@absolutejs/voice 0.0.22-beta.443 → 0.0.22-beta.445

package/dist/client/index.js

@@ -6428,6 +6428,9 @@ var readRealCallProfileTraceSurfaces = (events) => {
     if (event.type === "client.barge_in") {
       surfaces.add("barge-in");
     }
+    if (event.type === "client.reconnect") {
+      surfaces.add("reconnect");
+    }
   }
   return [...surfaces].sort();
 };
@@ -6869,7 +6872,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
       warnings.push(`Required real-call profile ${profileId} has ${String(summaryProfile?.sessionCount ?? 0)} session(s), expected at least ${String(options.minProfileSessions)}.`);
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     for (const surface of requiredSurfaces) {
       if (!observedSurfaces.has(surface)) {
@@ -6908,6 +6911,16 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var resolveRequiredRealCallProfileSurfaces = (requiredProfileSurfaces, profileId) => {
+  if (requiredProfileSurfaces === undefined) {
+    return [];
+  }
+  if (Array.isArray(requiredProfileSurfaces)) {
+    return requiredProfileSurfaces;
+  }
+  const requiredSurfacesByProfile = requiredProfileSurfaces;
+  return requiredSurfacesByProfile[profileId] ?? [];
+};
 var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
   action.label ?? action.id ?? "recovery action",
@@ -7180,10 +7193,16 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
       return true;
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
   });
+  const resolveRequiredProfileSurfaces = (profileId) => {
+    if (typeof profileId !== "string") {
+      return [];
+    }
+    return resolveRequiredRealCallProfileSurfaces(options.requiredProfileSurfaces, profileId);
+  };
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
   const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
   if (needsProfileProof) {
@@ -7206,6 +7225,19 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
         method: "POST",
         profileId
       });
+      const requiredSurfaces = resolveRequiredProfileSurfaces(profileId);
+      const summaryProfile = typeof profileId === "string" ? summariesByProfile.get(profileId) : undefined;
+      const observedSurfaces = new Set((summaryProfile?.surfaces ?? []).filter((value) => typeof value === "string"));
+      if (requiredSurfaces.includes("reconnect") && !observedSurfaces.has("reconnect")) {
+        actions.push({
+          description: profileId ? `Run reconnect profile proof for ${profileId} when reconnect stability is required for this profile.` : "Run reconnect profile proof when required profiles depend on reconnect stability evidence.",
+          href: appendRealCallRecoveryActionQuery(options.reconnectProofHref ?? "/api/voice/reconnect-proof", { profileId }),
+          id: "collect-reconnect-proof",
+          label: profileId ? `Run reconnect profile proof for ${profileId}` : "Run reconnect profile proof",
+          method: "POST",
+          profileId
+        });
+      }
     }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
@@ -8031,6 +8063,7 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
 var realCallProfileActionPaths = {
   "collect-browser-proof": "/collect-browser-proof",
   "collect-phone-proof": "/collect-phone-proof",
+  "collect-reconnect-proof": "/collect-reconnect-proof",
   "collect-provider-role-evidence": "/collect-provider-role-evidence",
   refresh: "/refresh"
 };
@@ -8056,11 +8089,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       ...options,
       browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
       phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      reconnectProofHref: options.reconnectProofHref ?? actionPath("collect-reconnect-proof"),
       sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-reconnect-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-reconnect-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };

package/dist/index.d.ts

@@ -9,7 +9,8 @@ export { buildVoiceAuditExport, exportVoiceAuditTrail, redactVoiceAuditEvent, re
 export { createVoiceAuditHTTPSink, createVoiceAuditS3Sink, createVoiceAuditSinkDeliveryId, createVoiceAuditSinkDeliveryRecord, createVoiceAuditSinkDeliveryWorker, createVoiceAuditSinkDeliveryWorkerLoop, createVoiceAuditSinkStore, createVoiceMemoryAuditSinkDeliveryStore, deliverVoiceAuditEventsToSinks, summarizeVoiceAuditSinkDeliveries, } from "./auditSinks";
 export { buildVoiceAuditDeliveryReport, createVoiceAuditDeliveryHTMLHandler, createVoiceAuditDeliveryJSONHandler, createVoiceAuditDeliveryRoutes, renderVoiceAuditDeliveryHTML, resolveVoiceAuditDeliveryFilter, } from "./auditDeliveryRoutes";
 export { createVoiceBargeInRoutes, renderVoiceBargeInHTML, summarizeVoiceBargeIn, } from "./bargeInRoutes";
-export { createVoiceReconnectContractRoutes, renderVoiceReconnectContractHTML, summarizeVoiceReconnectContractSnapshots, runVoiceReconnectContract, } from "./reconnectContract";
+export { buildVoiceReconnectProofReport, createVoiceReconnectContractRoutes, createVoiceReconnectProofRoutes, renderVoiceReconnectContractHTML, summarizeVoiceReconnectProofSessions, summarizeVoiceReconnectContractSnapshots, runVoiceReconnectContract, } from "./reconnectContract";
+export type { VoiceReconnectProofOptions, VoiceReconnectProofReport, VoiceReconnectProofRoutesOptions, VoiceReconnectProofStatus, } from "./reconnectContract";
 export { assertVoiceRealtimeChannelEvidence, buildVoiceRealtimeChannelRuntimeSamplesFromTrace, buildVoiceRealtimeChannelReport, createVoiceRealtimeChannelRoutes, evaluateVoiceRealtimeChannelEvidence, renderVoiceRealtimeChannelHTML, renderVoiceRealtimeChannelMarkdown, } from "./realtimeChannel";
 export type { VoiceRealtimeChannelAssertionInput, VoiceRealtimeChannelAssertionReport, VoiceRealtimeChannelBrowserCapture, VoiceRealtimeChannelIssue, VoiceRealtimeChannelReport, VoiceRealtimeChannelReportOptions, VoiceRealtimeChannelRoutesOptions, VoiceRealtimeChannelRuntimeSample, VoiceRealtimeChannelStatus, } from "./realtimeChannel";
 export { assertVoiceRealtimeProviderContractEvidence, buildVoiceRealtimeProviderContractMatrix, createVoiceRealtimeProviderContractMatrixPreset, createVoiceRealtimeProviderContractRoutes, evaluateVoiceRealtimeProviderContractEvidence, renderVoiceRealtimeProviderContractHTML, } from "./realtimeProviderContracts";

package/dist/index.js

@@ -11626,6 +11626,22 @@ var summarizeVoiceReconnectContractSnapshots = (events, options = {}) => events.
     turnIds: Array.isArray(payload.turnIds) ? payload.turnIds.filter((turnId) => typeof turnId === "string") : undefined
   };
 }).sort((left, right) => left.at - right.at);
+var summarizeVoiceReconnectProofSessions = (sessions, options = {}) => sessions.map((session) => {
+  const attempts = session.reconnect.attempts;
+  const at = session.lastActivityAt ?? session.reconnect.lastDisconnectAt ?? session.createdAt;
+  const status = session.status === "reconnecting" ? "reconnecting" : attempts > 0 && session.status === "completed" ? "resumed" : attempts > 0 && session.status === "failed" ? "exhausted" : "idle";
+  return {
+    at,
+    reconnect: {
+      attempts,
+      lastDisconnectAt: session.reconnect.lastDisconnectAt,
+      lastResumedAt: status === "resumed" && session.lastActivityAt ? session.lastActivityAt : undefined,
+      maxAttempts: options.maxAttempts ?? attempts,
+      status
+    },
+    turnIds: session.committedTurnIds.length > 0 ? session.committedTurnIds : session.turns.map((turn) => turn.id)
+  };
+}).sort((left, right) => left.at - right.at);
 var findDuplicateTurnIds = (snapshots) => {
   const duplicates = new Set;
   for (const snapshot of snapshots) {
@@ -11665,7 +11681,7 @@ var runVoiceReconnectContract = (options) => {
   const requireReconnect = options.requireReconnect ?? true;
   const requireResume = options.requireResume ?? true;
   const requireReplayProtection = options.requireReplayProtection ?? true;
-  if (snapshots.length === 0) {
+  if (snapshots.length === 0 && !options.allowNoSnapshots) {
     issues.push({
       code: "reconnect.no_snapshots",
       message: "No reconnect snapshots were provided.",
@@ -11728,6 +11744,83 @@ var runVoiceReconnectContract = (options) => {
     }
   };
 };
+var buildVoiceReconnectProofReport = (options = {}) => {
+  const sessionSnapshots = options.sessions ? summarizeVoiceReconnectProofSessions(options.sessions, {
+    maxAttempts: options.maxAttempts
+  }) : [];
+  const snapshots = [...sessionSnapshots, ...options.snapshots ?? []].sort((left, right) => left.at - right.at);
+  const requireObservedReconnect = options.requireObservedReconnect ?? false;
+  const contract = runVoiceReconnectContract({
+    allowNoSnapshots: true,
+    requireReconnect: requireObservedReconnect,
+    requireReplayProtection: options.requireReplayProtection ?? true,
+    requireResume: options.requireResumeAfterReconnect ?? requireObservedReconnect,
+    snapshots
+  });
+  const errorCount = contract.issues.filter((issue) => issue.severity === "error").length;
+  const warningCount = contract.issues.filter((issue) => issue.severity === "warning").length;
+  const status = errorCount > 0 ? "fail" : warningCount > 0 ? "warn" : "pass";
+  const sessionCount = options.completedSessionCount ?? options.sessions?.length ?? 0;
+  const summary = snapshots.length === 0 ? `Checked ${sessionCount} completed session(s). Reconnect proof is enabled; no reconnect cycle was observed.` : contract.summary.resumed ? `Checked ${sessionCount} completed session(s) and ${snapshots.length} reconnect snapshot(s). Resume was observed without replay duplicates.` : contract.summary.reconnected ? `Checked ${sessionCount} completed session(s) and ${snapshots.length} reconnect snapshot(s). Reconnect was observed.` : `Checked ${sessionCount} completed session(s) and ${snapshots.length} reconnect snapshot(s). No reconnect was required.`;
+  return {
+    checkedAt: contract.checkedAt,
+    contract,
+    generatedAt: new Date(contract.checkedAt).toISOString(),
+    ok: status !== "fail",
+    reconnectAware: true,
+    sessionCount,
+    snapshotCount: snapshots.length,
+    status,
+    summary
+  };
+};
+var getSessionsFromStore = async (store) => {
+  const summaries = await store.list();
+  const sessions = await Promise.all(summaries.map((summary) => store.get(summary.id)));
+  return sessions.filter((session) => session !== undefined);
+};
+var createVoiceReconnectProofRoutes = (options = {}) => {
+  const path = options.path ?? "/api/voice/reconnect-proof";
+  const collectedSnapshots = [];
+  const maxCollectedSnapshots = options.maxCollectedSnapshots ?? 500;
+  const buildReport = async () => buildVoiceReconnectProofReport({
+    completedSessionCount: options.getCompletedSessionCount ? await options.getCompletedSessionCount() : undefined,
+    maxAttempts: options.maxAttempts,
+    requireObservedReconnect: options.requireObservedReconnect,
+    requireReplayProtection: options.requireReplayProtection,
+    requireResumeAfterReconnect: options.requireResumeAfterReconnect,
+    sessions: options.getSessions ? await options.getSessions() : options.store ? await getSessionsFromStore(options.store) : undefined,
+    snapshots: [
+      ...collectedSnapshots,
+      ...options.getSnapshots ? await options.getSnapshots() : []
+    ]
+  });
+  const respond = async () => new Response(JSON.stringify(await buildReport()), {
+    headers: {
+      "content-type": "application/json; charset=utf-8",
+      ...options.headers
+    }
+  });
+  const collectSnapshot = (body) => {
+    if (!isReconnectPayload(body)) {
+      return;
+    }
+    collectedSnapshots.push({
+      at: body.at,
+      reconnect: body.reconnect,
+      turnIds: Array.isArray(body.turnIds) ? body.turnIds.filter((turnId) => typeof turnId === "string") : undefined
+    });
+    if (collectedSnapshots.length > maxCollectedSnapshots) {
+      collectedSnapshots.splice(0, collectedSnapshots.length - maxCollectedSnapshots);
+    }
+  };
+  return new Elysia9({
+    name: options.name ?? "absolutejs-voice-reconnect-proof"
+  }).get(path, respond).post(path, async ({ body }) => {
+    collectSnapshot(body);
+    return respond();
+  });
+};
 var renderVoiceReconnectContractHTML = (report) => {
   const issues = report.issues.map((issue) => `<li class="${escapeHtml12(issue.severity)}"><strong>${escapeHtml12(issue.code)}</strong>: ${escapeHtml12(issue.message)}</li>`).join("");
   return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>Voice Reconnect Contract</title><style>body{background:#0d1117;color:#f8fafc;font-family:ui-sans-serif,system-ui,sans-serif;margin:0}main{margin:auto;max-width:980px;padding:32px}.hero,.card{background:#151b23;border:1px solid #30363d;border-radius:18px;margin-bottom:16px;padding:20px}.eyebrow{color:#7dd3fc;font-size:.78rem;font-weight:900;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.25rem,7vw,4.5rem);letter-spacing:-.06em;line-height:.92;margin:.2rem 0 1rem}.summary{display:flex;flex-wrap:wrap;gap:10px}.pill{background:#0d1117;border:1px solid #30363d;border-radius:999px;padding:7px 10px}.pass{color:#86efac}.fail,.error{color:#fca5a5}.warning{color:#fde68a}li{margin:8px 0}</style></head><body><main><section class="hero"><p class="eyebrow">Reconnect Resume Proof</p><h1>Voice reconnect contract</h1><div class="summary"><span class="pill ${report.pass ? "pass" : "fail"}">${report.pass ? "pass" : "fail"}</span><span class="pill">${String(report.snapshotCount)} snapshots</span><span class="pill">${String(report.summary.attempts)} attempts</span><span class="pill">statuses ${escapeHtml12(report.statuses.join(", ") || "none")}</span></div></section><section class="card"><h2>Summary</h2><p>reconnected ${String(report.summary.reconnected)} \xB7 resumed ${String(report.summary.resumed)} \xB7 exhausted ${String(report.summary.exhausted)} \xB7 duplicate turns ${String(report.summary.duplicateTurnIds.length)}</p></section><section class="card"><h2>Issues</h2>${issues ? `<ul>${issues}</ul>` : '<p class="pass">No contract issues.</p>'}</section></main></body></html>`;
@@ -16604,6 +16697,9 @@ var readRealCallProfileTraceSurfaces = (events) => {
     if (event.type === "client.barge_in") {
       surfaces.add("barge-in");
     }
+    if (event.type === "client.reconnect") {
+      surfaces.add("reconnect");
+    }
   }
   return [...surfaces].sort();
 };
@@ -17045,7 +17141,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
       warnings.push(`Required real-call profile ${profileId} has ${String(summaryProfile?.sessionCount ?? 0)} session(s), expected at least ${String(options.minProfileSessions)}.`);
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     for (const surface of requiredSurfaces) {
       if (!observedSurfaces.has(surface)) {
@@ -17084,6 +17180,16 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var resolveRequiredRealCallProfileSurfaces = (requiredProfileSurfaces, profileId) => {
+  if (requiredProfileSurfaces === undefined) {
+    return [];
+  }
+  if (Array.isArray(requiredProfileSurfaces)) {
+    return requiredProfileSurfaces;
+  }
+  const requiredSurfacesByProfile = requiredProfileSurfaces;
+  return requiredSurfacesByProfile[profileId] ?? [];
+};
 var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms));
 var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
   action.label ?? action.id ?? "recovery action",
@@ -17356,10 +17462,16 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
       return true;
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
   });
+  const resolveRequiredProfileSurfaces = (profileId) => {
+    if (typeof profileId !== "string") {
+      return [];
+    }
+    return resolveRequiredRealCallProfileSurfaces(options.requiredProfileSurfaces, profileId);
+  };
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
   const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
   if (needsProfileProof) {
@@ -17382,6 +17494,19 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
         method: "POST",
         profileId
       });
+      const requiredSurfaces = resolveRequiredProfileSurfaces(profileId);
+      const summaryProfile = typeof profileId === "string" ? summariesByProfile.get(profileId) : undefined;
+      const observedSurfaces = new Set((summaryProfile?.surfaces ?? []).filter((value) => typeof value === "string"));
+      if (requiredSurfaces.includes("reconnect") && !observedSurfaces.has("reconnect")) {
+        actions.push({
+          description: profileId ? `Run reconnect profile proof for ${profileId} when reconnect stability is required for this profile.` : "Run reconnect profile proof when required profiles depend on reconnect stability evidence.",
+          href: appendRealCallRecoveryActionQuery(options.reconnectProofHref ?? "/api/voice/reconnect-proof", { profileId }),
+          id: "collect-reconnect-proof",
+          label: profileId ? `Run reconnect profile proof for ${profileId}` : "Run reconnect profile proof",
+          method: "POST",
+          profileId
+        });
+      }
     }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
@@ -18207,6 +18332,7 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
 var realCallProfileActionPaths = {
   "collect-browser-proof": "/collect-browser-proof",
   "collect-phone-proof": "/collect-phone-proof",
+  "collect-reconnect-proof": "/collect-reconnect-proof",
   "collect-provider-role-evidence": "/collect-provider-role-evidence",
   refresh: "/refresh"
 };
@@ -18232,11 +18358,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       ...options,
       browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
       phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      reconnectProofHref: options.reconnectProofHref ?? actionPath("collect-reconnect-proof"),
       sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-reconnect-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-reconnect-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };
@@ -41883,6 +42010,7 @@ export {
   summarizeVoiceSessionReplay,
   summarizeVoiceRoutingSessions,
   summarizeVoiceRoutingDecision,
+  summarizeVoiceReconnectProofSessions,
   summarizeVoiceReconnectContractSnapshots,
   summarizeVoiceProviderHealth,
   summarizeVoiceProviderFallbackRecovery,
@@ -42239,6 +42367,7 @@ export {
   createVoiceRedisTaskLeaseCoordinator,
   createVoiceRedisPlivoWebhookNonceStore,
   createVoiceRedisIdempotencyStore,
+  createVoiceReconnectProofRoutes,
   createVoiceReconnectContractRoutes,
   createVoiceRealtimeProviderContractRoutes,
   createVoiceRealtimeProviderContractMatrixPreset,
@@ -42477,6 +42606,7 @@ export {
   buildVoiceSloCalibrationReport,
   buildVoiceSessionSnapshotStatus,
   buildVoiceSessionSnapshot,
+  buildVoiceReconnectProofReport,
   buildVoiceRealtimeProviderContractMatrix,
   buildVoiceRealtimeChannelRuntimeSamplesFromTrace,
   buildVoiceRealtimeChannelReport,

package/dist/proofTrends.d.ts

@@ -375,7 +375,7 @@ export type VoiceRealCallProfileHistoryRoutesOptions = Omit<VoiceRealCallProfile
     source?: (() => Promise<VoiceRealCallProfileHistoryOptions> | VoiceRealCallProfileHistoryOptions) | VoiceRealCallProfileHistoryOptions;
     title?: string;
 };
-export type VoiceRealCallProfileRecoveryActionId = "collect-browser-proof" | "collect-phone-proof" | "collect-provider-role-evidence" | "refresh";
+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;
@@ -383,6 +383,7 @@ export type VoiceRealCallProfileRecoveryAction = VoiceProductionReadinessAction
 export type VoiceRealCallProfileReadinessCheckOptions = {
     browserProofHref?: string;
     failOnWarnings?: boolean;
+    reconnectProofHref?: string;
     href?: string;
     label?: string;
     maxAgeMs?: number;

package/dist/react/index.js

@@ -3608,6 +3608,9 @@ var readRealCallProfileTraceSurfaces = (events) => {
     if (event.type === "client.barge_in") {
       surfaces.add("barge-in");
     }
+    if (event.type === "client.reconnect") {
+      surfaces.add("reconnect");
+    }
   }
   return [...surfaces].sort();
 };
@@ -4049,7 +4052,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
       warnings.push(`Required real-call profile ${profileId} has ${String(summaryProfile?.sessionCount ?? 0)} session(s), expected at least ${String(options.minProfileSessions)}.`);
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     for (const surface of requiredSurfaces) {
       if (!observedSurfaces.has(surface)) {
@@ -4088,6 +4091,16 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var resolveRequiredRealCallProfileSurfaces = (requiredProfileSurfaces, profileId) => {
+  if (requiredProfileSurfaces === undefined) {
+    return [];
+  }
+  if (Array.isArray(requiredProfileSurfaces)) {
+    return requiredProfileSurfaces;
+  }
+  const requiredSurfacesByProfile = requiredProfileSurfaces;
+  return requiredSurfacesByProfile[profileId] ?? [];
+};
 var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
   action.label ?? action.id ?? "recovery action",
@@ -4360,10 +4373,16 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
       return true;
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
   });
+  const resolveRequiredProfileSurfaces = (profileId) => {
+    if (typeof profileId !== "string") {
+      return [];
+    }
+    return resolveRequiredRealCallProfileSurfaces(options.requiredProfileSurfaces, profileId);
+  };
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
   const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
   if (needsProfileProof) {
@@ -4386,6 +4405,19 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
         method: "POST",
         profileId
       });
+      const requiredSurfaces = resolveRequiredProfileSurfaces(profileId);
+      const summaryProfile = typeof profileId === "string" ? summariesByProfile.get(profileId) : undefined;
+      const observedSurfaces = new Set((summaryProfile?.surfaces ?? []).filter((value) => typeof value === "string"));
+      if (requiredSurfaces.includes("reconnect") && !observedSurfaces.has("reconnect")) {
+        actions.push({
+          description: profileId ? `Run reconnect profile proof for ${profileId} when reconnect stability is required for this profile.` : "Run reconnect profile proof when required profiles depend on reconnect stability evidence.",
+          href: appendRealCallRecoveryActionQuery(options.reconnectProofHref ?? "/api/voice/reconnect-proof", { profileId }),
+          id: "collect-reconnect-proof",
+          label: profileId ? `Run reconnect profile proof for ${profileId}` : "Run reconnect profile proof",
+          method: "POST",
+          profileId
+        });
+      }
     }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
@@ -5211,6 +5243,7 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
 var realCallProfileActionPaths = {
   "collect-browser-proof": "/collect-browser-proof",
   "collect-phone-proof": "/collect-phone-proof",
+  "collect-reconnect-proof": "/collect-reconnect-proof",
   "collect-provider-role-evidence": "/collect-provider-role-evidence",
   refresh: "/refresh"
 };
@@ -5236,11 +5269,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       ...options,
       browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
       phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      reconnectProofHref: options.reconnectProofHref ?? actionPath("collect-reconnect-proof"),
       sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-reconnect-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-reconnect-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };

package/dist/reconnectContract.d.ts

@@ -1,5 +1,5 @@
 import { Elysia } from "elysia";
-import type { VoiceReconnectClientState } from "./types";
+import type { VoiceReconnectClientState, VoiceSessionRecord, VoiceSessionStore } from "./types";
 import type { StoredVoiceTraceEvent } from "./trace";
 export type VoiceReconnectContractSnapshot = {
     at: number;
@@ -28,11 +28,43 @@ export type VoiceReconnectContractReport = {
     };
 };
 export type VoiceReconnectContractOptions = {
+    allowNoSnapshots?: boolean;
     requireReconnect?: boolean;
     requireResume?: boolean;
     requireReplayProtection?: boolean;
     snapshots: readonly VoiceReconnectContractSnapshot[];
 };
+export type VoiceReconnectProofStatus = "fail" | "pass" | "warn";
+export type VoiceReconnectProofReport = {
+    checkedAt: number;
+    contract: VoiceReconnectContractReport;
+    generatedAt: string;
+    ok: boolean;
+    reconnectAware: true;
+    sessionCount: number;
+    snapshotCount: number;
+    status: VoiceReconnectProofStatus;
+    summary: string;
+};
+export type VoiceReconnectProofOptions = {
+    completedSessionCount?: number;
+    maxAttempts?: number;
+    requireObservedReconnect?: boolean;
+    requireReplayProtection?: boolean;
+    requireResumeAfterReconnect?: boolean;
+    sessions?: readonly VoiceSessionRecord[];
+    snapshots?: readonly VoiceReconnectContractSnapshot[];
+};
+export type VoiceReconnectProofRoutesOptions = Omit<VoiceReconnectProofOptions, "completedSessionCount" | "sessions" | "snapshots"> & {
+    getCompletedSessionCount?: () => number | Promise<number>;
+    getSessions?: () => readonly VoiceSessionRecord[] | Promise<readonly VoiceSessionRecord[]>;
+    getSnapshots?: () => readonly VoiceReconnectContractSnapshot[] | Promise<readonly VoiceReconnectContractSnapshot[]>;
+    headers?: HeadersInit;
+    maxCollectedSnapshots?: number;
+    name?: string;
+    path?: string;
+    store?: VoiceSessionStore;
+};
 export type VoiceReconnectContractRoutesOptions = Omit<VoiceReconnectContractOptions, "snapshots"> & {
     getSnapshots: () => readonly VoiceReconnectContractSnapshot[] | Promise<readonly VoiceReconnectContractSnapshot[]>;
     headers?: HeadersInit;
@@ -44,7 +76,63 @@ export type VoiceReconnectContractRoutesOptions = Omit<VoiceReconnectContractOpt
 export declare const summarizeVoiceReconnectContractSnapshots: (events: readonly StoredVoiceTraceEvent[], options?: {
     sessionId?: string;
 }) => VoiceReconnectContractSnapshot[];
+export declare const summarizeVoiceReconnectProofSessions: (sessions: readonly VoiceSessionRecord[], options?: {
+    maxAttempts?: number;
+}) => VoiceReconnectContractSnapshot[];
 export declare const runVoiceReconnectContract: (options: VoiceReconnectContractOptions) => VoiceReconnectContractReport;
+export declare const buildVoiceReconnectProofReport: (options?: VoiceReconnectProofOptions) => VoiceReconnectProofReport;
+export declare const createVoiceReconnectProofRoutes: (options?: VoiceReconnectProofRoutesOptions) => 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: Response;
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: Response;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
 export declare const renderVoiceReconnectContractHTML: (report: VoiceReconnectContractReport) => string;
 export declare const createVoiceReconnectContractRoutes: (options: VoiceReconnectContractRoutesOptions) => Elysia<"", {
     decorator: {};

package/dist/vue/index.js

@@ -3529,6 +3529,9 @@ var readRealCallProfileTraceSurfaces = (events) => {
     if (event.type === "client.barge_in") {
       surfaces.add("barge-in");
     }
+    if (event.type === "client.reconnect") {
+      surfaces.add("reconnect");
+    }
   }
   return [...surfaces].sort();
 };
@@ -3970,7 +3973,7 @@ var buildRealCallProfileReadinessIssues = (report, options) => {
       warnings.push(`Required real-call profile ${profileId} has ${String(summaryProfile?.sessionCount ?? 0)} session(s), expected at least ${String(options.minProfileSessions)}.`);
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     for (const surface of requiredSurfaces) {
       if (!observedSurfaces.has(surface)) {
@@ -4009,6 +4012,16 @@ var appendRealCallRecoveryActionQuery = (href, query) => {
   const search = new URLSearchParams(entries).toString();
   return `${base}${separator}${search}${hash ? `#${hash}` : ""}`;
 };
+var resolveRequiredRealCallProfileSurfaces = (requiredProfileSurfaces, profileId) => {
+  if (requiredProfileSurfaces === undefined) {
+    return [];
+  }
+  if (Array.isArray(requiredProfileSurfaces)) {
+    return requiredProfileSurfaces;
+  }
+  const requiredSurfacesByProfile = requiredProfileSurfaces;
+  return requiredSurfacesByProfile[profileId] ?? [];
+};
 var sleepVoiceRealCallProfileRecoveryLoop = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var describeVoiceRealCallProfileRecoveryLoopAction = (action) => [
   action.label ?? action.id ?? "recovery action",
@@ -4281,10 +4294,16 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
       return true;
     }
     const requiredProfileSurfaces = options.requiredProfileSurfaces;
-    const requiredSurfaces = requiredProfileSurfaces === undefined ? [] : Array.isArray(requiredProfileSurfaces) ? requiredProfileSurfaces : requiredProfileSurfaces[profileId] ?? [];
+    const requiredSurfaces = resolveRequiredRealCallProfileSurfaces(requiredProfileSurfaces, profileId);
     const observedSurfaces = new Set(summaryProfile?.surfaces ?? []);
     return requiredSurfaces.some((surface) => !observedSurfaces.has(surface));
   });
+  const resolveRequiredProfileSurfaces = (profileId) => {
+    if (typeof profileId !== "string") {
+      return [];
+    }
+    return resolveRequiredRealCallProfileSurfaces(options.requiredProfileSurfaces, profileId);
+  };
   const ageMs = report.trend.ageMs ?? (report.generatedAt ? Date.now() - new Date(report.generatedAt).getTime() : undefined);
   const needsProfileProof = missingProfiles.length > 0 || warningProfiles.length > 0 || missingRoleProfiles.length > 0 || missingDepthProfiles.length > 0 || options.minCycles !== undefined && (report.summary.cycles ?? 0) < options.minCycles || options.minActionableProfiles !== undefined && report.defaults.summary.actionableProfiles < options.minActionableProfiles;
   if (needsProfileProof) {
@@ -4307,6 +4326,19 @@ var buildVoiceRealCallProfileRecoveryActions = (report, options = {}) => {
         method: "POST",
         profileId
       });
+      const requiredSurfaces = resolveRequiredProfileSurfaces(profileId);
+      const summaryProfile = typeof profileId === "string" ? summariesByProfile.get(profileId) : undefined;
+      const observedSurfaces = new Set((summaryProfile?.surfaces ?? []).filter((value) => typeof value === "string"));
+      if (requiredSurfaces.includes("reconnect") && !observedSurfaces.has("reconnect")) {
+        actions.push({
+          description: profileId ? `Run reconnect profile proof for ${profileId} when reconnect stability is required for this profile.` : "Run reconnect profile proof when required profiles depend on reconnect stability evidence.",
+          href: appendRealCallRecoveryActionQuery(options.reconnectProofHref ?? "/api/voice/reconnect-proof", { profileId }),
+          id: "collect-reconnect-proof",
+          label: profileId ? `Run reconnect profile proof for ${profileId}` : "Run reconnect profile proof",
+          method: "POST",
+          profileId
+        });
+      }
     }
   }
   if (options.maxAgeMs !== undefined && (ageMs === undefined || ageMs > options.maxAgeMs)) {
@@ -5132,6 +5164,7 @@ var createVoiceRealCallProfileHistoryRoutes = (options = {}) => {
 var realCallProfileActionPaths = {
   "collect-browser-proof": "/collect-browser-proof",
   "collect-phone-proof": "/collect-phone-proof",
+  "collect-reconnect-proof": "/collect-reconnect-proof",
   "collect-provider-role-evidence": "/collect-provider-role-evidence",
   refresh: "/refresh"
 };
@@ -5157,11 +5190,12 @@ var createVoiceRealCallProfileRecoveryActionRoutes = (options = {}) => {
       ...options,
       browserProofHref: options.browserProofHref ?? actionPath("collect-browser-proof"),
       phoneProofHref: options.phoneProofHref ?? actionPath("collect-phone-proof"),
+      reconnectProofHref: options.reconnectProofHref ?? actionPath("collect-reconnect-proof"),
       sourceHref: options.sourceHref ?? actionPath("collect-provider-role-evidence"),
       productionReadinessHref: options.productionReadinessHref ?? actionPath("refresh")
     }).map((action) => ({
       ...action,
-      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
+      href: action.id === "collect-browser-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-browser-proof"), { profileId: action.profileId }) : action.id === "collect-phone-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-phone-proof"), { profileId: action.profileId }) : action.id === "collect-reconnect-proof" ? appendRealCallRecoveryActionQuery(actionPath("collect-reconnect-proof"), { profileId: action.profileId }) : action.id === "collect-provider-role-evidence" ? actionPath("collect-provider-role-evidence") : action.href,
       method: action.id === "refresh" && (action.label === "Open real-call profile history" || action.label === "Open operations records") ? "GET" : "POST"
     }));
     return { actions, generatedAt: new Date().toISOString(), report };

package/package.json

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