@absolutejs/voice 0.0.22-beta.366 → 0.0.22-beta.367

package/dist/index.d.ts

@@ -72,7 +72,7 @@ export { buildVoiceProviderOrchestrationReport, createVoiceProviderOrchestration
 export { assertVoiceProviderRoutingContractEvidence, assertVoiceProviderRoutingContract, evaluateVoiceProviderRoutingContractEvidence, runVoiceProviderRoutingContract } from './providerRoutingContract';
 export { assertVoiceProviderSloEvidence, buildVoiceProviderSloReport, createVoiceProviderSloRoutes, evaluateVoiceProviderSloEvidence, renderVoiceProviderSloHTML, renderVoiceProviderSloMarkdown } from './providerSlo';
 export { createVoicePhoneAgentProductionSmokeHTMLHandler, createVoicePhoneAgentProductionSmokeJSONHandler, createVoicePhoneAgentProductionSmokeRoutes, renderVoicePhoneAgentProductionSmokeHTML, runVoicePhoneAgentProductionSmokeContract } from './phoneAgentProductionSmoke';
-export { assertVoiceProductionReadinessEvidence, buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessRoutes, evaluateVoiceProductionReadinessEvidence, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
+export { assertVoiceProductionReadinessEvidence, buildVoiceProductionReadinessGate, buildVoiceProductionReadinessReport, createVoiceProductionReadinessProofRuntime, createVoiceProductionReadinessRoutes, evaluateVoiceProductionReadinessEvidence, renderVoiceProductionReadinessHTML, summarizeVoiceProductionReadinessGate } from './productionReadiness';
 export { acknowledgeVoiceMonitorIssue, buildVoiceMonitorRunReport, createVoiceMemoryMonitorIssueStore, createVoiceMemoryMonitorNotifierDeliveryReceiptStore, createVoiceMonitorRoutes, createVoiceMonitorRunner, createVoiceMonitorRunnerRoutes, createVoiceMonitorWebhookNotifier, deliverVoiceMonitorIssueNotifications, muteVoiceMonitorIssue, renderVoiceMonitorHTML, renderVoiceMonitorMarkdown, resolveVoiceMonitorIssue } from './voiceMonitoring';
 export { createVoiceReadinessProfile, recommendVoiceReadinessProfile } from './readinessProfiles';
 export { assertVoiceProviderContractMatrixEvidence, assertVoiceProviderStackEvidence, buildVoiceProviderContractMatrix, createVoiceProviderContractMatrixHTMLHandler, createVoiceProviderContractMatrixJSONHandler, createVoiceProviderContractMatrixPreset, createVoiceProviderContractMatrixRoutes, evaluateVoiceProviderContractMatrixEvidence, evaluateVoiceProviderStackEvidence, evaluateVoiceProviderStackGaps, renderVoiceProviderContractMatrixHTML, recommendVoiceProviderStack } from './providerStackRecommendations';
@@ -142,7 +142,7 @@ export type { VoicePhoneAgentCarrier, VoicePhoneAgentCarrierSummary, VoicePhoneA
 export type { VoicePhoneAgentProductionSmokeIssue, VoicePhoneAgentProductionSmokeHandlerOptions, VoicePhoneAgentProductionSmokeHTMLHandlerOptions, VoicePhoneAgentProductionSmokeOptions, VoicePhoneAgentProductionSmokeReport, VoicePhoneAgentProductionSmokeRoutesOptions, VoicePhoneAgentProductionSmokeRequirement } from './phoneAgentProductionSmoke';
 export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceOpsStatus, VoiceOpsStatusLink, VoiceOpsStatusOptions, VoiceOpsStatusReport, VoiceOpsStatusRoutesOptions } from './opsStatus';
-export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateExplanation, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRouteInput, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessAssertionInput, VoiceProductionReadinessAssertionReport, VoiceProductionReadinessCheck, VoiceProductionReadinessGateExplanation, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofMetadata, VoiceProductionReadinessProofRuntime, VoiceProductionReadinessProofRuntimeOptions, VoiceProductionReadinessProofRuntimeSeedOptions, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRouteInput, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceMonitorDefinition, VoiceMonitorEvaluation, VoiceMonitorEvaluationInput, VoiceMonitorIssue, VoiceMonitorIssueStatus, VoiceMonitorIssueStore, VoiceMonitorNotifier, VoiceMonitorNotifierDeliveryInput, VoiceMonitorNotifierDeliveryOptions, VoiceMonitorNotifierDeliveryReceipt, VoiceMonitorNotifierDeliveryReceiptStore, VoiceMonitorNotifierDeliveryReport, VoiceMonitorNotifierDeliveryResult, VoiceMonitorRoutesOptions, VoiceMonitorRun, VoiceMonitorRunOptions, VoiceMonitorRunReport, VoiceMonitorRunner, VoiceMonitorRunnerOptions, VoiceMonitorRunnerRoutesOptions, VoiceMonitorRunnerTickResult, VoiceMonitorSeverity, VoiceMonitorStatus, VoiceMonitorWebhookNotifierOptions } from './voiceMonitoring';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixAssertionInput, VoiceProviderContractMatrixAssertionReport, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackAssertionInput, VoiceProviderStackAssertionReport, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';

package/dist/index.js

@@ -31830,6 +31830,176 @@ var createVoiceObservabilityExportRoutes = (options = {}) => {
 
 // src/productionReadiness.ts
 var escapeHtml52 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatVoiceProofFreshnessDuration = (valueMs) => {
+  if (valueMs < 1000) {
+    return `${Math.max(0, Math.round(valueMs))}ms`;
+  }
+  if (valueMs < 60000) {
+    return `${Math.round(valueMs / 1000)}s`;
+  }
+  return `${Math.round(valueMs / 60000)}m`;
+};
+var createVoiceProductionReadinessProofRuntime = (options = {}) => {
+  const store = createVoiceMemoryTraceEventStore();
+  const cacheMs = options.cacheMs ?? 1e4;
+  const traceMaxAgeMs = options.traceMaxAgeMs ?? 30 * 60 * 1000;
+  const freshnessMaxAgeMs = options.freshnessMaxAgeMs ?? traceMaxAgeMs;
+  const proofSource = options.proofSource ?? "production-readiness";
+  const readinessHref = options.readinessHref ?? "/api/production-readiness";
+  const trendsHref = options.trendsHref ?? "/voice/proof-trends";
+  const runId = options.runId ?? (() => `production-readiness-${Date.now()}-${crypto.randomUUID()}`);
+  let metadata;
+  let refreshPromise;
+  let refreshedAt = 0;
+  const cachedValues = new Map;
+  const resetTraceProof = async () => {
+    await Promise.all((await store.list()).map((event) => store.remove(event.id)));
+  };
+  const seedTraceProof = async (seed = {}) => {
+    await resetTraceProof();
+    const now = Date.now();
+    const sessionId = seed.sessionId ?? `production-readiness-trace-${now}`;
+    const scenarioId = seed.scenarioId ?? "production-readiness-proof";
+    const events = [
+      createVoiceTraceEvent({
+        at: now,
+        payload: {
+          elapsedMs: seed.llmElapsedMs ?? 320,
+          kind: "llm",
+          provider: seed.llmProvider ?? "llm",
+          providerStatus: "success",
+          selectedProvider: seed.llmProvider ?? "llm",
+          status: "success"
+        },
+        scenarioId,
+        sessionId,
+        type: "session.error"
+      }),
+      createVoiceTraceEvent({
+        at: now + 1,
+        payload: {
+          elapsedMs: seed.sttElapsedMs ?? 82,
+          kind: "stt",
+          provider: seed.sttProvider ?? "stt",
+          providerStatus: "success",
+          selectedProvider: seed.sttProvider ?? "stt",
+          status: "success"
+        },
+        scenarioId,
+        sessionId,
+        type: "session.error"
+      }),
+      createVoiceTraceEvent({
+        at: now + 2,
+        payload: {
+          elapsedMs: seed.ttsElapsedMs ?? 45,
+          kind: "tts",
+          provider: seed.ttsProvider ?? "tts",
+          providerStatus: "success",
+          selectedProvider: seed.ttsProvider ?? "tts",
+          status: "success"
+        },
+        scenarioId,
+        sessionId,
+        type: "session.error"
+      }),
+      createVoiceTraceEvent({
+        at: now + 3,
+        metadata: {
+          source: "browser",
+          surface: "live-latency-proof"
+        },
+        payload: {
+          completedAt: now + 3,
+          elapsedMs: seed.liveLatencyMs ?? 420,
+          latencyMs: seed.liveLatencyMs ?? 420,
+          startedAt: now + 3 - (seed.liveLatencyMs ?? 420),
+          status: "assistant_audio_started",
+          thresholdMs: 1800
+        },
+        scenarioId,
+        sessionId,
+        traceId: `production-readiness-live-latency-${now}`,
+        type: "client.live_latency"
+      })
+    ];
+    return Promise.all(events.map((event) => store.append(event)));
+  };
+  const refresh = (onRefresh) => {
+    if (refreshPromise && Date.now() - refreshedAt < cacheMs) {
+      return refreshPromise;
+    }
+    refreshPromise = (async () => {
+      const generatedAt = new Date().toISOString();
+      const nextMetadata = {
+        generatedAt,
+        refreshedAt: Date.now(),
+        runId: runId(),
+        source: proofSource
+      };
+      metadata = nextMetadata;
+      await onRefresh?.(nextMetadata);
+      return nextMetadata;
+    })().finally(() => {
+      refreshedAt = Date.now();
+    });
+    return refreshPromise;
+  };
+  const cache = async (key, loader, valueCacheMs = cacheMs) => {
+    const cached = cachedValues.get(key);
+    if (cached && Date.now() - cached.loadedAt < valueCacheMs) {
+      return cached.value;
+    }
+    const value = Promise.resolve(loader());
+    cachedValues.set(key, {
+      loadedAt: Date.now(),
+      value
+    });
+    return value;
+  };
+  const buildFreshnessCheck = async () => {
+    await refresh();
+    const now = Date.now();
+    const proofAgeMs = metadata ? now - metadata.refreshedAt : undefined;
+    const cacheAgeMs = refreshedAt ? now - refreshedAt : undefined;
+    const status = metadata && (proofAgeMs ?? Infinity) <= freshnessMaxAgeMs ? "pass" : "fail";
+    return {
+      detail: metadata ? `Proof ${metadata.runId} refreshed ${formatVoiceProofFreshnessDuration(proofAgeMs ?? 0)} ago; route cache age is ${formatVoiceProofFreshnessDuration(cacheAgeMs ?? 0)}.` : "Production readiness proof has not been refreshed yet.",
+      gateExplanation: {
+        evidenceHref: readinessHref,
+        observed: proofAgeMs ?? 0,
+        remediation: "Reload production readiness to refresh provider SLO, live latency, proof-pack, trend, and observability export proof.",
+        sourceHref: trendsHref,
+        threshold: freshnessMaxAgeMs,
+        thresholdLabel: "Maximum proof age",
+        unit: "ms"
+      },
+      href: options.freshnessHref ?? trendsHref,
+      label: options.freshnessLabel ?? "Proof freshness",
+      proofSource: {
+        detail: "Generated by the production readiness refresh path before the deploy gate evaluates cached route results.",
+        href: readinessHref,
+        source: metadata?.source ?? proofSource,
+        sourceLabel: options.proofSourceLabel ?? "Production readiness proof refresh"
+      },
+      status,
+      value: metadata ? `${formatVoiceProofFreshnessDuration(proofAgeMs ?? 0)} old` : "missing"
+    };
+  };
+  return {
+    buildFreshnessCheck,
+    cache,
+    getMetadata: () => metadata,
+    options: {
+      cacheMs,
+      traceMaxAgeMs
+    },
+    refresh,
+    resetTraceProof,
+    seedTraceProof,
+    store
+  };
+};
 var rollupStatus4 = (checks) => checks.some((check) => check.status === "fail") ? "fail" : checks.some((check) => check.status === "warn") ? "warn" : "pass";
 var readinessGateCodes = {
   "Agent squad contracts": "voice.readiness.agent_squad_contracts",
@@ -38273,6 +38443,7 @@ export {
   createVoiceProfileSwitchPolicyProofRoutes,
   createVoiceProfileSwitchLiveDecisionRoutes,
   createVoiceProductionReadinessRoutes,
+  createVoiceProductionReadinessProofRuntime,
   createVoicePostgresTraceSinkDeliveryStore,
   createVoicePostgresTraceEventStore,
   createVoicePostgresTelnyxWebhookEventStore,

package/dist/productionReadiness.d.ts

@@ -3,7 +3,7 @@ import { type VoiceProviderFallbackRecoverySummary } from './sessionReplay';
 import { type VoiceTelephonyCarrierMatrixInput } from './telephony/matrix';
 import { type VoiceTelephonyWebhookSecurityOptions, type VoiceTelephonyWebhookSecurityReport } from './telephony/security';
 import type { VoiceMonitorNotifierDeliveryReport, VoiceMonitorRunReport } from './voiceMonitoring';
-import type { VoiceTraceEventStore } from './trace';
+import { type StoredVoiceTraceEvent, type VoiceTraceEventStore } from './trace';
 import type { VoiceTraceSinkDeliveryStore } from './trace';
 import type { VoiceAgentSquadContractReport } from './agentSquadContract';
 import type { VoiceBargeInReport } from './bargeInRoutes';
@@ -110,6 +110,45 @@ export type VoiceProductionReadinessProfileExplanation = {
     purpose: string;
     surfaces: VoiceProductionReadinessProfileSurface[];
 };
+export type VoiceProductionReadinessProofMetadata = {
+    generatedAt: string;
+    refreshedAt: number;
+    runId: string;
+    source: string;
+};
+export type VoiceProductionReadinessProofRuntimeSeedOptions = {
+    liveLatencyMs?: number;
+    llmElapsedMs?: number;
+    llmProvider?: string;
+    scenarioId?: string;
+    sessionId?: string;
+    sttElapsedMs?: number;
+    sttProvider?: string;
+    ttsElapsedMs?: number;
+    ttsProvider?: string;
+};
+export type VoiceProductionReadinessProofRuntimeOptions = {
+    cacheMs?: number;
+    freshnessHref?: string;
+    freshnessLabel?: string;
+    freshnessMaxAgeMs?: number;
+    proofSource?: string;
+    proofSourceLabel?: string;
+    readinessHref?: string;
+    runId?: () => string;
+    traceMaxAgeMs?: number;
+    trendsHref?: string;
+};
+export type VoiceProductionReadinessProofRuntime = {
+    buildFreshnessCheck: () => Promise<VoiceProductionReadinessCheck>;
+    cache: <TValue>(key: string, loader: () => Promise<TValue> | TValue, cacheMs?: number) => Promise<TValue>;
+    getMetadata: () => VoiceProductionReadinessProofMetadata | undefined;
+    options: Pick<VoiceProductionReadinessRoutesOptions, 'cacheMs' | 'traceMaxAgeMs'>;
+    refresh: (onRefresh?: (metadata: VoiceProductionReadinessProofMetadata) => Promise<void> | void) => Promise<VoiceProductionReadinessProofMetadata>;
+    resetTraceProof: () => Promise<void>;
+    seedTraceProof: (options?: VoiceProductionReadinessProofRuntimeSeedOptions) => Promise<StoredVoiceTraceEvent[]>;
+    store: VoiceTraceEventStore;
+};
 export type VoiceProductionReadinessGateProfileSurface = VoiceProductionReadinessProfileSurface & {
     issues: VoiceProductionReadinessGateIssue[];
     status: VoiceProductionReadinessStatus;
@@ -590,6 +629,7 @@ export type VoiceProductionReadinessRoutesOptions = {
     monitoringNotifierDeliveryFailAfterMs?: number;
     reconnectResumeFailAfterMs?: number;
 };
+export declare const createVoiceProductionReadinessProofRuntime: (options?: VoiceProductionReadinessProofRuntimeOptions) => VoiceProductionReadinessProofRuntime;
 export declare const summarizeVoiceProductionReadinessGate: (report: VoiceProductionReadinessReport, options?: VoiceProductionReadinessGateOptions) => VoiceProductionReadinessGateReport;
 export declare const evaluateVoiceProductionReadinessEvidence: (report: VoiceProductionReadinessReport, input?: VoiceProductionReadinessAssertionInput) => VoiceProductionReadinessAssertionReport;
 export declare const assertVoiceProductionReadinessEvidence: (report: VoiceProductionReadinessReport, input?: VoiceProductionReadinessAssertionInput) => VoiceProductionReadinessAssertionReport;

package/package.json

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