tlnt/dist/services/hmsNfoClient.d.ts

TLNT - HMS-Powered Multi-Agent Platform with Government Agency Analysis, Deep Research, and Enterprise-Ready Deployment. Self-optimizing multi-domain AI agent with continuous learning and enterprise-grade performance monitoring.

/**
 * HMS-NFO API Client
 *
 * Client for connecting to HMS-NFO (Data Source/ETL System) API
 * Provides data processing, ETL, agency analysis, and deep research capabilities
 */
export interface HMSNfoConfig {
    baseURL: string;
    apiKey?: string;
    timeout?: number;
}
export interface ETLRequest {
    agent_id: string;
    request_id?: string;
    type: 'etl_processing';
    source: {
        type: string;
        agency?: string;
        dataset?: string;
        url?: string;
    };
    parameters: {
        output_format?: string;
        analysis_depth?: number;
        include_metadata?: boolean;
        filter_criteria?: Record<string, unknown>;
    };
    callback_url?: string;
    timeout_seconds?: number;
}
export interface AgencyAnalysisRequest {
    agent_id: string;
    request_id?: string;
    agency_name: string;
    issue_topic: string;
    state?: string;
    agency_type?: string;
    analysis_parameters?: {
        include_regulations?: boolean;
        include_policy_analysis?: boolean;
        generate_recommendations?: boolean;
    };
    callback_url?: string;
}
export interface DeepResearchRequest {
    agent_id: string;
    request_id?: string;
    research_topic: string;
    research_depth?: number;
    research_breadth?: number;
    parameters?: {
        include_cort_analysis?: boolean;
        source_types?: string[];
        max_sources?: number;
        synthesis_required?: boolean;
    };
    callback_url?: string;
}
export interface ProcessingStatus {
    request_id: string;
    status: 'accepted' | 'queued' | 'processing' | 'completed' | 'failed';
    agent_id?: string;
    processing_status?: string;
    estimated_completion_ms?: number;
    completed_at?: string;
    processing_time_seconds?: number;
    error?: string;
}
export interface ETLResult {
    request_id: string;
    agent_id: string;
    status: 'completed';
    completed_at: string;
    processing_time_seconds: number;
    results: {
        documents_processed: number;
        terms_extracted: number;
        index_size: string;
        summary: {
            total_words: number;
            unique_terms: number;
            top_terms: string[];
        };
        output_location: string;
        download_url: string;
    };
    metadata: {
        source_agencies: string[];
        data_types: string[];
        quality_score: number;
    };
}
export interface AgencyAnalysisResult {
    request_id: string;
    agent_id: string;
    status: 'completed';
    completed_at: string;
    analysis_results: {
        agency_info: {
            name: string;
            type: string;
            jurisdiction: string;
            state: string;
        };
        issue_analysis: {
            topic: string;
            complexity_score: number;
            regulatory_requirements: string[];
            recommended_hms_components: string[];
            implementation_roadmap: {
                phases: Array<{
                    phase: number;
                    title: string;
                    duration_weeks: number;
                }>;
            };
        };
        use_case_mapping: {
            primary_use_case: string;
            secondary_use_cases: string[];
            success_metrics: string[];
        };
    };
}
export interface DeepResearchResult {
    request_id: string;
    agent_id: string;
    status: 'completed';
    completed_at: string;
    research_results: {
        topic: string;
        sources_analyzed: number;
        cort_analysis: {
            depth_achieved: number;
            breadth_achieved: number;
            confidence_score: number;
        };
        key_findings: string[];
        synthesis_report: {
            executive_summary: string;
            detailed_analysis: string;
            recommendations: string[];
            risk_assessment: {
                regulatory_risk: 'low' | 'medium' | 'high';
                technical_risk: 'low' | 'medium' | 'high';
                compliance_risk: 'low' | 'medium' | 'high';
            };
        };
        source_bibliography: Array<{
            title: string;
            url: string;
            credibility: number;
        }>;
    };
}
export interface WebSearchRequest {
    query: string;
    max_results?: number;
    source_types?: string[];
}
export interface WebSearchResult {
    query: string;
    results: Array<{
        title: string;
        url: string;
        score: number;
        source: string;
        snippet?: string;
    }>;
    total_sources_queried: number;
    response_time_ms: number;
    search_providers: string[];
    aggregation_strategy: string;
}
export declare class HMSNfoClient {
    private client;
    private config;
    constructor(config: HMSNfoConfig);
    private formatError;
    healthCheck(): Promise<{
        status: string;
    }>;
    requestETLProcessing(request: ETLRequest): Promise<ProcessingStatus>;
    requestAgencyAnalysis(request: AgencyAnalysisRequest): Promise<ProcessingStatus>;
    requestDeepResearch(request: DeepResearchRequest): Promise<ProcessingStatus>;
    getAgencyTypes(): Promise<Record<string, string[]>>;
    performWebSearch(request: WebSearchRequest): Promise<WebSearchResult>;
    getETLStatus(): Promise<{
        pipeline_status: string;
        workers_available: number;
        last_processing_time: string;
        documents_processed: number;
        performance_metrics: Record<string, string>;
    }>;
    performDemoAgencyAnalysis(agencyName: string, issueTopic: string, state?: string): Promise<{
        status: string;
        agency_name: string;
        issue_topic: string;
        state?: string;
        hms_components: string[];
        analysis: {
            summary: string;
            recommendations: string[];
            technical_approach: string;
            estimated_timeline: string;
            compliance_impact: string;
        };
        documentation_generated: boolean;
        research_sources: number;
        confidence_score: number;
    }>;
    performDemoDeepResearch(query: string, depth?: number): Promise<{
        status: string;
        query: string;
        research_depth: number;
        cort_analysis: {
            phase_1: string;
            phase_2: string;
            phase_3: string;
            sources_analyzed: number;
            confidence_threshold: number;
            structured_insights: string[];
        };
        processing_time_ms: number;
        research_quality: string;
    }>;
    analyzeGovernmentAgency(agencyName: string, issueTopic: string, options?: {
        state?: string;
        agencyType?: string;
        includeRegulations?: boolean;
        includePolicyAnalysis?: boolean;
        generateRecommendations?: boolean;
        callbackUrl?: string;
    }): Promise<ProcessingStatus>;
    performComprehensiveResearch(topic: string, options?: {
        depth?: number;
        breadth?: number;
        includeCoRT?: boolean;
        sourceTypes?: string[];
        maxSources?: number;
        synthesisRequired?: boolean;
        callbackUrl?: string;
    }): Promise<ProcessingStatus>;
    processGovernmentData(source: {
        type: string;
        agency?: string;
        dataset?: string;
        url?: string;
    }, options?: {
        outputFormat?: string;
        analysisDepth?: number;
        includeMetadata?: boolean;
        filterCriteria?: Record<string, unknown>;
        callbackUrl?: string;
    }): Promise<ProcessingStatus>;
}
export default HMSNfoClient;
//# sourceMappingURL=hmsNfoClient.d.ts.map