dooers-agents-client 0.4.0 → 0.6.0

package/dist/main.cjs

@@ -6,7 +6,23 @@ var shallow = require('zustand/shallow');
 var vanilla = require('zustand/vanilla');
 var jsxRuntime = require('react/jsx-runtime');
 
-// src/hooks/use-analytics.ts
+// src/helpers/api-messages-url-to-ws.ts
+function apiMessagesUrlToWebSocketUrl(url) {
+  const t = url.trim();
+  if (!t) {
+    throw new Error("API Messages URL is empty");
+  }
+  if (/^wss:\/\//i.test(t) || /^ws:\/\//i.test(t)) {
+    return t;
+  }
+  if (/^https:\/\//i.test(t)) {
+    return `wss://${t.slice("https://".length)}`;
+  }
+  if (/^http:\/\//i.test(t)) {
+    return `ws://${t.slice("http://".length)}`;
+  }
+  throw new Error("API Messages URL must start with http://, https://, ws://, or wss://");
+}
 
 // src/types.ts
 function isSettingsFieldGroup(item) {
@@ -179,6 +195,8 @@ function toSettingsField(w) {
     label: w.label,
     required: w.required,
     readonly: w.readonly,
+    user_editable: w.user_editable ?? true,
+    visibility: w.visibility ?? "user",
     value: w.value,
     placeholder: w.placeholder,
     options: w.options,
@@ -199,7 +217,8 @@ function toSettingsItem(w) {
       id: g.id,
       label: g.label,
       fields: g.fields.map(toSettingsField),
-      collapsible: g.collapsible
+      collapsible: g.collapsible,
+      visibility: g.visibility ?? "user"
     };
   }
   return toSettingsField(w);
@@ -233,6 +252,92 @@ function toWireContentPart(p) {
 var MAX_RECONNECT_ATTEMPTS = 5;
 var RECONNECT_DELAYS = [1e3, 2e3, 4e3, 8e3, 16e3];
 var SEND_MESSAGE_TIMEOUT = 3e4;
+var AgentServerClient = class {
+  wsUrl;
+  constructor(apiMessagesUrl) {
+    this.wsUrl = apiMessagesUrlToWebSocketUrl(apiMessagesUrl);
+  }
+  /**
+   * Opens a short-lived WebSocket, requests `settings.public_schema`, and returns the public field
+   * list. Closes the socket when done.
+   */
+  fetchPublicSettingsSchema(options) {
+    const timeoutMs = options?.timeoutMs ?? 15e3;
+    return new Promise((resolve, reject) => {
+      const ws = new WebSocket(this.wsUrl);
+      const frameId = crypto.randomUUID();
+      let settled = false;
+      const finish = (fn) => {
+        if (settled) return;
+        settled = true;
+        clearTimeout(timer);
+        try {
+          ws.close();
+        } catch {
+        }
+        fn();
+      };
+      const timer = setTimeout(() => {
+        finish(() => reject(new Error("AgentServerClient.fetchPublicSettingsSchema: timeout")));
+      }, timeoutMs);
+      ws.onopen = () => {
+        ws.send(
+          JSON.stringify({
+            id: frameId,
+            type: "settings.public_schema",
+            payload: {}
+          })
+        );
+      };
+      ws.onmessage = (ev) => {
+        let msg;
+        try {
+          msg = JSON.parse(ev.data);
+        } catch {
+          return;
+        }
+        if (msg.type === "ack" && msg.payload?.ack_id === frameId) {
+          if (msg.payload?.ok === false) {
+            finish(
+              () => reject(
+                new Error(
+                  msg.payload?.error?.message ?? "AgentServerClient.fetchPublicSettingsSchema: request rejected"
+                )
+              )
+            );
+          }
+          return;
+        }
+        if (msg.type === "settings.public_schema.result" && msg.id === frameId) {
+          const raw = msg.payload?.schema;
+          const fieldsWire = raw?.fields ?? [];
+          const fields = fieldsWire.map((w) => toSettingsItem(w));
+          finish(
+            () => resolve({
+              version: typeof raw?.version === "string" ? raw.version : "1.0",
+              fields
+            })
+          );
+        }
+      };
+      ws.onerror = () => {
+        finish(
+          () => reject(new Error("AgentServerClient.fetchPublicSettingsSchema: WebSocket error"))
+        );
+      };
+      ws.onclose = (ev) => {
+        if (settled) return;
+        finish(
+          () => reject(
+            new Error(
+              `AgentServerClient.fetchPublicSettingsSchema: connection closed (${ev.code})${ev.reason ? ` ${ev.reason}` : ""}`
+            )
+          )
+        );
+      };
+    });
+  }
+};
 var AgentClient = class {
   ws = null;
   callbacks;
@@ -299,12 +404,12 @@ var AgentClient = class {
     };
   }
   connect(url, agentId, config) {
-    this.url = url;
+    this.url = apiMessagesUrlToWebSocketUrl(url);
     this.agentId = agentId;
     this.config = config ?? { organizationId: "", workspaceId: "", userId: "" };
     this.isIntentionallyClosed = false;
     try {
-      const parsed = new URL(url);
+      const parsed = new URL(this.url);
       parsed.protocol = parsed.protocol === "wss:" ? "https:" : "http:";
       parsed.pathname = "";
       parsed.search = "";
@@ -385,8 +490,12 @@ var AgentClient = class {
     });
   }
   // --- Settings ---
-  subscribeSettings() {
-    this.send("settings.subscribe", { agent_id: this.agentId });
+  subscribeSettings(options) {
+    this.send("settings.subscribe", {
+      agent_id: this.agentId,
+      audience: options?.audience ?? "user",
+      agent_owner_user_id: options?.agentOwnerUserId ?? null
+    });
   }
   unsubscribeSettings() {
     this.send("settings.unsubscribe", { agent_id: this.agentId });
@@ -662,6 +771,8 @@ var AgentClient = class {
           frame.payload.updated_at
         );
         break;
+      case "settings.public_schema.result":
+        break;
       case "feedback.ack":
         if (frame.payload.ok) {
           this.callbacks.onFeedbackAck(
@@ -1398,6 +1509,7 @@ function useFormFileUpload() {
         const formData = new FormData();
         formData.append("file", params.file);
         formData.append("field_id", params.fieldId);
+        formData.append("source", "chat");
         formData.append("agent_id", params.agentId);
         formData.append("run_id", params.runId);
         formData.append("thread_id", params.threadId);
@@ -1438,7 +1550,10 @@ function useSettings() {
   const fields = useShallowStore((s) => s.settings.fields);
   const updatedAt = useStore((s) => s.settings.updatedAt);
   const isLoading = useStore((s) => s.settings.isLoading);
-  const subscribe = react.useCallback(() => client.subscribeSettings(), [client]);
+  const subscribe = react.useCallback(
+    (options) => client.subscribeSettings(options),
+    [client]
+  );
   const unsubscribe = react.useCallback(() => client.unsubscribeSettings(), [client]);
   const patchField = react.useCallback(
     (fieldId, value) => client.patchSetting(fieldId, value),
@@ -1565,6 +1680,8 @@ function useUpload() {
 }
 
 exports.AgentProvider = AgentProvider;
+exports.AgentServerClient = AgentServerClient;
+exports.apiMessagesUrlToWebSocketUrl = apiMessagesUrlToWebSocketUrl;
 exports.isSettingsFieldGroup = isSettingsFieldGroup;
 exports.toFormElement = toFormElement;
 exports.toFormEventData = toFormEventData;