Skip to main content

Consolidate Omega memory

Omega consolidation derives one semantic summary or procedural memory from a bounded set of source memories. The operation preserves the source records and returns receipt-backed lineage so applications can inspect or roll back the derived output.

Consolidation does not widen access. The server re-reads every source through generated authorization and applies the effective memory profile.

Prerequisites​

  • The authenticated principal can read every source memory.
  • All sources belong to the same authorized owner and scope.
  • The effective profile enables consolidation and permits the requested output type.
  • The request contains 2 through 256 unique memory references.

Consolidate an episode​

POST /v1/graymatter/omega/episodes/consolidate
{
  "memoryRefs": [
    "41151b6f-d4fd-413a-b450-f44a3a0fd25e",
    "8d0ef38d-ab76-4701-a98b-257147f34e15"
  ],
  "outputType": "semantic",
  "reasonCode": "quarterly-summary",
  "idempotencyKey": "quarterly-summary-2026-q2-v1"
}

outputType accepts semantic or procedural. Use a stable idempotency key for one logical operation; do not reuse it with a different source set or output type.

The response identifies the episode, event, receipt, derived output, policy version, and source lineage. Preserve episodeRef and receiptRef with the application record that requested consolidation.

Inspect an episode​

GET /v1/graymatter/omega/episodes/{episodeId}

Inspection re-authorizes the current caller. Possession of an episode ID does not grant access to its sources or derived output.

Roll back a consolidation​

POST /v1/graymatter/omega/episodes/{episodeId}/rollback
{
  "reasonCode": "superseded-summary",
  "idempotencyKey": "rollback-quarterly-summary-2026-q2-v1"
}

Rollback removes only the derived output. It preserves the original memories and the event, receipt, and relationship history needed to explain what happened.

Handle results​

  • Treat replayed: true as an idempotent replay, not a second consolidation.
  • Record the returned memoryProfileVersion with downstream decisions.
  • Do not continue if source authorization or profile validation fails.
  • Do not replace a failed consolidation with an untracked summary that loses source lineage.