@absolutejs/voice 0.0.22-beta.22 → 0.0.22-beta.23

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { voice } from './plugin';
 export { createVoiceAssistant, createVoiceExperiment, summarizeVoiceAssistantRuns } from './assistant';
 export { createVoiceAssistantHealthHTMLHandler, createVoiceAssistantHealthJSONHandler, createVoiceAssistantHealthRoutes, renderVoiceAssistantHealthHTML, summarizeVoiceAssistantHealth } from './assistantHealth';
-export { createVoiceSessionReplayHTMLHandler, createVoiceSessionReplayJSONHandler, createVoiceSessionReplayRoutes, summarizeVoiceSessionReplay } from './sessionReplay';
+export { createVoiceSessionListRoutes, createVoiceSessionReplayHTMLHandler, createVoiceSessionReplayJSONHandler, createVoiceSessionReplayRoutes, createVoiceSessionsHTMLHandler, createVoiceSessionsJSONHandler, renderVoiceSessionsHTML, summarizeVoiceSessions, summarizeVoiceSessionReplay } from './sessionReplay';
 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';
@@ -30,7 +30,7 @@ export { createVoiceCallReviewFromLiveTelephonyReport, createVoiceCallReviewReco
 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 { VoiceSessionReplay, VoiceSessionReplayHTMLHandlerOptions, VoiceSessionReplayOptions, VoiceSessionReplayRoutesOptions, VoiceSessionReplayTurn } from './sessionReplay';
+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 { VoiceAgent, VoiceAgentMessage, VoiceAgentMessageRole, VoiceAgentModel, VoiceAgentModelInput, VoiceAgentModelOutput, VoiceAgentOptions, VoiceAgentRunResult, VoiceAgentSquadOptions, VoiceAgentTool, VoiceAgentToolCall, VoiceAgentToolResult } from './agent';

package/dist/index.js

@@ -7064,6 +7064,10 @@ var buildVoiceTraceReplay = (events, options = {}) => ({
 
 // src/sessionReplay.ts
 var getString3 = (value) => typeof value === "string" ? value : undefined;
+var escapeHtml6 = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+var increment2 = (record, key) => {
+  record[key] = (record[key] ?? 0) + 1;
+};
 var buildReplayTurns = (events) => {
   const turns = new Map;
   const getTurn = (turnId) => {
@@ -7144,6 +7148,131 @@ var summarizeVoiceSessionReplay = async (options) => {
     turns: buildReplayTurns(events)
   };
 };
+var summarizeVoiceSessions = async (options = {}) => {
+  const events = options.events ?? await options.store?.list() ?? [];
+  const grouped = new Map;
+  for (const event of events) {
+    grouped.set(event.sessionId, [...grouped.get(event.sessionId) ?? [], event]);
+  }
+  const sessions = [...grouped.entries()].map(([sessionId, sessionEvents]) => {
+    const sorted = filterVoiceTraceEvents(sessionEvents);
+    const summary = buildVoiceTraceReplay(sorted, {
+      evaluation: {
+        requireAssistantReply: false,
+        requireCompletedCall: false,
+        requireTranscript: false,
+        requireTurn: false
+      }
+    }).summary;
+    const providerErrors = {};
+    const providers = new Set;
+    let latestOutcome;
+    for (const event of sorted) {
+      const provider = getString3(event.payload.provider);
+      if (provider) {
+        providers.add(provider);
+      }
+      if (event.type === "session.error" && (event.payload.providerStatus === "error" || typeof event.payload.error === "string")) {
+        increment2(providerErrors, provider ?? "unknown");
+      }
+      const outcome = getString3(event.payload.outcome);
+      if (outcome) {
+        latestOutcome = outcome;
+      }
+    }
+    const item = {
+      endedAt: summary.endedAt,
+      errorCount: summary.errorCount,
+      eventCount: summary.eventCount,
+      latestOutcome,
+      providerErrors,
+      providers: [...providers].sort(),
+      sessionId,
+      startedAt: summary.startedAt,
+      status: summary.failed ? "failed" : "healthy",
+      transcriptCount: summary.transcriptCount,
+      turnCount: summary.turnCount
+    };
+    const replayHref = options.replayHref === false ? "" : typeof options.replayHref === "function" ? options.replayHref(item) : `${options.replayHref ?? "/api/voice-sessions"}/${encodeURIComponent(sessionId)}/replay/htmx`;
+    return {
+      ...item,
+      replayHref
+    };
+  });
+  const search = options.q?.trim().toLowerCase();
+  return sessions.filter((session) => {
+    if (options.status && options.status !== "all" && session.status !== options.status) {
+      return false;
+    }
+    if (options.provider && !session.providers.includes(options.provider)) {
+      return false;
+    }
+    if (!search) {
+      return true;
+    }
+    return [
+      session.sessionId,
+      session.latestOutcome,
+      session.status,
+      ...session.providers
+    ].some((value) => value?.toLowerCase().includes(search));
+  }).sort((left, right) => (right.endedAt ?? right.startedAt ?? 0) - (left.endedAt ?? left.startedAt ?? 0)).slice(0, options.limit ?? 50);
+};
+var renderVoiceSessionsHTML = (sessions) => sessions.length === 0 ? '<p class="voice-sessions-empty">No voice sessions found.</p>' : [
+  '<div class="voice-sessions-list">',
+  ...sessions.map((session) => [
+    `<article class="voice-session-card ${escapeHtml6(session.status)}">`,
+    '<div class="voice-session-card-header">',
+    `<strong>${escapeHtml6(session.sessionId)}</strong>`,
+    `<span>${escapeHtml6(session.status)}</span>`,
+    "</div>",
+    "<dl>",
+    `<div><dt>Events</dt><dd>${String(session.eventCount)}</dd></div>`,
+    `<div><dt>Turns</dt><dd>${String(session.turnCount)}</dd></div>`,
+    `<div><dt>Transcripts</dt><dd>${String(session.transcriptCount)}</dd></div>`,
+    `<div><dt>Errors</dt><dd>${String(session.errorCount)}</dd></div>`,
+    "</dl>",
+    session.latestOutcome ? `<p>Outcome: ${escapeHtml6(session.latestOutcome)}</p>` : "",
+    session.providers.length ? `<p>Providers: ${session.providers.map(escapeHtml6).join(", ")}</p>` : "",
+    session.replayHref ? `<p><a href="${escapeHtml6(session.replayHref)}">Open replay</a></p>` : "",
+    "</article>"
+  ].join("")),
+  "</div>"
+].join("");
+var createVoiceSessionsJSONHandler = (options = {}) => async ({ query }) => summarizeVoiceSessions({
+  ...options,
+  limit: typeof query?.limit === "string" ? Number(query.limit) : options.limit,
+  provider: query?.provider ?? options.provider,
+  q: query?.q ?? options.q,
+  status: query?.status === "failed" || query?.status === "healthy" || query?.status === "all" ? query.status : options.status
+});
+var createVoiceSessionsHTMLHandler = (options = {}) => async ({ query }) => {
+  const sessions = await summarizeVoiceSessions({
+    ...options,
+    limit: typeof query?.limit === "string" ? Number(query.limit) : options.limit,
+    provider: query?.provider ?? options.provider,
+    q: query?.q ?? options.q,
+    status: query?.status === "failed" || query?.status === "healthy" || query?.status === "all" ? query.status : options.status
+  });
+  const body = await (options.render?.(sessions) ?? renderVoiceSessionsHTML(sessions));
+  return new Response(body, {
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      ...options.headers
+    }
+  });
+};
+var createVoiceSessionListRoutes = (options = {}) => {
+  const path = options.path ?? "/api/voice-sessions";
+  const htmlPath = options.htmlPath === undefined ? `${path}/htmx` : options.htmlPath;
+  const routes = new Elysia4({
+    name: options.name ?? "absolutejs-voice-session-list"
+  }).get(path, createVoiceSessionsJSONHandler(options));
+  if (htmlPath) {
+    routes.get(htmlPath, createVoiceSessionsHTMLHandler(options));
+  }
+  return routes;
+};
 var createVoiceSessionReplayJSONHandler = (options) => async ({ params }) => summarizeVoiceSessionReplay({
   ...options,
   sessionId: params.sessionId ?? ""
@@ -10710,6 +10839,7 @@ export {
   transcodePCMToTwilioOutboundPayload,
   summarizeVoiceTraceSinkDeliveries,
   summarizeVoiceTrace,
+  summarizeVoiceSessions,
   summarizeVoiceSessionReplay,
   summarizeVoiceProviderHealth,
   summarizeVoiceOpsTasks,
@@ -10736,6 +10866,7 @@ export {
   reopenVoiceOpsTask,
   renderVoiceTraceMarkdown,
   renderVoiceTraceHTML,
+  renderVoiceSessionsHTML,
   renderVoiceProviderHealthHTML,
   renderVoiceCallReviewMarkdown,
   renderVoiceCallReviewHTML,
@@ -10777,10 +10908,13 @@ export {
   createVoiceTaskUpdatedEvent,
   createVoiceTaskSLABreachedEvent,
   createVoiceTaskCreatedEvent,
+  createVoiceSessionsJSONHandler,
+  createVoiceSessionsHTMLHandler,
   createVoiceSessionReplayRoutes,
   createVoiceSessionReplayJSONHandler,
   createVoiceSessionReplayHTMLHandler,
   createVoiceSessionRecord,
+  createVoiceSessionListRoutes,
   createVoiceSession,
   createVoiceSTTRoutingCorrectionHandler,
   createVoiceSQLiteTraceSinkDeliveryStore,

package/dist/sessionReplay.d.ts

@@ -28,6 +28,39 @@ export type VoiceSessionReplay = {
     }>;
     turns: VoiceSessionReplayTurn[];
 };
+export type VoiceSessionListStatus = 'failed' | 'healthy';
+export type VoiceSessionListItem = {
+    endedAt?: number;
+    errorCount: number;
+    eventCount: number;
+    latestOutcome?: string;
+    providerErrors: Record<string, number>;
+    providers: string[];
+    replayHref: string;
+    sessionId: string;
+    startedAt?: number;
+    status: VoiceSessionListStatus;
+    transcriptCount: number;
+    turnCount: number;
+};
+export type VoiceSessionListOptions = {
+    events?: StoredVoiceTraceEvent[];
+    limit?: number;
+    provider?: string;
+    q?: string;
+    replayHref?: false | string | ((session: Omit<VoiceSessionListItem, 'replayHref'>) => string);
+    status?: VoiceSessionListStatus | 'all';
+    store?: VoiceTraceEventStore;
+};
+export type VoiceSessionListHTMLHandlerOptions = VoiceSessionListOptions & {
+    headers?: HeadersInit;
+    render?: (sessions: VoiceSessionListItem[]) => string | Promise<string>;
+};
+export type VoiceSessionListRoutesOptions = VoiceSessionListHTMLHandlerOptions & {
+    htmlPath?: false | string;
+    name?: string;
+    path?: string;
+};
 export type VoiceSessionReplayOptions = {
     evaluation?: VoiceTraceEvaluationOptions;
     events?: StoredVoiceTraceEvent[];
@@ -46,6 +79,54 @@ export type VoiceSessionReplayRoutesOptions = VoiceSessionReplayHTMLHandlerOptio
     path?: string;
 };
 export declare const summarizeVoiceSessionReplay: (options: VoiceSessionReplayOptions) => Promise<VoiceSessionReplay>;
+export declare const summarizeVoiceSessions: (options?: VoiceSessionListOptions) => Promise<VoiceSessionListItem[]>;
+export declare const renderVoiceSessionsHTML: (sessions: VoiceSessionListItem[]) => string;
+export declare const createVoiceSessionsJSONHandler: (options?: VoiceSessionListOptions) => ({ query }: {
+    query?: Record<string, string | undefined>;
+}) => Promise<VoiceSessionListItem[]>;
+export declare const createVoiceSessionsHTMLHandler: (options?: VoiceSessionListHTMLHandlerOptions) => ({ query }: {
+    query?: Record<string, string | undefined>;
+}) => Promise<Response>;
+export declare const createVoiceSessionListRoutes: (options?: VoiceSessionListRoutesOptions) => 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: VoiceSessionListItem[];
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
 export declare const createVoiceSessionReplayJSONHandler: (options: Omit<VoiceSessionReplayOptions, "sessionId">) => ({ params }: {
     params: Record<string, string | undefined>;
 }) => Promise<VoiceSessionReplay>;

package/package.json

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