computesdk 1.18.0 → 1.18.2

package/dist/index.mjs

@@ -1312,7 +1312,7 @@ var Terminal = class {
   /**
    * Retrieve a specific terminal by ID
    * @param id - The terminal ID
-   * @returns Terminal response
+   * @returns Terminal instance
    */
   async retrieve(id) {
     return this.retrieveHandler(id);
@@ -1922,6 +1922,7 @@ var Overlay = class {
    * @param options.source - Absolute path to source directory
    * @param options.target - Relative path in sandbox
    * @param options.ignore - Glob patterns to ignore (e.g., ["node_modules", "*.log"])
+   * @param options.strategy - Strategy to use ('copy' or 'smart')
    * @param options.waitForCompletion - If true or options object, wait for background copy to complete
    * @returns Overlay info with copy status
    */
@@ -2011,6 +2012,7 @@ Try increasing maxRetries or check if the source directory is very large.`
       id: response.id,
       source: response.source,
       target: response.target,
+      strategy: this.validateStrategy(response.strategy),
       createdAt: response.created_at,
       stats: {
         copiedFiles: response.stats.copied_files,
@@ -2021,6 +2023,16 @@ Try increasing maxRetries or check if the source directory is very large.`
       copyError: response.copy_error
     };
   }
+  /**
+   * Validate and return strategy, defaulting to 'copy' for unknown/missing values (legacy support)
+   */
+  validateStrategy(strategy) {
+    const validStrategies = ["copy", "smart"];
+    if (strategy && validStrategies.includes(strategy)) {
+      return strategy;
+    }
+    return "copy";
+  }
   /**
    * Validate and return copy status, defaulting to 'pending' for unknown values
    */
@@ -2051,6 +2063,7 @@ var Sandbox = class {
   constructor(config) {
     this._token = null;
     this._ws = null;
+    this._terminals = /* @__PURE__ */ new Map();
     this.sandboxId = config.sandboxId;
     this.provider = config.provider;
     let sandboxUrlResolved = config.sandboxUrl;
@@ -2257,6 +2270,44 @@ var Sandbox = class {
     }
     return this._ws;
   }
+  /**
+   * Create and configure a TerminalInstance from response data
+   */
+  async hydrateTerminal(data, ws) {
+    const terminal = new TerminalInstance(
+      data.id,
+      data.pty,
+      data.status,
+      data.channel || null,
+      ws || null,
+      data.encoding || "raw"
+    );
+    const terminalId = data.id;
+    terminal.setExecuteHandler(async (command, background) => {
+      return this.request(`/terminals/${terminalId}/execute`, {
+        method: "POST",
+        body: JSON.stringify({ command, background })
+      });
+    });
+    terminal.setListCommandsHandler(async () => {
+      return this.request(`/terminals/${terminalId}/commands`);
+    });
+    terminal.setRetrieveCommandHandler(async (cmdId) => {
+      return this.request(`/terminals/${terminalId}/commands/${cmdId}`);
+    });
+    terminal.setWaitCommandHandler(async (cmdId, timeout) => {
+      const params = timeout ? new URLSearchParams({ timeout: timeout.toString() }) : "";
+      const endpoint = `/terminals/${terminalId}/commands/${cmdId}/wait${params ? `?${params}` : ""}`;
+      return this.request(endpoint);
+    });
+    terminal.setDestroyHandler(async () => {
+      await this.request(`/terminals/${terminalId}`, {
+        method: "DELETE"
+      });
+      this._terminals.delete(terminalId);
+    });
+    return terminal;
+  }
   // ============================================================================
   // Private Helper Methods
   // ============================================================================
@@ -2763,37 +2814,8 @@ API request failed (${response.status}): ${error}`
         }
       });
     }
-    const terminal = new TerminalInstance(
-      response.data.id,
-      response.data.pty,
-      response.data.status,
-      response.data.channel || null,
-      ws,
-      response.data.encoding || "raw"
-    );
-    const terminalId = response.data.id;
-    terminal.setExecuteHandler(async (command, background) => {
-      return this.request(`/terminals/${terminalId}/execute`, {
-        method: "POST",
-        body: JSON.stringify({ command, background })
-      });
-    });
-    terminal.setListCommandsHandler(async () => {
-      return this.request(`/terminals/${terminalId}/commands`);
-    });
-    terminal.setRetrieveCommandHandler(async (cmdId) => {
-      return this.request(`/terminals/${terminalId}/commands/${cmdId}`);
-    });
-    terminal.setWaitCommandHandler(async (cmdId, timeout) => {
-      const params = timeout ? new URLSearchParams({ timeout: timeout.toString() }) : "";
-      const endpoint = `/terminals/${terminalId}/commands/${cmdId}/wait${params ? `?${params}` : ""}`;
-      return this.request(endpoint);
-    });
-    terminal.setDestroyHandler(async () => {
-      await this.request(`/terminals/${terminalId}`, {
-        method: "DELETE"
-      });
-    });
+    const terminal = await this.hydrateTerminal(response.data, ws);
+    this._terminals.set(terminal.id, terminal);
     return terminal;
   }
   /**
@@ -2807,7 +2829,18 @@ API request failed (${response.status}): ${error}`
    * Get terminal by ID
    */
   async getTerminal(id) {
-    return this.request(`/terminals/${id}`);
+    const cached = this._terminals.get(id);
+    if (cached) {
+      return cached;
+    }
+    const response = await this.request(`/terminals/${id}`);
+    let ws = null;
+    if (response.data.pty) {
+      ws = await this.ensureWebSocket();
+    }
+    const terminal = await this.hydrateTerminal(response.data, ws);
+    this._terminals.set(id, terminal);
+    return terminal;
   }
   // ============================================================================
   // Command Tracking (Exec Mode Terminals)
@@ -3411,6 +3444,7 @@ API request failed (${response.status}): ${error}`
       this._ws.disconnect();
       this._ws = null;
     }
+    this._terminals.clear();
   }
 };
 
@@ -3428,7 +3462,8 @@ var PROVIDER_AUTH = {
   runloop: [["RUNLOOP_API_KEY"]],
   cloudflare: [["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]],
   codesandbox: [["CSB_API_KEY"]],
-  blaxel: [["BL_API_KEY", "BL_WORKSPACE"]]
+  blaxel: [["BL_API_KEY", "BL_WORKSPACE"]],
+  namespace: [["NSC_TOKEN"]]
 };
 var PROVIDER_NAMES = Object.keys(PROVIDER_AUTH);
 var PROVIDER_HEADERS = {
@@ -3470,6 +3505,9 @@ var PROVIDER_HEADERS = {
   blaxel: {
     apiKey: "X-BL-API-Key",
     workspace: "X-BL-Workspace"
+  },
+  namespace: {
+    token: "X-Namespace-Token"
   }
 };
 var PROVIDER_ENV_MAP = {
@@ -3511,6 +3549,9 @@ var PROVIDER_ENV_MAP = {
   blaxel: {
     BL_API_KEY: "apiKey",
     BL_WORKSPACE: "workspace"
+  },
+  namespace: {
+    NSC_TOKEN: "token"
   }
 };
 var PROVIDER_DASHBOARD_URLS = {
@@ -3523,7 +3564,8 @@ var PROVIDER_DASHBOARD_URLS = {
   runloop: "https://runloop.ai/dashboard",
   cloudflare: "https://dash.cloudflare.com/profile/api-tokens",
   codesandbox: "https://codesandbox.io/dashboard/settings",
-  blaxel: "https://blaxel.ai/dashboard"
+  blaxel: "https://blaxel.ai/dashboard",
+  namespace: "https://cloud.namespace.so"
 };
 function isValidProvider(name) {
   return name in PROVIDER_AUTH;
@@ -3591,7 +3633,8 @@ var PROVIDER_PRIORITY = [
   "vercel",
   "cloudflare",
   "codesandbox",
-  "blaxel"
+  "blaxel",
+  "namespace"
 ];
 var PROVIDER_ENV_VARS = {
   e2b: ["E2B_API_KEY"],
@@ -3603,7 +3646,8 @@ var PROVIDER_ENV_VARS = {
   vercel: ["VERCEL_TOKEN", "VERCEL_TEAM_ID", "VERCEL_PROJECT_ID"],
   cloudflare: ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"],
   codesandbox: ["CSB_API_KEY"],
-  blaxel: ["BL_API_KEY", "BL_WORKSPACE"]
+  blaxel: ["BL_API_KEY", "BL_WORKSPACE"],
+  namespace: ["NSC_TOKEN"]
 };
 
 // src/auto-detect.ts
@@ -3720,6 +3764,11 @@ function getProviderHeaders(provider) {
         headers["X-Blaxel-Workspace"] = process.env.BL_WORKSPACE;
       }
       break;
+    case "namespace":
+      if (process.env.NSC_TOKEN) {
+        headers["X-Namespace-Token"] = process.env.NSC_TOKEN;
+      }
+      break;
   }
   return headers;
 }
@@ -3756,6 +3805,7 @@ To fix this, set one of the following:
   Cloudflare: export CLOUDFLARE_API_TOKEN=xxx CLOUDFLARE_ACCOUNT_ID=xxx
   CodeSandbox: export CSB_API_KEY=xxx
   Blaxel:     export BL_API_KEY=xxx BL_WORKSPACE=xxx
+  Namespace:  export NSC_TOKEN=xxx
 
 Or set COMPUTESDK_PROVIDER to specify explicitly:
   export COMPUTESDK_PROVIDER=e2b