Directories
¶
| Path | Synopsis |
|---|---|
|
Package a2a is a hand-rolled codec for the Agent2Agent (A2A) protocol: an open standard for agent-to-agent communication built around a Task lifecycle, Messages composed of Parts, and Artifacts carrying task output.
|
Package a2a is a hand-rolled codec for the Agent2Agent (A2A) protocol: an open standard for agent-to-agent communication built around a Task lifecycle, Messages composed of Parts, and Artifacts carrying task output. |
|
a2aclient
Package a2aclient is a pure-Go client for the Agent2Agent (A2A) protocol.
|
Package a2aclient is a pure-Go client for the Agent2Agent (A2A) protocol. |
|
a2aconform
Package a2aconform is the shared A2A conformance vector suite: a declarative, transport-neutral corpus that every mapping producing A2A output in this repository must satisfy.
|
Package a2aconform is the shared A2A conformance vector suite: a declarative, transport-neutral corpus that every mapping producing A2A output in this repository must satisfy. |
|
Package agui is a hand-rolled codec for the AG-UI ("Agent-User Interaction") protocol: an open, event-based protocol that standardizes how AI agents stream structured and unstructured output, tool calls, and state mutations to user-facing applications.
|
Package agui is a hand-rolled codec for the AG-UI ("Agent-User Interaction") protocol: an open, event-based protocol that standardizes how AI agents stream structured and unstructured output, tool calls, and state mutations to user-facing applications. |
|
aguiclient
Package aguiclient is a reusable, pure-Go AG-UI conformance client.
|
Package aguiclient is a reusable, pure-Go AG-UI conformance client. |
|
Package brokerframe defines the wire contract exchanged between a Nexus session broker, its WebSocket gateway, and the nexus.io.broker plugin that each spawned instance dials back with.
|
Package brokerframe defines the wire contract exchanged between a Nexus session broker, its WebSocket gateway, and the nexus.io.broker plugin that each spawned instance dials back with. |
|
Package delegate is the sub-agent invocation primitive — the runtime that lets a parent agent call another agent with a different reasoning posture, system prompt, allowed-tools subset, and resource budget.
|
Package delegate is the sub-agent invocation primitive — the runtime that lets a parent agent call another agent with a different reasoning posture, system prompt, allowed-tools subset, and resource budget. |
|
Package desktop provides the reusable shell framework for Nexus desktop applications.
|
Package desktop provides the reusable shell framework for Nexus desktop applications. |
|
allplugins
Package allplugins provides a single RegisterAll function that registers every built-in plugin factory with an engine.PluginRegistry.
|
Package allplugins provides a single RegisterAll function that registers every built-in plugin factory with an engine.PluginRegistry. |
|
allplugins/internal/optincheck
Package optincheck is a build-graph canary.
|
Package optincheck is a build-graph canary. |
|
blobs
Package blobs implements a content-addressed blob store for multimodal payloads (images, audio, documents, video) referenced from event-payload MessageParts.
|
Package blobs implements a content-addressed blob store for multimodal payloads (images, audio, documents, video) referenced from event-payload MessageParts. |
|
configwatch
Package configwatch is an internal helper that fires a callback whenever the on-disk YAML config changes.
|
Package configwatch is an internal helper that fires a callback whenever the on-disk YAML config changes. |
|
journal
Package journal is the engine's durable, append-only event log.
|
Package journal is the engine's durable, append-only event log. |
|
objectstore
Package objectstore defines the lifecycle seam between a Nexus data tree on local disk and a remote object store, plus the driver-style registry that lets a backend module make itself selectable by name.
|
Package objectstore defines the lifecycle seam between a Nexus data tree on local disk and a remote object store, plus the driver-style registry that lets a backend module make itself selectable by name. |
|
objectstore/enginetest
Package enginetest holds the shared kill-and-resume suite: a real *engine.Engine, driven through a real object-store backend, killed, and resumed on a clean filesystem.
|
Package enginetest holds the shared kill-and-resume suite: a real *engine.Engine, driven through a real object-store backend, killed, and resumed on a clean filesystem. |
|
objectstore/objectstoretest
Package objectstoretest holds the shared conformance suite for objectstore.Backend, plus Memory - an in-memory backend that passes it.
|
Package objectstoretest holds the shared conformance suite for objectstore.Backend, plus Memory - an in-memory backend that passes it. |
|
pricing
Package pricing centralizes per-model token pricing for all LLM providers.
|
Package pricing centralizes per-model token pricing for all LLM providers. |
|
sandbox
Package sandbox is the engine-wide execution-isolation abstraction.
|
Package sandbox is the engine-wide execution-isolation abstraction. |
|
sandbox/host
Package host is the trivially-isolated sandbox backend: shell commands run directly via os/exec against the host kernel.
|
Package host is the trivially-isolated sandbox backend: shell commands run directly via os/exec against the host kernel. |
|
sandbox/wasm
Package wasm is the wazero-backed sandbox for agent-generated Go snippets.
|
Package wasm is the wazero-backed sandbox for agent-generated Go snippets. |
|
sandbox/wasm/host
Package host implements the wasm host module that backs the nexus_sdk/* snippet API.
|
Package host implements the wasm host module that backs the nexus_sdk/* snippet API. |
|
storage
Package storage provides per-plugin SQLite-backed key/value and SQL storage scoped at session, agent, or application levels.
|
Package storage provides per-plugin SQLite-backed key/value and SQL storage scoped at session, agent, or application levels. |
|
eval
|
|
|
baseline
Package baseline diffs two eval reports and produces a structured Diff + threshold-driven exit-code decision suitable for CI gating.
|
Package baseline diffs two eval reports and produces a structured Diff + threshold-driven exit-code decision suitable for CI gating. |
|
case
Package evalcase loads eval cases from disk.
|
Package evalcase loads eval cases from disk. |
|
internal/livedrive
Package livedrive holds the "drive a live engine, then wait for it to idle" loop shared by pkg/eval/runner's RunLive and pkg/eval/protocol's Run.
|
Package livedrive holds the "drive a live engine, then wait for it to idle" loop shared by pkg/eval/runner's RunLive and pkg/eval/protocol's Run. |
|
promote
Package promote turns a real session directory into a deterministic eval case.
|
Package promote turns a real session directory into a deterministic eval case. |
|
protocol
Package protocol implements the JSON request/response wire format used by `nexus eval --inspect-mode`.
|
Package protocol implements the JSON request/response wire format used by `nexus eval --inspect-mode`. |
|
report
Package report aggregates per-case Results into a stable JSON shape + human-readable summary.
|
Package report aggregates per-case Results into a stable JSON shape + human-readable summary. |
|
runner
Package runner — multi-case driver.
|
Package runner — multi-case driver. |
|
Package events defines the typed payload structs that flow over the engine bus.
|
Package events defines the typed payload structs that flow over the engine bus. |
|
compat
Package compat carries field-level migrations between event-payload schema versions.
|
Package compat carries field-level migrations between event-payload schema versions. |
|
Package iocopy provides byte-for-byte filesystem copy primitives shared by the eval promote pipeline and the online sampler plugin.
|
Package iocopy provides byte-for-byte filesystem copy primitives shared by the eval promote pipeline and the online sampler plugin. |
|
Package nexusauth verifies a credential minted elsewhere and turns an inbound HTTP request into a Principal.
|
Package nexusauth verifies a credential minted elsewhere and turns an inbound HTTP request into a Principal. |
|
Package nexuscreds acquires the outbound credentials Nexus presents to the services it calls.
|
Package nexuscreds acquires the outbound credentials Nexus presents to the services it calls. |
|
gcemeta
Package gcemeta answers facts about the Google Compute Engine environment this process runs in: whether it is on GCE at all, and if so its project, zone and region.
|
Package gcemeta answers facts about the Google Compute Engine environment this process runs in: whether it is on GCE at all, and if so its project, zone and region. |
|
googleadc
Package googleadc resolves Google Application Default Credentials and registers them with pkg/nexuscreds under the name "google-adc".
|
Package googleadc resolves Google Application Default Credentials and registers them with pkg/nexuscreds under the name "google-adc". |
|
Package nexusheaders is the single definition of the X-Nexus-* request header convention: the one way a client of a web-facing Nexus IO transport passes per-request out-of-band context — tenant, locale, timezone, an upstream authorization subject, a trace correlator — to the plugins running inside the engine.
|
Package nexusheaders is the single definition of the X-Nexus-* request header convention: the one way a client of a web-facing Nexus IO transport passes per-request out-of-band context — tenant, locale, timezone, an upstream authorization subject, a trace correlator — to the plugins running inside the engine. |
|
Package openaiconform is the shared OpenAI Responses conformance corpus: one declarative definition of the canonical request vectors, the settled wire invariants and the reply fixtures that EVERY serializer and parser for OpenAI's `/v1/responses` surface in this repository must satisfy.
|
Package openaiconform is the shared OpenAI Responses conformance corpus: one declarative definition of the canonical request vectors, the settled wire invariants and the reply fixtures that EVERY serializer and parser for OpenAI's `/v1/responses` surface in this repository must satisfy. |
|
Package posture defines the AgentPosture configuration type that the sub-agent invocation primitive consumes, together with an in-memory registry that nexus.agent.postures populates from on-disk YAML.
|
Package posture defines the AgentPosture configuration type that the sub-agent invocation primitive consumes, together with an in-memory registry that nexus.agent.postures populates from on-disk YAML. |
|
Package replay is the read-only walker over a session's durable journal.
|
Package replay is the read-only walker over a session's durable journal. |
|
Package roundtrip centralises the allowlist of LLMResponse.Metadata keys that must travel with a conversation Message so the NEXT request can echo them back to the provider verbatim.
|
Package roundtrip centralises the allowlist of LLMResponse.Metadata keys that must travel with a conversation Message so the NEXT request can echo them back to the provider verbatim. |
|
Package scene defines the Scene primitive — a named, structured, mutable session-scoped entity an agent uses to build durable visual output.
|
Package scene defines the Scene primitive — a named, structured, mutable session-scoped entity an agent uses to build durable visual output. |
|
Package streamtool is the channel-aware tool primitive — the contract a long-running tool implements when it wants to publish intermediate output while it runs.
|
Package streamtool is the channel-aware tool primitive — the contract a long-running tool implements when it wants to publish intermediate output while it runs. |
|
Package testharness provides integration test helpers for Nexus.
|
Package testharness provides integration test helpers for Nexus. |
|
contract
Package contract provides a lightweight unit-level test harness for asserting Nexus plugin event contracts (Subscriptions / Emissions).
|
Package contract provides a lightweight unit-level test harness for asserting Nexus plugin event contracts (Subscriptions / Emissions). |
Click to show internal directories.
Click to hide internal directories.