very-happy-cli 0.2.165 → 0.2.167

package/dist/{controlClient-RWTlQA4_.cjs → controlClient-BI6Fw3fQ.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var logger = require('./logger-D0hkk7Vo.cjs');
-var persistence = require('./persistence-C6ztVW1W.cjs');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
+var persistence = require('./persistence-BYGl0QYw.cjs');
+var configuration = require('./configuration-C3piBtxY.cjs');
 
 function daemonControlHeaders(controlToken) {
   return {
@@ -125,6 +125,13 @@ async function notifyDaemonTurnEvent(sessionId, event) {
 async function notifyDaemonBackgroundTasks(sessionId, backgroundTasks) {
   return daemonPost("/session-event", { sessionId, event: "background_tasks", backgroundTasks });
 }
+function reportRateLimitsToDaemon(report) {
+  void daemonPost("/rate-limits", report).then((result) => {
+    if (result?.error) logger.logger.debug(`[CONTROL CLIENT] rate-limits not recorded: ${result.error}`);
+  }).catch((error) => {
+    logger.logger.debug("[CONTROL CLIENT] rate-limits failed:", error);
+  });
+}
 function reportSessionEditToDaemon(edit) {
   void daemonPost("/session-edit", edit).then((result) => {
     if (result?.error) logger.logger.debug(`[CONTROL CLIENT] session-edit not recorded: ${result.error}`);
@@ -153,8 +160,8 @@ async function pushClipboardViaDaemon(text, terminalId) {
   }
   return result;
 }
-async function pushFilePreviewViaDaemon(terminalId, path, mode = "file") {
-  const result = await daemonPost("/file-preview", { terminalId, path, mode });
+async function pushFilePreviewViaDaemon(terminalId, path, mode = "file", intent) {
+  const result = await daemonPost("/file-preview", { terminalId, path, mode, ...intent ? { intent } : {} });
   if (result?.error) return { delivered: false, error: result.error };
   return { delivered: result?.delivered === true, ...result?.delivered === true ? {} : { error: "preview was not delivered" } };
 }
@@ -258,7 +265,22 @@ async function waitForProcessDeath(pid, timeout) {
   }
   throw new Error("Process did not die within timeout");
 }
+async function checkDaemonHibernation(body) {
+  const result = await daemonPost("/session-hibernate-check", body);
+  if (result && typeof result === "object" && typeof result.error === "string") {
+    return /404|Not Found|No daemon running|not running/.test(result.error) ? "unsupported" : "error";
+  }
+  if (!result || typeof result.hibernate !== "boolean") return "error";
+  return {
+    hibernate: result.hibernate,
+    ...typeof result.reason === "string" ? { reason: result.reason } : {},
+    ...typeof result.idleMs === "number" ? { idleMs: result.idleMs } : {},
+    ...typeof result.nextCheckMs === "number" ? { nextCheckMs: result.nextCheckMs } : {},
+    ...result.keepAwake === true ? { keepAwake: true } : {}
+  };
+}
 
+exports.checkDaemonHibernation = checkDaemonHibernation;
 exports.checkIfDaemonRunningAndCleanupStaleState = checkIfDaemonRunningAndCleanupStaleState;
 exports.cleanupDaemonState = cleanupDaemonState;
 exports.isDaemonRunningCurrentlyInstalledHappyVersion = isDaemonRunningCurrentlyInstalledHappyVersion;
@@ -271,6 +293,7 @@ exports.notifyDaemonSessionStarted = notifyDaemonSessionStarted;
 exports.notifyDaemonTurnEvent = notifyDaemonTurnEvent;
 exports.pushClipboardViaDaemon = pushClipboardViaDaemon;
 exports.pushFilePreviewViaDaemon = pushFilePreviewViaDaemon;
+exports.reportRateLimitsToDaemon = reportRateLimitsToDaemon;
 exports.reportSessionEditToDaemon = reportSessionEditToDaemon;
 exports.resumeDaemonSession = resumeDaemonSession;
 exports.setTerminalTitleViaDaemon = setTerminalTitleViaDaemon;

package/dist/{controlClient-Ci7HTMII.mjs → controlClient-DTheOlvC.mjs}

@@ -1,6 +1,6 @@
-import { l as logger } from './logger-CknSVkIe.mjs';
-import { readDaemonState, clearDaemonState } from './persistence-DujtUH94.mjs';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
+import { l as logger } from './logger-CbBv3q_b.mjs';
+import { d as readDaemonState, f as clearDaemonState } from './persistence-ON0zpHfb.mjs';
+import { c as configuration } from './configuration-WspKd2C2.mjs';
 
 function daemonControlHeaders(controlToken) {
   return {
@@ -123,6 +123,13 @@ async function notifyDaemonTurnEvent(sessionId, event) {
 async function notifyDaemonBackgroundTasks(sessionId, backgroundTasks) {
   return daemonPost("/session-event", { sessionId, event: "background_tasks", backgroundTasks });
 }
+function reportRateLimitsToDaemon(report) {
+  void daemonPost("/rate-limits", report).then((result) => {
+    if (result?.error) logger.debug(`[CONTROL CLIENT] rate-limits not recorded: ${result.error}`);
+  }).catch((error) => {
+    logger.debug("[CONTROL CLIENT] rate-limits failed:", error);
+  });
+}
 function reportSessionEditToDaemon(edit) {
   void daemonPost("/session-edit", edit).then((result) => {
     if (result?.error) logger.debug(`[CONTROL CLIENT] session-edit not recorded: ${result.error}`);
@@ -151,8 +158,8 @@ async function pushClipboardViaDaemon(text, terminalId) {
   }
   return result;
 }
-async function pushFilePreviewViaDaemon(terminalId, path, mode = "file") {
-  const result = await daemonPost("/file-preview", { terminalId, path, mode });
+async function pushFilePreviewViaDaemon(terminalId, path, mode = "file", intent) {
+  const result = await daemonPost("/file-preview", { terminalId, path, mode, ...intent ? { intent } : {} });
   if (result?.error) return { delivered: false, error: result.error };
   return { delivered: result?.delivered === true, ...result?.delivered === true ? {} : { error: "preview was not delivered" } };
 }
@@ -256,5 +263,19 @@ async function waitForProcessDeath(pid, timeout) {
   }
   throw new Error("Process did not die within timeout");
 }
+async function checkDaemonHibernation(body) {
+  const result = await daemonPost("/session-hibernate-check", body);
+  if (result && typeof result === "object" && typeof result.error === "string") {
+    return /404|Not Found|No daemon running|not running/.test(result.error) ? "unsupported" : "error";
+  }
+  if (!result || typeof result.hibernate !== "boolean") return "error";
+  return {
+    hibernate: result.hibernate,
+    ...typeof result.reason === "string" ? { reason: result.reason } : {},
+    ...typeof result.idleMs === "number" ? { idleMs: result.idleMs } : {},
+    ...typeof result.nextCheckMs === "number" ? { nextCheckMs: result.nextCheckMs } : {},
+    ...result.keepAwake === true ? { keepAwake: true } : {}
+  };
+}
 
-export { stopDaemon as a, pushFilePreviewViaDaemon as b, checkIfDaemonRunningAndCleanupStaleState as c, setTerminalTitleViaDaemon as d, spawnDaemonSession as e, listDaemonPeers as f, reportSessionEditToDaemon as g, notifyDaemonTurnEvent as h, isDaemonRunningCurrentlyInstalledHappyVersion as i, notifyDaemonBackgroundTasks as j, notifyDaemonSessionEvent as k, listDaemonSessions as l, notifyDaemonClaudeAuthFailed as m, notifyDaemonSessionStarted as n, cleanupDaemonState as o, pushClipboardViaDaemon as p, resumeDaemonSession as r, stopDaemonSession as s };
+export { checkIfDaemonRunningAndCleanupStaleState as a, stopDaemon as b, checkDaemonHibernation as c, pushFilePreviewViaDaemon as d, setTerminalTitleViaDaemon as e, spawnDaemonSession as f, listDaemonPeers as g, resumeDaemonSession as h, isDaemonRunningCurrentlyInstalledHappyVersion as i, reportSessionEditToDaemon as j, notifyDaemonTurnEvent as k, listDaemonSessions as l, notifyDaemonBackgroundTasks as m, notifyDaemonSessionStarted as n, notifyDaemonSessionEvent as o, pushClipboardViaDaemon as p, notifyDaemonClaudeAuthFailed as q, reportRateLimitsToDaemon as r, stopDaemonSession as s, cleanupDaemonState as t };

package/dist/{createSessionMetadata-CWR-AB2A.mjs → createSessionMetadata-BEZ4DIDA.mjs}

@@ -1,8 +1,58 @@
 import os from 'node:os';
-import { resolve } from 'node:path';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
+import { resolve, isAbsolute, dirname } from 'node:path';
+import { c as configuration } from './configuration-WspKd2C2.mjs';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { p as packageJson } from './package-VIUXrYZ1.mjs';
+import { p as packageJson } from './package-DU1DxhH9.mjs';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+
+const realFs = {
+  existsSync,
+  isDirectory: (path) => {
+    try {
+      return statSync(path).isDirectory();
+    } catch {
+      return false;
+    }
+  },
+  readFileSync: (path) => readFileSync(path, "utf8")
+};
+function resolveSessionWorktree(cwd, fs = realFs) {
+  let dir = resolve(cwd);
+  for (let depth = 0; depth < 64; depth++) {
+    const dotGit = resolve(dir, ".git");
+    try {
+      if (fs.existsSync(dotGit)) {
+        if (fs.isDirectory(dotGit)) return null;
+        const gitdir = fs.readFileSync(dotGit).match(/^gitdir:\s*(.+?)\s*$/m)?.[1];
+        if (!gitdir) return null;
+        const absolute = isAbsolute(gitdir) ? gitdir : resolve(dir, gitdir);
+        if (!/[\\/]\.git[\\/]worktrees[\\/][^\\/]+[\\/]?$/.test(absolute)) return null;
+        let branch = null;
+        try {
+          const head = fs.readFileSync(resolve(absolute, "HEAD")).trim();
+          const ref = head.match(/^ref:\s*refs\/heads\/(.+)$/)?.[1];
+          branch = ref ?? null;
+        } catch {
+        }
+        return { branch, root: dir };
+      }
+    } catch {
+      return null;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function sessionWorktreeMetadata(cwd) {
+  try {
+    const worktree = resolveSessionWorktree(cwd);
+    return worktree ? { worktree } : {};
+  } catch {
+    return {};
+  }
+}
 
 const SPAWN_ORIGIN_TAG_MAX = 24;
 function spawnOriginTags(env = process.env, flavor = void 0) {
@@ -46,9 +96,11 @@ function createSessionMetadata(opts) {
     // B-091/B-303: dispatched sessions carry their spawn origin as a tag
     // from birth (see spawnOriginTags) — applies to every flavor the daemon
     // can spawn, since HAPPY_SPAWNED_BY is exported flavor-independently.
-    ...originTags ? { tags: originTags } : {}
+    ...originTags ? { tags: originTags } : {},
+    // B-586: linked git worktree → branch shown in the session list.
+    ...sessionWorktreeMetadata(process.cwd())
   };
   return { state, metadata };
 }
 
-export { createSessionMetadata as c, isValidSpawnOrigin as i, spawnOriginTags as s };
+export { sessionWorktreeMetadata as a, createSessionMetadata as c, isValidSpawnOrigin as i, spawnOriginTags as s };

package/dist/{createSessionMetadata-CPGTztXP.cjs → createSessionMetadata-zQSz3hgk.cjs}

@@ -2,9 +2,59 @@
 
 var os = require('node:os');
 var path = require('node:path');
-var configuration = require('./configuration-BE61XNsg.cjs');
+var configuration = require('./configuration-C3piBtxY.cjs');
 var projectPath = require('./projectPath-ChLhdOyt.cjs');
-var _package = require('./package-UkmvSFsg.cjs');
+var _package = require('./package-C9ZP9bpX.cjs');
+var node_fs = require('node:fs');
+
+const realFs = {
+  existsSync: node_fs.existsSync,
+  isDirectory: (path) => {
+    try {
+      return node_fs.statSync(path).isDirectory();
+    } catch {
+      return false;
+    }
+  },
+  readFileSync: (path) => node_fs.readFileSync(path, "utf8")
+};
+function resolveSessionWorktree(cwd, fs = realFs) {
+  let dir = path.resolve(cwd);
+  for (let depth = 0; depth < 64; depth++) {
+    const dotGit = path.resolve(dir, ".git");
+    try {
+      if (fs.existsSync(dotGit)) {
+        if (fs.isDirectory(dotGit)) return null;
+        const gitdir = fs.readFileSync(dotGit).match(/^gitdir:\s*(.+?)\s*$/m)?.[1];
+        if (!gitdir) return null;
+        const absolute = path.isAbsolute(gitdir) ? gitdir : path.resolve(dir, gitdir);
+        if (!/[\\/]\.git[\\/]worktrees[\\/][^\\/]+[\\/]?$/.test(absolute)) return null;
+        let branch = null;
+        try {
+          const head = fs.readFileSync(path.resolve(absolute, "HEAD")).trim();
+          const ref = head.match(/^ref:\s*refs\/heads\/(.+)$/)?.[1];
+          branch = ref ?? null;
+        } catch {
+        }
+        return { branch, root: dir };
+      }
+    } catch {
+      return null;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function sessionWorktreeMetadata(cwd) {
+  try {
+    const worktree = resolveSessionWorktree(cwd);
+    return worktree ? { worktree } : {};
+  } catch {
+    return {};
+  }
+}
 
 const SPAWN_ORIGIN_TAG_MAX = 24;
 function spawnOriginTags(env = process.env, flavor = void 0) {
@@ -48,11 +98,14 @@ function createSessionMetadata(opts) {
     // B-091/B-303: dispatched sessions carry their spawn origin as a tag
     // from birth (see spawnOriginTags) — applies to every flavor the daemon
     // can spawn, since HAPPY_SPAWNED_BY is exported flavor-independently.
-    ...originTags ? { tags: originTags } : {}
+    ...originTags ? { tags: originTags } : {},
+    // B-586: linked git worktree → branch shown in the session list.
+    ...sessionWorktreeMetadata(process.cwd())
   };
   return { state, metadata };
 }
 
 exports.createSessionMetadata = createSessionMetadata;
 exports.isValidSpawnOrigin = isValidSpawnOrigin;
+exports.sessionWorktreeMetadata = sessionWorktreeMetadata;
 exports.spawnOriginTags = spawnOriginTags;

package/dist/defaultPermissionMode-Cif_RHGb.mjs

@@ -0,0 +1,191 @@
+import { l as logger } from './logger-CbBv3q_b.mjs';
+import { e as evaluateWrapperIdle, j as HIBERNATION_UNSUPPORTED_BACKOFF_MS } from './persistence-ON0zpHfb.mjs';
+
+const PRESENCE_SETTLE_MS = 6e3;
+async function commitHibernation(deps) {
+  const log = deps.log ?? ((message) => logger.debug(message));
+  if (!deps.claimExit()) {
+    log("[hibernate] exit already claimed for another reason; not hibernating");
+    return false;
+  }
+  const { client } = deps;
+  const now = deps.now ?? Date.now;
+  const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  let frozen = false;
+  let stamped = false;
+  const waitOrExit = async (work, fallback) => {
+    let settled = false;
+    const watched = work.finally(() => {
+      settled = true;
+    });
+    const exitWatch = (async () => {
+      while (!settled && !deps.exitRequested()) await sleep(EXIT_POLL_MS);
+      return settled ? watched : fallback;
+    })();
+    return Promise.race([watched, exitWatch]);
+  };
+  const abort = async (why2) => {
+    log(`[hibernate] aborted at commit: ${why2}`);
+    if (stamped) {
+      const clear = (metadata) => {
+        const next = { ...metadata };
+        delete next.hibernation;
+        return next;
+      };
+      const cleared = await client.updateMetadataAndWait(clear, deps.exitRequested() ? EXIT_CLEAR_TIMEOUT_MS : void 0).catch(() => false);
+      if (!cleared) log("[hibernate] stamp clear not confirmed (it keeps retrying in the background)");
+    }
+    if (frozen) {
+      client.unmuteHeartbeats();
+      client.unfreezeInbound();
+    }
+    deps.releaseExit();
+    return false;
+  };
+  const moved = () => {
+    if (deps.exitRequested()) return "exit requested";
+    if (client.inboundRoutedSinceCommit()) return "inbound message";
+    const verdict = deps.recheck();
+    return verdict.ok ? null : verdict.reason;
+  };
+  client.beginHibernationCommit();
+  try {
+    await client.flush();
+  } catch (error) {
+    return abort(`flush failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  let why = moved();
+  if (why) return abort(why);
+  client.freezeInbound();
+  client.muteHeartbeats();
+  frozen = true;
+  const stamp = { at: now(), seq: client.messageCursor, idleMs: deps.idleMs, v: 1 };
+  stamped = true;
+  const landed = await waitOrExit(client.updateMetadataAndWait((metadata) => ({ ...metadata, hibernation: stamp })).catch(() => false), false);
+  if (deps.exitRequested()) return abort("exit requested");
+  if (!landed) return abort("stamp not confirmed");
+  const settle = Math.max(0, client.lastHeartbeatAt + (deps.presenceSettleMs ?? PRESENCE_SETTLE_MS) - now());
+  if (settle > 0) await waitOrExit(sleep(settle), void 0);
+  why = moved();
+  if (why) return abort(why);
+  deps.markCommitted();
+  log(`[hibernate] committing: seq=${stamp.seq} idleMs=${stamp.idleMs}`);
+  await deps.finish(stamp);
+  return true;
+}
+const EXIT_POLL_MS = 100;
+const EXIT_CLEAR_TIMEOUT_MS = 1e3;
+class HibernationProbe {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  timer = null;
+  stopped = false;
+  running = false;
+  start() {
+    this.schedule(this.deps.checkMs);
+  }
+  stop() {
+    this.stopped = true;
+    if (this.timer !== null) (this.deps.clearTimer ?? ((h) => clearTimeout(h)))(this.timer);
+    this.timer = null;
+  }
+  schedule(ms) {
+    if (this.stopped) return;
+    const set = this.deps.setTimer ?? ((fn, delay) => {
+      const handle = setTimeout(fn, delay);
+      handle.unref?.();
+      return handle;
+    });
+    this.timer = set(() => {
+      void this.tick();
+    }, Math.max(1e3, ms));
+  }
+  /** One sample; returns the delay it scheduled (or null when it hibernated / stopped). */
+  async tick() {
+    if (this.stopped || this.running) return null;
+    this.running = true;
+    const log = this.deps.log ?? ((message) => logger.debug(message));
+    try {
+      const now = (this.deps.now ?? Date.now)();
+      const snapshot = this.deps.snapshot();
+      const local = evaluateWrapperIdle(snapshot, 1, now);
+      if (!local.ok && local.reason !== "keep-awake") {
+        this.schedule(this.deps.checkMs);
+        return this.deps.checkMs;
+      }
+      const answer = await this.deps.ask(snapshot);
+      if (answer === "unsupported") {
+        this.schedule(HIBERNATION_UNSUPPORTED_BACKOFF_MS);
+        return HIBERNATION_UNSUPPORTED_BACKOFF_MS;
+      }
+      if (answer === "error") {
+        this.schedule(this.deps.checkMs);
+        return this.deps.checkMs;
+      }
+      if (answer.keepAwake === true) this.deps.onKeepAwakeLatched?.();
+      if (local.ok && answer.hibernate && typeof answer.idleMs === "number" && answer.idleMs > 0) {
+        const done = await this.deps.commit(answer.idleMs);
+        if (done) {
+          this.stopped = true;
+          return null;
+        }
+        this.schedule(this.deps.checkMs);
+        return this.deps.checkMs;
+      }
+      const next = typeof answer.nextCheckMs === "number" && answer.nextCheckMs > 0 ? answer.nextCheckMs : this.deps.checkMs;
+      if (answer.reason) log(`[hibernate] daemon says stay awake (${answer.reason}); next check in ${Math.round(next / 1e3)}s`);
+      this.schedule(next);
+      return next;
+    } catch (error) {
+      log(`[hibernate] probe failed: ${error instanceof Error ? error.message : String(error)}`);
+      this.schedule(this.deps.checkMs);
+      return this.deps.checkMs;
+    } finally {
+      this.running = false;
+    }
+  }
+}
+class HibernationExitLatch {
+  constructor(outranks) {
+    this.outranks = outranks;
+  }
+  active = false;
+  committed = false;
+  deferredIntent = null;
+  begin() {
+    if (this.active) return false;
+    this.active = true;
+    this.committed = false;
+    this.deferredIntent = null;
+    return true;
+  }
+  get hibernating() {
+    return this.active;
+  }
+  /** true = the caller must NOT run this exit now (deferred, or the process is already leaving). */
+  intercept(intent) {
+    if (!this.active) return false;
+    if (!this.committed && (this.deferredIntent === null || this.outranks(intent, this.deferredIntent))) this.deferredIntent = intent;
+    return true;
+  }
+  get exitRequested() {
+    return this.deferredIntent !== null;
+  }
+  commit() {
+    if (this.active) this.committed = true;
+  }
+  /** Abort: returns the deferred exit to run now (or null). No-op once committed. */
+  release() {
+    if (!this.active || this.committed) return null;
+    this.active = false;
+    const deferred = this.deferredIntent;
+    this.deferredIntent = null;
+    return deferred;
+  }
+}
+
+const DEFAULT_CLAUDE_PERMISSION_MODE = "default";
+const DEFAULT_CODEX_PERMISSION_MODE = "default";
+
+export { DEFAULT_CLAUDE_PERMISSION_MODE as D, HibernationProbe as H, HibernationExitLatch as a, DEFAULT_CODEX_PERMISSION_MODE as b, commitHibernation as c };

package/dist/defaultPermissionMode-DNKNzk7l.cjs

@@ -0,0 +1,197 @@
+'use strict';
+
+var logger = require('./logger-B_MWPbZz.cjs');
+var persistence = require('./persistence-BYGl0QYw.cjs');
+
+const PRESENCE_SETTLE_MS = 6e3;
+async function commitHibernation(deps) {
+  const log = deps.log ?? ((message) => logger.logger.debug(message));
+  if (!deps.claimExit()) {
+    log("[hibernate] exit already claimed for another reason; not hibernating");
+    return false;
+  }
+  const { client } = deps;
+  const now = deps.now ?? Date.now;
+  const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  let frozen = false;
+  let stamped = false;
+  const waitOrExit = async (work, fallback) => {
+    let settled = false;
+    const watched = work.finally(() => {
+      settled = true;
+    });
+    const exitWatch = (async () => {
+      while (!settled && !deps.exitRequested()) await sleep(EXIT_POLL_MS);
+      return settled ? watched : fallback;
+    })();
+    return Promise.race([watched, exitWatch]);
+  };
+  const abort = async (why2) => {
+    log(`[hibernate] aborted at commit: ${why2}`);
+    if (stamped) {
+      const clear = (metadata) => {
+        const next = { ...metadata };
+        delete next.hibernation;
+        return next;
+      };
+      const cleared = await client.updateMetadataAndWait(clear, deps.exitRequested() ? EXIT_CLEAR_TIMEOUT_MS : void 0).catch(() => false);
+      if (!cleared) log("[hibernate] stamp clear not confirmed (it keeps retrying in the background)");
+    }
+    if (frozen) {
+      client.unmuteHeartbeats();
+      client.unfreezeInbound();
+    }
+    deps.releaseExit();
+    return false;
+  };
+  const moved = () => {
+    if (deps.exitRequested()) return "exit requested";
+    if (client.inboundRoutedSinceCommit()) return "inbound message";
+    const verdict = deps.recheck();
+    return verdict.ok ? null : verdict.reason;
+  };
+  client.beginHibernationCommit();
+  try {
+    await client.flush();
+  } catch (error) {
+    return abort(`flush failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  let why = moved();
+  if (why) return abort(why);
+  client.freezeInbound();
+  client.muteHeartbeats();
+  frozen = true;
+  const stamp = { at: now(), seq: client.messageCursor, idleMs: deps.idleMs, v: 1 };
+  stamped = true;
+  const landed = await waitOrExit(client.updateMetadataAndWait((metadata) => ({ ...metadata, hibernation: stamp })).catch(() => false), false);
+  if (deps.exitRequested()) return abort("exit requested");
+  if (!landed) return abort("stamp not confirmed");
+  const settle = Math.max(0, client.lastHeartbeatAt + (deps.presenceSettleMs ?? PRESENCE_SETTLE_MS) - now());
+  if (settle > 0) await waitOrExit(sleep(settle), void 0);
+  why = moved();
+  if (why) return abort(why);
+  deps.markCommitted();
+  log(`[hibernate] committing: seq=${stamp.seq} idleMs=${stamp.idleMs}`);
+  await deps.finish(stamp);
+  return true;
+}
+const EXIT_POLL_MS = 100;
+const EXIT_CLEAR_TIMEOUT_MS = 1e3;
+class HibernationProbe {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  timer = null;
+  stopped = false;
+  running = false;
+  start() {
+    this.schedule(this.deps.checkMs);
+  }
+  stop() {
+    this.stopped = true;
+    if (this.timer !== null) (this.deps.clearTimer ?? ((h) => clearTimeout(h)))(this.timer);
+    this.timer = null;
+  }
+  schedule(ms) {
+    if (this.stopped) return;
+    const set = this.deps.setTimer ?? ((fn, delay) => {
+      const handle = setTimeout(fn, delay);
+      handle.unref?.();
+      return handle;
+    });
+    this.timer = set(() => {
+      void this.tick();
+    }, Math.max(1e3, ms));
+  }
+  /** One sample; returns the delay it scheduled (or null when it hibernated / stopped). */
+  async tick() {
+    if (this.stopped || this.running) return null;
+    this.running = true;
+    const log = this.deps.log ?? ((message) => logger.logger.debug(message));
+    try {
+      const now = (this.deps.now ?? Date.now)();
+      const snapshot = this.deps.snapshot();
+      const local = persistence.evaluateWrapperIdle(snapshot, 1, now);
+      if (!local.ok && local.reason !== "keep-awake") {
+        this.schedule(this.deps.checkMs);
+        return this.deps.checkMs;
+      }
+      const answer = await this.deps.ask(snapshot);
+      if (answer === "unsupported") {
+        this.schedule(persistence.HIBERNATION_UNSUPPORTED_BACKOFF_MS);
+        return persistence.HIBERNATION_UNSUPPORTED_BACKOFF_MS;
+      }
+      if (answer === "error") {
+        this.schedule(this.deps.checkMs);
+        return this.deps.checkMs;
+      }
+      if (answer.keepAwake === true) this.deps.onKeepAwakeLatched?.();
+      if (local.ok && answer.hibernate && typeof answer.idleMs === "number" && answer.idleMs > 0) {
+        const done = await this.deps.commit(answer.idleMs);
+        if (done) {
+          this.stopped = true;
+          return null;
+        }
+        this.schedule(this.deps.checkMs);
+        return this.deps.checkMs;
+      }
+      const next = typeof answer.nextCheckMs === "number" && answer.nextCheckMs > 0 ? answer.nextCheckMs : this.deps.checkMs;
+      if (answer.reason) log(`[hibernate] daemon says stay awake (${answer.reason}); next check in ${Math.round(next / 1e3)}s`);
+      this.schedule(next);
+      return next;
+    } catch (error) {
+      log(`[hibernate] probe failed: ${error instanceof Error ? error.message : String(error)}`);
+      this.schedule(this.deps.checkMs);
+      return this.deps.checkMs;
+    } finally {
+      this.running = false;
+    }
+  }
+}
+class HibernationExitLatch {
+  constructor(outranks) {
+    this.outranks = outranks;
+  }
+  active = false;
+  committed = false;
+  deferredIntent = null;
+  begin() {
+    if (this.active) return false;
+    this.active = true;
+    this.committed = false;
+    this.deferredIntent = null;
+    return true;
+  }
+  get hibernating() {
+    return this.active;
+  }
+  /** true = the caller must NOT run this exit now (deferred, or the process is already leaving). */
+  intercept(intent) {
+    if (!this.active) return false;
+    if (!this.committed && (this.deferredIntent === null || this.outranks(intent, this.deferredIntent))) this.deferredIntent = intent;
+    return true;
+  }
+  get exitRequested() {
+    return this.deferredIntent !== null;
+  }
+  commit() {
+    if (this.active) this.committed = true;
+  }
+  /** Abort: returns the deferred exit to run now (or null). No-op once committed. */
+  release() {
+    if (!this.active || this.committed) return null;
+    this.active = false;
+    const deferred = this.deferredIntent;
+    this.deferredIntent = null;
+    return deferred;
+  }
+}
+
+const DEFAULT_CLAUDE_PERMISSION_MODE = "default";
+const DEFAULT_CODEX_PERMISSION_MODE = "default";
+
+exports.DEFAULT_CLAUDE_PERMISSION_MODE = DEFAULT_CLAUDE_PERMISSION_MODE;
+exports.DEFAULT_CODEX_PERMISSION_MODE = DEFAULT_CODEX_PERMISSION_MODE;
+exports.HibernationExitLatch = HibernationExitLatch;
+exports.HibernationProbe = HibernationProbe;
+exports.commitHibernation = commitHibernation;