internal/

directory
v0.10.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 30, 2026 License: Apache-2.0

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 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 internal/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 internal/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 cli is the mast binary: serve mode, one-shot mode, and the `mast sessions` / `mast stop` subcommands.
Package cli is the mast binary: serve mode, one-shot mode, and the `mast sessions` / `mast stop` subcommands.
Package compose wires a workload bundle plus its specialist specs into a runnable root agent.
Package compose wires a workload bundle plus its specialist specs into a runnable root agent.
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 evals is the v0.3 parity harness: it loads the scenario corpus and the intent table, and (as the workstream lands) scores a recorded run against them.
Package evals is the v0.3 parity harness: it loads the scenario corpus and the intent table, and (as the workstream lands) scores a recorded run against them.
cmd/evals command
Command evals runs the v0.3 parity eval suite (docs/v0.3-plan.md W0.4).
Command evals runs the v0.3 parity eval suite (docs/v0.3-plan.md W0.4).
cmd/outcome command
Command outcome runs the O tier: the outcome evals (#297, docs/outcome-evals-design.md).
Command outcome runs the O tier: the outcome evals (#297, docs/outcome-evals-design.md).
differentiators
Package differentiators holds the v0.3 eval scenarios that the upstream LangChain SRE harness structurally cannot express (docs/v0.3-plan.md W0.3).
Package differentiators holds the v0.3 eval scenarios that the upstream LangChain SRE harness structurally cannot express (docs/v0.3-plan.md W0.3).
harness
Package harness is the runnable form of the v0.3 parity eval suite (docs/v0.3-plan.md W0.4): the thing scripts/evals.sh invokes and CI gates on.
Package harness is the runnable form of the v0.3 parity eval suite (docs/v0.3-plan.md W0.4): the thing scripts/evals.sh invokes and CI gates on.
judge
Package judge is the metered tier of the v0.3 parity eval suite (docs/v0.3-plan.md W0.5): the 31-scenario corpus scored against a real model, which is the only tier that produces a LangChain-comparable number.
Package judge is the metered tier of the v0.3 parity eval suite (docs/v0.3-plan.md W0.5): the 31-scenario corpus scored against a real model, which is the only tier that produces a LangChain-comparable number.
outcome
Package outcome is the O tier's corpus: the fixture-role catalog, the case schema, and the loader that refuses a corpus which cannot measure what it claims to.
Package outcome is the O tier's corpus: the fixture-role catalog, the case schema, and the loader that refuses a corpus which cannot measure what it claims to.
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 injectedauth supports running mast where Google credentials are added to outbound requests by an egress gateway instead of being held by the process, as in an Agent Substrate sandbox with credential injection.
Package injectedauth supports running mast where Google credentials are added to outbound requests by an egress gateway instead of being held by the process, as in an Agent Substrate sandbox with credential injection.
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 kvwindow is the one shape mast reports a model server's KV-cache activity in, and the one fold that sums windows, shared by GET /sessions/{id}/usage (internal/attach) and the judged eval board (internal/evals/harness) so the two cannot drift.
Package kvwindow is the one shape mast reports a model server's KV-cache activity in, and the one fold that sums windows, shared by GET /sessions/{id}/usage (internal/attach) and the judged eval board (internal/evals/harness) so the two cannot drift.
Package mcp wires MCP toolsets for the workloads mast runs.
Package mcp wires MCP toolsets for the workloads mast runs.
Package modelretry waits out a provider that says "not now".
Package modelretry waits out a provider that says "not now".
Package modeltext reads the caller-facing text out of a model response part (#370).
Package modeltext reads the caller-facing text out of a model response part (#370).
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.
The ack vocabulary (v0.5 W4.6) — the two argument names mast fills in when it forwards an operator's acknowledgement.
The ack vocabulary (v0.5 W4.6) — the two argument names mast fills in when it forwards an operator's acknowledgement.
Package notify is the egress client for switchboard's outbound message ingress (v0.5 W4.5) — the half of unattended monitoring that speaks.
Package notify is the egress client for switchboard's outbound message ingress (v0.5 W4.5) — the half of unattended monitoring that speaks.
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.
providers
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.
usage
Package usage carries the provider-usage record that genai's UsageMetadata has no room for.
Package usage carries the provider-usage record that genai's UsageMetadata has no room for.
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 — internal/a2a; AG-UI — internal/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 — internal/a2a; AG-UI — internal/agui): pluggable bearer authentication (TokenValidator → Principal, with per-surface scope checks) and pluggable rate limiting (RateLimiter, in ratelimit.go).
Package toolcatalog assembles the tool declarations a real mast turn puts in front of a model, and states what each one promises the model it accepts.
Package toolcatalog assembles the tool declarations a real mast turn puts in front of a model, and states what each one promises the model it accepts.
Operator acknowledgements — the durable half of the v0.5 W4.6 ack path (docs/v0.5-plan.md).
Operator acknowledgements — the durable half of the v0.5 W4.6 ack path (docs/v0.5-plan.md).
Package usagetrack folds a session's metered model calls into the token breakdown `GET /sessions/{id}/usage` promises.
Package usagetrack folds a session's metered model calls into the token breakdown `GET /sessions/{id}/usage` promises.
Package version centralizes build-identity reporting for cmd/mast and any surface that advertises the build (attach capabilities frames, agent cards).
Package version centralizes build-identity reporting for cmd/mast and any surface that advertises the build (attach capabilities frames, agent cards).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL