Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent wraps the Google ADK runner with sensible defaults (streaming mode, in-memory session service, app name) so consumers hit the same shape regardless of whether they're driving the agent from a one-shot CLI, a REPL, or an HTTP handler.
|
Package agent wraps the Google ADK runner with sensible defaults (streaming mode, in-memory session service, app name) so consumers hit the same shape regardless of whether they're driving the agent from a one-shot CLI, a REPL, or an HTTP handler. |
|
internal/subsession
Package subsession holds the session-derivation plumbing shared by the two subagent-spawning paths: the core parallel-tool-call path in pkg/agent (subagent.go) and the long-lived background path in pkg/agent/background.
|
Package subsession holds the session-derivation plumbing shared by the two subagent-spawning paths: the core parallel-tool-call path in pkg/agent (subagent.go) and the long-lived background path in pkg/agent/background. |
|
internal/toolcalls
Package toolcalls records the tool calls an agent made, as the runtime observed them going past.
|
Package toolcalls records the tool calls an agent made, as the runtime observed them going past. |
|
Package agentenv parses the optional .agents/env.yaml (or .env.json) manifest and produces a Resolver that agent-bundle loaders can use to interpolate ${env:VAR} references in AGENTS.md, skill files, and mcp.json values.
|
Package agentenv parses the optional .agents/env.yaml (or .env.json) manifest and produces a Resolver that agent-bundle loaders can use to interpolate ${env:VAR} references in AGENTS.md, skill files, and mcp.json values. |
|
Package approval is the write gate: the seam where a mutating tool call stops and waits for an operator (docs/durable-write-gate-design.md).
|
Package approval is the write gate: the seam where a mutating tool call stops and waits for an operator (docs/durable-write-gate-design.md). |
|
Package approver is the model-backed permissions.Approver behind permission mode "auto" (#1175, docs/auto-mode-design.md).
|
Package approver is the model-backed permissions.Approver behind permission mode "auto" (#1175, docs/auto-mode-design.md). |
|
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. |
|
wire
Package wire is the attach protocol's vocabulary: the typed SSE event payloads and their event names, the durable eventlog rows the agent writes for things that happen TO a session (guardrail trips, turn errors, failed context reductions, audit rows), the turn-error classifier, and the small set of capability interfaces and context accessors pkg/agent implements or reads.
|
Package wire is the attach protocol's vocabulary: the typed SSE event payloads and their event names, the durable eventlog rows the agent writes for things that happen TO a session (guardrail trips, turn errors, failed context reductions, audit rows), the turn-error classifier, and the small set of capability interfaces and context accessors pkg/agent implements or reads. |
|
Package attachadapter bridges a *agent.Agent onto the attach-mode HTTP/SSE surface (pkg/attach).
|
Package attachadapter bridges a *agent.Agent onto the attach-mode HTTP/SSE surface (pkg/attach). |
|
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 childenv keeps the daemon's own credentials out of the processes it starts.
|
Package childenv keeps the daemon's own credentials out of the processes it starts. |
|
Package compose lifts reusable substrate wiring out of cmd/core-agent so library consumers can build the same agent stack the bundled binary does, per docs/compose-extraction-design.md (#386): substrate builders (compactor, agentic tools, MCP digest LLM fallback, context cache, Anthropic prompt cache), operator-visible formatters, pricing operations, grant persistence, and multi-session construction (session factory, resumer, and authn wiring).
|
Package compose lifts reusable substrate wiring out of cmd/core-agent so library consumers can build the same agent stack the bundled binary does, per docs/compose-extraction-design.md (#386): substrate builders (compactor, agentic tools, MCP digest LLM fallback, context cache, Anthropic prompt cache), operator-visible formatters, pricing operations, grant persistence, and multi-session construction (session factory, resumer, and authn wiring). |
|
Package config defines the on-disk schema for `.agents/config.json` and the rules for discovering, parsing, and merging it with built-in defaults.
|
Package config defines the on-disk schema for `.agents/config.json` and the rules for discovering, parsing, and merging it with built-in defaults. |
|
Package digest consolidates the digesting primitives core-agent uses to keep large tool responses out of the parent context.
|
Package digest consolidates the digesting primitives core-agent uses to keep large tool responses out of the parent context. |
|
Package evals provides session-trace extraction, trajectory and invariant evaluators, and call-schema validation for grading stored core-agent sessions (#1538).
|
Package evals provides session-trace extraction, trajectory and invariant evaluators, and call-schema validation for grading stored core-agent sessions (#1538). |
|
judge
Package judge provides the LLM-as-judge quality rubric for grading agent responses against ground-truth diagnoses (#1538).
|
Package judge provides the LLM-as-judge quality rubric for grading agent responses against ground-truth diagnoses (#1538). |
|
Durable continuation claims (#977).
|
Durable continuation claims (#977). |
|
Package hooks dispatches shell commands on agent-side event boundaries.
|
Package hooks dispatches shell commands on agent-side event boundaries. |
|
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 user-configured Model Context Protocol servers into the agent loop.
|
Package mcp wires user-configured Model Context Protocol servers into the agent loop. |
|
Package memory provides the storage-neutral multi-scope long-term memory contract, concurrent fan-out Router, URI opener registry, in-memory store, and ADK v2 memory.Service bridge for core-agent.
|
Package memory provides the storage-neutral multi-scope long-term memory contract, concurrent fan-out Router, URI opener registry, in-memory store, and ADK v2 memory.Service bridge for core-agent. |
|
memorybank
Package memorybank implements pkg/memory.Backend on top of Vertex AI Agent Engine Memory Bank (cloud.google.com/go/aiplatform/apiv1beta1.MemoryBankClient).
|
Package memorybank implements pkg/memory.Backend on top of Vertex AI Agent Engine Memory Bank (cloud.google.com/go/aiplatform/apiv1beta1.MemoryBankClient). |
|
memtest
Package memtest provides the shared conformance test suite that every pkg/memory.Backend implementation (InMemory, Memory Bank, SQLite FTS5, and external adapters) must pass.
|
Package memtest provides the shared conformance test suite that every pkg/memory.Backend implementation (InMemory, Memory Bank, SQLite FTS5, and external adapters) must pass. |
|
memtools
Package memtools builds the model-facing long-term memory tools (recall_memory, persist_memory, forget_memory) over a *memory.Router (#948, docs/memory-service-design.md "Model-facing tools").
|
Package memtools builds the model-facing long-term memory tools (recall_memory, persist_memory, forget_memory) over a *memory.Router (#948, docs/memory-service-design.md "Model-facing tools"). |
|
sqlfts
Package sqlfts implements pkg/memory.Backend on top of pure-Go SQLite with FTS5 full-text search (github.com/glebarez/sqlite).
|
Package sqlfts implements pkg/memory.Backend on top of pure-Go SQLite with FTS5 full-text search (github.com/glebarez/sqlite). |
|
Package models is the adapter layer between core-agent's configuration and concrete LLM backends.
|
Package models is the adapter layer between core-agent's configuration and concrete LLM backends. |
|
anthropic
Package anthropic implements models.Provider for Anthropic / Claude, on the first-party API and on Vertex AI.
|
Package anthropic implements models.Provider for Anthropic / Claude, on the first-party API and on Vertex AI. |
|
gemini
Package gemini implements models.Provider for Gemini, on the Gemini Developer API ("gemini") and on Vertex AI ("vertex").
|
Package gemini implements models.Provider for Gemini, on the Gemini Developer API ("gemini") and on Vertex AI ("vertex"). |
|
mock
Package mock ships two credential-free LLM providers and a recording wrapper that pair for offline testing of agent flows:
|
Package mock ships two credential-free LLM providers and a recording wrapper that pair for offline testing of agent flows: |
|
profiles
Package profiles is the models.Provider for provider profiles: every model.provider beyond core-agent's own gemini / vertex / anthropic / anthropic-vertex / echo / scripted.
|
Package profiles is the models.Provider for provider profiles: every model.provider beyond core-agent's own gemini / vertex / anthropic / anthropic-vertex / echo / scripted. |
|
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 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 pricing is core-agent's name for core-models' shared price catalog, github.com/go-steer/core-models/pricing.
|
Package pricing is core-agent's name for core-models' shared price catalog, github.com/go-steer/core-models/pricing. |
|
Package recording wraps an adkmodel.LLM with a JSONL transcript recorder for offline observability and scripted-replay testing.
|
Package recording wraps an adkmodel.LLM with a JSONL transcript recorder for offline observability and scripted-replay testing. |
|
Package runner drives the agent through a real conversation — either a single one-shot prompt (Headless) or a multi-turn stdin REPL (REPL).
|
Package runner drives the agent through a real conversation — either a single one-shot prompt (Headless) or a multi-turn stdin REPL (REPL). |
|
Package session is the deprecated former name of pkg/transcript (#492): ADK's own session package dominates pkg/agent's signatures, so this name collided in almost every file that used both.
|
Package session is the deprecated former name of pkg/transcript (#492): ADK's own session package dominates pkg/agent's signatures, so this name collided in almost every file that used both. |
|
Package skills loads SKILL.md bundles from .agents/skills/<name>/ and exposes them as an ADK Toolset the agent can invoke.
|
Package skills loads SKILL.md bundles from .agents/skills/<name>/ and exposes them as an ADK Toolset the agent can invoke. |
|
Package statestore is the home of the pluggable session-state backends described in docs/external-state-design.md (#1192).
|
Package statestore is the home of the pluggable session-state backends described in docs/external-state-design.md (#1192). |
|
agentengine
Package agentengine is the eventlog.Transcript backend on Vertex AI Agent Engine Sessions, written on aiplatform/apiv1beta1.SessionClient directly (docs/external-state-design.md decision 7: ADK's own session/vertexai client lets the service assign event IDs and drops UsageMetadata and FinishReason on ordinary events, which resume and the usage tracker read back).
|
Package agentengine is the eventlog.Transcript backend on Vertex AI Agent Engine Sessions, written on aiplatform/apiv1beta1.SessionClient directly (docs/external-state-design.md decision 7: ADK's own session/vertexai client lets the service assign event IDs and drops UsageMetadata and FinishReason on ordinary events, which resume and the usage tracker read back). |
|
conformance
Package conformance is the contract every eventlog.Transcript backend has to meet, as a reusable test suite.
|
Package conformance is the contract every eventlog.Transcript backend has to meet, as a reusable test suite. |
|
memory
Package memory is an in-process eventlog.Transcript over ADK's in-memory session service.
|
Package memory is an in-process eventlog.Transcript over ADK's in-memory session service. |
|
Package telemetry initializes OpenTelemetry for the agent loop.
|
Package telemetry initializes OpenTelemetry for the agent loop. |
|
Package tools provides ADK-side helpers for wiring tools into the agent.
|
Package tools provides ADK-side helpers for wiring tools into the agent. |
|
alert
Package alert implements the native `alert` built-in tool: a config-driven, distroless-safe way for a headless core-agent daemon to fire escalations to pre-registered webhook targets (Slack, Discord, PagerDuty, generic JSON) without shelling out or running a separate MCP server.
|
Package alert implements the native `alert` built-in tool: a config-driven, distroless-safe way for a headless core-agent daemon to fire escalations to pre-registered webhook targets (Slack, Discord, PagerDuty, generic JSON) without shelling out or running a separate MCP server. |
|
peer
Package peer implements the `call_peer` built-in tool: named delegation from one core-agent daemon to another over attach-mode HTTP.
|
Package peer implements the `call_peer` built-in tool: named delegation from one core-agent daemon to another over attach-mode HTTP. |
|
vcs
Package vcs implements the built-in vcs_* tool suite for shell-free GitOps workflows over go-steer/core-vcs (#1490).
|
Package vcs implements the built-in vcs_* tool suite for shell-free GitOps workflows over go-steer/core-vcs (#1490). |
|
Package transcript writes session transcripts to disk on exit.
|
Package transcript writes session transcripts to disk on exit. |
|
Package usage tracks token + cost accounting for the agent loop.
|
Package usage tracks token + cost accounting for the agent loop. |
|
The windowed-density loop detector (#702).
|
The windowed-density loop detector (#702). |
Click to show internal directories.
Click to hide internal directories.