tailii-host 0.1.1 → 0.4.0

package/dist/hub/panePreviewPump.js

@@ -0,0 +1,187 @@
+// panePreviewPump.ts
+// tailii (TS host) — foreground tmux pane のライブプレビュー配信。
+import { parsePermissionMode } from "../shared/permissionMode.js";
+import { PROTOCOL_V2 } from "../protocol.js";
+import { abortableSleep } from "../shared/sleep.js";
+/** tmux pane の画面内容が変化したときだけ pane_preview を流す。 */
+export class PanePreviewPump {
+    writer;
+    capture;
+    pollIntervalMs;
+    quietThresholdMs;
+    protocolVersion;
+    abortController = null;
+    task = null;
+    seq = 0;
+    lastText = null;
+    lastChangeAt = 0;
+    lastEmitAt = 0;
+    pendingText = null;
+    hasEmitted = false;
+    active = false;
+    inactiveSent = false;
+    session = null;
+    mode = "claude_status";
+    onPermissionMode;
+    log;
+    lastPermissionMode = null;
+    lastEmittedDialog = false;
+    emitInitial = false;
+    static minEmitIntervalMs = 500;
+    constructor(options) {
+        this.writer = options.writer;
+        this.capture = options.capture;
+        const pollIntervalMs = options.pollIntervalMs ?? 250;
+        this.pollIntervalMs = typeof pollIntervalMs === "function" ? pollIntervalMs : () => pollIntervalMs;
+        this.quietThresholdMs = options.quietThresholdMs ?? 2500;
+        this.protocolVersion = options.protocolVersion ?? (() => PROTOCOL_V2);
+        this.onPermissionMode = options.onPermissionMode ?? null;
+        this.log = options.log ?? null;
+    }
+    /**
+     * 対象セッションの preview を開始/切替する。同一セッションの二重 start は無視する。
+     * emitInitial=true は初回 capture も active フレームとして送る（処理中会話を一覧 watch で
+     * 開いた直後、pane が静止していてもカードを空にしないため）。
+     */
+    start(session, mode = "claude_status", opts) {
+        if (this.session === session && this.mode === mode && this.task !== null)
+            return;
+        this.stop();
+        this.session = session;
+        this.mode = mode;
+        this.emitInitial = opts?.emitInitial ?? false;
+        this.lastPermissionMode = null;
+        this.lastText = null;
+        this.lastChangeAt = 0;
+        this.lastEmitAt = 0;
+        this.pendingText = null;
+        this.hasEmitted = false;
+        this.active = false;
+        this.inactiveSent = false;
+        const ac = new AbortController();
+        this.abortController = ac;
+        this.task = this.run(session, mode, ac.signal);
+        this.task.catch(() => { });
+    }
+    /** preview を停止する。active 中なら UI 側の表示を消すため inactive を一度だけ流す。 */
+    stop() {
+        this.abortController?.abort();
+        this.abortController = null;
+        this.task = null;
+        if (this.session !== null && this.active && !this.inactiveSent) {
+            this.emit(this.session, false, "");
+        }
+        this.session = null;
+        this.mode = "claude_status";
+        this.emitInitial = false;
+        this.lastPermissionMode = null;
+        this.lastText = null;
+        this.lastChangeAt = 0;
+        this.lastEmitAt = 0;
+        this.pendingText = null;
+        this.hasEmitted = false;
+        this.active = false;
+        this.inactiveSent = false;
+    }
+    async run(session, mode, signal) {
+        // pane 消滅（reaper kill 等）後も購読が残る間はポーリングが失敗し続けるため、
+        // 連続失敗は初回と約1分ごとだけログする（250ms 間隔の連打でログを埋めない）。
+        let consecutiveFailures = 0;
+        while (!signal.aborted) {
+            let text = null;
+            try {
+                text = await this.capture(session);
+                consecutiveFailures = 0;
+            }
+            catch (error) {
+                consecutiveFailures += 1;
+                if (consecutiveFailures === 1 || consecutiveFailures % 240 === 0) {
+                    process.stderr.write(`[tailii-host engine] pane_preview capture 失敗` +
+                        (consecutiveFailures > 1 ? `（連続${consecutiveFailures}回目）` : "") +
+                        `: ${String(error)}\n`);
+                }
+            }
+            if (text !== null && mode === "claude_status" && this.onPermissionMode !== null) {
+                // ダイアログ表示中は null（判定不能）になるため、直前の確定値を保持して揺れを抑える。
+                const permissionMode = parsePermissionMode(text);
+                if (permissionMode !== null && permissionMode !== this.lastPermissionMode) {
+                    this.lastPermissionMode = permissionMode;
+                    this.onPermissionMode(permissionMode);
+                }
+            }
+            const now = Date.now();
+            if (text !== null && text !== this.lastText) {
+                if (this.lastText === null) {
+                    this.lastText = text;
+                    // Claude は従来どおり初回を基準フレームとして黙って保持する。
+                    // Codex は接続時点ですでに turn が進行中の場合があるため、初回 capture も送り、
+                    // iOS 側で現在の処理中ステータスだけを抽出する。
+                    // emitInitial 指定時（処理中会話の watch 開始）は Claude も初回から送る。
+                    if ((mode === "codex_terminal" || this.emitInitial) && text.trim().length > 0) {
+                        this.lastChangeAt = now;
+                        this.inactiveSent = false;
+                        this.queueActive(session, text, now, mode);
+                    }
+                }
+                else {
+                    this.lastText = text;
+                    this.lastChangeAt = now;
+                    this.inactiveSent = false;
+                    this.queueActive(session, text, now, mode);
+                }
+            }
+            if (this.pendingText !== null &&
+                now - this.lastEmitAt >= PanePreviewPump.minEmitIntervalMs) {
+                this.emitActive(session, this.pendingText, now, mode);
+            }
+            else if (mode !== "codex_terminal" &&
+                this.active &&
+                !this.inactiveSent &&
+                this.hasEmitted &&
+                this.lastChangeAt > 0 &&
+                now - this.lastChangeAt >= this.quietThresholdMs) {
+                this.emit(session, false, "");
+                this.inactiveSent = true;
+                this.active = false;
+            }
+            await abortableSleep(this.pollIntervalMs(), signal);
+        }
+    }
+    queueActive(session, text, now, mode) {
+        if (!this.hasEmitted || now - this.lastEmitAt >= PanePreviewPump.minEmitIntervalMs) {
+            this.emitActive(session, text, now, mode);
+            return;
+        }
+        this.pendingText = text;
+    }
+    emitActive(session, text, now, mode) {
+        this.pendingText = null;
+        this.lastEmitAt = now;
+        this.active = true;
+        this.inactiveSent = false;
+        // 選択ダイアログ（転写カード対象）のフレームが実際に流れたかを追える遷移ログ。
+        const dialogFrame = text.includes("Enter to select");
+        if (dialogFrame !== this.lastEmittedDialog) {
+            this.lastEmittedDialog = dialogFrame;
+            this.log?.(`pane_preview dialog-frame ${dialogFrame ? "開始" : "終了"} session=${session} bytes=${Buffer.byteLength(text, "utf8")}`);
+        }
+        this.emit(session, true, text, mode);
+    }
+    emit(session, active, text, mode = this.mode) {
+        const v = this.protocolVersion();
+        if (v < PROTOCOL_V2)
+            return;
+        this.seq += 1;
+        this.hasEmitted = true;
+        this.writer.write({
+            type: "pane_preview",
+            v,
+            session,
+            seq: this.seq,
+            active,
+            text,
+            ...(mode === "codex_terminal" ? { mode } : {}),
+        });
+    }
+}
+//# sourceMappingURL=panePreviewPump.js.map

package/dist/hub/panePreviewPump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panePreviewPump.js","sourceRoot":"","sources":["../../src/hub/panePreviewPump.ts"],"names":[],"mappings":"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"}

package/dist/hub/questionInjection.d.ts

@@ -0,0 +1,19 @@
+import type { QuestionAnswer } from "../protocol.js";
+import type { SessionBackend } from "../backend/sessionBackend.js";
+/**
+ * AskUserQuestion ダイアログのフレームか。`Enter to select` は /remote-control 等の
+ * ❯ メニューにも出るため、設問 TUI 固有の要素（質問タブ・回答レビュー・notes 等）との
+ * AND で判定する（承認ダイアログは Enter to select を含まないので対象外）。
+ */
+export declare function isQuestionDialogFrame(text: string): boolean;
+/**
+ * question_answer → Claude AskUserQuestion TUI のキー操作。
+ * 各キー間の待機は、Ink の再描画中に連続入力が欠落するのを避けるために設ける。
+ * - 単一選択 = 数字キーで即確定。Other は行番号 → literal 入力 → Enter。
+ * - multiSelect = 数字キーは無反応。カーソル（先頭 index 0 から開始）を ↓ で対象行へ移動し
+ *   Space でトグル → Right でレビュー → 最終問後に「1」Submit answers。
+ *   Other 行は Space でチェック＆入力欄化 → literal 入力 → ↑ でテキスト欄を抜けてから Right。
+ * - Other の synthetic index（= options.count）は選択肢中で最大の index になるため、
+ *   otherText があるときは最大 index を Other 行とみなす。
+ */
+export declare function injectQuestionAnswers(answers: QuestionAnswer[], session: string, sessionManager: SessionBackend): Promise<void>;

package/dist/hub/questionInjection.js

@@ -0,0 +1,126 @@
+// questionInjection.ts
+// tailii (TS host) — AskUserQuestion の回答を Claude TUI へ注入する。
+import { sleep } from "../shared/sleep.js";
+const KEY_STEP_MS = 150;
+/** Other 本文 → Enter の猶予（herdr 実測: 300ms 未満だと CR が本文に飲まれる）。 */
+const OTHER_TEXT_CR_GAP_MS = 400;
+/** 注入完了からダイアログ消滅検証までの猶予（TUI の再描画待ち）。 */
+const VERIFY_DELAY_MS = 600;
+/** 1回目の検証でダイアログ残存だったときの再検証までの猶予。 */
+const VERIFY_RETRY_DELAY_MS = 1_500;
+/**
+ * AskUserQuestion ダイアログのフレームか。`Enter to select` は /remote-control 等の
+ * ❯ メニューにも出るため、設問 TUI 固有の要素（質問タブ・回答レビュー・notes 等）との
+ * AND で判定する（承認ダイアログは Enter to select を含まないので対象外）。
+ */
+export function isQuestionDialogFrame(text) {
+    if (!text.includes("Enter to select"))
+        return false;
+    return (text.includes("Tab to switch questions") ||
+        text.includes("Ready to submit your answers?") ||
+        text.includes("Chat about this") ||
+        text.includes("Type something.") ||
+        text.includes("to add notes"));
+}
+/**
+ * question_answer → Claude AskUserQuestion TUI のキー操作。
+ * 各キー間の待機は、Ink の再描画中に連続入力が欠落するのを避けるために設ける。
+ * - 単一選択 = 数字キーで即確定。Other は行番号 → literal 入力 → Enter。
+ * - multiSelect = 数字キーは無反応。カーソル（先頭 index 0 から開始）を ↓ で対象行へ移動し
+ *   Space でトグル → Right でレビュー → 最終問後に「1」Submit answers。
+ *   Other 行は Space でチェック＆入力欄化 → literal 入力 → ↑ でテキスト欄を抜けてから Right。
+ * - Other の synthetic index（= options.count）は選択肢中で最大の index になるため、
+ *   otherText があるときは最大 index を Other 行とみなす。
+ */
+export async function injectQuestionAnswers(answers, session, sessionManager) {
+    const sorted = answers.slice().sort((a, b) => a.questionIndex - b.questionIndex);
+    // 2 問以上では、最後の設問が単一選択でも回答レビュー画面を経由する。
+    // 単一選択の数字キーは「その設問を確定」するだけで、AskUserQuestion 全体の
+    // Submit answers までは行わない。1 問だけの単一選択のみ即時完了する。
+    const needsReviewSubmit = sorted.length > 1 || sorted.some((answer) => answer.multiSelect);
+    for (const answer of sorted) {
+        const other = (answer.otherText ?? "").trim();
+        let indexes = answer.selectedOptionIndexes.filter((i) => i >= 0).sort((a, b) => a - b);
+        // otherText があるとき、最大 index は Other（Type something.）行。
+        let otherIndex = null;
+        if (other.length > 0 && indexes.length > 0) {
+            otherIndex = indexes[indexes.length - 1];
+            indexes = indexes.slice(0, -1);
+        }
+        if (answer.multiSelect) {
+            // multiSelect は数字キーではトグルできない（実 TUI）。カーソルを ↓ で移動し Space でトグルする。
+            // カーソルは先頭（index 0）から開始。indexes / otherIndex は昇順なので下方向のみで足りる。
+            let cursor = 0;
+            const moveTo = async (target) => {
+                for (let n = cursor; n < target; n += 1) {
+                    await sessionManager.sendKeys(session, ["Down"]);
+                    await sleep(KEY_STEP_MS);
+                }
+                cursor = target;
+            };
+            for (const idx of indexes) {
+                await moveTo(idx);
+                await sessionManager.sendKeys(session, ["Space"]);
+                await sleep(KEY_STEP_MS);
+            }
+            if (otherIndex !== null) {
+                await moveTo(otherIndex);
+                // Other 行を Space でチェックすると同時に入力欄がフォーカスされる。
+                await sessionManager.sendKeys(session, ["Space"]);
+                await sleep(KEY_STEP_MS);
+                await sessionManager.sendKeys(session, [other], true);
+                await sleep(KEY_STEP_MS);
+                // テキスト欄にいると Right がタブ移動に効かないため、↑ で通常行へ退避してから進む。
+                await sessionManager.sendKeys(session, ["Up"]);
+                await sleep(KEY_STEP_MS);
+                cursor = otherIndex - 1;
+            }
+            // レビュー（最終問）または次の質問タブへ進む。
+            await sessionManager.sendKeys(session, ["Right"]);
+        }
+        else if (otherIndex !== null) {
+            await sessionManager.sendKeys(session, [String(otherIndex + 1)]);
+            await sleep(KEY_STEP_MS);
+            // 本文は生キーで注入する。sendTextSubmit は「選択ダイアログ残存 → Esc で閉じる」防御を
+            // 持ち、AskUserQuestion ダイアログ自体（Enter to select フッター）を誤認して Esc で
+            // 設問を却下してしまう（実機FB 2026-08-05: その他回答が Request interrupted になり、
+            // 本文が通常メッセージとして送信される）。CR は本文から 300ms 以上空ければ飲まれない
+            // （herdr 実測 2026-07-22）ので、本文 → 猶予 → Enter の open-loop で確定し、
+            // 取りこぼしは末尾のダイアログ残存検証（throw → pending 復元）に任せる。
+            await sessionManager.sendKeys(session, [other], true);
+            await sleep(OTHER_TEXT_CR_GAP_MS);
+            await sessionManager.sendKeys(session, ["Enter"]);
+        }
+        else if (indexes.length > 0) {
+            // 数字キーで即確定（Enter は送らない）。
+            await sessionManager.sendKeys(session, [String(indexes[0] + 1)]);
+        }
+        // TUI の再描画/タブ送りを待つ（連続注入の取りこぼし防止）。
+        await sleep(200);
+    }
+    if (needsReviewSubmit) {
+        // 複数設問または複数選択では、最後に必ず回答レビュー画面を経由する。
+        // 「Ready to submit your answers?」で 1. Submit answers を確定する。
+        await sessionManager.sendKeys(session, ["1"]);
+    }
+    // 注入は TUI への open-loop キー操作で、キーが取りこぼされても各コマンドは exit 0 のまま
+    // 静かに失敗する。ダイアログが閉じたかを pane で検証し、残存なら throw して呼び出し側
+    // （hub）に pendingQuestion の復元と prompt 再配信をさせる（詰み防止, question-answer-retry）。
+    await sleep(VERIFY_DELAY_MS);
+    if (!(await questionDialogStillVisible(session, sessionManager)))
+        return;
+    await sleep(VERIFY_RETRY_DELAY_MS);
+    if (await questionDialogStillVisible(session, sessionManager)) {
+        throw new Error("AskUserQuestion dialog still visible after key injection");
+    }
+}
+/** pane 読取失敗は「検証不能」= 残存扱いにしない（誤復元でユーザーを二重回答に誘導しない）。 */
+async function questionDialogStillVisible(session, sessionManager) {
+    try {
+        return isQuestionDialogFrame(await sessionManager.capturePane(session, { lines: 40 }));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=questionInjection.js.map

package/dist/hub/questionInjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questionInjection.js","sourceRoot":"","sources":["../../src/hub/questionInjection.ts"],"names":[],"mappings":"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"}

package/dist/hub/reaper.d.ts

@@ -0,0 +1,74 @@
+import type { SessionInfo } from "../protocol.js";
+import { SessionMetadataStore } from "../sessions/sessionMetadataStore.js";
+import { type TmuxCommandRunner } from "../backend/tmux.js";
+/** 一律のアイドル timeout(秒)。idle/active(bump 停止)の両方に同じ値を使う。 */
+export declare const REAPER_IDLE_TIMEOUT_SECONDS = 1800;
+/** 巡回間隔(秒)。 */
+export declare const REAPER_CHECK_INTERVAL_SECONDS = 60;
+/** tailii が管理する tmux セッション名(これ以外は絶対に触らない)。 */
+export declare const TAILII_SESSION_PATTERN: RegExp;
+/** herdr backend セッションの reaper 操作面（テストはモックを注入する）。 */
+export interface HerdrReaperOps {
+    list(): Promise<SessionInfo[]>;
+    agentProcessAlive(name: string): Promise<boolean>;
+    kill(name: string): Promise<void>;
+    /** 生存 Tailii セッションが 0 のとき、pane ゼロの専用 server を停止する（任意実装）。 */
+    stopServerIfEmpty?(): Promise<void>;
+    /** 生存 pane の session 名 → タブ情報（session-title 自動タイトル同期用, 任意実装）。 */
+    tabInfoByName?(): Promise<Map<string, {
+        tabId: string;
+        label: string | null;
+    }>>;
+    /** タブラベルの書換（session-title, 任意実装）。 */
+    setDisplayTitle?(name: string, title: string | null): Promise<void>;
+}
+export interface ReaperTickOptions {
+    runner: TmuxCommandRunner;
+    heartbeatDir: string;
+    metadataStore: SessionMetadataStore;
+    timeoutSeconds: number;
+    now: number;
+    log?: (message: string) => void;
+    /**
+     * LISTEN 中のローカル開発サーバーが持つ cwd 集合。timeout 候補がある tick でだけ呼ぶ。
+     * null は検出不能。サーバーなしの空集合とは区別し、回収を次 tick へ延期する。
+     */
+    listLocalServerCwds?: () => Promise<ReadonlySet<string> | null>;
+    /**
+     * herdr backend の操作面。省略時は herdr メタが存在するときだけ実 HerdrSessionManager を使う
+     * （純 tmux 環境では herdr CLI を一切呼ばない）。null で herdr 巡回を無効化。
+     */
+    herdrOps?: HerdrReaperOps | null;
+    /**
+     * claude 会話タイトルの導出（session-title 自動タイトル同期用, テスト注入可）。
+     * 省略時は transcript の明示タイトル（custom-title/ai-title）優先 → 最初のユーザー発話。
+     */
+    deriveClaudeTitle?: (claudeSessionId: string) => string | null;
+    /**
+     * Codex の正式な会話名（thread.name）の導出（session-title 自動タイトル同期用）。
+     * 省略時は稼働中の共有 App Server の thread/list を巡回ごとに一度だけ読む。
+     */
+    deriveCodexTitle?: (threadId: string) => string | null | Promise<string | null>;
+}
+export interface ReaperTickResult {
+    /** 巡回時点で生存していた tailii セッション数(kill 前)。0 なら daemon は自然終了してよい。 */
+    liveCount: number;
+    killed: string[];
+    /** active のままプロセスだけ死んでいて idle へ降格したセッション。 */
+    demoted: string[];
+    /** 生存セッションが無く heartbeat 残骸を掃除したセッション。 */
+    reclaimed: string[];
+}
+/** server cwd がセッション cwd 自身またはその子孫か（prefix sibling は除外）。 */
+export declare function serverCwdBelongsToSession(sessionCwd: string, serverCwd: string): boolean;
+/** 生存中の tailii セッション名(`cs-*`/`s-*`)。tmux サーバ不在は空集合。 */
+export declare function liveTailiiSessions(runner: TmuxCommandRunner): Promise<string[]>;
+/** ターミナルクライアントが attach 中のセッション名集合。取得失敗は空集合(保護なしに倒す)。 */
+export declare function attachedSessions(runner: TmuxCommandRunner): Promise<Set<string>>;
+/**
+ * pane のエージェントプロセス生存判定。判定不能(tmux エラー等)は true(=保護、安全側)。
+ * pane_current_command がシェル名なら claude/codex プロセスは終了している。
+ */
+export declare function agentProcessAlive(runner: TmuxCommandRunner, name: string, metadataStore: SessionMetadataStore): Promise<boolean>;
+/** 巡回 1 回分。判定表は docs/architecture.md「セッション自動掃除」を参照。 */
+export declare function reaperTick(options: ReaperTickOptions): Promise<ReaperTickResult>;