tailii-host 0.1.0

package/dist/sessionMetadataStore.js

@@ -0,0 +1,122 @@
+// sessionMetadataStore.ts
+// tailii (TS host) — セッションメタデータ（cwd 権威記録）
+// Swift 版 SessionMetadataStore.swift の移植。
+// セッション名 → 作業ディレクトリ / 作成時刻を <base>/<name>.json に put/get/all で読み書きする。
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { ensureDirectory0700 } from "./paths.js";
+/** session 名が安全でないときに投げる型付きエラー。 */
+export class InvalidSessionNameError extends Error {
+    constructor(name) {
+        super(`invalid session name: ${name}`);
+        this.name = "InvalidSessionNameError";
+    }
+}
+/** session 名の安全性を検証する（空 / null バイト / `/` / `.`・`..` を拒否）。 */
+export function validateSessionName(name) {
+    if (name.length === 0)
+        throw new InvalidSessionNameError(name);
+    if (name.includes("\0"))
+        throw new InvalidSessionNameError(name);
+    if (name.includes("/"))
+        throw new InvalidSessionNameError(name);
+    if (name === "." || name === "..")
+        throw new InvalidSessionNameError(name);
+}
+/** デフォルトのベースディレクトリ（`~/.tailii/sessions`）。 */
+export function defaultSessionsBase() {
+    return path.join(os.homedir(), ".tailii", "sessions");
+}
+/**
+ * セッションメタデータの永続ストア（cwd 権威記録）。
+ * 1 ファイル 1 セッション（`<base>/<name>.json`）。テストは一時 dir を注入する。
+ */
+export class SessionMetadataStore {
+    base;
+    constructor(base) {
+        this.base = base ?? defaultSessionsBase();
+    }
+    /** セッションメタデータを保存する（同一 name は上書き）。 */
+    put(meta) {
+        validateSessionName(meta.name);
+        ensureDirectory0700(this.base);
+        const payload = JSON.stringify(
+        // sortedKeys 相当。任意キーは指定時のみ書く（後方互換: 未指定は従来どおりのキー構成）。
+        {
+            ...(meta.agent !== undefined ? { agent: meta.agent } : {}),
+            ...(meta.claudeSessionId !== undefined ? { claudeSessionId: meta.claudeSessionId } : {}),
+            createdAt: meta.createdAt,
+            cwd: meta.cwd,
+            name: meta.name,
+        });
+        const target = this.fileFor(meta.name);
+        const tmp = target + ".tmp";
+        fs.writeFileSync(tmp, payload);
+        fs.renameSync(tmp, target); // atomic 相当
+    }
+    /** 指定 name のメタデータ。存在しない / 読めない場合は null（throw しない設計）。 */
+    get(name) {
+        try {
+            validateSessionName(name);
+        }
+        catch {
+            return null;
+        }
+        try {
+            const raw = JSON.parse(fs.readFileSync(this.fileFor(name), "utf8"));
+            return decodeMeta(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** 保存済みの全メタデータ（壊れたファイルは無視、順序不定）。 */
+    all() {
+        let entries;
+        try {
+            entries = fs.readdirSync(this.base);
+        }
+        catch {
+            return [];
+        }
+        const result = [];
+        for (const entry of entries) {
+            if (!entry.endsWith(".json") || entry.startsWith("."))
+                continue;
+            try {
+                const raw = JSON.parse(fs.readFileSync(path.join(this.base, entry), "utf8"));
+                const meta = decodeMeta(raw);
+                if (meta)
+                    result.push(meta);
+            }
+            catch {
+                // 壊れたファイルは無視して全体を落とさない。
+            }
+        }
+        return result;
+    }
+    fileFor(name) {
+        return path.join(this.base, `${name}.json`);
+    }
+}
+function decodeMeta(raw) {
+    if (typeof raw !== "object" || raw === null)
+        return null;
+    const obj = raw;
+    if (typeof obj["name"] !== "string" ||
+        typeof obj["cwd"] !== "string" ||
+        typeof obj["createdAt"] !== "number") {
+        return null;
+    }
+    const agent = obj["agent"] === "codex" || obj["agent"] === "claude" ? obj["agent"] : undefined;
+    const claudeSessionId = typeof obj["claudeSessionId"] === "string" ? obj["claudeSessionId"] : undefined;
+    return {
+        name: obj["name"],
+        cwd: obj["cwd"],
+        createdAt: obj["createdAt"],
+        ...(agent !== undefined ? { agent } : {}),
+        ...(claudeSessionId !== undefined ? { claudeSessionId } : {}),
+    };
+}
+//# sourceMappingURL=sessionMetadataStore.js.map

package/dist/sessionMetadataStore.js.map

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

package/dist/sessionSearch.d.ts

@@ -0,0 +1,29 @@
+import type { ClaudeSessionInfo, SessionSearchResult } from "./protocol.js";
+export interface SessionSearchSource {
+    list(): ClaudeSessionInfo[];
+    transcriptPath(sessionId: string): string | null;
+}
+export interface SessionSearchOptions {
+    limit?: number;
+    nowMs?: () => number;
+    timeBudgetMs?: number;
+    perFileBytes?: number;
+    fileCountLimit?: number;
+    snippetContextChars?: number;
+}
+export interface SessionSearchStats {
+    scannedFiles: number;
+    truncated: boolean;
+}
+export interface SessionSearchResponse {
+    results: SessionSearchResult[];
+    stats: SessionSearchStats;
+}
+export declare const SESSION_SEARCH_DEFAULT_LIMIT = 20;
+export declare const SESSION_SEARCH_MAX_LIMIT = 100;
+export declare const SESSION_SEARCH_TIME_BUDGET_MS = 120;
+export declare const SESSION_SEARCH_PER_FILE_BYTES: number;
+export declare const SESSION_SEARCH_FILE_COUNT_LIMIT = 1000;
+export declare const SESSION_SEARCH_SNIPPET_CONTEXT_CHARS = 40;
+/** Claude 会話 jsonl の user/assistant テキストだけを対象に、大文字小文字を無視して部分一致検索する。 */
+export declare function searchClaudeSessions(store: SessionSearchSource, query: string, options?: SessionSearchOptions): SessionSearchResponse;

package/dist/sessionSearch.js

@@ -0,0 +1,139 @@
+// sessionSearch.ts
+// tailii (TS host) — Claude Code 会話本文の横断検索（session_search）
+import * as fs from "node:fs";
+export const SESSION_SEARCH_DEFAULT_LIMIT = 20;
+export const SESSION_SEARCH_MAX_LIMIT = 100;
+export const SESSION_SEARCH_TIME_BUDGET_MS = 120;
+export const SESSION_SEARCH_PER_FILE_BYTES = 1024 * 1024;
+export const SESSION_SEARCH_FILE_COUNT_LIMIT = 1000;
+export const SESSION_SEARCH_SNIPPET_CONTEXT_CHARS = 40;
+/** Claude 会話 jsonl の user/assistant テキストだけを対象に、大文字小文字を無視して部分一致検索する。 */
+export function searchClaudeSessions(store, query, options = {}) {
+    const normalizedQuery = query.trim().toLocaleLowerCase();
+    if (normalizedQuery.length === 0) {
+        return { results: [], stats: { scannedFiles: 0, truncated: false } };
+    }
+    const requested = options.limit ?? SESSION_SEARCH_DEFAULT_LIMIT;
+    const limit = clampLimit(requested);
+    const nowMs = options.nowMs ?? (() => Date.now());
+    const deadline = nowMs() + (options.timeBudgetMs ?? SESSION_SEARCH_TIME_BUDGET_MS);
+    const perFileBytes = options.perFileBytes ?? SESSION_SEARCH_PER_FILE_BYTES;
+    const fileCountLimit = options.fileCountLimit ?? SESSION_SEARCH_FILE_COUNT_LIMIT;
+    const snippetContext = options.snippetContextChars ?? SESSION_SEARCH_SNIPPET_CONTEXT_CHARS;
+    const sessions = store.list();
+    const results = [];
+    let scannedFiles = 0;
+    let truncated = false;
+    for (const info of sessions) {
+        if (results.length >= limit)
+            break;
+        if (scannedFiles >= fileCountLimit) {
+            truncated = true;
+            break;
+        }
+        if (nowMs() > deadline) {
+            truncated = true;
+            break;
+        }
+        const filePath = store.transcriptPath(info.sessionId);
+        if (filePath === null)
+            continue;
+        scannedFiles += 1;
+        const match = searchTranscriptFile(filePath, normalizedQuery, perFileBytes, snippetContext);
+        if (match === null)
+            continue;
+        const result = {
+            sessionId: info.sessionId,
+            title: info.title,
+            cwd: info.cwd,
+            snippet: match,
+        };
+        if (info.updatedAt !== undefined)
+            result.updatedAt = info.updatedAt;
+        results.push(result);
+    }
+    return { results, stats: { scannedFiles, truncated } };
+}
+function clampLimit(value) {
+    if (!Number.isFinite(value))
+        return SESSION_SEARCH_DEFAULT_LIMIT;
+    return Math.max(1, Math.min(SESSION_SEARCH_MAX_LIMIT, Math.floor(value)));
+}
+function searchTranscriptFile(filePath, normalizedQuery, byteLimit, snippetContext) {
+    let content;
+    try {
+        const fd = fs.openSync(filePath, "r");
+        try {
+            const size = Math.max(0, Math.min(byteLimit, fs.fstatSync(fd).size));
+            const buf = Buffer.alloc(size);
+            const bytesRead = fs.readSync(fd, buf, 0, size, 0);
+            content = buf.subarray(0, bytesRead).toString("utf8");
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return null;
+    }
+    for (const line of content.split("\n")) {
+        if (!line)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (typeof parsed !== "object" || parsed === null)
+            continue;
+        const obj = parsed;
+        if (obj["type"] !== "user" && obj["type"] !== "assistant")
+            continue;
+        const text = extractMessageText(obj);
+        if (text === null)
+            continue;
+        const normalizedText = text.toLocaleLowerCase();
+        const index = normalizedText.indexOf(normalizedQuery);
+        if (index < 0)
+            continue;
+        return makeSnippet(text, index, normalizedQuery.length, snippetContext);
+    }
+    return null;
+}
+function extractMessageText(obj) {
+    const message = obj["message"];
+    if (typeof message !== "object" || message === null)
+        return null;
+    const content = message["content"];
+    const parts = [];
+    if (typeof content === "string") {
+        parts.push(content);
+    }
+    else if (Array.isArray(content)) {
+        for (const element of content) {
+            if (typeof element === "string") {
+                parts.push(element);
+            }
+            else if (typeof element === "object" && element !== null) {
+                const block = element;
+                const blockType = block["type"];
+                const text = block["text"];
+                if ((blockType === undefined || blockType === "text") && typeof text === "string") {
+                    parts.push(text);
+                }
+            }
+        }
+    }
+    const text = parts.join(" ").replaceAll("\r", " ").replaceAll("\n", " ").trim();
+    return text.length > 0 ? text : null;
+}
+function makeSnippet(text, matchIndex, matchLength, context) {
+    const start = Math.max(0, matchIndex - context);
+    const end = Math.min(text.length, matchIndex + matchLength + context);
+    const prefix = start > 0 ? "..." : "";
+    const suffix = end < text.length ? "..." : "";
+    return `${prefix}${text.slice(start, end)}${suffix}`.replaceAll(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=sessionSearch.js.map

package/dist/sessionSearch.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,83 @@
+import * as os from "node:os";
+/** ペアリング payload の入力（v は sessionName の有無で 2/1 が決まる）。 */
+export interface PairingPayloadInput {
+    host: string;
+    port: number;
+    user: string;
+    /** 秘密鍵 PEM 全文。 */
+    key: string;
+    /** 指定で v2。 */
+    sessionName?: string;
+    /** v2 のみ。未指定なら JSON から省略される。 */
+    sessionCwd?: string;
+}
+/**
+ * ペアリング payload を Swift `JSONEncoder`（`.prettyPrinted + .sortedKeys`）と byte 一致で符号化する。
+ * 末尾改行は含めない（呼び出し側が付与）。golden `protocol/pairing-payload-v{1,2}.json` と契約整合。
+ */
+export declare function encodePairingPayload(input: PairingPayloadInput): string;
+/**
+ * LAN の IPv4 アドレスを検出する（en0 → en1 → 最初の非内部 IPv4 の順）。取得不能なら空文字。
+ * Swift 版の `ipconfig getifaddr en0/en1` 相当をクロスプラットフォームに一般化したもの。
+ */
+export declare function detectLanIP(interfaces?: NodeJS.Dict<os.NetworkInterfaceInfo[]>): string;
+/**
+ * Tailscale の IPv4（CGNAT レンジ `100.64.0.0/10`）を検出する。無ければ空文字。
+ * Tailscale は自身に 100.64.0.0〜100.127.255.255 のアドレスを割り当てる。
+ */
+export declare function detectTailscaleIP(interfaces?: NodeJS.Dict<os.NetworkInterfaceInfo[]>): string;
+/**
+ * ペアリングに使う「最も繋がりやすい」ホストを自動選定する。
+ * Tailscale が上がっていればその IP（tailnet の全端末から到達可・LAN 外でも成立）を優先し、
+ * 無ければ LAN IP へフォールバックする。ユーザーが経路（Tailscale か LAN か）を意識せずに済む。
+ */
+export declare function detectPreferredIP(interfaces?: NodeJS.Dict<os.NetworkInterfaceInfo[]>): string;
+/** authorized_keys 登録の結果。 */
+export type AuthorizedKeyResult = "added" | "already-present";
+/**
+ * 公開鍵行を `<sshDir>/authorized_keys` に登録する（既存なら何もしない）。
+ * ディレクトリは 0700、ファイルは 0600 で保存する（Swift 版パリティ）。
+ *
+ * @param sshDir `~/.ssh` 相当のディレクトリ（テストは一時 dir を注入）。
+ * @param pubLine 登録する公開鍵行（前後空白は呼び出し側で trim 済み想定）。
+ */
+export declare function registerAuthorizedKey(sshDir: string, pubLine: string): AuthorizedKeyResult;
+/** 鍵ペア用意の結果。 */
+export interface EnsureKeypairResult {
+    status: "generated" | "reused";
+    /** 秘密鍵 PEM 全文。 */
+    privateKeyPem: string;
+    /** 公開鍵行（trim 済み）。 */
+    publicKeyLine: string;
+}
+/**
+ * `<base>/poc_id_ed25519{,.pub}` の鍵ペアを用意する。無ければ `keygen` を呼んで生成する。
+ * base は 0700 で作成する。テストは `keygen` にダミー鍵書き出しを注入して ssh-keygen を回避できる。
+ *
+ * @param base `~/.tailii` 相当のディレクトリ。
+ * @param keygen 鍵が無いとき `keyPath` に ed25519 鍵ペア（keyPath と keyPath+".pub"）を生成する関数。
+ */
+export declare function ensureKeypair(base: string, keygen: (keyPath: string) => void): EnsureKeypairResult;
+/** 実 `ssh-keygen` で ed25519 鍵ペアを生成する（本番 keygen）。 */
+export declare function sshKeygenEd25519(keyPath: string): void;
+export interface EmitPayloadOptions {
+    /** `~/.tailii` 相当のディレクトリ。 */
+    base: string;
+    username: string;
+    lanIP: string;
+    sessionName?: string;
+    sessionCwd?: string;
+}
+/**
+ * `--emit-payload` の純ロジック。副作用なしで payload JSON（末尾改行なし）を返す。
+ * 既存の秘密鍵があれば読み、無ければ Swift 版と同じ擬似値で継続する（形状検査が目的）。
+ */
+export declare function emitPayloadJSON(options: EmitPayloadOptions): string;
+/**
+ * setup サブコマンドの CLI エントリポイント。
+ *
+ * `--emit-payload`: 副作用なしで payload JSON を stdout に出力（byte-exact 契約）。
+ * 通常モード: ed25519 鍵生成（無ければ）→ authorized_keys 登録 → payload をターミナル QR ＋ JSON で表示。
+ * `--code`: 同じ副作用の後、TCP で pairing-code v1 responder を 1 回だけ実行する。
+ */
+export declare function runSetupCommand(argv: string[]): Promise<number>;