tailii-host 0.1.0 → 0.3.0

package/README.md

@@ -1,28 +1,40 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/namasugi/tailii-host/main/assets/tailii-logo.png" alt="Tailii" width="480">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/tailii-host"><img src="https://img.shields.io/npm/v/tailii-host" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="license MIT"></a>
+</p>
+
 # tailii-host
 
-Tailii is an iPhone app for controlling Claude Code and Codex sessions running on your own Mac.
+Tailii is an iPhone app for controlling Claude Code and Codex sessions running on your own machine.
 
-`tailii-host` は、Tailii iPhone アプリと Mac 上の Claude Code / Codex セッションをつなぐホスト側ヘルパーです。Mac 側で `npx tailii-host setup` を実行してペアリングします。
+`tailii-host` は、Tailii iPhone アプリとホストマシン上の Claude Code / Codex セッションをつなぐホスト側ヘルパーです。ホスト側で `npx tailii-host setup` を実行してペアリングします。
 
 ## Requirements
 
 - Node.js 20 以上
-- macOS
-- tmux
-- `claude` CLI (Claude Code) がインストール済みでログイン済みであること
+- macOS または Linux（QUIC ゲートウェイは macOS のみ）
+- tmux(任意で herdr — セッション収容先をアプリ設定から herdr に切り替えられます)
+- SSH サーバーが有効であること(macOS では「リモートログイン」を ON)
+- `claude` CLI (Claude Code) がインストール済みでログイン済みであること(Codex を使う場合は `codex` CLI)
 - Tailii iPhone アプリ
 
 ## Quick start
 
-Mac で次のコマンドを実行します。
+ホストマシンで次のコマンドを実行します。
 
 ```sh
 npx tailii-host setup
 ```
 
-表示された QR コードを Tailii アプリで読み取るか、表示されたコードをアプリに入力してペアリングします。
+表示された QR コードを Tailii アプリで読み取るか、表示された `host:port` と 6 桁コードをアプリに入力してペアリングします。
+
+SSH 鍵は **iPhone 側で生成され、その公開鍵だけがホストの `~/.ssh/authorized_keys` に登録されます**（秘密鍵はネットワークにも QR にも載りません）。QR には接続先とワンタイムの共有鍵だけが入っており、**`setup` の実行中のみ有効**で 1 回のペアリングで失効します。うまくいかなかったときは `setup` をやり直してください。
 
-`setup` は、アプリが SSH 経由で実行するランチャー(`~/.local/bin/tailii-host`)を自動生成し、あわせて環境診断(tmux / claude CLI / リモートログイン)を表示します。診断だけを再実行するには:
+`setup` は、アプリが SSH 経由で実行するランチャー(`~/.local/bin/tailii-host`)を自動生成し、あわせて環境診断を表示します。Node.js / Claude / Codex / herdr の対応最低版、tmux、SSH サーバー、ランチャーを検査し、OS と検出できたパッケージマネージャーに合わせた導入/更新コマンドを案内します。macOS では任意の QUIC 環境も検査し、Linux では macOS 専用項目を表示しません。診断だけを再実行するには:
 
 ```sh
 npx tailii-host doctor
@@ -30,21 +42,30 @@ npx tailii-host doctor
 
 ## How it works
 
-Tailii はサーバーレス構成で動作し、リレーサーバーは使いません。Mac への到達性は自宅 LAN や Tailscale など、ユーザー自身のネットワーク環境で確保します。
+Tailii はサーバーレス構成で動作し、リレーサーバーは使いません。ホストへの到達性は自宅 LAN や Tailscale など、ユーザー自身のネットワーク環境で確保します。
+
+接続は SSH が基本です。macOS ホストでは、これに加えて QUIC ゲートウェイ(Rust / quinn)を launchd に常駐させ、Wi-Fi ↔ モバイル回線の切り替えやスリープ復帰をまたいでも会話が切れない、mosh 的なトランスポートとして利用できます。QUIC が使えない環境では自動的に SSH へフォールバックします。ゲートウェイの prebuilt バイナリは optionalDependencies(`@tailii/quic-gw-darwin-arm64` / `@tailii/quic-gw-darwin-x64`)として配布され、`setup` が設置から常駐化まで行います。
+
+承認フローでは Claude Code の PreToolUse hook を使い、ツール実行を一時停止して構造化イベントを iPhone に転送します。ユーザーは iPhone アプリ上でネイティブに承認または拒否できます。セッションは tmux(または herdr)により維持されるため、接続が切れても継続できます。
+
+接続中の出来事は iPhone 側のローカル通知で知らせます。バックグラウンド push 通知は現在準備中の実験的機能で、既定では無効です(ホスト側に APNs 設定が無い場合、送信は行われません)。
 
-承認フローでは Claude Code の PreToolUse hook を使い、ツール実行を一時停止して構造化イベントを iPhone に転送します。ユーザーは iPhone アプリ上でネイティブに承認または拒否できます。セッションは tmux により維持されるため、接続が切れても継続できます。バックグラウンド通知は Mac から APNs に直接送信されます。
+実行エンジンは、サブスクリプション認証済みの対話型 `claude` CLI(および `codex` CLI)です。Agent SDK やヘッドレス実行は使いません。
 
-実行エンジンは、サブスクリプション認証済みの対話型 `claude` CLI です。Agent SDK やヘッドレス実行は使いません。
+Tailii アプリの「使用量・情報」は、Claude / Codex のアカウント使用量とともに、ホストのバージョン・必須/任意診断・修復コマンドを表示します。診断は同シートの更新ごとに再実行されます。
 
 ## Commands
 
-- `setup`: メインのユーザー向けコマンドです。Mac と Tailii iPhone アプリをペアリングします。
+- `setup`: メインのユーザー向けコマンドです。ホストと Tailii iPhone アプリをペアリングし、アプリが生成した公開鍵を `authorized_keys` に登録します。
+- `doctor`: バージョン互換性、必須/任意のホスト環境、OS 別の導入/更新手順を診断します。
 - `engine`: Tailii が利用する実行エンジン関連の処理を行います。
-- `serve`: Mac 側ホストのローカルサーバーを起動します。
+- `serve`: ホスト側のローカルサーバーを起動します。
 - `hook`: Claude Code の hook から呼び出され、承認イベントを処理します。
-- `launch`: tmux-backed セッションを起動します。
+- `launch`: 端末バックエンド(tmux 既定 / herdr 任意)上にセッションを起動します。
 - `kick`: セッションやホスト側処理を再開・通知するために使われます。
 - `push-token`: iPhone アプリのプッシュ通知トークンを登録します。
+- `hub`: 会話状態・出力配信・入力調停とアイドルなセッション(tmux / herdr)の自動掃除を担う常駐デーモンです。engine 起動時や hook から自動起動されるため、通常は手動実行不要です。
+- `quic-info`: QUIC ゲートウェイの接続情報(ポート・証明書ピン・トークン)を出力します。アプリが SSH 経由で取得するために使う内部コマンドです。
 
 ## License
 

package/dist/{broker.d.ts → approval/broker.d.ts}

@@ -1,5 +1,5 @@
 import type { Readable, Writable } from "node:stream";
-import { type StaleDistGuard } from "./version.js";
+import { type StaleDistGuard } from "../shared/version.js";
 export interface RunBrokerOptions {
     socketPath: string;
     /** "stdin" 側（iOS→hook 方向の決定が流れてくる）。 */
@@ -14,11 +14,15 @@ export interface RunBrokerOptions {
     onStaleDist?: () => void;
     /** 起動直後に SSH 側へ channel_hello を送る（CLI の serve 経路で有効）。 */
     sendHello?: boolean;
+    /**
+     * 先発 listener の解放待ち猶予（ms）。iOS が chat 離脱で旧 serve チャネルを閉じた直後に
+     * 同一会話を開き直すと、旧 serve の終了（socket 解放）と新 serve の起動が競走する。
+     * 即失敗にせず短時間だけ解放を待って引き継ぐ（猶予内に解放されなければ従来どおり失敗）。
+     */
+    socketWaitGraceMs?: number;
+    /** 解放待ちの再確認間隔（ms）。 */
+    socketWaitIntervalMs?: number;
 }
-/**
- * unix socket と input/output の間を双方向中継する非解釈リレーの本体。
- * input EOF（SSH 断）で全クライアントを閉じ、socket ファイルを削除して resolve する。
- */
 export declare function runBroker(options: RunBrokerOptions): Promise<void>;
 /** serve サブコマンドのエントリポイント（`--session <name>` | `--socket <path>`）。 */
 export declare function runServeCommand(args: string[]): Promise<number>;

package/dist/{broker.js → approval/broker.js}

@@ -10,14 +10,16 @@
 //   - SSH→hook 方向は input の完全行を登録中の全クライアントへブロードキャスト
 //     （宛先選別なし＝各 hook が自 id を照合）。購読者ゼロ時は行を保持しない（非永続）。
 //   - channel_hello を含むあらゆる行を非解釈で透過する。
-//   - SSH 断（input EOF）→ 全クライアント socket を閉じ（各 hook EOF→deny, 5.6）、
+//   - SSH 断（input EOF）→ 全クライアント socket を閉じ（各 hook は EOF を切断と検知して
+//     retry-connect フォールバックへ, hook.ts 参照）、
 //     listen を止めて socket ファイルを削除して終了する。
 //   - EOF 時の残余バッファ（改行なしの部分行）は Swift 版同様そのまま転送する。
 import * as fs from "node:fs";
 import * as net from "node:net";
-import { resolveSocketPath } from "./socketPath.js";
-import { encodeControlMessage, PROTOCOL_MAX_SUPPORTED, PROTOCOL_V1 } from "./protocol.js";
-import { createStaleDistGuard, isStaleDist, readPackageVersion } from "./version.js";
+import { resolveSocketPath } from "../shared/socketPath.js";
+import { sleep } from "../shared/sleep.js";
+import { encodeControlMessage, PROTOCOL_MAX_SUPPORTED, PROTOCOL_V1 } from "../protocol.js";
+import { createStaleDistGuard, isStaleDist, readPackageVersion } from "../shared/version.js";
 /** 行分割器: チャンクを積み、完全行（末尾 \n 込み）ごとに onLine を呼ぶ。 */
 function makeLineFeeder(onLine) {
     let buf = Buffer.alloc(0);
@@ -42,11 +44,43 @@ function makeLineFeeder(onLine) {
  * unix socket と input/output の間を双方向中継する非解釈リレーの本体。
  * input EOF（SSH 断）で全クライアントを閉じ、socket ファイルを削除して resolve する。
  */
+/**
+ * `socketPath` に既に生きた listener がいるかを probe する（reject せず bool で返す）。
+ * 同一 session 名の serve が重複起動されうる（iOS 側の enterChat レース、または同一
+ * session を複数デバイスから同時に開いた場合）。無条件に unlink→listen すると生きている
+ * 側の listen 中ソケットを奪ってしまい、しかも Node の `net.Server.close()` は bind した
+ * パスを close 時に自動 unlink するため、奪われた側が閉じた瞬間に「今生きている方」の
+ * ソケットファイルまで消える（以後の hook connect が全て ECONNREFUSED になり、承認が
+ * 「考え中」のまま永久にハングする不具合の実根因）。奪う前に生存確認する。
+ */
+function isSocketAlive(socketPath) {
+    return new Promise((resolve) => {
+        const probe = net.connect(socketPath);
+        probe.once("connect", () => {
+            probe.destroy();
+            resolve(true);
+        });
+        probe.once("error", () => resolve(false));
+    });
+}
 export async function runBroker(options) {
     const { socketPath, input, output } = options;
     const log = options.log ?? (() => { });
     const staleDistGuard = options.staleDistGuard ?? createStaleDistGuard();
-    // 既存 socket ファイルを削除してから listen（Swift 版 unlink→bind と同一）。
+    // 既存 socket ファイルが生きていれば奪わず、まず解放を短時間待つ（chat 離脱→開き直しで
+    // 旧 serve の終了と競走するケースの吸収）。猶予内に解放されなければ従来どおり諦める
+    // （生きている正当な所有者からは決して奪わない, 上記コメント参照）。
+    // 生きていなければ（前回異常終了のスタール残骸）安全に削除して bind し直す
+    // （Swift 版 unlink→bind と同一の後始末）。
+    const graceMs = options.socketWaitGraceMs ?? 4000;
+    const intervalMs = options.socketWaitIntervalMs ?? 200;
+    const waitDeadline = Date.now() + graceMs;
+    while (await isSocketAlive(socketPath)) {
+        if (Date.now() >= waitDeadline) {
+            throw new Error(`socket already in use by a live listener: ${socketPath}`);
+        }
+        await sleep(intervalMs);
+    }
     fs.rmSync(socketPath, { force: true });
     const clients = new Set();
     let registryClosed = false;
@@ -59,8 +93,10 @@ export async function runBroker(options) {
         registryClosed = true;
         for (const client of clients)
             client.end();
+        // `net.Server.close()` は bind したパスの socket ファイルを自前で unlink するため
+        // （Node 内部仕様）、ここで追加の fs.rmSync は不要（かつ、上の isSocketAlive ガードにより
+        // このプロセスは常にこのパスの正当な唯一の所有者として起動しているため安全）。
         server.close(() => { });
-        fs.rmSync(socketPath, { force: true });
         resolveBroker?.();
     };
     /** 1 完全行を SSH (output) へ書き込む（失敗は無視 — Swift 版 try? と同一）。 */

package/dist/approval/broker.js.map

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

package/dist/{hook.d.ts → approval/hook.d.ts}

@@ -1,3 +1,5 @@
+import { type PushObserving } from "../push/approvalPushNotifier.js";
+import { type TmuxCommandRunner } from "../backend/tmux.js";
 /**
  * hook 内部デッドラインの既定値（秒）。settings の外部タイムアウト
  * （hookSettings.HOOK_EXTERNAL_TIMEOUT_SECONDS = 600）より**厳密に小さく**保つこと。
@@ -22,6 +24,12 @@ export interface ApprovalPushRequest {
  * 送信可否は deny 判断に影響しない（結果は捨てる）。本番実装は push-token 移植時に配線する。
  */
 export type ApprovalPushNotifier = (request: ApprovalPushRequest, timeLimitMs: number) => Promise<void>;
+export type PresenceReason = "mac-attached" | "client-live";
+export type PresenceProbe = (session: string) => Promise<PresenceReason | null>;
+/** presence 判定全体の上限。失敗・超過は push 送信へ倒す。 */
+export declare const PRESENCE_PROBE_TIME_LIMIT_MS = 500;
+/** Hub への使い捨て presence RPC の上限。 */
+export declare const HUB_PRESENCE_RPC_TIMEOUT_MS = 300;
 export interface RunHookOptions {
     stdinData: Buffer;
     /** 接続する unix socket パス。null は接続不能と同義（PreToolUse は即 deny）。 */
@@ -38,8 +46,27 @@ export interface RunHookOptions {
     notifier?: ApprovalPushNotifier;
     /** push 送信部の時間上限（ms）。gate 非阻害のためこの時間で打ち切る。既定 5000。 */
     notifierTimeLimitMs?: number;
+    /** 背景 push 前の presence 判定。例外・超過は不在扱いにせず fail-open で push する。 */
+    presenceProbe?: PresenceProbe;
+    /** presence により push を抑制した場合の観測先。 */
+    pushObserver?: Pick<PushObserving, "recordSkipped">;
+    /** connect 不能時に engine relay へ通知する socket path。省略時は既定パス。null なら送らない。 */
+    engineRelaySocketPath?: string | null;
     /** connect 不能ブランチでの retry-connect ポーリング間隔（秒）。既定 1.0。 */
     retryConnectIntervalSeconds?: number;
+    /**
+     * 現在の permission mode（"default" | "acceptEdits" | "plan" | "auto" | null）を返す
+     * provider（注入）。auto/acceptEdits の自動許可判定に使う。省略・null・例外は
+     * 「判定不能」として従来どおり iPhone ゲートへフォールバックする（安全側）。
+     */
+    permissionModeProvider?: () => Promise<string | null>;
+    /**
+     * reaper daemon の判定権威となる heartbeat ファイルの置き場（注入）。
+     * 省略時は書かない（テスト密閉）。runHookCommand が既定パスを渡す。
+     */
+    heartbeatDir?: string;
+    /** Session Hub daemon の常駐保証（注入）。省略時は何もしない。UserPromptSubmit でのみ呼ぶ。 */
+    ensureHub?: () => void;
 }
 export interface HookRunResult {
     exitCode: number;
@@ -47,6 +74,27 @@ export interface HookRunResult {
 }
 /** hook の本体（テスタブル・完全版）。stdin JSON の `hook_event_name` で分岐する。 */
 export declare function runHookCore(options: RunHookOptions): Promise<HookRunResult>;
+/**
+ * permission mode によって iPhone 承認をスキップできる場合、その理由文字列を返す（純ロジック）。
+ * - auto: 全ツールを自動許可。
+ * - acceptEdits: 編集系ツール（Write/Edit/MultiEdit/NotebookEdit）のみ自動許可。
+ * - それ以外（default / plan / null = 判定不能）: null（従来どおり iPhone ゲート）。
+ */
+export declare function autoAllowReasonForMode(mode: string | null, toolName: string): string | null;
+/**
+ * pane 表示から permission mode を判定する本番 provider を作る（claude 専用）。
+ * capture が timeLimitMs 内に返らない・失敗する場合は null（判定不能 → 従来ゲート）。
+ * 本番の hook CLI は Claude 専用なので、この provider も Claude にだけ配線する。
+ * セッションの属するバックエンド（tmux / herdr）はメタデータで解決する。
+ */
+export declare function makeTmuxPermissionModeProvider(session: string, timeLimitMs?: number): () => Promise<string | null>;
+/**
+ * Hub socket へ短命接続し、1回だけ presence RPC を行う。
+ * false は正常応答で購読者なし、null は接続・応答失敗を表す。
+ */
+export declare function requestHubPresence(session: string, socketPath: string, timeoutMs?: number): Promise<boolean | null>;
+/** tmux attach と Hub subscriber を順に調べる本番 presence probe。 */
+export declare function makePresenceProbe(runner?: TmuxCommandRunner, hubSocketPath?: string): PresenceProbe;
 /**
  * hook サブコマンドのエントリポイント。
  * 引数: `--socket <path>` | `--session <name>` | `--deadline <seconds>` |
@@ -58,10 +106,3 @@ export declare function runHookCore(options: RunHookOptions): Promise<HookRunRes
  * 判断する（未設定なら送らず観測記録, 3.5/6.4）。送信可否は deny 判断に影響しない。
  */
 export declare function runHookCommand(args: string[]): Promise<number>;
-/**
- * エージェント別にフックが実際に stdout へ書く文字列を決める（TESTABLE）。
- * claude: 生成した decision JSON をそのまま出す。
- * codex : allow/ask を「unsupported」として拒否するため、承認（allow 決定）時は無出力（null）で
- *         exit 0 続行にする。拒否（deny）や監査出力はそのまま出す（deny JSON は codex も解釈する）。
- */
-export declare function hookStdoutForAgent(agent: "claude" | "codex", stdout: string): string | null;