@voctiv/agent-sdk 0.2.0 → 0.2.2

package/README.md

@@ -0,0 +1,458 @@
+# @voctiv/agent-sdk
+
+TypeScript SDK for scripts executed by the `node-asr-tts-connector` scripting runtime.
+
+The package exports the `defineScript()` identity helper and the public runtime types for voice channels, SIP calls, ASR, TTS, VAD, Smart Turn, LLM, dialog context, logging, and Voctiv legacy platform compatibility APIs.
+
+Runtime behavior is provided by `apps/api`. The SDK itself does not open SIP calls, run ASR/TTS, or talk to platform services; it describes the objects injected into your script by the host.
+
+## Installation
+
+```bash
+npm install @voctiv/agent-sdk rxjs
+```
+
+`rxjs` is a peer dependency because the runtime API exposes observables for ASR, SIP, channel events, queues, and LLM streams.
+
+## Basic Script
+
+Scripts export a function created with `defineScript()`. The runtime loads the module and calls it with `{ channel, logger, context, platform }`.
+
+```ts
+import { defineScript } from '@voctiv/agent-sdk';
+import { firstValueFrom } from 'rxjs';
+
+export default defineScript(async ({ channel, logger, context, platform }) => {
+  logger.log('Script started', { dialogUuid: context.dialogUuid });
+
+  const asr = await channel.createAsr({
+    language: context.language || 'ru-RU',
+    smartTurn: { enabled: true },
+  });
+
+  await channel.audio.say('Hello! How can I help you?');
+  const userText = await firstValueFrom(asr.result$);
+
+  const nlu = await platform.nlu.extract(userText);
+  logger.log('NLU result', { nlu });
+
+  asr.destroy();
+  return { output: { userText, nlu } };
+});
+```
+
+## What The SDK Contains
+
+`defineScript(fn)` marks the default export as the script entry point. It returns the same function and exists to give TypeScript the correct `ScriptContext` shape.
+
+`ScriptContext` is the top-level object passed to a script:
+
+- `channel` is the media channel for SIP, WS, ASR, TTS, audio playback, LLM, and structured data messages.
+- `logger` writes structured script logs and can stream logs to a debug endpoint.
+- `context` contains dialog identity, caller/called numbers, language, flags, params, entry point, persisted env, and runtime budget.
+- `platform` exposes legacy platform operations: NLU, dialog state, outbound call scheduling, messaging, and phrase records.
+
+`MediaChannel` is the main real-time API:
+
+- `channel.type` is `"sip"` for telephony and `"ws"` for WebSocket/script-manager sessions. Headless sessions currently expose a synthetic `"ws"` channel; check `context.headless` to detect them.
+- `channel.params` is the merged runtime parameter map. Treat unknown keys as host-specific.
+- `channel.createAsr()` creates an ASR handle.
+- `channel.audio` controls TTS, raw playback, pre-synthesis, and mixer queues.
+- `channel.sip` controls SIP state, pre-answer media, DTMF, hold/mute/hangup, outbound calls, and bridging.
+- `channel.llm` talks to the Omni LLM backend.
+- `channel.events` exposes speech, interrupt, termination, and WS data message observables.
+- `channel.textInput` injects synthetic ASR results for tests and debug clients.
+
+## SIP And Pre-Answer Media
+
+SIP sessions expose call state through `channel.sip.state`, `state$`, `progress$`, `early$`, and `answered$`.
+
+The important states are:
+
+- `ringing`: INVITE is in progress, but no media is available yet.
+- `early`: RTP is ready before the final 200 OK answer. ASR, TTS, playback, and DTMF work in this state.
+- `active`: final 200 OK has been received or sent.
+- `terminated`: the call ended and no more audio is possible.
+
+### Outbound Pre-Answer
+
+For outbound calls, early media starts when the remote side sends a provisional response with SDP, usually `183 Session Progress`. This is useful for IVRs that speak before answering.
+
+```ts
+const bLeg = await channel.sip.makeCall({
+  sipUri: 'sip:+12025551234@trunk.example.com',
+});
+
+await bLeg.sip.waitForEarly();
+
+const asr = await bLeg.createAsr({ language: 'en-US' });
+asr.result$.subscribe((text) => {
+  if (/press one/i.test(text)) {
+    bLeg.sip.sendDtmf('1');
+  }
+});
+```
+
+`waitForEarly()` resolves when the call reaches either `early` or `active`. If a carrier skips early media and answers directly, it resolves on the final answer.
+
+### Inbound Pre-Answer
+
+For inbound calls, call `channel.sip.sendProgress()` to send `183 Session Progress` with SDP. This enters `early` state and enables full-duplex audio before the final answer.
+
+```ts
+import { firstValueFrom } from 'rxjs';
+
+channel.sip.sendProgress();
+await channel.sip.waitForEarly();
+
+const asr = await channel.createAsr({ language: 'en-US' });
+await channel.audio.say('Please say your account number.');
+
+const account = await firstValueFrom(asr.result$);
+
+channel.sip.answer();
+await channel.audio.say(`Thank you. Looking up account ${account}.`);
+```
+
+The API does not mark the call as answered until `answer()` sends final `200 OK`. External billing still depends on carrier policy.
+
+### Audio Auto-Wait
+
+On SIP channels, `channel.audio.say()` and `channel.audio.play()` automatically wait until RTP is ready (`early` or `active`). You only need explicit `waitForEarly()` / `waitForAnswer()` when your script logic depends on the state transition.
+
+If the call terminates before media becomes available, deferred audio resolves as a no-op.
+
+### SIP Controls
+
+`channel.sip` also supports:
+
+- `answer()` for inbound final answer.
+- `sendDtmf(digit, duration?)` for IVR navigation.
+- `sendInfo(contentType, body)` for SIP INFO messages.
+- `hold()` / `unhold()` for SIP hold.
+- `mute()` / `unmute()` for local outgoing audio suppression.
+- `hangup()` to terminate the call.
+- `makeCall()` to create an outbound SIP B-leg from the main SIP channel.
+- `bridge(other)` to cross-connect two SIP channels.
+
+`makeCall()` and `bridge()` are only supported by the main SIP channel. Worker-isolated, WS, and headless channels do not create nested SIP legs.
+
+## ASR, VAD, And Smart Turn
+
+Create ASR with `channel.createAsr(config?)`.
+
+```ts
+const asr = await channel.createAsr({
+  vendor: 'Y',
+  name: 'main-yandex-key',
+  language: 'ru-RU',
+  vad: {
+    positiveThreshold: 0.55,
+    negativeThreshold: 0.35,
+    preSpeechFrames: 12,
+    postSpeechFrames: 12,
+  },
+  smartTurn: {
+    enabled: true,
+    silenceTimeoutMs: 1200,
+  },
+});
+```
+
+`AsrHandle` exposes:
+
+- `result$`: finalized utterances.
+- `partial$`: streaming partial hypotheses.
+- `speechStart$` / `speechEnd$`: VAD speech boundaries.
+- `interrupt$`: barge-in / interrupt events where the host supports them.
+- `vadProbability$`: normalized VAD probability when available.
+- `pause()` / `resume()` to stop or resume forwarding new audio frames.
+- `finalize()` to force the current utterance to flush.
+- `destroy()` to close connector streams and subscriptions.
+
+SIP sessions use the call-level telephony VAD when it is available. WS sessions create one VAD/SmartTurn instance for the socket session on the first `createAsr()` call. Headless sessions return an inert ASR handle with empty observables.
+
+If ASR connector creation fails, SIP/WS return a degraded handle. VAD observables still mirror the channel where possible, but no real STT results are emitted.
+
+## ASR Credentials And Vendors
+
+`AsrConfig.vendor` is an engine hint, for example `"Y"`, `"D"`, `"yandex"`, or `"neuro_v3"`, resolved by the host vendor alias mapping.
+
+In Voctiv legacy compatibility mode, ASR credentials can be selected by logic-executor `key_storage.name`:
+
+```ts
+const asr = await channel.createAsr({
+  name: 'main-asr-key',
+  language: 'ru-RU',
+});
+```
+
+The runtime looks in `channel.params.authentication_data.legacyAsrKeysByName[name]` for the current dialog agent and company. If `name` is omitted, `channel.params.defaultAsrName` may be used. Vendor-specific overrides go into `data`; primitives are stringified and objects/arrays are JSON-serialized before connector config is built.
+
+## TTS, Playback, And Mixer Queues
+
+`channel.audio.say(textOrObservable, options?)` synthesizes text and plays it through the mixer.
+
+```ts
+await channel.audio.say('Please wait while I check that.', {
+  queue: 0,
+  alias: 'main-response',
+  ttsVendor: 'E',
+  ttsStrategy: 'sentence',
+  ttsConfig: {
+    voice_id: 'voice-id',
+    output_format: 'pcm_16000',
+  },
+});
+```
+
+`channel.audio.play(source, options?)` plays raw audio from a URL/path or a `LegacyPhraseRecord`.
+
+```ts
+await channel.audio.play('/opt/prompts/welcome.wav', {
+  queue: 1,
+  alias: 'welcome-earcon',
+});
+```
+
+`channel.audio.presay(text, options?)` pre-synthesizes TTS into the host TTS cache. If the cache is not available, the runtime logs a warning and resolves without throwing.
+
+`channel.audio.preload(source)` decodes a raw audio source through the audio player. It does not synthesize TTS and does not populate the TTS cache used by `presay()`.
+
+### TTS Strategies
+
+`ttsStrategy` controls how text is chunked:
+
+- `sentence`: split on sentence boundaries and synthesize each sentence. This is the default.
+- `streaming`: send chunks incrementally for streaming-capable vendors.
+- `full`: accumulate the whole input and synthesize it as one segment after the input completes.
+
+When using an `Observable<string>` input, WS clients also receive text progress events for streamed chunks.
+
+### Mixer Queues
+
+The mixer has queues `0` through `4`. Use separate queues for main speech, earcons, hold music, or background audio.
+
+```ts
+const music = channel.audio.queue(2);
+music.volume = 0.25;
+
+await channel.audio.play('/opt/audio/hold.wav', {
+  queue: 2,
+  alias: 'hold-music',
+  loop: true,
+});
+
+channel.audio.stop(2);
+```
+
+`PlayOptions.volume` changes the whole queue volume, not just one item. `stop(queue)` clears a queue and aborts in-flight sentence TTS for that queue. `stopAll()` clears every queue.
+
+For sentence-split TTS, internal queue item aliases are suffixed as `alias-0`, `alias-1`, and so on. Raw `play()` and direct streaming TTS use the alias exactly.
+
+## TTS Credentials And Saved Phrases
+
+In Voctiv legacy compatibility mode, TTS credentials can be selected by `PlayOptions.name` or `ttsConfig.name`.
+
+```ts
+await channel.audio.say('Здравствуйте!', {
+  name: 'main-tts-key',
+  ttsConfig: {
+    voice: 'alena',
+  },
+});
+```
+
+The runtime looks in `channel.params.authentication_data.legacyTtsKeysByName[name]`. If `name` is omitted, `channel.params.defaultTtsName` may be used.
+
+`legacySavePhrase` stores synthesized audio under the Voctiv record phrase storage root and inserts phrase metadata so it can later be loaded with `platform.getRecords()`.
+
+```ts
+await channel.audio.say('Welcome back.', {
+  legacySavePhrase: {
+    phraseName: 'welcome_back',
+    flag: context.flag,
+    language: context.language,
+  },
+});
+
+const records = await platform.getRecords?.({
+  phraseName: 'welcome_back',
+  flag: context.flag,
+  language: context.language,
+});
+
+if (records?.[0]) {
+  await channel.audio.play(records[0]);
+}
+```
+
+This requires legacy compatibility mode, a trusted LE agent id/UUID, TTS cache, and `LEGACY_V3_RECORD_PHRASE_ROOT`.
+
+## LLM API
+
+`channel.llm` talks to the Omni LLM backend.
+
+```ts
+const answer = await channel.llm.ask('Summarize the user request', {
+  role: 'assistant',
+  hidden: true,
+  agentUuid: context.agentUuid,
+});
+
+await channel.audio.say(answer);
+```
+
+For streaming:
+
+```ts
+const stream$ = channel.llm.stream('Answer briefly', {
+  role: 'assistant',
+});
+
+await channel.audio.say(
+  stream$.pipe(map((chunk) => chunk.content)),
+  { ttsStrategy: 'streaming' },
+);
+```
+
+`channel.llm.extract(options?)` runs structured extraction via Omni. `makePersistentStream(options?)` opens a long-lived Socket.IO stream and lets you send multiple turns without reconnecting.
+
+## Platform API
+
+`platform` exposes Voctiv legacy-compatible operations.
+
+`platform.nlu.extract(utterance, options?)` calls NLU v3 `/infer`. The runtime sends `phrase`, `context`, and `agent_id`. If `options.context` is omitted, current dialog params are serialized and used as NLU context.
+
+```ts
+const result = await platform.nlu.extract('I want to reschedule', {
+  intents: ['reschedule', 'cancel'],
+  entities: ['date', 'time'],
+  use_synonyms: true,
+});
+```
+
+Legacy platform APIs require `context.legacyV3Compat === true` in the current `apps/api` runtime. This includes NLU, outbound calls, dialog writes, messaging sends, and phrase records.
+
+### Dialog State
+
+```ts
+platform.dialog.entryPoint = 'on_recall';
+platform.dialog.result = 'done';
+```
+
+Setters update the local value immediately and ask the platform DB to persist asynchronously. They are not awaitable and should not be used as transactional writes.
+
+### Outbound Calls
+
+```ts
+await platform.call('+12025551234', {
+  date: new Date(Date.now() + 60_000),
+  entryPoint: 'on_callback',
+  recallCount: 2,
+  recallDelay: 300,
+  priority: 10,
+});
+```
+
+This creates a row in the legacy `call` table. The dialer picks it up and originates the SIP call.
+
+### Messaging
+
+```ts
+await platform.messaging.send({
+  src: 'bot',
+  destination: '+12025551234',
+  text: 'Your appointment is confirmed.',
+});
+```
+
+Outbound messages are transported through legacy Redis streams. `platform.messaging.message$` currently replays the inbound message that started a headless messaging script; it is not a live subscription to all future Redis messages.
+
+## Dialog Context And Persisted Env
+
+`context` includes identity, telephony fields, params, routing metadata, and runtime helpers.
+
+Important fields:
+
+- `context.dialogUuid`: current dialog UUID.
+- `context.callerId` / `context.msisdn`: caller identity.
+- `context.destinationNumber`: called number.
+- `context.language` / `context.lang`: language selected for the run.
+- `context.flag`: business flag.
+- `context.initialData`: shallow snapshot of params at script start.
+- `context.dialogParams`: live param map for the run.
+- `context.entryPoint`: current routing entry point.
+- `context.headless`: true for offline/queue/messaging sessions without a real media channel.
+- `context.runTime`: async execution budget helper.
+- `context.env$`: persisted dialog environment as an RxJS `BehaviorSubject`.
+
+Use `env$` for persisted script state:
+
+```ts
+const current = context.env$?.getValue() ?? {};
+context.env$?.next({
+  ...current,
+  lastIntent: 'reschedule',
+});
+```
+
+Do not return `env` from the script. The runtime snapshots `context.env$` after completion and attaches it to the persisted result.
+
+## Logging And Debugging
+
+Use `logger.log()`, `warn()`, `error()`, and `debug()` for structured logs.
+
+```ts
+logger.log('ASR result received', { text });
+logger.warn('Low confidence intent', { confidence });
+```
+
+`logger.enableDebug(endpoint)` streams logs from the current script instance to a remote debug endpoint. `logger.breakpoint(label, snapshot?)` pauses only when an active debug session is connected; otherwise it resolves immediately.
+
+## WS And Headless Behavior
+
+WS channels behave like active media channels:
+
+- `channel.sip.state` is effectively active.
+- `sendDtmf()` emits `dtmf-send` to the WS client.
+- `sendMessage()` emits a structured `data` event.
+- ASR reads socket audio frames or synthetic text input.
+
+Headless channels are for offline, queue, or messaging sessions:
+
+- Audio methods are no-ops that log warnings.
+- SIP methods are mostly no-ops.
+- `createAsr()` returns an inert handle.
+- LLM and platform APIs still work.
+
+Use `context.headless` to branch when a script must behave differently without a real media channel.
+
+## Text Input For Tests
+
+`channel.textInput` injects synthetic ASR output into a live ASR handle.
+
+```ts
+const asr = await channel.createAsr();
+
+channel.textInput.pushPartial(asr.id, 'hello', false);
+channel.textInput.pushResult(asr.id, 'hello world');
+```
+
+This is mainly for WS debug clients and automated tests. Unknown ASR ids are ignored.
+
+## Package Notes
+
+The package is published as CommonJS with TypeScript declarations in `dist`.
+
+Build locally with:
+
+```bash
+npm run build
+```
+
+The package exports only the public SDK entry point:
+
+```ts
+import { defineScript, type MediaChannel, type AsrHandle } from '@voctiv/agent-sdk';
+```

package/dist/define-script.d.ts

@@ -6,20 +6,32 @@ import type { LegacyGetRecordsParams, LegacyPhraseRecord } from './types/legacy-
 /**
  * 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>;
 }
@@ -51,7 +63,14 @@ 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;
     /**
      * **Snapshot** of dialog/session payload when the script run started.
@@ -78,16 +97,19 @@ export interface ScriptDialogContext {
     /** `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 Voctiv platform 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 the Voctiv platform database. */
@@ -173,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 Voctiv platform database (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;
@@ -212,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;
@@ -237,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 {
     /**
@@ -257,11 +292,12 @@ export interface MessagingApi {
  * Platform API — Voctiv platform–compatible operations available to scripts.
  *
  * Provides access to NLU, dialog state management, outbound call scheduling,
- * and messaging. Only functional in Voctiv platform 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;

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.map

@@ -1 +1 @@
-{"version":3,"file":"define-script.js","sourceRoot":"","sources":["../src/define-script.ts"],"names":[],"mappings":";;AAoYA,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":";;AAwaA,oCAEC;AA3BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,YAAY,CAAC,EAAY;IACvC,OAAO,EAAE,CAAC;AACZ,CAAC"}