@cocorograph/hub-agent 0.8.35 → 0.8.36

package/package.json

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

package/src/codex-stream-bridge.mjs

@@ -390,6 +390,20 @@ function subagentFallbackName(agentPath) {
   return agentPath.split("/").filter(Boolean).at(-1) || "subagent"
 }
 
+function explicitSubagentRoleFromThread(thread, expectedParentThreadId) {
+  const threadSpawn = thread?.source?.subAgent?.thread_spawn
+  if (
+    threadSpawn &&
+    (typeof threadSpawn.parent_thread_id !== "string" ||
+      threadSpawn.parent_thread_id !== expectedParentThreadId)
+  ) return null
+  const directRole = typeof thread?.agentRole === "string" ? thread.agentRole.trim() : ""
+  if (directRole) return directRole
+  const sourceRole = threadSpawn?.agent_role
+  const normalizedSourceRole = typeof sourceRole === "string" ? sourceRole.trim() : ""
+  return normalizedSourceRole || null
+}
+
 function parseDynamicToolArguments(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) return value
   if (typeof value !== "string") return null
@@ -749,7 +763,7 @@ export class CodexStreamBridge extends EventEmitter {
        *  deliveryPromise: Promise<object>, settleDelivery: Function}>} */
       pendingInjectSources: [],
       /** 組み込み collaboration subagent の表示用台帳。検索キーは agentThreadId、
-       * 外部へ出す安定した委譲 ID は spawn dynamicToolCall の item.id を保持する。 */
+       * 外部へ出す安定した委譲 ID は subAgentActivity の lifecycle ID を保持する。 */
       subagents: new Map(),
       /** dynamicToolCall(spawn_agent) の item.id -> 表示メタデータ。 */
       subagentSpawnMetadata: new Map(),
@@ -1593,6 +1607,7 @@ export class CodexStreamBridge extends EventEmitter {
           agentPath: record.agentPath,
           phase: record.phase,
           agent: record.agent,
+          agentExplicit: record.agentExplicit === true,
           description: record.description,
           prompt: record.prompt,
           background: record.background === true,
@@ -1636,6 +1651,7 @@ export class CodexStreamBridge extends EventEmitter {
       agentPath,
       phase,
       agent: metadata?.agent || previous?.agent || subagentFallbackName(agentPath),
+      agentExplicit: metadata?.agentExplicit === true || previous?.agentExplicit === true,
       description:
         metadata?.description || previous?.description || subagentFallbackName(agentPath),
       prompt: metadata?.prompt || previous?.prompt || "",
@@ -1673,8 +1689,11 @@ export class CodexStreamBridge extends EventEmitter {
       if (namespace !== "collaboration" || item.tool !== "spawn_agent" || !item.id) return
       const args = parseDynamicToolArguments(item.arguments)
       if (!args) return
+      const agent = typeof args.agent_type === "string" ? args.agent_type.trim() : ""
+      const agentExplicit = agent.length > 0
       const metadata = {
-        agent: typeof args.agent_type === "string" && args.agent_type ? args.agent_type : null,
+        agent: agentExplicit ? agent : null,
+        agentExplicit,
         description: typeof args.task_name === "string" && args.task_name ? args.task_name : null,
         prompt: typeof args.message === "string" ? args.message : null,
         background: args.background === true,
@@ -1769,6 +1788,7 @@ export class CodexStreamBridge extends EventEmitter {
         agentThreadId: record.agentThreadId,
         agentPath: record.agentPath,
         agent: record.agent,
+        agentExplicit: record.agentExplicit === true,
         description: record.description,
         prompt: record.prompt,
         background: record.background === true,
@@ -1802,6 +1822,10 @@ export class CodexStreamBridge extends EventEmitter {
           // RPC 待ち中に live lifecycle が進んだ場合、stale read で上書き・削除しない。
           if (session.subagents.get(record.agentThreadId) !== record) continue
           const thread = result?.thread
+          const explicitRole = explicitSubagentRoleFromThread(thread, session.threadId)
+          const metadata = explicitRole
+            ? { agent: explicitRole, agentExplicit: true }
+            : null
           const turns = Array.isArray(thread?.turns) ? thread.turns : []
           const lastTurn = turns.at(-1)
           const phase = terminalSubagentPhase(lastTurn?.status)
@@ -1816,7 +1840,7 @@ export class CodexStreamBridge extends EventEmitter {
               session,
               record.agentThreadId,
               phase,
-              { agentPath: record.agentPath, atMs: lastTurnAtMs },
+              { agentPath: record.agentPath, metadata, atMs: lastTurnAtMs },
               { emit: false },
             )
           } else if (
@@ -1829,6 +1853,7 @@ export class CodexStreamBridge extends EventEmitter {
               "started",
               {
                 agentPath: record.agentPath,
+                metadata,
                 atMs: record.startedAtMs,
               },
               { emit: false },

package/src/main.mjs

@@ -2076,6 +2076,7 @@ export function buildCodexReadyPayload(streamId, info, queueState) {
       agent_thread_id: subagent.agentThreadId,
       agent_path: subagent.agentPath,
       agent: subagent.agent,
+      agent_explicit: subagent.agentExplicit === true,
       // description は spawn_agent.task_name の既存 alias（人物の表示名ではない）。
       description: subagent.description,
       prompt: subagent.prompt,