@hasna/sandboxes 0.1.6 → 0.1.8

package/dist/cli/index.js

@@ -2244,6 +2244,37 @@ CREATE TABLE IF NOT EXISTS templates (
 CREATE INDEX IF NOT EXISTS idx_templates_name ON templates(name);
 
 INSERT OR IGNORE INTO _migrations (id) VALUES (2);
+  `,
+    `
+CREATE TABLE IF NOT EXISTS sandbox_sessions_new (
+  id TEXT PRIMARY KEY,
+  sandbox_id TEXT NOT NULL REFERENCES sandboxes(id) ON DELETE CASCADE,
+  agent_name TEXT,
+  agent_type TEXT,
+  command TEXT,
+  status TEXT NOT NULL DEFAULT 'running' CHECK(status IN ('running', 'completed', 'failed', 'killed')),
+  exit_code INTEGER,
+  started_at TEXT NOT NULL DEFAULT (datetime('now')),
+  ended_at TEXT
+);
+INSERT INTO sandbox_sessions_new SELECT * FROM sandbox_sessions;
+DROP TABLE sandbox_sessions;
+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);
   `
   ];
 });
@@ -2733,6 +2764,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 {
@@ -2893,6 +2933,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");
   }
@@ -3121,6 +3164,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");
   }
@@ -3272,18 +3318,152 @@ var init_stream = __esm(() => {
   listeners = new Map;
 });
 
+// src/lib/agents/claude.ts
+class ClaudeDriver {
+  name = "claude";
+  requiredEnvVars = ["ANTHROPIC_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which claude 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @anthropic-ai/claude-code 2>&1 || sudo npm install -g @anthropic-ai/claude-code 2>&1");
+  }
+  async configure(provider, providerSandboxId, _envVars) {
+    const config = JSON.stringify({
+      hasCompletedOnboarding: true,
+      hasTrustDialogAccepted: true,
+      hasAcknowledgedCostThreshold: true
+    });
+    await provider.exec(providerSandboxId, `mkdir -p ~/.claude && echo '${config}' > ~/.claude.json`);
+  }
+  buildCommand(prompt) {
+    return `claude --dangerously-skip-permissions -p ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/codex.ts
+class CodexDriver {
+  name = "codex";
+  requiredEnvVars = ["OPENAI_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which codex 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @openai/codex 2>&1 || sudo npm install -g @openai/codex 2>&1");
+  }
+  async configure(provider, providerSandboxId, _envVars) {
+    const config = `[core]
+approvalMode = "full-auto"
+quiet = true
+`;
+    await provider.exec(providerSandboxId, `mkdir -p ~/.codex && printf '${config.replace(/'/g, "'\\''")}' > ~/.codex/config.toml`);
+  }
+  buildCommand(prompt) {
+    return `codex --approval-mode full-auto -q ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/gemini.ts
+class GeminiDriver {
+  name = "gemini";
+  requiredEnvVars = ["GEMINI_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which gemini 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @google/gemini-cli 2>&1 || sudo npm install -g @google/gemini-cli 2>&1");
+  }
+  async configure(provider, providerSandboxId, _envVars) {
+    const settings = JSON.stringify({ theme: "Default", selectedAuthType: "gemini-api-key" });
+    await provider.exec(providerSandboxId, `mkdir -p ~/.gemini && echo '${settings}' > ~/.gemini/settings.json`);
+  }
+  buildCommand(prompt) {
+    return `gemini -p ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/opencode.ts
+class OpenCodeDriver {
+  name = "opencode";
+  requiredEnvVars = [];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which opencode 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g opencode-ai 2>&1 || sudo npm install -g opencode-ai 2>&1");
+  }
+  async configure(_provider, _providerSandboxId, _envVars) {}
+  buildCommand(prompt) {
+    return `opencode run ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/pi.ts
+class PiDriver {
+  name = "pi";
+  requiredEnvVars = ["PI_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which pi 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @pi-ai/cli 2>&1 || sudo npm install -g @pi-ai/cli 2>&1");
+  }
+  async configure(_provider, _providerSandboxId, _envVars) {}
+  buildCommand(prompt) {
+    return `pi ask ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/index.ts
+function getAgentDriver(name) {
+  return DRIVER_MAP.get(name);
+}
+var DRIVERS, DRIVER_MAP;
+var init_agents = __esm(() => {
+  DRIVERS = [
+    new ClaudeDriver,
+    new CodexDriver,
+    new GeminiDriver,
+    new OpenCodeDriver,
+    new PiDriver
+  ];
+  DRIVER_MAP = new Map(DRIVERS.map((d) => [d.name, d]));
+});
+
 // src/lib/agent-runner.ts
 var exports_agent_runner = {};
 __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 cmd = opts.command || AGENT_COMMANDS[opts.agentType]?.(opts.prompt) || opts.prompt;
+  const provider = await getProvider(sandbox.provider);
+  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) {
+    cmd = opts.command;
+  } else if (driver) {
+    await driver.install(provider, sandbox.provider_sandbox_id);
+    await driver.configure(provider, sandbox.provider_sandbox_id, sandbox.env_vars ?? {});
+    cmd = driver.buildCommand(opts.prompt);
+  } else {
+    cmd = opts.prompt;
+  }
   const session = createSession({
     sandbox_id: sandbox.id,
     agent_name: opts.agentName,
@@ -3291,9 +3471,19 @@ 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);
-  const provider = await getProvider(sandbox.provider);
-  const env = Object.keys(sandbox.env_vars ?? {}).length > 0 ? sandbox.env_vars : undefined;
   provider.exec(sandbox.provider_sandbox_id, cmd, {
     onStdout: (data) => {
       collector.onStdout(data);
@@ -3309,9 +3499,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;
 }
@@ -3321,22 +3534,16 @@ async function stopAgent(sandboxId) {
     return;
   const provider = await getProvider(sandbox.provider);
   try {
-    await provider.exec(sandbox.provider_sandbox_id, "pkill -f 'claude\\|codex\\|gemini' || true");
+    await provider.exec(sandbox.provider_sandbox_id, "pkill -f 'claude\\|codex\\|gemini\\|opencode\\|pi' || true");
   } catch {}
   emitLifecycleEvent(sandbox.id, "Agent stopped by user");
 }
-var CLAUDE_ONBOARDING_SETUP, AGENT_COMMANDS;
 var init_agent_runner = __esm(() => {
   init_sandboxes();
   init_sessions();
   init_providers();
   init_stream();
-  CLAUDE_ONBOARDING_SETUP = `mkdir -p ~/.claude && ` + `echo '{"hasCompletedOnboarding":true,"hasTrustDialogAccepted":true,"hasAcknowledgedCostThreshold":true}' > ~/.claude.json`;
-  AGENT_COMMANDS = {
-    claude: (prompt) => `${CLAUDE_ONBOARDING_SETUP} && claude --dangerously-skip-permissions -p ${JSON.stringify(prompt)}`,
-    codex: (prompt) => `codex -q ${JSON.stringify(prompt)}`,
-    gemini: (prompt) => `gemini -p ${JSON.stringify(prompt)}`
-  };
+  init_agents();
 });
 
 // node_modules/commander/esm.mjs

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;AAwKtC,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;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"}

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,8 +7,13 @@ 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 { getProvider } from "./providers/index.js";
 export type { SandboxProvider, ProviderSandbox, CreateSandboxOpts, ExecOptions } from "./providers/types.js";
 export { createStreamCollector, addStreamListener, emitLifecycleEvent } from "./lib/stream.js";
+export { getAgentDriver, listAgentDrivers } from "./lib/agents/index.js";
+export type { AgentDriver } from "./lib/agents/types.js";
 //# sourceMappingURL=index.d.ts.map

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

package/dist/index.js

@@ -45,7 +45,7 @@ var init_types = __esm(() => {
     "failed",
     "killed"
   ];
-  AGENT_TYPES = ["claude", "codex", "gemini", "custom"];
+  AGENT_TYPES = ["claude", "codex", "gemini", "opencode", "pi", "custom"];
   EVENT_TYPES = [
     "stdout",
     "stderr",
@@ -244,6 +244,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 +413,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 +644,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");
   }
@@ -829,6 +844,37 @@ CREATE TABLE IF NOT EXISTS templates (
 CREATE INDEX IF NOT EXISTS idx_templates_name ON templates(name);
 
 INSERT OR IGNORE INTO _migrations (id) VALUES (2);
+  `,
+  `
+CREATE TABLE IF NOT EXISTS sandbox_sessions_new (
+  id TEXT PRIMARY KEY,
+  sandbox_id TEXT NOT NULL REFERENCES sandboxes(id) ON DELETE CASCADE,
+  agent_name TEXT,
+  agent_type TEXT,
+  command TEXT,
+  status TEXT NOT NULL DEFAULT 'running' CHECK(status IN ('running', 'completed', 'failed', 'killed')),
+  exit_code INTEGER,
+  started_at TEXT NOT NULL DEFAULT (datetime('now')),
+  ended_at TEXT
+);
+INSERT INTO sandbox_sessions_new SELECT * FROM sandbox_sessions;
+DROP TABLE sandbox_sessions;
+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);
   `
 ];
 var db = null;
@@ -1324,6 +1370,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";
@@ -1518,6 +1603,117 @@ function emitLifecycleEvent(sandboxId, message) {
   });
   notifyListeners(sandboxId, "lifecycle", message);
 }
+// src/lib/agents/claude.ts
+class ClaudeDriver {
+  name = "claude";
+  requiredEnvVars = ["ANTHROPIC_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which claude 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @anthropic-ai/claude-code 2>&1 || sudo npm install -g @anthropic-ai/claude-code 2>&1");
+  }
+  async configure(provider, providerSandboxId, _envVars) {
+    const config = JSON.stringify({
+      hasCompletedOnboarding: true,
+      hasTrustDialogAccepted: true,
+      hasAcknowledgedCostThreshold: true
+    });
+    await provider.exec(providerSandboxId, `mkdir -p ~/.claude && echo '${config}' > ~/.claude.json`);
+  }
+  buildCommand(prompt) {
+    return `claude --dangerously-skip-permissions -p ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/codex.ts
+class CodexDriver {
+  name = "codex";
+  requiredEnvVars = ["OPENAI_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which codex 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @openai/codex 2>&1 || sudo npm install -g @openai/codex 2>&1");
+  }
+  async configure(provider, providerSandboxId, _envVars) {
+    const config = `[core]
+approvalMode = "full-auto"
+quiet = true
+`;
+    await provider.exec(providerSandboxId, `mkdir -p ~/.codex && printf '${config.replace(/'/g, "'\\''")}' > ~/.codex/config.toml`);
+  }
+  buildCommand(prompt) {
+    return `codex --approval-mode full-auto -q ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/gemini.ts
+class GeminiDriver {
+  name = "gemini";
+  requiredEnvVars = ["GEMINI_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which gemini 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @google/gemini-cli 2>&1 || sudo npm install -g @google/gemini-cli 2>&1");
+  }
+  async configure(provider, providerSandboxId, _envVars) {
+    const settings = JSON.stringify({ theme: "Default", selectedAuthType: "gemini-api-key" });
+    await provider.exec(providerSandboxId, `mkdir -p ~/.gemini && echo '${settings}' > ~/.gemini/settings.json`);
+  }
+  buildCommand(prompt) {
+    return `gemini -p ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/opencode.ts
+class OpenCodeDriver {
+  name = "opencode";
+  requiredEnvVars = [];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which opencode 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g opencode-ai 2>&1 || sudo npm install -g opencode-ai 2>&1");
+  }
+  async configure(_provider, _providerSandboxId, _envVars) {}
+  buildCommand(prompt) {
+    return `opencode run ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/pi.ts
+class PiDriver {
+  name = "pi";
+  requiredEnvVars = ["PI_API_KEY"];
+  async install(provider, providerSandboxId) {
+    const check = await provider.exec(providerSandboxId, "which pi 2>/dev/null || echo MISSING");
+    if (check.stdout.trim() !== "MISSING")
+      return;
+    await provider.exec(providerSandboxId, "npm install -g @pi-ai/cli 2>&1 || sudo npm install -g @pi-ai/cli 2>&1");
+  }
+  async configure(_provider, _providerSandboxId, _envVars) {}
+  buildCommand(prompt) {
+    return `pi ask ${JSON.stringify(prompt)}`;
+  }
+}
+
+// src/lib/agents/index.ts
+var DRIVERS = [
+  new ClaudeDriver,
+  new CodexDriver,
+  new GeminiDriver,
+  new OpenCodeDriver,
+  new PiDriver
+];
+var DRIVER_MAP = new Map(DRIVERS.map((d) => [d.name, d]));
+function getAgentDriver(name) {
+  return DRIVER_MAP.get(name);
+}
+function listAgentDrivers() {
+  return DRIVERS;
+}
 export {
   uuid,
   updateSession,
@@ -1532,14 +1728,17 @@ export {
   loadConfig,
   listWebhooks,
   listTemplates,
+  listSnapshots,
   listSessions,
   listSandboxes,
   listProjects,
   listEvents,
   listAgents,
+  listAgentDrivers,
   getWebhook,
   getTemplateByName,
   getTemplate,
+  getSnapshot,
   getSession,
   getSandbox,
   getProviderApiKey,
@@ -1551,6 +1750,7 @@ export {
   getDefaultImage,
   getDatabase,
   getConfigValue,
+  getAgentDriver,
   getAgentByName,
   getAgent,
   ensureProject,
@@ -1558,12 +1758,14 @@ export {
   emitLifecycleEvent,
   deleteWebhook,
   deleteTemplate,
+  deleteSnapshot,
   deleteSandbox,
   deleteProject,
   deleteAgent,
   createWebhook,
   createTemplate,
   createStreamCollector,
+  createSnapshot,
   createSession,
   createSandbox,
   createProject,
@@ -1572,6 +1774,7 @@ export {
   addEvent,
   WebhookNotFoundError,
   TemplateNotFoundError,
+  SnapshotNotFoundError,
   SessionNotFoundError,
   SandboxNotFoundError,
   SESSION_STATUSES,

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":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAc/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,CAkDzB;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAehE"}
+{"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"}