@adhdev/daemon-core 0.9.82-rc.448 → 0.9.82-rc.449

package/dist/commands/cli-manager.d.ts

@@ -38,6 +38,16 @@ export interface CliTransportFactoryParams {
     cliArgs?: string[];
     providerSessionId?: string;
     attachExisting?: boolean;
+    /**
+     * Launch-time record meta (meshNodeId / meshNodeFor / launchedByCoordinator /
+     * autoLaunchedForQueueTaskId). Defense-in-depth for SESSION-ACCUMULATION-LEAK:
+     * a session-host factory impl SHOULD seed the create_session record with this
+     * so the node binding is present the instant the record exists, rather than
+     * relying solely on the post-spawn updateRuntimeMeta round-trip. Optional and
+     * additive — factory impls that ignore it keep the prior behavior; the
+     * post-spawn WTDISPATCH stamp in register() still runs as the primary path.
+     */
+    initialMeta?: Record<string, unknown>;
 }
 export interface HostedCliRuntimeDescriptor {
     runtimeId: string;

package/dist/commands/med-family/types.d.ts

@@ -94,6 +94,16 @@ export interface MedFamilyContext {
         dryRun?: boolean;
         source?: 'mesh_cleanup_sessions' | 'mesh_remove_node' | 'magi_session_cleanup';
         requireAutoLaunchedForTaskIds?: Record<string, string>;
+        /**
+         * Opt-in orphan reclaim (default false). When true, a workspace-only live
+         * session (no node binding) OR a session bound to a node that no longer
+         * exists in `liveMeshNodeIds` is stopped instead of skipped — reclaims the
+         * SESSION-ACCUMULATION-LEAK orphans. `liveMeshNodeIds` is the current mesh's
+         * node id set; a session whose meshNodeId is still present is treated as an
+         * active sibling and left alone.
+         */
+        reclaimOrphans?: boolean;
+        liveMeshNodeIds?: string[];
     }) => Promise<{
         success: boolean;
         [key: string]: unknown;

package/dist/index.js

@@ -409,10 +409,10 @@ function readInjected(value) {
 }
 function getDaemonBuildInfo() {
   if (cached) return cached;
-  const commit = readInjected(true ? "7636b9d4fc6c456ebfe178b9b0a7b81664b02257" : void 0) ?? "unknown";
-  const commitShort = readInjected(true ? "7636b9d4" : void 0) ?? (commit !== "unknown" ? commit.slice(0, 7) : "unknown");
-  const version = readInjected(true ? "0.9.82-rc.448" : void 0) ?? readInjected(typeof process !== "undefined" ? process.env?.ADHDEV_PKG_VERSION : void 0) ?? "unknown";
-  const builtAt = readInjected(true ? "2026-07-02T00:30:54.215Z" : void 0);
+  const commit = readInjected(true ? "fe0e4d2aa03aea2793c2379e5ffc89abef5143d6" : void 0) ?? "unknown";
+  const commitShort = readInjected(true ? "fe0e4d2a" : void 0) ?? (commit !== "unknown" ? commit.slice(0, 7) : "unknown");
+  const version = readInjected(true ? "0.9.82-rc.449" : void 0) ?? readInjected(typeof process !== "undefined" ? process.env?.ADHDEV_PKG_VERSION : void 0) ?? "unknown";
+  const builtAt = readInjected(true ? "2026-07-03T01:58:07.610Z" : void 0);
   cached = builtAt ? { commit, commitShort, version, builtAt } : { commit, commitShort, version };
   return cached;
 }
@@ -38006,6 +38006,16 @@ var TerminalAdapter = class {
     this.recordEvent("input", capPreview(escapeControl(text)), text.length);
     this.pty?.write(text);
   }
+  /** Forward runtime metadata (meshNodeId, workspaceLabel, lifecycle, …) to
+   *  the underlying transport so it reaches the session registry. The spec
+   *  path previously dropped everything but providerSessionId here, which
+   *  left autoLaunch's meshNodeId stamp unbound on the record (see
+   *  SESSION-ACCUMULATION-LEAK). No-op when the transport does not support
+   *  metadata updates (e.g. plain node-pty). */
+  updateMeta(meta, replace = false) {
+    if (!this.pty || typeof this.pty.updateMeta !== "function") return;
+    this.pty.updateMeta(meta, replace);
+  }
   /** Debug-only: most-recent PTY input/output/resize/cursor events, oldest
    *  first. Pure observation — never consulted by the FSM. */
   getEventTimeline(limit = MAX_PTY_EVENTS) {
@@ -38305,6 +38315,13 @@ var FsmDriver = class {
         return;
     }
   }
+  /** Forward runtime metadata to the terminal transport so mesh binding
+   *  fields (meshNodeId / meshNodeFor / workspaceLabel / lifecycle) reach
+   *  the session registry. Not a DashboardCommand — this is a control-plane
+   *  update, not user input. */
+  updateMeta(meta, replace = false) {
+    this.adapter.updateMeta(meta, replace);
+  }
   snapshot() {
     return this.adapter.snapshot();
   }
@@ -40509,9 +40526,14 @@ var SpecCliAdapter = class _SpecCliAdapter {
     };
   }
   updateRuntimeMeta(meta) {
-    if (meta && typeof meta.providerSessionId === "string") {
+    if (!meta) return;
+    if (typeof meta.providerSessionId === "string") {
       this.providerSessionId = meta.providerSessionId;
     }
+    try {
+      this.driver.updateMeta(meta);
+    } catch {
+    }
   }
   refreshProviderDefinition() {
   }
@@ -44947,14 +44969,15 @@ var DaemonCliManager = class {
       console.error(colorize("red", `  \u2717 Failed to save recent activity: ${e}`));
     }
   }
-  getTransportFactory(runtimeId, providerType, workspace, cliArgs, providerSessionId, attachExisting = false) {
+  getTransportFactory(runtimeId, providerType, workspace, cliArgs, providerSessionId, attachExisting = false, initialMeta) {
     return this.deps.createPtyTransportFactory?.({
       runtimeId,
       providerType,
       workspace,
       cliArgs,
       providerSessionId,
-      attachExisting
+      attachExisting,
+      ...initialMeta && Object.keys(initialMeta).length ? { initialMeta } : {}
     }) || void 0;
   }
   createAdapter(cliType, workingDir, cliArgs, runtimeId, providerSessionId, attachExisting = false, extraEnv) {
@@ -45010,13 +45033,25 @@ var DaemonCliManager = class {
     const instanceManager = this.deps.getInstanceManager();
     const sessionRegistry = this.deps.getSessionRegistry?.() || null;
     if (!instanceManager) throw new Error("InstanceManager not available");
+    const launchMeshNodeId = typeof settings?.meshNodeId === "string" ? settings.meshNodeId.trim() : "";
+    const launchMeshNodeFor = typeof settings?.meshNodeFor === "string" ? settings.meshNodeFor.trim() : "";
+    const launchAutoLaunchedForQueueTaskId = typeof settings?.autoLaunchedForQueueTaskId === "string" ? settings.autoLaunchedForQueueTaskId.trim() : "";
+    const launchRecordMeta = {
+      ...launchMeshNodeId ? { meshNodeId: launchMeshNodeId } : {},
+      ...launchMeshNodeFor ? { meshNodeFor: launchMeshNodeFor } : {},
+      ...settings?.launchedByCoordinator === true ? { launchedByCoordinator: true } : {},
+      ...launchAutoLaunchedForQueueTaskId ? { autoLaunchedForQueueTaskId: launchAutoLaunchedForQueueTaskId } : {}
+    };
     const transportFactory = this.getTransportFactory(
       key2,
       normalizedType,
       resolvedDir,
       cliArgs,
       options?.providerSessionId,
-      attachExisting
+      attachExisting,
+      // Only seed at create time for fresh launches — an attach restores an
+      // existing record whose meta is already stamped; re-seeding could clobber.
+      attachExisting ? void 0 : launchRecordMeta
     );
     const cliInstance = new CliProviderInstance(provider, resolvedDir, cliArgs, key2, transportFactory, options);
     try {
@@ -45053,17 +45088,9 @@ var DaemonCliManager = class {
       throw new Error(`Failed to start ${provider.displayName || provider.name || cliType}: ${spawnErr?.message}`);
     }
     this.adapters.set(key2, cliInstance.getAdapter());
-    const launchMeshNodeId = typeof settings?.meshNodeId === "string" ? settings.meshNodeId.trim() : "";
-    const launchMeshNodeFor = typeof settings?.meshNodeFor === "string" ? settings.meshNodeFor.trim() : "";
-    const launchAutoLaunchedForQueueTaskId = typeof settings?.autoLaunchedForQueueTaskId === "string" ? settings.autoLaunchedForQueueTaskId.trim() : "";
-    if (launchMeshNodeId || launchMeshNodeFor || launchAutoLaunchedForQueueTaskId) {
+    if (Object.keys(launchRecordMeta).length) {
       try {
-        cliInstance.getAdapter().updateRuntimeMeta?.({
-          ...launchMeshNodeId ? { meshNodeId: launchMeshNodeId } : {},
-          ...launchMeshNodeFor ? { meshNodeFor: launchMeshNodeFor } : {},
-          ...settings?.launchedByCoordinator === true ? { launchedByCoordinator: true } : {},
-          ...launchAutoLaunchedForQueueTaskId ? { autoLaunchedForQueueTaskId: launchAutoLaunchedForQueueTaskId } : {}
-        });
+        cliInstance.getAdapter().updateRuntimeMeta?.({ ...launchRecordMeta });
       } catch {
       }
     }
@@ -50533,6 +50560,8 @@ var meshCrudHandlers = {
       const sessionIds = Array.isArray(args?.sessionIds) ? args.sessionIds.map((id) => typeof id === "string" ? id.trim() : "").filter(Boolean) : void 0;
       const source = args?.source === "magi_session_cleanup" ? "magi_session_cleanup" : "mesh_cleanup_sessions";
       const requireAutoLaunchedForTaskIds = args?.requireAutoLaunchedForTaskIds && typeof args.requireAutoLaunchedForTaskIds === "object" && !Array.isArray(args.requireAutoLaunchedForTaskIds) ? args.requireAutoLaunchedForTaskIds : void 0;
+      const reclaimOrphans = args?.reclaimOrphans === true;
+      const liveMeshNodeIds = Array.isArray(mesh?.nodes) ? mesh.nodes.map((n) => normalizeMeshNodeId(n)).filter(Boolean) : [];
       const result = await ctx.cleanupMeshSessions({
         meshId,
         nodeId,
@@ -50541,7 +50570,9 @@ var meshCrudHandlers = {
         sessionIds,
         dryRun: args?.dryRun === true,
         source,
-        requireAutoLaunchedForTaskIds
+        requireAutoLaunchedForTaskIds,
+        reclaimOrphans,
+        liveMeshNodeIds
       });
       return result;
     } catch (e) {
@@ -56626,6 +56657,13 @@ var DaemonCommandRouter = class {
     }
     if (!this.deps.sessionHostControl) return { success: false, error: "Session host control unavailable" };
     const requestedSessionIds = Array.isArray(args.sessionIds) ? new Set(args.sessionIds.map((id) => typeof id === "string" ? id.trim() : "").filter(Boolean)) : void 0;
+    const reclaimOrphans = args.reclaimOrphans === true;
+    const liveMeshNodeIds = Array.isArray(args.liveMeshNodeIds) ? args.liveMeshNodeIds.map((id) => typeof id === "string" ? id.trim() : "").filter(Boolean) : [];
+    const isNodeStillLive = (candidateNodeId) => {
+      if (!candidateNodeId) return false;
+      return liveMeshNodeIds.some((liveId) => liveId === candidateNodeId || meshNodeIdMatches({ id: liveId }, candidateNodeId) || daemonIdsEquivalent(liveId, candidateNodeId));
+    };
+    const reclaimedOrphanSessionIds = [];
     const sessions = await this.deps.sessionHostControl.listSessions();
     const matched = sessions.filter((record) => this.sessionMatchesMeshNode(record, args.node, args.nodeId, requestedSessionIds));
     const hasExplicitSessionIds = !!requestedSessionIds?.size;
@@ -56694,7 +56732,8 @@ var DaemonCommandRouter = class {
       const matchedByWorkspaceOnly = !recordNodeId;
       const isWorktreeNodeRemoval = cleanupSource === "mesh_remove_node" && args.node?.isLocalWorktree === true;
       const cleanWorkspaceOnlyForWorktree = isWorktreeNodeRemoval && matchedByWorkspaceOnly;
-      if (!hasExplicitSessionIds && liveRuntime && !delegateBoundToThisNode && !cleanWorkspaceOnlyForWorktree) {
+      const reclaimableOrphan = reclaimOrphans && liveRuntime && !delegateBoundToThisNode && (matchedByWorkspaceOnly || !isNodeStillLive(recordNodeId));
+      if (!hasExplicitSessionIds && liveRuntime && !delegateBoundToThisNode && !cleanWorkspaceOnlyForWorktree && !reclaimableOrphan) {
         skippedSessionIds.push(sessionId);
         skippedLiveSessionIds.push(sessionId);
         const reason = recordNodeId && recordNodeId !== args.nodeId ? `live_delegate_bound_to_other_node:${recordNodeId}` : matchedByWorkspaceOnly ? "live_session_matched_by_workspace_only_no_node_binding" : "live_session_not_bound_to_this_node";
@@ -56704,6 +56743,10 @@ var DaemonCommandRouter = class {
       if (cleanWorkspaceOnlyForWorktree && !delegateBoundToThisNode) {
         actedLiveDelegateSessionIds.push(sessionId);
       }
+      if (reclaimableOrphan && !cleanWorkspaceOnlyForWorktree && !delegateBoundToThisNode) {
+        reclaimedOrphanSessionIds.push(sessionId);
+        actedLiveDelegateSessionIds.push(sessionId);
+      }
       if (!hasExplicitSessionIds && liveRuntime && delegateBoundToThisNode && args.mode === "delete_stopped") {
         skippedSessionIds.push(sessionId);
         skippedLiveSessionIds.push(sessionId);
@@ -56776,6 +56819,7 @@ var DaemonCommandRouter = class {
       skippedCoordinatorSessionIds,
       ...skippedMarkerMismatchSessionIds.length ? { skippedMarkerMismatchSessionIds } : {},
       ...actedLiveDelegateSessionIds.length ? { actedLiveDelegateSessionIds } : {},
+      ...reclaimedOrphanSessionIds.length ? { reclaimedOrphanSessionIds } : {},
       ...skippedLiveSessionReasons.length ? { skippedLiveSessionReasons } : {},
       ...deleteUnsupported ? {
         deleteUnsupported: true,