Previous value: -"Result rows. Per-tool item shape is rendered in the markdown body."New value: +"Result rows for `list` and the sub-resource operations."

Previous value: -"Upstream JSON record. Per-tool item shape is rendered in the markdown body."New value: +"Upstream JSON record: a nomination (`list`), an action (`actions`), a committee, a hearing, or a nominee. A `list` row's `latestAction` and an `actions` row carry `rollVote` when they cite their own Senate record vote."

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "rollVote": {
+          "additionalProperties": false,
+          "description": "Arguments for congressgov_roll_votes that retrieve the Senate roll call vote this action cites as its own. Absent when the action cites no vote of its own (a back-reference such as \"(Record Vote No. 318)\" names another action's vote), and for votes before the feed starts — the Senate publishes roll call votes from the 101st Congress (1989) onward.",
+          "properties": {
+            "chamber": {
+              "const": "senate",
+              "description": "Always 'senate'. Pass it: congressgov_roll_votes defaults to 'house', whose vote with the same number is a different vote.",
+              "type": "string"
+            },
+            "congress": {
+              "description": "Congress the vote was cast in.",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            },
+            "session": {
+              "description": "Session the vote was cast in, from the action date: the congress's first year is session 1; its second year, and January 1–3 of the year after, session 2.",
+              "maximum": 2,
+              "minimum": 1,
+              "type": "integer"
+            },
+            "voteNumber": {
+              "description": "Senate roll call number the action cites.",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "chamber",
+            "congress",
+            "session",
+            "voteNumber"
+          ],
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Most recent action (`actionDate`, `text`), with `rollVote` when its text cites its own Senate record vote. Null or absent on a multi-part parent (e.g. PN730)."
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Arguments for congressgov_roll_votes that retrieve the Senate roll call vote this action cites as its own. Absent when the action cites no vote of its own (a back-reference such as \"(Record Vote No. 318)\" names another action's vote), and for votes before the feed starts — the Senate publishes roll call votes from the 101st Congress (1989) onward.",
+  "properties": {
+    "chamber": {
+      "const": "senate",
+      "description": "Always 'senate'. Pass it: congressgov_roll_votes defaults to 'house', whose vote with the same number is a different vote.",
+      "type": "string"
+    },
+    "congress": {
+      "description": "Congress the vote was cast in.",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    },
+    "session": {
+      "description": "Session the vote was cast in, from the action date: the congress's first year is session 1; its second year, and January 1–3 of the year after, session 2.",
+      "maximum": 2,
+      "minimum": 1,
+      "type": "integer"
+    },
+    "voteNumber": {
+      "description": "Senate roll call number the action cites.",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "chamber",
+    "congress",
+    "session",
+    "voteNumber"
+  ],
+  "type": "object"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: A process-local attempt budget or the shared upstream credential/IP quota was reached; upstream hourly limits vary and DEMO_KEY also has a daily quota. `invalid_request`: Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). `upstream_timeout`: The Congress.gov request deadline expired or the upstream returned an HTTP timeout response. `incompatible_identity`: A list operation carries an entity identifier that only a detail operation uses. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: A process-local attempt budget or the shared upstream credential/IP quota was reached; upstream hourly limits vary and DEMO_KEY also has a daily quota. `invalid_request`: Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape. `api_key_rejected`: The api.data.gov gateway rejected the server's configured CONGRESS_API_KEY (missing, invalid, disabled, unauthorized, or unverified); the gateway code is in data.upstreamCode. No change to the call's arguments can fix it. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status) or could not be reached, or the Senate LIS feed failed (5xx, a timeout, or a senate.gov HTTP 403 refusal, which carries retryable: false). `upstream_timeout`: A Congress.gov request or a congress.gov document fetch timed out or returned an HTTP timeout response, or the call's upstream requests could not finish inside its 50-second budget. `incompatible_identity`: A list operation carries an entity identifier that only a detail operation uses. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "not_found",
-  "rate_limited",
-  "invalid_request",
-  "upstream_error",
-  "upstream_timeout",
-  "incompatible_identity"
-]New value: +[
+  "not_found",
+  "rate_limited",
+  "invalid_request",
+  "api_key_rejected",
+  "upstream_error",
+  "upstream_timeout",
+  "incompatible_identity"
+]

Previous value: -"Dynamic upstream JSON record."New value: +"Nomination record for `get` (description, dates, nominees array, sub-resource counts); absent for `list` and sub-resources."

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "rollVote": {
+          "additionalProperties": false,
+          "description": "Arguments for congressgov_roll_votes that retrieve the Senate roll call vote this action cites as its own. Absent when the action cites no vote of its own (a back-reference such as \"(Record Vote No. 318)\" names another action's vote), and for votes before the feed starts — the Senate publishes roll call votes from the 101st Congress (1989) onward.",
+          "properties": {
+            "chamber": {
+              "const": "senate",
+              "description": "Always 'senate'. Pass it: congressgov_roll_votes defaults to 'house', whose vote with the same number is a different vote.",
+              "type": "string"
+            },
+            "congress": {
+              "description": "Congress the vote was cast in.",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            },
+            "session": {
+              "description": "Session the vote was cast in, from the action date: the congress's first year is session 1; its second year, and January 1–3 of the year after, session 2.",
+              "maximum": 2,
+              "minimum": 1,
+              "type": "integer"
+            },
+            "voteNumber": {
+              "description": "Senate roll call number the action cites.",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "chamber",
+            "congress",
+            "session",
+            "voteNumber"
+          ],
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Most recent action (`actionDate`, `text`), with `rollVote` when its text cites its own Senate record vote. Null or absent on a multi-part parent (e.g. PN730)."
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: A process-local attempt budget or the shared upstream credential/IP quota was reached; upstream hourly limits vary and DEMO_KEY also has a daily quota. `invalid_request`: Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). `upstream_timeout`: The Congress.gov request deadline expired or the upstream returned an HTTP timeout response. `incompatible_identity`: A list operation carries an entity identifier that only a detail operation uses. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "not_found",
-  "rate_limited",
-  "invalid_request",
-  "upstream_error"
-]New value: +[
+  "not_found",
+  "rate_limited",
+  "invalid_request",
+  "upstream_error",
+  "upstream_timeout",
+  "incompatible_identity"
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Dynamic upstream JSON record.",
+  "properties": {},
+  "type": "object"
+}

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "effectiveQuery",
+      "totalCount"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "not_found",
+            "rate_limited",
+            "invalid_request",
+            "upstream_error"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "effectiveQuery",
-  "totalCount"
-]

Removed value: -"Detail-mode key 'nomination' carries: Nomination record for `get` (description, dates, nominees array, sub-resource counts); absent for `list` and sub-resources."

Added value: +{
+  "description": "The browse scope and applied filters.",
+  "type": "string"
+}

Added value: +{
+  "description": "Guidance when results are empty, a page is past the end, or a caveat applies.",
+  "type": "string"
+}

Removed value: -{
-  "description": "Echo of the applied filters for list-mode queries. Rendered as the first line of the response.",
-  "type": "string"
-}

Added value: +{
+  "description": "Total results across all pages.",
+  "type": "number"
+}

Added value: +[
+  "effectiveQuery",
+  "totalCount"
+]

Previous value: -"Nomination data from Congress.gov API."New value: +"Detail-mode key 'nomination' carries: Nomination record for `get` (description, dates, nominees array, sub-resource counts); absent for `list` and sub-resources."

Added value: +{
+  "description": "Result rows. Per-tool item shape is rendered in the markdown body.",
+  "items": {
+    "additionalProperties": {},
+    "description": "Upstream JSON record. Per-tool item shape is rendered in the markdown body.",
+    "properties": {},
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": false,
+  "description": "Pagination metadata: total count and next offset.",
+  "properties": {
+    "count": {
+      "description": "Total result count across all pages.",
+      "maximum": 9007199254740991,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "nextOffset": {
+      "anyOf": [
+        {
+          "maximum": 9007199254740991,
+          "minimum": 0,
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Offset to pass for the next page, or null when there are no more pages."
+    }
+  },
+  "required": [
+    "count"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "Echo of the applied filters for list-mode queries. Rendered as the first line of the response.",
+  "type": "string"
+}

Previous value: -"Nomination number (e.g., '1064'). Required for detail operations."New value: +"Nomination number. Use the bare form (e.g. '1000') for nominations whose activity sits on the parent; use the partitioned form (e.g. '851-1') for sub-resources of a multi-part nomination. Required for detail operations."

Previous value: -"Batch ordinal within a multi-nominee nomination. Each ordinal addresses a group of nominees; the 'nominees' operation returns every individual in that batch. Use 'get' first to see available ordinals on the nomination's `nominees` array."New value: +"Batch ordinal within a multi-nominee nomination. Each ordinal addresses a group of nominees; the 'nominees' operation returns every individual in that batch. Use 'get' first to see available ordinals on the nomination's `nominees` array (multi-part parents have no nominees array — use a partitioned form like '851-1' instead)."

Previous value: -"Position ordinal within a nomination (for multi-nominee nominations)."New value: +"Batch ordinal within a multi-nominee nomination. Each ordinal addresses a group of nominees; the 'nominees' operation returns every individual in that batch. Use 'get' first to see available ordinals on the nomination's `nominees` array."