@absolutejs/voice 0.0.22-beta.17 → 0.0.22-beta.18

package/dist/assistantHealth.d.ts

@@ -0,0 +1,79 @@
+import { Elysia } from 'elysia';
+import { type VoiceAssistantRunsSummary } from './assistant';
+import { type VoiceProviderHealthSummary } from './providerHealth';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+export type VoiceAssistantHealthFailure = {
+    at: number;
+    assistantId?: string;
+    error?: string;
+    provider?: string;
+    rateLimited?: boolean;
+    sessionId: string;
+    status?: string;
+    turnId?: string;
+    type: StoredVoiceTraceEvent['type'];
+};
+export type VoiceAssistantHealthSummary<TProvider extends string = string> = {
+    assistantRuns: VoiceAssistantRunsSummary;
+    providerHealth: VoiceProviderHealthSummary<TProvider>[];
+    recentFailures: VoiceAssistantHealthFailure[];
+};
+export type VoiceAssistantHealthSummaryOptions<TProvider extends string = string> = {
+    events?: StoredVoiceTraceEvent[];
+    maxFailures?: number;
+    providers?: readonly TProvider[];
+    store?: VoiceTraceEventStore;
+};
+export type VoiceAssistantHealthHTMLHandlerOptions<TProvider extends string = string> = VoiceAssistantHealthSummaryOptions<TProvider> & {
+    headers?: HeadersInit;
+    render?: (summary: VoiceAssistantHealthSummary<TProvider>) => string | Promise<string>;
+};
+export type VoiceAssistantHealthRoutesOptions<TProvider extends string = string> = VoiceAssistantHealthHTMLHandlerOptions<TProvider> & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
+export declare const summarizeVoiceAssistantHealth: <TProvider extends string = string>(options: VoiceAssistantHealthSummaryOptions<TProvider>) => Promise<VoiceAssistantHealthSummary<TProvider>>;
+export declare const renderVoiceAssistantHealthHTML: <TProvider extends string = string>(summary: VoiceAssistantHealthSummary<TProvider>) => string;
+export declare const createVoiceAssistantHealthJSONHandler: <TProvider extends string = string>(options: VoiceAssistantHealthSummaryOptions<TProvider>) => () => Promise<VoiceAssistantHealthSummary<TProvider>>;
+export declare const createVoiceAssistantHealthHTMLHandler: <TProvider extends string = string>(options: VoiceAssistantHealthHTMLHandlerOptions<TProvider>) => () => Promise<Response>;
+export declare const createVoiceAssistantHealthRoutes: <TProvider extends string = string>(options: VoiceAssistantHealthRoutesOptions<TProvider>) => 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: VoiceAssistantHealthSummary<TProvider>;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { voice } from './plugin';
 export { createVoiceAssistant, createVoiceExperiment, summarizeVoiceAssistantRuns } from './assistant';
+export { createVoiceAssistantHealthHTMLHandler, createVoiceAssistantHealthJSONHandler, createVoiceAssistantHealthRoutes, renderVoiceAssistantHealthHTML, summarizeVoiceAssistantHealth } from './assistantHealth';
 export { createVoiceAgent, createVoiceAgentSquad, createVoiceAgentTool } from './agent';
 export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap, createStoredVoiceIntegrationEvent, createStoredVoiceOpsTask, createVoiceFileExternalObjectMapStore, createVoiceFileAssistantMemoryStore, createVoiceFileIntegrationEventStore, createVoiceFileReviewStore, createVoiceFileRuntimeStorage, createVoiceFileSessionStore, createVoiceFileTaskStore, createVoiceFileTraceSinkDeliveryStore, createVoiceFileTraceEventStore } from './fileStore';
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
@@ -26,6 +27,7 @@ export { resolveVoiceRuntimePreset } from './presets';
 export { resolveTurnDetectionConfig, TURN_PROFILE_DEFAULTS } from './turnProfiles';
 export { createVoiceCallReviewFromLiveTelephonyReport, createVoiceCallReviewRecorder, renderVoiceCallReviewHTML, renderVoiceCallReviewMarkdown } from './testing/review';
 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';
 export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderRouterPolicy, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';

package/dist/index.js

@@ -6101,6 +6101,292 @@ var summarizeVoiceAssistantRuns = async (input) => {
     totalRuns: assistantRuns.length
   };
 };
+// src/assistantHealth.ts
+import { Elysia as Elysia3 } from "elysia";
+
+// src/providerHealth.ts
+import { Elysia as Elysia2 } from "elysia";
+var getString = (value) => typeof value === "string" ? value : undefined;
+var getNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var isProviderStatus = (value) => value === "success" || value === "fallback" || value === "error";
+var summarizeVoiceProviderHealth = async (input) => {
+  const options = Array.isArray(input) ? { events: input } : input;
+  const events = options.events ?? await options.store?.list() ?? [];
+  const providers = options.providers ?? [];
+  const providerSet = new Set(providers);
+  const now = options.now ?? Date.now();
+  const entries = new Map;
+  const isAllowedProvider = (value) => typeof value === "string" && (providerSet.size === 0 || providerSet.has(value));
+  const getEntry = (provider) => {
+    const existing = entries.get(provider);
+    if (existing) {
+      return existing;
+    }
+    const entry = {
+      elapsedCount: 0,
+      elapsedTotal: 0,
+      errorCount: 0,
+      fallbackCount: 0,
+      provider,
+      rateLimited: false,
+      recommended: false,
+      runCount: 0,
+      status: "idle"
+    };
+    entries.set(provider, entry);
+    return entry;
+  };
+  for (const provider of providers) {
+    getEntry(provider);
+  }
+  const hasProviderRouterEvents = events.some((event) => event.type === "session.error" && isAllowedProvider(event.payload.provider) && isProviderStatus(event.payload.providerStatus));
+  for (const event of events) {
+    if (event.type === "assistant.run") {
+      if (hasProviderRouterEvents) {
+        continue;
+      }
+      const provider2 = event.payload.variantId;
+      if (!isAllowedProvider(provider2)) {
+        continue;
+      }
+      const entry2 = getEntry(provider2);
+      entry2.runCount += 1;
+      const elapsedMs = getNumber(event.payload.elapsedMs);
+      if (elapsedMs !== undefined) {
+        entry2.elapsedCount += 1;
+        entry2.elapsedTotal += elapsedMs;
+      }
+      continue;
+    }
+    if (event.type !== "session.error") {
+      continue;
+    }
+    const provider = event.payload.provider;
+    if (!isAllowedProvider(provider)) {
+      continue;
+    }
+    const providerStatus = isProviderStatus(event.payload.providerStatus) ? event.payload.providerStatus : undefined;
+    const applyProviderHealth = () => {
+      const entry2 = getEntry(provider);
+      const providerHealth = event.payload.providerHealth;
+      if (providerHealth && typeof providerHealth === "object") {
+        const suppressedUntil2 = getNumber(providerHealth.suppressedUntil);
+        if (suppressedUntil2 !== undefined) {
+          entry2.suppressedUntil = suppressedUntil2;
+        }
+      }
+      const suppressedUntil = getNumber(event.payload.suppressedUntil);
+      if (suppressedUntil !== undefined) {
+        entry2.suppressedUntil = suppressedUntil;
+      }
+      const suppressionRemainingMs = getNumber(event.payload.suppressionRemainingMs);
+      if (suppressionRemainingMs !== undefined) {
+        entry2.suppressionRemainingMs = suppressionRemainingMs;
+      }
+      return entry2;
+    };
+    if (providerStatus === "success" || providerStatus === "fallback") {
+      const entry2 = applyProviderHealth();
+      entry2.runCount += 1;
+      entry2.lastSuccessAt = event.at;
+      if (providerStatus === "success") {
+        entry2.lastError = undefined;
+        entry2.rateLimited = false;
+        entry2.suppressedUntil = undefined;
+        entry2.suppressionRemainingMs = undefined;
+      }
+      const elapsedMs = getNumber(event.payload.elapsedMs);
+      if (elapsedMs !== undefined) {
+        entry2.elapsedCount += 1;
+        entry2.elapsedTotal += elapsedMs;
+      }
+      const selectedProvider = event.payload.selectedProvider;
+      if (providerStatus === "fallback" && isAllowedProvider(selectedProvider) && selectedProvider !== provider) {
+        getEntry(selectedProvider).fallbackCount += 1;
+      }
+      continue;
+    }
+    const entry = applyProviderHealth();
+    entry.errorCount += 1;
+    entry.lastError = getString(event.payload.error);
+    entry.lastErrorAt = event.at;
+    entry.rateLimited ||= event.payload.rateLimited === true;
+  }
+  const summaries = [...entries.values()].map((entry) => {
+    const hadSuppression = typeof entry.suppressedUntil === "number" || typeof entry.suppressionRemainingMs === "number";
+    const suppressionRemainingMs = typeof entry.suppressedUntil === "number" ? Math.max(0, entry.suppressedUntil - now) : entry.suppressionRemainingMs;
+    const activeSuppression = typeof suppressionRemainingMs === "number" && suppressionRemainingMs > 0;
+    const recoverable = hadSuppression && !activeSuppression;
+    const averageElapsedMs = entry.elapsedCount > 0 ? Math.round(entry.elapsedTotal / entry.elapsedCount) : undefined;
+    const status = activeSuppression ? "suppressed" : recoverable ? "recoverable" : entry.rateLimited ? "rate-limited" : entry.errorCount > 0 && (!entry.lastSuccessAt || !entry.lastErrorAt || entry.lastErrorAt > entry.lastSuccessAt) ? "degraded" : entry.runCount > 0 ? "healthy" : "idle";
+    return {
+      averageElapsedMs,
+      errorCount: entry.errorCount,
+      fallbackCount: entry.fallbackCount,
+      lastError: entry.lastError,
+      lastErrorAt: entry.lastErrorAt,
+      lastSuccessAt: entry.lastSuccessAt,
+      provider: entry.provider,
+      rateLimited: entry.rateLimited,
+      recommended: false,
+      runCount: entry.runCount,
+      status,
+      suppressionRemainingMs: activeSuppression ? suppressionRemainingMs : undefined,
+      suppressedUntil: entry.suppressedUntil
+    };
+  });
+  const recommended = summaries.filter((entry) => entry.status === "healthy").sort((left, right) => (left.averageElapsedMs ?? Number.MAX_SAFE_INTEGER) - (right.averageElapsedMs ?? Number.MAX_SAFE_INTEGER))[0];
+  if (recommended) {
+    recommended.recommended = true;
+  }
+  return summaries;
+};
+var escapeHtml3 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var renderVoiceProviderHealthHTML = (providers) => providers.length === 0 ? '<p class="voice-provider-empty">No provider status yet.</p>' : [
+  '<div class="voice-provider-health">',
+  ...providers.map((provider) => {
+    const suppressionSeconds = typeof provider.suppressionRemainingMs === "number" ? Math.ceil(provider.suppressionRemainingMs / 1000) : undefined;
+    return [
+      `<article class="voice-provider-card ${escapeHtml3(provider.status)}">`,
+      '<div class="voice-provider-card-header">',
+      `<strong>${escapeHtml3(provider.provider)}</strong>`,
+      `<span>${escapeHtml3(provider.status)}${provider.recommended ? " \xB7 recommended" : ""}</span>`,
+      "</div>",
+      "<dl>",
+      `<div><dt>Runs</dt><dd>${String(provider.runCount)}</dd></div>`,
+      `<div><dt>Avg latency</dt><dd>${String(provider.averageElapsedMs ?? 0)}ms</dd></div>`,
+      `<div><dt>Errors</dt><dd>${String(provider.errorCount)}</dd></div>`,
+      `<div><dt>Fallbacks</dt><dd>${String(provider.fallbackCount)}</dd></div>`,
+      "</dl>",
+      suppressionSeconds ? `<p>Temporarily suppressed for ${String(suppressionSeconds)}s.</p>` : "",
+      provider.lastError ? `<p>${escapeHtml3(provider.lastError)}</p>` : "",
+      "</article>"
+    ].join("");
+  }),
+  "</div>"
+].join("");
+var createVoiceProviderHealthJSONHandler = (options) => async () => summarizeVoiceProviderHealth(options);
+var createVoiceProviderHealthHTMLHandler = (options) => async () => {
+  const providers = await summarizeVoiceProviderHealth(options);
+  const render = options.render ?? renderVoiceProviderHealthHTML;
+  const body = await render(providers);
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceProviderHealthRoutes = (options) => {
+  const path = options.path ?? "/api/provider-status";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia2({
+    name: options.name ?? "absolutejs-voice-provider-health"
+  }).get(path, createVoiceProviderHealthJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceProviderHealthHTMLHandler(options));
+  }
+  return routes;
+};
+
+// src/assistantHealth.ts
+var escapeHtml4 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var renderCountMap = (values) => {
+  const entries = Object.entries(values).sort((left, right) => right[1] - left[1]);
+  if (entries.length === 0) {
+    return '<p class="voice-assistant-health-empty">No data yet.</p>';
+  }
+  return [
+    '<div class="voice-assistant-health-metrics">',
+    ...entries.map(([label, value]) => `<div><span>${escapeHtml4(label)}</span><strong>${String(value)}</strong></div>`),
+    "</div>"
+  ].join("");
+};
+var getString2 = (value) => typeof value === "string" ? value : undefined;
+var getRecentFailures = (events, maxFailures) => events.filter((event) => event.type === "session.error" || event.type === "assistant.guardrail" && event.payload.action === "blocked").toReversed().slice(0, maxFailures).map((event) => ({
+  at: event.at,
+  assistantId: getString2(event.payload.assistantId),
+  error: getString2(event.payload.error),
+  provider: getString2(event.payload.provider),
+  rateLimited: event.payload.rateLimited === true ? true : undefined,
+  sessionId: event.sessionId,
+  status: getString2(event.payload.providerStatus),
+  turnId: event.turnId,
+  type: event.type
+}));
+var summarizeVoiceAssistantHealth = async (options) => {
+  const events = options.events ?? await options.store?.list() ?? [];
+  return {
+    assistantRuns: await summarizeVoiceAssistantRuns({ events }),
+    providerHealth: await summarizeVoiceProviderHealth({
+      events,
+      providers: options.providers
+    }),
+    recentFailures: getRecentFailures(events, options.maxFailures ?? 8)
+  };
+};
+var renderVoiceAssistantHealthHTML = (summary) => {
+  const assistant = summary.assistantRuns.assistants[0];
+  const failures = summary.recentFailures;
+  return [
+    '<div class="voice-assistant-health">',
+    '<section class="voice-assistant-health-grid">',
+    `<article><span>Runs</span><strong>${String(assistant?.runCount ?? 0)}</strong></article>`,
+    `<article><span>Sessions</span><strong>${String(assistant?.sessions ?? 0)}</strong></article>`,
+    `<article><span>Guardrails</span><strong>${String(assistant?.guardrailCount ?? 0)}</strong></article>`,
+    `<article><span>Avg latency</span><strong>${String(assistant?.averageElapsedMs ?? 0)}ms</strong></article>`,
+    "</section>",
+    "<section>",
+    "<h3>Provider Health</h3>",
+    renderVoiceProviderHealthHTML(summary.providerHealth),
+    "</section>",
+    '<section class="voice-assistant-health-columns">',
+    `<article><h3>Outcomes</h3>${renderCountMap(assistant?.outcomes ?? {})}</article>`,
+    `<article><h3>Variants</h3>${renderCountMap(assistant?.variants ?? {})}</article>`,
+    `<article><h3>Tools</h3>${renderCountMap(assistant?.toolCalls ?? {})}</article>`,
+    `<article><h3>Artifact Plans</h3>${renderCountMap(assistant?.artifactPlans ?? {})}</article>`,
+    "</section>",
+    "<section>",
+    "<h3>Recent Failures</h3>",
+    failures.length === 0 ? '<p class="voice-assistant-health-empty">No failures yet.</p>' : [
+      '<div class="voice-assistant-health-failures">',
+      ...failures.map((failure) => [
+        "<article>",
+        `<strong>${escapeHtml4(failure.provider ?? failure.assistantId ?? failure.type)}</strong>`,
+        `<span>${escapeHtml4(failure.status ?? (failure.rateLimited ? "rate-limited" : "error"))}</span>`,
+        failure.error ? `<p>${escapeHtml4(failure.error)}</p>` : "",
+        `<small>${escapeHtml4(failure.sessionId)}${failure.turnId ? ` / ${escapeHtml4(failure.turnId)}` : ""}</small>`,
+        "</article>"
+      ].join("")),
+      "</div>"
+    ].join(""),
+    "</section>",
+    "</div>"
+  ].join("");
+};
+var createVoiceAssistantHealthJSONHandler = (options) => async () => summarizeVoiceAssistantHealth(options);
+var createVoiceAssistantHealthHTMLHandler = (options) => async () => {
+  const summary = await summarizeVoiceAssistantHealth(options);
+  const render = options.render ?? renderVoiceAssistantHealthHTML;
+  const body = await render(summary);
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceAssistantHealthRoutes = (options) => {
+  const path = options.path ?? "/api/assistant-health";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia3({
+    name: options.name ?? "absolutejs-voice-assistant-health"
+  }).get(path, createVoiceAssistantHealthJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceAssistantHealthHTMLHandler(options));
+  }
+  return routes;
+};
 // src/fileStore.ts
 import { mkdir, readFile, readdir, rename, rm, writeFile } from "fs/promises";
 import { join } from "path";
@@ -6437,7 +6723,7 @@ var exportVoiceTrace = async (input) => {
   };
 };
 var toNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : 0;
-var escapeHtml3 = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+var escapeHtml5 = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 var formatTraceValue = (value) => {
   if (value === undefined || value === null) {
     return "";
@@ -6715,10 +7001,10 @@ var renderVoiceTraceHTML = (events, options = {}) => {
     const offset = summary.startedAt === undefined ? event.at : Math.max(0, event.at - summary.startedAt);
     return [
       "<tr>",
-      `<td>${escapeHtml3(String(offset))}</td>`,
-      `<td>${escapeHtml3(event.type)}</td>`,
-      `<td>${escapeHtml3(event.turnId ?? "")}</td>`,
-      `<td><code>${escapeHtml3(JSON.stringify(event.payload))}</code></td>`,
+      `<td>${escapeHtml5(String(offset))}</td>`,
+      `<td>${escapeHtml5(event.type)}</td>`,
+      `<td>${escapeHtml5(event.turnId ?? "")}</td>`,
+      `<td><code>${escapeHtml5(JSON.stringify(event.payload))}</code></td>`,
       "</tr>"
     ].join("");
   }).join(`
@@ -6729,7 +7015,7 @@ var renderVoiceTraceHTML = (events, options = {}) => {
     "<head>",
     '<meta charset="utf-8" />',
     '<meta name="viewport" content="width=device-width, initial-scale=1" />',
-    `<title>${escapeHtml3(options.title ?? "Voice Trace")}</title>`,
+    `<title>${escapeHtml5(options.title ?? "Voice Trace")}</title>`,
     "<style>",
     "body{font-family:ui-sans-serif,system-ui,sans-serif;margin:2rem;line-height:1.45;background:#f8f7f2;color:#181713}",
     "main{max-width:1100px;margin:auto}",
@@ -6743,7 +7029,7 @@ var renderVoiceTraceHTML = (events, options = {}) => {
     "</style>",
     "</head>",
     "<body><main>",
-    `<h1>${escapeHtml3(options.title ?? `Voice Trace ${summary.sessionId ?? ""}`.trim())}</h1>`,
+    `<h1>${escapeHtml5(options.title ?? `Voice Trace ${summary.sessionId ?? ""}`.trim())}</h1>`,
     `<p class="${evaluation.pass ? "pass" : "fail"}">QA: ${evaluation.pass ? "pass" : "fail"}</p>`,
     '<section class="summary">',
     `<div class="card"><strong>Events</strong><br>${summary.eventCount}</div>`,
@@ -6757,7 +7043,7 @@ var renderVoiceTraceHTML = (events, options = {}) => {
     eventRows,
     "</tbody></table>",
     "<h2>Markdown Export</h2>",
-    `<pre>${escapeHtml3(markdown)}</pre>`,
+    `<pre>${escapeHtml5(markdown)}</pre>`,
     "</main></body></html>"
   ].join(`
 `);
@@ -7855,190 +8141,6 @@ var createGeminiVoiceAssistantModel = (options) => {
     }
   };
 };
-// src/providerHealth.ts
-import { Elysia as Elysia2 } from "elysia";
-var getString = (value) => typeof value === "string" ? value : undefined;
-var getNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
-var isProviderStatus = (value) => value === "success" || value === "fallback" || value === "error";
-var summarizeVoiceProviderHealth = async (input) => {
-  const options = Array.isArray(input) ? { events: input } : input;
-  const events = options.events ?? await options.store?.list() ?? [];
-  const providers = options.providers ?? [];
-  const providerSet = new Set(providers);
-  const now = options.now ?? Date.now();
-  const entries = new Map;
-  const isAllowedProvider = (value) => typeof value === "string" && (providerSet.size === 0 || providerSet.has(value));
-  const getEntry = (provider) => {
-    const existing = entries.get(provider);
-    if (existing) {
-      return existing;
-    }
-    const entry = {
-      elapsedCount: 0,
-      elapsedTotal: 0,
-      errorCount: 0,
-      fallbackCount: 0,
-      provider,
-      rateLimited: false,
-      recommended: false,
-      runCount: 0,
-      status: "idle"
-    };
-    entries.set(provider, entry);
-    return entry;
-  };
-  for (const provider of providers) {
-    getEntry(provider);
-  }
-  const hasProviderRouterEvents = events.some((event) => event.type === "session.error" && isAllowedProvider(event.payload.provider) && isProviderStatus(event.payload.providerStatus));
-  for (const event of events) {
-    if (event.type === "assistant.run") {
-      if (hasProviderRouterEvents) {
-        continue;
-      }
-      const provider2 = event.payload.variantId;
-      if (!isAllowedProvider(provider2)) {
-        continue;
-      }
-      const entry2 = getEntry(provider2);
-      entry2.runCount += 1;
-      const elapsedMs = getNumber(event.payload.elapsedMs);
-      if (elapsedMs !== undefined) {
-        entry2.elapsedCount += 1;
-        entry2.elapsedTotal += elapsedMs;
-      }
-      continue;
-    }
-    if (event.type !== "session.error") {
-      continue;
-    }
-    const provider = event.payload.provider;
-    if (!isAllowedProvider(provider)) {
-      continue;
-    }
-    const providerStatus = isProviderStatus(event.payload.providerStatus) ? event.payload.providerStatus : undefined;
-    const applyProviderHealth = () => {
-      const entry2 = getEntry(provider);
-      const providerHealth = event.payload.providerHealth;
-      if (providerHealth && typeof providerHealth === "object") {
-        const suppressedUntil2 = getNumber(providerHealth.suppressedUntil);
-        if (suppressedUntil2 !== undefined) {
-          entry2.suppressedUntil = suppressedUntil2;
-        }
-      }
-      const suppressedUntil = getNumber(event.payload.suppressedUntil);
-      if (suppressedUntil !== undefined) {
-        entry2.suppressedUntil = suppressedUntil;
-      }
-      const suppressionRemainingMs = getNumber(event.payload.suppressionRemainingMs);
-      if (suppressionRemainingMs !== undefined) {
-        entry2.suppressionRemainingMs = suppressionRemainingMs;
-      }
-      return entry2;
-    };
-    if (providerStatus === "success" || providerStatus === "fallback") {
-      const entry2 = applyProviderHealth();
-      entry2.runCount += 1;
-      entry2.lastSuccessAt = event.at;
-      if (providerStatus === "success") {
-        entry2.lastError = undefined;
-        entry2.rateLimited = false;
-        entry2.suppressedUntil = undefined;
-        entry2.suppressionRemainingMs = undefined;
-      }
-      const elapsedMs = getNumber(event.payload.elapsedMs);
-      if (elapsedMs !== undefined) {
-        entry2.elapsedCount += 1;
-        entry2.elapsedTotal += elapsedMs;
-      }
-      const selectedProvider = event.payload.selectedProvider;
-      if (providerStatus === "fallback" && isAllowedProvider(selectedProvider) && selectedProvider !== provider) {
-        getEntry(selectedProvider).fallbackCount += 1;
-      }
-      continue;
-    }
-    const entry = applyProviderHealth();
-    entry.errorCount += 1;
-    entry.lastError = getString(event.payload.error);
-    entry.lastErrorAt = event.at;
-    entry.rateLimited ||= event.payload.rateLimited === true;
-  }
-  const summaries = [...entries.values()].map((entry) => {
-    const hadSuppression = typeof entry.suppressedUntil === "number" || typeof entry.suppressionRemainingMs === "number";
-    const suppressionRemainingMs = typeof entry.suppressedUntil === "number" ? Math.max(0, entry.suppressedUntil - now) : entry.suppressionRemainingMs;
-    const activeSuppression = typeof suppressionRemainingMs === "number" && suppressionRemainingMs > 0;
-    const recoverable = hadSuppression && !activeSuppression;
-    const averageElapsedMs = entry.elapsedCount > 0 ? Math.round(entry.elapsedTotal / entry.elapsedCount) : undefined;
-    const status = activeSuppression ? "suppressed" : recoverable ? "recoverable" : entry.rateLimited ? "rate-limited" : entry.errorCount > 0 && (!entry.lastSuccessAt || !entry.lastErrorAt || entry.lastErrorAt > entry.lastSuccessAt) ? "degraded" : entry.runCount > 0 ? "healthy" : "idle";
-    return {
-      averageElapsedMs,
-      errorCount: entry.errorCount,
-      fallbackCount: entry.fallbackCount,
-      lastError: entry.lastError,
-      lastErrorAt: entry.lastErrorAt,
-      lastSuccessAt: entry.lastSuccessAt,
-      provider: entry.provider,
-      rateLimited: entry.rateLimited,
-      recommended: false,
-      runCount: entry.runCount,
-      status,
-      suppressionRemainingMs: activeSuppression ? suppressionRemainingMs : undefined,
-      suppressedUntil: entry.suppressedUntil
-    };
-  });
-  const recommended = summaries.filter((entry) => entry.status === "healthy").sort((left, right) => (left.averageElapsedMs ?? Number.MAX_SAFE_INTEGER) - (right.averageElapsedMs ?? Number.MAX_SAFE_INTEGER))[0];
-  if (recommended) {
-    recommended.recommended = true;
-  }
-  return summaries;
-};
-var escapeHtml4 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-var renderVoiceProviderHealthHTML = (providers) => providers.length === 0 ? '<p class="voice-provider-empty">No provider status yet.</p>' : [
-  '<div class="voice-provider-health">',
-  ...providers.map((provider) => {
-    const suppressionSeconds = typeof provider.suppressionRemainingMs === "number" ? Math.ceil(provider.suppressionRemainingMs / 1000) : undefined;
-    return [
-      `<article class="voice-provider-card ${escapeHtml4(provider.status)}">`,
-      '<div class="voice-provider-card-header">',
-      `<strong>${escapeHtml4(provider.provider)}</strong>`,
-      `<span>${escapeHtml4(provider.status)}${provider.recommended ? " \xB7 recommended" : ""}</span>`,
-      "</div>",
-      "<dl>",
-      `<div><dt>Runs</dt><dd>${String(provider.runCount)}</dd></div>`,
-      `<div><dt>Avg latency</dt><dd>${String(provider.averageElapsedMs ?? 0)}ms</dd></div>`,
-      `<div><dt>Errors</dt><dd>${String(provider.errorCount)}</dd></div>`,
-      `<div><dt>Fallbacks</dt><dd>${String(provider.fallbackCount)}</dd></div>`,
-      "</dl>",
-      suppressionSeconds ? `<p>Temporarily suppressed for ${String(suppressionSeconds)}s.</p>` : "",
-      provider.lastError ? `<p>${escapeHtml4(provider.lastError)}</p>` : "",
-      "</article>"
-    ].join("");
-  }),
-  "</div>"
-].join("");
-var createVoiceProviderHealthJSONHandler = (options) => async () => summarizeVoiceProviderHealth(options);
-var createVoiceProviderHealthHTMLHandler = (options) => async () => {
-  const providers = await summarizeVoiceProviderHealth(options);
-  const render = options.render ?? renderVoiceProviderHealthHTML;
-  const body = await render(providers);
-  return new Response(body, {
-    headers: {
-      "Content-Type": "text/html; charset=utf-8",
-      ...options.headers
-    }
-  });
-};
-var createVoiceProviderHealthRoutes = (options) => {
-  const path = options.path ?? "/api/provider-status";
-  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
-  const routes = new Elysia2({
-    name: options.name ?? "absolutejs-voice-provider-health"
-  }).get(path, createVoiceProviderHealthJSONHandler(options));
-  if (htmlPath) {
-    routes.get(htmlPath, createVoiceProviderHealthHTMLHandler(options));
-  }
-  return routes;
-};
 // src/sqliteStore.ts
 import { Database } from "bun:sqlite";
 var normalizeTableNameSegment = (value) => value.trim().replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "") || "voice";
@@ -10495,6 +10597,7 @@ export {
   summarizeVoiceOpsTaskAnalytics,
   summarizeVoiceIntegrationEvents,
   summarizeVoiceAssistantRuns,
+  summarizeVoiceAssistantHealth,
   startVoiceOpsTask,
   shapeTelephonyAssistantText,
   selectVoiceTraceEventsForPrune,
@@ -10516,6 +10619,7 @@ export {
   renderVoiceProviderHealthHTML,
   renderVoiceCallReviewMarkdown,
   renderVoiceCallReviewHTML,
+  renderVoiceAssistantHealthHTML,
   redactVoiceTraceText,
   redactVoiceTraceEvents,
   redactVoiceTraceEvent,
@@ -10618,6 +10722,9 @@ export {
   createVoiceCRMActivitySink,
   createVoiceAssistantMemoryRecord,
   createVoiceAssistantMemoryHandle,
+  createVoiceAssistantHealthRoutes,
+  createVoiceAssistantHealthJSONHandler,
+  createVoiceAssistantHealthHTMLHandler,
   createVoiceAssistant,
   createVoiceAgentTool,
   createVoiceAgentSquad,

package/package.json

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