@sideboard-ai/core 0.1.241 → 0.1.243

package/dist/index.cjs

@@ -1240,6 +1240,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;
@@ -3323,7 +3324,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) {
@@ -4415,6 +4417,16 @@ function skillToolFromTextPart(part, id) {
     updatedAt: Date.now()
   };
 }
+function compactSummaryPart(text7, id = "compact-summary") {
+  return compactToolPart(text7, id, { status: "done" });
+}
+function compactPartsForSummaryMessage(message) {
+  const existing = (message.parts ?? []).filter(
+    (p) => p.type === "tool" && isCompactToolName(p.name)
+  );
+  if (existing.length) return existing;
+  return [compactSummaryPart(message.text ?? "")];
+}
 function compactToolPart(text7, id, opts) {
   const input = { trigger: opts?.trigger ?? "auto" };
   return withPartTimes(
@@ -12360,6 +12372,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);
@@ -12906,6 +12922,9 @@ var init_orch_mcp_isolation = __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 {
@@ -12944,11 +12963,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.";
   }
 });
 
@@ -13461,7 +13481,8 @@ var init_claude = __esm({
             ...sideboardWorktreeAllowedTools({
               github: true,
               linear: isLinearConnected(),
-              abletime: isAbleTimeConnected()
+              abletime: isAbleTimeConnected(),
+              planMode: thread.planMode
             }),
             ...brightsyMcpAllowedTools(injectedBrightsyNames)
           ];
@@ -15879,6 +15900,7 @@ __export(agents_exports, {
   CURSOR_SDK_INSTALL_HINT: () => CURSOR_SDK_INSTALL_HINT,
   ORCHESTRATOR_AGENT_KINDS: () => ORCHESTRATOR_AGENT_KINDS,
   PLAN_MODE_INSTRUCTION: () => PLAN_MODE_INSTRUCTION,
+  PLAN_MODE_OFF_INSTRUCTION: () => PLAN_MODE_OFF_INSTRUCTION,
   allAdapters: () => allAdapters,
   assertOrchestratorCapableAgent: () => assertOrchestratorCapableAgent,
   brightsyAdapter: () => brightsyAdapter,
@@ -15929,6 +15951,7 @@ __export(agents_exports, {
   parseCursorRunnerLine: () => parseCursorRunnerLine,
   parseSessionQuotaResetAt: () => parseSessionQuotaResetAt,
   permissionMode: () => permissionMode,
+  planModeTurnInstruction: () => planModeTurnInstruction,
   posixShellSingleQuote: () => posixShellSingleQuote,
   preferredCursorCostCents: () => preferredCursorCostCents,
   prepareTerminalCommand: () => prepareTerminalCommand,
@@ -16911,12 +16934,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];
@@ -16944,6 +16993,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);
@@ -16951,6 +17001,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()
   };
@@ -16966,6 +17017,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();
@@ -17552,15 +17604,403 @@ var init_worktree_run_ports = __esm({
   }
 });
 
+// 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 sleep2 = 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."
+    });
+  }
+  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 sleep2(Math.min(2e3, Math.max(50, deadline - Date.now())));
+  }
+  snap = snapshotJob(dir);
+  return toResult(jobId, snap);
+}
+function killProcessTree(pid, signal) {
+  if (!Number.isInteger(pid) || pid <= 0) return;
+  if (process.platform !== "win32") {
+    try {
+      process.kill(-pid, signal);
+      return;
+    } catch {
+    }
+  }
+  try {
+    process.kill(pid, signal);
+  } catch {
+  }
+}
+function appendJobLog(logFile, line) {
+  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);
+  } catch {
+  }
+}
+async function stopDetachedJob(cwd, id, opts) {
+  const jobId = sanitizeDetachedJobId(id);
+  const root = cwd.trim() || process.cwd();
+  const dir = resolveJobDir(root, jobId);
+  const sleep2 = 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 sleep2(Math.min(100, Math.max(20, deadline - Date.now())));
+  }
+  if (targetPid != null) {
+    killProcessTree(targetPid, "SIGKILL");
+    await sleep2(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
+  };
+}
+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"() {
+    "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}$/;
+  }
+});
+
 // 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 path2 = (0, import_node_path45.join)(repoPath, ".worktreeinclude");
-  if (!(0, import_node_fs45.existsSync)(path2)) return [];
-  return (0, import_node_fs45.readFileSync)(path2, "utf8").split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+  const path2 = (0, import_node_path46.join)(repoPath, ".worktreeinclude");
+  if (!(0, import_node_fs46.existsSync)(path2)) return [];
+  return (0, import_node_fs46.readFileSync)(path2, "utf8").split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
 }
 function resolveFilesToCopy(repoPath) {
   const fromInclude = readWorktreeInclude(repoPath);
@@ -17570,10 +18010,10 @@ function resolveFilesToCopy(repoPath) {
   if (settings?.fileIncludeGlobs?.length) {
     const matched = [];
     try {
-      for (const entry of (0, import_node_fs45.readdirSync)(repoPath, { withFileTypes: true })) {
+      for (const entry of (0, import_node_fs46.readdirSync)(repoPath, { withFileTypes: true })) {
         if (!entry.isFile()) continue;
         for (const glob of settings.fileIncludeGlobs) {
-          if (matchSimpleGlob(glob, entry.name) || matchSimpleGlob((0, import_node_path45.basename)(glob), entry.name)) {
+          if (matchSimpleGlob(glob, entry.name) || matchSimpleGlob((0, import_node_path46.basename)(glob), entry.name)) {
             matched.push(entry.name);
             break;
           }
@@ -17585,7 +18025,7 @@ function resolveFilesToCopy(repoPath) {
   }
   const defaults = [];
   try {
-    for (const entry of (0, import_node_fs45.readdirSync)(repoPath, { withFileTypes: true })) {
+    for (const entry of (0, import_node_fs46.readdirSync)(repoPath, { withFileTypes: true })) {
       if (entry.isFile() && entry.name.startsWith(".env")) {
         defaults.push(entry.name);
       }
@@ -17599,11 +18039,11 @@ function copyConfiguredFiles(repoPath, worktreePath) {
   const patterns = resolveFilesToCopy(repoPath);
   const copied = [];
   for (const rel of patterns) {
-    const src = (0, import_node_path45.join)(repoPath, rel);
-    if (!(0, import_node_fs45.existsSync)(src)) continue;
-    const dest = (0, import_node_path45.join)(worktreePath, rel);
-    (0, import_node_fs45.mkdirSync)((0, import_node_path45.dirname)(dest), { recursive: true });
-    (0, import_node_fs45.copyFileSync)(src, dest);
+    const src = (0, import_node_path46.join)(repoPath, rel);
+    if (!(0, import_node_fs46.existsSync)(src)) continue;
+    const dest = (0, import_node_path46.join)(worktreePath, rel);
+    (0, import_node_fs46.mkdirSync)((0, import_node_path46.dirname)(dest), { recursive: true });
+    (0, import_node_fs46.copyFileSync)(src, dest);
     copied.push(rel);
   }
   return copied;
@@ -17638,7 +18078,7 @@ function buildWorkspaceScriptEnv(opts, baseEnv) {
   const env = stripNestedElectronEnv({
     ...baseEnv ?? process.env
   });
-  const name = opts.workspaceName ?? (0, import_node_path45.basename)(opts.worktreePath);
+  const name = opts.workspaceName ?? (0, import_node_path46.basename)(opts.worktreePath);
   const ports = opts.ports ?? [];
   const primary = ports[0];
   env.SIDEBOARD_WORKSPACE_NAME = name;
@@ -17707,20 +18147,20 @@ function listenerCwd(pid) {
 }
 function realpathOrResolve(path2) {
   try {
-    return (0, import_node_fs45.realpathSync)(path2);
+    return (0, import_node_fs46.realpathSync)(path2);
   } catch {
-    return (0, import_node_path45.resolve)(path2);
+    return (0, import_node_path46.resolve)(path2);
   }
 }
 function isOtherWorktreeListenerCwd(cwd, worktreePath) {
   const wt = realpathOrResolve(worktreePath);
   const c = realpathOrResolve(cwd);
-  if (c === wt || c.startsWith(wt + import_node_path45.sep)) return false;
-  const parent = (0, import_node_path45.dirname)(wt);
-  const thisName = (0, import_node_path45.basename)(wt);
+  if (c === wt || c.startsWith(wt + import_node_path46.sep)) return false;
+  const parent = (0, import_node_path46.dirname)(wt);
+  const thisName = (0, import_node_path46.basename)(wt);
   if (!thisName || c === parent) return false;
-  if (!c.startsWith(parent + import_node_path45.sep)) return false;
-  const first = c.slice(parent.length + 1).split(import_node_path45.sep)[0];
+  if (!c.startsWith(parent + import_node_path46.sep)) return false;
+  const first = c.slice(parent.length + 1).split(import_node_path46.sep)[0];
   return Boolean(first) && first !== thisName;
 }
 function signalPid(pid, signal) {
@@ -17729,6 +18169,25 @@ function signalPid(pid, signal) {
   } catch {
   }
 }
+function isThisWorktreeListenerCwd(cwd, worktreePath) {
+  const wt = realpathOrResolve(worktreePath);
+  const c = realpathOrResolve(cwd);
+  return c === wt || c.startsWith(wt + import_node_path46.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) {
@@ -18119,14 +18578,14 @@ async function startDevServer(repoPath, worktreePath, onLine, opts) {
     throw err;
   }
 }
-var import_node_fs45, import_node_child_process5, import_node_net, import_node_path45, import_execa4, import_node_readline3, PORT_RANGE_SIZE, RECLAIM_RETRY_DELAY_MS, RECLAIM_TRIES, cachedLoginEnv;
+var import_node_fs46, import_node_child_process5, import_node_net, import_node_path46, 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_fs45 = require("fs");
+    import_node_fs46 = require("fs");
     import_node_child_process5 = require("child_process");
     import_node_net = require("net");
-    import_node_path45 = require("path");
+    import_node_path46 = require("path");
     import_execa4 = require("execa");
     import_node_readline3 = require("readline");
     init_settings();
@@ -18138,6 +18597,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;
@@ -18158,9 +18618,9 @@ async function findOrphanWorktrees(repoPaths) {
     repoPaths?.length ? repoPaths : threads.map((t) => t.repoPath).filter(Boolean)
   );
   const homeRoot = sideboardWorkspacesDir();
-  if ((0, import_node_fs46.existsSync)(homeRoot)) {
+  if ((0, import_node_fs47.existsSync)(homeRoot)) {
     try {
-      for (const entry of (0, import_node_fs46.readdirSync)(homeRoot, { withFileTypes: true })) {
+      for (const entry of (0, import_node_fs47.readdirSync)(homeRoot, { withFileTypes: true })) {
         if (!entry.isDirectory()) continue;
         void entry;
       }
@@ -18170,7 +18630,7 @@ async function findOrphanWorktrees(repoPaths) {
   const orphans = [];
   const seen = /* @__PURE__ */ new Set();
   for (const repoPath of repos) {
-    if (!repoPath || !(0, import_node_fs46.existsSync)(repoPath)) continue;
+    if (!repoPath || !(0, import_node_fs47.existsSync)(repoPath)) continue;
     try {
       const wts = await listWorktrees(repoPath);
       for (const wt of wts) {
@@ -18181,7 +18641,7 @@ async function findOrphanWorktrees(repoPaths) {
         seen.add(path2);
         let mtimeMs = 0;
         try {
-          mtimeMs = (0, import_node_fs46.statSync)(path2).mtimeMs;
+          mtimeMs = (0, import_node_fs47.statSync)(path2).mtimeMs;
         } catch {
           mtimeMs = 0;
         }
@@ -18191,16 +18651,16 @@ async function findOrphanWorktrees(repoPaths) {
     }
     try {
       const root = worktreesRoot(repoPath);
-      if ((0, import_node_fs46.existsSync)(root)) {
-        for (const entry of (0, import_node_fs46.readdirSync)(root, { withFileTypes: true })) {
+      if ((0, import_node_fs47.existsSync)(root)) {
+        for (const entry of (0, import_node_fs47.readdirSync)(root, { withFileTypes: true })) {
           if (!entry.isDirectory()) continue;
-          const path2 = (0, import_node_path46.join)(root, entry.name).replace(/\/$/, "");
+          const path2 = (0, import_node_path47.join)(root, entry.name).replace(/\/$/, "");
           if (known.has(path2) || seen.has(path2)) continue;
-          if (!(0, import_node_fs46.existsSync)((0, import_node_path46.join)(path2, ".git"))) continue;
+          if (!(0, import_node_fs47.existsSync)((0, import_node_path47.join)(path2, ".git"))) continue;
           seen.add(path2);
           let mtimeMs = 0;
           try {
-            mtimeMs = (0, import_node_fs46.statSync)(path2).mtimeMs;
+            mtimeMs = (0, import_node_fs47.statSync)(path2).mtimeMs;
           } catch {
             mtimeMs = Date.now();
           }
@@ -18261,12 +18721,12 @@ function worktreeCleanupSettings() {
     autoCleanupOrphans: a.autoCleanupOrphans
   };
 }
-var import_node_fs46, import_node_path46;
+var import_node_fs47, import_node_path47;
 var init_orphan_cleanup = __esm({
   "src/git/orphan-cleanup.ts"() {
     "use strict";
-    import_node_fs46 = require("fs");
-    import_node_path46 = require("path");
+    import_node_fs47 = require("fs");
+    import_node_path47 = require("path");
     init_worktree();
     init_thread_store();
     init_paths();
@@ -18282,6 +18742,7 @@ function stripArchivedTranscript(thread) {
       attachments: [],
       pendingTurnAttachments: [],
       queueAttachments: [],
+      compactedMessages: void 0,
       messages: [historyRetentionStubMessage(thread)]
     },
     { touch: false }
@@ -18441,12 +18902,12 @@ async function cloneRepoIntoSideboard(opts) {
   if (!url) throw new Error("Clone URL is required");
   let name = opts.name?.trim();
   if (!name) {
-    const leaf = (0, import_node_path47.basename)(url.replace(/\/$/, "").replace(/\.git$/, ""));
+    const leaf = (0, import_node_path48.basename)(url.replace(/\/$/, "").replace(/\.git$/, ""));
     name = leaf || "repo";
   }
   name = name.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
-  const dest = (0, import_node_path47.join)(sideboardReposDir(), name);
-  if ((0, import_node_fs47.existsSync)(dest)) {
+  const dest = (0, import_node_path48.join)(sideboardReposDir(), name);
+  if ((0, import_node_fs48.existsSync)(dest)) {
     const repoPath2 = await resolveRepoRoot(dest);
     const workspace2 = await ensureWorkspace(repoPath2);
     return { repoPath: repoPath2, workspace: workspace2 };
@@ -18461,12 +18922,12 @@ async function cloneRepoIntoSideboard(opts) {
   const workspace = await ensureWorkspace(repoPath);
   return { repoPath, workspace };
 }
-var import_node_fs47, import_node_path47, import_execa6;
+var import_node_fs48, import_node_path48, import_execa6;
 var init_clone_repo = __esm({
   "src/git/clone-repo.ts"() {
     "use strict";
-    import_node_fs47 = require("fs");
-    import_node_path47 = require("path");
+    import_node_fs48 = require("fs");
+    import_node_path48 = require("path");
     import_execa6 = require("execa");
     init_paths();
     init_workspaces();
@@ -18524,394 +18985,6 @@ var init_child_halt = __esm({
   }
 });
 
-// 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_fs48.existsSync)(file)) return null;
-  const n = Number.parseInt((0, import_node_fs48.readFileSync)(file, "utf8").trim(), 10);
-  return Number.isInteger(n) ? n : null;
-}
-function jobDir(root, id, legacy = false) {
-  return (0, import_node_path48.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_fs48.existsSync)(modern)) return modern;
-  const legacy = jobDir(root, id, true);
-  if ((0, import_node_fs48.existsSync)(legacy)) return legacy;
-  return modern;
-}
-function listJobIdsIn(root, rel) {
-  const dir = (0, import_node_path48.join)(root, rel);
-  if (!(0, import_node_fs48.existsSync)(dir)) return [];
-  return (0, import_node_fs48.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_path48.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_fs48.existsSync)(logFile)) return "(no log yet)";
-  const lines = (0, import_node_fs48.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_fs48.existsSync)(file)) return [];
-  const lines = (0, import_node_fs48.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_path48.join)(dir, "pid"));
-  const running = jobTreeAlive(pid);
-  return {
-    pid,
-    running,
-    exitCode: readIntFile((0, import_node_path48.join)(dir, "exit")),
-    log: (0, import_node_path48.join)(dir, "log"),
-    cursor: (0, import_node_path48.join)(dir, "present.cursor"),
-    progress: tailProgress((0, import_node_path48.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_fs48.mkdirSync)((0, import_node_path48.dirname)(snap.cursor), { recursive: true });
-    (0, import_node_fs48.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 sleep2 = opts?.sleep ?? sleepMs;
-  if (!(0, import_node_fs48.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 sleep2(Math.min(2e3, Math.max(50, deadline - Date.now())));
-  }
-  snap = snapshotJob(dir);
-  return toResult(jobId, snap);
-}
-function killProcessTree(pid, signal) {
-  if (!Number.isInteger(pid) || pid <= 0) return;
-  if (process.platform !== "win32") {
-    try {
-      process.kill(-pid, signal);
-      return;
-    } catch {
-    }
-  }
-  try {
-    process.kill(pid, signal);
-  } catch {
-  }
-}
-function appendJobLog(logFile, line) {
-  try {
-    (0, import_node_fs48.mkdirSync)((0, import_node_path48.dirname)(logFile), { recursive: true });
-    const body = line.endsWith("\n") ? line : `${line}
-`;
-    (0, import_node_fs48.appendFileSync)(logFile, body);
-  } catch {
-  }
-}
-async function stopDetachedJob(cwd, id, opts) {
-  const jobId = sanitizeDetachedJobId(id);
-  const root = cwd.trim() || process.cwd();
-  const dir = resolveJobDir(root, jobId);
-  const sleep2 = opts?.sleep ?? sleepMs;
-  const why = opts?.reason?.trim() ?? "";
-  if (!(0, import_node_fs48.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 sleep2(Math.min(100, Math.max(20, deadline - Date.now())));
-  }
-  if (targetPid != null) {
-    killProcessTree(targetPid, "SIGKILL");
-    await sleep2(100);
-  }
-  const exitFile = (0, import_node_path48.join)(dir, "exit");
-  if (!(0, import_node_fs48.existsSync)(exitFile)) {
-    try {
-      (0, import_node_fs48.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
-  };
-}
-var import_node_fs48, import_node_path48, 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_fs48 = require("fs");
-    import_node_path48 = 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/detect/detect.ts
 async function detectAgents() {
   ensureAgentPath();
@@ -23694,6 +23767,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--) {
@@ -23731,7 +23811,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";
@@ -23739,6 +23819,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.";
   }
 });
 
@@ -23748,11 +23830,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) {
@@ -24888,7 +24974,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",
@@ -24902,9 +24989,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);
@@ -24921,6 +25005,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(
@@ -24979,7 +25071,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,
@@ -25482,6 +25574,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,
@@ -25554,7 +25649,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),
@@ -25700,6 +25796,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);
@@ -25721,6 +25820,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);
@@ -25762,6 +25866,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]);
@@ -26896,8 +27005,11 @@ __export(index_exports, {
   PLAN_FILE_NAME: () => PLAN_FILE_NAME,
   PLAN_FILE_REL: () => PLAN_FILE_REL,
   PLAN_MODE_INSTRUCTION: () => PLAN_MODE_INSTRUCTION,
+  PLAN_MODE_OFF_INSTRUCTION: () => PLAN_MODE_OFF_INSTRUCTION,
   PLAN_QUESTION_ANSWERS_PREFIX: () => PLAN_QUESTION_ANSWERS_PREFIX,
   PORT_RANGE_SIZE: () => PORT_RANGE_SIZE,
+  PRESENT_PLAN_REQUIRES_PLAN_MODE: () => PRESENT_PLAN_REQUIRES_PLAN_MODE,
+  PRESENT_PLAN_TOOL_DESCRIPTION: () => PRESENT_PLAN_TOOL_DESCRIPTION,
   PROFILE_NOTES_MAX: () => PROFILE_NOTES_MAX,
   PR_DETAILS_JSON_FIELDS: () => PR_DETAILS_JSON_FIELDS,
   REPO_REVIEW_NAME: () => REPO_REVIEW_NAME,
@@ -26968,6 +27080,7 @@ __export(index_exports, {
   annotateDevAccessRuns: () => annotateDevAccessRuns,
   appDataDir: () => appDataDir,
   appSettingsPath: () => appSettingsPath,
+  appendCompactedMessages: () => appendCompactedMessages,
   appendIndexedGitConfig: () => appendIndexedGitConfig,
   appendMessage: () => appendMessage,
   appendQueuedItem: () => appendQueuedItem,
@@ -27055,6 +27168,9 @@ __export(index_exports, {
   commentGitHubIssue: () => commentGitHubIssue,
   commentLinearIssue: () => commentLinearIssue,
   commitAll: () => commitAll,
+  compactArchiveProse: () => compactArchiveProse,
+  compactPartsForSummaryMessage: () => compactPartsForSummaryMessage,
+  compactSummaryPart: () => compactSummaryPart,
   computeNextRunAt: () => computeNextRunAt,
   conductorBundledBinDir: () => conductorBundledBinDir,
   conductorDbPath: () => conductorDbPath,
@@ -27361,6 +27477,7 @@ __export(index_exports, {
   isTerminalTaskState: () => isTerminalTaskState,
   isThinkingEffort: () => isThinkingEffort,
   isThisProcessDesktopHost: () => isThisProcessDesktopHost,
+  isThisWorktreeListenerCwd: () => isThisWorktreeListenerCwd,
   isThreadCaffeinated: () => isThreadCaffeinated,
   isThreadRecordFile: () => isThreadRecordFile,
   isUnclaimedRunScriptRequest: () => isUnclaimedRunScriptRequest,
@@ -27370,6 +27487,7 @@ __export(index_exports, {
   issueMatchesAssignee: () => issueMatchesAssignee,
   issueSourceLabel: () => issueSourceLabel,
   issueTicketFromThread: () => issueTicketFromThread,
+  killDetachedRunTree: () => killDetachedRunTree,
   killListenersOnPorts: () => killListenersOnPorts,
   killStaleWorktreeListeners: () => killStaleWorktreeListeners,
   killableListenerPids: () => killableListenerPids,
@@ -27452,6 +27570,7 @@ __export(index_exports, {
   mergeSideboardIntoMcpServersJson: () => mergeSideboardIntoMcpServersJson,
   mergeUsage: () => mergeUsage,
   messagePartParentId: () => messagePartParentId,
+  messagesForCompactArchive: () => messagesForCompactArchive,
   messagesSinceLastBrightsyContextSummary: () => messagesSinceLastBrightsyContextSummary,
   moveQueuedItemToFront: () => moveQueuedItemToFront,
   needsCoordinatorAction: () => needsCoordinatorAction,
@@ -27511,6 +27630,7 @@ __export(index_exports, {
   planFileAbs: () => planFileAbs,
   planHistoryAgePurge: () => planHistoryAgePurge,
   planHistoryRetention: () => planHistoryRetention,
+  planModeTurnInstruction: () => planModeTurnInstruction,
   planQuestionsSignature: () => planQuestionsSignature,
   pnpmFilterPackage: () => pnpmFilterPackage,
   pollSlackOutboundWatches: () => pollSlackOutboundWatches,
@@ -27638,6 +27758,7 @@ __export(index_exports, {
   shouldInjectBrightsyMcp: () => shouldInjectBrightsyMcp,
   shouldNotifyOrchestrator: () => shouldNotifyOrchestrator,
   shouldRefreshReviewRequestTemplate: () => shouldRefreshReviewRequestTemplate,
+  shouldRegisterPresentPlan: () => shouldRegisterPresentPlan,
   shouldRemoveWorktreeOnTeardown: () => shouldRemoveWorktreeOnTeardown,
   shouldResetSessionForOccupancy: () => shouldResetSessionForOccupancy,
   shouldRunHistoryCleanup: () => shouldRunHistoryCleanup,
@@ -27699,6 +27820,7 @@ __export(index_exports, {
   threadHasCompactedContext: () => threadHasCompactedContext,
   threadLivePath: () => threadLivePath,
   threadLockPath: () => threadLockPath,
+  threadMayPresentPlan: () => threadMayPresentPlan,
   threadRequestsBrightsyMcp: () => threadRequestsBrightsyMcp,
   threadsDir: () => threadsDir,
   threadsSharingWorktree: () => threadsSharingWorktree,
@@ -27872,7 +27994,8 @@ function slimThreadForUiList(thread) {
     attachments: [],
     pendingTurnAttachments: [],
     queueAttachments: [],
-    messages: slimMessagesForUiList(messages, thread.updatedAt)
+    messages: slimMessagesForUiList(messages, thread.updatedAt),
+    compactedMessages: void 0
   };
 }
 function slimMessagesForUiList(messages, fallbackTs) {
@@ -30426,6 +30549,7 @@ function mcpArchiveBlockedReason(thread) {
 
 // src/mcp/server.ts
 init_profile();
+init_plan_present();
 
 // src/mcp/run-script-ref.ts
 init_chat_tabs();
@@ -33338,31 +33462,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 path2 = writePlanFile2(root, content);
+        const payload = {
+          ok: true,
+          path: path2,
+          title: title?.trim() || "Plan",
+          message: "Plan saved to .context/attachments/plan.md and shown in Sideboard chat for approval."
+        };
+        return mcpJson(payload);
       }
-      const path2 = writePlanFile2(root, content);
-      const payload = {
-        ok: true,
-        path: path2,
-        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.",
@@ -36699,8 +36832,11 @@ async function startSlackRelayServer(opts) {
   PLAN_FILE_NAME,
   PLAN_FILE_REL,
   PLAN_MODE_INSTRUCTION,
+  PLAN_MODE_OFF_INSTRUCTION,
   PLAN_QUESTION_ANSWERS_PREFIX,
   PORT_RANGE_SIZE,
+  PRESENT_PLAN_REQUIRES_PLAN_MODE,
+  PRESENT_PLAN_TOOL_DESCRIPTION,
   PROFILE_NOTES_MAX,
   PR_DETAILS_JSON_FIELDS,
   REPO_REVIEW_NAME,
@@ -36771,6 +36907,7 @@ async function startSlackRelayServer(opts) {
   annotateDevAccessRuns,
   appDataDir,
   appSettingsPath,
+  appendCompactedMessages,
   appendIndexedGitConfig,
   appendMessage,
   appendQueuedItem,
@@ -36858,6 +36995,9 @@ async function startSlackRelayServer(opts) {
   commentGitHubIssue,
   commentLinearIssue,
   commitAll,
+  compactArchiveProse,
+  compactPartsForSummaryMessage,
+  compactSummaryPart,
   computeNextRunAt,
   conductorBundledBinDir,
   conductorDbPath,
@@ -37164,6 +37304,7 @@ async function startSlackRelayServer(opts) {
   isTerminalTaskState,
   isThinkingEffort,
   isThisProcessDesktopHost,
+  isThisWorktreeListenerCwd,
   isThreadCaffeinated,
   isThreadRecordFile,
   isUnclaimedRunScriptRequest,
@@ -37173,6 +37314,7 @@ async function startSlackRelayServer(opts) {
   issueMatchesAssignee,
   issueSourceLabel,
   issueTicketFromThread,
+  killDetachedRunTree,
   killListenersOnPorts,
   killStaleWorktreeListeners,
   killableListenerPids,
@@ -37255,6 +37397,7 @@ async function startSlackRelayServer(opts) {
   mergeSideboardIntoMcpServersJson,
   mergeUsage,
   messagePartParentId,
+  messagesForCompactArchive,
   messagesSinceLastBrightsyContextSummary,
   moveQueuedItemToFront,
   needsCoordinatorAction,
@@ -37314,6 +37457,7 @@ async function startSlackRelayServer(opts) {
   planFileAbs,
   planHistoryAgePurge,
   planHistoryRetention,
+  planModeTurnInstruction,
   planQuestionsSignature,
   pnpmFilterPackage,
   pollSlackOutboundWatches,
@@ -37441,6 +37585,7 @@ async function startSlackRelayServer(opts) {
   shouldInjectBrightsyMcp,
   shouldNotifyOrchestrator,
   shouldRefreshReviewRequestTemplate,
+  shouldRegisterPresentPlan,
   shouldRemoveWorktreeOnTeardown,
   shouldResetSessionForOccupancy,
   shouldRunHistoryCleanup,
@@ -37502,6 +37647,7 @@ async function startSlackRelayServer(opts) {
   threadHasCompactedContext,
   threadLivePath,
   threadLockPath,
+  threadMayPresentPlan,
   threadRequestsBrightsyMcp,
   threadsDir,
   threadsSharingWorktree,