(phonic) Add min_words_to_interrupt to Phonic plugin options

.changeset/honest-chicken-fly.md

@@ -0,0 +1,5 @@
+---
+'@livekit/agents-plugin-phonic': patch
+---
+
+Add minWordsToInterrupt option to Phonic plugin

examples/src/phonic_realtime_agent.ts

@@ -33,6 +33,7 @@ export default defineAgent({
       llm: new phonic.realtime.RealtimeModel({
         voice: 'sabrina',
         audioSpeed: 1.2,
+        minWordsToInterrupt: 3,
       }),
     });
 

plugins/phonic/README.md

@@ -79,6 +79,7 @@ Set the `PHONIC_API_KEY` environment variable, or pass `apiKey` directly to `Rea
 | `audioSpeed` | `number` | Audio playback speed |
 | `phonicTools` | `string[]` | [Phonic Webhook tool](https://docs.phonic.co/docs/using-tools/tools_overview#webhook-tools) names available to the assistant |
 | `boostedKeywords` | `string[]` | Keywords to boost in speech recognition |
+| `minWordsToInterrupt` | `number` | Minimum number of user words required to interrupt the assistant |
 | `generateNoInputPokeText` | `boolean` | Auto-generate poke text when user is silent |
 | `noInputPokeSec` | `number` | Seconds of silence before sending poke message |
 | `noInputPokeText` | `string` | Poke message text (ignored when `generateNoInputPokeText` is true) |

plugins/phonic/package.json

@@ -41,7 +41,7 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "phonic": "^0.31.8"
+    "phonic": "^0.31.10"
   },
   "peerDependencies": {
     "@livekit/agents": "workspace:*",

plugins/phonic/src/realtime/realtime_model.ts

@@ -40,6 +40,7 @@ export interface RealtimeModelOptions {
   audioSpeed?: number;
   phonicTools?: string[];
   boostedKeywords?: string[];
+  minWordsToInterrupt?: number;
   generateNoInputPokeText?: boolean;
   noInputPokeSec?: number;
   noInputPokeText?: string;
@@ -116,6 +117,10 @@ export class RealtimeModel extends llm.RealtimeModel {
        * Keywords to boost in speech recognition
        */
       boostedKeywords?: string[];
+      /**
+       * Minimum number of user words required to interrupt the assistant
+       */
+      minWordsToInterrupt?: number;
       /**
        * Auto-generate poke text when user is silent
        */
@@ -181,6 +186,7 @@ export class RealtimeModel extends llm.RealtimeModel {
       audioSpeed: options.audioSpeed,
       phonicTools: options.phonicTools,
       boostedKeywords: options.boostedKeywords,
+      minWordsToInterrupt: options.minWordsToInterrupt,
       generateNoInputPokeText: options.generateNoInputPokeText,
       noInputPokeSec: options.noInputPokeSec,
       noInputPokeText: options.noInputPokeText,
@@ -502,6 +508,9 @@ export class RealtimeSession extends llm.RealtimeSession {
       audio_speed: this.options.audioSpeed,
       tools: [...(this.options.phonicTools ?? []), ...this.toolDefinitions],
       boosted_keywords: this.options.boostedKeywords,
+      ...(this.options.minWordsToInterrupt !== undefined && {
+        min_words_to_interrupt: this.options.minWordsToInterrupt,
+      }),
       generate_no_input_poke_text: this.options.generateNoInputPokeText,
       no_input_poke_sec: this.options.noInputPokeSec,
       no_input_poke_text: this.options.noInputPokeText,