@absolutejs/voice 0.0.22-beta.195 → 0.0.22-beta.197

package/dist/opsRecovery.d.ts

@@ -0,0 +1,137 @@
+import { Elysia } from 'elysia';
+import { type VoiceAuditSinkDeliveryQueueSummary, type VoiceAuditSinkDeliveryStore } from './auditSinks';
+import { type VoiceLatencySLOGateOptions, type VoiceLatencySLOGateReport } from './latencySlo';
+import { type VoiceHandoffDeliveryQueueSummary, type VoiceTraceSinkDeliveryQueueSummary } from './queue';
+import { type VoiceProviderHealthSummary } from './providerHealth';
+import type { VoiceProductionReadinessCheck } from './productionReadiness';
+import type { VoiceHandoffDeliveryStore } from './types';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore, VoiceTraceSinkDeliveryStore } from './trace';
+export type VoiceOpsRecoveryStatus = 'fail' | 'pass' | 'warn';
+export type VoiceOpsRecoveryIssueCode = 'voice.ops_recovery.audit_delivery_failed' | 'voice.ops_recovery.audit_delivery_pending' | 'voice.ops_recovery.handoff_failed' | 'voice.ops_recovery.handoff_pending' | 'voice.ops_recovery.latency_slo_failed' | 'voice.ops_recovery.latency_slo_warn' | 'voice.ops_recovery.provider_unresolved_failure' | 'voice.ops_recovery.trace_delivery_failed' | 'voice.ops_recovery.trace_delivery_pending';
+export type VoiceOpsRecoveryIssue = {
+    code: VoiceOpsRecoveryIssueCode;
+    detail?: string;
+    href?: string;
+    label: string;
+    severity: Exclude<VoiceOpsRecoveryStatus, 'pass'>;
+    value?: number | string;
+};
+export type VoiceOpsRecoveryProviderSummary<TProvider extends string = string> = {
+    healthy: number;
+    providers: VoiceProviderHealthSummary<TProvider>[];
+    recoveredFallbacks: number;
+    unresolvedFailures: number;
+};
+export type VoiceOpsRecoveryInterventionSummary = {
+    events: Array<{
+        action?: string;
+        at: number;
+        operatorId?: string;
+        sessionId: string;
+        traceId?: string;
+    }>;
+    total: number;
+};
+export type VoiceOpsRecoveryFailedSession = {
+    at: number;
+    error?: string;
+    operationsRecordHref?: string;
+    provider?: string;
+    sessionId: string;
+    traceId?: string;
+};
+export type VoiceOpsRecoveryReport<TProvider extends string = string> = {
+    auditDeliveries?: VoiceAuditSinkDeliveryQueueSummary;
+    checkedAt: number;
+    failedSessions: VoiceOpsRecoveryFailedSession[];
+    handoffDeliveries?: VoiceHandoffDeliveryQueueSummary;
+    interventions: VoiceOpsRecoveryInterventionSummary;
+    issues: VoiceOpsRecoveryIssue[];
+    latency?: VoiceLatencySLOGateReport;
+    providers: VoiceOpsRecoveryProviderSummary<TProvider>;
+    status: VoiceOpsRecoveryStatus;
+    traceDeliveries?: VoiceTraceSinkDeliveryQueueSummary;
+};
+export type VoiceOpsRecoveryLinks = {
+    auditDeliveries?: string;
+    handoffs?: string;
+    operationsRecords?: string | ((sessionId: string) => string);
+    providers?: string;
+    sessions?: string | ((sessionId: string) => string);
+    traceDeliveries?: string;
+    traces?: string | ((sessionId: string) => string);
+};
+export type VoiceOpsRecoveryReportOptions<TProvider extends string = string> = {
+    auditDeliveryDeadLetters?: VoiceAuditSinkDeliveryStore;
+    auditDeliveries?: VoiceAuditSinkDeliveryStore;
+    events?: StoredVoiceTraceEvent[];
+    handoffDeliveryDeadLetters?: VoiceHandoffDeliveryStore;
+    handoffDeliveries?: VoiceHandoffDeliveryStore;
+    latency?: VoiceLatencySLOGateOptions | false;
+    limit?: number;
+    links?: VoiceOpsRecoveryLinks;
+    providers?: readonly TProvider[];
+    traceDeliveryDeadLetters?: VoiceTraceSinkDeliveryStore;
+    traceDeliveries?: VoiceTraceSinkDeliveryStore;
+    traces?: VoiceTraceEventStore;
+};
+export type VoiceOpsRecoveryRoutesOptions<TProvider extends string = string> = VoiceOpsRecoveryReportOptions<TProvider> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceOpsRecoveryReport<TProvider>) => string | Promise<string>;
+    title?: string;
+};
+export declare const buildVoiceOpsRecoveryReport: <TProvider extends string = string>(options?: VoiceOpsRecoveryReportOptions<TProvider>) => Promise<VoiceOpsRecoveryReport<TProvider>>;
+export declare const buildVoiceOpsRecoveryReadinessCheck: (report: VoiceOpsRecoveryReport, options?: {
+    href?: string;
+    label?: string;
+}) => VoiceProductionReadinessCheck;
+export declare const renderVoiceOpsRecoveryMarkdown: (report: VoiceOpsRecoveryReport, options?: {
+    title?: string;
+}) => string;
+export declare const renderVoiceOpsRecoveryHTML: (report: VoiceOpsRecoveryReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceOpsRecoveryRoutes: <TProvider extends string = string>(options?: VoiceOpsRecoveryRoutesOptions<TProvider>) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceOpsRecoveryReport<TProvider>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/productionReadiness.d.ts

@@ -13,6 +13,7 @@ import type { VoiceAuditEventStore, VoiceAuditEventType, VoiceAuditOutcome } fro
 import { type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceProviderContractMatrixReport, VoiceProviderStackCapabilityGapReport } from './providerStackRecommendations';
 import type { VoiceCampaignReadinessProofReport } from './campaign';
+import { type VoiceOpsRecoveryReport } from './opsRecovery';
 export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
 export type VoiceProductionReadinessAction = {
     description?: string;
@@ -90,6 +91,7 @@ export type VoiceProductionReadinessReport = {
         liveLatency?: string;
         operationsRecords?: string;
         opsActions?: string;
+        opsRecovery?: string;
         phoneAgentSmoke?: string;
         providerContracts?: string;
         providerRoutingContracts?: string;
@@ -145,6 +147,12 @@ export type VoiceProductionReadinessReport = {
             warnings: number;
         };
         opsActionHistory?: VoiceProductionReadinessOpsActionHistorySummary;
+        opsRecovery?: {
+            issues: number;
+            recoveredFallbacks: number;
+            status: VoiceProductionReadinessStatus;
+            unresolvedProviderFailures: number;
+        };
         providers: {
             degraded: number;
             total: number;
@@ -318,6 +326,10 @@ export type VoiceProductionReadinessRoutesOptions = {
     llmProviders?: readonly string[];
     name?: string;
     opsActionHistory?: false | VoiceProductionReadinessOpsActionHistoryOptions;
+    opsRecovery?: false | VoiceOpsRecoveryReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceOpsRecoveryReport> | VoiceOpsRecoveryReport);
     path?: string;
     phoneAgentSmokes?: false | readonly VoicePhoneAgentProductionSmokeReport[] | ((input: {
         query: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.195",
+	"version": "0.0.22-beta.197",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",