@voctiv/agent-sdk 0.2.2 → 0.2.3

package/README.md

@@ -1,6 +1,6 @@
 # @voctiv/agent-sdk
 
-TypeScript SDK for scripts executed by the `node-asr-tts-connector` scripting runtime.
+TypeScript SDK for scripts executed by the `ScriptEngine` 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.
 
@@ -20,24 +20,53 @@ Scripts export a function created with `defineScript()`. The runtime loads the m
 
 ```ts
 import { defineScript } from '@voctiv/agent-sdk';
-import { firstValueFrom } from 'rxjs';
+import { filter, map, merge } from 'rxjs';
+
+const TTS_QUEUE = 1;
 
-export default defineScript(async ({ channel, logger, context, platform }) => {
-  logger.log('Script started', { dialogUuid: context.dialogUuid });
+export default defineScript(async ({ channel, logger, context }) => {
+  channel.sip.answer(); // No-op on WS/headless channels.
+  channel.sendMessage({ event: 'status', payload: 'ready' });
 
   const asr = await channel.createAsr({
     language: context.language || 'ru-RU',
-    smartTurn: { enabled: true },
+    vad: { preSpeechFrames: 20, postSpeechFrames: 4 },
+    smartTurn: { enabled: true, triggerFrames: 3, confirmMs: 50 },
   });
 
-  await channel.audio.say('Hello! How can I help you?');
-  const userText = await firstValueFrom(asr.result$);
+  // Barge-in: user speech stops only the agent TTS queue.
+  merge(asr.speechStart$, asr.partial$.pipe(filter((p) => !!p.text?.trim()))).subscribe(() => {
+    channel.audio.stop(TTS_QUEUE);
+  });
 
-  const nlu = await platform.nlu.extract(userText);
-  logger.log('NLU result', { nlu });
+  await channel.audio.say('Hi! Say anything and I will answer briefly.', {
+    queue: TTS_QUEUE,
+    alias: 'greeting',
+  });
 
-  asr.destroy();
-  return { output: { userText, nlu } };
+  asr.result$.pipe(filter((text) => !!text.trim())).subscribe((userText) => {
+    logger.log('User said', { userText });
+
+    const reply$ = channel.llm
+      .stream(`Reply briefly to the user: "${userText}"`, {
+        agentUuid: context.agentUuid,
+        dialogUuid: context.dialogUuid,
+      })
+      .pipe(map((chunk) => chunk.content));
+
+    void channel.audio.say(reply$, {
+      queue: TTS_QUEUE,
+      alias: 'reply',
+      ttsStrategy: 'sentence',
+    });
+  });
+
+  return new Promise((resolve) => {
+    channel.events.terminated$.subscribe(() => {
+      asr.destroy();
+      resolve({ output: { dialogUuid: context.dialogUuid } });
+    });
+  });
 });
 ```
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @packageDocumentation
- * **Agent scripting SDK** for `node-asr-tts-connector`: typed **`defineScript`** context,
+ * **Agent scripting SDK** for `ScriptEngine`: 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.

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * @packageDocumentation
- * **Agent scripting SDK** for `node-asr-tts-connector`: typed **`defineScript`** context,
+ * **Agent scripting SDK** for `ScriptEngine`: 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voctiv/agent-sdk",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Voctiv TypeScript agent SDK: defineScript and platform types for the voice/dialog scripting runtime.",
   "license": "UNLICENSED",
   "author": "",