@adhdev/daemon-standalone 0.9.82-rc.373 → 0.9.82-rc.375

package/vendor/mcp-server/index.js

@@ -382,213 +382,57 @@ function annotateRapidReadChatAdvisory(payload, options) {
 }
 
 // src/tools/mesh-tools.ts
-var import_daemon_core = require("@adhdev/daemon-core");
-var SESSION_PROVIDER_METADATA_TTL_MS = 30 * 6e4;
-var meshSessionProviderMetadata = /* @__PURE__ */ new Map();
-function getSessionMetadata(key) {
-  const entry = meshSessionProviderMetadata.get(key);
-  if (!entry) return void 0;
-  if (entry.expiresAt <= Date.now()) {
-    meshSessionProviderMetadata.delete(key);
-    return void 0;
-  }
-  return entry;
-}
-var ACTIVE_WORK_POLLING_BACKOFF_MS = 6e4;
-function buildActiveWorkPollingGuidance(summary, now = Date.now()) {
-  if (!summary || summary.generatingCount <= 0) return void 0;
-  return {
-    activeGeneratingWork: true,
-    generatingCount: summary.generatingCount,
-    doNotPollBefore: new Date(now + ACTIVE_WORK_POLLING_BACKOFF_MS).toISOString(),
-    eventSurface: "pendingCoordinatorEvents",
-    nextRecommendedAction: "Wait for pendingCoordinatorEvents/completion events or an explicit user status request. If no terminal evidence appears and the user asks for status, make one bounded status check, then wait again.",
-    message: "Do not repeatedly poll mesh_status/mesh_view_queue/mesh_read_chat while delegated work is generating; terminal ledger or completion evidence will be surfaced through pendingCoordinatorEvents when available."
-  };
-}
+var import_daemon_core2 = require("@adhdev/daemon-core");
+
+// src/tools/mesh-tool-shared.ts
 function readString(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
-function summarizeTaskMessage(message) {
-  const taskSummary = message.replace(/\s+/g, " ").trim();
-  const taskTitle = taskSummary.length > 96 ? `${taskSummary.slice(0, 93)}...` : taskSummary;
-  return { taskTitle: taskTitle || "(untitled task)", taskSummary };
-}
-function buildDirectTaskPayload(message, via, opts) {
-  const descriptor = summarizeTaskMessage(message);
-  return {
-    source: "direct",
-    via,
-    taskId: opts.taskId,
-    message,
-    taskTitle: descriptor.taskTitle,
-    taskSummary: descriptor.taskSummary,
-    ...opts.taskMode ? { taskMode: opts.taskMode } : {},
-    ...opts.providerType ? { providerType: opts.providerType } : {},
-    ...opts.targetSessionId ? { targetSessionId: opts.targetSessionId } : {},
-    ...opts.dispatchedToIdleSession !== void 0 ? { dispatchedToIdleSession: opts.dispatchedToIdleSession } : {}
-  };
-}
-function findNode(mesh, nodeId) {
-  const node = mesh.nodes.find((n) => (0, import_daemon_core.meshNodeIdMatches)(n, nodeId));
-  if (!node) throw new Error(`Node '${nodeId}' is not a member of mesh '${mesh.name}'`);
-  return node;
-}
-var DUPLICATE_DISPATCH_WINDOW_MS = 6e4;
-var STALE_ASSIGNED_QUEUE_MS = 30 * 6e4;
-var OLD_HISTORICAL_QUEUE_RECORD_MS = 7 * 24 * 60 * 6e4;
-var ACTIVE_QUEUE_STATUSES = /* @__PURE__ */ new Set(["pending", "assigned"]);
-var HISTORICAL_QUEUE_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
-async function refreshMeshFromDaemon(ctx) {
-  try {
-    const result = await ctx.transport.command("get_mesh", { meshId: ctx.mesh.id });
-    if (!result?.success || !Array.isArray(result.mesh?.nodes)) return;
-    const refreshedNodes = result.mesh.nodes.filter((n) => n?.id).map((n) => n);
-    ctx.mesh.nodes.splice(0, ctx.mesh.nodes.length, ...refreshedNodes);
-    ctx.mesh.updatedAt = result.mesh.updatedAt ?? ctx.mesh.updatedAt;
-  } catch {
-  }
+function readNumeric(value, fallback = 0) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : fallback;
 }
-async function syncCoordinatorDaemonMeshCache(ctx) {
-  if (!(ctx.transport instanceof IpcTransport)) return;
-  try {
-    await ctx.transport.command("get_mesh", {
-      meshId: ctx.mesh.id,
-      inlineMesh: ctx.mesh
-    });
-  } catch {
+var LARGE_LEDGER_FIELD_KEYS = /* @__PURE__ */ new Set(["plan", "validationPlan", "suggestedConfig", "payload"]);
+var LARGE_LEDGER_OBJECT_THRESHOLD = 800;
+var LARGE_LEDGER_NESTED_BYTES_THRESHOLD = 2e3;
+function summarizeLargeLedgerField(key, value) {
+  if (typeof value === "string") {
+    return value.length > 500 ? value.slice(0, 500) + "\u2026" : value;
   }
-}
-async function findNodeWithRefresh(ctx, nodeId) {
-  const hit = ctx.mesh.nodes.find((n) => (0, import_daemon_core.meshNodeIdMatches)(n, nodeId));
-  if (hit && !hit.isLocalWorktree) return hit;
-  await refreshMeshFromDaemon(ctx);
-  const refreshed = ctx.mesh.nodes.find((n) => (0, import_daemon_core.meshNodeIdMatches)(n, nodeId));
-  if (!refreshed) throw new Error(`Node '${nodeId}' is not a member of mesh '${ctx.mesh.name}'`);
-  return refreshed;
-}
-async function findOptionalNodeWithRefresh(ctx, nodeId) {
-  const hit = ctx.mesh.nodes.find((n) => (0, import_daemon_core.meshNodeIdMatches)(n, nodeId));
-  if (hit && !hit.isLocalWorktree) return hit;
-  await refreshMeshFromDaemon(ctx);
-  return ctx.mesh.nodes.find((n) => (0, import_daemon_core.meshNodeIdMatches)(n, nodeId)) ?? null;
-}
-function hasRecentDuplicateDispatch(ctx, args) {
-  const now = Date.now();
-  const normalizedMessage = args.message.trim();
-  for (const task of (0, import_daemon_core.getQueue)(ctx.mesh.id)) {
-    const timestamp = new Date(task.updatedAt || task.createdAt).getTime();
-    if (!Number.isFinite(timestamp) || now - timestamp > DUPLICATE_DISPATCH_WINDOW_MS) continue;
-    if (task.targetNodeId && task.targetNodeId !== args.node_id) continue;
-    if (task.assignedNodeId && task.assignedNodeId !== args.node_id) continue;
-    if (args.session_id && task.targetSessionId !== args.session_id && task.assignedSessionId !== args.session_id) continue;
-    if (task.message?.trim() === normalizedMessage) {
-      return { duplicate: true, entry: task, source: "queue" };
+  if (Array.isArray(value)) {
+    const serialized = JSON.stringify(value);
+    if (serialized && serialized.length > LARGE_LEDGER_OBJECT_THRESHOLD) {
+      return `[${key} summarized: ${value.length} items \u2014 use verbose=true or mesh_reconcile_ledger]`;
     }
+    return value;
   }
-  const entries = (0, import_daemon_core.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
-  for (let i = entries.length - 1; i >= 0; i -= 1) {
-    const entry = entries[i];
-    const timestamp = new Date(entry.timestamp).getTime();
-    if (Number.isFinite(timestamp) && now - timestamp > DUPLICATE_DISPATCH_WINDOW_MS) break;
-    if (entry.kind !== "task_dispatched") continue;
-    if (entry.nodeId !== args.node_id) continue;
-    if (args.session_id && entry.sessionId !== args.session_id) continue;
-    if (typeof entry.payload?.message !== "string") continue;
-    if (entry.payload.message.trim() === normalizedMessage) {
-      return { duplicate: true, entry, source: "ledger" };
+  if (value && typeof value === "object") {
+    const serialized = JSON.stringify(value);
+    if (serialized && serialized.length > LARGE_LEDGER_OBJECT_THRESHOLD) {
+      return `[${key} summarized: ${Object.keys(value).length} keys \u2014 use verbose=true or mesh_reconcile_ledger]`;
     }
+    return value;
   }
-  return { duplicate: false };
+  return value;
 }
-function buildMissingNodeReadChatRecovery(ctx, args) {
-  const entries = (0, import_daemon_core.readLedgerEntries)(ctx.mesh.id, { tail: 300 });
-  const relatedEntries = entries.filter((entry) => entry.nodeId === args.node_id || entry.sessionId === args.session_id);
-  const completedEntries = relatedEntries.filter((entry) => entry.kind === "task_completed");
-  const lastDispatch = [...relatedEntries].reverse().find((entry) => entry.kind === "task_dispatched");
-  const lastTerminal = [...relatedEntries].reverse().find((entry) => entry.kind === "task_completed" || entry.kind === "task_failed" || entry.kind === "task_stalled");
-  const lastRemoved = [...relatedEntries].reverse().find((entry) => entry.kind === "node_removed");
-  const lastLaunch = [...relatedEntries].reverse().find((entry) => entry.kind === "session_launched");
-  const providerSessionId = args.provider_session_id || readString(lastTerminal?.payload?.providerSessionId) || readString(lastLaunch?.payload?.providerSessionId) || readString(lastDispatch?.payload?.providerSessionId);
-  const finalSummary = readString(lastTerminal?.payload?.finalSummary) || readString(lastTerminal?.payload?.compactSummary) || readString(lastTerminal?.payload?.summary);
-  const ledger = {
-    taskCompletedFound: completedEntries.length > 0,
-    nodeRemovedFound: !!lastRemoved,
-    providerType: lastTerminal?.providerType || lastLaunch?.providerType || lastDispatch?.providerType,
-    providerSessionId,
-    nodeRemovedAt: lastRemoved?.timestamp,
-    sessionCleanupMode: readString(lastRemoved?.payload?.sessionCleanupMode),
-    readDebugLocator: readString(lastTerminal?.payload?.readDebugLocator) || readString(lastTerminal?.payload?.debugBundlePath)
-  };
-  if (finalSummary) {
-    if (args.compact === true) {
-      return {
-        ...compactChatPayload({
-          success: true,
-          status: "idle",
-          providerSessionId,
-          summary: finalSummary,
-          messages: [{ role: "assistant", content: finalSummary, isHistorical: true }]
-        }, {
-          nodeId: args.node_id,
-          sessionId: args.session_id,
-          limit: args.tail ?? 10
-        }),
-        recoveredFromLedger: true,
-        ledger
-      };
-    }
-    return {
-      success: true,
-      compact: false,
-      recoveredFromLedger: true,
-      nodeId: args.node_id,
-      sessionId: args.session_id,
-      summary: finalSummary,
-      ledger,
-      messages: [{ role: "assistant", content: finalSummary, isHistorical: true }]
-    };
+function elideLargeNestedValue(key, value) {
+  if (value === null || value === void 0) return value;
+  if (typeof value === "string") {
+    return value.length > 1e3 ? value.slice(0, 1e3) + "\u2026" : value;
   }
+  if (typeof value !== "object") return value;
+  const serialized = JSON.stringify(value);
+  const bytes = serialized ? serialized.length : 0;
+  if (bytes <= LARGE_LEDGER_NESTED_BYTES_THRESHOLD) return value;
   return {
-    success: false,
-    recoverable: true,
-    code: "mesh_removed_node_transcript_unavailable",
-    error: `Node '${args.node_id}' is not a current member of mesh '${ctx.mesh.name}'.`,
-    nodeId: args.node_id,
-    sessionId: args.session_id,
-    providerSessionId,
-    reason: "node_not_in_current_mesh_snapshot",
-    ledger,
-    completedSessionSeenInLedger: ledger.taskCompletedFound,
-    lastDispatch: lastDispatch ? {
-      timestamp: lastDispatch.timestamp,
-      sessionId: lastDispatch.sessionId,
-      providerType: lastDispatch.providerType,
-      taskId: typeof lastDispatch.payload?.taskId === "string" ? lastDispatch.payload.taskId : void 0,
-      messagePreview: typeof lastDispatch.payload?.message === "string" ? lastDispatch.payload.message.slice(0, 500) : void 0
-    } : null,
-    lastTerminalEvent: lastTerminal ? {
-      kind: lastTerminal.kind,
-      timestamp: lastTerminal.timestamp,
-      sessionId: lastTerminal.sessionId,
-      providerType: lastTerminal.providerType,
-      taskId: typeof lastTerminal.payload?.taskId === "string" ? lastTerminal.payload.taskId : void 0,
-      payload: lastTerminal.payload
-    } : null,
-    nextSteps: [
-      providerSessionId ? `Retry mesh_read_chat with provider_session_id='${providerSessionId}' on a current live node for the same daemon if one exists.` : "If the node UI shows a provider transcript id, retry mesh_read_chat/mesh_read_debug with provider_session_id.",
-      "Use mesh_read_debug with the provider_session_id or daemon-side debug bundle locator if available.",
-      "Check mesh_task_history for task_completed and node_removed entries before redispatching; do not resend solely because transcript recovery failed.",
-      "If this node was removed with stop_and_delete, the runtime transcript may be gone; rely on the ledger summary/locator or ask the operator for the saved UI output."
-    ],
-    recoveryHints: [
-      "The worktree/node may have been removed or the mesh snapshot may be stale after task completion.",
-      "If you have a provider_session_id, retry mesh_read_chat with that value while targeting a live node for the same daemon if available.",
-      "Use mesh_read_debug with provider_session_id, or inspect the daemon/session-host history locator if the transcript has already been archived.",
-      "Avoid redispatching the same task solely because read_chat could not recover the transcript; check task_history and git status first."
-    ]
+    _elided: true,
+    _kind: key,
+    _bytes: bytes,
+    _hint: "full evidence via mesh_reconcile_ledger"
   };
 }
+
+// src/tools/mesh-session-helpers.ts
 function readSessionRecordId(session) {
   return readString(session?.id) || readString(session?.sessionId) || readString(session?.session_id) || readString(session?.runtimeSessionId) || readString(session?.runtime_session_id) || readString(session?.instanceId) || readString(session?.instance_id);
 }
@@ -656,6 +500,36 @@ function collectNodeSessionIds(node) {
   sessionRecords.forEach((session) => addSessionRecord(sessions, session));
   return sessions;
 }
+function unwrapCommandPayload(value) {
+  let current = value;
+  const seen = /* @__PURE__ */ new Set();
+  for (let depth = 0; depth < 8; depth += 1) {
+    if (!current || typeof current !== "object" || seen.has(current)) break;
+    seen.add(current);
+    const nested = current.result ?? current.payload;
+    if (!nested || typeof nested !== "object") break;
+    current = nested;
+  }
+  return current;
+}
+function isTerminalSessionRecord(session) {
+  const status = typeof session?.status === "string" ? session.status.toLowerCase() : "";
+  const lifecycle = typeof session?.lifecycle === "string" ? session.lifecycle.toLowerCase() : "";
+  const state = typeof session?.state === "string" ? session.state.toLowerCase() : "";
+  return [status, lifecycle, state].some((value) => ["stopped", "failed", "terminated", "exited", "closed"].includes(value));
+}
+function isIdleSessionRecord(session) {
+  if (isTerminalSessionRecord(session)) return false;
+  const status = typeof session?.status === "string" ? session.status.toLowerCase() : "";
+  const chatStatus = typeof session?.activeChat?.status === "string" ? session.activeChat.status.toLowerCase() : "";
+  return status === "idle" || chatStatus === "waiting_input";
+}
+
+// src/tools/mesh-queue-helpers.ts
+var STALE_ASSIGNED_QUEUE_MS = 30 * 6e4;
+var OLD_HISTORICAL_QUEUE_RECORD_MS = 7 * 24 * 60 * 6e4;
+var ACTIVE_QUEUE_STATUSES = /* @__PURE__ */ new Set(["pending", "assigned"]);
+var HISTORICAL_QUEUE_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 function buildQueueLivenessIndex(mesh) {
   const nodeIds = /* @__PURE__ */ new Set();
   const nodeSessionIds = /* @__PURE__ */ new Map();
@@ -885,403 +759,105 @@ function annotateQueueStaleness(queue, mesh) {
     };
   });
 }
-function unwrapCommandPayload(value) {
-  let current = value;
-  const seen = /* @__PURE__ */ new Set();
-  for (let depth = 0; depth < 8; depth += 1) {
-    if (!current || typeof current !== "object" || seen.has(current)) break;
-    seen.add(current);
-    const nested = current.result ?? current.payload;
-    if (!nested || typeof nested !== "object") break;
-    current = nested;
-  }
-  return current;
-}
-function isDirectDispatchLedgerEntry(entry) {
-  if (entry?.kind !== "task_dispatched") return false;
-  const payload = entry.payload || {};
-  const via = readString(payload.via);
-  return payload.source === "direct" || via === "p2p_direct" || via === "local_direct" || via === "mesh_send_task";
-}
-function readMessageTimestampIso(message) {
-  for (const value of [message?.timestamp, message?.createdAt, message?.created_at, message?.updatedAt, message?.time]) {
-    if (typeof value === "number" && Number.isFinite(value)) {
-      const ms = value > 1e10 ? value : value * 1e3;
-      return new Date(ms).toISOString();
-    }
-    if (typeof value === "string" && value.trim()) {
-      const ms = new Date(value.trim()).getTime();
-      if (Number.isFinite(ms)) return new Date(ms).toISOString();
-    }
+
+// src/tools/mesh-compact.ts
+function buildCompactGitSnapshot(status) {
+  if (!status || typeof status !== "object" || Array.isArray(status)) return void 0;
+  const slim = {};
+  const carry = [
+    "isGitRepo",
+    "branch",
+    "headCommit",
+    "upstream",
+    "upstreamStatus",
+    "ahead",
+    "behind",
+    "dirty",
+    "detached",
+    "submodules"
+  ];
+  for (const key of carry) {
+    if (status[key] !== void 0) slim[key] = status[key];
   }
-  return void 0;
+  return slim;
 }
-function readFinalAssistantTranscriptEvidence(payload) {
-  const rawMessages = Array.isArray(payload?.messages) ? payload.messages : [];
-  const finalAssistant = [...rawMessages].reverse().filter(isCoordinatorVisibleMessage).find((message) => {
-    const role = String(message?.role ?? "").toLowerCase();
-    return (role === "assistant" || role === "agent") && messageContent(message).trim();
-  });
-  const finalSummary = messageContent(finalAssistant).trim() || (typeof payload?.summary === "string" && payload.summary.trim() ? payload.summary.trim() : void 0);
+function summarizeCompactSubmodules(submodules) {
+  if (!Array.isArray(submodules) || submodules.length === 0) return void 0;
+  const outOfSync = submodules.filter((s) => s?.outOfSync).map((s) => s?.path).filter(Boolean);
   return {
-    finalSummary,
-    transcriptMessageAt: finalAssistant ? readMessageTimestampIso(finalAssistant) : void 0
+    count: submodules.length,
+    ...outOfSync.length > 0 ? { outOfSyncPaths: outOfSync } : {}
   };
 }
-function findNodeSession(nodes, nodeId, sessionId) {
-  if (!nodeId || !sessionId) return {};
-  const node = nodes.find((candidate) => (0, import_daemon_core.meshNodeIdMatches)(candidate, nodeId));
-  if (!node) return {};
-  const sessions = Array.isArray(node.sessions) ? node.sessions : [];
-  const session = sessions.find((candidate) => readSessionRecordId(candidate) === sessionId);
-  return { node, session };
-}
-function buildDirectDispatchReconciliationCandidates(directDispatches, ledgerEntries) {
-  const candidates = [];
-  const seenTaskIds = /* @__PURE__ */ new Set();
-  for (const dispatch of directDispatches || []) {
-    const taskId = readString(dispatch?.taskId);
-    if (!taskId || seenTaskIds.has(taskId)) continue;
-    seenTaskIds.add(taskId);
-    candidates.push(dispatch);
-  }
-  for (const entry of ledgerEntries || []) {
-    if (!isDirectDispatchLedgerEntry(entry)) continue;
-    const taskId = readString(entry.payload?.taskId);
-    if (!taskId || seenTaskIds.has(taskId)) continue;
-    seenTaskIds.add(taskId);
-    candidates.push({
-      taskId,
-      nodeId: entry.nodeId,
-      sessionId: entry.sessionId,
-      providerType: entry.providerType || readString(entry.payload?.providerType),
-      message: readString(entry.payload?.message),
-      dispatchedAt: entry.timestamp,
-      via: readString(entry.payload?.via)
-    });
-  }
-  return candidates;
-}
-async function reconcileDirectDispatchesFromTranscriptEvidence(ctx, liveNodes, directDispatches, ledgerEntries) {
-  let attempted = 0;
-  let reconciled = 0;
-  let skipped = 0;
-  const candidates = buildDirectDispatchReconciliationCandidates(directDispatches, ledgerEntries);
-  for (const dispatch of candidates) {
-    const taskId = readString(dispatch?.taskId);
-    const nodeId = readString(dispatch?.nodeId);
-    const sessionId = readString(dispatch?.sessionId);
-    if (!taskId || !nodeId || !sessionId) {
-      skipped += 1;
-      continue;
-    }
-    const { session } = findNodeSession(liveNodes, nodeId, sessionId);
-    if (!session || !isIdleSessionRecord(session)) {
-      skipped += 1;
-      continue;
-    }
-    const node = await findOptionalNodeWithRefresh(ctx, nodeId).catch(() => null);
-    if (!node) {
-      skipped += 1;
-      continue;
-    }
-    const providerType = readString(dispatch?.providerType) || resolveSessionProviderType(session);
-    const providerSessionId = readString(session?.providerSessionId) || readString(session?.activeChat?.providerSessionId) || readString(session?.settings?.providerSessionId) || resolveMeshSessionProviderMetadata(ctx, nodeId, sessionId)?.providerSessionId;
-    attempted += 1;
-    try {
-      const readResult = await commandForNode(ctx, node, "read_chat", {
-        sessionId,
-        targetSessionId: sessionId,
-        workspace: node.workspace,
-        ...providerType ? { agentType: providerType, providerType } : {},
-        ...providerSessionId ? { providerSessionId } : {},
-        tailLimit: 10
-      });
-      const payload = unwrapCommandPayload(readResult);
-      if (payload?.success === false) continue;
-      const evidence = readFinalAssistantTranscriptEvidence(payload);
-      if (!evidence.finalSummary) continue;
-      const result = (0, import_daemon_core.reconcileDirectDispatchCompletionFromTranscript)({
-        meshId: ctx.mesh.id,
-        nodeId,
-        sessionId,
-        providerType,
-        providerSessionId: readString(payload?.providerSessionId) || providerSessionId,
-        taskId,
-        finalSummary: evidence.finalSummary,
-        transcriptMessageAt: evidence.transcriptMessageAt,
-        targetCoordinatorDaemonId: ctx.localDaemonId,
-        source: "mcp_mesh_status_transcript_reconciliation"
-      });
-      if (result.reconciled) reconciled += 1;
-    } catch {
-      skipped += 1;
+var MESH_COMPACT_PRESERVED_MARKER_FIELDS = ["dataFreshness"];
+function compactMeshStatusNode(entry) {
+  if (!entry || typeof entry !== "object") return entry;
+  const next = { ...entry };
+  if (next.git !== void 0) {
+    const slimGit = buildCompactGitSnapshot(next.git);
+    if (slimGit) {
+      if (slimGit.submodules !== void 0) {
+        const subSummary = summarizeCompactSubmodules(slimGit.submodules);
+        if (subSummary) slimGit.submodules = subSummary;
+        else delete slimGit.submodules;
+      }
+      next.git = slimGit;
     }
   }
-  return { attempted, reconciled, skipped };
-}
-async function triggerMeshQueueAndReport(ctx) {
-  try {
-    const raw = await ctx.transport.command("trigger_mesh_queue", { meshId: ctx.mesh.id });
-    const payload = unwrapCommandPayload(raw);
-    const trigger = payload?.trigger && typeof payload.trigger === "object" ? payload.trigger : payload;
-    return trigger && typeof trigger === "object" ? trigger : { success: true };
-  } catch (e) {
-    return {
-      success: false,
-      error: e?.message || String(e)
+  if (next.machine && typeof next.machine === "object") {
+    const m = next.machine;
+    next.machine = {
+      daemonId: m.daemonId,
+      machineId: m.machineId,
+      hostname: m.hostname,
+      displayName: m.displayName,
+      sameMachine: m.sameMachine,
+      locality: m.locality
     };
   }
-}
-function buildQueueTriggerGuidance(queueTrigger) {
-  if (!queueTrigger || queueTrigger.claimed === true) return void 0;
-  if (queueTrigger.success === false) {
-    return {
-      queueClaimed: false,
-      queueDispatchState: "trigger_failed",
-      nextAction: "Do not assume the queued task is running. Check mesh_view_queue and daemon connectivity before redispatching."
-    };
+  if (typeof next.submoduleWarning === "string") {
+    next.submodulesOutOfSync = true;
+    delete next.submoduleWarning;
   }
-  if (queueTrigger.autoLaunchPending === true) {
-    return {
-      queueClaimed: false,
-      queueDispatchState: "pending_waiting_for_autolaunch",
-      nextAction: "A worker session was just auto-launched for this task and is booting; it will claim the task shortly. Wait for it to claim \u2014 do NOT launch another session. Use mesh_view_queue to confirm the assignment lands."
+  if (next.staleDaemonBuild && typeof next.staleDaemonBuild === "object") {
+    const b = next.staleDaemonBuild;
+    next.staleDaemonBuild = {
+      scope: b.scope,
+      isDaemonAffecting: b.isDaemonAffecting !== false,
+      seeStaleDaemonBuilds: true
     };
   }
-  if (queueTrigger.noIdleMeshSessionAvailable === true) {
-    return {
-      queueClaimed: false,
-      queueDispatchState: "pending_no_idle_mesh_session",
-      nextAction: "The task is queued but not running. Launch a managed worker with mesh_launch_session, or wait for a delegated session to become ready and trigger the queue again."
-    };
+  delete next.capabilityTagsByProvider;
+  const elideSkip = /* @__PURE__ */ new Set(["git", "machine", "branchConvergence", "staleDaemonBuild", "sessions", ...MESH_COMPACT_PRESERVED_MARKER_FIELDS]);
+  for (const k of Object.keys(next)) {
+    if (elideSkip.has(k)) continue;
+    next[k] = elideLargeNestedValue(k, next[k]);
   }
-  return {
-    queueClaimed: false,
-    queueDispatchState: "pending_or_waiting_for_ready",
-    nextAction: "The task is queued but this trigger did not claim it. Use mesh_view_queue for the current active-work source of truth before retrying."
-  };
+  return next;
 }
-function isTerminalSessionRecord(session) {
-  const status = typeof session?.status === "string" ? session.status.toLowerCase() : "";
-  const lifecycle = typeof session?.lifecycle === "string" ? session.lifecycle.toLowerCase() : "";
-  const state = typeof session?.state === "string" ? session.state.toLowerCase() : "";
-  return [status, lifecycle, state].some((value) => ["stopped", "failed", "terminated", "exited", "closed"].includes(value));
+function compactNodeSeverity(entry) {
+  if (!entry || typeof entry !== "object") return 0;
+  if (entry.error || entry.health && entry.health !== "online" && entry.health !== "dirty") return 5;
+  if (entry.launchReady === false) return 4;
+  if (entry.isDirty === true || entry.health === "dirty") return 3;
+  if (entry.branchConvergence?.needsConvergence === true) return 2;
+  if (entry.staleDaemonBuild || entry.submodulesOutOfSync || entry.recoveryHints) return 1;
+  return 0;
 }
-function isIdleSessionRecord(session) {
-  if (isTerminalSessionRecord(session)) return false;
-  const status = typeof session?.status === "string" ? session.status.toLowerCase() : "";
-  const chatStatus = typeof session?.activeChat?.status === "string" ? session.activeChat.status.toLowerCase() : "";
-  return status === "idle" || chatStatus === "waiting_input";
-}
-function isMeshOwnedDelegateSession(session, meshId, nodeId) {
-  const settings = session?.settings;
-  const sessionMeshId = typeof settings?.meshNodeFor === "string" ? settings.meshNodeFor.trim() : "";
-  const sessionNodeId = typeof settings?.meshNodeId === "string" ? settings.meshNodeId.trim() : "";
-  if (sessionMeshId) {
-    if (sessionMeshId !== meshId) return false;
-    return !sessionNodeId || sessionNodeId === nodeId;
-  }
-  const coordinatorOwned = settings?.launchedByCoordinator === true || Boolean(readString(settings?.meshCoordinatorDaemonId));
-  if (!coordinatorOwned) return false;
-  const lastNodeId = readString(settings?.meshLastNodeId);
-  if (lastNodeId) return lastNodeId === nodeId;
-  return true;
-}
-function hasRemoteRelayMetadata(session) {
-  return Boolean(
-    readString(session?.settings?.meshCoordinatorDaemonId) || readString(session?.meta?.meshCoordinatorDaemonId) || readString(session?.metadata?.meshCoordinatorDaemonId) || readString(session?.meshCoordinatorDaemonId)
-  );
-}
-function classifyRemoteDelegateRelaySafety(session, meshId, nodeId, coordinatorDaemonId) {
-  if (!isMeshOwnedDelegateSession(session, meshId, nodeId)) return "unsafe_alias";
-  if (hasRemoteRelayMetadata(session)) return "safe";
-  return coordinatorDaemonId ? "self_heal" : "missing_anchor";
-}
-function chooseDispatchableSession(sessions, providerType, meshId, nodeId, coordinatorDaemonId) {
-  const live = sessions.filter((session) => !isTerminalSessionRecord(session));
-  const matchingProvider = (session) => !providerType || session?.providerType === providerType || session?.cliType === providerType;
-  const meshSessions = live.filter((session) => {
-    const safety = classifyRemoteDelegateRelaySafety(session, meshId, nodeId, coordinatorDaemonId);
-    return safety === "safe" || safety === "self_heal";
-  });
-  return meshSessions.find((session) => isIdleSessionRecord(session) && matchingProvider(session)) || void 0;
-}
-function buildRelayUnsafeRemoteSessionFailure(ctx, node, sessionId, providerType) {
-  return {
-    success: false,
-    recoverable: true,
-    code: "mesh_delegate_session_missing_relay_metadata",
-    reason: "mesh_delegate_session_missing_relay_metadata",
-    transport: "mesh_transport",
-    retryRecommended: true,
-    meshId: ctx.mesh.id,
-    nodeId: node.id,
-    daemonId: node.daemonId,
-    workspace: node.workspace,
-    sessionId,
-    unsafeTranscriptAlias: true,
-    ...providerType ? { resolvedProviderType: providerType } : {},
-    error: `Remote session '${sessionId}' is not relay-safe for mesh '${ctx.mesh.id}': missing meshNodeFor/meshCoordinatorDaemonId metadata, so completion events would not reach the coordinator ledger. This session may be the coordinator itself or an unrelated session (unsafe_transcript_alias risk).`,
-    nextAction: `Launch a fresh relay-safe session with mesh_launch_session(node_id: '${node.id}'${providerType ? `, type: '${providerType}'` : ""}) or dispatch without session_id so Repo Mesh can choose a valid delegate session.`,
-    noFallbackReason: "Blindly reusing a remote session without mesh relay metadata would silently drop task_completed / generating_completed events."
-  };
-}
-function buildMissingCoordinatorDaemonIdFailure(ctx, node, providerType) {
-  return {
-    success: false,
-    recoverable: true,
-    code: "mesh_coordinator_daemon_unknown",
-    reason: "mesh_coordinator_daemon_unknown",
-    transport: "mesh_transport",
-    retryRecommended: true,
-    meshId: ctx.mesh.id,
-    nodeId: node.id,
-    daemonId: node.daemonId,
-    workspace: node.workspace,
-    ...providerType ? { resolvedProviderType: providerType } : {},
-    error: `Cannot launch a remote mesh delegate for node '${node.id}': coordinator daemon identity is unavailable, so the worker would be unable to relay completion events back to the coordinator.`,
-    nextAction: "Retry after the coordinator daemon identity is available (for example from an attached daemon-backed MCP session) so meshCoordinatorDaemonId can be stamped on the worker session.",
-    noFallbackReason: "Launching without meshCoordinatorDaemonId would create a worker session that can finish work but cannot emit task_completed / generating_completed back to the coordinator."
-  };
-}
-function findNestedPayload(value, predicate) {
-  const seen = /* @__PURE__ */ new Set();
-  const stack = [{ payload: value, depth: 0 }];
-  while (stack.length) {
-    const { payload, depth } = stack.pop();
-    if (predicate(payload)) return payload;
-    if (!payload || typeof payload !== "object" || seen.has(payload) || depth >= 8) continue;
-    seen.add(payload);
-    for (const key of ["payload", "result"]) {
-      if (key in payload) stack.push({ payload: payload[key], depth: depth + 1 });
-    }
-  }
-  return value;
-}
-function extractCloneNodePayload(value) {
-  return findNestedPayload(value, (payload) => Boolean(payload?.node?.id));
-}
-function extractGitStatus(value) {
-  const payload = unwrapCommandPayload(value);
-  return payload?.status ?? value?.status ?? payload;
-}
-function extractGitDiff(value) {
-  const payload = unwrapCommandPayload(value);
-  return payload?.diffSummary ?? payload?.diff ?? value?.diffSummary ?? value?.diff ?? payload;
-}
-function extractSubmodules(value, ignorePaths) {
-  const payload = unwrapCommandPayload(value);
-  const subs = payload?.status?.submodules ?? payload?.submodules ?? value?.status?.submodules ?? value?.submodules;
-  if (!Array.isArray(subs)) return void 0;
-  if (ignorePaths.length === 0) return subs;
-  const ignoreSet = new Set(ignorePaths);
-  return subs.filter((s) => s?.path && !ignoreSet.has(s.path));
-}
-function assignFullGitSnapshot(entry, status) {
-  if (!status || typeof status !== "object" || Array.isArray(status)) return;
-  entry.git = status;
-}
-function buildCompactGitSnapshot(status) {
-  if (!status || typeof status !== "object" || Array.isArray(status)) return void 0;
-  const slim = {};
-  const carry = [
-    "isGitRepo",
-    "branch",
-    "headCommit",
-    "upstream",
-    "upstreamStatus",
-    "ahead",
-    "behind",
-    "dirty",
-    "detached",
-    "submodules"
-  ];
-  for (const key of carry) {
-    if (status[key] !== void 0) slim[key] = status[key];
-  }
-  return slim;
-}
-function summarizeCompactSubmodules(submodules) {
-  if (!Array.isArray(submodules) || submodules.length === 0) return void 0;
-  const outOfSync = submodules.filter((s) => s?.outOfSync).map((s) => s?.path).filter(Boolean);
-  return {
-    count: submodules.length,
-    ...outOfSync.length > 0 ? { outOfSyncPaths: outOfSync } : {}
-  };
-}
-var MESH_COMPACT_PRESERVED_MARKER_FIELDS = ["dataFreshness"];
-function compactMeshStatusNode(entry) {
-  if (!entry || typeof entry !== "object") return entry;
-  const next = { ...entry };
-  if (next.git !== void 0) {
-    const slimGit = buildCompactGitSnapshot(next.git);
-    if (slimGit) {
-      if (slimGit.submodules !== void 0) {
-        const subSummary = summarizeCompactSubmodules(slimGit.submodules);
-        if (subSummary) slimGit.submodules = subSummary;
-        else delete slimGit.submodules;
-      }
-      next.git = slimGit;
-    }
-  }
-  if (next.machine && typeof next.machine === "object") {
-    const m = next.machine;
-    next.machine = {
-      daemonId: m.daemonId,
-      machineId: m.machineId,
-      hostname: m.hostname,
-      displayName: m.displayName,
-      sameMachine: m.sameMachine,
-      locality: m.locality
-    };
-  }
-  if (typeof next.submoduleWarning === "string") {
-    next.submodulesOutOfSync = true;
-    delete next.submoduleWarning;
-  }
-  if (next.staleDaemonBuild && typeof next.staleDaemonBuild === "object") {
-    const b = next.staleDaemonBuild;
-    next.staleDaemonBuild = {
-      scope: b.scope,
-      isDaemonAffecting: b.isDaemonAffecting !== false,
-      seeStaleDaemonBuilds: true
-    };
-  }
-  delete next.capabilityTagsByProvider;
-  const elideSkip = /* @__PURE__ */ new Set(["git", "machine", "branchConvergence", "staleDaemonBuild", "sessions", ...MESH_COMPACT_PRESERVED_MARKER_FIELDS]);
-  for (const k of Object.keys(next)) {
-    if (elideSkip.has(k)) continue;
-    next[k] = elideLargeNestedValue(k, next[k]);
-  }
-  return next;
-}
-var COMPACT_DETAILED_NODES_BYTE_BUDGET = 9e3;
-var COMPACT_NODES_TOTAL_BYTE_BUDGET = 13e3;
-var COMPACT_MISSIONS_BYTE_BUDGET = 6e3;
-function compactNodeSeverity(entry) {
-  if (!entry || typeof entry !== "object") return 0;
-  if (entry.error || entry.health && entry.health !== "online" && entry.health !== "dirty") return 5;
-  if (entry.launchReady === false) return 4;
-  if (entry.isDirty === true || entry.health === "dirty") return 3;
-  if (entry.branchConvergence?.needsConvergence === true) return 2;
-  if (entry.staleDaemonBuild || entry.submodulesOutOfSync || entry.recoveryHints) return 1;
-  return 0;
-}
-function isNoteworthyCompactNode(entry) {
-  if (!entry || typeof entry !== "object") return true;
-  if (entry.health && entry.health !== "online") return true;
-  if (entry.isDirty === true) return true;
-  if (entry.error) return true;
-  if (entry.launchReady === false) return true;
-  if (entry.staleDaemonBuild) return true;
-  if (entry.submoduleWarning || entry.submodulesOutOfSync) return true;
-  if (entry.recoveryHints) return true;
-  if (Array.isArray(entry.nextStepHints) && entry.nextStepHints.length > 0) return true;
-  if (entry.branchConvergence?.needsConvergence === true) return true;
-  const sessionCount = Array.isArray(entry.sessions) ? entry.sessions.length : entry.sessionSummary?.total ?? 0;
-  if (sessionCount > 0) return true;
-  return false;
+function isNoteworthyCompactNode(entry) {
+  if (!entry || typeof entry !== "object") return true;
+  if (entry.health && entry.health !== "online") return true;
+  if (entry.isDirty === true) return true;
+  if (entry.error) return true;
+  if (entry.launchReady === false) return true;
+  if (entry.staleDaemonBuild) return true;
+  if (entry.submoduleWarning || entry.submodulesOutOfSync) return true;
+  if (entry.recoveryHints) return true;
+  if (Array.isArray(entry.nextStepHints) && entry.nextStepHints.length > 0) return true;
+  if (entry.branchConvergence?.needsConvergence === true) return true;
+  const sessionCount = Array.isArray(entry.sessions) ? entry.sessions.length : entry.sessionSummary?.total ?? 0;
+  if (sessionCount > 0) return true;
+  return false;
 }
 function minimalCompactNode(entry) {
   if (!entry || typeof entry !== "object") return entry;
@@ -1335,284 +911,26 @@ function summarizeNodeSessions(sessions) {
   }
   return summary;
 }
-function extractLaunchPayload(value) {
-  return findNestedPayload(value, (payload) => Boolean(payload?.sessionId || payload?.id || payload?.runtimeSessionId));
-}
-function classifyMeshLaunchFailure(error) {
-  const message = error instanceof Error ? error.message : String(error || "launch failed");
-  const lower = message.toLowerCase();
-  const p2pClassification = (0, import_daemon_core.classifyP2pRelayFailure)(error, { command: "launch_cli" });
-  if (p2pClassification.recoverable) {
-    return p2pClassification;
+
+// src/tools/mesh-node-identity.ts
+var import_daemon_core = require("@adhdev/daemon-core");
+function resolveCoordinatorNode(ctx) {
+  const preferredNodeId = typeof ctx.mesh.coordinator?.preferredNodeId === "string" ? ctx.mesh.coordinator.preferredNodeId.trim() : "";
+  if (preferredNodeId) {
+    const preferred = ctx.mesh.nodes.find((n) => n.id === preferredNodeId && typeof n.daemonId === "string" && n.daemonId.trim());
+    if (preferred) return preferred;
   }
-  if (lower.includes("cannot connect to daemon ipc") || lower.includes("daemon ipc command")) {
-    return {
-      code: "local_ipc_unavailable",
-      reason: "local_daemon_ipc_unavailable",
-      transport: "local_ipc",
-      recoverable: true,
-      retryRecommended: true,
-      nextAction: "Check the local daemon IPC connection, then retry mesh_launch_session once after the daemon is reachable."
-    };
+  if (ctx.localMachineId) {
+    const byMachine = ctx.mesh.nodes.find((n) => readNodeMachineId(n) === ctx.localMachineId);
+    if (byMachine) return byMachine;
   }
-  if (lower.includes("timed out") || lower.includes("timeout")) {
-    return {
-      code: "mesh_transport_timeout",
-      reason: "mesh_transport_timeout",
-      transport: "mesh_transport",
-      recoverable: true,
-      retryRecommended: true,
-      nextAction: "Check mesh transport health, then do one bounded retry before requeueing or relaunching the task."
-    };
+  if (ctx.localDaemonId) {
+    return ctx.mesh.nodes.find((n) => readNodeDaemonId(n) === ctx.localDaemonId);
   }
-  return {
-    code: "mesh_launch_failed",
-    reason: "provider_launch_failed",
-    transport: "mesh_transport",
-    recoverable: false,
-    retryRecommended: false,
-    nextAction: "Inspect the provider launch error and fix the underlying provider/configuration issue before retrying."
-  };
+  return void 0;
 }
-function buildWorktreeCleanupHint(node) {
-  if (!node.isLocalWorktree) return void 0;
-  return {
-    tool: "mesh_remove_node",
-    args: { node_id: node.id, session_cleanup_mode: "preserve" },
-    hint: `If the worktree is no longer needed, remove the orphan worktree node with mesh_remove_node(node_id: "${node.id}").`
-  };
-}
-function buildRecoverableLaunchFailure(ctx, node, providerType, error) {
-  const message = error instanceof Error ? error.message : String(error || "launch failed");
-  const classified = classifyMeshLaunchFailure(error);
-  const cleanup = buildWorktreeCleanupHint(node);
-  return {
-    success: false,
-    recoverable: classified.recoverable,
-    code: classified.code,
-    reason: classified.reason,
-    transport: classified.transport,
-    retryRecommended: classified.retryRecommended,
-    nextAction: classified.nextAction,
-    ...classified.noFallbackReason ? { noFallbackReason: classified.noFallbackReason } : {},
-    error: message,
-    meshId: ctx.mesh.id,
-    nodeId: node.id,
-    daemonId: node.daemonId,
-    workspace: node.workspace,
-    isLocalWorktree: node.isLocalWorktree === true,
-    worktreeBranch: node.worktreeBranch,
-    clonedFromNodeId: node.clonedFromNodeId,
-    ...providerType ? { resolvedProviderType: providerType } : {},
-    retryHint: `Retry mesh_launch_session(node_id: "${node.id}"${providerType ? `, type: "${providerType}"` : ""}) after daemon mesh transport/P2P is healthy.`,
-    ...cleanup ? { cleanup } : {},
-    nextStepHints: [
-      `Retry mesh_launch_session(node_id: "${node.id}"${providerType ? `, type: "${providerType}"` : ""}) after checking daemon/P2P health.`,
-      ...cleanup ? [`Cleanup orphan worktree node with mesh_remove_node(node_id: "${node.id}") if retry is not desired.`] : [],
-      "Run mesh_status to see the degraded reason and recovery hints before redispatching work."
-    ]
-  };
-}
-function recordRecoverableLaunchFailure(ctx, node, providerType, error) {
-  const failure = buildRecoverableLaunchFailure(ctx, node, providerType, error);
-  try {
-    (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
-      kind: "recovery_attempted",
-      nodeId: node.id,
-      providerType,
-      payload: {
-        event: "session_launch_failed",
-        ...failure
-      }
-    });
-  } catch {
-  }
-  return failure;
-}
-function getLatestActiveLaunchFailure(meshId, nodeId) {
-  const entries = (0, import_daemon_core.readLedgerEntries)(meshId, { tail: 200 });
-  for (let i = entries.length - 1; i >= 0; i -= 1) {
-    const entry = entries[i];
-    if (entry.nodeId !== nodeId) continue;
-    if (entry.kind === "session_launched" || entry.kind === "node_removed") return null;
-    if (entry.kind === "recovery_attempted" && entry.payload?.event === "session_launch_failed") {
-      return { timestamp: entry.timestamp, ...entry.payload };
-    }
-  }
-  return null;
-}
-function buildCoordinatorP2pRelayFailure(error, context) {
-  const payload = (0, import_daemon_core.buildP2pRelayFailurePayload)(error, {
-    command: context.command,
-    targetDaemonId: context.targetDaemonId
-  });
-  return {
-    ...payload,
-    ...context.nodeId ? { nodeId: context.nodeId } : {},
-    ...context.sessionId ? { sessionId: context.sessionId } : {},
-    retryHint: payload.retryRecommended ? payload.nextAction : "Do not retry as a P2P transport recovery; inspect the command/provider error first."
-  };
-}
-async function ipcDispatchToRemoteAgent(ctx, node, args) {
-  const transport = ctx.transport;
-  const daemonId = node.daemonId;
-  const dispatchCoordinatorDaemonId = readString(args.meshContext?.coordinatorDaemonId) || "";
-  let sessionId = args.session_id?.trim() || "";
-  const providerPriorityList = Array.isArray(node.policy?.providerPriority) ? node.policy.providerPriority : [];
-  let resolvedProviderType = args.providerType?.trim() || providerPriorityList[0] || "";
-  if (sessionId && args.verifiedSession) {
-    const explicitSession = args.verifiedSession;
-    const relaySafety = classifyRemoteDelegateRelaySafety(explicitSession, ctx.mesh.id, node.id, dispatchCoordinatorDaemonId);
-    if (relaySafety === "unsafe_alias") {
-      return buildRelayUnsafeRemoteSessionFailure(
-        ctx,
-        node,
-        sessionId,
-        resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
-      );
-    }
-    if (relaySafety === "missing_anchor") {
-      return buildMissingCoordinatorDaemonIdFailure(
-        ctx,
-        node,
-        resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
-      );
-    }
-    if (!resolvedProviderType) {
-      resolvedProviderType = resolveSessionProviderType(explicitSession);
-    }
-  } else if (!sessionId || args.session_id) {
-    try {
-      const relayResult = await transport.meshCommand(daemonId, "get_status_metadata", {});
-      const sessions = extractStatusMetadataSessions(relayResult);
-      if (sessionId) {
-        const explicitSession = sessions.find((session) => readSessionRecordId(session) === sessionId);
-        if (!explicitSession) {
-          return {
-            success: false,
-            recoverable: true,
-            code: "mesh_target_session_not_found",
-            reason: "mesh_target_session_not_found",
-            transport: "mesh_transport",
-            retryRecommended: true,
-            meshId: ctx.mesh.id,
-            nodeId: node.id,
-            daemonId,
-            workspace: node.workspace,
-            sessionId,
-            ...resolvedProviderType ? { resolvedProviderType } : {},
-            error: `Remote session '${sessionId}' is not present in the live status for node '${node.id}'.`,
-            nextAction: `Launch a fresh session with mesh_launch_session(node_id: '${node.id}'${resolvedProviderType ? `, type: '${resolvedProviderType}'` : ""}) or retry without session_id so Repo Mesh can target a live delegate session.`
-          };
-        }
-        const relaySafety = classifyRemoteDelegateRelaySafety(explicitSession, ctx.mesh.id, node.id, dispatchCoordinatorDaemonId);
-        if (relaySafety === "unsafe_alias") {
-          return buildRelayUnsafeRemoteSessionFailure(
-            ctx,
-            node,
-            sessionId,
-            resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
-          );
-        }
-        if (relaySafety === "missing_anchor") {
-          return buildMissingCoordinatorDaemonIdFailure(
-            ctx,
-            node,
-            resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
-          );
-        }
-        if (!resolvedProviderType) {
-          resolvedProviderType = resolveSessionProviderType(explicitSession);
-        }
-      } else {
-        const targetSession = chooseDispatchableSession(sessions, resolvedProviderType, ctx.mesh.id, node.id, dispatchCoordinatorDaemonId);
-        if (targetSession?.id || targetSession?.sessionId) {
-          sessionId = targetSession.id || targetSession.sessionId;
-          if (!resolvedProviderType) {
-            resolvedProviderType = resolveSessionProviderType(targetSession);
-          }
-        }
-      }
-    } catch (e) {
-      if (sessionId) {
-        return {
-          ...buildCoordinatorP2pRelayFailure(e, {
-            command: "get_status_metadata",
-            targetDaemonId: daemonId,
-            nodeId: node.id,
-            sessionId
-          }),
-          success: false,
-          error: `Cannot verify remote session '${sessionId}' before dispatch: ${e?.message || String(e)}`
-        };
-      }
-    }
-  }
-  if (!resolvedProviderType) {
-    return { success: false, error: `Cannot dispatch to remote node '${node.id}': providerType unknown. Set providerPriority on the node policy or call mesh_launch_session first.` };
-  }
-  try {
-    const dispatchResult = await transport.meshCommand(daemonId, "agent_command", {
-      ...sessionId ? { targetSessionId: sessionId } : {},
-      agentType: resolvedProviderType,
-      cliType: resolvedProviderType,
-      action: "send_chat",
-      message: args.message,
-      // WTCLAIM (B): carry the node workspace so a sessionless dispatch can be
-      // scoped to THIS node's session on the worker (findAdapter dir match /
-      // findMeshNodeAdapter). Without it, a worker hosting both a base node and a
-      // cloned worktree node (same daemonId) would fall through to a provider-only
-      // fuzzy match and could land worktree work on the base session.
-      ...node.workspace ? { dir: node.workspace } : {},
-      ...args.meshContext ? { meshContext: args.meshContext } : {}
-    });
-    const dispatchPayload = unwrapCommandPayload(dispatchResult);
-    if (dispatchPayload?.success === false || dispatchResult?.success === false) {
-      const source = dispatchPayload?.success === false ? dispatchPayload : dispatchResult;
-      const errorMessage = dispatchPayload?.error || dispatchResult?.error || "agent_command rejected the task";
-      return {
-        ...buildCoordinatorP2pRelayFailure(source?.error || errorMessage, {
-          command: "agent_command",
-          targetDaemonId: daemonId,
-          nodeId: node.id,
-          sessionId
-        }),
-        ...source && typeof source === "object" ? source : {},
-        success: false,
-        error: `P2P dispatch failed: ${errorMessage}`
-      };
-    }
-    return { success: true, dispatched: true, sessionId: sessionId || "", providerType: resolvedProviderType };
-  } catch (e) {
-    const errorMessage = e?.message || String(e);
-    return {
-      ...buildCoordinatorP2pRelayFailure(e, {
-        command: "agent_command",
-        targetDaemonId: daemonId,
-        nodeId: node.id,
-        sessionId
-      }),
-      error: `P2P dispatch failed: ${errorMessage}`
-    };
-  }
-}
-function resolveCoordinatorNode(ctx) {
-  const preferredNodeId = typeof ctx.mesh.coordinator?.preferredNodeId === "string" ? ctx.mesh.coordinator.preferredNodeId.trim() : "";
-  if (preferredNodeId) {
-    const preferred = ctx.mesh.nodes.find((n) => n.id === preferredNodeId && typeof n.daemonId === "string" && n.daemonId.trim());
-    if (preferred) return preferred;
-  }
-  if (ctx.localMachineId) {
-    const byMachine = ctx.mesh.nodes.find((n) => readNodeMachineId(n) === ctx.localMachineId);
-    if (byMachine) return byMachine;
-  }
-  if (ctx.localDaemonId) {
-    return ctx.mesh.nodes.find((n) => readNodeDaemonId(n) === ctx.localDaemonId);
-  }
-  return void 0;
-}
-function resolveCoordinatorDaemonId(ctx) {
-  return readString(resolveCoordinatorNode(ctx)?.daemonId) || readString(ctx.localDaemonId) || readString(ctx.localMachineId);
+function resolveCoordinatorDaemonId(ctx) {
+  return readString(resolveCoordinatorNode(ctx)?.daemonId) || readString(ctx.localDaemonId) || readString(ctx.localMachineId);
 }
 function readNodeMachineId(node) {
   return readString(node.machineId) || readString(node.machine_id) || readString(node.machine?.id) || readString(node.machine?.machineId) || readString(node.lastProbe?.machineId) || readString(node.last_probe?.machine_id) || readString(node.lastProbe?.machine?.id) || readString(node.lastProbe?.machine?.machineId) || readString(node.last_probe?.machine?.id) || readString(node.last_probe?.machine?.machine_id);
@@ -1760,1061 +1078,1775 @@ function resolvePreferredWorktreeNodeId(ctx) {
 function isLocalControlPlaneNode(ctx, node) {
   return !!getLocalControlPlaneMatchReason(ctx, node);
 }
-function meshSessionCacheKey(nodeId, runtimeSessionId) {
-  return `${nodeId}:${runtimeSessionId}`;
-}
-function rememberMeshSessionProviderMetadata(nodeId, runtimeSessionId, metadata) {
-  const keyNodeId = readString(nodeId);
-  const keySessionId = readString(runtimeSessionId);
-  if (!keyNodeId || !keySessionId) return;
-  const providerType = readString(metadata.providerType);
-  const providerSessionId = readString(metadata.providerSessionId);
-  if (!providerType && !providerSessionId) return;
-  const existing = getSessionMetadata(meshSessionCacheKey(keyNodeId, keySessionId)) || { providerType: "" };
-  meshSessionProviderMetadata.set(meshSessionCacheKey(keyNodeId, keySessionId), {
-    providerType: providerType || existing.providerType,
-    providerSessionId: providerSessionId || existing.providerSessionId,
-    expiresAt: Date.now() + SESSION_PROVIDER_METADATA_TTL_MS
-  });
-}
-function rememberMeshSessionProviderMetadataFromEvent(event) {
-  const metadataEvent = event?.metadataEvent && typeof event.metadataEvent === "object" ? event.metadataEvent : event && typeof event === "object" ? event : {};
-  const nodeId = readString(event?.nodeId) || readString(metadataEvent.nodeId) || readString(metadataEvent.meshNodeId);
-  const sessionId = readString(metadataEvent.targetSessionId) || readString(metadataEvent.sessionId) || readString(metadataEvent.instanceId) || readString(event?.sessionId);
-  rememberMeshSessionProviderMetadata(nodeId, sessionId, {
-    providerType: readString(metadataEvent.providerType) || readString(event?.providerType) || "",
-    providerSessionId: readString(metadataEvent.providerSessionId) || readString(event?.providerSessionId)
-  });
-}
-function resolveMeshSessionProviderMetadataFromLedger(ctx, nodeId, runtimeSessionId) {
-  const entries = (0, import_daemon_core.readLedgerEntries)(ctx.mesh.id, { tail: 50 });
-  for (let i = entries.length - 1; i >= 0; i -= 1) {
-    const entry = entries[i];
-    const payload = entry.payload && typeof entry.payload === "object" && !Array.isArray(entry.payload) ? entry.payload : {};
-    const entryNodeId = readString(entry.nodeId) || readString(payload.nodeId) || readString(payload.meshNodeId);
-    if (entryNodeId && entryNodeId !== nodeId) continue;
-    const entrySessionId = readString(entry.sessionId) || readString(payload.targetSessionId) || readString(payload.sessionId) || readString(payload.instanceId);
-    if (entrySessionId !== runtimeSessionId) continue;
-    const providerType = readString(entry.providerType) || readString(payload.providerType);
-    const completionDiagnostic = payload.completionDiagnostic && typeof payload.completionDiagnostic === "object" && !Array.isArray(payload.completionDiagnostic) ? payload.completionDiagnostic : {};
-    const metadataEvent = payload.metadataEvent && typeof payload.metadataEvent === "object" && !Array.isArray(payload.metadataEvent) ? payload.metadataEvent : {};
-    const providerSessionId = readString(payload.providerSessionId) || readString(completionDiagnostic.providerSessionId) || readString(metadataEvent.providerSessionId);
-    if (providerType || providerSessionId) {
-      return { providerType: providerType || "", providerSessionId };
-    }
-  }
-  return void 0;
-}
-function resolveMeshSessionProviderMetadata(ctx, nodeId, runtimeSessionId) {
-  const cached = getSessionMetadata(meshSessionCacheKey(nodeId, runtimeSessionId));
-  if (cached?.providerType || cached?.providerSessionId) return cached;
-  const fromLedger = resolveMeshSessionProviderMetadataFromLedger(ctx, nodeId, runtimeSessionId);
-  if (fromLedger) rememberMeshSessionProviderMetadata(nodeId, runtimeSessionId, fromLedger);
-  return fromLedger;
-}
-function countUncommittedChanges(status) {
-  if (typeof status?.uncommittedChanges === "number") return status.uncommittedChanges;
-  const keys = ["staged", "modified", "untracked", "deleted", "renamed"];
-  const counted = keys.reduce((sum, key) => sum + (Number.isFinite(Number(status?.[key])) ? Number(status[key]) : 0), 0);
-  const conflicts = Array.isArray(status?.conflictFiles) ? status.conflictFiles.length : status?.hasConflicts ? 1 : 0;
-  return counted + conflicts;
-}
-function isGitStatusDirty(status) {
-  if (typeof status?.isDirty === "boolean") return status.isDirty;
-  if (typeof status?.dirty === "boolean") return status.dirty;
-  if (Array.isArray(status?.submodules) && status.submodules.some((submodule) => submodule?.dirty || submodule?.outOfSync || submodule?.error)) return true;
-  return countUncommittedChanges(status) > 0;
-}
-var LARGE_LEDGER_FIELD_KEYS = /* @__PURE__ */ new Set(["plan", "validationPlan", "suggestedConfig", "payload"]);
-var LARGE_LEDGER_OBJECT_THRESHOLD = 800;
-var LARGE_LEDGER_NESTED_BYTES_THRESHOLD = 2e3;
-function summarizeLargeLedgerField(key, value) {
-  if (typeof value === "string") {
-    return value.length > 500 ? value.slice(0, 500) + "\u2026" : value;
-  }
-  if (Array.isArray(value)) {
-    const serialized = JSON.stringify(value);
-    if (serialized && serialized.length > LARGE_LEDGER_OBJECT_THRESHOLD) {
-      return `[${key} summarized: ${value.length} items \u2014 use verbose=true or mesh_reconcile_ledger]`;
+
+// src/tools/mesh-tool-schemas.ts
+var MESH_STATUS_TOOL = {
+  name: "mesh_status",
+  description: "Get the current status of all nodes in the repo mesh \u2014 health, git state, active sessions, recovery hints, and recommended next steps. Use this to decide which node to send work to or how to recover from failures. Also reports the running daemon build per daemonId under top-level daemonBuilds ({commit, commitShort, version}); when a live daemon was built from a commit BEHIND its workspace HEAD it adds staleDaemonBuilds[] + staleDaemonBuildWarning \u2014 meaning a just-merged refinery/mesh-tool fix is NOT yet live on that daemon (awaiting deploy/restart; a local dist rebuild does not update a cloud daemon). Do not repeatedly call this to wait for generating delegated work; wait for pendingCoordinatorEvents/completion events or an explicit user status request.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      _gemini_compat: { type: "string", description: "Dummy property for Gemini compatibility. Ignore this." },
+      includeStaleDirectWorkDetails: { type: "boolean", description: "Opt in to the full staleDirectWork array. Defaults false; normal status returns compact staleDirectWorkSummary only." },
+      includeSessions: { type: "boolean", description: "Opt in to per-node live session arrays. Default false: compact mode returns a per-node sessionSummary (counts) and de-duplicated full session lists under top-level daemonSessions keyed by daemonId (sessions are not repeated for every node that shares a daemon). Set true to also include the full session array on each node." },
+      compact: { type: "boolean", description: "Slim payload for LLM callers. Default true. Folds per-node session arrays to sessionSummary and de-duplicates daemon-shared sessions into daemonSessions. Set false (or verbose=true) for the full dashboard-grade payload." },
+      verbose: { type: "boolean", description: "Force the full payload; overrides compact." }
     }
-    return value;
   }
-  if (value && typeof value === "object") {
-    const serialized = JSON.stringify(value);
-    if (serialized && serialized.length > LARGE_LEDGER_OBJECT_THRESHOLD) {
-      return `[${key} summarized: ${Object.keys(value).length} keys \u2014 use verbose=true or mesh_reconcile_ledger]`;
+};
+var MESH_LIST_NODES_TOOL = {
+  name: "mesh_list_nodes",
+  description: "List all nodes in the mesh with their capabilities, platform, and workspace paths.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      _gemini_compat: { type: "string", description: "Dummy property for Gemini compatibility. Ignore this." }
     }
-    return value;
-  }
-  return value;
-}
-function elideLargeNestedValue(key, value) {
-  if (value === null || value === void 0) return value;
-  if (typeof value === "string") {
-    return value.length > 1e3 ? value.slice(0, 1e3) + "\u2026" : value;
   }
-  if (typeof value !== "object") return value;
-  const serialized = JSON.stringify(value);
-  const bytes = serialized ? serialized.length : 0;
-  if (bytes <= LARGE_LEDGER_NESTED_BYTES_THRESHOLD) return value;
-  return {
-    _elided: true,
-    _kind: key,
-    _bytes: bytes,
-    _hint: "full evidence via mesh_reconcile_ledger"
-  };
-}
-function slimLedgerPayload(payload) {
-  const slim = {};
-  for (const [k, v] of Object.entries(payload)) {
-    if (k === "message" || k === "taskSummary") {
-      slim[k] = typeof v === "string" && v.length > 200 ? v.slice(0, 200) + "\u2026" : v;
-    } else if (k === "evidence" || k === "workerResult" || k === "gitStatus" || k === "validationResults") {
-    } else if (k === "finalSummary") {
-      slim[k] = typeof v === "string" && v.length > 300 ? v.slice(0, 300) + "\u2026" : v;
-    } else if (LARGE_LEDGER_FIELD_KEYS.has(k)) {
-      slim[k] = summarizeLargeLedgerField(k, v);
-    } else {
-      slim[k] = elideLargeNestedValue(k, v);
-    }
+};
+var MESH_ENQUEUE_TASK_TOOL = {
+  name: "mesh_enqueue_task",
+  description: "Add a new task to the mesh work queue. Idle nodes will automatically pull and execute tasks from this queue. Use this instead of mesh_send_task when you do not need to target a specific node.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      message: { type: "string", description: "The task instruction for the agent." },
+      task_mode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "Optional task-mode contract. live_debug_readonly rejects obvious write/commit/push/deploy/destructive instructions before dispatch." },
+      taskMode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "CamelCase alias for task_mode." },
+      requiredTags: { type: "array", items: { type: "string" }, description: "Optional capability tags that every eligible node must have, e.g. os=darwin, provider=codex-cli, gpu." },
+      required_tags: { type: "array", items: { type: "string" }, description: "Snake_case alias for requiredTags." },
+      target_node_id: { type: "string", description: "Optional: only this node may claim the task. Use to route a queued task to a specific (e.g. freshly cloned) worktree node instead of letting the first idle base node claim it. Takes priority over prefer_worktree." },
+      targetNodeId: { type: "string", description: "CamelCase alias for target_node_id." },
+      prefer_worktree: { type: "boolean", description: "Optional: when true, route this task to the most recently cloned idle worktree node (avoids the main/base workspace preemptively claiming an isolated task). No-op if no worktree node exists; resolves to a target_node_id when one does." },
+      preferWorktree: { type: "boolean", description: "CamelCase alias for prefer_worktree." },
+      depends_on: { type: "array", items: { type: "string" }, description: "Task ids that must complete before this task becomes claimable. Cycles are rejected at enqueue." },
+      dependsOn: { type: "array", items: { type: "string" }, description: "CamelCase alias for depends_on." },
+      mission_id: { type: "string", description: "Mission this task belongs to (mesh_mission record id)." },
+      missionId: { type: "string", description: "CamelCase alias for mission_id." }
+    },
+    required: ["message"]
   }
-  return slim;
-}
-function readRelatedRepos(node) {
-  const raw = Array.isArray(node.relatedRepos) ? node.relatedRepos : Array.isArray(node.policy?.relatedRepos) ? node.policy.relatedRepos : [];
-  return raw.map((entry) => ({
-    label: typeof entry?.label === "string" ? entry.label.trim() : "",
-    workspace: typeof entry?.workspace === "string" ? entry.workspace.trim() : ""
-  })).filter((entry) => Boolean(entry.label && entry.workspace));
-}
-function summarizeRelatedRepoStatus(repo, status) {
-  const dirty = isGitStatusDirty(status);
-  return {
-    label: repo.label,
-    workspace: repo.workspace,
-    isGitRepo: status?.isGitRepo === true,
-    branch: status?.branch ?? null,
-    upstream: status?.upstream ?? null,
-    upstreamStatus: typeof status?.upstreamStatus === "string" ? status.upstreamStatus : status?.upstream ? "unchecked" : "no_upstream",
-    upstreamFetchedAt: Number.isFinite(Number(status?.upstreamFetchedAt)) ? Number(status.upstreamFetchedAt) : null,
-    upstreamFetchError: typeof status?.upstreamFetchError === "string" ? status.upstreamFetchError : null,
-    ahead: Number.isFinite(Number(status?.ahead)) ? Number(status.ahead) : 0,
-    behind: Number.isFinite(Number(status?.behind)) ? Number(status.behind) : 0,
-    dirty,
-    uncommittedChanges: countUncommittedChanges(status),
-    head: status?.headCommit ?? null,
-    lastCommitSummary: status?.headMessage ?? null,
-    ...status?.reason ? { reason: status.reason } : {},
-    ...status?.error ? { error: status.error } : {}
-  };
-}
-async function collectRelatedRepoStatuses(ctx, node) {
-  const relatedRepos = readRelatedRepos(node);
-  if (!relatedRepos.length) return [];
-  const results = [];
-  for (const repo of relatedRepos) {
-    try {
-      const statusResult = await commandForNode(ctx, node, "git_status", { workspace: repo.workspace, refreshUpstream: true });
-      const status = extractGitStatus(statusResult);
-      results.push(summarizeRelatedRepoStatus(repo, status));
-    } catch (e) {
-      results.push({
-        label: repo.label,
-        workspace: repo.workspace,
-        error: e?.message || "related repo status failed"
-      });
+};
+var MESH_VIEW_QUEUE_TOOL = {
+  name: "mesh_view_queue",
+  description: "View the mesh work queue with source-of-truth active counts separated from historical completed/failed/cancelled records. Do not repeatedly call this to wait for generating assigned work; wait for pendingCoordinatorEvents/completion events or an explicit user status request.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      status: {
+        type: "array",
+        items: { type: "string" },
+        description: "Explicit row filter by task status: pending, assigned, completed, failed, cancelled. Source-of-truth counts remain unfiltered; visible* counts describe returned rows."
+      },
+      view: {
+        type: "string",
+        enum: ["all", "active", "historical"],
+        description: "Optional row view. active returns pending/assigned rows, historical returns completed/failed/cancelled rows, all returns every persisted queue row. Defaults to all for compatibility."
+      },
+      compact: { type: "boolean", description: "Slim payload for LLM callers. Default true. Drops large historical (completed/failed/cancelled) queue row arrays, the full staleDirectWork orphan array (kept as staleDirectWorkSummary counts), and per-row maintenance cleanupCandidates in favor of counts; pending/assigned active rows are retained. Set false (or verbose=true) for the full dashboard-grade payload." },
+      verbose: { type: "boolean", description: "Force the full payload; overrides compact." }
     }
   }
-  return results;
-}
-function readProviderPriority(policy) {
-  const raw = policy?.providerPriority;
-  return Array.isArray(raw) ? raw.map((type) => typeof type === "string" ? type.trim() : "").filter(Boolean) : [];
-}
-function buildNodeCapabilityExposure(node) {
-  const providers = readProviderPriority(node.policy);
-  const capabilityTags = (0, import_daemon_core.buildMeshNodeCapabilityTags)(node);
-  const exposure = { capabilityTags };
-  if (providers.length) {
-    const byProvider = {};
-    for (const provider of providers) {
-      byProvider[provider] = (0, import_daemon_core.buildMeshNodeCapabilityTags)(node, provider);
-    }
-    exposure.capabilityTagsByProvider = byProvider;
+};
+var MESH_QUEUE_CANCEL_TOOL = {
+  name: "mesh_queue_cancel",
+  description: "Cancel a pending/assigned/completed/failed mesh queue task without deleting audit history. Use this to retire stale queue items that target dead sessions.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      task_id: { type: "string", description: "Queue task ID to cancel." },
+      reason: { type: "string", description: "Optional operator-visible reason for cancellation." }
+    },
+    required: ["task_id"]
   }
-  const capabilities = Array.isArray(node.capabilities) ? node.capabilities.filter((tag) => typeof tag === "string" && !!tag.trim()) : [];
-  if (capabilities.length) exposure.capabilities = capabilities;
-  return exposure;
-}
-function readSpawnedSessionVisibility(policy) {
-  return policy?.spawnedSessionVisibility === "hidden" ? "hidden" : "visible";
-}
-function missingProviderPriorityMessage(nodeId) {
-  return `Node '${nodeId}' has no providerPriority policy; pass type explicitly or configure node.policy.providerPriority`;
-}
-function getNodeLaunchReadiness(node) {
-  const bootstrap = node.worktreeBootstrap;
-  if (node.isLocalWorktree && bootstrap?.status === "failed" && bootstrap?.required !== false) {
-    return {
-      providerPriority: readProviderPriority(node.policy),
-      launchReady: false,
-      launchBlockedReason: "worktree_bootstrap_failed",
-      launchBlockedMessage: typeof bootstrap.error === "string" && bootstrap.error.trim() ? bootstrap.error.trim() : "Required worktree bootstrap failed; resolve it before launching an agent into this node.",
-      worktreeBootstrap: bootstrap
-    };
+};
+var MESH_QUEUE_REQUEUE_TOOL = {
+  name: "mesh_queue_requeue",
+  description: "Return a mesh queue task to pending for retry. By default clears stale assigned owner and target session so another live session can claim it. When the task has exceeded its retry cap it is auto-failed instead; use force=true to override.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      task_id: { type: "string", description: "Queue task ID to requeue." },
+      reason: { type: "string", description: "Optional operator-visible reason for requeueing." },
+      target_node_id: { type: "string", description: "Optional replacement target node ID." },
+      target_session_id: { type: "string", description: "Optional replacement target runtime session ID." },
+      clear_target_node: { type: "boolean", description: "When true, remove any existing target node constraint." },
+      keep_target_session: { type: "boolean", description: "When true, preserve an existing target session if target_session_id is not provided. Defaults false to avoid stale session targets." },
+      force: { type: "boolean", description: "When true, bypass the retry cap and requeue even if maxRetries has been exceeded. Use only for explicit operator recovery." }
+    },
+    required: ["task_id"]
   }
-  const providerPriority = readProviderPriority(node.policy);
-  if (providerPriority.length) {
-    return {
-      providerPriority,
-      launchReady: true
-    };
-  }
-  return {
-    providerPriority,
-    launchReady: false,
-    launchBlockedReason: "missing_provider_priority",
-    launchBlockedMessage: missingProviderPriorityMessage(node.id)
-  };
-}
-function getWorktreeBootstrapLaunchBlock(node, meshPolicy) {
-  if (!node.isLocalWorktree) return void 0;
-  const bootstrap = node.worktreeBootstrap;
-  const requireReady = !!(meshPolicy && typeof meshPolicy === "object" && meshPolicy.requireBootstrapBeforeLaunch === true);
-  if (requireReady && bootstrap?.status !== "ready") {
-    return {
-      success: false,
-      code: "bootstrap_not_ready",
-      error: `Node '${node.id}' bootstrap state is '${bootstrap?.status ?? "unknown"}' and mesh policy requireBootstrapBeforeLaunch is enabled.`,
-      nodeId: node.id,
-      worktreeBootstrap: bootstrap ?? null,
-      recoveryHint: "Run the worktree bootstrap (clone runOnClone or a refine with bootstrap inherit) until the node reports ready, or disable requireBootstrapBeforeLaunch."
-    };
+};
+var MESH_SEND_TASK_TOOL = {
+  name: "mesh_send_task",
+  description: "Legacy push-based task assignment. Enqueues a task specifically targeted at a given node. The node will pull it immediately if idle.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID (from mesh_list_nodes)." },
+      session_id: { type: "string", description: "Agent session ID on the target node." },
+      message: { type: "string", description: "Natural-language task to send to the agent." },
+      task_mode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "Optional task-mode contract. live_debug_readonly rejects obvious write/commit/push/deploy/destructive instructions before local or remote direct dispatch." },
+      taskMode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "CamelCase alias for task_mode." },
+      mission_id: { type: "string", description: "Mission this task belongs to (mesh_mission record id). When set, the directly dispatched task is attributed to the mission task aggregates exactly like mesh_enqueue_task, including terminal completion. Omit for an unattributed direct dispatch." },
+      missionId: { type: "string", description: "CamelCase alias for mission_id." }
+    },
+    required: ["node_id", "session_id", "message"]
   }
-  if (bootstrap?.status !== "failed" || bootstrap?.required === false) return void 0;
-  return {
-    success: false,
-    code: "worktree_bootstrap_failed",
-    error: typeof bootstrap.error === "string" && bootstrap.error.trim() ? bootstrap.error.trim() : `Node '${node.id}' has a failed required worktree bootstrap.`,
-    nodeId: node.id,
-    worktreeBootstrap: bootstrap,
-    recoveryHint: "Fix the configured worktree bootstrap command or remove/recreate the worktree node before launching an agent."
-  };
-}
-async function collectLiveStatusSessions(ctx, node) {
-  try {
-    const statusResult = await commandForNode(ctx, node, "get_status_metadata", {});
-    return extractStatusMetadataSessions(statusResult);
-  } catch {
-    return [];
+};
+var MESH_READ_CHAT_TOOL = {
+  name: "mesh_read_chat",
+  description: "Read recent chat messages from a delegated agent session on a mesh node. Use compact=true for coordinator context-efficient review: it filters tool/internal/debug chatter and returns the final user-visible summary plus recent key messages. If the runtime session has completed, provider_session_id can explicitly target provider transcript history.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID." },
+      session_id: { type: "string", description: "Agent session ID to read from." },
+      provider_session_id: { type: "string", description: "Optional provider transcript/session ID for completed sessions." },
+      tail: { type: "number", description: "Number of recent messages to return (default: 10)." },
+      compact: { type: "boolean", description: "When true, return a compact coordinator summary instead of the full transcript: tool/internal/control/debug messages are excluded and only recent user-visible key messages plus the final assistant summary are included." }
+    },
+    required: ["node_id", "session_id"]
   }
-}
-async function collectLiveStatusProbe(ctx, node) {
-  try {
-    const statusResult = await commandForNode(ctx, node, "get_status_metadata", {});
-    return {
-      sessions: extractStatusMetadataSessions(statusResult),
-      daemonBuild: extractDaemonBuildInfo(statusResult)
-    };
-  } catch {
-    return { sessions: [] };
+};
+var MESH_READ_DEBUG_TOOL = {
+  name: "mesh_read_debug",
+  description: "Collect a daemon-side chat/parser debug bundle for a delegated agent session on a mesh node without opening the browser UI. Defaults to daemon_file delivery and returns a saved bundle locator.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID." },
+      session_id: { type: "string", description: "Agent session ID to debug." },
+      provider_session_id: { type: "string", description: "Optional provider transcript/session ID for completed session history." },
+      tail: { type: "number", description: "Number of recent read_chat messages to embed (default: 40)." },
+      delivery: { type: "string", enum: ["daemon_file", "inline"], description: "daemon_file saves the full sanitized bundle on the daemon; inline returns it directly. Default: daemon_file." }
+    },
+    required: ["node_id", "session_id"]
   }
-}
-function extractDaemonBuildInfo(value) {
-  const payload = unwrapCommandPayload(value);
-  const build = payload?.daemonBuild && typeof payload.daemonBuild === "object" ? payload.daemonBuild : value?.daemonBuild && typeof value.daemonBuild === "object" ? value.daemonBuild : void 0;
-  if (!build) return void 0;
-  const commit = readString(build.commit);
-  if (!commit) return void 0;
-  return {
-    commit,
-    commitShort: readString(build.commitShort) || commit.slice(0, 7),
-    version: readString(build.version) || "unknown",
-    ...readString(build.builtAt) ? { builtAt: readString(build.builtAt) } : {}
-  };
-}
-async function collectMeshViewQueueNodesWithLiveSessions(ctx) {
-  const nodes = await Promise.all(ctx.mesh.nodes.map(async (node) => {
-    const liveSessions = await collectLiveStatusSessions(ctx, node);
-    return liveSessions.length > 0 ? { ...node, sessions: liveSessions } : node;
-  }));
-  return nodes;
-}
-function readNumeric(value, fallback = 0) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : fallback;
-}
-function buildBranchConvergence(mesh, node, status, dirty, uncommittedChanges) {
-  const defaultBranch = readString(mesh.defaultBranch) ?? "main";
-  const branch = readString(status?.branch) ?? readString(node.worktreeBranch) ?? null;
-  const ahead = readNumeric(status?.ahead);
-  const behind = readNumeric(status?.behind);
-  const upstream = readString(status?.upstream) ?? null;
-  const upstreamStatus = readString(status?.upstreamStatus) ?? (upstream ? "unchecked" : "no_upstream");
-  const hasConflicts = status?.hasConflicts === true || Array.isArray(status?.conflictFiles) && status.conflictFiles.length > 0;
-  const base = {
-    defaultBranch,
-    branch,
-    upstream,
-    upstreamStatus,
-    ahead,
-    behind,
-    isWorktree: node.isLocalWorktree === true,
-    isDefaultBranch: branch === defaultBranch
-  };
-  if (status?.isGitRepo !== true) {
-    return {
-      ...base,
-      status: "blocked_review",
-      needsConvergence: true,
-      reason: "git_status_unavailable",
-      nextStep: `Resolve git status for node '${node.id}' before marking the task complete.`
-    };
+};
+var MESH_LAUNCH_SESSION_TOOL = {
+  name: "mesh_launch_session",
+  description: "Launch a new agent session on a mesh node. Returns the session ID for subsequent send_task/read_chat calls. If the user names a provider, preserve it exactly: Hermes = hermes-cli, Claude Code/Claude = claude-cli, Codex = codex-cli, Gemini = gemini-cli. If type is omitted, resolve strictly from the node policy providerPriority and provider detection; fail closed when no configured provider is usable. Do not default to claude-cli.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID." },
+      type: { type: "string", description: "Optional provider type to launch. Use hermes-cli for Hermes, claude-cli for Claude Code, codex-cli for Codex, gemini-cli for Gemini. When omitted, node.policy.providerPriority is probed in order." }
+    },
+    required: ["node_id"]
   }
-  if (!branch) {
-    return {
-      ...base,
-      status: "blocked_review",
-      needsConvergence: true,
-      reason: "branch_unknown",
-      nextStep: `Inspect node '${node.id}' git branch before deciding whether it is merged to ${defaultBranch}.`
-    };
+};
+var MESH_GIT_STATUS_TOOL = {
+  name: "mesh_git_status",
+  description: "Get git status for a mesh node workspace \u2014 branch, dirty state, changed files.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID." }
+    },
+    required: ["node_id"]
   }
-  if (hasConflicts || dirty || uncommittedChanges > 0) {
-    return {
-      ...base,
-      status: "not_mergeable",
-      needsConvergence: true,
-      reason: hasConflicts ? "conflicts_present" : "dirty_workspace",
-      nextStep: `Commit, checkpoint, or resolve node '${node.id}' before any main convergence step.`
-    };
+};
+var MESH_READ_NODE_LOGS_TOOL = {
+  name: "mesh_read_node_logs",
+  description: "Fetch a recent daemon LOG tail directly from a (possibly remote) mesh node over P2P \u2014 no session launch, no PowerShell/shell grep on the remote machine. Use this to debug a node's daemon: read its error/warn lines, grep for a pattern, or read since a timestamp. The reply is byte-bounded (\u2264128KB, default 64KB; truncated:true when the file was larger, newest lines kept) and secrets (API keys, machine secrets, bearer tokens, JWTs, TURN credentials) are redacted before transmission. This reads the DAEMON log, not an agent session transcript \u2014 for a session transcript use mesh_read_chat / mesh_read_debug.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID (the daemon owning it serves its own log)." },
+      grep: { type: "string", description: "Optional regex (case-insensitive) \u2014 only matching log lines are returned. Invalid regex falls back to a literal substring match." },
+      since_ms: { type: "number", description: "Optional epoch-ms floor \u2014 only log lines at/after this time are returned (lines without a parseable timestamp are kept)." },
+      tail_bytes: { type: "number", description: "Max bytes of log tail to read (default 65536, capped at 131072). Larger files are truncated to the newest tail_bytes." },
+      date: { type: "string", description: "Optional YYYY-MM-DD log date (defaults to today). Falls back to the size-rotation backup when the active file is absent." }
+    },
+    required: ["node_id"]
   }
-  if (branch === defaultBranch) {
-    if (upstream && upstreamStatus !== "fresh") {
-      return {
-        ...base,
-        status: "blocked_review",
-        needsConvergence: true,
-        reason: "default_branch_upstream_unverified",
-        nextStep: `Refresh ${defaultBranch}'s upstream refs or resolve the fetch failure before declaring convergence complete for node '${node.id}'.`
-      };
-    }
-    if (ahead > 0 || behind > 0) {
-      return {
-        ...base,
-        status: "blocked_review",
-        needsConvergence: true,
-        reason: "default_branch_not_even_with_upstream",
-        nextStep: `Bring ${defaultBranch} even with its upstream before declaring convergence complete.`
-      };
-    }
-    return {
-      ...base,
-      status: "merged_to_main",
-      needsConvergence: false,
-      reason: "clean_default_branch",
-      nextStep: null
-    };
+};
+var MESH_FAST_FORWARD_NODE_TOOL = {
+  name: "mesh_fast_forward_node",
+  description: 'Safely dry-run or execute an obvious direct fast-forward for a mesh node without launching an agent session. mode="merge" (default) absorbs upstream commits into the local branch via git merge --ff-only (ahead=0, behind>0). mode="push" publishes local commits to origin via a strict ff-only push (HEAD must be a descendant of origin/<branch>). Defaults to dry-run; execution requires execute=true. Never force-pushes, rebases, resets, cleans, or checks out arbitrary revisions. When the merge path finds the branch ahead with nothing to merge, it returns code "ahead_needs_push" pointing at mode="push".',
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID." },
+      mode: { type: "string", enum: ["merge", "push"], description: "merge (default): git merge --ff-only to absorb upstream. push: strict ff-only push of local commits to origin/<branch>; refuses any non-fast-forward." },
+      branch: { type: "string", description: "Optional guard: require the node's current branch to match this branch before planning/executing." },
+      execute: { type: "boolean", description: "When true, apply the fast-forward/push if all safety gates pass. Defaults false/dry-run." },
+      dry_run: { type: "boolean", description: "Preview only. Defaults true unless execute=true; dry_run=true overrides execute." },
+      update_submodules: { type: "boolean", description: 'mode="merge" only: when true, if the root fast-forward changes gitlinks, run only git submodule update --init --recursive and verify submodules clean.' },
+      push_submodules: { type: "boolean", description: 'mode="push" only: also ff-only push submodule HEADs to their origin main. Gated by mesh policy allowAutoPublishSubmoduleMainCommits \u2014 skipped unless that policy is enabled. Defaults false (root push only).' }
+    },
+    required: ["node_id"]
   }
-  if (node.isLocalWorktree) {
-    return {
-      ...base,
-      status: "cleanup_candidate",
-      needsConvergence: true,
-      reason: "clean_non_default_worktree_branch",
-      nextStep: `Run mesh_refine_node(node_id: "${node.id}") or explicitly classify this worktree as blocked_review/not_mergeable before ending the task.`
-    };
-  }
-  if (upstream && upstreamStatus !== "fresh") {
-    return {
-      ...base,
-      status: "blocked_review",
-      needsConvergence: true,
-      reason: "feature_branch_upstream_unverified",
-      nextStep: `Refresh branch '${branch}' upstream refs or resolve the fetch failure before deciding whether it is ready to merge into ${defaultBranch}.`
-    };
-  }
-  if (!upstream || ahead > 0 || behind > 0) {
-    return {
-      ...base,
-      status: "blocked_review",
-      needsConvergence: true,
-      reason: !upstream ? "feature_branch_missing_upstream" : "feature_branch_not_even_with_upstream",
-      nextStep: `Push or reconcile branch '${branch}', then merge it into ${defaultBranch} or mark it not_mergeable with a reason.`
-    };
-  }
-  return {
-    ...base,
-    status: "pushed_feature_branch_needs_merge",
-    needsConvergence: true,
-    reason: "clean_non_default_branch",
-    nextStep: `Review and merge branch '${branch}' into ${defaultBranch}; do not report the task as fully complete while it remains off main.`
-  };
-}
-var COMPACT_MAX_CONVERGENCE_FOLLOWUPS = 12;
-function summarizeBranchConvergence(nodes, compact = false) {
-  const allFollowUps = nodes.filter((node) => node?.branchConvergence?.needsConvergence === true).map((node) => ({
-    nodeId: node.nodeId,
-    // workspace is a long absolute path redundant with nodeId — drop it in
-    // compact mode to keep this summary bounded.
-    ...compact ? {} : { workspace: node.workspace },
-    branch: node.branchConvergence.branch,
-    status: node.branchConvergence.status,
-    reason: node.branchConvergence.reason,
-    // The per-node nextStep is long prose that repeats node ids/branch names.
-    // In compact mode drop it (the status+reason carry the actionable signal;
-    // verbose still surfaces the full nextStep) so this summary stays bounded
-    // as node count grows.
-    ...compact ? {} : { nextStep: node.branchConvergence.nextStep }
-  }));
-  const byStatus = {};
-  for (const f of allFollowUps) {
-    const s = typeof f.status === "string" ? f.status : "unknown";
-    byStatus[s] = (byStatus[s] ?? 0) + 1;
-  }
-  const followUps = compact ? allFollowUps.slice(0, COMPACT_MAX_CONVERGENCE_FOLLOWUPS) : allFollowUps;
-  const omitted = allFollowUps.length - followUps.length;
-  return {
-    needsFollowUp: allFollowUps.length > 0,
-    unresolvedCount: allFollowUps.length,
-    byStatus,
-    requiredFinalStates: ["merged_to_main", "pushed_feature_branch_needs_merge", "blocked_review", "cleanup_candidate", "not_mergeable"],
-    followUps,
-    ...omitted > 0 ? { followUpsOmitted: omitted, followUpsHint: "Per-node followUp rows are capped in compact mode; counts above are complete. Use verbose=true for the full list." } : {}
-  };
-}
-async function commandForNode(ctx, node, command, args = {}) {
-  const isLocalNode = isLocalControlPlaneNode(ctx, node);
-  if (ctx.transport instanceof IpcTransport && node.daemonId && !isLocalNode) {
-    return ctx.transport.meshCommand(node.daemonId, command, args);
-  }
-  return ctx.transport.command(command, args);
-}
-function normalizePendingMeshCoordinatorEvents(value) {
-  const payload = unwrapCommandPayload(value);
-  const events = Array.isArray(payload?.events) ? payload.events : Array.isArray(value?.events) ? value.events : [];
-  return events.filter((event) => event && typeof event === "object");
-}
-function buildMeshForwardPayloadFromPendingEvent(event) {
-  const metadataEvent = event?.metadataEvent && typeof event.metadataEvent === "object" ? event.metadataEvent : {};
-  return {
-    event: readString(event?.event),
-    meshId: readString(event?.meshId),
-    nodeId: readString(event?.nodeId) || readString(metadataEvent.meshNodeId),
-    workspace: readString(event?.workspace) || readString(metadataEvent.workspace),
-    targetSessionId: readString(metadataEvent.targetSessionId) || readString(metadataEvent.sessionId) || readString(metadataEvent.instanceId),
-    providerType: readString(metadataEvent.providerType),
-    providerSessionId: readString(metadataEvent.providerSessionId),
-    finalSummary: readString(metadataEvent.finalSummary) || readString(metadataEvent.summary),
-    jobId: readString(metadataEvent.jobId),
-    interactionId: readString(metadataEvent.interactionId),
-    status: readString(metadataEvent.status),
-    targetDaemonId: readString(metadataEvent.targetDaemonId),
-    startedAt: readString(metadataEvent.startedAt),
-    completedAt: readString(metadataEvent.completedAt),
-    retryOfJobId: readString(metadataEvent.retryOfJobId),
-    ...metadataEvent.result && typeof metadataEvent.result === "object" && !Array.isArray(metadataEvent.result) ? { result: metadataEvent.result } : {},
-    ...metadataEvent.intentional === true ? { intentional: true } : {},
-    ...metadataEvent.intentionalStop === true ? { intentionalStop: true } : {},
-    ...metadataEvent.operatorCleanup === true ? { operatorCleanup: true } : {},
-    ...readString(metadataEvent.reason) ? { reason: readString(metadataEvent.reason) } : {},
-    ...readString(metadataEvent.stopReason) ? { stopReason: readString(metadataEvent.stopReason) } : {},
-    ...readString(metadataEvent.cleanupReason) ? { cleanupReason: readString(metadataEvent.cleanupReason) } : {},
-    ...readString(metadataEvent.source) ? { source: readString(metadataEvent.source) } : {}
-  };
-}
-async function drainCoordinatorPendingEvents(ctx, opts) {
-  const requestedNodeIds = opts?.nodeIds?.length ? new Set(opts.nodeIds) : null;
-  const matchesCurrentMesh = (event) => readString(event?.meshId) === ctx.mesh.id;
-  if (ctx.transport instanceof IpcTransport) {
-    const surfacedEvents = [];
-    const coordinatorDaemonId = readString(ctx.localDaemonId);
-    const pendingEventArgs = {
-      meshId: ctx.mesh.id,
-      ...coordinatorDaemonId ? { coordinatorDaemonId } : {}
-    };
-    try {
-      const localEvents = normalizePendingMeshCoordinatorEvents(await ctx.transport.command("get_pending_mesh_events", pendingEventArgs)).filter(matchesCurrentMesh);
-      for (const event of localEvents) {
-        const payload = buildMeshForwardPayloadFromPendingEvent(event);
-        if (!payload.event || !payload.meshId) continue;
-        let injected = false;
-        try {
-          await ctx.transport.command("mesh_forward_event", payload);
-          injected = true;
-        } catch {
-        }
-        rememberMeshSessionProviderMetadataFromEvent({ ...event, metadataEvent: payload });
-        if (!injected) surfacedEvents.push(event);
-      }
-    } catch {
-    }
-    for (const node of ctx.mesh.nodes) {
-      if (!node.daemonId || isLocalControlPlaneNode(ctx, node)) continue;
-      if (requestedNodeIds && !requestedNodeIds.has(node.id)) continue;
-      try {
-        const remoteEvents = normalizePendingMeshCoordinatorEvents(
-          await ctx.transport.meshCommand(node.daemonId, "get_pending_mesh_events", pendingEventArgs)
-        ).filter(matchesCurrentMesh);
-        if (remoteEvents.length === 0) continue;
-        for (const event of remoteEvents) {
-          const payload = buildMeshForwardPayloadFromPendingEvent(event);
-          if (!payload.event || !payload.meshId) continue;
-          await ctx.transport.command("mesh_forward_event", payload);
-          rememberMeshSessionProviderMetadataFromEvent({ ...event, metadataEvent: payload });
-        }
-      } catch {
-      }
-    }
-    try {
-      const localEvents = normalizePendingMeshCoordinatorEvents(await ctx.transport.command("get_pending_mesh_events", pendingEventArgs)).filter(matchesCurrentMesh);
-      for (const event of localEvents) {
-        const payload = buildMeshForwardPayloadFromPendingEvent(event);
-        if (!payload.event || !payload.meshId) continue;
-        let injected = false;
-        try {
-          await ctx.transport.command("mesh_forward_event", payload);
-          injected = true;
-        } catch {
-        }
-        rememberMeshSessionProviderMetadataFromEvent({ ...event, metadataEvent: payload });
-        if (!injected) surfacedEvents.push(event);
-      }
-    } catch {
-    }
-    return surfacedEvents;
-  }
-  const events = (0, import_daemon_core.drainPendingMeshCoordinatorEvents)(ctx.mesh.id, ctx.localDaemonId).filter(matchesCurrentMesh);
-  events.forEach(rememberMeshSessionProviderMetadataFromEvent);
-  return events;
-}
-function isP2pTransportUnavailableError(error) {
-  return (0, import_daemon_core.isP2pRelayTransportFailure)(error);
-}
-function buildRemoveNodeArgs(ctx, nodeId, sessionCleanupMode, force) {
-  return {
-    meshId: ctx.mesh.id,
-    nodeId,
-    ...sessionCleanupMode ? { sessionCleanupMode } : {},
-    ...force === true ? { force: true } : {},
-    inlineMesh: ctx.mesh
-  };
-}
-var MESH_STATUS_TOOL = {
-  name: "mesh_status",
-  description: "Get the current status of all nodes in the repo mesh \u2014 health, git state, active sessions, recovery hints, and recommended next steps. Use this to decide which node to send work to or how to recover from failures. Also reports the running daemon build per daemonId under top-level daemonBuilds ({commit, commitShort, version}); when a live daemon was built from a commit BEHIND its workspace HEAD it adds staleDaemonBuilds[] + staleDaemonBuildWarning \u2014 meaning a just-merged refinery/mesh-tool fix is NOT yet live on that daemon (awaiting deploy/restart; a local dist rebuild does not update a cloud daemon). Do not repeatedly call this to wait for generating delegated work; wait for pendingCoordinatorEvents/completion events or an explicit user status request.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      _gemini_compat: { type: "string", description: "Dummy property for Gemini compatibility. Ignore this." },
-      includeStaleDirectWorkDetails: { type: "boolean", description: "Opt in to the full staleDirectWork array. Defaults false; normal status returns compact staleDirectWorkSummary only." },
-      includeSessions: { type: "boolean", description: "Opt in to per-node live session arrays. Default false: compact mode returns a per-node sessionSummary (counts) and de-duplicated full session lists under top-level daemonSessions keyed by daemonId (sessions are not repeated for every node that shares a daemon). Set true to also include the full session array on each node." },
-      compact: { type: "boolean", description: "Slim payload for LLM callers. Default true. Folds per-node session arrays to sessionSummary and de-duplicates daemon-shared sessions into daemonSessions. Set false (or verbose=true) for the full dashboard-grade payload." },
-      verbose: { type: "boolean", description: "Force the full payload; overrides compact." }
-    }
+};
+var MESH_RESTART_DAEMON_TOOL = {
+  name: "mesh_restart_daemon",
+  description: `Update a mesh node's daemon to the latest published version on its release channel and restart it \u2014 the same path as the dashboard "preview update" button, exposed as a mesh command so a coordinator can roll a worker daemon onto a freshly deployed version without a manual restart round-trip. No agent session is launched. Idle-gated: a node whose daemon has an active session (generating / waiting_approval / starting) is refused with code "blocking_sessions" so an in-flight turn is never interrupted. If the node is already on the latest version it is a no-op (no restart), matching the dashboard button (returns alreadyLatest:true). Targets a single node \u2014 call other (idle) nodes first; restarting the coordinator's OWN daemon is naturally refused while its calling turn is active. Passing channel switches the daemon's release channel (and server URL) before restarting; omit it to keep the daemon on its configured channel.`,
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Target node ID \u2014 the daemon that owns this node is updated and restarted." },
+      channel: { type: "string", enum: ["stable", "preview"], description: "Optional release channel to update from. Defaults to the daemon's configured updateChannel. Setting it also repoints the daemon's server URL to that channel." }
+    },
+    required: ["node_id"]
   }
 };
-var MESH_LIST_NODES_TOOL = {
-  name: "mesh_list_nodes",
-  description: "List all nodes in the mesh with their capabilities, platform, and workspace paths.",
+var MESH_CHECKPOINT_TOOL = {
+  name: "mesh_checkpoint",
+  description: "Create a git checkpoint (commit) on a mesh node workspace.",
   inputSchema: {
     type: "object",
     properties: {
-      _gemini_compat: { type: "string", description: "Dummy property for Gemini compatibility. Ignore this." }
-    }
+      node_id: { type: "string", description: "Target node ID." },
+      message: { type: "string", description: "Checkpoint commit message." }
+    },
+    required: ["node_id", "message"]
   }
 };
-var MESH_ENQUEUE_TASK_TOOL = {
-  name: "mesh_enqueue_task",
-  description: "Add a new task to the mesh work queue. Idle nodes will automatically pull and execute tasks from this queue. Use this instead of mesh_send_task when you do not need to target a specific node.",
+var MESH_MISSION_UPSERT_TOOL = {
+  name: "mesh_mission_upsert",
+  description: "Create or update a persistent mission record so the plan survives coordinator restarts. Create a mission before enqueueing a multi-task batch, attach tasks via mesh_enqueue_task mission_id, and update status to completed/abandoned when the outcome is decided. Progress is derived from task statuses \u2014 there is no separate progress field.",
   inputSchema: {
     type: "object",
     properties: {
-      message: { type: "string", description: "The task instruction for the agent." },
-      task_mode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "Optional task-mode contract. live_debug_readonly rejects obvious write/commit/push/deploy/destructive instructions before dispatch." },
-      taskMode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "CamelCase alias for task_mode." },
-      requiredTags: { type: "array", items: { type: "string" }, description: "Optional capability tags that every eligible node must have, e.g. os=darwin, provider=codex-cli, gpu." },
-      required_tags: { type: "array", items: { type: "string" }, description: "Snake_case alias for requiredTags." },
-      target_node_id: { type: "string", description: "Optional: only this node may claim the task. Use to route a queued task to a specific (e.g. freshly cloned) worktree node instead of letting the first idle base node claim it. Takes priority over prefer_worktree." },
-      targetNodeId: { type: "string", description: "CamelCase alias for target_node_id." },
-      prefer_worktree: { type: "boolean", description: "Optional: when true, route this task to the most recently cloned idle worktree node (avoids the main/base workspace preemptively claiming an isolated task). No-op if no worktree node exists; resolves to a target_node_id when one does." },
-      preferWorktree: { type: "boolean", description: "CamelCase alias for prefer_worktree." },
-      depends_on: { type: "array", items: { type: "string" }, description: "Task ids that must complete before this task becomes claimable. Cycles are rejected at enqueue." },
-      dependsOn: { type: "array", items: { type: "string" }, description: "CamelCase alias for depends_on." },
-      mission_id: { type: "string", description: "Mission this task belongs to (mesh_mission record id)." },
-      missionId: { type: "string", description: "CamelCase alias for mission_id." }
+      mission_id: { type: "string", description: "Mission id to update. Omit to create a new mission." },
+      title: { type: "string", description: "Short mission title." },
+      goal: { type: "string", description: "Free-text mission goal/definition of done." },
+      status: { type: "string", enum: ["active", "paused", "completed", "abandoned"], description: "Mission lifecycle status. Defaults to active on create." }
     },
-    required: ["message"]
+    required: ["title"]
   }
 };
-var MESH_VIEW_QUEUE_TOOL = {
-  name: "mesh_view_queue",
-  description: "View the mesh work queue with source-of-truth active counts separated from historical completed/failed/cancelled records. Do not repeatedly call this to wait for generating assigned work; wait for pendingCoordinatorEvents/completion events or an explicit user status request.",
+var MESH_MISSION_LIST_TOOL = {
+  name: "mesh_mission_list",
+  description: 'List missions with their goal, status, and live task progress (total/pending/assigned/completed/failed). Unlike mesh_status (which surfaces live + recent missions), this returns every mission regardless of status by default, so paused/abandoned/completed missions are never hidden. Filter with `status` to scope (e.g. ["paused"] to find paused missions). Compact (default) elides the full goal to a capped preview; pass verbose=true for full goal text. Read-only.',
   inputSchema: {
     type: "object",
     properties: {
       status: {
         type: "array",
-        items: { type: "string" },
-        description: "Explicit row filter by task status: pending, assigned, completed, failed, cancelled. Source-of-truth counts remain unfiltered; visible* counts describe returned rows."
-      },
-      view: {
-        type: "string",
-        enum: ["all", "active", "historical"],
-        description: "Optional row view. active returns pending/assigned rows, historical returns completed/failed/cancelled rows, all returns every persisted queue row. Defaults to all for compatibility."
+        items: { type: "string", enum: ["active", "paused", "completed", "abandoned"] },
+        description: "Optional status filter. Omit to return missions of every status."
       },
-      compact: { type: "boolean", description: "Slim payload for LLM callers. Default true. Drops large historical (completed/failed/cancelled) queue row arrays, the full staleDirectWork orphan array (kept as staleDirectWorkSummary counts), and per-row maintenance cleanupCandidates in favor of counts; pending/assigned active rows are retained. Set false (or verbose=true) for the full dashboard-grade payload." },
-      verbose: { type: "boolean", description: "Force the full payload; overrides compact." }
+      verbose: { type: "boolean", description: "Return full goal text instead of a capped preview. Defaults to false (compact)." }
     }
   }
 };
-var MESH_QUEUE_CANCEL_TOOL = {
-  name: "mesh_queue_cancel",
-  description: "Cancel a pending/assigned/completed/failed mesh queue task without deleting audit history. Use this to retire stale queue items that target dead sessions.",
+var MESH_APPROVE_TOOL = {
+  name: "mesh_approve",
+  description: "Approve or reject a pending action on a delegated agent session.",
   inputSchema: {
     type: "object",
     properties: {
-      task_id: { type: "string", description: "Queue task ID to cancel." },
-      reason: { type: "string", description: "Optional operator-visible reason for cancellation." }
+      node_id: { type: "string", description: "Target node ID." },
+      session_id: { type: "string", description: "Agent session ID with pending approval." },
+      action: { type: "string", enum: ["approve", "reject"], description: "Action to take." }
     },
-    required: ["task_id"]
+    required: ["node_id", "session_id", "action"]
   }
 };
-var MESH_QUEUE_REQUEUE_TOOL = {
-  name: "mesh_queue_requeue",
-  description: "Return a mesh queue task to pending for retry. By default clears stale assigned owner and target session so another live session can claim it. When the task has exceeded its retry cap it is auto-failed instead; use force=true to override.",
+var MESH_CLONE_NODE_TOOL = {
+  name: "mesh_clone_node",
+  description: "Create a new worktree-based node from an existing node for isolated parallel work. Creates a git worktree on a new branch so multiple tasks can run on separate branches simultaneously.",
   inputSchema: {
     type: "object",
     properties: {
-      task_id: { type: "string", description: "Queue task ID to requeue." },
-      reason: { type: "string", description: "Optional operator-visible reason for requeueing." },
-      target_node_id: { type: "string", description: "Optional replacement target node ID." },
-      target_session_id: { type: "string", description: "Optional replacement target runtime session ID." },
-      clear_target_node: { type: "boolean", description: "When true, remove any existing target node constraint." },
-      keep_target_session: { type: "boolean", description: "When true, preserve an existing target session if target_session_id is not provided. Defaults false to avoid stale session targets." },
-      force: { type: "boolean", description: "When true, bypass the retry cap and requeue even if maxRetries has been exceeded. Use only for explicit operator recovery." }
+      source_node_id: { type: "string", description: "Node ID to clone from (from mesh_list_nodes)." },
+      branch: { type: "string", description: 'Branch name for the new worktree (e.g. "feat/auth-refactor").' },
+      base_branch: { type: "string", description: "Starting point for the branch (default: current HEAD)." }
     },
-    required: ["task_id"]
+    required: ["source_node_id", "branch"]
   }
 };
-var MESH_SEND_TASK_TOOL = {
-  name: "mesh_send_task",
-  description: "Legacy push-based task assignment. Enqueues a task specifically targeted at a given node. The node will pull it immediately if idle.",
+var MESH_REMOVE_NODE_TOOL = {
+  name: "mesh_remove_node",
+  description: "Remove a node from the mesh. If the node is a worktree, also cleans up the git worktree and directory. Session cleanup is controlled by mesh policy sessionCleanupOnNodeRemove unless session_cleanup_mode overrides it for this call. The coordinator's own local base node (same machine, NOT a worktree) is protected \u2014 removing it breaks live mesh membership and is rejected unless force:true is passed.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID (from mesh_list_nodes)." },
-      session_id: { type: "string", description: "Agent session ID on the target node." },
-      message: { type: "string", description: "Natural-language task to send to the agent." },
-      task_mode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "Optional task-mode contract. live_debug_readonly rejects obvious write/commit/push/deploy/destructive instructions before local or remote direct dispatch." },
-      taskMode: { type: "string", enum: ["code_change", "validation", "live_debug_readonly", "launch_app", "convergence"], description: "CamelCase alias for task_mode." },
-      mission_id: { type: "string", description: "Mission this task belongs to (mesh_mission record id). When set, the directly dispatched task is attributed to the mission task aggregates exactly like mesh_enqueue_task, including terminal completion. Omit for an unattributed direct dispatch." },
-      missionId: { type: "string", description: "CamelCase alias for mission_id." }
+      node_id: { type: "string", description: "Node ID to remove." },
+      session_cleanup_mode: {
+        type: "string",
+        enum: ["preserve", "stop", "delete_stopped", "stop_and_delete"],
+        description: "Optional override for cleanup of delegated sessions attached to this node. preserve keeps history/processes; stop stops live runtimes only; delete_stopped removes completed transcripts only; stop_and_delete stops live runtimes and deletes records."
+      },
+      force: { type: "boolean", description: "Override the coordinator-base-node guard. Only set true to intentionally tear down this mesh; the coordinator must then be re-registered/restarted. Worktree nodes never need force." }
     },
-    required: ["node_id", "session_id", "message"]
+    required: ["node_id"]
   }
 };
-var MESH_READ_CHAT_TOOL = {
-  name: "mesh_read_chat",
-  description: "Read recent chat messages from a delegated agent session on a mesh node. Use compact=true for coordinator context-efficient review: it filters tool/internal/debug chatter and returns the final user-visible summary plus recent key messages. If the runtime session has completed, provider_session_id can explicitly target provider transcript history.",
+var MESH_CLEANUP_SESSIONS_TOOL = {
+  name: "mesh_cleanup_sessions",
+  description: "Manually clean up delegated session records for a mesh node without removing the node. Defaults should preserve reviewable history unless the caller chooses a mode explicitly.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID." },
-      session_id: { type: "string", description: "Agent session ID to read from." },
-      provider_session_id: { type: "string", description: "Optional provider transcript/session ID for completed sessions." },
-      tail: { type: "number", description: "Number of recent messages to return (default: 10)." },
-      compact: { type: "boolean", description: "When true, return a compact coordinator summary instead of the full transcript: tool/internal/control/debug messages are excluded and only recent user-visible key messages plus the final assistant summary are included." }
+      node_id: { type: "string", description: "Node ID whose delegated sessions should be considered for cleanup." },
+      mode: {
+        type: "string",
+        enum: ["preserve", "stop", "delete_stopped", "stop_and_delete"],
+        description: "preserve = no-op; stop = release process occupancy by stopping live runtimes; delete_stopped = remove completed/stopped records while leaving live runtimes alone; stop_and_delete = stop live runtimes and delete records."
+      },
+      session_ids: {
+        type: "array",
+        items: { type: "string" },
+        description: "Optional explicit session IDs to limit cleanup to. When omitted, sessions are matched by node/workspace metadata."
+      },
+      dry_run: { type: "boolean", description: "Preview matched/stopped/deleted/skipped session IDs without mutating session-host state." }
     },
-    required: ["node_id", "session_id"]
+    required: ["node_id", "mode"]
   }
 };
-var MESH_READ_DEBUG_TOOL = {
-  name: "mesh_read_debug",
-  description: "Collect a daemon-side chat/parser debug bundle for a delegated agent session on a mesh node without opening the browser UI. Defaults to daemon_file delivery and returns a saved bundle locator.",
+var MESH_TASK_HISTORY_TOOL = {
+  name: "mesh_task_history",
+  description: "Read the task ledger for this mesh \u2014 dispatched tasks, completions, failures, checkpoints, and node lifecycle events. Use to understand what has been done before deciding next steps, to detect repeated failures, and to inform recovery decisions.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID." },
-      session_id: { type: "string", description: "Agent session ID to debug." },
-      provider_session_id: { type: "string", description: "Optional provider transcript/session ID for completed session history." },
-      tail: { type: "number", description: "Number of recent read_chat messages to embed (default: 40)." },
-      delivery: { type: "string", enum: ["daemon_file", "inline"], description: "daemon_file saves the full sanitized bundle on the daemon; inline returns it directly. Default: daemon_file." }
-    },
-    required: ["node_id", "session_id"]
+      tail: { type: "number", description: "Number of recent entries to return (default: 20; clamped to 40 in compact mode, 200 in verbose)." },
+      kind: { type: "string", description: "Filter by entry kind: task_dispatched, task_completed, task_failed, task_stalled, session_launched, checkpoint_created, node_cloned, node_removed, direct_fast_forward." },
+      compact: { type: "boolean", description: "Slim payload for LLM callers. Default true. Truncates long payload strings (message/taskSummary \u2264200, finalSummary \u2264300) and elides any large nested evidence blob (>2KB serialized \u2014 e.g. validationSummary/result/patchEquivalence/submoduleReachability) to a {_elided,_kind,_bytes,_hint} placeholder; full evidence stays accessible via mesh_reconcile_ledger. Set false (or verbose=true) for full untruncated payloads." },
+      verbose: { type: "boolean", description: "Force the full untruncated payload; overrides compact." }
+    }
   }
 };
-var MESH_LAUNCH_SESSION_TOOL = {
-  name: "mesh_launch_session",
-  description: "Launch a new agent session on a mesh node. Returns the session ID for subsequent send_task/read_chat calls. If the user names a provider, preserve it exactly: Hermes = hermes-cli, Claude Code/Claude = claude-cli, Codex = codex-cli, Gemini = gemini-cli. If type is omitted, resolve strictly from the node policy providerPriority and provider detection; fail closed when no configured provider is usable. Do not default to claude-cli.",
+var MESH_RECORD_NOTE_TOOL = {
+  name: "mesh_record_note",
+  description: "Record a durable operating note for this mesh \u2014 a runtime-accumulated lesson that future coordinators inherit. Unlike Claude-only memory/CLAUDE.md, this is provider-neutral: it persists in the mesh ledger and is injected into every coordinator's system prompt at launch (codex, hermes, antigravity, claude alike). Use it when you learn something durable: a provider quirk, a pattern to avoid, or a recovery lesson. Keep each note to one concrete, reusable fact. Not for transient task status \u2014 use missions/checkpoints for that.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID." },
-      type: { type: "string", description: "Optional provider type to launch. Use hermes-cli for Hermes, claude-cli for Claude Code, codex-cli for Codex, gemini-cli for Gemini. When omitted, node.policy.providerPriority is probed in order." }
+      text: { type: "string", description: "The note \u2014 one concrete, reusable operating fact/lesson. Phrase it so a future coordinator can act on it without this conversation's context." },
+      category: {
+        type: "string",
+        enum: ["provider_quirk", "pattern_to_avoid", "recovery_lesson"],
+        description: "Optional classification: provider_quirk (a provider/runtime behaves unexpectedly), pattern_to_avoid (an approach that caused problems), recovery_lesson (how a failure was recovered)."
+      }
     },
-    required: ["node_id"]
+    required: ["text"]
   }
 };
-var MESH_GIT_STATUS_TOOL = {
-  name: "mesh_git_status",
-  description: "Get git status for a mesh node workspace \u2014 branch, dirty state, changed files.",
+var MESH_RECONCILE_LEDGER_TOOL = {
+  name: "mesh_reconcile_ledger",
+  description: "Reconcile daemon-local mesh ledgers by querying bounded ledger slices over P2P/DataChannel and importing missing entries into the coordinator local JSONL ledger. Cloud/D1 is not used as a ledger source of truth.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID." }
-    },
-    required: ["node_id"]
+      node_ids: { type: "array", items: { type: "string" }, description: "Optional node IDs to query. Defaults to all mesh nodes." },
+      limit: { type: "number", description: "Bounded slice size per node. Defaults to 100 and is clamped by daemon-core." },
+      after_id: { type: "string", description: "Optional cursor entry ID; remote slices return entries strictly after this ID when present." },
+      since: { type: "string", description: "Optional ISO timestamp lower bound for queried entries." },
+      import_entries: { type: "boolean", description: "When false, query and report evidence without importing remote entries. Defaults true." }
+    }
   }
 };
-var MESH_READ_NODE_LOGS_TOOL = {
-  name: "mesh_read_node_logs",
-  description: "Fetch a recent daemon LOG tail directly from a (possibly remote) mesh node over P2P \u2014 no session launch, no PowerShell/shell grep on the remote machine. Use this to debug a node's daemon: read its error/warn lines, grep for a pattern, or read since a timestamp. The reply is byte-bounded (\u2264128KB, default 64KB; truncated:true when the file was larger, newest lines kept) and secrets (API keys, machine secrets, bearer tokens, JWTs, TURN credentials) are redacted before transmission. This reads the DAEMON log, not an agent session transcript \u2014 for a session transcript use mesh_read_chat / mesh_read_debug.",
+var MESH_PRUNE_STALE_DIRECT_TOOL = {
+  name: "mesh_prune_stale_direct",
+  description: "Prune orphaned staleDirect dispatch records \u2014 direct task dispatches whose original node/session is no longer present in the live mesh. dry_run (default) reports exactly which records would be pruned without mutating anything; pass execute=true to delete them. Active/pending/assigned/generating work and fresh unacknowledged dispatch failures (node/session still live) are always preserved. The append-only mesh ledger audit history is left intact.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID (the daemon owning it serves its own log)." },
-      grep: { type: "string", description: "Optional regex (case-insensitive) \u2014 only matching log lines are returned. Invalid regex falls back to a literal substring match." },
-      since_ms: { type: "number", description: "Optional epoch-ms floor \u2014 only log lines at/after this time are returned (lines without a parseable timestamp are kept)." },
-      tail_bytes: { type: "number", description: "Max bytes of log tail to read (default 65536, capped at 131072). Larger files are truncated to the newest tail_bytes." },
-      date: { type: "string", description: "Optional YYYY-MM-DD log date (defaults to today). Falls back to the size-rotation backup when the active file is absent." }
-    },
-    required: ["node_id"]
+      execute: { type: "boolean", description: "When true, actually delete the orphaned records. Defaults false (dry run). Ignored when dry_run=true." },
+      dry_run: { type: "boolean", description: "Force a preview without mutation even if execute=true. Defaults to dry-run behavior when execute is not set." },
+      include_terminal: { type: "boolean", description: "Also prune terminal (completed/failed) direct dispatch store rows in addition to orphans. Defaults false." }
+    }
   }
 };
-var MESH_FAST_FORWARD_NODE_TOOL = {
-  name: "mesh_fast_forward_node",
-  description: 'Safely dry-run or execute an obvious direct fast-forward for a mesh node without launching an agent session. mode="merge" (default) absorbs upstream commits into the local branch via git merge --ff-only (ahead=0, behind>0). mode="push" publishes local commits to origin via a strict ff-only push (HEAD must be a descendant of origin/<branch>). Defaults to dry-run; execution requires execute=true. Never force-pushes, rebases, resets, cleans, or checks out arbitrary revisions. When the merge path finds the branch ahead with nothing to merge, it returns code "ahead_needs_push" pointing at mode="push".',
+var MESH_REFINE_NODE_TOOL = {
+  name: "mesh_refine_node",
+  description: "The Refinery: validate \u2192 merge \u2192 push \u2192 clean up a completed worktree node onto the base branch. Defaults to dry-run (plan only): returns the validation plan with mergeWillRun:false/cleanupWillRun:false and performs NO merge/push/cleanup. Pass execute=true to actually converge the node. execute=true is async: the immediate response includes async:true, status:'accepted', jobId, interactionId, target node, and startedAt; completion/failure evidence is delivered through pending mesh events and the mesh task ledger. dry_run=true overrides execute. Matches the mesh_refine_batch / mesh_fast_forward_node dry_run/execute contract.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID." },
-      mode: { type: "string", enum: ["merge", "push"], description: "merge (default): git merge --ff-only to absorb upstream. push: strict ff-only push of local commits to origin/<branch>; refuses any non-fast-forward." },
-      branch: { type: "string", description: "Optional guard: require the node's current branch to match this branch before planning/executing." },
-      execute: { type: "boolean", description: "When true, apply the fast-forward/push if all safety gates pass. Defaults false/dry-run." },
-      dry_run: { type: "boolean", description: "Preview only. Defaults true unless execute=true; dry_run=true overrides execute." },
-      update_submodules: { type: "boolean", description: 'mode="merge" only: when true, if the root fast-forward changes gitlinks, run only git submodule update --init --recursive and verify submodules clean.' },
-      push_submodules: { type: "boolean", description: 'mode="push" only: also ff-only push submodule HEADs to their origin main. Gated by mesh policy allowAutoPublishSubmoduleMainCommits \u2014 skipped unless that policy is enabled. Defaults false (root push only).' }
+      node_id: { type: "string", description: "Node ID of the completed worktree node to refine and merge." },
+      execute: { type: "boolean", description: "When true, run validation/merge/push/cleanup for this node. Defaults false/dry-run." },
+      dry_run: { type: "boolean", description: "Preview the validation plan without merging. Defaults true unless execute=true; dry_run=true overrides execute." }
     },
     required: ["node_id"]
   }
 };
-var MESH_RESTART_DAEMON_TOOL = {
-  name: "mesh_restart_daemon",
-  description: `Update a mesh node's daemon to the latest published version on its release channel and restart it \u2014 the same path as the dashboard "preview update" button, exposed as a mesh command so a coordinator can roll a worker daemon onto a freshly deployed version without a manual restart round-trip. No agent session is launched. Idle-gated: a node whose daemon has an active session (generating / waiting_approval / starting) is refused with code "blocking_sessions" so an in-flight turn is never interrupted. If the node is already on the latest version it is a no-op (no restart), matching the dashboard button (returns alreadyLatest:true). Targets a single node \u2014 call other (idle) nodes first; restarting the coordinator's OWN daemon is naturally refused while its calling turn is active. Passing channel switches the daemon's release channel (and server URL) before restarting; omit it to keep the daemon on its configured channel.`,
+var MESH_REFINE_BATCH_TOOL = {
+  name: "mesh_refine_batch",
+  description: "Batch Refinery: converge multiple sibling worktree nodes onto the base branch in one conflict-aware sequential pipeline. Orders nodes by change-area (non-submodule nodes first, submodule-touching nodes serialized last) so each merged sibling advances the base and the next node auto-rebases + re-checks patch-equivalence before its own merge. Each node runs the same validation/patch-equivalence/submodule-reachability/merge/cleanup gates as mesh_refine_node. Conflicting or blocked nodes are isolated as blocked_review while the rest of the batch proceeds. Defaults to dry-run (plan only); set execute=true to converge. Never force-pushes or resets. execute=true is async: the immediate response is async:true / status:'accepted' with the batch jobId and ordered target node list; per-node convergence runs in the background and the aggregate completion/failure (with per-node merged / blocked_review / not_mergeable results) is delivered as a terminal refine event via pending mesh events and the ledger \u2014 do not re-invoke while a batch is in flight. dry_run returns the plan synchronously.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID \u2014 the daemon that owns this node is updated and restarted." },
-      channel: { type: "string", enum: ["stable", "preview"], description: "Optional release channel to update from. Defaults to the daemon's configured updateChannel. Setting it also repoints the daemon's server URL to that channel." }
+      node_ids: {
+        type: "array",
+        items: { type: "string" },
+        description: "Optional explicit node IDs to converge, in any order (the tool computes the safe merge order). When omitted, all local worktree nodes that need convergence are auto-collected."
+      },
+      execute: { type: "boolean", description: "When true, run validation/rebase/merge for each node in order. Defaults false/dry-run." },
+      dry_run: { type: "boolean", description: "Preview the ordering + per-node validation plan without executing. Defaults true unless execute=true; dry_run=true overrides execute." }
     },
-    required: ["node_id"]
+    required: []
   }
 };
-var MESH_CHECKPOINT_TOOL = {
-  name: "mesh_checkpoint",
-  description: "Create a git checkpoint (commit) on a mesh node workspace.",
+var MESH_REFINE_CONFIG_SCHEMA_TOOL = {
+  name: "mesh_refine_config_schema",
+  description: "Return the Repo Mesh Refinery config JSON schema and supported repo-local config locations. This is the validation source of truth; heuristic command detection is suggestions-only.",
+  inputSchema: { type: "object", properties: {} }
+};
+var MESH_VALIDATE_REFINE_CONFIG_TOOL = {
+  name: "mesh_validate_refine_config",
+  description: "Validate the repo mesh/refine config for a node/workspace without running validation commands or merging.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID." },
-      message: { type: "string", description: "Checkpoint commit message." }
-    },
-    required: ["node_id", "message"]
+      node_id: { type: "string", description: "Optional node/workspace whose refine config should be loaded. Defaults to the first mesh node." },
+      config: { type: "object", description: "Optional inline config object to validate instead of loading from the repo." }
+    }
   }
 };
-var MESH_MISSION_UPSERT_TOOL = {
-  name: "mesh_mission_upsert",
-  description: "Create or update a persistent mission record so the plan survives coordinator restarts. Create a mission before enqueueing a multi-task batch, attach tasks via mesh_enqueue_task mission_id, and update status to completed/abandoned when the outcome is decided. Progress is derived from task statuses \u2014 there is no separate progress field.",
+var MESH_SUGGEST_REFINE_CONFIG_TOOL = {
+  name: "mesh_suggest_refine_config",
+  description: "Suggest a repo mesh/refine config scaffold from project context/package scripts. Suggestions are never executed until saved as explicit refine config.",
   inputSchema: {
     type: "object",
     properties: {
-      mission_id: { type: "string", description: "Mission id to update. Omit to create a new mission." },
-      title: { type: "string", description: "Short mission title." },
-      goal: { type: "string", description: "Free-text mission goal/definition of done." },
-      status: { type: "string", enum: ["active", "paused", "completed", "abandoned"], description: "Mission lifecycle status. Defaults to active on create." }
-    },
-    required: ["title"]
+      node_id: { type: "string", description: "Optional node/workspace used for suggestions. Defaults to the first mesh node." }
+    }
   }
 };
-var MESH_MISSION_LIST_TOOL = {
-  name: "mesh_mission_list",
-  description: 'List missions with their goal, status, and live task progress (total/pending/assigned/completed/failed). Unlike mesh_status (which surfaces live + recent missions), this returns every mission regardless of status by default, so paused/abandoned/completed missions are never hidden. Filter with `status` to scope (e.g. ["paused"] to find paused missions). Compact (default) elides the full goal to a capped preview; pass verbose=true for full goal text. Read-only.',
+var MESH_CHANGE_IMPACT_CONFIG_SCHEMA_TOOL = {
+  name: "mesh_change_impact_config_schema",
+  description: "Return the Change Impact config JSON schema and supported repo-local config locations. Change Impact config declaratively classifies which package/file changes between the live daemon build and workspace HEAD require a daemon rebuild/restart vs. a web-only redeploy vs. nothing. Declarative only \u2014 config is parsed, never executed.",
+  inputSchema: { type: "object", properties: {} }
+};
+var MESH_VALIDATE_CHANGE_IMPACT_CONFIG_TOOL = {
+  name: "mesh_validate_change_impact_config",
+  description: "Validate a Change Impact config for a node/workspace and report valid/errors. Loads .adhdev/change-impact.{json,yaml,yml} (or repo-mesh-change-impact.* alias) from the repo unless an inline config is provided.",
   inputSchema: {
     type: "object",
     properties: {
-      status: {
-        type: "array",
-        items: { type: "string", enum: ["active", "paused", "completed", "abandoned"] },
-        description: "Optional status filter. Omit to return missions of every status."
-      },
-      verbose: { type: "boolean", description: "Return full goal text instead of a capped preview. Defaults to false (compact)." }
+      node_id: { type: "string", description: "Optional node/workspace whose change-impact config should be loaded. Defaults to the first mesh node." },
+      config: { type: "object", description: "Optional inline config object to validate instead of loading from the repo." }
     }
   }
 };
-var MESH_APPROVE_TOOL = {
-  name: "mesh_approve",
-  description: "Approve or reject a pending action on a delegated agent session.",
+var MESH_SUGGEST_CHANGE_IMPACT_CONFIG_TOOL = {
+  name: "mesh_suggest_change_impact_config",
+  description: "Suggest a Change Impact config scaffold from the repo package layout (web-* \u2192 web-only, others \u2192 daemon-runtime, plus docs/license markers as non-runtime). Heuristic scaffold only \u2014 the draft must be reviewed and saved before it takes effect; nothing is executed.",
   inputSchema: {
     type: "object",
     properties: {
-      node_id: { type: "string", description: "Target node ID." },
-      session_id: { type: "string", description: "Agent session ID with pending approval." },
-      action: { type: "string", enum: ["approve", "reject"], description: "Action to take." }
+      node_id: { type: "string", description: "Optional node/workspace used for suggestions. Defaults to the first mesh node." }
+    }
+  }
+};
+var MESH_INIT_TOOL = {
+  name: "mesh_init",
+  description: "One-click mesh onboarding for an existing git project. Detects installed CLI providers, suggests Refinery (.adhdev/refine.json) and worktree bootstrap (.adhdev/worktree_bootstrap.json) configs, optionally writes them to disk, and recommends a node providerPriority from the detected providers. Suggestions are scaffold only and never execute until saved; providerPriority is a recommendation to apply to node policy, not auto-applied. Defaults to dry-run (no files written) and never overwrites an existing config unless overwrite=true.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Optional node/workspace to onboard. Defaults to the first mesh node with a workspace." },
+      write: { type: "boolean", description: "When true, persist the suggested configs to disk. Defaults false (dry-run preview only)." },
+      overwrite: { type: "boolean", description: "When true, overwrite an existing config file. Defaults false (never clobber an existing refine/bootstrap config)." }
+    }
+  }
+};
+var MESH_REFINE_PLAN_TOOL = {
+  name: "mesh_refine_plan",
+  description: "Dry-run Refinery plan for a worktree node: reports config source, validation commands, suggestions/unavailable reason, and merge/cleanup intent without executing validation or git merge.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      node_id: { type: "string", description: "Node ID of the worktree node to plan." }
     },
-    required: ["node_id", "session_id", "action"]
+    required: ["node_id"]
+  }
+};
+var MESH_REVIEW_INBOX_TOOL = {
+  name: "mesh_review_inbox",
+  description: "List local worktree nodes that need human review: merge candidates (pushed feature branches ready to merge) and Refinery-blocked review results. Returns evidence summaries, diff stats vs. the default branch, and suggested actions (Refine / Requeue / Dismiss). Remote nodes are excluded in M4.0.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      mesh_id: { type: "string", description: "Mesh ID (optional \u2014 inferred from active mesh if omitted)." }
+    },
+    required: []
+  }
+};
+var ALL_MESH_TOOLS = [
+  MESH_STATUS_TOOL,
+  MESH_LIST_NODES_TOOL,
+  MESH_ENQUEUE_TASK_TOOL,
+  MESH_VIEW_QUEUE_TOOL,
+  MESH_QUEUE_CANCEL_TOOL,
+  MESH_QUEUE_REQUEUE_TOOL,
+  MESH_SEND_TASK_TOOL,
+  MESH_READ_CHAT_TOOL,
+  MESH_READ_DEBUG_TOOL,
+  MESH_LAUNCH_SESSION_TOOL,
+  MESH_GIT_STATUS_TOOL,
+  MESH_READ_NODE_LOGS_TOOL,
+  MESH_FAST_FORWARD_NODE_TOOL,
+  MESH_RESTART_DAEMON_TOOL,
+  MESH_CHECKPOINT_TOOL,
+  MESH_APPROVE_TOOL,
+  MESH_CLONE_NODE_TOOL,
+  MESH_REMOVE_NODE_TOOL,
+  MESH_REFINE_NODE_TOOL,
+  MESH_REFINE_BATCH_TOOL,
+  MESH_REFINE_CONFIG_SCHEMA_TOOL,
+  MESH_VALIDATE_REFINE_CONFIG_TOOL,
+  MESH_SUGGEST_REFINE_CONFIG_TOOL,
+  MESH_CHANGE_IMPACT_CONFIG_SCHEMA_TOOL,
+  MESH_VALIDATE_CHANGE_IMPACT_CONFIG_TOOL,
+  MESH_SUGGEST_CHANGE_IMPACT_CONFIG_TOOL,
+  MESH_INIT_TOOL,
+  MESH_REFINE_PLAN_TOOL,
+  MESH_CLEANUP_SESSIONS_TOOL,
+  MESH_PRUNE_STALE_DIRECT_TOOL,
+  MESH_TASK_HISTORY_TOOL,
+  MESH_RECORD_NOTE_TOOL,
+  MESH_RECONCILE_LEDGER_TOOL,
+  MESH_MISSION_UPSERT_TOOL,
+  MESH_MISSION_LIST_TOOL,
+  MESH_REVIEW_INBOX_TOOL
+];
+
+// src/tools/mesh-tools.ts
+var SESSION_PROVIDER_METADATA_TTL_MS = 30 * 6e4;
+var meshSessionProviderMetadata = /* @__PURE__ */ new Map();
+function getSessionMetadata(key) {
+  const entry = meshSessionProviderMetadata.get(key);
+  if (!entry) return void 0;
+  if (entry.expiresAt <= Date.now()) {
+    meshSessionProviderMetadata.delete(key);
+    return void 0;
+  }
+  return entry;
+}
+var ACTIVE_WORK_POLLING_BACKOFF_MS = 6e4;
+function buildActiveWorkPollingGuidance(summary, now = Date.now()) {
+  if (!summary || summary.generatingCount <= 0) return void 0;
+  return {
+    activeGeneratingWork: true,
+    generatingCount: summary.generatingCount,
+    doNotPollBefore: new Date(now + ACTIVE_WORK_POLLING_BACKOFF_MS).toISOString(),
+    eventSurface: "pendingCoordinatorEvents",
+    nextRecommendedAction: "Wait for pendingCoordinatorEvents/completion events or an explicit user status request. If no terminal evidence appears and the user asks for status, make one bounded status check, then wait again.",
+    message: "Do not repeatedly poll mesh_status/mesh_view_queue/mesh_read_chat while delegated work is generating; terminal ledger or completion evidence will be surfaced through pendingCoordinatorEvents when available."
+  };
+}
+function summarizeTaskMessage(message) {
+  const taskSummary = message.replace(/\s+/g, " ").trim();
+  const taskTitle = taskSummary.length > 96 ? `${taskSummary.slice(0, 93)}...` : taskSummary;
+  return { taskTitle: taskTitle || "(untitled task)", taskSummary };
+}
+function buildDirectTaskPayload(message, via, opts) {
+  const descriptor = summarizeTaskMessage(message);
+  return {
+    source: "direct",
+    via,
+    taskId: opts.taskId,
+    message,
+    taskTitle: descriptor.taskTitle,
+    taskSummary: descriptor.taskSummary,
+    ...opts.taskMode ? { taskMode: opts.taskMode } : {},
+    ...opts.providerType ? { providerType: opts.providerType } : {},
+    ...opts.targetSessionId ? { targetSessionId: opts.targetSessionId } : {},
+    ...opts.dispatchedToIdleSession !== void 0 ? { dispatchedToIdleSession: opts.dispatchedToIdleSession } : {}
+  };
+}
+function findNode(mesh, nodeId) {
+  const node = mesh.nodes.find((n) => (0, import_daemon_core2.meshNodeIdMatches)(n, nodeId));
+  if (!node) throw new Error(`Node '${nodeId}' is not a member of mesh '${mesh.name}'`);
+  return node;
+}
+var DUPLICATE_DISPATCH_WINDOW_MS = 6e4;
+async function refreshMeshFromDaemon(ctx) {
+  try {
+    const result = await ctx.transport.command("get_mesh", { meshId: ctx.mesh.id });
+    if (!result?.success || !Array.isArray(result.mesh?.nodes)) return;
+    const refreshedNodes = result.mesh.nodes.filter((n) => n?.id).map((n) => n);
+    ctx.mesh.nodes.splice(0, ctx.mesh.nodes.length, ...refreshedNodes);
+    ctx.mesh.updatedAt = result.mesh.updatedAt ?? ctx.mesh.updatedAt;
+  } catch {
+  }
+}
+async function syncCoordinatorDaemonMeshCache(ctx) {
+  if (!(ctx.transport instanceof IpcTransport)) return;
+  try {
+    await ctx.transport.command("get_mesh", {
+      meshId: ctx.mesh.id,
+      inlineMesh: ctx.mesh
+    });
+  } catch {
+  }
+}
+async function findNodeWithRefresh(ctx, nodeId) {
+  const hit = ctx.mesh.nodes.find((n) => (0, import_daemon_core2.meshNodeIdMatches)(n, nodeId));
+  if (hit && !hit.isLocalWorktree) return hit;
+  await refreshMeshFromDaemon(ctx);
+  const refreshed = ctx.mesh.nodes.find((n) => (0, import_daemon_core2.meshNodeIdMatches)(n, nodeId));
+  if (!refreshed) throw new Error(`Node '${nodeId}' is not a member of mesh '${ctx.mesh.name}'`);
+  return refreshed;
+}
+async function findOptionalNodeWithRefresh(ctx, nodeId) {
+  const hit = ctx.mesh.nodes.find((n) => (0, import_daemon_core2.meshNodeIdMatches)(n, nodeId));
+  if (hit && !hit.isLocalWorktree) return hit;
+  await refreshMeshFromDaemon(ctx);
+  return ctx.mesh.nodes.find((n) => (0, import_daemon_core2.meshNodeIdMatches)(n, nodeId)) ?? null;
+}
+function hasRecentDuplicateDispatch(ctx, args) {
+  const now = Date.now();
+  const normalizedMessage = args.message.trim();
+  for (const task of (0, import_daemon_core2.getQueue)(ctx.mesh.id)) {
+    const timestamp = new Date(task.updatedAt || task.createdAt).getTime();
+    if (!Number.isFinite(timestamp) || now - timestamp > DUPLICATE_DISPATCH_WINDOW_MS) continue;
+    if (task.targetNodeId && task.targetNodeId !== args.node_id) continue;
+    if (task.assignedNodeId && task.assignedNodeId !== args.node_id) continue;
+    if (args.session_id && task.targetSessionId !== args.session_id && task.assignedSessionId !== args.session_id) continue;
+    if (task.message?.trim() === normalizedMessage) {
+      return { duplicate: true, entry: task, source: "queue" };
+    }
+  }
+  const entries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
+  for (let i = entries.length - 1; i >= 0; i -= 1) {
+    const entry = entries[i];
+    const timestamp = new Date(entry.timestamp).getTime();
+    if (Number.isFinite(timestamp) && now - timestamp > DUPLICATE_DISPATCH_WINDOW_MS) break;
+    if (entry.kind !== "task_dispatched") continue;
+    if (entry.nodeId !== args.node_id) continue;
+    if (args.session_id && entry.sessionId !== args.session_id) continue;
+    if (typeof entry.payload?.message !== "string") continue;
+    if (entry.payload.message.trim() === normalizedMessage) {
+      return { duplicate: true, entry, source: "ledger" };
+    }
+  }
+  return { duplicate: false };
+}
+function buildMissingNodeReadChatRecovery(ctx, args) {
+  const entries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 300 });
+  const relatedEntries = entries.filter((entry) => entry.nodeId === args.node_id || entry.sessionId === args.session_id);
+  const completedEntries = relatedEntries.filter((entry) => entry.kind === "task_completed");
+  const lastDispatch = [...relatedEntries].reverse().find((entry) => entry.kind === "task_dispatched");
+  const lastTerminal = [...relatedEntries].reverse().find((entry) => entry.kind === "task_completed" || entry.kind === "task_failed" || entry.kind === "task_stalled");
+  const lastRemoved = [...relatedEntries].reverse().find((entry) => entry.kind === "node_removed");
+  const lastLaunch = [...relatedEntries].reverse().find((entry) => entry.kind === "session_launched");
+  const providerSessionId = args.provider_session_id || readString(lastTerminal?.payload?.providerSessionId) || readString(lastLaunch?.payload?.providerSessionId) || readString(lastDispatch?.payload?.providerSessionId);
+  const finalSummary = readString(lastTerminal?.payload?.finalSummary) || readString(lastTerminal?.payload?.compactSummary) || readString(lastTerminal?.payload?.summary);
+  const ledger = {
+    taskCompletedFound: completedEntries.length > 0,
+    nodeRemovedFound: !!lastRemoved,
+    providerType: lastTerminal?.providerType || lastLaunch?.providerType || lastDispatch?.providerType,
+    providerSessionId,
+    nodeRemovedAt: lastRemoved?.timestamp,
+    sessionCleanupMode: readString(lastRemoved?.payload?.sessionCleanupMode),
+    readDebugLocator: readString(lastTerminal?.payload?.readDebugLocator) || readString(lastTerminal?.payload?.debugBundlePath)
+  };
+  if (finalSummary) {
+    if (args.compact === true) {
+      return {
+        ...compactChatPayload({
+          success: true,
+          status: "idle",
+          providerSessionId,
+          summary: finalSummary,
+          messages: [{ role: "assistant", content: finalSummary, isHistorical: true }]
+        }, {
+          nodeId: args.node_id,
+          sessionId: args.session_id,
+          limit: args.tail ?? 10
+        }),
+        recoveredFromLedger: true,
+        ledger
+      };
+    }
+    return {
+      success: true,
+      compact: false,
+      recoveredFromLedger: true,
+      nodeId: args.node_id,
+      sessionId: args.session_id,
+      summary: finalSummary,
+      ledger,
+      messages: [{ role: "assistant", content: finalSummary, isHistorical: true }]
+    };
+  }
+  return {
+    success: false,
+    recoverable: true,
+    code: "mesh_removed_node_transcript_unavailable",
+    error: `Node '${args.node_id}' is not a current member of mesh '${ctx.mesh.name}'.`,
+    nodeId: args.node_id,
+    sessionId: args.session_id,
+    providerSessionId,
+    reason: "node_not_in_current_mesh_snapshot",
+    ledger,
+    completedSessionSeenInLedger: ledger.taskCompletedFound,
+    lastDispatch: lastDispatch ? {
+      timestamp: lastDispatch.timestamp,
+      sessionId: lastDispatch.sessionId,
+      providerType: lastDispatch.providerType,
+      taskId: typeof lastDispatch.payload?.taskId === "string" ? lastDispatch.payload.taskId : void 0,
+      messagePreview: typeof lastDispatch.payload?.message === "string" ? lastDispatch.payload.message.slice(0, 500) : void 0
+    } : null,
+    lastTerminalEvent: lastTerminal ? {
+      kind: lastTerminal.kind,
+      timestamp: lastTerminal.timestamp,
+      sessionId: lastTerminal.sessionId,
+      providerType: lastTerminal.providerType,
+      taskId: typeof lastTerminal.payload?.taskId === "string" ? lastTerminal.payload.taskId : void 0,
+      payload: lastTerminal.payload
+    } : null,
+    nextSteps: [
+      providerSessionId ? `Retry mesh_read_chat with provider_session_id='${providerSessionId}' on a current live node for the same daemon if one exists.` : "If the node UI shows a provider transcript id, retry mesh_read_chat/mesh_read_debug with provider_session_id.",
+      "Use mesh_read_debug with the provider_session_id or daemon-side debug bundle locator if available.",
+      "Check mesh_task_history for task_completed and node_removed entries before redispatching; do not resend solely because transcript recovery failed.",
+      "If this node was removed with stop_and_delete, the runtime transcript may be gone; rely on the ledger summary/locator or ask the operator for the saved UI output."
+    ],
+    recoveryHints: [
+      "The worktree/node may have been removed or the mesh snapshot may be stale after task completion.",
+      "If you have a provider_session_id, retry mesh_read_chat with that value while targeting a live node for the same daemon if available.",
+      "Use mesh_read_debug with provider_session_id, or inspect the daemon/session-host history locator if the transcript has already been archived.",
+      "Avoid redispatching the same task solely because read_chat could not recover the transcript; check task_history and git status first."
+    ]
+  };
+}
+function isDirectDispatchLedgerEntry(entry) {
+  if (entry?.kind !== "task_dispatched") return false;
+  const payload = entry.payload || {};
+  const via = readString(payload.via);
+  return payload.source === "direct" || via === "p2p_direct" || via === "local_direct" || via === "mesh_send_task";
+}
+function readMessageTimestampIso(message) {
+  for (const value of [message?.timestamp, message?.createdAt, message?.created_at, message?.updatedAt, message?.time]) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+      const ms = value > 1e10 ? value : value * 1e3;
+      return new Date(ms).toISOString();
+    }
+    if (typeof value === "string" && value.trim()) {
+      const ms = new Date(value.trim()).getTime();
+      if (Number.isFinite(ms)) return new Date(ms).toISOString();
+    }
+  }
+  return void 0;
+}
+function readFinalAssistantTranscriptEvidence(payload) {
+  const rawMessages = Array.isArray(payload?.messages) ? payload.messages : [];
+  const finalAssistant = [...rawMessages].reverse().filter(isCoordinatorVisibleMessage).find((message) => {
+    const role = String(message?.role ?? "").toLowerCase();
+    return (role === "assistant" || role === "agent") && messageContent(message).trim();
+  });
+  const finalSummary = messageContent(finalAssistant).trim() || (typeof payload?.summary === "string" && payload.summary.trim() ? payload.summary.trim() : void 0);
+  return {
+    finalSummary,
+    transcriptMessageAt: finalAssistant ? readMessageTimestampIso(finalAssistant) : void 0
+  };
+}
+function findNodeSession(nodes, nodeId, sessionId) {
+  if (!nodeId || !sessionId) return {};
+  const node = nodes.find((candidate) => (0, import_daemon_core2.meshNodeIdMatches)(candidate, nodeId));
+  if (!node) return {};
+  const sessions = Array.isArray(node.sessions) ? node.sessions : [];
+  const session = sessions.find((candidate) => readSessionRecordId(candidate) === sessionId);
+  return { node, session };
+}
+function buildDirectDispatchReconciliationCandidates(directDispatches, ledgerEntries) {
+  const candidates = [];
+  const seenTaskIds = /* @__PURE__ */ new Set();
+  for (const dispatch of directDispatches || []) {
+    const taskId = readString(dispatch?.taskId);
+    if (!taskId || seenTaskIds.has(taskId)) continue;
+    seenTaskIds.add(taskId);
+    candidates.push(dispatch);
+  }
+  for (const entry of ledgerEntries || []) {
+    if (!isDirectDispatchLedgerEntry(entry)) continue;
+    const taskId = readString(entry.payload?.taskId);
+    if (!taskId || seenTaskIds.has(taskId)) continue;
+    seenTaskIds.add(taskId);
+    candidates.push({
+      taskId,
+      nodeId: entry.nodeId,
+      sessionId: entry.sessionId,
+      providerType: entry.providerType || readString(entry.payload?.providerType),
+      message: readString(entry.payload?.message),
+      dispatchedAt: entry.timestamp,
+      via: readString(entry.payload?.via)
+    });
+  }
+  return candidates;
+}
+async function reconcileDirectDispatchesFromTranscriptEvidence(ctx, liveNodes, directDispatches, ledgerEntries) {
+  let attempted = 0;
+  let reconciled = 0;
+  let skipped = 0;
+  const candidates = buildDirectDispatchReconciliationCandidates(directDispatches, ledgerEntries);
+  for (const dispatch of candidates) {
+    const taskId = readString(dispatch?.taskId);
+    const nodeId = readString(dispatch?.nodeId);
+    const sessionId = readString(dispatch?.sessionId);
+    if (!taskId || !nodeId || !sessionId) {
+      skipped += 1;
+      continue;
+    }
+    const { session } = findNodeSession(liveNodes, nodeId, sessionId);
+    if (!session || !isIdleSessionRecord(session)) {
+      skipped += 1;
+      continue;
+    }
+    const node = await findOptionalNodeWithRefresh(ctx, nodeId).catch(() => null);
+    if (!node) {
+      skipped += 1;
+      continue;
+    }
+    const providerType = readString(dispatch?.providerType) || resolveSessionProviderType(session);
+    const providerSessionId = readString(session?.providerSessionId) || readString(session?.activeChat?.providerSessionId) || readString(session?.settings?.providerSessionId) || resolveMeshSessionProviderMetadata(ctx, nodeId, sessionId)?.providerSessionId;
+    attempted += 1;
+    try {
+      const readResult = await commandForNode(ctx, node, "read_chat", {
+        sessionId,
+        targetSessionId: sessionId,
+        workspace: node.workspace,
+        ...providerType ? { agentType: providerType, providerType } : {},
+        ...providerSessionId ? { providerSessionId } : {},
+        tailLimit: 10
+      });
+      const payload = unwrapCommandPayload(readResult);
+      if (payload?.success === false) continue;
+      const evidence = readFinalAssistantTranscriptEvidence(payload);
+      if (!evidence.finalSummary) continue;
+      const result = (0, import_daemon_core2.reconcileDirectDispatchCompletionFromTranscript)({
+        meshId: ctx.mesh.id,
+        nodeId,
+        sessionId,
+        providerType,
+        providerSessionId: readString(payload?.providerSessionId) || providerSessionId,
+        taskId,
+        finalSummary: evidence.finalSummary,
+        transcriptMessageAt: evidence.transcriptMessageAt,
+        targetCoordinatorDaemonId: ctx.localDaemonId,
+        source: "mcp_mesh_status_transcript_reconciliation"
+      });
+      if (result.reconciled) reconciled += 1;
+    } catch {
+      skipped += 1;
+    }
+  }
+  return { attempted, reconciled, skipped };
+}
+async function triggerMeshQueueAndReport(ctx) {
+  try {
+    const raw = await ctx.transport.command("trigger_mesh_queue", { meshId: ctx.mesh.id });
+    const payload = unwrapCommandPayload(raw);
+    const trigger = payload?.trigger && typeof payload.trigger === "object" ? payload.trigger : payload;
+    return trigger && typeof trigger === "object" ? trigger : { success: true };
+  } catch (e) {
+    return {
+      success: false,
+      error: e?.message || String(e)
+    };
+  }
+}
+function buildQueueTriggerGuidance(queueTrigger) {
+  if (!queueTrigger || queueTrigger.claimed === true) return void 0;
+  if (queueTrigger.success === false) {
+    return {
+      queueClaimed: false,
+      queueDispatchState: "trigger_failed",
+      nextAction: "Do not assume the queued task is running. Check mesh_view_queue and daemon connectivity before redispatching."
+    };
+  }
+  if (queueTrigger.autoLaunchPending === true) {
+    return {
+      queueClaimed: false,
+      queueDispatchState: "pending_waiting_for_autolaunch",
+      nextAction: "A worker session was just auto-launched for this task and is booting; it will claim the task shortly. Wait for it to claim \u2014 do NOT launch another session. Use mesh_view_queue to confirm the assignment lands."
+    };
+  }
+  if (queueTrigger.noIdleMeshSessionAvailable === true) {
+    return {
+      queueClaimed: false,
+      queueDispatchState: "pending_no_idle_mesh_session",
+      nextAction: "The task is queued but not running. Launch a managed worker with mesh_launch_session, or wait for a delegated session to become ready and trigger the queue again."
+    };
+  }
+  return {
+    queueClaimed: false,
+    queueDispatchState: "pending_or_waiting_for_ready",
+    nextAction: "The task is queued but this trigger did not claim it. Use mesh_view_queue for the current active-work source of truth before retrying."
+  };
+}
+function isMeshOwnedDelegateSession(session, meshId, nodeId) {
+  const settings = session?.settings;
+  const sessionMeshId = typeof settings?.meshNodeFor === "string" ? settings.meshNodeFor.trim() : "";
+  const sessionNodeId = typeof settings?.meshNodeId === "string" ? settings.meshNodeId.trim() : "";
+  if (sessionMeshId) {
+    if (sessionMeshId !== meshId) return false;
+    return !sessionNodeId || sessionNodeId === nodeId;
+  }
+  const coordinatorOwned = settings?.launchedByCoordinator === true || Boolean(readString(settings?.meshCoordinatorDaemonId));
+  if (!coordinatorOwned) return false;
+  const lastNodeId = readString(settings?.meshLastNodeId);
+  if (lastNodeId) return lastNodeId === nodeId;
+  return true;
+}
+function hasRemoteRelayMetadata(session) {
+  return Boolean(
+    readString(session?.settings?.meshCoordinatorDaemonId) || readString(session?.meta?.meshCoordinatorDaemonId) || readString(session?.metadata?.meshCoordinatorDaemonId) || readString(session?.meshCoordinatorDaemonId)
+  );
+}
+function classifyRemoteDelegateRelaySafety(session, meshId, nodeId, coordinatorDaemonId) {
+  if (!isMeshOwnedDelegateSession(session, meshId, nodeId)) return "unsafe_alias";
+  if (hasRemoteRelayMetadata(session)) return "safe";
+  return coordinatorDaemonId ? "self_heal" : "missing_anchor";
+}
+function chooseDispatchableSession(sessions, providerType, meshId, nodeId, coordinatorDaemonId) {
+  const live = sessions.filter((session) => !isTerminalSessionRecord(session));
+  const matchingProvider = (session) => !providerType || session?.providerType === providerType || session?.cliType === providerType;
+  const meshSessions = live.filter((session) => {
+    const safety = classifyRemoteDelegateRelaySafety(session, meshId, nodeId, coordinatorDaemonId);
+    return safety === "safe" || safety === "self_heal";
+  });
+  return meshSessions.find((session) => isIdleSessionRecord(session) && matchingProvider(session)) || void 0;
+}
+function buildRelayUnsafeRemoteSessionFailure(ctx, node, sessionId, providerType) {
+  return {
+    success: false,
+    recoverable: true,
+    code: "mesh_delegate_session_missing_relay_metadata",
+    reason: "mesh_delegate_session_missing_relay_metadata",
+    transport: "mesh_transport",
+    retryRecommended: true,
+    meshId: ctx.mesh.id,
+    nodeId: node.id,
+    daemonId: node.daemonId,
+    workspace: node.workspace,
+    sessionId,
+    unsafeTranscriptAlias: true,
+    ...providerType ? { resolvedProviderType: providerType } : {},
+    error: `Remote session '${sessionId}' is not relay-safe for mesh '${ctx.mesh.id}': missing meshNodeFor/meshCoordinatorDaemonId metadata, so completion events would not reach the coordinator ledger. This session may be the coordinator itself or an unrelated session (unsafe_transcript_alias risk).`,
+    nextAction: `Launch a fresh relay-safe session with mesh_launch_session(node_id: '${node.id}'${providerType ? `, type: '${providerType}'` : ""}) or dispatch without session_id so Repo Mesh can choose a valid delegate session.`,
+    noFallbackReason: "Blindly reusing a remote session without mesh relay metadata would silently drop task_completed / generating_completed events."
+  };
+}
+function buildMissingCoordinatorDaemonIdFailure(ctx, node, providerType) {
+  return {
+    success: false,
+    recoverable: true,
+    code: "mesh_coordinator_daemon_unknown",
+    reason: "mesh_coordinator_daemon_unknown",
+    transport: "mesh_transport",
+    retryRecommended: true,
+    meshId: ctx.mesh.id,
+    nodeId: node.id,
+    daemonId: node.daemonId,
+    workspace: node.workspace,
+    ...providerType ? { resolvedProviderType: providerType } : {},
+    error: `Cannot launch a remote mesh delegate for node '${node.id}': coordinator daemon identity is unavailable, so the worker would be unable to relay completion events back to the coordinator.`,
+    nextAction: "Retry after the coordinator daemon identity is available (for example from an attached daemon-backed MCP session) so meshCoordinatorDaemonId can be stamped on the worker session.",
+    noFallbackReason: "Launching without meshCoordinatorDaemonId would create a worker session that can finish work but cannot emit task_completed / generating_completed back to the coordinator."
+  };
+}
+function findNestedPayload(value, predicate) {
+  const seen = /* @__PURE__ */ new Set();
+  const stack = [{ payload: value, depth: 0 }];
+  while (stack.length) {
+    const { payload, depth } = stack.pop();
+    if (predicate(payload)) return payload;
+    if (!payload || typeof payload !== "object" || seen.has(payload) || depth >= 8) continue;
+    seen.add(payload);
+    for (const key of ["payload", "result"]) {
+      if (key in payload) stack.push({ payload: payload[key], depth: depth + 1 });
+    }
+  }
+  return value;
+}
+function extractCloneNodePayload(value) {
+  return findNestedPayload(value, (payload) => Boolean(payload?.node?.id));
+}
+function extractGitStatus(value) {
+  const payload = unwrapCommandPayload(value);
+  return payload?.status ?? value?.status ?? payload;
+}
+function extractGitDiff(value) {
+  const payload = unwrapCommandPayload(value);
+  return payload?.diffSummary ?? payload?.diff ?? value?.diffSummary ?? value?.diff ?? payload;
+}
+function extractSubmodules(value, ignorePaths) {
+  const payload = unwrapCommandPayload(value);
+  const subs = payload?.status?.submodules ?? payload?.submodules ?? value?.status?.submodules ?? value?.submodules;
+  if (!Array.isArray(subs)) return void 0;
+  if (ignorePaths.length === 0) return subs;
+  const ignoreSet = new Set(ignorePaths);
+  return subs.filter((s) => s?.path && !ignoreSet.has(s.path));
+}
+function assignFullGitSnapshot(entry, status) {
+  if (!status || typeof status !== "object" || Array.isArray(status)) return;
+  entry.git = status;
+}
+var COMPACT_DETAILED_NODES_BYTE_BUDGET = 9e3;
+var COMPACT_NODES_TOTAL_BYTE_BUDGET = 13e3;
+var COMPACT_MISSIONS_BYTE_BUDGET = 6e3;
+function extractLaunchPayload(value) {
+  return findNestedPayload(value, (payload) => Boolean(payload?.sessionId || payload?.id || payload?.runtimeSessionId));
+}
+function classifyMeshLaunchFailure(error) {
+  const message = error instanceof Error ? error.message : String(error || "launch failed");
+  const lower = message.toLowerCase();
+  const p2pClassification = (0, import_daemon_core2.classifyP2pRelayFailure)(error, { command: "launch_cli" });
+  if (p2pClassification.recoverable) {
+    return p2pClassification;
+  }
+  if (lower.includes("cannot connect to daemon ipc") || lower.includes("daemon ipc command")) {
+    return {
+      code: "local_ipc_unavailable",
+      reason: "local_daemon_ipc_unavailable",
+      transport: "local_ipc",
+      recoverable: true,
+      retryRecommended: true,
+      nextAction: "Check the local daemon IPC connection, then retry mesh_launch_session once after the daemon is reachable."
+    };
+  }
+  if (lower.includes("timed out") || lower.includes("timeout")) {
+    return {
+      code: "mesh_transport_timeout",
+      reason: "mesh_transport_timeout",
+      transport: "mesh_transport",
+      recoverable: true,
+      retryRecommended: true,
+      nextAction: "Check mesh transport health, then do one bounded retry before requeueing or relaunching the task."
+    };
+  }
+  return {
+    code: "mesh_launch_failed",
+    reason: "provider_launch_failed",
+    transport: "mesh_transport",
+    recoverable: false,
+    retryRecommended: false,
+    nextAction: "Inspect the provider launch error and fix the underlying provider/configuration issue before retrying."
+  };
+}
+function buildWorktreeCleanupHint(node) {
+  if (!node.isLocalWorktree) return void 0;
+  return {
+    tool: "mesh_remove_node",
+    args: { node_id: node.id, session_cleanup_mode: "preserve" },
+    hint: `If the worktree is no longer needed, remove the orphan worktree node with mesh_remove_node(node_id: "${node.id}").`
+  };
+}
+function buildRecoverableLaunchFailure(ctx, node, providerType, error) {
+  const message = error instanceof Error ? error.message : String(error || "launch failed");
+  const classified = classifyMeshLaunchFailure(error);
+  const cleanup = buildWorktreeCleanupHint(node);
+  return {
+    success: false,
+    recoverable: classified.recoverable,
+    code: classified.code,
+    reason: classified.reason,
+    transport: classified.transport,
+    retryRecommended: classified.retryRecommended,
+    nextAction: classified.nextAction,
+    ...classified.noFallbackReason ? { noFallbackReason: classified.noFallbackReason } : {},
+    error: message,
+    meshId: ctx.mesh.id,
+    nodeId: node.id,
+    daemonId: node.daemonId,
+    workspace: node.workspace,
+    isLocalWorktree: node.isLocalWorktree === true,
+    worktreeBranch: node.worktreeBranch,
+    clonedFromNodeId: node.clonedFromNodeId,
+    ...providerType ? { resolvedProviderType: providerType } : {},
+    retryHint: `Retry mesh_launch_session(node_id: "${node.id}"${providerType ? `, type: "${providerType}"` : ""}) after daemon mesh transport/P2P is healthy.`,
+    ...cleanup ? { cleanup } : {},
+    nextStepHints: [
+      `Retry mesh_launch_session(node_id: "${node.id}"${providerType ? `, type: "${providerType}"` : ""}) after checking daemon/P2P health.`,
+      ...cleanup ? [`Cleanup orphan worktree node with mesh_remove_node(node_id: "${node.id}") if retry is not desired.`] : [],
+      "Run mesh_status to see the degraded reason and recovery hints before redispatching work."
+    ]
+  };
+}
+function recordRecoverableLaunchFailure(ctx, node, providerType, error) {
+  const failure = buildRecoverableLaunchFailure(ctx, node, providerType, error);
+  try {
+    (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
+      kind: "recovery_attempted",
+      nodeId: node.id,
+      providerType,
+      payload: {
+        event: "session_launch_failed",
+        ...failure
+      }
+    });
+  } catch {
+  }
+  return failure;
+}
+function getLatestActiveLaunchFailure(meshId, nodeId) {
+  const entries = (0, import_daemon_core2.readLedgerEntries)(meshId, { tail: 200 });
+  for (let i = entries.length - 1; i >= 0; i -= 1) {
+    const entry = entries[i];
+    if (entry.nodeId !== nodeId) continue;
+    if (entry.kind === "session_launched" || entry.kind === "node_removed") return null;
+    if (entry.kind === "recovery_attempted" && entry.payload?.event === "session_launch_failed") {
+      return { timestamp: entry.timestamp, ...entry.payload };
+    }
+  }
+  return null;
+}
+function buildCoordinatorP2pRelayFailure(error, context) {
+  const payload = (0, import_daemon_core2.buildP2pRelayFailurePayload)(error, {
+    command: context.command,
+    targetDaemonId: context.targetDaemonId
+  });
+  return {
+    ...payload,
+    ...context.nodeId ? { nodeId: context.nodeId } : {},
+    ...context.sessionId ? { sessionId: context.sessionId } : {},
+    retryHint: payload.retryRecommended ? payload.nextAction : "Do not retry as a P2P transport recovery; inspect the command/provider error first."
+  };
+}
+async function ipcDispatchToRemoteAgent(ctx, node, args) {
+  const transport = ctx.transport;
+  const daemonId = node.daemonId;
+  const dispatchCoordinatorDaemonId = readString(args.meshContext?.coordinatorDaemonId) || "";
+  let sessionId = args.session_id?.trim() || "";
+  const providerPriorityList = Array.isArray(node.policy?.providerPriority) ? node.policy.providerPriority : [];
+  let resolvedProviderType = args.providerType?.trim() || providerPriorityList[0] || "";
+  if (sessionId && args.verifiedSession) {
+    const explicitSession = args.verifiedSession;
+    const relaySafety = classifyRemoteDelegateRelaySafety(explicitSession, ctx.mesh.id, node.id, dispatchCoordinatorDaemonId);
+    if (relaySafety === "unsafe_alias") {
+      return buildRelayUnsafeRemoteSessionFailure(
+        ctx,
+        node,
+        sessionId,
+        resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
+      );
+    }
+    if (relaySafety === "missing_anchor") {
+      return buildMissingCoordinatorDaemonIdFailure(
+        ctx,
+        node,
+        resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
+      );
+    }
+    if (!resolvedProviderType) {
+      resolvedProviderType = resolveSessionProviderType(explicitSession);
+    }
+  } else if (!sessionId || args.session_id) {
+    try {
+      const relayResult = await transport.meshCommand(daemonId, "get_status_metadata", {});
+      const sessions = extractStatusMetadataSessions(relayResult);
+      if (sessionId) {
+        const explicitSession = sessions.find((session) => readSessionRecordId(session) === sessionId);
+        if (!explicitSession) {
+          return {
+            success: false,
+            recoverable: true,
+            code: "mesh_target_session_not_found",
+            reason: "mesh_target_session_not_found",
+            transport: "mesh_transport",
+            retryRecommended: true,
+            meshId: ctx.mesh.id,
+            nodeId: node.id,
+            daemonId,
+            workspace: node.workspace,
+            sessionId,
+            ...resolvedProviderType ? { resolvedProviderType } : {},
+            error: `Remote session '${sessionId}' is not present in the live status for node '${node.id}'.`,
+            nextAction: `Launch a fresh session with mesh_launch_session(node_id: '${node.id}'${resolvedProviderType ? `, type: '${resolvedProviderType}'` : ""}) or retry without session_id so Repo Mesh can target a live delegate session.`
+          };
+        }
+        const relaySafety = classifyRemoteDelegateRelaySafety(explicitSession, ctx.mesh.id, node.id, dispatchCoordinatorDaemonId);
+        if (relaySafety === "unsafe_alias") {
+          return buildRelayUnsafeRemoteSessionFailure(
+            ctx,
+            node,
+            sessionId,
+            resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
+          );
+        }
+        if (relaySafety === "missing_anchor") {
+          return buildMissingCoordinatorDaemonIdFailure(
+            ctx,
+            node,
+            resolvedProviderType || resolveSessionProviderType(explicitSession) || void 0
+          );
+        }
+        if (!resolvedProviderType) {
+          resolvedProviderType = resolveSessionProviderType(explicitSession);
+        }
+      } else {
+        const targetSession = chooseDispatchableSession(sessions, resolvedProviderType, ctx.mesh.id, node.id, dispatchCoordinatorDaemonId);
+        if (targetSession?.id || targetSession?.sessionId) {
+          sessionId = targetSession.id || targetSession.sessionId;
+          if (!resolvedProviderType) {
+            resolvedProviderType = resolveSessionProviderType(targetSession);
+          }
+        }
+      }
+    } catch (e) {
+      if (sessionId) {
+        return {
+          ...buildCoordinatorP2pRelayFailure(e, {
+            command: "get_status_metadata",
+            targetDaemonId: daemonId,
+            nodeId: node.id,
+            sessionId
+          }),
+          success: false,
+          error: `Cannot verify remote session '${sessionId}' before dispatch: ${e?.message || String(e)}`
+        };
+      }
+    }
+  }
+  if (!resolvedProviderType) {
+    return { success: false, error: `Cannot dispatch to remote node '${node.id}': providerType unknown. Set providerPriority on the node policy or call mesh_launch_session first.` };
+  }
+  try {
+    const dispatchResult = await transport.meshCommand(daemonId, "agent_command", {
+      ...sessionId ? { targetSessionId: sessionId } : {},
+      agentType: resolvedProviderType,
+      cliType: resolvedProviderType,
+      action: "send_chat",
+      message: args.message,
+      // WTCLAIM (B): carry the node workspace so a sessionless dispatch can be
+      // scoped to THIS node's session on the worker (findAdapter dir match /
+      // findMeshNodeAdapter). Without it, a worker hosting both a base node and a
+      // cloned worktree node (same daemonId) would fall through to a provider-only
+      // fuzzy match and could land worktree work on the base session.
+      ...node.workspace ? { dir: node.workspace } : {},
+      ...args.meshContext ? { meshContext: args.meshContext } : {}
+    });
+    const dispatchPayload = unwrapCommandPayload(dispatchResult);
+    if (dispatchPayload?.success === false || dispatchResult?.success === false) {
+      const source = dispatchPayload?.success === false ? dispatchPayload : dispatchResult;
+      const errorMessage = dispatchPayload?.error || dispatchResult?.error || "agent_command rejected the task";
+      return {
+        ...buildCoordinatorP2pRelayFailure(source?.error || errorMessage, {
+          command: "agent_command",
+          targetDaemonId: daemonId,
+          nodeId: node.id,
+          sessionId
+        }),
+        ...source && typeof source === "object" ? source : {},
+        success: false,
+        error: `P2P dispatch failed: ${errorMessage}`
+      };
+    }
+    return { success: true, dispatched: true, sessionId: sessionId || "", providerType: resolvedProviderType };
+  } catch (e) {
+    const errorMessage = e?.message || String(e);
+    return {
+      ...buildCoordinatorP2pRelayFailure(e, {
+        command: "agent_command",
+        targetDaemonId: daemonId,
+        nodeId: node.id,
+        sessionId
+      }),
+      error: `P2P dispatch failed: ${errorMessage}`
+    };
+  }
+}
+function meshSessionCacheKey(nodeId, runtimeSessionId) {
+  return `${nodeId}:${runtimeSessionId}`;
+}
+function rememberMeshSessionProviderMetadata(nodeId, runtimeSessionId, metadata) {
+  const keyNodeId = readString(nodeId);
+  const keySessionId = readString(runtimeSessionId);
+  if (!keyNodeId || !keySessionId) return;
+  const providerType = readString(metadata.providerType);
+  const providerSessionId = readString(metadata.providerSessionId);
+  if (!providerType && !providerSessionId) return;
+  const existing = getSessionMetadata(meshSessionCacheKey(keyNodeId, keySessionId)) || { providerType: "" };
+  meshSessionProviderMetadata.set(meshSessionCacheKey(keyNodeId, keySessionId), {
+    providerType: providerType || existing.providerType,
+    providerSessionId: providerSessionId || existing.providerSessionId,
+    expiresAt: Date.now() + SESSION_PROVIDER_METADATA_TTL_MS
+  });
+}
+function rememberMeshSessionProviderMetadataFromEvent(event) {
+  const metadataEvent = event?.metadataEvent && typeof event.metadataEvent === "object" ? event.metadataEvent : event && typeof event === "object" ? event : {};
+  const nodeId = readString(event?.nodeId) || readString(metadataEvent.nodeId) || readString(metadataEvent.meshNodeId);
+  const sessionId = readString(metadataEvent.targetSessionId) || readString(metadataEvent.sessionId) || readString(metadataEvent.instanceId) || readString(event?.sessionId);
+  rememberMeshSessionProviderMetadata(nodeId, sessionId, {
+    providerType: readString(metadataEvent.providerType) || readString(event?.providerType) || "",
+    providerSessionId: readString(metadataEvent.providerSessionId) || readString(event?.providerSessionId)
+  });
+}
+function resolveMeshSessionProviderMetadataFromLedger(ctx, nodeId, runtimeSessionId) {
+  const entries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 50 });
+  for (let i = entries.length - 1; i >= 0; i -= 1) {
+    const entry = entries[i];
+    const payload = entry.payload && typeof entry.payload === "object" && !Array.isArray(entry.payload) ? entry.payload : {};
+    const entryNodeId = readString(entry.nodeId) || readString(payload.nodeId) || readString(payload.meshNodeId);
+    if (entryNodeId && entryNodeId !== nodeId) continue;
+    const entrySessionId = readString(entry.sessionId) || readString(payload.targetSessionId) || readString(payload.sessionId) || readString(payload.instanceId);
+    if (entrySessionId !== runtimeSessionId) continue;
+    const providerType = readString(entry.providerType) || readString(payload.providerType);
+    const completionDiagnostic = payload.completionDiagnostic && typeof payload.completionDiagnostic === "object" && !Array.isArray(payload.completionDiagnostic) ? payload.completionDiagnostic : {};
+    const metadataEvent = payload.metadataEvent && typeof payload.metadataEvent === "object" && !Array.isArray(payload.metadataEvent) ? payload.metadataEvent : {};
+    const providerSessionId = readString(payload.providerSessionId) || readString(completionDiagnostic.providerSessionId) || readString(metadataEvent.providerSessionId);
+    if (providerType || providerSessionId) {
+      return { providerType: providerType || "", providerSessionId };
+    }
+  }
+  return void 0;
+}
+function resolveMeshSessionProviderMetadata(ctx, nodeId, runtimeSessionId) {
+  const cached = getSessionMetadata(meshSessionCacheKey(nodeId, runtimeSessionId));
+  if (cached?.providerType || cached?.providerSessionId) return cached;
+  const fromLedger = resolveMeshSessionProviderMetadataFromLedger(ctx, nodeId, runtimeSessionId);
+  if (fromLedger) rememberMeshSessionProviderMetadata(nodeId, runtimeSessionId, fromLedger);
+  return fromLedger;
+}
+function countUncommittedChanges(status) {
+  if (typeof status?.uncommittedChanges === "number") return status.uncommittedChanges;
+  const keys = ["staged", "modified", "untracked", "deleted", "renamed"];
+  const counted = keys.reduce((sum, key) => sum + (Number.isFinite(Number(status?.[key])) ? Number(status[key]) : 0), 0);
+  const conflicts = Array.isArray(status?.conflictFiles) ? status.conflictFiles.length : status?.hasConflicts ? 1 : 0;
+  return counted + conflicts;
+}
+function isGitStatusDirty(status) {
+  if (typeof status?.isDirty === "boolean") return status.isDirty;
+  if (typeof status?.dirty === "boolean") return status.dirty;
+  if (Array.isArray(status?.submodules) && status.submodules.some((submodule) => submodule?.dirty || submodule?.outOfSync || submodule?.error)) return true;
+  return countUncommittedChanges(status) > 0;
+}
+function slimLedgerPayload(payload) {
+  const slim = {};
+  for (const [k, v] of Object.entries(payload)) {
+    if (k === "message" || k === "taskSummary") {
+      slim[k] = typeof v === "string" && v.length > 200 ? v.slice(0, 200) + "\u2026" : v;
+    } else if (k === "evidence" || k === "workerResult" || k === "gitStatus" || k === "validationResults") {
+    } else if (k === "finalSummary") {
+      slim[k] = typeof v === "string" && v.length > 300 ? v.slice(0, 300) + "\u2026" : v;
+    } else if (LARGE_LEDGER_FIELD_KEYS.has(k)) {
+      slim[k] = summarizeLargeLedgerField(k, v);
+    } else {
+      slim[k] = elideLargeNestedValue(k, v);
+    }
+  }
+  return slim;
+}
+function readRelatedRepos(node) {
+  const raw = Array.isArray(node.relatedRepos) ? node.relatedRepos : Array.isArray(node.policy?.relatedRepos) ? node.policy.relatedRepos : [];
+  return raw.map((entry) => ({
+    label: typeof entry?.label === "string" ? entry.label.trim() : "",
+    workspace: typeof entry?.workspace === "string" ? entry.workspace.trim() : ""
+  })).filter((entry) => Boolean(entry.label && entry.workspace));
+}
+function summarizeRelatedRepoStatus(repo, status) {
+  const dirty = isGitStatusDirty(status);
+  return {
+    label: repo.label,
+    workspace: repo.workspace,
+    isGitRepo: status?.isGitRepo === true,
+    branch: status?.branch ?? null,
+    upstream: status?.upstream ?? null,
+    upstreamStatus: typeof status?.upstreamStatus === "string" ? status.upstreamStatus : status?.upstream ? "unchecked" : "no_upstream",
+    upstreamFetchedAt: Number.isFinite(Number(status?.upstreamFetchedAt)) ? Number(status.upstreamFetchedAt) : null,
+    upstreamFetchError: typeof status?.upstreamFetchError === "string" ? status.upstreamFetchError : null,
+    ahead: Number.isFinite(Number(status?.ahead)) ? Number(status.ahead) : 0,
+    behind: Number.isFinite(Number(status?.behind)) ? Number(status.behind) : 0,
+    dirty,
+    uncommittedChanges: countUncommittedChanges(status),
+    head: status?.headCommit ?? null,
+    lastCommitSummary: status?.headMessage ?? null,
+    ...status?.reason ? { reason: status.reason } : {},
+    ...status?.error ? { error: status.error } : {}
+  };
+}
+async function collectRelatedRepoStatuses(ctx, node) {
+  const relatedRepos = readRelatedRepos(node);
+  if (!relatedRepos.length) return [];
+  const results = [];
+  for (const repo of relatedRepos) {
+    try {
+      const statusResult = await commandForNode(ctx, node, "git_status", { workspace: repo.workspace, refreshUpstream: true });
+      const status = extractGitStatus(statusResult);
+      results.push(summarizeRelatedRepoStatus(repo, status));
+    } catch (e) {
+      results.push({
+        label: repo.label,
+        workspace: repo.workspace,
+        error: e?.message || "related repo status failed"
+      });
+    }
+  }
+  return results;
+}
+function readProviderPriority(policy) {
+  const raw = policy?.providerPriority;
+  return Array.isArray(raw) ? raw.map((type) => typeof type === "string" ? type.trim() : "").filter(Boolean) : [];
+}
+function buildNodeCapabilityExposure(node) {
+  const providers = readProviderPriority(node.policy);
+  const capabilityTags = (0, import_daemon_core2.buildMeshNodeCapabilityTags)(node);
+  const exposure = { capabilityTags };
+  if (providers.length) {
+    const byProvider = {};
+    for (const provider of providers) {
+      byProvider[provider] = (0, import_daemon_core2.buildMeshNodeCapabilityTags)(node, provider);
+    }
+    exposure.capabilityTagsByProvider = byProvider;
+  }
+  const capabilities = Array.isArray(node.capabilities) ? node.capabilities.filter((tag) => typeof tag === "string" && !!tag.trim()) : [];
+  if (capabilities.length) exposure.capabilities = capabilities;
+  return exposure;
+}
+function readSpawnedSessionVisibility(policy) {
+  return policy?.spawnedSessionVisibility === "hidden" ? "hidden" : "visible";
+}
+function missingProviderPriorityMessage(nodeId) {
+  return `Node '${nodeId}' has no providerPriority policy; pass type explicitly or configure node.policy.providerPriority`;
+}
+function getNodeLaunchReadiness(node) {
+  const bootstrap = node.worktreeBootstrap;
+  if (node.isLocalWorktree && bootstrap?.status === "failed" && bootstrap?.required !== false) {
+    return {
+      providerPriority: readProviderPriority(node.policy),
+      launchReady: false,
+      launchBlockedReason: "worktree_bootstrap_failed",
+      launchBlockedMessage: typeof bootstrap.error === "string" && bootstrap.error.trim() ? bootstrap.error.trim() : "Required worktree bootstrap failed; resolve it before launching an agent into this node.",
+      worktreeBootstrap: bootstrap
+    };
+  }
+  const providerPriority = readProviderPriority(node.policy);
+  if (providerPriority.length) {
+    return {
+      providerPriority,
+      launchReady: true
+    };
+  }
+  return {
+    providerPriority,
+    launchReady: false,
+    launchBlockedReason: "missing_provider_priority",
+    launchBlockedMessage: missingProviderPriorityMessage(node.id)
+  };
+}
+function getWorktreeBootstrapLaunchBlock(node, meshPolicy) {
+  if (!node.isLocalWorktree) return void 0;
+  const bootstrap = node.worktreeBootstrap;
+  const requireReady = !!(meshPolicy && typeof meshPolicy === "object" && meshPolicy.requireBootstrapBeforeLaunch === true);
+  if (requireReady && bootstrap?.status !== "ready") {
+    return {
+      success: false,
+      code: "bootstrap_not_ready",
+      error: `Node '${node.id}' bootstrap state is '${bootstrap?.status ?? "unknown"}' and mesh policy requireBootstrapBeforeLaunch is enabled.`,
+      nodeId: node.id,
+      worktreeBootstrap: bootstrap ?? null,
+      recoveryHint: "Run the worktree bootstrap (clone runOnClone or a refine with bootstrap inherit) until the node reports ready, or disable requireBootstrapBeforeLaunch."
+    };
+  }
+  if (bootstrap?.status !== "failed" || bootstrap?.required === false) return void 0;
+  return {
+    success: false,
+    code: "worktree_bootstrap_failed",
+    error: typeof bootstrap.error === "string" && bootstrap.error.trim() ? bootstrap.error.trim() : `Node '${node.id}' has a failed required worktree bootstrap.`,
+    nodeId: node.id,
+    worktreeBootstrap: bootstrap,
+    recoveryHint: "Fix the configured worktree bootstrap command or remove/recreate the worktree node before launching an agent."
+  };
+}
+async function collectLiveStatusSessions(ctx, node) {
+  try {
+    const statusResult = await commandForNode(ctx, node, "get_status_metadata", {});
+    return extractStatusMetadataSessions(statusResult);
+  } catch {
+    return [];
   }
-};
-var MESH_CLONE_NODE_TOOL = {
-  name: "mesh_clone_node",
-  description: "Create a new worktree-based node from an existing node for isolated parallel work. Creates a git worktree on a new branch so multiple tasks can run on separate branches simultaneously.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      source_node_id: { type: "string", description: "Node ID to clone from (from mesh_list_nodes)." },
-      branch: { type: "string", description: 'Branch name for the new worktree (e.g. "feat/auth-refactor").' },
-      base_branch: { type: "string", description: "Starting point for the branch (default: current HEAD)." }
-    },
-    required: ["source_node_id", "branch"]
+}
+async function collectLiveStatusProbe(ctx, node) {
+  try {
+    const statusResult = await commandForNode(ctx, node, "get_status_metadata", {});
+    return {
+      sessions: extractStatusMetadataSessions(statusResult),
+      daemonBuild: extractDaemonBuildInfo(statusResult)
+    };
+  } catch {
+    return { sessions: [] };
   }
-};
-var MESH_REMOVE_NODE_TOOL = {
-  name: "mesh_remove_node",
-  description: "Remove a node from the mesh. If the node is a worktree, also cleans up the git worktree and directory. Session cleanup is controlled by mesh policy sessionCleanupOnNodeRemove unless session_cleanup_mode overrides it for this call. The coordinator's own local base node (same machine, NOT a worktree) is protected \u2014 removing it breaks live mesh membership and is rejected unless force:true is passed.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Node ID to remove." },
-      session_cleanup_mode: {
-        type: "string",
-        enum: ["preserve", "stop", "delete_stopped", "stop_and_delete"],
-        description: "Optional override for cleanup of delegated sessions attached to this node. preserve keeps history/processes; stop stops live runtimes only; delete_stopped removes completed transcripts only; stop_and_delete stops live runtimes and deletes records."
-      },
-      force: { type: "boolean", description: "Override the coordinator-base-node guard. Only set true to intentionally tear down this mesh; the coordinator must then be re-registered/restarted. Worktree nodes never need force." }
-    },
-    required: ["node_id"]
+}
+function extractDaemonBuildInfo(value) {
+  const payload = unwrapCommandPayload(value);
+  const build = payload?.daemonBuild && typeof payload.daemonBuild === "object" ? payload.daemonBuild : value?.daemonBuild && typeof value.daemonBuild === "object" ? value.daemonBuild : void 0;
+  if (!build) return void 0;
+  const commit = readString(build.commit);
+  if (!commit) return void 0;
+  return {
+    commit,
+    commitShort: readString(build.commitShort) || commit.slice(0, 7),
+    version: readString(build.version) || "unknown",
+    ...readString(build.builtAt) ? { builtAt: readString(build.builtAt) } : {}
+  };
+}
+async function collectMeshViewQueueNodesWithLiveSessions(ctx) {
+  const nodes = await Promise.all(ctx.mesh.nodes.map(async (node) => {
+    const liveSessions = await collectLiveStatusSessions(ctx, node);
+    return liveSessions.length > 0 ? { ...node, sessions: liveSessions } : node;
+  }));
+  return nodes;
+}
+function buildBranchConvergence(mesh, node, status, dirty, uncommittedChanges) {
+  const defaultBranch = readString(mesh.defaultBranch) ?? "main";
+  const branch = readString(status?.branch) ?? readString(node.worktreeBranch) ?? null;
+  const ahead = readNumeric(status?.ahead);
+  const behind = readNumeric(status?.behind);
+  const upstream = readString(status?.upstream) ?? null;
+  const upstreamStatus = readString(status?.upstreamStatus) ?? (upstream ? "unchecked" : "no_upstream");
+  const hasConflicts = status?.hasConflicts === true || Array.isArray(status?.conflictFiles) && status.conflictFiles.length > 0;
+  const base = {
+    defaultBranch,
+    branch,
+    upstream,
+    upstreamStatus,
+    ahead,
+    behind,
+    isWorktree: node.isLocalWorktree === true,
+    isDefaultBranch: branch === defaultBranch
+  };
+  if (status?.isGitRepo !== true) {
+    return {
+      ...base,
+      status: "blocked_review",
+      needsConvergence: true,
+      reason: "git_status_unavailable",
+      nextStep: `Resolve git status for node '${node.id}' before marking the task complete.`
+    };
   }
-};
-var MESH_CLEANUP_SESSIONS_TOOL = {
-  name: "mesh_cleanup_sessions",
-  description: "Manually clean up delegated session records for a mesh node without removing the node. Defaults should preserve reviewable history unless the caller chooses a mode explicitly.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Node ID whose delegated sessions should be considered for cleanup." },
-      mode: {
-        type: "string",
-        enum: ["preserve", "stop", "delete_stopped", "stop_and_delete"],
-        description: "preserve = no-op; stop = release process occupancy by stopping live runtimes; delete_stopped = remove completed/stopped records while leaving live runtimes alone; stop_and_delete = stop live runtimes and delete records."
-      },
-      session_ids: {
-        type: "array",
-        items: { type: "string" },
-        description: "Optional explicit session IDs to limit cleanup to. When omitted, sessions are matched by node/workspace metadata."
-      },
-      dry_run: { type: "boolean", description: "Preview matched/stopped/deleted/skipped session IDs without mutating session-host state." }
-    },
-    required: ["node_id", "mode"]
+  if (!branch) {
+    return {
+      ...base,
+      status: "blocked_review",
+      needsConvergence: true,
+      reason: "branch_unknown",
+      nextStep: `Inspect node '${node.id}' git branch before deciding whether it is merged to ${defaultBranch}.`
+    };
   }
-};
-var MESH_TASK_HISTORY_TOOL = {
-  name: "mesh_task_history",
-  description: "Read the task ledger for this mesh \u2014 dispatched tasks, completions, failures, checkpoints, and node lifecycle events. Use to understand what has been done before deciding next steps, to detect repeated failures, and to inform recovery decisions.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      tail: { type: "number", description: "Number of recent entries to return (default: 20; clamped to 40 in compact mode, 200 in verbose)." },
-      kind: { type: "string", description: "Filter by entry kind: task_dispatched, task_completed, task_failed, task_stalled, session_launched, checkpoint_created, node_cloned, node_removed, direct_fast_forward." },
-      compact: { type: "boolean", description: "Slim payload for LLM callers. Default true. Truncates long payload strings (message/taskSummary \u2264200, finalSummary \u2264300) and elides any large nested evidence blob (>2KB serialized \u2014 e.g. validationSummary/result/patchEquivalence/submoduleReachability) to a {_elided,_kind,_bytes,_hint} placeholder; full evidence stays accessible via mesh_reconcile_ledger. Set false (or verbose=true) for full untruncated payloads." },
-      verbose: { type: "boolean", description: "Force the full untruncated payload; overrides compact." }
-    }
+  if (hasConflicts || dirty || uncommittedChanges > 0) {
+    return {
+      ...base,
+      status: "not_mergeable",
+      needsConvergence: true,
+      reason: hasConflicts ? "conflicts_present" : "dirty_workspace",
+      nextStep: `Commit, checkpoint, or resolve node '${node.id}' before any main convergence step.`
+    };
   }
-};
-var MESH_RECONCILE_LEDGER_TOOL = {
-  name: "mesh_reconcile_ledger",
-  description: "Reconcile daemon-local mesh ledgers by querying bounded ledger slices over P2P/DataChannel and importing missing entries into the coordinator local JSONL ledger. Cloud/D1 is not used as a ledger source of truth.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_ids: { type: "array", items: { type: "string" }, description: "Optional node IDs to query. Defaults to all mesh nodes." },
-      limit: { type: "number", description: "Bounded slice size per node. Defaults to 100 and is clamped by daemon-core." },
-      after_id: { type: "string", description: "Optional cursor entry ID; remote slices return entries strictly after this ID when present." },
-      since: { type: "string", description: "Optional ISO timestamp lower bound for queried entries." },
-      import_entries: { type: "boolean", description: "When false, query and report evidence without importing remote entries. Defaults true." }
+  if (branch === defaultBranch) {
+    if (upstream && upstreamStatus !== "fresh") {
+      return {
+        ...base,
+        status: "blocked_review",
+        needsConvergence: true,
+        reason: "default_branch_upstream_unverified",
+        nextStep: `Refresh ${defaultBranch}'s upstream refs or resolve the fetch failure before declaring convergence complete for node '${node.id}'.`
+      };
     }
-  }
-};
-var MESH_PRUNE_STALE_DIRECT_TOOL = {
-  name: "mesh_prune_stale_direct",
-  description: "Prune orphaned staleDirect dispatch records \u2014 direct task dispatches whose original node/session is no longer present in the live mesh. dry_run (default) reports exactly which records would be pruned without mutating anything; pass execute=true to delete them. Active/pending/assigned/generating work and fresh unacknowledged dispatch failures (node/session still live) are always preserved. The append-only mesh ledger audit history is left intact.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      execute: { type: "boolean", description: "When true, actually delete the orphaned records. Defaults false (dry run). Ignored when dry_run=true." },
-      dry_run: { type: "boolean", description: "Force a preview without mutation even if execute=true. Defaults to dry-run behavior when execute is not set." },
-      include_terminal: { type: "boolean", description: "Also prune terminal (completed/failed) direct dispatch store rows in addition to orphans. Defaults false." }
+    if (ahead > 0 || behind > 0) {
+      return {
+        ...base,
+        status: "blocked_review",
+        needsConvergence: true,
+        reason: "default_branch_not_even_with_upstream",
+        nextStep: `Bring ${defaultBranch} even with its upstream before declaring convergence complete.`
+      };
     }
+    return {
+      ...base,
+      status: "merged_to_main",
+      needsConvergence: false,
+      reason: "clean_default_branch",
+      nextStep: null
+    };
   }
-};
-var MESH_REFINE_NODE_TOOL = {
-  name: "mesh_refine_node",
-  description: "The Refinery: validate \u2192 merge \u2192 push \u2192 clean up a completed worktree node onto the base branch. Defaults to dry-run (plan only): returns the validation plan with mergeWillRun:false/cleanupWillRun:false and performs NO merge/push/cleanup. Pass execute=true to actually converge the node. execute=true is async: the immediate response includes async:true, status:'accepted', jobId, interactionId, target node, and startedAt; completion/failure evidence is delivered through pending mesh events and the mesh task ledger. dry_run=true overrides execute. Matches the mesh_refine_batch / mesh_fast_forward_node dry_run/execute contract.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Node ID of the completed worktree node to refine and merge." },
-      execute: { type: "boolean", description: "When true, run validation/merge/push/cleanup for this node. Defaults false/dry-run." },
-      dry_run: { type: "boolean", description: "Preview the validation plan without merging. Defaults true unless execute=true; dry_run=true overrides execute." }
-    },
-    required: ["node_id"]
+  if (node.isLocalWorktree) {
+    return {
+      ...base,
+      status: "cleanup_candidate",
+      needsConvergence: true,
+      reason: "clean_non_default_worktree_branch",
+      nextStep: `Run mesh_refine_node(node_id: "${node.id}") or explicitly classify this worktree as blocked_review/not_mergeable before ending the task.`
+    };
   }
-};
-var MESH_REFINE_BATCH_TOOL = {
-  name: "mesh_refine_batch",
-  description: "Batch Refinery: converge multiple sibling worktree nodes onto the base branch in one conflict-aware sequential pipeline. Orders nodes by change-area (non-submodule nodes first, submodule-touching nodes serialized last) so each merged sibling advances the base and the next node auto-rebases + re-checks patch-equivalence before its own merge. Each node runs the same validation/patch-equivalence/submodule-reachability/merge/cleanup gates as mesh_refine_node. Conflicting or blocked nodes are isolated as blocked_review while the rest of the batch proceeds. Defaults to dry-run (plan only); set execute=true to converge. Never force-pushes or resets. execute=true is async: the immediate response is async:true / status:'accepted' with the batch jobId and ordered target node list; per-node convergence runs in the background and the aggregate completion/failure (with per-node merged / blocked_review / not_mergeable results) is delivered as a terminal refine event via pending mesh events and the ledger \u2014 do not re-invoke while a batch is in flight. dry_run returns the plan synchronously.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_ids: {
-        type: "array",
-        items: { type: "string" },
-        description: "Optional explicit node IDs to converge, in any order (the tool computes the safe merge order). When omitted, all local worktree nodes that need convergence are auto-collected."
-      },
-      execute: { type: "boolean", description: "When true, run validation/rebase/merge for each node in order. Defaults false/dry-run." },
-      dry_run: { type: "boolean", description: "Preview the ordering + per-node validation plan without executing. Defaults true unless execute=true; dry_run=true overrides execute." }
-    },
-    required: []
+  if (upstream && upstreamStatus !== "fresh") {
+    return {
+      ...base,
+      status: "blocked_review",
+      needsConvergence: true,
+      reason: "feature_branch_upstream_unverified",
+      nextStep: `Refresh branch '${branch}' upstream refs or resolve the fetch failure before deciding whether it is ready to merge into ${defaultBranch}.`
+    };
   }
-};
-var MESH_REFINE_CONFIG_SCHEMA_TOOL = {
-  name: "mesh_refine_config_schema",
-  description: "Return the Repo Mesh Refinery config JSON schema and supported repo-local config locations. This is the validation source of truth; heuristic command detection is suggestions-only.",
-  inputSchema: { type: "object", properties: {} }
-};
-var MESH_VALIDATE_REFINE_CONFIG_TOOL = {
-  name: "mesh_validate_refine_config",
-  description: "Validate the repo mesh/refine config for a node/workspace without running validation commands or merging.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Optional node/workspace whose refine config should be loaded. Defaults to the first mesh node." },
-      config: { type: "object", description: "Optional inline config object to validate instead of loading from the repo." }
-    }
+  if (!upstream || ahead > 0 || behind > 0) {
+    return {
+      ...base,
+      status: "blocked_review",
+      needsConvergence: true,
+      reason: !upstream ? "feature_branch_missing_upstream" : "feature_branch_not_even_with_upstream",
+      nextStep: `Push or reconcile branch '${branch}', then merge it into ${defaultBranch} or mark it not_mergeable with a reason.`
+    };
+  }
+  return {
+    ...base,
+    status: "pushed_feature_branch_needs_merge",
+    needsConvergence: true,
+    reason: "clean_non_default_branch",
+    nextStep: `Review and merge branch '${branch}' into ${defaultBranch}; do not report the task as fully complete while it remains off main.`
+  };
+}
+var COMPACT_MAX_CONVERGENCE_FOLLOWUPS = 12;
+function summarizeBranchConvergence(nodes, compact = false) {
+  const allFollowUps = nodes.filter((node) => node?.branchConvergence?.needsConvergence === true).map((node) => ({
+    nodeId: node.nodeId,
+    // workspace is a long absolute path redundant with nodeId — drop it in
+    // compact mode to keep this summary bounded.
+    ...compact ? {} : { workspace: node.workspace },
+    branch: node.branchConvergence.branch,
+    status: node.branchConvergence.status,
+    reason: node.branchConvergence.reason,
+    // The per-node nextStep is long prose that repeats node ids/branch names.
+    // In compact mode drop it (the status+reason carry the actionable signal;
+    // verbose still surfaces the full nextStep) so this summary stays bounded
+    // as node count grows.
+    ...compact ? {} : { nextStep: node.branchConvergence.nextStep }
+  }));
+  const byStatus = {};
+  for (const f of allFollowUps) {
+    const s = typeof f.status === "string" ? f.status : "unknown";
+    byStatus[s] = (byStatus[s] ?? 0) + 1;
   }
-};
-var MESH_SUGGEST_REFINE_CONFIG_TOOL = {
-  name: "mesh_suggest_refine_config",
-  description: "Suggest a repo mesh/refine config scaffold from project context/package scripts. Suggestions are never executed until saved as explicit refine config.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Optional node/workspace used for suggestions. Defaults to the first mesh node." }
-    }
+  const followUps = compact ? allFollowUps.slice(0, COMPACT_MAX_CONVERGENCE_FOLLOWUPS) : allFollowUps;
+  const omitted = allFollowUps.length - followUps.length;
+  return {
+    needsFollowUp: allFollowUps.length > 0,
+    unresolvedCount: allFollowUps.length,
+    byStatus,
+    requiredFinalStates: ["merged_to_main", "pushed_feature_branch_needs_merge", "blocked_review", "cleanup_candidate", "not_mergeable"],
+    followUps,
+    ...omitted > 0 ? { followUpsOmitted: omitted, followUpsHint: "Per-node followUp rows are capped in compact mode; counts above are complete. Use verbose=true for the full list." } : {}
+  };
+}
+async function commandForNode(ctx, node, command, args = {}) {
+  const isLocalNode = isLocalControlPlaneNode(ctx, node);
+  if (ctx.transport instanceof IpcTransport && node.daemonId && !isLocalNode) {
+    return ctx.transport.meshCommand(node.daemonId, command, args);
   }
-};
-var MESH_CHANGE_IMPACT_CONFIG_SCHEMA_TOOL = {
-  name: "mesh_change_impact_config_schema",
-  description: "Return the Change Impact config JSON schema and supported repo-local config locations. Change Impact config declaratively classifies which package/file changes between the live daemon build and workspace HEAD require a daemon rebuild/restart vs. a web-only redeploy vs. nothing. Declarative only \u2014 config is parsed, never executed.",
-  inputSchema: { type: "object", properties: {} }
-};
-var MESH_VALIDATE_CHANGE_IMPACT_CONFIG_TOOL = {
-  name: "mesh_validate_change_impact_config",
-  description: "Validate a Change Impact config for a node/workspace and report valid/errors. Loads .adhdev/change-impact.{json,yaml,yml} (or repo-mesh-change-impact.* alias) from the repo unless an inline config is provided.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Optional node/workspace whose change-impact config should be loaded. Defaults to the first mesh node." },
-      config: { type: "object", description: "Optional inline config object to validate instead of loading from the repo." }
+  return ctx.transport.command(command, args);
+}
+function normalizePendingMeshCoordinatorEvents(value) {
+  const payload = unwrapCommandPayload(value);
+  const events = Array.isArray(payload?.events) ? payload.events : Array.isArray(value?.events) ? value.events : [];
+  return events.filter((event) => event && typeof event === "object");
+}
+function buildMeshForwardPayloadFromPendingEvent(event) {
+  const metadataEvent = event?.metadataEvent && typeof event.metadataEvent === "object" ? event.metadataEvent : {};
+  return {
+    event: readString(event?.event),
+    meshId: readString(event?.meshId),
+    nodeId: readString(event?.nodeId) || readString(metadataEvent.meshNodeId),
+    workspace: readString(event?.workspace) || readString(metadataEvent.workspace),
+    targetSessionId: readString(metadataEvent.targetSessionId) || readString(metadataEvent.sessionId) || readString(metadataEvent.instanceId),
+    providerType: readString(metadataEvent.providerType),
+    providerSessionId: readString(metadataEvent.providerSessionId),
+    finalSummary: readString(metadataEvent.finalSummary) || readString(metadataEvent.summary),
+    jobId: readString(metadataEvent.jobId),
+    interactionId: readString(metadataEvent.interactionId),
+    status: readString(metadataEvent.status),
+    targetDaemonId: readString(metadataEvent.targetDaemonId),
+    startedAt: readString(metadataEvent.startedAt),
+    completedAt: readString(metadataEvent.completedAt),
+    retryOfJobId: readString(metadataEvent.retryOfJobId),
+    ...metadataEvent.result && typeof metadataEvent.result === "object" && !Array.isArray(metadataEvent.result) ? { result: metadataEvent.result } : {},
+    ...metadataEvent.intentional === true ? { intentional: true } : {},
+    ...metadataEvent.intentionalStop === true ? { intentionalStop: true } : {},
+    ...metadataEvent.operatorCleanup === true ? { operatorCleanup: true } : {},
+    ...readString(metadataEvent.reason) ? { reason: readString(metadataEvent.reason) } : {},
+    ...readString(metadataEvent.stopReason) ? { stopReason: readString(metadataEvent.stopReason) } : {},
+    ...readString(metadataEvent.cleanupReason) ? { cleanupReason: readString(metadataEvent.cleanupReason) } : {},
+    ...readString(metadataEvent.source) ? { source: readString(metadataEvent.source) } : {}
+  };
+}
+async function drainCoordinatorPendingEvents(ctx, opts) {
+  const requestedNodeIds = opts?.nodeIds?.length ? new Set(opts.nodeIds) : null;
+  const matchesCurrentMesh = (event) => readString(event?.meshId) === ctx.mesh.id;
+  if (ctx.transport instanceof IpcTransport) {
+    const surfacedEvents = [];
+    const coordinatorDaemonId = readString(ctx.localDaemonId);
+    const pendingEventArgs = {
+      meshId: ctx.mesh.id,
+      ...coordinatorDaemonId ? { coordinatorDaemonId } : {}
+    };
+    try {
+      const localEvents = normalizePendingMeshCoordinatorEvents(await ctx.transport.command("get_pending_mesh_events", pendingEventArgs)).filter(matchesCurrentMesh);
+      for (const event of localEvents) {
+        const payload = buildMeshForwardPayloadFromPendingEvent(event);
+        if (!payload.event || !payload.meshId) continue;
+        let injected = false;
+        try {
+          await ctx.transport.command("mesh_forward_event", payload);
+          injected = true;
+        } catch {
+        }
+        rememberMeshSessionProviderMetadataFromEvent({ ...event, metadataEvent: payload });
+        if (!injected) surfacedEvents.push(event);
+      }
+    } catch {
     }
-  }
-};
-var MESH_SUGGEST_CHANGE_IMPACT_CONFIG_TOOL = {
-  name: "mesh_suggest_change_impact_config",
-  description: "Suggest a Change Impact config scaffold from the repo package layout (web-* \u2192 web-only, others \u2192 daemon-runtime, plus docs/license markers as non-runtime). Heuristic scaffold only \u2014 the draft must be reviewed and saved before it takes effect; nothing is executed.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Optional node/workspace used for suggestions. Defaults to the first mesh node." }
+    for (const node of ctx.mesh.nodes) {
+      if (!node.daemonId || isLocalControlPlaneNode(ctx, node)) continue;
+      if (requestedNodeIds && !requestedNodeIds.has(node.id)) continue;
+      try {
+        const remoteEvents = normalizePendingMeshCoordinatorEvents(
+          await ctx.transport.meshCommand(node.daemonId, "get_pending_mesh_events", pendingEventArgs)
+        ).filter(matchesCurrentMesh);
+        if (remoteEvents.length === 0) continue;
+        for (const event of remoteEvents) {
+          const payload = buildMeshForwardPayloadFromPendingEvent(event);
+          if (!payload.event || !payload.meshId) continue;
+          await ctx.transport.command("mesh_forward_event", payload);
+          rememberMeshSessionProviderMetadataFromEvent({ ...event, metadataEvent: payload });
+        }
+      } catch {
+      }
     }
-  }
-};
-var MESH_INIT_TOOL = {
-  name: "mesh_init",
-  description: "One-click mesh onboarding for an existing git project. Detects installed CLI providers, suggests Refinery (.adhdev/refine.json) and worktree bootstrap (.adhdev/worktree_bootstrap.json) configs, optionally writes them to disk, and recommends a node providerPriority from the detected providers. Suggestions are scaffold only and never execute until saved; providerPriority is a recommendation to apply to node policy, not auto-applied. Defaults to dry-run (no files written) and never overwrites an existing config unless overwrite=true.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Optional node/workspace to onboard. Defaults to the first mesh node with a workspace." },
-      write: { type: "boolean", description: "When true, persist the suggested configs to disk. Defaults false (dry-run preview only)." },
-      overwrite: { type: "boolean", description: "When true, overwrite an existing config file. Defaults false (never clobber an existing refine/bootstrap config)." }
+    try {
+      const localEvents = normalizePendingMeshCoordinatorEvents(await ctx.transport.command("get_pending_mesh_events", pendingEventArgs)).filter(matchesCurrentMesh);
+      for (const event of localEvents) {
+        const payload = buildMeshForwardPayloadFromPendingEvent(event);
+        if (!payload.event || !payload.meshId) continue;
+        let injected = false;
+        try {
+          await ctx.transport.command("mesh_forward_event", payload);
+          injected = true;
+        } catch {
+        }
+        rememberMeshSessionProviderMetadataFromEvent({ ...event, metadataEvent: payload });
+        if (!injected) surfacedEvents.push(event);
+      }
+    } catch {
     }
+    return surfacedEvents;
   }
-};
-var MESH_REFINE_PLAN_TOOL = {
-  name: "mesh_refine_plan",
-  description: "Dry-run Refinery plan for a worktree node: reports config source, validation commands, suggestions/unavailable reason, and merge/cleanup intent without executing validation or git merge.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      node_id: { type: "string", description: "Node ID of the worktree node to plan." }
-    },
-    required: ["node_id"]
-  }
-};
-var MESH_REVIEW_INBOX_TOOL = {
-  name: "mesh_review_inbox",
-  description: "List local worktree nodes that need human review: merge candidates (pushed feature branches ready to merge) and Refinery-blocked review results. Returns evidence summaries, diff stats vs. the default branch, and suggested actions (Refine / Requeue / Dismiss). Remote nodes are excluded in M4.0.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      mesh_id: { type: "string", description: "Mesh ID (optional \u2014 inferred from active mesh if omitted)." }
-    },
-    required: []
-  }
-};
-var ALL_MESH_TOOLS = [
-  MESH_STATUS_TOOL,
-  MESH_LIST_NODES_TOOL,
-  MESH_ENQUEUE_TASK_TOOL,
-  MESH_VIEW_QUEUE_TOOL,
-  MESH_QUEUE_CANCEL_TOOL,
-  MESH_QUEUE_REQUEUE_TOOL,
-  MESH_SEND_TASK_TOOL,
-  MESH_READ_CHAT_TOOL,
-  MESH_READ_DEBUG_TOOL,
-  MESH_LAUNCH_SESSION_TOOL,
-  MESH_GIT_STATUS_TOOL,
-  MESH_READ_NODE_LOGS_TOOL,
-  MESH_FAST_FORWARD_NODE_TOOL,
-  MESH_RESTART_DAEMON_TOOL,
-  MESH_CHECKPOINT_TOOL,
-  MESH_APPROVE_TOOL,
-  MESH_CLONE_NODE_TOOL,
-  MESH_REMOVE_NODE_TOOL,
-  MESH_REFINE_NODE_TOOL,
-  MESH_REFINE_BATCH_TOOL,
-  MESH_REFINE_CONFIG_SCHEMA_TOOL,
-  MESH_VALIDATE_REFINE_CONFIG_TOOL,
-  MESH_SUGGEST_REFINE_CONFIG_TOOL,
-  MESH_CHANGE_IMPACT_CONFIG_SCHEMA_TOOL,
-  MESH_VALIDATE_CHANGE_IMPACT_CONFIG_TOOL,
-  MESH_SUGGEST_CHANGE_IMPACT_CONFIG_TOOL,
-  MESH_INIT_TOOL,
-  MESH_REFINE_PLAN_TOOL,
-  MESH_CLEANUP_SESSIONS_TOOL,
-  MESH_PRUNE_STALE_DIRECT_TOOL,
-  MESH_TASK_HISTORY_TOOL,
-  MESH_RECONCILE_LEDGER_TOOL,
-  MESH_MISSION_UPSERT_TOOL,
-  MESH_MISSION_LIST_TOOL,
-  MESH_REVIEW_INBOX_TOOL
-];
+  const events = (0, import_daemon_core2.drainPendingMeshCoordinatorEvents)(ctx.mesh.id, ctx.localDaemonId).filter(matchesCurrentMesh);
+  events.forEach(rememberMeshSessionProviderMetadataFromEvent);
+  return events;
+}
+function isP2pTransportUnavailableError(error) {
+  return (0, import_daemon_core2.isP2pRelayTransportFailure)(error);
+}
+function buildRemoveNodeArgs(ctx, nodeId, sessionCleanupMode, force) {
+  return {
+    meshId: ctx.mesh.id,
+    nodeId,
+    ...sessionCleanupMode ? { sessionCleanupMode } : {},
+    ...force === true ? { force: true } : {},
+    inlineMesh: ctx.mesh
+  };
+}
 async function meshStatus(ctx, args = {}) {
-  const rateResult = (0, import_daemon_core.recordMeshToolCall)({ meshId: ctx.mesh.id, tool: "mesh_status" });
+  const rateResult = (0, import_daemon_core2.recordMeshToolCall)({ meshId: ctx.mesh.id, tool: "mesh_status" });
   const compact = args.verbose === true ? false : args.compact ?? true;
   await refreshMeshFromDaemon(ctx);
   const { mesh, transport } = ctx;
-  let ledgerSummary = (0, import_daemon_core.getLedgerSummary)(mesh.id);
+  let ledgerSummary = (0, import_daemon_core2.getLedgerSummary)(mesh.id);
   const results = await Promise.all(mesh.nodes.map(async (node) => {
     const entry = {
       nodeId: node.id,
@@ -2870,14 +2902,14 @@ async function meshStatus(ctx, args = {}) {
         noFallbackReason: failure.noFallbackReason
       });
     }
-    entry.dataFreshness = (0, import_daemon_core.buildMeshNodeProbeFreshness)({
+    entry.dataFreshness = (0, import_daemon_core2.buildMeshNodeProbeFreshness)({
       git: entry.git,
       liveTruthProbed,
       isSelfNode: entry.machine?.sameMachine === true,
       daemonId: readNodeDaemonId(node),
       node
     });
-    const recoveryContext = (0, import_daemon_core.getSessionRecoveryContext)(mesh.id, { nodeId: node.id });
+    const recoveryContext = (0, import_daemon_core2.getSessionRecoveryContext)(mesh.id, { nodeId: node.id });
     if (recoveryContext.consecutiveNodeFailures > 0) {
       entry.recoveryHints = {
         consecutiveFailures: recoveryContext.consecutiveNodeFailures,
@@ -2949,23 +2981,23 @@ async function meshStatus(ctx, args = {}) {
     }
     return entry;
   }));
-  let ledgerEntries = (0, import_daemon_core.readLedgerEntries)(mesh.id, { tail: 200 });
-  let directDispatches = (0, import_daemon_core.getActiveDirectDispatches)(mesh.id);
+  let ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(mesh.id, { tail: 200 });
+  let directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(mesh.id);
   const directReconciliation = await reconcileDirectDispatchesFromTranscriptEvidence(ctx, results, directDispatches, ledgerEntries);
   if (directReconciliation.reconciled > 0) {
-    ledgerEntries = (0, import_daemon_core.readLedgerEntries)(mesh.id, { tail: 200 });
-    directDispatches = (0, import_daemon_core.getActiveDirectDispatches)(mesh.id);
-    ledgerSummary = (0, import_daemon_core.getLedgerSummary)(mesh.id);
+    ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(mesh.id, { tail: 200 });
+    directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(mesh.id);
+    ledgerSummary = (0, import_daemon_core2.getLedgerSummary)(mesh.id);
   }
-  const activeWorkEvidence = (0, import_daemon_core.buildMeshActiveWork)({
+  const activeWorkEvidence = (0, import_daemon_core2.buildMeshActiveWork)({
     meshId: mesh.id,
-    queue: (0, import_daemon_core.getQueue)(mesh.id),
+    queue: (0, import_daemon_core2.getQueue)(mesh.id),
     ledgerEntries,
     directDispatches,
     nodes: results
   });
   const pollingGuidance = buildActiveWorkPollingGuidance(activeWorkEvidence.summary);
-  const staleDirectWorkSummary = (0, import_daemon_core.buildCompactStaleDirectWorkSummary)(activeWorkEvidence.staleDirectWork, {
+  const staleDirectWorkSummary = (0, import_daemon_core2.buildCompactStaleDirectWorkSummary)(activeWorkEvidence.staleDirectWork, {
     note: activeWorkEvidence.staleDirectWorkNote,
     detailHint: "Full stale direct entries are omitted from mesh_status by default. Call mesh_status with includeStaleDirectWorkDetails=true or inspect mesh_task_history for ledger detail."
   });
@@ -3153,7 +3185,7 @@ async function meshStatus(ctx, args = {}) {
   }
   try {
     if (compact) {
-      const { live, historyFold } = (0, import_daemon_core.getMeshStatusMissionsCompact)(mesh.id);
+      const { live, historyFold } = (0, import_daemon_core2.getMeshStatusMissionsCompact)(mesh.id);
       const ranked = [...live].sort((a, b) => String(b.tasks?.lastActivityAt ?? "").localeCompare(String(a.tasks?.lastActivityAt ?? "")));
       const kept = [];
       const overflow = [];
@@ -3180,11 +3212,11 @@ async function meshStatus(ctx, args = {}) {
       }
       if (historyFold) response.missionsHistory = historyFold;
     } else {
-      const missions = (0, import_daemon_core.getMeshStatusMissionSummaries)(mesh.id, { verbose: true });
+      const missions = (0, import_daemon_core2.getMeshStatusMissionSummaries)(mesh.id, { verbose: true });
       if (missions.length > 0) {
         response.missions = missions.map((mission) => {
           try {
-            return { ...mission, stats: (0, import_daemon_core.computeMeshMissionStats)(mesh.id, mission.id) };
+            return { ...mission, stats: (0, import_daemon_core2.computeMeshMissionStats)(mesh.id, mission.id) };
           } catch {
             return mission;
           }
@@ -3195,14 +3227,14 @@ async function meshStatus(ctx, args = {}) {
   }
   try {
     const pendingEvents = await drainCoordinatorPendingEvents(ctx);
-    const asyncRefineJobs = (0, import_daemon_core.buildMeshAsyncRefineJobs)({
+    const asyncRefineJobs = (0, import_daemon_core2.buildMeshAsyncRefineJobs)({
       meshId: mesh.id,
       ledgerEntries,
       pendingEvents
     });
     if (asyncRefineJobs.length > 0) {
       if (compact) {
-        const summary = (0, import_daemon_core.summarizeMeshAsyncRefineJobs)(asyncRefineJobs);
+        const summary = (0, import_daemon_core2.summarizeMeshAsyncRefineJobs)(asyncRefineJobs);
         if (summary.activeJobs.length > 0) response.asyncRefineJobs = summary.activeJobs;
         response.asyncRefineJobsSummary = {
           total: summary.total,
@@ -3228,17 +3260,17 @@ async function meshTaskHistory(ctx, args) {
   const compactCap = requestedTail > 50 ? 20 : 30;
   const tail = compact ? Math.min(requestedTail, compactCap) : Math.min(requestedTail, 200);
   const kind = typeof args.kind === "string" && args.kind.trim() ? [args.kind.trim()] : void 0;
-  const rawEntries = (0, import_daemon_core.readLedgerEntries)(mesh.id, { tail, kind });
+  const rawEntries = (0, import_daemon_core2.readLedgerEntries)(mesh.id, { tail, kind });
   const entries = compact ? rawEntries.map((e) => ({
     ...e,
     payload: e.payload ? slimLedgerPayload(e.payload) : e.payload
   })) : rawEntries;
-  const summary = (0, import_daemon_core.getLedgerSummary)(mesh.id);
+  const summary = (0, import_daemon_core2.getLedgerSummary)(mesh.id);
   let taskStats;
   try {
     const taskIds = [...new Set(rawEntries.map((e) => typeof e.payload?.taskId === "string" ? e.payload.taskId : "").filter(Boolean))];
     if (taskIds.length > 0) {
-      const stats = (0, import_daemon_core.computeMeshTaskStats)(mesh.id, { taskIds });
+      const stats = (0, import_daemon_core2.computeMeshTaskStats)(mesh.id, { taskIds });
       if (stats.length > 0) taskStats = stats;
     }
   } catch {
@@ -3252,6 +3284,33 @@ async function meshTaskHistory(ctx, args) {
     ...pendingEvents.length > 0 ? { pendingCoordinatorEvents: pendingEvents } : {}
   }, null, 2);
 }
+async function meshRecordNote(ctx, args) {
+  const { mesh } = ctx;
+  const text = typeof args.text === "string" ? args.text.trim() : "";
+  if (!text) {
+    return JSON.stringify({ success: false, error: "text required" }, null, 2);
+  }
+  const category = args.category === "provider_quirk" || args.category === "pattern_to_avoid" || args.category === "recovery_lesson" ? args.category : void 0;
+  const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  const sourceCoordinator = ctx.coordinatorSessionId || ctx.localDaemonId || ctx.coordinatorHostname || void 0;
+  const entry = (0, import_daemon_core2.appendLedgerEntry)(mesh.id, {
+    kind: "coordinator_operating_note",
+    ...sourceCoordinator ? { sessionId: sourceCoordinator } : {},
+    payload: {
+      text,
+      ...category ? { category } : {},
+      createdAt,
+      ...sourceCoordinator ? { sourceCoordinator } : {}
+    }
+  });
+  return JSON.stringify({
+    success: true,
+    meshId: mesh.id,
+    noteId: entry.id,
+    recorded: { text, category: category ?? null, createdAt },
+    note: 'Recorded to the mesh ledger. Future coordinators on this mesh will see it under "## Operating Notes" at launch.'
+  }, null, 2);
+}
 async function meshReconcileLedger(ctx, args) {
   await refreshMeshFromDaemon(ctx);
   const requestedNodeIds = Array.isArray(args.node_ids) ? new Set(args.node_ids.map((id) => typeof id === "string" ? id.trim() : "").filter(Boolean)) : null;
@@ -3267,8 +3326,8 @@ async function meshReconcileLedger(ctx, args) {
   for (const node of nodes) {
     try {
       if (isLocalControlPlaneNode(ctx, node) || !node.daemonId) {
-        const slice2 = (0, import_daemon_core.readLedgerSliceFromStore)(ctx.mesh.id, queryArgs);
-        replicas.push((0, import_daemon_core.buildMeshLedgerReplicaEvidence)({
+        const slice2 = (0, import_daemon_core2.readLedgerSliceFromStore)(ctx.mesh.id, queryArgs);
+        replicas.push((0, import_daemon_core2.buildMeshLedgerReplicaEvidence)({
           nodeId: node.id,
           daemonId: node.daemonId,
           transport: "local",
@@ -3286,8 +3345,8 @@ async function meshReconcileLedger(ctx, args) {
       if (slice?.protocol !== "adhdev.mesh.ledger.slice.v1" || !Array.isArray(slice.entries)) {
         throw new Error("remote daemon returned an invalid ledger slice payload");
       }
-      const importResult = shouldImport ? (0, import_daemon_core.appendRemoteLedgerEntries)(ctx.mesh.id, slice.entries) : { accepted: 0, skippedDuplicate: 0, rejectedInvalid: 0, entries: [] };
-      replicas.push((0, import_daemon_core.buildMeshLedgerReplicaEvidence)({
+      const importResult = shouldImport ? (0, import_daemon_core2.appendRemoteLedgerEntries)(ctx.mesh.id, slice.entries) : { accepted: 0, skippedDuplicate: 0, rejectedInvalid: 0, entries: [] };
+      replicas.push((0, import_daemon_core2.buildMeshLedgerReplicaEvidence)({
         nodeId: node.id,
         daemonId: node.daemonId,
         transport: "p2p_datachannel",
@@ -3295,7 +3354,7 @@ async function meshReconcileLedger(ctx, args) {
         importResult
       }));
       if (shouldImport && importResult.accepted > 0) {
-        (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+        (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
           kind: "ledger_replicated",
           nodeId: node.id,
           payload: {
@@ -3309,7 +3368,7 @@ async function meshReconcileLedger(ctx, args) {
         });
       }
     } catch (e) {
-      replicas.push((0, import_daemon_core.buildMeshLedgerReplicaEvidence)({
+      replicas.push((0, import_daemon_core2.buildMeshLedgerReplicaEvidence)({
         nodeId: node.id,
         daemonId: node.daemonId,
         transport: node.daemonId ? "p2p_datachannel" : "local",
@@ -3318,8 +3377,8 @@ async function meshReconcileLedger(ctx, args) {
       }));
     }
   }
-  const evidence = (0, import_daemon_core.buildMeshLedgerReconciliationEvidence)(ctx.mesh.id, replicas);
-  (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+  const evidence = (0, import_daemon_core2.buildMeshLedgerReconciliationEvidence)(ctx.mesh.id, replicas);
+  (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
     kind: "ledger_reconciled",
     payload: {
       protocol: evidence.protocol,
@@ -3335,11 +3394,11 @@ async function meshPruneStaleDirect(ctx, args = {}) {
   const execute = args.execute === true && args.dry_run !== true;
   const includeTerminal = args.include_terminal === true;
   const liveNodes = await collectMeshViewQueueNodesWithLiveSessions(ctx);
-  const ledgerEntries = (0, import_daemon_core.readLedgerEntries)(ctx.mesh.id, { tail: 500 });
-  const directDispatches = (0, import_daemon_core.getActiveDirectDispatches)(ctx.mesh.id);
-  const result = (0, import_daemon_core.pruneStaleDirectDispatches)({
+  const ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 500 });
+  const directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(ctx.mesh.id);
+  const result = (0, import_daemon_core2.pruneStaleDirectDispatches)({
     meshId: ctx.mesh.id,
-    queue: (0, import_daemon_core.getQueue)(ctx.mesh.id),
+    queue: (0, import_daemon_core2.getQueue)(ctx.mesh.id),
     ledgerEntries,
     directDispatches,
     nodes: liveNodes,
@@ -3402,7 +3461,7 @@ async function meshListNodes(ctx) {
 }
 async function meshMissionUpsert(ctx, args) {
   try {
-    const mission = (0, import_daemon_core.upsertMeshMission)(ctx.mesh.id, {
+    const mission = (0, import_daemon_core2.upsertMeshMission)(ctx.mesh.id, {
       id: readString(args.mission_id) || readString(args.missionId) || void 0,
       title: args.title,
       goal: typeof args.goal === "string" ? args.goal : void 0,
@@ -3422,21 +3481,21 @@ async function meshMissionUpsert(ctx, args) {
 async function meshMissionList(ctx, args = {}) {
   try {
     const rawStatuses = Array.isArray(args.status) ? args.status : typeof args.status === "string" && args.status.trim() ? [args.status] : [];
-    const invalid = rawStatuses.filter((s) => !import_daemon_core.MESH_MISSION_STATUSES.includes(s));
+    const invalid = rawStatuses.filter((s) => !import_daemon_core2.MESH_MISSION_STATUSES.includes(s));
     if (invalid.length > 0) {
       return JSON.stringify({
         success: false,
         code: "invalid_mission_status",
-        error: `invalid status filter: ${invalid.join(", ")} (valid: ${import_daemon_core.MESH_MISSION_STATUSES.join(", ")})`
+        error: `invalid status filter: ${invalid.join(", ")} (valid: ${import_daemon_core2.MESH_MISSION_STATUSES.join(", ")})`
       });
     }
     const statuses = rawStatuses.length > 0 ? rawStatuses : void 0;
-    const missions = (0, import_daemon_core.listMeshMissionSummaries)(ctx.mesh.id, {
+    const missions = (0, import_daemon_core2.listMeshMissionSummaries)(ctx.mesh.id, {
       statuses,
       verbose: args.verbose === true
     }).map((mission) => {
       try {
-        return { ...mission, stats: (0, import_daemon_core.computeMeshMissionStats)(ctx.mesh.id, mission.id) };
+        return { ...mission, stats: (0, import_daemon_core2.computeMeshMissionStats)(ctx.mesh.id, mission.id) };
       } catch {
         return mission;
       }
@@ -3453,14 +3512,14 @@ async function meshMissionList(ctx, args = {}) {
 }
 async function meshEnqueueTask(ctx, args) {
   const taskMode = readString(args.task_mode) || readString(args.taskMode);
-  const requiredTags = (0, import_daemon_core.normalizeMeshCapabilityTags)(Array.isArray(args.requiredTags) ? args.requiredTags : args.required_tags);
+  const requiredTags = (0, import_daemon_core2.normalizeMeshCapabilityTags)(Array.isArray(args.requiredTags) ? args.requiredTags : args.required_tags);
   const dependsOn = Array.isArray(args.dependsOn) ? args.dependsOn : Array.isArray(args.depends_on) ? args.depends_on : void 0;
   const missionId = readString(args.missionId) || readString(args.mission_id) || void 0;
   const explicitTarget = readString(args.targetNodeId) || readString(args.target_node_id) || void 0;
   const preferWorktree = args.preferWorktree === true || args.prefer_worktree === true;
   const targetNodeId = explicitTarget || (preferWorktree ? resolvePreferredWorktreeNodeId(ctx) : void 0);
   try {
-    const task = (0, import_daemon_core.enqueueTask)(ctx.mesh.id, args.message, { taskMode, requiredTags, dependsOn, missionId, targetNodeId, ...ctx.coordinatorSessionId ? { sourceCoordinatorSessionId: ctx.coordinatorSessionId } : {} });
+    const task = (0, import_daemon_core2.enqueueTask)(ctx.mesh.id, args.message, { taskMode, requiredTags, dependsOn, missionId, targetNodeId, ...ctx.coordinatorSessionId ? { sourceCoordinatorSessionId: ctx.coordinatorSessionId } : {} });
     if (!(ctx.transport instanceof IpcTransport)) {
       const queueTrigger = await triggerMeshQueueAndReport(ctx);
       return JSON.stringify({
@@ -3483,14 +3542,14 @@ async function meshEnqueueTask(ctx, args) {
         const isLocalNode = isLocalControlPlaneNode(ctx, node);
         if (isLocalNode || !node.daemonId) continue;
         if (targetNodeId && node.id !== targetNodeId) continue;
-        if (!(0, import_daemon_core.nodeSatisfiesRequiredTags)(requiredTags, (0, import_daemon_core.buildMeshNodeCapabilityTags)(node))) continue;
+        if (!(0, import_daemon_core2.nodeSatisfiesRequiredTags)(requiredTags, (0, import_daemon_core2.buildMeshNodeCapabilityTags)(node))) continue;
         dispatchPromises.push(
           ipcDispatchToRemoteAgent(ctx, node, { message: args.message }).then((result) => {
             if (result.success) {
               try {
                 const providerType = result.providerType;
                 const descriptor = summarizeTaskMessage(args.message);
-                (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+                (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
                   kind: "task_dispatched",
                   nodeId: node.id,
                   sessionId: result.sessionId,
@@ -3512,7 +3571,7 @@ async function meshEnqueueTask(ctx, args) {
             }
           }).catch((err) => {
             try {
-              (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+              (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
                 kind: "p2p_dispatch_failed",
                 nodeId: node.id,
                 payload: {
@@ -3555,17 +3614,17 @@ async function meshEnqueueTask(ctx, args) {
   }
 }
 async function meshViewQueue(ctx, args) {
-  const rateResult = (0, import_daemon_core.recordMeshToolCall)({ meshId: ctx.mesh.id, tool: "mesh_view_queue" });
+  const rateResult = (0, import_daemon_core2.recordMeshToolCall)({ meshId: ctx.mesh.id, tool: "mesh_view_queue" });
   const compact = args.verbose === true ? false : args.compact ?? true;
   try {
     await refreshMeshFromDaemon(ctx);
     const statusFilter = sanitizeQueueStatusFilter(args.status);
     const view = normalizeQueueViewMode(args.view);
-    const rawQueue = (0, import_daemon_core.getQueue)(ctx.mesh.id);
+    const rawQueue = (0, import_daemon_core2.getQueue)(ctx.mesh.id);
     const statusById = new Map(rawQueue.map((task) => [task.id, task.status]));
     const withDependencies = rawQueue.map((task) => {
       if (!Array.isArray(task.dependsOn) || task.dependsOn.length === 0) return task;
-      const depState = (0, import_daemon_core.describeTaskDependencyState)(task, statusById);
+      const depState = (0, import_daemon_core2.describeTaskDependencyState)(task, statusById);
       return { ...task, ...depState };
     });
     const fullQueue = prioritizeActiveQueueRows(annotateQueueStaleness(withDependencies, ctx.mesh));
@@ -3574,16 +3633,16 @@ async function meshViewQueue(ctx, args) {
     const visibleSummary = buildQueueStatusSummary(queue);
     const maintenance = buildQueueMaintenanceReport(fullQueue);
     const liveNodes = await collectMeshViewQueueNodesWithLiveSessions(ctx);
-    let ledgerEntries = (0, import_daemon_core.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
-    let directDispatches = (0, import_daemon_core.getActiveDirectDispatches)(ctx.mesh.id);
+    let ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
+    let directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(ctx.mesh.id);
     const directReconciliation = await reconcileDirectDispatchesFromTranscriptEvidence(ctx, liveNodes, directDispatches, ledgerEntries);
     if (directReconciliation.reconciled > 0) {
-      ledgerEntries = (0, import_daemon_core.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
-      directDispatches = (0, import_daemon_core.getActiveDirectDispatches)(ctx.mesh.id);
+      ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
+      directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(ctx.mesh.id);
     }
-    (0, import_daemon_core.markStaleDirectDispatches)(ctx.mesh.id);
-    directDispatches = (0, import_daemon_core.getActiveDirectDispatches)(ctx.mesh.id);
-    const activeWorkEvidence = (0, import_daemon_core.buildMeshActiveWork)({
+    (0, import_daemon_core2.markStaleDirectDispatches)(ctx.mesh.id);
+    directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(ctx.mesh.id);
+    const activeWorkEvidence = (0, import_daemon_core2.buildMeshActiveWork)({
       meshId: ctx.mesh.id,
       queue: fullQueue,
       ledgerEntries,
@@ -3608,7 +3667,7 @@ async function meshViewQueue(ctx, args) {
     const wantActiveQueueArray = view === "active" || statusFilter?.some((status) => ACTIVE_QUEUE_STATUSES.has(status));
     const wantHistoricalQueueArray = !compact && (view === "historical" || requestedHistoricalRows);
     const activeWorkResult = compact ? compactActiveWorkRecords(activeWorkEvidence.activeWork) : { records: activeWorkEvidence.activeWork, omitted: 0 };
-    const staleDirectWorkSummary = (0, import_daemon_core.buildCompactStaleDirectWorkSummary)(activeWorkEvidence.staleDirectWork, {
+    const staleDirectWorkSummary = (0, import_daemon_core2.buildCompactStaleDirectWorkSummary)(activeWorkEvidence.staleDirectWork, {
       note: activeWorkEvidence.staleDirectWorkNote,
       detailHint: "Full stale direct entries are omitted from mesh_view_queue in compact mode. Call mesh_view_queue with verbose=true, or inspect mesh_task_history for ledger detail."
     });
@@ -3683,7 +3742,7 @@ async function meshQueueCancel(ctx, args) {
   try {
     const taskId = (args.task_id || args.taskId || "").trim();
     if (!taskId) return JSON.stringify({ success: false, error: "task_id required" });
-    const task = (0, import_daemon_core.cancelTask)(ctx.mesh.id, taskId, { reason: args.reason });
+    const task = (0, import_daemon_core2.cancelTask)(ctx.mesh.id, taskId, { reason: args.reason });
     if (!task) return JSON.stringify({ success: false, error: `Queue task '${taskId}' not found` });
     ctx.transport.command("trigger_mesh_queue", { meshId: ctx.mesh.id }).catch(() => {
     });
@@ -3699,7 +3758,7 @@ async function meshQueueRequeue(ctx, args) {
     const targetNodeId = (args.target_node_id || args.targetNodeId || "").trim() || void 0;
     const targetSessionId = (args.target_session_id || args.targetSessionId || "").trim() || void 0;
     const keepTargetSession = args.keep_target_session === true || args.keepTargetSession === true;
-    const task = (0, import_daemon_core.requeueTask)(ctx.mesh.id, taskId, {
+    const task = (0, import_daemon_core2.requeueTask)(ctx.mesh.id, taskId, {
       reason: args.reason,
       targetNodeId,
       targetSessionId,
@@ -3731,7 +3790,7 @@ async function meshQueueRequeue(ctx, args) {
 async function meshSendTask(ctx, args) {
   const requestedTaskMode = readString(args.task_mode) || readString(args.taskMode);
   const missionId = readString(args.missionId) || readString(args.mission_id) || void 0;
-  const modeValidation = (0, import_daemon_core.validateMeshTaskModeRequest)(requestedTaskMode, args.message);
+  const modeValidation = (0, import_daemon_core2.validateMeshTaskModeRequest)(requestedTaskMode, args.message);
   if (!modeValidation.valid) {
     return JSON.stringify({
       success: false,
@@ -3843,7 +3902,7 @@ async function meshSendTask(ctx, args) {
         const dispatchedAt = (/* @__PURE__ */ new Date()).toISOString();
         try {
           const providerType = result2.providerType || cached?.providerType;
-          (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+          (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
             kind: "task_dispatched",
             nodeId: args.node_id,
             sessionId: dispatchedSessionId,
@@ -3855,7 +3914,7 @@ async function meshSendTask(ctx, args) {
               targetSessionId: dispatchedSessionId
             })
           });
-          (0, import_daemon_core.insertDirectDispatch)(ctx.mesh.id, {
+          (0, import_daemon_core2.insertDirectDispatch)(ctx.mesh.id, {
             taskId,
             nodeId: args.node_id,
             sessionId: dispatchedSessionId,
@@ -3866,7 +3925,7 @@ async function meshSendTask(ctx, args) {
             dispatchedAt
           });
           if (missionId) {
-            (0, import_daemon_core.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
+            (0, import_daemon_core2.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
               id: taskId,
               missionId,
               assignedNodeId: args.node_id,
@@ -4025,7 +4084,7 @@ async function meshSendTask(ctx, args) {
         });
       }
       try {
-        (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+        (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
           kind: "task_dispatched",
           nodeId: args.node_id,
           sessionId: args.session_id,
@@ -4040,7 +4099,7 @@ async function meshSendTask(ctx, args) {
         });
       } catch {
       }
-      (0, import_daemon_core.insertDirectDispatch)(ctx.mesh.id, {
+      (0, import_daemon_core2.insertDirectDispatch)(ctx.mesh.id, {
         taskId,
         nodeId: args.node_id,
         sessionId: args.session_id,
@@ -4053,7 +4112,7 @@ async function meshSendTask(ctx, args) {
       });
       if (missionId) {
         try {
-          (0, import_daemon_core.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
+          (0, import_daemon_core2.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
             id: taskId,
             missionId,
             assignedNodeId: args.node_id,
@@ -4098,14 +4157,14 @@ async function meshSendTask(ctx, args) {
         } : {}
       });
     }
-    const task = (0, import_daemon_core.enqueueTask)(ctx.mesh.id, args.message, {
+    const task = (0, import_daemon_core2.enqueueTask)(ctx.mesh.id, args.message, {
       targetNodeId: args.node_id,
       targetSessionId: args.session_id,
       taskMode,
       ...missionId ? { missionId } : {}
     });
     const queueTrigger = await triggerMeshQueueAndReport(ctx);
-    const pendingEvents = (0, import_daemon_core.drainPendingMeshCoordinatorEvents)(ctx.mesh.id, ctx.localDaemonId);
+    const pendingEvents = (0, import_daemon_core2.drainPendingMeshCoordinatorEvents)(ctx.mesh.id, ctx.localDaemonId);
     const result = {
       success: true,
       source: "queue",
@@ -4138,7 +4197,7 @@ function classifyReadChatTransportCause(error) {
   return "saturated";
 }
 function resolveCachedMeshSessionPreviewFromLedger(ctx, nodeId, sessionId) {
-  const entries = (0, import_daemon_core.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
+  const entries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
   for (let i = entries.length - 1; i >= 0; i -= 1) {
     const entry = entries[i];
     const payload = entry.payload && typeof entry.payload === "object" && !Array.isArray(entry.payload) ? entry.payload : {};
@@ -4147,7 +4206,7 @@ function resolveCachedMeshSessionPreviewFromLedger(ctx, nodeId, sessionId) {
     const entrySessionId = readString(entry.sessionId) || readString(payload.targetSessionId) || readString(payload.sessionId) || readString(payload.instanceId);
     if (entrySessionId !== sessionId) continue;
     const metadataEvent = payload.metadataEvent && typeof payload.metadataEvent === "object" && !Array.isArray(payload.metadataEvent) ? payload.metadataEvent : payload;
-    const preview = (0, import_daemon_core.resolveMeshSurfacedSessionPreview)(metadataEvent);
+    const preview = (0, import_daemon_core2.resolveMeshSurfacedSessionPreview)(metadataEvent);
     if (preview) {
       return { ...preview, ledgerKind: entry.kind, timestamp: entry.timestamp };
     }
@@ -4155,7 +4214,7 @@ function resolveCachedMeshSessionPreviewFromLedger(ctx, nodeId, sessionId) {
   return void 0;
 }
 function buildMeshReadChatCacheFallback(ctx, args, node, error) {
-  const classification = (0, import_daemon_core.classifyP2pRelayFailure)(error, { command: "read_chat", targetDaemonId: node.daemonId });
+  const classification = (0, import_daemon_core2.classifyP2pRelayFailure)(error, { command: "read_chat", targetDaemonId: node.daemonId });
   const cause = classifyReadChatTransportCause(error);
   const errorMessage = error instanceof Error ? error.message : String(error ?? "");
   const causeNote = cause === "not_connected" ? "the worker daemon is not currently connected over P2P (no live channel)" : "the worker daemon is connected but saturated \u2014 it acknowledged the request but did not return the transcript within the deadline";
@@ -4225,7 +4284,7 @@ async function meshReadChat(ctx, args) {
       tailLimit: args.tail ?? 10
     });
   } catch (e) {
-    if (isLocalNode || !(0, import_daemon_core.isP2pRelayTransportFailure)(e)) throw e;
+    if (isLocalNode || !(0, import_daemon_core2.isP2pRelayTransportFailure)(e)) throw e;
     return buildMeshReadChatCacheFallback(ctx, args, node, e);
   }
   const payload = annotateRapidReadChatAdvisory(unwrapCommandPayload(result), {
@@ -4293,7 +4352,7 @@ async function meshLaunchSession(ctx, args) {
     const coordinatorNode = resolveCoordinatorNode(ctx);
     const coordinatorDaemonId = resolveCoordinatorDaemonId(ctx);
     const spawnedSessionVisibility = readSpawnedSessionVisibility(ctx.mesh.policy);
-    const delegatedWorkerAutoApprove = (0, import_daemon_core.resolveDelegatedWorkerAutoApprove)(ctx.mesh.policy, node.policy);
+    const delegatedWorkerAutoApprove = (0, import_daemon_core2.resolveDelegatedWorkerAutoApprove)(ctx.mesh.policy, node.policy);
     const isLocalNode = isLocalControlPlaneNode(ctx, node);
     if (node.daemonId && !isLocalNode && !coordinatorDaemonId) {
       return JSON.stringify(buildMissingCoordinatorDaemonIdFailure(ctx, node, resolvedProviderType), null, 2);
@@ -4340,7 +4399,7 @@ async function meshLaunchSession(ctx, args) {
       });
     }
     try {
-      (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+      (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
         kind: "session_launched",
         nodeId: args.node_id,
         sessionId: runtimeSessionId || void 0,
@@ -4493,7 +4552,7 @@ async function meshCheckpoint(ctx, args) {
     includeUntracked: true
   });
   try {
-    (0, import_daemon_core.appendLedgerEntry)(ctx.mesh.id, {
+    (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
       kind: "checkpoint_created",
       nodeId: args.node_id,
       payload: {
@@ -5958,6 +6017,9 @@ async function startMcpServer(opts) {
           case "mesh_task_history":
             text = await meshTaskHistory(meshCtx, a);
             break;
+          case "mesh_record_note":
+            text = await meshRecordNote(meshCtx, a);
+            break;
           case "mesh_reconcile_ledger":
             text = await meshReconcileLedger(meshCtx, a);
             break;