The factory that returns a mountable FastAPI read router over RunStore. Signature, the endpoints it adds, and the auth contract.

make_read_router

make_read_router builds a read-only FastAPI APIRouter over a RunStore. Mount it into your app and you get the full read surface (list, detail, events, SSE, drill-downs) with one auth dependency.

from dendrux.http import make_read_router

Signature

def make_read_router(*, store: RunStore, authorize: Callable[..., Any]) -> APIRouter

Returns a plain APIRouter. You own the prefix, CORS, TLS, rate limiting, and middleware. Write routes (submit / cancel) are yours to build on Agent methods.

Mount

from fastapi import FastAPI, HTTPException, Request
from dendrux.http import make_read_router
from dendrux.store import RunStore
 
app = FastAPI()
store = RunStore.from_database_url("sqlite+aiosqlite:///app.db")
 
async def authorize(request: Request) -> None:
    if request.headers.get("authorization") != f"Bearer {TOKEN}":
        raise HTTPException(401, "unauthorized")
 
app.include_router(make_read_router(store=store, authorize=authorize), prefix="/api")

Endpoints added

Full request/response shapes, query params, and the SSE cursor rules are in the HTTP API surface and the Mount the read router recipe. metadata_filter is not exposed over HTTP by design; call RunStore.list_runs directly or wrap it in your own route.

Where this fits

• Mounting the read router: the end-to-end recipe with captured responses.
• RunStore: the methods these endpoints call.
• HTTP API surface: every endpoint in detail.