Skip to content
Intelligence plane

Promotion-aware memory

Memory is not a raw log store. ContextOS treats it as a promotion pipeline: capture is immutable, candidates pass through a review queue, only promoted records are eligible for compilation. Tiered (working / episodic / semantic / durable) with consent gating and contradiction handling.

Abstract promotion-aware memory pipeline showing captured events, candidate extraction, review gates, tiered stores, and compiled context return flow.
Memory promotion path

Run evidence becomes candidates first, then passes consent, contradiction, and review checks before promoted memory can be compiled into future context.

CaptureCandidateReview gatePromoted tiersCompile
Promotion-aware memory
  1. 01Capture

    Append tool results, decisions, and effects.

  2. 02Extract candidate

    Create typed memory proposals with evidence refs.

  3. 03Review gate

    Check consent, contradictions, and review policy.

  4. 04Promote tier

    Route approved memory to working, episodic, semantic, or durable stores.

  5. 05Compile

    Only promoted memory can return in a future ContextPack.

Capture → Promoted

Every tool result and decision is captured immutably; a consolidator extracts typed candidates that enter the review queue with consent and contradiction checks before promotion.

Anti-pattern prevented

PII leakage and contradiction drift: consent is checked at the candidate stage; contradictions produce typed events instead of silent overwrites.

Metrics that matter

Recall precision, PII write-back violation rate, contradiction resolution time, correction adoption rate, review-queue throughput.

Memory write proposal

Promotion is governed by class. Each candidate emits a typed write proposal that lands in the review queue with consent + contradiction checks, then routes to the tier declared by the pack's memory policy.

Memory write proposal (typed)
{
  "proposal_id": "mwp_2026_05_04_0931_a17",
  "candidate": {
    "entity_ceid": "customer:cus_77",
    "predicate": "prefers_communication_channel",
    "value": "email",
    "evidence_refs": ["tool:crm.lookup:tc_212", "session:sess_42f1"],
    "confidence": 0.93
  },
  "class": "preference",
  "tier_target": "semantic",
  "consent_check": "passed",
  "contradiction_check": { "existing": null, "verdict": "no_conflict" },
  "auto_promote_eligible": true
}