agents

📄️ Resolve a pending approval request. Validates parent run belongs to authenticated org. Sets status, reason, resolved_by,

Resolve a pending approval request. Validates parent run belongs to authenticated org. Sets status, reason, resolved_by, resolved_at.

📄️ Return metadata for all agents in AgentRegistry. Does NOT require the model client — only the registry. For frontend dis

Return metadata for all agents in AgentRegistry. Does NOT require the model client — only the registry. For frontend discovery.

📄️ Cancel a run in queued, running, or awaiting_approval status. Sets status=cancelled and completed_at=now().

Cancel a run in queued, running, or awaiting_approval status. Sets status=cancelled and completed_at=now().

📄️ Retrieve a run by ID with steps (by step_index) and pending ApprovalRequests. Scoped to the authenticated org.

Retrieve a run by ID with steps (by step_index) and pending ApprovalRequests. Scoped to the authenticated org.

📄️ Mark a client-side agent session as completed. Updates Run: status=completed, summary, confidence, completed_at=now(). e

Mark a client-side agent session as completed. Updates Run: status=completed, summary, confidence, completed_at=now(). evidence and next_steps not persisted.

📄️ Create a client-side agent tool session. Server resolves the model, selects deployment lane, reads system prompt, builds

Create a client-side agent tool session. Server resolves the model, selects deployment lane, reads system prompt, builds tool gateway, and creates a Run row (status=running).

📄️ Execute a single tool call within a client-side agent session. Records a Step row. Returns tool result as JSON string.

Execute a single tool call within a client-side agent session. Records a Step row. Returns tool result as JSON string.

📄️ Run one inference turn within an active agent session. Validates session ownership and model match. Runs optional intent

Run one inference turn within an active agent session. Validates session ownership and model match. Runs optional intent gate. Builds context from previous_response_id cache.

📄️ Create a new conversation thread for the specified agent_type. Validates against AgentRegistry.supported_agents() and in

Create a new conversation thread for the specified agent_type. Validates against AgentRegistry.supported_agents() and inserts a Thread row in chat_threads.

📄️ List threads for the authenticated org, optionally filtered by agent_type. Scoped to org_id, ordered by updated_at DESC,

List threads for the authenticated org, optionally filtered by agent_type. Scoped to org_id, ordered by updated_at DESC, hard-capped at 50.

📄️ Retrieve a thread by ID with full message history. Scoped to the authenticated org; 404 for cross-org access.

Retrieve a thread by ID with full message history. Scoped to the authenticated org; 404 for cross-org access.

📄️ Start a new agent run within an existing thread. Validates thread ownership, opens SSE stream via start_agent_run(). Fir

Start a new agent run within an existing thread. Validates thread ownership, opens SSE stream via start_agent_run(). First event is run_created with run_id. Stream closes after done.