pkg/

directory
v3.2.0-rc.1 Latest Latest
Warning

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

Go to latest
Published: Nov 7, 2026 License: Apache-2.0

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).

Jump to

Keyboard shortcuts

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