@cocorograph/hub-agent 0.8.24 → 0.8.25

package/src/plugin-uninstall.mjs

@@ -0,0 +1,61 @@
+/**
+ * `hub-agent plugins uninstall <name>` の実装。
+ *
+ * プラグインは利用者が `~/.hub/plugins/<prio>-<name>/` へ自分で配置する運用なので、
+ * CLI が提供するのは「読み込み済み一覧 (list)」と「配置済みディレクトリの削除
+ * (uninstall)」だけ。リポ同梱 example を配る install 系は持たない。
+ *
+ * ⚠️ セキュリティ: 引数の `name` はそのままパス結合すると `../` で plugins ディレクトリの
+ * 外を再帰削除できてしまう (旧 plugin-install.mjs の uninstallPlugin はこれを塞いでいな
+ * かった)。次の 2 段で塞ぐ:
+ *   1. ディレクトリ名を `plugin-loader.mjs` の `parsePluginDirName()` で検証する
+ *      (discovery 側と **同じ 1 つの受理集合** を再利用する。判定を書き写すと
+ *      「読める形」と「消せる形」がずれ、置けるのに消せないディレクトリが生まれる)
+ *   2. 削除直前に `path.resolve` した結果が plugins ディレクトリ配下に収まっているか
+ *      を再確認する (形の検証をすり抜けた場合の最後の砦)
+ */
+import { promises as fs } from "node:fs"
+import path from "node:path"
+
+import { paths as configPaths } from "./config.mjs"
+import { parsePluginDirName } from "./plugin-loader.mjs"
+
+/**
+ * `~/.hub/plugins/<name>/` を再帰削除する。存在しない場合も成功扱い (冪等)。
+ *
+ * @param {string} name プラグインディレクトリ名 (`<prio>-<name>` 形式)
+ * @returns {Promise<{ dest: string, removed: boolean }>}
+ */
+export async function uninstallPlugin(name) {
+  if (!name || typeof name !== "string") {
+    throw new Error("plugin name is required")
+  }
+  // ⚠️ 受理集合は loader と共有する 1 つの validator が決める (ここで条件を足さない)。
+  if (!parsePluginDirName(name)) {
+    throw new Error(
+      `invalid plugin name "${name}": expected <prio>-<name> (e.g. 10-my-plugin)`,
+    )
+  }
+
+  const pluginsRoot = path.resolve(configPaths.pluginsDir)
+  const dest = path.resolve(path.join(pluginsRoot, name))
+  // 封じ込めの再確認。ここに来る時点で形は検証済みだが、削除は不可逆なので結合結果も見る。
+  // ⚠️ ここで見ているのは「**設定された論理 root** (configPaths.pluginsDir) 配下に収まって
+  // いるか」であり、実 (real) パスではない。`path.resolve` は字句正規化で symlink を
+  // 解決しないため、root 自体が別ボリュームへの symlink ならその先が正式な plugins root と
+  // して扱われる (loader も同じ論理 root を読むので一貫する)。`realpath` による拒否は
+  // 入れない — `.hub` や plugins を別ボリュームへ置く環境を壊し、かつ不存在時に ENOENT で
+  // 「存在しなくても成功 (冪等)」の契約も壊れるため。
+  if (!dest.startsWith(pluginsRoot + path.sep)) {
+    throw new Error(`refusing to remove "${dest}": outside of ${pluginsRoot}`)
+  }
+
+  try {
+    await fs.rm(dest, { recursive: true, force: true })
+  } catch (err) {
+    throw new Error(`failed to remove ${dest}: ${err.message}`)
+  }
+  return { dest, removed: true }
+}
+
+export default { uninstallPlugin }

package/src/tmux.mjs

@@ -588,7 +588,7 @@ export async function setTmuxGlobalEnv(name, value, opts = {}) {
 }
 
 /**
- * 汎用 tmux 実行。`tmux.exec` メッセージから呼び出される。
+ * 汎用 tmux 実行 (raw)。任意の tmux サブコマンドを実行して結果を返す低レベル API。
  *
  * @returns {Promise<{stdout: string, stderr: string, exit_code: number}>}
  */
@@ -913,16 +913,9 @@ export async function createSession(name, cwd, opts = {}) {
     // has-session が非 0 = セッション無し
   }
   await execFileP(tmuxBin(opts), ["new-session", "-d", "-s", name, "-c", resolvedCwd])
-  // 既定では mouse mode を ON にする (スマホの touch swipe → SGR wheel escape を
+  // mouse mode を ON にする (スマホの touch swipe → SGR wheel escape を
   // tmux が copy-mode スクロールとして拾えるようにするため)。tmux 2.1+ で `mouse`
   // option は session-scoped、`-t <session>` 指定で他 session への副作用なし。
-  //
-  // ⚠️ ただしこれは「初期既定値」にすぎない。実際の値は接続してきた端末に応じて
-  // pty.attach 時に setSessionMouse() で上書きされる: デスクトップ attach は off
-  // (= マウスのドラッグを xterm のローカル選択にして、コピー奪取・button release
-  // 取りこぼしによる操作不能を防ぐ。0.5.11 で全 session を mouse on にしたことが
-  // デスクトップのドラッグ選択を壊した回帰の修正)。スマホ attach は on のまま。
-  // 旧フロント (mouse フィールド未送信) はこの既定値 on がそのまま使われる。
   try {
     await execFileP(tmuxBin(opts), ["set-option", "-t", name, "mouse", "on"])
   } catch (err) {
@@ -995,27 +988,6 @@ export async function createSession(name, cwd, opts = {}) {
   }
 }
 
-/**
- * 指定 session の tmux mouse mode を on/off する。pty.attach 時に接続端末の
- * 種別に応じて呼ぶ (デスクトップ=off / スマホ=on)。失敗してもセッションの
- * 基本機能は動くので warn のみで握り潰す。
- * @param {string} name session 名
- * @param {boolean} on true=mouse on / false=mouse off
- * @param {{logger?: any, tmuxBin?: string}} [opts]
- */
-export async function setSessionMouse(name, on, opts = {}) {
-  if (!name) return
-  const value = on ? "on" : "off"
-  try {
-    await execFileP(tmuxBin(opts), ["set-option", "-t", name, "mouse", value])
-  } catch (err) {
-    opts.logger?.warn?.(
-      { session: name, mouse: value, err: err?.message || String(err) },
-      "tmux set-option mouse failed",
-    )
-  }
-}
-
 /** session_id として安全な形だけ許可する (send-keys へ流すためコマンド注入を防ぐ)。
  *  Claude の session_id は UUID (ASCII 英数 + ハイフン) なので、それ以外は弾く。 */
 export function isSafeSessionId(sessionId) {
@@ -1172,8 +1144,8 @@ const _delay = (ms) => new Promise((r) => setTimeout(r, ms))
  * resumeWithMessage は改行を空白へ畳む単一行用 (誤確定防止) でチャット本文の複数行を壊すため、
  * こちらは **bracketed paste** (ESC[200~ … ESC[201~) で本文を「貼り付け」として送り、改行を
  * 保ったまま入力欄へ入れてから、確定の Enter (CR) を別途送る。これは frontend の通常送信
- * (`\x1b[200~${text}\x1b[201~` → CR) と同じ手順を agent 側で再現したもの。PTY 非依存
- * (tmux send-keys) なので、当該セッションのターミナルを誰も開いていなくても届く。
+ * (`\x1b[200~${text}\x1b[201~` → CR) と同じ手順を agent 側で再現したもの。tmux send-keys
+ * で直接ペインへ届くので、ブラウザ側が何も開いていなくても投入できる。
  *
  * @param {string} name tmux セッション名
  * @param {string} text 投入する本文 (複数行可)

package/src/ws-client.mjs

@@ -49,36 +49,17 @@ const STABLE_CONNECTION_MS = 10_000
 // 当たって連発失敗するため、最低 5s 待つ。30s リトライまで段階的に伸びる。
 const MIN_BACKOFF_AFTER_5XX_MS = 5_000
 
-// outbound pty.data buffer のサイズ上限。
-// WS not OPEN 中に pty.data を捨てると Cockpit 上のターミナル描画が欠落して
-// 「動かない / 一部だけ表示される」体感を生むため、reconnect 後に flush する。
-// pty.data は冪等で順序維持できれば xterm 側で正しく再現できる。
-// 1 frame は典型的に 数十〜数百 bytes (claude TUI の partial redraw)。
-// 500 frame ≒ 数十KB を 1 切断あたりの上限とする。
-const PTY_BUFFER_MAX_FRAMES = 500
-// outbound buffer に残った pty.data が古すぎると、ターミナルの履歴として
-// 再生する意味が薄れる (ユーザーが視覚的に「過去のもの」として無視する範囲)。
-// 30 秒以上経過した pty.data は flush 時に破棄する。
-const PTY_BUFFER_MAX_AGE_MS = 30_000
-
 // agent→browser の制御/イベント系メッセージのうち、WS not OPEN 中に捨てると
 // Cockpit の挙動が壊れるものを reconnect 越しに保持する (機構③: 本番 agent.log で
 // `claude.jsonl.event ... "ws send skipped (not open)"` のドロップを観測)。
-//   - pty.input.ack: 喪失すると browser の pendingAcks が永久滞留し「送信待ち(未配信)」が
-//     消えない (S1/S3)。再接続 flush で遅れて届けば即解消する。
-//   - claude/codex の event / ready / exit / error / permission / input ack,nack:
+//   - claude/codex の input ack,nack: 喪失すると browser の pendingAcks が永久滞留し
+//     「送信待ち(未配信)」が消えない (S1/S3)。再接続 flush で遅れて届けば即解消する。
+//   - claude/codex の event / ready / exit / error / permission:
 //     喪失すると新規セッションの楽観バブルが本物へ昇格できず、再 attach も固着する。
 //   - claude.jsonl.event / session.event: TUI と一覧の確定状態を復元する。
-//   - pty.exit / pty.ready / pty.error: stream ライフサイクルの節目。落とすと browser の
-//     再 attach/復帰判断が狂う。
-// pty.data とは別バッファにするのは、高頻度な pty.data の洪水で低頻度な ack/event が
-// リング evict されるのを防ぐため (pty.data は冪等で最新フレームだけ届けば良いが、
-// ack/event は 1 件ずつ意味を持つ)。
+// 高頻度の delta 系はここに積まず (下の isEphemeral*DeltaEvent で除外)、低頻度な
+// ack/event がリング evict されるのを防ぐ (ack/event は 1 件ずつ意味を持つ)。
 const BUFFERED_CTRL_TYPES = new Set([
-  "pty.input.ack",
-  "pty.exit",
-  "pty.ready",
-  "pty.error",
   "claude.jsonl.event",
   "claude.event",
   "claude.ready",
@@ -97,7 +78,7 @@ const BUFFERED_CTRL_TYPES = new Set([
   "codex.input.nack",
   "session.event",
 ])
-// 制御/イベントバッファの上限。低頻度なので frames は小さめ、age は pty と揃える。
+// 制御/イベントバッファの上限。低頻度なので frames は小さめ。
 const CTRL_BUFFER_MAX_FRAMES = 200
 const CTRL_BUFFER_MAX_AGE_MS = 30_000
 // reconnect 後の buffered event は backend が browser の active stream 集合を
@@ -168,11 +149,8 @@ export class WsClient extends EventEmitter {
     this.backoff = MIN_BACKOFF_MS
     this.stopped = false
     this.startedAt = Date.now()
-    // pty.data の outbound buffer (WS not OPEN 中に積み、open 後 flush)。
-    // entry: { obj, ts }
-    this.ptyOutboundBuffer = []
-    // 制御/イベント系 (ack / jsonl.event 等) の outbound buffer。pty.data とは別管理で、
-    // 高頻度 pty.data の洪水に evict されないようにする (機構③)。entry: { obj, ts }
+    // 制御/イベント系 (ack / jsonl.event 等) の outbound buffer
+    // (WS not OPEN 中に積み、open 後 flush)。entry: { obj, ts }
     this.ctrlOutboundBuffer = []
     // reconnect 世代ごとの stream sync barrier。古い request_id の遅延応答で
     // 現接続の buffer を flush しないよう request_id を照合する。
@@ -282,11 +260,10 @@ export class WsClient extends EventEmitter {
       available_clis: this.availableClis,
       ...this.bundleStatus,
     })
-    // Plan ε: 毎回 reconnect 直後に backend ↔ agent の stream_id を能動同期する
-    // (orphan stream の即時 kill 用)。response は main.mjs の dispatch が拾い、
-    // ptyBridge.list() と差分を取って kill する。request_id は uuid で
-    // 重複排除。backend が古い (= Plan ε 未対応) なら "unknown_type" error が
-    // 返るだけで動作には影響しない。
+    // Plan ε: 毎回 reconnect 直後に backend ↔ agent の stream_id を能動同期する。
+    // response は main.mjs の dispatch が拾い、mode 別 snapshot から外れた
+    // chat subscriber を掃除する。request_id は uuid で重複排除。backend が
+    // 古い (= Plan ε 未対応) なら "unknown_type" error が返るだけで動作には影響しない。
     const streamsSyncRequestId = randomUUID()
     this._sendJson({
       type: "agent.streams.sync.request",
@@ -298,11 +275,11 @@ export class WsClient extends EventEmitter {
     this.emit("open")
   }
 
-  /** メッセージを送る。未接続時は pty.data と制御/イベント系 (ack / jsonl.event 等) を
+  /** メッセージを送る。未接続時は制御/イベント系 (ack / jsonl.event 等) を
    * buffer に積み、reconnect 後に flush する。
    *
    * heartbeat / hello / agent.streams.sync.* など「古くなると意味が無い」制御系は
-   * buffer しない (warn のみ)。ack / event 系は 1 件ずつ意味を持つので別バッファに保持する。
+   * buffer しない (warn のみ)。ack / event 系は 1 件ずつ意味を持つのでバッファに保持する。
    */
   send(obj) {
     const type = obj?.type
@@ -310,12 +287,8 @@ export class WsClient extends EventEmitter {
     // sync barrier 中に新しく発生した frame も同じ buffer へ積み、切断中 frame より
     // 先に送って時系列を逆転させない。heartbeat 等の非 buffer 制御系は通常どおり送る。
     const holdForStreamsSync = Boolean(this.pendingStreamsSyncRequestId)
-      && (type === "pty.data" || BUFFERED_CTRL_TYPES.has(type))
+      && BUFFERED_CTRL_TYPES.has(type)
     if (!wsOpen || holdForStreamsSync) {
-      if (type === "pty.data") {
-        this._bufferPtyData(obj)
-        return false
-      }
       if (BUFFERED_CTRL_TYPES.has(type)) {
         // SDK-P2 (2026-07-08): ephemeral な stream_event の content_block_delta (text/thinking
         // delta) は ctrl バッファに積まない。切断中は生成が続くと大量の delta が流れ、200 frame
@@ -340,50 +313,6 @@ export class WsClient extends EventEmitter {
     return this._sendJson(obj)
   }
 
-  /** pty.data を outbound buffer に積む。リング (drop oldest on overflow)。 */
-  _bufferPtyData(obj) {
-    this.ptyOutboundBuffer.push({ obj, ts: Date.now() })
-    if (this.ptyOutboundBuffer.length > PTY_BUFFER_MAX_FRAMES) {
-      const dropped = this.ptyOutboundBuffer.length - PTY_BUFFER_MAX_FRAMES
-      this.ptyOutboundBuffer.splice(0, dropped)
-      this.logger?.warn(
-        { dropped, kept: this.ptyOutboundBuffer.length },
-        "pty outbound buffer overflow (oldest dropped)"
-      )
-    }
-  }
-
-  /** open 直後に buffer を flush。古すぎる entry は破棄する。 */
-  _flushPtyBuffer() {
-    if (this.ptyOutboundBuffer.length === 0) return
-    const now = Date.now()
-    // B10: バッファを退避してから処理する。送信失敗 (_sendJson が false) で break
-    // した場合、未送信の残りフレームを ptyOutboundBuffer の先頭へ戻して順序を保持する
-    // (空配列で上書きしたまま break すると残りが欠落する)。
-    const buf = this.ptyOutboundBuffer
-    this.ptyOutboundBuffer = []
-    let sent = 0
-    let expired = 0
-    for (let i = 0; i < buf.length; i++) {
-      const entry = buf[i]
-      if (now - entry.ts > PTY_BUFFER_MAX_AGE_MS) {
-        expired += 1
-        continue
-      }
-      const ok = this._sendJson(entry.obj)
-      if (!ok) {
-        // 未送信分 (現エントリ含む i 以降) を先頭へ戻す。次回 open / flush で再送する。
-        this.ptyOutboundBuffer = buf.slice(i).concat(this.ptyOutboundBuffer)
-        break
-      }
-      sent += 1
-    }
-    this.logger?.info(
-      { sent, expired, total: buf.length, requeued: this.ptyOutboundBuffer.length },
-      "pty outbound buffer flushed"
-    )
-  }
-
   /** 制御/イベント系 (ack / jsonl.event 等) を outbound buffer に積む。リング (drop oldest)。 */
   _bufferCtrl(obj) {
     this.ctrlOutboundBuffer.push({ obj, ts: Date.now() })
@@ -398,7 +327,10 @@ export class WsClient extends EventEmitter {
   }
 
   /** open 直後に制御/イベントバッファを flush。古すぎる entry は破棄する。
-   * 構造は _flushPtyBuffer と同じ (退避 → 期限切れ skip → 送信失敗で残りを順序保持で戻す)。
+   *
+   * B10: バッファを退避してから処理する。送信失敗 (_sendJson が false) で break した
+   * 場合、未送信の残りフレームを ctrlOutboundBuffer の先頭へ戻して順序を保持する
+   * (空配列で上書きしたまま break すると残りが欠落する)。
    */
   _flushCtrlBuffer() {
     if (this.ctrlOutboundBuffer.length === 0) return
@@ -443,7 +375,6 @@ export class WsClient extends EventEmitter {
     // frame を失うため、2s compatibility timeout まで barrier を維持する。
     if (activeIds.size === 0) return false
     this._clearStreamsSyncBarrier()
-    this._flushPtyBuffer()
     this._flushCtrlBuffer()
     return true
   }
@@ -459,7 +390,6 @@ export class WsClient extends EventEmitter {
         { request_id: requestId },
         "streams sync barrier timed out; flushing buffered frames for legacy backend",
       )
-      this._flushPtyBuffer()
       this._flushCtrlBuffer()
     }, STREAMS_SYNC_BARRIER_TIMEOUT_MS)
     this.streamsSyncBarrierTimer.unref?.()

package/plugins/10-tailscale-remote/README.md

@@ -1,71 +0,0 @@
-# 10-tailscale-remote
-
-自宅 Mac (hub-agent host) を、Tailscale 等で繋がった会社 Mac (`remote_host`) の
-tmux に対する透過プロキシ化するサンプル plugin。
-
-## 何が起きるか
-
-| Browser action | 通常 (plugin 無し) | このプラグイン有効時 |
-|---|---|---|
-| `pty.attach` | ローカル `tmux attach -t SESSION` | `mosh remote_host -- tmux attach -t SESSION` |
-| `tmux.exec [...]` | ローカル `tmux ...` | `ssh remote_host tmux ...` |
-
-つまり、`hub.cocorograph.com/user/cockpit/terminal` から開くセッションが、
-あなたの手元 Mac ではなく `remote_host` の tmux に直接繋がります。Cockpit UI の
-`session.state` / `tmux.list_sessions` も全て `remote_host` 側の値です。
-
-## セットアップ
-
-1. ディレクトリを `~/.hub/plugins/10-tailscale-remote/` にコピー
-   ```bash
-   # CLI 経由 (推奨)
-   hub-agent plugins install 10-tailscale-remote
-
-   # 手動
-   mkdir -p ~/.hub/plugins/10-tailscale-remote
-   cp -r $(npm root -g)/@cocorograph/hub-agent/plugins/10-tailscale-remote/* \
-     ~/.hub/plugins/10-tailscale-remote/
-   ```
-
-2. `config.json` を編集
-   ```bash
-   cp ~/.hub/plugins/10-tailscale-remote/config.example.json \
-      ~/.hub/plugins/10-tailscale-remote/config.json
-   $EDITOR ~/.hub/plugins/10-tailscale-remote/config.json
-   ```
-
-   ```jsonc
-   {
-     "remote_host": "mbpm5-office",                       // ssh ホスト名
-     "ssh_key": "/Users/kaz/.ssh/mbpm5-office/id_ed25519",
-     "mosh_server": "/opt/homebrew/bin/mosh-server"       // remote_host 側のパス
-   }
-   ```
-
-3. remote 側の準備
-   - 同じユーザーで ssh 鍵ログイン可能であること
-   - `tmux` + `mosh-server` がインストール済みであること
-   - tmux session が既に走っていること (or `hub-agent` の `tmux.create_session` 経由で作る)
-
-4. hub-agent restart
-   ```bash
-   launchctl kickstart -k gui/$UID/co.cocorograph.hub-agent  # macOS
-   # or
-   systemctl --user restart hub-agent.service  # Linux
-   ```
-
-5. agent log で `tailscale-remote-ops 有効` の表示を確認
-   ```bash
-   tail -f ~/.hub/agent.log
-   ```
-
-## トラブルシューティング
-
-- `config.json` 無し → plugin は no-op で読み込まれます (`agent.log` に WARN)
-- ssh が「Host key verification failed」→ `ssh remote_host` で 1 度手動接続して known_hosts に追加
-- mosh が `Did not find mosh server startup message` → remote_host の `mosh_server` パスを確認 (`which mosh-server`)
-- Tailscale が落ちて remote_host に届かない → cockpit terminal を開くと WS 接続自体は成功するが pty が即 exit する
-
-## 仕様書
-
-[`ナレッジ/インフラ/cockpit-hub-hosted-integration-spec`](https://hub.cocorograph.com/knowledge/spec/cockpit-hub-hosted-integration-spec) (id=6080)

package/plugins/10-tailscale-remote/config.example.json

@@ -1,6 +0,0 @@
-{
-  "_comment": "このファイルを config.json にコピーしてから編集してください。",
-  "remote_host": "mbpm5-office",
-  "ssh_key": "/Users/kaz/.ssh/mbpm5-office/id_ed25519",
-  "mosh_server": "/opt/homebrew/bin/mosh-server"
-}

package/plugins/10-tailscale-remote/plugin.mjs

@@ -1,99 +0,0 @@
-/**
- * tailscale-remote: 自宅 Mac (hub-agent host) を 会社 Mac (remote_host) の
- * tmux に対する透過プロキシ化するプラグイン (Sprint K サンプル)。
- *
- * - `interceptPtySpawn`: ブラウザの attach を mosh + ssh + tmux attach に差し替え
- * - `interceptTmuxExec`: tmux.* RPC (list/create/kill 等) を ssh 越しに発行
- *
- * 使い方:
- *   1. `~/.hub/plugins/10-tailscale-remote/` にこのファイル + config.json を置く
- *      (`hub-agent plugins install 10-tailscale-remote` で自動コピー可)
- *   2. config.json の remote_host / ssh_key / mosh_server を埋める
- *   3. hub-agent restart (`hub-agent install-service` してあれば
- *      `launchctl kickstart -k gui/$UID/co.cocorograph.hub-agent`)
- *
- * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
- */
-import { readFileSync } from "node:fs"
-
-const cfgUrl = new URL("./config.json", import.meta.url)
-let cfg = { remote_host: "", ssh_key: "", mosh_server: "/opt/homebrew/bin/mosh-server" }
-try {
-  cfg = { ...cfg, ...JSON.parse(readFileSync(cfgUrl, "utf-8")) }
-} catch (err) {
-  // config.json が無い場合は plugin を no-op で読み込む (hook は何も上書きしない)
-  // user が編集してから restart する想定
-  cfg.__error = err.message
-}
-
-function isConfigured() {
-  return Boolean(cfg.remote_host && cfg.ssh_key && !cfg.__error)
-}
-
-function sshOpts() {
-  return ["-o", "IdentityAgent=none", "-i", cfg.ssh_key]
-}
-
-export default {
-  name: "tailscale-remote-ops",
-  hooks: {
-    async onAgentStart({ logger }) {
-      if (cfg.__error) {
-        logger?.warn(
-          { err: cfg.__error },
-          "tailscale-remote-ops: config.json が読めません。plugin は no-op で動作します",
-        )
-        return
-      }
-      if (!isConfigured()) {
-        logger?.warn(
-          { config: cfg },
-          "tailscale-remote-ops: remote_host / ssh_key が未設定。plugin は no-op",
-        )
-        return
-      }
-      logger?.info(
-        { remote_host: cfg.remote_host },
-        "tailscale-remote-ops 有効: pty.attach / tmux.exec を ssh 越しに発行します",
-      )
-    },
-
-    /**
-     * Browser からの attach を mosh + ssh + tmux attach に差し替える。
-     * pty bridge は通常通り node-pty で /bin/sh を spawn するが、その中身が
-     * remote_host への mosh ssh セッションになる。
-     */
-    async interceptPtySpawn({ sessionName }) {
-      if (!isConfigured()) return null
-      const sshOpt = sshOpts().join(" ")
-      const command = "/bin/sh"
-      const inner = [
-        `exec mosh`,
-        `--predict=adaptive`,
-        `--server=${cfg.mosh_server}`,
-        `--ssh="ssh ${sshOpt}"`,
-        cfg.remote_host,
-        `--`,
-        `bash -l -c "tmux attach -t ${sessionName}"`,
-      ].join(" ")
-      return {
-        command,
-        args: ["-c", inner],
-      }
-    },
-
-    /**
-     * tmux.* RPC (list-sessions / new-session / kill-session 等) を
-     * ssh 越しに remote_host で実行する。
-     */
-    async interceptTmuxExec({ args }) {
-      if (!isConfigured()) return null
-      return {
-        command: "ssh",
-        args: [...sshOpts(), cfg.remote_host, "tmux", ...args],
-      }
-    },
-  },
-}
-
-export const _internal = { cfg, isConfigured, sshOpts }

package/scripts/fix-node-pty-perms.mjs

@@ -1,89 +0,0 @@
-#!/usr/bin/env node
-// pnpm 経由インストールだと prebuilds/*/spawn-helper の実行権限が剥がれて
-// posix_spawnp が失敗する事象への workaround. postinstall で確実に +x を付与する。
-//
-// PTY backend は @lydell/node-pty (Microsoft 公式の fd-leak 修正フォーク) に移行済み。
-// prebuild は @lydell/node-pty-<platform>/prebuilds/<platform>/spawn-helper に入る
-// (npm install では +x 付きで展開されるが、pnpm 等で剥がれるケースに備えて修復する)。
-// 旧 node-pty の配置も後方互換で走査する。
-import { readdirSync, statSync, chmodSync } from "node:fs";
-import { join } from "node:path";
-
-const PNPM_GLOB = "node_modules/.pnpm";
-// prebuilds ディレクトリの候補 (node-pty 旧配置 + @lydell platform パッケージ)。
-const FALLBACK_DIRS = ["node_modules/node-pty/prebuilds"];
-
-function fixDir(dir) {
-  let count = 0;
-  for (const platform of readdirSync(dir)) {
-    const helper = join(dir, platform, "spawn-helper");
-    try {
-      const st = statSync(helper);
-      if (!(st.mode & 0o111)) {
-        chmodSync(helper, st.mode | 0o755);
-        console.log(`[fix-perms] chmod +x ${helper}`);
-        count++;
-      }
-    } catch {
-      // not present (e.g. win32 dir has no spawn-helper)
-    }
-  }
-  return count;
-}
-
-// @lydell の platform パッケージ (@lydell/node-pty-darwin-arm64 等) を走査する。
-function findLydellPrebuilds() {
-  const out = [];
-  const scopeDir = "node_modules/@lydell";
-  try {
-    for (const entry of readdirSync(scopeDir)) {
-      if (!entry.startsWith("node-pty-")) continue; // platform バイナリパッケージのみ
-      const p = join(scopeDir, entry, "prebuilds");
-      try {
-        statSync(p);
-        out.push(p);
-      } catch { /* prebuilds 無し */ }
-    }
-  } catch { /* @lydell scope 無し */ }
-  return out;
-}
-
-function findPnpmPrebuilds() {
-  const out = [];
-  try {
-    for (const entry of readdirSync(PNPM_GLOB)) {
-      let inner = null;
-      if (entry.startsWith("node-pty@")) {
-        // 旧 node-pty: node_modules/.pnpm/node-pty@x/node_modules/node-pty/prebuilds
-        inner = "node_modules/node-pty/prebuilds";
-      } else if (entry.startsWith("@lydell+node-pty-")) {
-        // @lydell platform: @lydell+node-pty-darwin-arm64@x → pkg 名 = node-pty-darwin-arm64
-        const pkg = entry.slice("@lydell+".length).split("@")[0];
-        inner = join("node_modules/@lydell", pkg, "prebuilds");
-      } else {
-        continue;
-      }
-      const p = join(PNPM_GLOB, entry, inner);
-      try {
-        statSync(p);
-        out.push(p);
-      } catch { /* skip */ }
-    }
-  } catch { /* no pnpm dir */ }
-  return out;
-}
-
-let fixed = 0;
-for (const dir of [...findPnpmPrebuilds(), ...findLydellPrebuilds()]) {
-  fixed += fixDir(dir);
-}
-for (const fallback of FALLBACK_DIRS) {
-  try {
-    statSync(fallback);
-    fixed += fixDir(fallback);
-  } catch { /* not hoisted */ }
-}
-
-if (fixed === 0) {
-  // 何も修正しなかった = 既に OK or node-pty 未インストール。サイレント終了。
-}