@cyanheads/congressgov-mcp-server 0.7.0 → 0.7.2

package/dist/mcp-server/tools/definitions/crs-reports.tool.d.ts

@@ -21,24 +21,28 @@ export declare const crsReportsTool: import("@cyanheads/mcp-ts-core").ToolDefini
 }, z.core.$loose>, readonly [{
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly reason: 'not_found';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov.';
     readonly recovery: "Use the tool's list or browse operation to discover valid identifiers, then retry with one that exists.";
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
     readonly reason: 'rate_limited';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded.';
     readonly recovery: 'Wait for the hourly rate-limit window to reset before retrying, or reduce the request frequency.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'invalid_request';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape.';
     readonly recovery: 'Check parameter formats: dates must be ISO 8601 like 2026-05-01T00:00:00Z and identifiers must match their documented shape.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly reason: 'upstream_error';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'Congress.gov returned an unexpected error (5xx or another non-2xx status).';
     readonly recovery: 'Retry after a short delay; if the failure persists the Congress.gov service may be temporarily degraded.';

package/dist/mcp-server/tools/definitions/crs-reports.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crs-reports.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/crs-reports.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAYjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDzB,CAAC"}
+{"version":3,"file":"crs-reports.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/crs-reports.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAYjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDzB,CAAC"}

package/dist/mcp-server/tools/definitions/crs-reports.tool.js

@@ -4,8 +4,8 @@
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { validationError } from '@cyanheads/mcp-ts-core/errors';
-import { formatCrsReports } from '../../../mcp-server/tools/format-helpers.js';
-import { congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../../../mcp-server/tools/tool-helpers.js';
+import { formatCrsReports } from '../format-helpers.js';
+import { congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../tool-helpers.js';
 import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
 export const crsReportsTool = tool('congressgov_crs_reports', {
     title: 'Congress.gov CRS Reports',

package/dist/mcp-server/tools/definitions/daily-record.tool.d.ts

@@ -31,24 +31,28 @@ export declare const dailyRecordTool: import("@cyanheads/mcp-ts-core").ToolDefin
 }, z.core.$loose>, readonly [{
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly reason: 'not_found';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov.';
     readonly recovery: "Use the tool's list or browse operation to discover valid identifiers, then retry with one that exists.";
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
     readonly reason: 'rate_limited';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded.';
     readonly recovery: 'Wait for the hourly rate-limit window to reset before retrying, or reduce the request frequency.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'invalid_request';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape.';
     readonly recovery: 'Check parameter formats: dates must be ISO 8601 like 2026-05-01T00:00:00Z and identifiers must match their documented shape.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly reason: 'upstream_error';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'Congress.gov returned an unexpected error (5xx or another non-2xx status).';
     readonly recovery: 'Retry after a short delay; if the failure persists the Congress.gov service may be temporarily degraded.';
@@ -67,21 +71,24 @@ export declare const dailyRecordTool: import("@cyanheads/mcp-ts-core").ToolDefin
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly reason: 'document_fetch_failed';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'www.congress.gov did not return a readable document — a non-2xx status, a network failure, an empty body, or a content type that is not text or XML.';
     readonly recovery: 'Retry after a short delay; if the failure persists, request a different format or read the document at the sourceUrl the text operation returns.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'document_too_large';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'The document is larger than the byte ceiling this server retrieves, so no character window can be served from it.';
     readonly recovery: 'Read the document at the sourceUrl the text operation returns. A document this size clears the ceiling in every format it publishes, so switching format reaches the same limit.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'offset_past_end';
+    readonly thrownBy: 'service';
     readonly retryable: false;
-    readonly when: 'characterOffset is at or beyond the last character of the document, so the window would be empty.';
-    readonly recovery: 'Restart the walk at characterOffset 0 and follow nextOffset, which goes null once the document has been read to the end.';
+    readonly when: "characterOffset is at or beyond the last character of every text the call would window — the document on 'content', or every returned row's summary text on 'summaries' — so the window would be empty.";
+    readonly recovery: "Restart the walk at characterOffset 0 and follow the response's nextOffset (or a summary row's textNextOffset), which goes null once the text has been read to the end.";
 }], {
     effectiveQuery: z.ZodString;
     totalCount: z.ZodNumber;

package/dist/mcp-server/tools/definitions/daily-record.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daily-record.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/daily-record.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAqBjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkK1B,CAAC"}
+{"version":3,"file":"daily-record.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/daily-record.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAqBjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkK1B,CAAC"}

package/dist/mcp-server/tools/definitions/daily-record.tool.js

@@ -4,8 +4,8 @@
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { validationError } from '@cyanheads/mcp-ts-core/errors';
-import { formatDailyRecord } from '../../../mcp-server/tools/format-helpers.js';
-import { congressErrorContracts, documentErrorContracts, documentWindowInput, listEnrichment, listOrDetail, notifyIfNoMatches, numericIdentifier, toIdentifierNumber, } from '../../../mcp-server/tools/tool-helpers.js';
+import { formatDailyRecord } from '../format-helpers.js';
+import { congressErrorContracts, documentErrorContracts, documentWindowInput, listEnrichment, listOrDetail, notifyIfNoMatches, numericIdentifier, toIdentifierNumber, } from '../tool-helpers.js';
 import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
 import { getCongressDocuments } from '../../../services/congress-documents/congress-documents-service.js';
 import { describeFormat, selectDocumentUrl, } from '../../../services/congress-documents/document-formats.js';

package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts

@@ -26,24 +26,28 @@ export declare const enactedLawsTool: import("@cyanheads/mcp-ts-core").ToolDefin
 }, z.core.$loose>, readonly [{
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly reason: 'not_found';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov.';
     readonly recovery: "Use the tool's list or browse operation to discover valid identifiers, then retry with one that exists.";
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
     readonly reason: 'rate_limited';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded.';
     readonly recovery: 'Wait for the hourly rate-limit window to reset before retrying, or reduce the request frequency.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'invalid_request';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape.';
     readonly recovery: 'Check parameter formats: dates must be ISO 8601 like 2026-05-01T00:00:00Z and identifiers must match their documented shape.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly reason: 'upstream_error';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'Congress.gov returned an unexpected error (5xx or another non-2xx status).';
     readonly recovery: 'Retry after a short delay; if the failure persists the Congress.gov service may be temporarily degraded.';

package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enacted-laws.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/enacted-laws.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAejD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkF1B,CAAC"}
+{"version":3,"file":"enacted-laws.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/enacted-laws.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAejD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkF1B,CAAC"}

package/dist/mcp-server/tools/definitions/enacted-laws.tool.js

@@ -4,8 +4,8 @@
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { validationError } from '@cyanheads/mcp-ts-core/errors';
-import { formatLaws } from '../../../mcp-server/tools/format-helpers.js';
-import { buildEffectiveQuery, congressErrorContracts, lawNumberIdentifier, listEnrichment, listOrDetail, notifyIfNoMatches, toLawNumber, } from '../../../mcp-server/tools/tool-helpers.js';
+import { formatLaws } from '../format-helpers.js';
+import { buildEffectiveQuery, congressErrorContracts, lawNumberIdentifier, listEnrichment, listOrDetail, notifyIfNoMatches, toLawNumber, } from '../tool-helpers.js';
 import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
 export const enactedLawsTool = tool('congressgov_enacted_laws', {
     title: 'Congress.gov Enacted Laws',

package/dist/mcp-server/tools/definitions/member-lookup.tool.d.ts

@@ -27,24 +27,28 @@ export declare const memberLookupTool: import("@cyanheads/mcp-ts-core").ToolDefi
 }, z.core.$loose>, readonly [{
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly reason: 'not_found';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov.';
     readonly recovery: "Use the tool's list or browse operation to discover valid identifiers, then retry with one that exists.";
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
     readonly reason: 'rate_limited';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded.';
     readonly recovery: 'Wait for the hourly rate-limit window to reset before retrying, or reduce the request frequency.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'invalid_request';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape.';
     readonly recovery: 'Check parameter formats: dates must be ISO 8601 like 2026-05-01T00:00:00Z and identifiers must match their documented shape.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly reason: 'upstream_error';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'Congress.gov returned an unexpected error (5xx or another non-2xx status).';
     readonly recovery: 'Retry after a short delay; if the failure persists the Congress.gov service may be temporarily degraded.';

package/dist/mcp-server/tools/definitions/member-lookup.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"member-lookup.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/member-lookup.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAajD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0H3B,CAAC"}
+{"version":3,"file":"member-lookup.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/member-lookup.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAajD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0H3B,CAAC"}

package/dist/mcp-server/tools/definitions/member-lookup.tool.js

@@ -4,8 +4,8 @@
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { validationError } from '@cyanheads/mcp-ts-core/errors';
-import { formatMembers } from '../../../mcp-server/tools/format-helpers.js';
-import { buildEffectiveQuery, congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../../../mcp-server/tools/tool-helpers.js';
+import { formatMembers } from '../format-helpers.js';
+import { buildEffectiveQuery, congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../tool-helpers.js';
 import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
 export const memberLookupTool = tool('congressgov_member_lookup', {
     title: 'Congress.gov Member Lookup',

package/dist/mcp-server/tools/definitions/roll-votes.tool.d.ts

@@ -34,24 +34,28 @@ export declare const rollVotesTool: import("@cyanheads/mcp-ts-core").ToolDefinit
 }, z.core.$loose>, readonly [{
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly reason: 'not_found';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov.';
     readonly recovery: "Use the tool's list or browse operation to discover valid identifiers, then retry with one that exists.";
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
     readonly reason: 'rate_limited';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded.';
     readonly recovery: 'Wait for the hourly rate-limit window to reset before retrying, or reduce the request frequency.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'invalid_request';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape.';
     readonly recovery: 'Check parameter formats: dates must be ISO 8601 like 2026-05-01T00:00:00Z and identifiers must match their documented shape.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly reason: 'upstream_error';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'Congress.gov returned an unexpected error (5xx or another non-2xx status).';
     readonly recovery: 'Retry after a short delay; if the failure persists the Congress.gov service may be temporarily degraded.';

package/dist/mcp-server/tools/definitions/roll-votes.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roll-votes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/roll-votes.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAcjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4HxB,CAAC"}
+{"version":3,"file":"roll-votes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/roll-votes.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAcjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4HxB,CAAC"}

package/dist/mcp-server/tools/definitions/roll-votes.tool.js

@@ -6,8 +6,8 @@
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { validationError } from '@cyanheads/mcp-ts-core/errors';
-import { formatVotes } from '../../../mcp-server/tools/format-helpers.js';
-import { buildEffectiveQuery, congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../../../mcp-server/tools/tool-helpers.js';
+import { formatVotes } from '../format-helpers.js';
+import { buildEffectiveQuery, congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../tool-helpers.js';
 import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
 import { getSenateVoteService } from '../../../services/senate-lis/senate-vote-service.js';
 export const rollVotesTool = tool('congressgov_roll_votes', {

package/dist/mcp-server/tools/definitions/search-bills.tool.d.ts

@@ -5,7 +5,7 @@
  * live fallback: a mirror that has not finished its initial build returns an empty
  * result with an enrichment notice rather than a thrown error. Gated behind
  * CONGRESS_MIRROR_ENABLED via disabledTool() — when the mirror is off (the
- * default) the tool stays on the manifest and the landing page for operators but
+ * default) the tool stays on the landing page for operators but
  * is skipped during MCP registration, so clients never see it in tools/list.
  * @module mcp-server/tools/definitions/search-bills
  */

package/dist/mcp-server/tools/definitions/search-bills.tool.js

@@ -5,14 +5,14 @@
  * live fallback: a mirror that has not finished its initial build returns an empty
  * result with an enrichment notice rather than a thrown error. Gated behind
  * CONGRESS_MIRROR_ENABLED via disabledTool() — when the mirror is off (the
- * default) the tool stays on the manifest and the landing page for operators but
+ * default) the tool stays on the landing page for operators but
  * is skipped during MCP registration, so clients never see it in tools/list.
  * @module mcp-server/tools/definitions/search-bills
  */
 import { disabledTool, tool, z } from '@cyanheads/mcp-ts-core';
 import { getServerConfig } from '../../../config/server-config.js';
-import { formatSearchBills } from '../../../mcp-server/tools/format-helpers.js';
-import { buildEffectiveQuery, listEnrichment, listOutput, notifyIfNoMatches, } from '../../../mcp-server/tools/tool-helpers.js';
+import { formatSearchBills } from '../format-helpers.js';
+import { buildEffectiveQuery, listEnrichment, listOutput, notifyIfNoMatches, } from '../tool-helpers.js';
 import { BILL_TYPE_CODES } from '../../../services/congress-api/types.js';
 import { getCongressMirror } from '../../../services/congress-mirror/congress-mirror-service.js';
 const searchBillsDef = tool('congressgov_search_bills', {

package/dist/mcp-server/tools/definitions/senate-nominations.tool.d.ts

@@ -27,24 +27,28 @@ export declare const senateNominationsTool: import("@cyanheads/mcp-ts-core").Too
 }, z.core.$loose>, readonly [{
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
     readonly reason: 'not_found';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov.';
     readonly recovery: "Use the tool's list or browse operation to discover valid identifiers, then retry with one that exists.";
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
     readonly reason: 'rate_limited';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded.';
     readonly recovery: 'Wait for the hourly rate-limit window to reset before retrying, or reduce the request frequency.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
     readonly reason: 'invalid_request';
+    readonly thrownBy: 'service';
     readonly retryable: false;
     readonly when: 'Congress.gov rejected the request as malformed — a bad date range or an identifier with an unexpected shape.';
     readonly recovery: 'Check parameter formats: dates must be ISO 8601 like 2026-05-01T00:00:00Z and identifiers must match their documented shape.';
 }, {
     readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
     readonly reason: 'upstream_error';
+    readonly thrownBy: 'service';
     readonly retryable: true;
     readonly when: 'Congress.gov returned an unexpected error (5xx or another non-2xx status).';
     readonly recovery: 'Retry after a short delay; if the failure persists the Congress.gov service may be temporarily degraded.';

package/dist/mcp-server/tools/definitions/senate-nominations.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"senate-nominations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/senate-nominations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAYjD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgIhC,CAAC"}
+{"version":3,"file":"senate-nominations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/senate-nominations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAYjD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgIhC,CAAC"}

package/dist/mcp-server/tools/definitions/senate-nominations.tool.js

@@ -4,8 +4,8 @@
  */
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { validationError } from '@cyanheads/mcp-ts-core/errors';
-import { formatNominations } from '../../../mcp-server/tools/format-helpers.js';
-import { buildEffectiveQuery, congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../../../mcp-server/tools/tool-helpers.js';
+import { formatNominations } from '../format-helpers.js';
+import { buildEffectiveQuery, congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../tool-helpers.js';
 import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
 export const senateNominationsTool = tool('congressgov_senate_nominations', {
     title: 'Congress.gov Senate Nominations',

package/dist/mcp-server/tools/format-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAw2DhD,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAYxE;AAwCD,2DAA2D;AAC3D,eAAO,MAAM,eAAe,WAvEhB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAuEkB,CAAC;AA8CpE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,WAtHlB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAsHuB,CAAC;AAEzE,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAoB1E;AAWD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAkB7E;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAWnF;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAK7E;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAc9E;AAED,8FAA8F;AAC9F,eAAO,MAAM,UAAU,WArNX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAqNiC,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAcxE;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAa9E"}
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AA45DhD,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAYxE;AAgDD,2DAA2D;AAC3D,eAAO,MAAM,eAAe,WA/EhB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EA+EkB,CAAC;AA8CpE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,WA9HlB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EA8HuB,CAAC;AAEzE,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAoB1E;AAWD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAkB7E;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAWnF;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAK7E;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAc9E;AAED,8FAA8F;AAC9F,eAAO,MAAM,UAAU,WA7NX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EA6NiC,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAcxE;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAa9E"}

package/dist/mcp-server/tools/format-helpers.js

@@ -26,6 +26,12 @@
  *
  * @module mcp-server/tools/format-helpers
  */
+import { decodeCharacterReferences } from '../../utils/character-references.js';
+/**
+ * Horizontal whitespace at this surface: spaces, tabs, and the literal U+00A0 in
+ * the class — what a decoded ` ` leaves behind, and ordinary spacing here.
+ */
+const HORIZONTAL_WHITESPACE_RE = /[ \t ]+/g;
 // ── Primitives ──────────────────────────────────────────────────────
 function tb(content) {
     return [{ type: 'text', text: content }];
@@ -39,30 +45,35 @@ function preserveHtmlBlockBoundaries(html) {
         .replace(/<\s*\/\s*li\s*>/gi, '\n')
         .replace(/<\s*\/\s*(?:p|ul|ol)\s*>/gi, '\n\n');
 }
+/**
+ * Collapse horizontal whitespace and blank-line runs, keeping the paragraph and
+ * line structure a block rendering carries.
+ */
+function normalizeBlockWhitespace(text) {
+    return text
+        .replace(HORIZONTAL_WHITESPACE_RE, ' ')
+        .replace(/\n[ \t]+/g, '\n')
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
 /**
  * Strip HTML to plain text while preserving paragraph and line breaks. Upstream
  * summary fields and other narrative bodies ship as HTML; we want the visible
  * structure (paragraph boundaries) to survive into the rendered Markdown.
  *
+ * Character references decode in one pass once the tags are gone, so text that
+ * literally says `&amp;lt;` reads as `&lt;` and not as a tag it never contained.
+ * A decoded `&nbsp;` is ordinary spacing at this surface, so it collapses with
+ * the rest of the horizontal whitespace.
+ *
  * Inline contexts that need single-line output should pass `{ inline: true }`.
  */
 function stripHtml(html, { inline = false } = {}) {
-    const text = preserveHtmlBlockBoundaries(html)
-        .replace(/<[^>]*>/g, '')
-        .replace(/&nbsp;/g, ' ')
-        .replace(/&#039;/g, "'")
-        .replace(/&amp;/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"');
+    const text = decodeCharacterReferences(preserveHtmlBlockBoundaries(html).replace(/<[^>]*>/g, ''));
     if (inline)
         return text.replace(/\s+/g, ' ').trim();
-    return text
-        .replace(/[ \t]+/g, ' ')
-        .replace(/\n[ \t]+/g, '\n')
-        .replace(/[ \t]+\n/g, '\n')
-        .replace(/\n{3,}/g, '\n\n')
-        .trim();
+    return normalizeBlockWhitespace(text);
 }
 /**
  * Wrap an emphasis span's content in Markdown markers with the span's own
@@ -92,23 +103,13 @@ function wrapEmphasis(inner, marker) {
  * through to the generic strip instead of leaving a stray marker.
  */
 function htmlToMarkdown(html) {
-    return preserveHtmlBlockBoundaries(html)
+    const markup = preserveHtmlBlockBoundaries(html)
         .replace(/<\s*p[^>]*>/gi, '')
         .replace(/<\s*(?:strong|b)\s*>([\s\S]*?)<\s*\/\s*(?:strong|b)\s*>/gi, (_m, inner) => wrapEmphasis(inner, '**'))
         .replace(/<\s*(?:em|i)\s*>([\s\S]*?)<\s*\/\s*(?:em|i)\s*>/gi, (_m, inner) => wrapEmphasis(inner, '*'))
         .replace(/<\s*a[^>]*href=["']([^"']*)["'][^>]*>([\s\S]*?)<\s*\/\s*a\s*>/gi, '[$2]($1)')
-        .replace(/<[^>]*>/g, '')
-        .replace(/&nbsp;/g, ' ')
-        .replace(/&#039;/g, "'")
-        .replace(/&amp;/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/[ \t]+/g, ' ')
-        .replace(/\n[ \t]+/g, '\n')
-        .replace(/[ \t]+\n/g, '\n')
-        .replace(/\n{3,}/g, '\n\n')
-        .trim();
+        .replace(/<[^>]*>/g, '');
+    return normalizeBlockWhitespace(decodeCharacterReferences(markup));
 }
 /** Safe deep access for compact field display — collapses whitespace to a single line. */
 function s(obj, ...path) {
@@ -530,6 +531,36 @@ const MEMBER_ROW_KEYS = new Set([
     'district',
     'url',
 ]);
+/**
+ * Window metadata a bounded summary row carries. Both summary renderers show it
+ * as one curated line, so it stays out of their fall-through key sets.
+ */
+const SUMMARY_WINDOW_KEYS = ['textTotalCharacters', 'textTruncated', 'textNextOffset'];
+/**
+ * The window line a row gains once its `text` was bounded — absent on a row
+ * returned whole, which is what keeps an unbounded page's rendering unchanged.
+ *
+ * The row publishes the total and the next offset; this window's own start is
+ * derived from the text it returned, the same way the vote roster derives its
+ * range — `textNextOffset` is one past the last character returned.
+ */
+function summaryWindowLine(item) {
+    const total = item.textTotalCharacters;
+    if (typeof total !== 'number')
+        return;
+    const text = typeof item.text === 'string' ? item.text : '';
+    const nextOffset = typeof item.textNextOffset === 'number' ? item.textNextOffset : null;
+    if (text.length === 0) {
+        return `**Summary text:** 0 of ${total.toLocaleString('en-US')} characters — characterOffset is past this summary's end`;
+    }
+    const end = nextOffset ?? total;
+    const start = end - text.length;
+    return join([
+        `**Summary text:** characters ${(start + 1).toLocaleString('en-US')}–${end.toLocaleString('en-US')} of ${total.toLocaleString('en-US')}`,
+        `**Truncated:** ${item.textTruncated === true}`,
+        nextOffset != null ? `next characterOffset: ${nextOffset}` : '_end of summary_',
+    ]);
+}
 function renderSummaryItem(item, i) {
     const named = new Set(SUMMARY_ROW_KEYS);
     const billType = s(item, 'bill', 'type')?.toUpperCase() ?? '';
@@ -557,6 +588,9 @@ function renderSummaryItem(item, i) {
     lines.push(bill && typeof bill === 'object' && !Array.isArray(bill)
         ? withUnnamedFields(bill, billLine, BILL_REF_KEYS)
         : billLine);
+    const window = summaryWindowLine(item);
+    if (window)
+        lines.push(window);
     // The summary text is the critical data — the whole point of this tool
     lines.push('');
     lines.push(text || '_Summary text not available._');
@@ -565,7 +599,7 @@ function renderSummaryItem(item, i) {
     return withRowRest(item, lines, named);
 }
 /** `actionDesc`/`versionCode` and the two update dates are resolved by `pick`. */
-const SUMMARY_ROW_KEYS = ['actionDate', 'text', 'url', 'bill'];
+const SUMMARY_ROW_KEYS = ['actionDate', 'text', 'url', 'bill', ...SUMMARY_WINDOW_KEYS];
 /** Fields of a summary row's nested bill reference the heading already renders. */
 const BILL_REF_KEYS = new Set(['congress', 'type', 'number', 'title', 'url']);
 function renderCrsReportItem(item, i) {
@@ -1204,7 +1238,7 @@ function renderSenateVoteItem(item, i) {
     if (question)
         lines.push(`**Question:** ${measure ? `${question} (${measure})` : question}`);
     const meta = join([
-        f('Date', s(item, 'voteDate')),
+        f('Date', senateVoteDate(item)),
         f('Yeas', s(item, 'yeas')),
         f('Nays', s(item, 'nays')),
     ]);
@@ -1215,6 +1249,18 @@ function renderSenateVoteItem(item, i) {
         lines.push(title);
     return withRowRest(item, lines, SENATE_VOTE_ROW_KEYS);
 }
+/**
+ * The resolved calendar date leads, with the menu's own year-less short form
+ * beside it — a row carries both, and the short form is what the Senate's own
+ * vote pages show.
+ */
+function senateVoteDate(item) {
+    const iso = s(item, 'voteDateIso');
+    const published = s(item, 'voteDate');
+    if (iso && published)
+        return `${iso} (${published})`;
+    return iso ?? published;
+}
 /** `chamber` is the dispatch marker, implicit in the Senate heading. */
 const SENATE_VOTE_ROW_KEYS = new Set([
     'chamber',
@@ -1224,6 +1270,7 @@ const SENATE_VOTE_ROW_KEYS = new Set([
     'question',
     'measure',
     'voteDate',
+    'voteDateIso',
     'yeas',
     'nays',
     'title',
@@ -1776,12 +1823,20 @@ function renderBillSubresourceSummaryItem(item, i) {
     const meta = join([f('Action Date', actionDate), f('Summary Updated', updated)]);
     if (meta)
         lines.push(meta);
+    const window = summaryWindowLine(item);
+    if (window)
+        lines.push(window);
     const text = typeof item.text === 'string' ? htmlToMarkdown(item.text) : '';
     if (text)
         lines.push('', text);
     return withRowRest(item, lines, named);
 }
-const BILL_SUMMARY_SUBRESOURCE_ROW_KEYS = ['actionDate', 'updateDate', 'text'];
+const BILL_SUMMARY_SUBRESOURCE_ROW_KEYS = [
+    'actionDate',
+    'updateDate',
+    'text',
+    ...SUMMARY_WINDOW_KEYS,
+];
 function pickBillListRenderer(first) {
     if ('title' in first && 'number' in first)
         return renderBillItem;