@absolutejs/voice 0.0.22-beta.400 → 0.0.22-beta.402

package/dist/callDebugger.d.ts

@@ -0,0 +1,58 @@
+import { Elysia } from 'elysia';
+import { type VoiceFailureReplayReport, type VoiceOperationsRecord, type VoiceOperationsRecordOptions } from './operationsRecord';
+import { type VoiceSessionSnapshot, type VoiceSessionSnapshotRouteSource } from './sessionSnapshot';
+export type VoiceCallDebuggerReport = {
+    checkedAt: number;
+    failureReplay: VoiceFailureReplayReport;
+    incidentMarkdown: string;
+    operationsRecord: VoiceOperationsRecord;
+    sessionId: string;
+    snapshot: VoiceSessionSnapshot;
+    status: 'failed' | 'healthy' | 'warning';
+};
+export type VoiceCallDebuggerRoutesOptions = Omit<VoiceOperationsRecordOptions, 'sessionId'> & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    incidentPath?: false | string;
+    name?: string;
+    operationsRecordHref?: string | ((input: {
+        sessionId: string;
+    }) => string | undefined);
+    path?: string;
+    render?: (report: VoiceCallDebuggerReport) => string | Promise<string>;
+    snapshot?: VoiceSessionSnapshotRouteSource;
+    title?: string;
+};
+export declare const buildVoiceCallDebuggerReport: (options: VoiceCallDebuggerRoutesOptions, input: {
+    request: Request;
+    sessionId: string;
+}) => Promise<VoiceCallDebuggerReport>;
+export declare const renderVoiceCallDebuggerHTML: (report: VoiceCallDebuggerReport, options?: Pick<VoiceCallDebuggerRoutesOptions, "title">) => string;
+export declare const createVoiceCallDebuggerRoutes: (options: VoiceCallDebuggerRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/client/index.js

@@ -3071,6 +3071,7 @@ var DEFAULT_TITLE = "Session Snapshot";
 var DEFAULT_DESCRIPTION = "Portable call artifact with media graph, provider routing, proof, quality, and telephony evidence.";
 var DEFAULT_DOWNLOAD_LABEL = "Download snapshot";
 var escapeHtml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatStatus = (status) => status ?? "n/a";
 var createVoiceSessionSnapshotViewModel = (state, options = {}) => {
   const snapshot = state.snapshot;
   const failedProofs = snapshot?.proofSummary.failed ?? 0;
@@ -3078,7 +3079,13 @@ var createVoiceSessionSnapshotViewModel = (state, options = {}) => {
   const timingWarnings = snapshot?.media.reduce((total, media) => total + media.report.timing.overBudgetFrames, 0) ?? 0;
   const backpressureDrops = snapshot?.media.reduce((total, media) => total + media.report.backpressure.droppedFrames, 0) ?? 0;
   const qualityWarnings = snapshot?.quality.filter((quality) => quality.status !== "pass").length ?? 0;
+  const artifactWarnings = snapshot?.artifacts.filter((artifact) => artifact.status !== undefined && artifact.status !== "pass").length ?? 0;
   return {
+    artifacts: snapshot?.artifacts.map((artifact) => ({
+      href: artifact.href,
+      label: artifact.label,
+      status: formatStatus(artifact.status)
+    })) ?? [],
     description: options.description ?? DEFAULT_DESCRIPTION,
     error: state.error,
     isLoading: state.isLoading,
@@ -3090,6 +3097,8 @@ var createVoiceSessionSnapshotViewModel = (state, options = {}) => {
       { label: "Backpressure drops", value: String(backpressureDrops) },
       { label: "Proof failures", value: String(failedProofs) },
       { label: "Quality warnings", value: String(qualityWarnings) },
+      { label: "Debug artifacts", value: String(snapshot.artifacts.length) },
+      { label: "Artifact warnings", value: String(artifactWarnings) },
       {
         label: "Provider routing",
         value: String(snapshot.providerRoutingEvents.length)
@@ -3111,6 +3120,10 @@ var renderVoiceSessionSnapshotHTML = (state, options = {}) => {
     <dt>${escapeHtml(row.label)}</dt>
     <dd>${escapeHtml(row.value)}</dd>
   </div>`).join("")}</dl>` : '<p class="absolute-voice-session-snapshot__empty">Load a session snapshot to see support diagnostics.</p>';
+  const artifacts = model.artifacts.length ? `<div class="absolute-voice-session-snapshot__artifacts">${model.artifacts.map((artifact) => {
+    const body = `<strong>${escapeHtml(artifact.label)}</strong><span>${escapeHtml(artifact.status)}</span>`;
+    return artifact.href ? `<a href="${escapeHtml(artifact.href)}">${body}</a>` : `<div>${body}</div>`;
+  }).join("")}</div>` : "";
   return `<section class="absolute-voice-session-snapshot absolute-voice-session-snapshot--${escapeHtml(model.status)}">
   <header class="absolute-voice-session-snapshot__header">
     <span class="absolute-voice-session-snapshot__eyebrow">${escapeHtml(model.title)}</span>
@@ -3119,6 +3132,7 @@ var renderVoiceSessionSnapshotHTML = (state, options = {}) => {
   <p class="absolute-voice-session-snapshot__description">${escapeHtml(model.description)}</p>
   ${model.showDownload ? `<button class="absolute-voice-session-snapshot__download" data-absolute-voice-session-snapshot-download type="button">${escapeHtml(options.downloadLabel ?? DEFAULT_DOWNLOAD_LABEL)}</button>` : ""}
   ${rows}
+  ${artifacts}
   ${model.error ? `<p class="absolute-voice-session-snapshot__error">${escapeHtml(model.error)}</p>` : ""}
 </section>`;
 };
@@ -4020,7 +4034,7 @@ var DEFAULT_LINKS = [
   { href: "/api/voice/vapi-coverage", label: "Coverage JSON" }
 ];
 var escapeHtml3 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var formatStatus = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var formatStatus2 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
 var surfaceDetail2 = (surface) => {
   if (surface.status === "pass") {
     return surface.replacement;
@@ -4059,7 +4073,7 @@ var renderVoicePlatformCoverageHTML = (snapshot, options = {}) => {
   const surfaces = model.surfaces.length ? `<div class="absolute-voice-platform-coverage__surfaces">${model.surfaces.map((surface) => `<article class="absolute-voice-platform-coverage__surface absolute-voice-platform-coverage__surface--${escapeHtml3(surface.status)}">
   <header>
     <strong>${escapeHtml3(surface.label)}</strong>
-    <span>${escapeHtml3(formatStatus(surface.status))}</span>
+    <span>${escapeHtml3(formatStatus2(surface.status))}</span>
   </header>
   <p>${escapeHtml3(surface.detail)}</p>
   <small>${surface.evidence.filter((item) => item.ok).length}/${surface.evidence.length} evidence checks passing</small>
@@ -10303,7 +10317,7 @@ var DEFAULT_TITLE11 = "Voice Providers";
 var DEFAULT_DESCRIPTION11 = "Live provider health, fallback counts, latency, and suppression state from your self-hosted trace store.";
 var escapeHtml19 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatProvider = (provider) => provider.split(/[-_\s]+/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || provider;
-var formatStatus2 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var formatStatus3 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
 var formatLatency = (value) => typeof value === "number" ? `${value}ms` : "No samples";
 var formatSuppression = (value) => typeof value === "number" ? `${Math.ceil(value / 1000)}s` : "None";
 var getProviderDetail = (provider) => {
@@ -10360,7 +10374,7 @@ var renderVoiceProviderStatusHTML = (snapshot, options = {}) => {
   const providers = model.providers.length ? `<div class="absolute-voice-provider-status__providers">${model.providers.map((provider) => `<article class="absolute-voice-provider-status__provider absolute-voice-provider-status__provider--${escapeHtml19(provider.status)}">
   <header>
     <strong>${escapeHtml19(provider.label)}</strong>
-    <span>${escapeHtml19(formatStatus2(provider.status))}</span>
+    <span>${escapeHtml19(formatStatus3(provider.status))}</span>
   </header>
   <p>${escapeHtml19(provider.detail)}</p>
   <dl>${provider.rows.map((row) => `<div>
@@ -10421,7 +10435,7 @@ var DEFAULT_DESCRIPTION12 = "Configured, selected, and healthy voice providers f
 var escapeHtml20 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatProvider2 = (provider) => provider.split(/[-_\s]+/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || provider;
 var formatKind2 = (kind) => kind.toUpperCase();
-var formatStatus3 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var formatStatus4 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
 var getCapabilityDetail = (capability) => {
   if (!capability.configured) {
     return "Not configured in this deployment.";
@@ -10447,7 +10461,7 @@ var createVoiceProviderCapabilitiesViewModel = (snapshot, options = {}) => {
     detail: getCapabilityDetail(capability),
     label: `${formatProvider2(capability.provider)} ${formatKind2(capability.kind)}`,
     rows: [
-      { label: "Status", value: formatStatus3(capability.status) },
+      { label: "Status", value: formatStatus4(capability.status) },
       { label: "Selected", value: capability.selected ? "Yes" : "No" },
       { label: "Model", value: capability.model ?? "Default" },
       {
@@ -10476,7 +10490,7 @@ var renderVoiceProviderCapabilitiesHTML = (snapshot, options = {}) => {
   const capabilities = model.capabilities.length ? `<div class="absolute-voice-provider-capabilities__providers">${model.capabilities.map((capability) => `<article class="absolute-voice-provider-capabilities__provider absolute-voice-provider-capabilities__provider--${escapeHtml20(capability.status)}">
   <header>
     <strong>${escapeHtml20(capability.label)}</strong>
-    <span>${escapeHtml20(formatStatus3(capability.status))}</span>
+    <span>${escapeHtml20(formatStatus4(capability.status))}</span>
   </header>
   <p>${escapeHtml20(capability.detail)}</p>
   <dl>${capability.rows.map((row) => `<div>
@@ -10536,7 +10550,7 @@ var DEFAULT_TITLE13 = "Provider Contracts";
 var DEFAULT_DESCRIPTION13 = "Production contract coverage for provider env, latency, fallback, streaming, and capabilities.";
 var escapeHtml21 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
 var formatProvider3 = (provider) => provider.split(/[-_\s]+/).filter(Boolean).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ") || provider;
-var formatStatus4 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+var formatStatus5 = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
 var contractDetail = (row) => {
   const failing = row.checks.filter((check) => check.status !== "pass");
   if (failing.length === 0) {
@@ -10555,12 +10569,12 @@ var createVoiceProviderContractsViewModel = (snapshot, options = {}) => {
       label: check.remediation?.label ?? check.label
     })),
     rows: [
-      { label: "Status", value: formatStatus4(row.status) },
+      { label: "Status", value: formatStatus5(row.status) },
       { label: "Selected", value: row.selected ? "Yes" : "No" },
       { label: "Configured", value: row.configured ? "Yes" : "No" },
       {
         label: "Checks",
-        value: row.checks.map((check) => `${check.label}: ${formatStatus4(check.status)}`).join(", ")
+        value: row.checks.map((check) => `${check.label}: ${formatStatus5(check.status)}`).join(", ")
       }
     ]
   }));
@@ -10581,7 +10595,7 @@ var renderVoiceProviderContractsHTML = (snapshot, options = {}) => {
   const rows = model.rows.length ? `<div class="absolute-voice-provider-contracts__rows">${model.rows.map((row) => `<article class="absolute-voice-provider-contracts__row absolute-voice-provider-contracts__row--${escapeHtml21(row.status)}">
   <header>
     <strong>${escapeHtml21(row.label)}</strong>
-    <span>${escapeHtml21(formatStatus4(row.status))}</span>
+    <span>${escapeHtml21(formatStatus5(row.status))}</span>
   </header>
   <p>${escapeHtml21(row.detail)}</p>
   ${row.remediations.length ? `<ul class="absolute-voice-provider-contracts__remediations">${row.remediations.map((remediation) => `<li>${remediation.href ? `<a href="${escapeHtml21(remediation.href)}">${escapeHtml21(remediation.label)}</a>` : `<strong>${escapeHtml21(remediation.label)}</strong>`}<span>${escapeHtml21(remediation.detail)}</span></li>`).join("")}</ul>` : ""}

package/dist/client/sessionSnapshotWidget.d.ts

@@ -1,5 +1,10 @@
 import { type VoiceSessionSnapshotClientOptions, type VoiceSessionSnapshotClientState } from './sessionSnapshot';
 export type VoiceSessionSnapshotViewModel = {
+    artifacts: Array<{
+        href?: string;
+        label: string;
+        status: string;
+    }>;
     description: string;
     error: string | null;
     isLoading: boolean;

package/dist/index.d.ts

@@ -33,8 +33,10 @@ export type { VoicePlatformCoverageAssertionInput, VoicePlatformCoverageAssertio
 export { assertVoiceProofTrendEvidence, appendVoiceRealCallProfileRecoveryEvidence, buildEmptyVoiceProofTrendReport, buildVoiceProofTrendProfileSummaries, buildVoiceProofTrendRecommendationReport, buildVoiceProofTrendReportFromRealCallProfiles, buildVoiceProofTrendReport, buildVoiceRealCallProfileEvidenceFromTraceEvents, buildVoiceRealCallProfileDefaults, buildVoiceRealCallProfileHistoryReport, buildVoiceRealCallProfileReadinessCheck, buildVoiceRealCallProfileRecoveryJobHistoryCheck, buildVoiceRealCallProfileRecoveryActions, createVoiceInMemoryRealCallProfileRecoveryJobStore, createVoiceRealCallProfileTraceCollector, createVoiceSQLiteRealCallProfileRecoveryJobStore, createVoiceProofTrendRecommendationRoutes, createVoiceProofTrendRoutes, createVoiceRealCallProfileHistoryRoutes, createVoiceRealCallProfileRecoveryActionRoutes, DEFAULT_VOICE_PROOF_TREND_PROFILE_DEFINITIONS, DEFAULT_VOICE_PROOF_TRENDS_MAX_AGE_MS, evaluateVoiceProofTrendEvidence, formatVoiceProofTrendAge, loadVoiceRealCallProfileEvidenceFromTraceStore, normalizeVoiceProofTrendReport, readVoiceProofTrendReportFile, renderVoiceProofTrendRecommendationHTML, renderVoiceProofTrendRecommendationMarkdown, renderVoiceRealCallProfileHistoryHTML, renderVoiceRealCallProfileHistoryMarkdown, runVoiceRealCallProfileRecoveryLoop, resolveVoiceRealCallProfileProviderRoute } from './proofTrends';
 export { createVoiceEvidenceAssertion, createVoiceProofAssertion, summarizeVoiceProofAssertions } from './proofAssertions';
 export { buildVoiceSessionSnapshot, buildVoiceSessionSnapshotStatus, createVoiceSessionSnapshotRoutes, parseVoiceSessionSnapshot } from './sessionSnapshot';
+export { buildVoiceCallDebuggerReport, createVoiceCallDebuggerRoutes, renderVoiceCallDebuggerHTML } from './callDebugger';
 export type { VoiceEvidenceAssertionInput, VoiceProofAssertionInput, VoiceProofAssertionResult, VoiceProofAssertionSummary } from './proofAssertions';
-export type { VoiceSessionSnapshot, VoiceSessionSnapshotInput, VoiceSessionSnapshotQualityEvidence, VoiceSessionSnapshotRoutesOptions, VoiceSessionSnapshotRouteSource, VoiceSessionSnapshotRouteSourceInput, VoiceSessionSnapshotStatus } from './sessionSnapshot';
+export type { VoiceSessionSnapshot, VoiceSessionSnapshotArtifact, VoiceSessionSnapshotArtifactKind, VoiceSessionSnapshotInput, VoiceSessionSnapshotQualityEvidence, VoiceSessionSnapshotRoutesOptions, VoiceSessionSnapshotRouteSource, VoiceSessionSnapshotRouteSourceInput, VoiceSessionSnapshotStatus } from './sessionSnapshot';
+export type { VoiceCallDebuggerReport, VoiceCallDebuggerRoutesOptions } from './callDebugger';
 export { fetchVoiceProofTarget, getVoiceProofTargetLogicalFailure, mapVoiceProofTargetsWithConcurrency, runVoiceCommandProofTarget, runVoiceCommandProofTargets, runVoiceProofTargets } from './proofRunner';
 export type { VoiceCommandProofExecutionResult, VoiceCommandProofTarget, VoiceCommandProofTargetResult, VoiceCommandProofTargetRunnerOptions, VoiceCommandProofTargetRunOptions, VoiceProofTarget, VoiceProofTargetMethod, VoiceProofTargetResult, VoiceProofTargetRunnerOptions, VoiceProofTargetRunOptions } from './proofRunner';
 export { applyVoiceProfileSwitchGuard, buildVoiceProfileSwitchReadinessReport, buildVoiceProfileSwitchLiveDecisionReport, createVoiceProfileSwitchLiveDecisionRoutes, createVoiceProfileSwitchPolicyProofRoutes, createVoiceProfileSwitchReadinessRoutes, recommendVoiceProfileSwitch, renderVoiceProfileSwitchLiveDecisionHTML, renderVoiceProfileSwitchPolicyProofHTML, renderVoiceProfileSwitchReadinessHTML, runVoiceProfileSwitchPolicyProof } from './profileSwitchRecommendation';