Metadata-Version: 2.5
Name: agent-workbench-fastapi
Version: 0.1.0
Summary: Streaming FastAPI/ASGI adapter for an Agent Workbench service
License: Proprietary
Requires-Python: >=3.11
Requires-Dist: httpx<1,>=0.27
Provides-Extra: test
Requires-Dist: fastapi<1,>=0.115; extra == 'test'
Requires-Dist: pytest<10,>=8; extra == 'test'
Description-Content-Type: text/markdown

# `agent-workbench-fastapi`

Thin streaming adapter for mounting a standalone Agent Workbench service in a
FastAPI application without giving the Python process a Node or Postgres
dependency.

```bash
pip install agent-workbench-fastapi
```

```python
from fastapi import FastAPI
from agent_workbench_fastapi import AgentWorkbenchProxy

app = FastAPI()
app.mount(
    "/api/agent",
    AgentWorkbenchProxy("http://agent-workbench:8080/api/agent"),
)
```

The proxy forwards only standard content negotiation, content, authentication,
cookie, tracing, and idempotency headers by default. It does not forward
client-supplied identity or tenant headers. The upstream Workbench service must
verify the user credential, or the host must provide a `resolve_headers`
callback that creates a trusted service-to-service identity assertion.

Request and response bodies are streamed. Long-running agent responses are not
buffered by the adapter.

The adapter and TypeScript runtime have independent versions. Python releases
use tags in the form `agent-workbench-fastapi-vX.Y.Z` and are published to
PyPI. The Agent Workbench service itself can run beside the FastAPI application
or elsewhere on the company's private network.
