@langchain/langgraph-sdk 1.12.3 → 1.12.5

package/dist/stream/discovery/namespace-from-history.cjs

@@ -37,7 +37,7 @@ function collectDirectTaskMappings(tasks, targets, out) {
 * direct mapping is never overwritten by a positional guess.
 */
 function collectPositionalTaskMappings(checkpoint, targets, out, messagesKey) {
-	const pushTasks = getTasks(checkpoint).filter((t) => Array.isArray(t.path) && t.path[0] === "__pregel_push" && typeof t.path[1] === "number" && typeof t.id === "string" && typeof t.name === "string");
+	const pushTasks = getTasks(checkpoint).filter((t) => Array.isArray(t.path) && t.path[0] === "__pregel_push" && typeof t.path[1] === "number" && t.path.length <= 3 && typeof t.id === "string" && typeof t.name === "string");
 	if (pushTasks.length === 0) return;
 	const msgs = checkpoint.values?.[messagesKey];
 	if (!Array.isArray(msgs)) return;

package/dist/stream/discovery/namespace-from-history.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"namespace-from-history.cjs","names":["normalizeAIMessageToolCalls","DEFAULT_MESSAGES_KEY","namespaceKey"],"sources":["../../../src/stream/discovery/namespace-from-history.ts"],"sourcesContent":["/**\n * Reconstruct discovery namespaces from checkpoint history.\n *\n * On reconnect the always-on SSE replay eventually re-derives every\n * subagent execution namespace and every subgraph host, but that costs\n * a full depth-1 replay. This module derives the same information from\n * a single bounded `getHistory()` read so the controller can promote\n * namespaces immediately on `hydrate()` (subgraph hosts + subagent\n * execution namespaces) and lazily for a single opened subagent.\n *\n * The logic mirrors the live discovery state machines so a\n * history-derived namespace and an SSE-derived one cannot disagree:\n *  - subagent mapping ports {@link ../../ui/manager} `fetchSubagentHistory`\n *    (direct task-result mapping, then positional Send-index fallback);\n *  - subgraph host detection ports the strict-prefix promotion rule in\n *    {@link ./subgraphs}.\n */\nimport type { Client } from \"../../client/index.js\";\nimport type {\n  Checkpoint,\n  Config,\n  Metadata,\n  ThreadState,\n} from \"../../schema.js\";\nimport { NAMESPACE_SEPARATOR, DEFAULT_MESSAGES_KEY } from \"../constants.js\";\nimport { namespaceKey } from \"../namespace.js\";\nimport { normalizeAIMessageToolCalls } from \"../message-coercion.js\";\n\ntype AnyCheckpoint = ThreadState<Record<string, unknown>>;\n\ninterface HistoryTask {\n  id?: unknown;\n  name?: unknown;\n  path?: unknown;\n  result?: { messages?: unknown[] };\n  checkpoint?: { checkpoint_ns?: unknown } | null;\n}\n\nfunction getTasks(checkpoint: AnyCheckpoint): HistoryTask[] {\n  const tasks = (checkpoint as { tasks?: unknown }).tasks;\n  return Array.isArray(tasks) ? (tasks as HistoryTask[]) : [];\n}\n\n/**\n * Phase 1 (preferred): map a `task` tool-call id directly to its\n * execution namespace via the task's result `ToolMessage`. Unambiguous\n * — works even when a step mixes subagent and non-subagent tool calls.\n *\n * The subgraph checkpoint_ns is `task.name + \":\" + task.id` (mirrors\n * pregel's `taskCheckpointNamespace`), so we derive it from name+id\n * rather than the always-null completed-task checkpoint.\n */\nexport function collectDirectTaskMappings(\n  tasks: HistoryTask[],\n  targets: Set<string>,\n  out: Map<string, string>\n): void {\n  for (const task of tasks) {\n    if (\n      !Array.isArray(task.path) ||\n      task.path[0] !== \"__pregel_push\" ||\n      typeof task.id !== \"string\" ||\n      typeof task.name !== \"string\"\n    ) {\n      continue;\n    }\n    const resultMessages = task.result?.messages;\n    if (!Array.isArray(resultMessages)) continue;\n    for (const msg of resultMessages) {\n      const m = msg as Record<string, unknown>;\n      const id = m.tool_call_id;\n      if (\n        m.type === \"tool\" &&\n        typeof id === \"string\" &&\n        targets.has(id) &&\n        !out.has(id)\n      ) {\n        out.set(id, `${task.name}:${task.id}`);\n      }\n    }\n  }\n}\n\n/**\n * Phase 2 (fallback): align still-pending push tasks to the triggering\n * AI message's tool calls by Send index (`path[1]`), where `path[1]`\n * indexes into the *full* `tool_calls` array. Only push tasks whose\n * targeted call is a subagent `task` are mapped, so a sibling\n * non-subagent tool call in the same message can't capture a subagent's\n * namespace. Applied only to ids Phase 1 could not resolve so a correct\n * direct mapping is never overwritten by a positional guess.\n */\nexport function collectPositionalTaskMappings(\n  checkpoint: AnyCheckpoint,\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  const pushTasks = getTasks(checkpoint).filter(\n    (t) =>\n      Array.isArray(t.path) &&\n      t.path[0] === \"__pregel_push\" &&\n      typeof t.path[1] === \"number\" &&\n      typeof t.id === \"string\" &&\n      typeof t.name === \"string\"\n  );\n  if (pushTasks.length === 0) return;\n\n  const msgs = (checkpoint.values as Record<string, unknown> | undefined)?.[\n    messagesKey\n  ];\n  if (!Array.isArray(msgs)) return;\n\n  let toolCalls: Array<{ id?: string; name?: string }> | undefined;\n  for (let i = msgs.length - 1; i >= 0; i -= 1) {\n    const m = msgs[i] as Record<string, unknown>;\n    if (m.type !== \"ai\") continue;\n    const normalized = normalizeAIMessageToolCalls(\n      m as unknown as Parameters<typeof normalizeAIMessageToolCalls>[0]\n    ) as Record<string, unknown>;\n    const normalizedToolCalls = normalized.tool_calls;\n    if (\n      Array.isArray(normalizedToolCalls) &&\n      (normalizedToolCalls as Array<{ name?: string }>).some(\n        (tc) => tc.name === \"task\"\n      )\n    ) {\n      toolCalls = normalizedToolCalls as Array<{\n        id?: string;\n        name?: string;\n      }>;\n      break;\n    }\n  }\n  if (toolCalls == null) return;\n\n  // `path[1]` is the Send index into the *full* `tool_calls` array, not the\n  // subagent-only subset. Resolve each push task against that array and map\n  // it only when the targeted call is itself a `task`, so a sibling\n  // non-subagent tool call cannot capture a subagent's namespace.\n  for (const task of pushTasks) {\n    const index = (task.path as unknown[])[1] as number;\n    const tc = toolCalls[index];\n    if (\n      tc?.name === \"task\" &&\n      tc.id != null &&\n      typeof task.id === \"string\" &&\n      typeof task.name === \"string\" &&\n      targets.has(tc.id) &&\n      !out.has(tc.id)\n    ) {\n      out.set(tc.id, `${task.name}:${task.id}`);\n    }\n  }\n}\n\n/** Build a `getHistory` `before` cursor from a history entry. */\nfunction beforeCursor(entry: AnyCheckpoint): Config | undefined {\n  const checkpointId = entry.checkpoint?.checkpoint_id;\n  if (typeof checkpointId !== \"string\") return undefined;\n  return { configurable: { checkpoint_id: checkpointId } };\n}\n\nfunction applyCollectors(\n  history: AnyCheckpoint[],\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  for (const checkpoint of history) {\n    collectDirectTaskMappings(getTasks(checkpoint), targets, out);\n  }\n  const stillUnmapped = () => [...targets].some((id) => !out.has(id));\n  if (stillUnmapped()) {\n    for (const checkpoint of history) {\n      if (!stillUnmapped()) break;\n      collectPositionalTaskMappings(checkpoint, targets, out, messagesKey);\n    }\n  }\n}\n\n/**\n * Synchronous subagent namespace mapping over an already-fetched\n * history page. Used by {@link resolveSubagentNamespaces} and by the\n * controller's hydrate-time bulk seed (which shares a single\n * `getHistory` page with subgraph host detection).\n */\nexport function mapSubagentNamespaces(\n  history: AnyCheckpoint[],\n  toolCallIds: string[],\n  messagesKey = DEFAULT_MESSAGES_KEY\n): Map<string, string> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n  applyCollectors(history, targets, out, messagesKey);\n  return out;\n}\n\n/**\n * Resolve execution namespaces for the given subagent `task` tool-call\n * ids from checkpoint history.\n *\n * Bounded and O(1) in calls: one `getHistory` page, plus at most one\n * `before`-cursor fallback page when the first leaves ids unresolved.\n * Never fans out per id.\n *\n * @returns Map of `toolCallId` → single execution namespace segment\n *   (e.g. `tools:<uuid>`). Unresolved ids are omitted.\n */\nexport async function resolveSubagentNamespaces<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  toolCallIds: string[],\n  opts?: { limit?: number; messagesKey?: string; signal?: AbortSignal }\n): Promise<Map<string, string>> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n\n  const limit = opts?.limit ?? 20;\n  const messagesKey = opts?.messagesKey ?? DEFAULT_MESSAGES_KEY;\n  const signal = opts?.signal;\n\n  const page1 = await getHistoryPage(client, threadId, { limit, signal });\n  applyCollectors(page1, targets, out, messagesKey);\n\n  const unresolved = [...targets].filter((id) => !out.has(id));\n  if (unresolved.length > 0 && page1.length > 0) {\n    const before = beforeCursor(page1[page1.length - 1]);\n    if (before != null) {\n      const page2 = await getHistoryPage(client, threadId, {\n        limit,\n        before,\n        signal,\n      });\n      applyCollectors(page2, targets, out, messagesKey);\n    }\n  }\n\n  return out;\n}\n\n/**\n * Fetch one bounded history page typed as plain records, sidestepping\n * the client's `TStateType` generic so the discovery collectors (which\n * read raw `values`/`tasks`) get a stable {@link AnyCheckpoint} shape.\n */\nexport function getHistoryPage<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  options: {\n    limit?: number;\n    before?: Config;\n    checkpoint?: Partial<Omit<Checkpoint, \"thread_id\">>;\n    metadata?: Metadata;\n    signal?: AbortSignal;\n  }\n): Promise<AnyCheckpoint[]> {\n  return client.threads.getHistory<Record<string, unknown>>(threadId, options);\n}\n\nexport interface SubgraphHost {\n  namespace: string[];\n  status: \"running\" | \"complete\" | \"error\";\n}\n\nfunction checkpointNsToSegments(checkpointNs: unknown): string[] {\n  if (typeof checkpointNs !== \"string\" || checkpointNs.length === 0) return [];\n  return checkpointNs.split(\"|\").filter((segment) => segment.length > 0);\n}\n\nfunction isInternalSegment(segment: string): boolean {\n  return segment.startsWith(\"tools:\") || segment.startsWith(\"task:\");\n}\n\n/**\n * Identify subgraph host namespaces from checkpoint history, mirroring the\n * promotion rule of the live {@link ./subgraphs} `SubgraphDiscovery`: a\n * namespace is a host iff it is a *strict ancestor* of a deeper namespace,\n * and inner function-node leaves are never promoted on their own.\n *\n * Two host signals are derived from the checkpoint namespaces observed in\n * history (`state` + `task` `checkpoint_ns`):\n *\n *  - **Interior hosts** — every strict ancestor of an observed namespace.\n *    Each segment of a nested `checkpoint_ns` wraps a deeper one, so the\n *    parent is always a subgraph (this also recovers a host whose own\n *    checkpoint fell outside the fetched page).\n *  - **Top-level hosts** — every depth-1 observed namespace. A top-level\n *    subgraph is always a host, including the values-only shape supported\n *    by `SubgraphDiscovery.#onValuesEvent`, where the host (e.g.\n *    `research:<uuid>`) appears with no deeper `research:<uuid>|...` key.\n *    The old strict-prefix rule dropped those, so reconnecting waited for\n *    SSE replay instead of hydrating the card immediately.\n *\n * A *deeper* observed namespace's own deepest segment is NOT promoted\n * unless it is itself an ancestor of something deeper — otherwise a plain\n * inner node (e.g. `worker:<uuid>|inner:<uuid>`) would surface as a\n * spurious subgraph card that was never present during live streaming.\n *\n * Tool/subagent namespaces (`tools:` / `task:`) are excluded — those are\n * owned by {@link ./subagents}. A namespace nested under a subgraph (e.g.\n * `research:<uuid>|tools:<uuid>`) still promotes its non-internal\n * `research:<uuid>` ancestor.\n */\nexport function collectSubgraphHostNamespaces(\n  history: AnyCheckpoint[]\n): SubgraphHost[] {\n  // Directly observed namespace tuples (state + task checkpoint_ns), with\n  // NO prefix synthesis — host promotion is derived below so that a deeper\n  // namespace's leaf segment is not mistaken for a host.\n  const observed = new Map<string, string[]>();\n  const record = (segments: string[]) => {\n    if (segments.length === 0) return;\n    observed.set(namespaceKey(segments), segments);\n  };\n  for (const state of history) {\n    record(checkpointNsToSegments(state.checkpoint?.checkpoint_ns));\n    for (const task of getTasks(state)) {\n      record(checkpointNsToSegments(task.checkpoint?.checkpoint_ns));\n    }\n  }\n\n  // Pending namespaces of the newest checkpoint → still running.\n  const pending = new Set<string>();\n  if (history.length > 0) {\n    for (const task of getTasks(history[0])) {\n      const segments = checkpointNsToSegments(task.checkpoint?.checkpoint_ns);\n      if (segments.length > 0) pending.add(namespaceKey(segments));\n    }\n  }\n\n  // Host candidates = strict ancestors of observed (interior) + depth-1\n  // observed (top-level). Insertion order: shallow ancestors first so the\n  // emitted host list keeps parents ahead of children.\n  const candidates = new Map<string, string[]>();\n  for (const segments of observed.values()) {\n    for (let depth = 1; depth < segments.length; depth += 1) {\n      const slice = segments.slice(0, depth);\n      candidates.set(namespaceKey(slice), slice);\n    }\n    if (segments.length === 1) {\n      candidates.set(namespaceKey(segments), segments);\n    }\n  }\n\n  const hosts: SubgraphHost[] = [];\n  for (const [key, segments] of candidates) {\n    if (segments.some(isInternalSegment)) continue;\n    const prefix = key + NAMESPACE_SEPARATOR;\n    const running =\n      pending.has(key) || [...pending].some((p) => p.startsWith(prefix));\n    hosts.push({\n      namespace: segments,\n      status: running ? \"running\" : \"complete\",\n    });\n  }\n  return hosts;\n}\n"],"mappings":"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"}
+{"version":3,"file":"namespace-from-history.cjs","names":["normalizeAIMessageToolCalls","DEFAULT_MESSAGES_KEY","namespaceKey"],"sources":["../../../src/stream/discovery/namespace-from-history.ts"],"sourcesContent":["/**\n * Reconstruct discovery namespaces from checkpoint history.\n *\n * On reconnect the always-on SSE replay eventually re-derives every\n * subagent execution namespace and every subgraph host, but that costs\n * a full depth-1 replay. This module derives the same information from\n * a single bounded `getHistory()` read so the controller can promote\n * namespaces immediately on `hydrate()` (subgraph hosts + subagent\n * execution namespaces) and lazily for a single opened subagent.\n *\n * The logic mirrors the live discovery state machines so a\n * history-derived namespace and an SSE-derived one cannot disagree:\n *  - subagent mapping ports {@link ../../ui/manager} `fetchSubagentHistory`\n *    (direct task-result mapping, then positional Send-index fallback);\n *  - subgraph host detection ports the strict-prefix promotion rule in\n *    {@link ./subgraphs}.\n */\nimport type { Client } from \"../../client/index.js\";\nimport type {\n  Checkpoint,\n  Config,\n  Metadata,\n  ThreadState,\n} from \"../../schema.js\";\nimport { NAMESPACE_SEPARATOR, DEFAULT_MESSAGES_KEY } from \"../constants.js\";\nimport { namespaceKey } from \"../namespace.js\";\nimport { normalizeAIMessageToolCalls } from \"../message-coercion.js\";\n\ntype AnyCheckpoint = ThreadState<Record<string, unknown>>;\n\ninterface HistoryTask {\n  id?: unknown;\n  name?: unknown;\n  path?: unknown;\n  result?: { messages?: unknown[] };\n  checkpoint?: { checkpoint_ns?: unknown } | null;\n}\n\nfunction getTasks(checkpoint: AnyCheckpoint): HistoryTask[] {\n  const tasks = (checkpoint as { tasks?: unknown }).tasks;\n  return Array.isArray(tasks) ? (tasks as HistoryTask[]) : [];\n}\n\n/**\n * Phase 1 (preferred): map a `task` tool-call id directly to its\n * execution namespace via the task's result `ToolMessage`. Unambiguous\n * — works even when a step mixes subagent and non-subagent tool calls.\n *\n * The subgraph checkpoint_ns is `task.name + \":\" + task.id` (mirrors\n * pregel's `taskCheckpointNamespace`), so we derive it from name+id\n * rather than the always-null completed-task checkpoint.\n */\nexport function collectDirectTaskMappings(\n  tasks: HistoryTask[],\n  targets: Set<string>,\n  out: Map<string, string>\n): void {\n  for (const task of tasks) {\n    if (\n      !Array.isArray(task.path) ||\n      task.path[0] !== \"__pregel_push\" ||\n      typeof task.id !== \"string\" ||\n      typeof task.name !== \"string\"\n    ) {\n      continue;\n    }\n    const resultMessages = task.result?.messages;\n    if (!Array.isArray(resultMessages)) continue;\n    for (const msg of resultMessages) {\n      const m = msg as Record<string, unknown>;\n      const id = m.tool_call_id;\n      if (\n        m.type === \"tool\" &&\n        typeof id === \"string\" &&\n        targets.has(id) &&\n        !out.has(id)\n      ) {\n        out.set(id, `${task.name}:${task.id}`);\n      }\n    }\n  }\n}\n\n/**\n * Phase 2 (fallback): align still-pending push tasks to the triggering\n * AI message's tool calls by Send index (`path[1]`), where `path[1]`\n * indexes into the *full* `tool_calls` array. Only push tasks whose\n * targeted call is a subagent `task` are mapped, so a sibling\n * non-subagent tool call in the same message can't capture a subagent's\n * namespace. Applied only to ids Phase 1 could not resolve so a correct\n * direct mapping is never overwritten by a positional guess.\n */\nexport function collectPositionalTaskMappings(\n  checkpoint: AnyCheckpoint,\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  const pushTasks = getTasks(checkpoint).filter(\n    (t) =>\n      Array.isArray(t.path) &&\n      t.path[0] === \"__pregel_push\" &&\n      typeof t.path[1] === \"number\" &&\n      // Send tasks are `[PUSH, i]` (legacy JS servers) or `[PUSH, i, false]`\n      // (aligned with Python); longer paths are error handlers of failed\n      // Sends (`[PUSH, i, false, \"node_error_handler\", false]`) and must not\n      // be mistaken for a second Send at the same index.\n      t.path.length <= 3 &&\n      typeof t.id === \"string\" &&\n      typeof t.name === \"string\"\n  );\n  if (pushTasks.length === 0) return;\n\n  const msgs = (checkpoint.values as Record<string, unknown> | undefined)?.[\n    messagesKey\n  ];\n  if (!Array.isArray(msgs)) return;\n\n  let toolCalls: Array<{ id?: string; name?: string }> | undefined;\n  for (let i = msgs.length - 1; i >= 0; i -= 1) {\n    const m = msgs[i] as Record<string, unknown>;\n    if (m.type !== \"ai\") continue;\n    const normalized = normalizeAIMessageToolCalls(\n      m as unknown as Parameters<typeof normalizeAIMessageToolCalls>[0]\n    ) as Record<string, unknown>;\n    const normalizedToolCalls = normalized.tool_calls;\n    if (\n      Array.isArray(normalizedToolCalls) &&\n      (normalizedToolCalls as Array<{ name?: string }>).some(\n        (tc) => tc.name === \"task\"\n      )\n    ) {\n      toolCalls = normalizedToolCalls as Array<{\n        id?: string;\n        name?: string;\n      }>;\n      break;\n    }\n  }\n  if (toolCalls == null) return;\n\n  // `path[1]` is the Send index into the *full* `tool_calls` array, not the\n  // subagent-only subset. Resolve each push task against that array and map\n  // it only when the targeted call is itself a `task`, so a sibling\n  // non-subagent tool call cannot capture a subagent's namespace.\n  for (const task of pushTasks) {\n    const index = (task.path as unknown[])[1] as number;\n    const tc = toolCalls[index];\n    if (\n      tc?.name === \"task\" &&\n      tc.id != null &&\n      typeof task.id === \"string\" &&\n      typeof task.name === \"string\" &&\n      targets.has(tc.id) &&\n      !out.has(tc.id)\n    ) {\n      out.set(tc.id, `${task.name}:${task.id}`);\n    }\n  }\n}\n\n/** Build a `getHistory` `before` cursor from a history entry. */\nfunction beforeCursor(entry: AnyCheckpoint): Config | undefined {\n  const checkpointId = entry.checkpoint?.checkpoint_id;\n  if (typeof checkpointId !== \"string\") return undefined;\n  return { configurable: { checkpoint_id: checkpointId } };\n}\n\nfunction applyCollectors(\n  history: AnyCheckpoint[],\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  for (const checkpoint of history) {\n    collectDirectTaskMappings(getTasks(checkpoint), targets, out);\n  }\n  const stillUnmapped = () => [...targets].some((id) => !out.has(id));\n  if (stillUnmapped()) {\n    for (const checkpoint of history) {\n      if (!stillUnmapped()) break;\n      collectPositionalTaskMappings(checkpoint, targets, out, messagesKey);\n    }\n  }\n}\n\n/**\n * Synchronous subagent namespace mapping over an already-fetched\n * history page. Used by {@link resolveSubagentNamespaces} and by the\n * controller's hydrate-time bulk seed (which shares a single\n * `getHistory` page with subgraph host detection).\n */\nexport function mapSubagentNamespaces(\n  history: AnyCheckpoint[],\n  toolCallIds: string[],\n  messagesKey = DEFAULT_MESSAGES_KEY\n): Map<string, string> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n  applyCollectors(history, targets, out, messagesKey);\n  return out;\n}\n\n/**\n * Resolve execution namespaces for the given subagent `task` tool-call\n * ids from checkpoint history.\n *\n * Bounded and O(1) in calls: one `getHistory` page, plus at most one\n * `before`-cursor fallback page when the first leaves ids unresolved.\n * Never fans out per id.\n *\n * @returns Map of `toolCallId` → single execution namespace segment\n *   (e.g. `tools:<uuid>`). Unresolved ids are omitted.\n */\nexport async function resolveSubagentNamespaces<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  toolCallIds: string[],\n  opts?: { limit?: number; messagesKey?: string; signal?: AbortSignal }\n): Promise<Map<string, string>> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n\n  const limit = opts?.limit ?? 20;\n  const messagesKey = opts?.messagesKey ?? DEFAULT_MESSAGES_KEY;\n  const signal = opts?.signal;\n\n  const page1 = await getHistoryPage(client, threadId, { limit, signal });\n  applyCollectors(page1, targets, out, messagesKey);\n\n  const unresolved = [...targets].filter((id) => !out.has(id));\n  if (unresolved.length > 0 && page1.length > 0) {\n    const before = beforeCursor(page1[page1.length - 1]);\n    if (before != null) {\n      const page2 = await getHistoryPage(client, threadId, {\n        limit,\n        before,\n        signal,\n      });\n      applyCollectors(page2, targets, out, messagesKey);\n    }\n  }\n\n  return out;\n}\n\n/**\n * Fetch one bounded history page typed as plain records, sidestepping\n * the client's `TStateType` generic so the discovery collectors (which\n * read raw `values`/`tasks`) get a stable {@link AnyCheckpoint} shape.\n */\nexport function getHistoryPage<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  options: {\n    limit?: number;\n    before?: Config;\n    checkpoint?: Partial<Omit<Checkpoint, \"thread_id\">>;\n    metadata?: Metadata;\n    signal?: AbortSignal;\n  }\n): Promise<AnyCheckpoint[]> {\n  return client.threads.getHistory<Record<string, unknown>>(threadId, options);\n}\n\nexport interface SubgraphHost {\n  namespace: string[];\n  status: \"running\" | \"complete\" | \"error\";\n}\n\nfunction checkpointNsToSegments(checkpointNs: unknown): string[] {\n  if (typeof checkpointNs !== \"string\" || checkpointNs.length === 0) return [];\n  return checkpointNs.split(\"|\").filter((segment) => segment.length > 0);\n}\n\nfunction isInternalSegment(segment: string): boolean {\n  return segment.startsWith(\"tools:\") || segment.startsWith(\"task:\");\n}\n\n/**\n * Identify subgraph host namespaces from checkpoint history, mirroring the\n * promotion rule of the live {@link ./subgraphs} `SubgraphDiscovery`: a\n * namespace is a host iff it is a *strict ancestor* of a deeper namespace,\n * and inner function-node leaves are never promoted on their own.\n *\n * Two host signals are derived from the checkpoint namespaces observed in\n * history (`state` + `task` `checkpoint_ns`):\n *\n *  - **Interior hosts** — every strict ancestor of an observed namespace.\n *    Each segment of a nested `checkpoint_ns` wraps a deeper one, so the\n *    parent is always a subgraph (this also recovers a host whose own\n *    checkpoint fell outside the fetched page).\n *  - **Top-level hosts** — every depth-1 observed namespace. A top-level\n *    subgraph is always a host, including the values-only shape supported\n *    by `SubgraphDiscovery.#onValuesEvent`, where the host (e.g.\n *    `research:<uuid>`) appears with no deeper `research:<uuid>|...` key.\n *    The old strict-prefix rule dropped those, so reconnecting waited for\n *    SSE replay instead of hydrating the card immediately.\n *\n * A *deeper* observed namespace's own deepest segment is NOT promoted\n * unless it is itself an ancestor of something deeper — otherwise a plain\n * inner node (e.g. `worker:<uuid>|inner:<uuid>`) would surface as a\n * spurious subgraph card that was never present during live streaming.\n *\n * Tool/subagent namespaces (`tools:` / `task:`) are excluded — those are\n * owned by {@link ./subagents}. A namespace nested under a subgraph (e.g.\n * `research:<uuid>|tools:<uuid>`) still promotes its non-internal\n * `research:<uuid>` ancestor.\n */\nexport function collectSubgraphHostNamespaces(\n  history: AnyCheckpoint[]\n): SubgraphHost[] {\n  // Directly observed namespace tuples (state + task checkpoint_ns), with\n  // NO prefix synthesis — host promotion is derived below so that a deeper\n  // namespace's leaf segment is not mistaken for a host.\n  const observed = new Map<string, string[]>();\n  const record = (segments: string[]) => {\n    if (segments.length === 0) return;\n    observed.set(namespaceKey(segments), segments);\n  };\n  for (const state of history) {\n    record(checkpointNsToSegments(state.checkpoint?.checkpoint_ns));\n    for (const task of getTasks(state)) {\n      record(checkpointNsToSegments(task.checkpoint?.checkpoint_ns));\n    }\n  }\n\n  // Pending namespaces of the newest checkpoint → still running.\n  const pending = new Set<string>();\n  if (history.length > 0) {\n    for (const task of getTasks(history[0])) {\n      const segments = checkpointNsToSegments(task.checkpoint?.checkpoint_ns);\n      if (segments.length > 0) pending.add(namespaceKey(segments));\n    }\n  }\n\n  // Host candidates = strict ancestors of observed (interior) + depth-1\n  // observed (top-level). Insertion order: shallow ancestors first so the\n  // emitted host list keeps parents ahead of children.\n  const candidates = new Map<string, string[]>();\n  for (const segments of observed.values()) {\n    for (let depth = 1; depth < segments.length; depth += 1) {\n      const slice = segments.slice(0, depth);\n      candidates.set(namespaceKey(slice), slice);\n    }\n    if (segments.length === 1) {\n      candidates.set(namespaceKey(segments), segments);\n    }\n  }\n\n  const hosts: SubgraphHost[] = [];\n  for (const [key, segments] of candidates) {\n    if (segments.some(isInternalSegment)) continue;\n    const prefix = key + NAMESPACE_SEPARATOR;\n    const running =\n      pending.has(key) || [...pending].some((p) => p.startsWith(prefix));\n    hosts.push({\n      namespace: segments,\n      status: running ? \"running\" : \"complete\",\n    });\n  }\n  return hosts;\n}\n"],"mappings":"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"}

package/dist/stream/discovery/namespace-from-history.js

@@ -37,7 +37,7 @@ function collectDirectTaskMappings(tasks, targets, out) {
 * direct mapping is never overwritten by a positional guess.
 */
 function collectPositionalTaskMappings(checkpoint, targets, out, messagesKey) {
-	const pushTasks = getTasks(checkpoint).filter((t) => Array.isArray(t.path) && t.path[0] === "__pregel_push" && typeof t.path[1] === "number" && typeof t.id === "string" && typeof t.name === "string");
+	const pushTasks = getTasks(checkpoint).filter((t) => Array.isArray(t.path) && t.path[0] === "__pregel_push" && typeof t.path[1] === "number" && t.path.length <= 3 && typeof t.id === "string" && typeof t.name === "string");
 	if (pushTasks.length === 0) return;
 	const msgs = checkpoint.values?.[messagesKey];
 	if (!Array.isArray(msgs)) return;

package/dist/stream/discovery/namespace-from-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"namespace-from-history.js","names":[],"sources":["../../../src/stream/discovery/namespace-from-history.ts"],"sourcesContent":["/**\n * Reconstruct discovery namespaces from checkpoint history.\n *\n * On reconnect the always-on SSE replay eventually re-derives every\n * subagent execution namespace and every subgraph host, but that costs\n * a full depth-1 replay. This module derives the same information from\n * a single bounded `getHistory()` read so the controller can promote\n * namespaces immediately on `hydrate()` (subgraph hosts + subagent\n * execution namespaces) and lazily for a single opened subagent.\n *\n * The logic mirrors the live discovery state machines so a\n * history-derived namespace and an SSE-derived one cannot disagree:\n *  - subagent mapping ports {@link ../../ui/manager} `fetchSubagentHistory`\n *    (direct task-result mapping, then positional Send-index fallback);\n *  - subgraph host detection ports the strict-prefix promotion rule in\n *    {@link ./subgraphs}.\n */\nimport type { Client } from \"../../client/index.js\";\nimport type {\n  Checkpoint,\n  Config,\n  Metadata,\n  ThreadState,\n} from \"../../schema.js\";\nimport { NAMESPACE_SEPARATOR, DEFAULT_MESSAGES_KEY } from \"../constants.js\";\nimport { namespaceKey } from \"../namespace.js\";\nimport { normalizeAIMessageToolCalls } from \"../message-coercion.js\";\n\ntype AnyCheckpoint = ThreadState<Record<string, unknown>>;\n\ninterface HistoryTask {\n  id?: unknown;\n  name?: unknown;\n  path?: unknown;\n  result?: { messages?: unknown[] };\n  checkpoint?: { checkpoint_ns?: unknown } | null;\n}\n\nfunction getTasks(checkpoint: AnyCheckpoint): HistoryTask[] {\n  const tasks = (checkpoint as { tasks?: unknown }).tasks;\n  return Array.isArray(tasks) ? (tasks as HistoryTask[]) : [];\n}\n\n/**\n * Phase 1 (preferred): map a `task` tool-call id directly to its\n * execution namespace via the task's result `ToolMessage`. Unambiguous\n * — works even when a step mixes subagent and non-subagent tool calls.\n *\n * The subgraph checkpoint_ns is `task.name + \":\" + task.id` (mirrors\n * pregel's `taskCheckpointNamespace`), so we derive it from name+id\n * rather than the always-null completed-task checkpoint.\n */\nexport function collectDirectTaskMappings(\n  tasks: HistoryTask[],\n  targets: Set<string>,\n  out: Map<string, string>\n): void {\n  for (const task of tasks) {\n    if (\n      !Array.isArray(task.path) ||\n      task.path[0] !== \"__pregel_push\" ||\n      typeof task.id !== \"string\" ||\n      typeof task.name !== \"string\"\n    ) {\n      continue;\n    }\n    const resultMessages = task.result?.messages;\n    if (!Array.isArray(resultMessages)) continue;\n    for (const msg of resultMessages) {\n      const m = msg as Record<string, unknown>;\n      const id = m.tool_call_id;\n      if (\n        m.type === \"tool\" &&\n        typeof id === \"string\" &&\n        targets.has(id) &&\n        !out.has(id)\n      ) {\n        out.set(id, `${task.name}:${task.id}`);\n      }\n    }\n  }\n}\n\n/**\n * Phase 2 (fallback): align still-pending push tasks to the triggering\n * AI message's tool calls by Send index (`path[1]`), where `path[1]`\n * indexes into the *full* `tool_calls` array. Only push tasks whose\n * targeted call is a subagent `task` are mapped, so a sibling\n * non-subagent tool call in the same message can't capture a subagent's\n * namespace. Applied only to ids Phase 1 could not resolve so a correct\n * direct mapping is never overwritten by a positional guess.\n */\nexport function collectPositionalTaskMappings(\n  checkpoint: AnyCheckpoint,\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  const pushTasks = getTasks(checkpoint).filter(\n    (t) =>\n      Array.isArray(t.path) &&\n      t.path[0] === \"__pregel_push\" &&\n      typeof t.path[1] === \"number\" &&\n      typeof t.id === \"string\" &&\n      typeof t.name === \"string\"\n  );\n  if (pushTasks.length === 0) return;\n\n  const msgs = (checkpoint.values as Record<string, unknown> | undefined)?.[\n    messagesKey\n  ];\n  if (!Array.isArray(msgs)) return;\n\n  let toolCalls: Array<{ id?: string; name?: string }> | undefined;\n  for (let i = msgs.length - 1; i >= 0; i -= 1) {\n    const m = msgs[i] as Record<string, unknown>;\n    if (m.type !== \"ai\") continue;\n    const normalized = normalizeAIMessageToolCalls(\n      m as unknown as Parameters<typeof normalizeAIMessageToolCalls>[0]\n    ) as Record<string, unknown>;\n    const normalizedToolCalls = normalized.tool_calls;\n    if (\n      Array.isArray(normalizedToolCalls) &&\n      (normalizedToolCalls as Array<{ name?: string }>).some(\n        (tc) => tc.name === \"task\"\n      )\n    ) {\n      toolCalls = normalizedToolCalls as Array<{\n        id?: string;\n        name?: string;\n      }>;\n      break;\n    }\n  }\n  if (toolCalls == null) return;\n\n  // `path[1]` is the Send index into the *full* `tool_calls` array, not the\n  // subagent-only subset. Resolve each push task against that array and map\n  // it only when the targeted call is itself a `task`, so a sibling\n  // non-subagent tool call cannot capture a subagent's namespace.\n  for (const task of pushTasks) {\n    const index = (task.path as unknown[])[1] as number;\n    const tc = toolCalls[index];\n    if (\n      tc?.name === \"task\" &&\n      tc.id != null &&\n      typeof task.id === \"string\" &&\n      typeof task.name === \"string\" &&\n      targets.has(tc.id) &&\n      !out.has(tc.id)\n    ) {\n      out.set(tc.id, `${task.name}:${task.id}`);\n    }\n  }\n}\n\n/** Build a `getHistory` `before` cursor from a history entry. */\nfunction beforeCursor(entry: AnyCheckpoint): Config | undefined {\n  const checkpointId = entry.checkpoint?.checkpoint_id;\n  if (typeof checkpointId !== \"string\") return undefined;\n  return { configurable: { checkpoint_id: checkpointId } };\n}\n\nfunction applyCollectors(\n  history: AnyCheckpoint[],\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  for (const checkpoint of history) {\n    collectDirectTaskMappings(getTasks(checkpoint), targets, out);\n  }\n  const stillUnmapped = () => [...targets].some((id) => !out.has(id));\n  if (stillUnmapped()) {\n    for (const checkpoint of history) {\n      if (!stillUnmapped()) break;\n      collectPositionalTaskMappings(checkpoint, targets, out, messagesKey);\n    }\n  }\n}\n\n/**\n * Synchronous subagent namespace mapping over an already-fetched\n * history page. Used by {@link resolveSubagentNamespaces} and by the\n * controller's hydrate-time bulk seed (which shares a single\n * `getHistory` page with subgraph host detection).\n */\nexport function mapSubagentNamespaces(\n  history: AnyCheckpoint[],\n  toolCallIds: string[],\n  messagesKey = DEFAULT_MESSAGES_KEY\n): Map<string, string> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n  applyCollectors(history, targets, out, messagesKey);\n  return out;\n}\n\n/**\n * Resolve execution namespaces for the given subagent `task` tool-call\n * ids from checkpoint history.\n *\n * Bounded and O(1) in calls: one `getHistory` page, plus at most one\n * `before`-cursor fallback page when the first leaves ids unresolved.\n * Never fans out per id.\n *\n * @returns Map of `toolCallId` → single execution namespace segment\n *   (e.g. `tools:<uuid>`). Unresolved ids are omitted.\n */\nexport async function resolveSubagentNamespaces<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  toolCallIds: string[],\n  opts?: { limit?: number; messagesKey?: string; signal?: AbortSignal }\n): Promise<Map<string, string>> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n\n  const limit = opts?.limit ?? 20;\n  const messagesKey = opts?.messagesKey ?? DEFAULT_MESSAGES_KEY;\n  const signal = opts?.signal;\n\n  const page1 = await getHistoryPage(client, threadId, { limit, signal });\n  applyCollectors(page1, targets, out, messagesKey);\n\n  const unresolved = [...targets].filter((id) => !out.has(id));\n  if (unresolved.length > 0 && page1.length > 0) {\n    const before = beforeCursor(page1[page1.length - 1]);\n    if (before != null) {\n      const page2 = await getHistoryPage(client, threadId, {\n        limit,\n        before,\n        signal,\n      });\n      applyCollectors(page2, targets, out, messagesKey);\n    }\n  }\n\n  return out;\n}\n\n/**\n * Fetch one bounded history page typed as plain records, sidestepping\n * the client's `TStateType` generic so the discovery collectors (which\n * read raw `values`/`tasks`) get a stable {@link AnyCheckpoint} shape.\n */\nexport function getHistoryPage<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  options: {\n    limit?: number;\n    before?: Config;\n    checkpoint?: Partial<Omit<Checkpoint, \"thread_id\">>;\n    metadata?: Metadata;\n    signal?: AbortSignal;\n  }\n): Promise<AnyCheckpoint[]> {\n  return client.threads.getHistory<Record<string, unknown>>(threadId, options);\n}\n\nexport interface SubgraphHost {\n  namespace: string[];\n  status: \"running\" | \"complete\" | \"error\";\n}\n\nfunction checkpointNsToSegments(checkpointNs: unknown): string[] {\n  if (typeof checkpointNs !== \"string\" || checkpointNs.length === 0) return [];\n  return checkpointNs.split(\"|\").filter((segment) => segment.length > 0);\n}\n\nfunction isInternalSegment(segment: string): boolean {\n  return segment.startsWith(\"tools:\") || segment.startsWith(\"task:\");\n}\n\n/**\n * Identify subgraph host namespaces from checkpoint history, mirroring the\n * promotion rule of the live {@link ./subgraphs} `SubgraphDiscovery`: a\n * namespace is a host iff it is a *strict ancestor* of a deeper namespace,\n * and inner function-node leaves are never promoted on their own.\n *\n * Two host signals are derived from the checkpoint namespaces observed in\n * history (`state` + `task` `checkpoint_ns`):\n *\n *  - **Interior hosts** — every strict ancestor of an observed namespace.\n *    Each segment of a nested `checkpoint_ns` wraps a deeper one, so the\n *    parent is always a subgraph (this also recovers a host whose own\n *    checkpoint fell outside the fetched page).\n *  - **Top-level hosts** — every depth-1 observed namespace. A top-level\n *    subgraph is always a host, including the values-only shape supported\n *    by `SubgraphDiscovery.#onValuesEvent`, where the host (e.g.\n *    `research:<uuid>`) appears with no deeper `research:<uuid>|...` key.\n *    The old strict-prefix rule dropped those, so reconnecting waited for\n *    SSE replay instead of hydrating the card immediately.\n *\n * A *deeper* observed namespace's own deepest segment is NOT promoted\n * unless it is itself an ancestor of something deeper — otherwise a plain\n * inner node (e.g. `worker:<uuid>|inner:<uuid>`) would surface as a\n * spurious subgraph card that was never present during live streaming.\n *\n * Tool/subagent namespaces (`tools:` / `task:`) are excluded — those are\n * owned by {@link ./subagents}. A namespace nested under a subgraph (e.g.\n * `research:<uuid>|tools:<uuid>`) still promotes its non-internal\n * `research:<uuid>` ancestor.\n */\nexport function collectSubgraphHostNamespaces(\n  history: AnyCheckpoint[]\n): SubgraphHost[] {\n  // Directly observed namespace tuples (state + task checkpoint_ns), with\n  // NO prefix synthesis — host promotion is derived below so that a deeper\n  // namespace's leaf segment is not mistaken for a host.\n  const observed = new Map<string, string[]>();\n  const record = (segments: string[]) => {\n    if (segments.length === 0) return;\n    observed.set(namespaceKey(segments), segments);\n  };\n  for (const state of history) {\n    record(checkpointNsToSegments(state.checkpoint?.checkpoint_ns));\n    for (const task of getTasks(state)) {\n      record(checkpointNsToSegments(task.checkpoint?.checkpoint_ns));\n    }\n  }\n\n  // Pending namespaces of the newest checkpoint → still running.\n  const pending = new Set<string>();\n  if (history.length > 0) {\n    for (const task of getTasks(history[0])) {\n      const segments = checkpointNsToSegments(task.checkpoint?.checkpoint_ns);\n      if (segments.length > 0) pending.add(namespaceKey(segments));\n    }\n  }\n\n  // Host candidates = strict ancestors of observed (interior) + depth-1\n  // observed (top-level). Insertion order: shallow ancestors first so the\n  // emitted host list keeps parents ahead of children.\n  const candidates = new Map<string, string[]>();\n  for (const segments of observed.values()) {\n    for (let depth = 1; depth < segments.length; depth += 1) {\n      const slice = segments.slice(0, depth);\n      candidates.set(namespaceKey(slice), slice);\n    }\n    if (segments.length === 1) {\n      candidates.set(namespaceKey(segments), segments);\n    }\n  }\n\n  const hosts: SubgraphHost[] = [];\n  for (const [key, segments] of candidates) {\n    if (segments.some(isInternalSegment)) continue;\n    const prefix = key + NAMESPACE_SEPARATOR;\n    const running =\n      pending.has(key) || [...pending].some((p) => p.startsWith(prefix));\n    hosts.push({\n      namespace: segments,\n      status: running ? \"running\" : \"complete\",\n    });\n  }\n  return hosts;\n}\n"],"mappings":"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"}
+{"version":3,"file":"namespace-from-history.js","names":[],"sources":["../../../src/stream/discovery/namespace-from-history.ts"],"sourcesContent":["/**\n * Reconstruct discovery namespaces from checkpoint history.\n *\n * On reconnect the always-on SSE replay eventually re-derives every\n * subagent execution namespace and every subgraph host, but that costs\n * a full depth-1 replay. This module derives the same information from\n * a single bounded `getHistory()` read so the controller can promote\n * namespaces immediately on `hydrate()` (subgraph hosts + subagent\n * execution namespaces) and lazily for a single opened subagent.\n *\n * The logic mirrors the live discovery state machines so a\n * history-derived namespace and an SSE-derived one cannot disagree:\n *  - subagent mapping ports {@link ../../ui/manager} `fetchSubagentHistory`\n *    (direct task-result mapping, then positional Send-index fallback);\n *  - subgraph host detection ports the strict-prefix promotion rule in\n *    {@link ./subgraphs}.\n */\nimport type { Client } from \"../../client/index.js\";\nimport type {\n  Checkpoint,\n  Config,\n  Metadata,\n  ThreadState,\n} from \"../../schema.js\";\nimport { NAMESPACE_SEPARATOR, DEFAULT_MESSAGES_KEY } from \"../constants.js\";\nimport { namespaceKey } from \"../namespace.js\";\nimport { normalizeAIMessageToolCalls } from \"../message-coercion.js\";\n\ntype AnyCheckpoint = ThreadState<Record<string, unknown>>;\n\ninterface HistoryTask {\n  id?: unknown;\n  name?: unknown;\n  path?: unknown;\n  result?: { messages?: unknown[] };\n  checkpoint?: { checkpoint_ns?: unknown } | null;\n}\n\nfunction getTasks(checkpoint: AnyCheckpoint): HistoryTask[] {\n  const tasks = (checkpoint as { tasks?: unknown }).tasks;\n  return Array.isArray(tasks) ? (tasks as HistoryTask[]) : [];\n}\n\n/**\n * Phase 1 (preferred): map a `task` tool-call id directly to its\n * execution namespace via the task's result `ToolMessage`. Unambiguous\n * — works even when a step mixes subagent and non-subagent tool calls.\n *\n * The subgraph checkpoint_ns is `task.name + \":\" + task.id` (mirrors\n * pregel's `taskCheckpointNamespace`), so we derive it from name+id\n * rather than the always-null completed-task checkpoint.\n */\nexport function collectDirectTaskMappings(\n  tasks: HistoryTask[],\n  targets: Set<string>,\n  out: Map<string, string>\n): void {\n  for (const task of tasks) {\n    if (\n      !Array.isArray(task.path) ||\n      task.path[0] !== \"__pregel_push\" ||\n      typeof task.id !== \"string\" ||\n      typeof task.name !== \"string\"\n    ) {\n      continue;\n    }\n    const resultMessages = task.result?.messages;\n    if (!Array.isArray(resultMessages)) continue;\n    for (const msg of resultMessages) {\n      const m = msg as Record<string, unknown>;\n      const id = m.tool_call_id;\n      if (\n        m.type === \"tool\" &&\n        typeof id === \"string\" &&\n        targets.has(id) &&\n        !out.has(id)\n      ) {\n        out.set(id, `${task.name}:${task.id}`);\n      }\n    }\n  }\n}\n\n/**\n * Phase 2 (fallback): align still-pending push tasks to the triggering\n * AI message's tool calls by Send index (`path[1]`), where `path[1]`\n * indexes into the *full* `tool_calls` array. Only push tasks whose\n * targeted call is a subagent `task` are mapped, so a sibling\n * non-subagent tool call in the same message can't capture a subagent's\n * namespace. Applied only to ids Phase 1 could not resolve so a correct\n * direct mapping is never overwritten by a positional guess.\n */\nexport function collectPositionalTaskMappings(\n  checkpoint: AnyCheckpoint,\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  const pushTasks = getTasks(checkpoint).filter(\n    (t) =>\n      Array.isArray(t.path) &&\n      t.path[0] === \"__pregel_push\" &&\n      typeof t.path[1] === \"number\" &&\n      // Send tasks are `[PUSH, i]` (legacy JS servers) or `[PUSH, i, false]`\n      // (aligned with Python); longer paths are error handlers of failed\n      // Sends (`[PUSH, i, false, \"node_error_handler\", false]`) and must not\n      // be mistaken for a second Send at the same index.\n      t.path.length <= 3 &&\n      typeof t.id === \"string\" &&\n      typeof t.name === \"string\"\n  );\n  if (pushTasks.length === 0) return;\n\n  const msgs = (checkpoint.values as Record<string, unknown> | undefined)?.[\n    messagesKey\n  ];\n  if (!Array.isArray(msgs)) return;\n\n  let toolCalls: Array<{ id?: string; name?: string }> | undefined;\n  for (let i = msgs.length - 1; i >= 0; i -= 1) {\n    const m = msgs[i] as Record<string, unknown>;\n    if (m.type !== \"ai\") continue;\n    const normalized = normalizeAIMessageToolCalls(\n      m as unknown as Parameters<typeof normalizeAIMessageToolCalls>[0]\n    ) as Record<string, unknown>;\n    const normalizedToolCalls = normalized.tool_calls;\n    if (\n      Array.isArray(normalizedToolCalls) &&\n      (normalizedToolCalls as Array<{ name?: string }>).some(\n        (tc) => tc.name === \"task\"\n      )\n    ) {\n      toolCalls = normalizedToolCalls as Array<{\n        id?: string;\n        name?: string;\n      }>;\n      break;\n    }\n  }\n  if (toolCalls == null) return;\n\n  // `path[1]` is the Send index into the *full* `tool_calls` array, not the\n  // subagent-only subset. Resolve each push task against that array and map\n  // it only when the targeted call is itself a `task`, so a sibling\n  // non-subagent tool call cannot capture a subagent's namespace.\n  for (const task of pushTasks) {\n    const index = (task.path as unknown[])[1] as number;\n    const tc = toolCalls[index];\n    if (\n      tc?.name === \"task\" &&\n      tc.id != null &&\n      typeof task.id === \"string\" &&\n      typeof task.name === \"string\" &&\n      targets.has(tc.id) &&\n      !out.has(tc.id)\n    ) {\n      out.set(tc.id, `${task.name}:${task.id}`);\n    }\n  }\n}\n\n/** Build a `getHistory` `before` cursor from a history entry. */\nfunction beforeCursor(entry: AnyCheckpoint): Config | undefined {\n  const checkpointId = entry.checkpoint?.checkpoint_id;\n  if (typeof checkpointId !== \"string\") return undefined;\n  return { configurable: { checkpoint_id: checkpointId } };\n}\n\nfunction applyCollectors(\n  history: AnyCheckpoint[],\n  targets: Set<string>,\n  out: Map<string, string>,\n  messagesKey: string\n): void {\n  for (const checkpoint of history) {\n    collectDirectTaskMappings(getTasks(checkpoint), targets, out);\n  }\n  const stillUnmapped = () => [...targets].some((id) => !out.has(id));\n  if (stillUnmapped()) {\n    for (const checkpoint of history) {\n      if (!stillUnmapped()) break;\n      collectPositionalTaskMappings(checkpoint, targets, out, messagesKey);\n    }\n  }\n}\n\n/**\n * Synchronous subagent namespace mapping over an already-fetched\n * history page. Used by {@link resolveSubagentNamespaces} and by the\n * controller's hydrate-time bulk seed (which shares a single\n * `getHistory` page with subgraph host detection).\n */\nexport function mapSubagentNamespaces(\n  history: AnyCheckpoint[],\n  toolCallIds: string[],\n  messagesKey = DEFAULT_MESSAGES_KEY\n): Map<string, string> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n  applyCollectors(history, targets, out, messagesKey);\n  return out;\n}\n\n/**\n * Resolve execution namespaces for the given subagent `task` tool-call\n * ids from checkpoint history.\n *\n * Bounded and O(1) in calls: one `getHistory` page, plus at most one\n * `before`-cursor fallback page when the first leaves ids unresolved.\n * Never fans out per id.\n *\n * @returns Map of `toolCallId` → single execution namespace segment\n *   (e.g. `tools:<uuid>`). Unresolved ids are omitted.\n */\nexport async function resolveSubagentNamespaces<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  toolCallIds: string[],\n  opts?: { limit?: number; messagesKey?: string; signal?: AbortSignal }\n): Promise<Map<string, string>> {\n  const out = new Map<string, string>();\n  const targets = new Set(toolCallIds);\n  if (targets.size === 0) return out;\n\n  const limit = opts?.limit ?? 20;\n  const messagesKey = opts?.messagesKey ?? DEFAULT_MESSAGES_KEY;\n  const signal = opts?.signal;\n\n  const page1 = await getHistoryPage(client, threadId, { limit, signal });\n  applyCollectors(page1, targets, out, messagesKey);\n\n  const unresolved = [...targets].filter((id) => !out.has(id));\n  if (unresolved.length > 0 && page1.length > 0) {\n    const before = beforeCursor(page1[page1.length - 1]);\n    if (before != null) {\n      const page2 = await getHistoryPage(client, threadId, {\n        limit,\n        before,\n        signal,\n      });\n      applyCollectors(page2, targets, out, messagesKey);\n    }\n  }\n\n  return out;\n}\n\n/**\n * Fetch one bounded history page typed as plain records, sidestepping\n * the client's `TStateType` generic so the discovery collectors (which\n * read raw `values`/`tasks`) get a stable {@link AnyCheckpoint} shape.\n */\nexport function getHistoryPage<TStateType>(\n  client: Client<TStateType>,\n  threadId: string,\n  options: {\n    limit?: number;\n    before?: Config;\n    checkpoint?: Partial<Omit<Checkpoint, \"thread_id\">>;\n    metadata?: Metadata;\n    signal?: AbortSignal;\n  }\n): Promise<AnyCheckpoint[]> {\n  return client.threads.getHistory<Record<string, unknown>>(threadId, options);\n}\n\nexport interface SubgraphHost {\n  namespace: string[];\n  status: \"running\" | \"complete\" | \"error\";\n}\n\nfunction checkpointNsToSegments(checkpointNs: unknown): string[] {\n  if (typeof checkpointNs !== \"string\" || checkpointNs.length === 0) return [];\n  return checkpointNs.split(\"|\").filter((segment) => segment.length > 0);\n}\n\nfunction isInternalSegment(segment: string): boolean {\n  return segment.startsWith(\"tools:\") || segment.startsWith(\"task:\");\n}\n\n/**\n * Identify subgraph host namespaces from checkpoint history, mirroring the\n * promotion rule of the live {@link ./subgraphs} `SubgraphDiscovery`: a\n * namespace is a host iff it is a *strict ancestor* of a deeper namespace,\n * and inner function-node leaves are never promoted on their own.\n *\n * Two host signals are derived from the checkpoint namespaces observed in\n * history (`state` + `task` `checkpoint_ns`):\n *\n *  - **Interior hosts** — every strict ancestor of an observed namespace.\n *    Each segment of a nested `checkpoint_ns` wraps a deeper one, so the\n *    parent is always a subgraph (this also recovers a host whose own\n *    checkpoint fell outside the fetched page).\n *  - **Top-level hosts** — every depth-1 observed namespace. A top-level\n *    subgraph is always a host, including the values-only shape supported\n *    by `SubgraphDiscovery.#onValuesEvent`, where the host (e.g.\n *    `research:<uuid>`) appears with no deeper `research:<uuid>|...` key.\n *    The old strict-prefix rule dropped those, so reconnecting waited for\n *    SSE replay instead of hydrating the card immediately.\n *\n * A *deeper* observed namespace's own deepest segment is NOT promoted\n * unless it is itself an ancestor of something deeper — otherwise a plain\n * inner node (e.g. `worker:<uuid>|inner:<uuid>`) would surface as a\n * spurious subgraph card that was never present during live streaming.\n *\n * Tool/subagent namespaces (`tools:` / `task:`) are excluded — those are\n * owned by {@link ./subagents}. A namespace nested under a subgraph (e.g.\n * `research:<uuid>|tools:<uuid>`) still promotes its non-internal\n * `research:<uuid>` ancestor.\n */\nexport function collectSubgraphHostNamespaces(\n  history: AnyCheckpoint[]\n): SubgraphHost[] {\n  // Directly observed namespace tuples (state + task checkpoint_ns), with\n  // NO prefix synthesis — host promotion is derived below so that a deeper\n  // namespace's leaf segment is not mistaken for a host.\n  const observed = new Map<string, string[]>();\n  const record = (segments: string[]) => {\n    if (segments.length === 0) return;\n    observed.set(namespaceKey(segments), segments);\n  };\n  for (const state of history) {\n    record(checkpointNsToSegments(state.checkpoint?.checkpoint_ns));\n    for (const task of getTasks(state)) {\n      record(checkpointNsToSegments(task.checkpoint?.checkpoint_ns));\n    }\n  }\n\n  // Pending namespaces of the newest checkpoint → still running.\n  const pending = new Set<string>();\n  if (history.length > 0) {\n    for (const task of getTasks(history[0])) {\n      const segments = checkpointNsToSegments(task.checkpoint?.checkpoint_ns);\n      if (segments.length > 0) pending.add(namespaceKey(segments));\n    }\n  }\n\n  // Host candidates = strict ancestors of observed (interior) + depth-1\n  // observed (top-level). Insertion order: shallow ancestors first so the\n  // emitted host list keeps parents ahead of children.\n  const candidates = new Map<string, string[]>();\n  for (const segments of observed.values()) {\n    for (let depth = 1; depth < segments.length; depth += 1) {\n      const slice = segments.slice(0, depth);\n      candidates.set(namespaceKey(slice), slice);\n    }\n    if (segments.length === 1) {\n      candidates.set(namespaceKey(segments), segments);\n    }\n  }\n\n  const hosts: SubgraphHost[] = [];\n  for (const [key, segments] of candidates) {\n    if (segments.some(isInternalSegment)) continue;\n    const prefix = key + NAMESPACE_SEPARATOR;\n    const running =\n      pending.has(key) || [...pending].some((p) => p.startsWith(prefix));\n    hosts.push({\n      namespace: segments,\n      status: running ? \"running\" : \"complete\",\n    });\n  }\n  return hosts;\n}\n"],"mappings":"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"}

package/dist/stream/lifecycle-loading-tracker.cjs

@@ -28,17 +28,21 @@ var LifecycleLoadingTracker = class {
 	#lastRunningLifecycleSeq = -1;
 	/** Notified once `isLoading` actually settles to `false` on a terminal event. */
 	#onSettled;
+	#ignore;
 	/**
 	* @param params.store      - Store whose `isLoading` slot we drive.
 	* @param params.isDisposed - Disposal probe consulted from deferred callbacks.
 	* @param params.onSettled  - Called once `isLoading` flips to `false`,
 	*   including for a run this client only observed and never
 	*   dispatched itself.
+	* @param params.ignore     - Lifecycle events to skip, e.g. another run's
+	*   replayed terminal while this client's own run is in flight.
 	*/
 	constructor(params) {
 		this.#store = params.store;
 		this.#isDisposed = params.isDisposed;
 		this.#onSettled = params.onSettled;
+		this.#ignore = params.ignore;
 	}
 	/**
 	* Bound listener suitable for `EventBus.subscribe`. Re-exposed as a
@@ -69,6 +73,7 @@ var LifecycleLoadingTracker = class {
 	handle(event) {
 		if (event.method !== "lifecycle") return;
 		if (!require_namespace.isRootNamespace(event.params.namespace)) return;
+		if (this.#ignore?.(event)) return;
 		const lifecycle = event.params.data;
 		const seq = typeof event.seq === "number" ? event.seq : void 0;
 		if (lifecycle?.event === "running") {

package/dist/stream/lifecycle-loading-tracker.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-loading-tracker.cjs","names":["#store","#isDisposed","#onSettled","#lastTerminalLifecycleSeq","#lastRunningLifecycleSeq","isRootNamespace"],"sources":["../../src/stream/lifecycle-loading-tracker.ts"],"sourcesContent":["/**\n * Drives the {@link RootSnapshot.isLoading} flag from root lifecycle\n * events.\n *\n * # What it does\n *\n * The tracker watches a stream of protocol events and flips the\n * `isLoading` slot of a {@link StreamStore} based on root-namespace\n * `lifecycle` payloads:\n *\n *   - `running`                       → `isLoading = true`\n *   - `completed` / `failed` / `interrupted`\n *                                     → `isLoading = false`\n *\n * Non-root, non-lifecycle, and unknown events are ignored.\n *\n * # Why it lives in its own class\n *\n * Lifecycle handling has two subtleties that we want to keep out of\n * the {@link StreamController}'s critical path:\n *\n *   1. **Stale `running` filtering.** SSE replays older events on\n *      reconnect — including a `running` lifecycle that fired before\n *      the run terminated. Without filtering, that replay would flip\n *      `isLoading` back to `true` after a `completed` already brought\n *      it down. We track the highest terminal `seq` we've seen and\n *      drop any `running` whose `seq` is at or below it.\n *   2. **Deferred terminal flip.** The flip from `true → false` is\n *      pushed to the next macrotask (`setTimeout(..., 0)`). This\n *      gives synchronous consumers — most notably `for await`\n *      iterators in framework bindings — one event-loop tick to\n *      observe terminal-related state (e.g. the final assistant\n *      message landing in `values`) before `isLoading` settles.\n *      The deferred callback re-checks whether a newer `running`\n *      arrived in the meantime (HITL interrupt → resume, or SSE\n *      history replay of interrupted → running) and bails if so,\n *      so a stale terminal reset cannot stomp an active run.\n *\n * # Why it's safe to register the listener as `controller.onEvent`\n *\n * The tracker subscribes to the controller's root event bus via the\n * exported {@link listener} arrow. Because the listener is bound at\n * construction time, removing it later (`bus.delete(tracker.listener)`)\n * works without `bind()` gymnastics in the controller.\n *\n * @typeParam T - The snapshot shape; must contain an `isLoading` flag.\n */\nimport type { Event, LifecycleEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"./store.js\";\nimport { isRootNamespace } from \"./namespace.js\";\n\n/**\n * Minimal contract the snapshot must satisfy. The tracker only\n * touches `isLoading`, leaving everything else for the controller.\n */\ntype LoadingSnapshot = { readonly isLoading: boolean };\n\n/**\n * Drives root-snapshot `isLoading` from root lifecycle events.\n */\nexport class LifecycleLoadingTracker<T extends LoadingSnapshot> {\n  /** Snapshot store whose `isLoading` slot we manage. */\n  readonly #store: StreamStore<T>;\n\n  /**\n   * Disposal probe. Consulted from the deferred `setTimeout` so a\n   * controller torn down between scheduling and firing doesn't end\n   * up writing to a defunct store.\n   */\n  readonly #isDisposed: () => boolean;\n\n  /**\n   * Highest sequence number of a terminal lifecycle we've observed.\n   * `running` events at or below this seq are stale replays and\n   * are dropped to avoid flipping the loading flag back on after the\n   * run has already ended.\n   */\n  #lastTerminalLifecycleSeq = -1;\n\n  /**\n   * Highest sequence number of a `running` lifecycle we've observed.\n   * Deferred terminal resets compare against this so an\n   * `interrupted`/`completed`/`failed` whose macrotask fires after a\n   * newer `running` does not incorrectly clear `isLoading`.\n   */\n  #lastRunningLifecycleSeq = -1;\n\n  /** Notified once `isLoading` actually settles to `false` on a terminal event. */\n  readonly #onSettled: (() => void) | undefined;\n\n  /**\n   * @param params.store      - Store whose `isLoading` slot we drive.\n   * @param params.isDisposed - Disposal probe consulted from deferred callbacks.\n   * @param params.onSettled  - Called once `isLoading` flips to `false`,\n   *   including for a run this client only observed and never\n   *   dispatched itself.\n   */\n  constructor(params: {\n    store: StreamStore<T>;\n    isDisposed: () => boolean;\n    onSettled?: () => void;\n  }) {\n    this.#store = params.store;\n    this.#isDisposed = params.isDisposed;\n    this.#onSettled = params.onSettled;\n  }\n\n  /**\n   * Bound listener suitable for `EventBus.subscribe`. Re-exposed as a\n   * stable property so the controller can later remove the same\n   * function reference from the bus on teardown.\n   */\n  readonly listener = (event: Event): void => {\n    this.handle(event);\n  };\n\n  /**\n   * Reset internal state when rebinding to a new thread.\n   *\n   * The seq guards are per-thread: a new thread's lifecycle events\n   * are not stale relative to the old thread's.\n   */\n  reset(): void {\n    this.#lastTerminalLifecycleSeq = -1;\n    this.#lastRunningLifecycleSeq = -1;\n  }\n\n  /**\n   * Process a single protocol event.\n   *\n   * Filters down to root-namespace lifecycle events, then mutates the\n   * store's `isLoading` slot. All other events are ignored.\n   *\n   * @param event - Any protocol event from the controller's root bus.\n   */\n  handle(event: Event): void {\n    if (event.method !== \"lifecycle\") return;\n    if (!isRootNamespace(event.params.namespace)) return;\n    const lifecycle = (event as LifecycleEvent).params.data as {\n      event?: string;\n    };\n    const seq = typeof event.seq === \"number\" ? event.seq : undefined;\n    if (lifecycle?.event === \"running\") {\n      // Drop stale `running` replays that arrive *after* a terminal\n      // for the same run. SSE re-streams history on reconnect; without\n      // this filter the loading flag would oscillate.\n      if (seq != null && seq <= this.#lastTerminalLifecycleSeq) {\n        return;\n      }\n      if (seq != null) {\n        this.#lastRunningLifecycleSeq = Math.max(\n          this.#lastRunningLifecycleSeq,\n          seq\n        );\n      }\n      this.#store.setState((s) =>\n        s.isLoading ? s : { ...s, isLoading: true }\n      );\n      return;\n    }\n    if (\n      lifecycle?.event === \"completed\" ||\n      lifecycle?.event === \"failed\" ||\n      lifecycle?.event === \"interrupted\"\n    ) {\n      if (seq != null) {\n        this.#lastTerminalLifecycleSeq = Math.max(\n          this.#lastTerminalLifecycleSeq,\n          seq\n        );\n      }\n      // Flip `isLoading=false` on the next macrotask so synchronous\n      // consumers iterating events get one tick to observe terminal\n      // state (the final values snapshot etc.) before the loading\n      // indicator drops. Bail if a newer `running` arrived since this\n      // terminal was scheduled (answered HITL interrupt, back-to-back\n      // runs, or history replay of interrupted → running).\n      setTimeout(() => {\n        if (this.#isDisposed()) return;\n        if (seq != null && this.#lastRunningLifecycleSeq > seq) return;\n        const wasLoading = this.#store.getSnapshot().isLoading;\n        this.#store.setState((s) =>\n          s.isLoading ? { ...s, isLoading: false } : s\n        );\n        if (wasLoading) this.#onSettled?.();\n      }, 0);\n    }\n  }\n}\n"],"mappings":";;;;;AA4DA,IAAa,0BAAb,MAAgE;;CAE9D;;;;;;CAOA;;;;;;;CAQA,4BAA4B;;;;;;;CAQ5B,2BAA2B;;CAG3B;;;;;;;;CASA,YAAY,QAIT;AACD,QAAA,QAAc,OAAO;AACrB,QAAA,aAAmB,OAAO;AAC1B,QAAA,YAAkB,OAAO;;;;;;;CAQ3B,YAAqB,UAAuB;AAC1C,OAAK,OAAO,MAAM;;;;;;;;CASpB,QAAc;AACZ,QAAA,2BAAiC;AACjC,QAAA,0BAAgC;;;;;;;;;;CAWlC,OAAO,OAAoB;AACzB,MAAI,MAAM,WAAW,YAAa;AAClC,MAAI,CAACK,kBAAAA,gBAAgB,MAAM,OAAO,UAAU,CAAE;EAC9C,MAAM,YAAa,MAAyB,OAAO;EAGnD,MAAM,MAAM,OAAO,MAAM,QAAQ,WAAW,MAAM,MAAM,KAAA;AACxD,MAAI,WAAW,UAAU,WAAW;AAIlC,OAAI,OAAO,QAAQ,OAAO,MAAA,yBACxB;AAEF,OAAI,OAAO,KACT,OAAA,0BAAgC,KAAK,IACnC,MAAA,yBACA,IACD;AAEH,SAAA,MAAY,UAAU,MACpB,EAAE,YAAY,IAAI;IAAE,GAAG;IAAG,WAAW;IAAM,CAC5C;AACD;;AAEF,MACE,WAAW,UAAU,eACrB,WAAW,UAAU,YACrB,WAAW,UAAU,eACrB;AACA,OAAI,OAAO,KACT,OAAA,2BAAiC,KAAK,IACpC,MAAA,0BACA,IACD;AAQH,oBAAiB;AACf,QAAI,MAAA,YAAkB,CAAE;AACxB,QAAI,OAAO,QAAQ,MAAA,0BAAgC,IAAK;IACxD,MAAM,aAAa,MAAA,MAAY,aAAa,CAAC;AAC7C,UAAA,MAAY,UAAU,MACpB,EAAE,YAAY;KAAE,GAAG;KAAG,WAAW;KAAO,GAAG,EAC5C;AACD,QAAI,WAAY,OAAA,aAAmB;MAClC,EAAE"}
+{"version":3,"file":"lifecycle-loading-tracker.cjs","names":["#store","#isDisposed","#onSettled","#ignore","#lastTerminalLifecycleSeq","#lastRunningLifecycleSeq","isRootNamespace"],"sources":["../../src/stream/lifecycle-loading-tracker.ts"],"sourcesContent":["/**\n * Drives the {@link RootSnapshot.isLoading} flag from root lifecycle\n * events.\n *\n * # What it does\n *\n * The tracker watches a stream of protocol events and flips the\n * `isLoading` slot of a {@link StreamStore} based on root-namespace\n * `lifecycle` payloads:\n *\n *   - `running`                       → `isLoading = true`\n *   - `completed` / `failed` / `interrupted`\n *                                     → `isLoading = false`\n *\n * Non-root, non-lifecycle, and unknown events are ignored.\n *\n * # Why it lives in its own class\n *\n * Lifecycle handling has two subtleties that we want to keep out of\n * the {@link StreamController}'s critical path:\n *\n *   1. **Stale `running` filtering.** SSE replays older events on\n *      reconnect — including a `running` lifecycle that fired before\n *      the run terminated. Without filtering, that replay would flip\n *      `isLoading` back to `true` after a `completed` already brought\n *      it down. We track the highest terminal `seq` we've seen and\n *      drop any `running` whose `seq` is at or below it.\n *   2. **Deferred terminal flip.** The flip from `true → false` is\n *      pushed to the next macrotask (`setTimeout(..., 0)`). This\n *      gives synchronous consumers — most notably `for await`\n *      iterators in framework bindings — one event-loop tick to\n *      observe terminal-related state (e.g. the final assistant\n *      message landing in `values`) before `isLoading` settles.\n *      The deferred callback re-checks whether a newer `running`\n *      arrived in the meantime (HITL interrupt → resume, or SSE\n *      history replay of interrupted → running) and bails if so,\n *      so a stale terminal reset cannot stomp an active run.\n *\n * # Why it's safe to register the listener as `controller.onEvent`\n *\n * The tracker subscribes to the controller's root event bus via the\n * exported {@link listener} arrow. Because the listener is bound at\n * construction time, removing it later (`bus.delete(tracker.listener)`)\n * works without `bind()` gymnastics in the controller.\n *\n * @typeParam T - The snapshot shape; must contain an `isLoading` flag.\n */\nimport type { Event, LifecycleEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"./store.js\";\nimport { isRootNamespace } from \"./namespace.js\";\n\n/**\n * Minimal contract the snapshot must satisfy. The tracker only\n * touches `isLoading`, leaving everything else for the controller.\n */\ntype LoadingSnapshot = { readonly isLoading: boolean };\n\n/**\n * Drives root-snapshot `isLoading` from root lifecycle events.\n */\nexport class LifecycleLoadingTracker<T extends LoadingSnapshot> {\n  /** Snapshot store whose `isLoading` slot we manage. */\n  readonly #store: StreamStore<T>;\n\n  /**\n   * Disposal probe. Consulted from the deferred `setTimeout` so a\n   * controller torn down between scheduling and firing doesn't end\n   * up writing to a defunct store.\n   */\n  readonly #isDisposed: () => boolean;\n\n  /**\n   * Highest sequence number of a terminal lifecycle we've observed.\n   * `running` events at or below this seq are stale replays and\n   * are dropped to avoid flipping the loading flag back on after the\n   * run has already ended.\n   */\n  #lastTerminalLifecycleSeq = -1;\n\n  /**\n   * Highest sequence number of a `running` lifecycle we've observed.\n   * Deferred terminal resets compare against this so an\n   * `interrupted`/`completed`/`failed` whose macrotask fires after a\n   * newer `running` does not incorrectly clear `isLoading`.\n   */\n  #lastRunningLifecycleSeq = -1;\n\n  /** Notified once `isLoading` actually settles to `false` on a terminal event. */\n  readonly #onSettled: (() => void) | undefined;\n\n  readonly #ignore: ((event: Event) => boolean) | undefined;\n\n  /**\n   * @param params.store      - Store whose `isLoading` slot we drive.\n   * @param params.isDisposed - Disposal probe consulted from deferred callbacks.\n   * @param params.onSettled  - Called once `isLoading` flips to `false`,\n   *   including for a run this client only observed and never\n   *   dispatched itself.\n   * @param params.ignore     - Lifecycle events to skip, e.g. another run's\n   *   replayed terminal while this client's own run is in flight.\n   */\n  constructor(params: {\n    store: StreamStore<T>;\n    isDisposed: () => boolean;\n    onSettled?: () => void;\n    ignore?: (event: Event) => boolean;\n  }) {\n    this.#store = params.store;\n    this.#isDisposed = params.isDisposed;\n    this.#onSettled = params.onSettled;\n    this.#ignore = params.ignore;\n  }\n\n  /**\n   * Bound listener suitable for `EventBus.subscribe`. Re-exposed as a\n   * stable property so the controller can later remove the same\n   * function reference from the bus on teardown.\n   */\n  readonly listener = (event: Event): void => {\n    this.handle(event);\n  };\n\n  /**\n   * Reset internal state when rebinding to a new thread.\n   *\n   * The seq guards are per-thread: a new thread's lifecycle events\n   * are not stale relative to the old thread's.\n   */\n  reset(): void {\n    this.#lastTerminalLifecycleSeq = -1;\n    this.#lastRunningLifecycleSeq = -1;\n  }\n\n  /**\n   * Process a single protocol event.\n   *\n   * Filters down to root-namespace lifecycle events, then mutates the\n   * store's `isLoading` slot. All other events are ignored.\n   *\n   * @param event - Any protocol event from the controller's root bus.\n   */\n  handle(event: Event): void {\n    if (event.method !== \"lifecycle\") return;\n    if (!isRootNamespace(event.params.namespace)) return;\n    if (this.#ignore?.(event)) return;\n    const lifecycle = (event as LifecycleEvent).params.data as {\n      event?: string;\n    };\n    const seq = typeof event.seq === \"number\" ? event.seq : undefined;\n    if (lifecycle?.event === \"running\") {\n      // Drop stale `running` replays that arrive *after* a terminal\n      // for the same run. SSE re-streams history on reconnect; without\n      // this filter the loading flag would oscillate.\n      if (seq != null && seq <= this.#lastTerminalLifecycleSeq) {\n        return;\n      }\n      if (seq != null) {\n        this.#lastRunningLifecycleSeq = Math.max(\n          this.#lastRunningLifecycleSeq,\n          seq\n        );\n      }\n      this.#store.setState((s) =>\n        s.isLoading ? s : { ...s, isLoading: true }\n      );\n      return;\n    }\n    if (\n      lifecycle?.event === \"completed\" ||\n      lifecycle?.event === \"failed\" ||\n      lifecycle?.event === \"interrupted\"\n    ) {\n      if (seq != null) {\n        this.#lastTerminalLifecycleSeq = Math.max(\n          this.#lastTerminalLifecycleSeq,\n          seq\n        );\n      }\n      // Flip `isLoading=false` on the next macrotask so synchronous\n      // consumers iterating events get one tick to observe terminal\n      // state (the final values snapshot etc.) before the loading\n      // indicator drops. Bail if a newer `running` arrived since this\n      // terminal was scheduled (answered HITL interrupt, back-to-back\n      // runs, or history replay of interrupted → running).\n      setTimeout(() => {\n        if (this.#isDisposed()) return;\n        if (seq != null && this.#lastRunningLifecycleSeq > seq) return;\n        const wasLoading = this.#store.getSnapshot().isLoading;\n        this.#store.setState((s) =>\n          s.isLoading ? { ...s, isLoading: false } : s\n        );\n        if (wasLoading) this.#onSettled?.();\n      }, 0);\n    }\n  }\n}\n"],"mappings":";;;;;AA4DA,IAAa,0BAAb,MAAgE;;CAE9D;;;;;;CAOA;;;;;;;CAQA,4BAA4B;;;;;;;CAQ5B,2BAA2B;;CAG3B;CAEA;;;;;;;;;;CAWA,YAAY,QAKT;AACD,QAAA,QAAc,OAAO;AACrB,QAAA,aAAmB,OAAO;AAC1B,QAAA,YAAkB,OAAO;AACzB,QAAA,SAAe,OAAO;;;;;;;CAQxB,YAAqB,UAAuB;AAC1C,OAAK,OAAO,MAAM;;;;;;;;CASpB,QAAc;AACZ,QAAA,2BAAiC;AACjC,QAAA,0BAAgC;;;;;;;;;;CAWlC,OAAO,OAAoB;AACzB,MAAI,MAAM,WAAW,YAAa;AAClC,MAAI,CAACM,kBAAAA,gBAAgB,MAAM,OAAO,UAAU,CAAE;AAC9C,MAAI,MAAA,SAAe,MAAM,CAAE;EAC3B,MAAM,YAAa,MAAyB,OAAO;EAGnD,MAAM,MAAM,OAAO,MAAM,QAAQ,WAAW,MAAM,MAAM,KAAA;AACxD,MAAI,WAAW,UAAU,WAAW;AAIlC,OAAI,OAAO,QAAQ,OAAO,MAAA,yBACxB;AAEF,OAAI,OAAO,KACT,OAAA,0BAAgC,KAAK,IACnC,MAAA,yBACA,IACD;AAEH,SAAA,MAAY,UAAU,MACpB,EAAE,YAAY,IAAI;IAAE,GAAG;IAAG,WAAW;IAAM,CAC5C;AACD;;AAEF,MACE,WAAW,UAAU,eACrB,WAAW,UAAU,YACrB,WAAW,UAAU,eACrB;AACA,OAAI,OAAO,KACT,OAAA,2BAAiC,KAAK,IACpC,MAAA,0BACA,IACD;AAQH,oBAAiB;AACf,QAAI,MAAA,YAAkB,CAAE;AACxB,QAAI,OAAO,QAAQ,MAAA,0BAAgC,IAAK;IACxD,MAAM,aAAa,MAAA,MAAY,aAAa,CAAC;AAC7C,UAAA,MAAY,UAAU,MACpB,EAAE,YAAY;KAAE,GAAG;KAAG,WAAW;KAAO,GAAG,EAC5C;AACD,QAAI,WAAY,OAAA,aAAmB;MAClC,EAAE"}

package/dist/stream/lifecycle-loading-tracker.js

@@ -28,17 +28,21 @@ var LifecycleLoadingTracker = class {
 	#lastRunningLifecycleSeq = -1;
 	/** Notified once `isLoading` actually settles to `false` on a terminal event. */
 	#onSettled;
+	#ignore;
 	/**
 	* @param params.store      - Store whose `isLoading` slot we drive.
 	* @param params.isDisposed - Disposal probe consulted from deferred callbacks.
 	* @param params.onSettled  - Called once `isLoading` flips to `false`,
 	*   including for a run this client only observed and never
 	*   dispatched itself.
+	* @param params.ignore     - Lifecycle events to skip, e.g. another run's
+	*   replayed terminal while this client's own run is in flight.
 	*/
 	constructor(params) {
 		this.#store = params.store;
 		this.#isDisposed = params.isDisposed;
 		this.#onSettled = params.onSettled;
+		this.#ignore = params.ignore;
 	}
 	/**
 	* Bound listener suitable for `EventBus.subscribe`. Re-exposed as a
@@ -69,6 +73,7 @@ var LifecycleLoadingTracker = class {
 	handle(event) {
 		if (event.method !== "lifecycle") return;
 		if (!isRootNamespace(event.params.namespace)) return;
+		if (this.#ignore?.(event)) return;
 		const lifecycle = event.params.data;
 		const seq = typeof event.seq === "number" ? event.seq : void 0;
 		if (lifecycle?.event === "running") {

package/dist/stream/lifecycle-loading-tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-loading-tracker.js","names":["#store","#isDisposed","#onSettled","#lastTerminalLifecycleSeq","#lastRunningLifecycleSeq"],"sources":["../../src/stream/lifecycle-loading-tracker.ts"],"sourcesContent":["/**\n * Drives the {@link RootSnapshot.isLoading} flag from root lifecycle\n * events.\n *\n * # What it does\n *\n * The tracker watches a stream of protocol events and flips the\n * `isLoading` slot of a {@link StreamStore} based on root-namespace\n * `lifecycle` payloads:\n *\n *   - `running`                       → `isLoading = true`\n *   - `completed` / `failed` / `interrupted`\n *                                     → `isLoading = false`\n *\n * Non-root, non-lifecycle, and unknown events are ignored.\n *\n * # Why it lives in its own class\n *\n * Lifecycle handling has two subtleties that we want to keep out of\n * the {@link StreamController}'s critical path:\n *\n *   1. **Stale `running` filtering.** SSE replays older events on\n *      reconnect — including a `running` lifecycle that fired before\n *      the run terminated. Without filtering, that replay would flip\n *      `isLoading` back to `true` after a `completed` already brought\n *      it down. We track the highest terminal `seq` we've seen and\n *      drop any `running` whose `seq` is at or below it.\n *   2. **Deferred terminal flip.** The flip from `true → false` is\n *      pushed to the next macrotask (`setTimeout(..., 0)`). This\n *      gives synchronous consumers — most notably `for await`\n *      iterators in framework bindings — one event-loop tick to\n *      observe terminal-related state (e.g. the final assistant\n *      message landing in `values`) before `isLoading` settles.\n *      The deferred callback re-checks whether a newer `running`\n *      arrived in the meantime (HITL interrupt → resume, or SSE\n *      history replay of interrupted → running) and bails if so,\n *      so a stale terminal reset cannot stomp an active run.\n *\n * # Why it's safe to register the listener as `controller.onEvent`\n *\n * The tracker subscribes to the controller's root event bus via the\n * exported {@link listener} arrow. Because the listener is bound at\n * construction time, removing it later (`bus.delete(tracker.listener)`)\n * works without `bind()` gymnastics in the controller.\n *\n * @typeParam T - The snapshot shape; must contain an `isLoading` flag.\n */\nimport type { Event, LifecycleEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"./store.js\";\nimport { isRootNamespace } from \"./namespace.js\";\n\n/**\n * Minimal contract the snapshot must satisfy. The tracker only\n * touches `isLoading`, leaving everything else for the controller.\n */\ntype LoadingSnapshot = { readonly isLoading: boolean };\n\n/**\n * Drives root-snapshot `isLoading` from root lifecycle events.\n */\nexport class LifecycleLoadingTracker<T extends LoadingSnapshot> {\n  /** Snapshot store whose `isLoading` slot we manage. */\n  readonly #store: StreamStore<T>;\n\n  /**\n   * Disposal probe. Consulted from the deferred `setTimeout` so a\n   * controller torn down between scheduling and firing doesn't end\n   * up writing to a defunct store.\n   */\n  readonly #isDisposed: () => boolean;\n\n  /**\n   * Highest sequence number of a terminal lifecycle we've observed.\n   * `running` events at or below this seq are stale replays and\n   * are dropped to avoid flipping the loading flag back on after the\n   * run has already ended.\n   */\n  #lastTerminalLifecycleSeq = -1;\n\n  /**\n   * Highest sequence number of a `running` lifecycle we've observed.\n   * Deferred terminal resets compare against this so an\n   * `interrupted`/`completed`/`failed` whose macrotask fires after a\n   * newer `running` does not incorrectly clear `isLoading`.\n   */\n  #lastRunningLifecycleSeq = -1;\n\n  /** Notified once `isLoading` actually settles to `false` on a terminal event. */\n  readonly #onSettled: (() => void) | undefined;\n\n  /**\n   * @param params.store      - Store whose `isLoading` slot we drive.\n   * @param params.isDisposed - Disposal probe consulted from deferred callbacks.\n   * @param params.onSettled  - Called once `isLoading` flips to `false`,\n   *   including for a run this client only observed and never\n   *   dispatched itself.\n   */\n  constructor(params: {\n    store: StreamStore<T>;\n    isDisposed: () => boolean;\n    onSettled?: () => void;\n  }) {\n    this.#store = params.store;\n    this.#isDisposed = params.isDisposed;\n    this.#onSettled = params.onSettled;\n  }\n\n  /**\n   * Bound listener suitable for `EventBus.subscribe`. Re-exposed as a\n   * stable property so the controller can later remove the same\n   * function reference from the bus on teardown.\n   */\n  readonly listener = (event: Event): void => {\n    this.handle(event);\n  };\n\n  /**\n   * Reset internal state when rebinding to a new thread.\n   *\n   * The seq guards are per-thread: a new thread's lifecycle events\n   * are not stale relative to the old thread's.\n   */\n  reset(): void {\n    this.#lastTerminalLifecycleSeq = -1;\n    this.#lastRunningLifecycleSeq = -1;\n  }\n\n  /**\n   * Process a single protocol event.\n   *\n   * Filters down to root-namespace lifecycle events, then mutates the\n   * store's `isLoading` slot. All other events are ignored.\n   *\n   * @param event - Any protocol event from the controller's root bus.\n   */\n  handle(event: Event): void {\n    if (event.method !== \"lifecycle\") return;\n    if (!isRootNamespace(event.params.namespace)) return;\n    const lifecycle = (event as LifecycleEvent).params.data as {\n      event?: string;\n    };\n    const seq = typeof event.seq === \"number\" ? event.seq : undefined;\n    if (lifecycle?.event === \"running\") {\n      // Drop stale `running` replays that arrive *after* a terminal\n      // for the same run. SSE re-streams history on reconnect; without\n      // this filter the loading flag would oscillate.\n      if (seq != null && seq <= this.#lastTerminalLifecycleSeq) {\n        return;\n      }\n      if (seq != null) {\n        this.#lastRunningLifecycleSeq = Math.max(\n          this.#lastRunningLifecycleSeq,\n          seq\n        );\n      }\n      this.#store.setState((s) =>\n        s.isLoading ? s : { ...s, isLoading: true }\n      );\n      return;\n    }\n    if (\n      lifecycle?.event === \"completed\" ||\n      lifecycle?.event === \"failed\" ||\n      lifecycle?.event === \"interrupted\"\n    ) {\n      if (seq != null) {\n        this.#lastTerminalLifecycleSeq = Math.max(\n          this.#lastTerminalLifecycleSeq,\n          seq\n        );\n      }\n      // Flip `isLoading=false` on the next macrotask so synchronous\n      // consumers iterating events get one tick to observe terminal\n      // state (the final values snapshot etc.) before the loading\n      // indicator drops. Bail if a newer `running` arrived since this\n      // terminal was scheduled (answered HITL interrupt, back-to-back\n      // runs, or history replay of interrupted → running).\n      setTimeout(() => {\n        if (this.#isDisposed()) return;\n        if (seq != null && this.#lastRunningLifecycleSeq > seq) return;\n        const wasLoading = this.#store.getSnapshot().isLoading;\n        this.#store.setState((s) =>\n          s.isLoading ? { ...s, isLoading: false } : s\n        );\n        if (wasLoading) this.#onSettled?.();\n      }, 0);\n    }\n  }\n}\n"],"mappings":";;;;;AA4DA,IAAa,0BAAb,MAAgE;;CAE9D;;;;;;CAOA;;;;;;;CAQA,4BAA4B;;;;;;;CAQ5B,2BAA2B;;CAG3B;;;;;;;;CASA,YAAY,QAIT;AACD,QAAA,QAAc,OAAO;AACrB,QAAA,aAAmB,OAAO;AAC1B,QAAA,YAAkB,OAAO;;;;;;;CAQ3B,YAAqB,UAAuB;AAC1C,OAAK,OAAO,MAAM;;;;;;;;CASpB,QAAc;AACZ,QAAA,2BAAiC;AACjC,QAAA,0BAAgC;;;;;;;;;;CAWlC,OAAO,OAAoB;AACzB,MAAI,MAAM,WAAW,YAAa;AAClC,MAAI,CAAC,gBAAgB,MAAM,OAAO,UAAU,CAAE;EAC9C,MAAM,YAAa,MAAyB,OAAO;EAGnD,MAAM,MAAM,OAAO,MAAM,QAAQ,WAAW,MAAM,MAAM,KAAA;AACxD,MAAI,WAAW,UAAU,WAAW;AAIlC,OAAI,OAAO,QAAQ,OAAO,MAAA,yBACxB;AAEF,OAAI,OAAO,KACT,OAAA,0BAAgC,KAAK,IACnC,MAAA,yBACA,IACD;AAEH,SAAA,MAAY,UAAU,MACpB,EAAE,YAAY,IAAI;IAAE,GAAG;IAAG,WAAW;IAAM,CAC5C;AACD;;AAEF,MACE,WAAW,UAAU,eACrB,WAAW,UAAU,YACrB,WAAW,UAAU,eACrB;AACA,OAAI,OAAO,KACT,OAAA,2BAAiC,KAAK,IACpC,MAAA,0BACA,IACD;AAQH,oBAAiB;AACf,QAAI,MAAA,YAAkB,CAAE;AACxB,QAAI,OAAO,QAAQ,MAAA,0BAAgC,IAAK;IACxD,MAAM,aAAa,MAAA,MAAY,aAAa,CAAC;AAC7C,UAAA,MAAY,UAAU,MACpB,EAAE,YAAY;KAAE,GAAG;KAAG,WAAW;KAAO,GAAG,EAC5C;AACD,QAAI,WAAY,OAAA,aAAmB;MAClC,EAAE"}
+{"version":3,"file":"lifecycle-loading-tracker.js","names":["#store","#isDisposed","#onSettled","#ignore","#lastTerminalLifecycleSeq","#lastRunningLifecycleSeq"],"sources":["../../src/stream/lifecycle-loading-tracker.ts"],"sourcesContent":["/**\n * Drives the {@link RootSnapshot.isLoading} flag from root lifecycle\n * events.\n *\n * # What it does\n *\n * The tracker watches a stream of protocol events and flips the\n * `isLoading` slot of a {@link StreamStore} based on root-namespace\n * `lifecycle` payloads:\n *\n *   - `running`                       → `isLoading = true`\n *   - `completed` / `failed` / `interrupted`\n *                                     → `isLoading = false`\n *\n * Non-root, non-lifecycle, and unknown events are ignored.\n *\n * # Why it lives in its own class\n *\n * Lifecycle handling has two subtleties that we want to keep out of\n * the {@link StreamController}'s critical path:\n *\n *   1. **Stale `running` filtering.** SSE replays older events on\n *      reconnect — including a `running` lifecycle that fired before\n *      the run terminated. Without filtering, that replay would flip\n *      `isLoading` back to `true` after a `completed` already brought\n *      it down. We track the highest terminal `seq` we've seen and\n *      drop any `running` whose `seq` is at or below it.\n *   2. **Deferred terminal flip.** The flip from `true → false` is\n *      pushed to the next macrotask (`setTimeout(..., 0)`). This\n *      gives synchronous consumers — most notably `for await`\n *      iterators in framework bindings — one event-loop tick to\n *      observe terminal-related state (e.g. the final assistant\n *      message landing in `values`) before `isLoading` settles.\n *      The deferred callback re-checks whether a newer `running`\n *      arrived in the meantime (HITL interrupt → resume, or SSE\n *      history replay of interrupted → running) and bails if so,\n *      so a stale terminal reset cannot stomp an active run.\n *\n * # Why it's safe to register the listener as `controller.onEvent`\n *\n * The tracker subscribes to the controller's root event bus via the\n * exported {@link listener} arrow. Because the listener is bound at\n * construction time, removing it later (`bus.delete(tracker.listener)`)\n * works without `bind()` gymnastics in the controller.\n *\n * @typeParam T - The snapshot shape; must contain an `isLoading` flag.\n */\nimport type { Event, LifecycleEvent } from \"@langchain/protocol\";\nimport { StreamStore } from \"./store.js\";\nimport { isRootNamespace } from \"./namespace.js\";\n\n/**\n * Minimal contract the snapshot must satisfy. The tracker only\n * touches `isLoading`, leaving everything else for the controller.\n */\ntype LoadingSnapshot = { readonly isLoading: boolean };\n\n/**\n * Drives root-snapshot `isLoading` from root lifecycle events.\n */\nexport class LifecycleLoadingTracker<T extends LoadingSnapshot> {\n  /** Snapshot store whose `isLoading` slot we manage. */\n  readonly #store: StreamStore<T>;\n\n  /**\n   * Disposal probe. Consulted from the deferred `setTimeout` so a\n   * controller torn down between scheduling and firing doesn't end\n   * up writing to a defunct store.\n   */\n  readonly #isDisposed: () => boolean;\n\n  /**\n   * Highest sequence number of a terminal lifecycle we've observed.\n   * `running` events at or below this seq are stale replays and\n   * are dropped to avoid flipping the loading flag back on after the\n   * run has already ended.\n   */\n  #lastTerminalLifecycleSeq = -1;\n\n  /**\n   * Highest sequence number of a `running` lifecycle we've observed.\n   * Deferred terminal resets compare against this so an\n   * `interrupted`/`completed`/`failed` whose macrotask fires after a\n   * newer `running` does not incorrectly clear `isLoading`.\n   */\n  #lastRunningLifecycleSeq = -1;\n\n  /** Notified once `isLoading` actually settles to `false` on a terminal event. */\n  readonly #onSettled: (() => void) | undefined;\n\n  readonly #ignore: ((event: Event) => boolean) | undefined;\n\n  /**\n   * @param params.store      - Store whose `isLoading` slot we drive.\n   * @param params.isDisposed - Disposal probe consulted from deferred callbacks.\n   * @param params.onSettled  - Called once `isLoading` flips to `false`,\n   *   including for a run this client only observed and never\n   *   dispatched itself.\n   * @param params.ignore     - Lifecycle events to skip, e.g. another run's\n   *   replayed terminal while this client's own run is in flight.\n   */\n  constructor(params: {\n    store: StreamStore<T>;\n    isDisposed: () => boolean;\n    onSettled?: () => void;\n    ignore?: (event: Event) => boolean;\n  }) {\n    this.#store = params.store;\n    this.#isDisposed = params.isDisposed;\n    this.#onSettled = params.onSettled;\n    this.#ignore = params.ignore;\n  }\n\n  /**\n   * Bound listener suitable for `EventBus.subscribe`. Re-exposed as a\n   * stable property so the controller can later remove the same\n   * function reference from the bus on teardown.\n   */\n  readonly listener = (event: Event): void => {\n    this.handle(event);\n  };\n\n  /**\n   * Reset internal state when rebinding to a new thread.\n   *\n   * The seq guards are per-thread: a new thread's lifecycle events\n   * are not stale relative to the old thread's.\n   */\n  reset(): void {\n    this.#lastTerminalLifecycleSeq = -1;\n    this.#lastRunningLifecycleSeq = -1;\n  }\n\n  /**\n   * Process a single protocol event.\n   *\n   * Filters down to root-namespace lifecycle events, then mutates the\n   * store's `isLoading` slot. All other events are ignored.\n   *\n   * @param event - Any protocol event from the controller's root bus.\n   */\n  handle(event: Event): void {\n    if (event.method !== \"lifecycle\") return;\n    if (!isRootNamespace(event.params.namespace)) return;\n    if (this.#ignore?.(event)) return;\n    const lifecycle = (event as LifecycleEvent).params.data as {\n      event?: string;\n    };\n    const seq = typeof event.seq === \"number\" ? event.seq : undefined;\n    if (lifecycle?.event === \"running\") {\n      // Drop stale `running` replays that arrive *after* a terminal\n      // for the same run. SSE re-streams history on reconnect; without\n      // this filter the loading flag would oscillate.\n      if (seq != null && seq <= this.#lastTerminalLifecycleSeq) {\n        return;\n      }\n      if (seq != null) {\n        this.#lastRunningLifecycleSeq = Math.max(\n          this.#lastRunningLifecycleSeq,\n          seq\n        );\n      }\n      this.#store.setState((s) =>\n        s.isLoading ? s : { ...s, isLoading: true }\n      );\n      return;\n    }\n    if (\n      lifecycle?.event === \"completed\" ||\n      lifecycle?.event === \"failed\" ||\n      lifecycle?.event === \"interrupted\"\n    ) {\n      if (seq != null) {\n        this.#lastTerminalLifecycleSeq = Math.max(\n          this.#lastTerminalLifecycleSeq,\n          seq\n        );\n      }\n      // Flip `isLoading=false` on the next macrotask so synchronous\n      // consumers iterating events get one tick to observe terminal\n      // state (the final values snapshot etc.) before the loading\n      // indicator drops. Bail if a newer `running` arrived since this\n      // terminal was scheduled (answered HITL interrupt, back-to-back\n      // runs, or history replay of interrupted → running).\n      setTimeout(() => {\n        if (this.#isDisposed()) return;\n        if (seq != null && this.#lastRunningLifecycleSeq > seq) return;\n        const wasLoading = this.#store.getSnapshot().isLoading;\n        this.#store.setState((s) =>\n          s.isLoading ? { ...s, isLoading: false } : s\n        );\n        if (wasLoading) this.#onSettled?.();\n      }, 0);\n    }\n  }\n}\n"],"mappings":";;;;;AA4DA,IAAa,0BAAb,MAAgE;;CAE9D;;;;;;CAOA;;;;;;;CAQA,4BAA4B;;;;;;;CAQ5B,2BAA2B;;CAG3B;CAEA;;;;;;;;;;CAWA,YAAY,QAKT;AACD,QAAA,QAAc,OAAO;AACrB,QAAA,aAAmB,OAAO;AAC1B,QAAA,YAAkB,OAAO;AACzB,QAAA,SAAe,OAAO;;;;;;;CAQxB,YAAqB,UAAuB;AAC1C,OAAK,OAAO,MAAM;;;;;;;;CASpB,QAAc;AACZ,QAAA,2BAAiC;AACjC,QAAA,0BAAgC;;;;;;;;;;CAWlC,OAAO,OAAoB;AACzB,MAAI,MAAM,WAAW,YAAa;AAClC,MAAI,CAAC,gBAAgB,MAAM,OAAO,UAAU,CAAE;AAC9C,MAAI,MAAA,SAAe,MAAM,CAAE;EAC3B,MAAM,YAAa,MAAyB,OAAO;EAGnD,MAAM,MAAM,OAAO,MAAM,QAAQ,WAAW,MAAM,MAAM,KAAA;AACxD,MAAI,WAAW,UAAU,WAAW;AAIlC,OAAI,OAAO,QAAQ,OAAO,MAAA,yBACxB;AAEF,OAAI,OAAO,KACT,OAAA,0BAAgC,KAAK,IACnC,MAAA,yBACA,IACD;AAEH,SAAA,MAAY,UAAU,MACpB,EAAE,YAAY,IAAI;IAAE,GAAG;IAAG,WAAW;IAAM,CAC5C;AACD;;AAEF,MACE,WAAW,UAAU,eACrB,WAAW,UAAU,YACrB,WAAW,UAAU,eACrB;AACA,OAAI,OAAO,KACT,OAAA,2BAAiC,KAAK,IACpC,MAAA,0BACA,IACD;AAQH,oBAAiB;AACf,QAAI,MAAA,YAAkB,CAAE;AACxB,QAAI,OAAO,QAAQ,MAAA,0BAAgC,IAAK;IACxD,MAAM,aAAa,MAAA,MAAY,aAAa,CAAC;AAC7C,UAAA,MAAY,UAAU,MACpB,EAAE,YAAY;KAAE,GAAG;KAAG,WAAW;KAAO,GAAG,EAC5C;AACD,QAAI,WAAY,OAAA,aAAmB;MAClC,EAAE"}

package/dist/stream/projections/messages.cjs

@@ -17,16 +17,10 @@ function messagesProjection(namespace) {
 			const indexById = /* @__PURE__ */ new Map();
 			const streamMessageIds = /* @__PURE__ */ new Set();
 			let valuesMessageIds = /* @__PURE__ */ new Set();
-			if (require_namespace.isRootNamespace(ns) && rootBus.channels.includes("messages")) {
-				const unsubscribe = rootBus.subscribe((event) => {
-					if (event.method !== "messages") return;
-					if (!require_namespace.isRootNamespace(event.params.namespace)) return;
-					applyEvent(event);
-				});
-				return { dispose() {
-					unsubscribe();
-				} };
-			}
+			const uncommittedIds = /* @__PURE__ */ new Set();
+			const finishedIds = /* @__PURE__ */ new Set();
+			const droppedIds = /* @__PURE__ */ new Set();
+			const rootShortCircuit = require_namespace.isRootNamespace(ns) && rootBus.channels.includes("messages");
 			let disposed = false;
 			const pendingMessages = [];
 			let dirty = false;
@@ -60,6 +54,10 @@ function messagesProjection(namespace) {
 					preferValuesMessage: require_message_reconciliation.shouldPreferValuesMessage
 				});
 				valuesMessageIds = reconciliation.valueMessageIds;
+				for (const id of valuesMessageIds) {
+					uncommittedIds.delete(id);
+					finishedIds.delete(id);
+				}
 				const reconciledMessages = [...reconciliation.messages];
 				pendingMessages.length = 0;
 				for (const message of reconciledMessages) pendingMessages.push(message);
@@ -83,7 +81,9 @@ function messagesProjection(namespace) {
 				if (update == null) return;
 				const msg = update.message;
 				const id = msg.id;
-				if (id == null) return;
+				if (id == null || droppedIds.has(id)) return;
+				if (!valuesMessageIds.has(id)) uncommittedIds.add(id);
+				if (update.kind === "message-finish") finishedIds.add(id);
 				const captured = roleByKey.get(id) ?? { role: "ai" };
 				const base = require_assembled_to_message.assembledMessageToBaseMessage(msg, captured.role, { toolCallId: captured.toolCallId });
 				streamMessageIds.add(id);
@@ -94,6 +94,33 @@ function messagesProjection(namespace) {
 				} else pendingMessages[existingIdx] = base;
 				scheduleFlush();
 			};
+			const closeRun = (unfinishedOnly) => {
+				assembler.abandonActive();
+				const dropped = /* @__PURE__ */ new Set();
+				for (const id of uncommittedIds) {
+					if (unfinishedOnly && finishedIds.has(id)) continue;
+					dropped.add(id);
+				}
+				if (dropped.size === 0) return;
+				for (const id of dropped) {
+					uncommittedIds.delete(id);
+					finishedIds.delete(id);
+					droppedIds.add(id);
+				}
+				const kept = pendingMessages.filter((m) => m.id == null || !dropped.has(m.id));
+				pendingMessages.length = 0;
+				pendingMessages.push(...kept);
+				indexById.clear();
+				for (const [id, idx] of require_message_reconciliation.buildMessageIndex(pendingMessages)) indexById.set(id, idx);
+				scheduleFlush();
+			};
+			const unsubscribeLifecycle = rootBus.subscribe((event) => {
+				if (event.method !== "lifecycle") return;
+				if (!require_namespace.isRootNamespace(event.params.namespace)) return;
+				const lifecycle = event.params.data?.event;
+				if (lifecycle === "running") setTimeout(() => !disposed && closeRun(false), 0);
+				else if (lifecycle === "completed" || lifecycle === "interrupted" || lifecycle === "failed") setTimeout(() => !disposed && closeRun(true), 0);
+			});
 			let runtime;
 			const openSubscription = () => {
 				runtime = require_runtime.openProjectionSubscription({
@@ -106,7 +133,12 @@ function messagesProjection(namespace) {
 					}
 				});
 			};
-			(async () => {
+			if (rootShortCircuit) runtime = { dispose: rootBus.subscribe((event) => {
+				if (!require_namespace.isRootNamespace(event.params.namespace)) return;
+				if (event.method === "messages") applyEvent(event);
+				else if (event.method === "values") applyValuesEvent(event);
+			}) };
+			else (async () => {
 				if (!(await rootBus.trySeedFromHistory?.({
 					kind: "messages",
 					namespace: ns,
@@ -115,6 +147,7 @@ function messagesProjection(namespace) {
 			})();
 			return { async dispose() {
 				disposed = true;
+				unsubscribeLifecycle();
 				if (flushChannel != null) {
 					flushChannel.port1.onmessage = null;
 					flushChannel.port1.close();

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

@@ -1 +1 @@
-{"version":3,"file":"messages.cjs","names":["namespaceKey","MessageAssembler","isRootNamespace","reconcileMessagesFromValues","ensureMessageInstances","shouldPreferValuesMessage","buildMessageIndex","assembledMessageToBaseMessage","openProjectionSubscription"],"sources":["../../../src/stream/projections/messages.ts"],"sourcesContent":["/**\n * Namespace-scoped `messages` projection.\n *\n * Opens `thread.subscribe({ channels: [\"messages\"], namespaces: [ns] })`\n * and folds each `messages` event through {@link MessageAssembler}.\n * Every update — start, block delta, block finish, message finish —\n * re-derives a `BaseMessage` class instance for the currently-active\n * message and updates its slot in the store.\n *\n * The projection emits `BaseMessage[]` (class instances from\n * `@langchain/core/messages`), never plain serialized objects.\n */\nimport type {\n  MessagesEvent,\n  MessageRole,\n  MessageStartData,\n  ValuesEvent,\n} from \"@langchain/protocol\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport { MessageAssembler } from \"../../client/stream/messages.js\";\nimport {\n  assembledMessageToBaseMessage,\n  type ExtendedMessageRole,\n} from \"../assembled-to-message.js\";\nimport type { Message } from \"../../types.messages.js\";\nimport type { ProjectionSpec, ProjectionRuntime } from \"../types.js\";\nimport { ensureMessageInstances } from \"../message-coercion.js\";\nimport { isRootNamespace, namespaceKey } from \"../namespace.js\";\nimport {\n  buildMessageIndex,\n  reconcileMessagesFromValues,\n  shouldPreferValuesMessage,\n} from \"../message-reconciliation.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\nexport function messagesProjection(\n  namespace: readonly string[]\n): ProjectionSpec<BaseMessage[]> {\n  const ns = [...namespace];\n  const key = `messages|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: [],\n    open({ thread, store, rootBus }): ProjectionRuntime {\n      const assembler = new MessageAssembler();\n      // Per-messageId state needed for BaseMessage projection:\n      //  - `role` is only in the `message-start` event; we cache it\n      //    so subsequent delta events still produce a typed message.\n      //  - `toolCallId` is pulled from message-start extras when role\n      //    is `tool` (a convention we keep compatible with serialized\n      //    v1 tool messages).\n      const roleByKey = new Map<\n        string,\n        { role: ExtendedMessageRole; toolCallId?: string }\n      >();\n      const indexById = new Map<string, number>();\n      // Ids this projection has observed via the `messages` channel\n      // (token-level deltas). Used by `applyValuesEvent` to prefer the\n      // stream-assembled version over the values-coerced shape while a\n      // turn is streaming, matching the root controller's policy.\n      const streamMessageIds = new Set<string>();\n      // Ids observed in the most recent `values.messages` snapshot.\n      // Messages that were present in a prior snapshot but are absent\n      // from this one are treated as explicit removals (server-side\n      // `RemoveMessage` reducer deltas). Stream-only messages (seen on\n      // the messages channel but never echoed in a values snapshot)\n      // are preserved — their enclosing superstep may simply not have\n      // committed yet.\n      let valuesMessageIds = new Set<string>();\n\n      // Root-scoped projections whose channels are already covered by\n      // the controller's root pump attach to the shared fan-out\n      // instead of opening a second server subscription. The root\n      // pump runs at `{namespaces: [[]], depth: 1}`, which is exactly\n      // the scope a root-namespace `messagesProjection` wants.\n      const rootShortCircuit =\n        isRootNamespace(ns) && rootBus.channels.includes(\"messages\");\n\n      if (rootShortCircuit) {\n        const unsubscribe = rootBus.subscribe((event) => {\n          if (event.method !== \"messages\") return;\n          if (!isRootNamespace(event.params.namespace)) return;\n          applyEvent(event as MessagesEvent);\n        });\n        return {\n          dispose() {\n            unsubscribe();\n          },\n        };\n      }\n\n      let disposed = false;\n\n      // Local mirror of the store contents. Every `applyEvent` /\n      // `applyValuesEvent` mutates this synchronously; a coalesced\n      // `scheduleFlush` copies it to `store` once per macrotask.\n      //\n      // Why the indirection? When a namespace-scoped projection\n      // (e.g. a subagent modal opened after the run finished) first\n      // subscribes, the server replays the entire history from\n      // `seq=0`. Dozens of `messages`-channel events can land in a\n      // single SSE parse — they drain through the `for await` loop\n      // as a long microtask chain. Microtasks run before any\n      // macrotask, so React's concurrent scheduler never gets a\n      // chance to commit between updates. Calling `store.setValue`\n      // per event in that burst overflows React's\n      // `nestedUpdateCount` guard and throws \"Maximum update depth\n      // exceeded\", permanently killing the projection and\n      // leaving the store stuck at its first few messages.\n      //\n      // Batching via `MessageChannel` (macrotask) coalesces the\n      // replay burst into one `setValue` call and lets React\n      // commit between flushes for live token streaming too.\n      const pendingMessages: BaseMessage[] = [];\n      let dirty = false;\n      let flushScheduled = false;\n      const flushChannel =\n        typeof MessageChannel !== \"undefined\" ? new MessageChannel() : null;\n\n      const flush = (): void => {\n        flushScheduled = false;\n        if (!dirty || disposed) return;\n        dirty = false;\n        // `.slice()` breaks identity so React's `Object.is` bail-out\n        // in `StreamStore.setValue` propagates the change.\n        store.setValue(pendingMessages.slice());\n      };\n      if (flushChannel != null) {\n        flushChannel.port1.onmessage = flush;\n      }\n\n      const scheduleFlush = (): void => {\n        dirty = true;\n        if (flushScheduled) return;\n        flushScheduled = true;\n        if (flushChannel != null) {\n          flushChannel.port2.postMessage(null);\n        } else {\n          setTimeout(flush, 0);\n        }\n      };\n\n      // Rebuild the store from `values.messages` snapshots.\n      //\n      // `values` events carry the full, committed state of the\n      // thread's `messages` channel at a checkpoint — they fire\n      // on node completion, AFTER every `messages`-channel delta\n      // for that turn has been emitted. They are the authoritative\n      // source of truth for ORDER and for non-streamed messages\n      // (human turns, serialised tool results, subagent echoes, …).\n      //\n      // Why rebuild rather than merge-by-id?\n      //\n      // In practice the server may emit the same logical message\n      // with DIFFERENT ids across successive `values` snapshots at\n      // the same namespace — e.g. a subagent first surfaces its\n      // seed prompt with a synthetic id like\n      // `subagent:<tool_call_id>:human`, then a later superstep\n      // echoes the same prompt back with a real UUID (or vice\n      // versa). A naive \"match-or-append by id\" strategy treats\n      // each fresh id as a new entry and the list grows\n      // monotonically, showing the same content twice (or more)\n      // in the UI.\n      //\n      // Policy (mirrors the root controller's `#applyValues`):\n      //\n      //  1. Walk `values.messages` in order. For each id, prefer\n      //     the stream-assembled entry if we have one for that id\n      //     (keeps in-progress token streaming visible); otherwise\n      //     take the values-coerced instance. Same-id values still\n      //     win when they carry data the stream lacks:\n      //       - tool messages arriving without `tool_call_id` on\n      //         the messages channel — the values snapshot always\n      //         carries it;\n      //       - AI messages whose finalized `tool_calls` didn't\n      //         fully land via the messages channel — the values\n      //         snapshot's AI message has them populated;\n      //       - metadata enrichment with unchanged content (e.g.\n      //         committed `additional_kwargs` on an echoed human).\n      //\n      //  2. Append any stream-only ids (seen on the messages\n      //     channel but never echoed in ANY values snapshot yet)\n      //     — their enclosing superstep hasn't committed yet, so\n      //     dropping them would flash the UI.\n      //\n      //  3. Ids that WERE in a prior values snapshot but are gone\n      //     from this one are treated as explicit removals\n      //     (`RemoveMessage` reducer deltas) and dropped.\n      //\n      // Unkeyed messages (no stable id) are passed through in\n      // their values order because we can't dedupe them safely.\n      const applyValuesEvent = (event: ValuesEvent): void => {\n        const data = event.params.data;\n        if (data == null || typeof data !== \"object\" || Array.isArray(data)) {\n          return;\n        }\n        const state = data as Record<string, unknown>;\n        const rawMessages = state.messages;\n        if (!Array.isArray(rawMessages) || rawMessages.length === 0) return;\n\n        const coerced = ensureMessageInstances(\n          rawMessages as (Message | BaseMessage)[]\n        );\n\n        const reconciliation = reconcileMessagesFromValues({\n          valueMessages: coerced,\n          currentMessages: pendingMessages,\n          currentIndexById: indexById,\n          previousValueMessageIds: valuesMessageIds,\n          streamedMessageIds: streamMessageIds,\n          preferValuesMessage: shouldPreferValuesMessage,\n        });\n        valuesMessageIds = reconciliation.valueMessageIds;\n        const reconciledMessages = [...reconciliation.messages];\n\n        pendingMessages.length = 0;\n        for (const message of reconciledMessages) pendingMessages.push(message);\n        indexById.clear();\n        for (const [id, idx] of buildMessageIndex(pendingMessages)) {\n          indexById.set(id, idx);\n        }\n        scheduleFlush();\n      };\n\n      const applyEvent = (event: MessagesEvent): void => {\n        const data = event.params.data;\n\n        if (data.event === \"message-start\") {\n          const startData = data as MessageStartData;\n          const role = (startData.role ?? \"ai\") as MessageRole;\n          // \"tool\" role is a v1 convention not represented in the\n          // protocol enum but common in practice — keep it working\n          // for graphs that emit it as an extensible field.\n          const extendedRole =\n            (startData as { role?: ExtendedMessageRole }).role ?? role;\n          const maybeToolCallId = (startData as { tool_call_id?: string })\n            .tool_call_id;\n          if (startData.id != null) {\n            roleByKey.set(startData.id, {\n              role: extendedRole,\n              toolCallId: maybeToolCallId,\n            });\n          }\n        }\n\n        const update = assembler.consume(event);\n        if (update == null) return;\n        const msg = update.message;\n        const id = msg.id;\n        if (id == null) return;\n        const captured = roleByKey.get(id) ?? { role: \"ai\" as const };\n        const base = assembledMessageToBaseMessage(msg, captured.role, {\n          toolCallId: captured.toolCallId,\n        });\n\n        streamMessageIds.add(id);\n        const existingIdx = indexById.get(id);\n        if (existingIdx == null) {\n          indexById.set(id, pendingMessages.length);\n          pendingMessages.push(base);\n        } else {\n          pendingMessages[existingIdx] = base;\n        }\n        scheduleFlush();\n      };\n\n      let runtime: ProjectionRuntime | undefined;\n      const openSubscription = () => {\n        runtime = openProjectionSubscription({\n          thread,\n          // Subscribe to both `messages` (live token deltas that drive\n          // the in-flight assistant bubble) and `values` (periodic full-\n          // state snapshots). Consuming values lets late-mounted scoped\n          // projections backfill history after the run has finished.\n          channels: [\"messages\", \"values\"],\n          namespace: ns,\n          onEvent(event) {\n            if (event.method === \"messages\") {\n              applyEvent(event as MessagesEvent);\n            } else if (event.method === \"values\") {\n              applyValuesEvent(event as ValuesEvent);\n            }\n          },\n        });\n      };\n\n      void (async () => {\n        const seeded =\n          (await rootBus.trySeedFromHistory?.({\n            kind: \"messages\",\n            namespace: ns,\n            store,\n          })) === true;\n        if (!seeded && !disposed) openSubscription();\n      })();\n\n      return {\n        async dispose() {\n          disposed = true;\n          if (flushChannel != null) {\n            flushChannel.port1.onmessage = null;\n            flushChannel.port1.close();\n            flushChannel.port2.close();\n          }\n          await runtime?.dispose();\n        },\n      };\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"messages.cjs","names":["namespaceKey","MessageAssembler","isRootNamespace","reconcileMessagesFromValues","ensureMessageInstances","shouldPreferValuesMessage","buildMessageIndex","assembledMessageToBaseMessage","openProjectionSubscription"],"sources":["../../../src/stream/projections/messages.ts"],"sourcesContent":["/**\n * Namespace-scoped `messages` projection.\n *\n * Opens `thread.subscribe({ channels: [\"messages\"], namespaces: [ns] })`\n * and folds each `messages` event through {@link MessageAssembler}.\n * Every update — start, block delta, block finish, message finish —\n * re-derives a `BaseMessage` class instance for the currently-active\n * message and updates its slot in the store.\n *\n * The projection emits `BaseMessage[]` (class instances from\n * `@langchain/core/messages`), never plain serialized objects.\n */\nimport type {\n  MessagesEvent,\n  MessageRole,\n  MessageStartData,\n  ValuesEvent,\n} from \"@langchain/protocol\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport { MessageAssembler } from \"../../client/stream/messages.js\";\nimport {\n  assembledMessageToBaseMessage,\n  type ExtendedMessageRole,\n} from \"../assembled-to-message.js\";\nimport type { Message } from \"../../types.messages.js\";\nimport type { ProjectionSpec, ProjectionRuntime } from \"../types.js\";\nimport { ensureMessageInstances } from \"../message-coercion.js\";\nimport { isRootNamespace, namespaceKey } from \"../namespace.js\";\nimport {\n  buildMessageIndex,\n  reconcileMessagesFromValues,\n  shouldPreferValuesMessage,\n} from \"../message-reconciliation.js\";\nimport { openProjectionSubscription } from \"./runtime.js\";\n\nexport function messagesProjection(\n  namespace: readonly string[]\n): ProjectionSpec<BaseMessage[]> {\n  const ns = [...namespace];\n  const key = `messages|${namespaceKey(ns)}`;\n\n  return {\n    key,\n    namespace: ns,\n    initial: [],\n    open({ thread, store, rootBus }): ProjectionRuntime {\n      const assembler = new MessageAssembler();\n      // Per-messageId state needed for BaseMessage projection:\n      //  - `role` is only in the `message-start` event; we cache it\n      //    so subsequent delta events still produce a typed message.\n      //  - `toolCallId` is pulled from message-start extras when role\n      //    is `tool` (a convention we keep compatible with serialized\n      //    v1 tool messages).\n      const roleByKey = new Map<\n        string,\n        { role: ExtendedMessageRole; toolCallId?: string }\n      >();\n      const indexById = new Map<string, number>();\n      // Ids this projection has observed via the `messages` channel\n      // (token-level deltas). Used by `applyValuesEvent` to prefer the\n      // stream-assembled version over the values-coerced shape while a\n      // turn is streaming, matching the root controller's policy.\n      const streamMessageIds = new Set<string>();\n      // Ids observed in the most recent `values.messages` snapshot.\n      // Messages that were present in a prior snapshot but are absent\n      // from this one are treated as explicit removals (server-side\n      // `RemoveMessage` reducer deltas). Stream-only messages (seen on\n      // the messages channel but never echoed in a values snapshot)\n      // are preserved — their enclosing superstep may simply not have\n      // committed yet.\n      let valuesMessageIds = new Set<string>();\n      // Same run-boundary rule as the root projection, driven by root\n      // lifecycle events: a terminal drops streamed, uncommitted messages\n      // that never finished; the next `running` drops the rest. Streamed\n      // events for a dropped id are ignored from then on, so a replayed\n      // `message-start` can't rebuild it.\n      const uncommittedIds = new Set<string>();\n      const finishedIds = new Set<string>();\n      const droppedIds = new Set<string>();\n\n      // Root-scoped projections whose channels are already covered by\n      // the controller's root pump attach to the shared fan-out\n      // instead of opening a second server subscription. The root\n      // pump runs at `{namespaces: [[]], depth: 1}`, which is exactly\n      // the scope a root-namespace `messagesProjection` wants.\n      const rootShortCircuit =\n        isRootNamespace(ns) && rootBus.channels.includes(\"messages\");\n\n      let disposed = false;\n\n      // Local mirror of the store contents. Every `applyEvent` /\n      // `applyValuesEvent` mutates this synchronously; a coalesced\n      // `scheduleFlush` copies it to `store` once per macrotask.\n      //\n      // Why the indirection? When a namespace-scoped projection\n      // (e.g. a subagent modal opened after the run finished) first\n      // subscribes, the server replays the entire history from\n      // `seq=0`. Dozens of `messages`-channel events can land in a\n      // single SSE parse — they drain through the `for await` loop\n      // as a long microtask chain. Microtasks run before any\n      // macrotask, so React's concurrent scheduler never gets a\n      // chance to commit between updates. Calling `store.setValue`\n      // per event in that burst overflows React's\n      // `nestedUpdateCount` guard and throws \"Maximum update depth\n      // exceeded\", permanently killing the projection and\n      // leaving the store stuck at its first few messages.\n      //\n      // Batching via `MessageChannel` (macrotask) coalesces the\n      // replay burst into one `setValue` call and lets React\n      // commit between flushes for live token streaming too.\n      const pendingMessages: BaseMessage[] = [];\n      let dirty = false;\n      let flushScheduled = false;\n      const flushChannel =\n        typeof MessageChannel !== \"undefined\" ? new MessageChannel() : null;\n\n      const flush = (): void => {\n        flushScheduled = false;\n        if (!dirty || disposed) return;\n        dirty = false;\n        // `.slice()` breaks identity so React's `Object.is` bail-out\n        // in `StreamStore.setValue` propagates the change.\n        store.setValue(pendingMessages.slice());\n      };\n      if (flushChannel != null) {\n        flushChannel.port1.onmessage = flush;\n      }\n\n      const scheduleFlush = (): void => {\n        dirty = true;\n        if (flushScheduled) return;\n        flushScheduled = true;\n        if (flushChannel != null) {\n          flushChannel.port2.postMessage(null);\n        } else {\n          setTimeout(flush, 0);\n        }\n      };\n\n      // Rebuild the store from `values.messages` snapshots.\n      //\n      // `values` events carry the full, committed state of the\n      // thread's `messages` channel at a checkpoint — they fire\n      // on node completion, AFTER every `messages`-channel delta\n      // for that turn has been emitted. They are the authoritative\n      // source of truth for ORDER and for non-streamed messages\n      // (human turns, serialised tool results, subagent echoes, …).\n      //\n      // Why rebuild rather than merge-by-id?\n      //\n      // In practice the server may emit the same logical message\n      // with DIFFERENT ids across successive `values` snapshots at\n      // the same namespace — e.g. a subagent first surfaces its\n      // seed prompt with a synthetic id like\n      // `subagent:<tool_call_id>:human`, then a later superstep\n      // echoes the same prompt back with a real UUID (or vice\n      // versa). A naive \"match-or-append by id\" strategy treats\n      // each fresh id as a new entry and the list grows\n      // monotonically, showing the same content twice (or more)\n      // in the UI.\n      //\n      // Policy (mirrors the root controller's `#applyValues`):\n      //\n      //  1. Walk `values.messages` in order. For each id, prefer\n      //     the stream-assembled entry if we have one for that id\n      //     (keeps in-progress token streaming visible); otherwise\n      //     take the values-coerced instance. Same-id values still\n      //     win when they carry data the stream lacks:\n      //       - tool messages arriving without `tool_call_id` on\n      //         the messages channel — the values snapshot always\n      //         carries it;\n      //       - AI messages whose finalized `tool_calls` didn't\n      //         fully land via the messages channel — the values\n      //         snapshot's AI message has them populated;\n      //       - metadata enrichment with unchanged content (e.g.\n      //         committed `additional_kwargs` on an echoed human).\n      //\n      //  2. Append any stream-only ids (seen on the messages\n      //     channel but never echoed in ANY values snapshot yet)\n      //     — their enclosing superstep hasn't committed yet, so\n      //     dropping them would flash the UI.\n      //\n      //  3. Ids that WERE in a prior values snapshot but are gone\n      //     from this one are treated as explicit removals\n      //     (`RemoveMessage` reducer deltas) and dropped.\n      //\n      // Unkeyed messages (no stable id) are passed through in\n      // their values order because we can't dedupe them safely.\n      const applyValuesEvent = (event: ValuesEvent): void => {\n        const data = event.params.data;\n        if (data == null || typeof data !== \"object\" || Array.isArray(data)) {\n          return;\n        }\n        const state = data as Record<string, unknown>;\n        const rawMessages = state.messages;\n        if (!Array.isArray(rawMessages) || rawMessages.length === 0) return;\n\n        const coerced = ensureMessageInstances(\n          rawMessages as (Message | BaseMessage)[]\n        );\n\n        const reconciliation = reconcileMessagesFromValues({\n          valueMessages: coerced,\n          currentMessages: pendingMessages,\n          currentIndexById: indexById,\n          previousValueMessageIds: valuesMessageIds,\n          streamedMessageIds: streamMessageIds,\n          preferValuesMessage: shouldPreferValuesMessage,\n        });\n        valuesMessageIds = reconciliation.valueMessageIds;\n        for (const id of valuesMessageIds) {\n          uncommittedIds.delete(id);\n          finishedIds.delete(id);\n        }\n        const reconciledMessages = [...reconciliation.messages];\n\n        pendingMessages.length = 0;\n        for (const message of reconciledMessages) pendingMessages.push(message);\n        indexById.clear();\n        for (const [id, idx] of buildMessageIndex(pendingMessages)) {\n          indexById.set(id, idx);\n        }\n        scheduleFlush();\n      };\n\n      const applyEvent = (event: MessagesEvent): void => {\n        const data = event.params.data;\n\n        if (data.event === \"message-start\") {\n          const startData = data as MessageStartData;\n          const role = (startData.role ?? \"ai\") as MessageRole;\n          // \"tool\" role is a v1 convention not represented in the\n          // protocol enum but common in practice — keep it working\n          // for graphs that emit it as an extensible field.\n          const extendedRole =\n            (startData as { role?: ExtendedMessageRole }).role ?? role;\n          const maybeToolCallId = (startData as { tool_call_id?: string })\n            .tool_call_id;\n          if (startData.id != null) {\n            roleByKey.set(startData.id, {\n              role: extendedRole,\n              toolCallId: maybeToolCallId,\n            });\n          }\n        }\n\n        const update = assembler.consume(event);\n        if (update == null) return;\n        const msg = update.message;\n        const id = msg.id;\n        if (id == null || droppedIds.has(id)) return;\n        if (!valuesMessageIds.has(id)) uncommittedIds.add(id);\n        if (update.kind === \"message-finish\") finishedIds.add(id);\n        const captured = roleByKey.get(id) ?? { role: \"ai\" as const };\n        const base = assembledMessageToBaseMessage(msg, captured.role, {\n          toolCallId: captured.toolCallId,\n        });\n\n        streamMessageIds.add(id);\n        const existingIdx = indexById.get(id);\n        if (existingIdx == null) {\n          indexById.set(id, pendingMessages.length);\n          pendingMessages.push(base);\n        } else {\n          pendingMessages[existingIdx] = base;\n        }\n        scheduleFlush();\n      };\n\n      const closeRun = (unfinishedOnly: boolean): void => {\n        assembler.abandonActive();\n        const dropped = new Set<string>();\n        for (const id of uncommittedIds) {\n          if (unfinishedOnly && finishedIds.has(id)) continue;\n          dropped.add(id);\n        }\n        if (dropped.size === 0) return;\n        for (const id of dropped) {\n          uncommittedIds.delete(id);\n          finishedIds.delete(id);\n          droppedIds.add(id);\n        }\n        const kept = pendingMessages.filter(\n          (m) => m.id == null || !dropped.has(m.id)\n        );\n        pendingMessages.length = 0;\n        pendingMessages.push(...kept);\n        indexById.clear();\n        for (const [id, idx] of buildMessageIndex(pendingMessages)) {\n          indexById.set(id, idx);\n        }\n        scheduleFlush();\n      };\n\n      // Root lifecycle arrives on the root pump, not this subscription.\n      // Defer a macrotask so events this subscription has already\n      // received from before the terminal are applied first.\n      const unsubscribeLifecycle = rootBus.subscribe((event) => {\n        if (event.method !== \"lifecycle\") return;\n        if (!isRootNamespace(event.params.namespace)) return;\n        const lifecycle = (event.params.data as { event?: string })?.event;\n        if (lifecycle === \"running\") {\n          setTimeout(() => !disposed && closeRun(false), 0);\n        } else if (\n          lifecycle === \"completed\" ||\n          lifecycle === \"interrupted\" ||\n          lifecycle === \"failed\"\n        ) {\n          setTimeout(() => !disposed && closeRun(true), 0);\n        }\n      });\n\n      let runtime: ProjectionRuntime | undefined;\n      const openSubscription = () => {\n        runtime = openProjectionSubscription({\n          thread,\n          // Subscribe to both `messages` (live token deltas that drive\n          // the in-flight assistant bubble) and `values` (periodic full-\n          // state snapshots). Consuming values lets late-mounted scoped\n          // projections backfill history after the run has finished.\n          channels: [\"messages\", \"values\"],\n          namespace: ns,\n          onEvent(event) {\n            if (event.method === \"messages\") {\n              applyEvent(event as MessagesEvent);\n            } else if (event.method === \"values\") {\n              applyValuesEvent(event as ValuesEvent);\n            }\n          },\n        });\n      };\n\n      if (rootShortCircuit) {\n        runtime = {\n          dispose: rootBus.subscribe((event) => {\n            if (!isRootNamespace(event.params.namespace)) return;\n            if (event.method === \"messages\") {\n              applyEvent(event as MessagesEvent);\n            } else if (event.method === \"values\") {\n              applyValuesEvent(event as ValuesEvent);\n            }\n          }),\n        };\n      } else {\n        void (async () => {\n          const seeded =\n            (await rootBus.trySeedFromHistory?.({\n              kind: \"messages\",\n              namespace: ns,\n              store,\n            })) === true;\n          if (!seeded && !disposed) openSubscription();\n        })();\n      }\n\n      return {\n        async dispose() {\n          disposed = true;\n          unsubscribeLifecycle();\n          if (flushChannel != null) {\n            flushChannel.port1.onmessage = null;\n            flushChannel.port1.close();\n            flushChannel.port2.close();\n          }\n          await runtime?.dispose();\n        },\n      };\n    },\n  };\n}\n"],"mappings":"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"}