@athenaintel/react 0.53.0 → 0.54.0

package/dist/chat-ui/thread/handoff-cursor.d.ts

@@ -36,20 +36,28 @@ interface ThreadSnapshot {
  * Opens the transcript at `cursor`: looks for the message every
  * {@link HANDOFF_CURSOR_POLL_MS}, pages older history in while it is further
  * back, scrolls to it, holds it in view while the transcript settles (until
- * the person scrolls), and highlights it. Calls `onSettled` once it revealed
- * the message or gave up (the bottom). Returns its cancel.
+ * the person scrolls), and highlights it. `claim` takes the pickup right
+ * before the scroll (`false`: another transcript showing the conversation took
+ * it, and this one stays put). Calls `onSettled` once it gave up (the bottom)
+ * or its hold ended. Returns its cancel, which leaves a revealed message's
+ * hold and highlight to finish on their own unless `endHold` (a newer pickup
+ * took over).
  */
-export declare function startHandoffCursorReveal({ cursor, readThread, readViewport, onSettled, now, }: {
+export declare function startHandoffCursorReveal({ cursor, readThread, readViewport, claim, onSettled, now, }: {
     cursor: string;
     readThread: () => ThreadSnapshot;
     readViewport: () => HTMLElement | null;
+    claim?: () => boolean;
     onSettled: () => void;
     now?: () => number;
-}): () => void;
+}): (options?: {
+    endHold?: boolean;
+}) => void;
 /**
  * Opens `threadId`'s transcript at the message the source was reading, once,
  * when this surface picked the conversation up with a cursor
- * (`recordHandoffArrival({ cursor })`). Renders nothing.
+ * (`recordHandoffArrival({ cursor })`). When two transcripts show the
+ * conversation, the first to find the message owns the pickup. Renders nothing.
  */
 export declare const HandoffCursorReveal: FC<{
     threadId: string | null | undefined;

package/dist/chat-ui/thread/handoff-cursor.js

@@ -1,9 +1,9 @@
 import { useAui, useThreadViewport, useThreadViewportStore } from "@assistant-ui/react";
 import { useRef, useEffect, useCallback } from "react";
 import { THREAD_VIEWPORT_ATTR, THREAD_VIEWPORT_FOOTER_ATTR } from "./statewire-history-edge.js";
-import { useHandoffArrivalCursor, settleHandoffArrivalCursor } from "../../agent-runtime/src/handoff-arrival.js";
+import { useHandoffArrivalCursor, readHandoffArrival, settleHandoffArrivalCursor } from "../../agent-runtime/src/handoff-arrival.js";
 import { readingCursorOf, handoffCursorMessageId, MESSAGE_ROW_ID_ATTRIBUTE, handoffCursorRevealStep, HANDOFF_CURSOR_HIGHLIGHT_MS, HANDOFF_CURSOR_SETTLE_MS } from "../../agent-runtime/src/handoff-cursor.js";
-import { deepAgentHistoryHasOlder, loadOlderDeepAgentHistoryPage, readDeepAgentStatewireExtras } from "../../agent-runtime/src/edit-command.js";
+import { deepAgentHistoryHasOlder, loadOlderDeepAgentHistoryPage, isHistoryPageLostToReconnect, readDeepAgentStatewireExtras } from "../../agent-runtime/src/edit-command.js";
 const THREAD_ROOT_SELECTOR = "[data-aui-thread-root]";
 const HANDOFF_CURSOR_REVEALED_ATTR = "data-handoff-cursor-revealed";
 const HANDOFF_CURSOR_POLL_MS = 150;
@@ -84,6 +84,7 @@ function startHandoffCursorReveal({
   cursor,
   readThread,
   readViewport,
+  claim = () => true,
   onSettled,
   now = () => Date.now()
 }) {
@@ -114,8 +115,8 @@ function startHandoffCursorReveal({
       }
       pagesLoaded += 1;
       waitingSince = now();
-    }).catch(() => {
-      pagesLoaded = Number.POSITIVE_INFINITY;
+    }).catch((error) => {
+      if (!isHistoryPageLostToReconnect(error)) pagesLoaded = Number.POSITIVE_INFINITY;
     }).finally(() => {
       paging = false;
       pageLandsAt = now() + 2 * HANDOFF_CURSOR_POLL_MS;
@@ -148,6 +149,11 @@ function startHandoffCursorReveal({
     switch (step) {
       case "reveal": {
         if (!viewport || !element) return;
+        if (!claim()) {
+          settled = true;
+          clearInterval(timer);
+          return;
+        }
         scrollMessageIntoView({ viewport, element });
         unhighlight = highlightMessage(element);
         revealed = { element, viewport, at: now() };
@@ -173,8 +179,10 @@ function startHandoffCursorReveal({
   };
   const timer = setInterval(tick, HANDOFF_CURSOR_POLL_MS);
   tick();
-  return () => {
+  return ({ endHold = false } = {}) => {
+    if (endHold) unhighlight == null ? void 0 : unhighlight();
     if (settled) return;
+    if (revealed && !endHold) return;
     settled = true;
     clearInterval(timer);
     detach == null ? void 0 : detach();
@@ -190,17 +198,34 @@ const HandoffCursorReveal = ({ threadId }) => {
   });
   const viewportRef = useRef(viewport);
   viewportRef.current = viewport;
+  const latestRef = useRef(null);
   useEffect(() => {
+    var _a;
     if (!threadId || !cursor) return void 0;
-    return startHandoffCursorReveal({
+    (_a = latestRef.current) == null ? void 0 : _a.call(latestRef, { endHold: true });
+    const cancel = startHandoffCursorReveal({
       cursor,
       readThread: () => {
         const state = aui.thread().getState();
         return { messages: state.messages, isLoading: state.isLoading, extras: state.extras };
       },
       readViewport: () => viewportRef.current ?? null,
-      onSettled: () => settleHandoffArrivalCursor(threadId)
+      // Settled before the scroll, so a second transcript's reveal stops at its claim.
+      claim: () => {
+        var _a2;
+        if (((_a2 = readHandoffArrival(threadId)) == null ? void 0 : _a2.cursor) !== cursor) return false;
+        settleHandoffArrivalCursor(threadId);
+        return true;
+      },
+      // Only this pickup's: a revealed message's hold ends after its claim
+      // settled the cursor, when a later handover may have recorded another.
+      onSettled: () => {
+        var _a2;
+        if (((_a2 = readHandoffArrival(threadId)) == null ? void 0 : _a2.cursor) === cursor) settleHandoffArrivalCursor(threadId);
+      }
     });
+    latestRef.current = cancel;
+    return cancel;
   }, [aui, cursor, threadId]);
   return null;
 };

package/dist/chat-ui/thread/handoff-cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"handoff-cursor.js","sources":["../../../src/chat-ui/thread/handoff-cursor.tsx"],"sourcesContent":["/**\n * Handovers open where the person was reading (`@athenaintel/agent-runtime`'s\n * `handoff-cursor`), for every host of `ChatThreadShell` (Athena in Chrome,\n * the desktop app, `AthenaChat`).\n *\n * As a source, `useReadThreadReadingCursor` reads the shell's viewport at the\n * moment of the click: `null` at the bottom, else the id of the last message\n * fully in view. As a destination, `HandoffCursorReveal` (mounted by the shell\n * for its `arrivalThreadId`) scrolls to the message the arrival names once the\n * transcript has it, paging older history in when it is further back, and\n * highlights it briefly; a cursor it can't find leaves the view at the bottom.\n */\nimport {\n  type ThreadMessage,\n  type ThreadViewportState,\n  useAui,\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"@assistant-ui/react\";\nimport {\n  deepAgentHistoryHasOlder,\n  HANDOFF_CURSOR_HIGHLIGHT_MS,\n  HANDOFF_CURSOR_SETTLE_MS,\n  handoffCursorMessageId,\n  handoffCursorRevealStep,\n  loadOlderDeepAgentHistoryPage,\n  MESSAGE_ROW_ID_ATTRIBUTE,\n  readDeepAgentStatewireExtras,\n  readingCursorOf,\n  settleHandoffArrivalCursor,\n  useHandoffArrivalCursor,\n} from \"@athenaintel/agent-runtime\";\nimport type { FC } from \"react\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { THREAD_VIEWPORT_ATTR, THREAD_VIEWPORT_FOOTER_ATTR } from \"./statewire-history-edge\";\n/** What assistant-ui's `ThreadPrimitive.Root` stamps on the thread panel. */\nconst THREAD_ROOT_SELECTOR = \"[data-aui-thread-root]\";\n/** Set on the revealed message while it is highlighted. */\nexport const HANDOFF_CURSOR_REVEALED_ATTR = \"data-handoff-cursor-revealed\";\n/** How often a landing looks for its message while the transcript loads. */\nexport const HANDOFF_CURSOR_POLL_MS = 150;\n\nconst escapeAttributeValue = (value: string): string =>\n  typeof CSS !== \"undefined\" && typeof CSS.escape === \"function\"\n    ? CSS.escape(value)\n    : value.replace(/[\"\\\\]/g, \"\\\\$&\");\n\n/** The thread viewport `anchor` sits in, or the one of the thread panel it sits in. */\nexport function findThreadViewport(anchor: Element | null | undefined): HTMLElement | null {\n  if (!anchor) return null;\n  const inside = anchor.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`);\n  if (inside) return inside;\n  return (\n    anchor.closest(THREAD_ROOT_SELECTOR)?.querySelector<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`) ??\n    null\n  );\n}\n\n/** How much of `viewport` its sticky footer (the composer dock) covers at the bottom. */\nfunction coveredBottomOf(viewport: HTMLElement): number {\n  const footer = viewport.querySelector<HTMLElement>(`[${THREAD_VIEWPORT_FOOTER_ATTR}]`);\n  if (!footer) return 0;\n  return Math.max(0, viewport.getBoundingClientRect().bottom - footer.getBoundingClientRect().top);\n}\n\n/** Where `viewport` is being read: `null` at the bottom, else a message id. */\nexport function readThreadReadingCursor(viewport: HTMLElement | null): string | null {\n  if (!viewport) return null;\n  return readingCursorOf({ viewport, coveredBottomPx: coveredBottomOf(viewport) });\n}\n\n/**\n * Reads where the thread is being read, at the moment of a click: inside the\n * viewport (a composer toolbar, even from a portaled dialog) through the\n * thread's viewport store; elsewhere in the panel (a header menu) from the\n * DOM around `anchor`. `null` at the bottom or with no viewport found.\n */\nexport function useReadThreadReadingCursor(): (anchor?: Element | null) => string | null {\n  const store = useThreadViewportStore({ optional: true });\n  return useCallback(\n    (anchor?: Element | null) =>\n      readThreadReadingCursor(store?.getState().element.viewport ?? findThreadViewport(anchor)),\n    [store],\n  );\n}\n\n/** Scrolls `element` into `viewport`'s visible part: centred, or its top when taller. */\nfunction scrollMessageIntoView({\n  viewport,\n  element,\n}: {\n  viewport: HTMLElement;\n  element: HTMLElement;\n}): void {\n  const box = viewport.getBoundingClientRect();\n  const rect = element.getBoundingClientRect();\n  const visible = Math.max(1, box.height - coveredBottomOf(viewport));\n  const offsetTop = rect.top - box.top + viewport.scrollTop;\n  const top =\n    rect.height >= visible ? offsetTop - 8 : offsetTop - (visible - rect.height) / 2;\n  // `instant`: the shell's viewport scrolls smoothly by default.\n  viewport.scrollTo({ top: Math.max(0, top), behavior: \"instant\" });\n}\n\nfunction isInView({ viewport, element }: { viewport: HTMLElement; element: HTMLElement }): boolean {\n  const box = viewport.getBoundingClientRect();\n  const rect = element.getBoundingClientRect();\n  return rect.bottom > box.top && rect.top < box.bottom - coveredBottomOf(viewport);\n}\n\n/**\n * A brief tint on the revealed message, through the Web Animations API so it\n * needs nothing from the host's stylesheet. Returns its undo.\n */\nfunction highlightMessage(element: HTMLElement): () => void {\n  element.setAttribute(HANDOFF_CURSOR_REVEALED_ATTR, \"\");\n  const animation =\n    typeof element.animate === \"function\"\n      ? element.animate(\n          [\n            {\n              backgroundColor: \"rgba(37, 99, 235, 0.12)\",\n              boxShadow: \"0 0 0 2px rgba(37, 99, 235, 0.35)\",\n              borderRadius: \"12px\",\n            },\n            {\n              backgroundColor: \"rgba(37, 99, 235, 0.12)\",\n              boxShadow: \"0 0 0 2px rgba(37, 99, 235, 0.35)\",\n              borderRadius: \"12px\",\n              offset: 0.5,\n            },\n            {\n              backgroundColor: \"rgba(37, 99, 235, 0)\",\n              boxShadow: \"0 0 0 2px rgba(37, 99, 235, 0)\",\n              borderRadius: \"12px\",\n            },\n          ],\n          { duration: HANDOFF_CURSOR_HIGHLIGHT_MS, easing: \"ease-out\" },\n        )\n      : null;\n  const timer = setTimeout(\n    () => element.removeAttribute(HANDOFF_CURSOR_REVEALED_ATTR),\n    HANDOFF_CURSOR_HIGHLIGHT_MS,\n  );\n  return () => {\n    clearTimeout(timer);\n    animation?.cancel();\n    element.removeAttribute(HANDOFF_CURSOR_REVEALED_ATTR);\n  };\n}\n\ninterface ThreadSnapshot {\n  messages: readonly ThreadMessage[];\n  isLoading: boolean;\n  extras: unknown;\n}\n\n/**\n * Opens the transcript at `cursor`: looks for the message every\n * {@link HANDOFF_CURSOR_POLL_MS}, pages older history in while it is further\n * back, scrolls to it, holds it in view while the transcript settles (until\n * the person scrolls), and highlights it. Calls `onSettled` once it revealed\n * the message or gave up (the bottom). Returns its cancel.\n */\nexport function startHandoffCursorReveal({\n  cursor,\n  readThread,\n  readViewport,\n  onSettled,\n  now = () => Date.now(),\n}: {\n  cursor: string;\n  readThread: () => ThreadSnapshot;\n  readViewport: () => HTMLElement | null;\n  onSettled: () => void;\n  now?: () => number;\n}): () => void {\n  // Progress restarts the wait: the reveal started, or a page of older history landed.\n  let waitingSince = now();\n  let pagesLoaded = 0;\n  let paging = false;\n  // A page that landed renders on a later commit: look again before paging on.\n  let pageLandsAt = 0;\n  let settled = false;\n  let revealed: { element: HTMLElement; viewport: HTMLElement; at: number } | null = null;\n  let personScrolled = false;\n  let unhighlight: (() => void) | null = null;\n  let detach: (() => void) | null = null;\n\n  const settle = () => {\n    if (settled) return;\n    settled = true;\n    clearInterval(timer);\n    detach?.();\n    onSettled();\n  };\n  const pageOlder = () => {\n    paging = true;\n    loadOlderDeepAgentHistoryPage({\n      readExtras: () => readDeepAgentStatewireExtras(readThread().extras),\n    })\n      .then((loaded) => {\n        if (!loaded) {\n          // Nothing older could be stated: the history is exhausted.\n          pagesLoaded = Number.POSITIVE_INFINITY;\n          return;\n        }\n        pagesLoaded += 1;\n        waitingSince = now();\n      })\n      .catch(() => {\n        pagesLoaded = Number.POSITIVE_INFINITY;\n      })\n      .finally(() => {\n        paging = false;\n        pageLandsAt = now() + 2 * HANDOFF_CURSOR_POLL_MS;\n      });\n  };\n  const tick = () => {\n    if (settled) return;\n    if (revealed) {\n      if (personScrolled || now() - revealed.at >= HANDOFF_CURSOR_SETTLE_MS) {\n        settle();\n        return;\n      }\n      if (revealed.element.isConnected && !isInView(revealed)) scrollMessageIntoView(revealed);\n      return;\n    }\n    const viewport = readViewport();\n    const { messages, isLoading, extras } = readThread();\n    const targetId = handoffCursorMessageId({ messages, cursor });\n    const element =\n      targetId !== null && viewport\n        ? viewport.querySelector<HTMLElement>(\n            `[${MESSAGE_ROW_ID_ATTRIBUTE}=\"${escapeAttributeValue(targetId)}\"]`,\n          )\n        : null;\n    const step = handoffCursorRevealStep({\n      found: element !== null,\n      // Still attaching, a page in flight, or the row not rendered yet.\n      loading:\n        isLoading ||\n        paging ||\n        now() < pageLandsAt ||\n        messages.length === 0 ||\n        (targetId !== null && !element),\n      hasOlder: deepAgentHistoryHasOlder(extras),\n      pagesLoaded,\n      elapsedMs: now() - waitingSince,\n    });\n    switch (step) {\n      case \"reveal\": {\n        if (!viewport || !element) return;\n        scrollMessageIntoView({ viewport, element });\n        unhighlight = highlightMessage(element);\n        revealed = { element, viewport, at: now() };\n        const stop = () => {\n          personScrolled = true;\n        };\n        const events = [\"wheel\", \"touchstart\", \"pointerdown\", \"keydown\"] as const;\n        for (const event of events) viewport.addEventListener(event, stop, { passive: true });\n        detach = () => {\n          for (const event of events) viewport.removeEventListener(event, stop);\n        };\n        return;\n      }\n      case \"page\":\n        pageOlder();\n        return;\n      case \"wait\":\n        return;\n      case \"bottom\":\n        settle();\n        return;\n    }\n  };\n  const timer = setInterval(tick, HANDOFF_CURSOR_POLL_MS);\n  tick();\n  return () => {\n    // Once settled, the highlight fades out on its own timer.\n    if (settled) return;\n    settled = true;\n    clearInterval(timer);\n    detach?.();\n    unhighlight?.();\n  };\n}\n\n/**\n * Opens `threadId`'s transcript at the message the source was reading, once,\n * when this surface picked the conversation up with a cursor\n * (`recordHandoffArrival({ cursor })`). Renders nothing.\n */\nexport const HandoffCursorReveal: FC<{ threadId: string | null | undefined }> = ({ threadId }) => {\n  const cursor = useHandoffArrivalCursor(threadId);\n  const aui = useAui();\n  const viewport = useThreadViewport({\n    optional: true,\n    selector: (state: ThreadViewportState) => state.element.viewport,\n  });\n  const viewportRef = useRef(viewport);\n  viewportRef.current = viewport;\n  useEffect(() => {\n    if (!threadId || !cursor) return undefined;\n    return startHandoffCursorReveal({\n      cursor,\n      readThread: () => {\n        const state = aui.thread().getState();\n        return { messages: state.messages, isLoading: state.isLoading, extras: state.extras };\n      },\n      readViewport: () => viewportRef.current ?? null,\n      onSettled: () => settleHandoffArrivalCursor(threadId),\n    });\n  }, [aui, cursor, threadId]);\n  return null;\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"handoff-cursor.js","sources":["../../../src/chat-ui/thread/handoff-cursor.tsx"],"sourcesContent":["/**\n * Handovers open where the person was reading (`@athenaintel/agent-runtime`'s\n * `handoff-cursor`), for every host of `ChatThreadShell` (Athena in Chrome,\n * the desktop app, `AthenaChat`).\n *\n * As a source, `useReadThreadReadingCursor` reads the shell's viewport at the\n * moment of the click: `null` at the bottom, else the id of the last message\n * fully in view. As a destination, `HandoffCursorReveal` (mounted by the shell\n * for its `arrivalThreadId`) scrolls to the message the arrival names once the\n * transcript has it, paging older history in when it is further back, and\n * highlights it briefly; a cursor it can't find leaves the view at the bottom.\n */\nimport {\n  type ThreadMessage,\n  type ThreadViewportState,\n  useAui,\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"@assistant-ui/react\";\nimport {\n  deepAgentHistoryHasOlder,\n  HANDOFF_CURSOR_HIGHLIGHT_MS,\n  HANDOFF_CURSOR_SETTLE_MS,\n  handoffCursorMessageId,\n  handoffCursorRevealStep,\n  isHistoryPageLostToReconnect,\n  loadOlderDeepAgentHistoryPage,\n  MESSAGE_ROW_ID_ATTRIBUTE,\n  readDeepAgentStatewireExtras,\n  readHandoffArrival,\n  readingCursorOf,\n  settleHandoffArrivalCursor,\n  useHandoffArrivalCursor,\n} from \"@athenaintel/agent-runtime\";\nimport type { FC } from \"react\";\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { THREAD_VIEWPORT_ATTR, THREAD_VIEWPORT_FOOTER_ATTR } from \"./statewire-history-edge\";\n/** What assistant-ui's `ThreadPrimitive.Root` stamps on the thread panel. */\nconst THREAD_ROOT_SELECTOR = \"[data-aui-thread-root]\";\n/** Set on the revealed message while it is highlighted. */\nexport const HANDOFF_CURSOR_REVEALED_ATTR = \"data-handoff-cursor-revealed\";\n/** How often a landing looks for its message while the transcript loads. */\nexport const HANDOFF_CURSOR_POLL_MS = 150;\n\nconst escapeAttributeValue = (value: string): string =>\n  typeof CSS !== \"undefined\" && typeof CSS.escape === \"function\"\n    ? CSS.escape(value)\n    : value.replace(/[\"\\\\]/g, \"\\\\$&\");\n\n/** The thread viewport `anchor` sits in, or the one of the thread panel it sits in. */\nexport function findThreadViewport(anchor: Element | null | undefined): HTMLElement | null {\n  if (!anchor) return null;\n  const inside = anchor.closest<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`);\n  if (inside) return inside;\n  return (\n    anchor.closest(THREAD_ROOT_SELECTOR)?.querySelector<HTMLElement>(`[${THREAD_VIEWPORT_ATTR}]`) ??\n    null\n  );\n}\n\n/** How much of `viewport` its sticky footer (the composer dock) covers at the bottom. */\nfunction coveredBottomOf(viewport: HTMLElement): number {\n  const footer = viewport.querySelector<HTMLElement>(`[${THREAD_VIEWPORT_FOOTER_ATTR}]`);\n  if (!footer) return 0;\n  return Math.max(0, viewport.getBoundingClientRect().bottom - footer.getBoundingClientRect().top);\n}\n\n/** Where `viewport` is being read: `null` at the bottom, else a message id. */\nexport function readThreadReadingCursor(viewport: HTMLElement | null): string | null {\n  if (!viewport) return null;\n  return readingCursorOf({ viewport, coveredBottomPx: coveredBottomOf(viewport) });\n}\n\n/**\n * Reads where the thread is being read, at the moment of a click: inside the\n * viewport (a composer toolbar, even from a portaled dialog) through the\n * thread's viewport store; elsewhere in the panel (a header menu) from the\n * DOM around `anchor`. `null` at the bottom or with no viewport found.\n */\nexport function useReadThreadReadingCursor(): (anchor?: Element | null) => string | null {\n  const store = useThreadViewportStore({ optional: true });\n  return useCallback(\n    (anchor?: Element | null) =>\n      readThreadReadingCursor(store?.getState().element.viewport ?? findThreadViewport(anchor)),\n    [store],\n  );\n}\n\n/** Scrolls `element` into `viewport`'s visible part: centred, or its top when taller. */\nfunction scrollMessageIntoView({\n  viewport,\n  element,\n}: {\n  viewport: HTMLElement;\n  element: HTMLElement;\n}): void {\n  const box = viewport.getBoundingClientRect();\n  const rect = element.getBoundingClientRect();\n  const visible = Math.max(1, box.height - coveredBottomOf(viewport));\n  const offsetTop = rect.top - box.top + viewport.scrollTop;\n  const top =\n    rect.height >= visible ? offsetTop - 8 : offsetTop - (visible - rect.height) / 2;\n  // `instant`: the shell's viewport scrolls smoothly by default.\n  viewport.scrollTo({ top: Math.max(0, top), behavior: \"instant\" });\n}\n\nfunction isInView({ viewport, element }: { viewport: HTMLElement; element: HTMLElement }): boolean {\n  const box = viewport.getBoundingClientRect();\n  const rect = element.getBoundingClientRect();\n  return rect.bottom > box.top && rect.top < box.bottom - coveredBottomOf(viewport);\n}\n\n/**\n * A brief tint on the revealed message, through the Web Animations API so it\n * needs nothing from the host's stylesheet. Returns its undo.\n */\nfunction highlightMessage(element: HTMLElement): () => void {\n  element.setAttribute(HANDOFF_CURSOR_REVEALED_ATTR, \"\");\n  const animation =\n    typeof element.animate === \"function\"\n      ? element.animate(\n          [\n            {\n              backgroundColor: \"rgba(37, 99, 235, 0.12)\",\n              boxShadow: \"0 0 0 2px rgba(37, 99, 235, 0.35)\",\n              borderRadius: \"12px\",\n            },\n            {\n              backgroundColor: \"rgba(37, 99, 235, 0.12)\",\n              boxShadow: \"0 0 0 2px rgba(37, 99, 235, 0.35)\",\n              borderRadius: \"12px\",\n              offset: 0.5,\n            },\n            {\n              backgroundColor: \"rgba(37, 99, 235, 0)\",\n              boxShadow: \"0 0 0 2px rgba(37, 99, 235, 0)\",\n              borderRadius: \"12px\",\n            },\n          ],\n          { duration: HANDOFF_CURSOR_HIGHLIGHT_MS, easing: \"ease-out\" },\n        )\n      : null;\n  const timer = setTimeout(\n    () => element.removeAttribute(HANDOFF_CURSOR_REVEALED_ATTR),\n    HANDOFF_CURSOR_HIGHLIGHT_MS,\n  );\n  return () => {\n    clearTimeout(timer);\n    animation?.cancel();\n    element.removeAttribute(HANDOFF_CURSOR_REVEALED_ATTR);\n  };\n}\n\ninterface ThreadSnapshot {\n  messages: readonly ThreadMessage[];\n  isLoading: boolean;\n  extras: unknown;\n}\n\n/**\n * Opens the transcript at `cursor`: looks for the message every\n * {@link HANDOFF_CURSOR_POLL_MS}, pages older history in while it is further\n * back, scrolls to it, holds it in view while the transcript settles (until\n * the person scrolls), and highlights it. `claim` takes the pickup right\n * before the scroll (`false`: another transcript showing the conversation took\n * it, and this one stays put). Calls `onSettled` once it gave up (the bottom)\n * or its hold ended. Returns its cancel, which leaves a revealed message's\n * hold and highlight to finish on their own unless `endHold` (a newer pickup\n * took over).\n */\nexport function startHandoffCursorReveal({\n  cursor,\n  readThread,\n  readViewport,\n  claim = () => true,\n  onSettled,\n  now = () => Date.now(),\n}: {\n  cursor: string;\n  readThread: () => ThreadSnapshot;\n  readViewport: () => HTMLElement | null;\n  claim?: () => boolean;\n  onSettled: () => void;\n  now?: () => number;\n}): (options?: { endHold?: boolean }) => void {\n  // Progress restarts the wait: the reveal started, or a page of older history landed.\n  let waitingSince = now();\n  let pagesLoaded = 0;\n  let paging = false;\n  // A page that landed renders on a later commit: look again before paging on.\n  let pageLandsAt = 0;\n  let settled = false;\n  let revealed: { element: HTMLElement; viewport: HTMLElement; at: number } | null = null;\n  let personScrolled = false;\n  let unhighlight: (() => void) | null = null;\n  let detach: (() => void) | null = null;\n\n  const settle = () => {\n    if (settled) return;\n    settled = true;\n    clearInterval(timer);\n    detach?.();\n    onSettled();\n  };\n  const pageOlder = () => {\n    paging = true;\n    loadOlderDeepAgentHistoryPage({\n      readExtras: () => readDeepAgentStatewireExtras(readThread().extras),\n    })\n      .then((loaded) => {\n        if (!loaded) {\n          // Nothing older could be stated: the history is exhausted.\n          pagesLoaded = Number.POSITIVE_INFINITY;\n          return;\n        }\n        pagesLoaded += 1;\n        waitingSince = now();\n      })\n      .catch((error: unknown) => {\n        // A dropped connection is not the end of the history: the re-attach\n        // carries what was loaded, and the next look pages on from there.\n        if (!isHistoryPageLostToReconnect(error)) pagesLoaded = Number.POSITIVE_INFINITY;\n      })\n      .finally(() => {\n        paging = false;\n        pageLandsAt = now() + 2 * HANDOFF_CURSOR_POLL_MS;\n      });\n  };\n  const tick = () => {\n    if (settled) return;\n    if (revealed) {\n      if (personScrolled || now() - revealed.at >= HANDOFF_CURSOR_SETTLE_MS) {\n        settle();\n        return;\n      }\n      if (revealed.element.isConnected && !isInView(revealed)) scrollMessageIntoView(revealed);\n      return;\n    }\n    const viewport = readViewport();\n    const { messages, isLoading, extras } = readThread();\n    const targetId = handoffCursorMessageId({ messages, cursor });\n    const element =\n      targetId !== null && viewport\n        ? viewport.querySelector<HTMLElement>(\n            `[${MESSAGE_ROW_ID_ATTRIBUTE}=\"${escapeAttributeValue(targetId)}\"]`,\n          )\n        : null;\n    const step = handoffCursorRevealStep({\n      found: element !== null,\n      // Still attaching, a page in flight, or the row not rendered yet.\n      loading:\n        isLoading ||\n        paging ||\n        now() < pageLandsAt ||\n        messages.length === 0 ||\n        (targetId !== null && !element),\n      hasOlder: deepAgentHistoryHasOlder(extras),\n      pagesLoaded,\n      elapsedMs: now() - waitingSince,\n    });\n    switch (step) {\n      case \"reveal\": {\n        if (!viewport || !element) return;\n        if (!claim()) {\n          // Another transcript showing this conversation took the pickup.\n          settled = true;\n          clearInterval(timer);\n          return;\n        }\n        scrollMessageIntoView({ viewport, element });\n        unhighlight = highlightMessage(element);\n        revealed = { element, viewport, at: now() };\n        const stop = () => {\n          personScrolled = true;\n        };\n        const events = [\"wheel\", \"touchstart\", \"pointerdown\", \"keydown\"] as const;\n        for (const event of events) viewport.addEventListener(event, stop, { passive: true });\n        detach = () => {\n          for (const event of events) viewport.removeEventListener(event, stop);\n        };\n        return;\n      }\n      case \"page\":\n        pageOlder();\n        return;\n      case \"wait\":\n        return;\n      case \"bottom\":\n        settle();\n        return;\n    }\n  };\n  const timer = setInterval(tick, HANDOFF_CURSOR_POLL_MS);\n  tick();\n  return ({ endHold = false } = {}) => {\n    if (endHold) unhighlight?.();\n    if (settled) return;\n    // A revealed message's hold finishes on its own timer, unless a newer pickup took over.\n    if (revealed && !endHold) return;\n    settled = true;\n    clearInterval(timer);\n    detach?.();\n    unhighlight?.();\n  };\n}\n\n/**\n * Opens `threadId`'s transcript at the message the source was reading, once,\n * when this surface picked the conversation up with a cursor\n * (`recordHandoffArrival({ cursor })`). When two transcripts show the\n * conversation, the first to find the message owns the pickup. Renders nothing.\n */\nexport const HandoffCursorReveal: FC<{ threadId: string | null | undefined }> = ({ threadId }) => {\n  const cursor = useHandoffArrivalCursor(threadId);\n  const aui = useAui();\n  const viewport = useThreadViewport({\n    optional: true,\n    selector: (state: ThreadViewportState) => state.element.viewport,\n  });\n  const viewportRef = useRef(viewport);\n  viewportRef.current = viewport;\n  // The latest pickup's reveal: its hold outlives the claim that settles its cursor.\n  const latestRef = useRef<ReturnType<typeof startHandoffCursorReveal> | null>(null);\n  useEffect(() => {\n    if (!threadId || !cursor) return undefined;\n    // A newer pickup takes over: the previous message stops being held and highlighted.\n    latestRef.current?.({ endHold: true });\n    const cancel = startHandoffCursorReveal({\n      cursor,\n      readThread: () => {\n        const state = aui.thread().getState();\n        return { messages: state.messages, isLoading: state.isLoading, extras: state.extras };\n      },\n      readViewport: () => viewportRef.current ?? null,\n      // Settled before the scroll, so a second transcript's reveal stops at its claim.\n      claim: () => {\n        if (readHandoffArrival(threadId)?.cursor !== cursor) return false;\n        settleHandoffArrivalCursor(threadId);\n        return true;\n      },\n      // Only this pickup's: a revealed message's hold ends after its claim\n      // settled the cursor, when a later handover may have recorded another.\n      onSettled: () => {\n        if (readHandoffArrival(threadId)?.cursor === cursor) settleHandoffArrivalCursor(threadId);\n      },\n    });\n    latestRef.current = cancel;\n    return cancel;\n  }, [aui, cursor, threadId]);\n  return null;\n};\n"],"names":["_a"],"mappings":"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"}

package/dist/collab/client.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const initialSync = require("../keryx-http/src/initial-sync.cjs");
 const receiveOnlySocket = require("../keryx-http/src/receive-only-socket.cjs");
 const unconfirmedUpdateAttributions = require("../keryx-http/src/unconfirmed-update-attributions.cjs");
 const updateAttributions = require("../keryx-http/src/update-attributions.cjs");
@@ -53,6 +54,14 @@ function socketFor({
     unconfirmed
   });
 }
+const HTTP_FIRST_READ_TIMEOUT_MS = 6e4;
+function browserStorage() {
+  try {
+    return typeof window !== "undefined" && window.localStorage ? window.localStorage : null;
+  } catch {
+    return null;
+  }
+}
 function connectGenericDoc(args) {
   const access = args.access ?? "view";
   const mint2 = resolveMint({ auth: args.auth, mint: args.mint });
@@ -91,6 +100,8 @@ function connectGenericDoc(args) {
   let localChangesSynced = true;
   let liveGrant = null;
   let readStatusOnConnect = false;
+  let keryxAnswersSyncStep1 = false;
+  let httpFirstRead = null;
   const notify = () => {
     version += 1;
     for (const listener of listeners) listener();
@@ -178,6 +189,10 @@ function connectGenericDoc(args) {
     if (provider) {
       const previous = provider;
       provider = null;
+      if ((httpFirstRead == null ? void 0 : httpFirstRead.target) === previous) {
+        httpFirstRead.controller.abort(new DOMException("The room closed", "AbortError"));
+        httpFirstRead = null;
+      }
       carriedUpdates = [...carriedUpdates, ...previous.unconfirmedUpdates];
       previous.destroy();
     }
@@ -210,7 +225,7 @@ function connectGenericDoc(args) {
     offlineTimer = setTimeout(() => {
       offlineTimer = null;
       if (destroyed || !connectionEnabled || status === "connected" || provider === null) return;
-      if (provider.wsconnecting && !hasUnsyncedLocalEdits()) {
+      if ((provider.wsconnecting || (httpFirstRead == null ? void 0 : httpFirstRead.target) === provider) && !hasUnsyncedLocalEdits()) {
         openingPastThreshold = provider;
         armOfflineTakeover();
         return;
@@ -291,16 +306,23 @@ function connectGenericDoc(args) {
     }
     if (destroyed || !connectionEnabled || seq !== connectSeq) return;
     const socket = socketFor({ grant, doc, unconfirmed: unconfirmedAttributions });
+    const roomUrl = `${grant.ws_url}/${grant.org}/${grant.doc_id}`;
+    const httpFirstUrl = args.httpFirstOpen === true && doc.store.clients.size === 0 && carriedUpdates.length === 0 ? initialSync.keryxRoomReadUrl({ wsUrl: roomUrl, token: grant.token, branch: grant.branch }) : null;
+    const params = {
+      yauth: grant.token,
+      branch: grant.branch,
+      gc: "true"
+    };
+    if (httpFirstUrl === null && asksForDiffedSync({ roomUrl, unconfirmed: carriedUpdates.length })) {
+      params[initialSync.INITIAL_SYNC_PARAM] = initialSync.INITIAL_SYNC_DIFF;
+    }
     const nextProvider = new websocket.WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {
-      params: {
-        yauth: grant.token,
-        branch: grant.branch,
-        gc: "true"
-      },
+      params,
       // BroadcastChannel would sync same-origin clients locally, bypassing the
       // server's permission enforcement (a read-only tab could write into an
       // editor tab's doc). Permissioned docs must round-trip the server.
       disableBc: true,
+      connect: httpFirstUrl === null,
       ...socket && { WebSocketPolyfill: socket }
     });
     provider = nextProvider;
@@ -342,6 +364,11 @@ function connectGenericDoc(args) {
     });
     nextProvider.on("connection-close", (event) => {
       if (provider !== nextProvider) return;
+      if (asksForDiffedSync({ roomUrl, unconfirmed: nextProvider.unconfirmedUpdates.length })) {
+        nextProvider.params[initialSync.INITIAL_SYNC_PARAM] = initialSync.INITIAL_SYNC_DIFF;
+      } else {
+        delete nextProvider.params[initialSync.INITIAL_SYNC_PARAM];
+      }
       const action = closePolicy.classifyClose(event == null ? void 0 : event.code);
       if (action === "remint") {
         consecutiveRemints += 1;
@@ -369,7 +396,68 @@ function connectGenericDoc(args) {
       notify();
     });
     scheduleRefresh(grant);
+    if (httpFirstUrl !== null) void openOverHttp({ target: nextProvider, url: httpFirstUrl, roomUrl });
   };
+  function asksForDiffedSync({ roomUrl, unconfirmed }) {
+    if (args.httpFirstOpen !== true) return false;
+    const origin = initialSync.keryxOriginOf(roomUrl);
+    const known = keryxAnswersSyncStep1 || origin !== null && initialSync.knownInitialSyncSupport({ storage: browserStorage(), origin }) === true;
+    return known && doc.store.clients.size > 0 && unconfirmed === 0 && !unconfirmedAttributions.keepsWrites;
+  }
+  async function openOverHttp({
+    target,
+    url,
+    roomUrl
+  }) {
+    var _a;
+    const started = performance.now();
+    const origin = initialSync.keryxOriginOf(roomUrl);
+    const storage = browserStorage();
+    let event;
+    if (origin !== null && initialSync.knownInitialSyncSupport({ storage, origin }) === false) {
+      event = { outcome: "skipped", durationMs: 0 };
+    } else {
+      const controller = new AbortController();
+      httpFirstRead = { target, controller };
+      const timeout = setTimeout(
+        () => controller.abort(new DOMException("The HTTP-first read timed out", "TimeoutError")),
+        HTTP_FIRST_READ_TIMEOUT_MS
+      );
+      try {
+        const read = await initialSync.readRoomOverHttp({ url, signal: controller.signal });
+        if (origin !== null) initialSync.rememberInitialSyncSupport({ storage, origin, supported: read.answersSyncStep1 });
+        if (read.answersSyncStep1 && provider === target && !destroyed) {
+          if (read.update.byteLength > 2) Y__namespace.applyUpdate(doc, read.update, target);
+          keryxAnswersSyncStep1 = true;
+        }
+        event = {
+          outcome: read.answersSyncStep1 ? "read" : "unsupported",
+          bytes: read.bytes,
+          durationMs: performance.now() - started
+        };
+      } catch (err) {
+        event = controller.signal.aborted && (destroyed || provider !== target) ? { outcome: "aborted", durationMs: performance.now() - started } : {
+          outcome: "failed",
+          durationMs: performance.now() - started,
+          error: err instanceof Error ? `${err.name}: ${err.message}` : String(err)
+        };
+      } finally {
+        clearTimeout(timeout);
+        if ((httpFirstRead == null ? void 0 : httpFirstRead.controller) === controller) httpFirstRead = null;
+      }
+    }
+    try {
+      (_a = args.onHttpFirstOpen) == null ? void 0 : _a.call(args, event);
+    } catch {
+    }
+    if (destroyed || provider !== target) return;
+    if (asksForDiffedSync({ roomUrl, unconfirmed: target.unconfirmedUpdates.length })) {
+      target.params[initialSync.INITIAL_SYNC_PARAM] = initialSync.INITIAL_SYNC_DIFF;
+    } else {
+      delete target.params[initialSync.INITIAL_SYNC_PARAM];
+    }
+    target.connect();
+  }
   const preparing = localCopy ? localCopy.prepare({ doc, transport }).catch(() => ({ unsyncedEdits: null })).then(({ unsyncedEdits }) => {
     if (destroyed) return;
     if (unsyncedEdits && !(unsyncedEdits.inserts.isEmpty() && unsyncedEdits.deletes.isEmpty())) {