tailii-host 0.1.1 → 0.3.0

package/dist/hub/reaper.js

@@ -0,0 +1,333 @@
+// reaper.ts
+// tailii (TS host) — tmux セッション自動掃除の判定ロジック。
+//
+// engine 内蔵の idle reaper は「engine(=SSH 接続)が生きている間しか回らない」「tracker が
+// in-memory で再起動時に空」という構造穴があった。Session Hub daemon は engine から独立した
+// detached プロセスとして動き、heartbeat ファイル(heartbeat.ts)を唯一の判定権威にして
+// `now - ts >= timeout`(一律 1800 秒)で kill する。ただし cwd 自身または子孫でローカル
+// 開発サーバーが LISTEN 中なら activity とみなし、heartbeat を更新して巻き添え終了を防ぐ。
+//
+// state=active(処理中)の扱いはエージェントで異なる:
+//   - claude: ターン中でも hook はツール実行中に沈黙する(長い1ツール呼びの間イベントが無い)
+//     ため、pane のエージェントプロセス生存を確認できたら Hub が ts を bump 代行する。
+//     プロセスが死んでいる(pane がシェルだけ)なら idle に書き換え → 30 分後に通常ルールで kill。
+//   - codex: ターンは engine が駆動し engine と運命共同体。engine が 60 秒毎に bump するので、
+//     bump が止まって timeout を超えた active は「死んだターン」→ そのまま kill してよい。
+//     Hub は bump 代行しない(すると bump 停止=ターン死亡のシグナルが壊れる)。
+//
+// 対象は tailii が作る `cs-*` / `s-*` セッションのみ。ユーザーの他の tmux セッションには触れない。
+// heartbeat 未採番の生存セッション(過去の残骸)は「今を idle」として採番し、次周期から計時する。
+// 対象セッションが 0 になったら自然終了する(次の engine 接続 / hook 発火で ensure され再起動)。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { bumpHeartbeat, listHeartbeatSessions, readHeartbeat, removeHeartbeat, writeHeartbeat, } from "../sessions/heartbeat.js";
+import { HerdrSessionManager, isDefaultHerdrTabLabel } from "../backend/herdr.js";
+import { CodexAppServerManager } from "../codex/codexAppServer.js";
+import { ClaudeSessionStore, transcriptTitle } from "../sessions/claudeSessionStore.js";
+import { paneCommandLooksLikeAgent } from "../backend/tmux.js";
+/** 一律のアイドル timeout(秒)。idle/active(bump 停止)の両方に同じ値を使う。 */
+export const REAPER_IDLE_TIMEOUT_SECONDS = 1800;
+/** 巡回間隔(秒)。 */
+export const REAPER_CHECK_INTERVAL_SECONDS = 60;
+/** tailii が管理する tmux セッション名(これ以外は絶対に触らない)。 */
+export const TAILII_SESSION_PATTERN = /^(cs|s)-/;
+/** 存在するパスは symlink / `..` / 大文字小文字表記を実体パスへ寄せる。 */
+function canonicalCwd(cwd) {
+    const absolute = path.resolve(cwd);
+    try {
+        return fs.realpathSync(absolute);
+    }
+    catch {
+        // stale metadata 等で既に消えた cwd も、字句正規化した値なら安全に比較できる。
+        return absolute;
+    }
+}
+/** server cwd がセッション cwd 自身またはその子孫か（prefix sibling は除外）。 */
+export function serverCwdBelongsToSession(sessionCwd, serverCwd) {
+    const relative = path.relative(canonicalCwd(sessionCwd), canonicalCwd(serverCwd));
+    return relative === "" ||
+        (relative !== ".." && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative));
+}
+/** 生存中の tailii セッション名(`cs-*`/`s-*`)。tmux サーバ不在は空集合。 */
+export async function liveTailiiSessions(runner) {
+    const result = await runner(["ls", "-F", "#{session_name}"]);
+    if (result.exitCode !== 0) {
+        const combined = (result.stdout + result.stderr).toLowerCase();
+        if (combined.includes("no server running") || combined.includes("no sessions"))
+            return [];
+        throw new Error(`tmux ls failed (exit ${result.exitCode}): ${result.stderr}`);
+    }
+    return result.stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((name) => TAILII_SESSION_PATTERN.test(name))
+        .sort();
+}
+/** ターミナルクライアントが attach 中のセッション名集合。取得失敗は空集合(保護なしに倒す)。 */
+export async function attachedSessions(runner) {
+    try {
+        const result = await runner(["list-clients", "-F", "#{session_name}"]);
+        if (result.exitCode !== 0)
+            return new Set();
+        return new Set(result.stdout
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((name) => name.length > 0));
+    }
+    catch {
+        return new Set();
+    }
+}
+/**
+ * pane のエージェントプロセス生存判定。判定不能(tmux エラー等)は true(=保護、安全側)。
+ * pane_current_command がシェル名なら claude/codex プロセスは終了している。
+ */
+export async function agentProcessAlive(runner, name, metadataStore) {
+    const target = metadataStore.get(name)?.tmuxPaneId ?? name;
+    try {
+        const result = await runner(["display-message", "-p", "-t", target, "#{pane_current_command}"]);
+        if (result.exitCode !== 0)
+            return true;
+        return paneCommandLooksLikeAgent(result.stdout);
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * herdr 巡回の既定 ops。herdr メタが 1 つも無ければ null（herdr CLI を呼ばない）。
+ * kill は pane close 相当（HerdrSessionManager.kill）。
+ */
+function defaultHerdrReaperOps(metadataStore) {
+    if (!metadataStore.all().some((meta) => meta.backend === "herdr"))
+        return null;
+    return new HerdrSessionManager({ store: metadataStore });
+}
+/** 既定の claude 会話タイトル導出（明示タイトル優先 → 最初のユーザー発話, 一覧と同じ規則）。 */
+function defaultDeriveClaudeTitle(claudeSessionId) {
+    const transcript = new ClaudeSessionStore().transcriptPath(claudeSessionId);
+    if (transcript === null)
+        return null;
+    return transcriptTitle(transcript);
+}
+/** 稼働中の共有 App Server から正式名つき Codex thread を一括取得する（server は起動しない）。 */
+async function loadCodexThreadTitles() {
+    const threads = await new CodexAppServerManager().listThreads();
+    if (threads === null)
+        return new Map();
+    return new Map(threads.flatMap((thread) => thread.name === null ? [] : [[thread.id, thread.name]]));
+}
+/** 巡回 1 回分。判定表は docs/architecture.md「セッション自動掃除」を参照。 */
+export async function reaperTick(options) {
+    const { runner, heartbeatDir, metadataStore, timeoutSeconds, now } = options;
+    const log = options.log ?? (() => { });
+    const live = await liveTailiiSessions(runner);
+    const attached = live.length > 0 ? await attachedSessions(runner) : new Set();
+    const killed = [];
+    const demoted = [];
+    const reclaimed = [];
+    let localServerCwdsPromise = null;
+    let localServerUnavailableLogged = false;
+    /** 同一 tick では lsof 結果を全セッションで共有する。検出失敗は null にして回収を延期。 */
+    const localServerCwds = () => {
+        if (localServerCwdsPromise === null) {
+            localServerCwdsPromise = (options.listLocalServerCwds?.() ?? Promise.resolve(new Set()))
+                .catch((error) => {
+                log(`local server 検出失敗(回収を延期): ${String(error)}`);
+                localServerUnavailableLogged = true;
+                return null;
+            });
+        }
+        return localServerCwdsPromise;
+    };
+    /**
+     * 1 セッション分の判定（tmux / herdr 共通）。heartbeat のルールは backend に依らない:
+     * 未採番=adopt / attach 中=bump / claude active+alive=bump 代行 / active+dead=idle 降格 /
+     * idle・codex active の timeout 超過=kill。
+     */
+    const judge = async (name, isAttached, agentAlive, kill) => {
+        const heartbeat = readHeartbeat(heartbeatDir, name);
+        if (heartbeat === null) {
+            // 未採番(engine 再起動をまたいだ残骸等)。今を idle 起点として採番し次周期から計時。
+            writeHeartbeat(heartbeatDir, name, { ts: now, state: "idle", event: "adopted" });
+            log(`adopt ${name}`);
+            return;
+        }
+        if (isAttached) {
+            // ターミナルから attach 中 = 人間が使用中。hook/engine を経由しない利用でも殺さない。
+            bumpHeartbeat(heartbeatDir, name, now, "daemon-client-attached");
+            return;
+        }
+        const agent = metadataStore.get(name)?.agent ?? "claude";
+        if (heartbeat.state === "active" && agent === "claude") {
+            if (await agentAlive()) {
+                // 処理中(ツール実行中は hook が沈黙する)。デーモンが ts を bump 代行して保護。
+                bumpHeartbeat(heartbeatDir, name, now, "daemon-agent-alive", "active");
+            }
+            else {
+                // active のままプロセスだけ死んだ(クラッシュ等)。idle へ倒して通常計時に載せる。
+                writeHeartbeat(heartbeatDir, name, { ts: now, state: "idle", event: "agent-process-dead" });
+                demoted.push(name);
+                log(`demote ${name} (agent process dead)`);
+            }
+            return;
+        }
+        // idle、および codex の active(bump 停止=ターン死亡)は一律 timeout で kill。
+        if (now - heartbeat.ts < timeoutSeconds)
+            return;
+        // 同じプロジェクト配下でローカル開発サーバーが LISTEN 中なら、その pane を閉じると
+        // server まで巻き添え終了する。server 自体を利用中の activity とみなし、停止後に改めて
+        // timeout 分の猶予を取る（herdr は attach 状態を取得できないため特に重要）。
+        const serverCwds = await localServerCwds();
+        // lsof 未導入・timeout 等を「サーバーなし」に倒すと、その瞬間に pane と server を
+        // 破壊し得る。heartbeat は進めず次の 60 秒 tick で再検出する。
+        if (serverCwds === null) {
+            if (!localServerUnavailableLogged) {
+                log("local server 検出不能のため timeout セッション回収を延期");
+                localServerUnavailableLogged = true;
+            }
+            return;
+        }
+        const cwd = metadataStore.get(name)?.cwd;
+        if (cwd !== undefined && [...serverCwds].some((serverCwd) => serverCwdBelongsToSession(cwd, serverCwd))) {
+            bumpHeartbeat(heartbeatDir, name, now, "daemon-local-server");
+            log(`protect ${name} (local server cwd=${cwd})`);
+            return;
+        }
+        // kill 直前に再読取して再判定する: tick 中に会話が再オープンされ engine が bump した
+        // 直後のセッションを殺さない(読取→kill 間の競合窓を閉じる)。
+        const recheck = readHeartbeat(heartbeatDir, name);
+        if (recheck !== null && recheck.ts !== heartbeat.ts)
+            return;
+        await kill();
+        removeHeartbeat(heartbeatDir, name);
+        killed.push(name);
+        log(`kill ${name} (state=${heartbeat.state} idle=${now - heartbeat.ts}s)`);
+    };
+    for (const name of live) {
+        await judge(name, attached.has(name), () => agentProcessAlive(runner, name, metadataStore), async () => {
+            const result = await runner(["kill-session", "-t", name]);
+            if (result.exitCode !== 0) {
+                log(`kill 失敗(掃除して継続): ${name}: ${result.stderr.trim()}`);
+            }
+        });
+    }
+    // --- herdr backend の巡回（tailii named session の pane）---
+    // attach 保護は無し（herdr API にクライアント attach 情報が無い）。claude の
+    // agent-alive bump 代行と heartbeat 計時は tmux と同一ルール。
+    const herdrOps = options.herdrOps !== undefined ? options.herdrOps : defaultHerdrReaperOps(metadataStore);
+    let herdrLive = [];
+    if (herdrOps !== null) {
+        try {
+            herdrLive = (await herdrOps.list())
+                .filter((info) => info.alive && TAILII_SESSION_PATTERN.test(info.name))
+                .map((info) => info.name)
+                .sort();
+        }
+        catch {
+            herdrLive = [];
+        }
+        for (const name of herdrLive) {
+            await judge(name, false, () => herdrOps.agentProcessAlive(name), async () => {
+                try {
+                    await herdrOps.kill(name);
+                }
+                catch (error) {
+                    log(`kill 失敗(掃除して継続): ${name}: ${String(error)}`);
+                }
+            });
+        }
+        // 生存 Tailii セッションが 0 なら空 server を回収する（tmux server の自動終了に対応）。
+        // 判定は ops 側で pane 総数 0 のときだけ停止する（手動 pane があれば停止しない）。
+        if (herdrLive.length === 0) {
+            await herdrOps.stopServerIfEmpty?.();
+        }
+        // --- 未命名タブへ会話タイトルを自動反映（session-title）---
+        // タブラベルが未命名（null / 空 / セッション名 / 0.7.5 tab create の既定連番 "1"…）の
+        // 生存セッションだけを対象に、Claude は transcript の会話タイトル（明示タイトル
+        // custom-title/ai-title 優先）、Codex は App Server の正式名 thread.name をタブへ書く。
+        // 命名済み（それ以外のラベル）は手動を優先して触らない。
+        if (herdrLive.length > 0 &&
+            herdrOps.tabInfoByName !== undefined && herdrOps.setDisplayTitle !== undefined) {
+            const deriveClaudeTitle = options.deriveClaudeTitle ?? defaultDeriveClaudeTitle;
+            let codexTitlesPromise = null;
+            const deriveCodexTitle = options.deriveCodexTitle ?? (async (threadId) => {
+                codexTitlesPromise ??= loadCodexThreadTitles();
+                return (await codexTitlesPromise).get(threadId) ?? null;
+            });
+            try {
+                const tabInfo = await herdrOps.tabInfoByName();
+                for (const name of herdrLive) {
+                    if (killed.includes(name))
+                        continue;
+                    const meta = metadataStore.get(name);
+                    if (meta === null)
+                        continue;
+                    const agent = meta.agent ?? "claude";
+                    const providerSessionId = agent === "codex"
+                        ? meta.providerSessionId
+                        : meta.providerSessionId ?? meta.claudeSessionId;
+                    if (providerSessionId === undefined)
+                        continue;
+                    const info = tabInfo.get(name);
+                    if (info === undefined)
+                        continue;
+                    // 「ラベル==前回の自動適用値」も未命名扱い = ai-title の更新へ追随して再リネーム
+                    // する（追随しないと旧 ai-title がタブに固定され、iOS の逆方向取り込みが人為
+                    // リネームと誤認して override 化する）。
+                    const unnamed = info.label === null || info.label === "" || info.label === name ||
+                        isDefaultHerdrTabLabel(info.label) || info.label === meta.autoTabTitle;
+                    if (!unnamed)
+                        continue; // 命名済み（人為リネーム）は触らない
+                    let title;
+                    try {
+                        title =
+                            agent === "codex"
+                                ? await deriveCodexTitle(providerSessionId)
+                                : deriveClaudeTitle(providerSessionId);
+                    }
+                    catch (error) {
+                        log(`session-title 導出失敗(継続): ${name}: ${String(error)}`);
+                        continue;
+                    }
+                    if (title === null || title.length === 0)
+                        continue;
+                    if (info.label === title) {
+                        // ラベルは最新。自動適用の記録だけ追いつかせる（旧版からの移行時）。
+                        if (meta.autoTabTitle !== title) {
+                            try {
+                                metadataStore.put({ ...meta, autoTabTitle: title });
+                            }
+                            catch (error) {
+                                log(`session-title 記録失敗(継続): ${name}: ${String(error)}`);
+                            }
+                        }
+                        continue;
+                    }
+                    try {
+                        await herdrOps.setDisplayTitle(name, title);
+                        metadataStore.put({ ...meta, autoTabTitle: title });
+                        log(`session-title 自動反映: ${name} → ${title.slice(0, 30)}`);
+                    }
+                    catch (error) {
+                        log(`session-title 反映失敗(継続): ${name}: ${String(error)}`);
+                    }
+                }
+            }
+            catch (error) {
+                log(`session-title 巡回失敗(継続): ${String(error)}`);
+            }
+        }
+    }
+    // 生存セッションの無い heartbeat は残骸 → 掃除(メタデータ = cwd 権威記録は消さない)。
+    // herdr 生存分も和に含める(含めないと herdr セッションの heartbeat を毎周期誤回収する)。
+    const liveSet = new Set([...live, ...herdrLive]);
+    for (const name of listHeartbeatSessions(heartbeatDir)) {
+        if (!liveSet.has(name)) {
+            removeHeartbeat(heartbeatDir, name);
+            reclaimed.push(name);
+        }
+    }
+    return { liveCount: live.length + herdrLive.length, killed, demoted, reclaimed };
+}
+//# sourceMappingURL=reaper.js.map

package/dist/hub/reaper.js.map

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

package/dist/hub/sessionHub.d.ts

@@ -0,0 +1,203 @@
+import type { ReaperTickOptions, ReaperTickResult } from "./reaper.js";
+import type { EngineRelayMessage } from "./engineRelaySocket.js";
+import { type HubClientMessage, type HubServerMessage } from "./hubProtocol.js";
+import type { ControlMessage, QuestionPromptQuestion, SubagentTranscriptEntry } from "../protocol.js";
+import type { ChatAgent } from "../chat/chatTailController.js";
+import type { PanePreviewMode } from "./panePreviewPump.js";
+import type { QuestionAnswer } from "../protocol.js";
+import { type CodexAppServerThreadRuntime, type CodexNativeTurnControllerOptions, type CodexTurnControllerRuntime } from "../codex/codexNativeTurnController.js";
+import { type CodexTurnLifecycleEvent } from "../codex/codexRolloutTailer.js";
+export interface HubTail {
+    open(cwd: string, preferredSessionId: string | null, newerThanMs?: number | null, agent?: ChatAgent): void;
+    stop(): void;
+    subagentTranscript?(nodeId: string): {
+        entries: SubagentTranscriptEntry[];
+        omitted: number;
+    };
+}
+export interface HubPreviewPump {
+    start(session: string, mode?: PanePreviewMode, opts?: {
+        emitInitial?: boolean;
+    }): void;
+    stop(): void;
+}
+export type HubTailFactory = (write: (payload: ControlMessage) => void, onCodexTurnLifecycle?: (event: CodexTurnLifecycleEvent) => void) => HubTail;
+export type HubPreviewPumpFactory = (write: (payload: ControlMessage) => void, onPermissionMode?: (mode: string) => void, 
+/** 毎周期評価するポーリング間隔（ms）。前面購読あり=高頻度 / 一覧 watch のみ=低頻度。 */
+pollIntervalMs?: () => number) => HubPreviewPump;
+export type SessionHubOptions = Omit<ReaperTickOptions, "now"> & {
+    /** Unix 秒。テストでは固定時計を注入する。 */
+    now?: () => number;
+    tailFactory?: HubTailFactory;
+    previewPumpFactory?: HubPreviewPumpFactory;
+    replayLimit?: number;
+    questionInjector?: (answers: QuestionAnswer[], session: string) => Promise<void>;
+    chatInjector?: (text: string, session: string) => Promise<void>;
+    codexAppServerFactory?: () => CodexAppServerThreadRuntime;
+    codexTurnControllerFactory?: (options: CodexNativeTurnControllerOptions) => CodexTurnControllerRuntime;
+    /** 未回答設問の永続化先。省略時は永続化しない（daemon は既定パスを明示する）。 */
+    pendingQuestionsPath?: string;
+    /** chat_send の durable queue / 配送済み receipt。daemon は既定パスを明示する。 */
+    chatReceiptsPath?: string;
+    /** receipt 永続化のテスト注入口。省略時は atomic rename を使う。 */
+    chatReceiptsWriter?: (target: string, contents: string) => void;
+};
+interface SubscriberState {
+    preview: boolean;
+    backfilling: boolean;
+}
+interface ReplayEvent {
+    serverSeq: number;
+    payload: ControlMessage;
+}
+interface PendingChatSend {
+    message: Extract<HubClientMessage, {
+        type: "chat_send";
+    }>;
+    waiters: Array<{
+        client: object;
+        id: string;
+    }>;
+}
+interface PendingCodexTurn {
+    message: Extract<HubClientMessage, {
+        type: "codex_turn_submit";
+    }>;
+    waiters: Array<{
+        client: object;
+        id: string;
+    }>;
+}
+interface CodexBufferedItem {
+    itemId: string;
+    payload: ControlMessage;
+}
+interface CodexLiveState {
+    phase: "starting" | "backfill" | "live" | "fallback-scan" | "fallback-live";
+    initialItemIds: ReadonlySet<string>;
+    initialContentCounts: ReadonlyMap<string, number>;
+    buffered: CodexBufferedItem[];
+    seenItemIds: Set<string>;
+    /** backfill と fallback の同文複数回を occurrence 単位で照合する。 */
+    publishedContentCounts: Map<string, number>;
+    scanContentCounts: Map<string, number>;
+    fallbackBaselineCounts: Map<string, number>;
+    disconnected: boolean;
+}
+interface SessionActor {
+    pendingQuestion: {
+        id: string;
+        questions: QuestionPromptQuestion[];
+        answerRoute: "tui" | "codex_native";
+        /** 注入失敗の自己修復で復元済みか。復元は毎回だが prompt 再配信は1回まで（再提示ループ防止）。 */
+        restoredAfterInjectionFailure?: boolean;
+    } | null;
+    processingSince: number | null;
+    focusedBy: Set<object>;
+    subscribers: Map<object, SubscriberState>;
+    nextServerSeq: number;
+    replayBuffer: ReplayEvent[];
+    tail: HubTail | null;
+    tailRetryTimer: ReturnType<typeof setTimeout> | null;
+    previewPump: HubPreviewPump | null;
+    backfillTails: Map<object, HubTail>;
+    seenClientMessageIds: Set<string>;
+    deliveredChatMessageIds: Map<string, number>;
+    deliveredCodexMessageIds: Map<string, number>;
+    deletedChatMessageIds: Map<string, number>;
+    deletedCodexMessageIds: Map<string, number>;
+    pendingChatMessages: Map<string, PendingChatSend>;
+    injectingChatMessageIds: Set<string>;
+    uncertainChatMessages: Map<string, Extract<HubClientMessage, {
+        type: "chat_send";
+    }>>;
+    uncertainCodexMessages: Map<string, Extract<HubClientMessage, {
+        type: "codex_turn_submit";
+    }>>;
+    pendingCodexTurns: Map<string, PendingCodexTurn>;
+    startingCodexMessageIds: Set<string>;
+    runtimeClaim: {
+        client: object;
+        expiresAt: number;
+    } | null;
+    codexLive: CodexLiveState | null;
+    chatQueue: PendingChatSend[];
+    chatOrder: string[];
+    chatDrainRunning: boolean;
+    chatDrainBlocked: boolean;
+    codexQueue: PendingCodexTurn[];
+    codexOrder: string[];
+    codexDrainRunning: boolean;
+    codexDrainBlocked: boolean;
+}
+export declare class SessionHub {
+    private readonly options;
+    private readonly clients;
+    /** 一覧 Mission Control の watcher（処理中会話全体の pane_preview 配信先）。 */
+    private readonly previewWatchers;
+    readonly actors: Map<string, SessionActor>;
+    private readonly now;
+    private readonly replayLimit;
+    private injectionsInFlight;
+    private codexStartsInFlight;
+    private modePushSeq;
+    private chatReceiptsDirty;
+    private readonly activeCodexTurns;
+    private codexTurnController;
+    constructor(options: SessionHubOptions);
+    get clientCount(): number;
+    get hasPendingQuestions(): boolean;
+    get hasInjectionsInFlight(): boolean;
+    get hasCodexTurnsInFlight(): boolean;
+    /** 新しく接続した engine が処理中会話を直ちに購読するための軽量スナップショット。 */
+    get processingSessionNames(): string[];
+    /** Hub 再起動前から active の heartbeat を actor の処理中状態へ戻す。 */
+    restoreFromHeartbeats(): void;
+    /** 永続化済み設問を復元する。App Server の request handle は再起動を越せないため TUI のみ対象。 */
+    restorePendingQuestions(): void;
+    /** daemon 再起動前に durable enqueue 済みだった chat_send と receipt を復元する。 */
+    restoreChatReceipts(): void;
+    registerClient(client: object, write: (line: string) => void): void;
+    unregisterClient(client: object): void;
+    broadcast(message: HubServerMessage): void;
+    sendTo(client: object, message: HubServerMessage): void;
+    handleRelayMessage(message: EngineRelayMessage): void;
+    handleClientMessage(client: object, line: string): void;
+    tick(): Promise<ReaperTickResult>;
+    close(): void;
+    /** tmux セッションの確定 kill に追従し、同名で将来作られる会話へ状態を持ち越さない。 */
+    private retireSession;
+    private subscribe;
+    private unsubscribe;
+    private startSharedTail;
+    private startCodexSharedStream;
+    private openCodexRollout;
+    private handleCodexChatItem;
+    private flushCodexBuffer;
+    private handleCodexDisconnect;
+    private startCodexFallback;
+    private publishCodexContent;
+    private publishConversationEvent;
+    private startBackfill;
+    private canReplay;
+    /** watch 状態・処理中遷移で全 actor の pump 要否を見直す（対象は疎なので全走査で足りる）。 */
+    private syncAllPreviews;
+    private syncPreview;
+    private actor;
+    private claimInput;
+    private deletePendingChatMessage;
+    private deletePendingCodexTurn;
+    private drainChatQueue;
+    private ensureCodexTurnController;
+    private drainCodexQueue;
+    private startCodexTurn;
+    private publishCodexMarker;
+    private applyProcessing;
+    private bumpSafe;
+    private setPendingQuestion;
+    private persistPendingQuestions;
+    private readPendingQuestions;
+    private persistChatReceipts;
+    private readChatReceipts;
+}
+export {};