@absolutejs/voice 0.0.22-beta.60 → 0.0.22-beta.61

package/dist/client/index.d.ts

@@ -10,6 +10,8 @@ export { createVoiceOpsStatusViewModel, defineVoiceOpsStatusElement, getVoiceOps
 export { createVoiceRoutingStatusStore, fetchVoiceRoutingStatus } from './routingStatus';
 export { createVoiceRoutingStatusViewModel, defineVoiceRoutingStatusElement, getVoiceRoutingStatusCSS, mountVoiceRoutingStatus, renderVoiceRoutingStatusHTML } from './routingStatusWidget';
 export { createVoiceProviderStatusStore, fetchVoiceProviderStatus } from './providerStatus';
+export { createVoiceProviderSimulationControlsStore } from './providerSimulationControls';
+export { bindVoiceProviderSimulationControls, createVoiceProviderSimulationControlsViewModel, defineVoiceProviderSimulationControlsElement, mountVoiceProviderSimulationControls, renderVoiceProviderSimulationControlsHTML } from './providerSimulationControlsWidget';
 export { createVoiceProviderStatusViewModel, defineVoiceProviderStatusElement, getVoiceProviderStatusCSS, mountVoiceProviderStatus, renderVoiceProviderStatusHTML } from './providerStatusWidget';
 export { createVoiceWorkflowStatusStore, fetchVoiceWorkflowStatus } from './workflowStatus';
 export type { VoiceAppKitStatusClientOptions, VoiceAppKitStatusSnapshot } from './appKitStatus';
@@ -17,5 +19,7 @@ export type { VoiceOpsStatusSurfaceView, VoiceOpsStatusViewModel, VoiceOpsStatus
 export type { VoiceRoutingStatusClientOptions, VoiceRoutingStatusSnapshot } from './routingStatus';
 export type { VoiceRoutingStatusViewModel, VoiceRoutingStatusWidgetOptions } from './routingStatusWidget';
 export type { VoiceProviderStatusClientOptions, VoiceProviderStatusSnapshot } from './providerStatus';
+export type { VoiceProviderSimulationControlsOptions, VoiceProviderSimulationControlsSnapshot, VoiceProviderSimulationProvider } from './providerSimulationControls';
+export type { VoiceProviderSimulationControlsViewModel } from './providerSimulationControlsWidget';
 export type { VoiceProviderStatusCardView, VoiceProviderStatusViewModel, VoiceProviderStatusWidgetOptions } from './providerStatusWidget';
 export type { VoiceWorkflowStatusClientOptions, VoiceWorkflowStatusSnapshot } from './workflowStatus';

package/dist/client/index.js

@@ -2073,10 +2073,184 @@ var createVoiceProviderStatusStore = (path = "/api/provider-status", options = {
     }
   };
 };
+// src/client/providerSimulationControls.ts
+var postSimulation = async (pathPrefix, mode, provider, fetchImpl) => {
+  const response = await fetchImpl(`${pathPrefix}/${mode}?provider=${encodeURIComponent(provider)}`, { method: "POST" });
+  const body = await response.json().catch(() => null);
+  if (!response.ok) {
+    const message = body && typeof body === "object" && "error" in body ? String(body.error) : `Voice provider simulation failed: HTTP ${response.status}`;
+    throw new Error(message);
+  }
+  return body;
+};
+var createVoiceProviderSimulationControlsStore = (options) => {
+  const listeners = new Set;
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const pathPrefix = options.pathPrefix ?? `/api/${options.kind ?? "stt"}-simulate`;
+  let closed = false;
+  let snapshot = {
+    error: null,
+    isRunning: false,
+    lastResult: null,
+    mode: null,
+    provider: null
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const run = async (provider, mode) => {
+    if (closed) {
+      return snapshot.lastResult;
+    }
+    snapshot = {
+      ...snapshot,
+      error: null,
+      isRunning: true,
+      mode,
+      provider
+    };
+    emit();
+    try {
+      const result = await postSimulation(pathPrefix, mode, provider, fetchImpl);
+      snapshot = {
+        error: null,
+        isRunning: false,
+        lastResult: result,
+        mode,
+        provider,
+        updatedAt: Date.now()
+      };
+      emit();
+      return result;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isRunning: false
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    listeners.clear();
+  };
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    run,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+// src/client/providerSimulationControlsWidget.ts
+var escapeHtml3 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var formatKind = (kind) => (kind ?? "stt").toUpperCase();
+var createVoiceProviderSimulationControlsViewModel = (snapshot, options) => {
+  const configuredProviders = options.providers.filter((provider) => provider.configured !== false);
+  const fallbackReady = !options.fallbackRequiredProvider || configuredProviders.some((entry) => entry.provider === options.fallbackRequiredProvider);
+  const failureProviders = (options.failureProviders ? options.failureProviders.map((provider) => ({ provider })) : configuredProviders).filter((provider) => configuredProviders.some((entry) => entry.provider === provider.provider));
+  return {
+    canSimulateFailure: configuredProviders.length > 0 && fallbackReady,
+    description: options.failureMessage ?? `Simulate ${formatKind(options.kind)} provider failure and recovery without changing credentials.`,
+    error: snapshot.error,
+    failureProviders,
+    isRunning: snapshot.isRunning,
+    label: snapshot.isRunning ? `Running ${snapshot.mode ?? "simulation"}` : snapshot.lastResult ? `${snapshot.lastResult.provider} ${snapshot.lastResult.mode} simulated` : configuredProviders.length ? `${configuredProviders.length} configured` : "No configured providers",
+    providers: configuredProviders,
+    resultText: snapshot.lastResult ? JSON.stringify(snapshot.lastResult, null, 2) : null,
+    title: options.title ?? `${formatKind(options.kind)} Failure Simulation`
+  };
+};
+var renderVoiceProviderSimulationControlsHTML = (snapshot, options) => {
+  const model = createVoiceProviderSimulationControlsViewModel(snapshot, options);
+  const failureButtons = model.failureProviders.map((provider) => `<button type="button" data-voice-provider-fail="${escapeHtml3(provider.provider)}"${!model.canSimulateFailure || snapshot.isRunning ? " disabled" : ""}>Simulate ${escapeHtml3(provider.provider)} ${escapeHtml3(formatKind(options.kind))} failure</button>`).join("");
+  const recoveryButtons = model.providers.map((provider) => `<button type="button" data-voice-provider-recover="${escapeHtml3(provider.provider)}"${snapshot.isRunning ? " disabled" : ""}>Mark ${escapeHtml3(provider.provider)} recovered</button>`).join("");
+  return `<section class="absolute-voice-provider-simulation absolute-voice-provider-simulation--${snapshot.error ? "error" : snapshot.isRunning ? "running" : "ready"}">
+  <header class="absolute-voice-provider-simulation__header">
+    <span class="absolute-voice-provider-simulation__eyebrow">${escapeHtml3(model.title)}</span>
+    <strong class="absolute-voice-provider-simulation__label">${escapeHtml3(model.label)}</strong>
+  </header>
+  <p class="absolute-voice-provider-simulation__description">${escapeHtml3(model.description)}</p>
+  ${model.canSimulateFailure ? "" : `<p class="absolute-voice-provider-simulation__empty">${escapeHtml3(options.fallbackRequiredMessage ?? "Configure fallback providers before simulating failure.")}</p>`}
+  <div class="absolute-voice-provider-simulation__actions">${failureButtons}${recoveryButtons}</div>
+  ${snapshot.error ? `<p class="absolute-voice-provider-simulation__error">${escapeHtml3(snapshot.error)}</p>` : ""}
+  ${model.resultText ? `<pre class="absolute-voice-provider-simulation__result">${escapeHtml3(model.resultText)}</pre>` : ""}
+</section>`;
+};
+var bindVoiceProviderSimulationControls = (element, store) => {
+  const onClick = (event) => {
+    const target = event.target;
+    if (!(target instanceof HTMLElement)) {
+      return;
+    }
+    const failProvider = target.getAttribute("data-voice-provider-fail");
+    const recoverProvider = target.getAttribute("data-voice-provider-recover");
+    if (failProvider) {
+      store.run(failProvider, "failure").catch(() => {});
+    }
+    if (recoverProvider) {
+      store.run(recoverProvider, "recovery").catch(() => {});
+    }
+  };
+  element.addEventListener("click", onClick);
+  return () => element.removeEventListener("click", onClick);
+};
+var mountVoiceProviderSimulationControls = (element, options) => {
+  const store = createVoiceProviderSimulationControlsStore(options);
+  const render = () => {
+    element.innerHTML = renderVoiceProviderSimulationControlsHTML(store.getSnapshot(), options);
+  };
+  const unsubscribeStore = store.subscribe(render);
+  const unsubscribeDom = bindVoiceProviderSimulationControls(element, store);
+  render();
+  return {
+    close: () => {
+      unsubscribeDom();
+      unsubscribeStore();
+      store.close();
+    },
+    run: store.run
+  };
+};
+var defineVoiceProviderSimulationControlsElement = (tagName = "absolute-voice-provider-simulation") => {
+  if (typeof window === "undefined" || typeof customElements === "undefined" || customElements.get(tagName)) {
+    return;
+  }
+  customElements.define(tagName, class AbsoluteVoiceProviderSimulationElement extends HTMLElement {
+    mounted;
+    connectedCallback() {
+      const providers = (this.getAttribute("providers") ?? "").split(",").map((provider) => provider.trim()).filter(Boolean).map((provider) => ({ provider }));
+      const failureProviders = (this.getAttribute("failure-providers") ?? "").split(",").map((provider) => provider.trim()).filter(Boolean);
+      this.mounted = mountVoiceProviderSimulationControls(this, {
+        failureProviders: failureProviders.length ? failureProviders : undefined,
+        fallbackRequiredMessage: this.getAttribute("fallback-required-message") ?? undefined,
+        fallbackRequiredProvider: this.getAttribute("fallback-required-provider") ?? undefined,
+        failureMessage: this.getAttribute("failure-message") ?? undefined,
+        kind: this.getAttribute("kind") ?? "stt",
+        pathPrefix: this.getAttribute("path-prefix") ?? undefined,
+        providers,
+        title: this.getAttribute("title") ?? undefined
+      });
+    }
+    disconnectedCallback() {
+      this.mounted?.close();
+      this.mounted = undefined;
+    }
+  });
+};
 // src/client/providerStatusWidget.ts
 var DEFAULT_TITLE3 = "Voice Providers";
 var DEFAULT_DESCRIPTION3 = "Live provider health, fallback counts, latency, and suppression state from your self-hosted trace store.";
-var escapeHtml3 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var escapeHtml4 = (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 formatStatus = (status) => status.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
 var formatLatency = (value) => typeof value === "number" ? `${value}ms` : "No samples";
@@ -2132,25 +2306,25 @@ var createVoiceProviderStatusViewModel = (snapshot, options = {}) => {
 };
 var renderVoiceProviderStatusHTML = (snapshot, options = {}) => {
   const model = createVoiceProviderStatusViewModel(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--${escapeHtml3(provider.status)}">
+  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--${escapeHtml4(provider.status)}">
   <header>
-    <strong>${escapeHtml3(provider.label)}</strong>
-    <span>${escapeHtml3(formatStatus(provider.status))}</span>
+    <strong>${escapeHtml4(provider.label)}</strong>
+    <span>${escapeHtml4(formatStatus(provider.status))}</span>
   </header>
-  <p>${escapeHtml3(provider.detail)}</p>
+  <p>${escapeHtml4(provider.detail)}</p>
   <dl>${provider.rows.map((row) => `<div>
-    <dt>${escapeHtml3(row.label)}</dt>
-    <dd>${escapeHtml3(row.value)}</dd>
+    <dt>${escapeHtml4(row.label)}</dt>
+    <dd>${escapeHtml4(row.value)}</dd>
   </div>`).join("")}</dl>
 </article>`).join("")}</div>` : '<p class="absolute-voice-provider-status__empty">Run voice traffic to see provider health.</p>';
-  return `<section class="absolute-voice-provider-status absolute-voice-provider-status--${escapeHtml3(model.status)}">
+  return `<section class="absolute-voice-provider-status absolute-voice-provider-status--${escapeHtml4(model.status)}">
   <header class="absolute-voice-provider-status__header">
-    <span class="absolute-voice-provider-status__eyebrow">${escapeHtml3(model.title)}</span>
-    <strong class="absolute-voice-provider-status__label">${escapeHtml3(model.label)}</strong>
+    <span class="absolute-voice-provider-status__eyebrow">${escapeHtml4(model.title)}</span>
+    <strong class="absolute-voice-provider-status__label">${escapeHtml4(model.label)}</strong>
   </header>
-  <p class="absolute-voice-provider-status__description">${escapeHtml3(model.description)}</p>
+  <p class="absolute-voice-provider-status__description">${escapeHtml4(model.description)}</p>
   ${providers}
-  ${model.error ? `<p class="absolute-voice-provider-status__error">${escapeHtml3(model.error)}</p>` : ""}
+  ${model.error ? `<p class="absolute-voice-provider-status__error">${escapeHtml4(model.error)}</p>` : ""}
 </section>`;
 };
 var getVoiceProviderStatusCSS = () => `.absolute-voice-provider-status{border:1px solid #d8d2c4;border-radius:20px;background:#fffaf0;color:#16130d;padding:18px;box-shadow:0 18px 40px rgba(47,37,18,.12);font-family:inherit}.absolute-voice-provider-status--error,.absolute-voice-provider-status--warning{border-color:#f2a7a7;background:#fff5f3}.absolute-voice-provider-status__header,.absolute-voice-provider-status__provider header{align-items:start;display:flex;gap:12px;justify-content:space-between}.absolute-voice-provider-status__eyebrow{color:#73664f;font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase}.absolute-voice-provider-status__label{font-size:24px;line-height:1}.absolute-voice-provider-status__description,.absolute-voice-provider-status__provider p,.absolute-voice-provider-status__provider dt,.absolute-voice-provider-status__empty{color:#514733}.absolute-voice-provider-status__providers{display:grid;gap:12px;margin-top:14px}.absolute-voice-provider-status__provider{background:#fff;border:1px solid #eee4d2;border-radius:16px;padding:14px}.absolute-voice-provider-status__provider--degraded,.absolute-voice-provider-status__provider--rate-limited,.absolute-voice-provider-status__provider--suppressed{border-color:#f2a7a7}.absolute-voice-provider-status__provider--recoverable{border-color:#fbbf24}.absolute-voice-provider-status__provider p{margin:10px 0}.absolute-voice-provider-status__provider dl{display:grid;gap:8px;grid-template-columns:repeat(2,minmax(0,1fr));margin:0}.absolute-voice-provider-status__provider div{background:#fffaf0;border:1px solid #eee4d2;border-radius:12px;padding:8px}.absolute-voice-provider-status__provider dt{font-size:12px}.absolute-voice-provider-status__provider dd{font-weight:800;margin:4px 0 0}.absolute-voice-provider-status__empty{margin:14px 0 0}.absolute-voice-provider-status__error{color:#9f1239;font-weight:700}`;
@@ -2271,9 +2445,11 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 export {
   renderVoiceRoutingStatusHTML,
   renderVoiceProviderStatusHTML,
+  renderVoiceProviderSimulationControlsHTML,
   renderVoiceOpsStatusHTML,
   mountVoiceRoutingStatus,
   mountVoiceProviderStatus,
+  mountVoiceProviderSimulationControls,
   mountVoiceOpsStatus,
   getVoiceRoutingStatusCSS,
   getVoiceProviderStatusCSS,
@@ -2285,6 +2461,7 @@ export {
   fetchVoiceAppKitStatus,
   defineVoiceRoutingStatusElement,
   defineVoiceProviderStatusElement,
+  defineVoiceProviderSimulationControlsElement,
   defineVoiceOpsStatusElement,
   decodeVoiceAudioChunk,
   createVoiceWorkflowStatusStore,
@@ -2293,6 +2470,8 @@ export {
   createVoiceRoutingStatusStore,
   createVoiceProviderStatusViewModel,
   createVoiceProviderStatusStore,
+  createVoiceProviderSimulationControlsViewModel,
+  createVoiceProviderSimulationControlsStore,
   createVoiceOpsStatusViewModel,
   createVoiceDuplexController,
   createVoiceController,
@@ -2300,6 +2479,7 @@ export {
   createVoiceAudioPlayer,
   createVoiceAppKitStatusStore,
   createMicrophoneCapture,
+  bindVoiceProviderSimulationControls,
   bindVoiceHTMX,
   bindVoiceBargeIn
 };

package/dist/client/providerSimulationControls.d.ts

@@ -0,0 +1,33 @@
+import type { VoiceIOProviderFailureSimulationMode, VoiceIOProviderFailureSimulationResult } from '../testing/ioProviderSimulator';
+export type VoiceProviderSimulationProvider<TProvider extends string = string> = {
+    configured?: boolean;
+    provider: TProvider;
+};
+export type VoiceProviderSimulationControlsOptions<TProvider extends string = string> = {
+    fallbackRequiredMessage?: string;
+    fallbackRequiredProvider?: TProvider;
+    failureMessage?: string;
+    failureProviders?: readonly TProvider[];
+    fetch?: typeof fetch;
+    intervalMs?: number;
+    kind?: 'stt' | 'tts' | string;
+    pathPrefix?: string;
+    providers: readonly VoiceProviderSimulationProvider<TProvider>[];
+    recoveryMessage?: string;
+    title?: string;
+};
+export type VoiceProviderSimulationControlsSnapshot<TProvider extends string = string> = {
+    error: string | null;
+    isRunning: boolean;
+    lastResult: VoiceIOProviderFailureSimulationResult<TProvider> | null;
+    mode: VoiceIOProviderFailureSimulationMode | null;
+    provider: TProvider | null;
+    updatedAt?: number;
+};
+export declare const createVoiceProviderSimulationControlsStore: <TProvider extends string = string>(options: VoiceProviderSimulationControlsOptions<TProvider>) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceProviderSimulationControlsSnapshot<TProvider>;
+    getSnapshot: () => VoiceProviderSimulationControlsSnapshot<TProvider>;
+    run: (provider: TProvider, mode: VoiceIOProviderFailureSimulationMode) => Promise<VoiceIOProviderFailureSimulationResult<TProvider> | null>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/providerSimulationControlsWidget.d.ts

@@ -0,0 +1,20 @@
+import { createVoiceProviderSimulationControlsStore, type VoiceProviderSimulationControlsOptions, type VoiceProviderSimulationControlsSnapshot, type VoiceProviderSimulationProvider } from './providerSimulationControls';
+export type VoiceProviderSimulationControlsViewModel<TProvider extends string = string> = {
+    canSimulateFailure: boolean;
+    description: string;
+    error: string | null;
+    failureProviders: VoiceProviderSimulationProvider<TProvider>[];
+    isRunning: boolean;
+    label: string;
+    providers: VoiceProviderSimulationProvider<TProvider>[];
+    resultText: string | null;
+    title: string;
+};
+export declare const createVoiceProviderSimulationControlsViewModel: <TProvider extends string = string>(snapshot: VoiceProviderSimulationControlsSnapshot<TProvider>, options: VoiceProviderSimulationControlsOptions<TProvider>) => VoiceProviderSimulationControlsViewModel<TProvider>;
+export declare const renderVoiceProviderSimulationControlsHTML: <TProvider extends string = string>(snapshot: VoiceProviderSimulationControlsSnapshot<TProvider>, options: VoiceProviderSimulationControlsOptions<TProvider>) => string;
+export declare const bindVoiceProviderSimulationControls: <TProvider extends string = string>(element: Element, store: ReturnType<typeof createVoiceProviderSimulationControlsStore<TProvider>>) => () => void;
+export declare const mountVoiceProviderSimulationControls: <TProvider extends string = string>(element: Element, options: VoiceProviderSimulationControlsOptions<TProvider>) => {
+    close: () => void;
+    run: (provider: TProvider, mode: import("../testing").VoiceIOProviderFailureSimulationMode) => Promise<import("../testing").VoiceIOProviderFailureSimulationResult<TProvider> | null>;
+};
+export declare const defineVoiceProviderSimulationControlsElement: (tagName?: string) => void;

package/dist/react/VoiceProviderSimulationControls.d.ts

@@ -0,0 +1,5 @@
+import type { VoiceProviderSimulationControlsOptions } from '../client/providerSimulationControls';
+export type VoiceProviderSimulationControlsProps<TProvider extends string = string> = VoiceProviderSimulationControlsOptions<TProvider> & {
+    className?: string;
+};
+export declare const VoiceProviderSimulationControls: <TProvider extends string = string>({ className, ...options }: VoiceProviderSimulationControlsProps<TProvider>) => import("react/jsx-runtime").JSX.Element;

package/dist/react/index.d.ts

@@ -1,9 +1,11 @@
 export { VoiceOpsStatus } from './VoiceOpsStatus';
+export { VoiceProviderSimulationControls } from './VoiceProviderSimulationControls';
 export { VoiceProviderStatus } from './VoiceProviderStatus';
 export { VoiceRoutingStatus } from './VoiceRoutingStatus';
 export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
 export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
 export { useVoiceProviderStatus } from './useVoiceProviderStatus';
+export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
 export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
 export { useVoiceWorkflowStatus } from './useVoiceWorkflowStatus';