runcastle 1.0.0 → 1.0.1

package/bin/runcastle.js

@@ -4897,7 +4897,7 @@ async function sandcastleImageProbe(exec, imageName) {
       tier: 2,
       status: "missing",
       detail: `image ${imageName} not found locally`,
-      fix: "Build it: sandcastle docker build-image (nothing builds it for you)."
+      fix: 'Start runcastle and click "Build image" on the Enable AFK burns card \u2014 it builds this for you (one click). Only needed for AFK/sandboxed burns.'
     };
   }
   return {
@@ -4906,7 +4906,7 @@ async function sandcastleImageProbe(exec, imageName) {
     tier: 2,
     status: "missing",
     detail: "no container runtime available to inspect the image",
-    fix: "Install a container runtime first, then build: sandcastle docker build-image"
+    fix: "Install a container runtime (Docker or Podman) first, then build the image from the Enable AFK burns card in the app."
   };
 }
 function afkTokenProbe(env) {
@@ -5055,10 +5055,38 @@ async function resolveRuntime(exec, preferred) {
     return other;
   return preferred;
 }
+function resolveSandcastleBin() {
+  try {
+    const mainUrl = import.meta.resolve("@ai-hero/sandcastle");
+    let dir = dirname7(fileURLToPath6(mainUrl));
+    for (let hops = 0;hops < 6; hops++) {
+      const manifestPath = join14(dir, "package.json");
+      if (existsSync16(manifestPath)) {
+        const manifest = JSON.parse(readFileSync7(manifestPath, "utf8"));
+        if (manifest.name === "@ai-hero/sandcastle" && manifest.bin?.sandcastle) {
+          return join14(dir, manifest.bin.sandcastle);
+        }
+      }
+      const parent = dirname7(dir);
+      if (parent === dir)
+        break;
+      dir = parent;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 function terminalSpec(kind, opts) {
   if (kind === "setup-token")
     return { cmd: "claude", args: ["setup-token"] };
-  return { cmd: "sandcastle", args: [opts.runtime, "build-image", "--image-name", opts.imageName] };
+  if (!opts.sandcastleBin) {
+    throw new NotFoundError("The bundled sandcastle CLI (@ai-hero/sandcastle) could not be located \u2014 reinstall runcastle.");
+  }
+  return {
+    cmd: "node",
+    args: [opts.sandcastleBin, opts.runtime, "build-image", "--image-name", opts.imageName]
+  };
 }
 function sandcastleTemplateDir() {
   return resolveAsset(ASSET_ENV.sandcastleTemplate, fileURLToPath6(new URL("../assets/sandcastle", import.meta.url)));
@@ -5132,7 +5160,8 @@ var init_setup2 = __esm(() => {
       const preferred = ctx.config.sandbox === "podman" ? "podman" : "docker";
       const runtime = await resolveRuntime(exec, preferred);
       const imageName = ctx.config.sandboxImage ?? "sandcastle:runcastle";
-      const spec = terminalSpec(input.kind, { runtime, imageName });
+      const sandcastleBin = input.kind === "build-image" ? resolveSandcastleBin() ?? undefined : undefined;
+      const spec = terminalSpec(input.kind, { runtime, imageName, sandcastleBin });
       const sessionId = newId("setup");
       const cwd = input.kind === "build-image" ? prepareSandboxBuildContext() : process.cwd();
       const resolved = resolveExecutable(spec.cmd);

package/index.js

@@ -4896,7 +4896,7 @@ async function sandcastleImageProbe(exec, imageName) {
       tier: 2,
       status: "missing",
       detail: `image ${imageName} not found locally`,
-      fix: "Build it: sandcastle docker build-image (nothing builds it for you)."
+      fix: 'Start runcastle and click "Build image" on the Enable AFK burns card \u2014 it builds this for you (one click). Only needed for AFK/sandboxed burns.'
     };
   }
   return {
@@ -4905,7 +4905,7 @@ async function sandcastleImageProbe(exec, imageName) {
     tier: 2,
     status: "missing",
     detail: "no container runtime available to inspect the image",
-    fix: "Install a container runtime first, then build: sandcastle docker build-image"
+    fix: "Install a container runtime (Docker or Podman) first, then build the image from the Enable AFK burns card in the app."
   };
 }
 function afkTokenProbe(env) {
@@ -5054,10 +5054,38 @@ async function resolveRuntime(exec, preferred) {
     return other;
   return preferred;
 }
+function resolveSandcastleBin() {
+  try {
+    const mainUrl = import.meta.resolve("@ai-hero/sandcastle");
+    let dir = dirname7(fileURLToPath6(mainUrl));
+    for (let hops = 0;hops < 6; hops++) {
+      const manifestPath = join14(dir, "package.json");
+      if (existsSync16(manifestPath)) {
+        const manifest = JSON.parse(readFileSync7(manifestPath, "utf8"));
+        if (manifest.name === "@ai-hero/sandcastle" && manifest.bin?.sandcastle) {
+          return join14(dir, manifest.bin.sandcastle);
+        }
+      }
+      const parent = dirname7(dir);
+      if (parent === dir)
+        break;
+      dir = parent;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
 function terminalSpec(kind, opts) {
   if (kind === "setup-token")
     return { cmd: "claude", args: ["setup-token"] };
-  return { cmd: "sandcastle", args: [opts.runtime, "build-image", "--image-name", opts.imageName] };
+  if (!opts.sandcastleBin) {
+    throw new NotFoundError("The bundled sandcastle CLI (@ai-hero/sandcastle) could not be located \u2014 reinstall runcastle.");
+  }
+  return {
+    cmd: "node",
+    args: [opts.sandcastleBin, opts.runtime, "build-image", "--image-name", opts.imageName]
+  };
 }
 function sandcastleTemplateDir() {
   return resolveAsset(ASSET_ENV.sandcastleTemplate, fileURLToPath6(new URL("../assets/sandcastle", import.meta.url)));
@@ -5131,7 +5159,8 @@ var init_setup2 = __esm(() => {
       const preferred = ctx.config.sandbox === "podman" ? "podman" : "docker";
       const runtime = await resolveRuntime(exec, preferred);
       const imageName = ctx.config.sandboxImage ?? "sandcastle:runcastle";
-      const spec = terminalSpec(input.kind, { runtime, imageName });
+      const sandcastleBin = input.kind === "build-image" ? resolveSandcastleBin() ?? undefined : undefined;
+      const spec = terminalSpec(input.kind, { runtime, imageName, sandcastleBin });
       const sessionId = newId("setup");
       const cwd = input.kind === "build-image" ? prepareSandboxBuildContext() : process.cwd();
       const resolved = resolveExecutable(spec.cmd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcastle",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "bin": {
     "runcastle": "./bin/runcastle.js"