EvolveResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/contextdb-ai/json-schema/contextdb-ai-evolve-response-schema.json",
  "title": "EvolveResponse",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/contextdb-ai-openapi.yaml#/components/schemas/EvolveResponse",
  "type": "object",
  "required": [
    "requested_operation",
    "applied_operation",
    "outcome",
    "memory",
    "previous_memory_ids",
    "deleted_memory_ids",
    "noop_reason",
    "memory_version",
    "primary_wal_lsn",
    "request_id"
  ],
  "properties": {
    "requested_operation": {
      "$ref": "#/$defs/EvolutionOperation"
    },
    "applied_operation": {
      "$ref": "#/$defs/EvolutionOperation"
    },
    "outcome": {
      "$ref": "#/$defs/EvolutionOutcome"
    },
    "memory": {
      "oneOf": [
        {
          "$ref": "#/$defs/Memory"
        },
        {
          "type": "null"
        }
      ]
    },
    "previous_memory_ids": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256
      }
    },
    "deleted_memory_ids": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256
      }
    },
    "noop_reason": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 1,
      "maxLength": 256
    },
    "memory_version": {
      "$ref": "#/$defs/MemoryVersion"
    },
    "primary_wal_lsn": {
      "$ref": "#/$defs/PrimaryWalLsn"
    },
    "request_id": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$defs": {
    "EpistemicSource": {
      "type": "string",
      "enum": [
        "user_stated",
        "agent_inferred",
        "third_party"
      ],
      "description": "Who vouches for the claim. Required on writes."
    },
    "EvolutionOperation": {
      "type": "string",
      "enum": [
        "add",
        "update",
        "delete",
        "noop"
      ]
    },
    "EvolutionOutcome": {
      "type": "string",
      "enum": [
        "added",
        "updated",
        "deleted",
        "noop",
        "contested"
      ]
    },
    "Memory": {
      "type": "object",
      "required": [
        "id",
        "content",
        "user_id",
        "epistemic_source",
        "confidence",
        "corroboration_count",
        "action_relevant",
        "requires_confirmation",
        "confirmed",
        "independent_corroboration",
        "injection_suspect",
        "entity_key",
        "attribute_key",
        "valid_until",
        "superseded_by"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "content": {
          "type": "string",
          "description": "Stored content with PII redacted as `[TYPE]` placeholders"
        },
        "user_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "epistemic_source": {
          "$ref": "#/$defs/EpistemicSource"
        },
        "confidence": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        },
        "corroboration_count": {
          "type": "integer",
          "minimum": 0
        },
        "action_relevant": {
          "type": "boolean"
        },
        "requires_confirmation": {
          "type": "boolean"
        },
        "confirmed": {
          "type": "boolean"
        },
        "independent_corroboration": {
          "type": "integer",
          "minimum": 0
        },
        "injection_suspect": {
          "type": "boolean"
        },
        "entity_key": {
          "type": [
            "string",
            "null"
          ]
        },
        "attribute_key": {
          "type": [
            "string",
            "null"
          ]
        },
        "valid_until": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "superseded_by": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "MemoryVersion": {
      "type": "integer",
      "minimum": 0,
      "description": "Monotonic consistency version within one organization/project."
    },
    "PrimaryWalLsn": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^[0-9A-F]+/[0-9A-F]+$",
      "description": "Primary PostgreSQL WAL position observed after commit."
    }
  }
}