tailii-host 0.1.0 → 0.3.0

package/dist/hub/hubClient.js

@@ -0,0 +1,187 @@
+// hubClient.ts
+// tailii (TS host) — engine から Session Hub へ接続する再接続可能な link。
+import * as net from "node:net";
+import { ensureHubDaemon } from "./hubDaemon.js";
+import { decodeHubServerLine, encodeHubMessage } from "./hubProtocol.js";
+import { resolveHubSocketPath } from "../shared/socketPath.js";
+export function connectHubSocket(options = {}) {
+    const socketPath = options.socketPath ?? resolveHubSocketPath();
+    let socket = null;
+    let closed = false;
+    let retryMs = 250;
+    let disconnectedAtMs = null;
+    let reconnectHandler = null;
+    let pendingReconnect = null;
+    const helloCompletedSockets = new WeakSet();
+    const queued = [];
+    const isReplayableState = (message) => message.type === "session_processing" || message.type === "runtime_claim_release" ||
+        message.type === "session_retire";
+    const enqueueOfflineState = (message) => {
+        // id 相関 RPC は呼び出し側 timeout / durable Outbox が再試行を所有する。切断queueへ
+        // 残すと遅延実行されるため、再接続後にも意味がある状態通知と確定killだけを合流する。
+        if (!isReplayableState(message))
+            return;
+        const existing = queued.findIndex((candidate) => candidate.type === message.type && "session" in candidate && "session" in message &&
+            candidate.session === message.session);
+        if (existing >= 0)
+            queued.splice(existing, 1);
+        queued.push(message);
+        // hook嵐や長期停止でも常駐engineのメモリを無制限に増やさない。
+        while (queued.length > 128) {
+            // 同名セッションへの旧queue混入を防ぐ確定killを、通常のprocessing更新より優先する。
+            const removable = queued.findIndex((candidate) => candidate.type !== "session_retire");
+            queued.splice(removable >= 0 ? removable : 0, 1);
+        }
+    };
+    const link = {
+        onMessage: null,
+        get onReconnect() { return reconnectHandler; },
+        set onReconnect(handler) {
+            reconnectHandler = handler;
+            if (handler === null || pendingReconnect === null)
+                return;
+            // connectHubSocket は生成直後から接続するため、engine の初期化 await 中に hello が
+            // 先着しうる。最新の hello 完了情報を handler 登録まで保持し、一度だけ引き渡す。
+            const info = pendingReconnect;
+            pendingReconnect = null;
+            handler(info);
+        },
+        send(message) {
+            // net.Socket は connect 中でも writable=true になり、接続失敗した候補へ write すると
+            // 再接続 queue を経ずに消える。確立済み socket だけを直接配送対象にする。
+            if (socket?.writable === true && socket.connecting === false && socket.destroyed === false) {
+                if (isReplayableState(message) && !helloCompletedSockets.has(socket)) {
+                    enqueueOfflineState(message);
+                    return true;
+                }
+                socket.write(encodeHubMessage(message));
+                return true;
+            }
+            enqueueOfflineState(message);
+            // 非再生対象（id 相関 RPC 等）はここで破棄される。呼び出し側が即時失敗できるよう
+            // false を返す（オフライン再生対象は queue に合流済みなので true）。
+            return isReplayableState(message);
+        },
+        close() {
+            closed = true;
+            pendingReconnect = null;
+            socket?.destroy();
+            socket = null;
+        },
+    };
+    const connect = () => {
+        if (closed)
+            return;
+        const candidate = net.connect(socketPath);
+        socket = candidate;
+        let connected = false;
+        let helloHandled = false;
+        let helloTimer = null;
+        let buffer = Buffer.alloc(0);
+        candidate.once("connect", () => {
+            connected = true;
+            retryMs = 250;
+            candidate.write(encodeHubMessage({ type: "hub_hello" }));
+            helloTimer = setTimeout(() => {
+                if (!helloHandled)
+                    candidate.destroy(new Error("Session Hub hello timeout"));
+            }, options.helloTimeoutMs ?? 5_000);
+            helloTimer.unref();
+        });
+        candidate.on("data", (chunk) => {
+            buffer = buffer.length === 0 ? chunk : Buffer.concat([buffer, chunk]);
+            let newline;
+            while ((newline = buffer.indexOf(0x0a)) >= 0) {
+                const message = decodeHubServerLine(buffer.subarray(0, newline).toString("utf8"));
+                buffer = buffer.subarray(newline + 1);
+                if (message !== null) {
+                    link.onMessage?.(message);
+                    if (message.type === "hub_hello_ack" && !helloHandled) {
+                        helloHandled = true;
+                        helloCompletedSockets.add(candidate);
+                        if (helloTimer !== null)
+                            clearTimeout(helloTimer);
+                        helloTimer = null;
+                        // handshake が成立した候補へだけオフライン状態を流す。不正 hello で破棄する
+                        // socket に session_retire 等を消費させない。
+                        const replay = queued.splice(0);
+                        // hello snapshot は replay より前の状態。直後に送る processing/retire を反映した
+                        // effective snapshot を engine へ渡さないと、retire 済み会話を active として
+                        // 再購読して actor を作り直す。
+                        let effectiveProcessingSessions = message.processingSessions === undefined
+                            ? undefined
+                            : new Set(message.processingSessions);
+                        if (effectiveProcessingSessions !== undefined) {
+                            for (const queuedMessage of replay) {
+                                if (queuedMessage.type === "session_retire") {
+                                    effectiveProcessingSessions.delete(queuedMessage.session);
+                                }
+                                else if (queuedMessage.type === "session_processing") {
+                                    if (queuedMessage.state === "active")
+                                        effectiveProcessingSessions.add(queuedMessage.session);
+                                    else
+                                        effectiveProcessingSessions.delete(queuedMessage.session);
+                                }
+                            }
+                        }
+                        for (const queuedMessage of replay) {
+                            candidate.write(encodeHubMessage(queuedMessage));
+                        }
+                        const boundary = disconnectedAtMs;
+                        disconnectedAtMs = null;
+                        const info = {
+                            bootId: message.bootId,
+                            disconnectedAtMs: boundary,
+                            processingSessions: effectiveProcessingSessions === undefined
+                                ? undefined
+                                : [...effectiveProcessingSessions],
+                        };
+                        if (reconnectHandler === null)
+                            pendingReconnect = info;
+                        else
+                            reconnectHandler(info);
+                    }
+                }
+            }
+        });
+        candidate.once("error", () => {
+            (options.ensureDaemon ?? ensureHubDaemon)();
+        });
+        candidate.once("close", () => {
+            if (helloTimer !== null)
+                clearTimeout(helloTimer);
+            helloTimer = null;
+            if (socket === candidate)
+                socket = null;
+            if (closed)
+                return;
+            if (connected && disconnectedAtMs === null)
+                disconnectedAtMs = Date.now();
+            const delay = retryMs;
+            retryMs = Math.min(5_000, retryMs * 2);
+            setTimeout(connect, delay).unref();
+        });
+    };
+    connect();
+    return link;
+}
+/** socket を使わず同じ SessionHub コアへ結ぶテスト用 link。 */
+export function connectInProcessHub(hub) {
+    const client = {};
+    const link = {
+        onMessage: null,
+        onReconnect: null,
+        send(message) {
+            hub.handleClientMessage(client, JSON.stringify(message));
+            return true;
+        },
+        close() { hub.unregisterClient(client); },
+    };
+    hub.registerClient(client, (line) => {
+        const message = decodeHubServerLine(line);
+        if (message !== null)
+            link.onMessage?.(message);
+    });
+    return link;
+}
+//# sourceMappingURL=hubClient.js.map

package/dist/hub/hubClient.js.map

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

package/dist/hub/hubDaemon.d.ts

@@ -0,0 +1,69 @@
+import { spawn } from "node:child_process";
+import { SessionHub } from "./sessionHub.js";
+import { LineWriter } from "../shared/lineWriter.js";
+import { type ControlMessage } from "../protocol.js";
+export interface HubLock {
+    pid: number;
+    version: string | null;
+}
+export declare function defaultHubLockPath(): string;
+export declare function defaultPendingQuestionsPath(): string;
+export declare function defaultChatReceiptsPath(): string;
+/**
+ * LineWriter の canonical flat wire を Hub 内部の ControlMessage へ戻す adapter。
+ *
+ * tool_activity / subagent_node は内部表現だけ nested で、wire は flat になる。
+ * JSON.parse の型 assertion だけでは activity/node が欠けた偽 ControlMessage を作るため、
+ * 必ず protocol decoder を通して境界を検証・復元する。
+ */
+export declare function controlMessageCallbackWriter(write: (message: ControlMessage) => void): LineWriter;
+/** lockfile を読む。不在・壊れは null。 */
+export declare function readHubLock(lockPath: string): HubLock | null;
+/** 生存中の別 pid が所有していなければ lock を取得する。 */
+export declare function acquireHubLock(lockPath: string, version: string | null, ownerPid?: number): boolean;
+/** pid が生きているか。権限不足(EPERM)は生存扱い。 */
+export declare function pidAlive(pid: number): boolean;
+export interface HubSocketServer {
+    socketPath: string;
+    close(): Promise<void>;
+}
+export declare const HUB_SOCKET_WRITABLE_LENGTH_LIMIT: number;
+export declare const HUB_SOCKET_CONVERSATION_EVENT_BATCH_SIZE = 16;
+export declare const HUB_SOCKET_CONVERSATION_EVENT_FLUSH_INTERVAL_MS = 8;
+interface HubWritableSocket {
+    readonly writableLength: number;
+    readonly destroyed: boolean;
+    write(line: string): unknown;
+    destroy(): unknown;
+}
+/** Hub から client へ書く直前に滞留量を検査し、遅延 client を切断する。 */
+export declare function writeHubSocketLine(socket: HubWritableSocket, line: string, writableLengthLimit: number, log: (message: string) => void): void;
+/**
+ * 大量の履歴 conversation_event を同期的に socket へ積むと、後着した pane_preview が
+ * history-done の後ろまで待たされる。履歴だけを小分けにし、ライブ状態・RPC応答は
+ * 直送して追い越せるようにする。conversation_event 同士の順序は FIFO で維持する。
+ */
+export declare function createPrioritizedHubSocketWriter(socket: HubWritableSocket, writableLengthLimit: number, log: (message: string) => void, options?: {
+    batchSize?: number;
+    flushIntervalMs?: number;
+}): (line: string) => void;
+/** engine 接続の各行を SessionHub コアへ渡す NDJSON socket。 */
+export declare function startHubSocket(options: {
+    hub: SessionHub;
+    socketPath?: string;
+    version: string | null;
+    bootId?: string;
+    log?: (message: string) => void;
+    writableLengthLimit?: number;
+}): Promise<HubSocketServer | null>;
+export interface EnsureHubDaemonOptions {
+    lockPath?: string;
+    cliPath?: string;
+    logPath?: string;
+    spawnImpl?: typeof spawn;
+}
+/** engine / hook から Hub の常駐を冪等・best-effort で保証する。 */
+export declare function ensureHubDaemon(options?: EnsureHubDaemonOptions): void;
+/** `tailii hub` エントリ。 */
+export declare function runHubCommand(args: string[]): Promise<number>;
+export {};