@langchain/langgraph-sdk 1.9.2 → 1.9.3

package/dist/stream/discovery/subagents.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"subagents.cjs","names":["StreamStore","#onToolEvent","#onValuesEvent","#upsertTaskToolCall","#commit","#map","#recordObservedWorkNamespace","#recordTaskNamespaceCandidate","namespaceKey","isConcreteToolNamespace","#observedOwnNamespaces","#taskIdByObservedNamespace","isToolNamespaceSegment","isRootNamespace"],"sources":["../../../src/stream/discovery/subagents.ts"],"sourcesContent":["/**\n * Root-scoped subagent discovery.\n *\n * Populates a `Map<callId, SubagentDiscoverySnapshot>` by watching\n * `task` tool calls on the root subscription. No content channels\n * (subagent messages, tool calls, extensions) are opened here — that\n * layer is driven by selector hooks via the\n * {@link ChannelRegistry}, keyed on `SubagentDiscoverySnapshot.namespace`.\n *\n * Discovery data this runner populates per subagent:\n *   - id, name, namespace, parentId, depth\n *   - status (`running` | `complete` | `error`)\n *   - taskInput / output / error / startedAt / completedAt\n *\n * The runner is fed events by the {@link StreamController}'s root\n * subscription; it does not open subscriptions of its own.\n */\nimport type { Event, ToolsEvent, ValuesEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"../store.js\";\nimport type { SubagentDiscoverySnapshot } from \"../types.js\";\nimport {\n  isConcreteToolNamespace,\n  isRootNamespace,\n  isToolNamespaceSegment,\n  namespaceKey,\n} from \"../namespace.js\";\n\nexport type SubagentMap = ReadonlyMap<string, SubagentDiscoverySnapshot>;\n\ninterface MutableSubagent {\n  id: string;\n  name: string;\n  namespace: readonly string[];\n  parentId: string | null;\n  depth: number;\n  status: \"running\" | \"complete\" | \"error\";\n  taskInput: string | undefined;\n  output: unknown;\n  error: string | undefined;\n  startedAt: Date;\n  completedAt: Date | null;\n}\n\nexport class SubagentDiscovery {\n  readonly store = new StreamStore<SubagentMap>(new Map());\n  #map = new Map<string, MutableSubagent>();\n  #taskIdByObservedNamespace = new Map<string, string>();\n  #observedOwnNamespaces = new Set<string>();\n\n  /** Feed a single root event. Non-discovery events are ignored. */\n  push(event: Event): void {\n    if (event.method === \"tools\") {\n      this.#onToolEvent(event as ToolsEvent);\n    } else if (event.method === \"values\") {\n      this.#onValuesEvent(event as ValuesEvent);\n    }\n  }\n\n  /** Current snapshot map. */\n  get snapshot(): SubagentMap {\n    return this.store.getSnapshot();\n  }\n\n  discoverFromMessage(message: unknown, namespace: readonly string[]): void {\n    let changed = false;\n    for (const toolCall of getTaskToolCalls(message)) {\n      changed =\n        this.#upsertTaskToolCall(toolCall.id, toolCall.input, namespace) ||\n        changed;\n    }\n    if (changed) this.#commit();\n  }\n\n  #commit(): void {\n    // Rebuild as a fresh Map so React / useSyncExternalStore sees a\n    // new reference on every change.\n    this.store.setValue(\n      new Map(\n        [...this.#map.values()].map((entry) => [entry.id, toSnapshot(entry)])\n      )\n    );\n  }\n\n  #onToolEvent(event: ToolsEvent): void {\n    const data = event.params.data;\n    const toolCallId = (data as { tool_call_id?: string }).tool_call_id;\n    const toolName = (data as { tool_name?: string }).tool_name;\n\n    if (data.event === \"tool-started\" && toolName === \"task\") {\n      const input = parseTaskInput((data as { input?: unknown }).input);\n      if (toolCallId == null) return;\n      this.#upsertTaskToolCall(toolCallId, input, event.params.namespace);\n      this.#commit();\n      return;\n    }\n\n    if (toolCallId == null) return;\n    const entry = this.#map.get(toolCallId);\n    if (entry == null) return;\n\n    if (data.event === \"tool-finished\") {\n      entry.status = \"complete\";\n      entry.output = (data as { output?: unknown }).output;\n      entry.completedAt = new Date();\n      this.#commit();\n      return;\n    }\n\n    if (data.event === \"tool-error\") {\n      entry.status = \"error\";\n      entry.error = (data as { message?: string }).message ?? \"Subagent failed\";\n      entry.completedAt = new Date();\n      this.#commit();\n    }\n  }\n\n  #onValuesEvent(event: ValuesEvent): void {\n    const data = event.params.data;\n    if (data == null || typeof data !== \"object\" || Array.isArray(data)) return;\n    const messages = (data as { messages?: unknown }).messages;\n    if (!Array.isArray(messages)) return;\n\n    let changed = this.#recordObservedWorkNamespace(event.params.namespace);\n    for (const message of messages) {\n      for (const toolCall of getTaskToolCalls(message)) {\n        changed =\n          this.#upsertTaskToolCall(\n            toolCall.id,\n            toolCall.input,\n            event.params.namespace\n          ) || changed;\n      }\n\n      const toolCallId = getToolMessageCallId(message);\n      if (toolCallId == null) continue;\n      const existing = this.#map.get(toolCallId);\n      if (existing == null) continue;\n      existing.status = \"complete\";\n      existing.output = message;\n      existing.completedAt = new Date();\n      changed = true;\n    }\n    if (changed) this.#commit();\n  }\n\n  #upsertTaskToolCall(\n    toolCallId: string,\n    input: { description?: string; subagent_type?: string },\n    eventNamespace: readonly string[]\n  ): boolean {\n    const namespace = taskWorkNamespace(toolCallId, eventNamespace);\n    const existing = this.#map.get(toolCallId);\n    if (existing != null) {\n      let changed = false;\n      this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n      const nextName = input.subagent_type ?? existing.name;\n      const nextTaskInput = input.description ?? existing.taskInput;\n      if (existing.name !== nextName) {\n        existing.name = nextName;\n        changed = true;\n      }\n      if (existing.taskInput !== nextTaskInput) {\n        existing.taskInput = nextTaskInput;\n        changed = true;\n      }\n      const namespaceKeyed = namespaceKey(existing.namespace);\n      const ownNamespaceKey = `tools:${toolCallId}`;\n      const nextNamespaceKey = namespaceKey(namespace);\n      if (\n        isConcreteToolNamespace(eventNamespace) ||\n        namespaceKeyed === ownNamespaceKey\n      ) {\n        // A wrapper task tool event can arrive under an execution namespace\n        // like `tools:<uuid>`, while the subagent's actual message state is\n        // under `tools:<tool_call_id>`. Once discovery has observed the own\n        // namespace carrying state, do not demote it back to the wrapper\n        // namespace.\n        if (\n          namespaceKeyed === ownNamespaceKey &&\n          nextNamespaceKey !== ownNamespaceKey &&\n          this.#observedOwnNamespaces.has(toolCallId)\n        ) {\n          return changed;\n        }\n        if (namespaceKeyed !== nextNamespaceKey) {\n          existing.namespace = namespace;\n          changed = true;\n        }\n      }\n      if (existing.status !== \"complete\" && existing.status !== \"error\") {\n        if (existing.status !== \"running\") {\n          existing.status = \"running\";\n          changed = true;\n        }\n      }\n      return changed;\n    }\n\n    // Prefer the namespace where the task is first observed. Later\n    // observations may move it between wrapper execution namespaces\n    // and `[\"tools:<toolCallId>\"]`, depending on where the stream proves\n    // the worker's scoped message/tool state exists.\n    const { parentId, depth } = lineageFromNamespace(eventNamespace);\n    this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n    this.#map.set(toolCallId, {\n      id: toolCallId,\n      name: input.subagent_type ?? \"unknown\",\n      namespace,\n      parentId,\n      depth,\n      status: \"running\",\n      taskInput: input.description,\n      output: undefined,\n      error: undefined,\n      startedAt: new Date(),\n      completedAt: null,\n    });\n    return true;\n  }\n\n  #recordObservedWorkNamespace(namespace: readonly string[]): boolean {\n    if (!isConcreteToolNamespace(namespace)) return false;\n    const last = namespace.at(-1);\n    if (last == null) return false;\n    const namespaceKeyed = namespaceKey(namespace);\n    const toolCallId =\n      this.#taskIdByObservedNamespace.get(namespaceKeyed) ??\n      last.slice(\"tools:\".length);\n    const existing = this.#map.get(toolCallId);\n    if (existing == null) return false;\n\n    const ownNamespaceKey = `tools:${toolCallId}`;\n    if (namespaceKeyed === ownNamespaceKey) {\n      this.#observedOwnNamespaces.add(toolCallId);\n    } else if (\n      this.#observedOwnNamespaces.has(toolCallId) ||\n      (!this.#taskIdByObservedNamespace.has(namespaceKeyed) &&\n        !shouldPromoteToObservedNamespace(existing))\n    ) {\n      return false;\n    }\n\n    if (namespaceKey(existing.namespace) === namespaceKeyed) return false;\n    existing.namespace = [...namespace];\n    return true;\n  }\n\n  #recordTaskNamespaceCandidate(\n    toolCallId: string,\n    namespace: readonly string[]\n  ): void {\n    if (!isConcreteToolNamespace(namespace)) return;\n    this.#taskIdByObservedNamespace.set(namespaceKey(namespace), toolCallId);\n  }\n}\n\nfunction shouldPromoteToObservedNamespace(entry: MutableSubagent): boolean {\n  return (\n    entry.name === \"fanout-worker\" ||\n    /^Worker worker-\\d+/i.test(entry.taskInput ?? \"\")\n  );\n}\n\nfunction taskWorkNamespace(\n  toolCallId: string,\n  eventNamespace: readonly string[]\n): readonly string[] {\n  const last = eventNamespace.at(-1);\n  if (last != null && isToolNamespaceSegment(last)) return [...eventNamespace];\n  return [`tools:${toolCallId}`];\n}\n\nfunction toSnapshot(entry: MutableSubagent): SubagentDiscoverySnapshot {\n  return {\n    id: entry.id,\n    name: entry.name,\n    namespace: entry.namespace,\n    parentId: entry.parentId,\n    depth: entry.depth,\n    status: entry.status,\n    taskInput: entry.taskInput,\n    output: entry.output,\n    error: entry.error,\n    startedAt: entry.startedAt,\n    completedAt: entry.completedAt,\n  };\n}\n\nfunction parseTaskInput(raw: unknown): {\n  description?: string;\n  subagent_type?: string;\n} {\n  if (raw == null) return {};\n  if (typeof raw === \"string\") {\n    try {\n      const parsed = JSON.parse(raw) as Record<string, unknown>;\n      return {\n        description:\n          typeof parsed.description === \"string\"\n            ? parsed.description\n            : undefined,\n        subagent_type:\n          typeof parsed.subagent_type === \"string\"\n            ? parsed.subagent_type\n            : undefined,\n      };\n    } catch {\n      return {};\n    }\n  }\n  if (typeof raw === \"object\" && !Array.isArray(raw)) {\n    const obj = raw as Record<string, unknown>;\n    return {\n      description:\n        typeof obj.description === \"string\" ? obj.description : undefined,\n      subagent_type:\n        typeof obj.subagent_type === \"string\" ? obj.subagent_type : undefined,\n    };\n  }\n  return {};\n}\n\nfunction getTaskToolCalls(message: unknown): Array<{\n  id: string;\n  input: { description?: string; subagent_type?: string };\n}> {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return [];\n  }\n  const record = message as {\n    tool_calls?: unknown;\n    kwargs?: { tool_calls?: unknown };\n    lc_kwargs?: { tool_calls?: unknown };\n  };\n  const toolCalls =\n    record.tool_calls ??\n    record.kwargs?.tool_calls ??\n    record.lc_kwargs?.tool_calls;\n  if (!Array.isArray(toolCalls)) return [];\n\n  const result: Array<{\n    id: string;\n    input: { description?: string; subagent_type?: string };\n  }> = [];\n  for (const toolCall of toolCalls) {\n    if (\n      toolCall == null ||\n      typeof toolCall !== \"object\" ||\n      Array.isArray(toolCall)\n    ) {\n      continue;\n    }\n    const record = toolCall as {\n      id?: unknown;\n      name?: unknown;\n      args?: unknown;\n    };\n    if (typeof record.id !== \"string\" || record.name !== \"task\") continue;\n    result.push({ id: record.id, input: parseTaskInput(record.args) });\n  }\n  return result;\n}\n\nfunction getToolMessageCallId(message: unknown): string | undefined {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return undefined;\n  }\n  const record = message as {\n    tool_call_id?: unknown;\n    kwargs?: { tool_call_id?: unknown };\n    lc_kwargs?: { tool_call_id?: unknown };\n  };\n  const id =\n    record.tool_call_id ??\n    record.kwargs?.tool_call_id ??\n    record.lc_kwargs?.tool_call_id;\n  return typeof id === \"string\" && id.length > 0 ? id : undefined;\n}\n\n/**\n * Derive (parentId, depth) from a namespace like\n * `[\"subagents:abc:def\"]`. Namespaces form a rooted tree; the last\n * `:` segment of the deepest namespace element is the current node's\n * call-id and the one before it is the parent.\n */\nfunction lineageFromNamespace(namespace: readonly string[]): {\n  parentId: string | null;\n  depth: number;\n} {\n  if (isRootNamespace(namespace)) return { parentId: null, depth: 1 };\n  const last = namespace[namespace.length - 1];\n  if (last == null) return { parentId: null, depth: 1 };\n  // Namespace segments typically look like\n  //   subagents:<parentCallId>:<thisCallId>\n  // but the protocol doesn't mandate that shape; we best-effort.\n  const parts = last.split(\":\").filter((part) => part.length > 0);\n  const trimmed = parts.slice(1); // drop the leading \"subagents\" prefix\n  const depth = Math.max(1, trimmed.length);\n  const parentId = trimmed.length >= 2 ? trimmed[trimmed.length - 2] : null;\n  return { parentId: parentId ?? null, depth };\n}\n"],"mappings":"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"}
+{"version":3,"file":"subagents.cjs","names":["StreamStore","#onToolEvent","#onValuesEvent","#upsertTaskToolCall","#commit","#map","#bindNamespaceByTaskInput","#recordObservedWorkNamespace","#recordTaskNamespaceCandidate","namespaceKey","isConcreteToolNamespace","#observedOwnNamespaces","#toolCallIdByTaskInput","#taskIdByObservedNamespace","isToolNamespaceSegment","isRootNamespace"],"sources":["../../../src/stream/discovery/subagents.ts"],"sourcesContent":["/**\n * Root-scoped subagent discovery.\n *\n * Populates a `Map<callId, SubagentDiscoverySnapshot>` by watching\n * `task` tool calls on the root subscription. No content channels\n * (subagent messages, tool calls, extensions) are opened here — that\n * layer is driven by selector hooks via the\n * {@link ChannelRegistry}, keyed on `SubagentDiscoverySnapshot.namespace`.\n *\n * Discovery data this runner populates per subagent:\n *   - id, name, namespace, parentId, depth\n *   - status (`running` | `complete` | `error`)\n *   - taskInput / output / error / startedAt / completedAt\n *\n * The runner is fed events by the {@link StreamController}'s root\n * subscription; it does not open subscriptions of its own.\n */\nimport type { Event, ToolsEvent, ValuesEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"../store.js\";\nimport type { SubagentDiscoverySnapshot } from \"../types.js\";\nimport {\n  isConcreteToolNamespace,\n  isRootNamespace,\n  isToolNamespaceSegment,\n  namespaceKey,\n} from \"../namespace.js\";\n\nexport type SubagentMap = ReadonlyMap<string, SubagentDiscoverySnapshot>;\n\ninterface MutableSubagent {\n  id: string;\n  name: string;\n  namespace: readonly string[];\n  parentId: string | null;\n  depth: number;\n  status: \"running\" | \"complete\" | \"error\";\n  taskInput: string | undefined;\n  output: unknown;\n  error: string | undefined;\n  startedAt: Date;\n  completedAt: Date | null;\n}\n\nexport class SubagentDiscovery {\n  readonly store = new StreamStore<SubagentMap>(new Map());\n  #map = new Map<string, MutableSubagent>();\n  #taskIdByObservedNamespace = new Map<string, string>();\n  #observedOwnNamespaces = new Set<string>();\n  // Index from `taskInput` (the `description` arg) to a FIFO queue of\n  // pending parent `tool_call_id`s. Bridges the wire's missing link\n  // between a deepagents `task` dispatch and its subagent execution\n  // namespace — the server seeds the subagent's first HumanMessage\n  // with `taskInput` verbatim, so an exact-equality lookup is\n  // deterministic. The queue (not a single value) handles the case\n  // where the coordinator dispatches N task calls with identical\n  // descriptions; pregel preserves dispatch order across executions,\n  // so FIFO pop attributes them correctly.\n  #toolCallIdByTaskInput = new Map<string, string[]>();\n\n  /** Feed a single root event. Non-discovery events are ignored. */\n  push(event: Event): void {\n    if (event.method === \"tools\") {\n      this.#onToolEvent(event as ToolsEvent);\n    } else if (event.method === \"values\") {\n      this.#onValuesEvent(event as ValuesEvent);\n    }\n  }\n\n  /** Current snapshot map. */\n  get snapshot(): SubagentMap {\n    return this.store.getSnapshot();\n  }\n\n  discoverFromMessage(message: unknown, namespace: readonly string[]): void {\n    let changed = false;\n    for (const toolCall of getTaskToolCalls(message)) {\n      changed =\n        this.#upsertTaskToolCall(toolCall.id, toolCall.input, namespace) ||\n        changed;\n    }\n    if (changed) this.#commit();\n  }\n\n  #commit(): void {\n    // Rebuild as a fresh Map so React / useSyncExternalStore sees a\n    // new reference on every change.\n    this.store.setValue(\n      new Map(\n        [...this.#map.values()].map((entry) => [entry.id, toSnapshot(entry)])\n      )\n    );\n  }\n\n  #onToolEvent(event: ToolsEvent): void {\n    const data = event.params.data;\n    const toolCallId = (data as { tool_call_id?: string }).tool_call_id;\n    const toolName = (data as { tool_name?: string }).tool_name;\n\n    if (data.event === \"tool-started\" && toolName === \"task\") {\n      const input = parseTaskInput((data as { input?: unknown }).input);\n      if (toolCallId == null) return;\n      this.#upsertTaskToolCall(toolCallId, input, event.params.namespace);\n      this.#commit();\n      return;\n    }\n\n    if (toolCallId == null) return;\n    const entry = this.#map.get(toolCallId);\n    if (entry == null) return;\n\n    if (data.event === \"tool-finished\") {\n      entry.status = \"complete\";\n      entry.output = (data as { output?: unknown }).output;\n      entry.completedAt = new Date();\n      this.#commit();\n      return;\n    }\n\n    if (data.event === \"tool-error\") {\n      entry.status = \"error\";\n      entry.error = (data as { message?: string }).message ?? \"Subagent failed\";\n      entry.completedAt = new Date();\n      this.#commit();\n    }\n  }\n\n  #onValuesEvent(event: ValuesEvent): void {\n    const data = event.params.data;\n    if (data == null || typeof data !== \"object\" || Array.isArray(data)) return;\n    const messages = (data as { messages?: unknown }).messages;\n    if (!Array.isArray(messages)) return;\n\n    // If a `tools:<id>` namespace's first HumanMessage matches a known\n    // taskInput, that's the subagent's execution scope. Record the\n    // binding so `#recordObservedWorkNamespace` can promote it.\n    this.#bindNamespaceByTaskInput(event.params.namespace, messages);\n\n    let changed = this.#recordObservedWorkNamespace(event.params.namespace);\n    for (const message of messages) {\n      for (const toolCall of getTaskToolCalls(message)) {\n        changed =\n          this.#upsertTaskToolCall(\n            toolCall.id,\n            toolCall.input,\n            event.params.namespace\n          ) || changed;\n      }\n\n      const toolCallId = getToolMessageCallId(message);\n      if (toolCallId == null) continue;\n      const existing = this.#map.get(toolCallId);\n      if (existing == null) continue;\n      existing.status = \"complete\";\n      existing.output = message;\n      existing.completedAt = new Date();\n      changed = true;\n    }\n    if (changed) this.#commit();\n  }\n\n  #upsertTaskToolCall(\n    toolCallId: string,\n    input: { description?: string; subagent_type?: string },\n    eventNamespace: readonly string[]\n  ): boolean {\n    const namespace = taskWorkNamespace(toolCallId, eventNamespace);\n    const existing = this.#map.get(toolCallId);\n    if (existing != null) {\n      let changed = false;\n      this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n      const nextName = input.subagent_type ?? existing.name;\n      const nextTaskInput = input.description ?? existing.taskInput;\n      if (existing.name !== nextName) {\n        existing.name = nextName;\n        changed = true;\n      }\n      if (existing.taskInput !== nextTaskInput) {\n        existing.taskInput = nextTaskInput;\n        changed = true;\n      }\n      const namespaceKeyed = namespaceKey(existing.namespace);\n      const ownNamespaceKey = `tools:${toolCallId}`;\n      const nextNamespaceKey = namespaceKey(namespace);\n      if (\n        isConcreteToolNamespace(eventNamespace) ||\n        namespaceKeyed === ownNamespaceKey\n      ) {\n        // A wrapper task tool event can arrive under an execution namespace\n        // like `tools:<uuid>`, while the subagent's actual message state is\n        // under `tools:<tool_call_id>`. Once discovery has observed the own\n        // namespace carrying state, do not demote it back to the wrapper\n        // namespace.\n        if (\n          namespaceKeyed === ownNamespaceKey &&\n          nextNamespaceKey !== ownNamespaceKey &&\n          this.#observedOwnNamespaces.has(toolCallId)\n        ) {\n          return changed;\n        }\n        if (namespaceKeyed !== nextNamespaceKey) {\n          existing.namespace = namespace;\n          changed = true;\n        }\n      }\n      if (existing.status !== \"complete\" && existing.status !== \"error\") {\n        if (existing.status !== \"running\") {\n          existing.status = \"running\";\n          changed = true;\n        }\n      }\n      return changed;\n    }\n\n    // Prefer the namespace where the task is first observed. Later\n    // observations may move it between wrapper execution namespaces\n    // and `[\"tools:<toolCallId>\"]`, depending on where the stream proves\n    // the worker's scoped message/tool state exists.\n    const { parentId, depth } = lineageFromNamespace(eventNamespace);\n    this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n    if (input.description != null) {\n      const queue = this.#toolCallIdByTaskInput.get(input.description) ?? [];\n      queue.push(toolCallId);\n      this.#toolCallIdByTaskInput.set(input.description, queue);\n    }\n    this.#map.set(toolCallId, {\n      id: toolCallId,\n      name: input.subagent_type ?? \"unknown\",\n      namespace,\n      parentId,\n      depth,\n      status: \"running\",\n      taskInput: input.description,\n      output: undefined,\n      error: undefined,\n      startedAt: new Date(),\n      completedAt: null,\n    });\n    return true;\n  }\n\n  #recordObservedWorkNamespace(namespace: readonly string[]): boolean {\n    if (!isConcreteToolNamespace(namespace)) return false;\n    const last = namespace.at(-1);\n    if (last == null) return false;\n    const namespaceKeyed = namespaceKey(namespace);\n    const toolCallId =\n      this.#taskIdByObservedNamespace.get(namespaceKeyed) ??\n      last.slice(\"tools:\".length);\n    const existing = this.#map.get(toolCallId);\n    if (existing == null) return false;\n\n    const ownNamespaceKey = `tools:${toolCallId}`;\n    if (namespaceKeyed === ownNamespaceKey) {\n      this.#observedOwnNamespaces.add(toolCallId);\n    } else if (\n      this.#observedOwnNamespaces.has(toolCallId) ||\n      (!this.#taskIdByObservedNamespace.has(namespaceKeyed) &&\n        !shouldPromoteToObservedNamespace(existing))\n    ) {\n      return false;\n    }\n\n    if (namespaceKey(existing.namespace) === namespaceKeyed) return false;\n    existing.namespace = [...namespace];\n    return true;\n  }\n\n  #recordTaskNamespaceCandidate(\n    toolCallId: string,\n    namespace: readonly string[]\n  ): void {\n    if (!isConcreteToolNamespace(namespace)) return;\n    this.#taskIdByObservedNamespace.set(namespaceKey(namespace), toolCallId);\n  }\n\n  /**\n   * Bind a `tools:<id>` namespace to a registered subagent by looking\n   * up the first HumanMessage content in the `taskInput` index.\n   */\n  #bindNamespaceByTaskInput(\n    namespace: readonly string[],\n    messages: unknown[]\n  ): void {\n    if (!isConcreteToolNamespace(namespace)) return;\n    const namespaceKeyed = namespaceKey(namespace);\n    if (this.#taskIdByObservedNamespace.has(namespaceKeyed)) return;\n\n    const text = getFirstHumanMessageText(messages);\n    if (text == null) return;\n    const toolCallId = this.#toolCallIdByTaskInput.get(text)?.shift();\n    if (toolCallId == null) return;\n    this.#taskIdByObservedNamespace.set(namespaceKeyed, toolCallId);\n  }\n}\n\nfunction getFirstHumanMessageText(messages: unknown[]): string | null {\n  for (const message of messages) {\n    if (message == null || typeof message !== \"object\") continue;\n    const record = message as {\n      type?: unknown;\n      role?: unknown;\n      content?: unknown;\n      kwargs?: { type?: unknown; content?: unknown };\n      lc_kwargs?: { type?: unknown; content?: unknown };\n    };\n    const type =\n      record.type ??\n      record.role ??\n      record.kwargs?.type ??\n      record.lc_kwargs?.type;\n    if (type !== \"human\") continue;\n    const content =\n      record.content ?? record.kwargs?.content ?? record.lc_kwargs?.content;\n    return typeof content === \"string\" && content.length > 0 ? content : null;\n  }\n  return null;\n}\n\nfunction shouldPromoteToObservedNamespace(entry: MutableSubagent): boolean {\n  return (\n    entry.name === \"fanout-worker\" ||\n    /^Worker worker-\\d+/i.test(entry.taskInput ?? \"\")\n  );\n}\n\nfunction taskWorkNamespace(\n  toolCallId: string,\n  eventNamespace: readonly string[]\n): readonly string[] {\n  const last = eventNamespace.at(-1);\n  if (last != null && isToolNamespaceSegment(last)) return [...eventNamespace];\n  return [`tools:${toolCallId}`];\n}\n\nfunction toSnapshot(entry: MutableSubagent): SubagentDiscoverySnapshot {\n  return {\n    id: entry.id,\n    name: entry.name,\n    namespace: entry.namespace,\n    parentId: entry.parentId,\n    depth: entry.depth,\n    status: entry.status,\n    taskInput: entry.taskInput,\n    output: entry.output,\n    error: entry.error,\n    startedAt: entry.startedAt,\n    completedAt: entry.completedAt,\n  };\n}\n\nfunction parseTaskInput(raw: unknown): {\n  description?: string;\n  subagent_type?: string;\n} {\n  if (raw == null) return {};\n  if (typeof raw === \"string\") {\n    try {\n      const parsed = JSON.parse(raw) as Record<string, unknown>;\n      return {\n        description:\n          typeof parsed.description === \"string\"\n            ? parsed.description\n            : undefined,\n        subagent_type:\n          typeof parsed.subagent_type === \"string\"\n            ? parsed.subagent_type\n            : undefined,\n      };\n    } catch {\n      return {};\n    }\n  }\n  if (typeof raw === \"object\" && !Array.isArray(raw)) {\n    const obj = raw as Record<string, unknown>;\n    return {\n      description:\n        typeof obj.description === \"string\" ? obj.description : undefined,\n      subagent_type:\n        typeof obj.subagent_type === \"string\" ? obj.subagent_type : undefined,\n    };\n  }\n  return {};\n}\n\nfunction getTaskToolCalls(message: unknown): Array<{\n  id: string;\n  input: { description?: string; subagent_type?: string };\n}> {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return [];\n  }\n  const record = message as {\n    tool_calls?: unknown;\n    kwargs?: { tool_calls?: unknown };\n    lc_kwargs?: { tool_calls?: unknown };\n  };\n  const toolCalls =\n    record.tool_calls ??\n    record.kwargs?.tool_calls ??\n    record.lc_kwargs?.tool_calls;\n  if (!Array.isArray(toolCalls)) return [];\n\n  const result: Array<{\n    id: string;\n    input: { description?: string; subagent_type?: string };\n  }> = [];\n  for (const toolCall of toolCalls) {\n    if (\n      toolCall == null ||\n      typeof toolCall !== \"object\" ||\n      Array.isArray(toolCall)\n    ) {\n      continue;\n    }\n    const record = toolCall as {\n      id?: unknown;\n      name?: unknown;\n      args?: unknown;\n    };\n    if (typeof record.id !== \"string\" || record.name !== \"task\") continue;\n    result.push({ id: record.id, input: parseTaskInput(record.args) });\n  }\n  return result;\n}\n\nfunction getToolMessageCallId(message: unknown): string | undefined {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return undefined;\n  }\n  const record = message as {\n    tool_call_id?: unknown;\n    kwargs?: { tool_call_id?: unknown };\n    lc_kwargs?: { tool_call_id?: unknown };\n  };\n  const id =\n    record.tool_call_id ??\n    record.kwargs?.tool_call_id ??\n    record.lc_kwargs?.tool_call_id;\n  return typeof id === \"string\" && id.length > 0 ? id : undefined;\n}\n\n/**\n * Derive (parentId, depth) from a namespace like\n * `[\"subagents:abc:def\"]`. Namespaces form a rooted tree; the last\n * `:` segment of the deepest namespace element is the current node's\n * call-id and the one before it is the parent.\n */\nfunction lineageFromNamespace(namespace: readonly string[]): {\n  parentId: string | null;\n  depth: number;\n} {\n  if (isRootNamespace(namespace)) return { parentId: null, depth: 1 };\n  const last = namespace[namespace.length - 1];\n  if (last == null) return { parentId: null, depth: 1 };\n  // Namespace segments typically look like\n  //   subagents:<parentCallId>:<thisCallId>\n  // but the protocol doesn't mandate that shape; we best-effort.\n  const parts = last.split(\":\").filter((part) => part.length > 0);\n  const trimmed = parts.slice(1); // drop the leading \"subagents\" prefix\n  const depth = Math.max(1, trimmed.length);\n  const parentId = trimmed.length >= 2 ? trimmed[trimmed.length - 2] : null;\n  return { parentId: parentId ?? null, depth };\n}\n"],"mappings":";;;AA2CA,IAAa,oBAAb,MAA+B;CAC7B,QAAiB,IAAIA,cAAAA,4BAAyB,IAAI,KAAK,CAAC;CACxD,uBAAO,IAAI,KAA8B;CACzC,6CAA6B,IAAI,KAAqB;CACtD,yCAAyB,IAAI,KAAa;CAU1C,yCAAyB,IAAI,KAAuB;;CAGpD,KAAK,OAAoB;AACvB,MAAI,MAAM,WAAW,QACnB,OAAA,YAAkB,MAAoB;WAC7B,MAAM,WAAW,SAC1B,OAAA,cAAoB,MAAqB;;;CAK7C,IAAI,WAAwB;AAC1B,SAAO,KAAK,MAAM,aAAa;;CAGjC,oBAAoB,SAAkB,WAAoC;EACxE,IAAI,UAAU;AACd,OAAK,MAAM,YAAY,iBAAiB,QAAQ,CAC9C,WACE,MAAA,mBAAyB,SAAS,IAAI,SAAS,OAAO,UAAU,IAChE;AAEJ,MAAI,QAAS,OAAA,QAAc;;CAG7B,UAAgB;AAGd,OAAK,MAAM,SACT,IAAI,IACF,CAAC,GAAG,MAAA,IAAU,QAAQ,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,IAAI,WAAW,MAAM,CAAC,CAAC,CACtE,CACF;;CAGH,aAAa,OAAyB;EACpC,MAAM,OAAO,MAAM,OAAO;EAC1B,MAAM,aAAc,KAAmC;EACvD,MAAM,WAAY,KAAgC;AAElD,MAAI,KAAK,UAAU,kBAAkB,aAAa,QAAQ;GACxD,MAAM,QAAQ,eAAgB,KAA6B,MAAM;AACjE,OAAI,cAAc,KAAM;AACxB,SAAA,mBAAyB,YAAY,OAAO,MAAM,OAAO,UAAU;AACnE,SAAA,QAAc;AACd;;AAGF,MAAI,cAAc,KAAM;EACxB,MAAM,QAAQ,MAAA,IAAU,IAAI,WAAW;AACvC,MAAI,SAAS,KAAM;AAEnB,MAAI,KAAK,UAAU,iBAAiB;AAClC,SAAM,SAAS;AACf,SAAM,SAAU,KAA8B;AAC9C,SAAM,8BAAc,IAAI,MAAM;AAC9B,SAAA,QAAc;AACd;;AAGF,MAAI,KAAK,UAAU,cAAc;AAC/B,SAAM,SAAS;AACf,SAAM,QAAS,KAA8B,WAAW;AACxD,SAAM,8BAAc,IAAI,MAAM;AAC9B,SAAA,QAAc;;;CAIlB,eAAe,OAA0B;EACvC,MAAM,OAAO,MAAM,OAAO;AAC1B,MAAI,QAAQ,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,KAAK,CAAE;EACrE,MAAM,WAAY,KAAgC;AAClD,MAAI,CAAC,MAAM,QAAQ,SAAS,CAAE;AAK9B,QAAA,yBAA+B,MAAM,OAAO,WAAW,SAAS;EAEhE,IAAI,UAAU,MAAA,4BAAkC,MAAM,OAAO,UAAU;AACvE,OAAK,MAAM,WAAW,UAAU;AAC9B,QAAK,MAAM,YAAY,iBAAiB,QAAQ,CAC9C,WACE,MAAA,mBACE,SAAS,IACT,SAAS,OACT,MAAM,OAAO,UACd,IAAI;GAGT,MAAM,aAAa,qBAAqB,QAAQ;AAChD,OAAI,cAAc,KAAM;GACxB,MAAM,WAAW,MAAA,IAAU,IAAI,WAAW;AAC1C,OAAI,YAAY,KAAM;AACtB,YAAS,SAAS;AAClB,YAAS,SAAS;AAClB,YAAS,8BAAc,IAAI,MAAM;AACjC,aAAU;;AAEZ,MAAI,QAAS,OAAA,QAAc;;CAG7B,oBACE,YACA,OACA,gBACS;EACT,MAAM,YAAY,kBAAkB,YAAY,eAAe;EAC/D,MAAM,WAAW,MAAA,IAAU,IAAI,WAAW;AAC1C,MAAI,YAAY,MAAM;GACpB,IAAI,UAAU;AACd,SAAA,6BAAmC,YAAY,eAAe;GAC9D,MAAM,WAAW,MAAM,iBAAiB,SAAS;GACjD,MAAM,gBAAgB,MAAM,eAAe,SAAS;AACpD,OAAI,SAAS,SAAS,UAAU;AAC9B,aAAS,OAAO;AAChB,cAAU;;AAEZ,OAAI,SAAS,cAAc,eAAe;AACxC,aAAS,YAAY;AACrB,cAAU;;GAEZ,MAAM,iBAAiBS,kBAAAA,aAAa,SAAS,UAAU;GACvD,MAAM,kBAAkB,SAAS;GACjC,MAAM,mBAAmBA,kBAAAA,aAAa,UAAU;AAChD,OACEC,kBAAAA,wBAAwB,eAAe,IACvC,mBAAmB,iBACnB;AAMA,QACE,mBAAmB,mBACnB,qBAAqB,mBACrB,MAAA,sBAA4B,IAAI,WAAW,CAE3C,QAAO;AAET,QAAI,mBAAmB,kBAAkB;AACvC,cAAS,YAAY;AACrB,eAAU;;;AAGd,OAAI,SAAS,WAAW,cAAc,SAAS,WAAW;QACpD,SAAS,WAAW,WAAW;AACjC,cAAS,SAAS;AAClB,eAAU;;;AAGd,UAAO;;EAOT,MAAM,EAAE,UAAU,UAAU,qBAAqB,eAAe;AAChE,QAAA,6BAAmC,YAAY,eAAe;AAC9D,MAAI,MAAM,eAAe,MAAM;GAC7B,MAAM,QAAQ,MAAA,sBAA4B,IAAI,MAAM,YAAY,IAAI,EAAE;AACtE,SAAM,KAAK,WAAW;AACtB,SAAA,sBAA4B,IAAI,MAAM,aAAa,MAAM;;AAE3D,QAAA,IAAU,IAAI,YAAY;GACxB,IAAI;GACJ,MAAM,MAAM,iBAAiB;GAC7B;GACA;GACA;GACA,QAAQ;GACR,WAAW,MAAM;GACjB,QAAQ,KAAA;GACR,OAAO,KAAA;GACP,2BAAW,IAAI,MAAM;GACrB,aAAa;GACd,CAAC;AACF,SAAO;;CAGT,6BAA6B,WAAuC;AAClE,MAAI,CAACA,kBAAAA,wBAAwB,UAAU,CAAE,QAAO;EAChD,MAAM,OAAO,UAAU,GAAG,GAAG;AAC7B,MAAI,QAAQ,KAAM,QAAO;EACzB,MAAM,iBAAiBD,kBAAAA,aAAa,UAAU;EAC9C,MAAM,aACJ,MAAA,0BAAgC,IAAI,eAAe,IACnD,KAAK,MAAM,EAAgB;EAC7B,MAAM,WAAW,MAAA,IAAU,IAAI,WAAW;AAC1C,MAAI,YAAY,KAAM,QAAO;AAG7B,MAAI,mBADoB,SAAS,aAE/B,OAAA,sBAA4B,IAAI,WAAW;WAE3C,MAAA,sBAA4B,IAAI,WAAW,IAC1C,CAAC,MAAA,0BAAgC,IAAI,eAAe,IACnD,CAAC,iCAAiC,SAAS,CAE7C,QAAO;AAGT,MAAIA,kBAAAA,aAAa,SAAS,UAAU,KAAK,eAAgB,QAAO;AAChE,WAAS,YAAY,CAAC,GAAG,UAAU;AACnC,SAAO;;CAGT,8BACE,YACA,WACM;AACN,MAAI,CAACC,kBAAAA,wBAAwB,UAAU,CAAE;AACzC,QAAA,0BAAgC,IAAID,kBAAAA,aAAa,UAAU,EAAE,WAAW;;;;;;CAO1E,0BACE,WACA,UACM;AACN,MAAI,CAACC,kBAAAA,wBAAwB,UAAU,CAAE;EACzC,MAAM,iBAAiBD,kBAAAA,aAAa,UAAU;AAC9C,MAAI,MAAA,0BAAgC,IAAI,eAAe,CAAE;EAEzD,MAAM,OAAO,yBAAyB,SAAS;AAC/C,MAAI,QAAQ,KAAM;EAClB,MAAM,aAAa,MAAA,sBAA4B,IAAI,KAAK,EAAE,OAAO;AACjE,MAAI,cAAc,KAAM;AACxB,QAAA,0BAAgC,IAAI,gBAAgB,WAAW;;;AAInE,SAAS,yBAAyB,UAAoC;AACpE,MAAK,MAAM,WAAW,UAAU;AAC9B,MAAI,WAAW,QAAQ,OAAO,YAAY,SAAU;EACpD,MAAM,SAAS;AAYf,OAJE,OAAO,QACP,OAAO,QACP,OAAO,QAAQ,QACf,OAAO,WAAW,UACP,QAAS;EACtB,MAAM,UACJ,OAAO,WAAW,OAAO,QAAQ,WAAW,OAAO,WAAW;AAChE,SAAO,OAAO,YAAY,YAAY,QAAQ,SAAS,IAAI,UAAU;;AAEvE,QAAO;;AAGT,SAAS,iCAAiC,OAAiC;AACzE,QACE,MAAM,SAAS,mBACf,sBAAsB,KAAK,MAAM,aAAa,GAAG;;AAIrD,SAAS,kBACP,YACA,gBACmB;CACnB,MAAM,OAAO,eAAe,GAAG,GAAG;AAClC,KAAI,QAAQ,QAAQK,kBAAAA,uBAAuB,KAAK,CAAE,QAAO,CAAC,GAAG,eAAe;AAC5E,QAAO,CAAC,SAAS,aAAa;;AAGhC,SAAS,WAAW,OAAmD;AACrE,QAAO;EACL,IAAI,MAAM;EACV,MAAM,MAAM;EACZ,WAAW,MAAM;EACjB,UAAU,MAAM;EAChB,OAAO,MAAM;EACb,QAAQ,MAAM;EACd,WAAW,MAAM;EACjB,QAAQ,MAAM;EACd,OAAO,MAAM;EACb,WAAW,MAAM;EACjB,aAAa,MAAM;EACpB;;AAGH,SAAS,eAAe,KAGtB;AACA,KAAI,OAAO,KAAM,QAAO,EAAE;AAC1B,KAAI,OAAO,QAAQ,SACjB,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,SAAO;GACL,aACE,OAAO,OAAO,gBAAgB,WAC1B,OAAO,cACP,KAAA;GACN,eACE,OAAO,OAAO,kBAAkB,WAC5B,OAAO,gBACP,KAAA;GACP;SACK;AACN,SAAO,EAAE;;AAGb,KAAI,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,IAAI,EAAE;EAClD,MAAM,MAAM;AACZ,SAAO;GACL,aACE,OAAO,IAAI,gBAAgB,WAAW,IAAI,cAAc,KAAA;GAC1D,eACE,OAAO,IAAI,kBAAkB,WAAW,IAAI,gBAAgB,KAAA;GAC/D;;AAEH,QAAO,EAAE;;AAGX,SAAS,iBAAiB,SAGvB;AACD,KACE,WAAW,QACX,OAAO,YAAY,YACnB,MAAM,QAAQ,QAAQ,CAEtB,QAAO,EAAE;CAEX,MAAM,SAAS;CAKf,MAAM,YACJ,OAAO,cACP,OAAO,QAAQ,cACf,OAAO,WAAW;AACpB,KAAI,CAAC,MAAM,QAAQ,UAAU,CAAE,QAAO,EAAE;CAExC,MAAM,SAGD,EAAE;AACP,MAAK,MAAM,YAAY,WAAW;AAChC,MACE,YAAY,QACZ,OAAO,aAAa,YACpB,MAAM,QAAQ,SAAS,CAEvB;EAEF,MAAM,SAAS;AAKf,MAAI,OAAO,OAAO,OAAO,YAAY,OAAO,SAAS,OAAQ;AAC7D,SAAO,KAAK;GAAE,IAAI,OAAO;GAAI,OAAO,eAAe,OAAO,KAAK;GAAE,CAAC;;AAEpE,QAAO;;AAGT,SAAS,qBAAqB,SAAsC;AAClE,KACE,WAAW,QACX,OAAO,YAAY,YACnB,MAAM,QAAQ,QAAQ,CAEtB;CAEF,MAAM,SAAS;CAKf,MAAM,KACJ,OAAO,gBACP,OAAO,QAAQ,gBACf,OAAO,WAAW;AACpB,QAAO,OAAO,OAAO,YAAY,GAAG,SAAS,IAAI,KAAK,KAAA;;;;;;;;AASxD,SAAS,qBAAqB,WAG5B;AACA,KAAIC,kBAAAA,gBAAgB,UAAU,CAAE,QAAO;EAAE,UAAU;EAAM,OAAO;EAAG;CACnE,MAAM,OAAO,UAAU,UAAU,SAAS;AAC1C,KAAI,QAAQ,KAAM,QAAO;EAAE,UAAU;EAAM,OAAO;EAAG;CAKrD,MAAM,UADQ,KAAK,MAAM,IAAI,CAAC,QAAQ,SAAS,KAAK,SAAS,EAAE,CACzC,MAAM,EAAE;CAC9B,MAAM,QAAQ,KAAK,IAAI,GAAG,QAAQ,OAAO;AAEzC,QAAO;EAAE,WADQ,QAAQ,UAAU,IAAI,QAAQ,QAAQ,SAAS,KAAK,SACtC;EAAM;EAAO"}

package/dist/stream/discovery/subagents.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"subagents.d.cts","names":[],"sources":["../../../src/stream/discovery/subagents.ts"],"mappings":";;;;;KA2BY,WAAA,GAAc,WAAA,SAAoB,yBAAA;AAAA,cAgBjC,iBAAA;EAAA;WACF,KAAA,EAAK,WAAA,CAAA,WAAA;EAMF;EAAZ,IAAA,CAAK,KAAA,EAAO,KAAA;EASR;EAAA,IAAA,QAAA,CAAA,GAAY,WAAA;EAIhB,mBAAA,CAAoB,OAAA,WAAkB,SAAA;AAAA"}
+{"version":3,"file":"subagents.d.cts","names":[],"sources":["../../../src/stream/discovery/subagents.ts"],"mappings":";;;;;KA2BY,WAAA,GAAc,WAAA,SAAoB,yBAAA;AAAA,cAgBjC,iBAAA;EAAA;WACF,KAAA,EAAK,WAAA,CAAA,WAAA;EAgBF;EAAZ,IAAA,CAAK,KAAA,EAAO,KAAA;EASR;EAAA,IAAA,QAAA,CAAA,GAAY,WAAA;EAIhB,mBAAA,CAAoB,OAAA,WAAkB,SAAA;AAAA"}

package/dist/stream/discovery/subagents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagents.d.ts","names":[],"sources":["../../../src/stream/discovery/subagents.ts"],"mappings":";;;;;KA2BY,WAAA,GAAc,WAAA,SAAoB,yBAAA;AAAA,cAgBjC,iBAAA;EAAA;WACF,KAAA,EAAK,WAAA,CAAA,WAAA;EAMF;EAAZ,IAAA,CAAK,KAAA,EAAO,KAAA;EASR;EAAA,IAAA,QAAA,CAAA,GAAY,WAAA;EAIhB,mBAAA,CAAoB,OAAA,WAAkB,SAAA;AAAA"}
+{"version":3,"file":"subagents.d.ts","names":[],"sources":["../../../src/stream/discovery/subagents.ts"],"mappings":";;;;;KA2BY,WAAA,GAAc,WAAA,SAAoB,yBAAA;AAAA,cAgBjC,iBAAA;EAAA;WACF,KAAA,EAAK,WAAA,CAAA,WAAA;EAgBF;EAAZ,IAAA,CAAK,KAAA,EAAO,KAAA;EASR;EAAA,IAAA,QAAA,CAAA,GAAY,WAAA;EAIhB,mBAAA,CAAoB,OAAA,WAAkB,SAAA;AAAA"}

package/dist/stream/discovery/subagents.js

@@ -6,6 +6,7 @@ var SubagentDiscovery = class {
 	#map = /* @__PURE__ */ new Map();
 	#taskIdByObservedNamespace = /* @__PURE__ */ new Map();
 	#observedOwnNamespaces = /* @__PURE__ */ new Set();
+	#toolCallIdByTaskInput = /* @__PURE__ */ new Map();
 	/** Feed a single root event. Non-discovery events are ignored. */
 	push(event) {
 		if (event.method === "tools") this.#onToolEvent(event);
@@ -56,6 +57,7 @@ var SubagentDiscovery = class {
 		if (data == null || typeof data !== "object" || Array.isArray(data)) return;
 		const messages = data.messages;
 		if (!Array.isArray(messages)) return;
+		this.#bindNamespaceByTaskInput(event.params.namespace, messages);
 		let changed = this.#recordObservedWorkNamespace(event.params.namespace);
 		for (const message of messages) {
 			for (const toolCall of getTaskToolCalls(message)) changed = this.#upsertTaskToolCall(toolCall.id, toolCall.input, event.params.namespace) || changed;
@@ -106,6 +108,11 @@ var SubagentDiscovery = class {
 		}
 		const { parentId, depth } = lineageFromNamespace(eventNamespace);
 		this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);
+		if (input.description != null) {
+			const queue = this.#toolCallIdByTaskInput.get(input.description) ?? [];
+			queue.push(toolCallId);
+			this.#toolCallIdByTaskInput.set(input.description, queue);
+		}
 		this.#map.set(toolCallId, {
 			id: toolCallId,
 			name: input.subagent_type ?? "unknown",
@@ -139,7 +146,31 @@ var SubagentDiscovery = class {
 		if (!isConcreteToolNamespace(namespace)) return;
 		this.#taskIdByObservedNamespace.set(namespaceKey(namespace), toolCallId);
 	}
+	/**
+	* Bind a `tools:<id>` namespace to a registered subagent by looking
+	* up the first HumanMessage content in the `taskInput` index.
+	*/
+	#bindNamespaceByTaskInput(namespace, messages) {
+		if (!isConcreteToolNamespace(namespace)) return;
+		const namespaceKeyed = namespaceKey(namespace);
+		if (this.#taskIdByObservedNamespace.has(namespaceKeyed)) return;
+		const text = getFirstHumanMessageText(messages);
+		if (text == null) return;
+		const toolCallId = this.#toolCallIdByTaskInput.get(text)?.shift();
+		if (toolCallId == null) return;
+		this.#taskIdByObservedNamespace.set(namespaceKeyed, toolCallId);
+	}
 };
+function getFirstHumanMessageText(messages) {
+	for (const message of messages) {
+		if (message == null || typeof message !== "object") continue;
+		const record = message;
+		if ((record.type ?? record.role ?? record.kwargs?.type ?? record.lc_kwargs?.type) !== "human") continue;
+		const content = record.content ?? record.kwargs?.content ?? record.lc_kwargs?.content;
+		return typeof content === "string" && content.length > 0 ? content : null;
+	}
+	return null;
+}
 function shouldPromoteToObservedNamespace(entry) {
 	return entry.name === "fanout-worker" || /^Worker worker-\d+/i.test(entry.taskInput ?? "");
 }

package/dist/stream/discovery/subagents.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagents.js","names":["#onToolEvent","#onValuesEvent","#upsertTaskToolCall","#commit","#map","#recordObservedWorkNamespace","#recordTaskNamespaceCandidate","#observedOwnNamespaces","#taskIdByObservedNamespace"],"sources":["../../../src/stream/discovery/subagents.ts"],"sourcesContent":["/**\n * Root-scoped subagent discovery.\n *\n * Populates a `Map<callId, SubagentDiscoverySnapshot>` by watching\n * `task` tool calls on the root subscription. No content channels\n * (subagent messages, tool calls, extensions) are opened here — that\n * layer is driven by selector hooks via the\n * {@link ChannelRegistry}, keyed on `SubagentDiscoverySnapshot.namespace`.\n *\n * Discovery data this runner populates per subagent:\n *   - id, name, namespace, parentId, depth\n *   - status (`running` | `complete` | `error`)\n *   - taskInput / output / error / startedAt / completedAt\n *\n * The runner is fed events by the {@link StreamController}'s root\n * subscription; it does not open subscriptions of its own.\n */\nimport type { Event, ToolsEvent, ValuesEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"../store.js\";\nimport type { SubagentDiscoverySnapshot } from \"../types.js\";\nimport {\n  isConcreteToolNamespace,\n  isRootNamespace,\n  isToolNamespaceSegment,\n  namespaceKey,\n} from \"../namespace.js\";\n\nexport type SubagentMap = ReadonlyMap<string, SubagentDiscoverySnapshot>;\n\ninterface MutableSubagent {\n  id: string;\n  name: string;\n  namespace: readonly string[];\n  parentId: string | null;\n  depth: number;\n  status: \"running\" | \"complete\" | \"error\";\n  taskInput: string | undefined;\n  output: unknown;\n  error: string | undefined;\n  startedAt: Date;\n  completedAt: Date | null;\n}\n\nexport class SubagentDiscovery {\n  readonly store = new StreamStore<SubagentMap>(new Map());\n  #map = new Map<string, MutableSubagent>();\n  #taskIdByObservedNamespace = new Map<string, string>();\n  #observedOwnNamespaces = new Set<string>();\n\n  /** Feed a single root event. Non-discovery events are ignored. */\n  push(event: Event): void {\n    if (event.method === \"tools\") {\n      this.#onToolEvent(event as ToolsEvent);\n    } else if (event.method === \"values\") {\n      this.#onValuesEvent(event as ValuesEvent);\n    }\n  }\n\n  /** Current snapshot map. */\n  get snapshot(): SubagentMap {\n    return this.store.getSnapshot();\n  }\n\n  discoverFromMessage(message: unknown, namespace: readonly string[]): void {\n    let changed = false;\n    for (const toolCall of getTaskToolCalls(message)) {\n      changed =\n        this.#upsertTaskToolCall(toolCall.id, toolCall.input, namespace) ||\n        changed;\n    }\n    if (changed) this.#commit();\n  }\n\n  #commit(): void {\n    // Rebuild as a fresh Map so React / useSyncExternalStore sees a\n    // new reference on every change.\n    this.store.setValue(\n      new Map(\n        [...this.#map.values()].map((entry) => [entry.id, toSnapshot(entry)])\n      )\n    );\n  }\n\n  #onToolEvent(event: ToolsEvent): void {\n    const data = event.params.data;\n    const toolCallId = (data as { tool_call_id?: string }).tool_call_id;\n    const toolName = (data as { tool_name?: string }).tool_name;\n\n    if (data.event === \"tool-started\" && toolName === \"task\") {\n      const input = parseTaskInput((data as { input?: unknown }).input);\n      if (toolCallId == null) return;\n      this.#upsertTaskToolCall(toolCallId, input, event.params.namespace);\n      this.#commit();\n      return;\n    }\n\n    if (toolCallId == null) return;\n    const entry = this.#map.get(toolCallId);\n    if (entry == null) return;\n\n    if (data.event === \"tool-finished\") {\n      entry.status = \"complete\";\n      entry.output = (data as { output?: unknown }).output;\n      entry.completedAt = new Date();\n      this.#commit();\n      return;\n    }\n\n    if (data.event === \"tool-error\") {\n      entry.status = \"error\";\n      entry.error = (data as { message?: string }).message ?? \"Subagent failed\";\n      entry.completedAt = new Date();\n      this.#commit();\n    }\n  }\n\n  #onValuesEvent(event: ValuesEvent): void {\n    const data = event.params.data;\n    if (data == null || typeof data !== \"object\" || Array.isArray(data)) return;\n    const messages = (data as { messages?: unknown }).messages;\n    if (!Array.isArray(messages)) return;\n\n    let changed = this.#recordObservedWorkNamespace(event.params.namespace);\n    for (const message of messages) {\n      for (const toolCall of getTaskToolCalls(message)) {\n        changed =\n          this.#upsertTaskToolCall(\n            toolCall.id,\n            toolCall.input,\n            event.params.namespace\n          ) || changed;\n      }\n\n      const toolCallId = getToolMessageCallId(message);\n      if (toolCallId == null) continue;\n      const existing = this.#map.get(toolCallId);\n      if (existing == null) continue;\n      existing.status = \"complete\";\n      existing.output = message;\n      existing.completedAt = new Date();\n      changed = true;\n    }\n    if (changed) this.#commit();\n  }\n\n  #upsertTaskToolCall(\n    toolCallId: string,\n    input: { description?: string; subagent_type?: string },\n    eventNamespace: readonly string[]\n  ): boolean {\n    const namespace = taskWorkNamespace(toolCallId, eventNamespace);\n    const existing = this.#map.get(toolCallId);\n    if (existing != null) {\n      let changed = false;\n      this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n      const nextName = input.subagent_type ?? existing.name;\n      const nextTaskInput = input.description ?? existing.taskInput;\n      if (existing.name !== nextName) {\n        existing.name = nextName;\n        changed = true;\n      }\n      if (existing.taskInput !== nextTaskInput) {\n        existing.taskInput = nextTaskInput;\n        changed = true;\n      }\n      const namespaceKeyed = namespaceKey(existing.namespace);\n      const ownNamespaceKey = `tools:${toolCallId}`;\n      const nextNamespaceKey = namespaceKey(namespace);\n      if (\n        isConcreteToolNamespace(eventNamespace) ||\n        namespaceKeyed === ownNamespaceKey\n      ) {\n        // A wrapper task tool event can arrive under an execution namespace\n        // like `tools:<uuid>`, while the subagent's actual message state is\n        // under `tools:<tool_call_id>`. Once discovery has observed the own\n        // namespace carrying state, do not demote it back to the wrapper\n        // namespace.\n        if (\n          namespaceKeyed === ownNamespaceKey &&\n          nextNamespaceKey !== ownNamespaceKey &&\n          this.#observedOwnNamespaces.has(toolCallId)\n        ) {\n          return changed;\n        }\n        if (namespaceKeyed !== nextNamespaceKey) {\n          existing.namespace = namespace;\n          changed = true;\n        }\n      }\n      if (existing.status !== \"complete\" && existing.status !== \"error\") {\n        if (existing.status !== \"running\") {\n          existing.status = \"running\";\n          changed = true;\n        }\n      }\n      return changed;\n    }\n\n    // Prefer the namespace where the task is first observed. Later\n    // observations may move it between wrapper execution namespaces\n    // and `[\"tools:<toolCallId>\"]`, depending on where the stream proves\n    // the worker's scoped message/tool state exists.\n    const { parentId, depth } = lineageFromNamespace(eventNamespace);\n    this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n    this.#map.set(toolCallId, {\n      id: toolCallId,\n      name: input.subagent_type ?? \"unknown\",\n      namespace,\n      parentId,\n      depth,\n      status: \"running\",\n      taskInput: input.description,\n      output: undefined,\n      error: undefined,\n      startedAt: new Date(),\n      completedAt: null,\n    });\n    return true;\n  }\n\n  #recordObservedWorkNamespace(namespace: readonly string[]): boolean {\n    if (!isConcreteToolNamespace(namespace)) return false;\n    const last = namespace.at(-1);\n    if (last == null) return false;\n    const namespaceKeyed = namespaceKey(namespace);\n    const toolCallId =\n      this.#taskIdByObservedNamespace.get(namespaceKeyed) ??\n      last.slice(\"tools:\".length);\n    const existing = this.#map.get(toolCallId);\n    if (existing == null) return false;\n\n    const ownNamespaceKey = `tools:${toolCallId}`;\n    if (namespaceKeyed === ownNamespaceKey) {\n      this.#observedOwnNamespaces.add(toolCallId);\n    } else if (\n      this.#observedOwnNamespaces.has(toolCallId) ||\n      (!this.#taskIdByObservedNamespace.has(namespaceKeyed) &&\n        !shouldPromoteToObservedNamespace(existing))\n    ) {\n      return false;\n    }\n\n    if (namespaceKey(existing.namespace) === namespaceKeyed) return false;\n    existing.namespace = [...namespace];\n    return true;\n  }\n\n  #recordTaskNamespaceCandidate(\n    toolCallId: string,\n    namespace: readonly string[]\n  ): void {\n    if (!isConcreteToolNamespace(namespace)) return;\n    this.#taskIdByObservedNamespace.set(namespaceKey(namespace), toolCallId);\n  }\n}\n\nfunction shouldPromoteToObservedNamespace(entry: MutableSubagent): boolean {\n  return (\n    entry.name === \"fanout-worker\" ||\n    /^Worker worker-\\d+/i.test(entry.taskInput ?? \"\")\n  );\n}\n\nfunction taskWorkNamespace(\n  toolCallId: string,\n  eventNamespace: readonly string[]\n): readonly string[] {\n  const last = eventNamespace.at(-1);\n  if (last != null && isToolNamespaceSegment(last)) return [...eventNamespace];\n  return [`tools:${toolCallId}`];\n}\n\nfunction toSnapshot(entry: MutableSubagent): SubagentDiscoverySnapshot {\n  return {\n    id: entry.id,\n    name: entry.name,\n    namespace: entry.namespace,\n    parentId: entry.parentId,\n    depth: entry.depth,\n    status: entry.status,\n    taskInput: entry.taskInput,\n    output: entry.output,\n    error: entry.error,\n    startedAt: entry.startedAt,\n    completedAt: entry.completedAt,\n  };\n}\n\nfunction parseTaskInput(raw: unknown): {\n  description?: string;\n  subagent_type?: string;\n} {\n  if (raw == null) return {};\n  if (typeof raw === \"string\") {\n    try {\n      const parsed = JSON.parse(raw) as Record<string, unknown>;\n      return {\n        description:\n          typeof parsed.description === \"string\"\n            ? parsed.description\n            : undefined,\n        subagent_type:\n          typeof parsed.subagent_type === \"string\"\n            ? parsed.subagent_type\n            : undefined,\n      };\n    } catch {\n      return {};\n    }\n  }\n  if (typeof raw === \"object\" && !Array.isArray(raw)) {\n    const obj = raw as Record<string, unknown>;\n    return {\n      description:\n        typeof obj.description === \"string\" ? obj.description : undefined,\n      subagent_type:\n        typeof obj.subagent_type === \"string\" ? obj.subagent_type : undefined,\n    };\n  }\n  return {};\n}\n\nfunction getTaskToolCalls(message: unknown): Array<{\n  id: string;\n  input: { description?: string; subagent_type?: string };\n}> {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return [];\n  }\n  const record = message as {\n    tool_calls?: unknown;\n    kwargs?: { tool_calls?: unknown };\n    lc_kwargs?: { tool_calls?: unknown };\n  };\n  const toolCalls =\n    record.tool_calls ??\n    record.kwargs?.tool_calls ??\n    record.lc_kwargs?.tool_calls;\n  if (!Array.isArray(toolCalls)) return [];\n\n  const result: Array<{\n    id: string;\n    input: { description?: string; subagent_type?: string };\n  }> = [];\n  for (const toolCall of toolCalls) {\n    if (\n      toolCall == null ||\n      typeof toolCall !== \"object\" ||\n      Array.isArray(toolCall)\n    ) {\n      continue;\n    }\n    const record = toolCall as {\n      id?: unknown;\n      name?: unknown;\n      args?: unknown;\n    };\n    if (typeof record.id !== \"string\" || record.name !== \"task\") continue;\n    result.push({ id: record.id, input: parseTaskInput(record.args) });\n  }\n  return result;\n}\n\nfunction getToolMessageCallId(message: unknown): string | undefined {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return undefined;\n  }\n  const record = message as {\n    tool_call_id?: unknown;\n    kwargs?: { tool_call_id?: unknown };\n    lc_kwargs?: { tool_call_id?: unknown };\n  };\n  const id =\n    record.tool_call_id ??\n    record.kwargs?.tool_call_id ??\n    record.lc_kwargs?.tool_call_id;\n  return typeof id === \"string\" && id.length > 0 ? id : undefined;\n}\n\n/**\n * Derive (parentId, depth) from a namespace like\n * `[\"subagents:abc:def\"]`. Namespaces form a rooted tree; the last\n * `:` segment of the deepest namespace element is the current node's\n * call-id and the one before it is the parent.\n */\nfunction lineageFromNamespace(namespace: readonly string[]): {\n  parentId: string | null;\n  depth: number;\n} {\n  if (isRootNamespace(namespace)) return { parentId: null, depth: 1 };\n  const last = namespace[namespace.length - 1];\n  if (last == null) return { parentId: null, depth: 1 };\n  // Namespace segments typically look like\n  //   subagents:<parentCallId>:<thisCallId>\n  // but the protocol doesn't mandate that shape; we best-effort.\n  const parts = last.split(\":\").filter((part) => part.length > 0);\n  const trimmed = parts.slice(1); // drop the leading \"subagents\" prefix\n  const depth = Math.max(1, trimmed.length);\n  const parentId = trimmed.length >= 2 ? trimmed[trimmed.length - 2] : null;\n  return { parentId: parentId ?? null, depth };\n}\n"],"mappings":"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"}
+{"version":3,"file":"subagents.js","names":["#onToolEvent","#onValuesEvent","#upsertTaskToolCall","#commit","#map","#bindNamespaceByTaskInput","#recordObservedWorkNamespace","#recordTaskNamespaceCandidate","#observedOwnNamespaces","#toolCallIdByTaskInput","#taskIdByObservedNamespace"],"sources":["../../../src/stream/discovery/subagents.ts"],"sourcesContent":["/**\n * Root-scoped subagent discovery.\n *\n * Populates a `Map<callId, SubagentDiscoverySnapshot>` by watching\n * `task` tool calls on the root subscription. No content channels\n * (subagent messages, tool calls, extensions) are opened here — that\n * layer is driven by selector hooks via the\n * {@link ChannelRegistry}, keyed on `SubagentDiscoverySnapshot.namespace`.\n *\n * Discovery data this runner populates per subagent:\n *   - id, name, namespace, parentId, depth\n *   - status (`running` | `complete` | `error`)\n *   - taskInput / output / error / startedAt / completedAt\n *\n * The runner is fed events by the {@link StreamController}'s root\n * subscription; it does not open subscriptions of its own.\n */\nimport type { Event, ToolsEvent, ValuesEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"../store.js\";\nimport type { SubagentDiscoverySnapshot } from \"../types.js\";\nimport {\n  isConcreteToolNamespace,\n  isRootNamespace,\n  isToolNamespaceSegment,\n  namespaceKey,\n} from \"../namespace.js\";\n\nexport type SubagentMap = ReadonlyMap<string, SubagentDiscoverySnapshot>;\n\ninterface MutableSubagent {\n  id: string;\n  name: string;\n  namespace: readonly string[];\n  parentId: string | null;\n  depth: number;\n  status: \"running\" | \"complete\" | \"error\";\n  taskInput: string | undefined;\n  output: unknown;\n  error: string | undefined;\n  startedAt: Date;\n  completedAt: Date | null;\n}\n\nexport class SubagentDiscovery {\n  readonly store = new StreamStore<SubagentMap>(new Map());\n  #map = new Map<string, MutableSubagent>();\n  #taskIdByObservedNamespace = new Map<string, string>();\n  #observedOwnNamespaces = new Set<string>();\n  // Index from `taskInput` (the `description` arg) to a FIFO queue of\n  // pending parent `tool_call_id`s. Bridges the wire's missing link\n  // between a deepagents `task` dispatch and its subagent execution\n  // namespace — the server seeds the subagent's first HumanMessage\n  // with `taskInput` verbatim, so an exact-equality lookup is\n  // deterministic. The queue (not a single value) handles the case\n  // where the coordinator dispatches N task calls with identical\n  // descriptions; pregel preserves dispatch order across executions,\n  // so FIFO pop attributes them correctly.\n  #toolCallIdByTaskInput = new Map<string, string[]>();\n\n  /** Feed a single root event. Non-discovery events are ignored. */\n  push(event: Event): void {\n    if (event.method === \"tools\") {\n      this.#onToolEvent(event as ToolsEvent);\n    } else if (event.method === \"values\") {\n      this.#onValuesEvent(event as ValuesEvent);\n    }\n  }\n\n  /** Current snapshot map. */\n  get snapshot(): SubagentMap {\n    return this.store.getSnapshot();\n  }\n\n  discoverFromMessage(message: unknown, namespace: readonly string[]): void {\n    let changed = false;\n    for (const toolCall of getTaskToolCalls(message)) {\n      changed =\n        this.#upsertTaskToolCall(toolCall.id, toolCall.input, namespace) ||\n        changed;\n    }\n    if (changed) this.#commit();\n  }\n\n  #commit(): void {\n    // Rebuild as a fresh Map so React / useSyncExternalStore sees a\n    // new reference on every change.\n    this.store.setValue(\n      new Map(\n        [...this.#map.values()].map((entry) => [entry.id, toSnapshot(entry)])\n      )\n    );\n  }\n\n  #onToolEvent(event: ToolsEvent): void {\n    const data = event.params.data;\n    const toolCallId = (data as { tool_call_id?: string }).tool_call_id;\n    const toolName = (data as { tool_name?: string }).tool_name;\n\n    if (data.event === \"tool-started\" && toolName === \"task\") {\n      const input = parseTaskInput((data as { input?: unknown }).input);\n      if (toolCallId == null) return;\n      this.#upsertTaskToolCall(toolCallId, input, event.params.namespace);\n      this.#commit();\n      return;\n    }\n\n    if (toolCallId == null) return;\n    const entry = this.#map.get(toolCallId);\n    if (entry == null) return;\n\n    if (data.event === \"tool-finished\") {\n      entry.status = \"complete\";\n      entry.output = (data as { output?: unknown }).output;\n      entry.completedAt = new Date();\n      this.#commit();\n      return;\n    }\n\n    if (data.event === \"tool-error\") {\n      entry.status = \"error\";\n      entry.error = (data as { message?: string }).message ?? \"Subagent failed\";\n      entry.completedAt = new Date();\n      this.#commit();\n    }\n  }\n\n  #onValuesEvent(event: ValuesEvent): void {\n    const data = event.params.data;\n    if (data == null || typeof data !== \"object\" || Array.isArray(data)) return;\n    const messages = (data as { messages?: unknown }).messages;\n    if (!Array.isArray(messages)) return;\n\n    // If a `tools:<id>` namespace's first HumanMessage matches a known\n    // taskInput, that's the subagent's execution scope. Record the\n    // binding so `#recordObservedWorkNamespace` can promote it.\n    this.#bindNamespaceByTaskInput(event.params.namespace, messages);\n\n    let changed = this.#recordObservedWorkNamespace(event.params.namespace);\n    for (const message of messages) {\n      for (const toolCall of getTaskToolCalls(message)) {\n        changed =\n          this.#upsertTaskToolCall(\n            toolCall.id,\n            toolCall.input,\n            event.params.namespace\n          ) || changed;\n      }\n\n      const toolCallId = getToolMessageCallId(message);\n      if (toolCallId == null) continue;\n      const existing = this.#map.get(toolCallId);\n      if (existing == null) continue;\n      existing.status = \"complete\";\n      existing.output = message;\n      existing.completedAt = new Date();\n      changed = true;\n    }\n    if (changed) this.#commit();\n  }\n\n  #upsertTaskToolCall(\n    toolCallId: string,\n    input: { description?: string; subagent_type?: string },\n    eventNamespace: readonly string[]\n  ): boolean {\n    const namespace = taskWorkNamespace(toolCallId, eventNamespace);\n    const existing = this.#map.get(toolCallId);\n    if (existing != null) {\n      let changed = false;\n      this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n      const nextName = input.subagent_type ?? existing.name;\n      const nextTaskInput = input.description ?? existing.taskInput;\n      if (existing.name !== nextName) {\n        existing.name = nextName;\n        changed = true;\n      }\n      if (existing.taskInput !== nextTaskInput) {\n        existing.taskInput = nextTaskInput;\n        changed = true;\n      }\n      const namespaceKeyed = namespaceKey(existing.namespace);\n      const ownNamespaceKey = `tools:${toolCallId}`;\n      const nextNamespaceKey = namespaceKey(namespace);\n      if (\n        isConcreteToolNamespace(eventNamespace) ||\n        namespaceKeyed === ownNamespaceKey\n      ) {\n        // A wrapper task tool event can arrive under an execution namespace\n        // like `tools:<uuid>`, while the subagent's actual message state is\n        // under `tools:<tool_call_id>`. Once discovery has observed the own\n        // namespace carrying state, do not demote it back to the wrapper\n        // namespace.\n        if (\n          namespaceKeyed === ownNamespaceKey &&\n          nextNamespaceKey !== ownNamespaceKey &&\n          this.#observedOwnNamespaces.has(toolCallId)\n        ) {\n          return changed;\n        }\n        if (namespaceKeyed !== nextNamespaceKey) {\n          existing.namespace = namespace;\n          changed = true;\n        }\n      }\n      if (existing.status !== \"complete\" && existing.status !== \"error\") {\n        if (existing.status !== \"running\") {\n          existing.status = \"running\";\n          changed = true;\n        }\n      }\n      return changed;\n    }\n\n    // Prefer the namespace where the task is first observed. Later\n    // observations may move it between wrapper execution namespaces\n    // and `[\"tools:<toolCallId>\"]`, depending on where the stream proves\n    // the worker's scoped message/tool state exists.\n    const { parentId, depth } = lineageFromNamespace(eventNamespace);\n    this.#recordTaskNamespaceCandidate(toolCallId, eventNamespace);\n    if (input.description != null) {\n      const queue = this.#toolCallIdByTaskInput.get(input.description) ?? [];\n      queue.push(toolCallId);\n      this.#toolCallIdByTaskInput.set(input.description, queue);\n    }\n    this.#map.set(toolCallId, {\n      id: toolCallId,\n      name: input.subagent_type ?? \"unknown\",\n      namespace,\n      parentId,\n      depth,\n      status: \"running\",\n      taskInput: input.description,\n      output: undefined,\n      error: undefined,\n      startedAt: new Date(),\n      completedAt: null,\n    });\n    return true;\n  }\n\n  #recordObservedWorkNamespace(namespace: readonly string[]): boolean {\n    if (!isConcreteToolNamespace(namespace)) return false;\n    const last = namespace.at(-1);\n    if (last == null) return false;\n    const namespaceKeyed = namespaceKey(namespace);\n    const toolCallId =\n      this.#taskIdByObservedNamespace.get(namespaceKeyed) ??\n      last.slice(\"tools:\".length);\n    const existing = this.#map.get(toolCallId);\n    if (existing == null) return false;\n\n    const ownNamespaceKey = `tools:${toolCallId}`;\n    if (namespaceKeyed === ownNamespaceKey) {\n      this.#observedOwnNamespaces.add(toolCallId);\n    } else if (\n      this.#observedOwnNamespaces.has(toolCallId) ||\n      (!this.#taskIdByObservedNamespace.has(namespaceKeyed) &&\n        !shouldPromoteToObservedNamespace(existing))\n    ) {\n      return false;\n    }\n\n    if (namespaceKey(existing.namespace) === namespaceKeyed) return false;\n    existing.namespace = [...namespace];\n    return true;\n  }\n\n  #recordTaskNamespaceCandidate(\n    toolCallId: string,\n    namespace: readonly string[]\n  ): void {\n    if (!isConcreteToolNamespace(namespace)) return;\n    this.#taskIdByObservedNamespace.set(namespaceKey(namespace), toolCallId);\n  }\n\n  /**\n   * Bind a `tools:<id>` namespace to a registered subagent by looking\n   * up the first HumanMessage content in the `taskInput` index.\n   */\n  #bindNamespaceByTaskInput(\n    namespace: readonly string[],\n    messages: unknown[]\n  ): void {\n    if (!isConcreteToolNamespace(namespace)) return;\n    const namespaceKeyed = namespaceKey(namespace);\n    if (this.#taskIdByObservedNamespace.has(namespaceKeyed)) return;\n\n    const text = getFirstHumanMessageText(messages);\n    if (text == null) return;\n    const toolCallId = this.#toolCallIdByTaskInput.get(text)?.shift();\n    if (toolCallId == null) return;\n    this.#taskIdByObservedNamespace.set(namespaceKeyed, toolCallId);\n  }\n}\n\nfunction getFirstHumanMessageText(messages: unknown[]): string | null {\n  for (const message of messages) {\n    if (message == null || typeof message !== \"object\") continue;\n    const record = message as {\n      type?: unknown;\n      role?: unknown;\n      content?: unknown;\n      kwargs?: { type?: unknown; content?: unknown };\n      lc_kwargs?: { type?: unknown; content?: unknown };\n    };\n    const type =\n      record.type ??\n      record.role ??\n      record.kwargs?.type ??\n      record.lc_kwargs?.type;\n    if (type !== \"human\") continue;\n    const content =\n      record.content ?? record.kwargs?.content ?? record.lc_kwargs?.content;\n    return typeof content === \"string\" && content.length > 0 ? content : null;\n  }\n  return null;\n}\n\nfunction shouldPromoteToObservedNamespace(entry: MutableSubagent): boolean {\n  return (\n    entry.name === \"fanout-worker\" ||\n    /^Worker worker-\\d+/i.test(entry.taskInput ?? \"\")\n  );\n}\n\nfunction taskWorkNamespace(\n  toolCallId: string,\n  eventNamespace: readonly string[]\n): readonly string[] {\n  const last = eventNamespace.at(-1);\n  if (last != null && isToolNamespaceSegment(last)) return [...eventNamespace];\n  return [`tools:${toolCallId}`];\n}\n\nfunction toSnapshot(entry: MutableSubagent): SubagentDiscoverySnapshot {\n  return {\n    id: entry.id,\n    name: entry.name,\n    namespace: entry.namespace,\n    parentId: entry.parentId,\n    depth: entry.depth,\n    status: entry.status,\n    taskInput: entry.taskInput,\n    output: entry.output,\n    error: entry.error,\n    startedAt: entry.startedAt,\n    completedAt: entry.completedAt,\n  };\n}\n\nfunction parseTaskInput(raw: unknown): {\n  description?: string;\n  subagent_type?: string;\n} {\n  if (raw == null) return {};\n  if (typeof raw === \"string\") {\n    try {\n      const parsed = JSON.parse(raw) as Record<string, unknown>;\n      return {\n        description:\n          typeof parsed.description === \"string\"\n            ? parsed.description\n            : undefined,\n        subagent_type:\n          typeof parsed.subagent_type === \"string\"\n            ? parsed.subagent_type\n            : undefined,\n      };\n    } catch {\n      return {};\n    }\n  }\n  if (typeof raw === \"object\" && !Array.isArray(raw)) {\n    const obj = raw as Record<string, unknown>;\n    return {\n      description:\n        typeof obj.description === \"string\" ? obj.description : undefined,\n      subagent_type:\n        typeof obj.subagent_type === \"string\" ? obj.subagent_type : undefined,\n    };\n  }\n  return {};\n}\n\nfunction getTaskToolCalls(message: unknown): Array<{\n  id: string;\n  input: { description?: string; subagent_type?: string };\n}> {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return [];\n  }\n  const record = message as {\n    tool_calls?: unknown;\n    kwargs?: { tool_calls?: unknown };\n    lc_kwargs?: { tool_calls?: unknown };\n  };\n  const toolCalls =\n    record.tool_calls ??\n    record.kwargs?.tool_calls ??\n    record.lc_kwargs?.tool_calls;\n  if (!Array.isArray(toolCalls)) return [];\n\n  const result: Array<{\n    id: string;\n    input: { description?: string; subagent_type?: string };\n  }> = [];\n  for (const toolCall of toolCalls) {\n    if (\n      toolCall == null ||\n      typeof toolCall !== \"object\" ||\n      Array.isArray(toolCall)\n    ) {\n      continue;\n    }\n    const record = toolCall as {\n      id?: unknown;\n      name?: unknown;\n      args?: unknown;\n    };\n    if (typeof record.id !== \"string\" || record.name !== \"task\") continue;\n    result.push({ id: record.id, input: parseTaskInput(record.args) });\n  }\n  return result;\n}\n\nfunction getToolMessageCallId(message: unknown): string | undefined {\n  if (\n    message == null ||\n    typeof message !== \"object\" ||\n    Array.isArray(message)\n  ) {\n    return undefined;\n  }\n  const record = message as {\n    tool_call_id?: unknown;\n    kwargs?: { tool_call_id?: unknown };\n    lc_kwargs?: { tool_call_id?: unknown };\n  };\n  const id =\n    record.tool_call_id ??\n    record.kwargs?.tool_call_id ??\n    record.lc_kwargs?.tool_call_id;\n  return typeof id === \"string\" && id.length > 0 ? id : undefined;\n}\n\n/**\n * Derive (parentId, depth) from a namespace like\n * `[\"subagents:abc:def\"]`. Namespaces form a rooted tree; the last\n * `:` segment of the deepest namespace element is the current node's\n * call-id and the one before it is the parent.\n */\nfunction lineageFromNamespace(namespace: readonly string[]): {\n  parentId: string | null;\n  depth: number;\n} {\n  if (isRootNamespace(namespace)) return { parentId: null, depth: 1 };\n  const last = namespace[namespace.length - 1];\n  if (last == null) return { parentId: null, depth: 1 };\n  // Namespace segments typically look like\n  //   subagents:<parentCallId>:<thisCallId>\n  // but the protocol doesn't mandate that shape; we best-effort.\n  const parts = last.split(\":\").filter((part) => part.length > 0);\n  const trimmed = parts.slice(1); // drop the leading \"subagents\" prefix\n  const depth = Math.max(1, trimmed.length);\n  const parentId = trimmed.length >= 2 ? trimmed[trimmed.length - 2] : null;\n  return { parentId: parentId ?? null, depth };\n}\n"],"mappings":"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"}

package/dist/stream/projections/runtime.cjs

@@ -7,11 +7,12 @@ function openProjectionSubscription({ thread, channels, namespace, depth = 1, re
 	let disposed = false;
 	const start = async () => {
 		try {
-			const subscription = await thread.subscribe({
+			const subscribeParams = {
 				channels: [...channels],
 				namespaces: namespace.length > 0 ? [[...namespace]] : [[]],
 				depth
-			});
+			};
+			const subscription = await thread.subscribe(subscribeParams);
 			handle = subscription;
 			if (disposed) {
 				await subscription.unsubscribe();

package/dist/stream/projections/runtime.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.cjs","names":[],"sources":["../../../src/stream/projections/runtime.ts"],"sourcesContent":["import type { Channel, Event } from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../../client/stream/index.js\";\nimport type { ProjectionRuntime, ThreadStream } from \"../types.js\";\n\ninterface ProjectionSubscriptionOptions {\n  thread: ThreadStream;\n  channels: readonly Channel[];\n  namespace: readonly string[];\n  depth?: number;\n  /**\n   * Some transports pause a subscription between runs. Most projections\n   * intentionally preserve their historical one-pass behavior; opt in when\n   * the projection already handled resume loops.\n   */\n  resumeOnPause?: boolean;\n  onSubscribe?: () => void;\n  onEvent(event: Event): void;\n  onFinally?: () => void;\n}\n\n/**\n * Shared async subscription lifecycle for projection runtimes.\n */\nexport function openProjectionSubscription({\n  thread,\n  channels,\n  namespace,\n  depth = 1,\n  resumeOnPause = false,\n  onSubscribe,\n  onEvent,\n  onFinally,\n}: ProjectionSubscriptionOptions): ProjectionRuntime {\n  let handle: SubscriptionHandle<Event> | undefined;\n  let disposed = false;\n\n  const start = async () => {\n    try {\n      const subscription = await thread.subscribe({\n        channels: [...channels],\n        namespaces: namespace.length > 0 ? [[...namespace]] : [[]],\n        depth,\n      });\n      handle = subscription;\n      if (disposed) {\n        await subscription.unsubscribe();\n        return;\n      }\n      onSubscribe?.();\n\n      do {\n        for await (const event of subscription) {\n          if (disposed) break;\n          onEvent(event);\n        }\n        if (disposed || !resumeOnPause || !subscription.isPaused) break;\n        await subscription.waitForResume();\n      } while (!disposed);\n    } catch {\n      // Thread closed / errored; projections expose their last good snapshot.\n    } finally {\n      onFinally?.();\n    }\n  };\n\n  void start();\n\n  return {\n    async dispose() {\n      disposed = true;\n      try {\n        await handle?.unsubscribe();\n      } catch {\n        // already closed\n      }\n    },\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,2BAA2B,EACzC,QACA,UACA,WACA,QAAQ,GACR,gBAAgB,OAChB,aACA,SACA,aACmD;CACnD,IAAI;CACJ,IAAI,WAAW;CAEf,MAAM,QAAQ,YAAY;AACxB,MAAI;GACF,MAAM,eAAe,MAAM,OAAO,UAAU;IAC1C,UAAU,CAAC,GAAG,SAAS;IACvB,YAAY,UAAU,SAAS,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1D;IACD,CAAC;AACF,YAAS;AACT,OAAI,UAAU;AACZ,UAAM,aAAa,aAAa;AAChC;;AAEF,kBAAe;AAEf,MAAG;AACD,eAAW,MAAM,SAAS,cAAc;AACtC,SAAI,SAAU;AACd,aAAQ,MAAM;;AAEhB,QAAI,YAAY,CAAC,iBAAiB,CAAC,aAAa,SAAU;AAC1D,UAAM,aAAa,eAAe;YAC3B,CAAC;UACJ,WAEE;AACR,gBAAa;;;AAIZ,QAAO;AAEZ,QAAO,EACL,MAAM,UAAU;AACd,aAAW;AACX,MAAI;AACF,SAAM,QAAQ,aAAa;UACrB;IAIX"}
+{"version":3,"file":"runtime.cjs","names":[],"sources":["../../../src/stream/projections/runtime.ts"],"sourcesContent":["import type { Channel, Event } from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../../client/stream/index.js\";\nimport type { ProjectionRuntime, ThreadStream } from \"../types.js\";\n\ninterface ProjectionSubscriptionOptions {\n  thread: ThreadStream;\n  channels: readonly Channel[];\n  namespace: readonly string[];\n  depth?: number;\n  /**\n   * Some transports pause a subscription between runs. Most projections\n   * intentionally preserve their historical one-pass behavior; opt in when\n   * the projection already handled resume loops.\n   */\n  resumeOnPause?: boolean;\n  onSubscribe?: () => void;\n  onEvent(event: Event): void;\n  onFinally?: () => void;\n}\n\n/**\n * Shared async subscription lifecycle for projection runtimes.\n */\nexport function openProjectionSubscription({\n  thread,\n  channels,\n  namespace,\n  depth = 1,\n  resumeOnPause = false,\n  onSubscribe,\n  onEvent,\n  onFinally,\n}: ProjectionSubscriptionOptions): ProjectionRuntime {\n  let handle: SubscriptionHandle<Event> | undefined;\n  let disposed = false;\n\n  const start = async () => {\n    try {\n      const subscribeParams = {\n        channels: [...channels],\n        namespaces:\n          namespace.length > 0\n            ? ([[...namespace]] as string[][])\n            : ([[]] as string[][]),\n        depth,\n      };\n      const subscription = await thread.subscribe(subscribeParams);\n      handle = subscription;\n      if (disposed) {\n        await subscription.unsubscribe();\n        return;\n      }\n      onSubscribe?.();\n\n      do {\n        for await (const event of subscription) {\n          if (disposed) break;\n          onEvent(event);\n        }\n        if (disposed || !resumeOnPause || !subscription.isPaused) break;\n        await subscription.waitForResume();\n      } while (!disposed);\n    } catch {\n      // Thread closed / errored; projections expose their last good snapshot.\n    } finally {\n      onFinally?.();\n    }\n  };\n\n  void start();\n\n  return {\n    async dispose() {\n      disposed = true;\n      try {\n        await handle?.unsubscribe();\n      } catch {\n        // already closed\n      }\n    },\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,2BAA2B,EACzC,QACA,UACA,WACA,QAAQ,GACR,gBAAgB,OAChB,aACA,SACA,aACmD;CACnD,IAAI;CACJ,IAAI,WAAW;CAEf,MAAM,QAAQ,YAAY;AACxB,MAAI;GACF,MAAM,kBAAkB;IACtB,UAAU,CAAC,GAAG,SAAS;IACvB,YACE,UAAU,SAAS,IACd,CAAC,CAAC,GAAG,UAAU,CAAC,GAChB,CAAC,EAAE,CAAC;IACX;IACD;GACD,MAAM,eAAe,MAAM,OAAO,UAAU,gBAAgB;AAC5D,YAAS;AACT,OAAI,UAAU;AACZ,UAAM,aAAa,aAAa;AAChC;;AAEF,kBAAe;AAEf,MAAG;AACD,eAAW,MAAM,SAAS,cAAc;AACtC,SAAI,SAAU;AACd,aAAQ,MAAM;;AAEhB,QAAI,YAAY,CAAC,iBAAiB,CAAC,aAAa,SAAU;AAC1D,UAAM,aAAa,eAAe;YAC3B,CAAC;UACJ,WAEE;AACR,gBAAa;;;AAIZ,QAAO;AAEZ,QAAO,EACL,MAAM,UAAU;AACd,aAAW;AACX,MAAI;AACF,SAAM,QAAQ,aAAa;UACrB;IAIX"}

package/dist/stream/projections/runtime.js

@@ -7,11 +7,12 @@ function openProjectionSubscription({ thread, channels, namespace, depth = 1, re
 	let disposed = false;
 	const start = async () => {
 		try {
-			const subscription = await thread.subscribe({
+			const subscribeParams = {
 				channels: [...channels],
 				namespaces: namespace.length > 0 ? [[...namespace]] : [[]],
 				depth
-			});
+			};
+			const subscription = await thread.subscribe(subscribeParams);
 			handle = subscription;
 			if (disposed) {
 				await subscription.unsubscribe();

package/dist/stream/projections/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../../../src/stream/projections/runtime.ts"],"sourcesContent":["import type { Channel, Event } from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../../client/stream/index.js\";\nimport type { ProjectionRuntime, ThreadStream } from \"../types.js\";\n\ninterface ProjectionSubscriptionOptions {\n  thread: ThreadStream;\n  channels: readonly Channel[];\n  namespace: readonly string[];\n  depth?: number;\n  /**\n   * Some transports pause a subscription between runs. Most projections\n   * intentionally preserve their historical one-pass behavior; opt in when\n   * the projection already handled resume loops.\n   */\n  resumeOnPause?: boolean;\n  onSubscribe?: () => void;\n  onEvent(event: Event): void;\n  onFinally?: () => void;\n}\n\n/**\n * Shared async subscription lifecycle for projection runtimes.\n */\nexport function openProjectionSubscription({\n  thread,\n  channels,\n  namespace,\n  depth = 1,\n  resumeOnPause = false,\n  onSubscribe,\n  onEvent,\n  onFinally,\n}: ProjectionSubscriptionOptions): ProjectionRuntime {\n  let handle: SubscriptionHandle<Event> | undefined;\n  let disposed = false;\n\n  const start = async () => {\n    try {\n      const subscription = await thread.subscribe({\n        channels: [...channels],\n        namespaces: namespace.length > 0 ? [[...namespace]] : [[]],\n        depth,\n      });\n      handle = subscription;\n      if (disposed) {\n        await subscription.unsubscribe();\n        return;\n      }\n      onSubscribe?.();\n\n      do {\n        for await (const event of subscription) {\n          if (disposed) break;\n          onEvent(event);\n        }\n        if (disposed || !resumeOnPause || !subscription.isPaused) break;\n        await subscription.waitForResume();\n      } while (!disposed);\n    } catch {\n      // Thread closed / errored; projections expose their last good snapshot.\n    } finally {\n      onFinally?.();\n    }\n  };\n\n  void start();\n\n  return {\n    async dispose() {\n      disposed = true;\n      try {\n        await handle?.unsubscribe();\n      } catch {\n        // already closed\n      }\n    },\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,2BAA2B,EACzC,QACA,UACA,WACA,QAAQ,GACR,gBAAgB,OAChB,aACA,SACA,aACmD;CACnD,IAAI;CACJ,IAAI,WAAW;CAEf,MAAM,QAAQ,YAAY;AACxB,MAAI;GACF,MAAM,eAAe,MAAM,OAAO,UAAU;IAC1C,UAAU,CAAC,GAAG,SAAS;IACvB,YAAY,UAAU,SAAS,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1D;IACD,CAAC;AACF,YAAS;AACT,OAAI,UAAU;AACZ,UAAM,aAAa,aAAa;AAChC;;AAEF,kBAAe;AAEf,MAAG;AACD,eAAW,MAAM,SAAS,cAAc;AACtC,SAAI,SAAU;AACd,aAAQ,MAAM;;AAEhB,QAAI,YAAY,CAAC,iBAAiB,CAAC,aAAa,SAAU;AAC1D,UAAM,aAAa,eAAe;YAC3B,CAAC;UACJ,WAEE;AACR,gBAAa;;;AAIZ,QAAO;AAEZ,QAAO,EACL,MAAM,UAAU;AACd,aAAW;AACX,MAAI;AACF,SAAM,QAAQ,aAAa;UACrB;IAIX"}
+{"version":3,"file":"runtime.js","names":[],"sources":["../../../src/stream/projections/runtime.ts"],"sourcesContent":["import type { Channel, Event } from \"@langchain/protocol\";\nimport type { SubscriptionHandle } from \"../../client/stream/index.js\";\nimport type { ProjectionRuntime, ThreadStream } from \"../types.js\";\n\ninterface ProjectionSubscriptionOptions {\n  thread: ThreadStream;\n  channels: readonly Channel[];\n  namespace: readonly string[];\n  depth?: number;\n  /**\n   * Some transports pause a subscription between runs. Most projections\n   * intentionally preserve their historical one-pass behavior; opt in when\n   * the projection already handled resume loops.\n   */\n  resumeOnPause?: boolean;\n  onSubscribe?: () => void;\n  onEvent(event: Event): void;\n  onFinally?: () => void;\n}\n\n/**\n * Shared async subscription lifecycle for projection runtimes.\n */\nexport function openProjectionSubscription({\n  thread,\n  channels,\n  namespace,\n  depth = 1,\n  resumeOnPause = false,\n  onSubscribe,\n  onEvent,\n  onFinally,\n}: ProjectionSubscriptionOptions): ProjectionRuntime {\n  let handle: SubscriptionHandle<Event> | undefined;\n  let disposed = false;\n\n  const start = async () => {\n    try {\n      const subscribeParams = {\n        channels: [...channels],\n        namespaces:\n          namespace.length > 0\n            ? ([[...namespace]] as string[][])\n            : ([[]] as string[][]),\n        depth,\n      };\n      const subscription = await thread.subscribe(subscribeParams);\n      handle = subscription;\n      if (disposed) {\n        await subscription.unsubscribe();\n        return;\n      }\n      onSubscribe?.();\n\n      do {\n        for await (const event of subscription) {\n          if (disposed) break;\n          onEvent(event);\n        }\n        if (disposed || !resumeOnPause || !subscription.isPaused) break;\n        await subscription.waitForResume();\n      } while (!disposed);\n    } catch {\n      // Thread closed / errored; projections expose their last good snapshot.\n    } finally {\n      onFinally?.();\n    }\n  };\n\n  void start();\n\n  return {\n    async dispose() {\n      disposed = true;\n      try {\n        await handle?.unsubscribe();\n      } catch {\n        // already closed\n      }\n    },\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,2BAA2B,EACzC,QACA,UACA,WACA,QAAQ,GACR,gBAAgB,OAChB,aACA,SACA,aACmD;CACnD,IAAI;CACJ,IAAI,WAAW;CAEf,MAAM,QAAQ,YAAY;AACxB,MAAI;GACF,MAAM,kBAAkB;IACtB,UAAU,CAAC,GAAG,SAAS;IACvB,YACE,UAAU,SAAS,IACd,CAAC,CAAC,GAAG,UAAU,CAAC,GAChB,CAAC,EAAE,CAAC;IACX;IACD;GACD,MAAM,eAAe,MAAM,OAAO,UAAU,gBAAgB;AAC5D,YAAS;AACT,OAAI,UAAU;AACZ,UAAM,aAAa,aAAa;AAChC;;AAEF,kBAAe;AAEf,MAAG;AACD,eAAW,MAAM,SAAS,cAAc;AACtC,SAAI,SAAU;AACd,aAAQ,MAAM;;AAEhB,QAAI,YAAY,CAAC,iBAAiB,CAAC,aAAa,SAAU;AAC1D,UAAM,aAAa,eAAe;YAC3B,CAAC;UACJ,WAEE;AACR,gBAAa;;;AAIZ,QAAO;AAEZ,QAAO,EACL,MAAM,UAAU;AACd,aAAW;AACX,MAAI;AACF,SAAM,QAAQ,aAAa;UACrB;IAIX"}

package/dist/stream/root-message-projection.cjs

@@ -23,13 +23,6 @@ var RootMessageProjection = class {
 	/** Root snapshot store written to on every merge. */
 	#store;
 	/**
-	* Subagent discovery runner notified about every assembled root
-	* message. Driving discovery from assembled messages (rather than
-	* raw events) lets us discover subagents from synthesized
-	* `tool_calls` without re-parsing protocol payloads.
-	*/
-	#subagents;
-	/**
 	* Stateful chunk assembler for in-flight messages. Reset (via a
 	* fresh instance) on every {@link reset} so a new thread starts
 	* with no half-built messages from the previous one.
@@ -61,16 +54,28 @@ var RootMessageProjection = class {
 	*/
 	#toolCallIdByNamespace = /* @__PURE__ */ new Map();
 	/**
+	* Coalescing buffer for store writes. {@link handleMessage} and
+	* {@link applyValues} stage their computed `messages` / `values`
+	* here instead of calling `store.setState` per event. A single
+	* `setTimeout(0)` flush commits them in one `setState`, so a
+	* burst of SSE events draining as a microtask chain becomes one
+	* store notification at the next macrotask boundary.
+	*
+	* `null` means "no staged write" — once a flush settles, the
+	* slots are cleared so the next call starts from the latest
+	* committed store snapshot.
+	*/
+	#pendingMessages = null;
+	#pendingValues = null;
+	#flushScheduled = false;
+	/**
 	* @param params.messagesKey - Key inside `values` that holds the
 	*   message array.
 	* @param params.store       - Root snapshot store to mutate.
-	* @param params.subagents   - Discovery runner fed by each new
-	*   assembled message.
 	*/
 	constructor(params) {
 		this.#messagesKey = params.messagesKey;
 		this.#store = params.store;
-		this.#subagents = params.subagents;
 	}
 	/**
 	* Drop all per-thread state. Called by the controller on thread
@@ -82,6 +87,9 @@ var RootMessageProjection = class {
 		this.#indexById.clear();
 		this.#valuesMessageIds = /* @__PURE__ */ new Set();
 		this.#toolCallIdByNamespace.clear();
+		this.#pendingMessages = null;
+		this.#pendingValues = null;
+		this.#flushScheduled = false;
 	}
 	/**
 	* Record a `namespace → tool_call_id` mapping captured from a root
@@ -103,7 +111,7 @@ var RootMessageProjection = class {
 	* Captures role/tool metadata on `message-start`, feeds the chunk
 	* to the assembler, projects the assembled output to a
 	* {@link BaseMessage}, and either appends or in-place updates the
-	* store's messages array based on whether the id was seen before.
+	* pending messages buffer based on whether the id was seen before.
 	*
 	* @param event - The `messages` channel event to consume.
 	*/
@@ -133,28 +141,22 @@ var RootMessageProjection = class {
 		if (id == null) return;
 		const captured = this.#roles.get(id) ?? { role: "ai" };
 		const base = require_assembled_to_message.assembledMessageToBaseMessage(update.message, captured.role, { toolCallId: captured.toolCallId });
-		this.#subagents.discoverFromMessage(base, event.params.namespace);
-		this.#store.setState((s) => {
-			const existingIdx = this.#indexById.get(id);
-			let messages;
-			if (existingIdx == null) {
-				this.#indexById.set(id, s.messages.length);
-				messages = [...s.messages, base];
-			} else if (require_message_reconciliation.messagesEqual(s.messages[existingIdx], base)) return s;
-			else {
-				messages = s.messages.slice();
-				messages[existingIdx] = base;
-			}
-			const values = syncMessagesIntoValues(s.values, this.#messagesKey, messages);
-			return values === s.values ? {
-				...s,
-				messages
-			} : {
-				...s,
-				messages,
-				values
-			};
-		});
+		const baselineMessages = this.#pendingMessages ?? this.#store.getSnapshot().messages;
+		const existingIdx = this.#indexById.get(id);
+		let messages;
+		if (existingIdx == null) {
+			this.#indexById.set(id, baselineMessages.length);
+			messages = [...baselineMessages, base];
+		} else if (require_message_reconciliation.messagesEqual(baselineMessages[existingIdx], base)) return;
+		else {
+			messages = baselineMessages.slice();
+			messages[existingIdx] = base;
+		}
+		const baselineValues = this.#pendingValues ?? this.#store.getSnapshot().values;
+		const values = syncMessagesIntoValues(baselineValues, this.#messagesKey, messages);
+		this.#pendingMessages = messages;
+		if (values !== baselineValues) this.#pendingValues = values;
+		this.#scheduleFlush();
 	}
 	/**
 	* Reconcile a full `values` snapshot into the projection.
@@ -172,34 +174,77 @@ var RootMessageProjection = class {
 	*   `values[messagesKey]` and coerced to `BaseMessage` instances.
 	*/
 	applyValues(nextValues, nextMessages) {
+		const baselineSnapshot = this.#store.getSnapshot();
+		const baselineMessages = this.#pendingMessages ?? baselineSnapshot.messages;
+		const baselineValues = this.#pendingValues ?? baselineSnapshot.values;
+		if (nextMessages.length === 0) {
+			if (stateValuesShallowEqual(baselineValues, nextValues, this.#messagesKey)) return;
+			this.#pendingValues = syncMessagesIntoValues(nextValues, this.#messagesKey, baselineMessages);
+			this.#scheduleFlush();
+			return;
+		}
+		const reconciliation = require_message_reconciliation.reconcileMessagesFromValues({
+			valueMessages: nextMessages,
+			currentMessages: baselineMessages,
+			currentIndexById: this.#indexById,
+			previousValueMessageIds: this.#valuesMessageIds,
+			preferValuesMessage: require_message_reconciliation.shouldPreferValuesMessageForToolCalls
+		});
+		this.#valuesMessageIds = reconciliation.valueMessageIds;
+		const messages = reconciliation.messages;
+		const values = {
+			...nextValues,
+			[this.#messagesKey]: messages
+		};
+		if (messages === baselineMessages && stateValuesShallowEqual(baselineValues, values, this.#messagesKey)) return;
+		this.#indexById.clear();
+		for (const [id, idx] of require_message_reconciliation.buildMessageIndex(messages)) this.#indexById.set(id, idx);
+		this.#pendingMessages = messages;
+		this.#pendingValues = values;
+		this.#scheduleFlush();
+	}
+	/**
+	* Schedule a coalesced flush on the next macrotask. Idempotent
+	* within a tick — multiple `handleMessage` / `applyValues` calls
+	* before the flush fires collapse into one store write.
+	*
+	* `setTimeout(0)` is a macrotask: it runs after the current
+	* microtask chain drains, so a burst of SSE events processed by
+	* the controller's `for await` pump becomes one `store.setState`
+	* (and therefore one `useSyncExternalStore` notification).
+	*/
+	#scheduleFlush = () => {
+		if (this.#flushScheduled) return;
+		this.#flushScheduled = true;
+		setTimeout(this.#flushPending, 0);
+	};
+	/**
+	* Drain `#pendingMessages` / `#pendingValues` to the store in a
+	* single `setState` call.
+	*/
+	#flushPending = () => {
+		this.#flushScheduled = false;
+		const messages = this.#pendingMessages;
+		const values = this.#pendingValues;
+		this.#pendingMessages = null;
+		this.#pendingValues = null;
+		if (messages == null && values == null) return;
 		this.#store.setState((s) => {
-			if (nextMessages.length === 0) return stateValuesShallowEqual(s.values, nextValues, this.#messagesKey) ? s : {
+			if (messages == null) return values == null ? s : {
 				...s,
-				values: nextValues
+				values
 			};
-			const reconciliation = require_message_reconciliation.reconcileMessagesFromValues({
-				valueMessages: nextMessages,
-				currentMessages: s.messages,
-				currentIndexById: this.#indexById,
-				previousValueMessageIds: this.#valuesMessageIds,
-				preferValuesMessage: require_message_reconciliation.shouldPreferValuesMessageForToolCalls
-			});
-			this.#valuesMessageIds = reconciliation.valueMessageIds;
-			const messages = reconciliation.messages;
-			const values = {
-				...nextValues,
-				[this.#messagesKey]: messages
+			if (values == null) return {
+				...s,
+				messages
 			};
-			if (messages === s.messages && stateValuesShallowEqual(s.values, values, this.#messagesKey)) return s;
-			this.#indexById.clear();
-			for (const [id, idx] of require_message_reconciliation.buildMessageIndex(messages)) this.#indexById.set(id, idx);
 			return {
 				...s,
-				values,
-				messages
+				messages,
+				values
 			};
 		});
-	}
+	};
 };
 /**
 * Mirror a freshly-updated message list into `values[messagesKey]`.