@cocorograph/hub-agent 0.8.24 → 0.8.25

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.25",
+  "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-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
  */