@hasna/sandboxes 0.1.8 → 0.1.10

package/dist/cli/index.js

@@ -2275,6 +2275,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);
   `
   ];
 });
@@ -2326,6 +2332,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
   };
@@ -2343,8 +2352,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) {
@@ -2416,6 +2427,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);
   }
@@ -2694,10 +2709,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
       };
@@ -2705,10 +2721,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}`);
     }
@@ -2721,9 +2755,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,
@@ -3318,6 +3364,25 @@ var init_stream = __esm(() => {
   listeners = new Map;
 });
 
+// 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);
+}
+var init_runtime_state = __esm(() => {
+  init_sessions();
+  init_sandboxes();
+});
+
 // src/lib/agents/claude.ts
 class ClaudeDriver {
   name = "claude";
@@ -3497,7 +3562,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, {
@@ -3512,7 +3577,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, {
@@ -3544,6 +3609,7 @@ var init_agent_runner = __esm(() => {
   init_providers();
   init_stream();
   init_agents();
+  init_runtime_state();
 });
 
 // node_modules/commander/esm.mjs
@@ -3623,6 +3689,20 @@ function listAgents() {
 init_providers();
 init_config();
 init_stream();
+init_runtime_state();
+
+// 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/cli/index.tsx
 function printTable(headers, rows) {
   const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] || "").length)));
   const headerLine = headers.map((h, i) => chalk.bold(h.padEnd(widths[i]))).join("  ");
@@ -3674,11 +3754,12 @@ function parseEnvVars(envArgs) {
   }
   return vars;
 }
-var program2 = new Command().name("sandboxes").description("Universal cloud sandbox manager for AI coding agents").version("0.1.0");
+var program2 = new Command().name("sandboxes").description("Universal cloud sandbox manager for AI coding agents").version(getPackageVersion());
 program2.command("create").description("Create a new sandbox").option("-p, --provider <provider>", "Provider (e2b, daytona, modal)").option("-i, --image <image>", "Container image").option("-t, --timeout <seconds>", "Timeout in seconds").option("-n, --name <name>", "Sandbox name").option("-e, --env <KEY=VAL...>", "Environment variables", (val, acc) => {
   acc.push(val);
   return acc;
 }, []).action(async (opts) => {
+  let sandboxId;
   try {
     const provider = opts.provider || getDefaultProvider();
     const timeout = opts.timeout ? parseInt(opts.timeout, 10) : getDefaultTimeout();
@@ -3691,6 +3772,7 @@ program2.command("create").description("Create a new sandbox").option("-p, --pro
       timeout,
       env_vars: envVars
     });
+    sandboxId = sandbox.id;
     console.log(chalk.dim("Creating sandbox..."));
     const p = await getProvider(provider);
     const result = await p.create({
@@ -3710,6 +3792,9 @@ program2.command("create").description("Create a new sandbox").option("-p, --pro
       console.log(`  ${chalk.bold("Name:")}     ${updated.name}`);
     }
   } catch (err) {
+    if (sandboxId) {
+      finalizeSandboxProvisionFailure(sandboxId, err);
+    }
     handleError(err);
   }
 });
@@ -3766,6 +3851,7 @@ program2.command("show <id>").description("Show sandbox details").action((id) =>
   }
 });
 program2.command("exec <id> <command...>").description("Execute a command in a sandbox").action(async (id, commandParts) => {
+  let sessionId;
   try {
     const sandbox = getSandbox(id);
     if (!sandbox.provider_sandbox_id) {
@@ -3777,6 +3863,7 @@ program2.command("exec <id> <command...>").description("Execute a command in a s
       sandbox_id: sandbox.id,
       command: cmd
     });
+    sessionId = session.id;
     const collector = createStreamCollector(sandbox.id, session.id);
     const p = await getProvider(sandbox.provider);
     const result = await p.exec(sandbox.provider_sandbox_id, cmd, {
@@ -3790,9 +3877,12 @@ program2.command("exec <id> <command...>").description("Execute a command in a s
       }
     });
     const execResult = "exit_code" in result ? result : await result.wait();
-    endSession(session.id, execResult.exit_code, execResult.exit_code === 0 ? "completed" : "failed");
+    finalizeSessionExit(session.id, execResult.exit_code);
     process.exit(execResult.exit_code);
   } catch (err) {
+    if (sessionId) {
+      finalizeSessionFailure(sessionId, err);
+    }
     handleError(err);
   }
 });

package/dist/db/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA2MtC,wBAAgB,WAAW,IAAI,QAAQ,CAYtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAcf"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmNtC,wBAAgB,WAAW,IAAI,QAAQ,CAYtC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAcf"}

package/dist/db/projects.d.ts

@@ -4,6 +4,6 @@ export declare function createProject(input: CreateProjectInput): Project;
 export declare function getProject(id: string): Project;
 export declare function getProjectByPath(path: string): Project | null;
 export declare function listProjects(): Project[];
-export declare function ensureProject(name: string, path: string): Project;
+export declare function ensureProject(name: string, path: string, description?: string): Project;
 export declare function deleteProject(id: string): void;
 //# sourceMappingURL=projects.d.ts.map

package/dist/db/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/db/projects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAKlE,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CASlD;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAYhE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAY9C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAS7D;AAED,wBAAgB,YAAY,IAAI,OAAO,EAAE,CAQxC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO9C"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/db/projects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAKlE,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CASlD;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAYhE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAY9C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAS7D;AAED,wBAAgB,YAAY,IAAI,OAAO,EAAE,CAQxC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAKvF;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO9C"}

package/dist/db/sandboxes.d.ts

@@ -7,6 +7,6 @@ export declare function listSandboxes(opts?: {
     provider?: SandboxProviderName;
     project_id?: string;
 }): Sandbox[];
-export declare function updateSandbox(id: string, updates: Partial<Pick<Sandbox, "status" | "provider_sandbox_id" | "name" | "image" | "timeout" | "config" | "env_vars" | "keep_alive_until">>): Sandbox;
+export declare function updateSandbox(id: string, updates: Partial<Pick<Sandbox, "status" | "provider_sandbox_id" | "name" | "image" | "timeout" | "config" | "env_vars" | "keep_alive_until" | "started_at">>): Sandbox;
 export declare function deleteSandbox(id: string): void;
 //# sourceMappingURL=sandboxes.d.ts.map

package/dist/db/sandboxes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandboxes.d.ts","sourceRoot":"","sources":["../../src/db/sandboxes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAKxB,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAkBrD;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAkChE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAY9C;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE;IACnC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,EAAE,CAwBZ;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CACF,OAAO,EACL,QAAQ,GACR,qBAAqB,GACrB,MAAM,GACN,OAAO,GACP,SAAS,GACT,QAAQ,GACR,UAAU,GACV,kBAAkB,CACrB,CACF,GACA,OAAO,CAuDT;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO9C"}
+{"version":3,"file":"sandboxes.d.ts","sourceRoot":"","sources":["../../src/db/sandboxes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAKxB,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAqBrD;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAsChE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAY9C;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE;IACnC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,EAAE,CAwBZ;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CACF,OAAO,EACL,QAAQ,GACR,qBAAqB,GACrB,MAAM,GACN,OAAO,GACP,SAAS,GACT,QAAQ,GACR,UAAU,GACV,kBAAkB,GAClB,YAAY,CACf,CACF,GACA,OAAO,CA2DT;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO9C"}

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { createSnapshot, getSnapshot, listSnapshots, deleteSnapshot } from "./db
 export type { Snapshot, SnapshotRow } from "./db/snapshots.js";
 export { SnapshotNotFoundError } from "./db/snapshots.js";
 export { loadConfig, saveConfig, getDefaultProvider, getDefaultTimeout, getDefaultImage, getProviderApiKey, setConfigValue, getConfigValue } from "./lib/config.js";
+export { BUILTIN_IMAGES, resolveImage, getBuiltinImageSetupScript } from "./lib/images.js";
 export { getProvider } from "./providers/index.js";
 export type { SandboxProvider, ProviderSandbox, CreateSandboxOpts, ExecOptions } from "./providers/types.js";
 export { createStreamCollector, addStreamListener, emitLifecycleEvent } from "./lib/stream.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3H,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/F,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGpK,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG7G,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG/F,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACtG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC3H,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC/F,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGpK,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG3F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG7G,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG/F,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -174,10 +174,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
       };
@@ -185,10 +186,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}`);
     }
@@ -201,9 +220,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,
@@ -875,6 +906,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;
@@ -949,6 +986,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
   };
@@ -966,8 +1006,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) {
@@ -1039,6 +1081,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);
   }
@@ -1262,11 +1308,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 });
 }
 function deleteProject(id) {
   const db2 = getDatabase();
@@ -1504,6 +1550,47 @@ function getConfigValue(key) {
   }
   return;
 }
+// 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/providers/index.ts
 init_types();
 var providerCache = new Map;
@@ -1722,6 +1809,7 @@ export {
   setConfigValue,
   saveConfig,
   resolvePartialId,
+  resolveImage,
   resetDatabase,
   registerAgent,
   now,
@@ -1750,6 +1838,7 @@ export {
   getDefaultImage,
   getDatabase,
   getConfigValue,
+  getBuiltinImageSetupScript,
   getAgentDriver,
   getAgentByName,
   getAgent,
@@ -1783,6 +1872,7 @@ export {
   ProviderError,
   ProjectNotFoundError,
   EVENT_TYPES,
+  BUILTIN_IMAGES,
   AgentNotFoundError,
   AGENT_TYPES
 };

package/dist/lib/agent-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../src/lib/agent-runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;CACpD;AAcD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAyGzB;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhE"}
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../src/lib/agent-runner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;CACpD;AAcD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAyGzB;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhE"}

package/dist/lib/images.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Built-in sandbox image aliases.
+ * Maps a short name to the provider-specific image identifier.
+ * For E2B, these are custom images or base images with setup scripts.
+ */
+export declare const BUILTIN_IMAGES: Record<string, {
+    e2b: string;
+    description: string;
+    setup_script?: string;
+}>;
+export declare function resolveImage(image: string): string;
+export declare function getBuiltinImageSetupScript(image: string): string | undefined;
+//# sourceMappingURL=images.d.ts.map

package/dist/lib/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/lib/images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CA+BtG,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E"}

package/dist/lib/runtime-state.d.ts

@@ -0,0 +1,5 @@
+export declare function getErrorMessage(error: unknown): string;
+export declare function finalizeSessionExit(sessionId: string, exitCode: number): void;
+export declare function finalizeSessionFailure(sessionId: string, _error?: unknown, exitCode?: number): void;
+export declare function finalizeSandboxProvisionFailure(sandboxId: string, error?: unknown): string;
+//# sourceMappingURL=runtime-state.d.ts.map

package/dist/lib/runtime-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../../src/lib/runtime-state.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,IAAI,CAG9F;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAI1F"}

package/dist/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C"}