ContextPackage

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/feason-com/json-schema/feason-com-context-package-schema.json",
  "title": "ContextPackage",
  "x-generated": "2026-11-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/feason-com-openapi.yml#/components/schemas/ContextPackage",
  "type": "object",
  "required": [
    "query",
    "corpusVersion",
    "context",
    "citations",
    "coverage",
    "usage",
    "instructions"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "corpusVersion": {
      "type": "string"
    },
    "context": {
      "type": "string",
      "description": "Token-budgeted Markdown intended to be inserted into a model prompt."
    },
    "citations": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ContextCitation"
      }
    },
    "coverage": {
      "type": "object",
      "required": [
        "requestedTraditions",
        "representedTraditions",
        "missingTraditions",
        "caveats"
      ],
      "properties": {
        "requestedTraditions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "representedTraditions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "missingTraditions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "caveats": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "usage": {
      "type": "object",
      "required": [
        "maxTokens",
        "estimatedTokens",
        "includedEvidence",
        "availableEvidence",
        "truncated"
      ],
      "properties": {
        "maxTokens": {
          "type": "integer"
        },
        "estimatedTokens": {
          "type": "integer"
        },
        "includedEvidence": {
          "type": "integer"
        },
        "availableEvidence": {
          "type": "integer"
        },
        "truncated": {
          "type": "boolean"
        }
      }
    },
    "instructions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$defs": {
    "ContextCitation": {
      "type": "object",
      "required": [
        "label",
        "passageId",
        "sourceId",
        "sourceTitle",
        "canonicalReference",
        "sourceUrl",
        "traditions",
        "verificationStatus"
      ],
      "properties": {
        "label": {
          "type": "string"
        },
        "passageId": {
          "type": "string"
        },
        "sourceId": {
          "type": "string"
        },
        "sourceTitle": {
          "type": "string"
        },
        "canonicalReference": {
          "type": "string"
        },
        "sourceUrl": {
          "type": "string",
          "format": "uri"
        },
        "traditions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "verificationStatus": {
          "enum": [
            "unverified",
            "machine_checked",
            "curated",
            "scholarly_reviewed"
          ]
        }
      }
    }
  }
}