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

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/voice",
-  "version": "0.0.22-beta.506",
+  "version": "0.0.22-beta.507",
   "description": "Voice primitives and Elysia plugin for AbsoluteJS",
   "repository": {
     "type": "git",