legismcp 0.3.0

package/dist/tools/members/memberSearch.js

@@ -0,0 +1,244 @@
+import { z } from "zod";
+import { getMemberSummary } from "../../utils/member.js";
+/**
+ * Zod schema for member search parameters
+ */
+export const memberSearchParamsSchema = z.object({
+    query: z.string().optional().describe("Search query for member names"),
+    chamber: z.enum(["house", "senate"]).optional().describe("Chamber: 'house' or 'senate'"),
+    state: z.string().optional().describe("Two-letter state code (e.g., 'CA', 'TX')"),
+    party: z.enum(["D", "R", "I"]).optional().describe("Party: 'D' (Democrat), 'R' (Republican), 'I' (Independent)"),
+    currentMember: z.boolean().optional().default(true).describe("Whether to include only current members"),
+    congress: z.string().optional().describe("Specific congress number (e.g., '118')"),
+    limit: z.number().min(1).max(100).optional().default(20).describe("Maximum number of results to return"),
+    offset: z.number().min(0).optional().default(0).describe("Number of results to skip")
+});
+/**
+ * Member search tool with filtering
+ */
+export class MemberSearchTool {
+    constructor(congressApi) {
+        this.congressApi = congressApi;
+    }
+    /**
+     * Search for members with filtering
+     */
+    async searchMembers(params) {
+        try {
+            console.log('Searching members', {
+                query: params.query,
+                chamber: params.chamber,
+                state: params.state,
+                party: params.party
+            });
+            // Build search filters
+            const filters = {};
+            if (params.congress) {
+                filters.congress = params.congress;
+            }
+            if (params.currentMember !== undefined) {
+                filters.currentMember = params.currentMember.toString();
+            }
+            // Over-fetch when local filters are active since the API doesn't support them.
+            // Also over-fetch when query (name) is provided, since the API ignores the query param
+            // for member endpoints and results aren't alphabetical.
+            const hasLocalFilters = !!(params.chamber || params.state || params.party || params.query);
+            const fetchLimit = hasLocalFilters ? 535 : params.limit;
+            // Execute search using CongressApiService — omit query since API ignores it for members
+            const searchResult = await this.congressApi.searchCollection('member', {
+                limit: fetchLimit,
+                offset: params.offset,
+                filters
+            });
+            if (!searchResult.members || searchResult.members.length === 0) {
+                return {
+                    members: [],
+                    totalCount: 0,
+                    searchCriteria: this.formatSearchCriteria(params),
+                    pagination: {
+                        limit: params.limit,
+                        offset: params.offset,
+                        hasMore: false
+                    },
+                    metadata: {
+                        searchedAt: new Date().toISOString(),
+                        congress: params.congress
+                    }
+                };
+            }
+            // Filter results based on local criteria (API may not support all filters)
+            let filteredMembers = this.applyLocalFilters(searchResult.members, params);
+            // Trim to requested limit after local filtering
+            filteredMembers = filteredMembers.slice(0, params.limit);
+            // Add summaries (no extra API calls needed)
+            const membersWithSummaries = filteredMembers.map(member => ({
+                ...member,
+                summary: this.generateMemberSummary(member)
+            }));
+            return {
+                members: membersWithSummaries,
+                totalCount: membersWithSummaries.length,
+                searchCriteria: this.formatSearchCriteria(params),
+                pagination: {
+                    limit: params.limit,
+                    offset: params.offset,
+                    hasMore: hasLocalFilters ? false : (searchResult.pagination?.next ? true : false)
+                },
+                metadata: {
+                    searchedAt: new Date().toISOString(),
+                    congress: params.congress
+                }
+            };
+        }
+        catch (error) {
+            console.error('Error searching members', { error: error.message });
+            throw error;
+        }
+    }
+    /**
+     * Apply local filters that may not be supported by API
+     */
+    applyLocalFilters(members, params) {
+        let filtered = [...members];
+        // Name filtering — API ignores query param for member endpoint.
+        // API returns names in "Last, First" format (e.g., "Cruz, Ted").
+        // Match by checking that all query words appear in at least one name field.
+        if (params.query) {
+            const queryWords = params.query.toLowerCase().split(/\s+/).filter(Boolean);
+            filtered = filtered.filter(member => {
+                const nameFields = [
+                    member.name,
+                    member.directOrderName,
+                    member.invertedOrderName,
+                    member.firstName,
+                    member.lastName,
+                    member.firstName && member.lastName ? `${member.firstName} ${member.lastName}` : null
+                ].filter(Boolean).map((n) => n.toLowerCase());
+                // All query words must appear in at least one name field
+                return queryWords.every(word => nameFields.some(n => n.includes(word)));
+            });
+        }
+        if (params.chamber) {
+            const chamberFull = MemberSearchTool.CHAMBER_MAP[params.chamber.toLowerCase()] || params.chamber;
+            filtered = filtered.filter(member => {
+                // Chamber is in terms.item[].chamber
+                const terms = member.terms?.item;
+                if (!terms || terms.length === 0)
+                    return false;
+                // Check the most recent term
+                const latestTerm = terms[terms.length - 1];
+                return latestTerm.chamber?.toLowerCase() === chamberFull.toLowerCase();
+            });
+        }
+        if (params.state) {
+            const stateFull = MemberSearchTool.STATE_MAP[params.state.toUpperCase()] || params.state;
+            filtered = filtered.filter(member => member.state?.toLowerCase() === stateFull.toLowerCase());
+        }
+        if (params.party) {
+            const partyFull = MemberSearchTool.PARTY_MAP[params.party.toUpperCase()] || params.party;
+            filtered = filtered.filter(member => member.partyName?.toLowerCase() === partyFull.toLowerCase());
+        }
+        return filtered;
+    }
+    /**
+     * Generate member summary
+     */
+    generateMemberSummary(member) {
+        return getMemberSummary(member);
+    }
+    /**
+     * Format search criteria for display
+     */
+    formatSearchCriteria(params) {
+        const criteria = [];
+        if (params.query)
+            criteria.push(`Query: "${params.query}"`);
+        if (params.chamber)
+            criteria.push(`Chamber: ${params.chamber}`);
+        if (params.state)
+            criteria.push(`State: ${params.state}`);
+        if (params.party)
+            criteria.push(`Party: ${params.party}`);
+        if (params.congress)
+            criteria.push(`Congress: ${params.congress}`);
+        if (params.currentMember === false)
+            criteria.push('Including former members');
+        return criteria.length > 0 ? criteria.join(', ') : 'No specific criteria';
+    }
+}
+// Map two-letter state codes to full state names used by Congress.gov API
+MemberSearchTool.STATE_MAP = {
+    AL: 'Alabama', AK: 'Alaska', AZ: 'Arizona', AR: 'Arkansas', CA: 'California',
+    CO: 'Colorado', CT: 'Connecticut', DE: 'Delaware', FL: 'Florida', GA: 'Georgia',
+    HI: 'Hawaii', ID: 'Idaho', IL: 'Illinois', IN: 'Indiana', IA: 'Iowa',
+    KS: 'Kansas', KY: 'Kentucky', LA: 'Louisiana', ME: 'Maine', MD: 'Maryland',
+    MA: 'Massachusetts', MI: 'Michigan', MN: 'Minnesota', MS: 'Mississippi', MO: 'Missouri',
+    MT: 'Montana', NE: 'Nebraska', NV: 'Nevada', NH: 'New Hampshire', NJ: 'New Jersey',
+    NM: 'New Mexico', NY: 'New York', NC: 'North Carolina', ND: 'North Dakota', OH: 'Ohio',
+    OK: 'Oklahoma', OR: 'Oregon', PA: 'Pennsylvania', RI: 'Rhode Island', SC: 'South Carolina',
+    SD: 'South Dakota', TN: 'Tennessee', TX: 'Texas', UT: 'Utah', VT: 'Vermont',
+    VA: 'Virginia', WA: 'Washington', WV: 'West Virginia', WI: 'Wisconsin', WY: 'Wyoming',
+    DC: 'District of Columbia', PR: 'Puerto Rico', GU: 'Guam', VI: 'Virgin Islands',
+    AS: 'American Samoa', MP: 'Northern Mariana Islands',
+};
+MemberSearchTool.PARTY_MAP = {
+    D: 'Democratic', R: 'Republican', I: 'Independent',
+};
+MemberSearchTool.CHAMBER_MAP = {
+    house: 'House of Representatives', senate: 'Senate',
+};
+/**
+ * Handle member search tool execution
+ */
+export async function handleMemberSearch(params, congressApi) {
+    try {
+        const tool = new MemberSearchTool(congressApi);
+        const result = await tool.searchMembers(params);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    }
+    catch (error) {
+        console.error('Error in handleMemberSearch:', error);
+        return {
+            content: [{
+                    type: "text",
+                    text: `Failed to search members: ${error instanceof Error ? error.message : String(error)}`
+                }],
+            isError: true
+        };
+    }
+}
+// Export constants for tool registration
+export const TOOL_NAME = "member-search";
+export const TOOL_DESCRIPTION = `Search for members of Congress with filtering.
+
+Use this tool to find members by name, state, party, or chamber. This is the
+starting point for member-related queries like "Who represents Texas?" or
+"Find Ted Cruz". Use the returned bioguideId with member-details for full info.
+
+Filtering capabilities:
+- Name-based search with partial matching
+- Chamber filtering (House/Senate)
+- State and party filtering
+- Current/former member filtering
+
+Examples:
+- Search by name: query = "Pelosi"
+- Search by state: state = "CA"
+- Search House Republicans: chamber = "house", party = "R"
+- Search former members: currentMember = false`;
+export const TOOL_PARAMS = {
+    query: z.string().optional().describe("Search query for member names"),
+    chamber: z.enum(["house", "senate"]).optional().describe("Chamber: 'house' or 'senate'"),
+    state: z.string().optional().describe("Two-letter state code (e.g., 'CA', 'TX')"),
+    party: z.enum(["D", "R", "I"]).optional().describe("Party: 'D' (Democrat), 'R' (Republican), 'I' (Independent)"),
+    currentMember: z.boolean().optional().default(true).describe("Whether to include only current members"),
+    congress: z.string().optional().describe("Specific congress number (e.g., '118')"),
+    limit: z.number().min(1).max(100).optional().default(20).describe("Maximum number of results to return"),
+    offset: z.number().min(0).optional().default(0).describe("Number of results to skip")
+};
+//# sourceMappingURL=memberSearch.js.map

package/dist/tools/members/memberSearch.js.map

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

package/dist/tools/subresource/subresourceTool.d.ts

@@ -0,0 +1,56 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { CongressApiService } from "../../services/CongressApiService.js";
+/**
+ * Zod schema for subresource parameters
+ */
+export declare const subresourceParamsSchema: z.ZodObject<{
+    parentUri: z.ZodString;
+    subresource: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["detailed", "summary", "raw"]>>>;
+}, "strip", z.ZodTypeAny, {
+    format: "detailed" | "summary" | "raw";
+    limit: number;
+    offset: number;
+    parentUri: string;
+    subresource: string;
+}, {
+    parentUri: string;
+    subresource: string;
+    format?: "detailed" | "summary" | "raw" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type SubresourceParams = z.infer<typeof subresourceParamsSchema>;
+/**
+ * Subresource tool — fetches sub-resource data and returns raw items
+ */
+export declare class SubresourceTool {
+    private congressApi;
+    constructor(congressApi: CongressApiService);
+    /**
+     * Get subresource data
+     */
+    getSubresource(params: SubresourceParams): Promise<any>;
+    /**
+     * Parse parent URI to extract resource information
+     */
+    private parseParentUri;
+    private extractItems;
+}
+/**
+ * Handle subresource tool execution
+ */
+export declare function handleSubresource(params: SubresourceParams, congressApi: CongressApiService): Promise<CallToolResult>;
+export declare const TOOL_NAME = "subresource";
+export declare const TOOL_DESCRIPTION = "Get detailed subresource data for a legislative resource.\n\nSupports all legislative subresources including:\n- Bill subresources: actions, cosponsors, committees, subjects, text, amendments, summaries\n- Member subresources: sponsored-legislation, cosponsored-legislation, committees\n- Committee subresources: bills, reports, members\n\nOutput formats:\n- detailed: Items array with count (default)\n- summary: Items array with count\n- raw: Unprocessed API response\n\nExamples:\n- Get bill actions: parentUri = \"congress-gov:/bill/118/hr/1\", subresource = \"actions\"\n- Get member committees: parentUri = \"congress-gov:/member/P000197\", subresource = \"committees\"\n- Raw format: parentUri = \"congress-gov:/bill/118/hr/1\", subresource = \"cosponsors\", format = \"raw\"\n- With pagination: parentUri = \"congress-gov:/bill/118/hr/1\", subresource = \"actions\", limit = 50, offset = 0";
+export declare const TOOL_PARAMS: {
+    parentUri: z.ZodString;
+    subresource: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["detailed", "summary", "raw"]>>>;
+};
+//# sourceMappingURL=subresourceTool.d.ts.map

package/dist/tools/subresource/subresourceTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subresourceTool.d.ts","sourceRoot":"","sources":["../../../src/tools/subresource/subresourceTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG1E;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAMlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,kBAAkB;IAEnD;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC;IAqD7D;;OAEG;IACH,OAAO,CAAC,cAAc;IA2DtB,OAAO,CAAC,YAAY;CAqCrB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAsBzB;AAGD,eAAO,MAAM,SAAS,gBAAgB,CAAC;AACvC,eAAO,MAAM,gBAAgB,s4BAgBiF,CAAC;AAE/G,eAAO,MAAM,WAAW;;;;;;CAMvB,CAAC"}

package/dist/tools/subresource/subresourceTool.js

@@ -0,0 +1,209 @@
+import { z } from "zod";
+import { ValidationError } from "../../utils/errors.js";
+/**
+ * Zod schema for subresource parameters
+ */
+export const subresourceParamsSchema = z.object({
+    parentUri: z.string().min(1).describe("Parent resource URI (e.g., 'congress-gov:/bill/118/hr/1')"),
+    subresource: z.string().min(1).describe("Subresource name (e.g., 'actions', 'cosponsors', 'committees')"),
+    limit: z.number().min(1).max(100).optional().default(20).describe("Maximum number of results to return"),
+    offset: z.number().min(0).optional().default(0).describe("Number of results to skip"),
+    format: z.enum(["detailed", "summary", "raw"]).optional().default("detailed").describe("Output format: 'raw' returns API response unchanged, 'detailed' and 'summary' return items with count")
+});
+/**
+ * Subresource tool — fetches sub-resource data and returns raw items
+ */
+export class SubresourceTool {
+    constructor(congressApi) {
+        this.congressApi = congressApi;
+    }
+    /**
+     * Get subresource data
+     */
+    async getSubresource(params) {
+        try {
+            console.log('Fetching subresource', {
+                parentUri: params.parentUri,
+                subresource: params.subresource
+            });
+            // Validate parent URI
+            const cleanUri = params.parentUri.replace(/^congress-gov:\/\/?/, '');
+            if (!cleanUri || cleanUri.split('/').length < 1) {
+                throw new ValidationError(`Invalid parent URI format: ${params.parentUri}`);
+            }
+            // Fetch subresource data using CongressApiService
+            const subresourceData = await this.congressApi.getSubResource(params.parentUri, params.subresource, { limit: params.limit, offset: params.offset });
+            // Parse parent URI for context
+            const parentInfo = this.parseParentUri(params.parentUri);
+            // Format the data
+            const format = params.format || 'detailed';
+            let data;
+            if (format === 'raw') {
+                data = subresourceData;
+            }
+            else {
+                const items = this.extractItems(subresourceData, params.subresource);
+                data = { count: items.length, items };
+            }
+            return {
+                parentResource: parentInfo,
+                subresource: params.subresource,
+                data,
+                metadata: {
+                    fetchedAt: new Date().toISOString(),
+                    format,
+                    pagination: {
+                        limit: params.limit,
+                        offset: params.offset
+                    }
+                }
+            };
+        }
+        catch (error) {
+            console.error('Error fetching subresource', { error: error.message });
+            throw error;
+        }
+    }
+    /**
+     * Parse parent URI to extract resource information
+     */
+    parseParentUri(uri) {
+        try {
+            const cleanUri = uri.replace(/^congress-gov:\/\/?/, '');
+            const parts = cleanUri.split('/');
+            if (parts.length < 1)
+                return null;
+            const collection = parts[0];
+            const resourceInfo = {
+                collection,
+                path: `/${cleanUri}`,
+                identifiers: {}
+            };
+            switch (collection) {
+                case 'bill':
+                    if (parts.length >= 4) {
+                        resourceInfo.identifiers = {
+                            congress: parts[1],
+                            billType: parts[2],
+                            billNumber: parts[3]
+                        };
+                    }
+                    break;
+                case 'amendment':
+                    if (parts.length >= 4) {
+                        resourceInfo.identifiers = {
+                            congress: parts[1],
+                            amendmentType: parts[2],
+                            amendmentNumber: parts[3]
+                        };
+                    }
+                    break;
+                case 'member':
+                    if (parts.length >= 2) {
+                        resourceInfo.identifiers = {
+                            memberId: parts[1],
+                            congress: parts[2]
+                        };
+                    }
+                    break;
+                case 'committee':
+                    if (parts.length >= 3) {
+                        resourceInfo.identifiers = {
+                            chamber: parts[1],
+                            committeeCode: parts[2],
+                            congress: parts[3]
+                        };
+                    }
+                    break;
+            }
+            return resourceInfo;
+        }
+        catch (error) {
+            console.error('Error parsing parent URI:', error);
+            return null;
+        }
+    }
+    extractItems(data, subresource) {
+        if (!data)
+            return [];
+        const dataMapping = {
+            'actions': 'actions',
+            'cosponsors': 'cosponsors',
+            'committees': 'committees',
+            'subjects': 'subjects',
+            'text': 'text',
+            'amendments': 'amendments',
+            'related-bills': 'relatedBills',
+            'summaries': 'summaries',
+            'titles': 'titles',
+            'sponsored-legislation': 'sponsoredLegislation',
+            'cosponsored-legislation': 'cosponsoredLegislation'
+        };
+        const propertyName = dataMapping[subresource] || subresource;
+        if (Array.isArray(data[propertyName])) {
+            return data[propertyName];
+        }
+        if (data[propertyName] && Array.isArray(data[propertyName][propertyName])) {
+            return data[propertyName][propertyName];
+        }
+        if (Array.isArray(data)) {
+            return data;
+        }
+        if (subresource === 'subjects' && data.subjects) {
+            return [data.subjects];
+        }
+        return [];
+    }
+}
+/**
+ * Handle subresource tool execution
+ */
+export async function handleSubresource(params, congressApi) {
+    try {
+        const tool = new SubresourceTool(congressApi);
+        const result = await tool.getSubresource(params);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(result, null, 2)
+                }]
+        };
+    }
+    catch (error) {
+        console.error('Error in handleSubresource:', error);
+        return {
+            content: [{
+                    type: "text",
+                    text: `Failed to get subresource: ${error instanceof Error ? error.message : String(error)}`
+                }],
+            isError: true
+        };
+    }
+}
+// Export constants for tool registration
+export const TOOL_NAME = "subresource";
+export const TOOL_DESCRIPTION = `Get detailed subresource data for a legislative resource.
+
+Supports all legislative subresources including:
+- Bill subresources: actions, cosponsors, committees, subjects, text, amendments, summaries
+- Member subresources: sponsored-legislation, cosponsored-legislation, committees
+- Committee subresources: bills, reports, members
+
+Output formats:
+- detailed: Items array with count (default)
+- summary: Items array with count
+- raw: Unprocessed API response
+
+Examples:
+- Get bill actions: parentUri = "congress-gov:/bill/118/hr/1", subresource = "actions"
+- Get member committees: parentUri = "congress-gov:/member/P000197", subresource = "committees"
+- Raw format: parentUri = "congress-gov:/bill/118/hr/1", subresource = "cosponsors", format = "raw"
+- With pagination: parentUri = "congress-gov:/bill/118/hr/1", subresource = "actions", limit = 50, offset = 0`;
+export const TOOL_PARAMS = {
+    parentUri: z.string().min(1).describe("Parent resource URI (e.g., 'congress-gov:/bill/118/hr/1')"),
+    subresource: z.string().min(1).describe("Subresource name (e.g., 'actions', 'cosponsors', 'committees')"),
+    limit: z.number().min(1).max(100).optional().default(20).describe("Maximum number of results to return"),
+    offset: z.number().min(0).optional().default(0).describe("Number of results to skip"),
+    format: z.enum(["detailed", "summary", "raw"]).optional().default("detailed").describe("Output format: 'raw' returns API response unchanged, 'detailed' and 'summary' return items with count")
+};
+//# sourceMappingURL=subresourceTool.js.map

package/dist/tools/subresource/subresourceTool.js.map

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

package/dist/tools/trending/trendingBillsTool.d.ts

@@ -0,0 +1,44 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { CongressApiService } from "../../services/CongressApiService.js";
+/**
+ * Zod schema for trending bills parameters
+ */
+export declare const trendingBillsParamsSchema: z.ZodObject<{
+    timeframe: z.ZodDefault<z.ZodOptional<z.ZodEnum<["week", "month", "quarter", "year"]>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    congress: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    timeframe: "week" | "month" | "quarter" | "year";
+    congress?: number | undefined;
+}, {
+    congress?: number | undefined;
+    limit?: number | undefined;
+    timeframe?: "week" | "month" | "quarter" | "year" | undefined;
+}>;
+export type TrendingBillsParams = z.infer<typeof trendingBillsParamsSchema>;
+/**
+ * Trending bills tool — fetches recently active bills with sub-resource data
+ */
+export declare class TrendingBillsTool {
+    private congressApi;
+    constructor(congressApi: CongressApiService);
+    /**
+     * Get recently active bills with sub-resource data
+     */
+    getTrendingBills(params: TrendingBillsParams): Promise<any>;
+    /**
+     * Fetch recent bills sorted by updateDate
+     */
+    private fetchRecentBills;
+    /**
+     * Enhance bills with sub-resource data using parallel fetching
+     */
+    private enhanceBillsWithData;
+}
+/**
+ * Handle trending bills tool execution
+ */
+export declare function handleTrendingBills(params: TrendingBillsParams, congressApi: CongressApiService): Promise<CallToolResult>;
+//# sourceMappingURL=trendingBillsTool.d.ts.map

package/dist/tools/trending/trendingBillsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trendingBillsTool.d.ts","sourceRoot":"","sources":["../../../src/tools/trending/trendingBillsTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG1E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,kBAAkB;IAEnD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC;IAkCjE;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;YACW,oBAAoB;CAqDnC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAAC,cAAc,CAAC,CAsBzB"}