OAMS v0.1 — The HTTP of Agent Memory

Why OAMS

Memory should be free to move.

Every AI system stores memories in a proprietary format. OAMS ends that.

🔗

Interoperability

Every AI system stores memories differently. OAMS is the JSON envelope that makes them all compatible — a single schema any agent can read and write.

📦

Portability

Your memories are yours. Export from any OAMS system, import to any other. No vendor lock-in, no proprietary blobs, no migration headaches.

🌐

Standard, Not a Silo

OAMS defines schemas, not infrastructure. Build on top of it, extend it, fork it. We just want memory to be free — for every agent, everywhere.

OAMS Specification

The 5 Object Schemas

Five composable JSON objects cover the full memory lifecycle — from raw storage to dream synthesis to knowledge graphs.

Core memory object — the fundamental unit of OAMS

oams/memory.json
{
  "id":         "uuid-or-slug",
  "namespace":  "default",
  "key":        "my-memory-key",
  "value":      "The content of the memory",
  "type":       "reference",
  "tags":       ["tag1", "tag2"],
  "metadata":   { "source": "slack", "created_at": 1700000000 },
  "ttl":        0,
  "locked":     false
}

Dream Engine result — synthesized output from a REM cycle run

oams/dream_output.json
{
  "dream_id":     "dream-abc123",
  "strategy":     "synthesize",
  "namespace":    "default",
  "keys_sampled": 20,
  "entries": [
    { "key": "synth_001", "value": "...", "type": "synthesize" }
  ],
  "meta": {
    "dominant_themes": ["..."],
    "confidence": 0.95
  },
  "duration_ms":  6100
}

BiOtA session — bidirectional temporal association replay metadata

oams/biota_session.json
{
  "session_id":       "uuid",
  "iterations_run":   3,
  "convergence_score": 0.987,
  "rem_score":        76,
  "creative_leaps": [
    {
      "type":          "cross_domain_synthesis",
      "leap":          "...",
      "novelty_score": 0.74
    }
  ],
  "predictive_leaps":  ["..."],
  "insights":          ["..."],
  "stages_completed":  9
}

ContextDream output — compressed context pack with creative leaps

oams/context_pack.json
{
  "pack_id": "uuid",
  "gist":    "Compressed context...",
  "compression": {
    "raw_tokens":        28000,
    "compressed_tokens": 9800,
    "savings_pct":       65.0
  },
  "creative_leaps":    ["..."],
  "predictive_slice":  ["..."],
  "algorithms_applied": [
    "SWR_clustering",
    "Go-CLS_gating",
    "REM_recombination",
    "SHY_downscaling"
  ]
}

Knowledge graph node — for GraphRAG and associative memory structures

oams/knowledge_node.json
{
  "id":     "node-uuid",
  "label":  "hippocampal replay",
  "type":   "concept",
  "connections": [
    {
      "target_id": "node-uuid-2",
      "weight":    0.87,
      "relation":  "enables"
    }
  ],
  "namespace":   "default",
  "memory_keys": ["key1", "key2"]
}

Migrate in Minutes

One-Click Importers

Already using another memory system? One API call brings everything over in OAMS format.

Import from Mem0

Already using Mem0? Import your entire memory store in one API call.

bash

curl -X POST \
  https://slopshop.gg/v1/oams/import/mem0 \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "mem0_api_key": "m0-...",
    "user_id": "user123"
  }'

Import from Zep

Migrate your Zep Graphiti temporal graph memories.

bash

curl -X POST \
  https://slopshop.gg/v1/oams/import/zep \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "zep_api_key": "z_...",
    "session_id": "sess123"
  }'

Import from Letta

Bring your Letta stateful agent memories.

bash

curl -X POST \
  https://slopshop.gg/v1/oams/import/letta \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "letta_api_key": "sk-...",
    "agent_id": "agent-123"
  }'

API Reference

OAMS Endpoints

All OAMS endpoints live at slopshop.gg. Three public endpoints — no key needed to validate or read the spec.

Method	Endpoint	Auth	Description
GET	/v1/oams/spec	Public	Full OAMS v0.1 specification
GET	/v1/oams/schema	Public	JSON Schema for validation
POST	/v1/oams/validate	Public	Validate memory objects against the OAMS schema
POST	/v1/oams/import/mem0	Required	Import from Mem0
POST	/v1/oams/import/zep	Required	Import from Zep Graphiti
POST	/v1/oams/import/letta	Required	Import from Letta
POST	/v1/oams/import/json	Required	Raw OAMS JSON import
GET	/v1/oams/export	Required	Export all memories as OAMS-compliant JSON

Data Sovereignty

Export Your Memories

Your memories belong to you. Export everything in OAMS format with one call:

bash — export all memories as OAMS JSON

curl https://slopshop.gg/v1/oams/export \
  -H "Authorization: Bearer YOUR_KEY" \
  > my-memories.json

The exported file is valid OAMS JSON — import it into any OAMS-compatible system with zero data transformation required.

OAMS v0.1 The HTTP of Agent Memory

Memory should be free to move.

The 5 Object Schemas

One-Click Importers

OAMS Endpoints

Export Your Memories

Get Involved