very-happy-cli 0.2.136 → 0.2.138

package/dist/{send-DP6n2J9x.cjs → send-BkypdBpK.cjs}

@@ -3,15 +3,15 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var persistence = require('./limits-DRrdJ7gr.cjs');
-var index = require('./index-8bwU9d-4.cjs');
+var persistence = require('./limits-CfzVummd.cjs');
+var index = require('./index-CRRK5P1r.cjs');
 require('node:fs/promises');
 require('node:os');
 require('zod');
 require('node:crypto');
 require('tweetnacl');
 require('node:util');
-require('./types-DbBPNIwf.cjs');
+require('./types-CRxf_3n8.cjs');
 require('axios');
 require('node:events');
 require('socket.io-client');
@@ -30,7 +30,7 @@ require('fs');
 require('node:readline');
 require('@anthropic-ai/sandbox-runtime');
 require('expo-server-sdk');
-require('./agentGuidance-6yh_wPwD.cjs');
+require('./agentGuidance-4HV-BOge.cjs');
 require('ink');
 require('react');
 require('@anthropic-ai/claude-agent-sdk');

package/dist/{send-BHquPaeG.mjs → send-snK_NGAA.mjs}

@@ -1,15 +1,15 @@
 import chalk from 'chalk';
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { r as readPersistedSessions, c as configuration } from './limits-kjHZUlSp.mjs';
-import { d as sendUserMessage, a as sessionWebUrl } from './index-CHI7iTa0.mjs';
+import { r as readPersistedSessions, c as configuration } from './limits-DEsg_gHi.mjs';
+import { d as sendUserMessage, a as sessionWebUrl } from './index-Dbl5U_N0.mjs';
 import 'node:fs/promises';
 import 'node:os';
 import 'zod';
 import 'node:crypto';
 import 'tweetnacl';
 import 'node:util';
-import './types-BKrZubg8.mjs';
+import './types-D5EsIAOe.mjs';
 import 'axios';
 import 'node:events';
 import 'socket.io-client';
@@ -28,7 +28,7 @@ import 'fs';
 import 'node:readline';
 import '@anthropic-ai/sandbox-runtime';
 import 'expo-server-sdk';
-import './agentGuidance-ASxKHxBP.mjs';
+import './agentGuidance-WHZsBKpm.mjs';
 import 'ink';
 import 'react';
 import '@anthropic-ai/claude-agent-sdk';

package/dist/{sessions-Q4BR02dG.cjs → sessions-9A-uoJL_.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
 var chalk = require('chalk');
-var index = require('./index-8bwU9d-4.cjs');
-var api = require('./types-DbBPNIwf.cjs');
+var index = require('./index-CRRK5P1r.cjs');
+var api = require('./types-CRxf_3n8.cjs');
 require('node:os');
 require('node:crypto');
-require('./limits-DRrdJ7gr.cjs');
+require('./limits-CfzVummd.cjs');
 require('node:fs/promises');
 require('node:fs');
 require('node:path');
@@ -14,7 +14,7 @@ require('tweetnacl');
 require('node:util');
 require('cross-spawn');
 require('node:readline');
-require('./agentGuidance-6yh_wPwD.cjs');
+require('./agentGuidance-4HV-BOge.cjs');
 require('fs/promises');
 require('ink');
 require('react');

package/dist/{sessions-BtrLzv5U.mjs → sessions-DxlC4C4g.mjs}

@@ -1,9 +1,9 @@
 import chalk from 'chalk';
-import { D as DEFAULT_RECENT_LIMIT, M as MAX_READ_LIMIT, l as listAccountSessions, e as listSessions, r as readSessionTranscript, f as stopSession, g as resolvePermissionRequest, h as archiveSession } from './index-CHI7iTa0.mjs';
-import { i as isValidSessionId } from './types-BKrZubg8.mjs';
+import { D as DEFAULT_RECENT_LIMIT, M as MAX_READ_LIMIT, l as listAccountSessions, e as listSessions, r as readSessionTranscript, f as stopSession, g as resolvePermissionRequest, h as archiveSession } from './index-Dbl5U_N0.mjs';
+import { i as isValidSessionId } from './types-D5EsIAOe.mjs';
 import 'node:os';
 import 'node:crypto';
-import './limits-kjHZUlSp.mjs';
+import './limits-DEsg_gHi.mjs';
 import 'node:fs/promises';
 import 'node:fs';
 import 'node:path';
@@ -12,7 +12,7 @@ import 'tweetnacl';
 import 'node:util';
 import 'cross-spawn';
 import 'node:readline';
-import './agentGuidance-ASxKHxBP.mjs';
+import './agentGuidance-WHZsBKpm.mjs';
 import 'fs/promises';
 import 'ink';
 import 'react';

package/dist/{spawn-CMjhlwlD.cjs → spawn-BORLpj60.cjs}

@@ -3,11 +3,11 @@
 var chalk = require('chalk');
 var node_fs = require('node:fs');
 var path = require('node:path');
-var index = require('./index-8bwU9d-4.cjs');
-var persistence = require('./limits-DRrdJ7gr.cjs');
+var index = require('./index-CRRK5P1r.cjs');
+var persistence = require('./limits-CfzVummd.cjs');
 require('node:os');
 require('node:crypto');
-require('./types-DbBPNIwf.cjs');
+require('./types-CRxf_3n8.cjs');
 require('axios');
 require('node:events');
 require('socket.io-client');
@@ -29,7 +29,7 @@ require('tweetnacl');
 require('node:readline');
 require('@anthropic-ai/sandbox-runtime');
 require('expo-server-sdk');
-require('./agentGuidance-6yh_wPwD.cjs');
+require('./agentGuidance-4HV-BOge.cjs');
 require('ink');
 require('react');
 require('@anthropic-ai/claude-agent-sdk');

package/dist/{spawn-DuQXydqI.mjs → spawn-DFfHCafP.mjs}

@@ -1,11 +1,11 @@
 import chalk from 'chalk';
 import { readFileSync, statSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { c as checkIfDaemonRunningAndCleanupStaleState, s as spawnDaemonSession, a as sessionWebUrl, i as isValidSpawnOrigin, b as sanitizeSpawnPermissionMode, A as ALLOWED_SPAWN_PERMISSION_MODES, S as SPAWN_AGENTS, w as waitForSessionKey, d as sendUserMessage } from './index-CHI7iTa0.mjs';
-import { l as logger } from './limits-kjHZUlSp.mjs';
+import { c as checkIfDaemonRunningAndCleanupStaleState, s as spawnDaemonSession, a as sessionWebUrl, i as isValidSpawnOrigin, b as sanitizeSpawnPermissionMode, A as ALLOWED_SPAWN_PERMISSION_MODES, S as SPAWN_AGENTS, w as waitForSessionKey, d as sendUserMessage } from './index-Dbl5U_N0.mjs';
+import { l as logger } from './limits-DEsg_gHi.mjs';
 import 'node:os';
 import 'node:crypto';
-import './types-BKrZubg8.mjs';
+import './types-D5EsIAOe.mjs';
 import 'axios';
 import 'node:events';
 import 'socket.io-client';
@@ -27,7 +27,7 @@ import 'tweetnacl';
 import 'node:readline';
 import '@anthropic-ai/sandbox-runtime';
 import 'expo-server-sdk';
-import './agentGuidance-ASxKHxBP.mjs';
+import './agentGuidance-WHZsBKpm.mjs';
 import 'ink';
 import 'react';
 import '@anthropic-ai/claude-agent-sdk';

package/dist/{teams-CkdUH10-.cjs → teams-9x2FO9RW.cjs}

@@ -4,15 +4,15 @@ var os = require('node:os');
 var promises = require('node:fs/promises');
 var z = require('zod');
 var node_crypto = require('node:crypto');
-var agentGuidance = require('./agentGuidance-6yh_wPwD.cjs');
-var persistence = require('./limits-DRrdJ7gr.cjs');
+var agentGuidance = require('./agentGuidance-4HV-BOge.cjs');
+var persistence = require('./limits-CfzVummd.cjs');
 var path = require('node:path');
-var index = require('./index-8bwU9d-4.cjs');
+var index = require('./index-CRRK5P1r.cjs');
 require('node:fs');
 require('tweetnacl');
 require('chalk');
 require('node:util');
-require('./types-DbBPNIwf.cjs');
+require('./types-CRxf_3n8.cjs');
 require('axios');
 require('node:events');
 require('socket.io-client');

package/dist/{teams-D5HxnyaW.mjs → teams-Cfr-2Yd-.mjs}

@@ -2,15 +2,15 @@ import { homedir } from 'node:os';
 import { unlink, rmdir, mkdir, lstat, readFile, writeFile, rename } from 'node:fs/promises';
 import { z } from 'zod';
 import { createHash, randomUUID } from 'node:crypto';
-import { d as teamRequest, e as createTeamsClient } from './agentGuidance-ASxKHxBP.mjs';
-import { d as readCredentialsForConfiguredRelay } from './limits-kjHZUlSp.mjs';
+import { d as teamRequest, e as createTeamsClient } from './agentGuidance-WHZsBKpm.mjs';
+import { d as readCredentialsForConfiguredRelay } from './limits-DEsg_gHi.mjs';
 import { join, resolve, dirname } from 'node:path';
-import { T as TEAM_SKILL } from './index-CHI7iTa0.mjs';
+import { T as TEAM_SKILL } from './index-Dbl5U_N0.mjs';
 import 'node:fs';
 import 'tweetnacl';
 import 'chalk';
 import 'node:util';
-import './types-BKrZubg8.mjs';
+import './types-D5EsIAOe.mjs';
 import 'axios';
 import 'node:events';
 import 'socket.io-client';

package/dist/{todo-BiLIZH4t.mjs → todo-CU5cjQZU.mjs}

@@ -1,6 +1,6 @@
-import { d as readCredentialsForConfiguredRelay, c as configuration } from './limits-kjHZUlSp.mjs';
-import { b as createBuiltinTodoClient, B as BUILTIN_TODO_SKILL } from './types-BKrZubg8.mjs';
-import { c as readTeamScope, t as teamScopePath } from './agentGuidance-ASxKHxBP.mjs';
+import { d as readCredentialsForConfiguredRelay, c as configuration } from './limits-DEsg_gHi.mjs';
+import { b as createBuiltinTodoClient, B as BUILTIN_TODO_SKILL } from './types-D5EsIAOe.mjs';
+import { c as readTeamScope, t as teamScopePath } from './agentGuidance-WHZsBKpm.mjs';
 import 'node:fs/promises';
 import 'node:fs';
 import 'node:os';

package/dist/{todo-CaYedmtq.cjs → todo-DydKcknX.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var persistence = require('./limits-DRrdJ7gr.cjs');
-var api = require('./types-DbBPNIwf.cjs');
-var agentGuidance = require('./agentGuidance-6yh_wPwD.cjs');
+var persistence = require('./limits-CfzVummd.cjs');
+var api = require('./types-CRxf_3n8.cjs');
+var agentGuidance = require('./agentGuidance-4HV-BOge.cjs');
 require('node:fs/promises');
 require('node:fs');
 require('node:os');

package/dist/{types-DbBPNIwf.cjs → types-CRxf_3n8.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var axios = require('axios');
-var persistence = require('./limits-DRrdJ7gr.cjs');
+var persistence = require('./limits-CfzVummd.cjs');
 var node_events = require('node:events');
 var socket_ioClient = require('socket.io-client');
 var z = require('zod');
@@ -1369,7 +1369,7 @@ class RpcHandlerManager {
   }
 }
 
-const __dirname$1 = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-DbBPNIwf.cjs', document.baseURI).href))));
+const __dirname$1 = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('types-CRxf_3n8.cjs', document.baseURI).href))));
 function projectPath() {
   const path$1 = path.resolve(__dirname$1, "..");
   return path$1;
@@ -3050,10 +3050,14 @@ class ApiSessionClient extends node_events.EventEmitter {
             return;
           }
           const localId = data.body.message.localId;
-          if (localId && this.directInboundLocalIds.delete(localId)) {
+          const relayAccepted = !!localId && this.directInboundLocalIds.delete(localId);
+          if (localId && this.routedInboundLocalIds.has(localId)) {
             this.lastSeq = messageSeq;
             return;
           }
+          if (relayAccepted) {
+            persistence.logger.debug(`[API] Routing relay-accepted message ${localId} from the central echo (own persist still pending or failed)`);
+          }
           const body = persistence.decrypt(this.encryptionKey, this.encryptionVariant, persistence.decodeBase64(data.body.message.content.c));
           persistence.logger.debugLargeJson("[SOCKET] [UPDATE] Received update:", body);
           this.routeIncomingMessage(body, localId);
@@ -3306,6 +3310,13 @@ class ApiSessionClient extends node_events.EventEmitter {
       }
       return;
     }
+    const role = typeof message === "object" && message !== null ? message.role : void 0;
+    if (role === "user") {
+      persistence.logger.debug("[API] Inbound user-role message did not match UserMessageSchema; forwarding as generic message", {
+        sourceLocalId: sourceLocalId ?? null,
+        issues: userResult.error.issues.slice(0, 5).map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+      });
+    }
     this.emit("message", message);
   }
   async fetchMessages() {
@@ -3334,12 +3345,13 @@ class ApiSessionClient extends node_events.EventEmitter {
           maxSeq = message.seq;
         }
         if (skipRouting) continue;
-        if (message.localId && this.directInboundLocalIds.delete(message.localId)) {
-          continue;
-        }
+        const relayAccepted = !!message.localId && this.directInboundLocalIds.delete(message.localId);
         if (message.localId && this.routedInboundLocalIds.has(message.localId)) {
           continue;
         }
+        if (relayAccepted) {
+          persistence.logger.debug(`[API] Routing relay-accepted message ${message.localId} from catch-up fetch (own persist still pending or failed)`);
+        }
         if (message.content?.t !== "encrypted") {
           continue;
         }
@@ -3471,6 +3483,8 @@ class ApiSessionClient extends node_events.EventEmitter {
           }
           callback({ ok: true, messages: stored });
         } catch (error) {
+          const routed = batch.filter((item) => this.routedInboundLocalIds.has(item.localId)).length;
+          persistence.logger.debug(`[API] Relay-delivered persist failed for ${batch.length} message(s) (${routed} already routed via central echo): ${error instanceof Error ? error.message : error}`);
           for (const item of batch) this.directInboundLocalIds.delete(item.localId);
           callback({ ok: false, error: error instanceof Error ? error.message : "Failed to persist session messages" });
         }
@@ -12966,6 +12980,9 @@ class CodexAppServerClient {
   // Tracks in-flight interruptTurn() RPCs so sendTurnAndWait can wait for them
   // before starting a new turn (prevents stale turn/interrupt from aborting the next turn).
   pendingInterrupt = null;
+  // In-flight idle release (B-461); ensureConnected() waits for it so a message
+  // arriving mid-release cannot spawn a second app-server against a dying one.
+  idleRelease = null;
   notificationProtocol = "unknown";
   completedTurnIds = /* @__PURE__ */ new Set();
   rawFileChangesByItemId = /* @__PURE__ */ new Map();
@@ -13299,6 +13316,53 @@ class CodexAppServerClient {
   async disconnect() {
     await this.disconnectInternal();
   }
+  /** True while an app-server child process is owned by this client. */
+  get hasProcess() {
+    return this.process !== null;
+  }
+  /**
+   * Drop the app-server process while the session is idle, keeping the thread
+   * id and defaults so the next turn can `thread/resume` it (B-461). Refuses —
+   * returning false — whenever anything is still in flight: an active turn, a
+   * pending interrupt, or any outstanding RPC. See codexIdleRelease.ts.
+   */
+  async releaseIdleProcess() {
+    if (this.idleRelease) return this.idleRelease;
+    if (!this.connected && !this.process) return false;
+    if (this.pendingTurnCompletion || this.pendingInterrupt || this.pending.size > 0) {
+      persistence.logger.debug("[CodexAppServer] Idle release skipped: work still in flight");
+      return false;
+    }
+    const run = (async () => {
+      const threadId = this._threadId;
+      persistence.logger.debug(`[CodexAppServer] Releasing idle app-server; thread=${threadId ?? "none"} kept for resume`);
+      await this.disconnectInternal({ preserveThreadState: !!threadId });
+      return true;
+    })();
+    this.idleRelease = run;
+    try {
+      return await run;
+    } finally {
+      if (this.idleRelease === run) this.idleRelease = null;
+    }
+  }
+  /**
+   * Make sure an app-server is running and, if a thread is remembered, resumed
+   * in it. Cheap no-op while connected. Covers both the idle release above and
+   * an app-server that exited on its own between turns.
+   */
+  async ensureConnected() {
+    if (this.idleRelease) await this.idleRelease;
+    if (this.connected) return;
+    const threadId = this._threadId;
+    if (this.process) {
+      await this.disconnectInternal({ preserveThreadState: !!threadId });
+    }
+    await this.connect();
+    if (threadId) {
+      await this.resumeThread({ threadId });
+    }
+  }
   buildThreadConfig(mcpServers) {
     return mcpServers ? { mcp_servers: mcpServers } : null;
   }
@@ -13313,6 +13377,7 @@ class CodexAppServerClient {
   }
   // ─── Thread management ──────────────────────────────────────
   async startThread(opts) {
+    await this.ensureConnected();
     const params = {
       model: opts.model ?? null,
       modelProvider: null,
@@ -13340,6 +13405,7 @@ class CodexAppServerClient {
     if (!threadId) {
       throw new Error("No thread available to resume.");
     }
+    await this.ensureConnected();
     const defaults = this.threadDefaults ?? {};
     const params = {
       threadId,
@@ -13367,6 +13433,7 @@ class CodexAppServerClient {
     return { threadId: result.thread.id, model: result.model };
   }
   async forkThread(opts) {
+    await this.ensureConnected();
     const defaults = this.threadDefaults ?? {};
     const params = {
       threadId: opts.threadId,
@@ -13395,6 +13462,7 @@ class CodexAppServerClient {
     return { threadId: result.thread.id, model: result.model, thread: result.thread };
   }
   async readThread(opts) {
+    await this.ensureConnected();
     const params = {
       threadId: opts.threadId,
       includeTurns: opts.includeTurns ?? true
@@ -13402,6 +13470,7 @@ class CodexAppServerClient {
     return await this.request("thread/read", params);
   }
   async rollbackThread(opts) {
+    await this.ensureConnected();
     const params = {
       threadId: opts.threadId,
       numTurns: opts.numTurns
@@ -13409,6 +13478,7 @@ class CodexAppServerClient {
     return await this.request("thread/rollback", params);
   }
   async injectItems(opts) {
+    await this.ensureConnected();
     const params = {
       threadId: opts.threadId,
       items: opts.items
@@ -13513,6 +13583,7 @@ class CodexAppServerClient {
     if (!this._threadId) {
       throw new Error("No active thread. Call startThread first.");
     }
+    await this.ensureConnected();
     const input = [
       { type: "text", text: prompt },
       ...(opts?.images ?? []).map((path) => ({ type: "localImage", path }))
@@ -13558,6 +13629,7 @@ class CodexAppServerClient {
       await this.pendingInterrupt;
       await new Promise((resolve) => setTimeout(resolve, 0));
     }
+    await this.ensureConnected();
     const timeoutMs = opts?.turnTimeoutMs ?? CodexAppServerClient.TURN_TIMEOUT_MS;
     let timer = null;
     const completion = new Promise((resolve) => {

package/dist/{types-BKrZubg8.mjs → types-D5EsIAOe.mjs}

@@ -1,5 +1,5 @@
 import axios from 'axios';
-import { l as logger, i as encodeBase64, j as encrypt, k as decrypt, m as decodeBase64, c as configuration, o as decryptBlob, q as prepareClipboardText, g as readSettings, r as readPersistedSessions, s as credentialRelayProblem, p as packageJson, t as readTrackedClaudeSessionIds, u as libsodiumEncryptForPublicKey, v as libsodiumPublicKeyFromSecretKey, x as getRandomBytes, y as redactLogValue } from './limits-kjHZUlSp.mjs';
+import { l as logger, i as encodeBase64, j as encrypt, k as decrypt, m as decodeBase64, c as configuration, o as decryptBlob, q as prepareClipboardText, g as readSettings, r as readPersistedSessions, s as credentialRelayProblem, p as packageJson, t as readTrackedClaudeSessionIds, u as libsodiumEncryptForPublicKey, v as libsodiumPublicKeyFromSecretKey, x as getRandomBytes, y as redactLogValue } from './limits-DEsg_gHi.mjs';
 import { EventEmitter } from 'node:events';
 import { io } from 'socket.io-client';
 import * as z from 'zod';
@@ -3028,10 +3028,14 @@ class ApiSessionClient extends EventEmitter {
             return;
           }
           const localId = data.body.message.localId;
-          if (localId && this.directInboundLocalIds.delete(localId)) {
+          const relayAccepted = !!localId && this.directInboundLocalIds.delete(localId);
+          if (localId && this.routedInboundLocalIds.has(localId)) {
             this.lastSeq = messageSeq;
             return;
           }
+          if (relayAccepted) {
+            logger.debug(`[API] Routing relay-accepted message ${localId} from the central echo (own persist still pending or failed)`);
+          }
           const body = decrypt(this.encryptionKey, this.encryptionVariant, decodeBase64(data.body.message.content.c));
           logger.debugLargeJson("[SOCKET] [UPDATE] Received update:", body);
           this.routeIncomingMessage(body, localId);
@@ -3284,6 +3288,13 @@ class ApiSessionClient extends EventEmitter {
       }
       return;
     }
+    const role = typeof message === "object" && message !== null ? message.role : void 0;
+    if (role === "user") {
+      logger.debug("[API] Inbound user-role message did not match UserMessageSchema; forwarding as generic message", {
+        sourceLocalId: sourceLocalId ?? null,
+        issues: userResult.error.issues.slice(0, 5).map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+      });
+    }
     this.emit("message", message);
   }
   async fetchMessages() {
@@ -3312,12 +3323,13 @@ class ApiSessionClient extends EventEmitter {
           maxSeq = message.seq;
         }
         if (skipRouting) continue;
-        if (message.localId && this.directInboundLocalIds.delete(message.localId)) {
-          continue;
-        }
+        const relayAccepted = !!message.localId && this.directInboundLocalIds.delete(message.localId);
         if (message.localId && this.routedInboundLocalIds.has(message.localId)) {
           continue;
         }
+        if (relayAccepted) {
+          logger.debug(`[API] Routing relay-accepted message ${message.localId} from catch-up fetch (own persist still pending or failed)`);
+        }
         if (message.content?.t !== "encrypted") {
           continue;
         }
@@ -3449,6 +3461,8 @@ class ApiSessionClient extends EventEmitter {
           }
           callback({ ok: true, messages: stored });
         } catch (error) {
+          const routed = batch.filter((item) => this.routedInboundLocalIds.has(item.localId)).length;
+          logger.debug(`[API] Relay-delivered persist failed for ${batch.length} message(s) (${routed} already routed via central echo): ${error instanceof Error ? error.message : error}`);
           for (const item of batch) this.directInboundLocalIds.delete(item.localId);
           callback({ ok: false, error: error instanceof Error ? error.message : "Failed to persist session messages" });
         }
@@ -12944,6 +12958,9 @@ class CodexAppServerClient {
   // Tracks in-flight interruptTurn() RPCs so sendTurnAndWait can wait for them
   // before starting a new turn (prevents stale turn/interrupt from aborting the next turn).
   pendingInterrupt = null;
+  // In-flight idle release (B-461); ensureConnected() waits for it so a message
+  // arriving mid-release cannot spawn a second app-server against a dying one.
+  idleRelease = null;
   notificationProtocol = "unknown";
   completedTurnIds = /* @__PURE__ */ new Set();
   rawFileChangesByItemId = /* @__PURE__ */ new Map();
@@ -13277,6 +13294,53 @@ class CodexAppServerClient {
   async disconnect() {
     await this.disconnectInternal();
   }
+  /** True while an app-server child process is owned by this client. */
+  get hasProcess() {
+    return this.process !== null;
+  }
+  /**
+   * Drop the app-server process while the session is idle, keeping the thread
+   * id and defaults so the next turn can `thread/resume` it (B-461). Refuses —
+   * returning false — whenever anything is still in flight: an active turn, a
+   * pending interrupt, or any outstanding RPC. See codexIdleRelease.ts.
+   */
+  async releaseIdleProcess() {
+    if (this.idleRelease) return this.idleRelease;
+    if (!this.connected && !this.process) return false;
+    if (this.pendingTurnCompletion || this.pendingInterrupt || this.pending.size > 0) {
+      logger.debug("[CodexAppServer] Idle release skipped: work still in flight");
+      return false;
+    }
+    const run = (async () => {
+      const threadId = this._threadId;
+      logger.debug(`[CodexAppServer] Releasing idle app-server; thread=${threadId ?? "none"} kept for resume`);
+      await this.disconnectInternal({ preserveThreadState: !!threadId });
+      return true;
+    })();
+    this.idleRelease = run;
+    try {
+      return await run;
+    } finally {
+      if (this.idleRelease === run) this.idleRelease = null;
+    }
+  }
+  /**
+   * Make sure an app-server is running and, if a thread is remembered, resumed
+   * in it. Cheap no-op while connected. Covers both the idle release above and
+   * an app-server that exited on its own between turns.
+   */
+  async ensureConnected() {
+    if (this.idleRelease) await this.idleRelease;
+    if (this.connected) return;
+    const threadId = this._threadId;
+    if (this.process) {
+      await this.disconnectInternal({ preserveThreadState: !!threadId });
+    }
+    await this.connect();
+    if (threadId) {
+      await this.resumeThread({ threadId });
+    }
+  }
   buildThreadConfig(mcpServers) {
     return mcpServers ? { mcp_servers: mcpServers } : null;
   }
@@ -13291,6 +13355,7 @@ class CodexAppServerClient {
   }
   // ─── Thread management ──────────────────────────────────────
   async startThread(opts) {
+    await this.ensureConnected();
     const params = {
       model: opts.model ?? null,
       modelProvider: null,
@@ -13318,6 +13383,7 @@ class CodexAppServerClient {
     if (!threadId) {
       throw new Error("No thread available to resume.");
     }
+    await this.ensureConnected();
     const defaults = this.threadDefaults ?? {};
     const params = {
       threadId,
@@ -13345,6 +13411,7 @@ class CodexAppServerClient {
     return { threadId: result.thread.id, model: result.model };
   }
   async forkThread(opts) {
+    await this.ensureConnected();
     const defaults = this.threadDefaults ?? {};
     const params = {
       threadId: opts.threadId,
@@ -13373,6 +13440,7 @@ class CodexAppServerClient {
     return { threadId: result.thread.id, model: result.model, thread: result.thread };
   }
   async readThread(opts) {
+    await this.ensureConnected();
     const params = {
       threadId: opts.threadId,
       includeTurns: opts.includeTurns ?? true
@@ -13380,6 +13448,7 @@ class CodexAppServerClient {
     return await this.request("thread/read", params);
   }
   async rollbackThread(opts) {
+    await this.ensureConnected();
     const params = {
       threadId: opts.threadId,
       numTurns: opts.numTurns
@@ -13387,6 +13456,7 @@ class CodexAppServerClient {
     return await this.request("thread/rollback", params);
   }
   async injectItems(opts) {
+    await this.ensureConnected();
     const params = {
       threadId: opts.threadId,
       items: opts.items
@@ -13491,6 +13561,7 @@ class CodexAppServerClient {
     if (!this._threadId) {
       throw new Error("No active thread. Call startThread first.");
     }
+    await this.ensureConnected();
     const input = [
       { type: "text", text: prompt },
       ...(opts?.images ?? []).map((path) => ({ type: "localImage", path }))
@@ -13536,6 +13607,7 @@ class CodexAppServerClient {
       await this.pendingInterrupt;
       await new Promise((resolve) => setTimeout(resolve, 0));
     }
+    await this.ensureConnected();
     const timeoutMs = opts?.turnTimeoutMs ?? CodexAppServerClient.TURN_TIMEOUT_MS;
     let timer = null;
     const completion = new Promise((resolve) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "very-happy-cli",
-  "version": "0.2.136",
+  "version": "0.2.138",
   "description": "Remote multi-agent workspace CLI with deep Claude integration, native terminal streaming, and self-hosting.",
   "author": "Kirill Dubovitskiy",
   "contributors": [
@@ -113,12 +113,12 @@
     "zod": "^4.0.0"
   },
   "optionalDependencies": {
-    "very-happy-tools-arm64-darwin": "0.2.136",
-    "very-happy-tools-x64-darwin": "0.2.136",
-    "very-happy-tools-arm64-linux": "0.2.136",
-    "very-happy-tools-x64-linux": "0.2.136",
-    "very-happy-tools-arm64-win32": "0.2.136",
-    "very-happy-tools-x64-win32": "0.2.136"
+    "very-happy-tools-arm64-darwin": "0.2.138",
+    "very-happy-tools-x64-darwin": "0.2.138",
+    "very-happy-tools-arm64-linux": "0.2.138",
+    "very-happy-tools-x64-linux": "0.2.138",
+    "very-happy-tools-arm64-win32": "0.2.138",
+    "very-happy-tools-x64-win32": "0.2.138"
   },
   "devDependencies": {
     "@slopus/happy-wire": "workspace:*",