Metadata-Version: 2.3
Name: phlo-observe-query
Version: 0.3.0
Summary: Typed read client for the phlo-observer V2 query API: runs, assets, lineage, insights, incidents and agent-facing tool functions (spec 19).
Author: Phlo
License: Apache-2.0
Requires-Dist: httpx>=0.28
Requires-Dist: pydantic>=2.8
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# phlo-observe-query

Typed, read-only client for the phlo-observer V2 query API (spec §19).

```python
from observe_query import ObserverClient

client = ObserverClient("http://observer:8080", token="...")

run = client.run("01J...")
failures = run.failures()
changes = run.recent_changes()
impact = run.affected_downstream()
bundle = run.investigate()
```

## Agent tools

`observe_query.tools` exposes the spec §19.2 tool surface as a dispatch
table; every function takes the client first and returns structured JSON:

```python
from observe_query import AGENT_TOOLS, call_tool

result = call_tool(client, "get_asset_health", entity_id="asset://a/b")
```

Agent access is read-only by design (spec §19.4): this package exposes no
write or action endpoints.
