{
  "openapi": "3.1.0",
  "info": {
    "title": "Griffynx API",
    "description": "Technical release-candidate contract for the gated evidence foundation. Endpoint deployment and independent evidence-method acceptance are distinct.",
    "version": "0.1.0a0",
    "x-publication-status": "technical-release-candidate",
    "x-contract-date": "12 November 2026"
  },
  "paths": {
    "/v1/inquiries": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Open Inquiry",
        "description": "Open an inquiry (command OpenInquiry).\n\n``mode=sync`` waits for the answer within ``stake.deadline_ms``. ``mode=async`` returns ``202`` the moment\nthe inquiry is admitted and runs it in the background, for a check too deep to hold a connection for\n(S52): poll ``GET /v1/inquiries/{id}`` for ``reasoning``, then the answer, which is kept a day. Every\nrefusal (a purpose, a limit, an unreadable material) still comes back at once, exactly as it does for\n``sync``. ``stream`` is not served and is refused here rather than silently treated as ``sync``.\n\nRejected with I13 when ``purpose`` is missing or not allowed by policy.\nEvery outcome, including a refusal, writes one audit row; its id comes\nback on the ``X-Griffynx-Audit-Id`` header so a caller can cite the call\nthey made.",
        "operationId": "open_inquiry_v1_inquiries_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InquiryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InquiryResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/inquiries/{inquiry_id}": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Inquiry",
        "description": "The inquiry as it stands: `reasoning` while it runs, then its answer, kept a day (S52).\n\nAn inquiry that is not yours, does not exist or is more than a day old is not found, the same answer for\nall three so this cannot be used to learn whether somebody else's exists (I19).",
        "operationId": "get_inquiry_v1_inquiries__inquiry_id__get",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Inquiry Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InquiryResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/inquiries/{inquiry_id}/events": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Inquiry Events",
        "description": "SSE: AssessmentIssued, AssessmentRevised, InquiryConcluded. Replayable with ``after``.",
        "operationId": "inquiry_events_v1_inquiries__inquiry_id__events_get",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Inquiry Id"
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "After"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/consent/{record_id}": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Consent",
        "description": "One consent/retention record: what was retained, under which purpose, for how long.\n\nScoped to the calling tenant. A record that exists but belongs to\nanother tenant answers exactly like one that does not exist, so this\ncan never be used to learn whether a given id belongs to somebody\nelse's inquiry.",
        "operationId": "get_consent_v1_consent__record_id__get",
        "parameters": [
          {
            "name": "record_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Record Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConsentRecordOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/observations": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Submit Observation",
        "description": "Submit testimony (command SubmitObservation). Enters with its provenance class; never sets a score.",
        "operationId": "submit_observation_v1_observations_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ObservationIn"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObservationOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/observations/batch": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Submit Observations",
        "description": "Submit many observations at once.",
        "operationId": "submit_observations_v1_observations_batch_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "items": {
                  "$ref": "#/components/schemas/ObservationIn"
                },
                "type": "array",
                "title": "Body"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ObservationOut"
                  },
                  "type": "array",
                  "title": "Response Submit Observations V1 Observations Batch Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/outcomes": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Submit Outcome",
        "description": "Report what happened after a decision (command SubmitOutcome). Feeds calibration (E14).",
        "operationId": "submit_outcome_v1_outcomes_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OutcomeIn"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObservationOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/outcomes/batch": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Submit Outcomes",
        "description": "Report many outcomes at once (a month of repayments, a day of chargebacks).",
        "operationId": "submit_outcomes_v1_outcomes_batch_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "items": {
                  "$ref": "#/components/schemas/OutcomeIn"
                },
                "type": "array",
                "title": "Body"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ObservationOut"
                  },
                  "type": "array",
                  "title": "Response Submit Outcomes V1 Outcomes Batch Post"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/material": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Create Material",
        "description": "Declare material (command IngestMaterial).\n\nA text material carries its text and is held at once; its id is the sha256 of the text, which is what\nan inquiry names in `material_ids`. Anything else declares the sha256 of the bytes that will follow and\nis told where to put them (`PUT` the bytes to `upload_url`). `retention_mode` is a promise (D35): the\ndefault, `transient`, is released as soon as the inquiry that reads it concludes. Only text is read\ntoday; an image or a document is stored and an inquiry that binds one is refused with that reason. C2\nmaterial is refused.",
        "operationId": "create_material_v1_material_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MaterialCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MaterialOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/material/{material_id}/content": {
      "put": {
        "tags": [
          "v1"
        ],
        "summary": "Put Material Content",
        "description": "The bytes of a declared material. They must hash to `material_id`.",
        "operationId": "put_material_content_v1_material__material_id__content_put",
        "parameters": [
          {
            "name": "material_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Material Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MaterialOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/material/{material_id}": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Material",
        "description": "The material's status. A material that is not yours is not found.",
        "operationId": "get_material_v1_material__material_id__get",
        "parameters": [
          {
            "name": "material_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Material Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MaterialOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "v1"
        ],
        "summary": "Delete Material",
        "description": "Let go of the content now. The record that it was held, and for what, stays.",
        "operationId": "delete_material_v1_material__material_id__delete",
        "parameters": [
          {
            "name": "material_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Material Id"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/material/{material_id}/extraction": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Extraction",
        "description": "What is stored about the material's extraction; what a message named is in the inquiry's findings.",
        "operationId": "get_extraction_v1_material__material_id__extraction_get",
        "parameters": [
          {
            "name": "material_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Material Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExtractionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Open Case",
        "description": "Open a case (command OpenCase).\n\nRequires an investigative tenant (KYB) and an authorization record (I13).",
        "operationId": "open_case_v1_cases_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaseCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Case",
        "description": "The case and its current state, derived from its event log.",
        "operationId": "get_case_v1_cases__case_id__get",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/members": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Add Case Members",
        "description": "Add members (command AddCaseMembers).",
        "operationId": "add_case_members_v1_cases__case_id__members_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaseMemberIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/intake": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Intake Case",
        "description": "Bring many things into a case at once (command IntakeBatch, D43).\n\nA bounded manifest of presentations and declared material; bytes follow by\nhash. Each item answers for itself (accepted, duplicate, rejected); the\nmanifest becomes one case event. Nothing is spent: gathering is ``expand``.\nFor open-ended intake open a session with ``case_id`` instead.",
        "operationId": "intake_case_v1_cases__case_id__intake_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IntakeManifest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntakeOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/expand": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Expand Case",
        "description": "One hop of attribution (command ExpandCase), budgeted.\n\nWith human_gate the candidates are shown first and nothing is spent until one is chosen.",
        "operationId": "expand_case_v1_cases__case_id__expand_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaseExpandIn"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InquiryResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/assertions": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Assert In Case",
        "description": "An analyst's judgement as evidence (command AssertInCase, E9).",
        "operationId": "assert_in_case_v1_cases__case_id__assertions_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaseAssertionIn"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ObservationOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/hold": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Hold Case",
        "description": "Place legal hold (command HoldCase).",
        "operationId": "hold_case_v1_cases__case_id__hold_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaseHoldIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/release": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Release Case",
        "description": "Release legal hold (command ReleaseCase).",
        "operationId": "release_case_v1_cases__case_id__release_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaseHoldIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/review": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Review Case",
        "description": "Move the review state (command ReviewCase).",
        "operationId": "review_case_v1_cases__case_id__review_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaseReviewIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/export": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Export Case",
        "description": "Produce the evidentiary bundle (command ExportCase). Requires sign-off.",
        "operationId": "export_case_v1_cases__case_id__export_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "bundle",
              "title": "Format"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseExportOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/close": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Close Case",
        "description": "Close the case (command CloseCase).",
        "operationId": "close_case_v1_cases__case_id__close_post",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          },
          {
            "name": "finding",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Finding"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/graph": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Case Graph",
        "description": "The case graph: nodes and edges with types, weights and provenance classes.",
        "operationId": "case_graph_v1_cases__case_id__graph_get",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaseGraphOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/timeline": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Case Timeline",
        "description": "Everything that happened in the case, in observed order.",
        "operationId": "case_timeline_v1_cases__case_id__timeline_get",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EventEnvelope"
                  },
                  "title": "Response Case Timeline V1 Cases  Case Id  Timeline Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/cases/{case_id}/events": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Case Events",
        "description": "SSE: CaseChanged, AssessmentRevised for expansions, MonitorTriggered for case monitors.",
        "operationId": "case_events_v1_cases__case_id__events_get",
        "parameters": [
          {
            "name": "case_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Case Id"
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "After"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/monitors": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Open Monitor",
        "description": "A standing watch (command OpenMonitor).",
        "operationId": "open_monitor_v1_monitors_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MonitorCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitorOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/monitors/{monitor_id}": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Monitor",
        "description": "The monitor and its last assessment.",
        "operationId": "get_monitor_v1_monitors__monitor_id__get",
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Monitor Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitorOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "v1"
        ],
        "summary": "Close Monitor",
        "description": "End the watch (command CloseMonitor).",
        "operationId": "close_monitor_v1_monitors__monitor_id__delete",
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Monitor Id"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/monitors/{monitor_id}/events": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Monitor Events",
        "description": "SSE: MonitorTriggered.",
        "operationId": "monitor_events_v1_monitors__monitor_id__events_get",
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Monitor Id"
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "After"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sessions": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Open Session",
        "description": "Open a live session (command OpenSession); returns the WebSocket URL for frames and events.",
        "operationId": "open_session_v1_sessions_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SessionOpen"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SessionOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sessions/{session_id}/close": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Close Session",
        "description": "Close a session (command CloseSession); the retention mode is applied.",
        "operationId": "close_session_v1_sessions__session_id__close_post",
        "parameters": [
          {
            "name": "session_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Session Id"
            }
          },
          {
            "name": "reason",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "ended",
              "title": "Reason"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/entities/{entity_id}": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Entity",
        "description": "A resolved subject as the tenant may see it.",
        "operationId": "get_entity_v1_entities__entity_id__get",
        "parameters": [
          {
            "name": "entity_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Entity Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EntityOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/entities/{entity_id}/ledger": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Get Ledger",
        "description": "The entity's assessments in order: reputation over time.",
        "operationId": "get_ledger_v1_entities__entity_id__ledger_get",
        "parameters": [
          {
            "name": "entity_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Entity Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LedgerEntryOut"
                  },
                  "title": "Response Get Ledger V1 Entities  Entity Id  Ledger Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/registry/artifact-types": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Artifact Types",
        "description": "Artifact types this tenant may present, from the loaded packs, with the platform list for a handle.",
        "operationId": "artifact_types_v1_registry_artifact_types_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/RegistryEntryOut"
                  },
                  "type": "array",
                  "title": "Response Artifact Types V1 Registry Artifact Types Get"
                }
              }
            }
          }
        }
      }
    },
    "/v1/registry/intents": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Intents",
        "description": "Intents this tenant may use.",
        "operationId": "intents_v1_registry_intents_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/RegistryEntryOut"
                  },
                  "type": "array",
                  "title": "Response Intents V1 Registry Intents Get"
                }
              }
            }
          }
        }
      }
    },
    "/v1/registry/purposes": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Purposes",
        "description": "Purposes this tenant's policy allows.",
        "operationId": "purposes_v1_registry_purposes_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/RegistryEntryOut"
                  },
                  "type": "array",
                  "title": "Response Purposes V1 Registry Purposes Get"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/keys": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Mint Key",
        "description": "Mint a key (command MintKey): shown once, stored hashed (I11).",
        "operationId": "mint_key_v1_admin_keys_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KeyCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KeyOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/keys/{key_id}": {
      "delete": {
        "tags": [
          "v1"
        ],
        "summary": "Revoke Key",
        "description": "Revoke a key (command RevokeKey).",
        "operationId": "revoke_key_v1_admin_keys__key_id__delete",
        "parameters": [
          {
            "name": "key_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Key Id"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/trials": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Provision Trial",
        "description": "Provision an X-Ray trial for one address and return its key, once.\n\nThe only route that mints a credential for somebody who is not in the\nroom, so three things bound it and all three are here rather than in the\ncaller. It needs the `trials` scope, which one key in one deployment\nholds. It takes one field, so nothing about the trial's shape can be asked\nfor. And every value it writes \u2014 tier, budget, limits, purposes, lifetime\n\u2014 is a constant in `control.trials`, which means a stolen provisioning key\ncan create trials and cannot create anything better than a trial.\n\nWhoever may hold a trial is decided before this is called, by the\nwhitelist in the surface that calls it. This route deliberately does not\nknow that list: it is a policy about people, it changes often, and putting\nit here would make every change to it a deploy of the gateway.",
        "operationId": "provision_trial_v1_admin_trials_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrialCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/trials/{tenant_id}/usage": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Trial Usage",
        "description": "What one trial has left: calls today, budget spent, days remaining.\n\nRead by the playground to draw its own usage strip, so the numbers a\nprospect sees are the numbers the gateway is actually enforcing rather\nthan a second count kept by the page and drifting from it.",
        "operationId": "trial_usage_v1_admin_trials__tenant_id__usage_get",
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Tenant Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialUsageOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/policies": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "List Policies",
        "description": "Every policy version this tenant has published, current first.",
        "operationId": "list_policies_v1_admin_policies_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/PolicyOut"
                  },
                  "type": "array",
                  "title": "Response List Policies V1 Admin Policies Get"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Publish Policy",
        "description": "Publish a policy version (command PublishPolicy). Labels change; scores never do.\n\nEmpty `bands` means the loaded packs' default bands. The new version is the tenant's current one; the\nversions before it stay, because an assessment already labelled names the version that labelled it.",
        "operationId": "publish_policy_v1_admin_policies_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PolicyIn"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PolicyOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/webhooks": {
      "post": {
        "tags": [
          "v1"
        ],
        "summary": "Register Webhook",
        "description": "Register a webhook (command RegisterWebhook).",
        "operationId": "register_webhook_v1_admin_webhooks_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookIn"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookOut"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/admin/audit": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Audit",
        "description": "The tenant's audit trail: every call and analyst action with its cost.",
        "operationId": "audit_v1_admin_audit_get",
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "After"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 100,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AuditEntryOut"
                  },
                  "title": "Response Audit V1 Admin Audit Get"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/health": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Health",
        "description": "Liveness. The only endpoint with a body today.",
        "operationId": "health_v1_health_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "string"
                  },
                  "type": "object",
                  "title": "Response Health V1 Health Get"
                }
              }
            }
          }
        }
      }
    },
    "/healthz": {
      "get": {
        "tags": [
          "ops"
        ],
        "summary": "Healthz",
        "description": "Liveness and the two things worth knowing before a deploy is believed.\n\nOpen, like the provider service's own health endpoint: it reveals how\nmany tools were discovered and whether the gateway's schema answers,\nand nothing about any tenant.",
        "operationId": "healthz_healthz_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Healthz Healthz Get"
                }
              }
            }
          }
        }
      }
    },
    "/v2/trust/schema": {
      "get": {
        "tags": [
          "Trust pilot"
        ],
        "summary": "Trust Schema",
        "description": "Describe the actual implemented pilot request body after authorization.",
        "operationId": "trust_schema_v2_trust_schema_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Trust Schema V2 Trust Schema Get"
                }
              }
            }
          }
        }
      }
    },
    "/v2/trust/checks": {
      "post": {
        "tags": [
          "Trust pilot"
        ],
        "summary": "Trust Check",
        "description": "Validate, reserve and run one canonical check; live mode is separately disabled.",
        "operationId": "trust_check_v2_trust_checks_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "request_id": {
                    "type": "string",
                    "maxLength": 100,
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "title": "Request Id"
                  },
                  "scenario": {
                    "type": "string",
                    "enum": [
                      "seller",
                      "dating_matrimony"
                    ],
                    "title": "Scenario"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "preview",
                      "live"
                    ],
                    "title": "Mode",
                    "default": "preview"
                  },
                  "authorization_reference": {
                    "type": "string",
                    "maxLength": 128,
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_.:-]+$",
                    "title": "Authorization Reference"
                  },
                  "inputs": {
                    "items": {
                      "properties": {
                        "scheme": {
                          "type": "string",
                          "enum": [
                            "email",
                            "e164",
                            "domain",
                            "https_url",
                            "platform_handle",
                            "cin",
                            "lei",
                            "upi",
                            "wallet"
                          ],
                          "title": "Scheme"
                        },
                        "namespace": {
                          "type": "string",
                          "maxLength": 100,
                          "minLength": 1,
                          "title": "Namespace"
                        },
                        "value": {
                          "type": "string",
                          "maxLength": 2048,
                          "minLength": 1,
                          "title": "Value"
                        },
                        "jurisdiction": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^[A-Z]{2}$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "title": "Jurisdiction"
                        }
                      },
                      "additionalProperties": false,
                      "type": "object",
                      "required": [
                        "scheme",
                        "namespace",
                        "value"
                      ],
                      "title": "PresentedInput",
                      "description": "Bounded scheme-qualified request input; normalization belongs to the contract."
                    },
                    "type": "array",
                    "maxItems": 8,
                    "minItems": 1,
                    "title": "Inputs"
                  }
                },
                "additionalProperties": false,
                "type": "object",
                "required": [
                  "request_id",
                  "scenario",
                  "authorization_reference",
                  "inputs"
                ],
                "title": "TrustRequest",
                "description": "An authorized pilot inquiry; the caller cannot set its spending limit."
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrustResponse"
                }
              }
            }
          }
        }
      }
    },
    "/v2/reports/{inquiry_id}": {
      "get": {
        "tags": [
          "Report core"
        ],
        "summary": "Report Core",
        "description": "Expose report-owned meaning for an already completed authorized inquiry.",
        "operationId": "report_core_v2_reports__inquiry_id__get",
        "parameters": [
          {
            "name": "inquiry_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Inquiry Id"
            }
          },
          {
            "name": "profile",
            "in": "query",
            "required": true,
            "schema": {
              "enum": [
                "discover_individual",
                "discover_company",
                "discover_fraud"
              ],
              "type": "string",
              "title": "Profile"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "json",
                "html",
                "pdf"
              ],
              "type": "string",
              "default": "json",
              "title": "Format"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Absence": {
        "properties": {
          "node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Node Id",
            "description": "The node in `graph` this silence is about, when the check drew one."
          },
          "about": {
            "type": "string",
            "title": "About"
          },
          "about_type": {
            "type": "string",
            "title": "About Type"
          },
          "kind": {
            "type": "string",
            "title": "Kind",
            "description": "Why it produced nothing: timeout, error, no_data, refused, budget or unregistered."
          },
          "reason": {
            "type": "string",
            "title": "Reason",
            "description": "The stated reason, with every source name removed."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "about",
          "about_type",
          "kind",
          "reason"
        ],
        "title": "Absence",
        "description": "Something that was asked and did not answer.\n\nAbsence is evidence (E3), so it is a first-class part of the report rather\nthan a gap the renderer has to notice. A report that cannot say what it\nfailed to learn is a report that overstates what it knows."
      },
      "Action": {
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "title": "Title"
          },
          "explanation": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Explanation"
          },
          "answer_ids": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 32,
            "minItems": 1,
            "title": "Answer Ids"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "title",
          "explanation",
          "answer_ids"
        ],
        "title": "Action",
        "description": "A future verification step with its exact accepted/missing premise."
      },
      "Answer": {
        "properties": {
          "answer_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Answer Id"
          },
          "question_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Question Id"
          },
          "question": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Question"
          },
          "subject_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Subject Id"
          },
          "determination": {
            "type": "string",
            "enum": [
              "source_reported",
              "established",
              "conflicting",
              "unresolved",
              "not_applicable"
            ],
            "title": "Determination"
          },
          "coverage": {
            "type": "string",
            "enum": [
              "covered",
              "partial",
              "uncovered",
              "unsupported",
              "not_applicable"
            ],
            "title": "Coverage"
          },
          "text": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Text"
          },
          "support": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 2000,
            "title": "Support",
            "default": []
          },
          "opposition": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 2000,
            "title": "Opposition",
            "default": []
          },
          "missing": {
            "items": {
              "type": "string",
              "maxLength": 3000,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 32,
            "title": "Missing",
            "default": []
          },
          "rule": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Rule"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "answer_id",
          "question_id",
          "question",
          "subject_id",
          "determination",
          "coverage",
          "text",
          "rule"
        ],
        "title": "Answer",
        "description": "Question-bound analytical meaning, copied without new surface inference."
      },
      "ArtifactExecution": {
        "properties": {
          "artifact_ref": {
            "type": "string",
            "format": "uuid",
            "title": "Artifact Ref"
          },
          "attempted": {
            "type": "boolean",
            "title": "Attempted"
          },
          "reason_code": {
            "type": "string",
            "title": "Reason Code"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "artifact_ref",
          "attempted",
          "reason_code"
        ],
        "title": "ArtifactExecution",
        "description": "An admitted artifact was attempted or explicitly omitted; no ownership inferred."
      },
      "Assessment": {
        "properties": {
          "assessment_id": {
            "type": "string",
            "format": "uuid",
            "title": "Assessment Id"
          },
          "inquiry_id": {
            "type": "string",
            "format": "uuid",
            "title": "Inquiry Id"
          },
          "score": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Score"
          },
          "low": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Low"
          },
          "high": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "High"
          },
          "preliminary": {
            "type": "boolean",
            "title": "Preliminary",
            "description": "True when the stopping rule was not yet met (pre_transaction only)."
          },
          "as_of": {
            "type": "string",
            "format": "date-time",
            "title": "As Of"
          },
          "methodology_version": {
            "type": "string",
            "title": "Methodology Version"
          },
          "label": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Label"
              },
              {
                "type": "null"
              }
            ]
          },
          "evidence": {
            "$ref": "#/components/schemas/EvidenceSummary"
          },
          "entity_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entity Id"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "assessment_id",
          "inquiry_id",
          "score",
          "low",
          "high",
          "preliminary",
          "as_of",
          "methodology_version",
          "label",
          "evidence",
          "entity_id"
        ],
        "title": "Assessment",
        "description": "The public projection of a kernel Assessment."
      },
      "Attention": {
        "properties": {
          "policy": {
            "type": "string",
            "const": "attention-1.0.0",
            "title": "Policy",
            "default": "attention-1.0.0"
          },
          "level": {
            "type": "string",
            "enum": [
              "High",
              "Medium",
              "Low",
              "Not assessed"
            ],
            "title": "Level"
          },
          "reason": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Reason"
          },
          "answer_ids": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 480,
            "title": "Answer Ids",
            "default": []
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "level",
          "reason"
        ],
        "title": "Attention",
        "description": "Uncalibrated review policy result, separate from coverage and facts."
      },
      "AuditEntryOut": {
        "properties": {
          "audit_id": {
            "type": "string",
            "format": "uuid",
            "title": "Audit Id"
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "title": "Occurred At"
          },
          "principal": {
            "type": "string",
            "title": "Principal"
          },
          "action": {
            "type": "string",
            "title": "Action"
          },
          "target_kind": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Kind"
          },
          "target_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Id"
          },
          "cost_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cost Amount"
          },
          "cost_currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cost Currency"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "audit_id",
          "occurred_at",
          "principal",
          "action",
          "target_kind",
          "target_id",
          "cost_amount",
          "cost_currency"
        ],
        "title": "AuditEntryOut",
        "description": "One audited action: who, what, when, at what cost."
      },
      "BindingOut": {
        "properties": {
          "binding_id": {
            "type": "string",
            "format": "uuid",
            "title": "Binding Id"
          },
          "target_kind": {
            "type": "string",
            "enum": [
              "artifact",
              "fingerprint",
              "signal",
              "claim"
            ],
            "title": "Target Kind"
          },
          "target_id": {
            "type": "string",
            "title": "Target Id"
          },
          "locator_kind": {
            "type": "string",
            "enum": [
              "text",
              "document",
              "image",
              "audio",
              "video",
              "structured"
            ],
            "title": "Locator Kind"
          },
          "locator": {
            "additionalProperties": true,
            "type": "object",
            "title": "Locator"
          },
          "confidence": {
            "type": "number",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Confidence"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "binding_id",
          "target_kind",
          "target_id",
          "locator_kind",
          "locator",
          "confidence"
        ],
        "title": "BindingOut",
        "description": "Where an extracted thing sits in its material."
      },
      "CanonicalReport": {
        "properties": {
          "meaning": {
            "$ref": "#/components/schemas/ReportInput"
          },
          "plan": {
            "$ref": "#/components/schemas/EditorialPlan"
          },
          "attention": {
            "$ref": "#/components/schemas/Attention"
          },
          "release": {
            "type": "string",
            "enum": [
              "complete",
              "partial",
              "blocked"
            ],
            "title": "Release"
          },
          "manifest": {
            "$ref": "#/components/schemas/Manifest"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "meaning",
          "plan",
          "attention",
          "release",
          "manifest"
        ],
        "title": "CanonicalReport",
        "description": "Transport schema name that preserves the legacy v1 Report component."
      },
      "CaseAssertionIn": {
        "properties": {
          "summary": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Summary"
          },
          "subject": {
            "$ref": "#/components/schemas/Subject"
          },
          "relates_to": {
            "items": {
              "$ref": "#/components/schemas/Presentation"
            },
            "type": "array",
            "title": "Relates To",
            "default": []
          },
          "observed_at": {
            "type": "string",
            "format": "date-time",
            "title": "Observed At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "summary",
          "subject",
          "observed_at"
        ],
        "title": "CaseAssertionIn",
        "description": "An analyst's judgement, entering as evidence with the analyst_asserted class (E9). Never a score."
      },
      "CaseCreate": {
        "properties": {
          "purpose": {
            "type": "string",
            "title": "Purpose"
          },
          "external_reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "External Reference",
            "description": "FIR, ticket or complaint number."
          },
          "lead_analyst": {
            "type": "string",
            "title": "Lead Analyst",
            "description": "The principal who leads the case."
          },
          "budget_amount": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Budget Amount"
          },
          "budget_currency": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 3,
                "minLength": 3
              },
              {
                "type": "null"
              }
            ],
            "title": "Budget Currency"
          },
          "budget_hops": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Budget Hops"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "purpose",
          "lead_analyst"
        ],
        "title": "CaseCreate",
        "description": "Open an inquiry that lives for weeks: authorization first (I13)."
      },
      "CaseExpandIn": {
        "properties": {
          "from_entity_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "title": "From Entity Ids",
            "default": []
          },
          "from_presentations": {
            "items": {
              "$ref": "#/components/schemas/Presentation"
            },
            "type": "array",
            "title": "From Presentations",
            "default": []
          },
          "max_fan_out": {
            "type": "integer",
            "maximum": 500.0,
            "minimum": 1.0,
            "title": "Max Fan Out",
            "default": 10
          },
          "tier_ceiling": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tier Ceiling"
          },
          "human_gate": {
            "type": "boolean",
            "title": "Human Gate",
            "description": "Show candidates and wait for a choice before spending.",
            "default": true
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "CaseExpandIn",
        "description": "One hop of attribution from the case graph, under the case budget."
      },
      "CaseExportOut": {
        "properties": {
          "export_id": {
            "type": "string",
            "format": "uuid",
            "title": "Export Id"
          },
          "format": {
            "type": "string",
            "enum": [
              "bundle",
              "graphml",
              "dot",
              "maltego"
            ],
            "title": "Format"
          },
          "manifest_hash": {
            "type": "string",
            "title": "Manifest Hash"
          },
          "download_url": {
            "type": "string",
            "title": "Download Url"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "export_id",
          "format",
          "manifest_hash",
          "download_url",
          "expires_at"
        ],
        "title": "CaseExportOut",
        "description": "The evidentiary bundle: every record by hash, the graph, the timeline, a manifest hash over it all."
      },
      "CaseGraphOut": {
        "properties": {
          "nodes": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Nodes"
          },
          "edges": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Edges"
          },
          "as_of": {
            "type": "string",
            "format": "date-time",
            "title": "As Of"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "nodes",
          "edges",
          "as_of"
        ],
        "title": "CaseGraphOut",
        "description": "Nodes and edges of the case graph with type, confidence and relationship."
      },
      "CaseHoldIn": {
        "properties": {
          "reason": {
            "type": "string",
            "minLength": 1,
            "title": "Reason"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "reason"
        ],
        "title": "CaseHoldIn",
        "description": "Place or release legal hold; deletion becomes impossible while held (I12)."
      },
      "CaseMemberIn": {
        "properties": {
          "presentations": {
            "items": {
              "$ref": "#/components/schemas/Presentation"
            },
            "type": "array",
            "title": "Presentations",
            "default": []
          },
          "material_ids": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Material Ids",
            "default": []
          },
          "entity_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "title": "Entity Ids",
            "default": []
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "CaseMemberIn",
        "description": "Add a presentation, material or known entity to a case."
      },
      "CaseOut": {
        "properties": {
          "case_id": {
            "type": "string",
            "format": "uuid",
            "title": "Case Id"
          },
          "opened_at": {
            "type": "string",
            "format": "date-time",
            "title": "Opened At"
          },
          "hold": {
            "type": "boolean",
            "title": "Hold"
          },
          "review_state": {
            "type": "string",
            "enum": [
              "open",
              "in_review",
              "signed_off",
              "closed"
            ],
            "title": "Review State"
          },
          "closed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Closed At"
          },
          "budget_remaining": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Budget Remaining"
          },
          "hops_remaining": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hops Remaining"
          },
          "events_url": {
            "type": "string",
            "title": "Events Url"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "case_id",
          "opened_at",
          "hold",
          "review_state",
          "closed_at",
          "budget_remaining",
          "hops_remaining",
          "events_url"
        ],
        "title": "CaseOut",
        "description": "The case resource and its current state, derived from its event log."
      },
      "CaseReviewIn": {
        "properties": {
          "review_state": {
            "type": "string",
            "enum": [
              "in_review",
              "signed_off",
              "closed"
            ],
            "title": "Review State"
          },
          "note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Note"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "review_state"
        ],
        "title": "CaseReviewIn",
        "description": "Move the review state; sign-off gates export."
      },
      "Check": {
        "properties": {
          "subject_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Subject Id"
          },
          "method": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Method"
          },
          "outcome": {
            "type": "string",
            "enum": [
              "observed",
              "partial",
              "no_record",
              "unavailable",
              "refused",
              "timeout",
              "not_attempted",
              "unsupported",
              "cancelled",
              "interrupted"
            ],
            "title": "Outcome"
          },
          "reason": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Reason"
          },
          "negative_scope": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 3000,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Negative Scope"
          },
          "negative_period": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ],
            "title": "Negative Period"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "subject_id",
          "method",
          "outcome",
          "reason"
        ],
        "title": "Check",
        "description": "Retained acquisition outcome; an operational failure is not a subject finding."
      },
      "Claim": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type",
            "description": "A registered claim type id. Always data class C2."
          },
          "fields": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Fields",
            "description": "The claim's fields. Never stored raw; verified to an outcome."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "type",
          "fields"
        ],
        "title": "Claim",
        "description": "A structured assertion to verify (never looked up): a registered claim type and its fields."
      },
      "Connection": {
        "properties": {
          "connection_id": {
            "type": "string",
            "format": "uuid",
            "title": "Connection Id",
            "description": "Stable id for this edge, so a report can cite it."
          },
          "kind": {
            "type": "string",
            "enum": [
              "declared",
              "resolved",
              "contradiction",
              "temporal",
              "shared",
              "similar",
              "asserted"
            ],
            "title": "Kind",
            "description": "How the edge came to exist, so a reader can weigh it: `declared` (a source reported it), `resolved` (evidence says these are one subject), `contradiction` (two sources disagree), `temporal` (a date a source asserted), `shared` (both reach the same third thing), `similar` (their values are close), `asserted` (a person said so)."
          },
          "relation": {
            "type": "string",
            "title": "Relation",
            "description": "The registered relationship type, e.g. shares_registrant."
          },
          "from_label": {
            "type": "string",
            "title": "From Label",
            "description": "The caller's own value where it was theirs, else its type."
          },
          "from_type": {
            "type": "string",
            "title": "From Type"
          },
          "to_label": {
            "type": "string",
            "title": "To Label"
          },
          "to_type": {
            "type": "string",
            "title": "To Type"
          },
          "weight": {
            "type": "number",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Weight",
            "description": "The kernel's computed strength for this edge."
          },
          "reason": {
            "type": "string",
            "title": "Reason",
            "description": "Why the edge holds, with every source name removed."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "connection_id",
          "kind",
          "relation",
          "from_label",
          "from_type",
          "to_label",
          "to_type",
          "weight",
          "reason"
        ],
        "title": "Connection",
        "description": "An edge the engine drew between two things, and why it drew it.\n\nThis is the part a flat aggregator cannot produce and the reason the free\nreport is worth running: not a longer list, but the joins between its\nentries."
      },
      "ConsentRecordOut": {
        "properties": {
          "record_id": {
            "type": "string",
            "format": "uuid",
            "title": "Record Id"
          },
          "inquiry_id": {
            "type": "string",
            "format": "uuid",
            "title": "Inquiry Id",
            "description": "The kernel trace this presentation was admitted under."
          },
          "purpose": {
            "type": "string",
            "title": "Purpose"
          },
          "consent_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Consent Ref",
            "description": "The caller's own consent reference, when the purpose required one."
          },
          "accepted_at": {
            "type": "string",
            "format": "date-time",
            "title": "Accepted At"
          },
          "presentation_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Presentation Hash",
            "description": "Null once purged past expires_at; never the presented value."
          },
          "artifact_type": {
            "type": "string",
            "title": "Artifact Type"
          },
          "data_class": {
            "type": "string",
            "enum": [
              "C0",
              "C1",
              "C2"
            ],
            "title": "Data Class"
          },
          "ttl_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ttl Days",
            "description": "From the pack's retention rule; null when the pack has not bounded it."
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "purged_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Purged At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "record_id",
          "inquiry_id",
          "purpose",
          "accepted_at",
          "artifact_type",
          "data_class",
          "expires_at",
          "purged_at"
        ],
        "title": "ConsentRecordOut",
        "description": "What was retained for one presentation, under which purpose, and for how long (D67, D68).\n\n``presentation_hash`` is the kernel's own content-addressed artifact id\n(D25): a sha256 of the type and the normalised value, never the value\nitself. It is null once the record has been purged past its own\n``expires_at``; the record's shape survives the purge because proving\nwhat was promised does not require the hash to still exist."
      },
      "Coverage": {
        "$ref": "#/components/schemas/CoveragePayload"
      },
      "CoverageGap": {
        "properties": {
          "about_type": {
            "type": "string",
            "title": "About Type"
          },
          "tools_above_ceiling": {
            "type": "integer",
            "title": "Tools Above Ceiling",
            "description": "How many registered tools this tier could not reach."
          },
          "lowest_tier_that_would_run": {
            "type": "string",
            "title": "Lowest Tier That Would Run"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "about_type",
          "tools_above_ceiling",
          "lowest_tier_that_would_run"
        ],
        "title": "CoverageGap",
        "description": "A class of check that exists but was not run, because of the tier ceiling.\n\nThis is the honest upgrade prompt. \"Nine platforms checked directly,\nopen-web discovery not run at this tier\" is true, useful to the reader,\nand better than any claim the marketing copy could make."
      },
      "CoveragePayload": {
        "properties": {
          "tier_ceiling": {
            "type": "string",
            "title": "Tier Ceiling"
          },
          "checks_run": {
            "type": "integer",
            "title": "Checks Run"
          },
          "checks_answered": {
            "type": "integer",
            "title": "Checks Answered"
          },
          "checks_unanswered": {
            "type": "integer",
            "title": "Checks Unanswered"
          },
          "execution": {
            "$ref": "#/components/schemas/ExecutionSummary"
          },
          "gaps": {
            "items": {
              "$ref": "#/components/schemas/CoverageGap"
            },
            "type": "array",
            "title": "Gaps"
          },
          "open_web": {
            "type": "string",
            "enum": [
              "searched",
              "degraded",
              "not_searched"
            ],
            "title": "Open Web"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "tier_ceiling",
          "checks_run",
          "checks_answered",
          "checks_unanswered",
          "gaps",
          "open_web"
        ],
        "title": "CoveragePayload",
        "description": "Wire shape for coverage, omitting the server-selected extension when absent."
      },
      "Declined": {
        "properties": {
          "members": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Members",
            "description": "Node ids the evidence weakly grouped."
          },
          "low": {
            "type": "number",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Low"
          },
          "high": {
            "type": "number",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "High"
          },
          "reason": {
            "type": "string",
            "title": "Reason",
            "description": "Why it was not enough to link them."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "members",
          "low",
          "high",
          "reason"
        ],
        "title": "Declined",
        "description": "Two things the evidence linked weakly, which we refused to call one.\n\nThe most important thing this document carries, and the easiest to leave\nout. A namesake attached to a subject is a false accusation that no\ncorrection undoes, so a grouping below the minting floor is recorded,\nshown, and explicitly *not* merged. Saying so out loud is what makes the\nrest of the report trustworthy."
      },
      "Discovery": {
        "properties": {
          "from_id": {
            "type": "string",
            "title": "From Id"
          },
          "to_id": {
            "type": "string",
            "title": "To Id"
          },
          "relation": {
            "type": "string",
            "title": "Relation",
            "description": "How the one led to the other, e.g. published_on_own_dns."
          },
          "label": {
            "type": "string",
            "title": "Label",
            "description": "The relation as an edge label a reader can read, e.g. `published in its own DNS`.",
            "default": ""
          },
          "confidence": {
            "type": "number",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Confidence"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "from_id",
          "to_id",
          "relation",
          "confidence"
        ],
        "title": "Discovery",
        "description": "One step of the investigation: examining this revealed that.\n\nDistinct from a `Connection`, and the difference matters to a reader. A\nconnection is an inference the engine drew between two things; a discovery\nis a fact about how the check proceeded. \"We read the domain's DNS and it\nnamed this mailbox\" is the sentence that makes a report feel like an\ninvestigation rather than a list."
      },
      "EditorialPlan": {
        "properties": {
          "audience": {
            "type": "string",
            "enum": [
              "individual",
              "fraud_team"
            ],
            "title": "Audience"
          },
          "title": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Title"
          },
          "summary": {
            "items": {
              "$ref": "#/components/schemas/Sentence"
            },
            "type": "array",
            "maxItems": 12,
            "minItems": 1,
            "title": "Summary"
          },
          "important": {
            "items": {
              "$ref": "#/components/schemas/Sentence"
            },
            "type": "array",
            "maxItems": 24,
            "title": "Important",
            "default": []
          },
          "uncertainty": {
            "items": {
              "$ref": "#/components/schemas/Sentence"
            },
            "type": "array",
            "maxItems": 24,
            "title": "Uncertainty",
            "default": []
          },
          "actions": {
            "items": {
              "$ref": "#/components/schemas/Action"
            },
            "type": "array",
            "maxItems": 12,
            "title": "Actions",
            "default": []
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "audience",
          "title",
          "summary"
        ],
        "title": "EditorialPlan",
        "description": "Audience changes expression and priority while retaining the same meaning."
      },
      "EntityOut": {
        "properties": {
          "entity_id": {
            "type": "string",
            "format": "uuid",
            "title": "Entity Id"
          },
          "kind": {
            "type": "string",
            "enum": [
              "person",
              "organisation",
              "device",
              "cluster"
            ],
            "title": "Kind"
          },
          "presentations": {
            "items": {
              "$ref": "#/components/schemas/Presentation"
            },
            "type": "array",
            "title": "Presentations"
          },
          "ledger_length": {
            "type": "integer",
            "title": "Ledger Length"
          },
          "latest": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Assessment"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "entity_id",
          "kind",
          "presentations",
          "ledger_length",
          "latest"
        ],
        "title": "EntityOut",
        "description": "A resolved subject as the tenant may see it: kind, current presentations, ledger summary."
      },
      "EventEnvelope": {
        "properties": {
          "event_id": {
            "type": "string",
            "title": "Event Id"
          },
          "type": {
            "type": "string",
            "title": "Type",
            "description": "One of the event types in griffynx_api.events."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "title": "Occurred At"
          },
          "subject_id": {
            "type": "string",
            "title": "Subject Id",
            "description": "inquiry_id, case_id, monitor_id or session_id the event concerns."
          },
          "payload": {
            "additionalProperties": true,
            "type": "object",
            "title": "Payload"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "event_id",
          "type",
          "occurred_at",
          "subject_id",
          "payload"
        ],
        "title": "EventEnvelope",
        "description": "One event on any stream (SSE, WebSocket, webhook): replayable by cursor."
      },
      "EvidenceSummary": {
        "properties": {
          "signals": {
            "type": "integer",
            "title": "Signals"
          },
          "failed_signals": {
            "type": "integer",
            "title": "Failed Signals"
          },
          "contradictions": {
            "type": "integer",
            "title": "Contradictions"
          },
          "by_provenance_class": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "By Provenance Class"
          },
          "by_trust_band": {
            "additionalProperties": {
              "type": "integer"
            },
            "propertyNames": {
              "enum": [
                "high",
                "medium",
                "low"
              ]
            },
            "type": "object",
            "title": "By Trust Band"
          },
          "oldest_observed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Oldest Observed At"
          },
          "newest_observed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Newest Observed At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "signals",
          "failed_signals",
          "contradictions",
          "by_provenance_class",
          "by_trust_band",
          "oldest_observed_at",
          "newest_observed_at"
        ],
        "title": "EvidenceSummary",
        "description": "What the tenant may see of the chain of evidence: counts and bands, never raw or provider names."
      },
      "ExecutionAction": {
        "properties": {
          "action_ref": {
            "type": "string",
            "format": "uuid",
            "title": "Action Ref"
          },
          "artifact_ref": {
            "type": "string",
            "format": "uuid",
            "title": "Artifact Ref"
          },
          "status": {
            "type": "string",
            "enum": [
              "completed",
              "partial",
              "failed",
              "timed_out",
              "unavailable",
              "skipped",
              "blocked",
              "unsupported"
            ],
            "title": "Status"
          },
          "reason_code": {
            "type": "string",
            "title": "Reason Code"
          },
          "attempted": {
            "type": "boolean",
            "title": "Attempted"
          },
          "signal_frames": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Signal Frames"
          },
          "failure_frames": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Failure Frames"
          },
          "emitted_candidates": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Emitted Candidates",
            "default": 0
          },
          "admission_omitted": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Admission Omitted",
            "default": 0
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "action_ref",
          "artifact_ref",
          "status",
          "reason_code",
          "attempted",
          "signal_frames",
          "failure_frames"
        ],
        "title": "ExecutionAction",
        "description": "One opaque logical action, independent of the number of emitted frames (KUN-209)."
      },
      "ExecutionSummary": {
        "properties": {
          "version": {
            "type": "string",
            "const": "m2",
            "title": "Version",
            "default": "m2"
          },
          "actions": {
            "items": {
              "$ref": "#/components/schemas/ExecutionAction"
            },
            "type": "array",
            "title": "Actions",
            "default": []
          },
          "artifacts": {
            "items": {
              "$ref": "#/components/schemas/ArtifactExecution"
            },
            "type": "array",
            "title": "Artifacts",
            "default": []
          },
          "detected": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Detected"
          },
          "emitted": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Emitted"
          },
          "extraction_omitted": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Extraction Omitted"
          },
          "extraction_totals_complete": {
            "type": "boolean",
            "title": "Extraction Totals Complete",
            "description": "All admitted text roots have instrumented extractor counts, not exhaustive recognition.",
            "default": false
          },
          "emitted_candidates": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Emitted Candidates",
            "default": 0
          },
          "admission_omitted": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Admission Omitted",
            "default": 0
          },
          "admitted": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Admitted"
          },
          "attempted": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Attempted"
          },
          "omitted": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Omitted"
          },
          "declared_units": {
            "type": "number",
            "minimum": 0.0,
            "title": "Declared Units"
          },
          "reserved_units": {
            "type": "number",
            "minimum": 0.0,
            "title": "Reserved Units"
          },
          "attempted_units": {
            "type": "number",
            "minimum": 0.0,
            "title": "Attempted Units"
          },
          "confirmed_billing": {
            "type": "string",
            "const": "unknown",
            "title": "Confirmed Billing",
            "default": "unknown"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "admitted",
          "attempted",
          "omitted",
          "declared_units",
          "reserved_units",
          "attempted_units"
        ],
        "title": "ExecutionSummary",
        "description": "Opt-in operational coverage; logical units are never confirmed supplier billing."
      },
      "ExtractionOut": {
        "properties": {
          "material_id": {
            "type": "string",
            "title": "Material Id"
          },
          "presentations": {
            "items": {
              "$ref": "#/components/schemas/Presentation"
            },
            "type": "array",
            "title": "Presentations"
          },
          "bindings": {
            "items": {
              "$ref": "#/components/schemas/BindingOut"
            },
            "type": "array",
            "title": "Bindings"
          },
          "fingerprint_summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fingerprint Summary"
          },
          "derived_material_ids": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Derived Material Ids"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "material_id",
          "presentations",
          "bindings",
          "fingerprint_summary",
          "derived_material_ids"
        ],
        "title": "ExtractionOut",
        "description": "Everything extracted from one material: presentations found, fingerprint, derived material."
      },
      "Fact": {
        "properties": {
          "fact_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Fact Id"
          },
          "subject_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Subject Id"
          },
          "predicate": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Predicate"
          },
          "value": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Value"
          },
          "value_type": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Value Type"
          },
          "source_role": {
            "type": "string",
            "enum": [
              "registry",
              "platform",
              "subject",
              "aggregator",
              "unknown"
            ],
            "title": "Source Role"
          },
          "assertion_role": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Assertion Role",
            "default": "source_report"
          },
          "publisher": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "title": "Publisher"
          },
          "source_url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Source Url"
          },
          "field_locator": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Field Locator"
          },
          "evidence_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Evidence Hash"
          },
          "dependency_key": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Dependency Key"
          },
          "upstream_dependencies": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 16,
            "title": "Upstream Dependencies",
            "default": []
          },
          "reference_kind": {
            "type": "string",
            "enum": [
              "source_evidence",
              "legacy_projection"
            ],
            "title": "Reference Kind",
            "default": "source_evidence"
          },
          "collected_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Collected At"
          },
          "source_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source At"
          },
          "effective_from": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Effective From"
          },
          "effective_until": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Effective Until"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "fact_id",
          "subject_id",
          "predicate",
          "value",
          "value_type",
          "source_role",
          "publisher",
          "source_url",
          "field_locator",
          "evidence_hash",
          "dependency_key"
        ],
        "title": "Fact",
        "description": "One retained source statement, preserving its distinct account and clocks."
      },
      "Finding": {
        "properties": {
          "finding_id": {
            "type": "string",
            "format": "uuid",
            "title": "Finding Id"
          },
          "node_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Node Id",
            "description": "The node in `graph` this fact is about, when the check drew one. Opaque and stable within this response only."
          },
          "about": {
            "type": "string",
            "title": "About",
            "description": "The caller's own presented value this concerns, when it was theirs."
          },
          "about_type": {
            "type": "string",
            "title": "About Type",
            "description": "The registered artifact type of `about`."
          },
          "kind": {
            "type": "string",
            "title": "Kind",
            "description": "What sort of check produced this, e.g. account_age, domain_popularity. A renderer uses it to say what a finding of this sort means; it names the question asked, never who was asked.",
            "default": "unknown"
          },
          "statement": {
            "type": "string",
            "title": "Statement",
            "description": "What was found, in words, with every source name removed."
          },
          "disposition": {
            "type": "string",
            "enum": [
              "supports",
              "weakens",
              "neutral"
            ],
            "title": "Disposition",
            "description": "Which way this points for somebody deciding whether to trust the subject, as the source itself declared it. Never parsed from `statement`, never a score, and never an input to the assessment. It is here so a tenant's policy can form a label (D05).",
            "default": "neutral"
          },
          "provenance_class": {
            "type": "string",
            "title": "Provenance Class",
            "description": "How this came to be known, e.g. third_party, computed."
          },
          "trust_band": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low"
            ],
            "title": "Trust Band",
            "description": "The banded trust of its source."
          },
          "observed_at": {
            "type": "string",
            "format": "date-time",
            "title": "Observed At"
          },
          "data_class": {
            "type": "string",
            "title": "Data Class",
            "description": "C0, C1 or C2. What handling this fact requires."
          },
          "attributes": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Attributes",
            "description": "What the source said, as structure, when it said something that has one. For a statement a public page makes: `predicate` (role, affiliation, founded, located, event, ownership, dispute, description, public_statement, review), `quote` (the page's own words, verbatim), `source_url` and `page_date`. For a profile: the platform, name, bio, location and when the account was created. Absent for most findings. It is what was said, never what it is worth."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "finding_id",
          "about",
          "about_type",
          "statement",
          "provenance_class",
          "trust_band",
          "observed_at",
          "data_class"
        ],
        "title": "Finding",
        "description": "One thing that was established about the subject.\n\nNothing here is an interpretation written by this repo. `disposition` is\nthe *source's* own statement of which way its finding points, declared\nbeside the logic that computed it and carried through unchanged; this\nlayer neither derives it nor second-guesses it, which is what keeps I4\nintact. What a tenant does with it is their policy (D05)."
      },
      "Findings": {
        "$ref": "#/components/schemas/FindingsPayload"
      },
      "FindingsPayload": {
        "properties": {
          "inquiry_id": {
            "type": "string",
            "format": "uuid",
            "title": "Inquiry Id"
          },
          "reasons": {
            "items": {
              "$ref": "#/components/schemas/GroundedReason"
            },
            "type": "array",
            "title": "Reasons"
          },
          "assessment_id": {
            "type": "string",
            "format": "uuid",
            "title": "Assessment Id"
          },
          "subject": {
            "items": {
              "$ref": "#/components/schemas/Presentation"
            },
            "type": "array",
            "title": "Subject"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "absences": {
            "items": {
              "$ref": "#/components/schemas/Absence"
            },
            "type": "array",
            "title": "Absences"
          },
          "connections": {
            "items": {
              "$ref": "#/components/schemas/Connection"
            },
            "type": "array",
            "title": "Connections"
          },
          "identities": {
            "items": {
              "$ref": "#/components/schemas/Identity"
            },
            "type": "array",
            "title": "Identities"
          },
          "graph": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Graph"
              },
              {
                "type": "null"
              }
            ]
          },
          "coverage": {
            "$ref": "#/components/schemas/Coverage"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Generated At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "inquiry_id",
          "assessment_id",
          "subject",
          "findings",
          "absences",
          "connections",
          "identities",
          "graph",
          "coverage",
          "generated_at"
        ],
        "title": "FindingsPayload",
        "description": "Wire shape for findings, including optional contextual-reason omission."
      },
      "FraudIntakeV1": {
        "properties": {
          "version": {
            "type": "integer",
            "const": 1,
            "title": "Version",
            "default": 1
          },
          "messages": {
            "items": {
              "$ref": "#/components/schemas/MessageIntakeV1"
            },
            "type": "array",
            "maxItems": 5,
            "minItems": 1,
            "title": "Messages"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "messages"
        ],
        "title": "FraudIntakeV1",
        "description": "Opt-in intake v1; neither channel nor sender establishes identity."
      },
      "Graph": {
        "properties": {
          "nodes": {
            "items": {
              "$ref": "#/components/schemas/Node"
            },
            "type": "array",
            "title": "Nodes",
            "default": []
          },
          "discoveries": {
            "items": {
              "$ref": "#/components/schemas/Discovery"
            },
            "type": "array",
            "title": "Discoveries",
            "default": []
          },
          "leads": {
            "items": {
              "$ref": "#/components/schemas/Lead"
            },
            "type": "array",
            "title": "Leads",
            "default": []
          },
          "declined": {
            "items": {
              "$ref": "#/components/schemas/Declined"
            },
            "type": "array",
            "title": "Declined",
            "default": []
          },
          "hops_explored": {
            "type": "integer",
            "title": "Hops Explored",
            "default": 0
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Graph",
        "description": "The picture: what was found, what led to what, and what was left alone."
      },
      "GroundedPremise": {
        "properties": {
          "finding_id": {
            "type": "string",
            "format": "uuid",
            "title": "Finding Id"
          },
          "field": {
            "type": "string",
            "title": "Field"
          },
          "value": {
            "type": "string",
            "title": "Value"
          },
          "start": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Start"
          },
          "end": {
            "type": "integer",
            "exclusiveMinimum": 0.0,
            "title": "End"
          },
          "role": {
            "type": "string",
            "enum": [
              "sender",
              "quoted_sender",
              "reported_sender"
            ],
            "title": "Role"
          },
          "group": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Group"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "finding_id",
          "field",
          "value",
          "start",
          "end",
          "role",
          "group"
        ],
        "title": "GroundedPremise",
        "description": "An eligible original-text predicate, not a reconstructed excerpt or identity claim."
      },
      "GroundedReason": {
        "properties": {
          "reason_id": {
            "type": "string",
            "format": "uuid",
            "title": "Reason Id"
          },
          "target_ref": {
            "type": "string",
            "format": "uuid",
            "title": "Target Ref"
          },
          "typology_id": {
            "type": "string",
            "title": "Typology Id"
          },
          "typology_version": {
            "type": "string",
            "title": "Typology Version"
          },
          "rule_version": {
            "type": "string",
            "const": "context-en-v1",
            "title": "Rule Version"
          },
          "material_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Material Hash"
          },
          "matched_fields": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Matched Fields"
          },
          "supporting_finding_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "title": "Supporting Finding Ids"
          },
          "premises": {
            "items": {
              "$ref": "#/components/schemas/GroundedPremise"
            },
            "type": "array",
            "title": "Premises"
          },
          "statement": {
            "type": "string",
            "title": "Statement"
          },
          "limitations": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Limitations",
            "default": []
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "reason_id",
          "target_ref",
          "typology_id",
          "typology_version",
          "rule_version",
          "material_hash",
          "matched_fields",
          "supporting_finding_ids",
          "premises",
          "statement"
        ],
        "title": "GroundedReason",
        "description": "An actual kernel match with relevant supporting premises, never a keyword-only allegation."
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "Identity": {
        "properties": {
          "identity_id": {
            "type": "string",
            "format": "uuid",
            "title": "Identity Id",
            "description": "Stable for these members in this inquiry; what a paragraph cites."
          },
          "members": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "minItems": 2,
            "title": "Members",
            "description": "Node ids the evidence groups."
          },
          "band": {
            "type": "string",
            "enum": [
              "resolved",
              "candidate"
            ],
            "title": "Band",
            "description": "`resolved` when the evidence clears the floor for one subject; `candidate` when it does not."
          },
          "low": {
            "type": "number",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Low"
          },
          "high": {
            "type": "number",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "High"
          },
          "independent_evidence": {
            "type": "integer",
            "minimum": 0.0,
            "title": "Independent Evidence",
            "description": "How many lines of evidence do not depend on one another. One is never enough."
          },
          "reason": {
            "type": "string",
            "title": "Reason",
            "description": "What joined them, in words, without naming who supplied it."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "identity_id",
          "members",
          "band",
          "low",
          "high",
          "independent_evidence",
          "reason"
        ],
        "title": "Identity",
        "description": "Two or more nodes the evidence says are one subject, and why.\n\nWhat resolve decided, which until now left the API as a refusal and nothing\nelse: a grouping too weak to merge appeared as `Declined`, and one strong\nenough to merge appeared nowhere. `resolved` is the second, `candidate` the\nfirst. Both carry their interval, because an identity is a claim about\npeople and the reader is owed how sure it is."
      },
      "InquiryRequest": {
        "properties": {
          "subject": {
            "$ref": "#/components/schemas/Subject"
          },
          "intent": {
            "type": "string",
            "title": "Intent",
            "description": "A registered intent id, e.g. pre_transaction, onboarding_screen."
          },
          "purpose": {
            "type": "string",
            "title": "Purpose",
            "description": "A registered purpose id. Required on every call (I13)."
          },
          "stake": {
            "$ref": "#/components/schemas/Stake"
          },
          "fraud_intake": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FraudIntakeV1"
              },
              {
                "type": "null"
              }
            ]
          },
          "context": {
            "items": {
              "$ref": "#/components/schemas/ObservationIn"
            },
            "type": "array",
            "title": "Context",
            "description": "The caller's own testimony, attached inline: at most 20, each about something this inquiry presents, each under this inquiry's purpose, and `tenant_supplied` or `self_attested` (with a consent reference). It is written into the inquiry's evidence as the caller's word and never lends a tool's trust. A subject's name is carried as an observation whose summary is `Name: <text>`.",
            "default": []
          },
          "material_ids": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Material Ids",
            "description": "Bound supported text material; images/PDF/OCR are not readable evidence. Binding unreadable or mixed text/non-text materials is refused. Declaration/storage alone does not run a check.",
            "default": []
          },
          "consent_ref": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Consent Ref",
            "description": "The caller's own record of the reader's consent, for example the id of the consent event. Required for a purpose that enumerates someone's own accounts (`self_exposure_audit`); otherwise optional. It is an opaque reference, never the consent text."
          },
          "tier_ceiling": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tier Ceiling",
            "description": "Highest provider tier this inquiry may use."
          },
          "render": {
            "type": "string",
            "enum": [
              "none",
              "template",
              "model"
            ],
            "title": "Render",
            "description": "Whether to write the findings up as a report. `none` is the default because a caller that only wants the numbers should not pay for prose. A tenant may be clamped below what it asks for; the reply says which renderer ran.",
            "default": "none"
          },
          "render_lang": {
            "type": "string",
            "title": "Render Lang",
            "description": "Language tag for the report, e.g. en, hi.",
            "default": "en"
          },
          "mode": {
            "type": "string",
            "enum": [
              "sync",
              "async",
              "stream"
            ],
            "title": "Mode",
            "default": "sync"
          },
          "idempotency_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Idempotency Key"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "subject",
          "intent",
          "purpose",
          "stake"
        ],
        "title": "InquiryRequest",
        "description": "Ask about a subject at a stake, for a purpose, with an intent."
      },
      "InquiryResponse": {
        "$ref": "#/components/schemas/InquiryResponsePayload"
      },
      "InquiryResponsePayload": {
        "properties": {
          "inquiry_id": {
            "type": "string",
            "format": "uuid",
            "title": "Inquiry Id"
          },
          "fraud_intake": {
            "items": {
              "$ref": "#/components/schemas/IntakeSummaryV1"
            },
            "type": "array",
            "title": "Fraud Intake"
          },
          "execution": {
            "$ref": "#/components/schemas/ExecutionSummary"
          },
          "status": {
            "type": "string",
            "enum": [
              "accepted",
              "reasoning",
              "preliminary",
              "concluded",
              "rejected"
            ],
            "title": "Status"
          },
          "assessment": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Assessment"
              },
              {
                "type": "null"
              }
            ]
          },
          "findings": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Findings"
              },
              {
                "type": "null"
              }
            ]
          },
          "report": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Report"
              },
              {
                "type": "null"
              }
            ]
          },
          "rejection": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Rejected"
              },
              {
                "type": "null"
              }
            ]
          },
          "events_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Events Url"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "inquiry_id",
          "status",
          "assessment",
          "findings",
          "report",
          "rejection",
          "events_url"
        ],
        "title": "InquiryResponsePayload",
        "description": "Wire shape for the response serializer, including its omitted optional keys."
      },
      "IntakeItem": {
        "properties": {
          "item_ref": {
            "type": "string",
            "maxLength": 64,
            "minLength": 1,
            "title": "Item Ref",
            "description": "The caller's id for this item within the batch."
          },
          "presentation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Presentation"
              },
              {
                "type": "null"
              }
            ]
          },
          "material": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MaterialCreate"
              },
              {
                "type": "null"
              }
            ]
          },
          "content_sha256": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 64,
                "minLength": 64
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Sha256",
            "description": "Required for material with bytes to follow: fixes the material id and idempotency."
          },
          "source_ref": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Ref",
            "description": "Where the caller got it (complainant, seized device, tip line). Never a relation."
          },
          "observed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Observed At",
            "description": "When the caller observed it, if known."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "item_ref"
        ],
        "title": "IntakeItem",
        "description": "One thing arriving for a case: a presentation, or a declared piece of material (D43).\n\nExactly one of ``presentation`` and ``material`` is set. Bytes never travel\nin the manifest: material is declared here with its hash and the bytes\nland at the evidence store by that hash, exactly as ``POST /v1/material``\ndoes. Items are nodes only; an item never asserts a relation to another."
      },
      "IntakeItemResult": {
        "properties": {
          "item_ref": {
            "type": "string",
            "title": "Item Ref"
          },
          "status": {
            "type": "string",
            "enum": [
              "accepted",
              "duplicate",
              "rejected"
            ],
            "title": "Status"
          },
          "artifact_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Artifact Id"
          },
          "material_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Material Id"
          },
          "upload_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Upload Url",
            "description": "Where the bytes go, for accepted material with bytes to follow."
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason",
            "description": "For rejected items: the rule that refused it."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "item_ref",
          "status"
        ],
        "title": "IntakeItemResult",
        "description": "One item's fate: accepted with its content id, a duplicate the case already holds, or rejected."
      },
      "IntakeManifest": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/IntakeItem"
            },
            "type": "array",
            "maxItems": 200,
            "minItems": 1,
            "title": "Items"
          },
          "note": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 500
              },
              {
                "type": "null"
              }
            ],
            "title": "Note",
            "description": "The caller's note on the batch as a whole."
          },
          "idempotency_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Idempotency Key"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "items"
        ],
        "title": "IntakeManifest",
        "description": "A bounded, mixed batch of items for a case, recorded as one intake event (D43).\n\nThe manifest is hashed and written as a ``CaseEvent`` so the evidentiary\nbundle knows what arrived, when, from whom and under which authorization.\nRegistering members never spends: extraction runs on material when its\nbytes arrive, as for any material; gathering waits for ``expand``."
      },
      "IntakeOut": {
        "properties": {
          "intake_id": {
            "type": "string",
            "format": "uuid",
            "title": "Intake Id"
          },
          "case_id": {
            "type": "string",
            "format": "uuid",
            "title": "Case Id"
          },
          "manifest_hash": {
            "type": "string",
            "title": "Manifest Hash"
          },
          "accepted": {
            "type": "integer",
            "title": "Accepted"
          },
          "duplicates": {
            "type": "integer",
            "title": "Duplicates"
          },
          "rejected": {
            "type": "integer",
            "title": "Rejected"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/IntakeItemResult"
            },
            "type": "array",
            "title": "Items"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "title": "Recorded At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "intake_id",
          "case_id",
          "manifest_hash",
          "accepted",
          "duplicates",
          "rejected",
          "items",
          "recorded_at"
        ],
        "title": "IntakeOut",
        "description": "The intake record: partial success is normal; every item answers for itself."
      },
      "IntakeSummaryV1": {
        "properties": {
          "material_id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Material Id"
          },
          "channel": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "whatsapp",
                  "sms",
                  "email",
                  "call",
                  "social",
                  "other"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Channel"
          },
          "sender_status": {
            "type": "string",
            "enum": [
              "absent",
              "recognized",
              "malformed",
              "unclassified"
            ],
            "title": "Sender Status"
          },
          "sender_type": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "EMAIL",
                  "PHONE",
                  "UPI_ID",
                  "URL"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Sender Type"
          },
          "presentation_ref": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Presentation Ref"
          },
          "reason_code": {
            "type": "string",
            "maxLength": 64,
            "title": "Reason Code"
          },
          "parser_version": {
            "type": "string",
            "const": "sender-v1",
            "title": "Parser Version",
            "default": "sender-v1"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "material_id",
          "sender_status",
          "reason_code"
        ],
        "title": "IntakeSummaryV1",
        "description": "Safe interpretation metadata, without raw sender or message content."
      },
      "KeyCreate": {
        "properties": {
          "label": {
            "type": "string",
            "title": "Label"
          },
          "scopes": {
            "items": {
              "type": "string",
              "enum": [
                "inquiries",
                "observations",
                "material",
                "cases",
                "monitors",
                "sessions",
                "trials",
                "admin"
              ]
            },
            "type": "array",
            "title": "Scopes"
          },
          "environment": {
            "type": "string",
            "enum": [
              "live",
              "test"
            ],
            "title": "Environment"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "label",
          "scopes",
          "environment"
        ],
        "title": "KeyCreate",
        "description": "Mint a tenant key: shown once, stored as a salted hash, prefixed gx_live_ or gx_test_ (I11)."
      },
      "KeyOut": {
        "properties": {
          "key_id": {
            "type": "string",
            "format": "uuid",
            "title": "Key Id"
          },
          "prefix": {
            "type": "string",
            "title": "Prefix"
          },
          "secret": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Secret"
          },
          "scopes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Scopes"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Revoked At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "key_id",
          "prefix",
          "secret",
          "scopes",
          "created_at",
          "revoked_at"
        ],
        "title": "KeyOut",
        "description": "The minted key. ``secret`` is present only in the creation response."
      },
      "Label": {
        "properties": {
          "value": {
            "type": "string",
            "title": "Value"
          },
          "policy_id": {
            "type": "string",
            "format": "uuid",
            "title": "Policy Id"
          },
          "policy_version": {
            "type": "integer",
            "title": "Policy Version"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "value",
          "policy_id",
          "policy_version"
        ],
        "title": "Label",
        "description": "The tenant's policy applied to the assessment. Belongs to the policy, not the assessment."
      },
      "Lead": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type"
          },
          "label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Label",
            "description": "Named under the same rule as a node."
          },
          "reason": {
            "type": "string",
            "title": "Reason",
            "description": "Why this check stopped here, in a reader's words."
          },
          "hop": {
            "type": "integer",
            "title": "Hop"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "type",
          "reason",
          "hop"
        ],
        "title": "Lead",
        "description": "Something found and not followed, and why not.\n\nNever a judgement about the thing. It is a statement about the limits of\n*this* check: its depth, its budget, or how ordinary the node looked next\nto the others. E7 already requires a tool we could not afford to be\ndistinguishable from a source that knew nothing, and this is the same\nprinciple one level up."
      },
      "LedgerEntryOut": {
        "properties": {
          "position": {
            "type": "integer",
            "title": "Position"
          },
          "assessment_id": {
            "type": "string",
            "format": "uuid",
            "title": "Assessment Id"
          },
          "as_of": {
            "type": "string",
            "format": "date-time",
            "title": "As Of"
          },
          "score": {
            "type": "integer",
            "title": "Score"
          },
          "low": {
            "type": "integer",
            "title": "Low"
          },
          "high": {
            "type": "integer",
            "title": "High"
          },
          "methodology_version": {
            "type": "string",
            "title": "Methodology Version"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "position",
          "assessment_id",
          "as_of",
          "score",
          "low",
          "high",
          "methodology_version"
        ],
        "title": "LedgerEntryOut",
        "description": "One position in an entity's ledger."
      },
      "Manifest": {
        "properties": {
          "semantic_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Semantic Hash"
          },
          "snapshot_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Snapshot Hash"
          },
          "profile_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Profile Hash"
          },
          "input_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Input Hash"
          },
          "evidence_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Evidence Hash"
          },
          "editorial_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Editorial Hash"
          },
          "method": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Method"
          },
          "editorial_version": {
            "type": "string",
            "const": "editorial-1.0.0",
            "title": "Editorial Version",
            "default": "editorial-1.0.0"
          },
          "renderer_version": {
            "type": "string",
            "const": "renderer-1.0.0",
            "title": "Renderer Version",
            "default": "renderer-1.0.0"
          },
          "narrative_method": {
            "type": "string",
            "enum": [
              "deterministic",
              "validated_proposal"
            ],
            "title": "Narrative Method",
            "default": "deterministic"
          },
          "model": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ],
            "title": "Model"
          },
          "prompt_hash": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt Hash"
          },
          "repair_attempts": {
            "type": "integer",
            "maximum": 1.0,
            "minimum": 0.0,
            "title": "Repair Attempts",
            "default": 0
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "semantic_hash",
          "snapshot_hash",
          "profile_hash",
          "input_hash",
          "evidence_hash",
          "editorial_hash",
          "method"
        ],
        "title": "Manifest",
        "description": "Versions and hashes needed to reproduce the accepted issued artifact."
      },
      "MaterialCreate": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "text",
              "document",
              "image",
              "audio",
              "video",
              "structured"
            ],
            "title": "Kind",
            "description": "Storage declaration, not a claim of reasoning support. Inquiries currently read only text; screenshot/image, PDF/document and OCR reasoning are unsupported. Mixed bindings containing unreadable material are refused, not silently treated as checked."
          },
          "mime_type": {
            "type": "string",
            "title": "Mime Type"
          },
          "size_bytes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Size Bytes"
          },
          "duration_ms": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Duration Ms"
          },
          "purpose": {
            "type": "string",
            "title": "Purpose"
          },
          "data_class_declared": {
            "type": "string",
            "enum": [
              "C0",
              "C1",
              "C2"
            ],
            "title": "Data Class Declared"
          },
          "retention_mode": {
            "type": "string",
            "enum": [
              "retain",
              "transient",
              "hold"
            ],
            "title": "Retention Mode",
            "description": "What we promise to do with the content. `transient` (the default): released as soon as the inquiry that reads it concludes, and after 30 minutes if none does. `retain`: kept 30 days. `hold`: a legal hold, with no expiry.",
            "default": "transient"
          },
          "consent_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Consent Ref",
            "description": "Required for audio and video recordings."
          },
          "languages_hint": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Languages Hint",
            "default": []
          },
          "case_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Case Id"
          },
          "inline_text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Inline Text",
            "description": "For kind=text only: the content itself, up to 50,000 characters."
          },
          "content_sha256": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Sha256",
            "description": "For anything but text: the sha256 of the bytes to follow, which is its material id."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "kind",
          "mime_type",
          "purpose",
          "data_class_declared"
        ],
        "title": "MaterialCreate",
        "description": "Declare a piece of unstructured content before its bytes arrive (D34, D35)."
      },
      "MaterialOut": {
        "properties": {
          "material_id": {
            "type": "string",
            "maxLength": 64,
            "minLength": 64,
            "title": "Material Id"
          },
          "status": {
            "type": "string",
            "enum": [
              "received",
              "extracting",
              "extracted",
              "failed",
              "purged",
              "awaiting_content"
            ],
            "title": "Status"
          },
          "upload_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Upload Url",
            "description": "Signed URL for the bytes; absent for inline text."
          },
          "upload_expires_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Upload Expires At"
          },
          "derived_from": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Derived From"
          },
          "derivation": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Derivation"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "material_id",
          "status"
        ],
        "title": "MaterialOut",
        "description": "The material resource: its hash id, status and where to put the bytes."
      },
      "MessageIntakeV1": {
        "properties": {
          "material_id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Material Id"
          },
          "channel": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "whatsapp",
                  "sms",
                  "email",
                  "call",
                  "social",
                  "other"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Channel"
          },
          "sender": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SenderInputV1"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "material_id"
        ],
        "title": "MessageIntakeV1",
        "description": "User-declared context for exactly one bound text material."
      },
      "MonitorCreate": {
        "properties": {
          "subject": {
            "$ref": "#/components/schemas/Subject"
          },
          "purpose": {
            "type": "string",
            "title": "Purpose"
          },
          "threshold_delta": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Threshold Delta",
            "description": "Score movement that triggers.",
            "default": 10
          },
          "interval_max_width": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100.0,
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Interval Max Width"
          },
          "case_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Case Id"
          },
          "webhook_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Webhook Id"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "subject",
          "purpose"
        ],
        "title": "MonitorCreate",
        "description": "A standing watch: tell me when belief about this subject moves."
      },
      "MonitorOut": {
        "properties": {
          "monitor_id": {
            "type": "string",
            "format": "uuid",
            "title": "Monitor Id"
          },
          "active": {
            "type": "boolean",
            "title": "Active"
          },
          "last_assessment": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Assessment"
              },
              {
                "type": "null"
              }
            ]
          },
          "events_url": {
            "type": "string",
            "title": "Events Url"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "monitor_id",
          "active",
          "last_assessment",
          "events_url"
        ],
        "title": "MonitorOut",
        "description": "The monitor resource."
      },
      "Node": {
        "properties": {
          "node_id": {
            "type": "string",
            "title": "Node Id",
            "description": "Stable within this response, so an edge, a finding and a refusal can cite it. Opaque on purpose: never derived from the value, so an unnamed node cannot be identified by guessing its value."
          },
          "type": {
            "type": "string",
            "title": "Type",
            "description": "The registered artifact type, e.g. DOMAIN, EMAIL."
          },
          "label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Label",
            "description": "What to call it, when it may be named. Null means the report says what kind of thing it is and not which one."
          },
          "hop": {
            "type": "integer",
            "title": "Hop",
            "description": "How far from the subject this was found. 0 is what was presented."
          },
          "origin": {
            "type": "string",
            "enum": [
              "presented",
              "discovered"
            ],
            "title": "Origin"
          },
          "group": {
            "type": "string",
            "enum": [
              "accounts",
              "contact",
              "web",
              "content",
              "other"
            ],
            "title": "Group",
            "description": "Which cluster a canvas draws it in: accounts (handles), contact (addresses, numbers), web (sites, hosts, links), content (pictures, messages, files). From the type alone, not the value.",
            "default": "other"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "node_id",
          "type",
          "hop",
          "origin"
        ],
        "title": "Node",
        "description": "One thing in the picture: what it is, what it is called, and how far out it sits.\n\n`label` is the part with a rule behind it. A value the caller presented is\nalways named, because it is theirs and they typed it. A value the check\n*discovered* is named only when the subject published it on their own\nassets \u2014 their DNS, their website \u2014 and is otherwise counted and described\nby type alone (D5). A free report that names a third party found at hop\ntwo because they once appeared near the subject is a report that can hurt\nsomebody who never asked to be in it."
      },
      "ObservationIn": {
        "properties": {
          "subject": {
            "$ref": "#/components/schemas/Subject"
          },
          "provenance_class": {
            "type": "string",
            "enum": [
              "tenant_supplied",
              "self_attested",
              "analyst_asserted"
            ],
            "title": "Provenance Class"
          },
          "summary": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Summary"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time",
            "title": "Observed At"
          },
          "observed_range_start": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Observed Range Start"
          },
          "observed_range_end": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Observed Range End"
          },
          "purpose": {
            "type": "string",
            "title": "Purpose"
          },
          "data_class": {
            "type": "string",
            "enum": [
              "C0",
              "C1",
              "C2"
            ],
            "title": "Data Class",
            "default": "C1"
          },
          "consent_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Consent Ref",
            "description": "Required for self_attested."
          },
          "case_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Case Id",
            "description": "Required for analyst_asserted."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "subject",
          "provenance_class",
          "summary",
          "observed_at",
          "purpose"
        ],
        "title": "ObservationIn",
        "description": "Testimony the caller supplies about a subject, entering with its provenance class."
      },
      "ObservationOut": {
        "properties": {
          "observation_id": {
            "type": "string",
            "format": "uuid",
            "title": "Observation Id"
          },
          "recorded_at": {
            "type": "string",
            "format": "date-time",
            "title": "Recorded At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "observation_id",
          "recorded_at"
        ],
        "title": "ObservationOut",
        "description": "Acknowledgement of accepted testimony."
      },
      "OutcomeIn": {
        "properties": {
          "assessment_id": {
            "type": "string",
            "format": "uuid",
            "title": "Assessment Id"
          },
          "decision_ref": {
            "type": "string",
            "title": "Decision Ref",
            "description": "The tenant's own id for the decision they took."
          },
          "kind": {
            "type": "string",
            "enum": [
              "repaid",
              "defaulted",
              "reversed",
              "settled",
              "confirmed",
              "exposed",
              "closed_finding",
              "other"
            ],
            "title": "Kind"
          },
          "observed_at": {
            "type": "string",
            "format": "date-time",
            "title": "Observed At"
          },
          "detail": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 500
              },
              {
                "type": "null"
              }
            ],
            "title": "Detail"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "assessment_id",
          "decision_ref",
          "kind",
          "observed_at"
        ],
        "title": "OutcomeIn",
        "description": "What actually happened after a decision. The most valuable thing a tenant sends (E14)."
      },
      "Paragraph": {
        "properties": {
          "text": {
            "type": "string",
            "minLength": 1,
            "title": "Text"
          },
          "cites": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "minItems": 1,
            "title": "Cites",
            "description": "Finding, connection or assessment ids this paragraph was written from."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "text",
          "cites"
        ],
        "title": "Paragraph",
        "description": "One paragraph, and the findings it was written from.\n\n`cites` is not decoration and not a footnote a reader is expected to\nfollow. It is the mechanism: a paragraph that cannot name the evidence it\ncame from is deleted before the report leaves this service. A renderer\ncannot produce an uncited sentence and have it survive."
      },
      "PolicyBand": {
        "properties": {
          "label": {
            "type": "string",
            "title": "Label"
          },
          "min_score": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Min Score"
          },
          "max_score": {
            "type": "integer",
            "maximum": 100.0,
            "minimum": 0.0,
            "title": "Max Score"
          },
          "max_interval_width": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100.0,
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Interval Width"
          },
          "purposes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Purposes",
            "description": "The purposes this band labels. Empty means every purpose, except that the fraud vocabulary (SAFE, SUSPICIOUS, LIKELY_SCAM, SCAM) only ever labels a fraud check: a footprint is not a scam.",
            "default": []
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "label",
          "min_score",
          "max_score"
        ],
        "title": "PolicyBand",
        "description": "One label band over score and interval."
      },
      "PolicyIn": {
        "properties": {
          "bands": {
            "items": {
              "$ref": "#/components/schemas/PolicyBand"
            },
            "type": "array",
            "title": "Bands",
            "description": "Empty means the loaded packs' default bands (SAFE to SCAM under pack-in).",
            "default": []
          },
          "allowed_purposes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "minItems": 1,
            "title": "Allowed Purposes"
          },
          "tier_ceiling": {
            "type": "string",
            "enum": [
              "T0",
              "T1",
              "T2",
              "T3"
            ],
            "title": "Tier Ceiling"
          },
          "monthly_budget_amount": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Monthly Budget Amount"
          },
          "budget_currency": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 3,
                "minLength": 3
              },
              {
                "type": "null"
              }
            ],
            "title": "Budget Currency"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "allowed_purposes",
          "tier_ceiling"
        ],
        "title": "PolicyIn",
        "description": "A new policy version: bands, allowed purposes, tier ceiling, budget.\n\nOwns the label and only the label (D05)."
      },
      "PolicyOut": {
        "properties": {
          "policy_id": {
            "type": "string",
            "format": "uuid",
            "title": "Policy Id"
          },
          "version": {
            "type": "integer",
            "title": "Version"
          },
          "bands": {
            "items": {
              "$ref": "#/components/schemas/PolicyBand"
            },
            "type": "array",
            "title": "Bands"
          },
          "allowed_purposes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Allowed Purposes"
          },
          "tier_ceiling": {
            "type": "string",
            "title": "Tier Ceiling"
          },
          "valid_from": {
            "type": "string",
            "format": "date-time",
            "title": "Valid From"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "policy_id",
          "version",
          "bands",
          "allowed_purposes",
          "tier_ceiling",
          "valid_from"
        ],
        "title": "PolicyOut",
        "description": "A policy version as stored."
      },
      "Presentation": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type",
            "description": "A registered artifact type id (see GET /v1/registry/artifact-types)."
          },
          "value": {
            "type": "string",
            "minLength": 1,
            "title": "Value",
            "description": "The presented value; normalised by the kernel."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "type",
          "value"
        ],
        "title": "Presentation",
        "description": "One presented identifier: a registered artifact type and its value."
      },
      "RegistryEntryOut": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "pack_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pack Id"
          },
          "core": {
            "type": "boolean",
            "title": "Core"
          },
          "family": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Family",
            "description": "For an artifact type: what sort of thing it is."
          },
          "examples": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Examples",
            "description": "For an artifact type: values that are valid.",
            "default": []
          },
          "platforms": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Platforms",
            "description": "For `SOCIAL_HANDLE`: the platforms a handle may be presented on (`platform:handle`, D72), and `_` for one presented without a platform."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "id",
          "description",
          "pack_id",
          "core"
        ],
        "title": "RegistryEntryOut",
        "description": "A registered vocabulary item the tenant may use: an artifact type, intent or purpose."
      },
      "Rejected": {
        "properties": {
          "reason": {
            "type": "string",
            "title": "Reason"
          },
          "rule": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rule",
            "description": "The invariant or policy that refused it, e.g. I13, policy.purpose."
          },
          "detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Detail"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "reason"
        ],
        "title": "Rejected",
        "description": "Why a command was refused. Always a rule, never a stack trace."
      },
      "Report": {
        "properties": {
          "inquiry_id": {
            "type": "string",
            "format": "uuid",
            "title": "Inquiry Id"
          },
          "assessment_id": {
            "type": "string",
            "format": "uuid",
            "title": "Assessment Id"
          },
          "lang": {
            "type": "string",
            "title": "Lang",
            "default": "en"
          },
          "rendered_by": {
            "type": "string",
            "enum": [
              "template",
              "model"
            ],
            "title": "Rendered By",
            "description": "Which renderer produced this. A consumer should not otherwise be able to tell."
          },
          "prompt_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt Version",
            "description": "The prompt that wrote it, when a model did. Null for a template."
          },
          "depth": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReportDepth"
              },
              {
                "type": "null"
              }
            ],
            "description": "How deep the report went and what a deeper one adds. Set on the individual report."
          },
          "sections": {
            "items": {
              "$ref": "#/components/schemas/ReportSection"
            },
            "type": "array",
            "title": "Sections"
          },
          "template_sections": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Template Sections",
            "description": "Sections the template wrote because the model's did not survive its checks (a paragraph citing something it was never given, a section that did not validate, or one it left out). Empty for a report the model wrote whole and for a template report.",
            "default": []
          },
          "share": {
            "$ref": "#/components/schemas/ShareCardOut"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Generated At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "inquiry_id",
          "assessment_id",
          "rendered_by",
          "sections",
          "share",
          "generated_at"
        ],
        "title": "Report",
        "description": "One inquiry, written for the person who asked.\n\nIt draws no conclusion the assessment did not already draw, and states no\nfact the findings did not already carry. What it adds is what each fact\nmeans for the reader, which is the one thing evidence never contains."
      },
      "ReportConnection": {
        "properties": {
          "connection_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Connection Id"
          },
          "from_subject": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "From Subject"
          },
          "to_subject": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "To Subject"
          },
          "relationship": {
            "type": "string",
            "enum": [
              "publication",
              "possible_same_subject",
              "identity",
              "control",
              "ownership",
              "affiliation",
              "employment",
              "hosted_on",
              "payment",
              "location",
              "event_participant"
            ],
            "title": "Relationship"
          },
          "status": {
            "type": "string",
            "enum": [
              "candidate",
              "accepted",
              "refuted"
            ],
            "title": "Status"
          },
          "grounds": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 32,
            "minItems": 1,
            "title": "Grounds"
          },
          "rule": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Rule"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "connection_id",
          "from_subject",
          "to_subject",
          "relationship",
          "status",
          "grounds",
          "rule"
        ],
        "title": "ReportConnection",
        "description": "An explicitly qualified relation; adjacency never becomes ownership."
      },
      "ReportDepth": {
        "properties": {
          "headline": {
            "type": "string",
            "title": "Headline",
            "description": "The line a renderer sets in bold at the top: how deep a free check goes, whom to ask.",
            "default": ""
          },
          "ai": {
            "type": "string",
            "title": "Ai",
            "description": "How the report used AI, in one sentence a reader can hold it to.",
            "default": ""
          },
          "level": {
            "type": "integer",
            "minimum": 1.0,
            "title": "Level",
            "description": "The depth this report reached, on the `of` scale."
          },
          "of": {
            "type": "integer",
            "minimum": 1.0,
            "title": "Of",
            "description": "The deepest level an investigation reaches."
          },
          "label": {
            "type": "string",
            "title": "Label",
            "description": "The level in words, e.g. `Depth level 2 of 5: automated sweep`."
          },
          "covered": {
            "type": "string",
            "title": "Covered",
            "description": "What this depth ran, in one sentence of counts."
          },
          "deeper": {
            "type": "string",
            "title": "Deeper",
            "description": "What the levels above add, and how to reach them."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "level",
          "of",
          "label",
          "covered",
          "deeper"
        ],
        "title": "ReportDepth",
        "description": "How deep this report went, said before anything it found (2026-09-22).\n\nThe free report is a sweep. A reader who takes it for an investigation over-reads every row, so the depth\nis stated first and plainly, with what a deeper one adds and whom to ask for it."
      },
      "ReportInput": {
        "properties": {
          "schema_version": {
            "type": "string",
            "const": "1.0.0",
            "title": "Schema Version",
            "default": "1.0.0"
          },
          "profile": {
            "type": "string",
            "enum": [
              "discover_individual",
              "discover_company",
              "discover_fraud",
              "trust_onboarding"
            ],
            "title": "Profile"
          },
          "scenario": {
            "type": "string",
            "enum": [
              "public",
              "seller",
              "dating_matrimony"
            ],
            "title": "Scenario"
          },
          "profile_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Profile Hash"
          },
          "input_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Input Hash"
          },
          "evidence_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Evidence Hash"
          },
          "snapshot_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Snapshot Hash"
          },
          "method": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Method"
          },
          "as_of": {
            "type": "string",
            "format": "date-time",
            "title": "As Of"
          },
          "subjects": {
            "items": {
              "$ref": "#/components/schemas/ReportSubject"
            },
            "type": "array",
            "maxItems": 128,
            "minItems": 1,
            "title": "Subjects"
          },
          "facts": {
            "items": {
              "$ref": "#/components/schemas/Fact"
            },
            "type": "array",
            "maxItems": 2000,
            "title": "Facts",
            "default": []
          },
          "answers": {
            "items": {
              "$ref": "#/components/schemas/Answer"
            },
            "type": "array",
            "maxItems": 480,
            "minItems": 1,
            "title": "Answers"
          },
          "connections": {
            "items": {
              "$ref": "#/components/schemas/ReportConnection"
            },
            "type": "array",
            "maxItems": 500,
            "title": "Connections",
            "default": []
          },
          "checks": {
            "items": {
              "$ref": "#/components/schemas/Check"
            },
            "type": "array",
            "maxItems": 1024,
            "title": "Checks",
            "default": []
          },
          "leads": {
            "items": {
              "$ref": "#/components/schemas/ReportLead"
            },
            "type": "array",
            "maxItems": 128,
            "title": "Leads",
            "default": []
          },
          "stop_reason": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Stop Reason"
          },
          "retention": {
            "type": "string",
            "const": "case_policy_required",
            "title": "Retention",
            "default": "case_policy_required"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "profile",
          "scenario",
          "profile_hash",
          "input_hash",
          "evidence_hash",
          "snapshot_hash",
          "method",
          "as_of",
          "subjects",
          "answers",
          "stop_reason"
        ],
        "title": "ReportInput",
        "description": "Frozen accepted meaning; report writing cannot acquire additional evidence."
      },
      "ReportLead": {
        "properties": {
          "question_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Question Id"
          },
          "candidate_subject": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Candidate Subject"
          },
          "grounds": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 32,
            "minItems": 1,
            "title": "Grounds"
          },
          "explanation": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Explanation"
          },
          "alternative": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Alternative"
          },
          "missing": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Missing"
          },
          "status": {
            "type": "string",
            "enum": [
              "proposed",
              "unresolved",
              "refuted"
            ],
            "title": "Status"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "question_id",
          "candidate_subject",
          "grounds",
          "explanation",
          "alternative",
          "missing",
          "status"
        ],
        "title": "ReportLead",
        "description": "A conditional research branch with its missing premise and alternative."
      },
      "ReportSection": {
        "properties": {
          "key": {
            "type": "string",
            "enum": [
              "summary",
              "given",
              "associations",
              "searches",
              "registration",
              "jobs",
              "people",
              "domain",
              "accounts",
              "profiles",
              "name",
              "breaches",
              "mentions",
              "darkweb",
              "phone",
              "email",
              "other",
              "lead",
              "found",
              "contradictions",
              "story",
              "timeline",
              "todo",
              "agreement",
              "could_do",
              "close_first",
              "trail",
              "connected",
              "declined",
              "unseen",
              "certainty"
            ],
            "title": "Key"
          },
          "heading": {
            "type": "string",
            "title": "Heading"
          },
          "paragraphs": {
            "items": {
              "$ref": "#/components/schemas/Paragraph"
            },
            "type": "array",
            "title": "Paragraphs",
            "default": []
          },
          "table": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReportTable"
              },
              {
                "type": "null"
              }
            ],
            "description": "What the section found as rows, when it is a list. Paragraphs may be empty then."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "key",
          "heading"
        ],
        "title": "ReportSection",
        "description": "One part of the report, in the fixed order every report uses."
      },
      "ReportSubject": {
        "properties": {
          "subject_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Subject Id"
          },
          "label": {
            "type": "string",
            "maxLength": 2300,
            "minLength": 1,
            "title": "Label"
          },
          "namespace": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Namespace"
          },
          "candidate": {
            "type": "boolean",
            "title": "Candidate",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "subject_id",
          "label",
          "namespace"
        ],
        "title": "ReportSubject",
        "description": "An exact account/identifier; a subject label is not identity acceptance."
      },
      "ReportTable": {
        "properties": {
          "columns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "minItems": 1,
            "title": "Columns"
          },
          "rows": {
            "items": {
              "$ref": "#/components/schemas/TableRow"
            },
            "type": "array",
            "minItems": 1,
            "title": "Rows"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "columns",
          "rows"
        ],
        "title": "ReportTable",
        "description": "What a section found, as rows a reader can scan and a renderer can draw without reading prose."
      },
      "SenderInputV1": {
        "properties": {
          "value": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "title": "Value"
          },
          "kind": {
            "type": "string",
            "enum": [
              "auto",
              "email",
              "phone",
              "upi",
              "url",
              "other"
            ],
            "title": "Kind",
            "default": "auto"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "value"
        ],
        "title": "SenderInputV1",
        "description": "Untrusted sender syntax, consumed transiently before provider dispatch."
      },
      "Sentence": {
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 3000,
            "minLength": 1,
            "title": "Text"
          },
          "fact_ids": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 64,
            "title": "Fact Ids",
            "default": []
          },
          "answer_ids": {
            "items": {
              "type": "string",
              "maxLength": 128,
              "minLength": 1
            },
            "type": "array",
            "maxItems": 64,
            "title": "Answer Ids",
            "default": []
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "text"
        ],
        "title": "Sentence",
        "description": "A sentence with explicit grounds; citation existence alone is insufficient."
      },
      "SessionOpen": {
        "properties": {
          "purpose": {
            "type": "string",
            "title": "Purpose"
          },
          "intent": {
            "type": "string",
            "title": "Intent"
          },
          "stake": {
            "$ref": "#/components/schemas/Stake"
          },
          "modalities": {
            "items": {
              "type": "string",
              "enum": [
                "text",
                "audio",
                "video"
              ]
            },
            "type": "array",
            "minItems": 1,
            "title": "Modalities"
          },
          "retention_mode": {
            "type": "string",
            "enum": [
              "retain",
              "transient",
              "hold"
            ],
            "title": "Retention Mode",
            "default": "transient"
          },
          "consent_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Consent Ref"
          },
          "languages_hint": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Languages Hint",
            "default": []
          },
          "case_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Case Id"
          },
          "escalate_at_score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100.0,
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Escalate At Score"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "purpose",
          "intent",
          "stake",
          "modalities"
        ],
        "title": "SessionOpen",
        "description": "An inquiry whose material is still arriving: a live call, chat or video (D38)."
      },
      "SessionOut": {
        "properties": {
          "session_id": {
            "type": "string",
            "format": "uuid",
            "title": "Session Id"
          },
          "stream_url": {
            "type": "string",
            "title": "Stream Url",
            "description": "WebSocket URL for frames in and events out."
          },
          "protocol_version": {
            "type": "string",
            "title": "Protocol Version"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "session_id",
          "stream_url",
          "protocol_version",
          "expires_at"
        ],
        "title": "SessionOut",
        "description": "Where to stream frames and what the session will emit."
      },
      "ShareCardOut": {
        "properties": {
          "findings": {
            "type": "integer",
            "title": "Findings"
          },
          "connections": {
            "type": "integer",
            "title": "Connections"
          },
          "absences": {
            "type": "integer",
            "title": "Absences"
          },
          "checks_not_run_at_this_tier": {
            "type": "integer",
            "title": "Checks Not Run At This Tier"
          },
          "kicker": {
            "type": "string",
            "title": "Kicker"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "findings",
          "connections",
          "absences",
          "checks_not_run_at_this_tier",
          "kicker"
        ],
        "title": "ShareCardOut",
        "description": "The shareable summary: counts, and a sentence about the counts.\n\nCarries no value the subject gave us, by construction, so passing it on\ndiscloses nothing about them."
      },
      "Stake": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "payment",
              "credit",
              "account",
              "listing",
              "hire",
              "belief",
              "other"
            ],
            "title": "Kind"
          },
          "amount": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Amount"
          },
          "currency": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 3,
                "minLength": 3
              },
              {
                "type": "null"
              }
            ],
            "title": "Currency"
          },
          "reversible": {
            "type": "boolean",
            "title": "Reversible",
            "description": "Can the truster undo the act after the fact?",
            "default": false
          },
          "deadline_ms": {
            "anyOf": [
              {
                "type": "integer",
                "exclusiveMinimum": 0.0
              },
              {
                "type": "null"
              }
            ],
            "title": "Deadline Ms",
            "description": "Time the caller can wait for a first answer."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "kind"
        ],
        "title": "Stake",
        "description": "What is at risk and how much time there is; fixes the tolerable interval and the budget."
      },
      "Subject": {
        "properties": {
          "presentations": {
            "items": {
              "$ref": "#/components/schemas/Presentation"
            },
            "type": "array",
            "title": "Presentations",
            "default": []
          },
          "entity_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Entity Id",
            "description": "A subject we have resolved before."
          },
          "claim": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Claim"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Subject",
        "description": "What the inquiry is about: presentations, an entity we already know, or a claim."
      },
      "TableRow": {
        "properties": {
          "cells": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "minItems": 1,
            "title": "Cells"
          },
          "cites": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "minItems": 1,
            "title": "Cites",
            "description": "Finding, connection or assessment ids this row was read from, as a paragraph cites."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "cells",
          "cites"
        ],
        "title": "TableRow",
        "description": "One row of a report table, and the evidence it was read from."
      },
      "TrialCreate": {
        "properties": {
          "email": {
            "type": "string",
            "maxLength": 254,
            "minLength": 3,
            "title": "Email",
            "description": "The work address the trial belongs to."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "email"
        ],
        "title": "TrialCreate",
        "description": "Provision an X-Ray trial for one address.\n\nOne field, and deliberately only one. Every policy value a trial carries \u2014\nits tier, its budget, its limits, its purposes, how long it lasts \u2014 is a\nserver-side constant, so a caller holding the provisioning key cannot mint\nitself a tenant with a higher ceiling than a trial is meant to have."
      },
      "TrialOut": {
        "properties": {
          "tenant_id": {
            "type": "string",
            "format": "uuid",
            "title": "Tenant Id"
          },
          "key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Key",
            "description": "The tenant key. Shown once, stored hashed (I11)."
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          },
          "tier_ceiling": {
            "type": "string",
            "title": "Tier Ceiling"
          },
          "inquiries_per_day": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Inquiries Per Day",
            "description": "Null when nothing is enforced."
          },
          "rate_per_minute": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rate Per Minute"
          },
          "budget_units": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Budget Units"
          },
          "allowed_artifact_types": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Allowed Artifact Types",
            "description": "Null means every registered type."
          },
          "allowed_purposes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Allowed Purposes"
          },
          "unlimited": {
            "type": "boolean",
            "title": "Unlimited",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "tenant_id",
          "expires_at",
          "tier_ceiling",
          "allowed_purposes"
        ],
        "title": "TrialOut",
        "description": "A provisioned trial. ``key`` is present only in this response, and only once."
      },
      "TrialUsageOut": {
        "properties": {
          "tenant_id": {
            "type": "string",
            "format": "uuid",
            "title": "Tenant Id"
          },
          "inquiries_today": {
            "type": "integer",
            "title": "Inquiries Today"
          },
          "inquiries_per_day": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Inquiries Per Day"
          },
          "inquiries_left": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Inquiries Left"
          },
          "cost_spent": {
            "type": "number",
            "title": "Cost Spent"
          },
          "cost_budget": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cost Budget"
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "days_left": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Days Left"
          },
          "free_tier_only": {
            "type": "boolean",
            "title": "Free Tier Only"
          },
          "unlimited": {
            "type": "boolean",
            "title": "Unlimited",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "tenant_id",
          "inquiries_today",
          "inquiries_per_day",
          "inquiries_left",
          "cost_spent",
          "cost_budget",
          "expires_at",
          "days_left",
          "free_tier_only"
        ],
        "title": "TrialUsageOut",
        "description": "What a trial has left, as its own page should show it."
      },
      "TrustResponse": {
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "preview",
              "live"
            ],
            "title": "Mode"
          },
          "research_performed": {
            "type": "boolean",
            "title": "Research Performed"
          },
          "notice": {
            "type": "string",
            "title": "Notice"
          },
          "report": {
            "$ref": "#/components/schemas/CanonicalReport"
          },
          "html": {
            "type": "string",
            "title": "Html"
          },
          "snapshot_hash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "title": "Snapshot Hash"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "mode",
          "research_performed",
          "notice",
          "report",
          "html",
          "snapshot_hash"
        ],
        "title": "TrustResponse",
        "description": "One canonical response and its rendering of the same report meaning."
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      },
      "WebhookIn": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "event_types": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "minItems": 1,
            "title": "Event Types"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "url",
          "event_types"
        ],
        "title": "WebhookIn",
        "description": "Where to deliver events durably; signed, retried, idempotent."
      },
      "WebhookOut": {
        "properties": {
          "webhook_id": {
            "type": "string",
            "format": "uuid",
            "title": "Webhook Id"
          },
          "url": {
            "type": "string",
            "title": "Url"
          },
          "event_types": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Event Types"
          },
          "signing_secret": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Signing Secret"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "webhook_id",
          "url",
          "event_types",
          "signing_secret"
        ],
        "title": "WebhookOut",
        "description": "A registered webhook and its signing secret (shown once)."
      }
    }
  }
}
