very-happy-cli 0.2.189 → 0.2.190

package/dist/{sessionLock-tEFvFXLD.mjs → sessionLock-Ca_bIo50.mjs}

@@ -1,8 +1,9 @@
-import { n as hibernationReplaySeq } from './persistence-0INrP3aB.mjs';
+import { o as hibernationReplaySeq } from './persistence-Dogj7JIp.mjs';
+import { c as compareExactVersions } from './cliUpdate-Y34VGe9Y.mjs';
 import { existsSync, readFileSync, unlinkSync, mkdirSync, renameSync } from 'node:fs';
 import { join } from 'node:path';
-import { c as configuration, w as writePrivateFileSync } from './configuration-1FabKklB.mjs';
-import { l as logger } from './logger-DOKH3Zbh.mjs';
+import { c as configuration, w as writePrivateFileSync } from './configuration-Dechcvd-.mjs';
+import { l as logger } from './logger-CL7pin9b.mjs';
 import { s as snapshotTree, k as killSurvivors } from './processTreeSnapshot-CuLJDNC-.mjs';
 
 const PROCESS_IDENTITY_FIELDS = [
@@ -81,6 +82,122 @@ function applyReconnectReplay(response) {
   return { response: { ...response, seq: cursor.seq }, replay: { source: "offline-exit", seq: cursor.seq } };
 }
 
+const AUTO_RESTART_CAPABILITY = "auto-restart-v1";
+const AUTO_RESTART_QUIET_MS = 10 * 60 * 1e3;
+const AUTO_RESTART_RECHECK_CAP_MS = 10 * 60 * 1e3;
+function resolveQuietMs(env = process.env) {
+  const raw = env.HAPPY_AUTO_RESTART_QUIET_MS;
+  if (raw !== void 0 && raw.trim() !== "") {
+    const value = Number(raw);
+    if (Number.isFinite(value) && value >= 0) return Math.round(value);
+  }
+  return AUTO_RESTART_QUIET_MS;
+}
+const AUTO_RESTART_MAX_CONCURRENT = 1;
+const AUTO_RESTART_MIN_GAP_MS = 15e3;
+const AUTO_RESTART_MAX_ATTEMPTS = 2;
+const AUTO_RESTART_BACKOFF_MS = 10 * 60 * 1e3;
+const AUTO_RESTART_MIN_CHECK_MS = 15e3;
+const AUTO_RESTART_FLAVORS = ["claude", "codex", "acp"];
+function wrapperStaleness(input) {
+  const wrapper = input.wrapperVersion?.trim();
+  if (wrapper) {
+    const cmp = compareExactVersions(wrapper, input.daemonVersion);
+    if (cmp !== null && cmp < 0) return { kind: "cli", from: wrapper, target: input.daemonVersion };
+  }
+  const running = input.agentVersion?.trim();
+  const installed = input.installedAgentVersion?.trim();
+  if (running && installed) {
+    const cmp = compareExactVersions(running, installed);
+    if (cmp !== null && cmp < 0) return { kind: "agent", from: running, target: installed };
+  }
+  return null;
+}
+function decideAutoRestart(input) {
+  const { report } = input;
+  if (!input.enabled) return { ok: false, reason: "disabled" };
+  if (!input.staleness) return { ok: false, reason: "not-stale" };
+  if (!input.trackedLive) return { ok: false, reason: "not-tracked" };
+  if (report.exiting) return { ok: false, reason: "exiting" };
+  if (!report.uiSession) return { ok: false, reason: "local-terminal" };
+  if (report.variant) return { ok: false, reason: "assistant" };
+  if (!AUTO_RESTART_FLAVORS.includes(report.flavor)) return { ok: false, reason: "unsupported-flavor" };
+  if (!input.resumable) return { ok: false, reason: "not-resumable" };
+  if (report.thinking || input.turnActive) return { ok: false, reason: "turn-active" };
+  if (report.pendingRequests > 0) return { ok: false, reason: "pending-request" };
+  if (report.queuedInputs > 0 || !report.waitingForInput) return { ok: false, reason: "queued-input" };
+  if (report.backgroundTasks > 0 || input.backgroundTasks > 0) return { ok: false, reason: "background-tasks" };
+  if ((report.scheduledWakeups ?? 0) > 0) return { ok: false, reason: "scheduled-wakeup" };
+  if (!(input.now - report.lastActivityAt >= (input.quietMs ?? AUTO_RESTART_QUIET_MS))) return { ok: false, reason: "recent-activity" };
+  if (input.automationRunning) return { ok: false, reason: "automation-running" };
+  const attempt = input.attempt && input.attempt.target === input.staleness.target ? input.attempt : null;
+  if (attempt && attempt.attempts >= AUTO_RESTART_MAX_ATTEMPTS) return { ok: false, reason: "gave-up" };
+  if (attempt && input.now < attempt.notBefore) return { ok: false, reason: "backoff" };
+  if (input.inFlight >= AUTO_RESTART_MAX_CONCURRENT) return { ok: false, reason: "machine-busy" };
+  if (input.lastStartedAt !== null && input.now - input.lastStartedAt < AUTO_RESTART_MIN_GAP_MS) return { ok: false, reason: "machine-busy" };
+  return { ok: true };
+}
+function autoRestartNextCheck(verdict, input, jitter = 0) {
+  if (verdict.ok) return null;
+  switch (verdict.reason) {
+    case "recent-activity":
+      return Math.max(AUTO_RESTART_MIN_CHECK_MS, input.report.lastActivityAt + (input.quietMs ?? AUTO_RESTART_QUIET_MS) - input.now);
+    case "machine-busy":
+      return AUTO_RESTART_MIN_GAP_MS + Math.round(Math.min(Math.max(jitter, 0), 0.999) * 2 * AUTO_RESTART_MIN_GAP_MS);
+    case "backoff":
+      return Math.max(AUTO_RESTART_MIN_CHECK_MS, (input.attempt?.notBefore ?? input.now) - input.now);
+    default:
+      return null;
+  }
+}
+function recordAttempt(previous, target, ok, now, error) {
+  if (ok) return null;
+  const attempts = (previous && previous.target === target ? previous.attempts : 0) + 1;
+  return { target, attempts, notBefore: now + AUTO_RESTART_BACKOFF_MS * attempts, ...error ? { lastError: error } : {} };
+}
+const MANUAL_REASONS = /* @__PURE__ */ new Set(["local-terminal", "assistant", "unsupported-flavor", "not-resumable"]);
+function statusFromVerdict(verdict, previous, staleness, now, attempt) {
+  if (verdict.ok) return null;
+  if (verdict.reason === "disabled" || verdict.reason === "not-stale" || verdict.reason === "not-tracked") return null;
+  const since = previous && previous.target === staleness.target ? previous.since : now;
+  if (verdict.reason === "gave-up") {
+    return { state: "failed", reason: attempt?.lastError ?? "gave-up", since, target: staleness.target };
+  }
+  return {
+    state: MANUAL_REASONS.has(verdict.reason) ? "manual" : "waiting",
+    reason: verdict.reason,
+    since,
+    target: staleness.target
+  };
+}
+function wrapperReportsIdle(input) {
+  const caps = input.capabilities ?? [];
+  if (input.variant) return false;
+  if (caps.includes(AUTO_RESTART_CAPABILITY)) return true;
+  if (!caps.includes("agent-hibernation-v1")) return false;
+  if (input.flavor !== "claude" && input.flavor !== "codex") return false;
+  if (input.spawnedBy && input.spawnedBy.trim()) return false;
+  return !(input.tags ?? []).some((tag) => tag === "teams" || tag === "automation" || tag === "assistant");
+}
+const AUTO_UPDATED_EVENT_KIND = "session-auto-updated";
+const AUTO_RESTARTED_ENV = "HAPPY_AUTO_RESTARTED";
+function encodeAutoRestarted(kind, target) {
+  return `${kind}:${target}`;
+}
+function decodeAutoRestarted(raw) {
+  const match = /^(cli|agent):(\S{1,64})$/.exec(raw?.trim() ?? "");
+  return match ? { kind: match[1], target: match[2] } : null;
+}
+function autoUpdatedEventText(kind, version, agentName = "Codex") {
+  return kind === "agent" ? `Updated ${agentName} to ${version} (session restarted in place, history kept)` : `Updated to Very Happy ${version} (session restarted in place, history kept)`;
+}
+function takeAutoRestartedEvent(env, agentName) {
+  const decoded = decodeAutoRestarted(env[AUTO_RESTARTED_ENV]);
+  delete env[AUTO_RESTARTED_ENV];
+  if (!decoded) return null;
+  return { type: "message", kind: AUTO_UPDATED_EVENT_KIND, message: autoUpdatedEventText(decoded.kind, decoded.target, agentName) };
+}
+
 const runtime = {
   signal: (pid, signal) => process.kill(pid, signal),
   isAlive: (pid) => {
@@ -233,4 +350,4 @@ async function claimSessionOrExit(happySessionId, options) {
   process.on("exit", () => releaseSessionLock(happySessionId));
 }
 
-export { applyServerSnapshot as a, applyReconnectReplay as b, claimSessionOrExit as c, terminateProcessTree as d, exitCursorStamp as e, mergeReconnectMetadata as m, processIdentityFields as p, readSessionLock as r, terminateProcess as t, withoutServerSnapshot as w };
+export { AUTO_RESTART_CAPABILITY as A, applyServerSnapshot as a, applyReconnectReplay as b, claimSessionOrExit as c, wrapperReportsIdle as d, exitCursorStamp as e, decideAutoRestart as f, autoRestartNextCheck as g, wrapperStaleness as h, AUTO_RESTART_MAX_ATTEMPTS as i, AUTO_RESTART_MIN_GAP_MS as j, readSessionLock as k, terminateProcess as l, mergeReconnectMetadata as m, terminateProcessTree as n, AUTO_RESTARTED_ENV as o, processIdentityFields as p, encodeAutoRestarted as q, recordAttempt as r, statusFromVerdict as s, takeAutoRestartedEvent as t, resolveQuietMs as u, AUTO_RESTART_RECHECK_CAP_MS as v, withoutServerSnapshot as w };

package/dist/{sessionOps-CljctDs5.mjs → sessionOps-CA2kpm66.mjs}

@@ -1,10 +1,10 @@
 import axios from 'axios';
-import { c as configuration } from './configuration-1FabKklB.mjs';
+import { c as configuration } from './configuration-Dechcvd-.mjs';
 import { e as encodeBase64, g as encrypt, d as decodeBase64, h as decrypt } from './authRelay-DhQhkBvX.mjs';
-import { l as listDaemonSessions, f as stopDaemonSession } from './controlClient-DwNnNAUx.mjs';
-import { b as readCredentialsForConfiguredRelay, c as readPersistedSessions } from './persistence-0INrP3aB.mjs';
+import { l as listDaemonSessions, f as stopDaemonSession } from './controlClient-D7NGfmtq.mjs';
+import { b as readCredentialsForConfiguredRelay, c as readPersistedSessions } from './persistence-Dogj7JIp.mjs';
 import { randomUUID } from 'node:crypto';
-import { d as delay } from './time-CUK37wiV.mjs';
+import { d as delay } from './time-CN3TuSVG.mjs';
 import { c as compactCommandText, p as parseClear } from './specialCommands-MXUN0wfI.mjs';
 import { io } from 'socket.io-client';
 import { b as backgroundTasksReport } from './backgroundTaskActivity-8PdPxrvy.mjs';
@@ -541,6 +541,12 @@ function sessionLiveness(live, sessionId) {
   const child = live.find((entry) => entry.happySessionId === sessionId);
   return child ? livenessOf(child) : { live: false };
 }
+function lineageOf(meta) {
+  return {
+    ...typeof meta?.parentSessionId === "string" && meta.parentSessionId ? { parentSessionId: meta.parentSessionId } : {},
+    ...typeof meta?.forkedFromMessageId === "string" && meta.forkedFromMessageId ? { forkedFromMessageId: meta.forkedFromMessageId } : {}
+  };
+}
 function toSummary(id, persisted, extra) {
   const meta = persisted?.metadata;
   return {
@@ -553,6 +559,7 @@ function toSummary(id, persisted, extra) {
     ...meta?.flavor ? { flavor: meta.flavor } : {},
     ...meta?.tags?.length ? { tags: [...meta.tags] } : {},
     ...meta?.variant ? { variant: meta.variant } : {},
+    ...lineageOf(meta),
     url: sessionWebUrl(id),
     ...persisted?.savedAt !== void 0 ? { savedAt: persisted.savedAt } : {}
   };
@@ -598,6 +605,7 @@ function summarizeAccountSession(row, persisted, liveIds, now) {
     ...meta.flavor ? { flavor: meta.flavor } : {},
     ...meta.tags?.length ? { tags: [...meta.tags] } : {},
     ...meta.variant ? { variant: meta.variant } : {},
+    ...lineageOf(meta),
     ...meta.machineId ? { machineId: meta.machineId } : {},
     ...persisted.savedAt !== void 0 ? { savedAt: persisted.savedAt } : {},
     pending,
@@ -785,4 +793,4 @@ async function unarchiveSession(sessionId) {
   );
 }
 
-export { DEFAULT_RECENT_LIMIT as D, MAX_READ_LIMIT as M, TurnWaitTimeoutError as T, listSessions as a, stopSession as b, resolvePermissionRequest as c, archiveSession as d, sendUserMessage as e, readSessionMetadata as f, waitForSessionKey as g, sessionLiveness as h, readSessionState as i, analyzeLatestTurn as j, readSessionLog as k, listAccountSessions as l, TURN_WINDOW as m, userPromptText as n, openUserScopedSocket as o, readSessionTranscript as r, sessionWebUrl as s, unarchiveSession as u, waitForTurnEnd as w };
+export { DEFAULT_RECENT_LIMIT as D, MAX_READ_LIMIT as M, TurnWaitTimeoutError as T, listSessions as a, stopSession as b, resolvePermissionRequest as c, archiveSession as d, sendUserMessage as e, readSessionMetadata as f, waitForSessionKey as g, sessionLiveness as h, readSessionState as i, lineageOf as j, analyzeLatestTurn as k, listAccountSessions as l, readSessionLog as m, TURN_WINDOW as n, openUserScopedSocket as o, userPromptText as p, readSessionTranscript as r, sessionWebUrl as s, unarchiveSession as u, waitForTurnEnd as w };

package/dist/{sessionOps-BzeOKIEF.cjs → sessionOps-DeWVqpe4.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
 var axios = require('axios');
-var configuration = require('./configuration-C0ctLGW2.cjs');
+var configuration = require('./configuration-Dt5lKW3P.cjs');
 var authRelay = require('./authRelay-Dy1qU9td.cjs');
-var controlClient = require('./controlClient-F7hAEEy2.cjs');
-var persistence = require('./persistence-CrzC7yr_.cjs');
+var controlClient = require('./controlClient-BRk65BRO.cjs');
+var persistence = require('./persistence-Bl5S3TLB.cjs');
 var node_crypto = require('node:crypto');
-var time = require('./time-XwEZxKGc.cjs');
+var time = require('./time-gPD_EmA-.cjs');
 var specialCommands = require('./specialCommands-J3JFOq0J.cjs');
 var socket_ioClient = require('socket.io-client');
 var backgroundTaskActivity = require('./backgroundTaskActivity-CBvUdj39.cjs');
@@ -543,6 +543,12 @@ function sessionLiveness(live, sessionId) {
   const child = live.find((entry) => entry.happySessionId === sessionId);
   return child ? livenessOf(child) : { live: false };
 }
+function lineageOf(meta) {
+  return {
+    ...typeof meta?.parentSessionId === "string" && meta.parentSessionId ? { parentSessionId: meta.parentSessionId } : {},
+    ...typeof meta?.forkedFromMessageId === "string" && meta.forkedFromMessageId ? { forkedFromMessageId: meta.forkedFromMessageId } : {}
+  };
+}
 function toSummary(id, persisted, extra) {
   const meta = persisted?.metadata;
   return {
@@ -555,6 +561,7 @@ function toSummary(id, persisted, extra) {
     ...meta?.flavor ? { flavor: meta.flavor } : {},
     ...meta?.tags?.length ? { tags: [...meta.tags] } : {},
     ...meta?.variant ? { variant: meta.variant } : {},
+    ...lineageOf(meta),
     url: sessionWebUrl(id),
     ...persisted?.savedAt !== void 0 ? { savedAt: persisted.savedAt } : {}
   };
@@ -600,6 +607,7 @@ function summarizeAccountSession(row, persisted, liveIds, now) {
     ...meta.flavor ? { flavor: meta.flavor } : {},
     ...meta.tags?.length ? { tags: [...meta.tags] } : {},
     ...meta.variant ? { variant: meta.variant } : {},
+    ...lineageOf(meta),
     ...meta.machineId ? { machineId: meta.machineId } : {},
     ...persisted.savedAt !== void 0 ? { savedAt: persisted.savedAt } : {},
     pending,
@@ -793,6 +801,7 @@ exports.TURN_WINDOW = TURN_WINDOW;
 exports.TurnWaitTimeoutError = TurnWaitTimeoutError;
 exports.analyzeLatestTurn = analyzeLatestTurn;
 exports.archiveSession = archiveSession;
+exports.lineageOf = lineageOf;
 exports.listAccountSessions = listAccountSessions;
 exports.listSessions = listSessions;
 exports.openUserScopedSocket = openUserScopedSocket;

package/dist/{sessionProvider-ORgzmkXy.cjs → sessionProvider-VFbtUmMR.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
 var chalk = require('chalk');
-var configuration = require('./configuration-C0ctLGW2.cjs');
-var controlClient = require('./controlClient-F7hAEEy2.cjs');
+var configuration = require('./configuration-Dt5lKW3P.cjs');
+var controlClient = require('./controlClient-BRk65BRO.cjs');
 var providerBinding = require('./providerBinding-B-Qbx9W2.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-CYDdLA6R.cjs');
+require('./package-DrY090nZ.cjs');
 require('node:fs/promises');
-require('./logger-BP1SW7Cs.cjs');
+require('./logger-BBRTTVsQ.cjs');
 require('node:util');
-require('./persistence-CrzC7yr_.cjs');
+require('./persistence-Bl5S3TLB.cjs');
 require('zod');
 require('./authRelay-Dy1qU9td.cjs');
 require('node:crypto');

package/dist/{sessionProvider-BnUFSJXM.mjs → sessionProvider-g18IiK74.mjs}

@@ -1,15 +1,15 @@
 import chalk from 'chalk';
-import { c as configuration } from './configuration-1FabKklB.mjs';
-import { r as restartDaemonSession } from './controlClient-DwNnNAUx.mjs';
+import { c as configuration } from './configuration-Dechcvd-.mjs';
+import { r as restartDaemonSession } from './controlClient-D7NGfmtq.mjs';
 import { r as readSessionProviders, b as readProviders, w as writeSessionProviders, u as updateBindings, s as sessionProvidersPath } from './providerBinding-CYubGg-Z.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-DTcaIhjW.mjs';
+import './package-C6uiXULx.mjs';
 import 'node:fs/promises';
-import './logger-DOKH3Zbh.mjs';
+import './logger-CL7pin9b.mjs';
 import 'node:util';
-import './persistence-0INrP3aB.mjs';
+import './persistence-Dogj7JIp.mjs';
 import 'zod';
 import './authRelay-DhQhkBvX.mjs';
 import 'node:crypto';

package/dist/{sessionScanner-Cr6PJ3PT.cjs → sessionScanner-CGzsN8V6.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
-var sync = require('./sync-CoChLEIg.cjs');
+var sync = require('./sync-DtWB7RzA.cjs');
 var types = require('./types-CRS-srZK.cjs');
 var path$1 = require('node:path');
 var node_fs = require('node:fs');
 var transcriptCursor = require('./transcriptCursor-DcXGLeSc.cjs');
-var logger = require('./logger-BP1SW7Cs.cjs');
-var startFileWatcher = require('./startFileWatcher-C-XCZ5t2.cjs');
+var logger = require('./logger-BBRTTVsQ.cjs');
+var startFileWatcher = require('./startFileWatcher-BQs0cJA-.cjs');
 var path = require('./path-B7zW-WwE.cjs');
 
 class Future {

package/dist/{sessionScanner-DZUlkdF6.mjs → sessionScanner-DDDud5re.mjs}

@@ -1,10 +1,10 @@
-import { I as InvalidateSync } from './sync-BvDMkKAN.mjs';
+import { I as InvalidateSync } from './sync-eZkXnsW_.mjs';
 import { R as RawJSONLinesSchema } from './types-CkqAACXx.mjs';
 import { join } from 'node:path';
 import { statSync } from 'node:fs';
 import { r as readTranscriptIncrement, i as isValidTranscriptHint } from './transcriptCursor-B7T_gkQ0.mjs';
-import { l as logger } from './logger-DOKH3Zbh.mjs';
-import { s as startFileWatcher } from './startFileWatcher-DkEeeAtL.mjs';
+import { l as logger } from './logger-CL7pin9b.mjs';
+import { s as startFileWatcher } from './startFileWatcher-Dedtu1vq.mjs';
 import { g as getProjectPath } from './path-D2wdaNSk.mjs';
 
 class Future {

package/dist/{sessions-15cag-su.mjs → sessions-B4d50sCI.mjs}

@@ -1,28 +1,29 @@
 import chalk from 'chalk';
-import { D as DEFAULT_RECENT_LIMIT, M as MAX_READ_LIMIT, l as listAccountSessions, a as listSessions, w as waitForTurnEnd, T as TurnWaitTimeoutError, r as readSessionTranscript, b as stopSession, c as resolvePermissionRequest, d as archiveSession } from './sessionOps-CljctDs5.mjs';
+import { e as exitAfterFlush } from './exitAfterFlush-AbKNZM0N.mjs';
+import { D as DEFAULT_RECENT_LIMIT, M as MAX_READ_LIMIT, l as listAccountSessions, a as listSessions, w as waitForTurnEnd, T as TurnWaitTimeoutError, r as readSessionTranscript, b as stopSession, c as resolvePermissionRequest, d as archiveSession } from './sessionOps-CA2kpm66.mjs';
 import { i as isValidSessionId } from './ids-DU6sLx4C.mjs';
-import { c as cliPeerSelf, e as executeSessionPeerTool, l as listPeerSessions, s as sendPeerMessage, P as PEER_SCOPES } from './peerTools-BtrUnSwz.mjs';
-import { c as readPersistedSessions } from './persistence-0INrP3aB.mjs';
+import { P as PEER_SCOPES, c as cliPeerSelf, e as executeSessionPeerTool, l as listPeerSessions, s as sendPeerMessage } from './peerTools-dY1aJez4.mjs';
+import { c as readPersistedSessions } from './persistence-Dogj7JIp.mjs';
 import { resolve } from 'node:path';
-import { f as fillForeignAccountRows, l as listRemoteSessions, a as listRemotePeers, w as waitForRemoteTurnEnd, r as readRemoteTranscript } from './remoteSessionClient-Vfj_5g2-.mjs';
+import { f as fillForeignAccountRows, l as listRemoteSessions, a as listRemotePeers, w as waitForRemoteTurnEnd, r as readRemoteTranscript } from './remoteSessionClient-BiC2KDew.mjs';
 import 'axios';
-import './configuration-1FabKklB.mjs';
+import './configuration-Dechcvd-.mjs';
 import 'node:fs';
 import 'node:os';
-import './package-DTcaIhjW.mjs';
+import './package-C6uiXULx.mjs';
 import 'node:fs/promises';
 import './authRelay-DhQhkBvX.mjs';
 import 'node:crypto';
 import 'tweetnacl';
-import './controlClient-DwNnNAUx.mjs';
-import './logger-DOKH3Zbh.mjs';
+import './controlClient-D7NGfmtq.mjs';
+import './logger-CL7pin9b.mjs';
 import 'node:util';
-import './time-CUK37wiV.mjs';
+import './time-CN3TuSVG.mjs';
 import './specialCommands-MXUN0wfI.mjs';
 import 'socket.io-client';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
 import 'zod';
-import './client-B161HwAk.mjs';
+import './client-CnGNYidN.mjs';
 
 const MACHINE_ID_RE = /^[a-zA-Z0-9_-]{1,128}$/;
 const ACTIONS = ["list", "read", "stop", "archive", "approve", "deny", "peers", "message"];
@@ -185,6 +186,9 @@ ${chalk.bold("Actions:")}
              async sub-agents / backgrounded commands still running after
              the turn ended \u2014 such a session is NOT idle (absent = the
              daemon or CLI is too old to report it).
+             A forked session shows \`parent=<id>\` (\`parentSessionId\`,
+             plus \`forkedFromMessageId\` for a fork from a message, in
+             --json) in list, list --all and read.
   stop       SIGTERM the session's process via the local daemon.
   archive    Mark the session inactive server-side (it stays resumable).
   approve    Answer a pending permission request \`requestId\` with approve \u2014
@@ -280,6 +284,7 @@ function formatAccountSummaryLine(summary) {
     if (summary.flavor) parts.push(`agent=${summary.flavor}`);
     if (summary.tags?.length) parts.push(`tags=${summary.tags.join(",")}`);
     if (summary.variant) parts.push(`variant=${summary.variant}`);
+    if (summary.parentSessionId) parts.push(`parent=${summary.parentSessionId}`);
     if (summary.machineId) parts.push(`machine=${summary.machineId}`);
     if (summary.cwd) parts.push(`cwd=${summary.cwd}`);
     if (summary.backgroundTasks && summary.backgroundTasks.count > 0) parts.push(formatBackgroundTasks(summary.backgroundTasks));
@@ -306,6 +311,7 @@ function formatSummaryLine(summary) {
   if (summary.flavor) parts.push(`agent=${summary.flavor}`);
   if (summary.tags?.length) parts.push(`tags=${summary.tags.join(",")}`);
   if (summary.variant) parts.push(`variant=${summary.variant}`);
+  if (summary.parentSessionId) parts.push(`parent=${summary.parentSessionId}`);
   if (summary.cwd) parts.push(`cwd=${summary.cwd}`);
   if (summary.pid !== void 0) parts.push(`pid=${summary.pid}`);
   if (summary.backgroundTasks && summary.backgroundTasks.count > 0) parts.push(formatBackgroundTasks(summary.backgroundTasks));
@@ -313,17 +319,20 @@ function formatSummaryLine(summary) {
   return parts.join(" ");
 }
 async function handleSessionsCommand(args) {
+  return exitAfterFlush(await runSessionsCommand(args));
+}
+async function runSessionsCommand(args) {
   let options;
   try {
     options = parseSessionsArgs(args);
   } catch (error) {
     console.error(chalk.red("Error:"), error instanceof Error ? error.message : String(error));
     console.error(`Run ${chalk.cyan("very-happy sessions --help")} for usage.`);
-    process.exit(1);
+    return 1;
   }
   if (options.action === "help") {
     console.log(SESSIONS_HELP);
-    process.exit(0);
+    return 0;
   }
   try {
     if (options.action === "list" && options.all) {
@@ -354,7 +363,7 @@ async function handleSessionsCommand(args) {
           console.log(chalk.dim(`${foreign} session(s) belong to a machine that is not reachable right now${why}.`));
         }
       }
-      process.exit(0);
+      return 0;
     }
     if (options.action === "list" && options.machine) {
       const listing = await listRemoteSessions(options.machine, { tag: options.tag, limit: options.limit });
@@ -367,7 +376,7 @@ async function handleSessionsCommand(args) {
         console.log(chalk.dim(`machine ${listing.host} (${listing.machineId})`));
         for (const summary of sessions) console.log(formatSummaryLine(summary));
       }
-      process.exit(0);
+      return 0;
     }
     if (options.action === "list") {
       const sessions = await listSessions({ tag: options.tag, recentLimit: options.limit });
@@ -378,7 +387,7 @@ async function handleSessionsCommand(args) {
       } else {
         for (const summary of sessions) console.log(formatSummaryLine(summary));
       }
-      process.exit(0);
+      return 0;
     }
     if (options.action === "peers" || options.action === "message") {
       const cwd = options.cwd ? resolve(options.cwd) : process.cwd();
@@ -391,7 +400,7 @@ async function handleSessionsCommand(args) {
         else if (!listing.project) console.log(`Not in a project (${self.sessionId}).`);
         else if (listing.peers.length === 0) console.log(`No other sessions in project "${listing.project.name}".`);
         else for (const peer of listing.peers) console.log([peer.sessionId, `[${peer.state ?? "?"}]`, peer.title ? `title="${peer.title}"` : "", peer.agent ? `agent=${peer.agent}` : "", peer.machine ? `machine=${peer.machine}` : "", peer.doing ? `doing="${peer.doing}"` : "", peer.url].filter(Boolean).join(" "));
-        process.exit(0);
+        return 0;
       }
       if (options.action === "peers") {
         const scope = options.scope === "project" ? void 0 : options.scope;
@@ -412,7 +421,7 @@ async function handleSessionsCommand(args) {
             for (const edit of peer.edits) console.log(chalk.dim(`    ${edit.tool} ${edit.path} (${Math.round((Date.now() - edit.at) / 6e4)}m ago)`));
           }
         }
-        process.exit(0);
+        return 0;
       }
       const target = options.sessionId;
       try {
@@ -423,7 +432,7 @@ ${result.url}`);
         else if (result.status === "offline-stored") console.log(`Message ${result.messageId} ${result.note ?? "stored"} (${target} is not running; same project)
 ${result.url}`);
         else console.error(chalk.yellow("Not delivered:"), result.error ?? `session is ${result.status}`, result.stored ? "(stored server-side, unread)" : "");
-        process.exit(peerMessageExitCode(result));
+        return peerMessageExitCode(result);
       } catch (error) {
         if (options.json) console.log(JSON.stringify({ delivered: false, to: target, error: error instanceof Error ? error.message : String(error) }));
         throw error;
@@ -474,18 +483,18 @@ ${result.url}`);
         const turn = result.turn;
         console.log(chalk.dim(`--- latest turn: ${turn.ended ? `ended (${turn.status ?? "unknown"})` : "running"}${turn.error ? ` \u2014 ${turn.error}` : ""} ---`));
       }
-      process.exit(timedOut ? 2 : 0);
+      return timedOut ? 2 : 0;
     }
     if (options.action === "stop") {
       const stopped = await stopSession(sessionId);
       if (!stopped) {
         if (options.json) console.log(JSON.stringify({ sessionId, stopped: false }));
         console.error(chalk.red("Error:"), `Session ${sessionId} is not among the daemon's running sessions.`);
-        process.exit(1);
+        return 1;
       }
       if (options.json) console.log(JSON.stringify({ sessionId, stopped: true }));
       else console.log(`Stopped ${sessionId}`);
-      process.exit(0);
+      return 0;
     }
     if (options.action === "approve" || options.action === "deny") {
       const requestId = options.requestId;
@@ -507,7 +516,7 @@ ${result.url}`);
         if (options.json) console.log(JSON.stringify(result));
         const hint = result.outcome.status === "rate-limited" ? ` \u2014 the request is still pending; re-run in ~${Math.ceil(result.outcome.retryAfterMs / 1e3)}s` : "";
         console.error(chalk.red("Error:"), `${options.action} of ${requestId} on ${sessionId} was not delivered (${result.outcome.status}): ${result.outcome.message}${hint}`);
-        process.exit(1);
+        return 1;
       }
       if (options.json) {
         console.log(JSON.stringify(result));
@@ -515,16 +524,16 @@ ${result.url}`);
         const verb = options.action === "approve" ? "Approved" : "Denied";
         console.log(`${verb} ${requestId} on ${sessionId} (${result.payload.decision})${result.settled ? "" : " \u2014 wrapper acknowledged, but the request was still listed as pending when we stopped waiting"}`);
       }
-      process.exit(0);
+      return 0;
     }
     await archiveSession(sessionId);
     if (options.json) console.log(JSON.stringify({ sessionId, archived: true }));
     else console.log(`Archived ${sessionId}`);
-    process.exit(0);
+    return 0;
   } catch (error) {
     console.error(chalk.red("Error:"), error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    return 1;
   }
 }
 
-export { SESSIONS_HELP, handleSessionsCommand, parseSessionsArgs, peerMessageExitCode, permissionFailureRecord };
+export { SESSIONS_HELP, formatAccountSummaryLine, formatSummaryLine, handleSessionsCommand, parseSessionsArgs, peerMessageExitCode, permissionFailureRecord };