@hasna/sandboxes 0.1.8 → 0.1.10

package/dist/mcp/index.js

@@ -147,10 +147,11 @@ class E2BProvider {
         onStderr: opts?.onStderr ? (data) => opts.onStderr(data) : undefined,
         envs: opts?.env,
         cwd: opts?.cwd,
-        timeoutMs: opts?.timeout ? opts.timeout * 1000 : undefined
+        timeoutMs: opts?.timeout ? opts.timeout * 1000 : undefined,
+        ...opts?.stdin !== undefined ? { stdin: opts.stdin } : {}
       });
       return {
-        exit_code: result.exitCode,
+        exit_code: result.exitCode ?? 0,
         stdout: result.stdout,
         stderr: result.stderr
       };
@@ -158,10 +159,28 @@ class E2BProvider {
       throw new ProviderError("e2b", `Failed to exec command: ${err.message}`);
     }
   }
-  async readFile(sandboxId, path) {
+  async readFile(sandboxId, path, opts) {
     const sandbox = await this.getInstance(sandboxId);
     try {
-      return await sandbox.files.read(path, { format: "text" });
+      if (opts?.encoding === "base64") {
+        const bytes = await sandbox.files.read(path, { format: "bytes" });
+        const sliced = opts.offset !== undefined || opts.limit !== undefined ? bytes.slice(opts.offset ?? 0, opts.limit !== undefined ? (opts.offset ?? 0) + opts.limit : undefined) : bytes;
+        return Buffer.from(sliced).toString("base64");
+      } else if (opts?.encoding === "hex") {
+        const bytes = await sandbox.files.read(path, { format: "bytes" });
+        const sliced = opts.offset !== undefined || opts.limit !== undefined ? bytes.slice(opts.offset ?? 0, opts.limit !== undefined ? (opts.offset ?? 0) + opts.limit : undefined) : bytes;
+        return Buffer.from(sliced).toString("hex");
+      } else {
+        const content = await sandbox.files.read(path, { format: "text" });
+        if (opts?.offset !== undefined || opts?.limit !== undefined) {
+          const lines = content.split(`
+`);
+          const sliced = lines.slice(opts.offset ?? 0, opts.limit !== undefined ? (opts.offset ?? 0) + opts.limit : undefined);
+          return sliced.join(`
+`);
+        }
+        return content;
+      }
     } catch (err) {
       throw new ProviderError("e2b", `Failed to read file ${path}: ${err.message}`);
     }
@@ -174,9 +193,21 @@ class E2BProvider {
       throw new ProviderError("e2b", `Failed to write file ${path}: ${err.message}`);
     }
   }
-  async listFiles(sandboxId, path) {
+  async listFiles(sandboxId, path, opts) {
     const sandbox = await this.getInstance(sandboxId);
     try {
+      if (opts?.recursive || opts?.glob) {
+        const pattern = opts.glob ? opts.glob : "*";
+        const cmd = opts.recursive ? `find ${JSON.stringify(path)} -name ${JSON.stringify(pattern)} 2>/dev/null | head -500` : `ls -la ${JSON.stringify(path)}/${pattern} 2>/dev/null`;
+        const result = await sandbox.commands.run(cmd);
+        return result.stdout.trim().split(`
+`).filter(Boolean).map((p) => ({
+          path: p.trim(),
+          name: p.trim().split("/").pop() || p.trim(),
+          is_dir: false,
+          size: 0
+        }));
+      }
       const entries = await sandbox.files.list(path);
       return entries.map((e) => ({
         path: e.path,
@@ -4822,6 +4853,12 @@ CREATE TABLE IF NOT EXISTS snapshots (
 );
 CREATE INDEX IF NOT EXISTS idx_snapshots_sandbox ON snapshots(sandbox_id);
 INSERT OR IGNORE INTO _migrations (id) VALUES (4);
+  `,
+  `
+ALTER TABLE sandboxes ADD COLUMN budget_limit_usd REAL;
+ALTER TABLE sandboxes ADD COLUMN on_budget_exceeded TEXT NOT NULL DEFAULT 'terminate' CHECK(on_budget_exceeded IN ('terminate', 'pause', 'notify'));
+ALTER TABLE sandboxes ADD COLUMN started_at TEXT;
+INSERT OR IGNORE INTO _migrations (id) VALUES (5);
   `
 ];
 var db = null;
@@ -4882,6 +4919,9 @@ function rowToSandbox(row) {
     project_id: row.project_id,
     on_timeout: row.on_timeout ?? "terminate",
     auto_resume: row.auto_resume === 1,
+    budget_limit_usd: row.budget_limit_usd ?? null,
+    on_budget_exceeded: row.on_budget_exceeded ?? "terminate",
+    started_at: row.started_at ?? null,
     created_at: row.created_at,
     updated_at: row.updated_at
   };
@@ -4899,8 +4939,10 @@ function createSandbox(input) {
   const project_id = input.project_id ?? null;
   const on_timeout = input.on_timeout ?? "terminate";
   const auto_resume = input.auto_resume ? 1 : 0;
-  db2.query(`INSERT INTO sandboxes (id, provider, name, status, image, timeout, config, env_vars, project_id, on_timeout, auto_resume, created_at, updated_at)
-     VALUES (?, ?, ?, 'creating', ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, provider, name, image, timeout, config, env_vars, project_id, on_timeout, auto_resume, timestamp, timestamp);
+  const budget_limit_usd = input.budget_limit_usd ?? null;
+  const on_budget_exceeded = input.on_budget_exceeded ?? "terminate";
+  db2.query(`INSERT INTO sandboxes (id, provider, name, status, image, timeout, config, env_vars, project_id, on_timeout, auto_resume, budget_limit_usd, on_budget_exceeded, created_at, updated_at)
+     VALUES (?, ?, ?, 'creating', ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, provider, name, image, timeout, config, env_vars, project_id, on_timeout, auto_resume, budget_limit_usd, on_budget_exceeded, timestamp, timestamp);
   return getSandbox(id);
 }
 function getSandbox(id) {
@@ -4972,6 +5014,10 @@ function updateSandbox(id, updates) {
     setClauses.push("keep_alive_until = ?");
     params.push(updates.keep_alive_until);
   }
+  if (updates.started_at !== undefined) {
+    setClauses.push("started_at = ?");
+    params.push(updates.started_at);
+  }
   if (setClauses.length === 0) {
     return getSandbox(resolvedId);
   }
@@ -5157,11 +5203,11 @@ function listProjects() {
   const rows = db2.query("SELECT * FROM projects ORDER BY created_at DESC").all();
   return rows.map(rowToProject);
 }
-function ensureProject(name, path) {
+function ensureProject(name, path, description) {
   const existing = getProjectByPath(path);
   if (existing)
     return existing;
-  return createProject({ name, path });
+  return createProject({ name, path, description });
 }
 
 // src/db/templates.ts
@@ -5492,6 +5538,21 @@ function getAgentDriver(name) {
   return DRIVER_MAP.get(name);
 }
 
+// src/lib/runtime-state.ts
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function finalizeSessionExit(sessionId, exitCode) {
+  endSession(sessionId, exitCode, exitCode === 0 ? "completed" : "failed");
+}
+function finalizeSessionFailure(sessionId, _error, exitCode = 1) {
+  endSession(sessionId, exitCode, "failed");
+}
+function finalizeSandboxProvisionFailure(sandboxId, error) {
+  updateSandbox(sandboxId, { status: "error" });
+  return getErrorMessage(error);
+}
+
 // src/lib/agent-runner.ts
 async function fireWebhook(url, payload) {
   try {
@@ -5554,7 +5615,7 @@ async function runAgent(sandboxId, opts) {
   }).then((result) => {
     const exitResult = result;
     const status = exitResult.exit_code === 0 ? "completed" : "failed";
-    endSession(session.id, exitResult.exit_code ?? 0, status);
+    finalizeSessionExit(session.id, exitResult.exit_code ?? 0);
     emitLifecycleEvent(sandbox.id, `Agent ${opts.agentType} finished with exit code ${exitResult.exit_code}`);
     if (opts.webhookUrl && webhookEvents.includes("complete")) {
       fireWebhook(opts.webhookUrl, {
@@ -5569,7 +5630,7 @@ async function runAgent(sandboxId, opts) {
       });
     }
   }).catch((err) => {
-    endSession(session.id, 1, "failed");
+    finalizeSessionFailure(session.id, err);
     emitLifecycleEvent(sandbox.id, `Agent ${opts.agentType} failed: ${err.message}`);
     if (opts.webhookUrl && webhookEvents.includes("error")) {
       fireWebhook(opts.webhookUrl, {
@@ -5596,7 +5657,72 @@ async function stopAgent(sandboxId) {
   emitLifecycleEvent(sandbox.id, "Agent stopped by user");
 }
 
+// src/lib/images.ts
+var BUILTIN_IMAGES = {
+  node20: {
+    e2b: "e2bdev/base:latest",
+    description: "Node 20 + npm + pnpm + yarn",
+    setup_script: "curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && apt-get install -y nodejs && npm install -g pnpm yarn"
+  },
+  "node20-claude": {
+    e2b: "e2bdev/base:latest",
+    description: "Node 20 + Claude Code CLI pre-installed",
+    setup_script: `curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && apt-get install -y nodejs && npm install -g @anthropic-ai/claude-code && mkdir -p ~/.claude && echo '{"hasCompletedOnboarding":true,"hasTrustDialogAccepted":true,"hasAcknowledgedCostThreshold":true}' > ~/.claude.json`
+  },
+  "node20-codex": {
+    e2b: "e2bdev/base:latest",
+    description: "Node 20 + Codex CLI pre-installed",
+    setup_script: `curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && apt-get install -y nodejs && npm install -g @openai/codex && mkdir -p ~/.codex && echo '[core]
+approvalMode = "full-auto"
+' > ~/.codex/config.toml`
+  },
+  python312: {
+    e2b: "e2bdev/base:latest",
+    description: "Python 3.12 + uv + pip",
+    setup_script: "apt-get update && apt-get install -y python3.12 python3-pip && pip3 install uv"
+  },
+  "python312-agents": {
+    e2b: "e2bdev/base:latest",
+    description: "Python 3.12 + uv + common AI libs",
+    setup_script: "apt-get update && apt-get install -y python3.12 python3-pip && pip3 install uv anthropic openai langchain"
+  },
+  fullstack: {
+    e2b: "e2bdev/base:latest",
+    description: "Node 20 + Python 3.12 + git + build tools",
+    setup_script: "apt-get update && apt-get install -y git build-essential python3.12 python3-pip && curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && apt-get install -y nodejs && npm install -g pnpm"
+  }
+};
+function resolveImage(image) {
+  return BUILTIN_IMAGES[image]?.e2b ?? image;
+}
+function getBuiltinImageSetupScript(image) {
+  return BUILTIN_IMAGES[image]?.setup_script;
+}
+
+// src/lib/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+var cachedVersion;
+function getPackageVersion() {
+  if (cachedVersion)
+    return cachedVersion;
+  const packageJson = JSON.parse(readFileSync2(new URL("../../package.json", import.meta.url), "utf8"));
+  cachedVersion = packageJson.version ?? "0.0.0";
+  return cachedVersion;
+}
+
 // src/mcp/index.ts
+var E2B_COST_PER_SECOND = 0.000014;
+var DAYTONA_COST_PER_SECOND = 0.00001;
+function estimateCost(providerName, startedAt) {
+  if (!startedAt)
+    return { compute_seconds: 0, cost_usd: 0 };
+  const seconds = (Date.now() - new Date(startedAt).getTime()) / 1000;
+  const rate = providerName === "daytona" ? DAYTONA_COST_PER_SECOND : E2B_COST_PER_SECOND;
+  return {
+    compute_seconds: Math.round(seconds),
+    cost_usd: Math.round(seconds * rate * 1e6) / 1e6
+  };
+}
 var exposedPorts = new Map;
 function ok(data) {
   return { content: [{ type: "text", text: JSON.stringify(data) }] };
@@ -5638,11 +5764,13 @@ var TOOL_CATALOG = [
   { name: "expose_port", description: "Forward a sandbox port and get a public URL" },
   { name: "list_exposed_ports", description: "List all forwarded ports for a sandbox" },
   { name: "close_port", description: "Stop forwarding a sandbox port" },
-  { name: "get_network_log", description: "Get outbound network connections from a sandbox" }
+  { name: "get_network_log", description: "Get outbound network connections from a sandbox" },
+  { name: "watch_file", description: "Get new content from a file since a previous read (tail -f equivalent)" },
+  { name: "list_images", description: "List available pre-warmed sandbox image aliases" }
 ];
 var server = new McpServer({
   name: "sandboxes",
-  version: "0.1.0"
+  version: getPackageVersion()
 });
 server.tool("create_sandbox", "Create a new sandbox", {
   provider: exports_external.string().optional().describe("Provider name (e2b, daytona, modal)"),
@@ -5654,8 +5782,11 @@ server.tool("create_sandbox", "Create a new sandbox", {
   on_timeout: exports_external.enum(["pause", "terminate"]).optional().describe("What to do on timeout: pause (saves state) or terminate"),
   auto_resume: exports_external.boolean().optional().describe("Auto-resume paused sandbox on next connect"),
   snapshot_id: exports_external.string().optional().describe("Snapshot ID to restore from"),
-  network: exports_external.enum(["full", "restricted", "none"]).optional().describe("Network access policy for the sandbox")
+  network: exports_external.enum(["full", "restricted", "none"]).optional().describe("Network access policy for the sandbox"),
+  budget_limit_usd: exports_external.number().optional().describe("Auto-terminate sandbox if compute cost exceeds this USD amount"),
+  on_budget_exceeded: exports_external.enum(["terminate", "pause", "notify"]).optional().describe("Action when budget limit is reached (default: terminate)")
 }, async (params) => {
+  let sandboxId;
   try {
     const providerName = params.provider ?? getDefaultProvider();
     const timeout = params.timeout ?? getDefaultTimeout();
@@ -5664,21 +5795,26 @@ server.tool("create_sandbox", "Create a new sandbox", {
       const tmpl = getTemplate(params.template_id);
       templateData = { image: tmpl.image ?? undefined, env_vars: tmpl.env_vars, setup_script: tmpl.setup_script };
     }
-    const image = params.image ?? templateData.image;
+    const rawImage = params.image ?? templateData.image;
+    const resolvedImage = rawImage ? resolveImage(rawImage) : rawImage;
+    const builtinSetupScript = rawImage ? getBuiltinImageSetupScript(rawImage) : undefined;
     const envVars = { ...templateData.env_vars, ...params.env_vars };
     const onTimeout = params.on_timeout ?? "terminate";
     const autoResume = params.auto_resume ?? false;
     const sandbox = createSandbox({
       provider: providerName,
-      image,
+      image: resolvedImage,
       timeout,
       name: params.name,
       env_vars: envVars,
       on_timeout: onTimeout,
       auto_resume: autoResume,
       template_id: params.template_id,
-      config: { network: params.network ?? "full" }
+      config: { network: params.network ?? "full" },
+      budget_limit_usd: params.budget_limit_usd,
+      on_budget_exceeded: params.on_budget_exceeded
     });
+    sandboxId = sandbox.id;
     const provider = await getProvider(providerName);
     if (params.snapshot_id) {
       const snapshot = getSnapshot(params.snapshot_id);
@@ -5691,7 +5827,7 @@ server.tool("create_sandbox", "Create a new sandbox", {
       return ok(updated2);
     }
     const result = await provider.create({
-      image,
+      image: resolvedImage,
       timeout,
       envVars,
       onTimeout,
@@ -5699,7 +5835,8 @@ server.tool("create_sandbox", "Create a new sandbox", {
     });
     const updated = updateSandbox(sandbox.id, {
       provider_sandbox_id: result.id,
-      status: "running"
+      status: "running",
+      started_at: new Date().toISOString()
     });
     emitLifecycleEvent(sandbox.id, "sandbox created");
     if (templateData.setup_script && result.id) {
@@ -5707,8 +5844,16 @@ server.tool("create_sandbox", "Create a new sandbox", {
         await provider.exec(result.id, templateData.setup_script);
       } catch {}
     }
+    if (builtinSetupScript && result.id) {
+      try {
+        await provider.exec(result.id, builtinSetupScript);
+      } catch {}
+    }
     return ok(updated);
   } catch (e) {
+    if (sandboxId) {
+      finalizeSandboxProvisionFailure(sandboxId, e);
+    }
     return err(e);
   }
 });
@@ -5716,7 +5861,9 @@ server.tool("get_sandbox", "Get sandbox details by ID", {
   id: exports_external.string().describe("Sandbox ID or partial ID")
 }, async (params) => {
   try {
-    return ok(getSandbox(params.id));
+    const sandbox = getSandbox(params.id);
+    const cost = estimateCost(sandbox.provider, sandbox.started_at);
+    return ok({ ...sandbox, ...cost });
   } catch (e) {
     return err(e);
   }
@@ -5726,10 +5873,11 @@ server.tool("list_sandboxes", "List sandboxes with filters", {
   provider: exports_external.string().optional().describe("Filter by provider")
 }, async (params) => {
   try {
-    return ok(listSandboxes({
+    const sandboxes = listSandboxes({
       status: params.status,
       provider: params.provider
-    }));
+    });
+    return ok(sandboxes.map((s) => ({ ...s, ...estimateCost(s.provider, s.started_at) })));
   } catch (e) {
     return err(e);
   }
@@ -5786,8 +5934,11 @@ server.tool("exec_command", "Execute a command in a sandbox", {
   sandbox_id: exports_external.string().describe("Sandbox ID or partial ID"),
   command: exports_external.string().describe("Command to execute"),
   background: exports_external.boolean().optional().describe("Run in background"),
-  env_vars: exports_external.record(exports_external.string()).optional().describe("Per-call environment variables (merged with sandbox env_vars, not persisted)")
+  env_vars: exports_external.record(exports_external.string()).optional().describe("Per-call environment variables (merged with sandbox env_vars, not persisted)"),
+  stdin: exports_external.string().optional().describe("String to pipe as stdin to the command"),
+  tty: exports_external.boolean().optional().describe("Allocate a TTY for the session (best-effort)")
 }, async (params) => {
+  let sessionId;
   try {
     const sandbox = getSandbox(params.sandbox_id);
     if (!sandbox.provider_sandbox_id)
@@ -5796,6 +5947,7 @@ server.tool("exec_command", "Execute a command in a sandbox", {
       sandbox_id: sandbox.id,
       command: params.command
     });
+    sessionId = session.id;
     const collector = createStreamCollector(sandbox.id, session.id);
     const provider = await getProvider(sandbox.provider);
     const callEnv = { ...sandbox.env_vars, ...params.env_vars };
@@ -5804,22 +5956,26 @@ server.tool("exec_command", "Execute a command in a sandbox", {
       provider.exec(sandbox.provider_sandbox_id, params.command, {
         onStdout: collector.onStdout,
         onStderr: collector.onStderr,
-        env
+        env,
+        stdin: params.stdin,
+        tty: params.tty
       }).then((res) => {
         const r = res;
-        endSession(session.id, r.exit_code ?? 0);
+        finalizeSessionExit(session.id, r.exit_code ?? 0);
       }).catch(() => {
-        endSession(session.id, 1);
+        finalizeSessionFailure(session.id);
       });
       return ok({ session_id: session.id, background: true });
     }
     const result = await provider.exec(sandbox.provider_sandbox_id, params.command, {
       onStdout: collector.onStdout,
       onStderr: collector.onStderr,
-      env
+      env,
+      stdin: params.stdin,
+      tty: params.tty
     });
     const execResult = result;
-    endSession(session.id, execResult.exit_code);
+    finalizeSessionExit(session.id, execResult.exit_code);
     return ok({
       session_id: session.id,
       exit_code: execResult.exit_code,
@@ -5827,20 +5983,30 @@ server.tool("exec_command", "Execute a command in a sandbox", {
       stderr: execResult.stderr
     });
   } catch (e) {
+    if (sessionId) {
+      finalizeSessionFailure(sessionId, e);
+    }
     return err(e);
   }
 });
 server.tool("read_file", "Read a file from a sandbox", {
   sandbox_id: exports_external.string().describe("Sandbox ID or partial ID"),
-  path: exports_external.string().describe("File path")
+  path: exports_external.string().describe("File path"),
+  offset: exports_external.number().optional().describe("Line or byte offset to start reading from"),
+  limit: exports_external.number().optional().describe("Max lines or bytes to return"),
+  encoding: exports_external.enum(["utf8", "base64", "hex"]).optional().describe("Output encoding (default: utf8)")
 }, async (params) => {
   try {
     const sandbox = getSandbox(params.sandbox_id);
     if (!sandbox.provider_sandbox_id)
       throw new Error("Sandbox has no provider ID");
     const provider = await getProvider(sandbox.provider);
-    const content = await provider.readFile(sandbox.provider_sandbox_id, params.path);
-    return ok({ path: params.path, content });
+    const content = await provider.readFile(sandbox.provider_sandbox_id, params.path, {
+      encoding: params.encoding,
+      offset: params.offset,
+      limit: params.limit
+    });
+    return ok({ path: params.path, content, encoding: params.encoding ?? "utf8" });
   } catch (e) {
     return err(e);
   }
@@ -5863,14 +6029,19 @@ server.tool("write_file", "Write a file to a sandbox", {
 });
 server.tool("list_files", "List files in a sandbox directory", {
   sandbox_id: exports_external.string().describe("Sandbox ID or partial ID"),
-  path: exports_external.string().describe("Directory path")
+  path: exports_external.string().describe("Directory path"),
+  recursive: exports_external.boolean().optional().describe("List files recursively"),
+  glob: exports_external.string().optional().describe("Glob pattern to filter files")
 }, async (params) => {
   try {
     const sandbox = getSandbox(params.sandbox_id);
     if (!sandbox.provider_sandbox_id)
       throw new Error("Sandbox has no provider ID");
     const provider = await getProvider(sandbox.provider);
-    const files = await provider.listFiles(sandbox.provider_sandbox_id, params.path);
+    const files = await provider.listFiles(sandbox.provider_sandbox_id, params.path, {
+      recursive: params.recursive,
+      glob: params.glob
+    });
     return ok(files);
   } catch (e) {
     return err(e);
@@ -5914,8 +6085,7 @@ server.tool("register_project", "Register a project", {
   description: exports_external.string().optional().describe("Project description")
 }, async (params) => {
   try {
-    const project = ensureProject(params.name, params.path);
-    return ok(project);
+    return ok(ensureProject(params.name, params.path, params.description));
   } catch (e) {
     return err(e);
   }
@@ -6205,5 +6375,43 @@ server.tool("get_network_log", "Get outbound network connections from a sandbox"
     return err(e);
   }
 });
+server.tool("watch_file", "Get new content from a file since a previous read (tail -f equivalent)", {
+  sandbox_id: exports_external.string().describe("Sandbox ID or partial ID"),
+  path: exports_external.string().describe("File path to watch"),
+  offset: exports_external.number().optional().describe("Line offset to read from (use next_offset from previous call)"),
+  limit: exports_external.number().optional().describe("Max lines to return (default: 100)")
+}, async (params) => {
+  try {
+    const sandbox = getSandbox(params.sandbox_id);
+    if (!sandbox.provider_sandbox_id)
+      throw new Error("Sandbox has no provider ID");
+    const provider = await getProvider(sandbox.provider);
+    const content = await provider.readFile(sandbox.provider_sandbox_id, params.path, {
+      offset: params.offset,
+      limit: params.limit ?? 100
+    });
+    const lines = content.split(`
+`);
+    return ok({
+      path: params.path,
+      content,
+      lines_read: lines.length,
+      next_offset: (params.offset ?? 0) + lines.length
+    });
+  } catch (e) {
+    return err(e);
+  }
+});
+server.tool("list_images", "List available pre-warmed sandbox image aliases", {}, async () => {
+  try {
+    return ok(Object.entries(BUILTIN_IMAGES).map(([name, info]) => ({
+      name,
+      description: info.description,
+      has_setup_script: !!info.setup_script
+    })));
+  } catch (e) {
+    return err(e);
+  }
+});
 var transport = new StdioServerTransport;
 await server.connect(transport);

package/dist/providers/e2b.d.ts

@@ -7,9 +7,16 @@ export declare class E2BProvider implements SandboxProvider {
     create(opts?: CreateSandboxOpts): Promise<ProviderSandbox>;
     private getInstance;
     exec(sandboxId: string, command: string, opts?: ExecOptions): Promise<ExecResult | ExecHandle>;
-    readFile(sandboxId: string, path: string): Promise<string>;
+    readFile(sandboxId: string, path: string, opts?: {
+        encoding?: 'utf8' | 'base64' | 'hex';
+        offset?: number;
+        limit?: number;
+    }): Promise<string>;
     writeFile(sandboxId: string, path: string, content: string): Promise<void>;
-    listFiles(sandboxId: string, path: string): Promise<FileInfo[]>;
+    listFiles(sandboxId: string, path: string, opts?: {
+        recursive?: boolean;
+        glob?: string;
+    }): Promise<FileInfo[]>;
     stop(sandboxId: string): Promise<void>;
     delete(sandboxId: string): Promise<void>;
     pause(sandboxId: string): Promise<void>;

package/dist/providers/e2b.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"e2b.d.ts","sourceRoot":"","sources":["../../src/providers/e2b.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,MAAM,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;YAwBlD,WAAW;IAkBnB,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;IA0D7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAYV,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkB/D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlF,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWvE"}
+{"version":3,"file":"e2b.d.ts","sourceRoot":"","sources":["../../src/providers/e2b.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,MAAM,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;YAwBlD,WAAW;IAkBnB,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;IA2D7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgC5I,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAYV,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA+B9G,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlF,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWvE"}

package/dist/providers/types.d.ts

@@ -13,6 +13,8 @@ export interface ExecOptions {
     timeout?: number;
     env?: Record<string, string>;
     cwd?: string;
+    stdin?: string;
+    tty?: boolean;
 }
 export interface ProviderSandbox {
     id: string;
@@ -22,9 +24,16 @@ export interface SandboxProvider {
     readonly name: string;
     create(opts?: CreateSandboxOpts): Promise<ProviderSandbox>;
     exec(sandboxId: string, command: string, opts?: ExecOptions): Promise<ExecResult | ExecHandle>;
-    readFile(sandboxId: string, path: string): Promise<string>;
+    readFile(sandboxId: string, path: string, opts?: {
+        encoding?: 'utf8' | 'base64' | 'hex';
+        offset?: number;
+        limit?: number;
+    }): Promise<string>;
     writeFile(sandboxId: string, path: string, content: string): Promise<void>;
-    listFiles(sandboxId: string, path: string): Promise<FileInfo[]>;
+    listFiles(sandboxId: string, path: string, opts?: {
+        recursive?: boolean;
+        glob?: string;
+    }): Promise<FileInfo[]>;
     stop(sandboxId: string): Promise<void>;
     delete(sandboxId: string): Promise<void>;
     keepAlive(sandboxId: string, durationMs?: number): Promise<void>;

package/dist/providers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3D,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IAEpC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEhE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAClC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,MAAM,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3D,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IAEpC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7I,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE/G,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnF"}