computesdk 2.0.2 → 2.1.2

package/dist/index.d.mts

@@ -3700,6 +3700,7 @@ declare class Sandbox {
      * @param options.env - Environment variables (server uses cmd.Env)
      * @param options.onStdout - Callback for streaming stdout data
      * @param options.onStderr - Callback for streaming stderr data
+     * @param options.timeout - Timeout in seconds (max 300 for long-running commands)
      * @returns Command execution result
      *
      * @example
@@ -3721,6 +3722,9 @@ declare class Sandbox {
      *   onStdout: (data) => console.log(data),
      *   onStderr: (data) => console.error(data),
      * })
+     *
+     * // With timeout for long-running commands
+     * await sandbox.runCommand('npm install', { timeout: 120 })
      * ```
      */
     runCommand(command: string, options?: {
@@ -3729,6 +3733,8 @@ declare class Sandbox {
         env?: Record<string, string>;
         onStdout?: (data: string) => void;
         onStderr?: (data: string) => void;
+        /** Timeout in seconds (max 300 for long-running commands) */
+        timeout?: number;
     }): Promise<{
         stdout: string;
         stderr: string;
@@ -3836,6 +3842,7 @@ declare const PROVIDER_AUTH: {
     readonly codesandbox: readonly [readonly ["CSB_API_KEY"]];
     readonly blaxel: readonly [readonly ["BL_API_KEY", "BL_WORKSPACE"]];
     readonly namespace: readonly [readonly ["NSC_TOKEN"]];
+    readonly hopx: readonly [readonly ["HOPX_API_KEY"]];
 };
 /**
  * All supported provider names (excluding gateway which is special)
@@ -3948,14 +3955,22 @@ interface ExplicitComputeConfig {
     };
     codesandbox?: {
         apiKey?: string;
+        templateId?: string;
+        timeout?: number;
     };
     blaxel?: {
         apiKey?: string;
         workspace?: string;
+        image?: string;
+        region?: string;
+        memory?: number;
     };
     namespace?: {
         token?: string;
     };
+    hopx?: {
+        apiKey?: string;
+    };
 }
 /**
  * Options for creating a sandbox via the gateway
@@ -4174,7 +4189,7 @@ declare const GATEWAY_URL = "https://gateway.computesdk.com";
  * Provider detection priority order
  * When multiple provider credentials are detected, use the first one in this list
  */
-declare const PROVIDER_PRIORITY: readonly ["e2b", "railway", "render", "daytona", "modal", "runloop", "vercel", "cloudflare", "codesandbox", "blaxel", "namespace"];
+declare const PROVIDER_PRIORITY: readonly ["e2b", "railway", "render", "daytona", "modal", "runloop", "vercel", "cloudflare", "codesandbox", "blaxel", "namespace", "hopx"];
 /**
  * Required environment variables for each provider
  * @deprecated Use PROVIDER_AUTH from provider-config instead
@@ -4191,6 +4206,7 @@ declare const PROVIDER_ENV_VARS: {
     readonly codesandbox: readonly ["CSB_API_KEY"];
     readonly blaxel: readonly ["BL_API_KEY", "BL_WORKSPACE"];
     readonly namespace: readonly ["NSC_TOKEN"];
+    readonly hopx: readonly ["HOPX_API_KEY"];
 };
 
 export { type CallableCompute, type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type ExplicitComputeConfig, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, type SetupOverlayConfig, type SetupPayload, SignalService, TerminalInstance, type WebSocketConstructor, autoConfigureCompute, buildProviderHeaders, buildSetupPayload, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, encodeSetupPayload, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };

package/dist/index.d.ts

@@ -3700,6 +3700,7 @@ declare class Sandbox {
      * @param options.env - Environment variables (server uses cmd.Env)
      * @param options.onStdout - Callback for streaming stdout data
      * @param options.onStderr - Callback for streaming stderr data
+     * @param options.timeout - Timeout in seconds (max 300 for long-running commands)
      * @returns Command execution result
      *
      * @example
@@ -3721,6 +3722,9 @@ declare class Sandbox {
      *   onStdout: (data) => console.log(data),
      *   onStderr: (data) => console.error(data),
      * })
+     *
+     * // With timeout for long-running commands
+     * await sandbox.runCommand('npm install', { timeout: 120 })
      * ```
      */
     runCommand(command: string, options?: {
@@ -3729,6 +3733,8 @@ declare class Sandbox {
         env?: Record<string, string>;
         onStdout?: (data: string) => void;
         onStderr?: (data: string) => void;
+        /** Timeout in seconds (max 300 for long-running commands) */
+        timeout?: number;
     }): Promise<{
         stdout: string;
         stderr: string;
@@ -3836,6 +3842,7 @@ declare const PROVIDER_AUTH: {
     readonly codesandbox: readonly [readonly ["CSB_API_KEY"]];
     readonly blaxel: readonly [readonly ["BL_API_KEY", "BL_WORKSPACE"]];
     readonly namespace: readonly [readonly ["NSC_TOKEN"]];
+    readonly hopx: readonly [readonly ["HOPX_API_KEY"]];
 };
 /**
  * All supported provider names (excluding gateway which is special)
@@ -3948,14 +3955,22 @@ interface ExplicitComputeConfig {
     };
     codesandbox?: {
         apiKey?: string;
+        templateId?: string;
+        timeout?: number;
     };
     blaxel?: {
         apiKey?: string;
         workspace?: string;
+        image?: string;
+        region?: string;
+        memory?: number;
     };
     namespace?: {
         token?: string;
     };
+    hopx?: {
+        apiKey?: string;
+    };
 }
 /**
  * Options for creating a sandbox via the gateway
@@ -4174,7 +4189,7 @@ declare const GATEWAY_URL = "https://gateway.computesdk.com";
  * Provider detection priority order
  * When multiple provider credentials are detected, use the first one in this list
  */
-declare const PROVIDER_PRIORITY: readonly ["e2b", "railway", "render", "daytona", "modal", "runloop", "vercel", "cloudflare", "codesandbox", "blaxel", "namespace"];
+declare const PROVIDER_PRIORITY: readonly ["e2b", "railway", "render", "daytona", "modal", "runloop", "vercel", "cloudflare", "codesandbox", "blaxel", "namespace", "hopx"];
 /**
  * Required environment variables for each provider
  * @deprecated Use PROVIDER_AUTH from provider-config instead
@@ -4191,6 +4206,7 @@ declare const PROVIDER_ENV_VARS: {
     readonly codesandbox: readonly ["CSB_API_KEY"];
     readonly blaxel: readonly ["BL_API_KEY", "BL_WORKSPACE"];
     readonly namespace: readonly ["NSC_TOKEN"];
+    readonly hopx: readonly ["HOPX_API_KEY"];
 };
 
 export { type CallableCompute, type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type ExplicitComputeConfig, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, type SetupOverlayConfig, type SetupPayload, SignalService, TerminalInstance, type WebSocketConstructor, autoConfigureCompute, buildProviderHeaders, buildSetupPayload, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, encodeSetupPayload, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };

package/dist/index.js

@@ -2364,7 +2364,9 @@ var Sandbox = class {
     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);
+      return this.request(endpoint, {
+        headers: timeout ? { "X-Request-Timeout": timeout.toString() } : void 0
+      });
     });
     terminal.setDestroyHandler(async () => {
       await this.request(`/terminals/${terminalId}`, {
@@ -2380,6 +2382,11 @@ var Sandbox = class {
   async request(endpoint, options = {}) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    if (process.env.COMPUTESDK_DEBUG) {
+      console.log(`[ComputeSDK] Request: ${options.method || "GET"} ${this.config.sandboxUrl}${endpoint}`);
+      console.log(`[ComputeSDK]   Sandbox ID: ${this.config.sandboxId}`);
+      console.log(`[ComputeSDK]   Token: ${this._token || "(no token)"}`);
+    }
     try {
       const headers = {
         ...this.config.headers
@@ -2422,6 +2429,15 @@ API request failed (${response.status}): ${error}`
             );
           }
         }
+        if (response.status === 403 && process.env.COMPUTESDK_DEBUG) {
+          console.error(`[ComputeSDK] 403 Forbidden Debug Info:`);
+          console.error(`  Endpoint: ${endpoint}`);
+          console.error(`  Method: ${options.method || "GET"}`);
+          console.error(`  Sandbox URL: ${this.config.sandboxUrl}`);
+          console.error(`  Sandbox ID: ${this.config.sandboxId}`);
+          console.error(`  Token: ${this._token || "(no token)"}`);
+          console.error(`  Error: ${error}`);
+        }
         throw new Error(`API request failed (${response.status}): ${error}`);
       }
       return data;
@@ -2941,7 +2957,9 @@ API request failed (${response.status}): ${error}`
   async waitForCommand(terminalId, cmdId, timeout) {
     const params = timeout ? new URLSearchParams({ timeout: timeout.toString() }) : "";
     const endpoint = `/terminals/${terminalId}/commands/${cmdId}/wait${params ? `?${params}` : ""}`;
-    return this.request(endpoint);
+    return this.request(endpoint, {
+      headers: timeout ? { "X-Request-Timeout": timeout.toString() } : void 0
+    });
   }
   /**
    * Wait for a background command to complete using long-polling
@@ -3308,6 +3326,7 @@ API request failed (${response.status}): ${error}`
     const response = await this.request("/ready");
     return {
       ready: response.ready,
+      healthy: response.healthy,
       servers: response.servers ?? [],
       overlays: response.overlays ?? []
     };
@@ -3391,6 +3410,7 @@ API request failed (${response.status}): ${error}`
    * @param options.env - Environment variables (server uses cmd.Env)
    * @param options.onStdout - Callback for streaming stdout data
    * @param options.onStderr - Callback for streaming stderr data
+   * @param options.timeout - Timeout in seconds (max 300 for long-running commands)
    * @returns Command execution result
    * 
    * @example
@@ -3412,11 +3432,21 @@ API request failed (${response.status}): ${error}`
    *   onStdout: (data) => console.log(data),
    *   onStderr: (data) => console.error(data),
    * })
+   * 
+   * // With timeout for long-running commands
+   * await sandbox.runCommand('npm install', { timeout: 120 })
    * ```
    */
   async runCommand(command, options) {
     const hasStreamingCallbacks = options?.onStdout || options?.onStderr;
     if (!hasStreamingCallbacks) {
+      if (options?.timeout && !options?.background) {
+        return this.run.command(command, {
+          ...options,
+          background: true,
+          waitForCompletion: { timeoutSeconds: options.timeout }
+        });
+      }
       return this.run.command(command, options);
     }
     const ws = await this.ensureWebSocket();
@@ -3474,9 +3504,20 @@ API request failed (${response.status}): ${error}`
         durationMs: 0
       };
     }
-    return new Promise((resolve) => {
+    const commandPromise = new Promise((resolve) => {
       resolvePromise = resolve;
     });
+    if (options?.timeout) {
+      const timeoutMs = options.timeout * 1e3;
+      const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => {
+          cleanup();
+          reject(new Error(`Command timed out after ${options.timeout} seconds`));
+        }, timeoutMs);
+      });
+      return Promise.race([commandPromise, timeoutPromise]);
+    }
+    return commandPromise;
   }
   /**
    * Get server information
@@ -3606,7 +3647,8 @@ var PROVIDER_AUTH = {
   cloudflare: [["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]],
   codesandbox: [["CSB_API_KEY"]],
   blaxel: [["BL_API_KEY", "BL_WORKSPACE"]],
-  namespace: [["NSC_TOKEN"]]
+  namespace: [["NSC_TOKEN"]],
+  hopx: [["HOPX_API_KEY"]]
 };
 var PROVIDER_NAMES = Object.keys(PROVIDER_AUTH);
 var PROVIDER_HEADERS = {
@@ -3643,7 +3685,7 @@ var PROVIDER_HEADERS = {
     accountId: "X-Cloudflare-Account-Id"
   },
   codesandbox: {
-    apiKey: "X-CSB-API-Key"
+    apiKey: "X-CODESANDBOX-API-Key"
   },
   blaxel: {
     apiKey: "X-Blaxel-API-Key",
@@ -3651,6 +3693,9 @@ var PROVIDER_HEADERS = {
   },
   namespace: {
     token: "X-Namespace-Token"
+  },
+  hopx: {
+    apiKey: "X-HOPX-API-Key"
   }
 };
 var PROVIDER_ENV_MAP = {
@@ -3695,6 +3740,9 @@ var PROVIDER_ENV_MAP = {
   },
   namespace: {
     NSC_TOKEN: "token"
+  },
+  hopx: {
+    HOPX_API_KEY: "apiKey"
   }
 };
 var PROVIDER_DASHBOARD_URLS = {
@@ -3708,7 +3756,8 @@ var PROVIDER_DASHBOARD_URLS = {
   cloudflare: "https://dash.cloudflare.com/profile/api-tokens",
   codesandbox: "https://codesandbox.io/dashboard/settings",
   blaxel: "https://blaxel.ai/dashboard",
-  namespace: "https://cloud.namespace.so"
+  namespace: "https://cloud.namespace.so",
+  hopx: "https://hopx.ai/dashboard"
 };
 function isValidProvider(name) {
   return name in PROVIDER_AUTH;
@@ -3777,7 +3826,8 @@ var PROVIDER_PRIORITY = [
   "cloudflare",
   "codesandbox",
   "blaxel",
-  "namespace"
+  "namespace",
+  "hopx"
 ];
 var PROVIDER_ENV_VARS = {
   e2b: ["E2B_API_KEY"],
@@ -3790,7 +3840,8 @@ var PROVIDER_ENV_VARS = {
   cloudflare: ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"],
   codesandbox: ["CSB_API_KEY"],
   blaxel: ["BL_API_KEY", "BL_WORKSPACE"],
-  namespace: ["NSC_TOKEN"]
+  namespace: ["NSC_TOKEN"],
+  hopx: ["HOPX_API_KEY"]
 };
 
 // src/auto-detect.ts
@@ -3912,6 +3963,11 @@ function getProviderHeaders(provider) {
         headers["X-Namespace-Token"] = process.env.NSC_TOKEN;
       }
       break;
+    case "hopx":
+      if (process.env.HOPX_API_KEY) {
+        headers["X-HOPX-API-Key"] = process.env.HOPX_API_KEY;
+      }
+      break;
   }
   return headers;
 }
@@ -3949,6 +4005,7 @@ To fix this, set one of the following:
   CodeSandbox: export CSB_API_KEY=xxx
   Blaxel:     export BL_API_KEY=xxx BL_WORKSPACE=xxx
   Namespace:  export NSC_TOKEN=xxx
+  HopX:       export HOPX_API_KEY=xxx
 
 Or set COMPUTESDK_PROVIDER to specify explicitly:
   export COMPUTESDK_PROVIDER=e2b
@@ -4062,7 +4119,7 @@ Get your API key at: https://computesdk.com/dashboard`
   const providerHeaders = buildProviderHeaders2(config);
   return {
     apiKey: computesdkApiKey,
-    gatewayUrl: config.gatewayUrl || GATEWAY_URL,
+    gatewayUrl: config.gatewayUrl || process.env.COMPUTESDK_GATEWAY_URL || GATEWAY_URL,
     provider: config.provider,
     providerHeaders,
     requestTimeoutMs: config.requestTimeoutMs,