runcastle 1.4.7 → 1.4.8

package/bin/runcastle.js

@@ -4640,6 +4640,63 @@ var init_git = __esm(() => {
   ];
 });
 
+// src/doctor/system-exec.ts
+import { spawn as spawn4 } from "child_process";
+function createSystemExec(opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_EXEC_TIMEOUT_MS;
+  const containFn = opts.containFn ?? containHostProcess;
+  return (command, args) => new Promise((resolve4) => {
+    const { file, args: spawnArgs } = resolveSpawnTarget(command, args);
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    const settle = (outcome) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timer);
+      resolve4(outcome);
+    };
+    const child = spawn4(file, spawnArgs, { cwd: opts.cwd, windowsHide: true });
+    const containment = child.pid === undefined ? null : containFn(child.pid);
+    const timer = setTimeout(() => {
+      if (containment)
+        containment.kill();
+      else if (child.pid !== undefined)
+        killProcessTree(child.pid);
+      const note = `${command} ${args.join(" ")} timed out after ${Math.round(timeoutMs / 1000)}s`;
+      settle({
+        ok: true,
+        code: null,
+        stdout,
+        stderr: stderr ? `${stderr}
+${note}` : note,
+        timedOut: true
+      });
+    }, timeoutMs);
+    child.stdout?.on("data", (d) => {
+      stdout += d.toString();
+    });
+    child.stderr?.on("data", (d) => {
+      stderr += d.toString();
+    });
+    child.on("error", (err) => {
+      containment?.kill();
+      settle({ ok: false, code: null, stdout, stderr: stderr || String(err) });
+    });
+    child.on("close", (code) => {
+      containment?.kill();
+      settle({ ok: true, code: code ?? 0, stdout, stderr });
+    });
+  });
+}
+var DEFAULT_EXEC_TIMEOUT_MS = 60000;
+var init_system_exec = __esm(() => {
+  init_kill_tree();
+  init_contain_host();
+  init_resolve_executable();
+});
+
 // src/launcher/edit-guard.ts
 import { isAbsolute, relative, resolve as resolve4 } from "path";
 function guardsEdits(kind) {
@@ -5520,8 +5577,27 @@ function buildClaudeArgs(input) {
     ...input.kickoffLine ? [input.kickoffLine] : []
   ];
 }
-var CC_NESTING_ENV, KICKOFF_LINES, CLAUDE_BIN = "claude", claudeRuntime;
+function findBackgroundSessionIn(listing, ccSessionId) {
+  if (!Array.isArray(listing))
+    return;
+  const held = listing.find((entry) => typeof entry === "object" && entry !== null && entry.sessionId === ccSessionId && entry.kind === "background");
+  if (!held)
+    return;
+  return { sessionId: ccSessionId, shortId: typeof held.id === "string" ? held.id : ccSessionId.slice(0, 8) };
+}
+async function listClaudeAgents() {
+  try {
+    const out = await createSystemExec({ timeoutMs: AGENTS_LISTING_TIMEOUT_MS })(CLAUDE_BIN, ["agents", "--json"]);
+    if (!out.ok || out.timedOut)
+      return;
+    return JSON.parse(out.stdout);
+  } catch {
+    return;
+  }
+}
+var CC_NESTING_ENV, KICKOFF_LINES, AGENTS_LISTING_TIMEOUT_MS = 1e4, CLAUDE_BIN = "claude", claudeRuntime;
 var init_claude = __esm(() => {
+  init_system_exec();
   init_resolve_executable();
   init_artifacts();
   init_skills_root();
@@ -5571,13 +5647,17 @@ var init_claude = __esm(() => {
         }),
         env: {
           RUNCASTLE_SESSION_ID: input.session.id,
-          RUNCASTLE_SERVER_URL: input.serverUrl
+          RUNCASTLE_SERVER_URL: input.serverUrl,
+          CLAUDE_CODE_DISABLE_AGENT_VIEW: "1"
         },
         envScrub: CC_NESTING_ENV
       };
     },
     kickoffLine(kind) {
       return KICKOFF_LINES[kind];
+    },
+    async findBackgroundSession(ccSessionId) {
+      return findBackgroundSessionIn(await listClaudeAgents(), ccSessionId);
     }
   };
 });
@@ -8224,7 +8304,7 @@ var init_chat_branch = __esm(() => {
 });
 
 // src/workflows/kill-registry.ts
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn5 } from "child_process";
 function log2(msg) {
   console.error(`[kill-registry] ${msg}`);
 }
@@ -8241,7 +8321,7 @@ function runDockerCommand(args) {
     const timer = setTimeout(() => settle(false), DOCKER_COMMAND_TIMEOUT_MS);
     timer.unref?.();
     try {
-      const child = spawn4("docker", args, { windowsHide: true, stdio: "ignore" });
+      const child = spawn5("docker", args, { windowsHide: true, stdio: "ignore" });
       child.on("exit", (code) => settle(code === 0));
       child.on("close", (code) => settle(code === 0));
       child.on("error", () => settle(false));
@@ -8372,63 +8452,6 @@ var init_kill_registry = __esm(() => {
   REGISTRY_KEY2 = Symbol.for("runcastle.kill.registry");
 });
 
-// src/doctor/system-exec.ts
-import { spawn as spawn5 } from "child_process";
-function createSystemExec(opts = {}) {
-  const timeoutMs = opts.timeoutMs ?? DEFAULT_EXEC_TIMEOUT_MS;
-  const containFn = opts.containFn ?? containHostProcess;
-  return (command, args) => new Promise((resolve9) => {
-    const { file, args: spawnArgs } = resolveSpawnTarget(command, args);
-    let stdout = "";
-    let stderr = "";
-    let settled = false;
-    const settle = (outcome) => {
-      if (settled)
-        return;
-      settled = true;
-      clearTimeout(timer);
-      resolve9(outcome);
-    };
-    const child = spawn5(file, spawnArgs, { cwd: opts.cwd, windowsHide: true });
-    const containment = child.pid === undefined ? null : containFn(child.pid);
-    const timer = setTimeout(() => {
-      if (containment)
-        containment.kill();
-      else if (child.pid !== undefined)
-        killProcessTree(child.pid);
-      const note = `${command} ${args.join(" ")} timed out after ${Math.round(timeoutMs / 1000)}s`;
-      settle({
-        ok: true,
-        code: null,
-        stdout,
-        stderr: stderr ? `${stderr}
-${note}` : note,
-        timedOut: true
-      });
-    }, timeoutMs);
-    child.stdout?.on("data", (d) => {
-      stdout += d.toString();
-    });
-    child.stderr?.on("data", (d) => {
-      stderr += d.toString();
-    });
-    child.on("error", (err) => {
-      containment?.kill();
-      settle({ ok: false, code: null, stdout, stderr: stderr || String(err) });
-    });
-    child.on("close", (code) => {
-      containment?.kill();
-      settle({ ok: true, code: code ?? 0, stdout, stderr });
-    });
-  });
-}
-var DEFAULT_EXEC_TIMEOUT_MS = 60000;
-var init_system_exec = __esm(() => {
-  init_kill_tree();
-  init_contain_host();
-  init_resolve_executable();
-});
-
 // src/services/settings.ts
 import { existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync6 } from "fs";
 import { dirname as dirname6 } from "path";
@@ -57734,7 +57757,8 @@ function runCommand2(bin, args2) {
     const timer = setTimeout(() => settle(false), COMMAND_TIMEOUT_MS);
     timer.unref?.();
     try {
-      const child = spawn8(bin, [...args2], { windowsHide: true, stdio: "ignore" });
+      const target = spawnTargetFor(bin, [...args2]);
+      const child = spawn8(target.file, target.args, { windowsHide: true, stdio: "ignore" });
       child.on("exit", (code) => settle(code === 0));
       child.on("close", (code) => settle(code === 0));
       child.on("error", () => settle(false));
@@ -57800,6 +57824,7 @@ async function reapRecorder(ticketId, options = {}) {
 var AGENT_BROWSER_BIN = "agent-browser", DEFAULT_TIMEOUT_MS2 = 1e4, POLL_INTERVAL_MS = 100, COMMAND_TIMEOUT_MS = 5000, REAL_DEPS2;
 var init_recorder_reap = __esm(() => {
   init_paths();
+  init_resolve_executable();
   REAL_DEPS2 = {
     findBrowser: () => findOnPath(AGENT_BROWSER_BIN),
     fileExists: existsSync16,
@@ -58410,7 +58435,10 @@ function couldNotReview(ticket, reason, digest) {
 **${headline2}**` : `**${headline2}**`
   };
 }
-var FFMPEG_BIN = "ffmpeg", spawnVersion = (path2) => spawnSync(path2, ["--version"], { timeout: 3000, stdio: "ignore" }), withheldDrives, DECLARATION, REVIEW_DIRECTORY_FS;
+var FFMPEG_BIN = "ffmpeg", spawnVersion = (path2) => {
+  const { file, args: args2 } = spawnTargetFor(path2, ["--version"]);
+  return spawnSync(file, args2, { timeout: 3000, stdio: "ignore", windowsHide: true });
+}, withheldDrives, DECLARATION, REVIEW_DIRECTORY_FS;
 var init_review_ticket = __esm(() => {
   init_src();
   init_paths();
@@ -58420,6 +58448,7 @@ var init_review_ticket = __esm(() => {
   init_agent_stream();
   init_git();
   init_review_findings();
+  init_resolve_executable();
   init_kill_registry();
   init_recorder_reap();
   init_recorder_reap();
@@ -65398,16 +65427,17 @@ function handlePtyExit(ctx, feature, session, meta, exitCode) {
   if (session.runtime === "codex" && feature) {
     noteResolvedMerge(ctx, session, feature).catch(() => {});
   }
+  let resumeFailureReported;
   if (diedBeforeLive && meta.resumeSessionId) {
-    emitForSession(ctx, session, {
-      type: "session.resume_failed",
-      message: `resume failed for ${session.kind} \u2014 the session exited before starting (code ${exitCode ?? "unknown"}); the previous conversation is still resumable`,
-      data: {
-        sessionId: session.id,
-        resumeSessionId: meta.resumeSessionId,
-        exitCode: exitCode ?? null
-      }
-    });
+    const resumeSessionId = meta.resumeSessionId;
+    const report = (background) => emitResumeFailed(ctx, session, resumeSessionId, exitCode, background);
+    if (meta.findBackgroundSession) {
+      resumeFailureReported = meta.findBackgroundSession(resumeSessionId).catch(() => {
+        return;
+      }).then(report);
+    } else {
+      report(undefined);
+    }
   }
   if (session.purpose === "self-plan" && feature) {
     const current2 = getFeatureRow(ctx, feature.id);
@@ -65423,19 +65453,36 @@ function handlePtyExit(ctx, feature, session, meta, exitCode) {
     message: ptyExitMessage(exitCode),
     data: { sessionId: session.id, exitCode: exitCode ?? null }
   });
+  return resumeFailureReported;
+}
+function emitResumeFailed(ctx, session, resumeSessionId, exitCode, background) {
+  const exited = `resume failed for ${session.kind} \u2014 the session exited before starting (code ${exitCode ?? "unknown"})`;
+  const short = background?.shortId;
+  emitForSession(ctx, session, {
+    type: "session.resume_failed",
+    message: short ? `${exited}: its conversation is running as a Claude Code background session (${short}), which cannot be resumed here. ` + `Run \`claude attach ${short}\` to look at it, then \`claude stop ${short}\` (stopping keeps the conversation), then relaunch.` : `${exited}; the previous conversation is still resumable`,
+    data: {
+      sessionId: session.id,
+      resumeSessionId,
+      exitCode: exitCode ?? null,
+      ...short ? { backgroundSessionId: short } : {}
+    }
+  });
 }
 function spawnEmbeddedPty(ctx, feature, session, worktreePath, runtime5, spec, meta = {}) {
   const { file, args: args2 } = spawnTargetFor(runtime5.resolveBinary(), spec.argv);
   const env = { ...process.env, ...spec.env };
   for (const key of spec.envScrub)
     delete env[key];
+  const findBackgroundSession = runtime5.findBackgroundSession?.bind(runtime5);
+  const exitMeta = findBackgroundSession ? { ...meta, findBackgroundSession } : meta;
   try {
     const entry = ptyRegistry().create({
       sessionId: session.id,
       cmd: file,
       args: args2,
       opts: { cwd: worktreePath, env, cols: 80, rows: 24, useConpty: true },
-      onExit: ({ exitCode }) => handlePtyExit(ctx, feature, session, meta, exitCode)
+      onExit: ({ exitCode }) => void handlePtyExit(ctx, feature, session, exitMeta, exitCode)
     });
     if (feature)
       startDocsWatch(ctx, feature);

package/index.js

@@ -4639,6 +4639,63 @@ var init_git = __esm(() => {
   ];
 });
 
+// src/doctor/system-exec.ts
+import { spawn as spawn4 } from "child_process";
+function createSystemExec(opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_EXEC_TIMEOUT_MS;
+  const containFn = opts.containFn ?? containHostProcess;
+  return (command, args) => new Promise((resolve4) => {
+    const { file, args: spawnArgs } = resolveSpawnTarget(command, args);
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    const settle = (outcome) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timer);
+      resolve4(outcome);
+    };
+    const child = spawn4(file, spawnArgs, { cwd: opts.cwd, windowsHide: true });
+    const containment = child.pid === undefined ? null : containFn(child.pid);
+    const timer = setTimeout(() => {
+      if (containment)
+        containment.kill();
+      else if (child.pid !== undefined)
+        killProcessTree(child.pid);
+      const note = `${command} ${args.join(" ")} timed out after ${Math.round(timeoutMs / 1000)}s`;
+      settle({
+        ok: true,
+        code: null,
+        stdout,
+        stderr: stderr ? `${stderr}
+${note}` : note,
+        timedOut: true
+      });
+    }, timeoutMs);
+    child.stdout?.on("data", (d) => {
+      stdout += d.toString();
+    });
+    child.stderr?.on("data", (d) => {
+      stderr += d.toString();
+    });
+    child.on("error", (err) => {
+      containment?.kill();
+      settle({ ok: false, code: null, stdout, stderr: stderr || String(err) });
+    });
+    child.on("close", (code) => {
+      containment?.kill();
+      settle({ ok: true, code: code ?? 0, stdout, stderr });
+    });
+  });
+}
+var DEFAULT_EXEC_TIMEOUT_MS = 60000;
+var init_system_exec = __esm(() => {
+  init_kill_tree();
+  init_contain_host();
+  init_resolve_executable();
+});
+
 // src/launcher/edit-guard.ts
 import { isAbsolute, relative, resolve as resolve4 } from "path";
 function guardsEdits(kind) {
@@ -5519,8 +5576,27 @@ function buildClaudeArgs(input) {
     ...input.kickoffLine ? [input.kickoffLine] : []
   ];
 }
-var CC_NESTING_ENV, KICKOFF_LINES, CLAUDE_BIN = "claude", claudeRuntime;
+function findBackgroundSessionIn(listing, ccSessionId) {
+  if (!Array.isArray(listing))
+    return;
+  const held = listing.find((entry) => typeof entry === "object" && entry !== null && entry.sessionId === ccSessionId && entry.kind === "background");
+  if (!held)
+    return;
+  return { sessionId: ccSessionId, shortId: typeof held.id === "string" ? held.id : ccSessionId.slice(0, 8) };
+}
+async function listClaudeAgents() {
+  try {
+    const out = await createSystemExec({ timeoutMs: AGENTS_LISTING_TIMEOUT_MS })(CLAUDE_BIN, ["agents", "--json"]);
+    if (!out.ok || out.timedOut)
+      return;
+    return JSON.parse(out.stdout);
+  } catch {
+    return;
+  }
+}
+var CC_NESTING_ENV, KICKOFF_LINES, AGENTS_LISTING_TIMEOUT_MS = 1e4, CLAUDE_BIN = "claude", claudeRuntime;
 var init_claude = __esm(() => {
+  init_system_exec();
   init_resolve_executable();
   init_artifacts();
   init_skills_root();
@@ -5570,13 +5646,17 @@ var init_claude = __esm(() => {
         }),
         env: {
           RUNCASTLE_SESSION_ID: input.session.id,
-          RUNCASTLE_SERVER_URL: input.serverUrl
+          RUNCASTLE_SERVER_URL: input.serverUrl,
+          CLAUDE_CODE_DISABLE_AGENT_VIEW: "1"
         },
         envScrub: CC_NESTING_ENV
       };
     },
     kickoffLine(kind) {
       return KICKOFF_LINES[kind];
+    },
+    async findBackgroundSession(ccSessionId) {
+      return findBackgroundSessionIn(await listClaudeAgents(), ccSessionId);
     }
   };
 });
@@ -8223,7 +8303,7 @@ var init_chat_branch = __esm(() => {
 });
 
 // src/workflows/kill-registry.ts
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn5 } from "child_process";
 function log2(msg) {
   console.error(`[kill-registry] ${msg}`);
 }
@@ -8240,7 +8320,7 @@ function runDockerCommand(args) {
     const timer = setTimeout(() => settle(false), DOCKER_COMMAND_TIMEOUT_MS);
     timer.unref?.();
     try {
-      const child = spawn4("docker", args, { windowsHide: true, stdio: "ignore" });
+      const child = spawn5("docker", args, { windowsHide: true, stdio: "ignore" });
       child.on("exit", (code) => settle(code === 0));
       child.on("close", (code) => settle(code === 0));
       child.on("error", () => settle(false));
@@ -8371,63 +8451,6 @@ var init_kill_registry = __esm(() => {
   REGISTRY_KEY2 = Symbol.for("runcastle.kill.registry");
 });
 
-// src/doctor/system-exec.ts
-import { spawn as spawn5 } from "child_process";
-function createSystemExec(opts = {}) {
-  const timeoutMs = opts.timeoutMs ?? DEFAULT_EXEC_TIMEOUT_MS;
-  const containFn = opts.containFn ?? containHostProcess;
-  return (command, args) => new Promise((resolve9) => {
-    const { file, args: spawnArgs } = resolveSpawnTarget(command, args);
-    let stdout = "";
-    let stderr = "";
-    let settled = false;
-    const settle = (outcome) => {
-      if (settled)
-        return;
-      settled = true;
-      clearTimeout(timer);
-      resolve9(outcome);
-    };
-    const child = spawn5(file, spawnArgs, { cwd: opts.cwd, windowsHide: true });
-    const containment = child.pid === undefined ? null : containFn(child.pid);
-    const timer = setTimeout(() => {
-      if (containment)
-        containment.kill();
-      else if (child.pid !== undefined)
-        killProcessTree(child.pid);
-      const note = `${command} ${args.join(" ")} timed out after ${Math.round(timeoutMs / 1000)}s`;
-      settle({
-        ok: true,
-        code: null,
-        stdout,
-        stderr: stderr ? `${stderr}
-${note}` : note,
-        timedOut: true
-      });
-    }, timeoutMs);
-    child.stdout?.on("data", (d) => {
-      stdout += d.toString();
-    });
-    child.stderr?.on("data", (d) => {
-      stderr += d.toString();
-    });
-    child.on("error", (err) => {
-      containment?.kill();
-      settle({ ok: false, code: null, stdout, stderr: stderr || String(err) });
-    });
-    child.on("close", (code) => {
-      containment?.kill();
-      settle({ ok: true, code: code ?? 0, stdout, stderr });
-    });
-  });
-}
-var DEFAULT_EXEC_TIMEOUT_MS = 60000;
-var init_system_exec = __esm(() => {
-  init_kill_tree();
-  init_contain_host();
-  init_resolve_executable();
-});
-
 // src/services/settings.ts
 import { existsSync as existsSync13, mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync6 } from "fs";
 import { dirname as dirname6 } from "path";
@@ -57733,7 +57756,8 @@ function runCommand2(bin, args2) {
     const timer = setTimeout(() => settle(false), COMMAND_TIMEOUT_MS);
     timer.unref?.();
     try {
-      const child = spawn8(bin, [...args2], { windowsHide: true, stdio: "ignore" });
+      const target = spawnTargetFor(bin, [...args2]);
+      const child = spawn8(target.file, target.args, { windowsHide: true, stdio: "ignore" });
       child.on("exit", (code) => settle(code === 0));
       child.on("close", (code) => settle(code === 0));
       child.on("error", () => settle(false));
@@ -57799,6 +57823,7 @@ async function reapRecorder(ticketId, options = {}) {
 var AGENT_BROWSER_BIN = "agent-browser", DEFAULT_TIMEOUT_MS2 = 1e4, POLL_INTERVAL_MS = 100, COMMAND_TIMEOUT_MS = 5000, REAL_DEPS2;
 var init_recorder_reap = __esm(() => {
   init_paths();
+  init_resolve_executable();
   REAL_DEPS2 = {
     findBrowser: () => findOnPath(AGENT_BROWSER_BIN),
     fileExists: existsSync16,
@@ -58409,7 +58434,10 @@ function couldNotReview(ticket, reason, digest) {
 **${headline2}**` : `**${headline2}**`
   };
 }
-var FFMPEG_BIN = "ffmpeg", spawnVersion = (path2) => spawnSync(path2, ["--version"], { timeout: 3000, stdio: "ignore" }), withheldDrives, DECLARATION, REVIEW_DIRECTORY_FS;
+var FFMPEG_BIN = "ffmpeg", spawnVersion = (path2) => {
+  const { file, args: args2 } = spawnTargetFor(path2, ["--version"]);
+  return spawnSync(file, args2, { timeout: 3000, stdio: "ignore", windowsHide: true });
+}, withheldDrives, DECLARATION, REVIEW_DIRECTORY_FS;
 var init_review_ticket = __esm(() => {
   init_src();
   init_paths();
@@ -58419,6 +58447,7 @@ var init_review_ticket = __esm(() => {
   init_agent_stream();
   init_git();
   init_review_findings();
+  init_resolve_executable();
   init_kill_registry();
   init_recorder_reap();
   init_recorder_reap();
@@ -65397,16 +65426,17 @@ function handlePtyExit(ctx, feature, session, meta, exitCode) {
   if (session.runtime === "codex" && feature) {
     noteResolvedMerge(ctx, session, feature).catch(() => {});
   }
+  let resumeFailureReported;
   if (diedBeforeLive && meta.resumeSessionId) {
-    emitForSession(ctx, session, {
-      type: "session.resume_failed",
-      message: `resume failed for ${session.kind} \u2014 the session exited before starting (code ${exitCode ?? "unknown"}); the previous conversation is still resumable`,
-      data: {
-        sessionId: session.id,
-        resumeSessionId: meta.resumeSessionId,
-        exitCode: exitCode ?? null
-      }
-    });
+    const resumeSessionId = meta.resumeSessionId;
+    const report = (background) => emitResumeFailed(ctx, session, resumeSessionId, exitCode, background);
+    if (meta.findBackgroundSession) {
+      resumeFailureReported = meta.findBackgroundSession(resumeSessionId).catch(() => {
+        return;
+      }).then(report);
+    } else {
+      report(undefined);
+    }
   }
   if (session.purpose === "self-plan" && feature) {
     const current2 = getFeatureRow(ctx, feature.id);
@@ -65422,19 +65452,36 @@ function handlePtyExit(ctx, feature, session, meta, exitCode) {
     message: ptyExitMessage(exitCode),
     data: { sessionId: session.id, exitCode: exitCode ?? null }
   });
+  return resumeFailureReported;
+}
+function emitResumeFailed(ctx, session, resumeSessionId, exitCode, background) {
+  const exited = `resume failed for ${session.kind} \u2014 the session exited before starting (code ${exitCode ?? "unknown"})`;
+  const short = background?.shortId;
+  emitForSession(ctx, session, {
+    type: "session.resume_failed",
+    message: short ? `${exited}: its conversation is running as a Claude Code background session (${short}), which cannot be resumed here. ` + `Run \`claude attach ${short}\` to look at it, then \`claude stop ${short}\` (stopping keeps the conversation), then relaunch.` : `${exited}; the previous conversation is still resumable`,
+    data: {
+      sessionId: session.id,
+      resumeSessionId,
+      exitCode: exitCode ?? null,
+      ...short ? { backgroundSessionId: short } : {}
+    }
+  });
 }
 function spawnEmbeddedPty(ctx, feature, session, worktreePath, runtime5, spec, meta = {}) {
   const { file, args: args2 } = spawnTargetFor(runtime5.resolveBinary(), spec.argv);
   const env = { ...process.env, ...spec.env };
   for (const key of spec.envScrub)
     delete env[key];
+  const findBackgroundSession = runtime5.findBackgroundSession?.bind(runtime5);
+  const exitMeta = findBackgroundSession ? { ...meta, findBackgroundSession } : meta;
   try {
     const entry = ptyRegistry().create({
       sessionId: session.id,
       cmd: file,
       args: args2,
       opts: { cwd: worktreePath, env, cols: 80, rows: 24, useConpty: true },
-      onExit: ({ exitCode }) => handlePtyExit(ctx, feature, session, meta, exitCode)
+      onExit: ({ exitCode }) => void handlePtyExit(ctx, feature, session, exitMeta, exitCode)
     });
     if (feature)
       startDocsWatch(ctx, feature);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcastle",
-  "version": "1.4.7",
+  "version": "1.4.8",
   "description": "Burn tickets into shipped features with Claude Code.",
   "license": "FSL-1.1-ALv2",
   "type": "module",