pkg/

Package a2a implements the v0.1 synchronous A2A client from docs/a2a-design.md ("Mast as A2A client", client-only phasing row): agent-card discovery and caching, JSON-RPC 2.0 message/send on the single A2A v0.3 endpoint (A2A-Version header, bearer auth from an env-var reference), direct-message and task-opened reply handling with bounded tasks/get polling to a terminal state, and tasks/cancel on caller cancellation.

Package agent provides the bucket-1 shim over ADK v2's runner and llmagent primitives.

Package budget meters model usage against workload budget ceilings.

Package config implements v0.1 of the `.agents/` discovery and loading rules from docs/config-layout-design.md.

Package envelope defines the on-the-wire payload shapes mast accepts on its inject endpoint.

Package federation implements the v0.1 slice of docs/federation-design.md: the frozen Adapter interface, reference parsing for `<scheme>://<name>[/<skill>]` remote-agent references, a scheme-keyed adapter registry, and the planner-facing `invoke_remote_agent` tool.

Package graph assembles the workload's triage flow as an explicit ADK v2 workflow graph — the LLM-as-router shape from docs/workflow-scaffolding-design.md (#7), as sketched in docs/triage-demo-plan.md:

Package inject implements the HTTP endpoint that receives edge-trigger payloads (from k8s-event-watcher and any other source speaking the envelope.InjectPayload shape) and dispatches them into the mast runtime.

Package mcp wires MCP toolsets for the workloads mast ships.

Package observability holds mast's telemetry surface: the FIXED Prometheus metric registry, and env-gated OTel trace-export setup.

Package planner implements the v0.1 scaffold of the supervisor-body planner from docs/orchestration-design.md ("The planner", shape C with light D flavor): a Task-mode LlmAgent whose tool vocabulary is the workload's execution vocabulary.

Package router assembles the top-level agent for a workload: a Chat-mode coordinator with the workload's specialists as SubAgents.

Package session is the operator-facing read/inspect surface over ADK's session store (docs/durable-execution-design.md, "Operator-facing surface").

Package specialists loads specialist .tmpl files from disk and turns them into ADK v2 agents.

Package workload loads workload bundles — the declarative operational profile for a mast deployment.