@convai/web-sdk 1.8.0-beta.2 → 1.8.0-beta.4

package/README.md

@@ -113,6 +113,7 @@ Full documentation is at **<a href="https://docs.convai.com/api-docs/plugins-and
 | <a href="https://docs.convai.com/api-docs/plugins-and-integrations/web-plugins/convai-web-sdk/error-handling" target="_blank" rel="noopener noreferrer">Error Handling</a>                 | `error`, `disconnect`, `serverResponse`, retry patterns                                            |
 | <a href="https://docs.convai.com/api-docs/plugins-and-integrations/web-plugins/convai-web-sdk/auth-tokens" target="_blank" rel="noopener noreferrer">Auth Tokens</a>                       | Server-side token exchange for production                                                          |
 | <a href="https://docs.convai.com/api-docs/plugins-and-integrations/web-plugins/convai-web-sdk/websocket-transport-layer" target="_blank" rel="noopener noreferrer">WebSocket Transport</a> | Alternative transport for WebRTC-constrained environments                                          |
+| <a href="https://docs.convai.com/api-docs/plugins-and-integrations/web-plugins/convai-web-sdk" target="_blank" rel="noopener noreferrer">SSE Transport</a>                         | Text-only interaction transport; the one that runs under Node                                      |
 
 ---
 
@@ -151,6 +152,35 @@ See the <a href="https://docs.convai.com/api-docs/plugins-and-integrations/web-p
 
 ---
 
+## SSE interaction transport (beta)
+
+Use the interaction API for text-only integrations that need a streamed response:
+
+```ts
+const client = new ConvaiClient({
+  apiKey: "...",
+  characterId: "...",
+  interactionApiUrl: "https://interaction-api-stg.convai.com/v1/interactions",
+});
+
+await client.connect();
+client.sendUserTextMessage("Hello!");
+```
+
+This sends each message as an SSE `POST` with `Authorization: Bearer ...`. Set `transport: "sse"`
+explicitly if preferred. SSE carries text only — no voice, video, or lipsync — and it never calls
+`/connect`, so `connect()` makes no network request and the session id arrives on the first
+interaction via the `characterSessionId` event.
+
+Because it needs neither WebRTC nor a DOM, this is the only transport that runs outside a browser.
+Import `@convai/web-sdk/core` from Node, SSR, or a serverless function — not the root or `/react`
+entry points, which pull in browser-only dependencies.
+
+The interaction API is currently reachable at staging only; a production host is planned.
+Full guide: [SSE Interaction Transport](docs/convai_sse_transport.md).
+
+---
+
 ## Vision dynamic context beta
 
 Vision dynamic context is the default WebRTC/LiveKit vision path when `enableVideo: true`. Camera, screen, canvas, and custom video tracks can feed unified vision context; set `visionInputConfig.enabled: false` only when you need to keep the video channel while opting out.

package/dist/core/AudioManager.d.ts

@@ -1,7 +1,7 @@
 import { Room } from "livekit-client";
-import { AudioControls } from "./types";
-import { EventEmitter } from "./EventEmitter";
-import type { IWebSocketSession } from "./types";
+import { AudioControls } from "./types.js";
+import { EventEmitter } from "./EventEmitter.js";
+import type { IWebSocketSession } from "./types.js";
 /**
  * Manages audio controls for LiveKit room
  * Provides methods to enable/disable microphone, manage audio devices,

package/dist/core/AudioManager.js

@@ -1,4 +1,4 @@
-import { EventEmitter } from "./EventEmitter";
+import { EventEmitter } from "./EventEmitter.js";
 /**
  * Manages audio controls for LiveKit room
  * Provides methods to enable/disable microphone, manage audio devices,

package/dist/core/ConnectionStateHandler.d.ts

@@ -1,5 +1,5 @@
 import { ConnectionState, DisconnectReason } from "livekit-client";
-import { ConvaiClientState } from "./types";
+import { ConvaiClientState } from "./types.js";
 /**
  * Handles connection state changes and disconnection logic for ConvaiClient.
  * Centralizes error handling and state management for better maintainability.

package/dist/core/ConvaiClient.d.ts

@@ -1,8 +1,8 @@
 import { Room } from "livekit-client";
-import { ConvaiConfig, ConvaiClientState, ChatMessage, IConvaiClient, AudioControls, VideoControls, ScreenShareControls, DynamicInfo, ContextUpdateOptions, UploadFileOptions, WebSocketSessionFactory, RespondModeUpdateOptions, UpdateSceneMetadataOptions, VisionStatusOptions, VisionTriggerOptions, ConnectionData } from "./types";
-import { EventEmitter } from "./EventEmitter";
-import { BlendshapeQueue } from "./BlendshapeQueue";
-import { MemoryManager } from "./MemoryManager";
+import { ConvaiConfig, ConvaiClientState, ChatMessage, IConvaiClient, AudioControls, VideoControls, ScreenShareControls, DynamicInfo, ContextUpdateOptions, UploadFileOptions, WebSocketSessionFactory, RespondModeUpdateOptions, UpdateSceneMetadataOptions, VisionStatusOptions, VisionTriggerOptions, ConnectionData, SendUserTextMessageOptions } from "./types.js";
+import { EventEmitter } from "./EventEmitter.js";
+import { BlendshapeQueue } from "./BlendshapeQueue.js";
+import { MemoryManager } from "./MemoryManager.js";
 /**
  * Main Convai client class for managing AI voice assistant connections
  * Provides complete interface for connecting to Convai's voice assistants,
@@ -60,6 +60,7 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
     private _endUserMetadata;
     private _wsSession;
     private _activeTransport;
+    private _sseSession;
     private _logRtviMessages;
     private _isDisconnecting;
     private _clientReadyRetryTimer;
@@ -193,7 +194,7 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
     /**
      * Send a text message to the character
      */
-    sendUserTextMessage(text: string): void;
+    sendUserTextMessage(text: string, options?: SendUserTextMessageOptions): void;
     /**
      * Send a trigger message to invoke specific character actions
      */

package/dist/core/ConvaiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConvaiClient.d.ts","sourceRoot":"","sources":["../../src/core/ConvaiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAML,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,EAEX,aAAa,EACb,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EAIjB,uBAAuB,EACvB,wBAAwB,EAExB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,EAGpB,cAAc,EACf,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA8BhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,YAAa,SAAQ,YAAa,YAAW,aAAa;IACrE,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,aAAa,CAA6B;IAClD;;;OAGG;IACH,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,gBAAgB,CAAkB;IAG1C,OAAO,CAAC,sBAAsB,CAA8C;IAC5E,OAAO,CAAC,wBAAwB,CAA8C;IAC9E,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAO;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IAEzD;;;;OAIG;IACH,MAAM,CAAC,0BAA0B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAKzE,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,uBAAuB,CAAyB;IAGxD,OAAO,CAAC,sBAAsB,CAAa;IAC3C,OAAO,CAAC,sBAAsB,CAAa;IAG3C,OAAO,CAAC,cAAc,CAA8B;gBAExC,MAAM,CAAC,EAAE,YAAY;IA+DjC,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,cAAc,IAAI,OAAO,GAAG,OAAO,GAAG,IAAI,CAE7C;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,YAAY,IAAI,WAAW,EAAE,CAEhC;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,IAAI,mBAAmB,IAAI,mBAAmB,CAE7C;IAED,IAAI,eAAe,IAAI,eAAe,CAErC;IAED,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,IAAI,CAExC;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqL3B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8LnD;;;;;;;;;;;;;;;;;;OAkBG;IACG,yBAAyB,CAC7B,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;;;OAIG;YACW,qBAAqB;YAuPrB,0CAA0C;IAgBxD;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAgDlC,OAAO,CAAC,yBAAyB;IAWjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOhC;;OAEG;IACH,YAAY,IAAI,IAAI;IAOpB;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmCvC;;OAEG;IACH,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IA2BvE;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAmBtC,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAwB5B;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI;IAUjE;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IASjD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAmClD,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,GAAG,IAAI;IAU9D,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,GAAG,IAAI;IAkBhE,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI;IAYnE;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAiB/C;;;OAGG;IACH,mBAAmB,CACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,EACnD,OAAO,GAAE,0BAA+B,GACvC,IAAI;IAaP,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,qBAAqB;IAe7B;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5E;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC;;;;OAIG;IACH,cAAc,IAAI,IAAI;CAMvB"}
+{"version":3,"file":"ConvaiClient.d.ts","sourceRoot":"","sources":["../../src/core/ConvaiClient.ts"],"names":[],"mappings":"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"}

package/dist/core/ConvaiClient.js

@@ -1,17 +1,19 @@
 import { Room, RoomEvent, DefaultReconnectPolicy, setLogLevel, } from "livekit-client";
 setLogLevel("warn");
-import { DisconnectReasonEnum, } from "./types";
-import { AudioManager } from "./AudioManager";
-import { VideoManager } from "./VideoManager";
-import { ScreenShareManager } from "./ScreenShareManager";
-import { MessageHandler } from "./MessageHandler";
-import { SDK_VERSION } from "../version";
-import { EventEmitter } from "./EventEmitter";
-import { MemoryManager } from "./MemoryManager";
-import { ConnectionStateHandler } from "./ConnectionStateHandler";
-import { buildBlendshapeConnectConfig } from "./connectRequest";
-import { shouldPreemptForContextUpdateResponse, shouldPreemptForExplicitRespondMode, } from "./contextUpdateRequest";
-import { resolveVisionInputConfig, serializeVisionInputConfig, } from "./visionRequest";
+import { DisconnectReasonEnum, } from "./types.js";
+import { AudioManager } from "./AudioManager.js";
+import { VideoManager } from "./VideoManager.js";
+import { ScreenShareManager } from "./ScreenShareManager.js";
+import { MessageHandler } from "./MessageHandler.js";
+import { SDK_VERSION } from "../version.js";
+import { EventEmitter } from "./EventEmitter.js";
+import { MemoryManager } from "./MemoryManager.js";
+import { ConnectionStateHandler } from "./ConnectionStateHandler.js";
+import { buildActionConnectConfig, buildBlendshapeConnectConfig, buildEmotionConnectConfig, } from "./connectRequest.js";
+import { shouldPreemptForContextUpdateResponse, shouldPreemptForExplicitRespondMode, } from "./contextUpdateRequest.js";
+import { resolveVisionInputConfig, serializeVisionInputConfig, } from "./visionRequest.js";
+import { SSESession } from "./SSESession.js";
+import { isValidLogicalTurnId } from "./logicalTurn.js";
 // Module-level registry — populated by importing @convai/web-sdk/vanilla/websocket
 let _wsFactory = null;
 function normalizeStateOfMind(value) {
@@ -92,6 +94,7 @@ export class ConvaiClient extends EventEmitter {
         this._endUserMetadata = null;
         this._wsSession = null;
         this._activeTransport = null;
+        this._sseSession = null;
         this._logRtviMessages = true;
         this._isDisconnecting = false;
         // RTVI client-ready handshake (race-proof bot-ready delivery)
@@ -377,8 +380,12 @@ export class ConvaiClient extends EventEmitter {
      * For LiveKit: publishes via the data channel.
      * For WebSocket: sends via PipecatClient.sendClientMessage (wrapped in {t,d} envelope).
      */
-    publishMessage(type, data) {
-        const message = { type, data };
+    publishMessage(type, data, id) {
+        const message = id === undefined ? { type, data } : { type, id, data };
+        if (this._activeTransport === "sse" && this._sseSession?.isConnected) {
+            this._sseSession.sendMessage(type, data, id);
+            return;
+        }
         if (this._activeTransport === "websocket" && this._wsSession?.isConnected) {
             this._wsSession.sendMessage(type, data);
         }
@@ -392,6 +399,9 @@ export class ConvaiClient extends EventEmitter {
      * Returns true when a message can be sent on the active transport.
      */
     isTransportReady() {
+        if (this._activeTransport === "sse") {
+            return this._sseSession?.isConnected ?? false;
+        }
         if (this._activeTransport === "websocket") {
             return this._wsSession?.isConnected ?? false;
         }
@@ -423,16 +433,67 @@ export class ConvaiClient extends EventEmitter {
             // Determine connection type based on enableVideo
             const connType = configWithDefaults.enableVideo ? "video" : "audio";
             this._connectionType = connType;
-            const transportType = configWithDefaults.transport ?? "livekit";
+            const transportType = configWithDefaults.transport ??
+                (configWithDefaults.interactionApiUrl ? "sse" : "livekit");
+            if (transportType === "sse" && !configWithDefaults.interactionApiUrl) {
+                throw new Error("interactionApiUrl is required when using the SSE transport");
+            }
+            if (transportType === "sse" && configWithDefaults.enableVideo) {
+                throw new Error("The SSE transport supports text interactions only");
+            }
             this._activeTransport = transportType;
             const effectiveVisionInputConfig = resolveVisionInputConfig(configWithDefaults);
-            // Prepare request body with required parameters
             // An explicit stateOfMind in the config wins; otherwise carry whatever
             // updateEmotion() last set, including before the first connect.
             const stateOfMind = configWithDefaults.stateOfMind !== undefined
                 ? normalizeStateOfMind(configWithDefaults.stateOfMind) ?? null
                 : this._stateOfMind;
             this._stateOfMind = stateOfMind;
+            if (transportType === "sse") {
+                this._sseSession = new SSESession({
+                    interactionApiUrl: configWithDefaults.interactionApiUrl,
+                    authorization: configWithDefaults.authToken ?? configWithDefaults.apiKey,
+                    characterId: configWithDefaults.characterId,
+                    getCharacterSessionId: () => this._characterSessionId,
+                    takeStateOfMind: () => {
+                        const stateOfMind = this._stateOfMind;
+                        this._stateOfMind = null;
+                        if (this._storedConfig?.stateOfMind !== undefined) {
+                            this._storedConfig = { ...this._storedConfig, stateOfMind: null };
+                        }
+                        return stateOfMind;
+                    },
+                    onCharacterSessionId: (characterSessionId) => {
+                        this._characterSessionId = characterSessionId;
+                        this.emit("characterSessionId", characterSessionId);
+                        this._storedConfig = {
+                            ...this._storedConfig,
+                            characterSessionId,
+                        };
+                    },
+                    endUserId: configWithDefaults.endUserId,
+                    endUserMetadata: configWithDefaults.endUserMetadata,
+                    enableEmotion: configWithDefaults.enableEmotion,
+                    emotionConfig: configWithDefaults.emotionConfig,
+                    actionConfig: configWithDefaults.actionConfig,
+                    debug: configWithDefaults.debug,
+                    onMessage: (payload) => this._messageHandler.handleDataReceivedPublic(payload),
+                    onError: (error) => this.emit("error", error),
+                });
+                this._sseSession.connect();
+                this._connectionType = "audio";
+                this._isBotReady = true;
+                this.updateState({
+                    isConnected: true,
+                    isConnecting: false,
+                    endUserId: configWithDefaults.endUserId ?? null,
+                    endUserMetadata: configWithDefaults.endUserMetadata ?? null,
+                });
+                this.emit("connect");
+                this.emit("botReady");
+                return;
+            }
+            // Prepare request body with required parameters
             const characterSessionIdToSend = configWithDefaults.characterSessionId ?? this._characterSessionId;
             const requestBody = {
                 character_id: configWithDefaults.characterId,
@@ -447,20 +508,8 @@ export class ConvaiClient extends EventEmitter {
                 connection_type: connType,
                 ...buildBlendshapeConnectConfig(configWithDefaults),
                 llm_provider: "dynamic",
-                ...(configWithDefaults.enableEmotion === true && {
-                    emotion_config: (() => {
-                        const cfg = configWithDefaults.emotionConfig;
-                        const provider = cfg?.provider ?? "llm";
-                        if (provider === "nrclex") {
-                            return {
-                                provider,
-                                min_word_threshold: cfg.min_word_threshold ?? 3,
-                                low_intensity_threshold: cfg.low_intensity_threshold ?? 0.33,
-                                high_intensity_threshold: cfg.high_intensity_threshold ?? 0.66,
-                            };
-                        }
-                        return { provider };
-                    })(),
+                ...(buildEmotionConnectConfig(configWithDefaults) && {
+                    emotion_config: buildEmotionConnectConfig(configWithDefaults),
                 }),
                 default_tts_enabled: configWithDefaults.ttsEnabled !== undefined
                     ? configWithDefaults.ttsEnabled
@@ -476,15 +525,8 @@ export class ConvaiClient extends EventEmitter {
                     characterSessionIdToSend !== "-1" && {
                     character_session_id: characterSessionIdToSend,
                 }),
-                ...(configWithDefaults.actionConfig && {
-                    action_config: {
-                        actions: configWithDefaults.actionConfig.actions,
-                        objects: configWithDefaults.actionConfig.objects,
-                        characters: configWithDefaults.actionConfig.characters,
-                        ...(configWithDefaults.actionConfig.current_attention_object && {
-                            current_attention_object: configWithDefaults.actionConfig.current_attention_object,
-                        }),
-                    },
+                ...(buildActionConnectConfig(configWithDefaults) && {
+                    action_config: buildActionConnectConfig(configWithDefaults),
                 }),
                 ...(configWithDefaults.dynamicInfo && {
                     dynamic_info: {
@@ -684,6 +726,10 @@ export class ConvaiClient extends EventEmitter {
         // Capture session identifiers from /connect response
         if (connectionData.character_session_id) {
             this._characterSessionId = connectionData.character_session_id;
+            // Emitted here rather than in connect(), so the proxy-auth path
+            // (connectWithConnectionData) surfaces the session id too -- both routes
+            // establish it at exactly this point.
+            this.emit("characterSessionId", connectionData.character_session_id);
             this._storedConfig = {
                 ...this._storedConfig,
                 characterSessionId: connectionData.character_session_id,
@@ -926,7 +972,12 @@ export class ConvaiClient extends EventEmitter {
      */
     async disconnect() {
         this._stopClientReadyHandshake();
-        if (this._activeTransport === "websocket" && this._wsSession) {
+        if (this._activeTransport === "sse" && this._sseSession) {
+            await this._sseSession.disconnect();
+            this._connectionStateHandler.resetConnectionState();
+            this.clearAllManagers();
+        }
+        else if (this._activeTransport === "websocket" && this._wsSession) {
             this._isDisconnecting = true;
             try {
                 await this._wsSession.disconnect();
@@ -961,6 +1012,7 @@ export class ConvaiClient extends EventEmitter {
         this._connectionType = null;
         this._activeTransport = null;
         this._wsSession = null;
+        this._sseSession = null;
         this._apiKey = null;
         this._authToken = null;
         this._characterId = null;
@@ -987,6 +1039,7 @@ export class ConvaiClient extends EventEmitter {
      */
     resetSession() {
         this._characterSessionId = "-1";
+        this.emit("characterSessionId", "-1");
         this._messageHandler.reset();
         // Clear metrics and disconnect reason when resetting session
         this.updateState({ metrics: [], disconnectReason: null });
@@ -994,11 +1047,15 @@ export class ConvaiClient extends EventEmitter {
     /**
      * Send a text message to the character
      */
-    sendUserTextMessage(text) {
+    sendUserTextMessage(text, options = {}) {
         if (!this.isTransportReady())
             return;
         if (!text || !text.trim())
             return;
+        const logicalTurnId = options?.logicalTurnId;
+        if (logicalTurnId !== undefined && !isValidLogicalTurnId(logicalTurnId)) {
+            throw new Error("logicalTurnId must be non-empty and at most 128 UTF-8 bytes");
+        }
         try {
             // Reset blendshape queue if mid-conversation, but don't interrupt the server
             if (this.blendshapeQueue.isConversationActive() ||
@@ -1015,10 +1072,32 @@ export class ConvaiClient extends EventEmitter {
                 userMessage: text.trim(),
                 timestamp: this._conversationStartTime,
             });
-            this.publishMessage("user_text_message", {
+            const userTextMessage = {
                 text: text.trim(),
                 participant_sid: this._participantSid || this._room.localParticipant?.sid,
-            });
+            };
+            const stateOfMind = normalizeStateOfMind(options.stateOfMind) ?? null;
+            if (stateOfMind)
+                this._stateOfMind = stateOfMind;
+            if (stateOfMind && this._activeTransport === "sse") {
+                this._sseSession?.sendMessages([
+                    { type: "update-emotion", data: { state_of_mind: stateOfMind } },
+                    {
+                        type: "user_text_message",
+                        data: userTextMessage,
+                        ...(logicalTurnId !== undefined ? { id: logicalTurnId } : {}),
+                    },
+                ]);
+            }
+            else {
+                if (stateOfMind) {
+                    this.publishMessage("update-emotion", {
+                        state_of_mind: stateOfMind,
+                        participant_sid: this._participantSid || this._room.localParticipant?.sid,
+                    });
+                }
+                this.publishMessage("user_text_message", userTextMessage, logicalTurnId);
+            }
         }
         catch (error) {
             throw error;
@@ -1315,6 +1394,10 @@ export class ConvaiClient extends EventEmitter {
      * the session from being disconnected due to inactivity.
      */
     resetIdleTimer() {
+        // SSE requests are one-turn streams; there is no persistent server-side
+        // realtime session for an idle timer to keep alive.
+        if (this._activeTransport === "sse")
+            return;
         if (!this.isTransportReady())
             return;
         this.publishMessage("reset-idle-timer", {