@cyanheads/congressgov-mcp-server 0.3.25 → 0.3.26

package/dist/services/senate-lis/senate-vote-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senate-vote-service.d.ts","sourceRoot":"","sources":["../../../src/services/senate-lis/senate-vote-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAStD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA+BxF,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,UAAU,oBAAqB,SAAQ,aAAa;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,UAAU,GAAG;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,QAAQ,CAAC;IAClB,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAkCF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAyB;IAIxC,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsBhF,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAM9E,cAAc,CAClB,MAAM,EAAE,oBAAoB,EAC5B,GAAG,CAAC,EAAE,OAAO,GACZ,OAAO,CAAC,uBAAuB,CAAC;YAarB,SAAS;YAaT,QAAQ;YAiCR,OAAO;IA2BrB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,cAAc;CAIvB;AAID,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD"}

package/dist/services/senate-lis/senate-vote-service.js

@@ -0,0 +1,182 @@
+/**
+ * @fileoverview Senate LIS roll-call vote client — fetch, retry, XML parse, normalize.
+ *
+ * The Congress.gov API v3 exposes House votes only (validated 2026-05-31: the
+ * `/senate-vote/...` namespace 404s). Senate roll call votes live solely in the
+ * Senate's official LIS XML feed, which has no API key and no JSON. This service
+ * fetches and normalizes that feed into the same list/detail/members envelopes the
+ * House path returns, so a single tool can serve both chambers.
+ *
+ * Two endpoints back the three operations:
+ * - Session menu → `list` (the whole session is one file; paginate client-side).
+ * - Individual vote → `get` (metadata + derived party totals) and `members`
+ *   (the roster from the same file; paginate client-side).
+ *
+ * The host returns HTTP 200 with an HTML error page for unknown congress/session/
+ * vote, so "not found" is detected from the body, not the status code.
+ *
+ * @module services/senate-lis/senate-vote-service
+ */
+import { JsonRpcErrorCode, McpError, notFound, serviceUnavailable, } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout, withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { computePartyTotals, parseRollCallVote, parseVoteMenu } from './parse.js';
+const DEFAULT_BASE_URL = 'https://www.senate.gov/legislative/LIS';
+const REQUEST_TIMEOUT_MS = 12_000;
+const MAX_ATTEMPTS = 3;
+const BASE_BACKOFF_MS = 1000;
+/** A 200 response whose body is an HTML page (the host's "not found" surface). */
+const HTML_RESPONSE_RE = /^\s*<(!DOCTYPE|html[\s>])/i;
+/** A valid feed body opens with one of these roots once the XML declaration is past. */
+const FEED_ROOT_RE = /<(vote_summary|roll_call_vote)[\s>]/;
+const NOT_FOUND_RECOVERY = {
+    reason: 'not_found',
+    recovery: {
+        hint: "Use operation 'list' with chamber 'senate' to find valid vote numbers for the congress and session, then retry.",
+    },
+};
+const UPSTREAM_ERROR_RECOVERY = {
+    reason: 'upstream_error',
+    recovery: {
+        hint: 'Retry after a short delay; the Senate.gov LIS feed may be temporarily unavailable.',
+    },
+};
+/** English ordinal for a congress number — "118" → "118th". */
+function ordinal(n) {
+    const lastTwo = n % 100;
+    if (lastTwo >= 11 && lastTwo <= 13)
+        return `${n}th`;
+    switch (n % 10) {
+        case 1:
+            return `${n}st`;
+        case 2:
+            return `${n}nd`;
+        case 3:
+            return `${n}rd`;
+        default:
+            return `${n}th`;
+    }
+}
+function isNativeAbortSignal(value) {
+    if (typeof AbortSignal !== 'function' ||
+        typeof AbortSignal.prototype.throwIfAborted !== 'function' ||
+        !value) {
+        return false;
+    }
+    try {
+        AbortSignal.prototype.throwIfAborted.call(value);
+        return true;
+    }
+    catch (error) {
+        return !(error instanceof TypeError);
+    }
+}
+export class SenateVoteService {
+    baseUrl;
+    constructor(baseUrl = DEFAULT_BASE_URL) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+    }
+    async listVotes(params, ctx) {
+        const url = `${this.baseUrl}/roll_call_lists/vote_menu_${params.congress}_${params.session}.xml`;
+        const xml = await this.fetchXml(url, `SenateVoteService GET vote_menu_${params.congress}_${params.session}`, ctx, `No Senate roll call votes found for the ${ordinal(params.congress)} Congress, session ${params.session}. Valid sessions are 1 and 2; the Senate publishes roll call votes from the 101st Congress (1989) onward.`, { congress: params.congress, session: params.session });
+        const all = parseVoteMenu(xml);
+        /** Roll number is chronological within a session; sort explicitly so order does
+         * not depend on feed ordering. */
+        const sorted = [...all].sort((a, b) => params.order === 'oldest' ? a.voteNumber - b.voteNumber : b.voteNumber - a.voteNumber);
+        const slice = sorted.slice(params.offset, params.offset + params.limit);
+        const nextOffset = params.offset + slice.length < sorted.length ? params.offset + slice.length : null;
+        return { chamber: 'senate', data: slice, pagination: { count: sorted.length, nextOffset } };
+    }
+    async getVote(params, ctx) {
+        const { vote, members } = await this.fetchVote(params, ctx);
+        /** Derive the party breakdown from the roster — the feed publishes none. */
+        return { chamber: 'senate', vote: { ...vote, partyTotals: computePartyTotals(members) } };
+    }
+    async getVoteMembers(params, ctx) {
+        const { vote, members } = await this.fetchVote(params, ctx);
+        const slice = members.slice(params.offset, params.offset + params.limit);
+        const nextOffset = params.offset + slice.length < members.length ? params.offset + slice.length : null;
+        return {
+            chamber: 'senate',
+            data: slice,
+            vote,
+            pagination: { count: members.length, nextOffset },
+        };
+    }
+    async fetchVote(params, ctx) {
+        const padded = String(params.voteNumber).padStart(5, '0');
+        const url = `${this.baseUrl}/roll_call_votes/vote${params.congress}${params.session}/vote_${params.congress}_${params.session}_${padded}.xml`;
+        const xml = await this.fetchXml(url, `SenateVoteService GET vote_${params.congress}_${params.session}_${padded}`, ctx, `Senate roll call vote ${params.voteNumber} was not found in the ${ordinal(params.congress)} Congress, session ${params.session}.`, { congress: params.congress, session: params.session, voteNumber: params.voteNumber });
+        return parseRollCallVote(xml);
+    }
+    async fetchXml(url, operation, ctx, notFoundMessage, data) {
+        const requestContext = this.getRequestContext(ctx, operation);
+        const signal = this.getAbortSignal(ctx);
+        const text = await withRetry(() => this.doFetch(url, requestContext, signal), {
+            operation,
+            context: requestContext,
+            baseDelayMs: BASE_BACKOFF_MS,
+            maxRetries: MAX_ATTEMPTS - 1,
+            isTransient: (error) => this.isRetryableError(error),
+            ...(signal ? { signal } : {}),
+        });
+        const trimmed = text.trim();
+        if (!trimmed) {
+            throw serviceUnavailable('The Senate LIS feed returned an empty response.', {
+                ...UPSTREAM_ERROR_RECOVERY,
+            });
+        }
+        /** The host serves a 200 HTML page for unknown congress/session/vote — treat any
+         * non-feed body as not found rather than letting the parser choke on it. */
+        if (HTML_RESPONSE_RE.test(trimmed) || !FEED_ROOT_RE.test(trimmed)) {
+            throw notFound(notFoundMessage, { ...data, ...NOT_FOUND_RECOVERY });
+        }
+        return trimmed;
+    }
+    async doFetch(url, requestContext, signal) {
+        try {
+            const response = await fetchWithTimeout(url, REQUEST_TIMEOUT_MS, requestContext, {
+                headers: { Accept: 'application/xml, text/xml, */*' },
+                ...(signal ? { signal } : {}),
+            });
+            return await response.text();
+        }
+        catch (error) {
+            /** fetchWithTimeout throws a status-mapped McpError whose message embeds the
+             *  full URL. The missing-resource case never lands here (the host answers 200
+             *  with HTML), so a genuine non-2xx is an outage/timeout — surface it as a clean,
+             *  retryable upstream error without echoing the URL. */
+            if (error instanceof McpError) {
+                throw serviceUnavailable('The Senate.gov LIS feed is temporarily unavailable.', { ...UPSTREAM_ERROR_RECOVERY }, { cause: error });
+            }
+            throw error;
+        }
+    }
+    isRetryableError(error) {
+        if (error instanceof McpError) {
+            return (error.code === JsonRpcErrorCode.ServiceUnavailable ||
+                error.code === JsonRpcErrorCode.Timeout);
+        }
+        return true;
+    }
+    getRequestContext(ctx, operation) {
+        const ctxRecord = ctx;
+        const requestId = typeof ctxRecord?.requestId === 'string' ? ctxRecord.requestId : 'senate-vote-service';
+        const timestamp = typeof ctxRecord?.timestamp === 'string' ? ctxRecord.timestamp : new Date().toISOString();
+        return { operation, requestId, timestamp };
+    }
+    getAbortSignal(ctx) {
+        const signal = ctx?.signal;
+        return isNativeAbortSignal(signal) ? signal : undefined;
+    }
+}
+let _service;
+export function initSenateVoteService() {
+    _service = new SenateVoteService();
+}
+export function getSenateVoteService() {
+    if (!_service) {
+        throw new Error('SenateVoteService not initialized — call initSenateVoteService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=senate-vote-service.js.map

package/dist/services/senate-lis/senate-vote-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"senate-vote-service.js","sourceRoot":"","sources":["../../../src/services/senate-lis/senate-vote-service.ts"],"names":[],"mappings":"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"}

package/dist/services/senate-lis/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Domain types for Senate LIS roll-call vote data.
+ *
+ * The Congress.gov API v3 exposes House votes only; Senate roll call votes are
+ * published solely through the Senate's official LIS XML feed
+ * (https://www.senate.gov/legislative/LIS/roll_call_votes/). These types describe
+ * the normalized, camelCased shapes the parser produces from that XML — distinct
+ * from the House JSON shapes the Congress.gov API returns.
+ *
+ * Every record carries `chamber: 'senate'` so the shared vote formatter can route
+ * Senate payloads to the Senate renderers without inspecting field shapes.
+ *
+ * @module services/senate-lis/types
+ */
+/** A single row from the Senate vote menu (`vote_menu_{congress}_{session}.xml`). */
+export type SenateVoteSummary = {
+    chamber: 'senate';
+    /** Roll call number within the session (1-based, not zero-padded). */
+    voteNumber: number;
+    /** Short date as published in the menu, e.g. "21-Dec" (no year — derive from session). */
+    voteDate?: string;
+    /** Associated measure label, e.g. "H.R. 10545", "PN373". */
+    issue?: string;
+    /** Vote question, e.g. "On Passage of the Bill", "On the Amendment". */
+    question?: string;
+    /** Amendment reference parsed from the menu question's nested `<measure>`, when present. */
+    measure?: string;
+    /** Outcome, e.g. "Passed", "Agreed to", "Rejected". */
+    result?: string;
+    yeas: number;
+    nays: number;
+    /** Full title / description of the matter voted on. */
+    title?: string;
+};
+/** Associated legislative document attached to a Senate vote (bill, nomination, amendment). */
+export type SenateVoteDocument = {
+    congress?: number;
+    /** Document type, e.g. "PN" (nomination), "S.", "H.R.", "S.Amdt.". */
+    type?: string;
+    number?: string;
+    name?: string;
+    title?: string;
+    shortTitle?: string;
+};
+/** Amendment metadata, populated only on amendment votes. */
+export type SenateVoteAmendment = {
+    number?: string;
+    toDocumentNumber?: string;
+    toDocumentShortTitle?: string;
+    purpose?: string;
+};
+/** Official tally block from the vote record. */
+export type SenateVoteCount = {
+    yeas: number;
+    nays: number;
+    present: number;
+    absent: number;
+};
+/**
+ * Per-party tally derived from the member roster. The LIS feed does not publish a
+ * party breakdown, so this is computed from each member's party + cast — honest
+ * aggregation of real per-member data, not an upstream-provided figure.
+ */
+export type SenatePartyTotal = {
+    /** Party code: "D", "R", "I". */
+    party: string;
+    yea: number;
+    nay: number;
+    present: number;
+    /** "Not Voting" casts (the Senate term for absent). */
+    notVoting: number;
+};
+/** A fully parsed Senate roll call vote record (`vote_{congress}_{session}_{nnnnn}.xml`). */
+export type SenateVoteDetail = {
+    chamber: 'senate';
+    congress: number;
+    session: number;
+    voteNumber: number;
+    /** Full timestamp, e.g. "January 8, 2024, 05:27 PM". */
+    voteDate?: string;
+    modifyDate?: string;
+    /** Short question, e.g. "On the Cloture Motion". */
+    question?: string;
+    /** Full question text, e.g. "On the Cloture Motion PN1020". */
+    voteQuestionText?: string;
+    voteTitle?: string;
+    /** Outcome label, e.g. "Cloture Motion Agreed to". */
+    voteResult?: string;
+    /** Outcome with tally, e.g. "Cloture Motion Agreed to (73-15)". */
+    voteResultText?: string;
+    /** Narrative describing the matter (nominee bio, amendment purpose). */
+    voteDocumentText?: string;
+    /** Threshold required to prevail, e.g. "1/2", "3/5", "2/3". */
+    majorityRequirement?: string;
+    count: SenateVoteCount;
+    document?: SenateVoteDocument;
+    amendment?: SenateVoteAmendment;
+    /** Party breakdown derived from the roster (present on `get`, omitted on `members`). */
+    partyTotals?: SenatePartyTotal[];
+};
+/** One member's recorded position on a Senate roll call. */
+export type SenateMemberVote = {
+    chamber: 'senate';
+    /** Display name as published, e.g. "Baldwin (D-WI)". */
+    memberFull?: string;
+    firstName?: string;
+    lastName?: string;
+    /** Party code: "D", "R", "I". */
+    party?: string;
+    /** Two-letter state code. */
+    state?: string;
+    /** Cast: "Yea", "Nay", "Present", or "Not Voting". */
+    voteCast?: string;
+    /** Senate LIS member identifier, e.g. "S354". */
+    lisMemberId?: string;
+};
+/** Parsed individual-vote payload: the vote record plus its full member roster. */
+export type ParsedRollCallVote = {
+    vote: SenateVoteDetail;
+    members: SenateMemberVote[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/services/senate-lis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/senate-lis/types.ts"],"names":[],"mappings":"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"}

package/dist/services/senate-lis/types.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Domain types for Senate LIS roll-call vote data.
+ *
+ * The Congress.gov API v3 exposes House votes only; Senate roll call votes are
+ * published solely through the Senate's official LIS XML feed
+ * (https://www.senate.gov/legislative/LIS/roll_call_votes/). These types describe
+ * the normalized, camelCased shapes the parser produces from that XML — distinct
+ * from the House JSON shapes the Congress.gov API returns.
+ *
+ * Every record carries `chamber: 'senate'` so the shared vote formatter can route
+ * Senate payloads to the Senate renderers without inspecting field shapes.
+ *
+ * @module services/senate-lis/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/senate-lis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/senate-lis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/congressgov-mcp-server",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "description": "Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.",
   "mcpName": "io.github.cyanheads/congressgov-mcp-server",
   "type": "module",
@@ -77,6 +77,7 @@
   },
   "dependencies": {
     "@cyanheads/mcp-ts-core": "^0.9.16",
+    "fast-xml-parser": "^5.8.0",
     "pino-pretty": "^13.1.3",
     "zod": "^4.4.3"
   },

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/cyanheads/congressgov-mcp-server",
     "source": "github"
   },
-  "version": "0.3.25",
+  "version": "0.3.26",
   "remotes": [
     {
       "type": "streamable-http",
@@ -19,7 +19,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/congressgov-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.3.25",
+      "version": "0.3.26",
       "packageArguments": [
         {
           "type": "positional",
@@ -54,7 +54,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/congressgov-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.3.25",
+      "version": "0.3.26",
       "packageArguments": [
         {
           "type": "positional",