@voctiv/agent-sdk 0.2.6 → 0.2.8

package/dist/define-script.d.ts

@@ -1,322 +1,7 @@
-import type { BehaviorSubject, Observable } from 'rxjs';
 import type { MediaChannel } from './types/media-channel';
-import { ScriptLogger } from './types/logger';
-import type { NluExtractOptions, NluInferResult } from './types/nlu';
-import type { LegacyGetRecordsParams, LegacyPhraseRecord } from './types/legacy-phrase';
-/**
- * NLU (Natural Language Understanding) API.
- *
- * Provides intent/entity extraction through the legacy NLU v3 `/infer` endpoint.
- * ScriptEngine allows this API when `context.legacyV3Compat` is `true` and NLU
- * runtime settings are configured (`NLU_V3_BASE_URL` plus a resolved numeric
- * agent id). Calls fail fast with a descriptive error otherwise.
- *
- * Compatible with logic-executor `nn.extract()` request/response shape.
- */
-export interface NluScriptApi {
-    /**
-     * Extract intents and entities from one user utterance.
-     *
-     * The runtime sends `{ phrase, context, agent_id }` to NLU v3. If
-     * `options.context` is omitted, it serializes the current dialog params
-     * (`context.dialogParams`, then legacy fallbacks) as the request context.
-     *
-     * @param utterance - User input text to analyze.
-     * @param options - Optional NLU filters and flags. `entities`, `intents`,
-     *   `use_neuro_api`, and `use_synonyms` are forwarded by ScriptEngine.
-     * @returns Raw parsed JSON response from the NLU `/infer` endpoint.
-     */
-    extract(utterance: string, options?: NluExtractOptions): Promise<NluInferResult>;
-    /**
-     * Observable wrapper around {@link extract}.
-     *
-     * This is not a streaming NLU session: every subscription performs one
-     * `extract()` call and emits exactly one result or one error.
-     */
-    extract$(utterance: string, options?: NluExtractOptions): Observable<NluInferResult>;
-}
-/**
- * First-level **`context`** passed to every **`defineScript`** handler.
- *
- * Combines **identity** (dialog, script, agent), **telephony** (caller/destination),
- * **payload** (**`initialData`** vs **`dialogParams`**), **Voctiv platform** rows (**`dialogEntity`**),
- * and **runtime** (**`env$`**, **`runTime`**). The index signature allows extra host-specific keys.
- */
-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 `platform.nlu.extract()` and legacy DB operations.
-     *
-     * Resolved by the server from Omni/LE mapping or env (`NLU_DEFAULT_AGENT_ID` /
-     * `AGENT_ID`). Client/session params named `agent_id`, `agentId`, `agentUuid`,
-     * and `agent_uuid` are stripped before context construction and cannot spoof it.
-     * May be `0` when no agent id is configured; NLU and `platform.call()` will then fail.
-     */
-    agentId: number;
-    /**
-     * **Snapshot** of dialog/session payload when the script run started.
-     *
-     * Shallow copy of the merge **`channelParams` + `sessionParams`** after the server removes
-     * untrusted keys (e.g. client cannot spoof **`agentUuid`** here). **Do not mutate** — use
-     * **`dialogParams`** for the live map. Compare with **`dialogParams`** to see what changed
-     * during the call (if the host updates the live object).
-     */
-    initialData: Record<string, unknown>;
-    /**
-     * **Live** dialog/session parameter map for this run (same merge as **`initialData`** at start).
-     *
-     * The host may add or overwrite keys while the session progresses. For media scripts this
-     * aligns with {@link import('./types/media-channel').MediaChannel.params} (Omni defaults, route,
-     * Voctiv platform ASR/TTS: **`defaultAsrName`**, **`defaultTtsName`**, **`asrVendor`**, **`ttsVendor`**,
-     * **`asrConfig`**, **`ttsConfig`**, **`authentication_data`**, **`legacyAsrKeysByName`** /
-     * **`legacyTtsKeysByName`**, etc.). **Read/write** according to your integration; scripts should
-     * treat unknown keys as opaque.
-     */
-    dialogParams: Record<string, unknown>;
-    /** Whether Voctiv platform compatibility mode is active. */
-    legacyV3Compat: boolean;
-    /** `true` when the script runs without a real media channel (offline / queue / messaging). */
-    headless: boolean;
-    /**
-     * Persisted dialog environment for this conversation. ScriptEngine converts the
-     * plain persisted `env` snapshot into this `BehaviorSubject` before invoking the script.
-     * On the first call the value is `undefined`.
-     *
-     * **Read/write only via `env$`:** use `env$.getValue()`, `env$.next(partialOrNext)`, or
-     * `env$.subscribe(...)`. Do not use a plain `context.env` — it is not provided.
-     *
-     * **Persistence:** On script completion (success or error), the runtime snapshots `env$` and
-     * attaches it to the persisted result; the script return value must not carry env
-     * (see {@link ScriptResult}).
-     *
-     * Session runners decide where that snapshot is stored. In Voctiv platform compatibility
-     * mode it is used as the LE-style dialog environment.
-     */
-    env$?: BehaviorSubject<Record<string, unknown> | undefined>;
-    /** Raw `dialog` table row from the Voctiv platform database. */
-    dialogEntity?: Record<string, unknown>;
-    /** Raw `call` table row from the Voctiv platform database. */
-    callEntity?: Record<string, unknown>;
-    /**
-     * Optional catalog of media keys exposed to the script (Voctiv platform / Omni), e.g. UUIDs or labels
-     * for UI or logging. **Credentials** still come from **`dialogParams.authentication_data`**
-     * (and the channel mirror); use **`name`** on {@link import('./types/asr-handle').AsrConfig} /
-     * {@link import('./types/mixer').PlayOptions} to select **`key_storage.name`** when LE credential maps exist.
-     */
-    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;
-    /**
-     * Async-phase execution budget: remaining time, extension pool, {@link ScriptRunTime.extend}.
-     * Injected by the runtime; absent only in tests or non-standard hosts.
-     */
-    runTime?: ScriptRunTime;
-    /** Opaque NLU runtime config managed by ScriptEngine. */
-    _nlu?: unknown;
-    [key: string]: unknown;
-}
-/**
- * Time budget for the script async phase (after VM load). Lets scripts check remaining time
- * and request limited extensions (capped by the runtime).
- */
-export interface ScriptRunTime {
-    /** Initial budget in ms before any {@link extend}. */
-    readonly budgetMs: number;
-    /** Maximum total extra ms grantable across all {@link extend} calls for this session. */
-    readonly maxExtendMs: number;
-    /** Milliseconds left until the runtime stops the async script phase. */
-    remainingMs(): number;
-    /** Extension quota not yet granted (ms). */
-    remainingExtendMs(): number;
-    /**
-     * Grants up to `requestedMs` additional runtime, limited by remaining extension quota.
-     * @returns Granted milliseconds (0 if nothing could be granted).
-     */
-    extend(requestedMs: number): number;
-}
-/** Error info attached to {@link ScriptResult} when a script fails. */
-export interface ScriptError {
-    /**
-     * Machine-readable category, e.g. `script_error`, `script_load_failed`, `time_limit_exceeded`.
-     */
-    code: string;
-    /** Human-readable error description. */
-    message: string;
-    /** Stack trace (when available). */
-    stack?: string;
-}
-/**
- * Value returned by a script function. Only `output` and `error` are valid fields.
- * Session state is updated via `context.env$`; the runtime snapshots it separately.
- */
-export interface ScriptResult {
-    /** Output data to store in dialog_stats. */
-    output?: Record<string, unknown>;
-    /** Error details (auto-populated on script crash, or set manually). */
-    error?: ScriptError;
-}
-/**
- * Result after the runtime attaches the final `env$` snapshot (Voctiv platform persistence).
- * Scripts never construct this type — use {@link ScriptResult} from `defineScript` handlers.
- */
-export interface PersistedScriptResult extends ScriptResult {
-    env?: Record<string, unknown>;
-}
-/** 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.
-     *
-     * Stored in the created call params as `entry_point`.
-     */
-    entryPoint?: string;
-    /**
-     * Legacy compatibility field for callers that schedule without a current `scriptId`.
-     *
-     * ScriptEngine uses this to allow scheduling when the current script id is not
-     * available. It does not resolve script names or paths from this field.
-     */
-    script?: string;
-    /** Reserved SIP channel/trunk hint. Not used by the default ScriptEngine scheduler. */
-    channel?: string;
-    /** How many times to retry on failure. Stored as `recall_count` in call params. */
-    recallCount?: number;
-    /** Delay in seconds between retries. Stored as `recall_delay` in call params. */
-    recallDelay?: number;
-    /** Entry point to use after a successful call. Stored as `on_success_call`. */
-    onSuccessCall?: string;
-    /** Entry point to use after a failed call. Stored as `on_failed_call`. */
-    onFailedCall?: string;
-    /** Call priority (higher = processed sooner by dialer). */
-    priority?: number;
-    /** Timezone offset passed to the legacy call row as `timeZone`. */
-    timezone?: number;
-    /** Extra SIP headers or protocol-level params. Stored as `proto_additional` in call params. */
-    protoAdditional?: Record<string, string>;
-}
-/**
- * Dialog state API — read and update dialog routing metadata.
- *
- * Setting `entryPoint` or `result` updates the local value immediately and asks
- * the Voctiv platform database to persist the change asynchronously. In worker
- * sessions the setter sends an RPC to the main thread; in direct sessions errors
- * are logged. There is no awaitable setter, so do not use it for transactional flow.
- */
-export interface DialogApi {
-    /** Current script entry point (e.g. `"on_recall"`). Set to change routing for the 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 (service id, bot id, or phone number expected by the MA consumer). */
-    src: string;
-    /** Recipient identifier (phone number, user id, or channel-specific address). */
-    destination: string;
-    /** Text body of the message. When present in legacy mode, it is also mirrored to dialog stats. */
-    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.
- *
- * Outbound messages are transported via Redis Streams (`ma_send` / `ma_receive`),
- * compatible with the old LE messaging architecture. `message$` is currently a
- * one-shot replay of the inbound message that started a headless messaging script,
- * not a live subscription to all future Redis messages.
- */
-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 — Voctiv platform–compatible operations available to scripts.
- *
- * Provides access to NLU, dialog state management, outbound call scheduling,
- * phrase records, and messaging. These operations are legacy-platform backed and
- * require `context.legacyV3Compat === true`.
- */
-export interface PlatformApi {
-    /** NLU intent/entity extraction API; throws outside legacy V3 compatibility mode. */
-    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>;
-    /**
-     * Voctiv platform only: load `record_phrase` / `record_phrase_file` rows from the LE PostgreSQL database
-     * (same filters as old `RecordPhrase.get_records`). Returns playable phrase record objects.
-     * Requires numeric `agent_id` on the dialog (params or `NLU_DEFAULT_AGENT_ID`) and
-     * `LEGACY_V3_RECORD_PHRASE_ROOT` pointing at the phrase file storage root.
-     */
-    getRecords?(params: LegacyGetRecordsParams): Promise<LegacyPhraseRecord[]>;
-}
+import type { ScriptLogger } from './types/logger';
+import type { ScriptDialogContext, ScriptResult } from './types/script-context';
+import type { PlatformApi } from './types/platform';
 /**
  * Top-level context passed to every script function.
  *
@@ -361,7 +46,8 @@ export type ScriptFn = (ctx: ScriptContext) => void | ScriptResult | Promise<voi
  * Mark the default export as a typed script entry point (identity wrapper; no runtime transform).
  *
  * The host loads this module, invokes the function with {@link ScriptContext}, and persists
- * {@link ScriptResult} / {@link ScriptDialogContext.env$} according to Voctiv platform rules.
+ * {@link ScriptResult} / {@link import('./types/script-context').ScriptDialogContext.env$}
+ * according to Voctiv platform rules.
  *
  * @param fn - Handler receiving **`{ channel, logger, context, platform }`**.
  *   - Use **`channel`** for ASR/TTS (see {@link import('./types/asr-handle').AsrConfig.name},
@@ -371,12 +57,12 @@ export type ScriptFn = (ctx: ScriptContext) => void | ScriptResult | Promise<voi
  *
  * @example
  * ```ts
- * import { defineScript } from '@lib/scripting-sdk';
+ * import { defineScript } from '@voctiv/agent-sdk';
  *
  * export default defineScript(async ({ channel, logger, context, platform }) => {
  *   const asr = await channel.createAsr({
  *     name: 'my-yandex-key',
- *     vendor: 'Y',
+ *     vendor: 'yandex',
  *     language: 'ru-RU',
  *   });
  * });

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

@@ -1 +1 @@
-{"version":3,"file":"define-script.d.ts","sourceRoot":"","sources":["../src/define-script.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-script.d.ts","sourceRoot":"","sources":["../src/define-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB,0FAA0F;IAC1F,MAAM,EAAE,YAAY,CAAC;IACrB,wFAAwF;IACxF,OAAO,EAAE,mBAAmB,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,GAAG,EAAE,aAAa,KACf,IAAI,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAEnD"}

package/dist/define-script.js

@@ -5,7 +5,8 @@ exports.defineScript = defineScript;
  * Mark the default export as a typed script entry point (identity wrapper; no runtime transform).
  *
  * The host loads this module, invokes the function with {@link ScriptContext}, and persists
- * {@link ScriptResult} / {@link ScriptDialogContext.env$} according to Voctiv platform rules.
+ * {@link ScriptResult} / {@link import('./types/script-context').ScriptDialogContext.env$}
+ * according to Voctiv platform rules.
  *
  * @param fn - Handler receiving **`{ channel, logger, context, platform }`**.
  *   - Use **`channel`** for ASR/TTS (see {@link import('./types/asr-handle').AsrConfig.name},
@@ -15,12 +16,12 @@ exports.defineScript = defineScript;
  *
  * @example
  * ```ts
- * import { defineScript } from '@lib/scripting-sdk';
+ * import { defineScript } from '@voctiv/agent-sdk';
  *
  * export default defineScript(async ({ channel, logger, context, platform }) => {
  *   const asr = await channel.createAsr({
  *     name: 'my-yandex-key',
- *     vendor: 'Y',
+ *     vendor: 'yandex',
  *     language: 'ru-RU',
  *   });
  * });

package/dist/define-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-script.js","sourceRoot":"","sources":["../src/define-script.ts"],"names":[],"mappings":";;AAuaA,oCAEC;AA3BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,YAAY,CAAC,EAAY;IACvC,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"define-script.js","sourceRoot":"","sources":["../src/define-script.ts"],"names":[],"mappings":";;AA2EA,oCAEC;AA5BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,YAAY,CAAC,EAAY;IACvC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -12,7 +12,7 @@
  * - **`legacyAsrKeysByName`**: map **`name`** → `{ platform, flat }` for ASR
  * - **`legacyTtsKeysByName`**: same for TTS
  *
- * Rows are scoped to **this dialog’s agent and company** (no agent UUID in the script). Use:
+ * Rows are scoped to **this dialog's agent and company** (no agent UUID in the script). Use:
  * - {@link import('./types/asr-handle').AsrConfig.name} or **`data.name`** on **`createAsr`**
  * - {@link import('./types/mixer').PlayOptions.name} or **`ttsConfig.name`** on **`say`/`play`/`presay`**
  *
@@ -22,9 +22,14 @@
  * records) require `context.legacyV3Compat === true`.
  */
 export { defineScript } from './define-script';
-export type { ScriptContext, ScriptDialogContext, ScriptRunTime, ScriptResult, PersistedScriptResult, ScriptError, ScriptFn, NluScriptApi, PlatformApi, DialogApi, ScheduleCallOptions, SendMessageOptions, InboundMessage, MessagingApi, } from './define-script';
+export type { ScriptContext, ScriptFn } from './define-script';
+export type { ScriptDialogContext, ScriptRunTime, ScriptResult, PersistedScriptResult, ScriptError, } from './types/script-context';
+export type { NluScriptApi, PlatformApi, DialogApi, ScheduleCallOptions, SendMessageOptions, InboundMessage, MessagingApi, } from './types/platform';
 export type { ScriptLogger } from './types/logger';
-export type { MediaChannel, ChannelAudio, ChannelEvents, ChannelLlm, ChannelSip, SipState, SipProgressEvent, LlmOptions, LlmStreamChunk, ExtractOptions, PersistentLlmStreamHandle, } from './types/media-channel';
+export type { MediaChannel, ChannelAudio, ChannelEvents, } from './types/media-channel';
+export type { ChannelLlm, LlmOptions, LlmStreamChunk, ExtractOptions, PersistentLlmStreamHandle, } from './types/llm';
+export type { ChannelSip, SipState, SipProgressEvent, } from './types/sip';
+export type { MediaError } from './types/errors';
 export type { AsrHandle, AsrConfig, AsrVadConfig, AsrSmartTurnConfig } from './types/asr-handle';
 export type { MixerQueueControl, PlayOptions, TtsStrategy, TtsVendor } from './types/mixer';
 export type { LegacyPhraseRecord, LegacyGetRecordsParams, LegacySavePhraseOptions, } from './types/legacy-phrase';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,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,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,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,EACV,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE/D,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,QAAQ,EACR,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,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,EACV,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,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

@@ -13,7 +13,7 @@
  * - **`legacyAsrKeysByName`**: map **`name`** → `{ platform, flat }` for ASR
  * - **`legacyTtsKeysByName`**: same for TTS
  *
- * Rows are scoped to **this dialog’s agent and company** (no agent UUID in the script). Use:
+ * Rows are scoped to **this dialog's agent and company** (no agent UUID in the script). Use:
  * - {@link import('./types/asr-handle').AsrConfig.name} or **`data.name`** on **`createAsr`**
  * - {@link import('./types/mixer').PlayOptions.name} or **`ttsConfig.name`** on **`say`/`play`/`presay`**
  *

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAuCrB,uDAG+B;AAF7B,2HAAA,0BAA0B,OAAA;AAC1B,qHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAmDrB,uDAG+B;AAF7B,2HAAA,0BAA0B,OAAA;AAC1B,qHAAA,oBAAoB,OAAA"}

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

@@ -1,4 +1,5 @@
-import { Observable } from 'rxjs';
+import type { Observable } from 'rxjs';
+import type { MediaError } from './errors';
 /**
  * Voice Activity Detection (VAD) tuning.
  *
@@ -35,7 +36,7 @@ export interface AsrVadConfig {
 export interface AsrSmartTurnConfig {
     /** When `true`, turn-taking heuristics are applied (defaults vary by host). */
     enabled?: boolean;
-    /** Frames of speech that must be seen before a “turn” can start. */
+    /** Frames of speech that must be seen before a "turn" can start. */
     triggerFrames?: number;
     /** Frames to wait before retrying after a short pause inside an utterance. */
     retryFrames?: number;
@@ -51,9 +52,9 @@ export interface AsrSmartTurnConfig {
  *
  * ### Voctiv platform + logic-executor `key_storage`
  *
- * When Voctiv platform compatibility is on and the connector loaded credentials from PostgreSQL, the session’s
+ * When Voctiv platform compatibility is on and the connector loaded credentials from PostgreSQL, the session's
  * `authentication_data` includes **`legacyAsrKeysByName`**: a map from **`key_storage.name`**
- * (string) to flat connector parameters (`api_key`, `base_url`, …) for **this dialog’s agent
+ * (string) to flat connector parameters (`api_key`, `base_url`, …) for **this dialog's agent
  * and company**. You do **not** pass agent UUID in the script — the dialog already belongs to an agent.
  *
  * - **`name`**: pick which row from that map to use (same value as in LE admin for the key).
@@ -66,18 +67,18 @@ export interface AsrSmartTurnConfig {
  *
  * ### Vendor
  *
- * **`vendor`** is resolved via ScriptEngine vendor aliases (`"yandex"`, `"Y"`, `"neuro_v3"`, …). If you set
- * **`name`** but omit **`vendor`**, the runtime may infer vendor from the key row’s **`platform`**
+ * **`vendor`** is resolved via ScriptEngine vendor aliases (`"yandex"`, `"deepgram"`, `"neuro_v3"`, …). If you set
+ * **`name`** but omit **`vendor`**, the runtime may infer vendor from the key row's **`platform`**
  * in the catalog.
  */
 export interface AsrConfig {
     /**
-     * ASR vendor / engine hint: single-letter code (`"Y"`, `"D"`, …) or legacy name
-     * (`"yandex"`, `"neuro_v3"`, …). See host `media-vendor-aliases` mapping.
+     * ASR vendor / engine hint, e.g. `"yandex"`, `"deepgram"`, `"google"`,
+     * `"azure"`, `"voctiv"`, or `"neuro_v3"`.
      */
     vendor?: string;
     /**
-     * logic-executor **`key_storage.name`** for this dialog’s agent + company. Selects credentials
+     * logic-executor **`key_storage.name`** for this dialog's agent + company. Selects credentials
      * from **`authentication_data.legacyAsrKeysByName[name]`** when Voctiv platform PostgreSQL key auth is enabled.
      * Overrides channel **`defaultAsrName`**.
      */
@@ -89,7 +90,7 @@ export interface AsrConfig {
      * Merged last over channel defaults and catalog credentials so the script can override
      * per call. Primitives are stringified; objects and arrays are JSON-serialized.
      *
-     * Do not rely on **`name`** here for third-party “model name” fields — the runtime consumes
+     * Do not rely on **`name`** here for third-party "model name" fields — the runtime consumes
      * it as the storage row selector and removes it before vendor config is built.
      */
     data?: Record<string, unknown>;
@@ -132,6 +133,18 @@ export interface AsrHandle {
     readonly interrupt$: Observable<void>;
     /** Normalized voice-activity probability 0–1 when the host exposes it; else may be inert. */
     readonly vadProbability$: Observable<number>;
+    /**
+     * Runtime errors from the ASR provider (gRPC disconnect, auth failures, quota exceeded, etc.).
+     *
+     * A degraded handle (returned when connector creation itself failed) has an inert `error$`
+     * that never emits — the creation failure is reported on {@link import('./media-channel').ChannelEvents.error$} instead.
+     *
+     * ```ts
+     * const asr = await channel.createAsr({ name: 'yandex-asr-test' });
+     * asr.error$.subscribe(err => console.log('ASR error:', err.message));
+     * ```
+     */
+    readonly error$: Observable<MediaError>;
     /** Pause forwarding new audio frames to the recognizer; skipped audio is not replayed. */
     pause(): void;
     /** Resume after {@link pause}. */

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

@@ -1 +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;;;;;;;GAOG;AACH,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,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sEAAsE;IACtE,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,6FAA6F;IAC7F,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE7C,0FAA0F;IAC1F,KAAK,IAAI,IAAI,CAAC;IACd,kCAAkC;IAClC,MAAM,IAAI,IAAI,CAAC;IACf,kFAAkF;IAClF,QAAQ,IAAI,IAAI,CAAC;IACjB,8FAA8F;IAC9F,OAAO,IAAI,IAAI,CAAC;CACjB"}
+{"version":3,"file":"asr-handle.d.ts","sourceRoot":"","sources":["../../src/types/asr-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;GAOG;AACH,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,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sEAAsE;IACtE,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,6FAA6F;IAC7F,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE7C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAExC,0FAA0F;IAC1F,KAAK,IAAI,IAAI,CAAC;IACd,kCAAkC;IAClC,MAAM,IAAI,IAAI,CAAC;IACf,kFAAkF;IAClF,QAAQ,IAAI,IAAI,CAAC;IACjB,8FAA8F;IAC9F,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/types/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Structured error emitted on {@link import('./media-channel').ChannelEvents.error$} and {@link import('./asr-handle').AsrHandle.error$}.
+ *
+ * Scripts can subscribe to these observables to detect ASR/TTS/SIP failures at runtime
+ * without relying on server-side logs.
+ */
+export interface MediaError {
+    /** Which subsystem produced the error. */
+    source: 'asr' | 'tts' | 'sip' | 'channel';
+    /** Human-readable description (same string that appears in server logs). */
+    message: string;
+    /** HTTP status code, gRPC status, or WebSocket close code when available. */
+    code?: number;
+    /** Vendor/engine identifier, e.g. `"yandex"`, `"elevenlabs"`, `"azure"`. */
+    vendor?: string;
+    /** Arbitrary provider-specific payload for advanced diagnostics. */
+    details?: unknown;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1C,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/errors.js

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

package/dist/types/errors.js.map

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

package/dist/types/llm.d.ts

@@ -0,0 +1,78 @@
+import type { Observable } from 'rxjs';
+/** Options for **`channel.llm.ask`** / **`stream`** / **`makePersistentStream`**. */
+export interface LlmOptions {
+    /** Override dialog UUID for Omni/LLM tracing (defaults to script dialog). */
+    dialogUuid?: string;
+    /** Chat role sent with the message, e.g. **`"assistant"`**, **`"user"`**. */
+    role?: string;
+    /** When `true`, message may be hidden from user-visible transcript (host-dependent). */
+    hidden?: boolean;
+    /**
+     * **LLM-only**: speaker / persona label in multi-party chat. **Not** related to
+     * {@link import('./mixer').PlayOptions.name} (TTS **`key_storage.name`**).
+     */
+    name?: string;
+    /** Route the request to a specific Omni agent profile (UUID). */
+    agentUuid?: string;
+    /** Multi-agent: current alias for routing. */
+    currentAgentAlias?: string;
+    /** Opaque payload forwarded to the Omni LLM backend. */
+    payload?: Record<string, any>;
+    /** Verbose logging on the LLM path. */
+    debug?: boolean;
+    /** Restrict which agent aliases may handle the request. */
+    agentAliasFilter?: string[];
+}
+/** Options for **`channel.llm.extract`**. All fields except `dialogUuid` are forwarded to Omni extract. */
+export interface ExtractOptions {
+    /** Override dialog UUID for extraction context; defaults to the current script dialog. */
+    dialogUuid?: string;
+    /** Optional extraction prompt/instruction forwarded to Omni. */
+    prompt?: string;
+    /** Model name or id understood by the Omni backend. */
+    model?: string;
+    /** Nucleus sampling value forwarded to Omni. */
+    topP?: number;
+    /** Temperature forwarded to Omni. */
+    temperature?: number;
+    /** Custom model descriptor forwarded as-is. */
+    customModel?: Record<string, any>;
+    [key: string]: unknown;
+}
+/** One chunk from **`channel.llm.stream`**. */
+export interface LlmStreamChunk {
+    id: string;
+    chunkId: number;
+    content: string;
+    finishReason: string | null;
+    event: any;
+    toolMessages?: any[];
+    raw: Record<string, any>;
+}
+/**
+ * Long-lived LLM Socket.IO stream — amortizes connection setup across many user turns.
+ */
+export interface PersistentLlmStreamHandle {
+    readonly stream$: Observable<LlmStreamChunk>;
+    /** Send one user/assistant turn over the existing stream; options override defaults for this send only. */
+    send(message: string, options?: LlmOptions): void;
+    /** Close the underlying Socket.IO stream without destroying the handle object. */
+    disconnect(): void;
+    /** Re-open the underlying Socket.IO stream after {@link disconnect}. */
+    reconnect(): void;
+}
+/** LLM facade on the media channel. */
+export interface ChannelLlm {
+    /** Single-shot completion for **`message`**; consumes the Omni SSE stream and returns concatenated text. */
+    ask(message: string, options?: LlmOptions): Promise<string>;
+    /** Token/chunk stream for **`message`** parsed from Omni SSE `data:` events. */
+    stream(message: string, options?: LlmOptions): Observable<LlmStreamChunk>;
+    /** Structured extraction / JSON-style fill from conversation context via Omni extract. */
+    extract(options?: ExtractOptions): Promise<Record<string, any>>;
+    /**
+     * Open a persistent Omni chat stream.
+     * @param options - Default **`agentUuid`**, **`dialogUuid`**, etc.; per-**`send`** overrides allowed.
+     */
+    makePersistentStream(options?: LlmOptions): PersistentLlmStreamHandle;
+}
+//# sourceMappingURL=llm.d.ts.map