@absolutejs/voice 0.0.22-beta.12 → 0.0.22-beta.121

package/dist/types.d.ts

@@ -269,6 +269,65 @@ export type VoiceCallLifecycleState = {
     lastEventAt: number;
     startedAt: number;
 };
+export type VoiceHandoffAction = 'escalate' | 'no-answer' | 'transfer' | 'voicemail';
+export type VoiceHandoffStatus = 'delivered' | 'failed' | 'skipped';
+export type VoiceHandoffResult = {
+    deliveredAt?: number;
+    deliveredTo?: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+    status: VoiceHandoffStatus;
+};
+export type VoiceHandoffDeliveryQueueStatus = VoiceHandoffStatus | 'pending';
+export type StoredVoiceHandoffDelivery<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
+    action: VoiceHandoffAction;
+    context: TContext;
+    createdAt: number;
+    deliveredAt?: number;
+    deliveries?: Record<string, VoiceHandoffResult & {
+        adapterId: string;
+        adapterKind?: string;
+    }>;
+    deliveryAttempts?: number;
+    deliveryError?: string;
+    deliveryStatus: VoiceHandoffDeliveryQueueStatus;
+    id: string;
+    metadata?: Record<string, unknown>;
+    reason?: string;
+    result?: TResult;
+    session: TSession;
+    sessionId: string;
+    target?: string;
+    updatedAt: number;
+};
+export type VoiceHandoffDeliveryStore<TDelivery extends StoredVoiceHandoffDelivery = StoredVoiceHandoffDelivery> = {
+    get: (id: string) => Promise<TDelivery | undefined> | TDelivery | undefined;
+    list: () => Promise<TDelivery[]> | TDelivery[];
+    remove: (id: string) => Promise<void> | void;
+    set: (id: string, delivery: TDelivery) => Promise<void> | void;
+};
+export type VoiceHandoffInput<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
+    action: VoiceHandoffAction;
+    api: VoiceSessionHandle<TContext, TSession, TResult>;
+    context: TContext;
+    metadata?: Record<string, unknown>;
+    reason?: string;
+    result?: TResult;
+    session: TSession;
+    target?: string;
+};
+export type VoiceHandoffAdapter<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
+    actions?: VoiceHandoffAction[];
+    handoff: (input: VoiceHandoffInput<TContext, TSession, TResult>) => Promise<VoiceHandoffResult> | VoiceHandoffResult;
+    id: string;
+    kind?: string;
+};
+export type VoiceHandoffConfig<TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = {
+    adapters: VoiceHandoffAdapter<TContext, TSession, TResult>[];
+    deliveryQueue?: VoiceHandoffDeliveryStore<StoredVoiceHandoffDelivery<TContext, TSession, TResult>>;
+    enqueueOnly?: boolean;
+    failMode?: 'record' | 'throw';
+};
 export type VoiceSessionStore<TSession extends VoiceSessionRecord = VoiceSessionRecord> = SessionStore<TSession, VoiceSessionSummary>;
 export type VoiceLogger = {
     debug?: (message: string, meta?: Record<string, unknown>) => void;
@@ -567,6 +626,7 @@ export type VoicePluginConfig<TContext = unknown, TSession extends VoiceSessionR
     audioConditioning?: VoiceAudioConditioningConfig;
     logger?: VoiceLogger;
     htmx?: boolean | VoiceHTMXConfig<TSession, NoInfer<TResult>>;
+    handoff?: VoiceHandoffConfig<TContext, TSession, TResult>;
     ops?: VoiceRuntimeOpsConfig<TContext, TSession, TResult>;
     trace?: VoiceTraceEventStore;
 } & VoiceRouteConfig<TContext, TSession, TResult>;
@@ -588,6 +648,7 @@ export type CreateVoiceSessionOptions<TContext = unknown, TSession extends Voice
     sttLifecycle: VoiceSTTLifecycle;
     turnDetection: VoiceResolvedTurnDetectionConfig;
     audioConditioning?: VoiceResolvedAudioConditioningConfig;
+    handoff?: VoiceHandoffConfig<TContext, TSession, TResult>;
     route: VoiceNormalizedRouteConfig<TContext, TSession, TResult>;
     logger?: VoiceLogger;
 };
@@ -604,10 +665,17 @@ export type VoiceClientCloseMessage = {
     type: 'close';
     reason?: string;
 };
+export type VoiceClientCallControlMessage = {
+    type: 'call_control';
+    action: 'complete' | 'escalate' | 'no-answer' | 'transfer' | 'voicemail';
+    metadata?: Record<string, unknown>;
+    reason?: string;
+    target?: string;
+};
 export type VoiceClientPingMessage = {
     type: 'ping';
 };
-export type VoiceClientMessage = VoiceClientStartMessage | VoiceClientEndTurnMessage | VoiceClientCloseMessage | VoiceClientPingMessage;
+export type VoiceClientMessage = VoiceClientStartMessage | VoiceClientEndTurnMessage | VoiceClientCloseMessage | VoiceClientCallControlMessage | VoiceClientPingMessage;
 export type VoiceServerSessionMessage = {
     type: 'session';
     sessionId: string;
@@ -642,6 +710,11 @@ export type VoiceServerCompleteMessage = {
     type: 'complete';
     sessionId: string;
 };
+export type VoiceServerCallLifecycleMessage = {
+    type: 'call_lifecycle';
+    event: VoiceCallLifecycleEvent;
+    sessionId: string;
+};
 export type VoiceServerErrorMessage = {
     type: 'error';
     message: string;
@@ -650,7 +723,7 @@ export type VoiceServerErrorMessage = {
 export type VoiceServerPongMessage = {
     type: 'pong';
 };
-export type VoiceServerMessage<TResult = unknown> = VoiceServerSessionMessage | VoiceServerPartialMessage | VoiceServerFinalMessage | VoiceServerTurnMessage<TResult> | VoiceServerAssistantMessage | VoiceServerAudioMessage | VoiceServerCompleteMessage | VoiceServerErrorMessage | VoiceServerPongMessage;
+export type VoiceServerMessage<TResult = unknown> = VoiceServerSessionMessage | VoiceServerPartialMessage | VoiceServerFinalMessage | VoiceServerTurnMessage<TResult> | VoiceServerAssistantMessage | VoiceServerAudioMessage | VoiceServerCallLifecycleMessage | VoiceServerCompleteMessage | VoiceServerErrorMessage | VoiceServerPongMessage;
 export type VoiceConnectionOptions = {
     protocols?: string[];
     scenarioId?: string;
@@ -661,6 +734,7 @@ export type VoiceConnectionOptions = {
 };
 export type VoiceCaptureOptions = {
     channelCount?: 1 | 2;
+    onAudio?: (audio: Uint8Array | ArrayBuffer, sendAudio: (audio: Uint8Array | ArrayBuffer) => void) => void;
     onLevel?: (level: number) => void;
     sampleRateHz?: number;
 };
@@ -674,6 +748,46 @@ export type VoiceBargeInOptions = {
     enabled?: boolean;
     interruptOnPartial?: boolean;
     interruptThreshold?: number;
+    monitor?: VoiceBargeInMonitor;
+};
+export type VoiceBargeInTriggerReason = 'input-level' | 'manual-audio' | 'manual-interrupt' | 'partial-transcript';
+export type VoiceBargeInMonitorEvent = {
+    at: number;
+    id: string;
+    latencyMs?: number;
+    playbackStopLatencyMs?: number;
+    reason: VoiceBargeInTriggerReason;
+    sessionId?: string | null;
+    status: 'requested' | 'stopped' | 'skipped';
+    thresholdMs?: number;
+};
+export type VoiceBargeInMonitorSnapshot = {
+    averageLatencyMs?: number;
+    events: VoiceBargeInMonitorEvent[];
+    failed: number;
+    lastEvent?: VoiceBargeInMonitorEvent;
+    passed: number;
+    status: 'empty' | 'fail' | 'pass' | 'warn';
+    thresholdMs: number;
+    total: number;
+};
+export type VoiceBargeInMonitor = {
+    getSnapshot: () => VoiceBargeInMonitorSnapshot;
+    recordRequested: (input: {
+        reason: VoiceBargeInTriggerReason;
+        sessionId?: string | null;
+    }) => VoiceBargeInMonitorEvent;
+    recordSkipped: (input: {
+        reason: VoiceBargeInTriggerReason;
+        sessionId?: string | null;
+    }) => VoiceBargeInMonitorEvent;
+    recordStopped: (input: {
+        latencyMs?: number;
+        playbackStopLatencyMs?: number;
+        reason: VoiceBargeInTriggerReason;
+        sessionId?: string | null;
+    }) => VoiceBargeInMonitorEvent;
+    subscribe: (subscriber: () => void) => () => void;
 };
 export type VoiceAudioPlayerOptions = {
     autoStart?: boolean;
@@ -728,6 +842,7 @@ export type VoiceHTMXOptions<TSession extends VoiceSessionRecord = VoiceSessionR
 };
 export type VoiceHTMXConfig<TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown> = VoiceHTMXRenderer<TSession, TResult> | VoiceHTMXOptions<TSession, TResult>;
 export type VoiceStreamState<TResult = unknown> = {
+    call: VoiceCallLifecycleState | null;
     sessionId: string | null;
     scenarioId: string | null;
     status: VoiceSessionStatus | 'idle';
@@ -744,6 +859,8 @@ export type VoiceStreamState<TResult = unknown> = {
     isConnected: boolean;
 };
 export type VoiceStream<TResult = unknown> = {
+    call: VoiceCallLifecycleState | null;
+    callControl: (message: Omit<VoiceClientCallControlMessage, 'type'>) => void;
     close: () => void;
     start: (input?: {
         scenarioId?: string;
@@ -810,6 +927,8 @@ export type VoiceBargeInBinding = {
 };
 export type VoiceController<TResult = unknown> = {
     bindHTMX: (options: VoiceHTMXBindingOptions) => () => void;
+    call: VoiceCallLifecycleState | null;
+    callControl: (message: Omit<VoiceClientCallControlMessage, 'type'>) => void;
     close: () => void;
     endTurn: () => void;
     start: (input?: {
@@ -855,6 +974,10 @@ export type VoiceStoreAction<TResult = unknown> = {
     sessionId: string;
     scenarioId?: string;
     status: VoiceSessionStatus;
+} | {
+    type: 'call_lifecycle';
+    event: VoiceCallLifecycleEvent;
+    sessionId: string;
 } | {
     type: 'partial';
     transcript: Transcript;

package/dist/vue/VoiceOpsStatus.d.ts

@@ -0,0 +1,30 @@
+export declare const VoiceOpsStatus: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    description: StringConstructor;
+    includeLinks: {
+        default: boolean;
+        type: BooleanConstructor;
+    };
+    intervalMs: NumberConstructor;
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: StringConstructor;
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    description: StringConstructor;
+    includeLinks: {
+        default: boolean;
+        type: BooleanConstructor;
+    };
+    intervalMs: NumberConstructor;
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: StringConstructor;
+}>> & Readonly<{}>, {
+    path: string;
+    includeLinks: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/VoiceProviderCapabilities.d.ts

@@ -0,0 +1,51 @@
+export declare const VoiceProviderCapabilities: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>> & Readonly<{}>, {
+    description: string;
+    title: string;
+    path: string;
+    intervalMs: number;
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/VoiceProviderSimulationControls.d.ts

@@ -0,0 +1,88 @@
+import { type PropType } from 'vue';
+import type { VoiceProviderSimulationProvider } from '../client/providerSimulationControls';
+export declare const VoiceProviderSimulationControls: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    fallbackRequiredMessage: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    fallbackRequiredProvider: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    failureMessage: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    failureProviders: {
+        default: undefined;
+        type: PropType<readonly string[] | undefined>;
+    };
+    kind: {
+        default: string;
+        type: StringConstructor;
+    };
+    pathPrefix: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    providers: {
+        required: true;
+        type: PropType<readonly VoiceProviderSimulationProvider[]>;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    fallbackRequiredMessage: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    fallbackRequiredProvider: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    failureMessage: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    failureProviders: {
+        default: undefined;
+        type: PropType<readonly string[] | undefined>;
+    };
+    kind: {
+        default: string;
+        type: StringConstructor;
+    };
+    pathPrefix: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    providers: {
+        required: true;
+        type: PropType<readonly VoiceProviderSimulationProvider[]>;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>> & Readonly<{}>, {
+    kind: string;
+    title: string;
+    fallbackRequiredProvider: string;
+    fallbackRequiredMessage: string;
+    failureProviders: readonly string[] | undefined;
+    failureMessage: string;
+    pathPrefix: string;
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/VoiceProviderStatus.d.ts

@@ -0,0 +1,51 @@
+export declare const VoiceProviderStatus: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>> & Readonly<{}>, {
+    description: string;
+    title: string;
+    path: string;
+    intervalMs: number;
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/VoiceRoutingStatus.d.ts

@@ -0,0 +1,51 @@
+export declare const VoiceRoutingStatus: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>> & Readonly<{}>, {
+    description: string;
+    title: string;
+    path: string;
+    intervalMs: number;
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/VoiceTurnLatency.d.ts

@@ -0,0 +1,69 @@
+export declare const VoiceTurnLatency: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    proofLabel: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    proofPath: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    proofLabel: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    proofPath: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>> & Readonly<{}>, {
+    description: string;
+    title: string;
+    path: string;
+    intervalMs: number;
+    proofPath: string;
+    proofLabel: string;
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/VoiceTurnQuality.d.ts

@@ -0,0 +1,51 @@
+export declare const VoiceTurnQuality: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    class: {
+        default: string;
+        type: StringConstructor;
+    };
+    description: {
+        default: undefined;
+        type: StringConstructor;
+    };
+    intervalMs: {
+        default: number;
+        type: NumberConstructor;
+    };
+    path: {
+        default: string;
+        type: StringConstructor;
+    };
+    title: {
+        default: undefined;
+        type: StringConstructor;
+    };
+}>> & Readonly<{}>, {
+    description: string;
+    title: string;
+    path: string;
+    intervalMs: number;
+    class: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/index.d.ts

@@ -1,2 +1,19 @@
+export { VoiceOpsStatus } from './VoiceOpsStatus';
+export { VoiceProviderSimulationControls } from './VoiceProviderSimulationControls';
+export { VoiceProviderCapabilities } from './VoiceProviderCapabilities';
+export { VoiceProviderStatus } from './VoiceProviderStatus';
+export { VoiceRoutingStatus } from './VoiceRoutingStatus';
+export { VoiceTurnLatency } from './VoiceTurnLatency';
+export { VoiceTurnQuality } from './VoiceTurnQuality';
+export { useVoiceAppKitStatus } from './useVoiceAppKitStatus';
+export { useVoiceCampaignDialerProof } from './useVoiceCampaignDialerProof';
 export { useVoiceStream } from './useVoiceStream';
 export { useVoiceController } from './useVoiceController';
+export { useVoiceProviderStatus } from './useVoiceProviderStatus';
+export { useVoiceProviderCapabilities } from './useVoiceProviderCapabilities';
+export { useVoiceProviderSimulationControls } from './useVoiceProviderSimulationControls';
+export { useVoiceRoutingStatus } from './useVoiceRoutingStatus';
+export { useVoiceTraceTimeline } from './useVoiceTraceTimeline';
+export { useVoiceTurnLatency } from './useVoiceTurnLatency';
+export { useVoiceTurnQuality } from './useVoiceTurnQuality';
+export { useVoiceWorkflowStatus } from './useVoiceWorkflowStatus';