Previous value: -"Characters to return, up to 16,000."New value: +"Characters to return, from 1 to 16,000. Smaller chunks may be needed to fit the response byte budget."

Added value: +16000

Previous value: -0New value: +1

Added value: +{
+  "type": "boolean"
+}

Added value: +{
+  "description": "Early-warning boundary, separate from the stale-source boundary.",
+  "format": "int64",
+  "type": "integer"
+}

Previous value: -[
-  "state",
-  "evaluated_at",
-  "max_age_seconds"
-]New value: +[
+  "state",
+  "evaluated_at",
+  "max_age_seconds",
+  "warn_age_seconds",
+  "attention_required"
+]

Added value: +{
+  "properties": {
+    "freshness": {
+      "$ref": "#/$defs/SourceFreshness",
+      "description": "Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."
+    },
+    "observed_at": {
+      "description": "Observation time does not replace the official source timestamp.",
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "scope": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "sha256": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "source_date": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "source_url": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "status": {
+      "description": "Present as unavailable when no SAM coverage exists in this generation.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "freshness"
+  ],
+  "type": "object"
+}

Added value: +{
+  "enum": [
+    "fresh",
+    "stale",
+    "unknown",
+    "unavailable"
+  ],
+  "type": "string"
+}

Added value: +{
+  "properties": {
+    "evaluated_at": {
+      "description": "UTC time when age was evaluated; source and observation dates are unchanged.",
+      "type": "string"
+    },
+    "max_age_seconds": {
+      "description": "Explicit warning threshold for this daily snapshot. Not a scheduler promise.",
+      "format": "int64",
+      "type": "integer"
+    },
+    "source_age_seconds": {
+      "description": "Age of the official source timestamp, never the import or enrichment timestamp.",
+      "format": "int64",
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "state": {
+      "$ref": "#/$defs/FreshnessState"
+    },
+    "warning": {
+      "description": "User-facing warning, or null when within the warning threshold.",
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "state",
+    "evaluated_at",
+    "max_age_seconds"
+  ],
+  "type": "object"
+}

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ExclusionCoverage"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Present for exclusion text chunks, with the same source-age policy as detail."
+}

Added value: +"Public record collection returned by search."

Added value: +"Retained snapshot UUID; omit for the current snapshot."

Added value: +"Stable ID of a known public record."

Added value: +"Characters to return, up to 16,000."

Added value: +"Character offset for the next bounded text chunk."

Previous value: -nullNew value: +{
+  "$defs": {
+    "JsonObject": {
+      "description": "Source-specific JSON map. The envelope is stable; map keys vary by official source.",
+      "type": "object"
+    }
+  },
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "properties": {
+    "document_kind": {
+      "type": "string"
+    },
+    "generation": {
+      "type": "string"
+    },
+    "id": {
+      "type": "string"
+    },
+    "next_offset": {
+      "format": "uint",
+      "minimum": 0,
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "offset": {
+      "format": "uint64",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "provenance": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/JsonObject"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Source metadata attached to the retained record."
+    },
+    "text": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "generation",
+    "id",
+    "text",
+    "offset",
+    "document_kind"
+  ],
+  "type": "object"
+}