@hasna/sandboxes 0.1.12 → 0.1.14

package/dist/cli/index.js

@@ -3932,6 +3932,23 @@ program2.command("delete <id>").description("Delete a sandbox").action(async (id
     handleError(err);
   }
 });
+for (const alias of ["remove", "uninstall", "rm"]) {
+  program2.command(`${alias} <id>`).description(`Delete a sandbox (alias for delete)`).action(async (id) => {
+    try {
+      const sandbox = getSandbox(id);
+      if (sandbox.provider_sandbox_id) {
+        try {
+          const p = await getProvider(sandbox.provider);
+          await p.delete(sandbox.provider_sandbox_id);
+        } catch {}
+      }
+      deleteSandbox(sandbox.id);
+      console.log(chalk.green(`Sandbox ${shortId(sandbox.id)} deleted.`));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+}
 program2.command("logs <id>").description("Show event logs for a sandbox").option("-f, --follow", "Follow log output").option("-s, --session <session_id>", "Filter by session ID").option("-l, --limit <n>", "Max number of events", "50").action(async (id, opts) => {
   try {
     const sandbox = getSandbox(id);

package/dist/mcp/index.js

@@ -5942,8 +5942,10 @@ server.tool("exec_command", "Execute a command in a sandbox", {
     const provider = await getProvider(sandbox.provider);
     const callEnv = { ...sandbox.env_vars, ...params.env_vars };
     const env = Object.keys(callEnv).length > 0 ? callEnv : undefined;
+    const needsShell = /<<\s*['"]?[A-Z]+['"]?/.test(params.command);
+    const effectiveCommand = needsShell ? `bash -c ${JSON.stringify(params.command)}` : params.command;
     if (params.background) {
-      provider.exec(sandbox.provider_sandbox_id, params.command, {
+      provider.exec(sandbox.provider_sandbox_id, effectiveCommand, {
         onStdout: collector.onStdout,
         onStderr: collector.onStderr,
         env,
@@ -5955,9 +5957,13 @@ server.tool("exec_command", "Execute a command in a sandbox", {
       }).catch(() => {
         finalizeSessionFailure(session.id);
       });
-      return ok({ session_id: session.id, background: true });
+      return ok({
+        session_id: session.id,
+        background: true,
+        message: "Command started in background. Use get_session to check completion status and exit_code. Use bg_wait_session to block until done."
+      });
     }
-    const result = await provider.exec(sandbox.provider_sandbox_id, params.command, {
+    const result = await provider.exec(sandbox.provider_sandbox_id, effectiveCommand, {
       onStdout: collector.onStdout,
       onStderr: collector.onStderr,
       env,
@@ -6047,6 +6053,36 @@ server.tool("get_session", "Get session details and exit code (useful for pollin
     return err(e);
   }
 });
+server.tool("bg_wait_session", "Wait (poll) for a background command session to complete. Returns exit_code, stdout, stderr when done. Use after exec_command with background:true.", {
+  session_id: exports_external.string().describe("Session ID from exec_command background:true response"),
+  timeout_seconds: exports_external.number().optional().describe("Max seconds to wait (default: 300)"),
+  poll_interval_ms: exports_external.number().optional().describe("Poll interval in ms (default: 1000)")
+}, async (params) => {
+  try {
+    const timeoutMs = (params.timeout_seconds ?? 300) * 1000;
+    const pollMs = params.poll_interval_ms ?? 1000;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+      const session = getSession(params.session_id);
+      if (session.status === "completed" || session.status === "failed" || session.status === "killed") {
+        const events = listEvents({ session_id: session.id, limit: 1e4 });
+        const stdout = events.filter((e) => e.type === "stdout").map((e) => e.data).join("");
+        const stderr = events.filter((e) => e.type === "stderr").map((e) => e.data).join("");
+        return ok({
+          session_id: session.id,
+          status: session.status,
+          exit_code: session.exit_code ?? (session.status === "failed" || session.status === "killed" ? 1 : 0),
+          stdout,
+          stderr
+        });
+      }
+      await new Promise((r) => setTimeout(r, pollMs));
+    }
+    return err(`Session ${params.session_id} did not complete within ${params.timeout_seconds ?? 300}s`);
+  } 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"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/sandboxes",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "author": "Andrei Hasna <andrei@hasna.com>",
   "repository": {
     "type": "git",