@voctiv/agent-sdk 0.1.0

package/dist/define-script.d.ts

@@ -0,0 +1,294 @@
+import type { Observable } from 'rxjs';
+import { MediaChannel } from './types/media-channel';
+import { ScriptLogger } from './types/logger';
+import type { NluExtractOptions, NluInferResult } from './types/nlu';
+/**
+ * NLU (Natural Language Understanding) API.
+ *
+ * Provides intent/entity extraction from user utterances.
+ * Compatible with logic-executor `nn.extract()`.
+ */
+export interface NluScriptApi {
+    /**
+     * Extract intents and entities from text.
+     * @param utterance - User input text to analyze.
+     * @param options - Filter by specific intents/entities, add context, etc.
+     * @returns Parsed NLU result with intents, entities, and confidence scores.
+     */
+    extract(utterance: string, options?: NluExtractOptions): Promise<NluInferResult>;
+    /**
+     * Same as {@link extract} but returns an RxJS Observable
+     * (useful for streaming pipelines).
+     */
+    extract$(utterance: string, options?: NluExtractOptions): Observable<NluInferResult>;
+}
+/**
+ * Typed first-level dialog context passed to every script.
+ * Contains all metadata about the current session: caller info,
+ * script identity, routing params, and legacy compat fields.
+ *
+ * Index signature allows arbitrary extra fields for forward compat.
+ */
+export interface ScriptDialogContext {
+    /** Short language code, e.g. `"ru"`, `"en"`. */
+    lang: string;
+    /** Full BCP-47 language tag, e.g. `"ru-RU"`, `"en-US"`. */
+    language: string;
+    /** Business flag for routing (e.g. `"default"`, `"vip"`). */
+    flag: string;
+    /** Unique dialog identifier (UUID). */
+    dialogUuid: string;
+    /** Caller phone number or messaging source ID. */
+    msisdn: string;
+    /** Inbound caller ID (same as msisdn for inbound calls). */
+    callerId: string;
+    /** Called number (DID / destination for inbound calls). */
+    destinationNumber: string;
+    /** Script record ID in the system. */
+    scriptId: string;
+    /** Human-readable script name. */
+    scriptName: string;
+    /** Agent UUID from Omni platform (links script to an NLU agent). */
+    agentUuid?: string;
+    /** Numeric NLU agent ID used for extract() calls. */
+    agentId: number;
+    /** Original params snapshot at session start (immutable). */
+    initialParams: Record<string, unknown>;
+    /** Mutable merged params (channel + session + route). */
+    params: Record<string, unknown>;
+    /** Whether legacy V3 compatibility mode is active. */
+    legacyV3Compat: boolean;
+    /** `true` when the script runs without a real media channel (offline / queue / messaging). */
+    headless: boolean;
+    /**
+     * Persisted script environment — survives between calls within the same dialog.
+     *
+     * **Reading:** On each call the system loads `env` from Redis (`dialog:{uuid}`, TTL 7 days)
+     * and injects it here. On the very first call `env` is `undefined`.
+     *
+     * **Writing (success path):** Return `{ env: { ... } }` from the script to persist
+     * a new snapshot:
+     * ```ts
+     * return { env: { step: 2, collected: true } };
+     * ```
+     *
+     * **Writing (mutation):** You can also mutate `context.env` directly during execution.
+     * If the script crashes or doesn't return an explicit `env`, the system reads the
+     * current value of `context.env` and persists it anyway — so partial progress is never lost.
+     *
+     * **Priority:** Explicit `return { env }` wins over mutations to `context.env`.
+     *
+     * **On error:** `env` is still saved (both mutation and return value are respected),
+     * and the {@link ScriptResult.error} field is populated alongside it.
+     *
+     * **Storage:** Redis key `dialog:{dialogUuid}`, JSON-serialized, TTL 7 days.
+     * Only active in legacy V3 compatibility mode.
+     */
+    env?: Record<string, unknown>;
+    /** Raw `dialog` table row from legacy DB. */
+    dialogEntity?: Record<string, unknown>;
+    /** Raw `call` table row from legacy DB. */
+    callEntity?: Record<string, unknown>;
+    /** Available TTS/ASR media key identifiers (legacy compat). */
+    availableMediaKeys?: string[];
+    /** Script entry point for routing (e.g. `"on_recall"`, `"on_message_api_received"`). */
+    entryPoint?: string;
+    /** Current recall attempt number (starts at 0). */
+    attempt?: number;
+    /** Max recall attempts configured for this dialog. */
+    recallCount?: number;
+    /** Delay in seconds between recall attempts. */
+    recallDelay?: number;
+    /** Inbound message that triggered this headless session (messaging). */
+    inboundMessage?: InboundMessage;
+    /** @internal NLU runtime config — opaque to scripts. */
+    _nlu?: unknown;
+    [key: string]: unknown;
+}
+/** Error info attached to {@link ScriptResult} when a script fails. */
+export interface ScriptError {
+    /** Error category: `"script_error"` | `"server_error"` (mirrors old LE stat names). */
+    code: string;
+    /** Human-readable error description. */
+    message: string;
+    /** Stack trace (when available). */
+    stack?: string;
+}
+/**
+ * Value returned by a script function.
+ *
+ * - `env` — persisted in Redis between calls within the same dialog (legacy compat).
+ * - `output` — written to `dialog_stats` (equivalent of old LE `nn.dump`).
+ * - `error` — set automatically when the script throws; can also be set manually.
+ */
+export interface ScriptResult {
+    /** Script environment to persist for the next call in this dialog. */
+    env?: Record<string, unknown>;
+    /** Output data to store in dialog_stats. */
+    output?: Record<string, unknown>;
+    /** Error details (auto-populated on script crash, or set manually). */
+    error?: ScriptError;
+}
+/** Options for scheduling an outbound call via {@link PlatformApi.call}. */
+export interface ScheduleCallOptions {
+    /** When to place the call. Defaults to now. */
+    date?: string | Date;
+    /** Deadline — don't call after this time. */
+    dateEnd?: string | Date;
+    /** Entry point to pass to the script when the call connects. */
+    entryPoint?: string;
+    /** Override script name/path for the outbound call. */
+    script?: string;
+    /** SIP channel/trunk name override. */
+    channel?: string;
+    /** How many times to retry on failure. */
+    recallCount?: number;
+    /** Delay in seconds between retries. */
+    recallDelay?: number;
+    /** Entry point to use after a successful call. */
+    onSuccessCall?: string;
+    /** Entry point to use after a failed call. */
+    onFailedCall?: string;
+    /** Call priority (higher = processed sooner by dialer). */
+    priority?: number;
+    /** Timezone offset (hours) for date interpretation. */
+    timezone?: number;
+    /** Extra SIP headers or protocol-level params. */
+    protoAdditional?: Record<string, string>;
+}
+/**
+ * Dialog state API — read and update dialog routing metadata.
+ *
+ * Setting `entryPoint` or `result` immediately persists the change
+ * to the legacy DB (non-blocking, fire-and-forget).
+ */
+export interface DialogApi {
+    /** Current script entry point (e.g. `"on_recall"`). Set to change routing for next call. */
+    entryPoint: string | undefined;
+    /** Dialog outcome (e.g. `"done"`, `"busy"`, `"no_answer"`). Set to finalize dialog. */
+    result: string | undefined;
+    /** Dialog UUID (read-only). */
+    readonly uuid: string;
+    /** Caller msisdn (read-only). */
+    readonly msisdn: string;
+}
+/** Options for sending an outbound message via {@link MessagingApi.send}. */
+export interface SendMessageOptions {
+    /** Sender identifier (your service ID or phone number). */
+    src: string;
+    /** Recipient identifier (phone number, user ID, etc.). */
+    destination: string;
+    /** Text body of the message. */
+    text?: string;
+    /** URL of an attachment (image, document, etc.). */
+    attachment?: string;
+    /** Quick-reply button labels. */
+    buttons?: string[];
+}
+/** Inbound message received from an external messaging channel. */
+export interface InboundMessage {
+    /** Sender identifier (who sent the message). */
+    src: string;
+    /** Recipient identifier (your service endpoint). */
+    dst: string;
+    /** Channel type, e.g. `"api"`. */
+    channelType: string;
+    /** Full raw payload from the messaging transport. */
+    payload: Record<string, unknown>;
+}
+/**
+ * Messaging API — send and receive messages through external channels.
+ *
+ * Messages are transported via Redis Streams (`ma_send` / `ma_receive`),
+ * compatible with the old LE messaging architecture.
+ */
+export interface MessagingApi {
+    /**
+     * Send an outbound message.
+     * Published to Redis stream for delivery by external consumer.
+     */
+    send(options: SendMessageOptions): Promise<void>;
+    /**
+     * Observable of inbound messages.
+     * Emits the triggering message when the script is started by an incoming message
+     * (entry point `on_message_api_received`).
+     */
+    readonly message$: Observable<InboundMessage>;
+}
+/**
+ * Platform API — legacy-compatible operations available to scripts.
+ *
+ * Provides access to NLU, dialog state management, outbound call scheduling,
+ * and messaging. Only functional in legacy V3 compatibility mode
+ * (except `nlu` which is always available).
+ */
+export interface PlatformApi {
+    /** NLU intent/entity extraction API. */
+    readonly nlu: NluScriptApi;
+    /** Dialog state — read/write entry point and result. */
+    readonly dialog: DialogApi;
+    /** Messaging API — send and receive external messages. */
+    readonly messaging: MessagingApi;
+    /**
+     * Schedule an outbound call.
+     * Creates a record in the `call` table; the dialer picks it up and originates the SIP call.
+     * @param msisdn - Destination phone number (E.164).
+     * @param options - Scheduling, routing, and retry options.
+     */
+    call(msisdn: string, options?: ScheduleCallOptions): Promise<void>;
+}
+/**
+ * Top-level context passed to every script function.
+ *
+ * @example
+ * ```ts
+ * export default defineScript(async ({ channel, logger, context, platform }) => {
+ *   logger.log('Script started', { dialog: context.dialogUuid });
+ *
+ *   // Voice interaction
+ *   await channel.audio.say('Hello!');
+ *
+ *   // NLU
+ *   const result = await platform.nlu.extract('I want to buy');
+ *
+ *   // Messaging
+ *   await platform.messaging.send({ src: 'bot', destination: '+7900...', text: 'Hi' });
+ *
+ *   // Schedule a callback
+ *   await platform.call('+7900...', { date: new Date(Date.now() + 3600000) });
+ * });
+ * ```
+ */
+export interface ScriptContext {
+    /**
+     * Media channel for voice/audio interaction (TTS, ASR, SIP, LLM).
+     * In headless mode most audio methods are no-ops.
+     */
+    channel: MediaChannel;
+    /** Structured logger — writes to system log and optionally to `dialog_stats` DB table. */
+    logger: ScriptLogger;
+    /** Dialog context with session metadata, routing params, and legacy fields. */
+    context: ScriptDialogContext;
+    /** Platform API — NLU, dialog state, messaging, outbound calls. */
+    platform: PlatformApi;
+}
+/**
+ * Script function signature.
+ * Return {@link ScriptResult} to persist env/output, or void.
+ */
+export type ScriptFn = (ctx: ScriptContext) => void | ScriptResult | Promise<void | ScriptResult>;
+/**
+ * Define a script entry point.
+ * Wrap your script function with this to enable type checking and runtime registration.
+ *
+ * @example
+ * ```ts
+ * import { defineScript } from '@lib/scripting-sdk';
+ *
+ * export default defineScript(async ({ channel, logger, context, platform }) => {
+ *   // your script logic here
+ * });
+ * ```
+ */
+export declare function defineScript(fn: ScriptFn): ScriptFn;
+//# sourceMappingURL=define-script.d.ts.map

package/dist/define-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-script.d.ts","sourceRoot":"","sources":["../src/define-script.ts"],"names":[],"mappings":"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"}

package/dist/define-script.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineScript = defineScript;
+/**
+ * Define a script entry point.
+ * Wrap your script function with this to enable type checking and runtime registration.
+ *
+ * @example
+ * ```ts
+ * import { defineScript } from '@lib/scripting-sdk';
+ *
+ * export default defineScript(async ({ channel, logger, context, platform }) => {
+ *   // your script logic here
+ * });
+ * ```
+ */
+function defineScript(fn) {
+    return fn;
+}
+//# sourceMappingURL=define-script.js.map

package/dist/define-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-script.js","sourceRoot":"","sources":["../src/define-script.ts"],"names":[],"mappings":";;AAqUA,oCAEC;AAfD;;;;;;;;;;;;GAYG;AACH,SAAgB,YAAY,CAAC,EAAY;IACvC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { defineScript } from './define-script';
+export type { ScriptContext, ScriptDialogContext, ScriptResult, ScriptError, ScriptFn, NluScriptApi, PlatformApi, DialogApi, ScheduleCallOptions, SendMessageOptions, InboundMessage, MessagingApi, } from './define-script';
+export type { ScriptLogger } from './types/logger';
+export type { MediaChannel, ChannelAudio, ChannelEvents, ChannelLlm, ChannelSip, LlmOptions, LlmStreamChunk, ExtractOptions, } from './types/media-channel';
+export type { AsrHandle, AsrConfig, AsrVadConfig, AsrSmartTurnConfig } from './types/asr-handle';
+export type { MixerQueueControl, PlayOptions, TtsStrategy, TtsVendor } from './types/mixer';
+export type { TextInput } from './types/text-input';
+export type { DtmfEvent, SipInfo, SipSignal, DataMessage, } from './types/events';
+export type { NluExtractOptions, NluInferResult } from './types/nlu';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACjG,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC5F,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EACV,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineScript = void 0;
+var define_script_1 = require("./define-script");
+Object.defineProperty(exports, "defineScript", { enumerable: true, get: function () { return define_script_1.defineScript; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA"}

package/dist/types/asr-handle.d.ts

@@ -0,0 +1,80 @@
+import { Observable } from 'rxjs';
+/** Voice Activity Detection (VAD) tuning parameters. */
+export interface AsrVadConfig {
+    /** Energy threshold to start speech detection (0.0–1.0). */
+    positiveThreshold?: number;
+    /** Energy threshold to end speech detection (0.0–1.0). */
+    negativeThreshold?: number;
+    /** Minimum consecutive speech frames to confirm speech start. */
+    minSpeechFrames?: number;
+    /** Noise floor energy level. */
+    energyFloor?: number;
+    /** Smoothing factor for noise floor estimation (0.0–1.0). */
+    noiseFloorAlpha?: number;
+    /** Frames of audio to include before detected speech start. */
+    preSpeechFrames?: number;
+    /** Silence frames after speech before confirming end-of-speech. */
+    postSpeechFrames?: number;
+}
+/** Smart turn-taking configuration — controls when to finalize ASR during conversation. */
+export interface AsrSmartTurnConfig {
+    /** Enable smart turn-taking (default: false). */
+    enabled?: boolean;
+    /** Frames of speech before starting a turn. */
+    triggerFrames?: number;
+    /** Frames to wait before retrying after a short pause. */
+    retryFrames?: number;
+    /** Max silence frames before force-finalizing the turn. */
+    maxSilenceFrames?: number;
+    /** Milliseconds to wait for confirmation after potential end-of-turn. */
+    confirmMs?: number;
+    /** Hard timeout: finalize after this many ms of silence regardless. */
+    silenceTimeoutMs?: number;
+}
+/** Configuration for creating an ASR (speech recognition) handle. */
+export interface AsrConfig {
+    /** ASR vendor / engine identifier. */
+    vendor?: string;
+    /** Recognition language (BCP-47, e.g. `"ru-RU"`). */
+    language?: string;
+    /** Vendor-specific configuration parameters. */
+    data?: Record<string, unknown>;
+    /** VAD tuning. */
+    vad?: AsrVadConfig;
+    /** Smart turn-taking tuning. */
+    smartTurn?: AsrSmartTurnConfig;
+}
+/**
+ * ASR handle — a live speech recognition session.
+ *
+ * Created via `channel.createAsr(config)`. Emits partial and final
+ * recognition results as Observables. Must be destroyed when no longer needed.
+ */
+export interface AsrHandle {
+    /** Unique handle identifier. */
+    readonly id: string;
+    /** Emits final recognition results (complete utterances). */
+    readonly result$: Observable<string>;
+    /** Emits partial (intermediate) recognition results. `isFinal` = true on last partial. */
+    readonly partial$: Observable<{
+        text: string;
+        isFinal: boolean;
+    }>;
+    /** Fires when speech is detected in the audio stream. */
+    readonly speechStart$: Observable<void>;
+    /** Fires when speech ends. */
+    readonly speechEnd$: Observable<void>;
+    /** Fires when ASR determines the user is interrupting (barge-in). */
+    readonly interrupt$: Observable<void>;
+    /** VAD probability stream (0.0–1.0) — useful for visualization. */
+    readonly vadProbability$: Observable<number>;
+    /** Temporarily pause recognition (audio is still buffered). */
+    pause(): void;
+    /** Resume recognition after pause. */
+    resume(): void;
+    /** Force-finalize the current utterance (trigger result$ immediately). */
+    finalize(): void;
+    /** Destroy this ASR handle and release all resources. */
+    destroy(): void;
+}
+//# sourceMappingURL=asr-handle.d.ts.map

package/dist/types/asr-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asr-handle.d.ts","sourceRoot":"","sources":["../../src/types/asr-handle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kBAAkB;IAClB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,gCAAgC;IAChC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7C,+DAA+D;IAC/D,KAAK,IAAI,IAAI,CAAC;IACd,sCAAsC;IACtC,MAAM,IAAI,IAAI,CAAC;IACf,0EAA0E;IAC1E,QAAQ,IAAI,IAAI,CAAC;IACjB,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/types/asr-handle.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=asr-handle.js.map

package/dist/types/asr-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asr-handle.js","sourceRoot":"","sources":["../../src/types/asr-handle.ts"],"names":[],"mappings":""}

package/dist/types/events.d.ts

@@ -0,0 +1,33 @@
+/** DTMF digit event from the remote party. */
+export interface DtmfEvent {
+    /** The pressed digit (`"0"`–`"9"`, `"*"`, `"#"`). */
+    digit: string;
+    /** Duration of the tone in milliseconds. */
+    duration: number;
+}
+/** Incoming SIP INFO message. */
+export interface SipInfo {
+    /** MIME content type (e.g. `"application/dtmf-relay"`). */
+    contentType: string;
+    /** Message body. */
+    body: string;
+}
+/** SIP call state change signal. */
+export interface SipSignal {
+    /** Call state (e.g. `"ringing"`, `"confirmed"`, `"terminated"`). */
+    state: string;
+    /** SIP response status code (e.g. `200`, `486`). */
+    statusCode?: number;
+    /** SIP response reason phrase. */
+    statusPhrase?: string;
+    /** SDP body (for media negotiation events). */
+    sdp?: string;
+}
+/** Arbitrary data message (used for WS data channel communication). */
+export interface DataMessage {
+    /** Event name / type identifier. */
+    event: string;
+    /** Event payload (any JSON-serializable data). */
+    payload: unknown;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,OAAO;IACtB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oCAAoC;AACpC,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/events.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":""}

package/dist/types/logger.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Structured logger available to scripts.
+ *
+ * In legacy compat mode, log entries are also batch-written
+ * to the `dialog_stats` DB table (equivalent of old LE `nn.log`).
+ */
+export interface ScriptLogger {
+    /** Info-level log entry. */
+    log(message: string, data?: Record<string, unknown>): void;
+    /** Warning-level log entry. */
+    warn(message: string, data?: Record<string, unknown>): void;
+    /** Error-level log entry. */
+    error(message: string, data?: Record<string, unknown>): void;
+    /** Debug-level log entry (not written to DB, only to stdout). */
+    debug(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Enable real-time log streaming to a remote debug endpoint.
+     * Opens a Socket.IO connection from this API pod to the debug server.
+     * Only logs from THIS script instance will be sent.
+     *
+     * @param endpoint - Debug URL from script-manager, e.g. "http://script-manager:3007#TOKEN"
+     */
+    enableDebug(endpoint: string): void;
+    /** Stop streaming logs and disconnect from the debug endpoint. */
+    disableDebug(): void;
+    /**
+     * Virtual breakpoint — pauses script execution and sends a snapshot
+     * of the provided variables to the debug UI. Execution resumes when
+     * the developer clicks "Continue" in the UI.
+     *
+     * If no debug session is active, resolves immediately (no-op).
+     *
+     * @param label   - Human-readable label, e.g. "after ASR result"
+     * @param snapshot - Object with variables to inspect, e.g. { text, intent, score }
+     */
+    breakpoint(label: string, snapshot?: Record<string, unknown>): Promise<void>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/types/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/types/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D,+BAA+B;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,6BAA6B;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,iEAAiE;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE7D;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC,kEAAkE;IAClE,YAAY,IAAI,IAAI,CAAC;IAErB;;;;;;;;;OASG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E"}

package/dist/types/logger.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger.js.map

package/dist/types/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/types/logger.ts"],"names":[],"mappings":""}

package/dist/types/media-channel.d.ts

@@ -0,0 +1,181 @@
+import { Observable } from 'rxjs';
+import { AsrConfig, AsrHandle } from './asr-handle';
+import { DtmfEvent, SipInfo, SipSignal, DataMessage } from './events';
+import { MixerQueueControl, PlayOptions } from './mixer';
+import { TextInput } from './text-input';
+/**
+ * Audio playback API — TTS synthesis, file playback, and queue management.
+ *
+ * Audio is routed through a multi-queue mixer. Each queue can play items
+ * independently with its own volume. Default queue index is 0.
+ */
+export interface ChannelAudio {
+    /**
+     * Synthesize text via TTS and play it.
+     * Accepts a plain string or an RxJS Observable of string chunks (for streaming TTS).
+     * Resolves when playback finishes.
+     */
+    say(input: string | Observable<string>, options?: PlayOptions): Promise<void>;
+    /**
+     * Play a pre-recorded audio file from URL or local path.
+     * Resolves when playback finishes.
+     */
+    play(source: string, options?: PlayOptions): Promise<void>;
+    /** Download, decode and cache audio (URL or file path) as PCM for instant playback. */
+    preload(source: string): Promise<void>;
+    /** Pre-synthesize text via TTS and store in file cache for instant `say()` playback. */
+    presay(text: string, options?: PlayOptions): Promise<void>;
+    /** Access a specific mixer queue by index (0–4). */
+    queue(index: number): MixerQueueControl;
+    /** Remove a specific item by alias from a queue. */
+    remove(alias: string, queue?: number): void;
+    /** Stop and clear all items in a specific queue. */
+    stop(queue: number): void;
+    /** Stop and clear all queues. */
+    stopAll(): void;
+}
+/** Observables for channel-level events (speech detection, termination, data messages). */
+export interface ChannelEvents {
+    /** Fires when the caller starts speaking (VAD-based). */
+    readonly speechStart$: Observable<void>;
+    /** Fires when the caller stops speaking. */
+    readonly speechEnd$: Observable<void>;
+    /** Fires when caller speech interrupts bot playback. */
+    readonly interrupt$: Observable<void>;
+    /** Fires when the session ends (hangup, timeout, or explicit destroy). */
+    readonly terminated$: Observable<void>;
+    /** Fires on incoming data messages (e.g. from WS client). */
+    readonly message$: Observable<DataMessage>;
+}
+/** Options for LLM `ask()` and `stream()` calls. */
+export interface LlmOptions {
+    /** Override dialog UUID for LLM context tracking. */
+    dialogUuid?: string;
+    /** System role hint (e.g. `"assistant"`, `"user"`). */
+    role?: string;
+    /** If `true`, the message is added to history but not displayed. */
+    hidden?: boolean;
+    /** Speaker name for multi-turn dialogs. */
+    name?: string;
+    /** Override agent UUID for routing to a specific LLM agent. */
+    agentUuid?: string;
+    /** Current agent alias for multi-agent scenarios. */
+    currentAgentAlias?: string;
+    /** Arbitrary payload forwarded to the LLM backend. */
+    payload?: Record<string, any>;
+    /** Enable debug logging for this request. */
+    debug?: boolean;
+    /** Restrict response to specific agent aliases. */
+    agentAliasFilter?: string[];
+}
+/** Options for LLM structured extraction. */
+export interface ExtractOptions {
+    /** Override dialog UUID. */
+    dialogUuid?: string;
+    /** Extraction prompt / instruction. */
+    prompt?: string;
+    /** LLM model name. */
+    model?: string;
+    /** Top-p (nucleus) sampling parameter. */
+    topP?: number;
+    /** Temperature sampling parameter. */
+    temperature?: number;
+    /** Custom model configuration. */
+    customModel?: Record<string, any>;
+    [key: string]: unknown;
+}
+/** A single chunk from an LLM streaming response. */
+export interface LlmStreamChunk {
+    /** Request ID. */
+    id: string;
+    /** Sequential chunk number. */
+    chunkId: number;
+    /** Text content of this chunk. */
+    content: string;
+    /** Non-null when the stream is done (e.g. `"stop"`, `"length"`). */
+    finishReason: string | null;
+    /** Raw SSE event data. */
+    event: any;
+    /** Tool call messages (function calling). */
+    toolMessages?: any[];
+    /** Full raw response object. */
+    raw: Record<string, any>;
+}
+/**
+ * LLM (Large Language Model) API — text generation and structured extraction.
+ */
+export interface ChannelLlm {
+    /** Send a message and get a complete response. */
+    ask(message: string, options?: LlmOptions): Promise<string>;
+    /** Send a message and get a streaming response (Observable of chunks). */
+    stream(message: string, options?: LlmOptions): Observable<LlmStreamChunk>;
+    /** Structured data extraction using LLM (e.g. filling a form from conversation). */
+    extract(options?: ExtractOptions): Promise<Record<string, any>>;
+}
+/**
+ * SIP telephony controls — DTMF, call control, bridging.
+ */
+export interface ChannelSip {
+    /** Observable of DTMF digit events. */
+    readonly dtmf$: Observable<DtmfEvent>;
+    /** Observable of SIP INFO messages. */
+    readonly sipInfo$: Observable<SipInfo>;
+    /** Observable of SIP call state changes (e.g. ringing, confirmed, terminated). */
+    readonly sipSignal$: Observable<SipSignal>;
+    /** Send a DTMF digit to the remote party. */
+    sendDtmf(digit: string, duration?: number): void;
+    /** Send a SIP INFO message. */
+    sendInfo(contentType: string, body: string): void;
+    /** Put the call on hold. */
+    hold(): void;
+    /** Resume a held call. */
+    unhold(): void;
+    /** Mute outgoing audio. */
+    mute(): void;
+    /** Unmute outgoing audio. */
+    unmute(): void;
+    /** Hang up the call. */
+    hangup(): void;
+    /** Answer an incoming call. */
+    answer(): void;
+    /** Originate a new outbound SIP call and return its media channel. */
+    makeCall(opts: {
+        sipUri: string;
+        fromUri?: string;
+    }): Promise<MediaChannel>;
+    /** Bridge two channels together (conference). Returns a teardown function. */
+    bridge(other: MediaChannel): () => void;
+}
+/**
+ * Media channel — the main interface for voice, audio, SIP, and LLM interaction.
+ *
+ * Every script receives a `channel` object. In headless mode,
+ * audio and SIP methods are no-ops or stubs.
+ */
+export interface MediaChannel {
+    /** Channel transport type: `"sip"` for phone calls, `"ws"` for WebSocket sessions. */
+    readonly type: 'sip' | 'ws';
+    /** Inbound caller ID (phone number or WS client ID). */
+    readonly callerId: string;
+    /** Called number / destination DID. */
+    readonly calledNumber: string;
+    /** Channel-level params (merged from route, agent defaults, etc.). */
+    readonly params: Record<string, unknown>;
+    /** Create a new ASR (speech recognition) handle with optional config. */
+    createAsr(config?: AsrConfig): Promise<AsrHandle>;
+    /** Virtual text input for testing — push text as if ASR recognized it. */
+    readonly textInput: TextInput;
+    /** Audio playback and TTS. */
+    readonly audio: ChannelAudio;
+    /** Channel events (speech, termination, data messages). */
+    readonly events: ChannelEvents;
+    /** LLM text generation and extraction. */
+    readonly llm: ChannelLlm;
+    /** SIP telephony controls. */
+    readonly sip: ChannelSip;
+    /** Send a data message to the remote party (WS). */
+    sendMessage(data: DataMessage): void;
+    /** Terminate the channel and release all resources. */
+    destroy(): void;
+}
+//# sourceMappingURL=media-channel.d.ts.map

package/dist/types/media-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-channel.d.ts","sourceRoot":"","sources":["../../src/types/media-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,uFAAuF;IACvF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,wFAAwF;IACxF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,oDAAoD;IACpD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACxC,oDAAoD;IACpD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;CAC5C;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0BAA0B;IAC1B,KAAK,EAAE,GAAG,CAAC;IACX,6CAA6C;IAC7C,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;IACrB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,0EAA0E;IAC1E,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC1E,oFAAoF;IACpF,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACvC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC3C,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,4BAA4B;IAC5B,IAAI,IAAI,IAAI,CAAC;IACb,0BAA0B;IAC1B,MAAM,IAAI,IAAI,CAAC;IACf,2BAA2B;IAC3B,IAAI,IAAI,IAAI,CAAC;IACb,6BAA6B;IAC7B,MAAM,IAAI,IAAI,CAAC;IACf,wBAAwB;IACxB,MAAM,IAAI,IAAI,CAAC;IACf,+BAA+B;IAC/B,MAAM,IAAI,IAAI,CAAC;IACf,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,8EAA8E;IAC9E,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,IAAI,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,yEAAyE;IACzE,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAClD,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IAEzB,oDAAoD;IACpD,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,uDAAuD;IACvD,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/types/media-channel.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=media-channel.js.map

package/dist/types/media-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-channel.js","sourceRoot":"","sources":["../../src/types/media-channel.ts"],"names":[],"mappings":""}

package/dist/types/mixer.d.ts

@@ -0,0 +1,42 @@
+import { Observable } from 'rxjs';
+/** TTS synthesis strategy. */
+export type TtsStrategy = 'sentence' | 'streaming' | 'chunk';
+/** TTS vendor identifier. */
+export type TtsVendor = 'A' | 'E' | 'ES' | 'V' | 'G';
+/** Options for `say()` and `play()` calls. */
+export interface PlayOptions {
+    /** Target mixer queue index (0–4). Default: 0. */
+    queue?: number;
+    /** Unique alias for this item — used to remove or track it. */
+    alias?: string;
+    /** Loop playback until explicitly stopped. */
+    loop?: boolean;
+    /** Delay in milliseconds between loop iterations. */
+    loopDelayMs?: number;
+    /** Queue volume 0.0 (silent) – 1.0 (full). Applied to the target queue for this call. */
+    volume?: number;
+    /** TTS synthesis strategy override. */
+    ttsStrategy?: TtsStrategy;
+    /** TTS vendor override. */
+    ttsVendor?: TtsVendor;
+    /** Vendor-specific TTS config (voice name, speed, pitch, etc.). */
+    ttsConfig?: Record<string, string>;
+}
+/** Control interface for a single mixer queue. */
+export interface MixerQueueControl {
+    /** Queue index (0–4). */
+    readonly index: number;
+    /** Current volume (0.0–1.0). Set to change. */
+    volume: number;
+    /** Fires when an item starts playing (emits alias). */
+    readonly itemStarted$: Observable<string>;
+    /** Fires when an item finishes playing (emits alias). */
+    readonly itemFinished$: Observable<string>;
+    /** Fires when the queue becomes empty. */
+    readonly queueEmpty$: Observable<void>;
+    /** Remove a specific item from this queue by alias. */
+    remove(alias: string): void;
+    /** Clear all items from this queue. */
+    clear(): void;
+}
+//# sourceMappingURL=mixer.d.ts.map

package/dist/types/mixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixer.d.ts","sourceRoot":"","sources":["../../src/types/mixer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;AAE7D,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAErD,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3C,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAEvC,uDAAuD;IACvD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uCAAuC;IACvC,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/types/mixer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mixer.js.map

package/dist/types/mixer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixer.js","sourceRoot":"","sources":["../../src/types/mixer.ts"],"names":[],"mappings":""}

package/dist/types/nlu.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Options for NLU extraction.
+ * Compatible with logic-executor `NeuroNluRecognitionRequest`.
+ */
+export interface NluExtractOptions {
+    /** Include only these entity types (e.g. `"date"`, `"phone"`). */
+    entities?: string | string[] | null;
+    /** Exclude these entity types from extraction. */
+    entities_exclude?: string | string[] | null;
+    /** Include only these intent names. */
+    intents?: string | string[] | null;
+    /** Exclude these intent names. */
+    intents_exclude?: string | string[] | null;
+    /** Additional context for disambiguation (string, array, or object). */
+    context?: string | unknown[] | Record<string, unknown> | null;
+    /** Force NLU API backend (default: true). */
+    use_neuro_api?: boolean;
+    /** Enable synonym expansion before extraction. */
+    use_synonyms?: boolean;
+}
+/** Raw JSON response from NLU v3 `/infer` endpoint. */
+export type NluInferResult = Record<string, unknown>;
+//# sourceMappingURL=nlu.d.ts.map

package/dist/types/nlu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlu.d.ts","sourceRoot":"","sources":["../../src/types/nlu.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5C,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3C,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,6CAA6C;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/types/nlu.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=nlu.js.map

package/dist/types/nlu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nlu.js","sourceRoot":"","sources":["../../src/types/nlu.ts"],"names":[],"mappings":""}

package/dist/types/text-input.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Virtual text input — pushes text directly into an AsrHandle's streams
+ * as if ASR recognized it. For automated testing via WS API without real audio.
+ */
+export interface TextInput {
+    pushResult(asrId: string, text: string): void;
+    pushPartial(asrId: string, text: string, isFinal?: boolean): void;
+}
+//# sourceMappingURL=text-input.d.ts.map

package/dist/types/text-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/types/text-input.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACnE"}

package/dist/types/text-input.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=text-input.js.map

package/dist/types/text-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.js","sourceRoot":"","sources":["../../src/types/text-input.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@voctiv/agent-sdk",
+  "version": "0.1.0",
+  "description": "Voctiv TypeScript agent SDK: defineScript and platform types for the voice/dialog scripting runtime.",
+  "license": "UNLICENSED",
+  "author": "",
+  "keywords": [
+    "voctiv",
+    "agent",
+    "sdk",
+    "voice",
+    "dialog",
+    "defineScript"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "rxjs": "^7.8.0"
+  },
+  "peerDependenciesMeta": {
+    "rxjs": {
+      "optional": false
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}