internal/

directory
v1.11.0 Latest Latest
Warning

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

Go to latest
Published: Jul 11, 2026 License: MIT

Directories

Path Synopsis
Package profiles supplies preset agent.Profile constructors.
Package profiles supplies preset agent.Profile constructors.
attachments
Package attachments computes per-turn <system-reminder>-wrapped messages the agent loop prepends to the user's incoming prompts.
Package attachments computes per-turn <system-reminder>-wrapped messages the agent loop prepends to the user's incoming prompts.
loader
Package loader reads user-authored agent definitions from <EVVA_HOME>/agents/{name}/ at startup and turns them into sysprompt.AgentDefinition values the agent.Registry can merge with Go-defined built-ins (sysprompt.MainAgent, ExploreAgent, GeneralAgent).
Package loader reads user-authored agent definitions from <EVVA_HOME>/agents/{name}/ at startup and turns them into sysprompt.AgentDefinition values the agent.Registry can merge with Go-defined built-ins (sysprompt.MainAgent, ExploreAgent, GeneralAgent).
sysprompt
Package sysprompt builds the system prompt for each kind of agent evva runs.
Package sysprompt builds the system prompt for each kind of agent evva runs.
Package checkpoint implements evva's per-turn "checkpoint & rewind" store: before each user turn the runtime records a checkpoint, and the first time a turn's fs tools (edit/write) mutate a file, that file's pre-mutation bytes are captured.
Package checkpoint implements evva's per-turn "checkpoint & rewind" store: before each user turn the runtime records a checkpoint, and the first time a turn's fs tools (edit/write) mutate a file, that file's pre-mutation bytes are captured.
Package memdir loads the on-disk memory that seeds the agent's system prompt at session start, and provides the read primitives for evva's typed-memory directory:
Package memdir loads the on-disk memory that seeds the agent's system prompt at session start, and provides the read primitives for evva's typed-memory directory:
dream
Package dream is the background memory-consolidation ("dream") subsystem: a gated, fenced pass that merges, prunes, and re-indexes the global memory store.
Package dream is the background memory-consolidation ("dream") subsystem: a gated, fenced pass that merges, prunes, and re-indexes the global memory store.
recall
Package recall finds the memory files relevant to a user query via a cheap LLM side-query, so only the few memories that matter get pulled into a turn (the rest stay on disk, surfaced on demand).
Package recall finds the memory files relevant to a user query via a cheap LLM side-query, so only the few memories that matter get pulled into a turn (the rest stay on disk, surfaced on demand).
Package outputstyle implements output styles: thin, stackable prompt overlays that change how the active persona *talks* without redefining who it is.
Package outputstyle implements output styles: thin, stackable prompt overlays that change how the active persona *talks* without redefining who it is.
Package question provides the back-channel between the AskUserQuestion tool (blocked agent goroutine) and the TUI (user interaction).
Package question provides the back-channel between the AskUserQuestion tool (blocked agent goroutine) and the TUI (user interaction).
Package repomap composes a compact, ranked, token-bounded overview of a codebase's symbols from the LSP layer (pkg/tools/lsp), with a glob fallback when no language server is available.
Package repomap composes a compact, ranked, token-bounded overview of a codebase's symbols from the LSP layer (pkg/tools/lsp), with a glob fallback when no language server is available.
Session storage on disk.
Session storage on disk.
skills
bundled
Package bundled registers evva's first-party Markdown skills into a skill.Registry.
Package bundled registers evva's first-party Markdown skills into a skill.Registry.
Package swarm is the per-space coordination core of Veronica, evva's in-process multi-agent swarm subsystem.
Package swarm is the per-space coordination core of Veronica, evva's in-process multi-agent swarm subsystem.
agentdef
Package agentdef is the re-callable loader that turns one on-disk agent directory (agents/{main,sub}/{name}/: system_prompt.md, tools/active.yml, tools/deferr.yml, profile.yml, skills/*) into the public SDK objects needed to construct a live agent — a pkg/agent.AgentDefinition plus a *pkg/skill.Registry — using pkg/* only.
Package agentdef is the re-callable loader that turns one on-disk agent directory (agents/{main,sub}/{name}/: system_prompt.md, tools/active.yml, tools/deferr.yml, profile.yml, skills/*) into the public SDK objects needed to construct a live agent — a pkg/agent.AgentDefinition plus a *pkg/skill.Registry — using pkg/* only.
bus
Package bus is the per-space message bus and mailboxes.
Package bus is the per-space message bus and mailboxes.
doctor
Package doctor is the swarm preflight (DR): `evva swarm doctor` runs the whole register-and-run ladder — manifest → member definitions → models / efforts → provider keys → .vero state → (optionally) the live service — and reports ✓/⚠/✗ per probe, so the expensive mistakes that today explode deep inside a member's first run (a typo'd model pin, a missing API key, a ledger written by a newer binary) surface before anything registers.
Package doctor is the swarm preflight (DR): `evva swarm doctor` runs the whole register-and-run ladder — manifest → member definitions → models / efforts → provider keys → .vero state → (optionally) the live service — and reports ✓/⚠/✗ per probe, so the expensive mistakes that today explode deep inside a member's first run (a typo'd model pin, a missing API key, a ledger written by a newer binary) surface before anything registers.
service
Package service is the process-singleton swarm host: the 127.0.0.1:8888 HTTP/WS server that fronts one or more isolated SwarmSpaces.
Package service is the process-singleton swarm host: the 127.0.0.1:8888 HTTP/WS server that fronts one or more isolated SwarmSpaces.
store
Package store is the single per-space data layer: it opens <workdir>/.vero/vero.db (WAL + busy_timeout, foreign keys on), runs migrations, and exposes a sync.RWMutex-wrapped DAO for the task ledger and the message store.
Package store is the single per-space data layer: it opens <workdir>/.vero/vero.db (WAL + busy_timeout, foreign keys on), runs migrations, and exposes a sync.RWMutex-wrapped DAO for the task ledger and the message store.
tools
Package tools holds Veronica's swarm-specific custom tools, written against pkg/tools.Tool and attached to agents via pkg/agent.WithCustomTool:
Package tools holds Veronica's swarm-specific custom tools, written against pkg/tools.Tool and attached to agents via pkg/agent.WithCustomTool:
tui/app
Package app is the attach TUI (`evva swarm attach`): a Bubble Tea cockpit over one running space.
Package app is the attach TUI (`evva swarm attach`): a Bubble Tea cockpit over one running space.
tui/client
Package client is the attach TUI's service client: thin authenticated REST calls for state snapshots and one WebSocket for the live feed + the interactive gate replies — exactly the surface the web console consumes (process model A: the service builds the agents, this client only reads state and POSTs intent).
Package client is the attach TUI's service client: thin authenticated REST calls for state snapshots and one WebSocket for the live feed + the interactive gate replies — exactly the surface the web console consumes (process model A: the service builds the agents, this client only reads state and POSTs intent).
tui/reduce
Package reduce is the Go port of the web console's event reducers (web2/src/lib/events.ts) — the semantics that turn the swarm's wire events into renderable state.
Package reduce is the Go port of the web console's event reducers (web2/src/lib/events.ts) — the semantics that turn the swarm's wire events into renderable state.
tui/wire
Package wire holds the attach TUI's wire-protocol types: the JSON shapes the swarm service pushes over its WebSocket and /chatlog replay, and the inbound command envelope the socket accepts.
Package wire holds the attach TUI's wire-protocol types: the JSON shapes the swarm service pushes over its WebSocket and /chatlog replay, and the inbound command envelope the socket accepts.
webapi
Package webapi serves the swarm workstation API: REST snapshots (/api/swarms, /api/swarm/:id, /api/tasks, /api/agents/:name/transcript, /api/messages) and a WebSocket bridge that streams each agent's pkg/event.Event out to the browser, fanned out by (spaceID, AgentID).
Package webapi serves the swarm workstation API: REST snapshots (/api/swarms, /api/swarm/:id, /api/tasks, /api/agents/:name/transcript, /api/messages) and a WebSocket bridge that streams each agent's pkg/event.Event out to the browser, fanned out by (spaceID, AgentID).
tools
config
Package configtool implements the `config` tool: a single model-facing handle on evva's runtime settings, mirroring what the interactive /config overlay exposes to the user.
Package configtool implements the `config` tool: a single model-facing handle on evva's runtime settings, mirroring what the interactive /config overlay exposes to the user.
dev
meta
Package meta hosts agent-meta tools: Agent (spawn sub-agent), ToolSearch (load deferred-tool schemas), and ScheduleWakeup (self-pace /loop iterations).
Package meta hosts agent-meta tools: Agent (spawn sub-agent), ToolSearch (load deferred-tool schemas), and ScheduleWakeup (self-pace /loop iterations).
mode
Package mode hosts agent-mode and isolation tools: EnterPlanMode / ExitPlanMode (read-only planning) and EnterWorktree / ExitWorktree (filesystem-isolated worktrees).
Package mode hosts agent-mode and isolation tools: EnterPlanMode / ExitPlanMode (read-only planning) and EnterWorktree / ExitWorktree (filesystem-isolated worktrees).
ux
Package ux hosts user-interaction tools: AskUserQuestion, PushNotification.
Package ux hosts user-interaction tools: AskUserQuestion, PushNotification.
Package toolset is the catalog of every tool the agent can construct.
Package toolset is the catalog of every tool the agent can construct.

Jump to

Keyboard shortcuts

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