promptspeak-mcp-server 0.1.0

package/dist/government/adapters/usaspending-adapter.js

@@ -0,0 +1,455 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * USASPENDING.GOV API ADAPTER
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Adapter for querying federal spending data from USASpending.gov API.
+ * API Documentation: https://api.usaspending.gov/api/v2/
+ *
+ * Key Features:
+ *   - Search spending by award
+ *   - Get award details
+ *   - Search by recipient (contractor)
+ *   - Query by NAICS/PSC codes
+ *
+ * Rate Limit: 30 requests per minute (no authentication required)
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { BaseGovernmentAdapter, DEFAULT_RETRY_CONFIG, DEFAULT_CACHE_CONFIG, AdapterError, success, failure, fromError, } from './base-adapter.js';
+export const DEFAULT_USASPENDING_CONFIG = {
+    baseUrl: 'https://api.usaspending.gov/api/v2',
+    timeoutMs: 30000,
+    rateLimit: {
+        requestsPerMinute: 30,
+        minDelayMs: 100,
+    },
+    cache: {
+        ...DEFAULT_CACHE_CONFIG,
+        ttlMs: 4 * 60 * 60 * 1000, // 4 hours - spending data updates daily
+    },
+    retry: DEFAULT_RETRY_CONFIG,
+};
+// ═══════════════════════════════════════════════════════════════════════════════
+// USASPENDING ADAPTER
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Adapter for USASpending.gov federal spending data.
+ */
+export class USASpendingAdapter extends BaseGovernmentAdapter {
+    constructor(config) {
+        super({ ...DEFAULT_USASPENDING_CONFIG, ...config });
+    }
+    getAdapterName() {
+        return 'USASpending';
+    }
+    getCacheKey(params) {
+        const normalized = JSON.stringify(params, Object.keys(params).sort());
+        return `usaspending:${Buffer.from(normalized).toString('base64').slice(0, 32)}`;
+    }
+    parseResponse(data) {
+        const award = data;
+        return this.normalizeAwardDetail(award);
+    }
+    /**
+     * Look up a specific award by its ID.
+     * Returns Result<LookupResult<USASpendingAwardRecord>> for type-safe error handling.
+     */
+    async lookup(params) {
+        const startTime = Date.now();
+        const { awardId } = params;
+        if (!awardId) {
+            return failure('VALIDATION_ERROR', 'Award ID is required', {
+                metadata: { executionTimeMs: Date.now() - startTime },
+            });
+        }
+        const cacheKey = this.getCacheKey({ awardId });
+        try {
+            // Check cache first
+            const cached = this.cache.get(cacheKey);
+            if (cached) {
+                return success({
+                    success: true,
+                    data: cached,
+                    fromCache: true,
+                    timestamp: new Date().toISOString(),
+                    source: 'usaspending',
+                }, { executionTimeMs: Date.now() - startTime, cacheHit: true });
+            }
+            // Fetch from API
+            const award = await this.getAwardById(awardId);
+            return success({
+                success: true,
+                data: award,
+                fromCache: false,
+                timestamp: new Date().toISOString(),
+                source: 'usaspending',
+            }, { executionTimeMs: Date.now() - startTime, cacheHit: false });
+        }
+        catch (error) {
+            return fromError(error, 'ADAPTER_ERROR');
+        }
+    }
+    /**
+     * Batch lookup multiple awards.
+     */
+    async lookupBatch(paramsList) {
+        const results = new Map();
+        const errors = new Map();
+        let partialCache = false;
+        for (const params of paramsList) {
+            const result = await this.lookup(params);
+            if (result.success && result.data.data) {
+                results.set(params.awardId, result.data.data);
+                if (result.data.fromCache) {
+                    partialCache = true;
+                }
+            }
+            else if (!result.success) {
+                errors.set(params.awardId, result.error.message || 'Unknown error');
+            }
+        }
+        return {
+            results,
+            errors,
+            totalRequested: paramsList.length,
+            totalSucceeded: results.size,
+            partialCache,
+        };
+    }
+    /**
+     * Search for awards matching the given criteria.
+     */
+    async searchAwards(options) {
+        const { filters, page = 1, limit = 10, sort = 'total_obligation', order = 'desc' } = options;
+        const cacheKey = this.getCacheKey({ type: 'search', filters, page, limit, sort, order });
+        try {
+            const response = await this.makeRequest('/search/spending_by_award/', {
+                method: 'POST',
+                body: {
+                    filters: {
+                        ...this.config.defaultFilters,
+                        ...filters,
+                    },
+                    fields: [
+                        'Award ID',
+                        'Recipient Name',
+                        'Start Date',
+                        'End Date',
+                        'Award Amount',
+                        'Total Outlays',
+                        'Description',
+                        'def_codes',
+                        'COVID-19 Obligations',
+                        'COVID-19 Outlays',
+                        'Infrastructure Obligations',
+                        'Infrastructure Outlays',
+                        'Awarding Agency',
+                        'Awarding Sub Agency',
+                        'Award Type',
+                        'contract_award_type',
+                        'NAICS Code',
+                        'NAICS Description',
+                        'PSC Code',
+                        'PSC Description',
+                        'recipient_id',
+                        'prime_award_recipient_id',
+                    ],
+                    page,
+                    limit,
+                    sort,
+                    order,
+                },
+                cacheKey,
+            });
+            const awards = response.results.map((result) => this.normalizeAwardSummary(result));
+            return {
+                awards,
+                total: response.page_metadata.total,
+                hasMore: response.page_metadata.hasNext,
+            };
+        }
+        catch (error) {
+            if (error instanceof AdapterError) {
+                throw error;
+            }
+            throw new AdapterError(`Failed to search awards: ${error instanceof Error ? error.message : 'Unknown error'}`, {
+                adapterName: this.getAdapterName(),
+                originalError: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Search for awards by recipient name or UEI.
+     */
+    async searchByRecipient(options) {
+        return this.searchAwards({
+            filters: {
+                recipient_search_text: options.recipientSearchText,
+            },
+            page: options.page,
+            limit: options.limit,
+        });
+    }
+    /**
+     * Search for awards by NAICS code.
+     */
+    async searchByNAICS(options) {
+        return this.searchAwards({
+            filters: {
+                naics_codes: [options.naicsCode],
+            },
+            page: options.page,
+            limit: options.limit,
+        });
+    }
+    /**
+     * Search for awards by agency.
+     */
+    async searchByAgency(options) {
+        return this.searchAwards({
+            filters: {
+                agencies: [
+                    {
+                        type: options.type || 'awarding',
+                        tier: options.tier || 'toptier',
+                        name: options.agencyName,
+                    },
+                ],
+            },
+            page: options.page,
+            limit: options.limit,
+        });
+    }
+    /**
+     * Get detailed information for a specific award.
+     */
+    async getAwardById(awardId) {
+        const cacheKey = this.getCacheKey({ type: 'detail', awardId });
+        try {
+            const response = await this.makeRequest(`/awards/${encodeURIComponent(awardId)}/`, {
+                method: 'GET',
+                cacheKey,
+            });
+            return this.normalizeAwardDetail(response);
+        }
+        catch (error) {
+            if (error instanceof AdapterError) {
+                throw error;
+            }
+            throw new AdapterError(`Failed to get award: ${awardId}`, {
+                adapterName: this.getAdapterName(),
+                originalError: error instanceof Error ? error : undefined,
+            });
+        }
+    }
+    /**
+     * Normalize an award summary from search results.
+     */
+    normalizeAwardSummary(summary) {
+        return {
+            awardId: summary.generated_unique_award_id,
+            identifier: summary.piid || summary.fain || summary.uri || '',
+            awardType: summary.type,
+            awardTypeDescription: summary.type_description,
+            description: summary.description,
+            totalObligation: summary.total_obligation,
+            baseAndAllOptionsValue: summary.base_and_all_options_value,
+            recipient: {
+                name: summary.recipient_name,
+                uei: summary.recipient_uei,
+                location: {
+                    city: null,
+                    state: null,
+                    country: null,
+                },
+            },
+            awardingAgency: {
+                name: summary.awarding_agency_name,
+                toptierName: summary.awarding_toptier_agency_name,
+                subtierName: summary.awarding_subtier_agency_name,
+            },
+            fundingAgency: summary.funding_agency_name
+                ? {
+                    name: summary.funding_agency_name,
+                    toptierName: summary.funding_toptier_agency_name,
+                    subtierName: summary.funding_subtier_agency_name,
+                }
+                : null,
+            dates: {
+                signed: summary.action_date,
+                performanceStart: summary.period_of_performance_start_date,
+                performanceEnd: summary.period_of_performance_current_end_date,
+            },
+            naics: {
+                code: summary.naics_code,
+                description: summary.naics_description,
+            },
+            psc: {
+                code: summary.psc_code,
+                description: summary.psc_description,
+            },
+            placeOfPerformance: {
+                city: summary.place_of_performance_city,
+                state: summary.place_of_performance_state,
+                country: summary.place_of_performance_country,
+            },
+            fetchedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Normalize detailed award information.
+     */
+    normalizeAwardDetail(detail) {
+        return {
+            awardId: detail.generated_unique_award_id,
+            identifier: detail.piid || detail.fain || detail.uri || '',
+            awardType: detail.type,
+            awardTypeDescription: detail.type_description,
+            description: detail.description,
+            totalObligation: detail.total_obligation,
+            baseAndAllOptionsValue: detail.base_and_all_options_value,
+            recipient: {
+                name: detail.recipient.recipient_name,
+                uei: detail.recipient.recipient_uei,
+                location: {
+                    city: detail.recipient.location.city_name,
+                    state: detail.recipient.location.state_code,
+                    country: detail.recipient.location.country_name,
+                },
+                businessCategories: detail.recipient.business_categories,
+            },
+            awardingAgency: {
+                name: `${detail.awarding_agency.toptier_agency.name} / ${detail.awarding_agency.subtier_agency.name}`,
+                toptierName: detail.awarding_agency.toptier_agency.name,
+                subtierName: detail.awarding_agency.subtier_agency.name,
+            },
+            fundingAgency: detail.funding_agency?.toptier_agency
+                ? {
+                    name: `${detail.funding_agency.toptier_agency.name}${detail.funding_agency.subtier_agency
+                        ? ` / ${detail.funding_agency.subtier_agency.name}`
+                        : ''}`,
+                    toptierName: detail.funding_agency.toptier_agency.name,
+                    subtierName: detail.funding_agency.subtier_agency?.name || null,
+                }
+                : null,
+            dates: {
+                signed: detail.date_signed,
+                performanceStart: detail.period_of_performance.start_date,
+                performanceEnd: detail.period_of_performance.end_date,
+            },
+            naics: {
+                code: detail.naics_hierarchy.base_code?.code || null,
+                description: detail.naics_hierarchy.base_code?.description || null,
+            },
+            psc: {
+                code: detail.psc_hierarchy.base_code?.code || null,
+                description: detail.psc_hierarchy.base_code?.description || null,
+            },
+            placeOfPerformance: {
+                city: detail.place_of_performance.city_name,
+                state: detail.place_of_performance.state_code,
+                country: detail.place_of_performance.country_name,
+            },
+            fetchedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Convert an award record to a PromptSpeak symbol.
+     */
+    toSymbol(record) {
+        const symbolId = `\u039E.TX.GOV.AWARD.${record.awardId.replace(/[^A-Za-z0-9]/g, '_').toUpperCase()}`;
+        const now = new Date().toISOString();
+        // Format currency
+        const formatCurrency = (amount) => {
+            if (amount >= 1e9)
+                return `$${(amount / 1e9).toFixed(2)}B`;
+            if (amount >= 1e6)
+                return `$${(amount / 1e6).toFixed(2)}M`;
+            if (amount >= 1e3)
+                return `$${(amount / 1e3).toFixed(2)}K`;
+            return `$${amount.toFixed(2)}`;
+        };
+        return {
+            symbolId,
+            version: 1,
+            hash: Buffer.from(record.awardId).toString('base64').slice(0, 16),
+            category: 'TRANSACTION',
+            subcategory: 'GOVERNMENT_AWARD',
+            tags: [
+                'government',
+                'usaspending',
+                record.awardType,
+                record.naics.code || 'no-naics',
+            ].filter(Boolean),
+            who: `Federal contractor: ${record.recipient.name}`,
+            what: `Government ${record.awardTypeDescription}: ${record.description.slice(0, 200)}`,
+            why: `Track federal spending and contract performance for ${record.awardingAgency.toptierName}`,
+            where: record.placeOfPerformance.state
+                ? `${record.placeOfPerformance.city || ''}, ${record.placeOfPerformance.state}, ${record.placeOfPerformance.country || 'USA'}`
+                : 'United States',
+            when: `${record.dates.performanceStart} to ${record.dates.performanceEnd}`,
+            how: {
+                focus: [
+                    'contract_value',
+                    'performance_period',
+                    'naics_classification',
+                    'awarding_agency',
+                ],
+                constraints: ['federal_data', 'public_record'],
+                output_format: 'structured_award_data',
+            },
+            commanders_intent: `Track and analyze the ${formatCurrency(record.totalObligation)} ${record.awardTypeDescription} awarded to ${record.recipient.name} by ${record.awardingAgency.toptierName}`,
+            requirements: [
+                `Total obligation: ${formatCurrency(record.totalObligation)}`,
+                `Base + options: ${formatCurrency(record.baseAndAllOptionsValue)}`,
+                `Recipient UEI: ${record.recipient.uei || 'Not available'}`,
+                `NAICS: ${record.naics.code || 'N/A'} - ${record.naics.description || 'N/A'}`,
+                `PSC: ${record.psc.code || 'N/A'} - ${record.psc.description || 'N/A'}`,
+            ],
+            created_at: now,
+            updated_at: now,
+            source_dataset: 'usaspending.gov',
+            source_id: record.awardId,
+            source_data: {
+                identifier: record.identifier,
+                award_type: record.awardType,
+                awarding_agency: record.awardingAgency,
+                funding_agency: record.fundingAgency,
+                recipient: record.recipient,
+                dates: record.dates,
+                naics: record.naics,
+                psc: record.psc,
+                amounts: {
+                    total_obligation: record.totalObligation,
+                    base_and_options: record.baseAndAllOptionsValue,
+                },
+            },
+            provenance: {
+                source_type: 'PRIMARY',
+                source_authority: 'HIGH',
+                source_urls: [`https://www.usaspending.gov/award/${record.awardId}`],
+                extraction_method: 'api',
+                verification_date: now,
+            },
+            freshness: {
+                last_validated: now,
+                valid_for_days: 7, // Federal spending data is updated weekly
+            },
+        };
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// FACTORY FUNCTION
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Create a USASpending adapter instance.
+ */
+export function createUSASpendingAdapter(config) {
+    return new USASpendingAdapter(config);
+}
+/**
+ * Default singleton instance.
+ */
+export const usaSpendingAdapter = createUSASpendingAdapter();
+//# sourceMappingURL=usaspending-adapter.js.map

package/dist/government/adapters/usaspending-adapter.js.map

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

package/dist/government/index.d.ts

@@ -0,0 +1,128 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * GOVERNMENT DATA ADAPTERS MODULE
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Multi-Agent Data Intelligence Framework (MADIF) - Government Data Layer
+ *
+ * This module provides adapters for querying federal government data sources:
+ *   - USASpending.gov - Federal spending and contract data
+ *   - Federal Register - Proposed rules, final rules, and notices
+ *   - SAM.gov - Entity registration and contractor information
+ *   - Regulations.gov - Regulatory documents and public comments
+ *
+ * Each adapter provides:
+ *   - Rate limiting (sliding window algorithm)
+ *   - Caching (LRU with TTL)
+ *   - Retry with exponential backoff
+ *   - Conversion to PromptSpeak symbols
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+export { BaseGovernmentAdapter, type RateLimitConfig, type CacheConfig, type RetryConfig, type BaseAdapterConfig, type LookupResult, type BatchLookupResult, type AdapterStats, AdapterError, ErrorCode, PromptSpeakError, isPromptSpeakError, CircuitBreakerError, NetworkError, TimeoutError, RateLimitError, AuthenticationError, NotFoundError, type Result, type ResultMetadata, success, failure, fromError, SlidingWindowRateLimiter, LRUCache, DEFAULT_RETRY_CONFIG, DEFAULT_CACHE_CONFIG, } from './adapters/base-adapter.js';
+export { USASpendingAdapter, createUSASpendingAdapter, usaSpendingAdapter, type USASpendingConfig, DEFAULT_USASPENDING_CONFIG, type USASpendingFilters, type USASpendingAwardSummary, type USASpendingAwardDetail, type USASpendingAwardRecord, } from './adapters/usaspending-adapter.js';
+export { FederalRegisterAdapter, createFederalRegisterAdapter, federalRegisterAdapter, type FederalRegisterConfig, DEFAULT_FEDERAL_REGISTER_CONFIG, type FRDocumentType, type FRAgencyReference, type FRCfrReference, type FRDocument, type FRAgency, type FederalRegisterRecord, type FRSearchConditions, } from './adapters/federal-register-adapter.js';
+export { SAMEntityAdapter, createSAMEntityAdapter, samEntityAdapter, type SAMEntityConfig, DEFAULT_SAM_ENTITY_CONFIG, type SAMRegistrationStatus, type SAMBusinessType, type SAMNaicsCode, type SAMPscCode, type SAMPointOfContact, type SAMAddress, type SAMEntityData, type SAMEntityRecord, type SAMSearchConditions, } from './adapters/sam-entity-adapter.js';
+export { RegulationsGovAdapter, createRegulationsGovAdapter, regulationsGovAdapter, type RegulationsGovConfig, DEFAULT_REGULATIONS_CONFIG, type RegDocumentType, type RegDocumentSubtype, type RegDocumentAttributes, type RegDocument, type RegDocketAttributes, type RegDocket, type RegulationsDocumentRecord, type RegulationsDocketRecord, type RegDocumentSearchConditions, type RegDocketSearchConditions, } from './adapters/regulations-adapter.js';
+export { SAMOpportunitiesAdapter, getSAMOpportunitiesAdapter, createSAMOpportunitiesAdapter, type SAMOpportunitiesConfig, type NoticeType, type SetAsideType, type SAMOpportunity, type OpportunitySearchParams, type OpportunitySearchResponse, } from './adapters/sam-opportunities-adapter.js';
+export { mapEntityToSymbol, mapAwardToSymbol, mapFederalRegisterToSymbol, mapRegulationsDocToSymbol, mapRegulationsDocketToSymbol, mapGovernmentDataToSymbol, mapGovernmentDataBatch, GOVERNMENT_SYMBOL_PREFIXES, isGovernmentSymbol, getGovernmentSourceFromSymbol, type GovernmentDataSource, type GovernmentRecord, } from './mappers/symbol-mapper.js';
+import { USASpendingAdapter, USASpendingConfig } from './adapters/usaspending-adapter.js';
+import { FederalRegisterAdapter, FederalRegisterConfig } from './adapters/federal-register-adapter.js';
+import { SAMEntityAdapter, SAMEntityConfig } from './adapters/sam-entity-adapter.js';
+import { RegulationsGovAdapter, RegulationsGovConfig } from './adapters/regulations-adapter.js';
+import { SAMOpportunitiesAdapter, SAMOpportunitiesConfig } from './adapters/sam-opportunities-adapter.js';
+/**
+ * Configuration options for creating all adapters.
+ */
+export interface GovernmentAdapterOptions {
+    /** USASpending.gov adapter config */
+    usaspending?: Partial<USASpendingConfig>;
+    /** Federal Register adapter config */
+    federalRegister?: Partial<FederalRegisterConfig>;
+    /** SAM.gov Entity adapter config (requires API key) */
+    sam?: Partial<SAMEntityConfig>;
+    /** SAM.gov Opportunities adapter config (requires API key) */
+    samOpportunities?: Partial<SAMOpportunitiesConfig>;
+    /** Regulations.gov adapter config (requires API key) */
+    regulations?: Partial<RegulationsGovConfig>;
+}
+/**
+ * Collection of all government data adapters.
+ */
+export interface GovernmentAdapters {
+    usaspending: USASpendingAdapter;
+    federalRegister: FederalRegisterAdapter;
+    sam: SAMEntityAdapter;
+    samOpportunities: SAMOpportunitiesAdapter;
+    regulations: RegulationsGovAdapter;
+}
+/**
+ * Create all government data adapters with optional configuration.
+ *
+ * @example
+ * ```typescript
+ * // Create all adapters with default config
+ * const adapters = createGovernmentAdapters();
+ *
+ * // Create with API keys
+ * const adapters = createGovernmentAdapters({
+ *   sam: { apiKey: process.env.SAM_API_KEY },
+ *   samOpportunities: { apiKey: process.env.SAM_API_KEY },
+ *   regulations: { apiKey: process.env.DATA_GOV_API_KEY },
+ * });
+ *
+ * // Search for SDVOSB RFI opportunities
+ * const rfis = await adapters.samOpportunities.searchRFIs({
+ *   keywords: ['AI', 'NLP'],
+ *   setAsideTypes: ['SDVOSBC'],
+ * });
+ * ```
+ */
+export declare function createGovernmentAdapters(options?: GovernmentAdapterOptions): GovernmentAdapters;
+/**
+ * Default singleton instances of all adapters.
+ * Use these for simple applications that don't need custom configuration.
+ */
+export declare const governmentAdapters: GovernmentAdapters;
+/**
+ * Configure API keys for adapters that require them.
+ *
+ * @example
+ * ```typescript
+ * configureApiKeys(governmentAdapters, {
+ *   sam: process.env.SAM_API_KEY,
+ *   regulations: process.env.DATA_GOV_API_KEY,
+ * });
+ * ```
+ */
+export declare function configureApiKeys(adapters: GovernmentAdapters, keys: {
+    sam?: string;
+    samOpportunities?: string;
+    regulations?: string;
+}): void;
+/**
+ * Check which adapters are fully configured.
+ */
+export declare function getAdapterStatus(adapters: GovernmentAdapters): {
+    usaspending: {
+        configured: true;
+        requiresKey: false;
+    };
+    federalRegister: {
+        configured: true;
+        requiresKey: false;
+    };
+    sam: {
+        configured: boolean;
+        requiresKey: true;
+    };
+    samOpportunities: {
+        configured: boolean;
+        requiresKey: true;
+    };
+    regulations: {
+        configured: boolean;
+        requiresKey: true;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/government/index.d.ts.map

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