@absolutejs/voice 0.0.22-beta.54 → 0.0.22-beta.540

package/dist/core/webhookVerification.d.ts

@@ -0,0 +1,27 @@
+export type VoiceWebhookVerificationReason = "missing-secret" | "missing-signature" | "missing-timestamp" | "signature-mismatch" | "stale-timestamp" | "unsupported-algorithm";
+export type VoiceWebhookVerificationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: VoiceWebhookVerificationReason;
+};
+export type VoiceWebhookVerificationInput = {
+    body: string;
+    now?: number;
+    secret?: string;
+    signature?: string | null;
+    timestamp?: string | null;
+    toleranceMs?: number;
+};
+export declare const VOICE_WEBHOOK_SIGNATURE_HEADER = "x-absolutejs-signature";
+export declare const VOICE_WEBHOOK_TIMESTAMP_HEADER = "x-absolutejs-timestamp";
+export declare const extractVoiceWebhookSignatureFromHeaders: (headers: Headers | Record<string, string | string[] | undefined>) => {
+    signature: string | null;
+    timestamp: string | null;
+};
+export declare const signVoiceWebhookBody: (input: {
+    body: string;
+    secret: string;
+    timestamp: string;
+}) => Promise<string>;
+export declare const verifyVoiceWebhookSignature: (input: VoiceWebhookVerificationInput) => Promise<VoiceWebhookVerificationResult>;

package/dist/core/whisperChannel.d.ts

@@ -0,0 +1,50 @@
+export type VoiceWhisperFrame = {
+    sessionId: string;
+    supervisorId: string;
+    pcm: ArrayBuffer | Uint8Array;
+    sampleRate: number;
+    timestamp: number;
+};
+export type VoiceWhisperRoute = "agent-only" | "agent-and-caller" | "drop";
+export type VoiceWhisperEvent = {
+    type: "started";
+    supervisorId: string;
+    at: number;
+} | {
+    type: "stopped";
+    supervisorId: string;
+    at: number;
+} | {
+    type: "frame";
+    frame: VoiceWhisperFrame;
+} | {
+    type: "ducked";
+    supervisorId: string;
+    level: number;
+    at: number;
+};
+export type CreateVoiceWhisperChannelOptions = {
+    sessionId: string;
+    defaultRoute?: VoiceWhisperRoute;
+    duckCallerToLevel?: number;
+    maxConcurrentWhispers?: number;
+    now?: () => number;
+};
+type ActiveWhisper = {
+    supervisorId: string;
+    route: VoiceWhisperRoute;
+    startedAt: number;
+};
+export declare const createVoiceWhisperChannel: (options: CreateVoiceWhisperChannelOptions) => {
+    pushFrame: (frame: VoiceWhisperFrame) => VoiceWhisperRoute;
+    sessionId: string;
+    start: (supervisorId: string, route?: VoiceWhisperRoute) => ActiveWhisper | undefined;
+    stop: (supervisorId: string) => boolean;
+    activeSupervisors: () => string[];
+    isWhispering: (supervisorId: string) => boolean;
+    routeFor: (supervisorId: string) => VoiceWhisperRoute | null;
+    setRoute(supervisorId: string, route: VoiceWhisperRoute): boolean;
+    subscribe(listener: (event: VoiceWhisperEvent) => void): () => void;
+};
+export type VoiceWhisperChannel = ReturnType<typeof createVoiceWhisperChannel>;
+export {};

package/dist/{workflowContract.d.ts → core/workflowContract.d.ts}

@@ -1,8 +1,8 @@
-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';
+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;
@@ -32,8 +32,8 @@ export type VoiceWorkflowContractDefinition<TResult = unknown> = {
         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'>> & {
+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;
 };
@@ -62,22 +62,11 @@ export type VoiceWorkflowContractTracePayload = {
     missingFields: string[];
     outcome?: VoiceWorkflowOutcome;
     requiredFields: string[];
-    status: 'pass' | 'fail';
+    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 createVoiceWorkflowScenario: <TResult = unknown>(definition: VoiceWorkflowContractDefinition<TResult>, overrides?: Partial<VoiceScenarioEvalDefinition>) => VoiceScenarioEvalDefinition;
+export declare const validateVoiceWorkflowRouteResult: <TResult = unknown>(definition: VoiceWorkflowContractDefinition<TResult>, routeResult: VoiceRouteResult<TResult>) => VoiceWorkflowContractValidation;
 export declare const createVoiceWorkflowContractHandler: <TContext = unknown, TSession extends VoiceSessionRecord = VoiceSessionRecord, TResult = unknown>(input: {
     contract?: VoiceWorkflowContract<TResult> | VoiceWorkflowContractDefinition<TResult>;
     handler: VoiceOnTurnHandler<TContext, TSession, TResult>;
@@ -89,3 +78,14 @@ export declare const createVoiceWorkflowContractHandler: <TContext = unknown, TS
     }) => VoiceWorkflowContract<TResult> | VoiceWorkflowContractDefinition<TResult> | undefined;
     store?: VoiceTraceEventStore;
 }) => VoiceOnTurnHandler<TContext, TSession, 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>>;

package/dist/core/zeroDataRetention.d.ts

@@ -0,0 +1,31 @@
+import type { VoiceTraceEvent } from "./trace";
+import type { VoiceTurnRecord } from "./types";
+export type VoiceZeroDataRetentionMode = "off" | "strict" | "custom";
+export type VoiceZeroDataRetentionRetainFlags = {
+    /** Persist committed/partial transcript text. */
+    transcriptText: boolean;
+    /** Persist assistant response text. */
+    assistantText: boolean;
+    /** Persist recorded audio artifacts. */
+    recordings: boolean;
+    /** Persist free-text payloads on trace events. */
+    traceText: boolean;
+    /** Persist arbitrary session/turn metadata. */
+    metadata: boolean;
+};
+export type VoiceZeroDataRetentionPolicy = {
+    mode: VoiceZeroDataRetentionMode;
+    retain: VoiceZeroDataRetentionRetainFlags;
+};
+export type CreateVoiceZeroDataRetentionPolicyOptions = {
+    mode?: VoiceZeroDataRetentionMode;
+    /** Per-flag overrides; only meaningful with mode "custom" (or to relax "strict"). */
+    retain?: Partial<VoiceZeroDataRetentionRetainFlags>;
+};
+export declare const VOICE_ZERO_DATA_RETENTION_REDACTION_MARKER = "[redacted:zdr]";
+export declare const createVoiceZeroDataRetentionPolicy: (options?: CreateVoiceZeroDataRetentionPolicyOptions) => VoiceZeroDataRetentionPolicy;
+export declare const isVoiceZeroDataRetentionActive: (policy: VoiceZeroDataRetentionPolicy) => boolean;
+export declare const scrubVoiceTraceForZeroDataRetention: (event: VoiceTraceEvent, policy: VoiceZeroDataRetentionPolicy) => VoiceTraceEvent;
+export declare const scrubVoiceTurnForZeroDataRetention: <TResult = unknown>(turn: VoiceTurnRecord<TResult>, policy: VoiceZeroDataRetentionPolicy) => VoiceTurnRecord<TResult>;
+export declare const shouldRetainVoiceRecording: (policy: VoiceZeroDataRetentionPolicy) => boolean;
+export declare const shouldRetainVoiceTranscript: (policy: VoiceZeroDataRetentionPolicy) => boolean;

package/dist/drizzle/assistantMemory.d.ts

@@ -0,0 +1,112 @@
+import { type VoiceAssistantMemoryRecord, type VoiceAssistantMemoryStore } from "../core/assistantMemory";
+import { type VoiceDrizzleStoreOptions } from "./shared";
+export declare const voiceAssistantMemoryTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "voice_assistant_memory";
+    schema: undefined;
+    columns: {
+        assistantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "assistant_id";
+            tableName: "voice_assistant_memory";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "voice_assistant_memory";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        key: import("drizzle-orm/pg-core").PgColumn<{
+            name: "key";
+            tableName: "voice_assistant_memory";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        namespace: import("drizzle-orm/pg-core").PgColumn<{
+            name: "namespace";
+            tableName: "voice_assistant_memory";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: "voice_assistant_memory";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sortAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sort_at";
+            tableName: "voice_assistant_memory";
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const createVoiceDrizzleAssistantMemoryStore: <TRecord extends VoiceAssistantMemoryRecord = VoiceAssistantMemoryRecord>(options: VoiceDrizzleStoreOptions) => VoiceAssistantMemoryStore<TRecord>;

package/dist/drizzle/eval.d.ts

@@ -0,0 +1,61 @@
+import type { VoiceEvalBaselineStore } from "../core/evalRoutes";
+import { type VoiceDrizzleStoreOptions } from "./shared";
+export declare const voiceEvalBaselineTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: string;
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: string;
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: string;
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sortAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sort_at";
+            tableName: string;
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const createVoiceDrizzleEvalBaselineStore: (options: VoiceDrizzleStoreOptions) => VoiceEvalBaselineStore;

package/dist/drizzle/handoff.d.ts

@@ -0,0 +1,62 @@
+import type { VoiceHandoffDeliveryRecord } from "../core/handoff";
+import type { VoiceHandoffDeliveryStore } from "../core/types";
+import { type VoiceDrizzleStoreOptions } from "./shared";
+export declare const voiceHandoffDeliveriesTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: string;
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: string;
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: string;
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sortAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sort_at";
+            tableName: string;
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const createVoiceDrizzleHandoffDeliveryStore: <TDelivery extends VoiceHandoffDeliveryRecord = VoiceHandoffDeliveryRecord>(options: VoiceDrizzleStoreOptions) => VoiceHandoffDeliveryStore<TDelivery>;

package/dist/drizzle/incidentBundle.d.ts

@@ -0,0 +1,61 @@
+import { type StoredVoiceIncidentBundleArtifact, type VoiceIncidentBundleStore } from "../core/incidentBundle";
+import { type VoiceDrizzleStoreOptions } from "./shared";
+export declare const voiceIncidentBundlesTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: string;
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: string;
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: import("drizzle-orm/pg-core").PgColumn<{
+            name: "payload";
+            tableName: string;
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sortAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sort_at";
+            tableName: string;
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const createVoiceDrizzleIncidentBundleStore: <TArtifact extends StoredVoiceIncidentBundleArtifact = StoredVoiceIncidentBundleArtifact>(options: VoiceDrizzleStoreOptions) => VoiceIncidentBundleStore<TArtifact>;