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

package/dist/client/agentSquadStatus.d.ts

@@ -0,0 +1,37 @@
+import type { VoiceTraceTimelineReport } from "../core/traceTimeline";
+import { type VoiceTraceTimelineClientOptions } from "./traceTimeline";
+export type VoiceAgentSquadSpecialistStatus = "active" | "blocked" | "handoff" | "idle" | "unknown-target";
+export type VoiceAgentSquadSpecialist = {
+    fromAgentId?: string;
+    lastEventAt?: number;
+    reason?: string;
+    sessionId: string;
+    status: VoiceAgentSquadSpecialistStatus;
+    summary?: string;
+    targetAgentId?: string;
+    turnId?: string;
+};
+export type VoiceAgentSquadStatusReport = {
+    active: VoiceAgentSquadSpecialist[];
+    checkedAt?: number;
+    current?: VoiceAgentSquadSpecialist;
+    sessionCount: number;
+    sessions: VoiceAgentSquadSpecialist[];
+};
+export type VoiceAgentSquadStatusSnapshot = {
+    error: string | null;
+    isLoading: boolean;
+    report: VoiceAgentSquadStatusReport;
+    updatedAt?: number;
+};
+export type VoiceAgentSquadStatusClientOptions = VoiceTraceTimelineClientOptions & {
+    sessionId?: string;
+};
+export declare const buildVoiceAgentSquadStatusReport: (timeline: VoiceTraceTimelineReport | null | undefined, options?: Pick<VoiceAgentSquadStatusClientOptions, "sessionId">) => VoiceAgentSquadStatusReport;
+export declare const createVoiceAgentSquadStatusStore: (path?: string, options?: VoiceAgentSquadStatusClientOptions) => {
+    close: () => void;
+    getServerSnapshot: () => VoiceAgentSquadStatusSnapshot;
+    getSnapshot: () => VoiceAgentSquadStatusSnapshot;
+    refresh: () => Promise<VoiceTraceTimelineReport | null>;
+    subscribe: (listener: () => void) => () => void;
+};

package/dist/client/agentSquadStatusWidget.d.ts

@@ -0,0 +1,24 @@
+import { type VoiceAgentSquadSpecialist, type VoiceAgentSquadStatusClientOptions, type VoiceAgentSquadStatusSnapshot } from "./agentSquadStatus";
+export type VoiceAgentSquadStatusViewModel = {
+    current?: VoiceAgentSquadSpecialist;
+    description: string;
+    error: string | null;
+    isLoading: boolean;
+    label: string;
+    sessionCount: number;
+    sessions: VoiceAgentSquadSpecialist[];
+    title: string;
+    updatedAt?: number;
+};
+export type VoiceAgentSquadStatusWidgetOptions = VoiceAgentSquadStatusClientOptions & {
+    description?: string;
+    title?: string;
+};
+export declare const createVoiceAgentSquadStatusViewModel: (snapshot: VoiceAgentSquadStatusSnapshot, options?: VoiceAgentSquadStatusWidgetOptions) => VoiceAgentSquadStatusViewModel;
+export declare const defineVoiceAgentSquadStatusElement: (tagName?: string, options?: VoiceAgentSquadStatusWidgetOptions) => void;
+export declare const getVoiceAgentSquadStatusCSS: () => string;
+export declare const mountVoiceAgentSquadStatus: (element: Element | null, path?: string, options?: VoiceAgentSquadStatusWidgetOptions) => {
+    refresh: () => Promise<import("..").VoiceTraceTimelineReport | null>;
+    close: () => void;
+};
+export declare const renderVoiceAgentSquadStatusHTML: (snapshot: VoiceAgentSquadStatusSnapshot, options?: VoiceAgentSquadStatusWidgetOptions) => string;

package/dist/client/audioPlayer.d.ts

@@ -1,4 +1,4 @@
-import type { AudioFormat, VoiceAudioPlayer, VoiceAudioPlayerOptions, VoiceAudioPlayerSource } from '../types';
+import type { AudioFormat, VoiceAudioPlayer, VoiceAudioPlayerOptions, VoiceAudioPlayerSource } from "../core/types";
 type MinimalAudioBuffer = {
     duration: number;
     getChannelData: (channel: number) => Float32Array;
@@ -29,7 +29,7 @@ type MinimalAudioContext = {
     destination: unknown;
     outputLatency?: number;
     resume: () => Promise<void>;
-    state: 'closed' | 'running' | 'suspended';
+    state: "closed" | "running" | "suspended";
     suspend: () => Promise<void>;
 };
 export declare const createVoiceAudioPlayer: (source: VoiceAudioPlayerSource, options?: VoiceAudioPlayerOptions) => VoiceAudioPlayer;

package/dist/client/bargeInMonitor.d.ts

@@ -0,0 +1,7 @@
+import type { VoiceBargeInMonitor } from "../core/types";
+export type VoiceBargeInMonitorOptions = {
+    fetch?: typeof fetch;
+    path?: string;
+    thresholdMs?: number;
+};
+export declare const createVoiceBargeInMonitor: (options?: VoiceBargeInMonitorOptions) => VoiceBargeInMonitor;

package/dist/client/browserMedia.d.ts

@@ -0,0 +1,8 @@
+import type { VoiceBrowserMediaReporterOptions, VoiceBrowserMediaReportPayload } from "../core/types";
+export type VoiceBrowserMediaReporter = {
+    close: () => void;
+    reportOnce: () => Promise<VoiceBrowserMediaReportPayload | undefined>;
+    start: () => void;
+    stop: () => void;
+};
+export declare const createVoiceBrowserMediaReporter: (options: VoiceBrowserMediaReporterOptions) => VoiceBrowserMediaReporter;

package/dist/client/browserNoiseSuppression.d.ts

@@ -0,0 +1,42 @@
+export type BrowserNoiseSuppressorOptions = {
+    /** Existing AudioContext to reuse. If omitted, a fresh one is created at 48kHz. */
+    audioContext?: AudioContext;
+    /** Optional message sent to the worklet via port.postMessage on init. */
+    initialPort?: Record<string, unknown>;
+    /** AudioWorkletNode options forwarded to the constructor. */
+    nodeOptions?: AudioWorkletNodeOptions;
+    /** Registered AudioWorkletProcessor name to instantiate. */
+    processorName: string;
+    /** Caller-supplied input stream from getUserMedia or similar. */
+    stream: MediaStream;
+    /** URL of the AudioWorklet script that registers `processorName`. */
+    workletUrl: string;
+};
+export type BrowserNoiseSuppressorHandle = {
+    /** The worklet node — operators can postMessage to tune at runtime. */
+    node: AudioWorkletNode;
+    /** A MediaStream containing the denoised audio track. */
+    stream: MediaStream;
+    /** Tears down the worklet + closes the AudioContext when this helper created it. */
+    stop: () => Promise<void>;
+};
+export declare const applyBrowserNoiseSuppression: (options: BrowserNoiseSuppressorOptions) => Promise<BrowserNoiseSuppressorHandle>;
+export type BrowserNoiseSuppressorPreset = {
+    initialPort?: Record<string, unknown>;
+    /** Display label for UI affordances. */
+    label: string;
+    nodeOptions?: AudioWorkletNodeOptions;
+    processorName: string;
+    workletUrl: string;
+};
+/**
+ * Convenience presets pointing at well-known open-source worklets. Operators
+ * still install the underlying npm package and copy the worklet file to a
+ * URL their site can serve.
+ */
+export declare const BROWSER_NOISE_SUPPRESSOR_PRESETS: {
+    /** DeepFilterNet 2023 model — best quality open-source pick. */
+    readonly deepfilternet: (workletUrl: string) => BrowserNoiseSuppressorPreset;
+    /** Jitsi @jitsi/rnnoise-wasm — ships a `rnnoise-processor` worklet. */
+    readonly rnnoise: (workletUrl: string) => BrowserNoiseSuppressorPreset;
+};

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 checkBrowserVoiceSupport: (globalScope?: typeof globalThis) => BrowserVoiceSupportReport;
+export declare const probeBrowserVoiceSupport: (globalScope?: typeof globalThis) => BrowserVoiceSupportProbe;

package/dist/client/callDebugger.d.ts

@@ -0,0 +1,21 @@
+import type { VoiceCallDebuggerReport } from "../core/callDebugger";
+import { type VoiceReactiveSource } from "./reactiveSource";
+export type VoiceCallDebuggerClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+    reactiveSource?: VoiceReactiveSource;
+};
+export type VoiceCallDebuggerClientState = {
+    error: string | null;
+    isLoading: boolean;
+    report?: VoiceCallDebuggerReport;
+    updatedAt?: number;
+};
+export declare const createVoiceCallDebuggerStore: (path: string, options?: VoiceCallDebuggerClientOptions) => {
+    close: () => void;
+    refresh: () => Promise<VoiceCallDebuggerReport | undefined>;
+    getServerSnapshot: () => VoiceCallDebuggerClientState;
+    getSnapshot: () => VoiceCallDebuggerClientState;
+    subscribe: (listener: () => void) => () => void;
+};
+export declare const fetchVoiceCallDebugger: (path: string, options?: Pick<VoiceCallDebuggerClientOptions, "fetch">) => Promise<VoiceCallDebuggerReport>;

package/dist/client/callDebuggerWidget.d.ts

@@ -0,0 +1,30 @@
+import { type VoiceCallDebuggerClientOptions, type VoiceCallDebuggerClientState } from "./callDebugger";
+export type VoiceCallDebuggerLaunchViewModel = {
+    description: string;
+    error: string | null;
+    href: string;
+    isLoading: boolean;
+    label: string;
+    rows: Array<{
+        label: string;
+        value: string;
+    }>;
+    status: "empty" | "error" | "loading" | "ready" | "warning";
+    title: string;
+    updatedAt?: number;
+};
+export type VoiceCallDebuggerLaunchOptions = VoiceCallDebuggerClientOptions & {
+    description?: string;
+    href?: string | ((input: {
+        report?: VoiceCallDebuggerClientState["report"];
+    }) => string);
+    linkLabel?: string;
+    title?: string;
+};
+export declare const createVoiceCallDebuggerLaunchViewModel: (path: string, state: VoiceCallDebuggerClientState, options?: VoiceCallDebuggerLaunchOptions) => VoiceCallDebuggerLaunchViewModel;
+export declare const defineVoiceCallDebuggerLaunchElement: (tagName?: string) => void;
+export declare const mountVoiceCallDebuggerLaunch: (element: Element, path: string, options?: VoiceCallDebuggerLaunchOptions) => {
+    refresh: () => Promise<import("..").VoiceCallDebuggerReport | undefined>;
+    close: () => void;
+};
+export declare const renderVoiceCallDebuggerLaunchHTML: (path: string, state: VoiceCallDebuggerClientState, options?: VoiceCallDebuggerLaunchOptions) => string;

package/dist/client/callPlayer.d.ts

@@ -0,0 +1,41 @@
+import type { Transcript } from "../core/types";
+export type VoiceCallPlayerState = {
+    activeTranscriptId?: string;
+    activeTranscriptIndex?: number;
+    audioUrl?: string;
+    buffered: number;
+    currentTimeMs: number;
+    durationMs: number;
+    error?: string;
+    isPlaying: boolean;
+    isReady: boolean;
+    playbackRate: number;
+};
+export type VoiceCallPlayerOptions = {
+    audioUrl?: string;
+    initialPlaybackRate?: number;
+    /** Recording start in epoch ms; used to convert transcript epoch timestamps to playback offsets. */
+    recordingStartedAtEpochMs?: number;
+    transcripts?: ReadonlyArray<Transcript>;
+};
+export type VoiceCallPlayer = {
+    getState: () => VoiceCallPlayerState;
+    pause: () => void;
+    play: () => Promise<void>;
+    reset: () => void;
+    seekMs: (positionMs: number) => void;
+    seekToTranscript: (transcriptId: string) => void;
+    setAudioUrl: (url: string | undefined) => void;
+    setBuffered: (seconds: number) => void;
+    setDuration: (durationMs: number) => void;
+    setError: (error: string | undefined) => void;
+    setPlaybackRate: (rate: number) => void;
+    setPlaying: (playing: boolean) => void;
+    setReady: (ready: boolean) => void;
+    setTime: (positionMs: number) => void;
+    setTranscripts: (transcripts: ReadonlyArray<Transcript>) => void;
+    subscribe: (listener: () => void) => () => void;
+    transcripts: () => ReadonlyArray<Transcript>;
+};
+export declare const createVoiceCallPlayer: (options?: VoiceCallPlayerOptions) => VoiceCallPlayer;
+export declare const formatVoiceCallPlayerTimestamp: (ms: number) => string;

package/dist/client/campaignDialerProof.d.ts

@@ -0,0 +1,25 @@
+import type { VoiceCampaignDialerProofReport, VoiceCampaignDialerProofStatus } from "../core/campaignDialers";
+import { type VoiceReactiveSource } from "./reactiveSource";
+export type VoiceCampaignDialerProofClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+    reactiveSource?: VoiceReactiveSource;
+    runPath?: string;
+};
+export type VoiceCampaignDialerProofSnapshot = {
+    error: string | null;
+    isLoading: boolean;
+    report?: VoiceCampaignDialerProofReport;
+    status?: VoiceCampaignDialerProofStatus;
+    updatedAt?: number;
+};
+export declare const createVoiceCampaignDialerProofStore: (path?: string, options?: VoiceCampaignDialerProofClientOptions) => {
+    close: () => void;
+    refresh: () => Promise<VoiceCampaignDialerProofStatus | undefined>;
+    runProof: () => Promise<VoiceCampaignDialerProofReport>;
+    getServerSnapshot: () => VoiceCampaignDialerProofSnapshot;
+    getSnapshot: () => VoiceCampaignDialerProofSnapshot;
+    subscribe: (listener: () => void) => () => void;
+};
+export declare const fetchVoiceCampaignDialerProofStatus: (path?: string, options?: Pick<VoiceCampaignDialerProofClientOptions, "fetch">) => Promise<VoiceCampaignDialerProofStatus>;
+export declare const runVoiceCampaignDialerProofAction: (path?: string, options?: Pick<VoiceCampaignDialerProofClientOptions, "fetch">) => Promise<VoiceCampaignDialerProofReport>;

package/dist/client/connection.d.ts

@@ -1,8 +1,8 @@
-import type { VoiceClientMessage, VoiceConnectionOptions, VoiceServerMessage } from '../types';
+import type { VoiceClientMessage, VoiceConnectionOptions, VoiceServerMessage } from "../core/types";
 type VoiceConnectionHandle = {
     callControl: (message: Omit<VoiceClientMessage & {
-        type: 'call_control';
-    }, 'type'>) => void;
+        type: "call_control";
+    }, "type">) => void;
     start: (input?: {
         sessionId?: string;
         scenarioId?: string;
@@ -14,6 +14,7 @@ type VoiceConnectionHandle = {
     getSessionId: () => string;
     send: (message: VoiceClientMessage) => void;
     sendAudio: (audio: Uint8Array | ArrayBuffer) => void;
+    simulateDisconnect: () => void;
     subscribe: (callback: (message: VoiceServerMessage) => void) => () => void;
 };
 export declare const createVoiceConnection: (path: string, options?: VoiceConnectionOptions) => VoiceConnectionHandle;

package/dist/client/controller.d.ts

@@ -1,2 +1,2 @@
-import type { VoiceController, VoiceControllerOptions } from '../types';
+import type { VoiceController, VoiceControllerOptions } from "../core/types";
 export declare const createVoiceController: <TResult = unknown>(path: string, options?: VoiceControllerOptions) => VoiceController<TResult>;

package/dist/client/conversationAnalytics.d.ts

@@ -0,0 +1,30 @@
+import type { StoredVoiceTraceEvent } from "../core/trace";
+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;
+export {};

package/dist/client/costDashboard.d.ts

@@ -0,0 +1,27 @@
+import type { StoredVoiceTraceEvent } from "../core/trace";
+export type VoiceCostDashboardBucket = {
+    bucketKey: string;
+    callCount: number;
+    llmUsd: number;
+    sttUsd: number;
+    telephonyMinutes: number;
+    telephonyUsd: number;
+    totalUsd: number;
+    ttsUsd: number;
+};
+export type VoiceCostDashboardReport = {
+    buckets: VoiceCostDashboardBucket[];
+    generatedAt: number;
+    grandTotal: VoiceCostDashboardBucket;
+    windowEndMs: number;
+    windowStartMs: number;
+};
+export type VoiceCostDashboardOptions = {
+    bucketBy?: "day" | "hour" | "month";
+    events: ReadonlyArray<StoredVoiceTraceEvent>;
+    /** Inclusive bucket start filter, epoch ms. */
+    fromMs?: number;
+    /** Inclusive bucket end filter, epoch ms. */
+    toMs?: number;
+};
+export declare const buildVoiceCostDashboardReport: (options: VoiceCostDashboardOptions) => VoiceCostDashboardReport;

package/dist/client/createVoiceStream.d.ts

@@ -1,2 +1,2 @@
-import type { VoiceConnectionOptions, VoiceStream } from '../types';
+import type { VoiceConnectionOptions, VoiceStream } from "../core/types";
 export declare const createVoiceStream: <TResult = unknown>(path: string, options?: VoiceConnectionOptions) => VoiceStream<TResult>;

package/dist/client/deliveryRuntime.d.ts

@@ -0,0 +1,36 @@
+import type { VoiceDeliveryRuntimeReport } from "../core/deliveryRuntime";
+import { type VoiceReactiveSource } from "./reactiveSource";
+export type VoiceDeliveryRuntimeClientOptions = {
+    fetch?: typeof fetch;
+    intervalMs?: number;
+    reactiveSource?: VoiceReactiveSource;
+    requeueDeadLettersPath?: string;
+    tickPath?: string;
+};
+export type VoiceDeliveryRuntimeSnapshot = {
+    actionError: string | null;
+    actionStatus: "idle" | "running" | "completed" | "failed";
+    error: string | null;
+    isLoading: boolean;
+    lastAction?: VoiceDeliveryRuntimeActionResult;
+    report?: VoiceDeliveryRuntimeReport;
+    updatedAt?: number;
+};
+export type VoiceDeliveryRuntimeAction = "tick" | "requeue-dead-letters";
+export type VoiceDeliveryRuntimeActionResult = {
+    action: VoiceDeliveryRuntimeAction;
+    result?: unknown;
+    summary?: VoiceDeliveryRuntimeReport["summary"];
+    updatedAt: number;
+};
+export declare const createVoiceDeliveryRuntimeStore: (path?: string, options?: VoiceDeliveryRuntimeClientOptions) => {
+    close: () => void;
+    refresh: () => Promise<VoiceDeliveryRuntimeReport | undefined>;
+    getServerSnapshot: () => VoiceDeliveryRuntimeSnapshot;
+    getSnapshot: () => VoiceDeliveryRuntimeSnapshot;
+    requeueDeadLetters: () => Promise<VoiceDeliveryRuntimeActionResult | undefined>;
+    subscribe: (listener: () => void) => () => void;
+    tick: () => Promise<VoiceDeliveryRuntimeActionResult | undefined>;
+};
+export declare const fetchVoiceDeliveryRuntime: (path?: string, options?: Pick<VoiceDeliveryRuntimeClientOptions, "fetch">) => Promise<VoiceDeliveryRuntimeReport>;
+export declare const runVoiceDeliveryRuntimeAction: (action: VoiceDeliveryRuntimeAction, path?: string, options?: VoiceDeliveryRuntimeClientOptions) => Promise<VoiceDeliveryRuntimeActionResult>;

package/dist/client/deliveryRuntimeWidget.d.ts

@@ -0,0 +1,37 @@
+import { type VoiceDeliveryRuntimeClientOptions, type VoiceDeliveryRuntimeSnapshot } from "./deliveryRuntime";
+export type VoiceDeliveryRuntimeSurfaceView = {
+    deadLettered: number;
+    detail: string;
+    failed: number;
+    id: "audit" | "trace";
+    label: string;
+    pending: number;
+    status: "pass" | "warn" | "disabled";
+    total: number;
+};
+export type VoiceDeliveryRuntimeViewModel = {
+    description: string;
+    error: string | null;
+    actionError: string | null;
+    actionStatus: VoiceDeliveryRuntimeSnapshot["actionStatus"];
+    isLoading: boolean;
+    isRunning: boolean;
+    label: string;
+    status: "pass" | "warn" | "loading" | "error";
+    surfaces: VoiceDeliveryRuntimeSurfaceView[];
+    title: string;
+    updatedAt?: number;
+};
+export type VoiceDeliveryRuntimeWidgetOptions = VoiceDeliveryRuntimeClientOptions & {
+    description?: string;
+    includeActions?: boolean;
+    title?: string;
+};
+export declare const createVoiceDeliveryRuntimeViewModel: (snapshot: VoiceDeliveryRuntimeSnapshot, options?: VoiceDeliveryRuntimeWidgetOptions) => VoiceDeliveryRuntimeViewModel;
+export declare const defineVoiceDeliveryRuntimeElement: (tagName?: string) => void;
+export declare const getVoiceDeliveryRuntimeCSS: () => string;
+export declare const mountVoiceDeliveryRuntime: (element: Element, path?: string, options?: VoiceDeliveryRuntimeWidgetOptions) => {
+    refresh: () => Promise<import("..").VoiceDeliveryRuntimeReport | undefined>;
+    close: () => void;
+};
+export declare const renderVoiceDeliveryRuntimeHTML: (snapshot: VoiceDeliveryRuntimeSnapshot, options?: VoiceDeliveryRuntimeWidgetOptions) => string;

package/dist/client/duplex.d.ts

@@ -1,3 +1,3 @@
-import type { VoiceAudioPlayer, VoiceBargeInBinding, VoiceBargeInOptions, VoiceController, VoiceDuplexController, VoiceDuplexControllerOptions } from '../types';
-export declare const bindVoiceBargeIn: <TResult = unknown>(controller: Pick<VoiceController<TResult>, "partial" | "sendAudio" | "subscribe">, player: Pick<VoiceAudioPlayer, "interrupt" | "isPlaying">, options?: VoiceBargeInOptions) => VoiceBargeInBinding;
+import type { VoiceAudioPlayer, VoiceBargeInBinding, VoiceBargeInOptions, VoiceController, VoiceDuplexController, VoiceDuplexControllerOptions } from "../core/types";
+export declare const bindVoiceBargeIn: <TResult = unknown>(controller: Pick<VoiceController<TResult>, "partial" | "sendAudio" | "sessionId" | "subscribe">, player: Pick<VoiceAudioPlayer, "interrupt" | "isPlaying" | "lastInterruptLatencyMs" | "lastPlaybackStopLatencyMs">, options?: VoiceBargeInOptions) => VoiceBargeInBinding;
 export declare const createVoiceDuplexController: <TResult = unknown>(path: string, options?: VoiceDuplexControllerOptions) => VoiceDuplexController<TResult>;

package/dist/client/htmx.d.ts

@@ -1,2 +1,2 @@
-import type { VoiceHTMXBindingOptions, VoiceStream } from '../types';
+import type { VoiceHTMXBindingOptions, VoiceStream } from "../core/types";
 export declare const bindVoiceHTMX: <TResult = unknown>(stream: VoiceStream<TResult>, options: VoiceHTMXBindingOptions) => () => void;

package/dist/client/htmxAttributes.d.ts

@@ -0,0 +1,24 @@
+export type VoiceHTMXPollingAttributes = {
+    /** Set true to emit hx-get/hx-trigger when refreshUrl is also provided. */
+    poll?: boolean;
+    /** Polling cadence. Default 5_000ms. Clamped to >= 1_000ms. */
+    pollIntervalMs?: number;
+    /** Extra HTMX attributes to splice in. Keys without the 'hx-' prefix have it added. */
+    pushAttributes?: Record<string, string>;
+    /** URL hx-get fires against. Without it, polling is skipped. */
+    refreshUrl?: string;
+    /** hx-swap value. Default 'outerHTML'. */
+    swap?: string;
+    /** Optional hx-target selector. */
+    target?: string;
+};
+export declare const buildVoiceHTMXAttributes: (attrs: VoiceHTMXPollingAttributes | undefined) => string;
+/**
+ * Injects HTMX polling attributes into the first opening tag of an HTML string.
+ * Returns the original HTML unchanged when attrs produce no attributes.
+ */
+export declare const wrapVoiceHTMLInHTMXContainer: (html: string, attrs: VoiceHTMXPollingAttributes & {
+    className?: string;
+    elementTag?: string;
+}) => string;
+export declare const wrapVoiceHTMLWithHTMXPolling: (html: string, attrs: VoiceHTMXPollingAttributes | undefined) => string;