@absolutejs/voice 0.0.22-beta.189 → 0.0.22-beta.190

package/dist/liveOps.d.ts

@@ -0,0 +1,122 @@
+import { Elysia } from 'elysia';
+import { type VoiceAuditEventStore } from './audit';
+import { type VoiceTraceEventStore } from './trace';
+export declare const VOICE_LIVE_OPS_ACTIONS: readonly ["assign", "create-task", "escalate", "force-handoff", "inject-instruction", "operator-takeover", "pause-assistant", "resume-assistant", "tag"];
+export type VoiceLiveOpsAction = (typeof VOICE_LIVE_OPS_ACTIONS)[number];
+export type VoiceLiveOpsControlStatus = 'assistant-paused' | 'assistant-resumed' | 'handoff-forced' | 'instruction-injected' | 'operator-takeover' | 'recorded';
+export type VoiceLiveOpsControlState = {
+    assistantPaused: boolean;
+    handoffTarget?: string;
+    injectedInstruction?: string;
+    lastAction: VoiceLiveOpsAction;
+    lastUpdatedAt: number;
+    operator?: string;
+    operatorTakeover: boolean;
+    status: VoiceLiveOpsControlStatus;
+    tag?: string;
+};
+export type VoiceLiveOpsActionInput = {
+    action: VoiceLiveOpsAction;
+    assignee?: string;
+    detail?: string;
+    sessionId: string;
+    tag?: string;
+};
+export type VoiceLiveOpsActionResult = {
+    action: VoiceLiveOpsAction;
+    control: VoiceLiveOpsControlState;
+    ok: true;
+    sessionId: string;
+};
+export type VoiceLiveOpsControlStore = {
+    get: (sessionId: string) => Promise<VoiceLiveOpsControlState | undefined> | VoiceLiveOpsControlState | undefined;
+    set: (sessionId: string, state: VoiceLiveOpsControlState) => Promise<void> | void;
+};
+export type VoiceLiveOpsControllerOptions = {
+    audit?: VoiceAuditEventStore;
+    defaultAssignee?: string;
+    defaultDetail?: string;
+    defaultTag?: string;
+    onAction?: (result: VoiceLiveOpsActionResult & {
+        assignee: string;
+        detail: string;
+        tag: string;
+    }) => Promise<void> | void;
+    store?: VoiceLiveOpsControlStore;
+    trace?: VoiceTraceEventStore;
+};
+export type VoiceLiveOpsRoutesOptions = VoiceLiveOpsControllerOptions & {
+    controlPath?: string;
+    name?: string;
+    path?: string;
+};
+export declare const createVoiceMemoryLiveOpsControlStore: () => VoiceLiveOpsControlStore;
+export declare const getVoiceLiveOpsControlStatus: (action: VoiceLiveOpsAction) => VoiceLiveOpsControlStatus;
+export declare const buildVoiceLiveOpsControlState: (input: VoiceLiveOpsActionInput & {
+    at?: number;
+    previous?: VoiceLiveOpsControlState;
+}) => VoiceLiveOpsControlState;
+export declare const createVoiceLiveOpsController: (options?: VoiceLiveOpsControllerOptions) => {
+    get: (sessionId: string) => VoiceLiveOpsControlState | Promise<VoiceLiveOpsControlState | undefined> | undefined;
+    perform: (input: VoiceLiveOpsActionInput) => Promise<VoiceLiveOpsActionResult>;
+    store: VoiceLiveOpsControlStore;
+};
+export declare const createVoiceLiveOpsRoutes: (options?: VoiceLiveOpsRoutesOptions) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    [x: string]: {
+        post: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: VoiceLiveOpsActionResult | {
+                    error: string;
+                    ok: boolean;
+                };
+            };
+        };
+    };
+} & {
+    [x: string]: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: {
+                    control: VoiceLiveOpsControlState | undefined;
+                    ok: boolean;
+                    sessionId: string;
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;

package/dist/react/index.d.ts

@@ -11,6 +11,7 @@ export { VoiceTurnLatency } from './VoiceTurnLatency';
 export { VoiceTurnQuality } from './VoiceTurnQuality';
 export { useVoiceOpsStatus } from './useVoiceOpsStatus';
 export { useVoiceOpsActionCenter } from './useVoiceOpsActionCenter';
+export { useVoiceLiveOps } from './useVoiceLiveOps';
 export { useVoiceDeliveryRuntime } from './useVoiceDeliveryRuntime';
 export { useVoiceCampaignDialerProof } from './useVoiceCampaignDialerProof';
 export { useVoiceStream } from './useVoiceStream';

package/dist/react/index.js

@@ -3401,9 +3401,111 @@ var VoiceTurnQuality = ({
     ]
   }, undefined, true, undefined, this);
 };
-// src/react/useVoiceCampaignDialerProof.tsx
+// src/react/useVoiceLiveOps.tsx
 import { useEffect as useEffect12, useRef as useRef12, useSyncExternalStore as useSyncExternalStore12 } from "react";
 
+// src/client/liveOps.ts
+var postVoiceLiveOpsAction = async (input, options = {}) => {
+  if (!input.sessionId) {
+    throw new Error("Start a voice session before running live ops actions.");
+  }
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const response = await fetchImpl(options.actionPath ?? "/api/voice/live-ops/action", {
+    body: JSON.stringify(input),
+    headers: {
+      "Content-Type": "application/json"
+    },
+    method: "POST"
+  });
+  const payload = await response.json().catch(() => null);
+  if (!response.ok || !payload?.ok) {
+    const message = payload && typeof payload === "object" && "error" in payload ? String(payload.error) : `Voice live ops action failed: HTTP ${response.status}`;
+    throw new Error(message);
+  }
+  return payload;
+};
+var createVoiceLiveOpsStore = (options = {}) => {
+  const listeners = new Set;
+  let closed = false;
+  let snapshot = {
+    error: null,
+    isRunning: false
+  };
+  const emit = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const run = async (input) => {
+    if (closed) {
+      return snapshot.lastResult;
+    }
+    snapshot = {
+      ...snapshot,
+      error: null,
+      isRunning: true,
+      runningAction: input.action
+    };
+    emit();
+    try {
+      const result = await postVoiceLiveOpsAction(input, options);
+      await options.onControl?.(result);
+      snapshot = {
+        ...snapshot,
+        error: null,
+        isRunning: false,
+        lastResult: result,
+        runningAction: undefined,
+        updatedAt: Date.now()
+      };
+      emit();
+      return result;
+    } catch (error) {
+      snapshot = {
+        ...snapshot,
+        error: error instanceof Error ? error.message : String(error),
+        isRunning: false,
+        runningAction: undefined,
+        updatedAt: Date.now()
+      };
+      emit();
+      throw error;
+    }
+  };
+  const close = () => {
+    closed = true;
+    listeners.clear();
+  };
+  return {
+    close,
+    getServerSnapshot: () => snapshot,
+    getSnapshot: () => snapshot,
+    run,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+};
+
+// src/react/useVoiceLiveOps.tsx
+var useVoiceLiveOps = (options = {}) => {
+  const storeRef = useRef12(null);
+  if (!storeRef.current) {
+    storeRef.current = createVoiceLiveOpsStore(options);
+  }
+  const store = storeRef.current;
+  useEffect12(() => () => store.close(), [store]);
+  return {
+    ...useSyncExternalStore12(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    run: store.run
+  };
+};
+// src/react/useVoiceCampaignDialerProof.tsx
+import { useEffect as useEffect13, useRef as useRef13, useSyncExternalStore as useSyncExternalStore13 } from "react";
+
 // src/client/campaignDialerProof.ts
 var fetchVoiceCampaignDialerProofStatus = async (path = "/api/voice/campaigns/dialer-proof", options = {}) => {
   const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -3524,23 +3626,23 @@ var createVoiceCampaignDialerProofStore = (path = "/api/voice/campaigns/dialer-p
 
 // src/react/useVoiceCampaignDialerProof.tsx
 var useVoiceCampaignDialerProof = (path = "/api/voice/campaigns/dialer-proof", options = {}) => {
-  const storeRef = useRef12(null);
+  const storeRef = useRef13(null);
   if (!storeRef.current) {
     storeRef.current = createVoiceCampaignDialerProofStore(path, options);
   }
   const store = storeRef.current;
-  useEffect12(() => {
+  useEffect13(() => {
     store.refresh().catch(() => {});
     return () => store.close();
   }, [store]);
   return {
-    ...useSyncExternalStore12(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    ...useSyncExternalStore13(store.subscribe, store.getSnapshot, store.getServerSnapshot),
     refresh: store.refresh,
     runProof: store.runProof
   };
 };
 // src/react/useVoiceStream.tsx
-import { useEffect as useEffect13, useRef as useRef13, useSyncExternalStore as useSyncExternalStore13 } from "react";
+import { useEffect as useEffect14, useRef as useRef14, useSyncExternalStore as useSyncExternalStore14 } from "react";
 
 // src/client/actions.ts
 var normalizeErrorMessage = (value) => {
@@ -4200,13 +4302,13 @@ var EMPTY_SNAPSHOT = {
   turns: []
 };
 var useVoiceStream = (path, options = {}) => {
-  const streamRef = useRef13(null);
+  const streamRef = useRef14(null);
   if (!streamRef.current) {
     streamRef.current = createVoiceStream(path, options);
   }
   const stream = streamRef.current;
-  useEffect13(() => () => stream.close(), [stream]);
-  const snapshot = useSyncExternalStore13(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
+  useEffect14(() => () => stream.close(), [stream]);
+  const snapshot = useSyncExternalStore14(stream.subscribe, stream.getSnapshot, stream.getServerSnapshot) ?? EMPTY_SNAPSHOT;
   return {
     ...snapshot,
     callControl: (message) => stream.callControl(message),
@@ -4216,7 +4318,7 @@ var useVoiceStream = (path, options = {}) => {
   };
 };
 // src/react/useVoiceController.tsx
-import { useEffect as useEffect14, useRef as useRef14, useSyncExternalStore as useSyncExternalStore14 } from "react";
+import { useEffect as useEffect15, useRef as useRef15, useSyncExternalStore as useSyncExternalStore15 } from "react";
 
 // src/client/htmx.ts
 var DEFAULT_EVENT_NAME = "voice-refresh";
@@ -4879,13 +4981,13 @@ var EMPTY_SNAPSHOT2 = {
   turns: []
 };
 var useVoiceController = (path, options = {}) => {
-  const controllerRef = useRef14(null);
+  const controllerRef = useRef15(null);
   if (!controllerRef.current) {
     controllerRef.current = createVoiceController(path, options);
   }
   const controller = controllerRef.current;
-  useEffect14(() => () => controller.close(), [controller]);
-  const snapshot = useSyncExternalStore14(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
+  useEffect15(() => () => controller.close(), [controller]);
+  const snapshot = useSyncExternalStore15(controller.subscribe, controller.getSnapshot, controller.getServerSnapshot) ?? EMPTY_SNAPSHOT2;
   return {
     ...snapshot,
     bindHTMX: controller.bindHTMX,
@@ -4899,7 +5001,7 @@ var useVoiceController = (path, options = {}) => {
   };
 };
 // src/react/useVoiceWorkflowStatus.tsx
-import { useEffect as useEffect15, useRef as useRef15, useSyncExternalStore as useSyncExternalStore15 } from "react";
+import { useEffect as useEffect16, useRef as useRef16, useSyncExternalStore as useSyncExternalStore16 } from "react";
 
 // src/client/workflowStatus.ts
 var fetchVoiceWorkflowStatus = async (path = "/evals/scenarios/json", options = {}) => {
@@ -4982,17 +5084,17 @@ var createVoiceWorkflowStatusStore = (path = "/evals/scenarios/json", options =
 
 // src/react/useVoiceWorkflowStatus.tsx
 var useVoiceWorkflowStatus = (path = "/evals/scenarios/json", options = {}) => {
-  const storeRef = useRef15(null);
+  const storeRef = useRef16(null);
   if (!storeRef.current) {
     storeRef.current = createVoiceWorkflowStatusStore(path, options);
   }
   const store = storeRef.current;
-  useEffect15(() => {
+  useEffect16(() => {
     store.refresh().catch(() => {});
     return () => store.close();
   }, [store]);
   return {
-    ...useSyncExternalStore15(store.subscribe, store.getSnapshot, store.getServerSnapshot),
+    ...useSyncExternalStore16(store.subscribe, store.getSnapshot, store.getServerSnapshot),
     refresh: store.refresh
   };
 };
@@ -5009,6 +5111,7 @@ export {
   useVoiceProviderCapabilities,
   useVoiceOpsStatus,
   useVoiceOpsActionCenter,
+  useVoiceLiveOps,
   useVoiceDeliveryRuntime,
   useVoiceController,
   useVoiceCampaignDialerProof,

package/dist/react/useVoiceLiveOps.d.ts

@@ -0,0 +1,9 @@
+import { type VoiceLiveOpsClientOptions } from '../client/liveOps';
+export declare const useVoiceLiveOps: (options?: VoiceLiveOpsClientOptions) => {
+    run: (input: import("..").VoiceLiveOpsActionInput) => Promise<import("..").VoiceLiveOpsActionResult | undefined>;
+    error: string | null;
+    isRunning: boolean;
+    lastResult?: import("..").VoiceLiveOpsActionResult;
+    runningAction?: import("..").VoiceLiveOpsAction;
+    updatedAt?: number;
+};

package/dist/svelte/createVoiceLiveOps.d.ts

@@ -0,0 +1,13 @@
+import { type VoiceLiveOpsClientOptions } from '../client/liveOps';
+import { type VoiceLiveOpsWidgetOptions } from '../client/liveOpsWidget';
+export declare const createVoiceLiveOps: (options?: VoiceLiveOpsClientOptions | VoiceLiveOpsWidgetOptions) => {
+    close: () => void;
+    getHTML: () => string;
+    getSnapshot: () => import("../client").VoiceLiveOpsSnapshot;
+    mount: (element: Element) => {
+        close: () => void;
+        run: (input: import("..").VoiceLiveOpsActionInput) => Promise<import("..").VoiceLiveOpsActionResult | undefined>;
+    };
+    run: (input: import("..").VoiceLiveOpsActionInput) => Promise<import("..").VoiceLiveOpsActionResult | undefined>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/svelte/index.d.ts

@@ -1,6 +1,7 @@
 export { createVoiceCampaignDialerProof } from './createVoiceCampaignDialerProof';
 export { createVoiceDeliveryRuntime } from './createVoiceDeliveryRuntime';
 export { createVoiceOpsActionCenter } from './createVoiceOpsActionCenter';
+export { createVoiceLiveOps } from './createVoiceLiveOps';
 export { createVoiceOpsStatus } from './createVoiceOpsStatus';
 export { createVoiceProviderSimulationControls } from './createVoiceProviderSimulationControls';
 export { createVoiceProviderCapabilities } from './createVoiceProviderCapabilities';