@voctiv/agent-sdk 0.1.3 → 0.2.1

package/dist/define-script.d.ts

@@ -1,33 +1,46 @@
 import type { BehaviorSubject, Observable } from 'rxjs';
-import { MediaChannel } from './types/media-channel';
+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 from user utterances.
- * Compatible with logic-executor `nn.extract()`.
+ * Provides intent/entity extraction through the legacy NLU v3 `/infer` endpoint.
+ * The current `apps/api` runtime only 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 text.
+     * 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 - Filter by specific intents/entities, add context, etc.
-     * @returns Parsed NLU result with intents, entities, and confidence scores.
+     * @param options - Optional NLU filters and flags. `entities`, `intents`,
+     *   `use_neuro_api`, and `use_synonyms` are forwarded by the current API runtime.
+     * @returns Raw parsed JSON response from the NLU `/infer` endpoint.
      */
     extract(utterance: string, options?: NluExtractOptions): Promise<NluInferResult>;
     /**
-     * Same as {@link extract} but returns an RxJS Observable
-     * (useful for streaming pipelines).
+     * 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>;
 }
 /**
- * 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.
+ * First-level **`context`** passed to every **`defineScript`** handler.
  *
- * Index signature allows arbitrary extra fields for forward compat.
+ * 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"`. */
@@ -50,34 +63,65 @@ export interface ScriptDialogContext {
     scriptName: string;
     /** Agent UUID from Omni platform (links script to an NLU agent). */
     agentUuid?: string;
-    /** Numeric NLU agent ID used for extract() calls. */
+    /**
+     * 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;
-    /** 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. */
+    /**
+     * **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. On each call the platform loads the
-     * previous snapshot and seeds {@link env$}. On the first call the value is `undefined`.
+     * Persisted dialog environment for this conversation. The API runtime 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
-     * persists it; the script return value must not carry env (see {@link ScriptResult}).
+     * attaches it to the persisted result; the script return value must not carry env
+     * (see {@link ScriptResult}).
      *
-     * Only active in legacy V3 compatibility mode.
+     * 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 legacy DB. */
+    /** Raw `dialog` table row from the Voctiv platform database. */
     dialogEntity?: Record<string, unknown>;
-    /** Raw `call` table row from legacy DB. */
+    /** Raw `call` table row from the Voctiv platform database. */
     callEntity?: Record<string, unknown>;
-    /** Available TTS/ASR media key identifiers (legacy compat). */
+    /**
+     * 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;
@@ -89,13 +133,39 @@ export interface ScriptDialogContext {
     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;
     /** @internal NLU runtime config — opaque to scripts. */
     _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 {
-    /** Error category: `"script_error"` | `"server_error"` (mirrors old LE stat names). */
+    /**
+     * Machine-readable category, e.g. `script_error`, `script_load_failed`, `time_limit_exceeded`.
+     */
     code: string;
     /** Human-readable error description. */
     message: string;
@@ -113,7 +183,7 @@ export interface ScriptResult {
     error?: ScriptError;
 }
 /**
- * Result after the runtime attaches the final `env$` snapshot (legacy persistence).
+ * 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 {
@@ -125,35 +195,46 @@ export interface ScheduleCallOptions {
     date?: string | Date;
     /** Deadline — don't call after this time. */
     dateEnd?: string | Date;
-    /** Entry point to pass to the script when the call connects. */
+    /**
+     * Entry point to pass to the script when the call connects.
+     *
+     * Stored in the created call params as `entry_point`.
+     */
     entryPoint?: string;
-    /** Override script name/path for the outbound call. */
+    /**
+     * Legacy compatibility field for callers that schedule without a current `scriptId`.
+     *
+     * The current `apps/api` scheduler only uses this to allow validation when
+     * `scriptId` is missing; it does not resolve the script name/path itself.
+     */
     script?: string;
-    /** SIP channel/trunk name override. */
+    /** Reserved SIP channel/trunk hint. The current `apps/api` scheduler does not persist it. */
     channel?: string;
-    /** How many times to retry on failure. */
+    /** How many times to retry on failure. Stored as `recall_count` in call params. */
     recallCount?: number;
-    /** Delay in seconds between retries. */
+    /** Delay in seconds between retries. Stored as `recall_delay` in call params. */
     recallDelay?: number;
-    /** Entry point to use after a successful call. */
+    /** Entry point to use after a successful call. Stored as `on_success_call`. */
     onSuccessCall?: string;
-    /** Entry point to use after a failed call. */
+    /** 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 (hours) for date interpretation. */
+    /** Timezone offset passed to the legacy call row as `timeZone`. */
     timezone?: number;
-    /** Extra SIP headers or protocol-level params. */
+    /** 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` immediately persists the change
- * to the legacy DB (non-blocking, fire-and-forget).
+ * 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 next call. */
+    /** 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;
@@ -164,11 +245,11 @@ export interface DialogApi {
 }
 /** Options for sending an outbound message via {@link MessagingApi.send}. */
 export interface SendMessageOptions {
-    /** Sender identifier (your service ID or phone number). */
+    /** Sender identifier (service id, bot id, or phone number expected by the MA consumer). */
     src: string;
-    /** Recipient identifier (phone number, user ID, etc.). */
+    /** Recipient identifier (phone number, user id, or channel-specific address). */
     destination: string;
-    /** Text body of the message. */
+    /** 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;
@@ -189,8 +270,10 @@ export interface InboundMessage {
 /**
  * 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.
+ * 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 {
     /**
@@ -206,14 +289,15 @@ export interface MessagingApi {
     readonly message$: Observable<InboundMessage>;
 }
 /**
- * Platform API — legacy-compatible operations available to scripts.
+ * Platform API — Voctiv platform–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).
+ * phrase records, and messaging. These operations are legacy-platform backed:
+ * the current `apps/api` runtime requires `context.legacyV3Compat === true` for
+ * NLU, `call`, `dialog` writes, messaging sends, and `getRecords`.
  */
 export interface PlatformApi {
-    /** NLU intent/entity extraction API. */
+    /** 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;
@@ -226,6 +310,13 @@ export interface PlatformApi {
      * @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[]>;
 }
 /**
  * Top-level context passed to every script function.
@@ -257,7 +348,7 @@ export interface ScriptContext {
     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. */
+    /** Dialog context with session metadata, routing params, and Voctiv platform fields. */
     context: ScriptDialogContext;
     /** Platform API — NLU, dialog state, messaging, outbound calls. */
     platform: PlatformApi;
@@ -268,15 +359,27 @@ export interface ScriptContext {
  */
 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.
+ * 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.
+ *
+ * @param fn - Handler receiving **`{ channel, logger, context, platform }`**.
+ *   - Use **`channel`** for ASR/TTS (see {@link import('./types/asr-handle').AsrConfig.name},
+ *     {@link import('./types/mixer').PlayOptions.name} for LE **`key_storage.name`** selection).
+ *   - Use **`context.dialogParams`** / **`context.dialogUuid`** for routing; **`platform`** for NLU, calls, messaging.
+ * @returns The same **`fn`** reference.
  *
  * @example
  * ```ts
  * import { defineScript } from '@lib/scripting-sdk';
  *
  * export default defineScript(async ({ channel, logger, context, platform }) => {
- *   // your script logic here
+ *   const asr = await channel.createAsr({
+ *     name: 'my-yandex-key',
+ *     vendor: 'Y',
+ *     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":"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"}

package/dist/define-script.js

@@ -2,15 +2,27 @@
 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.
+ * 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.
+ *
+ * @param fn - Handler receiving **`{ channel, logger, context, platform }`**.
+ *   - Use **`channel`** for ASR/TTS (see {@link import('./types/asr-handle').AsrConfig.name},
+ *     {@link import('./types/mixer').PlayOptions.name} for LE **`key_storage.name`** selection).
+ *   - Use **`context.dialogParams`** / **`context.dialogUuid`** for routing; **`platform`** for NLU, calls, messaging.
+ * @returns The same **`fn`** reference.
  *
  * @example
  * ```ts
  * import { defineScript } from '@lib/scripting-sdk';
  *
  * export default defineScript(async ({ channel, logger, context, platform }) => {
- *   // your script logic here
+ *   const asr = await channel.createAsr({
+ *     name: 'my-yandex-key',
+ *     vendor: 'Y',
+ *     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":";;AA4TA,oCAEC;AAfD;;;;;;;;;;;;GAYG;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":";;AAwaA,oCAEC;AA3BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,YAAY,CAAC,EAAY;IACvC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,34 @@
+/**
+ * @packageDocumentation
+ * **Agent scripting SDK** for `node-asr-tts-connector`: typed **`defineScript`** context,
+ * {@link import('./types/media-channel').MediaChannel}, ASR/TTS, LLM, SIP, and Voctiv platform (LE-compat) helpers.
+ * These exports are types plus the `defineScript` identity helper; behavior is provided by
+ * the `apps/api` scripting runtime that loads and executes your script.
+ *
+ * ### Selecting ASR/TTS credentials by `key_storage.name` (Voctiv platform)
+ *
+ * When the host enables Voctiv platform PostgreSQL key auth, **`channel.params.authentication_data`**
+ * may contain:
+ * - **`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:
+ * - {@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`**
+ *
+ * Channel defaults **`defaultAsrName`** / **`defaultTtsName`** apply when **`name`** is omitted.
+ *
+ * Legacy platform APIs (`platform.nlu`, `platform.call`, messaging sends, dialog writes, and phrase
+ * records) require `context.legacyV3Compat === true` in the current API runtime.
+ */
 export { defineScript } from './define-script';
-export type { ScriptContext, ScriptDialogContext, ScriptResult, PersistedScriptResult, ScriptError, ScriptFn, NluScriptApi, PlatformApi, DialogApi, ScheduleCallOptions, SendMessageOptions, InboundMessage, MessagingApi, } from './define-script';
+export type { ScriptContext, ScriptDialogContext, ScriptRunTime, ScriptResult, PersistedScriptResult, 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, PersistentLlmStreamHandle, } from './types/media-channel';
+export type { MediaChannel, ChannelAudio, ChannelEvents, ChannelLlm, ChannelSip, SipState, SipProgressEvent, LlmOptions, LlmStreamChunk, ExtractOptions, PersistentLlmStreamHandle, } 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 { LegacyPhraseRecord, LegacyGetRecordsParams, LegacySavePhraseOptions, } from './types/legacy-phrase';
+export { LEGACY_PHRASE_RECORD_BRAND, isLegacyPhraseRecord, } from './types/legacy-phrase';
 export type { TextInput } from './types/text-input';
 export type { DtmfEvent, SipInfo, SipSignal, DataMessage, } from './types/events';
 export type { NluExtractOptions, NluInferResult } from './types/nlu';

package/dist/index.d.ts.map

@@ -1 +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,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,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,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,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"}

package/dist/index.js

@@ -1,6 +1,32 @@
 "use strict";
+/**
+ * @packageDocumentation
+ * **Agent scripting SDK** for `node-asr-tts-connector`: typed **`defineScript`** context,
+ * {@link import('./types/media-channel').MediaChannel}, ASR/TTS, LLM, SIP, and Voctiv platform (LE-compat) helpers.
+ * These exports are types plus the `defineScript` identity helper; behavior is provided by
+ * the `apps/api` scripting runtime that loads and executes your script.
+ *
+ * ### Selecting ASR/TTS credentials by `key_storage.name` (Voctiv platform)
+ *
+ * When the host enables Voctiv platform PostgreSQL key auth, **`channel.params.authentication_data`**
+ * may contain:
+ * - **`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:
+ * - {@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`**
+ *
+ * Channel defaults **`defaultAsrName`** / **`defaultTtsName`** apply when **`name`** is omitted.
+ *
+ * Legacy platform APIs (`platform.nlu`, `platform.call`, messaging sends, dialog writes, and phrase
+ * records) require `context.legacyV3Compat === true` in the current API runtime.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineScript = void 0;
+exports.isLegacyPhraseRecord = exports.LEGACY_PHRASE_RECORD_BRAND = exports.defineScript = void 0;
 var define_script_1 = require("./define-script");
 Object.defineProperty(exports, "defineScript", { enumerable: true, get: function () { return define_script_1.defineScript; } });
+var legacy_phrase_1 = require("./types/legacy-phrase");
+Object.defineProperty(exports, "LEGACY_PHRASE_RECORD_BRAND", { enumerable: true, get: function () { return legacy_phrase_1.LEGACY_PHRASE_RECORD_BRAND; } });
+Object.defineProperty(exports, "isLegacyPhraseRecord", { enumerable: true, get: function () { return legacy_phrase_1.isLegacyPhraseRecord; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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