tailii-host 0.5.0 → 0.7.0

package/dist/backend/tmux.js

@@ -92,6 +92,20 @@ export function extractClaudeInputBox(screen) {
     }
     return null;
 }
+/**
+ * claude TUI の入力欄（composer）が描画済みか（起動中の pane との区別, boot-gate）。
+ *
+ * claude プロセスは起動していても、TUI が入力欄を描くまでには（host 負荷次第で）数秒〜
+ * 10 秒超の窓がある。その間の画面は初期シェルのプロンプト／`exec zsh -lc …` のエコー／
+ * 起動バナー（`╭…╮` の角付き枠）だけで、入力欄の罫線（`─` の連続行）は 1 本も無い。
+ * 罫線が 1 本でも見えれば TUI は描画済み（composer は本文の罫線と同じフレームで描かれ、
+ * スクロールで上側の罫線が窓外に出ても下側は残る）。`❯` だけの画面はシェルプロンプトの
+ * 可能性があるため描画済みとみなさない（`extractClaudeInputBox` の ❯ フォールバックは
+ * 描画済み前提の判定にだけ使う）。
+ */
+export function claudeInputBoxRendered(screen) {
+    return screen.split("\n").some((line) => isInputBoxRuleLine(stripSgr(line).trim()));
+}
 /**
  * 入力が空のとき claude TUI が入力欄へ薄字で出すプレースホルダ（実測 2.1.220）。
  * 未送信テキストと誤認すると、シェルモード離脱（空入力の Backspace）に入れず
@@ -108,6 +122,418 @@ function isInputPlaceholder(text) {
         return true;
     return text.startsWith("Message @") && text.endsWith("…");
 }
+/** SGR カラー/属性エスケープ（`ESC[…m`）を除いた素のテキスト。 */
+function stripSgr(line) {
+    // eslint-disable-next-line no-control-regex
+    return line.replace(/\u001b\[[0-9;]*m/g, "");
+}
+/**
+ * claude TUI の「プロンプト提案」（2.1.25x 頃〜。空の入力欄に薄字で次の一手を提示し、
+ * → / Tab で採用、Enter で即送信される）と空入力プレースホルダーは、いずれも通常の
+ * 未送信テキストと**同じ入力欄位置**に描画される。`--format text`（SGR 除去済み）では
+ * 本文と区別できないため、注入の残留 flush 判定・送信確定ループがこれらを実テキストと
+ * 誤認し、Enter で提案をそのまま送信してしまう（実障害 2026-09-03: iPhone 送信のたびに
+ * AI の提案文が勝手に送られ、送信が壊れる）。
+ *
+ * 決定的シグナル: 提案もプレースホルダーも本文が SGR 2（faint/薄字）で描画される。
+ * 利用者入力・中断時の queued 書き戻しは faint ではない（実測 herdr `pane read --format
+ * ansi` 2026-09-03: 提案は 本文が ESC[2m 包み、実テキストは faint 無し）。
+ *
+ * ANSI 画面から入力欄本文を切り出し、本文の可視文字がすべて faint なら「実テキスト無し」
+ * とみなす（＝提案/プレースホルダー）。faint でない可視文字が 1 つでもあれば実テキスト有り。
+ * 判定不能（罫線が見つからない・本文空）は false。
+ */
+export function inputBoxHasRealPendingText(ansiScreen) {
+    const analysis = analyzeInputBox(ansiScreen);
+    return analysis !== null && analysis.text.length > 0 && !analysis.faintOnly;
+}
+/**
+ * 入力欄の「実テキスト」（薄字プロンプト提案・プレースホルダーを除いた未送信本文）を返す。
+ * `null` = 入力欄が見つからない（罫線が窓外・描画崩れ）、`""` = 空 or 提案/プレースホルダー、
+ * それ以外 = 実テキスト。text capture の box.text を使う判定（clearInputBox の空判定・
+ * inputBoxContainsText の probe 照合）が提案を実テキストと誤認するのを塞ぐため、ANSI から
+ * faint を見て実テキストだけを取り出す（prompt-suggestion-chip）。
+ */
+export function inputBoxRealText(ansiScreen) {
+    const analysis = analyzeInputBox(ansiScreen);
+    if (analysis === null)
+        return null;
+    return analysis.faintOnly ? "" : analysis.text;
+}
+/**
+ * 入力欄の残存テキストが、transcript に記録済みの発話本文と同文か（restored-prompt-discard）。
+ *
+ * 入力欄の描画は折り返し（trim + 改行連結）・composer スクロールで先頭行が窓外に出る・シェルモード
+ * 記号 `!` の吸い上げがあるため、生の等値比較は使えない。空白類を両辺から除去し、先頭の `!` を
+ * 落としたうえで「同一」または「残存が記録本文の末尾（可視領域は常に末尾側）」なら同文とみなす。
+ * 末尾一致は短い断片の偶然一致（Mac 側で打ちかけた下書きが記録本文の語尾と重なる等）を避けるため
+ * 24 字以上に限る（typedTextProbe と同じ長さ）。
+ */
+export function inputBoxTextMatchesRecordedPrompt(boxText, recordedPrompt) {
+    const normalize = (value) => value.replace(/\s+/g, "").replace(/^!/, "");
+    const pending = normalize(boxText);
+    const recorded = normalize(recordedPrompt);
+    if (pending.length === 0 || recorded.length === 0)
+        return false;
+    if (pending === recorded)
+        return true;
+    return pending.length >= 24 && recorded.endsWith(pending);
+}
+/**
+ * claude TUI のプロンプト提案文を取り出す（提案チップ表示用）。
+ * 入力欄本文が薄字(faint)のみ かつ 既知プレースホルダーでない非空テキストのときだけ、その
+ * 本文を返す（＝提案）。空・実テキスト（利用者入力/中断書き戻し）・プレースホルダーは null。
+ * inputBoxHasRealPendingText と同じ解析(analyzeInputBox)を共有し、判定を一貫させる。
+ */
+export function extractInputBoxSuggestion(ansiScreen) {
+    const analysis = analyzeInputBox(ansiScreen);
+    if (analysis === null || analysis.text.length === 0)
+        return null;
+    return analysis.faintOnly ? analysis.text : null;
+}
+/**
+ * ANSI 画面から入力欄本文の可視テキスト（既知プレースホルダーは "" へ、extractClaudeInputBox
+ * 準拠）と「本文がすべて薄字(faint)か」を返す。罫線ペア or 末尾 `❯` 行で領域を特定する
+ * （extractClaudeInputBox と同型）。入力欄が見つからなければ null。
+ */
+function analyzeInputBox(ansiScreen) {
+    const rawLines = ansiScreen.split("\n").map((line) => line.replace(/\r$/, ""));
+    const stripped = rawLines.map((line) => stripSgr(line).trim());
+    // 罫線ペアで入力欄領域を特定する（extractClaudeInputBox と同じ規則を SGR 除去後の行へ）。
+    let bottom = -1;
+    for (let index = stripped.length - 1; index >= 0; index -= 1) {
+        if (isInputBoxRuleLine(stripped[index] ?? "")) {
+            bottom = index;
+            break;
+        }
+    }
+    let top = -1;
+    for (let index = bottom - 1; index >= 0; index -= 1) {
+        if (isInputBoxRuleLine(stripped[index] ?? "")) {
+            top = index;
+            break;
+        }
+    }
+    let bodyRaw;
+    if (top >= 0 && bottom > top) {
+        bodyRaw = rawLines.slice(top + 1, bottom);
+    }
+    else {
+        // 罫線が無い画面は最後の `❯` 行 1 行だけを入力欄とみなす（extractClaudeInputBox と同型）。
+        let sigilIndex = -1;
+        for (let index = stripped.length - 1; index >= 0; index -= 1) {
+            if ((stripped[index] ?? "").startsWith("❯")) {
+                sigilIndex = index;
+                break;
+            }
+        }
+        if (sigilIndex < 0)
+            return null;
+        bodyRaw = [rawLines[sigilIndex] ?? ""];
+    }
+    // プレースホルダー（文言一致）は "" 扱い（extractClaudeInputBox が担保・後方互換）。
+    const box = extractClaudeInputBox(stripped.join("\n"));
+    if (box === null)
+        return null;
+    return { text: box.text, faintOnly: bodyIsFaintOnly(bodyRaw) };
+}
+/**
+ * 入力欄本文（ANSI 付き raw 行）の可視文字がすべて faint（SGR 2）か。
+ * SGR 状態を文字送りで追い（0 = 全リセット / 2 = faint on / 22 = faint off）、
+ * 空白・モード記号（`❯ › !`）以外の可視文字だけを評価する。可視文字が 1 つも無ければ false。
+ */
+function bodyIsFaintOnly(bodyRaw) {
+    const ESC = "\u001b";
+    const NBSP = " ";
+    let faint = false;
+    let sawPrintable = false;
+    let allFaint = true;
+    for (const line of bodyRaw) {
+        let index = 0;
+        while (index < line.length) {
+            if (line[index] === ESC && line[index + 1] === "[") {
+                // eslint-disable-next-line no-control-regex
+                const match = /^\u001b\[([0-9;]*)m/.exec(line.slice(index));
+                if (match) {
+                    const params = match[1] ?? "";
+                    const codes = params === "" ? [0] : params.split(";").map((code) => Number(code));
+                    // SGR を左から評価する。38/48（前景/背景色）は 2;r;g;b または 5;n の
+                    // サブパラメータを従えるため、その分を読み飛ばす（`38;2;255;255;255` の `2` を
+                    // faint(SGR 2) と誤認しない — この取り違えが色付き実テキストの誤判定原因だった）。
+                    for (let cursor = 0; cursor < codes.length; cursor += 1) {
+                        const code = codes[cursor];
+                        if (code === 38 || code === 48) {
+                            const mode = codes[cursor + 1];
+                            cursor += mode === 2 ? 4 : mode === 5 ? 2 : 1;
+                            continue;
+                        }
+                        if (code === 0 || code === 22)
+                            faint = false;
+                        else if (code === 2)
+                            faint = true;
+                    }
+                    index += match[0].length;
+                    continue;
+                }
+            }
+            const ch = line[index] ?? "";
+            // 空白・NBSP・モード記号は本文の可視性判定から除外する（記号の色は faint とは限らない）。
+            if (ch !== " " &&
+                ch !== NBSP &&
+                ch !== "\t" &&
+                ch !== "❯" &&
+                ch !== "›" &&
+                ch !== "!") {
+                sawPrintable = true;
+                if (!faint)
+                    allFaint = false;
+            }
+            index += 1;
+        }
+    }
+    return sawPrintable && allFaint;
+}
+/**
+ * `/login` の OAuth コード入力待ち行（実測 claude 2.1.241: `Paste code here if prompted >`）。
+ * ブラウザで取得したコードを貼る唯一の入力面で、通常の入力欄（罫線ペア）は描画されない。
+ */
+export const LOGIN_CODE_PROMPT_MARKER = "Paste code here if prompted";
+/**
+ * `/login` でコード送信が失敗した後の再試行待ち行（実測 2.1.241:
+ * `OAuth error: Request failed with status code 400` の下に `Press Enter to retry.`）。
+ */
+export const LOGIN_RETRY_MARKER = "Press Enter to retry";
+/** `/login` 方式選択（`Select login method:`）のタイトル行（実測 2.1.241。フッターは `Esc to cancel` のみ）。 */
+export const LOGIN_METHOD_MARKER = "Select login method";
+/**
+ * 成功後の継続待ち画面（CLI 2.1.241 の文字列 `Login successful. Press Enter to continue…`。
+ * 入力欄は無く、Enter / Esc で閉じて通常の入力欄へ戻る）。
+ * 2026-08-25 実障害: この画面を知らず「交換中」として 10s 待って失敗を返し、利用者がキャンセル
+ * （Esc）すると閉じてログイン済みになる、という逆転が起きた。
+ */
+export const LOGIN_CONTINUE_MARKER = "to continue";
+/** ダイアログ行が pane 末尾（最後の非空行）からこの行数以内にあるときだけ「生きている」とみなす。 */
+const LOGIN_TAIL_WINDOW = 12;
+/**
+ * `marker` で始まる行が、生きたダイアログとして画面にあるか（TESTABLE 内部）。
+ * 会話本文が同じ文言を行頭に含むだけ（Ink の折り返し・/login の説明文）で発火しないよう、
+ * (a) 末尾 LOGIN_TAIL_WINDOW 行以内 (b) 直下 `footerReach` 行以内に `Esc to cancel` フッター、
+ * の 2 条件を課す（iOS 側 ClaudeLoginPromptParser.isLiveDialogLine と同じ規則）。
+ */
+function liveDialogLineIndex(lines, marker, footerReach) {
+    let lastContent = -1;
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        if ((lines[index] ?? "").trim().length > 0) {
+            lastContent = index;
+            break;
+        }
+    }
+    if (lastContent < 0)
+        return null;
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        if (!(lines[index] ?? "").trim().startsWith(marker))
+            continue;
+        if (lastContent - index > LOGIN_TAIL_WINDOW)
+            return null;
+        const end = Math.min(lines.length, index + 1 + footerReach);
+        for (let below = index + 1; below < end; below += 1) {
+            if ((lines[below] ?? "").trim().toLowerCase().startsWith("esc to cancel"))
+                return index;
+        }
+        return null;
+    }
+    return null;
+}
+/** 画面が `/login` のコード入力待ちか（TESTABLE）。chat 注入の門番と login_code_send の前提確認に使う。 */
+export function screenHasLoginCodePrompt(screen) {
+    return liveDialogLineIndex(screen.split("\n"), LOGIN_CODE_PROMPT_MARKER, 3) !== null;
+}
+function screenHasLoginRetry(screen) {
+    return liveDialogLineIndex(screen.split("\n"), LOGIN_RETRY_MARKER, 3) !== null;
+}
+function screenHasLoginMethodSelect(screen) {
+    // タイトル行と Esc フッターの間に選択肢（最大 3 行 + 空行）が入る。
+    return liveDialogLineIndex(screen.split("\n"), LOGIN_METHOD_MARKER, 8) !== null;
+}
+/** 成功後の継続待ち（`Login successful. Press Enter to continue…`）が pane 末尾付近にあるか。 */
+export function screenHasLoginContinue(screen) {
+    const lines = screen.split("\n");
+    let lastContent = -1;
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        if ((lines[index] ?? "").trim().length > 0) {
+            lastContent = index;
+            break;
+        }
+    }
+    if (lastContent < 0)
+        return false;
+    for (let index = lastContent; index >= Math.max(0, lastContent - LOGIN_TAIL_WINDOW); index -= 1) {
+        const text = (lines[index] ?? "").trim().toLowerCase();
+        if (text.includes("login successful") && text.includes(LOGIN_CONTINUE_MARKER))
+            return true;
+        if (text.startsWith("press enter to continue"))
+            return true;
+    }
+    return false;
+}
+/**
+ * 画面が `/login` フローのどこか（方式選択 / コード入力待ち / 失敗後の再試行待ち）にいるか（TESTABLE）。
+ * chat 注入の門番用。コード欄以外の 2 画面も、通常本文 + Enter が選択リストや retry を
+ * 押してしまうため同じく拒否する。
+ */
+export function screenInLoginFlow(screen) {
+    return screenHasLoginCodePrompt(screen) || screenHasLoginRetry(screen)
+        || screenHasLoginMethodSelect(screen) || screenHasLoginContinue(screen);
+}
+export function loginCodeScreenState(screen) {
+    if (screenHasLoginCodePrompt(screen))
+        return "prompt";
+    if (screenHasLoginRetry(screen))
+        return "retry";
+    if (screenHasLoginMethodSelect(screen))
+        return "method";
+    if (screenHasLoginContinue(screen))
+        return "continue";
+    const lines = screen.split("\n");
+    const tail = lines.slice(-LOGIN_TAIL_WINDOW - 8);
+    const rules = tail.filter((line) => isInputBoxRuleLine(line.trim())).length;
+    if (rules >= 2)
+        return "accepted";
+    return "pending";
+}
+/**
+ * retry 画面の理由行。`OAuth error` で始まる行（末尾窓内の最後のもの）だけを採用する。
+ * 直上行フォールバックは持たない（コードをエコーしたコード欄の行が理由として result / ログへ
+ * 漏れる）。念のためコード欄マーカーを含む行は採用しない。
+ */
+export function loginCodeErrorLine(screen) {
+    const lines = screen.split("\n").map((line) => line.trim());
+    const tail = lines.slice(-LOGIN_TAIL_WINDOW - 8);
+    for (let index = tail.length - 1; index >= 0; index -= 1) {
+        const text = tail[index] ?? "";
+        if (text.startsWith("OAuth error") && !text.includes(LOGIN_CODE_PROMPT_MARKER)) {
+            return text.slice(0, 200);
+        }
+    }
+    return null;
+}
+/**
+ * login-code 経路の失敗（利用者へそのまま出せる文言だけを message に持つ）。
+ * コード本文を含む生の backend エラー（tmux の args 等）を result / diag に流さないための型。
+ * chat 注入の門番（1 キーも送る前の確定拒否）にも使う — hub はこの型を「未送出の失敗」として
+ * uncertain（配送不明）に積まない。
+ */
+export class LoginCodeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LoginCodeError";
+    }
+}
+/** login_code_send が拒否するメッセージ（コード入力待ちでない）。 */
+export const LOGIN_CODE_PROMPT_NOT_VISIBLE = "Claude はログインコードの入力待ちではありません（/login を実行してから送ってください）";
+/** retry 画面で login_code_send されたときの案内。 */
+export const LOGIN_CODE_RETRY_PENDING = "Claude は再試行待ちです。「もう一度」を押してから、新しいコードを送ってください";
+/** chat 注入が `/login` フロー中の画面を検出したときの拒否文言（hub が会話本文へそのまま出す）。 */
+export const CHAT_BLOCKED_BY_LOGIN_PROMPT = "Claude が /login の途中です。転写カードから操作するか、キャンセルしてから送ってください";
+/** コード送出は届いたが、待ってもコード欄が消えない（CR 取りこぼし・TUI 停止）。 */
+export const LOGIN_CODE_NOT_ACCEPTED = "コードが Claude に受理されませんでした（もう一度送るか、Mac 側の画面を確認してください）";
+/** コード本文がコード欄に反映されなかった（send-text 取りこぼし）。CR は撃たない。 */
+export const LOGIN_CODE_NOT_ECHOED = "コードが入力欄に反映されませんでした（もう一度送ってください）";
+/** 交換が長引き、受理も拒否も確定しなかった。 */
+export const LOGIN_CODE_UNSETTLED = "ログインの結果を確認できませんでした（Mac 側の画面を確認してください）";
+/** login_code_send の失敗を利用者向け文言へ写す（コード本文・内部 args を漏らさない）。 */
+export function loginCodeErrorMessage(error) {
+    if (error instanceof LoginCodeError)
+        return error.message;
+    const name = error instanceof Error ? error.name : "Error";
+    return `コードの送出に失敗しました（${name}）`;
+}
+/** コード欄に本文が反映されたか（入力は末尾 6 文字以外マスク表示される実測に合わせ、末尾で照合）。 */
+export function loginCodeEchoed(screen, code) {
+    const lines = screen.split("\n");
+    const index = liveDialogLineIndex(lines, LOGIN_CODE_PROMPT_MARKER, 3);
+    if (index === null)
+        return false;
+    const probe = code.slice(-Math.min(6, code.length));
+    return (lines[index] ?? "").includes(probe);
+}
+/**
+ * `/login` のコードを送出し、結果を画面で確定させる（tmux / herdr 共通, TESTABLE）。
+ * - 送出前にコード欄が無ければ何も送らず throw（retry 画面は専用の案内）
+ * - 本文送出後、コード欄へのエコーを確認してから CR（反映していなければ CR を撃たず throw —
+ *   切り詰めたコードを送ってワンタイムコードを焼かない）
+ * - CR 後は `loginCodeScreenState` で待つ。retry / method は即 throw（余分な CR で retry を
+ *   押さない）。accepted（陽性証拠）で受理。prompt が settleMs 残れば **再キャプチャして prompt
+ *   のときだけ** CR を 1 回再送。pending は settleMs×2 まで待ち、確定しなければ throw。
+ *   暗黙の ok は返さない。
+ */
+export async function submitLoginCode(code, ops) {
+    const now = ops.now ?? (() => Date.now());
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    const initial = await ops.capture();
+    const initialState = initial === null ? "pending" : loginCodeScreenState(initial);
+    if (initialState === "retry")
+        throw new LoginCodeError(LOGIN_CODE_RETRY_PENDING);
+    if (initialState !== "prompt")
+        throw new LoginCodeError(LOGIN_CODE_PROMPT_NOT_VISIBLE);
+    await ops.sendLiteral(code);
+    await sleep(ops.delayMs);
+    let echoed = false;
+    for (let attempt = 0; attempt < 2 && !echoed; attempt += 1) {
+        if (attempt > 0)
+            await sleep(ops.pollMs);
+        const screen = await ops.capture();
+        echoed = screen !== null && loginCodeEchoed(screen, code);
+    }
+    if (!echoed)
+        throw new LoginCodeError(LOGIN_CODE_NOT_ECHOED);
+    const start = now();
+    const pendingDeadline = start + ops.settleMs * 2;
+    let entersSent = 0;
+    let continueEnters = 0;
+    let state = "prompt";
+    while (true) {
+        if (state === "prompt") {
+            if (entersSent >= 2)
+                throw new LoginCodeError(LOGIN_CODE_NOT_ACCEPTED);
+            await ops.sendEnter();
+            entersSent += 1;
+        }
+        else if (state === "continue") {
+            // ログインは完了している。継続待ちを Enter で閉じて入力欄へ戻す（最大 2 回）。閉じられなくても
+            // 失敗にはしない（iOS 側は成功画面を「続ける」カードとして転写できる）。
+            if (continueEnters >= 2)
+                return;
+            await ops.sendEnter();
+            continueEnters += 1;
+        }
+        const attemptDeadline = now() + ops.settleMs;
+        for (;;) {
+            await sleep(ops.pollMs);
+            const screen = await ops.capture();
+            state = screen === null ? "pending" : loginCodeScreenState(screen);
+            if (state === "retry") {
+                const reason = screen === null ? null : loginCodeErrorLine(screen);
+                throw new LoginCodeError(`コードが拒否されました${reason !== null ? `（${reason}）` : ""}。もう一度サインインしてください`);
+            }
+            if (state === "method") {
+                throw new LoginCodeError("ログインが中断され、方式選択に戻りました。/login をやり直してください");
+            }
+            if (state === "accepted")
+                return;
+            if (state === "continue")
+                break;
+            if (state === "prompt" && now() >= attemptDeadline)
+                break;
+            if (state === "pending" && now() >= pendingDeadline) {
+                // 継続待ちを閉じた後の描画遅延なら成功として扱う（継続画面を一度でも見ている）。
+                if (continueEnters > 0)
+                    return;
+                throw new LoginCodeError(LOGIN_CODE_UNSETTLED);
+            }
+        }
+    }
+}
 /** 入力欄の行群を「モード記号 + 本文」へ分解する。 */
 function splitInputPrompt(bodyLines) {
     const body = [...bodyLines];
@@ -159,12 +585,22 @@ export class TmuxSessionManager {
     runner;
     store;
     captureLines;
+    /** login-code 送出の待ち時間（テスト注入用）。 */
+    loginTiming;
     protocolVersion;
+    /** clearInputBox の C-u 1回ごとの反映待ち ms（herdr 側と同じ既定 150ms。テスト注入用）。 */
+    clearKeyDelayMs;
     constructor(options = {}) {
         this.runner = options.runner ?? processTmuxCommandRunner();
         this.store = options.store ?? new SessionMetadataStore();
         this.captureLines = options.captureLines ?? 50;
         this.protocolVersion = options.protocolVersion ?? PROTOCOL_V1;
+        this.clearKeyDelayMs = options.clearKeyDelayMs ?? 150;
+        this.loginTiming = {
+            delayMs: options.loginTiming?.delayMs ?? 150,
+            pollMs: options.loginTiming?.pollMs ?? 250,
+            settleMs: options.loginTiming?.settleMs ?? 5_000,
+        };
     }
     /**
      * 現存する各セッションを name/cwd/alive で列挙する（name 昇順、メタのみは alive:false）。
@@ -174,8 +610,14 @@ export class TmuxSessionManager {
      */
     async list() {
         const alive = await this.liveSessionNames();
+        const allMetas = this.store.all();
         // herdr backend のメタは HerdrSessionManager が列挙する（Composite で和を取る）。
-        const metas = this.store.all().filter((meta) => meta.backend !== "herdr");
+        const metas = allMetas.filter((meta) => meta.backend !== "herdr");
+        // herdr 担当の名前は tmux の生存集合からも外す。backend 切替前の同名 tmux セッションが
+        // 生き残っている間（reaper の idle 回収まで）、ここが backend:"tmux" を確定申告すると
+        // Composite の tmux 優先マージで正しい herdr 行（メタ = ルーティング権威）が消え、
+        // iOS の観測が tmux に固定される（cwd/会話 id も欠けて稼働中ピルの join からも落ちる）。
+        const herdrNames = new Set(allMetas.filter((meta) => meta.backend === "herdr").map((meta) => meta.name));
         const cwdByName = new Map();
         const claudeSessionIdByName = new Map();
         const providerSessionIdByName = new Map();
@@ -191,13 +633,16 @@ export class TmuxSessionManager {
             if (providerSessionId !== undefined)
                 providerSessionIdByName.set(meta.name, providerSessionId);
         }
-        const names = new Set(alive);
+        const names = new Set([...alive].filter((name) => !herdrNames.has(name)));
         for (const meta of metas)
             names.add(meta.name);
+        // backend は tmux も常に明示する。iOS は欄なしを「host 未申告」として既知の観測値を
+        // 保持するため、欄の省略を tmux の意味に使わない（session-backend）。
         const infos = [...names].map((name) => ({
             name,
             cwd: cwdByName.get(name) ?? "",
             alive: alive.has(name),
+            backend: "tmux",
             ...(claudeSessionIdByName.has(name) ? { claudeSessionId: claudeSessionIdByName.get(name) } : {}),
             ...(agentByName.has(name) ? { agent: agentByName.get(name) } : {}),
             ...(providerSessionIdByName.has(name)
@@ -238,7 +683,7 @@ export class TmuxSessionManager {
         }
         const cwd = this.store.get(name)?.cwd ?? "";
         const recent = await this.capturePane(name);
-        return { kind: "attached", info: { name, cwd, alive: true }, recentOutput: recent };
+        return { kind: "attached", info: { name, cwd, alive: true, backend: "tmux" }, recentOutput: recent };
     }
     /** pane 内のエージェント生存判定。tmux エラーや空出力は二重起動を避けて true に倒す。 */
     async agentProcessAlive(name) {
@@ -275,14 +720,37 @@ export class TmuxSessionManager {
      * 本文入力と送信確定を 1 操作で行う（chat 注入・kick 用, SessionBackend 共通面）。
      * literal 送出 → 150ms（Ink 再描画待ち）→ Enter。
      */
-    async sendTextSubmit(name, text) {
-        // 中断（停止）直後は claude が queued メッセージを入力欄へ書き戻す。残存したまま
-        // 注入すると今回の本文がその後ろへ連結され 1 メッセージになる（実機FB 2026-07-29）。
-        // 残存は先に Enter で独立メッセージとして送信し切ってから注入する。空入力への
-        // Enter は no-op なので誤検出は無害（herdr 側 sendTextSubmit と同じ防御）。
-        if (await this.inputBoxHasPendingText(name)) {
-            await this.sendKeys(name, ["Enter"]);
-            await new Promise((resolve) => setTimeout(resolve, 300));
+    async sendTextSubmit(name, text, options = {}) {
+        // 1 回の capture で「/login フロー中か」と「残存テキスト」を判定する（chat 毎の capture を増やさない）。
+        const screen = await this.captureVisibleScreenOrNull(name);
+        // `/login` フロー中（方式選択 / コード入力待ち / retry）は通常の入力欄が無く、注入した本文が
+        // 選択リストやコード欄へ入る。明示エラーで chat_send を失敗させる（コードは login_code_send、
+        // 再試行/中断は pane_key_send の専用経路）。
+        if (screen !== null && screenInLoginFlow(screen)) {
+            throw new LoginCodeError(CHAT_BLOCKED_BY_LOGIN_PROMPT);
+        }
+        // 中断（停止）直後の入力欄に残存テキストがあるまま注入すると、今回の本文がその後ろへ連結され
+        // 1 メッセージになる（実機FB 2026-07-29）。残存の身元で扱いを分ける（herdr 側と同じ規則）:
+        // - transcript の直近の発話と同文 = 出力前の中断で claude が書き戻した「配送済みの発話」
+        //   → 破棄（C-u）。Enter で送り直すと同じ発話が二重に届く（実機 2026-09-08）。
+        // - それ以外（旧版の queued 書き戻し / Mac 側の下書き）→ 従来どおり Enter で独立送信し切る。
+        // 判定は ANSI で行い、薄字（faint）のプロンプト提案/プレースホルダーを実テキストと
+        // 数えない（実障害 2026-09-03: 提案を残留と誤認し Enter で勝手に送信していた）。
+        const ansiScreen = await this.captureVisibleScreenAnsiOrNull(name);
+        const pending = ansiScreen !== null && inputBoxHasRealPendingText(ansiScreen)
+            ? (inputBoxRealText(ansiScreen) ?? "")
+            : "";
+        if (pending.length > 0) {
+            const recorded = options.recordedPromptText?.() ?? null;
+            if (recorded !== null && inputBoxTextMatchesRecordedPrompt(pending, recorded)) {
+                if (!(await this.clearInputBox(name))) {
+                    throw new TmuxFailedError(["send-keys", "-t", this.paneTarget(name), "C-u"], 1, "restored prompt could not be cleared from the input box (中断で書き戻された発話が残存)");
+                }
+            }
+            else {
+                await this.sendKeys(name, ["Enter"]);
+                await new Promise((resolve) => setTimeout(resolve, 300));
+            }
         }
         // 入力欄がシェルモード（プロンプト `!`）のまま残っていると、注入した通常メッセージが
         // そのままシェルコマンドとして実行される。空入力の Backspace（tmux キー名は BSpace）で
@@ -293,6 +761,31 @@ export class TmuxSessionManager {
         await new Promise((resolve) => setTimeout(resolve, 150));
         await this.sendKeys(name, ["Enter"]);
     }
+    /**
+     * `/login` の OAuth コードを入力欄へ渡して確定する（login_code_send）。
+     * コード入力待ちの画面でなければ何も送らず throw する（誤って通常入力欄へ
+     * コードが本文として送信されるのを防ぐ）。literal 送出 → 150ms → Enter は
+     * sendTextSubmit と同じ Ink の取り込み間隔。
+     */
+    async sendLoginCode(name, code) {
+        await submitLoginCode(code, {
+            capture: () => this.captureVisibleScreenOrNull(name),
+            sendLiteral: (text) => this.sendKeys(name, [text], true),
+            sendEnter: () => this.sendKeys(name, ["Enter"]),
+            delayMs: this.loginTiming.delayMs,
+            pollMs: this.loginTiming.pollMs,
+            settleMs: this.loginTiming.settleMs,
+        });
+    }
+    /** 画面キャプチャ（判定不能=capture 失敗は null）。 */
+    async captureVisibleScreenOrNull(name) {
+        try {
+            return await this.captureVisibleScreen(name);
+        }
+        catch {
+            return null;
+        }
+    }
     /**
      * 入力欄がシェルモードなら BSpace で通常入力へ戻す。判定不能・tmux エラーは no-op
      * （fail-open。この補助操作のエラーを表に出すと「送信できない」原因が BSpace 送出の
@@ -312,11 +805,28 @@ export class TmuxSessionManager {
             // no-op（fail-open）
         }
     }
-    /** 入力欄に未送信テキストが残っているか。判定不能は false。 */
-    async inputBoxHasPendingText(name) {
+    /**
+     * 入力欄を空にする（中断で書き戻された配送済み発話の破棄用, restored-prompt-discard）。
+     * C-u(kill-line) を繰り返す（herdr 側 clearInputBox と同じ規則: 多行本文は末尾行→改行の順に
+     * 消え 2N-1 回で必ず空になる。Backspace は本文の実文字を削るため使わない）。空にできたら true。
+     * 入力欄が見えない / 上限回数で空にならない / capture 失敗は false（呼び出し側は注入を諦めて
+     * 明示再送へ倒す。残存の上へ重ね打ちして連結送信するよりよい）。
+     */
+    async clearInputBox(name) {
         try {
-            const box = extractClaudeInputBox(await this.captureVisibleScreen(name));
-            return box !== null && box.text.length > 0;
+            for (let attempt = 0; attempt < 15; attempt += 1) {
+                const ansiScreen = await this.captureVisibleScreenAnsiOrNull(name);
+                const realText = ansiScreen === null ? null : inputBoxRealText(ansiScreen);
+                if (realText === null)
+                    return false;
+                if (realText.replace(/\s+/g, "").length === 0)
+                    return true;
+                await this.sendKeys(name, ["C-u"]);
+                await new Promise((resolve) => setTimeout(resolve, this.clearKeyDelayMs));
+            }
+            const ansiScreen = await this.captureVisibleScreenAnsiOrNull(name);
+            const realText = ansiScreen === null ? null : inputBoxRealText(ansiScreen);
+            return realText !== null && realText.replace(/\s+/g, "").length === 0;
         }
         catch {
             return false;
@@ -343,14 +853,53 @@ export class TmuxSessionManager {
         }
         return lines.join("\n");
     }
+    /**
+     * viewport 全体を ANSI エスケープ付き（`capture-pane -e`）で取る。faint（SGR 2）属性で
+     * プロンプト提案/プレースホルダーを実テキストと見分けるのに使う（inputBoxHasRealPendingText）。
+     * 判定不能=capture 失敗は null（fail-open）。
+     */
+    async captureVisibleScreenAnsiOrNull(name) {
+        // 判定不能は fail-open で null（残留 flush 判定を止めない）。exitCode≠0 だけでなく
+        // runner の reject（spawn 失敗など）も握る（text 側 captureVisibleScreenOrNull と同じ約束）。
+        try {
+            const args = ["capture-pane", "-p", "-e", "-t", this.paneTarget(name)];
+            const result = await this.runner(args);
+            if (result.exitCode !== 0)
+                return null;
+            const lines = result.stdout.split("\n");
+            while (lines.length > 0 && (lines[lines.length - 1] ?? "").trim() === "") {
+                lines.pop();
+            }
+            return lines.join("\n");
+        }
+        catch {
+            return null;
+        }
+    }
+    /** SessionBackend: プロンプト提案抽出用の viewport ANSI キャプチャ（失敗は throw）。 */
+    async captureVisibleAnsi(name) {
+        validateSessionName(name);
+        const args = ["capture-pane", "-p", "-e", "-t", this.paneTarget(name)];
+        const result = await this.runner(args);
+        if (result.exitCode !== 0) {
+            throw new TmuxFailedError(args, result.exitCode, result.stderr);
+        }
+        const lines = result.stdout.split("\n");
+        while (lines.length > 0 && (lines[lines.length - 1] ?? "").trim() === "") {
+            lines.pop();
+        }
+        return lines.join("\n");
+    }
     /** 指定セッションの pane へ tmux send-keys を発行する（literal は -l）。 */
     async sendKeys(name, keys, literal = false) {
         validateSessionName(name);
         if (keys.length === 0)
             return;
         const args = ["send-keys", "-t", this.paneTarget(name)];
+        // literal は `--` で引数終端を明示する（先頭が `-` の本文 — base64url の OAuth コード等 —
+        // を tmux がフラグと誤認して `unknown flag` で失敗する）。
         if (literal)
-            args.push("-l");
+            args.push("-l", "--");
         args.push(...keys);
         const result = await this.runner(args);
         if (result.exitCode !== 0) {