@absolutejs/voice 0.0.22-beta.293 → 0.0.22-beta.295

package/dist/operationsRecord.d.ts

@@ -45,10 +45,12 @@ export type VoiceOperationsRecordProviderDecision = {
     elapsedMs?: number;
     error?: string;
     fallbackProvider?: string;
+    kind?: string;
     provider?: string;
     reason?: string;
     selectedProvider?: string;
     status?: string;
+    surface?: string;
     type: StoredVoiceTraceEvent['type'];
     turnId?: string;
 };

package/dist/providerDecisionTraces.d.ts

@@ -0,0 +1,122 @@
+import { Elysia } from 'elysia';
+import { type VoiceRoutingEventKind } from './resilienceRoutes';
+import type { StoredVoiceTraceEvent, VoiceTraceEvent, VoiceTraceEventStore } from './trace';
+export type VoiceProviderDecisionStatus = 'error' | 'fallback' | 'selected' | 'skipped' | 'success';
+export type VoiceProviderDecisionTrace = {
+    at: number;
+    elapsedMs?: number;
+    error?: string;
+    fallbackProvider?: string;
+    kind?: VoiceRoutingEventKind;
+    latencyBudgetMs?: number;
+    provider: string;
+    reason: string;
+    scenarioId?: string;
+    selectedProvider?: string;
+    sessionId: string;
+    status: VoiceProviderDecisionStatus;
+    surface: string;
+    turnId?: string;
+};
+export type VoiceProviderDecisionTraceInput = Omit<VoiceProviderDecisionTrace, 'at' | 'reason' | 'sessionId' | 'surface'> & {
+    at?: number;
+    reason?: string;
+    sessionId?: string;
+    surface?: string;
+};
+export type VoiceProviderDecisionTraceIssue = {
+    code: string;
+    message: string;
+    status: 'fail' | 'warn';
+    surface?: string;
+};
+export type VoiceProviderDecisionSurfaceReport = {
+    decisions: number;
+    errors: number;
+    fallbacks: number;
+    issues: VoiceProviderDecisionTraceIssue[];
+    latestAt?: number;
+    providers: string[];
+    reasons: string[];
+    selected: number;
+    status: 'fail' | 'pass' | 'warn';
+    surface: string;
+};
+export type VoiceProviderDecisionTraceReport = {
+    checkedAt: number;
+    decisions: VoiceProviderDecisionTrace[];
+    issues: VoiceProviderDecisionTraceIssue[];
+    status: 'fail' | 'pass' | 'warn';
+    summary: {
+        decisions: number;
+        errors: number;
+        fallbacks: number;
+        providers: number;
+        selected: number;
+        surfaces: number;
+    };
+    surfaces: VoiceProviderDecisionSurfaceReport[];
+};
+export type VoiceProviderDecisionTraceReportOptions = {
+    events?: StoredVoiceTraceEvent[] | VoiceProviderDecisionTrace[];
+    maxAgeMs?: number;
+    minDecisions?: number;
+    now?: number;
+    requiredSurfaces?: readonly string[];
+    sessionId?: string;
+    store?: VoiceTraceEventStore;
+};
+export type VoiceProviderDecisionTraceRoutesOptions = VoiceProviderDecisionTraceReportOptions & {
+    headers?: HeadersInit;
+    htmlPath?: false | string;
+    markdownPath?: false | string;
+    name?: string;
+    path?: string;
+    render?: (report: VoiceProviderDecisionTraceReport) => string | Promise<string>;
+    title?: string;
+};
+export declare const createVoiceProviderDecisionTraceEvent: (input: VoiceProviderDecisionTraceInput) => VoiceTraceEvent;
+export declare const listVoiceProviderDecisionTraces: (events: StoredVoiceTraceEvent[] | VoiceProviderDecisionTrace[]) => VoiceProviderDecisionTrace[];
+export declare const buildVoiceProviderDecisionTraceReport: (options: VoiceProviderDecisionTraceReportOptions) => Promise<VoiceProviderDecisionTraceReport>;
+export declare const renderVoiceProviderDecisionTraceMarkdown: (report: VoiceProviderDecisionTraceReport) => string;
+export declare const renderVoiceProviderDecisionTraceHTML: (report: VoiceProviderDecisionTraceReport, title?: string) => string;
+export declare const createVoiceProviderDecisionTraceRoutes: (options: VoiceProviderDecisionTraceRoutesOptions) => 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: Response;
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/trace.d.ts

@@ -1,5 +1,5 @@
 import type { S3Client, S3Options } from 'bun';
-export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.context' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.live_latency' | 'client.reconnect' | 'operator.action' | 'session.error' | 'turn.assistant' | 'turn.committed' | 'turn.cost' | 'turn_latency.stage' | 'turn.transcript' | 'workflow.contract';
+export type VoiceTraceEventType = 'assistant.guardrail' | 'assistant.memory' | 'assistant.run' | 'agent.context' | 'agent.handoff' | 'agent.model' | 'agent.result' | 'agent.tool' | 'call.handoff' | 'call.lifecycle' | 'client.barge_in' | 'client.live_latency' | 'client.reconnect' | 'operator.action' | 'provider.decision' | 'session.error' | 'turn.assistant' | 'turn.committed' | 'turn.cost' | 'turn_latency.stage' | 'turn.transcript' | 'workflow.contract';
 export type VoiceTraceEvent<TPayload extends Record<string, unknown> = Record<string, unknown>> = {
     at: number;
     id?: string;

package/package.json

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