@cocorograph/hub-agent 0.5.8 → 0.5.10

package/package.json

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

package/src/main.mjs

@@ -10,8 +10,8 @@
  *
  * 仕様書: ナレッジ/インフラ/cockpit-hub-hosted-integration-spec (id=6080)
  */
-import { readFileSync } from "node:fs"
-import { readFile } from "node:fs/promises"
+import { readFileSync, watch as fsWatch } from "node:fs"
+import { mkdir, readFile, readdir } from "node:fs/promises"
 import os from "node:os"
 import path from "node:path"
 
@@ -119,11 +119,16 @@ export async function startDaemon({ version, ptyModule } = {}) {
   // 5s 周期で全 tmux session の状態を捕捉し、変化したものだけ session.state を push。
   // browser がフォーカスしていない session でも常時更新するためのバックグラウンド職人。
   const stateLoop = startStateLoop({ client, plugins, logger, intervalMs: 5_000 })
+  // bundle hook (cockpit_session_event_hook.py) が /tmp/cockpit_session_events/<name>.json
+  // に書き出す UserPromptSubmit / Stop の event を fs.watch で拾って WS push する。
+  // text マーカー判定 (detectStatusFromText) より精度が高い「ターン境界」の signal。
+  const sessionEventLoop = await startSessionEventWatcher({ client, logger })
 
   const shutdown = async (signal) => {
     logger.info({ signal }, "shutting down")
     await runHookBroadcast(plugins, "onAgentStop", ctx)
     stateLoop.stop()
+    sessionEventLoop?.stop?.()
     ptyBridge.shutdown()
     client.stop()
     process.exit(0)
@@ -134,6 +139,81 @@ export async function startDaemon({ version, ptyModule } = {}) {
   return { client, plugins, ptyBridge }
 }
 
+const SESSION_EVENTS_DIR =
+  process.env.COCKPIT_SESSION_EVENTS_DIR || "/tmp/cockpit_session_events"
+
+/**
+ * `/tmp/cockpit_session_events/<tmux_session>.json` を fs.watch して
+ * UserPromptSubmit / Stop の event を `session.event` 型で Hub に push する。
+ *
+ * 各 .json は `{ "event": "prompt_submit" | "stop", "at": <epoch_ms> }` 形式。
+ * - bundle 配信の `cockpit_session_event_hook.py` が claude code の hook 経由で
+ *   ターン境界に書き換える
+ * - capture-pane の text 判定よりタイミングが正確で attach の影響を受けない
+ *
+ * ディレクトリが無ければ作成し、起動直後に既存ファイルを 1 回読んで初期 push。
+ * 以降は変更検知のたびに該当ファイルを読み直して push する。
+ */
+async function startSessionEventWatcher({ client, logger }) {
+  try {
+    await mkdir(SESSION_EVENTS_DIR, { recursive: true })
+  } catch (err) {
+    logger?.warn(
+      { err: err.message, dir: SESSION_EVENTS_DIR },
+      "session event watcher: failed to mkdir, watcher disabled",
+    )
+    return null
+  }
+
+  const pushFile = async (filename) => {
+    if (!filename || !filename.endsWith(".json")) return
+    const sessionName = filename.slice(0, -5)
+    const full = path.join(SESSION_EVENTS_DIR, filename)
+    try {
+      const text = await readFile(full, "utf-8")
+      const data = JSON.parse(text)
+      if (!data || typeof data.event !== "string") return
+      client.send({
+        type: "session.event",
+        session_name: sessionName,
+        event: data.event,
+        at: typeof data.at === "number" ? data.at : Date.now(),
+      })
+    } catch {
+      // 一時欠如 / parse 失敗等は無視 (次の変更で読み直す)
+    }
+  }
+
+  // 起動時に既存ファイルを 1 回読んで初期 push (再起動後に取りこぼし防止)
+  try {
+    const files = await readdir(SESSION_EVENTS_DIR)
+    for (const f of files) await pushFile(f)
+  } catch {
+    // 無視
+  }
+
+  let watcher = null
+  try {
+    watcher = fsWatch(SESSION_EVENTS_DIR, { persistent: false }, (_event, filename) => {
+      if (!filename) return
+      // 名前文字列で来るので path.basename 不要
+      pushFile(filename).catch(() => {})
+    })
+  } catch (err) {
+    logger?.warn(
+      { err: err.message, dir: SESSION_EVENTS_DIR },
+      "session event watcher: fs.watch failed, watcher disabled",
+    )
+    return null
+  }
+
+  return {
+    stop() {
+      try { watcher?.close() } catch {}
+    },
+  }
+}
+
 /**
  * 全 tmux session の状態を定期 capture し、変化したものだけ Hub に push する。
  *
@@ -319,6 +399,8 @@ async function dispatch(msg, ctx) {
         try {
           await createTmuxSession(name, cwd, {
             claudeCmd: typeof msg.claude_cmd === "string" ? msg.claude_cmd : undefined,
+            initialPrompt:
+              typeof msg.initial_prompt === "string" ? msg.initial_prompt : undefined,
             logger: ctx.logger,
           })
           ctx.client.send({
@@ -364,6 +446,8 @@ async function dispatch(msg, ctx) {
           // worktree dir で tmux session を作成 (claude_cmd は createSession の default)
           await createTmuxSession(wtName, wtPath, {
             claudeCmd: typeof msg.claude_cmd === "string" ? msg.claude_cmd : undefined,
+            initialPrompt:
+              typeof msg.initial_prompt === "string" ? msg.initial_prompt : undefined,
             logger: ctx.logger,
           })
           ctx.client.send({

package/src/tmux.mjs

@@ -163,6 +163,26 @@ function tmuxBin(opts = {}) {
   return opts.tmuxBin || DEFAULT_TMUX_BIN
 }
 
+/**
+ * claudeCmd の各 `claude ... --permission-mode auto` の直後に
+ * initialPrompt を shell-safe quoting で末尾引数として注入する。
+ *
+ * `claude --foo --permission-mode auto || claude --bar --permission-mode auto`
+ * のように `||` で連結された OR 構造の両側に同じ prompt を埋め込むため、
+ * グローバル置換を行う。マッチが無ければ無加工の claudeCmd を返す
+ * (ユーザー定義 claudeCmd が独自フォーマットで `--permission-mode auto` を
+ * 含まない場合は noop)。
+ *
+ * `JSON.stringify` は `"` `\` 制御文字を `\u00xx` 等で安全にエスケープし、
+ * 結果は double-quoted な shell リテラルとしてそのまま使える。
+ */
+export function injectInitialPrompt(claudeCmd, initialPrompt) {
+  if (!initialPrompt || typeof initialPrompt !== "string") return claudeCmd
+  if (typeof claudeCmd !== "string" || claudeCmd.length === 0) return claudeCmd
+  const quoted = JSON.stringify(initialPrompt)
+  return claudeCmd.replace(/--permission-mode auto/g, `--permission-mode auto ${quoted}`)
+}
+
 /**
  * 汎用 tmux 実行。`tmux.exec` メッセージから呼び出される。
  *
@@ -317,6 +337,9 @@ export async function killManySessions(names, opts = {}) {
  * 新規 session を detached で作成して claude を起動する。
  * - 同名 session が既にあれば 'duplicate session' throw
  * - opts.claudeCmd で send-keys 内容を上書き可 (空文字なら claude 自動起動しない)
+ * - opts.initialPrompt を渡すと `claude ... --permission-mode auto` の直後に
+ *   shell-safe 引数として埋め込まれ、claude TUI の初回プロンプトとして実行される
+ *   (`/orchestrate` 等のスキル発火に利用)
  */
 export async function createSession(name, cwd, opts = {}) {
   // tmux は `-c` をシェル展開しないため、ここで `~` を絶対パスに展開する。
@@ -366,7 +389,8 @@ export async function createSession(name, cwd, opts = {}) {
       // display-message 失敗は致命的でないので飲み込む
     }
   }
-  const claudeCmd = opts.claudeCmd ?? DEFAULT_CLAUDE_CMD
+  const claudeCmdBase = opts.claudeCmd ?? DEFAULT_CLAUDE_CMD
+  const claudeCmd = injectInitialPrompt(claudeCmdBase, opts.initialPrompt)
   if (claudeCmd) {
     await execFileP(tmuxBin(opts), ["send-keys", "-t", name, claudeCmd, "Enter"])
   }