AIInterpretationGeneratedevent type

AI produced an interpretation tied to a target object via ReadOnlyContext (I4). Provenance fields (model, prompt_hash, retrieval_set_ids, derived_from_node_ids, confidence) satisfy I8.

Full spec

{
  "name": "AIInterpretationGenerated",
  "description": "AI produced an interpretation tied to a target object via ReadOnlyContext (I4). Provenance fields (model, prompt_hash, retrieval_set_ids, derived_from_node_ids, confidence) satisfy I8.",
  "current_version": 1,
  "actor_type_allowed": [
    "agent"
  ],
  "object_type": "AIInterpretation",
  "payload_versions": {
    "v1": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "interpretation_id",
        "target_object_type",
        "target_object_id",
        "interpretation_type",
        "model",
        "prompt_hash",
        "retrieval_set_ids",
        "derived_from_node_ids",
        "confidence"
      ],
      "properties": {
        "interpretation_id": {
          "type": "string",
          "format": "uuid"
        },
        "target_object_type": {
          "type": "string",
          "minLength": 1
        },
        "target_object_id": {
          "type": "string",
          "format": "uuid"
        },
        "interpretation_type": {
          "type": "string",
          "minLength": 1,
          "description": "Registered AI interpretation type (e.g., 'answer_draft', 'steerco_synthesis', 'blast_radius_summary')."
        },
        "content_ref": {
          "type": [
            "string",
            "null"
          ],
          "description": "Storage handle for the interpretation content; null if inlined in ai_interpretations row."
        },
        "model": {
          "type": "string",
          "minLength": 1
        },
        "model_version": {
          "type": "string"
        },
        "prompt_hash": {
          "type": "string",
          "minLength": 1
        },
        "retrieval_set_ids": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "derived_from_node_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uuid"
          }
        },
        "confidence": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        },
        "embedding_model_used": {
          "type": [
            "string",
            "null"
          ],
          "description": "I8 if retrieval used embeddings; the model id used to produce the retrieval set."
        },
        "embedding_model_version_used": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  },
  "projections_consuming": [
    "ai_interpretations_view",
    "audit_log"
  ],
  "canonicalizer_module": "event-canonicalizers/ai_interpretation_generated.ts"
}