---

name: agent-runtime description: "Owns Upsonic's core agent execution surface: Agent, Task, Direct, graph/runtime primitives, streaming, structured output, and run control." disable-model-invocation: true metadata: disco-role: operating license: MIT

agent-runtime

Use this route for the core execution APIs: Agent, Task, Direct, graph/runtime primitives, streaming, structured output, timeouts, partial results, and run control.

Include

• Agent and Task orchestration.
• Direct for direct model calls without the full agent pipeline.
• Runtime primitives such as Graph, run state, context handling, streaming, and cancellation/timeout behavior.
• Structured-output and cache-related runtime behavior when the question is about a task run rather than the provider or storage backend.

Exclude

• Model/provider selection and credentials → models-and-providers
• Tools, MCP, or agent-as-tool wiring → tools-and-mcp
• Session persistence and chat history → chat-memory-storage
• Policies, reflection, reliability, tracing, or evals → quality-safety-governance
• Teams, autonomous agents, prebuilt agents, Ralph, and simulation loops → teams-autonomous-prebuilt

Start here

• references/api-reference.md
• references/troubleshooting.md
• scripts/inspect_runtime_api.py