@voctiv/agent-sdk 0.1.3 → 0.2.1

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

@@ -1,5 +1,12 @@
 import { Observable } from 'rxjs';
-/** Voice Activity Detection (VAD) tuning parameters. */
+/**
+ * Voice Activity Detection (VAD) tuning.
+ *
+ * SIP sessions use the call-level telephony VAD when available. WS sessions create one
+ * VAD instance for the whole socket session on the first `createAsr()` call and merge
+ * these options with runtime defaults. When no VAD is available, audio is forwarded to
+ * ASR continuously and most VAD observables are empty.
+ */
 export interface AsrVadConfig {
     /** Energy threshold to start speech detection (0.0–1.0). */
     positiveThreshold?: number;
@@ -11,70 +18,127 @@ export interface AsrVadConfig {
     energyFloor?: number;
     /** Smoothing factor for noise floor estimation (0.0–1.0). */
     noiseFloorAlpha?: number;
-    /** Frames of audio to include before detected speech start. */
+    /** Frames of PCM (typically 20 ms @ 16 kHz / 640 bytes) to prepend before detected speech start. */
     preSpeechFrames?: number;
-    /** Silence frames after speech before confirming end-of-speech. */
+    /** Frames of post-speech PCM to still forward to ASR after VAD speech end. */
     postSpeechFrames?: number;
 }
-/** Smart turn-taking configuration — controls when to finalize ASR during conversation. */
+/**
+ * Smart turn-taking — controls when the runtime finalizes an utterance (end-of-turn) while
+ * streaming audio to ASR. Reduces cutting off the user mid-sentence when enabled.
+ *
+ * On WS sessions these values are passed to the telephony VAD/SmartTurn service.
+ * On SIP sessions, `enabled: true` also ensures the ASR connector has an
+ * `utterance_end_ms` value (defaulting to `1000`) when the resolved connector config
+ * did not already provide one.
+ */
 export interface AsrSmartTurnConfig {
-    /** Enable smart turn-taking (default: false). */
+    /** When `true`, turn-taking heuristics are applied (defaults vary by host). */
     enabled?: boolean;
-    /** Frames of speech before starting a turn. */
+    /** Frames of speech that must be seen before a “turn” can start. */
     triggerFrames?: number;
-    /** Frames to wait before retrying after a short pause. */
+    /** Frames to wait before retrying after a short pause inside an utterance. */
     retryFrames?: number;
-    /** Max silence frames before force-finalizing the turn. */
+    /** Max silence frames before force-finalizing the current turn. */
     maxSilenceFrames?: number;
-    /** Milliseconds to wait for confirmation after potential end-of-turn. */
+    /** Milliseconds to wait for confirmation after a candidate end-of-turn. */
     confirmMs?: number;
-    /** Hard timeout: finalize after this many ms of silence regardless. */
+    /** Hard cap: finalize after this many milliseconds of silence regardless of other rules. */
     silenceTimeoutMs?: number;
 }
-/** Configuration for creating an ASR (speech recognition) handle. */
+/**
+ * Arguments for {@link import('./media-channel').MediaChannel.createAsr}.
+ *
+ * ### Voctiv platform + logic-executor `key_storage`
+ *
+ * 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
+ * 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).
+ * - If omitted, the channel default **`defaultAsrName`** (from Omni / route) is used.
+ * - If neither is set, credentials fall back to the usual **`authentication_data.asr.<engine>`**
+ *   blob for the resolved vendor (main/reserved keys on the agent).
+ *
+ * You may also set the same selector as **`data.name`**. The runtime treats it as
+ * the storage-row selector and strips it before sending connector params to the ASR vendor.
+ *
+ * ### Vendor
+ *
+ * **`vendor`** is resolved via internal aliases (`"yandex"`, `"Y"`, `"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 identifier. */
+    /**
+     * ASR vendor / engine hint: single-letter code (`"Y"`, `"D"`, …) or legacy name
+     * (`"yandex"`, `"neuro_v3"`, …). See host `media-vendor-aliases` mapping.
+     */
     vendor?: string;
-    /** Recognition language (BCP-47, e.g. `"ru-RU"`). */
+    /**
+     * 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`**.
+     */
+    name?: string;
+    /** Recognition language (BCP-47), e.g. `"ru-RU"`. Passed through to the connector as `language`. */
     language?: string;
-    /** Vendor-specific configuration parameters. */
+    /**
+     * Vendor-specific connection parameters (URLs, timeouts, model ids, nested JSON, …).
+     * 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
+     * it as the storage row selector and removes it before vendor config is built.
+     */
     data?: Record<string, unknown>;
-    /** VAD tuning. */
+    /** Optional VAD tuning for this session (see host implementation). */
     vad?: AsrVadConfig;
-    /** Smart turn-taking tuning. */
+    /** Optional smart-turn tuning for this session. */
     smartTurn?: AsrSmartTurnConfig;
 }
 /**
- * ASR handle — a live speech recognition session.
+ * Live speech recognition session returned by {@link import('./media-channel').MediaChannel.createAsr}.
+ *
+ * Subscribe to **`partial$`** / **`result$`** for transcripts; wire **`speechStart$`** /
+ * **`speechEnd$`** / **`interrupt$`** for barge-in and UI. Call **`destroy()`** when done
+ * (e.g. on `channel.events.terminated$`) to release connector and subscriptions.
  *
- * Created via `channel.createAsr(config)`. Emits partial and final
- * recognition results as Observables. Must be destroyed when no longer needed.
+ * If connector creation fails, SIP/WS return a degraded handle: VAD observables still
+ * mirror the channel where possible, but `partial$` and `result$` do not emit real STT.
  */
 export interface AsrHandle {
-    /** Unique handle identifier. */
+    /** Opaque id (passed to `channel.textInput` helpers in automated tests). */
     readonly id: string;
-    /** Emits final recognition results (complete utterances). */
+    /**
+     * Emits one string per finalized utterance (end-of-turn). Empty strings may occur;
+     * filter in application code if needed.
+     */
     readonly result$: Observable<string>;
-    /** Emits partial (intermediate) recognition results. `isFinal` = true on last partial. */
+    /**
+     * Streaming partial hypotheses. **`isFinal: true`** marks the last partial before a finalize
+     * or end-of-turn aligned with **`result$`**.
+     */
     readonly partial$: Observable<{
         text: string;
         isFinal: boolean;
     }>;
-    /** Fires when speech is detected in the audio stream. */
+    /** Fires when VAD detects speech start (user started talking). */
     readonly speechStart$: Observable<void>;
-    /** Fires when speech ends. */
+    /** Fires when VAD detects speech end (user stopped). */
     readonly speechEnd$: Observable<void>;
-    /** Fires when ASR determines the user is interrupting (barge-in). */
+    /** Fires on barge-in / interrupt signals from the ASR stack (host-specific). */
     readonly interrupt$: Observable<void>;
-    /** VAD probability stream (0.0–1.0) — useful for visualization. */
+    /** Normalized voice-activity probability 0–1 when the host exposes it; else may be inert. */
     readonly vadProbability$: Observable<number>;
-    /** Temporarily pause recognition (audio is still buffered). */
+    /** Pause forwarding new audio frames to the recognizer; skipped audio is not replayed. */
     pause(): void;
-    /** Resume recognition after pause. */
+    /** Resume after {@link pause}. */
     resume(): void;
-    /** Force-finalize the current utterance (trigger result$ immediately). */
+    /** Force end of current utterance and flush **`result$`** as soon as possible. */
     finalize(): void;
-    /** Destroy this ASR handle and release all resources. */
+    /** Tear down streams, connector, and subscriptions. Idempotent-safe on well-behaved hosts. */
     destroy(): void;
 }
 //# sourceMappingURL=asr-handle.d.ts.map

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

package/dist/types/events.d.ts

@@ -1,20 +1,20 @@
 /** DTMF digit event from the remote party. */
 export interface DtmfEvent {
-    /** The pressed digit (`"0"`–`"9"`, `"*"`, `"#"`). */
+    /** The pressed digit. SIP emits `0`–`9`, `*`, `#`; WS input also accepts `A`–`D`. */
     digit: string;
-    /** Duration of the tone in milliseconds. */
+    /** Duration of the tone in milliseconds, normalized by the channel when available. */
     duration: number;
 }
 /** Incoming SIP INFO message. */
 export interface SipInfo {
-    /** MIME content type (e.g. `"application/dtmf-relay"`). */
+    /** MIME content type (e.g. `"application/dtmf-relay"`). May be empty for low-level Sofia events. */
     contentType: string;
-    /** Message body. */
+    /** Message body. May be empty for low-level Sofia events. */
     body: string;
 }
 /** SIP call state change signal. */
 export interface SipSignal {
-    /** Call state (e.g. `"ringing"`, `"confirmed"`, `"terminated"`). */
+    /** Raw telephony/Sofia call state, not normalized to SDK `SipState`. */
     state: string;
     /** SIP response status code (e.g. `200`, `486`). */
     statusCode?: number;
@@ -23,11 +23,11 @@ export interface SipSignal {
     /** SDP body (for media negotiation events). */
     sdp?: string;
 }
-/** Arbitrary data message (used for WS data channel communication). */
+/** Arbitrary data message used for WS data-channel communication between script and client. */
 export interface DataMessage {
     /** Event name / type identifier. */
     event: string;
-    /** Event payload (any JSON-serializable data). */
+    /** Event payload. Keep it JSON-serializable for WS clients and worker proxying. */
     payload: unknown;
 }
 //# sourceMappingURL=events.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,OAAO;IACtB,oGAAoG;IACpG,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oCAAoC;AACpC,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,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,+FAA+F;AAC/F,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/legacy-phrase.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Marker for pre-recorded phrase rows loaded from the Voctiv platform LE PostgreSQL DB
+ * ({@link PlatformApi.getRecords}). Pass to {@link ChannelAudio.play} instead of a URL/path string.
+ *
+ * Only used when Voctiv platform compatibility mode is enabled and the server has resolved
+ * a trusted LE agent id/UUID plus `LEGACY_V3_RECORD_PHRASE_ROOT`.
+ */
+export declare const LEGACY_PHRASE_RECORD_BRAND: "__legacyPhraseRecord";
+export interface LegacyPhraseRecord {
+    readonly [LEGACY_PHRASE_RECORD_BRAND]: true;
+    /** Absolute filesystem path passed to the audio decoder (same layout as old logic-executor `nv.say`). */
+    readonly path: string;
+    /** Phrase transcript / label from DB. */
+    readonly text: string;
+    /** Phrase name (`record_phrase.name`). */
+    readonly phraseName: string;
+}
+export declare function isLegacyPhraseRecord(source: unknown): source is LegacyPhraseRecord;
+/** Parameters for {@link PlatformApi.getRecords} (Voctiv platform LE `RecordPhrase` / `record_phrase_file`). */
+export interface LegacyGetRecordsParams {
+    /** Phrase group/name (`record_phrase.name`). */
+    phraseName: string;
+    /** Business flag used by the phrase catalog, normally `context.flag`. */
+    flag: string;
+    /** Language key used by the phrase catalog, normally `context.language`. */
+    language: string;
+}
+/**
+ * When set on {@link PlayOptions}, after TTS the audio is copied under the Voctiv platform
+ * record-phrase root and a `record_phrase` / `record_phrase_file` row is inserted so
+ * {@link PlatformApi.getRecords} can retrieve it. Also registers the PCM in the TTS file
+ * cache for subsequent `say`/`presay`.
+ *
+ * Only honored when Voctiv platform compatibility mode is active, `LEGACY_V3_RECORD_PHRASE_ROOT`
+ * is set, TTS cache is available, and the server resolved a trusted LE agent id/UUID.
+ */
+export interface LegacySavePhraseOptions {
+    /** Phrase group/name to create or update. */
+    phraseName: string;
+    /** Defaults to dialog `flag` from channel params when omitted. */
+    flag?: string;
+    /** Defaults to dialog language from channel params when omitted. */
+    language?: string;
+}
+//# sourceMappingURL=legacy-phrase.d.ts.map

package/dist/types/legacy-phrase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-phrase.d.ts","sourceRoot":"","sources":["../../src/types/legacy-phrase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,wBAAkC,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,0BAA0B,CAAC,EAAE,IAAI,CAAC;IAC5C,yGAAyG;IACzG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,kBAAkB,CAOlF;AAED,gHAAgH;AAChH,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/legacy-phrase.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_PHRASE_RECORD_BRAND = void 0;
+exports.isLegacyPhraseRecord = isLegacyPhraseRecord;
+/**
+ * Marker for pre-recorded phrase rows loaded from the Voctiv platform LE PostgreSQL DB
+ * ({@link PlatformApi.getRecords}). Pass to {@link ChannelAudio.play} instead of a URL/path string.
+ *
+ * Only used when Voctiv platform compatibility mode is enabled and the server has resolved
+ * a trusted LE agent id/UUID plus `LEGACY_V3_RECORD_PHRASE_ROOT`.
+ */
+exports.LEGACY_PHRASE_RECORD_BRAND = '__legacyPhraseRecord';
+function isLegacyPhraseRecord(source) {
+    return (typeof source === 'object' &&
+        source !== null &&
+        source[exports.LEGACY_PHRASE_RECORD_BRAND] === true &&
+        typeof source.path === 'string');
+}
+//# sourceMappingURL=legacy-phrase.js.map

package/dist/types/legacy-phrase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-phrase.js","sourceRoot":"","sources":["../../src/types/legacy-phrase.ts"],"names":[],"mappings":";;;AAmBA,oDAOC;AA1BD;;;;;;GAMG;AACU,QAAA,0BAA0B,GAAG,sBAA+B,CAAC;AAY1E,SAAgB,oBAAoB,CAAC,MAAe;IAClD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACd,MAA6B,CAAC,kCAA0B,CAAC,KAAK,IAAI;QACnE,OAAQ,MAA6B,CAAC,IAAI,KAAK,QAAQ,CACxD,CAAC;AACJ,CAAC"}

package/dist/types/logger.d.ts

@@ -1,8 +1,10 @@
 /**
  * Structured logger available to scripts.
  *
- * In legacy compat mode, log entries are also batch-written
+ * In Voctiv platform compatibility mode, log entries are also batch-written
  * to the `dialog_stats` DB table (equivalent of old LE `nn.log`).
+ * In all modes they go to the API process logger. Debug streaming, when enabled,
+ * forwards only logs from the current script session to the configured debug endpoint.
  */
 export interface ScriptLogger {
     /** Info-level log entry. */
@@ -11,7 +13,7 @@ export interface ScriptLogger {
     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-level log entry; intended for process/debug stream output rather than legacy DB stats. */
     debug(message: string, data?: Record<string, unknown>): void;
     /**
      * Enable real-time log streaming to a remote debug endpoint.

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

@@ -1 +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"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/types/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;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,mGAAmG;IACnG,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"}