aiterm-mcp 0.37.8 → 0.37.10

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.37.10] - 2026-09-21
+
+### 修正
+
+- Codex 0.155.1 の「Approaching rate limits」model切替dialogを専用に認識する。通常の`pty_send`と`agent_configure`は同じsessionで一時的な「Keep current model」だけを選び、入力受付を再確認してから進める。model変更と今後の表示抑止は選ばない。復旧不能時はtyped errorで本文・設定変更を送らない。
+
+## [0.37.9] - 2026-09-21
+
+### 修正
+
+- Grok／Composerで前のターンのweekly-limitパネルが残っていても、通常の`pty_send`が一度閉じて今回の本文を送れるようにした。同じsessionを保ち、解除記録をreceiptへ返す。
+- Grokの利用上限は現在の画面から判定する。古い上限logによる新しいターンの待機打切りと、入力欄に重なったprivacy案内による誤停止を修正した。
+
 ## [0.37.8] - 2026-09-19
 
 ### 修正
@@ -1719,7 +1732,9 @@ prototype (preserved under `prototype/python/` as the porting source and referen
   `ubuntu-latest` for Node 18/20/22, publishing to npm on `v*` tags with
   provenance.
 
-[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.8...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.10...HEAD
+[0.37.10]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.9...v0.37.10
+[0.37.9]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.8...v0.37.9
 [0.37.8]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.7...v0.37.8
 [0.37.7]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.6...v0.37.7
 [0.37.6]: https://github.com/kitepon/aiterm-mcp/compare/v0.37.5...v0.37.6

package/README.ja.md

@@ -202,7 +202,7 @@ runtime-error store は canonical dotagents config の `collection.enabled: true
 場合だけ収集し、既定OFF、network送信は行いません。tag起点CIのnpm provenance（OIDC Trusted
 Publishing）で公開し、GitHub Release が Official MCP Registry を再登録します。
 
-**状態:** 開発継続中 · 現行公開版 **v0.37.8** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.37.10** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 
@@ -244,10 +244,14 @@ pty_read(id, { wait: true })       → 削減済みの出力を読む（完了
 
 Grok／Composerの無人起動は公式`--trust`で指定された作業フォルダを信頼登録し、確認画面を完了してから初回promptを送る。この登録はGrok CLIの信頼ストアへ保存され、フォルダ内のhook・MCP・LSPにも適用される。read-only sandboxの制限は維持する。画面に残る完了済みhookの結果は実行中と判定しない。
 
+Grok／Composerで終了済みターンのweekly-limitパネルが残っている場合、次の通常`pty_send`が`Shift+X`で一度閉じ、入力受付を確認して今回の本文を送る。同じsessionと会話を保ち、receiptの`pane_input_recovery`に`grok_rate_limit_dialog_dismissed`を記録する。ターン未終了・harness不在は`GROK_RATE_LIMIT_RECOVERY_BLOCKED`、解除後の入力受付失敗は`GROK_RATE_LIMIT_RECOVERY_FAILED`となり、本文は未送信。上限の継続は`rate_limited`として返し、過去promptは再送しない。Grokの上限観測には現在の画面だけを使う。
+
 Grok／Composerがread-only sandboxの適用を拒否した場合、prompt送信時に`GROK_SANDBOX_STARTUP_FAILED`とCLIの原因を返す。例えばhookのパスにシンボリックリンクがあるとGrok CLIは起動を拒否する。設定の管理元で原因を修正し、対象sessionを`pty_close`して起動し直す。Aitermはsandboxを解除したりhookをコピーしたりしない。
 
 この判定はGrok専用アダプターが所有し、同じCLIを使うComposerにも適用する。初回prompt付きの`agent_launch`と通常の`pty_send`で、入力受付待ち中に拒否を検出すると未送信のエラーを返す。promptなし・`trust_project`指定なしの起動応答は入力受付を保証しない。`trust_project:true`では入力受付まで確認し、`startup.status`を返す。Grokのprivacy notice起動設定も同アダプターが所有する。実装の責務分担は[DESIGN](docs/DESIGN.md#failure-and-recovery)を参照。
 
+Codex 0.155.1の「Approaching rate limits」model切替dialogは、通常の`pty_send`と`agent_configure`で同じsessionのまま一時的な**2. Keep current model**だけを選ぶ。入力受付を再確認してから本文または設定変更を進め、dispatch receiptの`pane_input_recovery`には`codex_rate_limit_model_switch_kept_current`を記録する。model切替と今後の表示抑止は選ばない。入力受付へ戻らなければ`CODEX_RATE_LIMIT_MODEL_SWITCH_RECOVERY_FAILED`となり、本文・設定変更は未送信。このdialogは`agent_approval`の対象ではなく、inspectは`reason="rate_limit_model_switch"`だけを返し、prompt digestとchoicesを出さない。
+
 ```text
 agent_launch({ harness: "codex-cli", session_name: "codex1", cwd: "/repo",
               prompt: "port test/legacy.py to vitest",

package/README.md

@@ -216,7 +216,7 @@ collection is off by default and performs no network I/O. It ships via
 tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
 Release re-registers the Official MCP Registry entry.
 
-**Status:** actively maintained · current public release **v0.37.8** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
+**Status:** actively maintained · current public release **v0.37.10** · runs on Linux · WSL2 · macOS · native Windows (tmux on POSIX, the tmux-CLI-compatible [psmux](https://github.com/psmux/psmux) on native Windows — no WSL required) · MIT · see the [CHANGELOG](CHANGELOG.md).
 
 ### Update and rollback
 
@@ -264,10 +264,14 @@ The same primitive hosts another agent's TUI. `agent_launch` starts a selected e
 
 Grok／Composerの無人起動は公式`--trust`で指定された作業フォルダを信頼登録し、確認画面を完了してから初回promptを送る。この登録はGrok CLIの信頼ストアへ保存され、フォルダ内のhook・MCP・LSPにも適用される。read-only sandboxの制限は維持する。画面に残る完了済みhookの結果は実行中と判定しない。
 
+Grok／Composerで終了済みターンのweekly-limitパネルが残っている場合、次の通常`pty_send`が`Shift+X`で一度閉じ、入力受付を確認して今回の本文を送る。同じsessionと会話を保ち、receiptの`pane_input_recovery`に`grok_rate_limit_dialog_dismissed`を記録する。ターン未終了・harness不在は`GROK_RATE_LIMIT_RECOVERY_BLOCKED`、解除後の入力受付失敗は`GROK_RATE_LIMIT_RECOVERY_FAILED`となり、本文は未送信。上限の継続は`rate_limited`として返し、過去promptは再送しない。Grokの上限観測には現在の画面だけを使う。
+
 Grok／Composerがread-only sandboxの適用を拒否した場合、prompt送信時に`GROK_SANDBOX_STARTUP_FAILED`とCLIの原因を返す。hookパスのシンボリックリンクなど、CLIが示した原因を設定の管理元で修正し、対象sessionを`pty_close`して起動し直す。Aitermはsandboxを解除したりhookをコピーしたりしない。
 
 この判定はGrok専用アダプターが所有し、同じCLIを使うComposerにも適用する。初回prompt付きの`agent_launch`と通常の`pty_send`で、入力受付待ち中に拒否を検出すると未送信のエラーを返す。promptなし・`trust_project`指定なしの起動応答は入力受付を保証しない。`trust_project:true`では入力受付まで確認し、`startup.status`を返す。Grokのprivacy notice起動設定も同アダプターが所有する。実装の責務分担は[DESIGN](docs/DESIGN.md#failure-and-recovery)を参照。
 
+Codex 0.155.1の「Approaching rate limits」model切替dialogは、通常の`pty_send`と`agent_configure`で同じsessionのまま一時的な**2. Keep current model**だけを選ぶ。入力受付を再確認してから本文または設定変更を進め、dispatch receiptの`pane_input_recovery`には`codex_rate_limit_model_switch_kept_current`を記録する。model切替と今後の表示抑止は選ばない。入力受付へ戻らなければ`CODEX_RATE_LIMIT_MODEL_SWITCH_RECOVERY_FAILED`となり、本文・設定変更は未送信。このdialogは`agent_approval`の対象ではなく、inspectは`reason="rate_limit_model_switch"`だけを返し、prompt digestとchoicesを出さない。
+
 For a correlated Claude turn stopped at `Do you want to proceed?`, use `claude_approval(action: "inspect", ...)` to capture the active operation and SHA-256 screen digest, review the displayed command, then call `respond` with that exact digest and either `approve_once` or `deny`. The relay rechecks the operation and screen under the send lock, never exposes arbitrary input or permanent approval, keeps the active marker intact, and records a prompt-free owner-only receipt. `pty_send(force: true)` does not bypass this boundary.
 
 ```text

package/dist/aiterm-wait-cli.js

@@ -89,8 +89,8 @@ export async function main(argv) {
     }
     catch (e) {
         // Grok は利用上限に達すると auth 正本を自壊させることがあり（2026-08-22 実測）、
-        // metadata 検証が「未ログイン」という嘘の原因で落ちる。pane log に上限バナーが
-        // あるなら、誤診でなく rate_limited として typed に回答する。
+        // metadata検証が認証不在で止まる。現在のviewportに上限パネルがある場合だけ
+        // rate_limitedとして返し、古いlogで現在の認証エラーを置き換えない。
         if (e instanceof AitermError && /Grok 認証正本/.test(e.message)) {
             const limited = detectAgentRateLimit("grok", cmd.session);
             if (limited) {

package/dist/core.js

@@ -18,8 +18,8 @@ import { readRuntimeProcesses, processSubtree, processIdentity, backgroundProces
 import { AitermError, telemetryOwnedFailure, ownTelemetryFailure } from "./errors.js";
 import { isWin, SOCKDIR, tmuxCommand, sendPsmuxPayload, loadPtyBufferChunk, pasteBufferBaseArgs, TMUX_EMPTY_CONFIG, attachCommand, normalizePaneCommand, atomicShellMultiline, appendMarkSentinel, markShellCommand, settlePaneLog, paneCwdArgument, sessionEnvironmentLaunch, } from "./tmux-runtime.js";
 import { sleep, currentUid, runtimeStateBase, safeStatSize, readFileRange, writeJson0600, createEmpty0600, shq, LAUNCH_ID_RE, AGENT_DONE_POLL_MS, AGENT_EVENT_MAX_BYTES, assertSessionName, agentsDir, agentEventPath, agentMetadataPath, writeAgentMetadata, AGENT_EVENT_TAIL_BYTES, agentLabel, agentHarness, subagentInstruction, agentLineageFields, } from "./agent-shared.js";
-import { GROK_MODEL_DEFAULTS, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokEventsTranscript, latestGrokCompletion, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
-import { bindCodexTranscriptSession, latestCodexCompletion, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, } from "./harnesses/codex.js";
+import { GROK_MODEL_DEFAULTS, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokEventsTranscript, latestGrokCompletion, observeGrokDone, buildGrokAgentCmd, grokLaunchNote, grokEnvTokens, grokTuiReady, grokTuiBusy, grokPaneObservation, grokRateLimitDialog, grokStartupAction, grokLaunchBlockingDialog, assertGrokSandboxNotRejected, GROK_COMPOSER_MARKER_RE, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
+import { bindCodexTranscriptSession, latestCodexCompletion, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, } from "./harnesses/codex.js";
 import { OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeStartupAction, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, } from "./harnesses/claude.js";
 import { bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, buildCursorAgentCmd, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
 import { resolveAgentBin, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
@@ -1414,7 +1414,7 @@ export function runAgentApproval(options) {
         const dialog = codexApprovalDialog(screen);
         if (!dialog) {
             result.status = state.state === "blocked" || state.state === "unknown" || action === "respond" ? "blocked" : "none";
-            result.reason = state.state === "blocked" ? "unknown_dialog" : state.state === "unknown" ? "unrecognized_screen" : "no_current_dialog";
+            result.reason = state.state === "blocked" ? state.reason : state.state === "unknown" ? "unrecognized_screen" : "no_current_dialog";
             return result;
         }
         result.kind = dialog.kind;
@@ -2590,20 +2590,21 @@ export function agentWaitGuide(session) {
     const cmd = `aiterm-wait --session ${session ?? "<session_id>"} --cursor 0`;
     return `完了通知は ${agentWaitLaunchForm(cmd)} で受ける（親はここで待たない・polling 不要）。receipt の outcome=done を確認してから再取得する。`;
 }
-// harness 別の利用上限バナー。検知は「報告」専用で、完了判定や自動復旧には使わない。
+// harness別の利用上限観測。Grok/Composerは現在の質問カード、他harnessは既存logを使う。
 // 出典（2026-08-22）: grok は live 実バナーで検証、codex/claude はインストール済み実バイナリの
 // 埋込文字列から抽出（codex: "You've hit your usage limit for" / claude: "Usage limit reached ·
 // continuing automatically when it resets"。Claude Code はリセット時に自動継続する設計なので、
 // この報告は「今は上限で止まっている」の観測であり恒久停止を意味しない）。
 const AGENT_RATE_LIMIT_PATTERNS = {
-    grok: [/You hit your weekly limit/i, /Weekly limit left:\s*0%/i],
-    composer: [/You hit your weekly limit/i, /Weekly limit left:\s*0%/i],
     codex: [/You'?ve hit your usage limit/i],
     claude: [/Usage limit reached/i],
 };
 const AGENT_RATE_LIMIT_SCAN_BYTES = 16 * 1024;
 // pane log の末尾から上限バナーを探す。読めない・無い・対象 harness でないは全て null（誤検知より取りこぼし側へ倒す）。
 export function detectAgentRateLimit(kind, aitermSession) {
+    if (kind === "grok" || kind === "composer") {
+        return grokRateLimitDialog(captureScreen(aitermSession, 0))?.message ?? null;
+    }
     const patterns = AGENT_RATE_LIMIT_PATTERNS[kind];
     if (!patterns)
         return null;
@@ -3241,6 +3242,31 @@ function sendMenuChoice(name, choice) {
         throw new AitermError(`agent設定の選択を送れませんでした: ${sent.stderr.trim() || `code=${sent.code}`}`, 2);
     }
 }
+/** Codexの上限接近modalは承認APIへ出さず、一時keepの2だけを選んで共通ready gateへ戻す。 */
+async function recoverCodexRateLimitModelSwitch(name, meta) {
+    const dialog = meta.kind === "codex"
+        ? codexRateLimitModelSwitchDialog(captureScreen(name, AGENT_TUI_READY_LINES))
+        : null;
+    if (!dialog)
+        return false;
+    const live = observeSession(name);
+    if (live.harness_alive !== true) {
+        throw new AitermError(`CODEX_RATE_LIMIT_MODEL_SWITCH_RECOVERY_BLOCKED: ${live.reason}。今回の文字列は送信していません。`, 2);
+    }
+    sendMenuChoice(name, String(dialog.keepCurrentIndex));
+    return true;
+}
+/** ready待機中に現れたCodex利用上限modalも、同じ一時keep復旧へ戻す。 */
+async function waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, timeoutMs) {
+    let codexRateLimitModelSwitch = await recoverCodexRateLimitModelSwitch(name, meta);
+    let ready = await waitAgentTuiReady(name, meta, timeoutMs);
+    if (!ready.ready && !codexRateLimitModelSwitch) {
+        codexRateLimitModelSwitch = await recoverCodexRateLimitModelSwitch(name, meta);
+        if (codexRateLimitModelSwitch)
+            ready = await waitAgentTuiReady(name, meta, timeoutMs);
+    }
+    return { ready, codexRateLimitModelSwitch };
+}
 /** 同じ対話sessionを保ったまま、harness標準の操作でmodel／effortを変更する。 */
 export async function configureAgent(name, opts) {
     assertSessionName(name);
@@ -3253,9 +3279,13 @@ export async function configureAgent(name, opts) {
     }
     const meta = loadAgentMetadata(name);
     bindCompletedInitialPrompt(meta);
-    const ready = await waitAgentTuiReady(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
-    if (!ready.ready)
+    const { ready, codexRateLimitModelSwitch } = await waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
+    if (!ready.ready) {
+        if (codexRateLimitModelSwitch) {
+            throw new AitermError(`CODEX_RATE_LIMIT_MODEL_SWITCH_RECOVERY_FAILED: ${codexPaneObservation(ready.lastScreen).reason}。設定変更は送信していません。`, 2);
+        }
         throw new AitermError(`agent session '${name}' は入力待ちではありません`, 2);
+    }
     if (meta.kind === "claude") {
         if (model) {
             await sendAgentPromptText(name, `/model ${model}`);
@@ -3440,13 +3470,38 @@ export async function dispatchAgentTurn(name, text, o = {}) {
         && agentCompletionCursor(meta) === 0
         && readClaudeOperationMarker(meta) === null;
     const paneInputRecovery = await ensureAgentOwnsPaneInput(name, meta.kind);
+    let codexRateLimitModelSwitch = false;
+    const limitDialog = meta.kind === "grok" || meta.kind === "composer"
+        ? grokRateLimitDialog(captureScreen(name, 0)) : null;
+    if (limitDialog) {
+        const live = observeSession(name);
+        const done = latestAgentDoneEvent(meta);
+        if (live.harness_alive !== true || done?.done_status !== "turn_error") {
+            const reason = live.harness_alive !== true ? live.reason : "latest_turn_not_error";
+            throw new AitermError(`GROK_RATE_LIMIT_RECOVERY_BLOCKED: ${reason}。終了済み上限パネルと確認できません。今回の文字列は送信していません。`, 2);
+        }
+        sendKey(name, limitDialog.dismissKey);
+    }
     if (meta.kind !== "claude" || claudeColdStart) {
-        const ready = await waitAgentTuiReady(name, meta, o.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS);
+        const recovery = await waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, o.ready_timeout ?? AGENT_TUI_READY_TIMEOUT_MS);
+        codexRateLimitModelSwitch = recovery.codexRateLimitModelSwitch;
+        const { ready } = recovery;
         if (!ready.ready) {
+            if (codexRateLimitModelSwitch) {
+                throw new AitermError(`CODEX_RATE_LIMIT_MODEL_SWITCH_RECOVERY_FAILED: ${codexPaneObservation(ready.lastScreen).reason}。今回の文字列は送信していません。`, 2);
+            }
+            if (limitDialog) {
+                const reason = grokPaneObservation(ready.lastScreen).reason;
+                throw new AitermError(`GROK_RATE_LIMIT_RECOVERY_FAILED: ${reason}。上限パネル解除後の入力受付を確認できません。今回の文字列は送信していません。`, 2);
+            }
             throw new AitermError(`agent session '${name}' の ${agentLabel(meta.kind)} TUI が入力受付状態になりません。文字列は送信していません。` +
                 "少し後で pty_read(screen:true) を確認し、TUI が起動済みなら再度 pty_send してください。", 2);
         }
     }
+    if (codexRateLimitModelSwitch)
+        paneInputRecovery.push("codex_rate_limit_model_switch_kept_current");
+    if (limitDialog)
+        paneInputRecovery.push("grok_rate_limit_dialog_dismissed");
     const startOffset = agentCompletionCursor(meta);
     // promptなしで起動したCursorは、最初のdispatch時点ではtranscriptとの相関markerをまだ持たない。
     // その1回だけlaunch contextを加え、以後はbind済みconversationへ通常textだけを送る。

package/dist/harnesses/codex.js

@@ -390,7 +390,7 @@ function currentCodexDialog(screen) {
     // 過去の完了footerより前の質問・選択番号を、現在のdialogへ持ち込まない。
     const previousFooter = footers.at(-2);
     const current = previousFooter ? screen.slice(previousFooter.index + previousFooter[0].length) : screen;
-    const heading = [...current.matchAll(/Would you like to run the following command\?|Allow the [^\n]+ MCP server to run tool|Hooks need review|Do you trust the contents of this directory|Update available!/g)].at(-1);
+    const heading = [...current.matchAll(/Would you like to run the following command\?|Allow the [^\n]+ MCP server to run tool|Hooks need review|Do you trust the contents of this directory|Update available!|Approaching rate limits/g)].at(-1);
     return heading ? current.slice(heading.index) : current;
 }
 export function codexPaneObservation(screen) {
@@ -400,7 +400,7 @@ export function codexPaneObservation(screen) {
     const tail = screen.split("\n").slice(-24).join("\n");
     // 現在のmodal footerがある時だけ、折返しで上へ出た質問を画面全体から探す。
     const lastComposer = [...tail.matchAll(/(?:^|\n)[ \t]*[›>](?![ \t]*\d+\.)/g)].at(-1)?.index ?? -1;
-    const lastDialog = [...tail.matchAll(/Press enter to confirm or esc to (?:cancel|go back)|enter to submit\s*\|\s*esc to cancel|Would you like to run the following command\?|Allow the [^\n]+ MCP server to run tool|Hooks need review|Do you trust the contents of this directory|Update available!/gi)].at(-1)?.index ?? -1;
+    const lastDialog = [...tail.matchAll(/Press enter to confirm or esc to (?:cancel|go back)|enter to submit\s*\|\s*esc to cancel|Would you like to run the following command\?|Allow the [^\n]+ MCP server to run tool|Hooks need review|Do you trust the contents of this directory|Update available!|Approaching rate limits/gi)].at(-1)?.index ?? -1;
     const modal = lastDialog > lastComposer;
     if (!modal) {
         if (/esc to interrupt/i.test(tail))
@@ -415,12 +415,35 @@ export function codexPaneObservation(screen) {
         return { state: "blocked", reason: "mcp_approval" };
     if (/Hooks need review/.test(current))
         return { state: "blocked", reason: "hooks_review" };
+    if (codexRateLimitModelSwitchDialog(current))
+        return { state: "blocked", reason: "rate_limit_model_switch" };
     if (codexLaunchBlockingDialog(current))
         return { state: "blocked", reason: "startup_dialog" };
     if (modal)
         return { state: "blocked", reason: "unknown_dialog" };
     return { state: "unknown", reason: "unrecognized_screen" };
 }
+/**
+ * Codex 0.155.1 の利用上限接近modal。agent_approvalの対象ではないため、選択肢は公開しない。
+ * 1はmodel切替、3は今後の表示抑止なので、Aitermが選んでよいのは一時keepの2だけである。
+ */
+export function codexRateLimitModelSwitchDialog(screen) {
+    const current = currentCodexDialog(screen);
+    const footer = current.lastIndexOf("Press enter to confirm or esc to go back");
+    const composer = [...current.matchAll(/(?:^|\n)[ \t]*[›>](?![ \t]*\d+\.)/g)].at(-1)?.index ?? -1;
+    // 現在のcomposerがmodal footerより後なら、scrollbackの古いmodalである。
+    if (composer > footer)
+        return null;
+    if (!/(?:^|\n)\s*Approaching rate limits\s*(?:\n|$)/.test(current)
+        || !/(?:^|\n)\s*Switch to gpt-5\.6-luna for lower credit usage\?\s*(?:\n|$)/.test(current)
+        || !/(?:^|\n)[ \t]*(?:›[ \t]*)?1\. Switch to gpt-5\.6-luna(?:[ \t]{2,}[^\n]*)?[ \t]*(?:\n|$)/.test(current)
+        || !/(?:^|\n)[ \t]*(?:›[ \t]*)?2\. Keep current model[ \t]*(?:\n|$)/.test(current)
+        || !/(?:^|\n)[ \t]*(?:›[ \t]*)?3\. Keep current model \(never show again\)(?:[ \t]{2,}[^\n]*)?[ \t]*(?:\n|$)/.test(current)
+        || !/Press enter to confirm or esc to go back/i.test(current))
+        return null;
+    const selected = current.match(/(?:^|\n)[ \t]*›[ \t]*([123])\. (?:Switch to gpt-5\.6-luna|Keep current model(?: \(never show again\))?)(?:[ \t]{2,}[^\n]*)?[ \t]*(?:\n|$)/)?.[1];
+    return { keepCurrentIndex: 2, selectedIndex: selected ? Number(selected) : null };
+}
 export function codexStartupFailure(screen) {
     return /(?:^|\n)[ \t]*[›>]?[ \t]*Error loading config\.toml:/m.test(screen)
         ? "configuration_error" : null;

package/dist/harnesses/grok.js

@@ -210,8 +210,11 @@ export async function observeGrokDone(meta, timeout, requestedCursor, detectRate
                     }
                     try {
                         const done = grokCompletionEvent(meta, JSON.parse(line));
-                        if (done)
-                            return observation(done.done_status === "turn_error" ? "error" : "done", done);
+                        if (done) {
+                            const limited = done.done_status === "turn_error"
+                                ? detectRateLimit(meta.kind, meta.aiterm_session) : null;
+                            return observation(limited ? "rate_limited" : done.done_status === "turn_error" ? "error" : "done", done, limited);
+                        }
                     }
                     catch {
                         malformedEvents++;
@@ -307,12 +310,34 @@ export function grokTuiBusy(screen) {
         || screen.includes("Responding...")
         || screen.includes("[stop]");
 }
+// 現在の質問カードだけを認識する。選択肢が空でも操作欄は残る。
+// footer後に描画があれば過去のカードなので、会話履歴からキー操作を起こさない。
+export function grokRateLimitDialog(screen) {
+    const clean = screen.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "");
+    const headings = [...clean.matchAll(/^[ \t]*[┃│]?[ \t]*You hit your weekly limit\.[ \t]*[┃│]?[ \t]*$/gm)];
+    const heading = headings.at(-1);
+    if (!heading)
+        return null;
+    const afterHeading = clean.slice(heading.index + heading[0].length);
+    const footer = /Tab\s*:\s*next\s+answer\s*[│┃]?\s*Esc\s*:\s*scrollback\s*[│┃]?\s*Shift\+x\s*:\s*dismiss/i.exec(afterHeading);
+    if (!footer || afterHeading.slice(footer.index + footer[0].length).trim())
+        return null;
+    const body = afterHeading.slice(0, footer.index);
+    if (grokTuiBusy(body) || /(?:^|\n)[ \t]*(?:│[ \t]*)?[❯>]/u.test(body))
+        return null;
+    return { message: "You hit your weekly limit.", dismissKey: "X" };
+}
+function grokFramedComposer(screen) {
+    return /^[ \t]*│[ \t]*[❯>][^\n]*\n(?:[ \t]*│[^\n]*\n)*[ \t]*╰[^\n]*\b(?:Grok|Composer)\s+[\w.()-]+[^\n]*╯[ \t]*(?:\n|$)/mu.test(screen);
+}
 export function grokPaneObservation(screen) {
     // 通信失敗後もWaitingが残る実画面を、稼働中として返さない。
     const tail = screen.split("\n").slice(-32).join("\n");
     if (/Connection failed|reqwest error stream|Check your network and try again/i.test(tail))
         return { state: "blocked", reason: "connection_failed" };
-    if (/Help improve Grok/.test(tail))
+    if (grokRateLimitDialog(tail))
+        return { state: "blocked", reason: "rate_limited" };
+    if (/Help improve Grok/.test(tail) && !grokFramedComposer(tail.slice(tail.lastIndexOf("Help improve Grok"))))
         return { state: "blocked", reason: "privacy_choice" };
     if (grokLaunchBlockingDialog(tail))
         return { state: "blocked", reason: "startup_dialog" };

package/docs/00_overview.md

@@ -22,6 +22,8 @@ Claude Code親の非同期hookによる受信は[DESIGN](DESIGN.md#claude-code
 
 ## 履歴と証拠
 
+- [Grokの上限パネル復帰の受入](https://github.com/kitepon/aiterm-mcp/blob/main/docs/adr/0069-grok-rate-limit-recovery.md): 通常送信による解除、公開package試験、本番導入と実機未検証範囲。
+
 - [`archive/`](https://github.com/kitepon/aiterm-mcp/tree/main/docs/archive): 完了・棄却・中断・失効・置換により現行制御から外れたsnapshot。
 - [`adr/`](https://github.com/kitepon/aiterm-mcp/tree/main/docs/adr): 採択・棄却した設計判断とrelease受入。
 - [`evidence/`](https://github.com/kitepon/aiterm-mcp/tree/main/docs/evidence): Lattice／campaignの検証証拠。

package/docs/DESIGN.md

@@ -200,6 +200,19 @@ Grok／Composerのmanaged起動は公式`--trust`を渡し、指定cwdの信頼
 `grokTuiBusy`は応答中の表示だけを実行中の根拠にし、完了後も残る`[hooks: 成功/失敗]`を含めない。
 これらのCLI固有判定は`src/harnesses/grok.ts`が所有し、共通処理は判定を呼び出す。
 
+Grok／Composerの終了済みerrorターンにweekly-limit質問カードが残る場合、通常dispatchだけが
+現在のviewportを読み、harness生存と最新turnのエラー完了を確かめて`X`を一回送る。
+既存の入力受付待機を通した後に完了cursorを取得し、今回の本文だけを送る。
+実施した解除は既存receiptの`pane_input_recovery`に`grok_rate_limit_dialog_dismissed`として載る。
+解除条件の不成立は`GROK_RATE_LIMIT_RECOVERY_BLOCKED`、解除後の入力受付失敗は
+`GROK_RATE_LIMIT_RECOVERY_FAILED`で未送信を返す。読取・観測・設定・steerはこの解除を行わない。
+
+`grokRateLimitDialog`が見出しと操作footerの組を所有し、過去logや後続UIのあるカードは採用しない。
+privacy案内は現在の枠付きcomposerとmodel footerが見える場合だけ入力受付を妨げない。
+完了観測は成功eventを優先し、今回のerror eventと現在のカードが揃えばturn情報付きの`rate_limited`を返す。
+新turnの完了前に古いlogだけで上限を返さない。購入・再認証・過去prompt再送・定期再試行は行わない。
+画面判定と模擬CLIの実PTY試験は`test/grok-rate-limit.test.mjs`に置く。
+
 ## Platform contract
 
 - macOS／Linux／WSL2: tmux。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.37.8",
+  "version": "0.37.10",
   "mcpName": "io.github.kitepon/aiterm-mcp",
   "description": "Persistent terminal MCP with one harness-based launcher for Claude Code, Codex CLI, Grok CLI, and Cursor Agent CLI, plus durable PTYs for SSH, containers, and REPLs.",
   "keywords": [