{
  "$id": "https://commandlayer.org/schemas/v1.1.0/commons/explain/explain.receipt.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "explain.receipt",
  "description": "Receipt for an explain request, including the explanation and optional reasoning steps.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "verb": {
      "type": "string",
      "const": "explain"
    },
    "schema_version": {
      "type": "string",
      "const": "1.1.0"
    },
    "status": {
      "description": "Outcome status for this verb invocation.",
      "type": "string",
      "enum": [
        "success",
        "error",
        "delegated"
      ]
    },
    "explanation": {
      "description": "Natural language explanation tailored to the requested audience.",
      "type": "string",
      "minLength": 1
    },
    "steps": {
      "description": "Optional step-by-step breakdown of the reasoning.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 512
      },
      "maxItems": 64
    },
    "summary": {
      "description": "Optional short summary of the explanation.",
      "type": "string",
      "minLength": 1
    },
    "references": {
      "description": "Optional references or pointers used for this explanation.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 512
      },
      "maxItems": 64
    }
  },
  "required": [
    "verb",
    "schema_version",
    "status",
    "explanation"
  ]
}