tailii-host 0.1.0

package/dist/dirLister.js

@@ -0,0 +1,98 @@
+// dirLister.ts
+// tailii (TS host) — baseDir 配下限定のディレクトリ列挙/作成 + 非限定ブラウズ
+// Swift 版 DirLister.swift の移植（session-workdir 4.x/5.x, dir-create, dir-picker 1.1）。
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isInsideBase, standardize } from "./paths.js";
+/** `baseDir/<partial の親>` 直下のサブディレクトリ名を prefix 一致で返す（base 外・不正は空）。 */
+export function dirList(baseDir, partial) {
+    if (!baseDir)
+        return [];
+    // 絶対/`~` 直接指定は base 外（サジェスト対象外, 5.3/5.4）。
+    if (partial.startsWith("/") || partial.startsWith("~"))
+        return [];
+    // partial を親と未完セグメント（prefix）へ分割する。
+    const slashIdx = partial.lastIndexOf("/");
+    const parent = slashIdx >= 0 ? partial.slice(0, slashIdx) : "";
+    const prefix = slashIdx >= 0 ? partial.slice(slashIdx + 1) : partial;
+    // baseDir/<parent> を正準化し、base 内側であることを確認する（`..` 脱出を拒否, 5.3）。
+    const base = standardize(baseDir);
+    const parentPath = standardize(parent === "" ? base : base + "/" + parent);
+    if (!isInsideBase(parentPath, base))
+        return [];
+    let names;
+    try {
+        names = fs.readdirSync(parentPath);
+    }
+    catch {
+        return [];
+    }
+    // 隠し dir は prefix が `.` 始まりのときのみ含める（4.7）。
+    const includeHidden = prefix.startsWith(".");
+    const result = [];
+    for (const name of names) {
+        if (name.startsWith(".") && !includeHidden)
+            continue;
+        if (!name.startsWith(prefix))
+            continue;
+        try {
+            if (!fs.statSync(path.join(parentPath, name)).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        result.push(name);
+    }
+    return result.sort();
+}
+/** `baseDir` 配下限定で `relative` ディレクトリを作成する（base 外・不正・失敗は ok=false）。 */
+export function dirCreate(baseDir, relative) {
+    if (!baseDir)
+        return { path: "", ok: false };
+    if (relative.startsWith("/") || relative.startsWith("~"))
+        return { path: "", ok: false };
+    const trimmed = relative.trim();
+    if (!trimmed)
+        return { path: "", ok: false };
+    const base = standardize(baseDir);
+    const target = standardize(base + "/" + trimmed);
+    // base 内側（かつ base 自体でない）のみ許可（`..` 脱出を拒否）。
+    if (target === base || !isInsideBase(target, base))
+        return { path: target, ok: false };
+    try {
+        fs.mkdirSync(target, { recursive: true });
+        return { path: target, ok: true };
+    }
+    catch {
+        return { path: target, ok: false };
+    }
+}
+/** 絶対パス直下のサブディレクトリ名を非限定で列挙する（隠し dir とファイルは除外、ソート済み）。 */
+export function dirChildren(absolutePath) {
+    if (!absolutePath)
+        return [];
+    const dir = standardize(absolutePath);
+    let names;
+    try {
+        names = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const result = [];
+    for (const name of names) {
+        if (name.startsWith("."))
+            continue;
+        try {
+            if (!fs.statSync(path.join(dir, name)).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        result.push(name);
+    }
+    return result.sort();
+}
+//# sourceMappingURL=dirLister.js.map

package/dist/dirLister.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,36 @@
+/** シム生成の結果。 */
+export type ShimResult = "created" | "updated" | "unchanged" | "skipped-foreign";
+/** シムの内容を組み立てる（node 絶対パス + cli.js 絶対パス固定）。 */
+export declare function shimContent(nodePath: string, cliPath: string): string;
+/**
+ * `<binDir>/tailii-host` シムを生成する（冪等）。
+ * 既存内容が一致すれば何もしない。マーカーの無い既存ファイルは上書きしない
+ * （ユーザーが自前管理しているシムを壊さないため）。
+ */
+export declare function ensureHostShim(binDir: string, nodePath: string, cliPath: string): ShimResult;
+/** この実行自身の dist/cli.js 絶対パス（シムの exec 先）。 */
+export declare function resolveOwnCliPath(): string;
+/** 既定のシム設置ディレクトリ（iOS 側 `HostControlCommand` の規約と対）。 */
+export declare function defaultShimBinDir(): string;
+/**
+ * PATH 文字列からコマンドの実体を探す（`command -v` 相当）。見つからなければ null。
+ */
+export declare function findCommand(name: string, envPath: string): string | null;
+/** TCP ポートへ接続できるか（リモートログイン=sshd の稼働検査に使う）。 */
+export declare function checkTcpPort(host: string, port: number, timeoutMs?: number): Promise<boolean>;
+/** 1 検査項目の結果。 */
+export interface DoctorCheck {
+    /** 表示名。 */
+    label: string;
+    ok: boolean;
+    /** 必須項目か（false は情報提供のみで exit code に影響しない）。 */
+    required: boolean;
+    /** 詳細（見つかったパス、または直し方のヒント）。 */
+    detail: string;
+}
+/** 全検査を実行する（副作用なし・シムは検査のみ）。 */
+export declare function collectDoctorChecks(envPath?: string): Promise<DoctorCheck[]>;
+/** 検査結果を人間向けに整形する。 */
+export declare function formatDoctorChecks(checks: DoctorCheck[]): string;
+/** `tailii doctor` エントリポイント。必須項目に ✗ があれば 1 を返す。 */
+export declare function runDoctorCommand(_argv: string[]): Promise<number>;

package/dist/doctor.js

@@ -0,0 +1,162 @@
+// doctor.ts — 環境診断とホストシムの自動生成
+//
+// iPhone アプリは SSH 非対話シェルから `~/.local/bin/tailii-host` を exec する。
+// 非対話シェルでは node が PATH に乗らないため、node 絶対パスを埋めた薄いシムを
+// `tailii setup` が自動生成する（従来は手書き手順だった）。
+//
+// あわせて `tailii doctor` として、初回セットアップで詰まりやすい前提
+// （tmux / claude / codex CLI・リモートログイン・シム）を機械検査する。
+// 検査は launch.ts が SSH exec に注入するのと同じ PATH（defaultInjectedPath）で行う。
+// エージェント側の実行環境と同じ条件で探すことで「ターミナルでは見えるが
+// SSH 経由では見えない」タイプの偽陽性を避ける。
+import * as fs from "node:fs";
+import * as net from "node:net";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { defaultInjectedPath } from "./launch.js";
+/** 生成マーカー。これを含まない既存ファイルはユーザー管理とみなし上書きしない。 */
+const SHIM_MARKER = "Tailii host launcher";
+/** シムの内容を組み立てる（node 絶対パス + cli.js 絶対パス固定）。 */
+export function shimContent(nodePath, cliPath) {
+    return ("#!/bin/sh\n" +
+        `# ${SHIM_MARKER} — generated by \`tailii setup\` (safe to regenerate)\n` +
+        `exec "${nodePath}" "${cliPath}" "$@"\n`);
+}
+/**
+ * `<binDir>/tailii-host` シムを生成する（冪等）。
+ * 既存内容が一致すれば何もしない。マーカーの無い既存ファイルは上書きしない
+ * （ユーザーが自前管理しているシムを壊さないため）。
+ */
+export function ensureHostShim(binDir, nodePath, cliPath) {
+    fs.mkdirSync(binDir, { recursive: true });
+    const shimPath = path.join(binDir, "tailii-host");
+    const content = shimContent(nodePath, cliPath);
+    let existing = null;
+    try {
+        existing = fs.readFileSync(shimPath, "utf8");
+    }
+    catch {
+        existing = null;
+    }
+    if (existing === content) {
+        fs.chmodSync(shimPath, 0o755);
+        return "unchanged";
+    }
+    if (existing !== null && !existing.includes(SHIM_MARKER))
+        return "skipped-foreign";
+    fs.writeFileSync(shimPath, content, { mode: 0o755 });
+    fs.chmodSync(shimPath, 0o755);
+    return existing === null ? "created" : "updated";
+}
+/** この実行自身の dist/cli.js 絶対パス（シムの exec 先）。 */
+export function resolveOwnCliPath() {
+    return path.join(path.dirname(fileURLToPath(import.meta.url)), "cli.js");
+}
+/** 既定のシム設置ディレクトリ（iOS 側 `HostControlCommand` の規約と対）。 */
+export function defaultShimBinDir() {
+    return path.join(os.homedir(), ".local/bin");
+}
+// MARK: - 環境検査（テスタブル）
+/**
+ * PATH 文字列からコマンドの実体を探す（`command -v` 相当）。見つからなければ null。
+ */
+export function findCommand(name, envPath) {
+    for (const dir of envPath.split(":")) {
+        if (dir === "")
+            continue;
+        const candidate = path.join(dir, name);
+        try {
+            fs.accessSync(candidate, fs.constants.X_OK);
+            if (fs.statSync(candidate).isFile() || fs.lstatSync(candidate).isSymbolicLink())
+                return candidate;
+        }
+        catch {
+            // 次の PATH エントリへ。
+        }
+    }
+    return null;
+}
+/** TCP ポートへ接続できるか（リモートログイン=sshd の稼働検査に使う）。 */
+export function checkTcpPort(host, port, timeoutMs = 1500) {
+    return new Promise((resolve) => {
+        const socket = net.connect({ host, port });
+        const done = (ok) => {
+            socket.destroy();
+            resolve(ok);
+        };
+        socket.setTimeout(timeoutMs, () => done(false));
+        socket.once("connect", () => done(true));
+        socket.once("error", () => done(false));
+    });
+}
+/** 全検査を実行する（副作用なし・シムは検査のみ）。 */
+export async function collectDoctorChecks(envPath = defaultInjectedPath()) {
+    const checks = [];
+    const nodeMajor = Number(process.versions.node.split(".")[0]);
+    checks.push({
+        label: "Node.js 20+",
+        ok: nodeMajor >= 20,
+        required: true,
+        detail: `v${process.versions.node}`,
+    });
+    const tmux = findCommand("tmux", envPath);
+    checks.push({
+        label: "tmux",
+        ok: tmux !== null,
+        required: true,
+        detail: tmux ?? "見つかりません。`brew install tmux` 等で導入してください",
+    });
+    const claude = findCommand("claude", envPath);
+    const codex = findCommand("codex", envPath);
+    checks.push({
+        label: "claude CLI",
+        // どちらかのエージェント CLI があれば必須要件は満たす（claude 無しの codex 運用も許す）。
+        ok: claude !== null,
+        required: codex === null,
+        detail: claude ?? "見つかりません。https://claude.com/claude-code から導入してください",
+    });
+    checks.push({
+        label: "codex CLI(任意)",
+        ok: codex !== null,
+        required: false,
+        detail: codex ?? "未導入(Codex セッションを使う場合のみ必要)",
+    });
+    const sshdUp = await checkTcpPort("127.0.0.1", 22);
+    checks.push({
+        label: "リモートログイン(sshd:22)",
+        ok: sshdUp,
+        required: true,
+        detail: sshdUp
+            ? "接続可"
+            : "接続不可。システム設定 → 一般 → 共有 → リモートログイン を ON にしてください",
+    });
+    const shimPath = path.join(defaultShimBinDir(), "tailii-host");
+    const shimOk = fs.existsSync(shimPath);
+    checks.push({
+        label: "ホストシム(~/.local/bin/tailii-host)",
+        ok: shimOk,
+        required: true,
+        detail: shimOk ? shimPath : "未生成。`tailii setup` を実行すると自動生成されます",
+    });
+    return checks;
+}
+/** 検査結果を人間向けに整形する。 */
+export function formatDoctorChecks(checks) {
+    return checks
+        .map((c) => `  ${c.ok ? "✓" : c.required ? "✗" : "-"} ${c.label} : ${c.detail}`)
+        .join("\n");
+}
+/** `tailii doctor` エントリポイント。必須項目に ✗ があれば 1 を返す。 */
+export async function runDoctorCommand(_argv) {
+    const checks = await collectDoctorChecks();
+    process.stdout.write("Tailii 環境診断:\n" + formatDoctorChecks(checks) + "\n");
+    const failed = checks.filter((c) => c.required && !c.ok);
+    if (failed.length > 0) {
+        process.stdout.write(`必須項目 ${failed.length} 件が未充足です。上のヒントに従って解消してください。\n`);
+        return 1;
+    }
+    process.stdout.write("問題は見つかりませんでした。\n");
+    return 0;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,85 @@
+import type { Readable, Writable } from "node:stream";
+import { type ChatAgent } from "./chatTailController.js";
+import { CodexRolloutTailer } from "./codexRolloutTailer.js";
+import { ClaudeSessionStore } from "./claudeSessionStore.js";
+import { CodexSessionStore } from "./codexSessionStore.js";
+import { ImageService } from "./imageService.js";
+import { type EngineLauncher } from "./launch.js";
+import { type PlanUsageProvider } from "./planUsageFetcher.js";
+import { SessionIdleTracker } from "./sessionIdleTracker.js";
+import { SessionListService } from "./sessionListService.js";
+import { SessionMetadataStore } from "./sessionMetadataStore.js";
+import { TranscriptTailer } from "./transcriptTailer.js";
+import { TmuxSessionManager } from "./tmux.js";
+import { type StaleDistGuard } from "./version.js";
+/**
+ * engine サブコマンドのエントリポイント。実 stdin/stdout を使って EngineControl を起動する。
+ * 引数（省略可、統合テスト注入用）: --sessions-dir / --inner-command / --images-dir /
+ * --transcript / --claude-projects-dir / --idle-timeout / --resume-command。
+ */
+/**
+ * 既定エージェントを host 側設定から解決する（`--agent` 未指定時のフォールバック）。
+ * `~/.tailii/agent` の内容が `codex` なら codex、それ以外/不在は claude。
+ * これにより iOS を改修せず（engine 起動コマンドは `<binary> engine` のまま）codex に切替できる。
+ */
+export declare function resolveDefaultAgent(agentFilePath?: string): ChatAgent;
+export declare function runEngineCommand(args: string[]): Promise<number>;
+export interface RunEngineOptions {
+    /** "stdin" 側（iOS→Mac の制御要求が流れてくる）。 */
+    input: Readable;
+    /** "stdout" 側（Mac→iOS の応答を流す）。 */
+    output: Writable;
+    sessionManager: TmuxSessionManager;
+    /** 画像通知/取得の橋渡し（省略時は画像処理なし = 後方互換）。 */
+    imageService?: ImageService | null;
+    /** 会話出力キャプチャ（省略時は chat_output なし = 後方互換）。 */
+    transcriptTailer?: TranscriptTailer | null;
+    /** tail 対象の claude セッショントランスクリプト JSONL の絶対パス。 */
+    transcriptPath?: string | null;
+    /** session_start の橋渡し先。省略時（null）は error(launch_failed) を返す安全側既定。 */
+    launcher?: EngineLauncher | null;
+    /** codex セッション用 launcher（agentType=codex 時）。省略時は launcher にフォールバック。 */
+    codexLauncher?: EngineLauncher | null;
+    sessionListService?: SessionListService | null;
+    metadataStore?: SessionMetadataStore | null;
+    idleTracker?: SessionIdleTracker | null;
+    resumeLauncher?: EngineLauncher | null;
+    /** codex セッションの reattach 時 resume 用 launcher。省略時は resumeLauncher にフォールバック。 */
+    codexResumeLauncher?: EngineLauncher | null;
+    claudeSessionStore?: ClaudeSessionStore | null;
+    /** codex 会話一覧の導出（agent-tag）。省略時は codex 会話を一覧に含めない（後方互換）。 */
+    codexSessionStore?: CodexSessionStore | null;
+    reaperCheckIntervalSeconds?: number;
+    /** セッション連動 chat_output tail の projects ルート（--transcript 指定時は使わない）。 */
+    chatTailProjectsRoot?: string | null;
+    /** 対象エージェント（既定 claude）。codex は rollout tail を使う。 */
+    agent?: ChatAgent;
+    /** codex モードの rollout tailer（テスト注入用。省略時は既定ルートで自動生成）。 */
+    codexTailer?: CodexRolloutTailer;
+    /** 自分がサポートする最大版（既定 PROTOCOL_MAX_SUPPORTED）。 */
+    maxVersion?: number;
+    /** プラン使用状況の取得（既定は実 OAuth 使用量 API。テストは () => null を注入する）。 */
+    planUsage?: PlanUsageProvider;
+    /** slash_list のユーザーレベル探索ルート（既定は os.homedir()）。 */
+    homeDir?: string;
+    /** mode_get/mode_set の待機間隔（テストは短縮値を注入する）。 */
+    modeTiming?: Partial<ModeTiming>;
+    /** 起動時 package version と現在の package version を比較する stale 判定（テスト注入用）。 */
+    staleDistGuard?: StaleDistGuard | null;
+    /** stale dist 検出時の通知（CLI では return によりプロセス終了、テストは観測用）。 */
+    onStaleDist?: () => void;
+}
+interface ModeTiming {
+    getPollMs: number;
+    getAttempts: number;
+    setInitialPollMs: number;
+    setInitialTimeoutMs: number;
+    setChangePollMs: number;
+    setChangeTimeoutMs: number;
+}
+/**
+ * EngineControl の本体。`input` から NDJSON 行を読み、session_* を `sessionManager` に
+ * 橋渡しし、応答を `output` へ NDJSON 行で書く。EOF（input end）で正常終了する。
+ */
+export declare function runEngine(options: RunEngineOptions): Promise<void>;
+export {};