@absolutejs/voice 0.0.22-beta.506 → 0.0.22-beta.508

package/dist/angular/voice-live-agent-console.service.d.ts

@@ -0,0 +1,16 @@
+import { type CreateLiveAgentConsoleOptions, type LiveAgentConsole, type LiveAgentConsoleState } from "../client/liveAgentConsole";
+export type VoiceLiveAgentConsoleServiceOptions = CreateLiveAgentConsoleOptions & {
+    takeoverButtonLabel?: string;
+    title?: string;
+};
+export declare class VoiceLiveAgentConsoleService {
+    build(options: VoiceLiveAgentConsoleServiceOptions): {
+        releaseTakeover: () => void;
+        setCaller: (caller: Parameters<LiveAgentConsole["setCaller"]>[0]) => void;
+        state: import("@angular/core").Signal<LiveAgentConsoleState>;
+        stop: () => void;
+        takeover: (reason?: string) => void;
+        takeoverButtonLabel: string;
+        title: string;
+    };
+}

package/dist/client/browserVoiceSupport.d.ts

@@ -0,0 +1,22 @@
+export type BrowserVoiceSupportProbe = {
+    hasAudioContext: boolean;
+    hasAudioWorklet: boolean;
+    hasGetUserMedia: boolean;
+    hasMediaRecorder: boolean;
+    hasOpusEncoding: boolean;
+    hasRTCPeerConnection: boolean;
+    hasWebSocket: boolean;
+    isInsecureContext: boolean;
+    isIos: boolean;
+    isSafari: boolean;
+    requiresUserGestureToResumeAudio: boolean;
+    userAgent: string;
+};
+export type BrowserVoiceSupportReport = {
+    blockers: string[];
+    capabilities: BrowserVoiceSupportProbe;
+    ok: boolean;
+    warnings: string[];
+};
+export declare const probeBrowserVoiceSupport: (globalScope?: typeof globalThis) => BrowserVoiceSupportProbe;
+export declare const checkBrowserVoiceSupport: (globalScope?: typeof globalThis) => BrowserVoiceSupportReport;

package/dist/client/conversationAnalytics.d.ts

@@ -0,0 +1,29 @@
+import type { StoredVoiceTraceEvent } from "../trace";
+export type VoiceTrafficBucket = {
+    bucketKey: string;
+    callsCompleted: number;
+    callsFailed: number;
+    callsTransferred: number;
+    callsVoicemail: number;
+    callsTotal: number;
+    totalDurationMs: number;
+};
+export type VoiceTrafficSummary = {
+    buckets: VoiceTrafficBucket[];
+    callsByDisposition: Record<string, number>;
+    transferReasons: Record<string, number>;
+    topTransferTargets: Array<{
+        count: number;
+        target: string;
+    }>;
+    totals: VoiceTrafficBucket;
+    windowEndMs: number;
+    windowStartMs: number;
+};
+export type SummarizeVoiceCallTrafficOptions = {
+    bucketBy?: "day" | "hour" | "month";
+    events: ReadonlyArray<StoredVoiceTraceEvent>;
+    fromMs?: number;
+    toMs?: number;
+};
+export declare const summarizeVoiceCallTraffic: (options: SummarizeVoiceCallTrafficOptions) => VoiceTrafficSummary;

package/dist/client/liveAgentConsole.d.ts

@@ -0,0 +1,28 @@
+import { type CreateLiveCallViewerOptions, type LiveCallTimelineEvent, type LiveCallViewState, type LiveCallViewer } from "./liveCallViewer";
+import type { VoiceCallerMemorySnapshot } from "../callerMemory";
+export type LiveAgentConsoleState = {
+    caller?: VoiceCallerMemorySnapshot;
+    hasTakeover: boolean;
+    recentTimeline: LiveCallTimelineEvent[];
+    takeoverAt?: number;
+    takeoverReason?: string;
+    view: LiveCallViewState;
+};
+export type CreateLiveAgentConsoleOptions = CreateLiveCallViewerOptions & {
+    /** Recent timeline window length. Default 12. */
+    recentLimit?: number;
+    /** Resolves the caller memory snapshot for this session (fetched once on attach). */
+    resolveCaller?: () => Promise<VoiceCallerMemorySnapshot | undefined> | VoiceCallerMemorySnapshot | undefined;
+};
+export type LiveAgentConsole = {
+    getState: () => LiveAgentConsoleState;
+    noteAgentAudio: (at?: number) => void;
+    notePartial: (text: string, at?: number) => void;
+    noteTranscript: (text: string, at?: number) => void;
+    releaseTakeover: () => void;
+    setCaller: (caller: VoiceCallerMemorySnapshot | undefined) => void;
+    subscribe: (listener: () => void) => () => void;
+    takeover: (reason?: string) => void;
+    viewer: LiveCallViewer;
+};
+export declare const createLiveAgentConsole: (options: CreateLiveAgentConsoleOptions) => LiveAgentConsole;

package/dist/costPredictor.d.ts

@@ -0,0 +1,74 @@
+import { type VoicePriceBook } from "./costAccounting";
+export type VoiceCostProfile = {
+    /** Stored callers? Set to true to include caller-memory storage costs (per snapshot, monthly). Default false (we don't model storage here). */
+    includeCallerMemory?: boolean;
+    /** Inbound calls per day. */
+    inboundPerDay?: number;
+    /** Average input tokens per agent turn. */
+    inputTokensPerTurn: number;
+    /** LLM model id used for provider:model price lookup. */
+    llmModel: string;
+    /** LLM provider — must match price book namespace. */
+    llmProvider: string;
+    /** Average minutes per call. */
+    minutesPerCall: number;
+    /** Outbound calls per day. */
+    outboundPerDay?: number;
+    /** Average output tokens per agent turn. */
+    outputTokensPerTurn: number;
+    /** STT model. */
+    sttModel?: string;
+    /** STT provider. */
+    sttProvider?: string;
+    /** Telephony provider key in the price book (e.g. 'twilio', 'telnyx'). */
+    telephonyProvider?: string;
+    /** Total turns per call. */
+    turnsPerCall: number;
+    /** Average TTS characters spoken per agent turn. */
+    ttsCharsPerTurn: number;
+    /** TTS model / voice id. */
+    ttsModel?: string;
+    /** TTS provider. */
+    ttsProvider?: string;
+};
+export type VoiceCostPrediction = {
+    callsPerDay: number;
+    monthly: {
+        llmUsd: number;
+        sttUsd: number;
+        telephonyUsd: number;
+        totalUsd: number;
+        ttsUsd: number;
+    };
+    perCall: {
+        llmUsd: number;
+        sttUsd: number;
+        telephonyUsd: number;
+        totalUsd: number;
+        ttsUsd: number;
+    };
+};
+export type PredictVoiceCallCostInput = {
+    priceBook?: VoicePriceBook;
+    profile: VoiceCostProfile;
+};
+export declare const predictVoiceCallCost: (input: PredictVoiceCallCostInput) => VoiceCostPrediction;
+export type VoiceCostScenarioComparison = {
+    delta: {
+        monthlyUsd: number;
+        perCallUsd: number;
+    };
+    prediction: VoiceCostPrediction;
+    scenarioId: string;
+};
+export declare const compareVoiceCostScenarios: (input: {
+    baselineId: string;
+    priceBook?: VoicePriceBook;
+    scenarios: ReadonlyArray<{
+        id: string;
+        profile: VoiceCostProfile;
+    }>;
+}) => {
+    baseline: VoiceCostPrediction;
+    scenarios: VoiceCostScenarioComparison[];
+};

package/dist/dtmfCollector.d.ts

@@ -0,0 +1,37 @@
+export type VoiceDTMFDigit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "*" | "#";
+export declare const VOICE_DTMF_DIGITS: readonly VoiceDTMFDigit[];
+export type VoiceDTMFCollectorState = {
+    status: "collecting";
+    digits: string;
+} | {
+    status: "completed";
+    digits: string;
+    reason: "length" | "terminator";
+} | {
+    status: "cancelled";
+    digits: string;
+} | {
+    status: "rejected";
+    digits: string;
+    reason: "invalid" | "timeout" | "too-short";
+};
+export type CreateVoiceDTMFCollectorOptions = {
+    prompt: string;
+    minLength?: number;
+    maxLength?: number;
+    terminator?: VoiceDTMFDigit | null;
+    timeoutMs?: number;
+    interDigitTimeoutMs?: number;
+    validator?: (digits: string) => boolean | string;
+    now?: () => number;
+};
+export declare const collectVoiceDTMFInput: (options: CreateVoiceDTMFCollectorOptions) => {
+    cancel(): VoiceDTMFCollectorState;
+    feed(digit: string, at?: number): VoiceDTMFCollectorState;
+    getState: () => VoiceDTMFCollectorState;
+    prompt: string;
+    subscribe(listener: (state: VoiceDTMFCollectorState) => void): () => void;
+    tick(at?: number): VoiceDTMFCollectorState;
+};
+export type VoiceDTMFCollector = ReturnType<typeof collectVoiceDTMFInput>;
+export declare const validateVoiceDTMFLuhn: (digits: string) => boolean;

package/dist/holdAudio.d.ts

@@ -0,0 +1,23 @@
+export type VoiceHoldAudioCue = {
+    audioUrl?: string;
+    metadata?: Record<string, unknown>;
+    text?: string;
+};
+export type VoiceHoldAudioDriverOptions = {
+    /** Cooldown between hold cues so we don't spam the caller. Default 4_000ms. */
+    cooldownMs?: number;
+    /** Cues to play. Picked in order; cycles back to start. */
+    cues?: ReadonlyArray<VoiceHoldAudioCue>;
+    /** Operator callback invoked when a cue is selected. Wire to TTS or a pre-rendered clip. */
+    onCue: (cue: VoiceHoldAudioCue) => Promise<void> | void;
+    /** Minimum agent-thinking duration before the first cue fires. Default 1_500ms. */
+    thinkingThresholdMs?: number;
+};
+export type VoiceHoldAudioDriver = {
+    /** Note that the agent has started thinking (e.g. tool call dispatched). */
+    noteThinking: (timestampMs?: number) => void;
+    /** Note that the agent has produced output (e.g. assistant text / audio). */
+    noteResponse: (timestampMs?: number) => void;
+    reset: () => void;
+};
+export declare const createVoiceHoldAudioDriver: (options: VoiceHoldAudioDriverOptions) => VoiceHoldAudioDriver;

package/dist/iceServers.d.ts

@@ -0,0 +1,34 @@
+export type VoiceIceServer = {
+    credential?: string;
+    urls: string | string[];
+    username?: string;
+};
+export type CreateCoturnIceServersInput = {
+    /** TURN realm. */
+    realm: string;
+    /** Credential TTL in seconds. Default 3600. */
+    ttlSec?: number;
+    /** Coturn shared secret (use_auth_secret). */
+    sharedSecret: string;
+    /** TURN endpoint host:port (e.g. 'turn.example.com:3478'). */
+    turnHost: string;
+    /** Username to derive ephemeral credential for. */
+    username: string;
+    /** Optional STUN endpoints to prepend. Default ['stun:stun.l.google.com:19302']. */
+    stunUrls?: string[];
+    /** UTC unix-seconds NOW override for testing. */
+    now?: number;
+    /** SHA-1 HMAC implementation for testing. Defaults to crypto.subtle. */
+    hmacSha1Base64?: (key: string, message: string) => Promise<string>;
+};
+/**
+ * Builds an iceServers array using the coturn `use-auth-secret` REST API
+ * pattern: username = `${expires}:${callerId}`, credential = HMAC-SHA1(secret, username) base64-encoded.
+ */
+export declare const createCoturnIceServers: (input: CreateCoturnIceServersInput) => Promise<VoiceIceServer[]>;
+export type CreateTwilioNTSIceServersInput = {
+    accountSid: string;
+    authToken: string;
+    fetch?: typeof fetch;
+};
+export declare const createTwilioNTSIceServers: (input: CreateTwilioNTSIceServersInput) => Promise<VoiceIceServer[]>;

package/dist/index.d.ts

@@ -289,4 +289,16 @@ export { buildVoiceMultilingualProofReadinessCheck, renderVoiceMultilingualProof
 export type { VoiceMultilingualLanguageCode, VoiceMultilingualProofAdapterEntry, VoiceMultilingualProofAdapterReport, VoiceMultilingualProofDefaultThresholds, VoiceMultilingualProofLanguageMetrics, VoiceMultilingualProofLanguageReport, VoiceMultilingualProofLanguageThresholds, VoiceMultilingualProofOptions, VoiceMultilingualProofReadinessCheck, VoiceMultilingualProofReadinessOptions, VoiceMultilingualProofReport, } from "./multilingualProof";
 export { buildVoiceMonitorPlan, createVoiceInMemoryMonitorRegistry, createVoiceLiveMonitorRoutes, createVoiceMonitorRuntimeBinding, createVoiceMonitorSession, } from "./monitor";
 export type { VoiceMonitorAudioEvent, VoiceMonitorAudioSource, VoiceMonitorAuthenticate, VoiceMonitorAuthenticateInput, VoiceMonitorControlAck, VoiceMonitorControlHandler, VoiceMonitorControlHandlerInput, VoiceMonitorControlMessage, VoiceMonitorMutableRegistry, VoiceMonitorPlan, VoiceMonitorPlanInput, VoiceMonitorRegistry, VoiceMonitorRegistryRegisterInput, VoiceLiveMonitorRoutesOptions, VoiceMonitorRuntimeBindingOptions, VoiceMonitorSessionRecord, } from "./monitor";
+export { compareVoiceCostScenarios, predictVoiceCallCost, } from "./costPredictor";
+export type { PredictVoiceCallCostInput, VoiceCostPrediction, VoiceCostProfile, VoiceCostScenarioComparison, } from "./costPredictor";
+export { createCoturnIceServers, createTwilioNTSIceServers, } from "./iceServers";
+export type { CreateCoturnIceServersInput, CreateTwilioNTSIceServersInput, VoiceIceServer, } from "./iceServers";
+export { createVoiceHoldAudioDriver } from "./holdAudio";
+export type { VoiceHoldAudioCue, VoiceHoldAudioDriver, VoiceHoldAudioDriverOptions, } from "./holdAudio";
+export { createVoicePromptInjectionGuard, DEFAULT_VOICE_PROMPT_INJECTION_RULES, } from "./promptInjectionGuard";
+export type { VoicePromptInjectionRule, VoicePromptInjectionVerdict, VoicePromptInjectionGuard, CreateVoicePromptInjectionGuardOptions, } from "./promptInjectionGuard";
+export { createVoicePostCallSurvey, DEFAULT_VOICE_POST_CALL_SURVEY_QUESTIONS, summarizeVoicePostCallSurveys, } from "./postCallSurvey";
+export type { VoicePostCallSurvey, VoicePostCallSurveyAnswer, VoicePostCallSurveyQuestion, VoicePostCallSurveyResponse, CreateVoicePostCallSurveyOptions, } from "./postCallSurvey";
+export { collectVoiceDTMFInput, validateVoiceDTMFLuhn, VOICE_DTMF_DIGITS, } from "./dtmfCollector";
+export type { VoiceDTMFCollector, VoiceDTMFCollectorState, VoiceDTMFDigit, CreateVoiceDTMFCollectorOptions, } from "./dtmfCollector";
 export * from "./types";