@happyrobot-ai/sdk 0.1.25 → 0.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyrobot-ai/sdk",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "TypeScript SDK for the HappyRobot Public API",
   "main": "./index.js",
   "module": "./index.mjs",

package/resources/voice.d.ts

@@ -33,9 +33,9 @@ export declare class VoiceResource {
      * Call this from your server, then pass the returned `url` and `token`
      * to the browser where they can be used to initialize `HappyRobotVoiceClient`.
      *
-     * Provide `workflow_id` to start a new call, or `session_id` to join an
-     * in-progress call. Pair `session_id` with `should_takeover: true` to drop
-     * the AI agent and take over the call.
+     * Provide `workflow_id` to start a new call, or `session_id` (with the
+     * required `should_takeover: true`) to take over an in-progress call, which
+     * drops the AI agent.
      */
     createToken(body: CreateVoiceTokenBody): Promise<CreateVoiceTokenResponse>;
 }

package/resources/voice.js

@@ -36,9 +36,9 @@ class VoiceResource {
      * Call this from your server, then pass the returned `url` and `token`
      * to the browser where they can be used to initialize `HappyRobotVoiceClient`.
      *
-     * Provide `workflow_id` to start a new call, or `session_id` to join an
-     * in-progress call. Pair `session_id` with `should_takeover: true` to drop
-     * the AI agent and take over the call.
+     * Provide `workflow_id` to start a new call, or `session_id` (with the
+     * required `should_takeover: true`) to take over an in-progress call, which
+     * drops the AI agent.
      */
     async createToken(body) {
         return this.http.request({

package/types/voice.types.d.ts

@@ -24,17 +24,17 @@ export type CreateVoiceTokenBody = (CreateVoiceTokenBase & {
     should_takeover?: never;
 }) | (CreateVoiceTokenBase & {
     /**
-     * ID of an in-progress session to join. Generates a token for the
+     * ID of an in-progress session to take over. Generates a token for the
      * session's existing LiveKit room.
      */
     session_id: string;
     workflow_id?: never;
     /**
-     * When `true`, the joining participant takes over the call and the AI
-     * agent drops. When `false` (default), the participant joins alongside
-     * the agent without dropping it.
+     * Must be `true`. Explicit opt-in confirming the joining participant
+     * takes over the call and the AI agent drops. Joining a live call
+     * without taking over is not supported.
      */
-    should_takeover?: boolean;
+    should_takeover: true;
 });
 /** POST /voice/tokens response. */
 export interface CreateVoiceTokenResponse {