nexus

module
v0.32.0 Latest Latest
Warning

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

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

README

Nexus

Nexus

A modular AI agent harness built on a pure event-driven architecture in Go. The core manages only the event lifecycle and plugin registry — all behavior (LLM interaction, tool execution, output rendering, etc.) is delivered through composable plugins.

Nexus runs as the cmd/nexus CLI binary (terminal UI, browser UI, or oneshot mode) or embedded as a library in any Go process.

Prerequisites

Quick Start: CLI

# Set your API key (provider-specific)
export ANTHROPIC_API_KEY="your-key-here"   # for Anthropic
# export OPENAI_API_KEY="your-key-here"    # for OpenAI

# Build and run with default config
make run

# Or run a specific profile
bin/nexus -config configs/coding.yaml

The API key can also be set in a .env file in the project root.

Configuration Profiles

Profile Shell Access Agent Use Case
default.yaml Limited ReAct General purpose
coding.yaml Extended (make, docker, npm, cargo, python) ReAct Software development
research.yaml None ReAct Research and analysis
planned.yaml Limited ReAct + Dynamic planner Auto-approved planning
planned-static.yaml Limited ReAct + Static planner Fixed workflow steps
browser.yaml Limited ReAct Browser UI instead of TUI
planexec.yaml Limited Plan & Execute Multi-step task execution
orchestrator.yaml Limited Orchestrator Multi-agent coordination

Configuration is YAML-based. Each profile declares which plugins to load and their settings. See configs/default.yaml for the full schema.

Architecture

Plugins never call each other directly — all communication flows through a central typed event bus.

┌─────────────┐     ┌───────────┐     ┌──────────────┐
│   TUI / IO  │◄───►│           │◄───►│  LLM Provider│
└─────────────┘     │           │     └──────────────┘
                    │  Event    │
┌─────────────┐     │   Bus     │     ┌──────────────┐
│    Tools    │◄───►│           │◄───►│    Agents    │
└─────────────┘     │           │     └──────────────┘
                    │           │
┌─────────────┐     │           │     ┌──────────────┐
│   Memory    │◄───►│           │◄───►│  Gates       │
└─────────────┘     └───────────┘     └──────────────┘
Using Nexus as a library

Nexus embeds in any Go process without owning signals or process lifecycle:

eng, _ := engine.NewFromBytes(configYAML)
eng.Registry.Register("my.custom.plugin", myplugin.New)
eng.Boot(ctx)       // non-blocking
<-eng.SessionEnded()
eng.Stop(ctx)

CLI uses eng.Run(ctx) which wraps Boot + signal handling + Stop. Embedders must call Boot/Stop directly — Run installs its own SIGINT/SIGTERM handler, which conflicts with host processes.

Plugin categories
Category Plugins Description
Agents react, planexec, subagent, orchestrator Agent loops and coordination
Providers anthropic, openai LLM API providers
Tools shell, fileio, pdf, opener, ask Capabilities agents can invoke
I/O tui, browser, oneshot, agui, a2a User-facing transports
Memory conversation, compaction Context persistence and management
Observers logger, thinking Structured logging and thinking persistence
Planners dynamic, static Optional planning phase before agent execution
Gates endless_loop, stop_words, token_budget, rate_limiter, prompt_injection, json_schema, output_length, content_safety, context_window Quality, safety, and operational guards
Skills skills Skill discovery from directories listed in scan_paths
System dynvars, cancel Dynamic variables, cancellation

Project Structure

cmd/
  nexus/                CLI entry point
pkg/
  engine/               Core: event bus, plugin lifecycle, sessions, config
  events/               Typed event definitions
  ui/                   UI adapter contract (browser transport)
plugins/
  agents/               Agent loops (react, planexec, subagent, orchestrator)
  providers/anthropic/  Anthropic LLM provider (direct HTTP, no SDK)
  providers/openai/     OpenAI LLM provider (direct HTTP, no SDK)
  tools/                Shell, file I/O, PDF, file opener, ask user
  io/                   TUI, browser, oneshot, AG-UI, A2A transports
  memory/               Conversation history, context compaction
  observe/              Event logger, thinking persistence
  planners/             Dynamic and static planners
  gates/                Quality/safety/operational gates
  skills/               Skill discovery and catalog
  apps/helloworld/      Built-in hello-world example agent
configs/                YAML configuration files
docs/                   Full documentation (mdBook)

Development

make build        # Build binary to bin/nexus
make run          # Build and run with default config
make test         # Run all tests
make fmt          # Format code
make fmt-check    # Fail if any file needs gofmt (run by lint)
make vet          # Run go vet
make lint         # Run staticcheck (includes fmt-check + vet)
make clean        # Remove build artifacts

Documentation

Full documentation is in docs/ (mdBook format). Building the docs locally requires mdBook installed on your machine:

# Install mdBook (requires Rust/Cargo)
cargo install mdbook

# Or via homebrew
brew install mdbook

# Build and serve docs locally
cd docs && mdbook serve

Topics covered:

License

MIT. See LICENSE.

Directories

Path Synopsis
cmd
nexus command
Cost report CLI for the per-step router + multi-dim budget gate (idea 09).
Cost report CLI for the per-step router + multi-dim budget gate (idea 09).
nexus-broker command
Command nexus-broker is a standalone service that fronts OS-isolated Nexus instances.
Command nexus-broker is a standalone service that fronts OS-isolated Nexus instances.
internal
cmd/check-event-versions command
Command check-event-versions enforces the schema-versioning rule on pkg/events/*.go: any commit that mutates an existing payload struct (removes a field, renames a field, or changes a field's type) MUST bump the matching `<Name>Version` constant.
Command check-event-versions enforces the schema-versioning rule on pkg/events/*.go: any commit that mutates an existing payload struct (removes a field, renames a field, or changes a field's type) MUST bump the matching `<Name>Version` constant.
modules
pkg
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.
a2a/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.
a2a/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.
agui
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.
agui/aguiclient
Package aguiclient is a reusable, pure-Go AG-UI conformance client.
Package aguiclient is a reusable, pure-Go AG-UI conformance client.
brokerframe
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.
delegate
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.
engine/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.
engine/allplugins/internal/optincheck
Package optincheck is a build-graph canary.
Package optincheck is a build-graph canary.
engine/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.
engine/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.
engine/journal
Package journal is the engine's durable, append-only event log.
Package journal is the engine's durable, append-only event log.
engine/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.
engine/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.
engine/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.
engine/pricing
Package pricing centralizes per-model token pricing for all LLM providers.
Package pricing centralizes per-model token pricing for all LLM providers.
engine/sandbox
Package sandbox is the engine-wide execution-isolation abstraction.
Package sandbox is the engine-wide execution-isolation abstraction.
engine/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.
engine/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.
engine/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.
engine/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.
eval/case
Package evalcase loads eval cases from disk.
Package evalcase loads eval cases from disk.
eval/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.
eval/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.
eval/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`.
eval/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.
eval/runner
Package runner — multi-case driver.
Package runner — multi-case driver.
events
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.
events/compat
Package compat carries field-level migrations between event-payload schema versions.
Package compat carries field-level migrations between event-payload schema versions.
iocopy
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.
nexusauth
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.
nexuscreds
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.
nexuscreds/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.
nexuscreds/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".
nexusheaders
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.
openaiconform
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.
posture
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.
replay
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.
roundtrip
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.
scene
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.
streamtool
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.
testharness
Package testharness provides integration test helpers for Nexus.
Package testharness provides integration test helpers for Nexus.
testharness/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).
ui
plugins
agents/a2aremote
Package a2aremote hosts the nexus.agent.a2a_remote plugin — the OUTBOUND half of Nexus's Agent2Agent interoperability.
Package a2aremote hosts the nexus.agent.a2a_remote plugin — the OUTBOUND half of Nexus's Agent2Agent interoperability.
agents/aguiremote
Package aguiremote hosts the nexus.agent.agui_remote plugin — the consume-side bridge that surfaces one or more configured REMOTE AG-UI agents inside Nexus as delegate/subagent targets.
Package aguiremote hosts the nexus.agent.agui_remote plugin — the consume-side bridge that surfaces one or more configured REMOTE AG-UI agents inside Nexus as delegate/subagent targets.
agents/delegate
Package delegate hosts the nexus.agent.delegate plugin — the sub-agent invocation primitive exposed to the LLM as a single tool call.
Package delegate hosts the nexus.agent.delegate plugin — the sub-agent invocation primitive exposed to the LLM as a single tool call.
agents/postures
Package postures wires the posture.Registry into the engine as a plugin (nexus.agent.postures).
Package postures wires the posture.Registry into the engine as a plugin (nexus.agent.postures).
apps/helloworld
Package helloworld is a minimal Nexus plugin that responds to hello.request events with a configurable greeting.
Package helloworld is a minimal Nexus plugin that responds to hello.request events with a configurable greeting.
control/hitl
Package hitl is the human-in-the-loop primitive: any plugin that needs an operator's input — clarifying a question, approving a destructive tool call, picking among curated plans, or signing off on a memory write — emits hitl.requested and waits on hitl.responded.
Package hitl is the human-in-the-loop primitive: any plugin that needs an operator's input — clarifying a question, approving a destructive tool call, picking among curated plans, or signing off on a memory write — emits hitl.requested and waits on hitl.responded.
control/hitl_synthesizer
Package hitlsynthesizer renders context-aware approval prompts for HITL requests via a small/cheap LLM.
Package hitlsynthesizer renders context-aware approval prompts for HITL requests via a small/cheap LLM.
discovery/progressive
Package progressive implements hierarchical tool discovery.
Package progressive implements hierarchical tool discovery.
embeddings/cohere_multimodal
Package coheremultimodal implements an embeddings.provider capability backed by Cohere Embed v3 (multimodal): POST /v2/embed with either `text` or `image_url` content per input.
Package coheremultimodal implements an embeddings.provider capability backed by Cohere Embed v3 (multimodal): POST /v2/embed with either `text` or `image_url` content per input.
embeddings/mock
Package mock implements a deterministic, zero-I/O embeddings.provider for integration tests and offline development.
Package mock implements a deterministic, zero-I/O embeddings.provider for integration tests and offline development.
embeddings/openai
Package openai implements an embeddings.provider capability backed by the OpenAI embeddings API (https://api.openai.com/v1/embeddings).
Package openai implements an embeddings.provider capability backed by the OpenAI embeddings API (https://api.openai.com/v1/embeddings).
gates/approval_policy
Package approvalpolicy implements the policy-driven approval gate.
Package approvalpolicy implements the policy-driven approval gate.
gates/internal/retry
Package retry provides shared retry-with-LLM logic for gates that need to re-ask the LLM when output fails validation.
Package retry provides shared retry-with-LLM logic for gates that need to re-ask the LLM when output fails validation.
gates/rate_limiter
Package ratelimiter implements nexus.gate.rate_limiter, the LLM-request rate gate.
Package ratelimiter implements nexus.gate.rate_limiter, the LLM-request rate gate.
gates/token_budget
Package tokenbudget implements a multi-dimensional token / cost budget gate.
Package tokenbudget implements a multi-dimensional token / cost budget gate.
gates/tool_timeout
Package tooltimeout implements nexus.gate.tool_timeout, a per-call deadline gate for tool invocations.
Package tooltimeout implements nexus.gate.tool_timeout, a per-call deadline gate for tool invocations.
index/markdown
Package markdownindex implements a lexical-only markdown indexer.
Package markdownindex implements a lexical-only markdown indexer.
io/a2a
Package a2a implements the nexus.io.a2a serve plugin: an HTTP listener that exposes this Nexus instance as an Agent2Agent (A2A) agent.
Package a2a implements the nexus.io.a2a serve plugin: an HTTP listener that exposes this Nexus instance as an Agent2Agent (A2A) agent.
io/agui
Package agui implements the nexus.io.agui serve plugin: an HTTP listener that exposes the AG-UI ("Agent-User Interaction") endpoint.
Package agui implements the nexus.io.agui serve plugin: an HTTP listener that exposes the AG-UI ("Agent-User Interaction") endpoint.
io/broker
Package broker implements the nexus.io.broker plugin: a dial-back IO transport for spawned Nexus instances managed by the session broker (cmd/nexus-broker).
Package broker implements the nexus.io.broker plugin: a dial-back IO transport for spawned Nexus instances managed by the session broker (cmd/nexus-broker).
io/oneshot
Package oneshot provides a non-interactive IO plugin that runs the agent for a single turn, auto-approves every approval request, and emits a JSON transcript of the session to stdout (and optionally a file).
Package oneshot provides a non-interactive IO plugin that runs the agent for a single turn, auto-approves every approval request, and emits a JSON transcript of the session to stdout (and optionally a file).
io/realtime
Package realtime implements the nexus.io.realtime plugin: a WebSocket transport that streams LLM token deltas, tool previews, voice audio, and cancellation envelopes to connected clients, and accepts text input, audio chunks, cancel, and HITL responses going the other way.
Package realtime implements the nexus.io.realtime plugin: a WebSocket transport that streams LLM token deltas, tool previews, voice audio, and cancellation envelopes to connected clients, and accepts text input, audio chunks, cancel, and HITL responses going the other way.
io/test
Package testio provides a non-interactive IO plugin for integration testing.
Package testio provides a non-interactive IO plugin for integration testing.
io/voice
Package voice provides the nexus.io.voice plugin: a bus-driven voice IO transport that consumes microphone audio chunks (voice.audio.input.chunk), runs simple energy-based VAD + ASR (OpenAI Whisper API) to emit io.input, and consumes llm.response to drive TTS (OpenAI /audio/speech) chunks back out (voice.audio.output.chunk).
Package voice provides the nexus.io.voice plugin: a bus-driven voice IO transport that consumes microphone audio chunks (voice.audio.input.chunk), runs simple energy-based VAD + ASR (OpenAI Whisper API) to emit io.input, and consumes llm.response to drive TTS (OpenAI /audio/speech) chunks back out (voice.audio.output.chunk).
llm/batch
Package batch implements the cross-provider LLM Batch coordinator.
Package batch implements the cross-provider LLM Batch coordinator.
mcp/client
Package client implements the nexus.mcp.client plugin: a developer- configured bridge between Nexus and one or more MCP (Model Context Protocol) servers.
Package client implements the nexus.mcp.client plugin: a developer- configured bridge between Nexus and one or more MCP (Model Context Protocol) servers.
memory/internal/approval
Package approval is the shared human-in-the-loop wrapper used by the memory plugins (longterm, vector, compaction) that gain an opt-in require_approval config.
Package approval is the shared human-in-the-loop wrapper used by the memory plugins (longterm, vector, compaction) that gain an opt-in require_approval config.
memory/internal/internalflow
Package internalflow centralises the predicate every memory plugin uses to skip recording assistant messages produced by internal sub-flows (planner, classifier router, summariser, compaction, subagent, delegate).
Package internalflow centralises the predicate every memory plugin uses to skip recording assistant messages produced by internal sub-flows (planner, classifier router, summariser, compaction, subagent, delegate).
memory/simple
Package simple provides a minimal reference implementation of memory.history: an in-memory, append-only buffer with no cap and no persistence.
Package simple provides a minimal reference implementation of memory.history: an in-memory, append-only buffer with no cap and no persistence.
memory/summary_buffer
Package summary_buffer provides an inline auto-compacting memory.history provider.
Package summary_buffer provides an inline auto-compacting memory.history provider.
memory/tool_def_pruner
Package tool_def_pruner removes tool definitions from outgoing LLMRequest.Tools when those tools have been idle past a turn threshold.
Package tool_def_pruner removes tool definitions from outgoing LLMRequest.Tools when those tools have been idle past a turn threshold.
memory/tool_result_clear
Package tool_result_clear implements live curation of tool result bodies in the LLM-visible conversation.
Package tool_result_clear implements live curation of tool result bodies in the LLM-visible conversation.
memory/topic_pruner
Package topic_pruner detects topic shifts in the conversation and emits MemoryTopicShiftDetected when the user appears to have changed subjects.
Package topic_pruner detects topic shifts in the conversation and emits MemoryTopicShiftDetected when the user appears to have changed subjects.
memory/vector
Package vector implements the memory.vector capability: a per-agent semantic-recall store separate from nexus.memory.longterm (which is a file-per-entry notes store).
Package vector implements the memory.vector capability: a per-agent semantic-recall store separate from nexus.memory.longterm (which is a file-per-entry notes store).
observe/sampler
Package sampler is the opt-in online sampler plugin.
Package sampler is the opt-in online sampler plugin.
providers/fallback
Package fallback provides automatic provider failover when the primary LLM provider returns a non-retryable error or exhausts its retry budget.
Package fallback provides automatic provider failover when the primary LLM provider returns a non-retryable error or exhausts its retry budget.
providers/fanout
Package fanout sends a single LLM request to multiple providers in parallel and collects their responses.
Package fanout sends a single LLM request to multiple providers in parallel and collects their responses.
providers/gemini
Package gemini implements the Google Gemini LLM provider for Nexus.
Package gemini implements the Google Gemini LLM provider for Nexus.
rag/citations
Package citations parses and structures source attributions in LLM responses that follow a retrieval pass.
Package citations parses and structures source attributions in LLM responses that follow a retrieval pass.
rag/hybrid
Package hybrid implements the search.hybrid capability — a fusion orchestrator that runs vector and lexical retrieval in parallel and combines the rankings.
Package hybrid implements the search.hybrid capability — a fusion orchestrator that runs vector and lexical retrieval in parallel and combines the rankings.
rag/ingest
Package ingest implements a RAG ingestion plugin: chunks files, embeds them via the embeddings.provider capability, and upserts into the vector.store capability.
Package ingest implements a RAG ingestion plugin: chunks files, embeds them via the embeddings.provider capability, and upserts into the vector.store capability.
rag/reranker/cohere
Package cohere implements the search.reranker capability backed by the Cohere Rerank v2 API.
Package cohere implements the search.reranker capability backed by the Cohere Rerank v2 API.
rag/reranker/jina
Package jina implements the search.reranker capability backed by the Jina AI Reranker API.
Package jina implements the search.reranker capability backed by the Jina AI Reranker API.
rag/reranker/local
Package local implements the search.reranker capability with a pure-Go TF-IDF cosine reranker.
Package local implements the search.reranker capability with a pure-Go TF-IDF cosine reranker.
router/classifier
Package classifier implements an LLM-judge per-step model-role router.
Package classifier implements an LLM-judge per-step model-role router.
router/metadata
Package metadata implements a declarative per-step model router.
Package metadata implements a declarative per-step model router.
scene
Package scene hosts the nexus.scene plugin — the runtime that owns the Scene store, persists scene state into the session workspace, and exposes scene_create / scene_patch / scene_get / scene_list / scene_delete tools the LLM uses to build durable visual output.
Package scene hosts the nexus.scene plugin — the runtime that owns the Scene store, persists scene state into the session workspace, and exposes scene_create / scene_patch / scene_get / scene_list / scene_delete tools the LLM uses to build durable visual output.
search/anthropic_native
Package anthropicnative implements the search.provider capability backed by Anthropic's server-side web_search tool.
Package anthropicnative implements the search.provider capability backed by Anthropic's server-side web_search tool.
search/brave
Package brave implements a search.provider capability backed by the Brave Search API (https://api.search.brave.com/).
Package brave implements a search.provider capability backed by the Brave Search API (https://api.search.brave.com/).
search/gemini_native
Package geminative implements the search.provider capability backed by Gemini's server-side google_search tool.
Package geminative implements the search.provider capability backed by Gemini's server-side google_search tool.
search/openai_native
Package openainative implements the search.provider capability backed by OpenAI's hosted web_search tool, invoked through the Responses API.
Package openainative implements the search.provider capability backed by OpenAI's hosted web_search tool, invoked through the Responses API.
tools/docs_search
Package docssearch registers the user-facing "search_docs" tool.
Package docssearch registers the user-facing "search_docs" tool.
tools/knowledge_search
Package knowledge_search registers the user-facing "knowledge_search" tool.
Package knowledge_search registers the user-facing "knowledge_search" tool.
tools/screenshot
Package screenshot registers the take_screenshot tool.
Package screenshot registers the take_screenshot tool.
tools/session_tags
Package session_tags registers an opt-in LLM-facing tool surface over the general-namespace session tag store (pkg/engine/session_tags.go): the agent itself can set, read, delete, and list session labels through session_tag_set/get/delete/list.
Package session_tags registers an opt-in LLM-facing tool surface over the general-namespace session tag store (pkg/engine/session_tags.go): the agent itself can set, read, delete, and list session labels through session_tag_set/get/delete/list.
tools/web
Package web registers the user-facing web_search and web_fetch tools.
Package web registers the user-facing web_search and web_fetch tools.
vectorstore/chromem
Package chromem implements the vector.store capability backed by philippgille/chromem-go — a pure-Go, in-memory vector store with JSON on-disk persistence.
Package chromem implements the vector.store capability backed by philippgille/chromem-go — a pure-Go, in-memory vector store with JSON on-disk persistence.
vectorstore/sqlite_fts
Package sqlitefts implements the search.lexical capability backed by SQLite FTS5.
Package sqlitefts implements the search.lexical capability backed by SQLite FTS5.
workflows/icm
Package icm implements the nexus.workflows.icm plugin: a file-driven multi-stage workflow runner inspired by the Interpretable Context Methodology (Van Clief & McDermott, arXiv:2603.16021).
Package icm implements the nexus.workflows.icm plugin: a file-driven multi-stage workflow runner inspired by the Interpretable Context Methodology (Van Clief & McDermott, arXiv:2603.16021).
workflows/icm/icmtypes
Package icmtypes holds tiny shared value types used by both the nexus.workflows.icm plugin (events.go) and its session and predicates subpackages (artifact sidecars, run state, predicate failure events).
Package icmtypes holds tiny shared value types used by both the nexus.workflows.icm plugin (events.go) and its session and predicates subpackages (artifact sidecars, run state, predicate failure events).
workflows/icm/predicates
Package predicates implements the ICM workflow predicate evaluator.
Package predicates implements the ICM workflow predicate evaluator.
workflows/icm/predicates/builtins
Package builtins ships the four baked-in native predicate handlers for the ICM workflow plugin: word_count_under, word_count_over, contains_required_ids, and json_path_exists.
Package builtins ships the four baked-in native predicate handlers for the ICM workflow plugin: word_count_under, word_count_over, contains_required_ids, and json_path_exists.
workflows/icm/runtime
Package runtime — top-level ICM orchestrator.
Package runtime — top-level ICM orchestrator.
workflows/icm/session
Package session owns the on-disk layout of a single ICM workflow run.
Package session owns the on-disk layout of a single ICM workflow run.
workflows/icm/workspace
Package workspace is the pure-Go loader and validator for an ICM workspace folder.
Package workspace is the pure-Go loader and validator for an ICM workspace folder.
tests
integration/mcp_fake command
Fake MCP server used by tests/integration/mcp_client_test.go.
Fake MCP server used by tests/integration/mcp_client_test.go.

Jump to

Keyboard shortcuts

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