computesdk 1.17.0 → 1.18.1

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();
   }
 };
 
@@ -3419,6 +3453,7 @@ var PROVIDER_AUTH = {
   e2b: [["E2B_API_KEY"]],
   modal: [["MODAL_TOKEN_ID", "MODAL_TOKEN_SECRET"]],
   railway: [["RAILWAY_API_KEY", "RAILWAY_PROJECT_ID", "RAILWAY_ENVIRONMENT_ID"]],
+  render: [["RENDER_API_KEY", "RENDER_OWNER_ID"]],
   daytona: [["DAYTONA_API_KEY"]],
   vercel: [
     ["VERCEL_OIDC_TOKEN"],
@@ -3443,6 +3478,10 @@ var PROVIDER_HEADERS = {
     projectId: "X-Railway-Project-ID",
     environmentId: "X-Railway-Environment-ID"
   },
+  render: {
+    apiKey: "X-Render-API-Key",
+    ownerId: "X-Render-Owner-ID"
+  },
   daytona: {
     apiKey: "X-Daytona-API-Key"
   },
@@ -3480,6 +3519,10 @@ var PROVIDER_ENV_MAP = {
     RAILWAY_PROJECT_ID: "projectId",
     RAILWAY_ENVIRONMENT_ID: "environmentId"
   },
+  render: {
+    RENDER_API_KEY: "apiKey",
+    RENDER_OWNER_ID: "ownerId"
+  },
   daytona: {
     DAYTONA_API_KEY: "apiKey"
   },
@@ -3508,6 +3551,7 @@ var PROVIDER_DASHBOARD_URLS = {
   e2b: "https://e2b.dev/dashboard",
   modal: "https://modal.com/settings",
   railway: "https://railway.app/account/tokens",
+  render: "https://dashboard.render.com/account",
   daytona: "https://daytona.io/dashboard",
   vercel: "https://vercel.com/account/tokens",
   runloop: "https://runloop.ai/dashboard",
@@ -3574,6 +3618,7 @@ var GATEWAY_URL = "https://gateway.computesdk.com";
 var PROVIDER_PRIORITY = [
   "e2b",
   "railway",
+  "render",
   "daytona",
   "modal",
   "runloop",
@@ -3585,6 +3630,7 @@ var PROVIDER_PRIORITY = [
 var PROVIDER_ENV_VARS = {
   e2b: ["E2B_API_KEY"],
   railway: ["RAILWAY_API_KEY", "RAILWAY_PROJECT_ID", "RAILWAY_ENVIRONMENT_ID"],
+  render: ["RENDER_API_KEY", "RENDER_OWNER_ID"],
   daytona: ["DAYTONA_API_KEY"],
   modal: ["MODAL_TOKEN_ID", "MODAL_TOKEN_SECRET"],
   runloop: ["RUNLOOP_API_KEY"],