pkg/

directory
v0.30.0 Latest Latest
Warning

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

Go to latest
Published: Oct 31, 2026 License: MIT

Directories

Path Synopsis
a2a
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).

Jump to

Keyboard shortcuts

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