@cocorograph/hub-agent 0.8.77 → 0.8.78

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.8.77",
+  "version": "0.8.78",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの Claude / Codex チャットと tmux セッションを中継する。",
   "type": "module",
   "license": "UNLICENSED",

package/src/chat-sessions-snapshot.mjs

@@ -1,9 +1,110 @@
+import path from "node:path"
 import { listChatTargets } from "./chat-targets.mjs"
+import { getChatSignal as defaultGetChatSignal } from "./chat-signals.mjs"
 import { describeLiveSessionsUnion } from "./live-sessions.mjs"
+import { sessionNameFor } from "./session-names.mjs"
+import { sanitizeTmuxName } from "./tmux.mjs"
+
+/**
+ * 会話 1 本の表示用シグナル。
+ *
+ * ⚠️ 出どころは `chat-signals.mjs` の `(cwd, cli_kind)` キーのストアで、**tmux に依存しない**。
+ * 旧 `tmux.list_sessions` 経路は同じ信号を「tmux セッション名をキーにした sidecar
+ * (`/tmp/cockpit_session_events/<名前>.json`) と state loop の snapshot」という間接経路で
+ * 配っていたが、どちらも tmux セッション行が無いと更新されない (bundle hook も
+ * `TMUX_PANE` が無ければ書かずに終了する)。会話を tmux から切り離す移行では、その経路は
+ * 静かに止まる。ここで cwd キーの信号を直接載せることで、移行後も入力待ち・生成中・
+ * 使用率が出る。名前をキーにしないので、同名 worktree でも帰属を取り違えない。
+ */
+function attachChatSignal(item, cwd, getChatSignal, logger) {
+  let sig
+  try {
+    sig = cwd ? getChatSignal(cwd, item.kind) : null
+  } catch (err) {
+    // 信号の取得失敗で会話一覧まで失わない。未取得の判定キーは作らない。
+    logger?.warn?.(
+      { err: err?.message || String(err), cwd },
+      "chat.sessions: chat signal failed",
+    )
+    return item
+  }
+  if (!sig) return item
+  item.chat_signal = {
+    // 'processing' | 'waiting' | null (null = 鮮度切れ。断定しない)
+    status: sig.status ?? null,
+    // permission / AskUserQuestion の応答待ち。入力待ちバッジの本来の出どころ。
+    input_pending: sig.inputPending === true,
+    context_pct: typeof sig.context_pct === "number" ? sig.context_pct : null,
+    // この信号がどの会話のものかの帰属 (frontend の使用率の帰属判定に使う)。
+    session_id: typeof sig.sessionId === "string" ? sig.sessionId : null,
+    // 最後にターンが動いた時刻 (ms)。
+    turn_at: typeof sig.turnAt === "number" ? sig.turnAt : 0,
+  }
+  return item
+}
+
+/** 直近に動いた方を優先するための比較値。負値 / 非数は「不明」として最後に回す。 */
+function idleRank(item) {
+  return typeof item?.idle_ms === "number" && item.idle_ms >= 0 ? item.idle_ms : Infinity
+}
 
 /** ローカル検出した宛先と、毎回取得するライブ会話を返す。 */
-export async function buildChatSessionsSnapshot({ bridges, logger }) {
-  const live = describeLiveSessionsUnion(bridges)
+export async function buildChatSessionsSnapshot({
+  bridges,
+  logger,
+  getChatSignal = defaultGetChatSignal,
+}) {
+  const descriptors = describeLiveSessionsUnion(bridges)
   const { targets, errors } = await listChatTargets({ logger })
+  const targetByCwd = new Map(targets.map((target) => [target.cwd, target]))
+  const named = descriptors.map((descriptor) => {
+    const item = { ...descriptor }
+    // ⚠️ cwd が無い記述子で path.basename に undefined を渡すと throw し、map ごと失敗して
+    // 会話一覧が丸ごと空になる (呼び出し側の catch が targets:[] live:[] を返す)。名前を
+    // 解決できない 1 本のために全部を失わない。
+    const cwd = typeof item.cwd === "string" ? item.cwd : ""
+    const dir = targetByCwd.get(cwd)?.name ?? (cwd ? sanitizeTmuxName(path.basename(cwd)) : "")
+    return { item, cwd, sessionName: dir ? sessionNameFor(dir, item.kind) : "" }
+  })
+
+  // ⚠️ session_name は dir 名から作るので、別 workspace 配下の同名 worktree は同じ名前へ
+  // 解決される (この端末でも cloudflare-plugin が 3 つの workspace 配下に実在する)。
+  //
+  // ここで 2 本返してはいけない。frontend のサイドバーは行キーが session_name で、
+  // 行・下書き・ポインタ・選択状態のすべてが「1 名前 = 1 行」を前提に Map で引いている。
+  // 旧 tmux 一覧経路では tmux のセッション名空間が一意だったので、この不変条件はタダで
+  // 成立していた (同名 worktree は片方しか起動できなかった)。会話を tmux から切り離すと
+  // 両方ライブになれるため、agent 側で畳んで不変条件を維持する。
+  //
+  // 残す 1 本は「直近に動いた方」。frontend の adaptChatSessions が同名を畳むときと
+  // 同じ規則 (idle_ms が小さい方、同値なら先勝ち) にして、どちらで畳んでも同じ行が残る。
+  // ⚠️ 表示シグナルは cwd キーなので、畳んで残った会話のものが正しく付く (畳み込みは
+  // 行の一意性のためで、帰属のためではない)。
+  const live = []
+  const indexByName = new Map()
+  for (const { item, cwd, sessionName } of named) {
+    if (!sessionName) {
+      live.push(item)
+      continue
+    }
+    item.session_name = sessionName
+    const prior = indexByName.get(sessionName)
+    if (prior === undefined) {
+      indexByName.set(sessionName, live.length)
+      live.push(attachChatSignal(item, cwd, getChatSignal, logger))
+      continue
+    }
+    const kept = live[prior]
+    const replace = idleRank(item) < idleRank(kept)
+    logger?.warn?.(
+      {
+        session_name: sessionName,
+        kept_cwd: replace ? cwd : kept.cwd,
+        dropped_cwd: replace ? kept.cwd : cwd,
+      },
+      "chat.sessions: session name collision (folded)",
+    )
+    if (replace) live[prior] = attachChatSignal(item, cwd, getChatSignal, logger)
+  }
   return { targets, live, errors }
 }

package/src/chat-targets.mjs

@@ -1,7 +1,7 @@
 import fs from "node:fs/promises"
 import path from "node:path"
 import { hubProjectsBase } from "./chat-workspace.mjs"
-import { listWorktreeEntries } from "./tmux.mjs"
+import { listWorktreeEntries, sanitizeTmuxName } from "./tmux.mjs"
 import { AsyncTtlCache } from "./async-ttl-cache.mjs"
 
 export const chatTargetsCache = new AsyncTtlCache({ ttlMs: 3000 })
@@ -23,7 +23,7 @@ export async function listChatTargets({ logger } = {}) {
     try {
       workspaces = (await fs.readdir(base, { withFileTypes: true }))
         .filter((entry) => entry.isDirectory() && !entry.name.startsWith("."))
-        .map((entry) => ({ kind: "workspace", name: entry.name, cwd: path.join(base, entry.name) }))
+        .map((entry) => ({ kind: "workspace", name: sanitizeTmuxName(entry.name), cwd: path.join(base, entry.name) }))
     } catch (err) {
       // ⚠️ ENOENT は「base がまだ作られていない」であって走査の失敗ではない。worktree 側
       // (tmux.mjs の listWorktreeEntries) と扱いを揃える。ここで errors に入れると、正常な

package/src/tmux.mjs

@@ -31,7 +31,7 @@ const execFileP = promisify(execFile)
 
 const DEFAULT_TMUX_BIN = "tmux"
 
-function sanitizeTmuxName(s) {
+export function sanitizeTmuxName(s) {
   return s.replace(/[.:]/g, "-")
 }