very-happy-cli 0.2.165 → 0.2.166

package/dist/{browser-_gV7tcPs.cjs → browser-CcG8GLRV.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 var open = require('open');
-var logger = require('./logger-D0hkk7Vo.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 
 async function openBrowser(url) {
   try {

package/dist/{browser-mwzpOmcw.mjs → browser-DDFi1T8C.mjs}

@@ -1,5 +1,5 @@
 import open from 'open';
-import { l as logger } from './logger-CknSVkIe.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
 
 async function openBrowser(url) {
   try {

package/dist/{claudeLocal-G5UmJ81F.cjs → claudeLocal-DXBXwIOG.cjs}

@@ -4,25 +4,25 @@ var spawn = require('cross-spawn');
 var node_readline = require('node:readline');
 var node_fs = require('node:fs');
 var node_crypto = require('node:crypto');
-var logger = require('./logger-D0hkk7Vo.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 var smallFastModel = require('./smallFastModel-D_uxGMo3.cjs');
 var path$1 = require('node:path');
 var path = require('./path-B7zW-WwE.cjs');
-var systemPrompt = require('./systemPrompt-CB1Ls0AE.cjs');
+var systemPrompt = require('./systemPrompt-4erwILTB.cjs');
 var manager = require('./manager-Cly8xVIR.cjs');
 var contentLogMetadata = require('./contentLogMetadata-ZSFk_NjQ.cjs');
 var claudeCliPath = require('./claudeCliPath-U4HHmV4r.cjs');
 require('chalk');
 require('node:util');
-require('./configuration-BE61XNsg.cjs');
+require('./configuration-B0cb3xA3.cjs');
 require('node:os');
-require('./package-UkmvSFsg.cjs');
+require('./package-C1XvUQFy.cjs');
 require('node:fs/promises');
-require('./index-DqlyNgt4.cjs');
+require('./index-C9hI8a10.cjs');
 require('zod');
 require('@paralleldrive/cuid2');
 require('./trimIdent-4gvk9Wk6.cjs');
-require('./agentGuidance-B5NATuFa.cjs');
+require('./agentGuidance-BtBx2xxE.cjs');
 require('@anthropic-ai/sandbox-runtime');
 require('./projectPath-ChLhdOyt.cjs');
 require('path');

package/dist/{claudeLocal-BeHToEK5.mjs → claudeLocal-DmM5Oyhv.mjs}

@@ -2,25 +2,25 @@ import { spawn } from 'cross-spawn';
 import { createInterface } from 'node:readline';
 import { readdirSync, statSync, mkdirSync, existsSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
-import { l as logger } from './logger-CknSVkIe.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
 import { p as pinSmallFastModel, e as ensureLocalProxyBypass } from './smallFastModel-BLNgMrwR.mjs';
 import { join } from 'node:path';
 import { g as getProjectPath } from './path-D2wdaNSk.mjs';
-import { c as claudeCheckSession, s as systemPrompt } from './systemPrompt-D41Zw1a3.mjs';
+import { c as claudeCheckSession, s as systemPrompt } from './systemPrompt-BanyDihy.mjs';
 import { i as initializeSandbox, a as wrapCommand } from './manager-BQ4flvQZ.mjs';
 import { c as contentLogMetadata } from './contentLogMetadata-BlWI0egu.mjs';
 import { claudeCliPath } from './claudeCliPath-BqkaH2oR.mjs';
 import 'chalk';
 import 'node:util';
-import './configuration-L1qcGTFM.mjs';
+import './configuration-D2v3puap.mjs';
 import 'node:os';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';
 import 'node:fs/promises';
-import './index-vVWpCoTr.mjs';
+import './index-B0HEEYGh.mjs';
 import 'zod';
 import '@paralleldrive/cuid2';
 import './trimIdent-BAjmv_TG.mjs';
-import './agentGuidance-CQuNlNx8.mjs';
+import './agentGuidance-BDYt2Qy2.mjs';
 import '@anthropic-ai/sandbox-runtime';
 import './projectPath-BTBIMB57.mjs';
 import 'path';

package/dist/{claudeLocalLauncher-B4y2BsmO.cjs → claudeLocalLauncher-C41Y6Kp4.cjs}

@@ -1,27 +1,27 @@
 'use strict';
 
-var logger = require('./logger-D0hkk7Vo.cjs');
-var claudeLocal = require('./claudeLocal-G5UmJ81F.cjs');
-var sessionScanner = require('./sessionScanner-BBPEgJ5S.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
+var claudeLocal = require('./claudeLocal-DXBXwIOG.cjs');
+var sessionScanner = require('./sessionScanner-Cu1yKlj4.cjs');
 require('chalk');
 require('node:util');
-require('./configuration-BE61XNsg.cjs');
+require('./configuration-B0cb3xA3.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('./package-UkmvSFsg.cjs');
+require('./package-C1XvUQFy.cjs');
 require('node:fs/promises');
 require('cross-spawn');
 require('node:readline');
 require('node:crypto');
 require('./smallFastModel-D_uxGMo3.cjs');
 require('./path-B7zW-WwE.cjs');
-require('./systemPrompt-CB1Ls0AE.cjs');
-require('./index-DqlyNgt4.cjs');
+require('./systemPrompt-4erwILTB.cjs');
+require('./index-C9hI8a10.cjs');
 require('zod');
 require('@paralleldrive/cuid2');
 require('./trimIdent-4gvk9Wk6.cjs');
-require('./agentGuidance-B5NATuFa.cjs');
+require('./agentGuidance-BtBx2xxE.cjs');
 require('./manager-Cly8xVIR.cjs');
 require('@anthropic-ai/sandbox-runtime');
 require('./contentLogMetadata-ZSFk_NjQ.cjs');
@@ -29,16 +29,19 @@ require('./claudeCliPath-U4HHmV4r.cjs');
 require('./projectPath-ChLhdOyt.cjs');
 require('path');
 require('url');
-require('./sync-DwUUGGFz.cjs');
-require('./time-BbzJ7PJQ.cjs');
+require('./sync-x_lI_3j_.cjs');
+require('./time-T0YmeOhS.cjs');
 require('./types-CRS-srZK.cjs');
-require('./startFileWatcher-1LedLBY-.cjs');
+require('./transcriptCursor-DcXGLeSc.cjs');
+require('./startFileWatcher-DQbbypJv.cjs');
 require('fs/promises');
 
 async function claudeLocalLauncher(session) {
   const scanner = await sessionScanner.createSessionScanner({
     sessionId: session.sessionId,
     workingDirectory: session.path,
+    // B-551: prefer the transcript path Claude reported via its hook.
+    transcriptPathHints: session.transcriptPathHints ?? void 0,
     onMessage: (message) => {
       if (message.type !== "summary") {
         session.client.sendClaudeSessionMessage(message);

package/dist/{claudeLocalLauncher-Cq6bqAT4.mjs → claudeLocalLauncher-Cs4eUC3P.mjs}

@@ -1,25 +1,25 @@
-import { l as logger } from './logger-CknSVkIe.mjs';
-import { claudeLocal, ExitCodeError } from './claudeLocal-BeHToEK5.mjs';
-import { c as createSessionScanner, F as Future } from './sessionScanner-DqSk5Ol_.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
+import { claudeLocal, ExitCodeError } from './claudeLocal-DmM5Oyhv.mjs';
+import { c as createSessionScanner, F as Future } from './sessionScanner-CcuOn9uU.mjs';
 import 'chalk';
 import 'node:util';
-import './configuration-L1qcGTFM.mjs';
+import './configuration-D2v3puap.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import './package-VIUXrYZ1.mjs';
+import './package-BqwrPxL0.mjs';
 import 'node:fs/promises';
 import 'cross-spawn';
 import 'node:readline';
 import 'node:crypto';
 import './smallFastModel-BLNgMrwR.mjs';
 import './path-D2wdaNSk.mjs';
-import './systemPrompt-D41Zw1a3.mjs';
-import './index-vVWpCoTr.mjs';
+import './systemPrompt-BanyDihy.mjs';
+import './index-B0HEEYGh.mjs';
 import 'zod';
 import '@paralleldrive/cuid2';
 import './trimIdent-BAjmv_TG.mjs';
-import './agentGuidance-CQuNlNx8.mjs';
+import './agentGuidance-BDYt2Qy2.mjs';
 import './manager-BQ4flvQZ.mjs';
 import '@anthropic-ai/sandbox-runtime';
 import './contentLogMetadata-BlWI0egu.mjs';
@@ -27,16 +27,19 @@ import './claudeCliPath-BqkaH2oR.mjs';
 import './projectPath-BTBIMB57.mjs';
 import 'path';
 import 'url';
-import './sync-Dfm6K2te.mjs';
-import './time-v1Y_qEJp.mjs';
+import './sync-BLpH13Kb.mjs';
+import './time-CfDKj6Bx.mjs';
 import './types-CkqAACXx.mjs';
-import './startFileWatcher-B0VlG-Fn.mjs';
+import './transcriptCursor-B7T_gkQ0.mjs';
+import './startFileWatcher-Dfs4whzr.mjs';
 import 'fs/promises';
 
 async function claudeLocalLauncher(session) {
   const scanner = await createSessionScanner({
     sessionId: session.sessionId,
     workingDirectory: session.path,
+    // B-551: prefer the transcript path Claude reported via its hook.
+    transcriptPathHints: session.transcriptPathHints ?? void 0,
     onMessage: (message) => {
       if (message.type !== "summary") {
         session.client.sendClaudeSessionMessage(message);

package/dist/{claudeSessionFork-CokUhS4r.mjs → claudeSessionFork-BdLnc2Hv.mjs}

@@ -3,7 +3,7 @@ import { copyFile, 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-CknSVkIe.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
 
 class ForkTruncateUuidNotFoundError extends Error {
   constructor(cutAfterUuid, sourcePath) {

package/dist/{claudeSessionFork-CDJq_b9r.cjs → claudeSessionFork-Cs0I3eGI.cjs}

@@ -5,7 +5,7 @@ var promises = require('node:fs/promises');
 var node_fs = require('node:fs');
 var path = require('node:path');
 var node_readline = require('node:readline');
-var logger = require('./logger-D0hkk7Vo.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 
 class ForkTruncateUuidNotFoundError extends Error {
   constructor(cutAfterUuid, sourcePath) {

package/dist/{client-BwaWdlCm.mjs → client-CbK33y_s.mjs}

@@ -1,7 +1,7 @@
 import { randomUUID } from 'node:crypto';
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
-import { readSettings, readPersistedSessions, readCredentialsForConfiguredRelay } from './persistence-DujtUH94.mjs';
-import { r as readTeamScope, t as teamScopePath, w as writeTeamScope } from './context-DaCCB4cm.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
+import { readSettings, readPersistedSessions, readCredentialsForConfiguredRelay } from './persistence-B9LmhAE2.mjs';
+import { r as readTeamScope, t as teamScopePath, w as writeTeamScope } from './context-DjfqLWzE.mjs';
 
 async function teamRequest(path, method, token, scoped, body) {
   const response = await fetch(`${configuration.serverUrl}${path}`, {

package/dist/{client-uN9d6Git.cjs → client-DJ0kX_8M.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var configuration = require('./configuration-BE61XNsg.cjs');
-var persistence = require('./persistence-C6ztVW1W.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
+var persistence = require('./persistence-2Xp_o6x6.cjs');
 
 class AutomationsRequestError extends Error {
   constructor(status, code, runStatus) {

package/dist/{client-CJZKBZCE.mjs → client-GjTnsq6F.mjs}

@@ -1,5 +1,5 @@
-import { c as configuration } from './configuration-L1qcGTFM.mjs';
-import { readCredentialsForConfiguredRelay, readSettings } from './persistence-DujtUH94.mjs';
+import { c as configuration } from './configuration-D2v3puap.mjs';
+import { readCredentialsForConfiguredRelay, readSettings } from './persistence-B9LmhAE2.mjs';
 
 class AutomationsRequestError extends Error {
   constructor(status, code, runStatus) {

package/dist/{client-Do7cGPEq.cjs → client-JISJx2f-.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
 var node_crypto = require('node:crypto');
-var configuration = require('./configuration-BE61XNsg.cjs');
-var persistence = require('./persistence-C6ztVW1W.cjs');
-var context = require('./context-3WVw8qPz.cjs');
+var configuration = require('./configuration-B0cb3xA3.cjs');
+var persistence = require('./persistence-2Xp_o6x6.cjs');
+var context = require('./context-BFUpYT39.cjs');
 
 async function teamRequest(path, method, token, scoped, body) {
   const response = await fetch(`${configuration.configuration.serverUrl}${path}`, {

package/dist/codex/happyMcpStdioBridge.cjs

@@ -1,41 +1,42 @@
 'use strict';
 
-var tools = require('../tools-c2fb0CF5.cjs');
-var tools$1 = require('../tools-mWqsE6ji.cjs');
-var peerTools = require('../peerTools-CttfOxti.cjs');
+var tools = require('../tools-IJ0TAcJs.cjs');
+var reportProgressTool = require('../reportProgressTool-B-Rcy0s3.cjs');
+var peerTools = require('../peerTools-DPvbcs8V.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');
 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');
-var agentGuidance = require('../agentGuidance-B5NATuFa.cjs');
-require('../client-Do7cGPEq.cjs');
+require('../client-JISJx2f-.cjs');
 require('node:crypto');
-require('../configuration-BE61XNsg.cjs');
+require('../configuration-B0cb3xA3.cjs');
 require('node:fs');
 require('node:os');
 require('node:path');
-require('../package-UkmvSFsg.cjs');
+require('../package-C1XvUQFy.cjs');
 require('node:fs/promises');
-require('../persistence-C6ztVW1W.cjs');
+require('../persistence-2Xp_o6x6.cjs');
 require('../authRelay-BdYkC1Po.cjs');
 require('tweetnacl');
-require('../logger-D0hkk7Vo.cjs');
+require('../logger-JTcJU-uL.cjs');
 require('chalk');
 require('node:util');
-require('../context-3WVw8qPz.cjs');
-require('../index-DqlyNgt4.cjs');
+require('../context-BFUpYT39.cjs');
+require('../index-C9hI8a10.cjs');
 require('@paralleldrive/cuid2');
-require('../client-uN9d6Git.cjs');
+require('../client-DJ0kX_8M.cjs');
+require('../precheckCompat-CWOi5c9L.cjs');
 require('../ids-B6ZC0HGt.cjs');
-require('../controlClient-RWTlQA4_.cjs');
-require('../sessionOps-JP64uJmc.cjs');
+require('../controlClient-CmnHGcyl.cjs');
+require('../sessionOps-DOyy4gkY.cjs');
 require('axios');
-require('../time-BbzJ7PJQ.cjs');
+require('../time-T0YmeOhS.cjs');
 require('socket.io-client');
 require('../backgroundTaskActivity-CBvUdj39.cjs');
-require('../remoteSessionClient-BAkIwM2S.cjs');
+require('../remoteSessionClient-BwI8rpQw.cjs');
 require('../trimIdent-4gvk9Wk6.cjs');
 
 function parseArgs(argv) {
@@ -105,7 +106,10 @@ async function main() {
       title: agentGuidance.PREVIEW_TOOL_TITLE,
       inputSchema: {
         path: z.z.string().describe("Absolute path (or ~/\u2026) of the file to show the user"),
-        mode: z.z.enum(["file", "diff"]).optional()
+        mode: z.z.enum(["file", "diff"]).optional(),
+        // B-562: must be declared here too — the SDK strips undeclared arguments
+        // before they reach the forwarded callTool.
+        download: z.z.boolean().optional().describe(agentGuidance.PREVIEW_DOWNLOAD_PARAM_DESCRIPTION)
       }
     },
     async (args) => {
@@ -162,8 +166,9 @@ async function main() {
       return forwardTeam(`team_${String(type).replaceAll("-", "_")}`, { ...args, requestId });
     }
   });
-  tools$1.registerAutomationTools(server, (name, args) => forwardTeam(name, args));
+  reportProgressTool.registerAutomationTools(server, (name, args) => forwardTeam(name, args));
   peerTools.registerSessionPeerTools(server, (name, args) => forwardTeam(name, args));
+  reportProgressTool.registerReportProgressTool(server, async (args) => (await ensureHttpClient()).callTool({ name: agentGuidance.REPORT_PROGRESS_TOOL_NAME, arguments: args }));
   const stdio = new stdio_js.StdioServerTransport();
   await server.connect(stdio);
 }

package/dist/codex/happyMcpStdioBridge.mjs

@@ -1,39 +1,40 @@
-import { r as registerTeamsTools } from '../tools-jof0Bu54.mjs';
-import { r as registerAutomationTools } from '../tools-BVRoGcQH.mjs';
-import { r as registerSessionPeerTools } from '../peerTools-SWITnkqz.mjs';
+import { r as registerTeamsTools } from '../tools-3X2z3YDe.mjs';
+import { r as registerAutomationTools, a as registerReportProgressTool } from '../reportProgressTool-DnAD8wOa.mjs';
+import { r as registerSessionPeerTools } from '../peerTools-CeCe-3lk.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';
 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 { P as PREVIEW_TOOL_NAME, a as PREVIEW_TOOL_TITLE, b as PREVIEW_TOOL_DESCRIPTION } from '../agentGuidance-CQuNlNx8.mjs';
-import '../client-BwaWdlCm.mjs';
+import '../client-CbK33y_s.mjs';
 import 'node:crypto';
-import '../configuration-L1qcGTFM.mjs';
+import '../configuration-D2v3puap.mjs';
 import 'node:fs';
 import 'node:os';
 import 'node:path';
-import '../package-VIUXrYZ1.mjs';
+import '../package-BqwrPxL0.mjs';
 import 'node:fs/promises';
-import '../persistence-DujtUH94.mjs';
+import '../persistence-B9LmhAE2.mjs';
 import '../authRelay-DSAvg1uv.mjs';
 import 'tweetnacl';
-import '../logger-CknSVkIe.mjs';
+import '../logger-BpQcwNnt.mjs';
 import 'chalk';
 import 'node:util';
-import '../context-DaCCB4cm.mjs';
-import '../index-vVWpCoTr.mjs';
+import '../context-DjfqLWzE.mjs';
+import '../index-B0HEEYGh.mjs';
 import '@paralleldrive/cuid2';
-import '../client-CJZKBZCE.mjs';
+import '../client-GjTnsq6F.mjs';
+import '../precheckCompat-DeEbilbr.mjs';
 import '../ids-DU6sLx4C.mjs';
-import '../controlClient-Ci7HTMII.mjs';
-import '../sessionOps-DG5MMEp_.mjs';
+import '../controlClient-BMUJfUeF.mjs';
+import '../sessionOps-BnaEaOKs.mjs';
 import 'axios';
-import '../time-v1Y_qEJp.mjs';
+import '../time-CfDKj6Bx.mjs';
 import 'socket.io-client';
 import '../backgroundTaskActivity-8PdPxrvy.mjs';
-import '../remoteSessionClient-DCAUHgPz.mjs';
+import '../remoteSessionClient-B2DtWuNP.mjs';
 import '../trimIdent-BAjmv_TG.mjs';
 
 function parseArgs(argv) {
@@ -103,7 +104,10 @@ async function main() {
       title: PREVIEW_TOOL_TITLE,
       inputSchema: {
         path: z.string().describe("Absolute path (or ~/\u2026) of the file to show the user"),
-        mode: z.enum(["file", "diff"]).optional()
+        mode: z.enum(["file", "diff"]).optional(),
+        // B-562: must be declared here too — the SDK strips undeclared arguments
+        // before they reach the forwarded callTool.
+        download: z.boolean().optional().describe(PREVIEW_DOWNLOAD_PARAM_DESCRIPTION)
       }
     },
     async (args) => {
@@ -162,6 +166,7 @@ async function main() {
   });
   registerAutomationTools(server, (name, args) => forwardTeam(name, args));
   registerSessionPeerTools(server, (name, args) => forwardTeam(name, args));
+  registerReportProgressTool(server, async (args) => (await ensureHttpClient()).callTool({ name: REPORT_PROGRESS_TOOL_NAME, arguments: args }));
   const stdio = new StdioServerTransport();
   await server.connect(stdio);
 }

package/dist/{codexAppServerClient-BuSdeUxT.cjs → codexAppServerClient-BTjn2ZCZ.cjs}

@@ -3,10 +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-D0hkk7Vo.cjs');
+var logger = require('./logger-JTcJU-uL.cjs');
 var contentLogMetadata = require('./contentLogMetadata-ZSFk_NjQ.cjs');
 var manager = require('./manager-Cly8xVIR.cjs');
-var _package = require('./package-UkmvSFsg.cjs');
+var _package = require('./package-C1XvUQFy.cjs');
+var rateLimitWindows = require('./rateLimitWindows-C2Jk3Ih7.cjs');
 
 function isAppServerAvailable() {
   try {
@@ -104,6 +105,11 @@ class CodexAppServerClient {
   // Handlers set by the consumer (runCodex.ts)
   eventHandler = null;
   approvalHandler = null;
+  // B-555: subscription rate-limit snapshots (sparse notifications + throttled reads).
+  rateLimitHandler = null;
+  rateLimitReadAt = 0;
+  rateLimitReadInFlight = false;
+  rateLimitReadUnsupported = false;
   constructor(sandboxConfig) {
     this.sandboxConfig = sandboxConfig;
   }
@@ -119,6 +125,36 @@ class CodexAppServerClient {
   setApprovalHandler(handler) {
     this.approvalHandler = handler;
   }
+  /**
+   * B-555: receive Codex `RateLimitSnapshot`s — from `account/rateLimits/updated`
+   * (sparse: null windows mean "not in this update") and from a throttled
+   * `account/rateLimits/read` after connect / each finished turn. Codex does
+   * the fetch with its own login; we never touch its credentials.
+   */
+  setRateLimitHandler(handler) {
+    this.rateLimitHandler = handler;
+    this.maybeRefreshRateLimits();
+  }
+  maybeRefreshRateLimits() {
+    if (!this.rateLimitHandler || !this.connected) return;
+    if (!rateLimitWindows.shouldReadCodexRateLimits({
+      now: Date.now(),
+      lastReadAt: this.rateLimitReadAt,
+      inFlight: this.rateLimitReadInFlight,
+      unsupported: this.rateLimitReadUnsupported
+    })) return;
+    this.rateLimitReadAt = Date.now();
+    this.rateLimitReadInFlight = true;
+    this.request("account/rateLimits/read", {}, 15e3).then((result) => {
+      const snapshot = result?.rateLimits;
+      if (snapshot) this.rateLimitHandler?.(snapshot);
+    }).catch((error) => {
+      if (rateLimitWindows.isUnsupportedCodexMethodError(error)) this.rateLimitReadUnsupported = true;
+      logger.logger.debug("[CodexAppServer] account/rateLimits/read failed:", contentLogMetadata.errorLogMetadata(error));
+    }).finally(() => {
+      this.rateLimitReadInFlight = false;
+    });
+  }
   extractTurnId(params) {
     const turnId = params?.turn?.id ?? params?.turnId ?? params?.turn_id ?? null;
     return typeof turnId === "string" && turnId.length > 0 ? turnId : null;
@@ -144,6 +180,7 @@ class CodexAppServerClient {
     const aborted = status === "cancelled" || status === "canceled" || status === "aborted" || status === "interrupted";
     this.tryResolvePendingTurn(aborted, turnId, source);
     this._turnId = null;
+    this.maybeRefreshRateLimits();
     if (turnId && this.completedTurnIds.has(turnId)) {
       return;
     }
@@ -379,6 +416,7 @@ class CodexAppServerClient {
     this.notify("initialized");
     this.connected = true;
     logger.logger.debug("[CodexAppServer] Connected and initialized");
+    this.maybeRefreshRateLimits();
   }
   async disconnectInternal(opts) {
     if (!this.connected && !this.process) return;
@@ -1052,6 +1090,7 @@ class CodexAppServerClient {
             `codex/event/${msg.type}`
           );
           this._turnId = null;
+          this.maybeRefreshRateLimits();
         }
       }
       return;
@@ -1079,6 +1118,11 @@ class CodexAppServerClient {
       }
       return;
     }
+    if (method === "account/rateLimits/updated") {
+      const snapshot = params?.rateLimits;
+      if (snapshot) this.rateLimitHandler?.(snapshot);
+      return;
+    }
     if (method === "mcpServer/startupStatus/updated") {
       logger.logger.debug(`[CodexAppServer] mcpServer startup status:`, params);
       return;

package/dist/{codexAppServerClient-B0QaMQsC.mjs → codexAppServerClient-CldXEojt.mjs}

@@ -1,10 +1,11 @@
 import { execSync } from 'node:child_process';
 import { spawn } from 'cross-spawn';
 import { createInterface } from 'node:readline';
-import { l as logger } from './logger-CknSVkIe.mjs';
-import { c as contentLogMetadata, e as errorLogMetadata } from './contentLogMetadata-BlWI0egu.mjs';
+import { l as logger } from './logger-BpQcwNnt.mjs';
+import { e as errorLogMetadata, c as contentLogMetadata } from './contentLogMetadata-BlWI0egu.mjs';
 import { i as initializeSandbox, w as wrapForMcpTransport } from './manager-BQ4flvQZ.mjs';
-import { p as packageJson } from './package-VIUXrYZ1.mjs';
+import { p as packageJson } from './package-BqwrPxL0.mjs';
+import { s as shouldReadCodexRateLimits, i as isUnsupportedCodexMethodError } from './rateLimitWindows-Dhfhbtqu.mjs';
 
 function isAppServerAvailable() {
   try {
@@ -102,6 +103,11 @@ class CodexAppServerClient {
   // Handlers set by the consumer (runCodex.ts)
   eventHandler = null;
   approvalHandler = null;
+  // B-555: subscription rate-limit snapshots (sparse notifications + throttled reads).
+  rateLimitHandler = null;
+  rateLimitReadAt = 0;
+  rateLimitReadInFlight = false;
+  rateLimitReadUnsupported = false;
   constructor(sandboxConfig) {
     this.sandboxConfig = sandboxConfig;
   }
@@ -117,6 +123,36 @@ class CodexAppServerClient {
   setApprovalHandler(handler) {
     this.approvalHandler = handler;
   }
+  /**
+   * B-555: receive Codex `RateLimitSnapshot`s — from `account/rateLimits/updated`
+   * (sparse: null windows mean "not in this update") and from a throttled
+   * `account/rateLimits/read` after connect / each finished turn. Codex does
+   * the fetch with its own login; we never touch its credentials.
+   */
+  setRateLimitHandler(handler) {
+    this.rateLimitHandler = handler;
+    this.maybeRefreshRateLimits();
+  }
+  maybeRefreshRateLimits() {
+    if (!this.rateLimitHandler || !this.connected) return;
+    if (!shouldReadCodexRateLimits({
+      now: Date.now(),
+      lastReadAt: this.rateLimitReadAt,
+      inFlight: this.rateLimitReadInFlight,
+      unsupported: this.rateLimitReadUnsupported
+    })) return;
+    this.rateLimitReadAt = Date.now();
+    this.rateLimitReadInFlight = true;
+    this.request("account/rateLimits/read", {}, 15e3).then((result) => {
+      const snapshot = result?.rateLimits;
+      if (snapshot) this.rateLimitHandler?.(snapshot);
+    }).catch((error) => {
+      if (isUnsupportedCodexMethodError(error)) this.rateLimitReadUnsupported = true;
+      logger.debug("[CodexAppServer] account/rateLimits/read failed:", errorLogMetadata(error));
+    }).finally(() => {
+      this.rateLimitReadInFlight = false;
+    });
+  }
   extractTurnId(params) {
     const turnId = params?.turn?.id ?? params?.turnId ?? params?.turn_id ?? null;
     return typeof turnId === "string" && turnId.length > 0 ? turnId : null;
@@ -142,6 +178,7 @@ class CodexAppServerClient {
     const aborted = status === "cancelled" || status === "canceled" || status === "aborted" || status === "interrupted";
     this.tryResolvePendingTurn(aborted, turnId, source);
     this._turnId = null;
+    this.maybeRefreshRateLimits();
     if (turnId && this.completedTurnIds.has(turnId)) {
       return;
     }
@@ -377,6 +414,7 @@ class CodexAppServerClient {
     this.notify("initialized");
     this.connected = true;
     logger.debug("[CodexAppServer] Connected and initialized");
+    this.maybeRefreshRateLimits();
   }
   async disconnectInternal(opts) {
     if (!this.connected && !this.process) return;
@@ -1050,6 +1088,7 @@ class CodexAppServerClient {
             `codex/event/${msg.type}`
           );
           this._turnId = null;
+          this.maybeRefreshRateLimits();
         }
       }
       return;
@@ -1077,6 +1116,11 @@ class CodexAppServerClient {
       }
       return;
     }
+    if (method === "account/rateLimits/updated") {
+      const snapshot = params?.rateLimits;
+      if (snapshot) this.rateLimitHandler?.(snapshot);
+      return;
+    }
     if (method === "mcpServer/startupStatus/updated") {
       logger.debug(`[CodexAppServer] mcpServer startup status:`, params);
       return;