@cocorograph/hub-agent 0.8.116 → 0.8.118

package/package.json

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

package/src/claude-stream-bridge.mjs

@@ -34,35 +34,14 @@ import {
 } from "./tool-result-mask.mjs"
 import { createClaudeDisplayMasker, claudeMaskFailure } from "./claude-display-mask.mjs"
 import { copyPermissionInput, preparePermissionInput, restorePermissionInput, PERMISSION_MASK_DENIAL } from "./permission-display-mask.mjs"
-import { getOrCreateSiblingToken } from "./sibling-token.mjs"
+import { buildSiblingEnv } from "./sibling-token.mjs"
 import { recordInjectSourcePersistent } from "./inject-source-store.mjs"
 import { readPositiveIntEnv, sanitizePositiveInt } from "./positive-int-env.mjs"
 import { nextSessionSeq } from "./session-seq.mjs"
 
-/**
- * sibling-inject (2026-07-04) 用: spawn する claude プロセス自身の環境変数に、
- * この cwd の capability トークンを乗せる。ディスクには書かず、プロセス環境変数
- * としてのみ渡す (src/sibling-token.mjs のコメント参照)。
- * @param {string} cwd
- * @returns {NodeJS.ProcessEnv & {COCKPIT_SIBLING_TOKEN: string, COCKPIT_SIBLING_CWD: string,
- *   COCKPIT_DELEGATE_EVENT_ACK: string}}
- */
+/** sibling-inject 用の spawn 環境 (共通処理は sibling-token.mjs の buildSiblingEnv)。 */
 function siblingEnvFor(cwd) {
-  return {
-    ...process.env,
-    COCKPIT_SIBLING_TOKEN: getOrCreateSiblingToken(cwd),
-    COCKPIT_SIBLING_CWD: cwd,
-    // Spawn-time display capability; rejection by an older daemon does not stop the review.
-    COCKPIT_REVIEW_EVENTS: "1",
-    // hub-agent が spawn した Claude 配下 producer だけが delegate-event の受理 ACK を
-    // 要求するための capability。能力は spawn 時点で固定されるため、hub-agent を旧版へ
-    // ロールバックしても既存 producer は ACK を要求し続け、timeout し得る。
-    // 旧 bundle はこの値を無視し、従来どおり fire-and-forget のまま動く。
-    COCKPIT_DELEGATE_EVENT_ACK: "1",
-    // ask-sibling スキル (cockpit_orch.py) が「自分は claude/codex どちらか」を
-    // 環境変数から確実に判定できるようにする (ヒューリスティック不要)。
-    COCKPIT_SIBLING_SELF_KIND: "claude",
-  }
+  return buildSiblingEnv(cwd, { selfKind: "claude", delegateEventAck: true })
 }
 
 /** browser 切断後、セッションを生かしたまま再接続を待つ idle TTL (ミリ秒)。これを過ぎ、

package/src/codex-stream-bridge.mjs

@@ -68,7 +68,7 @@ import {
   snapshotCodexDeliveryAudit,
   verifyCodexDeliveryAudit,
 } from "./codex-delivery-audit.mjs"
-import { getOrCreateSiblingToken } from "./sibling-token.mjs"
+import { buildSiblingEnv } from "./sibling-token.mjs"
 import { readPositiveIntEnv, sanitizePositiveInt } from "./positive-int-env.mjs"
 import { nextSessionSeq } from "./session-seq.mjs"
 import { codexRolloutPresence, listCodexThreadsFromDisk } from "./usage.mjs"
@@ -192,25 +192,10 @@ async function buildCodexHostCapabilities({
   }
 }
 
-/**
- * sibling-inject (2026-07-04) 用: spawn する codex app-server プロセス自身の
- * 環境変数に、この cwd の capability トークンを乗せる。ディスクには書かず、
- * プロセス環境変数としてのみ渡す (src/sibling-token.mjs のコメント参照、
- * claude-stream-bridge.mjs の同名ヘルパーと対)。
- * @param {string} cwd
- * @returns {NodeJS.ProcessEnv}
- */
+/** sibling-inject 用の spawn 環境 (共通処理は sibling-token.mjs の buildSiblingEnv)。
+ *  Codex には delegate-event の ACK capability を付けない。 */
 function siblingEnvFor(cwd) {
-  return {
-    ...process.env,
-    COCKPIT_SIBLING_TOKEN: getOrCreateSiblingToken(cwd),
-    COCKPIT_SIBLING_CWD: cwd,
-    // Spawn-time display capability; rejection by an older daemon does not stop the review.
-    COCKPIT_REVIEW_EVENTS: "1",
-    // ask-sibling スキル (cockpit_orch.py) が「自分は claude/codex どちらか」を
-    // 環境変数から確実に判定できるようにする (ヒューリスティック不要)。
-    COCKPIT_SIBLING_SELF_KIND: "codex",
-  }
+  return buildSiblingEnv(cwd, { selfKind: "codex" })
 }
 
 // ── Stage 5 (2026-07-19): bounded warm pool + 長 idle TTL への再設計 ───────────

package/src/grok-stream-bridge.mjs

@@ -3,23 +3,13 @@ import { EventEmitter } from 'node:events'
 import { readPositiveIntEnv, sanitizePositiveInt } from './positive-int-env.mjs'
 import { GrokAcpClient } from './grok-acp-client.mjs'
 import { isUnderRemoval } from './chat-removal-guard.mjs'
-import { getOrCreateSiblingToken } from './sibling-token.mjs'
+import { buildSiblingEnv } from './sibling-token.mjs'
 
 // hub-bundle.mjs の HUB_MCP_NAMES と揃える。重い依存を避け、ここで定義する。
 const HUB_MCP_NAMES = new Set(['hub', 'hub_staff'])
 
 function siblingEnvFor(cwd, inherited = process.env) {
-  const env = {
-    ...inherited,
-    COCKPIT_SIBLING_TOKEN: getOrCreateSiblingToken(cwd),
-    COCKPIT_SIBLING_CWD: cwd,
-    COCKPIT_REVIEW_EVENTS: '1',
-    COCKPIT_DELEGATE_EVENT_ACK: '1',
-    COCKPIT_SIBLING_SELF_KIND: 'grok',
-  }
-  delete env.CLAUDE_CODE_SESSION_ID
-  delete env.CODEX_THREAD_ID
-  return env
+  return buildSiblingEnv(cwd, { selfKind: 'grok', delegateEventAck: true, stripParentSessionIds: true, inherited })
 }
 
 // 完了済み配送 ID の保持上限。上限を超えた古い完了済み ID の再送は再実行されうる。
@@ -489,6 +479,10 @@ export class GrokStreamBridge extends EventEmitter {
     session.cancelledTurn = session.turnSeq
     this._clearTurnPermissions(session, session.turnSeq, true)
     session.client.notify('session/cancel', { sessionId: session.sessionId })
+    if (!session.promptInFlight && !session.dispatchingInput) {
+      this.emit('grok_turn_complete', { stream_id: session.stream_id, session_id: session.sessionId,
+        stopReason: 'cancelled', lastSeq: session.updateSeq })
+    }
   }
 
   permissionReply({ stream_id, request_id, result }) {

package/src/main.mjs

@@ -3722,6 +3722,61 @@ export function createClaudeAttachTiming(ctx, msg) {
   }
 }
 
+/**
+ * Cockpit チャットの添付ファイル受信 (チャンク 1 件) を Claude / Codex / Grok で共有する。
+ * CLI ごとに違うのは返信型と既定 cwd だけ。既定 cwd は uploadManager がある場合に限り、
+ * msg.cwd が無いときだけ評価する。完了チャンクだけに done を返し、継続中チャンクは応答しない
+ * (browser は自分のチャンク送出完了で進捗を把握する)。
+ * @param {object} msg
+ * @param {object} ctx
+ * @param {string} doneType
+ * @param {() => string | undefined} getDefaultCwd
+ */
+async function handleChatUpload(msg, ctx, doneType, getDefaultCwd) {
+  if (!ctx.uploadManager) {
+    ctx.client.send({
+      type: doneType,
+      stream_id: msg.stream_id,
+      upload_id: msg.upload_id,
+      ok: false,
+      error: "upload_unavailable",
+    })
+    return
+  }
+  try {
+    const res = await ctx.uploadManager.addChunk({
+      upload_id: msg.upload_id,
+      filename: msg.filename,
+      media_type: msg.media_type,
+      total_size: msg.total_size,
+      total_chunks: msg.total_chunks,
+      chunk_index: msg.chunk_index,
+      data: msg.data,
+      cwd: msg.cwd || getDefaultCwd(),
+    })
+    if (res.done) {
+      ctx.client.send({
+        type: doneType,
+        stream_id: msg.stream_id,
+        upload_id: msg.upload_id,
+        ok: true,
+        path: res.path,
+        filename: res.filename,
+        media_type: res.media_type,
+        size: res.size,
+      })
+    }
+  } catch (err) {
+    ctx.client.send({
+      type: doneType,
+      stream_id: msg.stream_id,
+      upload_id: msg.upload_id,
+      ok: false,
+      error: err?.message || String(err),
+    })
+  }
+}
+
 /**
  * DispatchScheduler から呼ばれる本番メッセージ入口。
  * export はハンドラ契約を subprocess なしで検証するテスト専用の公開面でもある。
@@ -3739,10 +3794,11 @@ export async function dispatch(msg, ctx) {
           runInLane: scheduler && ((lane, fn) => scheduler.runInLane(lane, fn)),
           claudeBridge: ctx.claudeBridge,
           codexBridge: ctx.codexBridge,
+          grokBridge: ctx.grokBridge,
           claudeAttachOptions: () => resolveClaudeAttachOptions(ctx.config),
           available: (kind) => kind === "codex"
             ? codexAvailableForDispatch(ctx)
-            : ctx.availableClis?.includes("claude") === true,
+            : ctx.availableClis?.includes(kind) === true,
           logger: ctx.logger,
         })
         return
@@ -3945,56 +4001,12 @@ export async function dispatch(msg, ctx) {
         // message: { role: 'user', content: string | Array } を期待
         handleClaudeChatInput(msg, ctx)
         return
-      case "claude.upload": {
+      case "claude.upload":
         // Cockpit チャットモードの添付ファイル受信 (チャンク 1 件)。全チャンク到着で
         // cwd 配下の .cockpit-uploads/<日付>/ に保存し、保存パスを browser へ返す。
         // browser はそのパスを claude.input 本文に載せ、Claude が Read ツールで読む。
-        if (!ctx.uploadManager) {
-          ctx.client.send({
-            type: "claude.upload.done",
-            stream_id: msg.stream_id,
-            upload_id: msg.upload_id,
-            ok: false,
-            error: "upload_unavailable",
-          })
-          return
-        }
-        try {
-          const res = await ctx.uploadManager.addChunk({
-            upload_id: msg.upload_id,
-            filename: msg.filename,
-            media_type: msg.media_type,
-            total_size: msg.total_size,
-            total_chunks: msg.total_chunks,
-            chunk_index: msg.chunk_index,
-            data: msg.data,
-            cwd: msg.cwd || ctx.config?.claude_cwd || undefined,
-          })
-          if (res.done) {
-            // 完了チャンクのみ done を返す。継続中チャンクは応答しない
-            // (browser は自分のチャンク送出完了で進捗を把握する)。
-            ctx.client.send({
-              type: "claude.upload.done",
-              stream_id: msg.stream_id,
-              upload_id: msg.upload_id,
-              ok: true,
-              path: res.path,
-              filename: res.filename,
-              media_type: res.media_type,
-              size: res.size,
-            })
-          }
-        } catch (err) {
-          ctx.client.send({
-            type: "claude.upload.done",
-            stream_id: msg.stream_id,
-            upload_id: msg.upload_id,
-            ok: false,
-            error: err?.message || String(err),
-          })
-        }
+        await handleChatUpload(msg, ctx, "claude.upload.done", () => ctx.config?.claude_cwd || undefined)
         return
-      }
       case "claude.permission.reply": {
         if (!ctx.claudeBridge) return
         ctx.claudeBridge.permissionReply({
@@ -4335,59 +4347,11 @@ export async function dispatch(msg, ctx) {
         return
       }
       case "grok.upload":
-      case "codex.upload": {
-        // パス参照方式の添付受信を共有し、返信型と既定 cwd だけを切り替える。
-        async function handleUpload(doneType, getDefaultCwd) {
-          if (!ctx.uploadManager) {
-            ctx.client.send({
-              type: doneType,
-              stream_id: msg.stream_id,
-              upload_id: msg.upload_id,
-              ok: false,
-              error: "upload_unavailable",
-            })
-            return
-          }
-          try {
-            const res = await ctx.uploadManager.addChunk({
-              upload_id: msg.upload_id,
-              filename: msg.filename,
-              media_type: msg.media_type,
-              total_size: msg.total_size,
-              total_chunks: msg.total_chunks,
-              chunk_index: msg.chunk_index,
-              data: msg.data,
-              cwd: msg.cwd || getDefaultCwd(),
-            })
-            if (res.done) {
-              ctx.client.send({
-                type: doneType,
-                stream_id: msg.stream_id,
-                upload_id: msg.upload_id,
-                ok: true,
-                path: res.path,
-                filename: res.filename,
-                media_type: res.media_type,
-                size: res.size,
-              })
-            }
-          } catch (err) {
-            ctx.client.send({
-              type: doneType,
-              stream_id: msg.stream_id,
-              upload_id: msg.upload_id,
-              ok: false,
-              error: err?.message || String(err),
-            })
-          }
-        }
-        if (msg.type === "grok.upload") {
-          await handleUpload("grok.upload.done", () => defaultLaneCwd(ctx.config, "grok"))
-        } else {
-          await handleUpload("codex.upload.done", () => ctx.config?.claude_cwd || undefined)
-        }
+        await handleChatUpload(msg, ctx, "grok.upload.done", () => defaultLaneCwd(ctx.config, "grok"))
+        return
+      case "codex.upload":
+        await handleChatUpload(msg, ctx, "codex.upload.done", () => ctx.config?.claude_cwd || undefined)
         return
-      }
       case "codex.input":
         // 通常送信は idle なら turn/start、busy なら hub-agent の次ターン FIFO。
         // turn/steer / turn/interrupt は明示操作の別経路として扱う。
@@ -5027,6 +4991,7 @@ export async function dispatch(msg, ctx) {
               noteRestoreStop(ctx.sessionRestoreState, "claude", cwd)
               result.stopped = await ctx.claudeBridge.stopSessionsFor({ cwd, reason: "chat-stop" })
             } else if (msg.cli_kind === "grok") {
+              noteRestoreStop(ctx.sessionRestoreState, "grok", cwd)
               result.stopped = await ctx.grokBridge?.stopSessionsForCwd({ cwd, reason: "chat-stop" }) ?? 0
             } else {
               noteRestoreStop(ctx.sessionRestoreState, "codex", cwd)
@@ -5047,7 +5012,11 @@ export async function dispatch(msg, ctx) {
             }
           } else if (msg.cli_kind === "grok") {
             if (typeof msg.stream_id !== "string" || !msg.stream_id) result.error = "stream_id required"
-            else result.stopped = await ctx.grokBridge?.stopSessionForStream({ stream_id: msg.stream_id, reason: "chat-stop" }) ?? 0
+            else {
+              const streamCwd = ctx.grokBridge?.sessions?.get?.(msg.stream_id)?.cwd
+              if (streamCwd) noteRestoreStop(ctx.sessionRestoreState, "grok", streamCwd)
+              result.stopped = await ctx.grokBridge?.stopSessionForStream({ stream_id: msg.stream_id, reason: "chat-stop" }) ?? 0
+            }
           } else if (msg.cli_kind === "codex") {
             if (typeof msg.stream_id !== "string" || !msg.stream_id) result.error = "stream_id required"
             else {

package/src/session-restore.mjs

@@ -31,7 +31,7 @@ export function noteRestoreStop(state, cliKind, cwd) {
  * 受付状態と Hub の「接続ごとに 1 回」の送信がかみ合わず、復元が途中で止まる (2 巡目 blocker)。
  */
 export async function restoreSessions(message, {
-  state, claudeBridge, codexBridge, available, logger,
+  state, claudeBridge, codexBridge, grokBridge, available, logger,
   runInLane = (_lane, fn) => fn(), statCwd = stat,
   claudeAttachOptions = () => ({}),
 }) {
@@ -40,7 +40,7 @@ export async function restoreSessions(message, {
     return
   }
   state.accepted = true
-  const bridges = { claude: claudeBridge, codex: codexBridge }
+  const bridges = { claude: claudeBridge, codex: codexBridge, grok: grokBridge }
   const logSkip = (row, reason) => logger?.info?.({
     cli_kind: row?.cli_kind, cwd: row?.cwd, session_id: row?.session_id, reason,
   }, "agent.sessions.restore skipped")
@@ -48,7 +48,7 @@ export async function restoreSessions(message, {
     logSkip(null, "sessions must be an array")
     return
   }
-  const snapshot = () => describeLiveSessionsUnion({ claudeBridge, codexBridge }).map((s) => ({
+  const snapshot = () => describeLiveSessionsUnion({ claudeBridge, codexBridge, grokBridge }).map((s) => ({
     cli_kind: s.kind, cwd: s.cwd, session_id: s.session_id || s.thread_id,
   }))
   const same = (a, b) => a.cli_kind === b.cli_kind && a.cwd === b.cwd && a.session_id === b.session_id
@@ -73,7 +73,7 @@ export async function restoreSessions(message, {
       const live = [...current, ...selected.filter((r) => !current.some((s) => same(s, r)))]
       if (live.length >= WARM_TOTAL_MAX) break
       try {
-        if (!row || !["claude", "codex"].includes(row.cli_kind)) throw new Error("unknown CLI")
+        if (!row || !["claude", "codex", "grok"].includes(row.cli_kind)) throw new Error("unknown CLI")
         if (!bridges[row.cli_kind] || !available(row.cli_kind)) throw new Error("CLI unavailable")
         if (typeof row.session_id !== "string" || !row.session_id.trim()) throw new Error("empty session_id")
         if (typeof row.cwd !== "string" || !path.isAbsolute(row.cwd)) throw new Error("cwd must be absolute")
@@ -115,9 +115,11 @@ export async function restoreSessions(message, {
             // ここで欠けると復元した会話だけ権限モードが既定に落ちる (0.8.91 の実測)。
             ...(row.cli_kind === "claude"
               ? { ...claudeAttachOptions(), resumeSessionId: row.session_id }
-              // Codex は承認ポリシー / サンドボックスを thread 開始時にしか受け取らない。Hub が
-              // Cockpit の既定を行に載せる (空なら載せない = config.toml 既定。通常 attach と同じ)。
-              : {
+              : row.cli_kind === "grok"
+                ? { resumeSessionId: row.session_id }
+                // Codex は承認ポリシー / サンドボックスを thread 開始時にしか受け取らない。Hub が
+                // Cockpit の既定を行に載せる (空なら載せない = config.toml 既定。通常 attach と同じ)。
+                : {
                   resumeThreadId: row.session_id,
                   approvalPolicy: nonEmpty(row.approval_policy),
                   sandbox: nonEmpty(row.sandbox),

package/src/sibling-inject.mjs

@@ -425,6 +425,16 @@ function queuedResult(r) {
   }
 }
 
+// 配送前に未受理と確定した busy だけに再試行印を付ける。
+function busyResult() {
+  return {
+    ok: false,
+    error: "target_busy",
+    retryable: true,
+    hint: "宛先の未完了配送が上限に達しているため、このメッセージは受理されていません。混雑が落ち着いてから再送してください。",
+  }
+}
+
 export class SiblingInjectBridge {
   /**
    * @param {{dir?: string, claudeBridge?: object, codexBridge?: object, grokBridge?: object, logger?: object,
@@ -1099,6 +1109,8 @@ export class SiblingInjectBridge {
           }
         } else if (r.status === "delivery_queued") {
           result = queuedResult(r)
+        } else if (r.status === "busy") {
+          result = busyResult()
         } else if (r.status === "delivery_unconfirmed" || r.status === "delivery_failed") {
           result = {
             ok: false,
@@ -1195,6 +1207,8 @@ export class SiblingInjectBridge {
           }
         } else if (r.status === "delivery_queued") {
           result = queuedResult(r)
+        } else if (r.status === "busy") {
+          result = busyResult()
         } else if (r.status === "delivery_unconfirmed" || r.status === "delivery_failed") {
           result = {
             ok: false,

package/src/sibling-token.mjs

@@ -100,6 +100,41 @@ export function siblingTokenCwd(token) {
   return null
 }
 
+/**
+ * spawn する CLI プロセス自身の環境変数に、この cwd の sibling 連携用 capability を乗せる。
+ * ディスクには書かず、プロセス環境変数としてのみ渡す。継承元の環境オブジェクトは変更しない。
+ * @param {string} cwd
+ * @param {{ selfKind: "claude" | "codex" | "grok", delegateEventAck?: boolean,
+ *   stripParentSessionIds?: boolean, inherited?: NodeJS.ProcessEnv }} options
+ *   - selfKind: ask-sibling スキル (cockpit_orch.py) が「自分はどの CLI か」を環境変数から
+ *     確実に判定するための値。
+ *   - delegateEventAck: hub-agent が spawn した producer だけが delegate-event の受理 ACK を
+ *     要求するための capability。spawn 時点で固定されるため、hub-agent を旧版へロールバック
+ *     しても既存 producer は ACK を要求し続け、timeout し得る。旧 bundle はこの値を無視する。
+ *     Codex には付けない。
+ *   - stripParentSessionIds: 親 CLI のセッション ID を子へ継承させない (Grok)。
+ * @returns {NodeJS.ProcessEnv}
+ */
+export function buildSiblingEnv(cwd, { selfKind, delegateEventAck = false, stripParentSessionIds = false,
+  inherited = process.env }) {
+  const env = {
+    ...inherited,
+    COCKPIT_SIBLING_TOKEN: getOrCreateSiblingToken(cwd),
+    COCKPIT_SIBLING_CWD: cwd,
+    // Spawn-time display capability; rejection by an older daemon does not stop the review.
+    COCKPIT_REVIEW_EVENTS: "1",
+    ...(delegateEventAck ? { COCKPIT_DELEGATE_EVENT_ACK: "1" } : {}),
+    COCKPIT_SIBLING_SELF_KIND: selfKind,
+  }
+  // ACK を付けない CLI では、継承元に ACK があっても子へ持ち込まない。
+  if (!delegateEventAck) delete env.COCKPIT_DELEGATE_EVENT_ACK
+  if (stripParentSessionIds) {
+    delete env.CLAUDE_CODE_SESSION_ID
+    delete env.CODEX_THREAD_ID
+  }
+  return env
+}
+
 /** テスト用: トークンストアを全クリアする。 */
 export function _resetSiblingTokens() {
   tokensByCwd.clear()