aiterm-mcp 0.27.3 → 0.27.6

package/dist/aiterm-wait-cli.js

@@ -2,12 +2,12 @@
 // aiterm-wait — agent turn 完了eventの純リーダー観測CLI。
 // 完了/timeout/close を1行のJSON receiptで返してexitする。lock・PTY・dispatch状態には一切触れない。
 // 親AIホストのバックグラウンドタスクとして起動し、exitを「観測終了の通知」として使う。
-// exit≠完了: exit code は outcome を映す（0=done / 5=running=未完了 / 3=timeout=未完了 / 4=closed / 1=エラー）。
+// exit≠完了: exit code は outcome を映す（0=done / 5=running=未完了 / 3=timeout=未完了 / 4=closed / 6=rate_limited=vendor利用上限 / 1=エラー）。
 // --timeout 0 は待たずに一度だけ観測する照会で、未完了は running（timeout と混同させない）。
 // receipt の outcome が正で、done 以外は未完了。timeout の既定は core の DEFAULT_AGENT_DONE_TIMEOUT（600秒）。
 import { fileURLToPath } from "node:url";
 import * as fs from "node:fs";
-import { AitermError, observeAgentDone } from "./core.js";
+import { AitermError, detectAgentRateLimit, observeAgentDone } from "./core.js";
 const SESSION_RE = /^[A-Za-z0-9_-]{1,64}$/;
 const OPERATION_RE = /^sha256:[0-9a-f]{64}$/;
 const USAGE = "usage: aiterm-wait --session <name> [--cursor <event_cursor>] [--operation sha256:<64hex>] [--timeout <sec>]" +
@@ -74,14 +74,39 @@ const OUTCOME_EXIT_CODES = {
     running: 5,
     timeout: 3,
     closed: 4,
+    rate_limited: 6,
 };
 export async function main(argv) {
     const cmd = parseArgs(argv);
-    const result = await observeAgentDone(cmd.session, {
-        operation_id: cmd.operationId,
-        timeout: cmd.timeout,
-        cursor: cmd.cursor,
-    });
+    let result;
+    try {
+        result = await observeAgentDone(cmd.session, {
+            operation_id: cmd.operationId,
+            timeout: cmd.timeout,
+            cursor: cmd.cursor,
+        });
+    }
+    catch (e) {
+        // Grok は利用上限に達すると auth 正本を自壊させることがあり（2026-08-22 実測）、
+        // metadata 検証が「未ログイン」という嘘の原因で落ちる。pane log に上限バナーが
+        // あるなら、誤診でなく rate_limited として typed に回答する。
+        if (e instanceof AitermError && /Grok 認証正本/.test(e.message)) {
+            const limited = detectAgentRateLimit("grok", cmd.session);
+            if (limited) {
+                emit({
+                    ok: false,
+                    code: "AGENT_RATE_LIMITED",
+                    vendor: "grok",
+                    rate_limit: limited,
+                    message: "Grok が利用上限に達している。別のベンダーのモデルに切り替えてください。" +
+                        "（認証正本の不在は上限時に CLI が auth を自壊させた痕跡で、未ログインの誤診に注意）",
+                });
+                process.exitCode = 6;
+                return;
+            }
+        }
+        throw e;
+    }
     emit(result);
     process.exitCode = OUTCOME_EXIT_CODES[result.outcome];
 }

package/dist/core.js

@@ -2998,6 +2998,48 @@ export function agentWaitGuide(session) {
     const cmd = `aiterm-wait --session ${session ?? "<session_id>"} --cursor 0`;
     return `完了通知は ${agentWaitLaunchForm(cmd)} で受ける（親はここで待たない・polling 不要）。receipt の outcome=done を確認してから再取得する。`;
 }
+// vendor 別の利用上限バナー。検知は「報告」専用で、完了判定や自動復旧には使わない。
+// 出典（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 の末尾から上限バナーを探す。読めない・無い・対象 vendor でないは全て null（誤検知より取りこぼし側へ倒す）。
+export function detectAgentRateLimit(kind, aitermSession) {
+    const patterns = AGENT_RATE_LIMIT_PATTERNS[kind];
+    if (!patterns)
+        return null;
+    const file = logpath(aitermSession);
+    let size;
+    try {
+        size = fs.statSync(file).size;
+    }
+    catch {
+        return null;
+    }
+    if (size === 0)
+        return null;
+    let text;
+    try {
+        text = readFileRange(file, Math.max(0, size - AGENT_RATE_LIMIT_SCAN_BYTES), size).toString("utf8");
+    }
+    catch {
+        return null;
+    }
+    const clean = text.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "");
+    for (const re of patterns) {
+        const match = clean.match(re);
+        if (match)
+            return match[0];
+    }
+    return null;
+}
 async function observeCodexDone(meta, timeout, requestedCursor) {
     const metadataFile = agentMetadataPath(meta.aiterm_session, meta.launch_id);
     let transcript = codexRootTranscript(meta);
@@ -3008,7 +3050,7 @@ async function observeCodexDone(meta, timeout, requestedCursor) {
     let discardLeadingFragment = false;
     let initializedBoundary = false;
     const deadline = performance.now() + timeout * 1000;
-    const observation = (outcome, ev = null) => ({
+    const observation = (outcome, ev = null, rateLimit = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
         launch_id: meta.launch_id,
@@ -3019,6 +3061,7 @@ async function observeCodexDone(meta, timeout, requestedCursor) {
         turn_id: ev?.turn_id ?? null,
         malformed_events: malformedEvents,
         at: ev?.at ?? null,
+        rate_limit: rateLimit,
     });
     for (;;) {
         if (!fs.existsSync(metadataFile))
@@ -3067,6 +3110,11 @@ async function observeCodexDone(meta, timeout, requestedCursor) {
                 }
             }
         }
+        {
+            const limited = detectAgentRateLimit(meta.kind, meta.aiterm_session);
+            if (limited)
+                return observation("rate_limited", null, limited);
+        }
         if (performance.now() >= deadline)
             return observation(timeout === 0 ? "running" : "timeout");
         await sleep(AGENT_DONE_POLL_MS);
@@ -3084,7 +3132,7 @@ async function observeGrokDone(meta, timeout, requestedCursor) {
     let discardLeadingFragment = false;
     let initializedBoundary = false;
     const deadline = performance.now() + timeout * 1000;
-    const observation = (outcome, ev = null) => ({
+    const observation = (outcome, ev = null, rateLimit = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
         launch_id: meta.launch_id,
@@ -3095,6 +3143,7 @@ async function observeGrokDone(meta, timeout, requestedCursor) {
         turn_id: ev?.turn_id ?? null,
         malformed_events: malformedEvents,
         at: ev?.at ?? null,
+        rate_limit: rateLimit,
     });
     for (;;) {
         if (!fs.existsSync(metadataFile))
@@ -3141,6 +3190,11 @@ async function observeGrokDone(meta, timeout, requestedCursor) {
                 }
             }
         }
+        {
+            const limited = detectAgentRateLimit(meta.kind, meta.aiterm_session);
+            if (limited)
+                return observation("rate_limited", null, limited);
+        }
         if (performance.now() >= deadline)
             return observation(timeout === 0 ? "running" : "timeout");
         await sleep(AGENT_DONE_POLL_MS);
@@ -3173,7 +3227,7 @@ export async function observeAgentDone(name, o = {}) {
     let cursor = startOffset;
     let carry = "";
     let malformedEvents = 0;
-    const observation = (outcome, ev = null) => ({
+    const observation = (outcome, ev = null, rateLimit = null) => ({
         schema: "aiterm.agent-wait-result.v1",
         session_id: meta.aiterm_session,
         launch_id: meta.launch_id,
@@ -3184,6 +3238,7 @@ export async function observeAgentDone(name, o = {}) {
         turn_id: ev?.turn_id ?? null,
         malformed_events: malformedEvents,
         at: ev?.at ?? null,
+        rate_limit: rateLimit,
     });
     for (;;) {
         if (!fs.existsSync(metadataFile))
@@ -3211,6 +3266,11 @@ export async function observeAgentDone(name, o = {}) {
         }
         // timeout=0 は「待たずに一度だけ見る」照会＝未完了は失敗ではなく running。
         // 1秒以上を指定した待機の未完了は従来どおり timeout で、待ち方の意味は変えない。
+        {
+            const limited = detectAgentRateLimit(meta.kind, meta.aiterm_session);
+            if (limited)
+                return observation("rate_limited", null, limited);
+        }
         if (performance.now() >= deadline)
             return observation(timeout === 0 ? "running" : "timeout");
         await sleep(AGENT_DONE_POLL_MS);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiterm-mcp",
-  "version": "0.27.3",
+  "version": "0.27.6",
   "mcpName": "io.github.kitepon/aiterm-mcp",
   "description": "Persistent tmux terminal MCP for launching and driving Claude, Codex, Grok, or Composer from any MCP client, cross-vendor or same-vendor. Also runs durable PTY sessions for SSH, containers, and REPLs.",
   "keywords": [
@@ -26,7 +26,7 @@
   ],
   "license": "MIT",
   "author": {
-    "name": "Quo / クオ at kitepon.dev",
+    "name": "Quo / \u30af\u30aa at kitepon.dev",
     "url": "https://kitepon.dev/"
   },
   "repository": {