aiterm-mcp 0.70.24 → 0.70.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.70.26] - 2026-11-11
11
+
12
+ - A Claude turn that ends on a usage limit now has a terminal outcome. Claude Code 2.1.322 holds such a turn ("Usage limit reached · continuing automatically at 7pm · esc to cancel") and runs no Stop hook, so its operation stayed pending, `pty_key` refused every key but C-c, and the seat's span kept running. Now, from the transcript and Aiterm's activity record only: `pty_list` rows of Claude agent sessions carry `last_input_at` and `limit_end {at, reset_at, continued, hold: armed|cancelled|null}`; the Claude wait returns `rate_limited` (exit 6) with the record text and `reset_at` (it was `error` with failure category `rate_limited`); seat turns close the span; and an operation whose turn ended on an API error or an interrupt record no longer counts as pending. `pty_key` now refuses keys other than C-c only while an operation is pending (before, on every correlated Claude seat), so Escape cancels an armed hold, and `hold` turns `cancelled`.
13
+ - `aiterm-update` now keeps the reason when the new version's `aiterm-setup` does not end `ready`. The result already carried `setup_status` and `setup_reason_code`, but the setup's own message (for example which probe step failed and why) was dropped, so reading it meant running setup again on that host. The last lines of the setup's error output now go into the result's `message`.
14
+
15
+ ## [0.70.25] - 2026-11-11
16
+
17
+ - `pty_list` with seat turns is faster on a host with many seats. Checking whether one seat exists listed every seat with its agent metadata, and each metadata read scanned the whole agents folder, so one call grew with the number of seats squared (10-27 s for about 140 members). The check now reads only the session names, with the same tmux call, retry and failures. On the production state, reading the turns of 48 seats went from 4.6 s to 2.3 s. What `pty_list` returns is unchanged.
18
+
10
19
  ## [0.70.24] - 2026-11-11
11
20
 
12
21
  - Closing a seat now also ends its idle-clock worker. `pty_close`, killing all sessions, and a fresh launch under the same name removed the clock record but left the waiting `sh`/`sleep` (PowerShell on Windows) running until its wake time, so a deleted member's `agent-idle-cli --session <name>` stayed visible on the host. Before the record is removed, the worker is ended when its PID and start time still match the record: on Linux and macOS its own process group (the shell, its sleep, and a checker that is just waking), on Windows its PowerShell. A process never ends its own clock. If the worker cannot be ended, it still exits at wake on the missing token, as before. Live seats are unchanged.
@@ -3301,7 +3310,9 @@ prototype (preserved under `prototype/python/` as the porting source and referen
3301
3310
  `ubuntu-latest` for Node 18/20/22, publishing to npm on `v*` tags with
3302
3311
  provenance.
3303
3312
 
3304
- [Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.70.24...HEAD
3313
+ [Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.70.26...HEAD
3314
+ [0.70.26]: https://github.com/kitepon/aiterm-mcp/compare/v0.70.25...v0.70.26
3315
+ [0.70.25]: https://github.com/kitepon/aiterm-mcp/compare/v0.70.24...v0.70.25
3305
3316
  [0.70.24]: https://github.com/kitepon/aiterm-mcp/compare/v0.70.23...v0.70.24
3306
3317
  [0.70.23]: https://github.com/kitepon/aiterm-mcp/compare/v0.70.22...v0.70.23
3307
3318
  [0.70.22]: https://github.com/kitepon/aiterm-mcp/compare/v0.70.21...v0.70.22
package/README.ja.md CHANGED
@@ -215,7 +215,7 @@ runtime-error store は canonical dotagents config の `collection.enabled: true
215
215
  場合だけ収集し、既定OFF、network送信は行いません。tag起点CIのnpm provenance(OIDC Trusted
216
216
  Publishing)で公開し、GitHub Release が Official MCP Registry を再登録します。
217
217
 
218
- **状態:** 開発継続中 · 現行公開版 **v0.70.24** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
218
+ **状態:** 開発継続中 · 現行公開版 **v0.70.26** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
219
219
 
220
220
  ### 更新と巻き戻し
221
221
 
package/README.md CHANGED
@@ -227,7 +227,7 @@ collection is off by default and performs no network I/O. It ships via
227
227
  tag-triggered CI with npm provenance (OIDC Trusted Publishing); the GitHub
228
228
  Release re-registers the Official MCP Registry entry.
229
229
 
230
- **Status:** actively maintained · current public release **v0.70.24** · 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).
230
+ **Status:** actively maintained · current public release **v0.70.26** · 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).
231
231
 
232
232
  ### Update and rollback
233
233
 
package/dist/core.js CHANGED
@@ -11,7 +11,7 @@ import { inspectIdleSettings, inspectCodexResumeSettings, codexRecoveryComposer
11
11
  import { AGENT_TUI_READY_TIMEOUT_MS, AGENT_TUI_FIRST_DRAW_TIMEOUT_MS, AGENT_TUI_READY_POLL_MS, isAgentTuiReady, isAgentTuiBusy, isAgentTuiIdleReady, agentPaneObservation, parentPaneEvidence, waitAgentTuiReadyImpl, detectAgentSubmitResidueImpl, waitCursorPromptVisibleImpl, settleAgentDoneScreenImpl } from "./agent-screen-observation.js";
12
12
  export { launchEchoIsLastOnScreen, __testSetAgentTuiReadyStableSamples } from "./agent-screen-observation.js";
13
13
  import { parseClaudeOperationMarker } from "./claude-operation-marker.js";
14
- import { withManagedSpan, observeManagedSpan, SPAN_HELD } from "./managed-seat-turn.js";
14
+ import { withManagedSpan, observeManagedSpan, closeManagedSpan, SPAN_HELD } from "./managed-seat-turn.js";
15
15
  /**
16
16
  * core — CLI/MCP が共有する端末操作とharness進行(Node/TS 版)。
17
17
  *
@@ -67,7 +67,7 @@ import { readFileOrNull, restoreJsonSetting, withUserConfigLock, restoreUserDefa
67
67
  import { isDeepStrictEqual } from "node:util";
68
68
  import { grokAuthPlan, grokAuthStatus, grokAuthPane, GROK_MODEL_DEFAULTS, realGrokHome, resolveAndValidateGrokAuth, assertGrokModelAvailable, grokModelChoices, grokModelFromFooter, grokFooterModelName, grokModelDefaultsFromBody, restoreGrokModelDefaults, grokEventsTranscript, grokSessionDirectory, latestGrokCompletion, grokTurnSettled, observeGrokDone, buildGrokAgentCmd, grokAgentArgv, writeGrokCallerFiles, checkGrokCallerInput, grokLaunchNote, grokEnvTokens, grokEnvEntries, grokTuiReady, grokPaneObservation, GROK_INTERRUPT_KEY, grokRateLimitDialog, grokPromptAwaitingAccept, grokUnacceptedPromptRestored, grokStartupAction, grokFooterHasConfiguration, grokTranscriptText, createGrokAgentMetadata, } from "./harnesses/grok.js";
69
69
  import { codexAuthPlan, codexAuthStatus, codexAuthPane, realCodexHome, readCodexConfigPins, bindCodexTranscriptSession, latestCodexCompletion, codexTurnSettled, codexCompletedTurnId, codexWorkingResumeConfiguration, captureCodexRecoveryProof, captureCodexResumeProof, readCodexResumeProof, codexResumeProofDigest, codexRootTranscript, codexRolloutSessionId, codexRunningTurn, codexInterruptionRecord, observeCodexDone, buildCodexAgentCmd, codexAgentArgv, codexResumeArgv, writeCodexCallerFiles, refuseCodexCallerInput, codexLaunchNote, codexPaneObservation, CODEX_INTERRUPT_KEY, codexHelperProcess, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, codexFastCommandOffered, codexFooterShowsFast, codexServiceTierNotices, restoreCodexDefaults, restoreCodexDefaultInFile, } from "./harnesses/codex.js";
70
- import { claudeAuthPlan, claudeAuthStatus, claudeAuthPane, claudeOauthTokenFile, claudeSetupTokenPlan, claudeOauthToken, claudeOauthTokenPresent, writeClaudeOauthToken, OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, claudeModelChoices, claudeConfigDir, claudeProjectSlug, claudeFastIndicatorShown, claudeFastResult, buildClaudeAgentCmd, claudeAgentArgv, claudeResumeArgv, claudeLaunchNote, claudePaneObservation, CLAUDE_INTERRUPT_KEY, claudeUsageLimit, claudeLiveSelectMenu, claudeStartupAction, createClaudeAgentMetadata, writeClaudeCallerFiles, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, claudeApiErrorEndingTurn, claudeFailureCategory, } from "./harnesses/claude.js";
70
+ import { claudeAuthPlan, claudeAuthStatus, claudeAuthPane, claudeOauthTokenFile, claudeSetupTokenPlan, claudeOauthToken, claudeOauthTokenPresent, writeClaudeOauthToken, OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, claudeModelChoices, claudeConfigDir, claudeProjectSlug, claudeFastIndicatorShown, claudeFastResult, buildClaudeAgentCmd, claudeAgentArgv, claudeResumeArgv, claudeLaunchNote, claudePaneObservation, CLAUDE_INTERRUPT_KEY, claudeUsageLimit, claudeLiveSelectMenu, claudeStartupAction, createClaudeAgentMetadata, writeClaudeCallerFiles, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, claudeLimitEnd, claudeInterruptedAfter, claudeLimitResetAt, claudeApiErrorEndingTurn, claudeFailureCategory, } from "./harnesses/claude.js";
71
71
  import { cursorAuthPlan, cursorAuthStatus, cursorAuthPane, bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, cursorTranscript, cursorTranscriptSessionId, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, cursorModelChoices, cursorModelIsFastVariant, cursorFastParameter, cursorHeaderShowsFast, cursorPickerView, cursorEffortSelected, cursorParameterRows, cursorUserConfigPath, CURSOR_DEFAULT_MODEL_KEYS, realCursorHome, buildCursorAgentCmd, cursorAgentArgv, cursorPromptWithLineage, cursorLineagePreface, writeCursorCallerFiles, checkCursorCallerInput, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, CURSOR_INTERRUPT_KEY, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, validateCursorModelEffort, } from "./harnesses/cursor.js";
72
72
  import { interimFromNow, interimFromToken, readInterimWords, recordInterimBoundary } from "./interim-words.js";
73
73
  import { codexSeatAwaitingRollout, codexSeatTurn, grokSteerAcceptance, observeSteerDone, readSteerEntry, recordSteer } from "./steer-follow.js";
@@ -1008,8 +1008,10 @@ export function sendKeyResult(name, key, o = {}) {
1008
1008
  assertExecutionContext(name);
1009
1009
  assertSessionName(name);
1010
1010
  const k = KEYMAP[key.toLowerCase()] ?? key;
1011
- if (!o.preserveAgentOperation && k !== "C-c" && isAgentSession(name) && managedClaudeOperation(name) !== undefined) {
1012
- throw new AitermError("aiterm相関付きClaude agent sessionではturn相関を壊さないC-cだけをpty_keyで送れます。" +
1011
+ // Protects a pending operation: another key (Enter, history, a menu choice) could submit other input whose Stop the hook would
1012
+ // file under that operation. Exits on its own at the turn's Stop, its API-error/limit record, or its interrupt record; close too.
1013
+ if (!o.preserveAgentOperation && k !== "C-c" && isAgentSession(name) && managedClaudeOperation(name)) {
1014
+ throw new AitermError("aiterm相関付きClaude agent sessionのturnが終わるまでは、turn相関を壊さないC-cだけをpty_keyで送れます。" +
1013
1015
  "他の対話操作はpty_send(自動dispatch)、終了はpty_closeを使ってください。", 2);
1014
1016
  }
1015
1017
  return withAgentNativeOperation(name, true, () => sendKeyResultInNative(name, key, o));
@@ -1493,6 +1495,24 @@ async function readOutputInNative(name, o) {
1493
1495
  return body + "\n" + meta + agentMeta + completionSuffix(status);
1494
1496
  return body + "\n" + meta + agentMeta;
1495
1497
  }
1498
+ /** The usage limit that ended the turn after this launch's last input, or null. Transcript and activity only, no screen. */
1499
+ function claudeSeatLimitEnd(meta) {
1500
+ const input = Date.parse(readAgentActivity(meta).last_input_at ?? "");
1501
+ return Number.isFinite(input) ? claudeLimitEnd(meta, input) : null;
1502
+ }
1503
+ /** pty_list fields of a Claude agent row. */
1504
+ function claudeListedFields(meta) {
1505
+ if (meta?.kind !== "claude")
1506
+ return {};
1507
+ try {
1508
+ const end = claudeSeatLimitEnd(meta);
1509
+ return { last_input_at: readAgentActivity(meta).last_input_at,
1510
+ limit_end: end && { at: end.at, reset_at: end.reset_at, continued: end.continued, hold: end.hold } };
1511
+ }
1512
+ catch {
1513
+ return { last_input_at: null, limit_end: null };
1514
+ }
1515
+ }
1496
1516
  function decodeActivityCursor(cursor, name) {
1497
1517
  let value;
1498
1518
  try {
@@ -1647,7 +1667,7 @@ export function observeSession(name, cursor) {
1647
1667
  result.state = "unknown";
1648
1668
  result.reason = `agent_${state}`;
1649
1669
  result.pane_alive = null;
1650
- const native = listNativeSessionsResult().sessions.some(row => row.session_id === name);
1670
+ const native = nativeSessionExists(name);
1651
1671
  if (state !== "hibernated" || native) {
1652
1672
  if (native && state === "hibernated")
1653
1673
  result.reason = "resume_native_conflict";
@@ -1662,7 +1682,7 @@ export function observeSession(name, cursor) {
1662
1682
  }
1663
1683
  // Discard the old pane's cursor; hibernation proves absence, not an activity delta.
1664
1684
  if (!isDeepStrictEqual(loadAgentMetadata(name), meta) || agentDormantState(meta) !== "hibernated"
1665
- || listNativeSessionsResult().sessions.some(row => row.session_id === name))
1685
+ || nativeSessionExists(name))
1666
1686
  return result;
1667
1687
  result.state = "hibernated";
1668
1688
  result.reason = "idle_timeout";
@@ -1689,10 +1709,10 @@ export function absentHarnessAlive(meta, platform = process.platform) {
1689
1709
  // Input admission needs the same native ownership proof, without activity capture or child-delivery scans.
1690
1710
  function observeSessionNative(name) {
1691
1711
  assertSessionName(name);
1692
- const listed = listNativeSessionsResult().sessions.find(session => session.session_id === name);
1712
+ const listed = nativeSessionExists(name);
1693
1713
  const result = {
1694
1714
  schema: "aiterm.pty-observe-result.v1", session_id: name, observed_at: new Date().toISOString(),
1695
- exists: !!listed, harness: null, launch_id: null, state: "missing", reason: "session_missing",
1715
+ exists: listed, harness: null, launch_id: null, state: "missing", reason: "session_missing",
1696
1716
  pane_alive: false, harness_alive: null, pane_process: null, harness_process: null, process_identity: null,
1697
1717
  token_hint: null, pending_child_deliveries: null,
1698
1718
  activity: { cursor: null, output_changed: null, cpu_seconds: null, cpu_delta_seconds: null, cpu_delta_complete: null,
@@ -2150,7 +2170,7 @@ function observeEmptyCreatedLaunch(target, alive) {
2150
2170
  export function observeExecutionParentProcess(name) {
2151
2171
  assertSessionName(name);
2152
2172
  return readExecutionParentProcess(name, {
2153
- present: () => listNativeSessionsResult().sessions.some(session => session.session_id === name),
2173
+ present: () => nativeSessionExists(name),
2154
2174
  metadata: () => tryLoadAgentMetadata(name),
2155
2175
  pane: () => tmux("display-message", "-p", "-t", name, "#{pane_pid}\t#{pane_dead}"),
2156
2176
  processes: readRuntimeProcesses,
@@ -2163,45 +2183,56 @@ export function observeExecutionParentProcess(name) {
2163
2183
  const SESSION_LIST_EXITING_RETRY_MS = 500;
2164
2184
  const SESSION_LIST_EXITING_POLL_MS = 20;
2165
2185
  const SESSION_LIST_SERVER_EXITING_RE = /server exited unexpectedly/i;
2166
- function listNativeSessionsResult(envKeys = [], runTmux = tmux) {
2167
- for (const key of envKeys) {
2168
- if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
2169
- throw new AitermError("env_keysの環境変数名が不正です", 2);
2170
- }
2186
+ /** The native session rows, unenriched. Each row is [name, command, attached, width, height]. */
2187
+ function listNativeSessionRows(runTmux = tmux) {
2171
2188
  const list = () => runTmux("list-sessions", "-F", "#{session_name}\t#{pane_current_command}\t#{session_attached}\t#{window_width}\t#{window_height}");
2172
2189
  let r = list();
2173
2190
  for (const deadline = performance.now() + SESSION_LIST_EXITING_RETRY_MS; r.code !== 0 && SESSION_LIST_SERVER_EXITING_RE.test(r.stderr) && performance.now() < deadline;) {
2174
2191
  pauseSync(SESSION_LIST_EXITING_POLL_MS);
2175
2192
  r = list();
2176
2193
  }
2177
- const sessions = [];
2178
2194
  if (r.code !== 0 && !/no server running|No such file or directory/i.test(r.stderr))
2179
2195
  throw new AitermError("セッション一覧を取得できません: " + r.stderr.trim(), 2);
2180
- if (r.code === 0)
2181
- for (const line of r.stdout.trim().split("\n").filter(Boolean)) {
2182
- const [name, command, attached, width, height] = line.split("\t");
2183
- assertSessionName(name);
2184
- const environment = {};
2185
- const registered = envKeys.length ? registeredSessionEnvironment(name) : null;
2186
- for (const key of envKeys) {
2187
- // sessionの表には開いたprocessの環境も入っている。返すのは名指しで登録した値だけ。
2188
- if (registered && !registered.includes(key)) {
2189
- environment[key] = null;
2190
- continue;
2191
- }
2192
- const value = tmux("show-environment", "-t", name, key);
2193
- if (value.code !== 0 && !/unknown variable|not found|not set/i.test(value.stderr))
2194
- throw new AitermError("session環境変数を照会できません", 2);
2195
- // psmuxは指定以外の内部キーも出すため、要求されたキーと完全一致した行だけを返す。
2196
- const selected = value.stdout.split(/\r?\n/).find(entry => entry.startsWith(`${key}=`));
2197
- environment[key] = selected === undefined ? null : selected.slice(key.length + 1);
2196
+ if (r.code !== 0)
2197
+ return [];
2198
+ const rows = r.stdout.trim().split("\n").filter(Boolean).map(line => line.split("\t"));
2199
+ for (const [name] of rows)
2200
+ assertSessionName(name);
2201
+ return rows;
2202
+ }
2203
+ /** Same listing and failure as pty_list, without loading every seat's metadata: one seat's existence check stays one
2204
+ * tmux call (2026-11-11: per-seat full lists made a CurrentWork pty_list take 10-27 s for ~140 members). */
2205
+ function nativeSessionExists(name) {
2206
+ return listNativeSessionRows().some(([listed]) => listed === name);
2207
+ }
2208
+ function listNativeSessionsResult(envKeys = [], runTmux = tmux) {
2209
+ for (const key of envKeys) {
2210
+ if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
2211
+ throw new AitermError("env_keysの環境変数名が不正です", 2);
2212
+ }
2213
+ const sessions = [];
2214
+ for (const [name, command, attached, width, height] of listNativeSessionRows(runTmux)) {
2215
+ const environment = {};
2216
+ const registered = envKeys.length ? registeredSessionEnvironment(name) : null;
2217
+ for (const key of envKeys) {
2218
+ // sessionの表には開いたprocessの環境も入っている。返すのは名指しで登録した値だけ。
2219
+ if (registered && !registered.includes(key)) {
2220
+ environment[key] = null;
2221
+ continue;
2198
2222
  }
2199
- const meta = tryLoadAgentMetadata(name);
2200
- sessions.push({ session_id: name, current_command: normalizePaneCommand(command), attached: Number(attached) > 0,
2201
- width: Number(width), height: Number(height), harness: meta ? agentHarness(meta.kind) : null,
2202
- launch_id: meta?.launch_id ?? null,
2203
- vendor_session_id: meta?.vendor_session_id ?? null, environment });
2223
+ const value = tmux("show-environment", "-t", name, key);
2224
+ if (value.code !== 0 && !/unknown variable|not found|not set/i.test(value.stderr))
2225
+ throw new AitermError("session環境変数を照会できません", 2);
2226
+ // psmuxは指定以外の内部キーも出すため、要求されたキーと完全一致した行だけを返す。
2227
+ const selected = value.stdout.split(/\r?\n/).find(entry => entry.startsWith(`${key}=`));
2228
+ environment[key] = selected === undefined ? null : selected.slice(key.length + 1);
2204
2229
  }
2230
+ const meta = tryLoadAgentMetadata(name);
2231
+ sessions.push({ session_id: name, current_command: normalizePaneCommand(command), attached: Number(attached) > 0,
2232
+ width: Number(width), height: Number(height), harness: meta ? agentHarness(meta.kind) : null,
2233
+ launch_id: meta?.launch_id ?? null,
2234
+ vendor_session_id: meta?.vendor_session_id ?? null, environment, ...claudeListedFields(meta) });
2235
+ }
2205
2236
  return { schema: "aiterm.pty-list-result.v1", observed_at: new Date().toISOString(), sessions };
2206
2237
  }
2207
2238
  export function listSessionsResult(envKeys = [], runTmux = tmux) {
@@ -2234,7 +2265,7 @@ export function listSessionsResult(envKeys = [], runTmux = tmux) {
2234
2265
  continue;
2235
2266
  }
2236
2267
  result.sessions.push({ session_id: name, launch_id: meta.launch_id, current_command: command, attached: false, width: 0, height: 0,
2237
- harness: agentHarness(meta.kind), vendor_session_id: meta.vendor_session_id ?? null, environment });
2268
+ harness: agentHarness(meta.kind), vendor_session_id: meta.vendor_session_id ?? null, environment, ...claudeListedFields(meta) });
2238
2269
  }
2239
2270
  return result;
2240
2271
  }
@@ -2860,7 +2891,24 @@ function managedClaudeOperation(name) {
2860
2891
  }
2861
2892
  if (meta.kind !== "claude")
2862
2893
  return undefined;
2863
- return readClaudeOperationMarker(meta);
2894
+ return pendingClaudeOperation(meta);
2895
+ }
2896
+ /** The marker of a turn still pending. A turn its API error ended (a usage-limit hold included) or an interrupt ended may never
2897
+ * get a Stop: its marker is kept, so the original waiter can still bind its input and read that end, but it is not pending. */
2898
+ function pendingClaudeOperation(meta) {
2899
+ const marker = readClaudeOperationMarker(meta);
2900
+ if (!marker)
2901
+ return null;
2902
+ let at;
2903
+ try {
2904
+ at = fs.statSync(agentClaudeOperationPath(meta.aiterm_session, meta.launch_id)).mtimeMs;
2905
+ }
2906
+ catch (error) {
2907
+ if (error.code === "ENOENT")
2908
+ return null;
2909
+ throw error;
2910
+ }
2911
+ return claudeApiErrorAfter(meta, at) || claudeInterruptedAfter(meta, at) ? null : marker;
2864
2912
  }
2865
2913
  function clearClaudeApiErrorOperation(meta) {
2866
2914
  const file = agentClaudeOperationPath(meta.aiterm_session, meta.launch_id);
@@ -3902,6 +3950,11 @@ function readManagedSeatTurn(meta) {
3902
3950
  || performance.now() - started >= 15_000)
3903
3951
  return null;
3904
3952
  const binding = JSON.stringify([meta.aiterm_session, meta.launch_id, meta.kind, conversation, proof, live.pane_process, live.harness_process]);
3953
+ // Claude holds a limit-ended turn with no Stop and a busy-looking footer; its transcript says the turn ended.
3954
+ const limited = meta.kind === "claude" ? claudeSeatLimitEnd(meta) : null;
3955
+ if (limited && !limited.continued) {
3956
+ return closeManagedSpan(file, binding, `limit:${limited.at}`, () => managedSpanStart(meta));
3957
+ }
3905
3958
  return observeManagedSpan(file, binding, evidence, terminal, new Date().toISOString(), () => managedSpanStart(meta));
3906
3959
  });
3907
3960
  return performance.now() - started < 15_000 ? result : null;
@@ -4184,7 +4237,8 @@ export async function observeAgentDone(name, o = {}) {
4184
4237
  if (o.expected_launch_id && !fs.existsSync(agentMetadataPath(name, o.expected_launch_id)))
4185
4238
  throw new ExecutionError("EXECUTION_STALE_GENERATION");
4186
4239
  const result = await observeAgentDoneInternal(name, o);
4187
- if ((result.outcome === "done" || result.outcome === "error") && result.at !== null) {
4240
+ // A rate_limited with `at` is a recorded end (Claude's limit record, Antigravity's quota Stop); a screen-read limit has none.
4241
+ if ((result.outcome === "done" || result.outcome === "error" || result.outcome === "rate_limited") && result.at !== null) {
4188
4242
  try {
4189
4243
  recordAgentTurnEnd({ aiterm_session: name, launch_id: result.launch_id }, {
4190
4244
  ...result, at: Number.isFinite(Date.parse(result.at)) ? result.at : new Date().toISOString(),
@@ -4284,8 +4338,9 @@ async function observeAgentDoneInternal(name, o = {}) {
4284
4338
  turn_id: ev?.turn_id ?? null,
4285
4339
  malformed_events: malformedEvents,
4286
4340
  at: ev?.at ?? apiError?.at ?? null,
4287
- rate_limit: rateLimit,
4288
- error: apiError?.text ?? null,
4341
+ rate_limit: rateLimit ?? (outcome === "rate_limited" ? apiError?.text ?? null : null),
4342
+ ...(outcome === "rate_limited" && apiError?.at ? { reset_at: claudeLimitResetAt(apiError.text, Date.parse(apiError.at)) } : {}),
4343
+ error: outcome === "rate_limited" ? null : apiError?.text ?? null,
4289
4344
  error_kind: apiError?.status ? `http_${apiError.status}` : null,
4290
4345
  ...(apiError ? { failure: { category: claudeFailureCategory(apiError), execution: sawExecution ? "started" : "unknown",
4291
4346
  boundary: transcriptBound && sawUser && apiError.session_id === meta.vendor_session_id && parentUuid !== null && apiError.parent_uuid === parentUuid && apiError.uuid !== null ? {
@@ -4332,7 +4387,7 @@ async function observeAgentDoneInternal(name, o = {}) {
4332
4387
  // 利用上限ではStopも走る。その番の最後の記録がAPIエラーなら、doneでなく誤りとして返す。
4333
4388
  const ended = scanned.event && meta.kind === "claude" ? claudeApiErrorEndingTurn(meta, scanned.event.at) : null;
4334
4389
  if (ended)
4335
- return observation("error", null, null, ended);
4390
+ return observation(claudeFailureCategory(ended) === "rate_limited" ? "rate_limited" : "error", null, null, ended);
4336
4391
  if (scanned.event?.done_status === "turn_error") {
4337
4392
  // agy ends a quota-stopped turn with ERROR; its Stop error names the limit (RESOURCE_EXHAUSTED, code 429).
4338
4393
  const limited = antigravityQuotaLimit(scanned.event.error);
@@ -4389,7 +4444,7 @@ async function observeAgentDoneInternal(name, o = {}) {
4389
4444
  for (const line of lines) {
4390
4445
  const apiError = claudeApiErrorFromLine(line);
4391
4446
  if (apiError && (apiError.session_id === null || apiError.session_id === meta.vendor_session_id))
4392
- return observation("error", null, null, apiError);
4447
+ return observation(claudeFailureCategory(apiError) === "rate_limited" ? "rate_limited" : "error", null, null, apiError);
4393
4448
  let record;
4394
4449
  try {
4395
4450
  record = JSON.parse(line);
@@ -4961,7 +5016,7 @@ function readExecutionAuthMetadata(name) {
4961
5016
  }
4962
5017
  /** 一覧の取得失敗を端末の消失へ丸めず、正規PTY一覧で存在を確認する。 */
4963
5018
  function authSessionExists(name) {
4964
- return listNativeSessionsResult().sessions.some(session => session.session_id === name);
5019
+ return nativeSessionExists(name);
4965
5020
  }
4966
5021
  function authSessionEnvironment(name, keys) {
4967
5022
  const env = { ...process.env };
@@ -40,7 +40,7 @@ const waitSchema = z.object({
40
40
  schema: z.literal("aiterm.agent-wait-result.v1"), session_id: executionLaunchSchema.shape.session_id,
41
41
  launch_id: executionLaunchSchema.shape.launch_id,
42
42
  outcome: z.enum(["done", "running", "timeout", "closed", "rate_limited", "error", "not_taken"]),
43
- operation_id: z.string().nullable(), turn_id: z.string().nullable(),
43
+ operation_id: z.string().nullable(), turn_id: z.string().nullable(), at: z.string().nullable().optional(),
44
44
  steer: z.object({ placement: z.enum(["same_turn", "next_turn", "unknown"]) }).optional(),
45
45
  });
46
46
  const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
@@ -158,7 +158,8 @@ export function createExecutionRuntime(bindings) {
158
158
  return unknown;
159
159
  // core's typed error means the harness recorded a terminal turn error;
160
160
  // generic MCP/RPC errors do not satisfy waitSchema and cannot get here.
161
- if (result.outcome !== "done" && result.outcome !== "error")
161
+ // rate_limited with `at` is a recorded terminal end (Claude limit record, Antigravity quota Stop); a screen-read limit is not.
162
+ if (result.outcome !== "done" && result.outcome !== "error" && !(result.outcome === "rate_limited" && result.at))
162
163
  return unknown;
163
164
  const evidence = await bindings.invocationFence?.(structuredClone(point)).catch(() => "unknown") ?? "unknown";
164
165
  const final = await observe(point.launch.session_id);
@@ -806,6 +806,130 @@ export function claudeApiErrorAfter(meta, startedAtMs) {
806
806
  }
807
807
  return null;
808
808
  }
809
+ /** Claude wrote its interrupt record ("[Request interrupted by user…]") at or after `sinceMs`: the turn was interrupted. */
810
+ export function claudeInterruptedAfter(meta, sinceMs) {
811
+ const file = claudeSessionTranscriptPath(meta);
812
+ if (!file)
813
+ return false;
814
+ let size;
815
+ try {
816
+ size = fs.statSync(file).size;
817
+ }
818
+ catch (error) {
819
+ if (error.code === "ENOENT")
820
+ return false;
821
+ throw error;
822
+ }
823
+ const lines = readFileRange(file, Math.max(0, size - AGENT_EVENT_TAIL_BYTES), size).toString("utf8").split("\n");
824
+ lines.pop();
825
+ return lines.some(line => {
826
+ if (!line.includes("[Request interrupted by user"))
827
+ return false;
828
+ try {
829
+ const record = JSON.parse(line), content = record?.message?.content;
830
+ const text = typeof content === "string" ? content : Array.isArray(content) ? content.map((part) => part?.text ?? "").join("") : "";
831
+ return record?.type === "user" && record.isSidechain !== true && (!record.sessionId || record.sessionId === meta.vendor_session_id)
832
+ && Date.parse(record.timestamp) >= sinceMs && /^\[Request interrupted by user\b/u.test(text.trim());
833
+ }
834
+ catch {
835
+ return false;
836
+ }
837
+ });
838
+ }
839
+ const MONTHS = ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"];
840
+ const zoneOffset = (ms, zone) => {
841
+ const parts = Object.fromEntries(new Intl.DateTimeFormat("en-US", { timeZone: zone, hourCycle: "h23", year: "numeric", month: "numeric",
842
+ day: "numeric", hour: "numeric", minute: "numeric", second: "numeric" }).formatToParts(ms).map(part => [part.type, part.value]));
843
+ return Date.UTC(+parts.year, +parts.month - 1, +parts.day, +parts.hour, +parts.minute, +parts.second) - Math.floor(ms / 1000) * 1000;
844
+ };
845
+ /** "… resets 7pm (UTC)" / "resets Nov 14, 4:30am (Asia/Tokyo)": the first such wall-clock instant after `atMs`. Null when it does not parse. */
846
+ export function claudeLimitResetAt(text, atMs) {
847
+ const hit = /\bresets\s+(?:([A-Za-z]{3})[a-z]*\s+(\d{1,2}),?\s+)?(\d{1,2})(?::(\d{2}))?\s*(am|pm)\s*\(([^)\s]+)\)/i.exec(text);
848
+ if (!hit || !Number.isFinite(atMs))
849
+ return null;
850
+ const [, mon, day, hour, minute = "0", meridiem, zone] = hit;
851
+ const month = mon ? MONTHS.indexOf(mon.toLowerCase()) : -1;
852
+ if (mon && month < 0)
853
+ return null;
854
+ const h = (+hour % 12) + (meridiem.toLowerCase() === "pm" ? 12 : 0);
855
+ try {
856
+ const local = new Date(atMs + zoneOffset(atMs, zone));
857
+ const toUtc = (y, m, d) => {
858
+ const wall = Date.UTC(y, m, d, h, +minute);
859
+ const first = wall - zoneOffset(wall, zone);
860
+ return wall - zoneOffset(first, zone);
861
+ };
862
+ let y = local.getUTCFullYear(), m = mon ? month : local.getUTCMonth(), d = mon ? +day : local.getUTCDate();
863
+ let result = toUtc(y, m, d);
864
+ // Not after the limit itself: the named time is the next one (tomorrow, or next year for a dated reset).
865
+ if (result <= atMs)
866
+ result = mon ? toUtc(++y, m, d) : toUtc(y, m, d + 1);
867
+ return Number.isFinite(result) ? new Date(result).toISOString() : null;
868
+ }
869
+ catch {
870
+ return null;
871
+ }
872
+ }
873
+ /**
874
+ * The rate_limited API error that ended the turn after `sinceMs` (the last input), with what Claude Code recorded after it.
875
+ * Claude Code 2.1.322 holds such a turn without a Stop hook ("Usage limit reached · continuing automatically at 7pm · esc to cancel")
876
+ * and continues it at the reset by itself; only its transcript shows the hold. Null when no such error follows the input.
877
+ */
878
+ export function claudeLimitEnd(meta, sinceMs) {
879
+ const file = claudeSessionTranscriptPath(meta);
880
+ if (!file || !Number.isFinite(sinceMs))
881
+ return null;
882
+ let size;
883
+ try {
884
+ size = fs.statSync(file).size;
885
+ }
886
+ catch (error) {
887
+ if (error.code === "ENOENT")
888
+ return null;
889
+ throw error;
890
+ }
891
+ const lines = readFileRange(file, Math.max(0, size - AGENT_EVENT_TAIL_BYTES), size).toString("utf8").split("\n");
892
+ lines.pop();
893
+ let end = null;
894
+ for (const line of lines) {
895
+ const error = claudeApiErrorFromLine(line);
896
+ if (error) {
897
+ if (error.at && Date.parse(error.at) >= sinceMs && (error.session_id === null || error.session_id === meta.vendor_session_id)
898
+ && claudeFailureCategory(error) === "rate_limited")
899
+ end = { at: error.at, reset_at: claudeLimitResetAt(error.text, Date.parse(error.at)), continued: false, hold: null, text: error.text };
900
+ else if (end)
901
+ end.continued = true;
902
+ continue;
903
+ }
904
+ if (!end)
905
+ continue;
906
+ let record;
907
+ try {
908
+ record = JSON.parse(line);
909
+ }
910
+ catch {
911
+ continue;
912
+ }
913
+ if (record?.isSidechain === true || (record?.sessionId && record.sessionId !== meta.vendor_session_id))
914
+ continue;
915
+ if (record?.type === "system" && record.subtype === "informational" && typeof record.content === "string") {
916
+ if (/^Usage limit reached\b.*\bcontinuing automatically\b/i.test(record.content))
917
+ end.hold = "armed";
918
+ else if (/^Automatic continue cancelled\b/i.test(record.content))
919
+ end.hold = "cancelled";
920
+ }
921
+ else if ((record?.type === "user" || record?.type === "assistant") && record.isMeta !== true) {
922
+ const content = record.message?.content;
923
+ // Slash commands typed on the seat (/rate-limit-options to re-arm) are not conversation work.
924
+ if (typeof content === "string" && /^\s*<(?:command-|local-command-)/u.test(content))
925
+ continue;
926
+ end.continued = true;
927
+ }
928
+ }
929
+ if (end?.continued)
930
+ end.hold = null;
931
+ return end;
932
+ }
809
933
  // ---- login "oauth_token" (BellTeam Claude 2nd slot, Owner ruling 2026-11-09): `claude setup-token` prints a 1-year token once;
810
934
  // Aiterm, as the PTY owner, writes it to the slot's token file. The CLI keeps no copy, so the file is the credential.
811
935
  const OAUTH_TOKEN_RE = /sk-ant-oat01-[A-Za-z0-9_-]{20,}/g;
package/dist/index.js CHANGED
@@ -829,6 +829,12 @@ export function createAitermServer(options = {}) {
829
829
  vendor_session_id: z.string().nullable().optional().describe("agent sessionのharness側の会話ID。Claude CodeとGrokは起動時に--session-idで渡した値(席の中で会話を移した後は追わない)、" +
830
830
  "CodexとCursorは分かった後の値。通常PTYと、まだ分からない席はnull"),
831
831
  environment: z.record(z.string(), z.string().nullable()),
832
+ // Claude agent rows only (0.70.26). Transcript and Aiterm's activity record, no screen; other rows omit both.
833
+ last_input_at: z.string().nullable().optional().describe("Claude agent rows: the last input Aiterm typed into this launch"),
834
+ limit_end: z.object({
835
+ at: z.string(), reset_at: z.string().nullable(), continued: z.boolean(), hold: z.enum(["armed", "cancelled"]).nullable(),
836
+ }).nullable().optional().describe("Claude agent rows: the usage limit that ended the turn after last_input_at (that turn is over; no Stop follows). " +
837
+ "continued: Claude recorded work after it. hold: Claude's automatic continue is armed, or was cancelled (pty_key Escape cancels an armed hold)"),
832
838
  })),
833
839
  },
834
840
  }, async ({ env_keys }, extra) => {
@@ -118,3 +118,15 @@ export function observeManagedSpan(file, binding, evidence, terminal, at, positi
118
118
  }
119
119
  return { state: "idle" };
120
120
  }
121
+ /** A turn the harness's own record ended without a completion hook (Claude's usage-limit hold): close its span now.
122
+ * `terminal` names that end, so a later busy frame opens a new span and only a newer terminal settles it. */
123
+ export function closeManagedSpan(file, binding, terminal, position = () => null) {
124
+ let record = null;
125
+ try {
126
+ record = recordSchema.parse(JSON.parse(fs.readFileSync(file, "utf8")));
127
+ }
128
+ catch { /* absent or unreadable: write a closed one */ }
129
+ if (record?.binding !== binding || record.span || record.terminal !== terminal)
130
+ writeJson0600(file, { binding, span: null, terminal, ready: null, settled_from: position() });
131
+ return { state: "idle" };
132
+ }
package/dist/update.js CHANGED
@@ -151,6 +151,9 @@ export function updateLocal(options) {
151
151
  base.setup_status = typeof setupResult?.status === "string" ? setupResult.status : null;
152
152
  if (typeof setupResult?.reason_code === "string")
153
153
  base.setup_reason_code = setupResult.reason_code;
154
+ // setupの失敗理由はstderrにしか出ない。残さないと読むために現地でsetupを流し直すことになる。
155
+ if (base.setup_status && base.setup_status !== "ready" && tail(setup.stderr))
156
+ base.message = `aiterm-setup: ${tail(setup.stderr)}`;
154
157
  if (!base.setup_status) {
155
158
  return { ...base, status, reason_code: "setup_failed", message: `aiterm-setup --json が結果を返しません: ${tail(setup.stderr) || setup.error || `exit ${setup.status}`}` };
156
159
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aiterm-mcp",
3
- "version": "0.70.24",
3
+ "version": "0.70.26",
4
4
  "mcpName": "io.github.kitepon/aiterm-mcp",
5
5
  "description": "Persistent terminal MCP with one harness-based launcher for Claude Code, Codex CLI, Grok CLI, Cursor Agent CLI, and Antigravity CLI, plus durable PTYs for SSH, containers, and REPLs.",
6
6
  "keywords": [