@cocorograph/hub-agent 0.8.116 → 0.8.117

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.8.116",
+  "version": "0.8.117",
   "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 の再送は再実行されうる。

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 なしで検証するテスト専用の公開面でもある。
@@ -3945,56 +4000,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 +4346,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 は明示操作の別経路として扱う。

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()