@convai/web-sdk 1.8.0-beta.7 → 1.8.0

package/dist/core/MessageHandler.d.ts

@@ -9,7 +9,6 @@ import { BlendshapeQueue } from "./BlendshapeQueue.js";
 export declare class MessageHandler extends EventEmitter {
     private room;
     private chatMessages;
-    private activeBotLlmMessageId;
     private userTranscription;
     private logRtviMessages;
     private isBotResponding;
@@ -19,8 +18,7 @@ export declare class MessageHandler extends EventEmitter {
     private blendshapeQueue;
     private _currentEmotion;
     private modelOutputVersion;
-    private seenModelOutputPayloads;
-    private seenModelOutputPayloadCharacters;
+    private seenModelOutputIds;
     private seenBotOutputSegments;
     private readonly _boundHandleDataReceived;
     constructor(room?: Room);
@@ -86,8 +84,6 @@ export declare class MessageHandler extends EventEmitter {
     private handleDataReceived;
     private _handleActionResponse;
     private _handleModelOutput;
-    private _clearModelOutputReplayLedger;
-    private _handleBotLlmTextRaw;
     private lifecycleOwner;
     private numberOrUndefined;
     private transcriptionLogicalTurnId;
@@ -97,20 +93,6 @@ export declare class MessageHandler extends EventEmitter {
     handleDataReceivedPublic(payload: Uint8Array): void;
     /** Append a submitted text message without waiting for a server echo. */
     addUserTextMessage(text: string): void;
-    /**
-     * Insert a message into the transcript locally. Nothing is transmitted and
-     * no LLM turn is billed -- this is for client-side lines (a greeting, a
-     * system notice, a replayed history entry) that must appear in the chat.
-     *
-     * Subscribers see it through the same `messagesChange` as a live message,
-     * so React and the widgets pick it up with no special casing.
-     */
-    appendLocalMessage(message: {
-        sender: "user" | "bot";
-        content: string;
-        membershipId?: string;
-        characterId?: string;
-    }): ChatMessage;
     /**
      * Reset message state
      */

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

@@ -1 +1 @@
-{"version":3,"file":"MessageHandler.d.ts","sourceRoot":"","sources":["../../src/core/MessageHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAa,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,WAAW,EAQZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,OAAO,EACL,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AA8B3B;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,wBAAwB,CAAa;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAoD;IAC3E,OAAO,CAAC,kBAAkB,CAAY;IACtC,OAAO,CAAC,uBAAuB,CAAqB;IACpD,OAAO,CAAC,gCAAgC,CAAK;IAI7C,OAAO,CAAC,qBAAqB,CAA8B;IAK3D,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAG/B;gBAEE,IAAI,CAAC,EAAE,IAAI;IASvB;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI7C,8EAA8E;IAC9E,qBAAqB,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI;IAK3C;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE;IAIhC;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,UAAU,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIxD;;;OAGG;IACH,cAAc,IAAI,OAAO;IAIzB;;;;OAIG;IACH,wBAAwB,IAAI,IAAI;IAShC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAUzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAk1B1B,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,kBAAkB;IAuC1B,OAAO,CAAC,6BAA6B;IAKrC,OAAO,CAAC,oBAAoB;IAwB5B,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,0BAA0B;IAMlC;;OAEG;IACH,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAInD,yEAAyE;IACzE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYtC;;;;;;;OAOG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,WAAW;IAcf;;OAEG;IACH,KAAK,IAAI,IAAI;CAmBd"}
+{"version":3,"file":"MessageHandler.d.ts","sourceRoot":"","sources":["../../src/core/MessageHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAa,MAAM,gBAAgB,CAAC;AACjD,OAAO,EACL,WAAW,EAMZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C,OAAO,EACL,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAS3B;;;GAGG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,wBAAwB,CAAa;IAC7C,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAoD;IAC3E,OAAO,CAAC,kBAAkB,CAAY;IACtC,OAAO,CAAC,kBAAkB,CAAqB;IAI/C,OAAO,CAAC,qBAAqB,CAA8B;IAK3D,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAG/B;gBAEE,IAAI,CAAC,EAAE,IAAI;IASvB;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI7C,8EAA8E;IAC9E,qBAAqB,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI;IAK3C;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE;IAIhC;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,kBAAkB,IAAI,OAAO;IAI7B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,UAAU,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIxD;;;OAGG;IACH,cAAc,IAAI,OAAO;IAIzB;;;;OAIG;IACH,wBAAwB,IAAI,IAAI;IAShC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAUzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6gB1B,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,0BAA0B;IAMlC;;OAEG;IACH,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAInD,yEAAyE;IACzE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYtC;;OAEG;IACH,KAAK,IAAI,IAAI;CAkBd"}

package/dist/core/MessageHandler.js

@@ -1,24 +1,8 @@
 import { RoomEvent } from "livekit-client";
 import { EventEmitter } from "./EventEmitter.js";
 import { extractModelOutputPayload, parseModelOutputMessage, } from "./modelOutput.js";
-import { isValidLogicalTurnId, isValidOutputId } from "./logicalTurn.js";
+import { isValidLogicalTurnId } from "./logicalTurn.js";
 import { BlendshapeQueue, } from "./BlendshapeQueue.js";
-function stableJsonFingerprint(value) {
-    if (Array.isArray(value)) {
-        return `[${value.map(stableJsonFingerprint).join(",")}]`;
-    }
-    if (value && typeof value === "object") {
-        const entries = Object.entries(value)
-            .sort(([left], [right]) => left.localeCompare(right))
-            .map(([key, item]) => `${JSON.stringify(key)}:${stableJsonFingerprint(item)}`);
-        return `{${entries.join(",")}}`;
-    }
-    return JSON.stringify(value);
-}
-const MAX_MODEL_OUTPUT_REPLAY_FINGERPRINTS = 400;
-// Preserve exact replay matching instead of accepting hash collisions, while
-// bounding the aggregate strings retained by a long-lived v2 session.
-const MAX_MODEL_OUTPUT_REPLAY_RETAINED_CHARS = 4 * 1024 * 1024;
 /**
  * Handles incoming messages from Convai
  * Processes various message types from the AI assistant and updates chat history
@@ -28,7 +12,6 @@ export class MessageHandler extends EventEmitter {
         super();
         this.room = null;
         this.chatMessages = [];
-        this.activeBotLlmMessageId = null;
         this.userTranscription = "";
         this.logRtviMessages = true;
         this.isBotResponding = false;
@@ -37,8 +20,7 @@ export class MessageHandler extends EventEmitter {
         this.totalBlendshapesReceived = 0;
         this._currentEmotion = null;
         this.modelOutputVersion = 1;
-        this.seenModelOutputPayloads = new Set();
-        this.seenModelOutputPayloadCharacters = 0;
+        this.seenModelOutputIds = new Set();
         // bot-output segments already added to the chat. The server re-sends the
         // same segment (full text) as TTS progress advances (spoken_status
         // in-progress → completed); only the first sighting may touch the chat.
@@ -64,7 +46,7 @@ export class MessageHandler extends EventEmitter {
     /** Select the server-negotiated canonical output version for this session. */
     setModelOutputVersion(version) {
         this.modelOutputVersion = version;
-        this._clearModelOutputReplayLedger();
+        this.seenModelOutputIds.clear();
     }
     /**
      * Get current chat messages
@@ -166,23 +148,6 @@ export class MessageHandler extends EventEmitter {
             // Extract and categorize messages for chat display
             const timestamp = new Date().toISOString();
             const messageId = `${messageData.type}-${Date.now()}-${Math.random()}`;
-            // Multi-character routing identity, carried inline on every
-            // character-originated event. Undefined in single-character sessions, so
-            // these spread to nothing and every existing message keeps its shape.
-            const attribution = {
-                ...(messageData.data?.membership_id && {
-                    membershipId: messageData.data.membership_id,
-                }),
-                ...(messageData.data?.character_id && {
-                    characterId: messageData.data.character_id,
-                }),
-            };
-            /**
-             * Two instances must never share a streaming bubble. Without this a
-             * target switch mid-turn splices one character's text onto another's,
-             * because the merge would only be checking `isStreaming`.
-             */
-            const sameSpeaker = (msg) => !!msg && msg.membershipId === attribution.membershipId;
             // Handle different message types
             switch (messageData.type) {
                 // Submitted text is appended locally by sendUserTextMessage. Ignore
@@ -199,40 +164,21 @@ export class MessageHandler extends EventEmitter {
                     break;
                 // Bot Ready - Bot is ready, connection should be true
                 case "bot-ready":
-                    // `about` carries this instance's routing identity in a roster room,
-                    // and the same fields are also flattened onto `data`. Prefer `about`,
-                    // fall back to the flattened copy, and pass undefined for a
-                    // single-character session.
-                    this.emit("botReady", messageData.data?.about ??
-                        (messageData.data?.membership_id ? messageData.data : undefined));
+                    this.emit("botReady");
                     break;
                 // Bot LLM Started - Begin streaming response
                 case "bot-llm-started":
                     this.isBotResponding = true;
                     this.emit("botRespondingChange", true);
                     this.seenBotOutputSegments.clear();
-                    // Lifecycle frames do not carry output_id. In v2, keep at most one
-                    // unowned placeholder so concurrent starts cannot create anonymous
-                    // rows that later get adopted in reverse order. Invocation-correlated
-                    // chunks establish additional rows in authoritative arrival order.
-                    const hasUnownedV2Starter = this.modelOutputVersion === 2 &&
-                        this.chatMessages.some((message) => message.type === "bot-llm-text" &&
-                            message.isStreaming &&
-                            message.content === "" &&
-                            message.outputId === undefined &&
-                            message.logicalTurnId === undefined);
-                    if (hasUnownedV2Starter)
-                        break;
-                    // Add initial streaming message to chat.
+                    // Add initial streaming message to chat
                     const streamingMessage = {
                         id: messageId,
                         type: "bot-llm-text",
                         content: "",
                         timestamp: timestamp,
                         isStreaming: true,
-                        ...attribution,
                     };
-                    this.activeBotLlmMessageId = messageId;
                     this.chatMessages.push(streamingMessage);
                     this.emit("messagesChange", this.chatMessages);
                     break;
@@ -259,24 +205,17 @@ export class MessageHandler extends EventEmitter {
                                 break;
                             this.seenBotOutputSegments.add(segmentId);
                         }
-                        const activeBotLlmMessage = this.activeBotLlmMessageId
-                            ? this.chatMessages.find((message) => message.id === this.activeBotLlmMessageId)
-                            : undefined;
                         const lastMsg = this.chatMessages[this.chatMessages.length - 1];
                         // When the reply is rendered by the LLM text stream
                         // (bot-llm-text), the TTS echo adds nothing — never mix
                         // bot-output into an LLM bubble (streaming or complete).
-                        if (activeBotLlmMessage?.type === "bot-llm-text")
-                            break;
                         if (lastMsg?.type === "bot-llm-text")
                             break;
                         if (lastMsg?.type === "bot-output" &&
                             lastMsg.content.includes(newText)) {
                             break;
                         }
-                        if (lastMsg?.type === "bot-output" &&
-                            lastMsg.isStreaming &&
-                            sameSpeaker(lastMsg)) {
+                        if (lastMsg?.type === "bot-output" && lastMsg.isStreaming) {
                             this.chatMessages[this.chatMessages.length - 1] = {
                                 ...lastMsg,
                                 content: lastMsg.content + newText,
@@ -289,7 +228,6 @@ export class MessageHandler extends EventEmitter {
                                 content: newText,
                                 timestamp: new Date().toISOString(),
                                 isStreaming: true,
-                                ...attribution,
                             });
                         }
                         this.emit("messagesChange", this.chatMessages);
@@ -299,206 +237,41 @@ export class MessageHandler extends EventEmitter {
                 case "bot-llm-text":
                     if (messageData.data?.text) {
                         const newChunk = messageData.data.text;
-                        // Core adds this correlation metadata only for negotiated v2.
-                        // Legacy frames retain their exact historical shape and behavior.
-                        const outputId = this.modelOutputVersion === 2 &&
-                            isValidOutputId(messageData.data.output_id)
-                            ? messageData.data.output_id
-                            : undefined;
-                        const logicalTurnId = this.modelOutputVersion === 2 &&
-                            isValidLogicalTurnId(messageData.data.logical_turn_id)
-                            ? messageData.data.logical_turn_id
-                            : undefined;
-                        // A logical turn can contain multiple provider invocations (for
-                        // example, the response before a tool call and the continuation
-                        // after its result). Prefer the invocation id, then fall back to
-                        // the older v2 logical-turn id when Core does not send one.
-                        let targetMessageIndex = -1;
-                        if (outputId !== undefined) {
-                            for (let index = this.chatMessages.length - 1; index >= 0; index--) {
-                                const message = this.chatMessages[index];
-                                if (message.type === "bot-llm-text" &&
-                                    message.isStreaming &&
-                                    message.outputId === outputId &&
-                                    sameSpeaker(message)) {
-                                    targetMessageIndex = index;
-                                    break;
-                                }
-                            }
-                            // bot-llm-started has no correlation metadata. Let one empty,
-                            // unowned row adopt the first authoritative invocation id.
-                            if (targetMessageIndex === -1) {
-                                for (let index = this.chatMessages.length - 1; index >= 0; index--) {
-                                    const message = this.chatMessages[index];
-                                    if (message.type === "bot-llm-text" &&
-                                        message.isStreaming &&
-                                        message.content === "" &&
-                                        message.outputId === undefined &&
-                                        message.logicalTurnId === undefined &&
-                                        sameSpeaker(message)) {
-                                        targetMessageIndex = index;
-                                        break;
-                                    }
-                                }
-                            }
-                        }
-                        else if (logicalTurnId !== undefined) {
-                            for (let index = this.chatMessages.length - 1; index >= 0; index--) {
-                                const message = this.chatMessages[index];
-                                if (message.type === "bot-llm-text" &&
-                                    message.isStreaming &&
-                                    message.outputId === undefined &&
-                                    message.logicalTurnId === logicalTurnId &&
-                                    sameSpeaker(message)) {
-                                    targetMessageIndex = index;
-                                    break;
-                                }
-                            }
-                            // Older v2 Core still needs the starter-row behavior that was
-                            // introduced with logical-turn correlation.
-                            if (targetMessageIndex === -1) {
-                                const lastIndex = this.chatMessages.length - 1;
-                                const lastMessage = this.chatMessages[lastIndex];
-                                if (lastMessage?.type === "bot-llm-text" &&
-                                    lastMessage.isStreaming &&
-                                    lastMessage.content === "" &&
-                                    lastMessage.outputId === undefined &&
-                                    lastMessage.logicalTurnId === undefined &&
-                                    sameSpeaker(lastMessage)) {
-                                    targetMessageIndex = lastIndex;
-                                }
-                            }
-                        }
-                        else {
-                            // Uncorrelated (v1) chunk: it belongs to the bubble bot-llm-started
-                            // opened for this speaker. Only when no such bubble exists does the
-                            // historical "last streaming row" rule apply -- and still only for
-                            // the same speaker, so a target switch mid-turn cannot splice one
-                            // member's text onto another's row.
-                            // Ownership applies among uncorrelated rows only: an uncorrelated
-                            // chunk must never join a row that carries an output or turn id,
-                            // or a v2 correlated stream would absorb legacy text.
-                            if (this.activeBotLlmMessageId) {
-                                targetMessageIndex = this.chatMessages.findIndex((message) => message.id === this.activeBotLlmMessageId &&
-                                    message.type === "bot-llm-text" &&
-                                    message.isStreaming &&
-                                    !message.outputId &&
-                                    !message.logicalTurnId &&
-                                    sameSpeaker(message));
-                            }
-                            if (targetMessageIndex === -1) {
-                                const lastIndex = this.chatMessages.length - 1;
-                                const lastMessage = this.chatMessages[lastIndex];
-                                if (lastMessage &&
-                                    lastMessage.type === "bot-llm-text" &&
-                                    lastMessage.isStreaming &&
-                                    !lastMessage.outputId &&
-                                    !lastMessage.logicalTurnId &&
-                                    sameSpeaker(lastMessage)) {
-                                    targetMessageIndex = lastIndex;
-                                }
-                            }
-                        }
-                        let updatedMessage;
-                        if (targetMessageIndex !== -1) {
-                            const targetMessage = this.chatMessages[targetMessageIndex];
-                            updatedMessage = {
-                                ...targetMessage,
-                                content: targetMessage.content + newChunk,
-                                ...(outputId !== undefined &&
-                                    targetMessage.outputId === undefined
-                                    ? { outputId }
-                                    : {}),
-                                ...(logicalTurnId !== undefined &&
-                                    targetMessage.logicalTurnId === undefined
-                                    ? { logicalTurnId }
-                                    : {}),
+                        // Update the streaming message in chat
+                        const lastMessage = this.chatMessages[this.chatMessages.length - 1];
+                        if (lastMessage && lastMessage.isStreaming) {
+                            this.chatMessages[this.chatMessages.length - 1] = {
+                                ...lastMessage,
+                                content: lastMessage.content + newChunk,
                             };
-                            this.chatMessages[targetMessageIndex] = updatedMessage;
                         }
                         else {
                             // If no streaming message exists yet, create one
-                            updatedMessage = {
+                            const streamingMsg = {
                                 id: `${messageData.type}-${Date.now()}-${Math.random()}`,
                                 type: "bot-llm-text",
                                 content: newChunk,
                                 timestamp: new Date().toISOString(),
                                 isStreaming: true,
-                                ...(outputId ? { outputId } : {}),
-                                ...(logicalTurnId ? { logicalTurnId } : {}),
-                                ...attribution,
                             };
-                            this.activeBotLlmMessageId = updatedMessage.id;
-                            this.chatMessages.push(updatedMessage);
+                            this.chatMessages.push(streamingMsg);
                         }
-                        this.emit("messagesChange", this.chatMessages, updatedMessage);
+                        this.emit("messagesChange", this.chatMessages);
                     }
                     break;
-                // Parallel diagnostics-only provider output. This must never affect
-                // normal chat, speech, TTS, or response lifecycle state.
-                case "bot-llm-text-raw":
-                    this._handleBotLlmTextRaw(messageData.data);
-                    break;
                 // Bot LLM Stopped - Complete streaming response
-                case "bot-llm-stopped": {
-                    // A v2 response can have interleaved correlated rows. The stop event
-                    // is response-scoped, so none may remain open for later chunks.
-                    const finalizedMessages = [];
-                    if (this.modelOutputVersion === 2) {
-                        for (let index = 0; index < this.chatMessages.length; index++) {
-                            const message = this.chatMessages[index];
-                            if ((message.type === "bot-llm-text" ||
-                                message.type === "bot-output") &&
-                                message.isStreaming) {
-                                const finalizedMessage = {
-                                    ...message,
-                                    isStreaming: false,
-                                };
-                                this.chatMessages[index] = finalizedMessage;
-                                finalizedMessages.push(finalizedMessage);
-                            }
-                        }
-                    }
-                    else {
-                        // v1: a stop frame finalizes the bubble this turn owns; only when no
-                        // bubble was opened does the historical last-row rule apply.
-                        let stopIndex = this.activeBotLlmMessageId
-                            ? this.chatMessages.findIndex((message) => message.id === this.activeBotLlmMessageId)
-                            : -1;
-                        if (stopIndex === -1)
-                            stopIndex = this.chatMessages.length - 1;
-                        const lastBotMsg = this.chatMessages[stopIndex];
-                        if (lastBotMsg && lastBotMsg.isStreaming) {
-                            const finalizedMessage = { ...lastBotMsg, isStreaming: false };
-                            this.chatMessages[stopIndex] = finalizedMessage;
-                            finalizedMessages.push(finalizedMessage);
-                        }
-                    }
-                    // Clear streaming state
-                    this.isBotResponding = false;
-                    this.emit("botRespondingChange", false);
-                    // Keep the full-list event at one emission per stop while carrying
-                    // every v2 terminal delta for singular-message consumers.
-                    this.emit("messagesChange", this.chatMessages, undefined, finalizedMessages);
-                    break;
-                }
-                // Text-only Interactions API terminal marker. This is deliberately a
-                // separate event: a completed REST turn must not be represented as a
-                // synthetic bot-llm-stopped message.
-                case "bot-turn-completed":
-                    const completedIndex = this.activeBotLlmMessageId
-                        ? this.chatMessages.findIndex((message) => message.id === this.activeBotLlmMessageId)
-                        : -1;
-                    if (completedIndex >= 0 && this.chatMessages[completedIndex].isStreaming) {
-                        this.chatMessages[completedIndex] = {
-                            ...this.chatMessages[completedIndex],
+                case "bot-llm-stopped":
+                    const lastBotMsg = this.chatMessages[this.chatMessages.length - 1];
+                    if (lastBotMsg && lastBotMsg.isStreaming) {
+                        this.chatMessages[this.chatMessages.length - 1] = {
+                            ...lastBotMsg,
                             isStreaming: false,
                         };
-                        this.emit("messagesChange", this.chatMessages);
                     }
+                    // Clear streaming state
                     this.isBotResponding = false;
                     this.emit("botRespondingChange", false);
-                    this.emit("botTurnCompleted", messageData.data ?? {});
+                    this.emit("messagesChange", this.chatMessages);
                     break;
                 // User Transcription Messages
                 case "user-transcription":
@@ -508,14 +281,6 @@ export class MessageHandler extends EventEmitter {
                             const logicalTurnId = this.transcriptionLogicalTurnId(messageData.data.logical_turn_id);
                             // Final transcription - accumulate in single bubble until bot responds
                             const lastUserMsg = this.chatMessages[this.chatMessages.length - 1];
-                            // A final transcription identical to the line appended locally on send is
-                            // the server echoing that send back: drop it, or the user sees it twice.
-                            if (lastUserMsg?.type === "user-llm-text" &&
-                                lastUserMsg.content.trim() === String(messageContent).trim()) {
-                                this.userTranscription = "";
-                                this.emit("userTranscriptionChange", "");
-                                break;
-                            }
                             // Check if last message is an accumulating user message (isStreaming=true)
                             if (lastUserMsg &&
                                 lastUserMsg.type === "user-transcription" &&
@@ -560,8 +325,7 @@ export class MessageHandler extends EventEmitter {
                             emotion: messageData.data.emotion,
                             scale: messageData.data.scale,
                         };
-                        if (this.logRtviMessages)
-                            console.log("[SDK bot-emotion]", messageData.data);
+                        console.log("[SDK bot-emotion]", messageData.data);
                         this.emit("emotionChange", this._currentEmotion);
                         const emotionMessage = {
                             id: messageId,
@@ -635,14 +399,6 @@ export class MessageHandler extends EventEmitter {
                         this.emit("metrics", messageData.data);
                     }
                     break;
-                // Per-turn usage/cost breakdown. Informational only: the server streams
-                // it once the client opts in with usage-toggle, and it never affects
-                // server-side usage tracking or billing.
-                case "usage-update":
-                    if (messageData.data) {
-                        this.emit("usageUpdate", messageData.data);
-                    }
-                    break;
                 // Behavior Tree Response Messages
                 case "behavior-tree-response":
                     if (messageData.data?.narrative_section_id) {
@@ -661,22 +417,11 @@ export class MessageHandler extends EventEmitter {
                     if (messageData.data) {
                         const serverData = messageData.data;
                         switch (serverData.type) {
-                            case "bot-llm-text-raw":
-                                this._handleBotLlmTextRaw(serverData.data ?? serverData);
-                                break;
                             case "final-user-transcription":
                                 if (serverData.text) {
                                     const finalText = serverData.text;
                                     const logicalTurnId = this.transcriptionLogicalTurnId(serverData.logical_turn_id);
                                     const lastUserMsg = this.chatMessages[this.chatMessages.length - 1];
-                                    // A final transcription identical to the line appended locally on send is
-                                    // the server echoing that send back: drop it, or the user sees it twice.
-                                    if (lastUserMsg?.type === "user-llm-text" &&
-                                        lastUserMsg.content.trim() === String(finalText).trim()) {
-                                        this.userTranscription = "";
-                                        this.emit("userTranscriptionChange", "");
-                                        break;
-                                    }
                                     if (lastUserMsg &&
                                         lastUserMsg.type === "user-transcription" &&
                                         lastUserMsg.isStreaming === true) {
@@ -714,8 +459,7 @@ export class MessageHandler extends EventEmitter {
                                         emotion: serverData.emotion,
                                         scale: serverData.scale,
                                     };
-                                    if (this.logRtviMessages)
-                                        console.log("[SDK bot-emotion (ws)]", serverData);
+                                    console.log("[SDK bot-emotion (ws)]", serverData);
                                     this.emit("emotionChange", this._currentEmotion);
                                 }
                                 break;
@@ -802,35 +546,6 @@ export class MessageHandler extends EventEmitter {
                                 this.emit("serverResponse", serverResponse);
                                 break;
                             }
-                            /**
-                             * Lifecycle of one roster member. Emitted when a member is added
-                             * at runtime, becomes ready, or fails after /connect already
-                             * returned 200. `bot-ready` stays the readiness authority --
-                             * a `character-status` of "ready" must not enable interaction on
-                             * its own -- but this is the only way a background dispatch
-                             * failure is ever reported.
-                             */
-                            case "character-status": {
-                                const status = {
-                                    status: serverData.status ?? "starting",
-                                    membershipId: serverData.membership_id ?? "",
-                                    characterId: serverData.character_id ?? "",
-                                    characterSessionId: serverData.character_session_id ?? null,
-                                    participantIdentity: serverData.participant_identity ??
-                                        (serverData.membership_id
-                                            ? `character:${serverData.membership_id}`
-                                            : ""),
-                                    roomSessionId: serverData.room_session_id ?? null,
-                                    rosterEpoch: typeof serverData.roster_epoch === "number"
-                                        ? serverData.roster_epoch
-                                        : null,
-                                    failureCode: serverData.failure_code ?? null,
-                                };
-                                // Unattributable status is dropped rather than guessed at.
-                                if (status.membershipId)
-                                    this.emit("characterStatus", status);
-                                break;
-                            }
                             // interaction-created: session IDs for analytics/tracking
                             case "interaction-created": {
                                 const interactionCreated = {
@@ -898,55 +613,11 @@ export class MessageHandler extends EventEmitter {
             });
             return;
         }
-        // output_id identifies a provider invocation, not a serialized envelope.
-        // One invocation can produce distinct text and tool-call projections with
-        // the same id, and consumers must receive both in transport arrival order.
-        // Suppress only an exact transport replay of an already delivered payload.
-        const fingerprint = stableJsonFingerprint(output);
-        if (this.seenModelOutputPayloads.has(fingerprint))
-            return;
-        if (fingerprint.length > MAX_MODEL_OUTPUT_REPLAY_RETAINED_CHARS) {
-            this.emit("modelOutputProtocolError", {
-                code: "invalid_model_output",
-                message: "Core sent an oversized model-output envelope",
-            });
+        if (this.seenModelOutputIds.has(output.output_id))
             return;
-        }
-        this.seenModelOutputPayloads.add(fingerprint);
-        this.seenModelOutputPayloadCharacters += fingerprint.length;
-        while (this.seenModelOutputPayloads.size > MAX_MODEL_OUTPUT_REPLAY_FINGERPRINTS ||
-            this.seenModelOutputPayloadCharacters >
-                MAX_MODEL_OUTPUT_REPLAY_RETAINED_CHARS) {
-            const oldestFingerprint = this.seenModelOutputPayloads.values().next()
-                .value;
-            if (!oldestFingerprint)
-                break;
-            this.seenModelOutputPayloads.delete(oldestFingerprint);
-            this.seenModelOutputPayloadCharacters -= oldestFingerprint.length;
-        }
+        this.seenModelOutputIds.add(output.output_id);
         this.emit("modelOutput", output);
     }
-    _clearModelOutputReplayLedger() {
-        this.seenModelOutputPayloads.clear();
-        this.seenModelOutputPayloadCharacters = 0;
-    }
-    _handleBotLlmTextRaw(value) {
-        if (this.modelOutputVersion !== 2 || !value || typeof value !== "object") {
-            return;
-        }
-        const data = value;
-        if (typeof data.text !== "string" ||
-            !isValidLogicalTurnId(data.logical_turn_id)) {
-            return;
-        }
-        this.emit("botLlmTextRaw", {
-            text: data.text,
-            logical_turn_id: data.logical_turn_id,
-            ...(isValidOutputId(data.output_id)
-                ? { output_id: data.output_id }
-                : {}),
-        });
-    }
     lifecycleOwner(data) {
         if (!data) {
             return {};
@@ -988,41 +659,19 @@ export class MessageHandler extends EventEmitter {
         });
         this.emit("messagesChange", this.chatMessages);
     }
-    /**
-     * Insert a message into the transcript locally. Nothing is transmitted and
-     * no LLM turn is billed -- this is for client-side lines (a greeting, a
-     * system notice, a replayed history entry) that must appear in the chat.
-     *
-     * Subscribers see it through the same `messagesChange` as a live message,
-     * so React and the widgets pick it up with no special casing.
-     */
-    appendLocalMessage(message) {
-        const chatMessage = {
-            id: `local-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`,
-            type: message.sender === "user" ? "user-llm-text" : "bot-llm-text",
-            content: message.content,
-            timestamp: new Date().toISOString(),
-            ...(message.membershipId && { membershipId: message.membershipId }),
-            ...(message.characterId && { characterId: message.characterId }),
-        };
-        this.chatMessages.push(chatMessage);
-        this.emit("messagesChange", this.chatMessages);
-        return chatMessage;
-    }
     /**
      * Reset message state
      */
     reset() {
         this.chatMessages = [];
-        this.activeBotLlmMessageId = null;
         this.userTranscription = "";
         this.isBotResponding = false;
         this.isSpeaking = false;
         this.isListening = false;
         this.totalBlendshapesReceived = 0;
         this._currentEmotion = null;
+        this.seenModelOutputIds.clear();
         this.seenBotOutputSegments.clear();
-        this._clearModelOutputReplayLedger();
         this.blendshapeQueue.reset();
         this.emit("messagesChange", this.chatMessages);
         this.emit("userTranscriptionChange", "");