aiterm-mcp 0.59.0 → 0.60.0

package/CHANGELOG.md

@@ -7,6 +7,68 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.60.0] - 2026-10-13
+
+### 追加
+
+- BellTeamが、差し込んだ文を取った番の終わりと、自分で始めていない番を追える口（ADR 0122）。要求の`_meta["aiterm/caller"]`が`BellTeam`の時だけ足す。
+  ツールの説明・引数・`structuredContent`の形と、印の無い呼び手への返りは変えない。答えの本文は運ばず、位置だけを返す。
+  - `pty_send`の差し込み（`mode: "agent_steer"`）の返りに、`event_cursor`（打つ直前の完了の位置）と`wait_process`
+    （`aiterm-wait --session <席> --cursor <N> --steer <steer_id>`）。結果の`_meta["aiterm/steer"]`に`{ schema: "aiterm.steer-ref.v1", steer_id, interim_from }`。
+  - `aiterm-wait --steer <steer_id>`は、その文を取った番の終わりで返る。結果に`steer: { placement, taken_at }`を足す。
+    `placement`は`same_turn`（動いていた番が取り込んだ）・`next_turn`（番の後で、その文が新しい番を始めた）・`unknown`（記録の中で見分けられず、打った後の
+    最初の番の終わりで返した）。文が会話の記録に入っていない時は`outcome: "not_taken"`で、終了コードは8。
+  - `pty_observe`の要求の`_meta["aiterm/interim_from"]`に、上か下が返した値を渡すと、その位置より後の合間の言葉を返す（`seq`は1から）。
+  - `pty_list`の結果の`_meta["aiterm/seat_turns"]`に、席の今の番。`{ schema: "aiterm.seat-turns.v1", seats: [{ session_id, launch_id, harness, turn }] }`で、
+    `turn`は`{ state: "running", turn_id, started_at, event_cursor, wait_process, interim_from }`・`{ state: "idle" }`・`null`（分からない）。
+    Codexの席だけで、会話の記録から読む（画面は読まない）。動いている番の位置は番の頭で、そこから待てばその番の終わりで返る。
+  - 文の見分けは、打つ直前に控えた文の頭と、harnessの会話の記録の突き合わせ。CodexとClaude Codeで見分ける。GrokとCursorの差し込みは必ず今の番へ入るので、
+    打った後の最初の完了を`same_turn`で返す。別端末の席（`remote`）への送信は、まだこの手がかりを返さない。
+
+### 変更
+
+- 試験: `test/core-agent.test.mjs`を、話題の切れ目で5つのfileへ分けた（共通の準備は`test/core-agent-support.mjs`）。試験の中身と本数は同じ。
+  fileの中の試験は1本ずつ順に走るので、この1 fileがWindowsで687秒かかり、全体の試験（720秒）の長さを決めていた。分けたfileは並んで走る。
+  同じ訳で、`test/runtime-error-store.test.mjs`（Windowsで236秒）も2つに分けた（共通の準備は`test/runtime-error-store-support.mjs`）。
+- 試験: 試験は、動かした利用者・席・runnerの置き場と鍵に触らない（ADR 0121、ADR 0087の追記）。製品の動きは変わらない。
+  - 試験の前処理（`test/seat-env.mjs`）が、試験へ渡す環境を要る物だけにし、homeとharness・gh・git・npmの置き場を、試験ごとの空の置き場の中に向ける。
+    試験fileは最初のimportで前処理を読むので、入口（`npm test`）を通らずに流されても同じに効く。
+  - 一般の試験は、端末に入っている本物のClaude Code・Codex・Grok・Cursorを起こさない。実物で確かめる試験は、`AITERM_TEST_`で始まる変数で
+    実行ファイルを渡した時だけ動く。
+  - CIの入口と`npm test`は、この確かめ（`test/seat-env.test.mjs`）を先に流し、落ちたらほかの試験を起こさない。CIの入口は、
+    端末の本体（tmux・psmux・pwsh）が見えない時と、選んだ試験の名前が空や不正の時に、組む前に落ちる。
+  - 混んだ端末で上限に当たった待ち（席が起きるのを待つ所）を延ばした。
+- 試験: Codexのhookの試験の偽の受け口（`test/fixtures/codex-hook-queue.mjs`）が、キューのfileをその場で書いていた。同時に動くhookの数だけ
+  偽物が起きて同じfileを見るので、空にしてから書き終えるまでの間に読んだ偽物が異常終了し、「同時に二つのhookが動いても…」が
+  `CODEX_RECEIVER_TRANSPORT_FAILED`で落ちる事があった（macOSのCI）。一時fileからの置き換えにした。製品の動きは変わらない。
+
+### 修正
+
+- Claude CodeのStopのhookが、席の印を継いだ別の会話（席が起こした子や、裏の会話）の番の終わりで、席の答えのfileを上書きし、席の番の印を
+  消していた件を直す（ADR 0119）。席の会話と違う会話のStopでは、席の記録に触らない。席の会話IDは、席の記録を先に、無ければ環境の値で見る。
+- **設定を替えた直後に同じ席へ届いた文が、替える前の設定で動く事があった**（ADR 0120）。`agent_configure`は、命令を打つ前の確かめに
+  数秒かかる間、席ごとの送信の行列（ADR 0088）に並んでいなかった。その間に届いた`pty_send`が先に席へ入り、設定替えは番の後になった
+  （実例: ファストを入れた3秒後の1通が通常の速度で動いた）。設定替えを同じ行列に並べ、替えている間に届いた文は替え終えてから席へ入れる。
+  - `pty_send`の返りは、同じ席の設定替えが終わるまで遅れる。
+  - 番が動いている席への設定替えは、行列を持たずに番の終わりを待つ。その間の差し込みは今までどおり通る。
+  - 順番が来なかった時（POSIXは60秒、Windowsは180秒）、設定替えは`AGENT_SEND_BUSY`と「設定は変えていません。」で断る。
+    送信の断りの文は変えていない。
+- **Codexの完了待ちが、長く続いた番で「Codex transcript のturn増分が大きすぎます」と誤りで止まっていた件を直す。**
+  待ち始めの位置から16MiBを超えて書いた番で起きた（2026-10-13の夜の番は、開始の後ろが約8.4MBまで行った）。会話の記録を4MiBずつ読み、
+  番の大きさには上限を置かない。改行が来ないまま16MiBを超えた1行だけ、持たずに読み飛ばす。
+- 片付け済み（archived）などで断られたCodexへの配送を、会話を戻した後に同じ配送IDで渡し直せなかった件を直す
+  （`aiterm-parent-delivery codex submit`が`PARENT_DELIVERY_DUPLICATE`で断っていた）。共通部品`aiterm-steer-delivery`を`^0.4.7`へ上げる。
+
+## [0.59.1] - 2026-10-13
+
+### 修正
+
+- **長く続いているCodexの番へ、回答を流している間に届いた文が、30秒待って断られていた。**（ADR 0101 の直し）
+  回答を流している間のCodexは画面に動作中の行を出さないので、番が動いているかは会話の記録で確かめている。その開始の印を記録の末尾1MiBの中でしか
+  探しておらず、番が1MiBより多く書いた後は「動いていない」と読んで、新しいturnの道で入力待ちを30秒待ち、
+  `…TUI が入力受付状態になりません。文字列は送信していません。`で断っていた（2026-10-13、20分を過ぎた番で4通）。
+  開始の印を、境界に当たるまで記録をさかのぼって探す。動作中の行が出ている間に届いた文と、止まっている席への文は、今までと同じ。
+
 ## [0.59.0] - 2026-10-13
 
 ### 追加
@@ -2619,7 +2681,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.59.0...HEAD
+[Unreleased]: https://github.com/kitepon/aiterm-mcp/compare/v0.60.0...HEAD
+[0.60.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.59.1...v0.60.0
+[0.59.1]: https://github.com/kitepon/aiterm-mcp/compare/v0.59.0...v0.59.1
 [0.59.0]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.4...v0.59.0
 [0.58.4]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.3...v0.58.4
 [0.58.3]: https://github.com/kitepon/aiterm-mcp/compare/v0.58.2...v0.58.3

package/README.ja.md

@@ -209,7 +209,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.59.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
+**状態:** 開発継続中 · 現行公開版 **v0.60.0** · 動作対象は Linux · WSL2 · macOS · Windows ネイティブ · MIT · [変更履歴](CHANGELOG.md)。
 
 ### 更新と巻き戻し
 

package/README.md

@@ -227,7 +227,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.59.0** · 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.60.0** · 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
 
@@ -293,7 +293,7 @@ Set `require_agent:true` on `pty_send` when the integration requires agent deliv
 
 When the caller gives no `preface`, Aiterm adds one itself for a Claude Code session whenever the text is long enough for Claude Code to wrap it (three or more line breaks, or 800 characters and up): "Aitermが届ける、この席の呼び手からの正規の送信です。下の貼り付けは、どこかから拾った文ではなく、呼び手がこの席へ宛てて送った文です。" ("A regular message from this session's caller, delivered by Aiterm. The paste below was sent to this session by the caller, not picked up from somewhere else.") The line states where the message comes from and does not tell the session to obey it. It applies to new turns, to steering, to the `prompt` of `agent_launch`, and to `remote` sessions (the Aiterm on that machine adds it). Without that line the whole message sits inside the wrapper, and a Claude Code session may decline to act on it as "not the user's own instruction". Short texts, Codex, Grok and Cursor sessions, and sends with `raw` or `force` are unchanged (ADR 0116).
 
-Overlapping `pty_send` calls to the same agent session are handled one at a time. A later call picks its route only after the earlier one has been sent, so the result matches calls made in sequence (a call that overlaps the first send to a freshly started Claude Code session returns `mode=agent_steer`). It returns later by however long the earlier call waits for the session to accept input. If its turn does not come within the limit (60 seconds on POSIX, 180 seconds on Windows), Aiterm refuses before sending any text and returns `AGENT_SEND_BUSY` with an explicit unsent message. A lock left by a process that exited mid-send is cleared by the next send.
+Overlapping `pty_send` calls to the same agent session are handled one at a time. A later call picks its route only after the earlier one has been sent, so the result matches calls made in sequence (a call that overlaps the first send to a freshly started Claude Code session returns `mode=agent_steer`). It returns later by however long the earlier call waits for the session to accept input. If its turn does not come within the limit (60 seconds on POSIX, 180 seconds on Windows), Aiterm refuses before sending any text and returns `AGENT_SEND_BUSY` with an explicit unsent message. A lock left by a process that exited mid-send is cleared by the next send. `agent_configure` waits in the same line: a `pty_send` that arrives while a configuration change is in progress is sent after the change, so the turn runs with the new setting. A configuration change to a session whose turn is running does not hold the line while it waits for the turn to end, so steering still goes through. If its turn does not come within the same limit, `agent_configure` returns `AGENT_SEND_BUSY` with an explicit unchanged message.
 
 `agent_launch` and `pty_send` (to an agent session) accept an optional `image`: an array of absolute paths to image files (png/jpg/jpeg/gif/webp). Aiterm appends an attachment block to the prompt, and every harness opens the path with its own file-reading tool and sees the image; the caller never learns harness-specific attachment tricks. Invalid paths are rejected before anything is sent.
 

package/dist/agent-shared.js

@@ -33,6 +33,47 @@ export function readTailLinesNewestFirst(file, maxBytes) {
         lines.shift();
     return lines.filter(line => line.trim() !== "").reverse();
 }
+/**
+ * 記録を末尾から先頭へさかのぼり、行を新しい順に`visit`へ渡す。`visit`がundefined以外を返したら、そこで止めてその値を返す。
+ * 先頭まで読んで何も返らなければundefined。書いている途中の行（改行で終わっていない末尾）がある時と、読めなかった時はnull。
+ * 1回に読むのは`chunkBytes`ずつ。行が読む範囲に収まらない時は、収まるまで範囲を広げる（行の途中では切らない）。
+ * `visit`の2つめは、その行の頭のbyte位置。
+ */
+export function scanLinesNewestFirst(file, visit, chunkBytes) {
+    let end = safeStatSize(file);
+    for (let tail = true; end > 0; tail = false) {
+        let span = chunkBytes;
+        let start = Math.max(0, end - span);
+        let chunk = readFileRange(file, start, end);
+        // 範囲の先頭で切れた行は、次の回で読む。改行が範囲の最後の1つだけなら、その行は範囲に収まっていない。
+        let cut = start === 0 ? 0 : chunk.indexOf(0x0a) + 1;
+        while (chunk.length === end - start && start > 0 && (cut === 0 || cut === chunk.length)) {
+            span *= 2;
+            start = Math.max(0, end - span);
+            chunk = readFileRange(file, start, end);
+            cut = start === 0 ? 0 : chunk.indexOf(0x0a) + 1;
+        }
+        if (chunk.length !== end - start)
+            return null;
+        if (tail && chunk[chunk.length - 1] !== 0x0a)
+            return null;
+        const body = chunk.subarray(cut);
+        for (let stop = body.length; stop > 0;) {
+            if (body[stop - 1] === 0x0a)
+                stop -= 1;
+            const begin = stop === 0 ? 0 : body.lastIndexOf(0x0a, stop - 1) + 1;
+            const line = body.subarray(begin, stop).toString("utf8");
+            if (line.trim() !== "") {
+                const found = visit(line, start + cut + begin);
+                if (found !== undefined)
+                    return found;
+            }
+            stop = begin;
+        }
+        end = start + cut;
+    }
+    return undefined;
+}
 export function readFileRange(p, from, to) {
     const len = Math.max(0, to - from);
     if (len === 0)
@@ -121,6 +162,7 @@ export function pollGate(intervalMs, now = () => performance.now()) {
 export const AGENT_EVENT_MAX_BYTES = 1024 * 1024;
 export const AGENT_EVENT_TAIL_BYTES = 64 * 1024;
 // turnの境界（開始・終わり）を、harnessの記録の末尾から探す時に読む大きさ。終わった席では境界は末尾の近くにある。
+// 動いている番の開始は、番が長いとこれより前になる。開始を探す所は、この大きさずつさかのぼる（scanLinesNewestFirst）。
 export const AGENT_TURN_BOUNDARY_TAIL_BYTES = 1024 * 1024;
 export const CODEX_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;
 export const GROK_TRANSCRIPT_INCREMENT_MAX_BYTES = 16 * 1024 * 1024;

package/dist/aiterm-wait-cli.js

@@ -2,7 +2,8 @@
 // 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 / 6=rate_limited=harness利用上限 / 7=error=turnがエラー終了 / 1=waiter自身のエラー）。
+// exit≠完了: exit code は outcome を映す（0=done / 5=running=未完了 / 3=timeout=未完了 / 4=closed / 6=rate_limited=harness利用上限 / 7=error=turnがエラー終了 / 8=not_taken=差し込んだ文が会話に入っていない / 1=waiter自身のエラー）。
+// --steer は、差し込みの返り（BellTeamだけに返す。ADR 0122）のwait_processが付ける。その差し込みを取った番の終わりを待つ。
 // --timeout 0 は待たずに一度だけ観測する照会で、未完了は running（timeout と混同させない）。
 // receipt の outcome が正で、done 以外は未完了。timeout の既定は core の DEFAULT_AGENT_DONE_TIMEOUT（600秒）。
 import { fileURLToPath } from "node:url";
@@ -10,6 +11,7 @@ import * as fs from "node:fs";
 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 STEER_RE = /^[0-9a-f]{16}$/;
 const USAGE = "usage: aiterm-wait --session <name> [--cursor <event_cursor>] [--operation sha256:<64hex>] [--timeout <sec>]" +
     "（--timeout 0 は待たずに一度だけ観測する照会で、未完了は outcome=running / exit 5）";
 export function parseArgs(argv) {
@@ -17,9 +19,10 @@ export function parseArgs(argv) {
     let operationId = null;
     let timeout = null;
     let cursor = null;
+    let steer = null;
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
-        if (a === "--session" || a === "--operation" || a === "--timeout" || a === "--cursor") {
+        if (a === "--session" || a === "--operation" || a === "--timeout" || a === "--cursor" || a === "--steer") {
             const v = argv[i + 1];
             if (v === undefined)
                 throw new Error(`${a} に値がありません。${USAGE}`);
@@ -45,6 +48,13 @@ export function parseArgs(argv) {
                     throw new Error(`--cursor は0以上の整数完了境界だけを受理します。${USAGE}`);
                 cursor = Number(v);
             }
+            else if (a === "--steer") {
+                if (steer !== null)
+                    throw new Error(`--steer が重複しています。${USAGE}`);
+                if (!STEER_RE.test(v))
+                    throw new Error(`--steer が不正です。${USAGE}`);
+                steer = v;
+            }
             else {
                 if (timeout !== null)
                     throw new Error(`--timeout が重複しています。${USAGE}`);
@@ -61,7 +71,9 @@ export function parseArgs(argv) {
     }
     if (session === null)
         throw new Error(`--session は必須です。${USAGE}`);
-    return { session, operationId, timeout: timeout ?? 600, cursor };
+    if (steer !== null && operationId !== null)
+        throw new Error(`--steer は --operation と併用できません。${USAGE}`);
+    return { session, operationId, timeout: timeout ?? 600, cursor, steer };
 }
 function emit(value) {
     process.stdout.write(JSON.stringify(value) + "\n");
@@ -76,6 +88,7 @@ const OUTCOME_EXIT_CODES = {
     closed: 4,
     rate_limited: 6,
     error: 7,
+    not_taken: 8,
 };
 export async function main(argv) {
     const cmd = parseArgs(argv);
@@ -85,6 +98,7 @@ export async function main(argv) {
             operation_id: cmd.operationId,
             timeout: cmd.timeout,
             cursor: cmd.cursor,
+            steer: cmd.steer,
         });
     }
     catch (e) {

package/dist/claude-stop-hook.js

@@ -138,6 +138,22 @@ function consumeOperationMarker(file, marker) {
     }
     fs.unlinkSync(file);
 }
+/**
+ * 席の会話ID。席の記録（Aitermが書く `…agent.json`）を先に読み、無い・読めない時だけ、起動時に環境へ入れた値を見る。
+ * 記録を先にするのは、席の会話を後から結び直した時に、環境の値は起動時のまま残るため。
+ * どちらも無い時は null（今までどおり、印だけで席の物と数える）。
+ */
+function seatVendorSessionId(agents, session, launchId) {
+    try {
+        const meta = JSON.parse(fs.readFileSync(path.join(agents, `${session}.${launchId}.agent.json`), "utf8"));
+        if (typeof meta.vendor_session_id === "string" && meta.vendor_session_id)
+            return meta.vendor_session_id;
+    }
+    catch {
+        // 席の記録が無い・読めない。
+    }
+    return process.env.AITERM_AGENT_VENDOR_SESSION_ID || null;
+}
 async function main() {
     if (!hasAitermEnv())
         noop();
@@ -163,12 +179,17 @@ async function main() {
         fail("Claude session_id がありません");
     if (typeof payload.last_assistant_message !== "string")
         fail("last_assistant_message がありません");
+    // 席の印（環境変数）は、席のprocessが起こした子や、Claude Codeの裏の常駐を通じて、席と関係の無い会話にも継がれる。
+    // 席の会話と違う会話のStopは、席の記録（答え・event・番の印）に触らない（ADR 0119）。
+    const agents = agentsDir();
+    const seatConversation = seatVendorSessionId(agents, session, launchId);
+    if (seatConversation !== null && seatConversation !== payload.session_id)
+        noop();
     const text = payload.last_assistant_message;
     const resultBytes = Buffer.byteLength(text, "utf8");
     if (resultBytes > MAX_RESULT_BYTES)
         fail(`assistant result が${MAX_RESULT_BYTES} bytesを超えています`);
     const resultDigest = createHash("sha256").update(text, "utf8").digest("hex");
-    const agents = agentsDir();
     const resultFile = path.join(agents, `${session}.${launchId}.claude-result.json`);
     const eventFile = path.join(agents, `${session}.${launchId}.events.jsonl`);
     const operationFile = path.join(agents, `${session}.${launchId}.claude-operation.json`);

package/dist/core.js

@@ -29,7 +29,8 @@ import { grokAuthPlan, grokAuthStatus, grokAuthPane, GROK_MODEL_DEFAULTS, realGr
 import { codexAuthPlan, codexAuthStatus, codexAuthPane, realCodexHome, readCodexConfigPins, bindCodexTranscriptSession, latestCodexCompletion, codexTurnSettled, codexRunningTurn, observeCodexDone, buildCodexAgentCmd, codexLaunchNote, codexTuiReady, codexPaneObservation, codexTuiBusy, codexHelperProcess, codexRateLimitModelSwitchDialog, codexApprovalDialog, codexStartupAction, CODEX_COMPOSER_MARKER_RE, codexModelChoice, codexEffortChoice, codexMoreReasoningChoice, codexTranscriptText, createCodexAgentMetadata, codexModelChoices, codexFastCommandOffered, codexFooterShowsFast, codexServiceTierNotices, restoreCodexDefaults, restoreCodexDefaultInFile, } from "./harnesses/codex.js";
 import { claudeAuthPlan, claudeAuthStatus, claudeAuthPane, OPERATION_ID_RE, CLAUDE_RESULT_MAX_BYTES, CLAUDE_EFFORTS, agentManagedClaudeSettingsPath, agentClaudeResultPath, agentClaudeOperationPath, agentClaudeApprovalReceiptPath, agentClaudeDispatchReceiptPath, validateOperationId, readClaudeResultText, assertClaudeAuthenticationReady, claudeModelChoices, claudeConfigDir, claudeFastIndicatorShown, claudeFastResult, buildClaudeAgentCmd, claudeLaunchNote, claudeTuiReady, claudePaneObservation, claudeUsageLimit, claudeLiveSelectMenu, claudeModelPicker, claudeModelPickerRow, claudeModelSwitchConfirm, claudeModelSwitchResult, claudeStartupAction, claudeLoginMethodMenu, CLAUDE_COMPOSER_MARKER_RE, createClaudeAgentMetadata, claudeSessionTranscriptPath, claudeApiErrorFromLine, claudeApiErrorAfter, } from "./harnesses/claude.js";
 import { cursorAuthPlan, cursorAuthStatus, cursorAuthPane, bindCursorTranscriptSession, cursorTurnBoundary, latestCursorCompletion, observeCursorDone, cursorTranscriptText, assertCursorAuthenticationReady, assertCursorModelAvailable, cursorModelChoices, cursorModelIsFastVariant, cursorFastParameter, cursorHeaderShowsFast, cursorPickerView, cursorEffortSelected, cursorParameterRows, cursorUserConfigPath, CURSOR_DEFAULT_MODEL_KEYS, realCursorHome, buildCursorAgentCmd, cursorAgentArgv, cursorPwshLaunchLine, cursorPromptWithLineage, createCursorAgentMetadata, cursorLaunchNote, cursorEffortNavigation, cursorTuiReady, cursorPaneObservation, cursorPromptHooksRunning, cursorUsageLimit, CURSOR_SUBMIT_SEQUENCE, CURSOR_COMPOSER_CONTENT_MARKER_RE, validateCursorModelEffort, } from "./harnesses/cursor.js";
-import { readInterimWords, recordInterimBoundary } from "./interim-words.js";
+import { interimFromNow, readInterimWords, recordInterimBoundary } from "./interim-words.js";
+import { codexSeatTurn, observeSteerDone, readSteerEntry, recordSteer } from "./steer-follow.js";
 import { resolveAgentBin, resolveThroughlineBin, runThroughlineHandoffContext, isWindowsNativeExecutable, agentBinForPaneShell, resolveWinPaneShell } from "./agent-resolver.js";
 export { AitermError } from "./errors.js";
 export { tmuxSpawnEnv } from "./tmux-runtime.js";
@@ -330,6 +331,7 @@ function cleanupAgentState(name) {
                     f.endsWith(".claude-approval.json") ||
                     f.endsWith(".claude-dispatch") ||
                     f.endsWith(".interim.json") ||
+                    f.endsWith(".steers.jsonl") ||
                     f.endsWith(".auth.json"))
                     fs.unlinkSync(p);
                 else if (f.endsWith(".codex-home") || f.endsWith(".grok-home") || f.endsWith(".cursor-plugin") || f.endsWith(".home")) {
@@ -2235,13 +2237,16 @@ function reapDeadAgentSendLock(name, replacedToken = null) {
     }
     return "done";
 }
+// 順番が来なかった時の断りの末尾。同じ行列に並ぶ設定替え（ADR 0120）は、何も変えていない事を書く。
+const AGENT_SEND_UNSENT = "文字列は送信していません。少し後で再度 pty_send してください。";
+const AGENT_CONFIGURE_UNCHANGED = "設定は変えていません。少し後で再度 agent_configure してください。";
 // BellTeamのため: 先頭の「AGENT_SEND_BUSY: agent session '<名前>' は」と、文中の「文字列は送信していません。」で
 // 未送信の断りを見分けている（2026-10-05）。この2か所を変える時は、変える前に知らせる。
-function agentSendBusyError(name, pid, waitMs) {
+function agentSendBusyError(name, pid, waitMs, untouched = AGENT_SEND_UNSENT) {
     return new AitermError(`AGENT_SEND_BUSY: agent session '${name}' は${pid != null ? `別プロセス（pid ${pid}）` : "先に受け付けた送信"}の処理中です。` +
-        `${waitMs}ms待っても順番が来ませんでした。文字列は送信していません。少し後で再度 pty_send してください。`, 2);
+        `${waitMs}ms待っても順番が来ませんでした。${untouched}`, 2);
 }
-async function acquireAgentSendFileLock(name, deadline, waitMs) {
+async function acquireAgentSendFileLock(name, deadline, waitMs, untouched = AGENT_SEND_UNSENT) {
     const p = agentSendLockPath(name);
     let checkedOwner = null;
     let checkedOwnerReplaced = false;
@@ -2279,11 +2284,11 @@ async function acquireAgentSendFileLock(name, deadline, waitMs) {
                 `pty_listで対象を確認し、pty_closeでsessionを閉じてから同じIDで再作成してください`, 2);
         }
         if (performance.now() >= deadline)
-            throw agentSendBusyError(name, dead ? null : probe.pid, waitMs);
+            throw agentSendBusyError(name, dead ? null : probe.pid, waitMs, untouched);
         await sleep(AGENT_SEND_LOCK_POLL_MS);
     }
 }
-async function withAgentSendLock(name, run) {
+async function withAgentSendLock(name, run, untouched = AGENT_SEND_UNSENT) {
     const waitMs = agentSendLockWaitMs;
     const deadline = performance.now() + waitMs;
     const previous = agentSendQueues.get(name) ?? Promise.resolve();
@@ -2308,8 +2313,8 @@ async function withAgentSendLock(name, run) {
         ]);
         clearTimeout(timer);
         if (!myTurn)
-            throw agentSendBusyError(name, null, waitMs);
-        const release = await acquireAgentSendFileLock(name, deadline, waitMs);
+            throw agentSendBusyError(name, null, waitMs, untouched);
+        const release = await acquireAgentSendFileLock(name, deadline, waitMs, untouched);
         agentSendHeld.add(name);
         try {
             return await run();
@@ -2881,13 +2886,37 @@ async function settlePublishedClaudeCompletionMarker(meta, marker) {
     }
     return active;
 }
-/** BellTeamのため: agent sessionの現在（または直前）のturnの合間の言葉。agent sessionでなければnull。 */
-export function readSessionInterimWords(name, after) {
+/**
+ * BellTeamのため: agent sessionの現在（または直前）のturnの合間の言葉。agent sessionでなければnull。
+ * fromを渡した時は、その位置（差し込みの返りか、席の今の番が渡した位置）より後の言葉（ADR 0122）。
+ */
+export function readSessionInterimWords(name, after, from = null) {
     assertSessionName(name);
     const dir = existingAgentsDir();
     if (!dir || !fs.readdirSync(dir).some((f) => f.startsWith(`${name}.`) && f.endsWith(".agent.json")))
         return null;
-    return readInterimWords(loadAgentMetadata(name), after);
+    return readInterimWords(loadAgentMetadata(name), after, from);
+}
+/**
+ * BellTeamのため（ADR 0122）: agent sessionの、記録の上の今の番。画面は読まない。
+ * BellTeamは、自分の送信で始めていない番（Aitermの子の結果が始めた番など）を、ここで見つけて追う。
+ * 動いている番のwait_processは、その番の終わりで返る。
+ */
+export function readSeatTurns(sessionIds) {
+    const seats = [];
+    for (const name of sessionIds) {
+        const meta = tryLoadAgentMetadata(name);
+        if (!meta)
+            continue;
+        let turn = null;
+        try {
+            turn = codexSeatTurn(meta);
+        }
+        catch { /* 読めない席は、分からないまま返す */ }
+        seats.push({ session_id: name, launch_id: meta.launch_id, harness: agentHarness(meta.kind),
+            turn: turn?.state === "running" ? { ...turn, wait_process: agentWaitProcess(name, turn.event_cursor) } : turn });
+    }
+    return { schema: "aiterm.seat-turns.v1", seats };
 }
 /** agent harness の構造化 transcript から直近完了ターンの最終回答と相関情報を読む。 */
 export async function readAgentTranscriptResult(name, o = {}) {
@@ -3053,7 +3082,7 @@ export function windowsStartProcessArgumentList(args) {
 }
 // npmのplatform別bin shimをcallerに解釈させず、現在稼働中のNodeと同梱CLIを直接起動する。
 // Windowsでもbackendはpsmux、対話shellはPowerShell 7のまま。これはwaiter processの入口だけを所有する。
-export function agentWaitProcess(session, cursor, runtime = {}) {
+export function agentWaitProcess(session, cursor, runtime = {}, steer = null) {
     const executable = runtime.executable ?? liveNodeExecutable();
     const args = [
         runtime.cliPath ?? fileURLToPath(new URL("./aiterm-wait-cli.js", import.meta.url)),
@@ -3061,6 +3090,8 @@ export function agentWaitProcess(session, cursor, runtime = {}) {
         session,
         "--cursor",
         String(cursor),
+        // 差し込みを取った番の終わりを待つ（ADR 0122）。
+        ...(steer ? ["--steer", steer] : []),
     ];
     return {
         executable,
@@ -3139,6 +3170,7 @@ export function detectAgentRateLimit(kind, aitermSession) {
 // 外部waiterプロセス用の純リーダー観測。lock・PTY・metadata書込・dispatch状態には一切触れない。
 // Codex/Cursor/Grokは各harnessのtranscript、Claudeはevent fileを増分走査し、vendor_session_idのbind永続化を
 // 行わない（waiterは観測者であって所有者でない）。
+// steerを渡した時は、その差し込み（pty_sendの返りのsteer_id）を取った番の終わりを待つ（ADR 0122。steer-follow.ts）。
 export async function observeAgentDone(name, o = {}) {
     const meta = loadAgentMetadata(name);
     const operationId = o.operation_id == null ? null : validateOperationId(o.operation_id);
@@ -3149,6 +3181,23 @@ export async function observeAgentDone(name, o = {}) {
         throw new AitermError("cursor は0以上の整数完了境界で指定してください", 2);
     }
     const timeout = o.timeout ?? DEFAULT_AGENT_DONE_TIMEOUT;
+    if (o.steer != null) {
+        if (operationId)
+            throw new AitermError("steer は operation_id と併用できません", 2);
+        const plain = (cursor, timeoutSeconds) => observeAgentDone(name, { timeout: timeoutSeconds, cursor, signal: o.signal });
+        const entry = readSteerEntry(meta, o.steer);
+        if (!entry) {
+            // 控えが無い（古くて消えた）。位置が渡されていれば、今までの待ち（その位置より後の最初の完了）で返す。
+            if (o.cursor == null)
+                throw new AitermError("STEER_NOT_FOUND: この席に、その差し込みの控えがありません。", 2);
+            return { ...await plain(o.cursor, timeout), steer: { placement: "unknown", taken_at: null } };
+        }
+        return observeSteerDone(meta, entry, timeout, {
+            signal: o.signal, plain,
+            parseDone: line => parseAgentDoneEvent(line, meta).event,
+            rateLimit: () => detectAgentRateLimit(meta.kind, name),
+        });
+    }
     if (meta.kind === "codex" && meta.completion_route === "codex_transcript") {
         return observeCodexDone(meta, timeout, o.cursor, o.signal);
     }
@@ -4851,11 +4900,28 @@ export async function configureAgent(name, opts) {
     if ((model && /[\r\n]/.test(model)) || (effort && /[\r\n]/.test(effort))) {
         throw new AitermError("model／reasoning_effort に改行を含められません", 2);
     }
-    const meta = loadAgentMetadata(name);
-    if (fast === false && modelIsFastVariant(meta.kind, model)) {
+    if (fast === false && modelIsFastVariant(loadAgentMetadata(name).kind, model)) {
         throw new FastModeError("FAST_MODE_MODEL_CONFLICT", `model=${model} はfast版のIDですが、fast: false が渡されました。元のmodel IDを渡すか、fastを省いてください。設定は変えていません。`);
     }
+    // 設定替えは席の入力欄へ命令を打つので、送信と同じ行列（ADR 0088）に並ぶ。替えている間に届いた文は、替え終えてから席へ入る（ADR 0120）。
+    // 番が動いている席では、行列を持ったまま番の終わりを待たない（待つ間も、その席への差し込みを通す）。
+    const deadline = performance.now() + AGENT_TUI_READY_TIMEOUT_MS;
+    for (;;) {
+        const result = await withAgentSendLock(name, () => configureAgentInLock(name, model, effort, fast), AGENT_CONFIGURE_UNCHANGED);
+        if (result)
+            return result;
+        if (performance.now() >= deadline)
+            throw new AitermError(`agent session '${name}' は入力待ちではありません`, 2);
+        await sleep(AGENT_TUI_READY_POLL_MS);
+    }
+}
+/** 返りの null は、席の画面が番の最中を示していて、何も打っていない時。 */
+async function configureAgentInLock(name, model, effort, fast) {
+    // 席の控えは、行列の順番が来てから読む（前の送信が書いた分を、古い控えで上書きしない）。
+    const meta = loadAgentMetadata(name);
     bindCompletedInitialPrompt(meta);
+    if (isAgentTuiBusy(meta.kind, captureScreen(name, AGENT_TUI_READY_LINES)))
+        return null;
     const { ready, codexRateLimitModelSwitch } = await waitAgentTuiReadyAfterCodexRateLimitRecovery(name, meta, AGENT_TUI_READY_TIMEOUT_MS);
     if (!ready.ready) {
         if (codexRateLimitModelSwitch) {
@@ -5433,7 +5499,7 @@ async function sendAgentMessageInLock(name, text, o) {
             "前の文の完了待ちが終わってから送り直してください。Grokは120秒受け取れないと、前の文を自分から取り消します。", 2);
     }
     if (running) {
-        return steerRunningTurn(name, meta, text, { raw: o.raw, pane_input_recovery: paneInputRecovery, preface: o.preface });
+        return steerRunningTurn(name, meta, text, { raw: o.raw, pane_input_recovery: paneInputRecovery, preface: o.preface, follow: o.follow });
     }
     return dispatchAgentTurnInLock(name, text, { raw: o.raw, before_send: o.before_send, pane_input_recovery: paneInputRecovery, preface: o.preface });
 }
@@ -5445,7 +5511,26 @@ async function sendAgentMessageInLock(name, text, o) {
  * - Grok: 待ち行列へ入れた後に「send now」を押す。旧turnは`cancelled`（trigger=send_now）で閉じ、
  *   新turnが作業を継ぐ。完了判定はこの継ぎ目を完了と数えない（grokCompletionEvent）。
  */
+/**
+ * 差し込みを打つ直前の位置と、文の頭を控える（ADR 0122）。控えられなくても差し込みは止めない。
+ * 完了の位置は、そこから今までの待ちを始めると「打った後の最初の完了」で返る位置。Cursorの位置はuser発話の数で、
+ * 差し込みが新しいuser発話として書かれない時も今の番の終わりで返るよう、今の番の手前を指す。
+ */
+function recordSteerPosition(meta, body) {
+    try {
+        const completion = agentCompletionCursor(meta);
+        const cursor = meta.kind === "cursor" ? Math.max(0, completion - 1) : completion;
+        const entry = recordSteer(meta, interimFromNow(meta, cursor), body);
+        return entry ? { steer_id: entry.steer_id, event_cursor: entry.event_cursor, interim_from: entry.interim_from } : null;
+    }
+    catch {
+        return null;
+    }
+}
 async function steerRunningTurn(name, meta, text, o) {
+    const prefaced = splitAgentPreface(meta.kind, o.preface, text, { defaultForWrapped: !o.raw });
+    text = prefaced.body;
+    prepareSendText(text, { raw: o.raw });
     const receipt = {
         schema: "aiterm.agent-steer.v1",
         session_id: meta.aiterm_session,
@@ -5453,10 +5538,8 @@ async function steerRunningTurn(name, meta, text, o) {
         vendor: meta.kind,
         harness: agentHarness(meta.kind),
         pane_input_recovery: o.pane_input_recovery,
+        ...(o.follow ? { follow: recordSteerPosition(meta, text) } : {}),
     };
-    const prefaced = splitAgentPreface(meta.kind, o.preface, text, { defaultForWrapped: !o.raw });
-    text = prefaced.body;
-    prepareSendText(text, { raw: o.raw });
     // Claudeのoperation相関は変えない。差し込みは実行中turnの一部であり、新しいturnを予約しない。
     const preserveAgentOperation = meta.kind === "claude";
     send(name, text, {