@computesdk/provider 1.0.2 → 1.0.3

package/dist/index.d.mts

@@ -354,7 +354,7 @@ interface SandboxMethods<TSandbox = any, TConfig = any> {
     } | null>;
     extendTimeout?: (config: TConfig, sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;
     runCode: (sandbox: TSandbox, code: string, runtime?: Runtime, config?: TConfig) => Promise<CodeResult>;
-    runCommand: (sandbox: TSandbox, command: string, args?: string[], options?: RunCommandOptions) => Promise<CommandResult>;
+    runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>;
     getInfo: (sandbox: TSandbox) => Promise<SandboxInfo>;
     getUrl: (sandbox: TSandbox, options: {
         port: number;
@@ -362,12 +362,12 @@ interface SandboxMethods<TSandbox = any, TConfig = any> {
     }) => Promise<string>;
     getInstance?: (sandbox: TSandbox) => TSandbox;
     filesystem?: {
-        readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<string>;
-        writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;
-        mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;
-        readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<FileEntry[]>;
-        exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<boolean>;
-        remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;
+        readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<string>;
+        writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;
+        mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;
+        readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<FileEntry[]>;
+        exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<boolean>;
+        remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;
     };
 }
 /**
@@ -510,5 +510,26 @@ declare function createCompute<TInstance = any>(config: CreateComputeConfig<TIns
  * ```
  */
 declare function calculateBackoff(attempt: number, baseDelay?: number, jitterMax?: number): number;
+/**
+ * Escapes a string for safe use in shell commands
+ *
+ * Escapes special shell characters to prevent command injection.
+ * Use this when interpolating user-controlled values into shell commands.
+ *
+ * @param arg - The string to escape
+ * @returns Escaped string safe for shell interpolation
+ *
+ * @example
+ * ```typescript
+ * const path = '/path/with spaces';
+ * const command = `cd "${escapeShellArg(path)}" && ls`;
+ * // Result: cd "/path/with\ spaces" && ls
+ *
+ * const env = { KEY: 'value with $pecial chars' };
+ * const command = `KEY="${escapeShellArg(env.KEY)}" npm run build`;
+ * // Result: KEY="value with \$pecial chars" npm run build
+ * ```
+ */
+declare function escapeShellArg(arg: string): string;
 
-export { type BaseProviderConfig, type BlaxelProviderConfig, type CloudflareProviderConfig, type CodesandboxProviderConfig, type ComputeAPI, type ComputeConfig, type CreateComputeConfig, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type DaytonaProviderConfig, type E2BProviderConfig, type ExtendTimeoutOptions, type ExtractProviderSandboxType, type FindOrCreateSandboxOptions, type FindSandboxOptions, type ListSnapshotsOptions, type ListTemplatesOptions, type ModalProviderConfig, type Provider, type ProviderConfig, type ProviderMode, type ProviderSandbox, type ProviderSandboxManager, type ProviderSnapshotManager, type ProviderTemplateManager, type RailwayProviderConfig, type RunloopProviderConfig, type SandboxMethods, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedProviderSandbox, type VercelProviderConfig, calculateBackoff, createCompute, defineProvider };
+export { type BaseProviderConfig, type BlaxelProviderConfig, type CloudflareProviderConfig, type CodesandboxProviderConfig, type ComputeAPI, type ComputeConfig, type CreateComputeConfig, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type DaytonaProviderConfig, type E2BProviderConfig, type ExtendTimeoutOptions, type ExtractProviderSandboxType, type FindOrCreateSandboxOptions, type FindSandboxOptions, type ListSnapshotsOptions, type ListTemplatesOptions, type ModalProviderConfig, type Provider, type ProviderConfig, type ProviderMode, type ProviderSandbox, type ProviderSandboxManager, type ProviderSnapshotManager, type ProviderTemplateManager, type RailwayProviderConfig, type RunloopProviderConfig, type SandboxMethods, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedProviderSandbox, type VercelProviderConfig, calculateBackoff, createCompute, defineProvider, escapeShellArg };

package/dist/index.d.ts

@@ -354,7 +354,7 @@ interface SandboxMethods<TSandbox = any, TConfig = any> {
     } | null>;
     extendTimeout?: (config: TConfig, sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;
     runCode: (sandbox: TSandbox, code: string, runtime?: Runtime, config?: TConfig) => Promise<CodeResult>;
-    runCommand: (sandbox: TSandbox, command: string, args?: string[], options?: RunCommandOptions) => Promise<CommandResult>;
+    runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>;
     getInfo: (sandbox: TSandbox) => Promise<SandboxInfo>;
     getUrl: (sandbox: TSandbox, options: {
         port: number;
@@ -362,12 +362,12 @@ interface SandboxMethods<TSandbox = any, TConfig = any> {
     }) => Promise<string>;
     getInstance?: (sandbox: TSandbox) => TSandbox;
     filesystem?: {
-        readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<string>;
-        writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;
-        mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;
-        readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<FileEntry[]>;
-        exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<boolean>;
-        remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;
+        readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<string>;
+        writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;
+        mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;
+        readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<FileEntry[]>;
+        exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<boolean>;
+        remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;
     };
 }
 /**
@@ -510,5 +510,26 @@ declare function createCompute<TInstance = any>(config: CreateComputeConfig<TIns
  * ```
  */
 declare function calculateBackoff(attempt: number, baseDelay?: number, jitterMax?: number): number;
+/**
+ * Escapes a string for safe use in shell commands
+ *
+ * Escapes special shell characters to prevent command injection.
+ * Use this when interpolating user-controlled values into shell commands.
+ *
+ * @param arg - The string to escape
+ * @returns Escaped string safe for shell interpolation
+ *
+ * @example
+ * ```typescript
+ * const path = '/path/with spaces';
+ * const command = `cd "${escapeShellArg(path)}" && ls`;
+ * // Result: cd "/path/with\ spaces" && ls
+ *
+ * const env = { KEY: 'value with $pecial chars' };
+ * const command = `KEY="${escapeShellArg(env.KEY)}" npm run build`;
+ * // Result: KEY="value with \$pecial chars" npm run build
+ * ```
+ */
+declare function escapeShellArg(arg: string): string;
 
-export { type BaseProviderConfig, type BlaxelProviderConfig, type CloudflareProviderConfig, type CodesandboxProviderConfig, type ComputeAPI, type ComputeConfig, type CreateComputeConfig, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type DaytonaProviderConfig, type E2BProviderConfig, type ExtendTimeoutOptions, type ExtractProviderSandboxType, type FindOrCreateSandboxOptions, type FindSandboxOptions, type ListSnapshotsOptions, type ListTemplatesOptions, type ModalProviderConfig, type Provider, type ProviderConfig, type ProviderMode, type ProviderSandbox, type ProviderSandboxManager, type ProviderSnapshotManager, type ProviderTemplateManager, type RailwayProviderConfig, type RunloopProviderConfig, type SandboxMethods, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedProviderSandbox, type VercelProviderConfig, calculateBackoff, createCompute, defineProvider };
+export { type BaseProviderConfig, type BlaxelProviderConfig, type CloudflareProviderConfig, type CodesandboxProviderConfig, type ComputeAPI, type ComputeConfig, type CreateComputeConfig, type CreateSandboxParams, type CreateSandboxParamsWithOptionalProvider, type CreateSnapshotOptions, type CreateTemplateOptions, type DaytonaProviderConfig, type E2BProviderConfig, type ExtendTimeoutOptions, type ExtractProviderSandboxType, type FindOrCreateSandboxOptions, type FindSandboxOptions, type ListSnapshotsOptions, type ListTemplatesOptions, type ModalProviderConfig, type Provider, type ProviderConfig, type ProviderMode, type ProviderSandbox, type ProviderSandboxManager, type ProviderSnapshotManager, type ProviderTemplateManager, type RailwayProviderConfig, type RunloopProviderConfig, type SandboxMethods, type SnapshotMethods, type TemplateMethods, type TypedComputeAPI, type TypedProviderSandbox, type VercelProviderConfig, calculateBackoff, createCompute, defineProvider, escapeShellArg };

package/dist/index.js

@@ -22,12 +22,12 @@ var index_exports = {};
 __export(index_exports, {
   calculateBackoff: () => calculateBackoff,
   createCompute: () => createCompute,
-  defineProvider: () => defineProvider
+  defineProvider: () => defineProvider,
+  escapeShellArg: () => escapeShellArg
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/factory.ts
-var import_cmd = require("@computesdk/cmd");
 var UnsupportedFileSystem = class {
   constructor(providerName) {
     this.providerName = providerName;
@@ -100,28 +100,8 @@ var GeneratedSandbox = class {
   async runCode(code, runtime) {
     return await this.methods.runCode(this.sandbox, code, runtime, this.config);
   }
-  async runCommand(commandOrArray, argsOrOptions, maybeOptions) {
-    let command;
-    let args;
-    let options;
-    if (Array.isArray(commandOrArray)) {
-      [command, ...args] = commandOrArray;
-      options = argsOrOptions;
-    } else {
-      command = commandOrArray;
-      args = Array.isArray(argsOrOptions) ? argsOrOptions : [];
-      options = Array.isArray(argsOrOptions) ? maybeOptions : argsOrOptions;
-    }
-    const baseCommand = args.length > 0 ? [command, ...args] : [command];
-    if (options?.cwd || options?.background) {
-      const wrappedCommand = (0, import_cmd.cmd)(baseCommand, {
-        cwd: options.cwd,
-        background: options.background
-      });
-      const [wrappedCmd, ...wrappedArgs] = wrappedCommand;
-      return await this.methods.runCommand(this.sandbox, wrappedCmd, wrappedArgs, void 0);
-    }
-    return await this.methods.runCommand(this.sandbox, command, args, options);
+  async runCommand(command, options) {
+    return await this.methods.runCommand(this.sandbox, command, options);
   }
   async getInfo() {
     return await this.methods.getInfo(this.sandbox);
@@ -326,10 +306,14 @@ function createCompute(config) {
 function calculateBackoff(attempt, baseDelay = 1e3, jitterMax = 100) {
   return baseDelay * Math.pow(2, attempt) + Math.random() * jitterMax;
 }
+function escapeShellArg(arg) {
+  return arg.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\$/g, "\\$").replace(/`/g, "\\`");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   calculateBackoff,
   createCompute,
-  defineProvider
+  defineProvider,
+  escapeShellArg
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/factory.ts","../src/compute.ts","../src/utils.ts"],"sourcesContent":["/**\n * @computesdk/provider - Provider Framework\n * \n * Build custom sandbox providers for ComputeSDK.\n * This package provides the factory and types needed to create providers.\n */\n\n// Export factory\nexport { defineProvider } from './factory';\nexport type { \n  ProviderConfig, \n  SandboxMethods, \n  TemplateMethods, \n  SnapshotMethods, \n  BaseProviderConfig, \n  ProviderMode \n} from './factory';\n\n// Export direct mode compute API\nexport { createCompute } from './compute';\nexport type { CreateComputeConfig, ComputeAPI } from './compute';\n\n// Export utilities\nexport { calculateBackoff } from './utils';\n\n// Export all types\nexport type * from './types';\n","/**\n * Provider Factory - Creates providers from method definitions\n * \n * Eliminates boilerplate by auto-generating Provider/Sandbox classes\n * from simple method definitions with automatic feature detection.\n */\n\n// Import all types from local types\nimport type {\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n  SandboxFileSystem,\n  Provider,\n  ProviderSandboxManager,\n  ProviderTemplateManager,\n  ProviderSnapshotManager,\n  ProviderSandbox,\n  SandboxInfo,\n  CodeResult,\n  CommandResult,\n  CreateSnapshotOptions,\n  ListSnapshotsOptions,\n  CreateTemplateOptions,\n  ListTemplatesOptions,\n  FindOrCreateSandboxOptions,\n  FindSandboxOptions,\n  ExtendTimeoutOptions,\n} from './types/index.js';\nimport { cmd, type Command } from '@computesdk/cmd';\n\n/**\n * Flat sandbox method implementations - all operations in one place\n */\nexport interface SandboxMethods<TSandbox = any, TConfig = any> {\n  // Collection operations (map to compute.sandbox.*)\n  create: (config: TConfig, options?: CreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  getById: (config: TConfig, sandboxId: string) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  list: (config: TConfig) => Promise<Array<{ sandbox: TSandbox; sandboxId: string }>>;\n  destroy: (config: TConfig, sandboxId: string) => Promise<void>;\n\n  // Optional named sandbox operations\n  findOrCreate?: (config: TConfig, options: FindOrCreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  find?: (config: TConfig, options: FindSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  \n  // Optional timeout management\n  extendTimeout?: (config: TConfig, sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;\n\n  // Instance operations\n  runCode: (sandbox: TSandbox, code: string, runtime?: Runtime, config?: TConfig) => Promise<CodeResult>;\n  runCommand: (sandbox: TSandbox, command: string, args?: string[], options?: RunCommandOptions) => Promise<CommandResult>;\n  getInfo: (sandbox: TSandbox) => Promise<SandboxInfo>;\n  getUrl: (sandbox: TSandbox, options: { port: number; protocol?: string }) => Promise<string>;\n\n  // Optional provider-specific typed getInstance method\n  getInstance?: (sandbox: TSandbox) => TSandbox;\n\n  // Optional filesystem methods\n  filesystem?: {\n    readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<string>;\n    writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;\n    mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;\n    readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<FileEntry[]>;\n    exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<boolean>;\n    remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;\n  };\n}\n\n/**\n * Template method implementations\n */\nexport interface TemplateMethods<TTemplate = any, TConfig = any, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> {\n  create: (config: TConfig, options: TCreateOptions) => Promise<TTemplate>;\n  list: (config: TConfig, options?: ListTemplatesOptions) => Promise<TTemplate[]>;\n  delete: (config: TConfig, templateId: string) => Promise<void>;\n}\n\n/**\n * Snapshot method implementations  \n */\nexport interface SnapshotMethods<TSnapshot = any, TConfig = any> {\n  create: (config: TConfig, sandboxId: string, options?: CreateSnapshotOptions) => Promise<TSnapshot>;\n  list: (config: TConfig, options?: ListSnapshotsOptions) => Promise<TSnapshot[]>;\n  delete: (config: TConfig, snapshotId: string) => Promise<void>;\n}\n\n/**\n * Provider execution modes\n *\n * - 'raw': Use raw provider methods directly (for gateway internal use)\n * - 'direct': Use provider's native SDK directly (for providers with sandbox capabilities)\n * - 'gateway': Route through ComputeSDK gateway (for providers without native sandbox)\n */\nexport type ProviderMode = 'raw' | 'direct' | 'gateway';\n\n/**\n * Provider configuration for defineProvider()\n */\nexport interface ProviderConfig<TSandbox = any, TConfig = any, TTemplate = any, TSnapshot = any> {\n  name: string;\n  /**\n   * Default execution mode for this provider (defaults to 'gateway' if not specified)\n   *\n   * - 'direct': Provider has native sandbox capabilities (e.g., E2B) - uses provider SDK directly\n   * - 'gateway': Provider only has infrastructure (e.g., Railway) - routes through gateway\n   *\n   * Can be overridden at runtime with `mode` in config.\n   */\n  defaultMode?: 'direct' | 'gateway';\n  methods: {\n    sandbox: SandboxMethods<TSandbox, TConfig>;\n    template?: TemplateMethods<TTemplate, TConfig>;\n    snapshot?: SnapshotMethods<TSnapshot, TConfig>;\n  };\n}\n\n/**\n * Base config that all provider configs should extend\n * Includes the `mode` option for controlling execution mode\n */\nexport interface BaseProviderConfig {\n  /**\n   * Execution mode override\n   *\n   * - 'raw': Use raw provider methods directly (for gateway internal use)\n   * - 'direct': Use provider's native SDK directly\n   * - 'gateway': Route through ComputeSDK gateway\n   *\n   * If not specified, uses the provider's `defaultMode`.\n   */\n  mode?: ProviderMode;\n}\n\n/**\n * Auto-generated filesystem implementation that throws \"not supported\" errors\n */\nclass UnsupportedFileSystem implements SandboxFileSystem {\n  private readonly providerName: string;\n\n  constructor(providerName: string) {\n    this.providerName = providerName;\n  }\n\n  async readFile(_path: string): Promise<string> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async writeFile(_path: string, _content: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async mkdir(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async readdir(_path: string): Promise<FileEntry[]> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async exists(_path: string): Promise<boolean> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async remove(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n}\n\n\n\n/**\n * Auto-generated filesystem implementation that wraps provider methods\n */\nclass SupportedFileSystem<TSandbox> implements SandboxFileSystem {\n  constructor(\n    private sandbox: TSandbox,\n    private methods: NonNullable<SandboxMethods<TSandbox>['filesystem']>,\n    private allMethods: SandboxMethods<TSandbox>\n  ) {}\n\n  async readFile(path: string): Promise<string> {\n    return this.methods.readFile(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async writeFile(path: string, content: string): Promise<void> {\n    return this.methods.writeFile(this.sandbox, path, content, this.allMethods.runCommand);\n  }\n\n  async mkdir(path: string): Promise<void> {\n    return this.methods.mkdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async readdir(path: string): Promise<FileEntry[]> {\n    return this.methods.readdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.methods.exists(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async remove(path: string): Promise<void> {\n    return this.methods.remove(this.sandbox, path, this.allMethods.runCommand);\n  }\n}\n\n\n\n\n\n/**\n * Generated sandbox class - implements the ProviderSandbox interface\n */\nclass GeneratedSandbox<TSandbox = any> implements ProviderSandbox<TSandbox> {\n  readonly sandboxId: string;\n  readonly provider: string;\n  readonly filesystem: SandboxFileSystem;\n\n  constructor(\n    private sandbox: TSandbox,\n    sandboxId: string,\n    providerName: string,\n    private methods: SandboxMethods<TSandbox>,\n    private config: any,\n    private destroyMethod: (config: any, sandboxId: string) => Promise<void>,\n    private providerInstance: Provider\n  ) {\n    this.sandboxId = sandboxId;\n    this.provider = providerName;\n\n    // Auto-detect filesystem support\n    if (methods.filesystem) {\n      this.filesystem = new SupportedFileSystem(sandbox, methods.filesystem, methods);\n    } else {\n      this.filesystem = new UnsupportedFileSystem(providerName);\n    }\n  }\n\n  getInstance(): TSandbox {\n    // Use provider-specific typed getInstance if available\n    if (this.methods.getInstance) {\n      return this.methods.getInstance(this.sandbox);\n    }\n    // Fallback to returning the sandbox directly\n    return this.sandbox;\n  }\n\n  async runCode(code: string, runtime?: Runtime): Promise<CodeResult> {\n    return await this.methods.runCode(this.sandbox, code, runtime, this.config);\n  }\n\n  async runCommand(\n    commandOrArray: string | [string, ...string[]],\n    argsOrOptions?: string[] | RunCommandOptions,\n    maybeOptions?: RunCommandOptions\n  ): Promise<CommandResult> {\n    // Parse overloaded arguments\n    let command: string;\n    let args: string[];\n    let options: RunCommandOptions | undefined;\n\n    if (Array.isArray(commandOrArray)) {\n      // Array form: runCommand(['npm', 'install'], { cwd: '/app' })\n      [command, ...args] = commandOrArray;\n      options = argsOrOptions as RunCommandOptions | undefined;\n    } else {\n      // Traditional form: runCommand('npm', ['install'], { cwd: '/app' })\n      command = commandOrArray;\n      args = (Array.isArray(argsOrOptions) ? argsOrOptions : []) as string[];\n      options = Array.isArray(argsOrOptions) ? maybeOptions : argsOrOptions as RunCommandOptions | undefined;\n    }\n\n    // Build the command tuple\n    const baseCommand: Command = args.length > 0 ? [command, ...args] : [command];\n\n    // Use cmd() helper to handle cwd and background options\n    if (options?.cwd || options?.background) {\n      const wrappedCommand = cmd(baseCommand, {\n        cwd: options.cwd,\n        background: options.background,\n      });\n      const [wrappedCmd, ...wrappedArgs] = wrappedCommand;\n      return await this.methods.runCommand(this.sandbox, wrappedCmd, wrappedArgs, undefined);\n    }\n\n    return await this.methods.runCommand(this.sandbox, command, args, options);\n  }\n\n  async getInfo(): Promise<SandboxInfo> {\n    return await this.methods.getInfo(this.sandbox);\n  }\n\n  async getUrl(options: { port: number; protocol?: string }): Promise<string> {\n    return await this.methods.getUrl(this.sandbox, options);\n  }\n\n  getProvider(): Provider<TSandbox> {\n    return this.providerInstance;\n  }\n\n  async destroy(): Promise<void> {\n    // Destroy via the provider's destroy method using our sandboxId\n    await this.destroyMethod(this.config, this.sandboxId);\n  }\n}\n\n/**\n * Determines the effective execution mode\n *\n * @param config - Runtime config (may contain `mode` override)\n * @param defaultMode - Provider's default mode\n * @returns The effective execution mode\n */\nfunction getEffectiveMode(config: BaseProviderConfig, defaultMode: 'direct' | 'gateway'): ProviderMode {\n  // If mode is explicitly set in config, use it\n  if (config.mode) {\n    return config.mode;\n  }\n\n  // Otherwise use provider's default mode\n  return defaultMode;\n}\n\n/**\n * Auto-generated Sandbox Manager implementation\n */\nclass GeneratedSandboxManager<TSandbox, TConfig> implements ProviderSandboxManager<TSandbox> {\n  private readonly effectiveMode: ProviderMode;\n\n  constructor(\n    private config: TConfig,\n    private providerName: string,\n    private methods: SandboxMethods<TSandbox, TConfig>,\n    private providerInstance: Provider,\n    defaultMode: 'direct' | 'gateway'\n  ) {\n    this.effectiveMode = getEffectiveMode(config as BaseProviderConfig, defaultMode);\n  }\n\n  async create(options?: CreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    // Default to 'node' runtime if not specified for consistency across providers\n    const optionsWithDefaults = { runtime: 'node' as Runtime, ...options };\n    const result = await this.methods.create(this.config, optionsWithDefaults);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async getById(sandboxId: string): Promise<ProviderSandbox<TSandbox> | null> {\n    const result = await this.methods.getById(this.config, sandboxId);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async list(): Promise<ProviderSandbox<TSandbox>[]> {\n    const results = await this.methods.list(this.config);\n    \n    return results.map(result => new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    ));\n  }\n\n  async destroy(sandboxId: string): Promise<void> {\n    await this.methods.destroy(this.config, sandboxId);\n  }\n\n  async findOrCreate(options: FindOrCreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    if (!this.methods.findOrCreate) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support findOrCreate.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.findOrCreate(this.config, options);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async find(options: FindSandboxOptions): Promise<ProviderSandbox<TSandbox> | null> {\n    if (!this.methods.find) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support find.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.find(this.config, options);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async extendTimeout(sandboxId: string, options?: ExtendTimeoutOptions): Promise<void> {\n    if (!this.methods.extendTimeout) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support extendTimeout.\\n` +\n        `This feature requires gateway provider with timeout extension support.`\n      );\n    }\n\n    await this.methods.extendTimeout(this.config, sandboxId, options);\n  }\n}\n\n/**\n * Auto-generated Template Manager implementation\n */\nclass GeneratedTemplateManager<TTemplate, TConfig, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> implements ProviderTemplateManager<TTemplate, TCreateOptions> {\n  constructor(\n    private config: TConfig,\n    private methods: TemplateMethods<TTemplate, TConfig, TCreateOptions>\n  ) {}\n\n  async create(options: TCreateOptions): Promise<TTemplate> {\n    return await this.methods.create(this.config, options);\n  }\n\n  async list(options?: ListTemplatesOptions): Promise<TTemplate[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(templateId: string): Promise<void> {\n    return await this.methods.delete(this.config, templateId);\n  }\n}\n\n/**\n * Auto-generated Snapshot Manager implementation\n */\nclass GeneratedSnapshotManager<TSnapshot, TConfig> implements ProviderSnapshotManager<TSnapshot> {\n  constructor(\n    private config: TConfig,\n    private methods: SnapshotMethods<TSnapshot, TConfig>\n  ) {}\n\n  async create(sandboxId: string, options?: CreateSnapshotOptions): Promise<TSnapshot> {\n    return await this.methods.create(this.config, sandboxId, options);\n  }\n\n  async list(options?: ListSnapshotsOptions): Promise<TSnapshot[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(snapshotId: string): Promise<void> {\n    return await this.methods.delete(this.config, snapshotId);\n  }\n}\n\n/**\n * Auto-generated Provider implementation\n */\nclass GeneratedProvider<TSandbox, TConfig, TTemplate, TSnapshot> implements Provider<TSandbox, TTemplate, TSnapshot> {\n  readonly name: string;\n  readonly sandbox: ProviderSandboxManager<TSandbox>;\n  readonly template?: ProviderTemplateManager<TTemplate>;\n  readonly snapshot?: ProviderSnapshotManager<TSnapshot>;\n\n  constructor(config: TConfig, providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>) {\n    this.name = providerConfig.name;\n    this.sandbox = new GeneratedSandboxManager(\n      config,\n      providerConfig.name,\n      providerConfig.methods.sandbox,\n      this,\n      providerConfig.defaultMode ?? 'gateway'\n    );\n\n    // Initialize optional managers if methods are provided\n    if (providerConfig.methods.template) {\n      this.template = new GeneratedTemplateManager(config, providerConfig.methods.template);\n    }\n    \n    if (providerConfig.methods.snapshot) {\n      this.snapshot = new GeneratedSnapshotManager(config, providerConfig.methods.snapshot);\n    }\n  }\n\n  getSupportedRuntimes(): Runtime[] {\n    // For now, all providers support both node and python\n    // In the future, this could be configurable per provider\n    return ['node', 'python'];\n  }\n}\n\n/**\n * Create a provider from method definitions\n *\n * Auto-generates all boilerplate classes and provides feature detection\n * based on which methods are implemented.\n */\nexport function defineProvider<TSandbox, TConfig = any, TTemplate = any, TSnapshot = any>(\n  providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>\n): (config: TConfig & BaseProviderConfig) => Provider<TSandbox, TTemplate, TSnapshot> {\n  return (config: TConfig & BaseProviderConfig) => {\n    return new GeneratedProvider(config, providerConfig);\n  };\n}","/**\n * Direct Mode Compute API\n * \n * Use this when you want to use providers directly without the gateway.\n * This is the \"mother\" talking directly to \"children\" providers.\n */\n\nimport type { Provider } from './types';\n\n/**\n * Configuration for creating a compute instance with a provider\n */\nexport interface CreateComputeConfig<TInstance = any> {\n  /** The provider instance to use */\n  defaultProvider?: Provider<TInstance>;\n  /** Legacy alias for defaultProvider */\n  provider?: Provider<TInstance>;\n}\n\n/**\n * Compute API for direct provider usage\n */\nexport interface ComputeAPI<TInstance = any> {\n  /** Sandbox management methods */\n  sandbox: Provider<TInstance>['sandbox'];\n  /** Get current configuration */\n  getConfig(): CreateComputeConfig<TInstance> | null;\n  /** Update configuration and return new compute instance */\n  setConfig<TNewInstance = any>(config: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance>;\n  /** Clear configuration */\n  clearConfig(): void;\n}\n\n/**\n * Create a compute instance with a provider for direct mode\n * \n * @example\n * ```typescript\n * import { createCompute } from '@computesdk/provider';\n * import { e2bProvider } from '@computesdk/e2b';\n * \n * const provider = e2bProvider({ apiKey: 'your-key' });\n * const compute = createCompute({ defaultProvider: provider });\n * \n * const sandbox = await compute.sandbox.create();\n * ```\n */\nexport function createCompute<TInstance = any>(\n  config: CreateComputeConfig<TInstance>\n): ComputeAPI<TInstance> {\n  const provider = config.defaultProvider || config.provider;\n  \n  if (!provider) {\n    throw new Error(\n      'createCompute requires a provider for direct mode. ' +\n      'Pass a provider via the defaultProvider or provider config property. ' +\n      'For gateway mode, do not use createCompute; use the compute singleton from computesdk instead.'\n    );\n  }\n\n  let currentConfig: CreateComputeConfig<TInstance> | null = config;\n\n  return {\n    sandbox: provider.sandbox,\n    \n    getConfig() {\n      return currentConfig;\n    },\n    \n    setConfig<TNewInstance = any>(newConfig: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance> {\n      return createCompute(newConfig);\n    },\n    \n    clearConfig() {\n      currentConfig = null;\n    }\n  };\n}\n","/**\n * Utility functions for ComputeSDK\n */\n\n/**\n * Calculate exponential backoff delay with jitter\n * \n * Uses exponential backoff (2^attempt) multiplied by base delay,\n * plus random jitter to prevent thundering herd.\n * \n * @param attempt - Current retry attempt (0-indexed)\n * @param baseDelay - Base delay in milliseconds (default: 1000)\n * @param jitterMax - Maximum random jitter in milliseconds (default: 100)\n * @returns Delay in milliseconds\n * \n * @example\n * ```typescript\n * // First retry: 1000-1100ms\n * calculateBackoff(0);\n * \n * // Second retry: 2000-2100ms\n * calculateBackoff(1);\n * \n * // Third retry: 4000-4100ms\n * calculateBackoff(2);\n * ```\n */\nexport function calculateBackoff(\n  attempt: number,\n  baseDelay: number = 1000,\n  jitterMax: number = 100\n): number {\n  return baseDelay * Math.pow(2, attempt) + Math.random() * jitterMax;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/factory.ts","../src/compute.ts","../src/utils.ts"],"sourcesContent":["/**\n * @computesdk/provider - Provider Framework\n * \n * Build custom sandbox providers for ComputeSDK.\n * This package provides the factory and types needed to create providers.\n */\n\n// Export factory\nexport { defineProvider } from './factory';\nexport type { \n  ProviderConfig, \n  SandboxMethods, \n  TemplateMethods, \n  SnapshotMethods, \n  BaseProviderConfig, \n  ProviderMode \n} from './factory';\n\n// Export direct mode compute API\nexport { createCompute } from './compute';\nexport type { CreateComputeConfig, ComputeAPI } from './compute';\n\n// Export utilities\nexport { calculateBackoff, escapeShellArg } from './utils';\n\n// Export all types\nexport type * from './types';\n","/**\n * Provider Factory - Creates providers from method definitions\n * \n * Eliminates boilerplate by auto-generating Provider/Sandbox classes\n * from simple method definitions with automatic feature detection.\n */\n\n// Import all types from local types\nimport type {\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n  SandboxFileSystem,\n  Provider,\n  ProviderSandboxManager,\n  ProviderTemplateManager,\n  ProviderSnapshotManager,\n  ProviderSandbox,\n  SandboxInfo,\n  CodeResult,\n  CommandResult,\n  CreateSnapshotOptions,\n  ListSnapshotsOptions,\n  CreateTemplateOptions,\n  ListTemplatesOptions,\n  FindOrCreateSandboxOptions,\n  FindSandboxOptions,\n  ExtendTimeoutOptions,\n} from './types/index.js';\n\n/**\n * Flat sandbox method implementations - all operations in one place\n */\nexport interface SandboxMethods<TSandbox = any, TConfig = any> {\n  // Collection operations (map to compute.sandbox.*)\n  create: (config: TConfig, options?: CreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  getById: (config: TConfig, sandboxId: string) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  list: (config: TConfig) => Promise<Array<{ sandbox: TSandbox; sandboxId: string }>>;\n  destroy: (config: TConfig, sandboxId: string) => Promise<void>;\n\n  // Optional named sandbox operations\n  findOrCreate?: (config: TConfig, options: FindOrCreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  find?: (config: TConfig, options: FindSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  \n  // Optional timeout management\n  extendTimeout?: (config: TConfig, sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;\n\n  // Instance operations\n  runCode: (sandbox: TSandbox, code: string, runtime?: Runtime, config?: TConfig) => Promise<CodeResult>;\n  runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>;\n  getInfo: (sandbox: TSandbox) => Promise<SandboxInfo>;\n  getUrl: (sandbox: TSandbox, options: { port: number; protocol?: string }) => Promise<string>;\n\n  // Optional provider-specific typed getInstance method\n  getInstance?: (sandbox: TSandbox) => TSandbox;\n\n  // Optional filesystem methods\n  filesystem?: {\n    readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<string>;\n    writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;\n    mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;\n    readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<FileEntry[]>;\n    exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<boolean>;\n    remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;\n  };\n}\n\n/**\n * Template method implementations\n */\nexport interface TemplateMethods<TTemplate = any, TConfig = any, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> {\n  create: (config: TConfig, options: TCreateOptions) => Promise<TTemplate>;\n  list: (config: TConfig, options?: ListTemplatesOptions) => Promise<TTemplate[]>;\n  delete: (config: TConfig, templateId: string) => Promise<void>;\n}\n\n/**\n * Snapshot method implementations  \n */\nexport interface SnapshotMethods<TSnapshot = any, TConfig = any> {\n  create: (config: TConfig, sandboxId: string, options?: CreateSnapshotOptions) => Promise<TSnapshot>;\n  list: (config: TConfig, options?: ListSnapshotsOptions) => Promise<TSnapshot[]>;\n  delete: (config: TConfig, snapshotId: string) => Promise<void>;\n}\n\n/**\n * Provider execution modes\n *\n * - 'raw': Use raw provider methods directly (for gateway internal use)\n * - 'direct': Use provider's native SDK directly (for providers with sandbox capabilities)\n * - 'gateway': Route through ComputeSDK gateway (for providers without native sandbox)\n */\nexport type ProviderMode = 'raw' | 'direct' | 'gateway';\n\n/**\n * Provider configuration for defineProvider()\n */\nexport interface ProviderConfig<TSandbox = any, TConfig = any, TTemplate = any, TSnapshot = any> {\n  name: string;\n  /**\n   * Default execution mode for this provider (defaults to 'gateway' if not specified)\n   *\n   * - 'direct': Provider has native sandbox capabilities (e.g., E2B) - uses provider SDK directly\n   * - 'gateway': Provider only has infrastructure (e.g., Railway) - routes through gateway\n   *\n   * Can be overridden at runtime with `mode` in config.\n   */\n  defaultMode?: 'direct' | 'gateway';\n  methods: {\n    sandbox: SandboxMethods<TSandbox, TConfig>;\n    template?: TemplateMethods<TTemplate, TConfig>;\n    snapshot?: SnapshotMethods<TSnapshot, TConfig>;\n  };\n}\n\n/**\n * Base config that all provider configs should extend\n * Includes the `mode` option for controlling execution mode\n */\nexport interface BaseProviderConfig {\n  /**\n   * Execution mode override\n   *\n   * - 'raw': Use raw provider methods directly (for gateway internal use)\n   * - 'direct': Use provider's native SDK directly\n   * - 'gateway': Route through ComputeSDK gateway\n   *\n   * If not specified, uses the provider's `defaultMode`.\n   */\n  mode?: ProviderMode;\n}\n\n/**\n * Auto-generated filesystem implementation that throws \"not supported\" errors\n */\nclass UnsupportedFileSystem implements SandboxFileSystem {\n  private readonly providerName: string;\n\n  constructor(providerName: string) {\n    this.providerName = providerName;\n  }\n\n  async readFile(_path: string): Promise<string> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async writeFile(_path: string, _content: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async mkdir(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async readdir(_path: string): Promise<FileEntry[]> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async exists(_path: string): Promise<boolean> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async remove(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n}\n\n\n\n/**\n * Auto-generated filesystem implementation that wraps provider methods\n */\nclass SupportedFileSystem<TSandbox> implements SandboxFileSystem {\n  constructor(\n    private sandbox: TSandbox,\n    private methods: NonNullable<SandboxMethods<TSandbox>['filesystem']>,\n    private allMethods: SandboxMethods<TSandbox>\n  ) {}\n\n  async readFile(path: string): Promise<string> {\n    return this.methods.readFile(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async writeFile(path: string, content: string): Promise<void> {\n    return this.methods.writeFile(this.sandbox, path, content, this.allMethods.runCommand);\n  }\n\n  async mkdir(path: string): Promise<void> {\n    return this.methods.mkdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async readdir(path: string): Promise<FileEntry[]> {\n    return this.methods.readdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.methods.exists(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async remove(path: string): Promise<void> {\n    return this.methods.remove(this.sandbox, path, this.allMethods.runCommand);\n  }\n}\n\n\n\n\n\n/**\n * Generated sandbox class - implements the ProviderSandbox interface\n */\nclass GeneratedSandbox<TSandbox = any> implements ProviderSandbox<TSandbox> {\n  readonly sandboxId: string;\n  readonly provider: string;\n  readonly filesystem: SandboxFileSystem;\n\n  constructor(\n    private sandbox: TSandbox,\n    sandboxId: string,\n    providerName: string,\n    private methods: SandboxMethods<TSandbox>,\n    private config: any,\n    private destroyMethod: (config: any, sandboxId: string) => Promise<void>,\n    private providerInstance: Provider\n  ) {\n    this.sandboxId = sandboxId;\n    this.provider = providerName;\n\n    // Auto-detect filesystem support\n    if (methods.filesystem) {\n      this.filesystem = new SupportedFileSystem(sandbox, methods.filesystem, methods);\n    } else {\n      this.filesystem = new UnsupportedFileSystem(providerName);\n    }\n  }\n\n  getInstance(): TSandbox {\n    // Use provider-specific typed getInstance if available\n    if (this.methods.getInstance) {\n      return this.methods.getInstance(this.sandbox);\n    }\n    // Fallback to returning the sandbox directly\n    return this.sandbox;\n  }\n\n  async runCode(code: string, runtime?: Runtime): Promise<CodeResult> {\n    return await this.methods.runCode(this.sandbox, code, runtime, this.config);\n  }\n\n  async runCommand(\n    command: string,\n    options?: RunCommandOptions\n  ): Promise<CommandResult> {\n    // Pass command and options directly to provider - no preprocessing\n    // Provider is responsible for handling cwd, env, background, etc.\n    return await this.methods.runCommand(this.sandbox, command, options);\n  }\n\n  async getInfo(): Promise<SandboxInfo> {\n    return await this.methods.getInfo(this.sandbox);\n  }\n\n  async getUrl(options: { port: number; protocol?: string }): Promise<string> {\n    return await this.methods.getUrl(this.sandbox, options);\n  }\n\n  getProvider(): Provider<TSandbox> {\n    return this.providerInstance;\n  }\n\n  async destroy(): Promise<void> {\n    // Destroy via the provider's destroy method using our sandboxId\n    await this.destroyMethod(this.config, this.sandboxId);\n  }\n}\n\n/**\n * Determines the effective execution mode\n *\n * @param config - Runtime config (may contain `mode` override)\n * @param defaultMode - Provider's default mode\n * @returns The effective execution mode\n */\nfunction getEffectiveMode(config: BaseProviderConfig, defaultMode: 'direct' | 'gateway'): ProviderMode {\n  // If mode is explicitly set in config, use it\n  if (config.mode) {\n    return config.mode;\n  }\n\n  // Otherwise use provider's default mode\n  return defaultMode;\n}\n\n/**\n * Auto-generated Sandbox Manager implementation\n */\nclass GeneratedSandboxManager<TSandbox, TConfig> implements ProviderSandboxManager<TSandbox> {\n  private readonly effectiveMode: ProviderMode;\n\n  constructor(\n    private config: TConfig,\n    private providerName: string,\n    private methods: SandboxMethods<TSandbox, TConfig>,\n    private providerInstance: Provider,\n    defaultMode: 'direct' | 'gateway'\n  ) {\n    this.effectiveMode = getEffectiveMode(config as BaseProviderConfig, defaultMode);\n  }\n\n  async create(options?: CreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    // Default to 'node' runtime if not specified for consistency across providers\n    const optionsWithDefaults = { runtime: 'node' as Runtime, ...options };\n    const result = await this.methods.create(this.config, optionsWithDefaults);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async getById(sandboxId: string): Promise<ProviderSandbox<TSandbox> | null> {\n    const result = await this.methods.getById(this.config, sandboxId);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async list(): Promise<ProviderSandbox<TSandbox>[]> {\n    const results = await this.methods.list(this.config);\n    \n    return results.map(result => new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    ));\n  }\n\n  async destroy(sandboxId: string): Promise<void> {\n    await this.methods.destroy(this.config, sandboxId);\n  }\n\n  async findOrCreate(options: FindOrCreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    if (!this.methods.findOrCreate) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support findOrCreate.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.findOrCreate(this.config, options);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async find(options: FindSandboxOptions): Promise<ProviderSandbox<TSandbox> | null> {\n    if (!this.methods.find) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support find.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.find(this.config, options);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async extendTimeout(sandboxId: string, options?: ExtendTimeoutOptions): Promise<void> {\n    if (!this.methods.extendTimeout) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support extendTimeout.\\n` +\n        `This feature requires gateway provider with timeout extension support.`\n      );\n    }\n\n    await this.methods.extendTimeout(this.config, sandboxId, options);\n  }\n}\n\n/**\n * Auto-generated Template Manager implementation\n */\nclass GeneratedTemplateManager<TTemplate, TConfig, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> implements ProviderTemplateManager<TTemplate, TCreateOptions> {\n  constructor(\n    private config: TConfig,\n    private methods: TemplateMethods<TTemplate, TConfig, TCreateOptions>\n  ) {}\n\n  async create(options: TCreateOptions): Promise<TTemplate> {\n    return await this.methods.create(this.config, options);\n  }\n\n  async list(options?: ListTemplatesOptions): Promise<TTemplate[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(templateId: string): Promise<void> {\n    return await this.methods.delete(this.config, templateId);\n  }\n}\n\n/**\n * Auto-generated Snapshot Manager implementation\n */\nclass GeneratedSnapshotManager<TSnapshot, TConfig> implements ProviderSnapshotManager<TSnapshot> {\n  constructor(\n    private config: TConfig,\n    private methods: SnapshotMethods<TSnapshot, TConfig>\n  ) {}\n\n  async create(sandboxId: string, options?: CreateSnapshotOptions): Promise<TSnapshot> {\n    return await this.methods.create(this.config, sandboxId, options);\n  }\n\n  async list(options?: ListSnapshotsOptions): Promise<TSnapshot[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(snapshotId: string): Promise<void> {\n    return await this.methods.delete(this.config, snapshotId);\n  }\n}\n\n/**\n * Auto-generated Provider implementation\n */\nclass GeneratedProvider<TSandbox, TConfig, TTemplate, TSnapshot> implements Provider<TSandbox, TTemplate, TSnapshot> {\n  readonly name: string;\n  readonly sandbox: ProviderSandboxManager<TSandbox>;\n  readonly template?: ProviderTemplateManager<TTemplate>;\n  readonly snapshot?: ProviderSnapshotManager<TSnapshot>;\n\n  constructor(config: TConfig, providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>) {\n    this.name = providerConfig.name;\n    this.sandbox = new GeneratedSandboxManager(\n      config,\n      providerConfig.name,\n      providerConfig.methods.sandbox,\n      this,\n      providerConfig.defaultMode ?? 'gateway'\n    );\n\n    // Initialize optional managers if methods are provided\n    if (providerConfig.methods.template) {\n      this.template = new GeneratedTemplateManager(config, providerConfig.methods.template);\n    }\n    \n    if (providerConfig.methods.snapshot) {\n      this.snapshot = new GeneratedSnapshotManager(config, providerConfig.methods.snapshot);\n    }\n  }\n\n  getSupportedRuntimes(): Runtime[] {\n    // For now, all providers support both node and python\n    // In the future, this could be configurable per provider\n    return ['node', 'python'];\n  }\n}\n\n/**\n * Create a provider from method definitions\n *\n * Auto-generates all boilerplate classes and provides feature detection\n * based on which methods are implemented.\n */\nexport function defineProvider<TSandbox, TConfig = any, TTemplate = any, TSnapshot = any>(\n  providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>\n): (config: TConfig & BaseProviderConfig) => Provider<TSandbox, TTemplate, TSnapshot> {\n  return (config: TConfig & BaseProviderConfig) => {\n    return new GeneratedProvider(config, providerConfig);\n  };\n}","/**\n * Direct Mode Compute API\n * \n * Use this when you want to use providers directly without the gateway.\n * This is the \"mother\" talking directly to \"children\" providers.\n */\n\nimport type { Provider } from './types';\n\n/**\n * Configuration for creating a compute instance with a provider\n */\nexport interface CreateComputeConfig<TInstance = any> {\n  /** The provider instance to use */\n  defaultProvider?: Provider<TInstance>;\n  /** Legacy alias for defaultProvider */\n  provider?: Provider<TInstance>;\n}\n\n/**\n * Compute API for direct provider usage\n */\nexport interface ComputeAPI<TInstance = any> {\n  /** Sandbox management methods */\n  sandbox: Provider<TInstance>['sandbox'];\n  /** Get current configuration */\n  getConfig(): CreateComputeConfig<TInstance> | null;\n  /** Update configuration and return new compute instance */\n  setConfig<TNewInstance = any>(config: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance>;\n  /** Clear configuration */\n  clearConfig(): void;\n}\n\n/**\n * Create a compute instance with a provider for direct mode\n * \n * @example\n * ```typescript\n * import { createCompute } from '@computesdk/provider';\n * import { e2bProvider } from '@computesdk/e2b';\n * \n * const provider = e2bProvider({ apiKey: 'your-key' });\n * const compute = createCompute({ defaultProvider: provider });\n * \n * const sandbox = await compute.sandbox.create();\n * ```\n */\nexport function createCompute<TInstance = any>(\n  config: CreateComputeConfig<TInstance>\n): ComputeAPI<TInstance> {\n  const provider = config.defaultProvider || config.provider;\n  \n  if (!provider) {\n    throw new Error(\n      'createCompute requires a provider for direct mode. ' +\n      'Pass a provider via the defaultProvider or provider config property. ' +\n      'For gateway mode, do not use createCompute; use the compute singleton from computesdk instead.'\n    );\n  }\n\n  let currentConfig: CreateComputeConfig<TInstance> | null = config;\n\n  return {\n    sandbox: provider.sandbox,\n    \n    getConfig() {\n      return currentConfig;\n    },\n    \n    setConfig<TNewInstance = any>(newConfig: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance> {\n      return createCompute(newConfig);\n    },\n    \n    clearConfig() {\n      currentConfig = null;\n    }\n  };\n}\n","/**\n * Utility functions for ComputeSDK\n */\n\n/**\n * Calculate exponential backoff delay with jitter\n * \n * Uses exponential backoff (2^attempt) multiplied by base delay,\n * plus random jitter to prevent thundering herd.\n * \n * @param attempt - Current retry attempt (0-indexed)\n * @param baseDelay - Base delay in milliseconds (default: 1000)\n * @param jitterMax - Maximum random jitter in milliseconds (default: 100)\n * @returns Delay in milliseconds\n * \n * @example\n * ```typescript\n * // First retry: 1000-1100ms\n * calculateBackoff(0);\n * \n * // Second retry: 2000-2100ms\n * calculateBackoff(1);\n * \n * // Third retry: 4000-4100ms\n * calculateBackoff(2);\n * ```\n */\nexport function calculateBackoff(\n  attempt: number,\n  baseDelay: number = 1000,\n  jitterMax: number = 100\n): number {\n  return baseDelay * Math.pow(2, attempt) + Math.random() * jitterMax;\n}\n\n/**\n * Escapes a string for safe use in shell commands\n * \n * Escapes special shell characters to prevent command injection.\n * Use this when interpolating user-controlled values into shell commands.\n * \n * @param arg - The string to escape\n * @returns Escaped string safe for shell interpolation\n * \n * @example\n * ```typescript\n * const path = '/path/with spaces';\n * const command = `cd \"${escapeShellArg(path)}\" && ls`;\n * // Result: cd \"/path/with\\ spaces\" && ls\n * \n * const env = { KEY: 'value with $pecial chars' };\n * const command = `KEY=\"${escapeShellArg(env.KEY)}\" npm run build`;\n * // Result: KEY=\"value with \\$pecial chars\" npm run build\n * ```\n */\nexport function escapeShellArg(arg: string): string {\n  return arg\n    .replace(/\\\\/g, '\\\\\\\\')  // Escape backslashes\n    .replace(/\"/g, '\\\\\"')    // Escape double quotes\n    .replace(/\\$/g, '\\\\$')   // Escape dollar signs (variable expansion)\n    .replace(/`/g, '\\\\`');   // Escape backticks (command substitution)\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -1,5 +1,4 @@
 // src/factory.ts
-import { cmd } from "@computesdk/cmd";
 var UnsupportedFileSystem = class {
   constructor(providerName) {
     this.providerName = providerName;
@@ -72,28 +71,8 @@ var GeneratedSandbox = class {
   async runCode(code, runtime) {
     return await this.methods.runCode(this.sandbox, code, runtime, this.config);
   }
-  async runCommand(commandOrArray, argsOrOptions, maybeOptions) {
-    let command;
-    let args;
-    let options;
-    if (Array.isArray(commandOrArray)) {
-      [command, ...args] = commandOrArray;
-      options = argsOrOptions;
-    } else {
-      command = commandOrArray;
-      args = Array.isArray(argsOrOptions) ? argsOrOptions : [];
-      options = Array.isArray(argsOrOptions) ? maybeOptions : argsOrOptions;
-    }
-    const baseCommand = args.length > 0 ? [command, ...args] : [command];
-    if (options?.cwd || options?.background) {
-      const wrappedCommand = cmd(baseCommand, {
-        cwd: options.cwd,
-        background: options.background
-      });
-      const [wrappedCmd, ...wrappedArgs] = wrappedCommand;
-      return await this.methods.runCommand(this.sandbox, wrappedCmd, wrappedArgs, void 0);
-    }
-    return await this.methods.runCommand(this.sandbox, command, args, options);
+  async runCommand(command, options) {
+    return await this.methods.runCommand(this.sandbox, command, options);
   }
   async getInfo() {
     return await this.methods.getInfo(this.sandbox);
@@ -298,9 +277,13 @@ function createCompute(config) {
 function calculateBackoff(attempt, baseDelay = 1e3, jitterMax = 100) {
   return baseDelay * Math.pow(2, attempt) + Math.random() * jitterMax;
 }
+function escapeShellArg(arg) {
+  return arg.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\$/g, "\\$").replace(/`/g, "\\`");
+}
 export {
   calculateBackoff,
   createCompute,
-  defineProvider
+  defineProvider,
+  escapeShellArg
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/factory.ts","../src/compute.ts","../src/utils.ts"],"sourcesContent":["/**\n * Provider Factory - Creates providers from method definitions\n * \n * Eliminates boilerplate by auto-generating Provider/Sandbox classes\n * from simple method definitions with automatic feature detection.\n */\n\n// Import all types from local types\nimport type {\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n  SandboxFileSystem,\n  Provider,\n  ProviderSandboxManager,\n  ProviderTemplateManager,\n  ProviderSnapshotManager,\n  ProviderSandbox,\n  SandboxInfo,\n  CodeResult,\n  CommandResult,\n  CreateSnapshotOptions,\n  ListSnapshotsOptions,\n  CreateTemplateOptions,\n  ListTemplatesOptions,\n  FindOrCreateSandboxOptions,\n  FindSandboxOptions,\n  ExtendTimeoutOptions,\n} from './types/index.js';\nimport { cmd, type Command } from '@computesdk/cmd';\n\n/**\n * Flat sandbox method implementations - all operations in one place\n */\nexport interface SandboxMethods<TSandbox = any, TConfig = any> {\n  // Collection operations (map to compute.sandbox.*)\n  create: (config: TConfig, options?: CreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  getById: (config: TConfig, sandboxId: string) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  list: (config: TConfig) => Promise<Array<{ sandbox: TSandbox; sandboxId: string }>>;\n  destroy: (config: TConfig, sandboxId: string) => Promise<void>;\n\n  // Optional named sandbox operations\n  findOrCreate?: (config: TConfig, options: FindOrCreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  find?: (config: TConfig, options: FindSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  \n  // Optional timeout management\n  extendTimeout?: (config: TConfig, sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;\n\n  // Instance operations\n  runCode: (sandbox: TSandbox, code: string, runtime?: Runtime, config?: TConfig) => Promise<CodeResult>;\n  runCommand: (sandbox: TSandbox, command: string, args?: string[], options?: RunCommandOptions) => Promise<CommandResult>;\n  getInfo: (sandbox: TSandbox) => Promise<SandboxInfo>;\n  getUrl: (sandbox: TSandbox, options: { port: number; protocol?: string }) => Promise<string>;\n\n  // Optional provider-specific typed getInstance method\n  getInstance?: (sandbox: TSandbox) => TSandbox;\n\n  // Optional filesystem methods\n  filesystem?: {\n    readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<string>;\n    writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;\n    mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;\n    readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<FileEntry[]>;\n    exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<boolean>;\n    remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, args?: string[]) => Promise<CommandResult>) => Promise<void>;\n  };\n}\n\n/**\n * Template method implementations\n */\nexport interface TemplateMethods<TTemplate = any, TConfig = any, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> {\n  create: (config: TConfig, options: TCreateOptions) => Promise<TTemplate>;\n  list: (config: TConfig, options?: ListTemplatesOptions) => Promise<TTemplate[]>;\n  delete: (config: TConfig, templateId: string) => Promise<void>;\n}\n\n/**\n * Snapshot method implementations  \n */\nexport interface SnapshotMethods<TSnapshot = any, TConfig = any> {\n  create: (config: TConfig, sandboxId: string, options?: CreateSnapshotOptions) => Promise<TSnapshot>;\n  list: (config: TConfig, options?: ListSnapshotsOptions) => Promise<TSnapshot[]>;\n  delete: (config: TConfig, snapshotId: string) => Promise<void>;\n}\n\n/**\n * Provider execution modes\n *\n * - 'raw': Use raw provider methods directly (for gateway internal use)\n * - 'direct': Use provider's native SDK directly (for providers with sandbox capabilities)\n * - 'gateway': Route through ComputeSDK gateway (for providers without native sandbox)\n */\nexport type ProviderMode = 'raw' | 'direct' | 'gateway';\n\n/**\n * Provider configuration for defineProvider()\n */\nexport interface ProviderConfig<TSandbox = any, TConfig = any, TTemplate = any, TSnapshot = any> {\n  name: string;\n  /**\n   * Default execution mode for this provider (defaults to 'gateway' if not specified)\n   *\n   * - 'direct': Provider has native sandbox capabilities (e.g., E2B) - uses provider SDK directly\n   * - 'gateway': Provider only has infrastructure (e.g., Railway) - routes through gateway\n   *\n   * Can be overridden at runtime with `mode` in config.\n   */\n  defaultMode?: 'direct' | 'gateway';\n  methods: {\n    sandbox: SandboxMethods<TSandbox, TConfig>;\n    template?: TemplateMethods<TTemplate, TConfig>;\n    snapshot?: SnapshotMethods<TSnapshot, TConfig>;\n  };\n}\n\n/**\n * Base config that all provider configs should extend\n * Includes the `mode` option for controlling execution mode\n */\nexport interface BaseProviderConfig {\n  /**\n   * Execution mode override\n   *\n   * - 'raw': Use raw provider methods directly (for gateway internal use)\n   * - 'direct': Use provider's native SDK directly\n   * - 'gateway': Route through ComputeSDK gateway\n   *\n   * If not specified, uses the provider's `defaultMode`.\n   */\n  mode?: ProviderMode;\n}\n\n/**\n * Auto-generated filesystem implementation that throws \"not supported\" errors\n */\nclass UnsupportedFileSystem implements SandboxFileSystem {\n  private readonly providerName: string;\n\n  constructor(providerName: string) {\n    this.providerName = providerName;\n  }\n\n  async readFile(_path: string): Promise<string> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async writeFile(_path: string, _content: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async mkdir(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async readdir(_path: string): Promise<FileEntry[]> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async exists(_path: string): Promise<boolean> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async remove(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n}\n\n\n\n/**\n * Auto-generated filesystem implementation that wraps provider methods\n */\nclass SupportedFileSystem<TSandbox> implements SandboxFileSystem {\n  constructor(\n    private sandbox: TSandbox,\n    private methods: NonNullable<SandboxMethods<TSandbox>['filesystem']>,\n    private allMethods: SandboxMethods<TSandbox>\n  ) {}\n\n  async readFile(path: string): Promise<string> {\n    return this.methods.readFile(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async writeFile(path: string, content: string): Promise<void> {\n    return this.methods.writeFile(this.sandbox, path, content, this.allMethods.runCommand);\n  }\n\n  async mkdir(path: string): Promise<void> {\n    return this.methods.mkdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async readdir(path: string): Promise<FileEntry[]> {\n    return this.methods.readdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.methods.exists(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async remove(path: string): Promise<void> {\n    return this.methods.remove(this.sandbox, path, this.allMethods.runCommand);\n  }\n}\n\n\n\n\n\n/**\n * Generated sandbox class - implements the ProviderSandbox interface\n */\nclass GeneratedSandbox<TSandbox = any> implements ProviderSandbox<TSandbox> {\n  readonly sandboxId: string;\n  readonly provider: string;\n  readonly filesystem: SandboxFileSystem;\n\n  constructor(\n    private sandbox: TSandbox,\n    sandboxId: string,\n    providerName: string,\n    private methods: SandboxMethods<TSandbox>,\n    private config: any,\n    private destroyMethod: (config: any, sandboxId: string) => Promise<void>,\n    private providerInstance: Provider\n  ) {\n    this.sandboxId = sandboxId;\n    this.provider = providerName;\n\n    // Auto-detect filesystem support\n    if (methods.filesystem) {\n      this.filesystem = new SupportedFileSystem(sandbox, methods.filesystem, methods);\n    } else {\n      this.filesystem = new UnsupportedFileSystem(providerName);\n    }\n  }\n\n  getInstance(): TSandbox {\n    // Use provider-specific typed getInstance if available\n    if (this.methods.getInstance) {\n      return this.methods.getInstance(this.sandbox);\n    }\n    // Fallback to returning the sandbox directly\n    return this.sandbox;\n  }\n\n  async runCode(code: string, runtime?: Runtime): Promise<CodeResult> {\n    return await this.methods.runCode(this.sandbox, code, runtime, this.config);\n  }\n\n  async runCommand(\n    commandOrArray: string | [string, ...string[]],\n    argsOrOptions?: string[] | RunCommandOptions,\n    maybeOptions?: RunCommandOptions\n  ): Promise<CommandResult> {\n    // Parse overloaded arguments\n    let command: string;\n    let args: string[];\n    let options: RunCommandOptions | undefined;\n\n    if (Array.isArray(commandOrArray)) {\n      // Array form: runCommand(['npm', 'install'], { cwd: '/app' })\n      [command, ...args] = commandOrArray;\n      options = argsOrOptions as RunCommandOptions | undefined;\n    } else {\n      // Traditional form: runCommand('npm', ['install'], { cwd: '/app' })\n      command = commandOrArray;\n      args = (Array.isArray(argsOrOptions) ? argsOrOptions : []) as string[];\n      options = Array.isArray(argsOrOptions) ? maybeOptions : argsOrOptions as RunCommandOptions | undefined;\n    }\n\n    // Build the command tuple\n    const baseCommand: Command = args.length > 0 ? [command, ...args] : [command];\n\n    // Use cmd() helper to handle cwd and background options\n    if (options?.cwd || options?.background) {\n      const wrappedCommand = cmd(baseCommand, {\n        cwd: options.cwd,\n        background: options.background,\n      });\n      const [wrappedCmd, ...wrappedArgs] = wrappedCommand;\n      return await this.methods.runCommand(this.sandbox, wrappedCmd, wrappedArgs, undefined);\n    }\n\n    return await this.methods.runCommand(this.sandbox, command, args, options);\n  }\n\n  async getInfo(): Promise<SandboxInfo> {\n    return await this.methods.getInfo(this.sandbox);\n  }\n\n  async getUrl(options: { port: number; protocol?: string }): Promise<string> {\n    return await this.methods.getUrl(this.sandbox, options);\n  }\n\n  getProvider(): Provider<TSandbox> {\n    return this.providerInstance;\n  }\n\n  async destroy(): Promise<void> {\n    // Destroy via the provider's destroy method using our sandboxId\n    await this.destroyMethod(this.config, this.sandboxId);\n  }\n}\n\n/**\n * Determines the effective execution mode\n *\n * @param config - Runtime config (may contain `mode` override)\n * @param defaultMode - Provider's default mode\n * @returns The effective execution mode\n */\nfunction getEffectiveMode(config: BaseProviderConfig, defaultMode: 'direct' | 'gateway'): ProviderMode {\n  // If mode is explicitly set in config, use it\n  if (config.mode) {\n    return config.mode;\n  }\n\n  // Otherwise use provider's default mode\n  return defaultMode;\n}\n\n/**\n * Auto-generated Sandbox Manager implementation\n */\nclass GeneratedSandboxManager<TSandbox, TConfig> implements ProviderSandboxManager<TSandbox> {\n  private readonly effectiveMode: ProviderMode;\n\n  constructor(\n    private config: TConfig,\n    private providerName: string,\n    private methods: SandboxMethods<TSandbox, TConfig>,\n    private providerInstance: Provider,\n    defaultMode: 'direct' | 'gateway'\n  ) {\n    this.effectiveMode = getEffectiveMode(config as BaseProviderConfig, defaultMode);\n  }\n\n  async create(options?: CreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    // Default to 'node' runtime if not specified for consistency across providers\n    const optionsWithDefaults = { runtime: 'node' as Runtime, ...options };\n    const result = await this.methods.create(this.config, optionsWithDefaults);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async getById(sandboxId: string): Promise<ProviderSandbox<TSandbox> | null> {\n    const result = await this.methods.getById(this.config, sandboxId);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async list(): Promise<ProviderSandbox<TSandbox>[]> {\n    const results = await this.methods.list(this.config);\n    \n    return results.map(result => new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    ));\n  }\n\n  async destroy(sandboxId: string): Promise<void> {\n    await this.methods.destroy(this.config, sandboxId);\n  }\n\n  async findOrCreate(options: FindOrCreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    if (!this.methods.findOrCreate) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support findOrCreate.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.findOrCreate(this.config, options);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async find(options: FindSandboxOptions): Promise<ProviderSandbox<TSandbox> | null> {\n    if (!this.methods.find) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support find.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.find(this.config, options);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async extendTimeout(sandboxId: string, options?: ExtendTimeoutOptions): Promise<void> {\n    if (!this.methods.extendTimeout) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support extendTimeout.\\n` +\n        `This feature requires gateway provider with timeout extension support.`\n      );\n    }\n\n    await this.methods.extendTimeout(this.config, sandboxId, options);\n  }\n}\n\n/**\n * Auto-generated Template Manager implementation\n */\nclass GeneratedTemplateManager<TTemplate, TConfig, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> implements ProviderTemplateManager<TTemplate, TCreateOptions> {\n  constructor(\n    private config: TConfig,\n    private methods: TemplateMethods<TTemplate, TConfig, TCreateOptions>\n  ) {}\n\n  async create(options: TCreateOptions): Promise<TTemplate> {\n    return await this.methods.create(this.config, options);\n  }\n\n  async list(options?: ListTemplatesOptions): Promise<TTemplate[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(templateId: string): Promise<void> {\n    return await this.methods.delete(this.config, templateId);\n  }\n}\n\n/**\n * Auto-generated Snapshot Manager implementation\n */\nclass GeneratedSnapshotManager<TSnapshot, TConfig> implements ProviderSnapshotManager<TSnapshot> {\n  constructor(\n    private config: TConfig,\n    private methods: SnapshotMethods<TSnapshot, TConfig>\n  ) {}\n\n  async create(sandboxId: string, options?: CreateSnapshotOptions): Promise<TSnapshot> {\n    return await this.methods.create(this.config, sandboxId, options);\n  }\n\n  async list(options?: ListSnapshotsOptions): Promise<TSnapshot[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(snapshotId: string): Promise<void> {\n    return await this.methods.delete(this.config, snapshotId);\n  }\n}\n\n/**\n * Auto-generated Provider implementation\n */\nclass GeneratedProvider<TSandbox, TConfig, TTemplate, TSnapshot> implements Provider<TSandbox, TTemplate, TSnapshot> {\n  readonly name: string;\n  readonly sandbox: ProviderSandboxManager<TSandbox>;\n  readonly template?: ProviderTemplateManager<TTemplate>;\n  readonly snapshot?: ProviderSnapshotManager<TSnapshot>;\n\n  constructor(config: TConfig, providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>) {\n    this.name = providerConfig.name;\n    this.sandbox = new GeneratedSandboxManager(\n      config,\n      providerConfig.name,\n      providerConfig.methods.sandbox,\n      this,\n      providerConfig.defaultMode ?? 'gateway'\n    );\n\n    // Initialize optional managers if methods are provided\n    if (providerConfig.methods.template) {\n      this.template = new GeneratedTemplateManager(config, providerConfig.methods.template);\n    }\n    \n    if (providerConfig.methods.snapshot) {\n      this.snapshot = new GeneratedSnapshotManager(config, providerConfig.methods.snapshot);\n    }\n  }\n\n  getSupportedRuntimes(): Runtime[] {\n    // For now, all providers support both node and python\n    // In the future, this could be configurable per provider\n    return ['node', 'python'];\n  }\n}\n\n/**\n * Create a provider from method definitions\n *\n * Auto-generates all boilerplate classes and provides feature detection\n * based on which methods are implemented.\n */\nexport function defineProvider<TSandbox, TConfig = any, TTemplate = any, TSnapshot = any>(\n  providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>\n): (config: TConfig & BaseProviderConfig) => Provider<TSandbox, TTemplate, TSnapshot> {\n  return (config: TConfig & BaseProviderConfig) => {\n    return new GeneratedProvider(config, providerConfig);\n  };\n}","/**\n * Direct Mode Compute API\n * \n * Use this when you want to use providers directly without the gateway.\n * This is the \"mother\" talking directly to \"children\" providers.\n */\n\nimport type { Provider } from './types';\n\n/**\n * Configuration for creating a compute instance with a provider\n */\nexport interface CreateComputeConfig<TInstance = any> {\n  /** The provider instance to use */\n  defaultProvider?: Provider<TInstance>;\n  /** Legacy alias for defaultProvider */\n  provider?: Provider<TInstance>;\n}\n\n/**\n * Compute API for direct provider usage\n */\nexport interface ComputeAPI<TInstance = any> {\n  /** Sandbox management methods */\n  sandbox: Provider<TInstance>['sandbox'];\n  /** Get current configuration */\n  getConfig(): CreateComputeConfig<TInstance> | null;\n  /** Update configuration and return new compute instance */\n  setConfig<TNewInstance = any>(config: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance>;\n  /** Clear configuration */\n  clearConfig(): void;\n}\n\n/**\n * Create a compute instance with a provider for direct mode\n * \n * @example\n * ```typescript\n * import { createCompute } from '@computesdk/provider';\n * import { e2bProvider } from '@computesdk/e2b';\n * \n * const provider = e2bProvider({ apiKey: 'your-key' });\n * const compute = createCompute({ defaultProvider: provider });\n * \n * const sandbox = await compute.sandbox.create();\n * ```\n */\nexport function createCompute<TInstance = any>(\n  config: CreateComputeConfig<TInstance>\n): ComputeAPI<TInstance> {\n  const provider = config.defaultProvider || config.provider;\n  \n  if (!provider) {\n    throw new Error(\n      'createCompute requires a provider for direct mode. ' +\n      'Pass a provider via the defaultProvider or provider config property. ' +\n      'For gateway mode, do not use createCompute; use the compute singleton from computesdk instead.'\n    );\n  }\n\n  let currentConfig: CreateComputeConfig<TInstance> | null = config;\n\n  return {\n    sandbox: provider.sandbox,\n    \n    getConfig() {\n      return currentConfig;\n    },\n    \n    setConfig<TNewInstance = any>(newConfig: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance> {\n      return createCompute(newConfig);\n    },\n    \n    clearConfig() {\n      currentConfig = null;\n    }\n  };\n}\n","/**\n * Utility functions for ComputeSDK\n */\n\n/**\n * Calculate exponential backoff delay with jitter\n * \n * Uses exponential backoff (2^attempt) multiplied by base delay,\n * plus random jitter to prevent thundering herd.\n * \n * @param attempt - Current retry attempt (0-indexed)\n * @param baseDelay - Base delay in milliseconds (default: 1000)\n * @param jitterMax - Maximum random jitter in milliseconds (default: 100)\n * @returns Delay in milliseconds\n * \n * @example\n * ```typescript\n * // First retry: 1000-1100ms\n * calculateBackoff(0);\n * \n * // Second retry: 2000-2100ms\n * calculateBackoff(1);\n * \n * // Third retry: 4000-4100ms\n * calculateBackoff(2);\n * ```\n */\nexport function calculateBackoff(\n  attempt: number,\n  baseDelay: number = 1000,\n  jitterMax: number = 100\n): number {\n  return baseDelay * Math.pow(2, attempt) + Math.random() * jitterMax;\n}\n"],"mappings":";AA8BA,SAAS,WAAyB;AA2GlC,IAAM,wBAAN,MAAyD;AAAA,EAGvD,YAAY,cAAsB;AAChC,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,MAAM,SAAS,OAAgC;AAC7C,UAAM,IAAI,MAAM,8CAA8C,KAAK,YAAY,2BAA2B,KAAK,YAAY,kDAAkD;AAAA,EAC/K;AAAA,EAEA,MAAM,UAAU,OAAe,UAAiC;AAC9D,UAAM,IAAI,MAAM,8CAA8C,KAAK,YAAY,2BAA2B,KAAK,YAAY,kDAAkD;AAAA,EAC/K;AAAA,EAEA,MAAM,MAAM,OAA8B;AACxC,UAAM,IAAI,MAAM,8CAA8C,KAAK,YAAY,2BAA2B,KAAK,YAAY,kDAAkD;AAAA,EAC/K;AAAA,EAEA,MAAM,QAAQ,OAAqC;AACjD,UAAM,IAAI,MAAM,8CAA8C,KAAK,YAAY,2BAA2B,KAAK,YAAY,kDAAkD;AAAA,EAC/K;AAAA,EAEA,MAAM,OAAO,OAAiC;AAC5C,UAAM,IAAI,MAAM,8CAA8C,KAAK,YAAY,2BAA2B,KAAK,YAAY,kDAAkD;AAAA,EAC/K;AAAA,EAEA,MAAM,OAAO,OAA8B;AACzC,UAAM,IAAI,MAAM,8CAA8C,KAAK,YAAY,2BAA2B,KAAK,YAAY,kDAAkD;AAAA,EAC/K;AACF;AAOA,IAAM,sBAAN,MAAiE;AAAA,EAC/D,YACU,SACA,SACA,YACR;AAHQ;AACA;AACA;AAAA,EACP;AAAA,EAEH,MAAM,SAAS,MAA+B;AAC5C,WAAO,KAAK,QAAQ,SAAS,KAAK,SAAS,MAAM,KAAK,WAAW,UAAU;AAAA,EAC7E;AAAA,EAEA,MAAM,UAAU,MAAc,SAAgC;AAC5D,WAAO,KAAK,QAAQ,UAAU,KAAK,SAAS,MAAM,SAAS,KAAK,WAAW,UAAU;AAAA,EACvF;AAAA,EAEA,MAAM,MAAM,MAA6B;AACvC,WAAO,KAAK,QAAQ,MAAM,KAAK,SAAS,MAAM,KAAK,WAAW,UAAU;AAAA,EAC1E;AAAA,EAEA,MAAM,QAAQ,MAAoC;AAChD,WAAO,KAAK,QAAQ,QAAQ,KAAK,SAAS,MAAM,KAAK,WAAW,UAAU;AAAA,EAC5E;AAAA,EAEA,MAAM,OAAO,MAAgC;AAC3C,WAAO,KAAK,QAAQ,OAAO,KAAK,SAAS,MAAM,KAAK,WAAW,UAAU;AAAA,EAC3E;AAAA,EAEA,MAAM,OAAO,MAA6B;AACxC,WAAO,KAAK,QAAQ,OAAO,KAAK,SAAS,MAAM,KAAK,WAAW,UAAU;AAAA,EAC3E;AACF;AASA,IAAM,mBAAN,MAA4E;AAAA,EAK1E,YACU,SACR,WACA,cACQ,SACA,QACA,eACA,kBACR;AAPQ;AAGA;AACA;AACA;AACA;AAER,SAAK,YAAY;AACjB,SAAK,WAAW;AAGhB,QAAI,QAAQ,YAAY;AACtB,WAAK,aAAa,IAAI,oBAAoB,SAAS,QAAQ,YAAY,OAAO;AAAA,IAChF,OAAO;AACL,WAAK,aAAa,IAAI,sBAAsB,YAAY;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,cAAwB;AAEtB,QAAI,KAAK,QAAQ,aAAa;AAC5B,aAAO,KAAK,QAAQ,YAAY,KAAK,OAAO;AAAA,IAC9C;AAEA,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,QAAQ,MAAc,SAAwC;AAClE,WAAO,MAAM,KAAK,QAAQ,QAAQ,KAAK,SAAS,MAAM,SAAS,KAAK,MAAM;AAAA,EAC5E;AAAA,EAEA,MAAM,WACJ,gBACA,eACA,cACwB;AAExB,QAAI;AACJ,QAAI;AACJ,QAAI;AAEJ,QAAI,MAAM,QAAQ,cAAc,GAAG;AAEjC,OAAC,SAAS,GAAG,IAAI,IAAI;AACrB,gBAAU;AAAA,IACZ,OAAO;AAEL,gBAAU;AACV,aAAQ,MAAM,QAAQ,aAAa,IAAI,gBAAgB,CAAC;AACxD,gBAAU,MAAM,QAAQ,aAAa,IAAI,eAAe;AAAA,IAC1D;AAGA,UAAM,cAAuB,KAAK,SAAS,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO;AAG5E,QAAI,SAAS,OAAO,SAAS,YAAY;AACvC,YAAM,iBAAiB,IAAI,aAAa;AAAA,QACtC,KAAK,QAAQ;AAAA,QACb,YAAY,QAAQ;AAAA,MACtB,CAAC;AACD,YAAM,CAAC,YAAY,GAAG,WAAW,IAAI;AACrC,aAAO,MAAM,KAAK,QAAQ,WAAW,KAAK,SAAS,YAAY,aAAa,MAAS;AAAA,IACvF;AAEA,WAAO,MAAM,KAAK,QAAQ,WAAW,KAAK,SAAS,SAAS,MAAM,OAAO;AAAA,EAC3E;AAAA,EAEA,MAAM,UAAgC;AACpC,WAAO,MAAM,KAAK,QAAQ,QAAQ,KAAK,OAAO;AAAA,EAChD;AAAA,EAEA,MAAM,OAAO,SAA+D;AAC1E,WAAO,MAAM,KAAK,QAAQ,OAAO,KAAK,SAAS,OAAO;AAAA,EACxD;AAAA,EAEA,cAAkC;AAChC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,UAAyB;AAE7B,UAAM,KAAK,cAAc,KAAK,QAAQ,KAAK,SAAS;AAAA,EACtD;AACF;AASA,SAAS,iBAAiB,QAA4B,aAAiD;AAErG,MAAI,OAAO,MAAM;AACf,WAAO,OAAO;AAAA,EAChB;AAGA,SAAO;AACT;AAKA,IAAM,0BAAN,MAA6F;AAAA,EAG3F,YACU,QACA,cACA,SACA,kBACR,aACA;AALQ;AACA;AACA;AACA;AAGR,SAAK,gBAAgB,iBAAiB,QAA8B,WAAW;AAAA,EACjF;AAAA,EAEA,MAAM,OAAO,SAAoE;AAE/E,UAAM,sBAAsB,EAAE,SAAS,QAAmB,GAAG,QAAQ;AACrE,UAAM,SAAS,MAAM,KAAK,QAAQ,OAAO,KAAK,QAAQ,mBAAmB;AAEzE,WAAO,IAAI;AAAA,MACT,OAAO;AAAA,MACP,OAAO;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK,QAAQ;AAAA,MACb,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,QAAQ,WAA8D;AAC1E,UAAM,SAAS,MAAM,KAAK,QAAQ,QAAQ,KAAK,QAAQ,SAAS;AAChE,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,WAAO,IAAI;AAAA,MACT,OAAO;AAAA,MACP,OAAO;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK,QAAQ;AAAA,MACb,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,OAA6C;AACjD,UAAM,UAAU,MAAM,KAAK,QAAQ,KAAK,KAAK,MAAM;AAEnD,WAAO,QAAQ,IAAI,YAAU,IAAI;AAAA,MAC/B,OAAO;AAAA,MACP,OAAO;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK,QAAQ;AAAA,MACb,KAAK;AAAA,IACP,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,QAAQ,WAAkC;AAC9C,UAAM,KAAK,QAAQ,QAAQ,KAAK,QAAQ,SAAS;AAAA,EACnD;AAAA,EAEA,MAAM,aAAa,SAAyE;AAC1F,QAAI,CAAC,KAAK,QAAQ,cAAc;AAC9B,YAAM,IAAI;AAAA,QACR,aAAa,KAAK,YAAY;AAAA;AAAA,MAEhC;AAAA,IACF;AAEA,UAAM,SAAS,MAAM,KAAK,QAAQ,aAAa,KAAK,QAAQ,OAAO;AAEnE,WAAO,IAAI;AAAA,MACT,OAAO;AAAA,MACP,OAAO;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK,QAAQ;AAAA,MACb,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,SAAwE;AACjF,QAAI,CAAC,KAAK,QAAQ,MAAM;AACtB,YAAM,IAAI;AAAA,QACR,aAAa,KAAK,YAAY;AAAA;AAAA,MAEhC;AAAA,IACF;AAEA,UAAM,SAAS,MAAM,KAAK,QAAQ,KAAK,KAAK,QAAQ,OAAO;AAC3D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,WAAO,IAAI;AAAA,MACT,OAAO;AAAA,MACP,OAAO;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK,QAAQ;AAAA,MACb,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,WAAmB,SAA+C;AACpF,QAAI,CAAC,KAAK,QAAQ,eAAe;AAC/B,YAAM,IAAI;AAAA,QACR,aAAa,KAAK,YAAY;AAAA;AAAA,MAEhC;AAAA,IACF;AAEA,UAAM,KAAK,QAAQ,cAAc,KAAK,QAAQ,WAAW,OAAO;AAAA,EAClE;AACF;AAKA,IAAM,2BAAN,MAAuL;AAAA,EACrL,YACU,QACA,SACR;AAFQ;AACA;AAAA,EACP;AAAA,EAEH,MAAM,OAAO,SAA6C;AACxD,WAAO,MAAM,KAAK,QAAQ,OAAO,KAAK,QAAQ,OAAO;AAAA,EACvD;AAAA,EAEA,MAAM,KAAK,SAAsD;AAC/D,WAAO,MAAM,KAAK,QAAQ,KAAK,KAAK,QAAQ,OAAO;AAAA,EACrD;AAAA,EAEA,MAAM,OAAO,YAAmC;AAC9C,WAAO,MAAM,KAAK,QAAQ,OAAO,KAAK,QAAQ,UAAU;AAAA,EAC1D;AACF;AAKA,IAAM,2BAAN,MAAiG;AAAA,EAC/F,YACU,QACA,SACR;AAFQ;AACA;AAAA,EACP;AAAA,EAEH,MAAM,OAAO,WAAmB,SAAqD;AACnF,WAAO,MAAM,KAAK,QAAQ,OAAO,KAAK,QAAQ,WAAW,OAAO;AAAA,EAClE;AAAA,EAEA,MAAM,KAAK,SAAsD;AAC/D,WAAO,MAAM,KAAK,QAAQ,KAAK,KAAK,QAAQ,OAAO;AAAA,EACrD;AAAA,EAEA,MAAM,OAAO,YAAmC;AAC9C,WAAO,MAAM,KAAK,QAAQ,OAAO,KAAK,QAAQ,UAAU;AAAA,EAC1D;AACF;AAKA,IAAM,oBAAN,MAAqH;AAAA,EAMnH,YAAY,QAAiB,gBAAyE;AACpG,SAAK,OAAO,eAAe;AAC3B,SAAK,UAAU,IAAI;AAAA,MACjB;AAAA,MACA,eAAe;AAAA,MACf,eAAe,QAAQ;AAAA,MACvB;AAAA,MACA,eAAe,eAAe;AAAA,IAChC;AAGA,QAAI,eAAe,QAAQ,UAAU;AACnC,WAAK,WAAW,IAAI,yBAAyB,QAAQ,eAAe,QAAQ,QAAQ;AAAA,IACtF;AAEA,QAAI,eAAe,QAAQ,UAAU;AACnC,WAAK,WAAW,IAAI,yBAAyB,QAAQ,eAAe,QAAQ,QAAQ;AAAA,IACtF;AAAA,EACF;AAAA,EAEA,uBAAkC;AAGhC,WAAO,CAAC,QAAQ,QAAQ;AAAA,EAC1B;AACF;AAQO,SAAS,eACd,gBACoF;AACpF,SAAO,CAAC,WAAyC;AAC/C,WAAO,IAAI,kBAAkB,QAAQ,cAAc;AAAA,EACrD;AACF;;;AC5eO,SAAS,cACd,QACuB;AACvB,QAAM,WAAW,OAAO,mBAAmB,OAAO;AAElD,MAAI,CAAC,UAAU;AACb,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AAEA,MAAI,gBAAuD;AAE3D,SAAO;AAAA,IACL,SAAS,SAAS;AAAA,IAElB,YAAY;AACV,aAAO;AAAA,IACT;AAAA,IAEA,UAA8B,WAAwE;AACpG,aAAO,cAAc,SAAS;AAAA,IAChC;AAAA,IAEA,cAAc;AACZ,sBAAgB;AAAA,IAClB;AAAA,EACF;AACF;;;AClDO,SAAS,iBACd,SACA,YAAoB,KACpB,YAAoB,KACZ;AACR,SAAO,YAAY,KAAK,IAAI,GAAG,OAAO,IAAI,KAAK,OAAO,IAAI;AAC5D;","names":[]}
+{"version":3,"sources":["../src/factory.ts","../src/compute.ts","../src/utils.ts"],"sourcesContent":["/**\n * Provider Factory - Creates providers from method definitions\n * \n * Eliminates boilerplate by auto-generating Provider/Sandbox classes\n * from simple method definitions with automatic feature detection.\n */\n\n// Import all types from local types\nimport type {\n  Runtime,\n  CreateSandboxOptions,\n  FileEntry,\n  RunCommandOptions,\n  SandboxFileSystem,\n  Provider,\n  ProviderSandboxManager,\n  ProviderTemplateManager,\n  ProviderSnapshotManager,\n  ProviderSandbox,\n  SandboxInfo,\n  CodeResult,\n  CommandResult,\n  CreateSnapshotOptions,\n  ListSnapshotsOptions,\n  CreateTemplateOptions,\n  ListTemplatesOptions,\n  FindOrCreateSandboxOptions,\n  FindSandboxOptions,\n  ExtendTimeoutOptions,\n} from './types/index.js';\n\n/**\n * Flat sandbox method implementations - all operations in one place\n */\nexport interface SandboxMethods<TSandbox = any, TConfig = any> {\n  // Collection operations (map to compute.sandbox.*)\n  create: (config: TConfig, options?: CreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  getById: (config: TConfig, sandboxId: string) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  list: (config: TConfig) => Promise<Array<{ sandbox: TSandbox; sandboxId: string }>>;\n  destroy: (config: TConfig, sandboxId: string) => Promise<void>;\n\n  // Optional named sandbox operations\n  findOrCreate?: (config: TConfig, options: FindOrCreateSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string }>;\n  find?: (config: TConfig, options: FindSandboxOptions) => Promise<{ sandbox: TSandbox; sandboxId: string } | null>;\n  \n  // Optional timeout management\n  extendTimeout?: (config: TConfig, sandboxId: string, options?: ExtendTimeoutOptions) => Promise<void>;\n\n  // Instance operations\n  runCode: (sandbox: TSandbox, code: string, runtime?: Runtime, config?: TConfig) => Promise<CodeResult>;\n  runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>;\n  getInfo: (sandbox: TSandbox) => Promise<SandboxInfo>;\n  getUrl: (sandbox: TSandbox, options: { port: number; protocol?: string }) => Promise<string>;\n\n  // Optional provider-specific typed getInstance method\n  getInstance?: (sandbox: TSandbox) => TSandbox;\n\n  // Optional filesystem methods\n  filesystem?: {\n    readFile: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<string>;\n    writeFile: (sandbox: TSandbox, path: string, content: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;\n    mkdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;\n    readdir: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<FileEntry[]>;\n    exists: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<boolean>;\n    remove: (sandbox: TSandbox, path: string, runCommand: (sandbox: TSandbox, command: string, options?: RunCommandOptions) => Promise<CommandResult>) => Promise<void>;\n  };\n}\n\n/**\n * Template method implementations\n */\nexport interface TemplateMethods<TTemplate = any, TConfig = any, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> {\n  create: (config: TConfig, options: TCreateOptions) => Promise<TTemplate>;\n  list: (config: TConfig, options?: ListTemplatesOptions) => Promise<TTemplate[]>;\n  delete: (config: TConfig, templateId: string) => Promise<void>;\n}\n\n/**\n * Snapshot method implementations  \n */\nexport interface SnapshotMethods<TSnapshot = any, TConfig = any> {\n  create: (config: TConfig, sandboxId: string, options?: CreateSnapshotOptions) => Promise<TSnapshot>;\n  list: (config: TConfig, options?: ListSnapshotsOptions) => Promise<TSnapshot[]>;\n  delete: (config: TConfig, snapshotId: string) => Promise<void>;\n}\n\n/**\n * Provider execution modes\n *\n * - 'raw': Use raw provider methods directly (for gateway internal use)\n * - 'direct': Use provider's native SDK directly (for providers with sandbox capabilities)\n * - 'gateway': Route through ComputeSDK gateway (for providers without native sandbox)\n */\nexport type ProviderMode = 'raw' | 'direct' | 'gateway';\n\n/**\n * Provider configuration for defineProvider()\n */\nexport interface ProviderConfig<TSandbox = any, TConfig = any, TTemplate = any, TSnapshot = any> {\n  name: string;\n  /**\n   * Default execution mode for this provider (defaults to 'gateway' if not specified)\n   *\n   * - 'direct': Provider has native sandbox capabilities (e.g., E2B) - uses provider SDK directly\n   * - 'gateway': Provider only has infrastructure (e.g., Railway) - routes through gateway\n   *\n   * Can be overridden at runtime with `mode` in config.\n   */\n  defaultMode?: 'direct' | 'gateway';\n  methods: {\n    sandbox: SandboxMethods<TSandbox, TConfig>;\n    template?: TemplateMethods<TTemplate, TConfig>;\n    snapshot?: SnapshotMethods<TSnapshot, TConfig>;\n  };\n}\n\n/**\n * Base config that all provider configs should extend\n * Includes the `mode` option for controlling execution mode\n */\nexport interface BaseProviderConfig {\n  /**\n   * Execution mode override\n   *\n   * - 'raw': Use raw provider methods directly (for gateway internal use)\n   * - 'direct': Use provider's native SDK directly\n   * - 'gateway': Route through ComputeSDK gateway\n   *\n   * If not specified, uses the provider's `defaultMode`.\n   */\n  mode?: ProviderMode;\n}\n\n/**\n * Auto-generated filesystem implementation that throws \"not supported\" errors\n */\nclass UnsupportedFileSystem implements SandboxFileSystem {\n  private readonly providerName: string;\n\n  constructor(providerName: string) {\n    this.providerName = providerName;\n  }\n\n  async readFile(_path: string): Promise<string> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async writeFile(_path: string, _content: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async mkdir(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async readdir(_path: string): Promise<FileEntry[]> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async exists(_path: string): Promise<boolean> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n\n  async remove(_path: string): Promise<void> {\n    throw new Error(`Filesystem operations are not supported by ${this.providerName}'s sandbox environment. ${this.providerName} sandboxes are designed for code execution only.`);\n  }\n}\n\n\n\n/**\n * Auto-generated filesystem implementation that wraps provider methods\n */\nclass SupportedFileSystem<TSandbox> implements SandboxFileSystem {\n  constructor(\n    private sandbox: TSandbox,\n    private methods: NonNullable<SandboxMethods<TSandbox>['filesystem']>,\n    private allMethods: SandboxMethods<TSandbox>\n  ) {}\n\n  async readFile(path: string): Promise<string> {\n    return this.methods.readFile(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async writeFile(path: string, content: string): Promise<void> {\n    return this.methods.writeFile(this.sandbox, path, content, this.allMethods.runCommand);\n  }\n\n  async mkdir(path: string): Promise<void> {\n    return this.methods.mkdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async readdir(path: string): Promise<FileEntry[]> {\n    return this.methods.readdir(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.methods.exists(this.sandbox, path, this.allMethods.runCommand);\n  }\n\n  async remove(path: string): Promise<void> {\n    return this.methods.remove(this.sandbox, path, this.allMethods.runCommand);\n  }\n}\n\n\n\n\n\n/**\n * Generated sandbox class - implements the ProviderSandbox interface\n */\nclass GeneratedSandbox<TSandbox = any> implements ProviderSandbox<TSandbox> {\n  readonly sandboxId: string;\n  readonly provider: string;\n  readonly filesystem: SandboxFileSystem;\n\n  constructor(\n    private sandbox: TSandbox,\n    sandboxId: string,\n    providerName: string,\n    private methods: SandboxMethods<TSandbox>,\n    private config: any,\n    private destroyMethod: (config: any, sandboxId: string) => Promise<void>,\n    private providerInstance: Provider\n  ) {\n    this.sandboxId = sandboxId;\n    this.provider = providerName;\n\n    // Auto-detect filesystem support\n    if (methods.filesystem) {\n      this.filesystem = new SupportedFileSystem(sandbox, methods.filesystem, methods);\n    } else {\n      this.filesystem = new UnsupportedFileSystem(providerName);\n    }\n  }\n\n  getInstance(): TSandbox {\n    // Use provider-specific typed getInstance if available\n    if (this.methods.getInstance) {\n      return this.methods.getInstance(this.sandbox);\n    }\n    // Fallback to returning the sandbox directly\n    return this.sandbox;\n  }\n\n  async runCode(code: string, runtime?: Runtime): Promise<CodeResult> {\n    return await this.methods.runCode(this.sandbox, code, runtime, this.config);\n  }\n\n  async runCommand(\n    command: string,\n    options?: RunCommandOptions\n  ): Promise<CommandResult> {\n    // Pass command and options directly to provider - no preprocessing\n    // Provider is responsible for handling cwd, env, background, etc.\n    return await this.methods.runCommand(this.sandbox, command, options);\n  }\n\n  async getInfo(): Promise<SandboxInfo> {\n    return await this.methods.getInfo(this.sandbox);\n  }\n\n  async getUrl(options: { port: number; protocol?: string }): Promise<string> {\n    return await this.methods.getUrl(this.sandbox, options);\n  }\n\n  getProvider(): Provider<TSandbox> {\n    return this.providerInstance;\n  }\n\n  async destroy(): Promise<void> {\n    // Destroy via the provider's destroy method using our sandboxId\n    await this.destroyMethod(this.config, this.sandboxId);\n  }\n}\n\n/**\n * Determines the effective execution mode\n *\n * @param config - Runtime config (may contain `mode` override)\n * @param defaultMode - Provider's default mode\n * @returns The effective execution mode\n */\nfunction getEffectiveMode(config: BaseProviderConfig, defaultMode: 'direct' | 'gateway'): ProviderMode {\n  // If mode is explicitly set in config, use it\n  if (config.mode) {\n    return config.mode;\n  }\n\n  // Otherwise use provider's default mode\n  return defaultMode;\n}\n\n/**\n * Auto-generated Sandbox Manager implementation\n */\nclass GeneratedSandboxManager<TSandbox, TConfig> implements ProviderSandboxManager<TSandbox> {\n  private readonly effectiveMode: ProviderMode;\n\n  constructor(\n    private config: TConfig,\n    private providerName: string,\n    private methods: SandboxMethods<TSandbox, TConfig>,\n    private providerInstance: Provider,\n    defaultMode: 'direct' | 'gateway'\n  ) {\n    this.effectiveMode = getEffectiveMode(config as BaseProviderConfig, defaultMode);\n  }\n\n  async create(options?: CreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    // Default to 'node' runtime if not specified for consistency across providers\n    const optionsWithDefaults = { runtime: 'node' as Runtime, ...options };\n    const result = await this.methods.create(this.config, optionsWithDefaults);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async getById(sandboxId: string): Promise<ProviderSandbox<TSandbox> | null> {\n    const result = await this.methods.getById(this.config, sandboxId);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async list(): Promise<ProviderSandbox<TSandbox>[]> {\n    const results = await this.methods.list(this.config);\n    \n    return results.map(result => new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    ));\n  }\n\n  async destroy(sandboxId: string): Promise<void> {\n    await this.methods.destroy(this.config, sandboxId);\n  }\n\n  async findOrCreate(options: FindOrCreateSandboxOptions): Promise<ProviderSandbox<TSandbox>> {\n    if (!this.methods.findOrCreate) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support findOrCreate.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.findOrCreate(this.config, options);\n    \n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async find(options: FindSandboxOptions): Promise<ProviderSandbox<TSandbox> | null> {\n    if (!this.methods.find) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support find.\\n` +\n        `This feature requires gateway provider with named sandbox support.`\n      );\n    }\n\n    const result = await this.methods.find(this.config, options);\n    if (!result) {\n      return null;\n    }\n\n    return new GeneratedSandbox<TSandbox>(\n      result.sandbox,\n      result.sandboxId,\n      this.providerName,\n      this.methods,\n      this.config,\n      this.methods.destroy,\n      this.providerInstance\n    );\n  }\n\n  async extendTimeout(sandboxId: string, options?: ExtendTimeoutOptions): Promise<void> {\n    if (!this.methods.extendTimeout) {\n      throw new Error(\n        `Provider '${this.providerName}' does not support extendTimeout.\\n` +\n        `This feature requires gateway provider with timeout extension support.`\n      );\n    }\n\n    await this.methods.extendTimeout(this.config, sandboxId, options);\n  }\n}\n\n/**\n * Auto-generated Template Manager implementation\n */\nclass GeneratedTemplateManager<TTemplate, TConfig, TCreateOptions extends CreateTemplateOptions = CreateTemplateOptions> implements ProviderTemplateManager<TTemplate, TCreateOptions> {\n  constructor(\n    private config: TConfig,\n    private methods: TemplateMethods<TTemplate, TConfig, TCreateOptions>\n  ) {}\n\n  async create(options: TCreateOptions): Promise<TTemplate> {\n    return await this.methods.create(this.config, options);\n  }\n\n  async list(options?: ListTemplatesOptions): Promise<TTemplate[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(templateId: string): Promise<void> {\n    return await this.methods.delete(this.config, templateId);\n  }\n}\n\n/**\n * Auto-generated Snapshot Manager implementation\n */\nclass GeneratedSnapshotManager<TSnapshot, TConfig> implements ProviderSnapshotManager<TSnapshot> {\n  constructor(\n    private config: TConfig,\n    private methods: SnapshotMethods<TSnapshot, TConfig>\n  ) {}\n\n  async create(sandboxId: string, options?: CreateSnapshotOptions): Promise<TSnapshot> {\n    return await this.methods.create(this.config, sandboxId, options);\n  }\n\n  async list(options?: ListSnapshotsOptions): Promise<TSnapshot[]> {\n    return await this.methods.list(this.config, options);\n  }\n\n  async delete(snapshotId: string): Promise<void> {\n    return await this.methods.delete(this.config, snapshotId);\n  }\n}\n\n/**\n * Auto-generated Provider implementation\n */\nclass GeneratedProvider<TSandbox, TConfig, TTemplate, TSnapshot> implements Provider<TSandbox, TTemplate, TSnapshot> {\n  readonly name: string;\n  readonly sandbox: ProviderSandboxManager<TSandbox>;\n  readonly template?: ProviderTemplateManager<TTemplate>;\n  readonly snapshot?: ProviderSnapshotManager<TSnapshot>;\n\n  constructor(config: TConfig, providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>) {\n    this.name = providerConfig.name;\n    this.sandbox = new GeneratedSandboxManager(\n      config,\n      providerConfig.name,\n      providerConfig.methods.sandbox,\n      this,\n      providerConfig.defaultMode ?? 'gateway'\n    );\n\n    // Initialize optional managers if methods are provided\n    if (providerConfig.methods.template) {\n      this.template = new GeneratedTemplateManager(config, providerConfig.methods.template);\n    }\n    \n    if (providerConfig.methods.snapshot) {\n      this.snapshot = new GeneratedSnapshotManager(config, providerConfig.methods.snapshot);\n    }\n  }\n\n  getSupportedRuntimes(): Runtime[] {\n    // For now, all providers support both node and python\n    // In the future, this could be configurable per provider\n    return ['node', 'python'];\n  }\n}\n\n/**\n * Create a provider from method definitions\n *\n * Auto-generates all boilerplate classes and provides feature detection\n * based on which methods are implemented.\n */\nexport function defineProvider<TSandbox, TConfig = any, TTemplate = any, TSnapshot = any>(\n  providerConfig: ProviderConfig<TSandbox, TConfig, TTemplate, TSnapshot>\n): (config: TConfig & BaseProviderConfig) => Provider<TSandbox, TTemplate, TSnapshot> {\n  return (config: TConfig & BaseProviderConfig) => {\n    return new GeneratedProvider(config, providerConfig);\n  };\n}","/**\n * Direct Mode Compute API\n * \n * Use this when you want to use providers directly without the gateway.\n * This is the \"mother\" talking directly to \"children\" providers.\n */\n\nimport type { Provider } from './types';\n\n/**\n * Configuration for creating a compute instance with a provider\n */\nexport interface CreateComputeConfig<TInstance = any> {\n  /** The provider instance to use */\n  defaultProvider?: Provider<TInstance>;\n  /** Legacy alias for defaultProvider */\n  provider?: Provider<TInstance>;\n}\n\n/**\n * Compute API for direct provider usage\n */\nexport interface ComputeAPI<TInstance = any> {\n  /** Sandbox management methods */\n  sandbox: Provider<TInstance>['sandbox'];\n  /** Get current configuration */\n  getConfig(): CreateComputeConfig<TInstance> | null;\n  /** Update configuration and return new compute instance */\n  setConfig<TNewInstance = any>(config: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance>;\n  /** Clear configuration */\n  clearConfig(): void;\n}\n\n/**\n * Create a compute instance with a provider for direct mode\n * \n * @example\n * ```typescript\n * import { createCompute } from '@computesdk/provider';\n * import { e2bProvider } from '@computesdk/e2b';\n * \n * const provider = e2bProvider({ apiKey: 'your-key' });\n * const compute = createCompute({ defaultProvider: provider });\n * \n * const sandbox = await compute.sandbox.create();\n * ```\n */\nexport function createCompute<TInstance = any>(\n  config: CreateComputeConfig<TInstance>\n): ComputeAPI<TInstance> {\n  const provider = config.defaultProvider || config.provider;\n  \n  if (!provider) {\n    throw new Error(\n      'createCompute requires a provider for direct mode. ' +\n      'Pass a provider via the defaultProvider or provider config property. ' +\n      'For gateway mode, do not use createCompute; use the compute singleton from computesdk instead.'\n    );\n  }\n\n  let currentConfig: CreateComputeConfig<TInstance> | null = config;\n\n  return {\n    sandbox: provider.sandbox,\n    \n    getConfig() {\n      return currentConfig;\n    },\n    \n    setConfig<TNewInstance = any>(newConfig: CreateComputeConfig<TNewInstance>): ComputeAPI<TNewInstance> {\n      return createCompute(newConfig);\n    },\n    \n    clearConfig() {\n      currentConfig = null;\n    }\n  };\n}\n","/**\n * Utility functions for ComputeSDK\n */\n\n/**\n * Calculate exponential backoff delay with jitter\n * \n * Uses exponential backoff (2^attempt) multiplied by base delay,\n * plus random jitter to prevent thundering herd.\n * \n * @param attempt - Current retry attempt (0-indexed)\n * @param baseDelay - Base delay in milliseconds (default: 1000)\n * @param jitterMax - Maximum random jitter in milliseconds (default: 100)\n * @returns Delay in milliseconds\n * \n * @example\n * ```typescript\n * // First retry: 1000-1100ms\n * calculateBackoff(0);\n * \n * // Second retry: 2000-2100ms\n * calculateBackoff(1);\n * \n * // Third retry: 4000-4100ms\n * calculateBackoff(2);\n * ```\n */\nexport function calculateBackoff(\n  attempt: number,\n  baseDelay: number = 1000,\n  jitterMax: number = 100\n): number {\n  return baseDelay * Math.pow(2, attempt) + Math.random() * jitterMax;\n}\n\n/**\n * Escapes a string for safe use in shell commands\n * \n * Escapes special shell characters to prevent command injection.\n * Use this when interpolating user-controlled values into shell commands.\n * \n * @param arg - The string to escape\n * @returns Escaped string safe for shell interpolation\n * \n * @example\n * ```typescript\n * const path = '/path/with spaces';\n * const command = `cd \"${escapeShellArg(path)}\" && ls`;\n * // Result: cd \"/path/with\\ spaces\" && ls\n * \n * const env = { KEY: 'value with $pecial chars' };\n * const command = `KEY=\"${escapeShellArg(env.KEY)}\" npm run build`;\n * // Result: KEY=\"value with \\$pecial chars\" npm run build\n * ```\n */\nexport function escapeShellArg(arg: string): string {\n  return arg\n    .replace(/\\\\/g, '\\\\\\\\')  // Escape backslashes\n    .replace(/\"/g, '\\\\\"')    // Escape double quotes\n    .replace(/\\$/g, '\\\\$')   // Escape dollar signs (variable expansion)\n    .replace(/`/g, '\\\\`');   // Escape backticks (command substitution)\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@computesdk/provider",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Provider framework for ComputeSDK - define custom sandbox providers",
   "author": "Garrison",
   "license": "MIT",