Expand description
Storage layer: SQLite-backed object store and file store. Port of Go’s pkg/mstore and pkg/filestore.
Re-exports§
pub use agent_bundles::agent_picked_bundles;pub use agent_bundles::format_agent_bundle_block;pub use agent_bundles::join_startup_blocks;pub use agent_native_memory_versions::NativeMemoryVersion;pub use agent_native_memory_versions::NativeMemoryVersionSummary;pub use bundle_versions::BundleVersion;pub use bundle_versions::BundleVersionSummary;pub use agents::AgentDefinition;pub use agents::InstanceUpdate;pub use content::AgentContent;pub use error::StoreError;pub use history::AgentHistory;pub use mcp_servers::McpServer;pub use mcp_servers::McpServerReach;pub use bundles::format_global_bundle_block;pub use bundles::global_bundle_sections;pub use bundles::BundleReseedOutcome;pub use bundles::GlobalMemorySection;pub use skills::AgentSkill;pub use skills::Skill;
Modules§
- agent_
activity_ summaries - On-demand, once-per-definition activity summary — see
db_agent_activity_summariesin migrations.rs (OBJECT_SCHEMA_VERSIONv27) and docs/reports/REPORT_AGENT_PICKER_FIELD_ORDER_SORT_AND_DATA_GAPS_AUDIT_2026_08_24.md §5a. - agent_
bundles - An agent’s Bundles list: the bundles picked for it, in order
(
SPEC_RENAME_KNOWLEDGE_TO_MEMORY_2026_10_06.md§3.6). - agent_
credentials - Per-agent M2M Cognito credential for muxbus Tier-4 credential binding. See db_agent_credentials in migrations.rs (SHARED_STORE_SCHEMA_VERSION v4). The relay side is designed in the private cloud repo.
- agent_
groups - Saved fleet-control target groups — see
db_agent_groupsin migrations.rs (OBJECT_SCHEMA_VERSIONv24) and docs/specs/SPEC_MULTI_AGENT_FLEET_CONTROL_2026_08_20.md. - agent_
jekt_ keys - Per-agent HMAC-SHA256 signing key for host-tier jekt sender verification. See db_agent_jekt_keys in migrations.rs (OBJECT_SCHEMA_VERSION v18) and docs/specs/SPEC_JEKT_TRUST_LAYER_COMPLETION_2026_08_13.md §2.2.
- agent_
lan_ keys - Per-agent Ed25519 keypair for LAN-tier jekt sender verification. See db_agent_lan_keys in migrations.rs (OBJECT_SCHEMA_VERSION v19) and docs/specs/SPEC_JEKT_LAN_TIER_SIGNING_2026_08_15.md §2.1.
- agent_
native_ memory - Durable, location-consistent mirror of each agent’s native (Claude Code) memory files. See db_agent_native_memory in migrations.rs (SHARED_STORE_SCHEMA_VERSION v6 / OBJECT_SCHEMA_VERSION v14) and docs/specs/SPEC_NATIVE_MEMORY_DURABLE_SYNC_2026_08_07.md for the full design.
- agent_
native_ memory_ versions - Append-only version history for native memory content. See
db_agent_native_memory_versionsin migrations.rs (SHARED_STORE_SCHEMA_VERSIONv8 /OBJECT_SCHEMA_VERSIONv24 /IDENTITY_STORE_SCHEMA_VERSIONv3) and docs/specs/SPEC_MEMORY_VERSION_CONTROL_AND_ARMORY_AUDIT_2026_08_19.md for the full design. - agent_
tokens - Per-agent local identity token, keyed by the agent’s UID (
db_agents.id). - agent_
uid_ keys - Identity M4d-2: each agent’s LAN and WAN signing keypairs filed under its
UID (
db_agents.id), beside the name-keyed tables they are copied from (SPEC_AGENT_IDENTITY_CARRIED_NOT_DERIVED_2026_09_23.md§6.5.10). - agent_
wan_ keys - Per-agent Ed25519 keypair for general agent-to-agent WAN-tier jekt
signing. See
db_agent_wan_keysin migrations.rs (OBJECT_SCHEMA_VERSION v36). - agents
- Agent subsystem — definitions, instances, and their lifecycle CRUD.
- agents_
consolidate - Phase 3a — one-shot backfill from
db_agent_definitions+db_agent_instancesinto the new consolidateddb_agentstable. - background_
tasks - Durable registry of declared long-running (
run_in_background: true) tasks attached to a block. Seedb_background_tasksin migrations.rs (OBJECT_SCHEMA_VERSIONv20) and docs/status/STATUS_ATTACHED_TASK_AXIS_AND_DEV_LOOP_2026_08_15.md. - bundle_
versions - Append-only version history for Global Memory entry content — mirrors
agent_native_memory_versions.rs’s shape exactly, adapted for a singlebundle_idkey instead of that table’s composite(agent_id, filename)(a Bundle’s identity is already a single id). Seedocs/specs/SPEC_AGENT_FACING_GLOBAL_MEMORY_API_2026_09_15.mdPhase 0 — Global Memory (db_bundles) previously had no audit trail at all, onlyupdated_at; this exists specifically because Global Memory is about to gain a write path an agent, not just a human in Memory, can reach. - bundles
- Bundles — the agent’s personality and capability stack (provider, model, instructions, context files, MCP servers, skills).
- content
- Agent-content blobs — per-agent key/value content storage (e.g. the “instructions” panel content).
- conversation_
trust_ grants - Allowlist for a responding agent’s
conversation_visibility: trusted_peersmode. Seedb_conversation_trust_grantsin migrations.rs (OBJECT_SCHEMA_VERSION v26) and docs/specs/SPEC_MUXSPECT_CROSS_TIER_CONVERSATION_VISIBILITY_2026_08_21.md Phase B. - cron
- Persistent cron job storage — CRUD methods on
db_cron_jobsin the global shared store. Seedocs/specs/SPEC_CRON_LOOP_ROBUSTNESS_2026_06_25.md. - def_
registry_ mirror - Global agent-definition registry mirror.
- error
- Error types for the storage layer.
- filestore
- FileStore: file storage with write-through cache + background flusher. Port of Go’s pkg/filestore/blockstore.go, blockstore_cache.go, blockstore_dbops.go.
- history
- Agent session history — append-only per-agent entries with date-bucket + LIKE search.
- identities
- Identity subsystem — accounts and the direct junction that ties them to agents.
- jekt_
held - Jekts held for an absent agent —
SPEC_DURABLE_JEKT_DELIVERY_2026_09_24.mdPhase 1. A message to a known agent of this channel that no delivery tier could take is kept here for up to 24 h and replayed when the agent registers. The trust verdicts it was accepted with are explicit columns: onInjectionRequestthey areskip_deserializing, so they would not survive a JSON round-trip. - lan_
peer_ pubkey_ pins - Trust-on-first-use pin of a REMOTE agent_id’s LAN public key. See db_lan_peer_pubkey_pins in migrations.rs (OBJECT_SCHEMA_VERSION v20) and docs/specs/SPEC_JEKT_LAN_TIER_SIGNING_2026_08_15.md §2.2.
- lan_
peer_ uid_ pins - Trust-on-first-use pin of a REMOTE agent’s UID key, per (name, UID)
(identity M4d-6,
SPEC_AGENT_IDENTITY_CARRIED_NOT_DERIVED_2026_09_23.md§6.5.10). The LAN v2 counterpart oflan_peer_pubkey_pins.rs, and set only after that name pin matched: UIDs are public, so a pin keyed by UID alone could be squatted by a peer answering for its own name. - managed
- The “managed primitive” storage shape shared by standalone Skills and MCP Servers (v1 composable model, SPEC_V1_MCP_SKILLS_PRIMITIVES_2026_06_30.md; bundle-level refs per SPEC_BUNDLE_AS_CONTAINER_V2_2026_08_17.md).
- mcp_
servers - Standalone MCP Server primitives (v1 composable model).
- migrations
- SQL schema setup for Store, FileStore, and the saga log.
- muxbus
- project_
instructions - Tracking for what an agent reads as project instructions.
- registry_
mirror - Cross-version named-agent registry mirror.
- skills
- Agent skills — reusable capability records attached to an agent definition.
- snapshot
- Pre-migration snapshots — Increment B.2 lean cut from
docs/specs/SPEC_DATA_CHANNELS_2026_05_24.md§3.4. - store
- Store: generic OID-based CRUD for StoreObj types. Port of Go’s pkg/mstore/mstore_dbops.go + mstore_dbsetup.go.
- viewer_
devices - Paired devices: the viewer grants a device receives at pairing, and each
agent’s “hide from paired devices” flag. See
db_viewer_devicesanddb_agents.hide_from_devicesin migrations.rs (OBJECT_SCHEMA_VERSION v43) andbackend::viewer. - wan_
identity - The channel-wide WAN identity store,
<channel dir>/wan-identity/wan.db(SPEC_WAN_JEKT_VERIFICATION_2026_09_24.md§2.2, step D1). - widget_
storage - A widget package’s own key-value store, the
storagepermission (docs/specs/SPEC_USER_WIDGETS_AND_WIDGET_API_2026_10_09.md §6.3): per package, not per pane, values as JSON text. The limits are the caller’s (backend/widget_access.rs); this module only counts bytes. - work_
claims - Work claims: an agent saying “I’m working on this” about a path, branch
or topic, so others see it in
WhoIsWorkingOnand in overlap notes (docs/specs/SPEC_AGENT_OVERLAP_AWARENESS_2026_10_10.md §3.4). - work_
queue - Muxqueue — the universal agent work queue.