internal/

Package a2a implements a minimal A2A (Agent2Agent) surface for seamlessd: the agent card at /.well-known/agent-card.json and a JSON-RPC endpoint at /api/a2a whose one skill is recall -- another agent on this machine sends a text message and gets the owner's fused memory search results back.

Package agentguide owns the concise, cross-surface guidance that teaches an agent how Seamless's tools compose.

Package bench defines the agent-scenario benchmark: the scenarios an agent is run against, the named conditions (arms) each scenario runs under, and the grading contract that turns a captured run into pass/fail + metrics.

Package capture fetches external URLs into note content behind SSRF guards.

Package config loads Seamless configuration from a single YAML file with SEAMLESS_* environment overrides.

Package console serves the Seamless observability UI: server-rendered html/template pages plus an SSE feed, with no node/npm/React or build step.

Package core holds Seamless domain types shared across packages: Project, Memory, Session, Task, Trial, Event, and their enums.

Package demokit is the shared seeding core that fills a THROWAWAY Seamless data dir with backdated fixtures.

Package events is the append-only event log: the single write path for the record of everything (session lifecycle, memory write/read/supersede, injection, task transition, gardener action).

Package features is the registry of OPTIONAL features: the parts of Seamless the owner can switch on and off from the console without losing any data.

Package files is the markdown layer: memory and note files are the source of truth for durable knowledge.

Package gardener runs the propose-only maintenance passes over the memory corpus: it finds near-duplicate memories (dedup), memories that have gone untouched for too long (staleness), stage memories that stopped carrying a live gate (stale-stage), memories briefings keep injecting without any demand (dead-weight), captured plans that were never approved (stale-plan), recall queries that keep missing because nobody wrote the memory (memory-wanted), errors agents keep hitting on tool calls or hook stages (tool-error), and rolls recent sessions into a monthly digest.

Package gitread reads git repository state straight out of .git, with no exec dependency and no git library: the daemon must work on machines where a git binary may not exist, and hooks fire on every prompt.

Package hooks serves the Claude Code SessionStart and UserPromptSubmit hook endpoints and installs/removes their entries in a settings.json.

Package importer migrates Seam v1 data (~/.seam) into Seamless.

Package lifecycle carries a memory's bi-temporal lifecycle: supersession (one memory replacing another) and provenance.

Package llm provides embedding clients for the configured provider.

Package markdown renders agent-authored markdown as sanitized HTML for the Seamless console.

Package mcp hosts the Seamless MCP tool surface over streamable HTTP with a single static bearer key.

Package plans holds the shared vocabulary of captured Claude Code plans: the note-slug prefixes, the plan-status tag lifecycle, and the tracking-task composition.

Package retrieve assembles what an agent sees from its memory: the session-start briefing, the user-prompt-submit recall block, and the recall tool's fused search.

Package skills installs the release-maintained Seamless agent skills into a selected client's per-user skill home.

Favorite setters for the DB-owned entities.

Package validate provides shared input-validation helpers enforcing the filesystem-safety invariants in AGENTS.md: