@athenaintel/react 0.41.2 → 0.42.1

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

@@ -1 +1 @@
-{"version":3,"file":"interrupts.js","sources":["../../../../agent-runtime/src/interrupts.ts"],"sourcesContent":["/**\n * Human-in-the-loop interrupt primitives shared by every statewire chat\n * surface (Olympus, the React SDK, the Office add-in, the Chrome extension,\n * mobile).\n *\n * The agora deep-agent runtime parks a gated run on an `interrupt` input\n * request whose payload carries the Athena `hitl_approval` shape\n * (`athena_deep_agent/hitl_bridge.py`). A surface answers it with\n * `{ type: 'run/input', requestId, response: { type: 'resume', value } }` —\n * the exact command the backend's resume path consumes. This module holds the\n * payload contract (narrowing, resume values) and the shared resume-lock state\n * machine; rendering stays with each surface.\n *\n * Deliberately parameterized rather than self-wiring: these helpers never call\n * `useStatewireRuns`/`useAuiState` themselves. Each surface reads its own\n * statewire hooks (which its tests already mock) and passes the values in, so\n * the shared semantics cannot drift while per-surface wiring stays testable.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { hasClientToolInterruptSource } from './client-tools';\nimport { statewireTransportOutcome } from './errors';\nimport { readDeepAgentStreamValues } from './statewire-state';\n\n/** Human-in-the-loop approval payload the agora deep-agent runtime parks a run\n *  on (shaped by `athena_deep_agent/hitl_bridge.py`). */\nexport interface HitlApprovalPayload {\n  source: string;\n  type: string;\n  message: string;\n  /** Risk headline/facts/warnings, when the host includes them. */\n  approval_context?: unknown;\n  context?: {\n    tool_name?: string;\n    tool_id?: string;\n    tool_call_id?: string;\n    tool_args?: Record<string, unknown>;\n    pending_action_count?: number;\n    approval_context?: unknown;\n    /**\n     * Every pending gated call (name + args), in decision order. Absent on\n     * older backends — fall back to the single `tool_name`/`tool_args` pair.\n     * Per-dispatch payloads also carry each lane's `tool_call_id` (the lane\n     * card key) and `interrupt_id` (the lane resume key).\n     */\n    action_requests?: {\n      name?: string;\n      args?: Record<string, unknown>;\n      tool_call_id?: string;\n      interrupt_id?: string;\n      /**\n       * True when \"approve all for this session\" would take effect for this\n       * tool (the workspace allows overriding its approval). Absent on older\n       * backends and on non-overridable tools: the option is not offered.\n       */\n      session_approval_allowed?: boolean;\n      /**\n       * The decision types the parked gate accepts for this call (`approve`,\n       * `reject`, `edit`). Absent on older backends: only approve / reject\n       * are known to be accepted.\n       */\n      allowed_decisions?: string[];\n      /** What the backend resolved about this call before asking (display-only). */\n      approval_context?: unknown;\n    }[];\n    /**\n     * True when each dispatch parked on its own interrupt: decisions submit\n     * per lane via `lane_decisions` and each approved lane starts immediately,\n     * instead of the legacy batch where one resume must answer every lane.\n     */\n    per_dispatch?: boolean;\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** A pending `interrupt` input request; a present `response` key marks it answered. */\nexport function isPendingInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  return request.type === 'interrupt' && !('response' in request);\n}\n\n/**\n * Interrupt sources that were system pauses before the host stamped\n * `requires_user_action: false` on them (a background deep-research wait). Kept\n * only for the deploy skew between an older agora and a newer client; delete\n * once every deployment's raiser stamps the flag.\n */\nconst LEGACY_SYSTEM_PAUSE_INTERRUPT_SOURCES: ReadonlySet<string> = new Set(['deep_research_pending']);\n\n/**\n * A park nobody answers: the agent is still working (a background research\n * wait) and the backend resumes it itself. The raiser stamps\n * `requires_user_action: false`; older raisers are recognised by source.\n */\nexport function isSystemPauseInterrupt(payload: unknown): boolean {\n  if (!isRecord(payload)) return false;\n  if (payload.requires_user_action === false) return true;\n  return (\n    typeof payload.source === 'string' && LEGACY_SYSTEM_PAUSE_INTERRUPT_SOURCES.has(payload.source)\n  );\n}\n\n/**\n * A pending interrupt an approval card may answer. Two kinds are excluded —\n * client-tool parks (the client-tool bridge owns those, and a generic resume\n * would corrupt the parked tool call) and system pauses (nothing to answer; the\n * backend resumes them). The source checks are deliberately loose so a skewed\n * deploy can never route one here.\n */\nexport function isApprovalCardInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  if (!isPendingInterrupt(request)) return false;\n  const payload = (request as { payload?: unknown }).payload;\n  return !hasClientToolInterruptSource(payload) && !isSystemPauseInterrupt(payload);\n}\n\n/** Narrow an interrupt payload to the Athena HITL approval shape. */\nexport function asHitlApproval(value: unknown): HitlApprovalPayload | null {\n  if (!isRecord(value)) return null;\n  return value.type === 'hitl' &&\n    value.source === 'hitl_approval' &&\n    typeof value.message === 'string'\n    ? (value as unknown as HitlApprovalPayload)\n    : null;\n}\n\n/** Default paused-run copy when an interrupt payload carries no message. */\nexport const DEFAULT_INTERRUPT_PAUSED_MESSAGE =\n  'The agent is paused and waiting for input.';\n\n/** Best-effort human-readable message from any interrupt payload. */\nexport function readInterruptMessage(\n  value: unknown,\n  fallback: string = DEFAULT_INTERRUPT_PAUSED_MESSAGE,\n): string {\n  if (isRecord(value) && typeof value.message === 'string' && value.message.length > 0) {\n    return value.message;\n  }\n  return fallback;\n}\n\n/** One label/value row of a call's resolved approval facts. */\nexport interface PendingApprovalFact {\n  label: string;\n  value: string;\n}\n\n/** One caution of a call's resolved approval facts. */\nexport interface PendingApprovalWarning {\n  severity: 'info' | 'warning' | 'critical';\n  message: string;\n}\n\nexport interface PendingApprovalSlackTarget {\n  catalog_id: string;\n  conversation_id: string | null;\n  thread_ts: string | null;\n  team_url: string | null;\n  people: string[];\n}\n\n/**\n * What the backend resolved about a gated call before asking — e.g. where a\n * Slack write goes and as whom (agora `services/interrupts/approval_context.py`).\n * Display-only; the decision still answers the parked call.\n */\nexport interface PendingApprovalContext {\n  facts: PendingApprovalFact[];\n  warnings: PendingApprovalWarning[];\n  slack_target?: PendingApprovalSlackTarget;\n}\n\nconst APPROVAL_WARNING_SEVERITIES = new Set(['info', 'warning', 'critical']);\n\nfunction isNullableString(value: unknown): value is string | null {\n  return value === null || typeof value === 'string';\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((entry) => typeof entry === 'string');\n}\n\nfunction parsePendingApprovalSlackTarget(value: unknown): PendingApprovalSlackTarget | undefined {\n  if (!isRecord(value) || typeof value.catalog_id !== 'string') return undefined;\n  const conversationId = value.conversation_id;\n  const threadTs = value.thread_ts;\n  const teamUrl = value.team_url;\n  const people = value.people === undefined ? [] : value.people;\n  if (\n    !isNullableString(conversationId) ||\n    !isNullableString(threadTs) ||\n    !isNullableString(teamUrl) ||\n    !isStringArray(people)\n  )\n    return undefined;\n  return {\n    catalog_id: value.catalog_id,\n    conversation_id: conversationId,\n    thread_ts: threadTs,\n    team_url: teamUrl,\n    people,\n  };\n}\n\n/** A call's `approval_context`, or `undefined` when absent or empty. */\nexport function parsePendingApprovalContext(value: unknown): PendingApprovalContext | undefined {\n  if (!isRecord(value)) return undefined;\n  const facts: PendingApprovalFact[] = Array.isArray(value.facts)\n    ? value.facts.flatMap((fact) =>\n        isRecord(fact) && typeof fact.label === 'string' && typeof fact.value === 'string'\n          ? [{ label: fact.label, value: fact.value }]\n          : [],\n      )\n    : [];\n  const warnings: PendingApprovalWarning[] = Array.isArray(value.warnings)\n    ? value.warnings.flatMap((warning) => {\n        if (!isRecord(warning) || typeof warning.message !== 'string') return [];\n        const severity =\n          typeof warning.severity === 'string' && APPROVAL_WARNING_SEVERITIES.has(warning.severity)\n            ? (warning.severity as PendingApprovalWarning['severity'])\n            : 'info';\n        return [{ severity, message: warning.message }];\n      })\n    : [];\n  const slackTarget = parsePendingApprovalSlackTarget(value.slack_target);\n  return facts.length > 0 || warnings.length > 0 || slackTarget\n    ? { facts, warnings, ...(slackTarget ? { slack_target: slackTarget } : {}) }\n    : undefined;\n}\n\nexport interface PendingActionRequest {\n  name: string;\n  args: Record<string, unknown>;\n  /** The lane's `task` tool-call id (present on per-dispatch payloads). */\n  toolCallId?: string;\n  /** The lane's langgraph interrupt id — the `lane_decisions` resume key. */\n  interruptId?: string;\n  /** Present (true) when a session-wide approval would cover later calls of this tool. */\n  sessionApprovalAllowed?: true;\n  /** Present (true) when the gate accepts an `edit` decision for this call. */\n  editAllowed?: true;\n  /** Present when the backend resolved facts about this call before asking. */\n  approvalContext?: PendingApprovalContext;\n}\n\n/**\n * Every gated call this approval covers, in decision order. One resume answers\n * ALL of them, so every entry must stay reviewable somewhere. Falls back to\n * the single first-call fields on older backends without `action_requests`.\n */\nexport function pendingActionRequests(hitl: HitlApprovalPayload | null): PendingActionRequest[] {\n  const context = hitl?.context;\n  if (!context) return [];\n  // The payload crosses the wire with only its top-level shape narrowed\n  // (`asHitlApproval`), so the nested collection must be validated before any\n  // array/property access: a malformed host value must degrade to \"no\n  // reviewable entries\", never crash the approval surface.\n  const requests: Record<string, unknown>[] = Array.isArray(context.action_requests)\n    ? context.action_requests.filter(isRecord)\n    : context.tool_name && context.tool_args\n      ? [{ name: context.tool_name, args: context.tool_args, tool_call_id: context.tool_call_id }]\n      : [];\n  return requests.map((request) => {\n    const approvalContext = parsePendingApprovalContext(request.approval_context);\n    return {\n    name: typeof request.name === 'string' ? request.name : 'tool',\n    args: isRecord(request.args) ? request.args : {},\n    ...(typeof request.tool_call_id === 'string' && { toolCallId: request.tool_call_id }),\n    ...(typeof request.interrupt_id === 'string' && { interruptId: request.interrupt_id }),\n    ...(request.session_approval_allowed === true && { sessionApprovalAllowed: true }),\n    ...(Array.isArray(request.allowed_decisions) &&\n      request.allowed_decisions.includes('edit') && { editAllowed: true }),\n    ...(approvalContext && { approvalContext }),\n    };\n  });\n}\n\n/**\n * Whether the card may offer \"approve all for this session\": every pending\n * call must be one the backend stamped as session-approvable, so a batch that\n * mixes in a tool the workspace pinned as always-prompt only offers the\n * one-time answer.\n */\nexport function canApproveForSession(actionRequests: readonly PendingActionRequest[]): boolean {\n  return (\n    actionRequests.length > 0 &&\n    actionRequests.every((request) => request.sessionApprovalAllowed === true)\n  );\n}\n\n/** An interrupt a non-resume dispatch dropped, published by the host. */\nexport interface AbandonedInputRequest {\n  id: string;\n  type: string;\n}\n\n/**\n * `useStatewireState` selector body for the host-published abandoned input\n * requests. Reads through {@link readDeepAgentStreamValues} so the selector is\n * safe on the pre-attach (`undefined`) wire state, and returns the raw array\n * reference so the subscription stays shallow-stable — derive (`.find`) on the\n * result, never inside the selector.\n */\nexport function readAbandonedInputRequests(\n  state: unknown,\n): readonly AbandonedInputRequest[] | undefined {\n  const abandoned = readDeepAgentStreamValues(state).abandonedInputRequests;\n  // Wire value: anything non-array (including a malformed host publication)\n  // reads as \"none\" rather than crashing the consuming surface. Identity-\n  // preserving for the valid case, so it stays selector-safe.\n  return Array.isArray(abandoned)\n    ? (abandoned as readonly AbandonedInputRequest[])\n    : undefined;\n}\n\n/**\n * `useStatewireState` selector body for the host's mirrored interrupt\n * (`__interrupt__`, the LangGraph `{value, resumable}` wrapper). The mirror\n * is published the moment a lane parks on its gate — while sibling lanes are\n * still streaming and the run manager has NOT yet published an answerable\n * input request. Raw reference, selector-safe; unwrap with\n * {@link interruptMirrorPayload}.\n */\nexport function readInterruptMirror(state: unknown): unknown {\n  return readDeepAgentStreamValues(state).__interrupt__;\n}\n\n/** The payload of a mirrored interrupt wrapper, or `undefined` for anything else. */\nexport function interruptMirrorPayload(mirror: unknown): unknown {\n  return isRecord(mirror) ? mirror.value : undefined;\n}\n\n/**\n * `useStatewireState` selector body for the per-dispatch lane decisions the\n * host accepted through `run/lane-input` while the run was still streaming\n * (`queuedLaneDecisions`, keyed by langgraph interrupt id). Held until the\n * run parks, then answered as a native `lane_decisions` resume; every attached\n * client reads a queued lane as decided. Raw reference, selector-safe.\n */\nexport function readQueuedLaneDecisions(\n  state: unknown,\n): Readonly<Record<string, unknown>> | undefined {\n  const queued = readDeepAgentStreamValues(state).queuedLaneDecisions;\n  return isRecord(queued) ? queued : undefined;\n}\n\n/**\n * The distinct langgraph interrupt ids a `lane_decisions` resume answers for\n * these gated calls, in first-seen order — or `null` when any call lacks its\n * stamp (a legacy batch payload only a positional resume can answer). A\n * nested HITL request gating several calls contributes one id: the lane is\n * the interrupt, and one decision fans across its calls server-side.\n */\nexport function laneInterruptIds(actionRequests: readonly PendingActionRequest[]): string[] | null {\n  if (actionRequests.length === 0) return null;\n  const ids: string[] = [];\n  for (const request of actionRequests) {\n    if (request.interruptId === undefined) return null;\n    if (!ids.includes(request.interruptId)) ids.push(request.interruptId);\n  }\n  return ids;\n}\n\n/** One decision for every lane — the `lane_decisions` map a run-wide approve or reject sends. */\nexport function fanLaneDecision<T>({\n  interruptIds,\n  decision,\n}: {\n  interruptIds: readonly string[];\n  decision: T;\n}): Record<string, T> {\n  return Object.fromEntries(interruptIds.map((id) => [id, decision]));\n}\n\n/** The abandoned `interrupt` entry, if any — the \"approval was cancelled\" notice. */\nexport function findAbandonedInterrupt(\n  abandoned: readonly AbandonedInputRequest[] | undefined,\n): AbandonedInputRequest | undefined {\n  return abandoned?.find(\n    (request) => isRecord(request) && request.type === 'interrupt' && typeof request.id === 'string',\n  );\n}\n\n/** Canonical reason string carried by a user rejection. */\nexport const HITL_REJECT_REASON = 'User rejected the action.';\n\n/**\n * Default {@link UseApprovalResumeLockOptions.pendingResumeGraceMs} for every\n * approval surface: how long a clicked decision waits for its resume run to\n * start before the actions unlock again. Covers a `run/input` the host\n * rejected or a disconnected transport swallowed before any run began — the\n * one failure neither identity-change nor observed-run recovery can detect.\n */\nexport const HITL_PENDING_RESUME_GRACE_MS = 15_000;\n\n/**\n * Default {@link UseApprovalResumeLockOptions.maxTransportRetries}: how many\n * times a decision the transport lost (the websocket dropped or the statewire\n * session reset while the `run/input` was in flight) is re-sent on its own\n * before the user is asked to click again.\n */\nexport const HITL_RESUME_TRANSPORT_RETRIES = 3;\n\n/**\n * The dispatch died client-side without the host ever seeing it — a proven\n * session loss or a gone stream. Safe to re-send the same decision for the\n * same still-parked request. The complement (a server verdict, or the surface\n * unmounting) is not.\n */\nexport function isResumeTransportLoss(error: unknown): boolean {\n  const outcome = statewireTransportOutcome(error);\n  return outcome === 'session-lost' || outcome === 'stream-gone';\n}\n\n/** `run/input` resume value approving the gated call(s). */\nexport function hitlResumeApprove(): Record<string, string> {\n  return { action: 'approve' };\n}\n\n/**\n * `run/input` resume value approving the gated call(s) AND every later call of\n * the same tool(s) on this thread. The backend records the tools from its own\n * parked interrupt (never from this payload), so the value carries no names.\n */\nexport function hitlResumeApproveForSession(): Record<string, string> {\n  return { action: 'approve', scope: 'session' };\n}\n\n/** `run/input` resume value rejecting the gated call(s). */\nexport function hitlResumeReject(reason: string = HITL_REJECT_REASON): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\n/** One gated call's own answer inside a per-action resume ({@link hitlResumeActionDecisions}). */\nexport type HitlActionDecision =\n  | { action: 'approve' }\n  | { action: 'reject'; reason: string }\n  | { action: 'edit'; edited_args: Record<string, unknown> };\n\n/**\n * The `tool_call_id` of every gated call, in decision order — or `null` when\n * any call lacks one or two calls share one, in which case no per-action\n * resume can be bound to the batch and only the batch answers above apply.\n */\nexport function actionRequestToolCallIds(\n  actionRequests: readonly PendingActionRequest[],\n): string[] | null {\n  if (actionRequests.length === 0) return null;\n  const ids: string[] = [];\n  for (const request of actionRequests) {\n    if (request.toolCallId === undefined || ids.includes(request.toolCallId)) return null;\n    ids.push(request.toolCallId);\n  }\n  return ids;\n}\n\n/**\n * `run/input` resume value deciding each gated call by its `tool_call_id` —\n * the only channel that carries an edited call. The backend binds every entry\n * to the parked request with that id, takes the tool NAME from its own\n * request (an edit can change a call's arguments, never which tool runs), and\n * refuses the whole answer — nothing runs — unless the map names exactly the\n * parked calls. `edited_args` is the complete argument set the call runs\n * with, not a patch. The envelope `action` mirrors the first entry for hosts\n * that only read the envelope; `action_decisions` is authoritative.\n */\nexport function hitlResumeActionDecisions(\n  decisions: Readonly<Record<string, HitlActionDecision>>,\n): Record<string, unknown> {\n  const [anchorId, anchor] = Object.entries(decisions)[0] ?? [];\n  return {\n    action: anchor?.action === 'reject' ? 'reject' : 'approve',\n    ...(anchorId !== undefined && { tool_call_id: anchorId }),\n    action_decisions: decisions,\n  };\n}\n\n/** Canonical reason string carried by a user declining a non-HITL park. */\nexport const INTERRUPT_DECLINE_REASON = 'User declined the request.';\n\n/**\n * `run/input` resume value declining a non-HITL park. `{ action: 'reject' }`\n * is the one value every typed raiser treats as a clean user decline\n * (`FormCancelledError` / `ToolRejectedError`); a generic `continue` would be\n * rejected by their resume schemas and surface as a tool error the agent then\n * improvises around.\n */\nexport function interruptResumeDecline(\n  reason: string = INTERRUPT_DECLINE_REASON,\n): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\nexport interface UseApprovalResumeLockOptions<TValue> {\n  /** The pending interrupt's request id (`undefined` when nothing is parked). */\n  requestId: string | undefined;\n  /** The surface's thread `isRunning` read (mockable per surface). */\n  isRunning: boolean;\n  /**\n   * Dispatch the `run/input` resume for `requestId` on the surface's transport.\n   * Return the dispatch promise so a refused or lost command releases the lock\n   * at once and reaches `onResumeRejected`; a `void` return leaves the\n   * recovery paths below as the only release.\n   */\n  sendResume: (requestId: string, value: TValue) => void | Promise<unknown>;\n  /**\n   * The dispatch `sendResume` returned rejected — the host refused the\n   * `run/input` or the transport lost it. The lock is already released when\n   * this fires; the surface tells the user, since the request is back on\n   * screen with nothing else saying why.\n   */\n  onResumeRejected?: (error: unknown, requestId: string) => void;\n  /**\n   * A dispatch the transport lost is being re-sent for the still-parked\n   * request; `attempt` counts the retries so far (1-based). Diagnostics only —\n   * the lock stays held across the retry.\n   */\n  onResumeRetry?: (error: unknown, requestId: string, attempt: number) => void;\n  /**\n   * Automatic re-sends of a decision the transport lost\n   * ({@link isResumeTransportLoss}) while the request is still parked. `0`\n   * disables retries. Defaults to {@link HITL_RESUME_TRANSPORT_RETRIES}.\n   */\n  maxTransportRetries?: number;\n  /**\n   * Re-enable the actions when no resume run started within this window —\n   * covers a `run/input` that was rejected or lost before any run began, so\n   * neither reset path below can fire. Omit to keep the pre-existing surface\n   * behavior of staying locked until a resume run is observed.\n   */\n  pendingResumeGraceMs?: number;\n}\n\nexport interface ApprovalResumeLock<TValue> {\n  /** True after a resume until the request identity changes (or recovery fires). */\n  pending: boolean;\n  /**\n   * Send the resume value, locking the actions. No-op (returns `undefined`)\n   * while pending or unparked. Returns the dispatch promise when `sendResume`\n   * produced one, so a surface can hold its own state until the host settles.\n   */\n  resume: (value: TValue) => Promise<unknown> | undefined;\n}\n\n/**\n * Optimistic action lock shared by every approval surface: disable the\n * decision buttons the moment one is clicked, until the request identity\n * changes (it clears after the resume, or a fresh interrupt arrives). This\n * closes the double-click → duplicate-resume window.\n *\n * Recovery paths, in order of specificity:\n * 0. The dispatch itself rejected (a `sendResume` that returned a promise) —\n *    released at once, and reported through `onResumeRejected`. A rejection\n *    that is a transport loss (the socket dropped mid-flight) is re-sent up to\n *    `maxTransportRetries` times first, the lock held throughout, so a flaky\n *    connection does not hand the card back to the user for another click.\n *    The returned promise settles with the final attempt.\n * 1. Identity change — the resume landed (or a new interrupt replaced the\n *    request). Reset during render via React's \"previous value\" pattern.\n * 2. A resume run was observed starting and then settling with the request\n *    still pending (failed/cancelled resume) — clear the lock so the user can\n *    answer again.\n * 3. Optional grace window ({@link UseApprovalResumeLockOptions.pendingResumeGraceMs})\n *    for a `run/input` that never started a run at all.\n */\nexport function useApprovalResumeLock<TValue = Record<string, string>>(\n  options: UseApprovalResumeLockOptions<TValue>,\n): ApprovalResumeLock<TValue> {\n  const {\n    requestId,\n    isRunning,\n    sendResume,\n    pendingResumeGraceMs,\n    onResumeRejected,\n    onResumeRetry,\n    maxTransportRetries = HITL_RESUME_TRANSPORT_RETRIES,\n  } = options;\n\n  const [pending, setPending] = useState(false);\n  // Bumped per re-send so the grace window restarts with each attempt.\n  const [attempt, setAttempt] = useState(0);\n  const prevRequestIdRef = useRef(requestId);\n  if (prevRequestIdRef.current !== requestId) {\n    prevRequestIdRef.current = requestId;\n    if (pending) setPending(false);\n  }\n\n  // Track the resume run we kicked off (isRunning observed true→false while\n  // pending) and clear `pending` when it ends with the request unresolved.\n  const sawResumeRunRef = useRef(false);\n  useEffect(() => {\n    if (!pending) {\n      sawResumeRunRef.current = false;\n      return;\n    }\n    if (isRunning) {\n      sawResumeRunRef.current = true;\n      return;\n    }\n    if (sawResumeRunRef.current) {\n      sawResumeRunRef.current = false;\n      setPending(false);\n    }\n  }, [pending, isRunning]);\n\n  // Pre-start failure recovery: re-enable after the grace window when no\n  // resume run began; answering the still-parked request again is exactly\n  // what the user needs to be able to do.\n  useEffect(() => {\n    if (!pending || pendingResumeGraceMs === undefined) return;\n    const timer = setTimeout(() => {\n      if (!sawResumeRunRef.current) setPending(false);\n    }, pendingResumeGraceMs);\n    return () => clearTimeout(timer);\n  }, [pending, requestId, pendingResumeGraceMs, attempt]);\n\n  const sendResumeRef = useRef(sendResume);\n  sendResumeRef.current = sendResume;\n  const onResumeRejectedRef = useRef(onResumeRejected);\n  onResumeRejectedRef.current = onResumeRejected;\n  const onResumeRetryRef = useRef(onResumeRetry);\n  onResumeRetryRef.current = onResumeRetry;\n  const maxTransportRetriesRef = useRef(maxTransportRetries);\n  maxTransportRetriesRef.current = maxTransportRetries;\n  const currentRequestIdRef = useRef(requestId);\n  currentRequestIdRef.current = requestId;\n  const pendingRef = useRef(pending);\n  pendingRef.current = pending;\n  // One token per `resume` call: a settle from an earlier submission must not\n  // retry over, or release, a newer one for the same request.\n  const submissionRef = useRef(0);\n\n  const resume = useCallback(\n    (value: TValue): Promise<unknown> | undefined => {\n      if (requestId === undefined || pendingRef.current) return undefined;\n      const submission = ++submissionRef.current;\n      setPending(true);\n      pendingRef.current = true;\n      setAttempt(0);\n      const first: unknown = sendResumeRef.current(requestId, value);\n      if (!(first instanceof Promise)) return undefined;\n      // The final failure is already reported through `onResumeRejected`;\n      // callers that drop the promise must not get an unhandled rejection.\n      const outcome = new Promise<unknown>((resolve, reject) => {\n        const settle = (dispatched: Promise<unknown>, retries: number) => {\n          dispatched.then(resolve, (error: unknown) => {\n            // A late refusal for a request the lock has since moved past (the\n            // park was re-keyed, or a newer answer is in flight) must neither\n            // release that answer's lock nor be reported as a failure of it.\n            // The optimistic fold hides the answered request until the fold\n            // rolls back, so `undefined` here is not a departure.\n            const current = currentRequestIdRef.current;\n            if (\n              submission !== submissionRef.current ||\n              (current !== undefined && current !== requestId)\n            ) {\n              reject(error);\n              return;\n            }\n            if (retries < maxTransportRetriesRef.current && isResumeTransportLoss(error)) {\n              const next = retries + 1;\n              onResumeRetryRef.current?.(error, requestId, next);\n              setPending(true);\n              pendingRef.current = true;\n              setAttempt(next);\n              const resent: unknown = sendResumeRef.current(requestId, value);\n              if (resent instanceof Promise) {\n                settle(resent, next);\n                return;\n              }\n              resolve(undefined);\n              return;\n            }\n            setPending(false);\n            pendingRef.current = false;\n            onResumeRejectedRef.current?.(error, requestId);\n            reject(error);\n          });\n        };\n        settle(first, 0);\n      });\n      outcome.catch(() => {});\n      return outcome;\n    },\n    [requestId],\n  );\n\n  return { pending, resume };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"interrupts.js","sources":["../../../../agent-runtime/src/interrupts.ts"],"sourcesContent":["/**\n * Human-in-the-loop interrupt primitives shared by every statewire chat\n * surface (Olympus, the React SDK, the Office add-in, the Chrome extension,\n * mobile).\n *\n * The agora deep-agent runtime parks a gated run on an `interrupt` input\n * request whose payload carries the Athena `hitl_approval` shape\n * (`athena_deep_agent/hitl_bridge.py`). A surface answers it with\n * `{ type: 'run/input', requestId, response: { type: 'resume', value } }` —\n * the exact command the backend's resume path consumes. This module holds the\n * payload contract (narrowing, resume values) and the shared resume-lock state\n * machine; rendering stays with each surface.\n *\n * Deliberately parameterized rather than self-wiring: these helpers never call\n * `useStatewireRuns`/`useAuiState` themselves. Each surface reads its own\n * statewire hooks (which its tests already mock) and passes the values in, so\n * the shared semantics cannot drift while per-surface wiring stays testable.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { hasClientToolInterruptSource } from './client-tools';\nimport { statewireTransportOutcome } from './errors';\nimport { readDeepAgentStreamValues } from './statewire-state';\n\n/** Human-in-the-loop approval payload the agora deep-agent runtime parks a run\n *  on (shaped by `athena_deep_agent/hitl_bridge.py`). */\nexport interface HitlApprovalPayload {\n  source: string;\n  type: string;\n  message: string;\n  /** Risk headline/facts/warnings, when the host includes them. */\n  approval_context?: unknown;\n  context?: {\n    tool_name?: string;\n    tool_id?: string;\n    tool_call_id?: string;\n    tool_args?: Record<string, unknown>;\n    pending_action_count?: number;\n    approval_context?: unknown;\n    /**\n     * Every pending gated call (name + args), in decision order. Absent on\n     * older backends — fall back to the single `tool_name`/`tool_args` pair.\n     * Per-dispatch payloads also carry each lane's `tool_call_id` (the lane\n     * card key) and `interrupt_id` (the lane resume key).\n     */\n    action_requests?: {\n      name?: string;\n      args?: Record<string, unknown>;\n      tool_call_id?: string;\n      interrupt_id?: string;\n      /**\n       * True when \"approve all for this session\" would take effect for this\n       * tool (the workspace allows overriding its approval). Absent on older\n       * backends and on non-overridable tools: the option is not offered.\n       */\n      session_approval_allowed?: boolean;\n      /**\n       * The decision types the parked gate accepts for this call (`approve`,\n       * `reject`, `edit`). Absent on older backends: only approve / reject\n       * are known to be accepted.\n       */\n      allowed_decisions?: string[];\n      /** What the backend resolved about this call before asking (display-only). */\n      approval_context?: unknown;\n    }[];\n    /**\n     * True when each dispatch parked on its own interrupt: decisions submit\n     * per lane via `lane_decisions` and each approved lane starts immediately,\n     * instead of the legacy batch where one resume must answer every lane.\n     */\n    per_dispatch?: boolean;\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** A pending `interrupt` input request; a present `response` key marks it answered. */\nexport function isPendingInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  return request.type === 'interrupt' && !('response' in request);\n}\n\n/**\n * Interrupt sources that were system pauses before the host stamped\n * `requires_user_action: false` on them (a background deep-research wait). Kept\n * only for the deploy skew between an older agora and a newer client; delete\n * once every deployment's raiser stamps the flag.\n */\nconst LEGACY_SYSTEM_PAUSE_INTERRUPT_SOURCES: ReadonlySet<string> = new Set(['deep_research_pending']);\n\n/**\n * A park nobody answers: the agent is still working (a background research\n * wait) and the backend resumes it itself. The raiser stamps\n * `requires_user_action: false`; older raisers are recognised by source.\n */\nexport function isSystemPauseInterrupt(payload: unknown): boolean {\n  if (!isRecord(payload)) return false;\n  if (payload.requires_user_action === false) return true;\n  return (\n    typeof payload.source === 'string' && LEGACY_SYSTEM_PAUSE_INTERRUPT_SOURCES.has(payload.source)\n  );\n}\n\n/**\n * A pending interrupt an approval card may answer. Two kinds are excluded —\n * client-tool parks (the client-tool bridge owns those, and a generic resume\n * would corrupt the parked tool call) and system pauses (nothing to answer; the\n * backend resumes them). The source checks are deliberately loose so a skewed\n * deploy can never route one here.\n */\nexport function isApprovalCardInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  if (!isPendingInterrupt(request)) return false;\n  const payload = (request as { payload?: unknown }).payload;\n  return !hasClientToolInterruptSource(payload) && !isSystemPauseInterrupt(payload);\n}\n\n/** Narrow an interrupt payload to the Athena HITL approval shape. */\nexport function asHitlApproval(value: unknown): HitlApprovalPayload | null {\n  if (!isRecord(value)) return null;\n  return value.type === 'hitl' &&\n    value.source === 'hitl_approval' &&\n    typeof value.message === 'string'\n    ? (value as unknown as HitlApprovalPayload)\n    : null;\n}\n\n/** Default paused-run copy when an interrupt payload carries no message. */\nexport const DEFAULT_INTERRUPT_PAUSED_MESSAGE =\n  'The agent is paused and waiting for input.';\n\n/** Best-effort human-readable message from any interrupt payload. */\nexport function readInterruptMessage(\n  value: unknown,\n  fallback: string = DEFAULT_INTERRUPT_PAUSED_MESSAGE,\n): string {\n  if (isRecord(value) && typeof value.message === 'string' && value.message.length > 0) {\n    return value.message;\n  }\n  return fallback;\n}\n\n/** One label/value row of a call's resolved approval facts. */\nexport interface PendingApprovalFact {\n  label: string;\n  value: string;\n}\n\n/** One caution of a call's resolved approval facts. */\nexport interface PendingApprovalWarning {\n  severity: 'info' | 'warning' | 'critical';\n  message: string;\n}\n\nexport interface PendingApprovalSlackTarget {\n  catalog_id: string;\n  conversation_id: string | null;\n  thread_ts: string | null;\n  team_url: string | null;\n  people: string[];\n}\n\n/**\n * What the backend resolved about a gated call before asking — e.g. where a\n * Slack write goes and as whom (agora `services/interrupts/approval_context.py`).\n * Display-only; the decision still answers the parked call.\n */\nexport interface PendingApprovalContext {\n  facts: PendingApprovalFact[];\n  warnings: PendingApprovalWarning[];\n  slack_target?: PendingApprovalSlackTarget;\n}\n\nconst APPROVAL_WARNING_SEVERITIES = new Set(['info', 'warning', 'critical']);\n\nfunction isNullableString(value: unknown): value is string | null {\n  return value === null || typeof value === 'string';\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((entry) => typeof entry === 'string');\n}\n\nfunction parsePendingApprovalSlackTarget(value: unknown): PendingApprovalSlackTarget | undefined {\n  if (!isRecord(value) || typeof value.catalog_id !== 'string') return undefined;\n  const conversationId = value.conversation_id;\n  const threadTs = value.thread_ts;\n  const teamUrl = value.team_url;\n  const people = value.people === undefined ? [] : value.people;\n  if (\n    !isNullableString(conversationId) ||\n    !isNullableString(threadTs) ||\n    !isNullableString(teamUrl) ||\n    !isStringArray(people)\n  )\n    return undefined;\n  return {\n    catalog_id: value.catalog_id,\n    conversation_id: conversationId,\n    thread_ts: threadTs,\n    team_url: teamUrl,\n    people,\n  };\n}\n\n/** A call's `approval_context`, or `undefined` when absent or empty. */\nexport function parsePendingApprovalContext(value: unknown): PendingApprovalContext | undefined {\n  if (!isRecord(value)) return undefined;\n  const facts: PendingApprovalFact[] = Array.isArray(value.facts)\n    ? value.facts.flatMap((fact) =>\n        isRecord(fact) && typeof fact.label === 'string' && typeof fact.value === 'string'\n          ? [{ label: fact.label, value: fact.value }]\n          : [],\n      )\n    : [];\n  const warnings: PendingApprovalWarning[] = Array.isArray(value.warnings)\n    ? value.warnings.flatMap((warning) => {\n        if (!isRecord(warning) || typeof warning.message !== 'string') return [];\n        const severity =\n          typeof warning.severity === 'string' && APPROVAL_WARNING_SEVERITIES.has(warning.severity)\n            ? (warning.severity as PendingApprovalWarning['severity'])\n            : 'info';\n        return [{ severity, message: warning.message }];\n      })\n    : [];\n  const slackTarget = parsePendingApprovalSlackTarget(value.slack_target);\n  return facts.length > 0 || warnings.length > 0 || slackTarget\n    ? { facts, warnings, ...(slackTarget ? { slack_target: slackTarget } : {}) }\n    : undefined;\n}\n\nexport interface PendingActionRequest {\n  name: string;\n  args: Record<string, unknown>;\n  /** The lane's `task` tool-call id (present on per-dispatch payloads). */\n  toolCallId?: string;\n  /** The lane's langgraph interrupt id — the `lane_decisions` resume key. */\n  interruptId?: string;\n  /** Present (true) when a session-wide approval would cover later calls of this tool. */\n  sessionApprovalAllowed?: true;\n  /** Present (true) when the gate accepts an `edit` decision for this call. */\n  editAllowed?: true;\n  /** Present when the backend resolved facts about this call before asking. */\n  approvalContext?: PendingApprovalContext;\n}\n\n/**\n * Every gated call this approval covers, in decision order. One resume answers\n * ALL of them, so every entry must stay reviewable somewhere. Falls back to\n * the single first-call fields on older backends without `action_requests`.\n */\nexport function pendingActionRequests(hitl: HitlApprovalPayload | null): PendingActionRequest[] {\n  const context = hitl?.context;\n  if (!context) return [];\n  // The payload crosses the wire with only its top-level shape narrowed\n  // (`asHitlApproval`), so the nested collection must be validated before any\n  // array/property access: a malformed host value must degrade to \"no\n  // reviewable entries\", never crash the approval surface.\n  const requests: Record<string, unknown>[] = Array.isArray(context.action_requests)\n    ? context.action_requests.filter(isRecord)\n    : context.tool_name && context.tool_args\n      ? [{ name: context.tool_name, args: context.tool_args, tool_call_id: context.tool_call_id }]\n      : [];\n  return requests.map((request) => {\n    const approvalContext = parsePendingApprovalContext(request.approval_context);\n    return {\n    name: typeof request.name === 'string' ? request.name : 'tool',\n    args: isRecord(request.args) ? request.args : {},\n    ...(typeof request.tool_call_id === 'string' && { toolCallId: request.tool_call_id }),\n    ...(typeof request.interrupt_id === 'string' && { interruptId: request.interrupt_id }),\n    ...(request.session_approval_allowed === true && { sessionApprovalAllowed: true }),\n    ...(Array.isArray(request.allowed_decisions) &&\n      request.allowed_decisions.includes('edit') && { editAllowed: true }),\n    ...(approvalContext && { approvalContext }),\n    };\n  });\n}\n\n/**\n * Whether the card may offer \"approve all for this session\": every pending\n * call must be one the backend stamped as session-approvable, so a batch that\n * mixes in a tool the workspace pinned as always-prompt only offers the\n * one-time answer.\n */\nexport function canApproveForSession(actionRequests: readonly PendingActionRequest[]): boolean {\n  return (\n    actionRequests.length > 0 &&\n    actionRequests.every((request) => request.sessionApprovalAllowed === true)\n  );\n}\n\n/** An interrupt a non-resume dispatch dropped, published by the host. */\nexport interface AbandonedInputRequest {\n  id: string;\n  type: string;\n}\n\n/**\n * `useStatewireState` selector body for the host-published abandoned input\n * requests. Reads through {@link readDeepAgentStreamValues} so the selector is\n * safe on the pre-attach (`undefined`) wire state, and returns the raw array\n * reference so the subscription stays shallow-stable — derive (`.find`) on the\n * result, never inside the selector.\n */\nexport function readAbandonedInputRequests(\n  state: unknown,\n): readonly AbandonedInputRequest[] | undefined {\n  const abandoned = readDeepAgentStreamValues(state).abandonedInputRequests;\n  // Wire value: anything non-array (including a malformed host publication)\n  // reads as \"none\" rather than crashing the consuming surface. Identity-\n  // preserving for the valid case, so it stays selector-safe.\n  return Array.isArray(abandoned)\n    ? (abandoned as readonly AbandonedInputRequest[])\n    : undefined;\n}\n\n/**\n * `useStatewireState` selector body for the host's mirrored interrupt\n * (`__interrupt__`, the LangGraph `{value, resumable}` wrapper). The mirror\n * is published the moment a lane parks on its gate — while sibling lanes are\n * still streaming and the run manager has NOT yet published an answerable\n * input request. Raw reference, selector-safe; unwrap with\n * {@link interruptMirrorPayload}.\n */\nexport function readInterruptMirror(state: unknown): unknown {\n  return readDeepAgentStreamValues(state).__interrupt__;\n}\n\n/** The payload of a mirrored interrupt wrapper, or `undefined` for anything else. */\nexport function interruptMirrorPayload(mirror: unknown): unknown {\n  return isRecord(mirror) ? mirror.value : undefined;\n}\n\n/**\n * `useStatewireState` selector body for the per-dispatch lane decisions the\n * host accepted through `run/lane-input` while the run was still streaming\n * (`queuedLaneDecisions`, keyed by langgraph interrupt id). Held until the\n * run parks, then answered as a native `lane_decisions` resume; every attached\n * client reads a queued lane as decided. Raw reference, selector-safe.\n */\nexport function readQueuedLaneDecisions(\n  state: unknown,\n): Readonly<Record<string, unknown>> | undefined {\n  const queued = readDeepAgentStreamValues(state).queuedLaneDecisions;\n  return isRecord(queued) ? queued : undefined;\n}\n\n/**\n * The distinct langgraph interrupt ids a `lane_decisions` resume answers for\n * these gated calls, in first-seen order — or `null` when any call lacks its\n * stamp (a legacy batch payload only a positional resume can answer). A\n * nested HITL request gating several calls contributes one id: the lane is\n * the interrupt, and one decision fans across its calls server-side.\n */\nexport function laneInterruptIds(actionRequests: readonly PendingActionRequest[]): string[] | null {\n  if (actionRequests.length === 0) return null;\n  const ids: string[] = [];\n  for (const request of actionRequests) {\n    if (request.interruptId === undefined) return null;\n    if (!ids.includes(request.interruptId)) ids.push(request.interruptId);\n  }\n  return ids;\n}\n\nconst NO_TOOL_CALL_IDS: ReadonlySet<string> = new Set();\n\n/**\n * The gated calls still waiting on a person, by `tool_call_id`: every call of\n * the approval on screen (the parked request's, or the host's mirror while\n * sibling lanes still stream), less the lanes whose decision the host already\n * holds (`queuedLaneDecisions`, keyed by interrupt id): a lane decided live\n * waits for the run to park, not for anyone. The id is the one join between an\n * approval and the call it gates (a payload names no lane), so a call without\n * one counts for nothing.\n */\nexport function toolCallIdsAwaitingApproval({\n  actionRequests,\n  queuedLaneDecisions,\n}: {\n  actionRequests: readonly PendingActionRequest[];\n  queuedLaneDecisions?: Readonly<Record<string, unknown>>;\n}): ReadonlySet<string> {\n  let ids: Set<string> | undefined;\n  for (const request of actionRequests) {\n    if (request.toolCallId === undefined) continue;\n    if (\n      request.interruptId !== undefined &&\n      queuedLaneDecisions !== undefined &&\n      request.interruptId in queuedLaneDecisions\n    ) {\n      continue;\n    }\n    ids ??= new Set();\n    ids.add(request.toolCallId);\n  }\n  return ids ?? NO_TOOL_CALL_IDS;\n}\n\n/** One decision for every lane — the `lane_decisions` map a run-wide approve or reject sends. */\nexport function fanLaneDecision<T>({\n  interruptIds,\n  decision,\n}: {\n  interruptIds: readonly string[];\n  decision: T;\n}): Record<string, T> {\n  return Object.fromEntries(interruptIds.map((id) => [id, decision]));\n}\n\n/** The abandoned `interrupt` entry, if any — the \"approval was cancelled\" notice. */\nexport function findAbandonedInterrupt(\n  abandoned: readonly AbandonedInputRequest[] | undefined,\n): AbandonedInputRequest | undefined {\n  return abandoned?.find(\n    (request) => isRecord(request) && request.type === 'interrupt' && typeof request.id === 'string',\n  );\n}\n\n/** Canonical reason string carried by a user rejection. */\nexport const HITL_REJECT_REASON = 'User rejected the action.';\n\n/**\n * Default {@link UseApprovalResumeLockOptions.pendingResumeGraceMs} for every\n * approval surface: how long a clicked decision waits for its resume run to\n * start before the actions unlock again. Covers a `run/input` the host\n * rejected or a disconnected transport swallowed before any run began — the\n * one failure neither identity-change nor observed-run recovery can detect.\n */\nexport const HITL_PENDING_RESUME_GRACE_MS = 15_000;\n\n/**\n * Default {@link UseApprovalResumeLockOptions.maxTransportRetries}: how many\n * times a decision the transport lost (the websocket dropped or the statewire\n * session reset while the `run/input` was in flight) is re-sent on its own\n * before the user is asked to click again.\n */\nexport const HITL_RESUME_TRANSPORT_RETRIES = 3;\n\n/**\n * The dispatch died client-side without the host ever seeing it — a proven\n * session loss or a gone stream. Safe to re-send the same decision for the\n * same still-parked request. The complement (a server verdict, or the surface\n * unmounting) is not.\n */\nexport function isResumeTransportLoss(error: unknown): boolean {\n  const outcome = statewireTransportOutcome(error);\n  return outcome === 'session-lost' || outcome === 'stream-gone';\n}\n\n/** `run/input` resume value approving the gated call(s). */\nexport function hitlResumeApprove(): Record<string, string> {\n  return { action: 'approve' };\n}\n\n/**\n * `run/input` resume value approving the gated call(s) AND every later call of\n * the same tool(s) on this thread. The backend records the tools from its own\n * parked interrupt (never from this payload), so the value carries no names.\n */\nexport function hitlResumeApproveForSession(): Record<string, string> {\n  return { action: 'approve', scope: 'session' };\n}\n\n/** `run/input` resume value rejecting the gated call(s). */\nexport function hitlResumeReject(reason: string = HITL_REJECT_REASON): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\n/** One gated call's own answer inside a per-action resume ({@link hitlResumeActionDecisions}). */\nexport type HitlActionDecision =\n  | { action: 'approve' }\n  | { action: 'reject'; reason: string }\n  | { action: 'edit'; edited_args: Record<string, unknown> };\n\n/**\n * The `tool_call_id` of every gated call, in decision order — or `null` when\n * any call lacks one or two calls share one, in which case no per-action\n * resume can be bound to the batch and only the batch answers above apply.\n */\nexport function actionRequestToolCallIds(\n  actionRequests: readonly PendingActionRequest[],\n): string[] | null {\n  if (actionRequests.length === 0) return null;\n  const ids: string[] = [];\n  for (const request of actionRequests) {\n    if (request.toolCallId === undefined || ids.includes(request.toolCallId)) return null;\n    ids.push(request.toolCallId);\n  }\n  return ids;\n}\n\n/**\n * `run/input` resume value deciding each gated call by its `tool_call_id` —\n * the only channel that carries an edited call. The backend binds every entry\n * to the parked request with that id, takes the tool NAME from its own\n * request (an edit can change a call's arguments, never which tool runs), and\n * refuses the whole answer — nothing runs — unless the map names exactly the\n * parked calls. `edited_args` is the complete argument set the call runs\n * with, not a patch. The envelope `action` mirrors the first entry for hosts\n * that only read the envelope; `action_decisions` is authoritative.\n */\nexport function hitlResumeActionDecisions(\n  decisions: Readonly<Record<string, HitlActionDecision>>,\n): Record<string, unknown> {\n  const [anchorId, anchor] = Object.entries(decisions)[0] ?? [];\n  return {\n    action: anchor?.action === 'reject' ? 'reject' : 'approve',\n    ...(anchorId !== undefined && { tool_call_id: anchorId }),\n    action_decisions: decisions,\n  };\n}\n\n/** Canonical reason string carried by a user declining a non-HITL park. */\nexport const INTERRUPT_DECLINE_REASON = 'User declined the request.';\n\n/**\n * `run/input` resume value declining a non-HITL park. `{ action: 'reject' }`\n * is the one value every typed raiser treats as a clean user decline\n * (`FormCancelledError` / `ToolRejectedError`); a generic `continue` would be\n * rejected by their resume schemas and surface as a tool error the agent then\n * improvises around.\n */\nexport function interruptResumeDecline(\n  reason: string = INTERRUPT_DECLINE_REASON,\n): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\nexport interface UseApprovalResumeLockOptions<TValue> {\n  /** The pending interrupt's request id (`undefined` when nothing is parked). */\n  requestId: string | undefined;\n  /** The surface's thread `isRunning` read (mockable per surface). */\n  isRunning: boolean;\n  /**\n   * Dispatch the `run/input` resume for `requestId` on the surface's transport.\n   * Return the dispatch promise so a refused or lost command releases the lock\n   * at once and reaches `onResumeRejected`; a `void` return leaves the\n   * recovery paths below as the only release.\n   */\n  sendResume: (requestId: string, value: TValue) => void | Promise<unknown>;\n  /**\n   * The dispatch `sendResume` returned rejected — the host refused the\n   * `run/input` or the transport lost it. The lock is already released when\n   * this fires; the surface tells the user, since the request is back on\n   * screen with nothing else saying why.\n   */\n  onResumeRejected?: (error: unknown, requestId: string) => void;\n  /**\n   * A dispatch the transport lost is being re-sent for the still-parked\n   * request; `attempt` counts the retries so far (1-based). Diagnostics only —\n   * the lock stays held across the retry.\n   */\n  onResumeRetry?: (error: unknown, requestId: string, attempt: number) => void;\n  /**\n   * Automatic re-sends of a decision the transport lost\n   * ({@link isResumeTransportLoss}) while the request is still parked. `0`\n   * disables retries. Defaults to {@link HITL_RESUME_TRANSPORT_RETRIES}.\n   */\n  maxTransportRetries?: number;\n  /**\n   * Re-enable the actions when no resume run started within this window —\n   * covers a `run/input` that was rejected or lost before any run began, so\n   * neither reset path below can fire. Omit to keep the pre-existing surface\n   * behavior of staying locked until a resume run is observed.\n   */\n  pendingResumeGraceMs?: number;\n}\n\nexport interface ApprovalResumeLock<TValue> {\n  /** True after a resume until the request identity changes (or recovery fires). */\n  pending: boolean;\n  /**\n   * Send the resume value, locking the actions. No-op (returns `undefined`)\n   * while pending or unparked. Returns the dispatch promise when `sendResume`\n   * produced one, so a surface can hold its own state until the host settles.\n   */\n  resume: (value: TValue) => Promise<unknown> | undefined;\n}\n\n/**\n * Optimistic action lock shared by every approval surface: disable the\n * decision buttons the moment one is clicked, until the request identity\n * changes (it clears after the resume, or a fresh interrupt arrives). This\n * closes the double-click → duplicate-resume window.\n *\n * Recovery paths, in order of specificity:\n * 0. The dispatch itself rejected (a `sendResume` that returned a promise) —\n *    released at once, and reported through `onResumeRejected`. A rejection\n *    that is a transport loss (the socket dropped mid-flight) is re-sent up to\n *    `maxTransportRetries` times first, the lock held throughout, so a flaky\n *    connection does not hand the card back to the user for another click.\n *    The returned promise settles with the final attempt.\n * 1. Identity change — the resume landed (or a new interrupt replaced the\n *    request). Reset during render via React's \"previous value\" pattern.\n * 2. A resume run was observed starting and then settling with the request\n *    still pending (failed/cancelled resume) — clear the lock so the user can\n *    answer again.\n * 3. Optional grace window ({@link UseApprovalResumeLockOptions.pendingResumeGraceMs})\n *    for a `run/input` that never started a run at all.\n */\nexport function useApprovalResumeLock<TValue = Record<string, string>>(\n  options: UseApprovalResumeLockOptions<TValue>,\n): ApprovalResumeLock<TValue> {\n  const {\n    requestId,\n    isRunning,\n    sendResume,\n    pendingResumeGraceMs,\n    onResumeRejected,\n    onResumeRetry,\n    maxTransportRetries = HITL_RESUME_TRANSPORT_RETRIES,\n  } = options;\n\n  const [pending, setPending] = useState(false);\n  // Bumped per re-send so the grace window restarts with each attempt.\n  const [attempt, setAttempt] = useState(0);\n  const prevRequestIdRef = useRef(requestId);\n  if (prevRequestIdRef.current !== requestId) {\n    prevRequestIdRef.current = requestId;\n    if (pending) setPending(false);\n  }\n\n  // Track the resume run we kicked off (isRunning observed true→false while\n  // pending) and clear `pending` when it ends with the request unresolved.\n  const sawResumeRunRef = useRef(false);\n  useEffect(() => {\n    if (!pending) {\n      sawResumeRunRef.current = false;\n      return;\n    }\n    if (isRunning) {\n      sawResumeRunRef.current = true;\n      return;\n    }\n    if (sawResumeRunRef.current) {\n      sawResumeRunRef.current = false;\n      setPending(false);\n    }\n  }, [pending, isRunning]);\n\n  // Pre-start failure recovery: re-enable after the grace window when no\n  // resume run began; answering the still-parked request again is exactly\n  // what the user needs to be able to do.\n  useEffect(() => {\n    if (!pending || pendingResumeGraceMs === undefined) return;\n    const timer = setTimeout(() => {\n      if (!sawResumeRunRef.current) setPending(false);\n    }, pendingResumeGraceMs);\n    return () => clearTimeout(timer);\n  }, [pending, requestId, pendingResumeGraceMs, attempt]);\n\n  const sendResumeRef = useRef(sendResume);\n  sendResumeRef.current = sendResume;\n  const onResumeRejectedRef = useRef(onResumeRejected);\n  onResumeRejectedRef.current = onResumeRejected;\n  const onResumeRetryRef = useRef(onResumeRetry);\n  onResumeRetryRef.current = onResumeRetry;\n  const maxTransportRetriesRef = useRef(maxTransportRetries);\n  maxTransportRetriesRef.current = maxTransportRetries;\n  const currentRequestIdRef = useRef(requestId);\n  currentRequestIdRef.current = requestId;\n  const pendingRef = useRef(pending);\n  pendingRef.current = pending;\n  // One token per `resume` call: a settle from an earlier submission must not\n  // retry over, or release, a newer one for the same request.\n  const submissionRef = useRef(0);\n\n  const resume = useCallback(\n    (value: TValue): Promise<unknown> | undefined => {\n      if (requestId === undefined || pendingRef.current) return undefined;\n      const submission = ++submissionRef.current;\n      setPending(true);\n      pendingRef.current = true;\n      setAttempt(0);\n      const first: unknown = sendResumeRef.current(requestId, value);\n      if (!(first instanceof Promise)) return undefined;\n      // The final failure is already reported through `onResumeRejected`;\n      // callers that drop the promise must not get an unhandled rejection.\n      const outcome = new Promise<unknown>((resolve, reject) => {\n        const settle = (dispatched: Promise<unknown>, retries: number) => {\n          dispatched.then(resolve, (error: unknown) => {\n            // A late refusal for a request the lock has since moved past (the\n            // park was re-keyed, or a newer answer is in flight) must neither\n            // release that answer's lock nor be reported as a failure of it.\n            // The optimistic fold hides the answered request until the fold\n            // rolls back, so `undefined` here is not a departure.\n            const current = currentRequestIdRef.current;\n            if (\n              submission !== submissionRef.current ||\n              (current !== undefined && current !== requestId)\n            ) {\n              reject(error);\n              return;\n            }\n            if (retries < maxTransportRetriesRef.current && isResumeTransportLoss(error)) {\n              const next = retries + 1;\n              onResumeRetryRef.current?.(error, requestId, next);\n              setPending(true);\n              pendingRef.current = true;\n              setAttempt(next);\n              const resent: unknown = sendResumeRef.current(requestId, value);\n              if (resent instanceof Promise) {\n                settle(resent, next);\n                return;\n              }\n              resolve(undefined);\n              return;\n            }\n            setPending(false);\n            pendingRef.current = false;\n            onResumeRejectedRef.current?.(error, requestId);\n            reject(error);\n          });\n        };\n        settle(first, 0);\n      });\n      outcome.catch(() => {});\n      return outcome;\n    },\n    [requestId],\n  );\n\n  return { pending, resume };\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/lane-follow.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Followed subagent lanes — the client half of agora's `follow` interest
+ * (`message_window.follow_windows`).
+ *
+ * A running `task` card carries only its lane's newest steps (eight, with
+ * `athena_lane_truncated` counting the rest). A request that adds
+ * `follow: {before}` also covers the newest `before` steps of every lane a card
+ * in its window names: the resolution gains `follows`
+ * (`{ns: {chain, more, toolCallId}}`) and each step is its own `athena`
+ * document, keyed `[threadId, ns, stepId]`.
+ *
+ * A lane is followed through a request anchored at its card alone
+ * ({@link laneFollowRequest}), so following one lane pulls in no other and has
+ * the attach's whole step allowance. {@link readDeepAgentFollowedWindow} reads
+ * the followed steps back onto the card, so the card's tool-call part carries
+ * the whole live lane as its nested thread; {@link useDeepAgentLaneFollowSync}
+ * keeps the attach's follow requests to the running lanes a surface shows
+ * ({@link createDeepAgentLaneFollowRegistry}). It follows only on a host whose
+ * `protocol` lane advertises `DEEP_AGENT_LANE_FOLLOW_PROTOCOL_VERSION`; a host
+ * that refuses `follow` anyway (`invalid-interest`, one predating it) keeps the
+ * attach's windows, and the cards keep the steps their own documents carry.
+ *
+ * Surfaces opt in. A surface that follows nothing ships none of this and sees
+ * the wire it saw before.
+ */
+import type { LangChainMessage } from '@assistant-ui/react-langgraph';
+import { type DeepAgentInterestRequest, type DeepAgentMessageWindow, readDeepAgentMessageWindow } from './message-window';
+type MountedDocuments = Parameters<typeof readDeepAgentMessageWindow>[0];
+/** A request following the lane one `task` card holds. */
+export interface DeepAgentLaneFollowRequest extends DeepAgentInterestRequest {
+    readonly at: string;
+    readonly follow: {
+        readonly before: number;
+    };
+}
+/**
+ * The request following the lane of the running `task` card `cardId`: the card
+ * alone (`before: 1`), so its window names no other card's lane, with as many
+ * of its lane's newest steps as one attach follows.
+ */
+export declare function laneFollowRequest(cardId: string): DeepAgentLaneFollowRequest;
+export declare function isLaneFollowRequest(request: DeepAgentInterestRequest): request is DeepAgentLaneFollowRequest;
+/** What an attach follows, read off its mounted documents. */
+export interface DeepAgentLaneFollows {
+    /** The follow requests the attach holds whose card is still in the transcript. */
+    readonly requests: readonly DeepAgentLaneFollowRequest[];
+    /** Each followed lane's mounted steps, oldest first, by the `task` call whose card holds it. */
+    readonly lanes: ReadonlyMap<string, readonly LangChainMessage[]>;
+}
+/**
+ * The attach's follow requests and followed lanes. A step whose document is
+ * not mounted is left out; a lane two windows follow is read from the deeper
+ * one. A malformed window or step reads as absent.
+ */
+export declare function readDeepAgentLaneFollows(mounted: MountedDocuments): DeepAgentLaneFollows;
+/**
+ * A running card's transcript with its followed lane read in. A cut card
+ * carries its lane's newest steps whole, led by its first `cutTurns` entries:
+ * the older assistant turns that requested results among them, cut to those
+ * calls. The merge is the followed steps older than the card's newest, then
+ * the card's newest steps, then any followed step newer than all of them. The
+ * card's newest copies are the fuller ones (a lane step's document leaves every
+ * inline image a placeholder), and only the card carries a step without an id,
+ * which no follow addresses; the follow holds the cut turns whole, with the
+ * steps between them and the newest, and a cut turn it does not hold leads.
+ */
+export declare function mergeFollowedLane(carried: readonly unknown[], followed: readonly LangChainMessage[], cutTurns?: number): readonly unknown[];
+/**
+ * {@link readDeepAgentMessageWindow} with the attach's followed lanes read in.
+ * The follow requests ride at the end of `requests`, so a restatement built
+ * from this window (the thread's head widening, a page of older history) keeps
+ * them: the joined view never counts them as pages. Each running card a follow
+ * covers carries its lane's followed steps as its transcript, kept as the same
+ * object while its steps stand. Without follows, the window is
+ * {@link readDeepAgentMessageWindow}'s own.
+ */
+export declare function readDeepAgentFollowedWindow(mounted: MountedDocuments): DeepAgentMessageWindow | null;
+/**
+ * The lanes a surface shows (an open transcript drawer's), by the `task` call
+ * whose card holds each: what {@link useDeepAgentLaneFollowSync} follows.
+ */
+export interface DeepAgentLaneFollowRegistry {
+    /** Follow the lane of the `task` call `toolCallId` until the returned release is called. */
+    follow(toolCallId: string): () => void;
+    subscribe(listener: () => void): () => void;
+    /** The `task` calls whose lanes are followed; a new set on every change. */
+    getSnapshot(): ReadonlySet<string>;
+}
+export declare function createDeepAgentLaneFollowRegistry(): DeepAgentLaneFollowRegistry;
+/** Follows the lane of `toolCallId` while `active` (a drawer open on a running lane). */
+export declare function useDeepAgentLaneFollow(registry: DeepAgentLaneFollowRegistry | null, toolCallId: string, active: boolean): void;
+export interface UseDeepAgentLaneFollowSyncOptions {
+    /** The lanes the surface shows. */
+    registry: DeepAgentLaneFollowRegistry;
+    /**
+     * Another statement on the interest lane is in flight (a page of older
+     * history): wait for it, so neither statement drops what the other adds.
+     */
+    paused?: boolean;
+    /**
+     * A follow statement failed. A host that does not serve `follow` is not a
+     * failure: the cards keep the lanes their own documents carry.
+     */
+    onError?: ((error: unknown) => void) | undefined;
+}
+/**
+ * Keeps the attach's follow requests to the running lanes the registry holds,
+ * once per change, on a host whose `protocol` lane advertises at least
+ * `DEEP_AGENT_LANE_FOLLOW_PROTOCOL_VERSION`. A statement restates the
+ * attach's other requests as the window holds them, with the follows after
+ * them, inside the host's interest cap; a statement elsewhere that left a
+ * follow out (a page of older history) is answered by stating it again.
+ *
+ * Never a retry loop: a statement is not sent again unchanged on the same
+ * connection. A host that refuses `follow` (`invalid-interest`, one that
+ * predates it) keeps the attach's windows, and nothing is followed on that
+ * connection again; a card that left the transcript first (`unknown-message`)
+ * is not followed until the transcript moves.
+ */
+export declare function useDeepAgentLaneFollowSync({ registry, paused, onError, }: UseDeepAgentLaneFollowSyncOptions): void;
+export {};

package/dist/agent-runtime/src/lane-history.cjs

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const store = require("@assistant-ui/store");
+const reactQuery = require("@tanstack/react-query");
+const react = require("react");
+const runconfigContract = require("./generated/runconfig-contract.cjs");
+const messageWindow = require("./message-window.cjs");
+const protocol = require("./protocol.cjs");
+const subagents = require("./subagents.cjs");
+const threadExtras = require("./thread-extras.cjs");
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isCount = (value) => typeof value === "number" && Number.isInteger(value) && value >= 0;
+const entryId = (entry) => {
+  const id = isRecord(entry) ? entry.id : void 0;
+  return typeof id === "string" ? id : void 0;
+};
+function buildHistoryLaneCommand({
+  target,
+  at
+}) {
+  return {
+    type: runconfigContract.DEEP_AGENT_HISTORY_LANE_COMMAND,
+    ...target.lane !== void 0 ? { lane: target.lane } : { messageId: target.messageId },
+    before: runconfigContract.DEEP_AGENT_MAX_LANE_PAGE,
+    ...at !== void 0 && { at }
+  };
+}
+const nonEmpty = (value) => typeof value === "string" && value ? value : null;
+function readHistoryLanePage(payload) {
+  if (!isRecord(payload)) return null;
+  const { steps, more, total } = payload;
+  const messageId = nonEmpty(payload.messageId);
+  const lane = nonEmpty(payload.lane);
+  if (messageId === null === (lane === null) || !Array.isArray(steps)) return null;
+  if (!isRecord(more) || typeof more.before !== "boolean" || !isCount(total)) return null;
+  return {
+    messageId,
+    lane,
+    steps: steps.filter((step) => entryId(step) !== void 0),
+    hasEarlier: more.before,
+    total
+  };
+}
+const answers = (page, target) => target.lane !== void 0 ? page.lane === target.lane : page.messageId === target.messageId;
+function isWholeCardRefusal(error) {
+  const failure = isRecord(error) ? error.failure : void 0;
+  return isRecord(failure) && failure.fate === "rejected" && typeof failure.message === "string" && failure.message.includes(runconfigContract.DEEP_AGENT_HISTORY_MESSAGE_COMMAND);
+}
+const callCount = (entry) => {
+  var _a;
+  return entry.type === "ai" ? ((_a = entry.tool_calls) == null ? void 0 : _a.length) ?? 0 : 0;
+};
+function mergeLaneHistory({
+  history,
+  carried,
+  whole = false
+}) {
+  if (history.length === 0) return carried;
+  const held = /* @__PURE__ */ new Set();
+  for (const entry of history) {
+    const id = entryId(entry);
+    if (id !== void 0) held.add(id);
+  }
+  let anchor = -1;
+  for (let index = carried.length - 1; index >= 0; index -= 1) {
+    const id = entryId(carried[index]);
+    if (id !== void 0 && held.has(id)) {
+      anchor = index;
+      break;
+    }
+  }
+  if (anchor < 0) return whole ? history : [...history, ...carried];
+  const own = /* @__PURE__ */ new Map();
+  for (const entry of carried) {
+    const id = entryId(entry);
+    if (id !== void 0) own.set(id, entry);
+  }
+  const read = history.map((entry) => {
+    const id = entryId(entry);
+    const mine = id === void 0 ? void 0 : own.get(id);
+    return mine !== void 0 && callCount(mine) >= callCount(entry) ? mine : entry;
+  });
+  const older = carried.slice(0, anchor).filter((entry) => {
+    const id = entryId(entry);
+    return id !== void 0 && !held.has(id);
+  });
+  return [...older, ...read, ...carried.slice(anchor + 1)];
+}
+const laneTargetKey = (target) => target.lane !== void 0 ? `lane:${target.lane}` : `card:${target.messageId}`;
+const deepAgentLaneHistoryQueryKey = ({
+  target,
+  mount
+}) => ["athena-deep-agent", "history-lane", target, ...mount === void 0 ? [] : [mount]];
+let mountCount = 0;
+const nextMount = () => {
+  mountCount += 1;
+  return mountCount;
+};
+async function readLanePage({
+  sendCommand,
+  target,
+  at
+}) {
+  try {
+    const page = readHistoryLanePage(await sendCommand(buildHistoryLaneCommand({ target, at })));
+    if (page === null || !answers(page, target)) {
+      throw new Error("history/lane answered another card or lane");
+    }
+    return { steps: page.steps, hasEarlier: page.hasEarlier, total: page.total, whole: false };
+  } catch (error) {
+    if (target.messageId === void 0 || !isWholeCardRefusal(error)) throw error;
+    const result = messageWindow.readHistoryMessageResult(
+      await sendCommand(messageWindow.buildHistoryMessageCommand({ messageId: target.messageId }))
+    );
+    if (result === null || result.messageId !== target.messageId) {
+      throw new Error("history/message answered another message");
+    }
+    const card = result.message;
+    const steps = subagents.nestedMessagesFromArtifact(isRecord(card) ? card.artifact : void 0);
+    return { steps, hasEarlier: false, total: steps.length, whole: true };
+  }
+}
+function useDeepAgentLaneHistory({
+  messageId,
+  lane,
+  carried,
+  total,
+  finished = false,
+  checkpointed = false,
+  auto = false
+}) {
+  var _a;
+  const sendCommand = store.useAuiState(
+    (s) => threadExtras.hasStatewireThreadExtras(s.thread.extras) ? s.thread.extras.sendCommand : void 0
+  );
+  const hostVersion = store.useAuiState((s) => {
+    var _a2;
+    const extras = s.thread.extras;
+    return ((_a2 = protocol.readDeepAgentProtocol(extras == null ? void 0 : extras.state)) == null ? void 0 : _a2.version) ?? 0;
+  });
+  const sendRef = react.useRef(sendCommand);
+  sendRef.current = sendCommand;
+  const [mount] = react.useState(nextMount);
+  const [asked, setAsked] = react.useState(false);
+  const target = react.useMemo(
+    () => lane !== void 0 ? { lane } : messageId !== void 0 ? { messageId } : void 0,
+    [lane, messageId]
+  );
+  const settled = finished || checkpointed;
+  const askable = (total !== void 0 || checkpointed) && target !== void 0 && sendCommand !== void 0 && (target.lane !== void 0 || settled || hostVersion >= runconfigContract.DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION);
+  const query = reactQuery.useInfiniteQuery({
+    queryKey: deepAgentLaneHistoryQueryKey({
+      target: target === void 0 ? "" : laneTargetKey(target),
+      mount: settled ? void 0 : mount
+    }),
+    queryFn: ({ pageParam }) => {
+      const send = sendRef.current;
+      if (target === void 0 || send === void 0) {
+        return Promise.reject(new Error("no statewire thread to read the lane from"));
+      }
+      return readLanePage({ sendCommand: send, target, at: pageParam });
+    },
+    initialPageParam: void 0,
+    getNextPageParam: (last) => last.hasEarlier ? entryId(last.steps[0]) : void 0,
+    enabled: askable && (auto || asked),
+    retry: false,
+    retryOnMount: false,
+    staleTime: Number.POSITIVE_INFINITY,
+    refetchOnMount: false,
+    refetchOnWindowFocus: false,
+    refetchOnReconnect: false
+  });
+  const pages = (_a = query.data) == null ? void 0 : _a.pages;
+  const history = react.useMemo(() => {
+    var _a2, _b;
+    if (pages === void 0 || pages.length === 0) return null;
+    const entries = [...pages].reverse().flatMap((page) => page.steps);
+    return { entries, whole: ((_a2 = pages[0]) == null ? void 0 : _a2.whole) === true, total: ((_b = pages[0]) == null ? void 0 : _b.total) ?? 0 };
+  }, [pages]);
+  const available = askable && !query.isError;
+  const steps = react.useMemo(
+    () => history === null ? carried : mergeLaneHistory({ history: history.entries, carried, whole: history.whole }),
+    [history, carried]
+  );
+  const hasEarlier = available && (history === null ? checkpointed || steps.length < (total ?? 0) : query.hasNextPage);
+  const loading = query.isFetching;
+  const { fetchNextPage } = query;
+  const loadEarlier = react.useCallback(() => {
+    if (!hasEarlier || loading) return;
+    if (history === null) setAsked(true);
+    else void fetchNextPage();
+  }, [fetchNextPage, hasEarlier, history, loading]);
+  return {
+    steps,
+    // A lane read without a marker (a checkpointed one) counts what its pages say.
+    total: total === void 0 ? history == null ? void 0 : history.total : Math.max(total, (history == null ? void 0 : history.total) ?? 0),
+    available,
+    hasEarlier,
+    loading,
+    loadEarlier
+  };
+}
+exports.buildHistoryLaneCommand = buildHistoryLaneCommand;
+exports.deepAgentLaneHistoryQueryKey = deepAgentLaneHistoryQueryKey;
+exports.isWholeCardRefusal = isWholeCardRefusal;
+exports.mergeLaneHistory = mergeLaneHistory;
+exports.readHistoryLanePage = readHistoryLanePage;
+exports.useDeepAgentLaneHistory = useDeepAgentLaneHistory;
+//# sourceMappingURL=lane-history.cjs.map

package/dist/agent-runtime/src/lane-history.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-history.cjs","sources":["../../../../agent-runtime/src/lane-history.ts"],"sourcesContent":["/**\n * A card's whole nested transcript on demand — the client half of agora's\n * `history/lane` read command.\n *\n * A card's own document carries its nested transcript (a `task` subagent's\n * lane) cut to its newest entries whenever older ones are left off — a running\n * card always, and on a version-2 view a finished one too — counting the whole\n * stored transcript under `athena_lane_truncated`. `history/lane`\n * `{messageId, before, at?}` answers a page of it: the newest `before` entries,\n * or those strictly older than `at`, oldest first, each projected like a\n * followed lane step (every inline image a placeholder), with\n * `{more: {before}, total}`. {@link useDeepAgentLaneHistory} pages one card's\n * transcript for a surface that shows it whole, and {@link mergeLaneHistory}\n * reads the pages in under the card's own live entries.\n *\n * An in-eval dispatch's lane (`task()` inside `eval`) streams the same way on\n * its `ptc_subagents` registry entry: its newest steps, the marker counting the\n * lane, running or finished. `history/lane` `{lane, before, at?}` pages it by\n * the dispatch id (the registry key, never with `messageId`), and answers the\n * same page with `lane` set and `messageId` null. A lane whose steps no longer\n * ride pages the same way from its subagent checkpoint once agora recorded its\n * namespace (`ns`), `checkpointed`: a previous run's lane in this activation\n * (a later run left its registry entry only its summary and `ns`), or a\n * reopened session's (the registry died with the activation that streamed it,\n * and the summary its eval persisted records `ns`). It carries no steps, and\n * the first page names the total.\n *\n * Only a cut card or lane is paged. A finished card is cut only by a host that\n * serves `history/lane`, so it is always asked, and so is a cut in-eval lane\n * (a client that never sends `lane` needs no gate); a running card is asked\n * only when the host's `protocol` lane advertises\n * `DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION`. A card whose entries carry no ids\n * cannot be paged: the host says to read the card whole with\n * `history/message`, and that one read stands for the lane. Any other refusal\n * (an older pod answers `history/lane` as an unknown command, or wants a\n * `messageId`; a lane with no recorded checkpoint) leaves the surface on the\n * entries it carries: no error, and that mount never asks again.\n *\n * Surfaces opt in. A surface that pages nothing ships none of this.\n */\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { type InfiniteData, useInfiniteQuery } from '@tanstack/react-query';\nimport { useCallback, useMemo, useRef, useState } from 'react';\nimport {\n  DEEP_AGENT_HISTORY_LANE_COMMAND,\n  DEEP_AGENT_HISTORY_MESSAGE_COMMAND,\n  DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION,\n  DEEP_AGENT_MAX_LANE_PAGE,\n} from './generated/runconfig-contract';\nimport { buildHistoryMessageCommand, readHistoryMessageResult } from './message-window';\nimport { readDeepAgentProtocol } from './protocol';\nimport { nestedMessagesFromArtifact } from './subagents';\nimport { hasStatewireThreadExtras } from './thread-extras';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst isCount = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isInteger(value) && value >= 0;\n\nconst entryId = (entry: unknown): string | undefined => {\n  const id = isRecord(entry) ? entry.id : undefined;\n  return typeof id === 'string' ? id : undefined;\n};\n\n/**\n * The `history/lane` read command on the statewire command union, so\n * `sendCommand({ type: 'history/lane', … })` typechecks wherever the deep-agent\n * host is driven (an attach-ACL read, like `history/message`).\n */\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /** A page of one card's nested transcript. */\n      historyLane: HistoryLaneCommand;\n    }\n  }\n}\n\n/**\n * What one `history/lane` read pages: a card's nested transcript, by the card's\n * message id (a finished card or a running placeholder), or an in-eval\n * dispatch's lane, by its dispatch id.\n */\nexport type DeepAgentLaneTarget =\n  | { readonly messageId: string; readonly lane?: undefined }\n  | { readonly lane: string; readonly messageId?: undefined };\n\n/** The `history/lane` command: a page of one card's or lane's steps, oldest first. */\nexport type HistoryLaneCommand = {\n  readonly type: typeof DEEP_AGENT_HISTORY_LANE_COMMAND;\n  /** Entries in the page (`1..DEEP_AGENT_MAX_LANE_PAGE`). */\n  readonly before: number;\n  /** An entry id: the page holds the entries strictly older than it. Without it, the newest. */\n  readonly at?: string;\n} & ({ readonly messageId: string } | { readonly lane: string });\n\nexport function buildHistoryLaneCommand({\n  target,\n  at,\n}: {\n  target: DeepAgentLaneTarget;\n  at?: string | undefined;\n}): HistoryLaneCommand {\n  return {\n    type: DEEP_AGENT_HISTORY_LANE_COMMAND,\n    ...(target.lane !== undefined ? { lane: target.lane } : { messageId: target.messageId }),\n    before: DEEP_AGENT_MAX_LANE_PAGE,\n    ...(at !== undefined && { at }),\n  };\n}\n\n/** One page `history/lane` answered. */\nexport interface HistoryLanePage {\n  /** The card it pages; `null` for a lane. */\n  readonly messageId: string | null;\n  /** The in-eval lane it pages; `null` for a card (a host that predates lanes leaves it out). */\n  readonly lane: string | null;\n  /** The page's entries, oldest first; an entry without a string id is never in one. */\n  readonly steps: readonly LangChainMessage[];\n  /** Whether entries older than the page remain. */\n  readonly hasEarlier: boolean;\n  /** Entries the card's transcript, or the lane's checkpoint, stores. */\n  readonly total: number;\n}\n\nconst nonEmpty = (value: unknown): string | null =>\n  typeof value === 'string' && value ? value : null;\n\nexport function readHistoryLanePage(payload: unknown): HistoryLanePage | null {\n  if (!isRecord(payload)) return null;\n  const { steps, more, total } = payload;\n  const messageId = nonEmpty(payload.messageId);\n  const lane = nonEmpty(payload.lane);\n  if ((messageId === null) === (lane === null) || !Array.isArray(steps)) return null;\n  if (!isRecord(more) || typeof more.before !== 'boolean' || !isCount(total)) return null;\n  return {\n    messageId,\n    lane,\n    steps: steps.filter((step): step is LangChainMessage => entryId(step) !== undefined),\n    hasEarlier: more.before,\n    total,\n  };\n}\n\n/** Whether a page answers a read of `target`. */\nconst answers = (page: HistoryLanePage, target: DeepAgentLaneTarget): boolean =>\n  target.lane !== undefined ? page.lane === target.lane : page.messageId === target.messageId;\n\n/**\n * Whether `history/lane` was refused because the lane's entries carry no ids\n * to page by: the host names `history/message` as the way to read the card.\n */\nexport function isWholeCardRefusal(error: unknown): boolean {\n  const failure = isRecord(error) ? error.failure : undefined;\n  return (\n    isRecord(failure) &&\n    failure.fate === 'rejected' &&\n    typeof failure.message === 'string' &&\n    failure.message.includes(DEEP_AGENT_HISTORY_MESSAGE_COMMAND)\n  );\n}\n\n/** The tool calls an assistant entry makes. */\nconst callCount = (entry: LangChainMessage): number =>\n  entry.type === 'ai' ? (entry.tool_calls?.length ?? 0) : 0;\n\n/**\n * A card's transcript with its paged history read in: the history (whole,\n * oldest first), then the card's own entries newer than the last one the\n * history holds — what the lane did since the history was read. The card's\n * entries older than that one and not in the history yet (a page cut short by\n * its size, or a turn the card keeps for a result it holds) come first, so the\n * view never shows less than the card. An entry the card also carries is the\n * card's copy, which is the newer one: a page is a snapshot, which can catch a\n * step mid-stream, and leaves every inline image a placeholder. The exception\n * is a turn the card keeps cut to the calls it holds results for, which\n * carries fewer calls than the page's copy. Without history, the card's own\n * entries. `whole` history is the card's entire transcript as it was read;\n * when none of its entries can be matched to the card's (they carry no ids),\n * it stands alone.\n */\nexport function mergeLaneHistory({\n  history,\n  carried,\n  whole = false,\n}: {\n  history: readonly LangChainMessage[];\n  carried: readonly LangChainMessage[];\n  whole?: boolean;\n}): readonly LangChainMessage[] {\n  if (history.length === 0) return carried;\n  const held = new Set<string>();\n  for (const entry of history) {\n    const id = entryId(entry);\n    if (id !== undefined) held.add(id);\n  }\n  let anchor = -1;\n  for (let index = carried.length - 1; index >= 0; index -= 1) {\n    const id = entryId(carried[index]);\n    if (id !== undefined && held.has(id)) {\n      anchor = index;\n      break;\n    }\n  }\n  if (anchor < 0) return whole ? history : [...history, ...carried];\n  const own = new Map<string, LangChainMessage>();\n  for (const entry of carried) {\n    const id = entryId(entry);\n    if (id !== undefined) own.set(id, entry);\n  }\n  const read = history.map((entry) => {\n    const id = entryId(entry);\n    const mine = id === undefined ? undefined : own.get(id);\n    return mine !== undefined && callCount(mine) >= callCount(entry) ? mine : entry;\n  });\n  const older = carried.slice(0, anchor).filter((entry) => {\n    const id = entryId(entry);\n    return id !== undefined && !held.has(id);\n  });\n  return [...older, ...read, ...carried.slice(anchor + 1)];\n}\n\n/** What a surface shows of one card's or lane's steps. */\nexport interface DeepAgentLaneHistoryState {\n  /** The steps with the history read so far; the steps it carries before any. */\n  readonly steps: readonly LangChainMessage[];\n  /** Entries the transcript stores, when it is cut (a checkpointed lane's, once a page counted them). */\n  readonly total: number | undefined;\n  /** The host answers `history/lane` for this card or lane, and has not refused it. */\n  readonly available: boolean;\n  /** Entries older than the ones read remain, and can be asked for. */\n  readonly hasEarlier: boolean;\n  readonly loading: boolean;\n  /** Read the page before the earliest entry read so far (the newest page first). */\n  readonly loadEarlier: () => void;\n}\n\n/** One `history/lane` page as the pager holds it. */\ninterface LanePageData {\n  /** The page's entries, oldest first. */\n  readonly steps: readonly LangChainMessage[];\n  readonly hasEarlier: boolean;\n  readonly total: number;\n  /** The card's whole transcript, read with `history/message`. */\n  readonly whole: boolean;\n}\n\n/** One key per card or lane, so a card and a lane never share history or a refusal. */\nconst laneTargetKey = (target: DeepAgentLaneTarget): string =>\n  target.lane !== undefined ? `lane:${target.lane}` : `card:${target.messageId}`;\n\n/**\n * The query key one card's or lane's pages are cached under. A finished card or\n * lane never changes, so its pages are kept while it is cached; a running one\n * is read afresh by each surface that mounts it (`mount`), since an old page of\n * a lane that kept running could leave a gap before the steps it carries now.\n */\nexport const deepAgentLaneHistoryQueryKey = ({\n  target,\n  mount,\n}: {\n  target: string;\n  mount?: number | undefined;\n}) => ['athena-deep-agent', 'history-lane', target, ...(mount === undefined ? [] : [mount])];\n\nlet mountCount = 0;\nconst nextMount = (): number => {\n  mountCount += 1;\n  return mountCount;\n};\n\ntype SendCommand = StatewireThread.Extras['sendCommand'];\n\n/** One page of `target`: `history/lane`, or the card whole when its entries carry no ids. */\nasync function readLanePage({\n  sendCommand,\n  target,\n  at,\n}: {\n  sendCommand: SendCommand;\n  target: DeepAgentLaneTarget;\n  at: string | undefined;\n}): Promise<LanePageData> {\n  try {\n    const page = readHistoryLanePage(await sendCommand(buildHistoryLaneCommand({ target, at })));\n    if (page === null || !answers(page, target)) {\n      throw new Error('history/lane answered another card or lane');\n    }\n    return { steps: page.steps, hasEarlier: page.hasEarlier, total: page.total, whole: false };\n  } catch (error) {\n    if (target.messageId === undefined || !isWholeCardRefusal(error)) throw error;\n    const result = readHistoryMessageResult(\n      await sendCommand(buildHistoryMessageCommand({ messageId: target.messageId }))\n    );\n    if (result === null || result.messageId !== target.messageId) {\n      throw new Error('history/message answered another message');\n    }\n    const card: unknown = result.message;\n    const steps = nestedMessagesFromArtifact(isRecord(card) ? card.artifact : undefined);\n    return { steps, hasEarlier: false, total: steps.length, whole: true };\n  }\n}\n\n/**\n * Pages one card's transcript, or one in-eval lane, through `history/lane` for\n * a surface that shows it whole, as a TanStack infinite query. `auto` reads\n * the newest page as soon as it is cut (an open transcript drawer); otherwise\n * nothing is read until `loadEarlier`. A card whose message id changes (its\n * result replaced the running placeholder) is a new query. A refusal is the\n * query's error: never retried or refetched, so it costs one command, and the\n * surface stays on the steps it carries with no error.\n */\nexport function useDeepAgentLaneHistory({\n  messageId,\n  lane,\n  carried,\n  total,\n  finished = false,\n  checkpointed = false,\n  auto = false,\n}: {\n  /** The card's message id, for a `task` lane. */\n  messageId?: string | undefined;\n  /** The dispatch id, for an in-eval lane; wins over `messageId`. Neither: nothing to page. */\n  lane?: string | undefined;\n  /** The steps the card or the lane's registry entry carries. */\n  carried: readonly LangChainMessage[];\n  /** The cut marker's `messages`; `undefined` while every step rides. */\n  total: number | undefined;\n  /** The cut marker says the lane finished (only a host serving `history/lane` cuts a card then). */\n  finished?: boolean;\n  /**\n   * No steps ride: an in-eval lane a later run or a reopen left only its\n   * summary and namespace. It carries no steps and no marker, `history/lane`\n   * pages its subagent's own steps from its checkpoint, and the first page\n   * names their total.\n   */\n  checkpointed?: boolean;\n  auto?: boolean;\n}): DeepAgentLaneHistoryState {\n  const sendCommand = useAuiState((s) =>\n    hasStatewireThreadExtras(s.thread.extras)\n      ? (s.thread.extras as StatewireThread.Extras).sendCommand\n      : undefined\n  );\n  const hostVersion = useAuiState((s) => {\n    const extras = s.thread.extras as Partial<StatewireThread.Extras> | undefined;\n    return readDeepAgentProtocol(extras?.state)?.version ?? 0;\n  });\n  const sendRef = useRef(sendCommand);\n  sendRef.current = sendCommand;\n  const [mount] = useState(nextMount);\n  const [asked, setAsked] = useState(false);\n\n  const target = useMemo<DeepAgentLaneTarget | undefined>(\n    () =>\n      lane !== undefined ? { lane } : messageId !== undefined ? { messageId } : undefined,\n    [lane, messageId]\n  );\n  // A checkpointed lane's steps were left off once its run had ended.\n  const settled = finished || checkpointed;\n  const askable =\n    (total !== undefined || checkpointed) &&\n    target !== undefined &&\n    sendCommand !== undefined &&\n    (target.lane !== undefined || settled || hostVersion >= DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION);\n\n  const query = useInfiniteQuery<\n    LanePageData,\n    Error,\n    InfiniteData<LanePageData, string | undefined>,\n    readonly unknown[],\n    string | undefined\n  >({\n    queryKey: deepAgentLaneHistoryQueryKey({\n      target: target === undefined ? '' : laneTargetKey(target),\n      mount: settled ? undefined : mount,\n    }),\n    queryFn: ({ pageParam }) => {\n      const send = sendRef.current;\n      if (target === undefined || send === undefined) {\n        return Promise.reject(new Error('no statewire thread to read the lane from'));\n      }\n      return readLanePage({ sendCommand: send, target, at: pageParam });\n    },\n    initialPageParam: undefined,\n    getNextPageParam: (last) => (last.hasEarlier ? entryId(last.steps[0]) : undefined),\n    enabled: askable && (auto || asked),\n    retry: false,\n    retryOnMount: false,\n    staleTime: Number.POSITIVE_INFINITY,\n    refetchOnMount: false,\n    refetchOnWindowFocus: false,\n    refetchOnReconnect: false,\n  });\n\n  const pages = query.data?.pages;\n  const history = useMemo(() => {\n    if (pages === undefined || pages.length === 0) return null;\n    // Pages arrive newest first; each is strictly older than the one before.\n    const entries = [...pages].reverse().flatMap((page) => page.steps);\n    return { entries, whole: pages[0]?.whole === true, total: pages[0]?.total ?? 0 };\n  }, [pages]);\n  const available = askable && !query.isError;\n  const steps = useMemo(\n    () =>\n      history === null\n        ? carried\n        : mergeLaneHistory({ history: history.entries, carried, whole: history.whole }),\n    [history, carried]\n  );\n  // Before its first page, a checkpointed lane has every step still to read.\n  const hasEarlier =\n    available &&\n    (history === null ? checkpointed || steps.length < (total ?? 0) : query.hasNextPage);\n  const loading = query.isFetching;\n  const { fetchNextPage } = query;\n  const loadEarlier = useCallback(() => {\n    if (!hasEarlier || loading) return;\n    if (history === null) setAsked(true);\n    else void fetchNextPage();\n  }, [fetchNextPage, hasEarlier, history, loading]);\n\n  return {\n    steps,\n    // A lane read without a marker (a checkpointed one) counts what its pages say.\n    total: total === undefined ? history?.total : Math.max(total, history?.total ?? 0),\n    available,\n    hasEarlier,\n    loading,\n    loadEarlier,\n  };\n}\n"],"names":["DEEP_AGENT_HISTORY_LANE_COMMAND","DEEP_AGENT_MAX_LANE_PAGE","DEEP_AGENT_HISTORY_MESSAGE_COMMAND","readHistoryMessageResult","buildHistoryMessageCommand","nestedMessagesFromArtifact","useAuiState","hasStatewireThreadExtras","readDeepAgentProtocol","useRef","useState","useMemo","DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION","useInfiniteQuery","_a","useCallback"],"mappings":"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"}