@computesdk/beam 0.1.7 → 0.1.9

package/dist/index.js

@@ -39,28 +39,6 @@ function shellEscape(arg) {
   if (arg === "") return "''";
   return `'${arg.replace(/'/g, "'\\''")}'`;
 }
-function isNodeParserFailure(output) {
-  const hasSyntaxMarker = output.includes("SyntaxError") || output.includes("Unexpected token") || output.includes("Unexpected identifier") || output.includes("Unexpected end of input") || output.includes("Invalid or unexpected token");
-  const hasCompileContext = output.includes("[eval]") || output.includes("makeContextifyScript") || output.includes("compileScript") || output.includes("wrapSafe");
-  const hasRuntimeSyntaxSignature = output.includes("at JSON.parse") || output.includes("JSON.parse (<anonymous>)") || output.includes("in JSON at position");
-  return hasSyntaxMarker && hasCompileContext && !hasRuntimeSyntaxSignature;
-}
-function isPythonParserFailure(output) {
-  const hasSyntaxMarker = output.includes("SyntaxError") || output.includes("IndentationError") || output.includes("TabError");
-  const hasStringFileContext = output.includes('File "<string>"');
-  const hasRuntimeTraceback = output.includes("Traceback (most recent call last)");
-  return hasSyntaxMarker && hasStringFileContext && !hasRuntimeTraceback;
-}
-function isParserFailure(output, runtime) {
-  if (!output.trim()) return false;
-  if (runtime === "node") {
-    return isNodeParserFailure(output);
-  }
-  if (runtime === "python") {
-    return isPythonParserFailure(output);
-  }
-  return false;
-}
 var beam = (0, import_provider.defineProvider)({
   name: "beam",
   methods: {
@@ -83,10 +61,6 @@ var beam = (0, import_provider.defineProvider)({
           );
         }
         try {
-          if (options?.sandboxId) {
-            const instance2 = await import_beam_js.Sandbox.connect(options.sandboxId);
-            return { sandbox: instance2, sandboxId: instance2.containerId };
-          }
           const {
             runtime: optRuntime,
             timeout: optTimeout,
@@ -98,8 +72,6 @@ var beam = (0, import_provider.defineProvider)({
             sandboxId: _sandboxId,
             namespace: _namespace,
             directory: _directory,
-            overlays: _overlays,
-            servers: _servers,
             ...providerOptions
           } = options || {};
           const sandboxConfig = {
@@ -180,38 +152,6 @@ var beam = (0, import_provider.defineProvider)({
        *
        * Auto-detects runtime (Python vs Node.js) and executes via sandbox.exec().
        */
-      runCode: async (sandbox, code, runtime) => {
-        const effectiveRuntime = runtime || (code.includes("print(") || code.includes("import ") || code.includes("def ") || code.includes("sys.") || code.includes("json.") || code.includes("__") || code.includes('f"') || code.includes("f'") || code.includes("raise ") ? "python" : "node");
-        try {
-          const command = effectiveRuntime === "python" ? ["python3", "-c", code] : ["node", "-e", code];
-          const proc = await sandbox.exec(command);
-          await proc.wait();
-          const [stdoutStr, stderrStr] = await Promise.all([
-            proc.stdout.read(),
-            proc.stderr.read()
-          ]);
-          const output = stderrStr ? `${stdoutStr}${stdoutStr && stderrStr ? "\n" : ""}${stderrStr}` : stdoutStr;
-          const combinedOutput = `${stdoutStr || ""} ${stderrStr || ""}`;
-          if (proc.exitCode !== 0 && isParserFailure(combinedOutput, effectiveRuntime)) {
-            throw new Error(`Syntax error: ${(stderrStr || stdoutStr || "").trim()}`);
-          }
-          if (proc.exitCode !== 0 && !stdoutStr && !stderrStr) {
-            throw new Error(`Code execution failed with exit code ${proc.exitCode}`);
-          }
-          return {
-            output,
-            exitCode: proc.exitCode,
-            language: effectiveRuntime
-          };
-        } catch (error) {
-          if (error instanceof Error && error.message.includes("Syntax error")) {
-            throw error;
-          }
-          throw new Error(
-            `Beam execution failed: ${error instanceof Error ? error.message : String(error)}`
-          );
-        }
-      },
       /**
        * Execute a shell command in the sandbox
        *
@@ -222,7 +162,7 @@ var beam = (0, import_provider.defineProvider)({
         try {
           let fullCommand = command;
           if (options?.env && Object.keys(options.env).length > 0) {
-            const envPrefix = Object.entries(options.env).map(([k, v]) => `${k}="${(0, import_provider.escapeShellArg)(v)}"`).join(" ");
+            const envPrefix = Object.entries(options.env).map(([k, v]) => `${k}="${(0, import_provider.escapeShellArg)(String(v))}"`).join(" ");
             fullCommand = `${envPrefix} ${fullCommand}`;
           }
           if (options?.cwd) {
@@ -257,23 +197,23 @@ var beam = (0, import_provider.defineProvider)({
        */
       getInfo: async (sandbox) => {
         let runtime = "python";
-        const anySandbox = sandbox;
-        if (typeof anySandbox.runtime === "string") {
-          const lower = anySandbox.runtime.toLowerCase();
+        const runtimeHint = sandbox;
+        if (typeof runtimeHint.runtime === "string") {
+          const lower = runtimeHint.runtime.toLowerCase();
           if (lower.includes("node")) {
             runtime = "node";
           } else if (lower.includes("python")) {
             runtime = "python";
           }
-        } else if (typeof anySandbox.image === "string") {
-          const imageStr = anySandbox.image.toLowerCase();
+        } else if (typeof runtimeHint.image === "string") {
+          const imageStr = runtimeHint.image.toLowerCase();
           if (imageStr.includes("node")) {
             runtime = "node";
           } else if (imageStr.includes("python")) {
             runtime = "python";
           }
-        } else if (typeof anySandbox.imageName === "string") {
-          const imageNameStr = anySandbox.imageName.toLowerCase();
+        } else if (typeof runtimeHint.imageName === "string") {
+          const imageNameStr = runtimeHint.imageName.toLowerCase();
           if (imageNameStr.includes("node")) {
             runtime = "node";
           } else if (imageNameStr.includes("python")) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Beam Provider - Factory-based Implementation\n *\n * Containerized sandbox environments using the Beam platform.\n * Beam provides sandboxes with process management, filesystem access,\n * and port exposure capabilities.\n *\n * Features:\n * - Process execution via sandbox.exec()\n * - Code execution in Python, JavaScript\n * - Shell command execution\n * - Filesystem operations (shell-based + native listFiles)\n * - Dynamic port exposure for accessing sandbox services\n */\n\nimport { Sandbox, SandboxInstance, beamOpts, Image } from '@beamcloud/beam-js';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n} from 'computesdk';\n\n/** Type alias for the runCommand function passed to filesystem methods */\ntype RunCommandFn = (sandbox: SandboxInstance, command: string, options?: RunCommandOptions) => Promise<CommandResult>;\n\n/**\n * Beam-specific configuration options\n */\nexport interface BeamConfig {\n  /** Beam API token - if not provided, will fallback to BEAM_TOKEN environment variable */\n  token?: string;\n  /** Beam workspace ID - if not provided, will fallback to BEAM_WORKSPACE_ID environment variable */\n  workspaceId?: string;\n  /** Gateway URL for custom/staging environments */\n  gatewayUrl?: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Configure the global beamOpts singleton before each SDK call.\n * Beam uses a global config pattern rather than per-call config.\n */\nfunction configureBeamOpts(config: BeamConfig): void {\n  beamOpts.token = config.token || (typeof process !== 'undefined' && process.env?.BEAM_TOKEN) || '';\n  beamOpts.workspaceId = config.workspaceId || (typeof process !== 'undefined' && process.env?.BEAM_WORKSPACE_ID) || '';\n  if (config.gatewayUrl) {\n    beamOpts.gatewayUrl = config.gatewayUrl;\n  }\n  if (config.timeout) {\n    (beamOpts as any).timeout = config.timeout;\n  }\n}\n\n/**\n * Shell-escape a string using single quotes (POSIX).\n */\nfunction shellEscape(arg: string): string {\n  if (arg === '') return \"''\";\n  return `'${arg.replace(/'/g, \"'\\\\''\")}'`;\n}\n\n/**\n * Detect Node parser/compile failures while avoiding runtime SyntaxError matches.\n */\nfunction isNodeParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('Unexpected token') ||\n    output.includes('Unexpected identifier') ||\n    output.includes('Unexpected end of input') ||\n    output.includes('Invalid or unexpected token');\n\n  const hasCompileContext =\n    output.includes('[eval]') ||\n    output.includes('makeContextifyScript') ||\n    output.includes('compileScript') ||\n    output.includes('wrapSafe');\n\n  const hasRuntimeSyntaxSignature =\n    output.includes('at JSON.parse') ||\n    output.includes('JSON.parse (<anonymous>)') ||\n    output.includes('in JSON at position');\n\n  return hasSyntaxMarker && hasCompileContext && !hasRuntimeSyntaxSignature;\n}\n\n/**\n * Detect Python parser failures (syntax/indentation/tab) emitted by python -c.\n */\nfunction isPythonParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('IndentationError') ||\n    output.includes('TabError');\n\n  const hasStringFileContext = output.includes('File \"<string>\"');\n  const hasRuntimeTraceback = output.includes('Traceback (most recent call last)');\n\n  return hasSyntaxMarker && hasStringFileContext && !hasRuntimeTraceback;\n}\n\n/**\n * Detect parser/compile failures that should throw instead of returning CodeResult.\n */\nfunction isParserFailure(output: string, runtime: Runtime): boolean {\n  if (!output.trim()) return false;\n\n  if (runtime === 'node') {\n    return isNodeParserFailure(output);\n  }\n\n  if (runtime === 'python') {\n    return isPythonParserFailure(output);\n  }\n\n  return false;\n}\n\n/**\n * Create a Beam provider instance using the factory pattern\n *\n * Beam provides containerized sandbox environments with:\n * - Process management (exec, runCode)\n * - Filesystem access\n * - Dynamic port exposure\n * - Snapshot and image creation capabilities\n */\nexport const beam = defineProvider<SandboxInstance, BeamConfig>({\n  name: 'beam',\n  methods: {\n    sandbox: {\n      /**\n       * Create a new Beam sandbox\n       *\n       * Uses Sandbox class from @beamcloud/beam-js to provision a container.\n       */\n      create: async (config: BeamConfig, options?: CreateSandboxOptions) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          throw new Error(\n            `Missing Beam token. Provide 'token' in config or set BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n          );\n        }\n\n        if (!beamOpts.workspaceId) {\n          throw new Error(\n            `Missing Beam workspace ID. Provide 'workspaceId' in config or set BEAM_WORKSPACE_ID environment variable.`\n          );\n        }\n        try {\n          if (options?.sandboxId) {\n            const instance = await Sandbox.connect(options.sandboxId);\n            return { sandbox: instance, sandboxId: instance.containerId };\n          }\n\n          // Destructure known ComputeSDK fields, collect the rest for passthrough\n          const {\n            runtime: optRuntime,\n            timeout: optTimeout,\n            envs,\n            name,\n            metadata: _metadata,\n            templateId: _templateId,\n            snapshotId: _snapshotId,\n            sandboxId: _sandboxId,\n            namespace: _namespace,\n            directory: _directory,\n            overlays: _overlays,\n            servers: _servers,\n            ...providerOptions\n          } = options || {};\n\n          const sandboxConfig: any = {\n            name: name || `computesdk-${Date.now()}`,\n            keepWarmSeconds: 300,\n            ...providerOptions, // Spread provider-specific options\n          };\n\n          // options.timeout takes precedence over config.timeout\n          const timeout = optTimeout ?? config.timeout;\n          if (timeout) {\n            sandboxConfig.keepWarmSeconds = Math.ceil(timeout / 1000);\n          }\n\n          if (optRuntime === 'node') {\n            sandboxConfig.image = Image.fromRegistry('node:20-slim');\n          }\n\n          if (envs) {\n            sandboxConfig.envVars = Object.entries(envs).map(([name, value]) => `${name}=${value}`);\n          }\n\n          const sandbox = new Sandbox(sandboxConfig);\n          const instance = await sandbox.create();\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch (error) {\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('401')) {\n              throw new Error(\n                `Beam authentication failed. Please check your BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create Beam sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Connect to an existing Beam sandbox by ID\n       *\n       * Uses Sandbox.connect() to reconnect to a running sandbox.\n       */\n      getById: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return null;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch {\n          return null;\n        }\n      },\n\n      /**\n       * List all active Beam sandboxes\n       *\n       * Beam SDK has no sandbox list API; returns empty array.\n       */\n      list: async (_config: BeamConfig) => {\n        return [];\n      },\n\n      /**\n       * Destroy a Beam sandbox\n       *\n       * Connects to the sandbox and terminates it.\n       */\n      destroy: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          await instance.terminate();\n        } catch {\n          // Sandbox might already be destroyed\n        }\n      },\n\n      /**\n       * Execute code in the sandbox\n       *\n       * Auto-detects runtime (Python vs Node.js) and executes via sandbox.exec().\n       */\n      runCode: async (sandbox: SandboxInstance, code: string, runtime?: Runtime): Promise<CodeResult> => {\n        const effectiveRuntime = runtime || (\n          code.includes('print(') ||\n          code.includes('import ') ||\n          code.includes('def ') ||\n          code.includes('sys.') ||\n          code.includes('json.') ||\n          code.includes('__') ||\n          code.includes('f\"') ||\n          code.includes(\"f'\") ||\n          code.includes('raise ')\n            ? 'python'\n            : 'node'\n        );\n\n        try {\n          const command = effectiveRuntime === 'python'\n            ? ['python3', '-c', code]\n            : ['node', '-e', code];\n\n          const proc = await sandbox.exec(command);\n          await proc.wait();\n          const [stdoutStr, stderrStr] = await Promise.all([\n            proc.stdout.read(),\n            proc.stderr.read(),\n          ]);\n\n          const output = stderrStr\n            ? `${stdoutStr}${stdoutStr && stderrStr ? '\\n' : ''}${stderrStr}`\n            : stdoutStr;\n\n          const combinedOutput = `${stdoutStr || ''} ${stderrStr || ''}`;\n\n          if (proc.exitCode !== 0 && isParserFailure(combinedOutput, effectiveRuntime)) {\n            throw new Error(`Syntax error: ${(stderrStr || stdoutStr || '').trim()}`);\n          }\n\n          if (proc.exitCode !== 0 && !stdoutStr && !stderrStr) {\n            throw new Error(`Code execution failed with exit code ${proc.exitCode}`);\n          }\n\n          return {\n            output,\n            exitCode: proc.exitCode,\n            language: effectiveRuntime,\n          };\n        } catch (error) {\n          if (error instanceof Error && error.message.includes('Syntax error')) {\n            throw error;\n          }\n          throw new Error(\n            `Beam execution failed: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Execute a shell command in the sandbox\n       *\n       * Uses sandbox.exec() with shell command string.\n       */\n      runCommand: async (sandbox: SandboxInstance, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          let fullCommand = command;\n\n          if (options?.env && Object.keys(options.env).length > 0) {\n            const envPrefix = Object.entries(options.env)\n              .map(([k, v]: [string, string]) => `${k}=\"${escapeShellArg(v)}\"`)\n              .join(' ');\n            fullCommand = `${envPrefix} ${fullCommand}`;\n          }\n\n          if (options?.cwd) {\n            fullCommand = `cd \"${escapeShellArg(options.cwd)}\" && ${fullCommand}`;\n          }\n\n          if (options?.background) {\n            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n          }\n\n          // Wrap in sh -c to get shell parsing (pipes, redirects, etc.)\n          const proc = await sandbox.exec(['sh', '-c', fullCommand]);\n          await proc.wait();\n          const [stdoutStr, stderrStr] = await Promise.all([\n            proc.stdout.read(),\n            proc.stderr.read(),\n          ]);\n\n          return {\n            stdout: stdoutStr || '',\n            stderr: stderrStr || '',\n            exitCode: proc.exitCode || 0,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      /**\n       * Get sandbox information\n       */\n      getInfo: async (sandbox: SandboxInstance): Promise<SandboxInfo> => {\n        // Derive runtime from sandbox instance if available; otherwise default to 'python'\n        let runtime: Runtime = 'python';\n        const anySandbox = sandbox as any;\n\n        if (typeof anySandbox.runtime === 'string') {\n          const lower = anySandbox.runtime.toLowerCase();\n          if (lower.includes('node')) {\n            runtime = 'node';\n          } else if (lower.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof anySandbox.image === 'string') {\n          const imageStr = anySandbox.image.toLowerCase();\n          if (imageStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageStr.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof anySandbox.imageName === 'string') {\n          const imageNameStr = anySandbox.imageName.toLowerCase();\n          if (imageNameStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageNameStr.includes('python')) {\n            runtime = 'python';\n          }\n        }\n\n        return {\n          id: sandbox.containerId,\n          provider: 'beam',\n          runtime,\n          status: 'running',\n          createdAt: new Date(),\n          timeout: 300000,\n          metadata: {\n            containerId: sandbox.containerId,\n          },\n        };\n      },\n\n      /**\n       * Get public URL for a specific port\n       *\n       * Uses sandbox.exposePort() to dynamically expose a port.\n       */\n      getUrl: async (sandbox: SandboxInstance, options: { port: number; protocol?: string }): Promise<string> => {\n        try {\n          return await sandbox.exposePort(options.port);\n        } catch (error) {\n          throw new Error(\n            `Failed to get Beam URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Filesystem operations\n       *\n       * Most operations use shell commands via runCommand since Beam's file API\n       * is local-path oriented (uploadFile/downloadFile require local filesystem paths).\n       * readdir uses the native listFiles API since it returns structured data.\n       */\n      filesystem: {\n        readFile: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<string> => {\n          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to read file ${path}: ${result.stderr}`);\n          }\n          return result.stdout;\n        },\n\n        writeFile: async (sandbox: SandboxInstance, path: string, content: string, runCommand: RunCommandFn): Promise<void> => {\n          const b64 = Buffer.from(content).toString('base64');\n          const result = await runCommand(sandbox, `echo '${b64}' | base64 -d > ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to write file ${path}: ${result.stderr}`);\n          }\n        },\n\n        mkdir: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n          }\n        },\n\n        readdir: async (sandbox: SandboxInstance, path: string, _runCommand: RunCommandFn): Promise<FileEntry[]> => {\n          const files = await sandbox.fs.listFiles(path);\n          return files.map((file: any) => ({\n            name: file.name,\n            type: file.isDir ? 'directory' as const : 'file' as const,\n            size: Number(file.size) || 0,\n            modified: file.modTime ? new Date(file.modTime * 1000) : new Date(),\n          }));\n        },\n\n        exists: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<boolean> => {\n          const result = await runCommand(sandbox, `test -f ${shellEscape(path)} || test -d ${shellEscape(path)}`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n          }\n        },\n      },\n\n      /**\n       * Get the native SandboxInstance for advanced usage\n       */\n      getInstance: (sandbox: SandboxInstance): SandboxInstance => {\n        return sandbox;\n      },\n    },\n  },\n});\n\n// Export Beam sandbox type for explicit typing\nexport type { SandboxInstance as BeamSandboxInstance } from '@beamcloud/beam-js';\n"],"mappings":"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","names":["instance","name"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Beam Provider - Factory-based Implementation\n *\n * Containerized sandbox environments using the Beam platform.\n * Beam provides sandboxes with process management, filesystem access,\n * and port exposure capabilities.\n *\n * Features:\n * - Process execution via sandbox.exec()\n * - Code execution in Python, JavaScript\n * - Shell command execution\n * - Filesystem operations (shell-based + native listFiles)\n * - Dynamic port exposure for accessing sandbox services\n */\n\nimport { Sandbox, SandboxInstance, beamOpts, Image } from '@beamcloud/beam-js';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n} from 'computesdk';\n\n/** Type alias for the runCommand function passed to filesystem methods */\ntype RunCommandFn = (sandbox: SandboxInstance, command: string, options?: RunCommandOptions) => Promise<CommandResult>;\n\n/**\n * Beam-specific configuration options\n */\nexport interface BeamConfig {\n  /** Beam API token - if not provided, will fallback to BEAM_TOKEN environment variable */\n  token?: string;\n  /** Beam workspace ID - if not provided, will fallback to BEAM_WORKSPACE_ID environment variable */\n  workspaceId?: string;\n  /** Gateway URL for custom/staging environments */\n  gatewayUrl?: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Configure the global beamOpts singleton before each SDK call.\n * Beam uses a global config pattern rather than per-call config.\n */\nfunction configureBeamOpts(config: BeamConfig): void {\n  beamOpts.token = config.token || (typeof process !== 'undefined' && process.env?.BEAM_TOKEN) || '';\n  beamOpts.workspaceId = config.workspaceId || (typeof process !== 'undefined' && process.env?.BEAM_WORKSPACE_ID) || '';\n  if (config.gatewayUrl) {\n    beamOpts.gatewayUrl = config.gatewayUrl;\n  }\n  if (config.timeout) {\n    (beamOpts as any).timeout = config.timeout;\n  }\n}\n\n/**\n * Shell-escape a string using single quotes (POSIX).\n */\nfunction shellEscape(arg: string): string {\n  if (arg === '') return \"''\";\n  return `'${arg.replace(/'/g, \"'\\\\''\")}'`;\n}\n\n/**\n * Detect Node parser/compile failures while avoiding runtime SyntaxError matches.\n */\nfunction isNodeParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('Unexpected token') ||\n    output.includes('Unexpected identifier') ||\n    output.includes('Unexpected end of input') ||\n    output.includes('Invalid or unexpected token');\n\n  const hasCompileContext =\n    output.includes('[eval]') ||\n    output.includes('makeContextifyScript') ||\n    output.includes('compileScript') ||\n    output.includes('wrapSafe');\n\n  const hasRuntimeSyntaxSignature =\n    output.includes('at JSON.parse') ||\n    output.includes('JSON.parse (<anonymous>)') ||\n    output.includes('in JSON at position');\n\n  return hasSyntaxMarker && hasCompileContext && !hasRuntimeSyntaxSignature;\n}\n\n/**\n * Detect Python parser failures (syntax/indentation/tab) emitted by python -c.\n */\nfunction isPythonParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('IndentationError') ||\n    output.includes('TabError');\n\n  const hasStringFileContext = output.includes('File \"<string>\"');\n  const hasRuntimeTraceback = output.includes('Traceback (most recent call last)');\n\n  return hasSyntaxMarker && hasStringFileContext && !hasRuntimeTraceback;\n}\n\n/**\n * Detect parser/compile failures that should throw instead of returning CodeResult.\n */\nfunction isParserFailure(output: string, runtime: Runtime): boolean {\n  if (!output.trim()) return false;\n\n  if (runtime === 'node') {\n    return isNodeParserFailure(output);\n  }\n\n  if (runtime === 'python') {\n    return isPythonParserFailure(output);\n  }\n\n  return false;\n}\n\n/**\n * Create a Beam provider instance using the factory pattern\n *\n * Beam provides containerized sandbox environments with:\n * - Process management (exec, runCode)\n * - Filesystem access\n * - Dynamic port exposure\n * - Snapshot and image creation capabilities\n */\nexport const beam = defineProvider<SandboxInstance, BeamConfig>({\n  name: 'beam',\n  methods: {\n    sandbox: {\n      /**\n       * Create a new Beam sandbox\n       *\n       * Uses Sandbox class from @beamcloud/beam-js to provision a container.\n       */\n      create: async (config: BeamConfig, options?: CreateSandboxOptions) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          throw new Error(\n            `Missing Beam token. Provide 'token' in config or set BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n          );\n        }\n\n        if (!beamOpts.workspaceId) {\n          throw new Error(\n            `Missing Beam workspace ID. Provide 'workspaceId' in config or set BEAM_WORKSPACE_ID environment variable.`\n          );\n        }\n\n        try {\n          // Destructure known ComputeSDK fields, collect the rest for passthrough\n          const {\n            runtime: optRuntime,\n            timeout: optTimeout,\n            envs,\n            name,\n            metadata: _metadata,\n            templateId: _templateId,\n            snapshotId: _snapshotId,\n            sandboxId: _sandboxId,\n            namespace: _namespace,\n            directory: _directory,\n            ...providerOptions\n          } = options || {};\n\n          const sandboxConfig: any = {\n            name: name || `computesdk-${Date.now()}`,\n            keepWarmSeconds: 300,\n            ...providerOptions, // Spread provider-specific options\n          };\n\n          // options.timeout takes precedence over config.timeout\n          const timeout = optTimeout ?? config.timeout;\n          if (timeout) {\n            sandboxConfig.keepWarmSeconds = Math.ceil(timeout / 1000);\n          }\n\n          if (optRuntime === 'node') {\n            sandboxConfig.image = Image.fromRegistry('node:20-slim');\n          }\n\n          if (envs) {\n            sandboxConfig.envVars = Object.entries(envs).map(([name, value]) => `${name}=${value}`);\n          }\n\n          const sandbox = new Sandbox(sandboxConfig);\n          const instance = await sandbox.create();\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch (error) {\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('401')) {\n              throw new Error(\n                `Beam authentication failed. Please check your BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create Beam sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Connect to an existing Beam sandbox by ID\n       *\n       * Uses Sandbox.connect() to reconnect to a running sandbox.\n       */\n      getById: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return null;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch {\n          return null;\n        }\n      },\n\n      /**\n       * List all active Beam sandboxes\n       *\n       * Beam SDK has no sandbox list API; returns empty array.\n       */\n      list: async (_config: BeamConfig) => {\n        return [];\n      },\n\n      /**\n       * Destroy a Beam sandbox\n       *\n       * Connects to the sandbox and terminates it.\n       */\n      destroy: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          await instance.terminate();\n        } catch {\n          // Sandbox might already be destroyed\n        }\n      },\n\n      /**\n       * Execute code in the sandbox\n       *\n       * Auto-detects runtime (Python vs Node.js) and executes via sandbox.exec().\n       */\n\n      /**\n       * Execute a shell command in the sandbox\n       *\n       * Uses sandbox.exec() with shell command string.\n       */\n      runCommand: async (sandbox: SandboxInstance, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          let fullCommand = command;\n\n          if (options?.env && Object.keys(options.env).length > 0) {\n            const envPrefix = Object.entries(options.env)\n              .map(([k, v]) => `${k}=\"${escapeShellArg(String(v))}\"`)\n              .join(' ');\n            fullCommand = `${envPrefix} ${fullCommand}`;\n          }\n\n          if (options?.cwd) {\n            fullCommand = `cd \"${escapeShellArg(options.cwd)}\" && ${fullCommand}`;\n          }\n\n          if (options?.background) {\n            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n          }\n\n          // Wrap in sh -c to get shell parsing (pipes, redirects, etc.)\n          const proc = await sandbox.exec(['sh', '-c', fullCommand]);\n          await proc.wait();\n          const [stdoutStr, stderrStr] = await Promise.all([\n            proc.stdout.read(),\n            proc.stderr.read(),\n          ]);\n\n          return {\n            stdout: stdoutStr || '',\n            stderr: stderrStr || '',\n            exitCode: proc.exitCode || 0,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      /**\n       * Get sandbox information\n       */\n      getInfo: async (sandbox: SandboxInstance): Promise<SandboxInfo> => {\n        // Derive runtime from sandbox instance if available; otherwise default to 'python'\n        let runtime: Runtime = 'python';\n        const runtimeHint = sandbox as SandboxInstance & {\n          runtime?: unknown;\n          image?: unknown;\n          imageName?: unknown;\n        };\n\n        if (typeof runtimeHint.runtime === 'string') {\n          const lower = runtimeHint.runtime.toLowerCase();\n          if (lower.includes('node')) {\n            runtime = 'node';\n          } else if (lower.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof runtimeHint.image === 'string') {\n          const imageStr = runtimeHint.image.toLowerCase();\n          if (imageStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageStr.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof runtimeHint.imageName === 'string') {\n          const imageNameStr = runtimeHint.imageName.toLowerCase();\n          if (imageNameStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageNameStr.includes('python')) {\n            runtime = 'python';\n          }\n        }\n\n        return {\n          id: sandbox.containerId,\n          provider: 'beam',\n          runtime,\n          status: 'running',\n          createdAt: new Date(),\n          timeout: 300000,\n          metadata: {\n            containerId: sandbox.containerId,\n          },\n        };\n      },\n\n      /**\n       * Get public URL for a specific port\n       *\n       * Uses sandbox.exposePort() to dynamically expose a port.\n       */\n      getUrl: async (sandbox: SandboxInstance, options: { port: number; protocol?: string }): Promise<string> => {\n        try {\n          return await sandbox.exposePort(options.port);\n        } catch (error) {\n          throw new Error(\n            `Failed to get Beam URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Filesystem operations\n       *\n       * Most operations use shell commands via runCommand since Beam's file API\n       * is local-path oriented (uploadFile/downloadFile require local filesystem paths).\n       * readdir uses the native listFiles API since it returns structured data.\n       */\n      filesystem: {\n        readFile: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<string> => {\n          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to read file ${path}: ${result.stderr}`);\n          }\n          return result.stdout;\n        },\n\n        writeFile: async (sandbox: SandboxInstance, path: string, content: string, runCommand: RunCommandFn): Promise<void> => {\n          const b64 = Buffer.from(content).toString('base64');\n          const result = await runCommand(sandbox, `echo '${b64}' | base64 -d > ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to write file ${path}: ${result.stderr}`);\n          }\n        },\n\n        mkdir: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n          }\n        },\n\n        readdir: async (sandbox: SandboxInstance, path: string, _runCommand: RunCommandFn): Promise<FileEntry[]> => {\n          const files = await sandbox.fs.listFiles(path);\n          return files.map((file: any) => ({\n            name: file.name,\n            type: file.isDir ? 'directory' as const : 'file' as const,\n            size: Number(file.size) || 0,\n            modified: file.modTime ? new Date(file.modTime * 1000) : new Date(),\n          }));\n        },\n\n        exists: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<boolean> => {\n          const result = await runCommand(sandbox, `test -f ${shellEscape(path)} || test -d ${shellEscape(path)}`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n          }\n        },\n      },\n\n      /**\n       * Get the native SandboxInstance for advanced usage\n       */\n      getInstance: (sandbox: SandboxInstance): SandboxInstance => {\n        return sandbox;\n      },\n    },\n  },\n});\n\n// Export Beam sandbox type for explicit typing\nexport type { SandboxInstance as BeamSandboxInstance } from '@beamcloud/beam-js';\n"],"mappings":"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","names":["name"]}

package/dist/index.mjs

@@ -15,28 +15,6 @@ function shellEscape(arg) {
   if (arg === "") return "''";
   return `'${arg.replace(/'/g, "'\\''")}'`;
 }
-function isNodeParserFailure(output) {
-  const hasSyntaxMarker = output.includes("SyntaxError") || output.includes("Unexpected token") || output.includes("Unexpected identifier") || output.includes("Unexpected end of input") || output.includes("Invalid or unexpected token");
-  const hasCompileContext = output.includes("[eval]") || output.includes("makeContextifyScript") || output.includes("compileScript") || output.includes("wrapSafe");
-  const hasRuntimeSyntaxSignature = output.includes("at JSON.parse") || output.includes("JSON.parse (<anonymous>)") || output.includes("in JSON at position");
-  return hasSyntaxMarker && hasCompileContext && !hasRuntimeSyntaxSignature;
-}
-function isPythonParserFailure(output) {
-  const hasSyntaxMarker = output.includes("SyntaxError") || output.includes("IndentationError") || output.includes("TabError");
-  const hasStringFileContext = output.includes('File "<string>"');
-  const hasRuntimeTraceback = output.includes("Traceback (most recent call last)");
-  return hasSyntaxMarker && hasStringFileContext && !hasRuntimeTraceback;
-}
-function isParserFailure(output, runtime) {
-  if (!output.trim()) return false;
-  if (runtime === "node") {
-    return isNodeParserFailure(output);
-  }
-  if (runtime === "python") {
-    return isPythonParserFailure(output);
-  }
-  return false;
-}
 var beam = defineProvider({
   name: "beam",
   methods: {
@@ -59,10 +37,6 @@ var beam = defineProvider({
           );
         }
         try {
-          if (options?.sandboxId) {
-            const instance2 = await Sandbox.connect(options.sandboxId);
-            return { sandbox: instance2, sandboxId: instance2.containerId };
-          }
           const {
             runtime: optRuntime,
             timeout: optTimeout,
@@ -74,8 +48,6 @@ var beam = defineProvider({
             sandboxId: _sandboxId,
             namespace: _namespace,
             directory: _directory,
-            overlays: _overlays,
-            servers: _servers,
             ...providerOptions
           } = options || {};
           const sandboxConfig = {
@@ -156,38 +128,6 @@ var beam = defineProvider({
        *
        * Auto-detects runtime (Python vs Node.js) and executes via sandbox.exec().
        */
-      runCode: async (sandbox, code, runtime) => {
-        const effectiveRuntime = runtime || (code.includes("print(") || code.includes("import ") || code.includes("def ") || code.includes("sys.") || code.includes("json.") || code.includes("__") || code.includes('f"') || code.includes("f'") || code.includes("raise ") ? "python" : "node");
-        try {
-          const command = effectiveRuntime === "python" ? ["python3", "-c", code] : ["node", "-e", code];
-          const proc = await sandbox.exec(command);
-          await proc.wait();
-          const [stdoutStr, stderrStr] = await Promise.all([
-            proc.stdout.read(),
-            proc.stderr.read()
-          ]);
-          const output = stderrStr ? `${stdoutStr}${stdoutStr && stderrStr ? "\n" : ""}${stderrStr}` : stdoutStr;
-          const combinedOutput = `${stdoutStr || ""} ${stderrStr || ""}`;
-          if (proc.exitCode !== 0 && isParserFailure(combinedOutput, effectiveRuntime)) {
-            throw new Error(`Syntax error: ${(stderrStr || stdoutStr || "").trim()}`);
-          }
-          if (proc.exitCode !== 0 && !stdoutStr && !stderrStr) {
-            throw new Error(`Code execution failed with exit code ${proc.exitCode}`);
-          }
-          return {
-            output,
-            exitCode: proc.exitCode,
-            language: effectiveRuntime
-          };
-        } catch (error) {
-          if (error instanceof Error && error.message.includes("Syntax error")) {
-            throw error;
-          }
-          throw new Error(
-            `Beam execution failed: ${error instanceof Error ? error.message : String(error)}`
-          );
-        }
-      },
       /**
        * Execute a shell command in the sandbox
        *
@@ -198,7 +138,7 @@ var beam = defineProvider({
         try {
           let fullCommand = command;
           if (options?.env && Object.keys(options.env).length > 0) {
-            const envPrefix = Object.entries(options.env).map(([k, v]) => `${k}="${escapeShellArg(v)}"`).join(" ");
+            const envPrefix = Object.entries(options.env).map(([k, v]) => `${k}="${escapeShellArg(String(v))}"`).join(" ");
             fullCommand = `${envPrefix} ${fullCommand}`;
           }
           if (options?.cwd) {
@@ -233,23 +173,23 @@ var beam = defineProvider({
        */
       getInfo: async (sandbox) => {
         let runtime = "python";
-        const anySandbox = sandbox;
-        if (typeof anySandbox.runtime === "string") {
-          const lower = anySandbox.runtime.toLowerCase();
+        const runtimeHint = sandbox;
+        if (typeof runtimeHint.runtime === "string") {
+          const lower = runtimeHint.runtime.toLowerCase();
           if (lower.includes("node")) {
             runtime = "node";
           } else if (lower.includes("python")) {
             runtime = "python";
           }
-        } else if (typeof anySandbox.image === "string") {
-          const imageStr = anySandbox.image.toLowerCase();
+        } else if (typeof runtimeHint.image === "string") {
+          const imageStr = runtimeHint.image.toLowerCase();
           if (imageStr.includes("node")) {
             runtime = "node";
           } else if (imageStr.includes("python")) {
             runtime = "python";
           }
-        } else if (typeof anySandbox.imageName === "string") {
-          const imageNameStr = anySandbox.imageName.toLowerCase();
+        } else if (typeof runtimeHint.imageName === "string") {
+          const imageNameStr = runtimeHint.imageName.toLowerCase();
           if (imageNameStr.includes("node")) {
             runtime = "node";
           } else if (imageNameStr.includes("python")) {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Beam Provider - Factory-based Implementation\n *\n * Containerized sandbox environments using the Beam platform.\n * Beam provides sandboxes with process management, filesystem access,\n * and port exposure capabilities.\n *\n * Features:\n * - Process execution via sandbox.exec()\n * - Code execution in Python, JavaScript\n * - Shell command execution\n * - Filesystem operations (shell-based + native listFiles)\n * - Dynamic port exposure for accessing sandbox services\n */\n\nimport { Sandbox, SandboxInstance, beamOpts, Image } from '@beamcloud/beam-js';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n} from 'computesdk';\n\n/** Type alias for the runCommand function passed to filesystem methods */\ntype RunCommandFn = (sandbox: SandboxInstance, command: string, options?: RunCommandOptions) => Promise<CommandResult>;\n\n/**\n * Beam-specific configuration options\n */\nexport interface BeamConfig {\n  /** Beam API token - if not provided, will fallback to BEAM_TOKEN environment variable */\n  token?: string;\n  /** Beam workspace ID - if not provided, will fallback to BEAM_WORKSPACE_ID environment variable */\n  workspaceId?: string;\n  /** Gateway URL for custom/staging environments */\n  gatewayUrl?: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Configure the global beamOpts singleton before each SDK call.\n * Beam uses a global config pattern rather than per-call config.\n */\nfunction configureBeamOpts(config: BeamConfig): void {\n  beamOpts.token = config.token || (typeof process !== 'undefined' && process.env?.BEAM_TOKEN) || '';\n  beamOpts.workspaceId = config.workspaceId || (typeof process !== 'undefined' && process.env?.BEAM_WORKSPACE_ID) || '';\n  if (config.gatewayUrl) {\n    beamOpts.gatewayUrl = config.gatewayUrl;\n  }\n  if (config.timeout) {\n    (beamOpts as any).timeout = config.timeout;\n  }\n}\n\n/**\n * Shell-escape a string using single quotes (POSIX).\n */\nfunction shellEscape(arg: string): string {\n  if (arg === '') return \"''\";\n  return `'${arg.replace(/'/g, \"'\\\\''\")}'`;\n}\n\n/**\n * Detect Node parser/compile failures while avoiding runtime SyntaxError matches.\n */\nfunction isNodeParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('Unexpected token') ||\n    output.includes('Unexpected identifier') ||\n    output.includes('Unexpected end of input') ||\n    output.includes('Invalid or unexpected token');\n\n  const hasCompileContext =\n    output.includes('[eval]') ||\n    output.includes('makeContextifyScript') ||\n    output.includes('compileScript') ||\n    output.includes('wrapSafe');\n\n  const hasRuntimeSyntaxSignature =\n    output.includes('at JSON.parse') ||\n    output.includes('JSON.parse (<anonymous>)') ||\n    output.includes('in JSON at position');\n\n  return hasSyntaxMarker && hasCompileContext && !hasRuntimeSyntaxSignature;\n}\n\n/**\n * Detect Python parser failures (syntax/indentation/tab) emitted by python -c.\n */\nfunction isPythonParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('IndentationError') ||\n    output.includes('TabError');\n\n  const hasStringFileContext = output.includes('File \"<string>\"');\n  const hasRuntimeTraceback = output.includes('Traceback (most recent call last)');\n\n  return hasSyntaxMarker && hasStringFileContext && !hasRuntimeTraceback;\n}\n\n/**\n * Detect parser/compile failures that should throw instead of returning CodeResult.\n */\nfunction isParserFailure(output: string, runtime: Runtime): boolean {\n  if (!output.trim()) return false;\n\n  if (runtime === 'node') {\n    return isNodeParserFailure(output);\n  }\n\n  if (runtime === 'python') {\n    return isPythonParserFailure(output);\n  }\n\n  return false;\n}\n\n/**\n * Create a Beam provider instance using the factory pattern\n *\n * Beam provides containerized sandbox environments with:\n * - Process management (exec, runCode)\n * - Filesystem access\n * - Dynamic port exposure\n * - Snapshot and image creation capabilities\n */\nexport const beam = defineProvider<SandboxInstance, BeamConfig>({\n  name: 'beam',\n  methods: {\n    sandbox: {\n      /**\n       * Create a new Beam sandbox\n       *\n       * Uses Sandbox class from @beamcloud/beam-js to provision a container.\n       */\n      create: async (config: BeamConfig, options?: CreateSandboxOptions) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          throw new Error(\n            `Missing Beam token. Provide 'token' in config or set BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n          );\n        }\n\n        if (!beamOpts.workspaceId) {\n          throw new Error(\n            `Missing Beam workspace ID. Provide 'workspaceId' in config or set BEAM_WORKSPACE_ID environment variable.`\n          );\n        }\n        try {\n          if (options?.sandboxId) {\n            const instance = await Sandbox.connect(options.sandboxId);\n            return { sandbox: instance, sandboxId: instance.containerId };\n          }\n\n          // Destructure known ComputeSDK fields, collect the rest for passthrough\n          const {\n            runtime: optRuntime,\n            timeout: optTimeout,\n            envs,\n            name,\n            metadata: _metadata,\n            templateId: _templateId,\n            snapshotId: _snapshotId,\n            sandboxId: _sandboxId,\n            namespace: _namespace,\n            directory: _directory,\n            overlays: _overlays,\n            servers: _servers,\n            ...providerOptions\n          } = options || {};\n\n          const sandboxConfig: any = {\n            name: name || `computesdk-${Date.now()}`,\n            keepWarmSeconds: 300,\n            ...providerOptions, // Spread provider-specific options\n          };\n\n          // options.timeout takes precedence over config.timeout\n          const timeout = optTimeout ?? config.timeout;\n          if (timeout) {\n            sandboxConfig.keepWarmSeconds = Math.ceil(timeout / 1000);\n          }\n\n          if (optRuntime === 'node') {\n            sandboxConfig.image = Image.fromRegistry('node:20-slim');\n          }\n\n          if (envs) {\n            sandboxConfig.envVars = Object.entries(envs).map(([name, value]) => `${name}=${value}`);\n          }\n\n          const sandbox = new Sandbox(sandboxConfig);\n          const instance = await sandbox.create();\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch (error) {\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('401')) {\n              throw new Error(\n                `Beam authentication failed. Please check your BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create Beam sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Connect to an existing Beam sandbox by ID\n       *\n       * Uses Sandbox.connect() to reconnect to a running sandbox.\n       */\n      getById: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return null;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch {\n          return null;\n        }\n      },\n\n      /**\n       * List all active Beam sandboxes\n       *\n       * Beam SDK has no sandbox list API; returns empty array.\n       */\n      list: async (_config: BeamConfig) => {\n        return [];\n      },\n\n      /**\n       * Destroy a Beam sandbox\n       *\n       * Connects to the sandbox and terminates it.\n       */\n      destroy: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          await instance.terminate();\n        } catch {\n          // Sandbox might already be destroyed\n        }\n      },\n\n      /**\n       * Execute code in the sandbox\n       *\n       * Auto-detects runtime (Python vs Node.js) and executes via sandbox.exec().\n       */\n      runCode: async (sandbox: SandboxInstance, code: string, runtime?: Runtime): Promise<CodeResult> => {\n        const effectiveRuntime = runtime || (\n          code.includes('print(') ||\n          code.includes('import ') ||\n          code.includes('def ') ||\n          code.includes('sys.') ||\n          code.includes('json.') ||\n          code.includes('__') ||\n          code.includes('f\"') ||\n          code.includes(\"f'\") ||\n          code.includes('raise ')\n            ? 'python'\n            : 'node'\n        );\n\n        try {\n          const command = effectiveRuntime === 'python'\n            ? ['python3', '-c', code]\n            : ['node', '-e', code];\n\n          const proc = await sandbox.exec(command);\n          await proc.wait();\n          const [stdoutStr, stderrStr] = await Promise.all([\n            proc.stdout.read(),\n            proc.stderr.read(),\n          ]);\n\n          const output = stderrStr\n            ? `${stdoutStr}${stdoutStr && stderrStr ? '\\n' : ''}${stderrStr}`\n            : stdoutStr;\n\n          const combinedOutput = `${stdoutStr || ''} ${stderrStr || ''}`;\n\n          if (proc.exitCode !== 0 && isParserFailure(combinedOutput, effectiveRuntime)) {\n            throw new Error(`Syntax error: ${(stderrStr || stdoutStr || '').trim()}`);\n          }\n\n          if (proc.exitCode !== 0 && !stdoutStr && !stderrStr) {\n            throw new Error(`Code execution failed with exit code ${proc.exitCode}`);\n          }\n\n          return {\n            output,\n            exitCode: proc.exitCode,\n            language: effectiveRuntime,\n          };\n        } catch (error) {\n          if (error instanceof Error && error.message.includes('Syntax error')) {\n            throw error;\n          }\n          throw new Error(\n            `Beam execution failed: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Execute a shell command in the sandbox\n       *\n       * Uses sandbox.exec() with shell command string.\n       */\n      runCommand: async (sandbox: SandboxInstance, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          let fullCommand = command;\n\n          if (options?.env && Object.keys(options.env).length > 0) {\n            const envPrefix = Object.entries(options.env)\n              .map(([k, v]: [string, string]) => `${k}=\"${escapeShellArg(v)}\"`)\n              .join(' ');\n            fullCommand = `${envPrefix} ${fullCommand}`;\n          }\n\n          if (options?.cwd) {\n            fullCommand = `cd \"${escapeShellArg(options.cwd)}\" && ${fullCommand}`;\n          }\n\n          if (options?.background) {\n            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n          }\n\n          // Wrap in sh -c to get shell parsing (pipes, redirects, etc.)\n          const proc = await sandbox.exec(['sh', '-c', fullCommand]);\n          await proc.wait();\n          const [stdoutStr, stderrStr] = await Promise.all([\n            proc.stdout.read(),\n            proc.stderr.read(),\n          ]);\n\n          return {\n            stdout: stdoutStr || '',\n            stderr: stderrStr || '',\n            exitCode: proc.exitCode || 0,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      /**\n       * Get sandbox information\n       */\n      getInfo: async (sandbox: SandboxInstance): Promise<SandboxInfo> => {\n        // Derive runtime from sandbox instance if available; otherwise default to 'python'\n        let runtime: Runtime = 'python';\n        const anySandbox = sandbox as any;\n\n        if (typeof anySandbox.runtime === 'string') {\n          const lower = anySandbox.runtime.toLowerCase();\n          if (lower.includes('node')) {\n            runtime = 'node';\n          } else if (lower.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof anySandbox.image === 'string') {\n          const imageStr = anySandbox.image.toLowerCase();\n          if (imageStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageStr.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof anySandbox.imageName === 'string') {\n          const imageNameStr = anySandbox.imageName.toLowerCase();\n          if (imageNameStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageNameStr.includes('python')) {\n            runtime = 'python';\n          }\n        }\n\n        return {\n          id: sandbox.containerId,\n          provider: 'beam',\n          runtime,\n          status: 'running',\n          createdAt: new Date(),\n          timeout: 300000,\n          metadata: {\n            containerId: sandbox.containerId,\n          },\n        };\n      },\n\n      /**\n       * Get public URL for a specific port\n       *\n       * Uses sandbox.exposePort() to dynamically expose a port.\n       */\n      getUrl: async (sandbox: SandboxInstance, options: { port: number; protocol?: string }): Promise<string> => {\n        try {\n          return await sandbox.exposePort(options.port);\n        } catch (error) {\n          throw new Error(\n            `Failed to get Beam URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Filesystem operations\n       *\n       * Most operations use shell commands via runCommand since Beam's file API\n       * is local-path oriented (uploadFile/downloadFile require local filesystem paths).\n       * readdir uses the native listFiles API since it returns structured data.\n       */\n      filesystem: {\n        readFile: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<string> => {\n          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to read file ${path}: ${result.stderr}`);\n          }\n          return result.stdout;\n        },\n\n        writeFile: async (sandbox: SandboxInstance, path: string, content: string, runCommand: RunCommandFn): Promise<void> => {\n          const b64 = Buffer.from(content).toString('base64');\n          const result = await runCommand(sandbox, `echo '${b64}' | base64 -d > ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to write file ${path}: ${result.stderr}`);\n          }\n        },\n\n        mkdir: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n          }\n        },\n\n        readdir: async (sandbox: SandboxInstance, path: string, _runCommand: RunCommandFn): Promise<FileEntry[]> => {\n          const files = await sandbox.fs.listFiles(path);\n          return files.map((file: any) => ({\n            name: file.name,\n            type: file.isDir ? 'directory' as const : 'file' as const,\n            size: Number(file.size) || 0,\n            modified: file.modTime ? new Date(file.modTime * 1000) : new Date(),\n          }));\n        },\n\n        exists: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<boolean> => {\n          const result = await runCommand(sandbox, `test -f ${shellEscape(path)} || test -d ${shellEscape(path)}`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n          }\n        },\n      },\n\n      /**\n       * Get the native SandboxInstance for advanced usage\n       */\n      getInstance: (sandbox: SandboxInstance): SandboxInstance => {\n        return sandbox;\n      },\n    },\n  },\n});\n\n// Export Beam sandbox type for explicit typing\nexport type { SandboxInstance as BeamSandboxInstance } from '@beamcloud/beam-js';\n"],"mappings":"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","names":["instance","name"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Beam Provider - Factory-based Implementation\n *\n * Containerized sandbox environments using the Beam platform.\n * Beam provides sandboxes with process management, filesystem access,\n * and port exposure capabilities.\n *\n * Features:\n * - Process execution via sandbox.exec()\n * - Code execution in Python, JavaScript\n * - Shell command execution\n * - Filesystem operations (shell-based + native listFiles)\n * - Dynamic port exposure for accessing sandbox services\n */\n\nimport { Sandbox, SandboxInstance, beamOpts, Image } from '@beamcloud/beam-js';\nimport { defineProvider, escapeShellArg } from '@computesdk/provider';\nimport type {\n  CodeResult,\n  CommandResult,\n  SandboxInfo,\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n} from 'computesdk';\n\n/** Type alias for the runCommand function passed to filesystem methods */\ntype RunCommandFn = (sandbox: SandboxInstance, command: string, options?: RunCommandOptions) => Promise<CommandResult>;\n\n/**\n * Beam-specific configuration options\n */\nexport interface BeamConfig {\n  /** Beam API token - if not provided, will fallback to BEAM_TOKEN environment variable */\n  token?: string;\n  /** Beam workspace ID - if not provided, will fallback to BEAM_WORKSPACE_ID environment variable */\n  workspaceId?: string;\n  /** Gateway URL for custom/staging environments */\n  gatewayUrl?: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\n/**\n * Configure the global beamOpts singleton before each SDK call.\n * Beam uses a global config pattern rather than per-call config.\n */\nfunction configureBeamOpts(config: BeamConfig): void {\n  beamOpts.token = config.token || (typeof process !== 'undefined' && process.env?.BEAM_TOKEN) || '';\n  beamOpts.workspaceId = config.workspaceId || (typeof process !== 'undefined' && process.env?.BEAM_WORKSPACE_ID) || '';\n  if (config.gatewayUrl) {\n    beamOpts.gatewayUrl = config.gatewayUrl;\n  }\n  if (config.timeout) {\n    (beamOpts as any).timeout = config.timeout;\n  }\n}\n\n/**\n * Shell-escape a string using single quotes (POSIX).\n */\nfunction shellEscape(arg: string): string {\n  if (arg === '') return \"''\";\n  return `'${arg.replace(/'/g, \"'\\\\''\")}'`;\n}\n\n/**\n * Detect Node parser/compile failures while avoiding runtime SyntaxError matches.\n */\nfunction isNodeParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('Unexpected token') ||\n    output.includes('Unexpected identifier') ||\n    output.includes('Unexpected end of input') ||\n    output.includes('Invalid or unexpected token');\n\n  const hasCompileContext =\n    output.includes('[eval]') ||\n    output.includes('makeContextifyScript') ||\n    output.includes('compileScript') ||\n    output.includes('wrapSafe');\n\n  const hasRuntimeSyntaxSignature =\n    output.includes('at JSON.parse') ||\n    output.includes('JSON.parse (<anonymous>)') ||\n    output.includes('in JSON at position');\n\n  return hasSyntaxMarker && hasCompileContext && !hasRuntimeSyntaxSignature;\n}\n\n/**\n * Detect Python parser failures (syntax/indentation/tab) emitted by python -c.\n */\nfunction isPythonParserFailure(output: string): boolean {\n  const hasSyntaxMarker =\n    output.includes('SyntaxError') ||\n    output.includes('IndentationError') ||\n    output.includes('TabError');\n\n  const hasStringFileContext = output.includes('File \"<string>\"');\n  const hasRuntimeTraceback = output.includes('Traceback (most recent call last)');\n\n  return hasSyntaxMarker && hasStringFileContext && !hasRuntimeTraceback;\n}\n\n/**\n * Detect parser/compile failures that should throw instead of returning CodeResult.\n */\nfunction isParserFailure(output: string, runtime: Runtime): boolean {\n  if (!output.trim()) return false;\n\n  if (runtime === 'node') {\n    return isNodeParserFailure(output);\n  }\n\n  if (runtime === 'python') {\n    return isPythonParserFailure(output);\n  }\n\n  return false;\n}\n\n/**\n * Create a Beam provider instance using the factory pattern\n *\n * Beam provides containerized sandbox environments with:\n * - Process management (exec, runCode)\n * - Filesystem access\n * - Dynamic port exposure\n * - Snapshot and image creation capabilities\n */\nexport const beam = defineProvider<SandboxInstance, BeamConfig>({\n  name: 'beam',\n  methods: {\n    sandbox: {\n      /**\n       * Create a new Beam sandbox\n       *\n       * Uses Sandbox class from @beamcloud/beam-js to provision a container.\n       */\n      create: async (config: BeamConfig, options?: CreateSandboxOptions) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          throw new Error(\n            `Missing Beam token. Provide 'token' in config or set BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n          );\n        }\n\n        if (!beamOpts.workspaceId) {\n          throw new Error(\n            `Missing Beam workspace ID. Provide 'workspaceId' in config or set BEAM_WORKSPACE_ID environment variable.`\n          );\n        }\n\n        try {\n          // Destructure known ComputeSDK fields, collect the rest for passthrough\n          const {\n            runtime: optRuntime,\n            timeout: optTimeout,\n            envs,\n            name,\n            metadata: _metadata,\n            templateId: _templateId,\n            snapshotId: _snapshotId,\n            sandboxId: _sandboxId,\n            namespace: _namespace,\n            directory: _directory,\n            ...providerOptions\n          } = options || {};\n\n          const sandboxConfig: any = {\n            name: name || `computesdk-${Date.now()}`,\n            keepWarmSeconds: 300,\n            ...providerOptions, // Spread provider-specific options\n          };\n\n          // options.timeout takes precedence over config.timeout\n          const timeout = optTimeout ?? config.timeout;\n          if (timeout) {\n            sandboxConfig.keepWarmSeconds = Math.ceil(timeout / 1000);\n          }\n\n          if (optRuntime === 'node') {\n            sandboxConfig.image = Image.fromRegistry('node:20-slim');\n          }\n\n          if (envs) {\n            sandboxConfig.envVars = Object.entries(envs).map(([name, value]) => `${name}=${value}`);\n          }\n\n          const sandbox = new Sandbox(sandboxConfig);\n          const instance = await sandbox.create();\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch (error) {\n          if (error instanceof Error) {\n            if (error.message.includes('unauthorized') || error.message.includes('401')) {\n              throw new Error(\n                `Beam authentication failed. Please check your BEAM_TOKEN environment variable. Get your token from https://app.beam.cloud`\n              );\n            }\n          }\n          throw new Error(\n            `Failed to create Beam sandbox: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Connect to an existing Beam sandbox by ID\n       *\n       * Uses Sandbox.connect() to reconnect to a running sandbox.\n       */\n      getById: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return null;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          return { sandbox: instance, sandboxId: instance.containerId };\n        } catch {\n          return null;\n        }\n      },\n\n      /**\n       * List all active Beam sandboxes\n       *\n       * Beam SDK has no sandbox list API; returns empty array.\n       */\n      list: async (_config: BeamConfig) => {\n        return [];\n      },\n\n      /**\n       * Destroy a Beam sandbox\n       *\n       * Connects to the sandbox and terminates it.\n       */\n      destroy: async (config: BeamConfig, sandboxId: string) => {\n        configureBeamOpts(config);\n\n        if (!beamOpts.token) {\n          return;\n        }\n\n        try {\n          const instance = await Sandbox.connect(sandboxId);\n          await instance.terminate();\n        } catch {\n          // Sandbox might already be destroyed\n        }\n      },\n\n      /**\n       * Execute code in the sandbox\n       *\n       * Auto-detects runtime (Python vs Node.js) and executes via sandbox.exec().\n       */\n\n      /**\n       * Execute a shell command in the sandbox\n       *\n       * Uses sandbox.exec() with shell command string.\n       */\n      runCommand: async (sandbox: SandboxInstance, command: string, options?: RunCommandOptions): Promise<CommandResult> => {\n        const startTime = Date.now();\n        try {\n          let fullCommand = command;\n\n          if (options?.env && Object.keys(options.env).length > 0) {\n            const envPrefix = Object.entries(options.env)\n              .map(([k, v]) => `${k}=\"${escapeShellArg(String(v))}\"`)\n              .join(' ');\n            fullCommand = `${envPrefix} ${fullCommand}`;\n          }\n\n          if (options?.cwd) {\n            fullCommand = `cd \"${escapeShellArg(options.cwd)}\" && ${fullCommand}`;\n          }\n\n          if (options?.background) {\n            fullCommand = `nohup ${fullCommand} > /dev/null 2>&1 &`;\n          }\n\n          // Wrap in sh -c to get shell parsing (pipes, redirects, etc.)\n          const proc = await sandbox.exec(['sh', '-c', fullCommand]);\n          await proc.wait();\n          const [stdoutStr, stderrStr] = await Promise.all([\n            proc.stdout.read(),\n            proc.stderr.read(),\n          ]);\n\n          return {\n            stdout: stdoutStr || '',\n            stderr: stderrStr || '',\n            exitCode: proc.exitCode || 0,\n            durationMs: Date.now() - startTime,\n          };\n        } catch (error) {\n          return {\n            stdout: '',\n            stderr: error instanceof Error ? error.message : String(error),\n            exitCode: 127,\n            durationMs: Date.now() - startTime,\n          };\n        }\n      },\n\n      /**\n       * Get sandbox information\n       */\n      getInfo: async (sandbox: SandboxInstance): Promise<SandboxInfo> => {\n        // Derive runtime from sandbox instance if available; otherwise default to 'python'\n        let runtime: Runtime = 'python';\n        const runtimeHint = sandbox as SandboxInstance & {\n          runtime?: unknown;\n          image?: unknown;\n          imageName?: unknown;\n        };\n\n        if (typeof runtimeHint.runtime === 'string') {\n          const lower = runtimeHint.runtime.toLowerCase();\n          if (lower.includes('node')) {\n            runtime = 'node';\n          } else if (lower.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof runtimeHint.image === 'string') {\n          const imageStr = runtimeHint.image.toLowerCase();\n          if (imageStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageStr.includes('python')) {\n            runtime = 'python';\n          }\n        } else if (typeof runtimeHint.imageName === 'string') {\n          const imageNameStr = runtimeHint.imageName.toLowerCase();\n          if (imageNameStr.includes('node')) {\n            runtime = 'node';\n          } else if (imageNameStr.includes('python')) {\n            runtime = 'python';\n          }\n        }\n\n        return {\n          id: sandbox.containerId,\n          provider: 'beam',\n          runtime,\n          status: 'running',\n          createdAt: new Date(),\n          timeout: 300000,\n          metadata: {\n            containerId: sandbox.containerId,\n          },\n        };\n      },\n\n      /**\n       * Get public URL for a specific port\n       *\n       * Uses sandbox.exposePort() to dynamically expose a port.\n       */\n      getUrl: async (sandbox: SandboxInstance, options: { port: number; protocol?: string }): Promise<string> => {\n        try {\n          return await sandbox.exposePort(options.port);\n        } catch (error) {\n          throw new Error(\n            `Failed to get Beam URL for port ${options.port}: ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      },\n\n      /**\n       * Filesystem operations\n       *\n       * Most operations use shell commands via runCommand since Beam's file API\n       * is local-path oriented (uploadFile/downloadFile require local filesystem paths).\n       * readdir uses the native listFiles API since it returns structured data.\n       */\n      filesystem: {\n        readFile: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<string> => {\n          const result = await runCommand(sandbox, `cat ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to read file ${path}: ${result.stderr}`);\n          }\n          return result.stdout;\n        },\n\n        writeFile: async (sandbox: SandboxInstance, path: string, content: string, runCommand: RunCommandFn): Promise<void> => {\n          const b64 = Buffer.from(content).toString('base64');\n          const result = await runCommand(sandbox, `echo '${b64}' | base64 -d > ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to write file ${path}: ${result.stderr}`);\n          }\n        },\n\n        mkdir: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `mkdir -p ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to create directory ${path}: ${result.stderr}`);\n          }\n        },\n\n        readdir: async (sandbox: SandboxInstance, path: string, _runCommand: RunCommandFn): Promise<FileEntry[]> => {\n          const files = await sandbox.fs.listFiles(path);\n          return files.map((file: any) => ({\n            name: file.name,\n            type: file.isDir ? 'directory' as const : 'file' as const,\n            size: Number(file.size) || 0,\n            modified: file.modTime ? new Date(file.modTime * 1000) : new Date(),\n          }));\n        },\n\n        exists: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<boolean> => {\n          const result = await runCommand(sandbox, `test -f ${shellEscape(path)} || test -d ${shellEscape(path)}`);\n          return result.exitCode === 0;\n        },\n\n        remove: async (sandbox: SandboxInstance, path: string, runCommand: RunCommandFn): Promise<void> => {\n          const result = await runCommand(sandbox, `rm -rf ${shellEscape(path)}`);\n          if (result.exitCode !== 0) {\n            throw new Error(`Failed to remove ${path}: ${result.stderr}`);\n          }\n        },\n      },\n\n      /**\n       * Get the native SandboxInstance for advanced usage\n       */\n      getInstance: (sandbox: SandboxInstance): SandboxInstance => {\n        return sandbox;\n      },\n    },\n  },\n});\n\n// Export Beam sandbox type for explicit typing\nexport type { SandboxInstance as BeamSandboxInstance } from '@beamcloud/beam-js';\n"],"mappings":"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","names":["name"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@computesdk/beam",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Beam provider for ComputeSDK - containerized sandbox environments with process management and filesystem access",
   "author": "ComputeSDK",
   "license": "MIT",
@@ -19,8 +19,8 @@
   ],
   "dependencies": {
     "@beamcloud/beam-js": "1.0.0-rc.30",
-    "computesdk": "2.5.4",
-    "@computesdk/provider": "1.2.0"
+    "computesdk": "3.0.0",
+    "@computesdk/provider": "1.4.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",