@superatomai/sdk-node 0.0.73-dsp → 0.0.74-dsp

package/dist/index.d.mts

@@ -6456,6 +6456,7 @@ declare class SuperatomSDK {
     private components;
     private tools;
     private workflows;
+    private registryWaiters;
     private anthropicApiKey;
     private groqApiKey;
     private geminiApiKey;
@@ -6622,6 +6623,19 @@ declare class SuperatomSDK {
      * the workflow component is returned directly, with the LLM-extracted props.
      */
     setWorkflows(workflows: WorkflowDescriptor[]): void;
+    /**
+     * Make sure the agent has a tool surface before answering a prompt.
+     *
+     * Components and workflows are pushed by the browser once per page load and
+     * kept only in memory, so a backend restart leaves both lists empty until
+     * someone reloads a tab. The agent still answers — with no workflows to route
+     * to and no components to render — which looks like a model regression rather
+     * than lost state. Ask the client to re-send instead, and proceed regardless
+     * so a stale or silent client degrades no worse than it does today.
+     */
+    private ensureRegistry;
+    /** Release anyone blocked in ensureRegistry() now that the list has arrived. */
+    private resolveRegistryWaiters;
     /**
      * Get the registered workflow components.
      */

package/dist/index.d.ts

@@ -6456,6 +6456,7 @@ declare class SuperatomSDK {
     private components;
     private tools;
     private workflows;
+    private registryWaiters;
     private anthropicApiKey;
     private groqApiKey;
     private geminiApiKey;
@@ -6622,6 +6623,19 @@ declare class SuperatomSDK {
      * the workflow component is returned directly, with the LLM-extracted props.
      */
     setWorkflows(workflows: WorkflowDescriptor[]): void;
+    /**
+     * Make sure the agent has a tool surface before answering a prompt.
+     *
+     * Components and workflows are pushed by the browser once per page load and
+     * kept only in memory, so a backend restart leaves both lists empty until
+     * someone reloads a tab. The agent still answers — with no workflows to route
+     * to and no components to render — which looks like a model regression rather
+     * than lost state. Ask the client to re-send instead, and proceed regardless
+     * so a stale or silent client degrades no worse than it does today.
+     */
+    private ensureRegistry;
+    /** Release anyone blocked in ensureRegistry() now that the list has arrived. */
+    private resolveRegistryWaiters;
     /**
      * Get the registered workflow components.
      */

package/dist/index.js

@@ -121,7 +121,7 @@ module.exports = __toCommonJS(index_exports);
 // src/websocket.ts
 var import_ws = __toESM(require("ws"));
 function createWebSocket(url) {
-  return new import_ws.default(url);
+  return new import_ws.default(url, { handshakeTimeout: 15e3 });
 }
 
 // src/types.ts
@@ -5021,6 +5021,7 @@ var LLM = class {
             try {
               currentToolUse.input = currentToolUse.inputJson ? JSON.parse(currentToolUse.inputJson) : {};
             } catch (error) {
+              logger.error(`[LLM] Tool "${currentToolUse.name}" input was not valid JSON, falling back to {}: ${String(currentToolUse.inputJson).substring(0, 500)}`);
               currentToolUse.input = {};
             }
             delete currentToolUse.inputJson;
@@ -5100,10 +5101,12 @@ var LLM = class {
               content: stripLoneSurrogates(resultContent)
             };
           } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`[LLM] Tool "${toolUse.name}" threw: ${message} | input: ${JSON.stringify(toolUse.input).substring(0, 300)}`);
             return {
               type: "tool_result",
               tool_use_id: toolUse.id,
-              content: error instanceof Error ? error.message : String(error),
+              content: message,
               is_error: true
             };
           }
@@ -5111,6 +5114,9 @@ var LLM = class {
         toolResultEntries.forEach((entry) => toolResults.content.push(entry));
         conversationMessages.push(toolResults);
       } else {
+        if (stopReason === "tool_use") {
+          logger.error(`[LLM] stop_reason=tool_use but no tool_use block survived parsing (${contentBlocks.length} content block(s))`);
+        }
         break;
       }
     }
@@ -29277,6 +29283,8 @@ var SuperatomSDK = class {
     this.components = [];
     this.tools = [];
     this.workflows = [];
+    // Resolvers waiting on a registry re-send, keyed by the RES type expected.
+    this.registryWaiters = /* @__PURE__ */ new Map();
     // Heartbeat properties for keeping WebSocket connection alive.
     // 25s ping + 10s grace stays under common NAT/LB idle thresholds (~60-100s)
     // so we detect dead sockets within seconds instead of minutes.
@@ -29486,21 +29494,23 @@ var SuperatomSDK = class {
           });
           break;
         case "USER_PROMPT_REQ":
-          handleUserPromptRequest(
-            parsed,
-            this.components,
-            (msg) => this.send(msg),
-            this.anthropicApiKey,
-            this.groqApiKey,
-            this.geminiApiKey,
-            this.openaiApiKey,
-            this.llmProviders,
-            this.collections,
-            this.tools,
-            this.mainAgentModel,
-            this.sourceAgentModel,
-            this.workflows,
-            this.answerFlow === "custom" ? this.answerProvider : void 0
+          this.ensureRegistry().then(
+            () => handleUserPromptRequest(
+              parsed,
+              this.components,
+              (msg) => this.send(msg),
+              this.anthropicApiKey,
+              this.groqApiKey,
+              this.geminiApiKey,
+              this.openaiApiKey,
+              this.llmProviders,
+              this.collections,
+              this.tools,
+              this.mainAgentModel,
+              this.sourceAgentModel,
+              this.workflows,
+              this.answerFlow === "custom" ? this.answerProvider : void 0
+            )
           ).catch((error) => {
             logger.error("Failed to handle user prompt request:", error);
           });
@@ -29518,8 +29528,12 @@ var SuperatomSDK = class {
           });
           break;
         case "COMPONENT_LIST_RES":
-          handleComponentListResponse(parsed, (com) => this.storeComponents(com), this.collections).catch((error) => {
+          handleComponentListResponse(parsed, (com) => {
+            this.storeComponents(com);
+            this.resolveRegistryWaiters("COMPONENT_LIST_RES");
+          }, this.collections).catch((error) => {
             logger.error("Failed to handle component list request:", error);
+            this.resolveRegistryWaiters("COMPONENT_LIST_RES");
           });
           break;
         /* The dashboard contract, pushed by the bundle that holds it — on
@@ -29530,8 +29544,12 @@ var SuperatomSDK = class {
           });
           break;
         case "WORKFLOW_LIST_RES":
-          handleWorkflowListResponse(parsed, (wf) => this.setWorkflows(wf)).catch((error) => {
+          handleWorkflowListResponse(parsed, (wf) => {
+            this.setWorkflows(wf);
+            this.resolveRegistryWaiters("WORKFLOW_LIST_RES");
+          }).catch((error) => {
             logger.error("Failed to handle workflow list request:", error);
+            this.resolveRegistryWaiters("WORKFLOW_LIST_RES");
           });
           break;
         case "USERS":
@@ -29876,6 +29894,50 @@ var SuperatomSDK = class {
     this.workflows = workflows;
     logger.info(`Workflows stored in SDK: ${workflows.length} workflow(s)`);
   }
+  /**
+   * Make sure the agent has a tool surface before answering a prompt.
+   *
+   * Components and workflows are pushed by the browser once per page load and
+   * kept only in memory, so a backend restart leaves both lists empty until
+   * someone reloads a tab. The agent still answers — with no workflows to route
+   * to and no components to render — which looks like a model regression rather
+   * than lost state. Ask the client to re-send instead, and proceed regardless
+   * so a stale or silent client degrades no worse than it does today.
+   */
+  async ensureRegistry(timeoutMs = 4e3) {
+    const missing = [];
+    if (this.workflows.length === 0) missing.push(["WORKFLOW_LIST_REQ", "WORKFLOW_LIST_RES"]);
+    if (this.components.length === 0) missing.push(["COMPONENT_LIST_REQ", "COMPONENT_LIST_RES"]);
+    if (missing.length === 0) return;
+    logger.warn(`Registry empty, requesting from client: ${missing.map(([req]) => req).join(", ")}`);
+    await Promise.all(missing.map(([reqType, resType]) => new Promise((resolve4) => {
+      let settled = false;
+      const finish = () => {
+        if (!settled) {
+          settled = true;
+          resolve4();
+        }
+      };
+      const waiters = this.registryWaiters.get(resType) ?? [];
+      waiters.push(finish);
+      this.registryWaiters.set(resType, waiters);
+      const sent = this.send({
+        type: reqType,
+        from: { type: this.type },
+        to: { type: "runtime" },
+        payload: {}
+      });
+      if (!sent) finish();
+      else setTimeout(finish, timeoutMs);
+    })));
+  }
+  /** Release anyone blocked in ensureRegistry() now that the list has arrived. */
+  resolveRegistryWaiters(resType) {
+    const waiters = this.registryWaiters.get(resType);
+    if (!waiters || waiters.length === 0) return;
+    this.registryWaiters.delete(resType);
+    waiters.forEach((resolve4) => resolve4());
+  }
   /**
    * Get the registered workflow components.
    */

package/dist/index.mjs

@@ -8,7 +8,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/websocket.ts
 import WebSocket from "ws";
 function createWebSocket(url) {
-  return new WebSocket(url);
+  return new WebSocket(url, { handshakeTimeout: 15e3 });
 }
 
 // src/types.ts
@@ -4908,6 +4908,7 @@ var LLM = class {
             try {
               currentToolUse.input = currentToolUse.inputJson ? JSON.parse(currentToolUse.inputJson) : {};
             } catch (error) {
+              logger.error(`[LLM] Tool "${currentToolUse.name}" input was not valid JSON, falling back to {}: ${String(currentToolUse.inputJson).substring(0, 500)}`);
               currentToolUse.input = {};
             }
             delete currentToolUse.inputJson;
@@ -4987,10 +4988,12 @@ var LLM = class {
               content: stripLoneSurrogates(resultContent)
             };
           } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`[LLM] Tool "${toolUse.name}" threw: ${message} | input: ${JSON.stringify(toolUse.input).substring(0, 300)}`);
             return {
               type: "tool_result",
               tool_use_id: toolUse.id,
-              content: error instanceof Error ? error.message : String(error),
+              content: message,
               is_error: true
             };
           }
@@ -4998,6 +5001,9 @@ var LLM = class {
         toolResultEntries.forEach((entry) => toolResults.content.push(entry));
         conversationMessages.push(toolResults);
       } else {
+        if (stopReason === "tool_use") {
+          logger.error(`[LLM] stop_reason=tool_use but no tool_use block survived parsing (${contentBlocks.length} content block(s))`);
+        }
         break;
       }
     }
@@ -29164,6 +29170,8 @@ var SuperatomSDK = class {
     this.components = [];
     this.tools = [];
     this.workflows = [];
+    // Resolvers waiting on a registry re-send, keyed by the RES type expected.
+    this.registryWaiters = /* @__PURE__ */ new Map();
     // Heartbeat properties for keeping WebSocket connection alive.
     // 25s ping + 10s grace stays under common NAT/LB idle thresholds (~60-100s)
     // so we detect dead sockets within seconds instead of minutes.
@@ -29373,21 +29381,23 @@ var SuperatomSDK = class {
           });
           break;
         case "USER_PROMPT_REQ":
-          handleUserPromptRequest(
-            parsed,
-            this.components,
-            (msg) => this.send(msg),
-            this.anthropicApiKey,
-            this.groqApiKey,
-            this.geminiApiKey,
-            this.openaiApiKey,
-            this.llmProviders,
-            this.collections,
-            this.tools,
-            this.mainAgentModel,
-            this.sourceAgentModel,
-            this.workflows,
-            this.answerFlow === "custom" ? this.answerProvider : void 0
+          this.ensureRegistry().then(
+            () => handleUserPromptRequest(
+              parsed,
+              this.components,
+              (msg) => this.send(msg),
+              this.anthropicApiKey,
+              this.groqApiKey,
+              this.geminiApiKey,
+              this.openaiApiKey,
+              this.llmProviders,
+              this.collections,
+              this.tools,
+              this.mainAgentModel,
+              this.sourceAgentModel,
+              this.workflows,
+              this.answerFlow === "custom" ? this.answerProvider : void 0
+            )
           ).catch((error) => {
             logger.error("Failed to handle user prompt request:", error);
           });
@@ -29405,8 +29415,12 @@ var SuperatomSDK = class {
           });
           break;
         case "COMPONENT_LIST_RES":
-          handleComponentListResponse(parsed, (com) => this.storeComponents(com), this.collections).catch((error) => {
+          handleComponentListResponse(parsed, (com) => {
+            this.storeComponents(com);
+            this.resolveRegistryWaiters("COMPONENT_LIST_RES");
+          }, this.collections).catch((error) => {
             logger.error("Failed to handle component list request:", error);
+            this.resolveRegistryWaiters("COMPONENT_LIST_RES");
           });
           break;
         /* The dashboard contract, pushed by the bundle that holds it — on
@@ -29417,8 +29431,12 @@ var SuperatomSDK = class {
           });
           break;
         case "WORKFLOW_LIST_RES":
-          handleWorkflowListResponse(parsed, (wf) => this.setWorkflows(wf)).catch((error) => {
+          handleWorkflowListResponse(parsed, (wf) => {
+            this.setWorkflows(wf);
+            this.resolveRegistryWaiters("WORKFLOW_LIST_RES");
+          }).catch((error) => {
             logger.error("Failed to handle workflow list request:", error);
+            this.resolveRegistryWaiters("WORKFLOW_LIST_RES");
           });
           break;
         case "USERS":
@@ -29763,6 +29781,50 @@ var SuperatomSDK = class {
     this.workflows = workflows;
     logger.info(`Workflows stored in SDK: ${workflows.length} workflow(s)`);
   }
+  /**
+   * Make sure the agent has a tool surface before answering a prompt.
+   *
+   * Components and workflows are pushed by the browser once per page load and
+   * kept only in memory, so a backend restart leaves both lists empty until
+   * someone reloads a tab. The agent still answers — with no workflows to route
+   * to and no components to render — which looks like a model regression rather
+   * than lost state. Ask the client to re-send instead, and proceed regardless
+   * so a stale or silent client degrades no worse than it does today.
+   */
+  async ensureRegistry(timeoutMs = 4e3) {
+    const missing = [];
+    if (this.workflows.length === 0) missing.push(["WORKFLOW_LIST_REQ", "WORKFLOW_LIST_RES"]);
+    if (this.components.length === 0) missing.push(["COMPONENT_LIST_REQ", "COMPONENT_LIST_RES"]);
+    if (missing.length === 0) return;
+    logger.warn(`Registry empty, requesting from client: ${missing.map(([req]) => req).join(", ")}`);
+    await Promise.all(missing.map(([reqType, resType]) => new Promise((resolve4) => {
+      let settled = false;
+      const finish = () => {
+        if (!settled) {
+          settled = true;
+          resolve4();
+        }
+      };
+      const waiters = this.registryWaiters.get(resType) ?? [];
+      waiters.push(finish);
+      this.registryWaiters.set(resType, waiters);
+      const sent = this.send({
+        type: reqType,
+        from: { type: this.type },
+        to: { type: "runtime" },
+        payload: {}
+      });
+      if (!sent) finish();
+      else setTimeout(finish, timeoutMs);
+    })));
+  }
+  /** Release anyone blocked in ensureRegistry() now that the list has arrived. */
+  resolveRegistryWaiters(resType) {
+    const waiters = this.registryWaiters.get(resType);
+    if (!waiters || waiters.length === 0) return;
+    this.registryWaiters.delete(resType);
+    waiters.forEach((resolve4) => resolve4());
+  }
   /**
    * Get the registered workflow components.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superatomai/sdk-node",
-  "version": "0.0.73-dsp",
+  "version": "0.0.74-dsp",
   "description": "Node.js TypeScript SDK for Superatom",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",