@absolutejs/voice 0.0.22-beta.54 → 0.0.22-beta.540

package/dist/core/proofTrends.d.ts

@@ -0,0 +1,966 @@
+import { Elysia } from "elysia";
+import type { Database } from "bun:sqlite";
+import { type VoiceProviderDecisionStatus } from "./providerDecisionTraces";
+import type { VoiceProductionReadinessAction, VoiceProductionReadinessCheck, VoiceReadinessRecoveryAction } from "./productionReadiness";
+import type { VoiceReconnectContractReport, VoiceReconnectProofReport } from "./reconnectContract";
+import { StoredVoiceTraceEvent, VoiceTraceEventStore } from "./trace";
+export type VoiceProofTrendStatus = "empty" | "fail" | "pass" | "stale";
+export type VoiceProofTrendSummary = {
+    cycles?: number;
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    maxReconnectP95Ms?: number;
+    profiles?: VoiceProofTrendProfileSummary[];
+    providers?: VoiceProofTrendProviderSummary[];
+    reconnect?: VoiceProofTrendReconnectSummary;
+    runtimeChannel?: VoiceProofTrendRuntimeChannelSummary;
+    maxTurnP95Ms?: number;
+};
+export type VoiceProofTrendProfileSummary = {
+    cycles?: number;
+    description?: string;
+    id: string;
+    label?: string;
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    maxReconnectP95Ms?: number;
+    maxTurnP95Ms?: number;
+    providers?: VoiceProofTrendProviderSummary[];
+    reconnect?: VoiceProofTrendReconnectSummary;
+    runtimeChannel?: VoiceProofTrendRuntimeChannelSummary;
+    sessionCount?: number;
+    status?: string;
+    surfaces?: string[];
+};
+export type VoiceProofTrendProfileDefinition = {
+    description?: string;
+    id: string;
+    label?: string;
+    liveOffsetMs?: number;
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    maxReconnectP95Ms?: number;
+    maxRuntimeFirstAudioLatencyMs?: number;
+    maxRuntimeInterruptionP95Ms?: number;
+    maxRuntimeJitterMs?: number;
+    maxRuntimeTimestampDriftMs?: number;
+    maxTurnP95Ms?: number;
+    providerOffsetMs?: number;
+    runtimeOffsetMs?: number;
+    turnOffsetMs?: number;
+};
+export type VoiceProofTrendProviderSummary = {
+    averageMs?: number;
+    id: string;
+    label?: string;
+    p50Ms?: number;
+    p95Ms?: number;
+    role?: string;
+    samples?: number;
+    status?: string;
+};
+export type VoiceProofTrendRuntimeChannelSummary = {
+    maxBackpressureEvents?: number;
+    maxFirstAudioLatencyMs?: number;
+    maxInterruptionP95Ms?: number;
+    maxJitterMs?: number;
+    maxTimestampDriftMs?: number;
+    samples?: number;
+    status?: string;
+};
+export type VoiceProofTrendReconnectSummary = {
+    attempts?: number;
+    exhausted?: boolean;
+    maxAttempts?: number;
+    resumeLatencyP95Ms?: number;
+    reconnected?: boolean;
+    resumed?: boolean;
+    samples?: number;
+    snapshotCount?: number;
+    status?: string;
+};
+export type VoiceProofTrendCycle = {
+    at?: string;
+    cycle?: number;
+    liveLatency?: {
+        p95Ms?: number;
+        samples?: number;
+    };
+    ok?: boolean;
+    opsRecovery?: {
+        issues?: number;
+        status?: string;
+    };
+    productionReadiness?: {
+        status?: string;
+    };
+    providerSlo?: {
+        events?: number;
+        eventsWithLatency?: number;
+        status?: string;
+    };
+    providers?: VoiceProofTrendProviderSummary[];
+    reconnect?: VoiceProofTrendReconnectSummary;
+    runtimeChannel?: VoiceProofTrendRuntimeChannelSummary;
+    turnLatency?: {
+        p95Ms?: number;
+        samples?: number;
+        status?: string;
+    };
+};
+export type VoiceProofTrendReportInput = {
+    baseUrl?: string;
+    cycles?: VoiceProofTrendCycle[];
+    generatedAt?: string;
+    maxAgeMs?: number;
+    now?: Date | number | string;
+    ok?: boolean;
+    outputDir?: string;
+    runId?: string;
+    source?: string;
+    status?: VoiceProofTrendStatus;
+    summary?: VoiceProofTrendSummary;
+};
+export type VoiceProofTrendReport = {
+    ageMs?: number;
+    baseUrl?: string;
+    cycles: VoiceProofTrendCycle[];
+    freshUntil?: string;
+    generatedAt?: string;
+    maxAgeMs: number;
+    ok: boolean;
+    outputDir?: string;
+    runId?: string;
+    source: string;
+    status: VoiceProofTrendStatus;
+    summary: VoiceProofTrendSummary;
+};
+export type VoiceProofTrendProfileSummaryOptions = {
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    maxReconnectP95Ms?: number;
+    maxRuntimeFirstAudioLatencyMs?: number;
+    maxRuntimeInterruptionP95Ms?: number;
+    maxRuntimeJitterMs?: number;
+    maxRuntimeTimestampDriftMs?: number;
+    maxTurnP95Ms?: number;
+    profiles?: readonly VoiceProofTrendProfileDefinition[];
+};
+export type VoiceProofTrendRealCallProfileEvidence = {
+    generatedAt?: string;
+    liveP95Ms?: number;
+    ok?: boolean;
+    operationsRecordHref?: string;
+    profileDescription?: string;
+    profileId: string;
+    profileLabel?: string;
+    providerP95Ms?: number;
+    providers?: VoiceProofTrendProviderSummary[];
+    reconnect?: VoiceProofTrendReconnectSummary;
+    runtimeChannel?: VoiceProofTrendRuntimeChannelSummary;
+    sessionId: string;
+    surfaces?: string[];
+    turnP95Ms?: number;
+};
+export type VoiceRealCallProfileEvidenceRecord = VoiceProofTrendRealCallProfileEvidence & {
+    createdAt: string;
+    id: string;
+};
+export type VoiceReconnectProfileEvidenceSummaryStatus = "empty" | "fail" | "pass" | "warn";
+export type VoiceReconnectProfileEvidenceSummary = {
+    evidence: VoiceRealCallProfileEvidenceRecord[];
+    generatedAt: string;
+    latest?: VoiceRealCallProfileEvidenceRecord;
+    ok: boolean;
+    profileId: string;
+    resumeLatencyP95Ms?: number;
+    sampleCount: number;
+    snapshotCount: number;
+    sourceHref?: string;
+    status: VoiceReconnectProfileEvidenceSummaryStatus;
+};
+export type VoiceRealCallProfileEvidenceCreateInput = VoiceProofTrendRealCallProfileEvidence & {
+    createdAt?: string;
+    id?: string;
+};
+export type VoiceRealCallProfileEvidenceListOptions = {
+    limit?: number;
+    profileId?: string;
+    sessionId?: string;
+    since?: Date | number | string;
+    until?: Date | number | string;
+};
+export type VoiceRealCallProfileEvidenceStore = {
+    append(input: VoiceRealCallProfileEvidenceCreateInput): Promise<VoiceRealCallProfileEvidenceRecord> | VoiceRealCallProfileEvidenceRecord;
+    get(id: string): Promise<VoiceRealCallProfileEvidenceRecord | undefined> | VoiceRealCallProfileEvidenceRecord | undefined;
+    list(options?: VoiceRealCallProfileEvidenceListOptions): Promise<VoiceRealCallProfileEvidenceRecord[]> | VoiceRealCallProfileEvidenceRecord[];
+    remove(id: string): Promise<void> | void;
+};
+export type VoiceSQLiteRealCallProfileEvidenceStoreOptions = {
+    database?: Database;
+    idPrefix?: string;
+    now?: () => Date;
+    path?: string;
+    tableName?: string;
+};
+export type VoiceReconnectRealCallProfileEvidenceOptions = {
+    operationsRecordHref?: string | ((report: VoiceReconnectProofReport | VoiceReconnectContractReport, index: number) => string | undefined);
+    profileDescription?: string;
+    profileId?: string;
+    profileLabel?: string;
+    sessionId?: string | ((report: VoiceReconnectProofReport | VoiceReconnectContractReport, index: number) => string);
+    surfaces?: readonly string[];
+};
+export type VoiceRealCallProfileTraceEvidenceOptions = {
+    defaultProfileId?: string;
+    defaultProfileLabel?: string;
+    maxProviderP95Ms?: number;
+    profileDescriptions?: Record<string, string>;
+    profileLabels?: Record<string, string>;
+    sessionIds?: readonly string[];
+};
+export type VoiceRealCallProfileTraceStoreEvidenceOptions = VoiceRealCallProfileTraceEvidenceOptions & {
+    limit?: number;
+    store: VoiceTraceEventStore;
+};
+export type VoiceRealCallProfileTraceCollectorEvidenceOptions = VoiceRealCallProfileTraceEvidenceOptions & {
+    limit?: number;
+};
+export type VoiceRealCallProfileTraceCollectorOptions<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = VoiceRealCallProfileTraceCollectorEvidenceOptions & {
+    store: VoiceTraceEventStore<TEvent>;
+};
+export type VoiceRealCallProfileTraceCollector<TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent> = VoiceTraceEventStore<TEvent> & {
+    buildHistoryReport: (options?: Omit<VoiceRealCallProfileHistoryOptions, "evidence"> & {
+        evidenceOptions?: VoiceRealCallProfileTraceCollectorEvidenceOptions;
+    }) => Promise<VoiceRealCallProfileHistoryReport>;
+    listCapturedSessionIds: () => string[];
+    listEvidence: (options?: VoiceRealCallProfileTraceCollectorEvidenceOptions) => Promise<VoiceProofTrendRealCallProfileEvidence[]>;
+};
+export type VoiceRealCallEvidenceRuntimeSourceOptions = {
+    browserEvidence?: VoiceRealCallEvidenceRuntimeSurfaceEvidenceSource;
+    existingEvidenceLimit?: number;
+    evidenceStore: VoiceRealCallProfileEvidenceStore;
+    history?: Omit<VoiceRealCallProfileHistoryOptions, "evidence">;
+    phoneEvidence?: VoiceRealCallEvidenceRuntimeSurfaceEvidenceSource;
+    providerRoleEvidence?: VoiceRealCallEvidenceRuntimeProviderRoleEvidenceSource;
+    reconnectEvidence?: VoiceReconnectRealCallProfileEvidenceOptions;
+    reconnectReports?: ((options: VoiceRealCallEvidenceRuntimeCollectOptions) => Promise<VoiceReconnectProofReport | VoiceReconnectContractReport | readonly (VoiceReconnectProofReport | VoiceReconnectContractReport)[] | undefined> | VoiceReconnectProofReport | VoiceReconnectContractReport | readonly (VoiceReconnectProofReport | VoiceReconnectContractReport)[] | undefined) | VoiceReconnectProofReport | VoiceReconnectContractReport | readonly (VoiceReconnectProofReport | VoiceReconnectContractReport)[];
+    traceEvidence?: VoiceRealCallProfileTraceCollectorEvidenceOptions;
+    traceStore?: VoiceTraceEventStore;
+};
+export type VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions = Omit<VoiceProofTrendRealCallProfileEvidence, "profileId" | "providers" | "sessionId" | "surfaces"> & {
+    profileId?: string;
+    providers?: readonly VoiceProofTrendProviderSummary[];
+    sessionId?: string;
+    surfaces?: readonly string[];
+};
+export type VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions = Omit<VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions, "providers"> & {
+    providers: readonly VoiceProofTrendProviderSummary[];
+};
+export type VoiceRealCallEvidenceRuntimeSurfaceEvidenceSource = VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions[] | ((options: VoiceRealCallEvidenceRuntimeCollectOptions) => Promise<VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions[] | undefined> | VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions[] | undefined);
+export type VoiceRealCallEvidenceRuntimeProviderRoleEvidenceSource = VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions[] | ((options: VoiceRealCallEvidenceRuntimeCollectOptions) => Promise<VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions[] | undefined> | VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions[] | undefined);
+export type VoiceRealCallEvidenceRuntimeOptions = VoiceRealCallEvidenceRuntimeSourceOptions & {
+    dedupe?: boolean;
+    now?: () => Date;
+};
+export type VoiceRealCallEvidenceRuntimeCollectOptions = Partial<VoiceRealCallEvidenceRuntimeSourceOptions> & {
+    dedupe?: boolean;
+    now?: () => Date;
+};
+export type VoiceRealCallEvidenceRuntimeReport = {
+    appended: number;
+    collected: VoiceProofTrendRealCallProfileEvidence[];
+    duplicateKeys: string[];
+    evidence: VoiceRealCallProfileEvidenceRecord[];
+    generatedAt: string;
+    history: VoiceRealCallProfileHistoryReport;
+    issues: string[];
+    ok: boolean;
+    skippedDuplicates: number;
+    source: string;
+    status: VoiceProofTrendStatus;
+    summary: {
+        collectedEvidence: number;
+        failedProfiles: number;
+        profiles: number;
+        sessions: number;
+        storedEvidence: number;
+    };
+};
+export type VoiceRealCallEvidenceRuntime = {
+    appendEvidence: (evidence: VoiceProofTrendRealCallProfileEvidence | readonly VoiceProofTrendRealCallProfileEvidence[], options?: Pick<VoiceRealCallEvidenceRuntimeCollectOptions, "dedupe">) => Promise<VoiceRealCallEvidenceRuntimeReport>;
+    buildHistoryReport: (options?: Omit<VoiceRealCallProfileHistoryOptions, "evidence"> & VoiceRealCallProfileEvidenceListOptions) => Promise<VoiceRealCallProfileHistoryReport>;
+    buildReport: (options?: VoiceRealCallEvidenceRuntimeCollectOptions) => Promise<VoiceRealCallEvidenceRuntimeReport>;
+    collect: (options?: VoiceRealCallEvidenceRuntimeCollectOptions) => Promise<VoiceRealCallEvidenceRuntimeReport>;
+    listEvidence: (options?: VoiceRealCallProfileEvidenceListOptions) => Promise<VoiceRealCallProfileEvidenceRecord[]>;
+};
+export type VoiceRealCallEvidenceRuntimeWorkerStatus = "idle" | "running" | VoiceProofTrendStatus;
+export type VoiceRealCallEvidenceRuntimeWorkerHealthReport = {
+    collectCount: number;
+    error?: string;
+    isRunning: boolean;
+    lastCollectedAt?: string;
+    lastReport?: VoiceRealCallEvidenceRuntimeReport;
+    lastStartedAt?: string;
+    lastStoppedAt?: string;
+    lastTickAt?: string;
+    source: string;
+    status: VoiceRealCallEvidenceRuntimeWorkerStatus;
+};
+export type VoiceRealCallEvidenceRuntimeWorkerOptions = {
+    collectOptions?: VoiceRealCallEvidenceRuntimeCollectOptions;
+    now?: () => Date;
+    onCollect?: (report: VoiceRealCallEvidenceRuntimeReport) => void | Promise<void>;
+    onError?: (error: unknown) => void | Promise<void>;
+    runtime: VoiceRealCallEvidenceRuntime;
+};
+export type VoiceRealCallEvidenceRuntimeWorker = {
+    collect: () => Promise<VoiceRealCallEvidenceRuntimeReport>;
+    health: () => VoiceRealCallEvidenceRuntimeWorkerHealthReport;
+};
+export type VoiceRealCallEvidenceRuntimeWorkerLoopOptions = VoiceRealCallEvidenceRuntimeWorkerOptions & {
+    pollIntervalMs?: number;
+};
+export type VoiceRealCallEvidenceRuntimeWorkerLoop = VoiceRealCallEvidenceRuntimeWorker & {
+    isRunning: () => boolean;
+    start: () => void;
+    stop: () => void;
+    tick: () => Promise<VoiceRealCallEvidenceRuntimeReport>;
+};
+export type VoiceRealCallEvidenceRuntimeRoutesOptions = VoiceRealCallEvidenceRuntimeOptions & {
+    collectPath?: false | string;
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    jsonPath?: string;
+    markdownPath?: false | string;
+    name?: string;
+    runtime?: VoiceRealCallEvidenceRuntime;
+    title?: string;
+};
+export type VoiceRealCallEvidenceRuntimeReadinessCheckOptions = {
+    collectHref?: string;
+    failOnWarnings?: boolean;
+    href?: string;
+    label?: string;
+    minProfiles?: number;
+    minSessions?: number;
+    minStoredEvidence?: number;
+    sourceHref?: string;
+};
+export type VoiceRealCallEvidenceRuntimeWorkerReadinessCheckOptions = {
+    collectHref?: string;
+    failOnNotRunning?: boolean;
+    failOnStale?: boolean;
+    href?: string;
+    label?: string;
+    maxLastCollectedAgeMs?: number;
+    now?: () => Date;
+    requireRunning?: boolean;
+    sourceHref?: string;
+};
+export type VoiceProofTrendRealCallProfileReportOptions = VoiceProofTrendProfileSummaryOptions & {
+    baseUrl?: string;
+    evidence: readonly VoiceProofTrendRealCallProfileEvidence[];
+    generatedAt?: string;
+    maxAgeMs?: number;
+    now?: Date | number | string;
+    outputDir?: string;
+    runId?: string;
+    source?: string;
+};
+export type VoiceProofTrendAssertionInput = {
+    maxAgeMs?: number;
+    maxRuntimeBackpressureEvents?: number;
+    maxRuntimeFirstAudioLatencyMs?: number;
+    maxRuntimeInterruptionP95Ms?: number;
+    maxRuntimeJitterMs?: number;
+    maxRuntimeTimestampDriftMs?: number;
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    maxTurnP95Ms?: number;
+    minCycles?: number;
+    minLiveLatencySamples?: number;
+    minProviderSloEventsWithLatency?: number;
+    minRuntimeChannelSamples?: number;
+    minTurnLatencySamples?: number;
+    requireAllCyclesOk?: boolean;
+    requireStatus?: VoiceProofTrendStatus;
+};
+export type VoiceProofTrendAssertionReport = {
+    ageMs?: number;
+    cycles: number;
+    failedCycles: number;
+    issues: string[];
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    runtimeChannel?: VoiceProofTrendRuntimeChannelSummary;
+    maxTurnP95Ms?: number;
+    ok: boolean;
+    status: VoiceProofTrendStatus;
+};
+export type VoiceProofTrendRoutesOptions = {
+    headers?: HeadersInit;
+    jsonPath?: string;
+    maxAgeMs?: number;
+    name?: string;
+    path?: string;
+    source?: (() => Promise<VoiceProofTrendReport | VoiceProofTrendReportInput> | VoiceProofTrendReport | VoiceProofTrendReportInput) | VoiceProofTrendReport | VoiceProofTrendReportInput;
+};
+export type VoiceProofTrendRecommendationStatus = "fail" | "pass" | "warn";
+export type VoiceProofTrendRecommendationSurface = "live-latency" | "provider-path" | "runtime-channel" | "turn-latency";
+export type VoiceProofTrendRecommendation = {
+    evidence: Record<string, number | string | undefined>;
+    nextMove: string;
+    providerId?: string;
+    role?: string;
+    recommendation: string;
+    status: VoiceProofTrendRecommendationStatus;
+    surface: VoiceProofTrendRecommendationSurface;
+};
+export type VoiceProofTrendProviderRecommendation = {
+    averageMs?: number;
+    id: string;
+    label?: string;
+    nextMove: string;
+    p50Ms?: number;
+    p95Ms?: number;
+    rank: number;
+    role?: string;
+    samples?: number;
+    status: VoiceProofTrendRecommendationStatus;
+};
+export type VoiceProofTrendRecommendationReport = {
+    bestProvider?: VoiceProofTrendProviderRecommendation;
+    bestProviders: VoiceProofTrendProviderRecommendation[];
+    generatedAt: string;
+    issues: string[];
+    ok: boolean;
+    profiles: VoiceProofTrendProfileRecommendation[];
+    providers: VoiceProofTrendProviderRecommendation[];
+    recommendations: VoiceProofTrendRecommendation[];
+    source: string;
+    status: VoiceProofTrendRecommendationStatus;
+    summary: {
+        keepCurrentProviderPath: boolean;
+        keepCurrentRuntimeChannel: boolean;
+        providerComparisonCount: number;
+        recommendedActions: number;
+        switchRecommended: boolean;
+    };
+};
+export type VoiceProofTrendProfileRecommendation = {
+    bestProviders: VoiceProofTrendProviderRecommendation[];
+    id: string;
+    label?: string;
+    nextMove: string;
+    providerComparisonCount: number;
+    recommendation: string;
+    status: VoiceProofTrendRecommendationStatus;
+};
+export type VoiceProofTrendRecommendationOptions = {
+    currentProviderId?: string;
+    maxLiveP95Ms?: number;
+    maxProviderP95Ms?: number;
+    maxRuntimeBackpressureEvents?: number;
+    maxRuntimeFirstAudioLatencyMs?: number;
+    maxRuntimeInterruptionP95Ms?: number;
+    maxRuntimeJitterMs?: number;
+    maxRuntimeTimestampDriftMs?: number;
+    maxTurnP95Ms?: number;
+    providerSwitchMinImprovementMs?: number;
+    providerSwitchMinImprovementRatio?: number;
+};
+export type VoiceProofTrendRecommendationRoutesOptions = VoiceProofTrendRecommendationOptions & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    jsonPath?: string;
+    maxAgeMs?: number;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    source?: (() => Promise<VoiceProofTrendReport | VoiceProofTrendReportInput> | VoiceProofTrendReport | VoiceProofTrendReportInput) | VoiceProofTrendReport | VoiceProofTrendReportInput;
+    title?: string;
+};
+export type VoiceRealCallProfileHistoryReport = {
+    defaults: VoiceRealCallProfileDefaultsReport;
+    generatedAt: string;
+    history: VoiceProofTrendReport[];
+    issues: string[];
+    ok: boolean;
+    recommendations: VoiceProofTrendRecommendationReport;
+    reports: number;
+    source: string;
+    status: VoiceProofTrendStatus;
+    summary: VoiceProofTrendSummary & {
+        failedReports: number;
+        profileCount: number;
+    };
+    trend: VoiceProofTrendReport;
+};
+export type VoiceRealCallProfileHistoryOptions = VoiceProofTrendProfileSummaryOptions & VoiceProofTrendRecommendationOptions & {
+    baseUrl?: string;
+    evidence?: readonly VoiceProofTrendRealCallProfileEvidence[];
+    generatedAt?: string;
+    maxAgeMs?: number;
+    now?: Date | number | string;
+    reports?: readonly (VoiceProofTrendReport | VoiceProofTrendReportInput)[];
+    source?: string;
+};
+export type VoiceRealCallProfileDefault = {
+    evidence: {
+        liveP95Ms?: number;
+        providerP95Ms?: number;
+        turnP95Ms?: number;
+    };
+    label?: string;
+    latencyBudgets: {
+        maxLiveP95Ms?: number;
+        maxProviderP95Ms?: number;
+        maxTurnP95Ms?: number;
+    };
+    nextMove: string;
+    profileId: string;
+    providerRoutes: Record<string, string>;
+    providers: VoiceProofTrendProviderRecommendation[];
+    runtimeChannel?: {
+        maxBackpressureEvents?: number;
+        maxFirstAudioLatencyMs?: number;
+        maxInterruptionP95Ms?: number;
+        maxJitterMs?: number;
+        maxTimestampDriftMs?: number;
+    };
+    status: VoiceProofTrendRecommendationStatus;
+};
+export type VoiceRealCallProfileDefaultsReport = {
+    generatedAt: string;
+    issues: string[];
+    ok: boolean;
+    profiles: VoiceRealCallProfileDefault[];
+    source: string;
+    status: VoiceProofTrendRecommendationStatus;
+    summary: {
+        actionableProfiles: number;
+        profileCount: number;
+        requiredProviderRoles: string[];
+    };
+};
+export type VoiceRealCallProfileDefaultsOptions = VoiceProofTrendRecommendationOptions & {
+    latencyBudgetHeadroomMs?: number;
+    latencyBudgetHeadroomRatio?: number;
+    requiredProviderRoles?: readonly string[];
+};
+export type VoiceRealCallProfileProviderRouteOptions<TProvider extends string = string> = {
+    availableProviders?: readonly TProvider[];
+    defaults: VoiceRealCallProfileDefaultsReport | VoiceRealCallProfileHistoryReport;
+    fallbackProvider?: TProvider;
+    profileId?: string;
+    providerAliases?: Partial<Record<string, TProvider | readonly TProvider[]>>;
+    role: string;
+};
+export type VoiceRealCallProfileHistoryRoutesOptions = Omit<VoiceRealCallProfileHistoryOptions, "source"> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    source?: (() => Promise<VoiceRealCallProfileHistoryOptions> | VoiceRealCallProfileHistoryOptions) | VoiceRealCallProfileHistoryOptions;
+    title?: string;
+};
+export type VoiceRealCallProfileRecoveryActionId = "collect-browser-proof" | "collect-phone-proof" | "collect-reconnect-proof" | "collect-provider-role-evidence" | "refresh";
+export type VoiceRealCallProfileRecoveryAction = VoiceProductionReadinessAction & {
+    id: VoiceRealCallProfileRecoveryActionId;
+    profileId?: string;
+};
+export type VoiceRealCallProfileReadinessCheckOptions = {
+    browserProofHref?: string;
+    failOnWarnings?: boolean;
+    reconnectProofHref?: string;
+    href?: string;
+    label?: string;
+    maxAgeMs?: number;
+    minActionableProfiles?: number;
+    minCycles?: number;
+    minProfileCycles?: number;
+    minProfileSessions?: number;
+    minProfiles?: number;
+    requiredProfileIds?: readonly string[];
+    requiredProfileSurfaces?: readonly string[] | Record<string, readonly string[]>;
+    requiredProviderRoles?: readonly string[];
+    operationsRecordsHref?: string;
+    phoneProofHref?: string;
+    productionReadinessHref?: string;
+    sourceHref?: string;
+};
+export type VoiceRealCallProfileRecoveryActionOptions = VoiceRealCallProfileReadinessCheckOptions;
+export type VoiceRealCallProfileRecoveryJobHistoryCheckOptions = {
+    allowFailedJobs?: boolean;
+    failOnRunningJobs?: boolean;
+    href?: string;
+    label?: string;
+    maxAgeMs?: number;
+    minCompletedJobs?: number;
+    sourceHref?: string;
+};
+export type VoiceRealCallProfileRecoveryActionHandlerInput = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    profileId?: string;
+    report: VoiceRealCallProfileHistoryReport;
+};
+export type VoiceRealCallProfileRecoveryActionResult = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    generatedAt: string;
+    job?: VoiceRealCallProfileRecoveryJob;
+    jobId?: string;
+    jobStatus?: VoiceRealCallProfileRecoveryJobStatus;
+    message?: string;
+    ok: boolean;
+    report?: VoiceRealCallProfileHistoryReport;
+    status: VoiceProofTrendStatus;
+};
+export type VoiceRealCallProfileRecoveryJobStatus = "fail" | "pass" | "queued" | "running";
+export type VoiceRealCallProfileRecoveryJob = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    completedAt?: string;
+    createdAt: string;
+    id: string;
+    message?: string;
+    ok?: boolean;
+    report?: VoiceRealCallProfileHistoryReport;
+    startedAt?: string;
+    status: VoiceRealCallProfileRecoveryJobStatus;
+    updatedAt: string;
+};
+export type VoiceRealCallProfileRecoveryJobCreateInput = {
+    actionId: VoiceRealCallProfileRecoveryActionId;
+    createdAt?: string;
+    id?: string;
+    message?: string;
+    status?: VoiceRealCallProfileRecoveryJobStatus;
+};
+export type VoiceRealCallProfileRecoveryJobUpdate = Partial<Pick<VoiceRealCallProfileRecoveryJob, "completedAt" | "message" | "ok" | "report" | "startedAt" | "status" | "updatedAt">>;
+export type VoiceRealCallProfileRecoveryJobListOptions = {
+    actionId?: VoiceRealCallProfileRecoveryActionId;
+    limit?: number;
+    status?: VoiceRealCallProfileRecoveryJobStatus;
+};
+export type VoiceRealCallProfileRecoveryJobStore = {
+    create(input: VoiceRealCallProfileRecoveryJobCreateInput): Promise<VoiceRealCallProfileRecoveryJob> | VoiceRealCallProfileRecoveryJob;
+    get(id: string): Promise<VoiceRealCallProfileRecoveryJob | undefined> | VoiceRealCallProfileRecoveryJob | undefined;
+    list?(options?: VoiceRealCallProfileRecoveryJobListOptions): Promise<VoiceRealCallProfileRecoveryJob[]> | VoiceRealCallProfileRecoveryJob[];
+    update(id: string, update: VoiceRealCallProfileRecoveryJobUpdate): Promise<VoiceRealCallProfileRecoveryJob | undefined> | VoiceRealCallProfileRecoveryJob | undefined;
+};
+export type VoiceSQLiteRealCallProfileRecoveryJobStoreOptions = {
+    database?: Database;
+    idPrefix?: string;
+    now?: () => Date;
+    path?: string;
+    tableName?: string;
+};
+export type VoiceRealCallProfileRecoveryActionHandler = (input: VoiceRealCallProfileRecoveryActionHandlerInput) => Promise<Partial<VoiceRealCallProfileRecoveryActionResult> | void> | Partial<VoiceRealCallProfileRecoveryActionResult> | void;
+export type VoiceRealCallProfileRecoveryActionRoutesOptions = VoiceRealCallProfileRecoveryActionOptions & Omit<VoiceRealCallProfileHistoryRoutesOptions, "htmlPath" | "markdownPath"> & {
+    asyncActionIds?: readonly VoiceRealCallProfileRecoveryActionId[];
+    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[];
+    passes: number;
+    ok: boolean;
+    realCallProfileGate: VoiceProductionReadinessCheck | null;
+    startFailures: VoiceRealCallProfileRecoveryLoopStartFailure[];
+};
+export type VoiceRealCallProfileRecoveryLoopOptions = {
+    actionFilter?: (action: VoiceRealCallProfileRecoveryLoopAction) => boolean;
+    baseUrl: string;
+    fetch?: typeof fetch;
+    interPassDelayMs?: number;
+    jobHref?: string | ((jobId: string) => string);
+    jobPollMs?: number;
+    jobTimeoutMs?: number;
+    logger?: Pick<Console, "log">;
+    maxPasses?: number;
+    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_TREND_PROFILE_DEFINITIONS: ({
+    description: string;
+    id: string;
+    label: string;
+    liveOffsetMs?: undefined;
+    providerOffsetMs?: undefined;
+    runtimeOffsetMs?: undefined;
+    turnOffsetMs?: undefined;
+} | {
+    description: string;
+    id: string;
+    label: string;
+    liveOffsetMs: number;
+    providerOffsetMs: number;
+    runtimeOffsetMs: number;
+    turnOffsetMs: number;
+})[];
+export declare const DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS: number;
+export declare const buildEmptyVoiceProofTrendReport: (source?: string, maxAgeMs?: number) => VoiceProofTrendReport;
+export declare const buildVoiceProofTrendReport: (input?: VoiceProofTrendReportInput) => VoiceProofTrendReport;
+export declare const normalizeVoiceProofTrendReport: (value: VoiceProofTrendReport | VoiceProofTrendReportInput, options?: {
+    maxAgeMs?: number;
+    now?: Date | number | string;
+    source?: string;
+}) => VoiceProofTrendReport;
+export declare const readVoiceProofTrendReportFile: (path: string, options?: {
+    maxAgeMs?: number;
+}) => Promise<VoiceProofTrendReport>;
+export declare const buildVoiceReconnectProfileEvidenceSummary: (evidence: readonly VoiceRealCallProfileEvidenceRecord[], options?: {
+    generatedAt?: string;
+    profileId?: string;
+    sourceHref?: string;
+}) => VoiceReconnectProfileEvidenceSummary;
+export declare const buildVoiceRealCallProfileEvidenceFromTraceEvents: (events: readonly StoredVoiceTraceEvent[], options?: VoiceRealCallProfileTraceEvidenceOptions) => VoiceProofTrendRealCallProfileEvidence[];
+export declare const buildVoiceRealCallProfileEvidenceFromReconnectProofReports: (input: VoiceReconnectProofReport | VoiceReconnectContractReport | readonly (VoiceReconnectProofReport | VoiceReconnectContractReport)[], options?: VoiceReconnectRealCallProfileEvidenceOptions) => VoiceProofTrendRealCallProfileEvidence[];
+export declare const loadVoiceRealCallProfileEvidenceFromStore: (options: VoiceRealCallProfileEvidenceListOptions & {
+    store: VoiceRealCallProfileEvidenceStore;
+}) => Promise<VoiceRealCallProfileEvidenceRecord[]>;
+export declare const loadVoiceRealCallProfileEvidenceFromTraceStore: (options: VoiceRealCallProfileTraceStoreEvidenceOptions) => Promise<VoiceProofTrendRealCallProfileEvidence[]>;
+export declare const buildVoiceRealCallProfileEvidenceFromRuntimeProviderRoles: (input: VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeProviderRoleEvidenceOptions[], options?: {
+    defaultProfileId?: string;
+    defaultSessionPrefix?: string;
+    now?: () => Date;
+}) => VoiceProofTrendRealCallProfileEvidence[];
+export declare const buildVoiceRealCallProfileEvidenceFromRuntimeSurface: (input: VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions | readonly VoiceRealCallEvidenceRuntimeSurfaceEvidenceOptions[], options: {
+    defaultProfileId: string;
+    defaultSessionPrefix: string;
+    defaultSurfaces: readonly string[];
+    now?: () => Date;
+}) => VoiceProofTrendRealCallProfileEvidence[];
+export declare const buildVoiceRealCallEvidenceRuntimeReadinessCheck: (report: VoiceRealCallEvidenceRuntimeReport, options?: VoiceRealCallEvidenceRuntimeReadinessCheckOptions) => VoiceProductionReadinessCheck;
+export declare const createVoiceRealCallEvidenceRuntime: (options: VoiceRealCallEvidenceRuntimeOptions) => VoiceRealCallEvidenceRuntime;
+export declare const buildVoiceRealCallEvidenceRuntimeWorkerReadinessCheck: (health: VoiceRealCallEvidenceRuntimeWorkerHealthReport, options?: VoiceRealCallEvidenceRuntimeWorkerReadinessCheckOptions) => VoiceProductionReadinessCheck;
+export declare const createVoiceRealCallEvidenceRuntimeWorker: (options: VoiceRealCallEvidenceRuntimeWorkerOptions) => VoiceRealCallEvidenceRuntimeWorker;
+export declare const createVoiceRealCallEvidenceRuntimeWorkerLoop: (options: VoiceRealCallEvidenceRuntimeWorkerLoopOptions) => VoiceRealCallEvidenceRuntimeWorkerLoop;
+export declare const createVoiceRealCallProfileTraceCollector: <TEvent extends StoredVoiceTraceEvent = StoredVoiceTraceEvent>(options: VoiceRealCallProfileTraceCollectorOptions<TEvent>) => VoiceRealCallProfileTraceCollector<TEvent>;
+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 buildVoiceRealCallProfileRecoveryActions: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileRecoveryActionOptions) => VoiceRealCallProfileRecoveryAction[];
+export declare const createVoiceInMemoryRealCallProfileRecoveryJobStore: (options?: {
+    idPrefix?: string;
+    now?: () => Date;
+}) => VoiceRealCallProfileRecoveryJobStore;
+export declare const runVoiceRealCallProfileRecoveryLoop: (options: VoiceRealCallProfileRecoveryLoopOptions) => Promise<VoiceRealCallProfileRecoveryLoopReport>;
+export declare const createVoiceSQLiteRealCallProfileEvidenceStore: (options?: VoiceSQLiteRealCallProfileEvidenceStoreOptions) => VoiceRealCallProfileEvidenceStore;
+export declare const buildVoiceRealCallProfileHistoryReport: (options?: VoiceRealCallProfileHistoryOptions) => VoiceRealCallProfileHistoryReport;
+export declare const buildVoiceRealCallProfileHistoryReportFromStore: (options: Omit<VoiceRealCallProfileHistoryOptions, "evidence"> & VoiceRealCallProfileEvidenceListOptions & {
+    store: VoiceRealCallProfileEvidenceStore;
+}) => Promise<VoiceRealCallProfileHistoryReport>;
+export declare const buildVoiceRealCallProfileReadinessCheck: (report: VoiceRealCallProfileHistoryReport, options?: VoiceRealCallProfileReadinessCheckOptions) => VoiceProductionReadinessCheck;
+export declare const buildVoiceRealCallProfileRecoveryJobHistoryCheck: (store: Pick<VoiceRealCallProfileRecoveryJobStore, "list"> | undefined, options?: VoiceRealCallProfileRecoveryJobHistoryCheckOptions) => Promise<VoiceProductionReadinessCheck>;
+export declare const createVoiceSQLiteRealCallProfileRecoveryJobStore: (options?: VoiceSQLiteRealCallProfileRecoveryJobStoreOptions) => VoiceRealCallProfileRecoveryJobStore;
+export declare const resolveVoiceRealCallProfileProviderRoute: <TProvider extends string = string>(options: VoiceRealCallProfileProviderRouteOptions<TProvider>) => TProvider | undefined;
+export declare const assertVoiceProofTrendEvidence: (report: VoiceProofTrendReport, input?: VoiceProofTrendAssertionInput) => VoiceProofTrendAssertionReport;
+export declare const evaluateVoiceProofTrendEvidence: (report: VoiceProofTrendReport, input?: VoiceProofTrendAssertionInput) => VoiceProofTrendAssertionReport;
+export declare const buildVoiceProofTrendRecommendationReport: (report: VoiceProofTrendReport, options?: VoiceProofTrendRecommendationOptions) => VoiceProofTrendRecommendationReport;
+export declare const createVoiceProofTrendRecommendationRoutes: (options: VoiceProofTrendRecommendationRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const createVoiceRealCallEvidenceRuntimeRoutes: (options: VoiceRealCallEvidenceRuntimeRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const createVoiceRealCallProfileHistoryRoutes: (options?: VoiceRealCallProfileHistoryRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const renderVoiceProofTrendRecommendationHTML: (report: VoiceProofTrendRecommendationReport, title?: string) => string;
+export declare const renderVoiceProofTrendRecommendationMarkdown: (report: VoiceProofTrendRecommendationReport, title?: string) => string;
+export declare const renderVoiceRealCallEvidenceRuntimeHTML: (report: VoiceRealCallEvidenceRuntimeReport, title?: string) => string;
+export declare const renderVoiceRealCallEvidenceRuntimeMarkdown: (report: VoiceRealCallEvidenceRuntimeReport, title?: string) => string;
+export declare const renderVoiceRealCallProfileHistoryHTML: (report: VoiceRealCallProfileHistoryReport, title?: string) => string;
+export declare const renderVoiceRealCallProfileHistoryMarkdown: (report: VoiceRealCallProfileHistoryReport, title?: string) => string;
+export declare const createVoiceProofTrendRoutes: (options: VoiceProofTrendRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const createVoiceRealCallProfileRecoveryActionRoutes: (options?: VoiceRealCallProfileRecoveryActionRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+export declare const formatVoiceProofTrendAge: (ageMs: unknown) => string;