dooers-agents-client 0.9.2 → 0.11.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

@@ -24,6 +24,9 @@ function apiMessagesUrlToWebSocketUrl(url) {
   throw new Error("API Messages URL must start with http://, https://, ws://, or wss://");
 }
 
+// src/version.ts
+var PACKAGE_VERSION = "0.10.0";
+
 // src/types.ts
 function isSettingsFieldGroup(item) {
   return "fields" in item && Array.isArray(item.fields);
@@ -34,6 +37,8 @@ function toUser(w) {
     userId: w.user_id,
     userName: w.user_name,
     userEmail: w.user_email,
+    userMobileNumber: w.user_mobile_number,
+    userWhatsappNumber: w.user_whatsapp_number,
     identityIds: w.identity_ids,
     systemRole: w.system_role,
     organizationRole: w.organization_role,
@@ -65,7 +70,8 @@ function toDisplayContentPart(w) {
         url: w.url,
         mimeType: w.mime_type,
         duration: w.duration,
-        filename: w.filename
+        filename: w.filename,
+        ...w.ref_id ? { refId: w.ref_id } : {}
       };
     case "image":
       return {
@@ -75,7 +81,8 @@ function toDisplayContentPart(w) {
         width: w.width,
         height: w.height,
         alt: w.alt,
-        filename: w.filename
+        filename: w.filename,
+        ...w.ref_id ? { refId: w.ref_id } : {}
       };
     case "document":
       return {
@@ -83,7 +90,8 @@ function toDisplayContentPart(w) {
         url: w.url,
         filename: w.filename,
         mimeType: w.mime_type,
-        sizeBytes: w.size_bytes
+        sizeBytes: w.size_bytes,
+        ...w.ref_id ? { refId: w.ref_id } : {}
       };
   }
 }
@@ -278,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;
@@ -410,7 +419,8 @@ var AgentClient = class {
   config = {
     organizationId: "",
     workspaceId: "",
-    userId: ""
+    userId: "",
+    channel: "dooers-platform"
   };
   connectFrameId = "";
   isIntentionallyClosed = false;
@@ -429,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;
   }
@@ -449,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");
@@ -532,6 +555,7 @@ var AgentClient = class {
   }
   disconnect() {
     this.isIntentionallyClosed = true;
+    this.stopHeartbeat();
     if (this.reconnectTimer) {
       clearTimeout(this.reconnectTimer);
       this.reconnectTimer = null;
@@ -597,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) {
@@ -697,9 +725,7 @@ var AgentClient = class {
         content
       }
     };
-    if (params.metadata) {
-      payload.metadata = params.metadata;
-    }
+    payload.metadata = this.withChannelMetadata(params.metadata);
     this.sendRaw({
       id: clientEventId,
       type: "event.create",
@@ -727,7 +753,8 @@ var AgentClient = class {
             values: params.values
           }
         }
-      }
+      },
+      metadata: this.withChannelMetadata(params.metadata)
     });
     return promise;
   }
@@ -747,6 +774,7 @@ var AgentClient = class {
     });
   }
   createConnection() {
+    this.stopHeartbeat();
     if (this.ws) {
       this.abortPendingMessages("Connection lost; reconnecting");
       this.ws.onopen = null;
@@ -787,13 +815,15 @@ var AgentClient = class {
           user_id: this.config.userId ?? "",
           user_name: this.config.userName ?? null,
           user_email: this.config.userEmail ?? null,
+          user_mobile_number: this.config.userMobileNumber ?? null,
+          user_whatsapp_number: this.config.userWhatsappNumber ?? null,
           identity_ids: this.config.identityIds ?? [],
           system_role: this.config.systemRole ?? "user",
           organization_role: this.config.organizationRole ?? "member",
           workspace_role: this.config.workspaceRole ?? "member"
         },
         auth_token: this.config.authToken,
-        client: { name: "dooers-agents-client", version: "0.1.0" }
+        client: { name: "dooers-agents-client", version: PACKAGE_VERSION }
       }
     });
   }
@@ -812,6 +842,8 @@ var AgentClient = class {
                 after_event_id: afterEventId
               });
             }
+            this.resubscribeSettings();
+            this.startHeartbeat();
           } else {
             this.callbacks.setConnectionStatus("error", frame.payload.error?.message);
           }
@@ -953,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();
@@ -971,6 +1024,17 @@ var AgentClient = class {
   send(type, payload) {
     this.sendRaw({ id: crypto.randomUUID(), type, payload });
   }
+  withChannelMetadata(metadata) {
+    const channel = (this.config.channel || "dooers-platform").trim() || "dooers-platform";
+    const base = metadata ? { ...metadata } : {};
+    if (!("channel" in base)) {
+      base.channel = channel;
+    }
+    if (this.config.channelMeta && !("channel_meta" in base)) {
+      base.channel_meta = this.config.channelMeta;
+    }
+    return Object.keys(base).length > 0 ? base : void 0;
+  }
   sendRaw(frame) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
     this.ws.send(JSON.stringify(frame));
@@ -1412,11 +1476,15 @@ function AgentProvider({
   userId,
   userName,
   userEmail,
+  userMobileNumber,
+  userWhatsappNumber,
   identityIds,
   systemRole,
   organizationRole,
   workspaceRole,
   authToken,
+  channel,
+  channelMeta,
   uploadUrl,
   onError,
   children
@@ -1437,35 +1505,63 @@ 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,
       userName,
       userEmail,
+      userMobileNumber,
+      userWhatsappNumber,
       identityIds: identityIdsKey ? identityIdsKey.split(",") : void 0,
       systemRole,
       organizationRole,
       workspaceRole,
-      authToken
-    });
-    return () => clientRef.current?.disconnect();
+      authToken,
+      channel,
+      channelMeta: parsedChannelMeta
+    };
   }, [
-    url,
-    agentId,
     organizationId,
     workspaceId,
     userId,
     userName,
     userEmail,
+    userMobileNumber,
+    userWhatsappNumber,
     identityIdsKey,
     systemRole,
     organizationRole,
     workspaceRole,
-    authToken
+    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 }),
     []
@@ -1919,6 +2015,7 @@ function useUpload() {
 
 exports.AgentProvider = AgentProvider;
 exports.AgentServerClient = AgentServerClient;
+exports.PACKAGE_VERSION = PACKAGE_VERSION;
 exports.apiMessagesUrlToWebSocketUrl = apiMessagesUrlToWebSocketUrl;
 exports.isSettingsFieldGroup = isSettingsFieldGroup;
 exports.toFormElement = toFormElement;