promptspeak-mcp-server 0.1.0

package/dist/government/index.js

@@ -0,0 +1,183 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * 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
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// BASE ADAPTER
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Abstract base class
+BaseGovernmentAdapter, 
+// Error handling
+AdapterError, ErrorCode, PromptSpeakError, isPromptSpeakError, CircuitBreakerError, NetworkError, TimeoutError, RateLimitError, AuthenticationError, NotFoundError, success, failure, fromError, 
+// Internal utilities
+SlidingWindowRateLimiter, LRUCache, 
+// Defaults
+DEFAULT_RETRY_CONFIG, DEFAULT_CACHE_CONFIG, } from './adapters/base-adapter.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// USASPENDING.GOV ADAPTER
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Adapter class
+USASpendingAdapter, 
+// Factory function
+createUSASpendingAdapter, 
+// Singleton instance
+usaSpendingAdapter, DEFAULT_USASPENDING_CONFIG, } from './adapters/usaspending-adapter.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// FEDERAL REGISTER ADAPTER
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Adapter class
+FederalRegisterAdapter, 
+// Factory function
+createFederalRegisterAdapter, 
+// Singleton instance
+federalRegisterAdapter, DEFAULT_FEDERAL_REGISTER_CONFIG, } from './adapters/federal-register-adapter.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// SAM.GOV ENTITY ADAPTER
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Adapter class
+SAMEntityAdapter, 
+// Factory function
+createSAMEntityAdapter, 
+// Singleton instance
+samEntityAdapter, DEFAULT_SAM_ENTITY_CONFIG, } from './adapters/sam-entity-adapter.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// REGULATIONS.GOV ADAPTER
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Adapter class
+RegulationsGovAdapter, 
+// Factory function
+createRegulationsGovAdapter, 
+// Singleton instance
+regulationsGovAdapter, DEFAULT_REGULATIONS_CONFIG, } from './adapters/regulations-adapter.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// SAM.GOV OPPORTUNITIES ADAPTER
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Adapter class
+SAMOpportunitiesAdapter, 
+// Factory functions
+getSAMOpportunitiesAdapter, createSAMOpportunitiesAdapter, } from './adapters/sam-opportunities-adapter.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// SYMBOL MAPPERS
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Individual mappers
+mapEntityToSymbol, mapAwardToSymbol, mapFederalRegisterToSymbol, mapRegulationsDocToSymbol, mapRegulationsDocketToSymbol, 
+// Unified mapper
+mapGovernmentDataToSymbol, mapGovernmentDataBatch, 
+// Namespace utilities
+GOVERNMENT_SYMBOL_PREFIXES, isGovernmentSymbol, getGovernmentSourceFromSymbol, } from './mappers/symbol-mapper.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// CONVENIENCE FACTORY
+// ═══════════════════════════════════════════════════════════════════════════════
+import { USASpendingAdapter } from './adapters/usaspending-adapter.js';
+import { FederalRegisterAdapter } from './adapters/federal-register-adapter.js';
+import { SAMEntityAdapter } from './adapters/sam-entity-adapter.js';
+import { RegulationsGovAdapter } from './adapters/regulations-adapter.js';
+import { SAMOpportunitiesAdapter } from './adapters/sam-opportunities-adapter.js';
+/**
+ * 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 function createGovernmentAdapters(options = {}) {
+    return {
+        usaspending: new USASpendingAdapter(options.usaspending),
+        federalRegister: new FederalRegisterAdapter(options.federalRegister),
+        sam: new SAMEntityAdapter(options.sam),
+        samOpportunities: new SAMOpportunitiesAdapter(options.samOpportunities),
+        regulations: new RegulationsGovAdapter(options.regulations),
+    };
+}
+/**
+ * Default singleton instances of all adapters.
+ * Use these for simple applications that don't need custom configuration.
+ */
+export const governmentAdapters = {
+    usaspending: new USASpendingAdapter(),
+    federalRegister: new FederalRegisterAdapter(),
+    sam: new SAMEntityAdapter(),
+    samOpportunities: new SAMOpportunitiesAdapter(),
+    regulations: new RegulationsGovAdapter(),
+};
+// ═══════════════════════════════════════════════════════════════════════════════
+// API KEY CONFIGURATION HELPER
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * 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 function configureApiKeys(adapters, keys) {
+    if (keys.sam) {
+        adapters.sam.setApiKey(keys.sam);
+    }
+    if (keys.samOpportunities) {
+        adapters.samOpportunities.setApiKey(keys.samOpportunities);
+    }
+    else if (keys.sam) {
+        // Use same key for both SAM adapters if only one provided
+        adapters.samOpportunities.setApiKey(keys.sam);
+    }
+    if (keys.regulations) {
+        adapters.regulations.setApiKey(keys.regulations);
+    }
+}
+/**
+ * Check which adapters are fully configured.
+ */
+export function getAdapterStatus(adapters) {
+    return {
+        usaspending: { configured: true, requiresKey: false },
+        federalRegister: { configured: true, requiresKey: false },
+        sam: { configured: adapters.sam.isApiConfigured(), requiresKey: true },
+        samOpportunities: { configured: !adapters.samOpportunities.isStubMode(), requiresKey: true },
+        regulations: { configured: adapters.regulations.isApiConfigured(), requiresKey: true },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/government/index.js.map

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

package/dist/government/mappers/symbol-mapper.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * GOVERNMENT DATA SYMBOL MAPPER
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Maps government data records to PromptSpeak symbols.
+ * Provides unified symbol generation across all government data adapters.
+ *
+ * Symbol Taxonomy:
+ *   - Entities: Ξ.C.GOV.* (COMPANY category, government contractor subcategory)
+ *   - Awards: Ξ.TX.GOV.* (TRANSACTION category, government award subcategory)
+ *   - Regulations: Ξ.RG.* (REGULATORY category)
+ *   - Documents: Ξ.D.GOV.* (DOCUMENT category)
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import type { DirectiveSymbol } from '../../symbols/types.js';
+import type { USASpendingAwardRecord } from '../adapters/usaspending-adapter.js';
+import type { FederalRegisterRecord } from '../adapters/federal-register-adapter.js';
+import type { SAMEntityRecord } from '../adapters/sam-entity-adapter.js';
+import type { RegulationsDocumentRecord, RegulationsDocketRecord } from '../adapters/regulations-adapter.js';
+/**
+ * Map a SAM.gov entity to a COMPANY symbol.
+ */
+export declare function mapEntityToSymbol(record: SAMEntityRecord): DirectiveSymbol;
+/**
+ * Map a USASpending award to a TRANSACTION symbol.
+ */
+export declare function mapAwardToSymbol(record: USASpendingAwardRecord): DirectiveSymbol;
+/**
+ * Map a Federal Register document to a REGULATORY or DOCUMENT symbol.
+ */
+export declare function mapFederalRegisterToSymbol(record: FederalRegisterRecord): DirectiveSymbol;
+/**
+ * Map a Regulations.gov document to a REGULATORY symbol.
+ */
+export declare function mapRegulationsDocToSymbol(record: RegulationsDocumentRecord): DirectiveSymbol;
+/**
+ * Map a Regulations.gov docket to a WORKFLOW symbol.
+ */
+export declare function mapRegulationsDocketToSymbol(record: RegulationsDocketRecord): DirectiveSymbol;
+/**
+ * Government data source types for the unified mapper.
+ */
+export type GovernmentDataSource = 'sam' | 'usaspending' | 'federal_register' | 'regulations';
+/**
+ * Record types for the unified mapper.
+ */
+export type GovernmentRecord = SAMEntityRecord | USASpendingAwardRecord | FederalRegisterRecord | RegulationsDocumentRecord | RegulationsDocketRecord;
+/**
+ * Unified mapper that routes to the appropriate specific mapper.
+ */
+export declare function mapGovernmentDataToSymbol(source: GovernmentDataSource, record: GovernmentRecord): DirectiveSymbol;
+/**
+ * Batch map multiple records to symbols.
+ */
+export declare function mapGovernmentDataBatch(source: GovernmentDataSource, records: GovernmentRecord[]): DirectiveSymbol[];
+/**
+ * Government symbol namespace prefixes.
+ */
+export declare const GOVERNMENT_SYMBOL_PREFIXES: {
+    /** SAM.gov entities (contractors) */
+    readonly ENTITY: "Ξ.C.GOV";
+    /** USASpending awards */
+    readonly AWARD: "Ξ.TX.GOV";
+    /** Federal Register rules */
+    readonly RULE: "Ξ.RG.FR.RULE";
+    /** Federal Register proposed rules */
+    readonly PROPOSED_RULE: "Ξ.RG.FR.PROPOSED";
+    /** Regulations.gov documents */
+    readonly REGULATION: "Ξ.RG.REGS";
+    /** Regulatory dockets */
+    readonly DOCKET: "Ξ.WF.REGS.DOCKET";
+    /** Presidential documents */
+    readonly PRESIDENTIAL: "Ξ.D.GOV.PRESIDENTIAL";
+    /** General government documents */
+    readonly DOCUMENT: "Ξ.D.GOV";
+};
+/**
+ * Check if a symbol ID is a government symbol.
+ */
+export declare function isGovernmentSymbol(symbolId: string): boolean;
+/**
+ * Get the government data source from a symbol ID.
+ */
+export declare function getGovernmentSourceFromSymbol(symbolId: string): GovernmentDataSource | null;
+//# sourceMappingURL=symbol-mapper.d.ts.map

package/dist/government/mappers/symbol-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-mapper.d.ts","sourceRoot":"","sources":["../../../src/government/mappers/symbol-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAoC7G;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CA2G1E;AAgBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,eAAe,CAoGhF;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAsIzF;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,eAAe,CAoH5F;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,uBAAuB,GAAG,eAAe,CAgG7F;AAMD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,KAAK,GACL,aAAa,GACb,kBAAkB,GAClB,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,sBAAsB,GACtB,qBAAqB,GACrB,yBAAyB,GACzB,uBAAuB,CAAC;AAE5B;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,gBAAgB,GACvB,eAAe,CAiBjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,gBAAgB,EAAE,GAC1B,eAAe,EAAE,CAEnB;AAMD;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,qCAAqC;;IAErC,yBAAyB;;IAEzB,6BAA6B;;IAE7B,sCAAsC;;IAEtC,gCAAgC;;IAEhC,yBAAyB;;IAEzB,6BAA6B;;IAE7B,mCAAmC;;CAE3B,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI5D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAsB3F"}