computesdk 1.10.2 → 1.10.3

package/dist/index.d.mts

@@ -132,8 +132,13 @@ interface Sandbox$1 {
     readonly provider: string;
     /** Execute code in the sandbox */
     runCode(code: string, runtime?: Runtime): Promise<CodeResult$1>;
-    /** Execute shell commands */
-    runCommand(commandOrArray: string | [string, ...string[]], argsOrOptions?: string[] | RunCommandOptions, maybeOptions?: RunCommandOptions): Promise<CommandResult$1>;
+    /**
+     * Execute shell command
+     *
+     * Send raw command string to the sandbox - no preprocessing.
+     * The provider/server handles shell invocation and execution details.
+     */
+    runCommand(command: string, options?: RunCommandOptions): Promise<CommandResult$1>;
     /** Get information about the sandbox */
     getInfo(): Promise<SandboxInfo$1>;
     /** Get URL for accessing the sandbox on a specific port */
@@ -1695,6 +1700,10 @@ interface CommandRunOptions {
     shell?: string;
     /** Run in background (optional) */
     background?: boolean;
+    /** Working directory for the command (optional) */
+    cwd?: string;
+    /** Environment variables (optional) */
+    env?: Record<string, string>;
 }
 /**
  * Run - Resource namespace for executing code and commands
@@ -1740,6 +1749,8 @@ declare class Run {
      * @param options - Execution options
      * @param options.shell - Shell to use (optional)
      * @param options.background - Run in background (optional)
+     * @param options.cwd - Working directory for the command (optional)
+     * @param options.env - Environment variables (optional)
      * @returns Command execution result with stdout, stderr, exit code, and duration
      */
     command(command: string, options?: CommandRunOptions): Promise<CommandResult>;
@@ -2598,12 +2609,14 @@ declare class Sandbox {
      */
     runCodeRequest(code: string, language?: string): Promise<CodeExecutionResponse>;
     /**
-     * Execute a shell command (POST /run/command)
+     * Execute a command and get the result
+     * Lower-level method that returns the raw API response
      *
-     * @param options - Command options
-     * @param options.command - The command to execute
+     * @param options.command - Command to execute
      * @param options.shell - Shell to use (optional)
      * @param options.background - Run in background (optional)
+     * @param options.cwd - Working directory for the command (optional)
+     * @param options.env - Environment variables (optional)
      * @returns Command execution result
      *
      * @example
@@ -2616,6 +2629,8 @@ declare class Sandbox {
         command: string;
         shell?: string;
         background?: boolean;
+        cwd?: string;
+        env?: Record<string, string>;
     }): Promise<RunCommandResponse>;
     /**
      * List files at the specified path
@@ -2891,21 +2906,37 @@ declare class Sandbox {
         language: string;
     }>;
     /**
-     * Execute shell command in the sandbox (convenience method)
+     * Execute shell command in the sandbox
      *
-     * Delegates to sandbox.run.command() - prefer using that directly for new code.
+     * Sends clean command string to server - no preprocessing or shell wrapping.
+     * The server handles shell invocation, working directory, and backgrounding.
      *
-     * @param command - The command to execute (string or array form)
-     * @param argsOrOptions - Arguments array or options object
-     * @param maybeOptions - Options when using (command, args, options) form
+     * @param command - The command to execute (raw string, e.g., "npm install")
+     * @param options - Execution options
+     * @param options.background - Run in background (server uses goroutines)
+     * @param options.cwd - Working directory (server uses cmd.Dir)
+     * @param options.env - Environment variables (server uses cmd.Env)
      * @returns Command execution result
+     *
+     * @example
+     * ```typescript
+     * // Simple command
+     * await sandbox.runCommand('ls -la')
+     *
+     * // With working directory
+     * await sandbox.runCommand('npm install', { cwd: '/app' })
+     *
+     * // Background with env vars
+     * await sandbox.runCommand('node server.js', {
+     *   background: true,
+     *   env: { PORT: '3000' }
+     * })
+     * ```
      */
-    runCommand(commandOrArray: string | [string, ...string[]], argsOrOptions?: string[] | {
-        background?: boolean;
-        cwd?: string;
-    }, maybeOptions?: {
+    runCommand(command: string, options?: {
         background?: boolean;
         cwd?: string;
+        env?: Record<string, string>;
     }): Promise<{
         stdout: string;
         stderr: string;

package/dist/index.d.ts

@@ -132,8 +132,13 @@ interface Sandbox$1 {
     readonly provider: string;
     /** Execute code in the sandbox */
     runCode(code: string, runtime?: Runtime): Promise<CodeResult$1>;
-    /** Execute shell commands */
-    runCommand(commandOrArray: string | [string, ...string[]], argsOrOptions?: string[] | RunCommandOptions, maybeOptions?: RunCommandOptions): Promise<CommandResult$1>;
+    /**
+     * Execute shell command
+     *
+     * Send raw command string to the sandbox - no preprocessing.
+     * The provider/server handles shell invocation and execution details.
+     */
+    runCommand(command: string, options?: RunCommandOptions): Promise<CommandResult$1>;
     /** Get information about the sandbox */
     getInfo(): Promise<SandboxInfo$1>;
     /** Get URL for accessing the sandbox on a specific port */
@@ -1695,6 +1700,10 @@ interface CommandRunOptions {
     shell?: string;
     /** Run in background (optional) */
     background?: boolean;
+    /** Working directory for the command (optional) */
+    cwd?: string;
+    /** Environment variables (optional) */
+    env?: Record<string, string>;
 }
 /**
  * Run - Resource namespace for executing code and commands
@@ -1740,6 +1749,8 @@ declare class Run {
      * @param options - Execution options
      * @param options.shell - Shell to use (optional)
      * @param options.background - Run in background (optional)
+     * @param options.cwd - Working directory for the command (optional)
+     * @param options.env - Environment variables (optional)
      * @returns Command execution result with stdout, stderr, exit code, and duration
      */
     command(command: string, options?: CommandRunOptions): Promise<CommandResult>;
@@ -2598,12 +2609,14 @@ declare class Sandbox {
      */
     runCodeRequest(code: string, language?: string): Promise<CodeExecutionResponse>;
     /**
-     * Execute a shell command (POST /run/command)
+     * Execute a command and get the result
+     * Lower-level method that returns the raw API response
      *
-     * @param options - Command options
-     * @param options.command - The command to execute
+     * @param options.command - Command to execute
      * @param options.shell - Shell to use (optional)
      * @param options.background - Run in background (optional)
+     * @param options.cwd - Working directory for the command (optional)
+     * @param options.env - Environment variables (optional)
      * @returns Command execution result
      *
      * @example
@@ -2616,6 +2629,8 @@ declare class Sandbox {
         command: string;
         shell?: string;
         background?: boolean;
+        cwd?: string;
+        env?: Record<string, string>;
     }): Promise<RunCommandResponse>;
     /**
      * List files at the specified path
@@ -2891,21 +2906,37 @@ declare class Sandbox {
         language: string;
     }>;
     /**
-     * Execute shell command in the sandbox (convenience method)
+     * Execute shell command in the sandbox
      *
-     * Delegates to sandbox.run.command() - prefer using that directly for new code.
+     * Sends clean command string to server - no preprocessing or shell wrapping.
+     * The server handles shell invocation, working directory, and backgrounding.
      *
-     * @param command - The command to execute (string or array form)
-     * @param argsOrOptions - Arguments array or options object
-     * @param maybeOptions - Options when using (command, args, options) form
+     * @param command - The command to execute (raw string, e.g., "npm install")
+     * @param options - Execution options
+     * @param options.background - Run in background (server uses goroutines)
+     * @param options.cwd - Working directory (server uses cmd.Dir)
+     * @param options.env - Environment variables (server uses cmd.Env)
      * @returns Command execution result
+     *
+     * @example
+     * ```typescript
+     * // Simple command
+     * await sandbox.runCommand('ls -la')
+     *
+     * // With working directory
+     * await sandbox.runCommand('npm install', { cwd: '/app' })
+     *
+     * // Background with env vars
+     * await sandbox.runCommand('node server.js', {
+     *   background: true,
+     *   env: { PORT: '3000' }
+     * })
+     * ```
      */
-    runCommand(commandOrArray: string | [string, ...string[]], argsOrOptions?: string[] | {
-        background?: boolean;
-        cwd?: string;
-    }, maybeOptions?: {
+    runCommand(command: string, options?: {
         background?: boolean;
         cwd?: string;
+        env?: Record<string, string>;
     }): Promise<{
         stdout: string;
         stderr: string;

package/dist/index.js

@@ -728,7 +728,7 @@ var TerminalCommand = class {
    */
   async run(command, options) {
     const response = await this.runHandler(command, options?.background);
-    const cmd2 = new Command({
+    const cmd = new Command({
       cmdId: response.data.cmd_id || "",
       terminalId: this.terminalId,
       command: response.data.command,
@@ -739,9 +739,9 @@ var TerminalCommand = class {
       durationMs: response.data.duration_ms,
       startedAt: (/* @__PURE__ */ new Date()).toISOString()
     });
-    cmd2.setWaitHandler((timeout) => this.waitHandler(cmd2.id, timeout));
-    cmd2.setRetrieveHandler(() => this.retrieveHandler(cmd2.id));
-    return cmd2;
+    cmd.setWaitHandler((timeout) => this.waitHandler(cmd.id, timeout));
+    cmd.setRetrieveHandler(() => this.retrieveHandler(cmd.id));
+    return cmd;
   }
   /**
    * List all commands executed in this terminal
@@ -750,7 +750,7 @@ var TerminalCommand = class {
   async list() {
     const response = await this.listHandler();
     return response.data.commands.map((item) => {
-      const cmd2 = new Command({
+      const cmd = new Command({
         cmdId: item.cmd_id,
         terminalId: this.terminalId,
         command: item.command,
@@ -764,9 +764,9 @@ var TerminalCommand = class {
         startedAt: item.started_at,
         finishedAt: item.finished_at
       });
-      cmd2.setWaitHandler((timeout) => this.waitHandler(cmd2.id, timeout));
-      cmd2.setRetrieveHandler(() => this.retrieveHandler(cmd2.id));
-      return cmd2;
+      cmd.setWaitHandler((timeout) => this.waitHandler(cmd.id, timeout));
+      cmd.setRetrieveHandler(() => this.retrieveHandler(cmd.id));
+      return cmd;
     });
   }
   /**
@@ -776,7 +776,7 @@ var TerminalCommand = class {
    */
   async retrieve(cmdId) {
     const response = await this.retrieveHandler(cmdId);
-    const cmd2 = new Command({
+    const cmd = new Command({
       cmdId: response.data.cmd_id,
       terminalId: this.terminalId,
       command: response.data.command,
@@ -788,9 +788,9 @@ var TerminalCommand = class {
       startedAt: response.data.started_at,
       finishedAt: response.data.finished_at
     });
-    cmd2.setWaitHandler((timeout) => this.waitHandler(cmd2.id, timeout));
-    cmd2.setRetrieveHandler(() => this.retrieveHandler(cmd2.id));
-    return cmd2;
+    cmd.setWaitHandler((timeout) => this.waitHandler(cmd.id, timeout));
+    cmd.setRetrieveHandler(() => this.retrieveHandler(cmd.id));
+    return cmd;
   }
 };
 
@@ -1810,6 +1810,8 @@ var Run = class {
    * @param options - Execution options
    * @param options.shell - Shell to use (optional)
    * @param options.background - Run in background (optional)
+   * @param options.cwd - Working directory for the command (optional)
+   * @param options.env - Environment variables (optional)
    * @returns Command execution result with stdout, stderr, exit code, and duration
    */
   async command(command, options) {
@@ -1935,7 +1937,7 @@ var Sandbox = class {
         await this.writeFile(path, content);
       },
       mkdir: async (path) => {
-        await this.runCommand((0, import_cmd.mkdir)(path));
+        await this.runCommand((0, import_cmd.escapeArgs)((0, import_cmd.mkdir)(path)));
       },
       readdir: async (path) => {
         const response = await this.listFiles(path);
@@ -1947,7 +1949,7 @@ var Sandbox = class {
         }));
       },
       exists: async (path) => {
-        const result = await this.runCommand(import_cmd.test.exists(path));
+        const result = await this.runCommand((0, import_cmd.escapeArgs)(import_cmd.test.exists(path)));
         return result.exitCode === 0;
       },
       remove: async (path) => {
@@ -1972,7 +1974,13 @@ var Sandbox = class {
         };
       },
       command: async (command, options) => {
-        const result = await this.runCommandRequest({ command, shell: options?.shell, background: options?.background });
+        const result = await this.runCommandRequest({
+          command,
+          shell: options?.shell,
+          background: options?.background,
+          cwd: options?.cwd,
+          env: options?.env
+        });
         return {
           stdout: result.data.stdout,
           stderr: result.data.stderr,
@@ -2286,12 +2294,14 @@ API request failed (${response.status}): ${error}`
     });
   }
   /**
-   * Execute a shell command (POST /run/command)
+   * Execute a command and get the result
+   * Lower-level method that returns the raw API response
    *
-   * @param options - Command options
-   * @param options.command - The command to execute
+   * @param options.command - Command to execute
    * @param options.shell - Shell to use (optional)
    * @param options.background - Run in background (optional)
+   * @param options.cwd - Working directory for the command (optional)
+   * @param options.env - Environment variables (optional)
    * @returns Command execution result
    *
    * @example
@@ -2888,29 +2898,35 @@ API request failed (${response.status}): ${error}`
     return this.run.code(code, language ? { language } : void 0);
   }
   /**
-   * Execute shell command in the sandbox (convenience method)
+   * Execute shell command in the sandbox
    *
-   * Delegates to sandbox.run.command() - prefer using that directly for new code.
+   * Sends clean command string to server - no preprocessing or shell wrapping.
+   * The server handles shell invocation, working directory, and backgrounding.
    *
-   * @param command - The command to execute (string or array form)
-   * @param argsOrOptions - Arguments array or options object
-   * @param maybeOptions - Options when using (command, args, options) form
+   * @param command - The command to execute (raw string, e.g., "npm install")
+   * @param options - Execution options
+   * @param options.background - Run in background (server uses goroutines)
+   * @param options.cwd - Working directory (server uses cmd.Dir)
+   * @param options.env - Environment variables (server uses cmd.Env)
    * @returns Command execution result
+   * 
+   * @example
+   * ```typescript
+   * // Simple command
+   * await sandbox.runCommand('ls -la')
+   * 
+   * // With working directory
+   * await sandbox.runCommand('npm install', { cwd: '/app' })
+   * 
+   * // Background with env vars
+   * await sandbox.runCommand('node server.js', { 
+   *   background: true, 
+   *   env: { PORT: '3000' } 
+   * })
+   * ```
    */
-  async runCommand(commandOrArray, argsOrOptions, maybeOptions) {
-    let commandParts;
-    let options;
-    if (Array.isArray(commandOrArray)) {
-      commandParts = commandOrArray;
-      options = argsOrOptions;
-    } else {
-      const args = Array.isArray(argsOrOptions) ? argsOrOptions : [];
-      commandParts = [commandOrArray, ...args];
-      options = Array.isArray(argsOrOptions) ? maybeOptions : argsOrOptions;
-    }
-    const finalCommand = (0, import_cmd.cmd)(commandParts, options);
-    const fullCommand = (0, import_cmd.escapeArgs)(finalCommand);
-    return this.run.command(fullCommand, { background: options?.background });
+  async runCommand(command, options) {
+    return this.run.command(command, options);
   }
   /**
    * Get server information