runtime/

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/CarriedWorldUniverse/nexus

Links

Open Source Insights

README ¶

runtime/ — agent.exe

Single agent runtime. Provider-agnostic. Comms-first, no PTY.

Invocation: agent.exe <aspect-home-folder>

providers/ — AI backend plug-ins. Contract: invoke / tokenCount / compact.
context/ — session persistence (global.jsonl, threads/.jsonl, or none).
dispatch/ — incoming comms → provider invocation pipeline.
hands/ — kind:"hand" dispatch, concurrency cap, cost attribution.

See spec §2.2–§2.4.

Directories ¶

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

Path	Synopsis
agent Package agent implements the per-aspect runtime.	Package agent implements the per-aspect runtime.
aspect
wsasp
brokercreds Package brokercreds is the aspect-side client helper for fetching kind-typed credentials from the Nexus broker via the credential.fetch WS frame (NEX-77).	Package brokercreds is the aspect-side client helper for fetching kind-typed credentials from the Nexus broker via the credential.fetch WS frame (NEX-77).
cmd
agent command Command agent is the single-aspect runtime binary.	Command agent is the single-aspect runtime binary.
agentfunnel command
aspect command
nexus-comms-mcp command Command nexus-comms-mcp bridges nexus's WebSocket chat substrate to stdio MCP.	Command nexus-comms-mcp bridges nexus's WebSocket chat substrate to stdio MCP.
nexus-github-mcp command GitHub REST API client.	GitHub REST API client.
nexus-imap-mcp command
nexus-issue-mcp command Command nexus-issue-mcp bridges the in-process nexus issue tracker to stdio MCP.	Command nexus-issue-mcp bridges the in-process nexus issue tracker to stdio MCP.
nexus-jira-mcp command Command nexus-jira-mcp bridges Atlassian Jira REST to stdio MCP.	Command nexus-jira-mcp bridges Atlassian Jira REST to stdio MCP.
nexus-watch command Command nexus-watch is a terminal observer for one aspect's observability stream.	Command nexus-watch is a terminal observer for one aspect's observability stream.
nexus-wstest command Command nexus-wstest is a comprehensive WS frame tester that exercises every operator + aspect frame the broker exposes.	Command nexus-wstest is a comprehensive WS frame tester that exercises every operator + aspect frame the broker exposes.
compactor Package compactor implements the proactive compaction trigger per registration spec §2.7.	Package compactor implements the proactive compaction trigger per registration spec §2.7.
context
tree Package tree implements the tree-structured session JSONL format per registration spec §2.6.	Package tree implements the tree-structured session JSONL format per registration spec §2.6.
handexec Package handexec implements dispatch-mode execution for the harness binary.	Package handexec implements dispatch-mode execution for the harness binary.
keyfile
obsforward Package obsforward wires a remote aspect's funnel observability hook to the broker over the existing aspect WS connection.	Package obsforward wires a remote aspect's funnel observability hook to the broker over the existing aspect WS connection.
providers Package providers defines the Nexus Provider interface and the normalised types that flow across the adapter boundary.	Package providers defines the Nexus Provider interface and the normalised types that flow across the adapter boundary.
claude-api Package claudeapi implements the Nexus provider contract against Anthropic's Claude API.	Package claudeapi implements the Nexus provider contract against Anthropic's Claude API.
ollama-local Package ollamalocal implements the embeddings half of the Nexus provider contract against a locally-hosted Ollama instance.	Package ollamalocal implements the embeddings half of the Nexus provider contract against a locally-hosted Ollama instance.
wsclient Package wsclient is the aspect-and-Outpost-side WebSocket client.	Package wsclient is the aspect-and-Outpost-side WebSocket client.