us-gov-open-data-mcp 1.0.0

package/dist/sdk/congress.js

@@ -0,0 +1,659 @@
+/**
+ * Congress.gov SDK — typed API client for the Congress.gov API (v3).
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchBills, getBillDetails } from "us-gov-open-data/sdk/congress";
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.congress.gov/v3",
+    name: "congress",
+    auth: {
+        type: "query",
+        key: "api_key",
+        envVar: "DATA_GOV_API_KEY",
+        extraParams: { format: "json" },
+    },
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 30 * 60 * 1000, // 30 min
+});
+// ─── Helpers ─────────────────────────────────────────────────────────
+/** Current congress number based on date. */
+export function currentCongress() {
+    const year = new Date().getFullYear();
+    return Math.floor((year - 1789) / 2) + 1;
+}
+/** Map bill type codes to Congress.gov URL segments. */
+const BILL_URL_SEGMENTS = {
+    hr: "house-bill",
+    s: "senate-bill",
+    hjres: "house-joint-resolution",
+    sjres: "senate-joint-resolution",
+    hconres: "house-concurrent-resolution",
+    sconres: "senate-concurrent-resolution",
+    hres: "house-resolution",
+    sres: "senate-resolution",
+};
+export function billTypeToUrlSegment(billType) {
+    return BILL_URL_SEGMENTS[billType.toLowerCase()] || "house-bill";
+}
+// ─── Reference data ──────────────────────────────────────────────────
+export const billTypes = {
+    hr: { name: "House Bill", urlSegment: "house-bill" },
+    s: { name: "Senate Bill", urlSegment: "senate-bill" },
+    hjres: { name: "House Joint Resolution", urlSegment: "house-joint-resolution" },
+    sjres: { name: "Senate Joint Resolution", urlSegment: "senate-joint-resolution" },
+    hconres: { name: "House Concurrent Resolution", urlSegment: "house-concurrent-resolution" },
+    sconres: { name: "Senate Concurrent Resolution", urlSegment: "senate-concurrent-resolution" },
+    hres: { name: "House Simple Resolution", urlSegment: "house-resolution" },
+    sres: { name: "Senate Simple Resolution", urlSegment: "senate-resolution" },
+};
+export const congressNumbers = {
+    119: "2025-2026", 118: "2023-2024", 117: "2021-2022",
+    116: "2019-2020", 115: "2017-2018", 114: "2015-2016",
+    113: "2013-2014", 112: "2011-2012", 111: "2009-2010",
+};
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Search/list bills by congress number and/or bill type.
+ *
+ * NOTE: The Congress.gov API v3 does NOT support text/keyword search on the /bill endpoint.
+ * The `query` parameter is accepted but used for client-side title filtering only.
+ * To find specific bills, use `getBillDetails()` with known bill numbers, or browse
+ * by congress/bill_type and filter results.
+ */
+export async function searchBills(opts = {}) {
+    const congressNum = opts.congress ?? currentCongress();
+    let path = `/bill/${congressNum}`;
+    if (opts.bill_type)
+        path += `/${opts.bill_type.toLowerCase()}`;
+    // Fetch more if we need to filter client-side
+    const fetchLimit = opts.query ? Math.min((opts.limit ?? 20) * 5, 250) : (opts.limit ?? 20);
+    const res = await api.get(path, {
+        limit: fetchLimit,
+        offset: opts.offset ?? 0,
+        sort: "updateDate+desc",
+    });
+    let bills = res.bills ?? [];
+    // Client-side keyword filtering since the API doesn't support text search
+    if (opts.query) {
+        const terms = opts.query.toLowerCase().split(/\s+/).filter(Boolean);
+        bills = bills.filter(b => {
+            const title = (b.title ?? "").toLowerCase();
+            return terms.some(t => title.includes(t));
+        });
+        bills = bills.slice(0, opts.limit ?? 20);
+    }
+    return { bills };
+}
+/** Get detailed information about a specific bill, including cosponsors with party breakdown. */
+export async function getBillDetails(congress, billType, billNumber) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}`);
+    const bill = res.bill ?? res;
+    // Secondary call for cosponsors
+    let cosponsors = [];
+    const cosponsorPartyBreakdown = {};
+    try {
+        const cRes = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/cosponsors`, { limit: 250 });
+        cosponsors = cRes.cosponsors ?? [];
+        for (const c of cosponsors) {
+            const party = (c.party ?? "?");
+            cosponsorPartyBreakdown[party] = (cosponsorPartyBreakdown[party] ?? 0) + 1;
+        }
+    }
+    catch {
+        // Non-critical — some bills may not have cosponsors
+    }
+    return { bill, cosponsors, cosponsorPartyBreakdown };
+}
+/** Search members of Congress by state, congress, and/or district. */
+export async function searchMembers(opts = {}) {
+    let path;
+    if (opts.state && opts.district !== undefined) {
+        const congressNum = opts.congress ?? currentCongress();
+        path = `/member/congress/${congressNum}/${opts.state.toUpperCase()}/${opts.district}`;
+    }
+    else if (opts.state) {
+        path = `/member/${opts.state.toUpperCase()}`;
+    }
+    else if (opts.congress) {
+        path = `/member/congress/${opts.congress}`;
+    }
+    else {
+        path = `/member`;
+    }
+    const res = await api.get(path, { limit: opts.limit ?? 50 });
+    return { members: res.members ?? [] };
+}
+/** Convert a calendar year to Congress number and session. */
+function yearToCongress(year) {
+    const congress = Math.floor((year - 1789) / 2) + 1;
+    const session = (year % 2 === 1 ? 1 : 2);
+    return { congress, session };
+}
+/**
+ * Get House roll call votes.
+ *
+ * Primary source: Congress.gov API (currently 118th–119th Congress, beta).
+ * Fallback: clerk.house.gov XML (coverage: 1990 to present) — fills gaps
+ * where the API returns no data (e.g. older congresses).
+ *
+ * Data sources:
+ *   - https://api.congress.gov/v3/house-vote
+ *   - https://clerk.house.gov/Votes
+ */
+export async function getHouseVotes(opts = {}) {
+    // Resolve congress+session from year if needed (API uses congress/session)
+    const resolvedOpts = { ...opts };
+    if (opts.year && !opts.congress) {
+        const { congress, session } = yearToCongress(opts.year);
+        resolvedOpts.congress = congress;
+        resolvedOpts.session = opts.session ?? session;
+    }
+    // Try Congress.gov API first
+    try {
+        const apiResult = await getHouseVotesFromApi(resolvedOpts);
+        const hasData = opts.vote_number
+            ? (apiResult.members?.length ?? 0) > 0 || apiResult.vote != null
+            : (apiResult.votes?.length ?? 0) > 0;
+        if (hasData)
+            return apiResult;
+    }
+    catch {
+        // API error — continue to clerk fallback
+    }
+    // Fall back to clerk.house.gov XML (1990–present)
+    return getHouseVotesFromClerk(opts);
+}
+/** Fallback: Fetch House votes from clerk.house.gov XML (1990–present). */
+async function getHouseVotesFromClerk(opts) {
+    // Resolve year (either explicit or derived from congress+session)
+    let year;
+    if (opts.year) {
+        year = opts.year;
+    }
+    else {
+        const congressNum = opts.congress ?? currentCongress();
+        const sessionNum = opts.session ?? currentSession();
+        year = congressSessionToYear(congressNum, sessionNum);
+    }
+    if (opts.vote_number) {
+        // Fetch individual vote XML from clerk.house.gov
+        const num = String(opts.vote_number).padStart(3, "0");
+        const url = `${HOUSE_CLERK_BASE}/${year}/roll${num}.xml`;
+        const resp = await fetch(url, {
+            headers: { "User-Agent": "us-gov-open-data-mcp/2.0 (gov-accountability-tool)" },
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!resp.ok)
+            throw new Error(`House vote fetch failed: ${resp.status} ${resp.statusText} (${url})`);
+        const xml = await resp.text();
+        const parsed = parseXml(xml);
+        const rc = (parsed["rollcall-vote"] ?? {});
+        const meta = (rc["vote-metadata"] ?? {});
+        const voteDataNode = (rc["vote-data"] ?? {});
+        // Build vote summary
+        const vote = {
+            rollCallNumber: Number(meta["rollcall-num"]) || opts.vote_number,
+            date: String(meta["action-date"] ?? ""),
+            question: String(meta["vote-question"] ?? ""),
+            voteQuestion: String(meta["vote-question"] ?? ""),
+            result: String(meta["vote-result"] ?? ""),
+            description: String(meta["vote-desc"] ?? ""),
+            legislationNumber: String(meta["legis-num"] ?? ""),
+            voteType: String(meta["vote-type"] ?? ""),
+        };
+        // Parse members from recorded-vote entries
+        const recordedVotes = (voteDataNode["recorded-vote"] ?? []);
+        const members = recordedVotes.map((rv) => {
+            const leg = (rv.legislator ?? {});
+            return {
+                bioguideID: String(leg["@_name-id"] ?? ""),
+                lastName: String(leg["@_sort-field"] ?? leg["@_unaccented-name"] ?? ""),
+                firstName: "",
+                voteParty: String(leg["@_party"] ?? ""),
+                party: String(leg["@_party"] ?? ""),
+                voteState: String(leg["@_state"] ?? ""),
+                voteCast: String(rv.vote ?? ""),
+                votePosition: String(rv.vote ?? ""),
+            };
+        });
+        // Build party tally
+        const partyTally = {};
+        for (const m of members) {
+            const p = m.party ?? "?";
+            const v = m.votePosition ?? "?";
+            if (!partyTally[p])
+                partyTally[p] = {};
+            partyTally[p][v] = (partyTally[p][v] ?? 0) + 1;
+        }
+        return { vote, members, partyTally, source: "clerk.house.gov" };
+    }
+    // List votes: parse HTML index page from clerk.house.gov
+    const url = `${HOUSE_CLERK_BASE}/${year}/index.asp`;
+    const resp = await fetch(url, {
+        headers: { "User-Agent": "us-gov-open-data-mcp/2.0 (gov-accountability-tool)" },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!resp.ok)
+        throw new Error(`House vote index fetch failed: ${resp.status} (${url})`);
+    const html = await resp.text();
+    const votes = parseHouseVoteIndex(html, opts.limit ?? 20);
+    return { votes, source: "clerk.house.gov" };
+}
+/** Primary: Fetch House votes from Congress.gov API (118th–119th Congress, beta). */
+async function getHouseVotesFromApi(opts) {
+    const congressNum = opts.congress ?? currentCongress();
+    if (opts.vote_number && opts.session) {
+        // Try member-level breakdown first
+        try {
+            const res = await api.get(`/house-vote/${congressNum}/${opts.session}/${opts.vote_number}/members`);
+            const raw = res.houseRollCallVoteMemberVotes?.results ?? [];
+            const members = raw.map((m) => ({
+                ...m,
+                party: m.voteParty,
+                votePosition: m.voteCast,
+            }));
+            const partyTally = {};
+            for (const m of members) {
+                const party = (m.party ?? "?");
+                const pos = (m.votePosition ?? "?");
+                if (!partyTally[party])
+                    partyTally[party] = {};
+                partyTally[party][pos] = (partyTally[party][pos] ?? 0) + 1;
+            }
+            return { members, partyTally, source: "api.congress.gov" };
+        }
+        catch {
+            // Fall back to vote summary
+            const vRes = await api.get(`/house-vote/${congressNum}/${opts.session}/${opts.vote_number}`);
+            const vote = vRes.houseRollCallVote ?? vRes;
+            if (vote.votePartyTotal) {
+                const partyTally = {};
+                for (const pt of vote.votePartyTotal) {
+                    partyTally[pt.voteParty] = {
+                        Yea: pt.yeaTotal,
+                        Nay: pt.nayTotal,
+                        "Not Voting": pt.notVotingTotal,
+                        Present: pt.presentTotal,
+                    };
+                }
+                return { vote, partyTally, source: "api.congress.gov" };
+            }
+            return { vote, source: "api.congress.gov" };
+        }
+    }
+    // List recent votes via API
+    let path = `/house-vote/${congressNum}`;
+    if (opts.session)
+        path += `/${opts.session}`;
+    const res = await api.get(path, { limit: opts.limit ?? 20 });
+    return { votes: res.houseRollCallVotes ?? [], source: "api.congress.gov" };
+}
+/** Parse the clerk.house.gov HTML index page to extract a vote list. */
+function parseHouseVoteIndex(html, limit) {
+    const votes = [];
+    // Match each table row that contains vote data
+    const rowPattern = /<TR>\s*<TD>[\s\S]*?<\/TR>/gi;
+    let rowMatch;
+    while ((rowMatch = rowPattern.exec(html)) !== null && votes.length < limit) {
+        const row = rowMatch[0];
+        // Extract TD cells — content may contain nested tags
+        const cellPattern = /<TD[^>]*>([\s\S]*?)<\/TD>/gi;
+        const cells = [];
+        let cellMatch;
+        while ((cellMatch = cellPattern.exec(row)) !== null) {
+            // Strip all HTML tags, collapse whitespace
+            cells.push(cellMatch[1].replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim());
+        }
+        if (cells.length < 6)
+            continue;
+        const rollNum = Number(cells[0]);
+        if (!rollNum)
+            continue;
+        const resultCode = cells[4].trim();
+        const result = resultCode === "P" ? "Passed" : resultCode === "F" ? "Failed" : resultCode === "A" ? "Agreed to" : resultCode;
+        votes.push({
+            rollCallNumber: rollNum,
+            date: cells[1],
+            question: cells[3],
+            result,
+            description: cells[5],
+            legislationNumber: cells[2],
+        });
+    }
+    return votes;
+}
+/** Get recently enacted laws. */
+export async function getRecentLaws(opts = {}) {
+    const congressNum = opts.congress ?? currentCongress();
+    const res = await api.get(`/law/${congressNum}`, { limit: opts.limit ?? 20 });
+    return { laws: res.bills ?? res.laws ?? [] };
+}
+/** Get bills sponsored or cosponsored by a specific member. */
+export async function getMemberBills(bioguideId, type = "sponsored", limit = 20) {
+    const legType = type === "cosponsored" ? "cosponsored-legislation" : "sponsored-legislation";
+    const res = await api.get(`/member/${bioguideId}/${legType}`, { limit });
+    return { bills: res.sponsoredLegislation ?? res.cosponsoredLegislation ?? [] };
+}
+// ─── Bill Sub-resource Methods ───────────────────────────────────────
+/** Get the action history / timeline for a bill. */
+export async function getBillActions(congress, billType, billNumber, limit = 100) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/actions`, { limit });
+    return { actions: res.actions ?? [] };
+}
+/** Get amendments filed on a bill. */
+export async function getBillAmendments(congress, billType, billNumber, limit = 50) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/amendments`, { limit });
+    return { amendments: res.amendments ?? [] };
+}
+/** Get committees a bill was referred to. */
+export async function getBillCommittees(congress, billType, billNumber) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/committees`);
+    return { committees: res.committees ?? [] };
+}
+/** Get related/companion bills. */
+export async function getBillRelatedBills(congress, billType, billNumber, limit = 50) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/relatedbills`, { limit });
+    return { relatedBills: res.relatedBills ?? [] };
+}
+/** Get legislative subjects tagged on a bill. */
+export async function getBillSubjects(congress, billType, billNumber, limit = 100) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/subjects`, { limit });
+    return {
+        subjects: res.subjects?.legislativeSubjects ?? res.legislativeSubjects ?? [],
+        policyArea: res.subjects?.policyArea?.name ?? res.policyArea?.name,
+    };
+}
+/** Get CRS summaries of a bill. */
+export async function getBillSummaries(congress, billType, billNumber) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/summaries`);
+    return { summaries: res.summaries ?? [] };
+}
+/** Get text versions available for a bill. */
+export async function getBillTextVersions(congress, billType, billNumber) {
+    const res = await api.get(`/bill/${congress}/${billType.toLowerCase()}/${billNumber}/text`);
+    return { textVersions: res.textVersions ?? [] };
+}
+// ─── Member Details ──────────────────────────────────────────────────
+/** Get detailed information about a specific member by bioguide ID. */
+export async function getMemberDetails(bioguideId) {
+    const res = await api.get(`/member/${bioguideId}`);
+    return { member: res.member ?? res };
+}
+// ─── Amendments ──────────────────────────────────────────────────────
+/** Search/list amendments. */
+export async function searchAmendments(opts = {}) {
+    let path = "/amendment";
+    if (opts.congress) {
+        path += `/${opts.congress}`;
+        if (opts.amendmentType)
+            path += `/${opts.amendmentType.toLowerCase()}`;
+    }
+    const res = await api.get(path, {
+        limit: opts.limit ?? 20,
+    });
+    return { amendments: res.amendments ?? [] };
+}
+/** Get details about a specific amendment (includes actions). */
+export async function getAmendmentDetails(congress, amendmentType, amendmentNumber) {
+    const amtType = amendmentType.toLowerCase();
+    const res = await api.get(`/amendment/${congress}/${amtType}/${amendmentNumber}`);
+    let actions = [];
+    try {
+        const aRes = await api.get(`/amendment/${congress}/${amtType}/${amendmentNumber}/actions`);
+        actions = aRes.actions ?? [];
+    }
+    catch { /* non-critical */ }
+    return {
+        amendment: res.amendment ?? res,
+        actions,
+    };
+}
+// ─── Committees ──────────────────────────────────────────────────────
+/** List congressional committees. */
+export async function listCommittees(opts = {}) {
+    let path = "/committee";
+    if (opts.congress) {
+        path += `/${opts.congress}`;
+    }
+    if (opts.chamber) {
+        path += `/${opts.chamber.toLowerCase()}`;
+    }
+    const res = await api.get(path, {
+        limit: opts.limit ?? 50,
+    });
+    return { committees: res.committees ?? [] };
+}
+/** Get detailed committee info. */
+export async function getCommitteeDetails(chamber, committeeCode) {
+    const res = await api.get(`/committee/${chamber.toLowerCase()}/${committeeCode}`);
+    return { committee: res.committee ?? res };
+}
+/** Get bills assigned to a committee. */
+export async function getCommitteeBills(chamber, committeeCode, limit = 20) {
+    const res = await api.get(`/committee/${chamber.toLowerCase()}/${committeeCode}/bills`, { limit });
+    return { bills: res["committee-bills"]?.bills ?? res.bills ?? [] };
+}
+// ─── Nominations ─────────────────────────────────────────────────────
+/** List presidential nominations for a congress. */
+export async function listNominations(opts = {}) {
+    const congressNum = opts.congress ?? currentCongress();
+    const res = await api.get(`/nomination/${congressNum}`, { limit: opts.limit ?? 20 });
+    return { nominations: res.nominations ?? [] };
+}
+/** Get details about a specific nomination (includes actions). */
+export async function getNominationDetails(congress, nominationNumber) {
+    const res = await api.get(`/nomination/${congress}/${nominationNumber}`);
+    let actions = [];
+    try {
+        const aRes = await api.get(`/nomination/${congress}/${nominationNumber}/actions`);
+        actions = aRes.actions ?? [];
+    }
+    catch { /* non-critical */ }
+    return {
+        nomination: res.nomination ?? res,
+        actions,
+    };
+}
+// ─── Treaties ────────────────────────────────────────────────────────
+/** List treaties. */
+export async function listTreaties(opts = {}) {
+    let path = "/treaty";
+    if (opts.congress)
+        path += `/${opts.congress}`;
+    const res = await api.get(path, {
+        limit: opts.limit ?? 20,
+    });
+    return { treaties: res.treaties ?? [] };
+}
+/** Get details about a specific treaty (includes actions). */
+export async function getTreatyDetails(congress, treatyNumber) {
+    const res = await api.get(`/treaty/${congress}/${treatyNumber}`);
+    let actions = [];
+    try {
+        const aRes = await api.get(`/treaty/${congress}/${treatyNumber}/actions`);
+        actions = aRes.actions ?? [];
+    }
+    catch { /* non-critical */ }
+    return {
+        treaty: res.treaty ?? res,
+        actions,
+    };
+}
+// ─── CRS Reports ─────────────────────────────────────────────────────
+/** Search Congressional Research Service reports. */
+export async function searchCrsReports(opts = {}) {
+    const res = await api.get("/crsreport", { limit: opts.limit ?? 20 });
+    return { reports: res.CRSReports ?? res.reports ?? [] };
+}
+/** Get a specific CRS report by report number. */
+export async function getCrsReportDetails(reportNumber) {
+    const res = await api.get(`/crsreport/${reportNumber}`);
+    return { report: res.CRSReport ?? res.report ?? res };
+}
+// ─── Congressional Record ────────────────────────────────────────────
+/** Get Congressional Record issues. */
+export async function getCongressionalRecord(opts = {}) {
+    const params = { limit: opts.limit ?? 20 };
+    if (opts.year)
+        params.y = opts.year;
+    if (opts.month)
+        params.m = opts.month;
+    if (opts.day)
+        params.d = opts.day;
+    const res = await api.get("/congressional-record", params);
+    return { issues: res.Results?.Issues ?? res.congressionalRecord ?? res.issues ?? [] };
+}
+// ─── Roll Call Votes (from clerk.house.gov & senate.gov XML) ─────────
+import { XMLParser } from "fast-xml-parser";
+const xmlParser = new XMLParser({
+    ignoreAttributes: false,
+    trimValues: true,
+    // Ensure arrays for repeating elements in House and Senate vote XML
+    isArray: (name) => name === "member" || name === "vote" ||
+        name === "recorded-vote" || name === "totals-by-party",
+    // Parse numeric-looking values as numbers
+    parseTagValue: true,
+});
+/** Parse XML string into a JS object using fast-xml-parser. */
+function parseXml(xml) {
+    return xmlParser.parse(xml);
+}
+const HOUSE_CLERK_BASE = "https://clerk.house.gov/evs";
+const SENATE_BASE = "https://www.senate.gov/legislative/LIS";
+function padVoteNumber(n) {
+    return String(n).padStart(5, "0");
+}
+/** Convert congress number + session to calendar year. */
+function congressSessionToYear(congress, session) {
+    return (congress - 1) * 2 + 1788 + session;
+}
+/**
+ * Get Senate roll call votes from senate.gov XML data.
+ *
+ * Coverage: 101st Congress (1989) to present — far deeper than the Congress.gov API
+ * which only has House votes for 118th-119th Congress.
+ *
+ * Data source: https://www.senate.gov/general/XML.htm
+ */
+export async function getSenateVotes(opts = {}) {
+    const congressNum = opts.congress ?? currentCongress();
+    const sessionNum = opts.session ?? currentSession();
+    if (opts.vote_number) {
+        // Fetch individual vote XML
+        const url = `${SENATE_BASE}/roll_call_votes/vote${congressNum}${sessionNum}` +
+            `/vote_${congressNum}_${sessionNum}_${padVoteNumber(opts.vote_number)}.xml`;
+        const resp = await fetch(url, {
+            headers: { "User-Agent": "us-gov-open-data-mcp/2.0 (gov-accountability-tool)" },
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!resp.ok)
+            throw new Error(`Senate vote fetch failed: ${resp.status} ${resp.statusText} (${url})`);
+        const xml = await resp.text();
+        const parsed = parseXml(xml);
+        const rc = parsed.roll_call_vote ?? {};
+        // Parse vote metadata
+        const doc = rc.document;
+        const cnt = (rc.count ?? {});
+        const tb = (rc.tie_breaker ?? {});
+        const vote = {
+            congress: Number(rc.congress) || congressNum,
+            session: Number(rc.session) || sessionNum,
+            voteNumber: Number(rc.vote_number) || opts.vote_number,
+            date: String(rc.vote_date ?? ""),
+            question: String(rc.question ?? ""),
+            result: String(rc.vote_result ?? ""),
+            title: String(rc.vote_title ?? ""),
+            description: String(rc.vote_document_text ?? ""),
+            majorityRequired: String(rc.majority_requirement ?? ""),
+            count: {
+                yeas: Number(cnt.yeas) || 0,
+                nays: Number(cnt.nays) || 0,
+                present: Number(cnt.present) || 0,
+                absent: Number(cnt.absent) || 0,
+            },
+        };
+        if (doc) {
+            vote.document = {
+                type: String(doc.document_type ?? ""),
+                number: String(doc.document_number ?? ""),
+                name: String(doc.document_name ?? ""),
+                title: String(doc.document_title ?? ""),
+            };
+        }
+        const tbWho = String(tb.by_whom ?? "");
+        if (tbWho) {
+            vote.tieBreaker = { byWhom: tbWho, vote: String(tb.tie_breaker_vote ?? "") };
+        }
+        // Parse members
+        const membersContainer = (rc.members ?? {});
+        const rawMembers = (membersContainer.member ?? []);
+        const members = rawMembers.map((m) => ({
+            fullName: String(m.member_full ?? ""),
+            firstName: String(m.first_name ?? ""),
+            lastName: String(m.last_name ?? ""),
+            party: String(m.party ?? ""),
+            state: String(m.state ?? ""),
+            voteCast: String(m.vote_cast ?? ""),
+        }));
+        // Build party tally
+        const partyTally = {};
+        for (const m of members) {
+            const p = m.party || "?";
+            const v = m.voteCast || "?";
+            if (!partyTally[p])
+                partyTally[p] = {};
+            partyTally[p][v] = (partyTally[p][v] ?? 0) + 1;
+        }
+        return { vote, members, partyTally };
+    }
+    // List recent votes — fetch list XML
+    const listUrl = `${SENATE_BASE}/roll_call_lists/vote_menu_${congressNum}_${sessionNum}.xml`;
+    const resp = await fetch(listUrl, {
+        headers: { "User-Agent": "us-gov-open-data-mcp/2.0 (gov-accountability-tool)" },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!resp.ok)
+        throw new Error(`Senate vote list fetch failed: ${resp.status} ${resp.statusText} (${listUrl})`);
+    const xml = await resp.text();
+    const parsed = parseXml(xml);
+    const summary = parsed.vote_summary ?? {};
+    const rawVotes = (summary.votes ?? {}).vote ?? [];
+    const voteArr = (Array.isArray(rawVotes) ? rawVotes : [rawVotes]);
+    const maxResults = opts.limit ?? 20;
+    const votes = voteArr.slice(0, maxResults).map((v) => {
+        const tally = (v.vote_tally ?? {});
+        return {
+            congress: congressNum,
+            session: sessionNum,
+            voteNumber: Number(v.vote_number) || 0,
+            date: String(v.vote_date ?? ""),
+            question: String(v.question ?? ""),
+            result: String(v.result ?? ""),
+            title: String(v.title ?? ""),
+            description: String(v.issue ?? ""),
+            majorityRequired: "",
+            count: {
+                yeas: Number(tally.yeas) || 0,
+                nays: Number(tally.nays) || 0,
+                present: 0,
+                absent: 0,
+            },
+        };
+    });
+    return { votes };
+}
+/** Helper: current session (1 for odd years, 2 for even years). */
+function currentSession() {
+    return new Date().getFullYear() % 2 === 1 ? 1 : 2;
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=congress.js.map