@adhdev/daemon-standalone 0.9.82-rc.99 → 1.0.0

package/vendor/session-host-daemon/index.mjs

@@ -24,13 +24,10 @@ import { EventEmitter } from "events";
 import * as fs3 from "fs";
 import * as net from "net";
 import {
-  SESSION_HOST_SUPPORTED_REQUEST_TYPES,
   SessionHostRegistry,
   createLineParser,
   createResponseEnvelope,
-  getDefaultSessionHostEndpoint,
-  resolveSessionHostCols as resolveSessionHostCols2,
-  resolveSessionHostRows as resolveSessionHostRows2
+  getDefaultSessionHostEndpoint
 } from "@adhdev/session-host-core";
 
 // src/runtime.ts
@@ -74,7 +71,8 @@ function formatXtermViewportPlain(terminal, rows) {
   const lines = [];
   for (let i = start; i < end; i++) {
     const line = buffer.getLine(i);
-    lines.push(line ? line.translateToString(true) : "");
+    const raw = line ? line.translateToString(false) : "";
+    lines.push(raw.replace(/\s+$/, ""));
   }
   let first = 0;
   let last = lines.length;
@@ -137,6 +135,9 @@ function createXtermMirror(options) {
       if (serializer) return serializeXtermViewport(terminal, serializer, currentRows);
       return formatXtermViewportPlain(terminal, currentRows);
     },
+    formatPlainText() {
+      return formatXtermViewportPlain(terminal, currentRows).replace(/\r\n/g, "\n");
+    },
     getCursorPosition() {
       const buffer = terminal.buffer.active;
       return {
@@ -169,6 +170,9 @@ function normalizeGhosttyBinding(mod) {
         formatVT() {
           return viewportSnapshot.formatVT();
         },
+        formatPlainText() {
+          return viewportSnapshot.formatPlainText();
+        },
         getCursorPosition() {
           if (typeof handle.getCursorPosition === "function") return handle.getCursorPosition();
           return viewportSnapshot.getCursorPosition();
@@ -217,6 +221,10 @@ var PtySessionRuntime = class {
   ptyProcess = null;
   screenMirror = null;
   pendingQueryScanTail = "";
+  terminalModeScanTail = "";
+  altScreen = false;
+  pasteMode = false;
+  scrollRegion;
   onDataCallback;
   onExitCallback;
   constructor(options) {
@@ -224,6 +232,7 @@ var PtySessionRuntime = class {
     this.payload = options.payload;
     this.cols = resolveSessionHostCols(options.payload.cols);
     this.rows = resolveSessionHostRows(options.payload.rows);
+    this.scrollRegion = { top: 0, bot: this.rows - 1 };
     this.onDataCallback = options.onData;
     this.onExitCallback = options.onExit;
   }
@@ -255,6 +264,7 @@ var PtySessionRuntime = class {
     });
     this.ptyProcess.onData((data) => {
       this.screenMirror?.write(data);
+      this.trackTerminalModes(data);
       this.respondToTerminalQueries(data);
       this.onDataCallback(data);
     });
@@ -263,6 +273,7 @@ var PtySessionRuntime = class {
       this.screenMirror?.dispose();
       this.screenMirror = null;
       this.pendingQueryScanTail = "";
+      this.terminalModeScanTail = "";
       this.onExitCallback(exitCode ?? null);
     });
     return this.ptyProcess.pid;
@@ -274,6 +285,12 @@ var PtySessionRuntime = class {
   resize(cols, rows) {
     if (!this.ptyProcess) throw new Error(`Session not running: ${this.sessionId}`);
     this.ptyProcess.resize(cols, rows);
+    this.cols = Math.max(1, cols | 0);
+    this.rows = Math.max(1, rows | 0);
+    this.scrollRegion = {
+      top: Math.min(this.scrollRegion.top, this.rows - 1),
+      bot: Math.min(Math.max(this.scrollRegion.top, this.scrollRegion.bot), this.rows - 1)
+    };
     this.screenMirror?.resize(cols, rows);
   }
   stop() {
@@ -297,6 +314,55 @@ var PtySessionRuntime = class {
   getSnapshotText() {
     return this.screenMirror?.formatVT() || "";
   }
+  getTerminalSnapshot() {
+    if (!this.ptyProcess || !this.screenMirror) {
+      throw new Error(`Session not running: ${this.sessionId}`);
+    }
+    const cursor = this.screenMirror.getCursorPosition();
+    return {
+      text: this.screenMirror.formatPlainText(),
+      state: {
+        cursor: {
+          row: Math.max(0, cursor.row | 0),
+          col: Math.max(0, cursor.col | 0)
+        },
+        altScreen: this.altScreen,
+        pasteMode: this.pasteMode,
+        rawMode: true,
+        scrollRegion: { ...this.scrollRegion },
+        cols: this.cols,
+        rows: this.rows
+      }
+    };
+  }
+  trackTerminalModes(data) {
+    if (!data) return;
+    const combined = this.terminalModeScanTail + data;
+    const privateMode = /\x1b\[\?([0-9;]*)([hl])/g;
+    let privateMatch;
+    while ((privateMatch = privateMode.exec(combined)) !== null) {
+      const enabled = privateMatch[2] === "h";
+      for (const mode of privateMatch[1].split(";")) {
+        if (mode === "47" || mode === "1047" || mode === "1049") this.altScreen = enabled;
+        if (mode === "2004") this.pasteMode = enabled;
+      }
+    }
+    const scrollRegion = /\x1b\[(\d*)(?:;(\d*))?r/g;
+    let scrollMatch;
+    while ((scrollMatch = scrollRegion.exec(combined)) !== null) {
+      const top = scrollMatch[1] ? Number.parseInt(scrollMatch[1], 10) - 1 : 0;
+      const bot = scrollMatch[2] ? Number.parseInt(scrollMatch[2], 10) - 1 : this.rows - 1;
+      this.scrollRegion = {
+        top: Math.max(0, Math.min(this.rows - 1, top)),
+        bot: Math.max(0, Math.min(this.rows - 1, bot))
+      };
+      if (this.scrollRegion.bot < this.scrollRegion.top) {
+        this.scrollRegion = { top: 0, bot: this.rows - 1 };
+      }
+    }
+    const lastEscape = combined.lastIndexOf("\x1B");
+    this.terminalModeScanTail = lastEscape >= 0 && combined.length - lastEscape < 64 ? combined.slice(lastEscape) : "";
+  }
   respondToTerminalQueries(data) {
     if (!this.ptyProcess || !this.screenMirror || !data) return;
     const combined = this.pendingQueryScanTail + data;
@@ -361,9 +427,203 @@ var SessionHostStorage = class {
   }
 };
 
+// src/session-diagnostics.ts
+import {
+  SESSION_HOST_SUPPORTED_REQUEST_TYPES
+} from "@adhdev/session-host-core";
+var MAX_RECENT_DIAGNOSTICS = 200;
+function pushRecent(bucket, entry, max = MAX_RECENT_DIAGNOSTICS) {
+  bucket.push(entry);
+  if (bucket.length > max) {
+    bucket.splice(0, bucket.length - max);
+  }
+}
+function getSessionHostRecoveryLabel(record) {
+  const recoveryState = typeof record.meta?.runtimeRecoveryState === "string" ? String(record.meta.runtimeRecoveryState).trim() : "";
+  if (!recoveryState) return null;
+  if (recoveryState === "auto_resumed") return "restored after restart";
+  if (recoveryState === "resume_failed") return "restore failed";
+  if (recoveryState === "host_restart_interrupted") return "host restart interrupted";
+  if (recoveryState === "orphan_snapshot") return "snapshot recovered";
+  return recoveryState.replace(/_/g, " ");
+}
+function getSessionSurfaceKind(record) {
+  if (["starting", "running", "stopping", "interrupted"].includes(record.lifecycle)) {
+    return "live_runtime";
+  }
+  if ((record.lifecycle === "stopped" || record.lifecycle === "failed") && (record.meta?.restoredFromStorage === true || getSessionHostRecoveryLabel(record))) {
+    return "recovery_snapshot";
+  }
+  return "inactive_record";
+}
+function annotateSessionSurface(record) {
+  return {
+    ...record,
+    surfaceKind: getSessionSurfaceKind(record)
+  };
+}
+function sanitizeDiagnosticsRecord(record) {
+  return {
+    ...record,
+    launchCommand: {
+      command: record.launchCommand.command,
+      args: Array.isArray(record.launchCommand.args) ? [...record.launchCommand.args] : []
+    }
+  };
+}
+function buildHostDiagnostics(params) {
+  const limit = Math.max(1, Math.min(200, Number(params.payload?.limit) || 50));
+  const allSessions = params.payload?.includeSessions === false ? void 0 : params.sessions.map((record) => annotateSessionSurface(record)).map((record) => sanitizeDiagnosticsRecord(record));
+  const liveRuntimes = allSessions?.filter((record) => record.surfaceKind === "live_runtime");
+  const recoverySnapshots = allSessions?.filter((record) => record.surfaceKind === "recovery_snapshot").slice(0, limit);
+  const inactiveRecords = allSessions?.filter((record) => record.surfaceKind === "inactive_record").slice(0, limit);
+  const sessions = allSessions ? [
+    ...liveRuntimes || [],
+    ...recoverySnapshots || [],
+    ...inactiveRecords || []
+  ] : void 0;
+  return {
+    hostStartedAt: params.hostStartedAt,
+    endpoint: params.endpointPath,
+    runtimeCount: params.runtimeCount,
+    supportedRequestTypes: [...SESSION_HOST_SUPPORTED_REQUEST_TYPES],
+    sessions,
+    liveRuntimes,
+    recoverySnapshots,
+    inactiveRecords,
+    recentLogs: params.recentLogs.slice(-limit),
+    recentRequests: params.recentRequests.slice(-limit),
+    recentTransitions: params.recentTransitions.slice(-limit)
+  };
+}
+
+// src/session-lifecycle.ts
+import {
+  resolveSessionHostCols as resolveSessionHostCols2,
+  resolveSessionHostRows as resolveSessionHostRows2
+} from "@adhdev/session-host-core";
+function compareDuplicateCandidates(a, b) {
+  const score = (record) => {
+    const lifecycleScore = record.lifecycle === "running" ? 4 : record.lifecycle === "starting" ? 3 : record.lifecycle === "stopping" ? 2 : record.lifecycle === "interrupted" ? 1 : 0;
+    return [
+      lifecycleScore,
+      record.writeOwner ? 1 : 0,
+      Array.isArray(record.attachedClients) ? record.attachedClients.length : 0,
+      record.lastActivityAt || 0,
+      record.startedAt || 0,
+      record.createdAt || 0
+    ];
+  };
+  const aScore = score(a);
+  const bScore = score(b);
+  for (let i = 0; i < aScore.length; i += 1) {
+    if (aScore[i] === bScore[i]) continue;
+    return bScore[i] - aScore[i];
+  }
+  return 0;
+}
+function planDuplicatePrune(sessions, filters) {
+  const candidates = sessions.filter((record) => ["starting", "running", "stopping", "interrupted"].includes(record.lifecycle)).filter((record) => !filters.providerFilter || record.providerType === filters.providerFilter).filter((record) => !filters.workspaceFilter || record.workspace === filters.workspaceFilter);
+  const groups = /* @__PURE__ */ new Map();
+  for (const record of candidates) {
+    const providerSessionId = typeof record.meta?.providerSessionId === "string" ? String(record.meta.providerSessionId).trim() : "";
+    if (!providerSessionId) continue;
+    const bindingKey = `${record.providerType}::${record.workspace}::${providerSessionId}`;
+    const bucket = groups.get(bindingKey) || [];
+    bucket.push(record);
+    groups.set(bindingKey, bucket);
+  }
+  const duplicateGroups = [];
+  const keptSessionIds = [];
+  const duplicateRecords = [];
+  for (const [bindingKey, records] of groups.entries()) {
+    if (records.length < 2) continue;
+    const sorted = [...records].sort((a, b) => compareDuplicateCandidates(a, b));
+    const kept = sorted[0];
+    const duplicates = sorted.slice(1);
+    const providerSessionId = typeof kept.meta?.providerSessionId === "string" ? String(kept.meta.providerSessionId) : "";
+    duplicateGroups.push({
+      bindingKey,
+      providerType: kept.providerType,
+      workspace: kept.workspace,
+      providerSessionId,
+      keptSessionId: kept.sessionId,
+      prunedSessionIds: duplicates.map((record) => record.sessionId)
+    });
+    keptSessionIds.push(kept.sessionId);
+    for (const duplicate of duplicates) {
+      duplicateRecords.push(duplicate);
+    }
+  }
+  return { duplicateGroups, keptSessionIds, duplicateRecords };
+}
+function buildPayloadFromRecord(record) {
+  return {
+    sessionId: record.sessionId,
+    runtimeKey: record.runtimeKey,
+    displayName: record.displayName,
+    providerType: record.providerType,
+    category: record.category,
+    workspace: record.workspace,
+    launchCommand: record.launchCommand,
+    cols: resolveSessionHostCols2(typeof record.meta?.sessionHostCols === "number" ? record.meta.sessionHostCols : void 0),
+    rows: resolveSessionHostRows2(typeof record.meta?.sessionHostRows === "number" ? record.meta.sessionHostRows : void 0),
+    meta: record.meta
+  };
+}
+function buildRecoveredRecord(persisted) {
+  const wasLiveRuntime = !["stopped", "failed"].includes(persisted.record.lifecycle);
+  const hadAttachedClients = Array.isArray(persisted.record.attachedClients) && persisted.record.attachedClients.length > 0;
+  const hadWriteOwner = !!persisted.record.writeOwner;
+  const hadRecoveryInterest = hadAttachedClients || hadWriteOwner;
+  const recoveredRecord = {
+    ...persisted.record,
+    attachedClients: [],
+    writeOwner: null,
+    lifecycle: wasLiveRuntime ? "stopped" : persisted.record.lifecycle,
+    lastActivityAt: Date.now(),
+    meta: {
+      ...persisted.record.meta || {},
+      restoredFromStorage: true,
+      runtimeRecoveryState: wasLiveRuntime ? "orphan_snapshot" : "snapshot",
+      runtimeHadAttachedClientsAtCrash: hadAttachedClients,
+      runtimeHadWriteOwnerAtCrash: hadWriteOwner,
+      runtimeAutoResumeSkipped: wasLiveRuntime && hadRecoveryInterest
+    }
+  };
+  return { recoveredRecord, wasLiveRuntime, hadRecoveryInterest };
+}
+
+// src/session-protocol.ts
+function getRequestSessionId(request) {
+  const payload = request.payload;
+  return typeof payload?.sessionId === "string" ? payload.sessionId : void 0;
+}
+function getRequestClientId(request) {
+  const payload = request.payload;
+  return typeof payload?.clientId === "string" ? payload.clientId : void 0;
+}
+function mergeRuntimeSnapshot(base, record, opts) {
+  const cols = typeof record?.meta?.sessionHostCols === "number" ? record.meta.sessionHostCols : 80;
+  const rows = typeof record?.meta?.sessionHostRows === "number" ? record.meta.sessionHostRows : 24;
+  if (typeof opts.sinceSeq === "number" || !opts.runtimeText) {
+    return {
+      ...base,
+      cols,
+      rows
+    };
+  }
+  return {
+    ...base,
+    text: opts.runtimeText,
+    truncated: false,
+    cols,
+    rows
+  };
+}
+
 // src/server.ts
-var SessionHostServer = class _SessionHostServer extends EventEmitter {
-  static MAX_RECENT_DIAGNOSTICS = 200;
+var SessionHostServer = class extends EventEmitter {
   endpoint;
   registry = new SessionHostRegistry();
   runtimes = /* @__PURE__ */ new Map();
@@ -510,6 +770,8 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
         }
         case "get_snapshot":
           return { success: true, result: this.getSnapshot(request.payload.sessionId, request.payload.sinceSeq) };
+        case "get_terminal_snapshot":
+          return { success: true, result: this.requireRuntime(request.payload.sessionId).getTerminalSnapshot() };
         case "get_host_diagnostics":
           return { success: true, result: this.getHostDiagnostics(request.payload) };
         case "clear_session_buffer": {
@@ -610,7 +872,7 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
           if (this.runtimes.has(request.payload.sessionId)) {
             return { success: true, result: existing };
           }
-          const resumed = this.startRuntime(existing, this.buildPayloadFromRecord(existing), "session_resumed");
+          const resumed = this.startRuntime(existing, buildPayloadFromRecord(existing), "session_resumed");
           this.recordRuntimeTransition(request.payload.sessionId, "resume_session", resumed.lifecycle, void 0, true);
           return { success: true, result: resumed };
         }
@@ -692,7 +954,7 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
     sessions.add(sessionId);
   }
   async handleIncomingRequest(socket, envelope) {
-    const sessionId = this.getRequestSessionId(envelope.request);
+    const sessionId = getRequestSessionId(envelope.request);
     if (sessionId && (envelope.request.type === "create_session" || envelope.request.type === "attach_session")) {
       this.subscribeSocketToSession(socket, sessionId);
     }
@@ -706,8 +968,8 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
       timestamp: startedAt,
       requestId: envelope.requestId,
       type: envelope.request.type,
-      sessionId: this.getRequestSessionId(envelope.request),
-      clientId: this.getRequestClientId(envelope.request),
+      sessionId: getRequestSessionId(envelope.request),
+      clientId: getRequestClientId(envelope.request),
       success: response.success,
       durationMs: Math.max(0, Date.now() - startedAt),
       error: response.success ? void 0 : response.error
@@ -750,79 +1012,24 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
     const record = this.registry.getSession(sessionId);
     if (!record) return;
     const snapshot = this.getSnapshot(sessionId);
-    this.storage.save(record, snapshot);
-  }
-  getSessionHostRecoveryLabel(record) {
-    const recoveryState = typeof record.meta?.runtimeRecoveryState === "string" ? String(record.meta.runtimeRecoveryState).trim() : "";
-    if (!recoveryState) return null;
-    if (recoveryState === "auto_resumed") return "restored after restart";
-    if (recoveryState === "resume_failed") return "restore failed";
-    if (recoveryState === "host_restart_interrupted") return "host restart interrupted";
-    if (recoveryState === "orphan_snapshot") return "snapshot recovered";
-    return recoveryState.replace(/_/g, " ");
-  }
-  getSessionSurfaceKind(record) {
-    if (["starting", "running", "stopping", "interrupted"].includes(record.lifecycle)) {
-      return "live_runtime";
-    }
-    if ((record.lifecycle === "stopped" || record.lifecycle === "failed") && (record.meta?.restoredFromStorage === true || this.getSessionHostRecoveryLabel(record))) {
-      return "recovery_snapshot";
+    try {
+      this.storage.save(record, snapshot);
+    } catch (error) {
+      const code = typeof error?.code === "string" ? error.code : "persist_failed";
+      console.error(`[session-host] Persist failed for ${sessionId}: ${code}: ${error?.message || error}`);
     }
-    return "inactive_record";
-  }
-  annotateSessionSurface(record) {
-    return {
-      ...record,
-      surfaceKind: this.getSessionSurfaceKind(record)
-    };
-  }
-  sanitizeDiagnosticsRecord(record) {
-    return {
-      ...record,
-      launchCommand: {
-        command: record.launchCommand.command,
-        args: Array.isArray(record.launchCommand.args) ? [...record.launchCommand.args] : []
-      }
-    };
   }
   getHostDiagnostics(payload) {
-    const limit = Math.max(1, Math.min(200, Number(payload?.limit) || 50));
-    const allSessions = payload?.includeSessions === false ? void 0 : this.registry.listSessions().map((record) => this.annotateSessionSurface(record)).map((record) => this.sanitizeDiagnosticsRecord(record));
-    const liveRuntimes = allSessions?.filter((record) => record.surfaceKind === "live_runtime");
-    const recoverySnapshots = allSessions?.filter((record) => record.surfaceKind === "recovery_snapshot").slice(0, limit);
-    const inactiveRecords = allSessions?.filter((record) => record.surfaceKind === "inactive_record").slice(0, limit);
-    const sessions = allSessions ? [
-      ...liveRuntimes || [],
-      ...recoverySnapshots || [],
-      ...inactiveRecords || []
-    ] : void 0;
-    return {
+    return buildHostDiagnostics({
+      payload,
       hostStartedAt: this.startedAt,
-      endpoint: this.endpoint.path,
+      endpointPath: this.endpoint.path,
       runtimeCount: this.runtimes.size,
-      supportedRequestTypes: [...SESSION_HOST_SUPPORTED_REQUEST_TYPES],
-      sessions,
-      liveRuntimes,
-      recoverySnapshots,
-      inactiveRecords,
-      recentLogs: this.recentLogs.slice(-limit),
-      recentRequests: this.recentRequests.slice(-limit),
-      recentTransitions: this.recentTransitions.slice(-limit)
-    };
-  }
-  getRequestSessionId(request) {
-    const payload = request.payload;
-    return typeof payload?.sessionId === "string" ? payload.sessionId : void 0;
-  }
-  getRequestClientId(request) {
-    const payload = request.payload;
-    return typeof payload?.clientId === "string" ? payload.clientId : void 0;
-  }
-  pushRecent(bucket, entry) {
-    bucket.push(entry);
-    if (bucket.length > _SessionHostServer.MAX_RECENT_DIAGNOSTICS) {
-      bucket.splice(0, bucket.length - _SessionHostServer.MAX_RECENT_DIAGNOSTICS);
-    }
+      sessions: this.registry.listSessions(),
+      recentLogs: this.recentLogs,
+      recentRequests: this.recentRequests,
+      recentTransitions: this.recentTransitions
+    });
   }
   recordHostLog(level, message, sessionId, data) {
     const entry = {
@@ -832,12 +1039,12 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
       sessionId,
       data
     };
-    this.pushRecent(this.recentLogs, entry);
+    pushRecent(this.recentLogs, entry);
     this.emitEvent({ type: "host_log", entry });
     this.emit("log", `[${level}] ${message}`);
   }
   recordRequestTrace(trace) {
-    this.pushRecent(this.recentRequests, trace);
+    pushRecent(this.recentRequests, trace);
     this.emitEvent({ type: "request_trace", trace });
     if (!trace.success) {
       this.recordHostLog(
@@ -907,7 +1114,7 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
       success,
       error
     };
-    this.pushRecent(this.recentTransitions, transition);
+    pushRecent(this.recentTransitions, transition);
     this.emitEvent({ type: "runtime_transition", transition });
   }
   waitForRuntimeExit(sessionId, timeoutMs = 5e3) {
@@ -943,29 +1150,8 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
   getSnapshot(sessionId, sinceSeq) {
     const snapshot = this.registry.getSnapshot(sessionId, sinceSeq);
     const record = this.registry.getSession(sessionId);
-    if (typeof sinceSeq === "number") {
-      return {
-        ...snapshot,
-        cols: typeof record?.meta?.sessionHostCols === "number" ? record.meta.sessionHostCols : 80,
-        rows: typeof record?.meta?.sessionHostRows === "number" ? record.meta.sessionHostRows : 24
-      };
-    }
-    const runtime = this.runtimes.get(sessionId);
-    const runtimeText = runtime?.getSnapshotText?.() || "";
-    if (!runtimeText) {
-      return {
-        ...snapshot,
-        cols: typeof record?.meta?.sessionHostCols === "number" ? record.meta.sessionHostCols : 80,
-        rows: typeof record?.meta?.sessionHostRows === "number" ? record.meta.sessionHostRows : 24
-      };
-    }
-    return {
-      ...snapshot,
-      text: runtimeText,
-      truncated: false,
-      cols: typeof record?.meta?.sessionHostCols === "number" ? record.meta.sessionHostCols : 80,
-      rows: typeof record?.meta?.sessionHostRows === "number" ? record.meta.sessionHostRows : 24
-    };
+    const runtimeText = typeof sinceSeq === "number" ? "" : this.runtimes.get(sessionId)?.getSnapshotText?.() || "";
+    return mergeRuntimeSnapshot(snapshot, record, { sinceSeq, runtimeText });
   }
   flushAllPersistence() {
     for (const sessionId of this.runtimes.keys()) {
@@ -988,7 +1174,7 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
       await this.waitForRuntimeExit(sessionId);
     }
     const latest = this.registry.getSession(sessionId) || existing;
-    const restarted = this.startRuntime(latest, this.buildPayloadFromRecord(latest), "session_resumed");
+    const restarted = this.startRuntime(latest, buildPayloadFromRecord(latest), "session_resumed");
     this.recordRuntimeTransition(sessionId, "restart_completed", restarted.lifecycle, void 0, true);
     return restarted;
   }
@@ -996,36 +1182,13 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
     const providerFilter = typeof payload?.providerType === "string" ? payload.providerType.trim() : "";
     const workspaceFilter = typeof payload?.workspace === "string" ? payload.workspace.trim() : "";
     const dryRun = payload?.dryRun === true;
-    const sessions = this.registry.listSessions().filter((record) => ["starting", "running", "stopping", "interrupted"].includes(record.lifecycle)).filter((record) => !providerFilter || record.providerType === providerFilter).filter((record) => !workspaceFilter || record.workspace === workspaceFilter);
-    const groups = /* @__PURE__ */ new Map();
-    for (const record of sessions) {
-      const providerSessionId = typeof record.meta?.providerSessionId === "string" ? String(record.meta.providerSessionId).trim() : "";
-      if (!providerSessionId) continue;
-      const bindingKey = `${record.providerType}::${record.workspace}::${providerSessionId}`;
-      const bucket = groups.get(bindingKey) || [];
-      bucket.push(record);
-      groups.set(bindingKey, bucket);
-    }
-    const duplicateGroups = [];
-    const keptSessionIds = [];
+    const { duplicateGroups, keptSessionIds, duplicateRecords } = planDuplicatePrune(
+      this.registry.listSessions(),
+      { providerFilter, workspaceFilter }
+    );
     const prunedSessionIds = [];
-    for (const [bindingKey, records] of groups.entries()) {
-      if (records.length < 2) continue;
-      const sorted = [...records].sort((a, b) => this.compareDuplicateCandidates(a, b));
-      const kept = sorted[0];
-      const duplicates = sorted.slice(1);
-      const providerSessionId = typeof kept.meta?.providerSessionId === "string" ? String(kept.meta.providerSessionId) : "";
-      duplicateGroups.push({
-        bindingKey,
-        providerType: kept.providerType,
-        workspace: kept.workspace,
-        providerSessionId,
-        keptSessionId: kept.sessionId,
-        prunedSessionIds: duplicates.map((record) => record.sessionId)
-      });
-      keptSessionIds.push(kept.sessionId);
-      if (dryRun) continue;
-      for (const duplicate of duplicates) {
+    if (!dryRun) {
+      for (const duplicate of duplicateRecords) {
         await this.pruneDuplicateRuntime(duplicate);
         prunedSessionIds.push(duplicate.sessionId);
       }
@@ -1053,25 +1216,7 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
     const states = this.storage.loadAll();
     let skippedAutoResumeSessions = 0;
     for (const persisted of states) {
-      const wasLiveRuntime = !["stopped", "failed"].includes(persisted.record.lifecycle);
-      const hadAttachedClients = Array.isArray(persisted.record.attachedClients) && persisted.record.attachedClients.length > 0;
-      const hadWriteOwner = !!persisted.record.writeOwner;
-      const hadRecoveryInterest = hadAttachedClients || hadWriteOwner;
-      const recoveredRecord = {
-        ...persisted.record,
-        attachedClients: [],
-        writeOwner: null,
-        lifecycle: wasLiveRuntime ? "stopped" : persisted.record.lifecycle,
-        lastActivityAt: Date.now(),
-        meta: {
-          ...persisted.record.meta || {},
-          restoredFromStorage: true,
-          runtimeRecoveryState: wasLiveRuntime ? "orphan_snapshot" : "snapshot",
-          runtimeHadAttachedClientsAtCrash: hadAttachedClients,
-          runtimeHadWriteOwnerAtCrash: hadWriteOwner,
-          runtimeAutoResumeSkipped: wasLiveRuntime && hadRecoveryInterest
-        }
-      };
+      const { recoveredRecord, wasLiveRuntime, hadRecoveryInterest } = buildRecoveredRecord(persisted);
       this.registry.restoreSession(recoveredRecord, persisted.snapshot);
       this.storage.save(recoveredRecord, persisted.snapshot);
       if (wasLiveRuntime && hadRecoveryInterest) {
@@ -1082,26 +1227,6 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
       this.recordHostLog("warn", `session host restored ${skippedAutoResumeSessions} live runtime snapshot(s) without auto-resume`);
     }
   }
-  compareDuplicateCandidates(a, b) {
-    const score = (record) => {
-      const lifecycleScore = record.lifecycle === "running" ? 4 : record.lifecycle === "starting" ? 3 : record.lifecycle === "stopping" ? 2 : record.lifecycle === "interrupted" ? 1 : 0;
-      return [
-        lifecycleScore,
-        record.writeOwner ? 1 : 0,
-        Array.isArray(record.attachedClients) ? record.attachedClients.length : 0,
-        record.lastActivityAt || 0,
-        record.startedAt || 0,
-        record.createdAt || 0
-      ];
-    };
-    const aScore = score(a);
-    const bScore = score(b);
-    for (let i = 0; i < aScore.length; i += 1) {
-      if (aScore[i] === bScore[i]) continue;
-      return bScore[i] - aScore[i];
-    }
-    return 0;
-  }
   async pruneDuplicateRuntime(record) {
     const providerSessionId = typeof record.meta?.providerSessionId === "string" ? String(record.meta.providerSessionId) : void 0;
     this.recordRuntimeTransition(
@@ -1122,20 +1247,6 @@ var SessionHostServer = class _SessionHostServer extends EventEmitter {
     this.registry.deleteSession(record.sessionId);
     this.storage.remove(record.sessionId);
   }
-  buildPayloadFromRecord(record) {
-    return {
-      sessionId: record.sessionId,
-      runtimeKey: record.runtimeKey,
-      displayName: record.displayName,
-      providerType: record.providerType,
-      category: record.category,
-      workspace: record.workspace,
-      launchCommand: record.launchCommand,
-      cols: resolveSessionHostCols2(typeof record.meta?.sessionHostCols === "number" ? record.meta.sessionHostCols : void 0),
-      rows: resolveSessionHostRows2(typeof record.meta?.sessionHostRows === "number" ? record.meta.sessionHostRows : void 0),
-      meta: record.meta
-    };
-  }
   startRuntime(record, payload, startEventType) {
     const runtime = new PtySessionRuntime({
       sessionId: record.sessionId,