@athenaintel/react 0.54.0 → 0.55.0

package/dist/chat-ui/statewire.cjs

@@ -6,6 +6,8 @@ const useStatewireApprovalRequest = require("../chat/use-statewire-approval-requ
 const StatewireRunRefusalNotice = require("../chat/StatewireRunRefusalNotice.cjs");
 const StatewireQueuedMessages = require("../chat/StatewireQueuedMessages.cjs");
 const statewireHistoryEdge = require("./thread/statewire-history-edge.cjs");
+const earlierStepsButton = require("../chat/super-grouping/earlier-steps-button.cjs");
+const useTurnSteps = require("../chat/super-grouping/use-turn-steps.cjs");
 const statewireWindowContext = require("../provider/statewire-window-context.cjs");
 const continuePill = require("./messages/continue-pill.cjs");
 const runtimeMessage = require("./messages/runtime-message.cjs");
@@ -23,7 +25,11 @@ exports.StatewireRunRefusalNotice = StatewireRunRefusalNotice.StatewireRunRefusa
 exports.StatewireQueuedMessages = StatewireQueuedMessages.StatewireQueuedMessages;
 exports.HistoryEdgeRow = statewireHistoryEdge.HistoryEdgeRow;
 exports.StatewireHistoryEdge = statewireHistoryEdge.StatewireHistoryEdge;
+exports.EarlierStepsButton = earlierStepsButton.EarlierStepsButton;
+exports.TurnStepsControlContext = useTurnSteps.TurnStepsControlContext;
+exports.StatewireHistoryPagesContext = statewireWindowContext.StatewireHistoryPagesContext;
 exports.StatewireToolOutputsContext = statewireWindowContext.StatewireToolOutputsContext;
+exports.useStatewireHistoryPages = statewireWindowContext.useStatewireHistoryPages;
 exports.useStatewireToolOutputs = statewireWindowContext.useStatewireToolOutputs;
 exports.ContinuePill = continuePill.ContinuePill;
 exports.RuntimeMessageCard = runtimeMessage.RuntimeMessageCard;

package/dist/chat-ui/statewire.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"statewire.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"statewire.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/chat-ui/statewire.d.ts

@@ -15,7 +15,9 @@ export { type StatewireApprovalRequest, type StatewireApprovalWait, type Statewi
 export { RUN_START_REFUSAL_FALLBACK_MESSAGE, StatewireRunRefusalNotice, type StatewireRunRefusalNoticeProps, } from "../chat/StatewireRunRefusalNotice";
 export { StatewireQueuedMessages, type StatewireQueueEditorContext, type StatewireQueueEvent, type StatewireQueueRowContentContext, type StatewireQueueRowMarkerContext, type StatewireQueuedMessagesProps, } from "../chat/StatewireQueuedMessages";
 export { HistoryEdgeRow, type HistoryEdgeRowProps, StatewireHistoryEdge, type StatewireHistoryEdgeProps, } from "./thread/statewire-history-edge";
-export { StatewireToolOutputsContext, useStatewireToolOutputs, } from "../provider/statewire-window-context";
+export { EarlierStepsButton } from "../chat/super-grouping/earlier-steps-button";
+export { type TurnStepsControlProps, TurnStepsControlContext, } from "../chat/super-grouping/use-turn-steps";
+export { StatewireHistoryPagesContext, StatewireToolOutputsContext, useStatewireHistoryPages, useStatewireToolOutputs, } from "../provider/statewire-window-context";
 export { ContinuePill } from "./messages/continue-pill";
 export { RuntimeMessageCard, type RuntimeMessageCardProps } from "./messages/runtime-message";
 export { WakeMarkerCard, type WakeMarkerCardProps, WakeMarkerMessage, } from "./messages/wake-marker";

package/dist/chat-ui/statewire.js

@@ -4,7 +4,9 @@ import { useStatewireApprovalRequest, useStatewireApprovalWait } from "../chat/u
 import { RUN_START_REFUSAL_FALLBACK_MESSAGE, StatewireRunRefusalNotice } from "../chat/StatewireRunRefusalNotice.js";
 import { StatewireQueuedMessages } from "../chat/StatewireQueuedMessages.js";
 import { HistoryEdgeRow, StatewireHistoryEdge } from "./thread/statewire-history-edge.js";
-import { StatewireToolOutputsContext, useStatewireToolOutputs } from "../provider/statewire-window-context.js";
+import { EarlierStepsButton } from "../chat/super-grouping/earlier-steps-button.js";
+import { TurnStepsControlContext } from "../chat/super-grouping/use-turn-steps.js";
+import { StatewireHistoryPagesContext, StatewireToolOutputsContext, useStatewireHistoryPages, useStatewireToolOutputs } from "../provider/statewire-window-context.js";
 import { ContinuePill } from "./messages/continue-pill.js";
 import { RuntimeMessageCard } from "./messages/runtime-message.js";
 import { WakeMarkerCard, WakeMarkerMessage } from "./messages/wake-marker.js";
@@ -13,6 +15,7 @@ import { StatewireContinueRunAffordance, StatewireContinueRunButton, StatewireRu
 import { HITL_PENDING_RESUME_GRACE_MS } from "../agent-runtime/src/interrupts.js";
 export {
   ContinuePill,
+  EarlierStepsButton,
   HITL_PENDING_RESUME_GRACE_MS,
   HistoryEdgeRow,
   RUN_START_REFUSAL_FALLBACK_MESSAGE,
@@ -21,10 +24,12 @@ export {
   StatewireContinueRunAffordance,
   StatewireContinueRunButton,
   StatewireHistoryEdge,
+  StatewireHistoryPagesContext,
   StatewireQueuedMessages,
   StatewireRunEndedFooter,
   StatewireRunRefusalNotice,
   StatewireToolOutputsContext,
+  TurnStepsControlContext,
   WaitingOnYouBanner,
   WaitingOnYouBannerView,
   WakeMarkerCard,
@@ -33,6 +38,7 @@ export {
   useBrowserDecisionConfirmer,
   useStatewireApprovalRequest,
   useStatewireApprovalWait,
+  useStatewireHistoryPages,
   useStatewireToolOutputs
 };
 //# sourceMappingURL=statewire.js.map

package/dist/chat-ui/statewire.js.map

@@ -1 +1 @@
-{"version":3,"file":"statewire.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}
+{"version":3,"file":"statewire.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}

package/dist/chat-ui/thread/statewire-history-edge.cjs

@@ -161,11 +161,14 @@ const HistoryEdgeRow = ({
 };
 const StatewireHistoryEdge = ({
   toolOutputs: toolOutputsProp,
+  historyPages: historyPagesProp,
   className,
   onHistoryLoad
 }) => {
   const providerToolOutputs = statewireWindowContext.useStatewireToolOutputs();
   const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? void 0;
+  const providerHistoryPages = statewireWindowContext.useStatewireHistoryPages();
+  const historyPages = historyPagesProp === null ? void 0 : historyPagesProp ?? providerHistoryPages ?? void 0;
   const messages = react.useAuiState((s) => s.thread.messages);
   const threadId = require$$0.useContext(threadIdContext.AthenaStatewireThreadIdContext);
   const [nearTop, setNearTop] = require$$0.useState(false);
@@ -192,6 +195,7 @@ const StatewireHistoryEdge = ({
     isMessageMounted,
     maxConcurrentToolOutputs: HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY,
     onHistoryLoad,
+    historyPages,
     onError: (error, command) => {
       if (error instanceof Error && errors.isStatewireChannelTeardown(error)) return;
       console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);

package/dist/chat-ui/thread/statewire-history-edge.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-history-edge.cjs","sources":["../../../src/chat-ui/thread/statewire-history-edge.tsx"],"sourcesContent":["import {\n  getExternalStoreMessages,\n  type ThreadMessage,\n  type ThreadViewportState,\n  useAuiState,\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"@assistant-ui/react\";\nimport {\n  type DeepAgentHistoryLoadEvent,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  useDeepAgentWindowSync,\n} from \"@athenaintel/agent-runtime\";\nimport type { FC } from \"react\";\nimport { Component, useContext, useEffect, useMemo, useRef, useState } from \"react\";\nimport { cn } from \"../../lib/utils\";\nimport {\n  NO_STATEWIRE_HISTORY,\n  StatewireHistoryContext,\n} from \"../../provider/statewire-history-context\";\nimport { useStatewireToolOutputs } from \"../../provider/statewire-window-context\";\nimport { AthenaStatewireThreadIdContext } from \"../../threads/thread-id-context\";\n\n/** The attribute `ChatThreadShell` stamps on the scroll viewport. */\nexport const THREAD_VIEWPORT_ATTR = \"data-aui-thread-viewport\";\n/** The attribute `ChatThreadShell` stamps on its sticky viewport footer (the composer dock). */\nexport const THREAD_VIEWPORT_FOOTER_ATTR = \"data-aui-thread-viewport-footer\";\n\n/**\n * How far above the viewport the edge row counts as near: the row sits above\n * the first loaded message, so reaching it means the user has scrolled past\n * everything loaded and the next page should already be on its way. Messages\n * this close to the viewport also count as on screen for cut tool outputs.\n */\nexport const HISTORY_EDGE_NEAR_MARGIN_PX = 1500;\n\n/**\n * Cut tool outputs a transcript reads at once. The reads share the session's\n * command lane with everything the person sends, so a long transcript must\n * not queue dozens of them ahead of a message or a Stop.\n */\nexport const HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY = 2;\n\n/** What assistant-ui's `MessagePrimitive.Root` stamps on every message. */\nconst MESSAGE_SELECTOR = \"[data-message-id]\";\n\nconst NO_MESSAGE_IDS: ReadonlySet<string> = new Set();\n\nfunction sameIds({ a, b }: { a: ReadonlySet<string>; b: ReadonlySet<string> }): boolean {\n  if (a.size !== b.size) return false;\n  for (const id of a) if (!b.has(id)) return false;\n  return true;\n}\n\n/**\n * Which messages sit within {@link HISTORY_EDGE_NEAR_MARGIN_PX} of the\n * viewport, so cut tool outputs are read for what the person can reach. A\n * thread opens at its newest turn; reading every loaded step's output up\n * front sent dozens of reads, each re-rendering the transcript, for steps\n * nobody had scrolled to.\n *\n * `undefined` (every message counts) where nothing can be observed: no\n * viewport around the row, or no `IntersectionObserver`. A message rendered\n * without a `data-message-id` root (a host's own renderer) cannot be observed\n * either, so it counts as before.\n */\nfunction useMessagesNearViewport({\n  viewport,\n  hasViewport,\n  messages,\n}: {\n  viewport: HTMLElement | null;\n  /** A viewport is (or will be) registered around the row. */\n  hasViewport: boolean;\n  /** The converted thread: every change may have mounted or remounted a message. */\n  messages: readonly ThreadMessage[];\n}): ((messageId: string) => boolean) | undefined {\n  const [nearIds, setNearIds] = useState<ReadonlySet<string>>(NO_MESSAGE_IDS);\n  const observable = hasViewport && typeof IntersectionObserver !== \"undefined\";\n  const trackRef = useRef<(() => void) | null>(null);\n  // Every id a rendered element carries, as of the last scan.\n  const renderedIdsRef = useRef<ReadonlySet<string>>(NO_MESSAGE_IDS);\n\n  useEffect(() => {\n    if (!viewport || !observable) return undefined;\n    const near = new Set<Element>();\n    const observed = new Set<Element>();\n    const publish = () => {\n      const ids = new Set<string>();\n      for (const element of near) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) ids.add(id);\n      }\n      setNearIds((previous) => (sameIds({ a: previous, b: ids }) ? previous : ids));\n    };\n    const intersections = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting && entry.target.isConnected) near.add(entry.target);\n          else near.delete(entry.target);\n        }\n        publish();\n      },\n      { root: viewport, rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px` },\n    );\n    // A page that folds into a turn gives it a new id: a host keyed by id\n    // remounts the turn's element, a host keyed by row (`ChatThreadShell`)\n    // keeps it and the element's id changes. So what is observed follows the\n    // rendered elements, not the message list, and the near ids are read off\n    // those elements again on every scan.\n    const track = () => {\n      for (const element of observed) {\n        if (element.isConnected) continue;\n        intersections.unobserve(element);\n        observed.delete(element);\n        near.delete(element);\n      }\n      const rendered = new Set<string>();\n      for (const element of viewport.querySelectorAll(MESSAGE_SELECTOR)) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) rendered.add(id);\n        if (observed.has(element)) continue;\n        observed.add(element);\n        intersections.observe(element);\n      }\n      renderedIdsRef.current = rendered;\n      publish();\n    };\n    trackRef.current = track;\n    track();\n    return () => {\n      trackRef.current = null;\n      renderedIdsRef.current = NO_MESSAGE_IDS;\n      intersections.disconnect();\n      setNearIds(NO_MESSAGE_IDS);\n    };\n  }, [viewport, observable]);\n\n  // A changed message list is the trigger to re-scan: its messages render in\n  // the same commit, so their elements are in the DOM by this effect (a\n  // query, no layout read).\n  useEffect(() => {\n    trackRef.current?.();\n  }, [messages]);\n\n  return useMemo(() => {\n    if (!observable) return undefined;\n    return (messageId: string) => {\n      // Not registered yet: nothing is on screen to read for.\n      if (viewport === null) return false;\n      return nearIds.has(messageId) || !renderedIdsRef.current.has(messageId);\n    };\n  }, [nearIds, observable, viewport]);\n}\n\n/** The wire message a converted message was built from first (its oldest source). */\nfunction oldestSourceId(message: ThreadMessage): string | undefined {\n  const source = getExternalStoreMessages<{ id?: unknown }>(message)[0];\n  return typeof source?.id === \"string\" ? source.id : undefined;\n}\n\n/**\n * Whether older history landed ahead of what was loaded: the old first\n * message now sits further down (a page ahead of it), or the first message's\n * old oldest wire message now follows earlier ones (a page that folded into\n * the first loaded turn). A first message replaced in place — a branch picked\n * on it, an edit — is neither, and a run streaming at the tail never touches\n * the first message.\n */\nfunction prependedOlderHistory({\n  previous,\n  next,\n}: {\n  previous: readonly ThreadMessage[];\n  next: readonly ThreadMessage[];\n}): boolean {\n  const previousFirst = previous[0];\n  const nextFirst = next[0];\n  if (previousFirst === undefined || nextFirst === undefined || previousFirst === nextFirst) return false;\n  if (previousFirst.id !== nextFirst.id && next.some((message, index) => index > 0 && message.id === previousFirst.id)) {\n    return true;\n  }\n  const previousOldest = oldestSourceId(previousFirst);\n  if (previousOldest === undefined || previousOldest === oldestSourceId(nextFirst)) return false;\n  return getExternalStoreMessages<{ id?: unknown }>(nextFirst).some(\n    (source, index) => index > 0 && source?.id === previousOldest,\n  );\n}\n\ninterface KeepReadingPlaceProps {\n  viewport: HTMLElement | null;\n  threadId: string | null;\n  /** The converted thread. */\n  messages: readonly ThreadMessage[];\n}\n\n/**\n * Keeps the reader's place when older history lands. Everything a page adds\n * sits above what the person is reading, so their distance from the bottom of\n * the transcript is what must survive. A class for `getSnapshotBeforeUpdate`:\n * the distance is read right before React applies the commit that renders the\n * page — the one moment it is exact, even for a scroll the browser has not\n * reported yet — and restored after it, instantly (never through the\n * viewport's smooth scrolling). Other commits read no layout.\n *\n * The browser's scroll anchoring and assistant-ui's prepend anchor aim at the\n * same position, so whichever ran first leaves this nothing to do; on its own\n * it covers what they miss: a reader at the very top (browsers never anchor\n * at scroll offset 0) and a page that folds into the first loaded turn of a\n * host that keys rows by message id (that message remounts under a new id,\n * taking the browser's anchor node with it; `ChatThreadShell` keeps the row).\n */\nclass KeepReadingPlace extends Component<KeepReadingPlaceProps> {\n  getSnapshotBeforeUpdate(previous: Readonly<KeepReadingPlaceProps>): number | null {\n    const { viewport, threadId, messages } = this.props;\n    if (\n      viewport === null ||\n      viewport !== previous.viewport ||\n      threadId !== previous.threadId ||\n      messages === previous.messages ||\n      !prependedOlderHistory({ previous: previous.messages, next: messages })\n    ) {\n      return null;\n    }\n    return viewport.scrollHeight - viewport.scrollTop;\n  }\n\n  componentDidUpdate(\n    _previous: Readonly<KeepReadingPlaceProps>,\n    _state: unknown,\n    fromBottom: number | null,\n  ): void {\n    const { viewport } = this.props;\n    if (viewport === null || fromBottom === null) return;\n    const top = viewport.scrollHeight - fromBottom;\n    if (Math.abs(viewport.scrollTop - top) >= 1) viewport.scrollTo({ top, behavior: \"instant\" });\n  }\n\n  render(): null {\n    return null;\n  }\n}\n\nexport interface HistoryEdgeRowProps {\n  /** Whether the server holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /** Whether the next page can be asked for; `false` with `hasOlder` is the connection's loading depth spent. Defaults to `hasOlder`. */\n  canLoadOlder?: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  onLoadOlder: () => void;\n  className?: string;\n  /** The row element, for the viewport observer. */\n  rowRef?: (element: HTMLElement | null) => void;\n}\n\n/**\n * The top edge of the LOADED history: a manual way to load the next page of\n * older messages, and the in-flight state. Renders nothing when the whole\n * transcript is loaded (or the head interest has not resolved).\n */\nexport const HistoryEdgeRow: FC<HistoryEdgeRowProps> = ({\n  hasOlder,\n  canLoadOlder = hasOlder,\n  loading,\n  onLoadOlder,\n  className,\n  rowRef,\n}) => {\n  if (!hasOlder) return null;\n  return (\n    <div\n      ref={rowRef}\n      data-testid=\"thread-history-edge\"\n      className={cn(\n        \"mx-auto flex w-full max-w-(--thread-max-width) items-center justify-center py-1 text-xs text-muted-foreground\",\n        className,\n      )}\n    >\n      {loading ? (\n        <span data-testid=\"thread-history-edge-loading\">Loading earlier messages…</span>\n      ) : canLoadOlder ? (\n        <button\n          type=\"button\"\n          data-testid=\"thread-history-edge-load\"\n          onClick={onLoadOlder}\n          className=\"rounded-lg px-2.5 py-1 text-xs font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground\"\n        >\n          Load earlier messages\n        </button>\n      ) : (\n        <span data-testid=\"thread-history-edge-limit\">Earlier messages can't be loaded here</span>\n      )}\n    </div>\n  );\n};\n\nexport interface StatewireHistoryEdgeProps {\n  /**\n   * The thread's tool-output store (the one its converter substitutes from).\n   * Defaults to `AthenaProvider`'s; hosts mounting the runtime themselves pass\n   * the store they gave `useDeepAgentRuntime({ toolOutputs })`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  className?: string;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: (event: DeepAgentHistoryLoadEvent) => void;\n}\n\n/**\n * The client half of the interest window for a DOM thread — mounted once per\n * thread, inside the scroll viewport above the messages (`ChatThreadShell`'s\n * `beforeMessages` slot):\n *\n * - renders the \"Load earlier messages\" edge row and loads the next page when\n *   the row comes near the viewport (scrolling up) or on its button, keeping\n *   the reading position when the page lands above the view;\n * - fetches cut tool outputs whole for the cards near the viewport, a few at\n *   a time, so they re-render complete through the converter (`toolOutputs`).\n *\n * Inert until the head interest resolves: no row, no reads.\n */\nexport const StatewireHistoryEdge: FC<StatewireHistoryEdgeProps> = ({\n  toolOutputs: toolOutputsProp,\n  className,\n  onHistoryLoad,\n}) => {\n  const providerToolOutputs = useStatewireToolOutputs();\n  const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? undefined;\n  const messages = useAuiState((s) => s.thread.messages);\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const [nearTop, setNearTop] = useState(false);\n  const [nearTopEpoch, setNearTopEpoch] = useState(0);\n  const nearTopRef = useRef(false);\n  const [rowEl, setRowEl] = useState<HTMLElement | null>(null);\n  // The scroll viewport the thread registered (assistant-ui's viewport store),\n  // known even while the row renders nothing; the row's ancestor otherwise.\n  const hasViewportStore = useThreadViewportStore({ optional: true }) !== null;\n  const registeredViewport = useThreadViewport({\n    optional: true,\n    selector: (state: ThreadViewportState) => state.element.viewport,\n  });\n  const viewport =\n    registeredViewport ?? rowEl?.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`) ?? null;\n  const isMessageMounted = useMessagesNearViewport({\n    viewport,\n    hasViewport: hasViewportStore || viewport !== null,\n    messages,\n  });\n  const historyStore = useContext(StatewireHistoryContext);\n  const { hasOlder, canLoadOlder, loading, loadOlder } = useDeepAgentWindowSync({\n    messages,\n    toolOutputs,\n    nearTop,\n    nearTopEpoch,\n    isMessageMounted,\n    maxConcurrentToolOutputs: HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY,\n    onHistoryLoad,\n    onError: (error, command) => {\n      // Leaving the thread settles an in-flight read as lost: lifecycle, not a failure.\n      if (error instanceof Error && isStatewireChannelTeardown(error)) return;\n      console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);\n    },\n  });\n\n  // Other surfaces of the provider (the workbench's Shell pane) read where the\n  // history stands; leaving the thread or unmounting withdraws the report.\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    historyStore.set({ threadId, hasOlder, canLoadOlder, loading, loadOlder });\n    return undefined;\n  }, [historyStore, threadId, hasOlder, canLoadOlder, loading, loadOlder]);\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    return () => {\n      if (historyStore.get().threadId === threadId) historyStore.set(NO_STATEWIRE_HISTORY);\n    };\n  }, [historyStore, threadId]);\n\n  // The row's own visibility is the near-top level: a level, not an edge, so\n  // pages chain while the user stays at the top and stop once the prepended\n  // content has pushed the row away again.\n  useEffect(() => {\n    if (!rowEl || !hasOlder || typeof IntersectionObserver === \"undefined\") return;\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          const near = entry.isIntersecting;\n          if (nearTopRef.current === near) continue;\n          nearTopRef.current = near;\n          setNearTop(near);\n          if (near) setNearTopEpoch((epoch) => epoch + 1);\n        }\n      },\n      {\n        root: viewport,\n        rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px`,\n      },\n    );\n    observer.observe(rowEl);\n    return () => {\n      observer.disconnect();\n      nearTopRef.current = false;\n      setNearTop(false);\n    };\n  }, [rowEl, hasOlder, viewport]);\n\n  return (\n    <>\n      <KeepReadingPlace viewport={viewport} threadId={threadId} messages={messages} />\n      <HistoryEdgeRow\n        rowRef={setRowEl}\n        hasOlder={hasOlder}\n        canLoadOlder={canLoadOlder}\n        loading={loading}\n        onLoadOlder={loadOlder}\n        className={className}\n      />\n    </>\n  );\n};\n"],"names":["useState","useRef","useEffect","useMemo","getExternalStoreMessages","Component","jsx","cn","useStatewireToolOutputs","useAuiState","useContext","AthenaStatewireThreadIdContext","useThreadViewportStore","useThreadViewport","StatewireHistoryContext","useDeepAgentWindowSync","isStatewireChannelTeardown","NO_STATEWIRE_HISTORY","jsxs","Fragment"],"mappings":";;;;;;;;;;;AAyBO,MAAM,uBAAuB;AAE7B,MAAM,8BAA8B;AAQpC,MAAM,8BAA8B;AAOpC,MAAM,uCAAuC;AAGpD,MAAM,mBAAmB;AAEzB,MAAM,qCAA0C,IAAA;AAEhD,SAAS,QAAQ,EAAE,GAAG,KAAkE;AACtF,MAAI,EAAE,SAAS,EAAE,KAAM,QAAO;AAC9B,aAAW,MAAM,EAAG,KAAI,CAAC,EAAE,IAAI,EAAE,EAAG,QAAO;AAC3C,SAAO;AACT;AAcA,SAAS,wBAAwB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AACF,GAMiD;AAC/C,QAAM,CAAC,SAAS,UAAU,IAAIA,WAAAA,SAA8B,cAAc;AAC1E,QAAM,aAAa,eAAe,OAAO,yBAAyB;AAClE,QAAM,WAAWC,WAAAA,OAA4B,IAAI;AAEjD,QAAM,iBAAiBA,WAAAA,OAA4B,cAAc;AAEjEC,aAAAA,UAAU,MAAM;AACd,QAAI,CAAC,YAAY,CAAC,WAAY,QAAO;AACrC,UAAM,2BAAW,IAAA;AACjB,UAAM,+BAAe,IAAA;AACrB,UAAM,UAAU,MAAM;AACpB,YAAM,0BAAU,IAAA;AAChB,iBAAW,WAAW,MAAM;AAC1B,cAAM,KAAK,QAAQ,aAAa,iBAAiB;AACjD,YAAI,GAAI,KAAI,IAAI,EAAE;AAAA,MACpB;AACA,iBAAW,CAAC,aAAc,QAAQ,EAAE,GAAG,UAAU,GAAG,IAAA,CAAK,IAAI,WAAW,GAAI;AAAA,IAC9E;AACA,UAAM,gBAAgB,IAAI;AAAA,MACxB,CAAC,YAAY;AACX,mBAAW,SAAS,SAAS;AAC3B,cAAI,MAAM,kBAAkB,MAAM,OAAO,YAAa,MAAK,IAAI,MAAM,MAAM;AAAA,cACtE,MAAK,OAAO,MAAM,MAAM;AAAA,QAC/B;AACA,gBAAA;AAAA,MACF;AAAA,MACA,EAAE,MAAM,UAAU,YAAY,GAAG,2BAA2B,SAAA;AAAA,IAAS;AAOvE,UAAM,QAAQ,MAAM;AAClB,iBAAW,WAAW,UAAU;AAC9B,YAAI,QAAQ,YAAa;AACzB,sBAAc,UAAU,OAAO;AAC/B,iBAAS,OAAO,OAAO;AACvB,aAAK,OAAO,OAAO;AAAA,MACrB;AACA,YAAM,+BAAe,IAAA;AACrB,iBAAW,WAAW,SAAS,iBAAiB,gBAAgB,GAAG;AACjE,cAAM,KAAK,QAAQ,aAAa,iBAAiB;AACjD,YAAI,GAAI,UAAS,IAAI,EAAE;AACvB,YAAI,SAAS,IAAI,OAAO,EAAG;AAC3B,iBAAS,IAAI,OAAO;AACpB,sBAAc,QAAQ,OAAO;AAAA,MAC/B;AACA,qBAAe,UAAU;AACzB,cAAA;AAAA,IACF;AACA,aAAS,UAAU;AACnB,UAAA;AACA,WAAO,MAAM;AACX,eAAS,UAAU;AACnB,qBAAe,UAAU;AACzB,oBAAc,WAAA;AACd,iBAAW,cAAc;AAAA,IAC3B;AAAA,EACF,GAAG,CAAC,UAAU,UAAU,CAAC;AAKzBA,aAAAA,UAAU,MAAM;;AACd,mBAAS,YAAT;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAOC,WAAAA,QAAQ,MAAM;AACnB,QAAI,CAAC,WAAY,QAAO;AACxB,WAAO,CAAC,cAAsB;AAE5B,UAAI,aAAa,KAAM,QAAO;AAC9B,aAAO,QAAQ,IAAI,SAAS,KAAK,CAAC,eAAe,QAAQ,IAAI,SAAS;AAAA,IACxE;AAAA,EACF,GAAG,CAAC,SAAS,YAAY,QAAQ,CAAC;AACpC;AAGA,SAAS,eAAe,SAA4C;AAClE,QAAM,SAASC,MAAAA,yBAA2C,OAAO,EAAE,CAAC;AACpE,SAAO,QAAO,iCAAQ,QAAO,WAAW,OAAO,KAAK;AACtD;AAUA,SAAS,sBAAsB;AAAA,EAC7B;AAAA,EACA;AACF,GAGY;AACV,QAAM,gBAAgB,SAAS,CAAC;AAChC,QAAM,YAAY,KAAK,CAAC;AACxB,MAAI,kBAAkB,UAAa,cAAc,UAAa,kBAAkB,UAAW,QAAO;AAClG,MAAI,cAAc,OAAO,UAAU,MAAM,KAAK,KAAK,CAAC,SAAS,UAAU,QAAQ,KAAK,QAAQ,OAAO,cAAc,EAAE,GAAG;AACpH,WAAO;AAAA,EACT;AACA,QAAM,iBAAiB,eAAe,aAAa;AACnD,MAAI,mBAAmB,UAAa,mBAAmB,eAAe,SAAS,EAAG,QAAO;AACzF,SAAOA,MAAAA,yBAA2C,SAAS,EAAE;AAAA,IAC3D,CAAC,QAAQ,UAAU,QAAQ,MAAK,iCAAQ,QAAO;AAAA,EAAA;AAEnD;AAyBA,MAAM,yBAAyBC,WAAAA,UAAiC;AAAA,EAC9D,wBAAwB,UAA0D;AAChF,UAAM,EAAE,UAAU,UAAU,SAAA,IAAa,KAAK;AAC9C,QACE,aAAa,QACb,aAAa,SAAS,YACtB,aAAa,SAAS,YACtB,aAAa,SAAS,YACtB,CAAC,sBAAsB,EAAE,UAAU,SAAS,UAAU,MAAM,SAAA,CAAU,GACtE;AACA,aAAO;AAAA,IACT;AACA,WAAO,SAAS,eAAe,SAAS;AAAA,EAC1C;AAAA,EAEA,mBACE,WACA,QACA,YACM;AACN,UAAM,EAAE,aAAa,KAAK;AAC1B,QAAI,aAAa,QAAQ,eAAe,KAAM;AAC9C,UAAM,MAAM,SAAS,eAAe;AACpC,QAAI,KAAK,IAAI,SAAS,YAAY,GAAG,KAAK,EAAG,UAAS,SAAS,EAAE,KAAK,UAAU,WAAW;AAAA,EAC7F;AAAA,EAEA,SAAe;AACb,WAAO;AAAA,EACT;AACF;AAoBO,MAAM,iBAA0C,CAAC;AAAA,EACtD;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,MAAI,CAAC,SAAU,QAAO;AACtB,SACEC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,KAAK;AAAA,MACL,eAAY;AAAA,MACZ,WAAWC,OAAAA;AAAAA,QACT;AAAA,QACA;AAAA,MAAA;AAAA,MAGD,oBACCD,+BAAC,QAAA,EAAK,eAAY,+BAA8B,UAAA,6BAAyB,IACvE,eACFA,2BAAAA;AAAAA,QAAC;AAAA,QAAA;AAAA,UACC,MAAK;AAAA,UACL,eAAY;AAAA,UACZ,SAAS;AAAA,UACT,WAAU;AAAA,UACX,UAAA;AAAA,QAAA;AAAA,MAAA,IAIDA,2BAAAA,IAAC,QAAA,EAAK,eAAY,6BAA4B,UAAA,wCAAA,CAAqC;AAAA,IAAA;AAAA,EAAA;AAI3F;AA2BO,MAAM,uBAAsD,CAAC;AAAA,EAClE,aAAa;AAAA,EACb;AAAA,EACA;AACF,MAAM;AACJ,QAAM,sBAAsBE,uBAAAA,wBAAA;AAC5B,QAAM,cAAc,mBAAmB,uBAAuB;AAC9D,QAAM,WAAWC,MAAAA,YAAY,CAAC,MAAM,EAAE,OAAO,QAAQ;AACrD,QAAM,WAAWC,WAAAA,WAAWC,8CAA8B;AAC1D,QAAM,CAAC,SAAS,UAAU,IAAIX,WAAAA,SAAS,KAAK;AAC5C,QAAM,CAAC,cAAc,eAAe,IAAIA,WAAAA,SAAS,CAAC;AAClD,QAAM,aAAaC,WAAAA,OAAO,KAAK;AAC/B,QAAM,CAAC,OAAO,QAAQ,IAAID,WAAAA,SAA6B,IAAI;AAG3D,QAAM,mBAAmBY,MAAAA,uBAAuB,EAAE,UAAU,KAAA,CAAM,MAAM;AACxE,QAAM,qBAAqBC,MAAAA,kBAAkB;AAAA,IAC3C,UAAU;AAAA,IACV,UAAU,CAAC,UAA+B,MAAM,QAAQ;AAAA,EAAA,CACzD;AACD,QAAM,WACJ,uBAAsB,+BAAO,QAAqB,IAAI,oBAAoB,SAAQ;AACpF,QAAM,mBAAmB,wBAAwB;AAAA,IAC/C;AAAA,IACA,aAAa,oBAAoB,aAAa;AAAA,IAC9C;AAAA,EAAA,CACD;AACD,QAAM,eAAeH,WAAAA,WAAWI,+CAAuB;AACvD,QAAM,EAAE,UAAU,cAAc,SAAS,UAAA,IAAcC,uBAAAA,uBAAuB;AAAA,IAC5E;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,0BAA0B;AAAA,IAC1B;AAAA,IACA,SAAS,CAAC,OAAO,YAAY;AAE3B,UAAI,iBAAiB,SAASC,OAAAA,2BAA2B,KAAK,EAAG;AACjE,cAAQ,KAAK,0BAA0B,OAAO,YAAY,KAAK;AAAA,IACjE;AAAA,EAAA,CACD;AAIDd,aAAAA,UAAU,MAAM;AACd,QAAI,CAAC,gBAAgB,CAAC,SAAU,QAAO;AACvC,iBAAa,IAAI,EAAE,UAAU,UAAU,cAAc,SAAS,WAAW;AACzE,WAAO;AAAA,EACT,GAAG,CAAC,cAAc,UAAU,UAAU,cAAc,SAAS,SAAS,CAAC;AACvEA,aAAAA,UAAU,MAAM;AACd,QAAI,CAAC,gBAAgB,CAAC,SAAU,QAAO;AACvC,WAAO,MAAM;AACX,UAAI,aAAa,MAAM,aAAa,SAAU,cAAa,IAAIe,4CAAoB;AAAA,IACrF;AAAA,EACF,GAAG,CAAC,cAAc,QAAQ,CAAC;AAK3Bf,aAAAA,UAAU,MAAM;AACd,QAAI,CAAC,SAAS,CAAC,YAAY,OAAO,yBAAyB,YAAa;AACxE,UAAM,WAAW,IAAI;AAAA,MACnB,CAAC,YAAY;AACX,mBAAW,SAAS,SAAS;AAC3B,gBAAM,OAAO,MAAM;AACnB,cAAI,WAAW,YAAY,KAAM;AACjC,qBAAW,UAAU;AACrB,qBAAW,IAAI;AACf,cAAI,KAAM,iBAAgB,CAAC,UAAU,QAAQ,CAAC;AAAA,QAChD;AAAA,MACF;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,YAAY,GAAG,2BAA2B;AAAA,MAAA;AAAA,IAC5C;AAEF,aAAS,QAAQ,KAAK;AACtB,WAAO,MAAM;AACX,eAAS,WAAA;AACT,iBAAW,UAAU;AACrB,iBAAW,KAAK;AAAA,IAClB;AAAA,EACF,GAAG,CAAC,OAAO,UAAU,QAAQ,CAAC;AAE9B,SACEgB,2BAAAA,KAAAC,qBAAA,EACE,UAAA;AAAA,IAAAb,2BAAAA,IAAC,kBAAA,EAAiB,UAAoB,UAAoB,SAAA,CAAoB;AAAA,IAC9EA,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QACC,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,QACA,aAAa;AAAA,QACb;AAAA,MAAA;AAAA,IAAA;AAAA,EACF,GACF;AAEJ;;;;;;;"}
+{"version":3,"file":"statewire-history-edge.cjs","sources":["../../../src/chat-ui/thread/statewire-history-edge.tsx"],"sourcesContent":["import {\n  getExternalStoreMessages,\n  type ThreadMessage,\n  type ThreadViewportState,\n  useAuiState,\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"@assistant-ui/react\";\nimport {\n  type DeepAgentHistoryLoadEvent,\n  type DeepAgentHistoryStore,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  useDeepAgentWindowSync,\n} from \"@athenaintel/agent-runtime\";\nimport type { FC } from \"react\";\nimport { Component, useContext, useEffect, useMemo, useRef, useState } from \"react\";\nimport { cn } from \"../../lib/utils\";\nimport {\n  NO_STATEWIRE_HISTORY,\n  StatewireHistoryContext,\n} from \"../../provider/statewire-history-context\";\nimport {\n  useStatewireHistoryPages,\n  useStatewireToolOutputs,\n} from \"../../provider/statewire-window-context\";\nimport { AthenaStatewireThreadIdContext } from \"../../threads/thread-id-context\";\n\n/** The attribute `ChatThreadShell` stamps on the scroll viewport. */\nexport const THREAD_VIEWPORT_ATTR = \"data-aui-thread-viewport\";\n/** The attribute `ChatThreadShell` stamps on its sticky viewport footer (the composer dock). */\nexport const THREAD_VIEWPORT_FOOTER_ATTR = \"data-aui-thread-viewport-footer\";\n\n/**\n * How far above the viewport the edge row counts as near: the row sits above\n * the first loaded message, so reaching it means the user has scrolled past\n * everything loaded and the next page should already be on its way. Messages\n * this close to the viewport also count as on screen for cut tool outputs.\n */\nexport const HISTORY_EDGE_NEAR_MARGIN_PX = 1500;\n\n/**\n * Cut tool outputs a transcript reads at once. The reads share the session's\n * command lane with everything the person sends, so a long transcript must\n * not queue dozens of them ahead of a message or a Stop.\n */\nexport const HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY = 2;\n\n/** What assistant-ui's `MessagePrimitive.Root` stamps on every message. */\nconst MESSAGE_SELECTOR = \"[data-message-id]\";\n\nconst NO_MESSAGE_IDS: ReadonlySet<string> = new Set();\n\nfunction sameIds({ a, b }: { a: ReadonlySet<string>; b: ReadonlySet<string> }): boolean {\n  if (a.size !== b.size) return false;\n  for (const id of a) if (!b.has(id)) return false;\n  return true;\n}\n\n/**\n * Which messages sit within {@link HISTORY_EDGE_NEAR_MARGIN_PX} of the\n * viewport, so cut tool outputs are read for what the person can reach. A\n * thread opens at its newest turn; reading every loaded step's output up\n * front sent dozens of reads, each re-rendering the transcript, for steps\n * nobody had scrolled to.\n *\n * `undefined` (every message counts) where nothing can be observed: no\n * viewport around the row, or no `IntersectionObserver`. A message rendered\n * without a `data-message-id` root (a host's own renderer) cannot be observed\n * either, so it counts as before.\n */\nfunction useMessagesNearViewport({\n  viewport,\n  hasViewport,\n  messages,\n}: {\n  viewport: HTMLElement | null;\n  /** A viewport is (or will be) registered around the row. */\n  hasViewport: boolean;\n  /** The converted thread: every change may have mounted or remounted a message. */\n  messages: readonly ThreadMessage[];\n}): ((messageId: string) => boolean) | undefined {\n  const [nearIds, setNearIds] = useState<ReadonlySet<string>>(NO_MESSAGE_IDS);\n  const observable = hasViewport && typeof IntersectionObserver !== \"undefined\";\n  const trackRef = useRef<(() => void) | null>(null);\n  // Every id a rendered element carries, as of the last scan.\n  const renderedIdsRef = useRef<ReadonlySet<string>>(NO_MESSAGE_IDS);\n\n  useEffect(() => {\n    if (!viewport || !observable) return undefined;\n    const near = new Set<Element>();\n    const observed = new Set<Element>();\n    const publish = () => {\n      const ids = new Set<string>();\n      for (const element of near) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) ids.add(id);\n      }\n      setNearIds((previous) => (sameIds({ a: previous, b: ids }) ? previous : ids));\n    };\n    const intersections = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting && entry.target.isConnected) near.add(entry.target);\n          else near.delete(entry.target);\n        }\n        publish();\n      },\n      { root: viewport, rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px` },\n    );\n    // A page that folds into a turn gives it a new id: a host keyed by id\n    // remounts the turn's element, a host keyed by row (`ChatThreadShell`)\n    // keeps it and the element's id changes. So what is observed follows the\n    // rendered elements, not the message list, and the near ids are read off\n    // those elements again on every scan.\n    const track = () => {\n      for (const element of observed) {\n        if (element.isConnected) continue;\n        intersections.unobserve(element);\n        observed.delete(element);\n        near.delete(element);\n      }\n      const rendered = new Set<string>();\n      for (const element of viewport.querySelectorAll(MESSAGE_SELECTOR)) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) rendered.add(id);\n        if (observed.has(element)) continue;\n        observed.add(element);\n        intersections.observe(element);\n      }\n      renderedIdsRef.current = rendered;\n      publish();\n    };\n    trackRef.current = track;\n    track();\n    return () => {\n      trackRef.current = null;\n      renderedIdsRef.current = NO_MESSAGE_IDS;\n      intersections.disconnect();\n      setNearIds(NO_MESSAGE_IDS);\n    };\n  }, [viewport, observable]);\n\n  // A changed message list is the trigger to re-scan: its messages render in\n  // the same commit, so their elements are in the DOM by this effect (a\n  // query, no layout read).\n  useEffect(() => {\n    trackRef.current?.();\n  }, [messages]);\n\n  return useMemo(() => {\n    if (!observable) return undefined;\n    return (messageId: string) => {\n      // Not registered yet: nothing is on screen to read for.\n      if (viewport === null) return false;\n      return nearIds.has(messageId) || !renderedIdsRef.current.has(messageId);\n    };\n  }, [nearIds, observable, viewport]);\n}\n\n/** The wire message a converted message was built from first (its oldest source). */\nfunction oldestSourceId(message: ThreadMessage): string | undefined {\n  const source = getExternalStoreMessages<{ id?: unknown }>(message)[0];\n  return typeof source?.id === \"string\" ? source.id : undefined;\n}\n\n/**\n * Whether older history landed ahead of what was loaded: the old first\n * message now sits further down (a page ahead of it), or the first message's\n * old oldest wire message now follows earlier ones (a page that folded into\n * the first loaded turn). A first message replaced in place — a branch picked\n * on it, an edit — is neither, and a run streaming at the tail never touches\n * the first message.\n */\nfunction prependedOlderHistory({\n  previous,\n  next,\n}: {\n  previous: readonly ThreadMessage[];\n  next: readonly ThreadMessage[];\n}): boolean {\n  const previousFirst = previous[0];\n  const nextFirst = next[0];\n  if (previousFirst === undefined || nextFirst === undefined || previousFirst === nextFirst) return false;\n  if (previousFirst.id !== nextFirst.id && next.some((message, index) => index > 0 && message.id === previousFirst.id)) {\n    return true;\n  }\n  const previousOldest = oldestSourceId(previousFirst);\n  if (previousOldest === undefined || previousOldest === oldestSourceId(nextFirst)) return false;\n  return getExternalStoreMessages<{ id?: unknown }>(nextFirst).some(\n    (source, index) => index > 0 && source?.id === previousOldest,\n  );\n}\n\ninterface KeepReadingPlaceProps {\n  viewport: HTMLElement | null;\n  threadId: string | null;\n  /** The converted thread. */\n  messages: readonly ThreadMessage[];\n}\n\n/**\n * Keeps the reader's place when older history lands. Everything a page adds\n * sits above what the person is reading, so their distance from the bottom of\n * the transcript is what must survive. A class for `getSnapshotBeforeUpdate`:\n * the distance is read right before React applies the commit that renders the\n * page — the one moment it is exact, even for a scroll the browser has not\n * reported yet — and restored after it, instantly (never through the\n * viewport's smooth scrolling). Other commits read no layout.\n *\n * The browser's scroll anchoring and assistant-ui's prepend anchor aim at the\n * same position, so whichever ran first leaves this nothing to do; on its own\n * it covers what they miss: a reader at the very top (browsers never anchor\n * at scroll offset 0) and a page that folds into the first loaded turn of a\n * host that keys rows by message id (that message remounts under a new id,\n * taking the browser's anchor node with it; `ChatThreadShell` keeps the row).\n */\nclass KeepReadingPlace extends Component<KeepReadingPlaceProps> {\n  getSnapshotBeforeUpdate(previous: Readonly<KeepReadingPlaceProps>): number | null {\n    const { viewport, threadId, messages } = this.props;\n    if (\n      viewport === null ||\n      viewport !== previous.viewport ||\n      threadId !== previous.threadId ||\n      messages === previous.messages ||\n      !prependedOlderHistory({ previous: previous.messages, next: messages })\n    ) {\n      return null;\n    }\n    return viewport.scrollHeight - viewport.scrollTop;\n  }\n\n  componentDidUpdate(\n    _previous: Readonly<KeepReadingPlaceProps>,\n    _state: unknown,\n    fromBottom: number | null,\n  ): void {\n    const { viewport } = this.props;\n    if (viewport === null || fromBottom === null) return;\n    const top = viewport.scrollHeight - fromBottom;\n    if (Math.abs(viewport.scrollTop - top) >= 1) viewport.scrollTo({ top, behavior: \"instant\" });\n  }\n\n  render(): null {\n    return null;\n  }\n}\n\nexport interface HistoryEdgeRowProps {\n  /** Whether the server holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /** Whether the next page can be asked for; `false` with `hasOlder` is the connection's loading depth spent. Defaults to `hasOlder`. */\n  canLoadOlder?: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  onLoadOlder: () => void;\n  className?: string;\n  /** The row element, for the viewport observer. */\n  rowRef?: (element: HTMLElement | null) => void;\n}\n\n/**\n * The top edge of the LOADED history: a manual way to load the next page of\n * older messages, and the in-flight state. Renders nothing when the whole\n * transcript is loaded (or the head interest has not resolved).\n */\nexport const HistoryEdgeRow: FC<HistoryEdgeRowProps> = ({\n  hasOlder,\n  canLoadOlder = hasOlder,\n  loading,\n  onLoadOlder,\n  className,\n  rowRef,\n}) => {\n  if (!hasOlder) return null;\n  return (\n    <div\n      ref={rowRef}\n      data-testid=\"thread-history-edge\"\n      className={cn(\n        \"mx-auto flex w-full max-w-(--thread-max-width) items-center justify-center py-1 text-xs text-muted-foreground\",\n        className,\n      )}\n    >\n      {loading ? (\n        <span data-testid=\"thread-history-edge-loading\">Loading earlier messages…</span>\n      ) : canLoadOlder ? (\n        <button\n          type=\"button\"\n          data-testid=\"thread-history-edge-load\"\n          onClick={onLoadOlder}\n          className=\"rounded-lg px-2.5 py-1 text-xs font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground\"\n        >\n          Load earlier messages\n        </button>\n      ) : (\n        <span data-testid=\"thread-history-edge-limit\">Earlier messages can't be loaded here</span>\n      )}\n    </div>\n  );\n};\n\nexport interface StatewireHistoryEdgeProps {\n  /**\n   * The thread's tool-output store (the one its converter substitutes from).\n   * Defaults to `AthenaProvider`'s; hosts mounting the runtime themselves pass\n   * the store they gave `useDeepAgentRuntime({ toolOutputs })`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /**\n   * Where older turns are paged by command (`history/page`) from a host that\n   * answers it: the store the thread joins (`useDeepAgentThread({\n   * historyStore })`). Defaults to `AthenaProvider`'s; `null` keeps interest\n   * pages even under the provider. A host that mounts the runtime itself\n   * also provides the store through `StatewireHistoryPagesContext` and the\n   * control through `TurnStepsControlContext` (`EarlierStepsButton`), so a\n   * summarized turn's rows can open its steps.\n   */\n  historyPages?: DeepAgentHistoryStore | null;\n  className?: string;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: (event: DeepAgentHistoryLoadEvent) => void;\n}\n\n/**\n * The client half of the interest window for a DOM thread — mounted once per\n * thread, inside the scroll viewport above the messages (`ChatThreadShell`'s\n * `beforeMessages` slot):\n *\n * - renders the \"Load earlier messages\" edge row and loads the next page when\n *   the row comes near the viewport (scrolling up) or on its button, keeping\n *   the reading position when the page lands above the view;\n * - fetches cut tool outputs whole for the cards near the viewport, a few at\n *   a time, so they re-render complete through the converter (`toolOutputs`).\n *\n * Inert until the head interest resolves: no row, no reads.\n */\nexport const StatewireHistoryEdge: FC<StatewireHistoryEdgeProps> = ({\n  toolOutputs: toolOutputsProp,\n  historyPages: historyPagesProp,\n  className,\n  onHistoryLoad,\n}) => {\n  const providerToolOutputs = useStatewireToolOutputs();\n  const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? undefined;\n  const providerHistoryPages = useStatewireHistoryPages();\n  const historyPages =\n    historyPagesProp === null ? undefined : (historyPagesProp ?? providerHistoryPages ?? undefined);\n  const messages = useAuiState((s) => s.thread.messages);\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const [nearTop, setNearTop] = useState(false);\n  const [nearTopEpoch, setNearTopEpoch] = useState(0);\n  const nearTopRef = useRef(false);\n  const [rowEl, setRowEl] = useState<HTMLElement | null>(null);\n  // The scroll viewport the thread registered (assistant-ui's viewport store),\n  // known even while the row renders nothing; the row's ancestor otherwise.\n  const hasViewportStore = useThreadViewportStore({ optional: true }) !== null;\n  const registeredViewport = useThreadViewport({\n    optional: true,\n    selector: (state: ThreadViewportState) => state.element.viewport,\n  });\n  const viewport =\n    registeredViewport ?? rowEl?.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`) ?? null;\n  const isMessageMounted = useMessagesNearViewport({\n    viewport,\n    hasViewport: hasViewportStore || viewport !== null,\n    messages,\n  });\n  const historyStore = useContext(StatewireHistoryContext);\n  const { hasOlder, canLoadOlder, loading, loadOlder } = useDeepAgentWindowSync({\n    messages,\n    toolOutputs,\n    nearTop,\n    nearTopEpoch,\n    isMessageMounted,\n    maxConcurrentToolOutputs: HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY,\n    onHistoryLoad,\n    historyPages,\n    onError: (error, command) => {\n      // Leaving the thread settles an in-flight read as lost: lifecycle, not a failure.\n      if (error instanceof Error && isStatewireChannelTeardown(error)) return;\n      console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);\n    },\n  });\n\n  // Other surfaces of the provider (the workbench's Shell pane) read where the\n  // history stands; leaving the thread or unmounting withdraws the report.\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    historyStore.set({ threadId, hasOlder, canLoadOlder, loading, loadOlder });\n    return undefined;\n  }, [historyStore, threadId, hasOlder, canLoadOlder, loading, loadOlder]);\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    return () => {\n      if (historyStore.get().threadId === threadId) historyStore.set(NO_STATEWIRE_HISTORY);\n    };\n  }, [historyStore, threadId]);\n\n  // The row's own visibility is the near-top level: a level, not an edge, so\n  // pages chain while the user stays at the top and stop once the prepended\n  // content has pushed the row away again.\n  useEffect(() => {\n    if (!rowEl || !hasOlder || typeof IntersectionObserver === \"undefined\") return;\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          const near = entry.isIntersecting;\n          if (nearTopRef.current === near) continue;\n          nearTopRef.current = near;\n          setNearTop(near);\n          if (near) setNearTopEpoch((epoch) => epoch + 1);\n        }\n      },\n      {\n        root: viewport,\n        rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px`,\n      },\n    );\n    observer.observe(rowEl);\n    return () => {\n      observer.disconnect();\n      nearTopRef.current = false;\n      setNearTop(false);\n    };\n  }, [rowEl, hasOlder, viewport]);\n\n  return (\n    <>\n      <KeepReadingPlace viewport={viewport} threadId={threadId} messages={messages} />\n      <HistoryEdgeRow\n        rowRef={setRowEl}\n        hasOlder={hasOlder}\n        canLoadOlder={canLoadOlder}\n        loading={loading}\n        onLoadOlder={loadOlder}\n        className={className}\n      />\n    </>\n  );\n};\n"],"names":["useState","useRef","useEffect","useMemo","getExternalStoreMessages","Component","jsx","cn","useStatewireToolOutputs","useStatewireHistoryPages","useAuiState","useContext","AthenaStatewireThreadIdContext","useThreadViewportStore","useThreadViewport","StatewireHistoryContext","useDeepAgentWindowSync","isStatewireChannelTeardown","NO_STATEWIRE_HISTORY","jsxs","Fragment"],"mappings":"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"}

package/dist/chat-ui/thread/statewire-history-edge.d.ts

@@ -1,4 +1,4 @@
-import { type DeepAgentHistoryLoadEvent, type DeepAgentToolOutputStore } from "../../agent-runtime/src/index";
+import { type DeepAgentHistoryLoadEvent, type DeepAgentHistoryStore, type DeepAgentToolOutputStore } from "../../agent-runtime/src/index";
 import type { FC } from "react";
 /** The attribute `ChatThreadShell` stamps on the scroll viewport. */
 export declare const THREAD_VIEWPORT_ATTR = "data-aui-thread-viewport";
@@ -42,6 +42,16 @@ export interface StatewireHistoryEdgeProps {
      * the store they gave `useDeepAgentRuntime({ toolOutputs })`.
      */
     toolOutputs?: DeepAgentToolOutputStore;
+    /**
+     * Where older turns are paged by command (`history/page`) from a host that
+     * answers it: the store the thread joins (`useDeepAgentThread({
+     * historyStore })`). Defaults to `AthenaProvider`'s; `null` keeps interest
+     * pages even under the provider. A host that mounts the runtime itself
+     * also provides the store through `StatewireHistoryPagesContext` and the
+     * control through `TurnStepsControlContext` (`EarlierStepsButton`), so a
+     * summarized turn's rows can open its steps.
+     */
+    historyPages?: DeepAgentHistoryStore | null;
     className?: string;
     /** A page interest resolved (telemetry). */
     onHistoryLoad?: (event: DeepAgentHistoryLoadEvent) => void;

package/dist/chat-ui/thread/statewire-history-edge.js

@@ -2,7 +2,7 @@ import { jsxs, Fragment, jsx } from "react/jsx-runtime";
 import { useAuiState, useThreadViewportStore, useThreadViewport, getExternalStoreMessages } from "@assistant-ui/react";
 import { useContext, useState, useRef, useEffect, useMemo, Component } from "react";
 import { StatewireHistoryContext, NO_STATEWIRE_HISTORY } from "../../provider/statewire-history-context.js";
-import { useStatewireToolOutputs } from "../../provider/statewire-window-context.js";
+import { useStatewireToolOutputs, useStatewireHistoryPages } from "../../provider/statewire-window-context.js";
 import { AthenaStatewireThreadIdContext } from "../../threads/thread-id-context.js";
 import { useDeepAgentWindowSync } from "../../agent-runtime/src/use-deep-agent-window-sync.js";
 import { isStatewireChannelTeardown } from "../../agent-runtime/src/errors.js";
@@ -159,11 +159,14 @@ const HistoryEdgeRow = ({
 };
 const StatewireHistoryEdge = ({
   toolOutputs: toolOutputsProp,
+  historyPages: historyPagesProp,
   className,
   onHistoryLoad
 }) => {
   const providerToolOutputs = useStatewireToolOutputs();
   const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? void 0;
+  const providerHistoryPages = useStatewireHistoryPages();
+  const historyPages = historyPagesProp === null ? void 0 : historyPagesProp ?? providerHistoryPages ?? void 0;
   const messages = useAuiState((s) => s.thread.messages);
   const threadId = useContext(AthenaStatewireThreadIdContext);
   const [nearTop, setNearTop] = useState(false);
@@ -190,6 +193,7 @@ const StatewireHistoryEdge = ({
     isMessageMounted,
     maxConcurrentToolOutputs: HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY,
     onHistoryLoad,
+    historyPages,
     onError: (error, command) => {
       if (error instanceof Error && isStatewireChannelTeardown(error)) return;
       console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);

package/dist/chat-ui/thread/statewire-history-edge.js.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-history-edge.js","sources":["../../../src/chat-ui/thread/statewire-history-edge.tsx"],"sourcesContent":["import {\n  getExternalStoreMessages,\n  type ThreadMessage,\n  type ThreadViewportState,\n  useAuiState,\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"@assistant-ui/react\";\nimport {\n  type DeepAgentHistoryLoadEvent,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  useDeepAgentWindowSync,\n} from \"@athenaintel/agent-runtime\";\nimport type { FC } from \"react\";\nimport { Component, useContext, useEffect, useMemo, useRef, useState } from \"react\";\nimport { cn } from \"../../lib/utils\";\nimport {\n  NO_STATEWIRE_HISTORY,\n  StatewireHistoryContext,\n} from \"../../provider/statewire-history-context\";\nimport { useStatewireToolOutputs } from \"../../provider/statewire-window-context\";\nimport { AthenaStatewireThreadIdContext } from \"../../threads/thread-id-context\";\n\n/** The attribute `ChatThreadShell` stamps on the scroll viewport. */\nexport const THREAD_VIEWPORT_ATTR = \"data-aui-thread-viewport\";\n/** The attribute `ChatThreadShell` stamps on its sticky viewport footer (the composer dock). */\nexport const THREAD_VIEWPORT_FOOTER_ATTR = \"data-aui-thread-viewport-footer\";\n\n/**\n * How far above the viewport the edge row counts as near: the row sits above\n * the first loaded message, so reaching it means the user has scrolled past\n * everything loaded and the next page should already be on its way. Messages\n * this close to the viewport also count as on screen for cut tool outputs.\n */\nexport const HISTORY_EDGE_NEAR_MARGIN_PX = 1500;\n\n/**\n * Cut tool outputs a transcript reads at once. The reads share the session's\n * command lane with everything the person sends, so a long transcript must\n * not queue dozens of them ahead of a message or a Stop.\n */\nexport const HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY = 2;\n\n/** What assistant-ui's `MessagePrimitive.Root` stamps on every message. */\nconst MESSAGE_SELECTOR = \"[data-message-id]\";\n\nconst NO_MESSAGE_IDS: ReadonlySet<string> = new Set();\n\nfunction sameIds({ a, b }: { a: ReadonlySet<string>; b: ReadonlySet<string> }): boolean {\n  if (a.size !== b.size) return false;\n  for (const id of a) if (!b.has(id)) return false;\n  return true;\n}\n\n/**\n * Which messages sit within {@link HISTORY_EDGE_NEAR_MARGIN_PX} of the\n * viewport, so cut tool outputs are read for what the person can reach. A\n * thread opens at its newest turn; reading every loaded step's output up\n * front sent dozens of reads, each re-rendering the transcript, for steps\n * nobody had scrolled to.\n *\n * `undefined` (every message counts) where nothing can be observed: no\n * viewport around the row, or no `IntersectionObserver`. A message rendered\n * without a `data-message-id` root (a host's own renderer) cannot be observed\n * either, so it counts as before.\n */\nfunction useMessagesNearViewport({\n  viewport,\n  hasViewport,\n  messages,\n}: {\n  viewport: HTMLElement | null;\n  /** A viewport is (or will be) registered around the row. */\n  hasViewport: boolean;\n  /** The converted thread: every change may have mounted or remounted a message. */\n  messages: readonly ThreadMessage[];\n}): ((messageId: string) => boolean) | undefined {\n  const [nearIds, setNearIds] = useState<ReadonlySet<string>>(NO_MESSAGE_IDS);\n  const observable = hasViewport && typeof IntersectionObserver !== \"undefined\";\n  const trackRef = useRef<(() => void) | null>(null);\n  // Every id a rendered element carries, as of the last scan.\n  const renderedIdsRef = useRef<ReadonlySet<string>>(NO_MESSAGE_IDS);\n\n  useEffect(() => {\n    if (!viewport || !observable) return undefined;\n    const near = new Set<Element>();\n    const observed = new Set<Element>();\n    const publish = () => {\n      const ids = new Set<string>();\n      for (const element of near) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) ids.add(id);\n      }\n      setNearIds((previous) => (sameIds({ a: previous, b: ids }) ? previous : ids));\n    };\n    const intersections = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting && entry.target.isConnected) near.add(entry.target);\n          else near.delete(entry.target);\n        }\n        publish();\n      },\n      { root: viewport, rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px` },\n    );\n    // A page that folds into a turn gives it a new id: a host keyed by id\n    // remounts the turn's element, a host keyed by row (`ChatThreadShell`)\n    // keeps it and the element's id changes. So what is observed follows the\n    // rendered elements, not the message list, and the near ids are read off\n    // those elements again on every scan.\n    const track = () => {\n      for (const element of observed) {\n        if (element.isConnected) continue;\n        intersections.unobserve(element);\n        observed.delete(element);\n        near.delete(element);\n      }\n      const rendered = new Set<string>();\n      for (const element of viewport.querySelectorAll(MESSAGE_SELECTOR)) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) rendered.add(id);\n        if (observed.has(element)) continue;\n        observed.add(element);\n        intersections.observe(element);\n      }\n      renderedIdsRef.current = rendered;\n      publish();\n    };\n    trackRef.current = track;\n    track();\n    return () => {\n      trackRef.current = null;\n      renderedIdsRef.current = NO_MESSAGE_IDS;\n      intersections.disconnect();\n      setNearIds(NO_MESSAGE_IDS);\n    };\n  }, [viewport, observable]);\n\n  // A changed message list is the trigger to re-scan: its messages render in\n  // the same commit, so their elements are in the DOM by this effect (a\n  // query, no layout read).\n  useEffect(() => {\n    trackRef.current?.();\n  }, [messages]);\n\n  return useMemo(() => {\n    if (!observable) return undefined;\n    return (messageId: string) => {\n      // Not registered yet: nothing is on screen to read for.\n      if (viewport === null) return false;\n      return nearIds.has(messageId) || !renderedIdsRef.current.has(messageId);\n    };\n  }, [nearIds, observable, viewport]);\n}\n\n/** The wire message a converted message was built from first (its oldest source). */\nfunction oldestSourceId(message: ThreadMessage): string | undefined {\n  const source = getExternalStoreMessages<{ id?: unknown }>(message)[0];\n  return typeof source?.id === \"string\" ? source.id : undefined;\n}\n\n/**\n * Whether older history landed ahead of what was loaded: the old first\n * message now sits further down (a page ahead of it), or the first message's\n * old oldest wire message now follows earlier ones (a page that folded into\n * the first loaded turn). A first message replaced in place — a branch picked\n * on it, an edit — is neither, and a run streaming at the tail never touches\n * the first message.\n */\nfunction prependedOlderHistory({\n  previous,\n  next,\n}: {\n  previous: readonly ThreadMessage[];\n  next: readonly ThreadMessage[];\n}): boolean {\n  const previousFirst = previous[0];\n  const nextFirst = next[0];\n  if (previousFirst === undefined || nextFirst === undefined || previousFirst === nextFirst) return false;\n  if (previousFirst.id !== nextFirst.id && next.some((message, index) => index > 0 && message.id === previousFirst.id)) {\n    return true;\n  }\n  const previousOldest = oldestSourceId(previousFirst);\n  if (previousOldest === undefined || previousOldest === oldestSourceId(nextFirst)) return false;\n  return getExternalStoreMessages<{ id?: unknown }>(nextFirst).some(\n    (source, index) => index > 0 && source?.id === previousOldest,\n  );\n}\n\ninterface KeepReadingPlaceProps {\n  viewport: HTMLElement | null;\n  threadId: string | null;\n  /** The converted thread. */\n  messages: readonly ThreadMessage[];\n}\n\n/**\n * Keeps the reader's place when older history lands. Everything a page adds\n * sits above what the person is reading, so their distance from the bottom of\n * the transcript is what must survive. A class for `getSnapshotBeforeUpdate`:\n * the distance is read right before React applies the commit that renders the\n * page — the one moment it is exact, even for a scroll the browser has not\n * reported yet — and restored after it, instantly (never through the\n * viewport's smooth scrolling). Other commits read no layout.\n *\n * The browser's scroll anchoring and assistant-ui's prepend anchor aim at the\n * same position, so whichever ran first leaves this nothing to do; on its own\n * it covers what they miss: a reader at the very top (browsers never anchor\n * at scroll offset 0) and a page that folds into the first loaded turn of a\n * host that keys rows by message id (that message remounts under a new id,\n * taking the browser's anchor node with it; `ChatThreadShell` keeps the row).\n */\nclass KeepReadingPlace extends Component<KeepReadingPlaceProps> {\n  getSnapshotBeforeUpdate(previous: Readonly<KeepReadingPlaceProps>): number | null {\n    const { viewport, threadId, messages } = this.props;\n    if (\n      viewport === null ||\n      viewport !== previous.viewport ||\n      threadId !== previous.threadId ||\n      messages === previous.messages ||\n      !prependedOlderHistory({ previous: previous.messages, next: messages })\n    ) {\n      return null;\n    }\n    return viewport.scrollHeight - viewport.scrollTop;\n  }\n\n  componentDidUpdate(\n    _previous: Readonly<KeepReadingPlaceProps>,\n    _state: unknown,\n    fromBottom: number | null,\n  ): void {\n    const { viewport } = this.props;\n    if (viewport === null || fromBottom === null) return;\n    const top = viewport.scrollHeight - fromBottom;\n    if (Math.abs(viewport.scrollTop - top) >= 1) viewport.scrollTo({ top, behavior: \"instant\" });\n  }\n\n  render(): null {\n    return null;\n  }\n}\n\nexport interface HistoryEdgeRowProps {\n  /** Whether the server holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /** Whether the next page can be asked for; `false` with `hasOlder` is the connection's loading depth spent. Defaults to `hasOlder`. */\n  canLoadOlder?: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  onLoadOlder: () => void;\n  className?: string;\n  /** The row element, for the viewport observer. */\n  rowRef?: (element: HTMLElement | null) => void;\n}\n\n/**\n * The top edge of the LOADED history: a manual way to load the next page of\n * older messages, and the in-flight state. Renders nothing when the whole\n * transcript is loaded (or the head interest has not resolved).\n */\nexport const HistoryEdgeRow: FC<HistoryEdgeRowProps> = ({\n  hasOlder,\n  canLoadOlder = hasOlder,\n  loading,\n  onLoadOlder,\n  className,\n  rowRef,\n}) => {\n  if (!hasOlder) return null;\n  return (\n    <div\n      ref={rowRef}\n      data-testid=\"thread-history-edge\"\n      className={cn(\n        \"mx-auto flex w-full max-w-(--thread-max-width) items-center justify-center py-1 text-xs text-muted-foreground\",\n        className,\n      )}\n    >\n      {loading ? (\n        <span data-testid=\"thread-history-edge-loading\">Loading earlier messages…</span>\n      ) : canLoadOlder ? (\n        <button\n          type=\"button\"\n          data-testid=\"thread-history-edge-load\"\n          onClick={onLoadOlder}\n          className=\"rounded-lg px-2.5 py-1 text-xs font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground\"\n        >\n          Load earlier messages\n        </button>\n      ) : (\n        <span data-testid=\"thread-history-edge-limit\">Earlier messages can't be loaded here</span>\n      )}\n    </div>\n  );\n};\n\nexport interface StatewireHistoryEdgeProps {\n  /**\n   * The thread's tool-output store (the one its converter substitutes from).\n   * Defaults to `AthenaProvider`'s; hosts mounting the runtime themselves pass\n   * the store they gave `useDeepAgentRuntime({ toolOutputs })`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  className?: string;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: (event: DeepAgentHistoryLoadEvent) => void;\n}\n\n/**\n * The client half of the interest window for a DOM thread — mounted once per\n * thread, inside the scroll viewport above the messages (`ChatThreadShell`'s\n * `beforeMessages` slot):\n *\n * - renders the \"Load earlier messages\" edge row and loads the next page when\n *   the row comes near the viewport (scrolling up) or on its button, keeping\n *   the reading position when the page lands above the view;\n * - fetches cut tool outputs whole for the cards near the viewport, a few at\n *   a time, so they re-render complete through the converter (`toolOutputs`).\n *\n * Inert until the head interest resolves: no row, no reads.\n */\nexport const StatewireHistoryEdge: FC<StatewireHistoryEdgeProps> = ({\n  toolOutputs: toolOutputsProp,\n  className,\n  onHistoryLoad,\n}) => {\n  const providerToolOutputs = useStatewireToolOutputs();\n  const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? undefined;\n  const messages = useAuiState((s) => s.thread.messages);\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const [nearTop, setNearTop] = useState(false);\n  const [nearTopEpoch, setNearTopEpoch] = useState(0);\n  const nearTopRef = useRef(false);\n  const [rowEl, setRowEl] = useState<HTMLElement | null>(null);\n  // The scroll viewport the thread registered (assistant-ui's viewport store),\n  // known even while the row renders nothing; the row's ancestor otherwise.\n  const hasViewportStore = useThreadViewportStore({ optional: true }) !== null;\n  const registeredViewport = useThreadViewport({\n    optional: true,\n    selector: (state: ThreadViewportState) => state.element.viewport,\n  });\n  const viewport =\n    registeredViewport ?? rowEl?.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`) ?? null;\n  const isMessageMounted = useMessagesNearViewport({\n    viewport,\n    hasViewport: hasViewportStore || viewport !== null,\n    messages,\n  });\n  const historyStore = useContext(StatewireHistoryContext);\n  const { hasOlder, canLoadOlder, loading, loadOlder } = useDeepAgentWindowSync({\n    messages,\n    toolOutputs,\n    nearTop,\n    nearTopEpoch,\n    isMessageMounted,\n    maxConcurrentToolOutputs: HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY,\n    onHistoryLoad,\n    onError: (error, command) => {\n      // Leaving the thread settles an in-flight read as lost: lifecycle, not a failure.\n      if (error instanceof Error && isStatewireChannelTeardown(error)) return;\n      console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);\n    },\n  });\n\n  // Other surfaces of the provider (the workbench's Shell pane) read where the\n  // history stands; leaving the thread or unmounting withdraws the report.\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    historyStore.set({ threadId, hasOlder, canLoadOlder, loading, loadOlder });\n    return undefined;\n  }, [historyStore, threadId, hasOlder, canLoadOlder, loading, loadOlder]);\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    return () => {\n      if (historyStore.get().threadId === threadId) historyStore.set(NO_STATEWIRE_HISTORY);\n    };\n  }, [historyStore, threadId]);\n\n  // The row's own visibility is the near-top level: a level, not an edge, so\n  // pages chain while the user stays at the top and stop once the prepended\n  // content has pushed the row away again.\n  useEffect(() => {\n    if (!rowEl || !hasOlder || typeof IntersectionObserver === \"undefined\") return;\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          const near = entry.isIntersecting;\n          if (nearTopRef.current === near) continue;\n          nearTopRef.current = near;\n          setNearTop(near);\n          if (near) setNearTopEpoch((epoch) => epoch + 1);\n        }\n      },\n      {\n        root: viewport,\n        rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px`,\n      },\n    );\n    observer.observe(rowEl);\n    return () => {\n      observer.disconnect();\n      nearTopRef.current = false;\n      setNearTop(false);\n    };\n  }, [rowEl, hasOlder, viewport]);\n\n  return (\n    <>\n      <KeepReadingPlace viewport={viewport} threadId={threadId} messages={messages} />\n      <HistoryEdgeRow\n        rowRef={setRowEl}\n        hasOlder={hasOlder}\n        canLoadOlder={canLoadOlder}\n        loading={loading}\n        onLoadOlder={loadOlder}\n        className={className}\n      />\n    </>\n  );\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"statewire-history-edge.js","sources":["../../../src/chat-ui/thread/statewire-history-edge.tsx"],"sourcesContent":["import {\n  getExternalStoreMessages,\n  type ThreadMessage,\n  type ThreadViewportState,\n  useAuiState,\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"@assistant-ui/react\";\nimport {\n  type DeepAgentHistoryLoadEvent,\n  type DeepAgentHistoryStore,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  useDeepAgentWindowSync,\n} from \"@athenaintel/agent-runtime\";\nimport type { FC } from \"react\";\nimport { Component, useContext, useEffect, useMemo, useRef, useState } from \"react\";\nimport { cn } from \"../../lib/utils\";\nimport {\n  NO_STATEWIRE_HISTORY,\n  StatewireHistoryContext,\n} from \"../../provider/statewire-history-context\";\nimport {\n  useStatewireHistoryPages,\n  useStatewireToolOutputs,\n} from \"../../provider/statewire-window-context\";\nimport { AthenaStatewireThreadIdContext } from \"../../threads/thread-id-context\";\n\n/** The attribute `ChatThreadShell` stamps on the scroll viewport. */\nexport const THREAD_VIEWPORT_ATTR = \"data-aui-thread-viewport\";\n/** The attribute `ChatThreadShell` stamps on its sticky viewport footer (the composer dock). */\nexport const THREAD_VIEWPORT_FOOTER_ATTR = \"data-aui-thread-viewport-footer\";\n\n/**\n * How far above the viewport the edge row counts as near: the row sits above\n * the first loaded message, so reaching it means the user has scrolled past\n * everything loaded and the next page should already be on its way. Messages\n * this close to the viewport also count as on screen for cut tool outputs.\n */\nexport const HISTORY_EDGE_NEAR_MARGIN_PX = 1500;\n\n/**\n * Cut tool outputs a transcript reads at once. The reads share the session's\n * command lane with everything the person sends, so a long transcript must\n * not queue dozens of them ahead of a message or a Stop.\n */\nexport const HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY = 2;\n\n/** What assistant-ui's `MessagePrimitive.Root` stamps on every message. */\nconst MESSAGE_SELECTOR = \"[data-message-id]\";\n\nconst NO_MESSAGE_IDS: ReadonlySet<string> = new Set();\n\nfunction sameIds({ a, b }: { a: ReadonlySet<string>; b: ReadonlySet<string> }): boolean {\n  if (a.size !== b.size) return false;\n  for (const id of a) if (!b.has(id)) return false;\n  return true;\n}\n\n/**\n * Which messages sit within {@link HISTORY_EDGE_NEAR_MARGIN_PX} of the\n * viewport, so cut tool outputs are read for what the person can reach. A\n * thread opens at its newest turn; reading every loaded step's output up\n * front sent dozens of reads, each re-rendering the transcript, for steps\n * nobody had scrolled to.\n *\n * `undefined` (every message counts) where nothing can be observed: no\n * viewport around the row, or no `IntersectionObserver`. A message rendered\n * without a `data-message-id` root (a host's own renderer) cannot be observed\n * either, so it counts as before.\n */\nfunction useMessagesNearViewport({\n  viewport,\n  hasViewport,\n  messages,\n}: {\n  viewport: HTMLElement | null;\n  /** A viewport is (or will be) registered around the row. */\n  hasViewport: boolean;\n  /** The converted thread: every change may have mounted or remounted a message. */\n  messages: readonly ThreadMessage[];\n}): ((messageId: string) => boolean) | undefined {\n  const [nearIds, setNearIds] = useState<ReadonlySet<string>>(NO_MESSAGE_IDS);\n  const observable = hasViewport && typeof IntersectionObserver !== \"undefined\";\n  const trackRef = useRef<(() => void) | null>(null);\n  // Every id a rendered element carries, as of the last scan.\n  const renderedIdsRef = useRef<ReadonlySet<string>>(NO_MESSAGE_IDS);\n\n  useEffect(() => {\n    if (!viewport || !observable) return undefined;\n    const near = new Set<Element>();\n    const observed = new Set<Element>();\n    const publish = () => {\n      const ids = new Set<string>();\n      for (const element of near) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) ids.add(id);\n      }\n      setNearIds((previous) => (sameIds({ a: previous, b: ids }) ? previous : ids));\n    };\n    const intersections = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting && entry.target.isConnected) near.add(entry.target);\n          else near.delete(entry.target);\n        }\n        publish();\n      },\n      { root: viewport, rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px` },\n    );\n    // A page that folds into a turn gives it a new id: a host keyed by id\n    // remounts the turn's element, a host keyed by row (`ChatThreadShell`)\n    // keeps it and the element's id changes. So what is observed follows the\n    // rendered elements, not the message list, and the near ids are read off\n    // those elements again on every scan.\n    const track = () => {\n      for (const element of observed) {\n        if (element.isConnected) continue;\n        intersections.unobserve(element);\n        observed.delete(element);\n        near.delete(element);\n      }\n      const rendered = new Set<string>();\n      for (const element of viewport.querySelectorAll(MESSAGE_SELECTOR)) {\n        const id = element.getAttribute(\"data-message-id\");\n        if (id) rendered.add(id);\n        if (observed.has(element)) continue;\n        observed.add(element);\n        intersections.observe(element);\n      }\n      renderedIdsRef.current = rendered;\n      publish();\n    };\n    trackRef.current = track;\n    track();\n    return () => {\n      trackRef.current = null;\n      renderedIdsRef.current = NO_MESSAGE_IDS;\n      intersections.disconnect();\n      setNearIds(NO_MESSAGE_IDS);\n    };\n  }, [viewport, observable]);\n\n  // A changed message list is the trigger to re-scan: its messages render in\n  // the same commit, so their elements are in the DOM by this effect (a\n  // query, no layout read).\n  useEffect(() => {\n    trackRef.current?.();\n  }, [messages]);\n\n  return useMemo(() => {\n    if (!observable) return undefined;\n    return (messageId: string) => {\n      // Not registered yet: nothing is on screen to read for.\n      if (viewport === null) return false;\n      return nearIds.has(messageId) || !renderedIdsRef.current.has(messageId);\n    };\n  }, [nearIds, observable, viewport]);\n}\n\n/** The wire message a converted message was built from first (its oldest source). */\nfunction oldestSourceId(message: ThreadMessage): string | undefined {\n  const source = getExternalStoreMessages<{ id?: unknown }>(message)[0];\n  return typeof source?.id === \"string\" ? source.id : undefined;\n}\n\n/**\n * Whether older history landed ahead of what was loaded: the old first\n * message now sits further down (a page ahead of it), or the first message's\n * old oldest wire message now follows earlier ones (a page that folded into\n * the first loaded turn). A first message replaced in place — a branch picked\n * on it, an edit — is neither, and a run streaming at the tail never touches\n * the first message.\n */\nfunction prependedOlderHistory({\n  previous,\n  next,\n}: {\n  previous: readonly ThreadMessage[];\n  next: readonly ThreadMessage[];\n}): boolean {\n  const previousFirst = previous[0];\n  const nextFirst = next[0];\n  if (previousFirst === undefined || nextFirst === undefined || previousFirst === nextFirst) return false;\n  if (previousFirst.id !== nextFirst.id && next.some((message, index) => index > 0 && message.id === previousFirst.id)) {\n    return true;\n  }\n  const previousOldest = oldestSourceId(previousFirst);\n  if (previousOldest === undefined || previousOldest === oldestSourceId(nextFirst)) return false;\n  return getExternalStoreMessages<{ id?: unknown }>(nextFirst).some(\n    (source, index) => index > 0 && source?.id === previousOldest,\n  );\n}\n\ninterface KeepReadingPlaceProps {\n  viewport: HTMLElement | null;\n  threadId: string | null;\n  /** The converted thread. */\n  messages: readonly ThreadMessage[];\n}\n\n/**\n * Keeps the reader's place when older history lands. Everything a page adds\n * sits above what the person is reading, so their distance from the bottom of\n * the transcript is what must survive. A class for `getSnapshotBeforeUpdate`:\n * the distance is read right before React applies the commit that renders the\n * page — the one moment it is exact, even for a scroll the browser has not\n * reported yet — and restored after it, instantly (never through the\n * viewport's smooth scrolling). Other commits read no layout.\n *\n * The browser's scroll anchoring and assistant-ui's prepend anchor aim at the\n * same position, so whichever ran first leaves this nothing to do; on its own\n * it covers what they miss: a reader at the very top (browsers never anchor\n * at scroll offset 0) and a page that folds into the first loaded turn of a\n * host that keys rows by message id (that message remounts under a new id,\n * taking the browser's anchor node with it; `ChatThreadShell` keeps the row).\n */\nclass KeepReadingPlace extends Component<KeepReadingPlaceProps> {\n  getSnapshotBeforeUpdate(previous: Readonly<KeepReadingPlaceProps>): number | null {\n    const { viewport, threadId, messages } = this.props;\n    if (\n      viewport === null ||\n      viewport !== previous.viewport ||\n      threadId !== previous.threadId ||\n      messages === previous.messages ||\n      !prependedOlderHistory({ previous: previous.messages, next: messages })\n    ) {\n      return null;\n    }\n    return viewport.scrollHeight - viewport.scrollTop;\n  }\n\n  componentDidUpdate(\n    _previous: Readonly<KeepReadingPlaceProps>,\n    _state: unknown,\n    fromBottom: number | null,\n  ): void {\n    const { viewport } = this.props;\n    if (viewport === null || fromBottom === null) return;\n    const top = viewport.scrollHeight - fromBottom;\n    if (Math.abs(viewport.scrollTop - top) >= 1) viewport.scrollTo({ top, behavior: \"instant\" });\n  }\n\n  render(): null {\n    return null;\n  }\n}\n\nexport interface HistoryEdgeRowProps {\n  /** Whether the server holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /** Whether the next page can be asked for; `false` with `hasOlder` is the connection's loading depth spent. Defaults to `hasOlder`. */\n  canLoadOlder?: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  onLoadOlder: () => void;\n  className?: string;\n  /** The row element, for the viewport observer. */\n  rowRef?: (element: HTMLElement | null) => void;\n}\n\n/**\n * The top edge of the LOADED history: a manual way to load the next page of\n * older messages, and the in-flight state. Renders nothing when the whole\n * transcript is loaded (or the head interest has not resolved).\n */\nexport const HistoryEdgeRow: FC<HistoryEdgeRowProps> = ({\n  hasOlder,\n  canLoadOlder = hasOlder,\n  loading,\n  onLoadOlder,\n  className,\n  rowRef,\n}) => {\n  if (!hasOlder) return null;\n  return (\n    <div\n      ref={rowRef}\n      data-testid=\"thread-history-edge\"\n      className={cn(\n        \"mx-auto flex w-full max-w-(--thread-max-width) items-center justify-center py-1 text-xs text-muted-foreground\",\n        className,\n      )}\n    >\n      {loading ? (\n        <span data-testid=\"thread-history-edge-loading\">Loading earlier messages…</span>\n      ) : canLoadOlder ? (\n        <button\n          type=\"button\"\n          data-testid=\"thread-history-edge-load\"\n          onClick={onLoadOlder}\n          className=\"rounded-lg px-2.5 py-1 text-xs font-medium text-muted-foreground transition-colors hover:bg-accent hover:text-foreground\"\n        >\n          Load earlier messages\n        </button>\n      ) : (\n        <span data-testid=\"thread-history-edge-limit\">Earlier messages can't be loaded here</span>\n      )}\n    </div>\n  );\n};\n\nexport interface StatewireHistoryEdgeProps {\n  /**\n   * The thread's tool-output store (the one its converter substitutes from).\n   * Defaults to `AthenaProvider`'s; hosts mounting the runtime themselves pass\n   * the store they gave `useDeepAgentRuntime({ toolOutputs })`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /**\n   * Where older turns are paged by command (`history/page`) from a host that\n   * answers it: the store the thread joins (`useDeepAgentThread({\n   * historyStore })`). Defaults to `AthenaProvider`'s; `null` keeps interest\n   * pages even under the provider. A host that mounts the runtime itself\n   * also provides the store through `StatewireHistoryPagesContext` and the\n   * control through `TurnStepsControlContext` (`EarlierStepsButton`), so a\n   * summarized turn's rows can open its steps.\n   */\n  historyPages?: DeepAgentHistoryStore | null;\n  className?: string;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: (event: DeepAgentHistoryLoadEvent) => void;\n}\n\n/**\n * The client half of the interest window for a DOM thread — mounted once per\n * thread, inside the scroll viewport above the messages (`ChatThreadShell`'s\n * `beforeMessages` slot):\n *\n * - renders the \"Load earlier messages\" edge row and loads the next page when\n *   the row comes near the viewport (scrolling up) or on its button, keeping\n *   the reading position when the page lands above the view;\n * - fetches cut tool outputs whole for the cards near the viewport, a few at\n *   a time, so they re-render complete through the converter (`toolOutputs`).\n *\n * Inert until the head interest resolves: no row, no reads.\n */\nexport const StatewireHistoryEdge: FC<StatewireHistoryEdgeProps> = ({\n  toolOutputs: toolOutputsProp,\n  historyPages: historyPagesProp,\n  className,\n  onHistoryLoad,\n}) => {\n  const providerToolOutputs = useStatewireToolOutputs();\n  const toolOutputs = toolOutputsProp ?? providerToolOutputs ?? undefined;\n  const providerHistoryPages = useStatewireHistoryPages();\n  const historyPages =\n    historyPagesProp === null ? undefined : (historyPagesProp ?? providerHistoryPages ?? undefined);\n  const messages = useAuiState((s) => s.thread.messages);\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const [nearTop, setNearTop] = useState(false);\n  const [nearTopEpoch, setNearTopEpoch] = useState(0);\n  const nearTopRef = useRef(false);\n  const [rowEl, setRowEl] = useState<HTMLElement | null>(null);\n  // The scroll viewport the thread registered (assistant-ui's viewport store),\n  // known even while the row renders nothing; the row's ancestor otherwise.\n  const hasViewportStore = useThreadViewportStore({ optional: true }) !== null;\n  const registeredViewport = useThreadViewport({\n    optional: true,\n    selector: (state: ThreadViewportState) => state.element.viewport,\n  });\n  const viewport =\n    registeredViewport ?? rowEl?.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`) ?? null;\n  const isMessageMounted = useMessagesNearViewport({\n    viewport,\n    hasViewport: hasViewportStore || viewport !== null,\n    messages,\n  });\n  const historyStore = useContext(StatewireHistoryContext);\n  const { hasOlder, canLoadOlder, loading, loadOlder } = useDeepAgentWindowSync({\n    messages,\n    toolOutputs,\n    nearTop,\n    nearTopEpoch,\n    isMessageMounted,\n    maxConcurrentToolOutputs: HISTORY_EDGE_TOOL_OUTPUT_CONCURRENCY,\n    onHistoryLoad,\n    historyPages,\n    onError: (error, command) => {\n      // Leaving the thread settles an in-flight read as lost: lifecycle, not a failure.\n      if (error instanceof Error && isStatewireChannelTeardown(error)) return;\n      console.warn(`[StatewireHistoryEdge] ${command} failed:`, error);\n    },\n  });\n\n  // Other surfaces of the provider (the workbench's Shell pane) read where the\n  // history stands; leaving the thread or unmounting withdraws the report.\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    historyStore.set({ threadId, hasOlder, canLoadOlder, loading, loadOlder });\n    return undefined;\n  }, [historyStore, threadId, hasOlder, canLoadOlder, loading, loadOlder]);\n  useEffect(() => {\n    if (!historyStore || !threadId) return undefined;\n    return () => {\n      if (historyStore.get().threadId === threadId) historyStore.set(NO_STATEWIRE_HISTORY);\n    };\n  }, [historyStore, threadId]);\n\n  // The row's own visibility is the near-top level: a level, not an edge, so\n  // pages chain while the user stays at the top and stop once the prepended\n  // content has pushed the row away again.\n  useEffect(() => {\n    if (!rowEl || !hasOlder || typeof IntersectionObserver === \"undefined\") return;\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          const near = entry.isIntersecting;\n          if (nearTopRef.current === near) continue;\n          nearTopRef.current = near;\n          setNearTop(near);\n          if (near) setNearTopEpoch((epoch) => epoch + 1);\n        }\n      },\n      {\n        root: viewport,\n        rootMargin: `${HISTORY_EDGE_NEAR_MARGIN_PX}px 0px`,\n      },\n    );\n    observer.observe(rowEl);\n    return () => {\n      observer.disconnect();\n      nearTopRef.current = false;\n      setNearTop(false);\n    };\n  }, [rowEl, hasOlder, viewport]);\n\n  return (\n    <>\n      <KeepReadingPlace viewport={viewport} threadId={threadId} messages={messages} />\n      <HistoryEdgeRow\n        rowRef={setRowEl}\n        hasOlder={hasOlder}\n        canLoadOlder={canLoadOlder}\n        loading={loading}\n        onLoadOlder={loadOlder}\n        className={className}\n      />\n    </>\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/collab/client.cjs

@@ -100,6 +100,7 @@ function connectGenericDoc(args) {
   let localChangesSynced = true;
   let liveGrant = null;
   let readStatusOnConnect = false;
+  let accessRecheckPending = false;
   let keryxAnswersSyncStep1 = false;
   let httpFirstRead = null;
   const notify = () => {
@@ -284,7 +285,8 @@ function connectGenericDoc(args) {
           grant,
           firstConnection,
           offlineForMs,
-          hasUnsyncedEdits: hasUnsyncedLocalEdits()
+          hasUnsyncedEdits: hasUnsyncedLocalEdits(),
+          ...accessRecheckPending ? { accessRechecked: true } : {}
         });
       } catch {
         if (destroyed || !connectionEnabled || seq !== connectSeq) return;
@@ -293,6 +295,7 @@ function connectGenericDoc(args) {
         return;
       }
       if (destroyed || !connectionEnabled || seq !== connectSeq) return;
+      accessRecheckPending = false;
       if (decision === "hold") {
         held = true;
         heldGrant = grant;
@@ -345,6 +348,7 @@ function connectGenericDoc(args) {
       if (event.status === "connected") {
         consecutiveRemints = 0;
         readStatusOnConnect = false;
+        accessRecheckPending = false;
       }
       setStatus(event.status);
       if (event.status === "connected") documentStatus$1 == null ? void 0 : documentStatus$1.connected({ readNow: readStatusNow });
@@ -373,6 +377,7 @@ function connectGenericDoc(args) {
       if (action === "remint") {
         consecutiveRemints += 1;
         readStatusOnConnect = true;
+        accessRecheckPending = true;
         documentStatus$1 == null ? void 0 : documentStatus$1.disconnected();
         teardownProvider();
         if (consecutiveRemints > tokenRefresh.MAX_CONSECUTIVE_REMINTS) {
@@ -542,6 +547,39 @@ function connectGenericDoc(args) {
     listeners.add(check);
     check();
   });
+  let grantRefresh = null;
+  const askForGrant = async () => {
+    try {
+      const grant = await mint2({ assetId: args.assetId, access });
+      if (destroyed || !connectionEnabled || grant.access_type !== "rw") return false;
+      if (held) {
+        if ((heldGrant == null ? void 0 : heldGrant.access_type) !== "r") return false;
+        held = false;
+        heldGrant = null;
+        notify();
+        void connect({ grant });
+        return true;
+      }
+      if (status !== "connected") return false;
+      if (accessType === "rw") return true;
+      void connect({ scheduledRefresh: true, grant });
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  const refreshGrant = () => {
+    if (destroyed || !connectionEnabled) return Promise.resolve(false);
+    if (grantRefresh) return grantRefresh;
+    const heldOnRead = held && (heldGrant == null ? void 0 : heldGrant.access_type) === "r";
+    if (!heldOnRead && status !== "connected") return Promise.resolve(false);
+    if (!heldOnRead && accessType === "rw") return Promise.resolve(true);
+    const asked = askForGrant().finally(() => {
+      grantRefresh = null;
+    });
+    grantRefresh = asked;
+    return asked;
+  };
   return {
     doc,
     get status() {
@@ -592,6 +630,7 @@ function connectGenericDoc(args) {
       if (!connectionEnabled || held) return Promise.resolve();
       return provider ? connect({ scheduledRefresh: true }) : connect();
     },
+    refreshGrant,
     setConnectionEnabled: (enabled) => {
       var _a, _b;
       if (destroyed || enabled === connectionEnabled) return;