tailii-host 0.10.1 → 0.11.0

package/dist/backend/tmux.d.ts

@@ -7,7 +7,7 @@ export interface TmuxCommandResult {
     stderr: string;
 }
 /** tmux コマンド実行の注入可能な抽象（テストはモックを注入する）。 */
-export type TmuxCommandRunner = (args: string[]) => Promise<TmuxCommandResult>;
+export type TmuxCommandRunner = (args: string[], input?: string) => Promise<TmuxCommandResult>;
 /** tmux 実行ファイルの既定絶対パス（PATH 外のため絶対指定）。 */
 export declare const DEFAULT_TMUX_PATH = "/opt/homebrew/bin/tmux";
 /** tmux の pane_current_command がエージェント実行中に見えるか。空文字は判定不能なので安全側。 */
@@ -30,7 +30,7 @@ export declare function inputBoxIsShellMode(box: ClaudeInputBox | null): boolean
 /**
  * 画面から claude TUI の入力欄を取り出す（TESTABLE）。
  *
- * 入力欄は末尾側の 2 本の水平罫線に挟まれた領域。`❯` 行だけを探す旧実装は
+ * 入力欄は上下 2 本の水平罫線に挟まれた領域（枠の探し方は `findInputBoxFrame`）。`❯` 行だけを探す旧実装は
  * シェルモード（プロンプトが `!` になる）で入力欄を見失い、注入検証が必ず失敗
  * → 本文を 3 回重ね打ちして入力欄を壊し、送信失敗として throw していた
  * （実障害 2026-08-03: `!` 始まりの送信が HerdrFailedError）。
@@ -98,7 +98,215 @@ export interface SendTextSubmitOptions {
      * 本文を明示再送へ倒すと二重送信になり得るため（「配送済み扱い + 可観測化」を選ぶ）。
      */
     onUnconfirmedSubmit?: () => void;
+    /**
+     * 選択ダイアログ（AskUserQuestion の設問 / ❯ メニュー）が開いていたら、Esc で閉じてから本文を送る
+     * （chat-cancel-choice）。利用者が「選択肢に答えずにメッセージを送る」と決めた送信にだけ付く。
+     * 付いていない送信は従来どおり 1 キーも打たずに拒否する（tmux）。
+     * 承認ダイアログと `/login` フローは対象外（どちらも専用の操作経路があり、Esc の意味が重い）。
+     */
+    cancelChoiceDialog?: boolean;
+    /** 選択ダイアログを実際に Esc で閉じたときに 1 回だけ呼ばれる（hub が監査ログへ残す）。 */
+    onChoiceDialogCancelled?: () => void;
+}
+/**
+ * CLI が 1 回に読み取る入力の上限（バイト）。macOS の pty は 1022（実測 2.1.284: tmux / herdr とも）。
+ * Linux の pty は 1 回で約 4095 バイトまで返しうる（未実測。広い側に倒す）。
+ */
+export declare const PASTE_READ_BYTES: number;
+export declare function typedTextWouldBreak(text: string, readBytes?: number): boolean;
+/** tmux で 1 回で打つと壊れる本文か（TESTABLE）。引数の上限を超える本文も貼り付けで渡す。 */
+export declare function tmuxTypedTextWouldBreak(text: string): boolean;
+/** 括弧付き貼り付けの開始・終了（端末の bracketed paste）。 */
+export declare const BRACKETED_PASTE_START = "\u001B[200~";
+export declare const BRACKETED_PASTE_END = "\u001B[201~";
+/**
+ * 貼り付けとして渡せる本文か。ESC を含む本文は、途中の `ESC[201~` で貼り付けが終わり、残りが
+ * 打鍵として解釈されうるので渡さない（従来どおり打つ）。
+ */
+export declare function textIsPasteSafe(text: string): boolean;
+/**
+ * 入力反映検証に使う probe（本文の**末尾側**）。検証不能な本文（空など）は null。
+ *
+ * 末尾側なのは composer の表示特性のため: 入力が表示高を超えると composer は下へ
+ * スクロールし**先頭行が窓外へ消える**（実測 2.1.220: 10行ペーストで先頭4行が
+ * capture から消失）。カーソルは常に末尾にあるので、末尾側の probe だけが
+ * 「見えている範囲」との照合を保証できる（先頭24字の旧 probe は多行/長文で
+ * 構造的に偽陰性 → 再投入 → 本文二重化の温床だった）。
+ *
+ * 先頭 `!`（シェルモード）は claude TUI がモード記号として吸い上げ、入力欄本文には
+ * 残らない（`!ls -la` は `! ls -la` と描画される）。単一行本文では照合キーからも
+ * 落とさないと末尾24字に `!` が含まれるとき反映検証が失敗する。
+ */
+export declare function typedTextProbe(text: string): string | null;
+/**
+ * 入力欄テキストに probe が反映されているか（折り返し非依存）。
+ * extractClaudeInputBox は表示行を trim + "\n" 連結で返すため、probe が入力欄の
+ * 行折り返しをまたぐと生の includes は絶対に一致しない（全角24字=48桁 > 内幅で必発）。
+ * この偽陰性が「反映済み本文の再投入 = 初回送信の本文二重化」の根因だった（実機5件）。
+ * 空白類（折り返しの改行・trim 痕・全角空白含む）と不可視文字を両辺から除去して照合する。
+ *
+ * 結合文字は両辺を NFC にそろえる。端末には合成済みの形で映るので（`e` + U+0301 → `é`、
+ * `か` + U+3099 → `が`）、分解形（macOS 由来の文字列に多い）のままの probe は一致しない
+ * （独立検証が実測: 結合文字を含む本文の反映検証が必ず失敗した）。
+ */
+export declare function inputBoxTextIncludesProbe(boxText: string, probe: string): boolean;
+/**
+ * 1 つの貼り付けに入れる本文の上限（TESTABLE）。CLI（実測 2.1.284）は、1 つの貼り付けが
+ * **800 字以下で改行 2 個以下**なら、畳まずに本文のまま入力欄へ入れる（801 字・改行 3 個から
+ * `[Pasted text #N +M lines]` に畳む。字数は UTF-16 の単位で数える）。境界より手前に取る。
+ */
+export declare const INLINE_PASTE_MAX_CHARS = 500;
+export declare const INLINE_PASTE_MAX_NEWLINES = 1;
+/**
+ * 1 つの貼り付けのバイト数の上限。括弧（12 バイト）を足しても、CLI の 1 回の読み取り（1022 バイト）と
+ * pty の入力の待ち行列に収まる大きさにする。まとめて書き込むと、CLI が読み進めるのを待たされる
+ * （実測 herdr: 8KB を 1 回で書くと、入り切るまで 4〜7 秒。1 つずつなら 0.3 秒）。
+ */
+export declare const INLINE_PASTE_MAX_BYTES = 900;
+/**
+ * 貼り付ける前に、CLI が記録するときの形へそろえる（TESTABLE）。CLI（実測 2.1.284）は貼り付けの
+ * CR / CRLF / U+2028 を LF にし、制御文字（DEL・U+009B など）を落とす。先にそろえておくと、
+ * 入力欄に映る本文と照合できる（そろえないと、これらを含む本文は毎回「入らなかった」と判定される）。
+ * タブと LF は残す。ESC を含む本文は貼り付けない（`textIsPasteSafe`）。
+ */
+export declare function normalizeTextForPaste(text: string): string;
+/**
+ * 本文を、畳まれずに入力欄へ入る大きさの貼り付けに分ける（long-text-paste, TESTABLE）。
+ * つなげると元の本文に戻る。
+ *
+ * - 1 つは `INLINE_PASTE_MAX_CHARS` 字・`INLINE_PASTE_MAX_BYTES` バイト・改行
+ *   `INLINE_PASTE_MAX_NEWLINES` 個まで
+ * - 書記素の途中では分けない（結合文字・ZWJ でつないだ絵文字・サロゲートの対）
+ * - **拡張子の付いた語を、1 つの貼り付けの中に丸ごと入れない**。CLI は、貼り付けの中の実在する
+ *   画像のパスを `[Image #N]` の添付に置き換える（実測 2.1.284: 貼り付けの全体がパスのとき。
+ *   パスが 2 つ以上並ぶときは、後ろに本文が続いていても置き換わり、語の順序まで変わる）。
+ *   アプリは添付のパスを本文の前に空白区切りで並べる（`p1 p2 本文`）。拡張子の「.」の直後で
+ *   分けると、前半は拡張子が無く、後半はパスの形をしていない
+ */
+export declare function splitForInlinePaste(text: string): string[];
+/** ボトムバーの位置に `paste again to expand` が出ているか（常駐 TUI 行は読み飛ばす, TESTABLE）。 */
+export declare function screenShowsPasteHint(screen: string): boolean;
+/**
+ * 入力欄に映っている本文が、`text` の一部として順に現れるか（TESTABLE）。
+ * 置き換えの表示（`TRUNCATED_DISPLAY`）で区切られた各部分が、`text` の中にこの順で現れることを
+ * 確かめる。`anchoredAtEnd` なら、最後の部分は `text` の末尾と同文でなければならない。
+ * 一致した字数を返す（一致しなければ -1）。照合は空白類・不可視文字を落とした形で行う。
+ */
+export declare function matchInputBoxAgainstText(boxText: string, text: string, anchoredAtEnd: boolean): number;
+/**
+ * 貼り付けた本文が入力欄に入ったか（TESTABLE）。**入力欄に映っている全体が、本文の末尾と同文**
+ * であることで確かめる（入力欄は長い本文の末尾側だけを映す）。pty は先入れ先出しなので、最後の
+ * 貼り付けが入っていれば、その前の貼り付けも CLI が読み終えている。
+ * 約 10000 字を超える本文は、中ほどが置き換えの表示になる（`matchInputBoxAgainstText`）。
+ *
+ * 末尾の数十字だけを探す照合にはしない。各行の終わりが同じ文言の本文（表・ログ）だと、途中まで
+ * 入った時点で一致してしまう。CLI の処理が止まっている最中にそうなると、続けて打つ Enter が
+ * 貼り付けの残りと一緒に読まれて改行として本文に入り、送信されないまま入力欄に残る（実測
+ * 2.1.284: 30 行の本文を 11 行まで入った時点で止めた）。
+ */
+export declare function pastedTextArrived(boxText: string, text: string): boolean;
+/**
+ * 入力欄に映っているのが、貼り付けた本文の一部か（TESTABLE）。貼り付けが途中まで入った形
+ * （CLI がまだ読んでいる / 処理が止まっている）を、別の中身と見分ける。
+ */
+export declare function pastedTextPartlyArrived(boxText: string, text: string): boolean;
+/** 本文を小分けの貼り付けで渡すための入出力（tmux / herdr が与える）。 */
+export interface PastedTextIo {
+    /** 小分けにした本文を、1 つずつ括弧付き貼り付けとして、順に渡す。 */
+    paste: (pieces: string[]) => Promise<void>;
+    /** viewport を ANSI 付きで撮る（撮れなければ null）。 */
+    capture: () => Promise<string | null>;
+    /** C-u（kill-line）を `count` 回、続けて打つ。 */
+    sendKills: (count: number) => Promise<void>;
+    /** 入力欄に入ったのを確かめる間隔と上限（ms）。 */
+    pollMs: number;
+    timeoutMs: number;
+    /** C-u をまとめて打った後、画面を撮り直すまでの間隔（ms）。 */
+    clearDelayMs: number;
+    /** C-u をまとめて打った後、入力欄が変わるのを待つ上限（ms。既定 `TYPED_TEXT_CLEAR_SETTLE_MS`）。 */
+    clearSettleMs?: number;
+    /** 貼り付けが入るのを待つのを、遅くともこの時刻（epoch ms）で打ち切る。 */
+    verifyDeadlineMs?: number;
 }
+/** 貼り付けが入力欄に入るのを待つ上限と、確かめる間隔の既定（ms）。実測は 0.3 秒以内に入る。 */
+export declare const PASTED_TEXT_TIMEOUT_MS = 3000;
+/**
+ * tmux で待つ上限の既定（ms）。tmux は確かめられなくても送信確定へ進むので、長く待つ意味が薄い
+ * （画面が崩れて読めない間は、貼り付けで渡す送信のたびにこの時間がかかる）。入っている途中なら延ばす。
+ */
+export declare const PASTED_TEXT_TIMEOUT_TMUX_MS = 1500;
+export declare const PASTED_TEXT_POLL_MS = 100;
+/**
+ * C-u をまとめて打った後、入力欄が変わるのを待つ上限（ms）。長い本文は、1 回消すたびに入力欄の
+ * 描き直しがかかり、40 回ぶんの反映に 1 秒以上かかる（実測 herdr: 10000 字の本文。150ms おきに
+ * 3 回見て変わらなければ諦める作りでは、消している途中で諦め、先頭の 468 字が残った）。
+ */
+export declare const TYPED_TEXT_CLEAR_SETTLE_MS = 1500;
+/**
+ * 入れかけの長い本文を入力欄から消す（TESTABLE）。空にできたら true。
+ *
+ * C-u（kill-line）は 1 回で 1 行ぶんしか消えない: 多行の本文は末尾行 → その改行の順に消え、
+ * N 行なら 2N-1 回かかる（実測 2.1.220）。回数を固定（`clearInputBox` は 15 回）にすると
+ * 9 行以上の本文は途中までしか消えない。40 回ずつまとめて打ち、**入力欄が空になるまで、
+ * 進んでいる限り続ける**（上限は本文の大きさから決める）。まとめて打った後は、入力欄が変わるのを
+ * `clearSettleMs` まで待つ。2 回続けて変わらなければ諦める（同じ行が並ぶ本文は、消えていても
+ * 映っている範囲が同じに見えるので、1 回では諦めない）。空の入力欄への C-u は何もしない。
+ * 入力欄のフレームと確かめられないとき（ダイアログ・判別不能）は 1 キーも打たない。
+ */
+export declare function clearTypedInput(text: string, io: Pick<PastedTextIo, "capture" | "sendKills" | "clearDelayMs" | "clearSettleMs">): Promise<boolean>;
+/**
+ * 行数の分からない残存を消すときの上限（`clearTypedInput` の本文の代わりに渡す）。
+ * 400 行ぶん（C-u 約 800 回）まで。
+ */
+export declare const CLEAR_UNKNOWN_INPUT_BOUND: string;
+/** 貼り付けの送出が途中で失敗し、入った分を入力欄から消した（= 非配達が確定）ときの拒否文言。 */
+export declare const CHAT_BLOCKED_BY_UNTYPED_TEXT = "\u9577\u3044\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u5165\u529B\u6B04\u3078\u6B63\u3057\u304F\u5165\u529B\u3067\u304D\u306A\u304B\u3063\u305F\u305F\u3081\u3001\u9001\u4FE1\u3057\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u3082\u3046\u4E00\u5EA6\u9001\u3063\u3066\u304F\u3060\u3055\u3044\uFF09";
+/**
+ * 注入を始めてから、貼り付けが入ったのを確かめ終えるまでに使ってよい時間（ms）。アプリは応答を
+ * 18 秒待つ。この後の送信確定（最大で tmux 3.4 秒 / herdr 5.2 秒）を引いた残りに収める。
+ */
+export declare const INJECT_VERIFY_BUDGET_MS = 12000;
+/** 貼り付けた本文が入力欄に入ったのを、確かめられたか。 */
+export type PasteOutcome = "arrived" | "unverified";
+/**
+ * 本文を、小分けの括弧付き貼り付けで入力欄へ入れる（tmux / herdr 共通, long-text-paste）。
+ *
+ * ```
+ * 小分けにして順に貼り付ける（splitForInlinePaste）
+ * 100ms ごとに最大 3 秒、入力欄に入ったのを確かめる（pastedTextArrived）→ `arrived`
+ *   （入っている途中で、進んでいる間は延ばす。最大 9 秒。注入を始めてから 12 秒まで）
+ * 確かめられなかった → `unverified`（1 キーも打たない。どう扱うかは backend が決める）
+ * 貼り付けの送出が途中で失敗した:
+ *   入った分が入力欄に映っている → 消す（clearTypedInput）。空にできたら
+ *                                    ChatInjectionRejectedError（非配達が確定）
+ *   それ以外                     → 送出のエラーをそのまま返す
+ * ```
+ *
+ * 貼り付けは打鍵と違い、読み取りの境界・タブ・結合文字で壊れない。1 つが 800 字以下・改行 2 個
+ * 以下なら CLI は畳まずに本文のまま入力欄へ入れるので、**打った場合と同じ本文が記録される**
+ * （`<pasted_content>` の包みが付かない）。
+ *
+ * **確かめられなかったときの扱いは、本文を打つ場合（変更前からの経路）と同じにする**:
+ * - tmux: そのまま送信確定へ進む（Enter を押し、成立を確認できなければ `onUnconfirmedSubmit`）。
+ *   画面を読めないだけのことがある（実測: 肌色付きの ✌🏽 などを含む発話の後、tmux の画面が
+ *   崩れて入力欄が 1 行ずれる）。Enter は貼り付けの後ろに並ぶので、途中までの本文が送信される
+ *   ことは無い
+ * - herdr: 失敗として返す（打つ場合の反映検証と同じ。Remote Control 切断直後は入力が捨てられ、
+ *   確かめずに進むと「送信成立」と誤判定する）
+ *
+ * 採らなかった方式:
+ * - **小分けにして打つ**: タブのカーソルずれ・処理の停止・結合文字で、順序の崩れた本文や先頭が
+ *   重複した本文が黙って届いた（独立検証が実 claude で再現）。
+ * - **全文を 1 つの貼り付けで渡す**: 入力欄は `[Pasted text #N +M lines]` になり、本文は包まれて
+ *   記録される。確かめる根拠が改行の数しか無く、同じ行数の別の貼り付け（Mac 側の下書き）と
+ *   見分けられない。包みは Claude に「利用者が書いたとは限らない内容」と伝えるためのもので、
+ *   利用者の指示の全体をその扱いにしてしまう。会話の一覧・タイトル・検索にも包みが出る。
+ * - **確かめられなかった本文を控えて、後から入った分を消す**（控え・確認用の印）: CLI が止まった
+ *   ときの「ちょうど 1 通」は守れるが、画面の読み取りに頼る判定が増え、それ自体が誤配送と
+ *   送信不能の源になった（独立検証 5 周: 印が発話として届く・下書きを削る・画面が崩れると
+ *   以後の送信がすべて拒否される）。
+ */
+export declare function pasteTextInline(text: string, io: PastedTextIo): Promise<PasteOutcome>;
 /**
  * 入力欄の残存テキストが、transcript に記録済みの発話本文と同文か（restored-prompt-discard）。
  *
@@ -247,6 +455,153 @@ export declare class TmuxFailedError extends Error {
  * （`screenHasSelectionFooter` と同じ硬化）。
  */
 export declare function screenShowsDialogFooter(screen: string): boolean;
+/**
+ * **Esc で閉じてよい**選択ダイアログ（AskUserQuestion の設問 / ❯ メニュー）が画面下部に出ているか
+ * （chat-cancel-choice, TESTABLE）。実測 2.1.283 のフッター:
+ * - 設問（1 問）: `Enter to select · ↑/↓ to navigate · Esc to cancel`
+ * - 設問（複数問）: `Enter to select · Tab/Arrow keys to navigate · Esc to cancel`
+ * - 自由記述欄にフォーカス中: 上に `· ctrl+g to edit in VS Code` が挟まる（80 桁では折り返す）
+ *
+ * `screenShowsDialogFooter` より狭い: ツール承認（`Esc to cancel · Tab to amend`）と `/login` の
+ * 継続待ちは含めない。承認の Esc は「ツールを拒否してターンを止める」で、選択肢を閉じるのとは
+ * 重さが違う（承認はアプリの承認モーダルが正規の経路）。
+ * 折り返しで `Esc to cancel` が次の行へ落ちるので、同じ行に両方あることは要求しない。
+ * Esc は処理中の Claude を中断するキーでもあるため、**ボトムバーが見えているフレームでは
+ * 決して true にしない**（本文の引用を末尾窓で拾っても、composer を見ているなら撃たない）。
+ */
+export declare function screenShowsCancellableChoice(screen: string): boolean;
+/**
+ * ツール承認ダイアログ（フッター `Esc to cancel · Tab to amend`）が画面下部に出ているか（TESTABLE）。
+ * 通常の承認は PreToolUse hook がアプリの承認モーダルで捌き TUI には出ないが、hook の allow を
+ * 上書きする Claude Code 自身の安全確認（作業フォルダ外への Artifact 保存・`.claude/` への書き込み等）
+ * は TUI に残り、利用者が答えるまで会話が止まる。pane_preview の「静止した入力待ち」として初回
+ * フレームから送り、iPhone の転写カードで答えられるようにする（開き直しでもカードが出る）。
+ * フッターはカーソルが 1 番目のとき `Esc to cancel · Tab to amend`、2 番目以降へ動かすと
+ * `Esc to cancel` 単独になる（実測 2.1.283）ので、行頭の `Esc to cancel` で拾う（`/login` の各画面も
+ * 同じフッターだが、そちらも静止した入力待ちとして初回から送る対象なので区別しない）。
+ * 判定は `screenShowsCancellableChoice` と同じ硬化（末尾数行・行頭一致・ボトムバーが見えたら偽）。
+ */
+export declare function screenShowsApprovalDialog(screen: string): boolean;
+/**
+ * 選択ダイアログを Esc で閉じる試行の結果。
+ * - `absent`: 閉じるべき選択ダイアログが見えない（1 キーも打っていない）。
+ * - `cancelled`: Esc を 1 回打ち、ダイアログが消えたことを確認した。
+ * - `stuck`: Esc を打ったが、待ってもダイアログが消えない（または画面を読めない）。
+ */
+export type ChoiceDialogCancelOutcome = "absent" | "cancelled" | "stuck";
+/**
+ * 選択ダイアログを Esc で閉じ、消えたことを確認する（tmux / herdr 共通, chat-cancel-choice）。
+ *
+ * **Esc は 1 回しか打たない**。実測 2.1.283 では設問が複数でも、自由記述欄にフォーカスが
+ * あっても 1 回で閉じて 0.3 秒以内に空の入力欄へ戻る。閉じた後の入力欄へもう 1 回届くと
+ * 「Esc 2 回」= 巻き戻し（rewind）の画面が開き、続けて打つ本文がそこへ落ちる。
+ * 消えたかどうかは読めたフレームだけで判断する（capture 不能を「閉じた」と見なさない）。
+ */
+export declare function cancelChoiceDialog(io: {
+    /** 呼び出し側が直前に撮ったフレーム（事前確認の capture 回数を増やさない）。null = 撮れなかった。 */
+    screen: string | null;
+    capture: () => Promise<string | null>;
+    sendEscape: () => Promise<void>;
+    /** 既定は `screenShowsCancellableChoice`。herdr は従来の判定窓を渡す。 */
+    detect?: (screen: string) => boolean;
+    pollMs: number;
+    maxPolls: number;
+}): Promise<ChoiceDialogCancelOutcome>;
+/** Esc 後にダイアログの消滅を確かめる間隔と回数の既定（合計 約 2.4s）。 */
+export declare const CHOICE_CANCEL_POLL_MS = 300;
+export declare const CHOICE_CANCEL_MAX_POLLS = 8;
+/**
+ * 設問を閉じて送る指定なのに、入力欄へ戻ったことを画面で確かめられなかったときの拒否文言。
+ * hub は「未回答の設問がある」と知っている。判別できない画面へ本文を打つと選択肢へ落ちる。
+ */
+export declare const CHAT_BLOCKED_BY_UNREADABLE_CHOICE = "\u8A2D\u554F\u306E\u753B\u9762\u3092\u78BA\u8A8D\u3067\u304D\u306A\u304B\u3063\u305F\u305F\u3081\u3001\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u9001\u4FE1\u3057\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u5C11\u3057\u5F85\u3063\u3066\u9001\u308A\u76F4\u3059\u304B\u3001\u30A2\u30D7\u30EA\u3067\u8A2D\u554F\u306B\u7B54\u3048\u3066\u304F\u3060\u3055\u3044\uFF09";
+/** 設問は閉じたが、その後の入力欄を画面で確かめられなかったときの拒否文言。 */
+export declare const CHAT_BLOCKED_AFTER_CHOICE_CANCELLED = "\u8A2D\u554F\u306F\u9589\u3058\u307E\u3057\u305F\u304C\u3001\u5165\u529B\u6B04\u3092\u78BA\u8A8D\u3067\u304D\u306A\u304B\u3063\u305F\u305F\u3081\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u9001\u4FE1\u3057\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u9001\u308A\u76F4\u3057\u3066\u304F\u3060\u3055\u3044\uFF09";
+/**
+ * 選択ダイアログを閉じた直後のフレームを、入力欄が描画されるまで撮り直す（tmux / herdr 共通）。
+ * 閉じた直後は描画途中でボトムバーが欠け、`unknown` に見えることがある。ここで諦めると
+ * 「設問は閉じたのに本文は未送信」になるので、`unknown` の間だけ短く待つ。
+ */
+export declare function settleFrameAfterChoiceCancel(io: {
+    capture: () => Promise<string | null>;
+    pollMs: number;
+    maxPolls: number;
+}): Promise<{
+    screen: string | null;
+    frame: SubmitFrameVerdict;
+}>;
+/** 選択ダイアログを閉じられなかったときの拒否文言（hub が会話本文へそのまま出す）。 */
+export declare const CHAT_BLOCKED_BY_STUCK_CHOICE = "\u9078\u629E\u80A2\u3092\u9589\u3058\u3089\u308C\u306A\u304B\u3063\u305F\u305F\u3081\u3001\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u9001\u4FE1\u3057\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u30A2\u30D7\u30EA\u3067\u9078\u629E\u80A2\u306B\u7B54\u3048\u308B\u304B\u3001Mac \u5074\u306E\u753B\u9762\u3067\u9589\u3058\u3066\u304F\u3060\u3055\u3044\uFF09";
+/**
+ * キュー済みの発話の直下に出る「今すぐ送信」ヒント行の状態（chat-send-now, TESTABLE）。
+ * - `absent`: ヒント行が無い = CLI のキューに利用者の発話は無い。
+ * - `ready`: 既定のキー割り当てのヒントが出ている。
+ * - `rebound`: ヒントは出ているが、キー割り当てが既定と違う（利用者が keybindings を変えた）。
+ */
+export type SendNowHintState = "absent" | "ready" | "rebound";
+/**
+ * 画面に「今すぐ送信」のヒントが出ているか。実測 2.1.283 の形:
+ *
+ * ```
+ * ❯ キュー済みの発話（長ければ 2 桁字下げで折り返す）
+ *   ctrl+x ctrl+s to send now
+ * ✽ Proofing… (9s · ↓ 183 tokens)
+ * ────────
+ * ❯ Press up to edit queued messages
+ * ```
+ *
+ * 会話本文がこの文言を引用しただけで拾わないよう、**ヒント行のすぐ上がキュー済みの発話**
+ * （`❯` で始まる行と、その折り返し）であることを要求する。応答本文は `⏺` で始まるので、
+ * 本文中の引用は上へ辿ると先に `⏺` に当たって外れる。
+ * 誤検出しても実害は無い（キューが空のときの chord は何もしない。実測）。
+ */
+export declare function screenSendNowHint(screen: string): SendNowHintState;
+/** `sendQueuedNow` の結果（ワイヤーの `chat_send_now_result.status` と同じ 4 値）。 */
+export type SendQueuedNowOutcome = {
+    status: "sent";
+} | {
+    status: "nothing_queued";
+} | {
+    status: "blocked";
+    reason: string;
+} | {
+    status: "failed";
+    reason: string;
+};
+export declare const SEND_NOW_BLOCKED_BY_DIALOG = "\u30C0\u30A4\u30A2\u30ED\u30B0\u306E\u8868\u793A\u4E2D\u306F\u300C\u4ECA\u3059\u3050\u9001\u4FE1\u300D\u3067\u304D\u307E\u305B\u3093\uFF08\u30A2\u30D7\u30EA\u3067\u9078\u629E\u80A2\u306B\u7B54\u3048\u3066\u304B\u3089\u3082\u3046\u4E00\u5EA6\u8A66\u3057\u3066\u304F\u3060\u3055\u3044\uFF09";
+export declare const SEND_NOW_BLOCKED_BY_DRAFT = "Mac \u5074\u306E\u5165\u529B\u6B04\u306B\u5165\u529B\u4E2D\u306E\u6587\u5B57\u304C\u3042\u308B\u305F\u3081\u300C\u4ECA\u3059\u3050\u9001\u4FE1\u300D\u3057\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u305D\u306E\u6587\u5B57\u3054\u3068\u9001\u4FE1\u3055\u308C\u308B\u306E\u3092\u9632\u3050\u305F\u3081\uFF09";
+export declare const SEND_NOW_BLOCKED_BY_UNREADABLE = "\u753B\u9762\u3092\u78BA\u8A8D\u3067\u304D\u306A\u304B\u3063\u305F\u305F\u3081\u300C\u4ECA\u3059\u3050\u9001\u4FE1\u300D\u3057\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u5C11\u3057\u5F85\u3063\u3066\u3082\u3046\u4E00\u5EA6\u8A66\u3057\u3066\u304F\u3060\u3055\u3044\uFF09";
+export declare const SEND_NOW_BLOCKED_BY_REBOUND = "Claude Code \u306E\u30AD\u30FC\u5272\u308A\u5F53\u3066\u304C\u5909\u66F4\u3055\u308C\u3066\u3044\u308B\u305F\u3081\u300C\u4ECA\u3059\u3050\u9001\u4FE1\u300D\u3067\u304D\u307E\u305B\u3093\uFF08chat:sendNow \u3092\u65E2\u5B9A\u306B\u623B\u3057\u3066\u304F\u3060\u3055\u3044\uFF09";
+export declare const SEND_NOW_UNCONFIRMED = "\u300C\u4ECA\u3059\u3050\u9001\u4FE1\u300D\u3092\u9001\u308A\u307E\u3057\u305F\u304C\u3001\u5C4A\u3044\u305F\u3053\u3068\u3092\u78BA\u8A8D\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F";
+export declare const SEND_NOW_EXPIRED_IN_QUEUE = "\u5148\u306B\u9001\u3063\u305F\u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u51E6\u7406\u306B\u6642\u9593\u304C\u304B\u304B\u3063\u305F\u305F\u3081\u300C\u4ECA\u3059\u3050\u9001\u4FE1\u300D\u3057\u307E\u305B\u3093\u3067\u3057\u305F\uFF08\u3082\u3046\u4E00\u5EA6\u8A66\u3057\u3066\u304F\u3060\u3055\u3044\uFF09";
+/**
+ * chord 後にヒント行の消滅を確かめる間隔と回数の既定（合計 約 6s）。短い発話は 0.7s 以内に消えるが、
+ * 貼り付け扱いの長文（約 800 字超）は 4.5s かかった（実測 2.1.283）。届いているのに `failed` を
+ * 返すと、利用者は届いた発話をもう一度流そうとする。
+ */
+export declare const SEND_NOW_POLL_MS = 300;
+export declare const SEND_NOW_MAX_POLLS = 20;
+/** 判別できないフレーム（描画の途中）を撮り直す回数。chord を送る前だけ（合計 約 1.5s）。 */
+export declare const SEND_NOW_SETTLE_POLLS = 5;
+/**
+ * CLI のキューに溜まっている発話を今すぐ届ける（tmux / herdr 共通, chat-send-now）。
+ * CLI の `chat:sendNow` を 1 回送り、ヒント行が消えたことを確かめる。
+ *
+ * 実測 2.1.283:
+ * - ツールの実行中: ツールが背景へ回り、発話は同じターンへ届く（`queued_command`）。
+ * - 応答の生成中 / `/` で始まる発話（添付のパス）: そのターンを打ち切り、発話は新しいターンで届く。
+ * - キューが空 / アイドル: 何も起きない。
+ * - **入力欄に文字がある: その文字ごと送信される**。Mac 側の下書きを勝手に送らないよう、
+ *   入力欄が空と確かめられたフレームでだけ送る（fail-closed）。
+ */
+export declare function sendQueuedNow(io: {
+    capture: () => Promise<string | null>;
+    sendChord: () => Promise<void>;
+    pollMs: number;
+    maxPolls: number;
+    /** 判別できないフレームを撮り直す回数（既定 `SEND_NOW_SETTLE_POLLS`）。 */
+    settlePolls?: number;
+}): Promise<SendQueuedNowOutcome>;
 /**
  * 画面最下部に composer のボトムバーが出ているか＝「いま見ているのは入力欄であって
  * ダイアログではない」か（TESTABLE。text / ANSI どちらのキャプチャでも使える）。
@@ -303,6 +658,16 @@ export declare class TmuxSessionManager {
     private readonly submitDelayMs;
     /** Enter → 送信成立確認 の間隔 ms（テスト注入用）。 */
     private readonly submitVerifyDelayMs;
+    /** 選択ダイアログを Esc で閉じた後の消滅確認の間隔 ms（テスト注入用）。 */
+    private readonly choiceCancelPollMs;
+    /** 「今すぐ送信」の chord 後、ヒント行の消滅確認の間隔 ms（テスト注入用）。 */
+    private readonly sendNowPollMs;
+    /** 貼り付けた本文が入力欄に入るのを確かめる間隔と上限 ms（テスト注入用）。 */
+    private readonly pastedTextPollMs;
+    private readonly pastedTextTimeoutMs;
+    private readonly clearSettleMs;
+    /** 貼り付けバッファ名の通番。 */
+    private pasteSequence;
     constructor(options?: {
         runner?: TmuxCommandRunner;
         store?: SessionMetadataStore;
@@ -316,6 +681,12 @@ export declare class TmuxSessionManager {
         clearKeyDelayMs?: number;
         submitDelayMs?: number;
         submitVerifyDelayMs?: number;
+        choiceCancelPollMs?: number;
+        sendNowPollMs?: number;
+        pastedTextPollMs?: number;
+        pastedTextTimeoutMs?: number;
+        /** C-u をまとめて打った後、入力欄が変わるのを待つ上限（テスト用に短くできる）。 */
+        clearSettleMs?: number;
     });
     /**
      * 現存する各セッションを name/cwd/alive で列挙する（name 昇順、メタのみは alive:false）。
@@ -340,6 +711,20 @@ export declare class TmuxSessionManager {
      * literal 送出 → 150ms（Ink 再描画待ち）→ Enter。
      */
     sendTextSubmit(name: string, text: string, options?: SendTextSubmitOptions): Promise<void>;
+    /**
+     * 小分けにした本文を、1 つずつ括弧付き貼り付けとして pane へ渡す（long-text-paste）。
+     * 本文は標準入力から tmux の貼り付けバッファへ載せる（`load-buffer -`）。引数で渡すと、tmux は
+     * 末尾の `;` をコマンドの区切りとして落とし、約 16KB を超えると `command too long` で失敗する
+     * （実測 tmux 3.7）。`paste-buffer -p` で括弧を付け、`-r` で改行を LF のまま渡す（`-r` が無いと
+     * LF を CR に置き換える）。`-d` で貼った後にバッファを消す。バッファ名は呼び出しごとに変える
+     * （並行する注入と取り違えない）。
+     */
+    private pasteBracketed;
+    /**
+     * CLI のキューに溜まっている発話を今すぐ届ける（chat-send-now, SessionBackend 共通面）。
+     * `C-x C-s` は 1 回の send-keys で続けて送る（chord を分断しない）。
+     */
+    sendQueuedNow(name: string): Promise<SendQueuedNowOutcome>;
     /**
      * 入力済みの本文を Enter で送信し、成立を確認するまで上限つきで Enter を撃ち直す
      * （herdr 側 `sendTextSubmit` の送信確定ループと同型）。