Skip to content

API reference

A curated map of the public surface, grouped by import path. Every module below has a full, auto-generated reference (rendered from docstrings by mkdocstrings) — follow the links for signatures, parameters, and source.

The public surface is guarded by tests/contract/test_public_api.py: every symbol in a public __all__ must resolve, carry a docstring, and appear on one of these pages.

Top level — kaboo_workflows

The curated top-level exports, for the common case:

  • Config pipeline: load, load_config, load_session, resolve_infra, AppConfig, ConfigInput, ResolvedConfig, ResolvedInfra
  • Orchestration: OrchestrationBuilder
  • Streaming: make_event_queue, EventQueue, StreamEvent, EventType
  • Tools: node_as_tool, node_as_async_tool, serialize_multiagent_result
  • MCP: create_mcp_client, create_mcp_server, MCPLifecycle
  • Hooks: EventPublisher, MaxToolCallsGuard, StopGuard, ToolNameSanitizer
  • Rendering / CLI: AnsiRenderer, cli_errors
  • Errors: ConfigurationError, SchemaValidationError, UnresolvedReferenceError, CircularDependencyError, ImportResolutionError (see kaboo_workflows.exceptions)

Serving — kaboo_workflows.adapters

  • create_agui_app — turn a config into a FastAPI AG-UI / CopilotKit app. This is the primary serving entrypoint and lives here (not re-exported top level).

Configuration — kaboo_workflows.config

Loaders, interpolation, infra resolution, and the full YAML schema models (AgentDef, ModelDef, OrchestrationDef, DelegateOrchestrationDef, SwarmOrchestrationDef, GraphOrchestrationDef, MCPServerDef, MCPClientDef, HookDef, SessionManagerDef, …).

Hooks — kaboo_workflows.hooks

EventPublisher, HistoryHook, InterruptHook, MaxToolCallsGuard, MultiAgentStopGuard, StopGuard, ToolNameSanitizer, stop_guard_from_event.

MCP — kaboo_workflows.mcp

MCPClient, MCPServer, MCPLifecycle, create_mcp_client, create_mcp_server, and the sse / stdio / streamable_http transports.

Tools — kaboo_workflows.tools

ask_user, the load_tool* discovery helpers, node_as_tool / node_as_async_tool, resolve_tool_spec(s), serialize_multiagent_result.

Converters — kaboo_workflows.converters

StreamConverter, OpenAIStreamConverter, RawStreamConverter.

Renderers — kaboo_workflows.renderers

AnsiRenderer.

Types — kaboo_workflows.types

EventType, StreamEvent, and the SessionManifest family (AgentDescriptor, OrchestrationDescriptor, EntryDescriptor, ModelDescriptor, NodeRef, EdgeRef).