@absolutejs/voice 0.0.22-beta.191 → 0.0.22-beta.193

package/dist/latencySlo.d.ts

@@ -0,0 +1,56 @@
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+export type VoiceLatencySLOStatus = 'empty' | 'fail' | 'pass' | 'warn';
+export type VoiceLatencySLOStage = 'assistant_text_to_tts_send' | 'barge_in_stop' | 'commit_to_assistant_text' | 'final_to_commit' | 'live_latency' | 'provider_llm' | 'provider_stt' | 'provider_tts' | 'speech_to_commit' | 'tts_send_duration' | 'tts_to_first_audio';
+export type VoiceLatencySLOBudget = {
+    failAfterMs: number;
+    warnAfterMs?: number;
+};
+export type VoiceLatencySLOMeasurement = {
+    at: number;
+    latencyMs: number;
+    label: string;
+    provider?: string;
+    sessionId: string;
+    stage: VoiceLatencySLOStage;
+    status: Exclude<VoiceLatencySLOStatus, 'empty'>;
+    turnId?: string;
+};
+export type VoiceLatencySLOStageSummary = {
+    averageMs?: number;
+    budget: VoiceLatencySLOBudget;
+    failed: number;
+    label: string;
+    maxMs?: number;
+    measurements: VoiceLatencySLOMeasurement[];
+    p50Ms?: number;
+    p95Ms?: number;
+    stage: VoiceLatencySLOStage;
+    status: VoiceLatencySLOStatus;
+    total: number;
+    warnings: number;
+};
+export type VoiceLatencySLOGateReport = {
+    checkedAt: number;
+    failed: number;
+    measurements: VoiceLatencySLOMeasurement[];
+    stages: VoiceLatencySLOStageSummary[];
+    status: VoiceLatencySLOStatus;
+    total: number;
+    warnings: number;
+};
+export type VoiceLatencySLOGateOptions = {
+    budgets?: Partial<Record<VoiceLatencySLOStage, VoiceLatencySLOBudget>>;
+    events?: StoredVoiceTraceEvent[];
+    failAfterMs?: number;
+    limit?: number;
+    store?: VoiceTraceEventStore;
+    warnAfterMs?: number;
+};
+export type VoiceLatencySLOGateError = Error & {
+    report: VoiceLatencySLOGateReport;
+};
+export declare const buildVoiceLatencySLOGate: (options: VoiceLatencySLOGateOptions) => Promise<VoiceLatencySLOGateReport>;
+export declare const assertVoiceLatencySLOGate: (options: VoiceLatencySLOGateOptions) => Promise<VoiceLatencySLOGateReport>;
+export declare const renderVoiceLatencySLOMarkdown: (report: VoiceLatencySLOGateReport, options?: {
+    title?: string;
+}) => string;

package/dist/operationsRecord.d.ts

@@ -1,6 +1,8 @@
 import { Elysia } from 'elysia';
 import { type StoredVoiceAuditEvent, type VoiceAuditEventStore } from './audit';
+import type { StoredVoiceIntegrationEvent, StoredVoiceOpsTask, VoiceIntegrationEventStore, VoiceOpsTaskStore } from './ops';
 import { type VoiceSessionReplay } from './sessionReplay';
+import type { StoredVoiceCallReviewArtifact, VoiceCallReviewStore } from './testing/review';
 import { type VoiceTraceTimelineEvent, type VoiceTraceTimelineProviderSummary } from './traceTimeline';
 import { type StoredVoiceTraceEvent, type VoiceTraceEvaluationOptions, type VoiceTraceEventStore, type VoiceTraceRedactionConfig, type VoiceTraceSummary } from './trace';
 export type VoiceOperationsRecordStatus = 'failed' | 'healthy' | 'warning';
@@ -38,16 +40,41 @@ export type VoiceOperationsRecordAuditSummary = {
     success: number;
     total: number;
 };
+export type VoiceOperationsRecordReviewSummary = {
+    failed: number;
+    reviews: StoredVoiceCallReviewArtifact[];
+    total: number;
+};
+export type VoiceOperationsRecordTaskSummary = {
+    done: number;
+    inProgress: number;
+    open: number;
+    overdue: number;
+    tasks: StoredVoiceOpsTask[];
+    total: number;
+};
+export type VoiceOperationsRecordIntegrationEventSummary = {
+    delivered: number;
+    events: StoredVoiceIntegrationEvent[];
+    failed: number;
+    pending: number;
+    sinkDeliveries: number;
+    skipped: number;
+    total: number;
+};
 export type VoiceOperationsRecord = {
     audit?: VoiceOperationsRecordAuditSummary;
     checkedAt: number;
     handoffs: VoiceOperationsRecordAgentHandoff[];
+    integrationEvents?: VoiceOperationsRecordIntegrationEventSummary;
     outcome: VoiceOperationsRecordOutcome;
     providers: VoiceTraceTimelineProviderSummary[];
     replay: VoiceSessionReplay;
+    reviews?: VoiceOperationsRecordReviewSummary;
     sessionId: string;
     status: VoiceOperationsRecordStatus;
     summary: VoiceTraceSummary;
+    tasks?: VoiceOperationsRecordTaskSummary;
     timeline: VoiceTraceTimelineEvent[];
     tools: VoiceOperationsRecordTool[];
     traceEvents: StoredVoiceTraceEvent[];
@@ -56,9 +83,12 @@ export type VoiceOperationsRecordOptions = {
     audit?: VoiceAuditEventStore;
     evaluation?: VoiceTraceEvaluationOptions;
     events?: StoredVoiceTraceEvent[];
+    integrationEvents?: VoiceIntegrationEventStore;
     redact?: VoiceTraceRedactionConfig;
+    reviews?: VoiceCallReviewStore;
     sessionId: string;
     store?: VoiceTraceEventStore;
+    tasks?: VoiceOpsTaskStore;
 };
 export type VoiceOperationsRecordRoutesOptions = Omit<VoiceOperationsRecordOptions, 'sessionId'> & {
     headers?: HeadersInit;

package/dist/productionReadiness.d.ts

@@ -12,6 +12,7 @@ import type { VoiceReconnectContractReport } from './reconnectContract';
 import type { VoiceAuditEventStore, VoiceAuditEventType, VoiceAuditOutcome } from './audit';
 import { type VoiceAuditSinkDeliveryStore } from './auditSinks';
 import type { VoiceProviderContractMatrixReport, VoiceProviderStackCapabilityGapReport } from './providerStackRecommendations';
+import type { VoiceCampaignReadinessProofReport } from './campaign';
 export type VoiceProductionReadinessStatus = 'fail' | 'pass' | 'warn';
 export type VoiceProductionReadinessAction = {
     description?: string;
@@ -81,6 +82,7 @@ export type VoiceProductionReadinessReport = {
         audit?: string;
         auditDeliveries?: string;
         bargeIn?: string;
+        campaignReadiness?: string;
         carriers?: string;
         deliveryRuntime?: string;
         handoffs?: string;
@@ -117,6 +119,12 @@ export type VoiceProductionReadinessReport = {
             total: number;
             warnings: number;
         };
+        campaignReadiness?: {
+            failed: number;
+            passed: number;
+            status: VoiceProductionReadinessStatus;
+            total: number;
+        };
         carriers?: {
             failing: number;
             providers: number;
@@ -294,6 +302,10 @@ export type VoiceProductionReadinessRoutesOptions = {
         query: Record<string, unknown>;
         request: Request;
     }) => Promise<readonly VoiceTelephonyCarrierMatrixInput[]> | readonly VoiceTelephonyCarrierMatrixInput[]);
+    campaignReadiness?: false | VoiceCampaignReadinessProofReport | ((input: {
+        query: Record<string, unknown>;
+        request: Request;
+    }) => Promise<VoiceCampaignReadinessProofReport> | VoiceCampaignReadinessProofReport);
     deliveryRuntime?: false | VoiceDeliveryRuntime | VoiceDeliveryRuntimeSummary | ((input: {
         query: Record<string, unknown>;
         request: Request;

package/dist/readinessProfiles.d.ts

@@ -4,6 +4,7 @@ export type VoiceReadinessProfileOptions = {
     audit?: VoiceProductionReadinessAuditOptions;
     auditDeliveries?: VoiceProductionReadinessAuditDeliveryOptions;
     bargeInReports?: VoiceProductionReadinessRoutesOptions['bargeInReports'];
+    campaignReadiness?: VoiceProductionReadinessRoutesOptions['campaignReadiness'];
     carriers?: VoiceProductionReadinessRoutesOptions['carriers'];
     deliveryRuntime?: VoiceProductionReadinessRoutesOptions['deliveryRuntime'];
     explain?: boolean;

package/dist/testing/index.js

@@ -6401,9 +6401,32 @@ var createVoiceSession = (options) => {
     });
   };
   const completeTurn = async (session, turn) => {
+    const liveOpsControl = await options.liveOps?.getControl(options.id);
+    if (liveOpsControl?.assistantPaused || liveOpsControl?.operatorTakeover) {
+      await appendTrace({
+        metadata: {
+          source: "voice-live-ops"
+        },
+        payload: {
+          action: "turn.skipped",
+          control: liveOpsControl,
+          reason: liveOpsControl.operatorTakeover ? "operator-takeover" : "assistant-paused",
+          status: "skipped"
+        },
+        session,
+        turnId: turn.id,
+        type: "operator.action"
+      });
+      return;
+    }
+    const injectedInstruction = liveOpsControl?.injectedInstruction?.trim();
     const committedOutput = await options.route.onTurn({
       api,
       context: options.context,
+      liveOps: liveOpsControl ? {
+        control: liveOpsControl,
+        injectedInstruction
+      } : undefined,
       session,
       turn
     });

package/dist/types.d.ts

@@ -3,6 +3,7 @@ import type { VoiceOpsDispositionTaskPolicies, VoiceOpsTaskAssignmentRule, Voice
 import type { VoiceIntegrationSink } from './opsSinks';
 import type { StoredVoiceCallReviewArtifact, VoiceCallReviewArtifact, VoiceCallReviewStore } from './testing/review';
 import type { VoiceTraceEventStore } from './trace';
+import type { VoiceLiveOpsControlState } from './liveOps';
 export type AudioFormat = {
     container: 'raw';
     encoding: 'alaw' | 'mulaw' | 'pcm_s16le';
@@ -484,6 +485,10 @@ export type VoiceLexiconResolver<TContext = unknown> = (input: {
 }) => Promise<VoiceLexiconEntry[] | void> | VoiceLexiconEntry[] | void;
 export type VoiceOnTurnObjectHandler<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = (input: {
     context: TContext;
+    liveOps?: {
+        control: VoiceLiveOpsControlState;
+        injectedInstruction?: string;
+    };
     session: TSession;
     turn: VoiceTurnRecord;
     api: VoiceSessionHandle<TContext, TSession, TResult>;
@@ -605,6 +610,9 @@ export type VoiceRuntimeOpsConfig<TContext = unknown, TSession extends VoiceSess
     tasks?: VoiceOpsTaskStore;
     webhook?: VoiceIntegrationWebhookConfig;
 };
+export type VoiceLiveOpsRuntimeConfig = {
+    getControl: (sessionId: string) => Promise<VoiceLiveOpsControlState | null | undefined> | VoiceLiveOpsControlState | null | undefined;
+};
 export type VoiceNormalizedRouteConfig<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = Omit<VoiceRouteConfig<TContext, TSession, TResult>, 'onTurn'> & {
     onTurn: VoiceOnTurnObjectHandler<TContext, TSession, TResult>;
 };
@@ -639,6 +647,7 @@ export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionR
     htmx?: boolean | VoiceHTMXConfig<TSession, NoInfer<TResult>>;
     handoff?: VoiceHandoffConfig<TContext, TSession, TResult>;
     ops?: VoiceRuntimeOpsConfig<TContext, TSession, TResult>;
+    liveOps?: VoiceLiveOpsRuntimeConfig;
     trace?: VoiceTraceEventStore;
 } & VoiceRouteConfig<TContext, TSession, TResult>;
 export type CreateVoiceSessionOptions<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
@@ -662,6 +671,7 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
     turnDetection: VoiceResolvedTurnDetectionConfig;
     audioConditioning?: VoiceResolvedAudioConditioningConfig;
     handoff?: VoiceHandoffConfig<TContext, TSession, TResult>;
+    liveOps?: VoiceLiveOpsRuntimeConfig;
     route: VoiceNormalizedRouteConfig<TContext, TSession, TResult>;
     logger?: VoiceLogger;
 };

package/dist/vue/useVoiceLiveOps.d.ts

@@ -4,6 +4,6 @@ export declare function useVoiceLiveOps(options?: VoiceLiveOpsClientOptions): {
     isRunning: import("vue").Ref<boolean, boolean>;
     lastResult: import("vue").ShallowRef<VoiceLiveOpsActionResult | undefined, VoiceLiveOpsActionResult | undefined>;
     run: (input: import("..").VoiceLiveOpsActionInput) => Promise<VoiceLiveOpsActionResult | undefined>;
-    runningAction: import("vue").Ref<"escalate" | "assign" | "create-task" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined, "escalate" | "assign" | "create-task" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined>;
+    runningAction: import("vue").Ref<"assign" | "create-task" | "escalate" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined, "assign" | "create-task" | "escalate" | "force-handoff" | "inject-instruction" | "operator-takeover" | "pause-assistant" | "resume-assistant" | "tag" | undefined>;
     updatedAt: import("vue").Ref<number | undefined, number | undefined>;
 };

package/package.json

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