dooers-agents-client 0.9.3 → 0.12.0

package/README.md

@@ -5,7 +5,7 @@ React agents client SDK for agents server SDK.
 ## Install
 
 ```bash
-npm install dooers-agents-client
+npm install dooers-agents
 ```
 
 Peer dependency: `react >= 18`
@@ -15,7 +15,7 @@ Peer dependency: `react >= 18`
 Wrap your component tree in `AgentProvider`, then use hooks anywhere inside.
 
 ```tsx
-import { AgentProvider, useConnection, useThreadDetails, useMessage } from "dooers-agents-client"
+import { AgentProvider, useConnection, useThreadDetails, useMessage } from "dooers-agents"
 
 function App() {
   return (
@@ -230,9 +230,9 @@ import type {
   AnalyticsEvent,
   FeedbackType,      // "like" | "dislike"
   FeedbackTarget,    // "event" | "run" | "thread"
-} from "dooers-agents-client"
+} from "dooers-agents"
 
-import { isSettingsFieldGroup } from "dooers-agents-client"  // type guard
+import { isSettingsFieldGroup } from "dooers-agents"  // type guard
 ```
 
 ## Architecture

package/dist/main.cjs

@@ -25,7 +25,7 @@ function apiMessagesUrlToWebSocketUrl(url) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.9.3";
+var PACKAGE_VERSION = "0.10.0";
 
 // src/types.ts
 function isSettingsFieldGroup(item) {
@@ -286,6 +286,7 @@ function toWireContentPart(p) {
 var MAX_RECONNECT_ATTEMPTS = 5;
 var RECONNECT_DELAYS = [1e3, 2e3, 4e3, 8e3, 16e3];
 var SEND_MESSAGE_TIMEOUT = 3e4;
+var PING_INTERVAL_MS = 3e4;
 function blobPartFilename(blob, override) {
   const o = (override ?? "").trim();
   if (o) return o;
@@ -438,6 +439,9 @@ var AgentClient = class {
   isLoadingMore = false;
   // Event pagination cursors per thread
   eventPaginationCursors = /* @__PURE__ */ new Map();
+  /** Active settings subscription — restored after reconnect. */
+  settingsSubscription = null;
+  pingTimer = null;
   constructor(callbacks) {
     this.callbacks = callbacks;
   }
@@ -458,6 +462,16 @@ var AgentClient = class {
   setUploadRunId(runId) {
     this.uploadRunId = (runId ?? "").trim();
   }
+  /**
+   * Merge connection metadata without tearing down the WebSocket.
+   * Use for handshake token refresh and identity/role updates on an open session.
+   */
+  updateConnectionConfig(config) {
+    this.config = { ...this.config, ...config };
+  }
+  isConnected() {
+    return this.ws?.readyState === WebSocket.OPEN;
+  }
   async upload(file, options) {
     if (!this.uploadUrl) {
       throw new Error("uploadUrl not configured");
@@ -541,6 +555,7 @@ var AgentClient = class {
   }
   disconnect() {
     this.isIntentionallyClosed = true;
+    this.stopHeartbeat();
     if (this.reconnectTimer) {
       clearTimeout(this.reconnectTimer);
       this.reconnectTimer = null;
@@ -606,13 +621,17 @@ var AgentClient = class {
   }
   // --- Settings ---
   subscribeSettings(options) {
+    const audience = options?.audience ?? "user";
+    const agentOwnerUserId = options?.agentOwnerUserId ?? null;
+    this.settingsSubscription = { audience, agentOwnerUserId };
     this.send("settings.subscribe", {
       agent_id: this.agentId,
-      audience: options?.audience ?? "user",
-      agent_owner_user_id: options?.agentOwnerUserId ?? null
+      audience,
+      agent_owner_user_id: agentOwnerUserId
     });
   }
   unsubscribeSettings() {
+    this.settingsSubscription = null;
     this.send("settings.unsubscribe", { agent_id: this.agentId });
   }
   patchSetting(fieldId, value) {
@@ -755,6 +774,7 @@ var AgentClient = class {
     });
   }
   createConnection() {
+    this.stopHeartbeat();
     if (this.ws) {
       this.abortPendingMessages("Connection lost; reconnecting");
       this.ws.onopen = null;
@@ -822,6 +842,8 @@ var AgentClient = class {
                 after_event_id: afterEventId
               });
             }
+            this.resubscribeSettings();
+            this.startHeartbeat();
           } else {
             this.callbacks.setConnectionStatus("error", frame.payload.error?.message);
           }
@@ -963,7 +985,28 @@ var AgentClient = class {
         break;
     }
   }
+  resubscribeSettings() {
+    if (!this.settingsSubscription) return;
+    this.send("settings.subscribe", {
+      agent_id: this.agentId,
+      audience: this.settingsSubscription.audience,
+      agent_owner_user_id: this.settingsSubscription.agentOwnerUserId
+    });
+  }
+  startHeartbeat() {
+    this.stopHeartbeat();
+    this.pingTimer = setInterval(() => {
+      this.send("ping", {});
+    }, PING_INTERVAL_MS);
+  }
+  stopHeartbeat() {
+    if (this.pingTimer) {
+      clearInterval(this.pingTimer);
+      this.pingTimer = null;
+    }
+  }
   scheduleReconnect() {
+    this.stopHeartbeat();
     if (this.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
       this.abortPendingMessages("Connection lost after maximum retries");
       this.callbacks.setReconnectFailed();
@@ -1462,9 +1505,17 @@ function AgentProvider({
     clientRef.current?.setUploadAgentId(agentId);
   }, [agentId]);
   const identityIdsKey = identityIds?.join(",") ?? "";
-  react.useEffect(() => {
-    if (!url || !agentId) return;
-    clientRef.current?.connect(url, agentId, {
+  const channelMetaKey = channelMeta ? JSON.stringify(channelMeta) : "";
+  const connectionConfig = react.useMemo(() => {
+    let parsedChannelMeta;
+    if (channelMetaKey) {
+      try {
+        parsedChannelMeta = JSON.parse(channelMetaKey);
+      } catch {
+        parsedChannelMeta = channelMeta;
+      }
+    }
+    return {
       organizationId,
       workspaceId,
       userId,
@@ -1478,12 +1529,9 @@ function AgentProvider({
       workspaceRole,
       authToken,
       channel,
-      channelMeta
-    });
-    return () => clientRef.current?.disconnect();
+      channelMeta: parsedChannelMeta
+    };
   }, [
-    url,
-    agentId,
     organizationId,
     workspaceId,
     userId,
@@ -1497,8 +1545,23 @@ function AgentProvider({
     workspaceRole,
     authToken,
     channel,
+    channelMetaKey,
     channelMeta
   ]);
+  const connectionConfigRef = react.useRef(connectionConfig);
+  connectionConfigRef.current = connectionConfig;
+  react.useEffect(() => {
+    if (!url || !agentId) {
+      clientRef.current?.disconnect();
+      return;
+    }
+    clientRef.current?.connect(url, agentId, connectionConfigRef.current);
+    return () => clientRef.current?.disconnect();
+  }, [url, agentId]);
+  react.useEffect(() => {
+    if (!url || !agentId) return;
+    clientRef.current?.updateConnectionConfig(connectionConfig);
+  }, [url, agentId, connectionConfig]);
   const contextValue = react.useMemo(
     () => ({ store: storeRef.current, client: clientRef.current }),
     []