@exotel-npm-dev/exotel-ai-assist 1.3.0 → 1.3.1

package/dist/controller/index.js

@@ -349,7 +349,7 @@ class BroadcastChannelTransport {
     const lockName = `exotel-ai-assist-leader:${sessionHash}`;
     this.channel = new BroadcastChannel(channelName);
     this.channel.onmessage = ev => {
-      var _a;
+      var _a, _b, _c;
       const data = ev.data;
       if (this.isLeader) {
         if (data.type === "JOIN" && this.socketConnected && this.ackPayload) {
@@ -361,11 +361,18 @@ class BroadcastChannelTransport {
             payload: this.ackPayload
           });
         }
+        if (data.type === "SEND" && ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
+          this.socket.send(data.payload);
+        }
+        if (data.type === "FEEDBACK_SYNC") {
+          (_b = this.handler) === null || _b === void 0 ? void 0 : _b.call(this, data);
+        }
         return;
       }
-      // Follower: forward every message except JOIN to the controller handler.
-      if (data.type !== "JOIN") {
-        (_a = this.handler) === null || _a === void 0 ? void 0 : _a.call(this, data);
+      // Follower: forward server messages to the controller handler.
+      // JOIN and SEND are internal transport messages, not controller messages.
+      if (data.type !== "JOIN" && data.type !== "SEND") {
+        (_c = this.handler) === null || _c === void 0 ? void 0 : _c.call(this, data);
       }
     };
     this._electLeader(lockName);
@@ -475,8 +482,15 @@ class BroadcastChannelTransport {
   }
   send(payload) {
     var _a;
-    if (this.isLeader && ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
-      this.socket.send(payload);
+    if (this.isLeader) {
+      if (((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
+        this.socket.send(payload);
+      }
+    } else {
+      this.channel.postMessage({
+        type: "SEND",
+        payload
+      });
     }
   }
   onMessage(handler) {
@@ -485,6 +499,14 @@ class BroadcastChannelTransport {
   markAcknowledged(rawAckPayload) {
     this.ackPayload = rawAckPayload;
   }
+  broadcastFeedbackSync(sequence, feedbackType, badFeedbackReason) {
+    this.channel.postMessage({
+      type: "FEEDBACK_SYNC",
+      sequence,
+      feedbackType,
+      badFeedbackReason
+    });
+  }
   destroy() {
     var _a;
     if (this.isLeader) {
@@ -1685,6 +1707,7 @@ class ExotelAIAssistController extends EventEmitter {
     };
     try {
       this.transport.send(JSON.stringify(message));
+      this.transport.broadcastFeedbackSync(sequence, feedbackType, badFeedbackReason);
       return true;
     } catch (error) {
       console.error("[ExotelAIAssist] Failed to send feedback:", error);
@@ -1728,6 +1751,13 @@ class ExotelAIAssistController extends EventEmitter {
       case "MESSAGE":
         if (msg.payload) this._handleServerPayload(msg.payload);
         break;
+      case "FEEDBACK_SYNC":
+        this.emit("suggestionFeedbackSync", {
+          sequence: msg.sequence,
+          feedbackType: msg.feedbackType,
+          badFeedbackReason: msg.badFeedbackReason
+        });
+        break;
     }
   }
   _scheduleReconnect() {

package/dist/index.js

@@ -19791,7 +19791,7 @@ class BroadcastChannelTransport {
     const lockName = `exotel-ai-assist-leader:${sessionHash}`;
     this.channel = new BroadcastChannel(channelName);
     this.channel.onmessage = ev => {
-      var _a;
+      var _a, _b, _c;
       const data = ev.data;
       if (this.isLeader) {
         if (data.type === "JOIN" && this.socketConnected && this.ackPayload) {
@@ -19803,11 +19803,18 @@ class BroadcastChannelTransport {
             payload: this.ackPayload
           });
         }
+        if (data.type === "SEND" && ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
+          this.socket.send(data.payload);
+        }
+        if (data.type === "FEEDBACK_SYNC") {
+          (_b = this.handler) === null || _b === void 0 ? void 0 : _b.call(this, data);
+        }
         return;
       }
-      // Follower: forward every message except JOIN to the controller handler.
-      if (data.type !== "JOIN") {
-        (_a = this.handler) === null || _a === void 0 ? void 0 : _a.call(this, data);
+      // Follower: forward server messages to the controller handler.
+      // JOIN and SEND are internal transport messages, not controller messages.
+      if (data.type !== "JOIN" && data.type !== "SEND") {
+        (_c = this.handler) === null || _c === void 0 ? void 0 : _c.call(this, data);
       }
     };
     this._electLeader(lockName);
@@ -19917,8 +19924,15 @@ class BroadcastChannelTransport {
   }
   send(payload) {
     var _a;
-    if (this.isLeader && ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
-      this.socket.send(payload);
+    if (this.isLeader) {
+      if (((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
+        this.socket.send(payload);
+      }
+    } else {
+      this.channel.postMessage({
+        type: "SEND",
+        payload
+      });
     }
   }
   onMessage(handler) {
@@ -19927,6 +19941,14 @@ class BroadcastChannelTransport {
   markAcknowledged(rawAckPayload) {
     this.ackPayload = rawAckPayload;
   }
+  broadcastFeedbackSync(sequence, feedbackType, badFeedbackReason) {
+    this.channel.postMessage({
+      type: "FEEDBACK_SYNC",
+      sequence,
+      feedbackType,
+      badFeedbackReason
+    });
+  }
   destroy() {
     var _a;
     if (this.isLeader) {
@@ -21127,6 +21149,7 @@ class ExotelAIAssistController extends EventEmitter {
     };
     try {
       this.transport.send(JSON.stringify(message));
+      this.transport.broadcastFeedbackSync(sequence, feedbackType, badFeedbackReason);
       return true;
     } catch (error) {
       console.error("[ExotelAIAssist] Failed to send feedback:", error);
@@ -21170,6 +21193,13 @@ class ExotelAIAssistController extends EventEmitter {
       case "MESSAGE":
         if (msg.payload) this._handleServerPayload(msg.payload);
         break;
+      case "FEEDBACK_SYNC":
+        this.emit("suggestionFeedbackSync", {
+          sequence: msg.sequence,
+          feedbackType: msg.feedbackType,
+          badFeedbackReason: msg.badFeedbackReason
+        });
+        break;
     }
   }
   _scheduleReconnect() {
@@ -21325,13 +21355,26 @@ function useExotelAIAssist(params) {
     });
     ctrl.on("streamState", setStreamState);
     ctrl.on("botConfig", setBotConfig);
-    ctrl.on("suggestion", s => setSuggestions(prev => [...prev, s].slice(-50)));
+    ctrl.on("suggestion", s => setSuggestions(prev => {
+      if (prev.some(existing => existing.sequence === s.sequence)) return prev;
+      return [...prev, s].slice(-50);
+    }));
     ctrl.on("sentiment", setSentiment);
     ctrl.on("transcript", lines => setTranscripts(prev => {
       const map = new Map(prev.map(l => [l.id, l]));
       for (const l of lines) map.set(l.id, l);
       return Array.from(map.values()).sort((a, b) => a.startTime - b.startTime);
     }));
+    ctrl.on("suggestionFeedbackSync", ({
+      sequence,
+      feedbackType,
+      badFeedbackReason
+    }) => {
+      setSuggestions(prev => prev.map(s => s.sequence === sequence ? Object.assign(Object.assign({}, s), {
+        feedbackType,
+        badFeedbackReason
+      }) : s));
+    });
     ctrl.on("error", setLastError);
     ctrl.connect();
     return () => {

package/dist/react/index.js

@@ -5077,7 +5077,7 @@ class BroadcastChannelTransport {
     const lockName = `exotel-ai-assist-leader:${sessionHash}`;
     this.channel = new BroadcastChannel(channelName);
     this.channel.onmessage = ev => {
-      var _a;
+      var _a, _b, _c;
       const data = ev.data;
       if (this.isLeader) {
         if (data.type === "JOIN" && this.socketConnected && this.ackPayload) {
@@ -5089,11 +5089,18 @@ class BroadcastChannelTransport {
             payload: this.ackPayload
           });
         }
+        if (data.type === "SEND" && ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
+          this.socket.send(data.payload);
+        }
+        if (data.type === "FEEDBACK_SYNC") {
+          (_b = this.handler) === null || _b === void 0 ? void 0 : _b.call(this, data);
+        }
         return;
       }
-      // Follower: forward every message except JOIN to the controller handler.
-      if (data.type !== "JOIN") {
-        (_a = this.handler) === null || _a === void 0 ? void 0 : _a.call(this, data);
+      // Follower: forward server messages to the controller handler.
+      // JOIN and SEND are internal transport messages, not controller messages.
+      if (data.type !== "JOIN" && data.type !== "SEND") {
+        (_c = this.handler) === null || _c === void 0 ? void 0 : _c.call(this, data);
       }
     };
     this._electLeader(lockName);
@@ -5203,8 +5210,15 @@ class BroadcastChannelTransport {
   }
   send(payload) {
     var _a;
-    if (this.isLeader && ((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
-      this.socket.send(payload);
+    if (this.isLeader) {
+      if (((_a = this.socket) === null || _a === void 0 ? void 0 : _a.readyState) === WebSocket.OPEN) {
+        this.socket.send(payload);
+      }
+    } else {
+      this.channel.postMessage({
+        type: "SEND",
+        payload
+      });
     }
   }
   onMessage(handler) {
@@ -5213,6 +5227,14 @@ class BroadcastChannelTransport {
   markAcknowledged(rawAckPayload) {
     this.ackPayload = rawAckPayload;
   }
+  broadcastFeedbackSync(sequence, feedbackType, badFeedbackReason) {
+    this.channel.postMessage({
+      type: "FEEDBACK_SYNC",
+      sequence,
+      feedbackType,
+      badFeedbackReason
+    });
+  }
   destroy() {
     var _a;
     if (this.isLeader) {
@@ -6413,6 +6435,7 @@ class ExotelAIAssistController extends EventEmitter {
     };
     try {
       this.transport.send(JSON.stringify(message));
+      this.transport.broadcastFeedbackSync(sequence, feedbackType, badFeedbackReason);
       return true;
     } catch (error) {
       console.error("[ExotelAIAssist] Failed to send feedback:", error);
@@ -6456,6 +6479,13 @@ class ExotelAIAssistController extends EventEmitter {
       case "MESSAGE":
         if (msg.payload) this._handleServerPayload(msg.payload);
         break;
+      case "FEEDBACK_SYNC":
+        this.emit("suggestionFeedbackSync", {
+          sequence: msg.sequence,
+          feedbackType: msg.feedbackType,
+          badFeedbackReason: msg.badFeedbackReason
+        });
+        break;
     }
   }
   _scheduleReconnect() {
@@ -6611,13 +6641,26 @@ function useExotelAIAssist(params) {
     });
     ctrl.on("streamState", setStreamState);
     ctrl.on("botConfig", setBotConfig);
-    ctrl.on("suggestion", s => setSuggestions(prev => [...prev, s].slice(-50)));
+    ctrl.on("suggestion", s => setSuggestions(prev => {
+      if (prev.some(existing => existing.sequence === s.sequence)) return prev;
+      return [...prev, s].slice(-50);
+    }));
     ctrl.on("sentiment", setSentiment);
     ctrl.on("transcript", lines => setTranscripts(prev => {
       const map = new Map(prev.map(l => [l.id, l]));
       for (const l of lines) map.set(l.id, l);
       return Array.from(map.values()).sort((a, b) => a.startTime - b.startTime);
     }));
+    ctrl.on("suggestionFeedbackSync", ({
+      sequence,
+      feedbackType,
+      badFeedbackReason
+    }) => {
+      setSuggestions(prev => prev.map(s => s.sequence === sequence ? Object.assign(Object.assign({}, s), {
+        feedbackType,
+        badFeedbackReason
+      }) : s));
+    });
     ctrl.on("error", setLastError);
     ctrl.connect();
     return () => {

package/dist/transport/index.d.ts

@@ -8,6 +8,8 @@ export interface ITransport {
     /** Store the raw ack payload so follower tabs joining later receive it as a
      *  MESSAGE replay instead of a bare ACKNOWLEDGED signal. */
     markAcknowledged(rawAckPayload: string): void;
+    /** Broadcast a feedback state change to other tabs for UI sync. */
+    broadcastFeedbackSync(sequence: number, feedbackType: "good" | "bad" | null, badFeedbackReason: string | null): void;
     destroy(): void;
 }
 export declare class BroadcastChannelTransport implements ITransport {
@@ -35,6 +37,7 @@ export declare class BroadcastChannelTransport implements ITransport {
     send(payload: string): void;
     onMessage(handler: TransportMessageHandler): void;
     markAcknowledged(rawAckPayload: string): void;
+    broadcastFeedbackSync(sequence: number, feedbackType: "good" | "bad" | null, badFeedbackReason: string | null): void;
     destroy(): void;
 }
 export declare function createTransport(sessionHash: string): ITransport;

package/dist/types/index.d.ts

@@ -117,6 +117,12 @@ export interface ControllerEvents {
     statusChange: (status: ConnectionStatus) => void;
     /** Fires whenever the server sends a `stream_status` message. */
     streamState: (state: StreamState) => void;
+    /** Fires when another tab updates suggestion feedback, for cross-tab UI sync. */
+    suggestionFeedbackSync: (data: {
+        sequence: number;
+        feedbackType: "good" | "bad" | null;
+        badFeedbackReason: string | null;
+    }) => void;
     error: (err: Error) => void;
     raw: (data: unknown) => void;
 }
@@ -133,5 +139,10 @@ export type WorkerInboundMessage = {
 } | {
     type: "ERROR";
     message: string;
+} | {
+    type: "FEEDBACK_SYNC";
+    sequence: number;
+    feedbackType: "good" | "bad" | null;
+    badFeedbackReason: string | null;
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exotel-npm-dev/exotel-ai-assist",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "AI-powered real-time suggestions, transcript, and sentiment for agent calls",
   "license": "Apache-2.0",
   "main": "dist/index.js",

package/src/controller/index.ts

@@ -116,6 +116,7 @@ export class ExotelAIAssistController extends EventEmitter<ControllerEvents> {
 
     try {
       this.transport.send(JSON.stringify(message));
+      this.transport.broadcastFeedbackSync(sequence, feedbackType, badFeedbackReason);
       return true;
     } catch (error) {
       console.error("[ExotelAIAssist] Failed to send feedback:", error);
@@ -164,6 +165,14 @@ export class ExotelAIAssistController extends EventEmitter<ControllerEvents> {
       case "MESSAGE":
         if (msg.payload) this._handleServerPayload(msg.payload);
         break;
+
+      case "FEEDBACK_SYNC":
+        this.emit("suggestionFeedbackSync", {
+          sequence: msg.sequence,
+          feedbackType: msg.feedbackType,
+          badFeedbackReason: msg.badFeedbackReason,
+        });
+        break;
     }
   }
 

package/src/hooks/useExotelAIAssist.ts

@@ -73,7 +73,12 @@ export function useExotelAIAssist(params: ExotelAIAssistParams): UseExotelAIAssi
     });
     ctrl.on("streamState", setStreamState);
     ctrl.on("botConfig", setBotConfig);
-    ctrl.on("suggestion", (s) => setSuggestions((prev) => [...prev, s].slice(-MAX_SUGGESTIONS)));
+    ctrl.on("suggestion", (s) =>
+      setSuggestions((prev) => {
+        if (prev.some((existing) => existing.sequence === s.sequence)) return prev;
+        return [...prev, s].slice(-MAX_SUGGESTIONS);
+      }),
+    );
     ctrl.on("sentiment", setSentiment);
     ctrl.on("transcript", (lines) =>
       setTranscripts((prev) => {
@@ -82,6 +87,9 @@ export function useExotelAIAssist(params: ExotelAIAssistParams): UseExotelAIAssi
         return Array.from(map.values()).sort((a, b) => a.startTime - b.startTime);
       }),
     );
+    ctrl.on("suggestionFeedbackSync", ({ sequence, feedbackType, badFeedbackReason }) => {
+      setSuggestions((prev) => prev.map((s) => (s.sequence === sequence ? { ...s, feedbackType, badFeedbackReason } : s)));
+    });
     ctrl.on("error", setLastError);
 
     ctrl.connect();

package/src/transport/index.ts

@@ -4,7 +4,7 @@ type TransportMessageHandler = (msg: WorkerInboundMessage) => void;
 
 // Internal-only message used for the leader-sync handshake.
 // Never forwarded to the controller.
-type InternalMessage = WorkerInboundMessage | { type: "JOIN" };
+type InternalMessage = WorkerInboundMessage | { type: "JOIN" } | { type: "SEND"; payload: string };
 
 export interface ITransport {
   connect(url: string, authToken: string): void;
@@ -14,6 +14,8 @@ export interface ITransport {
   /** Store the raw ack payload so follower tabs joining later receive it as a
    *  MESSAGE replay instead of a bare ACKNOWLEDGED signal. */
   markAcknowledged(rawAckPayload: string): void;
+  /** Broadcast a feedback state change to other tabs for UI sync. */
+  broadcastFeedbackSync(sequence: number, feedbackType: "good" | "bad" | null, badFeedbackReason: string | null): void;
   destroy(): void;
 }
 
@@ -48,11 +50,18 @@ export class BroadcastChannelTransport implements ITransport {
           this.channel.postMessage({ type: "CONNECTED" } satisfies WorkerInboundMessage);
           this.channel.postMessage({ type: "MESSAGE", payload: this.ackPayload } satisfies WorkerInboundMessage);
         }
+        if (data.type === "SEND" && this.socket?.readyState === WebSocket.OPEN) {
+          this.socket.send((data as { type: "SEND"; payload: string }).payload);
+        }
+        if (data.type === "FEEDBACK_SYNC") {
+          this.handler?.(data as WorkerInboundMessage);
+        }
         return;
       }
 
-      // Follower: forward every message except JOIN to the controller handler.
-      if (data.type !== "JOIN") {
+      // Follower: forward server messages to the controller handler.
+      // JOIN and SEND are internal transport messages, not controller messages.
+      if (data.type !== "JOIN" && data.type !== "SEND") {
         this.handler?.(data as WorkerInboundMessage);
       }
     };
@@ -154,8 +163,12 @@ export class BroadcastChannelTransport implements ITransport {
   }
 
   send(payload: string): void {
-    if (this.isLeader && this.socket?.readyState === WebSocket.OPEN) {
-      this.socket.send(payload);
+    if (this.isLeader) {
+      if (this.socket?.readyState === WebSocket.OPEN) {
+        this.socket.send(payload);
+      }
+    } else {
+      this.channel.postMessage({ type: "SEND", payload } satisfies InternalMessage);
     }
   }
 
@@ -167,6 +180,10 @@ export class BroadcastChannelTransport implements ITransport {
     this.ackPayload = rawAckPayload;
   }
 
+  broadcastFeedbackSync(sequence: number, feedbackType: "good" | "bad" | null, badFeedbackReason: string | null): void {
+    this.channel.postMessage({ type: "FEEDBACK_SYNC", sequence, feedbackType, badFeedbackReason } satisfies WorkerInboundMessage);
+  }
+
   destroy(): void {
     if (this.isLeader) {
       this.channel.postMessage({ type: "DISCONNECTED", code: 1000 } satisfies WorkerInboundMessage);

package/src/types/index.ts

@@ -137,6 +137,8 @@ export interface ControllerEvents {
   statusChange: (status: ConnectionStatus) => void;
   /** Fires whenever the server sends a `stream_status` message. */
   streamState: (state: StreamState) => void;
+  /** Fires when another tab updates suggestion feedback, for cross-tab UI sync. */
+  suggestionFeedbackSync: (data: { sequence: number; feedbackType: "good" | "bad" | null; badFeedbackReason: string | null }) => void;
   error: (err: Error) => void;
   raw: (data: unknown) => void;
 }
@@ -146,4 +148,5 @@ export type WorkerInboundMessage =
   | { type: "CONNECTED" }
   | { type: "ACKNOWLEDGED" }
   | { type: "DISCONNECTED"; code?: number }
-  | { type: "ERROR"; message: string };
+  | { type: "ERROR"; message: string }
+  | { type: "FEEDBACK_SYNC"; sequence: number; feedbackType: "good" | "bad" | null; badFeedbackReason: string | null };