removedInput schema / properties / record_handle
Removed value: -{
- "description": "Tenant/tool-bound deferred record handle.",
- "type": "string"
-}
removedInput schema / properties / record_limit
Removed value: -{
- "default": 25,
- "description": "Maximum object entries or array items, clamped to 25; text fragments use the response byte budget.",
- "minimum": 1,
- "multipleOf": 1,
- "type": "number"
-}
removedInput schema / properties / record_offset
Removed value: -{
- "default": 0,
- "description": "Key, item or Unicode-code-point offset.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
-}
removedInput schema / properties / record_path
Removed value: -{
- "default": "",
- "description": "JSON Pointer to a stored value; empty selects the root.",
- "type": "string"
-}
changedInput schema / properties / topic / enum
Previous value: -[
- "issue_codes",
- "filing_types",
- "government_entities",
- "contribution_types",
- "countries",
- "identifiers",
- "methodology",
- "fara_rules"
-]New value: +[
+ "issue_codes",
+ "filing_types",
+ "government_entities",
+ "contribution_types",
+ "countries",
+ "states",
+ "identifiers",
+ "methodology",
+ "fara_rules"
+]
removedOutput schema / $defs
Removed value: -{
- "__schema0": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "type": "number"
- },
- {
- "type": "boolean"
- },
- {
- "type": "null"
- },
- {
- "items": {
- "$ref": "#/$defs/__schema0"
- },
- "type": "array"
- },
- {
- "additionalProperties": {
- "$ref": "#/$defs/__schema0"
- },
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- }
- ]
- }
-}
changedOutput schema / anyOf
Previous value: -[
- {
- "not": {
- "required": [
- "error"
- ]
- },
- "required": [
- "topic",
- "total_entries",
- "matched_entries",
- "retrieved_at",
- "source_urls",
- "notices",
- "truncated"
- ]
- },
- {
- "required": [
- "error"
- ]
- }
-]New value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "topic",
+ "entries",
+ "total_entries",
+ "matched_entries",
+ "retrieved_at",
+ "source_urls",
+ "notices",
+ "output_complete",
+ "truncated",
+ "offset",
+ "records_returned",
+ "cursor_expires_at"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]
changedOutput schema / properties / cursor_expires_at / description
Previous value: -"Absolute expiry of retained entries and continuations."New value: +"Absolute expiry of the pinned vocabulary and its continuations."
removedOutput schema / properties / delivery_limits
Removed value: -{
- "additionalProperties": {
- "additionalProperties": false,
- "description": "Requested and effective delivery control.",
- "properties": {
- "effective": {
- "description": "Applied delivery ceiling.",
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "requested": {
- "description": "Caller-requested positive integer.",
- "exclusiveMinimum": 0,
- "multipleOf": 1,
- "type": "number"
- }
- },
- "required": [
- "requested",
- "effective"
- ],
- "type": "object"
- },
- "description": "Clamped controls for this call; an empty map means no clamp. Immediate cursor replay retains its original values.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
-}
changedOutput schema / properties / entries / description
Previous value: -"Complete entries delivered in this pinned vocabulary window."New value: +"Whole entries delivered in this fixed 125-entry window."
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_filter`: Topic is missing, continuation scope changes, or record selectors conflict or select an invalid path. `cursor_invalid`: A cursor or record handle is unavailable, expired or belongs to another tenant or tool. `acquisition_storage_unavailable`: Storage cannot retain the complete vocabulary or its checkpoint safely. `result_too_large`: Complete metadata leaves no space for a result window. `source_schema_changed`: Source vocabulary violates its verified schema. `snapshot_unavailable`: Required FARA country snapshot is unavailable. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_filter`: The first call omits topic. `cursor_invalid`: A cursor is unavailable or expired, belongs to another tenant or tool, or arrives with a changed topic or filter. `acquisition_storage_unavailable`: Storage cannot retain the complete vocabulary or its checkpoint safely. `source_schema_changed`: Source vocabulary violates its verified schema. `snapshot_unavailable`: Required FARA country snapshot is unavailable. Other values are possible when a failure originates below the handler."
changedOutput schema / properties / error / properties / data / properties / reason / examples
Previous value: -[
- "invalid_filter",
- "cursor_invalid",
- "acquisition_storage_unavailable",
- "result_too_large",
- "source_schema_changed",
- "snapshot_unavailable"
-]New value: +[
+ "invalid_filter",
+ "cursor_invalid",
+ "acquisition_storage_unavailable",
+ "source_schema_changed",
+ "snapshot_unavailable"
+]
changedOutput schema / properties / offset / description
Previous value: -"Start position in the pinned filtered vocabulary."New value: +"Entries delivered before this window."
changedOutput schema / properties / output_complete / description
Previous value: -"Every matched entry has been delivered or deferred."New value: +"Whether every matched entry has been delivered."
removedOutput schema / properties / record_handles
Removed value: -{
- "description": "Oversized entries retrievable through this same tool.",
- "items": {
- "additionalProperties": false,
- "description": "Deferred parent retrieval.",
- "properties": {
- "expires_at": {
- "description": "Retained parent expiry ISO timestamp.",
- "type": "string"
- },
- "record_bytes": {
- "description": "Serialized parent UTF-8 bytes.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "record_handle": {
- "description": "Opaque retained parent handle.",
- "type": "string"
- },
- "retrieval_tool": {
- "description": "Source tool for record windows.",
- "type": "string"
- },
- "source_id": {
- "description": "Original source identity.",
- "type": "string"
- }
- },
- "required": [
- "record_handle",
- "source_id",
- "record_bytes",
- "expires_at",
- "retrieval_tool"
- ],
- "type": "object"
- },
- "type": "array"
-}
removedOutput schema / properties / record_window
Removed value: -{
- "description": "Exact recursive window of a deferred vocabulary entry.",
- "oneOf": [
- {
- "additionalProperties": false,
- "description": "Complete or deferred object children.",
- "properties": {
- "complete": {
- "description": "This path and included children are fully delivered.",
- "type": "boolean"
- },
- "entries": {
- "description": "Key-ordered object window.",
- "items": {
- "additionalProperties": false,
- "description": "Key and pointer; value only when it fits.",
- "properties": {
- "key": {
- "description": "Original key.",
- "type": "string"
- },
- "path": {
- "description": "Child JSON Pointer.",
- "type": "string"
- },
- "value": {
- "$ref": "#/$defs/__schema0",
- "description": "Whole child value only when it fits."
- }
- },
- "required": [
- "key",
- "path"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "kind": {
- "const": "object",
- "description": "Object-entry window.",
- "type": "string"
- },
- "next_offset": {
- "description": "Next undelivered position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "offset": {
- "description": "Start position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Selected JSON Pointer.",
- "type": "string"
- },
- "record_handle": {
- "description": "Stored parent handle.",
- "type": "string"
- },
- "returned": {
- "description": "Delivered entries or code points.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "total": {
- "description": "Total keys, items or code points at this path.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "record_handle",
- "path",
- "total",
- "offset",
- "returned",
- "complete",
- "kind",
- "entries"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "description": "Array items preserving original indexes.",
- "properties": {
- "complete": {
- "description": "This path and included children are fully delivered.",
- "type": "boolean"
- },
- "items": {
- "description": "Indexed array window.",
- "items": {
- "additionalProperties": false,
- "description": "Original index and child pointer.",
- "properties": {
- "index": {
- "description": "Original child index.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Child JSON Pointer.",
- "type": "string"
- },
- "value": {
- "$ref": "#/$defs/__schema0",
- "description": "Whole child value only when it fits."
- }
- },
- "required": [
- "index",
- "path"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "kind": {
- "const": "array",
- "description": "Array-item window.",
- "type": "string"
- },
- "next_offset": {
- "description": "Next undelivered position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "offset": {
- "description": "Start position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Selected JSON Pointer.",
- "type": "string"
- },
- "record_handle": {
- "description": "Stored parent handle.",
- "type": "string"
- },
- "returned": {
- "description": "Delivered entries or code points.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "total": {
- "description": "Total keys, items or code points at this path.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "record_handle",
- "path",
- "total",
- "offset",
- "returned",
- "complete",
- "kind",
- "items"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "description": "Unicode-code-point text fragment.",
- "properties": {
- "complete": {
- "description": "This path and included children are fully delivered.",
- "type": "boolean"
- },
- "kind": {
- "const": "string",
- "description": "Unicode text window.",
- "type": "string"
- },
- "next_offset": {
- "description": "Next undelivered position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "offset": {
- "description": "Start position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Selected JSON Pointer.",
- "type": "string"
- },
- "record_handle": {
- "description": "Stored parent handle.",
- "type": "string"
- },
- "returned": {
- "description": "Delivered entries or code points.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "text": {
- "description": "Complete-code-point text fragment.",
- "type": "string"
- },
- "total": {
- "description": "Total keys, items or code points at this path.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "record_handle",
- "path",
- "total",
- "offset",
- "returned",
- "complete",
- "kind",
- "text"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "description": "Unfragmented non-text scalar.",
- "properties": {
- "complete": {
- "description": "This path and included children are fully delivered.",
- "type": "boolean"
- },
- "kind": {
- "const": "scalar",
- "description": "Complete scalar value.",
- "type": "string"
- },
- "next_offset": {
- "description": "Next undelivered position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "offset": {
- "description": "Start position.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Selected JSON Pointer.",
- "type": "string"
- },
- "record_handle": {
- "description": "Stored parent handle.",
- "type": "string"
- },
- "returned": {
- "description": "Delivered entries or code points.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "total": {
- "description": "Total keys, items or code points at this path.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "value": {
- "anyOf": [
- {
- "description": "Null value.",
- "type": "null"
- },
- {
- "description": "Boolean value.",
- "type": "boolean"
- },
- {
- "description": "Finite numeric value.",
- "type": "number"
- }
- ],
- "description": "Exact scalar value."
- }
- },
- "required": [
- "record_handle",
- "path",
- "total",
- "offset",
- "returned",
- "complete",
- "kind",
- "value"
- ],
- "type": "object"
- }
- ]
-}
removedOutput schema / properties / records_deferred
Removed value: -{
- "description": "Oversized entries retained behind handles.",
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
-}
changedOutput schema / properties / records_returned / description
Previous value: -"Complete entries delivered in this window."New value: +"Whole entries delivered in this window."
removedOutput schema / properties / retrieval_tool
Removed value: -{
- "const": "uslobbying_list_reference",
- "description": "Tool used to retrieve deferred vocabulary entries.",
- "type": "string"
-}
changedOutput schema / properties / retrieved_at / description
Previous value: -"Vocabulary retrieval timestamp."New value: +"Retrieval timestamp: the shared LDA constants fetch for LDA topics (the older of the LDA and FARA retrievals for countries), the call time for explanatory topics."
changedOutput schema / properties / topic / enum
Previous value: -[
- "issue_codes",
- "filing_types",
- "government_entities",
- "contribution_types",
- "countries",
- "identifiers",
- "methodology",
- "fara_rules"
-]New value: +[
+ "issue_codes",
+ "filing_types",
+ "government_entities",
+ "contribution_types",
+ "countries",
+ "states",
+ "identifiers",
+ "methodology",
+ "fara_rules"
+]
changedOutput schema / properties / truncated / description
Previous value: -"More entries or deferred record values remain retrievable."New value: +"More matched entries remain; follow next_cursor."