Blog
Technical articles explaining the specification in depth — with real-world examples using Raven (autonomous robot) and Trident (fleet management platform).
A comprehensive guide to the Recommendation grain type (0x0C), introduced in OMS v1.5 — governed, auditable proposals to change memory or agent configuration. Covers the propose/review/apply/roll-back lifecycle, why rec_status lives in the index layer, the normative dedup_key construction, applier execution authority, and reproducible undo.
A comprehensive guide to the Skill grain type (0x0B), introduced in OMS v1.4 — the hybrid definition-plus-competence model, why the Fact + mg:capable_of convention was promoted to a first-class type, proficiency as a supersession chain, skill transfer between agents, and how Skills differ from Workflows and capability Facts.
How OMS Consensus grains record multi-agent agreement with threshold-based voting, trust-weighted confidence, and quorum protection — enabling auditable decisions across regulated industries, fleet coordination, and collaborative AI systems.
A comprehensive guide to the Consent grain type (0x0A) in OMS v1.2 — DID-scoped permission grants and withdrawals, the consent_cascade invalidation policy, GDPR/CCPA/HIPAA compliance patterns, and how Consent grains create an immutable audit trail for data processing authorization.
A comprehensive guide to the Reasoning grain type (0x08) in OMS v1.2 — inference methods, premises and conclusions, extended thinking capture, the requires_human_review safety mechanism, field compaction, and real-world applications in healthcare, finance, and legal reasoning.
How the Context Assembly Language turns a raw memory store into a first-class context pipeline for AI agents — from querying relevant grains to assembling token-budgeted context blocks that drop directly into LLM calls.
CAL's FORMAT clause gives you six output options for assembled agent context. Side-by-side token counts, real examples, and a decision guide for when to use SML, TOON, Markdown, or JSON.
Semantic Markup Language (SML) uses grain type tag names as epistemic signals — telling an LLM not just what information is, but what kind of information it is. Hands-on examples across the grain-type elements, from customer support to incident response.
How the Open Memory Specification maps to autonomous vehicle systems — from LiDAR and camera observations with sync groups and coordinate frames to navigation goals, actuator commands, and device profiles for edge-to-cloud processing.
Customer service AI agents lose context between sessions, across channels, and when switching platforms. The Open Memory Specification provides a structured memory model — Episodes for raw transcripts, Facts for customer knowledge, Goals for issue tracking, Workflows for escalation — with GDPR-ready PII handling and cross-platform portability via .mg files.
How the Open Memory Specification maps to education and research — using Facts as knowledge graph triples, provenance chains as citation trails, Episodes for student interactions, Goals for learning objectives, embedding refs for semantic search, and content addressing for reproducible research.
How the Open Memory Specification maps to financial services — from trading signals and order execution to SOX-compliant audit trails, bi-temporal decision reconstruction, COSE-signed trade records, and regulatory compliance tags for PCI-DSS, Basel III, and Sarbanes-Oxley.
How the Open Memory Specification maps to healthcare AI — from patient observations and diagnoses to treatment plans, with PHI protection, HIPAA compliance mapping, per-patient encryption, selective disclosure, and bi-temporal queries for clinical audit.
Legal AI agents must maintain tamper-proof records, support discovery, handle attorney-client privilege, and preserve chain of custody. The Open Memory Specification maps to these requirements through immutable grains, COSE signatures for authentication, selective disclosure for privilege, grain protection for litigation holds, and .mg files as evidence packages.
Factories generate thousands of sensor readings per second. The Open Memory Specification maps this data to Observations for sensor telemetry, Facts for equipment knowledge, Workflows for learned SOPs, and Checkpoints for shift handoff — with device profiles from 512-byte microcontrollers to cloud-scale analytics.
How the Open Memory Specification maps to robotics systems — using Observation grains for multi-sensor fusion with coordinate frames and sync groups, Goal hierarchies for task decomposition, Checkpoints for state recovery, Workflows for manipulation skills, and device profiles from embedded MCUs to cloud planners.
A byte-by-byte walkthrough of the 9-byte fixed header and MessagePack payload that make up a memory grain binary blob, using the actual hex from OMS Test Vector 1.
How Section 14 of the Open Memory Specification enables full audit trails through provenance chains and typed cross-links — the derivation trail every grain carries, the closed vocabulary of 11 relation types, the critical normative note on 'replaces', and how grains form knowledge graphs with typed edges.
OMS gives every memory grain five timestamps spanning two independent time axes — event time and system time. This bi-temporal model enables precise auditing, point-in-time reconstruction, and regulatory compliance without sacrificing immutability.
A step-by-step guide to implementing the Open Memory Specification, from Level 1 Minimal Reader through Level 3 Production Store — with test vectors, library recommendations, and common pitfalls to avoid.
A deep dive into how OMS uses SHA-256 content addressing to give every memory grain a unique, verifiable, tamper-evident identity — covering the formula, the five roles of a content address, temporal uniqueness, and security considerations.
A deep dive into the canonical serialization rules in Section 4 of the Open Memory Specification — key ordering, integer encoding, float constraints, NFC normalization, and the full 10-step algorithm that ensures two independent implementations always produce the same bytes.
How the Open Memory Specification's three device profiles — Extended, Standard, and Lightweight — adapt the .mg format for everything from cloud servers with gigabytes of RAM to battery-powered microcontrollers with kilobytes.
How OMS maps human-readable field names to compact short keys for efficient binary storage — a complete guide to Section 6 of the Open Memory Specification, covering core fields, type-specific fields, compaction rules, and nested compaction boundaries.
How the Open Memory Specification addresses GDPR, CCPA, and HIPAA requirements through per-user encryption with HKDF-SHA256, crypto-erasure via key destruction, blind index lookups, and built-in compliance primitives mapped to specific regulatory articles.
A comprehensive guide to Section 23 of the Open Memory Specification — the invalidation_policy field that declares who can remove a grain from trusted status. Covers all six protection modes, fail-closed semantics, goal laundering attacks, scope propagation, bypass path closures, and key separation requirements.
OMS v1.2 update: The Checkpoint type is now named State. States are agent state snapshots for save/restore in OMS — like a video game save point for AI agents. Learn about the State grain type, its context map, plan and history fields, fault tolerance patterns, and the immutability model.
OMS v1.2 update: The Episode type is now named Event. Events are the raw, unstructured interaction records in OMS — the input to consolidation that extracts structured Facts. Learn about the Event grain type, its fields, the consolidation pipeline, and real-world use cases.
A comprehensive guide to the Fact grain type in OMS — the semantic triple model, required and optional fields, confidence scoring, bi-temporal validity, protected facts, consolidation levels, and real-world applications.
The most complex OMS memory type: Goal grains model explicit objectives with state machines, structured criteria, delegation, hierarchies, and protection against goal laundering.
How OMS Observation grains capture high-volume data from physical sensors, AI cognitive agents, and human observers — with spatial context, temporal alignment, and multi-modal content references.
How OMS Tool grains record every tool invocation, argument, and result as an immutable, content-addressed record — enabling replay, debugging, cost tracking, and compliance.
Workflows are procedural memory in OMS — directed graphs of procedural steps that agents can replay. Learn the nodes-and-edges model introduced in OMS v1.4, how topology encodes forks and joins, node-to-Tool binding, versioning through supersession, and industry use cases.
A technical comparison of the two encoding options in the Open Memory Specification — MessagePack (default) and CBOR (optional) — covering deterministic rules, key sorting differences, float encoding, content address implications, and when to use each.
Section 11 of the OMS spec defines the .mg container — a portable binary file that packages any number of memory grains with a 16-byte header, random-access index, optional compression, and a SHA-256 footer checksum. This is how agent memory gets exported, shared, and archived.
A step-by-step guide for migrating existing agent memory systems to the Open Memory Specification — mapping proprietary stores to OMS grain types, defining a namespace strategy, adopting conformance levels incrementally, and using the .mg file as the universal export format.
A complete guide to Section 7 of the Open Memory Specification — content references, embedding references, modality-specific metadata, and the security model for linking grains to external multi-modal content without embedding blobs.
Why agent memory locked in proprietary formats is a liability, how the Open Memory Specification's eight requirements and ten design principles solve the portability problem, and what OMS intentionally leaves out of scope.
OMS lets you prove a fact exists without revealing its sensitive fields. Inspired by SD-JWT (RFC 9901), selective disclosure replaces chosen values with SHA-256 hashes — enabling GDPR-compliant sharing, inter-company collaboration, and court-admissible redaction at the grain level.
How the OMS v1.0 sensitivity classification system uses 2-bit header fields and structured tag vocabularies to enable O(1) routing of personally identifiable information and protected health information to appropriate storage tiers --- without deserializing the payload.
OMS uses COSE Sign1 envelopes and W3C Decentralized Identifiers to provide cryptographic authenticity for memory grains — without certificate authorities, without centralized PKI, and without changing a grain's content address.
The memory grain is the atomic unit of agent knowledge in the Open Memory Specification. This post covers the twelve grain types, the immutability model, content addressing, the .mg container capabilities, and the ten design principles that shape the format.
LLM context windows are not memory. Production agents need portable, verifiable, immutable knowledge that survives restarts, transfers between systems, and stands up to audit. Here is what persistent memory requires and why the Open Memory Specification exists.
