@adhdev/mesh-shared 1.0.60-rc.73 → 1.0.60-rc.74

package/dist/json.d.ts

@@ -9,7 +9,11 @@
  */
 export type JsonRecord = Record<string, unknown>;
 export declare function readRecord(value: unknown): JsonRecord;
+/** A plain-object record, or undefined — for callers that must tell "absent" from "empty". */
+export declare function readOptionalRecord(value: unknown): JsonRecord | undefined;
 export declare function readString(...values: unknown[]): string | undefined;
+/** The first non-blank trimmed string, or '' — readString for callers that want a plain string. */
+export declare function readText(...values: unknown[]): string;
 export declare function readNumber(...values: unknown[]): number | undefined;
 export declare function readBoolean(...values: unknown[]): boolean | undefined;
 export declare function readStringArray(value: unknown): string[];

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

@@ -18,10 +18,10 @@
  * 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", "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 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_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_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: 48;
+export declare const CANONICAL_MESH_TOOL_COUNT: 42;
 /**
  * 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
@@ -33,8 +33,7 @@ export declare const CANONICAL_MESH_TOOL_COUNT: 48;
  * 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).
+ * `note` carries any extra guidance when an argument moved in a rename.
  */
 export declare const RETIRED_MESH_TOOLS: Readonly<Record<string, {
     readonly tool: CanonicalMeshToolName;
@@ -42,8 +41,13 @@ export declare const RETIRED_MESH_TOOLS: Readonly<Record<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.
+ * Tool names removed outright (no merged replacement), mapped to the guidance a
+ * coordinator on an old prompt needs to do the same job with the remaining tools.
+ */
+export declare const REMOVED_MESH_TOOLS: Readonly<Record<string, string>>;
+/**
+ * The error text for a call to a retired or removed tool name, or null when
+ * `name` is neither. 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/mesh-vocabulary.d.ts

@@ -38,8 +38,7 @@ export type MeshThinkingLevel = typeof MESH_THINKING_LEVELS[number];
 export declare const MESH_DELIVERY_MODES: readonly ["when_idle", "interrupt"];
 export type MeshDeliveryMode = typeof MESH_DELIVERY_MODES[number];
 /**
- * What to do with a node's sessions when the node is removed or a MAGI fan-out
- * settles. Declared here so daemon-core (`RepoMeshSessionCleanupMode`), the
+ * What to do with a node's sessions when the node is removed. Declared here so daemon-core (`RepoMeshSessionCleanupMode`), the
  * web dashboard picker and the MCP schemas all read one list.
  */
 export declare const MESH_SESSION_CLEANUP_MODES: readonly ["preserve", "stop", "delete_stopped", "stop_and_delete"];

package/dist/outbound-message.d.ts

@@ -132,9 +132,8 @@ export type SendRefusal = 'not_ready' | 'send_in_flight' | 'not_generating' | 'n
  *                   a turn is generating (`send_now`). Written, not yet answered;
  *   `interrupt`   — the turn in flight was stopped first, then this body was
  *                   written (or re-parked) as a new turn;
- *   `acp`         — handed to an ACP agent's `session/prompt`.
  */
-export type SubmitRoute = 'pty' | 'agent_queue' | 'interrupt' | 'acp';
+export type SubmitRoute = 'pty' | 'agent_queue' | 'interrupt';
 /** The stop key pressed by an `interrupt` submit (logs / operator display). */
 export interface SubmitInterruptDetail {
     keyName: string;

package/dist/protocol/daemon-server.d.ts

@@ -157,11 +157,6 @@ export type AuthOkWirePayload = {
     machineNickname: string | null;
     seqscribeFleetSecret?: string;
     seqscribeFleetSecretVersion?: number;
-    /** Beacon board seed for cold start (advisory, may be absent). */
-    beaconSeed?: {
-        reports: unknown[];
-        truncated: number;
-    };
     limits: AuthOkPlanLimits;
 };
 export type AuthErrorWirePayload = {
@@ -207,14 +202,6 @@ export type DaemonErrorWirePayload = {
     message?: string;
     detail?: unknown;
 };
-export type BeaconVectorsWirePayload = {
-    op: 'put';
-    report: unknown;
-} | {
-    op: 'get';
-    topics: string[];
-    requestId: string;
-};
 export declare const P2P_SIGNAL_TYPES: readonly ["p2p_ready", "p2p_offer", "p2p_answer", "p2p_ice"];
 export type P2PSignalType = typeof P2P_SIGNAL_TYPES[number];
 export declare const isP2PSignalType: (value: unknown) => value is "p2p_ready" | "p2p_offer" | "p2p_answer" | "p2p_ice";
@@ -258,9 +245,9 @@ export declare const isMeshP2PSignalType: (value: unknown) => value is "mesh_p2p
 export type MeshP2PSignalWirePayload = {
     senderDaemonId: string;
 } & Record<string, unknown>;
-export declare const DAEMON_TO_SERVER_TYPES: readonly ["auth", "status_report", "status_heartbeat", "status_event", "command_result", "error", "agent_event", "beacon_vectors", "daemon_mesh_command", "p2p_offer", "p2p_ice"];
+export declare const DAEMON_TO_SERVER_TYPES: readonly ["auth", "status_report", "status_heartbeat", "status_event", "command_result", "error", "agent_event", "daemon_mesh_command", "p2p_offer", "p2p_ice"];
 export type DaemonToServerType = typeof DAEMON_TO_SERVER_TYPES[number];
-export declare const isDaemonToServerType: (value: unknown) => value is "error" | "p2p_offer" | "p2p_ice" | "auth" | "status_report" | "status_heartbeat" | "status_event" | "command_result" | "agent_event" | "beacon_vectors" | "daemon_mesh_command";
+export declare const isDaemonToServerType: (value: unknown) => value is "error" | "p2p_offer" | "p2p_ice" | "auth" | "status_report" | "status_heartbeat" | "status_event" | "command_result" | "agent_event" | "daemon_mesh_command";
 export type DaemonAuthMsg = Envelope<'auth', DaemonAuthWirePayload>;
 export type StatusReportMsg = Envelope<'status_report', CloudStatusReportWirePayload>;
 export type StatusHeartbeatMsg = Envelope<'status_heartbeat', StatusHeartbeatWirePayload>;
@@ -269,7 +256,6 @@ export type CommandResultMsg = Envelope<'command_result', CommandResultWirePaylo
 export type DaemonErrorMsg = Envelope<'error', DaemonErrorWirePayload>;
 /** Agent-level event forwarded verbatim to the `agent:status` webhook (throttled server-side). Dynamic by design. */
 export type AgentEventMsg = Envelope<'agent_event', CommandPayload>;
-export type BeaconVectorsMsg = Envelope<'beacon_vectors', BeaconVectorsWirePayload>;
 export type DaemonP2POfferMsg = Envelope<'p2p_offer', P2POfferWirePayload>;
 export type DaemonP2PIceMsg = Envelope<'p2p_ice', P2PIceWirePayload>;
 /**
@@ -285,7 +271,7 @@ export type DaemonMeshCommandMsg = {
     args: Record<string, unknown>;
     timestamp: number;
 };
-export type DaemonToServerMsg = DaemonAuthMsg | StatusReportMsg | StatusHeartbeatMsg | DaemonStatusEventMsg | CommandResultMsg | DaemonErrorMsg | AgentEventMsg | BeaconVectorsMsg | DaemonMeshCommandMsg | DaemonP2POfferMsg | DaemonP2PIceMsg;
+export type DaemonToServerMsg = DaemonAuthMsg | StatusReportMsg | StatusHeartbeatMsg | DaemonStatusEventMsg | CommandResultMsg | DaemonErrorMsg | AgentEventMsg | DaemonMeshCommandMsg | DaemonP2POfferMsg | DaemonP2PIceMsg;
 /** Members that carry a `payload` object (everything except `daemon_mesh_command`). */
 export type DaemonToServerPayloadType = Exclude<DaemonToServerMsg, DaemonMeshCommandMsg>['type'];
 export type DaemonToServerPayloadOf<T extends DaemonToServerPayloadType> = Extract<DaemonToServerMsg, {
@@ -297,9 +283,9 @@ export type DaemonToServerPayloadOf<T extends DaemonToServerPayloadType> = Extra
  * token string because nothing downstream can proceed without one.
  */
 export declare function decodeDaemonToServer(raw: unknown): DaemonToServerMsg | null;
-export declare const SERVER_TO_DAEMON_CONTROL_TYPES: readonly ["auth_ok", "auth_error", "machine_evicted", "force_disconnect", "token_revoked", "version_mismatch", "force_update_required", "command", "agent_command", "resolve_action", "beacon_vectors_result", "daemon_mesh_result", "p2p_ready", "p2p_offer", "p2p_answer", "p2p_ice", "mesh_p2p_ready", "mesh_p2p_offer", "mesh_p2p_answer", "mesh_p2p_ice"];
+export declare const SERVER_TO_DAEMON_CONTROL_TYPES: readonly ["auth_ok", "auth_error", "machine_evicted", "force_disconnect", "token_revoked", "version_mismatch", "force_update_required", "command", "agent_command", "resolve_action", "daemon_mesh_result", "p2p_ready", "p2p_offer", "p2p_answer", "p2p_ice", "mesh_p2p_ready", "mesh_p2p_offer", "mesh_p2p_answer", "mesh_p2p_ice"];
 export type ServerToDaemonControlType = typeof SERVER_TO_DAEMON_CONTROL_TYPES[number];
-export declare const isServerToDaemonControlType: (value: unknown) => value is "p2p_ready" | "p2p_offer" | "p2p_answer" | "p2p_ice" | "mesh_p2p_ready" | "mesh_p2p_offer" | "mesh_p2p_answer" | "mesh_p2p_ice" | "command" | "auth_ok" | "auth_error" | "machine_evicted" | "force_disconnect" | "token_revoked" | "version_mismatch" | "force_update_required" | "agent_command" | "resolve_action" | "beacon_vectors_result" | "daemon_mesh_result";
+export declare const isServerToDaemonControlType: (value: unknown) => value is "p2p_ready" | "p2p_offer" | "p2p_answer" | "p2p_ice" | "mesh_p2p_ready" | "mesh_p2p_offer" | "mesh_p2p_answer" | "mesh_p2p_ice" | "command" | "auth_ok" | "auth_error" | "machine_evicted" | "force_disconnect" | "token_revoked" | "version_mismatch" | "force_update_required" | "agent_command" | "resolve_action" | "daemon_mesh_result";
 /** Optional routing fields the server stamps on relayed commands. */
 type ServerRelayFields = {
     id?: MessageId;
@@ -324,15 +310,6 @@ export type ServerAgentCommandMsg = Envelope<'agent_command', {
 export type ServerResolveActionMsg = Envelope<'resolve_action', CommandPayload> & ServerRelayFields;
 export type ServerP2PSignalMsg = Envelope<P2PSignalType, RelayedP2PSignalWirePayload> & ServerRelayFields;
 export type ServerMeshP2PSignalMsg = Envelope<MeshP2PSignalType, MeshP2PSignalWirePayload> & ServerRelayFields;
-/** Reply to a `beacon_vectors` GET, correlated by `requestId` (top-level, no payload). A PUT gets no reply. */
-export type BeaconVectorsResultMsg = {
-    type: 'beacon_vectors_result';
-    requestId: string;
-    success: boolean;
-    reports?: unknown[];
-    truncated?: number;
-    error?: string;
-};
 /** Correlated ack/nack of a `daemon_mesh_command` (top-level, no payload). */
 export type DaemonMeshResultMsg = {
     type: 'daemon_mesh_result';
@@ -341,7 +318,7 @@ export type DaemonMeshResultMsg = {
     result?: unknown;
     error?: string;
 };
-export type ServerToDaemonControlMsg = AuthOkMsg | AuthErrorMsg | MachineEvictedMsg | ForceDisconnectMsg | TokenRevokedMsg | VersionMismatchMsg | ForceUpdateRequiredMsg | ServerCommandMsg | ServerAgentCommandMsg | ServerResolveActionMsg | BeaconVectorsResultMsg | DaemonMeshResultMsg | ServerP2PSignalMsg | ServerMeshP2PSignalMsg;
+export type ServerToDaemonControlMsg = AuthOkMsg | AuthErrorMsg | MachineEvictedMsg | ForceDisconnectMsg | TokenRevokedMsg | VersionMismatchMsg | ForceUpdateRequiredMsg | ServerCommandMsg | ServerAgentCommandMsg | ServerResolveActionMsg | DaemonMeshResultMsg | ServerP2PSignalMsg | ServerMeshP2PSignalMsg;
 declare const directCommandBrand: unique symbol;
 /**
  * A command name relayed as the frame `type` — the OPEN namespace the REST API
@@ -364,7 +341,7 @@ export type ServerToDaemonMsg = ServerToDaemonControlMsg | ServerDirectCommandMs
 export type ServerToDaemonType = ServerToDaemonMsg['type'];
 export declare function isServerDirectCommandMsg(msg: ServerToDaemonMsg): msg is ServerDirectCommandMsg;
 /** Members of the control set that carry a `payload` object. */
-export type ServerToDaemonPayloadType = Exclude<ServerToDaemonControlMsg, BeaconVectorsResultMsg | DaemonMeshResultMsg>['type'];
+export type ServerToDaemonPayloadType = Exclude<ServerToDaemonControlMsg, DaemonMeshResultMsg>['type'];
 export type ServerToDaemonPayloadOf<T extends ServerToDaemonPayloadType> = Extract<ServerToDaemonControlMsg, {
     type: T;
 }>['payload'];
@@ -372,7 +349,7 @@ export declare function isDaemonDirectCommandType(value: unknown): value is Daem
 /**
  * Parse boundary for the daemon: is `raw` a frame this link accepts from the server?
  * Control members are checked for their discriminant and envelope shape; the
- * two payload-less replies need their `requestId`; any other well-formed
+ * payload-less `daemon_mesh_result` reply needs its `requestId`; any other well-formed
  * command name becomes a `ServerDirectCommandMsg`.
  */
 export declare function decodeServerToDaemon(raw: unknown): ServerToDaemonMsg | null;

package/dist/session-launch.d.ts

@@ -19,14 +19,6 @@
  * passed through {@link sanitizeModelIdentifier}) and `modelSource` (an enum,
  * passed through {@link isModelAxisSource}). Never widen that to the record.
  */
-/**
- * Where a model / thinking-level value came from.
- *
- * `restore` is deliberately NOT a member: a hosted session re-attached after a
- * daemon restart keeps the ORIGINAL source (the user still picked that model);
- * only `SessionLaunchRecord.launchedBy` records that the session came back via
- * restore.
- */
 export declare const MODEL_AXIS_SOURCES: readonly ["user", "remembered", "mesh_slot", "task_override", "provider_default", "unspecified"];
 export type ModelAxisSource = typeof MODEL_AXIS_SOURCES[number];
 export declare function isModelAxisSource(value: unknown): value is ModelAxisSource;

package/dist/slot-proposal.d.ts

@@ -1,5 +1,5 @@
 /**
- * CLI auto-detect → capability-slot / MAGI-panel PROPOSAL generator.
+ * CLI auto-detect → capability-slot PROPOSAL generator.
  *
  * Detection of installed CLI providers already exists per node (the status
  * snapshot's `availableProviders`), and applying a slot profile already exists
@@ -27,7 +27,6 @@
  * need it, and it is pure data + pure functions on plain objects.
  */
 import { type MeshTaskDifficulty, type NodeCapabilitySlot } from './brain-routing';
-import type { MagiSlot } from './magi';
 /**
  * One provider's seeded slot recipe. A provider may map to MORE THAN ONE slot
  * (claude-cli does: a wide sonnet slot plus a narrow opus slot for the hard
@@ -120,28 +119,3 @@ export interface SlotProposal {
  * returned proposal can report what a wholesale write would destroy.
  */
 export declare function buildSlotProposal(detected: readonly DetectedCliProvider[], currentSlots?: readonly NodeCapabilitySlot[]): SlotProposal;
-/**
- * Build a MAGI panel proposal from the same detections.
- *
- * ─── Deliberately narrow ──────────────────────────────────────────────────────
- *
- * MAGI's value is provider INDEPENDENCE: replicas from different providers
- * (ideally different machines) answering the same question, so agreement means
- * something. Detection tells us which providers exist — that is exactly enough
- * to propose one panel of distinct providers, and no more.
- *
- * What detection does NOT tell us is which provider suits which review KIND
- * (rca vs design vs claim_audit). Nothing in any manifest grades a provider for
- * root-cause analysis over design review, and inventing a per-kind assignment
- * would fabricate a rationale that does not exist. So this proposes ONE panel of
- * the detected providers and leaves the kind binding to the operator; the caller
- * decides which `task_kind` to bind it to via the existing dry-run tool.
- *
- * Ordering follows {@link CLI_SLOT_RECIPES} insertion order (recipe-known
- * providers first, in table order), so the panel leads with the providers whose
- * suitability is actually attested.
- */
-export declare function buildMagiPanelProposal(detected: readonly DetectedCliProvider[], opts?: {
-    nodeId?: string;
-    maxSlots?: number;
-}): MagiSlot[];

package/dist/turn-ipc-mission.d.ts

@@ -7,8 +7,6 @@ import { TURN_IPC_PROTOCOL_VERSION } from './turn-ipc-guards';
 export declare const MESH_MISSION_STATUSES: readonly ["active", "paused", "completed", "abandoned"];
 export type MeshMissionStatusValue = typeof MESH_MISSION_STATUSES[number];
 export declare const isMeshMissionStatusValue: (value: unknown) => value is "active" | "completed" | "paused" | "abandoned";
-export declare const MESH_MISSION_SOURCES: readonly ["magi", "coordinator"];
-export type MeshMissionSourceValue = typeof MESH_MISSION_SOURCES[number];
 export interface MissionBriefWire {
     goal: string;
     constraints?: readonly string[];
@@ -25,7 +23,6 @@ export interface MissionUpsertRequest {
     /** Free text — see file-header note on why this is fine over local IPC. */
     goal?: string;
     status?: MeshMissionStatusValue;
-    source?: MeshMissionSourceValue;
     /**
      * H2: `undefined` = do not touch the stored brief. `null` = explicitly clear it.
      * A present object with no usable `goal` is treated by the daemon's own
@@ -40,7 +37,6 @@ export interface MeshMissionRecordWire {
     title: string;
     goal: string;
     status: MeshMissionStatusValue;
-    source?: MeshMissionSourceValue;
     /** H2: absent = no brief attached to this mission. */
     brief?: MissionBriefWire;
 }
@@ -68,7 +64,6 @@ export interface MissionListQueryRequest {
     meshId: string;
     statuses?: readonly MeshMissionStatusValue[];
     verbose?: boolean;
-    includeMagi?: boolean;
     withStats?: boolean;
     limit?: number;
     historyIdLimit?: number;
@@ -110,7 +105,6 @@ export interface MissionListSummaryVerboseWire {
     title: string;
     goal: string;
     status: MeshMissionStatusValue;
-    source?: MeshMissionSourceValue;
     tasks: MeshMissionTaskAggregateWire;
     stats?: MeshMissionStatsWire;
     /** H2: absent = no brief attached. */
@@ -128,7 +122,6 @@ export interface MissionListSummarySlimWire {
     goalPreview: string;
     goalTruncated: boolean;
     status: MeshMissionStatusValue;
-    source?: MeshMissionSourceValue;
     tasks: MeshMissionTaskAggregateWire;
     stats?: MeshMissionStatsWire;
     /** H2: absent = no brief attached. */

package/dist/turn-ipc-queue.d.ts

@@ -1,7 +1,7 @@
 /**
  * turn-ipc — local records, queue composites and active work (C-W9a):
- * record_local, queue_query, queue_enqueue, queue_enqueue_graph, queue_cancel,
- * queue_requeue, direct_dispatch_record, graph_audit_record, active_work_query,
+ * record_local, queue_query, queue_enqueue, queue_enqueue_batch, queue_cancel,
+ * queue_requeue, direct_dispatch_record, active_work_query,
  * recovery_context_query. Part of the turn-ipc wire contract (./turn-ipc.ts).
  */
 import { TURN_IPC_PROTOCOL_VERSION } from './turn-ipc-guards';
@@ -47,7 +47,7 @@ export interface QueueQueryRequest {
     /** With `withCounts`: also count terminal rows whose `updated_at` is older than this age. */
     historicalOlderThanMs?: number;
     /**
-     * Also return `dependencyHeads`: id/status/blockedReason/cancelReason of every
+     * Also return `dependencyHeads`: id/status/cancelReason of every
      * row the returned entries list in `dependsOn` that is not itself returned —
      * enough to annotate dependency state without reading the whole queue.
      */
@@ -57,7 +57,6 @@ export interface QueueQueryRequest {
 export interface QueueDependencyHeadWire {
     id: string;
     status: string;
-    blockedReason?: string;
     cancelReason?: string;
 }
 export interface QueueQueryResponse {
@@ -77,37 +76,29 @@ export interface QueueEnqueueRequest {
     /** Free text (the task message — see the section note). */
     message: string;
     options?: Record<string, unknown>;
-    /** `recordSingleEnqueueDecision` args minus `taskId` (the daemon fills it). */
-    decision?: Record<string, unknown>;
 }
 export interface QueueEnqueueResponse {
     entry: QueueEntryWire;
 }
 export declare function decodeQueueEnqueueRequest(value: unknown): QueueEnqueueRequest | null;
 export declare function decodeQueueEnqueueResponse(value: unknown): QueueEnqueueResponse | null;
-export interface QueueEnqueueGraphRequest {
+export interface QueueEnqueueBatchRequest {
     v: typeof TURN_IPC_PROTOCOL_VERSION;
     meshId: string;
-    mode: 'compat' | 'graph';
-    /** compat: `MeshTaskGraphEntrySpec[]` (JSON passthrough). */
-    specs?: readonly Record<string, unknown>[];
-    /** graph: `commitMeshGraphPlan` input minus `meshId` (JSON passthrough). */
-    plan?: Record<string, unknown>;
-    /** Audit context: batchId / missionId / coordinatorSessionId / onDependencyFailure / orchestrationDecision / taskCount. */
-    audit?: Record<string, unknown>;
-}
-export type QueueEnqueueGraphResponse = {
+    /** `MeshTaskBatchEntrySpec[]` (daemon-core, JSON passthrough). */
+    specs: readonly Record<string, unknown>[];
+}
+export type QueueEnqueueBatchResponse = {
     ok: true;
     tasks: readonly QueueEntryWire[];
-    graph?: Record<string, unknown>;
 } | {
     ok: false;
     refusalCode?: string;
     message: string;
     extra?: Record<string, unknown>;
 };
-export declare function decodeQueueEnqueueGraphRequest(value: unknown): QueueEnqueueGraphRequest | null;
-export declare function decodeQueueEnqueueGraphResponse(value: unknown): QueueEnqueueGraphResponse | null;
+export declare function decodeQueueEnqueueBatchRequest(value: unknown): QueueEnqueueBatchRequest | null;
+export declare function decodeQueueEnqueueBatchResponse(value: unknown): QueueEnqueueBatchResponse | null;
 export interface QueueCancelRequest {
     v: typeof TURN_IPC_PROTOCOL_VERSION;
     meshId: string;
@@ -143,28 +134,12 @@ export interface DirectDispatchRecordRequest {
     message: string;
     /** `recordDirectDispatchTask` options minus `id` (JSON passthrough). */
     task?: Record<string, unknown>;
-    /** `recordDirectDispatchDecision` args minus `taskId` (JSON passthrough). */
-    decision?: Record<string, unknown>;
 }
 export interface DirectDispatchRecordResponse {
     taskRecorded: boolean;
-    decisionRecorded: boolean;
 }
 export declare function decodeDirectDispatchRecordRequest(value: unknown): DirectDispatchRecordRequest | null;
 export declare function decodeDirectDispatchRecordResponse(value: unknown): DirectDispatchRecordResponse | null;
-export declare const GRAPH_AUDIT_EVENTS: readonly ["gate_claimed", "gate_released", "gate_abandoned", "node_patched"];
-export type GraphAuditEvent = typeof GRAPH_AUDIT_EVENTS[number];
-export interface GraphAuditRecordRequest {
-    v: typeof TURN_IPC_PROTOCOL_VERSION;
-    meshId: string;
-    event: GraphAuditEvent;
-    fields: Record<string, unknown>;
-}
-export interface GraphAuditRecordResponse {
-    recorded: boolean;
-}
-export declare function decodeGraphAuditRecordRequest(value: unknown): GraphAuditRecordRequest | null;
-export declare function decodeGraphAuditRecordResponse(value: unknown): GraphAuditRecordResponse | null;
 export interface ActiveWorkQueryRequest {
     v: typeof TURN_IPC_PROTOCOL_VERSION;
     meshId: string;

package/dist/turn-ipc-stats.d.ts

@@ -0,0 +1,72 @@
+/**
+ * turn-ipc — task stats and maintenance commands: task_stats_query,
+ * prune_stale_direct, orphaned_pin_notify. Part of the turn-ipc wire contract
+ * (./turn-ipc.ts).
+ */
+import { TURN_IPC_PROTOCOL_VERSION } from './turn-ipc-guards';
+export interface TaskStatsQueryRequest {
+    v: typeof TURN_IPC_PROTOCOL_VERSION;
+    meshId: string;
+    taskIds?: readonly string[];
+    missionId?: string;
+    tail?: number;
+    /** Also compute `computeMeshMissionStats` — requires `missionId`. */
+    rollup?: boolean;
+    /**
+     * Batch rollups: `computeMeshMissionStats` for every id, over ONE queue read and
+     * ONE record read (answers `missions`, `tasks` empty). Exclusive with
+     * `taskIds`/`missionId`. An older daemon rejects the key.
+     */
+    missionIds?: readonly string[];
+}
+export interface TaskStatsQueryResponse {
+    /** `MeshTaskStats[]`, JSON passthrough. */
+    tasks: readonly Record<string, unknown>[];
+    /** `MeshMissionStats`, JSON passthrough; present only when `rollup: true` was requested and satisfiable. */
+    mission?: Record<string, unknown>;
+    /** Batch mode: `MeshMissionStats` per requested mission id, JSON passthrough. */
+    missions?: Record<string, Record<string, unknown>>;
+}
+export declare function decodeTaskStatsQueryRequest(value: unknown): TaskStatsQueryRequest | null;
+export declare function decodeTaskStatsQueryResponse(value: unknown): TaskStatsQueryResponse | null;
+export interface PruneStaleDirectRequest {
+    v: typeof TURN_IPC_PROTOCOL_VERSION;
+    meshId: string;
+    execute?: boolean;
+    includeTerminal?: boolean;
+    source?: string;
+}
+export interface PruneStaleDirectResponse {
+    mode: 'execute' | 'dry_run';
+    includeTerminal: boolean;
+    candidateCount: number;
+    /** `MeshActiveWorkRecord[]`, JSON passthrough. */
+    prunable: readonly Record<string, unknown>[];
+    prunedCount: number;
+    preservedUnacknowledged: readonly Record<string, unknown>[];
+    preservedLedgerOnly: readonly Record<string, unknown>[];
+    preservedNotOrphan: readonly Record<string, unknown>[];
+}
+export declare function decodePruneStaleDirectRequest(value: unknown): PruneStaleDirectRequest | null;
+export declare function decodePruneStaleDirectResponse(value: unknown): PruneStaleDirectResponse | null;
+export interface OrphanedPinNotifyRequest {
+    v: typeof TURN_IPC_PROTOCOL_VERSION;
+    meshId: string;
+    stoppedSessionId: string;
+    excludeTaskId?: string;
+    cause?: string;
+    nodeId?: string;
+    coordinatorSessionId?: string;
+}
+export interface OrphanedPinnedTaskWire {
+    taskId: string;
+    title: string;
+    targetSessionId: string;
+    targetNodeId?: string;
+    missionId?: string;
+}
+export interface OrphanedPinNotifyResponse {
+    orphans: readonly OrphanedPinnedTaskWire[];
+}
+export declare function decodeOrphanedPinNotifyRequest(value: unknown): OrphanedPinNotifyRequest | null;
+export declare function decodeOrphanedPinNotifyResponse(value: unknown): OrphanedPinNotifyResponse | null;

package/dist/turn-ipc.d.ts

@@ -52,14 +52,14 @@
  * LAYOUT
  * -------
  * This module holds the error codes and the command registry; the per-command
- * contracts live in ./turn-ipc-{turn,mission,queue,graph}.ts (re-exported here)
+ * contracts live in ./turn-ipc-{turn,mission,queue,stats}.ts (re-exported here)
  * over the shared guard primitives in ./turn-ipc-guards.ts.
  */
 export { TURN_IPC_PROTOCOL_VERSION } from './turn-ipc-guards';
 export * from './turn-ipc-turn';
 export * from './turn-ipc-mission';
 export * from './turn-ipc-queue';
-export * from './turn-ipc-graph';
+export * from './turn-ipc-stats';
 /**
  * Closed error-code union every command response may carry instead of (or in
  * addition to, for the client-side wrapper) a result.
@@ -85,6 +85,6 @@ export interface TurnIpcError {
 }
 export declare function isTurnIpcError(value: unknown): value is TurnIpcError;
 /** 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 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_batch", "queue_cancel", "queue_requeue", "direct_dispatch_record", "active_work_query", "recovery_context_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 "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";
+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_batch" | "queue_cancel" | "queue_requeue" | "direct_dispatch_record" | "active_work_query" | "recovery_context_query" | "task_stats_query" | "orphaned_pin_notify";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/mesh-shared",
-  "version": "1.0.60-rc.73",
+  "version": "1.0.60-rc.74",
   "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

@@ -5,10 +5,8 @@
  * per-difficulty "brain" preset resolves that into a concrete provider / model /
  * thinking-level for the launched session. The goal is token economy: an `easy`
  * task runs on a cheaper model at low reasoning effort; a `difficult` task gets a
- * stronger model at high effort. This is a separate axis from MAGI's review kinds
- * (rca/design/…) — MAGI fans out review replicas; this picks the single brain that
- * *executes* a task — but it reuses the same slot shape (provider/model) and the
- * same machine-local storage (`~/.adhdev/meshes.json`).
+ * stronger model at high effort. This picks the single brain that *executes* a
+ * task, stored machine-local (`~/.adhdev/meshes.json`).
  */
 
 /** The fixed difficulty axis the coordinator classifies a task into. */
@@ -33,8 +31,8 @@ export interface BrainSlot {
 
 /**
  * Per-difficulty brain bindings for ONE mesh, stored machine-local in
- * `~/.adhdev/meshes.json` under that mesh's entry (`meshes[].difficultyBrains`,
- * sibling of `magiKindPanels`). The scope is per mesh: two meshes on the same
+ * `~/.adhdev/meshes.json` under that mesh's entry (`meshes[].difficultyBrains`).
+ * The scope is per mesh: two meshes on the same
  * machine hold independent presets, so one can pin `difficult` to a cheaper model
  * without changing what any other mesh runs. (It formerly sat at the config root
  * keyed by difficulty alone — and since this map picks the MODEL a task runs on,
@@ -118,8 +116,8 @@ export function normalizeDifficultyBrainMap(raw: unknown): DifficultyBrainMap {
 // capability slots. Each slot bundles what used to be scattered across
 // providerPriority (order), a per-provider maxParallel cap, and the
 // the owning mesh's difficultyBrains (difficulty → model/thinking). Slot order =
-// preference. This single profile is the source of truth for task routing, MAGI
-// fan-out, and orchestrator-proposed edits.
+// preference. This single profile is the source of truth for task routing and
+// orchestrator-proposed edits.
 // ─────────────────────────────────────────────────────────────────────────────
 
 /**

package/src/git-diff.ts

@@ -0,0 +1,48 @@
+/**
+ * Projection of a daemon `git_diff_file` answer into the per-file row the MCP
+ * `git_diff` tool and the cloud git-diff shortcut both return: the diff text
+ * capped at `maxLines` (with a visible truncation marker), plus the file's
+ * change metadata from the diff summary.
+ */
+
+import { readRecord } from './json'
+
+export interface GitFileDiffRow {
+    path: string
+    old_path?: string | null
+    status?: string
+    diff: string
+    truncated: boolean
+    binary: boolean
+    error?: string
+}
+
+/** Cap diff text at `maxLines`; a truncated diff ends with a `... (truncated)` marker line. */
+function truncateDiffText(text: string, maxLines: number): { diff: string; truncated: boolean } {
+    const lines = text.split('\n')
+    const truncated = lines.length > maxLines
+    return {
+        diff: truncated ? lines.slice(0, maxLines).join('\n') + '\n... (truncated)' : text,
+        truncated,
+    }
+}
+
+/** One changed file's row from its `git_diff_file` answer (either `{ diff: {...} }` or the bare diff record). */
+export function projectFileDiffRow(
+    file: { path: string; oldPath?: string | null; status?: string },
+    rawResult: unknown,
+    maxLines: number,
+): GitFileDiffRow {
+    const raw = readRecord(rawResult)
+    const d = readRecord(raw.diff ?? rawResult)
+    const text = typeof d.diff === 'string' ? d.diff : ''
+    const { diff, truncated } = truncateDiffText(text, maxLines)
+    return {
+        path: file.path,
+        old_path: file.oldPath ?? null,
+        status: file.status ?? 'M',
+        diff,
+        truncated,
+        binary: typeof d.binary === 'boolean' ? d.binary : false,
+    }
+}

package/src/index.ts

@@ -19,7 +19,7 @@ export * from './node-facts'
 export * from './workspace-normalize'
 export * from './daemon-normalize'
 export * from './git-summarize'
-export * from './magi'
+export * from './git-diff'
 export * from './brain-routing'
 export * from './slot-proposal'
 export * from './interpolation'

package/src/json.ts

@@ -14,6 +14,11 @@ export function readRecord(value: unknown): JsonRecord {
     return value && typeof value === 'object' && !Array.isArray(value) ? value as JsonRecord : {}
 }
 
+/** A plain-object record, or undefined — for callers that must tell "absent" from "empty". */
+export function readOptionalRecord(value: unknown): JsonRecord | undefined {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value as JsonRecord : undefined
+}
+
 export function readString(...values: unknown[]): string | undefined {
     for (const value of values) {
         if (typeof value !== 'string') continue
@@ -23,6 +28,11 @@ export function readString(...values: unknown[]): string | undefined {
     return undefined
 }
 
+/** The first non-blank trimmed string, or '' — readString for callers that want a plain string. */
+export function readText(...values: unknown[]): string {
+    return readString(...values) ?? ''
+}
+
 export function readNumber(...values: unknown[]): number | undefined {
     for (const value of values) {
         if (typeof value === 'number' && Number.isFinite(value)) return value