@hasna/sandboxes 0.1.12 → 0.1.13

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.13",
   "author": "Andrei Hasna <andrei@hasna.com>",
   "repository": {
     "type": "git",