The Open Agent Memory Standard.

The atomic unit. Every memory, from every vendor, reduces to this shape. Embeddings are optional and dimension-agnostic. Confidence is a calibrated scalar in [0, 1]. Metadata is open-ended.

type OAMSMemory = {
  id: string;              // stable, unique
  namespace: string;       // agent scope
  content: string;         // canonical text
  embedding?: number[];     // optional
  confidence: number;      // 0.0 - 1.0
  created_at: string;      // ISO 8601
  metadata: Record<string, unknown>;
}

When one agent shares memory with another — across frameworks, across vendors — the payload travels in a federation envelope. Scope is explicit. TTL is enforced. Audit lineage is preserved through the hop.

type OAMSEnvelope = {
  source_agent: string;       // DID or URL
  target_agents: string[];     // recipients
  scope: "read" | "read_write" | "mirror";
  ttl: number;                 // seconds, 0 = session
  payload: OAMSMemory[];
  audit: AuditTrail;
}

Consolidation is how raw memories become knowledge. OAMS does not dictate the algorithm — it defines the contract: named strategy, declared inputs, declared outputs, and a verifiable audit trail.

type OAMSPipeline = {
  strategy: string;            // e.g. "synthesize"
  version: string;             // semver
  inputs: string[];             // memory ids
  outputs: string[];            // resulting ids
  audit_log: {
    started_at: string;
    finished_at: string;
    actor: string;              // model + version
    reason: string;
  };
}

Before two systems exchange memory, they handshake. A well-known URL describes what the provider supports: which pipelines, which transports, which scopes. Discovery is static. No SDK required.

GET /.well-known/oams-capabilities
Accept: application/json

// Response
{
  "oams_version": "0.1",
  "strategies": ["synthesize", "compress"],
  "transports": ["https", "a2a", "mcp"],
  "embedding_dim": 1536,
  "max_payload": 10485760,
  "auth": ["bearer", "mtls"]
}