@thinkhive/sdk 4.0.1 → 4.2.0

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 /**
- * ThinkHive SDK v3.0.0
+ * ThinkHive SDK v4.1.0
  *
  * Run-centric AI agent observability platform with:
  * - Facts vs Inferences (claims API)
  * - Deterministic ticket linking (7 methods)
  * - Customer context snapshots (time-series)
  * - Calibrated predictions (Brier scores)
+ * - Configurable ROI calculation engine
  *
- * @version 3.0.0
+ * @version 4.1.0
  * @license MIT
  */
 import { isInitialized, SDK_VERSION, DEFAULT_ENDPOINT } from './core/config';
@@ -22,6 +23,15 @@ import { deterministicGraders, createRegexRule, createContainsRule, createLength
 import { conversationEval, aggregateWorst, aggregateAverage, aggregateWeighted, aggregateFinalTurn, aggregateMajority, getAggregator, getProblematicTurns, analyzeConversationTrend } from './api/conversation-eval';
 import { transcriptPatterns, isHighRisk, getMatchesByCategory, getCriticalInsights, hasPiiExposure, hasFrustrationSignals, hasEscalationRequest, getCategoryDistribution, getRecommendations, needsAttention, sortMatchesBySeverity } from './api/transcript-patterns';
 import { agents } from './api/agents';
+import { evalRuns } from './api/eval-runs';
+import { signals } from './api/signals';
+import { notifications } from './api/notifications';
+import { documents } from './api/documents';
+import { shadowTests } from './api/shadow-tests';
+import { sessions } from './api/sessions';
+import { drift, hasDrift, getDriftSeverity } from './api/drift';
+import { llmCosts, formatCost as formatLLMCost } from './api/llm-costs';
+import { guardrails } from './guardrails';
 import { apiKeys, hasPermission, isExpired as isApiKeyExpired, isValid as isApiKeyValid, getTimeUntilExpiry, canAccessAgent } from './api/apiKeys';
 import { roiAnalytics, calculateRevenueAtRisk, calculateAutomationSavings, formatCurrency, getROIQuality } from './api/roi-analytics';
 import { businessMetrics, isMetricReady, needsMoreTraces, awaitingExternalData, isMetricStale, getStatusMessage, getTraceProgress, formatMetricValue, getTrendEmoji } from './api/business-metrics';
@@ -40,6 +50,14 @@ export type { IndustryConfig, CustomIndustryConfig, ROIMetrics, BusinessImpact,
 export type { RetrievedContext, GroundTruthContext, GroundedSpan, UngroundedSpan, CitationMap, RAGEvaluation, RAGEvidence, HallucinationInstance, HallucinationReport, GroundednessResult, BatchEvaluationResult, BatchEvaluationSummary, } from './api/quality-metrics';
 export type { MetricTrend, MetricStatus, CurrentMetricResponse, MetricHistoryPoint, MetricHistorySummary, MetricHistoryResponse, RecordMetricOptions, RecordMetricResponse, } from './api/business-metrics';
 export type { Agent, CreateAgentOptions, UpdateAgentOptions, AgentConfig, UpdateAgentConfigOptions, DeleteAgentOptions, CascadeImpact, } from './api/agents';
+export type { CreateEvalRunOptions, GetEvalRunResultsOptions, ListEvalRunsOptions, EstimateCostOptions, GetTraceResultsOptions, EvalRun, EvalResult, EvalCostEstimate, } from './api/eval-runs';
+export type { DetectionConfig, CreateSignalOptions, UpdateSignalOptions, ListSignalsOptions, SignalStatsOptions, SignalTrendsOptions, SignalTracesOptions, SignalEventsOptions, Signal, SignalStats, SignalTrendPoint, SignalEvent, } from './api/signals';
+export type { NotificationRule, CreateNotificationRuleData, UpdateNotificationRuleData, Notification, } from './api/notifications';
+export type { Document, DocumentUploadResponse, } from './api/documents';
+export type { CreateShadowTestData, UpdateShadowTestData, ShadowTest, } from './api/shadow-tests';
+export type { ListSessionsOptions, Session, SessionTrace as SessionTraceRecord, } from './api/sessions';
+export type { DetectDriftOptions, DriftReport, DriftDimension, DetectAllResult, } from './api/drift';
+export type { CostQueryOptions, CostSummary, CostBreakdownItem, AgentCostBreakdown, CostSavings, OptimizationEntry, OptimizationStats, OptimizationRecommendation, } from './api/llm-costs';
 /**
  * Initialize ThinkHive SDK v3
  *
@@ -216,8 +234,9 @@ export declare const analyzer: {
     }): Promise<any>;
 };
 export { isInitialized, SDK_VERSION, DEFAULT_ENDPOINT };
-export { runs, claims, calibration, linking, customerContext, humanReview, nondeterminism, evalHealth, deterministicGraders, conversationEval, transcriptPatterns, apiKeys, agents, roiAnalytics, qualityMetrics, businessMetrics, };
-export { createRunWithContext, toOpenAIMessages, fromOpenAIMessages, isFact, isInference, isComputed, getHighConfidenceClaims, groupClaimsByType, groupClaimsByCategory, calculateBrierScore, calculateECE, isWellCalibrated, getCalibrationQuality, generateZendeskMarker, parseZendeskMarker, hasZendeskMarker, removeZendeskMarker, linkRunToTicket, linkRunToZendeskTicket, getBestLinkMethod, LINK_METHOD_CONFIDENCE, captureCustomerContext, getContextAsOf, toContextSnapshot, calculateArrChange, calculateHealthTrend, calculatePassAtK, calculatePassToK, requiredPassRateForPassAtK, isReliableEvaluation, getReliabilityRecommendation, hasHealthIssue, getHealthSeverityLevel, isSaturated, getSaturationRecommendation, createRegexRule, createContainsRule, createLengthRule, createJsonSchemaRule, allRulesPassed, getFailedRules, calculateAverageScore, aggregateWorst, aggregateAverage, aggregateWeighted, aggregateFinalTurn, aggregateMajority, getAggregator, getProblematicTurns, analyzeConversationTrend, isHighRisk, getMatchesByCategory, getCriticalInsights, hasPiiExposure, hasFrustrationSignals, hasEscalationRequest, getCategoryDistribution, getRecommendations, needsAttention, sortMatchesBySeverity, hasPermission, isApiKeyExpired, isApiKeyValid, getTimeUntilExpiry, canAccessAgent, calculateRevenueAtRisk, calculateAutomationSavings, formatCurrency, getROIQuality, passesQualityThreshold, isHallucinationRiskAcceptable, getQualityRecommendations, formatQualityScore, getGradeColor, isMetricReady, needsMoreTraces, awaitingExternalData, isMetricStale, getStatusMessage, getTraceProgress, formatMetricValue, getTrendEmoji, };
+export { runs, claims, calibration, linking, customerContext, humanReview, nondeterminism, evalHealth, deterministicGraders, conversationEval, transcriptPatterns, apiKeys, agents, roiAnalytics, qualityMetrics, businessMetrics, evalRuns, signals, notifications, documents, shadowTests, sessions, drift, llmCosts, guardrails, };
+export { createRunWithContext, toOpenAIMessages, fromOpenAIMessages, isFact, isInference, isComputed, getHighConfidenceClaims, groupClaimsByType, groupClaimsByCategory, calculateBrierScore, calculateECE, isWellCalibrated, getCalibrationQuality, generateZendeskMarker, parseZendeskMarker, hasZendeskMarker, removeZendeskMarker, linkRunToTicket, linkRunToZendeskTicket, getBestLinkMethod, LINK_METHOD_CONFIDENCE, captureCustomerContext, getContextAsOf, toContextSnapshot, calculateArrChange, calculateHealthTrend, calculatePassAtK, calculatePassToK, requiredPassRateForPassAtK, isReliableEvaluation, getReliabilityRecommendation, hasHealthIssue, getHealthSeverityLevel, isSaturated, getSaturationRecommendation, createRegexRule, createContainsRule, createLengthRule, createJsonSchemaRule, allRulesPassed, getFailedRules, calculateAverageScore, aggregateWorst, aggregateAverage, aggregateWeighted, aggregateFinalTurn, aggregateMajority, getAggregator, getProblematicTurns, analyzeConversationTrend, isHighRisk, getMatchesByCategory, getCriticalInsights, hasPiiExposure, hasFrustrationSignals, hasEscalationRequest, getCategoryDistribution, getRecommendations, needsAttention, sortMatchesBySeverity, hasPermission, isApiKeyExpired, isApiKeyValid, getTimeUntilExpiry, canAccessAgent, calculateRevenueAtRisk, calculateAutomationSavings, formatCurrency, getROIQuality, passesQualityThreshold, isHallucinationRiskAcceptable, getQualityRecommendations, formatQualityScore, getGradeColor, isMetricReady, needsMoreTraces, awaitingExternalData, isMetricStale, getStatusMessage, getTraceProgress, formatMetricValue, getTrendEmoji, hasDrift, getDriftSeverity, formatLLMCost, };
+export { type ScanRequest, type ScanResponse, type Finding, type ScannerResult } from './guardrails';
 export { ThinkHiveError, ThinkHiveApiError, ThinkHiveValidationError, PermissionDeniedError, AgentScopeError, RateLimitError, IpWhitelistError, };
 declare const _default: {
     init: typeof init;
@@ -327,21 +346,27 @@ declare const _default: {
         verify(linkId: string, options: {
             verified: boolean;
             notes?: string;
-        }): Promise<{
-            linkId: string;
-            verified: boolean;
-            message: string;
-        }>;
+        }): Promise<import("./integrations/ticket-linking").LinkResponse>;
         delete(linkId: string): Promise<void>;
-        autoLink(runId: string): Promise<{
-            runId: string;
-            created: import("./integrations/ticket-linking").LinkResponse[];
-            candidates: Array<{
-                ticketId: string;
-                method: import("./core/types").LinkMethod;
-                confidence: number;
-                reason: string;
-            }>;
+        autoLink(runId: string): Promise<import("./integrations/ticket-linking").LinkResponse | null>;
+        stats(): Promise<{
+            totalLinks: number;
+            byMethod: Record<string, number>;
+            avgConfidence: number;
+            verifiedCount: number;
+            unverifiedCount: number;
+        }>;
+        generateMarker(options: {
+            traceId: string;
+            runId?: string;
+            format?: "html_comment" | "base64" | "custom";
+            customTemplate?: string;
+        }): Promise<{
+            marker: string;
+            format: string;
+            traceId: string;
+            runId: string | null;
+            instructions: string;
         }>;
     };
     customerContext: {
@@ -598,6 +623,87 @@ declare const _default: {
             endDate?: string | Date;
             agentId?: string;
         }): Promise<import("./api/roi-analytics").CorrelationAnalysis>;
+        getConfig(): Promise<{
+            id: string;
+            companyId: string;
+            version: number;
+            isActive: boolean;
+            costConfig: Record<string, unknown>;
+            deflectionConfig: Record<string, unknown>;
+            resolutionConfig: Record<string, unknown>;
+            attributionConfig: Record<string, unknown>;
+            slaConfig: Record<string, unknown>;
+            displayConfig: Record<string, unknown>;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        createConfig(data: {
+            costConfig?: Record<string, unknown>;
+            deflectionConfig?: Record<string, unknown>;
+            resolutionConfig?: Record<string, unknown>;
+            attributionConfig?: Record<string, unknown>;
+            slaConfig?: Record<string, unknown>;
+            displayConfig?: Record<string, unknown>;
+        }): Promise<{
+            id: string;
+            companyId: string;
+            version: number;
+            isActive: boolean;
+            costConfig: Record<string, unknown>;
+            deflectionConfig: Record<string, unknown>;
+            resolutionConfig: Record<string, unknown>;
+            attributionConfig: Record<string, unknown>;
+            slaConfig: Record<string, unknown>;
+            displayConfig: Record<string, unknown>;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        updateConfig(data: {
+            costConfig?: Record<string, unknown>;
+            deflectionConfig?: Record<string, unknown>;
+            resolutionConfig?: Record<string, unknown>;
+            attributionConfig?: Record<string, unknown>;
+            slaConfig?: Record<string, unknown>;
+            displayConfig?: Record<string, unknown>;
+        }): Promise<{
+            id: string;
+            companyId: string;
+            version: number;
+            isActive: boolean;
+            costConfig: Record<string, unknown>;
+            deflectionConfig: Record<string, unknown>;
+            resolutionConfig: Record<string, unknown>;
+            attributionConfig: Record<string, unknown>;
+            slaConfig: Record<string, unknown>;
+            displayConfig: Record<string, unknown>;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        configVersions(options?: {
+            limit?: number;
+            offset?: number;
+        }): Promise<{
+            data: Record<string, unknown>[];
+            pagination: {
+                limit: number;
+                offset: number;
+                hasMore: boolean;
+            };
+        }>;
+        calculateV3(options: {
+            agentId?: string;
+            startDate: string | Date;
+            endDate: string | Date;
+            configurationVersion?: number;
+            includeBreakdown?: boolean;
+            includeConfidenceIntervals?: boolean;
+        }): Promise<Record<string, unknown>>;
+        trendV3(options: {
+            agentId?: string;
+            granularity: "day" | "week" | "month";
+            startDate: string | Date;
+            endDate: string | Date;
+        }): Promise<Record<string, unknown>>;
     };
     qualityMetrics: {
         getRagScores(traceId: string): Promise<{
@@ -669,6 +775,88 @@ declare const _default: {
         record(agentId: string, options: import("./api/business-metrics").RecordMetricOptions): Promise<import("./api/business-metrics").RecordMetricResponse>;
         recordBatch(agentId: string, metrics: import("./api/business-metrics").RecordMetricOptions[]): Promise<import("./api/business-metrics").RecordMetricResponse[]>;
     };
+    evalRuns: {
+        create(agentId: string, opts?: import("./api/eval-runs").CreateEvalRunOptions): Promise<import("./api/eval-runs").EvalRun>;
+        get(runId: string): Promise<import("./api/eval-runs").EvalRun>;
+        getResults(runId: string, opts?: import("./api/eval-runs").GetEvalRunResultsOptions): Promise<{
+            results: import("./api/eval-runs").EvalResult[];
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }>;
+        list(opts?: import("./api/eval-runs").ListEvalRunsOptions): Promise<import("./api/eval-runs").EvalRun[]>;
+        estimateCost(agentId: string, opts?: import("./api/eval-runs").EstimateCostOptions): Promise<import("./api/eval-runs").EvalCostEstimate>;
+        getTraceResults(traceId: string, opts?: import("./api/eval-runs").GetTraceResultsOptions): Promise<import("./api/eval-runs").EvalResult[]>;
+        remove(runId: string): Promise<void>;
+    };
+    signals: {
+        list(opts?: import("./api/signals").ListSignalsOptions): Promise<import("./api/signals").Signal[]>;
+        create(name: string, group: string, detectionConfig: import("./api/signals").DetectionConfig, opts?: import("./api/signals").CreateSignalOptions): Promise<import("./api/signals").Signal>;
+        update(id: string, opts: import("./api/signals").UpdateSignalOptions): Promise<import("./api/signals").Signal>;
+        remove(id: string): Promise<void>;
+        seedDefaults(): Promise<import("./api/signals").Signal[]>;
+        getStats(opts?: import("./api/signals").SignalStatsOptions): Promise<import("./api/signals").SignalStats[]>;
+        getTrends(opts?: import("./api/signals").SignalTrendsOptions): Promise<import("./api/signals").SignalTrendPoint[]>;
+        getTraces(id: string, opts?: import("./api/signals").SignalTracesOptions): Promise<{
+            traces: any[];
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }>;
+        getEvents(id: string, opts?: import("./api/signals").SignalEventsOptions): Promise<{
+            events: import("./api/signals").SignalEvent[];
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }>;
+    };
+    notifications: {
+        listRules(agentId: string): Promise<import("./api/notifications").NotificationRule[]>;
+        getRule(id: string, agentId?: string): Promise<import("./api/notifications").NotificationRule>;
+        createRule(data: import("./api/notifications").CreateNotificationRuleData): Promise<import("./api/notifications").NotificationRule>;
+        updateRule(id: string, data: import("./api/notifications").UpdateNotificationRuleData): Promise<import("./api/notifications").NotificationRule>;
+        deleteRule(id: string): Promise<void>;
+        listNotifications(agentId: string, unreadOnly?: boolean): Promise<import("./api/notifications").Notification[]>;
+        markAsRead(id: string): Promise<import("./api/notifications").Notification>;
+    };
+    documents: {
+        list(agentId: string): Promise<import("./api/documents").Document[]>;
+        upload(agentId: string, fileName: string, fileType: string, fileSize: number): Promise<import("./api/documents").DocumentUploadResponse>;
+        remove(agentId: string, docId: string): Promise<void>;
+    };
+    shadowTests: {
+        list(agentId: string): Promise<import("./api/shadow-tests").ShadowTest[]>;
+        get(id: string): Promise<import("./api/shadow-tests").ShadowTest>;
+        getByFix(fixId: string): Promise<import("./api/shadow-tests").ShadowTest[]>;
+        create(data: import("./api/shadow-tests").CreateShadowTestData): Promise<import("./api/shadow-tests").ShadowTest>;
+        update(id: string, data: import("./api/shadow-tests").UpdateShadowTestData): Promise<import("./api/shadow-tests").ShadowTest>;
+    };
+    sessions: {
+        list(agentId: string, opts?: import("./api/sessions").ListSessionsOptions): Promise<{
+            sessions: import("./api/sessions").Session[];
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }>;
+        getTraces(sessionId: string, agentId: string): Promise<import("./api/sessions").SessionTrace[]>;
+    };
+    drift: {
+        detect(agentId: string, opts?: import("./api/drift").DetectDriftOptions): Promise<import("./api/drift").DriftReport>;
+        detectAll(): Promise<import("./api/drift").DetectAllResult>;
+    };
+    llmCosts: {
+        getSummary(opts?: import("./api/llm-costs").CostQueryOptions): Promise<import("./api/llm-costs").CostSummary>;
+        getBreakdown(agentId: string, opts?: import("./api/llm-costs").CostQueryOptions): Promise<import("./api/llm-costs").AgentCostBreakdown>;
+        getSavings(): Promise<import("./api/llm-costs").CostSavings>;
+        getOptimizationStats(): Promise<import("./api/llm-costs").OptimizationStats>;
+    };
+    guardrails: {
+        scan(request: import("./guardrails").ScanRequest): Promise<import("./guardrails").ScanResponse>;
+        listScanners(): Promise<Array<{
+            name: string;
+            description: string;
+        }>>;
+    };
     generateZendeskMarker: typeof generateZendeskMarker;
     parseZendeskMarker: typeof parseZendeskMarker;
     linkRunToTicket: typeof linkRunToTicket;
@@ -688,5 +876,8 @@ declare const _default: {
     isMetricReady: typeof isMetricReady;
     needsMoreTraces: typeof needsMoreTraces;
     getStatusMessage: typeof getStatusMessage;
+    hasDrift: typeof hasDrift;
+    getDriftSeverity: typeof getDriftSeverity;
+    formatLLMCost: typeof formatLLMCost;
 };
 export default _default;