@arbidocs/react 0.5.110 → 0.5.112

package/dist/viewers/viewer-zoom.js

@@ -0,0 +1,163 @@
+import { useCallback, useEffect, useLayoutEffect, useRef } from "react";
+const MIN_ZOOM = 0.5;
+const MAX_ZOOM = 4;
+const DOUBLE_TAP_ZOOM = 2;
+const MAX_CANVAS_PIXELS = 8e6;
+const MAX_RENDER_DPR = 2;
+function clampZoom(zoom) {
+  if (!Number.isFinite(zoom)) return 1;
+  return Math.round(Math.min(MAX_ZOOM, Math.max(MIN_ZOOM, zoom)) * 100) / 100;
+}
+const ZOOM_PRESETS = [1.5, 2, 3];
+function cycleZoom(zoom) {
+  return ZOOM_PRESETS.find((preset) => preset > zoom + 0.05) ?? 1;
+}
+function doubleTapZoom(zoom) {
+  return zoom > 1.05 ? 1 : DOUBLE_TAP_ZOOM;
+}
+function zoomLabel(zoom) {
+  return `${Math.round(zoom * 100)}%`;
+}
+function pinchZoom(startZoom, startDistance, distance2) {
+  if (startDistance <= 0) return startZoom;
+  return clampZoom(startZoom * distance2 / startDistance);
+}
+function anchoredScroll(scroll, focal, oldZoom, newZoom) {
+  if (oldZoom <= 0) return scroll;
+  return (scroll + focal) * newZoom / oldZoom - focal;
+}
+function renderDpr(cssWidth, cssHeight, devicePixelRatio, maxPixels = MAX_CANVAS_PIXELS) {
+  const wanted = Math.min(Math.max(devicePixelRatio || 1, 1), MAX_RENDER_DPR);
+  const area = cssWidth * cssHeight;
+  if (area <= 0) return wanted;
+  const fits = Math.sqrt(maxPixels / area);
+  return Math.max(1, Math.min(wanted, fits));
+}
+function fitPageWidth(contentWidth, pageBorder) {
+  if (!Number.isFinite(contentWidth)) return 0;
+  return Math.max(0, Math.floor(contentWidth) - pageBorder);
+}
+function contentBoxWidth(el) {
+  const style = getComputedStyle(el);
+  const padding = (parseFloat(style.paddingLeft) || 0) + (parseFloat(style.paddingRight) || 0);
+  return Math.max(0, el.clientWidth - padding);
+}
+const distance = (a, b) => Math.hypot(a.clientX - b.clientX, a.clientY - b.clientY);
+const INTERACTIVE = 'button, a, input, textarea, select, [role="button"]';
+const DOUBLE_TAP_MS = 300;
+const DOUBLE_TAP_SLOP_PX = 30;
+function usePinchZoom({ containerRef, zoom, onZoomChange }) {
+  const zoomRef = useRef(zoom);
+  const onChangeRef = useRef(onZoomChange);
+  onChangeRef.current = onZoomChange;
+  const focalRef = useRef(null);
+  const appliedZoomRef = useRef(zoom);
+  const request = useCallback((next, focal) => {
+    const clamped = clampZoom(next);
+    if (clamped === zoomRef.current) return;
+    focalRef.current = focal;
+    zoomRef.current = clamped;
+    onChangeRef.current?.(clamped);
+  }, []);
+  useLayoutEffect(() => {
+    zoomRef.current = zoom;
+    const container = containerRef.current;
+    const previous = appliedZoomRef.current;
+    appliedZoomRef.current = zoom;
+    if (!container || previous === zoom) return;
+    const rect = container.getBoundingClientRect();
+    const focal = focalRef.current ?? { x: rect.width / 2, y: rect.height / 2 };
+    focalRef.current = null;
+    container.dataset.zooming = "true";
+    container.scrollLeft = anchoredScroll(container.scrollLeft, focal.x, previous, zoom);
+    container.scrollTop = anchoredScroll(container.scrollTop, focal.y, previous, zoom);
+    requestAnimationFrame(
+      () => requestAnimationFrame(() => {
+        delete container.dataset.zooming;
+      })
+    );
+  }, [zoom, containerRef]);
+  useEffect(() => {
+    const el = containerRef.current;
+    if (!el) return;
+    let pinch = null;
+    let lastTap = null;
+    let frame = 0;
+    let pending = null;
+    const focalOf = (a, b) => {
+      const rect = el.getBoundingClientRect();
+      return {
+        x: (a.clientX + b.clientX) / 2 - rect.left,
+        y: (a.clientY + b.clientY) / 2 - rect.top
+      };
+    };
+    const flush = () => {
+      frame = 0;
+      if (pending) request(pending.zoom, pending.focal);
+      pending = null;
+    };
+    const onStart = (e) => {
+      if (e.touches.length === 2) {
+        pinch = { startDistance: distance(e.touches[0], e.touches[1]), startZoom: zoomRef.current };
+        lastTap = null;
+      }
+    };
+    const onMove = (e) => {
+      if (!pinch || e.touches.length !== 2) return;
+      e.preventDefault();
+      pending = {
+        zoom: pinchZoom(pinch.startZoom, pinch.startDistance, distance(e.touches[0], e.touches[1])),
+        focal: focalOf(e.touches[0], e.touches[1])
+      };
+      if (!frame) frame = requestAnimationFrame(flush);
+    };
+    const onEnd = (e) => {
+      if (pinch && e.touches.length < 2) {
+        pinch = null;
+        return;
+      }
+      if (e.touches.length !== 0 || e.changedTouches.length !== 1) return;
+      const t = e.changedTouches[0];
+      if (e.target?.closest?.(INTERACTIVE)) return;
+      const now = e.timeStamp;
+      if (lastTap && now - lastTap.time < DOUBLE_TAP_MS && Math.hypot(t.clientX - lastTap.x, t.clientY - lastTap.y) < DOUBLE_TAP_SLOP_PX) {
+        e.preventDefault();
+        const rect = el.getBoundingClientRect();
+        request(doubleTapZoom(zoomRef.current), {
+          x: t.clientX - rect.left,
+          y: t.clientY - rect.top
+        });
+        lastTap = null;
+      } else {
+        lastTap = { time: now, x: t.clientX, y: t.clientY };
+      }
+    };
+    el.addEventListener("touchstart", onStart, { passive: true });
+    el.addEventListener("touchmove", onMove, { passive: false });
+    el.addEventListener("touchend", onEnd, { passive: false });
+    el.addEventListener("touchcancel", onEnd, { passive: false });
+    return () => {
+      el.removeEventListener("touchstart", onStart);
+      el.removeEventListener("touchmove", onMove);
+      el.removeEventListener("touchend", onEnd);
+      el.removeEventListener("touchcancel", onEnd);
+      if (frame) cancelAnimationFrame(frame);
+    };
+  }, [containerRef, request]);
+}
+export {
+  MAX_CANVAS_PIXELS,
+  MAX_ZOOM,
+  MIN_ZOOM,
+  anchoredScroll,
+  clampZoom,
+  contentBoxWidth,
+  cycleZoom,
+  doubleTapZoom,
+  fitPageWidth,
+  pinchZoom,
+  renderDpr,
+  usePinchZoom,
+  zoomLabel
+};
+//# sourceMappingURL=viewer-zoom.js.map

package/dist/viewers/viewer-zoom.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/viewers/viewer-zoom.ts"],
+  "sourcesContent": ["/**\n * Zoom for page-stacked viewers (PDF + parsed/HTML).\n *\n * Browser pinch-zoom only magnifies the bitmap the page already painted: a PDF canvas rendered at\n * fit-width stays blurry however far you pinch. The viewers therefore own the zoom: `zoom` is a\n * multiplier of the fit-width size (1 = fit width, 2 = twice as wide). The PDF viewer re-renders\n * its canvases at the new scale; the parsed viewer reflows its text. This module holds the pure\n * math and the touch gesture hook (pinch, double-tap) both use.\n */\n\nimport { useCallback, useEffect, useLayoutEffect, useRef } from 'react'\nimport type { RefObject } from 'react'\n\nexport const MIN_ZOOM = 0.5\nexport const MAX_ZOOM = 4\nconst DOUBLE_TAP_ZOOM = 2\n/** Canvas pixel budget per page: iOS Safari fails above ~16.7M pixels in total, so stay well under. */\nexport const MAX_CANVAS_PIXELS = 8_000_000\n/** Device pixel ratio is capped: beyond 2x the extra sharpness is invisible and costs 2-3x memory. */\nconst MAX_RENDER_DPR = 2\n\nexport function clampZoom(zoom: number): number {\n  if (!Number.isFinite(zoom)) return 1\n  return Math.round(Math.min(MAX_ZOOM, Math.max(MIN_ZOOM, zoom)) * 100) / 100\n}\n\n/** The zoom levels the single zoom button steps through before it returns to fit width. */\nconst ZOOM_PRESETS = [1.5, 2, 3]\n\n/** The zoom button: the next preset above the current zoom, or back to fit width after the last. */\nexport function cycleZoom(zoom: number): number {\n  return ZOOM_PRESETS.find((preset) => preset > zoom + 0.05) ?? 1\n}\n\n/** Double-tap toggles between fit width and a comfortable reading zoom. */\nexport function doubleTapZoom(zoom: number): number {\n  return zoom > 1.05 ? 1 : DOUBLE_TAP_ZOOM\n}\n\nexport function zoomLabel(zoom: number): string {\n  return `${Math.round(zoom * 100)}%`\n}\n\n/** The zoom a pinch has reached: the start zoom scaled by how far the fingers moved apart. */\nexport function pinchZoom(startZoom: number, startDistance: number, distance: number): number {\n  if (startDistance <= 0) return startZoom\n  return clampZoom((startZoom * distance) / startDistance)\n}\n\n/**\n * New scroll offset that keeps the content point under `focal` (a viewport coordinate) still while\n * the zoom changes from `oldZoom` to `newZoom`.\n */\nexport function anchoredScroll(\n  scroll: number,\n  focal: number,\n  oldZoom: number,\n  newZoom: number\n): number {\n  if (oldZoom <= 0) return scroll\n  return ((scroll + focal) * newZoom) / oldZoom - focal\n}\n\n/**\n * Device pixel ratio to rasterise a page of `cssWidth` x `cssHeight` at: the device's own, capped,\n * and lowered further when the page would otherwise exceed the canvas pixel budget.\n */\nexport function renderDpr(\n  cssWidth: number,\n  cssHeight: number,\n  devicePixelRatio: number,\n  maxPixels: number = MAX_CANVAS_PIXELS\n): number {\n  const wanted = Math.min(Math.max(devicePixelRatio || 1, 1), MAX_RENDER_DPR)\n  const area = cssWidth * cssHeight\n  if (area <= 0) return wanted\n  const fits = Math.sqrt(maxPixels / area)\n  return Math.max(1, Math.min(wanted, fits))\n}\n\n/**\n * Width a fit-width page's content gets in a scroller whose content box is `contentWidth` wide:\n * that box less the page's own border, floored so sub-pixel layout never rounds the page up past\n * the box into a sideways overflow.\n */\nexport function fitPageWidth(contentWidth: number, pageBorder: number): number {\n  if (!Number.isFinite(contentWidth)) return 0\n  return Math.max(0, Math.floor(contentWidth) - pageBorder)\n}\n\n/**\n * An element's content-box width: `clientWidth` (which, unlike `offsetWidth`, leaves out the\n * vertical scrollbar and the borders) less the horizontal padding.\n */\nexport function contentBoxWidth(el: HTMLElement): number {\n  const style = getComputedStyle(el)\n  const padding = (parseFloat(style.paddingLeft) || 0) + (parseFloat(style.paddingRight) || 0)\n  return Math.max(0, el.clientWidth - padding)\n}\n\nconst distance = (a: Touch, b: Touch) => Math.hypot(a.clientX - b.clientX, a.clientY - b.clientY)\nconst INTERACTIVE = 'button, a, input, textarea, select, [role=\"button\"]'\nconst DOUBLE_TAP_MS = 300\nconst DOUBLE_TAP_SLOP_PX = 30\n\ninterface PinchZoomOptions {\n  containerRef: RefObject<HTMLElement | null>\n  zoom: number\n  onZoomChange?: (zoom: number) => void\n}\n\n/**\n * Pinch and double-tap zoom on a scroller, plus focal-point preservation for EVERY zoom change\n * (gesture, buttons, props): after the new zoom has laid out, the scroll offset is moved so the\n * content under the pinch centre (or the viewport centre) stays where it was.\n *\n * The scroller must carry `touch-action: pan-x pan-y` so the browser leaves two-finger gestures\n * to this hook instead of zooming the whole app.\n */\nexport function usePinchZoom({ containerRef, zoom, onZoomChange }: PinchZoomOptions): void {\n  const zoomRef = useRef(zoom)\n  const onChangeRef = useRef(onZoomChange)\n  onChangeRef.current = onZoomChange\n  const focalRef = useRef<{ x: number; y: number } | null>(null)\n  const appliedZoomRef = useRef(zoom)\n\n  const request = useCallback((next: number, focal: { x: number; y: number } | null) => {\n    const clamped = clampZoom(next)\n    if (clamped === zoomRef.current) return\n    focalRef.current = focal\n    zoomRef.current = clamped\n    onChangeRef.current?.(clamped)\n  }, [])\n\n  // Zoom changed (from here or from outside): keep the focal point still once it has laid out.\n  useLayoutEffect(() => {\n    zoomRef.current = zoom\n    const container = containerRef.current\n    const previous = appliedZoomRef.current\n    appliedZoomRef.current = zoom\n    if (!container || previous === zoom) return\n    const rect = container.getBoundingClientRect()\n    const focal = focalRef.current ?? { x: rect.width / 2, y: rect.height / 2 }\n    focalRef.current = null\n    // The page-anchoring observer must not also react to this resize.\n    container.dataset.zooming = 'true'\n    container.scrollLeft = anchoredScroll(container.scrollLeft, focal.x, previous, zoom)\n    container.scrollTop = anchoredScroll(container.scrollTop, focal.y, previous, zoom)\n    requestAnimationFrame(() =>\n      requestAnimationFrame(() => {\n        delete container.dataset.zooming\n      })\n    )\n  }, [zoom, containerRef])\n\n  useEffect(() => {\n    const el = containerRef.current\n    if (!el) return\n    let pinch: { startDistance: number; startZoom: number } | null = null\n    let lastTap: { time: number; x: number; y: number } | null = null\n    let frame = 0\n    let pending: { zoom: number; focal: { x: number; y: number } } | null = null\n\n    const focalOf = (a: Touch, b: Touch) => {\n      const rect = el.getBoundingClientRect()\n      return {\n        x: (a.clientX + b.clientX) / 2 - rect.left,\n        y: (a.clientY + b.clientY) / 2 - rect.top,\n      }\n    }\n    const flush = () => {\n      frame = 0\n      if (pending) request(pending.zoom, pending.focal)\n      pending = null\n    }\n\n    const onStart = (e: TouchEvent) => {\n      if (e.touches.length === 2) {\n        pinch = { startDistance: distance(e.touches[0], e.touches[1]), startZoom: zoomRef.current }\n        lastTap = null\n      }\n    }\n    const onMove = (e: TouchEvent) => {\n      if (!pinch || e.touches.length !== 2) return\n      e.preventDefault()\n      pending = {\n        zoom: pinchZoom(pinch.startZoom, pinch.startDistance, distance(e.touches[0], e.touches[1])),\n        focal: focalOf(e.touches[0], e.touches[1]),\n      }\n      if (!frame) frame = requestAnimationFrame(flush)\n    }\n    const onEnd = (e: TouchEvent) => {\n      if (pinch && e.touches.length < 2) {\n        pinch = null\n        return\n      }\n      if (e.touches.length !== 0 || e.changedTouches.length !== 1) return\n      const t = e.changedTouches[0]\n      if ((e.target as Element | null)?.closest?.(INTERACTIVE)) return\n      const now = e.timeStamp\n      if (\n        lastTap &&\n        now - lastTap.time < DOUBLE_TAP_MS &&\n        Math.hypot(t.clientX - lastTap.x, t.clientY - lastTap.y) < DOUBLE_TAP_SLOP_PX\n      ) {\n        e.preventDefault()\n        const rect = el.getBoundingClientRect()\n        request(doubleTapZoom(zoomRef.current), {\n          x: t.clientX - rect.left,\n          y: t.clientY - rect.top,\n        })\n        lastTap = null\n      } else {\n        lastTap = { time: now, x: t.clientX, y: t.clientY }\n      }\n    }\n\n    el.addEventListener('touchstart', onStart, { passive: true })\n    el.addEventListener('touchmove', onMove, { passive: false })\n    el.addEventListener('touchend', onEnd, { passive: false })\n    el.addEventListener('touchcancel', onEnd, { passive: false })\n    return () => {\n      el.removeEventListener('touchstart', onStart)\n      el.removeEventListener('touchmove', onMove)\n      el.removeEventListener('touchend', onEnd)\n      el.removeEventListener('touchcancel', onEnd)\n      if (frame) cancelAnimationFrame(frame)\n    }\n  }, [containerRef, request])\n}\n"],
+  "mappings": "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",
+  "names": ["distance"]
+}

package/dist/websocket/ArbiWebSocketProvider.js

@@ -0,0 +1,207 @@
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+import { connectWithReconnect } from "@arbidocs/sdk/browser";
+import {
+  isMessageType,
+  logger
+} from "@arbidocs/client";
+import { useArbi } from "../useArbi.js";
+import { finishEntityExtraction } from "../entity-extraction.js";
+import { useArbiWsStore } from "./store.js";
+import { nextReconnectDelay, resolveSocketBaseUrl } from "./reconnect.js";
+import { applyLiveUpdate } from "./live-updates.js";
+import { applyRunFinished } from "../chat/run-finished.js";
+import { useArbiSessionStore } from "../session/session-hooks.js";
+import { applyChatEvent } from "../directmessages/chat-cache.js";
+import { applyCallEvent } from "../calls/events.js";
+import { applyNotificationRow, isNotificationRow } from "../notifications/live.js";
+import { applyTaskEvent } from "../documents/processing-live.js";
+import { refreshDocuments } from "../documents/documents-data.js";
+import { arbiQueryKeys } from "../query-keys.js";
+import { useFeature } from "../host/features.js";
+import { useOnlineSync } from "../connectivity.js";
+import { useArbiHost } from "../host/config.js";
+import { ArbiWsContext } from "./context.js";
+function signedInId(arbi) {
+  return arbi.isLoggedIn ? arbi.user.identity()?.externalId ?? null : null;
+}
+const EVICTED_CLOSE_CODE = 1008;
+function ArbiWebSocketProvider({
+  enabled = true,
+  onAuthenticated,
+  handlers,
+  children
+}) {
+  const arbi = useArbi();
+  const arbiRef = useRef(arbi);
+  arbiRef.current = arbi;
+  const queryClient = useQueryClient();
+  const subscribersRef = useRef(/* @__PURE__ */ new Set());
+  const setStatus = useArbiWsStore((s) => s.setStatus);
+  const applyTaskUpdate = useArbiWsStore((s) => s.applyTaskUpdate);
+  const applyPresence = useArbiWsStore((s) => s.applyPresence);
+  const reset = useArbiWsStore((s) => s.reset);
+  const setEvicted = useArbiWsStore((s) => s.setEvicted);
+  const onAuthenticatedRef = useRef(onAuthenticated);
+  onAuthenticatedRef.current = onAuthenticated;
+  const handlersRef = useRef(handlers);
+  handlersRef.current = handlers;
+  const session = useArbiSessionStore();
+  const sessionRef = useRef(session);
+  sessionRef.current = session;
+  const host = useArbiHost();
+  const hostRef = useRef(host);
+  hostRef.current = host;
+  const acceptRings = useFeature("calls");
+  const acceptRingsRef = useRef(acceptRings);
+  acceptRingsRef.current = acceptRings;
+  useOnlineSync();
+  const context = useMemo(
+    () => ({
+      subscribe: (fn) => {
+        subscribersRef.current.add(fn);
+        return () => {
+          subscribersRef.current.delete(fn);
+        };
+      }
+    }),
+    []
+  );
+  useEffect(() => {
+    if (!enabled) {
+      reset();
+      return;
+    }
+    let conn = null;
+    let cancelled = false;
+    let evicted = false;
+    const me = () => signedInId(arbiRef.current);
+    const onMessage = (msg) => {
+      const type = msg.type;
+      if (type === "connection_closed") {
+        evicted = true;
+        setEvicted(true);
+      } else if (isMessageType(msg, "task_update")) {
+        if (applyTaskUpdate(msg)) applyTaskEvent(queryClient, arbiRef.current, msg, me());
+      } else if (isMessageType(msg, "presence_update")) applyPresence(msg);
+      else if (isMessageType(msg, "response_complete"))
+        applyRunFinished(
+          queryClient,
+          arbiRef.current,
+          sessionRef.current,
+          msg,
+          (quota) => hostRef.current.chat?.onQuotaExceeded?.(quota)
+        );
+      else if (type === "error")
+        logger.error("[WebSocket] Server error:", msg.message);
+      else if (isMessageType(msg, "batch_complete")) {
+        if (msg.batch_type === "entity_extract") {
+          finishEntityExtraction(msg.doc_ext_ids ?? []);
+          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allFacts() });
+        }
+        if (msg.batch_type === "upload" || msg.batch_type === "entity_extract") {
+          if (msg.doc_ext_ids?.length)
+            void refreshDocuments(queryClient, arbiRef.current, msg.doc_ext_ids);
+          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allTags() });
+        }
+      } else if (type.startsWith("chat.") || type === "agent_dm_status")
+        void applyChatEvent(arbiRef.current, queryClient, msg);
+      else if (type.startsWith("call."))
+        applyCallEvent(queryClient, msg, { me: me(), acceptRings: acceptRingsRef.current });
+      else if (isNotificationRow(msg)) applyNotificationRow(queryClient, msg, me());
+      else void applyLiveUpdate(queryClient, msg);
+      try {
+        handlersRef.current?.[type]?.(msg);
+      } catch (error) {
+        logger.error(`[WebSocket] The host's ${type} handler failed:`, error);
+      }
+      for (const fn of subscribersRef.current) {
+        try {
+          fn(msg);
+        } catch {
+        }
+      }
+    };
+    let retryTimer = null;
+    let attempt = 0;
+    const scheduleRestart = () => {
+      if (cancelled || evicted || retryTimer) return;
+      setStatus("disconnected");
+      const delay = nextReconnectDelay(attempt);
+      attempt += 1;
+      retryTimer = setTimeout(() => {
+        retryTimer = null;
+        void start();
+      }, delay);
+    };
+    const start = async () => {
+      if (cancelled) return;
+      const info = arbiRef.current.getConnectionInfo();
+      if (!info) {
+        scheduleRestart();
+        return;
+      }
+      conn?.close();
+      conn = null;
+      setStatus("connecting");
+      try {
+        const c = await connectWithReconnect({
+          baseUrl: resolveSocketBaseUrl(
+            info.baseUrl,
+            typeof window === "undefined" ? void 0 : window.location.origin
+          ),
+          accessToken: info.accessToken,
+          // Resolve the freshest token on every (re)connect so rotation is picked up.
+          getAccessToken: () => arbiRef.current.getConnectionInfo()?.accessToken ?? null,
+          // A reconnect refused for its token re-logs in silently first.
+          refreshAuth: () => arbiRef.current.refreshAccess(),
+          onAuthenticated: (message) => onAuthenticatedRef.current?.(message),
+          // The session's: a sign-out closes the socket before the server revokes the token.
+          signal: info.signal,
+          onMessage,
+          onReconnecting: () => setStatus("reconnecting"),
+          onReconnected: () => {
+            attempt = 0;
+            setStatus("connected");
+          },
+          // Evicted (a newer session of the same user, or the server took this connection over for a
+          // newer one of this session): reconnecting would be evicted again, or evict that one.
+          shouldReconnect: (code) => {
+            if (code !== EVICTED_CLOSE_CODE && !evicted) return true;
+            evicted = true;
+            setEvicted(true);
+            setStatus("disconnected");
+            return false;
+          },
+          onReconnectFailed: scheduleRestart,
+          onClose: () => {
+            if (!cancelled) setStatus(evicted ? "disconnected" : "reconnecting");
+          }
+        });
+        if (cancelled) {
+          c.close();
+          return;
+        }
+        conn = c;
+        attempt = 0;
+        setStatus("connected");
+      } catch {
+        if (!info.signal.aborted) scheduleRestart();
+      }
+    };
+    setEvicted(false);
+    void start();
+    return () => {
+      cancelled = true;
+      if (retryTimer) clearTimeout(retryTimer);
+      conn?.close();
+      reset();
+    };
+  }, [enabled, queryClient, setStatus, setEvicted, applyTaskUpdate, applyPresence, reset]);
+  return /* @__PURE__ */ jsx(ArbiWsContext.Provider, { value: context, children });
+}
+export {
+  ArbiWebSocketProvider
+};
+//# sourceMappingURL=ArbiWebSocketProvider.js.map

package/dist/websocket/ArbiWebSocketProvider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/ArbiWebSocketProvider.tsx"],
+  "sourcesContent": ["/**\n * ArbiWebSocketProvider \u2014 one shared, reconnecting WebSocket for the whole app.\n *\n * Opens a single authenticated socket (via the SDK transport's\n * `connectWithReconnect`, which handles auth, backoff, and live-token refresh),\n * feeds the canonical WS store, applies what every site applies (tasks, presence,\n * chats, calls, notification rows, finished runs, conversation, mail-draft and skill\n * events), then hands each message to the host's own `handlers` for its type and\n * fans it out to subscribers registered by the `useArbiWebSocket` /\n * `useArbiWsMessage` hooks.\n *\n * Mount it inside an `<ArbiHost>` with an `arbi` (it reads the Arbi instance for the base\n * URL + live access token). Gate it with `enabled` so it connects only once the\n * app is authenticated against a live backend.\n */\n\nimport { useEffect, useMemo, useRef, type ReactNode } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { connectWithReconnect, type ReconnectableWsConnection } from '@arbidocs/sdk/browser'\nimport {\n  isMessageType,\n  type WebSocketServerMessage,\n  type WsTaskUpdateMessage,\n  type WsBatchCompleteMessage,\n  type WsPresenceUpdateMessage,\n  type WsAuthResultMessage,\n  type WsResponseCompleteMessage,\n  logger,\n} from '@arbidocs/client'\nimport { useArbi } from '../useArbi'\nimport { finishEntityExtraction } from '../entity-extraction'\nimport { useArbiWsStore } from './store'\nimport { nextReconnectDelay, resolveSocketBaseUrl } from './reconnect'\nimport { applyLiveUpdate } from './live-updates'\nimport { applyRunFinished } from '../chat/run-finished'\nimport { useArbiSessionStore } from '../session/session-hooks'\nimport { applyChatEvent } from '../directmessages/chat-cache'\nimport { applyCallEvent } from '../calls/events'\nimport { applyNotificationRow, isNotificationRow } from '../notifications/live'\nimport { applyTaskEvent } from '../documents/processing-live'\nimport { refreshDocuments } from '../documents/documents-data'\nimport { arbiQueryKeys } from '../query-keys'\nimport { useFeature } from '../host/features'\nimport { useOnlineSync } from '../connectivity'\nimport { useArbiHost } from '../host/config'\nimport { ArbiWsContext, type ArbiWsContextValue, type ArbiWsSubscriber } from './context'\n\n/** A host's own handling of server messages, by message type (e.g. `remote_control`). */\nexport type ArbiWsHandlers = Partial<Record<string, (message: WebSocketServerMessage) => void>>\n\nexport interface ArbiWebSocketProviderProps {\n  /**\n   * Open the socket only when the app is authenticated against a live backend.\n   * Defaults to `true`; pass the connection status so demo/logged-out sessions\n   * don't try to connect.\n   */\n  enabled?: boolean\n  /** Called each time the server accepts the socket's auth (e.g. to show the unread count). */\n  onAuthenticated?: (message: WsAuthResultMessage) => void\n  /**\n   * The host's own handling of message types the provider does not apply (e.g. `remote_control`),\n   * each called after the provider's own and before the subscribers. Read on each message, so a\n   * new object never reopens the socket.\n   */\n  handlers?: ArbiWsHandlers\n  children: ReactNode\n}\n\n/** The signed-in person's id on `arbi`, or null when nobody is signed in. */\nfunction signedInId(arbi: ReturnType<typeof useArbi>): string | null {\n  return arbi.isLoggedIn ? (arbi.user.identity()?.externalId ?? null) : null\n}\n\n/** The close code of a server-side single-session eviction (a newer session of the same user). */\nconst EVICTED_CLOSE_CODE = 1008\n\nexport function ArbiWebSocketProvider({\n  enabled = true,\n  onAuthenticated,\n  handlers,\n  children,\n}: ArbiWebSocketProviderProps) {\n  // The latest `Arbi`, read on each use: a host renews its instance (another server session, an\n  // opened workspace) without that reopening the socket; the token is read afresh on each connect.\n  const arbi = useArbi()\n  const arbiRef = useRef(arbi)\n  arbiRef.current = arbi\n  const queryClient = useQueryClient()\n  const subscribersRef = useRef<Set<ArbiWsSubscriber>>(new Set())\n  const setStatus = useArbiWsStore((s) => s.setStatus)\n  const applyTaskUpdate = useArbiWsStore((s) => s.applyTaskUpdate)\n  const applyPresence = useArbiWsStore((s) => s.applyPresence)\n  const reset = useArbiWsStore((s) => s.reset)\n  const setEvicted = useArbiWsStore((s) => s.setEvicted)\n  const onAuthenticatedRef = useRef(onAuthenticated)\n  onAuthenticatedRef.current = onAuthenticated\n  const handlersRef = useRef(handlers)\n  handlersRef.current = handlers\n  const session = useArbiSessionStore()\n  const sessionRef = useRef(session)\n  sessionRef.current = session\n  const host = useArbiHost()\n  const hostRef = useRef(host)\n  hostRef.current = host\n  // Calls ring only a person whose `calls` feature is on (ARBI: Settings \u2192 Experimental); unlisted, on.\n  const acceptRings = useFeature('calls')\n  const acceptRingsRef = useRef(acceptRings)\n  acceptRingsRef.current = acceptRings\n  // Online or not follows this connection too (and the network, and \"Work offline\").\n  useOnlineSync()\n\n  // Stable subscribe API \u2014 the subscriber set lives in a ref, so registering a\n  // handler never re-opens the socket.\n  const context = useMemo<ArbiWsContextValue>(\n    () => ({\n      subscribe: (fn) => {\n        subscribersRef.current.add(fn)\n        return () => {\n          subscribersRef.current.delete(fn)\n        }\n      },\n    }),\n    []\n  )\n\n  useEffect(() => {\n    if (!enabled) {\n      reset()\n      return\n    }\n\n    let conn: ReconnectableWsConnection | null = null\n    let cancelled = false\n    // Taken over by another connection of this session (the server says so, then closes):\n    // reconnecting would take it back, and the two would evict each other in turn.\n    let evicted = false\n\n    const me = () => signedInId(arbiRef.current)\n\n    // What every site applies, before the host's own subscribers hear the message.\n    const onMessage = (msg: WebSocketServerMessage) => {\n      const type = msg.type as string\n      if (type === 'connection_closed') {\n        evicted = true\n        setEvicted(true)\n      } else if (isMessageType<WsTaskUpdateMessage>(msg, 'task_update')) {\n        // The live processing row, then the documents list (an upload's row, a finished re-read).\n        if (applyTaskUpdate(msg)) applyTaskEvent(queryClient, arbiRef.current, msg, me())\n      } else if (isMessageType<WsPresenceUpdateMessage>(msg, 'presence_update')) applyPresence(msg)\n      else if (isMessageType<WsResponseCompleteMessage>(msg, 'response_complete'))\n        // A run finished: its conversation stops generating, its follow-up leaves the queue, the\n        // documents it saved are read again, the thread follows, and a run failed for the AI usage\n        // says so the chat host's way.\n        applyRunFinished(queryClient, arbiRef.current, sessionRef.current, msg, (quota) =>\n          hostRef.current.chat?.onQuotaExceeded?.(quota)\n        )\n      else if (type === 'error')\n        logger.error('[WebSocket] Server error:', (msg as { message?: unknown }).message)\n      else if (isMessageType<WsBatchCompleteMessage>(msg, 'batch_complete')) {\n        // An upload or an extraction finished: its documents are read again, and the tags (an\n        // upload may create sender labels; an extraction creates people and organisations and\n        // links facts). AI fields (`doctag_generate`) are the AI review's (blocks).\n        if (msg.batch_type === 'entity_extract') {\n          finishEntityExtraction(msg.doc_ext_ids ?? [])\n          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allFacts() })\n        }\n        if (msg.batch_type === 'upload' || msg.batch_type === 'entity_extract') {\n          if (msg.doc_ext_ids?.length)\n            void refreshDocuments(queryClient, arbiRef.current, msg.doc_ext_ids)\n          void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.allTags() })\n        }\n      } else if (type.startsWith('chat.') || type === 'agent_dm_status')\n        // Chats (direct messages, agent DM progress).\n        void applyChatEvent(arbiRef.current, queryClient, msg)\n      else if (type.startsWith('call.'))\n        applyCallEvent(queryClient, msg, { me: me(), acceptRings: acceptRingsRef.current })\n      else if (isNotificationRow(msg)) applyNotificationRow(queryClient, msg, me())\n      // Conversation, mail-draft and skill events.\n      else void applyLiveUpdate(queryClient, msg as unknown as { type: string })\n\n      // The host's own handler for this type, then the subscribers. A throwing handler must not\n      // kill the stream.\n      try {\n        handlersRef.current?.[type]?.(msg)\n      } catch (error) {\n        logger.error(`[WebSocket] The host's ${type} handler failed:`, error)\n      }\n      for (const fn of subscribersRef.current) {\n        try {\n          fn(msg)\n        } catch {\n          /* swallow \u2014 one bad handler can't break the socket */\n        }\n      }\n    }\n\n    let retryTimer: ReturnType<typeof setTimeout> | null = null\n    let attempt = 0\n\n    // The socket is best-effort and never gives up: after the transport's own retries (or a failed\n    // connect) a fresh one is opened after a capped backoff, offline meanwhile. It never ends the\n    // session; that is the HTTP layer's job.\n    const scheduleRestart = () => {\n      if (cancelled || evicted || retryTimer) return\n      setStatus('disconnected')\n      const delay = nextReconnectDelay(attempt)\n      attempt += 1\n      retryTimer = setTimeout(() => {\n        retryTimer = null\n        void start()\n      }, delay)\n    }\n\n    const start = async () => {\n      if (cancelled) return\n      const info = arbiRef.current.getConnectionInfo()\n      if (!info) {\n        // Not signed in on this client yet: try again shortly.\n        scheduleRestart()\n        return\n      }\n      conn?.close()\n      conn = null\n      setStatus('connecting')\n      try {\n        const c = await connectWithReconnect({\n          baseUrl: resolveSocketBaseUrl(\n            info.baseUrl,\n            typeof window === 'undefined' ? undefined : window.location.origin\n          ),\n          accessToken: info.accessToken,\n          // Resolve the freshest token on every (re)connect so rotation is picked up.\n          getAccessToken: () => arbiRef.current.getConnectionInfo()?.accessToken ?? null,\n          // A reconnect refused for its token re-logs in silently first.\n          refreshAuth: () => arbiRef.current.refreshAccess(),\n          onAuthenticated: (message) => onAuthenticatedRef.current?.(message),\n          // The session's: a sign-out closes the socket before the server revokes the token.\n          signal: info.signal,\n          onMessage,\n          onReconnecting: () => setStatus('reconnecting'),\n          onReconnected: () => {\n            attempt = 0\n            setStatus('connected')\n          },\n          // Evicted (a newer session of the same user, or the server took this connection over for a\n          // newer one of this session): reconnecting would be evicted again, or evict that one.\n          shouldReconnect: (code) => {\n            if (code !== EVICTED_CLOSE_CODE && !evicted) return true\n            evicted = true\n            setEvicted(true)\n            setStatus('disconnected')\n            return false\n          },\n          onReconnectFailed: scheduleRestart,\n          onClose: () => {\n            if (!cancelled) setStatus(evicted ? 'disconnected' : 'reconnecting')\n          },\n        })\n        if (cancelled) {\n          c.close()\n          return\n        }\n        conn = c\n        attempt = 0\n        setStatus('connected')\n      } catch {\n        // Stopped by a sign-out: the session is gone, nothing to reopen.\n        if (!info.signal.aborted) scheduleRestart()\n      }\n    }\n    setEvicted(false)\n    void start()\n\n    return () => {\n      cancelled = true\n      if (retryTimer) clearTimeout(retryTimer)\n      conn?.close()\n      reset()\n    }\n  }, [enabled, queryClient, setStatus, setEvicted, applyTaskUpdate, applyPresence, reset])\n\n  return <ArbiWsContext.Provider value={context}>{children}</ArbiWsContext.Provider>\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/websocket/context.js

@@ -0,0 +1,14 @@
+import { createContext, useContext } from "react";
+const ArbiWsContext = createContext(null);
+function useArbiWsContext() {
+  const ctx = useContext(ArbiWsContext);
+  if (!ctx) {
+    throw new Error("useArbiWebSocket hooks must be used within an <ArbiWebSocketProvider>");
+  }
+  return ctx;
+}
+export {
+  ArbiWsContext,
+  useArbiWsContext
+};
+//# sourceMappingURL=context.js.map

package/dist/websocket/context.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/context.ts"],
+  "sourcesContent": ["/**\n * Context for the shared WebSocket \u2014 the subscribe registry the provider fills\n * and the hooks read. Kept separate from the provider component so both can be\n * imported without tripping react-refresh's component-only-export rule.\n */\n\nimport { createContext, useContext } from 'react'\nimport type { WebSocketServerMessage } from '@arbidocs/client'\n\nexport type ArbiWsSubscriber = (msg: WebSocketServerMessage) => void\n\nexport interface ArbiWsContextValue {\n  subscribe: (fn: ArbiWsSubscriber) => () => void\n}\n\nexport const ArbiWsContext = createContext<ArbiWsContextValue | null>(null)\n\nexport function useArbiWsContext(): ArbiWsContextValue {\n  const ctx = useContext(ArbiWsContext)\n  if (!ctx) {\n    throw new Error('useArbiWebSocket hooks must be used within an <ArbiWebSocketProvider>')\n  }\n  return ctx\n}\n"],
+  "mappings": "AAMA,SAAS,eAAe,kBAAkB;AASnC,MAAM,gBAAgB,cAAyC,IAAI;AAEnE,SAAS,mBAAuC;AACrD,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/websocket/hooks.js

@@ -0,0 +1,30 @@
+import { useEffect, useRef } from "react";
+import { isMessageType } from "@arbidocs/client";
+import { useArbiWsContext } from "./context.js";
+import { useArbiWsStore } from "./store.js";
+function useArbiWebSocket(onMessage) {
+  const { subscribe } = useArbiWsContext();
+  const handlerRef = useRef(onMessage);
+  handlerRef.current = onMessage;
+  useEffect(() => subscribe((msg) => handlerRef.current(msg)), [subscribe]);
+}
+function useArbiWsMessage(type, handler) {
+  const { subscribe } = useArbiWsContext();
+  const handlerRef = useRef(handler);
+  handlerRef.current = handler;
+  useEffect(
+    () => subscribe((msg) => {
+      if (isMessageType(msg, type)) handlerRef.current(msg);
+    }),
+    [subscribe, type]
+  );
+}
+function useArbiWsStatus() {
+  return useArbiWsStore((s) => s.status);
+}
+export {
+  useArbiWebSocket,
+  useArbiWsMessage,
+  useArbiWsStatus
+};
+//# sourceMappingURL=hooks.js.map

package/dist/websocket/hooks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/hooks.ts"],
+  "sourcesContent": ["/**\n * Typed subscription + selector hooks for the shared WebSocket.\n *\n * All message typing flows from the OpenAPI-derived `WebSocketServerMessage`\n * union \u2014 handlers are narrowed by the discriminant `type`, exactly like the\n * rest of the SDK.\n */\n\nimport { useEffect, useRef } from 'react'\nimport { isMessageType, type WebSocketServerMessage } from '@arbidocs/client'\nimport { useArbiWsContext } from './context'\nimport { useArbiWsStore, type ArbiWsStatus } from './store'\n\n/**\n * Subscribe to every server message. The handler is kept in a ref, so passing a\n * new inline function each render does not resubscribe.\n */\nexport function useArbiWebSocket(onMessage: (msg: WebSocketServerMessage) => void): void {\n  const { subscribe } = useArbiWsContext()\n  const handlerRef = useRef(onMessage)\n  handlerRef.current = onMessage\n  useEffect(() => subscribe((msg) => handlerRef.current(msg)), [subscribe])\n}\n\n/**\n * Subscribe to a single message type, fully narrowed to that variant.\n *\n * @example\n *   useArbiWsMessage<WsBatchCompleteMessage>('batch_complete', (msg) => {\n *     // msg.batch_type, msg.doc_ext_ids are typed\n *   })\n */\nexport function useArbiWsMessage<T extends WebSocketServerMessage>(\n  type: T['type'],\n  handler: (msg: T) => void\n): void {\n  const { subscribe } = useArbiWsContext()\n  const handlerRef = useRef(handler)\n  handlerRef.current = handler\n  useEffect(\n    () =>\n      subscribe((msg) => {\n        if (isMessageType<T>(msg, type)) handlerRef.current(msg)\n      }),\n    [subscribe, type]\n  )\n}\n\n/** Live connection status of the shared socket. */\nexport function useArbiWsStatus(): ArbiWsStatus {\n  return useArbiWsStore((s) => s.status)\n}\n"],
+  "mappings": "AAQA,SAAS,WAAW,cAAc;AAClC,SAAS,qBAAkD;AAC3D,SAAS,wBAAwB;AACjC,SAAS,sBAAyC;AAM3C,SAAS,iBAAiB,WAAwD;AACvF,QAAM,EAAE,UAAU,IAAI,iBAAiB;AACvC,QAAM,aAAa,OAAO,SAAS;AACnC,aAAW,UAAU;AACrB,YAAU,MAAM,UAAU,CAAC,QAAQ,WAAW,QAAQ,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;AAC1E;AAUO,SAAS,iBACd,MACA,SACM;AACN,QAAM,EAAE,UAAU,IAAI,iBAAiB;AACvC,QAAM,aAAa,OAAO,OAAO;AACjC,aAAW,UAAU;AACrB;AAAA,IACE,MACE,UAAU,CAAC,QAAQ;AACjB,UAAI,cAAiB,KAAK,IAAI,EAAG,YAAW,QAAQ,GAAG;AAAA,IACzD,CAAC;AAAA,IACH,CAAC,WAAW,IAAI;AAAA,EAClB;AACF;AAGO,SAAS,kBAAgC;AAC9C,SAAO,eAAe,CAAC,MAAM,EAAE,MAAM;AACvC;",
+  "names": []
+}

package/dist/websocket/index.js

@@ -0,0 +1,22 @@
+import {
+  ArbiWebSocketProvider
+} from "./ArbiWebSocketProvider.js";
+import { useArbiWsContext } from "./context.js";
+import { useArbiWebSocket, useArbiWsMessage, useArbiWsStatus } from "./hooks.js";
+import { applyLiveUpdate, LIVE_UPDATE_TYPES } from "./live-updates.js";
+import {
+  useArbiWsStore,
+  DISMISSED_TASK_TTL_MS
+} from "./store.js";
+export {
+  ArbiWebSocketProvider,
+  DISMISSED_TASK_TTL_MS,
+  LIVE_UPDATE_TYPES,
+  applyLiveUpdate,
+  useArbiWebSocket,
+  useArbiWsContext,
+  useArbiWsMessage,
+  useArbiWsStatus,
+  useArbiWsStore
+};
+//# sourceMappingURL=index.js.map

package/dist/websocket/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/index.ts"],
+  "sourcesContent": ["/**\n * Shared WebSocket layer for @arbidocs/react.\n *\n * One reconnecting socket per app, a canonical WS store, typed subscription\n * hooks, and a drop-in document-sync hook that replaces polling.\n */\n\nexport {\n  ArbiWebSocketProvider,\n  type ArbiWebSocketProviderProps,\n  type ArbiWsHandlers,\n} from './ArbiWebSocketProvider'\nexport { useArbiWsContext, type ArbiWsContextValue } from './context'\nexport { useArbiWebSocket, useArbiWsMessage, useArbiWsStatus } from './hooks'\nexport { applyLiveUpdate, LIVE_UPDATE_TYPES } from './live-updates'\nexport {\n  useArbiWsStore,\n  DISMISSED_TASK_TTL_MS,\n  type ArbiWsState,\n  type ArbiWsStatus,\n  type LiveTask,\n} from './store'\n"],
+  "mappings": "AAOA;AAAA,EACE;AAAA,OAGK;AACP,SAAS,wBAAiD;AAC1D,SAAS,kBAAkB,kBAAkB,uBAAuB;AACpE,SAAS,iBAAiB,yBAAyB;AACnD;AAAA,EACE;AAAA,EACA;AAAA,OAIK;",
+  "names": []
+}

package/dist/websocket/live-updates.js

@@ -0,0 +1,38 @@
+import { applyConversationEvent } from "../chat/conversation-events.js";
+import { announceMailDraftReplaced } from "../mail/hooks.js";
+import { arbiQueryKeys, mailQueryKeys } from "../query-keys.js";
+const LIVE_UPDATE_TYPES = [
+  "conversation.message_posted",
+  "conversation.title_updated",
+  "conversation.document_binding_changed",
+  "mail.draft_replaced",
+  "skills_updated"
+];
+async function applyLiveUpdate(queryClient, message) {
+  switch (message.type) {
+    case "conversation.message_posted":
+    case "conversation.title_updated":
+    case "conversation.document_binding_changed":
+      await applyConversationEvent(queryClient, message);
+      return true;
+    case "mail.draft_replaced": {
+      const oldId = message.old_id;
+      const newId = message.new_id;
+      if (!oldId || !newId) return true;
+      void queryClient.invalidateQueries({ queryKey: mailQueryKeys.allMessages() });
+      void queryClient.invalidateQueries({ queryKey: mailQueryKeys.allFolders() });
+      announceMailDraftReplaced(oldId, newId);
+      return true;
+    }
+    case "skills_updated":
+      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.skills() });
+      return true;
+    default:
+      return false;
+  }
+}
+export {
+  LIVE_UPDATE_TYPES,
+  applyLiveUpdate
+};
+//# sourceMappingURL=live-updates.js.map

package/dist/websocket/live-updates.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/live-updates.ts"],
+  "sourcesContent": ["/**\n * The live updates every site applies from the server's WebSocket, cache side only: a message\n * somebody else posted, a generated title, a thread's document binding, a mail draft saved under a\n * new id, and a changed skill. `ArbiWebSocketProvider` applies them itself; a host with its own\n * socket routes these messages here, so there is one implementation.\n */\n\nimport type { QueryClient } from '@tanstack/react-query'\nimport { applyConversationEvent } from '../chat/conversation-events'\nimport { announceMailDraftReplaced } from '../mail/hooks'\nimport { arbiQueryKeys, mailQueryKeys } from '../query-keys'\n\n/** The message types `applyLiveUpdate` handles. */\nexport const LIVE_UPDATE_TYPES = [\n  'conversation.message_posted',\n  'conversation.title_updated',\n  'conversation.document_binding_changed',\n  'mail.draft_replaced',\n  'skills_updated',\n] as const\n\n/**\n * Apply one server message to the cache. Resolves `true` when it was one of `LIVE_UPDATE_TYPES`,\n * `false` (nothing done) for any other.\n */\nexport async function applyLiveUpdate(\n  queryClient: QueryClient,\n  message: { type: string; [field: string]: unknown }\n): Promise<boolean> {\n  switch (message.type) {\n    case 'conversation.message_posted':\n    case 'conversation.title_updated':\n    case 'conversation.document_binding_changed':\n      await applyConversationEvent(queryClient, message)\n      return true\n    case 'mail.draft_replaced': {\n      // A native draft saved again under a new id (by ARBI in a private chat, or in another tab):\n      // the Mail lists refresh and an open composer showing the old id follows it.\n      const oldId = message.old_id as string | undefined\n      const newId = message.new_id as string | undefined\n      if (!oldId || !newId) return true\n      void queryClient.invalidateQueries({ queryKey: mailQueryKeys.allMessages() })\n      void queryClient.invalidateQueries({ queryKey: mailQueryKeys.allFolders() })\n      announceMailDraftReplaced(oldId, newId)\n      return true\n    }\n    case 'skills_updated':\n      // A skill changed server-side (saved by an agent, deleted, published): the cached\n      // marketplace list is never re-read on its own.\n      void queryClient.invalidateQueries({ queryKey: arbiQueryKeys.skills() })\n      return true\n    default:\n      return false\n  }\n}\n"],
+  "mappings": "AAQA,SAAS,8BAA8B;AACvC,SAAS,iCAAiC;AAC1C,SAAS,eAAe,qBAAqB;AAGtC,MAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMA,eAAsB,gBACpB,aACA,SACkB;AAClB,UAAQ,QAAQ,MAAM;AAAA,IACpB,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,YAAM,uBAAuB,aAAa,OAAO;AACjD,aAAO;AAAA,IACT,KAAK,uBAAuB;AAG1B,YAAM,QAAQ,QAAQ;AACtB,YAAM,QAAQ,QAAQ;AACtB,UAAI,CAAC,SAAS,CAAC,MAAO,QAAO;AAC7B,WAAK,YAAY,kBAAkB,EAAE,UAAU,cAAc,YAAY,EAAE,CAAC;AAC5E,WAAK,YAAY,kBAAkB,EAAE,UAAU,cAAc,WAAW,EAAE,CAAC;AAC3E,gCAA0B,OAAO,KAAK;AACtC,aAAO;AAAA,IACT;AAAA,IACA,KAAK;AAGH,WAAK,YAAY,kBAAkB,EAAE,UAAU,cAAc,OAAO,EAAE,CAAC;AACvE,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;",
+  "names": []
+}

package/dist/websocket/reconnect.js

@@ -0,0 +1,13 @@
+const INITIAL_RECONNECT_DELAY_MS = 1e3;
+const MAX_RECONNECT_DELAY_MS = 3e4;
+function nextReconnectDelay(attempt) {
+  return Math.min(INITIAL_RECONNECT_DELAY_MS * 2 ** Math.max(0, attempt), MAX_RECONNECT_DELAY_MS);
+}
+function resolveSocketBaseUrl(configured, origin) {
+  return /^https?:\/\//.test(configured) || !origin ? configured : origin;
+}
+export {
+  nextReconnectDelay,
+  resolveSocketBaseUrl
+};
+//# sourceMappingURL=reconnect.js.map

package/dist/websocket/reconnect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/websocket/reconnect.ts"],
+  "sourcesContent": ["/** The shared socket's reconnect policy and where it opens. */\n\nconst INITIAL_RECONNECT_DELAY_MS = 1_000\nconst MAX_RECONNECT_DELAY_MS = 30_000\n\n/** Capped exponential backoff before a fresh connect after the transport gave up. */\nexport function nextReconnectDelay(attempt: number): number {\n  return Math.min(INITIAL_RECONNECT_DELAY_MS * 2 ** Math.max(0, attempt), MAX_RECONNECT_DELAY_MS)\n}\n\n/**\n * The HTTP origin to open the socket on. A same-origin deployment configures the API as `''` (or\n * a relative prefix), from which no WebSocket URL can be built: the page's origin is used then.\n */\nexport function resolveSocketBaseUrl(configured: string, origin: string | undefined): string {\n  return /^https?:\\/\\//.test(configured) || !origin ? configured : origin\n}\n"],
+  "mappings": "AAEA,MAAM,6BAA6B;AACnC,MAAM,yBAAyB;AAGxB,SAAS,mBAAmB,SAAyB;AAC1D,SAAO,KAAK,IAAI,6BAA6B,KAAK,KAAK,IAAI,GAAG,OAAO,GAAG,sBAAsB;AAChG;AAMO,SAAS,qBAAqB,YAAoB,QAAoC;AAC3F,SAAO,eAAe,KAAK,UAAU,KAAK,CAAC,SAAS,aAAa;AACnE;",
+  "names": []
+}