@absolutejs/voice 0.0.22-beta.42 → 0.0.22-beta.421

package/dist/vue/useVoiceRoutingStatus.d.ts

@@ -0,0 +1,8 @@
+import { type VoiceRoutingStatusClientOptions } from '../client/routingStatus';
+export declare function useVoiceRoutingStatus(path?: string, options?: VoiceRoutingStatusClientOptions): {
+    decision: import("vue").ShallowRef<import("..").VoiceRoutingEvent | null, import("..").VoiceRoutingEvent | null>;
+    error: import("vue").Ref<string | null, string | null>;
+    isLoading: import("vue").Ref<boolean, boolean>;
+    refresh: () => Promise<import("..").VoiceRoutingEvent | null>;
+    updatedAt: import("vue").Ref<number | undefined, number | undefined>;
+};

package/dist/vue/useVoiceSessionSnapshot.d.ts

@@ -0,0 +1,10 @@
+import { type VoiceSessionSnapshotClientOptions } from '../client/sessionSnapshot';
+import type { VoiceSessionSnapshot } from '../sessionSnapshot';
+export declare function useVoiceSessionSnapshot(path: string, options?: VoiceSessionSnapshotClientOptions): {
+    download: () => Blob;
+    error: import("vue").ShallowRef<string | null, string | null>;
+    isLoading: import("vue").ShallowRef<boolean, boolean>;
+    refresh: () => Promise<VoiceSessionSnapshot | undefined>;
+    snapshot: import("vue").ShallowRef<VoiceSessionSnapshot | undefined, VoiceSessionSnapshot | undefined>;
+    updatedAt: import("vue").ShallowRef<number | undefined, number | undefined>;
+};

package/dist/vue/useVoiceStream.d.ts

@@ -1,5 +1,5 @@
 import type { VoiceConnectionOptions, VoiceTurnRecord } from '../types';
-export declare const useVoiceStream: <TResult = unknown>(path: string, options?: VoiceConnectionOptions) => {
+export declare function useVoiceStream<TResult = unknown>(path: string, options?: VoiceConnectionOptions): {
     assistantAudio: import("vue").ShallowRef<{
         chunk: Uint8Array;
         format: import("..").AudioFormat;
@@ -19,8 +19,10 @@ export declare const useVoiceStream: <TResult = unknown>(path: string, options?:
     error: import("vue").Ref<string | null, string | null>;
     isConnected: import("vue").Ref<boolean, boolean>;
     partial: import("vue").Ref<string, string>;
+    reconnect: import("vue").ShallowRef<import("..").VoiceReconnectClientState, import("..").VoiceReconnectClientState>;
     sendAudio: (audio: Uint8Array | ArrayBuffer) => void;
     sessionId: import("vue").Ref<string | null, string | null>;
+    sessionMetadata: import("vue").ShallowRef<Record<string, unknown> | null, Record<string, unknown> | null>;
     status: import("vue").Ref<import("..").VoiceSessionStatus | "idle", import("..").VoiceSessionStatus | "idle">;
     turns: import("vue").ShallowRef<VoiceTurnRecord<TResult>[], VoiceTurnRecord<TResult>[]>;
 };

package/dist/vue/useVoiceTraceTimeline.d.ts

@@ -0,0 +1,9 @@
+import { type VoiceTraceTimelineClientOptions } from '../client/traceTimeline';
+import type { VoiceTraceTimelineReport } from '../traceTimeline';
+export declare function useVoiceTraceTimeline(path?: string, options?: VoiceTraceTimelineClientOptions): {
+    error: import("vue").Ref<string | null, string | null>;
+    isLoading: import("vue").Ref<boolean, boolean>;
+    refresh: () => Promise<VoiceTraceTimelineReport | null>;
+    report: import("vue").ShallowRef<VoiceTraceTimelineReport | null, VoiceTraceTimelineReport | null>;
+    updatedAt: import("vue").Ref<number | undefined, number | undefined>;
+};

package/dist/vue/useVoiceTurnLatency.d.ts

@@ -0,0 +1,10 @@
+import { type VoiceTurnLatencyClientOptions } from '../client/turnLatency';
+import type { VoiceTurnLatencyReport } from '../turnLatency';
+export declare function useVoiceTurnLatency(path?: string, options?: VoiceTurnLatencyClientOptions): {
+    error: import("vue").ShallowRef<string | null, string | null>;
+    isLoading: import("vue").ShallowRef<boolean, boolean>;
+    refresh: () => Promise<VoiceTurnLatencyReport | undefined>;
+    report: import("vue").ShallowRef<VoiceTurnLatencyReport | undefined, VoiceTurnLatencyReport | undefined>;
+    runProof: () => Promise<VoiceTurnLatencyReport | undefined>;
+    updatedAt: import("vue").ShallowRef<number | undefined, number | undefined>;
+};

package/dist/vue/useVoiceTurnQuality.d.ts

@@ -0,0 +1,9 @@
+import { type VoiceTurnQualityClientOptions } from '../client/turnQuality';
+import type { VoiceTurnQualityReport } from '../turnQuality';
+export declare function useVoiceTurnQuality(path?: string, options?: VoiceTurnQualityClientOptions): {
+    error: import("vue").ShallowRef<string | null, string | null>;
+    isLoading: import("vue").ShallowRef<boolean, boolean>;
+    refresh: () => Promise<VoiceTurnQualityReport | undefined>;
+    report: import("vue").ShallowRef<VoiceTurnQualityReport | undefined, VoiceTurnQualityReport | undefined>;
+    updatedAt: import("vue").ShallowRef<number | undefined, number | undefined>;
+};

package/dist/vue/useVoiceWorkflowStatus.d.ts

@@ -0,0 +1,9 @@
+import { type VoiceWorkflowStatusClientOptions } from '../client/workflowStatus';
+import type { VoiceScenarioEvalReport } from '../evalRoutes';
+export declare function useVoiceWorkflowStatus(path?: string, options?: VoiceWorkflowStatusClientOptions): {
+    error: import("vue").Ref<string | null, string | null>;
+    isLoading: import("vue").Ref<boolean, boolean>;
+    refresh: () => Promise<VoiceScenarioEvalReport | undefined>;
+    report: import("vue").ShallowRef<VoiceScenarioEvalReport | undefined, VoiceScenarioEvalReport | undefined>;
+    updatedAt: import("vue").Ref<number | undefined, number | undefined>;
+};

package/dist/workflowContract.d.ts

@@ -0,0 +1,91 @@
+import type { VoiceScenarioEvalDefinition } from './evalRoutes';
+import type { StoredVoiceTraceEvent, VoiceTraceEventStore } from './trace';
+import type { VoiceOnTurnHandler, VoiceRouteResult, VoiceSessionRecord, VoiceTurnRecord } from './types';
+export type VoiceWorkflowOutcome = 'complete' | 'transfer' | 'escalate' | 'voicemail' | 'no-answer';
+export type VoiceWorkflowContractFieldMatch = 'boolean' | 'non-empty' | 'number' | 'string' | 'truthy';
+export type VoiceWorkflowContractField = {
+    aliases?: string[];
+    label?: string;
+    match?: VoiceWorkflowContractFieldMatch;
+    path: string;
+    required?: boolean;
+};
+export type VoiceWorkflowContractDefinition<TResult = unknown> = {
+    description?: string;
+    fields?: VoiceWorkflowContractField[];
+    forbiddenHandoffActions?: string[];
+    id: string;
+    label?: string;
+    maxProviderErrors?: number;
+    maxSessionErrors?: number;
+    minSessions?: number;
+    minTurns?: number;
+    outcome?: VoiceWorkflowOutcome;
+    requiredAssistantIncludes?: string[];
+    requiredDisposition?: string;
+    requiredHandoffActions?: string[];
+    requiredLifecycleTypes?: string[];
+    requiredTranscriptIncludes?: string[];
+    scenarioId?: string;
+    validate?: (input: {
+        result: TResult | undefined;
+        routeResult: VoiceRouteResult<TResult>;
+    }) => VoiceWorkflowContractValidationIssue[];
+};
+export type VoiceWorkflowContractPresetName = 'appointment-booking' | 'lead-qualification' | 'support-triage' | 'transfer-handoff' | 'voicemail-callback';
+export type VoiceWorkflowContractPresetOptions<TResult = unknown> = Partial<Omit<VoiceWorkflowContractDefinition<TResult>, 'fields' | 'id'>> & {
+    fields?: VoiceWorkflowContractField[];
+    id?: string;
+};
+export type VoiceWorkflowContractValidationIssue = {
+    code: string;
+    field?: string;
+    message: string;
+};
+export type VoiceWorkflowContractValidation = {
+    contractId: string;
+    issues: VoiceWorkflowContractValidationIssue[];
+    missingFields: string[];
+    outcome?: VoiceWorkflowOutcome;
+    pass: boolean;
+    requiredFields: string[];
+};
+export type VoiceWorkflowContract<TResult = unknown> = {
+    assertRouteResult: (routeResult: VoiceRouteResult<TResult>) => void;
+    definition: VoiceWorkflowContractDefinition<TResult>;
+    toScenarioEval: (overrides?: Partial<VoiceScenarioEvalDefinition>) => VoiceScenarioEvalDefinition;
+    validateRouteResult: (routeResult: VoiceRouteResult<TResult>) => VoiceWorkflowContractValidation;
+};
+export type VoiceWorkflowContractTracePayload = {
+    contractId: string;
+    issues: VoiceWorkflowContractValidationIssue[];
+    missingFields: string[];
+    outcome?: VoiceWorkflowOutcome;
+    requiredFields: string[];
+    status: 'pass' | 'fail';
+};
+export declare const validateVoiceWorkflowRouteResult: <TResult = unknown>(definition: VoiceWorkflowContractDefinition<TResult>, routeResult: VoiceRouteResult<TResult>) => VoiceWorkflowContractValidation;
+export declare const createVoiceWorkflowScenario: <TResult = unknown>(definition: VoiceWorkflowContractDefinition<TResult>, overrides?: Partial<VoiceScenarioEvalDefinition>) => VoiceScenarioEvalDefinition;
+export declare const createVoiceWorkflowContract: <TResult = unknown>(definition: VoiceWorkflowContractDefinition<TResult>) => VoiceWorkflowContract<TResult>;
+export declare const createVoiceWorkflowContractPreset: <TResult = unknown>(name: VoiceWorkflowContractPresetName, options?: VoiceWorkflowContractPresetOptions<TResult>) => VoiceWorkflowContract<TResult>;
+export declare const recordVoiceWorkflowContractTrace: (input: {
+    at?: number;
+    contractId?: string;
+    scenarioId?: string;
+    sessionId: string;
+    store: VoiceTraceEventStore;
+    traceId?: string;
+    turnId?: string;
+    validation: VoiceWorkflowContractValidation;
+}) => Promise<StoredVoiceTraceEvent<VoiceWorkflowContractTracePayload>>;
+export declare const createVoiceWorkflowContractHandler: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(input: {
+    contract?: VoiceWorkflowContract<TResult> | VoiceWorkflowContractDefinition<TResult>;
+    handler: VoiceOnTurnHandler<TContext, TSession, TResult>;
+    resolveContract?: (args: {
+        context: TContext;
+        result: VoiceRouteResult<TResult>;
+        session: TSession;
+        turn: VoiceTurnRecord;
+    }) => VoiceWorkflowContract<TResult> | VoiceWorkflowContractDefinition<TResult> | undefined;
+    store?: VoiceTraceEventStore;
+}) => VoiceOnTurnHandler<TContext, TSession, TResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/voice",
-	"version": "0.0.22-beta.42",
+	"version": "0.0.22-beta.421",
 	"description": "Voice primitives and Elysia plugin for AbsoluteJS",
 	"repository": {
 		"type": "git",
@@ -245,6 +245,9 @@
 			"optional": true
 		}
 	},
+	"dependencies": {
+		"@absolutejs/media": "0.0.1-beta.14"
+	},
 	"devDependencies": {
 		"@absolutejs/absolute": "0.19.0-beta.646",
 		"@angular/core": "^21.0.0",