tailii-host 0.10.1 → 0.11.1

package/dist/backend/herdr.js

@@ -2,11 +2,11 @@
 // tailii (TS host) — herdr backend のセッション操作（list / reattach / kill / send / read）。
 // TmuxSessionManager と同じ面（SessionBackend）を herdr CLI（socket API のフロント）で実装する。
 //
-// 実測済みの herdr 0.7.5 挙動（設計正本は docs/herdr-backend.md）:
+// 実測済みの herdr 0.7.5 挙動（0.9.3 でも CLI 面・JSON 形状は同一。設計正本は docs/herdr-backend.md）:
 // - 全 pane は専用 named session `tailii` に収容（全コマンドに `--session tailii` 前置）。
 //   起動は `tab create --cwd --env --no-focus`（root_pane.pane_id が新 pane）→ `pane rename`
-//   → `pane run <id> "exec /bin/zsh -lc '<cmd>'"`。0.7.5 で `agent start` から pane 生成
-//   /cwd/env 指定が廃止されたため（旧: agent start 一発で pane 起動）。
+//   → `pane run <id> "exec env -u HERDR_ENV /bin/zsh -lc '<cmd>'"`（長いときは一時スクリプト経由）。
+//   0.7.5 で `agent start` から pane 生成/cwd/env 指定が廃止されたため（旧: agent start 一発で pane 起動）。
 //   `pane run` はタイプ注入で argv のクォートを保持しない → コマンドは単一文字列で渡す。
 //   exec 前置によりコマンド終了と同時に pane が閉じる（旧 agent start と同義・stale shell なし）。
 // - `pane read --source recent-unwrapped --lines N` は tmux `capture-pane -J -S -N` 相当。
@@ -21,9 +21,8 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import { PROTOCOL_V1 } from "../protocol.js";
-import { normalizeForTextMatch, stripInvisibleForComparison } from "../shared/invisibleText.js";
 import { HERDR_PANE_ID_PATTERN, SessionMetadataStore, validateSessionName, } from "../sessions/sessionMetadataStore.js";
-import { CHAT_BLOCKED_BY_LOGIN_PROMPT, claudeInputBoxRendered, extractClaudeInputBox, inputBoxHasRealPendingText, inputBoxRealText, inputBoxIsShellMode, inputBoxTextMatchesRecordedPrompt, LoginCodeError, paneCommandLooksLikeAgent, screenInLoginFlow, ChatInjectionRejectedError, classifySubmitFrame, SUBMIT_ATTEMPT_LIMIT, submitLoginCode, } from "./tmux.js";
+import { cancelChoiceDialog, CHAT_BLOCKED_BY_LOGIN_PROMPT, CHAT_BLOCKED_AFTER_CHOICE_CANCELLED, CHAT_BLOCKED_BY_STUCK_CHOICE, CHAT_BLOCKED_BY_UNREADABLE_CHOICE, CHOICE_CANCEL_MAX_POLLS, CHOICE_CANCEL_POLL_MS, claudeComposerBarVisible, claudeInputBoxRendered, extractClaudeInputBox, inputBoxHasRealPendingText, inputBoxRealText, inputBoxIsShellMode, inputBoxTextMatchesRecordedPrompt, LoginCodeError, paneCommandLooksLikeAgent, screenInLoginFlow, inputBoxTextIncludesProbe, typedTextProbe, typedTextWouldBreak, textIsPasteSafe, pasteTextInline, clearTypedInput, INJECT_VERIFY_BUDGET_MS, CLEAR_UNKNOWN_INPUT_BOUND, BRACKETED_PASTE_START, BRACKETED_PASTE_END, PASTED_TEXT_POLL_MS, PASTED_TEXT_TIMEOUT_MS, TYPED_TEXT_CLEAR_SETTLE_MS, ChatInjectionRejectedError, classifySubmitFrame, SEND_NOW_MAX_POLLS, SEND_NOW_POLL_MS, sendQueuedNow, settleFrameAfterChoiceCancel, SUBMIT_ATTEMPT_LIMIT, submitLoginCode, } from "./tmux.js";
 /** herdr 実行ファイルの既定絶対パス（SSH exec は非ログインシェルで PATH 外のため絶対指定）。 */
 export function defaultHerdrPath() {
     return path.join(os.homedir(), ".local", "bin", "herdr");
@@ -56,6 +55,15 @@ const HERDR_TIMEOUT_MS = 15_000;
  * （2026-09-06 実機で発症）。窓内のシェル前面は「起動中」として生存扱いにする。
  */
 export const HERDR_LAUNCH_GRACE_SECONDS = 20;
+/**
+ * TMUX / TMUX_PANE を除いた環境。herdr server は最初に `herdr` を叩いたプロセスの環境を引き継ぎ、
+ * その配下の Claude は TMUX があると外側の tmux pane 名を状態ファイルの `tmux` 欄に書く
+ * （reaper の照合を取り違える）。tmux 内の hook / CLI から起動されても持ち込まないよう外す。
+ */
+export function envWithoutTmux(env = process.env) {
+    const { TMUX: _tmux, TMUX_PANE: _tmuxPane, ...rest } = env;
+    return rest;
+}
 /**
  * 実 herdr を起動する既定ランナー。herdr 非0 exit は throw せず結果で表現する。
  * `sessionName`（既定 tailii）を `--session` として全コマンドに前置する。
@@ -66,7 +74,7 @@ export function processHerdrCommandRunner(herdrPath = defaultHerdrPath(), sessio
         // 発行するのは pane list / pane get / tab list など即応するコマンドだけ。無期限に
         // 待つと engine の read loop と hub の tick ループが同時に止まるため上限を切る
         // （tmux ランナー・`gitService` と同じ規約）。
-        { maxBuffer: 16 * 1024 * 1024, timeout: timeoutMs }, (error, stdout, stderr) => {
+        { maxBuffer: 16 * 1024 * 1024, timeout: timeoutMs, env: envWithoutTmux() }, (error, stdout, stderr) => {
             if (error && typeof error.code === "string") {
                 // 実行ファイル起動自体の失敗（ENOENT 等）のみ throw（tmux ランナーと同じ境界）。
                 reject(error);
@@ -77,13 +85,48 @@ export function processHerdrCommandRunner(herdrPath = defaultHerdrPath(), sessio
         });
     });
 }
+/**
+ * herdr CLI のエラー JSON（`{"error":{"code":"…"}}`、stderr に出る）から code を取り出す。
+ * 判定不能は null。
+ */
+export function herdrErrorCode(output) {
+    const text = output.trim();
+    if (text.length === 0)
+        return null;
+    try {
+        const parsed = JSON.parse(text);
+        return typeof parsed.error?.code === "string" ? parsed.error.code : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 旧サーバーを止めて新しい版へ移る手順。`delete` まで行うのは、旧版の pane が herdr の
+ * claude 連携へ会話 id を申告済みで、新しいサーバー（≥0.8）が保存状態から復元するときに
+ * Tailii のフック抜きの `claude --resume` で自動再開してしまうため（実測 2026-09-30,
+ * 0.7.5 の保存状態 → 0.9.3 サーバー）。保存状態を消せば会話は開き直したときに Tailii が
+ * 自前の起動で resume する。0.7.5 の `pane release-agent` は申告を消さない（実測）。
+ */
+export const HERDR_RESTART_COMMAND = "herdr session stop tailii && herdr session delete tailii";
+/**
+ * herdr を更新した後、tailii セッションのサーバーが旧版のまま動いている（`protocol_mismatch`）
+ * ときの案内。0.9.x の CLI は 0.7.5 のサーバーへ全コマンドを拒否するため、サーバーを
+ * 止めるまで Tailii の herdr 操作は全て失敗する（実測 2026-09-30, 0.9.3 CLI × 0.7.5 server）。
+ * 止めると pane のプロセス（実行中の会話）は終了するので、自動では止めず利用者に委ねる。
+ */
+export const HERDR_RESTART_NEEDED_MESSAGE = "herdr が更新されましたが、Tailii 用の herdr サーバーは古い版のまま動いています。" +
+    `Mac で \`${HERDR_RESTART_COMMAND}\` を実行してから会話を開き直してください` +
+    "（実行中の会話は一度終了し、開き直すと続きから再開します）。";
 /** HerdrSessionManager が投げる型付きエラー。 */
 export class HerdrFailedError extends Error {
     args;
     exitCode;
     stderr;
     constructor(args, exitCode, stderr) {
-        super(`herdr ${args.join(" ")} failed (exit ${exitCode}): ${stderr}`);
+        super(herdrErrorCode(stderr) === "protocol_mismatch"
+            ? HERDR_RESTART_NEEDED_MESSAGE
+            : `herdr ${args.join(" ")} failed (exit ${exitCode}): ${stderr}`);
         this.args = args;
         this.exitCode = exitCode;
         this.stderr = stderr;
@@ -121,6 +164,12 @@ const ENTER_SEQUENCE = "\r";
  * 空 composer への C-u は完全に no-op で、処理中の agent にも干渉しない）。
  */
 const KILL_LINE_SEQUENCE = "\u0015";
+/**
+ * `chat:sendNow` の chord（Ctrl-X Ctrl-S）の生制御文字（chat-send-now）。herdr の send-keys は
+ * キーごとに別プロセスで送るため、2 打の間が空くと chord が成立しない恐れがある。
+ * **1 回の send-text で続けて送る**（実測 herdr 0.7.5 + Claude Code 2.1.283 で成立）。
+ */
+const SEND_NOW_SEQUENCE = "\u0018\u0013";
 /**
  * 画面に選択ダイアログのフッター行があるか。チャット本文が「Enter to select」を
  * 引用しただけの偽陽性（誤 Esc・再送スキップの実害）を避けるため、substring では
@@ -138,48 +187,8 @@ function stripAnsiForMatch(line) {
     // eslint-disable-next-line no-control-regex
     return line.replace(/\u001b\[[0-9;:?]*[ -/]*[@-~]/g, "");
 }
-/**
- * 入力反映検証に使う probe（本文の**末尾側**）。検証不能な本文（空など）は null。
- *
- * 末尾側なのは composer の表示特性のため: 入力が表示高を超えると composer は下へ
- * スクロールし**先頭行が窓外へ消える**（実測 2.1.220: 10行ペーストで先頭4行が
- * capture から消失）。カーソルは常に末尾にあるので、末尾側の probe だけが
- * 「見えている範囲」との照合を保証できる（先頭24字の旧 probe は多行/長文で
- * 構造的に偽陰性 → 再投入 → 本文二重化の温床だった）。
- *
- * 先頭 `!`（シェルモード）は claude TUI がモード記号として吸い上げ、入力欄本文には
- * 残らない（`!ls -la` は `! ls -la` と描画される）。単一行本文では照合キーからも
- * 落とさないと末尾24字に `!` が含まれるとき反映検証が失敗する。
- */
-export function typedTextProbe(text) {
-    // 不可視文字は端末のセルに載らない（capture に出ない）ため、probe に混ざると反映検証が
-    // 構造的に偽陰性になる。probe は不可視文字を除いた可視本文から取る
-    // （照合側 `inputBoxTextIncludesProbe` も両辺から落とすので規則は一致する）。
-    const lines = stripInvisibleForComparison(text)
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
-    const lastLine = lines.at(-1);
-    if (lastLine === undefined)
-        return null;
-    const body = lines.length === 1 && lastLine.startsWith("!") ? lastLine.slice(1).trim() : lastLine;
-    if (body.length === 0)
-        return null;
-    return body.slice(-24);
-}
-/**
- * 入力欄テキストに probe が反映されているか（折り返し非依存）。
- * extractClaudeInputBox は表示行を trim + "\n" 連結で返すため、probe が入力欄の
- * 行折り返しをまたぐと生の includes は絶対に一致しない（全角24字=48桁 > 内幅で必発）。
- * この偽陰性が「反映済み本文の再投入 = 初回送信の本文二重化」の根因だった（実機5件）。
- * 空白類（折り返しの改行・trim 痕・全角空白含む）と不可視文字を両辺から除去して照合する。
- */
-export function inputBoxTextIncludesProbe(boxText, probe) {
-    const needle = normalizeForTextMatch(probe);
-    if (needle.length === 0)
-        return false;
-    return normalizeForTextMatch(boxText).includes(needle);
-}
+// 反映検証の probe は tmux backend と共有する（long-text-paste）。従来の import 元を保つ。
+export { inputBoxTextIncludesProbe, typedTextProbe } from "./tmux.js";
 /** herdr CLI の JSON stdout から `result` を取り出す。JSON でない/エラー封筒は null。 */
 export function parseHerdrResult(stdout) {
     try {
@@ -312,6 +321,55 @@ export function parseHerdrForegroundCommand(stdout) {
     const name = first["name"];
     return typeof name === "string" ? name : "";
 }
+/**
+ * `pane process-info` の前面プロセス群の pid（前面プロセスグループ id を含む）。
+ * Claude Code の `~/.claude/sessions/<pid>.json` と照合する（tmux 欄の無い herdr 用, 実測で一致）。
+ */
+export function parseHerdrForegroundPids(stdout) {
+    const result = parseHerdrResult(stdout);
+    const info = result?.["process_info"];
+    if (typeof info !== "object" || info === null)
+        return [];
+    const raw = info;
+    const pids = new Set();
+    const group = raw["foreground_process_group_id"];
+    if (typeof group === "number" && Number.isInteger(group) && group > 0)
+        pids.add(group);
+    const list = raw["foreground_processes"];
+    if (Array.isArray(list)) {
+        for (const item of list) {
+            if (typeof item !== "object" || item === null)
+                continue;
+            const pid = item["pid"];
+            if (typeof pid === "number" && Number.isInteger(pid) && pid > 0)
+                pids.add(pid);
+        }
+    }
+    return [...pids];
+}
+/**
+ * セッション名に対応する pane を選ぶ。
+ * 1. 記録済み pane ID の pane が同じ label（または label なし）ならそれ。
+ * 2. 無ければ label（= セッション名）一致の pane。
+ * 3. それも無ければ、記録 ID の pane の label が**他の Tailii セッション名でない**限りそれ
+ *    （利用者が herdr 上で pane 名を変えた会話も見失わない。`keys.rename_pane` で変えられる）。
+ * 記録 ID の pane が別の Tailii セッション名を持つときだけ採用しない: pane ID はサーバーの状態を
+ * 消したとき（`herdr session delete tailii` 後の初回起動など）に w1:p1 から振り直されるため、
+ * 古い記録 ID が別の会話の pane を指し得る（取り違えると別会話へ送信・stale 掃除で別会話を閉じる）。
+ * @param isTailiiName label がメタに記録された Tailii セッション名か（取り違えの判定用）。
+ *   3. に入ったときだけ呼ぶ（メタ全件の読み込みは重いので、通常の 1. / 2. では読まない）。
+ */
+export function resolveHerdrSessionPane(panes, name, recordedPaneId, isTailiiName) {
+    const byId = recordedPaneId !== undefined ? panes.find((pane) => pane.paneId === recordedPaneId) : undefined;
+    if (byId !== undefined && (byId.label === null || byId.label === name))
+        return byId;
+    const byLabel = panes.find((pane) => pane.label === name);
+    if (byLabel !== undefined)
+        return byLabel;
+    if (byId !== undefined && byId.label !== null && !isTailiiName(byId.label))
+        return byId;
+    return null;
+}
 /** herdr backend のセッション list / reattach / kill / send / read とメタデータ統合。 */
 export class HerdrSessionManager {
     runner;
@@ -322,6 +380,14 @@ export class HerdrSessionManager {
     submitDelayMs;
     /** sendTextSubmit の CR→残留確認 間隔 ms（テスト注入用）。 */
     submitVerifyDelayMs;
+    /** 選択ダイアログを Esc で閉じた後の消滅確認の間隔 ms（テスト注入用）。 */
+    choiceCancelPollMs;
+    /** 「今すぐ送信」の chord 後、ヒント行の消滅確認の間隔 ms（テスト注入用）。 */
+    sendNowPollMs;
+    /** 貼り付けた本文が入力欄に入るのを確かめる間隔と上限 ms（テスト注入用）。 */
+    pastedTextPollMs;
+    pastedTextTimeoutMs;
+    clearSettleMs;
     /** 入力欄へ本文が反映されなかったときの再投入間隔 ms（RC 切断 limbo 対策）。 */
     inputRetryDelayMs;
     /** clearInputBox の C-u 1回ごとの反映待ち ms（実測レイテンシ 9〜27ms。テスト注入用）。 */
@@ -343,6 +409,11 @@ export class HerdrSessionManager {
         this.protocolVersion = options.protocolVersion ?? PROTOCOL_V1;
         this.submitDelayMs = options.submitDelayMs ?? 600;
         this.submitVerifyDelayMs = options.submitVerifyDelayMs ?? 700;
+        this.choiceCancelPollMs = options.choiceCancelPollMs ?? CHOICE_CANCEL_POLL_MS;
+        this.sendNowPollMs = options.sendNowPollMs ?? SEND_NOW_POLL_MS;
+        this.pastedTextPollMs = options.pastedTextPollMs ?? PASTED_TEXT_POLL_MS;
+        this.pastedTextTimeoutMs = options.pastedTextTimeoutMs ?? PASTED_TEXT_TIMEOUT_MS;
+        this.clearSettleMs = options.clearSettleMs ?? TYPED_TEXT_CLEAR_SETTLE_MS;
         this.inputRetryDelayMs = options.inputRetryDelayMs ?? 1_500;
         this.clearKeyDelayMs = options.clearKeyDelayMs ?? 150;
         this.readyTimeoutMs = options.readyTimeoutMs ?? 10_000;
@@ -382,21 +453,19 @@ export class HerdrSessionManager {
         return this.listFromPanes(panes);
     }
     async listFromPanes(panes) {
-        const paneIds = new Set(panes.map((pane) => pane.paneId));
-        const labels = new Set(panes.map((pane) => pane.label).filter((label) => label !== null));
         // タブラベル（Mac 側リネーム含む会話タイトル表示）を name→label で引けるようにする
         // （session-title 逆方向同期: セッション名と異なるラベルを displayTitle として載せる）。
         const tabLabels = await this.tabLabels();
+        const metas = this.store.all();
+        const tailiiNames = new Set(metas.map((meta) => meta.name));
         const infos = [];
-        for (const meta of this.store.all()) {
+        for (const meta of metas) {
             if (meta.backend !== "herdr")
                 continue;
             const agent = meta.agent ?? "claude";
             const providerSessionId = meta.providerSessionId ?? (agent === "claude" ? meta.claudeSessionId : undefined);
-            const alive = (meta.herdrPaneId !== undefined && paneIds.has(meta.herdrPaneId)) || labels.has(meta.name);
-            const pane = (meta.herdrPaneId !== undefined
-                ? panes.find((candidate) => candidate.paneId === meta.herdrPaneId)
-                : undefined) ?? panes.find((candidate) => candidate.label === meta.name);
+            const pane = resolveHerdrSessionPane(panes, meta.name, meta.herdrPaneId, (label) => tailiiNames.has(label));
+            const alive = pane !== null;
             const tabLabel = pane?.tabId != null ? tabLabels.get(pane.tabId) : undefined;
             // 自動適用ラベル（hub tick が書いた値 = meta.autoTabTitle）と既定連番は人為リネーム
             // ではないため displayTitle に載せない（iOS が override として誤取り込みしないため）。
@@ -500,6 +569,24 @@ export class HerdrSessionManager {
             return true;
         }
     }
+    /** pane の前面プロセスの pid 群。取得できなければ null（reaper の Claude 状態照合用）。 */
+    async agentProcessIds(name) {
+        validateSessionName(name);
+        const target = await this.paneTarget(name);
+        if (target === null)
+            return null;
+        try {
+            const result = await this.runner(["pane", "process-info", "--pane", target]);
+            if (result.exitCode !== 0)
+                return null;
+            // 空は「前面プロセスが無い」ではなく形式変更・一時失敗の疑い → 取得不能として扱う。
+            const pids = parseHerdrForegroundPids(result.stdout);
+            return pids.length > 0 ? pids : null;
+        }
+        catch {
+            return null;
+        }
+    }
     /**
      * メタの createdAt（launch 時刻。launcher は pane 再利用時に更新しない）が猶予窓内か。
      * 未記録は窓外（従来どおりの判定）。時計の巻き戻りで経過が負になった場合も窓外に倒し、
@@ -522,7 +609,7 @@ export class HerdrSessionManager {
         validateSessionName(name);
         const pane = await this.findPane(name);
         if (pane === null) {
-            throw new HerdrFailedError(["tab", "rename", name], 1, "pane not found");
+            throw await this.missingPaneError(["tab", "rename", name]);
         }
         if (pane.tabId === null) {
             throw new HerdrFailedError(["tab", "rename", name], 1, "tab id unavailable");
@@ -540,7 +627,7 @@ export class HerdrSessionManager {
         validateSessionName(name);
         const target = await this.paneTarget(name);
         if (target === null) {
-            throw new HerdrFailedError(["pane", "close", name], 1, "pane not found");
+            throw await this.missingPaneError(["pane", "close", name]);
         }
         const args = ["pane", "close", target];
         const result = await this.runner(args);
@@ -558,6 +645,7 @@ export class HerdrSessionManager {
      * リトライで確定させる。submit 済みの空入力への Enter は no-op なので二重送信は起きない。
      */
     async sendTextSubmit(name, text, options = {}) {
+        const startedAtMs = Date.now();
         // ブート直後の注入は本文ごと TUI 初期化に破棄され得る（実測: 入力欄にも jsonl にも
         // 残らない）。herdr の claude 検出（agent_status が unknown を抜けるまで）を注入の
         // 準備完了ゲートにする。working（処理中の queue 入力）も注入可。判定不能は fail-open。
@@ -583,9 +671,29 @@ export class HerdrSessionManager {
         }
         // 選択ダイアログ（/remote-control 等）が開いたままだと本文がダイアログに食われる。
         // 注入前に Esc で閉じてから入力欄へ流す（Mac 側で手動 Esc するのと同じ操作）。
-        if (dialogWindow !== null && screenHasSelectionFooter(dialogWindow)) {
-            await this.sendKeys(name, ["Escape"]);
-            await new Promise((resolve) => setTimeout(resolve, 300));
+        // herdr は `cancelChoiceDialog` 指定の有無に関わらず閉じる（従来からの挙動。設問は hub が
+        // 保留で守るので、ここへ来るのは利用者が答えずに送ると決めた送信か ❯ メニューだけ）。
+        // Esc は 1 回だけ打ち、消えたのを確かめてから進む（chat-cancel-choice）。旧実装は 300ms
+        // 待つだけで確認せず、閉じ切る前に本文を打ってダイアログへ落とし得た。
+        // ボトムバーが見えているフレームでは撃たない: Esc は処理中の Claude を中断するキーでもあり、
+        // 30 行窓は会話本文（閉じたダイアログの転写や引用）を含むため。
+        let choiceStuck = false;
+        let choiceCancelled = false;
+        if (dialogWindow !== null) {
+            const outcome = await cancelChoiceDialog({
+                screen: dialogWindow,
+                capture: () => this.captureDialogWindow(name),
+                sendEscape: () => this.sendKeys(name, ["Escape"]),
+                detect: (window) => screenHasSelectionFooter(window) && !claudeComposerBarVisible(window),
+                pollMs: this.choiceCancelPollMs,
+                maxPolls: CHOICE_CANCEL_MAX_POLLS,
+            });
+            // 閉じたかどうかの最終判断は下のフレーム判定に任せる（30 行窓は会話本文を含むので、
+            // 本文に残った文言で「閉じていない」と見誤っても、ダイアログでなければ従来どおり送る）。
+            choiceStuck = outcome === "stuck";
+            choiceCancelled = outcome === "cancelled";
+            if (choiceCancelled)
+                options.onChoiceDialogCancelled?.();
         }
         // 中断（停止）直後の入力欄に残存テキストがあるまま注入すると、今回の本文がその後ろへ
         // 連結され 1 メッセージとして送信される（実機FB 2026-07-29: 停止→送信で「前回本文+今回
@@ -603,8 +711,25 @@ export class HerdrSessionManager {
         // ではないので上の Esc では閉じられない）。ここまで来てバーが見えないなら、本文を
         // 1 キーも打たずに諦める。
         // 見逃し側（未知フレーム）は従来どおり注入へ進む＝送信が丸ごと不能にはならない。
-        const injectFrame = classifySubmitFrame(await this.captureVisibleScreenAnsiOrNull(name));
+        // 閉じた直後は描画途中でボトムバーが欠けることがある。設問を閉じる指定の送信だけ、
+        // 入力欄が描画されるまで短く撮り直す（指定の無い送信は read 回数を増やさない）。
+        const { frame: injectFrame } = await settleFrameAfterChoiceCancel({
+            capture: () => this.captureVisibleScreenAnsiOrNull(name),
+            pollMs: this.choiceCancelPollMs,
+            maxPolls: choiceCancelled && options.cancelChoiceDialog === true ? CHOICE_CANCEL_MAX_POLLS : 0,
+        });
+        if (choiceCancelled && options.cancelChoiceDialog === true && injectFrame === "unknown") {
+            throw new ChatInjectionRejectedError(CHAT_BLOCKED_AFTER_CHOICE_CANCELLED);
+        }
+        if (options.cancelChoiceDialog === true && injectFrame === "unknown") {
+            // 設問がある前提の送信は fail-closed: 入力欄（ボトムバー）が見えたときだけ打つ。
+            // 指定の無い送信は従来どおり（未知フレームで送信が丸ごと不能にならないよう fail-open）。
+            throw new ChatInjectionRejectedError(CHAT_BLOCKED_BY_UNREADABLE_CHOICE);
+        }
         if (injectFrame === "dialog") {
+            // Esc は打ったが閉じない。ここで本文を打つとダイアログへ落ちるので、何も打たずに諦める。
+            if (choiceStuck)
+                throw new ChatInjectionRejectedError(CHAT_BLOCKED_BY_STUCK_CHOICE);
             throw new ChatInjectionRejectedError("ダイアログの表示中はメッセージを送信できません（アプリで選択肢に答えてから送り直してください）");
         }
         const pending = injectFrame === "pending" ? await this.inputBoxPendingText(name) : "";
@@ -636,6 +761,43 @@ export class HerdrSessionManager {
         // chat_send を uncertain（アプリの明示再送）へ倒す。
         const probe = typedTextProbe(text);
         let typed = probe === null;
+        if (!typed && typedTextWouldBreak(text) && textIsPasteSafe(text)) {
+            // 1 回で打つと壊れる本文は、小分けの括弧付き貼り付けで渡す（long-text-paste）。1 回で打つと
+            // CLI が読み取りの境界ごとに貼り付けとして取り込み、入力欄が `[Pasted text #N]` になって
+            // 下の反映検証が必ず失敗する（実測 2.1.283: 983 字の送信が 3 回打ち直した末に失敗）。
+            const target = await this.paneTarget(name);
+            if (target === null) {
+                throw await this.missingPaneError(["pane", "send-text", name]);
+            }
+            const sendRaw = async (payload) => {
+                const args = ["pane", "send-text", target, payload];
+                const result = await this.runner(args);
+                if (result.exitCode !== 0)
+                    throw new HerdrFailedError(args, result.exitCode, result.stderr);
+            };
+            const outcome = await pasteTextInline(text, {
+                // 1 つずつ書き込む。まとめて書き込むと、CLI が読み進めるのを待たされる（実測: 8KB を
+                // 1 回で書くと入り切るまで 4〜7 秒、20KB は 10 秒でも入り切らない。1 つずつなら 1 秒）。
+                paste: async (pieces) => {
+                    for (const piece of pieces)
+                        await sendRaw(`${BRACKETED_PASTE_START}${piece}${BRACKETED_PASTE_END}`);
+                },
+                capture: () => this.captureVisibleScreenAnsiOrNull(name),
+                sendKills: (count) => sendRaw(KILL_LINE_SEQUENCE.repeat(count)),
+                pollMs: this.pastedTextPollMs,
+                timeoutMs: this.pastedTextTimeoutMs,
+                clearDelayMs: this.clearKeyDelayMs,
+                clearSettleMs: this.clearSettleMs,
+                verifyDeadlineMs: startedAtMs + INJECT_VERIFY_BUDGET_MS,
+            });
+            if (outcome !== "arrived") {
+                // 打つ場合の反映検証と同じ扱い: 残骸を best-effort で掃除してから失敗として返す。
+                // 貼り直しはしない（CLI が止まっていただけなら、貼り直した分だけ後から重なって入る）。
+                await this.clearInputBox(name);
+                throw new HerdrFailedError(["pane", "send-text", name], 1, "pasted text did not reach the input box (RC limbo / ダイアログ表示中 / 入力欄不可視 / CLI の停止のいずれか)");
+            }
+            typed = true;
+        }
         for (let attempt = 0; attempt < 3 && !typed; attempt += 1) {
             if (attempt > 0) {
                 await new Promise((resolve) => setTimeout(resolve, this.inputRetryDelayMs));
@@ -671,6 +833,15 @@ export class HerdrSessionManager {
         if ((await this.submitTypedText(name)) !== "submitted")
             options.onUnconfirmedSubmit?.();
     }
+    /** CLI のキューに溜まっている発話を今すぐ届ける（chat-send-now, SessionBackend 共通面）。 */
+    async sendQueuedNow(name) {
+        return sendQueuedNow({
+            capture: () => this.captureVisibleScreenAnsiOrNull(name),
+            sendChord: () => this.sendKeys(name, [SEND_NOW_SEQUENCE], true),
+            pollMs: this.sendNowPollMs,
+            maxPolls: SEND_NOW_MAX_POLLS,
+        });
+    }
     /**
      * 入力済みの本文を Enter で送信し、成立を確認するまで上限つきで撃ち直す（tmux 側と同型）。
      *
@@ -764,6 +935,7 @@ export class HerdrSessionManager {
      */
     async clearInputBox(name) {
         try {
+            let first = null;
             for (let attempt = 0; attempt < 15; attempt += 1) {
                 // ダイアログ判定は selectionDialogVisible（末尾30行窓）に揃える。全画面を
                 // 走査すると、チャット本文に残る閉じたダイアログの転写（「Enter to select」行）を
@@ -777,12 +949,27 @@ export class HerdrSessionManager {
                     return false;
                 if (realText.replace(/\s+/g, "").length === 0)
                     return true;
+                first ??= realText;
                 await this.sendKeys(name, [KILL_LINE_SEQUENCE], true);
                 await new Promise((resolve) => setTimeout(resolve, this.clearKeyDelayMs));
             }
             // 上限到達時も最後の C-u の結果は未観測なので、最終状態を見てから判定する。
             const realText = inputBoxRealText(await this.captureVisibleScreenAnsi(name));
-            return realText !== null && realText.replace(/\s+/g, "").length === 0;
+            if (realText === null)
+                return false;
+            if (realText.replace(/\s+/g, "").length === 0)
+                return true;
+            // 消えてはいるが行が多い（9 行以上の本文は 15 回では消し切れない）。進んでいる限り続ける。
+            // 1 字も消えていない残存（C-u の効かない中身）には、これ以上打たない。
+            // ダイアログが出ていたら `clearTypedInput` が 1 キーも打たない（フレームを確かめてから打つ）。
+            if (realText === first)
+                return false;
+            return await clearTypedInput(CLEAR_UNKNOWN_INPUT_BOUND, {
+                capture: () => this.captureVisibleScreenAnsiOrNull(name),
+                sendKills: (count) => this.sendKeys(name, [KILL_LINE_SEQUENCE.repeat(count)], true),
+                clearDelayMs: this.clearKeyDelayMs,
+                clearSettleMs: this.clearSettleMs,
+            });
         }
         catch {
             return false;
@@ -903,7 +1090,7 @@ export class HerdrSessionManager {
         validateSessionName(name);
         const target = await this.paneTarget(name);
         if (target === null) {
-            throw new HerdrFailedError(["pane", "read", name], 1, "pane not found");
+            throw await this.missingPaneError(["pane", "read", name]);
         }
         return this.readPane(target, ["--source", "visible", "--format", "ansi"]);
     }
@@ -931,7 +1118,7 @@ export class HerdrSessionManager {
             return;
         const target = await this.paneTarget(name);
         if (target === null) {
-            throw new HerdrFailedError(["pane", "send-keys", name], 1, "pane not found");
+            throw await this.missingPaneError(["pane", "send-keys", name]);
         }
         for (const key of keys) {
             let args;
@@ -966,7 +1153,7 @@ export class HerdrSessionManager {
         validateSessionName(name);
         const target = await this.paneTarget(name);
         if (target === null) {
-            throw new HerdrFailedError(["pane", "read", name], 1, "pane not found");
+            throw await this.missingPaneError(["pane", "read", name]);
         }
         const lines = options.lines ?? this.captureLines;
         if (options.joinWrappedLines ?? false) {
@@ -991,7 +1178,7 @@ export class HerdrSessionManager {
         validateSessionName(name);
         const target = await this.paneTarget(name);
         if (target === null) {
-            throw new HerdrFailedError(["pane", "read", name], 1, "pane not found");
+            throw await this.missingPaneError(["pane", "read", name]);
         }
         return this.readPane(target, ["--source", "visible"]);
     }
@@ -1026,6 +1213,24 @@ export class HerdrSessionManager {
             // ENOENT 等（未導入環境）は無視。
         }
     }
+    /**
+     * 入出力先の pane が見つからなかったときのエラー。`pane list` 自体が旧サーバーとの非互換
+     * （`protocol_mismatch`）で失敗していたなら、「pane が無い」ではなく更新の案内を返す
+     * （livePanes は失敗を空集合として握るため、そのままだと送信失敗が `pane not found` に化ける）。
+     * 見つからなかった後だけ 1 回追加で問い合わせるので、正常時の経路は増えない。
+     */
+    async missingPaneError(args) {
+        try {
+            const result = await this.runner(["pane", "list"]);
+            if (result.exitCode !== 0 && herdrErrorCode(result.stderr) === "protocol_mismatch") {
+                return new HerdrFailedError(["pane", "list"], result.exitCode, result.stderr);
+            }
+        }
+        catch {
+            // 実行ファイル起動失敗などは従来どおり「pane が無い」として扱う。
+        }
+        return new HerdrFailedError(args, 1, "pane not found");
+    }
     /** 生存 pane の一覧。取得できなかった場合は null（「0 件」と区別する）。 */
     async livePanesOrNull() {
         try {
@@ -1044,14 +1249,11 @@ export class HerdrSessionManager {
     }
     /** セッション名の現存 pane を解決する（記録済み pane ID 優先、無ければ label 一致）。 */
     async findPane(name) {
-        const panes = await this.livePanes();
-        const recorded = this.store.get(name)?.herdrPaneId;
-        if (recorded !== undefined) {
-            const byId = panes.find((pane) => pane.paneId === recorded);
-            if (byId !== undefined)
-                return byId;
-        }
-        return panes.find((pane) => pane.label === name) ?? null;
+        return resolveHerdrSessionPane(await this.livePanes(), name, this.store.get(name)?.herdrPaneId, 
+        // 3. の判定でだけ該当 1 件を読む（findPane はライブビュー更新で 250ms ごとに呼ばれるので
+        // メタ全件は読まない）。名前の一致まで見るのは、大文字小文字を区別しない FS で
+        // `S-B` が `s-b.json` を読んでも別名扱いにし、listFromPanes（中身の名前で判定）と揃えるため。
+        (label) => this.store.get(label)?.name === label);
     }
     /** 入出力 target の pane ID（現存しなければ null）。 */
     async paneTarget(name) {