@adhdev/mesh-shared 1.0.60-rc.52 → 1.0.60-rc.54

package/dist/magi.d.ts

@@ -50,7 +50,7 @@
  * already pinned the (node, provider) target, so any difficulty would be inert at best
  * and would fight the panel's own slot selection at worst. To change how hard a
  * replica thinks or how much parallelism a node grants, edit that NODE's capability
- * slots (`mesh_node_slots_set`); it is a different axis, on purpose.
+ * slots (`mesh_node_slots` action "set"); it is a different axis, on purpose.
  *
  * Unknown keys are dropped rather than rejected, so slots written by another version
  * stay readable. Write paths pair the normalizer with

package/dist/mesh-tool-names.d.ts

@@ -18,7 +18,32 @@
  * Order mirrors mcp-server `ALL_MESH_TOOLS` for easy visual diffing, but the consistency
  * checks are set-based (order-insensitive).
  */
-export declare const CANONICAL_MESH_TOOL_NAMES: readonly ["mesh_status", "mesh_route_preview", "mesh_list_nodes", "mesh_enqueue_batch", "mesh_enqueue_task", "mesh_view_queue", "mesh_graph_view", "mesh_graph_gate_claim", "mesh_graph_gate_release", "mesh_graph_gate_abandon", "mesh_graph_node_patch", "mesh_queue_cancel", "mesh_queue_requeue", "mesh_send_task", "mesh_read_chat", "mesh_read_debug", "mesh_read_terminal", "mesh_send_keys", "mesh_launch_session", "mesh_git_status", "mesh_read_node_logs", "mesh_fast_forward_node", "mesh_restart_daemon", "mesh_checkpoint", "mesh_approve", "mesh_answer_question", "mesh_list_pending_approvals", "mesh_plan_onboarding", "mesh_create", "mesh_add_node", "mesh_clone_node", "mesh_remove_node", "mesh_cleanup_worktree_nodes", "mesh_refine_node", "mesh_refine_batch", "mesh_refine_config", "mesh_change_impact_config", "mesh_init", "mesh_reinit", "mesh_write_mesh_json_config", "mesh_refine_plan", "mesh_cleanup_sessions", "mesh_prune_stale_direct", "mesh_task_history", "mesh_ledger_query", "mesh_record_note", "mesh_forget_note", "mesh_reconcile_ledger", "mesh_mission_upsert", "mesh_mission_list", "mesh_review_inbox", "mesh_magi_review", "mesh_magi_collect", "mesh_magi_kind_panel_set", "mesh_magi_kind_panel_list", "mesh_node_slots_set", "mesh_node_slots_list", "mesh_node_slots_propose", "mesh_coordinator_prompt_append_get", "mesh_coordinator_prompt_append_set"];
+export declare const CANONICAL_MESH_TOOL_NAMES: readonly ["mesh_status", "mesh_route_preview", "mesh_list_nodes", "mesh_enqueue_batch", "mesh_enqueue_task", "mesh_view_queue", "mesh_graph_view", "mesh_graph_gate", "mesh_graph_node_patch", "mesh_queue_cancel", "mesh_queue_requeue", "mesh_send_task", "mesh_read_chat", "mesh_read_debug", "mesh_read_terminal", "mesh_send_keys", "mesh_launch_session", "mesh_git_status", "mesh_read_node_logs", "mesh_fast_forward_node", "mesh_restart_daemon", "mesh_checkpoint", "mesh_approve", "mesh_answer_question", "mesh_list_pending_approvals", "mesh_create", "mesh_add_node", "mesh_clone_node", "mesh_remove_node", "mesh_cleanup_worktree_nodes", "mesh_refine_node", "mesh_refine_batch", "mesh_config", "mesh_init", "mesh_refine_plan", "mesh_cleanup_sessions", "mesh_task_history", "mesh_ledger_query", "mesh_note", "mesh_reconcile_ledger", "mesh_mission_upsert", "mesh_mission_list", "mesh_review_inbox", "mesh_magi_review", "mesh_magi_collect", "mesh_magi_kind_panel", "mesh_node_slots", "mesh_coordinator_prompt_append"];
 export type CanonicalMeshToolName = typeof CANONICAL_MESH_TOOL_NAMES[number];
 /** The count the `NN tools` barrel doc comments and consistency test assert against. */
-export declare const CANONICAL_MESH_TOOL_COUNT: 60;
+export declare const CANONICAL_MESH_TOOL_COUNT: 48;
+/**
+ * Tool names retired by the 2026-09-26 tool-surface consolidation (60 → 48).
+ * Every capability behind them is still reachable: each retired name maps to the
+ * merged tool plus the discriminator argument that selects the same behaviour.
+ *
+ * mcp-server answers a call to a retired name with an error naming the
+ * replacement (it does NOT forward silently — a coordinator running an old
+ * prompt must learn the new spelling), and the daemon-core coordinator prompt
+ * test asserts none of these names is advertised anywhere in the prompt.
+ *
+ * `args` is the discriminator to add; every other argument keeps its name.
+ * `note` covers the one rename where an argument moved (the old
+ * `mesh_graph_gate_claim({ extend_seconds })` extend-only mode).
+ */
+export declare const RETIRED_MESH_TOOLS: Readonly<Record<string, {
+    readonly tool: CanonicalMeshToolName;
+    readonly args: Readonly<Record<string, string>>;
+    readonly note?: string;
+}>>;
+/**
+ * The error text for a call to a retired tool name, or null when `name` is not
+ * retired. One wording shared by every MCP mode so the redirect reads the same
+ * wherever an old prompt calls it.
+ */
+export declare function retiredMeshToolError(name: string): string | null;

package/dist/protocol/dashboard-daemon-p2p.d.ts

@@ -35,7 +35,7 @@ export type ChunkFrame<T extends string> = {
 export declare function isChunkType(value: unknown): value is `${string}_chunk`;
 export declare const DASHBOARD_TO_DAEMON_P2P_TYPES: readonly ["ping", "pong", "command", "input", "pty_input", "pty_resize", "screenshot_start", "screenshot_stop", "subscribe", "unsubscribe", "seqscribe_session_interest", "read", "write", "list"];
 export type DashboardToDaemonP2PType = typeof DASHBOARD_TO_DAEMON_P2P_TYPES[number];
-export declare const isDashboardToDaemonP2PType: (value: unknown) => value is "command" | "ping" | "pong" | "input" | "pty_input" | "pty_resize" | "screenshot_start" | "screenshot_stop" | "subscribe" | "unsubscribe" | "seqscribe_session_interest" | "read" | "write" | "list";
+export declare const isDashboardToDaemonP2PType: (value: unknown) => value is "list" | "command" | "ping" | "pong" | "input" | "pty_input" | "pty_resize" | "screenshot_start" | "screenshot_stop" | "subscribe" | "unsubscribe" | "seqscribe_session_interest" | "read" | "write";
 export type DashboardToDaemonChunkType = `${DashboardToDaemonP2PType}_chunk`;
 export declare function isDashboardToDaemonChunkType(value: unknown): value is DashboardToDaemonChunkType;
 export type P2PPingMsg = {

package/dist/slot-proposal.d.ts

@@ -3,7 +3,7 @@
  *
  * Detection of installed CLI providers already exists per node (the status
  * snapshot's `availableProviders`), and applying a slot profile already exists
- * (`mesh_node_slots_set`, dry-run by default). What was missing is the bit in
+ * (`mesh_node_slots` action "set", dry-run by default). What was missing is the bit in
  * between: turning "these CLIs are installed on this node" into a concrete
  * `NodeCapabilitySlot[]` draft the operator can review. This module is that
  * bridge, and nothing more — it is a PURE proposal generator. It never writes;

package/dist/turn-ipc.d.ts

@@ -712,7 +712,7 @@ export interface GraphGateClaimRequest {
     coordinatorSessionId: string;
     leaseSeconds?: number;
     extendDeadlineSeconds?: number;
-    /** Also collect `collectGateConvergenceEvidence` on a successful claim (mesh_graph_gate_claim's own behavior). */
+    /** Also collect `collectGateConvergenceEvidence` on a successful claim (mesh_graph_gate action=claim's own behavior). */
     probeConvergenceEvidence?: boolean;
 }
 export interface GraphGateClaimResponse {
@@ -903,7 +903,7 @@ export declare function decodeOrphanedPinNotifyResponse(value: unknown): Orphane
 /** The complete, closed set of IPC command names this contract defines. */
 export declare const TURN_IPC_COMMANDS: readonly ["turn_observe", "mesh_record", "turn_cancel", "operator_status", "turn_query", "mesh_index_query", "mission_upsert", "mission_query", "note_upsert", "note_forget", "tool_call_record", "ledger_query", "mission_list_query", "record_local", "queue_query", "queue_enqueue", "queue_enqueue_graph", "queue_cancel", "queue_requeue", "direct_dispatch_record", "graph_audit_record", "active_work_query", "recovery_context_query", "graph_gate_claim", "graph_gate_release", "graph_gate_abandon", "graph_node_patch", "graph_view_query", "task_stats_query", "prune_stale_direct", "orphaned_pin_notify"];
 export type TurnIpcCommand = typeof TURN_IPC_COMMANDS[number];
-export declare const isTurnIpcCommand: (value: unknown) => value is "operator_status" | "turn_observe" | "mesh_record" | "turn_cancel" | "turn_query" | "mesh_index_query" | "mission_upsert" | "mission_query" | "note_upsert" | "note_forget" | "tool_call_record" | "ledger_query" | "mission_list_query" | "record_local" | "queue_query" | "queue_enqueue" | "queue_enqueue_graph" | "queue_cancel" | "queue_requeue" | "direct_dispatch_record" | "graph_audit_record" | "active_work_query" | "recovery_context_query" | "graph_gate_claim" | "graph_gate_release" | "graph_gate_abandon" | "graph_node_patch" | "graph_view_query" | "task_stats_query" | "prune_stale_direct" | "orphaned_pin_notify";
+export declare const isTurnIpcCommand: (value: unknown) => value is "prune_stale_direct" | "operator_status" | "turn_observe" | "mesh_record" | "turn_cancel" | "turn_query" | "mesh_index_query" | "mission_upsert" | "mission_query" | "note_upsert" | "note_forget" | "tool_call_record" | "ledger_query" | "mission_list_query" | "record_local" | "queue_query" | "queue_enqueue" | "queue_enqueue_graph" | "queue_cancel" | "queue_requeue" | "direct_dispatch_record" | "graph_audit_record" | "active_work_query" | "recovery_context_query" | "graph_gate_claim" | "graph_gate_release" | "graph_gate_abandon" | "graph_node_patch" | "graph_view_query" | "task_stats_query" | "orphaned_pin_notify";
 /** Request type keyed by command name — for a generically-typed dispatcher on either end. */
 export interface TurnIpcRequestByCommand {
     turn_observe: TurnObserveRequest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/mesh-shared",
-  "version": "1.0.60-rc.52",
+  "version": "1.0.60-rc.54",
   "description": "ADHDev mesh-shared — pure mesh/git status normalizers shared by daemon-core and web-core",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/brain-routing.ts

@@ -66,7 +66,7 @@ export function isMeshTaskDifficulty(value: unknown): value is MeshTaskDifficult
  *      a value that should never have been stamped provider-blind.
  *
  *   2. IT FOUGHT THE SLOTS. Operators express model choice per node via
- *      capability slots (`mesh_node_slots_set`), which know the provider. A
+ *      capability slots (`mesh_node_slots` action "set"), which know the provider. A
  *      mesh-wide preset that also picks a model duplicated that decision from a
  *      position with strictly less information, and needed the modelSource
  *      ('explicit' vs 'preset') precedence machinery plus a fail-closed

package/src/magi.ts

@@ -59,7 +59,7 @@
  * already pinned the (node, provider) target, so any difficulty would be inert at best
  * and would fight the panel's own slot selection at worst. To change how hard a
  * replica thinks or how much parallelism a node grants, edit that NODE's capability
- * slots (`mesh_node_slots_set`); it is a different axis, on purpose.
+ * slots (`mesh_node_slots` action "set"); it is a different axis, on purpose.
  *
  * Unknown keys are dropped rather than rejected, so slots written by another version
  * stay readable. Write paths pair the normalizer with

package/src/mesh-tool-names.ts

@@ -28,9 +28,7 @@ export const CANONICAL_MESH_TOOL_NAMES = [
     'mesh_view_queue',
     // GRAPH-ORCHESTRATION Phase E — the coordinator gate + graph view surface.
     'mesh_graph_view',
-    'mesh_graph_gate_claim',
-    'mesh_graph_gate_release',
-    'mesh_graph_gate_abandon',
+    'mesh_graph_gate',
     'mesh_graph_node_patch',
     'mesh_queue_cancel',
     'mesh_queue_requeue',
@@ -48,7 +46,6 @@ export const CANONICAL_MESH_TOOL_NAMES = [
     'mesh_approve',
     'mesh_answer_question',
     'mesh_list_pending_approvals',
-    'mesh_plan_onboarding',
     'mesh_create',
     'mesh_add_node',
     'mesh_clone_node',
@@ -56,34 +53,84 @@ export const CANONICAL_MESH_TOOL_NAMES = [
     'mesh_cleanup_worktree_nodes',
     'mesh_refine_node',
     'mesh_refine_batch',
-    'mesh_refine_config',
-    'mesh_change_impact_config',
+    'mesh_config',
     'mesh_init',
-    'mesh_reinit',
-    'mesh_write_mesh_json_config',
     'mesh_refine_plan',
     'mesh_cleanup_sessions',
-    'mesh_prune_stale_direct',
     'mesh_task_history',
     'mesh_ledger_query',
-    'mesh_record_note',
-    'mesh_forget_note',
+    'mesh_note',
     'mesh_reconcile_ledger',
     'mesh_mission_upsert',
     'mesh_mission_list',
     'mesh_review_inbox',
     'mesh_magi_review',
     'mesh_magi_collect',
-    'mesh_magi_kind_panel_set',
-    'mesh_magi_kind_panel_list',
-    'mesh_node_slots_set',
-    'mesh_node_slots_list',
-    'mesh_node_slots_propose',
-    'mesh_coordinator_prompt_append_get',
-    'mesh_coordinator_prompt_append_set',
+    'mesh_magi_kind_panel',
+    'mesh_node_slots',
+    'mesh_coordinator_prompt_append',
 ] as const;
 
 export type CanonicalMeshToolName = typeof CANONICAL_MESH_TOOL_NAMES[number];
 
 /** The count the `NN tools` barrel doc comments and consistency test assert against. */
 export const CANONICAL_MESH_TOOL_COUNT = CANONICAL_MESH_TOOL_NAMES.length;
+
+/**
+ * Tool names retired by the 2026-09-26 tool-surface consolidation (60 → 48).
+ * Every capability behind them is still reachable: each retired name maps to the
+ * merged tool plus the discriminator argument that selects the same behaviour.
+ *
+ * mcp-server answers a call to a retired name with an error naming the
+ * replacement (it does NOT forward silently — a coordinator running an old
+ * prompt must learn the new spelling), and the daemon-core coordinator prompt
+ * test asserts none of these names is advertised anywhere in the prompt.
+ *
+ * `args` is the discriminator to add; every other argument keeps its name.
+ * `note` covers the one rename where an argument moved (the old
+ * `mesh_graph_gate_claim({ extend_seconds })` extend-only mode).
+ */
+export const RETIRED_MESH_TOOLS: Readonly<Record<string, {
+    readonly tool: CanonicalMeshToolName;
+    readonly args: Readonly<Record<string, string>>;
+    readonly note?: string;
+}>> = {
+    mesh_graph_gate_claim: {
+        tool: 'mesh_graph_gate',
+        args: { action: 'claim' },
+        note: 'The extend-only form (claim with extend_seconds) is now action: "extend" with the same extend_seconds.',
+    },
+    mesh_graph_gate_release: { tool: 'mesh_graph_gate', args: { action: 'release' } },
+    mesh_graph_gate_abandon: { tool: 'mesh_graph_gate', args: { action: 'abandon' } },
+    // Never a published tool (it is the daemon command behind the extend verb),
+    // but an older gate-expiry notice told coordinators to call it by this name.
+    mesh_graph_gate_extend: { tool: 'mesh_graph_gate', args: { action: 'extend' } },
+    mesh_node_slots_set: { tool: 'mesh_node_slots', args: { action: 'set' } },
+    mesh_node_slots_list: { tool: 'mesh_node_slots', args: { action: 'list' } },
+    mesh_node_slots_propose: { tool: 'mesh_node_slots', args: { action: 'propose' } },
+    mesh_magi_kind_panel_set: { tool: 'mesh_magi_kind_panel', args: { action: 'set' } },
+    mesh_magi_kind_panel_list: { tool: 'mesh_magi_kind_panel', args: { action: 'list' } },
+    mesh_coordinator_prompt_append_get: { tool: 'mesh_coordinator_prompt_append', args: { action: 'get' } },
+    mesh_coordinator_prompt_append_set: { tool: 'mesh_coordinator_prompt_append', args: { action: 'set' } },
+    mesh_record_note: { tool: 'mesh_note', args: { action: 'record' } },
+    mesh_forget_note: { tool: 'mesh_note', args: { action: 'forget' } },
+    mesh_reinit: { tool: 'mesh_init', args: { mode: 'reinit' } },
+    mesh_refine_config: { tool: 'mesh_config', args: { kind: 'refine' } },
+    mesh_change_impact_config: { tool: 'mesh_config', args: { kind: 'change_impact' } },
+    mesh_write_mesh_json_config: { tool: 'mesh_config', args: { kind: 'mesh_json' } },
+    mesh_plan_onboarding: { tool: 'mesh_create', args: { mode: 'plan' } },
+    mesh_prune_stale_direct: { tool: 'mesh_cleanup_sessions', args: { mode: 'prune_stale_direct' } },
+};
+
+/**
+ * The error text for a call to a retired tool name, or null when `name` is not
+ * retired. One wording shared by every MCP mode so the redirect reads the same
+ * wherever an old prompt calls it.
+ */
+export function retiredMeshToolError(name: string): string | null {
+    const entry = Object.prototype.hasOwnProperty.call(RETIRED_MESH_TOOLS, name) ? RETIRED_MESH_TOOLS[name] : undefined;
+    if (!entry) return null;
+    const discriminator = Object.entries(entry.args).map(([k, v]) => `${k}: "${v}"`).join(', ');
+    return `Tool "${name}" was retired (merged into ${entry.tool}). Call ${entry.tool} with ${discriminator} and the same other arguments.`
+        + (entry.note ? ` ${entry.note}` : '');
+}

package/src/slot-proposal.ts

@@ -3,7 +3,7 @@
  *
  * Detection of installed CLI providers already exists per node (the status
  * snapshot's `availableProviders`), and applying a slot profile already exists
- * (`mesh_node_slots_set`, dry-run by default). What was missing is the bit in
+ * (`mesh_node_slots` action "set", dry-run by default). What was missing is the bit in
  * between: turning "these CLIs are installed on this node" into a concrete
  * `NodeCapabilitySlot[]` draft the operator can review. This module is that
  * bridge, and nothing more — it is a PURE proposal generator. It never writes;

package/src/turn-ipc.ts

@@ -1675,8 +1675,8 @@ export function decodeRecoveryContextQueryResponse(value: unknown): RecoveryCont
 // Wiring-unification Phase C, workstream C-W9c (2026-09-24 19:00 stamp
 // "mcp-server graph gates/plan/patch ... still call daemon-core in-process").
 //
-// `mesh-tools-graph.ts`'s five graph-orchestration tools (`mesh_graph_gate_claim`
-// / `_release` / `_abandon`, `mesh_graph_node_patch`, `mesh_graph_view`) called
+// `mesh-tools-graph.ts`'s five graph-orchestration tools (the gate claim
+// / release / abandon verbs, now `mesh_graph_gate`, `mesh_graph_node_patch`, `mesh_graph_view`) called
 // daemon-core's MeshRuntimeStore-backed graph module in-process
 // (`claimMeshGraphGate` / `releaseMeshGraphGate` / `abandonMeshGraphGate` /
 // `patchGraphNodeAndRetry` / `buildMeshGraphViews`, all in `mesh-graph-gates.ts` /
@@ -1700,7 +1700,7 @@ export interface GraphGateClaimRequest {
     coordinatorSessionId: string
     leaseSeconds?: number
     extendDeadlineSeconds?: number
-    /** Also collect `collectGateConvergenceEvidence` on a successful claim (mesh_graph_gate_claim's own behavior). */
+    /** Also collect `collectGateConvergenceEvidence` on a successful claim (mesh_graph_gate action=claim's own behavior). */
     probeConvergenceEvidence?: boolean
 }
 
@@ -1760,7 +1760,7 @@ export interface GraphGateReleaseRequest {
 // roll back — mesh-graph-gates.ts file header). The daemon handler catches
 // that and reports it as a RESULT, not an IPC-level failure (the same
 // success:true-carries-a-refusal shape `queue_enqueue_graph` already uses) —
-// `mesh_graph_gate_release`'s tool layer classifies `refusalCode` by prefix
+// `mesh_graph_gate` action=release's tool layer classifies `refusalCode` by prefix
 // exactly as it did the in-process thrown message.
 export type GraphGateReleaseResponse =
     | {
@@ -2003,7 +2003,7 @@ export function decodeTaskStatsQueryResponse(value: unknown): TaskStatsQueryResp
 // ─── prune_stale_direct ─────────────────────────────────────────────────────
 //
 // C-W9c: replaces the in-process `pruneStaleDirectDispatches` call
-// (`mesh_prune_stale_direct` tool, `mesh-tools-session.ts`). Unlike the other
+// (`mesh_cleanup_sessions` mode=prune_stale_direct, `mesh-tools-session.ts`). Unlike the other
 // C-W9 commands this one does NOT take its inputs (queue/records/direct
 // dispatches) on the wire — the daemon already reads them itself
 // (`getQueue`/`readLocalRecords`/`getActiveDirectDispatches`), so the request