@absolutejs/voice 0.0.22-beta.40 → 0.0.22-beta.41

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { createStoredVoiceCallReviewArtifact, createStoredVoiceExternalObjectMap
 export { createVoiceAssistantMemoryHandle, createVoiceAssistantMemoryRecord, createVoiceMemoryAssistantMemoryStore, resolveVoiceAssistantMemoryNamespace } from './assistantMemory';
 export { createAnthropicVoiceAssistantModel, createGeminiVoiceAssistantModel, createJSONVoiceAssistantModel, createOpenAIVoiceAssistantModel, createVoiceProviderRouter } from './modelAdapters';
 export { createVoiceProviderHealthHTMLHandler, createVoiceProviderHealthJSONHandler, createVoiceProviderHealthRoutes, renderVoiceProviderHealthHTML, summarizeVoiceProviderHealth } from './providerHealth';
+export { buildVoiceOpsConsoleReport, createVoiceOpsConsoleRoutes, renderVoiceOpsConsoleHTML } from './opsConsoleRoutes';
 export { createVoiceQualityRoutes, evaluateVoiceQuality, renderVoiceQualityHTML } from './qualityRoutes';
 export { createVoiceResilienceRoutes, listVoiceRoutingEvents, renderVoiceResilienceHTML } from './resilienceRoutes';
 export { createVoiceSTTProviderRouter, createVoiceTTSProviderRouter } from './providerAdapters';
@@ -41,6 +42,7 @@ export type { VoiceDiagnosticsRoutesOptions } from './diagnosticsRoutes';
 export type { VoiceSessionListHTMLHandlerOptions, VoiceSessionListItem, VoiceSessionListOptions, VoiceSessionListRoutesOptions, VoiceSessionListStatus, VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn } from './sessionReplay';
 export type { AnthropicVoiceAssistantModelOptions, GeminiVoiceAssistantModelOptions, OpenAIVoiceAssistantModelOptions, VoiceProviderRouterEvent, VoiceProviderRouterFallbackMode, VoiceProviderRouterHealthOptions, VoiceProviderRouterOptions, VoiceProviderRouterPolicy, VoiceProviderRouterProviderHealth, VoiceProviderRouterProviderProfile, VoiceJSONAssistantModelHandler, VoiceJSONAssistantModelOptions } from './modelAdapters';
 export type { VoiceProviderHealthStatus, VoiceProviderHealthSummary, VoiceProviderHealthSummaryOptions } from './providerHealth';
+export type { VoiceOpsConsoleLink, VoiceOpsConsoleReport, VoiceOpsConsoleRoutesOptions } from './opsConsoleRoutes';
 export type { VoiceQualityLink, VoiceQualityMetric, VoiceQualityReport, VoiceQualityRoutesOptions, VoiceQualityStatus, VoiceQualityThresholds } from './qualityRoutes';
 export type { VoiceResilienceIOSimulator, VoiceResilienceLink, VoiceResiliencePageData, VoiceResilienceRoutesOptions, VoiceResilienceSimulationProvider, VoiceRoutingEvent, VoiceRoutingEventKind } from './resilienceRoutes';
 export type { VoiceIOProviderRouterEvent, VoiceSTTProviderRouterOptions, VoiceTTSProviderRouterOptions } from './providerAdapters';

package/dist/index.js

@@ -8993,8 +8993,8 @@ var createGeminiVoiceAssistantModel = (options) => {
     }
   };
 };
-// src/qualityRoutes.ts
-import { Elysia as Elysia7 } from "elysia";
+// src/opsConsoleRoutes.ts
+import { Elysia as Elysia9 } from "elysia";
 
 // src/handoffHealth.ts
 import { Elysia as Elysia6 } from "elysia";
@@ -9190,6 +9190,7 @@ var createVoiceHandoffHealthRoutes = (options = {}) => {
 };
 
 // src/qualityRoutes.ts
+import { Elysia as Elysia7 } from "elysia";
 var DEFAULT_THRESHOLDS = {
   maxDuplicateTurnRate: 0,
   maxEmptyTurnRate: 0.02,
@@ -9338,6 +9339,7 @@ var createVoiceQualityRoutes = (options) => {
   });
   return routes;
 };
+
 // src/resilienceRoutes.ts
 import { Elysia as Elysia8 } from "elysia";
 var escapeHtml10 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
@@ -9651,6 +9653,121 @@ var createVoiceResilienceRoutes = (options) => {
   registerSimulationRoutes(routes, options.ttsSimulation, "/api/tts-simulate");
   return routes;
 };
+
+// src/opsConsoleRoutes.ts
+var DEFAULT_LINKS = [
+  {
+    description: "Quality gates for CI, deploy checks, and production readiness.",
+    href: "/quality",
+    label: "Quality",
+    statusHref: "/quality/status"
+  },
+  {
+    description: "Provider health, fallback paths, and failure simulation.",
+    href: "/resilience",
+    label: "Resilience"
+  },
+  {
+    description: "Redacted trace exports for debugging and support handoffs.",
+    href: "/diagnostics",
+    label: "Diagnostics"
+  },
+  {
+    description: "Recent sessions with replay links.",
+    href: "/sessions",
+    label: "Sessions"
+  },
+  {
+    description: "Transfer and webhook delivery health.",
+    href: "/handoffs",
+    label: "Handoffs"
+  }
+];
+var escapeHtml11 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var countProviderStatuses = (providers) => {
+  const degradedStatuses = new Set(["degraded", "rate-limited", "suppressed"]);
+  const healthy = providers.filter((provider) => provider.status === "healthy").length;
+  const degraded = providers.filter((provider) => degradedStatuses.has(provider.status)).length;
+  return {
+    degraded,
+    healthy,
+    total: providers.length
+  };
+};
+var buildVoiceOpsConsoleReport = async (options) => {
+  const events = await options.store.list();
+  const providers = [
+    ...await summarizeVoiceProviderHealth({
+      events,
+      providers: options.llmProviders
+    }),
+    ...await summarizeVoiceProviderHealth({
+      events,
+      providers: options.sttProviders
+    }),
+    ...await summarizeVoiceProviderHealth({
+      events,
+      providers: options.ttsProviders
+    })
+  ];
+  const handoffs = await summarizeVoiceHandoffHealth({ events });
+  const sessions = await summarizeVoiceSessions({
+    events,
+    limit: 8,
+    status: "all"
+  });
+  const quality = await evaluateVoiceQuality({ events });
+  const routingEvents = listVoiceRoutingEvents(events).slice(0, 10);
+  const trace = summarizeVoiceTrace(events);
+  return {
+    checkedAt: Date.now(),
+    eventCount: events.length,
+    handoffs: {
+      failed: handoffs.failed,
+      total: handoffs.total
+    },
+    links: options.links ?? DEFAULT_LINKS,
+    providers: countProviderStatuses(providers),
+    quality,
+    recentRoutingEvents: routingEvents,
+    recentSessions: sessions,
+    sessions: {
+      failed: sessions.filter((session) => session.status === "failed").length,
+      healthy: sessions.filter((session) => session.status === "healthy").length,
+      total: sessions.length
+    },
+    trace
+  };
+};
+var renderMetricCard = (input) => `<article class="metric"><span>${escapeHtml11(input.label)}</span><strong>${escapeHtml11(String(input.value))}</strong>${input.status ? `<p class="${escapeHtml11(input.status)}">${escapeHtml11(input.status)}</p>` : ""}${input.href ? `<a href="${escapeHtml11(input.href)}">Open</a>` : ""}</article>`;
+var renderVoiceOpsConsoleHTML = (report, options = {}) => {
+  const links = report.links.map((link) => `<article class="surface">
+<div><h2>${escapeHtml11(link.label)}</h2>${link.description ? `<p>${escapeHtml11(link.description)}</p>` : ""}</div>
+<p><a href="${escapeHtml11(link.href)}">Open ${escapeHtml11(link.label)}</a>${link.statusHref ? ` \xB7 <a href="${escapeHtml11(link.statusHref)}">Status</a>` : ""}</p>
+</article>`).join("");
+  const sessions = report.recentSessions.length ? report.recentSessions.map((session) => `<tr><td>${escapeHtml11(session.sessionId)}</td><td>${escapeHtml11(session.status)}</td><td>${session.turnCount}</td><td>${session.errorCount}</td><td>${session.replayHref ? `<a href="${escapeHtml11(session.replayHref)}">Replay</a>` : ""}</td></tr>`).join("") : '<tr><td colspan="5">No sessions yet.</td></tr>';
+  const routing = report.recentRoutingEvents.length ? report.recentRoutingEvents.map((event) => `<tr><td>${escapeHtml11(event.kind)}</td><td>${escapeHtml11(event.provider ?? "unknown")}</td><td>${escapeHtml11(event.status ?? "unknown")}</td><td>${event.elapsedMs ?? 0}ms</td><td>${escapeHtml11(event.sessionId)}</td></tr>`).join("") : '<tr><td colspan="5">No provider routing events yet.</td></tr>';
+  const title = options.title ?? "AbsoluteJS Voice Ops Console";
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><title>${escapeHtml11(title)}</title><style>body{font-family:ui-sans-serif,system-ui,sans-serif;background:#101316;color:#f6f2e8;margin:0}main{max-width:1180px;margin:auto;padding:32px}a{color:#fbbf24}header{display:flex;justify-content:space-between;gap:24px;align-items:flex-start;margin-bottom:24px}.eyebrow{color:#fbbf24;font-weight:800;letter-spacing:.08em;text-transform:uppercase}h1{font-size:clamp(2.2rem,5vw,4.5rem);line-height:.95;margin:.2rem 0 1rem}.muted{color:#a8b0b8}.grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));margin:20px 0}.metric,.surface{background:#181d22;border:1px solid #2a323a;border-radius:20px;padding:18px}.metric strong{display:block;font-size:2.2rem;margin:.25rem 0}.pass,.healthy{color:#86efac}.fail,.failed,.degraded{color:#fca5a5}.surfaces{display:grid;gap:16px;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));margin:24px 0}table{width:100%;border-collapse:collapse;background:#181d22;border-radius:16px;overflow:hidden;margin:12px 0 28px}td,th{border-bottom:1px solid #2a323a;padding:12px;text-align:left}section{margin-top:30px}@media(max-width:700px){main{padding:20px}header{display:block}}</style></head><body><main><header><div><p class="eyebrow">Self-hosted voice operations</p><h1>${escapeHtml11(title)}</h1><p class="muted">One deployable control plane for quality gates, failover, traces, sessions, handoffs, and provider health.</p></div><p class="muted">Checked ${escapeHtml11(new Date(report.checkedAt).toLocaleString())}</p></header><div class="grid">${renderMetricCard({ label: "Quality", value: report.quality.status, status: report.quality.status, href: "/quality" })}${renderMetricCard({ label: "Events", value: report.eventCount, href: "/diagnostics" })}${renderMetricCard({ label: "Sessions", value: report.sessions.total, status: report.sessions.failed > 0 ? "failed" : "healthy", href: "/sessions" })}${renderMetricCard({ label: "Handoffs failed", value: report.handoffs.failed, status: report.handoffs.failed > 0 ? "failed" : "healthy", href: "/handoffs" })}${renderMetricCard({ label: "Providers degraded", value: report.providers.degraded, status: report.providers.degraded > 0 ? "degraded" : "healthy", href: "/resilience" })}</div><section><h2>Operational Surfaces</h2><div class="surfaces">${links}</div></section><section><h2>Recent Sessions</h2><table><thead><tr><th>Session</th><th>Status</th><th>Turns</th><th>Errors</th><th>Replay</th></tr></thead><tbody>${sessions}</tbody></table></section><section><h2>Recent Provider Routing</h2><table><thead><tr><th>Kind</th><th>Provider</th><th>Status</th><th>Elapsed</th><th>Session</th></tr></thead><tbody>${routing}</tbody></table></section></main></body></html>`;
+};
+var createVoiceOpsConsoleRoutes = (options) => {
+  const path = options.path ?? "/ops-console";
+  const routes = new Elysia9({
+    name: options.name ?? "absolutejs-voice-ops-console"
+  });
+  const getReport = () => buildVoiceOpsConsoleReport(options);
+  routes.get(path, async () => {
+    const report = await getReport();
+    return new Response(renderVoiceOpsConsoleHTML(report, { title: options.title }), {
+      headers: {
+        "Content-Type": "text/html; charset=utf-8",
+        ...options.headers
+      }
+    });
+  });
+  routes.get(`${path}/json`, async () => getReport());
+  return routes;
+};
 // src/providerAdapters.ts
 class VoiceIOProviderTimeoutError extends Error {
   provider;
@@ -10495,7 +10612,7 @@ var createVoiceMemoryStore = () => {
   return { get, getOrCreate, list, remove, set };
 };
 // src/opsWebhook.ts
-import { Elysia as Elysia9 } from "elysia";
+import { Elysia as Elysia10 } from "elysia";
 var toHex5 = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
 var signVoiceOpsWebhookBody = async (input) => {
   const encoder = new TextEncoder;
@@ -10625,7 +10742,7 @@ var verifyVoiceOpsWebhookSignature = async (input) => {
 };
 var createVoiceOpsWebhookReceiverRoutes = (options = {}) => {
   const path = options.path ?? "/api/voice-ops/webhook";
-  return new Elysia9().post(path, async ({ body, request, set }) => {
+  return new Elysia10().post(path, async ({ body, request, set }) => {
     const bodyText = typeof body === "string" ? body : JSON.stringify(body);
     if (options.signingSecret) {
       const verification = await verifyVoiceOpsWebhookSignature({
@@ -12807,6 +12924,7 @@ export {
   renderVoiceResilienceHTML,
   renderVoiceQualityHTML,
   renderVoiceProviderHealthHTML,
+  renderVoiceOpsConsoleHTML,
   renderVoiceHandoffHealthHTML,
   renderVoiceCallReviewMarkdown,
   renderVoiceCallReviewHTML,
@@ -12898,6 +13016,7 @@ export {
   createVoiceOpsTaskProcessorWorkerLoop,
   createVoiceOpsTaskProcessorWorker,
   createVoiceOpsRuntime,
+  createVoiceOpsConsoleRoutes,
   createVoiceMemoryTraceSinkDeliveryStore,
   createVoiceMemoryTraceEventStore,
   createVoiceMemoryStore,
@@ -12968,6 +13087,7 @@ export {
   buildVoiceTraceReplay,
   buildVoiceOpsTaskFromSLABreach,
   buildVoiceOpsTaskFromReview,
+  buildVoiceOpsConsoleReport,
   buildVoiceDiagnosticsMarkdown,
   assignVoiceOpsTask,
   applyVoiceOpsTaskPolicy,

package/dist/opsConsoleRoutes.d.ts

@@ -0,0 +1,77 @@
+import { Elysia } from 'elysia';
+import { type VoiceQualityReport } from './qualityRoutes';
+import { type VoiceRoutingEvent } from './resilienceRoutes';
+import { type VoiceSessionListItem } from './sessionReplay';
+import { summarizeVoiceTrace, type VoiceTraceEventStore } from './trace';
+export type VoiceOpsConsoleLink = {
+    description?: string;
+    href: string;
+    label: string;
+    statusHref?: string;
+};
+export type VoiceOpsConsoleReport = {
+    checkedAt: number;
+    eventCount: number;
+    handoffs: {
+        failed: number;
+        total: number;
+    };
+    links: VoiceOpsConsoleLink[];
+    providers: {
+        degraded: number;
+        healthy: number;
+        total: number;
+    };
+    quality: VoiceQualityReport;
+    recentRoutingEvents: VoiceRoutingEvent[];
+    recentSessions: VoiceSessionListItem[];
+    sessions: {
+        failed: number;
+        healthy: number;
+        total: number;
+    };
+    trace: ReturnType<typeof summarizeVoiceTrace>;
+};
+export type VoiceOpsConsoleRoutesOptions = {
+    headers?: HeadersInit;
+    links?: VoiceOpsConsoleLink[];
+    llmProviders?: readonly string[];
+    name?: string;
+    path?: string;
+    store: VoiceTraceEventStore;
+    sttProviders?: readonly string[];
+    title?: string;
+    ttsProviders?: readonly string[];
+};
+export declare const buildVoiceOpsConsoleReport: (options: VoiceOpsConsoleRoutesOptions) => Promise<VoiceOpsConsoleReport>;
+export declare const renderVoiceOpsConsoleHTML: (report: VoiceOpsConsoleReport, options?: {
+    title?: string;
+}) => string;
+export declare const createVoiceOpsConsoleRoutes: (options: VoiceOpsConsoleRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/package.json

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