aiterm-mcp 0.59.1 → 0.60.0

package/dist/index.js

@@ -25,7 +25,8 @@ import { claudeParentFromRequest, discardClaudeHookRequest } from "./claude-pare
 import { parentDeliveryDiagnostic } from "./parent-hook-diagnostic.js";
 import { cursorParentFromRequest, isCursorMcpClient } from "./cursor-parent-receiver.js";
 import { waitProcessCommandLine } from "./cursor-parent-receive.js";
-import { INTERIM_RESULT_META_KEY, interimRequestFromMeta } from "./interim-words.js";
+import { INTERIM_RESULT_META_KEY, interimCallerFromMeta, interimRequestFromMeta } from "./interim-words.js";
+import { SEAT_TURNS_RESULT_META_KEY, STEER_RESULT_META_KEY } from "./steer-follow.js";
 // package.json の version を実行時に読み、MCP initialize で配るサーバ版と一致させる。
 // createRequire を使うのは、import 属性 `with { type: "json" }` が Node 18.20+ 限定で
 // engines "node >=18"（18.0〜18.19）を SyntaxError で壊し、旧 `assert` 構文は逆に Node 22 で
@@ -368,8 +369,11 @@ registerRemoteAwareTool("pty_send", {
             if (rtk)
                 throw new Error("agent session への dispatch は rtk:true と併用できません");
             delivery = await deliveryForRequest(extra);
-            const receipt = await core.sendAgentMessage(session_id, core.attachImages(text, image), { raw, before_send: delivery?.before_send, preface });
+            // BellTeamのため（ADR 0122）: 差し込みになった時、その文を取った番の終わりを待つ手がかりを返す。印の無い呼び手には何も足さない。
+            const receipt = await core.sendAgentMessage(session_id, core.attachImages(text, image), { raw, before_send: delivery?.before_send, preface,
+                follow: interimCallerFromMeta(extra._meta) });
             if (receipt.schema === "aiterm.agent-steer.v1") {
+                const follow = receipt.follow ?? null;
                 return {
                     content: [
                         {
@@ -382,14 +386,15 @@ registerRemoteAwareTool("pty_send", {
                         schema: "aiterm.pty-send-result.v1",
                         mode: "agent_steer",
                         session_id: receipt.session_id,
-                        event_cursor: null,
-                        wait_process: null,
+                        event_cursor: follow ? follow.event_cursor : null,
+                        wait_process: follow ? core.agentWaitProcess(receipt.session_id, follow.event_cursor, {}, follow.steer_id) : null,
                         launch_id: receipt.launch_id,
                         vendor: receipt.vendor,
                         harness: receipt.harness,
                         submit_residue: null,
                         pane_input_recovery: receipt.pane_input_recovery,
                     },
+                    ...(follow ? { _meta: { [STEER_RESULT_META_KEY]: { schema: "aiterm.steer-ref.v1", steer_id: follow.steer_id, interim_from: follow.interim_from } } } : {}),
                 };
             }
             const waited = completionWait(delivery, receipt.session_id, receipt.event_cursor);
@@ -624,15 +629,27 @@ registerRemoteAwareTool("pty_list", {
             environment: z.record(z.string(), z.string().nullable()),
         })),
     },
-}, async ({ env_keys }) => {
+}, async ({ env_keys }, extra) => {
     try {
         const result = core.listSessionsResult(env_keys);
-        return { ...ok(core.listSessions(result)), structuredContent: { ...result } };
+        return { ...ok(core.listSessions(result)), structuredContent: { ...result }, ...seatTurnsMeta(result.sessions, extra._meta) };
     }
     catch (e) {
         return fail(e);
     }
 });
+// BellTeamのため（ADR 0122）: 要求の_metaに aiterm/caller="BellTeam" がある時だけ、結果の_metaへ席の今の番を載せる。
+// 説明と引数には出さない（steer-follow.ts の冒頭）。それ以外の呼び手には何も足さない。
+function seatTurnsMeta(sessions, requestMeta) {
+    if (!interimCallerFromMeta(requestMeta))
+        return {};
+    try {
+        return { _meta: { [SEAT_TURNS_RESULT_META_KEY]: core.readSeatTurns(sessions.filter(session => session.harness !== null).map(session => session.session_id)) } };
+    }
+    catch (e) {
+        return { _meta: { [SEAT_TURNS_RESULT_META_KEY]: { schema: "aiterm.seat-turns.v1", error: e instanceof Error ? e.message : String(e) } } };
+    }
+}
 const nativeProcessIdentitySchema = z.object({
     pid: z.number().int(), process_group_id: z.number().int().nullable(),
     started_identity: z.string(), argv_digest: z.string(),
@@ -675,7 +692,10 @@ function interimWordsMeta(sessionId, requestMeta) {
     if (!request)
         return {};
     try {
-        const words = core.readSessionInterimWords(sessionId, request.after);
+        // 読み始める位置が付いているのに読めない時は、最後のdispatchの言葉を返さない（呼び手が別の番の言葉を出してしまう）。
+        if (request.from_invalid)
+            throw new Error("INTERIM_FROM_INVALID: aiterm/interim_from の値を読めません");
+        const words = core.readSessionInterimWords(sessionId, request.after, request.from ?? null);
         return words ? { _meta: { [INTERIM_RESULT_META_KEY]: words } } : {};
     }
     catch (e) {

package/dist/interim-words.js

@@ -24,21 +24,47 @@ export const INTERIM_CALLER = "BellTeam";
 export const INTERIM_AFTER_META_KEY = "aiterm/interim_after";
 /** 結果の_metaで返すキー。 */
 export const INTERIM_RESULT_META_KEY = "aiterm/interim_words";
+/**
+ * 読み始める位置。差し込みの返りと「席の今の番」が渡す文字列（中身は呼び手に読ませない）。
+ * 指定した時は、最後のdispatchの境界ではなく、その位置より後の言葉を返す（ADR 0122）。
+ */
+export const INTERIM_FROM_META_KEY = "aiterm/interim_from";
+export function interimFromToken(from) {
+    return `v1:${from.event_cursor}:${from.unit === "byte" ? "b" : "u"}:${from.boundary}`;
+}
+export function parseInterimFrom(token) {
+    if (typeof token !== "string")
+        return null;
+    const match = /^v1:(\d{1,15}):([bu]):(\d{1,15})$/.exec(token);
+    if (!match)
+        return null;
+    return { event_cursor: Number(match[1]), unit: match[2] === "b" ? "byte" : "user", boundary: Number(match[3]) };
+}
 export function agentInterimBoundaryPath(name, launchId) {
     assertSessionName(name);
     if (!LAUNCH_ID_RE.test(launchId))
         throw new AitermError(`launch_id が不正です: ${launchId}`, 2);
     return path.join(agentsDir(), `${name}.${launchId}.interim.json`);
 }
-/** 要求の_metaがBellTeamの印を持つ時だけ、前回のseqを返す。それ以外はnull（何も足さない）。 */
+/** 要求の_metaがBellTeamの印を持つか。 */
+export function interimCallerFromMeta(meta) {
+    return !!meta && typeof meta === "object" && meta[INTERIM_CALLER_META_KEY] === INTERIM_CALLER;
+}
+/**
+ * 要求の_metaがBellTeamの印を持つ時だけ、前回のseqを返す。それ以外はnull（何も足さない）。
+ * 読み始める位置（aiterm/interim_from）が付いていれば、fromに入れる。付いているのに読めない時はfromがnullでfrom_invalidがtrue
+ * （最後のdispatchの言葉を黙って返すと、呼び手は別の番の言葉を出してしまう）。
+ */
 export function interimRequestFromMeta(meta) {
-    if (!meta || typeof meta !== "object")
+    if (!interimCallerFromMeta(meta))
         return null;
     const record = meta;
-    if (record[INTERIM_CALLER_META_KEY] !== INTERIM_CALLER)
-        return null;
-    const after = record[INTERIM_AFTER_META_KEY];
-    return { after: typeof after === "number" && Number.isSafeInteger(after) && after > 0 ? after : 0 };
+    const raw = record[INTERIM_AFTER_META_KEY];
+    const after = typeof raw === "number" && Number.isSafeInteger(raw) && raw > 0 ? raw : 0;
+    if (record[INTERIM_FROM_META_KEY] === undefined)
+        return { after };
+    const from = parseInterimFrom(record[INTERIM_FROM_META_KEY]);
+    return from ? { after, from } : { after, from: null, from_invalid: true };
 }
 function parse(line) {
     if (!line.trim())
@@ -238,8 +264,54 @@ function readInterimBoundary(meta) {
         return null;
     return value;
 }
-/** 現在（または直前）のturnで書かれた合間の言葉のうち、seqがafterより後のもの。 */
-export function readInterimWords(meta, after) {
+/**
+ * 今の時点の読み始めの位置。差し込みを打つ直前に取る（その差し込みより後に書かれた言葉だけを読むため）。
+ * Claude・Codex・Cursorは記録のbyte位置、Grokは記録中のuser発話の数（「今すぐ送る」で入った文は、次のuser発話になる）。
+ * Cursorは、番が動いている間は記録を足すだけなので、byte位置が動かない（末尾の行を書き換えるのは、次の番の開始の時）。
+ */
+export function interimFromNow(meta, eventCursor) {
+    if (meta.kind === "grok")
+        return { event_cursor: eventCursor, unit: "user", boundary: grokUserCount(readLines(grokChatHistory(meta))) };
+    let file = null;
+    try {
+        file = meta.kind === "claude" ? claudeSessionTranscriptPath(meta)
+            : meta.kind === "codex" ? (meta.vendor_session_id ? codexBoundTranscript(meta) : codexRootTranscript(meta))
+                : cursorTranscript(meta);
+    }
+    catch { /* 記録を決められない時は、頭から */ }
+    return { event_cursor: eventCursor, unit: "byte", boundary: file ? safeStatSize(file) : 0 };
+}
+/** 渡された位置より後に書かれた合間の言葉。位置の単位がharnessと合わない時は、言葉なし。 */
+function interimWordsFrom(meta, from) {
+    if (meta.kind === "grok")
+        return from.unit === "user" ? grokInterimWords(readLines(grokChatHistory(meta)), from.boundary) : [];
+    if (from.unit !== "byte")
+        return [];
+    if (meta.kind === "claude")
+        return claudeInterimWords(readLines(claudeSessionTranscriptPath(meta), from.boundary));
+    if (meta.kind === "codex")
+        return codexInterimWords(readLines(meta.vendor_session_id ? codexBoundTranscript(meta) : codexRootTranscript(meta), from.boundary));
+    // 位置より後の行だけを渡すので、user発話の数では絞らない。
+    return cursorInterimWords(readLines(cursorTranscript(meta), from.boundary), -1);
+}
+/**
+ * 現在（または直前）のturnで書かれた合間の言葉のうち、seqがafterより後のもの。
+ * fromを渡した時は、最後のdispatchの境界ではなく、その位置より後の言葉（seqはその位置から1で数える）。
+ */
+export function readInterimWords(meta, after, from = null) {
+    if (from) {
+        const words = interimWordsFrom(meta, from).map((word, index) => ({ seq: index + 1, ...word }));
+        return {
+            schema: "aiterm.interim-words.v1",
+            session_id: meta.aiterm_session,
+            launch_id: meta.launch_id,
+            harness: agentHarness(meta.kind),
+            event_cursor: from.event_cursor,
+            operation_id: null,
+            last_seq: words.length,
+            words: words.filter((word) => word.seq > after),
+        };
+    }
     const recorded = readInterimBoundary(meta);
     // dispatchの記録が無ければ、起動時promptのturnだけを記録の先頭から読む。promptなしで起動してまだ送っていない時は無い。
     const launchTurn = !recorded && meta.initial_prompt !== "none";

package/dist/parent-delivery.js

@@ -307,7 +307,8 @@ export class ParentDeliveryManager {
         job.capture = (async () => {
             if (completion.launch_id !== job.record.boundary.launch_id)
                 throw new AitermError("PARENT_DELIVERY_LAUNCH_CHANGED: 子のlaunchが置換されました", 2);
-            if (completion.outcome === "running" || completion.outcome === "timeout")
+            // not_takenは差し込みを追う待ちだけが返す。親配送の待ちは差し込みを追わないので、来ない。
+            if (completion.outcome === "running" || completion.outcome === "timeout" || completion.outcome === "not_taken")
                 throw new AitermError("PARENT_DELIVERY_NOT_COMPLETED: 子の完了を確認できません", 2);
             const record = job.record;
             record.child_outcome = completion.outcome;