@adhdev/daemon-core 0.9.76-rc.6 → 0.9.76-rc.60

package/dist/index.js

@@ -41,11 +41,140 @@ var init_repo_mesh_types = __esm({
       requireApprovalForPush: true,
       requireApprovalForDestructiveGit: true,
       dirtyWorkspaceBehavior: "warn",
-      maxParallelTasks: 2
+      maxParallelTasks: 2,
+      sessionCleanupOnNodeRemove: "preserve"
     };
   }
 });
 
+// src/git/git-worktree.ts
+var git_worktree_exports = {};
+__export(git_worktree_exports, {
+  createWorktree: () => createWorktree,
+  listWorktrees: () => listWorktrees,
+  parseWorktreeListOutput: () => parseWorktreeListOutput,
+  removeWorktree: () => removeWorktree,
+  resolveWorktreePath: () => resolveWorktreePath
+});
+function resolveWorktreePath(repoRoot, meshName, branch) {
+  const safeBranch = branch.replace(/[/\\:*?"<>|]/g, "-").replace(/^\.+|\.+$/g, "");
+  const safeMeshName = meshName.replace(/[/\\:*?"<>|]/g, "-").replace(/^\.+|\.+$/g, "");
+  const parentDir = path4.dirname(repoRoot);
+  return path4.join(parentDir, WORKTREE_DIR_NAME, safeMeshName, safeBranch);
+}
+async function createWorktree(opts) {
+  const { repoRoot, branch, baseBranch, meshName } = opts;
+  const targetDir = opts.targetDir || resolveWorktreePath(repoRoot, meshName, branch);
+  if ((0, import_node_fs2.existsSync)(targetDir)) {
+    throw new Error(`Worktree target directory already exists: ${targetDir}`);
+  }
+  await (0, import_promises3.mkdir)(path4.dirname(targetDir), { recursive: true });
+  const args = ["worktree", "add", targetDir, "-b", branch];
+  if (baseBranch) {
+    args.push(baseBranch);
+  }
+  try {
+    await execFileAsync2("git", args, {
+      cwd: repoRoot,
+      encoding: "utf8",
+      timeout: GIT_TIMEOUT_MS,
+      maxBuffer: GIT_MAX_BUFFER,
+      windowsHide: true
+    });
+  } catch (error) {
+    const stderr = typeof error.stderr === "string" ? error.stderr : "";
+    if (/already exists/i.test(stderr)) {
+      throw new Error(`Branch '${branch}' already exists or is checked out in another worktree`);
+    }
+    throw new Error(`git worktree add failed: ${stderr.trim() || error.message}`);
+  }
+  return {
+    success: true,
+    worktreePath: targetDir,
+    branch
+  };
+}
+async function removeWorktree(repoRoot, worktreePath) {
+  if (!(0, import_node_fs2.existsSync)(worktreePath)) {
+    await pruneWorktrees(repoRoot);
+    return { success: true, removedPath: worktreePath };
+  }
+  try {
+    await execFileAsync2("git", ["worktree", "remove", worktreePath, "--force"], {
+      cwd: repoRoot,
+      encoding: "utf8",
+      timeout: GIT_TIMEOUT_MS,
+      maxBuffer: GIT_MAX_BUFFER,
+      windowsHide: true
+    });
+  } catch (error) {
+    const stderr = typeof error.stderr === "string" ? error.stderr : "";
+    throw new Error(`git worktree remove failed: ${stderr.trim() || error.message}`);
+  }
+  return { success: true, removedPath: worktreePath };
+}
+async function listWorktrees(repoRoot) {
+  const { stdout } = await execFileAsync2("git", ["worktree", "list", "--porcelain"], {
+    cwd: repoRoot,
+    encoding: "utf8",
+    timeout: GIT_TIMEOUT_MS,
+    maxBuffer: GIT_MAX_BUFFER,
+    windowsHide: true
+  });
+  return parseWorktreeListOutput(stdout);
+}
+function parseWorktreeListOutput(output) {
+  const entries = [];
+  const blocks = output.trim().split(/\n\n+/);
+  for (const block of blocks) {
+    if (!block.trim()) continue;
+    const lines = block.trim().split("\n");
+    const entry = { path: "", head: "", branch: null, bare: false };
+    for (const line of lines) {
+      if (line.startsWith("worktree ")) {
+        entry.path = line.slice("worktree ".length).trim();
+      } else if (line.startsWith("HEAD ")) {
+        entry.head = line.slice("HEAD ".length).trim();
+      } else if (line.startsWith("branch ")) {
+        const ref = line.slice("branch ".length).trim();
+        entry.branch = ref.replace(/^refs\/heads\//, "");
+      } else if (line === "bare") {
+        entry.bare = true;
+      }
+    }
+    if (entry.path) {
+      entries.push(entry);
+    }
+  }
+  return entries;
+}
+async function pruneWorktrees(repoRoot) {
+  try {
+    await execFileAsync2("git", ["worktree", "prune"], {
+      cwd: repoRoot,
+      encoding: "utf8",
+      timeout: GIT_TIMEOUT_MS,
+      windowsHide: true
+    });
+  } catch {
+  }
+}
+var path4, import_promises3, import_node_fs2, import_node_child_process2, import_node_util2, execFileAsync2, WORKTREE_DIR_NAME, GIT_TIMEOUT_MS, GIT_MAX_BUFFER;
+var init_git_worktree = __esm({
+  "src/git/git-worktree.ts"() {
+    "use strict";
+    path4 = __toESM(require("path"));
+    import_promises3 = require("fs/promises");
+    import_node_fs2 = require("fs");
+    import_node_child_process2 = require("child_process");
+    import_node_util2 = require("util");
+    execFileAsync2 = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
+    WORKTREE_DIR_NAME = ".adhdev-worktrees";
+    GIT_TIMEOUT_MS = 3e4;
+    GIT_MAX_BUFFER = 4 * 1024 * 1024;
+  }
+});
+
 // src/config/config.ts
 var config_exports = {};
 __export(config_exports, {
@@ -304,10 +433,10 @@ function getMeshConfigPath() {
   return (0, import_path2.join)(getConfigDir(), "meshes.json");
 }
 function loadMeshConfig() {
-  const path26 = getMeshConfigPath();
-  if (!(0, import_fs2.existsSync)(path26)) return { meshes: [] };
+  const path27 = getMeshConfigPath();
+  if (!(0, import_fs2.existsSync)(path27)) return { meshes: [] };
   try {
-    const raw = JSON.parse((0, import_fs2.readFileSync)(path26, "utf-8"));
+    const raw = JSON.parse((0, import_fs2.readFileSync)(path27, "utf-8"));
     if (!raw || !Array.isArray(raw.meshes)) return { meshes: [] };
     return raw;
   } catch {
@@ -315,16 +444,16 @@ function loadMeshConfig() {
   }
 }
 function saveMeshConfig(config) {
-  const path26 = getMeshConfigPath();
-  (0, import_fs2.writeFileSync)(path26, JSON.stringify(config, null, 2), { encoding: "utf-8", mode: 384 });
+  const path27 = getMeshConfigPath();
+  (0, import_fs2.writeFileSync)(path27, JSON.stringify(config, null, 2), { encoding: "utf-8", mode: 384 });
 }
 function normalizeRepoIdentity(remoteUrl) {
   let identity = remoteUrl.trim();
   if (identity.startsWith("http://") || identity.startsWith("https://")) {
     try {
       const url = new URL(identity);
-      const path26 = url.pathname.replace(/^\//, "").replace(/\.git$/, "");
-      return `${url.hostname}/${path26}`;
+      const path27 = url.pathname.replace(/^\//, "").replace(/\.git$/, "");
+      return `${url.hostname}/${path27}`;
     } catch {
     }
   }
@@ -332,6 +461,18 @@ function normalizeRepoIdentity(remoteUrl) {
   if (sshMatch) return `${sshMatch[1]}/${sshMatch[2]}`;
   return identity;
 }
+function mergeMeshPolicy(base, patch) {
+  const policy = { ...DEFAULT_MESH_POLICY, ...base || {}, ...patch || {} };
+  if (!["block", "warn", "checkpoint_then_continue"].includes(policy.dirtyWorkspaceBehavior)) {
+    policy.dirtyWorkspaceBehavior = "warn";
+  }
+  const maxParallelTasks = Number(policy.maxParallelTasks);
+  policy.maxParallelTasks = Number.isFinite(maxParallelTasks) ? Math.max(1, Math.min(8, Math.floor(maxParallelTasks))) : 2;
+  if (!SESSION_CLEANUP_MODES.has(String(policy.sessionCleanupOnNodeRemove))) {
+    policy.sessionCleanupOnNodeRemove = "preserve";
+  }
+  return policy;
+}
 function listMeshes() {
   return loadMeshConfig().meshes;
 }
@@ -355,7 +496,7 @@ function createMesh(opts) {
     repoIdentity,
     repoRemoteUrl: opts.repoRemoteUrl,
     defaultBranch: opts.defaultBranch,
-    policy: { ...DEFAULT_MESH_POLICY, ...opts.policy },
+    policy: mergeMeshPolicy(void 0, opts.policy),
     coordinator: opts.coordinator || {},
     nodes: [],
     createdAt: now,
@@ -371,7 +512,7 @@ function updateMesh(meshId, opts) {
   if (!mesh) return void 0;
   if (opts.name !== void 0) mesh.name = opts.name.trim().slice(0, 100);
   if (opts.defaultBranch !== void 0) mesh.defaultBranch = opts.defaultBranch;
-  if (opts.policy) mesh.policy = { ...mesh.policy, ...opts.policy };
+  if (opts.policy) mesh.policy = mergeMeshPolicy(mesh.policy, opts.policy);
   if (opts.coordinator) mesh.coordinator = opts.coordinator;
   mesh.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   saveMeshConfig(config);
@@ -399,9 +540,12 @@ function addNode(meshId, opts) {
     id: `node_${(0, import_crypto3.randomUUID)().replace(/-/g, "")}`,
     workspace: opts.workspace.trim(),
     repoRoot: opts.repoRoot,
+    daemonId: opts.daemonId,
     userOverrides: opts.userOverrides || {},
     policy: opts.policy || {},
-    isLocalWorktree: opts.isLocalWorktree
+    isLocalWorktree: opts.isLocalWorktree,
+    worktreeBranch: opts.worktreeBranch,
+    clonedFromNodeId: opts.clonedFromNodeId
   };
   mesh.nodes.push(node);
   mesh.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -431,7 +575,7 @@ function updateNode(meshId, nodeId, opts) {
   saveMeshConfig(config);
   return node;
 }
-var import_fs2, import_path2, import_crypto3;
+var import_fs2, import_path2, import_crypto3, SESSION_CLEANUP_MODES;
 var init_mesh_config = __esm({
   "src/config/mesh-config.ts"() {
     "use strict";
@@ -440,6 +584,7 @@ var init_mesh_config = __esm({
     import_crypto3 = require("crypto");
     init_config();
     init_repo_mesh_types();
+    SESSION_CLEANUP_MODES = /* @__PURE__ */ new Set(["preserve", "stop", "delete_stopped", "stop_and_delete"]);
   }
 });
 
@@ -449,7 +594,7 @@ __export(coordinator_prompt_exports, {
   buildCoordinatorSystemPrompt: () => buildCoordinatorSystemPrompt
 });
 function buildCoordinatorSystemPrompt(ctx) {
-  const { mesh, status, userInstruction } = ctx;
+  const { mesh, status, userInstruction, coordinatorCliType } = ctx;
   const sections = [];
   sections.push(`You are a **Repo Mesh Coordinator** \u2014 a technical team lead who orchestrates work across multiple agent sessions on a shared Git repository.
 
@@ -463,15 +608,15 @@ Default branch: \`${mesh.defaultBranch}\`` : ""}`);
   } else {
     sections.push("## Nodes\nNo nodes configured yet. Ask the user to add nodes with `adhdev mesh add-node`.");
   }
-  sections.push(buildPolicySection(mesh.policy));
+  sections.push(buildPolicySection({ ...DEFAULT_MESH_POLICY, ...mesh.policy || {} }));
   sections.push(TOOLS_SECTION);
   sections.push(WORKFLOW_SECTION);
-  sections.push(RULES_SECTION);
+  sections.push(buildRulesSection(coordinatorCliType));
   if (userInstruction) {
     sections.push(`## Additional Context
 ${userInstruction}`);
   }
-  if (mesh.coordinator.systemPromptSuffix) {
+  if (mesh.coordinator?.systemPromptSuffix) {
     sections.push(mesh.coordinator.systemPromptSuffix);
   }
   return sections.join("\n\n");
@@ -516,10 +661,29 @@ function buildPolicySection(policy) {
   return `## Policy
 ${rules.join("\n")}`;
 }
-var TOOLS_SECTION, WORKFLOW_SECTION, RULES_SECTION;
+function buildRulesSection(coordinatorCliType) {
+  const coordinatorNote = coordinatorCliType ? `
+- **Coordinator runtime is not a delegation default.** This coordinator is running as \`${coordinatorCliType}\`, but delegated node sessions must follow the user's requested provider, not the coordinator's own runtime.` : "";
+  return `## Rules
+
+- **Minimize coordinator context.** The coordinator's job is routing, not implementing. Do not read source files, run commands, or analyze code directly \u2014 delegate all of that to node agents. Your context should stay lean.
+- **Delegate analysis too.** If you need to understand a bug or explore the codebase, send that investigation as a task to a node. Do not do it yourself.
+- **Respect explicit provider requests.** If the user names an agent/provider, pass the matching provider type to \`mesh_launch_session\`: Hermes \u2192 \`hermes-cli\`, Claude Code/Claude \u2192 \`claude-cli\`, Codex \u2192 \`codex-cli\`, Gemini \u2192 \`gemini-cli\`. Never substitute \`claude-cli\` just because the coordinator itself is Claude Code.
+- **Front-load the task message.** When calling \`mesh_send_task\`, include everything the agent needs: what files to touch, what the problem is, what the fix should look like. The agent won't ask follow-up questions.
+- **Don't inspect code.** Treat delegated agent summaries as self-reports, not verification. Verify side effects via \`mesh_git_status\` (including related repo freshness when configured), not by reading source files.
+- **Don't over-parallelize.** Start with 1-2 concurrent tasks. Scale up if they succeed. Never launch a duplicate session or second worker solely because \`mesh_read_chat\` has no final assistant message while the delegated session is still showing tool/terminal activity.
+- **Handle failures gracefully.** If a task fails, read the chat to understand why, then retry or reassign.
+- **Keep the user informed.** Report progress after each delegation round \u2014 one or two sentences, not a narration.
+- **Respect node capabilities.** Don't send build tasks to read-only nodes. Don't push from nodes that aren't allowed to.
+- **Never fabricate tool results.** Always call the actual tool; never pretend you did.
+- **Clean up worktree nodes.** After a worktree task completes and its changes are merged or checkpointed, call \`mesh_remove_node\` to free resources.
+- **Name worktree branches meaningfully.** Use descriptive names like \`feat/auth-refactor\` or \`fix/build-123\`.${coordinatorNote}`;
+}
+var TOOLS_SECTION, WORKFLOW_SECTION;
 var init_coordinator_prompt = __esm({
   "src/mesh/coordinator-prompt.ts"() {
     "use strict";
+    init_repo_mesh_types();
     TOOLS_SECTION = `## Available Tools
 
 | Tool | Purpose |
@@ -531,30 +695,23 @@ var init_coordinator_prompt = __esm({
 | \`mesh_read_chat\` | Read an agent's recent messages to check progress |
 | \`mesh_git_status\` | Check git status on a specific node |
 | \`mesh_checkpoint\` | Create a git checkpoint on a node |
-| \`mesh_approve\` | Approve/reject a pending agent action |`;
+| \`mesh_approve\` | Approve/reject a pending agent action |
+| \`mesh_clone_node\` | Create a worktree node for isolated parallel branch work |
+| \`mesh_remove_node\` | Remove a node (cleans up worktree if applicable) |`;
     WORKFLOW_SECTION = `## Orchestration Workflow
 
 1. **Assess** \u2014 Call \`mesh_status\` to see which nodes are healthy and available.
 2. **Plan** \u2014 Decompose the user's request into independent tasks for parallel execution, or sequential tasks when dependencies exist.
 3. **Delegate** \u2014 For each task:
    a. Pick the best node (consider: health, dirty state, current workload).
-   b. If no session exists, call \`mesh_launch_session\` to start one.
-   c. Call \`mesh_send_task\` with a **complete, self-contained** instruction that includes all context the agent needs (file paths, line numbers, what to change, why). Do not send partial instructions expecting future follow-up.
-4. **Monitor** \u2014 Periodically call \`mesh_read_chat\` to check progress. Handle approvals via \`mesh_approve\`.
-5. **Verify** \u2014 When a task reports completion, call \`mesh_git_status\` to verify changes were made.
+   b. If you need branch isolation for parallel work, call \`mesh_clone_node\` to create a worktree node first.
+   c. If no session exists, call \`mesh_launch_session\` to start one.
+   d. Call \`mesh_send_task\` with a **complete, self-contained** instruction that includes all context the agent needs (file paths, line numbers, what to change, why). Do not send partial instructions expecting future follow-up.
+4. **Monitor** \u2014 Prefer event-driven completion/status notifications. Do **not** poll \`mesh_read_chat\` repeatedly just because the delegated session has not produced a final assistant message yet; tool/terminal activity means work may still be in progress. Do not call \`mesh_read_chat\` again within a few seconds for the same generating session; wait for the completion callback/status event instead unless you are debugging a real stall. Use at most one compact \`mesh_read_chat\` check after a completion/approval signal, an explicit user status request, or a real timeout/stall. Handle approvals via \`mesh_approve\`.
+5. **Verify** \u2014 When a task reports completion or git work is visible, call \`mesh_git_status\` to verify changes were made.
 6. **Checkpoint** \u2014 Call \`mesh_checkpoint\` to save the work.
-7. **Report** \u2014 Summarize what was done, what changed, and any issues.`;
-    RULES_SECTION = `## Rules
-
-- **Minimize coordinator context.** The coordinator's job is routing, not implementing. Do not read source files, run commands, or analyze code directly \u2014 delegate all of that to node agents. Your context should stay lean.
-- **Delegate analysis too.** If you need to understand a bug or explore the codebase, send that investigation as a task to a node. Do not do it yourself.
-- **Front-load the task message.** When calling \`mesh_send_task\`, include everything the agent needs: what files to touch, what the problem is, what the fix should look like. The agent won't ask follow-up questions.
-- **Don't inspect code.** Trust the agent's output. Verify via \`mesh_git_status\`, not by reading source files.
-- **Don't over-parallelize.** Start with 1-2 concurrent tasks. Scale up if they succeed.
-- **Handle failures gracefully.** If a task fails, read the chat to understand why, then retry or reassign.
-- **Keep the user informed.** Report progress after each delegation round \u2014 one or two sentences, not a narration.
-- **Respect node capabilities.** Don't send build tasks to read-only nodes. Don't push from nodes that aren't allowed to.
-- **Never fabricate tool results.** Always call the actual tool; never pretend you did.`;
+7. **Clean up** \u2014 Remove worktree nodes via \`mesh_remove_node\` after their work is merged or no longer needed.
+8. **Report** \u2014 Summarize what was done, what changed, and any issues.`;
   }
 });
 
@@ -573,13 +730,13 @@ function getDaemonLogDir() {
   return LOG_DIR;
 }
 function getCurrentDaemonLogPath(date = /* @__PURE__ */ new Date()) {
-  return path9.join(LOG_DIR, `daemon-${date.toISOString().slice(0, 10)}.log`);
+  return path10.join(LOG_DIR, `daemon-${date.toISOString().slice(0, 10)}.log`);
 }
 function checkDateRotation() {
   const today = getDateStr();
   if (today !== currentDate) {
     currentDate = today;
-    currentLogFile = path9.join(LOG_DIR, `daemon-${currentDate}.log`);
+    currentLogFile = path10.join(LOG_DIR, `daemon-${currentDate}.log`);
     cleanOldLogs();
   }
 }
@@ -593,7 +750,7 @@ function cleanOldLogs() {
       const dateMatch = file.match(/daemon-(\d{4}-\d{2}-\d{2})/);
       if (dateMatch && dateMatch[1] < cutoffStr) {
         try {
-          fs2.unlinkSync(path9.join(LOG_DIR, file));
+          fs2.unlinkSync(path10.join(LOG_DIR, file));
         } catch {
         }
       }
@@ -709,17 +866,17 @@ function installGlobalInterceptor() {
   writeToFile(`Log file: ${currentLogFile}`);
   writeToFile(`Log level: ${currentLevel}`);
 }
-var fs2, path9, os4, LEVEL_NUM, LEVEL_LABEL, currentLevel, LOG_DIR, MAX_LOG_SIZE, MAX_LOG_DAYS, currentDate, currentLogFile, writeCount, RING_BUFFER_SIZE, ringBuffer, origConsoleLog, origConsoleError, origConsoleWarn, LOG, interceptorInstalled, LOG_PATH;
+var fs2, path10, os4, LEVEL_NUM, LEVEL_LABEL, currentLevel, LOG_DIR, MAX_LOG_SIZE, MAX_LOG_DAYS, currentDate, currentLogFile, writeCount, RING_BUFFER_SIZE, ringBuffer, origConsoleLog, origConsoleError, origConsoleWarn, LOG, interceptorInstalled, LOG_PATH;
 var init_logger = __esm({
   "src/logging/logger.ts"() {
     "use strict";
     fs2 = __toESM(require("fs"));
-    path9 = __toESM(require("path"));
+    path10 = __toESM(require("path"));
     os4 = __toESM(require("os"));
     LEVEL_NUM = { debug: 0, info: 1, warn: 2, error: 3 };
     LEVEL_LABEL = { debug: "DBG", info: "INF", warn: "WRN", error: "ERR" };
     currentLevel = "info";
-    LOG_DIR = process.platform === "win32" ? path9.join(process.env.LOCALAPPDATA || process.env.APPDATA || path9.join(os4.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path9.join(os4.homedir(), "Library", "Logs", "adhdev") : path9.join(os4.homedir(), ".local", "share", "adhdev", "logs");
+    LOG_DIR = process.platform === "win32" ? path10.join(process.env.LOCALAPPDATA || process.env.APPDATA || path10.join(os4.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path10.join(os4.homedir(), "Library", "Logs", "adhdev") : path10.join(os4.homedir(), ".local", "share", "adhdev", "logs");
     MAX_LOG_SIZE = 5 * 1024 * 1024;
     MAX_LOG_DAYS = 7;
     try {
@@ -727,16 +884,16 @@ var init_logger = __esm({
     } catch {
     }
     currentDate = getDateStr();
-    currentLogFile = path9.join(LOG_DIR, `daemon-${currentDate}.log`);
+    currentLogFile = path10.join(LOG_DIR, `daemon-${currentDate}.log`);
     cleanOldLogs();
     try {
-      const oldLog = path9.join(LOG_DIR, "daemon.log");
+      const oldLog = path10.join(LOG_DIR, "daemon.log");
       if (fs2.existsSync(oldLog)) {
         const stat2 = fs2.statSync(oldLog);
         const oldDate = stat2.mtime.toISOString().slice(0, 10);
-        fs2.renameSync(oldLog, path9.join(LOG_DIR, `daemon-${oldDate}.log`));
+        fs2.renameSync(oldLog, path10.join(LOG_DIR, `daemon-${oldDate}.log`));
       }
-      const oldLogBackup = path9.join(LOG_DIR, "daemon.log.old");
+      const oldLogBackup = path10.join(LOG_DIR, "daemon.log.old");
       if (fs2.existsSync(oldLogBackup)) {
         fs2.unlinkSync(oldLogBackup);
       }
@@ -768,7 +925,7 @@ var init_logger = __esm({
       }
     };
     interceptorInstalled = false;
-    LOG_PATH = path9.join(LOG_DIR, `daemon-${getDateStr()}.log`);
+    LOG_PATH = path10.join(LOG_DIR, `daemon-${getDateStr()}.log`);
   }
 });
 
@@ -1236,9 +1393,9 @@ function buildCliScreenSnapshot(text) {
 function findBinary(name) {
   const trimmed = String(name || "").trim();
   if (!trimmed) return trimmed;
-  const expanded = trimmed.startsWith("~") ? path13.join(os9.homedir(), trimmed.slice(1)) : trimmed;
-  if (path13.isAbsolute(expanded) || expanded.includes("/") || expanded.includes("\\")) {
-    return path13.isAbsolute(expanded) ? expanded : path13.resolve(expanded);
+  const expanded = trimmed.startsWith("~") ? path14.join(os9.homedir(), trimmed.slice(1)) : trimmed;
+  if (path14.isAbsolute(expanded) || expanded.includes("/") || expanded.includes("\\")) {
+    return path14.isAbsolute(expanded) ? expanded : path14.resolve(expanded);
   }
   const isWin = os9.platform() === "win32";
   try {
@@ -1254,7 +1411,7 @@ function findBinary(name) {
   }
 }
 function isScriptBinary(binaryPath) {
-  if (!path13.isAbsolute(binaryPath)) return false;
+  if (!path14.isAbsolute(binaryPath)) return false;
   try {
     const fs16 = require("fs");
     const resolved = fs16.realpathSync(binaryPath);
@@ -1270,7 +1427,7 @@ function isScriptBinary(binaryPath) {
   }
 }
 function looksLikeMachOOrElf(filePath) {
-  if (!path13.isAbsolute(filePath)) return false;
+  if (!path14.isAbsolute(filePath)) return false;
   try {
     const fs16 = require("fs");
     const resolved = fs16.realpathSync(filePath);
@@ -1359,12 +1516,12 @@ function normalizeCliProviderForRuntime(raw) {
     }
   };
 }
-var os9, path13, import_child_process4, buildCliSpawnEnv;
+var os9, path14, import_child_process4, buildCliSpawnEnv;
 var init_provider_cli_shared = __esm({
   "src/cli-adapters/provider-cli-shared.ts"() {
     "use strict";
     os9 = __toESM(require("os"));
-    path13 = __toESM(require("path"));
+    path14 = __toESM(require("path"));
     import_child_process4 = require("child_process");
     init_spawn_env();
     buildCliSpawnEnv = import_session_host_core.sanitizeSpawnEnv;
@@ -1487,7 +1644,7 @@ var init_provider_cli_config = __esm({
 
 // src/cli-adapters/provider-cli-runtime.ts
 function resolveCliSpawnPlan(options) {
-  const { provider, runtimeSettings, workingDir, extraArgs } = options;
+  const { provider, runtimeSettings, workingDir, extraArgs, extraEnv } = options;
   const { spawn: spawnConfig } = provider;
   const configuredCommand = typeof runtimeSettings.executablePath === "string" && runtimeSettings.executablePath.trim() ? runtimeSettings.executablePath.trim() : spawnConfig.command;
   const binaryPath = findBinary(configuredCommand);
@@ -1495,9 +1652,9 @@ function resolveCliSpawnPlan(options) {
   const allArgs = [...spawnConfig.args, ...extraArgs];
   let shellCmd;
   let shellArgs;
-  const useShellUnix = !isWin && (!!spawnConfig.shell || !path14.isAbsolute(binaryPath) || isScriptBinary(binaryPath) || !looksLikeMachOOrElf(binaryPath));
+  const useShellUnix = !isWin && (!!spawnConfig.shell || !path15.isAbsolute(binaryPath) || isScriptBinary(binaryPath) || !looksLikeMachOOrElf(binaryPath));
   const isCmdShim = isWin && /\.(cmd|bat)$/i.test(binaryPath);
-  const useShellWin = !!spawnConfig.shell || isCmdShim || !path14.isAbsolute(binaryPath) || isScriptBinary(binaryPath);
+  const useShellWin = !!spawnConfig.shell || isCmdShim || !path15.isAbsolute(binaryPath) || isScriptBinary(binaryPath);
   const useShell = isWin ? useShellWin : useShellUnix;
   if (useShell) {
     shellCmd = isWin ? "cmd.exe" : process.env.SHELL || "/bin/zsh";
@@ -1511,7 +1668,7 @@ function resolveCliSpawnPlan(options) {
     shellCmd = binaryPath;
     shellArgs = allArgs;
   }
-  const env = buildCliSpawnEnv(process.env, spawnConfig.env);
+  const env = buildCliSpawnEnv(process.env, { ...spawnConfig.env || {}, ...extraEnv || {} });
   env.TERMINAL_CWD = workingDir;
   return {
     binaryPath,
@@ -1573,12 +1730,12 @@ function respondToCliTerminalQueries(options) {
   }
   return "";
 }
-var os10, path14, import_session_host_core2;
+var os10, path15, import_session_host_core2;
 var init_provider_cli_runtime = __esm({
   "src/cli-adapters/provider-cli-runtime.ts"() {
     "use strict";
     os10 = __toESM(require("os"));
-    path14 = __toESM(require("path"));
+    path15 = __toESM(require("path"));
     import_session_host_core2 = require("@adhdev/session-host-core");
     init_provider_cli_shared();
   }
@@ -1614,8 +1771,9 @@ var init_provider_cli_adapter = __esm({
     init_provider_cli_runtime();
     init_provider_cli_shared();
     ProviderCliAdapter = class _ProviderCliAdapter {
-      constructor(provider, workingDir, extraArgs = [], transportFactory = new NodePtyTransportFactory()) {
+      constructor(provider, workingDir, extraArgs = [], extraEnv = {}, transportFactory = new NodePtyTransportFactory()) {
         this.extraArgs = extraArgs;
+        this.extraEnv = extraEnv;
         this.provider = provider;
         this.transportFactory = transportFactory;
         this.cliType = provider.type;
@@ -1766,8 +1924,9 @@ var init_provider_cli_adapter = __esm({
         const currentSnapshot = normalizeScreenSnapshot(screenText);
         const lastSnapshot = this.lastScreenSnapshot;
         if (!lastSnapshot || lastSnapshot === currentSnapshot) return screenText;
-        const staleSnapshotLooksActive = /\besc to (?:interrupt|stop)\b|Enter to interrupt, Ctrl\+C to cancel/i.test(lastSnapshot);
-        const currentScreenLooksIdle = /(?:^|\n|\r)\s*[❯›>]\s*(?:\n|\r|$)/.test(screenText) && !/\besc to (?:interrupt|stop)\b|Enter to interrupt, Ctrl\+C to cancel/i.test(screenText);
+        const activeScreenPattern = /\besc to (?:interrupt|stop)\b|Enter to interrupt, Ctrl\+C to cancel|Enter to confirm\s*[·•-]\s*Esc to cancel|\b(?:MCP servers?|tool calls?)\b[^\n\r]{0,160}\brequire approval\b/i;
+        const staleSnapshotLooksActive = activeScreenPattern.test(lastSnapshot);
+        const currentScreenLooksIdle = /(?:^|\n|\r)\s*[❯›>]\s*(?:Try\s+["“][^\n\r"”]+["”])?\s*(?:\n|\r|$)/.test(screenText) && !activeScreenPattern.test(screenText);
         if (staleSnapshotLooksActive && currentScreenLooksIdle) return screenText;
         if (currentSnapshot.length >= lastSnapshot.length) return screenText;
         return `${screenText}
@@ -1930,7 +2089,8 @@ ${lastSnapshot}`;
           provider: this.provider,
           runtimeSettings: this.runtimeSettings,
           workingDir: this.workingDir,
-          extraArgs: this.extraArgs
+          extraArgs: this.extraArgs,
+          extraEnv: this.extraEnv
         });
         LOG.info("CLI", `[${this.cliType}] Spawning in ${this.workingDir}`);
         this.resetTraceSession();
@@ -3128,9 +3288,8 @@ ${lastSnapshot}`;
           };
           this.recordTrace("submit_echo_missing", diagnostic);
           if (this.requirePromptEchoBeforeSubmit) {
-            const message = `${this.cliName} prompt echo was not observed on the PTY screen before submit`;
-            LOG.warn("CLI", `[${this.cliType}] ${message} elapsed=${elapsed}ms maxEchoWaitMs=${state.maxEchoWaitMs} screen=${JSON.stringify(diagnostic.screenText).slice(0, 240)}`);
-            completion.rejectOnce(new Error(message));
+            LOG.warn("CLI", `[${this.cliType}] prompt echo was not observed before submit; sending guarded submit key anyway elapsed=${elapsed}ms maxEchoWaitMs=${state.maxEchoWaitMs} screen=${JSON.stringify(diagnostic.screenText).slice(0, 240)}`);
+            this.submitSendKey(state, completion);
             return;
           }
           LOG.warn("CLI", `[${this.cliType}] prompt echo was not observed before submit; sending submit key anyway elapsed=${elapsed}ms maxEchoWaitMs=${state.maxEchoWaitMs}`);
@@ -3177,7 +3336,14 @@ ${lastSnapshot}`;
         })() : null;
         const parsedSessionStatus = typeof parsedStatusBeforeSend?.status === "string" ? String(parsedStatusBeforeSend.status) : "";
         if (!allowInputDuringGeneration && (parsedSessionStatus === "generating" || parsedSessionStatus === "long_generating")) {
-          throw new Error(`${this.cliName} is still processing the previous prompt`);
+          const parsedModal = parsedStatusBeforeSend?.activeModal ?? parsedStatusBeforeSend?.modal ?? null;
+          const parsedHasActionableModal = Boolean(
+            parsedModal && Array.isArray(parsedModal.buttons) && parsedModal.buttons.some((candidate) => typeof candidate === "string" && candidate.trim())
+          );
+          const terminalLooksIdle = this.currentStatus === "idle" && this.runDetectStatus(this.recentOutputBuffer) === "idle" && !this.isWaitingForResponse && !this.currentTurnScope && !this.hasActionableApproval() && !parsedHasActionableModal;
+          if (!terminalLooksIdle) {
+            throw new Error(`${this.cliName} is still processing the previous prompt`);
+          }
         }
         if (this.isWaitingForResponse && !allowInputDuringGeneration) {
           if (!this.clearStaleIdleResponseGuard("send_message_guard")) {
@@ -3727,12 +3893,14 @@ __export(index_exports, {
   createGitWorkspaceMonitor: () => createGitWorkspaceMonitor,
   createInteractionId: () => createInteractionId,
   createMesh: () => createMesh,
+  createWorktree: () => createWorktree,
   deleteMesh: () => deleteMesh,
   detectAllVersions: () => detectAllVersions,
   detectCLIs: () => detectCLIs,
   detectIDEs: () => detectIDEs,
   ensureSessionHostReady: () => ensureSessionHostReady,
   execNpmCommandSync: () => execNpmCommandSync,
+  filterUserFacingChatMessages: () => filterUserFacingChatMessages,
   findCdpManager: () => findCdpManager,
   flattenMessageParts: () => flattenMessageParts,
   forwardAgentStreamsToIdeInstance: () => forwardAgentStreamsToIdeInstance,
@@ -3774,11 +3942,13 @@ __export(index_exports, {
   isSessionHostLiveRuntime: () => isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot: () => isSessionHostRecoverySnapshot,
   isSetupComplete: () => isSetupComplete,
+  isUserFacingChatMessage: () => isUserFacingChatMessage,
   killIdeProcess: () => killIdeProcess,
   launchIDE: () => launchIDE,
   launchWithCdp: () => launchWithCdp,
   listHostedCliRuntimes: () => listHostedCliRuntimes,
   listMeshes: () => listMeshes,
+  listWorktrees: () => listWorktrees,
   loadConfig: () => loadConfig,
   loadState: () => loadState,
   logCommand: () => logCommand,
@@ -3798,6 +3968,7 @@ __export(index_exports, {
   normalizeSessionModalFields: () => normalizeSessionModalFields,
   parsePorcelainV2Status: () => parsePorcelainV2Status,
   parseProviderSourceConfigUpdate: () => parseProviderSourceConfigUpdate,
+  parseWorktreeListOutput: () => parseWorktreeListOutput,
   partitionSessionHostDiagnosticsSessions: () => partitionSessionHostDiagnosticsSessions,
   partitionSessionHostRecords: () => partitionSessionHostRecords,
   prepareSessionChatTailUpdate: () => prepareSessionChatTailUpdate,
@@ -3807,6 +3978,7 @@ __export(index_exports, {
   recordDebugTrace: () => recordDebugTrace,
   registerExtensionProviders: () => registerExtensionProviders,
   removeNode: () => removeNode,
+  removeWorktree: () => removeWorktree,
   resetConfig: () => resetConfig,
   resetDebugRuntimeConfig: () => resetDebugRuntimeConfig,
   resetState: () => resetState,
@@ -3816,6 +3988,7 @@ __export(index_exports, {
   resolveGitRepository: () => resolveGitRepository,
   resolveSessionHostAppName: () => resolveSessionHostAppName,
   resolveSessionHostAppNameResolution: () => resolveSessionHostAppNameResolution,
+  resolveWorktreePath: () => resolveWorktreePath,
   runAsyncBatch: () => runAsyncBatch,
   runGit: () => runGit,
   saveConfig: () => saveConfig,
@@ -4739,6 +4912,7 @@ var FAILURE_REASONS = /* @__PURE__ */ new Set([
   "dirty_index_required",
   "conflict",
   "invalid_args",
+  "nothing_to_commit",
   "git_command_failed"
 ]);
 function failure(reason, error) {
@@ -4983,7 +5157,10 @@ async function gitCheckpoint(workspace, message, includeUntracked) {
   } catch (err) {
     const output = (err?.stdout || "") + (err?.stderr || "");
     if (/nothing to commit/i.test(output)) {
-      throw new GitCommandError("git_command_failed", "Nothing to commit");
+      throw new GitCommandError("nothing_to_commit", "Nothing to commit \u2014 working tree is clean.", {
+        stdout: err?.stdout,
+        stderr: err?.stderr
+      });
     }
     throw err;
   }
@@ -5175,20 +5352,23 @@ var TurnSnapshotTracker = class {
   }
 };
 
+// src/git/index.ts
+init_git_worktree();
+
 // src/index.ts
 init_config();
 
 // src/config/workspaces.ts
 var fs = __toESM(require("fs"));
 var os = __toESM(require("os"));
-var path4 = __toESM(require("path"));
+var path5 = __toESM(require("path"));
 var import_crypto2 = require("crypto");
 var MAX_WORKSPACES = 50;
 function expandPath(p) {
   const t = (p || "").trim();
   if (!t) return "";
-  if (t.startsWith("~")) return path4.join(os.homedir(), t.slice(1).replace(/^\//, ""));
-  return path4.resolve(t);
+  if (t.startsWith("~")) return path5.join(os.homedir(), t.slice(1).replace(/^\//, ""));
+  return path5.resolve(t);
 }
 function validateWorkspacePath(absPath) {
   try {
@@ -5202,7 +5382,7 @@ function validateWorkspacePath(absPath) {
   }
 }
 function defaultWorkspaceLabel(absPath) {
-  const base = path4.basename(absPath) || absPath;
+  const base = path5.basename(absPath) || absPath;
   return base;
 }
 function getDefaultWorkspacePath(config) {
@@ -5293,9 +5473,9 @@ function resolveIdeLaunchWorkspace(args, config) {
   return getDefaultWorkspacePath(config) || void 0;
 }
 function findWorkspaceByPath(config, rawPath) {
-  const abs = path4.resolve(expandPath(rawPath));
+  const abs = path5.resolve(expandPath(rawPath));
   if (!abs) return void 0;
-  return (config.workspaces || []).find((w) => path4.resolve(expandPath(w.path)) === abs);
+  return (config.workspaces || []).find((w) => path5.resolve(expandPath(w.path)) === abs);
 }
 function addWorkspaceEntry(config, rawPath, label, options) {
   const abs = expandPath(rawPath);
@@ -5311,7 +5491,7 @@ function addWorkspaceEntry(config, rawPath, label, options) {
   const v = validateWorkspacePath(abs);
   if (!v.ok) return { error: v.error };
   const list = [...config.workspaces || []];
-  if (list.some((w) => path4.resolve(w.path) === abs)) {
+  if (list.some((w) => path5.resolve(w.path) === abs)) {
     return { error: "Workspace already in list" };
   }
   if (list.length >= MAX_WORKSPACES) {
@@ -5345,7 +5525,7 @@ function setDefaultWorkspaceId(config, id) {
 }
 
 // src/config/recent-activity.ts
-var path5 = __toESM(require("path"));
+var path6 = __toESM(require("path"));
 
 // src/providers/summary-metadata.ts
 function normalizeSummaryItem(item) {
@@ -5414,9 +5594,9 @@ var MAX_ACTIVITY = 30;
 function normalizeWorkspace(workspace) {
   if (!workspace) return "";
   try {
-    return path5.resolve(expandPath(workspace));
+    return path6.resolve(expandPath(workspace));
   } catch {
-    return path5.resolve(workspace);
+    return path6.resolve(workspace);
   }
 }
 function buildRecentActivityKey(entry) {
@@ -5584,14 +5764,14 @@ function markSessionSeen(state, sessionId, seenAt = Date.now(), completionMarker
 }
 
 // src/config/saved-sessions.ts
-var path6 = __toESM(require("path"));
+var path7 = __toESM(require("path"));
 var MAX_SAVED_SESSIONS = 500;
 function normalizeWorkspace2(workspace) {
   if (!workspace) return "";
   try {
-    return path6.resolve(expandPath(workspace));
+    return path7.resolve(expandPath(workspace));
   } catch {
-    return path6.resolve(workspace);
+    return path7.resolve(workspace);
   }
 }
 function buildSavedProviderSessionKey(providerSessionId) {
@@ -5770,7 +5950,7 @@ function resetState() {
 var import_child_process = require("child_process");
 var import_fs4 = require("fs");
 var import_os2 = require("os");
-var path7 = __toESM(require("path"));
+var path8 = __toESM(require("path"));
 var BUILTIN_IDE_DEFINITIONS = [];
 var registeredIDEs = /* @__PURE__ */ new Map();
 function registerIDEDefinition(def) {
@@ -5789,9 +5969,9 @@ function getMergedDefinitions() {
 function findCliCommand(command) {
   const trimmed = String(command || "").trim();
   if (!trimmed) return null;
-  if (path7.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~")) {
-    const candidate = trimmed.startsWith("~") ? path7.join((0, import_os2.homedir)(), trimmed.slice(1)) : trimmed;
-    const resolved = path7.isAbsolute(candidate) ? candidate : path7.resolve(candidate);
+  if (path8.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~")) {
+    const candidate = trimmed.startsWith("~") ? path8.join((0, import_os2.homedir)(), trimmed.slice(1)) : trimmed;
+    const resolved = path8.isAbsolute(candidate) ? candidate : path8.resolve(candidate);
     return (0, import_fs4.existsSync)(resolved) ? resolved : null;
   }
   try {
@@ -5819,7 +5999,7 @@ function getIdeVersion(cliCommand) {
 function checkPathExists(paths) {
   const home = (0, import_os2.homedir)();
   for (const p of paths) {
-    const normalized = p.startsWith("~") ? path7.join(home, p.slice(1)) : p;
+    const normalized = p.startsWith("~") ? path8.join(home, p.slice(1)) : p;
     if (normalized.includes("*")) {
       const username = home.split(/[\\/]/).pop() || "";
       const resolved = normalized.replace("*", username);
@@ -5831,19 +6011,19 @@ function checkPathExists(paths) {
   return null;
 }
 async function detectIDEs(providerLoader) {
-  const os21 = (0, import_os2.platform)();
+  const os22 = (0, import_os2.platform)();
   const results = [];
   for (const def of getMergedDefinitions()) {
     const cliPath = findCliCommand(providerLoader?.getIdeCliCommand(def.id, def.cli) || def.cli);
-    const appPath = checkPathExists(providerLoader?.getIdePathCandidates(def.id, def.paths[os21] || []) || []);
+    const appPath = checkPathExists(providerLoader?.getIdePathCandidates(def.id, def.paths[os22] || []) || []);
     let resolvedCli = cliPath;
-    if (!resolvedCli && appPath && os21 === "darwin") {
+    if (!resolvedCli && appPath && os22 === "darwin") {
       const bundledCli = `${appPath}/Contents/Resources/app/bin/${def.cli}`;
       if ((0, import_fs4.existsSync)(bundledCli)) resolvedCli = bundledCli;
     }
-    if (!resolvedCli && appPath && os21 === "win32") {
-      const { dirname: dirname8 } = await import("path");
-      const appDir = dirname8(appPath);
+    if (!resolvedCli && appPath && os22 === "win32") {
+      const { dirname: dirname9 } = await import("path");
+      const appDir = dirname9(appPath);
       const candidates = [
         `${appDir}\\\\bin\\\\${def.cli}.cmd`,
         `${appDir}\\\\bin\\\\${def.cli}`,
@@ -5858,7 +6038,7 @@ async function detectIDEs(providerLoader) {
         }
       }
     }
-    const installed = os21 === "darwin" ? !!(resolvedCli || appPath) : !!resolvedCli;
+    const installed = os22 === "darwin" ? !!(resolvedCli || appPath) : !!resolvedCli;
     const version = resolvedCli ? getIdeVersion(resolvedCli) : null;
     results.push({
       id: def.id,
@@ -5877,7 +6057,7 @@ async function detectIDEs(providerLoader) {
 // src/detection/cli-detector.ts
 var import_child_process2 = require("child_process");
 var os2 = __toESM(require("os"));
-var path8 = __toESM(require("path"));
+var path9 = __toESM(require("path"));
 var import_fs5 = require("fs");
 function parseVersion(raw) {
   const match = raw.match(/v?(\d+\.\d+(?:\.\d+)?(?:-[a-zA-Z0-9.]+)?)/);
@@ -5890,18 +6070,18 @@ function shellQuote(value) {
 function expandHome(value) {
   const trimmed = value.trim();
   if (!trimmed.startsWith("~")) return trimmed;
-  return path8.join(os2.homedir(), trimmed.slice(1));
+  return path9.join(os2.homedir(), trimmed.slice(1));
 }
 function isExplicitCommandPath(command) {
   const trimmed = command.trim();
-  return path8.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~");
+  return path9.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~");
 }
 function resolveCommandPath(command) {
   const trimmed = command.trim();
   if (!trimmed) return null;
   if (isExplicitCommandPath(trimmed)) {
     const expanded = expandHome(trimmed);
-    const candidate = path8.isAbsolute(expanded) ? expanded : path8.resolve(expanded);
+    const candidate = path9.isAbsolute(expanded) ? expanded : path9.resolve(expanded);
     return (0, import_fs5.existsSync)(candidate) ? candidate : null;
   }
   return null;
@@ -7974,6 +8154,44 @@ function normalizeChatMessage(message) {
 function normalizeChatMessages(messages) {
   return (Array.isArray(messages) ? messages : []).map((message) => normalizeChatMessage(message));
 }
+function readMessageMeta(message) {
+  const meta = message?.meta;
+  return meta && typeof meta === "object" && !Array.isArray(meta) ? meta : null;
+}
+function readStringField(value) {
+  return typeof value === "string" ? value.trim().toLowerCase() : "";
+}
+function readVisibilityField(message, meta) {
+  const record = message;
+  return readStringField(record.visibility ?? record.transcriptVisibility ?? meta?.visibility ?? meta?.transcriptVisibility);
+}
+function isExplicitlyHiddenFromTranscript(message, meta) {
+  const record = message;
+  const visibility = readVisibilityField(message, meta);
+  const audience = readStringField(record.audience ?? meta?.audience);
+  const source = readStringField(record.source ?? meta?.source);
+  return visibility === "hidden" || visibility === "debug" || visibility === "internal" || audience === "debug" || audience === "trace" || audience === "internal" || source === "runtime_status" || source === "runtime_activity" || source === "provider_chrome" || source === "control" || record.internal === true || record.isInternal === true || record.debug === true || meta?.internal === true || meta?.isInternal === true || meta?.debug === true || meta?.statusOnly === true || meta?.controlOnly === true;
+}
+function isExplicitlyVisibleInTranscript(message, meta) {
+  const record = message;
+  const visibility = readVisibilityField(message, meta);
+  const audience = readStringField(record.audience ?? meta?.audience);
+  return visibility === "visible" || visibility === "user" || visibility === "chat" || audience === "chat" || record.userFacing === true || meta?.userFacing === true;
+}
+function isUserFacingChatMessage(message) {
+  if (!message) return false;
+  const meta = readMessageMeta(message);
+  if (isExplicitlyHiddenFromTranscript(message, meta)) return false;
+  if (isExplicitlyVisibleInTranscript(message, meta)) return true;
+  const role = typeof message.role === "string" ? message.role.trim().toLowerCase() : "";
+  const kind = resolveChatMessageKind(message);
+  if (role === "user" || role === "human") return kind === "standard" || kind === "";
+  if (role === "assistant") return kind === "standard" || kind === "";
+  return false;
+}
+function filterUserFacingChatMessages(messages) {
+  return (Array.isArray(messages) ? messages : []).filter((message) => isUserFacingChatMessage(message));
+}
 
 // src/providers/control-effects.ts
 function extractProviderControlValues(controls, data) {
@@ -8170,9 +8388,9 @@ ${cleanBody}`;
 
 // src/config/chat-history.ts
 var fs3 = __toESM(require("fs"));
-var path10 = __toESM(require("path"));
+var path11 = __toESM(require("path"));
 var os5 = __toESM(require("os"));
-var HISTORY_DIR = path10.join(os5.homedir(), ".adhdev", "history");
+var HISTORY_DIR = path11.join(os5.homedir(), ".adhdev", "history");
 var RETAIN_DAYS = 30;
 var SAVED_HISTORY_INDEX_VERSION = 1;
 var SAVED_HISTORY_INDEX_FILE = ".saved-history-index.json";
@@ -8335,7 +8553,7 @@ function extractSavedHistorySessionIdFromFile(file) {
 function buildSavedHistoryFileSignatureMap(dir, files) {
   return new Map(files.map((file) => {
     try {
-      const stat2 = fs3.statSync(path10.join(dir, file));
+      const stat2 = fs3.statSync(path11.join(dir, file));
       return [file, `${file}:${stat2.size}:${Math.trunc(stat2.mtimeMs)}`];
     } catch {
       return [file, `${file}:missing`];
@@ -8346,7 +8564,7 @@ function buildSavedHistoryCacheSignature(files, fileSignatures) {
   return files.map((file) => fileSignatures.get(file) || `${file}:missing`).join("|");
 }
 function getSavedHistoryIndexFilePath(dir) {
-  return path10.join(dir, SAVED_HISTORY_INDEX_FILE);
+  return path11.join(dir, SAVED_HISTORY_INDEX_FILE);
 }
 function getSavedHistoryIndexLockPath(dir) {
   return `${getSavedHistoryIndexFilePath(dir)}${SAVED_HISTORY_INDEX_LOCK_SUFFIX}`;
@@ -8448,7 +8666,7 @@ function savePersistedSavedHistoryIndex(dir, entries) {
     }
     for (const file of Array.from(currentEntries.keys())) {
       if (incomingFiles.has(file)) continue;
-      if (!fs3.existsSync(path10.join(dir, file))) {
+      if (!fs3.existsSync(path11.join(dir, file))) {
         currentEntries.delete(file);
       }
     }
@@ -8474,7 +8692,7 @@ function historyDirectoryHasFilesNewerThanIndex(dir) {
     const indexStat = fs3.statSync(getSavedHistoryIndexFilePath(dir));
     const files = listHistoryFiles(dir);
     for (const file of files) {
-      const stat2 = fs3.statSync(path10.join(dir, file));
+      const stat2 = fs3.statSync(path11.join(dir, file));
       if (stat2.mtimeMs > indexStat.mtimeMs) return true;
     }
     return false;
@@ -8484,14 +8702,14 @@ function historyDirectoryHasFilesNewerThanIndex(dir) {
 }
 function buildSavedHistoryFileSignature(dir, file) {
   try {
-    const stat2 = fs3.statSync(path10.join(dir, file));
+    const stat2 = fs3.statSync(path11.join(dir, file));
     return `${file}:${stat2.size}:${Math.trunc(stat2.mtimeMs)}`;
   } catch {
     return `${file}:missing`;
   }
 }
 function persistSavedHistoryFileSummaryEntry(agentType, dir, file, updater) {
-  const filePath = path10.join(dir, file);
+  const filePath = path11.join(dir, file);
   const result = withLockedPersistedSavedHistoryIndex(dir, (entries) => {
     const currentEntry = entries.get(file) || null;
     const nextSummary = updater(currentEntry?.summary || null);
@@ -8564,7 +8782,7 @@ function updateSavedHistoryIndexForAppendedMessages(agentType, dir, file, histor
 function computeSavedHistoryFileSummary(dir, file) {
   const historySessionId = extractSavedHistorySessionIdFromFile(file);
   if (!historySessionId) return null;
-  const filePath = path10.join(dir, file);
+  const filePath = path11.join(dir, file);
   const content = fs3.readFileSync(filePath, "utf-8");
   const lines = content.split("\n").filter(Boolean);
   let messageCount = 0;
@@ -8651,7 +8869,7 @@ function computeSavedHistorySessionSummaries(agentType, dir, files, fileSignatur
   const summaryBySessionId = /* @__PURE__ */ new Map();
   const nextPersistedEntries = /* @__PURE__ */ new Map();
   for (const file of files.slice().sort()) {
-    const filePath = path10.join(dir, file);
+    const filePath = path11.join(dir, file);
     const signature = fileSignatures.get(file) || `${file}:missing`;
     const cached = savedHistoryFileSummaryCache.get(filePath);
     const persisted = persistedEntries.get(file);
@@ -8771,12 +8989,12 @@ var ChatHistoryWriter = class {
         });
       }
       if (newMessages.length === 0) return;
-      const dir = path10.join(HISTORY_DIR, this.sanitize(agentType));
+      const dir = path11.join(HISTORY_DIR, this.sanitize(agentType));
       fs3.mkdirSync(dir, { recursive: true });
       const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
       const filePrefix = effectiveHistoryKey ? `${this.sanitize(effectiveHistoryKey)}_` : "";
       const fileName = `${filePrefix}${date}.jsonl`;
-      const filePath = path10.join(dir, fileName);
+      const filePath = path11.join(dir, fileName);
       const lines = newMessages.map((m) => JSON.stringify(m)).join("\n") + "\n";
       fs3.appendFileSync(filePath, lines, "utf-8");
       updateSavedHistoryIndexForAppendedMessages(agentType, dir, fileName, effectiveHistoryKey, newMessages);
@@ -8867,11 +9085,11 @@ var ChatHistoryWriter = class {
     const ws = String(workspace || "").trim();
     if (!id || !ws) return;
     try {
-      const dir = path10.join(HISTORY_DIR, this.sanitize(agentType));
+      const dir = path11.join(HISTORY_DIR, this.sanitize(agentType));
       fs3.mkdirSync(dir, { recursive: true });
       const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
       const fileName = `${this.sanitize(id)}_${date}.jsonl`;
-      const filePath = path10.join(dir, fileName);
+      const filePath = path11.join(dir, fileName);
       const record = {
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         receivedAt: Date.now(),
@@ -8917,14 +9135,14 @@ var ChatHistoryWriter = class {
         this.lastSeenCounts.set(toDedupKey, Math.max(fromCount, this.lastSeenCounts.get(toDedupKey) || 0));
         this.lastSeenCounts.delete(fromDedupKey);
       }
-      const dir = path10.join(HISTORY_DIR, this.sanitize(agentType));
+      const dir = path11.join(HISTORY_DIR, this.sanitize(agentType));
       if (!fs3.existsSync(dir)) return;
       const fromPrefix = `${this.sanitize(fromId)}_`;
       const toPrefix = `${this.sanitize(toId)}_`;
       const files = fs3.readdirSync(dir).filter((file) => file.startsWith(fromPrefix) && file.endsWith(".jsonl"));
       for (const file of files) {
-        const sourcePath = path10.join(dir, file);
-        const targetPath = path10.join(dir, `${toPrefix}${file.slice(fromPrefix.length)}`);
+        const sourcePath = path11.join(dir, file);
+        const targetPath = path11.join(dir, `${toPrefix}${file.slice(fromPrefix.length)}`);
         const sourceLines = fs3.readFileSync(sourcePath, "utf-8").split("\n").filter(Boolean);
         const rewritten = sourceLines.map((line) => {
           try {
@@ -8958,13 +9176,13 @@ var ChatHistoryWriter = class {
     const sessionId = String(historySessionId || "").trim();
     if (!sessionId) return;
     try {
-      const dir = path10.join(HISTORY_DIR, this.sanitize(agentType));
+      const dir = path11.join(HISTORY_DIR, this.sanitize(agentType));
       if (!fs3.existsSync(dir)) return;
       const prefix = `${this.sanitize(sessionId)}_`;
       const files = fs3.readdirSync(dir).filter((file) => file.startsWith(prefix) && file.endsWith(".jsonl")).sort();
       const seen = /* @__PURE__ */ new Set();
       for (const file of files) {
-        const filePath = path10.join(dir, file);
+        const filePath = path11.join(dir, file);
         const lines = fs3.readFileSync(filePath, "utf-8").split("\n").filter(Boolean);
         const next = [];
         for (const line of lines) {
@@ -9018,11 +9236,11 @@ var ChatHistoryWriter = class {
       const cutoff = Date.now() - RETAIN_DAYS * 24 * 60 * 60 * 1e3;
       const agentDirs = fs3.readdirSync(HISTORY_DIR, { withFileTypes: true }).filter((d) => d.isDirectory());
       for (const dir of agentDirs) {
-        const dirPath = path10.join(HISTORY_DIR, dir.name);
+        const dirPath = path11.join(HISTORY_DIR, dir.name);
         const files = fs3.readdirSync(dirPath).filter((f) => f.endsWith(".jsonl") || f.endsWith(".terminal.log"));
         let removedAny = false;
         for (const file of files) {
-          const filePath = path10.join(dirPath, file);
+          const filePath = path11.join(dirPath, file);
           const stat2 = fs3.statSync(filePath);
           if (stat2.mtimeMs < cutoff) {
             fs3.unlinkSync(filePath);
@@ -9072,13 +9290,13 @@ function pageHistoryRecords(agentType, records, offset = 0, limit = 30, excludeR
 function readChatHistory(agentType, offset = 0, limit = 30, historySessionId, excludeRecentCount = 0, historyBehavior) {
   try {
     const sanitized = agentType.replace(/[^a-zA-Z0-9_-]/g, "_");
-    const dir = path10.join(HISTORY_DIR, sanitized);
+    const dir = path11.join(HISTORY_DIR, sanitized);
     if (!fs3.existsSync(dir)) return { messages: [], hasMore: false };
     const files = listHistoryFiles(dir, historySessionId);
     const allMessages = [];
     const seen = /* @__PURE__ */ new Set();
     for (const file of files) {
-      const filePath = path10.join(dir, file);
+      const filePath = path11.join(dir, file);
       const content = fs3.readFileSync(filePath, "utf-8");
       const lines = content.trim().split("\n").filter(Boolean);
       for (let i = 0; i < lines.length; i++) {
@@ -9102,7 +9320,7 @@ function readChatHistory(agentType, offset = 0, limit = 30, historySessionId, ex
 function listSavedHistorySessions(agentType, options = {}, historyBehavior) {
   try {
     const sanitized = agentType.replace(/[^a-zA-Z0-9_-]/g, "_");
-    const dir = path10.join(HISTORY_DIR, sanitized);
+    const dir = path11.join(HISTORY_DIR, sanitized);
     if (!fs3.existsSync(dir)) {
       savedHistorySessionCache.delete(sanitized);
       return { sessions: [], hasMore: false };
@@ -9163,11 +9381,11 @@ function listSavedHistorySessions(agentType, options = {}, historyBehavior) {
 }
 function readExistingSessionStartRecord(agentType, historySessionId) {
   try {
-    const dir = path10.join(HISTORY_DIR, agentType);
+    const dir = path11.join(HISTORY_DIR, agentType);
     if (!fs3.existsSync(dir)) return null;
     const files = listHistoryFiles(dir, historySessionId).sort();
     for (const file of files) {
-      const lines = fs3.readFileSync(path10.join(dir, file), "utf-8").split("\n").filter(Boolean);
+      const lines = fs3.readFileSync(path11.join(dir, file), "utf-8").split("\n").filter(Boolean);
       for (const line of lines) {
         try {
           const parsed = JSON.parse(line);
@@ -9187,16 +9405,16 @@ function readExistingSessionStartRecord(agentType, historySessionId) {
 function rewriteCanonicalSavedHistory(agentType, historySessionId, records) {
   if (records.length === 0) return false;
   try {
-    const dir = path10.join(HISTORY_DIR, agentType);
+    const dir = path11.join(HISTORY_DIR, agentType);
     fs3.mkdirSync(dir, { recursive: true });
     const prefix = `${historySessionId.replace(/[^a-zA-Z0-9_-]/g, "_")}_`;
     for (const file of fs3.readdirSync(dir)) {
       if (file.startsWith(prefix) && file.endsWith(".jsonl")) {
-        fs3.unlinkSync(path10.join(dir, file));
+        fs3.unlinkSync(path11.join(dir, file));
       }
     }
     const targetDate = new Date(records[records.length - 1].receivedAt || Date.now()).toISOString().slice(0, 10);
-    const filePath = path10.join(dir, `${prefix}${targetDate}.jsonl`);
+    const filePath = path11.join(dir, `${prefix}${targetDate}.jsonl`);
     fs3.writeFileSync(filePath, `${records.map((record) => JSON.stringify(record)).join("\n")}
 `, "utf-8");
     invalidatePersistedSavedHistoryIndex(agentType, dir);
@@ -9946,6 +10164,14 @@ function validateMessage(message, source, index) {
   if (typeof message.senderName === "string") normalized.senderName = message.senderName;
   if (typeof message._type === "string") normalized._type = message._type;
   if (typeof message._sub === "string") normalized._sub = message._sub;
+  if (typeof message.visibility === "string") normalized.visibility = message.visibility;
+  if (typeof message.transcriptVisibility === "string") normalized.transcriptVisibility = message.transcriptVisibility;
+  if (typeof message.audience === "string") normalized.audience = message.audience;
+  if (typeof message.source === "string") normalized.source = message.source;
+  if (typeof message.userFacing === "boolean") normalized.userFacing = message.userFacing;
+  if (typeof message.internal === "boolean") normalized.internal = message.internal;
+  if (typeof message.isInternal === "boolean") normalized.isInternal = message.isInternal;
+  if (typeof message.debug === "boolean") normalized.debug = message.debug;
   return normalized;
 }
 function validateModal(activeModal, status, source) {
@@ -11191,6 +11417,14 @@ function getActiveChatOptions(profile) {
   if (profile === "full") return {};
   return LIVE_STATUS_ACTIVE_CHAT_OPTIONS;
 }
+function resolveSessionStatus(activeChat, providerStatus) {
+  const chatStatus = normalizeManagedStatus(activeChat?.status, { activeModal: activeChat?.activeModal || null });
+  const topLevelStatus = normalizeManagedStatus(providerStatus, { activeModal: activeChat?.activeModal || null });
+  if (chatStatus === "waiting_approval" || topLevelStatus === "waiting_approval") return "waiting_approval";
+  if (chatStatus === "generating" || topLevelStatus === "generating") return "generating";
+  if (topLevelStatus !== "idle") return topLevelStatus;
+  return chatStatus;
+}
 function shouldIncludeSessionControls(profile) {
   return profile !== "live";
 }
@@ -11269,9 +11503,7 @@ function buildIdeWorkspaceSession(state, cdpManagers, options) {
     providerName: state.name,
     kind: "workspace",
     transport: "cdp-page",
-    status: normalizeManagedStatus(activeChat?.status || state.status, {
-      activeModal: activeChat?.activeModal || null
-    }),
+    status: resolveSessionStatus(activeChat, state.status),
     title,
     workspace,
     ...git && { git },
@@ -11306,9 +11538,7 @@ function buildExtensionAgentSession(parent, ext, options) {
     providerSessionId: ext.providerSessionId,
     kind: "agent",
     transport: "cdp-webview",
-    status: normalizeManagedStatus(activeChat?.status || ext.status, {
-      activeModal: activeChat?.activeModal || null
-    }),
+    status: resolveSessionStatus(activeChat, ext.status),
     title: activeChat?.title || ext.name,
     workspace,
     ...git && { git },
@@ -11358,9 +11588,7 @@ function buildCliSession(state, options) {
     providerSessionId: state.providerSessionId,
     kind: "agent",
     transport: "pty",
-    status: normalizeManagedStatus(activeChat?.status || state.status, {
-      activeModal: activeChat?.activeModal || null
-    }),
+    status: resolveSessionStatus(activeChat, state.status),
     title: activeChat?.title || state.name,
     workspace,
     ...git && { git },
@@ -11408,9 +11636,7 @@ function buildAcpSession(state, options) {
     providerName: state.name,
     kind: "agent",
     transport: "acp",
-    status: normalizeManagedStatus(activeChat?.status || state.status, {
-      activeModal: activeChat?.activeModal || null
-    }),
+    status: resolveSessionStatus(activeChat, state.status),
     title: activeChat?.title || state.name,
     workspace,
     ...git && { git },
@@ -11533,7 +11759,7 @@ function resolveLegacyProviderScript(fn, scriptName, params) {
 // src/commands/chat-commands.ts
 var fs4 = __toESM(require("fs"));
 var os6 = __toESM(require("os"));
-var path11 = __toESM(require("path"));
+var path12 = __toESM(require("path"));
 var import_node_crypto = require("crypto");
 
 // src/providers/provider-input-support.ts
@@ -11736,6 +11962,7 @@ function buildSessionModalDeliverySignature(payload) {
 // src/commands/chat-commands.ts
 var RECENT_SEND_WINDOW_MS = 1200;
 var READ_CHAT_PROVIDER_EVAL_TIMEOUT_MS = 25e3;
+var HERMES_CLI_STARTING_SEND_SETTLE_MS = 2e3;
 var recentSendByTarget = /* @__PURE__ */ new Map();
 function getCurrentProviderType(h, fallback = "") {
   return h.currentSession?.providerType || h.currentProviderType || fallback;
@@ -11788,6 +12015,16 @@ function buildSendInputSignature(input) {
 function getSendChatInputEnvelope(args) {
   return normalizeInputEnvelope(args?.input ? { input: args.input } : args);
 }
+function sleep(ms) {
+  return new Promise((resolve16) => setTimeout(resolve16, ms));
+}
+async function waitOnceForFreshHermesCliStart(adapter, log) {
+  if (adapter.cliType !== "hermes-cli") return;
+  const status = typeof adapter.getStatus === "function" ? adapter.getStatus()?.status : void 0;
+  if (status !== "starting") return;
+  log(`Hermes CLI is still starting; waiting ${HERMES_CLI_STARTING_SEND_SETTLE_MS}ms before first send`);
+  await sleep(HERMES_CLI_STARTING_SEND_SETTLE_MS);
+}
 function getHistorySessionId(h, args) {
   const explicit = typeof args?.historySessionId === "string" ? args.historySessionId.trim() : "";
   if (explicit) return explicit;
@@ -11842,7 +12079,7 @@ function normalizeReadChatTailLimit(args) {
 }
 function normalizeReadChatMessages(payload) {
   const messages = Array.isArray(payload.messages) ? payload.messages : [];
-  return messages;
+  return normalizeChatMessages(messages);
 }
 function deriveHistoryDedupKey(message) {
   const unitKey = typeof message._unitKey === "string" ? message._unitKey.trim() : "";
@@ -11896,6 +12133,34 @@ function normalizeReadChatCommandStatus(status, activeModal) {
       return raw;
   }
 }
+function isGeneratingLikeStatus(status) {
+  return status === "generating" || status === "streaming" || status === "long_generating" || status === "starting";
+}
+function shouldTrustCliAdapterTerminalStatus(parsedStatus, activeModal, adapter, adapterStatus) {
+  if (!isGeneratingLikeStatus(parsedStatus)) return false;
+  if (hasNonEmptyModalButtons(activeModal)) return false;
+  const adapterRawStatus = typeof adapterStatus?.status === "string" ? adapterStatus.status.trim() : "";
+  if (adapterRawStatus !== "idle") return false;
+  if (typeof adapter.isProcessing === "function" && adapter.isProcessing()) return false;
+  return true;
+}
+function normalizeCliReadChatStatus(parsedStatus, activeModal, adapter, adapterStatus) {
+  if (shouldTrustCliAdapterTerminalStatus(parsedStatus, activeModal, adapter, adapterStatus)) return "idle";
+  return typeof parsedStatus === "string" && parsedStatus.trim() ? parsedStatus : "idle";
+}
+function finalizeStreamingMessagesWhenIdle(messages, status) {
+  if (status !== "idle") return messages;
+  return messages.map((message) => {
+    const meta = message.meta && typeof message.meta === "object" ? message.meta : void 0;
+    const hasStreamingMeta = meta?.streaming === true;
+    if (message.bubbleState !== "streaming" && !hasStreamingMeta) return message;
+    return {
+      ...message,
+      ...message.bubbleState === "streaming" ? { bubbleState: "final" } : {},
+      ...hasStreamingMeta ? { meta: { ...meta, streaming: false } } : {}
+    };
+  });
+}
 function buildReadChatCommandResult(payload, args) {
   let validatedPayload;
   const debugReadChat = payload?.debugReadChat && typeof payload.debugReadChat === "object" ? payload.debugReadChat : void 0;
@@ -11908,13 +12173,22 @@ function buildReadChatCommandResult(payload, args) {
     return { success: false, error: error?.message || String(error) };
   }
   const messages = normalizeReadChatMessages(validatedPayload);
-  const sync = buildFullTail(messages, normalizeReadChatTailLimit(args));
+  const visibleMessages = filterUserFacingChatMessages(messages);
+  const sync = buildFullTail(visibleMessages, normalizeReadChatTailLimit(args));
+  const hiddenMsgCount = Math.max(0, messages.length - visibleMessages.length);
+  const returnedDebugReadChat = debugReadChat ? {
+    ...debugReadChat,
+    fullMsgCount: typeof debugReadChat.fullMsgCount === "number" ? debugReadChat.fullMsgCount : messages.length,
+    visibleMsgCount: visibleMessages.length,
+    hiddenMsgCount,
+    returnedMsgCount: sync.messages.length
+  } : void 0;
   return {
     success: true,
     ...validatedPayload,
     messages: sync.messages,
     totalMessages: sync.totalMessages,
-    ...debugReadChat ? { debugReadChat } : {}
+    ...returnedDebugReadChat ? { debugReadChat: returnedDebugReadChat } : {}
   };
 }
 var DEFAULT_DEBUG_SANITIZE_OPTIONS = {
@@ -12044,7 +12318,7 @@ function buildDebugBundleText(bundle) {
 }
 function getChatDebugBundleDir() {
   const override = typeof process.env.ADHDEV_DEBUG_BUNDLE_DIR === "string" ? process.env.ADHDEV_DEBUG_BUNDLE_DIR.trim() : "";
-  return override || path11.join(os6.homedir(), ".adhdev", "debug-bundles", "chat");
+  return override || path12.join(os6.homedir(), ".adhdev", "debug-bundles", "chat");
 }
 function safeBundleIdSegment(value, fallback) {
   const normalized = String(value || fallback).trim().replace(/[^A-Za-z0-9_.-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
@@ -12060,6 +12334,14 @@ function buildChatDebugBundleSummary(bundle) {
   const readChat = bundle.readChat && typeof bundle.readChat === "object" ? bundle.readChat : {};
   const cli = bundle.cli && typeof bundle.cli === "object" ? bundle.cli : null;
   const frontend = bundle.frontend && typeof bundle.frontend === "object" ? bundle.frontend : null;
+  const debugReadChat = readChat.debugReadChat && typeof readChat.debugReadChat === "object" ? readChat.debugReadChat : {};
+  const parsedStatus = cli?.parsedStatus && typeof cli.parsedStatus === "object" ? cli.parsedStatus : null;
+  const cliParsedMessageCount = Array.isArray(parsedStatus?.messages) ? parsedStatus.messages.length : void 0;
+  const readChatReturnedMessages = Array.isArray(readChat.messagesTail) ? readChat.messagesTail.length : void 0;
+  const cliPartialResponse = typeof cli?.partialResponse === "string" ? cli.partialResponse : "";
+  const readChatStatus = typeof readChat.status === "string" ? readChat.status : "";
+  const cliStatus = typeof cli?.status === "string" ? cli.status : "";
+  const cliParsedStatus = typeof parsedStatus?.status === "string" ? parsedStatus.status : "";
   return {
     createdAt: bundle.createdAt,
     targetSessionId: target.targetSessionId,
@@ -12068,8 +12350,22 @@ function buildChatDebugBundleSummary(bundle) {
     readChatSuccess: readChat.success,
     readChatStatus: readChat.status,
     readChatTotalMessages: readChat.totalMessages,
+    readChatReturnedMessages,
     cliStatus: cli?.status,
+    cliParsedStatus: cliParsedStatus || void 0,
     cliMessageCount: cli?.messageCount,
+    cliParsedMessageCount,
+    cliPartialResponseChars: cliPartialResponse.length,
+    parserAdapterStatusMismatch: Boolean(cliStatus && cliParsedStatus && cliStatus !== cliParsedStatus),
+    parserReadChatStatusMismatch: Boolean(readChatStatus && cliParsedStatus && readChatStatus !== cliParsedStatus),
+    readChatDebug: Object.keys(debugReadChat).length ? {
+      adapterStatus: debugReadChat.adapterStatus,
+      parsedStatus: debugReadChat.parsedStatus,
+      returnedStatus: debugReadChat.returnedStatus,
+      parsedMsgCount: debugReadChat.parsedMsgCount,
+      returnedMsgCount: debugReadChat.returnedMsgCount,
+      shouldPreferAdapterMessages: debugReadChat.shouldPreferAdapterMessages
+    } : void 0,
     hasFrontendSnapshot: !!frontend
   };
 }
@@ -12077,7 +12373,7 @@ function storeChatDebugBundleOnDaemon(bundle, targetSessionId) {
   const bundleId = createChatDebugBundleId(targetSessionId);
   const dir = getChatDebugBundleDir();
   fs4.mkdirSync(dir, { recursive: true });
-  const savedPath = path11.join(dir, `${bundleId}.json`);
+  const savedPath = path12.join(dir, `${bundleId}.json`);
   const json = `${JSON.stringify(bundle, null, 2)}
 `;
   fs4.writeFileSync(savedPath, json, { encoding: "utf8", mode: 384 });
@@ -12307,7 +12603,7 @@ async function handleChatHistory(h, args) {
   }
 }
 async function handleReadChat(h, args) {
-  const provider = h.getProvider(args?.agentType);
+  const provider = h.getProvider(args?.agentType || args?.providerType);
   const transport = getTargetTransport(h, provider);
   const historySessionId = getHistorySessionId(h, args);
   const _log = (msg) => LOG.debug("Command", `[read_chat] ${msg}`);
@@ -12334,10 +12630,13 @@ async function handleReadChat(h, args) {
       const transcriptAuthority = parsedRecord.transcriptAuthority === "provider" || parsedRecord.transcriptAuthority === "daemon" ? parsedRecord.transcriptAuthority : void 0;
       const coverage = parsedRecord.coverage === "full" || parsedRecord.coverage === "tail" || parsedRecord.coverage === "current-turn" ? parsedRecord.coverage : void 0;
       const activeModal = parsedRecord.activeModal ?? parsedRecord.modal ?? null;
-      const returnedStatus = parsedRecord.status || "idle";
-      LOG.debug("Command", `[read_chat] cli-like parsed provider=${adapter.cliType} target=${String(args?.targetSessionId || "")} adapterStatus=${String(adapterStatus.status || "")} parsedStatus=${String(parsedRecord.status || "")} parsedMsgCount=${parsedRecord.messages.length}`);
+      const returnedStatus = normalizeCliReadChatStatus(parsedRecord.status, activeModal, adapter, adapterStatus);
+      const runtimeMessageMerger = getTargetInstance(h, args);
+      const parsedMessages = finalizeStreamingMessagesWhenIdle(parsedRecord.messages, returnedStatus);
+      const returnedMessages = runtimeMessageMerger?.category === "cli" && runtimeMessageMerger.type === adapter.cliType && typeof runtimeMessageMerger.mergeRuntimeChatMessages === "function" ? runtimeMessageMerger.mergeRuntimeChatMessages(parsedMessages) : parsedMessages;
+      LOG.debug("Command", `[read_chat] cli-like parsed provider=${adapter.cliType} target=${String(args?.targetSessionId || "")} adapterStatus=${String(adapterStatus.status || "")} parsedStatus=${String(parsedRecord.status || "")} parsedMsgCount=${parsedRecord.messages.length} returnedMsgCount=${returnedMessages.length}`);
       return buildReadChatCommandResult({
-        messages: parsedRecord.messages,
+        messages: returnedMessages,
         status: returnedStatus,
         activeModal,
         debugReadChat: {
@@ -12348,7 +12647,7 @@ async function handleReadChat(h, args) {
           returnedStatus: String(returnedStatus || ""),
           shouldPreferAdapterMessages: false,
           parsedMsgCount: parsedRecord.messages.length,
-          returnedMsgCount: parsedRecord.messages.length
+          returnedMsgCount: returnedMessages.length
         },
         ...title ? { title } : {},
         ...providerSessionId ? { providerSessionId } : {},
@@ -12594,6 +12893,7 @@ async function handleSendChat(h, args) {
       try {
         assertTextOnlyInput(provider, input);
         if (!text) return { success: false, error: "text required for PTY send" };
+        await waitOnceForFreshHermesCliStart(adapter, _log);
         await adapter.sendMessage(text);
         return _logSendSuccess(`${transport}-adapter`, adapter.cliType);
       } catch (e) {
@@ -13093,9 +13393,17 @@ async function handleResolveAction(h, args) {
     const targetState = targetInstance?.getState?.();
     const surfacedModal = targetState?.activeChat?.activeModal && Array.isArray(targetState.activeChat.activeModal.buttons) && targetState.activeChat.activeModal.buttons.some((candidate) => typeof candidate === "string" && candidate.trim()) ? targetState.activeChat.activeModal : null;
     const statusModal = status?.activeModal && Array.isArray(status.activeModal.buttons) && status.activeModal.buttons.some((candidate) => typeof candidate === "string" && candidate.trim()) ? status.activeModal : null;
-    const effectiveModal = statusModal || surfacedModal;
-    const effectiveStatus = status?.status === "waiting_approval" || targetState?.activeChat?.status === "waiting_approval" ? "waiting_approval" : status?.status;
-    LOG.info("Command", `[resolveAction] CLI PTY gate target=${String(args?.targetSessionId || "")} rawStatus=${String(status?.status || "")} effectiveStatus=${String(effectiveStatus || "")} statusModal=${statusModal ? "yes" : "no"} surfacedModal=${surfacedModal ? "yes" : "no"} instance=${targetInstance ? "yes" : "no"}`);
+    const parsedStatus = !statusModal && !surfacedModal && typeof adapter.getScriptParsedStatus === "function" ? (() => {
+      try {
+        return parseMaybeJson(adapter.getScriptParsedStatus());
+      } catch {
+        return null;
+      }
+    })() : null;
+    const parsedModal = parsedStatus?.status === "waiting_approval" && parsedStatus?.activeModal && Array.isArray(parsedStatus.activeModal.buttons) && parsedStatus.activeModal.buttons.some((candidate) => typeof candidate === "string" && candidate.trim()) ? parsedStatus.activeModal : null;
+    const effectiveModal = statusModal || surfacedModal || parsedModal;
+    const effectiveStatus = status?.status === "waiting_approval" || targetState?.activeChat?.status === "waiting_approval" || parsedStatus?.status === "waiting_approval" ? "waiting_approval" : status?.status;
+    LOG.info("Command", `[resolveAction] CLI PTY gate target=${String(args?.targetSessionId || "")} rawStatus=${String(status?.status || "")} effectiveStatus=${String(effectiveStatus || "")} statusModal=${statusModal ? "yes" : "no"} surfacedModal=${surfacedModal ? "yes" : "no"} parsedModal=${parsedModal ? "yes" : "no"} instance=${targetInstance ? "yes" : "no"}`);
     if (!effectiveModal) {
       return { success: false, error: "Not in approval state" };
     }
@@ -13221,7 +13529,7 @@ async function handleResolveAction(h, args) {
 
 // src/commands/cdp-commands.ts
 var fs5 = __toESM(require("fs"));
-var path12 = __toESM(require("path"));
+var path13 = __toESM(require("path"));
 var os7 = __toESM(require("os"));
 var KEY_TO_VK = {
   Backspace: 8,
@@ -13478,25 +13786,25 @@ function resolveSafePath(requestedPath) {
   const inputPath = rawPath || ".";
   const home = os7.homedir();
   if (inputPath.startsWith("~")) {
-    return path12.resolve(path12.join(home, inputPath.slice(1)));
+    return path13.resolve(path13.join(home, inputPath.slice(1)));
   }
   if (process.platform === "win32") {
     const normalized = normalizeWindowsRequestedPath(inputPath);
-    if (path12.win32.isAbsolute(normalized)) {
-      return path12.win32.normalize(normalized);
+    if (path13.win32.isAbsolute(normalized)) {
+      return path13.win32.normalize(normalized);
     }
-    return path12.win32.resolve(normalized);
+    return path13.win32.resolve(normalized);
   }
-  if (path12.isAbsolute(inputPath)) {
-    return path12.normalize(inputPath);
+  if (path13.isAbsolute(inputPath)) {
+    return path13.normalize(inputPath);
   }
-  return path12.resolve(inputPath);
+  return path13.resolve(inputPath);
 }
 function listDirectoryEntriesSafe(dirPath) {
   const entries = fs5.readdirSync(dirPath, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
-    const entryPath = path12.join(dirPath, entry.name);
+    const entryPath = path13.join(dirPath, entry.name);
     try {
       if (entry.isDirectory()) {
         files.push({ name: entry.name, type: "directory" });
@@ -13550,7 +13858,7 @@ async function handleFileRead(h, args) {
 async function handleFileWrite(h, args) {
   try {
     const filePath = resolveSafePath(args?.path);
-    fs5.mkdirSync(path12.dirname(filePath), { recursive: true });
+    fs5.mkdirSync(path13.dirname(filePath), { recursive: true });
     fs5.writeFileSync(filePath, args?.content || "", "utf-8");
     return { success: true, path: filePath };
   } catch (e) {
@@ -14334,9 +14642,11 @@ var DaemonCommandHandler = class {
     }
     const sessionLookupFailed = !!targetSessionId && !session;
     const managerKey = this.extractIdeType(args, sessionLookupFailed);
-    let providerType;
+    let providerType = args?.agentType || args?.providerType;
     if (!sessionLookupFailed) {
-      providerType = session?.providerType || args?.agentType || args?.providerType || this.inferProviderType(managerKey);
+      providerType = session?.providerType || providerType || this.inferProviderType(managerKey);
+    } else if (!providerType) {
+      providerType = this.inferProviderType(managerKey);
     }
     return { session, managerKey, providerType, sessionLookupFailed };
   }
@@ -14416,7 +14726,8 @@ var DaemonCommandHandler = class {
       "pty_resize",
       "invoke_provider_script"
     ]);
-    if (this._currentRoute.sessionLookupFailed && sessionScopedCommands.has(cmd)) {
+    const allowsInactiveReadChatFallback = cmd === "read_chat" && !!this._currentRoute.providerType && (typeof args?.providerSessionId === "string" && args.providerSessionId.trim().length > 0 || typeof args?.historySessionId === "string" && args.historySessionId.trim().length > 0);
+    if (this._currentRoute.sessionLookupFailed && sessionScopedCommands.has(cmd) && !allowsInactiveReadChatFallback) {
       const result2 = {
         success: false,
         error: `Live session not found for targetSessionId: ${String(args?.targetSessionId || "").trim() || "unknown"}`
@@ -14669,7 +14980,7 @@ var DaemonCommandHandler = class {
 
 // src/commands/cli-manager.ts
 var os13 = __toESM(require("os"));
-var path16 = __toESM(require("path"));
+var path17 = __toESM(require("path"));
 var crypto4 = __toESM(require("crypto"));
 var import_fs6 = require("fs");
 var import_child_process6 = require("child_process");
@@ -14679,7 +14990,7 @@ init_config();
 
 // src/providers/cli-provider-instance.ts
 var os12 = __toESM(require("os"));
-var path15 = __toESM(require("path"));
+var path16 = __toESM(require("path"));
 var crypto3 = __toESM(require("crypto"));
 var fs6 = __toESM(require("fs"));
 var import_node_module = require("module");
@@ -14738,7 +15049,7 @@ function buildIncrementalHistoryAppendMessages(previousMessages, currentMessages
 var CachedDatabaseSync = null;
 function getDatabaseSync() {
   if (CachedDatabaseSync) return CachedDatabaseSync;
-  const requireFn = typeof require === "function" ? require : (0, import_node_module.createRequire)(path15.join(process.cwd(), "__adhdev_sqlite_loader__.js"));
+  const requireFn = typeof require === "function" ? require : (0, import_node_module.createRequire)(path16.join(process.cwd(), "__adhdev_sqlite_loader__.js"));
   const sqliteModule = requireFn(`node:${"sqlite"}`);
   CachedDatabaseSync = sqliteModule.DatabaseSync;
   if (!CachedDatabaseSync) {
@@ -14791,7 +15102,7 @@ var CliProviderInstance = class {
     this.providerSessionId = options?.providerSessionId;
     this.launchMode = options?.launchMode || "new";
     this.onProviderSessionResolved = options?.onProviderSessionResolved;
-    this.adapter = new ProviderCliAdapter(provider, workingDir, cliArgs, transportFactory);
+    this.adapter = new ProviderCliAdapter(provider, workingDir, cliArgs, options?.extraEnv || {}, transportFactory);
     this.monitor = new StatusMonitor();
     this.historyWriter = new ChatHistoryWriter();
   }
@@ -15268,7 +15579,19 @@ var CliProviderInstance = class {
     }
   }
   pushEvent(event) {
-    this.events.push(event);
+    const enrichedEvent = {
+      ...event,
+      instanceId: typeof event.instanceId === "string" && event.instanceId.trim() ? event.instanceId : this.instanceId,
+      targetSessionId: typeof event.targetSessionId === "string" && event.targetSessionId.trim() ? event.targetSessionId : this.instanceId,
+      providerType: typeof event.providerType === "string" && event.providerType.trim() ? event.providerType : this.type,
+      workspaceName: typeof event.workspaceName === "string" && event.workspaceName.trim() ? event.workspaceName : this.workingDir,
+      providerSessionId: typeof event.providerSessionId === "string" && event.providerSessionId.trim() ? event.providerSessionId : this.providerSessionId
+    };
+    if (this.context?.emitProviderEvent) {
+      this.context.emitProviderEvent(enrichedEvent);
+      return;
+    }
+    this.events.push(enrichedEvent);
   }
   flushEvents() {
     const events = [...this.events];
@@ -15475,12 +15798,59 @@ ${effect.notification.body || ""}`.trim();
       );
     }
   }
+  mergeRuntimeChatMessages(parsedMessages) {
+    return this.mergeConversationMessages(parsedMessages);
+  }
   mergeConversationMessages(parsedMessages) {
     if (this.runtimeMessages.length === 0) return normalizeChatMessages(parsedMessages);
-    return normalizeChatMessages([...parsedMessages, ...this.runtimeMessages.map((entry) => entry.message)].map((message, index) => ({ message, index })).sort((a, b) => {
-      const aTime = a.message.receivedAt || a.message.timestamp || 0;
-      const bTime = b.message.receivedAt || b.message.timestamp || 0;
-      if (aTime !== bTime) return aTime - bTime;
+    const parsedEntries = parsedMessages.map((message, index) => ({
+      message,
+      index,
+      source: "parsed"
+    }));
+    const runtimeEntries = this.runtimeMessages.map((entry, index) => ({
+      message: entry.message,
+      index: parsedMessages.length + index,
+      source: "runtime",
+      runtimeKey: entry.key
+    }));
+    const getTime = (message) => {
+      const value = typeof message.receivedAt === "number" ? message.receivedAt : typeof message.timestamp === "number" ? message.timestamp : 0;
+      return Number.isFinite(value) && value > 0 ? value : 0;
+    };
+    const getRole = (message) => typeof message.role === "string" ? message.role.trim().toLowerCase() : "";
+    const isRuntimeOverlay = (entry) => {
+      if (entry.source !== "runtime") return false;
+      const key = typeof entry.runtimeKey === "string" ? entry.runtimeKey.trim().toLowerCase() : "";
+      if (key.startsWith("auto_approval:")) return true;
+      return !isUserFacingChatMessage(entry.message);
+    };
+    const shouldKeepParsedBeforeUntimedRuntime = (message) => {
+      const role = getRole(message);
+      return role === "user" || role === "human";
+    };
+    const shouldKeepParsedAfterUntimedRuntime = (message) => {
+      const role = getRole(message);
+      if (role !== "assistant") return false;
+      const kind = resolveChatMessageKind(message);
+      return kind === "standard" || kind === "terminal";
+    };
+    return normalizeChatMessages([...parsedEntries, ...runtimeEntries].sort((a, b) => {
+      const aTime = getTime(a.message);
+      const bTime = getTime(b.message);
+      if (aTime && bTime && aTime !== bTime) return aTime - bTime;
+      if (a.source !== b.source && aTime !== bTime) {
+        const parsedEntry = a.source === "parsed" ? a : b.source === "parsed" ? b : null;
+        const runtimeEntry = a.source === "runtime" ? a : b.source === "runtime" ? b : null;
+        if (parsedEntry && runtimeEntry && isRuntimeOverlay(runtimeEntry) && getTime(parsedEntry.message) === 0 && getTime(runtimeEntry.message) > 0) {
+          if (shouldKeepParsedBeforeUntimedRuntime(parsedEntry.message)) {
+            return a.source === "parsed" ? -1 : 1;
+          }
+          if (shouldKeepParsedAfterUntimedRuntime(parsedEntry.message)) {
+            return a.source === "parsed" ? 1 : -1;
+          }
+        }
+      }
       return a.index - b.index;
     }).map((entry) => entry.message));
   }
@@ -16804,11 +17174,11 @@ function shouldRestoreHostedRuntime(record, managerTag) {
 // src/commands/cli-manager.ts
 function isExplicitCommand(command) {
   const trimmed = command.trim();
-  return path16.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~");
+  return path17.isAbsolute(trimmed) || trimmed.includes("/") || trimmed.includes("\\") || trimmed.startsWith("~");
 }
 function expandExecutable(command) {
   const trimmed = command.trim();
-  return trimmed.startsWith("~") ? path16.join(os13.homedir(), trimmed.slice(1)) : trimmed;
+  return trimmed.startsWith("~") ? path17.join(os13.homedir(), trimmed.slice(1)) : trimmed;
 }
 function commandExists(command) {
   const trimmed = command.trim();
@@ -16832,6 +17202,35 @@ function colorize(color, text) {
   const fn = chalkApi?.[color];
   return typeof fn === "function" ? fn(text) : text;
 }
+var COORDINATOR_DELEGATED_ENV_UNSETS = {
+  ADHDEV_INLINE_MESH: "",
+  ADHDEV_MCP_TRANSPORT: "",
+  ADHDEV_MESH_ID: "",
+  HERMES_EPHEMERAL_SYSTEM_PROMPT: ""
+};
+function hasCliArg(args, flag) {
+  return args.some((arg) => arg === flag || arg.startsWith(`${flag}=`));
+}
+function ensureEmptyDelegatedMcpConfig(workspace) {
+  const baseDir = path17.join(os13.tmpdir(), "adhdev-delegated-agent-empty-mcp");
+  (0, import_fs6.mkdirSync)(baseDir, { recursive: true });
+  const workspaceHash = crypto4.createHash("sha256").update(path17.resolve(workspace || os13.tmpdir())).digest("hex").slice(0, 16);
+  const filePath = path17.join(baseDir, `${workspaceHash}.json`);
+  (0, import_fs6.writeFileSync)(filePath, JSON.stringify({ mcpServers: {} }, null, 2), "utf-8");
+  return filePath;
+}
+function buildCoordinatorDelegatedCliLaunchOptions(input) {
+  const cliType = String(input.cliType || "").trim();
+  const cliArgs = Array.isArray(input.cliArgs) ? [...input.cliArgs] : [];
+  const env = { ...input.env || {}, ...COORDINATOR_DELEGATED_ENV_UNSETS };
+  if (cliType === "hermes-cli" && !hasCliArg(cliArgs, "--ignore-user-config")) {
+    cliArgs.unshift("--ignore-user-config");
+  }
+  if (cliType === "claude-cli" && !hasCliArg(cliArgs, "--mcp-config")) {
+    cliArgs.unshift("--mcp-config", ensureEmptyDelegatedMcpConfig(input.workspace));
+  }
+  return { cliArgs, env };
+}
 function isUuid(value) {
   return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);
 }
@@ -17002,7 +17401,7 @@ var DaemonCliManager = class {
       attachExisting
     }) || void 0;
   }
-  createAdapter(cliType, workingDir, cliArgs, runtimeId, providerSessionId, attachExisting = false) {
+  createAdapter(cliType, workingDir, cliArgs, runtimeId, providerSessionId, attachExisting = false, extraEnv) {
     const normalizedType = this.providerLoader.resolveAlias(cliType);
     const provider = this.providerLoader.getMeta(normalizedType);
     if (provider && provider.category === "cli" && provider.patterns && provider.spawn) {
@@ -17016,7 +17415,7 @@ var DaemonCliManager = class {
         providerSessionId,
         attachExisting
       );
-      return new ProviderCliAdapter(resolvedProvider, workingDir, cliArgs, transportFactory);
+      return new ProviderCliAdapter(resolvedProvider, workingDir, cliArgs, extraEnv || {}, transportFactory);
     }
     throw new Error(`No CLI provider found for '${cliType}'. Create a provider.js in providers/cli/${cliType}/`);
   }
@@ -17089,7 +17488,7 @@ var DaemonCliManager = class {
   async startSession(cliType, workingDir, cliArgs, initialModel, options) {
     const trimmed = (workingDir || "").trim();
     if (!trimmed) throw new Error("working directory required");
-    const resolvedDir = trimmed.startsWith("~") ? trimmed.replace(/^~/, os13.homedir()) : path16.resolve(trimmed);
+    const resolvedDir = trimmed.startsWith("~") ? trimmed.replace(/^~/, os13.homedir()) : path17.resolve(trimmed);
     const normalizedType = this.providerLoader.resolveAlias(cliType);
     const rawProvider = this.providerLoader.getByAlias(cliType);
     const provider = rawProvider ? this.providerLoader.resolve(normalizedType) || rawProvider : void 0;
@@ -17219,6 +17618,7 @@ Run 'adhdev doctor' for detailed diagnostics.`
         {
           providerSessionId: sessionBinding.providerSessionId,
           launchMode: sessionBinding.launchMode,
+          extraEnv: options?.extraEnv,
           onProviderSessionResolved: ({ providerSessionId, providerName, providerType, workspace }) => {
             this.persistRecentActivity({
               kind: "cli",
@@ -17239,7 +17639,8 @@ Run 'adhdev doctor' for detailed diagnostics.`
         resolvedCliArgs,
         key,
         sessionBinding.providerSessionId,
-        false
+        false,
+        options?.extraEnv
       );
       try {
         await adapter.spawn();
@@ -17463,12 +17864,23 @@ Run 'adhdev doctor' for detailed diagnostics.`
         const dir = resolved.path;
         const launchSource = resolved.source;
         if (!cliType) throw new Error("cliType required");
+        const settingsOverride = args?.settings && typeof args.settings === "object" ? args.settings : void 0;
+        const delegatedLaunch = settingsOverride?.launchedByCoordinator === true ? buildCoordinatorDelegatedCliLaunchOptions({
+          cliType,
+          workspace: dir,
+          cliArgs: args?.cliArgs,
+          env: args?.env
+        }) : null;
         const started = await this.startSession(
           cliType,
           dir,
-          args?.cliArgs,
+          delegatedLaunch ? delegatedLaunch.cliArgs : args?.cliArgs,
           args?.initialModel,
-          { resumeSessionId: args?.resumeSessionId, settingsOverride: args?.settings }
+          {
+            resumeSessionId: args?.resumeSessionId,
+            settingsOverride,
+            extraEnv: delegatedLaunch ? delegatedLaunch.env : args?.env
+          }
         );
         return {
           success: true,
@@ -17590,11 +18002,11 @@ Run 'adhdev doctor' for detailed diagnostics.`
 var import_child_process7 = require("child_process");
 var net = __toESM(require("net"));
 var os15 = __toESM(require("os"));
-var path18 = __toESM(require("path"));
+var path19 = __toESM(require("path"));
 
 // src/providers/provider-loader.ts
 var fs7 = __toESM(require("fs"));
-var path17 = __toESM(require("path"));
+var path18 = __toESM(require("path"));
 var os14 = __toESM(require("os"));
 var chokidar = __toESM(require("chokidar"));
 init_logger();
@@ -17918,7 +18330,7 @@ var ProviderLoader = class _ProviderLoader {
     try {
       if (!fs7.existsSync(candidate) || !fs7.statSync(candidate).isDirectory()) return false;
       return ["ide", "extension", "cli", "acp"].some(
-        (category) => fs7.existsSync(path17.join(candidate, category))
+        (category) => fs7.existsSync(path18.join(candidate, category))
       );
     } catch {
       return false;
@@ -17926,20 +18338,20 @@ var ProviderLoader = class _ProviderLoader {
   }
   static hasProviderRootMarker(candidate) {
     try {
-      return fs7.existsSync(path17.join(candidate, _ProviderLoader.SIBLING_MARKER_FILE));
+      return fs7.existsSync(path18.join(candidate, _ProviderLoader.SIBLING_MARKER_FILE));
     } catch {
       return false;
     }
   }
   detectDefaultUserDir() {
-    const fallback = path17.join(os14.homedir(), ".adhdev", "providers");
+    const fallback = path18.join(os14.homedir(), ".adhdev", "providers");
     const envOptIn = process.env[_ProviderLoader.SIBLING_ENV_VAR] === "1";
     const visited = /* @__PURE__ */ new Set();
     for (const start of this.probeStarts) {
-      let current = path17.resolve(start);
+      let current = path18.resolve(start);
       while (!visited.has(current)) {
         visited.add(current);
-        const siblingCandidate = path17.join(path17.dirname(current), _ProviderLoader.REPO_PROVIDER_DIRNAME);
+        const siblingCandidate = path18.join(path18.dirname(current), _ProviderLoader.REPO_PROVIDER_DIRNAME);
         if (_ProviderLoader.looksLikeProviderRoot(siblingCandidate)) {
           const hasMarker = _ProviderLoader.hasProviderRootMarker(siblingCandidate);
           if (envOptIn || hasMarker) {
@@ -17961,7 +18373,7 @@ var ProviderLoader = class _ProviderLoader {
             return { path: siblingCandidate, source };
           }
         }
-        const parent = path17.dirname(current);
+        const parent = path18.dirname(current);
         if (parent === current) break;
         current = parent;
       }
@@ -17971,11 +18383,11 @@ var ProviderLoader = class _ProviderLoader {
   constructor(options) {
     this.logFn = options?.logFn || LOG.forComponent("Provider").asLogFn();
     this.probeStarts = options?.probeStarts ?? [process.cwd(), __dirname];
-    this.defaultProvidersDir = path17.join(os14.homedir(), ".adhdev", "providers");
+    this.defaultProvidersDir = path18.join(os14.homedir(), ".adhdev", "providers");
     const detected = this.detectDefaultUserDir();
     this.userDir = detected.path;
     this.userDirSource = detected.source;
-    this.upstreamDir = path17.join(this.defaultProvidersDir, ".upstream");
+    this.upstreamDir = path18.join(this.defaultProvidersDir, ".upstream");
     this.disableUpstream = false;
     this.applySourceConfig({
       userDir: options?.userDir,
@@ -18034,7 +18446,7 @@ var ProviderLoader = class _ProviderLoader {
       this.userDir = detected.path;
       this.userDirSource = detected.source;
     }
-    this.upstreamDir = path17.join(this.defaultProvidersDir, ".upstream");
+    this.upstreamDir = path18.join(this.defaultProvidersDir, ".upstream");
     this.disableUpstream = this.sourceMode === "no-upstream";
     if (this.explicitProviderDir) {
       this.log(`Config 'providerDir' applied: ${this.userDir}`);
@@ -18048,7 +18460,7 @@ var ProviderLoader = class _ProviderLoader {
   * Canonical provider directory shape for a given root.
   */
   getProviderDir(root, category, type) {
-    return path17.join(root, category, type);
+    return path18.join(root, category, type);
   }
   /**
   * Canonical user override directory for a provider.
@@ -18075,7 +18487,7 @@ var ProviderLoader = class _ProviderLoader {
   resolveProviderFile(type, ...segments) {
     const dir = this.findProviderDirInternal(type);
     if (!dir) return null;
-    return path17.join(dir, ...segments);
+    return path18.join(dir, ...segments);
   }
   /**
   * Load all providers (3-tier priority)
@@ -18114,7 +18526,7 @@ var ProviderLoader = class _ProviderLoader {
     if (!fs7.existsSync(this.upstreamDir)) return false;
     try {
       return fs7.readdirSync(this.upstreamDir).some(
-        (d) => fs7.statSync(path17.join(this.upstreamDir, d)).isDirectory()
+        (d) => fs7.statSync(path18.join(this.upstreamDir, d)).isDirectory()
       );
     } catch {
       return false;
@@ -18611,8 +19023,8 @@ var ProviderLoader = class _ProviderLoader {
               resolved._resolvedScriptDir = entry.scriptDir;
               resolved._resolvedScriptsSource = `compatibility:${entry.ideVersion}`;
               if (providerDir) {
-                const fullDir = path17.join(providerDir, entry.scriptDir);
-                resolved._resolvedScriptsPath = fs7.existsSync(path17.join(fullDir, "scripts.js")) ? path17.join(fullDir, "scripts.js") : fullDir;
+                const fullDir = path18.join(providerDir, entry.scriptDir);
+                resolved._resolvedScriptsPath = fs7.existsSync(path18.join(fullDir, "scripts.js")) ? path18.join(fullDir, "scripts.js") : fullDir;
               }
               matched = true;
             }
@@ -18627,8 +19039,8 @@ var ProviderLoader = class _ProviderLoader {
             resolved._resolvedScriptDir = base.defaultScriptDir;
             resolved._resolvedScriptsSource = "defaultScriptDir:version_miss";
             if (providerDir) {
-              const fullDir = path17.join(providerDir, base.defaultScriptDir);
-              resolved._resolvedScriptsPath = fs7.existsSync(path17.join(fullDir, "scripts.js")) ? path17.join(fullDir, "scripts.js") : fullDir;
+              const fullDir = path18.join(providerDir, base.defaultScriptDir);
+              resolved._resolvedScriptsPath = fs7.existsSync(path18.join(fullDir, "scripts.js")) ? path18.join(fullDir, "scripts.js") : fullDir;
             }
           }
           resolved._versionWarning = `Version ${currentVersion} not in compatibility matrix. Using default scripts.`;
@@ -18645,8 +19057,8 @@ var ProviderLoader = class _ProviderLoader {
               resolved._resolvedScriptDir = dirOverride;
               resolved._resolvedScriptsSource = `versions:${range}`;
               if (providerDir) {
-                const fullDir = path17.join(providerDir, dirOverride);
-                resolved._resolvedScriptsPath = fs7.existsSync(path17.join(fullDir, "scripts.js")) ? path17.join(fullDir, "scripts.js") : fullDir;
+                const fullDir = path18.join(providerDir, dirOverride);
+                resolved._resolvedScriptsPath = fs7.existsSync(path18.join(fullDir, "scripts.js")) ? path18.join(fullDir, "scripts.js") : fullDir;
               }
             }
           } else if (override.scripts) {
@@ -18662,8 +19074,8 @@ var ProviderLoader = class _ProviderLoader {
         resolved._resolvedScriptDir = base.defaultScriptDir;
         resolved._resolvedScriptsSource = "defaultScriptDir:no_version";
         if (providerDir) {
-          const fullDir = path17.join(providerDir, base.defaultScriptDir);
-          resolved._resolvedScriptsPath = fs7.existsSync(path17.join(fullDir, "scripts.js")) ? path17.join(fullDir, "scripts.js") : fullDir;
+          const fullDir = path18.join(providerDir, base.defaultScriptDir);
+          resolved._resolvedScriptsPath = fs7.existsSync(path18.join(fullDir, "scripts.js")) ? path18.join(fullDir, "scripts.js") : fullDir;
         }
       }
     }
@@ -18695,14 +19107,14 @@ var ProviderLoader = class _ProviderLoader {
       this.log(`  [loadScriptsFromDir] ${type}: providerDir not found`);
       return null;
     }
-    const dir = path17.join(providerDir, scriptDir);
+    const dir = path18.join(providerDir, scriptDir);
     if (!fs7.existsSync(dir)) {
       this.log(`  [loadScriptsFromDir] ${type}: dir not found: ${dir}`);
       return null;
     }
     const cached = this.scriptsCache.get(dir);
     if (cached) return cached;
-    const scriptsJs = path17.join(dir, "scripts.js");
+    const scriptsJs = path18.join(dir, "scripts.js");
     if (fs7.existsSync(scriptsJs)) {
       try {
         delete require.cache[require.resolve(scriptsJs)];
@@ -18744,7 +19156,7 @@ var ProviderLoader = class _ProviderLoader {
             return;
           }
           if (filePath.endsWith(".js") || filePath.endsWith(".json")) {
-            this.log(`File changed: ${path17.basename(filePath)}, reloading...`);
+            this.log(`File changed: ${path18.basename(filePath)}, reloading...`);
             this.reload();
           }
         };
@@ -18799,7 +19211,7 @@ var ProviderLoader = class _ProviderLoader {
     }
     const https = require("https");
     const { execSync: execSync7 } = require("child_process");
-    const metaPath = path17.join(this.upstreamDir, _ProviderLoader.META_FILE);
+    const metaPath = path18.join(this.upstreamDir, _ProviderLoader.META_FILE);
     let prevEtag = "";
     let prevTimestamp = 0;
     try {
@@ -18859,17 +19271,17 @@ var ProviderLoader = class _ProviderLoader {
         return { updated: false };
       }
       this.log("Downloading latest providers from GitHub...");
-      const tmpTar = path17.join(os14.tmpdir(), `adhdev-providers-${Date.now()}.tar.gz`);
-      const tmpExtract = path17.join(os14.tmpdir(), `adhdev-providers-extract-${Date.now()}`);
+      const tmpTar = path18.join(os14.tmpdir(), `adhdev-providers-${Date.now()}.tar.gz`);
+      const tmpExtract = path18.join(os14.tmpdir(), `adhdev-providers-extract-${Date.now()}`);
       await this.downloadFile(_ProviderLoader.GITHUB_TARBALL_URL, tmpTar);
       fs7.mkdirSync(tmpExtract, { recursive: true });
       execSync7(`tar -xzf "${tmpTar}" -C "${tmpExtract}"`, { timeout: 3e4 });
       const extracted = fs7.readdirSync(tmpExtract);
       const rootDir = extracted.find(
-        (d) => fs7.statSync(path17.join(tmpExtract, d)).isDirectory() && d.startsWith("adhdev-providers")
+        (d) => fs7.statSync(path18.join(tmpExtract, d)).isDirectory() && d.startsWith("adhdev-providers")
       );
       if (!rootDir) throw new Error("Unexpected tarball structure");
-      const sourceDir = path17.join(tmpExtract, rootDir);
+      const sourceDir = path18.join(tmpExtract, rootDir);
       const backupDir = this.upstreamDir + ".bak";
       if (fs7.existsSync(this.upstreamDir)) {
         if (fs7.existsSync(backupDir)) fs7.rmSync(backupDir, { recursive: true, force: true });
@@ -18944,8 +19356,8 @@ var ProviderLoader = class _ProviderLoader {
   copyDirRecursive(src, dest) {
     fs7.mkdirSync(dest, { recursive: true });
     for (const entry of fs7.readdirSync(src, { withFileTypes: true })) {
-      const srcPath = path17.join(src, entry.name);
-      const destPath = path17.join(dest, entry.name);
+      const srcPath = path18.join(src, entry.name);
+      const destPath = path18.join(dest, entry.name);
       if (entry.isDirectory()) {
         this.copyDirRecursive(srcPath, destPath);
       } else {
@@ -18956,7 +19368,7 @@ var ProviderLoader = class _ProviderLoader {
   /** .meta.json save */
   writeMeta(metaPath, etag, timestamp) {
     try {
-      fs7.mkdirSync(path17.dirname(metaPath), { recursive: true });
+      fs7.mkdirSync(path18.dirname(metaPath), { recursive: true });
       fs7.writeFileSync(metaPath, JSON.stringify({
         etag,
         timestamp,
@@ -18973,7 +19385,7 @@ var ProviderLoader = class _ProviderLoader {
     const scan = (d) => {
       try {
         for (const entry of fs7.readdirSync(d, { withFileTypes: true })) {
-          if (entry.isDirectory()) scan(path17.join(d, entry.name));
+          if (entry.isDirectory()) scan(path18.join(d, entry.name));
           else if (entry.name === "provider.json") count++;
         }
       } catch {
@@ -19201,17 +19613,17 @@ var ProviderLoader = class _ProviderLoader {
     for (const root of searchRoots) {
       if (!fs7.existsSync(root)) continue;
       const candidate = this.getProviderDir(root, cat, type);
-      if (fs7.existsSync(path17.join(candidate, "provider.json"))) return candidate;
-      const catDir = path17.join(root, cat);
+      if (fs7.existsSync(path18.join(candidate, "provider.json"))) return candidate;
+      const catDir = path18.join(root, cat);
       if (fs7.existsSync(catDir)) {
         try {
           for (const entry of fs7.readdirSync(catDir, { withFileTypes: true })) {
             if (!entry.isDirectory()) continue;
-            const jsonPath = path17.join(catDir, entry.name, "provider.json");
+            const jsonPath = path18.join(catDir, entry.name, "provider.json");
             if (fs7.existsSync(jsonPath)) {
               try {
                 const data = JSON.parse(fs7.readFileSync(jsonPath, "utf-8"));
-                if (data.type === type) return path17.join(catDir, entry.name);
+                if (data.type === type) return path18.join(catDir, entry.name);
               } catch {
               }
             }
@@ -19228,7 +19640,7 @@ var ProviderLoader = class _ProviderLoader {
    * (template substitution is NOT applied here — scripts.js handles that)
    */
   buildScriptWrappersFromDir(dir) {
-    const scriptsJs = path17.join(dir, "scripts.js");
+    const scriptsJs = path18.join(dir, "scripts.js");
     if (fs7.existsSync(scriptsJs)) {
       try {
         delete require.cache[require.resolve(scriptsJs)];
@@ -19242,7 +19654,7 @@ var ProviderLoader = class _ProviderLoader {
       for (const file of fs7.readdirSync(dir)) {
         if (!file.endsWith(".js")) continue;
         const scriptName = toCamel(file.replace(".js", ""));
-        const filePath = path17.join(dir, file);
+        const filePath = path18.join(dir, file);
         result[scriptName] = (...args) => {
           try {
             let content = fs7.readFileSync(filePath, "utf-8");
@@ -19302,7 +19714,7 @@ var ProviderLoader = class _ProviderLoader {
       }
       const hasJson = entries.some((e) => e.name === "provider.json");
       if (hasJson) {
-        const jsonPath = path17.join(d, "provider.json");
+        const jsonPath = path18.join(d, "provider.json");
         try {
           const raw = fs7.readFileSync(jsonPath, "utf-8");
           const mod = JSON.parse(raw);
@@ -19323,7 +19735,7 @@ var ProviderLoader = class _ProviderLoader {
             this.log(`\u26A0 Invalid provider at ${jsonPath}: ${validation.errors.join("; ")}`);
           } else {
             const hasCompatibility = Array.isArray(normalizedProvider.compatibility);
-            const scriptsPath = path17.join(d, "scripts.js");
+            const scriptsPath = path18.join(d, "scripts.js");
             if (!hasCompatibility && fs7.existsSync(scriptsPath)) {
               try {
                 delete require.cache[require.resolve(scriptsPath)];
@@ -19349,7 +19761,7 @@ var ProviderLoader = class _ProviderLoader {
           if (!entry.isDirectory()) continue;
           if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
           if (excludeDirs && d === dir && excludeDirs.includes(entry.name)) continue;
-          scan(path17.join(d, entry.name));
+          scan(path18.join(d, entry.name));
         }
       }
     };
@@ -19674,8 +20086,8 @@ function detectCurrentWorkspace(ideId) {
       const appNameMap = getMacAppIdentifiers();
       const appName = appNameMap[ideId];
       if (appName) {
-        const storagePath = path18.join(
-          process.env.APPDATA || path18.join(os15.homedir(), "AppData", "Roaming"),
+        const storagePath = path19.join(
+          process.env.APPDATA || path19.join(os15.homedir(), "AppData", "Roaming"),
           appName,
           "storage.json"
         );
@@ -19864,9 +20276,9 @@ init_logger();
 
 // src/logging/command-log.ts
 var fs8 = __toESM(require("fs"));
-var path19 = __toESM(require("path"));
+var path20 = __toESM(require("path"));
 var os16 = __toESM(require("os"));
-var LOG_DIR2 = process.platform === "win32" ? path19.join(process.env.LOCALAPPDATA || process.env.APPDATA || path19.join(os16.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path19.join(os16.homedir(), "Library", "Logs", "adhdev") : path19.join(os16.homedir(), ".local", "share", "adhdev", "logs");
+var LOG_DIR2 = process.platform === "win32" ? path20.join(process.env.LOCALAPPDATA || process.env.APPDATA || path20.join(os16.homedir(), "AppData", "Local"), "adhdev", "logs") : process.platform === "darwin" ? path20.join(os16.homedir(), "Library", "Logs", "adhdev") : path20.join(os16.homedir(), ".local", "share", "adhdev", "logs");
 var MAX_FILE_SIZE = 5 * 1024 * 1024;
 var MAX_DAYS = 7;
 try {
@@ -19904,13 +20316,13 @@ function getDateStr2() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 }
 var currentDate2 = getDateStr2();
-var currentFile = path19.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
+var currentFile = path20.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
 var writeCount2 = 0;
 function checkRotation() {
   const today = getDateStr2();
   if (today !== currentDate2) {
     currentDate2 = today;
-    currentFile = path19.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
+    currentFile = path20.join(LOG_DIR2, `commands-${currentDate2}.jsonl`);
     cleanOldFiles();
   }
 }
@@ -19924,7 +20336,7 @@ function cleanOldFiles() {
       const dateMatch = file.match(/commands-(\d{4}-\d{2}-\d{2})/);
       if (dateMatch && dateMatch[1] < cutoffStr) {
         try {
-          fs8.unlinkSync(path19.join(LOG_DIR2, file));
+          fs8.unlinkSync(path20.join(LOG_DIR2, file));
         } catch {
         }
       }
@@ -20007,14 +20419,66 @@ function getRecentCommands(count = 50) {
 cleanOldFiles();
 
 // src/commands/router.ts
+var yaml = __toESM(require("js-yaml"));
 init_logger();
 
 // src/commands/mesh-coordinator.ts
-var import_node_fs2 = require("fs");
+var import_node_child_process3 = require("child_process");
+var import_node_fs3 = require("fs");
 var import_node_module2 = require("module");
+var os17 = __toESM(require("os"));
 var import_node_path = require("path");
 var DEFAULT_SERVER_NAME = "adhdev-mesh";
 var DEFAULT_ADHDEV_MCP_COMMAND = "adhdev-mcp";
+var HERMES_CLI_TYPE = "hermes-cli";
+var HERMES_MCP_CONFIG_PATH = "~/.hermes/config.yaml";
+function isHermesProvider(provider, cliType) {
+  const type = cliType?.trim() || provider?.type?.trim() || "";
+  return type === HERMES_CLI_TYPE;
+}
+function resolveHermesMeshCoordinatorSetup(options) {
+  const mcpServer = resolveAdhdevMcpServerLaunch({
+    meshId: options.meshId,
+    nodeExecutable: options.nodeExecutable,
+    adhdevMcpEntryPath: options.adhdevMcpEntryPath
+  });
+  if (!mcpServer) {
+    return {
+      kind: "unsupported",
+      reason: "Could not resolve the ADHDev MCP server entrypoint and a Node runtime with WebSocket support for daemon IPC mode"
+    };
+  }
+  const configPath = resolveMcpConfigPath(HERMES_MCP_CONFIG_PATH, options.workspace);
+  if (!configPath.trim()) {
+    return createHermesManualMeshCoordinatorSetup(options.meshId, options.workspace);
+  }
+  return {
+    kind: "auto_import",
+    serverName: DEFAULT_SERVER_NAME,
+    configPath,
+    configFormat: "hermes_config_yaml",
+    mcpServer
+  };
+}
+function createHermesManualMeshCoordinatorSetup(meshId, workspace) {
+  return {
+    kind: "manual",
+    serverName: DEFAULT_SERVER_NAME,
+    configFormat: "hermes_config_yaml",
+    configPathCommand: HERMES_MCP_CONFIG_PATH,
+    requiresRestart: true,
+    instructions: "Hermes CLI does not auto-import repo-local .mcp.json. Add this MCP server to Hermes config under mcp_servers, then start a fresh Hermes session.",
+    template: renderMeshCoordinatorTemplate(
+      "mcp_servers:\n  {{serverName}}:\n    command: {{adhdevMcpCommand}}\n    args:\n      - --repo-mesh\n      - {{meshId}}\n    enabled: true\n",
+      {
+        meshId,
+        workspace,
+        serverName: DEFAULT_SERVER_NAME,
+        adhdevMcpCommand: DEFAULT_ADHDEV_MCP_COMMAND
+      }
+    )
+  };
+}
 function resolveMeshCoordinatorSetup(options) {
   const { provider, meshId, workspace } = options;
   const config = provider?.meshCoordinator;
@@ -20024,6 +20488,9 @@ function resolveMeshCoordinatorSetup(options) {
       reason: config?.reason || "Provider does not declare Repo Mesh coordinator support"
     };
   }
+  if (isHermesProvider(provider, options.cliType)) {
+    return resolveHermesMeshCoordinatorSetup(options);
+  }
   const mcpConfig = config.mcpConfig;
   if (!mcpConfig || mcpConfig.mode === "none") {
     return {
@@ -20033,8 +20500,8 @@ function resolveMeshCoordinatorSetup(options) {
   }
   const serverName = mcpConfig.serverName?.trim() || DEFAULT_SERVER_NAME;
   if (mcpConfig.mode === "auto_import") {
-    const path26 = mcpConfig.path?.trim();
-    if (!path26) {
+    const path27 = mcpConfig.path?.trim();
+    if (!path27) {
       return { kind: "unsupported", reason: "Provider auto-import MCP config is missing a config path" };
     }
     const mcpServer = resolveAdhdevMcpServerLaunch({
@@ -20045,13 +20512,13 @@ function resolveMeshCoordinatorSetup(options) {
     if (!mcpServer) {
       return {
         kind: "unsupported",
-        reason: "Could not resolve the ADHDev MCP server entrypoint without relying on a PATH bin shim"
+        reason: "Could not resolve the ADHDev MCP server entrypoint and a Node runtime with WebSocket support for daemon IPC mode"
       };
     }
     return {
       kind: "auto_import",
       serverName,
-      configPath: (0, import_node_path.join)(workspace, path26),
+      configPath: resolveMcpConfigPath(path27, workspace),
       configFormat: mcpConfig.format,
       mcpServer
     };
@@ -20085,14 +20552,85 @@ function resolveMeshCoordinatorSetup(options) {
 function renderMeshCoordinatorTemplate(template, values) {
   return template.replace(/\{\{\s*(meshId|workspace|serverName|adhdevMcpCommand)\s*\}\}/g, (_, key) => values[key] || "");
 }
+function resolveMcpConfigPath(configPath, workspace) {
+  const trimmed = configPath.trim();
+  if (trimmed === "~") return os17.homedir();
+  if (trimmed.startsWith("~/")) return (0, import_node_path.join)(os17.homedir(), trimmed.slice(2));
+  if ((0, import_node_path.isAbsolute)(trimmed)) return trimmed;
+  return (0, import_node_path.join)(workspace, trimmed);
+}
 function resolveAdhdevMcpServerLaunch(options) {
   const entryPath = resolveAdhdevMcpEntryPath(options.adhdevMcpEntryPath);
   if (!entryPath) return null;
+  const nodeExecutable = resolveMcpNodeExecutable(options.nodeExecutable);
+  if (!nodeExecutable) return null;
   return {
-    command: options.nodeExecutable?.trim() || process.execPath,
+    command: nodeExecutable,
     args: [entryPath, "--mode", "ipc", "--repo-mesh", options.meshId]
   };
 }
+function resolveMcpNodeExecutable(explicitExecutable) {
+  const explicit = explicitExecutable?.trim();
+  if (explicit) return explicit;
+  const candidates = [];
+  const addCandidate = (candidate) => {
+    const trimmed = candidate?.trim();
+    if (!trimmed) return;
+    const normalized = normalizeExistingPath(trimmed) || trimmed;
+    if (!candidates.includes(normalized)) candidates.push(normalized);
+  };
+  addCandidate(process.env.ADHDEV_MCP_NODE_EXECUTABLE);
+  addCandidate(process.env.ADHDEV_NODE_EXECUTABLE);
+  addCandidate(process.env.npm_node_execpath);
+  addNodeCandidatesFromPath(process.env.PATH, addCandidate);
+  addNodeCandidatesFromNvm(os17.homedir(), addCandidate);
+  addCandidate("/opt/homebrew/bin/node");
+  addCandidate("/usr/local/bin/node");
+  addCandidate("/usr/bin/node");
+  addCandidate(process.execPath);
+  for (const candidate of candidates) {
+    if (nodeRuntimeSupportsWebSocket(candidate)) return candidate;
+  }
+  return null;
+}
+function addNodeCandidatesFromPath(pathValue, addCandidate) {
+  for (const entry of (pathValue || "").split(":")) {
+    const dir = entry.trim();
+    if (!dir) continue;
+    addCandidate((0, import_node_path.join)(dir, "node"));
+  }
+}
+function addNodeCandidatesFromNvm(homeDir, addCandidate) {
+  const versionsDir = (0, import_node_path.join)(homeDir, ".nvm", "versions", "node");
+  try {
+    const versionDirs = (0, import_node_fs3.readdirSync)(versionsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort(compareNodeVersionNamesDescending);
+    for (const versionDir of versionDirs) {
+      addCandidate((0, import_node_path.join)(versionsDir, versionDir, "bin", "node"));
+    }
+  } catch {
+  }
+}
+function compareNodeVersionNamesDescending(a, b) {
+  const parse = (value) => value.replace(/^v/, "").split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const left = parse(a);
+  const right = parse(b);
+  for (let i = 0; i < Math.max(left.length, right.length); i++) {
+    const diff = (right[i] || 0) - (left[i] || 0);
+    if (diff !== 0) return diff;
+  }
+  return b.localeCompare(a);
+}
+function nodeRuntimeSupportsWebSocket(nodeExecutable) {
+  try {
+    (0, import_node_child_process3.execFileSync)(nodeExecutable, ["-e", "process.exit(typeof WebSocket === 'function' ? 0 : 42)"], {
+      stdio: "ignore",
+      timeout: 3e3
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function resolveAdhdevMcpEntryPath(explicitPath) {
   const explicit = explicitPath?.trim();
   if (explicit) return normalizeExistingPath(explicit) || explicit;
@@ -20128,15 +20666,109 @@ function resolveAdhdevMcpEntryPath(explicitPath) {
 }
 function normalizeExistingPath(filePath) {
   try {
-    if (!(0, import_node_fs2.existsSync)(filePath)) return null;
-    return import_node_fs2.realpathSync.native(filePath);
+    if (!(0, import_node_fs3.existsSync)(filePath)) return null;
+    return import_node_fs3.realpathSync.native(filePath);
   } catch {
     return null;
   }
 }
 
+// src/mesh/mesh-events.ts
+init_mesh_config();
+init_logger();
+function readNonEmptyString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : "";
+}
+function formatCompletionMetadata(event) {
+  const parts = [
+    readNonEmptyString(event.targetSessionId) ? `session_id=${readNonEmptyString(event.targetSessionId)}` : "",
+    readNonEmptyString(event.providerType) ? `provider=${readNonEmptyString(event.providerType)}` : "",
+    readNonEmptyString(event.providerSessionId) ? `provider_session_id=${readNonEmptyString(event.providerSessionId)}` : ""
+  ].filter(Boolean);
+  return parts.length > 0 ? ` (${parts.join("; ")})` : "";
+}
+function buildMeshSystemMessage(args) {
+  const metadata = formatCompletionMetadata(args.metadataEvent);
+  if (args.event === "agent:generating_completed") {
+    return `[System] ${args.nodeLabel} has completed its task and is now idle${metadata}. This completion came from the agent status event path; use mesh_read_chat once to review its final progress, but do not poll repeatedly.`;
+  }
+  if (args.event === "agent:waiting_approval") {
+    return `[System] ${args.nodeLabel} is waiting for approval to proceed${metadata}. You may use mesh_read_chat and mesh_approve to handle it.`;
+  }
+  return "";
+}
+function injectMeshSystemMessage(components, args) {
+  const coordinatorInstances = components.instanceManager.getByCategory("cli").filter((inst) => {
+    const instState = inst.getState();
+    if (instState.settings?.meshCoordinatorFor !== args.meshId) return false;
+    if (args.sourceInstanceId && instState.instanceId === args.sourceInstanceId) return false;
+    return true;
+  });
+  if (coordinatorInstances.length === 0) return { success: true, forwarded: 0 };
+  const messageText = buildMeshSystemMessage({
+    event: args.event,
+    nodeLabel: args.nodeLabel,
+    metadataEvent: args.metadataEvent
+  });
+  if (!messageText) return { success: false, error: "unsupported mesh event" };
+  for (const coord of coordinatorInstances) {
+    const coordState = coord.getState();
+    LOG.info("MeshEvents", `Forwarding mesh event to coordinator ${coordState.instanceId}`);
+    coord.onEvent("send_message", { input: { text: messageText, textFallback: messageText } });
+  }
+  return { success: true, forwarded: coordinatorInstances.length };
+}
+function handleMeshForwardEvent(components, payload) {
+  const eventName = readNonEmptyString(payload.event);
+  if (eventName !== "agent:generating_completed" && eventName !== "agent:waiting_approval") {
+    return { success: false, error: "unsupported mesh event" };
+  }
+  const meshId = readNonEmptyString(payload.meshId);
+  if (!meshId) return { success: false, error: "meshId required" };
+  const nodeId = readNonEmptyString(payload.nodeId);
+  const workspace = readNonEmptyString(payload.workspace);
+  const nodeLabel = nodeId ? `Node '${nodeId}'` : workspace ? `Agent at ${workspace}` : "Remote agent";
+  return injectMeshSystemMessage(components, {
+    meshId,
+    nodeLabel,
+    event: eventName,
+    metadataEvent: {
+      targetSessionId: readNonEmptyString(payload.targetSessionId) || readNonEmptyString(payload.sessionId),
+      providerType: readNonEmptyString(payload.providerType),
+      providerSessionId: readNonEmptyString(payload.providerSessionId)
+    }
+  });
+}
+function setupMeshEventForwarding(components) {
+  components.instanceManager.onEvent((event) => {
+    if (event.event !== "agent:generating_completed" && event.event !== "agent:waiting_approval") return;
+    const instanceId = readNonEmptyString(event.instanceId);
+    if (!instanceId) return;
+    const sourceInstance = components.instanceManager.getInstance(instanceId);
+    if (!sourceInstance || sourceInstance.category !== "cli") return;
+    const state = sourceInstance.getState();
+    const workspace = readNonEmptyString(state.workspace);
+    if (!workspace) return;
+    const settings = state.settings && typeof state.settings === "object" ? state.settings : {};
+    const meshIdFromRuntime = readNonEmptyString(settings.meshNodeFor);
+    const mesh = meshIdFromRuntime ? getMesh(meshIdFromRuntime) : getMeshByRepo(workspace);
+    const meshId = meshIdFromRuntime || readNonEmptyString(mesh?.id);
+    if (!meshId) return;
+    const targetNode = mesh?.nodes?.find((n) => n.workspace === workspace);
+    const runtimeNodeId = readNonEmptyString(settings.meshNodeId);
+    const nodeLabel = targetNode ? `Node '${targetNode.id}'` : runtimeNodeId ? `Node '${runtimeNodeId}'` : `Agent at ${workspace}`;
+    injectMeshSystemMessage(components, {
+      meshId,
+      sourceInstanceId: instanceId,
+      nodeLabel,
+      event: event.event,
+      metadataEvent: event
+    });
+  });
+}
+
 // src/status/snapshot.ts
-var os17 = __toESM(require("os"));
+var os18 = __toESM(require("os"));
 init_config();
 init_terminal_screen();
 init_logger();
@@ -20192,8 +20824,8 @@ function buildAvailableProviders(providerLoader) {
 }
 function buildMachineInfo(profile = "full") {
   const base = {
-    hostname: os17.hostname(),
-    platform: os17.platform()
+    hostname: os18.hostname(),
+    platform: os18.platform()
   };
   if (profile === "live") {
     return base;
@@ -20202,23 +20834,23 @@ function buildMachineInfo(profile = "full") {
     const memSnap2 = getHostMemorySnapshot();
     return {
       ...base,
-      arch: os17.arch(),
-      cpus: os17.cpus().length,
+      arch: os18.arch(),
+      cpus: os18.cpus().length,
       totalMem: memSnap2.totalMem,
-      release: os17.release()
+      release: os18.release()
     };
   }
   const memSnap = getHostMemorySnapshot();
   return {
     ...base,
-    arch: os17.arch(),
-    cpus: os17.cpus().length,
+    arch: os18.arch(),
+    cpus: os18.cpus().length,
     totalMem: memSnap.totalMem,
     freeMem: memSnap.freeMem,
     availableMem: memSnap.availableMem,
-    loadavg: os17.loadavg(),
-    uptime: os17.uptime(),
-    release: os17.release()
+    loadavg: os18.loadavg(),
+    uptime: os18.uptime(),
+    release: os18.release()
   };
 }
 function parseMessageTime(value) {
@@ -20452,14 +21084,14 @@ function buildStatusSnapshot(options) {
 var import_child_process8 = require("child_process");
 var import_child_process9 = require("child_process");
 var fs9 = __toESM(require("fs"));
-var os18 = __toESM(require("os"));
-var path20 = __toESM(require("path"));
+var os19 = __toESM(require("os"));
+var path21 = __toESM(require("path"));
 var UPGRADE_HELPER_ENV = "ADHDEV_DAEMON_UPGRADE_HELPER";
 function getUpgradeLogPath() {
-  const home = os18.homedir();
-  const dir = path20.join(home, ".adhdev");
+  const home = os19.homedir();
+  const dir = path21.join(home, ".adhdev");
   fs9.mkdirSync(dir, { recursive: true });
-  return path20.join(dir, "daemon-upgrade.log");
+  return path21.join(dir, "daemon-upgrade.log");
 }
 function appendUpgradeLog(message) {
   const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] ${message}
@@ -20470,14 +21102,14 @@ function appendUpgradeLog(message) {
   }
 }
 function resolveSiblingNpmInvocation(nodeExecutable, platform10 = process.platform) {
-  const binDir = path20.dirname(nodeExecutable);
+  const binDir = path21.dirname(nodeExecutable);
   if (platform10 === "win32") {
-    const npmCliPath = path20.join(binDir, "node_modules", "npm", "bin", "npm-cli.js");
+    const npmCliPath = path21.join(binDir, "node_modules", "npm", "bin", "npm-cli.js");
     if (fs9.existsSync(npmCliPath)) {
       return { executable: nodeExecutable, argsPrefix: [npmCliPath], execOptions: getNpmExecOptions(platform10) };
     }
     for (const candidate of ["npm.exe", "npm"]) {
-      const candidatePath = path20.join(binDir, candidate);
+      const candidatePath = path21.join(binDir, candidate);
       if (fs9.existsSync(candidatePath)) {
         return { executable: candidatePath, argsPrefix: [], execOptions: getNpmExecOptions(platform10) };
       }
@@ -20485,7 +21117,7 @@ function resolveSiblingNpmInvocation(nodeExecutable, platform10 = process.platfo
     return { executable: nodeExecutable, argsPrefix: [npmCliPath], execOptions: getNpmExecOptions(platform10) };
   }
   for (const candidate of ["npm"]) {
-    const candidatePath = path20.join(binDir, candidate);
+    const candidatePath = path21.join(binDir, candidate);
     if (fs9.existsSync(candidatePath)) {
       return { executable: candidatePath, argsPrefix: [], execOptions: getNpmExecOptions(platform10) };
     }
@@ -20502,13 +21134,13 @@ function findCurrentPackageRoot(currentCliPath, packageName) {
   let currentDir = resolvedPath;
   try {
     if (fs9.statSync(resolvedPath).isFile()) {
-      currentDir = path20.dirname(resolvedPath);
+      currentDir = path21.dirname(resolvedPath);
     }
   } catch {
-    currentDir = path20.dirname(resolvedPath);
+    currentDir = path21.dirname(resolvedPath);
   }
   while (true) {
-    const packageJsonPath = path20.join(currentDir, "package.json");
+    const packageJsonPath = path21.join(currentDir, "package.json");
     try {
       if (fs9.existsSync(packageJsonPath)) {
         const parsed = JSON.parse(fs9.readFileSync(packageJsonPath, "utf8"));
@@ -20519,7 +21151,7 @@ function findCurrentPackageRoot(currentCliPath, packageName) {
       }
     } catch {
     }
-    const parentDir = path20.dirname(currentDir);
+    const parentDir = path21.dirname(currentDir);
     if (parentDir === currentDir) {
       return null;
     }
@@ -20527,13 +21159,13 @@ function findCurrentPackageRoot(currentCliPath, packageName) {
   }
 }
 function resolveInstallPrefixFromPackageRoot(packageRoot, packageName) {
-  const nodeModulesDir = packageName.startsWith("@") ? path20.dirname(path20.dirname(packageRoot)) : path20.dirname(packageRoot);
-  if (path20.basename(nodeModulesDir) !== "node_modules") {
+  const nodeModulesDir = packageName.startsWith("@") ? path21.dirname(path21.dirname(packageRoot)) : path21.dirname(packageRoot);
+  if (path21.basename(nodeModulesDir) !== "node_modules") {
     return null;
   }
-  const maybeLibDir = path20.dirname(nodeModulesDir);
-  if (path20.basename(maybeLibDir) === "lib") {
-    return path20.dirname(maybeLibDir);
+  const maybeLibDir = path21.dirname(nodeModulesDir);
+  if (path21.basename(maybeLibDir) === "lib") {
+    return path21.dirname(maybeLibDir);
   }
   return maybeLibDir;
 }
@@ -20648,7 +21280,7 @@ async function waitForPidExit(pid, timeoutMs) {
   }
 }
 function stopSessionHostProcesses(appName) {
-  const pidFile = path20.join(os18.homedir(), ".adhdev", `${appName}-session-host.pid`);
+  const pidFile = path21.join(os19.homedir(), ".adhdev", `${appName}-session-host.pid`);
   try {
     if (fs9.existsSync(pidFile)) {
       const pid = Number.parseInt(fs9.readFileSync(pidFile, "utf8").trim(), 10);
@@ -20665,7 +21297,7 @@ function stopSessionHostProcesses(appName) {
   }
 }
 function removeDaemonPidFile() {
-  const pidFile = path20.join(os18.homedir(), ".adhdev", "daemon.pid");
+  const pidFile = path21.join(os19.homedir(), ".adhdev", "daemon.pid");
   try {
     fs9.unlinkSync(pidFile);
   } catch {
@@ -20676,7 +21308,7 @@ function cleanupStaleGlobalInstallDirs(pkgName, surface) {
   const npmRoot = String(execNpmCommandSync(["root", "-g", ...prefixArgs], { encoding: "utf8" }, surface)).trim();
   if (!npmRoot) return;
   const npmPrefix = surface.installPrefix || String(execNpmCommandSync(["prefix", "-g", ...prefixArgs], { encoding: "utf8" }, surface)).trim();
-  const binDir = process.platform === "win32" ? npmPrefix : path20.join(npmPrefix, "bin");
+  const binDir = process.platform === "win32" ? npmPrefix : path21.join(npmPrefix, "bin");
   const packageBaseName = pkgName.startsWith("@") ? pkgName.split("/")[1] : pkgName;
   const binNames = /* @__PURE__ */ new Set([packageBaseName]);
   if (pkgName === "@adhdev/daemon-standalone") {
@@ -20684,25 +21316,25 @@ function cleanupStaleGlobalInstallDirs(pkgName, surface) {
   }
   if (pkgName.startsWith("@")) {
     const [scope, name] = pkgName.split("/");
-    const scopeDir = path20.join(npmRoot, scope);
+    const scopeDir = path21.join(npmRoot, scope);
     if (!fs9.existsSync(scopeDir)) return;
     for (const entry of fs9.readdirSync(scopeDir)) {
       if (!entry.startsWith(`.${name}-`)) continue;
-      fs9.rmSync(path20.join(scopeDir, entry), { recursive: true, force: true });
-      appendUpgradeLog(`Removed stale scoped staging dir: ${path20.join(scopeDir, entry)}`);
+      fs9.rmSync(path21.join(scopeDir, entry), { recursive: true, force: true });
+      appendUpgradeLog(`Removed stale scoped staging dir: ${path21.join(scopeDir, entry)}`);
     }
   } else {
     for (const entry of fs9.readdirSync(npmRoot)) {
       if (!entry.startsWith(`.${pkgName}-`)) continue;
-      fs9.rmSync(path20.join(npmRoot, entry), { recursive: true, force: true });
-      appendUpgradeLog(`Removed stale staging dir: ${path20.join(npmRoot, entry)}`);
+      fs9.rmSync(path21.join(npmRoot, entry), { recursive: true, force: true });
+      appendUpgradeLog(`Removed stale staging dir: ${path21.join(npmRoot, entry)}`);
     }
   }
   if (fs9.existsSync(binDir)) {
     for (const entry of fs9.readdirSync(binDir)) {
       if (!Array.from(binNames).some((name) => entry.startsWith(`.${name}-`))) continue;
-      fs9.rmSync(path20.join(binDir, entry), { recursive: true, force: true });
-      appendUpgradeLog(`Removed stale bin staging entry: ${path20.join(binDir, entry)}`);
+      fs9.rmSync(path21.join(binDir, entry), { recursive: true, force: true });
+      appendUpgradeLog(`Removed stale bin staging entry: ${path21.join(binDir, entry)}`);
     }
   }
 }
@@ -20803,6 +21435,56 @@ function normalizeReleaseChannel(value) {
 function resolveUpgradeChannel(args) {
   return normalizeReleaseChannel(args?.channel) || normalizeReleaseChannel(args?.updatePolicy?.channel) || normalizeReleaseChannel(args?.npmTag) || normalizeReleaseChannel(loadConfig().updateChannel) || "stable";
 }
+function readProviderPriorityFromPolicy(policy) {
+  const record = policy && typeof policy === "object" && !Array.isArray(policy) ? policy : {};
+  const raw = record.providerPriority;
+  if (!Array.isArray(raw)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  return raw.map((type) => typeof type === "string" ? type.trim() : "").filter(Boolean).filter((type) => {
+    if (seen.has(type)) return false;
+    seen.add(type);
+    return true;
+  });
+}
+async function resolveProviderTypeFromPriority(args) {
+  if (!args.providerPriority.length) {
+    return { error: `Node '${args.nodeId}' has no providerPriority policy; pass cliType explicitly or configure node.policy.providerPriority` };
+  }
+  const failed = [];
+  for (const requestedType of args.providerPriority) {
+    const normalizedType = args.providerLoader.resolveAlias(requestedType);
+    if (!args.providerLoader.isMachineProviderEnabled(normalizedType)) {
+      failed.push(`${requestedType}: disabled`);
+      continue;
+    }
+    const detected = await detectCLI(normalizedType, args.providerLoader, { includeVersion: false });
+    args.providerLoader.setCliDetectionResults([{
+      id: normalizedType,
+      installed: !!detected,
+      path: detected?.path
+    }], false);
+    args.onStatusChange?.();
+    if (detected) return { providerType: normalizedType };
+    failed.push(`${requestedType}: not detected`);
+  }
+  return { error: `No usable provider detected for node '${args.nodeId}' from providerPriority: ${failed.join("; ")}` };
+}
+function loadYamlModule() {
+  return yaml;
+}
+function getMcpServersKey(format) {
+  return format === "hermes_config_yaml" ? "mcp_servers" : "mcpServers";
+}
+function parseMeshCoordinatorMcpConfig(text, format) {
+  if (!text.trim()) return {};
+  if (format === "claude_mcp_json") return JSON.parse(text);
+  const parsed = loadYamlModule().load(text);
+  return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+}
+function serializeMeshCoordinatorMcpConfig(config, format) {
+  if (format === "claude_mcp_json") return JSON.stringify(config, null, 2);
+  return loadYamlModule().dump(config, { noRefs: true, lineWidth: 120 });
+}
 var CHAT_COMMANDS = [
   "send_chat",
   "new_chat",
@@ -20901,6 +21583,154 @@ var DaemonCommandRouter = class {
   constructor(deps) {
     this.deps = deps;
   }
+  getCachedInlineMesh(meshId, inlineMesh) {
+    if (inlineMesh && typeof inlineMesh === "object") {
+      this.inlineMeshCache.set(meshId, inlineMesh);
+      return inlineMesh;
+    }
+    return this.inlineMeshCache.get(meshId);
+  }
+  async getMeshForCommand(meshId, inlineMesh) {
+    try {
+      const { getMesh: getMesh3 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
+      const mesh = getMesh3(meshId);
+      if (mesh) return { mesh, inline: false };
+    } catch {
+    }
+    const cached = this.getCachedInlineMesh(meshId, inlineMesh);
+    return cached ? { mesh: cached, inline: true } : null;
+  }
+  updateInlineMeshNode(meshId, mesh, node) {
+    if (!mesh || !Array.isArray(mesh.nodes) || !node?.id) return;
+    const idx = mesh.nodes.findIndex((entry) => entry?.id === node.id || entry?.nodeId === node.id);
+    if (idx >= 0) mesh.nodes[idx] = node;
+    else mesh.nodes.push(node);
+    mesh.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.inlineMeshCache.set(meshId, mesh);
+  }
+  removeInlineMeshNode(meshId, mesh, nodeId) {
+    if (!mesh || !Array.isArray(mesh.nodes)) return false;
+    const idx = mesh.nodes.findIndex((entry) => entry?.id === nodeId || entry?.nodeId === nodeId);
+    if (idx === -1) return false;
+    mesh.nodes.splice(idx, 1);
+    mesh.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    this.inlineMeshCache.set(meshId, mesh);
+    return true;
+  }
+  normalizeMeshSessionCleanupMode(value) {
+    return value === "stop" || value === "delete_stopped" || value === "stop_and_delete" || value === "preserve" ? value : "preserve";
+  }
+  sessionMatchesMeshNode(record, node, nodeId, sessionIds) {
+    const sessionId = typeof record?.sessionId === "string" ? record.sessionId : "";
+    if (!sessionId) return false;
+    if (sessionIds?.size) return sessionIds.has(sessionId);
+    const workspace = typeof node?.workspace === "string" ? node.workspace : "";
+    if (workspace && record?.workspace === workspace) return true;
+    if (record?.meta?.meshNodeId === nodeId) return true;
+    return false;
+  }
+  isCompletedHostedSession(record) {
+    return record?.lifecycle === "stopped" || record?.lifecycle === "failed" || record?.lifecycle === "interrupted";
+  }
+  async cleanupMeshSessions(args) {
+    if (args.mode === "preserve") {
+      return { success: true, mode: "preserve", matchedCount: 0, stoppedSessionIds: [], deletedSessionIds: [], skippedSessionIds: [] };
+    }
+    if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
+    const requestedSessionIds = Array.isArray(args.sessionIds) ? new Set(args.sessionIds.map((id) => typeof id === "string" ? id.trim() : "").filter(Boolean)) : void 0;
+    const sessions = await this.deps.sessionHostControl.listSessions();
+    const matched = sessions.filter((record) => this.sessionMatchesMeshNode(record, args.node, args.nodeId, requestedSessionIds));
+    const hasExplicitSessionIds = !!requestedSessionIds?.size;
+    const stoppedSessionIds = [];
+    const deletedSessionIds = [];
+    const skippedSessionIds = [];
+    const skippedLiveSessionIds = [];
+    const deleteUnsupportedSessionIds = [];
+    const recordsRemainSessionIds = [];
+    const errors = [];
+    const matchedBySurfaceKind = {
+      live_runtime: 0,
+      recovery_snapshot: 0,
+      inactive_record: 0
+    };
+    for (const record of matched) {
+      const surfaceKind = getSessionHostSurfaceKind(record);
+      matchedBySurfaceKind[surfaceKind] += 1;
+    }
+    for (const record of matched) {
+      const sessionId = String(record.sessionId);
+      const completed = this.isCompletedHostedSession(record);
+      const surfaceKind = getSessionHostSurfaceKind(record);
+      const liveRuntime = surfaceKind === "live_runtime";
+      if (!hasExplicitSessionIds && liveRuntime) {
+        skippedSessionIds.push(sessionId);
+        skippedLiveSessionIds.push(sessionId);
+        continue;
+      }
+      try {
+        if (args.mode === "stop") {
+          if (!completed) {
+            if (!args.dryRun) await this.deps.sessionHostControl.stopSession(sessionId);
+            stoppedSessionIds.push(sessionId);
+          } else {
+            skippedSessionIds.push(sessionId);
+          }
+          continue;
+        }
+        if (args.mode === "delete_stopped") {
+          if (completed) {
+            if (!args.dryRun) await this.deps.sessionHostControl.deleteSession(sessionId, { force: false });
+            deletedSessionIds.push(sessionId);
+          } else {
+            skippedSessionIds.push(sessionId);
+          }
+          continue;
+        }
+        if (args.mode === "stop_and_delete") {
+          if (!args.dryRun) await this.deps.sessionHostControl.deleteSession(sessionId, { force: true });
+          deletedSessionIds.push(sessionId);
+          continue;
+        }
+      } catch (e) {
+        const message = e?.message || String(e);
+        if (message.includes("Unsupported session host request: delete_session") && (args.mode === "delete_stopped" || args.mode === "stop_and_delete")) {
+          deleteUnsupportedSessionIds.push(sessionId);
+          recordsRemainSessionIds.push(sessionId);
+          if (args.mode === "stop_and_delete" && !completed) {
+            try {
+              await this.deps.sessionHostControl.stopSession(sessionId);
+              stoppedSessionIds.push(sessionId);
+            } catch (stopError) {
+              errors.push({ sessionId, error: stopError?.message || String(stopError) });
+              continue;
+            }
+          }
+          skippedSessionIds.push(sessionId);
+          continue;
+        }
+        errors.push({ sessionId, error: message });
+      }
+    }
+    const deleteUnsupported = deleteUnsupportedSessionIds.length > 0;
+    return {
+      success: errors.length === 0,
+      mode: args.mode,
+      dryRun: args.dryRun === true,
+      matchedCount: matched.length,
+      matchedBySurfaceKind,
+      stoppedSessionIds,
+      deletedSessionIds,
+      skippedSessionIds,
+      skippedLiveSessionIds,
+      ...deleteUnsupported ? {
+        deleteUnsupported: true,
+        effectiveCleanup: args.mode === "stop_and_delete" ? "stopped_only_records_remain" : "delete_unsupported_records_remain",
+        deleteUnsupportedSessionIds,
+        recordsRemainSessionIds
+      } : {},
+      ...errors.length ? { errors } : {}
+    };
+  }
   async traceSessionHostAction(action, args, run, summarizeResult) {
     const interactionId = typeof args?._interactionId === "string" ? args._interactionId : void 0;
     const sessionId = typeof args?.sessionId === "string" ? args.sessionId : void 0;
@@ -21020,6 +21850,9 @@ var DaemonCommandRouter = class {
   async executeDaemonCommand(cmd, args) {
     switch (cmd) {
       // ─── CLI / ACP commands ───
+      case "mesh_forward_event": {
+        return handleMeshForwardEvent({ instanceManager: this.deps.instanceManager }, args);
+      }
       case "launch_cli":
       case "stop_cli":
       case "set_cli_view_mode":
@@ -21564,7 +22397,26 @@ var DaemonCommandRouter = class {
         if (!name) return { success: false, error: "name required" };
         try {
           const { createMesh: createMesh2 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
-          const mesh = createMesh2({ name, repoIdentity, repoRemoteUrl, defaultBranch });
+          const mesh = createMesh2({ name, repoIdentity, repoRemoteUrl, defaultBranch, policy: args?.policy });
+          return { success: true, mesh };
+        } catch (e) {
+          return { success: false, error: e.message };
+        }
+      }
+      case "update_mesh": {
+        const meshId = typeof args?.meshId === "string" ? args.meshId.trim() : "";
+        if (!meshId) return { success: false, error: "meshId required" };
+        try {
+          const { updateMesh: updateMesh2 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
+          const patch = {};
+          if (typeof args?.name === "string") patch.name = args.name;
+          if (typeof args?.defaultBranch === "string") patch.defaultBranch = args.defaultBranch;
+          if (args?.policy && typeof args.policy === "object" && !Array.isArray(args.policy)) patch.policy = args.policy;
+          if (args?.coordinator && typeof args.coordinator === "object" && !Array.isArray(args.coordinator)) patch.coordinator = args.coordinator;
+          if (!Object.keys(patch).length) return { success: false, error: "No updates provided" };
+          const mesh = updateMesh2(meshId, patch);
+          if (!mesh) return { success: false, error: "Mesh not found" };
+          this.inlineMeshCache.set(meshId, mesh);
           return { success: true, mesh };
         } catch (e) {
           return { success: false, error: e.message };
@@ -21588,21 +22440,164 @@ var DaemonCommandRouter = class {
         if (!workspace) return { success: false, error: "workspace required" };
         try {
           const { addNode: addNode3 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
-          const node = addNode3(meshId, { workspace });
+          const providerPriority = Array.isArray(args?.providerPriority) ? args.providerPriority.map((type) => typeof type === "string" ? type.trim() : "").filter(Boolean) : [];
+          const readOnly = args?.readOnly === true;
+          const policy = {
+            ...readOnly ? { readOnly: true } : {},
+            ...providerPriority.length ? { providerPriority } : {}
+          };
+          const node = addNode3(meshId, { workspace, ...policy ? { policy } : {} });
           if (!node) return { success: false, error: "Mesh not found" };
           return { success: true, node };
         } catch (e) {
           return { success: false, error: e.message };
         }
       }
+      case "update_mesh_node": {
+        const meshId = typeof args?.meshId === "string" ? args.meshId.trim() : "";
+        const nodeId = typeof args?.nodeId === "string" ? args.nodeId.trim() : "";
+        if (!meshId || !nodeId) return { success: false, error: "meshId and nodeId required" };
+        try {
+          const { updateNode: updateNode2 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
+          const policy = args?.policy && typeof args.policy === "object" && !Array.isArray(args.policy) ? { ...args.policy } : {};
+          if (Array.isArray(args?.providerPriority)) {
+            const providerPriority = args.providerPriority.map((type) => typeof type === "string" ? type.trim() : "").filter(Boolean);
+            delete policy.provider_priority;
+            if (providerPriority.length) {
+              policy.providerPriority = providerPriority;
+            } else {
+              delete policy.providerPriority;
+            }
+          }
+          const node = updateNode2(meshId, nodeId, { policy });
+          if (!node) return { success: false, error: "Mesh node not found" };
+          return { success: true, node };
+        } catch (e) {
+          return { success: false, error: e.message };
+        }
+      }
+      case "cleanup_mesh_sessions": {
+        const meshId = typeof args?.meshId === "string" ? args.meshId.trim() : "";
+        const nodeId = typeof args?.nodeId === "string" ? args.nodeId.trim() : "";
+        if (!meshId || !nodeId) return { success: false, error: "meshId and nodeId required" };
+        try {
+          const meshRecord = await this.getMeshForCommand(meshId, args?.inlineMesh);
+          const mesh = meshRecord?.mesh;
+          if (!mesh) return { success: false, error: "Mesh not found" };
+          const node = mesh?.nodes?.find((n) => n.id === nodeId || n.nodeId === nodeId);
+          if (!node) return { success: false, error: `Node '${nodeId}' not found in mesh` };
+          const mode = this.normalizeMeshSessionCleanupMode(args?.mode ?? mesh?.policy?.sessionCleanupOnNodeRemove);
+          const sessionIds = Array.isArray(args?.sessionIds) ? args.sessionIds.map((id) => typeof id === "string" ? id.trim() : "").filter(Boolean) : void 0;
+          const result = await this.cleanupMeshSessions({
+            meshId,
+            nodeId,
+            node,
+            mode,
+            sessionIds,
+            dryRun: args?.dryRun === true
+          });
+          return result;
+        } catch (e) {
+          return { success: false, error: e.message };
+        }
+      }
       case "remove_mesh_node": {
         const meshId = typeof args?.meshId === "string" ? args.meshId.trim() : "";
         const nodeId = typeof args?.nodeId === "string" ? args.nodeId.trim() : "";
         if (!meshId || !nodeId) return { success: false, error: "meshId and nodeId required" };
         try {
-          const { removeNode: removeNode3 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
-          const removed = removeNode3(meshId, nodeId);
-          return { success: true, removed };
+          const meshRecord = await this.getMeshForCommand(meshId, args?.inlineMesh);
+          const mesh = meshRecord?.mesh;
+          const node = mesh?.nodes?.find((n) => n.id === nodeId || n.nodeId === nodeId);
+          const sessionCleanupMode = this.normalizeMeshSessionCleanupMode(
+            args?.sessionCleanupMode ?? args?.session_cleanup_mode ?? mesh?.policy?.sessionCleanupOnNodeRemove
+          );
+          let sessionCleanup;
+          if (node && sessionCleanupMode !== "preserve") {
+            sessionCleanup = await this.cleanupMeshSessions({ meshId, nodeId, node, mode: sessionCleanupMode });
+            if (sessionCleanup.success === false) return { success: false, removed: false, sessionCleanup };
+          }
+          if (node?.isLocalWorktree && node.workspace) {
+            try {
+              const sourceNode = node.clonedFromNodeId ? mesh?.nodes.find((n) => n.id === node.clonedFromNodeId || n.nodeId === node.clonedFromNodeId) : mesh?.nodes.find((n) => !n.isLocalWorktree);
+              const repoRoot = sourceNode?.repoRoot || sourceNode?.workspace;
+              if (repoRoot) {
+                const { removeWorktree: removeWorktree2 } = await Promise.resolve().then(() => (init_git_worktree(), git_worktree_exports));
+                await removeWorktree2(repoRoot, node.workspace);
+              }
+            } catch (e) {
+              LOG.warn("MeshNode", `Worktree cleanup failed for ${nodeId}: ${e.message}`);
+            }
+          }
+          let removed = false;
+          if (meshRecord?.inline) {
+            removed = this.removeInlineMeshNode(meshId, mesh, nodeId);
+          } else {
+            const { removeNode: removeNode3 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
+            removed = removeNode3(meshId, nodeId);
+          }
+          return { success: true, removed, ...sessionCleanup ? { sessionCleanup } : {} };
+        } catch (e) {
+          return { success: false, error: e.message };
+        }
+      }
+      case "clone_mesh_node": {
+        const meshId = typeof args?.meshId === "string" ? args.meshId.trim() : "";
+        const sourceNodeId = typeof args?.sourceNodeId === "string" ? args.sourceNodeId.trim() : "";
+        const branch = typeof args?.branch === "string" ? args.branch.trim() : "";
+        const baseBranch = typeof args?.baseBranch === "string" ? args.baseBranch.trim() : void 0;
+        if (!meshId) return { success: false, error: "meshId required" };
+        if (!sourceNodeId) return { success: false, error: "sourceNodeId required" };
+        if (!branch) return { success: false, error: "branch required" };
+        try {
+          const meshRecord = await this.getMeshForCommand(meshId, args?.inlineMesh);
+          const mesh = meshRecord?.mesh;
+          if (!mesh) return { success: false, error: "Mesh not found" };
+          const sourceNode = mesh.nodes?.find((n) => n.id === sourceNodeId || n.nodeId === sourceNodeId);
+          if (!sourceNode) return { success: false, error: `Source node '${sourceNodeId}' not found in mesh` };
+          const repoRoot = sourceNode.repoRoot || sourceNode.workspace;
+          const { createWorktree: createWorktree2 } = await Promise.resolve().then(() => (init_git_worktree(), git_worktree_exports));
+          const result = await createWorktree2({
+            repoRoot,
+            branch,
+            baseBranch,
+            meshName: mesh.name
+          });
+          let node;
+          if (meshRecord.inline) {
+            const { randomUUID: randomUUID8 } = await import("crypto");
+            node = {
+              id: `node_${randomUUID8().replace(/-/g, "")}`,
+              workspace: result.worktreePath,
+              repoRoot: result.worktreePath,
+              daemonId: sourceNode.daemonId,
+              userOverrides: { ...sourceNode.userOverrides || {} },
+              policy: { ...sourceNode.policy || {} },
+              isLocalWorktree: true,
+              worktreeBranch: result.branch,
+              clonedFromNodeId: sourceNodeId
+            };
+            this.updateInlineMeshNode(meshId, mesh, node);
+          } else {
+            const { addNode: addNode3 } = await Promise.resolve().then(() => (init_mesh_config(), mesh_config_exports));
+            node = addNode3(meshId, {
+              workspace: result.worktreePath,
+              repoRoot: result.worktreePath,
+              daemonId: sourceNode.daemonId,
+              userOverrides: { ...sourceNode.userOverrides || {} },
+              isLocalWorktree: true,
+              worktreeBranch: result.branch,
+              clonedFromNodeId: sourceNodeId,
+              policy: { ...sourceNode.policy || {} }
+            });
+            if (!node) return { success: false, error: "Failed to register worktree node" };
+          }
+          return {
+            success: true,
+            node,
+            worktreePath: result.worktreePath,
+            branch: result.branch
+          };
         } catch (e) {
           return { success: false, error: e.message };
         }
@@ -21610,7 +22605,7 @@ var DaemonCommandRouter = class {
       // ─── Mesh Coordinator Launch ───
       case "launch_mesh_coordinator": {
         const meshId = typeof args?.meshId === "string" ? args.meshId.trim() : "";
-        const cliType = typeof args?.cliType === "string" ? args.cliType.trim() : "claude-cli";
+        let cliType = typeof args?.cliType === "string" ? args.cliType.trim() : "";
         if (!meshId) return { success: false, error: "meshId required" };
         try {
           const { buildCoordinatorSystemPrompt: buildCoordinatorSystemPrompt2 } = await Promise.resolve().then(() => (init_coordinator_prompt(), coordinator_prompt_exports));
@@ -21638,9 +22633,29 @@ var DaemonCommandRouter = class {
           }
           const workspace = typeof coordinatorNode.workspace === "string" ? coordinatorNode.workspace.trim() : "";
           if (!workspace) return { success: false, error: "Coordinator node workspace required", meshId, cliType };
+          if (!cliType) {
+            const resolved = await resolveProviderTypeFromPriority({
+              nodeId: String(coordinatorNode.id || coordinatorNode.nodeId || preferredCoordinatorNodeId || "coordinator"),
+              providerPriority: readProviderPriorityFromPolicy(coordinatorNode.policy),
+              providerLoader: this.deps.providerLoader,
+              onStatusChange: this.deps.onStatusChange
+            });
+            if (!resolved.providerType) {
+              return {
+                success: false,
+                code: "mesh_coordinator_provider_priority_unusable",
+                error: resolved.error || "No usable provider found from node providerPriority",
+                meshId,
+                cliType,
+                workspace
+              };
+            }
+            cliType = resolved.providerType;
+          }
           const providerMeta = this.deps.providerLoader.resolve?.(cliType) || this.deps.providerLoader.getMeta(cliType);
           const coordinatorSetup = resolveMeshCoordinatorSetup({
             provider: providerMeta,
+            cliType,
             meshId,
             workspace
           });
@@ -21665,7 +22680,8 @@ var DaemonCommandRouter = class {
               meshCoordinatorSetup: coordinatorSetup
             };
           }
-          if (coordinatorSetup.configFormat !== "claude_mcp_json") {
+          const configFormat = coordinatorSetup.configFormat;
+          if (configFormat !== "claude_mcp_json" && configFormat !== "hermes_config_yaml") {
             return {
               success: false,
               code: "mesh_coordinator_unsupported",
@@ -21675,17 +22691,34 @@ var DaemonCommandRouter = class {
               workspace
             };
           }
-          const { existsSync: existsSync22, readFileSync: readFileSync15, writeFileSync: writeFileSync12, copyFileSync: copyFileSync3 } = await import("fs");
-          const mcpConfigPath = coordinatorSetup.configPath;
-          const hadExistingMcpConfig = existsSync22(mcpConfigPath);
-          let existingMcpConfig = {};
-          if (hadExistingMcpConfig) {
-            try {
-              existingMcpConfig = JSON.parse(readFileSync15(mcpConfigPath, "utf-8"));
-              copyFileSync3(mcpConfigPath, mcpConfigPath + ".backup");
-            } catch {
-            }
+          let systemPrompt = "";
+          try {
+            systemPrompt = buildCoordinatorSystemPrompt2({ mesh, coordinatorCliType: cliType });
+          } catch (error) {
+            const message = error?.message || String(error);
+            LOG.error("MeshCoordinator", `Failed to build coordinator prompt: ${message}`);
+            return {
+              success: false,
+              code: "mesh_coordinator_prompt_failed",
+              error: `Failed to build Repo Mesh coordinator prompt: ${message}`,
+              meshId,
+              cliType,
+              workspace
+            };
           }
+          const { existsSync: existsSync23, readFileSync: readFileSync15, writeFileSync: writeFileSync13, copyFileSync: copyFileSync3, mkdirSync: mkdirSync15 } = await import("fs");
+          const { dirname: dirname9 } = await import("path");
+          const mcpConfigPath = coordinatorSetup.configPath;
+          const hermesManualFallback = cliType === "hermes-cli" && configFormat === "hermes_config_yaml" ? createHermesManualMeshCoordinatorSetup(meshId, workspace) : null;
+          const returnManualFallback = (message) => ({
+            success: false,
+            code: "mesh_coordinator_manual_mcp_setup_required",
+            error: message,
+            meshId,
+            cliType,
+            workspace,
+            meshCoordinatorSetup: hermesManualFallback
+          });
           const mcpServerEntry = {
             command: coordinatorSetup.mcpServer.command,
             args: coordinatorSetup.mcpServer.args
@@ -21696,24 +22729,55 @@ var DaemonCommandRouter = class {
               ADHDEV_MCP_TRANSPORT: "ipc"
             };
           }
+          try {
+            mkdirSync15(dirname9(mcpConfigPath), { recursive: true });
+          } catch (error) {
+            const message = `Could not prepare MCP config path for automatic setup: ${error?.message || error}`;
+            LOG.error("MeshCoordinator", message);
+            if (hermesManualFallback) return returnManualFallback(message);
+            return { success: false, code: "mesh_coordinator_config_write_failed", error: message, meshId, cliType, workspace };
+          }
+          const hadExistingMcpConfig = existsSync23(mcpConfigPath);
+          let existingMcpConfig = {};
+          if (hadExistingMcpConfig) {
+            try {
+              existingMcpConfig = parseMeshCoordinatorMcpConfig(readFileSync15(mcpConfigPath, "utf-8"), configFormat);
+              copyFileSync3(mcpConfigPath, mcpConfigPath + ".backup");
+            } catch (error) {
+              LOG.error("MeshCoordinator", `Failed to parse existing MCP config ${mcpConfigPath}: ${error?.message || error}`);
+              return {
+                success: false,
+                code: "mesh_coordinator_config_parse_failed",
+                error: `Failed to parse existing MCP config at ${mcpConfigPath}`
+              };
+            }
+          }
+          const mcpServersKey = getMcpServersKey(configFormat);
+          const existingServers = existingMcpConfig[mcpServersKey];
           const mcpConfig = {
             ...existingMcpConfig,
-            mcpServers: {
-              ...existingMcpConfig.mcpServers || {},
+            [mcpServersKey]: {
+              ...existingServers && typeof existingServers === "object" && !Array.isArray(existingServers) ? existingServers : {},
               [coordinatorSetup.serverName]: mcpServerEntry
             }
           };
-          writeFileSync12(mcpConfigPath, JSON.stringify(mcpConfig, null, 2), "utf-8");
-          LOG.info("MeshCoordinator", `Wrote ${mcpConfigPath} with ${coordinatorSetup.serverName} server`);
-          let systemPrompt = "";
           try {
-            systemPrompt = buildCoordinatorSystemPrompt2({ mesh });
-          } catch {
-            systemPrompt = `You are a Repo Mesh Coordinator for "${mesh.name}". Use the adhdev-mesh MCP tools (mesh_status, mesh_list_nodes, mesh_send_task, mesh_read_chat, mesh_launch_session, etc.) to orchestrate work across ${mesh.nodes.length} node(s).`;
+            writeFileSync13(mcpConfigPath, serializeMeshCoordinatorMcpConfig(mcpConfig, configFormat), "utf-8");
+          } catch (error) {
+            const message = `Could not write MCP config for automatic setup: ${error?.message || error}`;
+            LOG.error("MeshCoordinator", message);
+            if (hermesManualFallback) return returnManualFallback(message);
+            return { success: false, code: "mesh_coordinator_config_write_failed", error: message, meshId, cliType, workspace };
           }
+          LOG.info("MeshCoordinator", `Wrote ${mcpConfigPath} with ${coordinatorSetup.serverName} server`);
           const cliArgs = [];
+          const launchEnv = {};
           if (systemPrompt) {
-            cliArgs.push("--append-system-prompt", systemPrompt);
+            if (configFormat === "hermes_config_yaml") {
+              launchEnv.HERMES_EPHEMERAL_SYSTEM_PROMPT = systemPrompt;
+            } else {
+              cliArgs.push("--append-system-prompt", systemPrompt);
+            }
           }
           if (cliType === "claude-cli") {
             cliArgs.push("--mcp-config", coordinatorSetup.configPath);
@@ -21722,6 +22786,7 @@ var DaemonCommandRouter = class {
             cliType,
             dir: workspace,
             cliArgs: cliArgs.length > 0 ? cliArgs : void 0,
+            env: Object.keys(launchEnv).length > 0 ? launchEnv : void 0,
             settings: {
               meshCoordinatorFor: meshId
             }
@@ -21901,6 +22966,12 @@ var DaemonStatusReporter = class {
     if (providerType) {
       payload.providerType = providerType;
     }
+    if (typeof event.providerSessionId === "string" && event.providerSessionId.trim()) {
+      payload.providerSessionId = event.providerSessionId.trim();
+    }
+    if (typeof event.workspaceName === "string" && event.workspaceName.trim()) {
+      payload.workspaceName = event.workspaceName.trim();
+    }
     if (typeof event.duration === "number" && Number.isFinite(event.duration)) {
       payload.duration = event.duration;
     }
@@ -23148,7 +24219,10 @@ var ProviderInstanceManager = class {
       this.instances.get(id).dispose();
     }
     this.instances.set(id, instance);
-    await instance.init(context);
+    await instance.init({
+      ...context,
+      emitProviderEvent: (event) => this.emitProviderEvent(instance.type, id, event)
+    });
   }
   /**
   * Instance remove
@@ -23310,6 +24384,17 @@ var ProviderInstanceManager = class {
   onEvent(listener) {
     this.eventListeners.push(listener);
   }
+  emitProviderEvent(providerType, instanceId, event) {
+    const payload = {
+      ...event,
+      providerType,
+      instanceId: typeof event.instanceId === "string" && event.instanceId.trim() ? event.instanceId : instanceId,
+      targetSessionId: typeof event.targetSessionId === "string" && event.targetSessionId.trim() ? event.targetSessionId : instanceId
+    };
+    for (const listener of this.eventListeners) {
+      listener(payload);
+    }
+  }
   emitPendingEvents(providerType, state, extra = {}) {
     for (const event of state.pendingEvents) {
       for (const listener of this.eventListeners) {
@@ -23382,11 +24467,11 @@ var ProviderInstanceManager = class {
 
 // src/providers/version-archive.ts
 var fs11 = __toESM(require("fs"));
-var path21 = __toESM(require("path"));
-var os19 = __toESM(require("os"));
+var path22 = __toESM(require("path"));
+var os20 = __toESM(require("os"));
 var import_child_process10 = require("child_process");
 var import_os3 = require("os");
-var ARCHIVE_PATH = path21.join(os19.homedir(), ".adhdev", "version-history.json");
+var ARCHIVE_PATH = path22.join(os20.homedir(), ".adhdev", "version-history.json");
 var MAX_ENTRIES_PER_PROVIDER = 20;
 var VersionArchive = class {
   history = {};
@@ -23433,7 +24518,7 @@ var VersionArchive = class {
   }
   save() {
     try {
-      fs11.mkdirSync(path21.dirname(ARCHIVE_PATH), { recursive: true });
+      fs11.mkdirSync(path22.dirname(ARCHIVE_PATH), { recursive: true });
       fs11.writeFileSync(ARCHIVE_PATH, JSON.stringify(this.history, null, 2));
     } catch {
     }
@@ -23489,8 +24574,8 @@ function getVersion(binary, versionCommand) {
 function checkPathExists2(paths) {
   for (const p of paths) {
     if (p.includes("*")) {
-      const home = os19.homedir();
-      const resolved = p.replace(/\*/g, home.split(path21.sep).pop() || "");
+      const home = os20.homedir();
+      const resolved = p.replace(/\*/g, home.split(path22.sep).pop() || "");
       if (fs11.existsSync(resolved)) return resolved;
     } else {
       if (fs11.existsSync(p)) return p;
@@ -23500,7 +24585,7 @@ function checkPathExists2(paths) {
 }
 function getMacAppVersion(appPath) {
   if ((0, import_os3.platform)() !== "darwin" || !appPath.endsWith(".app")) return null;
-  const plistPath = path21.join(appPath, "Contents", "Info.plist");
+  const plistPath = path22.join(appPath, "Contents", "Info.plist");
   if (!fs11.existsSync(plistPath)) return null;
   const raw = runCommand(`/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "${plistPath}"`);
   return raw || null;
@@ -23526,7 +24611,7 @@ async function detectAllVersions(loader, archive) {
       const cliBin = provider.cli ? findBinary2(provider.cli) : null;
       let resolvedBin = cliBin;
       if (!resolvedBin && appPath && currentOs === "darwin") {
-        const bundled = path21.join(appPath, "Contents", "Resources", "app", "bin", provider.cli || "");
+        const bundled = path22.join(appPath, "Contents", "Resources", "app", "bin", provider.cli || "");
         if (provider.cli && fs11.existsSync(bundled)) resolvedBin = bundled;
       }
       info.installed = !!(appPath || resolvedBin);
@@ -23567,7 +24652,7 @@ async function detectAllVersions(loader, archive) {
 // src/daemon/dev-server.ts
 var http2 = __toESM(require("http"));
 var fs15 = __toESM(require("fs"));
-var path25 = __toESM(require("path"));
+var path26 = __toESM(require("path"));
 init_config();
 
 // src/daemon/scaffold-template.ts
@@ -23918,7 +25003,7 @@ init_logger();
 
 // src/daemon/dev-cdp-handlers.ts
 var fs12 = __toESM(require("fs"));
-var path22 = __toESM(require("path"));
+var path23 = __toESM(require("path"));
 init_logger();
 async function handleCdpEvaluate(ctx, req, res) {
   const body = await ctx.readBody(req);
@@ -24097,17 +25182,17 @@ async function handleScriptHints(ctx, type, _req, res) {
     return;
   }
   let scriptsPath = "";
-  const directScripts = path22.join(dir, "scripts.js");
+  const directScripts = path23.join(dir, "scripts.js");
   if (fs12.existsSync(directScripts)) {
     scriptsPath = directScripts;
   } else {
-    const scriptsDir = path22.join(dir, "scripts");
+    const scriptsDir = path23.join(dir, "scripts");
     if (fs12.existsSync(scriptsDir)) {
       const versions = fs12.readdirSync(scriptsDir).filter((d) => {
-        return fs12.statSync(path22.join(scriptsDir, d)).isDirectory();
+        return fs12.statSync(path23.join(scriptsDir, d)).isDirectory();
       }).sort().reverse();
       for (const ver of versions) {
-        const p = path22.join(scriptsDir, ver, "scripts.js");
+        const p = path23.join(scriptsDir, ver, "scripts.js");
         if (fs12.existsSync(p)) {
           scriptsPath = p;
           break;
@@ -24936,7 +26021,7 @@ async function handleDomContext(ctx, type, req, res) {
 
 // src/daemon/dev-cli-debug.ts
 var fs13 = __toESM(require("fs"));
-var path23 = __toESM(require("path"));
+var path24 = __toESM(require("path"));
 function slugifyFixtureName(value) {
   const normalized = String(value || "").trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
   return normalized || `fixture-${Date.now()}`;
@@ -24946,11 +26031,11 @@ function getCliFixtureDir(ctx, type) {
   if (!providerDir) {
     throw new Error(`Provider directory not found for '${type}'`);
   }
-  return path23.join(providerDir, "fixtures");
+  return path24.join(providerDir, "fixtures");
 }
 function readCliFixture(ctx, type, name) {
   const fixtureDir = getCliFixtureDir(ctx, type);
-  const filePath = path23.join(fixtureDir, `${name}.json`);
+  const filePath = path24.join(fixtureDir, `${name}.json`);
   if (!fs13.existsSync(filePath)) {
     throw new Error(`Fixture not found: ${filePath}`);
   }
@@ -25118,7 +26203,7 @@ function getCliTargetBundle(ctx, type, instanceId) {
   if (!adapter) return null;
   return { target, instance, adapter };
 }
-function sleep(ms) {
+function sleep2(ms) {
   return new Promise((resolve16) => setTimeout(resolve16, ms));
 }
 async function waitForCliReady(ctx, type, instanceId, timeoutMs) {
@@ -25135,7 +26220,7 @@ async function waitForCliReady(ctx, type, instanceId, timeoutMs) {
         return bundle;
       }
     }
-    await sleep(100);
+    await sleep2(100);
   }
   return getCliTargetBundle(ctx, type, instanceId);
 }
@@ -25191,7 +26276,7 @@ async function runCliExerciseInternal(ctx, body) {
         const message = String(lastLaunchError.message || "");
         const retryable = /ECONNREFUSED|session-host|Session host/i.test(message);
         if (!retryable || attempt === 2) break;
-        await sleep(1e3);
+        await sleep2(1e3);
       }
     }
     if (!launched) {
@@ -25254,16 +26339,16 @@ async function runCliExerciseInternal(ctx, body) {
     const modal = debug?.activeModal || trace?.activeModal || null;
     noteStatus(status);
     if (resolveActiveModalIfNeeded(status, modal)) {
-      await sleep(150);
+      await sleep2(150);
       continue;
     }
     const startupParseGate = !!debug?.startupParseGate;
     if (status === "idle" && !startupParseGate) break;
-    await sleep(150);
+    await sleep2(150);
   }
   ctx.instanceManager.sendEvent(bundle.target.instanceId, "send_message", { text });
   while (Date.now() - startAt < Math.max(1e3, timeoutMs)) {
-    await sleep(150);
+    await sleep2(150);
     bundle = getCliTargetBundle(ctx, type, bundle.target.instanceId);
     if (!bundle) {
       throw new Error("CLI instance disappeared during exercise");
@@ -25717,7 +26802,7 @@ async function handleCliFixtureCapture(ctx, req, res) {
       },
       notes: typeof body?.notes === "string" ? body.notes : void 0
     };
-    const filePath = path23.join(fixtureDir, `${name}.json`);
+    const filePath = path24.join(fixtureDir, `${name}.json`);
     fs13.writeFileSync(filePath, JSON.stringify(fixture, null, 2));
     ctx.json(res, 200, {
       saved: true,
@@ -25741,7 +26826,7 @@ async function handleCliFixtureList(ctx, type, _req, res) {
       return;
     }
     const fixtures = fs13.readdirSync(fixtureDir).filter((file) => file.endsWith(".json")).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" })).map((file) => {
-      const fullPath = path23.join(fixtureDir, file);
+      const fullPath = path24.join(fixtureDir, file);
       try {
         const raw = JSON.parse(fs13.readFileSync(fullPath, "utf-8"));
         return {
@@ -25877,8 +26962,8 @@ async function handleCliRaw(ctx, req, res) {
 
 // src/daemon/dev-auto-implement.ts
 var fs14 = __toESM(require("fs"));
-var path24 = __toESM(require("path"));
-var os20 = __toESM(require("os"));
+var path25 = __toESM(require("path"));
+var os21 = __toESM(require("os"));
 function getAutoImplPid(ctx) {
   const pid = ctx.autoImplProcess?.pid;
   return typeof pid === "number" && pid > 0 ? pid : null;
@@ -25927,22 +27012,22 @@ function getLatestScriptVersionDir(scriptsDir) {
   if (!fs14.existsSync(scriptsDir)) return null;
   const versions = fs14.readdirSync(scriptsDir).filter((d) => {
     try {
-      return fs14.statSync(path24.join(scriptsDir, d)).isDirectory();
+      return fs14.statSync(path25.join(scriptsDir, d)).isDirectory();
     } catch {
       return false;
     }
   }).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" }));
   if (versions.length === 0) return null;
-  return path24.join(scriptsDir, versions[0]);
+  return path25.join(scriptsDir, versions[0]);
 }
 function resolveAutoImplWritableProviderDir(ctx, category, type, requestedDir) {
-  const canonicalUserDir = path24.resolve(ctx.providerLoader.getUserProviderDir(category, type));
-  const desiredDir = requestedDir ? path24.resolve(requestedDir) : canonicalUserDir;
-  const upstreamRoot = path24.resolve(ctx.providerLoader.getUpstreamDir());
-  if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path24.sep}`)) {
+  const canonicalUserDir = path25.resolve(ctx.providerLoader.getUserProviderDir(category, type));
+  const desiredDir = requestedDir ? path25.resolve(requestedDir) : canonicalUserDir;
+  const upstreamRoot = path25.resolve(ctx.providerLoader.getUpstreamDir());
+  if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path25.sep}`)) {
     return { dir: null, reason: `Refusing to write into upstream provider directory: ${desiredDir}` };
   }
-  if (path24.basename(desiredDir) !== type) {
+  if (path25.basename(desiredDir) !== type) {
     return { dir: null, reason: `Requested writable provider directory must end with '${type}': ${desiredDir}` };
   }
   const sourceDir = ctx.findProviderDir(type);
@@ -25950,11 +27035,11 @@ function resolveAutoImplWritableProviderDir(ctx, category, type, requestedDir) {
     return { dir: null, reason: `Provider source directory not found for '${type}'` };
   }
   if (!fs14.existsSync(desiredDir)) {
-    fs14.mkdirSync(path24.dirname(desiredDir), { recursive: true });
+    fs14.mkdirSync(path25.dirname(desiredDir), { recursive: true });
     fs14.cpSync(sourceDir, desiredDir, { recursive: true });
     ctx.log(`Auto-implement writable copy created: ${desiredDir}`);
   }
-  const providerJson = path24.join(desiredDir, "provider.json");
+  const providerJson = path25.join(desiredDir, "provider.json");
   if (!fs14.existsSync(providerJson)) {
     return { dir: null, reason: `provider.json not found in writable provider directory: ${desiredDir}` };
   }
@@ -25965,13 +27050,13 @@ function loadAutoImplReferenceScripts(ctx, referenceType) {
   const refDir = ctx.findProviderDir(referenceType);
   if (!refDir || !fs14.existsSync(refDir)) return {};
   const referenceScripts = {};
-  const scriptsDir = path24.join(refDir, "scripts");
+  const scriptsDir = path25.join(refDir, "scripts");
   const latestDir = getLatestScriptVersionDir(scriptsDir);
   if (!latestDir) return referenceScripts;
   for (const file of fs14.readdirSync(latestDir)) {
     if (!file.endsWith(".js")) continue;
     try {
-      referenceScripts[file] = fs14.readFileSync(path24.join(latestDir, file), "utf-8");
+      referenceScripts[file] = fs14.readFileSync(path25.join(latestDir, file), "utf-8");
     } catch {
     }
   }
@@ -26079,9 +27164,9 @@ async function handleAutoImplement(ctx, type, req, res) {
     });
     const referenceScripts = loadAutoImplReferenceScripts(ctx, resolvedReference);
     const prompt = buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domContext, referenceScripts, comment, resolvedReference, verification);
-    const tmpDir = path24.join(os20.tmpdir(), "adhdev-autoimpl");
+    const tmpDir = path25.join(os21.tmpdir(), "adhdev-autoimpl");
     if (!fs14.existsSync(tmpDir)) fs14.mkdirSync(tmpDir, { recursive: true });
-    const promptFile = path24.join(tmpDir, `prompt-${type}-${Date.now()}.md`);
+    const promptFile = path25.join(tmpDir, `prompt-${type}-${Date.now()}.md`);
     fs14.writeFileSync(promptFile, prompt, "utf-8");
     ctx.log(`Auto-implement prompt written to ${promptFile} (${prompt.length} chars)`);
     const agentProvider = ctx.providerLoader.resolve(agent) || ctx.providerLoader.getMeta(agent);
@@ -26234,7 +27319,7 @@ async function handleAutoImplement(ctx, type, req, res) {
     const interactiveFlags = ["--yolo", "--interactive", "-i"];
     const baseArgs = [...spawn4.args || []].filter((a) => !interactiveFlags.includes(a));
     let shellCmd;
-    const isWin = os20.platform() === "win32";
+    const isWin = os21.platform() === "win32";
     const escapeArg = (a) => isWin ? `"${a.replace(/"/g, '""')}"` : `'${a.replace(/'/g, "'\\''")}'`;
     const promptMode = autoImpl?.promptMode ?? "stdin";
     const extraArgs = autoImpl?.extraArgs ?? [];
@@ -26273,7 +27358,7 @@ async function handleAutoImplement(ctx, type, req, res) {
     try {
       const pty = require("node-pty");
       ctx.log(`Auto-implement spawn (PTY): ${shellCmd}`);
-      const isWin2 = os20.platform() === "win32";
+      const isWin2 = os21.platform() === "win32";
       child = pty.spawn(isWin2 ? "cmd.exe" : process.env.SHELL || "/bin/zsh", [isWin2 ? "/c" : "-c", shellCmd], {
         name: "xterm-256color",
         cols: 120,
@@ -26513,7 +27598,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
     setMode: "set_mode.js"
   };
   const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-  const scriptsDir = path24.join(providerDir, "scripts");
+  const scriptsDir = path25.join(providerDir, "scripts");
   const latestScriptsDir = getLatestScriptVersionDir(scriptsDir);
   if (latestScriptsDir) {
     lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -26524,7 +27609,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
     for (const file of fs14.readdirSync(latestScriptsDir)) {
       if (file.endsWith(".js") && targetFileNames.has(file)) {
         try {
-          const content = fs14.readFileSync(path24.join(latestScriptsDir, file), "utf-8");
+          const content = fs14.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
           lines.push("```javascript");
           lines.push(content);
@@ -26541,7 +27626,7 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
       lines.push("");
       for (const file of refFiles) {
         try {
-          const content = fs14.readFileSync(path24.join(latestScriptsDir, file), "utf-8");
+          const content = fs14.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u{1F512}`);
           lines.push("```javascript");
           lines.push(content);
@@ -26582,10 +27667,10 @@ function buildAutoImplPrompt(ctx, type, provider, providerDir, functions, domCon
       lines.push("");
     }
   }
-  const docsDir = path24.join(providerDir, "../../docs");
+  const docsDir = path25.join(providerDir, "../../docs");
   const loadGuide = (name) => {
     try {
-      const p = path24.join(docsDir, name);
+      const p = path25.join(docsDir, name);
       if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
     } catch {
     }
@@ -26822,7 +27907,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
     parseApproval: "parse_approval.js"
   };
   const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-  const scriptsDir = path24.join(providerDir, "scripts");
+  const scriptsDir = path25.join(providerDir, "scripts");
   const latestScriptsDir = getLatestScriptVersionDir(scriptsDir);
   if (latestScriptsDir) {
     lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -26834,7 +27919,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       if (!file.endsWith(".js")) continue;
       if (!targetFileNames.has(file)) continue;
       try {
-        const content = fs14.readFileSync(path24.join(latestScriptsDir, file), "utf-8");
+        const content = fs14.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
         lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
         lines.push("```javascript");
         lines.push(content);
@@ -26850,7 +27935,7 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       lines.push("");
       for (const file of refFiles) {
         try {
-          const content = fs14.readFileSync(path24.join(latestScriptsDir, file), "utf-8");
+          const content = fs14.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u{1F512}`);
           lines.push("```javascript");
           lines.push(content);
@@ -26883,10 +27968,10 @@ function buildCliAutoImplPrompt(ctx, type, provider, providerDir, functions, ref
       lines.push("");
     }
   }
-  const docsDir = path24.join(providerDir, "../../docs");
+  const docsDir = path25.join(providerDir, "../../docs");
   const loadGuide = (name) => {
     try {
-      const p = path24.join(docsDir, name);
+      const p = path25.join(docsDir, name);
       if (fs14.existsSync(p)) return fs14.readFileSync(p, "utf-8");
     } catch {
     }
@@ -27333,8 +28418,8 @@ var DevServer = class _DevServer {
   }
   getEndpointList() {
     return this.routes.map((r) => {
-      const path26 = typeof r.pattern === "string" ? r.pattern : r.pattern.source.replace(/\\\//g, "/").replace(/\(\[.*?\]\+\)/g, ":type").replace(/[\^$]/g, "");
-      return `${r.method.padEnd(5)} ${path26}`;
+      const path27 = typeof r.pattern === "string" ? r.pattern : r.pattern.source.replace(/\\\//g, "/").replace(/\(\[.*?\]\+\)/g, ":type").replace(/[\^$]/g, "");
+      return `${r.method.padEnd(5)} ${path27}`;
     });
   }
   async start(port = DEV_SERVER_PORT) {
@@ -27622,12 +28707,12 @@ var DevServer = class _DevServer {
   // ─── DevConsole SPA ───
   getConsoleDistDir() {
     const candidates = [
-      path25.resolve(__dirname, "../../web-devconsole/dist"),
-      path25.resolve(__dirname, "../../../web-devconsole/dist"),
-      path25.join(process.cwd(), "packages/web-devconsole/dist")
+      path26.resolve(__dirname, "../../web-devconsole/dist"),
+      path26.resolve(__dirname, "../../../web-devconsole/dist"),
+      path26.join(process.cwd(), "packages/web-devconsole/dist")
     ];
     for (const dir of candidates) {
-      if (fs15.existsSync(path25.join(dir, "index.html"))) return dir;
+      if (fs15.existsSync(path26.join(dir, "index.html"))) return dir;
     }
     return null;
   }
@@ -27637,7 +28722,7 @@ var DevServer = class _DevServer {
       this.json(res, 500, { error: "DevConsole not found. Run: npm run build -w packages/web-devconsole" });
       return;
     }
-    const htmlPath = path25.join(distDir, "index.html");
+    const htmlPath = path26.join(distDir, "index.html");
     try {
       const html = fs15.readFileSync(htmlPath, "utf-8");
       res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
@@ -27662,15 +28747,15 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: "Not found" });
       return;
     }
-    const safePath = path25.normalize(pathname).replace(/^\.\.\//, "");
-    const filePath = path25.join(distDir, safePath);
+    const safePath = path26.normalize(pathname).replace(/^\.\.\//, "");
+    const filePath = path26.join(distDir, safePath);
     if (!filePath.startsWith(distDir)) {
       this.json(res, 403, { error: "Forbidden" });
       return;
     }
     try {
       const content = fs15.readFileSync(filePath);
-      const ext = path25.extname(filePath);
+      const ext = path26.extname(filePath);
       const contentType = _DevServer.MIME_MAP[ext] || "application/octet-stream";
       res.writeHead(200, { "Content-Type": contentType, "Cache-Control": "public, max-age=31536000, immutable" });
       res.end(content);
@@ -27783,9 +28868,9 @@ var DevServer = class _DevServer {
           const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
           if (entry.isDirectory()) {
             files.push({ path: rel, size: 0, type: "dir" });
-            scan(path25.join(d, entry.name), rel);
+            scan(path26.join(d, entry.name), rel);
           } else {
-            const stat2 = fs15.statSync(path25.join(d, entry.name));
+            const stat2 = fs15.statSync(path26.join(d, entry.name));
             files.push({ path: rel, size: stat2.size, type: "file" });
           }
         }
@@ -27808,7 +28893,7 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider directory not found: ${type}` });
       return;
     }
-    const fullPath = path25.resolve(dir, path25.normalize(filePath));
+    const fullPath = path26.resolve(dir, path26.normalize(filePath));
     if (!fullPath.startsWith(dir)) {
       this.json(res, 403, { error: "Forbidden" });
       return;
@@ -27833,14 +28918,14 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider directory not found: ${type}` });
       return;
     }
-    const fullPath = path25.resolve(dir, path25.normalize(filePath));
+    const fullPath = path26.resolve(dir, path26.normalize(filePath));
     if (!fullPath.startsWith(dir)) {
       this.json(res, 403, { error: "Forbidden" });
       return;
     }
     try {
       if (fs15.existsSync(fullPath)) fs15.copyFileSync(fullPath, fullPath + ".bak");
-      fs15.mkdirSync(path25.dirname(fullPath), { recursive: true });
+      fs15.mkdirSync(path26.dirname(fullPath), { recursive: true });
       fs15.writeFileSync(fullPath, content, "utf-8");
       this.log(`File saved: ${fullPath} (${content.length} chars)`);
       this.providerLoader.reload();
@@ -27857,7 +28942,7 @@ var DevServer = class _DevServer {
       return;
     }
     for (const name of ["scripts.js", "provider.json"]) {
-      const p = path25.join(dir, name);
+      const p = path26.join(dir, name);
       if (fs15.existsSync(p)) {
         const source = fs15.readFileSync(p, "utf-8");
         this.json(res, 200, { type, path: p, source, lines: source.split("\n").length });
@@ -27878,8 +28963,8 @@ var DevServer = class _DevServer {
       this.json(res, 404, { error: `Provider not found: ${type}` });
       return;
     }
-    const target = fs15.existsSync(path25.join(dir, "scripts.js")) ? "scripts.js" : "provider.json";
-    const targetPath = path25.join(dir, target);
+    const target = fs15.existsSync(path26.join(dir, "scripts.js")) ? "scripts.js" : "provider.json";
+    const targetPath = path26.join(dir, target);
     try {
       if (fs15.existsSync(targetPath)) fs15.copyFileSync(targetPath, targetPath + ".bak");
       fs15.writeFileSync(targetPath, source, "utf-8");
@@ -28026,7 +29111,7 @@ var DevServer = class _DevServer {
     }
     let targetDir;
     targetDir = this.providerLoader.getUserProviderDir(category, type);
-    const jsonPath = path25.join(targetDir, "provider.json");
+    const jsonPath = path26.join(targetDir, "provider.json");
     if (fs15.existsSync(jsonPath)) {
       this.json(res, 409, { error: `Provider already exists at ${targetDir}`, path: targetDir });
       return;
@@ -28038,8 +29123,8 @@ var DevServer = class _DevServer {
       const createdFiles = ["provider.json"];
       if (result.files) {
         for (const [relPath, content] of Object.entries(result.files)) {
-          const fullPath = path25.join(targetDir, relPath);
-          fs15.mkdirSync(path25.dirname(fullPath), { recursive: true });
+          const fullPath = path26.join(targetDir, relPath);
+          fs15.mkdirSync(path26.dirname(fullPath), { recursive: true });
           fs15.writeFileSync(fullPath, content, "utf-8");
           createdFiles.push(relPath);
         }
@@ -28092,22 +29177,22 @@ var DevServer = class _DevServer {
     if (!fs15.existsSync(scriptsDir)) return null;
     const versions = fs15.readdirSync(scriptsDir).filter((d) => {
       try {
-        return fs15.statSync(path25.join(scriptsDir, d)).isDirectory();
+        return fs15.statSync(path26.join(scriptsDir, d)).isDirectory();
       } catch {
         return false;
       }
     }).sort((a, b) => b.localeCompare(a, void 0, { numeric: true, sensitivity: "base" }));
     if (versions.length === 0) return null;
-    return path25.join(scriptsDir, versions[0]);
+    return path26.join(scriptsDir, versions[0]);
   }
   resolveAutoImplWritableProviderDir(category, type, requestedDir) {
-    const canonicalUserDir = path25.resolve(this.providerLoader.getUserProviderDir(category, type));
-    const desiredDir = requestedDir ? path25.resolve(requestedDir) : canonicalUserDir;
-    const upstreamRoot = path25.resolve(this.providerLoader.getUpstreamDir());
-    if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path25.sep}`)) {
+    const canonicalUserDir = path26.resolve(this.providerLoader.getUserProviderDir(category, type));
+    const desiredDir = requestedDir ? path26.resolve(requestedDir) : canonicalUserDir;
+    const upstreamRoot = path26.resolve(this.providerLoader.getUpstreamDir());
+    if (desiredDir === upstreamRoot || desiredDir.startsWith(`${upstreamRoot}${path26.sep}`)) {
       return { dir: null, reason: `Refusing to write into upstream provider directory: ${desiredDir}` };
     }
-    if (path25.basename(desiredDir) !== type) {
+    if (path26.basename(desiredDir) !== type) {
       return { dir: null, reason: `Requested writable provider directory must end with '${type}': ${desiredDir}` };
     }
     const sourceDir = this.findProviderDir(type);
@@ -28115,11 +29200,11 @@ var DevServer = class _DevServer {
       return { dir: null, reason: `Provider source directory not found for '${type}'` };
     }
     if (!fs15.existsSync(desiredDir)) {
-      fs15.mkdirSync(path25.dirname(desiredDir), { recursive: true });
+      fs15.mkdirSync(path26.dirname(desiredDir), { recursive: true });
       fs15.cpSync(sourceDir, desiredDir, { recursive: true });
       this.log(`Auto-implement writable copy created: ${desiredDir}`);
     }
-    const providerJson = path25.join(desiredDir, "provider.json");
+    const providerJson = path26.join(desiredDir, "provider.json");
     if (!fs15.existsSync(providerJson)) {
       return { dir: null, reason: `provider.json not found in writable provider directory: ${desiredDir}` };
     }
@@ -28155,7 +29240,7 @@ var DevServer = class _DevServer {
       setMode: "set_mode.js"
     };
     const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-    const scriptsDir = path25.join(providerDir, "scripts");
+    const scriptsDir = path26.join(providerDir, "scripts");
     const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
     if (latestScriptsDir) {
       lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -28166,7 +29251,7 @@ var DevServer = class _DevServer {
       for (const file of fs15.readdirSync(latestScriptsDir)) {
         if (file.endsWith(".js") && targetFileNames.has(file)) {
           try {
-            const content = fs15.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
+            const content = fs15.readFileSync(path26.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
             lines.push("```javascript");
             lines.push(content);
@@ -28183,7 +29268,7 @@ var DevServer = class _DevServer {
         lines.push("");
         for (const file of refFiles) {
           try {
-            const content = fs15.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
+            const content = fs15.readFileSync(path26.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u{1F512}`);
             lines.push("```javascript");
             lines.push(content);
@@ -28224,10 +29309,10 @@ var DevServer = class _DevServer {
         lines.push("");
       }
     }
-    const docsDir = path25.join(providerDir, "../../docs");
+    const docsDir = path26.join(providerDir, "../../docs");
     const loadGuide = (name) => {
       try {
-        const p = path25.join(docsDir, name);
+        const p = path26.join(docsDir, name);
         if (fs15.existsSync(p)) return fs15.readFileSync(p, "utf-8");
       } catch {
       }
@@ -28401,7 +29486,7 @@ var DevServer = class _DevServer {
       parseApproval: "parse_approval.js"
     };
     const targetFileNames = new Set(functions.map((fn) => funcToFile[fn]).filter(Boolean));
-    const scriptsDir = path25.join(providerDir, "scripts");
+    const scriptsDir = path26.join(providerDir, "scripts");
     const latestScriptsDir = this.getLatestScriptVersionDir(scriptsDir);
     if (latestScriptsDir) {
       lines.push(`Scripts version directory: \`${latestScriptsDir}\``);
@@ -28413,7 +29498,7 @@ var DevServer = class _DevServer {
         if (!file.endsWith(".js")) continue;
         if (!targetFileNames.has(file)) continue;
         try {
-          const content = fs15.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
+          const content = fs15.readFileSync(path26.join(latestScriptsDir, file), "utf-8");
           lines.push(`### \`${file}\` \u270F\uFE0F EDIT`);
           lines.push("```javascript");
           lines.push(content);
@@ -28429,7 +29514,7 @@ var DevServer = class _DevServer {
         lines.push("");
         for (const file of refFiles) {
           try {
-            const content = fs15.readFileSync(path25.join(latestScriptsDir, file), "utf-8");
+            const content = fs15.readFileSync(path26.join(latestScriptsDir, file), "utf-8");
             lines.push(`### \`${file}\` \u{1F512}`);
             lines.push("```javascript");
             lines.push(content);
@@ -28462,10 +29547,10 @@ var DevServer = class _DevServer {
         lines.push("");
       }
     }
-    const docsDir = path25.join(providerDir, "../../docs");
+    const docsDir = path26.join(providerDir, "../../docs");
     const loadGuide = (name) => {
       try {
-        const p = path25.join(docsDir, name);
+        const p = path26.join(docsDir, name);
         if (fs15.existsSync(p)) return fs15.readFileSync(p, "utf-8");
       } catch {
       }
@@ -29151,29 +30236,58 @@ function resolveSessionHostAppName(options = {}) {
 var import_session_host_core4 = require("@adhdev/session-host-core");
 var STARTUP_TIMEOUT_MS = DEFAULT_SESSION_HOST_READY_TIMEOUT_MS;
 var STARTUP_POLL_MS = 200;
-async function canConnect(endpoint) {
+var SessionHostCompatibilityError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "SessionHostCompatibilityError";
+  }
+};
+function getMissingRequestTypes(diagnostics, requiredRequestTypes) {
+  const supported = new Set(diagnostics?.supportedRequestTypes || []);
+  return requiredRequestTypes.filter((requestType) => !supported.has(requestType));
+}
+async function assertRequiredRequestTypes(client, requiredRequestTypes) {
+  if (requiredRequestTypes.length === 0) return;
+  const response = await client.request({
+    type: "get_host_diagnostics",
+    payload: { includeSessions: false }
+  });
+  const missing = getMissingRequestTypes(response.success ? response.result : void 0, requiredRequestTypes);
+  if (missing.length > 0) {
+    const detail = response.success ? "" : ` (${response.error || "capability probe failed"})`;
+    throw new SessionHostCompatibilityError(
+      `Session host does not support required request types: ${missing.join(", ")}${detail}`
+    );
+  }
+}
+async function canConnect(endpoint, requiredRequestTypes = []) {
   const client = new import_session_host_core4.SessionHostClient({ endpoint });
   try {
     await client.connect();
-    await client.close();
+    await assertRequiredRequestTypes(client, requiredRequestTypes);
     return true;
-  } catch {
+  } catch (error) {
+    if (error instanceof SessionHostCompatibilityError) throw error;
     return false;
+  } finally {
+    await client.close().catch(() => {
+    });
   }
 }
-async function waitForReady(endpoint, timeoutMs = STARTUP_TIMEOUT_MS) {
+async function waitForReady(endpoint, timeoutMs = STARTUP_TIMEOUT_MS, requiredRequestTypes = []) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
-    if (await canConnect(endpoint)) return;
+    if (await canConnect(endpoint, requiredRequestTypes)) return;
     await new Promise((resolve16) => setTimeout(resolve16, STARTUP_POLL_MS));
   }
   throw new Error(`Session host did not become ready within ${timeoutMs}ms`);
 }
 async function ensureSessionHostReady(options) {
   const endpoint = (0, import_session_host_core4.getDefaultSessionHostEndpoint)(options.appName || "adhdev");
-  if (await canConnect(endpoint)) return endpoint;
+  const requiredRequestTypes = options.requiredRequestTypes || [];
+  if (await canConnect(endpoint, requiredRequestTypes)) return endpoint;
   options.spawnHost();
-  await waitForReady(endpoint, options.timeoutMs);
+  await waitForReady(endpoint, options.timeoutMs, requiredRequestTypes);
   return endpoint;
 }
 async function listHostedCliRuntimes(endpoint) {
@@ -29465,48 +30579,6 @@ var SessionRegistry = class {
 // src/boot/daemon-lifecycle.ts
 init_logger();
 init_config();
-
-// src/mesh/mesh-events.ts
-init_mesh_config();
-init_logger();
-function setupMeshEventForwarding(components) {
-  components.instanceManager.onEvent((event) => {
-    if (event.event !== "agent:generating_completed" && event.event !== "agent:waiting_approval") return;
-    const instanceId = event.instanceId;
-    if (!instanceId) return;
-    const sourceInstance = components.instanceManager.getInstance(instanceId);
-    if (!sourceInstance || sourceInstance.category !== "cli") return;
-    const state = sourceInstance.getState();
-    const workspace = state.workspace;
-    if (!workspace) return;
-    const mesh = getMeshByRepo(workspace);
-    if (!mesh) return;
-    const allInstances = components.instanceManager.getByCategory("cli");
-    const coordinatorInstances = allInstances.filter((inst) => {
-      const instState = inst.getState();
-      if (instState.settings?.meshCoordinatorFor !== mesh.id) return false;
-      if (instState.instanceId === instanceId) return false;
-      return true;
-    });
-    if (coordinatorInstances.length === 0) return;
-    const targetNode = mesh.nodes.find((n) => n.workspace === workspace);
-    const nodeLabel = targetNode ? `Node '${targetNode.id}'` : `Agent at ${workspace}`;
-    let messageText = "";
-    if (event.event === "agent:generating_completed") {
-      messageText = `[System] ${nodeLabel} has completed its task and is now idle. You may use mesh_read_chat to review its progress.`;
-    } else if (event.event === "agent:waiting_approval") {
-      messageText = `[System] ${nodeLabel} is waiting for approval to proceed. You may use mesh_read_chat and mesh_approve to handle it.`;
-    }
-    if (!messageText) return;
-    for (const coord of coordinatorInstances) {
-      const coordState = coord.getState();
-      LOG.info("MeshEvents", `Forwarding event from ${workspace} to coordinator ${coordState.instanceId}`);
-      coord.onEvent("send_message", { input: { text: messageText, textFallback: messageText } });
-    }
-  });
-}
-
-// src/boot/daemon-lifecycle.ts
 async function initDaemonComponents(config) {
   installGlobalInterceptor();
   const appConfig = loadConfig();
@@ -29813,12 +30885,14 @@ async function shutdownDaemonComponents(components) {
   createGitWorkspaceMonitor,
   createInteractionId,
   createMesh,
+  createWorktree,
   deleteMesh,
   detectAllVersions,
   detectCLIs,
   detectIDEs,
   ensureSessionHostReady,
   execNpmCommandSync,
+  filterUserFacingChatMessages,
   findCdpManager,
   flattenMessageParts,
   forwardAgentStreamsToIdeInstance,
@@ -29860,11 +30934,13 @@ async function shutdownDaemonComponents(components) {
   isSessionHostLiveRuntime,
   isSessionHostRecoverySnapshot,
   isSetupComplete,
+  isUserFacingChatMessage,
   killIdeProcess,
   launchIDE,
   launchWithCdp,
   listHostedCliRuntimes,
   listMeshes,
+  listWorktrees,
   loadConfig,
   loadState,
   logCommand,
@@ -29884,6 +30960,7 @@ async function shutdownDaemonComponents(components) {
   normalizeSessionModalFields,
   parsePorcelainV2Status,
   parseProviderSourceConfigUpdate,
+  parseWorktreeListOutput,
   partitionSessionHostDiagnosticsSessions,
   partitionSessionHostRecords,
   prepareSessionChatTailUpdate,
@@ -29893,6 +30970,7 @@ async function shutdownDaemonComponents(components) {
   recordDebugTrace,
   registerExtensionProviders,
   removeNode,
+  removeWorktree,
   resetConfig,
   resetDebugRuntimeConfig,
   resetState,
@@ -29902,6 +30980,7 @@ async function shutdownDaemonComponents(components) {
   resolveGitRepository,
   resolveSessionHostAppName,
   resolveSessionHostAppNameResolution,
+  resolveWorktreePath,
   runAsyncBatch,
   runGit,
   saveConfig,