very-happy-cli 0.2.162 → 0.2.164

package/dist/{index-9L39wqYR.mjs → index-CRJtZCK-.mjs}

@@ -1,34 +1,34 @@
-import { D as DefaultTransport, A as AcpBackend } from './AcpBackend--TmFHgRH.mjs';
-export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend--TmFHgRH.mjs';
-import { l as logger } from './logger-CGE4C8ho.mjs';
-import { A as AcpSessionManager } from './AcpSessionManager-BSIBnWUb.mjs';
-import { l as BUILTIN_TODO_DISCOVERY, P as PROMPT_QUEUE_CAPABILITY } from './index-BBg9j0XK.mjs';
+import { D as DefaultTransport, A as AcpBackend } from './AcpBackend-B8l1ZePt.mjs';
+export { a as DEFAULT_IDLE_TIMEOUT_MS, b as DEFAULT_TOOL_CALL_TIMEOUT_MS, e as extractErrorDetail, f as formatDuration, c as formatDurationMinutes, h as handleAgentMessageChunk, d as handleAgentThoughtChunk, g as handleLegacyMessageChunk, i as handlePlanUpdate, j as handleThinkingUpdate, k as handleToolCall, l as handleToolCallUpdate, p as parseArgsFromContent } from './AcpBackend-B8l1ZePt.mjs';
+import { l as logger } from './logger-8dtZPn3n.mjs';
+import { A as AcpSessionManager } from './AcpSessionManager-BQnDJvct.mjs';
+import { l as BUILTIN_TODO_DISCOVERY, P as PROMPT_QUEUE_CAPABILITY } from './index-vVWpCoTr.mjs';
 import { r as registerAgentAttachmentDownloads } from './agentAttachments-M_B5qEF2.mjs';
-import { c as configuration } from './configuration-A5gW_0GE.mjs';
-import { C as CLAUDE_ATTACHMENT_KINDS, a as stageClaudeAttachments, b as appendStagedAttachmentsToPrompt } from './attachmentContent-s1xPha4Q.mjs';
-import { p as preparePiTeamsRuntime } from './piRuntime-DVPixFjl.mjs';
+import { c as configuration } from './configuration-CiBUH72C.mjs';
+import { C as CLAUDE_ATTACHMENT_KINDS, a as stageClaudeAttachments, b as appendStagedAttachmentsToPrompt } from './attachmentContent-BLyyo1al.mjs';
+import { p as preparePiTeamsRuntime } from './piRuntime-BnNl5Lmb.mjs';
 import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
-import { c as connectionState, A as ApiClient } from './api-D57dsd6_.mjs';
-import { M as MessageQueue2, r as registerKillSessionHandler } from './registerKillSessionHandler-Cll4-o8Y.mjs';
-import { h as hashObject, s as startHappyServer } from './deterministicJson-DiR7EOMO.mjs';
-import { readSettings } from './persistence-Cw8aLoyL.mjs';
-import { g as getInitialMachineMetadata } from './machineMetadata-ue1nkowa.mjs';
-import { c as createSessionMetadata } from './createSessionMetadata-Dyg33ZlU.mjs';
-import { s as setupOfflineReconnection } from './setupOfflineReconnection-DiQma2Cc.mjs';
-import { n as notifyDaemonSessionStarted, g as reportSessionEditToDaemon } from './controlClient-CYzHrh3e.mjs';
+import { c as connectionState, A as ApiClient } from './api-Yoh_zKdR.mjs';
+import { M as MessageQueue2, r as registerKillSessionHandler } from './registerKillSessionHandler-Ben5lAsN.mjs';
+import { h as hashObject, s as startHappyServer } from './deterministicJson-CKqT3awl.mjs';
+import { readSettings } from './persistence-C_xFQLsD.mjs';
+import { g as getInitialMachineMetadata } from './machineMetadata-Bhp_w3-_.mjs';
+import { c as createSessionMetadata } from './createSessionMetadata-B47GrTX6.mjs';
+import { s as setupOfflineReconnection } from './setupOfflineReconnection-B_9xp36H.mjs';
+import { n as notifyDaemonSessionStarted, g as reportSessionEditToDaemon } from './controlClient-DzmCQrY_.mjs';
 import { e as encodeBase64 } from './authRelay-DSAvg1uv.mjs';
-import { S as StreamRelay } from './streamRelay-BLgU9X3R.mjs';
+import { S as StreamRelay } from './streamRelay-BzMEEvJU.mjs';
 import { p as projectPath } from './projectPath-BTBIMB57.mjs';
-import { B as BasePermissionHandler } from './BasePermissionHandler-DUBySe0f.mjs';
-import { T as TitleGenerator } from './titleGenerator-B4AW3dLr.mjs';
-import { w as writeSessionModeFile, n as normalizeAcpPermissionMode, r as removeSessionModeFile } from './sessionModeFile-BKxgNH3P.mjs';
+import { B as BasePermissionHandler } from './BasePermissionHandler-DgtAtJTV.mjs';
+import { T as TitleGenerator } from './titleGenerator-CUG-n2r3.mjs';
+import { w as writeSessionModeFile, n as normalizeAcpPermissionMode, r as removeSessionModeFile } from './sessionModeFile-CSvi4H_t.mjs';
 import { E as EditReportThrottle, e as extractAcpEditPaths } from './editPaths-BVfS_FFL.mjs';
 import 'node:child_process';
 import '@agentclientprotocol/sdk';
-import './time-CVvxdEDh.mjs';
+import './time-CRvAaC5H.mjs';
 import './contentLogMetadata-BlWI0egu.mjs';
-import './package-DQsvY1XN.mjs';
+import './package-tVYgFJoK.mjs';
 import 'chalk';
 import 'node:util';
 import 'node:fs';
@@ -36,48 +36,48 @@ import '@paralleldrive/cuid2';
 import 'zod';
 import 'node:os';
 import 'node:fs/promises';
-import './attachmentLimits-D5pgmASK.mjs';
+import './attachmentLimits-B8nzhw-i.mjs';
 import './resources-BdFBQi8r.mjs';
 import 'axios';
+import './lidState-BbR6y9rq.mjs';
+import 'os';
+import 'child_process';
 import 'node:events';
 import 'socket.io-client';
 import './limits-DIo7rEBR.mjs';
-import './lidState-CigXWxhe.mjs';
-import 'os';
-import 'child_process';
-import './registerCommonHandlers-Ckv5boQI.mjs';
+import './registerCommonHandlers-bSskMveZ.mjs';
 import 'util';
 import 'fs/promises';
 import 'crypto';
 import 'path';
 import 'cross-spawn';
-import './sync-BpLasLu2.mjs';
+import './sync-SCvDzRy6.mjs';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
 import 'tweetnacl';
 import './types-CkqAACXx.mjs';
-import './client-Dk7x-s-O.mjs';
-import './context-BXnxalWW.mjs';
-import './sessionOps-CdwVPSZz.mjs';
-import './tools-_kFe4m_l.mjs';
-import './tools-BA1qkiV1.mjs';
-import './client-DwqHDsLb.mjs';
-import './peerTools-D19hhSQF.mjs';
+import './client-Do5CHQnZ.mjs';
+import './context-BpEYcuLv.mjs';
+import './sessionOps-BlMg1uAa.mjs';
+import './tools-RvMKw7yx.mjs';
+import './tools-gUjkPpCw.mjs';
+import './client-DkoV3VWl.mjs';
+import './peerTools-C1cduHh1.mjs';
 import './ids-DU6sLx4C.mjs';
-import './remoteSessionClient-BMjsbuBh.mjs';
+import './remoteSessionClient-DnCIuZpQ.mjs';
 import '@modelcontextprotocol/sdk/server/mcp.js';
 import 'node:http';
 import '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import './assistantTools-mEz6uNqL.mjs';
+import './assistantTools-BWfAV349.mjs';
 import './terminals-Dlg0x3nY.mjs';
 import './terminalTitleSuggest-CeKsX_V6.mjs';
 import './tmuxSocket-B8Yx20sT.mjs';
-import './bootstrap-BKmsYSwh.mjs';
+import './bootstrap-CTNjn_aj.mjs';
 import './agentGuidance-CQuNlNx8.mjs';
 import './trimIdent-BAjmv_TG.mjs';
 import './previewPath-CXN4Vag0.mjs';
 import './detectCLI-CSGMlV51.mjs';
 import 'fs';
-import './localHappyAgentAuth-CaCyKzYp.mjs';
+import './localHappyAgentAuth-C7rDePjF.mjs';
 import 'url';
 import 'node:module';
 import './oneShotPrompts-DT4p6RNd.mjs';

package/dist/{index-CvXcVQ06.mjs → index-CbF87SeZ.mjs}

@@ -1,4 +1,4 @@
-import { p as packageJson } from './package-DQsvY1XN.mjs';
+import { p as packageJson } from './package-tVYgFJoK.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-7FaZtVu2.mjs');
+    const { selfCheckMain } = await import('./selfCheck-DdT8r263.mjs');
     process.exit(await selfCheckMain({ verbose: isSelfCheckRequest(args) }));
   }
-  const { main } = await import('./main-3fIFXD-t.mjs');
+  const { main } = await import('./main-BQTaUrz0.mjs');
   await main();
 }
 void run(process.argv.slice(2));

package/dist/{index-CZWAiydF.cjs → index-DaTxsAC3.cjs}

@@ -2,14 +2,14 @@
 
 var node_fs = require('node:fs');
 var os = require('node:os');
-var logger = require('./logger-7ucWm9wp.cjs');
-var persistence = require('./persistence-i0nQMLlk.cjs');
+var logger = require('./logger-B1k7eZnq.cjs');
+var persistence = require('./persistence-d3ZyER6o.cjs');
 var loginShellEnv = require('./loginShellEnv-BkuYtExZ.cjs');
 require('chalk');
 require('node:util');
-require('./configuration-UsI0sxEv.cjs');
+require('./configuration-PXAE4-FP.cjs');
 require('node:path');
-require('./package-D1A-8ZJy.cjs');
+require('./package-CC_txQ31.cjs');
 require('node:fs/promises');
 require('zod');
 require('./authRelay-BdYkC1Po.cjs');

package/dist/{index-DJ-oV52i.cjs → index-DqlyNgt4.cjs}

@@ -131,7 +131,12 @@ const sessionTranscriptDropEventSchema = z__namespace.object({
   t: z__namespace.literal("transcript-drop"),
   fromSeq: z__namespace.number().int().nonnegative(),
   toSeq: z__namespace.number().int().nonnegative().optional(),
-  reason: z__namespace.string().min(1).optional()
+  reason: z__namespace.string().min(1).optional(),
+  /**
+   * B-544: the `conversation-rewind` requestId this tombstone answers. The
+   * wrapper keeps a rewind provisional until it sees it; absent from old web.
+   */
+  requestId: z__namespace.string().min(1).optional()
 });
 const sessionEventSchema = z__namespace.discriminatedUnion("t", [
   sessionTextEventSchema,

package/dist/{index-DK2JpTJf.mjs → index-OEGj3BxE.mjs}

@@ -1,14 +1,14 @@
 import { statSync, readdirSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { l as logger } from './logger-CGE4C8ho.mjs';
-import { readSettings } from './persistence-Cw8aLoyL.mjs';
+import { l as logger } from './logger-8dtZPn3n.mjs';
+import { readSettings } from './persistence-C_xFQLsD.mjs';
 import { d as describeAgentHome, C as CLAUDE_CONFIG_DIR_ENV, a as CODEX_HOME_ENV, f as findClaudeConversation, b as agentHomeCandidates, c as findCodexThread, r as resolveAgentHomes, A as AGENT_HOME_ENV_NAMES, g as agentHomeEnv, p as probeLoginShellEnv } from './loginShellEnv-Dw8M7tkI.mjs';
 export { h as claudeConversationPath, i as claudeProjectDirName, j as codexRolloutFileMatches, e as expandHomePath } from './loginShellEnv-Dw8M7tkI.mjs';
 import 'chalk';
 import 'node:util';
-import './configuration-A5gW_0GE.mjs';
+import './configuration-CiBUH72C.mjs';
 import 'node:path';
-import './package-DQsvY1XN.mjs';
+import './package-tVYgFJoK.mjs';
 import 'node:fs/promises';
 import 'zod';
 import './authRelay-DSAvg1uv.mjs';

package/dist/{index-BBg9j0XK.mjs → index-vVWpCoTr.mjs}

@@ -111,7 +111,12 @@ const sessionTranscriptDropEventSchema = z.object({
   t: z.literal("transcript-drop"),
   fromSeq: z.number().int().nonnegative(),
   toSeq: z.number().int().nonnegative().optional(),
-  reason: z.string().min(1).optional()
+  reason: z.string().min(1).optional(),
+  /**
+   * B-544: the `conversation-rewind` requestId this tombstone answers. The
+   * wrapper keeps a rewind provisional until it sees it; absent from old web.
+   */
+  requestId: z.string().min(1).optional()
 });
 const sessionEventSchema = z.discriminatedUnion("t", [
   sessionTextEventSchema,

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-require('./package-D1A-8ZJy.cjs');
-require('./index-DRhWHEuW.cjs');
+require('./package-CC_txQ31.cjs');
+require('./index-B2UvSWo_.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import './package-DQsvY1XN.mjs';
-import './index-CvXcVQ06.mjs';
+import './package-tVYgFJoK.mjs';
+import './index-CbF87SeZ.mjs';
 import 'node:module';
 import 'node:fs';
 import 'node:fs/promises';

package/dist/{install-B2duVo9a.mjs → install-CurvoW2u.mjs}

@@ -1,15 +1,15 @@
-import { l as logger } from './logger-CGE4C8ho.mjs';
+import { l as logger } from './logger-8dtZPn3n.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-A5gW_0GE.mjs';
+import './configuration-CiBUH72C.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-DQsvY1XN.mjs';
+import './package-tVYgFJoK.mjs';
 import 'node:fs/promises';
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/{install-C8WyZI9K.cjs → install-__Mni4NU.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var logger = require('./logger-7ucWm9wp.cjs');
+var logger = require('./logger-B1k7eZnq.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-UsI0sxEv.cjs');
+require('./configuration-PXAE4-FP.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-D1A-8ZJy.cjs');
+require('./package-CC_txQ31.cjs');
 require('node:fs/promises');
 
 const PLIST_LABEL = "com.happy-cli.daemon";

package/dist/lib.cjs

@@ -1,25 +1,25 @@
 'use strict';
 
-var api = require('./api-CQnLOqRS.cjs');
-var logger = require('./logger-7ucWm9wp.cjs');
-var configuration = require('./configuration-UsI0sxEv.cjs');
+var api = require('./api-EKlS0r1w.cjs');
+var logger = require('./logger-B1k7eZnq.cjs');
+var configuration = require('./configuration-PXAE4-FP.cjs');
 var types = require('./types-CRS-srZK.cjs');
 require('axios');
-require('node:events');
-require('socket.io-client');
-require('./attachmentLimits-DzlBPyJP.cjs');
-require('zod');
-require('./index-DJ-oV52i.cjs');
-require('@paralleldrive/cuid2');
+require('./lidState-De2HP6nu.cjs');
 require('./authRelay-BdYkC1Po.cjs');
 require('node:crypto');
 require('tweetnacl');
-require('./limits-C-a7gr04.cjs');
-require('./time-CLwVAz6s.cjs');
-require('./lidState-Ds-6ytZV.cjs');
 require('os');
 require('child_process');
-require('./registerCommonHandlers-CMROPdJz.cjs');
+require('node:events');
+require('socket.io-client');
+require('./attachmentLimits-eJZ4ZBjF.cjs');
+require('zod');
+require('./index-DqlyNgt4.cjs');
+require('@paralleldrive/cuid2');
+require('./limits-C-a7gr04.cjs');
+require('./time-C7BplxuS.cjs');
+require('./registerCommonHandlers-Dausbdsb.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-Dj92ZJ8Y.cjs');
+require('./sync--uxtLWbo.cjs');
 require('./backgroundTaskActivity-CBvUdj39.cjs');
-require('./controlClient-BXktrQ4z.cjs');
-require('./persistence-i0nQMLlk.cjs');
+require('./controlClient-DI-Er-Ww.cjs');
+require('./persistence-d3ZyER6o.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-D1A-8ZJy.cjs');
+require('./package-CC_txQ31.cjs');
 
 
 

package/dist/lib.d.cts

@@ -164,6 +164,7 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
         fromSeq: z.ZodNumber;
         toSeq: z.ZodOptional<z.ZodNumber>;
         reason: z.ZodOptional<z.ZodString>;
+        requestId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "t">;
 }, z.core.$strip>;
 type SessionEnvelope = z.infer<typeof sessionEnvelopeSchema>;
@@ -719,6 +720,33 @@ type Metadata = {
     /** Lineage for sessions created via the fork / duplicate flow. */
     parentSessionId?: string;
     forkedFromMessageId?: string;
+    /**
+     * B-531: written by a fork's wrapper once the server accepted every replayed
+     * history message (capability fork-backfill-ack-v1). `very-happy spawn
+     * --fork --prompt` waits for it before sending, so the prompt cannot get a
+     * seq inside the replay. Absent on non-fork sessions and old wrappers.
+     */
+    forkBackfill?: {
+        done: true;
+        count: number;
+        failed?: boolean;
+        completedAt: number;
+    };
+    /**
+     * B-544: the newest in-place rewind (conversation-rewind with a requestId).
+     * `pending` until the web's transcript-drop tombstone with the same
+     * requestId confirms it; otherwise the wrapper switches back to
+     * `sourceClaudeSessionId` (`reverted`). The web reads `requestId` when the
+     * RPC ack was lost. Plain strings throughout; old web/CLI ignore it.
+     */
+    rewind?: {
+        requestId: string;
+        action: string;
+        sourceClaudeSessionId: string;
+        claudeSessionId: string | null;
+        at: number;
+        state: string;
+    } | null;
     /**
      * B-290: the Claude conversation this session was imported from (the
      * on-disk transcript written by claude CLI / desktop / claude.ai that was
@@ -1169,6 +1197,15 @@ declare class ApiSessionClient extends EventEmitter {
     private fetchMessages;
     private static readonly MAX_OUTBOX_BATCH_SIZE;
     private flushOutbox;
+    /**
+     * B-531: resolve once the server has accepted (POST answered, seq assigned)
+     * every message that was in the outbox when this was called. Messages
+     * enqueued later do not extend the wait. Returns false when the client was
+     * closed first — the caller must not treat that as "committed". Retries are
+     * the outbox's own (InvalidateSync backoff), so a server that keeps failing
+     * keeps this pending rather than resolving early.
+     */
+    drainOutbox(): Promise<boolean>;
     private rememberRoutedInbound;
     private rememberDirectInbound;
     private connectSessionRelay;
@@ -1310,6 +1347,16 @@ declare class ApiSessionClient extends EventEmitter {
      */
     suppressNextArchiveSignal(): void;
     skipExistingMessages(): void;
+    /**
+     * B-544: the newest `limit` session records, decrypted, ascending seq.
+     * Read-only (no routing, no lastSeq change) — rewind reconcile reads the
+     * durable log with it. Undecryptable records come back with `body: null`.
+     */
+    readLogTail(limit: number): Promise<Array<{
+        seq: number;
+        localId: string | null;
+        body: unknown;
+    }>>;
     updateMetadata(handler: (metadata: Metadata) => Metadata): void;
     /**
      * Update session agent state

package/dist/lib.d.mts

@@ -164,6 +164,7 @@ declare const sessionEnvelopeSchema: z.ZodObject<{
         fromSeq: z.ZodNumber;
         toSeq: z.ZodOptional<z.ZodNumber>;
         reason: z.ZodOptional<z.ZodString>;
+        requestId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "t">;
 }, z.core.$strip>;
 type SessionEnvelope = z.infer<typeof sessionEnvelopeSchema>;
@@ -719,6 +720,33 @@ type Metadata = {
     /** Lineage for sessions created via the fork / duplicate flow. */
     parentSessionId?: string;
     forkedFromMessageId?: string;
+    /**
+     * B-531: written by a fork's wrapper once the server accepted every replayed
+     * history message (capability fork-backfill-ack-v1). `very-happy spawn
+     * --fork --prompt` waits for it before sending, so the prompt cannot get a
+     * seq inside the replay. Absent on non-fork sessions and old wrappers.
+     */
+    forkBackfill?: {
+        done: true;
+        count: number;
+        failed?: boolean;
+        completedAt: number;
+    };
+    /**
+     * B-544: the newest in-place rewind (conversation-rewind with a requestId).
+     * `pending` until the web's transcript-drop tombstone with the same
+     * requestId confirms it; otherwise the wrapper switches back to
+     * `sourceClaudeSessionId` (`reverted`). The web reads `requestId` when the
+     * RPC ack was lost. Plain strings throughout; old web/CLI ignore it.
+     */
+    rewind?: {
+        requestId: string;
+        action: string;
+        sourceClaudeSessionId: string;
+        claudeSessionId: string | null;
+        at: number;
+        state: string;
+    } | null;
     /**
      * B-290: the Claude conversation this session was imported from (the
      * on-disk transcript written by claude CLI / desktop / claude.ai that was
@@ -1169,6 +1197,15 @@ declare class ApiSessionClient extends EventEmitter {
     private fetchMessages;
     private static readonly MAX_OUTBOX_BATCH_SIZE;
     private flushOutbox;
+    /**
+     * B-531: resolve once the server has accepted (POST answered, seq assigned)
+     * every message that was in the outbox when this was called. Messages
+     * enqueued later do not extend the wait. Returns false when the client was
+     * closed first — the caller must not treat that as "committed". Retries are
+     * the outbox's own (InvalidateSync backoff), so a server that keeps failing
+     * keeps this pending rather than resolving early.
+     */
+    drainOutbox(): Promise<boolean>;
     private rememberRoutedInbound;
     private rememberDirectInbound;
     private connectSessionRelay;
@@ -1310,6 +1347,16 @@ declare class ApiSessionClient extends EventEmitter {
      */
     suppressNextArchiveSignal(): void;
     skipExistingMessages(): void;
+    /**
+     * B-544: the newest `limit` session records, decrypted, ascending seq.
+     * Read-only (no routing, no lastSeq change) — rewind reconcile reads the
+     * durable log with it. Undecryptable records come back with `body: null`.
+     */
+    readLogTail(limit: number): Promise<Array<{
+        seq: number;
+        localId: string | null;
+        body: unknown;
+    }>>;
     updateMetadata(handler: (metadata: Metadata) => Metadata): void;
     /**
      * Update session agent state

package/dist/lib.mjs

@@ -1,23 +1,23 @@
-export { A as ApiClient, a as ApiSessionClient } from './api-D57dsd6_.mjs';
-export { l as logger } from './logger-CGE4C8ho.mjs';
-export { c as configuration } from './configuration-A5gW_0GE.mjs';
+export { A as ApiClient, a as ApiSessionClient } from './api-Yoh_zKdR.mjs';
+export { l as logger } from './logger-8dtZPn3n.mjs';
+export { c as configuration } from './configuration-CiBUH72C.mjs';
 export { R as RawJSONLinesSchema } from './types-CkqAACXx.mjs';
 import 'axios';
-import 'node:events';
-import 'socket.io-client';
-import './attachmentLimits-D5pgmASK.mjs';
-import 'zod';
-import './index-BBg9j0XK.mjs';
-import '@paralleldrive/cuid2';
+import './lidState-BbR6y9rq.mjs';
 import './authRelay-DSAvg1uv.mjs';
 import 'node:crypto';
 import 'tweetnacl';
-import './limits-DIo7rEBR.mjs';
-import './time-CVvxdEDh.mjs';
-import './lidState-CigXWxhe.mjs';
 import 'os';
 import 'child_process';
-import './registerCommonHandlers-Ckv5boQI.mjs';
+import 'node:events';
+import 'socket.io-client';
+import './attachmentLimits-B8nzhw-i.mjs';
+import 'zod';
+import './index-vVWpCoTr.mjs';
+import '@paralleldrive/cuid2';
+import './limits-DIo7rEBR.mjs';
+import './time-CRvAaC5H.mjs';
+import './registerCommonHandlers-bSskMveZ.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-BpLasLu2.mjs';
+import './sync-SCvDzRy6.mjs';
 import './backgroundTaskActivity-8PdPxrvy.mjs';
-import './controlClient-CYzHrh3e.mjs';
-import './persistence-Cw8aLoyL.mjs';
+import './controlClient-DzmCQrY_.mjs';
+import './persistence-C_xFQLsD.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-DQsvY1XN.mjs';
+import './package-tVYgFJoK.mjs';

package/dist/{lidState-CigXWxhe.mjs → lidState-BbR6y9rq.mjs}

@@ -1,8 +1,72 @@
-import { l as logger } from './logger-CGE4C8ho.mjs';
+import { l as logger } from './logger-8dtZPn3n.mjs';
 import { e as encodeBase64, g as encrypt, h as decrypt, d as decodeBase64 } from './authRelay-DSAvg1uv.mjs';
 import os from 'os';
 import { execSync } from 'child_process';
 
+const CONNECT_PENDING_MAX_MS = 15e3;
+function decideConnect(input) {
+  if (input.connected) return "skip-connected";
+  if (input.pendingSince === null) return "connect";
+  const maxPendingMs = input.maxPendingMs ?? CONNECT_PENDING_MAX_MS;
+  const age = input.now - input.pendingSince;
+  if (age < 0 || age >= maxPendingMs) return "restart";
+  return "skip-pending";
+}
+class SocketConnectGuard {
+  constructor(socket, options = {}) {
+    this.socket = socket;
+    this.options = options;
+    this.now = options.now ?? Date.now;
+    const clear = () => {
+      this.pendingSince = null;
+    };
+    socket.on("connect", clear);
+    socket.on("connect_error", clear);
+    socket.on("disconnect", clear);
+    if (socket.active && !socket.connected) this.pendingSince = this.now();
+  }
+  pendingSince = null;
+  now;
+  connect(reason) {
+    const now = this.now();
+    const decision = decideConnect({
+      connected: this.socket.connected,
+      pendingSince: this.pendingSince,
+      now,
+      maxPendingMs: this.options.maxPendingMs
+    });
+    if (decision === "skip-connected") return decision;
+    if (decision === "skip-pending") {
+      this.options.log?.(`[socket-guard] ${reason}: CONNECT pending ${now - this.pendingSince}ms \u2014 not sending another`);
+      return decision;
+    }
+    if (decision === "restart") {
+      this.options.log?.(`[socket-guard] ${reason}: CONNECT pending ${now - this.pendingSince}ms \u2014 rebuilding the engine connection`);
+      this.pendingSince = null;
+      this.socket.disconnect();
+    }
+    this.pendingSince = now;
+    this.socket.connect();
+    return decision;
+  }
+  /** Test/diagnostic view. */
+  get pendingSinceMs() {
+    return this.pendingSince;
+  }
+}
+const guards = /* @__PURE__ */ new WeakMap();
+function socketConnectGuard(socket, options) {
+  let guard = guards.get(socket);
+  if (!guard) {
+    guard = new SocketConnectGuard(socket, options);
+    guards.set(socket, guard);
+  }
+  return guard;
+}
+function connectGuarded(socket, reason, options) {
+  return socketConnectGuard(socket, options).connect(reason);
+}
+
 function isRateQuotaCode(code) {
   return typeof code === "string" && code.endsWith("_rate_quota_exceeded");
 }
@@ -294,4 +358,4 @@ function shouldReconnect() {
   return true;
 }
 
-export { RpcHandlerManager as R, answerSocketRequest as a, shouldReconnect as b, describeSocketAckDrop as d, isRateQuotaCode as i, pauseForRateQuota as p, safeAck as s };
+export { RpcHandlerManager as R, answerSocketRequest as a, safeAck as b, connectGuarded as c, describeSocketAckDrop as d, shouldReconnect as e, isRateQuotaCode as i, pauseForRateQuota as p, socketConnectGuard as s };