@hasna/sandboxes 0.1.7 → 0.1.9

package/dist/cli/index.js

@@ -2263,6 +2263,24 @@ ALTER TABLE sandbox_sessions_new RENAME TO sandbox_sessions;
 CREATE INDEX IF NOT EXISTS idx_sessions_sandbox ON sandbox_sessions(sandbox_id);
 CREATE INDEX IF NOT EXISTS idx_sessions_status ON sandbox_sessions(status);
 INSERT OR IGNORE INTO _migrations (id) VALUES (3);
+  `,
+    `
+CREATE TABLE IF NOT EXISTS snapshots (
+  id TEXT PRIMARY KEY,
+  sandbox_id TEXT NOT NULL,
+  provider_sandbox_id TEXT NOT NULL,
+  provider TEXT NOT NULL,
+  name TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+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);
   `
   ];
 });
@@ -2314,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
   };
@@ -2331,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) {
@@ -2404,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);
   }
@@ -2682,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
       };
@@ -2693,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}`);
     }
@@ -2709,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,
@@ -2752,6 +2810,15 @@ class E2BProvider {
       throw new ProviderError("e2b", `Failed to resume sandbox: ${err.message}`);
     }
   }
+  async getPublicUrl(sandboxId, port, _protocol) {
+    const sandbox = await this.getInstance(sandboxId);
+    try {
+      const host = sandbox.getHost(port);
+      return `https://${host}`;
+    } catch (err) {
+      throw new ProviderError("e2b", `Failed to get public URL for port ${port}: ${err.message}`);
+    }
+  }
   async keepAlive(sandboxId, durationMs) {
     const sandbox = await this.getInstance(sandboxId);
     try {
@@ -2912,6 +2979,9 @@ class DaytonaProvider {
       throw new ProviderError("daytona", `Failed to delete sandbox: ${err.message}`);
     }
   }
+  async getPublicUrl(_sandboxId, _port, _protocol) {
+    throw new ProviderError("daytona", "Port forwarding not supported by Daytona provider");
+  }
   async pause(_sandboxId) {
     throw new ProviderError("daytona", "Pause/resume not supported by Daytona provider");
   }
@@ -3140,6 +3210,9 @@ class ModalProvider {
   async delete(sandboxId) {
     await this.stop(sandboxId);
   }
+  async getPublicUrl(_sandboxId, _port, _protocol) {
+    throw new ProviderError("modal", "Port forwarding not supported by Modal provider");
+  }
   async pause(_sandboxId) {
     throw new ProviderError("modal", "Pause/resume not supported by Modal provider");
   }
@@ -3409,13 +3482,23 @@ __export(exports_agent_runner, {
   stopAgent: () => stopAgent,
   runAgent: () => runAgent
 });
+async function fireWebhook(url, payload) {
+  try {
+    await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
+    });
+  } catch {}
+}
 async function runAgent(sandboxId, opts) {
   const sandbox = getSandbox(sandboxId);
   if (!sandbox.provider_sandbox_id) {
     throw new Error("Sandbox has no provider instance");
   }
   const provider = await getProvider(sandbox.provider);
-  const env = Object.keys(sandbox.env_vars ?? {}).length > 0 ? sandbox.env_vars : undefined;
+  const mergedEnv = { ...sandbox.env_vars, ...opts.callEnvVars };
+  const env = Object.keys(mergedEnv).length > 0 ? mergedEnv : undefined;
   let cmd;
   const driver = opts.agentType !== "custom" ? getAgentDriver(opts.agentType) : undefined;
   if (opts.command) {
@@ -3434,6 +3517,18 @@ async function runAgent(sandboxId, opts) {
     command: cmd
   });
   emitLifecycleEvent(sandbox.id, `Agent ${opts.agentType} started: ${opts.prompt.slice(0, 100)}`);
+  const startedAt = Date.now();
+  const webhookEvents = opts.webhookEvents ?? ["start", "complete", "error"];
+  if (opts.webhookUrl && webhookEvents.includes("start")) {
+    fireWebhook(opts.webhookUrl, {
+      event: "start",
+      session_id: session.id,
+      sandbox_id: sandbox.id,
+      agent_type: opts.agentType,
+      status: "running",
+      timestamp: new Date().toISOString()
+    });
+  }
   const collector = createStreamCollector(sandbox.id, session.id);
   provider.exec(sandbox.provider_sandbox_id, cmd, {
     onStdout: (data) => {
@@ -3450,9 +3545,32 @@ async function runAgent(sandboxId, opts) {
     const status = exitResult.exit_code === 0 ? "completed" : "failed";
     endSession(session.id, exitResult.exit_code ?? 0, status);
     emitLifecycleEvent(sandbox.id, `Agent ${opts.agentType} finished with exit code ${exitResult.exit_code}`);
+    if (opts.webhookUrl && webhookEvents.includes("complete")) {
+      fireWebhook(opts.webhookUrl, {
+        event: "complete",
+        session_id: session.id,
+        sandbox_id: sandbox.id,
+        agent_type: opts.agentType,
+        status,
+        exit_code: exitResult.exit_code,
+        duration_ms: Date.now() - startedAt,
+        timestamp: new Date().toISOString()
+      });
+    }
   }).catch((err) => {
     endSession(session.id, 1, "failed");
     emitLifecycleEvent(sandbox.id, `Agent ${opts.agentType} failed: ${err.message}`);
+    if (opts.webhookUrl && webhookEvents.includes("error")) {
+      fireWebhook(opts.webhookUrl, {
+        event: "error",
+        session_id: session.id,
+        sandbox_id: sandbox.id,
+        agent_type: opts.agentType,
+        status: "failed",
+        duration_ms: Date.now() - startedAt,
+        timestamp: new Date().toISOString()
+      });
+    }
   });
   return session;
 }

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;AA6LtC,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/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/db/snapshots.d.ts

@@ -0,0 +1,29 @@
+export interface Snapshot {
+    id: string;
+    sandbox_id: string;
+    provider_sandbox_id: string;
+    provider: string;
+    name: string | null;
+    created_at: string;
+}
+export interface SnapshotRow {
+    id: string;
+    sandbox_id: string;
+    provider_sandbox_id: string;
+    provider: string;
+    name: string | null;
+    created_at: string;
+}
+export declare class SnapshotNotFoundError extends Error {
+    constructor(id: string);
+}
+export declare function createSnapshot(input: {
+    sandbox_id: string;
+    provider_sandbox_id: string;
+    provider: string;
+    name?: string;
+}): Snapshot;
+export declare function getSnapshot(id: string): Snapshot;
+export declare function listSnapshots(sandboxId?: string): Snapshot[];
+export declare function deleteSnapshot(id: string): void;
+//# sourceMappingURL=snapshots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/db/snapshots.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,EAAE,EAAE,MAAM;CAIvB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,QAAQ,CASX;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAOhD;AAED,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAM5D;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK/C"}

package/dist/index.d.ts

@@ -7,7 +7,11 @@ export { registerAgent, getAgent, getAgentByName, listAgents, deleteAgent } from
 export { createProject, getProject, getProjectByPath, listProjects, ensureProject, deleteProject } from "./db/projects.js";
 export { createWebhook, getWebhook, listWebhooks, deleteWebhook } from "./db/webhooks.js";
 export { createTemplate, getTemplate, getTemplateByName, listTemplates, deleteTemplate } from "./db/templates.js";
+export { createSnapshot, getSnapshot, listSnapshots, deleteSnapshot } from "./db/snapshots.js";
+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;AAGlH,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,
@@ -244,6 +275,15 @@ class E2BProvider {
       throw new ProviderError("e2b", `Failed to resume sandbox: ${err.message}`);
     }
   }
+  async getPublicUrl(sandboxId, port, _protocol) {
+    const sandbox = await this.getInstance(sandboxId);
+    try {
+      const host = sandbox.getHost(port);
+      return `https://${host}`;
+    } catch (err) {
+      throw new ProviderError("e2b", `Failed to get public URL for port ${port}: ${err.message}`);
+    }
+  }
   async keepAlive(sandboxId, durationMs) {
     const sandbox = await this.getInstance(sandboxId);
     try {
@@ -404,6 +444,9 @@ class DaytonaProvider {
       throw new ProviderError("daytona", `Failed to delete sandbox: ${err.message}`);
     }
   }
+  async getPublicUrl(_sandboxId, _port, _protocol) {
+    throw new ProviderError("daytona", "Port forwarding not supported by Daytona provider");
+  }
   async pause(_sandboxId) {
     throw new ProviderError("daytona", "Pause/resume not supported by Daytona provider");
   }
@@ -632,6 +675,9 @@ class ModalProvider {
   async delete(sandboxId) {
     await this.stop(sandboxId);
   }
+  async getPublicUrl(_sandboxId, _port, _protocol) {
+    throw new ProviderError("modal", "Port forwarding not supported by Modal provider");
+  }
   async pause(_sandboxId) {
     throw new ProviderError("modal", "Pause/resume not supported by Modal provider");
   }
@@ -848,6 +894,24 @@ ALTER TABLE sandbox_sessions_new RENAME TO sandbox_sessions;
 CREATE INDEX IF NOT EXISTS idx_sessions_sandbox ON sandbox_sessions(sandbox_id);
 CREATE INDEX IF NOT EXISTS idx_sessions_status ON sandbox_sessions(status);
 INSERT OR IGNORE INTO _migrations (id) VALUES (3);
+  `,
+  `
+CREATE TABLE IF NOT EXISTS snapshots (
+  id TEXT PRIMARY KEY,
+  sandbox_id TEXT NOT NULL,
+  provider_sandbox_id TEXT NOT NULL,
+  provider TEXT NOT NULL,
+  name TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+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;
@@ -922,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
   };
@@ -939,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) {
@@ -1012,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);
   }
@@ -1343,6 +1416,45 @@ function deleteTemplate(id) {
     throw new TemplateNotFoundError(id);
   db2.query("DELETE FROM templates WHERE id = ?").run(resolvedId);
 }
+// src/db/snapshots.ts
+class SnapshotNotFoundError extends Error {
+  constructor(id) {
+    super(`Snapshot not found: ${id}`);
+    this.name = "SnapshotNotFoundError";
+  }
+}
+function createSnapshot(input) {
+  const db2 = getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  db2.query(`INSERT INTO snapshots (id, sandbox_id, provider_sandbox_id, provider, name, created_at)
+     VALUES (?, ?, ?, ?, ?, ?)`).run(id, input.sandbox_id, input.provider_sandbox_id, input.provider, input.name ?? null, timestamp);
+  return getSnapshot(id);
+}
+function getSnapshot(id) {
+  const db2 = getDatabase();
+  const resolvedId = resolvePartialId("snapshots", id);
+  if (!resolvedId)
+    throw new SnapshotNotFoundError(id);
+  const row = db2.query("SELECT * FROM snapshots WHERE id = ?").get(resolvedId);
+  if (!row)
+    throw new SnapshotNotFoundError(id);
+  return row;
+}
+function listSnapshots(sandboxId) {
+  const db2 = getDatabase();
+  if (sandboxId) {
+    return db2.query("SELECT * FROM snapshots WHERE sandbox_id = ? ORDER BY created_at DESC").all(sandboxId);
+  }
+  return db2.query("SELECT * FROM snapshots ORDER BY created_at DESC").all();
+}
+function deleteSnapshot(id) {
+  const db2 = getDatabase();
+  const resolvedId = resolvePartialId("snapshots", id);
+  if (!resolvedId)
+    throw new SnapshotNotFoundError(id);
+  db2.query("DELETE FROM snapshots WHERE id = ?").run(resolvedId);
+}
 // src/lib/config.ts
 import { existsSync as existsSync2, readFileSync, writeFileSync, mkdirSync as mkdirSync2 } from "fs";
 import { dirname as dirname2, join as join2 } from "path";
@@ -1438,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;
@@ -1656,12 +1809,14 @@ export {
   setConfigValue,
   saveConfig,
   resolvePartialId,
+  resolveImage,
   resetDatabase,
   registerAgent,
   now,
   loadConfig,
   listWebhooks,
   listTemplates,
+  listSnapshots,
   listSessions,
   listSandboxes,
   listProjects,
@@ -1671,6 +1826,7 @@ export {
   getWebhook,
   getTemplateByName,
   getTemplate,
+  getSnapshot,
   getSession,
   getSandbox,
   getProviderApiKey,
@@ -1682,6 +1838,7 @@ export {
   getDefaultImage,
   getDatabase,
   getConfigValue,
+  getBuiltinImageSetupScript,
   getAgentDriver,
   getAgentByName,
   getAgent,
@@ -1690,12 +1847,14 @@ export {
   emitLifecycleEvent,
   deleteWebhook,
   deleteTemplate,
+  deleteSnapshot,
   deleteSandbox,
   deleteProject,
   deleteAgent,
   createWebhook,
   createTemplate,
   createStreamCollector,
+  createSnapshot,
   createSession,
   createSandbox,
   createProject,
@@ -1704,6 +1863,7 @@ export {
   addEvent,
   WebhookNotFoundError,
   TemplateNotFoundError,
+  SnapshotNotFoundError,
   SessionNotFoundError,
   SandboxNotFoundError,
   SESSION_STATUSES,
@@ -1712,6 +1872,7 @@ export {
   ProviderError,
   ProjectNotFoundError,
   EVENT_TYPES,
+  BUILTIN_IMAGES,
   AgentNotFoundError,
   AGENT_TYPES
 };

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

@@ -6,6 +6,9 @@ export interface RunAgentOpts {
     command?: string;
     onStdout?: (data: string) => void;
     onStderr?: (data: string) => void;
+    callEnvVars?: Record<string, string>;
+    webhookUrl?: string;
+    webhookEvents?: ('start' | 'complete' | 'error')[];
 }
 export declare function runAgent(sandboxId: string, opts: RunAgentOpts): Promise<SandboxSession>;
 export declare function stopAgent(sandboxId: string): Promise<void>;

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;CACnC;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CA8DzB;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":"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"}

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"}