@absolutejs/voice 0.0.22-beta.183 → 0.0.22-beta.184

package/dist/index.d.ts

@@ -105,7 +105,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, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
+export type { VoiceProductionReadinessAction, VoiceProductionReadinessAuditOptions, VoiceProductionReadinessAuditRequirement, VoiceProductionReadinessAuditSummary, VoiceProductionReadinessCheck, VoiceProductionReadinessGateIssue, VoiceProductionReadinessGateOptions, VoiceProductionReadinessGateProfile, VoiceProductionReadinessGateProfileSurface, VoiceProductionReadinessGateReport, VoiceProductionReadinessOpsActionHistoryOptions, VoiceProductionReadinessOpsActionHistorySummary, VoiceProductionReadinessOperationsRecordLink, VoiceProductionReadinessOperationsRecordLinks, VoiceProductionReadinessProfileExplanation, VoiceProductionReadinessProfileSurface, VoiceProductionReadinessProofSource, VoiceProductionReadinessReport, VoiceProductionReadinessRoutesOptions, VoiceProductionReadinessTraceDeliverySummary, VoiceProductionReadinessAuditDeliveryOptions, VoiceProductionReadinessAuditDeliverySummary, VoiceProductionReadinessTraceDeliveryOptions, VoiceProductionReadinessStatus } from './productionReadiness';
 export type { VoiceReadinessProfileName, VoiceReadinessProfileOptions, VoiceReadinessProfileRecommendation, VoiceReadinessProfileRecommendationScore, VoiceReadinessProfileRoutesOptions } from './readinessProfiles';
 export type { VoiceProviderStackChoice, VoiceProviderStackCapabilities, VoiceProviderStackCapabilityGap, VoiceProviderStackCapabilityGapInput, VoiceProviderStackCapabilityGapReport, VoiceProviderContractCheck, VoiceProviderContractCheckStatus, VoiceProviderContractDefinition, VoiceProviderContractMatrixHandlerOptions, VoiceProviderContractMatrixHTMLHandlerOptions, VoiceProviderContractMatrixInput, VoiceProviderContractMatrixPresetOptions, VoiceProviderContractMatrixReport, VoiceProviderContractMatrixRoutesOptions, VoiceProviderContractMatrixRow, VoiceProviderStackInput, VoiceProviderStackKind, VoiceProviderStackRecommendation } from './providerStackRecommendations';
 export type { VoiceOperationsRecord, VoiceOperationsRecordAgentHandoff, VoiceOperationsRecordAuditSummary, VoiceOperationsRecordOptions, VoiceOperationsRecordOutcome, VoiceOperationsRecordRoutesOptions, VoiceOperationsRecordStatus, VoiceOperationsRecordTool } from './operationsRecord';

package/dist/index.js

@@ -20482,6 +20482,7 @@ var readinessGateCodes = {
   "Delivery runtime": "voice.readiness.delivery_runtime",
   "Handoff delivery": "voice.readiness.handoff_delivery",
   "Live latency proof": "voice.readiness.live_latency",
+  "Operations records": "voice.readiness.operations_records",
   "Operator action history": "voice.readiness.operator_action_history",
   "Phone agent production smoke": "voice.readiness.phone_agent_smoke",
   "Provider contract matrix": "voice.readiness.provider_contract_matrix",
@@ -20810,6 +20811,46 @@ var summarizeLiveLatency = (events, options) => {
     warnings
   };
 };
+var getString12 = (value) => typeof value === "string" ? value : undefined;
+var getNumber7 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var voiceOperationsRecordHref = (base, sessionId) => {
+  const encoded = encodeURIComponent(sessionId);
+  if (base.includes(":sessionId")) {
+    return base.replace(":sessionId", encoded);
+  }
+  return `${base.replace(/\/+$/, "")}/${encoded}`;
+};
+var buildOperationsRecordLinks = (input) => {
+  const failedSessionSet = new Set(input.failedSessionIds);
+  const providerErrors = input.events.filter((event) => event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.error === "string")).map((event) => ({
+    detail: getString12(event.payload.error),
+    href: voiceOperationsRecordHref(input.base, event.sessionId),
+    label: "Open provider error operations record",
+    sessionId: event.sessionId,
+    status: "fail"
+  }));
+  const failingLatency = input.events.filter((event) => event.type === "client.live_latency").map((event) => ({
+    event,
+    latencyMs: getNumber7(event.payload.latencyMs) ?? getNumber7(event.payload.elapsedMs)
+  })).filter((entry) => entry.latencyMs !== undefined && entry.latencyMs > input.liveLatencyWarnAfterMs).map(({ event, latencyMs }) => ({
+    detail: `${latencyMs}ms live latency`,
+    href: voiceOperationsRecordHref(input.base, event.sessionId),
+    label: "Open latency operations record",
+    sessionId: event.sessionId,
+    status: latencyMs > input.liveLatencyFailAfterMs ? "fail" : "warn"
+  }));
+  return {
+    failedSessions: input.failedSessionIds.map((sessionId) => ({
+      href: voiceOperationsRecordHref(input.base, sessionId),
+      label: "Open failed session operations record",
+      sessionId,
+      status: failedSessionSet.has(sessionId) ? "fail" : "warn"
+    })),
+    failingLatency,
+    providerErrors
+  };
+};
+var firstOperationsRecordHref = (links) => links[0]?.href;
 var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const request = input.request ?? new Request("http://localhost/");
   const query = input.query ?? {};
@@ -20873,6 +20914,14 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const deliveryRuntime = summarizeDeliveryRuntime(deliveryRuntimeSummary);
   const degradedProviders = providers.filter((provider) => provider.status === "degraded" || provider.status === "rate-limited" || provider.status === "suppressed").length;
   const failedSessions = sessions.filter((session) => session.status === "failed").length;
+  const failedSessionItems = sessions.filter((session) => session.status === "failed");
+  const operationsRecords = buildOperationsRecordLinks({
+    base: options.links?.operationsRecords ?? "/voice-operations",
+    events,
+    failedSessionIds: failedSessionItems.map((session) => session.sessionId),
+    liveLatencyFailAfterMs: options.liveLatencyFailAfterMs ?? 3200,
+    liveLatencyWarnAfterMs: options.liveLatencyWarnAfterMs ?? 1800
+  });
   const checks = [
     {
       detail: quality.status === "pass" ? "Quality gates are passing." : "Quality gates need attention.",
@@ -20904,11 +20953,18 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     },
     {
       detail: providerRecovery.unresolvedErrors > 0 ? `${providerRecovery.unresolvedErrors} provider error(s) have no recovered fallback evidence.` : providerRecovery.recovered > 0 ? `${providerRecovery.recovered} provider fallback recovery event(s) kept sessions healthy.` : "No provider fallback recovery was needed in the current trace window.",
-      href: options.links?.resilience ?? "/resilience",
+      href: firstOperationsRecordHref(operationsRecords.providerErrors) ?? options.links?.resilience ?? "/resilience",
       label: "Provider fallback recovery",
       status: providerRecovery.status,
       value: providerRecovery.total === 0 ? "0 events" : `${providerRecovery.recovered}/${providerRecovery.total}`,
       actions: providerRecovery.status === "pass" ? [] : [
+        ...firstOperationsRecordHref(operationsRecords.providerErrors) ? [
+          {
+            description: "Open the exact call/session operations record for the first unresolved provider error.",
+            href: firstOperationsRecordHref(operationsRecords.providerErrors),
+            label: "Open failing operations record"
+          }
+        ] : [],
         {
           description: "Open provider resilience traces and inspect unresolved provider errors.",
           href: options.links?.resilience ?? "/resilience",
@@ -20918,11 +20974,18 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
     },
     {
       detail: failedSessions === 0 ? sessions.length > 0 ? "Recent sessions have no recorded provider/session failures." : "No sessions have been recorded yet; run a smoke or live session for proof." : `${failedSessions} recent session(s) have failures.`,
-      href: options.links?.sessions ?? "/sessions",
+      href: firstOperationsRecordHref(operationsRecords.failedSessions) ?? options.links?.sessions ?? "/sessions",
       label: "Session health",
       status: failedSessions > 0 ? "fail" : sessions.length === 0 ? "warn" : "pass",
       value: `${sessions.length - failedSessions}/${sessions.length}`,
       actions: failedSessions > 0 ? [
+        ...firstOperationsRecordHref(operationsRecords.failedSessions) ? [
+          {
+            description: "Open the exact failed call/session operations record.",
+            href: firstOperationsRecordHref(operationsRecords.failedSessions),
+            label: "Open failed operations record"
+          }
+        ] : [],
         {
           description: "Open failed sessions and replay traces.",
           href: `${options.links?.sessions ?? "/sessions"}?status=failed`,
@@ -20974,12 +21037,19 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
   const proofSource = (...keys) => keys.map((key) => proofSources?.[key]).find((source) => source !== undefined);
   checks.push({
     detail: liveLatency.total === 0 ? "No browser live-latency measurements are recorded yet." : liveLatency.status === "pass" ? `Live browser turn latency averages ${liveLatency.averageLatencyMs}ms.` : `${liveLatency.failed} failed and ${liveLatency.warnings} warned live-latency measurement(s).`,
-    href: options.links?.liveLatency ?? "/traces",
+    href: firstOperationsRecordHref(operationsRecords.failingLatency) ?? options.links?.liveLatency ?? "/traces",
     label: "Live latency proof",
     proofSource: proofSource("liveLatency", "liveLatencyProof"),
     status: liveLatency.status,
     value: liveLatency.averageLatencyMs === undefined ? `${liveLatency.total} samples` : `${liveLatency.averageLatencyMs}ms avg`,
     actions: liveLatency.status === "pass" ? [] : [
+      ...firstOperationsRecordHref(operationsRecords.failingLatency) ? [
+        {
+          description: "Open the exact call/session operations record for the slow live turn.",
+          href: firstOperationsRecordHref(operationsRecords.failingLatency),
+          label: "Open latency operations record"
+        }
+      ] : [],
       {
         description: "Run a live browser voice turn and inspect the persisted latency trace.",
         href: options.links?.liveLatency ?? "/traces",
@@ -21260,6 +21330,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       handoffs: "/handoffs",
       handoffRetry: "/api/voice-handoffs/retry",
       liveLatency: "/traces",
+      operationsRecords: "/voice-operations",
       opsActions: "/voice/ops-actions",
       phoneAgentSmoke: "/sessions",
       providerContracts: "/provider-contracts",
@@ -21272,6 +21343,7 @@ var buildVoiceProductionReadinessReport = async (options, input = {}) => {
       ...options.links
     },
     profile: options.profile || undefined,
+    operationsRecords,
     proofSources,
     status: rollupStatus2(checks),
     summary: {
@@ -22193,11 +22265,11 @@ import { Elysia as Elysia37 } from "elysia";
 // src/traceTimeline.ts
 import { Elysia as Elysia36 } from "elysia";
 var escapeHtml38 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString12 = (value) => typeof value === "string" && value.trim() ? value : undefined;
-var getNumber7 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var getString13 = (value) => typeof value === "string" && value.trim() ? value : undefined;
+var getNumber8 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var firstString3 = (payload, keys) => {
   for (const key of keys) {
-    const value = getString12(payload[key]);
+    const value = getString13(payload[key]);
     if (value) {
       return value;
     }
@@ -22206,7 +22278,7 @@ var firstString3 = (payload, keys) => {
 };
 var firstNumber3 = (payload, keys) => {
   for (const key of keys) {
-    const value = getNumber7(payload[key]);
+    const value = getNumber8(payload[key]);
     if (value !== undefined) {
       return value;
     }
@@ -22234,15 +22306,15 @@ var timelineLabel = (event) => {
     case "turn.transcript":
       return event.payload.isFinal === true ? "Final transcript" : "Partial transcript";
     case "turn.committed":
-      return `Committed turn${getString12(event.payload.reason) ? ` (${getString12(event.payload.reason)})` : ""}`;
+      return `Committed turn${getString13(event.payload.reason) ? ` (${getString13(event.payload.reason)})` : ""}`;
     case "turn.assistant":
       return "Assistant reply";
     case "agent.model":
       return `Model call${eventProvider(event) ? ` via ${eventProvider(event)}` : ""}`;
     case "agent.tool":
-      return `Tool ${getString12(event.payload.toolName) ?? "call"}`;
+      return `Tool ${getString13(event.payload.toolName) ?? "call"}`;
     case "agent.handoff":
-      return `Agent handoff${getString12(event.payload.targetAgentId) ? ` to ${getString12(event.payload.targetAgentId)}` : ""}`;
+      return `Agent handoff${getString13(event.payload.targetAgentId) ? ` to ${getString13(event.payload.targetAgentId)}` : ""}`;
     case "assistant.run":
       return `Assistant run${eventProvider(event) ? ` via ${eventProvider(event)}` : ""}`;
     case "assistant.guardrail":
@@ -22252,11 +22324,11 @@ var timelineLabel = (event) => {
     case "client.live_latency":
       return `Live latency${eventElapsedMs(event) !== undefined ? ` ${eventElapsedMs(event)}ms` : ""}`;
     case "session.error":
-      return `Error${getString12(event.payload.error) ? `: ${getString12(event.payload.error)}` : ""}`;
+      return `Error${getString13(event.payload.error) ? `: ${getString13(event.payload.error)}` : ""}`;
     case "turn.cost":
       return "Cost telemetry";
     case "turn_latency.stage":
-      return `Latency ${getString12(event.payload.stage) ?? "stage"}`;
+      return `Latency ${getString13(event.payload.stage) ?? "stage"}`;
     case "workflow.contract":
       return `Workflow contract ${eventStatus(event) ?? ""}`.trim();
     default:
@@ -22449,26 +22521,26 @@ var createVoiceTraceTimelineRoutes = (options) => {
 };
 
 // src/operationsRecord.ts
-var getString13 = (value) => typeof value === "string" ? value : undefined;
-var getNumber8 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var getString14 = (value) => typeof value === "string" ? value : undefined;
+var getNumber9 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var countOutcome = (events, outcome) => events.filter((event) => event.outcome === outcome).length;
 var toHandoff = (event) => ({
   at: event.at,
-  fromAgentId: getString13(event.payload.fromAgentId),
+  fromAgentId: getString14(event.payload.fromAgentId),
   metadata: event.payload.metadata && typeof event.payload.metadata === "object" && !Array.isArray(event.payload.metadata) ? event.payload.metadata : undefined,
-  reason: getString13(event.payload.reason),
-  status: getString13(event.payload.status),
-  summary: getString13(event.payload.summary),
-  targetAgentId: getString13(event.payload.targetAgentId),
+  reason: getString14(event.payload.reason),
+  status: getString14(event.payload.status),
+  summary: getString14(event.payload.summary),
+  targetAgentId: getString14(event.payload.targetAgentId),
   turnId: event.turnId
 });
 var toTool = (event) => ({
   at: event.at,
-  elapsedMs: getNumber8(event.payload.elapsedMs),
-  error: getString13(event.payload.error),
-  status: getString13(event.payload.status),
-  toolCallId: getString13(event.payload.toolCallId),
-  toolName: getString13(event.payload.toolName),
+  elapsedMs: getNumber9(event.payload.elapsedMs),
+  error: getString14(event.payload.error),
+  status: getString14(event.payload.status),
+  toolCallId: getString14(event.payload.toolCallId),
+  toolName: getString14(event.payload.toolName),
   turnId: event.turnId
 });
 var resolveOutcome4 = (events) => {
@@ -23191,8 +23263,8 @@ var createVoiceTTSProviderRouter = (options) => {
 // src/traceDeliveryRoutes.ts
 import { Elysia as Elysia39 } from "elysia";
 var escapeHtml41 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var getString14 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
-var getNumber9 = (value) => {
+var getString15 = (value) => typeof value === "string" && value.trim() ? value.trim() : undefined;
+var getNumber10 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
   }
@@ -23203,13 +23275,13 @@ var getNumber9 = (value) => {
   return;
 };
 var parseStatus2 = (value) => {
-  const text = getString14(value);
+  const text = getString15(value);
   return text === "pending" || text === "delivered" || text === "failed" || text === "skipped" || text === "all" ? text : undefined;
 };
 var resolveVoiceTraceDeliveryFilter = (query = {}, base = {}) => ({
   ...base,
-  limit: getNumber9(query.limit) ?? base.limit,
-  q: getString14(query.q) ?? base.q,
+  limit: getNumber10(query.limit) ?? base.limit,
+  q: getString15(query.q) ?? base.q,
   status: parseStatus2(query.status) ?? base.status
 });
 var deliverySearchText2 = (delivery) => [

package/dist/productionReadiness.d.ts

@@ -86,6 +86,7 @@ export type VoiceProductionReadinessReport = {
         handoffs?: string;
         handoffRetry?: string;
         liveLatency?: string;
+        operationsRecords?: string;
         opsActions?: string;
         phoneAgentSmoke?: string;
         providerContracts?: string;
@@ -98,6 +99,7 @@ export type VoiceProductionReadinessReport = {
     };
     profile?: VoiceProductionReadinessProfileExplanation;
     proofSources?: Record<string, VoiceProductionReadinessProofSource>;
+    operationsRecords?: VoiceProductionReadinessOperationsRecordLinks;
     status: VoiceProductionReadinessStatus;
     summary: {
         agentSquadContracts?: {
@@ -174,6 +176,18 @@ export type VoiceProductionReadinessReport = {
         traceDeliveries?: VoiceProductionReadinessTraceDeliverySummary;
     };
 };
+export type VoiceProductionReadinessOperationsRecordLink = {
+    detail?: string;
+    href: string;
+    label: string;
+    sessionId: string;
+    status: VoiceProductionReadinessStatus;
+};
+export type VoiceProductionReadinessOperationsRecordLinks = {
+    failedSessions: VoiceProductionReadinessOperationsRecordLink[];
+    failingLatency: VoiceProductionReadinessOperationsRecordLink[];
+    providerErrors: VoiceProductionReadinessOperationsRecordLink[];
+};
 export type VoiceProductionReadinessAuditRequirement = {
     label?: string;
     maxAgeMs?: number;

package/package.json

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