@cocorograph/hub-agent 0.7.104 → 0.8.0

package/src/tui-permission-bridge.mjs

@@ -1,280 +0,0 @@
-/**
- * TUI 権限ブリッジ (G3 spike)。
- *
- * 対話 TUI (tmux/PTY) で動く claude の PreToolUse フックが書き出す権限要求
- * ファイルを fs.watch で拾い、既存 SDK 経路と同じ `claude.permission.request`
- * として browser へ push する。browser の `claude.permission.reply` 決定を
- * `.decision` ファイルとして書き戻し、フックがそれを読んで permissionDecision
- * を返す。これにより TUI 自身の権限メニューを抑止しつつチャット UI で承認できる。
- *
- * ファイル IPC を採用する理由: hub-agent はローカル HTTP サーバを持たず、
- * `/tmp/cockpit_session_events/` の fs.watch 前例 (main.mjs) があるため、同じ
- * パターンに揃える。atomic write (tmp+rename) / 全エラー握りつぶしも踏襲する。
- *
- * 契約: D00000_hub.cocorograph.com:tools/cockpit-tui-chat/SPIKE-G3.md
- */
-
-import { EventEmitter } from "node:events"
-import { watch, existsSync } from "node:fs"
-import { mkdir, readFile, writeFile, rename, unlink, readdir } from "node:fs/promises"
-import path from "node:path"
-
-export const PERMISSION_REQUESTS_DIR =
-  process.env.COCKPIT_PERMISSION_DIR || "/tmp/cockpit_permission_requests"
-
-/**
- * pending request の TTL。これを超えた seen/pending エントリは GC する。
- *
- * 旧 5 分から延長 (6h)。理由 2 点:
- *  - 遅延回答 resume: フックが死んだ後でもユーザーが戻って回答→新メッセージで再開できる
- *    よう、回答可能な状態を長く保つ (resolve は 2s の .decision 未消費判定で resume へ倒す
- *    ので、_pending を長く保っても二重確定は起きない)。
- *  - 承認カードの re-hydrate: セッション切替でビューが再マウントしてもカードを復元できるよう、
- *    未応答リクエストのペイロードを保持しておく (listPending)。
- */
-const PENDING_TTL_MS = Number(process.env.COCKPIT_PENDING_TTL_MS) || 6 * 60 * 60 * 1000
-
-/**
- * TUI フック ⇄ browser の権限往復をファイル IPC で仲介する。
- *
- * イベント:
- *   - "permission": { request_id, session_id, cwd, tool_name, input }
- *     フックが書いた要求を 1 件読んだとき。main.mjs がこれを
- *     `claude.permission.request` として client.send する。
- */
-export class TuiPermissionBridge extends EventEmitter {
-  /**
-   * @param {{dir?: string, logger?: object}} [opts]
-   */
-  constructor({ dir = PERMISSION_REQUESTS_DIR, logger } = {}) {
-    super()
-    this.dir = dir
-    this.logger = logger
-    /** @type {Map<string, {payload: object, at: number}>} request_id -> ペイロード + 受理時刻(ms) */
-    this._pending = new Map()
-    /** @type {Set<string>} 二重発火防止 (request_id) */
-    this._seen = new Set()
-    this._watcher = null
-  }
-
-  /** 監視ディレクトリを作成し、既存要求を sweep してから fs.watch を張る。 */
-  async start() {
-    await mkdir(this.dir, { recursive: true })
-    await this._sweep()
-    try {
-      this._watcher = watch(this.dir, (_event, filename) => {
-        if (filename && filename.endsWith(".json")) {
-          this._ingest(filename).catch(() => {})
-        }
-      })
-    } catch (err) {
-      this.logger?.warn(
-        { err: err?.message },
-        "tui permission watcher: fs.watch failed, watcher disabled",
-      )
-    }
-  }
-
-  /** 起動時 / 取りこぼし保険: dir 内の全 .json 要求を読む。 */
-  async _sweep() {
-    let names = []
-    try {
-      names = await readdir(this.dir)
-    } catch {
-      return
-    }
-    for (const n of names) {
-      if (n.endsWith(".json")) await this._ingest(n).catch(() => {})
-    }
-  }
-
-  /**
-   * 要求ファイル 1 件を読み "permission" を emit する。partial write や
-   * 既読は無視する。
-   * @param {string} filename `<request_id>.json`
-   */
-  async _ingest(filename) {
-    const request_id = filename.slice(0, -".json".length)
-    if (this._seen.has(request_id)) return
-    let body
-    try {
-      body = JSON.parse(await readFile(path.join(this.dir, filename), "utf-8"))
-    } catch {
-      // partial write / 既に消えた → 次の watch イベントで拾い直す。
-      return
-    }
-    this._gc()
-    this._seen.add(request_id)
-    const payload = {
-      request_id,
-      session_id: body.session_id ?? null,
-      cwd: body.cwd ?? null,
-      tool_name: body.tool_name ?? "",
-      input: body.tool_input ?? {},
-      // 質問/承認カードの直前アシスタント説明 (フックが transcript から抽出して同梱)。
-      // browser はこれをカード上部に表示し、jsonl tail の到着レースに依らず文脈を読める。
-      context_text: body.context_text ?? null,
-    }
-    // payload も保持する (セッション切替でビュー再マウント時の re-hydrate / listPending 用)。
-    this._pending.set(request_id, { payload, at: Date.now() })
-    this.emit("permission", payload)
-  }
-
-  /**
-   * 指定セッション宛の未応答リクエストのペイロード一覧を返す (re-hydrate 用)。
-   *
-   * セッション切替でビューが再マウントすると、その時点で持っていた承認/質問カードは
-   * React state ごと消える (agent は claude.permission.request を 1 回しか push しない)。
-   * 戻ってきたときに復元できるよう、browser が再購読時にこれを引いて未応答カードを
-   * 再配信する。session_id 一致を主、cwd 一致を従にして絞る。
-   *
-   * @param {{session_id?: string|null, cwd?: string|null}} q
-   * @returns {object[]} emit と同形のペイロード配列
-   */
-  listPending({ session_id, cwd } = {}) {
-    const out = []
-    for (const { payload } of this._pending.values()) {
-      const sidOk = session_id && payload.session_id === session_id
-      const cwdOk = cwd && payload.cwd === cwd
-      if (sidOk || cwdOk) out.push(payload)
-    }
-    return out
-  }
-
-  /** request を pending から完全に落とす (resume 等で「もう再配信しない」とき)。 */
-  drop(request_id) {
-    this._pending.delete(request_id)
-    this._seen.delete(request_id)
-  }
-
-  /**
-   * セッションに紐づく pending を **まとめて** 落とす (set/clear 非対称の解消)。
-   *
-   * `_pending` を畳む経路は元々 `resolve()`(browser 回答) と `drop(request_id)` の 2 本しか
-   * 無く、(a) ターミナルでネイティブ回答された / (b) `/clear` で session が回転した /
-   * (c) kill された、という「browser を経由しない終端」では pending が 6h TTL まで残り、
-   * 復帰時 `listPending`→rehydrate が古いカードを反復再 push していた (症状1b)。本メソッドは
-   * その終端を session 同一性で一括 drop するためのもの。
-   *
-   * マッチ規則は `listPending` (L134-142) と同じ OR セマンティクス: payload.session_id ===
-   * session_id **または** payload.cwd === cwd。さらに `toolName` を渡すと payload.tool_name 一致
-   * のものだけに絞る (ネイティブ回答検知で「いま解決したツールのカードだけ」を畳む用途)。
-   * 落とした request_id を返すので、呼び出し側は browser へ `claude.permission.cancel` を
-   * 送ってカードを消せる。
-   *
-   * `drop(request_id)` との違い: drop は request_id 既知の 1 件 (resume 経路)、dropBySession は
-   * session 同一性で選んだ **集合** を落とし、落とした id 一覧を返す。
-   *
-   * @param {{session_id?: string|null, cwd?: string|null, toolName?: string|null}} q
-   * @returns {string[]} 落とした request_id の配列
-   */
-  dropBySession({ session_id = null, cwd = null, toolName = null } = {}) {
-    const dropped = []
-    if (!session_id && !cwd) return dropped
-    for (const [request_id, { payload }] of this._pending) {
-      const sidOk = session_id && payload.session_id === session_id
-      const cwdOk = cwd && payload.cwd === cwd
-      if (!(sidOk || cwdOk)) continue
-      if (toolName && payload.tool_name !== toolName) continue
-      this._pending.delete(request_id)
-      this._seen.delete(request_id)
-      // 要求ファイルも掃除する (1-B: 質問系フックは即 abstain して .json を残すため、
-      // 畳んだ後に消さないと agent 再起動時の _sweep が古いカードを再 emit する)。best-effort。
-      unlink(path.join(this.dir, `${request_id}.json`)).catch(() => {})
-      dropped.push(request_id)
-    }
-    return dropped
-  }
-
-  /**
-   * browser の決定をフックへ返す。対象 request_id なら `.decision` を atomic
-   * 書き込みし、要求ファイルを掃除して true を返す。対象外なら false
-   * (呼び出し側は SDK 経路へフォールバックする)。
-   *
-   * @param {string} request_id
-   * @param {boolean} allow
-   * @param {string} [denyMessage]
-   * @param {unknown} [updatedInput] AskUserQuestion 等の回答 ({questions, answers})。
-   *   フックが PreToolUse の hookSpecificOutput.updatedInput として注入し、claude が
-   *   対話 UI を出さず確定する。Bash 等の allow/deny だけで済むツールでは undefined。
-   * @returns {Promise<boolean>} この bridge の管理下だったか
-   */
-  async resolve(request_id, allow, denyMessage, updatedInput) {
-    if (!this._pending.has(request_id)) return false
-    this._pending.delete(request_id)
-    const decision = allow ? "allow" : "deny"
-    const fp = path.join(this.dir, `${request_id}.decision`)
-    const tmp = `${fp}.tmp`
-    try {
-      await writeFile(
-        tmp,
-        JSON.stringify({
-          decision,
-          deny_message: denyMessage ?? null,
-          // 回答 (AskUserQuestion の {questions, answers} 等)。フックが
-          // updatedInput として注入する。無ければ null (Bash 等)。
-          updated_input: updatedInput ?? null,
-        }),
-      )
-      await rename(tmp, fp)
-    } catch (err) {
-      // 書けなくてもこの request は我々のもの: フックは TTL で ask 縮退する。
-      this.logger?.warn({ err: err?.message, request_id }, "decision write failed")
-      return true
-    }
-    try {
-      await unlink(path.join(this.dir, `${request_id}.json`))
-    } catch {
-      /* フック側でも消す。二重防御。 */
-    }
-    return true
-  }
-
-  /**
-   * 書き込んだ ``.decision`` がまだ消費されていないか判定する (遅延回答 resume 用)。
-   *
-   * フックが生存していれば ~0.15s のポーリングで ``.decision`` を読んで即 unlink する
-   * (_poll_decision の _cleanup)。書き込み後しばらく経っても ``.decision`` が残っている
-   * = フックは既に死んでいる (Claude Code のフック timeout で kill / TTL 経過で abstain
-   * 済み) と判定でき、呼び出し側は「回答を新メッセージとしてセッションへ届ける resume」
-   * へフォールバックする。
-   *
-   * @param {string} request_id
-   * @returns {boolean} ``.decision`` が残っていれば true (= 未消費 = フック死亡)
-   */
-  hasUnconsumedDecision(request_id) {
-    return existsSync(path.join(this.dir, `${request_id}.decision`))
-  }
-
-  /** 未消費の ``.decision`` を掃除する (resume へフォールバックしたとき呼ぶ)。 */
-  async dropDecision(request_id) {
-    try {
-      await unlink(path.join(this.dir, `${request_id}.decision`))
-    } catch {
-      /* 既に無ければ no-op */
-    }
-  }
-
-  /** TTL 超過の seen/pending を掃除する。 */
-  _gc() {
-    const now = Date.now()
-    for (const [id, entry] of this._pending) {
-      if (now - entry.at > PENDING_TTL_MS) {
-        this._pending.delete(id)
-        this._seen.delete(id)
-      }
-    }
-  }
-
-  /** watcher を閉じる。 */
-  stop() {
-    try {
-      this._watcher?.close()
-    } catch {
-      /* ignore */
-    }
-    this._watcher = null
-  }
-}
-
-export default TuiPermissionBridge

package/src/tui-viewer-registry.mjs

@@ -1,201 +0,0 @@
-/**
- * TUI 閲覧マーカー registry (T04778 watcher ゲート)。
- *
- * Cockpit の TUI チャットでブラウザが「ある session を閲覧中」であることを、
- * ローカルのマーカーファイルとして保持する。対話 TUI (tmux/PTY) で動く claude の
- * PreToolUse 承認フック (bridge_permission.py) は、ツール実行前にこのマーカーの
- * 鮮度を読み、「閲覧者がいる session だけ承認を Cockpit へブリッジ、いなければ
- * 即 ask 縮退」する。これにより、承認フックを全ユーザーの settings.json に常設
- * しても、非閲覧の対話セッション (リーダー / cockpit-orch サブ / ターミナルモード)
- * の Bash がブリッジ応答 TTL ぶんハングする地雷を回避する。
- *
- * ブラウザは閲覧中 `claude.tui.viewing {session_id, cwd}` を周期送信し、main.mjs が
- * note() を呼んでマーカーを更新する。アンマウント時は `claude.tui.unviewing` で
- * unview() を呼び、sid マーカーを即失効させる。鮮度切れは sweep で掃除する。
- *
- * ファイル IPC / atomic write (tmp+rename) / 全エラー握りつぶしは
- * tui-permission-bridge.mjs の前例に揃える。
- *
- * 契約: D00000_hub.cocorograph.com:tools/cockpit-tui-chat/WATCHER-GATE.md
- */
-
-import { createHash } from "node:crypto"
-import { mkdir, writeFile, rename, unlink, readdir, readFile } from "node:fs/promises"
-import path from "node:path"
-
-export const VIEWERS_DIR =
-  process.env.COCKPIT_VIEWERS_DIR || "/tmp/cockpit_tui_viewers"
-
-/** マーカー鮮度 (秒)。ブラウザのハートビート間隔 (5s) の 3 倍を既定とする。 */
-const VIEWER_TTL_SEC = Number(process.env.COCKPIT_VIEWER_TTL_SEC) || 15
-
-/** 失効マーカーを掃除する周期 (ms)。判定はフック側が expires_at で行うので衛生のみ。 */
-const SWEEP_INTERVAL_MS = 30 * 1000
-
-/**
- * session_id をフック側 (`bridge_permission.py`) と同一規則でファイル名へ正規化する。
- * Python 側は ``c.isalnum() or c in "-_"`` を残す。UUID は ASCII 英数 + ハイフンなので
- * 実質 no-op だが、両者が一致しないとマーカーを引けないため厳密に揃える。
- *
- * @param {string} sessionId
- * @returns {string}
- */
-function sanitizeSessionId(sessionId) {
-  return String(sessionId).replace(/[^A-Za-z0-9_-]/g, "")
-}
-
-/**
- * cwd をフック側と同一規則でハッシュする (sha1 hex 先頭 16 文字)。
- *
- * @param {string} cwd
- * @returns {string}
- */
-function hashCwd(cwd) {
-  return createHash("sha1").update(String(cwd), "utf8").digest("hex").slice(0, 16)
-}
-
-/**
- * TUI 閲覧マーカーをローカル FS に保持する registry。
- */
-export class TuiViewerRegistry {
-  /**
-   * @param {{dir?: string, ttlSec?: number, logger?: object}} [opts]
-   */
-  constructor({ dir = VIEWERS_DIR, ttlSec = VIEWER_TTL_SEC, logger } = {}) {
-    this.dir = dir
-    this.ttlSec = ttlSec
-    this.logger = logger
-    this._sweepTimer = null
-    /** atomic write の tmp 名を一意化するための単調増加カウンタ (race 回避)。 */
-    this._tmpSeq = 0
-  }
-
-  /** ディレクトリを作成し、起動時の残骸を掃除して周期 sweep を張る。 */
-  async start() {
-    try {
-      await mkdir(this.dir, { recursive: true })
-    } catch (err) {
-      this.logger?.warn({ err: err?.message }, "tui viewer registry: mkdir failed")
-    }
-    await this._sweep()
-    this._sweepTimer = setInterval(() => {
-      this._sweep().catch(() => {})
-    }, SWEEP_INTERVAL_MS)
-    // 他の timer 同様 unref して agent のアイドル終了を妨げない。
-    this._sweepTimer?.unref?.()
-  }
-
-  /**
-   * 閲覧ハートビートを受けてマーカーを更新する。session_id マーカー (厳密) と
-   * cwd マーカー (フォールバック) の両方を ``expires_at = now + ttl`` で atomic 更新する。
-   *
-   * @param {{session_id?: string|null, cwd?: string|null}} info
-   * @returns {Promise<void>}
-   */
-  async note({ session_id, cwd } = {}) {
-    // expires_at は epoch **秒** (フック側 time.time() と比較するため)。
-    const expiresAt = Date.now() / 1000 + this.ttlSec
-    const updatedAt = Date.now() / 1000
-    const body = JSON.stringify({
-      session_id: session_id ?? null,
-      cwd: cwd ?? null,
-      expires_at: expiresAt,
-      updated_at: updatedAt,
-    })
-    const targets = []
-    if (session_id) {
-      const safe = sanitizeSessionId(session_id)
-      if (safe) targets.push(path.join(this.dir, `sid-${safe}.json`))
-    }
-    if (cwd) targets.push(path.join(this.dir, `cwd-${hashCwd(cwd)}.json`))
-    for (const fp of targets) {
-      await this._atomicWrite(fp, body)
-    }
-  }
-
-  /**
-   * 閲覧終了を受けて session_id マーカーを即削除する。cwd マーカーは同 cwd を
-   * 他のブラウザが閲覧している可能性があるため即削除せず、TTL 失効に委ねる。
-   *
-   * @param {{session_id?: string|null}} info
-   * @returns {Promise<void>}
-   */
-  async unview({ session_id } = {}) {
-    if (!session_id) return
-    const safe = sanitizeSessionId(session_id)
-    if (!safe) return
-    try {
-      await unlink(path.join(this.dir, `sid-${safe}.json`))
-    } catch {
-      /* 既に無い / 失効済み。 */
-    }
-  }
-
-  /**
-   * atomic write (tmp+rename)。書けなくても agent は落とさない。
-   *
-   * tmp 名は ``<fp>.<pid>.<seq>.tmp`` で **書込ごとに一意化**する。固定 ``<fp>.tmp`` を
-   * 使うと、同一マーカー (同 session_id / 同 cwd) へ複数タブ・高頻度ハートビートが並行
-   * note() したとき、先勝ちの rename が tmp を移動した後に後発の rename が ENOENT で
-   * 失敗する (rename '<fp>.tmp' → '<fp>': no such file)。マーカー自体は勝者が書くので
-   * 致命的ではないが、ログを汚し鮮度更新を取りこぼす余地があった。一意 tmp なら各書込が
-   * 独立した tmp を rename するため衝突しない。
-   *
-   * @param {string} fp
-   * @param {string} body
-   */
-  async _atomicWrite(fp, body) {
-    const tmp = `${fp}.${process.pid}.${++this._tmpSeq}.tmp`
-    try {
-      await writeFile(tmp, body)
-      await rename(tmp, fp)
-    } catch (err) {
-      // rename 前に書けた tmp が残りうるので掃除する (sweep は *.json のみ対象)。
-      try {
-        await unlink(tmp)
-      } catch {
-        /* 無ければ no-op */
-      }
-      this.logger?.warn({ err: err?.message, fp }, "viewer marker write failed")
-    }
-  }
-
-  /** expires_at を過ぎたマーカーを unlink する (衛生のみ)。 */
-  async _sweep() {
-    let names = []
-    try {
-      names = await readdir(this.dir)
-    } catch {
-      return
-    }
-    const now = Date.now() / 1000
-    for (const n of names) {
-      if (!n.endsWith(".json")) continue
-      const fp = path.join(this.dir, n)
-      let body
-      try {
-        body = JSON.parse(await readFile(fp, "utf-8"))
-      } catch {
-        continue
-      }
-      const exp = body?.expires_at
-      if (typeof exp === "number" && exp <= now) {
-        try {
-          await unlink(fp)
-        } catch {
-          /* ignore */
-        }
-      }
-    }
-  }
-
-  /** 周期 sweep を停止する。 */
-  stop() {
-    if (this._sweepTimer) {
-      clearInterval(this._sweepTimer)
-      this._sweepTimer = null
-    }
-  }
-}
-
-export default TuiViewerRegistry