> For the complete documentation index, see [llms.txt](/llms.txt). Every page on this site is also available as markdown at `<path>.md`.

# Reference

Auto-generated API reference for the `flowai_harness` public surface. Each
page below renders the module's exported classes, functions, and type
aliases directly from their docstrings.

For task-oriented guides see [Approvals](/docs/guides/approvals),
[Data Environment](/docs/guides/data-environment),
[Studio](/docs/guides/studio),
[Expose Tools Over MCP](/docs/guides/mcp),
[Testing](/docs/guides/testing), and [Streaming Events](/docs/guides/streaming).

Besides `dev` / `serve` (see [Studio](/docs/reference/studio)), the CLI also provides
`flowai-harness docs export` to generate the docs content artifact and
`flowai-harness mcp python MODULE:OBJECT` to serve a Python runtime object
over MCP (see [MCP](/docs/reference/mcp)).

- [Runtime](/docs/reference/runtime) — `Runtime`, `create_runtime`, `define_runtime`, `RuntimeSpec`, and the testing / data-environment configs.
- [Studio](/docs/reference/studio) — `define_app`, workspace bindings, and the local Studio command surface.
- [Evals](/docs/reference/evals) — eval configs, test cases, structured action ground truth, scorer presets, artifacts, and event envelopes.
- [MCP](/docs/reference/mcp) — stdio and Streamable HTTP helpers for exposing runtime tools to MCP clients.
- [Agents](/docs/reference/agents) — `define_coordinator`, `define_planner`, `define_executor`, `define_specialist`, and `AgentSpec`.
- [Plans](/docs/reference/plans) — `define_plan`, `PlanSpec`, `PlanDisplayAlias`.
- [References](/docs/reference/references) — `define_reference`, `ReferenceSpec`.
- [Tools](/docs/reference/tools) — `define_tool`, `ToolSpec`.
- [Prompts](/docs/reference/prompts) — `layered_prompt`, `LayeredPrompt`.
- [Tenant](/docs/reference/tenant) — `define_tenant`, `TenantIdentity`.
- [Unions](/docs/reference/unions) — `TaggedUnion`.
- [Glimpse](/docs/reference/glimpse) — `glimpse`.