@ai-hero/sandcastle 0.4.8 → 0.5.0

package/dist/sandboxes/test-bind-mount.js

@@ -0,0 +1,91 @@
+/**
+ * Filesystem-based test bind-mount sandbox provider.
+ *
+ * Uses a temp directory on the local filesystem as the "sandbox".
+ * Intended for testing the bind-mount provider abstraction without
+ * requiring Docker or Podman.
+ */
+import { execFile, spawn } from "node:child_process";
+import { copyFile, mkdir, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { createInterface } from "node:readline";
+import { createBindMountSandboxProvider, } from "../SandboxProvider.js";
+/**
+ * Create a filesystem-based test bind-mount sandbox provider.
+ *
+ * The "sandbox" is a temp directory. `exec` runs shell commands in it,
+ * `copyFileIn`/`copyFileOut` copy single files between host and the temp dir,
+ * and `close` removes the temp dir.
+ */
+export const testBindMount = () => createBindMountSandboxProvider({
+    name: "test-bind-mount",
+    create: async () => {
+        const sandboxRoot = await mkdtemp(join(tmpdir(), "sandcastle-test-bm-"));
+        const worktreePath = join(sandboxRoot, "workspace");
+        await mkdir(worktreePath, { recursive: true });
+        return {
+            worktreePath,
+            exec: (command, options) => {
+                if (options?.onLine) {
+                    const onLine = options.onLine;
+                    return new Promise((resolve, reject) => {
+                        const proc = spawn("sh", ["-c", command], {
+                            cwd: options?.cwd ?? worktreePath,
+                            stdio: ["ignore", "pipe", "pipe"],
+                        });
+                        const stdoutChunks = [];
+                        const stderrChunks = [];
+                        const rl = createInterface({ input: proc.stdout });
+                        rl.on("line", (line) => {
+                            stdoutChunks.push(line);
+                            onLine(line);
+                        });
+                        proc.stderr.on("data", (chunk) => {
+                            stderrChunks.push(chunk.toString());
+                        });
+                        proc.on("error", (error) => {
+                            reject(new Error(`exec failed: ${error.message}`));
+                        });
+                        proc.on("close", (code) => {
+                            resolve({
+                                stdout: stdoutChunks.join("\n"),
+                                stderr: stderrChunks.join(""),
+                                exitCode: code ?? 0,
+                            });
+                        });
+                    });
+                }
+                return new Promise((resolve, reject) => {
+                    execFile("sh", ["-c", command], {
+                        cwd: options?.cwd ?? worktreePath,
+                        maxBuffer: 10 * 1024 * 1024,
+                    }, (error, stdout, stderr) => {
+                        if (error && error.code === undefined) {
+                            reject(new Error(`exec failed: ${error.message}`));
+                        }
+                        else {
+                            resolve({
+                                stdout: stdout.toString(),
+                                stderr: stderr.toString(),
+                                exitCode: typeof error?.code === "number" ? error.code : 0,
+                            });
+                        }
+                    });
+                });
+            },
+            copyFileIn: async (hostPath, sandboxPath) => {
+                await mkdir(dirname(sandboxPath), { recursive: true });
+                await copyFile(hostPath, sandboxPath);
+            },
+            copyFileOut: async (sandboxPath, hostPath) => {
+                await mkdir(dirname(hostPath), { recursive: true });
+                await copyFile(sandboxPath, hostPath);
+            },
+            close: async () => {
+                await rm(sandboxRoot, { recursive: true, force: true });
+            },
+        };
+    },
+});
+//# sourceMappingURL=test-bind-mount.js.map

package/dist/sandboxes/test-bind-mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-bind-mount.js","sourceRoot":"","sources":["../../src/sandboxes/test-bind-mount.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,8BAA8B,GAI/B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAA6B,EAAE,CAC1D,8BAA8B,CAAC;IAC7B,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,KAAK,IAAqC,EAAE;QAClD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,OAAO;YACL,YAAY;YAEZ,IAAI,EAAE,CACJ,OAAe,EACf,OAIC,EACoB,EAAE;gBACvB,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;oBACpB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;oBAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;wBACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE;4BACxC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,YAAY;4BACjC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;yBAClC,CAAC,CAAC;wBAEH,MAAM,YAAY,GAAa,EAAE,CAAC;wBAClC,MAAM,YAAY,GAAa,EAAE,CAAC;wBAElC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAO,EAAE,CAAC,CAAC;wBACpD,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;4BACrB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;4BACxB,MAAM,CAAC,IAAI,CAAC,CAAC;wBACf,CAAC,CAAC,CAAC;wBAEH,IAAI,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;4BACxC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;wBACtC,CAAC,CAAC,CAAC;wBAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;4BACzB,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;wBACrD,CAAC,CAAC,CAAC;wBAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;4BACxB,OAAO,CAAC;gCACN,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;gCAC/B,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gCAC7B,QAAQ,EAAE,IAAI,IAAI,CAAC;6BACpB,CAAC,CAAC;wBACL,CAAC,CAAC,CAAC;oBACL,CAAC,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBACrC,QAAQ,CACN,IAAI,EACJ,CAAC,IAAI,EAAE,OAAO,CAAC,EACf;wBACE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,YAAY;wBACjC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;qBAC5B,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;wBACxB,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;4BACtC,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;wBACrD,CAAC;6BAAM,CAAC;4BACN,OAAO,CAAC;gCACN,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;gCACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;gCACzB,QAAQ,EAAE,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;6BAC3D,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC,CACF,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC;YAED,UAAU,EAAE,KAAK,EACf,QAAgB,EAChB,WAAmB,EACJ,EAAE;gBACjB,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvD,MAAM,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACxC,CAAC;YAED,WAAW,EAAE,KAAK,EAChB,WAAmB,EACnB,QAAgB,EACD,EAAE;gBACjB,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpD,MAAM,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACxC,CAAC;YAED,KAAK,EAAE,KAAK,IAAmB,EAAE;gBAC/B,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/templates/parallel-planner/main.mts

@@ -30,7 +30,7 @@ const MAX_ITERATIONS = 10;
 // Hooks run inside the sandbox before the agent starts each iteration.
 // npm install ensures the sandbox always has fresh dependencies.
 const hooks = {
-  onSandboxReady: [{ command: "npm install" }],
+  sandbox: { onSandboxReady: [{ command: "npm install" }] },
 };
 
 // Copy node_modules from the host into the worktree before each sandbox

package/dist/templates/parallel-planner-with-review/main.mts

@@ -35,7 +35,7 @@ const MAX_ITERATIONS = 10;
 // Hooks run inside the sandbox before the agent starts each iteration.
 // npm install ensures the sandbox always has fresh dependencies.
 const hooks = {
-  onSandboxReady: [{ command: "npm install" }],
+  sandbox: { onSandboxReady: [{ command: "npm install" }] },
 };
 
 // Copy node_modules from the host into the worktree before each sandbox

package/dist/templates/sequential-reviewer/main.mts

@@ -30,7 +30,7 @@ const MAX_ITERATIONS = 10;
 // Hooks run inside the sandbox before the agent starts each iteration.
 // npm install ensures the sandbox always has fresh dependencies.
 const hooks = {
-  onSandboxReady: [{ command: "npm install" }],
+  sandbox: { onSandboxReady: [{ command: "npm install" }] },
 };
 
 // Copy node_modules from the host into the worktree before each sandbox

package/dist/templates/simple-loop/main.mts

@@ -38,11 +38,13 @@ await run({
   // platform-specific binaries and any packages added since the last copy.
   copyToWorktree: ["node_modules"],
 
-  // Lifecycle hooks — commands that run inside the sandbox at specific points.
+  // Lifecycle hooks — commands grouped by where they run (host or sandbox).
   hooks: {
-    // onSandboxReady runs once after the sandbox is initialised and the repo is
-    // synced in, before the agent starts. Use it to install dependencies or run
-    // any other setup steps your project needs.
-    onSandboxReady: [{ command: "npm install" }],
+    sandbox: {
+      // onSandboxReady runs once after the sandbox is initialised and the repo is
+      // synced in, before the agent starts. Use it to install dependencies or run
+      // any other setup steps your project needs.
+      onSandboxReady: [{ command: "npm install" }],
+    },
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-hero/sandcastle",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "description": "CLI for orchestrating AI agents in isolated sandbox environments",
   "type": "module",
   "main": "./dist/index.js",