@absolutejs/voice 0.0.22-beta.384 → 0.0.22-beta.386

package/dist/proofTrends.d.ts

@@ -1,7 +1,8 @@
 import { Elysia } from 'elysia';
 import type { Database } from 'bun:sqlite';
-import type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck } from './productionReadiness';
-import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+import { type VoiceProviderDecisionStatus } from './providerDecisionTraces';
+import type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck, VoiceReadinessRecoveryAction } from './productionReadiness';
+import { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
 export type VoiceProofTrendStatus = 'empty' | 'fail' | 'pass' | 'stale';
 export type VoiceProofTrendSummary = {
     cycles?: number;
@@ -469,6 +470,80 @@ export type VoiceRealCallProfileRecoveryActionRoutesOptions = VoiceRealCallProfi
     handlers?: Partial<Record<VoiceRealCallProfileRecoveryActionId, VoiceRealCallProfileRecoveryActionHandler>>;
     jobStore?: VoiceRealCallProfileRecoveryJobStore;
 };
+export type VoiceRealCallProfileRecoveryLoopAction = Partial<VoiceReadinessRecoveryAction> & Partial<VoiceRealCallProfileRecoveryAction> & {
+    href?: string;
+    method?: string;
+};
+export type VoiceRealCallProfileRecoveryLoopJob = Partial<VoiceRealCallProfileRecoveryJob> & {
+    error?: string;
+    id?: string;
+    status?: string;
+};
+export type VoiceRealCallProfileRecoveryLoopJobResult = {
+    action: string;
+    jobId?: string;
+    result: VoiceRealCallProfileRecoveryLoopJob;
+};
+export type VoiceRealCallProfileRecoveryLoopStartFailure = {
+    action: string;
+    error: string;
+};
+export type VoiceRealCallProfileRecoveryLoopReport = {
+    actionCount: number;
+    actions: VoiceRealCallProfileRecoveryLoopAction[];
+    jobs: VoiceRealCallProfileRecoveryLoopJobResult[];
+    ok: boolean;
+    realCallProfileGate: VoiceProductionReadinessCheck | null;
+    startFailures: VoiceRealCallProfileRecoveryLoopStartFailure[];
+};
+export type VoiceRealCallProfileRecoveryLoopOptions = {
+    actionFilter?: (action: VoiceRealCallProfileRecoveryLoopAction) => boolean;
+    baseUrl: string;
+    fetch?: typeof fetch;
+    jobHref?: string | ((jobId: string) => string);
+    jobPollMs?: number;
+    jobTimeoutMs?: number;
+    logger?: Pick<Console, 'log'>;
+    readinessCheckLabel?: string;
+    readinessHref?: string;
+    recoveryActionsHref?: string;
+    refreshHref?: false | string;
+    requestTimeoutMs?: number;
+};
+export type VoiceRealCallProfileRecoveryEvidenceProviderRole = 'llm' | 'stt' | 'tts';
+export type VoiceRealCallProfileRecoveryEvidenceProvider = string | {
+    elapsedMs?: number;
+    provider: string;
+    reason?: string;
+    selectedProvider?: string;
+    status?: VoiceProviderDecisionStatus;
+    surface?: string;
+};
+export type VoiceRealCallProfileRecoveryEvidenceOptions<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = {
+    at?: number;
+    browser?: false | {
+        firstAudioLatencyMs?: number;
+        messageCount?: number;
+        openSockets?: number;
+        receivedBytes?: number;
+        sentBytes?: number;
+        status?: string;
+    };
+    live?: false | {
+        latencyMs?: number;
+        status?: string;
+    };
+    metadata?: Record<string, unknown>;
+    profileId: string;
+    providers?: Partial<Record<VoiceRealCallProfileRecoveryEvidenceProviderRole, VoiceRealCallProfileRecoveryEvidenceProvider>>;
+    scenarioId?: string;
+    sessionId?: string;
+    store: Pick<VoiceTraceEventStore<TEvent>, 'append'>;
+};
+export type VoiceRealCallProfileRecoveryEvidenceResult<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = {
+    events: TEvent[];
+    sessionId: string;
+};
 export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
 export declare const DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS: ({
     description: string;
@@ -503,6 +578,8 @@ export declare const createVoiceRealCallProfileTraceCollector: <TEvent extends S
 export declare const buildVoiceProofTrendProfileSummaries: (input: VoiceProofTrendReport | readonly VoiceProofTrendReport[], options?: VoiceProofTrendProfileSummaryOptions) => VoiceProofTrendProfileSummary[];
 export declare const buildVoiceProofTrendReportFromRealCallProfiles: (options: VoiceProofTrendRealCallProfileReportOptions) => VoiceProofTrendReport;
 export declare const buildVoiceRealCallProfileDefaults: (input: VoiceRealCallProfileHistoryReport | VoiceProofTrendReport, options?: VoiceRealCallProfileDefaultsOptions) => VoiceRealCallProfileDefaultsReport;
+export declare const appendVoiceRealCallProfileRecoveryEvidence: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>(options: VoiceRealCallProfileRecoveryEvidenceOptions<TEvent>) => Promise<VoiceRealCallProfileRecoveryEvidenceResult<TEvent>>;
+export declare const runVoiceRealCallProfileRecoveryLoop: (options: VoiceRealCallProfileRecoveryLoopOptions) => Promise<VoiceRealCallProfileRecoveryLoopReport>;
 export declare const buildVoiceRealCallProfileRecoveryActions: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileRecoveryActionOptions) => VoiceRealCallProfileRecoveryAction[];
 export declare const createVoiceInMemoryRealCallProfileRecoveryJobStore: (options?: {
     idPrefix?: string;