Directories
¶
| Path | Synopsis |
|---|---|
|
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 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 agent provides the bucket-1 shim over ADK v2's runner and llmagent primitives. |
|
Package approval is the write gate: the seam where a mutating tool call stops and waits for an operator (docs/v0.3-plan.md W2, hitl_policy.on_mutation).
|
Package approval is the write gate: the seam where a mutating tool call stops and waits for an operator (docs/v0.3-plan.md W2, hitl_policy.on_mutation). |
|
Package attach implements live-tail + inject over HTTP/SSE for headless core-agent deployments.
|
Package attach implements live-tail + inject over HTTP/SSE for headless core-agent deployments. |
|
Package attachadapter bridges a mast serve-daemon session into pkg/attach's Registrant contract, so operator frontends (mast-web) can list, tail, and inject into sessions over the attach protocol.
|
Package attachadapter bridges a mast serve-daemon session into pkg/attach's Registrant contract, so operator frontends (mast-web) can list, tail, and inject into sessions over the attach protocol. |
|
Package auth defines the per-caller identity primitive used by the multi-session attach layer.
|
Package auth defines the per-caller identity primitive used by the multi-session attach layer. |
|
Package budget meters model usage against workload budget ceilings.
|
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 config implements v0.1 of the `.agents/` discovery and loading rules from docs/config-layout-design.md. |
|
Package digest consolidates the digesting primitives mast uses to keep large tool responses out of the parent context.
|
Package digest consolidates the digesting primitives mast uses to keep large tool responses out of the parent context. |
|
Package effects implements the recorded-effect outbox (docs/durable-execution-design.md, "Recorded-effect outbox"): the runtime guard that makes mutating-tool re-execution ambiguity visible and blocking instead of silent, under mast's declared at-least-once contract.
|
Package effects implements the recorded-effect outbox (docs/durable-execution-design.md, "Recorded-effect outbox"): the runtime guard that makes mutating-tool re-execution ambiguity visible and blocking instead of silent, under mast's declared at-least-once contract. |
|
Package envelope defines the on-the-wire payload shapes mast accepts on its inject endpoint.
|
Package envelope defines the on-the-wire payload shapes mast accepts on its inject endpoint. |
|
Package eventlog is the durable, append-only audit log that backs agent.Agent's session.Service.
|
Package eventlog is the durable, append-only audit log that backs agent.Agent's session.Service. |
|
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 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. |
|
Fan-out dispatch (docs/v0.3-plan.md W3): N analysts run concurrently over the same incident, one synthesis specialist merges what they return into a single report.
|
Fan-out dispatch (docs/v0.3-plan.md W3): N analysts run concurrently over the same incident, one synthesis specialist merges what they return into a single report. |
|
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 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 instruction loads project + user "agent memory" files (typically AGENTS.md) into the system prompt.
|
Package instruction loads project + user "agent memory" files (typically AGENTS.md) into the system prompt. |
|
Package mcp wires MCP toolsets for the workloads mast runs.
|
Package mcp wires MCP toolsets for the workloads mast runs. |
|
Package modeltier classifies LLM model IDs into capability tiers (frontier / mid / small) used to tune behavior whose right setting depends on how powerfully the model reasons.
|
Package modeltier classifies LLM model IDs into capability tiers (frontier / mid / small) used to tune behavior whose right setting depends on how powerfully the model reasons. |
|
Package observability holds mast's telemetry surface: the FIXED Prometheus metric registry, and env-gated OTel trace-export setup.
|
Package observability holds mast's telemetry surface: the FIXED Prometheus metric registry, and env-gated OTel trace-export setup. |
|
Package permissions implements the central permission gate that decides whether each tool invocation may proceed.
|
Package permissions implements the central permission gate that decides whether each tool invocation may proceed. |
|
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 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 pricing resolves a model's per-million-token rates across a layered set of sources so usage costs stay accurate as new models ship and operators add overrides.
|
Package pricing resolves a model's per-million-token rates across a layered set of sources so usage costs stay accurate as new models ship and operators add overrides. |
|
providers
|
|
|
anthropic
Package anthropic adapts Anthropic / Claude to the ADK's model.LLM interface.
|
Package anthropic adapts Anthropic / Claude to the ADK's model.LLM interface. |
|
gemini
Package gemini wraps an ADK Gemini model.LLM with the behavior mast needs for unattended operation: server-side built-in tool injection (Google Search / URL Context / Code Execution), Vertex explicit context-cache stamping, empty-response detection + retry, and cache-eviction recovery.
|
Package gemini wraps an ADK Gemini model.LLM with the behavior mast needs for unattended operation: server-side built-in tool injection (Google Search / URL Context / Code Execution), Vertex explicit context-cache stamping, empty-response detection + retry, and cache-eviction recovery. |
|
mock
Package mock ships a credential-free scripted LLM provider for offline testing of agent flows.
|
Package mock ships a credential-free scripted LLM provider for offline testing of agent flows. |
|
vertexcache
Package vertexcache owns the lifecycle of a single Vertex explicit context cache — Create at agent startup, Refresh on TTL pressure, Delete on session unregister.
|
Package vertexcache owns the lifecycle of a single Vertex explicit context cache — Create at agent startup, Refresh on TTL pressure, Delete on session unregister. |
|
Package router assembles the top-level agent for a workload: a Chat-mode coordinator with the workload's specialists as SubAgents.
|
Package router assembles the top-level agent for a workload: a Chat-mode coordinator with the workload's specialists as SubAgents. |
|
Package serverauth holds the request-admission seams shared by mast's network server surfaces (A2A — pkg/a2a; AG-UI — pkg/agui): pluggable bearer authentication (TokenValidator → Principal, with per-surface scope checks) and pluggable rate limiting (RateLimiter, in ratelimit.go).
|
Package serverauth holds the request-admission seams shared by mast's network server surfaces (A2A — pkg/a2a; AG-UI — pkg/agui): pluggable bearer authentication (TokenValidator → Principal, with per-surface scope checks) and pluggable rate limiting (RateLimiter, in ratelimit.go). |
|
Package specialists loads specialist .tmpl files from disk and turns them into ADK v2 agents.
|
Package specialists loads specialist .tmpl files from disk and turns them into ADK v2 agents. |
|
Pause records and resume tokens — the storage half of the v0.2 programmatic pause/abort surface (docs/durable-execution-design.md, "The v0.2 pause/abort mechanics").
|
Pause records and resume tokens — the storage half of the v0.2 programmatic pause/abort surface (docs/durable-execution-design.md, "The v0.2 pause/abort mechanics"). |
|
Package workload loads workload bundles — the declarative operational profile for a mast deployment.
|
Package workload loads workload bundles — the declarative operational profile for a mast deployment. |
Click to show internal directories.
Click to hide internal directories.