Agent Base module review / evidence pass 05 / Library V14 / 2026-07-30
Direct source review found a real family of reusable modules—not one generic framework. The Great Library should give each coherent capability a stable identity, while GitHub repositories follow dependency and release boundaries. A Library Work and a GitHub repo are deliberately not the same thing.
Current state: Agent Runtime is now a verified experimental public release. All thirteen estate repositories are released; none remains a linked placeholder or staging-only home.
Recommended estate: the Great Library plus ten intentional public agent repositories and one private agent-lab incubator—not twenty-two repositories copied from twenty-two folders. The Library can still expose all twenty-two modules independently and later move any Work to its own repo without changing its identity.
Great Library
├── Agents
│ ├── Operating stack
│ │ ├── SISO Project OS project-local agent operating contract
│ │ ├── SISO Agent Runtime installed coding-agent application
│ │ │ ├── Agent Control Core routing, execution, goals, tasks, safety
│ │ │ ├── Session Lifecycle corrections, lessons, checkpoints, restore
│ │ │ ├── Context Manager budgets, memory, retained evidence, compaction
│ │ │ ├── Status & Evidence operator visibility and commands
│ │ │ ├── Agent TUI Kit terminal components, adapters, runtime UI
│ │ │ └── Profile Composer shared instructions projected per tool
│ │ ├── Herdr workspace in which the stack is operated
│ │ └── Agent Zero user-facing coordinator
│ │ ├── Boot & Rehydration wakes from shared state
│ │ └── Voice Gateway staged voice-to-agent interface
│ ├── Capabilities
│ │ ├── Skills Catalog atomic repeatable capabilities
│ │ └── Agent Playbook compositions of skills for scenarios
│ ├── Shared intelligence
│ │ ├── Agent Brain Service shared state, memory, tasks, fleet, timeline
│ │ └── Session Intelligence learns from explicit agent sessions
│ └── Assurance & integrations
│ ├── Atlas read-only architecture auditor
│ ├── Context Firewall shadow measurement and promotion rail
│ └── Headroom Adapter opt-in lossless context sidecar
│
├── Research
│ ├── Foundry source discovery, evaluation and preservation
│ │ └── Research Topic Registry stable research buckets and artifact links
│ └── Evidence Engines
│ ├── Knowledge Engine sources → grounded knowledge and taxonomy
│ ├── Principles Engine evidence → canonical engineering guidance
│ └── Idea Engine evidence → ranked improvement backlog
│
└── Source records
└── Agent Base Source Warehouse retired extraction source, not architecture
This is an ownership and dependency map, not a permanent folder taxonomy. Relationships live in registry data, so a module can move between repositories or graduate from package to repo without breaking its Library address.
| Module | Outcome found in source | Library action | Repository verdict |
|---|---|---|---|
SISO Agent Runtimeinstall.sh · bin · apps/siso-tui | The installed and launched coding-agent product shell. | Released Work | One clean Runtime repo now publishes the provider-neutral shell and six contracts. Full Pi routing and raw TUI parity remain explicit migration work. |
Agent Control Coreextensions/siso-agent-router | Routing, spawning, workflows, tasks, goals, registries, mailbox, supervision, scorecards, review, worktrees, and write-scope safety. | Runtime Work | Package inside the runtime repo. First split its eighty files into internal domains with explicit contracts; do not create a repo per filename group. |
Session Lifecycleextensions/siso-lifecycle | Correction capture, lesson draining, checkpoints, and session restore discovery. | Runtime Work | Named runtime package. Graduate only if another host adopts its contract independently. |
Context Managerextensions/siso-context-manager | Token budgets, deterministic distillation, retained goals and evidence, child/mailbox state, memory, and compact prompts. | Runtime Work | Named runtime package with fixture-tested compact-packet contract. |
Status & Evidence Surfaceextensions/siso-status | Status, widgets, notifications, commands, tools, and custom operator message rendering. | Runtime Work | Package inside runtime; presentation depends on the host lifecycle. |
Agent TUI Kitpackages/siso-tui | Renderer-neutral terminal contracts, components, adapters, theme, runtime behavior, and the OpenTUI shell. | Runtime Work | Package in runtime monorepo initially. It can later become its own repo if non-runtime tools adopt it. |
Agent Profile Composerbrain | One shared behavioral core composed into Claude- and Codex-specific generated instruction profiles. | Runtime Work | Package in runtime first; a small independent repo is justified only when several products consume versioned profiles. |
SISO Project OSsiso-project-os | Project-local schemas, CLI, agent operating rules, and lifecycle contracts. | Already a Work | Already an independent clean repo. Link it; stop physically nesting it in Agent Base. |
SISO Agent Playbooksiso-agent-playbook | Installable fleet operating package containing playbooks, prompts, skills, tools, telemetry, and evidence. | Released | Verified public Lordsisodia repo preserves its warehouse modifications and independent history. |
Skills Catalogtemplates/profile/skills | Atomic repeatable agent capabilities currently projected into user skill roots by the runtime installer. | Released | The public hub validates 28 Skills and supports independent promotion when installation, forking, release, or ownership becomes real. |
SISO Foundryfoundry · research/repo-catalog | Source-mining and reusable-source knowledge product with pipeline, databases, method, and read-only interface. | Released in Research | The portable code plane is public; large corpora and databases remain behind typed data locators. |
Agent Brain Serviceextensions/braind | Authoritative shared state service: memory, tasks, timeline, fleet, cost, notifications, questions, delegation, tiered auth, client outbox, and health checks. | Released | Public configurable service excludes personal topology and runtime state; install, auth, replay, merge, and state-preserving uninstall pass. |
Session Intelligenceextensions/session-mirror | Parses Claude/Codex sessions; mines evidence quotes, goals, failures, intentions and wins; clusters recurrence; scores importance; renders recall; proposes gated improvements. | Released in Agents | Public provider-neutral core requires explicit inputs, redacts before persistence, stores no raw transcript, and passes fixture privacy checks. |
Knowledge Engineextensions/knowledge-engine | Long-form source ingestion into traceable value items and an emergent taxonomy using a distill-once, route-many pipeline. | Released in Research | Reusable grounding and value-item contracts live in siso-evidence-engines; generated knowledge and private corpora stay external. |
Principles Engineextensions/codex-engine | Credibility-tiered evidence gates, proposals, ratings, and canonical engineering principles. | Released in Research | Public outcome name avoids product-name confusion; source tiers, corroboration, jury votes, and deterministic scores are retained. |
Idea Engineextensions/idea-engine | Grounded, novel, right-layer, non-gameable improvement ideas moving through proposed, rated, queued, applied, or rejected states. | Released in Research | Shares evidence primitives with its siblings; autonomous target mutation and machine scheduling are excluded. |
Agent Zero Bootextensions/agent-zero | Rehydrates Agent Zero from fleet, task, memory, timeline, question, and division state before interaction. | Agent Zero Work | Move into the existing Agent Zero source boundary. It is a module of that product, not another repository. |
Voice Gatewayextensions/agent-zero-voice · extensions/voice | A safe typed plan/receipt/replay contract plus an earlier browser-speech-to-Herdr prototype. | Experimental | Reconcile under Agent Zero. Preserve idempotency, risk, replay, and approval gates; create a standalone repo only if the interface becomes host-agnostic. |
Research Topic Registryextensions/research-topics | Creates or matches stable research buckets, links artifacts with provenance, and merges without deleting history. | Foundry Work | Package inside Foundry unless independent consumers prove a separate lifecycle. |
Atlasatlas | Read-only persistent architecture auditor that triangulates three critics and files tickets only on agreement. | Verify + extract | Own repo after one live-use and dependency verification pass. Its outcome and safety boundary are independently coherent. |
Context Firewallintegrations/context-firewall | Shadow-only loopback measurement rail with numeric/private telemetry and an explicit transform promotion gate. | Experimental Work | Package in siso-agent-integrations; no own repo or core-runtime status yet. |
Headroom Adapterintegrations/headroom | Version-pinned, opt-in, lossless sidecar harness with Oracle contracts, canaries, and rollback. | Experimental Work | Package beside Context Firewall. Keep the current non-promotion verdict visible until the cache gate is measurable. |
great-library-of-sisoStable identities, relationships, evidence, releases, human pages, and source inventories. Already live.siso-agent-runtimeRuntime app plus control core, lifecycle, context, status, TUI, and profile packages.siso-project-osAlready independent. Link it rather than nest it.siso-agent-zeroCoordination capability plus boot/rehydration and staged voice-interface packages.siso-agent-playbookReleased operating package with preserved history and reversible installation.siso-skills-hubReleased capability catalog and distribution. Mature Skills may graduate to their own repos.siso-foundryReleased Research code plane plus research-topic registry; datasets remain external.siso-agent-brainReleased configurable shared state service, client, schema, migrations, auth, and doctor.siso-session-intelligenceReleased privacy-reduced transcript adapters, insights, scoring, and recall.siso-evidence-enginesReleased Research family for knowledge, principles, and ideas sharing evidence primitives.siso-agent-integrationsReleased experimental adapters with explicit promotion verdicts.Later, only if proven: siso-atlas, a standalone voice gateway, independently forkable skill repositories, and independently released evidence engines. Stable Library IDs mean those later splits do not break links.
| Current material | Long-term owner | Why |
|---|---|---|
| Installer, CLI, loaded extensions, Pi/OpenTUI app | siso-agent-runtime | One installed application with one release lifecycle. |
siso-project-os | siso-project-os | Already an independent project operating contract. |
siso-agent-playbook | siso-agent-playbook | Already an independently installable fleet operating package. |
templates/profile/skills | siso-skills | Capabilities need identity and releases independent of the runtime application. |
| Agent Zero boot and voice code | siso-agent-zero | They extend the user-facing coordinating agent rather than the generic runtime. |
| Foundry and research-topic registry | siso-foundry | One source-discovery and research-catalog outcome; large datasets stay external. |
braind | siso-agent-brain | A persistent shared-state service with its own API, client, schema and operational lifecycle. |
session-mirror | siso-session-intelligence | A distinct privacy-sensitive learning pipeline over agent transcripts. |
| Knowledge, coding-principles and idea engines | siso-evidence-engines | Three independent Works sharing evidence, scoring, provenance and promotion primitives. |
| Context Firewall and Headroom adapter | siso-agent-integrations | Reusable experiments with explicit safety and promotion contracts. |
siso-agentlabs, Web Chat and unfinished harness/interface spikes | private siso-agent-lab | Incubation and comparison material; successful modules graduate outward, failed experiments remain traceable or enter the vault. |
| SISO Internal Lab / LifeLock and internal operations application | SISO_Internal_Lab, unchanged | It owns internal products and operations, not reusable agent infrastructure or an agent R&D attic. |
Promotion flow: private siso-agent-lab → proven public package or Work → its owning public repo → indexed by the Great Library. The private lab is temporary incubation, never the canonical home of a released capability.
| Current material | Correct treatment | Reason |
|---|---|---|
apps/siso-os cmux fork/WIP | External ledger | Preserve the upstream fork, SISO branch, and dirty patch separately; it is not Agent Runtime source and is marked superseded by Herdr. |
packages/design-tokens | Route to shared UI | It has cross-product design ownership, not agent-system ownership. |
office · runtime · data · eval output | Private/data stores | Databases, telemetry, generated evidence, and machine state are data products or private state, not code modules. |
archive · imports · upstream clones · corpora | Vault or manifest | The Library should index provenance and locators without putting terabytes or unreviewed third-party source into application repos. |
Root scripts and 208 smoke commands | Distribute to owners | A test belongs with the module whose public contract it proves. |
Security gate: direct review found an embedded provider credential in the warehouse Session Intelligence configuration. The public repository was clean-room implemented and contains neither that configuration nor its Git history. The original provider credential still requires external revocation and rotation.
siso-agent-lab; do not move them into SISO_Internal_Lab.The verdicts above come from direct reads of module entrypoints, type contracts, READMEs, architecture documents, migrations, pipeline stages, safety gates, package manifests, and nested Git state. Semantic search through the registered project service was attempted but did not complete in a bounded time, so targeted source reads were used as the required fallback.
The source inventory remains partial: Runtime parity beyond the clean foundation, Atlas current-use verification, Agent Labs and Web Chat supersession comparisons, and individual Skill promotion evidence still require direct follow-up. No files were moved or edited inside the dirty Agent Base warehouse.
Repository decomposition · Skill repository map · SISO Agent Stack model · Open Agents