@pluno/product-agent-web 0.1.239 → 0.1.241

package/dist/adapters/web/socketIOTransport.d.ts

@@ -28,7 +28,7 @@ type Options = {
     backendUrl: string;
     auth: ProductAgentSocketAuth;
     onReady: (ready: Ready) => void;
-    onDisconnect: (intentional: boolean) => void;
+    onDisconnect: (intentional: boolean, reason: string) => void;
     onEvent: (name: string, event: unknown) => void;
     onToolCall: (event: unknown) => boolean | Promise<boolean>;
     onError: (error: ProductAgentSocketError) => void;
@@ -78,7 +78,7 @@ export declare class ProductAgentSocketIOTransport {
     get connectionAttempt(): ProductAgentConnectionAttempt | null;
     markReady(): void;
     private restoreBackoff;
-    recover(): void;
+    recover(reason?: string): void;
     private beginAttempt;
     private clearReadinessTimers;
     retain(sessionId: string, owner: string): Promise<void>;

package/dist/product-agent-sdk.js

@@ -1248,7 +1248,7 @@ function Zn(s) {
       }
     }).catch((a) => {
       const c = Ve(a);
-      if (["connection_interrupted", "request_timed_out", "request_cancelled", "408", "425", "429", "500", "502", "503", "504"].includes(c.code))
+      if (["display_projection_disabled", "409", "connection_interrupted", "request_timed_out", "request_cancelled", "408", "425", "429", "500", "502", "503", "504"].includes(c.code))
         throw Object.assign(c, { code: "history_load_failed", message: "We couldn’t refresh this conversation. Try again.", retryable: !0 });
       if (Oi(c.code)) throw Object.assign(c, { retryable: !0 });
       return i(a, { operation: "conversation.snapshot", requestId: o.requestId, sessionId: o.sessionId });
@@ -1632,7 +1632,7 @@ function ar(s) {
     return e() && i.directory.memberships[t]?.members.length ? i.conversation.sessions[t] ?? null : null;
   }, s.invalidateAuth), async (t) => (!e() || t.authorityId !== s.authority.authorityId || t.generation !== s.authority.generation || !s.runtime().engine.getState().slices.directory.memberships[t.sessionId]?.members.length || (s.manager.receiveConversationSources(t.sources), s.notify()), null);
 }
-const cr = "0.1.239", dr = {
+const cr = "0.1.241", dr = {
   version: cr
 };
 function et(s) {
@@ -4104,8 +4104,11 @@ class uo {
       forceNew: !0,
       auth: { ...e.auth },
       reconnection: e.reconnect ?? !0
-    }), this.socket.io.on("reconnect_attempt", () => this.beginAttempt()), this.socket.io.on("close", () => {
-      this.invalidate(!1), this.restoreBackoff();
+    }), this.socket.io.on("reconnect_attempt", () => this.beginAttempt()), this.socket.io.on("close", (t) => {
+      const i = this.generation, n = this.attempt;
+      t === "forced close" ? queueMicrotask(() => {
+        i === this.generation && n === this.attempt && this.invalidate(!1, t);
+      }) : this.invalidate(!1, t), this.restoreBackoff();
     }), this.socket.io.on("reconnect", () => this.restoreBackoff()), this.socket.on("connection.ready", (t) => {
       if (t.protocol !== 1 || t.role !== this.options.auth.role || t.display_projection_ready !== !1) {
         this.options.onError(new w("Unsupported Product Agent transport negotiation", "protocol_error")), this.disconnect();
@@ -4115,7 +4118,8 @@ class uo {
     }), this.socket.on("connect", () => {
       this.active = !0, this.activate();
     }), this.socket.on("disconnect", (t) => this.invalidate(
-      t === "io client disconnect" && !this.replacingCredentials
+      t === "io client disconnect" && !this.replacingCredentials,
+      t
     )), this.socket.on("connect_error", (t) => {
       const i = t.data?.code;
       if (i === "unauthorized" && t.data?.reason === "token_expired" && t.data.retryable === !0) {
@@ -4123,7 +4127,7 @@ class uo {
         return;
       }
       if (!i || t.data?.retryable === !0) {
-        if (this.invalidate(!1), this.options.reconnect === !1)
+        if (this.invalidate(!1, "connect_error"), this.options.reconnect === !1)
           this.socket.disconnect();
         else {
           const n = this.socket.io;
@@ -4206,10 +4210,10 @@ class uo {
     }
   }
   replaceCredentials(e, t) {
-    this.replacingCredentials = !0, this.invalidate(!1), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1), t && this.bindings.clear(), this.options.auth = { ...e }, this.socket.auth = { ...e }, this.connect();
+    this.replacingCredentials = !0, this.invalidate(!1, "credential_replacement"), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1, "credential_replacement"), t && this.bindings.clear(), this.options.auth = { ...e }, this.socket.auth = { ...e }, this.connect();
   }
   suspend() {
-    this.replacingCredentials = !0, this.invalidate(!1), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1);
+    this.replacingCredentials = !0, this.invalidate(!1, "local_suspend"), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1, "local_suspend");
   }
   disconnect() {
     this.invalidate(!0), this.socket.disconnect();
@@ -4227,8 +4231,8 @@ class uo {
     const e = this.socket.io;
     e.backoff.attempts = Math.min(20, Math.max(0, this.attemptCount - 1));
   }
-  recover() {
-    !this.active || this.retired || (this.invalidate(!1), this.socket.io.engine.close());
+  recover(e = "local_recovery") {
+    !this.active || this.retired || (this.invalidate(!1, e), this.socket.io.engine.close());
   }
   beginAttempt() {
     this.clearReadinessTimers(), this.active = !0, this.attempt = { connectionAttemptId: crypto.randomUUID(), reconnectAttempt: this.attemptCount++, startedAt: Date.now() }, this.socket.auth = { ...this.options.auth, connection_attempt_id: this.attempt.connectionAttemptId }, this.options.onAttempt?.(this.attempt);
@@ -4237,7 +4241,7 @@ class uo {
         retryable: !0,
         ...this.attempt,
         readinessPhase: this.ready ? "bootstrap" : this.admitted ? "activation" : "namespace_ready"
-      })), e === this.generation && this.recover());
+      })), e === this.generation && this.recover(i));
     };
     this.admissionTimer = setTimeout(() => t("connect_timeout"), 15e3), this.readinessTimer = setTimeout(() => t("auth_timeout"), co);
   }
@@ -4285,7 +4289,7 @@ class uo {
   }
   activationFailed(e) {
     const t = this.generation;
-    this.options.onError(e), t === this.generation && ((e.outcomeUnknown || e.detail?.retryable === !0) && this.options.reconnect !== !1 ? this.socket.io.engine.close() : this.disconnect());
+    this.options.onError(e), t === this.generation && ((e.outcomeUnknown || e.detail?.retryable === !0) && this.options.reconnect !== !1 ? this.recover("local_activation_failure") : this.disconnect());
   }
   synchronize(e = !1) {
     const t = this.generation;
@@ -4377,13 +4381,13 @@ class uo {
     });
   }
   recoverUncertainDelivery(e, t) {
-    e instanceof w && (e.outcomeUnknown || e.code === "backpressure" && !e.backendRefusal) && t === this.generation && this.active && this.socket.io.engine.close();
+    e instanceof w && (e.outcomeUnknown || e.code === "backpressure" && !e.backendRefusal) && t === this.generation && this.active && this.recover(e.code === "backpressure" ? "local_backpressure" : "local_delivery_uncertain");
   }
-  invalidate(e = !1) {
+  invalidate(e = !1, t = "local_invalidation") {
     if (this.clearReadinessTimers(), !!this.active) {
       this.active = !1, this.generation++, this.ready = null, this.admitted = null, this.activating = !1;
-      for (const t of [...this.pending]) t(new w("Connection lost before acknowledgement", "delivery_unknown", !0));
-      this.options.onDisconnect(e);
+      for (const i of [...this.pending]) i(new w("Connection lost before acknowledgement", "delivery_unknown", !0));
+      this.options.onDisconnect(e, t);
     }
   }
 }
@@ -4926,12 +4930,12 @@ class D extends EventTarget {
       onReady: () => {
         this.readyState !== 3 && (this.readyState = 1, this.dispatchEvent(new Event("open")));
       },
-      onDisconnect: (t) => {
+      onDisconnect: (t, i) => {
         if (t) {
           this.finishClose(!0);
           return;
         }
-        this.readyState !== 3 && (this.resetBootstrap(), this.readyState = 0, this.initialized = !1, this.bootstrapped = !1, this.beforeBootstrap.length = 0, this.rejectToolReceipts(), this.dispatchEvent(new Event("reconnecting")));
+        this.readyState !== 3 && (this.resetBootstrap(), this.readyState = 0, this.initialized = !1, this.bootstrapped = !1, this.beforeBootstrap.length = 0, this.rejectToolReceipts(), this.dispatchEvent(new CustomEvent("reconnecting", { detail: { reason: i } })));
       },
       onEvent: (t, i) => {
         const n = i, r = n.sessionId ?? n.session?.id ?? n.item?.sessionId, o = this.hydration;
@@ -7987,8 +7991,8 @@ class bt {
         });
         this.socket = r, this.options.webSocketFactory && (this.socketConnectTimer = window.setTimeout(() => {
           this.socket === r && r.readyState === WebSocket.CONNECTING && (N("web-sdk.agent", "Pluno socket opening timed out; reconnecting"), this.reportTransportDiagnostic("connect_timeout"), this.replaceTimedOutSocket(r));
-        }, Ua)), r.addEventListener("reconnecting", () => {
-          this.socket === r && this.state.status !== "closed" && (this.refreshingDefaultCredentials || this.reportTransportDiagnostic("socket_closed", { closeCode: 1006, wasClean: !1 }), this.setReconnectingState());
+        }, Ua)), r.addEventListener("reconnecting", (o) => {
+          this.socket === r && this.state.status !== "closed" && (this.refreshingDefaultCredentials || this.reportTransportDiagnostic("socket_closed", { disconnectReason: o.detail.reason }), this.setReconnectingState());
         }), r.addEventListener("open", () => {
           this.socket !== r || (this.clearSocketConnectTimer(), this.directoryObservation.reconnect().catch(() => {
           }), this.conversationObservation?.wake(), N("web-sdk.agent", "Pluno socket opened", {
@@ -8890,7 +8894,7 @@ class bt {
   }
   /** @internal */
   reportTransportDiagnostic(e, t = {}) {
-    const i = typeof navigator > "u" ? "unknown" : navigator.onLine === !1 ? "offline" : "online", n = `${e}:${t.requestId ?? t.connectionAttemptId ?? "none"}:${t.closeCode ?? "none"}:${i}`, r = (/* @__PURE__ */ new Date()).toISOString(), o = this.transportDiagnosticEpisodes.get(n), a = {
+    const i = typeof navigator > "u" ? "unknown" : navigator.onLine === !1 ? "offline" : "online", n = `${e}:${t.requestId ?? t.connectionAttemptId ?? "none"}:${t.closeCode ?? "none"}:${t.disconnectReason ?? "none"}:${i}`, r = (/* @__PURE__ */ new Date()).toISOString(), o = this.transportDiagnosticEpisodes.get(n), a = {
       id: o?.id ?? crypto.randomUUID(),
       phase: e,
       entrySurface: this.options.entrySurface,

package/dist/product-agent-widget.js

@@ -1371,7 +1371,7 @@ function Ip(t) {
       }
     }).catch((r) => {
       const c = ss(r);
-      if (["connection_interrupted", "request_timed_out", "request_cancelled", "408", "425", "429", "500", "502", "503", "504"].includes(c.code))
+      if (["display_projection_disabled", "409", "connection_interrupted", "request_timed_out", "request_cancelled", "408", "425", "429", "500", "502", "503", "504"].includes(c.code))
         throw Object.assign(c, { code: "history_load_failed", message: "We couldn’t refresh this conversation. Try again.", retryable: !0 });
       if (Wl(c.code)) throw Object.assign(c, { retryable: !0 });
       return i(r, { operation: "conversation.snapshot", requestId: a.requestId, sessionId: a.sessionId });
@@ -1820,7 +1820,7 @@ function Op(t) {
     return e() && i.directory.memberships[n]?.members.length ? i.conversation.sessions[n] ?? null : null;
   }, t.invalidateAuth), async (n) => (!e() || n.authorityId !== t.authority.authorityId || n.generation !== t.authority.generation || !t.runtime().engine.getState().slices.directory.memberships[n.sessionId]?.members.length || (t.manager.receiveConversationSources(n.sources), t.notify()), null);
 }
-const Ql = "0.1.239", Np = {
+const Ql = "0.1.241", Np = {
   version: Ql
 }, Tt = /* @__PURE__ */ Object.create(null);
 Tt.open = "0";
@@ -4158,8 +4158,11 @@ class qh {
       forceNew: !0,
       auth: { ...e.auth },
       reconnection: e.reconnect ?? !0
-    }), this.socket.io.on("reconnect_attempt", () => this.beginAttempt()), this.socket.io.on("close", () => {
-      this.invalidate(!1), this.restoreBackoff();
+    }), this.socket.io.on("reconnect_attempt", () => this.beginAttempt()), this.socket.io.on("close", (n) => {
+      const i = this.generation, s = this.attempt;
+      n === "forced close" ? queueMicrotask(() => {
+        i === this.generation && s === this.attempt && this.invalidate(!1, n);
+      }) : this.invalidate(!1, n), this.restoreBackoff();
     }), this.socket.io.on("reconnect", () => this.restoreBackoff()), this.socket.on("connection.ready", (n) => {
       if (n.protocol !== 1 || n.role !== this.options.auth.role || n.display_projection_ready !== !1) {
         this.options.onError(new O("Unsupported Product Agent transport negotiation", "protocol_error")), this.disconnect();
@@ -4169,7 +4172,8 @@ class qh {
     }), this.socket.on("connect", () => {
       this.active = !0, this.activate();
     }), this.socket.on("disconnect", (n) => this.invalidate(
-      n === "io client disconnect" && !this.replacingCredentials
+      n === "io client disconnect" && !this.replacingCredentials,
+      n
     )), this.socket.on("connect_error", (n) => {
       const i = n.data?.code;
       if (i === "unauthorized" && n.data?.reason === "token_expired" && n.data.retryable === !0) {
@@ -4177,7 +4181,7 @@ class qh {
         return;
       }
       if (!i || n.data?.retryable === !0) {
-        if (this.invalidate(!1), this.options.reconnect === !1)
+        if (this.invalidate(!1, "connect_error"), this.options.reconnect === !1)
           this.socket.disconnect();
         else {
           const s = this.socket.io;
@@ -4260,10 +4264,10 @@ class qh {
     }
   }
   replaceCredentials(e, n) {
-    this.replacingCredentials = !0, this.invalidate(!1), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1), n && this.bindings.clear(), this.options.auth = { ...e }, this.socket.auth = { ...e }, this.connect();
+    this.replacingCredentials = !0, this.invalidate(!1, "credential_replacement"), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1, "credential_replacement"), n && this.bindings.clear(), this.options.auth = { ...e }, this.socket.auth = { ...e }, this.connect();
   }
   suspend() {
-    this.replacingCredentials = !0, this.invalidate(!1), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1);
+    this.replacingCredentials = !0, this.invalidate(!1, "local_suspend"), this.socket.disconnect(), this.replacingCredentials = !1, this.invalidate(!1, "local_suspend");
   }
   disconnect() {
     this.invalidate(!0), this.socket.disconnect();
@@ -4281,8 +4285,8 @@ class qh {
     const e = this.socket.io;
     e.backoff.attempts = Math.min(20, Math.max(0, this.attemptCount - 1));
   }
-  recover() {
-    !this.active || this.retired || (this.invalidate(!1), this.socket.io.engine.close());
+  recover(e = "local_recovery") {
+    !this.active || this.retired || (this.invalidate(!1, e), this.socket.io.engine.close());
   }
   beginAttempt() {
     this.clearReadinessTimers(), this.active = !0, this.attempt = { connectionAttemptId: crypto.randomUUID(), reconnectAttempt: this.attemptCount++, startedAt: Date.now() }, this.socket.auth = { ...this.options.auth, connection_attempt_id: this.attempt.connectionAttemptId }, this.options.onAttempt?.(this.attempt);
@@ -4291,7 +4295,7 @@ class qh {
         retryable: !0,
         ...this.attempt,
         readinessPhase: this.ready ? "bootstrap" : this.admitted ? "activation" : "namespace_ready"
-      })), e === this.generation && this.recover());
+      })), e === this.generation && this.recover(i));
     };
     this.admissionTimer = setTimeout(() => n("connect_timeout"), 15e3), this.readinessTimer = setTimeout(() => n("auth_timeout"), Ph);
   }
@@ -4339,7 +4343,7 @@ class qh {
   }
   activationFailed(e) {
     const n = this.generation;
-    this.options.onError(e), n === this.generation && ((e.outcomeUnknown || e.detail?.retryable === !0) && this.options.reconnect !== !1 ? this.socket.io.engine.close() : this.disconnect());
+    this.options.onError(e), n === this.generation && ((e.outcomeUnknown || e.detail?.retryable === !0) && this.options.reconnect !== !1 ? this.recover("local_activation_failure") : this.disconnect());
   }
   synchronize(e = !1) {
     const n = this.generation;
@@ -4431,13 +4435,13 @@ class qh {
     });
   }
   recoverUncertainDelivery(e, n) {
-    e instanceof O && (e.outcomeUnknown || e.code === "backpressure" && !e.backendRefusal) && n === this.generation && this.active && this.socket.io.engine.close();
+    e instanceof O && (e.outcomeUnknown || e.code === "backpressure" && !e.backendRefusal) && n === this.generation && this.active && this.recover(e.code === "backpressure" ? "local_backpressure" : "local_delivery_uncertain");
   }
-  invalidate(e = !1) {
+  invalidate(e = !1, n = "local_invalidation") {
     if (this.clearReadinessTimers(), !!this.active) {
       this.active = !1, this.generation++, this.ready = null, this.admitted = null, this.activating = !1;
-      for (const n of [...this.pending]) n(new O("Connection lost before acknowledgement", "delivery_unknown", !0));
-      this.options.onDisconnect(e);
+      for (const i of [...this.pending]) i(new O("Connection lost before acknowledgement", "delivery_unknown", !0));
+      this.options.onDisconnect(e, n);
     }
   }
 }
@@ -4980,12 +4984,12 @@ class Te extends EventTarget {
       onReady: () => {
         this.readyState !== 3 && (this.readyState = 1, this.dispatchEvent(new Event("open")));
       },
-      onDisconnect: (n) => {
+      onDisconnect: (n, i) => {
         if (n) {
           this.finishClose(!0);
           return;
         }
-        this.readyState !== 3 && (this.resetBootstrap(), this.readyState = 0, this.initialized = !1, this.bootstrapped = !1, this.beforeBootstrap.length = 0, this.rejectToolReceipts(), this.dispatchEvent(new Event("reconnecting")));
+        this.readyState !== 3 && (this.resetBootstrap(), this.readyState = 0, this.initialized = !1, this.bootstrapped = !1, this.beforeBootstrap.length = 0, this.rejectToolReceipts(), this.dispatchEvent(new CustomEvent("reconnecting", { detail: { reason: i } })));
       },
       onEvent: (n, i) => {
         const s = i, o = s.sessionId ?? s.session?.id ?? s.item?.sessionId, a = this.hydration;
@@ -7508,8 +7512,8 @@ class Qr {
         });
         this.socket = o, this.options.webSocketFactory && (this.socketConnectTimer = window.setTimeout(() => {
           this.socket === o && o.readyState === WebSocket.CONNECTING && (Me("web-sdk.agent", "Pluno socket opening timed out; reconnecting"), this.reportTransportDiagnostic("connect_timeout"), this.replaceTimedOutSocket(o));
-        }, lf)), o.addEventListener("reconnecting", () => {
-          this.socket === o && this.state.status !== "closed" && (this.refreshingDefaultCredentials || this.reportTransportDiagnostic("socket_closed", { closeCode: 1006, wasClean: !1 }), this.setReconnectingState());
+        }, lf)), o.addEventListener("reconnecting", (a) => {
+          this.socket === o && this.state.status !== "closed" && (this.refreshingDefaultCredentials || this.reportTransportDiagnostic("socket_closed", { disconnectReason: a.detail.reason }), this.setReconnectingState());
         }), o.addEventListener("open", () => {
           this.socket !== o || (this.clearSocketConnectTimer(), this.directoryObservation.reconnect().catch(() => {
           }), this.conversationObservation?.wake(), Me("web-sdk.agent", "Pluno socket opened", {
@@ -8411,7 +8415,7 @@ class Qr {
   }
   /** @internal */
   reportTransportDiagnostic(e, n = {}) {
-    const i = typeof navigator > "u" ? "unknown" : navigator.onLine === !1 ? "offline" : "online", s = `${e}:${n.requestId ?? n.connectionAttemptId ?? "none"}:${n.closeCode ?? "none"}:${i}`, o = (/* @__PURE__ */ new Date()).toISOString(), a = this.transportDiagnosticEpisodes.get(s), r = {
+    const i = typeof navigator > "u" ? "unknown" : navigator.onLine === !1 ? "offline" : "online", s = `${e}:${n.requestId ?? n.connectionAttemptId ?? "none"}:${n.closeCode ?? "none"}:${n.disconnectReason ?? "none"}:${i}`, o = (/* @__PURE__ */ new Date()).toISOString(), a = this.transportDiagnosticEpisodes.get(s), r = {
       id: a?.id ?? crypto.randomUUID(),
       phase: e,
       entrySurface: this.options.entrySurface,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluno/product-agent-web",
-  "version": "0.1.239",
+  "version": "0.1.241",
   "description": "Browser SDK and default widget for embedding Pluno Product Agent into customer web apps.",
   "license": "Apache-2.0",
   "type": "module",