very-happy-cli 0.2.189 → 0.2.190

package/dist/{index-CnzsOD19.cjs → index-f8oDidjV.cjs}

@@ -1,95 +1,96 @@
 'use strict';
 
-var AcpBackend = require('./AcpBackend-DRPJ2g9G.cjs');
-var logger = require('./logger-BP1SW7Cs.cjs');
-var AcpSessionManager = require('./AcpSessionManager-DM-KKg6v.cjs');
+var AcpBackend = require('./AcpBackend-dkRv9QHm.cjs');
+var logger = require('./logger-BBRTTVsQ.cjs');
+var AcpSessionManager = require('./AcpSessionManager-AqWAqahm.cjs');
 var index = require('./index-BOe6dKnL.cjs');
-var deterministicJson = require('./deterministicJson-D0LU_XbO.cjs');
+var deterministicJson = require('./deterministicJson-BEygolBQ.cjs');
 var specialCommands = require('./specialCommands-J3JFOq0J.cjs');
-var agentAttachments = require('./agentAttachments-Dbw8iMCZ.cjs');
-var configuration = require('./configuration-C0ctLGW2.cjs');
-var attachmentContent = require('./attachmentContent-Cc5b7TPr.cjs');
-var piRuntime = require('./piRuntime-DEbPE_kW.cjs');
+var heldInput = require('./heldInput-BOtqFO2r.cjs');
+var configuration = require('./configuration-Dt5lKW3P.cjs');
+var attachmentContent = require('./attachmentContent-NmVfKp-B.cjs');
+var piRuntime = require('./piRuntime-Bd9-eq6M.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
-var api = require('./api-BDuuyys8.cjs');
-var client = require('./client-DIfxYk7B.cjs');
-var registerKillSessionHandler = require('./registerKillSessionHandler-DhCjrs44.cjs');
-var persistence = require('./persistence-CrzC7yr_.cjs');
-var machineMetadata = require('./machineMetadata-BKX3ov9g.cjs');
-var createSessionMetadata = require('./createSessionMetadata-DezS33OM.cjs');
-var setupOfflineReconnection = require('./setupOfflineReconnection-tV0Q1dgR.cjs');
-var startupSessionCreate = require('./startupSessionCreate-CYc8mra-.cjs');
-var controlClient = require('./controlClient-F7hAEEy2.cjs');
+var api = require('./api-CXL6jp-p.cjs');
+var client = require('./client-CMKGrnmT.cjs');
+var registerKillSessionHandler = require('./registerKillSessionHandler-CA1FFr_F.cjs');
+var persistence = require('./persistence-Bl5S3TLB.cjs');
+var machineMetadata = require('./machineMetadata-DnFNlrVK.cjs');
+var createSessionMetadata = require('./createSessionMetadata-B_HZCDj_.cjs');
+var setupOfflineReconnection = require('./setupOfflineReconnection-DPXRo_zf.cjs');
+var startupSessionCreate = require('./startupSessionCreate-Dxy3X4DG.cjs');
+var controlClient = require('./controlClient-BRk65BRO.cjs');
 var authRelay = require('./authRelay-Dy1qU9td.cjs');
-var sessionLock = require('./sessionLock-DSqiP2lH.cjs');
-var acpSessionResume = require('./acpSessionResume-2BTMsB7_.cjs');
+var sessionLock = require('./sessionLock-BFBReiKq.cjs');
+var acpSessionResume = require('./acpSessionResume-CZao6QEd.cjs');
 var streamRelay = require('./streamRelay-D9a4cBEa.cjs');
 var projectPath = require('./projectPath-C3ioB4Bu.cjs');
-var BasePermissionHandler = require('./BasePermissionHandler-DjM16uJz.cjs');
-var titleGenerator = require('./titleGenerator-DVX0NZUn.cjs');
+var BasePermissionHandler = require('./BasePermissionHandler-CpSugp7Z.cjs');
+var titleGenerator = require('./titleGenerator-lT5ldPuN.cjs');
 var editPaths = require('./editPaths-Bqp4OFPw.cjs');
 var node_fs = require('node:fs');
 var os = require('node:os');
 require('node:child_process');
 require('@agentclientprotocol/sdk');
-require('./time-XwEZxKGc.cjs');
+require('./time-gPD_EmA-.cjs');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
 require('./processTree-CMHWlVse.cjs');
-require('./package-CYDdLA6R.cjs');
+require('./package-DrY090nZ.cjs');
 require('chalk');
 require('node:util');
 require('@paralleldrive/cuid2');
 require('zod');
 require('./prompt-Bof2aQkI.cjs');
-require('./reportProgressTool-DznxPKES.cjs');
-require('./client-D0aYWt53.cjs');
+require('./reportProgressTool-CvPGov1F.cjs');
+require('./client-Bffkrs5p.cjs');
 require('./precheckCompat-CWOi5c9L.cjs');
 require('./agentGuidance-BtBx2xxE.cjs');
 require('./trimIdent-4gvk9Wk6.cjs');
 require('./pi-DlsrPCTa.cjs');
 require('./fileStore-7qhnbs6N.cjs');
 require('node:fs/promises');
-require('./client-BNmFaRXZ.cjs');
-require('./context-D-hEk5pC.cjs');
-require('./sessionOps-BzeOKIEF.cjs');
+require('./client-CARZ_lNS.cjs');
+require('./context-BdZssgF0.cjs');
+require('./sessionOps-DeWVqpe4.cjs');
 require('axios');
 require('socket.io-client');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
 require('./resources-BZ_Be0qM.cjs');
-require('./tools-CjMafO_D.cjs');
-require('./peerTools-B4315xjX.cjs');
+require('./tools-DvqbLsCF.cjs');
+require('./peerTools-5ZM4spcZ.cjs');
 require('./ids-B6ZC0HGt.cjs');
-require('./remoteSessionClient-Dq8XTLQP.cjs');
+require('./remoteSessionClient-DGFI__5Z.cjs');
 require('@modelcontextprotocol/sdk/server/mcp.js');
 require('node:http');
 require('@modelcontextprotocol/sdk/server/streamableHttp.js');
 require('./limits-C-a7gr04.cjs');
-require('./downloadTarget-aNcCxVRL.cjs');
+require('./downloadTarget-DS0zT2AU.cjs');
 require('./terminals-B_bfC9c2.cjs');
 require('./terminalTitleSuggest-DhvRFX3H.cjs');
 require('./tmuxSocket-D-Xt6Vn-.cjs');
-require('./bootstrap-CDY-Vz8q.cjs');
+require('./bootstrap-DBJB0y-H.cjs');
 require('./webPanels-FCgFKvVe.cjs');
-require('./pushNotifications-CalIS9sq.cjs');
+require('./pushNotifications-CfspRcl-.cjs');
 require('./previewPath-B0rBdhy1.cjs');
 require('crypto');
-require('./lidState-B4dHJCeS.cjs');
+require('./lidState-q_XFYg33.cjs');
 require('os');
 require('child_process');
 require('node:events');
-require('./registerCommonHandlers-DZPozYxc.cjs');
+require('./registerCommonHandlers-Beun-cQv.cjs');
 require('util');
 require('fs/promises');
 require('path');
 require('cross-spawn');
-require('./sync-CoChLEIg.cjs');
+require('./sync-DtWB7RzA.cjs');
 require('tweetnacl');
 require('./types-CRS-srZK.cjs');
 require('./detectCLI-BuYR_Qxe.cjs');
 require('fs');
-require('./localHappyAgentAuth-CG2nPD_H.cjs');
+require('./localHappyAgentAuth-CKNW-MXw.cjs');
 require('./fsMkdir-0K3yENml.cjs');
+require('./cliUpdate-DsKXPFYp.cjs');
 require('./processTreeSnapshot-mDbnuojn.cjs');
 require('url');
 require('node:module');
@@ -162,6 +163,10 @@ function describeAcpTurnFailure(agentName, error) {
   return { message: `${agentName} error: ${detail}`, error: detail, exited: false };
 }
 
+function acpExitIntent(exit) {
+  return exit?.intent ?? "offline";
+}
+
 const OUT_OF_TURN_QUIET_MS = 6e4;
 function isAcpTurnContent(msg) {
   if (msg.type === "model-output") return typeof msg.textDelta === "string" && msg.textDelta.length > 0;
@@ -827,7 +832,9 @@ async function runAcp(opts) {
     machineId: settings.machineId,
     startedBy: opts.startedBy,
     sandbox: settings.sandboxConfig,
-    capabilities: [index.PROMPT_QUEUE_CAPABILITY, index.PROJECT_SESSION_CAPABILITY]
+    // B-852: a daemon-spawned pi session reports when it is quiescent, so the
+    // daemon can restart it onto new code after an upgrade.
+    capabilities: [index.PROMPT_QUEUE_CAPABILITY, index.PROJECT_SESSION_CAPABILITY, ...opts.agentName === "pi" && opts.startedBy === "daemon" ? [sessionLock.AUTO_RESTART_CAPABILITY] : []]
   });
   metadata.attachmentKinds = [];
   if (opts.agentName === "gemini") metadata.configuredModel = readGeminiConfiguredModel();
@@ -920,6 +927,11 @@ async function runAcp(opts) {
     messageQueue.setOnWait(() => drain.onIdle());
   }
   attachPromptQueueDrain(session);
+  messageQueue.setOnDiscard((entries) => {
+    const keys = entries.map((entry) => entry.sourceId).filter((key) => typeof key === "string");
+    if (keys.length > 0) session.sendQueueCancelReason(keys, entries[0].reason);
+  });
+  const heldInput$1 = new heldInput.HeldInput((keys, reason) => session.sendQueueCancelReason(keys, reason));
   let currentPermissionMode;
   let currentModel;
   let modeSelector = null;
@@ -1014,7 +1026,16 @@ async function runAcp(opts) {
     session.keepAlive(thinking, "remote");
   };
   let acpSessionId = null;
+  let piProbe = null;
   let shouldExit = false;
+  let exit = null;
+  const beginExit = (intent, reason) => {
+    if (!exit) exit = { intent, reason };
+    shouldExit = true;
+    heldInput$1.drop(exit.reason);
+    messageQueue.discardAll(exit.reason);
+    messageQueue.close();
+  };
   let abortController = new AbortController();
   let turnCancelled = false;
   let backendStarted = false;
@@ -1024,8 +1045,8 @@ async function runAcp(opts) {
   const stopRunnerFromBackendStatus = (status, detail) => {
     const reason = detail ? `${opts.agentName} backend ${status}: ${detail}` : `${opts.agentName} backend ${status}`;
     logger.logger.debug(`[${opts.agentName}] ${reason}; stopping ACP runner`);
-    shouldExit = true;
-    messageQueue.close();
+    session.sendSessionEvent({ type: "message", message: reason });
+    beginExit("offline", "failed");
   };
   const sendEnvelopes = (envelopes) => {
     for (const envelope of envelopes) {
@@ -1334,7 +1355,7 @@ async function runAcp(opts) {
   };
   backend.onMessage(onBackendMessage);
   const titleGenerator$1 = new titleGenerator.TitleGenerator(session);
-  agentAttachments.registerAgentAttachmentDownloads(session);
+  heldInput.registerAgentAttachmentDownloads(session);
   let userMessageDelivery = Promise.resolve();
   session.onUserMessage((message) => {
     const downloads = session.drainAttachmentsForUserMessage();
@@ -1383,6 +1404,7 @@ async function runAcp(opts) {
     }).catch(() => {
       logger.logger.warn("[ACP] Failed to prepare user attachments");
       session.sendSessionEvent({ type: "message", message: "Could not prepare this message. Please send it again." });
+      if (message.localKey) session.sendQueueCancelReason([message.localKey], exit?.reason ?? "failed");
     });
   });
   session.keepAlive(thinking, "remote");
@@ -1422,10 +1444,15 @@ async function runAcp(opts) {
     }
   );
   const disposeTermination = registerKillSessionHandler.registerKillSessionHandler(session.rpcHandlerManager, async () => {
-    shouldExit = true;
-    messageQueue.close();
+    beginExit("archive", "aborted");
     await handleAbort();
-  }, session, { processSignals: true });
+  }, session, {
+    processSignals: true,
+    onSignal: async () => {
+      beginExit("offline", "restarted");
+      await handleAbort();
+    }
+  });
   const afterSessionStarted = async (requestedModel) => {
     if (requestedModel) {
       await switchModelIfRequested(requestedModel);
@@ -1479,6 +1506,36 @@ async function runAcp(opts) {
       logger.logger.debug(`[${opts.agentName}] Resume of agent session ${resumeId}: ${started.resumed ?? "new"}${started.loadFailure ? ` (${started.loadFailure})` : ""}`);
       if (started.resumed !== "loaded") session.sendSessionEvent({ type: "message", message: acpSessionResume.piRestartNotice(opts.agentName, "resume", started) });
     }
+    if (opts.agentName === "pi" && opts.startedBy === "daemon") {
+      const piSnapshot = () => {
+        const meta = session.getMetadata();
+        return {
+          flavor: "acp",
+          resumable: typeof meta?.piSessionId === "string" && meta.piSessionId.length > 0,
+          uiSession: true,
+          ...isAssistantVariant ? { variant: "assistant" } : {},
+          ...process.env.HAPPY_SPAWNED_BY ? { spawnedBy: process.env.HAPPY_SPAWNED_BY } : {},
+          ...meta?.tags ? { tags: meta.tags } : {},
+          keepAwake: false,
+          thinking,
+          queuedInputs: messageQueue.size() + (session.promptQueueHasPending() ? 1 : 0),
+          waitingForInput: messageQueue.isWaiting(),
+          pendingRequests: Object.keys(session.getAgentState()?.requests ?? {}).length,
+          backgroundTasks: 0,
+          lastActivityAt: session.lastActivityAt,
+          ...shouldExit ? { exiting: true } : {}
+        };
+      };
+      piProbe = new startupSessionCreate.HibernationProbe({
+        checkMs: persistence.resolveCheckMs(),
+        snapshot: piSnapshot,
+        ask: (report) => controlClient.checkDaemonHibernation({ sessionId: session.sessionId, pid: process.pid, report }),
+        commit: async () => false
+      });
+      piProbe.start();
+    }
+    const autoUpdated = sessionLock.takeAutoRestartedEvent(process.env);
+    if (autoUpdated) session.sendSessionEvent(autoUpdated);
     if (verbose) {
       if (!sawSlashCommands) {
         logAcp("muted", `Outgoing slash commands from ${opts.agentName}: not reported yet`);
@@ -1502,6 +1559,7 @@ async function runAcp(opts) {
         }
         break;
       }
+      heldInput$1.hold(batch.sourceIds);
       logAcp("incoming", `Incoming prompt: ${formatUnknownForConsole(batch.message, ACP_EVENT_PREVIEW_CHARS)}`);
       endOutOfTurn("prompt");
       sendEnvelopes(sessionManager.startTurn());
@@ -1531,6 +1589,13 @@ async function runAcp(opts) {
           happyHomeDir: configuration.configuration.happyHomeDir,
           sessionId: session.sessionId
         }) : [];
+        if (shouldExit) {
+          sendEnvelopes(sessionManager.endTurn("cancelled"));
+          streamRelay$1.endTurn();
+          setThinking(false);
+          break;
+        }
+        heldInput$1.delivered();
         promptInFlight = true;
         let outcome;
         try {
@@ -1557,6 +1622,7 @@ async function runAcp(opts) {
       } catch (error) {
         const failure = describeAcpTurnFailure(opts.agentName, error);
         session.sendSessionEvent({ type: "message", message: failure.message });
+        heldInput$1.drop("failed");
         sendEnvelopes(sessionManager.endTurn("failed", failure.error));
         streamRelay$1.endTurn();
         setThinking(false);
@@ -1569,6 +1635,7 @@ async function runAcp(opts) {
     }
   } finally {
     disposeTermination?.();
+    piProbe?.stop();
     setThinking(false);
     clearInterval(keepAliveInterval);
     streamRelay$1.endTurn();
@@ -1595,15 +1662,27 @@ async function runAcp(opts) {
     }
     try {
       session.closePromptQueueDrain();
-      session.updateMetadata((currentMetadata) => ({
-        ...currentMetadata,
-        lifecycleState: "archived",
-        lifecycleStateSince: Date.now(),
-        archivedBy: "cli",
-        archiveReason: "Session ended"
-      }));
+      heldInput$1.drop(exit?.reason ?? "failed");
+      messageQueue.discardAll(exit?.reason ?? "failed");
+      const intent = acpExitIntent(exit);
+      if (intent === "archive") {
+        session.updateMetadata((currentMetadata) => ({
+          ...currentMetadata,
+          lifecycleState: "archived",
+          lifecycleStateSince: Date.now(),
+          archivedBy: "cli",
+          archiveReason: "Session ended"
+        }));
+      }
       session.sendSessionDeath();
       await session.flush();
+      if (intent === "offline") {
+        try {
+          await api$1.deactivateSession(session.sessionId);
+        } catch (error) {
+          logger.logger.debug(`[${opts.agentName}] deactivate on exit failed:`, error);
+        }
+      }
       await session.close();
     } catch (error) {
       logger.logger.debug(`[${opts.agentName}] Session close failed:`, error);

package/dist/{index-CKd20r1W.mjs → index-rNTX33in.mjs}

@@ -1,4 +1,4 @@
-import { p as packageJson } from './package-DTcaIhjW.mjs';
+import { p as packageJson } from './package-C6uiXULx.mjs';
 import module$1 from 'node:module';
 import { existsSync } from 'node:fs';
 import { readdir, rm } from 'node:fs/promises';
@@ -57,10 +57,10 @@ async function pruneStaleCompileCaches(happyHomeDir, cliVersion) {
 async function run(args) {
   enableCompileCacheIfPossible(packageJson.version);
   if (isStandaloneVersionRequest(args) || isSelfCheckRequest(args)) {
-    const { selfCheckMain } = await import('./selfCheck-BQ_H2Sns.mjs');
+    const { selfCheckMain } = await import('./selfCheck-BfK945YQ.mjs');
     process.exit(await selfCheckMain({ verbose: isSelfCheckRequest(args) }));
   }
-  const { main } = await import('./main-DODz8DQE.mjs');
+  const { main } = await import('./main-DO7nRvhf.mjs');
   await main();
 }
 void run(process.argv.slice(2));

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-require('./package-CYDdLA6R.cjs');
-require('./index-4TpmBb2Q.cjs');
+require('./package-DrY090nZ.cjs');
+require('./index-CwRW11hT.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import './package-DTcaIhjW.mjs';
-import './index-CKd20r1W.mjs';
+import './package-C6uiXULx.mjs';
+import './index-rNTX33in.mjs';
 import 'node:module';
 import 'node:fs';
 import 'node:fs/promises';

package/dist/{install-DNbIEJUk.cjs → install-CXIL_FYx.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var logger = require('./logger-BP1SW7Cs.cjs');
+var logger = require('./logger-BBRTTVsQ.cjs');
 var require$$0 = require('fs');
 var child_process = require('child_process');
 var trimIdent = require('./trimIdent-4gvk9Wk6.cjs');
 var os = require('os');
 require('chalk');
 require('node:util');
-require('./configuration-C0ctLGW2.cjs');
+require('./configuration-Dt5lKW3P.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-CYDdLA6R.cjs');
+require('./package-DrY090nZ.cjs');
 require('node:fs/promises');
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/{install-23ehAdTD.mjs → install-DfPrEWGG.mjs}

@@ -1,15 +1,15 @@
-import { l as logger } from './logger-DOKH3Zbh.mjs';
+import { l as logger } from './logger-CL7pin9b.mjs';
 import { existsSync, writeFileSync, chmodSync } from 'fs';
 import { execSync } from 'child_process';
 import { t as trimIdent } from './trimIdent-BAjmv_TG.mjs';
 import os from 'os';
 import 'chalk';
 import 'node:util';
-import './configuration-1FabKklB.mjs';
+import './configuration-Dechcvd-.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-DTcaIhjW.mjs';
+import './package-C6uiXULx.mjs';
 import 'node:fs/promises';
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/lib.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var api = require('./api-BDuuyys8.cjs');
-var logger = require('./logger-BP1SW7Cs.cjs');
-var configuration = require('./configuration-C0ctLGW2.cjs');
+var api = require('./api-CXL6jp-p.cjs');
+var logger = require('./logger-BBRTTVsQ.cjs');
+var configuration = require('./configuration-Dt5lKW3P.cjs');
 var types = require('./types-CRS-srZK.cjs');
 require('axios');
-require('./lidState-B4dHJCeS.cjs');
+require('./lidState-q_XFYg33.cjs');
 require('./authRelay-Dy1qU9td.cjs');
 require('node:crypto');
 require('tweetnacl');
@@ -13,14 +13,14 @@ require('os');
 require('child_process');
 require('node:events');
 require('socket.io-client');
-require('./pushNotifications-CalIS9sq.cjs');
+require('./pushNotifications-CfspRcl-.cjs');
 require('zod');
 require('./index-BOe6dKnL.cjs');
 require('@paralleldrive/cuid2');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
 require('./limits-C-a7gr04.cjs');
-require('./time-XwEZxKGc.cjs');
-require('./registerCommonHandlers-DZPozYxc.cjs');
+require('./time-gPD_EmA-.cjs');
+require('./registerCommonHandlers-Beun-cQv.cjs');
 require('util');
 require('fs/promises');
 require('crypto');
@@ -28,17 +28,17 @@ require('path');
 require('cross-spawn');
 require('./projectPath-C3ioB4Bu.cjs');
 require('url');
-require('./sync-CoChLEIg.cjs');
+require('./sync-DtWB7RzA.cjs');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
-require('./controlClient-F7hAEEy2.cjs');
-require('./persistence-CrzC7yr_.cjs');
+require('./controlClient-BRk65BRO.cjs');
+require('./persistence-Bl5S3TLB.cjs');
 require('node:fs/promises');
 require('node:fs');
 require('chalk');
 require('node:util');
 require('node:path');
 require('node:os');
-require('./package-CYDdLA6R.cjs');
+require('./package-DrY090nZ.cjs');
 
 
 

package/dist/lib.d.cts

@@ -616,6 +616,19 @@ declare const DaemonStateSchema: z$1.ZodObject<{
         rpcAvailable: z$1.ZodBoolean;
         detectedAt: z$1.ZodNumber;
     }, z$1.core.$loose>>;
+    autoRestart: z$1.ZodOptional<z$1.ZodObject<{
+        enabled: z$1.ZodBoolean;
+        rpcAvailable: z$1.ZodBoolean;
+        detectedAt: z$1.ZodNumber;
+        sessions: z$1.ZodRecord<z$1.ZodString, z$1.ZodObject<{
+            state: z$1.ZodString;
+            reason: z$1.ZodOptional<z$1.ZodString>;
+            since: z$1.ZodNumber;
+            target: z$1.ZodString;
+            offline: z$1.ZodOptional<z$1.ZodBoolean>;
+            retryAt: z$1.ZodOptional<z$1.ZodNumber>;
+        }, z$1.core.$strip>>;
+    }, z$1.core.$loose>>;
     webPanels: z$1.ZodOptional<z$1.ZodObject<{
         panels: z$1.ZodArray<z$1.ZodObject<{
             id: z$1.ZodString;
@@ -1032,6 +1045,13 @@ declare class RpcHandlerManager {
     private getPrefixedMethod;
 }
 
+/**
+ * Why the CLI dropped a user message it never ran — the `queue-cancel` reason
+ * (B-332). `failed` (B-854): taken off the queue, but the runner could not hand
+ * it to the agent (a pre-flight check or the agent's start failed).
+ */
+type QueueDiscardReason = 'cleared' | 'aborted' | 'restarted' | 'failed';
+
 /**
  * B-509 —— server-side prompt queue drain (pure state machine, no I/O).
  *
@@ -1334,7 +1354,7 @@ declare class ApiSessionClient extends EventEmitter {
     private pushCommittedMessagesToRelay;
     private enqueueMessage;
     /** B-332: emit a queue-cancel tombstone, mirroring the web's own signal. */
-    sendQueueCancelReason(localKeys: string[], reason: 'cleared' | 'aborted' | 'restarted'): void;
+    sendQueueCancelReason(localKeys: string[], reason: QueueDiscardReason): void;
     /**
      * B-332 site ③: find queued user input this wrapper destroyed (it was still
      * in the previous wrapper's in-memory queue when it died) and tell the web.
@@ -1532,9 +1552,29 @@ declare class ApiSessionClient extends EventEmitter {
      */
     flush(): Promise<void>;
     close(): Promise<void>;
+    /**
+     * B-854: set by close(). The socket's own `disconnect` ("io client
+     * disconnect") must not reconnect a client its owner closed: a runner that
+     * ends without `process.exit` (ACP) stayed alive on that socket — still
+     * "active" for the daemon and the web, with no loop to run anything.
+     */
+    private closedByClient;
     private startSmartReconnect;
 }
 
+/** What the daemon publishes per behind session (spec §4). */
+type AutoRestartSessionState = 'waiting' | 'restarting' | 'failed' | 'manual';
+interface AutoRestartSessionStatus {
+    state: AutoRestartSessionState;
+    reason?: string;
+    since: number;
+    target: string;
+    /** `failed` only: the old wrapper is stopped and no new one came up, so the session is offline (spec §3). */
+    offline?: boolean;
+    /** `failed` + `offline` only: the daemon retries once by itself at this time; absent = left to Restore. */
+    retryAt?: number;
+}
+
 /**
  * B-510: machine web panels — local web pages a person may need to look at
  * (noVNC, an agent-browser dashboard, Grafana, a dev server), declared ONLY in
@@ -1953,6 +1993,8 @@ declare class ApiMachineClient {
     private claudeAuthState;
     /** B-587: the machine's hibernation threshold, published as a capability. */
     private agentHibernationIdleMs;
+    /** B-852: auto-restart setting + per-session status (null until the daemon installs it). */
+    private autoRestart;
     /** B-510: last normalized `webPanels` (null = never set → field not written). */
     private webPanels;
     private webPanelsSignatureSent;
@@ -2044,6 +2086,16 @@ declare class ApiMachineClient {
      */
     setWebPanels(panels: WebPanel[]): Promise<void>;
     private publishAgentHibernation;
+    /**
+     * B-852: the machine page's「会话自动更新」switch (`auto-restart-set`) and
+     * the `daemonState.autoRestart` capability + per-session status. Call
+     * before connect().
+     */
+    setAutoRestartHandlers(initialEnabled: boolean, set: (enabled: boolean) => Promise<boolean>): void;
+    /** B-852: the scheduler's per-session status changed (already signature-deduped). */
+    setAutoRestartSessions(sessions: Record<string, AutoRestartSessionStatus>): Promise<void>;
+    private autoRestartState;
+    private publishAutoRestart;
     /** B-276 machine RPCs. Responses always carry `claudeAuth` so the web can refresh in place. */
     setClaudeAuthHandlers(handlers: {
         probe: () => Promise<ClaudeAuthState>;