@absolutejs/voice 0.0.22-beta.90 → 0.0.22-beta.92

package/dist/client/index.js

@@ -1560,11 +1560,26 @@ var DEFAULT_INTERRUPT_THRESHOLD = 0.08;
 var shouldInterruptForLevel = (level, options = {}) => (options.enabled ?? true) && level >= (options.interruptThreshold ?? DEFAULT_INTERRUPT_THRESHOLD);
 var bindVoiceBargeIn = (controller, player, options = {}) => {
   let lastPartial = controller.partial;
-  const interruptIfPlaying = () => {
+  const interruptIfPlaying = (reason) => {
     if (!player.isPlaying || options.enabled === false) {
+      options.monitor?.recordSkipped({
+        reason,
+        sessionId: controller.sessionId
+      });
       return;
     }
-    player.interrupt();
+    options.monitor?.recordRequested({
+      reason,
+      sessionId: controller.sessionId
+    });
+    player.interrupt().then(() => {
+      options.monitor?.recordStopped({
+        latencyMs: player.lastInterruptLatencyMs,
+        playbackStopLatencyMs: player.lastPlaybackStopLatencyMs,
+        reason,
+        sessionId: controller.sessionId
+      });
+    });
   };
   const unsubscribe = controller.subscribe(() => {
     if (options.interruptOnPartial === false) {
@@ -1572,7 +1587,7 @@ var bindVoiceBargeIn = (controller, player, options = {}) => {
       return;
     }
     if (!lastPartial && controller.partial) {
-      interruptIfPlaying();
+      interruptIfPlaying("partial-transcript");
     }
     lastPartial = controller.partial;
   });
@@ -1582,11 +1597,11 @@ var bindVoiceBargeIn = (controller, player, options = {}) => {
     },
     handleLevel: (level) => {
       if (shouldInterruptForLevel(level, options)) {
-        interruptIfPlaying();
+        interruptIfPlaying("input-level");
       }
     },
     sendAudio: (audio) => {
-      interruptIfPlaying();
+      interruptIfPlaying("manual-audio");
       controller.sendAudio(audio);
     }
   };
@@ -1616,13 +1631,93 @@ var createVoiceDuplexController = (path, options = {}) => {
     audioPlayer,
     close,
     interruptAssistant: async () => {
+      options.bargeIn?.monitor?.recordRequested({
+        reason: "manual-interrupt",
+        sessionId: controller.sessionId
+      });
       await audioPlayer.interrupt();
+      options.bargeIn?.monitor?.recordStopped({
+        latencyMs: audioPlayer.lastInterruptLatencyMs,
+        playbackStopLatencyMs: audioPlayer.lastPlaybackStopLatencyMs,
+        reason: "manual-interrupt",
+        sessionId: controller.sessionId
+      });
     },
     sendAudio: (audio) => {
       bargeInBinding?.sendAudio(audio);
     }
   };
 };
+// src/client/bargeInMonitor.ts
+var DEFAULT_THRESHOLD_MS = 250;
+var createEventId = () => `barge-in:${Date.now()}:${crypto.randomUUID?.() ?? Math.random().toString(36).slice(2)}`;
+var summarize = (events, thresholdMs) => {
+  const stopped = events.filter((event) => event.status === "stopped");
+  const latencies = stopped.map((event) => event.latencyMs).filter((value) => typeof value === "number");
+  const failed = stopped.filter((event) => typeof event.latencyMs === "number" && event.latencyMs > thresholdMs).length;
+  const passed = stopped.length - failed;
+  return {
+    averageLatencyMs: latencies.length > 0 ? Math.round(latencies.reduce((total, value) => total + value, 0) / latencies.length) : undefined,
+    events: [...events],
+    failed,
+    lastEvent: events.at(-1),
+    passed,
+    status: events.length === 0 ? "empty" : failed > 0 ? "fail" : stopped.length === 0 ? "warn" : "pass",
+    thresholdMs,
+    total: stopped.length
+  };
+};
+var createVoiceBargeInMonitor = (options = {}) => {
+  const listeners = new Set;
+  const thresholdMs = options.thresholdMs ?? DEFAULT_THRESHOLD_MS;
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const events = [];
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const postEvent = (event) => {
+    if (!options.path || typeof fetchImpl !== "function") {
+      return;
+    }
+    fetchImpl(options.path, {
+      body: JSON.stringify(event),
+      headers: {
+        "Content-Type": "application/json"
+      },
+      method: "POST"
+    }).catch(() => {});
+  };
+  const record = (status, input) => {
+    const event = {
+      at: Date.now(),
+      id: createEventId(),
+      latencyMs: input.latencyMs,
+      playbackStopLatencyMs: input.playbackStopLatencyMs,
+      reason: input.reason,
+      sessionId: input.sessionId,
+      status,
+      thresholdMs
+    };
+    events.push(event);
+    postEvent(event);
+    emit();
+    return event;
+  };
+  return {
+    getSnapshot: () => summarize(events, thresholdMs),
+    recordRequested: (input) => record("requested", input),
+    recordSkipped: (input) => record("skipped", input),
+    recordStopped: (input) => record("stopped", input),
+    subscribe: (subscriber) => {
+      listeners.add(subscriber);
+      return () => {
+        listeners.delete(subscriber);
+      };
+    }
+  };
+};
 // src/client/appKitStatus.ts
 var fetchVoiceAppKitStatus = async (path = "/app-kit/status", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -2229,6 +2324,85 @@ var createVoiceTurnQualityStore = (path = "/api/turn-quality", options = {}) =>
     }
   };
 };
+// src/client/traceTimeline.ts
+var fetchVoiceTraceTimeline = async (path = "/api/voice-traces", options = {}) => {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(path);
+  if (!response.ok) {
+    throw new Error(`Voice trace timeline failed: HTTP ${response.status}`);
+  }
+  return await response.json();
+};
+var createVoiceTraceTimelineStore = (path = "/api/voice-traces", options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let timer;
+  let snapshot = {
+    error: null,
+    isLoading: false,
+    report: null
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const refresh = async () => {
+    if (closed) {
+      return snapshot.report;
+    }
+    snapshot = {
+      ...snapshot,
+      error: null,
+      isLoading: true
+    };
+    emit();
+    try {
+      const report = await fetchVoiceTraceTimeline(path, options);
+      snapshot = {
+        error: null,
+        isLoading: false,
+        report,
+        updatedAt: Date.now()
+      };
+      emit();
+      return report;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isLoading: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    listeners.clear();
+  };
+  if (options.intervalMs && options.intervalMs > 0) {
+    timer = setInterval(() => {
+      refresh().catch(() => {});
+    }, options.intervalMs);
+  }
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    refresh,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
 // src/client/providerSimulationControls.ts
 var postSimulation = async (pathPrefix, mode, provider, fetchImpl) => {
   const response = await fetchImpl(`${pathPrefix}/${mode}?provider=${encodeURIComponent(provider)}`, { method: "POST" });
@@ -2747,6 +2921,93 @@ var defineVoiceTurnQualityElement = (tagName = "absolute-voice-turn-quality") =>
     }
   });
 };
+// src/client/traceTimelineWidget.ts
+var DEFAULT_TITLE6 = "Voice Traces";
+var DEFAULT_DESCRIPTION6 = "Latest call timelines with provider latency, fallbacks, handoffs, and errors from your self-hosted trace store.";
+var escapeHtml7 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatMs = (value) => typeof value === "number" ? `${value}ms` : "n/a";
+var formatProviders = (session) => session.providers.length ? session.providers.map((provider) => provider.provider).join(", ") : "No providers";
+var createVoiceTraceTimelineViewModel = (snapshot, options = {}) => {
+  const sessions = (snapshot.report?.sessions ?? []).slice(0, options.limit ?? 3).map((session) => ({
+    ...session,
+    detailHref: `${options.detailBasePath ?? "/traces"}/${encodeURIComponent(session.sessionId)}`,
+    durationLabel: formatMs(session.summary.callDurationMs),
+    label: `${session.summary.eventCount} events / ${session.summary.turnCount} turns`,
+    providerLabel: formatProviders(session)
+  }));
+  const failed = sessions.filter((session) => session.status === "failed").length;
+  const warnings = sessions.filter((session) => session.status === "warning").length;
+  return {
+    description: options.description ?? DEFAULT_DESCRIPTION6,
+    error: snapshot.error,
+    isLoading: snapshot.isLoading,
+    label: snapshot.error ? "Unavailable" : failed > 0 ? `${failed} failed` : warnings > 0 ? `${warnings} warning` : sessions.length ? `${sessions.length} recent` : snapshot.isLoading ? "Checking" : "No traces yet",
+    sessions,
+    status: snapshot.error ? "error" : failed > 0 ? "failed" : warnings > 0 ? "warning" : sessions.length ? "ready" : snapshot.isLoading ? "loading" : "empty",
+    title: options.title ?? DEFAULT_TITLE6,
+    updatedAt: snapshot.updatedAt
+  };
+};
+var renderVoiceTraceTimelineWidgetHTML = (snapshot, options = {}) => {
+  const model = createVoiceTraceTimelineViewModel(snapshot, options);
+  const sessions = model.sessions.length ? `<div class="absolute-voice-trace-timeline__sessions">${model.sessions.map((session) => `<article class="absolute-voice-trace-timeline__session absolute-voice-trace-timeline__session--${escapeHtml7(session.status)}">
+  <header>
+    <strong>${escapeHtml7(session.sessionId)}</strong>
+    <span>${escapeHtml7(session.status)}</span>
+  </header>
+  <p>${escapeHtml7(session.label)} \xB7 ${escapeHtml7(session.durationLabel)} \xB7 ${escapeHtml7(session.providerLabel)}</p>
+  <a href="${escapeHtml7(session.detailHref)}">Open timeline</a>
+</article>`).join("")}</div>` : '<p class="absolute-voice-trace-timeline__empty">Run a voice session to see call timelines.</p>';
+  return `<section class="absolute-voice-trace-timeline absolute-voice-trace-timeline--${escapeHtml7(model.status)}">
+  <header class="absolute-voice-trace-timeline__header">
+    <span class="absolute-voice-trace-timeline__eyebrow">${escapeHtml7(model.title)}</span>
+    <strong class="absolute-voice-trace-timeline__label">${escapeHtml7(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-trace-timeline__description">${escapeHtml7(model.description)}</p>
+  ${sessions}
+  ${model.error ? `<p class="absolute-voice-trace-timeline__error">${escapeHtml7(model.error)}</p>` : ""}
+</section>`;
+};
+var getVoiceTraceTimelineCSS = () => `.absolute-voice-trace-timeline{border:1px solid #bad7d3;border-radius:20px;background:#f3fffb;color:#09201c;padding:18px;box-shadow:0 18px 40px rgba(9,32,28,.12);font-family:inherit}.absolute-voice-trace-timeline--error,.absolute-voice-trace-timeline--failed{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-trace-timeline--warning{border-color:#fbbf24;background:#fffaf0}.absolute-voice-trace-timeline__header,.absolute-voice-trace-timeline__session header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-trace-timeline__eyebrow{color:#17665b;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-trace-timeline__label{font-size:24px;line-height:1}.absolute-voice-trace-timeline__description,.absolute-voice-trace-timeline__session p,.absolute-voice-trace-timeline__empty{color:#35544f}.absolute-voice-trace-timeline__sessions{display:grid;gap:12px;margin-top:14px}.absolute-voice-trace-timeline__session{background:#fff;border:1px solid #cfe7e2;border-radius:16px;padding:14px}.absolute-voice-trace-timeline__session--failed{border-color:#f2a7a7}.absolute-voice-trace-timeline__session--warning{border-color:#fbbf24}.absolute-voice-trace-timeline__session p{margin:10px 0}.absolute-voice-trace-timeline__session a{color:#0f766e;font-weight:800}.absolute-voice-trace-timeline__empty{margin:14px 0 0}.absolute-voice-trace-timeline__error{color:#9f1239;font-weight:700}`;
+var mountVoiceTraceTimeline = (element, path = "/api/voice-traces", options = {}) => {
+  const store = createVoiceTraceTimelineStore(path, options);
+  const render = () => {
+    element.innerHTML = renderVoiceTraceTimelineWidgetHTML(store.getSnapshot(), options);
+  };
+  const unsubscribe = store.subscribe(render);
+  render();
+  store.refresh().catch(() => {});
+  return {
+    close: () => {
+      unsubscribe();
+      store.close();
+    },
+    refresh: store.refresh
+  };
+};
+var defineVoiceTraceTimelineElement = (tagName = "absolute-voice-trace-timeline") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceTraceTimelineElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const intervalMs = Number(this.getAttribute("interval-ms") ?? 5000);
+      const limit = Number(this.getAttribute("limit") ?? 3);
+      this.mounted = mountVoiceTraceTimeline(this, this.getAttribute("path") ?? "/api/voice-traces", {
+        description: this.getAttribute("description") ?? undefined,
+        detailBasePath: this.getAttribute("detail-base-path") ?? undefined,
+        intervalMs: Number.isFinite(intervalMs) ? intervalMs : 5000,
+        limit: Number.isFinite(limit) ? limit : 3,
+        title: this.getAttribute("title") ?? undefined
+      });
+    }
+    disconnectedCallback() {
+      this.mounted?.close();
+      this.mounted = undefined;
+    }
+  });
+};
 // src/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -2827,18 +3088,21 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 };
 export {
   renderVoiceTurnQualityHTML,
+  renderVoiceTraceTimelineWidgetHTML,
   renderVoiceRoutingStatusHTML,
   renderVoiceProviderStatusHTML,
   renderVoiceProviderSimulationControlsHTML,
   renderVoiceProviderCapabilitiesHTML,
   renderVoiceOpsStatusHTML,
   mountVoiceTurnQuality,
+  mountVoiceTraceTimeline,
   mountVoiceRoutingStatus,
   mountVoiceProviderStatus,
   mountVoiceProviderSimulationControls,
   mountVoiceProviderCapabilities,
   mountVoiceOpsStatus,
   getVoiceTurnQualityCSS,
+  getVoiceTraceTimelineCSS,
   getVoiceRoutingStatusCSS,
   getVoiceProviderStatusCSS,
   getVoiceProviderCapabilitiesCSS,
@@ -2846,11 +3110,13 @@ export {
   getVoiceOpsStatusCSS,
   fetchVoiceWorkflowStatus,
   fetchVoiceTurnQuality,
+  fetchVoiceTraceTimeline,
   fetchVoiceRoutingStatus,
   fetchVoiceProviderStatus,
   fetchVoiceProviderCapabilities,
   fetchVoiceAppKitStatus,
   defineVoiceTurnQualityElement,
+  defineVoiceTraceTimelineElement,
   defineVoiceRoutingStatusElement,
   defineVoiceProviderStatusElement,
   defineVoiceProviderSimulationControlsElement,
@@ -2860,6 +3126,8 @@ export {
   createVoiceWorkflowStatusStore,
   createVoiceTurnQualityViewModel,
   createVoiceTurnQualityStore,
+  createVoiceTraceTimelineViewModel,
+  createVoiceTraceTimelineStore,
   createVoiceStream,
   createVoiceRoutingStatusViewModel,
   createVoiceRoutingStatusStore,
@@ -2873,6 +3141,7 @@ export {
   createVoiceDuplexController,
   createVoiceController,
   createVoiceConnection,
+  createVoiceBargeInMonitor,
   createVoiceAudioPlayer,
   createVoiceAppKitStatusStore,
   createMicrophoneCapture,

package/dist/client/traceTimeline.d.ts

@@ -0,0 +1,19 @@
+import type { VoiceTraceTimelineReport } from '../traceTimeline';
+export type VoiceTraceTimelineClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+};
+export type VoiceTraceTimelineSnapshot = {
+    error: string | null;
+    isLoading: boolean;
+    report: VoiceTraceTimelineReport | null;
+    updatedAt?: number;
+};
+export declare const fetchVoiceTraceTimeline: (path?: string, options?: Pick<VoiceTraceTimelineClientOptions, "fetch">) => Promise<VoiceTraceTimelineReport>;
+export declare const createVoiceTraceTimelineStore: (path?: string, options?: VoiceTraceTimelineClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceTraceTimelineSnapshot;
+    getSnapshot: () => VoiceTraceTimelineSnapshot;
+    refresh: () => Promise<VoiceTraceTimelineReport | null>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/traceTimelineWidget.d.ts

@@ -0,0 +1,32 @@
+import type { VoiceTraceTimelineSession } from '../traceTimeline';
+import { type VoiceTraceTimelineClientOptions, type VoiceTraceTimelineSnapshot } from './traceTimeline';
+export type VoiceTraceTimelineSessionView = VoiceTraceTimelineSession & {
+    detailHref: string;
+    durationLabel: string;
+    label: string;
+    providerLabel: string;
+};
+export type VoiceTraceTimelineViewModel = {
+    description: string;
+    error: string | null;
+    isLoading: boolean;
+    label: string;
+    sessions: VoiceTraceTimelineSessionView[];
+    status: 'empty' | 'error' | 'failed' | 'loading' | 'ready' | 'warning';
+    title: string;
+    updatedAt?: number;
+};
+export type VoiceTraceTimelineWidgetOptions = VoiceTraceTimelineClientOptions & {
+    description?: string;
+    detailBasePath?: string;
+    limit?: number;
+    title?: string;
+};
+export declare const createVoiceTraceTimelineViewModel: (snapshot: VoiceTraceTimelineSnapshot, options?: VoiceTraceTimelineWidgetOptions) => VoiceTraceTimelineViewModel;
+export declare const renderVoiceTraceTimelineWidgetHTML: (snapshot: VoiceTraceTimelineSnapshot, options?: VoiceTraceTimelineWidgetOptions) => string;
+export declare const getVoiceTraceTimelineCSS: () => string;
+export declare const mountVoiceTraceTimeline: (element: Element, path?: string, options?: VoiceTraceTimelineWidgetOptions) => {
+    close: () => void;
+    refresh: () => Promise<import("..").VoiceTraceTimelineReport | null>;
+};
+export declare const defineVoiceTraceTimelineElement: (tagName?: string) => void;

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { voice } from './plugin';
 export { createVoiceAppKit, createVoiceAppKitRoutes, summarizeVoiceAppKitStatus } from './appKit';
 export { createVoiceAssistant, createVoiceExperiment, summarizeVoiceAssistantRuns } from './assistant';
 export { createVoiceAssistantHealthHTMLHandler, createVoiceAssistantHealthJSONHandler, createVoiceAssistantHealthRoutes, renderVoiceAssistantHealthHTML, summarizeVoiceAssistantHealth } from './assistantHealth';
+export { createVoiceBargeInRoutes, renderVoiceBargeInHTML, summarizeVoiceBargeIn } from './bargeInRoutes';
 export { buildVoiceDiagnosticsMarkdown, createVoiceDiagnosticsRoutes, resolveVoiceDiagnosticsTraceFilter } from './diagnosticsRoutes';
 export { compareVoiceEvalBaseline, createVoiceFileEvalBaselineStore, createVoiceFileScenarioFixtureStore, createVoiceEvalRoutes, renderVoiceEvalBaselineHTML, renderVoiceEvalHTML, renderVoiceScenarioEvalHTML, renderVoiceScenarioFixtureEvalHTML, runVoiceScenarioEvals, runVoiceScenarioFixtureEvals, runVoiceSessionEvals } from './evalRoutes';
 export { createVoiceWorkflowContract, createVoiceWorkflowContractHandler, createVoiceWorkflowContractPreset, createVoiceWorkflowScenario, recordVoiceWorkflowContractTrace, validateVoiceWorkflowRouteResult } from './workflowContract';
@@ -48,6 +49,7 @@ export { resolveVoiceRuntimePreset } from './presets';
 export { resolveTurnDetectionConfig, TURN_PROFILE_DEFAULTS } from './turnProfiles';
 export { createVoiceCallReviewFromLiveTelephonyReport, createVoiceCallReviewRecorder, renderVoiceCallReviewHTML, renderVoiceCallReviewMarkdown } from './testing/review';
 export type { VoiceAppKitLink, VoiceAppKitRoutes, VoiceAppKitRoutesOptions, VoiceAppKitStatus, VoiceAppKitStatusOptions, VoiceAppKitStatusReport, VoiceAppKitSurface } from './appKit';
+export type { VoiceBargeInReport, VoiceBargeInRoutesOptions } from './bargeInRoutes';
 export type { VoiceAssistant, VoiceAssistantArtifactPlan, VoiceAssistantExperiment, VoiceAssistantExperimentOptions, VoiceAssistantGuardrailInput, VoiceAssistantGuardrails, VoiceAssistantMemoryLifecycle, VoiceAssistantMemoryLifecycleInput, VoiceAssistantOptions, VoiceAssistantOutputGuardrailInput, VoiceAssistantPreset, VoiceAssistantRunsSummary, VoiceAssistantRunSummary, VoiceAssistantVariant } from './assistant';
 export type { VoiceAssistantHealthFailure, VoiceAssistantHealthHTMLHandlerOptions, VoiceAssistantHealthRoutesOptions, VoiceAssistantHealthSummary, VoiceAssistantHealthSummaryOptions } from './assistantHealth';
 export type { VoiceAssistantMemoryBinding, VoiceAssistantMemoryHandle, VoiceAssistantMemoryOptions, VoiceAssistantMemoryRecord, VoiceAssistantMemoryStore } from './assistantMemory';