pub const SHARED_STORE_SCHEMA_VERSION: i64 = 12;Expand description
user_version stamped into ~/.agentmux/shared/store.db after
run_shared_store_schema. Versioned independently from objects.db.
v1 — initial: identity accounts/bundles/bindings/links, memory
bundles, drone definitions, muxbus credentials
v2 — db_cron_jobs: persistent scheduled injection jobs
v3 — Phase 4a of SPEC_PRESET_TO_BUNDLE_REFACTOR_2026_07_02.md: rename
db_identity_accounts -> db_accounts, db_memory_bundles -> db_bundles
(SPEC_ARMORY_PHASE4_STORAGE_RENAME_COMPLETION_2026_07_12.md).
v4 — db_agent_credentials: per-agent M2M Cognito client_id/secret +
cached access token, one row per locally-registered agent_id.
Lets cloud_subscriber use a credential bound to a specific agent
instead of the single shared per-account MUXBUS_TOKEN for every
/reactive/* call.
v5 — db_cron_jobs.max_age_secs: optional hard expiry bound (seconds since
created_at) alongside the existing max_fires bound. NULL = no expiry
(existing rows unaffected). See
docs/specs/SPEC_AGENT_POLLING_AND_WAKEUP_HARDENING_2026_08_04.md Phase 0.
v6 — db_agent_native_memory: durable, location-consistent mirror of
each agent’s native memory files, keyed by (agent_id, filename).
See docs/specs/SPEC_NATIVE_MEMORY_DURABLE_SYNC_2026_08_07.md.
v7 — db_bundles.instructions_by_provider: JSON object of
{provider_id: content} instruction variants, additive to the
existing flat instructions column. ABF v0.2 §2.2, see
docs/specs/SPEC_ABF_V0_2_PROVIDER_AWARE_COMPONENTS_AND_NATIVE_MEMORY_2026_08_10.md.
v8 — db_agent_native_memory_versions: append-only version history for
native memory content, one row per agent:memory:write_file
call (plus reverts and, later, out-of-band-write detection) —
the mirror in v6 only ever holds the current value, with no way
to see what a file contained before its last write. See
docs/specs/SPEC_MEMORY_VERSION_CONTROL_AND_ARMORY_AUDIT_2026_08_19.md.
v9 — db_bundles.is_system: AgentMux-controlled, highest-priority
Global Bundle tier — see OBJECT_SCHEMA_VERSION’s v27 doc
comment (objects.db, above run_object_schema) for the full
design; this store just needs schema parity.
v10 — db_bundle_versions: append-only version history for Global
Memory entry content — see OBJECT_SCHEMA_VERSION’s v35 doc
comment for the full rationale
(SPEC_AGENT_FACING_GLOBAL_MEMORY_API_2026_09_15.md); this store
just needs schema parity, same as v9 above.
v11 — db_cron_jobs.target_uid: the target agent’s UID (db_agents.id)
beside the slug column, resolved once at create time and
dual-written; nothing reads it yet, a job still fires by
target. Identity M1b of
SPEC_AGENT_IDENTITY_CARRIED_NOT_DERIVED_2026_09_23.md §9.1 —
spec §5.4: non-interactive ingress never resolves a name at fire
time, so the UID has to be captured while a human or model is
present. Empty when the name did not resolve; never guessed.
v12 — db_cron_jobs.created_by_uid and db_bundle_versions.written_by_uid:
the actor’s UID beside each actor-name column, taken from the
request’s Caller (its X-Agent-Token), never from a body field.
Empty for an Unattributed request; never guessed. Dual-written,
not yet read. Identity M4c-1 of
SPEC_AGENT_IDENTITY_CARRIED_NOT_DERIVED_2026_09_23.md §6.5.9.