@hasna/sandboxes 0.1.9 → 0.1.11

package/dist/cli/index.js

@@ -3364,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";
@@ -3543,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, {
@@ -3558,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, {
@@ -3590,6 +3609,7 @@ var init_agent_runner = __esm(() => {
   init_providers();
   init_stream();
   init_agents();
+  init_runtime_state();
 });
 
 // node_modules/commander/esm.mjs
@@ -3669,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("  ");
@@ -3720,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();
@@ -3737,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({
@@ -3756,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);
   }
 });
@@ -3812,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) {
@@ -3823,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, {
@@ -3836,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/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/index.js

@@ -1,20 +1,5 @@
 // @bun
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -1308,11 +1293,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();

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

package/dist/mcp/index.js

@@ -1,21 +1,6 @@
 #!/usr/bin/env bun
 // @bun
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -5203,11 +5188,11 @@ function listProjects() {
   const rows = db2.query("SELECT * FROM projects ORDER BY created_at DESC").all();
   return rows.map(rowToProject);
 }
-function ensureProject(name, path) {
+function ensureProject(name, path, description) {
   const existing = getProjectByPath(path);
   if (existing)
     return existing;
-  return createProject({ name, path });
+  return createProject({ name, path, description });
 }
 
 // src/db/templates.ts
@@ -5538,6 +5523,21 @@ function getAgentDriver(name) {
   return DRIVER_MAP.get(name);
 }
 
+// src/lib/runtime-state.ts
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function finalizeSessionExit(sessionId, exitCode) {
+  endSession(sessionId, exitCode, exitCode === 0 ? "completed" : "failed");
+}
+function finalizeSessionFailure(sessionId, _error, exitCode = 1) {
+  endSession(sessionId, exitCode, "failed");
+}
+function finalizeSandboxProvisionFailure(sandboxId, error) {
+  updateSandbox(sandboxId, { status: "error" });
+  return getErrorMessage(error);
+}
+
 // src/lib/agent-runner.ts
 async function fireWebhook(url, payload) {
   try {
@@ -5600,7 +5600,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, {
@@ -5615,7 +5615,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, {
@@ -5684,6 +5684,17 @@ function getBuiltinImageSetupScript(image) {
   return BUILTIN_IMAGES[image]?.setup_script;
 }
 
+// src/lib/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+var cachedVersion;
+function getPackageVersion() {
+  if (cachedVersion)
+    return cachedVersion;
+  const packageJson = JSON.parse(readFileSync2(new URL("../../package.json", import.meta.url), "utf8"));
+  cachedVersion = packageJson.version ?? "0.0.0";
+  return cachedVersion;
+}
+
 // src/mcp/index.ts
 var E2B_COST_PER_SECOND = 0.000014;
 var DAYTONA_COST_PER_SECOND = 0.00001;
@@ -5718,6 +5729,7 @@ var TOOL_CATALOG = [
   { name: "read_file", description: "Read a file from a sandbox" },
   { name: "write_file", description: "Write a file to a sandbox" },
   { name: "list_files", description: "List files in a sandbox directory" },
+  { name: "get_session", description: "Get session details and exit code (useful for background commands)" },
   { name: "get_logs", description: "Get sandbox/session event logs" },
   { name: "register_agent", description: "Register an agent" },
   { name: "list_agents", description: "List all registered agents" },
@@ -5744,7 +5756,7 @@ var TOOL_CATALOG = [
 ];
 var server = new McpServer({
   name: "sandboxes",
-  version: "0.1.0"
+  version: getPackageVersion()
 });
 server.tool("create_sandbox", "Create a new sandbox", {
   provider: exports_external.string().optional().describe("Provider name (e2b, daytona, modal)"),
@@ -5760,6 +5772,7 @@ server.tool("create_sandbox", "Create a new sandbox", {
   budget_limit_usd: exports_external.number().optional().describe("Auto-terminate sandbox if compute cost exceeds this USD amount"),
   on_budget_exceeded: exports_external.enum(["terminate", "pause", "notify"]).optional().describe("Action when budget limit is reached (default: terminate)")
 }, async (params) => {
+  let sandboxId;
   try {
     const providerName = params.provider ?? getDefaultProvider();
     const timeout = params.timeout ?? getDefaultTimeout();
@@ -5787,6 +5800,7 @@ server.tool("create_sandbox", "Create a new sandbox", {
       budget_limit_usd: params.budget_limit_usd,
       on_budget_exceeded: params.on_budget_exceeded
     });
+    sandboxId = sandbox.id;
     const provider = await getProvider(providerName);
     if (params.snapshot_id) {
       const snapshot = getSnapshot(params.snapshot_id);
@@ -5823,6 +5837,9 @@ server.tool("create_sandbox", "Create a new sandbox", {
     }
     return ok(updated);
   } catch (e) {
+    if (sandboxId) {
+      finalizeSandboxProvisionFailure(sandboxId, e);
+    }
     return err(e);
   }
 });
@@ -5907,6 +5924,7 @@ server.tool("exec_command", "Execute a command in a sandbox", {
   stdin: exports_external.string().optional().describe("String to pipe as stdin to the command"),
   tty: exports_external.boolean().optional().describe("Allocate a TTY for the session (best-effort)")
 }, async (params) => {
+  let sessionId;
   try {
     const sandbox = getSandbox(params.sandbox_id);
     if (!sandbox.provider_sandbox_id)
@@ -5915,6 +5933,7 @@ server.tool("exec_command", "Execute a command in a sandbox", {
       sandbox_id: sandbox.id,
       command: params.command
     });
+    sessionId = session.id;
     const collector = createStreamCollector(sandbox.id, session.id);
     const provider = await getProvider(sandbox.provider);
     const callEnv = { ...sandbox.env_vars, ...params.env_vars };
@@ -5928,9 +5947,9 @@ server.tool("exec_command", "Execute a command in a sandbox", {
         tty: params.tty
       }).then((res) => {
         const r = res;
-        endSession(session.id, r.exit_code ?? 0);
+        finalizeSessionExit(session.id, r.exit_code ?? 0);
       }).catch(() => {
-        endSession(session.id, 1);
+        finalizeSessionFailure(session.id);
       });
       return ok({ session_id: session.id, background: true });
     }
@@ -5942,7 +5961,7 @@ server.tool("exec_command", "Execute a command in a sandbox", {
       tty: params.tty
     });
     const execResult = result;
-    endSession(session.id, execResult.exit_code);
+    finalizeSessionExit(session.id, execResult.exit_code);
     return ok({
       session_id: session.id,
       exit_code: execResult.exit_code,
@@ -5950,6 +5969,9 @@ server.tool("exec_command", "Execute a command in a sandbox", {
       stderr: execResult.stderr
     });
   } catch (e) {
+    if (sessionId) {
+      finalizeSessionFailure(sessionId, e);
+    }
     return err(e);
   }
 });
@@ -6011,6 +6033,16 @@ server.tool("list_files", "List files in a sandbox directory", {
     return err(e);
   }
 });
+server.tool("get_session", "Get session details and exit code (useful for polling background command results)", {
+  session_id: exports_external.string().describe("Session ID")
+}, async (params) => {
+  try {
+    const session = getSession(params.session_id);
+    return ok(session);
+  } catch (e) {
+    return err(e);
+  }
+});
 server.tool("get_logs", "Get sandbox/session event logs", {
   sandbox_id: exports_external.string().optional().describe("Filter by sandbox ID"),
   session_id: exports_external.string().optional().describe("Filter by session ID"),
@@ -6049,8 +6081,7 @@ server.tool("register_project", "Register a project", {
   description: exports_external.string().optional().describe("Project description")
 }, async (params) => {
   try {
-    const project = ensureProject(params.name, params.path);
-    return ok(project);
+    return ok(ensureProject(params.name, params.path, params.description));
   } catch (e) {
     return err(e);
   }

package/dist/server/index.js

@@ -1,21 +1,6 @@
 #!/usr/bin/env bun
 // @bun
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
@@ -1245,11 +1230,11 @@ function listProjects() {
   const rows = db2.query("SELECT * FROM projects ORDER BY created_at DESC").all();
   return rows.map(rowToProject);
 }
-function ensureProject(name, path) {
+function ensureProject(name, path, description) {
   const existing = getProjectByPath(path);
   if (existing)
     return existing;
-  return createProject({ name, path });
+  return createProject({ name, path, description });
 }
 
 // src/db/webhooks.ts
@@ -1443,6 +1428,32 @@ function emitLifecycleEvent(sandboxId, message) {
   notifyListeners(sandboxId, "lifecycle", message);
 }
 
+// src/lib/runtime-state.ts
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function finalizeSessionExit(sessionId, exitCode) {
+  endSession(sessionId, exitCode, exitCode === 0 ? "completed" : "failed");
+}
+function finalizeSessionFailure(sessionId, _error, exitCode = 1) {
+  endSession(sessionId, exitCode, "failed");
+}
+function finalizeSandboxProvisionFailure(sandboxId, error) {
+  updateSandbox(sandboxId, { status: "error" });
+  return getErrorMessage(error);
+}
+
+// src/lib/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/server/serve.ts
 function json(data, status = 200) {
   return new Response(JSON.stringify(data), {
@@ -1488,7 +1499,7 @@ async function handleRequest(req) {
     return json({ ok: true });
   }
   if (pathname === "/api/health" && method === "GET") {
-    return json({ status: "ok", version: "0.1.0" });
+    return json({ status: "ok", version: getPackageVersion() });
   }
   if (pathname === "/api/sandboxes" && method === "GET") {
     const status = url.searchParams.get("status") || undefined;
@@ -1500,11 +1511,13 @@ async function handleRequest(req) {
     return json(result);
   }
   if (pathname === "/api/sandboxes" && method === "POST") {
+    let sandboxId;
     try {
       const input = await body(req);
       const providerName = input.provider || getDefaultProvider();
       const timeout = input.timeout || getDefaultTimeout();
       const sandbox = createSandbox({ ...input, provider: providerName, timeout });
+      sandboxId = sandbox.id;
       const provider = await getProvider(providerName);
       const providerSandbox = await provider.create({
         image: input.image,
@@ -1518,7 +1531,8 @@ async function handleRequest(req) {
       emitLifecycleEvent(sandbox.id, `Sandbox created with provider ${providerName}`);
       return json(updated, 201);
     } catch (err) {
-      return error(err.message, 500);
+      const message = sandboxId ? finalizeSandboxProvisionFailure(sandboxId, err) : getErrorMessage(err);
+      return error(message, 500);
     }
   }
   let params = matchRoute(pathname, method, "/api/sandboxes/:id", "GET");
@@ -1561,6 +1575,7 @@ async function handleRequest(req) {
   }
   params = matchRoute(pathname, method, "/api/sandboxes/:id/exec", "POST");
   if (params) {
+    let sessionId;
     try {
       const sandbox = getSandbox(params["id"]);
       if (!sandbox.provider_sandbox_id) {
@@ -1568,6 +1583,7 @@ async function handleRequest(req) {
       }
       const { command } = await body(req);
       const session = createSession({ sandbox_id: sandbox.id, command });
+      sessionId = session.id;
       const collector = createStreamCollector(sandbox.id, session.id);
       const provider = await getProvider(sandbox.provider);
       const result = await provider.exec(sandbox.provider_sandbox_id, command, {
@@ -1575,12 +1591,15 @@ async function handleRequest(req) {
         onStderr: collector.onStderr
       });
       if ("exit_code" in result) {
-        endSession(session.id, result.exit_code);
+        finalizeSessionExit(session.id, result.exit_code);
         return json({ session_id: session.id, ...result });
       }
       return json({ session_id: session.id, status: "running" });
     } catch (err) {
-      return error(err.message, 500);
+      if (sessionId) {
+        finalizeSessionFailure(sessionId, err);
+      }
+      return error(getErrorMessage(err), 500);
     }
   }
   params = matchRoute(pathname, method, "/api/sandboxes/:id/keep-alive", "POST");
@@ -1645,7 +1664,7 @@ async function handleRequest(req) {
   if (pathname === "/api/projects" && method === "POST") {
     try {
       const input = await body(req);
-      return json(ensureProject(input.name, input.path), 201);
+      return json(ensureProject(input.name, input.path, input.description), 201);
     } catch (err) {
       return error(err.message, 500);
     }

package/dist/server/serve.d.ts

@@ -1,2 +1,3 @@
+export declare function handleRequest(req: Request): Promise<Response>;
 export declare function startServer(port: number): void;
 //# sourceMappingURL=serve.d.ts.map

package/dist/server/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAyVA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO9C"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAuEA,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+RnE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/sandboxes",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "author": "Andrei Hasna <andrei@hasna.com>",
   "repository": {
     "type": "git",
@@ -10,7 +10,6 @@
   "dependencies": {
     "@daytonaio/sdk": "^0.18.0",
     "@e2b/code-interpreter": "^1.5.0",
-    "@hasna/sandboxes": "^0.1.8",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",