Documentation
¶
Overview ¶
Package runtime groups reusable agent runtime packages extracted from norma.
The root package is documentation-only. Functional APIs live in subpackages:
- acpagent for ACP-backed ADK agents and ACP subprocess clients
- agentconfig for provider and MCP configuration schemas
- agentfactory for building runtime agents from validated configuration
- appconfig for loading and validating application config documents
- hostedagent for local API-backed ADK agents
- mcpregistry for in-memory MCP server lookup
- poolagent for ordered failover across multiple agent backends
- sessionstate for canonical runtime session-state keys
- structuredagent for JSON-schema-constrained ADK agent wrappers
Use github.com/normahq/norma/pkg/runtime/agentfactory when applications want the complete runtime assembly path. Use the lower-level packages directly when a caller needs one specific runtime capability.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package acpagent adapts Agentic Computing Protocol (ACP) runtimes to the Google ADK [agent.Agent] interface.
|
Package acpagent adapts Agentic Computing Protocol (ACP) runtimes to the Google ADK [agent.Agent] interface. |
|
Package agentconfig defines runtime provider and MCP configuration schemas.
|
Package agentconfig defines runtime provider and MCP configuration schemas. |
|
Package agentfactory builds ADK-compatible agents from runtime config.
|
Package agentfactory builds ADK-compatible agents from runtime config. |
|
Package appconfig loads and validates runtime application configuration.
|
Package appconfig loads and validates runtime application configuration. |
|
Package hostedagent adapts local API-backed models to the ADK agent interface.
|
Package hostedagent adapts local API-backed models to the ADK agent interface. |
|
Package mcpregistry stores MCP server definitions by ID.
|
Package mcpregistry stores MCP server definitions by ID. |
|
Package poolagent provides ordered failover across multiple agent backends.
|
Package poolagent provides ordered failover across multiple agent backends. |
|
Package sessionstate defines canonical runtime session-state keys.
|
Package sessionstate defines canonical runtime session-state keys. |
|
Package structuredagent wraps ADK agents with JSON-schema-constrained I/O.
|
Package structuredagent wraps ADK agents with JSON-schema-constrained I/O. |
|
Package taskmaster provides an unstable reusable async message scheduler.
|
Package taskmaster provides an unstable reusable async message scheduler. |
|
adk
Package adk wraps an already-built ADK agent for Taskmaster local execution.
|
Package adk wraps an already-built ADK agent for Taskmaster local execution. |
Click to show internal directories.
Click to hide internal directories.