Directories
¶
| Path | Synopsis |
|---|---|
|
Package app turns a validated config.Config into a wired, ready-to-run Korvun system (ADR-0017 §0).
|
Package app turns a validated config.Config into a wired, ready-to-run Korvun system (ADR-0017 §0). |
|
Package brain declares the minimal contract a reasoning engine must implement to participate in Korvun's router.
|
Package brain declares the minimal contract a reasoning engine must implement to participate in Korvun's router. |
|
Package buildinfo formats the binary's version identity for the --version flag (ADR-0025 §2).
|
Package buildinfo formats the binary's version identity for the --version flag (ADR-0025 §2). |
|
Package bus is Korvun's in-process event bus: a best-effort, non-blocking publish/subscribe tap over the message pipeline's lifecycle (ADR-0023, Stage 14 Phase 1a).
|
Package bus is Korvun's in-process event bus: a best-effort, non-blocking publish/subscribe tap over the message pipeline's lifecycle (ADR-0023, Stage 14 Phase 1a). |
|
Package channel defines the interface that every messaging adapter must implement, along with a registry for managing active channels.
|
Package channel defines the interface that every messaging adapter must implement, along with a registry for managing active channels. |
|
console
Package console is the internal direct-chat channel (operator-console spec FR-CONS-1): a first-class channel.Channel with NO network — the operator talks to the brains from the app itself.
|
Package console is the internal direct-chat channel (operator-console spec FR-CONS-1): a first-class channel.Channel with NO network — the operator talks to the brains from the app itself. |
|
discord
Package discord is the Discord channel adapter (Piece 4, ADR-0033).
|
Package discord is the Discord channel adapter (Piece 4, ADR-0033). |
|
telegram
Package telegram is the Korvun channel adapter for Telegram Bot updates.
|
Package telegram is the Korvun channel adapter for Telegram Bot updates. |
|
webhook
Package webhook implements a generic webhook channel adapter that converts arbitrary JSON payloads into Envelopes using a configurable field mapping.
|
Package webhook implements a generic webhook channel adapter that converts arbitrary JSON payloads into Envelopes using a configurable field mapping. |
|
Package cli is the command-line surface of the korvun binary (Piece 3): it parses argv, dispatches the subcommands (serve / config / status / version / help), and owns the retrocompat shim so the pre-CLI invocation `korvun -config x.json` keeps behaving as an implicit `serve`.
|
Package cli is the command-line surface of the korvun binary (Piece 3): it parses argv, dispatches the subcommands (serve / config / status / version / help), and owns the retrocompat shim so the pre-CLI invocation `korvun -config x.json` keeps behaving as an implicit `serve`. |
|
Package config parses and validates a Korvun deployment descriptor from a JSON file into a typed Config (ADR-0017 §1).
|
Package config parses and validates a Korvun deployment descriptor from a JSON file into a typed Config (ADR-0017 §1). |
|
This file adds the operator-console surface of the control API (operator-console spec 2026-08-08, SP3: FR-API-1/1b/1c/2/3).
|
This file adds the operator-console surface of the control API (operator-console spec 2026-08-08, SP3: FR-API-1/1b/1c/2/3). |
|
Package conversation owns the conversation-memory domain: the canonical conversation Key, the Turn record, the Role of a turn, and the Store seam the Brain reads from before a dispatch and writes to after a reply (ADR-0018, Stage 9 ADR-A).
|
Package conversation owns the conversation-memory domain: the canonical conversation Key, the Turn record, the Role of a turn, and the Store seam the Brain reads from before a dispatch and writes to after a reply (ADR-0018, Stage 9 ADR-A). |
|
sqlite
Package sqlite is the durable implementation of the conversation.Store seam (ADR-0019, Stage 9 ADR-B), backed by SQLite through the pure-Go modernc.org/sqlite driver (no cgo — decisive for the Pi/ARM cross-compile).
|
Package sqlite is the durable implementation of the conversation.Store seam (ADR-0019, Stage 9 ADR-B), backed by SQLite through the pure-Go modernc.org/sqlite driver (no cgo — decisive for the Pi/ARM cross-compile). |
|
Package envelope defines the canonical message type used throughout Korvun.
|
Package envelope defines the canonical message type used throughout Korvun. |
|
Package httpserver is a small, general HTTP server with a Start/Shutdown lifecycle the app drives (ADR-0020 §4).
|
Package httpserver is a small, general HTTP server with a Start/Shutdown lifecycle the app drives (ADR-0020 §4). |
|
Package liveview is Korvun's read-only live-view: a Server-Sent Events stream of the message pipeline's lifecycle (GET /api/events) plus a minimal embedded vanilla HTML/JS UI (/ui), both mounted on the existing admin httpserver (ADR-0024, Stage 14 Phase 1b).
|
Package liveview is Korvun's read-only live-view: a Server-Sent Events stream of the message pipeline's lifecycle (GET /api/events) plus a minimal embedded vanilla HTML/JS UI (/ui), both mounted on the existing admin httpserver (ADR-0024, Stage 14 Phase 1b). |
|
Package metrics owns the observability seam (ADR-0020 §2): a push interface the domain records operational events through, plus a Nop default so a nil backend is never possible.
|
Package metrics owns the observability seam (ADR-0020 §2): a push interface the domain records operational events through, plus a Nop default so a nil backend is never possible. |
|
prom
Package prom is the Prometheus implementation of the metrics.Metrics seam (ADR-0020 §2).
|
Package prom is the Prometheus implementation of the metrics.Metrics seam (ADR-0020 §2). |
|
Package model defines the abstraction every reasoning provider in Korvun talks through.
|
Package model defines the abstraction every reasoning provider in Korvun talks through. |
|
fanout
Package fanout coordinates the parallel dispatch of a single model.Request to N model.Model implementations and collects every outcome.
|
Package fanout coordinates the parallel dispatch of a single model.Request to N model.Model implementations and collects every outcome. |
|
groq
Package groq implements internal/model.Model against the Groq cloud API.
|
Package groq implements internal/model.Model against the Groq cloud API. |
|
ollama
Package ollama implements internal/model.Model against a local Ollama server.
|
Package ollama implements internal/model.Model against a local Ollama server. |
|
openaicompat
Package openaicompat implements internal/model.Model against ANY OpenAI-compatible chat-completions endpoint — cloud or local — selected by config alone (ADR-0044, the universal model gateway).
|
Package openaicompat implements internal/model.Model against ANY OpenAI-compatible chat-completions endpoint — cloud or local — selected by config alone (ADR-0044, the universal model gateway). |
|
retry
Package retry provides a per-instance decorator over model.Model that owns the per-attempt deadline for every dispatch shape and retries ONLY genuinely transient post-load errors (ADR-0031 Decisions 4 and 5).
|
Package retry provides a per-instance decorator over model.Model that owns the per-attempt deadline for every dispatch shape and retries ONLY genuinely transient post-load errors (ADR-0031 Decisions 4 and 5). |
|
sequential
Package sequential coordinates the SERIAL dispatch of a single model.Request to N model.Model implementations, stopping at the first success.
|
Package sequential coordinates the SERIAL dispatch of a single model.Request to N model.Model implementations, stopping at the first success. |
|
Package policy turns the outcomes of a model fan-out into a single Decision according to a configurable dispatch policy.
|
Package policy turns the outcomes of a model fan-out into a single Decision according to a configurable dispatch policy. |
|
Package router wires inbound Envelopes from channels to brains and outbound replies back to channels.
|
Package router wires inbound Envelopes from channels to brains and outbound replies back to channels. |
|
Package shell is the desktop shell's lifecycle logic (ADR-0035 §3a): plain Go functions — load a config, start/stop the in-process core under the reload supervisor, the ephemeral-port policy, per-cycle admin-bearer provisioning, secret provisioning from the OS keychain (the SecretStore seam; real backend in the keyring subpackage), status, and the same-origin admin proxy the WebView rides (ProxyHandler, ADR-0035 §3b) — with NO Wails import, so everything tests as ordinary Go with -race.
|
Package shell is the desktop shell's lifecycle logic (ADR-0035 §3a): plain Go functions — load a config, start/stop the in-process core under the reload supervisor, the ephemeral-port policy, per-cycle admin-bearer provisioning, secret provisioning from the OS keychain (the SecretStore seam; real backend in the keyring subpackage), status, and the same-origin admin proxy the WebView rides (ProxyHandler, ADR-0035 §3b) — with NO Wails import, so everything tests as ordinary Go with -race. |
|
keyring
Package keyring is the real OS-keychain backend behind shell.SecretStore (ADR-0035 §4, ADR-0037): Keychain Services on macOS, Credential Manager on Windows, Secret Service D-Bus on Linux — via zalando/go-keyring, the only package in the repo that imports it.
|
Package keyring is the real OS-keychain backend behind shell.SecretStore (ADR-0035 §4, ADR-0037): Keychain Services on macOS, Credential Manager on Windows, Secret Service D-Bus on Linux — via zalando/go-keyring, the only package in the repo that imports it. |
|
logsink
Package logsink is the desktop's file log sink (v0.9.1, app-audit finding B3).
|
Package logsink is the desktop's file log sink (v0.9.1, app-audit finding B3). |
|
Package skill is Korvun's read-only loader of AgentSkills-compatible markdown skills (ADR-0041 §6): directories holding a SKILL.md whose YAML frontmatter is parsed with an in-house FLAT-subset parser (R-3 — zero dependencies; the two REQUIRED AgentSkills fields are flat strings).
|
Package skill is Korvun's read-only loader of AgentSkills-compatible markdown skills (ADR-0041 §6): directories holding a SKILL.md whose YAML frontmatter is parsed with an in-house FLAT-subset parser (R-3 — zero dependencies; the two REQUIRED AgentSkills fields are flat strings). |
|
Package supervisor owns the Korvun app lifecycle ABOVE a single *app.App (ADR-0027).
|
Package supervisor owns the Korvun app lifecycle ABOVE a single *app.App (ADR-0027). |
|
Package tool owns the agent Tool seam (ADR-0021 §4): the interface an AgentBrain invokes mid-reasoning, plus the minimal, PURE built-in tools the Stage 8 seam-validation slice ships.
|
Package tool owns the agent Tool seam (ADR-0021 §4): the interface an AgentBrain invokes mid-reasoning, plus the minimal, PURE built-in tools the Stage 8 seam-validation slice ships. |
Click to show internal directories.
Click to hide internal directories.