@cocorograph/hub-agent 0.8.24 → 0.8.26

package/README.md

@@ -62,9 +62,7 @@ hub-agent stop                        # 停止方法のヒント表示
 hub-agent install-service [--bin PATH]
 hub-agent uninstall-service
 hub-agent plugins list                # ~/.hub/plugins/ から読み込み済プラグイン
-hub-agent plugins examples            # repo 同梱の install 可能 example
-hub-agent plugins install <name> [--force]
-hub-agent plugins uninstall <name>
+hub-agent plugins uninstall <name>    # ~/.hub/plugins/<prio>-<name>/ を削除
 ```
 
 ## 設定ファイル
@@ -86,7 +84,8 @@ hub-agent/
 │   ├── config.mjs             # ~/.hub/agent.json 管理
 │   ├── enroll.mjs             # enrollment フロー
 │   ├── ws-client.mjs          # outbound WSS + reconnect with jitter
-│   ├── pty-bridge.mjs         # @lydell/node-pty 多重化 (fd leak 回避フォーク)
+│   ├── claude-stream-bridge.mjs # Claude Agent SDK チャット中継
+│   ├── codex-stream-bridge.mjs  # Codex app-server チャット中継
 │   ├── tmux.mjs               # tmux exec/list/create/kill
 │   ├── state.mjs              # session status / context_pct 検知
 │   ├── skills.mjs             # ~/.claude/skills 集計
@@ -98,7 +97,8 @@ hub-agent/
 │   ├── co.cocorograph.hub-agent.plist
 │   └── hub-agent.service
 ├── scripts/
-│   └── fix-node-pty-perms.mjs # @lydell/node-pty spawn-helper +x 修復 (postinstall)
+│   ├── install.sh             # ワンライナーセットアップ (macOS / Linux / WSL)
+│   └── install.ps1            # Windows (WSL2 導入 + Task Scheduler 登録)
 └── test/
 ```
 
@@ -107,21 +107,22 @@ hub-agent/
 - [x] Sprint A: 仕様書 (Hub knowledge id=6080)
 - [x] Sprint B: Hub 側 enrollment API + WS endpoint 雛形
 - [x] Sprint C: 本リポジトリの雛形 + outbound WSS + hook system
-- [x] Sprint D: pty bridge
 - [x] Sprint E: tmux exec/list/create/kill 移植 + auto list UI
 - [x] Sprint F: Hub Browser↔Agent multiplex 中継
 - [x] Sprint G: Hub frontend /user/cockpit/{agents,terminal} ページ
 - [x] Sprint H: skills / state dot / usage badge リレー
 - [x] Sprint I: 接続復旧 (jitter + force reconnect + Celery stale 検知)
 - [x] Sprint J: 本リポジトリ publish 準備 + launchd/systemd 連携
-- [x] Sprint K: remote-ops プラグイン例 (`plugins/10-tailscale-remote/`)
 
-## 同梱プラグイン
+## プラグイン
 
-- [`plugins/10-tailscale-remote`](./plugins/10-tailscale-remote/README.md) — 自宅
-  Mac (hub-agent host) を会社 Mac (`remote_host`) の tmux に対する透過プロキシ化。
-  `hub-agent plugins install 10-tailscale-remote` で `~/.hub/plugins/` にコピー、
-  `config.json` を編集して restart で有効化
+プラグインは利用者が `~/.hub/plugins/<prio>-<name>/plugin.mjs` を自分で置く運用です。
+置けば `plugins list` から読み込まれ、`plugins uninstall <prio>-<name>` で削除できます。
+
+リポジトリ同梱の example プラグインはありません。唯一同梱していた
+`plugins/10-tailscale-remote/` は pty spawn を横取りするプラグインで、pty 中継の撤去と
+同時に削除しました。同梱 example が 0 件になったため、それを配る `plugins examples` /
+`plugins install` と `package.json` の `files` の `plugins/` も外しています。
 
 ## ライセンス
 

package/bin/hub-agent.mjs

@@ -34,12 +34,8 @@ if (!process.env.LC_ALL) process.env.LC_ALL = "C.UTF-8"
 import { hasConfig, readConfig } from "../src/config.mjs"
 import { enroll } from "../src/enroll.mjs"
 import { resolveSyncTargets, syncBundleTargets } from "../src/hub-bundle.mjs"
-import {
-  installPlugin,
-  listInstallableExamples,
-  uninstallPlugin,
-} from "../src/plugin-install.mjs"
 import { loadPlugins } from "../src/plugin-loader.mjs"
+import { uninstallPlugin } from "../src/plugin-uninstall.mjs"
 import {
   installService,
   restartService,
@@ -264,6 +260,11 @@ program
     }
   })
 
+// プラグインは利用者が `~/.hub/plugins/<prio>-<name>/` へ自分で配置する運用なので、
+// CLI が提供するのは利用者配置分の管理 (list / uninstall) だけ。リポ同梱 example を配る
+// `examples` / `install` は、唯一の example (`plugins/10-tailscale-remote/`) が pty spawn を
+// 横取りするプラグインで pty 撤去と同時に削除され、同梱 example が 0 件になったため撤去した
+// (あわせて package.json の files から `plugins/` を外している)。
 const plugins = program.command("plugins").description("プラグイン管理")
 plugins
   .command("list")
@@ -279,40 +280,9 @@ plugins
     }
   })
 
-plugins
-  .command("examples")
-  .description("リポ同梱の install 可能 example プラグイン一覧")
-  .action(async () => {
-    const list = await listInstallableExamples()
-    if (list.length === 0) {
-      console.log("(no examples bundled)")
-      return
-    }
-    for (const name of list) {
-      console.log(`- ${name}`)
-    }
-  })
-
-plugins
-  .command("install <name>")
-  .description("repo plugins/<name>/ を ~/.hub/plugins/<name>/ にコピー (config.json は温存)")
-  .option("--force", "既存ディレクトリを上書きする")
-  .action(async (name, opts) => {
-    try {
-      const r = await installPlugin(name, { force: !!opts.force })
-      console.log(`installed: ${r.dest}`)
-      console.log("次のステップ:")
-      console.log(`  $EDITOR ${r.dest}/config.json    # 既存なら温存、新規なら example をコピー`)
-      console.log(`  hub-agent restart (launchctl kickstart / systemctl restart)`)
-    } catch (err) {
-      console.error(`plugins install failed: ${err.message}`)
-      process.exit(1)
-    }
-  })
-
 plugins
   .command("uninstall <name>")
-  .description("~/.hub/plugins/<name>/ を削除")
+  .description("~/.hub/plugins/<prio>-<name>/ を削除する")
   .action(async (name) => {
     try {
       const r = await uninstallPlugin(name)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.8.24",
-  "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
+  "version": "0.8.26",
+  "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの Claude / Codex チャットと tmux セッションを中継する。",
   "type": "module",
   "license": "UNLICENSED",
   "private": false,
@@ -19,7 +19,6 @@
   "scripts": {
     "start": "node bin/hub-agent.mjs start",
     "test": "node --test test/*.test.mjs",
-    "postinstall": "node scripts/fix-node-pty-perms.mjs",
     "check:publish-on-main": "node scripts/check-publish-on-main.mjs",
     "prepublishOnly": "node scripts/check-publish-on-main.mjs && npm test"
   },
@@ -28,13 +27,11 @@
     "src/",
     "scripts/",
     "templates/",
-    "plugins/",
     "README.md",
     "LICENSE"
   ],
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.158",
-    "@lydell/node-pty": "1.2.0-beta.12",
     "commander": "^12.1.0",
     "pino": "^9.0.0",
     "ws": "^8.18.0"

package/scripts/install.sh

@@ -518,10 +518,10 @@ _install_node_lts_linux() {
 }
 
 # ネイティブアドオンのビルドに必要な make / g++ / python3 を導入する。
-# PTY backend は @lydell/node-pty に移行済みで全 OS の prebuild を同梱するため通常は
-# native ビルド不要だが、prebuild が当たらない環境では node-gyp rebuild に
-# フォールバックする。クリーンな Ubuntu には build-essential が無く
-# `gyp ERR! not found: make` で失敗する (WSL クリーン Ubuntu で発覚) ため保険で導入する。
+# 現在の依存はすべて純 JS で通常は native ビルド不要だが、optional な native 依存
+# (ws の bufferutil 等) が prebuild なしで拾われると node-gyp rebuild にフォールバック
+# する。クリーンな Ubuntu には build-essential が無く `gyp ERR! not found: make` で
+# 失敗する (WSL クリーン Ubuntu で発覚) ため保険で導入する。
 # macOS は Xcode CLT 前提なので何もしない。
 ensure_build_tools() {
   [[ "$(uname)" == "Darwin" ]] && return 0
@@ -812,7 +812,7 @@ macos_perm_guidance() {
   cat <<EOF
 
 📣 macOS の権限ダイアログについて
-  hub-agent は tmux/pty を中継するため、初回起動時に macOS から
+  hub-agent は tmux セッションとローカルの CLI (Claude / Codex) を中継するため、初回起動時に macOS から
   「node がローカルネットワーク上の機器を検出することを求めています」
   「node がアクセシビリティを制御することを求めています」
   「node がほかのアプリからのデータへのアクセス権を求めています」

package/src/claude-history-watch.mjs

@@ -8,15 +8,18 @@
  * 設計:
  * - 対象ファイルのバイトオフセットを記録し、増分だけ読んで行単位でパース
  * - fs.watch(file) の change イベントで増分読み取り (取りこぼし対策に軽いポーリング併用)
- * - DISPLAY_TYPES (user/assistant/system/result) の行だけ onEvent に渡す
+ * - historyEventFromLine が表示対象と判定した行だけ onEvent に渡す
+ *   (DISPLAY_TYPES の 4 種 + queue-operation から復元したタスク終端イベント)
  * - 各行の uuid を含めて渡す (frontend 側で重複排除に使う)
  * - ファイル不在時は出現を待つ (ディレクトリ監視はせず、ポーリングで存在チェック)
  */
 import { watch as fsWatch } from "node:fs"
 import { open, realpath, stat } from "node:fs/promises"
 
-// 履歴 hydrate と live watch で jsonl→SDK message 整形を共通化 (フィールド取りこぼし防止)。
-import { DISPLAY_TYPES, normalizeHistoryEvent } from "./claude-history.mjs"
+// 履歴 hydrate と live watch で「どの行を拾うか + jsonl→SDK message 整形」を共通化
+// (フィールド取りこぼし・片方だけ直すドリフトの防止)。queue-operation からの終端イベント
+// 合成もこの関数の中に閉じているので、live watch も自動的に同じ挙動になる。
+import { historyEventFromLine } from "./claude-history.mjs"
 
 // アダプティブ・ポーリング: 最後の追記から FAST_WINDOW_MS 以内は fast、以降は idle 周期。
 // ~/.claude が iCloud Drive への symlink のため fs.watch (FSEvents) が遅延/不発しやすく、
@@ -98,8 +101,8 @@ export function watchSessionFile({ filePath, onEvent, fromEnd = true, logger })
           } catch {
             continue
           }
-          if (!obj || !DISPLAY_TYPES.has(obj.type)) continue
-          const event = normalizeHistoryEvent(obj)
+          const event = historyEventFromLine(obj)
+          if (!event) continue
           try {
             onEvent(event)
           } catch (err) {

package/src/claude-history.mjs

@@ -10,6 +10,8 @@
  * - cwd エンコード規則: `/`, `.`, `_` などの非英数字を `-` 置換 (Claude CLI と同じ)
  * - 1 行 = 1 JSON。`type` が 'user' / 'assistant' / 'system' / 'result' のものだけ抽出
  *   (内部 type 'attachment' / 'last-prompt' / 'permission-mode' 等は UI 表示対象外)
+ *   例外として `queue-operation` の未配送タスク通知だけは終端イベントへ合成する
+ *   (synthesizeTaskNotificationEvent 参照。行そのものを表示するわけではない)
  * - 上限 MAX_HISTORY_LINES (デフォルト 500) で末尾から切る
  * - ファイル不在 (新規セッション) なら空配列を返す (エラーにしない)
  */
@@ -210,6 +212,149 @@ export function normalizeHistoryEvent(obj) {
   return event
 }
 
+const TASK_NOTIFICATION_MARKER = "<task-notification>"
+const TASK_NOTIFICATION_CLOSE = "</task-notification>"
+// ヘッダ領域の終わり。ここから先は自由文 (報告全文) なので、鍵と状態の抽出対象にしない。
+const TASK_NOTIFICATION_BODY_TAGS = ["<result>", "<summary>", "<note>"]
+// マスクを素通りする経路なので、長さでも歯止めを掛ける (実データの tool_use_id は 30〜40 字)。
+const MAX_TOOL_USE_ID_LEN = 200
+const MAX_STATUS_LEN = 64
+
+/**
+ * 「通知の体裁を持つのに合成しなかった」件数。**内容は一切持たない**。
+ *
+ * ⚠️ これは観測窓であって判定ではない。封筒の検査を厳しくすると、Claude CLI が将来ラッパー・
+ * 空白・タグ順を変えたときに**正当な通知まで落ちて幽霊カードが静かに戻る**。その「静かな戻り」に
+ * 気づけるよう、件数だけを数える (内容をログへ出すと、まさに伏せ字を回避したい本文が漏れる)。
+ */
+let taskNotificationEnvelopeDrops = 0
+
+/** 封筒の検査で合成しなかった**累計**件数を返す (テスト用)。 */
+export function getTaskNotificationEnvelopeDrops() {
+  return taskNotificationEnvelopeDrops
+}
+
+/** 前回 drain 以降に増えた分を返して 0 に戻す (ログへ出す側が使う)。 */
+let taskNotificationEnvelopeDropsReported = 0
+export function drainTaskNotificationEnvelopeDrops() {
+  const delta = taskNotificationEnvelopeDrops - taskNotificationEnvelopeDropsReported
+  taskNotificationEnvelopeDropsReported = taskNotificationEnvelopeDrops
+  return delta
+}
+
+/** `<tag>…</tag>` の **最初の** 中身を返す。見つからなければ ""。 */
+function firstTagValue(text, tag) {
+  const open = `<${tag}>`
+  const start = text.indexOf(open)
+  if (start < 0) return ""
+  const from = start + open.length
+  const end = text.indexOf(`</${tag}>`, from)
+  if (end < 0) return ""
+  return text.slice(from, end).trim()
+}
+
+/**
+ * `queue-operation` 行に埋まっている「タスク終端の宣言」を、画面が扱える最小イベントへ
+ * 合成する (2026-08-05)。
+ *
+ * ## なぜ必要か
+ * サブエージェント / バックグラウンドタスクの完了通知は、CLI がまず **キューへ積む**
+ * (`type:"queue-operation", operation:"enqueue"`) 形で jsonl に書かれ、その後キューから
+ * 取り出された時に初めて `type:"user"` の行として配送される。ところが配送前に
+ * セッションが閉じる・`remove` されるなどで **user 行が書かれないまま終わる**ケースが多く
+ * (2026-08-05 に手元の全 jsonl 2,136 本を走査した実測で、終端宣言 788 件 (tool_use_id
+ * ユニーク) のうち 332 件 = 42% が未配送。内訳 completed 285 / failed 29 / killed 18)、
+ * 画面側の台帳はそのカードを
+ * 「実行中」のまま抱え続ける (= リロードで残る幽霊カード)。
+ *
+ * enqueue 行の `content` には `<status>` と `<tool-use-id>` が入っており、これは
+ * **CLI 自身が書いた終端宣言**なので、時間で推測せずに終端を復元できる。
+ *
+ * ## ⚠️ 載せてよいのは「鍵」と「状態」と「時刻」だけ
+ * `<result>` にはサブエージェントの報告全文が入る (実データで確認済み)。しかしマスク処理
+ * `maskMessageObject` (src/tool-result-mask.mjs:165-168) は `const message = obj.message;
+ * if (!message …) return obj` で **即 return** するため、`message` を持たないこの合成イベントは
+ * **マスクを素通りする**。よって `<result>` / `<summary>` / `<note>` / `<output-file>` の本文は
+ * 絶対に載せない (載せると秘匿情報がマスクされないまま browser へ流れる)。`<task-id>` も
+ * 画面側が使っていないので載せない。
+ *
+ * 画面側 (Hub 本体 frontend/lib/cockpit/agentRequest.ts の applyTaskNotificationEvent) は
+ * `type:"system" / subtype:"task_notification" / tool_use_id / status` を終端として処理し、
+ * `requireRegistered: true` なので未知の tool_use_id で幻のカードが増えることはない。
+ * `timestamp` は猶予表示の起点になるので必ず載せる。
+ *
+ * @param {Record<string, unknown>} obj jsonl 1 行をパースした生 object
+ * @returns {Record<string, unknown>|null} 合成イベント。対象外なら null
+ */
+export function synthesizeTaskNotificationEvent(obj) {
+  if (!obj || obj.type !== "queue-operation" || obj.operation !== "enqueue") return null
+  const content = obj.content
+  if (typeof content !== "string") return null
+  const trimmed = content.trim()
+  // ⚠️ **「通知を含む」ではなく「通知そのものである」ことを要求する** (2026-08-05 のクロス
+  // レビュー minor)。含むだけで拾うと、**利用者が通知の文面を本文へ貼っただけの入力**を終端
+  // 宣言として扱ってしまう。実測でも、このレビューのやり取り自体がキューに積まれ、状態として
+  // 日本語の文章を、鍵として 215 字の文字列を拾っていた (実データ 1,692 行中 2 件)。
+  // 実データでは正規の通知 1,648 件すべてが `<task-notification>` で始まり、閉じタグを持つ。
+  if (!trimmed.startsWith(TASK_NOTIFICATION_MARKER)) {
+    if (trimmed.includes(TASK_NOTIFICATION_MARKER)) taskNotificationEnvelopeDrops += 1
+    return null
+  }
+  // ⚠️ 閉じタグは **最後の出現**を採る。最初の出現にすると、`<result>` の本文が
+  // `</task-notification>` を引用しているだけで封筒が途中で切れ、正当な通知を落とす。
+  const closeAt = trimmed.lastIndexOf(TASK_NOTIFICATION_CLOSE)
+  if (closeAt < TASK_NOTIFICATION_MARKER.length) {
+    taskNotificationEnvelopeDrops += 1
+    return null
+  }
+  // 閉じタグの後ろに本文が続くものは通知そのものではない (貼り付けの typical な形)。
+  if (trimmed.slice(closeAt + TASK_NOTIFICATION_CLOSE.length).trim()) {
+    taskNotificationEnvelopeDrops += 1
+    return null
+  }
+  const block = trimmed.slice(TASK_NOTIFICATION_MARKER.length, closeAt)
+  // 鍵と状態は **ヘッダ領域** (自由文の本文タグより前) からだけ採る。本文に紛れたタグや、
+  // 正規の `<status>` が欠けたときに本文側のタグを拾い上げることを防ぐ。
+  let headerEnd = block.length
+  for (const tag of TASK_NOTIFICATION_BODY_TAGS) {
+    const at = block.indexOf(tag)
+    if (at >= 0 && at < headerEnd) headerEnd = at
+  }
+  const header = block.slice(0, headerEnd)
+  const tool_use_id = firstTagValue(header, "tool-use-id")
+  const status = firstTagValue(header, "status")
+  // 鍵か状態が欠けた通知は画面側でも無視されるので、流すだけ無駄 → 合成しない。
+  if (!tool_use_id || !status) {
+    taskNotificationEnvelopeDrops += 1
+    return null
+  }
+  // マスクを素通りする経路なので、長さでも歯止めを掛ける (異常に長い値は封筒が壊れたサイン)。
+  if (tool_use_id.length > MAX_TOOL_USE_ID_LEN || status.length > MAX_STATUS_LEN) {
+    taskNotificationEnvelopeDrops += 1
+    return null
+  }
+  const event = { type: "system", subtype: "task_notification", tool_use_id, status }
+  if (obj.timestamp !== undefined) event.timestamp = obj.timestamp
+  return event
+}
+
+/**
+ * jsonl 1 行 (パース済み) を UI 表示用イベントに変換する。表示対象外なら null。
+ *
+ * ⚠️ **認識と合成はこの 1 関数に閉じる**。履歴 hydrate (readSessionHistory) と live watch
+ * (claude-history-watch.mjs) の両方がここを通ること。過去、行のフィルタ / 整形が 2 箇所に
+ * 分散して片方だけ更新されるドリフトが起きているため (normalizeHistoryEvent の注記参照)。
+ *
+ * @param {Record<string, unknown>} obj
+ * @returns {Record<string, unknown>|null}
+ */
+export function historyEventFromLine(obj) {
+  if (!obj || typeof obj !== "object") return null
+  // 1 行から出すイベントは最大 1 個 (画面側の終端は先勝ちなので重複は無害だが、増やさない)。
+  if (DISPLAY_TYPES.has(obj.type)) return normalizeHistoryEvent(obj)
+  return synthesizeTaskNotificationEvent(obj)
+}
+
 /**
  * cwd 文字列を Claude Code の project dir 名に変換する。
  * 例: `/Users/kaz/hub/projects/D00585_partition-lab`
@@ -297,10 +442,10 @@ export async function readSessionHistory(filePath, { maxLines = MAX_HISTORY_LINE
     } catch {
       continue
     }
-    if (!obj || typeof obj !== "object") continue
-    if (!DISPLAY_TYPES.has(obj.type)) continue
-    // SDK message と同じ shape にする (余分な meta は落とす)。整形は共通関数に集約。
-    let event = normalizeHistoryEvent(obj)
+    // SDK message と同じ shape にする (余分な meta は落とす)。認識・整形・合成は
+    // historyEventFromLine 1 箇所に集約 (live watch も同じ関数を通る)。
+    let event = historyEventFromLine(obj)
+    if (!event) continue
     // 秘匿情報 / 非公開スキルプロンプト本文を hydrate 時にも伏せる (古いセッション再表示対策)。
     if (MASK_ENABLED) event = maskMessageObject(event, toolNames)
     events.push(event)

package/src/claude-stream-bridge.mjs

@@ -15,8 +15,7 @@
  * - これは Claude CLI の `claude --resume <id> -p "<msg>"` を毎ターン叩くのと同じ
  *   モデルで、SDK の挙動と素直に噛み合う
  *
- * PtyBridge と並走させる設計。`pty.*` 系メッセージは無傷で、新規 `claude.*` のみ
- * 受け持つ。テスト時は SDK を `{ query }` shape で stub 注入する。
+ * `claude.*` 系メッセージを受け持つ。テスト時は SDK を `{ query }` shape で stub 注入する。
  */
 import { EventEmitter } from "node:events"
 import { randomUUID } from "node:crypto"
@@ -2427,7 +2426,7 @@ export class ClaudeStreamBridge extends EventEmitter {
   /**
    * 指定 cwd / session_id に紐づく SDK セッションを**即停止**する (T04784 TUI bind 用)。
    *
-   * TUI モードに切り替えた session は対話 TUI (tmux/PTY) の claude が write を担うため、
+   * TUI モードに切り替えた session は tmux ペインの対話 claude が write を担うため、
    * SDK セッションを生かしたままだと同一 cwd の jsonl を二重ホストして競合する
    * (DESIGN.md C7)。soft-detach (7 日 resident) では止まらないので、ここで明示 close する。
    *

package/src/codex-stream-bridge.mjs

@@ -11,7 +11,7 @@
  *   claude.input              → input()    (idle は turn/start、生成中は次ターン FIFO)
  *   claude.interrupt          → interrupt() (turn/interrupt)
  *   claude.detach              → detach()   (TTL 付き graceful close)
- *   (codex 固有)               → keepalive() (閲覧中の生存シグナル。pty.resize 相当)
+ *   (codex 固有)               → keepalive() (閲覧中の生存シグナル)
  *   claude.permission.reply    → permissionReply() (client.respond/respondError)
  *   claude.event (生 SDK イベント素通し) → 'event' (生 notification 素通し、同じ思想)
  *   claude.permission.request  → 'permission' (承認/入力要求の生 method+params 素通し)

package/src/hooks.mjs

@@ -17,7 +17,6 @@
 export const HOOK_NAMES = Object.freeze([
   "onAgentStart",
   "onAgentStop",
-  "interceptPtySpawn",
   "interceptTmuxExec",
   "interceptSessionCreate",
   "interceptSessionKill",
@@ -26,21 +25,6 @@ export const HOOK_NAMES = Object.freeze([
   "transformStatusDetection",
 ])
 
-/**
- * @typedef {Object} PtySpawnArgs
- * @property {string} sessionName
- * @property {number} cols
- * @property {number} rows
- * @property {Record<string, string>} env
- */
-
-/**
- * @typedef {Object} PtySpawnDecision
- * @property {string} command
- * @property {string[]} args
- * @property {Record<string, string>} [env]
- */
-
 /**
  * @typedef {Object} TmuxExecArgs
  * @property {string[]} args
@@ -60,7 +44,6 @@ export const HOOK_NAMES = Object.freeze([
  * @property {{
  *   onAgentStart?: (ctx: HookContext) => Promise<void>,
  *   onAgentStop?: (ctx: HookContext) => Promise<void>,
- *   interceptPtySpawn?: (ctx: HookContext & PtySpawnArgs) => Promise<PtySpawnDecision | null>,
  *   interceptTmuxExec?: (ctx: HookContext & TmuxExecArgs) => Promise<TmuxExecDecision | null>,
  * }} hooks
  */