very-happy-cli 0.2.176 → 0.2.178

package/dist/{index-jeD70GGH.cjs → index-piJPsTsm.cjs}

@@ -1,35 +1,36 @@
 'use strict';
 
-var AcpBackend = require('./AcpBackend-9_ZI1Bv3.cjs');
-var logger = require('./logger-zoO54Zsy.cjs');
-var AcpSessionManager = require('./AcpSessionManager-CjdJLofq.cjs');
-var index = require('./index-De8L5lFK.cjs');
+var AcpBackend = require('./AcpBackend-CDkAQXYf.cjs');
+var logger = require('./logger-DXTWlPzP.cjs');
+var AcpSessionManager = require('./AcpSessionManager-DckmUZza.cjs');
+var index = require('./index-_l1Sdmbi.cjs');
 var agentAttachments = require('./agentAttachments-Dbw8iMCZ.cjs');
-var configuration = require('./configuration-CpBrilxV.cjs');
-var attachmentContent = require('./attachmentContent-CFzzTeV9.cjs');
-var piRuntime = require('./piRuntime-B-SPcWIr.cjs');
+var configuration = require('./configuration-4TGMrjul.cjs');
+var attachmentContent = require('./attachmentContent-bpQTBJ0y.cjs');
+var piRuntime = require('./piRuntime-BHRT5MKO.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
-var api = require('./api-Buc_ejoA.cjs');
-var registerKillSessionHandler = require('./registerKillSessionHandler-WQra3T9B.cjs');
-var deterministicJson = require('./deterministicJson-aHxtYLha.cjs');
-var persistence = require('./persistence-Cih2AWml.cjs');
-var machineMetadata = require('./machineMetadata-BAKVtr-k.cjs');
-var createSessionMetadata = require('./createSessionMetadata-D4Sj6H95.cjs');
-var setupOfflineReconnection = require('./setupOfflineReconnection-B9Tw1Ouj.cjs');
-var controlClient = require('./controlClient-bs_YqwDl.cjs');
-var authRelay = require('./authRelay-BdYkC1Po.cjs');
-var streamRelay = require('./streamRelay-Cx01enfe.cjs');
+var api = require('./api-JANhFdZV.cjs');
+var registerKillSessionHandler = require('./registerKillSessionHandler-DYl7l4Ts.cjs');
+var deterministicJson = require('./deterministicJson-BjNQsAjO.cjs');
+var persistence = require('./persistence-BfX72dne.cjs');
+var machineMetadata = require('./machineMetadata-DcUupMje.cjs');
+var createSessionMetadata = require('./createSessionMetadata-B2NynaWZ.cjs');
+var setupOfflineReconnection = require('./setupOfflineReconnection-C2EeYTFH.cjs');
+var controlClient = require('./controlClient-BTaZlbC6.cjs');
+var authRelay = require('./authRelay-Dy1qU9td.cjs');
+var streamRelay = require('./streamRelay-9kBPpbvU.cjs');
 var projectPath = require('./projectPath-ChLhdOyt.cjs');
-var BasePermissionHandler = require('./BasePermissionHandler-DPvLN7aR.cjs');
-var titleGenerator = require('./titleGenerator-CXr7t6cf.cjs');
-var sessionModeFile = require('./sessionModeFile-DVukoSp7.cjs');
+var BasePermissionHandler = require('./BasePermissionHandler-DyLmKKtO.cjs');
+var titleGenerator = require('./titleGenerator-D26gvNaS.cjs');
+var sessionModeFile = require('./sessionModeFile-CLLdidiJ.cjs');
 var editPaths = require('./editPaths-Bqp4OFPw.cjs');
 require('node:child_process');
 require('@agentclientprotocol/sdk');
-require('./time-s8CaneqW.cjs');
+require('./time-A6zR3Iy6.cjs');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
-require('./package-A7zOGx8B.cjs');
+require('./processTree-CMHWlVse.cjs');
+require('./package-DY4zTbKS.cjs');
 require('chalk');
 require('node:util');
 require('node:fs');
@@ -37,49 +38,49 @@ require('@paralleldrive/cuid2');
 require('zod');
 require('node:os');
 require('node:fs/promises');
-require('./attachmentLimits-DtFqqiwR.cjs');
+require('./attachmentLimits-SqeAHrVC.cjs');
 require('./resources-JDPugcDq.cjs');
 require('axios');
-require('./lidState-UasMvPzw.cjs');
+require('./lidState-BeOwj6eW.cjs');
 require('os');
 require('child_process');
 require('node:events');
 require('socket.io-client');
 require('./limits-C-a7gr04.cjs');
-require('./registerCommonHandlers-CqO075-X.cjs');
+require('./registerCommonHandlers-C0_fyBQ0.cjs');
 require('util');
 require('fs/promises');
 require('crypto');
 require('path');
 require('cross-spawn');
-require('./sync-BgZuthoS.cjs');
+require('./sync-Dhmtk66S.cjs');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
 require('tweetnacl');
 require('./types-CRS-srZK.cjs');
-require('./client-D7sSU04O.cjs');
-require('./context-Hk0j2Y9-.cjs');
-require('./sessionOps-Nryt1DZt.cjs');
-require('./tools-lotMyxIE.cjs');
-require('./reportProgressTool-C2gn_HWD.cjs');
-require('./client-D9pEOhn4.cjs');
+require('./client-Dnza1hgN.cjs');
+require('./context-JoKu0V54.cjs');
+require('./sessionOps-BAnr7n8t.cjs');
+require('./tools-CxJp4T1T.cjs');
+require('./reportProgressTool-B9nCzbkL.cjs');
+require('./client-C4zKGjiJ.cjs');
 require('./precheckCompat-CWOi5c9L.cjs');
 require('./agentGuidance-BtBx2xxE.cjs');
 require('./trimIdent-4gvk9Wk6.cjs');
-require('./peerTools-dPc9hRC5.cjs');
+require('./peerTools-iy3_6Yc5.cjs');
 require('./ids-B6ZC0HGt.cjs');
-require('./remoteSessionClient-f3DYorl8.cjs');
+require('./remoteSessionClient-BRTIOX5b.cjs');
 require('@modelcontextprotocol/sdk/server/mcp.js');
 require('node:http');
 require('@modelcontextprotocol/sdk/server/streamableHttp.js');
-require('./downloadTarget-CmdlljZW.cjs');
+require('./downloadTarget-BN5vZt3K.cjs');
 require('./terminals-B_bfC9c2.cjs');
 require('./terminalTitleSuggest-DhvRFX3H.cjs');
 require('./tmuxSocket-D-Xt6Vn-.cjs');
-require('./bootstrap-BboDz_w2.cjs');
+require('./bootstrap-DCQ87Aan.cjs');
 require('./previewPath-B0rBdhy1.cjs');
 require('./detectCLI-DR9ZaN6B.cjs');
 require('fs');
-require('./localHappyAgentAuth-CA02WOny.cjs');
+require('./localHappyAgentAuth-Br-mgogg.cjs');
 require('url');
 require('node:module');
 require('./oneShotPrompts-CL0dip9C.cjs');
@@ -98,6 +99,35 @@ function createAcpBackend(options) {
   return new AcpBackend.AcpBackend(backendOptions);
 }
 
+const MAX_DETAIL_CHARS = 400;
+function detailOf(error) {
+  if (error instanceof Error) return error.message;
+  if (error && typeof error === "object") {
+    const record = error;
+    const data = record.data && typeof record.data === "object" ? record.data : null;
+    const details = typeof data?.details === "string" ? data.details : null;
+    const message = typeof record.message === "string" ? record.message : null;
+    const text = details && message && details !== message ? `${message}: ${details}` : details ?? message;
+    if (text) return text;
+    try {
+      return JSON.stringify(error);
+    } catch {
+      return String(error);
+    }
+  }
+  return String(error);
+}
+function oneLine(text) {
+  const folded = text.replace(/\s+/g, " ").trim();
+  return folded.length > MAX_DETAIL_CHARS ? `${folded.slice(0, MAX_DETAIL_CHARS - 1)}\u2026` : folded;
+}
+function describeAcpTurnFailure(agentName, error) {
+  if (AcpBackend.isAgentExitError(error)) {
+    return { message: `Process exited unexpectedly: ${oneLine(error.message)}`, exited: true };
+  }
+  return { message: `${agentName} error: ${oneLine(detailOf(error))}`, exited: false };
+}
+
 const SUPPORTED_CATEGORIES = /* @__PURE__ */ new Set(["mode", "model", "thought_level"]);
 function isRecord$1(value) {
   return !!value && typeof value === "object";
@@ -265,7 +295,6 @@ function mergeAcpSessionConfigIntoMetadata(metadata, snapshot) {
   return next;
 }
 
-const TURN_TIMEOUT_MS = 5 * 60 * 1e3;
 const ACP_EVENT_PREVIEW_CHARS = 240;
 const ACP_RAW_PREVIEW_CHARS = 2e3;
 const ACP_COLOR_RESET = "\x1B[0m";
@@ -733,7 +762,7 @@ async function runAcp(opts) {
     }
   };
   const teamsPiEnv = opts.agentName === "pi" ? await piRuntime.preparePiTeamsRuntime() : {};
-  const backend = new AcpBackend.AcpBackend({
+  const createBackend = () => new AcpBackend.AcpBackend({
     agentName: opts.agentName,
     cwd: process.cwd(),
     command: opts.command,
@@ -752,6 +781,7 @@ async function runAcp(opts) {
     transportHandler: new AcpBackend.DefaultTransport(opts.agentName),
     verbose
   });
+  let backend = createBackend();
   let thinking = false;
   const setThinking = (next) => {
     if (thinking === next) {
@@ -763,34 +793,15 @@ async function runAcp(opts) {
   let acpSessionId = null;
   let shouldExit = false;
   let abortController = new AbortController();
-  let pendingTurn = null;
   let turnCancelled = false;
-  const clearPendingTurn = (error) => {
-    if (!pendingTurn) {
-      return;
-    }
-    clearTimeout(pendingTurn.timeout);
-    const current = pendingTurn;
-    pendingTurn = null;
-    if (error) {
-      current.reject(error);
-      return;
-    }
-    current.resolve();
-  };
-  const waitForTurnEnd = () => new Promise((resolve, reject) => {
-    const timeout = setTimeout(() => {
-      pendingTurn = null;
-      reject(new Error(`Timed out waiting for ${opts.agentName} to finish the turn`));
-    }, TURN_TIMEOUT_MS);
-    pendingTurn = { resolve, reject, timeout };
-  });
+  let backendStarted = false;
+  let backendGone = null;
+  let todoDiscoverySent = false;
   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();
-    clearPendingTurn(new Error(reason));
   };
   const sendEnvelopes = (envelopes) => {
     for (const envelope of envelopes) {
@@ -1056,14 +1067,21 @@ async function runAcp(opts) {
       const suffix = msg.detail ? `: ${msg.detail}` : "";
       const statusLine = `Status: ${msg.status}${suffix}`;
       logAcp("muted", statusLine);
-      if (msg.status === "idle") {
-        clearPendingTurn();
-      }
       if (msg.status === "error" || msg.status === "stopped") {
         if (msg.status === "error") opts.onBackendError?.(msg.detail);
-        stopRunnerFromBackendStatus(msg.status, msg.detail);
+        if (!backendStarted) {
+          stopRunnerFromBackendStatus(msg.status, msg.detail);
+        } else if (msg.status === "stopped") {
+          backendGone = new Error(msg.detail ?? `${opts.agentName} process exited`);
+        }
       }
     }
+    if (msg.type === "event" && msg.name === "notice") {
+      const message = AcpBackend.acpNoticeMessage(opts.agentName, msg.payload);
+      logAcp("muted", message);
+      session.sendSessionEvent({ type: "message", message });
+      return;
+    }
     const frontendMessage = formatAcpMessageForFrontend(opts.agentName, msg, verbose);
     if (frontendMessage) {
       logAcp(frontendMessage.kind, frontendMessage.text);
@@ -1115,8 +1133,9 @@ async function runAcp(opts) {
   const keepAliveInterval = setInterval(() => {
     session.keepAlive(thinking, "remote");
   }, 2e3);
+  let promptInFlight = false;
   async function handleAbort() {
-    turnCancelled = thinking;
+    turnCancelled = thinking && promptInFlight;
     try {
       if (acpSessionId) {
         await backend.cancel(acpSessionId);
@@ -1149,15 +1168,12 @@ async function runAcp(opts) {
   const disposeTermination = registerKillSessionHandler.registerKillSessionHandler(session.rpcHandlerManager, async () => {
     shouldExit = true;
     messageQueue.close();
-    clearPendingTurn(new Error("Session terminated"));
     await handleAbort();
   }, session, { processSignals: true });
-  try {
-    const started = await backend.startSession();
-    acpSessionId = started.sessionId;
-    if (opts.model) {
-      await switchModelIfRequested(opts.model);
-      const applied = isCurrentRequestedModel(opts.model);
+  const afterSessionStarted = async (requestedModel) => {
+    if (requestedModel) {
+      await switchModelIfRequested(requestedModel);
+      const applied = isCurrentRequestedModel(requestedModel);
       if (!applied) session.sendSessionEvent({ type: "message", message: "The saved model is unavailable for this agent; using its current model." });
     }
     session.updateMetadata((current) => ({
@@ -1166,8 +1182,33 @@ async function runAcp(opts) {
     }));
     if (permissionModeIsFileBacked()) {
       fileBackedModeActive = true;
-      publishFileBackedPermissionMode(initialPermissionMode);
+      publishFileBackedPermissionMode(fileBackedPermissionMode ?? initialPermissionMode);
+    }
+  };
+  const restartBackend = async () => {
+    const gone = backendGone;
+    backend.offMessage?.(onBackendMessage);
+    acpSessionId = null;
+    try {
+      await backend.dispose();
+    } catch (error) {
+      logger.logger.debug(`[${opts.agentName}] dispose of the dead backend failed:`, error);
     }
+    backend = createBackend();
+    backend.onMessage(onBackendMessage);
+    const started = await backend.startSession();
+    acpSessionId = started.sessionId;
+    backendGone = null;
+    todoDiscoverySent = false;
+    await afterSessionStarted(currentModel ?? opts.model);
+    logger.logger.debug(`[${opts.agentName}] Restarted the agent after it exited: ${gone?.message ?? "unknown"}`);
+    session.sendSessionEvent({ type: "message", message: `${opts.agentName} was restarted after its process exited; it does not remember the earlier conversation (the transcript here is kept).` });
+  };
+  try {
+    const started = await backend.startSession();
+    acpSessionId = started.sessionId;
+    backendStarted = true;
+    await afterSessionStarted(opts.model);
     if (verbose) {
       if (!sawSlashCommands) {
         logAcp("muted", `Outgoing slash commands from ${opts.agentName}: not reported yet`);
@@ -1179,7 +1220,6 @@ async function runAcp(opts) {
         logAcp("muted", `Outgoing models from ${opts.agentName}: not reported yet`);
       }
     }
-    let todoDiscoverySent = false;
     while (!shouldExit) {
       const waitSignal = abortController.signal;
       const batch = await messageQueue.waitForMessagesAndGetAsString(waitSignal);
@@ -1192,17 +1232,17 @@ async function runAcp(opts) {
         }
         break;
       }
-      if (!acpSessionId) {
-        throw new Error("ACP session is not started");
-      }
       logAcp("incoming", `Incoming prompt: ${formatUnknownForConsole(batch.message, ACP_EVENT_PREVIEW_CHARS)}`);
       sendEnvelopes(sessionManager.startTurn());
       turnCancelled = false;
       setThinking(true);
-      const turnEnded = waitForTurnEnd();
-      void turnEnded.catch(() => {
-      });
       try {
+        if (backendGone) {
+          await restartBackend();
+        }
+        if (!acpSessionId) {
+          throw new Error("ACP session is not started");
+        }
         if (typeof batch.mode.permissionMode === "string" && batch.mode.permissionMode.length > 0) {
           await switchPermissionModeIfRequested(batch.mode.permissionMode);
         }
@@ -1218,10 +1258,23 @@ ${index.BUILTIN_TODO_DISCOVERY}`;
           happyHomeDir: configuration.configuration.happyHomeDir,
           sessionId: session.sessionId
         }) : [];
-        await backend.sendPrompt(acpSessionId, attachmentContent.appendStagedAttachmentsToPrompt(prompt, staged), attachments);
+        promptInFlight = true;
+        let outcome;
+        try {
+          outcome = await backend.sendPrompt(acpSessionId, attachmentContent.appendStagedAttachmentsToPrompt(prompt, staged), attachments);
+        } finally {
+          promptInFlight = false;
+        }
         todoDiscoverySent = true;
-        await turnEnded;
-        sendEnvelopes(sessionManager.endTurn(turnCancelled ? "cancelled" : "completed"));
+        const stopReason = outcome && typeof outcome === "object" ? outcome.stopReason : void 0;
+        if (stopReason === "error") {
+          throw new Error("the turn ended with an error reported by the agent");
+        }
+        const cancelled = turnCancelled || stopReason === "cancelled";
+        sendEnvelopes(sessionManager.endTurn(cancelled ? "cancelled" : "completed"));
+        if (!cancelled && stopReason && stopReason !== "end_turn") {
+          session.sendSessionEvent({ type: "message", message: `${opts.agentName} stopped the turn: ${stopReason}` });
+        }
         streamRelay$1.endTurn();
         setThinking(false);
         session.sendSessionEvent({ type: "ready" });
@@ -1229,14 +1282,16 @@ ${index.BUILTIN_TODO_DISCOVERY}`;
           logAcp("muted", `Outgoing prompt completion from ${opts.agentName}`);
         }
       } catch (error) {
-        session.sendSessionEvent({ type: "message", message: "The agent could not process this message or its attachments. Please check the agent and try again." });
+        const failure = describeAcpTurnFailure(opts.agentName, error);
+        session.sendSessionEvent({ type: "message", message: failure.message });
         sendEnvelopes(sessionManager.endTurn("failed"));
         streamRelay$1.endTurn();
         setThinking(false);
         session.sendSessionEvent({ type: "ready" });
         logAcp("error", `Prompt error from ${opts.agentName}: ${error instanceof Error ? error.message : String(error)}`);
-        clearPendingTurn(error instanceof Error ? error : new Error(String(error)));
-        throw error;
+        if (failure.exited && error instanceof Error) {
+          backendGone = error;
+        }
       }
     }
   } finally {
@@ -1246,7 +1301,6 @@ ${index.BUILTIN_TODO_DISCOVERY}`;
     streamRelay$1.endTurn();
     streamRelay$1.dispose();
     reconnectionHandle?.cancel();
-    clearPendingTurn(new Error("ACP runner shutting down"));
     try {
       permissionHandler.reset();
     } catch (error) {

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-require('./package-A7zOGx8B.cjs');
-require('./index-MwTVbeGW.cjs');
+require('./package-DY4zTbKS.cjs');
+require('./index-BRClDe07.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import './package-ayqGDKSp.mjs';
-import './index-59hR7nVz.mjs';
+import './package-B7B03ejW.mjs';
+import './index-BYgfern_.mjs';
 import 'node:module';
 import 'node:fs';
 import 'node:fs/promises';

package/dist/{install-DXUEtGfU.cjs → install-TO4taKW7.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var logger = require('./logger-zoO54Zsy.cjs');
+var logger = require('./logger-DXTWlPzP.cjs');
 var fs = 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-CpBrilxV.cjs');
+require('./configuration-4TGMrjul.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-A7zOGx8B.cjs');
+require('./package-DY4zTbKS.cjs');
 require('node:fs/promises');
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/{install-DytIJ_Ia.mjs → install-fYWHrPcC.mjs}

@@ -1,15 +1,15 @@
-import { l as logger } from './logger-CihCDWDw.mjs';
+import { l as logger } from './logger--vAVtXB_.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-BAwOtWFY.mjs';
+import './configuration-DVrb61aY.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-ayqGDKSp.mjs';
+import './package-B7B03ejW.mjs';
 import 'node:fs/promises';
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/lib.cjs

@@ -1,25 +1,25 @@
 'use strict';
 
-var api = require('./api-Buc_ejoA.cjs');
-var logger = require('./logger-zoO54Zsy.cjs');
-var configuration = require('./configuration-CpBrilxV.cjs');
+var api = require('./api-JANhFdZV.cjs');
+var logger = require('./logger-DXTWlPzP.cjs');
+var configuration = require('./configuration-4TGMrjul.cjs');
 var types = require('./types-CRS-srZK.cjs');
 require('axios');
-require('./lidState-UasMvPzw.cjs');
-require('./authRelay-BdYkC1Po.cjs');
+require('./lidState-BeOwj6eW.cjs');
+require('./authRelay-Dy1qU9td.cjs');
 require('node:crypto');
 require('tweetnacl');
 require('os');
 require('child_process');
 require('node:events');
 require('socket.io-client');
-require('./attachmentLimits-DtFqqiwR.cjs');
+require('./attachmentLimits-SqeAHrVC.cjs');
 require('zod');
-require('./index-De8L5lFK.cjs');
+require('./index-_l1Sdmbi.cjs');
 require('@paralleldrive/cuid2');
 require('./limits-C-a7gr04.cjs');
-require('./time-s8CaneqW.cjs');
-require('./registerCommonHandlers-CqO075-X.cjs');
+require('./time-A6zR3Iy6.cjs');
+require('./registerCommonHandlers-C0_fyBQ0.cjs');
 require('util');
 require('fs/promises');
 require('crypto');
@@ -27,10 +27,10 @@ require('path');
 require('cross-spawn');
 require('./projectPath-ChLhdOyt.cjs');
 require('url');
-require('./sync-BgZuthoS.cjs');
+require('./sync-Dhmtk66S.cjs');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
-require('./controlClient-bs_YqwDl.cjs');
-require('./persistence-Cih2AWml.cjs');
+require('./controlClient-BTaZlbC6.cjs');
+require('./persistence-BfX72dne.cjs');
 require('node:fs/promises');
 require('node:fs');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
@@ -38,7 +38,7 @@ require('chalk');
 require('node:util');
 require('node:path');
 require('node:os');
-require('./package-A7zOGx8B.cjs');
+require('./package-DY4zTbKS.cjs');
 
 
 

package/dist/lib.d.cts

@@ -1285,9 +1285,15 @@ declare class ApiSessionClient extends EventEmitter {
          *  unique constraint swallow every envelope after the first. */
         localIdFor?: (envelopeIndex: number) => string;
     }): void;
+    /**
+     * Returns true when a `turn-end` envelope went out, false when no turn was
+     * open to close (B-631: the web renders a failed turn-end's `error` as its
+     * own line, so a launcher sends the matching session event only when this
+     * says the turn-end did not carry it).
+     */
     closeClaudeSessionTurn(status?: SessionTurnEndStatus, meta?: {
         error?: string;
-    }): void;
+    }): boolean;
     sendCodexMessage(body: any): void;
     private enqueueSessionProtocolEnvelope;
     sendSessionProtocolMessage(envelope: SessionEnvelope, localId?: string): void;
@@ -1829,6 +1835,9 @@ declare class ApiMachineClient {
     private createControlSocket;
     private activateControlSocket;
     private bindControlDataHandlers;
+    private serverMigrateHandler;
+    /** B-635: the daemon decides what to do with a relay-migration notice (daemon/serverMigration.ts). */
+    setServerMigrateHandler(handler: ((notice: unknown) => void) | null): void;
     private startReleaseHandover;
     private releaseHandover;
     private startKeepAlive;

package/dist/lib.d.mts

@@ -1285,9 +1285,15 @@ declare class ApiSessionClient extends EventEmitter {
          *  unique constraint swallow every envelope after the first. */
         localIdFor?: (envelopeIndex: number) => string;
     }): void;
+    /**
+     * Returns true when a `turn-end` envelope went out, false when no turn was
+     * open to close (B-631: the web renders a failed turn-end's `error` as its
+     * own line, so a launcher sends the matching session event only when this
+     * says the turn-end did not carry it).
+     */
     closeClaudeSessionTurn(status?: SessionTurnEndStatus, meta?: {
         error?: string;
-    }): void;
+    }): boolean;
     sendCodexMessage(body: any): void;
     private enqueueSessionProtocolEnvelope;
     sendSessionProtocolMessage(envelope: SessionEnvelope, localId?: string): void;
@@ -1829,6 +1835,9 @@ declare class ApiMachineClient {
     private createControlSocket;
     private activateControlSocket;
     private bindControlDataHandlers;
+    private serverMigrateHandler;
+    /** B-635: the daemon decides what to do with a relay-migration notice (daemon/serverMigration.ts). */
+    setServerMigrateHandler(handler: ((notice: unknown) => void) | null): void;
     private startReleaseHandover;
     private releaseHandover;
     private startKeepAlive;

package/dist/lib.mjs

@@ -1,23 +1,23 @@
-export { A as ApiClient, a as ApiSessionClient } from './api-CbwDDXJt.mjs';
-export { l as logger } from './logger-CihCDWDw.mjs';
-export { c as configuration } from './configuration-BAwOtWFY.mjs';
+export { A as ApiClient, a as ApiSessionClient } from './api-Dib0dmqC.mjs';
+export { l as logger } from './logger--vAVtXB_.mjs';
+export { c as configuration } from './configuration-DVrb61aY.mjs';
 export { R as RawJSONLinesSchema } from './types-CkqAACXx.mjs';
 import 'axios';
-import './lidState-CduPmrM0.mjs';
-import './authRelay-DSAvg1uv.mjs';
+import './lidState-DNMlIhX0.mjs';
+import './authRelay-DhQhkBvX.mjs';
 import 'node:crypto';
 import 'tweetnacl';
 import 'os';
 import 'child_process';
 import 'node:events';
 import 'socket.io-client';
-import './attachmentLimits-Di1Z93lN.mjs';
+import './attachmentLimits-UyFn8fkQ.mjs';
 import 'zod';
-import './index-DMy3OCBe.mjs';
+import './index-Clqlu17M.mjs';
 import '@paralleldrive/cuid2';
 import './limits-DIo7rEBR.mjs';
-import './time-DxCTiteK.mjs';
-import './registerCommonHandlers-Bm7CMqMv.mjs';
+import './time-BuGWTVP6.mjs';
+import './registerCommonHandlers-CvIedVRf.mjs';
 import 'util';
 import 'fs/promises';
 import 'crypto';
@@ -25,10 +25,10 @@ import 'path';
 import 'cross-spawn';
 import './projectPath-BTBIMB57.mjs';
 import 'url';
-import './sync-BKvgkhPs.mjs';
-import './backgroundTaskActivity-8PdPxrvy.mjs';
-import './controlClient-00KYAjsI.mjs';
-import './persistence-Dy3lmall.mjs';
+import './sync-DbW07iQS.mjs';
+import './backgroundTaskActivity-BVwJBl02.mjs';
+import './controlClient-BYKyGyxj.mjs';
+import './persistence-DTk4sNpd.mjs';
 import 'node:fs/promises';
 import 'node:fs';
 import './contentLogMetadata-BlWI0egu.mjs';
@@ -36,4 +36,4 @@ import 'chalk';
 import 'node:util';
 import 'node:path';
 import 'node:os';
-import './package-ayqGDKSp.mjs';
+import './package-B7B03ejW.mjs';

package/dist/{lidState-UasMvPzw.cjs → lidState-BeOwj6eW.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var logger = require('./logger-zoO54Zsy.cjs');
-var authRelay = require('./authRelay-BdYkC1Po.cjs');
+var logger = require('./logger-DXTWlPzP.cjs');
+var authRelay = require('./authRelay-Dy1qU9td.cjs');
 var os = require('os');
 var child_process = require('child_process');
 

package/dist/{lidState-CduPmrM0.mjs → lidState-DNMlIhX0.mjs}

@@ -1,5 +1,5 @@
-import { l as logger } from './logger-CihCDWDw.mjs';
-import { e as encodeBase64, g as encrypt, h as decrypt, d as decodeBase64 } from './authRelay-DSAvg1uv.mjs';
+import { l as logger } from './logger--vAVtXB_.mjs';
+import { e as encodeBase64, g as encrypt, h as decrypt, d as decodeBase64 } from './authRelay-DhQhkBvX.mjs';
 import os from 'os';
 import { execSync } from 'child_process';
 

package/dist/{localHappyAgentAuth-DL8JjHTV.mjs → localHappyAgentAuth-BezKSFDi.mjs}

@@ -3,8 +3,8 @@ import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import tweetnacl from 'tweetnacl';
 import { z } from 'zod';
-import { c as credentialRelayProblem, d as decodeBase64 } from './authRelay-DSAvg1uv.mjs';
-import { c as configuration } from './configuration-BAwOtWFY.mjs';
+import { c as credentialRelayProblem, d as decodeBase64 } from './authRelay-DhQhkBvX.mjs';
+import { c as configuration } from './configuration-DVrb61aY.mjs';
 
 const AgentCredentialsSchema = z.object({
   token: z.string().min(1),