@cyanheads/congressgov-mcp-server 0.3.3

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

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview Shared formatting for tool output — lists, details, HTML stripping.
+ * @module mcp-server/tools/format-helpers
+ */
+/** Format any tool result into readable text content blocks. */
+export function formatResult(result) {
+    return [{ type: 'text', text: render(result) }];
+}
+function render(obj) {
+    // Paginated list: { data: [...], pagination: {...} }
+    if (Array.isArray(obj.data) && obj.pagination) {
+        const p = obj.pagination;
+        const items = obj.data;
+        const header = `${p.count} total${p.nextOffset != null ? ` | next offset: ${p.nextOffset}` : ''}`;
+        if (items.length === 0)
+            return header;
+        return [header, '', ...items.map((item, i) => `${i + 1}. ${summarize(item)}`)].join('\n');
+    }
+    // Single-key wrapper: { bill: {...} }, { issues: [...] }, etc.
+    const keys = Object.keys(obj);
+    if (keys.length === 1 && keys[0] !== undefined) {
+        const val = obj[keys[0]];
+        if (Array.isArray(val)) {
+            if (val.length === 0)
+                return `No ${keys[0]}.`;
+            return val
+                .map((item, i) => `${i + 1}. ${typeof item === 'object' && item ? summarize(item) : String(item)}`)
+                .join('\n');
+        }
+    }
+    // Detail object or fallback
+    return cleanJson(obj);
+}
+function summarize(item) {
+    const parts = [];
+    // Identifier
+    if (item.type && item.number)
+        parts.push(`${item.type} ${item.number}`);
+    else if (item.citation)
+        parts.push(String(item.citation));
+    else if (item.id)
+        parts.push(String(item.id));
+    // Name
+    const name = item.title ?? item.name ?? item.fullName ?? item.directOrderName ?? item.description;
+    if (name)
+        parts.push(stripHtml(String(name)).slice(0, 200));
+    // Status
+    if (typeof item.latestAction === 'object' && item.latestAction) {
+        const a = item.latestAction;
+        parts.push(`[${a.actionDate}: ${a.text}]`);
+    }
+    else if (item.actionDate && item.text) {
+        parts.push(`${item.actionDate}: ${stripHtml(String(item.text)).slice(0, 150)}`);
+    }
+    return parts.join(' — ') || JSON.stringify(item).slice(0, 300);
+}
+function cleanJson(value) {
+    return JSON.stringify(value, (_key, val) => (typeof val === 'string' && val.includes('<') ? stripHtml(val) : val), 2);
+}
+function stripHtml(html) {
+    return html
+        .replace(/<[^>]*>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&#039;/g, "'")
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=format-helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-helpers.ts"],"names":[],"mappings":"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"}

package/dist/services/congress-api/congress-api-service.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview Congress.gov API v3 client — auth, pagination, rate limiting, response normalization.
+ * @module services/congress-api/congress-api-service
+ */
+import type { BillSubResourceParams, CommitteeSubResourceParams, CongressDetail, GetBillParams, GetCommitteeReportParams, GetCrsReportParams, GetDailyArticlesParams, GetDailyIssuesParams, GetLawParams, GetMemberLegislationParams, GetVoteParams, ListBillsParams, ListCommitteeReportsParams, ListCommitteesParams, ListDailyRecordParams, ListLawsParams, ListMembersParams, ListNominationsParams, ListSummariesParams, ListVotesParams, NominationSubResourceParams, Pagination, PaginationParams } from './types.js';
+interface FetchListResult {
+    data: unknown[];
+    pagination: Pagination;
+    [key: string]: unknown;
+}
+export declare class CongressApiService {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private requestCount;
+    private windowStart;
+    constructor();
+    listBills(params: ListBillsParams): Promise<FetchListResult>;
+    getBill(params: GetBillParams): Promise<{
+        bill: unknown;
+    }>;
+    getBillSubResource(params: BillSubResourceParams): Promise<FetchListResult>;
+    listLaws(params: ListLawsParams): Promise<FetchListResult>;
+    getLaw(params: GetLawParams): Promise<{
+        law: unknown;
+    }>;
+    listMembers(params: ListMembersParams): Promise<FetchListResult>;
+    getMember(bioguideId: string): Promise<{
+        member: unknown;
+    }>;
+    getMemberLegislation(params: GetMemberLegislationParams): Promise<FetchListResult>;
+    listCommittees(params: ListCommitteesParams): Promise<FetchListResult>;
+    getCommittee(chamber: string, committeeCode: string): Promise<{
+        committee: unknown;
+    }>;
+    getCommitteeSubResource(params: CommitteeSubResourceParams): Promise<FetchListResult>;
+    listVotes(params: ListVotesParams): Promise<FetchListResult>;
+    getVote(params: GetVoteParams): Promise<{
+        vote: unknown;
+    }>;
+    getVoteMembers(params: GetVoteParams): Promise<{
+        vote: unknown;
+    }>;
+    listNominations(params: ListNominationsParams): Promise<FetchListResult>;
+    getNomination(congress: number, nominationNumber: string): Promise<{
+        nomination: unknown;
+    }>;
+    getNominee(congress: number, nominationNumber: string, ordinal: number, params?: PaginationParams): Promise<FetchListResult>;
+    getNominationSubResource(params: NominationSubResourceParams): Promise<FetchListResult>;
+    listSummaries(params: ListSummariesParams): Promise<FetchListResult>;
+    listCrsReports(params?: PaginationParams): Promise<FetchListResult>;
+    getCrsReport(params: GetCrsReportParams): Promise<{
+        report: unknown;
+    }>;
+    listCommitteeReports(params: ListCommitteeReportsParams): Promise<FetchListResult>;
+    getCommitteeReport(params: GetCommitteeReportParams): Promise<{
+        report: unknown;
+    }>;
+    getCommitteeReportText(params: GetCommitteeReportParams): Promise<{
+        text: unknown;
+    }>;
+    listDailyRecord(params?: ListDailyRecordParams): Promise<FetchListResult>;
+    getDailyIssues(params: GetDailyIssuesParams): Promise<FetchListResult>;
+    getDailyArticles(params: GetDailyArticlesParams): Promise<FetchListResult>;
+    getCurrentCongress(): Promise<CongressDetail>;
+    getCongress(congress: number): Promise<CongressDetail>;
+    private fetchList;
+    private extractPagination;
+    private get;
+    private checkRateLimit;
+    private inferListKey;
+}
+export declare function initCongressApi(): void;
+export declare function getCongressApi(): CongressApiService;
+export {};
+//# sourceMappingURL=congress-api-service.d.ts.map

package/dist/services/congress-api/congress-api-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"congress-api-service.d.ts","sourceRoot":"","sources":["../../../src/services/congress-api/congress-api-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EAEd,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,UAAU,eAAe;IACvB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAOD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAc;;IAUjC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAOtD,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAKhE,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ3E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAOpD,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IAO7D,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAa1D,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAKjE,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC;IAQlF,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAQhE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAK3F,uBAAuB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC;IAQrF,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAQtD,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAO1D,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IASvE,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlE,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAKnC,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAQ3B,wBAAwB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;IAQvF,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAUpE,cAAc,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI7D,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAO5E,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC;IAO5E,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAgBlF,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAS1F,eAAe,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzE,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAQtE,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAOpE,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC;IAK7C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAO9C,SAAS;IAwBvB,OAAO,CAAC,iBAAiB;YAaX,GAAG;IAkDjB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,YAAY;CAmBrB;AAQD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAInD"}

package/dist/services/congress-api/congress-api-service.js

@@ -0,0 +1,292 @@
+/**
+ * @fileoverview Congress.gov API v3 client — auth, pagination, rate limiting, response normalization.
+ * @module services/congress-api/congress-api-service
+ */
+import { notFound, rateLimited, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { getServerConfig } from '../../config/server-config.js';
+const MAX_RETRIES = 3;
+const BASE_BACKOFF_MS = 1000;
+const RATE_LIMIT_WINDOW_MS = 60 * 60 * 1000;
+const RATE_LIMIT_MAX = 5000;
+export class CongressApiService {
+    apiKey;
+    baseUrl;
+    requestCount = 0;
+    windowStart = Date.now();
+    constructor() {
+        const config = getServerConfig();
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+    }
+    // --- Bills ---
+    listBills(params) {
+        const path = params.billType
+            ? `/bill/${params.congress}/${params.billType}`
+            : `/bill/${params.congress}`;
+        return this.fetchList(path, 'bills', params);
+    }
+    async getBill(params) {
+        const data = await this.get(`/bill/${params.congress}/${params.billType}/${params.billNumber}`);
+        return { bill: data.bill };
+    }
+    getBillSubResource(params) {
+        const path = `/bill/${params.congress}/${params.billType}/${params.billNumber}/${params.subResource}`;
+        const key = this.inferListKey(params.subResource);
+        return this.fetchList(path, key, params);
+    }
+    // --- Laws ---
+    listLaws(params) {
+        const path = params.lawType
+            ? `/law/${params.congress}/${params.lawType}`
+            : `/law/${params.congress}`;
+        return this.fetchList(path, 'bills', params);
+    }
+    async getLaw(params) {
+        const data = await this.get(`/law/${params.congress}/${params.lawType}/${params.lawNumber}`);
+        return { law: data.law };
+    }
+    // --- Members ---
+    listMembers(params) {
+        let path = '/member';
+        if (params.congress)
+            path = `/member/congress/${params.congress}`;
+        if (params.stateCode) {
+            path = `/member/${params.stateCode}`;
+            if (params.district !== undefined)
+                path += `/${params.district}`;
+        }
+        const query = {};
+        if (params.currentMember !== undefined)
+            query.currentMember = params.currentMember ? 'true' : 'false';
+        return this.fetchList(path, 'members', params, query);
+    }
+    async getMember(bioguideId) {
+        const data = await this.get(`/member/${bioguideId}`);
+        return { member: data.member };
+    }
+    getMemberLegislation(params) {
+        const path = `/member/${params.bioguideId}/${params.type}`;
+        const key = params.type.replace('-legislation', 'Legislation');
+        return this.fetchList(path, key, params);
+    }
+    // --- Committees ---
+    listCommittees(params) {
+        let path = '/committee';
+        if (params.congress && params.chamber)
+            path = `/committee/${params.congress}/${params.chamber}`;
+        else if (params.congress)
+            path = `/committee/${params.congress}`;
+        else if (params.chamber)
+            path = `/committee/${params.chamber}`;
+        return this.fetchList(path, 'committees', params);
+    }
+    async getCommittee(chamber, committeeCode) {
+        const data = await this.get(`/committee/${chamber}/${committeeCode}`);
+        return { committee: data.committee };
+    }
+    getCommitteeSubResource(params) {
+        const path = `/committee/${params.chamber}/${params.committeeCode}/${params.subResource}`;
+        const key = this.inferListKey(params.subResource);
+        return this.fetchList(path, key, params);
+    }
+    // --- Votes ---
+    listVotes(params) {
+        return this.fetchList(`/house-vote/${params.congress}/${params.session}`, 'houseRollCallVotes', params);
+    }
+    async getVote(params) {
+        const data = await this.get(`/house-vote/${params.congress}/${params.session}/${params.voteNumber}`);
+        return { vote: data.houseRollCallVote ?? data };
+    }
+    async getVoteMembers(params) {
+        const data = await this.get(`/house-vote/${params.congress}/${params.session}/${params.voteNumber}/members`);
+        return { vote: data.houseRollCallVoteMemberVotes ?? data };
+    }
+    // --- Nominations ---
+    listNominations(params) {
+        return this.fetchList(`/nomination/${params.congress}`, 'nominations', params);
+    }
+    async getNomination(congress, nominationNumber) {
+        const data = await this.get(`/nomination/${congress}/${nominationNumber}`);
+        return { nomination: data.nomination };
+    }
+    getNominee(congress, nominationNumber, ordinal, params) {
+        return this.fetchList(`/nomination/${congress}/${nominationNumber}/${ordinal}`, 'nominees', params);
+    }
+    getNominationSubResource(params) {
+        const path = `/nomination/${params.congress}/${params.nominationNumber}/${params.subResource}`;
+        const key = this.inferListKey(params.subResource);
+        return this.fetchList(path, key, params);
+    }
+    // --- Summaries ---
+    listSummaries(params) {
+        let path = '/summaries';
+        if (params.congress && params.billType)
+            path = `/summaries/${params.congress}/${params.billType}`;
+        else if (params.congress)
+            path = `/summaries/${params.congress}`;
+        return this.fetchList(path, 'summaries', params);
+    }
+    // --- CRS Reports ---
+    listCrsReports(params) {
+        return this.fetchList('/crsreport', 'CRSReports', params);
+    }
+    async getCrsReport(params) {
+        const data = await this.get(`/crsreport/${params.reportNumber}`);
+        return { report: data.CRSReport ?? data };
+    }
+    // --- Committee Reports ---
+    listCommitteeReports(params) {
+        const path = params.reportType
+            ? `/committee-report/${params.congress}/${params.reportType}`
+            : `/committee-report/${params.congress}`;
+        return this.fetchList(path, 'reports', params);
+    }
+    async getCommitteeReport(params) {
+        const data = await this.get(`/committee-report/${params.congress}/${params.reportType}/${params.reportNumber}`);
+        const reports = data.committeeReports;
+        const report = Array.isArray(reports) ? reports[0] : (reports ?? data);
+        if (!report || (typeof report === 'object' && Object.keys(report).length === 0)) {
+            throw notFound('Committee report not found', {
+                congress: params.congress,
+                reportType: params.reportType,
+                reportNumber: params.reportNumber,
+            });
+        }
+        return { report };
+    }
+    async getCommitteeReportText(params) {
+        const data = await this.get(`/committee-report/${params.congress}/${params.reportType}/${params.reportNumber}/text`);
+        return { text: data.text ?? data['text-versions'] ?? data };
+    }
+    // --- Daily Congressional Record ---
+    listDailyRecord(params) {
+        return this.fetchList('/daily-congressional-record', 'dailyCongressionalRecord', params);
+    }
+    getDailyIssues(params) {
+        return this.fetchList(`/daily-congressional-record/${params.volumeNumber}`, 'dailyCongressionalRecord', params);
+    }
+    getDailyArticles(params) {
+        const path = `/daily-congressional-record/${params.volumeNumber}/${params.issueNumber}/articles`;
+        return this.fetchList(path, 'articles', params);
+    }
+    // --- Congress metadata ---
+    async getCurrentCongress() {
+        const data = await this.get('/congress/current');
+        return data.congress;
+    }
+    async getCongress(congress) {
+        const data = await this.get(`/congress/${congress}`);
+        return data.congress;
+    }
+    // --- Internal ---
+    async fetchList(path, listKey, params, extraQuery) {
+        const query = { ...extraQuery };
+        if (params?.limit)
+            query.limit = String(params.limit);
+        if (params?.offset)
+            query.offset = String(params.offset);
+        if (params?.fromDateTime)
+            query.fromDateTime = params.fromDateTime;
+        if (params?.toDateTime)
+            query.toDateTime = params.toDateTime;
+        const data = await this.get(path, query);
+        const raw = data[listKey];
+        // Some endpoints (e.g. committee-bills) nest the array inside an object — unwrap it.
+        const items = Array.isArray(raw)
+            ? raw
+            : raw && typeof raw === 'object'
+                ? (Object.values(raw).find(Array.isArray) ?? [])
+                : [];
+        const pagination = this.extractPagination(data.pagination, items.length, params);
+        return { data: items, pagination };
+    }
+    extractPagination(raw, itemCount, params) {
+        const count = raw?.count ?? itemCount;
+        const currentOffset = params?.offset ?? 0;
+        const limit = params?.limit ?? 20;
+        const nextOffset = raw?.next ? currentOffset + limit : null;
+        return { count, nextOffset };
+    }
+    // biome-ignore lint/suspicious/noExplicitAny: API responses are dynamic JSON
+    async get(path, query) {
+        this.checkRateLimit();
+        const url = new URL(`${this.baseUrl}${path}`);
+        url.searchParams.set('format', 'json');
+        url.searchParams.set('api_key', this.apiKey);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined && v !== '')
+                    url.searchParams.set(k, v);
+            }
+        }
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            const res = await fetch(url.toString(), {
+                headers: { Accept: 'application/json' },
+            });
+            if (res.status === 429) {
+                throw rateLimited('Congress.gov API rate limit reached (5,000 requests/hour). Wait before retrying — the limit resets hourly.');
+            }
+            if (res.status >= 500) {
+                const body = await res.text().catch(() => '');
+                // The API returns 500 instead of 404 for some nonexistent entities —
+                // these have structured JSON error bodies vs. empty/HTML for real outages
+                if (body.includes('"error"')) {
+                    throw new Error(`Congress.gov API returned HTTP ${res.status}: ${body}`);
+                }
+                if (attempt < MAX_RETRIES - 1) {
+                    await sleep(BASE_BACKOFF_MS * 2 ** attempt);
+                    continue;
+                }
+                throw serviceUnavailable(`Congress.gov API returned HTTP ${res.status} after ${MAX_RETRIES} attempts.`, { status: res.status });
+            }
+            if (!res.ok) {
+                const body = await res.text().catch(() => '');
+                throw new Error(`Congress.gov API returned HTTP ${res.status}: ${body || res.statusText}`);
+            }
+            this.requestCount++;
+            return res.json();
+        }
+    }
+    checkRateLimit() {
+        const now = Date.now();
+        if (now - this.windowStart > RATE_LIMIT_WINDOW_MS) {
+            this.windowStart = now;
+            this.requestCount = 0;
+        }
+        if (this.requestCount >= RATE_LIMIT_MAX) {
+            throw rateLimited('Congress.gov API rate limit reached (5,000 requests/hour). Wait before retrying — the limit resets hourly.');
+        }
+    }
+    inferListKey(subResource) {
+        const mapping = {
+            actions: 'actions',
+            amendments: 'amendments',
+            articles: 'articles',
+            bills: 'committee-bills',
+            committees: 'committees',
+            cosponsors: 'cosponsors',
+            hearings: 'hearings',
+            nominations: 'nominations',
+            relatedbills: 'relatedBills',
+            reports: 'reports',
+            subjects: 'subjects',
+            summaries: 'summaries',
+            text: 'textVersions',
+            titles: 'titles',
+        };
+        return mapping[subResource] ?? subResource;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+let _service;
+export function initCongressApi() {
+    _service = new CongressApiService();
+}
+export function getCongressApi() {
+    if (!_service)
+        throw new Error('CongressApiService not initialized — call initCongressApi() in setup()');
+    return _service;
+}
+//# sourceMappingURL=congress-api-service.js.map

package/dist/services/congress-api/congress-api-service.js.map

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

package/dist/services/congress-api/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Types for Congress.gov API v3 responses.
+ * @module services/congress-api/types
+ */
+/** Shared pagination metadata returned by list endpoints. */
+export interface Pagination {
+    count: number;
+    nextOffset: number | null;
+}
+/** Standard pagination query params. */
+export interface PaginationParams {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}
+/** Date range filter params. */
+export interface DateRangeParams {
+    fromDateTime?: string | undefined;
+    toDateTime?: string | undefined;
+}
+export type BillType = 'hr' | 's' | 'hjres' | 'sjres' | 'hconres' | 'sconres' | 'hres' | 'sres';
+export type BillSubResource = 'actions' | 'amendments' | 'cosponsors' | 'committees' | 'subjects' | 'summaries' | 'text' | 'titles' | 'relatedbills';
+export interface ListBillsParams extends PaginationParams, DateRangeParams {
+    billType?: BillType | undefined;
+    congress: number;
+}
+export interface GetBillParams {
+    billNumber: number;
+    billType: BillType;
+    congress: number;
+}
+export interface BillSubResourceParams extends GetBillParams, PaginationParams {
+    subResource: BillSubResource;
+}
+export type LawType = 'pub' | 'priv';
+export interface ListLawsParams extends PaginationParams {
+    congress: number;
+    lawType?: LawType | undefined;
+}
+export interface GetLawParams {
+    congress: number;
+    lawNumber: number;
+    lawType: LawType;
+}
+export interface ListMembersParams extends PaginationParams {
+    congress?: number | undefined;
+    currentMember?: boolean | undefined;
+    district?: number | undefined;
+    stateCode?: string | undefined;
+}
+export interface GetMemberLegislationParams extends PaginationParams {
+    bioguideId: string;
+    type: 'sponsored-legislation' | 'cosponsored-legislation';
+}
+export type Chamber = 'house' | 'senate' | 'joint';
+export type CommitteeSubResource = 'bills' | 'reports' | 'nominations';
+export interface ListCommitteesParams extends PaginationParams {
+    chamber?: Chamber | undefined;
+    congress?: number | undefined;
+}
+export interface CommitteeSubResourceParams extends PaginationParams {
+    chamber: Chamber;
+    committeeCode: string;
+    subResource: CommitteeSubResource;
+}
+export interface ListVotesParams extends PaginationParams {
+    congress: number;
+    session: number;
+}
+export interface GetVoteParams {
+    congress: number;
+    session: number;
+    voteNumber: number;
+}
+export type NominationSubResource = 'actions' | 'committees' | 'hearings';
+export interface ListNominationsParams extends PaginationParams {
+    congress: number;
+}
+export interface NominationSubResourceParams extends PaginationParams {
+    congress: number;
+    nominationNumber: string;
+    subResource: NominationSubResource;
+}
+export interface ListSummariesParams extends PaginationParams, DateRangeParams {
+    billType?: BillType | undefined;
+    congress?: number | undefined;
+}
+export interface GetCrsReportParams {
+    reportNumber: string;
+}
+export type CommitteeReportType = 'hrpt' | 'srpt' | 'erpt';
+export interface ListCommitteeReportsParams extends PaginationParams {
+    congress: number;
+    reportType?: CommitteeReportType | undefined;
+}
+export interface GetCommitteeReportParams {
+    congress: number;
+    reportNumber: number;
+    reportType: CommitteeReportType;
+}
+export interface ListDailyRecordParams extends PaginationParams {
+}
+export interface GetDailyIssuesParams extends PaginationParams {
+    volumeNumber: number;
+}
+export interface GetDailyArticlesParams extends PaginationParams {
+    issueNumber: number;
+    volumeNumber: number;
+}
+export interface CongressDetail {
+    congress: number;
+    endYear: number;
+    name: string;
+    sessions: Array<{
+        number: number;
+        chamber: string;
+        type: string;
+        startDate: string;
+        endDate?: string | undefined;
+    }>;
+    startYear: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/congress-api/types.d.ts.map

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

package/dist/services/congress-api/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Types for Congress.gov API v3 responses.
+ * @module services/congress-api/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/congress-api/types.js.map

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