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. 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. Other values are possible when a failure originates below the handler."

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

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. 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"
+]

Previous value: -"Filter committee list results by name (e.g., 'transportation', 'armed services'). Only meaningful for 'list'. Fetches the full chamber set and matches client-side; fuzzy-matched rows are labeled approximate."New value: +"Filter committee-list results by name (e.g., 'transportation', 'armed services'). Only meaningful for 'list'; fuzzy-matched rows are labeled approximate."

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"
-]

Previous value: -"Committee system code, e.g. 'hsju00'. Required for 'get' and sub-resources. Codes are lowercase letters + 2-digit suffix. Pass a committee name here and the tool will attempt to resolve it automatically — or use operation:'list' with filter to browse."New value: +"Committee system code, e.g. 'hsju00'. Required for 'get' and sub-resources. Codes are letters + a 2-digit suffix and are matched case-insensitively. Any other non-blank value is treated as a committee name and resolved automatically — single-word names ('Judiciary') included — or use operation:'list' with filter to browse."

Previous value: -"^([a-z]{2,6}\\d{2}|.*\\s.*)$"New value: +"\\S"

Previous value: -"Committee system code (e.g., 'hsju00'). Required for get and sub-resources."New value: +"Committee system code, e.g. 'hsju00'. Required for 'get' and sub-resources. Codes are lowercase letters + 2-digit suffix. Pass a committee name here and the tool will attempt to resolve it automatically — or use operation:'list' with filter to browse."

Added value: +"^([a-z]{2,6}\\d{2}|.*\\s.*)$"

Added value: +{
+  "description": "Filter committee list results by name (e.g., 'transportation', 'armed services'). Only meaningful for 'list'. Fetches the full chamber set and matches client-side; fuzzy-matched rows are labeled approximate.",
+  "type": "string"
+}

Removed value: -"Detail-mode key 'committee' carries: Committee record for `get` (name, chamber, subcommittees, history, 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: -"Committee data from Congress.gov API."New value: +"Detail-mode key 'committee' carries: Committee record for `get` (name, chamber, subcommittees, history, 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: -"Chamber filter. Required for 'get' and sub-resources."New value: +"Chamber filter for 'list', or override for 'get' and sub-resources (otherwise inferred from committeeCode prefix)."

Added value: +{
+  "default": "recent",
+  "description": "Sort order for the 'bills' sub-resource. 'recent' (default) returns newest update-date first; 'oldest' returns ascending update-date order. Ignored by other operations.",
+  "enum": [
+    "recent",
+    "oldest"
+  ],
+  "type": "string"
+}