@athenaintel/react 0.57.2 → 0.60.0

package/dist/agent-runtime/src/subagents.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagents.js","sources":["../../../../agent-runtime/src/subagents.ts"],"sourcesContent":["/**\n * Subagent discovery: every subagent lane a deep-agent thread has spawned, as\n * the card view model the surfaces that draw subagent lanes render. Two\n * dispatch paths feed lanes keyed by dispatch id:\n *\n * - top-level `task` tool calls, read from the call's own tool-call part\n *   ({@link taskSubagentsOfTurn}): the part's result and `isPreliminary` say\n *   where the lane is, and its `messages` (the nested thread\n *   `createSubagentTranscriptConversionCache` converts) are the transcript;\n * - in-eval `task()` dispatches ({@link deriveEvalSubagents}), whose only\n *   signals are the live `ptc_subagents` state channel and the summaries a\n *   finished `eval` ToolMessage persists in `artifact.ptc_subagents`.\n */\nimport {\n  getExternalStoreMessages,\n  type ThreadMessage,\n  type ToolCallMessagePart,\n} from '@assistant-ui/core';\nimport type { LangChainMessage, LangChainToolCall } from '@assistant-ui/react-langgraph';\nimport { useAuiState } from '@assistant-ui/store';\nimport { useMemo } from 'react';\nimport {\n  DEEP_AGENT_LANE_USAGE_KEY,\n  DEEP_AGENT_TRUNCATED_LANE_KEY,\n} from './generated/runconfig-contract';\nimport type { PendingActionRequest } from './interrupts';\nimport { getMessageText } from './message-text';\nimport { convertSubagentTranscript, withRepeatedResult } from './subagent-transcripts';\nimport { EVAL_TOOL_NAME, TASK_TOOL_NAME } from './tool-names';\nimport type { PtcSubagentEntry, Todo } from './types';\n\n/**\n * Where a subagent lane is:\n *\n * - `queued` — the dispatch has not started: a `task` call with no result yet\n *   (waiting for a dispatch slot or an approval; the backend shows the running\n *   card once the dispatch holds its slot), or an in-eval dispatch waiting for\n *   one of the bridge's concurrency slots.\n * - `running` — a `task` call's result is still the backend's running\n *   placeholder (its part is `isPreliminary`), and the nested transcript fills\n *   in live; or an in-eval dispatch's lifecycle says it runs.\n * - `complete` / `error` — the real result replaced the placeholder; `error`\n *   when it is an error result.\n */\nexport type SubagentStatus = 'queued' | 'running' | 'complete' | 'error';\n\n/** True for the settled lifecycle states (`complete` / `error`). */\nexport function isTerminalSubagentStatus(status: SubagentStatus): boolean {\n  return status === 'complete' || status === 'error';\n}\n\n/** Aggregate lane lifecycle counts for one fan-out (orchestration strip + header chip). */\nexport interface SubagentStatusCounts {\n  total: number;\n  queued: number;\n  running: number;\n  complete: number;\n  failed: number;\n  /** complete + failed — the settled count progress displays use. */\n  terminal: number;\n}\n\nexport function countSubagentStatuses(\n  snapshots: readonly SubagentDiscoverySnapshot[]\n): SubagentStatusCounts {\n  const counts: SubagentStatusCounts = {\n    total: snapshots.length,\n    queued: 0,\n    running: 0,\n    complete: 0,\n    failed: 0,\n    terminal: 0,\n  };\n  for (const snapshot of snapshots) {\n    if (snapshot.status === 'queued') counts.queued += 1;\n    else if (snapshot.status === 'running') counts.running += 1;\n    else if (snapshot.status === 'complete') counts.complete += 1;\n    else counts.failed += 1;\n  }\n  counts.terminal = counts.complete + counts.failed;\n  return counts;\n}\n\n/**\n * Discovery snapshot for one subagent invocation. Mirrors LangChain's\n * `SubagentDiscoverySnapshot`: `id` is the `task` tool-call id that spawned the\n * subagent (the dispatch id for an in-eval dispatch), so cards nest under the\n * coordinator turn that delegated the work.\n */\nexport interface SubagentDiscoverySnapshot {\n  /** The `task` tool-call id that spawned the subagent. */\n  id: string;\n  /** Subagent type/name, from the `task` call's `subagent_type` arg. */\n  name: string;\n  /** The one-line task brief from the `task` call's `description` arg. */\n  description: string;\n  /** Lifecycle state — see {@link SubagentStatus}. */\n  status: SubagentStatus;\n  /** The call's result text (empty while it is the running placeholder). */\n  output?: string;\n  /** Number of nested tool calls the subagent made. */\n  toolCallCount: number;\n  /**\n   * The subagent's transcript as a nested thread: a `task` part's native\n   * `messages`, or an in-eval dispatch's live transcript converted the same way.\n   */\n  messages: readonly ThreadMessage[];\n  /** Messages in the transcript as the wire carries them, before conversion joins a turn's steps. */\n  messageCount: number;\n  /**\n   * Nested messages the wire left off: a cut card carries its newest steps\n   * ({@link readTruncatedLane}) — a running card always, a finished one on a\n   * version-2 view — and the rest pages in through `history/lane`; an in-eval\n   * dispatch's streamed transcript is cut the same way, running or finished.\n   * Absent when the transcript rides whole.\n   */\n  omittedMessageCount?: number;\n  /**\n   * Where the lane's steps ride, what `history/lane` pages the rest of the lane\n   * under (`useDeepAgentLaneHistory`): a `task` lane's card, an in-eval lane's\n   * registry entry while it streams its steps, or, once they no longer ride,\n   * its subagent checkpoint (`checkpointed`), when agora recorded where that is\n   * (`ns`). Absent for any other in-eval lane with no streamed steps (a summary\n   * written before agora recorded the namespace, an older host).\n   */\n  source?: SubagentLaneSource;\n  /** The subagent's own plan, nested by the backend on the task artifact (`subgraph_state.todos`). */\n  todos?: Todo[];\n  /** The newest tool call in the transcript — the card's \"last action\" ticker. */\n  lastToolCall?: LangChainToolCall;\n  /** The newest assistant text in the transcript — the card's thought preview. */\n  currentText: string;\n  /**\n   * The `eval` tool-call id that dispatched this subagent, when it was spawned\n   * from INSIDE the code interpreter (`task()` in the REPL) rather than by a\n   * top-level `task` tool call. The eval card uses it to render lanes for its\n   * own dispatches.\n   */\n  evalId?: string;\n  /**\n   * Backend-reported runtime for a finished in-eval dispatch (from the terminal\n   * lifecycle event). Authoritative over client-side timing — it survives a page\n   * refresh, where local first-seen timestamps are gone.\n   */\n  durationMs?: number;\n  /** The model that produced the transcript, from its newest assistant turn's model stamp. */\n  model?: string;\n  /**\n   * The lane's token use: the whole lane's as the host counts it\n   * (`DEEP_AGENT_LANE_USAGE_KEY`), else the sum of the native step usage\n   * (`metadata.steps[].usage`) of the steps the transcript holds. Absent while\n   * no step reports any.\n   */\n  usage?: SubagentTokenUsage;\n}\n\n/** A subagent lane's token use. */\nexport interface SubagentTokenUsage {\n  /** Input tokens, the prompt cache's reads and writes included. */\n  readonly inputTokens: number;\n  readonly outputTokens: number;\n  /**\n   * Less than the lane will have used: the lane still runs (its newest step may\n   * not have reported yet), or no host total arrived and the sum covers only\n   * the steps held of a lane cut to its newest ones.\n   */\n  readonly partial: boolean;\n}\n\n/** Input and output tokens of some model calls. */\nexport interface TokenCounts {\n  readonly inputTokens: number;\n  readonly outputTokens: number;\n}\n\nfunction subagentNameFromArgs(args: Readonly<Record<string, unknown>> | undefined): string {\n  if (!args) return 'subagent';\n  return String(args.subagent_type ?? args.subagentType ?? args.subagent ?? 'subagent');\n}\n\n/**\n * The subagent's streamed transcript as the wire carries it, read from a task\n * ToolMessage's `artifact.subgraph_state.messages` (the shape the backend nests\n * it under — see the route's `_subagent_subgraph_state`).\n */\nexport function nestedMessagesFromArtifact(artifact: unknown): LangChainMessage[] {\n  const a = artifact as { subgraph_state?: { messages?: LangChainMessage[] } } | undefined;\n  return a?.subgraph_state?.messages ?? [];\n}\n\n/** What the wire left off a cut `task` card's nested transcript. */\nexport interface TruncatedLane {\n  /** Nested messages the host holds for the lane. */\n  messages: number;\n  /** Tool calls across all of them. */\n  toolCalls: number;\n  /**\n   * The card is a finished lane's, cut for a version-2 view. Only a host that\n   * serves `history/lane` cuts a finished card.\n   */\n  finished: boolean;\n}\n\n/**\n * Where a lane's steps ride, and what `history/lane` pages the rest of them\n * under: a `task` lane's card, by its message id, or an in-eval dispatch's\n * `ptc_subagents` registry entry, by its dispatch id.\n */\nexport type SubagentLaneSource = {\n  /** The steps as the wire carries them (a card's report restored, {@link withRepeatedResult}). */\n  readonly transcript: readonly LangChainMessage[];\n  /** The cut marker; absent while every step rides. */\n  readonly truncated?: TruncatedLane;\n  /**\n   * No steps ride, and `history/lane {lane}` pages the subagent's own steps\n   * from its checkpoint: an in-eval lane a later run in this activation left\n   * only its summary and `ns`, or a reopened session's lane (its registry gone,\n   * the summary its eval persisted records `ns`).\n   */\n  readonly checkpointed?: true;\n} & (\n  | {\n      /** The card's message id: the running placeholder's, then the result's. */\n      readonly messageId: string;\n      readonly lane?: undefined;\n    }\n  | {\n      /** The dispatch id: the in-eval lane's registry key. */\n      readonly lane: string;\n      readonly messageId?: undefined;\n    }\n);\n\nconst isCount = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 0;\n\n/**\n * The cut marker off a `task` card's raw wire message: the host carries only\n * the lane's newest nested steps and names the whole transcript here\n * (`DEEP_AGENT_TRUNCATED_LANE_KEY`), on a running card and, for a version-2\n * view, on a finished one. `null` when the transcript rides whole.\n */\nexport function readTruncatedLane(toolMessage: unknown): TruncatedLane | null {\n  if (typeof toolMessage !== 'object' || toolMessage === null) return null;\n  const marker = (toolMessage as Record<string, unknown>)[DEEP_AGENT_TRUNCATED_LANE_KEY];\n  if (typeof marker !== 'object' || marker === null) return null;\n  const { messages, tool_calls: toolCalls, finished } = marker as Record<string, unknown>;\n  return isCount(messages) && isCount(toolCalls)\n    ? { messages, toolCalls, finished: finished === true }\n    : null;\n}\n\n/**\n * The whole lane's token use the host carries on a `task` card's raw wire\n * message or an in-eval lane's `ptc_subagents` entry\n * (`DEEP_AGENT_LANE_USAGE_KEY`), however much of the lane the wire carries.\n * `null` when it carries none (an older host, or no step reported usage).\n */\nexport function readLaneUsage(wire: unknown): TokenCounts | null {\n  if (typeof wire !== 'object' || wire === null) return null;\n  const usage = (wire as Record<string, unknown>)[DEEP_AGENT_LANE_USAGE_KEY];\n  if (typeof usage !== 'object' || usage === null) return null;\n  const { input_tokens: inputTokens, output_tokens: outputTokens } = usage as Record<\n    string,\n    unknown\n  >;\n  return isCount(inputTokens) && isCount(outputTokens) ? { inputTokens, outputTokens } : null;\n}\n\n/**\n * A lane's token use: the host's total when it sent one, else what the native\n * steps of the transcript held add up to, partial while the lane runs or when\n * that transcript is cut. `undefined` while neither counts anything.\n */\nfunction laneTokenUsage(\n  wire: unknown,\n  steps: TokenCounts | undefined,\n  status: SubagentStatus,\n  cut: boolean\n): SubagentTokenUsage | undefined {\n  const settled = isTerminalSubagentStatus(status);\n  const whole = readLaneUsage(wire);\n  if (whole !== null) return { ...whole, partial: !settled };\n  return steps === undefined ? undefined : { ...steps, partial: !settled || cut };\n}\n\nconst transcriptStepUsageCache = new WeakMap<readonly ThreadMessage[], TokenCounts | null>();\n\n/**\n * What the model calls of a converted transcript used, from assistant-ui's\n * native step usage (`metadata.steps[].usage`, one step per model call a turn\n * joined). `undefined` when no step reports usage. Memoized per transcript\n * array, which the conversion caches keep while the transcript is unchanged.\n */\nexport function transcriptStepUsage(messages: readonly ThreadMessage[]): TokenCounts | undefined {\n  const cached = transcriptStepUsageCache.get(messages);\n  if (cached !== undefined) return cached ?? undefined;\n  let inputTokens = 0;\n  let outputTokens = 0;\n  let counted = false;\n  for (const message of messages) {\n    for (const step of message.metadata.steps ?? []) {\n      if (step.usage === undefined) continue;\n      inputTokens += step.usage.inputTokens;\n      outputTokens += step.usage.outputTokens;\n      counted = true;\n    }\n  }\n  const usage = counted ? { inputTokens, outputTokens } : null;\n  transcriptStepUsageCache.set(messages, usage);\n  return usage ?? undefined;\n}\n\n/**\n * The subagent's own plan, read from a task ToolMessage's\n * `artifact.subgraph_state.todos` (the backend mirrors the subagent's isolated\n * `todos` state channel there — see the route's `_forward_subagent_todos`).\n * `undefined` (not `[]`) when the subagent never wrote a plan, so the UI can\n * distinguish \"no plan\" from \"plan with zero items\".\n */\nexport function nestedTodosFromArtifact(artifact: unknown): Todo[] | undefined {\n  const a = artifact as { subgraph_state?: { todos?: unknown } } | undefined;\n  const todos = a?.subgraph_state?.todos;\n  return Array.isArray(todos) ? (todos as Todo[]) : undefined;\n}\n\n/**\n * The persisted in-eval dispatch summaries from an `eval` ToolMessage's\n * `artifact.ptc_subagents` (written by the backend when the eval ends). Unlike\n * the live `ptc_subagents` state channel — which dies with the stream — these\n * survive checkpoint reload, so reopened sessions can still render each\n * dispatch's terminal status, duration, output, and error.\n */\nexport function ptcSubagentsFromArtifact(artifact: unknown): PtcSubagentEntry[] {\n  const a = artifact as { ptc_subagents?: unknown } | undefined;\n  const entries = a?.ptc_subagents;\n  if (!Array.isArray(entries)) return [];\n  return entries.filter(\n    (entry): entry is PtcSubagentEntry =>\n      !!entry &&\n      typeof entry === 'object' &&\n      typeof (entry as { id?: unknown }).id === 'string' &&\n      !!(entry as { id?: string }).id\n  );\n}\n\nconst inEvalDispatchCounts = new WeakMap<object, number>();\n\n/**\n * How many subagents an `eval` call delegated to from inside the interpreter\n * (its `task()` dispatches), read off the call's own artifact: the persisted\n * dispatch summaries (`artifact.ptc_subagents`, one per dispatch id), else the\n * `task` sub-calls its PTC log records (a running call's placeholder, or a\n * backend that persists no summaries). Counted once per artifact object, so a\n * settled call's count costs nothing when its turn is read again.\n */\nexport function countInEvalDispatches(artifact: unknown): number {\n  if (typeof artifact !== 'object' || artifact === null) return 0;\n  const cached = inEvalDispatchCounts.get(artifact);\n  if (cached !== undefined) return cached;\n  const summaries = new Set(ptcSubagentsFromArtifact(artifact).map((entry) => entry.id));\n  let count = summaries.size;\n  if (count === 0) {\n    const dispatches = new Set<string>();\n    for (const message of nestedMessagesFromArtifact(artifact)) {\n      if (message.type !== 'ai' || !message.tool_calls) continue;\n      for (const call of message.tool_calls) {\n        if (call.name === TASK_TOOL_NAME && call.id) dispatches.add(call.id);\n      }\n    }\n    count = dispatches.size;\n  }\n  inEvalDispatchCounts.set(artifact, count);\n  return count;\n}\n\n/**\n * What one transcript contributes to a lane: the newest assistant text\n * (thought preview), the newest tool call and the count (\"last action\"\n * ticker), the producing model, and the plan recovered from the newest\n * `write_todos` call — the fallback for in-eval lanes, whose isolated `todos`\n * state channel never reaches the wire (the task path nests todos on the\n * artifact instead); the call args carry the same list, so the progress ring\n * can still fill. A pure function of the transcript array.\n */\ninterface TranscriptDerivation {\n  currentText: string;\n  model: string | undefined;\n  lastToolCall: LangChainToolCall | undefined;\n  toolCallCount: number;\n  todos: Todo[] | undefined;\n}\n\nconst EMPTY_TRANSCRIPT_DERIVATION: TranscriptDerivation = {\n  currentText: '',\n  model: undefined,\n  lastToolCall: undefined,\n  toolCallCount: 0,\n  todos: undefined,\n};\n\n/**\n * Per-transcript cache for {@link deriveTranscript}: a lane's converted\n * transcript keeps its array while the lane does not change (the conversion\n * caches hand back the previous array), so only lanes still streaming are\n * read again.\n */\nconst transcriptDerivationCache = new WeakMap<readonly ThreadMessage[], TranscriptDerivation>();\n\nfunction deriveTranscript(transcript: readonly ThreadMessage[]): TranscriptDerivation {\n  if (transcript.length === 0) return EMPTY_TRANSCRIPT_DERIVATION;\n  const cached = transcriptDerivationCache.get(transcript);\n  if (cached !== undefined) return cached;\n  let currentText = '';\n  let model: string | undefined;\n  let lastToolCall: LangChainToolCall | undefined;\n  let toolCallCount = 0;\n  let todos: Todo[] | undefined;\n  for (const message of transcript) {\n    if (message.role !== 'assistant') continue;\n    // A joined turn's `metadata.custom` merges its steps' stamps, the later\n    // step's winning (`joinExternalMessages`), so this is the newest stamp.\n    const turnModel: unknown = message.metadata?.custom?.model;\n    if (typeof turnModel === 'string' && turnModel) model = turnModel;\n    for (const part of message.content) {\n      if (part.type === 'text') {\n        if (part.text) currentText = part.text;\n        continue;\n      }\n      if (part.type !== 'tool-call') continue;\n      toolCallCount += 1;\n      lastToolCall = { id: part.toolCallId, name: part.toolName, args: part.args };\n      if (part.toolName !== 'write_todos') continue;\n      const list: unknown = part.args.todos;\n      if (Array.isArray(list)) todos = list as Todo[];\n    }\n  }\n  const derivation: TranscriptDerivation = {\n    currentText,\n    model,\n    lastToolCall,\n    toolCallCount,\n    todos,\n  };\n  transcriptDerivationCache.set(transcript, derivation);\n  return derivation;\n}\n\nconst NO_TRANSCRIPT: readonly ThreadMessage[] = [];\n\n/**\n * The lane of one `task` tool-call part. `toolMessage` is the raw ToolMessage\n * answering it, which carries the wire's cut marker for a running lane.\n */\nfunction taskSubagent(\n  part: ToolCallMessagePart,\n  toolMessage: LangChainMessage | undefined\n): SubagentDiscoverySnapshot {\n  const args: Readonly<Record<string, unknown>> = part.args;\n  const transcript = part.messages ?? NO_TRANSCRIPT;\n  const derived = deriveTranscript(transcript);\n  const messageCount = nestedMessagesFromArtifact(part.artifact).length;\n  const lane = readTruncatedLane(toolMessage);\n  const todos = nestedTodosFromArtifact(part.artifact);\n  const status: SubagentStatus =\n    part.result === undefined\n      ? 'queued'\n      : part.isPreliminary === true\n        ? 'running'\n        : part.isError === true\n          ? 'error'\n          : 'complete';\n  const usage = laneTokenUsage(\n    toolMessage,\n    transcriptStepUsage(transcript),\n    status,\n    lane !== null && lane.messages > messageCount\n  );\n  return {\n    id: part.toolCallId,\n    name: subagentNameFromArgs(args),\n    description: typeof args.description === 'string' ? args.description : '',\n    status,\n    ...(part.result !== undefined && { output: getMessageText({ content: part.result }) }),\n    toolCallCount: Math.max(derived.toolCallCount, lane?.toolCalls ?? 0),\n    messages: transcript,\n    messageCount,\n    ...(lane !== null && { omittedMessageCount: Math.max(0, lane.messages - messageCount) }),\n    ...(typeof toolMessage?.id === 'string' && {\n      source: {\n        messageId: toolMessage.id,\n        transcript: withRepeatedResult(nestedMessagesFromArtifact(part.artifact), part.result),\n        ...(lane !== null && { truncated: lane }),\n      },\n    }),\n    ...(todos !== undefined && { todos }),\n    ...(derived.lastToolCall !== undefined && { lastToolCall: derived.lastToolCall }),\n    currentText: derived.currentText,\n    ...(derived.model !== undefined && { model: derived.model }),\n    ...(usage !== undefined && { usage }),\n  };\n}\n\n/** The raw ToolMessage answering each tool call of a converted turn, from the sources bound to it. */\nfunction toolMessagesOfTurn(message: ThreadMessage): Map<string, LangChainMessage> {\n  const byCall = new Map<string, LangChainMessage>();\n  for (const source of getExternalStoreMessages<LangChainMessage>(message)) {\n    if (source.type === 'tool') byCall.set(source.tool_call_id, source);\n  }\n  return byCall;\n}\n\n/**\n * Per-part lane cache: a re-converted turn keeps the part object of every call\n * whose ToolMessage did not change (the conversion cache's `keepUnchangedParts`),\n * so a streaming lane re-derives only itself.\n */\nconst taskSubagentByPart = new WeakMap<ToolCallMessagePart, SubagentDiscoverySnapshot>();\nconst taskSubagentsByTurn = new WeakMap<ThreadMessage, ReadonlyMap<string, SubagentDiscoverySnapshot>>();\n\n/**\n * The lane of every `task` call in one converted turn (a `ThreadMessage`, or the\n * message state assistant-ui publishes for it), keyed by tool-call id in call\n * order. Memoized per turn and per part.\n */\nexport function taskSubagentsOfTurn(\n  message: ThreadMessage\n): ReadonlyMap<string, SubagentDiscoverySnapshot> {\n  const cached = taskSubagentsByTurn.get(message);\n  if (cached !== undefined) return cached;\n  const lanes = new Map<string, SubagentDiscoverySnapshot>();\n  if (message.role === 'assistant') {\n    let toolMessages: Map<string, LangChainMessage> | null = null;\n    for (const part of message.content) {\n      if (part.type !== 'tool-call' || part.toolName !== TASK_TOOL_NAME) continue;\n      let lane = taskSubagentByPart.get(part);\n      if (lane === undefined) {\n        toolMessages ??= toolMessagesOfTurn(message);\n        lane = taskSubagent(part, toolMessages.get(part.toolCallId));\n        taskSubagentByPart.set(part, lane);\n      }\n      lanes.set(part.toolCallId, lane);\n    }\n  }\n  taskSubagentsByTurn.set(message, lanes);\n  return lanes;\n}\n\n/** The lane of every `task` call in a converted thread, in transcript order. */\nexport function taskSubagentsOfThread(\n  messages: readonly ThreadMessage[]\n): SubagentDiscoverySnapshot[] {\n  return messages.flatMap((message) => [...taskSubagentsOfTurn(message).values()]);\n}\n\n/**\n * Point a lane at an in-eval dispatch's live transcript, converted into a nested\n * thread, with the live fields it derives. Never regresses a known tool-call\n * count: a countless later event must not reset a lane to \"0 tool calls\".\n */\nfunction applyLaneTranscript(\n  snap: SubagentDiscoverySnapshot,\n  transcript: readonly LangChainMessage[]\n): void {\n  snap.messages = convertSubagentTranscript(transcript, snap.status === 'running');\n  snap.messageCount = transcript.length;\n  const derived = deriveTranscript(snap.messages);\n  if (derived.currentText) snap.currentText = derived.currentText;\n  if (derived.model) snap.model = derived.model;\n  if (derived.lastToolCall) snap.lastToolCall = derived.lastToolCall;\n  snap.toolCallCount = Math.max(snap.toolCallCount, derived.toolCallCount);\n  // An in-eval lane has no artifact todos channel: recover the plan from its\n  // `write_todos` calls.\n  snap.todos = snap.todos ?? derived.todos;\n}\n\n/**\n * The lanes of in-eval dispatches, from two sources: the *persisted* summaries\n * each finished `eval` ToolMessage carries in `artifact.ptc_subagents`\n * (terminal truth; the only source after a session reopen), then the *live*\n * `ptc_subagents` state channel (`ptcSubagents`) for dispatches still\n * streaming. A live entry never downgrades a terminal snapshot back to\n * `running` — a stale lifecycle entry whose terminal event was lost must not\n * resurrect a perpetually-running lane the persisted summary already settled.\n * A lane whose steps no longer ride but whose subagent checkpoint namespace is\n * recorded (`ns`) is `checkpointed`, and `history/lane {lane}` pages its\n * steps: a live entry a later run stripped to its summary, or a persisted\n * summary with no live entry (the registry died with the activation that\n * streamed it). A live entry speaks for its lane over the summary.\n */\nexport function deriveEvalSubagents(\n  messages: readonly LangChainMessage[],\n  ptcSubagents?: Record<string, PtcSubagentEntry>\n): Map<string, SubagentDiscoverySnapshot> {\n  const byDispatchId = new Map<string, SubagentDiscoverySnapshot>();\n  // Persisted in-eval dispatch summaries (terminal truth; survives reopen).\n  for (const m of messages) {\n    if (m.type !== 'tool' || m.name !== EVAL_TOOL_NAME) continue;\n    for (const entry of ptcSubagentsFromArtifact(m.artifact)) {\n      mergePtcSubagentEntry(byDispatchId, entry, {\n        // The eval ended when these summaries were written, so any lane the\n        // backend could not settle is a cancelled dispatch, never \"running\".\n        status: entry.status === 'complete' ? 'complete' : 'error',\n        fallbackEvalId: m.tool_call_id,\n      });\n      noteCheckpointedLane(byDispatchId.get(entry.id), entry);\n    }\n  }\n  // Live lifecycle entries (the only signal while an eval is still streaming).\n  if (ptcSubagents) {\n    for (const entry of Object.values(ptcSubagents)) {\n      if (!entry || typeof entry !== 'object' || typeof entry.id !== 'string' || !entry.id) {\n        continue;\n      }\n      // This activation's registry speaks for the lane: the steps it streams,\n      // else its own namespace, else nothing to page.\n      const existing = byDispatchId.get(entry.id);\n      if (existing?.source?.checkpointed === true) existing.source = undefined;\n      mergePtcSubagentEntry(byDispatchId, entry, {\n        status:\n          entry.status === 'complete'\n            ? 'complete'\n            : entry.status === 'error'\n              ? 'error'\n              : entry.status === 'queued'\n                ? 'queued'\n                : 'running',\n      });\n      noteCheckpointedLane(byDispatchId.get(entry.id), entry);\n    }\n  }\n  return byDispatchId;\n}\n\n/** Lifecycle progression order — a merge may only move a lane forward. */\nfunction subagentStatusRank(status: SubagentStatus): number {\n  if (status === 'queued') return 0;\n  if (status === 'running') return 1;\n  return 2;\n}\n\nfunction mergePtcSubagentEntry(\n  byDispatchId: Map<string, SubagentDiscoverySnapshot>,\n  entry: PtcSubagentEntry,\n  options: { status: SubagentStatus; fallbackEvalId?: string }\n): void {\n  const { status, fallbackEvalId } = options;\n  const existing = byDispatchId.get(entry.id);\n  if (existing) {\n    // A lane only ever moves FORWARD (queued → running → terminal): a stale\n    // entry whose later event was lost must not resurrect a running lane to\n    // queued or a finished lane to running — and a settled terminal outcome\n    // never flips to the other terminal (first settled source wins).\n    if (\n      status === existing.status ||\n      subagentStatusRank(status) > subagentStatusRank(existing.status)\n    ) {\n      existing.status = status;\n    }\n    const evalId = entry.eval_id ?? fallbackEvalId;\n    if (evalId) existing.evalId = evalId;\n    if (typeof entry.duration_ms === 'number') existing.durationMs = entry.duration_ms;\n    // A count only arrives on terminal events; never let a countless later\n    // event (or an older backend) regress a known count.\n    if (typeof entry.tool_call_count === 'number') {\n      existing.toolCallCount = Math.max(existing.toolCallCount, entry.tool_call_count);\n    }\n    if (Array.isArray(entry.messages) && entry.messages.length > 0) {\n      applyLaneTranscript(existing, entry.messages);\n    }\n    applyLaneCut(existing, entry);\n    applyLaneUsage(existing, entry);\n    // Prefer the real output (Athena's in-eval output bridge); fall back to the\n    // error string only when no (non-empty) output was captured. Same\n    // empty-string/nullish rule as the create branch below.\n    if (entry.output) existing.output = entry.output;\n    else if (entry.error && !existing.output) existing.output = entry.error;\n    return;\n  }\n  // `||` (not `??`) so an empty-string output falls back to the error, matching\n  // the merge branch's truthy check above.\n  const initialOutput = entry.output || entry.error;\n  const evalId = entry.eval_id ?? fallbackEvalId;\n  const created: SubagentDiscoverySnapshot = {\n    id: entry.id,\n    name: String(entry.subagent_type ?? 'subagent'),\n    description: entry.label ?? entry.description ?? '',\n    status,\n    toolCallCount: typeof entry.tool_call_count === 'number' ? entry.tool_call_count : 0,\n    messages: NO_TRANSCRIPT,\n    messageCount: 0,\n    currentText: '',\n    ...(evalId ? { evalId } : {}),\n    ...(typeof entry.duration_ms === 'number' ? { durationMs: entry.duration_ms } : {}),\n    ...(initialOutput ? { output: initialOutput } : {}),\n  };\n  if (Array.isArray(entry.messages) && entry.messages.length > 0) {\n    applyLaneTranscript(created, entry.messages);\n  }\n  applyLaneCut(created, entry);\n  applyLaneUsage(created, entry);\n  byDispatchId.set(entry.id, created);\n}\n\n/**\n * Where an in-eval dispatch's streamed steps ride, and what the wire left off\n * them, read off its entry's cut marker (`DEEP_AGENT_TRUNCATED_LANE_KEY`) as a\n * `task` card's is: the steps left off, and the whole lane's tool calls.\n */\nfunction applyLaneCut(snap: SubagentDiscoverySnapshot, entry: PtcSubagentEntry): void {\n  const lane = readTruncatedLane(entry);\n  if (Array.isArray(entry.messages) && entry.messages.length > 0) {\n    snap.source = {\n      lane: entry.id,\n      transcript: entry.messages,\n      ...(lane !== null && { truncated: lane }),\n    };\n  }\n  if (lane === null) return;\n  snap.omittedMessageCount = Math.max(0, lane.messages - snap.messageCount);\n  snap.toolCallCount = Math.max(snap.toolCallCount, lane.toolCalls);\n}\n\nconst NO_LANE_STEPS: readonly LangChainMessage[] = [];\n\n/**\n * An entry that recorded its subagent's checkpoint namespace (`ns`, a registry\n * entry or the summary an eval persisted, since agora writes it) pages its\n * lane from that checkpoint when no streamed steps carry it.\n */\nfunction noteCheckpointedLane(\n  snap: SubagentDiscoverySnapshot | undefined,\n  entry: PtcSubagentEntry\n): void {\n  if (snap === undefined || snap.source !== undefined) return;\n  if (typeof entry.ns !== 'string' || !entry.ns) return;\n  snap.source = { lane: entry.id, transcript: NO_LANE_STEPS, checkpointed: true };\n}\n\n/**\n * An in-eval lane's token use, from its entry's host total or the native steps\n * of its live transcript. A merge that brings neither keeps what the lane has.\n */\nfunction applyLaneUsage(snap: SubagentDiscoverySnapshot, entry: PtcSubagentEntry): void {\n  const usage = laneTokenUsage(\n    entry,\n    transcriptStepUsage(snap.messages),\n    snap.status,\n    (snap.omittedMessageCount ?? 0) > 0\n  );\n  if (usage !== undefined) snap.usage = usage;\n}\n\n/**\n * The first call of a nested thread with one of `toolCallIds`: the calls a\n * subagent made are the tool-call parts of its transcript, ids included.\n */\nfunction findToolCall({\n  messages,\n  toolCallIds,\n}: {\n  messages: readonly ThreadMessage[] | undefined;\n  toolCallIds: ReadonlySet<string>;\n}): ToolCallMessagePart | undefined {\n  if (messages === undefined) return undefined;\n  for (const message of messages) {\n    if (message.role !== 'assistant') continue;\n    for (const part of message.content) {\n      if (part.type === 'tool-call' && toolCallIds.has(part.toolCallId)) return part;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Whether a subagent lane waits on a person's approval, given the gated calls\n * still waiting on one (`toolCallIdsAwaitingApproval`): its own dispatch is the\n * gated call (a per-dispatch `task` gate), or a call it made is (a gated tool\n * raised inside the delegated subagent). The approval names the gated call's\n * `tool_call_id` and never the lane, and a lane's transcript carries the calls\n * it made with their ids, so the call id is the join. A settled lane waits on\n * nobody.\n */\nexport function subagentAwaitingApproval({\n  lane,\n  toolCallIds,\n}: {\n  lane: Pick<SubagentDiscoverySnapshot, 'id' | 'status' | 'messages'>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): boolean {\n  if (toolCallIds.size === 0 || isTerminalSubagentStatus(lane.status)) return false;\n  return (\n    toolCallIds.has(lane.id) ||\n    findToolCall({ messages: lane.messages, toolCallIds }) !== undefined\n  );\n}\n\n/**\n * The call a subagent made that waits on a person's approval (a gated tool\n * raised inside the delegated subagent), read off its transcript — what the\n * lane card names while it waits. `undefined` when the lane made none, which\n * includes a lane whose own dispatch is the gated call.\n */\nexport function subagentToolCallAwaitingApproval({\n  lane,\n  toolCallIds,\n}: {\n  lane: Pick<SubagentDiscoverySnapshot, 'status' | 'messages'>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): LangChainToolCall | undefined {\n  if (toolCallIds.size === 0 || isTerminalSubagentStatus(lane.status)) return undefined;\n  const part = findToolCall({ messages: lane.messages, toolCallIds });\n  return part === undefined\n    ? undefined\n    : { id: part.toolCallId, name: part.toolName, args: part.args };\n}\n\n/** What {@link subagentLanesHoldingUnseenApproval} finds: the lanes, and the call if one holds it. */\nexport interface UnseenApprovalLanes {\n  /** The lanes holding a gated call none of their transcripts shows. */\n  laneIds: ReadonlySet<string>;\n  /**\n   * The gated call, when exactly one lane holds exactly one such call. With\n   * several candidate lanes the approval holds them all (the run is parked, so\n   * none of them runs), but which one made the call is unknown.\n   */\n  gatedCallId: string | undefined;\n}\n\nconst NO_UNSEEN_APPROVAL_LANES: UnseenApprovalLanes = {\n  laneIds: new Set(),\n  gatedCallId: undefined,\n};\n\n/**\n * The lanes of one turn that wait on a gated call no transcript shows. The\n * approval names a call raised inside a delegated subagent by its\n * `tool_call_id`, and the lane's transcript is what joins the two\n * ({@link subagentAwaitingApproval}). But a lane's steps ride only on the\n * backend's running placeholder, which is never checkpointed: a conversation\n * opened after its run parked (a reload, another device, a handover) shows the\n * lane with no steps at all, and the join finds nothing. A gated call that is\n * none of the turn's own calls and is in no lane's transcript was raised inside\n * one of the turn's unsettled lanes whose steps did not ride.\n *\n * Pass only the lanes of the turn the run is on now (the thread's newest\n * message, running or waiting on a person): an earlier turn's unsettled lane\n * was stopped, not parked, though its status still reads `requires-action`.\n */\nexport function subagentLanesHoldingUnseenApproval({\n  lanes,\n  turnToolCallIds,\n  toolCallIds,\n}: {\n  lanes: readonly Pick<SubagentDiscoverySnapshot, 'id' | 'status' | 'messages'>[];\n  /** Every tool-call id of the turn itself (its `task` calls included). */\n  turnToolCallIds: ReadonlySet<string>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): UnseenApprovalLanes {\n  if (toolCallIds.size === 0) return NO_UNSEEN_APPROVAL_LANES;\n  const shown = new Set<string>();\n  for (const lane of lanes) {\n    for (const message of lane.messages) {\n      if (message.role !== 'assistant') continue;\n      for (const part of message.content) {\n        if (part.type === 'tool-call' && toolCallIds.has(part.toolCallId)) {\n          shown.add(part.toolCallId);\n        }\n      }\n    }\n  }\n  const unseen: string[] = [...toolCallIds].filter(\n    (id) => !turnToolCallIds.has(id) && !shown.has(id)\n  );\n  if (unseen.length === 0) return NO_UNSEEN_APPROVAL_LANES;\n  const holders = lanes.filter(\n    (lane) => !isTerminalSubagentStatus(lane.status) && lane.messages.length === 0\n  );\n  if (holders.length === 0) return NO_UNSEEN_APPROVAL_LANES;\n  return {\n    laneIds: new Set(holders.map((lane) => lane.id)),\n    gatedCallId: holders.length === 1 && unseen.length === 1 ? unseen[0] : undefined,\n  };\n}\n\n/**\n * Every tool-call id of the turn the run is on now, else `undefined`: the\n * thread's newest message, still running or waiting on a person. An earlier\n * turn keeps `requires-action` for a call that never got its result (a stopped\n * run's lane), so its status alone never says it owns the run's approval.\n * Pass it to {@link subagentLanesHoldingUnseenApproval} as `turnToolCallIds`.\n */\nexport function openTurnToolCallIds(\n  message: Pick<ThreadMessage, 'role' | 'content' | 'status'> & { isLast: boolean }\n): ReadonlySet<string> | undefined {\n  if (message.role !== 'assistant' || !message.isLast) return undefined;\n  const status = message.status?.type;\n  if (status !== 'running' && status !== 'requires-action') return undefined;\n  const ids = new Set<string>();\n  for (const part of message.content) {\n    if (part.type === 'tool-call') ids.add(part.toolCallId);\n  }\n  return ids;\n}\n\n/**\n * What a subagent lane parked on a person's approval reads in every app (the\n * lane's status, where it would say Running or Queued).\n */\nexport const SUBAGENT_AWAITING_APPROVAL_LABEL = 'Waiting for approval';\n\n/** What a lane waits on, from {@link subagentLaneApprovalWait}. */\nexport interface SubagentLaneApprovalWait {\n  /** The lane is parked on an approval: its own dispatch or a call it made is the gated call. */\n  awaitingApproval: boolean;\n  /** The call inside the lane the approval gates, when it is known. */\n  gatedCall: LangChainToolCall | undefined;\n  /** The approval gates a call the lane made that its card cannot show (its steps did not ride). */\n  insideLane?: boolean;\n}\n\nconst NOT_AWAITING_APPROVAL: SubagentLaneApprovalWait = {\n  awaitingApproval: false,\n  gatedCall: undefined,\n};\n\n/**\n * Whether a lane waits on a person's approval, and on what: the call it made,\n * read off its transcript; or, for a lane whose steps did not ride (a\n * conversation opened after its run parked: {@link\n * subagentLanesHoldingUnseenApproval}), the call the approval names when this\n * lane alone can hold it, else only that it waits on a call it made. A lane\n * whose own dispatch is the gated call waits with no `gatedCall`.\n */\nexport function subagentLaneApprovalWait({\n  lane,\n  toolCallIds,\n  unseenApproval,\n  actionRequests,\n}: {\n  lane: Pick<SubagentDiscoverySnapshot, 'id' | 'status' | 'messages'>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n  /** The open turn's step-less lanes holding a gated call, when the lane is on that turn. */\n  unseenApproval: UnseenApprovalLanes | undefined;\n  /** The parked approval's gated calls, which name an unseen call's tool and arguments. */\n  actionRequests: readonly Pick<PendingActionRequest, 'toolCallId' | 'name' | 'args'>[] | undefined;\n}): SubagentLaneApprovalWait {\n  const unseen: boolean =\n    !isTerminalSubagentStatus(lane.status) && unseenApproval?.laneIds.has(lane.id) === true;\n  if (!subagentAwaitingApproval({ lane, toolCallIds }) && !unseen) return NOT_AWAITING_APPROVAL;\n  const shown = subagentToolCallAwaitingApproval({ lane, toolCallIds });\n  if (shown !== undefined || !unseen) return { awaitingApproval: true, gatedCall: shown };\n  const gatedCallId: string | undefined = unseenApproval?.gatedCallId;\n  const request = gatedCallId\n    ? actionRequests?.find((candidate) => candidate.toolCallId === gatedCallId)\n    : undefined;\n  return {\n    awaitingApproval: true,\n    gatedCall:\n      request && gatedCallId\n        ? // The approval's args crossed the wire as JSON, as a call's own do.\n          { id: gatedCallId, name: request.name, args: request.args as LangChainToolCall['args'] }\n        : undefined,\n    insideLane: true,\n  };\n}\n\n/**\n * Whether the lane of the `task` call `toolCallId` in this turn waits on a\n * person's approval, and on what ({@link subagentLaneApprovalWait}), for a\n * card that shows one lane (the SDK's, the phone's). The lanes are the turn's\n * own; a lane's steps are its converted `messages`, else (a host that doesn't\n * convert them, like the phone) the transcript its running placeholder\n * carries. On the turn the run is on now ({@link openTurnToolCallIds}), a\n * gated call no lane shows is held by its step-less lanes\n * ({@link subagentLanesHoldingUnseenApproval}), so a conversation opened after\n * its run parked still reads as waiting for approval.\n */\nexport function turnLaneApprovalWait({\n  message,\n  toolCallId,\n  toolCallIds,\n  actionRequests,\n}: {\n  message: ThreadMessage & { isLast: boolean };\n  toolCallId: string;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n  /** The parked approval's gated calls, which name an unseen call's tool and arguments. */\n  actionRequests: readonly Pick<PendingActionRequest, 'toolCallId' | 'name' | 'args'>[] | undefined;\n}): SubagentLaneApprovalWait {\n  if (toolCallIds.size === 0 || message.role !== 'assistant') return NOT_AWAITING_APPROVAL;\n  const artifacts = new Map<string, unknown>();\n  for (const part of message.content) {\n    if (part.type === 'tool-call' && part.toolName === TASK_TOOL_NAME) {\n      artifacts.set(part.toolCallId, part.artifact);\n    }\n  }\n  const lanes = [...taskSubagentsOfTurn(message).values()].map((lane) => {\n    if (lane.messages.length > 0) return lane;\n    const carried = nestedMessagesFromArtifact(artifacts.get(lane.id));\n    return carried.length === 0\n      ? lane\n      : { ...lane, messages: convertSubagentTranscript(carried, lane.status === 'running') };\n  });\n  const lane = lanes.find((candidate) => candidate.id === toolCallId);\n  if (lane === undefined) return NOT_AWAITING_APPROVAL;\n  const turnToolCallIds = openTurnToolCallIds(message);\n  return subagentLaneApprovalWait({\n    lane,\n    toolCallIds,\n    unseenApproval:\n      turnToolCallIds === undefined\n        ? undefined\n        : subagentLanesHoldingUnseenApproval({ lanes, turnToolCallIds, toolCallIds }),\n    actionRequests,\n  });\n}\n\n/**\n * What a lane waiting for approval says it waits on, in every app: a call it\n * made (\"Needs approval to run\", then the call), a call it made that its card\n * cannot name (\"Needs approval to continue\"), or its own dispatch (\"Needs\n * approval to start\").\n */\nexport function subagentApprovalNoteLabel({\n  gatedCall,\n  insideLane = false,\n}: Pick<SubagentLaneApprovalWait, 'gatedCall' | 'insideLane'>): string {\n  if (gatedCall !== undefined) return 'Needs approval to run';\n  return insideLane ? 'Needs approval to continue' : 'Needs approval to start';\n}\n\n/**\n * The calls of one converted turn that wait on a person's approval, in turn\n * order: a gated call of the turn itself, or a `task` call not yet settled\n * (no result, or the running placeholder) whose lane holds a gated call — the\n * steps the turn's step list reads as waiting rather than running or done.\n */\nexport function turnToolCallsAwaitingApproval({\n  message,\n  toolCallIds,\n}: {\n  message: ThreadMessage;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): string[] {\n  if (toolCallIds.size === 0 || message.role !== 'assistant') return [];\n  const ids: string[] = [];\n  for (const part of message.content) {\n    if (part.type !== 'tool-call') continue;\n    if (toolCallIds.has(part.toolCallId)) {\n      ids.push(part.toolCallId);\n      continue;\n    }\n    if (part.toolName !== TASK_TOOL_NAME) continue;\n    const settled = part.result !== undefined && part.isPreliminary !== true;\n    if (!settled && findToolCall({ messages: part.messages, toolCallIds }) !== undefined) {\n      ids.push(part.toolCallId);\n    }\n  }\n  return ids;\n}\n\nconst NO_WAITING_TOOL_CALLS: ReadonlySet<string> = new Set();\n/** Joins call ids into one selector value; an id never holds it. */\nconst TOOL_CALL_ID_SEPARATOR = '\\n';\n\n/**\n * {@link turnToolCallsAwaitingApproval} for the message in scope: what a\n * turn's step list takes as `waitingToolCallIds`, given the run's waiting\n * calls (`toolCallIdsAwaitingApproval`). Selected as a joined string, so a\n * streamed token re-renders the caller only when the waiting steps change, and\n * the set keeps its identity while they do not. Olympus's activity card and\n * the SDK chat's turns both read it.\n */\nexport function useTurnToolCallsAwaitingApproval(\n  toolCallIds: ReadonlySet<string>\n): ReadonlySet<string> {\n  const key = useAuiState((s) =>\n    toolCallIds.size === 0\n      ? ''\n      : turnToolCallsAwaitingApproval({ message: s.message, toolCallIds }).join(\n          TOOL_CALL_ID_SEPARATOR\n        )\n  );\n  return useMemo(\n    () => (key === '' ? NO_WAITING_TOOL_CALLS : new Set(key.split(TOOL_CALL_ID_SEPARATOR))),\n    [key]\n  );\n}\n\n/** Result text shown for a dispatch whose owning run ended before it finished. */\nexport const ORPHANED_SUBAGENT_OUTPUT =\n  'Interrupted — the run that dispatched this subagent ended before it finished.';\n\n/**\n * Settle snapshots orphaned by their dispatching context: once the owner (e.g.\n * the `eval` tool call whose in-eval `task()` issued them) is itself terminal,\n * nothing can ever deliver a `complete`/`error` lifecycle event for a lane still\n * `queued`/`running` — the dispatch coroutines were cancelled with the eval. Those\n * lanes are coerced to `error` with an interruption message so the UI can't show\n * perpetual \"Running · no activity\" ghosts. Returns the input array unchanged\n * (same reference) when there is nothing to settle.\n */\nexport function finalizeOrphanedSubagents(\n  snapshots: readonly SubagentDiscoverySnapshot[],\n  ownerTerminal: boolean\n): readonly SubagentDiscoverySnapshot[] {\n  if (!ownerTerminal || snapshots.every((s) => isTerminalSubagentStatus(s.status))) {\n    return snapshots;\n  }\n  return snapshots.map((s) =>\n    isTerminalSubagentStatus(s.status)\n      ? s\n      : { ...s, status: 'error', output: s.output || ORPHANED_SUBAGENT_OUTPUT }\n  );\n}\n\n/**\n * The `task` tool calls sharing `toolCallId`'s parent AI message — the parallel\n * fan-out siblings, in declaration order. Parallel `task` calls always live on ONE\n * AI message's `tool_calls`, so \"same parent message\" IS the parallelism boundary;\n * sequential delegations sit on separate AI messages and form singleton groups.\n * The FIRST sibling is the group's `anchorId`: its tool-part render draws the whole\n * side-by-side group and the other siblings render nothing, keeping the layout\n * change fully inside the `task` tool UI. Falls back to a singleton group when the\n * parent AI message isn't among `messages` (a turn's bound sources, or a raw\n * transcript).\n */\nexport interface TaskSiblingGroup {\n  /** Sibling `task` tool-call ids in declaration order. */\n  ids: string[];\n  /** The first sibling — the one tool-part render that owns the group's UI. */\n  anchorId: string;\n}\n\nexport function taskSiblingGroup(\n  messages: readonly LangChainMessage[],\n  toolCallId: string\n): TaskSiblingGroup {\n  for (const m of messages) {\n    if (m.type !== 'ai' || !m.tool_calls) continue;\n    if (!m.tool_calls.some((tc) => tc.id === toolCallId)) continue;\n    const ids = m.tool_calls\n      .filter((tc) => tc.name === TASK_TOOL_NAME && tc.id)\n      .map((tc) => tc.id as string);\n    if (ids.length > 0) return { ids, anchorId: ids[0] ?? toolCallId };\n    break;\n  }\n  return { ids: [toolCallId], anchorId: toolCallId };\n}\n"],"names":["lane"],"mappings":"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"}
+{"version":3,"file":"subagents.js","sources":["../../../../agent-runtime/src/subagents.ts"],"sourcesContent":["/**\n * Subagent discovery: every subagent lane a deep-agent thread has spawned, as\n * the card view model the surfaces that draw subagent lanes render. Two\n * dispatch paths feed lanes keyed by dispatch id:\n *\n * - top-level `task` tool calls, read from the call's own tool-call part\n *   ({@link taskSubagentsOfTurn}): the part's result and `isPreliminary` say\n *   where the lane is, and its `messages` (the nested thread\n *   `createSubagentTranscriptConversionCache` converts) are the transcript;\n * - in-eval `task()` dispatches ({@link deriveEvalSubagents}), whose only\n *   signals are the live `ptc_subagents` state channel and the summaries a\n *   finished `eval` ToolMessage persists in `artifact.ptc_subagents`.\n */\nimport {\n  getExternalStoreMessages,\n  type ThreadMessage,\n  type ToolCallMessagePart,\n} from '@assistant-ui/core';\nimport type { LangChainMessage, LangChainToolCall } from '@assistant-ui/react-langgraph';\nimport { useAuiState } from '@assistant-ui/store';\nimport { useMemo } from 'react';\nimport {\n  DEEP_AGENT_LANE_USAGE_KEY,\n  DEEP_AGENT_TRUNCATED_LANE_KEY,\n} from './generated/runconfig-contract';\nimport type { PendingActionRequest } from './interrupts';\nimport { getMessageText } from './message-text';\nimport { convertSubagentTranscript, withRepeatedResult } from './subagent-transcripts';\nimport { EVAL_TOOL_NAME, TASK_TOOL_NAME } from './tool-names';\nimport type { PtcSubagentEntry, Todo } from './types';\n\n/**\n * Where a subagent lane is:\n *\n * - `queued` — the dispatch has not started: a `task` call with no result yet\n *   (waiting for a dispatch slot or an approval; the backend shows the running\n *   card once the dispatch holds its slot), or an in-eval dispatch waiting for\n *   one of the bridge's concurrency slots.\n * - `running` — a `task` call's result is still the backend's running\n *   placeholder (its part is `isPreliminary`), and the nested transcript fills\n *   in live; or an in-eval dispatch's lifecycle says it runs.\n * - `complete` / `error` — the real result replaced the placeholder; `error`\n *   when it is an error result.\n */\nexport type SubagentStatus = 'queued' | 'running' | 'complete' | 'error';\n\n/** True for the settled lifecycle states (`complete` / `error`). */\nexport function isTerminalSubagentStatus(status: SubagentStatus): boolean {\n  return status === 'complete' || status === 'error';\n}\n\n/** Aggregate lane lifecycle counts for one fan-out (orchestration strip + header chip). */\nexport interface SubagentStatusCounts {\n  total: number;\n  queued: number;\n  running: number;\n  complete: number;\n  failed: number;\n  /** complete + failed — the settled count progress displays use. */\n  terminal: number;\n}\n\nexport function countSubagentStatuses(\n  snapshots: readonly SubagentDiscoverySnapshot[]\n): SubagentStatusCounts {\n  const counts: SubagentStatusCounts = {\n    total: snapshots.length,\n    queued: 0,\n    running: 0,\n    complete: 0,\n    failed: 0,\n    terminal: 0,\n  };\n  for (const snapshot of snapshots) {\n    if (snapshot.status === 'queued') counts.queued += 1;\n    else if (snapshot.status === 'running') counts.running += 1;\n    else if (snapshot.status === 'complete') counts.complete += 1;\n    else counts.failed += 1;\n  }\n  counts.terminal = counts.complete + counts.failed;\n  return counts;\n}\n\n/**\n * Discovery snapshot for one subagent invocation. Mirrors LangChain's\n * `SubagentDiscoverySnapshot`: `id` is the `task` tool-call id that spawned the\n * subagent (the dispatch id for an in-eval dispatch), so cards nest under the\n * coordinator turn that delegated the work.\n */\nexport interface SubagentDiscoverySnapshot {\n  /** The `task` tool-call id that spawned the subagent. */\n  id: string;\n  /** Subagent type/name, from the `task` call's `subagent_type` arg. */\n  name: string;\n  /** The one-line task brief from the `task` call's `description` arg. */\n  description: string;\n  /** Lifecycle state — see {@link SubagentStatus}. */\n  status: SubagentStatus;\n  /** The call's result text (empty while it is the running placeholder). */\n  output?: string;\n  /** Number of nested tool calls the subagent made. */\n  toolCallCount: number;\n  /**\n   * The subagent's transcript as a nested thread: a `task` part's native\n   * `messages`, or an in-eval dispatch's live transcript converted the same way.\n   */\n  messages: readonly ThreadMessage[];\n  /** Messages in the transcript as the wire carries them, before conversion joins a turn's steps. */\n  messageCount: number;\n  /**\n   * Nested messages the wire left off: a cut card carries its newest steps\n   * ({@link readTruncatedLane}) — a running card always, a finished one on a\n   * version-2 view — and the rest pages in through `history/lane`; an in-eval\n   * dispatch's streamed transcript is cut the same way, running or finished.\n   * Absent when the transcript rides whole.\n   */\n  omittedMessageCount?: number;\n  /**\n   * Where the lane's steps ride, what `history/lane` pages the rest of the lane\n   * under (`useDeepAgentLaneHistory`): a `task` lane's card, an in-eval lane's\n   * registry entry while it streams its steps, or, once they no longer ride,\n   * its subagent checkpoint (`checkpointed`), when agora recorded where that is\n   * (`ns`). Absent for any other in-eval lane with no streamed steps (a summary\n   * written before agora recorded the namespace, an older host).\n   */\n  source?: SubagentLaneSource;\n  /** The subagent's own plan, nested by the backend on the task artifact (`subgraph_state.todos`). */\n  todos?: Todo[];\n  /** The newest tool call in the transcript — the card's \"last action\" ticker. */\n  lastToolCall?: LangChainToolCall;\n  /** The newest assistant text in the transcript — the card's thought preview. */\n  currentText: string;\n  /**\n   * The `eval` tool-call id that dispatched this subagent, when it was spawned\n   * from INSIDE the code interpreter (`task()` in the REPL) rather than by a\n   * top-level `task` tool call. The eval card uses it to render lanes for its\n   * own dispatches.\n   */\n  evalId?: string;\n  /**\n   * Backend-reported runtime for a finished in-eval dispatch (from the terminal\n   * lifecycle event). Authoritative over client-side timing — it survives a page\n   * refresh, where local first-seen timestamps are gone.\n   */\n  durationMs?: number;\n  /** The model that produced the transcript, from its newest assistant turn's model stamp. */\n  model?: string;\n  /**\n   * The lane's token use: the whole lane's as the host counts it\n   * (`DEEP_AGENT_LANE_USAGE_KEY`), else the sum of the native step usage\n   * (`metadata.steps[].usage`) of the steps the transcript holds. Absent while\n   * no step reports any.\n   */\n  usage?: SubagentTokenUsage;\n}\n\n/** A subagent lane's token use. */\nexport interface SubagentTokenUsage {\n  /** Input tokens, the prompt cache's reads and writes included. */\n  readonly inputTokens: number;\n  readonly outputTokens: number;\n  /**\n   * Less than the lane will have used: the lane still runs (its newest step may\n   * not have reported yet), or no host total arrived and the sum covers only\n   * the steps held of a lane cut to its newest ones.\n   */\n  readonly partial: boolean;\n}\n\n/** Input and output tokens of some model calls. */\nexport interface TokenCounts {\n  readonly inputTokens: number;\n  readonly outputTokens: number;\n}\n\nfunction subagentNameFromArgs(args: Readonly<Record<string, unknown>> | undefined): string {\n  if (!args) return 'subagent';\n  return String(args.subagent_type ?? args.subagentType ?? args.subagent ?? 'subagent');\n}\n\n/**\n * The subagent's streamed transcript as the wire carries it, read from a task\n * ToolMessage's `artifact.subgraph_state.messages` (the shape the backend nests\n * it under — see the route's `_subagent_subgraph_state`).\n */\nexport function nestedMessagesFromArtifact(artifact: unknown): LangChainMessage[] {\n  const a = artifact as { subgraph_state?: { messages?: LangChainMessage[] } } | undefined;\n  return a?.subgraph_state?.messages ?? [];\n}\n\n/** What the wire left off a cut `task` card's nested transcript. */\nexport interface TruncatedLane {\n  /** Nested messages the host holds for the lane. */\n  messages: number;\n  /** Tool calls across all of them. */\n  toolCalls: number;\n  /**\n   * The card is a finished lane's, cut for a version-2 view. Only a host that\n   * serves `history/lane` cuts a finished card.\n   */\n  finished: boolean;\n}\n\n/**\n * Where a lane's steps ride, and what `history/lane` pages the rest of them\n * under: a `task` lane's card, by its message id, or an in-eval dispatch's\n * `ptc_subagents` registry entry, by its dispatch id.\n */\nexport type SubagentLaneSource = {\n  /** The steps as the wire carries them (a card's report restored, {@link withRepeatedResult}). */\n  readonly transcript: readonly LangChainMessage[];\n  /** The cut marker; absent while every step rides. */\n  readonly truncated?: TruncatedLane;\n  /**\n   * No steps ride, and `history/lane {lane}` pages the subagent's own steps\n   * from its checkpoint: an in-eval lane a later run in this activation left\n   * only its summary and `ns`, or a reopened session's lane (its registry gone,\n   * the summary its eval persisted records `ns`).\n   */\n  readonly checkpointed?: true;\n} & (\n  | {\n      /** The card's message id: the running placeholder's, then the result's. */\n      readonly messageId: string;\n      readonly lane?: undefined;\n    }\n  | {\n      /** The dispatch id: the in-eval lane's registry key. */\n      readonly lane: string;\n      readonly messageId?: undefined;\n    }\n);\n\nconst isCount = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 0;\n\n/**\n * The cut marker off a `task` card's raw wire message: the host carries only\n * the lane's newest nested steps and names the whole transcript here\n * (`DEEP_AGENT_TRUNCATED_LANE_KEY`), on a running card and, for a version-2\n * view, on a finished one. `null` when the transcript rides whole.\n */\nexport function readTruncatedLane(toolMessage: unknown): TruncatedLane | null {\n  if (typeof toolMessage !== 'object' || toolMessage === null) return null;\n  const marker = (toolMessage as Record<string, unknown>)[DEEP_AGENT_TRUNCATED_LANE_KEY];\n  if (typeof marker !== 'object' || marker === null) return null;\n  const { messages, tool_calls: toolCalls, finished } = marker as Record<string, unknown>;\n  return isCount(messages) && isCount(toolCalls)\n    ? { messages, toolCalls, finished: finished === true }\n    : null;\n}\n\n/**\n * The whole lane's token use the host carries on a `task` card's raw wire\n * message or an in-eval lane's `ptc_subagents` entry\n * (`DEEP_AGENT_LANE_USAGE_KEY`), however much of the lane the wire carries.\n * `null` when it carries none (an older host, or no step reported usage).\n */\nexport function readLaneUsage(wire: unknown): TokenCounts | null {\n  if (typeof wire !== 'object' || wire === null) return null;\n  const usage = (wire as Record<string, unknown>)[DEEP_AGENT_LANE_USAGE_KEY];\n  if (typeof usage !== 'object' || usage === null) return null;\n  const { input_tokens: inputTokens, output_tokens: outputTokens } = usage as Record<\n    string,\n    unknown\n  >;\n  return isCount(inputTokens) && isCount(outputTokens) ? { inputTokens, outputTokens } : null;\n}\n\n/**\n * A lane's token use: the host's total when it sent one, else what the native\n * steps of the transcript held add up to, partial while the lane runs or when\n * that transcript is cut. `undefined` while neither counts anything.\n */\nfunction laneTokenUsage(\n  wire: unknown,\n  steps: TokenCounts | undefined,\n  status: SubagentStatus,\n  cut: boolean\n): SubagentTokenUsage | undefined {\n  const settled = isTerminalSubagentStatus(status);\n  const whole = readLaneUsage(wire);\n  if (whole !== null) return { ...whole, partial: !settled };\n  return steps === undefined ? undefined : { ...steps, partial: !settled || cut };\n}\n\nconst transcriptStepUsageCache = new WeakMap<readonly ThreadMessage[], TokenCounts | null>();\n\n/**\n * What the model calls of a converted transcript used, from assistant-ui's\n * native step usage (`metadata.steps[].usage`, one step per model call a turn\n * joined). `undefined` when no step reports usage. Memoized per transcript\n * array, which the conversion caches keep while the transcript is unchanged.\n */\nexport function transcriptStepUsage(messages: readonly ThreadMessage[]): TokenCounts | undefined {\n  const cached = transcriptStepUsageCache.get(messages);\n  if (cached !== undefined) return cached ?? undefined;\n  let inputTokens = 0;\n  let outputTokens = 0;\n  let counted = false;\n  for (const message of messages) {\n    for (const step of message.metadata.steps ?? []) {\n      if (step.usage === undefined) continue;\n      inputTokens += step.usage.inputTokens;\n      outputTokens += step.usage.outputTokens;\n      counted = true;\n    }\n  }\n  const usage = counted ? { inputTokens, outputTokens } : null;\n  transcriptStepUsageCache.set(messages, usage);\n  return usage ?? undefined;\n}\n\n/**\n * The subagent's own plan, read from a task ToolMessage's\n * `artifact.subgraph_state.todos` (the backend mirrors the subagent's isolated\n * `todos` state channel there — see the route's `_forward_subagent_todos`).\n * `undefined` (not `[]`) when the subagent never wrote a plan, so the UI can\n * distinguish \"no plan\" from \"plan with zero items\".\n */\nexport function nestedTodosFromArtifact(artifact: unknown): Todo[] | undefined {\n  const a = artifact as { subgraph_state?: { todos?: unknown } } | undefined;\n  const todos = a?.subgraph_state?.todos;\n  return Array.isArray(todos) ? (todos as Todo[]) : undefined;\n}\n\n/**\n * The persisted in-eval dispatch summaries from an `eval` ToolMessage's\n * `artifact.ptc_subagents` (written by the backend when the eval ends). Unlike\n * the live `ptc_subagents` state channel — which dies with the stream — these\n * survive checkpoint reload, so reopened sessions can still render each\n * dispatch's terminal status, duration, output, and error.\n */\nexport function ptcSubagentsFromArtifact(artifact: unknown): PtcSubagentEntry[] {\n  const a = artifact as { ptc_subagents?: unknown } | undefined;\n  const entries = a?.ptc_subagents;\n  if (!Array.isArray(entries)) return [];\n  return entries.filter(\n    (entry): entry is PtcSubagentEntry =>\n      !!entry &&\n      typeof entry === 'object' &&\n      typeof (entry as { id?: unknown }).id === 'string' &&\n      !!(entry as { id?: string }).id\n  );\n}\n\nconst inEvalDispatchCounts = new WeakMap<object, number>();\n\n/**\n * How many subagents an `eval` call delegated to from inside the interpreter\n * (its `task()` dispatches), read off the call's own artifact: the persisted\n * dispatch summaries (`artifact.ptc_subagents`, one per dispatch id), else the\n * `task` sub-calls its PTC log records (a running call's placeholder, or a\n * backend that persists no summaries). Counted once per artifact object, so a\n * settled call's count costs nothing when its turn is read again.\n */\nexport function countInEvalDispatches(artifact: unknown): number {\n  if (typeof artifact !== 'object' || artifact === null) return 0;\n  const cached = inEvalDispatchCounts.get(artifact);\n  if (cached !== undefined) return cached;\n  const summaries = new Set(ptcSubagentsFromArtifact(artifact).map((entry) => entry.id));\n  let count = summaries.size;\n  if (count === 0) {\n    const dispatches = new Set<string>();\n    for (const message of nestedMessagesFromArtifact(artifact)) {\n      if (message.type !== 'ai' || !message.tool_calls) continue;\n      for (const call of message.tool_calls) {\n        if (call.name === TASK_TOOL_NAME && call.id) dispatches.add(call.id);\n      }\n    }\n    count = dispatches.size;\n  }\n  inEvalDispatchCounts.set(artifact, count);\n  return count;\n}\n\n/**\n * What one transcript contributes to a lane: the newest assistant text\n * (thought preview), the newest tool call and the count (\"last action\"\n * ticker), the producing model, and the plan recovered from the newest\n * `write_todos` call — the fallback for in-eval lanes, whose isolated `todos`\n * state channel never reaches the wire (the task path nests todos on the\n * artifact instead); the call args carry the same list, so the progress ring\n * can still fill. A pure function of the transcript array.\n */\ninterface TranscriptDerivation {\n  currentText: string;\n  model: string | undefined;\n  lastToolCall: LangChainToolCall | undefined;\n  toolCallCount: number;\n  todos: Todo[] | undefined;\n}\n\nconst EMPTY_TRANSCRIPT_DERIVATION: TranscriptDerivation = {\n  currentText: '',\n  model: undefined,\n  lastToolCall: undefined,\n  toolCallCount: 0,\n  todos: undefined,\n};\n\n/**\n * Per-transcript cache for {@link deriveTranscript}: a lane's converted\n * transcript keeps its array while the lane does not change (the conversion\n * caches hand back the previous array), so only lanes still streaming are\n * read again.\n */\nconst transcriptDerivationCache = new WeakMap<readonly ThreadMessage[], TranscriptDerivation>();\n\nfunction deriveTranscript(transcript: readonly ThreadMessage[]): TranscriptDerivation {\n  if (transcript.length === 0) return EMPTY_TRANSCRIPT_DERIVATION;\n  const cached = transcriptDerivationCache.get(transcript);\n  if (cached !== undefined) return cached;\n  let currentText = '';\n  let model: string | undefined;\n  let lastToolCall: LangChainToolCall | undefined;\n  let toolCallCount = 0;\n  let todos: Todo[] | undefined;\n  for (const message of transcript) {\n    if (message.role !== 'assistant') continue;\n    // A joined turn's `metadata.custom` merges its steps' stamps, the later\n    // step's winning (`joinExternalMessages`), so this is the newest stamp.\n    const turnModel: unknown = message.metadata?.custom?.model;\n    if (typeof turnModel === 'string' && turnModel) model = turnModel;\n    for (const part of message.content) {\n      if (part.type === 'text') {\n        if (part.text) currentText = part.text;\n        continue;\n      }\n      if (part.type !== 'tool-call') continue;\n      toolCallCount += 1;\n      lastToolCall = { id: part.toolCallId, name: part.toolName, args: part.args };\n      if (part.toolName !== 'write_todos') continue;\n      const list: unknown = part.args.todos;\n      if (Array.isArray(list)) todos = list as Todo[];\n    }\n  }\n  const derivation: TranscriptDerivation = {\n    currentText,\n    model,\n    lastToolCall,\n    toolCallCount,\n    todos,\n  };\n  transcriptDerivationCache.set(transcript, derivation);\n  return derivation;\n}\n\nconst NO_TRANSCRIPT: readonly ThreadMessage[] = [];\n\n/**\n * The lane of one `task` tool-call part. `toolMessage` is the raw ToolMessage\n * answering it, which carries the wire's cut marker for a running lane.\n */\nfunction taskSubagent(\n  part: ToolCallMessagePart,\n  toolMessage: LangChainMessage | undefined\n): SubagentDiscoverySnapshot {\n  const args: Readonly<Record<string, unknown>> = part.args;\n  const transcript = part.messages ?? NO_TRANSCRIPT;\n  const derived = deriveTranscript(transcript);\n  const messageCount = nestedMessagesFromArtifact(part.artifact).length;\n  const lane = readTruncatedLane(toolMessage);\n  const todos = nestedTodosFromArtifact(part.artifact);\n  const status: SubagentStatus =\n    part.result === undefined\n      ? 'queued'\n      : part.isPreliminary === true\n        ? 'running'\n        : part.isError === true\n          ? 'error'\n          : 'complete';\n  const usage = laneTokenUsage(\n    toolMessage,\n    transcriptStepUsage(transcript),\n    status,\n    lane !== null && lane.messages > messageCount\n  );\n  return {\n    id: part.toolCallId,\n    name: subagentNameFromArgs(args),\n    description: typeof args.description === 'string' ? args.description : '',\n    status,\n    ...(part.result !== undefined && { output: getMessageText({ content: part.result }) }),\n    toolCallCount: Math.max(derived.toolCallCount, lane?.toolCalls ?? 0),\n    messages: transcript,\n    messageCount,\n    ...(lane !== null && { omittedMessageCount: Math.max(0, lane.messages - messageCount) }),\n    ...(typeof toolMessage?.id === 'string' && {\n      source: {\n        messageId: toolMessage.id,\n        transcript: withRepeatedResult(nestedMessagesFromArtifact(part.artifact), part.result),\n        ...(lane !== null && { truncated: lane }),\n      },\n    }),\n    ...(todos !== undefined && { todos }),\n    ...(derived.lastToolCall !== undefined && { lastToolCall: derived.lastToolCall }),\n    currentText: derived.currentText,\n    ...(derived.model !== undefined && { model: derived.model }),\n    ...(usage !== undefined && { usage }),\n  };\n}\n\n/** The raw ToolMessage answering each tool call of a converted turn, from the sources bound to it. */\nfunction toolMessagesOfTurn(message: ThreadMessage): Map<string, LangChainMessage> {\n  const byCall = new Map<string, LangChainMessage>();\n  for (const source of getExternalStoreMessages<LangChainMessage>(message)) {\n    if (source.type === 'tool') byCall.set(source.tool_call_id, source);\n  }\n  return byCall;\n}\n\n/**\n * Per-part lane cache: a re-converted turn keeps the part object of every call\n * whose ToolMessage did not change (the conversion cache's `keepUnchangedParts`),\n * so a streaming lane re-derives only itself.\n */\nconst taskSubagentByPart = new WeakMap<ToolCallMessagePart, SubagentDiscoverySnapshot>();\nconst taskSubagentsByTurn = new WeakMap<ThreadMessage, ReadonlyMap<string, SubagentDiscoverySnapshot>>();\n\n/**\n * The lane of every `task` call in one converted turn (a `ThreadMessage`, or the\n * message state assistant-ui publishes for it), keyed by tool-call id in call\n * order. Memoized per turn and per part.\n */\nexport function taskSubagentsOfTurn(\n  message: ThreadMessage\n): ReadonlyMap<string, SubagentDiscoverySnapshot> {\n  const cached = taskSubagentsByTurn.get(message);\n  if (cached !== undefined) return cached;\n  const lanes = new Map<string, SubagentDiscoverySnapshot>();\n  if (message.role === 'assistant') {\n    let toolMessages: Map<string, LangChainMessage> | null = null;\n    for (const part of message.content) {\n      if (part.type !== 'tool-call' || part.toolName !== TASK_TOOL_NAME) continue;\n      let lane = taskSubagentByPart.get(part);\n      if (lane === undefined) {\n        toolMessages ??= toolMessagesOfTurn(message);\n        lane = taskSubagent(part, toolMessages.get(part.toolCallId));\n        taskSubagentByPart.set(part, lane);\n      }\n      lanes.set(part.toolCallId, lane);\n    }\n  }\n  taskSubagentsByTurn.set(message, lanes);\n  return lanes;\n}\n\n/** The lane of every `task` call in a converted thread, in transcript order. */\nexport function taskSubagentsOfThread(\n  messages: readonly ThreadMessage[]\n): SubagentDiscoverySnapshot[] {\n  return messages.flatMap((message) => [...taskSubagentsOfTurn(message).values()]);\n}\n\n/**\n * Point a lane at an in-eval dispatch's live transcript, converted into a nested\n * thread, with the live fields it derives. Never regresses a known tool-call\n * count: a countless later event must not reset a lane to \"0 tool calls\".\n */\nfunction applyLaneTranscript(\n  snap: SubagentDiscoverySnapshot,\n  transcript: readonly LangChainMessage[]\n): void {\n  snap.messages = convertSubagentTranscript(transcript, snap.status === 'running');\n  snap.messageCount = transcript.length;\n  const derived = deriveTranscript(snap.messages);\n  if (derived.currentText) snap.currentText = derived.currentText;\n  if (derived.model) snap.model = derived.model;\n  if (derived.lastToolCall) snap.lastToolCall = derived.lastToolCall;\n  snap.toolCallCount = Math.max(snap.toolCallCount, derived.toolCallCount);\n  // An in-eval lane has no artifact todos channel: recover the plan from its\n  // `write_todos` calls.\n  snap.todos = snap.todos ?? derived.todos;\n}\n\n/**\n * The lanes of in-eval dispatches, from two sources: the *persisted* summaries\n * each finished `eval` ToolMessage carries in `artifact.ptc_subagents`\n * (terminal truth; the only source after a session reopen), then the *live*\n * `ptc_subagents` state channel (`ptcSubagents`) for dispatches still\n * streaming. A live entry never downgrades a terminal snapshot back to\n * `running` — a stale lifecycle entry whose terminal event was lost must not\n * resurrect a perpetually-running lane the persisted summary already settled.\n * A lane whose steps no longer ride but whose subagent checkpoint namespace is\n * recorded (`ns`) is `checkpointed`, and `history/lane {lane}` pages its\n * steps: a live entry a later run stripped to its summary, or a persisted\n * summary with no live entry (the registry died with the activation that\n * streamed it). A live entry speaks for its lane over the summary.\n */\nexport function deriveEvalSubagents(\n  messages: readonly LangChainMessage[],\n  ptcSubagents?: Record<string, PtcSubagentEntry>\n): Map<string, SubagentDiscoverySnapshot> {\n  const byDispatchId = new Map<string, SubagentDiscoverySnapshot>();\n  // Persisted in-eval dispatch summaries (terminal truth; survives reopen).\n  for (const m of messages) {\n    if (m.type !== 'tool' || m.name !== EVAL_TOOL_NAME) continue;\n    for (const entry of ptcSubagentsFromArtifact(m.artifact)) {\n      mergePtcSubagentEntry(byDispatchId, entry, {\n        // The eval ended when these summaries were written, so any lane the\n        // backend could not settle is a cancelled dispatch, never \"running\".\n        status: entry.status === 'complete' ? 'complete' : 'error',\n        fallbackEvalId: m.tool_call_id,\n      });\n      noteCheckpointedLane(byDispatchId.get(entry.id), entry);\n    }\n  }\n  // Live lifecycle entries (the only signal while an eval is still streaming).\n  if (ptcSubagents) {\n    for (const entry of Object.values(ptcSubagents)) {\n      if (!entry || typeof entry !== 'object' || typeof entry.id !== 'string' || !entry.id) {\n        continue;\n      }\n      // This activation's registry speaks for the lane: the steps it streams,\n      // else its own namespace, else nothing to page.\n      const existing = byDispatchId.get(entry.id);\n      if (existing?.source?.checkpointed === true) existing.source = undefined;\n      mergePtcSubagentEntry(byDispatchId, entry, {\n        status:\n          entry.status === 'complete'\n            ? 'complete'\n            : entry.status === 'error'\n              ? 'error'\n              : entry.status === 'queued'\n                ? 'queued'\n                : 'running',\n      });\n      noteCheckpointedLane(byDispatchId.get(entry.id), entry);\n    }\n  }\n  return byDispatchId;\n}\n\n/** Lifecycle progression order — a merge may only move a lane forward. */\nfunction subagentStatusRank(status: SubagentStatus): number {\n  if (status === 'queued') return 0;\n  if (status === 'running') return 1;\n  return 2;\n}\n\nfunction mergePtcSubagentEntry(\n  byDispatchId: Map<string, SubagentDiscoverySnapshot>,\n  entry: PtcSubagentEntry,\n  options: { status: SubagentStatus; fallbackEvalId?: string }\n): void {\n  const { status, fallbackEvalId } = options;\n  const existing = byDispatchId.get(entry.id);\n  if (existing) {\n    // A lane only ever moves FORWARD (queued → running → terminal): a stale\n    // entry whose later event was lost must not resurrect a running lane to\n    // queued or a finished lane to running — and a settled terminal outcome\n    // never flips to the other terminal (first settled source wins).\n    if (\n      status === existing.status ||\n      subagentStatusRank(status) > subagentStatusRank(existing.status)\n    ) {\n      existing.status = status;\n    }\n    const evalId = entry.eval_id ?? fallbackEvalId;\n    if (evalId) existing.evalId = evalId;\n    if (typeof entry.duration_ms === 'number') existing.durationMs = entry.duration_ms;\n    // A count only arrives on terminal events; never let a countless later\n    // event (or an older backend) regress a known count.\n    if (typeof entry.tool_call_count === 'number') {\n      existing.toolCallCount = Math.max(existing.toolCallCount, entry.tool_call_count);\n    }\n    if (Array.isArray(entry.messages) && entry.messages.length > 0) {\n      applyLaneTranscript(existing, entry.messages);\n    }\n    applyLaneCut(existing, entry);\n    applyLaneUsage(existing, entry);\n    // Prefer the real output (Athena's in-eval output bridge); fall back to the\n    // error string only when no (non-empty) output was captured. Same\n    // empty-string/nullish rule as the create branch below.\n    if (entry.output) existing.output = entry.output;\n    else if (entry.error && !existing.output) existing.output = entry.error;\n    return;\n  }\n  // `||` (not `??`) so an empty-string output falls back to the error, matching\n  // the merge branch's truthy check above.\n  const initialOutput = entry.output || entry.error;\n  const evalId = entry.eval_id ?? fallbackEvalId;\n  const created: SubagentDiscoverySnapshot = {\n    id: entry.id,\n    name: String(entry.subagent_type ?? 'subagent'),\n    description: entry.label ?? entry.description ?? '',\n    status,\n    toolCallCount: typeof entry.tool_call_count === 'number' ? entry.tool_call_count : 0,\n    messages: NO_TRANSCRIPT,\n    messageCount: 0,\n    currentText: '',\n    ...(evalId ? { evalId } : {}),\n    ...(typeof entry.duration_ms === 'number' ? { durationMs: entry.duration_ms } : {}),\n    ...(initialOutput ? { output: initialOutput } : {}),\n  };\n  if (Array.isArray(entry.messages) && entry.messages.length > 0) {\n    applyLaneTranscript(created, entry.messages);\n  }\n  applyLaneCut(created, entry);\n  applyLaneUsage(created, entry);\n  byDispatchId.set(entry.id, created);\n}\n\n/**\n * Where an in-eval dispatch's streamed steps ride, and what the wire left off\n * them, read off its entry's cut marker (`DEEP_AGENT_TRUNCATED_LANE_KEY`) as a\n * `task` card's is: the steps left off, and the whole lane's tool calls.\n */\nfunction applyLaneCut(snap: SubagentDiscoverySnapshot, entry: PtcSubagentEntry): void {\n  const lane = readTruncatedLane(entry);\n  if (Array.isArray(entry.messages) && entry.messages.length > 0) {\n    snap.source = {\n      lane: entry.id,\n      transcript: entry.messages,\n      ...(lane !== null && { truncated: lane }),\n    };\n  }\n  if (lane === null) return;\n  snap.omittedMessageCount = Math.max(0, lane.messages - snap.messageCount);\n  snap.toolCallCount = Math.max(snap.toolCallCount, lane.toolCalls);\n}\n\nconst NO_LANE_STEPS: readonly LangChainMessage[] = [];\n\n/**\n * An entry that recorded its subagent's checkpoint namespace (`ns`, a registry\n * entry or the summary an eval persisted, since agora writes it) pages its\n * lane from that checkpoint when no streamed steps carry it.\n */\nfunction noteCheckpointedLane(\n  snap: SubagentDiscoverySnapshot | undefined,\n  entry: PtcSubagentEntry\n): void {\n  if (snap === undefined || snap.source !== undefined) return;\n  if (typeof entry.ns !== 'string' || !entry.ns) return;\n  snap.source = { lane: entry.id, transcript: NO_LANE_STEPS, checkpointed: true };\n}\n\n/**\n * An in-eval lane's token use, from its entry's host total or the native steps\n * of its live transcript. A merge that brings neither keeps what the lane has.\n */\nfunction applyLaneUsage(snap: SubagentDiscoverySnapshot, entry: PtcSubagentEntry): void {\n  const usage = laneTokenUsage(\n    entry,\n    transcriptStepUsage(snap.messages),\n    snap.status,\n    (snap.omittedMessageCount ?? 0) > 0\n  );\n  if (usage !== undefined) snap.usage = usage;\n}\n\n/**\n * The first call of a nested thread with one of `toolCallIds`: the calls a\n * subagent made are the tool-call parts of its transcript, ids included.\n */\nfunction findToolCall({\n  messages,\n  toolCallIds,\n}: {\n  messages: readonly ThreadMessage[] | undefined;\n  toolCallIds: ReadonlySet<string>;\n}): ToolCallMessagePart | undefined {\n  if (messages === undefined) return undefined;\n  for (const message of messages) {\n    if (message.role !== 'assistant') continue;\n    for (const part of message.content) {\n      if (part.type === 'tool-call' && toolCallIds.has(part.toolCallId)) return part;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Whether a subagent lane waits on a person's approval, given the gated calls\n * still waiting on one (`toolCallIdsAwaitingApproval`): its own dispatch is the\n * gated call (a per-dispatch `task` gate), or a call it made is (a gated tool\n * raised inside the delegated subagent). The approval names the gated call's\n * `tool_call_id` and never the lane, and a lane's transcript carries the calls\n * it made with their ids, so the call id is the join. A settled lane waits on\n * nobody.\n */\nexport function subagentAwaitingApproval({\n  lane,\n  toolCallIds,\n}: {\n  lane: Pick<SubagentDiscoverySnapshot, 'id' | 'status' | 'messages'>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): boolean {\n  if (toolCallIds.size === 0 || isTerminalSubagentStatus(lane.status)) return false;\n  return (\n    toolCallIds.has(lane.id) ||\n    findToolCall({ messages: lane.messages, toolCallIds }) !== undefined\n  );\n}\n\n/**\n * The call a subagent made that waits on a person's approval (a gated tool\n * raised inside the delegated subagent), read off its transcript — what the\n * lane card names while it waits. `undefined` when the lane made none, which\n * includes a lane whose own dispatch is the gated call.\n */\nexport function subagentToolCallAwaitingApproval({\n  lane,\n  toolCallIds,\n}: {\n  lane: Pick<SubagentDiscoverySnapshot, 'status' | 'messages'>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): LangChainToolCall | undefined {\n  if (toolCallIds.size === 0 || isTerminalSubagentStatus(lane.status)) return undefined;\n  const part = findToolCall({ messages: lane.messages, toolCallIds });\n  return part === undefined\n    ? undefined\n    : { id: part.toolCallId, name: part.toolName, args: part.args };\n}\n\n/** What {@link subagentLanesHoldingUnseenApproval} finds: the lanes, and the call if one holds it. */\nexport interface UnseenApprovalLanes {\n  /** The lanes holding a gated call none of their transcripts shows. */\n  laneIds: ReadonlySet<string>;\n  /**\n   * The gated call, when exactly one lane holds exactly one such call. With\n   * several candidate lanes the approval holds them all (the run is parked, so\n   * none of them runs), but which one made the call is unknown.\n   */\n  gatedCallId: string | undefined;\n}\n\nconst NO_UNSEEN_APPROVAL_LANES: UnseenApprovalLanes = {\n  laneIds: new Set(),\n  gatedCallId: undefined,\n};\n\n/**\n * The lanes of one turn that wait on a gated call no transcript shows. The\n * approval names a call raised inside a delegated subagent by its\n * `tool_call_id`, and the lane's transcript is what joins the two\n * ({@link subagentAwaitingApproval}). But a lane's steps ride only on the\n * backend's running placeholder, which is never checkpointed: a conversation\n * opened after its run parked (a reload, another device, a handover) shows the\n * lane with no steps at all, and the join finds nothing. A gated call that is\n * none of the turn's own calls and is in no lane's transcript was raised inside\n * one of the turn's unsettled lanes whose steps did not ride.\n *\n * Pass only the lanes of the turn the run is on now (the thread's newest\n * message, running or waiting on a person): an earlier turn's unsettled lane\n * was stopped, not parked, though its status still reads `requires-action`.\n */\nexport function subagentLanesHoldingUnseenApproval({\n  lanes,\n  turnToolCallIds,\n  toolCallIds,\n}: {\n  lanes: readonly Pick<SubagentDiscoverySnapshot, 'id' | 'status' | 'messages'>[];\n  /** Every tool-call id of the turn itself (its `task` calls included). */\n  turnToolCallIds: ReadonlySet<string>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): UnseenApprovalLanes {\n  if (toolCallIds.size === 0) return NO_UNSEEN_APPROVAL_LANES;\n  const shown = new Set<string>();\n  for (const lane of lanes) {\n    for (const message of lane.messages) {\n      if (message.role !== 'assistant') continue;\n      for (const part of message.content) {\n        if (part.type === 'tool-call' && toolCallIds.has(part.toolCallId)) {\n          shown.add(part.toolCallId);\n        }\n      }\n    }\n  }\n  const unseen: string[] = [...toolCallIds].filter(\n    (id) => !turnToolCallIds.has(id) && !shown.has(id)\n  );\n  if (unseen.length === 0) return NO_UNSEEN_APPROVAL_LANES;\n  const holders = lanes.filter(\n    (lane) => !isTerminalSubagentStatus(lane.status) && lane.messages.length === 0\n  );\n  if (holders.length === 0) return NO_UNSEEN_APPROVAL_LANES;\n  return {\n    laneIds: new Set(holders.map((lane) => lane.id)),\n    gatedCallId: holders.length === 1 && unseen.length === 1 ? unseen[0] : undefined,\n  };\n}\n\n/**\n * Every tool-call id of the turn the run is on now, else `undefined`: the\n * thread's newest message, still running or waiting on a person. An earlier\n * turn keeps `requires-action` for a call that never got its result (a stopped\n * run's lane), so its status alone never says it owns the run's approval.\n * Pass it to {@link subagentLanesHoldingUnseenApproval} as `turnToolCallIds`.\n */\nexport function openTurnToolCallIds(\n  message: Pick<ThreadMessage, 'role' | 'content' | 'status'> & { isLast: boolean }\n): ReadonlySet<string> | undefined {\n  if (message.role !== 'assistant' || !message.isLast) return undefined;\n  const status = message.status?.type;\n  if (status !== 'running' && status !== 'requires-action') return undefined;\n  const ids = new Set<string>();\n  for (const part of message.content) {\n    if (part.type === 'tool-call') ids.add(part.toolCallId);\n  }\n  return ids;\n}\n\n/**\n * What a subagent lane parked on a person's approval reads in every app (the\n * lane's status, where it would say Running or Queued).\n */\nexport const SUBAGENT_AWAITING_APPROVAL_LABEL = 'Waiting for approval';\n\n/** What a lane waits on, from {@link subagentLaneApprovalWait}. */\nexport interface SubagentLaneApprovalWait {\n  /** The lane is parked on an approval: its own dispatch or a call it made is the gated call. */\n  awaitingApproval: boolean;\n  /** The call inside the lane the approval gates, when it is known. */\n  gatedCall: LangChainToolCall | undefined;\n  /** The approval gates a call the lane made that its card cannot show (its steps did not ride). */\n  insideLane?: boolean;\n}\n\nconst NOT_AWAITING_APPROVAL: SubagentLaneApprovalWait = {\n  awaitingApproval: false,\n  gatedCall: undefined,\n};\n\n/**\n * Whether a lane waits on a person's approval, and on what: the call it made,\n * read off its transcript; or, for a lane whose steps did not ride (a\n * conversation opened after its run parked: {@link\n * subagentLanesHoldingUnseenApproval}), the call the approval names when this\n * lane alone can hold it, else only that it waits on a call it made. A lane\n * whose own dispatch is the gated call waits with no `gatedCall`.\n */\nexport function subagentLaneApprovalWait({\n  lane,\n  toolCallIds,\n  unseenApproval,\n  actionRequests,\n}: {\n  lane: Pick<SubagentDiscoverySnapshot, 'id' | 'status' | 'messages'>;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n  /** The open turn's step-less lanes holding a gated call, when the lane is on that turn. */\n  unseenApproval: UnseenApprovalLanes | undefined;\n  /** The parked approval's gated calls, which name an unseen call's tool and arguments. */\n  actionRequests: readonly Pick<PendingActionRequest, 'toolCallId' | 'name' | 'args'>[] | undefined;\n}): SubagentLaneApprovalWait {\n  const unseen: boolean =\n    !isTerminalSubagentStatus(lane.status) && unseenApproval?.laneIds.has(lane.id) === true;\n  if (!subagentAwaitingApproval({ lane, toolCallIds }) && !unseen) return NOT_AWAITING_APPROVAL;\n  const shown = subagentToolCallAwaitingApproval({ lane, toolCallIds });\n  if (shown !== undefined || !unseen) return { awaitingApproval: true, gatedCall: shown };\n  const gatedCallId: string | undefined = unseenApproval?.gatedCallId;\n  const request = gatedCallId\n    ? actionRequests?.find((candidate) => candidate.toolCallId === gatedCallId)\n    : undefined;\n  return {\n    awaitingApproval: true,\n    gatedCall:\n      request && gatedCallId\n        ? // The approval's args crossed the wire as JSON, as a call's own do.\n          { id: gatedCallId, name: request.name, args: request.args as LangChainToolCall['args'] }\n        : undefined,\n    insideLane: true,\n  };\n}\n\n/**\n * Whether the lane of the `task` call `toolCallId` in this turn waits on a\n * person's approval, and on what ({@link subagentLaneApprovalWait}), for a\n * card that shows one lane (the SDK's, the phone's). The lanes are the turn's\n * own; a lane's steps are its converted `messages`, else (a host that doesn't\n * convert them, like the phone) the transcript its running placeholder\n * carries. On the turn the run is on now ({@link openTurnToolCallIds}), a\n * gated call no lane shows is held by its step-less lanes\n * ({@link subagentLanesHoldingUnseenApproval}), so a conversation opened after\n * its run parked still reads as waiting for approval.\n */\nexport function turnLaneApprovalWait({\n  message,\n  toolCallId,\n  toolCallIds,\n  actionRequests,\n}: {\n  message: ThreadMessage & { isLast: boolean };\n  toolCallId: string;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n  /** The parked approval's gated calls, which name an unseen call's tool and arguments. */\n  actionRequests: readonly Pick<PendingActionRequest, 'toolCallId' | 'name' | 'args'>[] | undefined;\n}): SubagentLaneApprovalWait {\n  if (toolCallIds.size === 0 || message.role !== 'assistant') return NOT_AWAITING_APPROVAL;\n  const artifacts = new Map<string, unknown>();\n  for (const part of message.content) {\n    if (part.type === 'tool-call' && part.toolName === TASK_TOOL_NAME) {\n      artifacts.set(part.toolCallId, part.artifact);\n    }\n  }\n  const lanes = [...taskSubagentsOfTurn(message).values()].map((lane) => {\n    if (lane.messages.length > 0) return lane;\n    const carried = nestedMessagesFromArtifact(artifacts.get(lane.id));\n    return carried.length === 0\n      ? lane\n      : { ...lane, messages: convertSubagentTranscript(carried, lane.status === 'running') };\n  });\n  const lane = lanes.find((candidate) => candidate.id === toolCallId);\n  if (lane === undefined) return NOT_AWAITING_APPROVAL;\n  const turnToolCallIds = openTurnToolCallIds(message);\n  return subagentLaneApprovalWait({\n    lane,\n    toolCallIds,\n    unseenApproval:\n      turnToolCallIds === undefined\n        ? undefined\n        : subagentLanesHoldingUnseenApproval({ lanes, turnToolCallIds, toolCallIds }),\n    actionRequests,\n  });\n}\n\n/**\n * What a lane waiting for approval says it waits on, in every app: a call it\n * made (\"Needs approval to run\", then the call), a call it made that its card\n * cannot name (\"Needs approval to continue\"), or its own dispatch (\"Needs\n * approval to start\").\n */\nexport function subagentApprovalNoteLabel({\n  gatedCall,\n  insideLane = false,\n}: Pick<SubagentLaneApprovalWait, 'gatedCall' | 'insideLane'>): string {\n  if (gatedCall !== undefined) return 'Needs approval to run';\n  return insideLane ? 'Needs approval to continue' : 'Needs approval to start';\n}\n\n/**\n * The calls of one converted turn that wait on a person's approval, in turn\n * order: a gated call of the turn itself, or a `task` call not yet settled\n * (no result, or the running placeholder) whose lane holds a gated call — the\n * steps the turn's step list reads as waiting rather than running or done.\n */\nexport function turnToolCallsAwaitingApproval({\n  message,\n  toolCallIds,\n}: {\n  message: ThreadMessage;\n  /** The gated calls still waiting on a decision (`toolCallIdsAwaitingApproval`). */\n  toolCallIds: ReadonlySet<string>;\n}): string[] {\n  if (toolCallIds.size === 0 || message.role !== 'assistant') return [];\n  const ids: string[] = [];\n  for (const part of message.content) {\n    if (part.type !== 'tool-call') continue;\n    if (toolCallIds.has(part.toolCallId)) {\n      ids.push(part.toolCallId);\n      continue;\n    }\n    if (part.toolName !== TASK_TOOL_NAME) continue;\n    const settled = part.result !== undefined && part.isPreliminary !== true;\n    if (!settled && findToolCall({ messages: part.messages, toolCallIds }) !== undefined) {\n      ids.push(part.toolCallId);\n    }\n  }\n  return ids;\n}\n\nconst NO_WAITING_TOOL_CALLS: ReadonlySet<string> = new Set();\n/** Joins call ids into one selector value; an id never holds it. */\nconst TOOL_CALL_ID_SEPARATOR = '\\n';\n\n/**\n * {@link turnToolCallsAwaitingApproval} for the message in scope: what a\n * turn's step list takes as `waitingToolCallIds`, given the run's waiting\n * calls (`toolCallIdsAwaitingApproval`). Selected as a joined string, so a\n * streamed token re-renders the caller only when the waiting steps change, and\n * the set keeps its identity while they do not. Olympus's activity card and\n * the SDK chat's turns both read it.\n */\nexport function useTurnToolCallsAwaitingApproval(\n  toolCallIds: ReadonlySet<string>\n): ReadonlySet<string> {\n  const key = useAuiState((s) =>\n    toolCallIds.size === 0\n      ? ''\n      : turnToolCallsAwaitingApproval({ message: s.message, toolCallIds }).join(\n          TOOL_CALL_ID_SEPARATOR\n        )\n  );\n  return useMemo(\n    () => (key === '' ? NO_WAITING_TOOL_CALLS : new Set(key.split(TOOL_CALL_ID_SEPARATOR))),\n    [key]\n  );\n}\n\n/** Result text shown for a dispatch whose owning run ended before it finished. */\nexport const ORPHANED_SUBAGENT_OUTPUT =\n  'Interrupted — the run that dispatched this subagent ended before it finished.';\n\n/**\n * Settle snapshots orphaned by their dispatching context: once the owner (e.g.\n * the `eval` tool call whose in-eval `task()` issued them) is itself terminal,\n * nothing can ever deliver a `complete`/`error` lifecycle event for a lane still\n * `queued`/`running` — the dispatch coroutines were cancelled with the eval. Those\n * lanes are coerced to `error` with an interruption message so the UI can't show\n * perpetual \"Running · no activity\" ghosts. Returns the input array unchanged\n * (same reference) when there is nothing to settle.\n */\nexport function finalizeOrphanedSubagents(\n  snapshots: readonly SubagentDiscoverySnapshot[],\n  ownerTerminal: boolean\n): readonly SubagentDiscoverySnapshot[] {\n  if (!ownerTerminal || snapshots.every((s) => isTerminalSubagentStatus(s.status))) {\n    return snapshots;\n  }\n  return snapshots.map((s) =>\n    isTerminalSubagentStatus(s.status)\n      ? s\n      : { ...s, status: 'error', output: s.output || ORPHANED_SUBAGENT_OUTPUT }\n  );\n}\n\n/**\n * The `task` tool calls sharing `toolCallId`'s parent AI message — the parallel\n * fan-out siblings, in declaration order. Parallel `task` calls always live on ONE\n * AI message's `tool_calls`, so \"same parent message\" IS the parallelism boundary;\n * sequential delegations sit on separate AI messages and form singleton groups.\n * The FIRST sibling is the group's `anchorId`: its tool-part render draws the whole\n * side-by-side group and the other siblings render nothing, keeping the layout\n * change fully inside the `task` tool UI. Falls back to a singleton group when the\n * parent AI message isn't among `messages` (a turn's bound sources, or a raw\n * transcript).\n */\nexport interface TaskSiblingGroup {\n  /** Sibling `task` tool-call ids in declaration order. */\n  ids: string[];\n  /** The first sibling — the one tool-part render that owns the group's UI. */\n  anchorId: string;\n}\n\nexport function taskSiblingGroup(\n  messages: readonly LangChainMessage[],\n  toolCallId: string\n): TaskSiblingGroup {\n  for (const m of messages) {\n    if (m.type !== 'ai' || !m.tool_calls) continue;\n    if (!m.tool_calls.some((tc) => tc.id === toolCallId)) continue;\n    const ids = m.tool_calls\n      .filter((tc) => tc.name === TASK_TOOL_NAME && tc.id)\n      .map((tc) => tc.id as string);\n    if (ids.length > 0) return { ids, anchorId: ids[0] ?? toolCallId };\n    break;\n  }\n  return { ids: [toolCallId], anchorId: toolCallId };\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/thread-extras.cjs

@@ -1,38 +1,46 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const statewireHeldSends = require("./statewire-held-sends.cjs");
 function hasStatewireThreadExtras(extras) {
   if (!extras || typeof extras !== "object") return false;
   const candidate = extras;
   return typeof candidate.sendCommand === "function" && Array.isArray(candidate.inputRequests) && typeof candidate.runs === "object" && candidate.runs !== null;
 }
-function isFailedSendEntry(value) {
+function readStatewireFailedSends(extras) {
   var _a;
-  if (!value || typeof value !== "object") return false;
-  const entry = value;
-  return typeof entry.id === "string" && typeof ((_a = entry.sendFailure) == null ? void 0 : _a.fate) === "string";
+  if (!extras || typeof extras !== "object") return [];
+  const held = (_a = extras.runs) == null ? void 0 : _a.held;
+  if (!Array.isArray(held)) return [];
+  return held.flatMap((entry) => {
+    const candidate = entry;
+    if (typeof (candidate == null ? void 0 : candidate.id) !== "string" || !Array.isArray(candidate.parts)) return [];
+    const sendFailure = statewireHeldSends.heldSendFailure(candidate.localMeta);
+    return sendFailure === void 0 ? [] : [{ ...candidate, sendFailure }];
+  });
+}
+function failedActionsOf(extras) {
+  const outbox = statewireHeldSends.readStatewireOutbox(extras);
+  if (outbox === null) return null;
+  return {
+    retryFailed: (messageId) => statewireHeldSends.retryHeldRunSend({ outbox, messageId, thread: statewireHeldSends.runSendThreadOfExtras(extras) }),
+    discardFailed: (messageId) => statewireHeldSends.discardHeldRunSend({ outbox, messageId })
+  };
 }
 function readStatewireFailedSendLane(extras) {
-  var _a;
-  if (!extras || typeof extras !== "object") return null;
-  const candidate = extras;
-  const failed = (_a = candidate.runs) == null ? void 0 : _a.failed;
-  if (!Array.isArray(failed) || typeof candidate.retryFailed !== "function") return null;
+  const actions = failedActionsOf(extras);
+  if (actions === null) return null;
   return {
-    failed: failed.filter(isFailedSendEntry),
-    retryFailed: candidate.retryFailed
+    failed: readStatewireFailedSends(extras).map(({ id, sendFailure }) => ({ id, sendFailure })),
+    retryFailed: actions.retryFailed
   };
 }
 function requireStatewireFailedActions(extras) {
-  if (!extras || typeof extras !== "object") {
-    throw new Error("Failed-send actions require a Statewire thread");
-  }
-  const candidate = extras;
-  if (typeof candidate.retryFailed !== "function" || typeof candidate.discardFailed !== "function") {
-    throw new Error("Failed-send actions require a Statewire thread");
-  }
-  return candidate;
+  const actions = failedActionsOf(extras);
+  if (actions === null) throw new Error("Failed-send actions require a Statewire thread");
+  return actions;
 }
 exports.hasStatewireThreadExtras = hasStatewireThreadExtras;
 exports.readStatewireFailedSendLane = readStatewireFailedSendLane;
+exports.readStatewireFailedSends = readStatewireFailedSends;
 exports.requireStatewireFailedActions = requireStatewireFailedActions;
 //# sourceMappingURL=thread-extras.cjs.map

package/dist/agent-runtime/src/thread-extras.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"thread-extras.cjs","sources":["../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One projected failed run send: the message id plus the failure that\n * retained it (`runs.failed` entry, structurally). */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** The failed-send lane surface the send-recovery controller consumes. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Re-dispatches the entry against the current thread — same message id,\n   * re-anchored — and removes it from the lane. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\nfunction isFailedSendEntry(value: unknown): value is StatewireFailedSendEntry {\n  if (!value || typeof value !== 'object') return false;\n  const entry = value as { id?: unknown; sendFailure?: { fate?: unknown } };\n  return typeof entry.id === 'string' && typeof entry.sendFailure?.fate === 'string';\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  if (!extras || typeof extras !== 'object') return null;\n  const candidate = extras as {\n    runs?: { failed?: unknown };\n    retryFailed?: unknown;\n  };\n  const failed = candidate.runs?.failed;\n  if (!Array.isArray(failed) || typeof candidate.retryFailed !== 'function') return null;\n  return {\n    failed: failed.filter(isFailedSendEntry),\n    retryFailed: candidate.retryFailed as StatewireFailedSendLane['retryFailed'],\n  };\n}\n\n/** The failed-send lane actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  if (!extras || typeof extras !== 'object') {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  const candidate = extras as Record<string, unknown>;\n  if (\n    typeof candidate.retryFailed !== 'function' ||\n    typeof candidate.discardFailed !== 'function'\n  ) {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  return candidate as unknown as StatewireFailedActions;\n}\n"],"names":[],"mappings":";;AAQO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA+BA,SAAS,kBAAkB,OAAmD;;AAC5E,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SAAO,OAAO,MAAM,OAAO,YAAY,SAAO,WAAM,gBAAN,mBAAmB,UAAS;AAC5E;AAOO,SAAS,4BAA4B,QAAiD;;AAC3F,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAIlB,QAAM,UAAS,eAAU,SAAV,mBAAgB;AAC/B,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,UAAU,gBAAgB,WAAY,QAAO;AAClF,SAAO;AAAA,IACL,QAAQ,OAAO,OAAO,iBAAiB;AAAA,IACvC,aAAa,UAAU;AAAA,EAAA;AAE3B;AAGO,SAAS,8BAA8B,QAAyC;AACrF,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY;AAClB,MACE,OAAO,UAAU,gBAAgB,cACjC,OAAO,UAAU,kBAAkB,YACnC;AACA,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;;;;"}
+{"version":3,"file":"thread-extras.cjs","sources":["../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport {\n  type DeepAgentSendFailure,\n  discardHeldRunSend,\n  readStatewireOutbox,\n  heldSendFailure,\n  retryHeldRunSend,\n  runSendThreadOfExtras,\n} from './statewire-held-sends';\n\n/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One failed run send: the message id plus the failure its held outbox entry carries. */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    cause?: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** A failed run send as a surface renders it: the held message plus its failure. */\nexport type StatewireFailedSend = StatewireThread.RunsHeldEntry & {\n  readonly sendFailure: DeepAgentSendFailure;\n};\n\n/** The failed sends and the retry the send-recovery controller and the queue tray consume. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Sends the held entry again — same message id, re-anchored — and clears\n   * its failure. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\n/**\n * The failed run sends off a statewire thread's extras: the `runs.held`\n * entries whose outbox entry was held for a failure (`localMeta.error`, see\n * `statewire-held-sends.ts`), in queue order. Empty when the extras are not a\n * statewire thread's.\n */\nexport function readStatewireFailedSends(extras: unknown): StatewireFailedSend[] {\n  if (!extras || typeof extras !== 'object') return [];\n  const held = (extras as { runs?: { held?: unknown } }).runs?.held;\n  if (!Array.isArray(held)) return [];\n  return held.flatMap((entry: unknown): StatewireFailedSend[] => {\n    const candidate = entry as Partial<StatewireThread.RunsHeldEntry> | null;\n    if (typeof candidate?.id !== 'string' || !Array.isArray(candidate.parts)) return [];\n    const sendFailure = heldSendFailure(candidate.localMeta);\n    return sendFailure === undefined\n      ? []\n      : [{ ...(candidate as StatewireThread.RunsHeldEntry), sendFailure }];\n  });\n}\n\nfunction failedActionsOf(extras: unknown): StatewireFailedActions | null {\n  const outbox = readStatewireOutbox(extras);\n  if (outbox === null) return null;\n  return {\n    retryFailed: (messageId) =>\n      retryHeldRunSend({ outbox, messageId, thread: runSendThreadOfExtras(extras) }),\n    discardFailed: (messageId) => discardHeldRunSend({ outbox, messageId }),\n  };\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  const actions = failedActionsOf(extras);\n  if (actions === null) return null;\n  return {\n    failed: readStatewireFailedSends(extras).map(({ id, sendFailure }) => ({ id, sendFailure })),\n    retryFailed: actions.retryFailed,\n  };\n}\n\n/** The failed-send actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  const actions = failedActionsOf(extras);\n  if (actions === null) throw new Error('Failed-send actions require a Statewire thread');\n  return actions;\n}\n"],"names":["heldSendFailure","readStatewireOutbox","retryHeldRunSend","runSendThreadOfExtras","discardHeldRunSend"],"mappings":";;;AAkBO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA0CO,SAAS,yBAAyB,QAAwC;;AAC/E,MAAI,CAAC,UAAU,OAAO,WAAW,iBAAiB,CAAA;AAClD,QAAM,QAAQ,YAAyC,SAAzC,mBAA+C;AAC7D,MAAI,CAAC,MAAM,QAAQ,IAAI,UAAU,CAAA;AACjC,SAAO,KAAK,QAAQ,CAAC,UAA0C;AAC7D,UAAM,YAAY;AAClB,QAAI,QAAO,uCAAW,QAAO,YAAY,CAAC,MAAM,QAAQ,UAAU,KAAK,EAAG,QAAO,CAAA;AACjF,UAAM,cAAcA,mBAAAA,gBAAgB,UAAU,SAAS;AACvD,WAAO,gBAAgB,SACnB,CAAA,IACA,CAAC,EAAE,GAAI,WAA6C,aAAa;AAAA,EACvE,CAAC;AACH;AAEA,SAAS,gBAAgB,QAAgD;AACvE,QAAM,SAASC,mBAAAA,oBAAoB,MAAM;AACzC,MAAI,WAAW,KAAM,QAAO;AAC5B,SAAO;AAAA,IACL,aAAa,CAAC,cACZC,mBAAAA,iBAAiB,EAAE,QAAQ,WAAW,QAAQC,mBAAAA,sBAAsB,MAAM,GAAG;AAAA,IAC/E,eAAe,CAAC,cAAcC,mBAAAA,mBAAmB,EAAE,QAAQ,WAAW;AAAA,EAAA;AAE1E;AAOO,SAAS,4BAA4B,QAAiD;AAC3F,QAAM,UAAU,gBAAgB,MAAM;AACtC,MAAI,YAAY,KAAM,QAAO;AAC7B,SAAO;AAAA,IACL,QAAQ,yBAAyB,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,mBAAmB,EAAE,IAAI,cAAc;AAAA,IAC3F,aAAa,QAAQ;AAAA,EAAA;AAEzB;AAGO,SAAS,8BAA8B,QAAyC;AACrF,QAAM,UAAU,gBAAgB,MAAM;AACtC,MAAI,YAAY,KAAM,OAAM,IAAI,MAAM,gDAAgD;AACtF,SAAO;AACT;;;;;"}

package/dist/agent-runtime/src/thread-extras.d.ts

@@ -1,3 +1,5 @@
+import type { StatewireThread } from '@assistant-ui/react-statewire';
+import { type DeepAgentSendFailure } from './statewire-held-sends';
 /**
  * The statewire hooks read the NEAREST aui thread's extras and throw when those
  * aren't statewire extras — which is the case inside nested read-only runtimes
@@ -11,12 +13,12 @@ export interface StatewireFailedActions {
     retryFailed: (messageId: string) => void;
     discardFailed: (messageId: string) => void;
 }
-/** One projected failed run send: the message id plus the failure that
- * retained it (`runs.failed` entry, structurally). */
+/** One failed run send: the message id plus the failure its held outbox entry carries. */
 export interface StatewireFailedSendEntry {
     id: string;
     sendFailure: {
         fate: string;
+        cause?: string;
         /**
          * Set on an `aborted` send that was never attempted because an earlier
          * send in the same detach batch WAS attempted and settled `lost`: the
@@ -26,18 +28,29 @@ export interface StatewireFailedSendEntry {
         predecessorLost?: boolean;
     };
 }
-/** The failed-send lane surface the send-recovery controller consumes. */
+/** A failed run send as a surface renders it: the held message plus its failure. */
+export type StatewireFailedSend = StatewireThread.RunsHeldEntry & {
+    readonly sendFailure: DeepAgentSendFailure;
+};
+/** The failed sends and the retry the send-recovery controller and the queue tray consume. */
 export interface StatewireFailedSendLane {
     failed: readonly StatewireFailedSendEntry[];
-    /** Re-dispatches the entry against the current thread — same message id,
-     * re-anchored — and removes it from the lane. Throws for unknown ids. */
+    /** Sends the held entry again — same message id, re-anchored — and clears
+     * its failure. Throws for unknown ids. */
     retryFailed: (messageId: string) => void;
 }
+/**
+ * The failed run sends off a statewire thread's extras: the `runs.held`
+ * entries whose outbox entry was held for a failure (`localMeta.error`, see
+ * `statewire-held-sends.ts`), in queue order. Empty when the extras are not a
+ * statewire thread's.
+ */
+export declare function readStatewireFailedSends(extras: unknown): StatewireFailedSend[];
 /**
  * The failed-send lane off a statewire thread's extras, or `null` when the
  * extras are not a statewire thread's (nested read-only runtimes, legacy
  * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.
  */
 export declare function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null;
-/** The failed-send lane actions off a statewire thread's extras, or throw. */
+/** The failed-send actions off a statewire thread's extras, or throw. */
 export declare function requireStatewireFailedActions(extras: unknown): StatewireFailedActions;

package/dist/agent-runtime/src/thread-extras.js

@@ -1,38 +1,46 @@
+import { heldSendFailure, readStatewireOutbox, discardHeldRunSend, retryHeldRunSend, runSendThreadOfExtras } from "./statewire-held-sends.js";
 function hasStatewireThreadExtras(extras) {
   if (!extras || typeof extras !== "object") return false;
   const candidate = extras;
   return typeof candidate.sendCommand === "function" && Array.isArray(candidate.inputRequests) && typeof candidate.runs === "object" && candidate.runs !== null;
 }
-function isFailedSendEntry(value) {
+function readStatewireFailedSends(extras) {
   var _a;
-  if (!value || typeof value !== "object") return false;
-  const entry = value;
-  return typeof entry.id === "string" && typeof ((_a = entry.sendFailure) == null ? void 0 : _a.fate) === "string";
+  if (!extras || typeof extras !== "object") return [];
+  const held = (_a = extras.runs) == null ? void 0 : _a.held;
+  if (!Array.isArray(held)) return [];
+  return held.flatMap((entry) => {
+    const candidate = entry;
+    if (typeof (candidate == null ? void 0 : candidate.id) !== "string" || !Array.isArray(candidate.parts)) return [];
+    const sendFailure = heldSendFailure(candidate.localMeta);
+    return sendFailure === void 0 ? [] : [{ ...candidate, sendFailure }];
+  });
+}
+function failedActionsOf(extras) {
+  const outbox = readStatewireOutbox(extras);
+  if (outbox === null) return null;
+  return {
+    retryFailed: (messageId) => retryHeldRunSend({ outbox, messageId, thread: runSendThreadOfExtras(extras) }),
+    discardFailed: (messageId) => discardHeldRunSend({ outbox, messageId })
+  };
 }
 function readStatewireFailedSendLane(extras) {
-  var _a;
-  if (!extras || typeof extras !== "object") return null;
-  const candidate = extras;
-  const failed = (_a = candidate.runs) == null ? void 0 : _a.failed;
-  if (!Array.isArray(failed) || typeof candidate.retryFailed !== "function") return null;
+  const actions = failedActionsOf(extras);
+  if (actions === null) return null;
   return {
-    failed: failed.filter(isFailedSendEntry),
-    retryFailed: candidate.retryFailed
+    failed: readStatewireFailedSends(extras).map(({ id, sendFailure }) => ({ id, sendFailure })),
+    retryFailed: actions.retryFailed
   };
 }
 function requireStatewireFailedActions(extras) {
-  if (!extras || typeof extras !== "object") {
-    throw new Error("Failed-send actions require a Statewire thread");
-  }
-  const candidate = extras;
-  if (typeof candidate.retryFailed !== "function" || typeof candidate.discardFailed !== "function") {
-    throw new Error("Failed-send actions require a Statewire thread");
-  }
-  return candidate;
+  const actions = failedActionsOf(extras);
+  if (actions === null) throw new Error("Failed-send actions require a Statewire thread");
+  return actions;
 }
 export {
   hasStatewireThreadExtras,
   readStatewireFailedSendLane,
+  readStatewireFailedSends,
   requireStatewireFailedActions
 };
 //# sourceMappingURL=thread-extras.js.map

package/dist/agent-runtime/src/thread-extras.js.map

@@ -1 +1 @@
-{"version":3,"file":"thread-extras.js","sources":["../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One projected failed run send: the message id plus the failure that\n * retained it (`runs.failed` entry, structurally). */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** The failed-send lane surface the send-recovery controller consumes. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Re-dispatches the entry against the current thread — same message id,\n   * re-anchored — and removes it from the lane. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\nfunction isFailedSendEntry(value: unknown): value is StatewireFailedSendEntry {\n  if (!value || typeof value !== 'object') return false;\n  const entry = value as { id?: unknown; sendFailure?: { fate?: unknown } };\n  return typeof entry.id === 'string' && typeof entry.sendFailure?.fate === 'string';\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  if (!extras || typeof extras !== 'object') return null;\n  const candidate = extras as {\n    runs?: { failed?: unknown };\n    retryFailed?: unknown;\n  };\n  const failed = candidate.runs?.failed;\n  if (!Array.isArray(failed) || typeof candidate.retryFailed !== 'function') return null;\n  return {\n    failed: failed.filter(isFailedSendEntry),\n    retryFailed: candidate.retryFailed as StatewireFailedSendLane['retryFailed'],\n  };\n}\n\n/** The failed-send lane actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  if (!extras || typeof extras !== 'object') {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  const candidate = extras as Record<string, unknown>;\n  if (\n    typeof candidate.retryFailed !== 'function' ||\n    typeof candidate.discardFailed !== 'function'\n  ) {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  return candidate as unknown as StatewireFailedActions;\n}\n"],"names":[],"mappings":"AAQO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA+BA,SAAS,kBAAkB,OAAmD;AAxCvE;AAyCL,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SAAO,OAAO,MAAM,OAAO,YAAY,SAAO,WAAM,gBAAN,mBAAmB,UAAS;AAC5E;AAOO,SAAS,4BAA4B,QAAiD;AAnDtF;AAoDL,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAIlB,QAAM,UAAS,eAAU,SAAV,mBAAgB;AAC/B,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,UAAU,gBAAgB,WAAY,QAAO;AAClF,SAAO;AAAA,IACL,QAAQ,OAAO,OAAO,iBAAiB;AAAA,IACvC,aAAa,UAAU;AAAA,EAAA;AAE3B;AAGO,SAAS,8BAA8B,QAAyC;AACrF,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY;AAClB,MACE,OAAO,UAAU,gBAAgB,cACjC,OAAO,UAAU,kBAAkB,YACnC;AACA,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;"}
+{"version":3,"file":"thread-extras.js","sources":["../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport {\n  type DeepAgentSendFailure,\n  discardHeldRunSend,\n  readStatewireOutbox,\n  heldSendFailure,\n  retryHeldRunSend,\n  runSendThreadOfExtras,\n} from './statewire-held-sends';\n\n/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One failed run send: the message id plus the failure its held outbox entry carries. */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    cause?: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** A failed run send as a surface renders it: the held message plus its failure. */\nexport type StatewireFailedSend = StatewireThread.RunsHeldEntry & {\n  readonly sendFailure: DeepAgentSendFailure;\n};\n\n/** The failed sends and the retry the send-recovery controller and the queue tray consume. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Sends the held entry again — same message id, re-anchored — and clears\n   * its failure. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\n/**\n * The failed run sends off a statewire thread's extras: the `runs.held`\n * entries whose outbox entry was held for a failure (`localMeta.error`, see\n * `statewire-held-sends.ts`), in queue order. Empty when the extras are not a\n * statewire thread's.\n */\nexport function readStatewireFailedSends(extras: unknown): StatewireFailedSend[] {\n  if (!extras || typeof extras !== 'object') return [];\n  const held = (extras as { runs?: { held?: unknown } }).runs?.held;\n  if (!Array.isArray(held)) return [];\n  return held.flatMap((entry: unknown): StatewireFailedSend[] => {\n    const candidate = entry as Partial<StatewireThread.RunsHeldEntry> | null;\n    if (typeof candidate?.id !== 'string' || !Array.isArray(candidate.parts)) return [];\n    const sendFailure = heldSendFailure(candidate.localMeta);\n    return sendFailure === undefined\n      ? []\n      : [{ ...(candidate as StatewireThread.RunsHeldEntry), sendFailure }];\n  });\n}\n\nfunction failedActionsOf(extras: unknown): StatewireFailedActions | null {\n  const outbox = readStatewireOutbox(extras);\n  if (outbox === null) return null;\n  return {\n    retryFailed: (messageId) =>\n      retryHeldRunSend({ outbox, messageId, thread: runSendThreadOfExtras(extras) }),\n    discardFailed: (messageId) => discardHeldRunSend({ outbox, messageId }),\n  };\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  const actions = failedActionsOf(extras);\n  if (actions === null) return null;\n  return {\n    failed: readStatewireFailedSends(extras).map(({ id, sendFailure }) => ({ id, sendFailure })),\n    retryFailed: actions.retryFailed,\n  };\n}\n\n/** The failed-send actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  const actions = failedActionsOf(extras);\n  if (actions === null) throw new Error('Failed-send actions require a Statewire thread');\n  return actions;\n}\n"],"names":[],"mappings":";AAkBO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA0CO,SAAS,yBAAyB,QAAwC;;AAC/E,MAAI,CAAC,UAAU,OAAO,WAAW,iBAAiB,CAAA;AAClD,QAAM,QAAQ,YAAyC,SAAzC,mBAA+C;AAC7D,MAAI,CAAC,MAAM,QAAQ,IAAI,UAAU,CAAA;AACjC,SAAO,KAAK,QAAQ,CAAC,UAA0C;AAC7D,UAAM,YAAY;AAClB,QAAI,QAAO,uCAAW,QAAO,YAAY,CAAC,MAAM,QAAQ,UAAU,KAAK,EAAG,QAAO,CAAA;AACjF,UAAM,cAAc,gBAAgB,UAAU,SAAS;AACvD,WAAO,gBAAgB,SACnB,CAAA,IACA,CAAC,EAAE,GAAI,WAA6C,aAAa;AAAA,EACvE,CAAC;AACH;AAEA,SAAS,gBAAgB,QAAgD;AACvE,QAAM,SAAS,oBAAoB,MAAM;AACzC,MAAI,WAAW,KAAM,QAAO;AAC5B,SAAO;AAAA,IACL,aAAa,CAAC,cACZ,iBAAiB,EAAE,QAAQ,WAAW,QAAQ,sBAAsB,MAAM,GAAG;AAAA,IAC/E,eAAe,CAAC,cAAc,mBAAmB,EAAE,QAAQ,WAAW;AAAA,EAAA;AAE1E;AAOO,SAAS,4BAA4B,QAAiD;AAC3F,QAAM,UAAU,gBAAgB,MAAM;AACtC,MAAI,YAAY,KAAM,QAAO;AAC7B,SAAO;AAAA,IACL,QAAQ,yBAAyB,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,mBAAmB,EAAE,IAAI,cAAc;AAAA,IAC3F,aAAa,QAAQ;AAAA,EAAA;AAEzB;AAGO,SAAS,8BAA8B,QAAyC;AACrF,QAAM,UAAU,gBAAgB,MAAM;AACtC,MAAI,YAAY,KAAM,OAAM,IAAI,MAAM,gDAAgD;AACtF,SAAO;AACT;"}

package/dist/agent-runtime/src/thread-handoff-flow-machine.d.ts

@@ -75,19 +75,19 @@ export declare const threadHandoffFlowMachine: import("xstate").StateMachine<Han
         } | {
             kind: "office_invitation";
             host: "excel" | "powerpoint" | "word";
+        } | {
+            kind: "chrome";
         } | {
             kind: "spaces";
             url: string;
+        } | {
+            kind: "next";
         } | {
             kind: "desktop";
             scheme_url: string;
             download_url: string;
             deployment_url: string;
             protocol_version: 1;
-        } | {
-            kind: "chrome";
-        } | {
-            kind: "next";
         };
     }, {
         run: ThreadHandoffRun;
@@ -138,19 +138,19 @@ export declare const threadHandoffFlowMachine: import("xstate").StateMachine<Han
         } | {
             kind: "office_invitation";
             host: "excel" | "powerpoint" | "word";
+        } | {
+            kind: "chrome";
         } | {
             kind: "spaces";
             url: string;
+        } | {
+            kind: "next";
         } | {
             kind: "desktop";
             scheme_url: string;
             download_url: string;
             deployment_url: string;
             protocol_version: 1;
-        } | {
-            kind: "chrome";
-        } | {
-            kind: "next";
         };
     }, {
         run: ThreadHandoffRun;