tailii-host 0.5.0 → 0.7.0

package/dist/codex/codexAppServer.d.ts

@@ -33,7 +33,8 @@ export interface CodexAppServerThreadOptions {
 }
 /** テスト差し替え可能なApp Server 1接続分。 */
 export interface CodexAppServerConnection {
-    initialize(): Promise<void>;
+    /** initialize 応答（`userAgent` 等）を返す。診断用で、void を返す実装でもよい。 */
+    initialize(): Promise<unknown>;
     request(method: string, params: unknown, timeoutMs?: number): Promise<unknown>;
     onNotification(handler: (notification: CodexAppServerNotification) => void): () => void;
     onServerRequest(handler: (request: CodexAppServerRequest) => void): () => void;
@@ -50,13 +51,22 @@ export declare class CodexAppServerThread {
     readonly initialItems: readonly Record<string, unknown>[];
     readonly initialActiveTurnId: string | null;
     /**
-     * この接続で thread/resume（または作成元 bootstrap）が成功し、live 通知を受け取れるか。
-     * rollout 未生成の新規 thread は resume に失敗するため false。呼び出し側は初回 turn の
-     * 表示を rollout tail へフォールバックし、通知が来ない接続を live 権威にしない。
+     * この接続で thread/resume と履歴スナップショットの読み取り（または作成元 bootstrap）が
+     * 成功し、live 通知を受け取れるか。turn 履歴が未生成の新規 thread は false。呼び出し側は
+     * 履歴取得がタイムアウトした場合も false。表示は rollout tail へフォールバックし、
+     * この接続を live 本文の権威にしない（turn 操作と承認は接続を維持する）。
      */
     readonly liveSubscriptionReady: boolean;
     private readonly connection;
     private readonly cwd;
+    /** liveSubscriptionReady=false の理由（履歴読み取りの失敗文言）。ログ診断用。 */
+    readonly liveSubscriptionError: string | null;
+    /**
+     * 購読時点で thread に設定されているモデル（thread/resume または作成元 thread/start の
+     * 応答 `thread.model`）。null は応答に含まれない旧 App Server。Hub はこれを `pc:model`
+     * として配信し、会話を開いていない間に変更されたモデルも開き直しで反映する。
+     */
+    readonly model: string | null;
     /** 読み取り専用の readiness 確認だけは、共有 App Server の一時的な混雑を自動回復する。 */
     private static readonly activeTurnReadMaxAttempts;
     private static readonly activeTurnReadRetryTimeoutMs;
@@ -64,17 +74,31 @@ export declare class CodexAppServerThread {
     private supportsSteerClientUserMessageId;
     constructor(threadId: string, initialItems: readonly Record<string, unknown>[], initialActiveTurnId: string | null, 
     /**
-     * この接続で thread/resume（または作成元 bootstrap）が成功し、live 通知を受け取れるか。
-     * rollout 未生成の新規 thread は resume に失敗するため false。呼び出し側は初回 turn の
-     * 表示を rollout tail へフォールバックし、通知が来ない接続を live 権威にしない。
+     * この接続で thread/resume と履歴スナップショットの読み取り（または作成元 bootstrap）が
+     * 成功し、live 通知を受け取れるか。turn 履歴が未生成の新規 thread は false。呼び出し側は
+     * 履歴取得がタイムアウトした場合も false。表示は rollout tail へフォールバックし、
+     * この接続を live 本文の権威にしない（turn 操作と承認は接続を維持する）。
+     */
+    liveSubscriptionReady: boolean, connection: CodexAppServerConnection, cwd: string | null, 
+    /** liveSubscriptionReady=false の理由（履歴読み取りの失敗文言）。ログ診断用。 */
+    liveSubscriptionError?: string | null, 
+    /**
+     * 購読時点で thread に設定されているモデル（thread/resume または作成元 thread/start の
+     * 応答 `thread.model`）。null は応答に含まれない旧 App Server。Hub はこれを `pc:model`
+     * として配信し、会話を開いていない間に変更されたモデルも開き直しで反映する。
      */
-    liveSubscriptionReady: boolean, connection: CodexAppServerConnection, cwd: string | null);
+    model?: string | null);
     startTurn(text: string, clientUserMessageId?: string | null, effort?: string | null, sandbox?: "read-only" | "workspace-write" | "danger-full-access" | null, approvalPolicy?: CodexAppServerApprovalPolicy | null): Promise<string>;
     readActiveTurnId(): Promise<string | null | undefined>;
-    /** 親履歴で欠落する sub-agent の終端状態を、子 thread 自身から読み直す。 */
+    /**
+     * 親履歴で欠落する sub-agent の終端状態を、子 thread 自身から読み直す。
+     * Thread の `model`（ロード中は現在の設定値、未ロードなら最後に永続化された値）も返し、
+     * 再オープン時に spawn item へ model が無い版でも実行モデルを復元できるようにする。
+     */
     readThreadStatus(threadId: string): Promise<{
         status: unknown;
         timestampMs?: number;
+        model?: string;
     } | undefined>;
     steerTurn(turnId: string, text: string, clientUserMessageId?: string | null): Promise<void>;
     interruptTurn(turnId: string): Promise<void>;
@@ -90,6 +114,10 @@ export interface CodexAppServerManagerOptions {
     pollIntervalMs?: number;
     startupTimeoutMs?: number;
     titleGenerationTimeoutMs?: number;
+    /** 診断ログ（daemon と CLI の版ずれ等）。 */
+    log?: (message: string) => void;
+    /** `codex --version` の代替（テスト用）。null は不明。 */
+    cliVersion?: () => Promise<string | null>;
 }
 /** thread/list の公開スキーマから一覧表示に必要なフィールドだけを保持する。 */
 export interface CodexAppServerThreadInfo {
@@ -125,7 +153,21 @@ export declare class CodexAppServerManager {
     private readonly startupLockPath;
     /** 最初の turn 前（rollout 未作成）の thread を生存させる作成元購読。openThread が引き継ぐ。 */
     private readonly bootstrapConnections;
+    /** thread/start 応答の model。bootstrap 接続を引き継ぐ openThread が購読時のモデルとして返す。 */
+    private readonly bootstrapThreadModels;
+    private readonly log;
+    private readonly readCliVersion;
+    private cliVersionPromise;
+    /** 版ずれは同じ組み合わせにつき 1 回だけログする。 */
+    private lastVersionMismatch;
     constructor(options?: CodexAppServerManagerOptions);
+    /**
+     * initialize 応答の `userAgent`（`<client>/<server 版> (...)`）から daemon の版を読み、
+     * `codex --version` と食い違えばログに残す。共有 daemon は detached spawn で生き残るため、
+     * codex 更新後も旧バイナリが App Server を提供し続ける（2026-07-23 実障害）。他クライアントも
+     * 使う daemon を勝手には再起動せず、原因究明の手掛かりとして版ずれを可視化する。
+     */
+    private noteServerVersion;
     /** serverを再利用または排他的に起動し、利用可能になるまで待つ。 */
     ensureRunning(): Promise<void>;
     /** 稼働中の server にだけ接続する。停止中・不達時は起動せず null を返す。 */
@@ -156,8 +198,11 @@ export declare class CodexAppServerManager {
     generateThreadTitle(options: CodexThreadTitleGenerationOptions): Promise<CodexThreadTitleGenerationResult>;
     /** ログイン中アカウントで利用可能なCodexモデルをApp Server APIから取得する。 */
     listModels(): Promise<CodexModelInfo[]>;
+    /** 指定threadの後続turnで使うモデルをApp Serverの設定APIへ反映する。 */
+    setThreadModel(threadId: string, model: string): Promise<void>;
     /** 既存 thread を購読する長寿命接続を開く。turn と native approval はこの接続を流れる。 */
     openThread(options: CodexAppServerThreadOptions): Promise<CodexAppServerThread>;
+    private openThreadAttempt;
     private probe;
     private remoteControlRequest;
     private waitUntilReady;