very-happy-cli 0.2.193 → 0.2.195

package/dist/{claudeSessionFork-_GwIlmMB.mjs → claudeSessionFork-HFFwivGY.mjs}

@@ -1,9 +1,9 @@
 import { randomUUID } from 'node:crypto';
-import { copyFile, unlink, readFile, rename, writeFile } from 'node:fs/promises';
+import { unlink, readFile, rename, writeFile } from 'node:fs/promises';
 import { createReadStream, createWriteStream } from 'node:fs';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
-import { l as logger } from './logger-JV7-4Q_6.mjs';
+import { l as logger } from './logger-UgDpJA2u.mjs';
 
 class ForkTruncateUuidNotFoundError extends Error {
   constructor(cutAfterUuid, sourcePath) {
@@ -52,20 +52,109 @@ async function discardForkedSession(projectDir, claudeSessionId) {
   }
 }
 async function forkSession(projectDir, sourceClaudeSessionId) {
-  const newId = randomUUID();
   const src = jsonlPath(projectDir, sourceClaudeSessionId);
-  const dst = jsonlPath(projectDir, newId);
+  const lines = completeLines(await readSource(src));
+  const newId = await writeFork(projectDir, lines);
+  logger.debug(`[CLAUDE FORK] Forked ${sourceClaudeSessionId} -> ${newId}`);
+  return newId;
+}
+async function readSource(src) {
   try {
-    await copyFile(src, dst);
+    return await readFile(src, "utf-8");
   } catch (error) {
-    if (error.code === "ENOENT") {
-      throw new ForkSourceMissingError(src);
-    }
+    if (error.code === "ENOENT") throw new ForkSourceMissingError(src);
+    throw error;
+  }
+}
+async function writeFork(projectDir, lines) {
+  const newId = randomUUID();
+  const destination = jsonlPath(projectDir, newId);
+  const temporary = `${destination}.tmp-${process.pid}`;
+  try {
+    await writeFile(temporary, lines.length > 0 ? lines.join("\n") + "\n" : "", { encoding: "utf-8", flag: "wx" });
+    await rename(temporary, destination);
+  } catch (error) {
+    await unlink(temporary).catch(() => void 0);
     throw error;
   }
-  logger.debug(`[CLAUDE FORK] Forked ${sourceClaudeSessionId} -> ${newId}`);
   return newId;
 }
+function completeLines(raw) {
+  const lines = raw.split("\n");
+  const tail = lines.pop() ?? "";
+  if (tail.trim()) {
+    try {
+      JSON.parse(tail);
+      lines.push(tail);
+    } catch {
+    }
+  }
+  return lines.filter((line) => line.length > 0);
+}
+const INTERRUPTED_PROMPT = /^\[Request interrupted by user(?: for tool use)?\]$/i;
+const LOCAL_COMMAND_OUTPUT = /^<local-command-(?:stdout|stderr)>/;
+const CONTINUING_STOPS = /* @__PURE__ */ new Set(["tool_use", "pause_turn"]);
+function endsTurn(entry) {
+  if (!entry || entry.isSidechain) return false;
+  if (entry.type === "assistant") {
+    const stop = entry.message?.stop_reason;
+    return typeof stop === "string" && !CONTINUING_STOPS.has(stop);
+  }
+  if (entry.type === "system" && entry.subtype === "compact_boundary") return true;
+  if (entry.type === "user" && entry.isCompactSummary) return true;
+  const text = userPromptText(entry)?.trim();
+  return text !== void 0 && (INTERRUPTED_PROMPT.test(text) || LOCAL_COMMAND_OUTPUT.test(text));
+}
+function findUnfinishedTurn(lines) {
+  let start = -1;
+  const prompts = [];
+  for (let i = lines.length - 1; i >= 0; i--) {
+    let entry;
+    try {
+      entry = JSON.parse(lines[i]);
+    } catch {
+      continue;
+    }
+    if (endsTurn(entry)) break;
+    const text = userPromptText(entry);
+    if (text === null || typeof entry.uuid !== "string") continue;
+    start = i;
+    prompts.unshift(text);
+  }
+  return start < 0 ? null : { start, prompts };
+}
+function conversationOf(lines) {
+  let conversation = false;
+  let prompt = false;
+  for (const line of lines) {
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (entry?.isSidechain || entry?.isMeta || entry?.isSynthetic || entry?.type !== "user" && entry?.type !== "assistant") continue;
+    conversation = true;
+    const content = entry.message?.content;
+    if (entry.type === "user" && (typeof content === "string" || Array.isArray(content) && content.length > 0 && !content.some((block) => block?.type === "tool_result"))) {
+      prompt = true;
+    }
+  }
+  return { conversation, prompt };
+}
+async function forkCompletedTurns(projectDir, sourceClaudeSessionId) {
+  const src = jsonlPath(projectDir, sourceClaudeSessionId);
+  const lines = completeLines(await readSource(src));
+  const unfinished = findUnfinishedTurn(lines);
+  const kept = unfinished ? lines.slice(0, unfinished.start) : lines;
+  const excludedPrompts = unfinished?.prompts ?? [];
+  const history = conversationOf(kept);
+  if (!history.conversation) return { startFresh: true, excludedPrompts };
+  if (!history.prompt) throw new Error("Cannot safely fork: earlier history has no user prompt");
+  const newClaudeSessionId = await writeFork(projectDir, kept);
+  logger.debug(`[CLAUDE FORK] Forked completed turns of ${sourceClaudeSessionId} -> ${newClaudeSessionId} (${excludedPrompts.length} prompt(s) left out)`);
+  return { newClaudeSessionId, excludedPrompts };
+}
 async function forkAndTruncateSession(projectDir, sourceClaudeSessionId, cutAfterUuid) {
   const newId = randomUUID();
   const src = jsonlPath(projectDir, sourceClaudeSessionId);
@@ -156,16 +245,7 @@ async function listClaudeRewindPoints(projectDir, claudeSessionId) {
 }
 async function forkBeforeUserMessage(projectDir, sourceClaudeSessionId, cutBeforeUuid) {
   const src = jsonlPath(projectDir, sourceClaudeSessionId);
-  let raw;
-  try {
-    raw = await readFile(src, "utf-8");
-  } catch (error) {
-    if (error.code === "ENOENT") throw new ForkSourceMissingError(src);
-    throw error;
-  }
-  const lines = raw.split("\n");
-  let hasPreviousConversation = false;
-  let hasPreviousPrompt = false;
+  const lines = completeLines(await readSource(src));
   let cut = -1;
   for (let i = 0; i < lines.length; i++) {
     let entry;
@@ -179,28 +259,13 @@ async function forkBeforeUserMessage(projectDir, sourceClaudeSessionId, cutBefor
       cut = i;
       break;
     }
-    if (!entry?.isSidechain && !entry?.isMeta && !entry?.isSynthetic && (entry?.type === "user" || entry?.type === "assistant")) {
-      hasPreviousConversation = true;
-      const content = entry.message?.content;
-      if (entry.type === "user" && (typeof content === "string" || Array.isArray(content) && content.length > 0 && !content.some((block) => block?.type === "tool_result"))) {
-        hasPreviousPrompt = true;
-      }
-    }
   }
   if (cut < 0) throw new ForkTruncateUuidNotFoundError(cutBeforeUuid, src);
-  if (!hasPreviousConversation) return null;
-  if (!hasPreviousPrompt) throw new Error("Cannot safely rewind: earlier history has no user prompt");
-  const newId = randomUUID();
-  const destination = jsonlPath(projectDir, newId);
-  const temporary = `${destination}.tmp-${process.pid}`;
-  try {
-    await writeFile(temporary, lines.slice(0, cut).join("\n") + "\n", { encoding: "utf-8", flag: "wx" });
-    await rename(temporary, destination);
-  } catch (error) {
-    await unlink(temporary).catch(() => void 0);
-    throw error;
-  }
-  return newId;
+  const kept = lines.slice(0, cut);
+  const history = conversationOf(kept);
+  if (!history.conversation) return null;
+  if (!history.prompt) throw new Error("Cannot safely rewind: earlier history has no user prompt");
+  return writeFork(projectDir, kept);
 }
 
-export { ForkSourceMissingError as F, forkAndTruncateSession as a, ForkTruncateUuidNotFoundError as b, forkBeforeUserMessage as c, discardForkedSession as d, forkSession as f, listClaudeRewindPoints as l };
+export { ForkSourceMissingError as F, forkCompletedTurns as a, forkAndTruncateSession as b, ForkTruncateUuidNotFoundError as c, discardForkedSession as d, forkBeforeUserMessage as e, forkSession as f, listClaudeRewindPoints as l };

package/dist/{client-DwbhrX6D.mjs → client-BhAjEv8Z.mjs}

@@ -2,10 +2,10 @@ import { randomUUID } from 'node:crypto';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { basename, dirname } from 'node:path';
-import { f as isInsideTeamWorktree, g as rebaseTeamWorktreePath } from './index-D1YnIih6.mjs';
-import { c as configuration } from './configuration-ThKBP_zY.mjs';
-import { r as readSettings, c as readPersistedSessions, b as readCredentialsForConfiguredRelay } from './persistence-Cg4sfjQV.mjs';
-import { r as readTeamScope, t as teamScopePath, w as writeTeamScope } from './context-C0EFLnOg.mjs';
+import { f as isInsideTeamWorktree, g as rebaseTeamWorktreePath } from './index-BlWyEpMw.mjs';
+import { c as configuration } from './configuration-CwfgJZKs.mjs';
+import { r as readSettings, c as readPersistedSessions, b as readCredentialsForConfiguredRelay } from './persistence-CQhmtobL.mjs';
+import { r as readTeamScope, t as teamScopePath, w as writeTeamScope } from './context-DcOpvIiR.mjs';
 
 async function teamRequest(path, method, token, scoped, body) {
   const response = await fetch(`${configuration.serverUrl}${path}`, {

package/dist/{client-D2GWkd-T.cjs → client-BlV73Gbw.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var configuration = require('./configuration-BBK0rmmj.cjs');
-var persistence = require('./persistence-CsmAgN-C.cjs');
+var configuration = require('./configuration-CKaq0tNe.cjs');
+var persistence = require('./persistence-DBmeYlwT.cjs');
 
 class AutomationsRequestError extends Error {
   constructor(status, code, runStatus, invalidFields = []) {

package/dist/{client-Bde4QVIn.mjs → client-CydHzidF.mjs}

@@ -1,5 +1,5 @@
-import { c as configuration } from './configuration-ThKBP_zY.mjs';
-import { b as readCredentialsForConfiguredRelay } from './persistence-Cg4sfjQV.mjs';
+import { c as configuration } from './configuration-CwfgJZKs.mjs';
+import { b as readCredentialsForConfiguredRelay } from './persistence-CQhmtobL.mjs';
 
 const UNSUPPORTED_BACKOFF_MS = 10 * 6e4;
 class ProjectsUnsupportedError extends Error {

package/dist/{client-CJr8Pjwm.cjs → client-DcXLNaF2.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var configuration = require('./configuration-BBK0rmmj.cjs');
-var persistence = require('./persistence-CsmAgN-C.cjs');
+var configuration = require('./configuration-CKaq0tNe.cjs');
+var persistence = require('./persistence-DBmeYlwT.cjs');
 
 const UNSUPPORTED_BACKOFF_MS = 10 * 6e4;
 class ProjectsUnsupportedError extends Error {

package/dist/{client-7RnI9J0W.mjs → client-DpTk1S7C.mjs}

@@ -1,5 +1,5 @@
-import { c as configuration } from './configuration-ThKBP_zY.mjs';
-import { b as readCredentialsForConfiguredRelay, r as readSettings } from './persistence-Cg4sfjQV.mjs';
+import { c as configuration } from './configuration-CwfgJZKs.mjs';
+import { b as readCredentialsForConfiguredRelay, r as readSettings } from './persistence-CQhmtobL.mjs';
 
 class AutomationsRequestError extends Error {
   constructor(status, code, runStatus, invalidFields = []) {

package/dist/{client-DLlnmAPL.cjs → client-DxjYsJ8d.cjs}

@@ -4,10 +4,10 @@ var node_crypto = require('node:crypto');
 var node_child_process = require('node:child_process');
 var node_util = require('node:util');
 var path = require('node:path');
-var index = require('./index-BUFrKZeQ.cjs');
-var configuration = require('./configuration-BBK0rmmj.cjs');
-var persistence = require('./persistence-CsmAgN-C.cjs');
-var context = require('./context-wDp0aZBK.cjs');
+var index = require('./index-D9Hidq-g.cjs');
+var configuration = require('./configuration-CKaq0tNe.cjs');
+var persistence = require('./persistence-DBmeYlwT.cjs');
+var context = require('./context-DbENnaVc.cjs');
 
 async function teamRequest(path, method, token, scoped, body) {
   const response = await fetch(`${configuration.configuration.serverUrl}${path}`, {

package/dist/codex/happyMcpStdioBridge.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var tools = require('../tools-CcebYtLj.cjs');
-var reportProgressTool = require('../reportProgressTool-Ddg1yVq2.cjs');
-var peerTools = require('../peerTools-D-VNNFw-.cjs');
+var tools = require('../tools-B3KGMSU5.cjs');
+var reportProgressTool = require('../reportProgressTool-CIHGKraF.cjs');
+var peerTools = require('../peerTools-BXSjS8lB.cjs');
 var agentGuidance = require('../agentGuidance-BtBx2xxE.cjs');
 var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 var stdio_js = require('@modelcontextprotocol/sdk/server/stdio.js');
@@ -10,37 +10,37 @@ var index_js = require('@modelcontextprotocol/sdk/client/index.js');
 var streamableHttp_js = require('@modelcontextprotocol/sdk/client/streamableHttp.js');
 var z = require('zod');
 var limits = require('../limits-C-a7gr04.cjs');
-require('../client-DLlnmAPL.cjs');
+require('../client-DxjYsJ8d.cjs');
 require('node:crypto');
 require('node:child_process');
 require('node:util');
 require('node:path');
-require('../index-BUFrKZeQ.cjs');
+require('../index-D9Hidq-g.cjs');
 require('@paralleldrive/cuid2');
-require('../configuration-BBK0rmmj.cjs');
+require('../configuration-CKaq0tNe.cjs');
 require('node:fs');
 require('node:os');
-require('../package-uzlvxa5S.cjs');
+require('../package-B61-BBlh.cjs');
 require('node:fs/promises');
-require('../persistence-CsmAgN-C.cjs');
+require('../persistence-DBmeYlwT.cjs');
 require('../authRelay-Dy1qU9td.cjs');
 require('tweetnacl');
-require('../logger-CX3x2eI4.cjs');
+require('../logger-BZ5TcbEh.cjs');
 require('chalk');
-require('../context-wDp0aZBK.cjs');
-require('../client-D2GWkd-T.cjs');
+require('../context-DbENnaVc.cjs');
+require('../client-BlV73Gbw.cjs');
 require('../precheckCompat-CWOi5c9L.cjs');
-require('../client-CJr8Pjwm.cjs');
+require('../client-DcXLNaF2.cjs');
 require('../prompt-Bof2aQkI.cjs');
 require('../ids-B6ZC0HGt.cjs');
-require('../controlClient-DwWTns3A.cjs');
-require('../sessionOps-XSEjIqNq.cjs');
+require('../controlClient-D_HIbnnS.cjs');
+require('../sessionOps-74pSDXoS.cjs');
 require('axios');
-require('../time-BTLcO8jp.cjs');
+require('../time-BPPTQ_sE.cjs');
 require('../specialCommands-J3JFOq0J.cjs');
 require('socket.io-client');
 require('../backgroundTaskActivity-CBvUdj39.cjs');
-require('../remoteSessionClient-CcSP24Zq.cjs');
+require('../remoteSessionClient-D6_7vNKc.cjs');
 require('../trimIdent-4gvk9Wk6.cjs');
 
 function parseArgs(argv) {

package/dist/codex/happyMcpStdioBridge.mjs

@@ -1,6 +1,6 @@
-import { r as registerTeamsTools } from '../tools-BR-drXZ8.mjs';
-import { r as registerAutomationTools, a as registerProjectTools, b as registerReportProgressTool } from '../reportProgressTool-DVru7jc_.mjs';
-import { r as registerSessionPeerTools } from '../peerTools-WtRgTSqG.mjs';
+import { r as registerTeamsTools } from '../tools-DqjPHq9I.mjs';
+import { r as registerAutomationTools, a as registerProjectTools, b as registerReportProgressTool } from '../reportProgressTool-HjzV5y_2.mjs';
+import { r as registerSessionPeerTools } from '../peerTools-DS6GqJcn.mjs';
 import { P as PREVIEW_TOOL_NAME, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION, c as PREVIEW_DOWNLOAD_PARAM_DESCRIPTION, R as REPORT_PROGRESS_TOOL_NAME } from '../agentGuidance-BDYt2Qy2.mjs';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -8,37 +8,37 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import { z } from 'zod';
 import { C as CLIPBOARD_TOOL_NAME, a as CLIPBOARD_TOOL_TITLE, b as CLIPBOARD_TOOL_DESCRIPTION } from '../limits-DIo7rEBR.mjs';
-import '../client-DwbhrX6D.mjs';
+import '../client-BhAjEv8Z.mjs';
 import 'node:crypto';
 import 'node:child_process';
 import 'node:util';
 import 'node:path';
-import '../index-D1YnIih6.mjs';
+import '../index-BlWyEpMw.mjs';
 import '@paralleldrive/cuid2';
-import '../configuration-ThKBP_zY.mjs';
+import '../configuration-CwfgJZKs.mjs';
 import 'node:fs';
 import 'node:os';
-import '../package-Bw3H6VLn.mjs';
+import '../package-C4OfB2YF.mjs';
 import 'node:fs/promises';
-import '../persistence-Cg4sfjQV.mjs';
+import '../persistence-CQhmtobL.mjs';
 import '../authRelay-DhQhkBvX.mjs';
 import 'tweetnacl';
-import '../logger-JV7-4Q_6.mjs';
+import '../logger-UgDpJA2u.mjs';
 import 'chalk';
-import '../context-C0EFLnOg.mjs';
-import '../client-7RnI9J0W.mjs';
+import '../context-DcOpvIiR.mjs';
+import '../client-DpTk1S7C.mjs';
 import '../precheckCompat-DeEbilbr.mjs';
-import '../client-Bde4QVIn.mjs';
+import '../client-CydHzidF.mjs';
 import '../prompt-QHuFx9j6.mjs';
 import '../ids-DU6sLx4C.mjs';
-import '../controlClient-Ckl8N1MS.mjs';
-import '../sessionOps-C65Iej_C.mjs';
+import '../controlClient-Dv6IvvUq.mjs';
+import '../sessionOps-BkEgNA2O.mjs';
 import 'axios';
-import '../time-Cw0liIqB.mjs';
+import '../time-CIkdLyza.mjs';
 import '../specialCommands-MXUN0wfI.mjs';
 import 'socket.io-client';
 import '../backgroundTaskActivity-8PdPxrvy.mjs';
-import '../remoteSessionClient--0vfA7I5.mjs';
+import '../remoteSessionClient-DQSnC7ox.mjs';
 import '../trimIdent-BAjmv_TG.mjs';
 
 function parseArgs(argv) {

package/dist/{codexAccount-NOX5pmQf.mjs → codexAccount-CKXpXq0B.mjs}

@@ -1,7 +1,7 @@
 import { readFileSync, renameSync, rmSync, symlinkSync, mkdirSync, lstatSync, readlinkSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
-import { l as accountCodexHomePath, b as accountSecretPath, e as expandHome } from './store-Vej_738f.mjs';
+import { l as accountCodexHomePath, b as accountSecretPath, e as expandHome } from './store-Tf-r1ouq.mjs';
 
 /*!
  * Copyright (c) Squirrel Chat et al., All rights reserved.

package/dist/{codexAccount-BDQjRbtI.cjs → codexAccount-CYhQir50.cjs}

@@ -3,7 +3,7 @@
 var node_fs = require('node:fs');
 var path = require('node:path');
 var os = require('node:os');
-var store = require('./store-CkNa6oj4.cjs');
+var store = require('./store-aa3CVNwS.cjs');
 
 /*!
  * Copyright (c) Squirrel Chat et al., All rights reserved.

package/dist/{codexAppServerClient-DWEsZUC4.cjs → codexAppServerClient-C1xBSuVk.cjs}

@@ -3,11 +3,11 @@
 var node_child_process = require('node:child_process');
 var spawn = require('cross-spawn');
 var node_readline = require('node:readline');
-var logger = require('./logger-CX3x2eI4.cjs');
+var logger = require('./logger-BZ5TcbEh.cjs');
 var contentLogMetadata = require('./contentLogMetadata-ZSFk_NjQ.cjs');
 var manager = require('./manager-HrEj442o.cjs');
-var _package = require('./package-uzlvxa5S.cjs');
-var rateLimitWindows = require('./rateLimitWindows-BZl6GMwQ.cjs');
+var _package = require('./package-B61-BBlh.cjs');
+var rateLimitWindows = require('./rateLimitWindows-BIfLMxOk.cjs');
 var processTree = require('./processTree-CMHWlVse.cjs');
 
 const CODEX_HELPER_LABEL_MAX_CHARS = 80;
@@ -191,6 +191,7 @@ class CodexAppServerClient {
   static MAX_CHILD_LABELS = 128;
   // Handlers set by the consumer (runCodex.ts)
   eventHandler = null;
+  rawNotificationListeners = /* @__PURE__ */ new Set();
   approvalHandler = null;
   // B-555: subscription rate-limit snapshots (sparse notifications + throttled reads).
   rateLimitHandler = null;
@@ -868,6 +869,55 @@ ${text}`.slice(-400);
     };
     return await this.request("thread/inject_items", params);
   }
+  // ─── B-861 side questions ───────────────────────────────────
+  // A side client (its own app-server process) drives a throwaway thread
+  // with these; none of them touch `_threadId` / `_turnId`, so the client's
+  // turn tracking and reconnect-resume stay out of it.
+  /** Every app-server notification, raw. Returns the unsubscribe. */
+  onRawNotification(listener) {
+    this.rawNotificationListeners.add(listener);
+    return () => {
+      this.rawNotificationListeners.delete(listener);
+    };
+  }
+  /**
+   * An ephemeral (never persisted) thread for one side question. With
+   * `sourceThreadId`: `thread/fork` of the main thread — Codex 0.154 forks a
+   * running thread from a second app-server with the turn in flight as
+   * `interrupted`, and writes nothing to the source rollout
+   * (vh-team-B-861/codex-probe1.log). `excludeTurns` is required for an
+   * ephemeral fork of a paginated thread. Read-only sandbox, approval never.
+   */
+  async openSideThread(opts) {
+    await this.ensureConnected();
+    const common = {
+      model: opts.model ?? null,
+      modelProvider: this.accountOverrides.modelProvider ?? null,
+      cwd: opts.cwd,
+      approvalPolicy: "never",
+      sandbox: "read-only",
+      config: { ...this.accountOverrides.config, "features.hooks": false },
+      baseInstructions: null,
+      developerInstructions: opts.developerInstructions,
+      ephemeral: true,
+      persistExtendedHistory: false
+    };
+    const result = opts.sourceThreadId ? await this.request("thread/fork", { ...common, threadId: opts.sourceThreadId, excludeTurns: true, threadSource: null }) : await this.request("thread/start", { ...common, profile: null, compactPrompt: null, includeApplyPatchTool: false, experimentalRawEvents: false });
+    return { threadId: result.thread.id };
+  }
+  /** `turn/start` on a side thread; resolves with the turn id once accepted. */
+  async startSideTurn(threadId, text) {
+    const result = await this.request("turn/start", {
+      threadId,
+      input: [{ type: "text", text }],
+      approvalPolicy: "never",
+      sandboxPolicy: { type: "readOnly" }
+    });
+    return typeof result?.turn?.id === "string" ? result.turn.id : null;
+  }
+  async interruptSideTurn(threadId, turnId) {
+    await this.request("turn/interrupt", { threadId, turnId });
+  }
   async reconnectAndResumeThread() {
     const threadId = this._threadId;
     await this.disconnectInternal({ preserveThreadState: !!threadId });
@@ -1505,6 +1555,13 @@ ${text}`.slice(-400);
   }
   handleNotification(method, params) {
     this.touchTurnWatchdog();
+    for (const listener of this.rawNotificationListeners) {
+      try {
+        listener(method, params);
+      } catch (error) {
+        logger.logger.debug("[CodexAppServer] raw notification listener failed", contentLogMetadata.errorLogMetadata(error));
+      }
+    }
     if (method === "codex/event" || method.startsWith("codex/event/")) {
       this.notificationProtocol = "legacy";
       const msg = params?.msg;

package/dist/{codexAppServerClient-B3QJV6Ey.mjs → codexAppServerClient-mln0W8vT.mjs}

@@ -1,11 +1,11 @@
 import { execSync } from 'node:child_process';
 import { spawn } from 'cross-spawn';
 import { createInterface } from 'node:readline';
-import { l as logger } from './logger-JV7-4Q_6.mjs';
+import { l as logger } from './logger-UgDpJA2u.mjs';
 import { e as errorLogMetadata, c as contentLogMetadata } from './contentLogMetadata-BlWI0egu.mjs';
 import { i as initializeSandbox, w as wrapForMcpTransport } from './manager-BEsI4qt3.mjs';
-import { p as packageJson } from './package-Bw3H6VLn.mjs';
-import { s as shouldReadCodexRateLimits, i as isUnsupportedCodexMethodError } from './rateLimitWindows-CRARnKaI.mjs';
+import { p as packageJson } from './package-C4OfB2YF.mjs';
+import { s as shouldReadCodexRateLimits, i as isUnsupportedCodexMethodError } from './rateLimitWindows-8-khalzj.mjs';
 import { s as stopProcessGracefully, k as killProcessTree } from './processTree-CP5IvQ2Z.mjs';
 
 const CODEX_HELPER_LABEL_MAX_CHARS = 80;
@@ -189,6 +189,7 @@ class CodexAppServerClient {
   static MAX_CHILD_LABELS = 128;
   // Handlers set by the consumer (runCodex.ts)
   eventHandler = null;
+  rawNotificationListeners = /* @__PURE__ */ new Set();
   approvalHandler = null;
   // B-555: subscription rate-limit snapshots (sparse notifications + throttled reads).
   rateLimitHandler = null;
@@ -866,6 +867,55 @@ ${text}`.slice(-400);
     };
     return await this.request("thread/inject_items", params);
   }
+  // ─── B-861 side questions ───────────────────────────────────
+  // A side client (its own app-server process) drives a throwaway thread
+  // with these; none of them touch `_threadId` / `_turnId`, so the client's
+  // turn tracking and reconnect-resume stay out of it.
+  /** Every app-server notification, raw. Returns the unsubscribe. */
+  onRawNotification(listener) {
+    this.rawNotificationListeners.add(listener);
+    return () => {
+      this.rawNotificationListeners.delete(listener);
+    };
+  }
+  /**
+   * An ephemeral (never persisted) thread for one side question. With
+   * `sourceThreadId`: `thread/fork` of the main thread — Codex 0.154 forks a
+   * running thread from a second app-server with the turn in flight as
+   * `interrupted`, and writes nothing to the source rollout
+   * (vh-team-B-861/codex-probe1.log). `excludeTurns` is required for an
+   * ephemeral fork of a paginated thread. Read-only sandbox, approval never.
+   */
+  async openSideThread(opts) {
+    await this.ensureConnected();
+    const common = {
+      model: opts.model ?? null,
+      modelProvider: this.accountOverrides.modelProvider ?? null,
+      cwd: opts.cwd,
+      approvalPolicy: "never",
+      sandbox: "read-only",
+      config: { ...this.accountOverrides.config, "features.hooks": false },
+      baseInstructions: null,
+      developerInstructions: opts.developerInstructions,
+      ephemeral: true,
+      persistExtendedHistory: false
+    };
+    const result = opts.sourceThreadId ? await this.request("thread/fork", { ...common, threadId: opts.sourceThreadId, excludeTurns: true, threadSource: null }) : await this.request("thread/start", { ...common, profile: null, compactPrompt: null, includeApplyPatchTool: false, experimentalRawEvents: false });
+    return { threadId: result.thread.id };
+  }
+  /** `turn/start` on a side thread; resolves with the turn id once accepted. */
+  async startSideTurn(threadId, text) {
+    const result = await this.request("turn/start", {
+      threadId,
+      input: [{ type: "text", text }],
+      approvalPolicy: "never",
+      sandboxPolicy: { type: "readOnly" }
+    });
+    return typeof result?.turn?.id === "string" ? result.turn.id : null;
+  }
+  async interruptSideTurn(threadId, turnId) {
+    await this.request("turn/interrupt", { threadId, turnId });
+  }
   async reconnectAndResumeThread() {
     const threadId = this._threadId;
     await this.disconnectInternal({ preserveThreadState: !!threadId });
@@ -1503,6 +1553,13 @@ ${text}`.slice(-400);
   }
   handleNotification(method, params) {
     this.touchTurnWatchdog();
+    for (const listener of this.rawNotificationListeners) {
+      try {
+        listener(method, params);
+      } catch (error) {
+        logger.debug("[CodexAppServer] raw notification listener failed", errorLogMetadata(error));
+      }
+    }
     if (method === "codex/event" || method.startsWith("codex/event/")) {
       this.notificationProtocol = "legacy";
       const msg = params?.msg;