@sideboard-ai/core 0.1.241 → 0.1.243

package/dist/mcp/run-stdio.cjs

@@ -1660,7 +1660,8 @@ function normalizeThread(raw) {
     runScriptRequest: normalizeRunScriptRequest(raw.runScriptRequest),
     quotaResumeAt: raw.quotaResumeAt ?? null,
     quotaContinuedFromId: raw.quotaContinuedFromId ?? null,
-    archivedAt: typeof raw.archivedAt === "string" && raw.archivedAt.trim() ? raw.archivedAt.trim() : void 0
+    archivedAt: typeof raw.archivedAt === "string" && raw.archivedAt.trim() ? raw.archivedAt.trim() : void 0,
+    compactedMessages: Array.isArray(raw.compactedMessages) ? raw.compactedMessages : void 0
   };
 }
 function createEmptyThread(partial) {
@@ -3400,6 +3401,7 @@ function archivedUpdatedMs(thread) {
 }
 function isHistoryRetentionStub(thread) {
   if ((thread.attachments?.length ?? 0) > 0) return false;
+  if ((thread.compactedMessages?.length ?? 0) > 0) return false;
   const messages = thread.messages ?? [];
   if (messages.length === 0) return true;
   if (messages.length > 1) return false;
@@ -9704,6 +9706,10 @@ var init_node_launch = __esm({
 // src/agents/injected-mcp.ts
 function sideboardWorktreeAllowedTools(opts) {
   const out = [...SIDEBOARD_ARTIFACT_MCP_ALLOWED_TOOLS];
+  if (!opts?.planMode) {
+    const idx = out.indexOf("mcp__sideboard__present_plan");
+    if (idx >= 0) out.splice(idx, 1);
+  }
   if (opts?.github !== false) out.push(...SIDEBOARD_GITHUB_MCP_ALLOWED_TOOLS);
   if (opts?.linear) out.push(...SIDEBOARD_LINEAR_MCP_ALLOWED_TOOLS);
   if (opts?.abletime) out.push(...SIDEBOARD_ABLETIME_MCP_ALLOWED_TOOLS);
@@ -10564,6 +10570,9 @@ function skillToolFromTextPart(part, id) {
     updatedAt: Date.now()
   };
 }
+function compactSummaryPart(text7, id = "compact-summary") {
+  return compactToolPart(text7, id, { status: "done" });
+}
 function compactToolPart(text7, id, opts) {
   const input = { trigger: opts?.trigger ?? "auto" };
   return withPartTimes(
@@ -10841,6 +10850,17 @@ function partsToAssistantText(parts) {
     (p) => p.type === "text" && !messagePartParentId(p)
   ).map((p) => p.text).join("").trim();
 }
+function lastAssistantMessageText(parts) {
+  if (!parts?.length) return "";
+  for (let i = parts.length - 1; i >= 0; i--) {
+    const p = parts[i];
+    if (!p || p.type !== "text" || messagePartParentId(p)) continue;
+    const text7 = p.text.trim();
+    if (!text7 || isInternalAgentStatusText(text7)) continue;
+    return text7;
+  }
+  return "";
+}
 function stripBrightsyNdjsonNoise(text7) {
   if (!text7 || !text7.includes('"type"')) return text7;
   let out = text7;
@@ -10878,6 +10898,9 @@ var init_message_parts = __esm({
 });
 
 // src/agents/types.ts
+function planModeTurnInstruction(planMode) {
+  return planMode ? PLAN_MODE_INSTRUCTION : PLAN_MODE_OFF_INSTRUCTION;
+}
 function permissionMode(thread) {
   if (thread.sourceType === "orchestration") {
     return {
@@ -10916,11 +10939,12 @@ function permissionMode(thread) {
     codexSandbox: "workspace-write"
   };
 }
-var PLAN_MODE_INSTRUCTION;
+var PLAN_MODE_INSTRUCTION, PLAN_MODE_OFF_INSTRUCTION;
 var init_types = __esm({
   "src/agents/types.ts"() {
     "use strict";
     PLAN_MODE_INSTRUCTION = "Plan mode is active and must remain active until the user turns Plan mode off in the UI (or Approves / Hands off the plan). Analyze the codebase, search and read files as needed, and produce or refine a clear implementation plan. Do not modify, create, or delete any project files except via Sideboard MCP present_plan (writes .context/attachments/plan.md). When you need a clarifying decision (approach forks, auth choice, scope) \u2014 not greetings, check-ins, or an invented task menu: (1) first write a short chat message that explains the decision and what each option means (tradeoffs, when to pick it) \u2014 do not leave the user staring at bare labels; (2) then call Sideboard MCP ask_user with the same options, including a description on every option. If one option is the obvious default, proceed without asking. Sideboard shows questions in the composer and mirrors them in chat. After ask_user, wait for the user's next message with their answers before finalizing the plan. When the plan is ready for approval: (1) call present_plan with the full markdown plan (title + content) so Sideboard saves .context/attachments/plan.md and shows it in chat for Approve / Hand off / Copy; (2) Claude should also call ExitPlanMode after present_plan. Do not skip present_plan \u2014 the plan must be a markdown file, not only chat prose.";
+    PLAN_MODE_OFF_INSTRUCTION = "Plan mode is off. Do not call present_plan or ExitPlanMode \u2014 those only work when the user turns Plan on in the composer. If you need to propose an approach, write it in chat.";
   }
 });
 
@@ -11433,7 +11457,8 @@ var init_claude = __esm({
             ...sideboardWorktreeAllowedTools({
               github: true,
               linear: isLinearConnected(),
-              abletime: isAbleTimeConnected()
+              abletime: isAbleTimeConnected(),
+              planMode: thread.planMode
             }),
             ...brightsyMcpAllowedTools(injectedBrightsyNames)
           ];
@@ -13983,12 +14008,38 @@ ${match.text}`, "");
   blocks.push("Continue from this context. Do not repeat the summary unless asked.");
   return blocks.join("\n");
 }
+function compactArchiveProse(message) {
+  if (message.origin === "continue") return null;
+  if (message.role === "summary") return null;
+  let text7 = (message.text ?? "").trim();
+  if (!text7 && message.role === "agent") {
+    text7 = lastAssistantMessageText(message.parts).trim();
+  }
+  if (!text7 || isInternalAgentStatusText(text7)) return null;
+  return { role: message.role, text: text7, ts: message.ts };
+}
+function messagesForCompactArchive(older) {
+  const out = [];
+  for (const message of older) {
+    const prose = compactArchiveProse(message);
+    if (prose) out.push(prose);
+  }
+  return out;
+}
+function appendCompactedMessages(existing, older) {
+  const next = messagesForCompactArchive(older);
+  if (!existing?.length) return next;
+  if (!next.length) return existing;
+  return [...existing, ...next];
+}
 function applyCompaction(messages, summaryText, thresholds = {}) {
   const { older, recent } = splitForCompaction(messages, thresholds);
   if (older.length === 0) return messages;
+  const text7 = summaryText.trim();
   const summary = {
     role: "summary",
-    text: summaryText.trim(),
+    text: text7,
+    parts: [compactSummaryPart(text7)],
     ts: (/* @__PURE__ */ new Date()).toISOString()
   };
   return [summary, ...recent];
@@ -14016,6 +14067,7 @@ async function maybeCompactContext(thread, thresholds = {}, summarize = summariz
     cwd: thread.worktreePath
   });
   let messages = applyCompaction(thread.messages, summary, thresholds);
+  const compactedMessages = appendCompactedMessages(thread.compactedMessages, older);
   const resetSession = shouldResetSessionForOccupancy({ messages: thread.messages });
   if (resetSession) {
     messages = applyForwardOccupancy(messages);
@@ -14023,6 +14075,7 @@ async function maybeCompactContext(thread, thresholds = {}, summarize = summariz
   const next = {
     ...thread,
     messages,
+    ...compactedMessages.length ? { compactedMessages } : { compactedMessages: void 0 },
     sessionId: resetSession ? null : thread.sessionId,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
@@ -14038,6 +14091,7 @@ var CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAG
 var init_context_compact = __esm({
   "src/composer/context-compact.ts"() {
     "use strict";
+    init_message_parts();
     init_error_detail();
     init_usage();
     init_context_estimate();
@@ -14596,390 +14650,797 @@ var init_worktree_run_ports = __esm({
   }
 });
 
-// src/hook/conductor.ts
-function matchSimpleGlob(pattern, name) {
-  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
-  return new RegExp(`^${escaped}$`).test(name);
-}
-function readWorktreeInclude(repoPath) {
-  const path = (0, import_node_path39.join)(repoPath, ".worktreeinclude");
-  if (!(0, import_node_fs39.existsSync)(path)) return [];
-  return (0, import_node_fs39.readFileSync)(path, "utf8").split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+// src/mcp/wait-for-turn.ts
+function mcpWaitForTurnTimeoutMs(requested) {
+  const n = requested ?? MCP_WAIT_FOR_TURN_MAX_MS;
+  if (!Number.isFinite(n)) return MCP_WAIT_FOR_TURN_MAX_MS;
+  return Math.min(Math.max(1e3, Math.floor(n)), MCP_WAIT_FOR_TURN_MAX_MS);
 }
-function resolveFilesToCopy(repoPath) {
-  const fromInclude = readWorktreeInclude(repoPath);
-  if (fromInclude.length) return fromInclude;
-  const settings = loadRepoSettings(repoPath);
-  if (settings?.filesToCopy?.length) return settings.filesToCopy;
-  if (settings?.fileIncludeGlobs?.length) {
-    const matched = [];
-    try {
-      for (const entry of (0, import_node_fs39.readdirSync)(repoPath, { withFileTypes: true })) {
-        if (!entry.isFile()) continue;
-        for (const glob of settings.fileIncludeGlobs) {
-          if (matchSimpleGlob(glob, entry.name) || matchSimpleGlob((0, import_node_path39.basename)(glob), entry.name)) {
-            matched.push(entry.name);
-            break;
-          }
-        }
-      }
-    } catch {
-    }
-    if (matched.length) return [...new Set(matched)];
+function mcpWaitTaskHint(taskState, status) {
+  switch (taskState) {
+    case "submitted":
+      return MCP_WAIT_QUEUED_HINT;
+    case "working":
+      return MCP_WAIT_STILL_RUNNING_HINT;
+    case "input-required":
+      return MCP_WAIT_INPUT_REQUIRED_HINT;
+    case "canceled":
+      return MCP_WAIT_STOPPED_HINT;
+    case "failed":
+      return status === "broken" ? MCP_WAIT_BROKEN_HINT : MCP_WAIT_ERROR_HINT;
+    default:
+      return void 0;
   }
-  const defaults = [];
-  try {
-    for (const entry of (0, import_node_fs39.readdirSync)(repoPath, { withFileTypes: true })) {
-      if (entry.isFile() && entry.name.startsWith(".env")) {
-        defaults.push(entry.name);
-      }
-    }
-  } catch {
+}
+var MCP_WAIT_FOR_TURN_MAX_MS, MCP_WAIT_STILL_RUNNING_HINT, MCP_WAIT_QUEUED_HINT, MCP_WAIT_STOPPED_HINT, MCP_WAIT_BROKEN_HINT, MCP_WAIT_ERROR_HINT, MCP_WAIT_INPUT_REQUIRED_HINT;
+var init_wait_for_turn = __esm({
+  "src/mcp/wait-for-turn.ts"() {
+    "use strict";
+    MCP_WAIT_FOR_TURN_MAX_MS = 45e3;
+    MCP_WAIT_STILL_RUNNING_HINT = "Child is still working. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts) or assume a hang while progress is updating.";
+    MCP_WAIT_QUEUED_HINT = "Child is queued waiting for a concurrency slot \u2014 it has not started yet. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts), force_stop, or assume it failed to start.";
+    MCP_WAIT_STOPPED_HINT = "Child was stopped before the turn finished. Do not treat this as success. send_to_thread to resume, or tell the user.";
+    MCP_WAIT_BROKEN_HINT = "Child worktree is broken (missing on disk). Tell the user \u2014 do not treat this as success.";
+    MCP_WAIT_ERROR_HINT = "Child turn failed. lastError/text is the failure \u2014 switch agent, tell the user, or retry. Do not treat empty text as success.";
+    MCP_WAIT_INPUT_REQUIRED_HINT = "Child asked the user a question (ask_user). taskState is input-required. Wait for the user to answer in that chat \u2014 do not send_to_thread a check-in.";
   }
-  if (defaults.length) return defaults;
-  return [".env.local", ".env"];
+});
+
+// src/mcp/wait-for-job.ts
+function mcpWaitForJobTimeoutMs(requested) {
+  return mcpWaitForTurnTimeoutMs(requested);
 }
-function copyConfiguredFiles(repoPath, worktreePath) {
-  const patterns = resolveFilesToCopy(repoPath);
-  const copied = [];
-  for (const rel of patterns) {
-    const src = (0, import_node_path39.join)(repoPath, rel);
-    if (!(0, import_node_fs39.existsSync)(src)) continue;
-    const dest = (0, import_node_path39.join)(worktreePath, rel);
-    (0, import_node_fs39.mkdirSync)((0, import_node_path39.dirname)(dest), { recursive: true });
-    (0, import_node_fs39.copyFileSync)(src, dest);
-    copied.push(rel);
+function sanitizeDetachedJobId(id) {
+  const s = id.trim();
+  if (!JOB_ID_RE.test(s)) {
+    throw new Error(`detached-job id must be 1\u201364 chars [A-Za-z0-9._-], got ${JSON.stringify(id)}`);
   }
-  return copied;
+  return s;
 }
-async function captureLoginEnv() {
-  if (cachedLoginEnv) return { ...cachedLoginEnv };
-  const shell = process.env.SHELL?.trim() || (process.platform === "darwin" ? "/bin/zsh" : "/bin/bash");
+function jobAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
   try {
-    const result = await (0, import_execa4.execa)(shell, ["-l", "-c", "env -0"], {
-      reject: false,
-      timeout: 5e3
-    });
-    if (result.exitCode === 0 && result.stdout) {
-      const env = { ...process.env };
-      for (const entry of result.stdout.split("\0")) {
-        if (!entry) continue;
-        const eq = entry.indexOf("=");
-        if (eq <= 0) continue;
-        const key = entry.slice(0, eq);
-        const value = entry.slice(eq + 1);
-        if (key) env[key] = value;
-      }
-      cachedLoginEnv = env;
-      return { ...env };
-    }
+    process.kill(pid, 0);
+    return true;
   } catch {
+    return false;
   }
-  cachedLoginEnv = { ...process.env };
-  return { ...cachedLoginEnv };
 }
-function buildWorkspaceScriptEnv(opts, baseEnv) {
-  const env = stripNestedElectronEnv({
-    ...baseEnv ?? process.env
-  });
-  const name = opts.workspaceName ?? (0, import_node_path39.basename)(opts.worktreePath);
-  const ports = opts.ports ?? [];
-  const primary = ports[0];
-  env.SIDEBOARD_WORKSPACE_NAME = name;
-  env.SIDEBOARD_WORKSPACE_PATH = opts.worktreePath;
-  env.SIDEBOARD_ROOT_PATH = opts.repoPath;
-  env.SIDEBOARD_IS_LOCAL = "1";
-  if (opts.defaultBranch) env.SIDEBOARD_DEFAULT_BRANCH = opts.defaultBranch;
-  env.CONDUCTOR_WORKSPACE_NAME = name;
-  env.CONDUCTOR_WORKSPACE_PATH = opts.worktreePath;
-  env.CONDUCTOR_ROOT_PATH = opts.repoPath;
-  env.CONDUCTOR_IS_LOCAL = "1";
-  if (opts.defaultBranch) env.CONDUCTOR_DEFAULT_BRANCH = opts.defaultBranch;
-  if (primary != null) {
-    env.SIDEBOARD_PORT = String(primary);
-    env.CONDUCTOR_PORT = String(primary);
-    env.PORT = String(primary);
-    for (let i = 1; i < ports.length; i++) {
-      const p = ports[i];
-      env[`SIDEBOARD_PORT_${i}`] = String(p);
-      env[`CONDUCTOR_PORT_${i}`] = String(p);
-    }
+function processGroupAlive(pgid) {
+  if (process.platform === "win32") return false;
+  if (!Number.isInteger(pgid) || pgid <= 1) return false;
+  try {
+    process.kill(-pgid, 0);
+    return true;
+  } catch (err) {
+    return err && typeof err === "object" && "code" in err && err.code === "EPERM";
   }
-  applyWorktreePkgCacheEnv(env, opts.worktreePath);
-  return env;
 }
-function pipeLines(stream, onLine) {
-  if (!stream || !onLine) return;
-  const rl = (0, import_node_readline3.createInterface)({ input: stream });
-  rl.on("line", onLine);
+function jobTreeAlive(pid) {
+  if (pid == null) return false;
+  return jobAlive(pid) || processGroupAlive(pid);
 }
-function killableListenerPids(raw, selfPid = process.pid) {
-  const pids = [];
-  for (const token of raw.trim().split(/\s+/)) {
-    const pid = Number(token);
-    if (!Number.isFinite(pid) || pid <= 0 || pid === selfPid) continue;
-    pids.push(pid);
-  }
-  return pids;
+function readIntFile(file) {
+  if (!(0, import_node_fs39.existsSync)(file)) return null;
+  const n = Number.parseInt((0, import_node_fs39.readFileSync)(file, "utf8").trim(), 10);
+  return Number.isInteger(n) ? n : null;
 }
-function listUnixListenerPids(port, selfPid) {
-  try {
-    const raw = (0, import_node_child_process4.execFileSync)("lsof", [`-tiTCP:${port}`, "-sTCP:LISTEN"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      timeout: 2e3
-    });
-    return killableListenerPids(raw, selfPid);
-  } catch {
-    return [];
-  }
+function jobDir(root, id, legacy = false) {
+  return (0, import_node_path39.join)(root, legacy ? LEGACY_DETACHED_JOBS_DIR : DETACHED_JOBS_DIR, id);
 }
-function listenerCwd(pid) {
-  if (!Number.isFinite(pid) || pid <= 0) return null;
-  try {
-    const raw = (0, import_node_child_process4.execFileSync)("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      timeout: 2e3
-    });
-    for (const line of raw.split("\n")) {
-      if (line.startsWith("n") && line.length > 1) return line.slice(1);
-    }
-  } catch {
-  }
-  return null;
+function resolveJobDir(root, id) {
+  const modern = jobDir(root, id, false);
+  if ((0, import_node_fs39.existsSync)(modern)) return modern;
+  const legacy = jobDir(root, id, true);
+  if ((0, import_node_fs39.existsSync)(legacy)) return legacy;
+  return modern;
 }
-function realpathOrResolve(path) {
-  try {
-    return (0, import_node_fs39.realpathSync)(path);
-  } catch {
-    return (0, import_node_path39.resolve)(path);
+function listJobIdsIn(root, rel) {
+  const dir = (0, import_node_path39.join)(root, rel);
+  if (!(0, import_node_fs39.existsSync)(dir)) return [];
+  return (0, import_node_fs39.readdirSync)(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && JOB_ID_RE.test(e.name)).map((e) => e.name);
+}
+function listRunningDetachedJobs(worktreePath) {
+  const root = worktreePath.trim();
+  if (!root) return [];
+  const ids = /* @__PURE__ */ new Set([
+    ...listJobIdsIn(root, DETACHED_JOBS_DIR),
+    ...listJobIdsIn(root, LEGACY_DETACHED_JOBS_DIR)
+  ]);
+  const running = [];
+  for (const id of ids) {
+    const dir = resolveJobDir(root, id);
+    const pid = readIntFile((0, import_node_path39.join)(dir, "pid"));
+    if (jobTreeAlive(pid)) running.push(id);
   }
+  return running.sort();
 }
-function isOtherWorktreeListenerCwd(cwd, worktreePath) {
-  const wt = realpathOrResolve(worktreePath);
-  const c = realpathOrResolve(cwd);
-  if (c === wt || c.startsWith(wt + import_node_path39.sep)) return false;
-  const parent = (0, import_node_path39.dirname)(wt);
-  const thisName = (0, import_node_path39.basename)(wt);
-  if (!thisName || c === parent) return false;
-  if (!c.startsWith(parent + import_node_path39.sep)) return false;
-  const first = c.slice(parent.length + 1).split(import_node_path39.sep)[0];
-  return Boolean(first) && first !== thisName;
+function looksLikeDeferredDonePromise(text7) {
+  const t = (text7 ?? "").trim();
+  if (!t || t.length > DEFERRED_DONE_MAX_CHARS) return false;
+  const unquoted = t.replace(/`[^`]*`/g, " ").replace(/["“”][^"“”]*["“”]/g, " ").replace(/\s+/g, " ").trim();
+  if (!unquoted) return false;
+  return /\b(i['’]?ll|i will)\s+let you know\b/i.test(unquoted) || /\blet you know when\b/i.test(unquoted) || /\b(check back|ping me)\s+when\b/i.test(unquoted) || /\bi(?:['’]ll| will)\s+(report|update you)\s+when\b/i.test(unquoted);
 }
-function signalPid(pid, signal) {
-  try {
-    process.kill(pid, signal);
-  } catch {
-  }
+function isJobContinuePrompt(text7) {
+  if (typeof text7 !== "string") return false;
+  const t = text7.trim();
+  return t.startsWith("Detached job still running:") || t.startsWith("You ended the turn after promising to report later");
 }
-function killListenersOnPorts(ports) {
-  const selfPid = process.pid;
-  for (const port of ports) {
-    if (!Number.isFinite(port) || port <= 0) continue;
-    try {
-      if (process.platform === "win32") {
-        (0, import_node_child_process4.execFileSync)(
-          "powershell",
-          [
-            "-NoProfile",
-            "-Command",
-            `Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue | Where-Object { $_.OwningProcess -ne ${selfPid} } | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }`
-          ],
-          { stdio: "ignore", timeout: 3e3 }
-        );
-        continue;
-      }
-      for (const pid of listUnixListenerPids(port, selfPid)) {
-        signalPid(pid, "SIGTERM");
-      }
-    } catch {
-    }
+function collapseGhRunWatchLog(text7) {
+  if (!text7.includes(GH_WATCH_REFRESH)) return text7;
+  const frames = text7.split(/(?=Refreshing run status every 3 seconds\.)/);
+  const watchFrames = frames.filter((f) => f.includes(GH_WATCH_REFRESH));
+  if (watchFrames.length <= 1) return text7;
+  const prefix = frames[0]?.includes(GH_WATCH_REFRESH) ? "" : frames[0] ?? "";
+  const last = watchFrames[watchFrames.length - 1] ?? "";
+  const omitted = watchFrames.length - 1;
+  const note = `(${omitted} identical gh run watch refresh${omitted === 1 ? "" : "es"} omitted)
+`;
+  return [prefix.trimEnd(), note, last.trimStart()].filter(Boolean).join("\n");
+}
+function capJobLogDelta(text7) {
+  const collapsed = collapseGhRunWatchLog(text7);
+  const lines = collapsed.split("\n");
+  let out = lines.length > MAX_JOB_DELTA_LINES ? `\u2026(${lines.length - MAX_JOB_DELTA_LINES} earlier lines omitted)
+${lines.slice(-MAX_JOB_DELTA_LINES).join("\n")}` : collapsed;
+  if (out.length > MAX_JOB_DELTA_CHARS) {
+    out = `\u2026(truncated ${out.length} chars)
+${out.slice(-MAX_JOB_DELTA_CHARS)}`;
   }
+  return out;
 }
-function killStaleWorktreeListeners(ports, worktreePath, signal = "SIGTERM") {
-  if (!worktreePath.trim()) {
-    killListenersOnPorts(ports);
-    return;
+function formatJobStillRunningContinuePrompt(jobIds) {
+  const ids = jobIds.join(", ");
+  return [
+    `Detached job still running: ${ids}.`,
+    "Do not end this turn. Loop wait_for_job (same id) until stillRunning is false. The log pane updates from each wait result.",
+    "If the job is hanging or doing the wrong thing, call stop_job (same id) instead of looping forever.",
+    "Then report the result. Do not tell the user you will let them know later."
+  ].join(" ");
+}
+function formatDeferredDoneContinuePrompt() {
+  return [
+    "You ended the turn after promising to report later, but no detached job is running.",
+    "If tests/pack/deploy still need to run: start once with detached-job.cjs, then loop wait_for_job until stillRunning is false (the log pane updates from wait JSON).",
+    "Do not say you will let the user know later."
+  ].join(" ");
+}
+function turnWatchedDetachedJob(parts) {
+  return parts.some((p) => {
+    if (p.type !== "tool") return false;
+    if (/wait_for_job$/i.test(p.name ?? "") || /stop_job$/i.test(p.name ?? "")) return true;
+    const blob = [p.name, p.detail, p.description, p.input ? JSON.stringify(p.input) : ""].filter(Boolean).join(" ");
+    return /detached-job\.(?:js|cjs)\b/i.test(blob);
+  });
+}
+function planJobContinue(opts) {
+  if (opts.isOrchestrator) return { action: "none" };
+  if (opts.agent === "brightsy") return { action: "none" };
+  if (opts.queueLength > 0) return { action: "none" };
+  if (opts.continueCount >= MAX_JOB_CONTINUES) return { action: "none" };
+  const farewell = looksLikeDeferredDonePromise(opts.chatText);
+  if (opts.runningJobIds.length > 0 && (farewell || opts.watchedJob)) {
+    return {
+      action: "wait",
+      jobIds: opts.runningJobIds,
+      prompt: formatJobStillRunningContinuePrompt(opts.runningJobIds)
+    };
   }
-  if (process.platform === "win32") {
-    killListenersOnPorts(ports);
-    return;
+  if (looksLikeDeferredDonePromise(opts.chatText) && !opts.alreadyNudged) {
+    return { action: "nudge", prompt: formatDeferredDoneContinuePrompt() };
   }
-  const selfPid = process.pid;
-  for (const port of ports) {
-    if (!Number.isFinite(port) || port <= 0) continue;
-    for (const pid of listUnixListenerPids(port, selfPid)) {
-      const cwd = listenerCwd(pid);
-      if (cwd && isOtherWorktreeListenerCwd(cwd, worktreePath)) continue;
-      signalPid(pid, signal);
-    }
+  return { action: "none" };
+}
+function tailProgress(logFile, maxLines = 12) {
+  if (!(0, import_node_fs39.existsSync)(logFile)) return "(no log yet)";
+  const lines = (0, import_node_fs39.readFileSync)(logFile, "utf8").split("\n");
+  return lines.slice(-maxLines).join("\n");
+}
+function lastProgressLine(progress) {
+  const last = progress.split("\n").map((l) => l.trim()).filter((l) => l && l !== "(no log yet)").at(-1);
+  return last ? last.slice(0, 72) : void 0;
+}
+function readLogLines(file) {
+  if (!(0, import_node_fs39.existsSync)(file)) return [];
+  const lines = (0, import_node_fs39.readFileSync)(file, "utf8").split("\n");
+  if (lines.length && lines[lines.length - 1] === "") lines.pop();
+  return lines;
+}
+function takeDelta(logFile, cursorFile) {
+  const lines = readLogLines(logFile);
+  const cursor = readIntFile(cursorFile) ?? 0;
+  const start = Math.min(Math.max(0, cursor), lines.length);
+  return { delta: capJobLogDelta(lines.slice(start).join("\n")), nextCursor: lines.length };
+}
+function snapshotJob(dir) {
+  const pid = readIntFile((0, import_node_path39.join)(dir, "pid"));
+  const running = jobTreeAlive(pid);
+  return {
+    pid,
+    running,
+    exitCode: readIntFile((0, import_node_path39.join)(dir, "exit")),
+    log: (0, import_node_path39.join)(dir, "log"),
+    cursor: (0, import_node_path39.join)(dir, "present.cursor"),
+    progress: tailProgress((0, import_node_path39.join)(dir, "log"))
+  };
+}
+function toResult(id, snap, extra) {
+  const failed = extra?.failed === true || !snap.running && snap.exitCode != null && snap.exitCode !== 0;
+  const ok = !snap.running && snap.exitCode === 0;
+  const stillRunning = snap.running && !ok;
+  const { delta, nextCursor } = takeDelta(snap.log, snap.cursor);
+  try {
+    (0, import_node_fs39.mkdirSync)((0, import_node_path39.dirname)(snap.cursor), { recursive: true });
+    (0, import_node_fs39.writeFileSync)(snap.cursor, `${nextCursor}
+`);
+  } catch {
+  }
+  const status = ok ? "ok" : failed && !stillRunning ? "failed" : stillRunning ? "running" : "idle";
+  const progress = extra?.progress ?? snap.progress;
+  return {
+    stillRunning,
+    ok,
+    failed: Boolean(failed && !stillRunning && !ok),
+    status,
+    id,
+    pid: snap.pid,
+    exitCode: snap.exitCode ?? void 0,
+    phase: lastProgressLine(progress),
+    delta,
+    progress,
+    hint: stillRunning ? MCP_WAIT_JOB_STILL_RUNNING_HINT : void 0
+  };
+}
+async function sleepMs(ms) {
+  await new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+async function waitForDetachedJob(cwd, id, opts) {
+  const jobId = sanitizeDetachedJobId(id);
+  const root = cwd.trim() || process.cwd();
+  const dir = resolveJobDir(root, jobId);
+  const timeoutMs = mcpWaitForJobTimeoutMs(opts?.timeoutMs);
+  const sleep = opts?.sleep ?? sleepMs;
+  if (!(0, import_node_fs39.existsSync)(dir)) {
+    return {
+      stillRunning: false,
+      ok: false,
+      failed: true,
+      status: "failed",
+      id: jobId,
+      delta: "",
+      progress: "No detached job. Start one first.",
+      hint: "Start with detached-job.cjs start <id> -- <command>, then call wait_for_job again."
+    };
+  }
+  const deadline = Date.now() + timeoutMs;
+  let snap = snapshotJob(dir);
+  if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
+  if (!snap.running && snap.pid == null && snap.progress === "(no log yet)") {
+    return toResult(jobId, snap, {
+      failed: true,
+      progress: "No detached job. Start one first."
+    });
+  }
+  while (Date.now() < deadline) {
+    snap = snapshotJob(dir);
+    if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
+    if (!snap.running) return toResult(jobId, snap, { failed: true });
+    await sleep(Math.min(2e3, Math.max(50, deadline - Date.now())));
   }
+  snap = snapshotJob(dir);
+  return toResult(jobId, snap);
 }
-function killScriptTree(child, ports = []) {
-  const pid = child.pid;
-  if (pid) {
+function killProcessTree(pid, signal) {
+  if (!Number.isInteger(pid) || pid <= 0) return;
+  if (process.platform !== "win32") {
     try {
-      if (process.platform === "win32") {
-        void (0, import_execa4.execa)("taskkill", ["/pid", String(pid), "/T", "/F"], { reject: false });
-      } else {
-        process.kill(-pid, "SIGTERM");
-        setTimeout(() => {
-          try {
-            process.kill(-pid, "SIGKILL");
-          } catch {
-          }
-        }, 2500).unref?.();
-      }
+      process.kill(-pid, signal);
+      return;
     } catch {
-      try {
-        child.kill("SIGTERM");
-      } catch {
-      }
     }
   }
-  killListenersOnPorts(ports);
-}
-async function spawnWorkspaceScript(command, opts) {
-  const loginEnv = await captureLoginEnv();
-  const env = buildWorkspaceScriptEnv(
-    {
-      worktreePath: opts.worktreePath,
-      repoPath: opts.repoPath,
-      workspaceName: opts.workspaceName,
-      defaultBranch: opts.defaultBranch,
-      ports: opts.ports
-    },
-    loginEnv
-  );
   try {
-    mergeAgentGitAuthEnv(
-      env,
-      await resolveAgentGitAuthEnv(env, { cwd: opts.worktreePath })
-    );
+    process.kill(pid, signal);
   } catch {
   }
-  if (opts.heldPorts?.length) {
-    await Promise.all(opts.heldPorts.map((h) => h.release()));
-  }
-  const shell = process.platform === "darwin" ? "zsh" : "bash";
-  const child = (0, import_execa4.execa)(shell, ["-lc", command], {
-    cwd: opts.worktreePath,
-    reject: false,
-    env,
-    // Own process group so Stop can tear down the whole tree (not just the shell).
-    // There is no settings.toml `stop=` / teardown hook for run scripts.
-    ...process.platform === "win32" ? {} : { detached: true }
-  });
-  pipeLines(child.stdout, opts.onLine);
-  pipeLines(child.stderr, opts.onLine);
-  const ports = opts.ports ?? [];
-  return {
-    pid: child.pid,
-    kill: () => killScriptTree(child, ports),
-    done: child.then((r) => r.exitCode ?? null),
-    child
-  };
 }
-async function attachAbort(handle, signal) {
-  if (signal) {
-    const onAbort = () => handle.kill();
-    if (signal.aborted) onAbort();
-    else signal.addEventListener("abort", onAbort, { once: true });
+function appendJobLog(logFile, line) {
+  try {
+    (0, import_node_fs39.mkdirSync)((0, import_node_path39.dirname)(logFile), { recursive: true });
+    const body = line.endsWith("\n") ? line : `${line}
+`;
+    (0, import_node_fs39.appendFileSync)(logFile, body);
+  } catch {
   }
-  return handle.done;
 }
-async function runSetupScript(repoPath, worktreePath, onLine, opts) {
-  const settings = loadWorkspaceSettings(worktreePath, repoPath);
-  if (!settings?.setup) return { ran: false, exitCode: null, source: null };
-  const source = workspaceSettingsSourceLabel(worktreePath, repoPath);
-  onLine?.(`[setup] ${source ?? "settings.toml"}`);
-  const handle = await spawnWorkspaceScript(settings.setup, {
-    worktreePath,
-    repoPath,
-    defaultBranch: opts?.defaultBranch,
-    onLine
-  });
-  const exitCode = await attachAbort(handle, opts?.signal);
+async function stopDetachedJob(cwd, id, opts) {
+  const jobId = sanitizeDetachedJobId(id);
+  const root = cwd.trim() || process.cwd();
+  const dir = resolveJobDir(root, jobId);
+  const sleep = opts?.sleep ?? sleepMs;
+  const why = opts?.reason?.trim() ?? "";
+  if (!(0, import_node_fs39.existsSync)(dir)) {
+    return {
+      stillRunning: false,
+      ok: false,
+      failed: true,
+      status: "failed",
+      id: jobId,
+      delta: "",
+      progress: "No detached job. Start one first.",
+      hint: "Start with detached-job.cjs start <id> -- <command>, then wait_for_job or stop_job.",
+      stopped: false,
+      reason: "not-found"
+    };
+  }
+  let snap = snapshotJob(dir);
+  if (!snap.running) {
+    const result2 = toResult(jobId, snap);
+    return {
+      ...result2,
+      stopped: false,
+      reason: "not-running",
+      hint: "That job is already finished. Read the log; do not wait again unless you start a new command."
+    };
+  }
+  appendJobLog(snap.log, `$ stop${why ? `: ${why}` : ""}`);
+  const targetPid = snap.pid;
+  if (targetPid != null) killProcessTree(targetPid, "SIGTERM");
+  const graceMs = Number.isFinite(opts?.graceMs) ? Math.max(50, opts.graceMs) : 2e3;
+  const deadline = Date.now() + graceMs;
+  while (Date.now() < deadline && jobTreeAlive(targetPid)) {
+    await sleep(Math.min(100, Math.max(20, deadline - Date.now())));
+  }
+  if (targetPid != null) {
+    killProcessTree(targetPid, "SIGKILL");
+    await sleep(100);
+  }
+  const exitFile = (0, import_node_path39.join)(dir, "exit");
+  if (!(0, import_node_fs39.existsSync)(exitFile)) {
+    try {
+      (0, import_node_fs39.writeFileSync)(exitFile, "1\n");
+    } catch {
+    }
+  }
+  snap = snapshotJob(dir);
+  const stillRunning = jobTreeAlive(targetPid) || snap.running;
+  const result = toResult(jobId, snap, { failed: true });
+  const stopped = !stillRunning;
   return {
-    ran: true,
-    exitCode,
-    source,
-    kill: handle.kill
+    ...result,
+    stillRunning,
+    ok: false,
+    failed: true,
+    status: stillRunning ? "running" : "failed",
+    stopped,
+    reason: stopped ? "stopped" : "still-running",
+    stopReason: why || void 0,
+    hint: stopped ? MCP_STOP_JOB_HINT : MCP_WAIT_JOB_STILL_RUNNING_HINT
   };
 }
-async function runConventionSetup(repoPath, worktreePath, onLine, opts) {
-  const found = findConventionSetup(worktreePath, repoPath);
-  if (!found) return { ran: false, exitCode: null, source: null };
-  onLine?.(`[setup] ${found.source}`);
-  const handle = await spawnWorkspaceScript(found.command, {
-    worktreePath,
-    repoPath,
-    defaultBranch: opts?.defaultBranch,
-    onLine
-  });
-  const exitCode = await attachAbort(handle, opts?.signal);
-  return {
-    ran: true,
-    exitCode,
-    source: found.source,
-    kill: handle.kill
-  };
+var import_node_fs39, import_node_path39, MAX_JOB_CONTINUES, MAX_JOB_DELTA_LINES, MAX_JOB_DELTA_CHARS, DEFERRED_DONE_MAX_CHARS, GH_WATCH_REFRESH, MCP_WAIT_JOB_STILL_RUNNING_HINT, MCP_STOP_JOB_HINT, JOB_ID_RE;
+var init_wait_for_job = __esm({
+  "src/mcp/wait-for-job.ts"() {
+    "use strict";
+    import_node_fs39 = require("fs");
+    import_node_path39 = require("path");
+    init_workspace_scratch();
+    init_wait_for_turn();
+    MAX_JOB_CONTINUES = 8;
+    MAX_JOB_DELTA_LINES = 80;
+    MAX_JOB_DELTA_CHARS = 4e3;
+    DEFERRED_DONE_MAX_CHARS = 480;
+    GH_WATCH_REFRESH = "Refreshing run status every 3 seconds.";
+    MCP_WAIT_JOB_STILL_RUNNING_HINT = "Job is still running. The type=log pane already appended this delta. Call wait_for_job again. If it is hanging, producing no useful output, or doing the wrong thing, call stop_job (same id) instead of looping forever. Do not end the turn or tell the user you will let them know later.";
+    MCP_STOP_JOB_HINT = "Stopped. The type=log pane is status=failed with the last delta. Do not wait again unless you start a new command.";
+    JOB_ID_RE = /^[a-zA-Z0-9._-]{1,64}$/;
+  }
+});
+
+// src/hook/conductor.ts
+function matchSimpleGlob(pattern, name) {
+  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${escaped}$`).test(name);
 }
-async function runWorkspaceSetup(repoPath, worktreePath, onLine, opts) {
-  await ensureWorktreeSideboardIgnored(worktreePath);
-  const review = ensureReviewGuidelinesFile(worktreePath, repoPath);
-  if (review.wrote) {
-    onLine?.(`[setup] wrote ${review.path} \u2014 local Review guidelines`);
+function readWorktreeInclude(repoPath) {
+  const path = (0, import_node_path40.join)(repoPath, ".worktreeinclude");
+  if (!(0, import_node_fs40.existsSync)(path)) return [];
+  return (0, import_node_fs40.readFileSync)(path, "utf8").split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+}
+function resolveFilesToCopy(repoPath) {
+  const fromInclude = readWorktreeInclude(repoPath);
+  if (fromInclude.length) return fromInclude;
+  const settings = loadRepoSettings(repoPath);
+  if (settings?.filesToCopy?.length) return settings.filesToCopy;
+  if (settings?.fileIncludeGlobs?.length) {
+    const matched = [];
+    try {
+      for (const entry of (0, import_node_fs40.readdirSync)(repoPath, { withFileTypes: true })) {
+        if (!entry.isFile()) continue;
+        for (const glob of settings.fileIncludeGlobs) {
+          if (matchSimpleGlob(glob, entry.name) || matchSimpleGlob((0, import_node_path40.basename)(glob), entry.name)) {
+            matched.push(entry.name);
+            break;
+          }
+        }
+      }
+    } catch {
+    }
+    if (matched.length) return [...new Set(matched)];
   }
-  let setup = await runSetupScript(repoPath, worktreePath, onLine, opts);
-  if (!setup.ran) {
-    setup = await runCursorWorktreeSetup(repoPath, worktreePath, onLine);
+  const defaults = [];
+  try {
+    for (const entry of (0, import_node_fs40.readdirSync)(repoPath, { withFileTypes: true })) {
+      if (entry.isFile() && entry.name.startsWith(".env")) {
+        defaults.push(entry.name);
+      }
+    }
+  } catch {
   }
-  if (!setup.ran) {
-    setup = await runConventionSetup(repoPath, worktreePath, onLine, opts);
+  if (defaults.length) return defaults;
+  return [".env.local", ".env"];
+}
+function copyConfiguredFiles(repoPath, worktreePath) {
+  const patterns = resolveFilesToCopy(repoPath);
+  const copied = [];
+  for (const rel of patterns) {
+    const src = (0, import_node_path40.join)(repoPath, rel);
+    if (!(0, import_node_fs40.existsSync)(src)) continue;
+    const dest = (0, import_node_path40.join)(worktreePath, rel);
+    (0, import_node_fs40.mkdirSync)((0, import_node_path40.dirname)(dest), { recursive: true });
+    (0, import_node_fs40.copyFileSync)(src, dest);
+    copied.push(rel);
   }
-  return setup;
+  return copied;
 }
-async function runArchiveScript(repoPath, worktreePath, onLine) {
-  const settings = loadWorkspaceSettings(worktreePath, repoPath);
-  if (!settings?.archive) return { ran: false, exitCode: null };
-  const handle = await spawnWorkspaceScript(settings.archive, {
-    worktreePath,
-    repoPath,
-    onLine
-  });
-  const exitCode = await handle.done;
-  return { ran: true, exitCode };
+async function captureLoginEnv() {
+  if (cachedLoginEnv) return { ...cachedLoginEnv };
+  const shell = process.env.SHELL?.trim() || (process.platform === "darwin" ? "/bin/zsh" : "/bin/bash");
+  try {
+    const result = await (0, import_execa4.execa)(shell, ["-l", "-c", "env -0"], {
+      reject: false,
+      timeout: 5e3
+    });
+    if (result.exitCode === 0 && result.stdout) {
+      const env = { ...process.env };
+      for (const entry of result.stdout.split("\0")) {
+        if (!entry) continue;
+        const eq = entry.indexOf("=");
+        if (eq <= 0) continue;
+        const key = entry.slice(0, eq);
+        const value = entry.slice(eq + 1);
+        if (key) env[key] = value;
+      }
+      cachedLoginEnv = env;
+      return { ...env };
+    }
+  } catch {
+  }
+  cachedLoginEnv = { ...process.env };
+  return { ...cachedLoginEnv };
 }
-function listRunScripts(worktreePath, repoPath) {
-  const settings = loadWorkspaceSettings(worktreePath, repoPath);
-  if (!settings?.runScripts.length) return [];
-  return settings.runScripts.filter((s) => {
-    if (!s.availableIn?.length) return true;
-    return s.availableIn.includes("local");
+function buildWorkspaceScriptEnv(opts, baseEnv) {
+  const env = stripNestedElectronEnv({
+    ...baseEnv ?? process.env
   });
+  const name = opts.workspaceName ?? (0, import_node_path40.basename)(opts.worktreePath);
+  const ports = opts.ports ?? [];
+  const primary = ports[0];
+  env.SIDEBOARD_WORKSPACE_NAME = name;
+  env.SIDEBOARD_WORKSPACE_PATH = opts.worktreePath;
+  env.SIDEBOARD_ROOT_PATH = opts.repoPath;
+  env.SIDEBOARD_IS_LOCAL = "1";
+  if (opts.defaultBranch) env.SIDEBOARD_DEFAULT_BRANCH = opts.defaultBranch;
+  env.CONDUCTOR_WORKSPACE_NAME = name;
+  env.CONDUCTOR_WORKSPACE_PATH = opts.worktreePath;
+  env.CONDUCTOR_ROOT_PATH = opts.repoPath;
+  env.CONDUCTOR_IS_LOCAL = "1";
+  if (opts.defaultBranch) env.CONDUCTOR_DEFAULT_BRANCH = opts.defaultBranch;
+  if (primary != null) {
+    env.SIDEBOARD_PORT = String(primary);
+    env.CONDUCTOR_PORT = String(primary);
+    env.PORT = String(primary);
+    for (let i = 1; i < ports.length; i++) {
+      const p = ports[i];
+      env[`SIDEBOARD_PORT_${i}`] = String(p);
+      env[`CONDUCTOR_PORT_${i}`] = String(p);
+    }
+  }
+  applyWorktreePkgCacheEnv(env, opts.worktreePath);
+  return env;
 }
-function getDefaultRunScript(worktreePath, repoPath) {
-  const scripts = listRunScripts(worktreePath, repoPath);
-  if (!scripts.length) return null;
-  return scripts.find((s) => s.default === true) ?? scripts.find((s) => s.name === "dev") ?? scripts.find((s) => s.name !== "all") ?? scripts[0] ?? null;
+function pipeLines(stream, onLine) {
+  if (!stream || !onLine) return;
+  const rl = (0, import_node_readline3.createInterface)({ input: stream });
+  rl.on("line", onLine);
 }
-function getRunScript(worktreePath, repoPath, name) {
-  const scripts = listRunScripts(worktreePath, repoPath);
-  if (!scripts.length) return null;
-  if (name) {
-    return scripts.find((s) => s.name === name) ?? null;
+function killableListenerPids(raw, selfPid = process.pid) {
+  const pids = [];
+  for (const token of raw.trim().split(/\s+/)) {
+    const pid = Number(token);
+    if (!Number.isFinite(pid) || pid <= 0 || pid === selfPid) continue;
+    pids.push(pid);
   }
-  return getDefaultRunScript(worktreePath, repoPath);
+  return pids;
 }
-function getRunMode(worktreePath, repoPath) {
-  return loadWorkspaceSettings(worktreePath, repoPath)?.runMode ?? "concurrent";
+function listUnixListenerPids(port, selfPid) {
+  try {
+    const raw = (0, import_node_child_process4.execFileSync)("lsof", [`-tiTCP:${port}`, "-sTCP:LISTEN"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 2e3
+    });
+    return killableListenerPids(raw, selfPid);
+  } catch {
+    return [];
+  }
 }
-async function reservePort() {
-  return new Promise((resolve2, reject) => {
-    const server = (0, import_node_net.createServer)();
-    let released = false;
+function listenerCwd(pid) {
+  if (!Number.isFinite(pid) || pid <= 0) return null;
+  try {
+    const raw = (0, import_node_child_process4.execFileSync)("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 2e3
+    });
+    for (const line of raw.split("\n")) {
+      if (line.startsWith("n") && line.length > 1) return line.slice(1);
+    }
+  } catch {
+  }
+  return null;
+}
+function realpathOrResolve(path) {
+  try {
+    return (0, import_node_fs40.realpathSync)(path);
+  } catch {
+    return (0, import_node_path40.resolve)(path);
+  }
+}
+function isOtherWorktreeListenerCwd(cwd, worktreePath) {
+  const wt = realpathOrResolve(worktreePath);
+  const c = realpathOrResolve(cwd);
+  if (c === wt || c.startsWith(wt + import_node_path40.sep)) return false;
+  const parent = (0, import_node_path40.dirname)(wt);
+  const thisName = (0, import_node_path40.basename)(wt);
+  if (!thisName || c === parent) return false;
+  if (!c.startsWith(parent + import_node_path40.sep)) return false;
+  const first = c.slice(parent.length + 1).split(import_node_path40.sep)[0];
+  return Boolean(first) && first !== thisName;
+}
+function signalPid(pid, signal) {
+  try {
+    process.kill(pid, signal);
+  } catch {
+  }
+}
+function isThisWorktreeListenerCwd(cwd, worktreePath) {
+  const wt = realpathOrResolve(worktreePath);
+  const c = realpathOrResolve(cwd);
+  return c === wt || c.startsWith(wt + import_node_path40.sep);
+}
+function killDetachedRunTree(pid, worktreePath) {
+  if (!Number.isFinite(pid) || pid <= 1 || pid === process.pid) return;
+  const cwd = listenerCwd(pid);
+  if (cwd) {
+    if (!isThisWorktreeListenerCwd(cwd, worktreePath)) return;
+  } else if (!processGroupAlive(pid)) {
+    return;
+  }
+  try {
+    process.kill(-pid, "SIGTERM");
+  } catch {
+    signalPid(pid, "SIGTERM");
+  }
+}
+function killListenersOnPorts(ports) {
+  const selfPid = process.pid;
+  for (const port of ports) {
+    if (!Number.isFinite(port) || port <= 0) continue;
+    try {
+      if (process.platform === "win32") {
+        (0, import_node_child_process4.execFileSync)(
+          "powershell",
+          [
+            "-NoProfile",
+            "-Command",
+            `Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue | Where-Object { $_.OwningProcess -ne ${selfPid} } | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }`
+          ],
+          { stdio: "ignore", timeout: 3e3 }
+        );
+        continue;
+      }
+      for (const pid of listUnixListenerPids(port, selfPid)) {
+        signalPid(pid, "SIGTERM");
+      }
+    } catch {
+    }
+  }
+}
+function killStaleWorktreeListeners(ports, worktreePath, signal = "SIGTERM") {
+  if (!worktreePath.trim()) {
+    killListenersOnPorts(ports);
+    return;
+  }
+  if (process.platform === "win32") {
+    killListenersOnPorts(ports);
+    return;
+  }
+  const selfPid = process.pid;
+  for (const port of ports) {
+    if (!Number.isFinite(port) || port <= 0) continue;
+    for (const pid of listUnixListenerPids(port, selfPid)) {
+      const cwd = listenerCwd(pid);
+      if (cwd && isOtherWorktreeListenerCwd(cwd, worktreePath)) continue;
+      signalPid(pid, signal);
+    }
+  }
+}
+function killScriptTree(child, ports = []) {
+  const pid = child.pid;
+  if (pid) {
+    try {
+      if (process.platform === "win32") {
+        void (0, import_execa4.execa)("taskkill", ["/pid", String(pid), "/T", "/F"], { reject: false });
+      } else {
+        process.kill(-pid, "SIGTERM");
+        setTimeout(() => {
+          try {
+            process.kill(-pid, "SIGKILL");
+          } catch {
+          }
+        }, 2500).unref?.();
+      }
+    } catch {
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+    }
+  }
+  killListenersOnPorts(ports);
+}
+async function spawnWorkspaceScript(command, opts) {
+  const loginEnv = await captureLoginEnv();
+  const env = buildWorkspaceScriptEnv(
+    {
+      worktreePath: opts.worktreePath,
+      repoPath: opts.repoPath,
+      workspaceName: opts.workspaceName,
+      defaultBranch: opts.defaultBranch,
+      ports: opts.ports
+    },
+    loginEnv
+  );
+  try {
+    mergeAgentGitAuthEnv(
+      env,
+      await resolveAgentGitAuthEnv(env, { cwd: opts.worktreePath })
+    );
+  } catch {
+  }
+  if (opts.heldPorts?.length) {
+    await Promise.all(opts.heldPorts.map((h) => h.release()));
+  }
+  const shell = process.platform === "darwin" ? "zsh" : "bash";
+  const child = (0, import_execa4.execa)(shell, ["-lc", command], {
+    cwd: opts.worktreePath,
+    reject: false,
+    env,
+    // Own process group so Stop can tear down the whole tree (not just the shell).
+    // There is no settings.toml `stop=` / teardown hook for run scripts.
+    ...process.platform === "win32" ? {} : { detached: true }
+  });
+  pipeLines(child.stdout, opts.onLine);
+  pipeLines(child.stderr, opts.onLine);
+  const ports = opts.ports ?? [];
+  return {
+    pid: child.pid,
+    kill: () => killScriptTree(child, ports),
+    done: child.then((r) => r.exitCode ?? null),
+    child
+  };
+}
+async function attachAbort(handle, signal) {
+  if (signal) {
+    const onAbort = () => handle.kill();
+    if (signal.aborted) onAbort();
+    else signal.addEventListener("abort", onAbort, { once: true });
+  }
+  return handle.done;
+}
+async function runSetupScript(repoPath, worktreePath, onLine, opts) {
+  const settings = loadWorkspaceSettings(worktreePath, repoPath);
+  if (!settings?.setup) return { ran: false, exitCode: null, source: null };
+  const source = workspaceSettingsSourceLabel(worktreePath, repoPath);
+  onLine?.(`[setup] ${source ?? "settings.toml"}`);
+  const handle = await spawnWorkspaceScript(settings.setup, {
+    worktreePath,
+    repoPath,
+    defaultBranch: opts?.defaultBranch,
+    onLine
+  });
+  const exitCode = await attachAbort(handle, opts?.signal);
+  return {
+    ran: true,
+    exitCode,
+    source,
+    kill: handle.kill
+  };
+}
+async function runConventionSetup(repoPath, worktreePath, onLine, opts) {
+  const found = findConventionSetup(worktreePath, repoPath);
+  if (!found) return { ran: false, exitCode: null, source: null };
+  onLine?.(`[setup] ${found.source}`);
+  const handle = await spawnWorkspaceScript(found.command, {
+    worktreePath,
+    repoPath,
+    defaultBranch: opts?.defaultBranch,
+    onLine
+  });
+  const exitCode = await attachAbort(handle, opts?.signal);
+  return {
+    ran: true,
+    exitCode,
+    source: found.source,
+    kill: handle.kill
+  };
+}
+async function runWorkspaceSetup(repoPath, worktreePath, onLine, opts) {
+  await ensureWorktreeSideboardIgnored(worktreePath);
+  const review = ensureReviewGuidelinesFile(worktreePath, repoPath);
+  if (review.wrote) {
+    onLine?.(`[setup] wrote ${review.path} \u2014 local Review guidelines`);
+  }
+  let setup = await runSetupScript(repoPath, worktreePath, onLine, opts);
+  if (!setup.ran) {
+    setup = await runCursorWorktreeSetup(repoPath, worktreePath, onLine);
+  }
+  if (!setup.ran) {
+    setup = await runConventionSetup(repoPath, worktreePath, onLine, opts);
+  }
+  return setup;
+}
+async function runArchiveScript(repoPath, worktreePath, onLine) {
+  const settings = loadWorkspaceSettings(worktreePath, repoPath);
+  if (!settings?.archive) return { ran: false, exitCode: null };
+  const handle = await spawnWorkspaceScript(settings.archive, {
+    worktreePath,
+    repoPath,
+    onLine
+  });
+  const exitCode = await handle.done;
+  return { ran: true, exitCode };
+}
+function listRunScripts(worktreePath, repoPath) {
+  const settings = loadWorkspaceSettings(worktreePath, repoPath);
+  if (!settings?.runScripts.length) return [];
+  return settings.runScripts.filter((s) => {
+    if (!s.availableIn?.length) return true;
+    return s.availableIn.includes("local");
+  });
+}
+function getDefaultRunScript(worktreePath, repoPath) {
+  const scripts = listRunScripts(worktreePath, repoPath);
+  if (!scripts.length) return null;
+  return scripts.find((s) => s.default === true) ?? scripts.find((s) => s.name === "dev") ?? scripts.find((s) => s.name !== "all") ?? scripts[0] ?? null;
+}
+function getRunScript(worktreePath, repoPath, name) {
+  const scripts = listRunScripts(worktreePath, repoPath);
+  if (!scripts.length) return null;
+  if (name) {
+    return scripts.find((s) => s.name === name) ?? null;
+  }
+  return getDefaultRunScript(worktreePath, repoPath);
+}
+function getRunMode(worktreePath, repoPath) {
+  return loadWorkspaceSettings(worktreePath, repoPath)?.runMode ?? "concurrent";
+}
+async function reservePort() {
+  return new Promise((resolve2, reject) => {
+    const server = (0, import_node_net.createServer)();
+    let released = false;
     const release = () => new Promise((res) => {
       if (released) {
         res();
@@ -15140,14 +15601,14 @@ async function startDevServer(repoPath, worktreePath, onLine, opts) {
     throw err;
   }
 }
-var import_node_fs39, import_node_child_process4, import_node_net, import_node_path39, import_execa4, import_node_readline3, PORT_RANGE_SIZE, RECLAIM_RETRY_DELAY_MS, RECLAIM_TRIES, cachedLoginEnv;
+var import_node_fs40, import_node_child_process4, import_node_net, import_node_path40, import_execa4, import_node_readline3, PORT_RANGE_SIZE, RECLAIM_RETRY_DELAY_MS, RECLAIM_TRIES, cachedLoginEnv;
 var init_conductor = __esm({
   "src/hook/conductor.ts"() {
     "use strict";
-    import_node_fs39 = require("fs");
+    import_node_fs40 = require("fs");
     import_node_child_process4 = require("child_process");
     import_node_net = require("net");
-    import_node_path39 = require("path");
+    import_node_path40 = require("path");
     import_execa4 = require("execa");
     import_node_readline3 = require("readline");
     init_settings();
@@ -15159,6 +15620,7 @@ var init_conductor = __esm({
     init_request_review();
     init_worktree_exclude();
     init_worktree_run_ports();
+    init_wait_for_job();
     init_worktree_run_ports();
     init_nested_electron_env();
     PORT_RANGE_SIZE = 10;
@@ -15201,7 +15663,7 @@ function materialize(mem) {
   };
 }
 function setupLogPath(threadId) {
-  return (0, import_node_path40.join)(threadsDir(), `${threadId}.setup.log.json`);
+  return (0, import_node_path41.join)(threadsDir(), `${threadId}.setup.log.json`);
 }
 function setupLogKeyForWorktree(worktreePath) {
   const norm = normalizeWorktreePath(worktreePath);
@@ -15219,7 +15681,7 @@ function persistNow(threadId) {
   const mem = memory.get(threadId);
   if (!mem) return;
   try {
-    (0, import_node_fs40.writeFileSync)(
+    (0, import_node_fs41.writeFileSync)(
       setupLogPath(threadId),
       `${JSON.stringify(materialize(mem))}
 `,
@@ -15240,9 +15702,9 @@ function schedulePersist(threadId) {
 }
 function loadFromDisk(threadId) {
   const path = setupLogPath(threadId);
-  if (!(0, import_node_fs40.existsSync)(path)) return null;
+  if (!(0, import_node_fs41.existsSync)(path)) return null;
   try {
-    const raw = JSON.parse((0, import_node_fs40.readFileSync)(path, "utf8"));
+    const raw = JSON.parse((0, import_node_fs41.readFileSync)(path, "utf8"));
     return {
       output: typeof raw.output === "string" ? raw.output : "",
       running: Boolean(raw.running),
@@ -15298,13 +15760,13 @@ function finishSetupLog(threadId, exitCode, source) {
   persistNow(threadId);
   return materialize(mem);
 }
-var import_node_crypto8, import_node_fs40, import_node_path40, EMPTY, MAX_SETUP_LOG_CHARS, memory, persistTimers, PERSIST_DEBOUNCE_MS;
+var import_node_crypto8, import_node_fs41, import_node_path41, EMPTY, MAX_SETUP_LOG_CHARS, memory, persistTimers, PERSIST_DEBOUNCE_MS;
 var init_setup_log = __esm({
   "src/store/setup-log.ts"() {
     "use strict";
     import_node_crypto8 = require("crypto");
-    import_node_fs40 = require("fs");
-    import_node_path40 = require("path");
+    import_node_fs41 = require("fs");
+    import_node_path41 = require("path");
     init_worktree_labels();
     init_paths();
     EMPTY = {
@@ -15349,7 +15811,7 @@ function safeScriptToken(scriptName) {
   return token || "dev";
 }
 function runLogPath(key) {
-  return (0, import_node_path41.join)(threadsDir(), `${key}.run.log.json`);
+  return (0, import_node_path42.join)(threadsDir(), `${key}.run.log.json`);
 }
 function runLogKeyForWorktree(worktreePath, scriptName) {
   const norm = normalizeWorktreePath(worktreePath);
@@ -15377,7 +15839,7 @@ function persistNow2(key) {
   const mem = memory2.get(key);
   if (!mem) return;
   try {
-    (0, import_node_fs41.writeFileSync)(runLogPath(key), `${JSON.stringify(materialize2(mem))}
+    (0, import_node_fs42.writeFileSync)(runLogPath(key), `${JSON.stringify(materialize2(mem))}
 `, "utf8");
   } catch {
   }
@@ -15394,9 +15856,9 @@ function schedulePersist2(key) {
 }
 function loadFromDisk2(key) {
   const path = runLogPath(key);
-  if (!(0, import_node_fs41.existsSync)(path)) return null;
+  if (!(0, import_node_fs42.existsSync)(path)) return null;
   try {
-    const raw = JSON.parse((0, import_node_fs41.readFileSync)(path, "utf8"));
+    const raw = JSON.parse((0, import_node_fs42.readFileSync)(path, "utf8"));
     return {
       output: typeof raw.output === "string" ? raw.output : "",
       running: Boolean(raw.running),
@@ -15454,13 +15916,13 @@ function finishRunLog(key, exitCode) {
 function flushRunLog(key) {
   persistNow2(key);
 }
-var import_node_crypto9, import_node_fs41, import_node_path41, EMPTY2, MAX_RUN_LOG_CHARS, DEFAULT_RUN_LOG_TAIL_CHARS, memory2, persistTimers2, PERSIST_DEBOUNCE_MS2;
+var import_node_crypto9, import_node_fs42, import_node_path42, EMPTY2, MAX_RUN_LOG_CHARS, DEFAULT_RUN_LOG_TAIL_CHARS, memory2, persistTimers2, PERSIST_DEBOUNCE_MS2;
 var init_run_log = __esm({
   "src/store/run-log.ts"() {
     "use strict";
     import_node_crypto9 = require("crypto");
-    import_node_fs41 = require("fs");
-    import_node_path41 = require("path");
+    import_node_fs42 = require("fs");
+    import_node_path42 = require("path");
     init_worktree_labels();
     init_setup_log();
     init_paths();
@@ -15489,9 +15951,9 @@ async function findOrphanWorktrees(repoPaths) {
     repoPaths?.length ? repoPaths : threads.map((t) => t.repoPath).filter(Boolean)
   );
   const homeRoot = sideboardWorkspacesDir();
-  if ((0, import_node_fs42.existsSync)(homeRoot)) {
+  if ((0, import_node_fs43.existsSync)(homeRoot)) {
     try {
-      for (const entry of (0, import_node_fs42.readdirSync)(homeRoot, { withFileTypes: true })) {
+      for (const entry of (0, import_node_fs43.readdirSync)(homeRoot, { withFileTypes: true })) {
         if (!entry.isDirectory()) continue;
         void entry;
       }
@@ -15501,7 +15963,7 @@ async function findOrphanWorktrees(repoPaths) {
   const orphans = [];
   const seen = /* @__PURE__ */ new Set();
   for (const repoPath of repos) {
-    if (!repoPath || !(0, import_node_fs42.existsSync)(repoPath)) continue;
+    if (!repoPath || !(0, import_node_fs43.existsSync)(repoPath)) continue;
     try {
       const wts = await listWorktrees(repoPath);
       for (const wt of wts) {
@@ -15512,7 +15974,7 @@ async function findOrphanWorktrees(repoPaths) {
         seen.add(path);
         let mtimeMs = 0;
         try {
-          mtimeMs = (0, import_node_fs42.statSync)(path).mtimeMs;
+          mtimeMs = (0, import_node_fs43.statSync)(path).mtimeMs;
         } catch {
           mtimeMs = 0;
         }
@@ -15522,16 +15984,16 @@ async function findOrphanWorktrees(repoPaths) {
     }
     try {
       const root = worktreesRoot(repoPath);
-      if ((0, import_node_fs42.existsSync)(root)) {
-        for (const entry of (0, import_node_fs42.readdirSync)(root, { withFileTypes: true })) {
+      if ((0, import_node_fs43.existsSync)(root)) {
+        for (const entry of (0, import_node_fs43.readdirSync)(root, { withFileTypes: true })) {
           if (!entry.isDirectory()) continue;
-          const path = (0, import_node_path42.join)(root, entry.name).replace(/\/$/, "");
+          const path = (0, import_node_path43.join)(root, entry.name).replace(/\/$/, "");
           if (known.has(path) || seen.has(path)) continue;
-          if (!(0, import_node_fs42.existsSync)((0, import_node_path42.join)(path, ".git"))) continue;
+          if (!(0, import_node_fs43.existsSync)((0, import_node_path43.join)(path, ".git"))) continue;
           seen.add(path);
           let mtimeMs = 0;
           try {
-            mtimeMs = (0, import_node_fs42.statSync)(path).mtimeMs;
+            mtimeMs = (0, import_node_fs43.statSync)(path).mtimeMs;
           } catch {
             mtimeMs = Date.now();
           }
@@ -15583,12 +16045,12 @@ function shouldRunWorktreeCleanup(settings = loadAppSettings()) {
   const elapsed = Date.now() - Date.parse(last);
   return elapsed >= intervalHours * 36e5;
 }
-var import_node_fs42, import_node_path42;
+var import_node_fs43, import_node_path43;
 var init_orphan_cleanup = __esm({
   "src/git/orphan-cleanup.ts"() {
     "use strict";
-    import_node_fs42 = require("fs");
-    import_node_path42 = require("path");
+    import_node_fs43 = require("fs");
+    import_node_path43 = require("path");
     init_worktree();
     init_thread_store();
     init_paths();
@@ -15604,6 +16066,7 @@ function stripArchivedTranscript(thread) {
       attachments: [],
       pendingTurnAttachments: [],
       queueAttachments: [],
+      compactedMessages: void 0,
       messages: [historyRetentionStubMessage(thread)]
     },
     { touch: false }
@@ -15755,534 +16218,146 @@ var init_apply_into_main = __esm({
     import_execa5 = require("execa");
     init_worktree();
   }
-});
-
-// src/git/clone-repo.ts
-async function cloneRepoIntoSideboard(opts) {
-  const url = opts.url.trim();
-  if (!url) throw new Error("Clone URL is required");
-  let name = opts.name?.trim();
-  if (!name) {
-    const leaf = (0, import_node_path43.basename)(url.replace(/\/$/, "").replace(/\.git$/, ""));
-    name = leaf || "repo";
-  }
-  name = name.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
-  const dest = (0, import_node_path43.join)(sideboardReposDir(), name);
-  if ((0, import_node_fs43.existsSync)(dest)) {
-    const repoPath2 = await resolveRepoRoot(dest);
-    const workspace2 = await ensureWorkspace(repoPath2);
-    return { repoPath: repoPath2, workspace: workspace2 };
-  }
-  const result = await (0, import_execa6.execa)("git", ["clone", url, dest], { reject: false });
-  if (result.exitCode !== 0) {
-    throw new Error(
-      `git clone failed: ${result.stderr?.trim() || result.stdout?.trim() || `exit ${result.exitCode}`}`
-    );
-  }
-  const repoPath = await resolveRepoRoot(dest);
-  const workspace = await ensureWorkspace(repoPath);
-  return { repoPath, workspace };
-}
-var import_node_fs43, import_node_path43, import_execa6;
-var init_clone_repo = __esm({
-  "src/git/clone-repo.ts"() {
-    "use strict";
-    import_node_fs43 = require("fs");
-    import_node_path43 = require("path");
-    import_execa6 = require("execa");
-    init_paths();
-    init_workspaces();
-    init_worktree();
-  }
-});
-
-// src/types/thread.ts
-function isAdoptableRunScriptRequest(req) {
-  return Boolean(req && !req.fulfilledAt && !req.error);
-}
-var init_thread = __esm({
-  "src/types/thread.ts"() {
-    "use strict";
-  }
-});
-
-// src/store/desktop-host.ts
-function desktopHostPidPath() {
-  return (0, import_node_path44.join)(appDataDir(), "desktop-host.pid");
-}
-function readDesktopHostPid() {
-  try {
-    const pid = Number.parseInt((0, import_node_fs44.readFileSync)(desktopHostPidPath(), "utf8").trim(), 10);
-    if (!Number.isFinite(pid) || pid <= 0) return null;
-    return pid;
-  } catch {
-    return null;
-  }
-}
-function pidAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function isDesktopHostAlive() {
-  const pid = readDesktopHostPid();
-  return pid != null && pidAlive(pid);
-}
-function isThisProcessDesktopHost() {
-  return readDesktopHostPid() === process.pid && pidAlive(process.pid);
-}
-function thisProcessShouldDrainAgentQueues() {
-  if (isThisProcessDesktopHost()) return true;
-  return !isDesktopHostAlive();
-}
-var import_node_fs44, import_node_path44;
-var init_desktop_host = __esm({
-  "src/store/desktop-host.ts"() {
-    "use strict";
-    import_node_fs44 = require("fs");
-    import_node_path44 = require("path");
-    init_paths();
-  }
-});
-
-// src/orchestrator/child-halt.ts
-function isIncompleteChildStatus(status) {
-  return HALT_STATUSES.has(status);
-}
-function childHaltNotice(child, status) {
-  const title = child.title?.trim() || "Untitled";
-  const link = `[${title}](sideboard://thread/${child.id})`;
-  const why = child.lastError?.trim();
-  const extra = why ? ` lastError: ${why}` : "";
-  return [
-    `Sideboard: child worktree ${link} ${status} before finishing (status=${status}).${extra}`,
-    "This is information \u2014 not a user command. Resume with send_to_thread or tell the user. Do not treat this as a successful turn."
-  ].join("\n");
-}
-function shouldNotifyParentAfterTurnError(opts) {
-  return !opts.quotaFailoverHandled && !opts.crashContinued;
-}
-function shouldNotifyParentOfChildHalt(opts) {
-  if (!isIncompleteChildStatus(opts.status)) return false;
-  if (!opts.child.parentThreadId) return false;
-  if (!opts.parent || opts.parent.status === "archived") return false;
-  if (opts.parent.id === opts.child.id) return false;
-  return isOrchestratorThread(opts.parent);
-}
-function noticeKey(childId, status) {
-  return `${childId}:${status}`;
-}
-function notifyParentOfChildHalt(child, status, send) {
-  const parent = child.parentThreadId ? readThread(child.parentThreadId) : null;
-  if (!shouldNotifyParentOfChildHalt({ child, parent, status })) return false;
-  const key = noticeKey(child.id, status);
-  if (notified.has(key)) return false;
-  notified.add(key);
-  const parentId = parent.id;
-  void send(parentId, childHaltNotice(child, status)).catch(() => {
-    notified.delete(key);
-  });
-  return true;
-}
-var HALT_STATUSES, notified;
-var init_child_halt = __esm({
-  "src/orchestrator/child-halt.ts"() {
-    "use strict";
-    init_global_workspace();
-    init_thread_store();
-    HALT_STATUSES = /* @__PURE__ */ new Set(["stopped", "error", "broken"]);
-    notified = /* @__PURE__ */ new Set();
-  }
-});
-
-// src/mcp/wait-for-turn.ts
-function mcpWaitForTurnTimeoutMs(requested) {
-  const n = requested ?? MCP_WAIT_FOR_TURN_MAX_MS;
-  if (!Number.isFinite(n)) return MCP_WAIT_FOR_TURN_MAX_MS;
-  return Math.min(Math.max(1e3, Math.floor(n)), MCP_WAIT_FOR_TURN_MAX_MS);
-}
-function mcpWaitTaskHint(taskState, status) {
-  switch (taskState) {
-    case "submitted":
-      return MCP_WAIT_QUEUED_HINT;
-    case "working":
-      return MCP_WAIT_STILL_RUNNING_HINT;
-    case "input-required":
-      return MCP_WAIT_INPUT_REQUIRED_HINT;
-    case "canceled":
-      return MCP_WAIT_STOPPED_HINT;
-    case "failed":
-      return status === "broken" ? MCP_WAIT_BROKEN_HINT : MCP_WAIT_ERROR_HINT;
-    default:
-      return void 0;
-  }
-}
-var MCP_WAIT_FOR_TURN_MAX_MS, MCP_WAIT_STILL_RUNNING_HINT, MCP_WAIT_QUEUED_HINT, MCP_WAIT_STOPPED_HINT, MCP_WAIT_BROKEN_HINT, MCP_WAIT_ERROR_HINT, MCP_WAIT_INPUT_REQUIRED_HINT;
-var init_wait_for_turn = __esm({
-  "src/mcp/wait-for-turn.ts"() {
-    "use strict";
-    MCP_WAIT_FOR_TURN_MAX_MS = 45e3;
-    MCP_WAIT_STILL_RUNNING_HINT = "Child is still working. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts) or assume a hang while progress is updating.";
-    MCP_WAIT_QUEUED_HINT = "Child is queued waiting for a concurrency slot \u2014 it has not started yet. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts), force_stop, or assume it failed to start.";
-    MCP_WAIT_STOPPED_HINT = "Child was stopped before the turn finished. Do not treat this as success. send_to_thread to resume, or tell the user.";
-    MCP_WAIT_BROKEN_HINT = "Child worktree is broken (missing on disk). Tell the user \u2014 do not treat this as success.";
-    MCP_WAIT_ERROR_HINT = "Child turn failed. lastError/text is the failure \u2014 switch agent, tell the user, or retry. Do not treat empty text as success.";
-    MCP_WAIT_INPUT_REQUIRED_HINT = "Child asked the user a question (ask_user). taskState is input-required. Wait for the user to answer in that chat \u2014 do not send_to_thread a check-in.";
-  }
-});
-
-// src/mcp/wait-for-job.ts
-function mcpWaitForJobTimeoutMs(requested) {
-  return mcpWaitForTurnTimeoutMs(requested);
-}
-function sanitizeDetachedJobId(id) {
-  const s = id.trim();
-  if (!JOB_ID_RE.test(s)) {
-    throw new Error(`detached-job id must be 1\u201364 chars [A-Za-z0-9._-], got ${JSON.stringify(id)}`);
-  }
-  return s;
-}
-function jobAlive(pid) {
-  if (!Number.isInteger(pid) || pid <= 0) return false;
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function processGroupAlive(pgid) {
-  if (process.platform === "win32") return false;
-  if (!Number.isInteger(pgid) || pgid <= 1) return false;
-  try {
-    process.kill(-pgid, 0);
-    return true;
-  } catch (err) {
-    return err && typeof err === "object" && "code" in err && err.code === "EPERM";
-  }
-}
-function jobTreeAlive(pid) {
-  if (pid == null) return false;
-  return jobAlive(pid) || processGroupAlive(pid);
-}
-function readIntFile(file) {
-  if (!(0, import_node_fs45.existsSync)(file)) return null;
-  const n = Number.parseInt((0, import_node_fs45.readFileSync)(file, "utf8").trim(), 10);
-  return Number.isInteger(n) ? n : null;
-}
-function jobDir(root, id, legacy = false) {
-  return (0, import_node_path45.join)(root, legacy ? LEGACY_DETACHED_JOBS_DIR : DETACHED_JOBS_DIR, id);
-}
-function resolveJobDir(root, id) {
-  const modern = jobDir(root, id, false);
-  if ((0, import_node_fs45.existsSync)(modern)) return modern;
-  const legacy = jobDir(root, id, true);
-  if ((0, import_node_fs45.existsSync)(legacy)) return legacy;
-  return modern;
-}
-function listJobIdsIn(root, rel) {
-  const dir = (0, import_node_path45.join)(root, rel);
-  if (!(0, import_node_fs45.existsSync)(dir)) return [];
-  return (0, import_node_fs45.readdirSync)(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && JOB_ID_RE.test(e.name)).map((e) => e.name);
-}
-function listRunningDetachedJobs(worktreePath) {
-  const root = worktreePath.trim();
-  if (!root) return [];
-  const ids = /* @__PURE__ */ new Set([
-    ...listJobIdsIn(root, DETACHED_JOBS_DIR),
-    ...listJobIdsIn(root, LEGACY_DETACHED_JOBS_DIR)
-  ]);
-  const running = [];
-  for (const id of ids) {
-    const dir = resolveJobDir(root, id);
-    const pid = readIntFile((0, import_node_path45.join)(dir, "pid"));
-    if (jobTreeAlive(pid)) running.push(id);
-  }
-  return running.sort();
-}
-function looksLikeDeferredDonePromise(text7) {
-  const t = (text7 ?? "").trim();
-  if (!t || t.length > DEFERRED_DONE_MAX_CHARS) return false;
-  const unquoted = t.replace(/`[^`]*`/g, " ").replace(/["“”][^"“”]*["“”]/g, " ").replace(/\s+/g, " ").trim();
-  if (!unquoted) return false;
-  return /\b(i['’]?ll|i will)\s+let you know\b/i.test(unquoted) || /\blet you know when\b/i.test(unquoted) || /\b(check back|ping me)\s+when\b/i.test(unquoted) || /\bi(?:['’]ll| will)\s+(report|update you)\s+when\b/i.test(unquoted);
-}
-function isJobContinuePrompt(text7) {
-  if (typeof text7 !== "string") return false;
-  const t = text7.trim();
-  return t.startsWith("Detached job still running:") || t.startsWith("You ended the turn after promising to report later");
-}
-function collapseGhRunWatchLog(text7) {
-  if (!text7.includes(GH_WATCH_REFRESH)) return text7;
-  const frames = text7.split(/(?=Refreshing run status every 3 seconds\.)/);
-  const watchFrames = frames.filter((f) => f.includes(GH_WATCH_REFRESH));
-  if (watchFrames.length <= 1) return text7;
-  const prefix = frames[0]?.includes(GH_WATCH_REFRESH) ? "" : frames[0] ?? "";
-  const last = watchFrames[watchFrames.length - 1] ?? "";
-  const omitted = watchFrames.length - 1;
-  const note = `(${omitted} identical gh run watch refresh${omitted === 1 ? "" : "es"} omitted)
-`;
-  return [prefix.trimEnd(), note, last.trimStart()].filter(Boolean).join("\n");
-}
-function capJobLogDelta(text7) {
-  const collapsed = collapseGhRunWatchLog(text7);
-  const lines = collapsed.split("\n");
-  let out = lines.length > MAX_JOB_DELTA_LINES ? `\u2026(${lines.length - MAX_JOB_DELTA_LINES} earlier lines omitted)
-${lines.slice(-MAX_JOB_DELTA_LINES).join("\n")}` : collapsed;
-  if (out.length > MAX_JOB_DELTA_CHARS) {
-    out = `\u2026(truncated ${out.length} chars)
-${out.slice(-MAX_JOB_DELTA_CHARS)}`;
-  }
-  return out;
-}
-function formatJobStillRunningContinuePrompt(jobIds) {
-  const ids = jobIds.join(", ");
-  return [
-    `Detached job still running: ${ids}.`,
-    "Do not end this turn. Loop wait_for_job (same id) until stillRunning is false. The log pane updates from each wait result.",
-    "If the job is hanging or doing the wrong thing, call stop_job (same id) instead of looping forever.",
-    "Then report the result. Do not tell the user you will let them know later."
-  ].join(" ");
-}
-function formatDeferredDoneContinuePrompt() {
-  return [
-    "You ended the turn after promising to report later, but no detached job is running.",
-    "If tests/pack/deploy still need to run: start once with detached-job.cjs, then loop wait_for_job until stillRunning is false (the log pane updates from wait JSON).",
-    "Do not say you will let the user know later."
-  ].join(" ");
-}
-function turnWatchedDetachedJob(parts) {
-  return parts.some((p) => {
-    if (p.type !== "tool") return false;
-    if (/wait_for_job$/i.test(p.name ?? "") || /stop_job$/i.test(p.name ?? "")) return true;
-    const blob = [p.name, p.detail, p.description, p.input ? JSON.stringify(p.input) : ""].filter(Boolean).join(" ");
-    return /detached-job\.(?:js|cjs)\b/i.test(blob);
-  });
-}
-function planJobContinue(opts) {
-  if (opts.isOrchestrator) return { action: "none" };
-  if (opts.agent === "brightsy") return { action: "none" };
-  if (opts.queueLength > 0) return { action: "none" };
-  if (opts.continueCount >= MAX_JOB_CONTINUES) return { action: "none" };
-  const farewell = looksLikeDeferredDonePromise(opts.chatText);
-  if (opts.runningJobIds.length > 0 && (farewell || opts.watchedJob)) {
-    return {
-      action: "wait",
-      jobIds: opts.runningJobIds,
-      prompt: formatJobStillRunningContinuePrompt(opts.runningJobIds)
-    };
-  }
-  if (looksLikeDeferredDonePromise(opts.chatText) && !opts.alreadyNudged) {
-    return { action: "nudge", prompt: formatDeferredDoneContinuePrompt() };
-  }
-  return { action: "none" };
-}
-function tailProgress(logFile, maxLines = 12) {
-  if (!(0, import_node_fs45.existsSync)(logFile)) return "(no log yet)";
-  const lines = (0, import_node_fs45.readFileSync)(logFile, "utf8").split("\n");
-  return lines.slice(-maxLines).join("\n");
-}
-function lastProgressLine(progress) {
-  const last = progress.split("\n").map((l) => l.trim()).filter((l) => l && l !== "(no log yet)").at(-1);
-  return last ? last.slice(0, 72) : void 0;
-}
-function readLogLines(file) {
-  if (!(0, import_node_fs45.existsSync)(file)) return [];
-  const lines = (0, import_node_fs45.readFileSync)(file, "utf8").split("\n");
-  if (lines.length && lines[lines.length - 1] === "") lines.pop();
-  return lines;
-}
-function takeDelta(logFile, cursorFile) {
-  const lines = readLogLines(logFile);
-  const cursor = readIntFile(cursorFile) ?? 0;
-  const start = Math.min(Math.max(0, cursor), lines.length);
-  return { delta: capJobLogDelta(lines.slice(start).join("\n")), nextCursor: lines.length };
-}
-function snapshotJob(dir) {
-  const pid = readIntFile((0, import_node_path45.join)(dir, "pid"));
-  const running = jobTreeAlive(pid);
-  return {
-    pid,
-    running,
-    exitCode: readIntFile((0, import_node_path45.join)(dir, "exit")),
-    log: (0, import_node_path45.join)(dir, "log"),
-    cursor: (0, import_node_path45.join)(dir, "present.cursor"),
-    progress: tailProgress((0, import_node_path45.join)(dir, "log"))
-  };
-}
-function toResult(id, snap, extra) {
-  const failed = extra?.failed === true || !snap.running && snap.exitCode != null && snap.exitCode !== 0;
-  const ok = !snap.running && snap.exitCode === 0;
-  const stillRunning = snap.running && !ok;
-  const { delta, nextCursor } = takeDelta(snap.log, snap.cursor);
-  try {
-    (0, import_node_fs45.mkdirSync)((0, import_node_path45.dirname)(snap.cursor), { recursive: true });
-    (0, import_node_fs45.writeFileSync)(snap.cursor, `${nextCursor}
-`);
-  } catch {
-  }
-  const status = ok ? "ok" : failed && !stillRunning ? "failed" : stillRunning ? "running" : "idle";
-  const progress = extra?.progress ?? snap.progress;
-  return {
-    stillRunning,
-    ok,
-    failed: Boolean(failed && !stillRunning && !ok),
-    status,
-    id,
-    pid: snap.pid,
-    exitCode: snap.exitCode ?? void 0,
-    phase: lastProgressLine(progress),
-    delta,
-    progress,
-    hint: stillRunning ? MCP_WAIT_JOB_STILL_RUNNING_HINT : void 0
-  };
-}
-async function sleepMs(ms) {
-  await new Promise((resolve2) => setTimeout(resolve2, ms));
-}
-async function waitForDetachedJob(cwd, id, opts) {
-  const jobId = sanitizeDetachedJobId(id);
-  const root = cwd.trim() || process.cwd();
-  const dir = resolveJobDir(root, jobId);
-  const timeoutMs = mcpWaitForJobTimeoutMs(opts?.timeoutMs);
-  const sleep = opts?.sleep ?? sleepMs;
-  if (!(0, import_node_fs45.existsSync)(dir)) {
-    return {
-      stillRunning: false,
-      ok: false,
-      failed: true,
-      status: "failed",
-      id: jobId,
-      delta: "",
-      progress: "No detached job. Start one first.",
-      hint: "Start with detached-job.cjs start <id> -- <command>, then call wait_for_job again."
-    };
-  }
-  const deadline = Date.now() + timeoutMs;
-  let snap = snapshotJob(dir);
-  if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
-  if (!snap.running && snap.pid == null && snap.progress === "(no log yet)") {
-    return toResult(jobId, snap, {
-      failed: true,
-      progress: "No detached job. Start one first."
-    });
+});
+
+// src/git/clone-repo.ts
+async function cloneRepoIntoSideboard(opts) {
+  const url = opts.url.trim();
+  if (!url) throw new Error("Clone URL is required");
+  let name = opts.name?.trim();
+  if (!name) {
+    const leaf = (0, import_node_path44.basename)(url.replace(/\/$/, "").replace(/\.git$/, ""));
+    name = leaf || "repo";
   }
-  while (Date.now() < deadline) {
-    snap = snapshotJob(dir);
-    if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
-    if (!snap.running) return toResult(jobId, snap, { failed: true });
-    await sleep(Math.min(2e3, Math.max(50, deadline - Date.now())));
+  name = name.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
+  const dest = (0, import_node_path44.join)(sideboardReposDir(), name);
+  if ((0, import_node_fs44.existsSync)(dest)) {
+    const repoPath2 = await resolveRepoRoot(dest);
+    const workspace2 = await ensureWorkspace(repoPath2);
+    return { repoPath: repoPath2, workspace: workspace2 };
   }
-  snap = snapshotJob(dir);
-  return toResult(jobId, snap);
+  const result = await (0, import_execa6.execa)("git", ["clone", url, dest], { reject: false });
+  if (result.exitCode !== 0) {
+    throw new Error(
+      `git clone failed: ${result.stderr?.trim() || result.stdout?.trim() || `exit ${result.exitCode}`}`
+    );
+  }
+  const repoPath = await resolveRepoRoot(dest);
+  const workspace = await ensureWorkspace(repoPath);
+  return { repoPath, workspace };
 }
-function killProcessTree(pid, signal) {
-  if (!Number.isInteger(pid) || pid <= 0) return;
-  if (process.platform !== "win32") {
-    try {
-      process.kill(-pid, signal);
-      return;
-    } catch {
-    }
+var import_node_fs44, import_node_path44, import_execa6;
+var init_clone_repo = __esm({
+  "src/git/clone-repo.ts"() {
+    "use strict";
+    import_node_fs44 = require("fs");
+    import_node_path44 = require("path");
+    import_execa6 = require("execa");
+    init_paths();
+    init_workspaces();
+    init_worktree();
+  }
+});
+
+// src/types/thread.ts
+function isAdoptableRunScriptRequest(req) {
+  return Boolean(req && !req.fulfilledAt && !req.error);
+}
+var init_thread = __esm({
+  "src/types/thread.ts"() {
+    "use strict";
   }
+});
+
+// src/store/desktop-host.ts
+function desktopHostPidPath() {
+  return (0, import_node_path45.join)(appDataDir(), "desktop-host.pid");
+}
+function readDesktopHostPid() {
   try {
-    process.kill(pid, signal);
+    const pid = Number.parseInt((0, import_node_fs45.readFileSync)(desktopHostPidPath(), "utf8").trim(), 10);
+    if (!Number.isFinite(pid) || pid <= 0) return null;
+    return pid;
   } catch {
+    return null;
   }
 }
-function appendJobLog(logFile, line) {
+function pidAlive(pid) {
   try {
-    (0, import_node_fs45.mkdirSync)((0, import_node_path45.dirname)(logFile), { recursive: true });
-    const body = line.endsWith("\n") ? line : `${line}
-`;
-    (0, import_node_fs45.appendFileSync)(logFile, body);
+    process.kill(pid, 0);
+    return true;
   } catch {
+    return false;
   }
 }
-async function stopDetachedJob(cwd, id, opts) {
-  const jobId = sanitizeDetachedJobId(id);
-  const root = cwd.trim() || process.cwd();
-  const dir = resolveJobDir(root, jobId);
-  const sleep = opts?.sleep ?? sleepMs;
-  const why = opts?.reason?.trim() ?? "";
-  if (!(0, import_node_fs45.existsSync)(dir)) {
-    return {
-      stillRunning: false,
-      ok: false,
-      failed: true,
-      status: "failed",
-      id: jobId,
-      delta: "",
-      progress: "No detached job. Start one first.",
-      hint: "Start with detached-job.cjs start <id> -- <command>, then wait_for_job or stop_job.",
-      stopped: false,
-      reason: "not-found"
-    };
-  }
-  let snap = snapshotJob(dir);
-  if (!snap.running) {
-    const result2 = toResult(jobId, snap);
-    return {
-      ...result2,
-      stopped: false,
-      reason: "not-running",
-      hint: "That job is already finished. Read the log; do not wait again unless you start a new command."
-    };
-  }
-  appendJobLog(snap.log, `$ stop${why ? `: ${why}` : ""}`);
-  const targetPid = snap.pid;
-  if (targetPid != null) killProcessTree(targetPid, "SIGTERM");
-  const graceMs = Number.isFinite(opts?.graceMs) ? Math.max(50, opts.graceMs) : 2e3;
-  const deadline = Date.now() + graceMs;
-  while (Date.now() < deadline && jobTreeAlive(targetPid)) {
-    await sleep(Math.min(100, Math.max(20, deadline - Date.now())));
-  }
-  if (targetPid != null) {
-    killProcessTree(targetPid, "SIGKILL");
-    await sleep(100);
-  }
-  const exitFile = (0, import_node_path45.join)(dir, "exit");
-  if (!(0, import_node_fs45.existsSync)(exitFile)) {
-    try {
-      (0, import_node_fs45.writeFileSync)(exitFile, "1\n");
-    } catch {
-    }
-  }
-  snap = snapshotJob(dir);
-  const stillRunning = jobTreeAlive(targetPid) || snap.running;
-  const result = toResult(jobId, snap, { failed: true });
-  const stopped = !stillRunning;
-  return {
-    ...result,
-    stillRunning,
-    ok: false,
-    failed: true,
-    status: stillRunning ? "running" : "failed",
-    stopped,
-    reason: stopped ? "stopped" : "still-running",
-    stopReason: why || void 0,
-    hint: stopped ? MCP_STOP_JOB_HINT : MCP_WAIT_JOB_STILL_RUNNING_HINT
-  };
+function isDesktopHostAlive() {
+  const pid = readDesktopHostPid();
+  return pid != null && pidAlive(pid);
 }
-var import_node_fs45, import_node_path45, MAX_JOB_CONTINUES, MAX_JOB_DELTA_LINES, MAX_JOB_DELTA_CHARS, DEFERRED_DONE_MAX_CHARS, GH_WATCH_REFRESH, MCP_WAIT_JOB_STILL_RUNNING_HINT, MCP_STOP_JOB_HINT, JOB_ID_RE;
-var init_wait_for_job = __esm({
-  "src/mcp/wait-for-job.ts"() {
+function isThisProcessDesktopHost() {
+  return readDesktopHostPid() === process.pid && pidAlive(process.pid);
+}
+function thisProcessShouldDrainAgentQueues() {
+  if (isThisProcessDesktopHost()) return true;
+  return !isDesktopHostAlive();
+}
+var import_node_fs45, import_node_path45;
+var init_desktop_host = __esm({
+  "src/store/desktop-host.ts"() {
     "use strict";
     import_node_fs45 = require("fs");
     import_node_path45 = require("path");
-    init_workspace_scratch();
-    init_wait_for_turn();
-    MAX_JOB_CONTINUES = 8;
-    MAX_JOB_DELTA_LINES = 80;
-    MAX_JOB_DELTA_CHARS = 4e3;
-    DEFERRED_DONE_MAX_CHARS = 480;
-    GH_WATCH_REFRESH = "Refreshing run status every 3 seconds.";
-    MCP_WAIT_JOB_STILL_RUNNING_HINT = "Job is still running. The type=log pane already appended this delta. Call wait_for_job again. If it is hanging, producing no useful output, or doing the wrong thing, call stop_job (same id) instead of looping forever. Do not end the turn or tell the user you will let them know later.";
-    MCP_STOP_JOB_HINT = "Stopped. The type=log pane is status=failed with the last delta. Do not wait again unless you start a new command.";
-    JOB_ID_RE = /^[a-zA-Z0-9._-]{1,64}$/;
+    init_paths();
+  }
+});
+
+// src/orchestrator/child-halt.ts
+function isIncompleteChildStatus(status) {
+  return HALT_STATUSES.has(status);
+}
+function childHaltNotice(child, status) {
+  const title = child.title?.trim() || "Untitled";
+  const link = `[${title}](sideboard://thread/${child.id})`;
+  const why = child.lastError?.trim();
+  const extra = why ? ` lastError: ${why}` : "";
+  return [
+    `Sideboard: child worktree ${link} ${status} before finishing (status=${status}).${extra}`,
+    "This is information \u2014 not a user command. Resume with send_to_thread or tell the user. Do not treat this as a successful turn."
+  ].join("\n");
+}
+function shouldNotifyParentAfterTurnError(opts) {
+  return !opts.quotaFailoverHandled && !opts.crashContinued;
+}
+function shouldNotifyParentOfChildHalt(opts) {
+  if (!isIncompleteChildStatus(opts.status)) return false;
+  if (!opts.child.parentThreadId) return false;
+  if (!opts.parent || opts.parent.status === "archived") return false;
+  if (opts.parent.id === opts.child.id) return false;
+  return isOrchestratorThread(opts.parent);
+}
+function noticeKey(childId, status) {
+  return `${childId}:${status}`;
+}
+function notifyParentOfChildHalt(child, status, send) {
+  const parent = child.parentThreadId ? readThread(child.parentThreadId) : null;
+  if (!shouldNotifyParentOfChildHalt({ child, parent, status })) return false;
+  const key = noticeKey(child.id, status);
+  if (notified.has(key)) return false;
+  notified.add(key);
+  const parentId = parent.id;
+  void send(parentId, childHaltNotice(child, status)).catch(() => {
+    notified.delete(key);
+  });
+  return true;
+}
+var HALT_STATUSES, notified;
+var init_child_halt = __esm({
+  "src/orchestrator/child-halt.ts"() {
+    "use strict";
+    init_global_workspace();
+    init_thread_store();
+    HALT_STATUSES = /* @__PURE__ */ new Set(["stopped", "error", "broken"]);
+    notified = /* @__PURE__ */ new Set();
   }
 });
 
@@ -21349,6 +21424,13 @@ function isPresentPlanToolName(name) {
   if (!name) return false;
   return /present_plan$/i.test(name) || /^mcp__sideboard__present_plan$/i.test(name);
 }
+function threadMayPresentPlan(thread) {
+  return Boolean(thread?.planMode);
+}
+function shouldRegisterPresentPlan(thread) {
+  if (thread == null) return true;
+  return threadMayPresentPlan(thread);
+}
 function extractPresentedPlan(parts) {
   if (!parts?.length) return null;
   for (let i = parts.length - 1; i >= 0; i--) {
@@ -21386,7 +21468,7 @@ function resolvePlanMarkdown(opts) {
   }
   return null;
 }
-var PLAN_FILE_REL, PLAN_FILE_NAME, LEGACY_PLAN_FILE_REL;
+var PLAN_FILE_REL, PLAN_FILE_NAME, LEGACY_PLAN_FILE_REL, PRESENT_PLAN_TOOL_DESCRIPTION, PRESENT_PLAN_REQUIRES_PLAN_MODE;
 var init_plan_present = __esm({
   "src/plan/plan-present.ts"() {
     "use strict";
@@ -21394,6 +21476,8 @@ var init_plan_present = __esm({
     PLAN_FILE_REL = `${ATTACHMENTS_DIR}/plan.md`;
     PLAN_FILE_NAME = "plan.md";
     LEGACY_PLAN_FILE_REL = ".sideboard/plan.md";
+    PRESENT_PLAN_TOOL_DESCRIPTION = "Only when Sideboard Plan mode is on (composer Plan chip). Saves the implementation plan to .context/attachments/plan.md and shows Approve / Hand off / Copy in chat. Pass the full plan body in content. Then Claude should call ExitPlanMode. If Plan mode is off, do not call this \u2014 write the plan in chat.";
+    PRESENT_PLAN_REQUIRES_PLAN_MODE = "Plan mode is off. Do not call present_plan or ExitPlanMode. Write the plan in chat. The user can turn Plan on in the composer.";
   }
 });
 
@@ -21403,11 +21487,15 @@ __export(plan_file_exports, {
   LEGACY_PLAN_FILE_REL: () => LEGACY_PLAN_FILE_REL,
   PLAN_FILE_NAME: () => PLAN_FILE_NAME,
   PLAN_FILE_REL: () => PLAN_FILE_REL,
+  PRESENT_PLAN_REQUIRES_PLAN_MODE: () => PRESENT_PLAN_REQUIRES_PLAN_MODE,
+  PRESENT_PLAN_TOOL_DESCRIPTION: () => PRESENT_PLAN_TOOL_DESCRIPTION,
   extractPresentedPlan: () => extractPresentedPlan,
   isPresentPlanToolName: () => isPresentPlanToolName,
   planFileAbs: () => planFileAbs,
   readPlanFile: () => readPlanFile,
   resolvePlanMarkdown: () => resolvePlanMarkdown,
+  shouldRegisterPresentPlan: () => shouldRegisterPresentPlan,
+  threadMayPresentPlan: () => threadMayPresentPlan,
   writePlanFile: () => writePlanFile
 });
 function ensureAttachmentsGitignore(worktreePath) {
@@ -23075,7 +23163,8 @@ var init_orchestrator = __esm({
             if (compact.didCompact) {
               thread = updateThread(threadId, {
                 messages: compact.thread.messages,
-                sessionId: compact.thread.sessionId
+                sessionId: compact.thread.sessionId,
+                compactedMessages: compact.thread.compactedMessages
               });
               this.emit({
                 type: "context_compacted",
@@ -23089,9 +23178,6 @@ var init_orchestrator = __esm({
             this.emit({ type: "error", threadId, message: `context compact failed: ${message}` });
             thread = this.requireThread(threadId);
           }
-          if (this.stoppedTurns.has(threadId)) {
-            return;
-          }
           const promptText = typeof prompt === "string" ? prompt : "";
           const autoContinue = isJobContinuePrompt(promptText) || promptText.startsWith("The previous agent process ended before it finished.");
           const parked = takePendingTurnAttachments(thread);
@@ -23108,6 +23194,14 @@ var init_orchestrator = __esm({
             agent: thread.agent,
             orch: isOrchestratorThread(thread)
           });
+          if (this.stoppedTurns.has(threadId)) {
+            const stopped = writeLiveStatus(threadId, "stopped");
+            if (stopped?.status === "stopped") {
+              this.emit({ type: "status_changed", threadId, status: "stopped" });
+            }
+            this.emit({ type: "turn_finished", threadId, exitCode: 1 });
+            return;
+          }
           thread = this.requireThread(threadId);
           const gitPrompt = expandCanonicalGitRequest(promptText);
           const { agentPrompt: expandedPrompt } = expandComposerPrompt(
@@ -23166,7 +23260,7 @@ var init_orchestrator = __esm({
           ].filter(Boolean).join("\n\n") || void 0;
           const prGateDirective = thread.agent !== "brightsy" && !isOrchestratorThread(thread) && mentionsPrGoal(promptText) ? formatPrGateDirective() : null;
           const agentPrompt = [
-            thread.planMode ? PLAN_MODE_INSTRUCTION : null,
+            planModeTurnInstruction(thread.planMode),
             orchestrationReminder,
             prGateDirective,
             injectedNoticeContext,
@@ -23669,6 +23763,9 @@ var init_orchestrator = __esm({
         }
         const preferredPorts = active?.ports?.length ? active.ports : active?.port != null ? [active.port] : void 0;
         if (active && !existing) {
+          if (typeof active.pid === "number") {
+            killDetachedRunTree(active.pid, thread.worktreePath);
+          }
           killListenersOnPorts(collectActiveRunPorts([active]));
           this.syncWorktreeRuns(
             thread.worktreePath,
@@ -23741,7 +23838,8 @@ var init_orchestrator = __esm({
           scriptName: resolvedName,
           port: handle.port,
           ports: handle.ports,
-          startedAt
+          startedAt,
+          ...typeof handle.pid === "number" && handle.pid > 1 ? { pid: handle.pid } : {}
         };
         const nextRuns = [
           ...latestShared.activeRuns.filter((r) => r.scriptName !== resolvedName),
@@ -23887,6 +23985,9 @@ var init_orchestrator = __esm({
           }
           const run2 = shared.activeRuns.find((r) => r.scriptName === scriptName);
           if (!hadHandle2 && run2) {
+            if (typeof run2.pid === "number") {
+              killDetachedRunTree(run2.pid, thread.worktreePath);
+            }
             killListenersOnPorts(collectActiveRunPorts([run2]));
           }
           const remaining = shared.activeRuns.filter((r) => r.scriptName !== scriptName);
@@ -23908,6 +24009,11 @@ var init_orchestrator = __esm({
           }
         }
         if (!hadHandle && shared.activeRuns.length > 0) {
+          for (const run2 of shared.activeRuns) {
+            if (typeof run2.pid === "number") {
+              killDetachedRunTree(run2.pid, thread.worktreePath);
+            }
+          }
           killListenersOnPorts(collectActiveRunPorts(shared.activeRuns));
         }
         this.syncWorktreeRuns(thread.worktreePath, [], null);
@@ -23949,6 +24055,11 @@ var init_orchestrator = __esm({
             (k) => isWorktreeRunProcessKey(k, thread.worktreePath) || siblings.some((t) => k.startsWith(`${t.id}:run:`) || k === `${t.id}:dev`)
           );
           if (!force && hasLiveHandle) continue;
+          for (const run2 of shared.activeRuns) {
+            if (typeof run2.pid === "number") {
+              killDetachedRunTree(run2.pid, thread.worktreePath);
+            }
+          }
           killListenersOnPorts(collectActiveRunPorts(shared.activeRuns));
           if (shared.devPort != null) {
             killListenersOnPorts([shared.devPort]);
@@ -26577,6 +26688,7 @@ function mcpArchiveBlockedReason(thread) {
 
 // src/mcp/server.ts
 init_profile();
+init_plan_present();
 
 // src/mcp/run-script-ref.ts
 init_chat_tabs();
@@ -29507,31 +29619,40 @@ async function startMcpServer() {
       return mcpJson(payload);
     }
   );
-  server.tool(
-    "present_plan",
-    "Save the implementation plan as markdown to .context/attachments/plan.md and show it in Sideboard chat for user approval (Copy / Hand off / Approve). Call this when the plan is ready \u2014 required in plan mode. Pass the full plan body in content. Then Claude should call ExitPlanMode.",
-    {
-      title: import_zod9.z.string().optional().describe("Short plan title (defaults to Plan)"),
-      content: import_zod9.z.string().min(1).describe("Full plan markdown (headings, steps, risks, open questions)"),
-      thread_id: import_zod9.z.string().optional().describe("Sideboard thread id when cwd is not the worktree")
-    },
-    async ({ title, content, thread_id }) => {
-      const { writePlanFile: writePlanFile2 } = await Promise.resolve().then(() => (init_plan_file(), plan_file_exports));
-      let root = process.cwd();
-      if (thread_id?.trim()) {
-        const t = orch.getThread(thread_id.trim());
+  const callingThreadId = process.env[SIDEBOARD_THREAD_ID_ENV]?.trim() || "";
+  const callingThread = callingThreadId ? orch.getThread(callingThreadId) : null;
+  if (shouldRegisterPresentPlan(callingThread)) {
+    server.tool(
+      "present_plan",
+      PRESENT_PLAN_TOOL_DESCRIPTION,
+      {
+        title: import_zod9.z.string().optional().describe("Short plan title (defaults to Plan)"),
+        content: import_zod9.z.string().min(1).describe("Full plan markdown (headings, steps, risks, open questions)"),
+        thread_id: import_zod9.z.string().optional().describe("Sideboard thread id when cwd is not the worktree")
+      },
+      async ({ title, content, thread_id }) => {
+        const { writePlanFile: writePlanFile2 } = await Promise.resolve().then(() => (init_plan_file(), plan_file_exports));
+        const ref = thread_id?.trim() || callingThreadId;
+        const t = ref ? orch.getThread(ref) : null;
+        if (t && !threadMayPresentPlan(t)) {
+          return mcpJson(
+            { ok: false, error: PRESENT_PLAN_REQUIRES_PLAN_MODE },
+            true
+          );
+        }
+        let root = process.cwd();
         if (t?.worktreePath?.trim()) root = t.worktreePath;
+        const path = writePlanFile2(root, content);
+        const payload = {
+          ok: true,
+          path,
+          title: title?.trim() || "Plan",
+          message: "Plan saved to .context/attachments/plan.md and shown in Sideboard chat for approval."
+        };
+        return mcpJson(payload);
       }
-      const path = writePlanFile2(root, content);
-      const payload = {
-        ok: true,
-        path,
-        title: title?.trim() || "Plan",
-        message: "Plan saved to .context/attachments/plan.md and shown in Sideboard chat for approval."
-      };
-      return mcpJson(payload);
-    }
-  );
+    );
+  }
   server.tool(
     "present_schema",
     "Open Sideboard\u2019s schema-driven side column (filterable table and/or form) when the user needs to filter, edit, publish, or persist records. Do not call this just to re-display rows you already wrote as a markdown table. If the user asks for an editable / interactive table, call this even if chat already showed those rows. Pass JSON Schema + optional schemaUi. Prefer datasource=inline with embedded resource/records. Use datasource=brightsy with resource_id only when the user is logged into Brightsy.",