@cocorograph/hub-agent 0.7.4 → 0.7.5

package/package.json

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

package/src/main.mjs

@@ -74,6 +74,7 @@ import {
   recoverTuiInput,
   removeWorktree as removeWorktreeDir,
   resumeWithMessage,
+  pasteToSessionByName,
   setSessionMouse,
   setTmuxGlobalEnv,
   setTuiEffort,
@@ -1433,6 +1434,13 @@ export function handleUntrackedPtyData(msg, ctx) {
   }
 }
 
+/**
+ * 離席中キュー投入 (claude.tui.queue.flush) の冪等化用に、処理済み flush_id を記憶する。
+ * WS 再送で同じ flush が二重に届いても二重 paste しないため。上限を超えたら全消去 (best-effort)。
+ */
+const _seenFlushIds = new Set()
+const _SEEN_FLUSH_CAP = 2000
+
 async function dispatch(msg, ctx) {
   const t = msg?.type || ""
   try {
@@ -1974,6 +1982,58 @@ async function dispatch(msg, ctx) {
         })()
         return
       }
+      case "claude.tui.queue.flush": {
+        // 離席中(非アクティブセッション)キュー自動投入 (案A の agent 側受け口)。
+        // ブラウザの常駐ドレイン (useCockpitTuiQueueDrainAll) が、表示していないセッションの
+        // 送信待ちキュー先頭 1 件をここへ送る。tmux send-keys (PTY 非依存) で投入するので、
+        // そのセッションのターミナルを誰も開いていなくても届く。結果を flush.ack で返し、
+        // ブラウザは ack を受けてはじめて localStorage から 1 件 dequeue する (冪等)。
+        const sessionName =
+          typeof msg.session_name === "string" ? msg.session_name : ""
+        const text = typeof msg.text === "string" ? msg.text : ""
+        const flushId = typeof msg.flush_id === "string" ? msg.flush_id : ""
+        const ackFail = (reason) => {
+          if (flushId && sessionName) {
+            ctx.client.send({
+              type: "claude.tui.queue.flush.ack",
+              session_name: sessionName,
+              flush_id: flushId,
+              ok: false,
+              error: reason,
+            })
+          }
+        }
+        if (!sessionName || !flushId || !text) {
+          ackFail("missing session_name / flush_id / text")
+          return
+        }
+        // 冪等化: 同一 flush_id を既に処理済みなら再 paste せず ok を返す (ブラウザは dequeue 済み
+        // を再確認するだけ)。WS 再送・ack 取りこぼしによる二重投入を防ぐ。
+        if (_seenFlushIds.has(flushId)) {
+          ctx.client.send({
+            type: "claude.tui.queue.flush.ack",
+            session_name: sessionName,
+            flush_id: flushId,
+            ok: true,
+          })
+          return
+        }
+        ;(async () => {
+          const result = await pasteToSessionByName(sessionName, text, { logger })
+          if (result.ok) {
+            if (_seenFlushIds.size >= _SEEN_FLUSH_CAP) _seenFlushIds.clear()
+            _seenFlushIds.add(flushId)
+          }
+          ctx.client.send({
+            type: "claude.tui.queue.flush.ack",
+            session_name: sessionName,
+            flush_id: flushId,
+            ok: !!result.ok,
+            error: result.ok ? undefined : result.error,
+          })
+        })()
+        return
+      }
       case "claude.tui.rehydratePermissions": {
         // セッション切替でビューが再マウントすると、その時点の承認/質問カードは React
         // state ごと消える (agent は claude.permission.request を 1 回しか push しない)。

package/src/tmux.mjs

@@ -796,6 +796,17 @@ export function isSafeSessionId(sessionId) {
   return typeof sessionId === "string" && /^[A-Za-z0-9_-]{8,128}$/.test(sessionId)
 }
 
+/** tmux セッション名として安全な形だけ許可する。`-t <name>` の引数に流すため、先頭ハイフン
+ *  (フラグ誤認) や予期せぬ文字を弾く。agent が作るセッション名は英数・`_`・`-`・`.` のみ。 */
+export function isSafeSessionName(name) {
+  return typeof name === "string" && /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/.test(name)
+}
+
+/** bracketed paste マーカーと貼り付け確定の待ち時間 (pasteToSessionByName 用)。 */
+const PASTE_START = "\x1b[200~"
+const PASTE_END = "\x1b[201~"
+const PASTE_CONFIRM_DELAY_MS = 120
+
 /** agent 設定 (model / permissionMode) を claude のフラグ文字列に変換する ("" or "--model X ...")。 */
 export function composeClaudeFlags(opts = {}) {
   const model = (opts.model || "").trim()
@@ -953,6 +964,55 @@ export async function resumeWithMessage(name, text, opts = {}) {
   }
 }
 
+/**
+ * 離席中キュー投入: 送信待ちメッセージ 1 件を、ブラウザがそのセッションのターミナルを
+ * マウントしていなくても tmux send-keys で対話 claude TUI へ投入する (案A の agent 側実体)。
+ *
+ * resumeWithMessage は改行を空白へ畳む単一行用 (誤確定防止) でチャット本文の複数行を壊すため、
+ * こちらは **bracketed paste** (ESC[200~ … ESC[201~) で本文を「貼り付け」として送り、改行を
+ * 保ったまま入力欄へ入れてから、確定の Enter (CR) を別途送る。これは frontend の通常送信
+ * (`\x1b[200~${text}\x1b[201~` → CR) と同じ手順を agent 側で再現したもの。PTY 非依存
+ * (tmux send-keys) なので、当該セッションのターミナルを誰も開いていなくても届く。
+ *
+ * @param {string} name tmux セッション名
+ * @param {string} text 投入する本文 (複数行可)
+ * @param {{logger?:object,tmuxBin?:string}} [opts]
+ * @returns {Promise<{ok:boolean, error?:string}>}
+ */
+export async function pasteToSessionByName(name, text, opts = {}) {
+  const bin = tmuxBin(opts)
+  const body = String(text ?? "")
+  if (!body) return { ok: false, error: "empty paste text" }
+  if (!isSafeSessionName(name)) return { ok: false, error: "unsafe session name" }
+  try {
+    // copy-mode 等に入っているとキーが奪われるので先に抜ける (cyclePermission と同じ防御)。
+    try {
+      await execFileP(bin, ["send-keys", "-t", name, "-X", "cancel"])
+    } catch {
+      /* copy-mode でなければ "not in a mode" エラー = 無視 */
+    }
+    // bracketed paste の開始/終了マーカーと本文を literal (-l) で送る。改行を含む本文も
+    // 「貼り付け」として扱われ、Claude TUI は改行で確定しない (CR を別送するまで未確定)。
+    await execFileP(bin, ["send-keys", "-t", name, "-l", PASTE_START])
+    await execFileP(bin, ["send-keys", "-t", name, "-l", body])
+    await execFileP(bin, ["send-keys", "-t", name, "-l", PASTE_END])
+    // 貼り付けが入力欄へ反映される猶予を置いてから確定 (CR を本文より先着させない)。
+    await _delay(PASTE_CONFIRM_DELAY_MS)
+    await execFileP(bin, ["send-keys", "-t", name, "Enter"])
+    opts.logger?.info(
+      { session: name, len: body.length },
+      "tui queue flush: pasted queued message (headless)",
+    )
+    return { ok: true }
+  } catch (err) {
+    opts.logger?.warn(
+      { session: name, err: err?.message },
+      "pasteToSessionByName failed",
+    )
+    return { ok: false, error: err?.message || String(err) }
+  }
+}
+
 /**
  * 対話 claude TUI に shift+tab (BACKTAB) を 1 回送って権限モードを循環させる。
  *