@cocorograph/hub-agent 0.6.18 → 0.6.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
   "type": "module",
   "license": "UNLICENSED",

package/src/claude-stream-bridge.mjs

@@ -389,12 +389,17 @@ class ClaudeStreamSession {
       // 走行中ターンは完走を待ち TTL 後に再チェック (走行中は絶対に撤去しない)
       if (this._busy) {
         this._idleTimer = setTimeout(tick, ttlMs)
+        // idle TTL は最大 7 日。タイマー単独でイベントループを生かさない (unref)。
+        // 本番デーモンは WS 接続等で常駐するので reap は問題なく発火し、テスト/CLI
+        // など他に handle が無いプロセスは即座に終了できる。
+        this._idleTimer.unref?.()
         return
       }
       this._idleTimer = null
       onTimeout?.()
     }
     this._idleTimer = setTimeout(tick, ttlMs)
+    this._idleTimer.unref?.()
   }
 
   /**

package/src/service-install.mjs

@@ -15,6 +15,8 @@ import path from "node:path"
 import { spawnSync } from "node:child_process"
 import { fileURLToPath } from "node:url"
 
+import { readConfig } from "./config.mjs"
+
 const PLIST_LABEL = "co.cocorograph.hub-agent"
 const SYSTEMD_UNIT_NAME = "hub-agent.service"
 
@@ -50,7 +52,7 @@ function escapeXmlText(s) {
     .replaceAll(">", ">")
 }
 
-function expandTemplate(text, hubAgentBin) {
+function expandTemplate(text, hubAgentBin, opts = {}) {
   // hub-agent デーモンの runtime 環境に必須な追加 env を、各プラットフォームの
   // 起動ファイル形式 (plist / systemd) に合わせて差し込むためのプレースホルダ展開。
   //
@@ -72,12 +74,43 @@ function expandTemplate(text, hubAgentBin) {
     // systemd 側: Environment=KEY=VALUE の 1 行。末尾 \n でテンプレ "__...__\n" を吸収。
     systemdLine = `Environment=NODE_EXTRA_CA_CERTS=${nodeExtraCa}\n`
   }
+
+  // 多端末共有チャット (HUB_AGENT_CHAT_SHARED)。NODE_EXTRA_CA_CERTS と同じ仕組みで
+  // plist / systemd の EnvironmentVariables に焼き込む。値ソースは (a) installService
+  // が agent.json.chat_shared を読んで渡す opts.chatShared、または (b) install-service
+  // 実行時の process.env.HUB_AGENT_CHAT_SHARED。これにより agent 更新で install-service
+  // が plist を再生成しても、agent.json に chat_shared=true があればフラグが維持される
+  // (旧実装は手動 plist 追記が再生成で消える事故があった。2026-05-30)。
+  const chatShared =
+    opts.chatShared === true || process.env.HUB_AGENT_CHAT_SHARED === "1"
+  let chatPlistEntry = ""
+  let chatSystemdLine = ""
+  if (chatShared) {
+    chatPlistEntry =
+      `    <key>HUB_AGENT_CHAT_SHARED</key>\n` +
+      `    <string>1</string>\n`
+    chatSystemdLine = `Environment=HUB_AGENT_CHAT_SHARED=1\n`
+  }
+
   return text
     .replaceAll("__HUB_AGENT_BIN__", hubAgentBin)
     .replaceAll("__HOME__", os.homedir())
     .replaceAll("__PATH__", process.env.PATH || "/usr/local/bin:/usr/bin:/bin")
     .replaceAll("__NODE_EXTRA_CA_CERTS_PLIST_ENTRY__", plistEntry)
     .replaceAll("__NODE_EXTRA_CA_CERTS_SYSTEMD_LINE__", systemdLine)
+    .replaceAll("__HUB_AGENT_CHAT_SHARED_PLIST_ENTRY__", chatPlistEntry)
+    .replaceAll("__HUB_AGENT_CHAT_SHARED_SYSTEMD_LINE__", chatSystemdLine)
+}
+
+/** agent.json から多端末共有フラグ (chat_shared) を読む。読めなければ false。
+ *  install-service 時に plist/systemd へ焼き込む値ソースに使う (env 併用は expandTemplate 側)。 */
+async function readChatSharedFromConfig() {
+  try {
+    const config = await readConfig()
+    return config?.chat_shared === true
+  } catch {
+    return false
+  }
 }
 
 async function ensureDir(p) {
@@ -95,6 +128,67 @@ function run(cmd, args, opts = {}) {
   }
 }
 
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+/**
+ * macOS の `launchctl bootout` は非同期で、graceful shutdown を持つ hub-agent は
+ * 実際に launchd の登録から消えるまでに時間がかかる。直後に `bootstrap` を叩くと
+ * 旧サービスがまだ抜け切っておらず `Bootstrap failed: 5: Input/output error` 等で
+ * 失敗し、plist はディスクにあるのにロードされない (= KeepAlive 不発 → offline)
+ * 状態に陥る。本関数は対象 service が launchd の登録から消えるまで polling して待つ。
+ * (2026-05-30: install-service の bootout→bootstrap レースで offline 化する事故の修正)
+ *
+ * @param {number} uid
+ * @param {{ timeoutMs?: number, intervalMs?: number }} [opts]
+ * @returns {Promise<boolean>} 消えたら true / timeout なら false
+ */
+async function waitUntilBootedOut(uid, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5000
+  const intervalMs = opts.intervalMs ?? 200
+  const spawn = opts.spawn ?? spawnSync
+  const sleepFn = opts.sleep ?? sleep
+  const now = opts.now ?? (() => Date.now())
+  const deadline = now() + timeoutMs
+  while (now() < deadline) {
+    const r = spawn("launchctl", ["print", `gui/${uid}/${PLIST_LABEL}`], {
+      stdio: "ignore",
+    })
+    // 非 0 = 登録に存在しない = bootout 完了
+    if (r.status !== 0) return true
+    await sleepFn(intervalMs)
+  }
+  return false
+}
+
+/**
+ * bootout 後の bootstrap を、過渡的失敗 (旧サービスの抜け残り等) に対して
+ * リトライする。`run` と違い最終的に失敗したときだけ throw する。
+ *
+ * @param {number} uid
+ * @param {string} dest plist パス
+ * @param {{ attempts?: number, intervalMs?: number }} [opts]
+ */
+async function bootstrapWithRetry(uid, dest, opts = {}) {
+  const attempts = opts.attempts ?? 4
+  const intervalMs = opts.intervalMs ?? 400
+  const spawn = opts.spawn ?? spawnSync
+  const sleepFn = opts.sleep ?? sleep
+  let lastStatus = null
+  for (let i = 0; i < attempts; i++) {
+    const r = spawn("launchctl", ["bootstrap", `gui/${uid}`, dest], {
+      stdio: "inherit",
+    })
+    if (r.status === 0) return
+    // 既にロード済み (status 37 / "service already loaded") は成功とみなす
+    if (r.status === 37) return
+    lastStatus = r.status
+    await sleepFn(intervalMs)
+  }
+  throw new Error(
+    `launchctl bootstrap gui/${uid} ${dest} failed after ${attempts} attempts (last exit ${lastStatus})`
+  )
+}
+
 /**
  * `which hub-agent` の結果を、launchd / systemd から長期間 exec 可能な
  * 安定パスに正規化する。pure 関数。`opts` で fs を差し替えてテスト可能。
@@ -156,24 +250,34 @@ export async function installService({ bin } = {}) {
   const hubAgentBin = bin || detectHubAgentBin()
   await ensureLogFile()
 
+  // agent.json の永続フラグを読み、テンプレ展開に渡す (再生成でも維持されるように)。
+  const chatShared = await readChatSharedFromConfig()
+
   if (process.platform === "darwin") {
     const tpl = await readTemplate("co.cocorograph.hub-agent.plist")
-    const expanded = expandTemplate(tpl, hubAgentBin)
+    const expanded = expandTemplate(tpl, hubAgentBin, { chatShared })
     const dest = macPlistPath()
     await ensureDir(path.dirname(dest))
     await fs.writeFile(dest, expanded, { mode: 0o644 })
 
     const uid = ensureUnixUid()
-    // 既存ロード解除 → bootstrap → kickstart
+    // 既存ロード解除 → (登録が消えるまで待機) → bootstrap (リトライ) → kickstart。
+    // bootout は非同期なので待たずに bootstrap するとレースで失敗し offline 化する
+    // (2026-05-30 の事故)。waitUntilBootedOut で確実に抜けてから bootstrap する。
     spawnSync("launchctl", ["bootout", `gui/${uid}`, dest], { stdio: "ignore" })
-    run("launchctl", ["bootstrap", `gui/${uid}`, dest])
-    run("launchctl", ["kickstart", "-k", `gui/${uid}/${PLIST_LABEL}`])
+    await waitUntilBootedOut(uid)
+    await bootstrapWithRetry(uid, dest)
+    // kickstart は「既に走っている daemon を再起動」する用途。bootstrap + RunAtLoad で
+    // 既に起動済みのことがあり、その場合 kickstart 失敗は致命的でないので throw しない。
+    spawnSync("launchctl", ["kickstart", "-k", `gui/${uid}/${PLIST_LABEL}`], {
+      stdio: "ignore",
+    })
     return { platform: "darwin", path: dest, label: PLIST_LABEL, bin: hubAgentBin }
   }
 
   if (process.platform === "linux") {
     const tpl = await readTemplate("hub-agent.service")
-    const expanded = expandTemplate(tpl, hubAgentBin)
+    const expanded = expandTemplate(tpl, hubAgentBin, { chatShared })
     const dest = linuxUnitPath()
     await ensureDir(path.dirname(dest))
     await fs.writeFile(dest, expanded, { mode: 0o644 })
@@ -264,4 +368,6 @@ export const _internal = {
   macPlistPath,
   linuxUnitPath,
   repoTemplatesDir,
+  waitUntilBootedOut,
+  bootstrapWithRetry,
 }

package/templates/co.cocorograph.hub-agent.plist

@@ -52,7 +52,7 @@
     <string>__PATH__</string>
     <key>HOME</key>
     <string>__HOME__</string>
-__NODE_EXTRA_CA_CERTS_PLIST_ENTRY__  </dict>
+__NODE_EXTRA_CA_CERTS_PLIST_ENTRY____HUB_AGENT_CHAT_SHARED_PLIST_ENTRY__  </dict>
 
   <!-- KeepAlive で過剰再起動した時に 10 秒スロットルする -->
   <key>ThrottleInterval</key>

package/templates/hub-agent.service

@@ -12,7 +12,7 @@ Type=simple
 # 行に、未 set なら空文字列に」展開する。
 Environment=PATH=__PATH__
 Environment=HOME=__HOME__
-__NODE_EXTRA_CA_CERTS_SYSTEMD_LINE__WorkingDirectory=__HOME__
+__NODE_EXTRA_CA_CERTS_SYSTEMD_LINE____HUB_AGENT_CHAT_SHARED_SYSTEMD_LINE__WorkingDirectory=__HOME__
 ExecStart=__HUB_AGENT_BIN__ start
 Restart=always
 RestartSec=10