{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://sierracatalina.com/context-layer/implementation/context-request.schema.json",
  "title": "context request",
  "description": "Phase 0 request envelope for purpose-bound context disclosure.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "spec_version",
    "type",
    "id",
    "created_at",
    "issuer",
    "subject_ref",
    "requester",
    "recipient",
    "purpose",
    "task",
    "selectors",
    "requested_actions",
    "retention",
    "receipt_requirement",
    "expires_at"
  ],
  "properties": {
    "spec_version": {
      "const": "context-layer/0.1-draft"
    },
    "type": {
      "const": "context_request"
    },
    "id": {
      "type": "string",
      "pattern": "^urn:cl:request:[A-Za-z0-9._~-]+$"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "issuer": {
      "$ref": "#/$defs/issuer"
    },
    "subject_ref": {
      "type": "string",
      "minLength": 3,
      "maxLength": 512
    },
    "requester": {
      "$ref": "#/$defs/requester"
    },
    "recipient": {
      "$ref": "#/$defs/recipient"
    },
    "purpose": {
      "type": "string",
      "minLength": 3,
      "maxLength": 240
    },
    "task": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind",
        "user_visible"
      ],
      "properties": {
        "kind": {
          "$ref": "#/$defs/name"
        },
        "user_visible": {
          "type": "boolean"
        }
      }
    },
    "selectors": {
      "type": "array",
      "minItems": 1,
      "maxItems": 64,
      "uniqueItems": true,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "predicate"
        ],
        "properties": {
          "predicate": {
            "$ref": "#/$defs/name"
          }
        }
      }
    },
    "requested_actions": {
      "type": "array",
      "maxItems": 64,
      "uniqueItems": true,
      "items": {
        "$ref": "#/$defs/name"
      }
    },
    "retention": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "mode",
        "max_seconds"
      ],
      "properties": {
        "mode": {
          "enum": [
            "ephemeral",
            "single_use"
          ]
        },
        "max_seconds": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400
        }
      }
    },
    "receipt_requirement": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "level",
        "required"
      ],
      "properties": {
        "level": {
          "enum": [
            "none",
            "decision",
            "operation"
          ]
        },
        "required": {
          "type": "boolean"
        }
      }
    },
    "expires_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "$defs": {
    "name": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"
    },
    "issuer": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 3,
          "maxLength": 512
        }
      }
    },
    "requester": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "principal",
        "authenticated_by",
        "client_instance"
      ],
      "properties": {
        "principal": {
          "type": "string",
          "minLength": 3,
          "maxLength": 512
        },
        "authenticated_by": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "client_instance": {
          "type": "string",
          "minLength": 3,
          "maxLength": 512
        }
      }
    },
    "recipient": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "principal",
        "onward_disclosure"
      ],
      "properties": {
        "principal": {
          "type": "string",
          "minLength": 3,
          "maxLength": 512
        },
        "onward_disclosure": {
          "enum": [
            "allowed",
            "forbidden"
          ]
        }
      }
    }
  }
}