npm - @buildwithtrace/sdk - Versions diffs - 0.1.2 → 0.1.3 - Mend

@buildwithtrace/sdk 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -323,7 +323,9 @@ declare class Trace {
     /**
      * Execute one tool call. FILE tools run locally (sandboxed to projectDir) and
      * their result is POSTed to /tools/result so the backend continues the stream.
-     * Engine/GUI tools are out of scope and throw TraceToolExecutionError.
+     * Engine/GUI tools are out of scope: the SDK POSTs an is_error result (so the
+     * backend can finalize the turn) and continues — it does NOT throw, which would
+     * abandon the open stream.
      */
     private _handleToolCall;
     /**

package/dist/index.d.ts CHANGED Viewed

@@ -323,7 +323,9 @@ declare class Trace {
     /**
      * Execute one tool call. FILE tools run locally (sandboxed to projectDir) and
      * their result is POSTed to /tools/result so the backend continues the stream.
-     * Engine/GUI tools are out of scope and throw TraceToolExecutionError.
+     * Engine/GUI tools are out of scope: the SDK POSTs an is_error result (so the
+     * backend can finalize the turn) and continues — it does NOT throw, which would
+     * abandon the open stream.
      */
     private _handleToolCall;
     /**

package/dist/index.js CHANGED Viewed

@@ -574,12 +574,6 @@ function openBrowser(url) {
   } catch {
   }
 }
-var SUCCESS_HTML = `<!DOCTYPE html><html><head><meta charset="utf-8"><title>Trace</title></head>
-<body style="font-family:system-ui,-apple-system,sans-serif;text-align:center;padding:64px;color:#2a2119">
-<h1 style="font-weight:600">&#10003; Authentication successful</h1>
-<p>You can close this window and return to your terminal.</p>
-<script>setTimeout(function(){window.close();},500)</script>
-</body></html>`;
 var PENDING_HTML = `<!DOCTYPE html><html><head><meta charset="utf-8"><title>Trace</title></head>
 <body style="font-family:system-ui,-apple-system,sans-serif;text-align:center;padding:64px;color:#2a2119">
 <h1 style="font-weight:600">Waiting for authentication&#8230;</h1>
@@ -637,7 +631,13 @@ function browserLogin(opts = {}) {
         res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }).end(PENDING_HTML);
         return;
       }
-      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }).end(SUCCESS_HTML);
+      const successUrl = `${frontendUrl}/login?success=desktop`;
+      res.writeHead(302, {
+        Location: successUrl,
+        "Content-Type": "text/html; charset=utf-8"
+      }).end(
+        `<!DOCTYPE html><meta http-equiv="refresh" content="0;url=${successUrl}"><body style="font-family:system-ui;text-align:center;padding:60px"><p>Signed in. Returning to Trace&#8230; <a href="${successUrl}">continue</a></p></body>`
+      );
       res.on("finish", shutdown);
       res.on("close", shutdown);
       settle(() => resolve3(result));
@@ -691,7 +691,7 @@ var import_posthog_node = require("posthog-node");
 // src/_build_config.ts
 var BUILD_POSTHOG_KEY = "phc_YbXW9ynLyGf9qHVxOY87InoZNSRikTCQ14GDJOZtSxX";
 var BUILD_POSTHOG_HOST = "https://us.i.posthog.com";
-var BUILD_SDK_VERSION = "0.1.2";
+var BUILD_SDK_VERSION = "0.1.3";
 // src/analytics.ts
 var DEFAULT_HOST = "https://us.i.posthog.com";
@@ -854,6 +854,8 @@ function alias(distinctId, aliasId) {
 // src/index.ts
 var DEFAULT_API_URL2 = "https://api.buildwithtrace.com";
 var API_VERSION = "latest";
+var RETRYABLE_STREAM_STATUS = /* @__PURE__ */ new Set([429, 502, 503, 504]);
+var MAX_STREAM_RETRIES = 3;
 var TraceError = class extends Error {
   constructor(message) {
     super(message);
@@ -1184,21 +1186,35 @@ var Trace = class _Trace {
   async _streamChat(message, opts) {
     const sessionId = `sdk-${Date.now().toString(36)}`;
     const body = this._buildChatBody(message, opts, sessionId);
-    const resp = await fetch(`${this.baseUrl}/api/${API_VERSION}/chat/stream`, {
-      method: "POST",
-      headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json",
-        "Accept": "text/event-stream",
-        "User-Agent": "buildwithtrace-node-sdk/0.1.0"
-      },
-      body: JSON.stringify(body)
-    });
-    if (!resp.ok) {
-      const errText = await resp.text().catch(() => "");
-      throw _Trace._httpError(resp.status, errText, opts.mode);
+    const controller = new AbortController();
+    let idleTimer = setTimeout(
+      () => controller.abort(),
+      this.timeout
+    );
+    let resp;
+    for (let attempt = 0; attempt < MAX_STREAM_RETRIES; attempt++) {
+      resp = await fetch(`${this.baseUrl}/api/${API_VERSION}/chat/stream`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          "Accept": "text/event-stream",
+          "User-Agent": "buildwithtrace-node-sdk/0.1.0"
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (resp.ok || !RETRYABLE_STREAM_STATUS.has(resp.status) || attempt === MAX_STREAM_RETRIES - 1)
+        break;
+      await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
+    }
+    if (!resp || !resp.ok) {
+      clearTimeout(idleTimer);
+      const errText = resp ? await resp.text().catch(() => "") : "";
+      throw _Trace._httpError(resp ? resp.status : 0, errText, opts.mode);
     }
     if (!resp.body) {
+      clearTimeout(idleTimer);
       throw new TraceError("The backend returned an empty response stream.");
     }
     const projectDir = opts.projectDir ? (0, import_path2.resolve)(opts.projectDir) : process.cwd();
@@ -1233,6 +1249,8 @@ var Trace = class _Trace {
       for (; ; ) {
         const { done, value } = await reader.read();
         if (done) break;
+        clearTimeout(idleTimer);
+        idleTimer = setTimeout(() => controller.abort(), this.timeout);
         buffer += decoder.decode(value, { stream: true });
         let nl;
         while ((nl = buffer.indexOf("\n")) >= 0) {
@@ -1248,6 +1266,7 @@ var Trace = class _Trace {
         if (ev) await handleEvent(ev);
       }
     } finally {
+      clearTimeout(idleTimer);
       reader.cancel().catch(() => {
       });
     }
@@ -1266,16 +1285,18 @@ var Trace = class _Trace {
   /**
    * Execute one tool call. FILE tools run locally (sandboxed to projectDir) and
    * their result is POSTed to /tools/result so the backend continues the stream.
-   * Engine/GUI tools are out of scope and throw TraceToolExecutionError.
+   * Engine/GUI tools are out of scope: the SDK POSTs an is_error result (so the
+   * backend can finalize the turn) and continues — it does NOT throw, which would
+   * abandon the open stream.
    */
   async _handleToolCall(event, sessionId, projectDir, defaultFile) {
     const toolName = event.tool_name || "unknown";
     const toolCallId = event.tool_call_id || "";
     const toolArgs = event.tool_args || {};
     if (!isFileTool(toolName)) {
-      throw new TraceToolExecutionError(
-        `The agent requested '${toolName}', which the SDK does not execute. The SDK runs FILE tools only (read_file, write, search_replace, list_dir, grep, delete_trace_file); engine/GUI tools (ERC/DRC, gerber/export, take_snapshot, run_*, autoroute) require the \`buildwithtrace\` CLI or the desktop app.`
-      );
+      const msg = `The agent requested '${toolName}', which the SDK does not execute. The SDK runs FILE tools only (read_file, write, search_replace, list_dir, grep, delete_trace_file); engine/GUI tools (ERC/DRC, gerber/export, take_snapshot, run_*, autoroute) require the \`buildwithtrace\` CLI or the desktop app.`;
+      await this._postToolResult(sessionId, toolCallId, `Error: ${msg}`, true);
+      return;
     }
     const result = executeFileTool(toolName, toolArgs, projectDir, defaultFile);
     await this._postToolResult(sessionId, toolCallId, result.result, !result.success);

package/dist/index.mjs CHANGED Viewed

@@ -537,12 +537,6 @@ function openBrowser(url) {
   } catch {
   }
 }
-var SUCCESS_HTML = `<!DOCTYPE html><html><head><meta charset="utf-8"><title>Trace</title></head>
-<body style="font-family:system-ui,-apple-system,sans-serif;text-align:center;padding:64px;color:#2a2119">
-<h1 style="font-weight:600">&#10003; Authentication successful</h1>
-<p>You can close this window and return to your terminal.</p>
-<script>setTimeout(function(){window.close();},500)</script>
-</body></html>`;
 var PENDING_HTML = `<!DOCTYPE html><html><head><meta charset="utf-8"><title>Trace</title></head>
 <body style="font-family:system-ui,-apple-system,sans-serif;text-align:center;padding:64px;color:#2a2119">
 <h1 style="font-weight:600">Waiting for authentication&#8230;</h1>
@@ -600,7 +594,13 @@ function browserLogin(opts = {}) {
         res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }).end(PENDING_HTML);
         return;
       }
-      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }).end(SUCCESS_HTML);
+      const successUrl = `${frontendUrl}/login?success=desktop`;
+      res.writeHead(302, {
+        Location: successUrl,
+        "Content-Type": "text/html; charset=utf-8"
+      }).end(
+        `<!DOCTYPE html><meta http-equiv="refresh" content="0;url=${successUrl}"><body style="font-family:system-ui;text-align:center;padding:60px"><p>Signed in. Returning to Trace&#8230; <a href="${successUrl}">continue</a></p></body>`
+      );
       res.on("finish", shutdown);
       res.on("close", shutdown);
       settle(() => resolve3(result));
@@ -654,7 +654,7 @@ import { PostHog } from "posthog-node";
 // src/_build_config.ts
 var BUILD_POSTHOG_KEY = "phc_YbXW9ynLyGf9qHVxOY87InoZNSRikTCQ14GDJOZtSxX";
 var BUILD_POSTHOG_HOST = "https://us.i.posthog.com";
-var BUILD_SDK_VERSION = "0.1.2";
+var BUILD_SDK_VERSION = "0.1.3";
 // src/analytics.ts
 var DEFAULT_HOST = "https://us.i.posthog.com";
@@ -817,6 +817,8 @@ function alias(distinctId, aliasId) {
 // src/index.ts
 var DEFAULT_API_URL2 = "https://api.buildwithtrace.com";
 var API_VERSION = "latest";
+var RETRYABLE_STREAM_STATUS = /* @__PURE__ */ new Set([429, 502, 503, 504]);
+var MAX_STREAM_RETRIES = 3;
 var TraceError = class extends Error {
   constructor(message) {
     super(message);
@@ -1147,21 +1149,35 @@ var Trace = class _Trace {
   async _streamChat(message, opts) {
     const sessionId = `sdk-${Date.now().toString(36)}`;
     const body = this._buildChatBody(message, opts, sessionId);
-    const resp = await fetch(`${this.baseUrl}/api/${API_VERSION}/chat/stream`, {
-      method: "POST",
-      headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json",
-        "Accept": "text/event-stream",
-        "User-Agent": "buildwithtrace-node-sdk/0.1.0"
-      },
-      body: JSON.stringify(body)
-    });
-    if (!resp.ok) {
-      const errText = await resp.text().catch(() => "");
-      throw _Trace._httpError(resp.status, errText, opts.mode);
+    const controller = new AbortController();
+    let idleTimer = setTimeout(
+      () => controller.abort(),
+      this.timeout
+    );
+    let resp;
+    for (let attempt = 0; attempt < MAX_STREAM_RETRIES; attempt++) {
+      resp = await fetch(`${this.baseUrl}/api/${API_VERSION}/chat/stream`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          "Accept": "text/event-stream",
+          "User-Agent": "buildwithtrace-node-sdk/0.1.0"
+        },
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      if (resp.ok || !RETRYABLE_STREAM_STATUS.has(resp.status) || attempt === MAX_STREAM_RETRIES - 1)
+        break;
+      await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
+    }
+    if (!resp || !resp.ok) {
+      clearTimeout(idleTimer);
+      const errText = resp ? await resp.text().catch(() => "") : "";
+      throw _Trace._httpError(resp ? resp.status : 0, errText, opts.mode);
     }
     if (!resp.body) {
+      clearTimeout(idleTimer);
       throw new TraceError("The backend returned an empty response stream.");
     }
     const projectDir = opts.projectDir ? resolve2(opts.projectDir) : process.cwd();
@@ -1196,6 +1212,8 @@ var Trace = class _Trace {
       for (; ; ) {
         const { done, value } = await reader.read();
         if (done) break;
+        clearTimeout(idleTimer);
+        idleTimer = setTimeout(() => controller.abort(), this.timeout);
         buffer += decoder.decode(value, { stream: true });
         let nl;
         while ((nl = buffer.indexOf("\n")) >= 0) {
@@ -1211,6 +1229,7 @@ var Trace = class _Trace {
         if (ev) await handleEvent(ev);
       }
     } finally {
+      clearTimeout(idleTimer);
       reader.cancel().catch(() => {
       });
     }
@@ -1229,16 +1248,18 @@ var Trace = class _Trace {
   /**
    * Execute one tool call. FILE tools run locally (sandboxed to projectDir) and
    * their result is POSTed to /tools/result so the backend continues the stream.
-   * Engine/GUI tools are out of scope and throw TraceToolExecutionError.
+   * Engine/GUI tools are out of scope: the SDK POSTs an is_error result (so the
+   * backend can finalize the turn) and continues — it does NOT throw, which would
+   * abandon the open stream.
    */
   async _handleToolCall(event, sessionId, projectDir, defaultFile) {
     const toolName = event.tool_name || "unknown";
     const toolCallId = event.tool_call_id || "";
     const toolArgs = event.tool_args || {};
     if (!isFileTool(toolName)) {
-      throw new TraceToolExecutionError(
-        `The agent requested '${toolName}', which the SDK does not execute. The SDK runs FILE tools only (read_file, write, search_replace, list_dir, grep, delete_trace_file); engine/GUI tools (ERC/DRC, gerber/export, take_snapshot, run_*, autoroute) require the \`buildwithtrace\` CLI or the desktop app.`
-      );
+      const msg = `The agent requested '${toolName}', which the SDK does not execute. The SDK runs FILE tools only (read_file, write, search_replace, list_dir, grep, delete_trace_file); engine/GUI tools (ERC/DRC, gerber/export, take_snapshot, run_*, autoroute) require the \`buildwithtrace\` CLI or the desktop app.`;
+      await this._postToolResult(sessionId, toolCallId, `Error: ${msg}`, true);
+      return;
     }
     const result = executeFileTool(toolName, toolArgs, projectDir, defaultFile);
     await this._postToolResult(sessionId, toolCallId, result.result, !result.success);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@buildwithtrace/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "TypeScript SDK for Trace — AI-powered PCB & schematic design",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",