very-happy-cli 0.2.166 → 0.2.167

package/dist/{AcpBackend-20VHOXwb.cjs → AcpBackend-D1IKJGz_.cjs}

@@ -3,10 +3,10 @@
 var node_child_process = require('node:child_process');
 var sdk = require('@agentclientprotocol/sdk');
 var node_crypto = require('node:crypto');
-var logger = require('./logger-JTcJU-uL.cjs');
-var time = require('./time-T0YmeOhS.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
+var time = require('./time-BXvtjhe9.cjs');
 var contentLogMetadata = require('./contentLogMetadata-ZSFk_NjQ.cjs');
-var _package = require('./package-C1XvUQFy.cjs');
+var _package = require('./package-C9ZP9bpX.cjs');
 
 function acpImageBlocks(attachments, supportsImages) {
   return attachments.filter((file) => ["image/jpeg", "image/png", "image/gif", "image/webp"].includes(file.mimeType)).map((file) => {

package/dist/{AcpBackend-tRWk7yi7.mjs → AcpBackend-kFZlee5E.mjs}

@@ -1,10 +1,10 @@
 import { spawn } from 'node:child_process';
 import { ndJsonStream, ClientSideConnection } from '@agentclientprotocol/sdk';
 import { randomUUID } from 'node:crypto';
-import { l as logger } from './logger-BpQcwNnt.mjs';
-import { d as delay } from './time-CfDKj6Bx.mjs';
+import { l as logger } from './logger-CbBv3q_b.mjs';
+import { d as delay } from './time-PG5Dfwdv.mjs';
 import { c as contentLogMetadata, e as errorLogMetadata } from './contentLogMetadata-BlWI0egu.mjs';
-import { p as packageJson } from './package-BqwrPxL0.mjs';
+import { p as packageJson } from './package-DU1DxhH9.mjs';
 
 function acpImageBlocks(attachments, supportsImages) {
   return attachments.filter((file) => ["image/jpeg", "image/png", "image/gif", "image/webp"].includes(file.mimeType)).map((file) => {

package/dist/{BasePermissionHandler-COKc4pmt.cjs → BasePermissionHandler-DHxYAK5L.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var logger = require('./logger-JTcJU-uL.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
 
 class BasePermissionHandler {
   pendingRequests = /* @__PURE__ */ new Map();

package/dist/{BasePermissionHandler-CDCLIrZJ.mjs → BasePermissionHandler-DS0kRTNI.mjs}

@@ -1,4 +1,4 @@
-import { l as logger } from './logger-BpQcwNnt.mjs';
+import { l as logger } from './logger-CbBv3q_b.mjs';
 
 class BasePermissionHandler {
   pendingRequests = /* @__PURE__ */ new Map();

package/dist/{BaseReasoningProcessor-BDVKvooR.mjs → BaseReasoningProcessor-BRtCCt7q.mjs}

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { l as logger } from './logger-BpQcwNnt.mjs';
+import { l as logger } from './logger-CbBv3q_b.mjs';
 
 class BaseReasoningProcessor {
   accumulator = "";

package/dist/{BaseReasoningProcessor-DAGQdkNp.cjs → BaseReasoningProcessor-CsjVdt_H.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var node_crypto = require('node:crypto');
-var logger = require('./logger-JTcJU-uL.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
 
 class BaseReasoningProcessor {
   accumulator = "";

package/dist/{agentHome-2IbIjKCa.mjs → agentHome-Ct-VXFeG.mjs}

@@ -1,13 +1,13 @@
 import chalk from 'chalk';
 import { homedir } from 'node:os';
-import { readSettings, updateSettings } from './persistence-B9LmhAE2.mjs';
+import { r as readSettings, u as updateSettings } from './persistence-ON0zpHfb.mjs';
 import 'node:fs';
-import './logger-BpQcwNnt.mjs';
+import './logger-CbBv3q_b.mjs';
 import { d as describeAgentHome, p as probeLoginShellEnv, r as resolveAgentHomes, e as expandHomePath, A as AGENT_HOME_ENV_NAMES } from './loginShellEnv-Dw8M7tkI.mjs';
 import 'node:fs/promises';
-import './configuration-D2v3puap.mjs';
+import './configuration-WspKd2C2.mjs';
 import 'node:path';
-import './package-BqwrPxL0.mjs';
+import './package-DU1DxhH9.mjs';
 import 'zod';
 import './authRelay-DSAvg1uv.mjs';
 import 'node:crypto';

package/dist/{agentHome-KVWj6nCl.cjs → agentHome-DeAWzhSe.cjs}

@@ -2,14 +2,14 @@
 
 var chalk = require('chalk');
 var os = require('node:os');
-var persistence = require('./persistence-2Xp_o6x6.cjs');
+var persistence = require('./persistence-BYGl0QYw.cjs');
 require('node:fs');
-require('./logger-JTcJU-uL.cjs');
+require('./logger-B_MWPbZz.cjs');
 var loginShellEnv = require('./loginShellEnv-BkuYtExZ.cjs');
 require('node:fs/promises');
-require('./configuration-B0cb3xA3.cjs');
+require('./configuration-C3piBtxY.cjs');
 require('node:path');
-require('./package-C1XvUQFy.cjs');
+require('./package-C9ZP9bpX.cjs');
 require('zod');
 require('./authRelay-BdYkC1Po.cjs');
 require('node:crypto');

package/dist/{api-DnNL5fLw.cjs → api-BZYLRDM9.cjs}

@@ -1,22 +1,22 @@
 'use strict';
 
 var axios = require('axios');
-var logger = require('./logger-JTcJU-uL.cjs');
-var lidState = require('./lidState-D8BmnJV1.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
+var lidState = require('./lidState-Bc2K9H9l.cjs');
 var node_events = require('node:events');
 var socket_ioClient = require('socket.io-client');
-var attachmentLimits = require('./attachmentLimits-BfgKV5iE.cjs');
+var attachmentLimits = require('./attachmentLimits-BEYEEBm8.cjs');
 var authRelay = require('./authRelay-BdYkC1Po.cjs');
 var limits = require('./limits-C-a7gr04.cjs');
-var time = require('./time-T0YmeOhS.cjs');
-var configuration = require('./configuration-B0cb3xA3.cjs');
+var time = require('./time-BXvtjhe9.cjs');
+var configuration = require('./configuration-C3piBtxY.cjs');
 var node_crypto = require('node:crypto');
 var index = require('./index-C9hI8a10.cjs');
-var registerCommonHandlers = require('./registerCommonHandlers-Aha_KfM3.cjs');
+var registerCommonHandlers = require('./registerCommonHandlers-DVYB3iVn.cjs');
 var cuid2 = require('@paralleldrive/cuid2');
-var sync = require('./sync-x_lI_3j_.cjs');
+var sync = require('./sync-Bvc-vh6C.cjs');
 var backgroundTaskActivity = require('./backgroundTaskActivity-CBvUdj39.cjs');
-var controlClient = require('./controlClient-CmnHGcyl.cjs');
+var controlClient = require('./controlClient-BI6Fw3fQ.cjs');
 var contentLogMetadata = require('./contentLogMetadata-ZSFk_NjQ.cjs');
 var chalk = require('chalk');
 
@@ -1590,6 +1590,14 @@ class ApiSessionClient extends node_events.EventEmitter {
     }
   }
   routeIncomingMessage(message, sourceLocalId) {
+    if (this.inboundFrozen) {
+      logger.logger.debug(`[API] Hibernating: holding inbound ${sourceLocalId ?? "(no localId)"}`);
+      this.frozenInbound.push({ message, sourceLocalId });
+      this.inboundRoutedDuringCommit = true;
+      return;
+    }
+    this.inboundRoutedDuringCommit = true;
+    this.noteActivity();
     if (sourceLocalId) this.promptQueueDrain?.onInbound(sourceLocalId);
     const messageWithSource = sourceLocalId && typeof message === "object" && message !== null ? { ...message, localKey: message.localKey ?? sourceLocalId } : message;
     const userResult = attachmentLimits.UserMessageSchema.safeParse(messageWithSource);
@@ -1835,6 +1843,7 @@ class ApiSessionClient extends node_events.EventEmitter {
     }
   }
   enqueueMessage(content, invalidate = true, localId) {
+    this.noteActivity();
     const encrypted = authRelay.encodeBase64(authRelay.encrypt(this.encryptionKey, this.encryptionVariant, content));
     this.pendingOutbox.push({
       content: encrypted,
@@ -2011,6 +2020,52 @@ class ApiSessionClient extends node_events.EventEmitter {
     };
     this.enqueueMessage(content);
   }
+  // ── B-587 hibernation support ──────────────────────────────────────────
+  /** Last user/agent activity this wrapper saw (spec §2.1). */
+  lastActivity = Date.now();
+  inboundFrozen = false;
+  frozenInbound = [];
+  heartbeatsMuted = false;
+  lastHeartbeat = 0;
+  get lastHeartbeatAt() {
+    return this.lastHeartbeat;
+  }
+  muteHeartbeats() {
+    this.heartbeatsMuted = true;
+  }
+  unmuteHeartbeats() {
+    this.heartbeatsMuted = false;
+  }
+  inboundRoutedDuringCommit = false;
+  noteActivity(now = Date.now()) {
+    if (now > this.lastActivity) this.lastActivity = now;
+  }
+  get lastActivityAt() {
+    return this.lastActivity;
+  }
+  /** The message cursor (highest seq this wrapper has seen). */
+  get messageCursor() {
+    return this.lastSeq;
+  }
+  /** Start watching for inbound routed during the hibernation commit window. */
+  beginHibernationCommit() {
+    this.inboundRoutedDuringCommit = false;
+  }
+  /** Was any inbound message routed since beginHibernationCommit()? */
+  inboundRoutedSinceCommit() {
+    return this.inboundRoutedDuringCommit;
+  }
+  /** Stop routing inbound messages; the next wrapper replays them (spec §3/§4). */
+  freezeInbound() {
+    this.inboundFrozen = true;
+  }
+  /** An aborted hibernation: route whatever arrived while frozen, in order. */
+  unfreezeInbound() {
+    this.inboundFrozen = false;
+    const held = this.frozenInbound;
+    this.frozenInbound = [];
+    for (const item of held) this.routeIncomingMessage(item.message, item.sourceLocalId);
+  }
   /**
    * Send a ping message to keep the connection alive
    */
@@ -2029,11 +2084,14 @@ class ApiSessionClient extends node_events.EventEmitter {
     }));
   });
   keepAlive(thinking, mode, backgroundTasks) {
+    if (this.heartbeatsMuted) return;
+    this.lastHeartbeat = Date.now();
     if (process.env.DEBUG) {
       logger.logger.debug(`[API] Sending keep alive message: ${thinking}`);
     }
     this.turnReporter.observe(thinking);
     if (backgroundTasks) this.backgroundTaskReporter.observe(backgroundTasks);
+    if (thinking || (backgroundTasks?.length ?? 0) > 0) this.noteActivity();
     this.socket.volatile.emit("session-alive", {
       sid: this.sessionId,
       time: Date.now(),
@@ -2226,7 +2284,26 @@ class ApiSessionClient extends node_events.EventEmitter {
     });
   }
   updateMetadata(handler) {
-    this.metadataLock.inLock(async () => {
+    void this.writeMetadata(handler);
+  }
+  /**
+   * B-587: the same write, awaitable with a ceiling — the hibernation stamp
+   * must land before `session-end`. Resolves false on timeout (the write
+   * itself keeps retrying in the background, exactly like updateMetadata).
+   */
+  async updateMetadataAndWait(handler, timeoutMs = 1e4) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+      timer = setTimeout(() => resolve(false), timeoutMs);
+    });
+    try {
+      return await Promise.race([this.writeMetadata(handler).then(() => true), timeout]);
+    } finally {
+      if (timer) clearTimeout(timer);
+    }
+  }
+  writeMetadata(handler) {
+    return this.metadataLock.inLock(async () => {
       let rateRefusals = 0;
       await time.backoff(async () => {
         let updated = handler(this.metadata);
@@ -2272,6 +2349,7 @@ class ApiSessionClient extends node_events.EventEmitter {
           this.agentState = answer.agentState ? authRelay.decrypt(this.encryptionKey, this.encryptionVariant, authRelay.decodeBase64(answer.agentState)) : null;
           this.agentStateVersion = answer.version;
           rateRefusals = 0;
+          if (Object.keys(this.agentState?.requests ?? {}).length > 0) this.noteActivity();
           logger.logger.debug("Agent state updated", this.agentState);
         } else if (answer.result === "version-mismatch") {
           if (answer.version > this.agentStateVersion) {
@@ -3088,7 +3166,7 @@ class ApiClient {
     return new ApiSessionClient(this.credential.token, session, opts);
   }
   async machineSyncClient(machine) {
-    const { ApiMachineClient } = await Promise.resolve().then(function () { return require('./apiMachine-DeoQ8QbZ.cjs'); });
+    const { ApiMachineClient } = await Promise.resolve().then(function () { return require('./apiMachine-BgMxGPsR.cjs'); });
     return new ApiMachineClient(this.credential.token, machine);
   }
   push() {

package/dist/{api-Cmz3XS4P.mjs → api-CReZazeT.mjs}

@@ -1,20 +1,20 @@
 import axios from 'axios';
-import { l as logger, r as redactLogValue } from './logger-BpQcwNnt.mjs';
-import { R as RpcHandlerManager, a as answerSocketRequest, c as connectGuarded, s as socketConnectGuard, d as describeSocketAckDrop, b as safeAck, i as isRateQuotaCode, p as pauseForRateQuota, e as shouldReconnect } from './lidState-BfximpjX.mjs';
+import { l as logger, r as redactLogValue } from './logger-CbBv3q_b.mjs';
+import { R as RpcHandlerManager, a as answerSocketRequest, c as connectGuarded, s as socketConnectGuard, d as describeSocketAckDrop, b as safeAck, i as isRateQuotaCode, p as pauseForRateQuota, e as shouldReconnect } from './lidState-B2ZxdREe.mjs';
 import { EventEmitter } from 'node:events';
 import { io } from 'socket.io-client';
-import { A as AsyncLock, a as MAX_CHAT_ATTACHMENT_ENCRYPTED_BYTES, U as UserMessageSchema, F as FileEventMessageSchema } from './attachmentLimits-C1PCCM79.mjs';
+import { A as AsyncLock, a as MAX_CHAT_ATTACHMENT_ENCRYPTED_BYTES, U as UserMessageSchema, F as FileEventMessageSchema } from './attachmentLimits-CxG3T18E.mjs';
 import { h as decrypt, d as decodeBase64, i as decryptBlob, e as encodeBase64, g as encrypt, l as libsodiumEncryptForPublicKey, j as libsodiumPublicKeyFromSecretKey, k as getRandomBytes } from './authRelay-DSAvg1uv.mjs';
 import { p as prepareClipboardText, d as prepareClipboardHistoryText } from './limits-DIo7rEBR.mjs';
-import { b as backoff, d as delay, e as exponentialBackoffDelay } from './time-CfDKj6Bx.mjs';
-import { c as configuration } from './configuration-D2v3puap.mjs';
+import { b as backoff, d as delay, e as exponentialBackoffDelay } from './time-PG5Dfwdv.mjs';
+import { c as configuration } from './configuration-WspKd2C2.mjs';
 import { createHmac, randomUUID } from 'node:crypto';
 import { c as createEnvelope, s as streamKeyOf, R as ReleaseDrainNoticeSchema, q as RelayAssignmentResponseSchema } from './index-B0HEEYGh.mjs';
-import { r as registerCommonHandlers } from './registerCommonHandlers-DdfGsFbM.mjs';
+import { r as registerCommonHandlers } from './registerCommonHandlers-B0PVff2U.mjs';
 import { createId } from '@paralleldrive/cuid2';
-import { I as InvalidateSync } from './sync-BLpH13Kb.mjs';
+import { I as InvalidateSync } from './sync-CCwYpJMS.mjs';
 import { B as BackgroundTaskReporter } from './backgroundTaskActivity-8PdPxrvy.mjs';
-import { j as notifyDaemonTurnEvent, k as notifyDaemonBackgroundTasks } from './controlClient-BMUJfUeF.mjs';
+import { k as notifyDaemonTurnEvent, m as notifyDaemonBackgroundTasks } from './controlClient-DTheOlvC.mjs';
 import { c as contentLogMetadata } from './contentLogMetadata-BlWI0egu.mjs';
 import chalk from 'chalk';
 
@@ -1588,6 +1588,14 @@ class ApiSessionClient extends EventEmitter {
     }
   }
   routeIncomingMessage(message, sourceLocalId) {
+    if (this.inboundFrozen) {
+      logger.debug(`[API] Hibernating: holding inbound ${sourceLocalId ?? "(no localId)"}`);
+      this.frozenInbound.push({ message, sourceLocalId });
+      this.inboundRoutedDuringCommit = true;
+      return;
+    }
+    this.inboundRoutedDuringCommit = true;
+    this.noteActivity();
     if (sourceLocalId) this.promptQueueDrain?.onInbound(sourceLocalId);
     const messageWithSource = sourceLocalId && typeof message === "object" && message !== null ? { ...message, localKey: message.localKey ?? sourceLocalId } : message;
     const userResult = UserMessageSchema.safeParse(messageWithSource);
@@ -1833,6 +1841,7 @@ class ApiSessionClient extends EventEmitter {
     }
   }
   enqueueMessage(content, invalidate = true, localId) {
+    this.noteActivity();
     const encrypted = encodeBase64(encrypt(this.encryptionKey, this.encryptionVariant, content));
     this.pendingOutbox.push({
       content: encrypted,
@@ -2009,6 +2018,52 @@ class ApiSessionClient extends EventEmitter {
     };
     this.enqueueMessage(content);
   }
+  // ── B-587 hibernation support ──────────────────────────────────────────
+  /** Last user/agent activity this wrapper saw (spec §2.1). */
+  lastActivity = Date.now();
+  inboundFrozen = false;
+  frozenInbound = [];
+  heartbeatsMuted = false;
+  lastHeartbeat = 0;
+  get lastHeartbeatAt() {
+    return this.lastHeartbeat;
+  }
+  muteHeartbeats() {
+    this.heartbeatsMuted = true;
+  }
+  unmuteHeartbeats() {
+    this.heartbeatsMuted = false;
+  }
+  inboundRoutedDuringCommit = false;
+  noteActivity(now = Date.now()) {
+    if (now > this.lastActivity) this.lastActivity = now;
+  }
+  get lastActivityAt() {
+    return this.lastActivity;
+  }
+  /** The message cursor (highest seq this wrapper has seen). */
+  get messageCursor() {
+    return this.lastSeq;
+  }
+  /** Start watching for inbound routed during the hibernation commit window. */
+  beginHibernationCommit() {
+    this.inboundRoutedDuringCommit = false;
+  }
+  /** Was any inbound message routed since beginHibernationCommit()? */
+  inboundRoutedSinceCommit() {
+    return this.inboundRoutedDuringCommit;
+  }
+  /** Stop routing inbound messages; the next wrapper replays them (spec §3/§4). */
+  freezeInbound() {
+    this.inboundFrozen = true;
+  }
+  /** An aborted hibernation: route whatever arrived while frozen, in order. */
+  unfreezeInbound() {
+    this.inboundFrozen = false;
+    const held = this.frozenInbound;
+    this.frozenInbound = [];
+    for (const item of held) this.routeIncomingMessage(item.message, item.sourceLocalId);
+  }
   /**
    * Send a ping message to keep the connection alive
    */
@@ -2027,11 +2082,14 @@ class ApiSessionClient extends EventEmitter {
     }));
   });
   keepAlive(thinking, mode, backgroundTasks) {
+    if (this.heartbeatsMuted) return;
+    this.lastHeartbeat = Date.now();
     if (process.env.DEBUG) {
       logger.debug(`[API] Sending keep alive message: ${thinking}`);
     }
     this.turnReporter.observe(thinking);
     if (backgroundTasks) this.backgroundTaskReporter.observe(backgroundTasks);
+    if (thinking || (backgroundTasks?.length ?? 0) > 0) this.noteActivity();
     this.socket.volatile.emit("session-alive", {
       sid: this.sessionId,
       time: Date.now(),
@@ -2224,7 +2282,26 @@ class ApiSessionClient extends EventEmitter {
     });
   }
   updateMetadata(handler) {
-    this.metadataLock.inLock(async () => {
+    void this.writeMetadata(handler);
+  }
+  /**
+   * B-587: the same write, awaitable with a ceiling — the hibernation stamp
+   * must land before `session-end`. Resolves false on timeout (the write
+   * itself keeps retrying in the background, exactly like updateMetadata).
+   */
+  async updateMetadataAndWait(handler, timeoutMs = 1e4) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+      timer = setTimeout(() => resolve(false), timeoutMs);
+    });
+    try {
+      return await Promise.race([this.writeMetadata(handler).then(() => true), timeout]);
+    } finally {
+      if (timer) clearTimeout(timer);
+    }
+  }
+  writeMetadata(handler) {
+    return this.metadataLock.inLock(async () => {
       let rateRefusals = 0;
       await backoff(async () => {
         let updated = handler(this.metadata);
@@ -2270,6 +2347,7 @@ class ApiSessionClient extends EventEmitter {
           this.agentState = answer.agentState ? decrypt(this.encryptionKey, this.encryptionVariant, decodeBase64(answer.agentState)) : null;
           this.agentStateVersion = answer.version;
           rateRefusals = 0;
+          if (Object.keys(this.agentState?.requests ?? {}).length > 0) this.noteActivity();
           logger.debug("Agent state updated", this.agentState);
         } else if (answer.result === "version-mismatch") {
           if (answer.version > this.agentStateVersion) {
@@ -3086,7 +3164,7 @@ class ApiClient {
     return new ApiSessionClient(this.credential.token, session, opts);
   }
   async machineSyncClient(machine) {
-    const { ApiMachineClient } = await import('./apiMachine-B6ySCFe0.mjs');
+    const { ApiMachineClient } = await import('./apiMachine-CWndf1Vn.mjs');
     return new ApiMachineClient(this.credential.token, machine);
   }
   push() {

package/dist/{apiMachine-DeoQ8QbZ.cjs → apiMachine-BgMxGPsR.cjs}

@@ -1,43 +1,43 @@
 'use strict';
 
 var socket_ioClient = require('socket.io-client');
-var logger = require('./logger-JTcJU-uL.cjs');
-var lidState = require('./lidState-D8BmnJV1.cjs');
-var mirrorProtocol = require('./mirrorProtocol-BEGk2--0.cjs');
-var configuration = require('./configuration-B0cb3xA3.cjs');
+var logger = require('./logger-B_MWPbZz.cjs');
+var lidState = require('./lidState-Bc2K9H9l.cjs');
+var mirrorProtocol = require('./mirrorProtocol-BdcN6QlN.cjs');
+var configuration = require('./configuration-C3piBtxY.cjs');
 var cliUpdate = require('./cliUpdate-DsKXPFYp.cjs');
-var registerCommonHandlers = require('./registerCommonHandlers-Aha_KfM3.cjs');
+var registerCommonHandlers = require('./registerCommonHandlers-DVYB3iVn.cjs');
 var promises = require('node:fs/promises');
 var path = require('node:path');
 var os = require('node:os');
 var node_child_process = require('node:child_process');
-var persistence = require('./persistence-2Xp_o6x6.cjs');
+var persistence = require('./persistence-BYGl0QYw.cjs');
 var authRelay = require('./authRelay-BdYkC1Po.cjs');
 var limits = require('./limits-C-a7gr04.cjs');
-var time = require('./time-T0YmeOhS.cjs');
+var time = require('./time-BXvtjhe9.cjs');
 var pty = require('node-pty');
 var terminals = require('./terminals-B_bfC9c2.cjs');
 var tmuxSocket = require('./tmuxSocket-D-Xt6Vn-.cjs');
-var index = require('./index-DEKIgZUo.cjs');
+var index = require('./index-PNMQPKhz.cjs');
 var node_crypto = require('node:crypto');
 var node_fs = require('node:fs');
 var axios = require('axios');
 var projectPath = require('./projectPath-ChLhdOyt.cjs');
 var ids = require('./ids-B6ZC0HGt.cjs');
 var detectCLI = require('./detectCLI-DR9ZaN6B.cjs');
-var localHappyAgentAuth = require('./localHappyAgentAuth-d7B6S_o7.cjs');
+var localHappyAgentAuth = require('./localHappyAgentAuth-T5GOvRha.cjs');
 var path$1 = require('./path-B7zW-WwE.cjs');
 var oneShotPrompts = require('./oneShotPrompts-CL0dip9C.cjs');
-var claudeSessionFork = require('./claudeSessionFork-Cs0I3eGI.cjs');
-var codexAppServerClient = require('./codexAppServerClient-BTjn2ZCZ.cjs');
+var claudeSessionFork = require('./claudeSessionFork-Byd8zD1U.cjs');
+var codexAppServerClient = require('./codexAppServerClient-TiW9OBk4.cjs');
 var index$1 = require('./index-C9hI8a10.cjs');
 var codexThreadFork = require('./codexThreadFork-DNekT4nQ.cjs');
-var rateLimitWindows = require('./rateLimitWindows-C2Jk3Ih7.cjs');
+var rateLimitWindows = require('./rateLimitWindows-CusGIqlq.cjs');
 require('chalk');
 require('node:util');
 require('os');
 require('child_process');
-require('./package-C1XvUQFy.cjs');
+require('./package-C9ZP9bpX.cjs');
 require('util');
 require('fs/promises');
 require('crypto');
@@ -51,7 +51,7 @@ require('url');
 require('fs');
 require('node:readline');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
-require('./manager-Cly8xVIR.cjs');
+require('./manager-HrEj442o.cjs');
 require('@anthropic-ai/sandbox-runtime');
 require('@paralleldrive/cuid2');
 
@@ -10462,6 +10462,9 @@ class ApiMachineClient {
     registerCommonHandlers.registerCommonHandlers(this.rpcHandlerManager, process.cwd());
     registerFsHandlers(this.rpcHandlerManager);
     registerTodoHandlers(this.rpcHandlerManager);
+    if (typeof configuration.configuration.happyHomeDir === "string") {
+      mirrorProtocol.registerWorktreeHandlers(this.rpcHandlerManager, mirrorProtocol.configureWorktreeService({ home: configuration.configuration.happyHomeDir, machineId: this.machine.id, log: (msg, err) => logger.logger.debug(msg, err) }));
+    }
     this.wireAutoRestoreReport();
   }
   socket;
@@ -10483,6 +10486,8 @@ class ApiMachineClient {
   cliUpdateState = null;
   cliUpdatePushChain = Promise.resolve();
   claudeAuthState = null;
+  /** B-587: the machine's hibernation threshold, published as a capability. */
+  agentHibernationIdleMs = null;
   rateLimitPushChain = Promise.resolve();
   rateLimitPublisher = new RateLimitPublisher({
     getCurrent: () => this.machine.daemonState?.rateLimits,
@@ -10647,6 +10652,34 @@ class ApiMachineClient {
     this.cliUpdatePushChain = attempt.then(() => void 0);
     return attempt;
   }
+  /**
+   * B-587: `agent-hibernation-set {idleMs}` (0 = off) and the
+   * `daemonState.agentHibernation` capability. Call before connect().
+   */
+  setAgentHibernationHandlers(initialIdleMs, set) {
+    this.agentHibernationIdleMs = initialIdleMs;
+    this.rpcHandlerManager.registerHandler("agent-hibernation-set", async (params) => {
+      const raw = params?.idleMs;
+      if (typeof raw !== "number" || !Number.isFinite(raw) || raw < 0) return { error: "invalid-idle-ms" };
+      const idleMs = await set(raw);
+      this.agentHibernationIdleMs = idleMs;
+      await this.publishAgentHibernation();
+      return { agentHibernation: { idleMs } };
+    });
+  }
+  publishAgentHibernation() {
+    const idleMs = this.agentHibernationIdleMs;
+    if (idleMs === null || !this.socket?.connected) return Promise.resolve();
+    const attempt = this.cliUpdatePushChain.then(() => this.updateDaemonState((current) => ({
+      ...current ?? {},
+      status: current?.status ?? "running",
+      agentHibernation: { idleMs, rpcAvailable: true, detectedAt: Date.now() }
+    }))).catch((error) => {
+      logger.logger.debug("[API MACHINE] Failed to publish agent hibernation:", error);
+    });
+    this.cliUpdatePushChain = attempt.then(() => void 0);
+    return attempt;
+  }
   /** B-276 machine RPCs. Responses always carry `claudeAuth` so the web can refresh in place. */
   setClaudeAuthHandlers(handlers) {
     this.rpcHandlerManager.registerHandler("claude-auth-probe", async () => {
@@ -11366,7 +11399,9 @@ class ApiMachineClient {
         closedTerminals: this.webTerminal.getClosedTerminals(),
         // B-276: re-ship the last preflight so a reconnect never
         // leaves a stale-pid value visible longer than needed.
-        ...this.claudeAuthState ? { claudeAuth: this.claudeAuthState } : {}
+        ...this.claudeAuthState ? { claudeAuth: this.claudeAuthState } : {},
+        // B-587 capability + setting (same restamp discipline).
+        ...this.agentHibernationIdleMs !== null ? { agentHibernation: { idleMs: this.agentHibernationIdleMs, rpcAvailable: true, detectedAt: now } } : {}
       };
     });
     this.webTerminal.startListTracking((terminals) => this.pushTerminalList(terminals));