Directories
¶
| Path | Synopsis |
|---|---|
|
Package activelearn is the label-agnostic async self-improvement mechanism extracted from the shipped reasoning learner (spike 053).
|
Package activelearn is the label-agnostic async self-improvement mechanism extracted from the shipped reasoning learner (spike 053). |
|
Package agent owns the cornerstone runtime contract every later phase implements or consumes: the open Agent interface, the single-Run-scoped InvocationContext, the forward-compat Event/Actions/LLMResponse shape, the OTel-correct trace IDs, and the Budget tree that bounds a run.
|
Package agent owns the cornerstone runtime contract every later phase implements or consumes: the open Agent interface, the single-Run-scoped InvocationContext, the forward-compat Event/Actions/LLMResponse shape, the OTel-correct trace IDs, and the Budget tree that bounds a run. |
|
agenttest
Package agenttest holds the shared Agent mocks (D-07) that the workflow tests (Plan 05 Sequential/Loop, Plan 06 Parallel), the CLI dry-run (Plan 07), and future Phase 3/9 all reuse — one source of truth, zero inline mock duplication (CLAUDE.md "reusable code").
|
Package agenttest holds the shared Agent mocks (D-07) that the workflow tests (Plan 05 Sequential/Loop, Plan 06 Parallel), the CLI dry-run (Plan 07), and future Phase 3/9 all reuse — one source of truth, zero inline mock duplication (CLAUDE.md "reusable code"). |
|
display
Package display is the trust boundary for Phase-26's typed-display protocol (GAP-1 / HARDEN-08).
|
Package display is the trust boundary for Phase-26's typed-display protocol (GAP-1 / HARDEN-08). |
|
mcptools
Package mcptools bridges a generic MCP server's tools into Aura's agent tool registry: it lists the server's tools and adapts each to a tools.Tool whose Execute routes through the MCP client's tools/call.
|
Package mcptools bridges a generic MCP server's tools into Aura's agent tool registry: it lists the server's tools and adapts each to a tools.Tool whose Execute routes through the MCP client's tools/call. |
|
prompt
Package prompt owns the single wire-Request assembly chokepoint (PromptBuilder) and the content fingerprint (PrefixHash) that the cache-invariant gate reads.
|
Package prompt owns the single wire-Request assembly chokepoint (PromptBuilder) and the content fingerprint (PrefixHash) that the cache-invariant gate reads. |
|
tools
Package tools defines the tool interface the agent loop dispatches against, the deferred-tool flag that keeps big specs out of the default LLM manifest, and the built-in `tool_search` hook the model uses to fetch deferred specs.
|
Package tools defines the tool interface the agent loop dispatches against, the deferred-tool flag that keeps big specs out of the default LLM manifest, and the built-in `tool_search` hook the model uses to fetch deferred specs. |
|
workflow
Pattern derivato da google/adk-go v1.4.0 agent/workflowagents/loopagent/agent.go (Apache 2.0).
|
Pattern derivato da google/adk-go v1.4.0 agent/workflowagents/loopagent/agent.go (Apache 2.0). |
|
auth.go is the WEB-03 in-binary web-auth boundary (D-01..D-04): a constant-time operator-secret login that mints an HMAC-signed session cookie, a RequireAuth middleware that gates the whole origin except the public paths (login + assets + GET /healthz), a POST /logout that clears the cookie, and a capability gate on the only mutating route (POST /agent/run).
|
auth.go is the WEB-03 in-binary web-auth boundary (D-01..D-04): a constant-time operator-secret login that mints an HMAC-signed session cookie, a RequireAuth middleware that gates the whole origin except the public paths (login + assets + GET /healthz), a POST /logout that clears the cookie, and a capability gate on the only mutating route (POST /agent/run). |
|
Package askuser is the per-domain Store over aura.paused_states (PRD 1.5).
|
Package askuser is the per-domain Store over aura.paused_states (PRD 1.5). |
|
Package assets persists multimodal asset lifecycle state.
|
Package assets persists multimodal asset lifecycle state. |
|
Package cachemetrics is the per-domain Store over aura.cache_metrics (PRD Slice 4 / Phase 6, D-02).
|
Package cachemetrics is the per-domain Store over aura.cache_metrics (PRD Slice 4 / Phase 6, D-02). |
|
Package canonicaljson is a deterministic serializer for Aura-internal hashing.
|
Package canonicaljson is a deterministic serializer for Aura-internal hashing. |
|
Package channels is the daemon channels framework (Phase 13 / Slice 9a, UX-02): a Channel interface + Registry that the bootServe lifecycle mounts as a fail-soft subsystem, with Telegram (internal/channels/telegram) the first real channel.
|
Package channels is the daemon channels framework (Phase 13 / Slice 9a, UX-02): a Channel interface + Registry that the bootServe lifecycle mounts as a fail-soft subsystem, with Telegram (internal/channels/telegram) the first real channel. |
|
telegram
Package telegram — this file is the per-turn AG-UI fanout consumer (the Phase-12 seam).
|
Package telegram — this file is the per-turn AG-UI fanout consumer (the Phase-12 seam). |
|
Package config is the thin root composite read by every cmd/aura subcommand.
|
Package config is the thin root composite read by every cmd/aura subcommand. |
|
Package conversations is the per-domain Store over aura.conversations + aura.conversation_turns + aura.context_rot_events (PRD 1.8 / 1.8.5).
|
Package conversations is the per-domain Store over aura.conversations + aura.conversation_turns + aura.context_rot_events (PRD 1.8 / 1.8.5). |
|
Package cron is the Phase 10 scheduler: the at|every|cron schedule engine (this file), the thin sqlc Store over scheduler_tasks + agent_job_runs (store.go), and — landing in downstream waves — the tick loop, held-conn advisory-lock claim, heartbeat, and recovery scan.
|
Package cron is the Phase 10 scheduler: the at|every|cron schedule engine (this file), the thin sqlc Store over scheduler_tasks + agent_job_runs (store.go), and — landing in downstream waves — the tick loop, held-conn advisory-lock claim, heartbeat, and recovery scan. |
|
handlers
Package handlers holds the per-TaskKind scheduler handlers (D-28 / Slice 0.9): each TaskKind is ONE file with a Handler impl + a HandlerMeta — no central dispatch switch.
|
Package handlers holds the per-TaskKind scheduler handlers (D-28 / Slice 0.9): each TaskKind is ONE file with a Handler impl + a HandlerMeta — no central dispatch switch. |
|
Package db owns Postgres connectivity for Aura — pgxpool open, golang-migrate runner, ping/status/reset helpers, and the redactDSN error-wrap discipline (T-1.05-01 mitigation).
|
Package db owns Postgres connectivity for Aura — pgxpool open, golang-migrate runner, ping/status/reset helpers, and the redactDSN error-wrap discipline (T-1.05-01 mitigation). |
|
Package documents implements Aura's document ingestion domain.
|
Package documents implements Aura's document ingestion domain. |
|
Package eval hosts Aura's LIVE, operator-authorized evaluation harnesses.
|
Package eval hosts Aura's LIVE, operator-authorized evaluation harnesses. |
|
Package identity is the canonical per-domain Store over the generated sqlc surface (D-A2-01).
|
Package identity is the canonical per-domain Store over the generated sqlc surface (D-A2-01). |
|
MCP subprocess client for mcp-neo4j-cypher (Pattern 3).
|
MCP subprocess client for mcp-neo4j-cypher (Pattern 3). |
|
Package llm hosts the streaming LLM client interface and an OpenAI-compatible implementation.
|
Package llm hosts the streaming LLM client interface and an OpenAI-compatible implementation. |
|
openai_compat
Package openai_compat is the handrolled OpenAI-compatible HTTP+SSE streaming client implementing llm.Client.
|
Package openai_compat is the handrolled OpenAI-compatible HTTP+SSE streaming client implementing llm.Client. |
|
Package mcp is a generic stdio MCP (Model Context Protocol) client: it spawns any MCP server that speaks JSON-RPC 2.0 over newline-delimited stdio, performs the initialize handshake, and exposes tools/list + tools/call.
|
Package mcp is a generic stdio MCP (Model Context Protocol) client: it spawns any MCP server that speaks JSON-RPC 2.0 over newline-delimited stdio, performs the initialize handshake, and exposes tools/list + tools/call. |
|
Package obs centralizes process observability bootstrap: structured logs, redaction, and the global OpenTelemetry tracer provider.
|
Package obs centralizes process observability bootstrap: structured logs, redaction, and the global OpenTelemetry tracer provider. |
|
Package profile stores per-identity Agent.md profiles on disk.
|
Package profile stores per-identity Agent.md profiles on disk. |
|
Package reasoningfifo is a rune-capped rolling buffer for streamed chain-of-thought reasoning text.
|
Package reasoningfifo is a rune-capped rolling buffer for streamed chain-of-thought reasoning text. |
|
Package reasoninglearn is the async self-improvement worker for the reasoning classifier (spike 053).
|
Package reasoninglearn is the async self-improvement worker for the reasoning classifier (spike 053). |
|
Package reasoningstore persists oracle-labeled reasoning-tier examples in Neo4j (the existing vector store) and loads them for the embedding classifier to fold into its centroids — the self-improvement substrate validated in spike 053.
|
Package reasoningstore persists oracle-labeled reasoning-tier examples in Neo4j (the existing vector store) and loads them for the embedding classifier to fold into its centroids — the self-improvement substrate validated in spike 053. |
|
Package runner is the orchestration layer that ties the Phase-4 substrate together (PRD 1.5 resume + 1.8 lifecycle + 1.8.5 search): the Runner drives the agent turn-by-turn, persists each turn via conversations.Store, is the SOLE writer of aura.paused_states (it observes the Actions.AwaitingInput pause Event and inserts the rows), resolves resumes as a FRESH agent.Run over rehydrated history (SC-4: no silent LLM re-run, no duplicate ask_user tool_call), and owns the goleak-clean auto-title WaitGroup (D-A5-01).
|
Package runner is the orchestration layer that ties the Phase-4 substrate together (PRD 1.5 resume + 1.8 lifecycle + 1.8.5 search): the Runner drives the agent turn-by-turn, persists each turn via conversations.Store, is the SOLE writer of aura.paused_states (it observes the Actions.AwaitingInput pause Event and inserts the rows), resolves resumes as a FRESH agent.Run over rehydrated history (SC-4: no silent LLM re-run, no duplicate ask_user tool_call), and owns the goleak-clean auto-title WaitGroup (D-A5-01). |
|
Package scoring is the pure, shared risk-tier module (PRD §Risk-Based Governance, amendment #41 / D-11): it computes a qualitative RiskTier for scheduler tasks and skills so consumers can render an advisory gate.
|
Package scoring is the pure, shared risk-tier module (PRD §Risk-Based Governance, amendment #41 / D-11): it computes a qualitative RiskTier for scheduler tasks and skills so consumers can render an advisory gate. |
|
Package secret holds the canonical secret-env-key predicate shared by every site that filters or redacts environment variables before they reach a child process or an exported config.
|
Package secret holds the canonical secret-env-key predicate shared by every site that filters or redacts environment variables before they reach a child process or an exported config. |
|
Package semindex is Aura's reusable embedding-index core: one shared lock-free pure-math layer (cosine/centroid/margin/bank ops over [][]float64) plus two typed wrappers — Classifier (Centroid mode: argmax over per-group means → best label + top-2 Margin) and Ranker (PerItem mode: top-K cosine over individual docs → []Scored).
|
Package semindex is Aura's reusable embedding-index core: one shared lock-free pure-math layer (cosine/centroid/margin/bank ops over [][]float64) plus two typed wrappers — Classifier (Centroid mode: argmax over per-group means → best label + top-2 Margin) and Ranker (PerItem mode: top-K cosine over individual docs → []Scored). |
|
Package setup is the setup-wizard backend (Phase 13 / Slice 9a, UX-03): an isolated loopback HTTP server (:9081, distinct from the AG-UI gateway :9080) that issues the single-use onboarding token the Telegram channel's /start consumes (plan 13-06) and surfaces onboarding completion over SSE.
|
Package setup is the setup-wizard backend (Phase 13 / Slice 9a, UX-03): an isolated loopback HTTP server (:9081, distinct from the AG-UI gateway :9080) that issues the single-use onboarding token the Telegram channel's /start consumes (plan 13-06) and surfaces onboarding completion over SSE. |
|
Package skilladapters is the composition-root seam that bridges the live *skills.Loader / *skills.Writer onto the consumer-declared tools.skillLoader / tools.skillWriter interfaces the `skill` tool dispatches against.
|
Package skilladapters is the composition-root seam that bridges the live *skills.Loader / *skills.Writer onto the consumer-declared tools.skillLoader / tools.skillWriter interfaces the `skill` tool dispatches against. |
|
Package skills is the read half of Aura's skills system (Slice 7a): a multi-root loader that scans SKILL.md files on disk, parses their YAML frontmatter, and caches the result behind a short TTL.
|
Package skills is the read half of Aura's skills system (Slice 7a): a multi-root loader that scans SKILL.md files on disk, parses their YAML frontmatter, and caches the result behind a short TTL. |
|
Package swarm is the ephemeral per-call coordinator for CAP-03: it fans a set of goals out as LlmAgent workers, runs them in budget-bounded leak-safe waves, isolates per-child failures (a failed child becomes a report entry, siblings keep running — D-02), and collects an ordered []ChildReport.
|
Package swarm is the ephemeral per-call coordinator for CAP-03: it fans a set of goals out as LlmAgent workers, runs them in budget-bounded leak-safe waves, isolates per-child failures (a failed child becomes a report entry, siblings keep running — D-02), and collects an ordered []ChildReport. |
|
Package toolselectlearn is the tool-selection active-learning loop (D-06/D-07, spike 057) — the SECOND consumer of the shared internal/activelearn mechanism after the reasoning learner.
|
Package toolselectlearn is the tool-selection active-learning loop (D-06/D-07, spike 057) — the SECOND consumer of the shared internal/activelearn mechanism after the reasoning learner. |
|
Package toolselectstore persists oracle-confirmed (query-embedding -> tool) tool-selection examples in Neo4j (the existing vector store) and loads them for the tool_search ranker to fold into its per-tool centroids — the self-improvement substrate for D-06/D-07 (spike 057), the SECOND consumer of the activelearn mechanism after the reasoning learner.
|
Package toolselectstore persists oracle-confirmed (query-embedding -> tool) tool-selection examples in Neo4j (the existing vector store) and loads them for the tool_search ranker to fold into its per-tool centroids — the self-improvement substrate for D-06/D-07 (spike 057), the SECOND consumer of the activelearn mechanism after the reasoning learner. |
|
Package web is the Phase 7 shared engine behind the web_search and web_fetch tools.
|
Package web is the Phase 7 shared engine behind the web_search and web_fetch tools. |
|
Package webauth embeds the Authula (Apache-2.0, v1.11.0) Go auth framework as the cockpit's "industrial" web-auth provider, behind the AURA_WEB_AUTH_PROVIDER feature flag (see docs/cockpit-overhaul/05-authula-auth-SPEC.md, Option A2).
|
Package webauth embeds the Authula (Apache-2.0, v1.11.0) Go auth framework as the cockpit's "industrial" web-auth provider, behind the AURA_WEB_AUTH_PROVIDER feature flag (see docs/cockpit-overhaul/05-authula-auth-SPEC.md, Option A2). |
|
Package webui is the single-binary host for the embedded web cockpit.
|
Package webui is the single-binary host for the embedded web cockpit. |
Click to show internal directories.
Click to hide internal directories.