@adhdev/daemon-standalone 0.9.82-rc.376 → 0.9.82-rc.378

package/vendor/mcp-server/index.js

@@ -35,9 +35,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/tools/mesh-tools.ts
-var import_node_crypto = require("crypto");
-
 // src/transports/ipc.ts
 var DEFAULT_IPC_PORT = 19222;
 var DEFAULT_IPC_PATH = "/ipc";
@@ -341,47 +338,7 @@ function compactChatPayload(payload, opts = {}) {
   };
 }
 
-// src/tools/read-chat-polling-advisory.ts
-var RAPID_READ_CHAT_ADVISORY_WINDOW_MS = 5e3;
-var ACTIVE_READ_STATUSES = /* @__PURE__ */ new Set([
-  "generating",
-  "running",
-  "streaming",
-  "starting",
-  "busy"
-]);
-var recentReads = /* @__PURE__ */ new Map();
-function isActiveReadChatStatus(status) {
-  return typeof status === "string" && ACTIVE_READ_STATUSES.has(status.toLowerCase());
-}
-function annotateRapidReadChatAdvisory(payload, options) {
-  const now = options.now ?? Date.now();
-  const status = options.status ?? payload?.status ?? payload?.data?.status ?? payload?.result?.status;
-  const active = isActiveReadChatStatus(status);
-  const previous = recentReads.get(options.key);
-  if (!active) {
-    recentReads.set(options.key, { at: now, status: typeof status === "string" ? status : void 0 });
-    return payload;
-  }
-  recentReads.set(options.key, { at: now, status: typeof status === "string" ? status : void 0 });
-  if (!previous || !isActiveReadChatStatus(previous.status)) return payload;
-  const elapsedMs = now - previous.at;
-  if (elapsedMs < 0 || elapsedMs >= RAPID_READ_CHAT_ADVISORY_WINDOW_MS) return payload;
-  return {
-    ...payload,
-    pollingAdvisory: {
-      type: "rapid_read_chat_polling",
-      toolName: options.toolName,
-      windowMs: RAPID_READ_CHAT_ADVISORY_WINDOW_MS,
-      elapsedMs,
-      nextSuggestedReadAt: previous.at + RAPID_READ_CHAT_ADVISORY_WINDOW_MS,
-      completionCallbackExpected: Boolean(options.completionCallbackExpected),
-      message: `This session is still ${String(status)}. Avoid repeated ${options.toolName} polling for the same generating session; wait for the completion callback/status event or retry after the suggested time if you are debugging a real stall.`
-    }
-  };
-}
-
-// src/tools/mesh-tools.ts
+// src/tools/mesh-tools-internal.ts
 var import_daemon_core2 = require("@adhdev/daemon-core");
 
 // src/tools/mesh-tool-shared.ts
@@ -525,606 +482,219 @@ function isIdleSessionRecord(session) {
   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();
-  for (const node of Array.isArray(mesh?.nodes) ? mesh.nodes : []) {
-    const nodeId = readString(node.id) || readString(node.nodeId) || readString(node.node_id);
-    if (!nodeId) continue;
-    nodeIds.add(nodeId);
-    const sessions = collectNodeSessionIds(node);
-    if (sessions.size > 0) nodeSessionIds.set(nodeId, sessions);
-  }
-  return { nodeIds, nodeSessionIds };
-}
-function queueAssignmentStaleReason(task, liveness) {
-  if (task?.status !== "assigned") return void 0;
-  const nodeId = readString(task.assignedNodeId) || readString(task.nodeId) || readString(task.node_id) || readString(task.targetNodeId);
-  const sessionId = readString(task.assignedSessionId) || readString(task.sessionId) || readString(task.session_id) || readString(task.targetSessionId);
-  if (nodeId && liveness.nodeIds.size > 0 && !liveness.nodeIds.has(nodeId)) {
-    return "assigned node is not present in the current mesh snapshot";
+// 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 (nodeId && sessionId && liveness.nodeSessionIds.has(nodeId) && !liveness.nodeSessionIds.get(nodeId).has(sessionId)) {
-    return "assigned session is not live on the assigned node";
+  if (ctx.localMachineId) {
+    const byMachine = ctx.mesh.nodes.find((n) => readNodeMachineId(n) === ctx.localMachineId);
+    if (byMachine) return byMachine;
   }
-  const updatedAt = new Date(task.updatedAt).getTime();
-  const ageMs = Number.isFinite(updatedAt) ? Date.now() - updatedAt : null;
-  if (!nodeId && ageMs !== null && ageMs >= STALE_ASSIGNED_QUEUE_MS) {
-    return "assigned task has no assigned node metadata";
+  if (ctx.localDaemonId) {
+    return ctx.mesh.nodes.find((n) => readNodeDaemonId(n) === ctx.localDaemonId);
   }
   return void 0;
 }
-function buildQueueStatusSummary(queue) {
-  const counts = { pending: 0, assigned: 0, completed: 0, failed: 0, cancelled: 0 };
-  let staleAssigned = 0;
-  for (const task of queue) {
-    const status = typeof task?.status === "string" ? task.status : void 0;
-    if (status && Object.prototype.hasOwnProperty.call(counts, status)) {
-      counts[status] += 1;
-    }
-    if (status === "assigned" && task?.staleAssigned === true) staleAssigned += 1;
-  }
-  const liveAssigned = Math.max(0, counts.assigned - staleAssigned);
-  return {
-    totalCount: queue.length,
-    activeCount: counts.pending + liveAssigned,
-    historicalCount: counts.completed + counts.failed + counts.cancelled,
-    counts,
-    activeCounts: {
-      pending: counts.pending,
-      assigned: liveAssigned
-    },
-    staleAssignedCount: staleAssigned,
-    rawActiveCounts: {
-      pending: counts.pending,
-      assigned: counts.assigned
-    },
-    historicalCounts: {
-      completed: counts.completed,
-      failed: counts.failed,
-      cancelled: counts.cancelled
-    }
-  };
+function resolveCoordinatorDaemonId(ctx) {
+  return readString(resolveCoordinatorNode(ctx)?.daemonId) || readString(ctx.localDaemonId) || readString(ctx.localMachineId);
 }
-function normalizeQueueViewMode(value) {
-  return value === "active" || value === "historical" || value === "all" ? value : "all";
+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);
 }
-function sanitizeQueueStatusFilter(value) {
-  if (!Array.isArray(value)) return void 0;
-  const statuses = value.map((item) => typeof item === "string" ? item.trim() : "").filter((status) => ACTIVE_QUEUE_STATUSES.has(status) || HISTORICAL_QUEUE_STATUSES.has(status));
-  return statuses.length ? Array.from(new Set(statuses)) : void 0;
+function readNodeDaemonId(node) {
+  return readString(node.daemonId) || readString(node.daemon_id) || readString(node.machine?.daemonId) || readString(node.machine?.daemon_id) || readString(node.lastProbe?.daemonId) || readString(node.last_probe?.daemon_id) || readString(node.lastProbe?.machine?.daemonId) || readString(node.lastProbe?.machine?.daemon_id) || readString(node.last_probe?.machine?.daemonId) || readString(node.last_probe?.machine?.daemon_id);
 }
-function filterQueueForView(queue, view, statuses) {
-  if (statuses?.length) {
-    const allowed = new Set(statuses);
-    return queue.filter((task) => allowed.has(String(task?.status || "")));
-  }
-  if (view === "active") return queue.filter((task) => ACTIVE_QUEUE_STATUSES.has(String(task?.status || "")));
-  if (view === "historical") return queue.filter((task) => HISTORICAL_QUEUE_STATUSES.has(String(task?.status || "")));
-  return queue;
+function normalizeHostname(value) {
+  const hostname = readString(value);
+  if (!hostname) return void 0;
+  return hostname.toLowerCase().replace(/\.$/, "");
 }
-function prioritizeActiveQueueRows(queue) {
-  const active = [];
-  const historical = [];
-  const other = [];
-  for (const task of queue) {
-    const status = String(task?.status || "");
-    if (ACTIVE_QUEUE_STATUSES.has(status)) active.push(task);
-    else if (HISTORICAL_QUEUE_STATUSES.has(status)) historical.push(task);
-    else other.push(task);
-  }
-  return [...active, ...other, ...historical];
+function readNodeHostname(node) {
+  return readString(node.hostname) || readString(node.host) || readString(node.machineHostname) || readString(node.machine_hostname) || readString(node.machine?.hostname) || readString(node.machine?.host) || readString(node.lastProbe?.hostname) || readString(node.last_probe?.hostname) || readString(node.lastProbe?.machine?.hostname) || readString(node.last_probe?.machine?.hostname);
 }
-function slimQueueTask(task) {
-  return {
-    id: task?.id,
-    status: task?.status,
-    assignedNodeId: task?.assignedNodeId,
-    assignedSessionId: task?.assignedSessionId,
-    targetNodeId: task?.targetNodeId,
-    targetSessionId: task?.targetSessionId,
-    updatedAt: task?.updatedAt,
-    staleAssigned: task?.staleAssigned === true,
-    staleReason: task?.staleReason
-  };
+function readNodeDisplayMachineName(node) {
+  return readString(node.machineName) || readString(node.machine_name) || readString(node.machineLabel) || readString(node.machine_label) || readString(node.machineNickname) || readString(node.machine_nickname) || readString(node.alias) || readString(node.machine?.name) || readString(node.machine?.displayName) || readString(node.machine?.display_name) || readString(node.lastProbe?.machineName) || readString(node.last_probe?.machine_name) || readString(node.lastProbe?.machine?.name) || readString(node.last_probe?.machine?.name) || readNodeHostname(node);
 }
-function buildQueueMaintenanceReport(queue) {
-  const now = Date.now();
-  const staleAssignedTasks = queue.filter((task) => task?.status === "assigned" && task?.staleAssigned === true).map(slimQueueTask);
-  const historicalTasks = queue.filter((task) => HISTORICAL_QUEUE_STATUSES.has(String(task?.status || "")));
-  const oldHistoricalTasks = historicalTasks.filter((task) => {
-    const updatedAt = new Date(task?.updatedAt).getTime();
-    return Number.isFinite(updatedAt) && now - updatedAt >= OLD_HISTORICAL_QUEUE_RECORD_MS;
-  }).map((task) => ({
-    ...slimQueueTask(task),
-    cleanupClass: "old_historical_record",
-    reason: "terminal queue record is older than the read-only maintenance threshold"
-  }));
-  const cleanupCandidates = [
-    ...staleAssignedTasks.map((task) => ({
-      ...task,
-      cleanupClass: "stale_assigned",
-      reason: typeof task.staleReason === "string" ? task.staleReason : "active assigned task does not match current live mesh node/session state",
-      suggestedOperation: "operator_review_then_requeue_or_cancel"
-    })),
-    ...oldHistoricalTasks.map((task) => ({
-      ...task,
-      suggestedOperation: "operator_review_then_archive_or_keep"
-    }))
-  ];
+function compactIdentityEvidence(value) {
+  if (!value) return void 0;
+  return value.length > 24 ? `${value.slice(0, 12)}\u2026${value.slice(-8)}` : value;
+}
+function pushIdentityEvidence(evidence, label, value) {
+  const compact = compactIdentityEvidence(value);
+  if (compact) evidence.push(`${label}:${compact}`);
+}
+function buildNodeMachineIdentity(ctx, node) {
+  const machineId = readNodeMachineId(node);
+  const daemonId = readNodeDaemonId(node);
+  const hostname = readNodeHostname(node);
+  const machineName = readNodeDisplayMachineName(node);
+  const coordinatorHostname = readString(ctx.coordinatorHostname);
+  const localControlPlaneReason = getLocalControlPlaneMatchReason(ctx, node);
+  const directLocal = !!localControlPlaneReason;
+  const hostnameMatches = Boolean(
+    normalizeHostname(hostname) && normalizeHostname(coordinatorHostname) && normalizeHostname(hostname) === normalizeHostname(coordinatorHostname)
+  );
+  const sameMachine = directLocal || hostnameMatches;
+  const evidence = [];
+  pushIdentityEvidence(evidence, "machineName", machineName);
+  pushIdentityEvidence(evidence, "hostname", hostname);
+  pushIdentityEvidence(evidence, "machineId", machineId);
+  pushIdentityEvidence(evidence, "daemonId", daemonId);
+  if (localControlPlaneReason) {
+    pushIdentityEvidence(evidence, "localMatch", localControlPlaneReason);
+    pushIdentityEvidence(evidence, "localMachineId", ctx.localMachineId);
+    pushIdentityEvidence(evidence, "localDaemonId", ctx.localDaemonId);
+  }
+  const locality = sameMachine ? "same_machine" : evidence.length > 0 ? "remote_known" : "remote_or_unknown";
+  const localityReason = sameMachine ? localControlPlaneReason || "matched coordinator hostname" : evidence.length > 0 ? `known remote/other machine identity; no local coordinator match (${evidence.join(", ")})` : "no useful machine identity evidence available";
   return {
-    readOnly: true,
-    mutationPerformed: false,
-    sourceOfTruth: "mesh_work_queue_file",
-    staleAssignedDefinition: "Only active assigned queue rows are stale candidates, and only when the assigned node/session is absent from the current live mesh snapshot.",
-    historicalDefinition: "completed/failed/cancelled rows are historical ledger records and never active assignments.",
-    staleAssignedTasks,
-    staleAssignedCount: staleAssignedTasks.length,
-    historicalRecordCount: historicalTasks.length,
-    oldHistoricalRecordCount: oldHistoricalTasks.length,
-    cleanupCandidates,
-    cleanupCandidateCount: cleanupCandidates.length
+    daemonId,
+    machineId,
+    hostname,
+    machineName,
+    displayName: machineName || hostname || daemonId || machineId,
+    coordinatorHostname,
+    sameMachine,
+    locality,
+    localityReason,
+    identityEvidence: evidence
   };
 }
-function buildCompactQueueMaintenanceReport(maintenance) {
-  const staleAssignedTasks = Array.isArray(maintenance.staleAssignedTasks) ? maintenance.staleAssignedTasks : [];
-  const cleanupCandidateCount = maintenance.cleanupCandidateCount ?? 0;
-  return {
-    readOnly: true,
-    mutationPerformed: false,
-    sourceOfTruth: "mesh_work_queue_file",
-    payloadMode: "compact",
-    staleAssignedDefinition: maintenance.staleAssignedDefinition,
-    historicalDefinition: maintenance.historicalDefinition,
-    // staleAssignedTasks are active assigned rows (not historical) — retain a
-    // bounded sample so coordinators can still see drift without the full array.
-    staleAssignedTasks: staleAssignedTasks.slice(0, 5),
-    staleAssignedSampleLimit: 5,
-    staleAssignedCount: maintenance.staleAssignedCount ?? staleAssignedTasks.length,
-    historicalRecordCount: maintenance.historicalRecordCount ?? 0,
-    oldHistoricalRecordCount: maintenance.oldHistoricalRecordCount ?? 0,
-    cleanupCandidateCount,
-    cleanupCandidatesOmitted: true,
-    cleanupCandidatesHint: "Per-row cleanup candidates are omitted in compact mode; call mesh_view_queue with verbose=true for the full maintenance/cleanupDryRun rows."
+function nodeHasLocalDaemonEvidence(ctx, node) {
+  const isLocal = (session) => {
+    if (!session || typeof session !== "object") return false;
+    if (ctx.localDaemonId && (0, import_daemon_core.daemonIdsEquivalent)(session.runtime?.owner, ctx.localDaemonId)) return true;
+    if (ctx.localDaemonId && (0, import_daemon_core.daemonIdsEquivalent)(session.daemonClient?.daemonId, ctx.localDaemonId)) return true;
+    return false;
   };
-}
-var COMPACT_MAX_ACTIVE_QUEUE_ROWS = 15;
-var COMPACT_QUEUE_MESSAGE_CAP = 140;
-var COMPACT_MAX_ACTIVE_WORK_ROWS = 12;
-var COMPACT_ACTIVE_WORK_TITLE_CAP = 80;
-function truncateForCompact(value, cap) {
-  if (typeof value !== "string") return value;
-  return value.length > cap ? value.slice(0, cap) + "\u2026" : value;
-}
-function compactQueueRow(task) {
-  if (!task || typeof task !== "object") return task;
-  const slim = {};
-  for (const [k, v] of Object.entries(task)) {
-    if (k === "message") slim[k] = truncateForCompact(v, COMPACT_QUEUE_MESSAGE_CAP);
-    else slim[k] = elideLargeNestedValue(k, v);
+  const sessionArrays = [
+    node?.sessions,
+    node?.activeSessions,
+    node?.active_sessions,
+    node?.lastProbe?.sessions,
+    node?.last_probe?.sessions,
+    node?.lastProbe?.status?.sessions,
+    node?.last_probe?.status?.sessions
+  ];
+  for (const arr of sessionArrays) {
+    if (Array.isArray(arr) && arr.some(isLocal)) return true;
   }
-  return slim;
-}
-function compactQueueRows(rows) {
-  const capped = rows.slice(0, COMPACT_MAX_ACTIVE_QUEUE_ROWS).map(compactQueueRow);
-  return { rows: capped, omitted: Math.max(0, rows.length - capped.length) };
-}
-function compactActiveWorkRecord(record) {
-  if (!record || typeof record !== "object") return record;
-  const slim = {};
-  for (const [k, v] of Object.entries(record)) {
-    if (k === "message" || k === "taskSummary") continue;
-    else if (k === "taskTitle") slim[k] = truncateForCompact(v, COMPACT_ACTIVE_WORK_TITLE_CAP);
-    else slim[k] = elideLargeNestedValue(k, v);
+  const sessionRecords = [
+    node?.activeSession,
+    node?.active_session,
+    node?.currentSession,
+    node?.current_session,
+    node?.runtimeSession,
+    node?.runtime_session,
+    node?.session,
+    node?.lastProbe?.activeSession,
+    node?.last_probe?.active_session,
+    node?.lastProbe?.currentSession,
+    node?.last_probe?.current_session,
+    node?.lastProbe?.session,
+    node?.last_probe?.session
+  ];
+  for (const session of sessionRecords) {
+    if (isLocal(session)) return true;
   }
-  return slim;
+  return false;
 }
-function compactActiveWorkRecords(records) {
-  if (!Array.isArray(records)) return { records, omitted: 0 };
-  const capped = records.slice(0, COMPACT_MAX_ACTIVE_WORK_ROWS).map(compactActiveWorkRecord);
-  return { records: capped, omitted: Math.max(0, records.length - capped.length) };
+function isDirectLocalNode(ctx, node) {
+  const machineId = readNodeMachineId(node);
+  const daemonId = readNodeDaemonId(node);
+  return Boolean(
+    ctx.localMachineId && (0, import_daemon_core.daemonIdsEquivalent)(machineId, ctx.localMachineId) || ctx.localDaemonId && (0, import_daemon_core.daemonIdsEquivalent)(daemonId, ctx.localDaemonId) || nodeHasLocalDaemonEvidence(ctx, node)
+  );
 }
-function annotateQueueStaleness(queue, mesh) {
-  const liveness = buildQueueLivenessIndex(mesh);
-  const now = Date.now();
-  return queue.map((task) => {
-    const taskStatus = typeof task?.status === "string" ? task.status : void 0;
-    const annotated = {
-      ...task,
-      taskStatus,
-      isActive: taskStatus ? ACTIVE_QUEUE_STATUSES.has(taskStatus) : false,
-      isHistorical: taskStatus ? HISTORICAL_QUEUE_STATUSES.has(taskStatus) : false,
-      dispatchedAt: task?.createdAt,
-      ...taskStatus === "assigned" ? { activeTaskId: task.id } : {},
-      ...taskStatus === "completed" || taskStatus === "failed" ? {
-        completedAt: task.updatedAt
-      } : {}
-    };
-    if (taskStatus !== "assigned") return annotated;
-    const updatedAt = new Date(task.updatedAt).getTime();
-    const ageMs = Number.isFinite(updatedAt) ? now - updatedAt : null;
-    const staleReason = queueAssignmentStaleReason(task, liveness);
-    if (!staleReason) return annotated;
-    return {
-      ...annotated,
-      stale: true,
-      staleAssigned: true,
-      staleReason,
-      ...ageMs !== null ? { assignedAgeMs: ageMs } : {}
-    };
-  });
+function isConfiguredCoordinatorNode(ctx, node) {
+  if (!ctx.localMachineId && !ctx.localDaemonId) return false;
+  const nodeId = readString(node.id) || readString(node.nodeId) || readString(node.node_id);
+  if (!nodeId) return false;
+  const nodeDaemonId = readNodeDaemonId(node);
+  const nodeMachineId = readNodeMachineId(node);
+  if (nodeDaemonId && ctx.localDaemonId && !(0, import_daemon_core.daemonIdsEquivalent)(nodeDaemonId, ctx.localDaemonId)) return false;
+  if (nodeMachineId && ctx.localMachineId && !(0, import_daemon_core.daemonIdsEquivalent)(nodeMachineId, ctx.localMachineId)) return false;
+  const preferredNodeId = readString(ctx.mesh.coordinator?.preferredNodeId) || readString(ctx.mesh.coordinator?.preferred_node_id);
+  if (preferredNodeId) return nodeId === preferredNodeId;
+  const first = ctx.mesh.nodes?.[0];
+  const firstNodeId = readString(first?.id) || readString(first?.nodeId) || readString(first?.node_id);
+  return !!firstNodeId && nodeId === firstNodeId;
 }
-
-// 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];
+function getLocalControlPlaneMatchReason(ctx, node) {
+  if (isDirectLocalNode(ctx, node)) return "matched coordinator daemon or machine id";
+  if (isConfiguredCoordinatorNode(ctx, node)) return "matched configured coordinator node";
+  if (node.isLocalWorktree === true) {
+    const sourceNode = findClonedFromNode(ctx, node);
+    if (sourceNode && isDirectLocalNode(ctx, sourceNode)) return "matched local cloned-from node";
+    if (sourceNode && isConfiguredCoordinatorNode(ctx, sourceNode)) return "matched configured coordinator source node";
   }
-  return slim;
+  return 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 {
-    count: submodules.length,
-    ...outOfSync.length > 0 ? { outOfSyncPaths: outOfSync } : {}
-  };
+function findClonedFromNode(ctx, node) {
+  const clonedFromNodeId = readString(node.clonedFromNodeId) || readString(node.cloned_from_node_id);
+  if (!clonedFromNodeId) return void 0;
+  return ctx.mesh.nodes.find((n) => (0, import_daemon_core.meshNodeIdMatches)(n, clonedFromNodeId));
 }
-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;
+function resolvePreferredWorktreeNodeId(ctx) {
+  const worktreeNodes = (ctx.mesh.nodes || []).filter((n) => n.isLocalWorktree === true);
+  if (worktreeNodes.length === 0) return void 0;
+  const chosen = worktreeNodes[worktreeNodes.length - 1];
+  return readString(chosen?.id) || readString(chosen?.nodeId) || readString(chosen?.node_id);
+}
+function isLocalControlPlaneNode(ctx, node) {
+  return !!getLocalControlPlaneMatchReason(ctx, node);
+}
+
+// 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." }
     }
   }
-  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
-    };
+};
+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." }
+    }
   }
-  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;
-}
-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 minimalCompactNode(entry) {
-  if (!entry || typeof entry !== "object") return entry;
-  const bc = entry.branchConvergence && typeof entry.branchConvergence === "object" ? {
-    status: entry.branchConvergence.status,
-    needsConvergence: entry.branchConvergence.needsConvergence,
-    reason: entry.branchConvergence.reason,
-    branch: entry.branchConvergence.branch
-  } : void 0;
-  const preservedMarkers = {};
-  for (const field of MESH_COMPACT_PRESERVED_MARKER_FIELDS) {
-    if (entry[field] !== void 0) preservedMarkers[field] = entry[field];
-  }
-  return {
-    nodeId: entry.nodeId,
-    workspace: entry.workspace,
-    daemonId: entry.daemonId,
-    health: entry.health,
-    branch: entry.branch,
-    launchReady: entry.launchReady,
-    ...entry.providerPriority !== void 0 ? { providerPriority: entry.providerPriority } : {},
-    // Keep the routable tag set on quiet/folded nodes — a coordinator planning
-    // required_tags routing needs it even for nodes with nothing to converge.
-    ...entry.capabilityTags !== void 0 ? { capabilityTags: entry.capabilityTags } : {},
-    ...entry.launchBlockedReason !== void 0 ? { launchBlockedReason: entry.launchBlockedReason } : {},
-    ...bc ? { branchConvergence: bc } : {},
-    ...entry.sessionSummary ? { sessionSummary: entry.sessionSummary } : {},
-    ...preservedMarkers,
-    folded: true
-  };
-}
-function summarizeNodeSessions(sessions) {
-  const list = Array.isArray(sessions) ? sessions : [];
-  const byStatus = {};
-  const providerCounts = {};
-  const selfCoordinatorSessionIds = [];
-  for (const s of list) {
-    const status = typeof s?.status === "string" && s.status ? s.status : "unknown";
-    byStatus[status] = (byStatus[status] ?? 0) + 1;
-    const provider = typeof s?.providerType === "string" && s.providerType ? s.providerType : "unknown";
-    providerCounts[provider] = (providerCounts[provider] ?? 0) + 1;
-    if (s?.isSelfCoordinator === true && s.id) selfCoordinatorSessionIds.push(String(s.id));
-  }
-  const summary = {
-    total: list.length,
-    byStatus,
-    providerCounts
-  };
-  if (selfCoordinatorSessionIds.length > 0) {
-    summary.selfCoordinatorSessionIds = selfCoordinatorSessionIds;
-  }
-  return summary;
-}
-
-// 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 (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 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);
-}
-function readNodeDaemonId(node) {
-  return readString(node.daemonId) || readString(node.daemon_id) || readString(node.machine?.daemonId) || readString(node.machine?.daemon_id) || readString(node.lastProbe?.daemonId) || readString(node.last_probe?.daemon_id) || readString(node.lastProbe?.machine?.daemonId) || readString(node.lastProbe?.machine?.daemon_id) || readString(node.last_probe?.machine?.daemonId) || readString(node.last_probe?.machine?.daemon_id);
-}
-function normalizeHostname(value) {
-  const hostname = readString(value);
-  if (!hostname) return void 0;
-  return hostname.toLowerCase().replace(/\.$/, "");
-}
-function readNodeHostname(node) {
-  return readString(node.hostname) || readString(node.host) || readString(node.machineHostname) || readString(node.machine_hostname) || readString(node.machine?.hostname) || readString(node.machine?.host) || readString(node.lastProbe?.hostname) || readString(node.last_probe?.hostname) || readString(node.lastProbe?.machine?.hostname) || readString(node.last_probe?.machine?.hostname);
-}
-function readNodeDisplayMachineName(node) {
-  return readString(node.machineName) || readString(node.machine_name) || readString(node.machineLabel) || readString(node.machine_label) || readString(node.machineNickname) || readString(node.machine_nickname) || readString(node.alias) || readString(node.machine?.name) || readString(node.machine?.displayName) || readString(node.machine?.display_name) || readString(node.lastProbe?.machineName) || readString(node.last_probe?.machine_name) || readString(node.lastProbe?.machine?.name) || readString(node.last_probe?.machine?.name) || readNodeHostname(node);
-}
-function compactIdentityEvidence(value) {
-  if (!value) return void 0;
-  return value.length > 24 ? `${value.slice(0, 12)}\u2026${value.slice(-8)}` : value;
-}
-function pushIdentityEvidence(evidence, label, value) {
-  const compact = compactIdentityEvidence(value);
-  if (compact) evidence.push(`${label}:${compact}`);
-}
-function buildNodeMachineIdentity(ctx, node) {
-  const machineId = readNodeMachineId(node);
-  const daemonId = readNodeDaemonId(node);
-  const hostname = readNodeHostname(node);
-  const machineName = readNodeDisplayMachineName(node);
-  const coordinatorHostname = readString(ctx.coordinatorHostname);
-  const localControlPlaneReason = getLocalControlPlaneMatchReason(ctx, node);
-  const directLocal = !!localControlPlaneReason;
-  const hostnameMatches = Boolean(
-    normalizeHostname(hostname) && normalizeHostname(coordinatorHostname) && normalizeHostname(hostname) === normalizeHostname(coordinatorHostname)
-  );
-  const sameMachine = directLocal || hostnameMatches;
-  const evidence = [];
-  pushIdentityEvidence(evidence, "machineName", machineName);
-  pushIdentityEvidence(evidence, "hostname", hostname);
-  pushIdentityEvidence(evidence, "machineId", machineId);
-  pushIdentityEvidence(evidence, "daemonId", daemonId);
-  if (localControlPlaneReason) {
-    pushIdentityEvidence(evidence, "localMatch", localControlPlaneReason);
-    pushIdentityEvidence(evidence, "localMachineId", ctx.localMachineId);
-    pushIdentityEvidence(evidence, "localDaemonId", ctx.localDaemonId);
-  }
-  const locality = sameMachine ? "same_machine" : evidence.length > 0 ? "remote_known" : "remote_or_unknown";
-  const localityReason = sameMachine ? localControlPlaneReason || "matched coordinator hostname" : evidence.length > 0 ? `known remote/other machine identity; no local coordinator match (${evidence.join(", ")})` : "no useful machine identity evidence available";
-  return {
-    daemonId,
-    machineId,
-    hostname,
-    machineName,
-    displayName: machineName || hostname || daemonId || machineId,
-    coordinatorHostname,
-    sameMachine,
-    locality,
-    localityReason,
-    identityEvidence: evidence
-  };
-}
-function nodeHasLocalDaemonEvidence(ctx, node) {
-  const isLocal = (session) => {
-    if (!session || typeof session !== "object") return false;
-    if (ctx.localDaemonId && session.runtime?.owner === ctx.localDaemonId) return true;
-    if (ctx.localDaemonId && session.daemonClient?.daemonId === ctx.localDaemonId) return true;
-    return false;
-  };
-  const sessionArrays = [
-    node?.sessions,
-    node?.activeSessions,
-    node?.active_sessions,
-    node?.lastProbe?.sessions,
-    node?.last_probe?.sessions,
-    node?.lastProbe?.status?.sessions,
-    node?.last_probe?.status?.sessions
-  ];
-  for (const arr of sessionArrays) {
-    if (Array.isArray(arr) && arr.some(isLocal)) return true;
-  }
-  const sessionRecords = [
-    node?.activeSession,
-    node?.active_session,
-    node?.currentSession,
-    node?.current_session,
-    node?.runtimeSession,
-    node?.runtime_session,
-    node?.session,
-    node?.lastProbe?.activeSession,
-    node?.last_probe?.active_session,
-    node?.lastProbe?.currentSession,
-    node?.last_probe?.current_session,
-    node?.lastProbe?.session,
-    node?.last_probe?.session
-  ];
-  for (const session of sessionRecords) {
-    if (isLocal(session)) return true;
-  }
-  return false;
-}
-function isDirectLocalNode(ctx, node) {
-  const machineId = readNodeMachineId(node);
-  const daemonId = readNodeDaemonId(node);
-  return Boolean(
-    ctx.localMachineId && (0, import_daemon_core.daemonIdsEquivalent)(machineId, ctx.localMachineId) || ctx.localDaemonId && (0, import_daemon_core.daemonIdsEquivalent)(daemonId, ctx.localDaemonId) || nodeHasLocalDaemonEvidence(ctx, node)
-  );
-}
-function isConfiguredCoordinatorNode(ctx, node) {
-  if (!ctx.localMachineId && !ctx.localDaemonId) return false;
-  const nodeId = readString(node.id) || readString(node.nodeId) || readString(node.node_id);
-  if (!nodeId) return false;
-  const nodeDaemonId = readNodeDaemonId(node);
-  const nodeMachineId = readNodeMachineId(node);
-  if (nodeDaemonId && ctx.localDaemonId && !(0, import_daemon_core.daemonIdsEquivalent)(nodeDaemonId, ctx.localDaemonId)) return false;
-  if (nodeMachineId && ctx.localMachineId && !(0, import_daemon_core.daemonIdsEquivalent)(nodeMachineId, ctx.localMachineId)) return false;
-  const preferredNodeId = readString(ctx.mesh.coordinator?.preferredNodeId) || readString(ctx.mesh.coordinator?.preferred_node_id);
-  if (preferredNodeId) return nodeId === preferredNodeId;
-  const first = ctx.mesh.nodes?.[0];
-  const firstNodeId = readString(first?.id) || readString(first?.nodeId) || readString(first?.node_id);
-  return !!firstNodeId && nodeId === firstNodeId;
-}
-function getLocalControlPlaneMatchReason(ctx, node) {
-  if (isDirectLocalNode(ctx, node)) return "matched coordinator daemon or machine id";
-  if (isConfiguredCoordinatorNode(ctx, node)) return "matched configured coordinator node";
-  if (node.isLocalWorktree === true) {
-    const sourceNode = findClonedFromNode(ctx, node);
-    if (sourceNode && isDirectLocalNode(ctx, sourceNode)) return "matched local cloned-from node";
-    if (sourceNode && isConfiguredCoordinatorNode(ctx, sourceNode)) return "matched configured coordinator source node";
-  }
-  return void 0;
-}
-function findClonedFromNode(ctx, node) {
-  const clonedFromNodeId = readString(node.clonedFromNodeId) || readString(node.cloned_from_node_id);
-  if (!clonedFromNodeId) return void 0;
-  return ctx.mesh.nodes.find((n) => (0, import_daemon_core.meshNodeIdMatches)(n, clonedFromNodeId));
-}
-function resolvePreferredWorktreeNodeId(ctx) {
-  const worktreeNodes = (ctx.mesh.nodes || []).filter((n) => n.isLocalWorktree === true);
-  if (worktreeNodes.length === 0) return void 0;
-  const chosen = worktreeNodes[worktreeNodes.length - 1];
-  return readString(chosen?.id) || readString(chosen?.nodeId) || readString(chosen?.node_id);
-}
-function isLocalControlPlaneNode(ctx, node) {
-  return !!getLocalControlPlaneMatchReason(ctx, node);
-}
-
-// 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." }
-    }
-  }
-};
-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." }
-    }
-  }
-};
-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"]
+};
+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"]
   }
 };
 var MESH_VIEW_QUEUE_TOOL = {
@@ -1231,7 +801,8 @@ var MESH_LAUNCH_SESSION_TOOL = {
     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." }
+      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." },
+      force: { type: "boolean", description: "Set true to launch an ADDITIONAL session even when this node already has a live mesh-owned worker session. Default false: if a live worker session for this mesh+node already exists (e.g. an enqueue auto-launch just spawned one), the existing session is returned idempotently instead of creating an empty duplicate. Only pass force when you intentionally want a second concurrent provider/session on the node." }
     },
     required: ["node_id"]
   }
@@ -1345,269 +916,698 @@ var MESH_APPROVE_TOOL = {
     required: ["node_id", "session_id", "action"]
   }
 };
-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.",
+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"]
+  }
+};
+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"]
+  }
+};
+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"]
+  }
+};
+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." }
+    }
+  }
+};
+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: {
+      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: ["text"]
+  }
+};
+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." }
+    }
+  }
+};
+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." }
+    }
+  }
+};
+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"]
+  }
+};
+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: []
+  }
+};
+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." }
+    }
+  }
+};
+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." }
+    }
+  }
+};
+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." }
+    }
+  }
+};
+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." }
+    }
+  }
+};
+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: {
-      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"]
+      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_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.",
+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 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." }
+      node_id: { type: "string", description: "Node ID of the worktree node to plan." }
     },
     required: ["node_id"]
   }
 };
-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.",
+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: {
-      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." }
+      mesh_id: { type: "string", description: "Mesh ID (optional \u2014 inferred from active mesh if omitted)." }
     },
-    required: ["node_id", "mode"]
+    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-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 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;
+}
+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 minimalCompactNode(entry) {
+  if (!entry || typeof entry !== "object") return entry;
+  const bc = entry.branchConvergence && typeof entry.branchConvergence === "object" ? {
+    status: entry.branchConvergence.status,
+    needsConvergence: entry.branchConvergence.needsConvergence,
+    reason: entry.branchConvergence.reason,
+    branch: entry.branchConvergence.branch
+  } : void 0;
+  const preservedMarkers = {};
+  for (const field of MESH_COMPACT_PRESERVED_MARKER_FIELDS) {
+    if (entry[field] !== void 0) preservedMarkers[field] = entry[field];
+  }
+  return {
+    nodeId: entry.nodeId,
+    workspace: entry.workspace,
+    daemonId: entry.daemonId,
+    health: entry.health,
+    branch: entry.branch,
+    launchReady: entry.launchReady,
+    ...entry.providerPriority !== void 0 ? { providerPriority: entry.providerPriority } : {},
+    // Keep the routable tag set on quiet/folded nodes — a coordinator planning
+    // required_tags routing needs it even for nodes with nothing to converge.
+    ...entry.capabilityTags !== void 0 ? { capabilityTags: entry.capabilityTags } : {},
+    ...entry.launchBlockedReason !== void 0 ? { launchBlockedReason: entry.launchBlockedReason } : {},
+    ...bc ? { branchConvergence: bc } : {},
+    ...entry.sessionSummary ? { sessionSummary: entry.sessionSummary } : {},
+    ...preservedMarkers,
+    folded: true
+  };
+}
+function summarizeNodeSessions(sessions) {
+  const list = Array.isArray(sessions) ? sessions : [];
+  const byStatus = {};
+  const providerCounts = {};
+  const selfCoordinatorSessionIds = [];
+  for (const s of list) {
+    const status = typeof s?.status === "string" && s.status ? s.status : "unknown";
+    byStatus[status] = (byStatus[status] ?? 0) + 1;
+    const provider = typeof s?.providerType === "string" && s.providerType ? s.providerType : "unknown";
+    providerCounts[provider] = (providerCounts[provider] ?? 0) + 1;
+    if (s?.isSelfCoordinator === true && s.id) selfCoordinatorSessionIds.push(String(s.id));
+  }
+  const summary = {
+    total: list.length,
+    byStatus,
+    providerCounts
+  };
+  if (selfCoordinatorSessionIds.length > 0) {
+    summary.selfCoordinatorSessionIds = selfCoordinatorSessionIds;
+  }
+  return summary;
+}
+
+// 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();
+  for (const node of Array.isArray(mesh?.nodes) ? mesh.nodes : []) {
+    const nodeId = readString(node.id) || readString(node.nodeId) || readString(node.node_id);
+    if (!nodeId) continue;
+    nodeIds.add(nodeId);
+    const sessions = collectNodeSessionIds(node);
+    if (sessions.size > 0) nodeSessionIds.set(nodeId, sessions);
   }
-};
-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." }
-    }
+  return { nodeIds, nodeSessionIds };
+}
+function queueAssignmentStaleReason(task, liveness) {
+  if (task?.status !== "assigned") return void 0;
+  const nodeId = readString(task.assignedNodeId) || readString(task.nodeId) || readString(task.node_id) || readString(task.targetNodeId);
+  const sessionId = readString(task.assignedSessionId) || readString(task.sessionId) || readString(task.session_id) || readString(task.targetSessionId);
+  if (nodeId && liveness.nodeIds.size > 0 && !liveness.nodeIds.has(nodeId)) {
+    return "assigned node is not present in the current mesh snapshot";
   }
-};
-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: {
-      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: ["text"]
+  if (nodeId && sessionId && liveness.nodeSessionIds.has(nodeId) && !liveness.nodeSessionIds.get(nodeId).has(sessionId)) {
+    return "assigned session is not live on the assigned node";
   }
-};
-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." }
-    }
+  const updatedAt = new Date(task.updatedAt).getTime();
+  const ageMs = Number.isFinite(updatedAt) ? Date.now() - updatedAt : null;
+  if (!nodeId && ageMs !== null && ageMs >= STALE_ASSIGNED_QUEUE_MS) {
+    return "assigned task has no assigned node metadata";
   }
-};
-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." }
+  return void 0;
+}
+function buildQueueStatusSummary(queue) {
+  const counts = { pending: 0, assigned: 0, completed: 0, failed: 0, cancelled: 0 };
+  let staleAssigned = 0;
+  for (const task of queue) {
+    const status = typeof task?.status === "string" ? task.status : void 0;
+    if (status && Object.prototype.hasOwnProperty.call(counts, status)) {
+      counts[status] += 1;
     }
+    if (status === "assigned" && task?.staleAssigned === true) staleAssigned += 1;
   }
-};
-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." }
+  const liveAssigned = Math.max(0, counts.assigned - staleAssigned);
+  return {
+    totalCount: queue.length,
+    activeCount: counts.pending + liveAssigned,
+    historicalCount: counts.completed + counts.failed + counts.cancelled,
+    counts,
+    activeCounts: {
+      pending: counts.pending,
+      assigned: liveAssigned
     },
-    required: ["node_id"]
-  }
-};
-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." }
+    staleAssignedCount: staleAssigned,
+    rawActiveCounts: {
+      pending: counts.pending,
+      assigned: counts.assigned
     },
-    required: []
-  }
-};
-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." }
+    historicalCounts: {
+      completed: counts.completed,
+      failed: counts.failed,
+      cancelled: counts.cancelled
     }
+  };
+}
+function normalizeQueueViewMode(value) {
+  return value === "active" || value === "historical" || value === "all" ? value : "all";
+}
+function sanitizeQueueStatusFilter(value) {
+  if (!Array.isArray(value)) return void 0;
+  const statuses = value.map((item) => typeof item === "string" ? item.trim() : "").filter((status) => ACTIVE_QUEUE_STATUSES.has(status) || HISTORICAL_QUEUE_STATUSES.has(status));
+  return statuses.length ? Array.from(new Set(statuses)) : void 0;
+}
+function filterQueueForView(queue, view, statuses) {
+  if (statuses?.length) {
+    const allowed = new Set(statuses);
+    return queue.filter((task) => allowed.has(String(task?.status || "")));
   }
-};
-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." }
-    }
+  if (view === "active") return queue.filter((task) => ACTIVE_QUEUE_STATUSES.has(String(task?.status || "")));
+  if (view === "historical") return queue.filter((task) => HISTORICAL_QUEUE_STATUSES.has(String(task?.status || "")));
+  return queue;
+}
+function prioritizeActiveQueueRows(queue) {
+  const active = [];
+  const historical = [];
+  const other = [];
+  for (const task of queue) {
+    const status = String(task?.status || "");
+    if (ACTIVE_QUEUE_STATUSES.has(status)) active.push(task);
+    else if (HISTORICAL_QUEUE_STATUSES.has(status)) historical.push(task);
+    else other.push(task);
+  }
+  return [...active, ...other, ...historical];
+}
+function slimQueueTask(task) {
+  return {
+    id: task?.id,
+    status: task?.status,
+    assignedNodeId: task?.assignedNodeId,
+    assignedSessionId: task?.assignedSessionId,
+    targetNodeId: task?.targetNodeId,
+    targetSessionId: task?.targetSessionId,
+    updatedAt: task?.updatedAt,
+    staleAssigned: task?.staleAssigned === true,
+    staleReason: task?.staleReason
+  };
+}
+function buildQueueMaintenanceReport(queue) {
+  const now = Date.now();
+  const staleAssignedTasks = queue.filter((task) => task?.status === "assigned" && task?.staleAssigned === true).map(slimQueueTask);
+  const historicalTasks = queue.filter((task) => HISTORICAL_QUEUE_STATUSES.has(String(task?.status || "")));
+  const oldHistoricalTasks = historicalTasks.filter((task) => {
+    const updatedAt = new Date(task?.updatedAt).getTime();
+    return Number.isFinite(updatedAt) && now - updatedAt >= OLD_HISTORICAL_QUEUE_RECORD_MS;
+  }).map((task) => ({
+    ...slimQueueTask(task),
+    cleanupClass: "old_historical_record",
+    reason: "terminal queue record is older than the read-only maintenance threshold"
+  }));
+  const cleanupCandidates = [
+    ...staleAssignedTasks.map((task) => ({
+      ...task,
+      cleanupClass: "stale_assigned",
+      reason: typeof task.staleReason === "string" ? task.staleReason : "active assigned task does not match current live mesh node/session state",
+      suggestedOperation: "operator_review_then_requeue_or_cancel"
+    })),
+    ...oldHistoricalTasks.map((task) => ({
+      ...task,
+      suggestedOperation: "operator_review_then_archive_or_keep"
+    }))
+  ];
+  return {
+    readOnly: true,
+    mutationPerformed: false,
+    sourceOfTruth: "mesh_work_queue_file",
+    staleAssignedDefinition: "Only active assigned queue rows are stale candidates, and only when the assigned node/session is absent from the current live mesh snapshot.",
+    historicalDefinition: "completed/failed/cancelled rows are historical ledger records and never active assignments.",
+    staleAssignedTasks,
+    staleAssignedCount: staleAssignedTasks.length,
+    historicalRecordCount: historicalTasks.length,
+    oldHistoricalRecordCount: oldHistoricalTasks.length,
+    cleanupCandidates,
+    cleanupCandidateCount: cleanupCandidates.length
+  };
+}
+function buildCompactQueueMaintenanceReport(maintenance) {
+  const staleAssignedTasks = Array.isArray(maintenance.staleAssignedTasks) ? maintenance.staleAssignedTasks : [];
+  const cleanupCandidateCount = maintenance.cleanupCandidateCount ?? 0;
+  return {
+    readOnly: true,
+    mutationPerformed: false,
+    sourceOfTruth: "mesh_work_queue_file",
+    payloadMode: "compact",
+    staleAssignedDefinition: maintenance.staleAssignedDefinition,
+    historicalDefinition: maintenance.historicalDefinition,
+    // staleAssignedTasks are active assigned rows (not historical) — retain a
+    // bounded sample so coordinators can still see drift without the full array.
+    staleAssignedTasks: staleAssignedTasks.slice(0, 5),
+    staleAssignedSampleLimit: 5,
+    staleAssignedCount: maintenance.staleAssignedCount ?? staleAssignedTasks.length,
+    historicalRecordCount: maintenance.historicalRecordCount ?? 0,
+    oldHistoricalRecordCount: maintenance.oldHistoricalRecordCount ?? 0,
+    cleanupCandidateCount,
+    cleanupCandidatesOmitted: true,
+    cleanupCandidatesHint: "Per-row cleanup candidates are omitted in compact mode; call mesh_view_queue with verbose=true for the full maintenance/cleanupDryRun rows."
+  };
+}
+var COMPACT_MAX_ACTIVE_QUEUE_ROWS = 15;
+var COMPACT_QUEUE_MESSAGE_CAP = 140;
+var COMPACT_MAX_ACTIVE_WORK_ROWS = 12;
+var COMPACT_ACTIVE_WORK_TITLE_CAP = 80;
+function truncateForCompact(value, cap) {
+  if (typeof value !== "string") return value;
+  return value.length > cap ? value.slice(0, cap) + "\u2026" : value;
+}
+function compactQueueRow(task) {
+  if (!task || typeof task !== "object") return task;
+  const slim = {};
+  for (const [k, v] of Object.entries(task)) {
+    if (k === "message") slim[k] = truncateForCompact(v, COMPACT_QUEUE_MESSAGE_CAP);
+    else slim[k] = elideLargeNestedValue(k, v);
   }
-};
-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 slim;
+}
+function compactQueueRows(rows) {
+  const capped = rows.slice(0, COMPACT_MAX_ACTIVE_QUEUE_ROWS).map(compactQueueRow);
+  return { rows: capped, omitted: Math.max(0, rows.length - capped.length) };
+}
+function compactActiveWorkRecord(record) {
+  if (!record || typeof record !== "object") return record;
+  const slim = {};
+  for (const [k, v] of Object.entries(record)) {
+    if (k === "message" || k === "taskSummary") continue;
+    else if (k === "taskTitle") slim[k] = truncateForCompact(v, COMPACT_ACTIVE_WORK_TITLE_CAP);
+    else slim[k] = elideLargeNestedValue(k, v);
   }
-};
-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." }
-    }
+  return slim;
+}
+function compactActiveWorkRecords(records) {
+  if (!Array.isArray(records)) return { records, omitted: 0 };
+  const capped = records.slice(0, COMPACT_MAX_ACTIVE_WORK_ROWS).map(compactActiveWorkRecord);
+  return { records: capped, omitted: Math.max(0, records.length - capped.length) };
+}
+function annotateQueueStaleness(queue, mesh) {
+  const liveness = buildQueueLivenessIndex(mesh);
+  const now = Date.now();
+  return queue.map((task) => {
+    const taskStatus = typeof task?.status === "string" ? task.status : void 0;
+    const annotated = {
+      ...task,
+      taskStatus,
+      isActive: taskStatus ? ACTIVE_QUEUE_STATUSES.has(taskStatus) : false,
+      isHistorical: taskStatus ? HISTORICAL_QUEUE_STATUSES.has(taskStatus) : false,
+      dispatchedAt: task?.createdAt,
+      ...taskStatus === "assigned" ? { activeTaskId: task.id } : {},
+      ...taskStatus === "completed" || taskStatus === "failed" ? {
+        completedAt: task.updatedAt
+      } : {}
+    };
+    if (taskStatus !== "assigned") return annotated;
+    const updatedAt = new Date(task.updatedAt).getTime();
+    const ageMs = Number.isFinite(updatedAt) ? now - updatedAt : null;
+    const staleReason = queueAssignmentStaleReason(task, liveness);
+    if (!staleReason) return annotated;
+    return {
+      ...annotated,
+      stale: true,
+      staleAssigned: true,
+      staleReason,
+      ...ageMs !== null ? { assignedAgeMs: ageMs } : {}
+    };
+  });
+}
+
+// src/tools/read-chat-polling-advisory.ts
+var RAPID_READ_CHAT_ADVISORY_WINDOW_MS = 5e3;
+var ACTIVE_READ_STATUSES = /* @__PURE__ */ new Set([
+  "generating",
+  "running",
+  "streaming",
+  "starting",
+  "busy"
+]);
+var recentReads = /* @__PURE__ */ new Map();
+function isActiveReadChatStatus(status) {
+  return typeof status === "string" && ACTIVE_READ_STATUSES.has(status.toLowerCase());
+}
+function annotateRapidReadChatAdvisory(payload, options) {
+  const now = options.now ?? Date.now();
+  const status = options.status ?? payload?.status ?? payload?.data?.status ?? payload?.result?.status;
+  const active = isActiveReadChatStatus(status);
+  const previous = recentReads.get(options.key);
+  if (!active) {
+    recentReads.set(options.key, { at: now, status: typeof status === "string" ? status : void 0 });
+    return payload;
   }
-};
-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)." }
+  recentReads.set(options.key, { at: now, status: typeof status === "string" ? status : void 0 });
+  if (!previous || !isActiveReadChatStatus(previous.status)) return payload;
+  const elapsedMs = now - previous.at;
+  if (elapsedMs < 0 || elapsedMs >= RAPID_READ_CHAT_ADVISORY_WINDOW_MS) return payload;
+  return {
+    ...payload,
+    pollingAdvisory: {
+      type: "rapid_read_chat_polling",
+      toolName: options.toolName,
+      windowMs: RAPID_READ_CHAT_ADVISORY_WINDOW_MS,
+      elapsedMs,
+      nextSuggestedReadAt: previous.at + RAPID_READ_CHAT_ADVISORY_WINDOW_MS,
+      completionCallbackExpected: Boolean(options.completionCallbackExpected),
+      message: `This session is still ${String(status)}. Avoid repeated ${options.toolName} polling for the same generating session; wait for the completion callback/status event or retry after the suggested time if you are debugging a real stall.`
     }
-  }
-};
-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_RECORD_NOTE_TOOL,
-  MESH_RECONCILE_LEDGER_TOOL,
-  MESH_MISSION_UPSERT_TOOL,
-  MESH_MISSION_LIST_TOOL,
-  MESH_REVIEW_INBOX_TOOL
-];
+  };
+}
 
-// src/tools/mesh-tools.ts
+// src/tools/mesh-tools-internal.ts
+var import_daemon_core3 = require("@adhdev/daemon-core");
+var import_node_crypto = require("crypto");
 var SESSION_PROVIDER_METADATA_TTL_MS = 30 * 6e4;
 var meshSessionProviderMetadata = /* @__PURE__ */ new Map();
 function getSessionMetadata(key) {
@@ -2821,32 +2821,115 @@ async function drainCoordinatorPendingEvents(ctx, opts) {
         rememberMeshSessionProviderMetadataFromEvent({ ...event, metadataEvent: payload });
         if (!injected) surfacedEvents.push(event);
       }
-    } catch {
-    }
-    return surfacedEvents;
+    } catch {
+    }
+    return surfacedEvents;
+  }
+  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
+  };
+}
+function classifyReadChatTransportCause(error) {
+  const message = (error instanceof Error ? error.message : String(error ?? "")).toLowerCase();
+  if (/not acknowledged|delivery failure|channel never opened|connect timed out|not connected|datachannel|disconnected|\bclosed\b|offline|no route|failed to initiate p2p|p2p mesh is not available|connect queue full/.test(message)) {
+    return "not_connected";
+  }
+  return "saturated";
+}
+function resolveCachedMeshSessionPreviewFromLedger(ctx, nodeId, sessionId) {
+  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 : {};
+    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 !== sessionId) continue;
+    const metadataEvent = payload.metadataEvent && typeof payload.metadataEvent === "object" && !Array.isArray(payload.metadataEvent) ? payload.metadataEvent : payload;
+    const preview = (0, import_daemon_core2.resolveMeshSurfacedSessionPreview)(metadataEvent);
+    if (preview) {
+      return { ...preview, ledgerKind: entry.kind, timestamp: entry.timestamp };
+    }
+  }
+  return void 0;
+}
+function buildMeshReadChatCacheFallback(ctx, args, node, error) {
+  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";
+  const cached = resolveCachedMeshSessionPreviewFromLedger(ctx, args.node_id, args.session_id);
+  if (cached) {
+    return JSON.stringify({
+      success: true,
+      source: "coordinator_cache_fallback",
+      fallback: true,
+      nodeId: args.node_id,
+      sessionId: args.session_id,
+      transport: "p2p",
+      transportFailure: {
+        code: classification.code,
+        reason: classification.reason,
+        cause,
+        error: errorMessage
+      },
+      advisory: `Live transcript unavailable (${causeNote}). Showing the cached coordinator-side summary surfaced from the worker's last completion/status event \u2014 a stale point-in-time summary, NOT the live transcript. The full transcript requires a live P2P read_chat once the peer is reachable.`,
+      fullTranscriptRequiresP2p: true,
+      summary: cached.preview,
+      messages: [{
+        role: cached.role,
+        content: cached.preview,
+        cached: true,
+        ...cached.receivedAt ? { receivedAt: cached.receivedAt } : {}
+      }],
+      cachedPreview: {
+        role: cached.role,
+        ledgerKind: cached.ledgerKind,
+        ledgerTimestamp: cached.timestamp,
+        ...cached.receivedAt ? { receivedAt: cached.receivedAt } : {}
+      }
+    }, null, 2);
   }
-  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);
+  const failure = buildCoordinatorP2pRelayFailure(error, {
+    command: "read_chat",
+    targetDaemonId: node.daemonId,
+    nodeId: args.node_id,
+    sessionId: args.session_id
+  });
+  return JSON.stringify({
+    ...failure,
+    cause,
+    cachedSummaryAvailable: false,
+    fullTranscriptRequiresP2p: true,
+    advisory: `Live transcript unavailable (${causeNote}) and no cached coordinator-side summary exists for this session yet (no completion/status event has been surfaced). The full transcript requires a live P2P read_chat once the peer is reachable.`
+  }, null, 2);
 }
-function buildRemoveNodeArgs(ctx, nodeId, sessionCleanupMode, force) {
-  return {
-    meshId: ctx.mesh.id,
-    nodeId,
-    ...sessionCleanupMode ? { sessionCleanupMode } : {},
-    ...force === true ? { force: true } : {},
-    inlineMesh: ctx.mesh
-  };
+function resolveRefineConfigNode(ctx, nodeId) {
+  if (nodeId) return findNode(ctx.mesh, nodeId);
+  const node = ctx.mesh.nodes.find((entry) => !!entry.workspace);
+  if (!node) throw new Error("No mesh node with a workspace is available");
+  return node;
 }
+
+// src/tools/mesh-tools-status.ts
 async function meshStatus(ctx, args = {}) {
-  const rateResult = (0, import_daemon_core2.recordMeshToolCall)({ meshId: ctx.mesh.id, tool: "mesh_status" });
+  const rateResult = (0, import_daemon_core3.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_core2.getLedgerSummary)(mesh.id);
+  let ledgerSummary = (0, import_daemon_core3.getLedgerSummary)(mesh.id);
   const results = await Promise.all(mesh.nodes.map(async (node) => {
     const entry = {
       nodeId: node.id,
@@ -2902,14 +2985,14 @@ async function meshStatus(ctx, args = {}) {
         noFallbackReason: failure.noFallbackReason
       });
     }
-    entry.dataFreshness = (0, import_daemon_core2.buildMeshNodeProbeFreshness)({
+    entry.dataFreshness = (0, import_daemon_core3.buildMeshNodeProbeFreshness)({
       git: entry.git,
       liveTruthProbed,
       isSelfNode: entry.machine?.sameMachine === true,
       daemonId: readNodeDaemonId(node),
       node
     });
-    const recoveryContext = (0, import_daemon_core2.getSessionRecoveryContext)(mesh.id, { nodeId: node.id });
+    const recoveryContext = (0, import_daemon_core3.getSessionRecoveryContext)(mesh.id, { nodeId: node.id });
     if (recoveryContext.consecutiveNodeFailures > 0) {
       entry.recoveryHints = {
         consecutiveFailures: recoveryContext.consecutiveNodeFailures,
@@ -2981,23 +3064,23 @@ async function meshStatus(ctx, args = {}) {
     }
     return entry;
   }));
-  let ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(mesh.id, { tail: 200 });
-  let directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(mesh.id);
+  let ledgerEntries = (0, import_daemon_core3.readLedgerEntries)(mesh.id, { tail: 200 });
+  let directDispatches = (0, import_daemon_core3.getActiveDirectDispatches)(mesh.id);
   const directReconciliation = await reconcileDirectDispatchesFromTranscriptEvidence(ctx, results, directDispatches, ledgerEntries);
   if (directReconciliation.reconciled > 0) {
-    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);
+    ledgerEntries = (0, import_daemon_core3.readLedgerEntries)(mesh.id, { tail: 200 });
+    directDispatches = (0, import_daemon_core3.getActiveDirectDispatches)(mesh.id);
+    ledgerSummary = (0, import_daemon_core3.getLedgerSummary)(mesh.id);
   }
-  const activeWorkEvidence = (0, import_daemon_core2.buildMeshActiveWork)({
+  const activeWorkEvidence = (0, import_daemon_core3.buildMeshActiveWork)({
     meshId: mesh.id,
-    queue: (0, import_daemon_core2.getQueue)(mesh.id),
+    queue: (0, import_daemon_core3.getQueue)(mesh.id),
     ledgerEntries,
     directDispatches,
     nodes: results
   });
   const pollingGuidance = buildActiveWorkPollingGuidance(activeWorkEvidence.summary);
-  const staleDirectWorkSummary = (0, import_daemon_core2.buildCompactStaleDirectWorkSummary)(activeWorkEvidence.staleDirectWork, {
+  const staleDirectWorkSummary = (0, import_daemon_core3.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."
   });
@@ -3185,7 +3268,7 @@ async function meshStatus(ctx, args = {}) {
   }
   try {
     if (compact) {
-      const { live, historyFold } = (0, import_daemon_core2.getMeshStatusMissionsCompact)(mesh.id);
+      const { live, historyFold } = (0, import_daemon_core3.getMeshStatusMissionsCompact)(mesh.id);
       const ranked = [...live].sort((a, b) => String(b.tasks?.lastActivityAt ?? "").localeCompare(String(a.tasks?.lastActivityAt ?? "")));
       const kept = [];
       const overflow = [];
@@ -3212,230 +3295,45 @@ async function meshStatus(ctx, args = {}) {
       }
       if (historyFold) response.missionsHistory = historyFold;
     } else {
-      const missions = (0, import_daemon_core2.getMeshStatusMissionSummaries)(mesh.id, { verbose: true });
+      const missions = (0, import_daemon_core3.getMeshStatusMissionSummaries)(mesh.id, { verbose: true });
       if (missions.length > 0) {
         response.missions = missions.map((mission) => {
           try {
-            return { ...mission, stats: (0, import_daemon_core2.computeMeshMissionStats)(mesh.id, mission.id) };
-          } catch {
-            return mission;
-          }
-        });
-      }
-    }
-  } catch {
-  }
-  try {
-    const pendingEvents = await drainCoordinatorPendingEvents(ctx);
-    const asyncRefineJobs = (0, import_daemon_core2.buildMeshAsyncRefineJobs)({
-      meshId: mesh.id,
-      ledgerEntries,
-      pendingEvents
-    });
-    if (asyncRefineJobs.length > 0) {
-      if (compact) {
-        const summary = (0, import_daemon_core2.summarizeMeshAsyncRefineJobs)(asyncRefineJobs);
-        if (summary.activeJobs.length > 0) response.asyncRefineJobs = summary.activeJobs;
-        response.asyncRefineJobsSummary = {
-          total: summary.total,
-          byStatus: summary.byStatus,
-          ...summary.staleTerminal > 0 ? { staleTerminal: summary.staleTerminal } : {}
-        };
-      } else {
-        response.asyncRefineJobs = asyncRefineJobs;
-      }
-    }
-    if (pendingEvents.length > 0) {
-      response.pendingCoordinatorEvents = pendingEvents;
-    }
-  } catch {
-  }
-  return JSON.stringify(response, null, 2);
-}
-async function meshTaskHistory(ctx, args) {
-  const { mesh } = ctx;
-  const compact = args.verbose === true ? false : args.compact ?? true;
-  const pendingEvents = await drainCoordinatorPendingEvents(ctx);
-  const requestedTail = typeof args.tail === "number" && args.tail > 0 ? Math.floor(args.tail) : 20;
-  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_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_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_core2.computeMeshTaskStats)(mesh.id, { taskIds });
-      if (stats.length > 0) taskStats = stats;
-    }
-  } catch {
-  }
-  return JSON.stringify({
-    meshId: mesh.id,
-    payloadMode: compact ? "compact" : "full",
-    entries,
-    summary,
-    ...taskStats ? { taskStats } : {},
-    ...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;
-  const nodes = ctx.mesh.nodes.filter((node) => !requestedNodeIds || requestedNodeIds.has(node.id));
-  const replicas = [];
-  const shouldImport = args.import_entries !== false;
-  const queryArgs = {
-    meshId: ctx.mesh.id,
-    ...typeof args.limit === "number" ? { limit: args.limit } : {},
-    ...typeof args.after_id === "string" && args.after_id.trim() ? { afterId: args.after_id.trim() } : {},
-    ...typeof args.since === "string" && args.since.trim() ? { since: args.since.trim() } : {}
-  };
-  for (const node of nodes) {
-    try {
-      if (isLocalControlPlaneNode(ctx, node) || !node.daemonId) {
-        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",
-          slice: slice2,
-          status: "local"
-        }));
-        continue;
-      }
-      const result = await commandForNode(ctx, node, "get_mesh_ledger_slice", queryArgs);
-      const payload = unwrapCommandPayload(result);
-      if (payload?.success === false) {
-        throw new Error(payload.error || "remote get_mesh_ledger_slice failed");
-      }
-      const slice = payload?.slice ?? payload;
-      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_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",
-        slice,
-        importResult
-      }));
-      if (shouldImport && importResult.accepted > 0) {
-        (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
-          kind: "ledger_replicated",
-          nodeId: node.id,
-          payload: {
-            protocol: "adhdev.mesh.ledger.slice.v1",
-            imported: importResult.accepted,
-            skippedDuplicate: importResult.skippedDuplicate,
-            rejectedInvalid: importResult.rejectedInvalid,
-            nextAfterId: slice.cursor?.nextAfterId ?? null,
-            via: "p2p_datachannel"
-          }
-        });
-      }
-    } catch (e) {
-      replicas.push((0, import_daemon_core2.buildMeshLedgerReplicaEvidence)({
-        nodeId: node.id,
-        daemonId: node.daemonId,
-        transport: node.daemonId ? "p2p_datachannel" : "local",
-        status: "failed",
-        error: e?.message ?? String(e)
-      }));
-    }
-  }
-  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,
-      sourceOfTruth: evidence.sourceOfTruth,
-      totals: evidence.totals,
-      convergence: evidence.convergence
-    }
-  });
-  return JSON.stringify({ success: true, evidence }, null, 2);
-}
-async function meshPruneStaleDirect(ctx, args = {}) {
-  await refreshMeshFromDaemon(ctx);
-  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_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_core2.getQueue)(ctx.mesh.id),
-    ledgerEntries,
-    directDispatches,
-    nodes: liveNodes,
-    execute,
-    includeTerminal,
-    source: "mesh_prune_stale_direct"
-  });
-  const { prunable, prunedCount, preservedUnacknowledged, preservedLedgerOnly, preservedNotOrphan } = result;
-  const summarize = (records) => records.map((r) => ({
-    taskId: r.taskId,
-    nodeId: r.nodeId,
-    sessionId: r.sessionId,
-    status: r.status,
-    terminal: r.terminal === true,
-    staleReason: r.staleReason,
-    taskTitle: r.taskTitle,
-    createdAt: r.createdAt
-  }));
-  return JSON.stringify({
-    success: true,
-    mode: result.mode,
-    meshId: ctx.mesh.id,
-    includeTerminal,
-    candidateCount: result.candidateCount,
-    prunableCount: prunable.length,
-    prunedCount,
-    prunable: summarize(prunable),
-    preserved: {
-      unacknowledgedCount: preservedUnacknowledged.length,
-      ledgerOnlyCount: preservedLedgerOnly.length,
-      notOrphanCount: preservedNotOrphan.length,
-      unacknowledged: summarize(preservedUnacknowledged),
-      ledgerOnly: summarize(preservedLedgerOnly),
-      notOrphan: summarize(preservedNotOrphan)
-    },
-    note: execute ? `Pruned ${prunedCount} orphaned direct dispatch record(s) from the active staleDirect surface. The append-only mesh ledger audit history is preserved; a direct_dispatch_pruned entry records this prune.` : "Dry run \u2014 nothing was deleted. Re-run with execute=true to prune the listed orphaned records. Fresh unacknowledged dispatch failures (node/session still live) and ledger-only audit entries are always preserved."
-  }, null, 2);
+            return { ...mission, stats: (0, import_daemon_core3.computeMeshMissionStats)(mesh.id, mission.id) };
+          } catch {
+            return mission;
+          }
+        });
+      }
+    }
+  } catch {
+  }
+  try {
+    const pendingEvents = await drainCoordinatorPendingEvents(ctx);
+    const asyncRefineJobs = (0, import_daemon_core3.buildMeshAsyncRefineJobs)({
+      meshId: mesh.id,
+      ledgerEntries,
+      pendingEvents
+    });
+    if (asyncRefineJobs.length > 0) {
+      if (compact) {
+        const summary = (0, import_daemon_core3.summarizeMeshAsyncRefineJobs)(asyncRefineJobs);
+        if (summary.activeJobs.length > 0) response.asyncRefineJobs = summary.activeJobs;
+        response.asyncRefineJobsSummary = {
+          total: summary.total,
+          byStatus: summary.byStatus,
+          ...summary.staleTerminal > 0 ? { staleTerminal: summary.staleTerminal } : {}
+        };
+      } else {
+        response.asyncRefineJobs = asyncRefineJobs;
+      }
+    }
+    if (pendingEvents.length > 0) {
+      response.pendingCoordinatorEvents = pendingEvents;
+    }
+  } catch {
+  }
+  return JSON.stringify(response, null, 2);
 }
 async function meshListNodes(ctx) {
   await refreshMeshFromDaemon(ctx);
@@ -3459,67 +3357,18 @@ async function meshListNodes(ctx) {
     }))
   }, null, 2);
 }
-async function meshMissionUpsert(ctx, args) {
-  try {
-    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,
-      status: readString(args.status) || void 0
-    });
-    return JSON.stringify({
-      success: true,
-      mission,
-      nextAction: "Attach tasks with mesh_enqueue_task mission_id and depends_on. mesh_status shows live task aggregates for this mission."
-    });
-  } catch (e) {
-    const message = e?.message || String(e);
-    const code = message.includes("mission_title_required") ? "mission_title_required" : message.includes("invalid_mission_status") ? "invalid_mission_status" : void 0;
-    return JSON.stringify({ success: false, ...code ? { code } : {}, error: message });
-  }
-}
-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_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_core2.MESH_MISSION_STATUSES.join(", ")})`
-      });
-    }
-    const statuses = rawStatuses.length > 0 ? rawStatuses : void 0;
-    const missions = (0, import_daemon_core2.listMeshMissionSummaries)(ctx.mesh.id, {
-      statuses,
-      verbose: args.verbose === true
-    }).map((mission) => {
-      try {
-        return { ...mission, stats: (0, import_daemon_core2.computeMeshMissionStats)(ctx.mesh.id, mission.id) };
-      } catch {
-        return mission;
-      }
-    });
-    return JSON.stringify({
-      success: true,
-      count: missions.length,
-      ...statuses ? { statusFilter: statuses } : {},
-      missions
-    }, null, 2);
-  } catch (e) {
-    return JSON.stringify({ success: false, error: e?.message || String(e) });
-  }
-}
+
+// src/tools/mesh-tools-queue.ts
 async function meshEnqueueTask(ctx, args) {
   const taskMode = readString(args.task_mode) || readString(args.taskMode);
-  const requiredTags = (0, import_daemon_core2.normalizeMeshCapabilityTags)(Array.isArray(args.requiredTags) ? args.requiredTags : args.required_tags);
+  const requiredTags = (0, import_daemon_core3.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_core2.enqueueTask)(ctx.mesh.id, args.message, { taskMode, requiredTags, dependsOn, missionId, targetNodeId, ...ctx.coordinatorSessionId ? { sourceCoordinatorSessionId: ctx.coordinatorSessionId } : {} });
+    const task = (0, import_daemon_core3.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({
@@ -3542,14 +3391,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_core2.nodeSatisfiesRequiredTags)(requiredTags, (0, import_daemon_core2.buildMeshNodeCapabilityTags)(node))) continue;
+        if (!(0, import_daemon_core3.nodeSatisfiesRequiredTags)(requiredTags, (0, import_daemon_core3.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_core2.appendLedgerEntry)(ctx.mesh.id, {
+                (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
                   kind: "task_dispatched",
                   nodeId: node.id,
                   sessionId: result.sessionId,
@@ -3571,7 +3420,7 @@ async function meshEnqueueTask(ctx, args) {
             }
           }).catch((err) => {
             try {
-              (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
+              (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
                 kind: "p2p_dispatch_failed",
                 nodeId: node.id,
                 payload: {
@@ -3614,17 +3463,17 @@ async function meshEnqueueTask(ctx, args) {
   }
 }
 async function meshViewQueue(ctx, args) {
-  const rateResult = (0, import_daemon_core2.recordMeshToolCall)({ meshId: ctx.mesh.id, tool: "mesh_view_queue" });
+  const rateResult = (0, import_daemon_core3.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_core2.getQueue)(ctx.mesh.id);
+    const rawQueue = (0, import_daemon_core3.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_core2.describeTaskDependencyState)(task, statusById);
+      const depState = (0, import_daemon_core3.describeTaskDependencyState)(task, statusById);
       return { ...task, ...depState };
     });
     const fullQueue = prioritizeActiveQueueRows(annotateQueueStaleness(withDependencies, ctx.mesh));
@@ -3633,16 +3482,16 @@ async function meshViewQueue(ctx, args) {
     const visibleSummary = buildQueueStatusSummary(queue);
     const maintenance = buildQueueMaintenanceReport(fullQueue);
     const liveNodes = await collectMeshViewQueueNodesWithLiveSessions(ctx);
-    let ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
-    let directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(ctx.mesh.id);
+    let ledgerEntries = (0, import_daemon_core3.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
+    let directDispatches = (0, import_daemon_core3.getActiveDirectDispatches)(ctx.mesh.id);
     const directReconciliation = await reconcileDirectDispatchesFromTranscriptEvidence(ctx, liveNodes, directDispatches, ledgerEntries);
     if (directReconciliation.reconciled > 0) {
-      ledgerEntries = (0, import_daemon_core2.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
-      directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(ctx.mesh.id);
+      ledgerEntries = (0, import_daemon_core3.readLedgerEntries)(ctx.mesh.id, { tail: 200 });
+      directDispatches = (0, import_daemon_core3.getActiveDirectDispatches)(ctx.mesh.id);
     }
-    (0, import_daemon_core2.markStaleDirectDispatches)(ctx.mesh.id);
-    directDispatches = (0, import_daemon_core2.getActiveDirectDispatches)(ctx.mesh.id);
-    const activeWorkEvidence = (0, import_daemon_core2.buildMeshActiveWork)({
+    (0, import_daemon_core3.markStaleDirectDispatches)(ctx.mesh.id);
+    directDispatches = (0, import_daemon_core3.getActiveDirectDispatches)(ctx.mesh.id);
+    const activeWorkEvidence = (0, import_daemon_core3.buildMeshActiveWork)({
       meshId: ctx.mesh.id,
       queue: fullQueue,
       ledgerEntries,
@@ -3667,7 +3516,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_core2.buildCompactStaleDirectWorkSummary)(activeWorkEvidence.staleDirectWork, {
+    const staleDirectWorkSummary = (0, import_daemon_core3.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."
     });
@@ -3742,55 +3591,304 @@ 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_core2.cancelTask)(ctx.mesh.id, taskId, { reason: args.reason });
+    const task = (0, import_daemon_core3.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(() => {
     });
     return JSON.stringify({ success: true, task }, null, 2);
   } catch (e) {
-    return JSON.stringify({ success: false, error: e.message });
+    return JSON.stringify({ success: false, error: e.message });
+  }
+}
+async function meshQueueRequeue(ctx, args) {
+  try {
+    const taskId = (args.task_id || args.taskId || "").trim();
+    if (!taskId) return JSON.stringify({ success: false, error: "task_id required" });
+    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_core3.requeueTask)(ctx.mesh.id, taskId, {
+      reason: args.reason,
+      targetNodeId,
+      targetSessionId,
+      clearTargetNode: args.clear_target_node === true || args.clearTargetNode === true,
+      clearTargetSession: targetSessionId ? false : !keepTargetSession,
+      force: args.force === true
+    });
+    if (!task) return JSON.stringify({ success: false, error: `Queue task '${taskId}' not found` });
+    if (task.status === "failed" && task.cancelReason?.startsWith("max_retries_exceeded")) {
+      return JSON.stringify({
+        success: false,
+        code: "max_retries_exceeded",
+        error: task.cancelReason,
+        task,
+        hint: "Use force=true to bypass the retry cap for explicit operator recovery."
+      }, null, 2);
+    }
+    const triggerPreferredNodeId = targetNodeId || task.targetNodeId || void 0;
+    ctx.transport.command("trigger_mesh_queue", {
+      meshId: ctx.mesh.id,
+      ...triggerPreferredNodeId ? { preferredNodeId: triggerPreferredNodeId } : {}
+    }).catch(() => {
+    });
+    return JSON.stringify({ success: true, task }, null, 2);
+  } catch (e) {
+    return JSON.stringify({ success: false, error: e.message });
+  }
+}
+
+// src/tools/mesh-tools-mission.ts
+async function meshTaskHistory(ctx, args) {
+  const { mesh } = ctx;
+  const compact = args.verbose === true ? false : args.compact ?? true;
+  const pendingEvents = await drainCoordinatorPendingEvents(ctx);
+  const requestedTail = typeof args.tail === "number" && args.tail > 0 ? Math.floor(args.tail) : 20;
+  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_core3.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_core3.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_core3.computeMeshTaskStats)(mesh.id, { taskIds });
+      if (stats.length > 0) taskStats = stats;
+    }
+  } catch {
+  }
+  return JSON.stringify({
+    meshId: mesh.id,
+    payloadMode: compact ? "compact" : "full",
+    entries,
+    summary,
+    ...taskStats ? { taskStats } : {},
+    ...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_core3.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;
+  const nodes = ctx.mesh.nodes.filter((node) => !requestedNodeIds || requestedNodeIds.has(node.id));
+  const replicas = [];
+  const shouldImport = args.import_entries !== false;
+  const queryArgs = {
+    meshId: ctx.mesh.id,
+    ...typeof args.limit === "number" ? { limit: args.limit } : {},
+    ...typeof args.after_id === "string" && args.after_id.trim() ? { afterId: args.after_id.trim() } : {},
+    ...typeof args.since === "string" && args.since.trim() ? { since: args.since.trim() } : {}
+  };
+  for (const node of nodes) {
+    try {
+      if (isLocalControlPlaneNode(ctx, node) || !node.daemonId) {
+        const slice2 = (0, import_daemon_core3.readLedgerSliceFromStore)(ctx.mesh.id, queryArgs);
+        replicas.push((0, import_daemon_core3.buildMeshLedgerReplicaEvidence)({
+          nodeId: node.id,
+          daemonId: node.daemonId,
+          transport: "local",
+          slice: slice2,
+          status: "local"
+        }));
+        continue;
+      }
+      const result = await commandForNode(ctx, node, "get_mesh_ledger_slice", queryArgs);
+      const payload = unwrapCommandPayload(result);
+      if (payload?.success === false) {
+        throw new Error(payload.error || "remote get_mesh_ledger_slice failed");
+      }
+      const slice = payload?.slice ?? payload;
+      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_core3.appendRemoteLedgerEntries)(ctx.mesh.id, slice.entries) : { accepted: 0, skippedDuplicate: 0, rejectedInvalid: 0, entries: [] };
+      replicas.push((0, import_daemon_core3.buildMeshLedgerReplicaEvidence)({
+        nodeId: node.id,
+        daemonId: node.daemonId,
+        transport: "p2p_datachannel",
+        slice,
+        importResult
+      }));
+      if (shouldImport && importResult.accepted > 0) {
+        (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
+          kind: "ledger_replicated",
+          nodeId: node.id,
+          payload: {
+            protocol: "adhdev.mesh.ledger.slice.v1",
+            imported: importResult.accepted,
+            skippedDuplicate: importResult.skippedDuplicate,
+            rejectedInvalid: importResult.rejectedInvalid,
+            nextAfterId: slice.cursor?.nextAfterId ?? null,
+            via: "p2p_datachannel"
+          }
+        });
+      }
+    } catch (e) {
+      replicas.push((0, import_daemon_core3.buildMeshLedgerReplicaEvidence)({
+        nodeId: node.id,
+        daemonId: node.daemonId,
+        transport: node.daemonId ? "p2p_datachannel" : "local",
+        status: "failed",
+        error: e?.message ?? String(e)
+      }));
+    }
+  }
+  const evidence = (0, import_daemon_core3.buildMeshLedgerReconciliationEvidence)(ctx.mesh.id, replicas);
+  (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
+    kind: "ledger_reconciled",
+    payload: {
+      protocol: evidence.protocol,
+      sourceOfTruth: evidence.sourceOfTruth,
+      totals: evidence.totals,
+      convergence: evidence.convergence
+    }
+  });
+  return JSON.stringify({ success: true, evidence }, null, 2);
+}
+async function meshMissionUpsert(ctx, args) {
+  try {
+    const mission = (0, import_daemon_core3.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,
+      status: readString(args.status) || void 0
+    });
+    return JSON.stringify({
+      success: true,
+      mission,
+      nextAction: "Attach tasks with mesh_enqueue_task mission_id and depends_on. mesh_status shows live task aggregates for this mission."
+    });
+  } catch (e) {
+    const message = e?.message || String(e);
+    const code = message.includes("mission_title_required") ? "mission_title_required" : message.includes("invalid_mission_status") ? "invalid_mission_status" : void 0;
+    return JSON.stringify({ success: false, ...code ? { code } : {}, error: message });
   }
 }
-async function meshQueueRequeue(ctx, args) {
+async function meshMissionList(ctx, args = {}) {
   try {
-    const taskId = (args.task_id || args.taskId || "").trim();
-    if (!taskId) return JSON.stringify({ success: false, error: "task_id required" });
-    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_core2.requeueTask)(ctx.mesh.id, taskId, {
-      reason: args.reason,
-      targetNodeId,
-      targetSessionId,
-      clearTargetNode: args.clear_target_node === true || args.clearTargetNode === true,
-      clearTargetSession: targetSessionId ? false : !keepTargetSession,
-      force: args.force === true
-    });
-    if (!task) return JSON.stringify({ success: false, error: `Queue task '${taskId}' not found` });
-    if (task.status === "failed" && task.cancelReason?.startsWith("max_retries_exceeded")) {
+    const rawStatuses = Array.isArray(args.status) ? args.status : typeof args.status === "string" && args.status.trim() ? [args.status] : [];
+    const invalid = rawStatuses.filter((s) => !import_daemon_core3.MESH_MISSION_STATUSES.includes(s));
+    if (invalid.length > 0) {
       return JSON.stringify({
         success: false,
-        code: "max_retries_exceeded",
-        error: task.cancelReason,
-        task,
-        hint: "Use force=true to bypass the retry cap for explicit operator recovery."
-      }, null, 2);
+        code: "invalid_mission_status",
+        error: `invalid status filter: ${invalid.join(", ")} (valid: ${import_daemon_core3.MESH_MISSION_STATUSES.join(", ")})`
+      });
     }
-    const triggerPreferredNodeId = targetNodeId || task.targetNodeId || void 0;
-    ctx.transport.command("trigger_mesh_queue", {
-      meshId: ctx.mesh.id,
-      ...triggerPreferredNodeId ? { preferredNodeId: triggerPreferredNodeId } : {}
-    }).catch(() => {
+    const statuses = rawStatuses.length > 0 ? rawStatuses : void 0;
+    const missions = (0, import_daemon_core3.listMeshMissionSummaries)(ctx.mesh.id, {
+      statuses,
+      verbose: args.verbose === true
+    }).map((mission) => {
+      try {
+        return { ...mission, stats: (0, import_daemon_core3.computeMeshMissionStats)(ctx.mesh.id, mission.id) };
+      } catch {
+        return mission;
+      }
     });
-    return JSON.stringify({ success: true, task }, null, 2);
+    return JSON.stringify({
+      success: true,
+      count: missions.length,
+      ...statuses ? { statusFilter: statuses } : {},
+      missions
+    }, null, 2);
   } catch (e) {
-    return JSON.stringify({ success: false, error: e.message });
+    return JSON.stringify({ success: false, error: e?.message || String(e) });
   }
 }
+async function meshReviewInbox(ctx, args = {}) {
+  await refreshMeshFromDaemon(ctx);
+  const meshId = (args.mesh_id ?? ctx.mesh.id).trim();
+  const result = await commandForNode(ctx, ctx.mesh.nodes[0], "get_mesh_review_inbox", {
+    meshId,
+    inlineMesh: ctx.mesh
+  });
+  return JSON.stringify(result, null, 2);
+}
+
+// src/tools/mesh-tools-session.ts
+async function meshPruneStaleDirect(ctx, args = {}) {
+  await refreshMeshFromDaemon(ctx);
+  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_core3.readLedgerEntries)(ctx.mesh.id, { tail: 500 });
+  const directDispatches = (0, import_daemon_core3.getActiveDirectDispatches)(ctx.mesh.id);
+  const result = (0, import_daemon_core3.pruneStaleDirectDispatches)({
+    meshId: ctx.mesh.id,
+    queue: (0, import_daemon_core3.getQueue)(ctx.mesh.id),
+    ledgerEntries,
+    directDispatches,
+    nodes: liveNodes,
+    execute,
+    includeTerminal,
+    source: "mesh_prune_stale_direct"
+  });
+  const { prunable, prunedCount, preservedUnacknowledged, preservedLedgerOnly, preservedNotOrphan } = result;
+  const summarize = (records) => records.map((r) => ({
+    taskId: r.taskId,
+    nodeId: r.nodeId,
+    sessionId: r.sessionId,
+    status: r.status,
+    terminal: r.terminal === true,
+    staleReason: r.staleReason,
+    taskTitle: r.taskTitle,
+    createdAt: r.createdAt
+  }));
+  return JSON.stringify({
+    success: true,
+    mode: result.mode,
+    meshId: ctx.mesh.id,
+    includeTerminal,
+    candidateCount: result.candidateCount,
+    prunableCount: prunable.length,
+    prunedCount,
+    prunable: summarize(prunable),
+    preserved: {
+      unacknowledgedCount: preservedUnacknowledged.length,
+      ledgerOnlyCount: preservedLedgerOnly.length,
+      notOrphanCount: preservedNotOrphan.length,
+      unacknowledged: summarize(preservedUnacknowledged),
+      ledgerOnly: summarize(preservedLedgerOnly),
+      notOrphan: summarize(preservedNotOrphan)
+    },
+    note: execute ? `Pruned ${prunedCount} orphaned direct dispatch record(s) from the active staleDirect surface. The append-only mesh ledger audit history is preserved; a direct_dispatch_pruned entry records this prune.` : "Dry run \u2014 nothing was deleted. Re-run with execute=true to prune the listed orphaned records. Fresh unacknowledged dispatch failures (node/session still live) and ledger-only audit entries are always preserved."
+  }, null, 2);
+}
 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_core2.validateMeshTaskModeRequest)(requestedTaskMode, args.message);
+  const modeValidation = (0, import_daemon_core3.validateMeshTaskModeRequest)(requestedTaskMode, args.message);
   if (!modeValidation.valid) {
     return JSON.stringify({
       success: false,
@@ -3902,7 +4000,7 @@ async function meshSendTask(ctx, args) {
         const dispatchedAt = (/* @__PURE__ */ new Date()).toISOString();
         try {
           const providerType = result2.providerType || cached?.providerType;
-          (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
+          (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
             kind: "task_dispatched",
             nodeId: args.node_id,
             sessionId: dispatchedSessionId,
@@ -3914,7 +4012,7 @@ async function meshSendTask(ctx, args) {
               targetSessionId: dispatchedSessionId
             })
           });
-          (0, import_daemon_core2.insertDirectDispatch)(ctx.mesh.id, {
+          (0, import_daemon_core3.insertDirectDispatch)(ctx.mesh.id, {
             taskId,
             nodeId: args.node_id,
             sessionId: dispatchedSessionId,
@@ -3925,7 +4023,7 @@ async function meshSendTask(ctx, args) {
             dispatchedAt
           });
           if (missionId) {
-            (0, import_daemon_core2.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
+            (0, import_daemon_core3.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
               id: taskId,
               missionId,
               assignedNodeId: args.node_id,
@@ -4084,7 +4182,7 @@ async function meshSendTask(ctx, args) {
         });
       }
       try {
-        (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
+        (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
           kind: "task_dispatched",
           nodeId: args.node_id,
           sessionId: args.session_id,
@@ -4099,7 +4197,7 @@ async function meshSendTask(ctx, args) {
         });
       } catch {
       }
-      (0, import_daemon_core2.insertDirectDispatch)(ctx.mesh.id, {
+      (0, import_daemon_core3.insertDirectDispatch)(ctx.mesh.id, {
         taskId,
         nodeId: args.node_id,
         sessionId: args.session_id,
@@ -4112,7 +4210,7 @@ async function meshSendTask(ctx, args) {
       });
       if (missionId) {
         try {
-          (0, import_daemon_core2.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
+          (0, import_daemon_core3.recordDirectDispatchTask)(ctx.mesh.id, args.message, {
             id: taskId,
             missionId,
             assignedNodeId: args.node_id,
@@ -4157,14 +4255,14 @@ async function meshSendTask(ctx, args) {
         } : {}
       });
     }
-    const task = (0, import_daemon_core2.enqueueTask)(ctx.mesh.id, args.message, {
+    const task = (0, import_daemon_core3.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_core2.drainPendingMeshCoordinatorEvents)(ctx.mesh.id, ctx.localDaemonId);
+    const pendingEvents = (0, import_daemon_core3.drainPendingMeshCoordinatorEvents)(ctx.mesh.id, ctx.localDaemonId);
     const result = {
       success: true,
       source: "queue",
@@ -4189,81 +4287,6 @@ async function meshSendTask(ctx, args) {
     return JSON.stringify(failure);
   }
 }
-function classifyReadChatTransportCause(error) {
-  const message = (error instanceof Error ? error.message : String(error ?? "")).toLowerCase();
-  if (/not acknowledged|delivery failure|channel never opened|connect timed out|not connected|datachannel|disconnected|\bclosed\b|offline|no route|failed to initiate p2p|p2p mesh is not available|connect queue full/.test(message)) {
-    return "not_connected";
-  }
-  return "saturated";
-}
-function resolveCachedMeshSessionPreviewFromLedger(ctx, nodeId, sessionId) {
-  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 : {};
-    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 !== sessionId) continue;
-    const metadataEvent = payload.metadataEvent && typeof payload.metadataEvent === "object" && !Array.isArray(payload.metadataEvent) ? payload.metadataEvent : payload;
-    const preview = (0, import_daemon_core2.resolveMeshSurfacedSessionPreview)(metadataEvent);
-    if (preview) {
-      return { ...preview, ledgerKind: entry.kind, timestamp: entry.timestamp };
-    }
-  }
-  return void 0;
-}
-function buildMeshReadChatCacheFallback(ctx, args, node, error) {
-  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";
-  const cached = resolveCachedMeshSessionPreviewFromLedger(ctx, args.node_id, args.session_id);
-  if (cached) {
-    return JSON.stringify({
-      success: true,
-      source: "coordinator_cache_fallback",
-      fallback: true,
-      nodeId: args.node_id,
-      sessionId: args.session_id,
-      transport: "p2p",
-      transportFailure: {
-        code: classification.code,
-        reason: classification.reason,
-        cause,
-        error: errorMessage
-      },
-      advisory: `Live transcript unavailable (${causeNote}). Showing the cached coordinator-side summary surfaced from the worker's last completion/status event \u2014 a stale point-in-time summary, NOT the live transcript. The full transcript requires a live P2P read_chat once the peer is reachable.`,
-      fullTranscriptRequiresP2p: true,
-      summary: cached.preview,
-      messages: [{
-        role: cached.role,
-        content: cached.preview,
-        cached: true,
-        ...cached.receivedAt ? { receivedAt: cached.receivedAt } : {}
-      }],
-      cachedPreview: {
-        role: cached.role,
-        ledgerKind: cached.ledgerKind,
-        ledgerTimestamp: cached.timestamp,
-        ...cached.receivedAt ? { receivedAt: cached.receivedAt } : {}
-      }
-    }, null, 2);
-  }
-  const failure = buildCoordinatorP2pRelayFailure(error, {
-    command: "read_chat",
-    targetDaemonId: node.daemonId,
-    nodeId: args.node_id,
-    sessionId: args.session_id
-  });
-  return JSON.stringify({
-    ...failure,
-    cause,
-    cachedSummaryAvailable: false,
-    fullTranscriptRequiresP2p: true,
-    advisory: `Live transcript unavailable (${causeNote}) and no cached coordinator-side summary exists for this session yet (no completion/status event has been surfaced). The full transcript requires a live P2P read_chat once the peer is reachable.`
-  }, null, 2);
-}
 async function meshReadChat(ctx, args) {
   const node = await findOptionalNodeWithRefresh(ctx, args.node_id);
   if (!node) {
@@ -4284,7 +4307,7 @@ async function meshReadChat(ctx, args) {
       tailLimit: args.tail ?? 10
     });
   } catch (e) {
-    if (isLocalNode || !(0, import_daemon_core2.isP2pRelayTransportFailure)(e)) throw e;
+    if (isLocalNode || !(0, import_daemon_core3.isP2pRelayTransportFailure)(e)) throw e;
     return buildMeshReadChatCacheFallback(ctx, args, node, e);
   }
   const payload = annotateRapidReadChatAdvisory(unwrapCommandPayload(result), {
@@ -4352,11 +4375,40 @@ async function meshLaunchSession(ctx, args) {
     const coordinatorNode = resolveCoordinatorNode(ctx);
     const coordinatorDaemonId = resolveCoordinatorDaemonId(ctx);
     const spawnedSessionVisibility = readSpawnedSessionVisibility(ctx.mesh.policy);
-    const delegatedWorkerAutoApprove = (0, import_daemon_core2.resolveDelegatedWorkerAutoApprove)(ctx.mesh.policy, node.policy);
+    const delegatedWorkerAutoApprove = (0, import_daemon_core3.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);
     }
+    if (args.force !== true) {
+      try {
+        const statusResult = await commandForNode(ctx, node, "get_status_metadata", {});
+        const sessions = extractStatusMetadataSessions(statusResult);
+        const existing = sessions.find((session) => !isTerminalSessionRecord(session) && isMeshOwnedDelegateSession(session, ctx.mesh.id, args.node_id));
+        if (existing) {
+          const existingSessionId = readSessionRecordId(existing);
+          if (existingSessionId) {
+            const existingProviderType = resolveSessionProviderType(existing) || resolvedProviderType || void 0;
+            const existingStatus = typeof existing?.status === "string" ? existing.status : "unknown";
+            return JSON.stringify({
+              success: true,
+              duplicate: true,
+              launched: false,
+              reused: true,
+              sessionId: existingSessionId,
+              nodeId: args.node_id,
+              ...existingProviderType ? { resolvedProviderType: existingProviderType, providerType: existingProviderType } : {},
+              sessionStatus: existingStatus,
+              idle: isIdleSessionRecord(existing),
+              reason: "mesh_launch_session_duplicate_guard",
+              warning: `Node '${args.node_id}' already has a live mesh-owned worker session ('${existingSessionId}', status '${existingStatus}'). Returning it instead of launching an empty duplicate (likely an enqueue auto-launch already spawned it).`,
+              nextAction: `Use session '${existingSessionId}' for mesh_send_task/mesh_read_chat. If you intentionally need a second concurrent session on this node, retry mesh_launch_session with force=true.`
+            }, null, 2);
+          }
+        }
+      } catch {
+      }
+    }
     let result;
     try {
       result = await commandForNode(ctx, node, "launch_cli", {
@@ -4399,7 +4451,7 @@ async function meshLaunchSession(ctx, args) {
       });
     }
     try {
-      (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
+      (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
         kind: "session_launched",
         nodeId: args.node_id,
         sessionId: runtimeSessionId || void 0,
@@ -4418,6 +4470,34 @@ async function meshLaunchSession(ctx, args) {
     }, null, 2);
   }
 }
+async function meshApprove(ctx, args) {
+  const node = await findNodeWithRefresh(ctx, args.node_id);
+  const cached = getSessionMetadata(meshSessionCacheKey(args.node_id, args.session_id));
+  const providerSessionId = cached?.providerSessionId;
+  const result = await commandForNode(ctx, node, "resolve_action", {
+    sessionId: args.session_id,
+    targetSessionId: args.session_id,
+    workspace: node.workspace,
+    ...cached?.providerType ? { agentType: cached.providerType, providerType: cached.providerType } : {},
+    ...providerSessionId ? { providerSessionId } : {},
+    action: args.action === "reject" ? "reject" : "approve"
+  });
+  return JSON.stringify(result, null, 2);
+}
+async function meshCleanupSessions(ctx, args) {
+  const node = await findNodeWithRefresh(ctx, args.node_id);
+  const result = await commandForNode(ctx, node, "cleanup_mesh_sessions", {
+    meshId: ctx.mesh.id,
+    nodeId: args.node_id,
+    mode: args.mode,
+    sessionIds: args.session_ids,
+    dryRun: args.dry_run === true,
+    inlineMesh: ctx.mesh
+  });
+  return JSON.stringify(result, null, 2);
+}
+
+// src/tools/mesh-tools-git.ts
 async function meshGitStatus(ctx, args) {
   const node = await findNodeWithRefresh(ctx, args.node_id);
   const autoDiscoverSubmodules = node.policy?.autoDiscoverSubmodules !== false;
@@ -4552,7 +4632,7 @@ async function meshCheckpoint(ctx, args) {
     includeUntracked: true
   });
   try {
-    (0, import_daemon_core2.appendLedgerEntry)(ctx.mesh.id, {
+    (0, import_daemon_core3.appendLedgerEntry)(ctx.mesh.id, {
       kind: "checkpoint_created",
       nodeId: args.node_id,
       payload: {
@@ -4567,20 +4647,6 @@ async function meshCheckpoint(ctx, args) {
   }
   return JSON.stringify(result, null, 2);
 }
-async function meshApprove(ctx, args) {
-  const node = await findNodeWithRefresh(ctx, args.node_id);
-  const cached = getSessionMetadata(meshSessionCacheKey(args.node_id, args.session_id));
-  const providerSessionId = cached?.providerSessionId;
-  const result = await commandForNode(ctx, node, "resolve_action", {
-    sessionId: args.session_id,
-    targetSessionId: args.session_id,
-    workspace: node.workspace,
-    ...cached?.providerType ? { agentType: cached.providerType, providerType: cached.providerType } : {},
-    ...providerSessionId ? { providerSessionId } : {},
-    action: args.action === "reject" ? "reject" : "approve"
-  });
-  return JSON.stringify(result, null, 2);
-}
 async function meshCloneNode(ctx, args) {
   const sourceNode = await findNodeWithRefresh(ctx, args.source_node_id);
   const result = await commandForNode(ctx, sourceNode, "clone_mesh_node", {
@@ -4600,18 +4666,6 @@ async function meshCloneNode(ctx, args) {
   }
   return JSON.stringify(result, null, 2);
 }
-async function meshCleanupSessions(ctx, args) {
-  const node = await findNodeWithRefresh(ctx, args.node_id);
-  const result = await commandForNode(ctx, node, "cleanup_mesh_sessions", {
-    meshId: ctx.mesh.id,
-    nodeId: args.node_id,
-    mode: args.mode,
-    sessionIds: args.session_ids,
-    dryRun: args.dry_run === true,
-    inlineMesh: ctx.mesh
-  });
-  return JSON.stringify(result, null, 2);
-}
 async function meshRemoveNode(ctx, args) {
   const node = await findNodeWithRefresh(ctx, args.node_id);
   const removeArgs = buildRemoveNodeArgs(ctx, args.node_id, args.session_cleanup_mode, args.force === true);
@@ -4645,12 +4699,8 @@ async function meshRemoveNode(ctx, args) {
   }
   return JSON.stringify({ ...result || {}, ...transportFallback ? { transportFallback } : {} }, null, 2);
 }
-function resolveRefineConfigNode(ctx, nodeId) {
-  if (nodeId) return findNode(ctx.mesh, nodeId);
-  const node = ctx.mesh.nodes.find((entry) => !!entry.workspace);
-  if (!node) throw new Error("No mesh node with a workspace is available");
-  return node;
-}
+
+// src/tools/mesh-tools-refine.ts
 async function meshRefineConfigSchema(ctx) {
   const node = resolveRefineConfigNode(ctx);
   const result = await commandForNode(ctx, node, "get_mesh_refine_config_schema", {});
@@ -4752,15 +4802,6 @@ async function meshRefineBatch(ctx, args = {}) {
   }
   return JSON.stringify(result, null, 2);
 }
-async function meshReviewInbox(ctx, args = {}) {
-  await refreshMeshFromDaemon(ctx);
-  const meshId = (args.mesh_id ?? ctx.mesh.id).trim();
-  const result = await commandForNode(ctx, ctx.mesh.nodes[0], "get_mesh_review_inbox", {
-    meshId,
-    inlineMesh: ctx.mesh
-  });
-  return JSON.stringify(result, null, 2);
-}
 
 // src/help.ts
 var STANDARD_TOOLS = [