Directories
¶
| Path | Synopsis |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
token_budget
Package tokenbudget implements a multi-dimensional token / cost budget gate.
|
Package tokenbudget implements a multi-dimensional token / cost budget gate. |
|
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. |
|
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. |
|
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). |
|
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). |
|
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. |
|
test
Package testio provides a non-interactive IO plugin for integration testing.
|
Package testio provides a non-interactive IO plugin for integration testing. |
|
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. |
|
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). |
|
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. |
|
summary_buffer
Package summary_buffer provides an inline auto-compacting memory.history provider.
|
Package summary_buffer provides an inline auto-compacting memory.history provider. |
|
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. |
|
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. |
|
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. |
|
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. |
|
planners
|
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
metadata
Package metadata implements a declarative per-step model router.
|
Package metadata implements a declarative per-step model router. |
|
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. |
|
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/). |
|
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. |
|
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. |
|
system
|
|
|
tools
|
|
|
docs_search
Package docssearch registers the user-facing "search_docs" tool.
|
Package docssearch registers the user-facing "search_docs" tool. |
|
knowledge_search
Package knowledge_search registers the user-facing "knowledge_search" tool.
|
Package knowledge_search registers the user-facing "knowledge_search" tool. |
|
screenshot
Package screenshot registers the take_screenshot tool.
|
Package screenshot registers the take_screenshot tool. |
|
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. |
|
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. |
|
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). |
|
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). |
|
icm/predicates
Package predicates implements the ICM workflow predicate evaluator.
|
Package predicates implements the ICM workflow predicate evaluator. |
|
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. |
|
icm/runtime
Package runtime — top-level ICM orchestrator.
|
Package runtime — top-level ICM orchestrator. |
|
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. |
|
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. |
Click to show internal directories.
Click to hide internal directories.