@athenaintel/react 0.41.3 → 0.42.1

package/dist/threads/session-list-tab-share.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list-tab-share.cjs","sources":["../../src/threads/session-list-tab-share.ts"],"sourcesContent":["/**\n * Open tabs of one signed-in user share their session-list reads.\n *\n * A pushed conversation-index change reaches every open tab at once, and each\n * one used to re-read the same lists. With this in place:\n *\n * - **Pages are shared.** Whenever a tab reads a list's first page, it posts\n *   the page on a `BroadcastChannel` named for the backend, the user and the\n *   workspace. A tab that holds the same list (same query key) and has an\n *   older copy takes it, so the new row appears there without a request.\n * - **One tab reads for the others.** Before an index-triggered refresh, a tab\n *   claims the list on the channel. The other tabs hold their own refresh for\n *   that list for {@link TAB_SHARE_CLAIM_MS}; the claimer's page normally\n *   lands well before then. If it does not (the claimer failed or closed),\n *   they refresh themselves.\n *\n * Only same-origin tabs can hear a `BroadcastChannel`, and only tabs signed in\n * as the same user to the same workspace and backend use the same channel, so\n * a page never reaches another account. Without a signed-in user, a\n * workspace, or `BroadcastChannel` (older browsers, SSR, tests), every call is\n * a no-op and each tab reads for itself, as before.\n */\nimport {\n  type ConversationListPage,\n  CONVERSATION_LIST_QUERY_KEY_ROOT,\n} from '@athenaintel/agent-runtime';\nimport type { QueryClient, QueryKey } from '@tanstack/react-query';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { keyPartFingerprint } from '../lib/use-athena-rest-query';\n\n/** How long a claim by another tab holds this tab's own refresh of that list. */\nexport const TAB_SHARE_CLAIM_MS = 5_000;\n\nconst CHANNEL_PREFIX = 'athena-sdk:session-list:';\nconst MESSAGE_VERSION = 1;\n\ntype TabShareMessage =\n  | { v: number; kind: 'page'; key: string; queryKey: QueryKey; data: ConversationListPage; updatedAt: number }\n  | { v: number; kind: 'claim'; key: string };\n\nexport interface SessionListTabShare {\n  /**\n   * Whether another tab has claimed the list with this query key and its\n   * claim still stands: when it lapses (epoch ms), or `null`.\n   */\n  claimedUntil(key: string): number | null;\n  /** Tell the other tabs this one is reading the list now. */\n  claim(key: string): void;\n}\n\nconst NO_SHARE: SessionListTabShare = {\n  claimedUntil: () => null,\n  claim: () => undefined,\n};\n\n/** A list's first-page query key, as the stable string the channel names it by. */\nexport function sessionListShareKey(queryKey: QueryKey): string {\n  return JSON.stringify(queryKey);\n}\n\nfunction isFirstPageKey(queryKey: unknown): queryKey is QueryKey {\n  return (\n    Array.isArray(queryKey) &&\n    queryKey[0] === CONVERSATION_LIST_QUERY_KEY_ROOT &&\n    queryKey[queryKey.length - 1] === 'first-page'\n  );\n}\n\nfunction isPage(value: unknown): value is ConversationListPage {\n  if (typeof value !== 'object' || value === null) return false;\n  const { items, hasMore } = value as Record<string, unknown>;\n  return Array.isArray(items) && typeof hasMore === 'boolean';\n}\n\n/** Parse a channel message, or `null` for anything this version does not send. Exported for tests. */\nexport function parseTabShareMessage(raw: unknown): TabShareMessage | null {\n  if (typeof raw !== 'object' || raw === null) return null;\n  const message = raw as Record<string, unknown>;\n  if (message.v !== MESSAGE_VERSION || typeof message.key !== 'string') return null;\n  if (message.kind === 'claim') return { v: MESSAGE_VERSION, kind: 'claim', key: message.key };\n  if (\n    message.kind === 'page' &&\n    isFirstPageKey(message.queryKey) &&\n    sessionListShareKey(message.queryKey) === message.key &&\n    isPage(message.data) &&\n    typeof message.updatedAt === 'number'\n  ) {\n    return {\n      v: MESSAGE_VERSION,\n      kind: 'page',\n      key: message.key,\n      queryKey: message.queryKey,\n      data: message.data,\n      updatedAt: message.updatedAt,\n    };\n  }\n  return null;\n}\n\n/**\n * Take a page another tab read: only into a list this tab holds, and only\n * when it is newer than this tab's copy. Returns whether it was taken.\n * Exported for tests.\n */\nexport function applySharedPage(\n  queryClient: QueryClient,\n  message: Extract<TabShareMessage, { kind: 'page' }>,\n): boolean {\n  const state = queryClient.getQueryState(message.queryKey);\n  if (!state) return false;\n  if (state.dataUpdatedAt >= message.updatedAt) return false;\n  queryClient.setQueryData(message.queryKey, message.data, { updatedAt: message.updatedAt });\n  return true;\n}\n\n/**\n * Share this provider's session-list first pages with the user's other open\n * tabs, and hear theirs. `identity` is `null` when sharing must stay off (no\n * signed-in user or workspace known yet).\n */\nexport function useSessionListTabShare({\n  queryClient,\n  identity,\n}: {\n  queryClient: QueryClient;\n  identity: { backendUrl: string; userId: string; workspaceId: string } | null;\n}): SessionListTabShare {\n  const channelName = identity\n    ? `${CHANNEL_PREFIX}${keyPartFingerprint(\n        [identity.backendUrl, identity.userId, identity.workspaceId].join('\\u0000'),\n      )}`\n    : null;\n  const claims = useMemo(() => new Map<string, number>(), [channelName]);\n  // The channel is opened by the effect that closes it, so each setup has its\n  // own (StrictMode's setup, cleanup, setup included), and `claim` posts on\n  // whichever one is open now.\n  const channelRef = useRef<BroadcastChannel | null>(null);\n  const isSupported = channelName !== null && typeof BroadcastChannel !== 'undefined';\n\n  useEffect(() => {\n    if (!channelName || typeof BroadcastChannel === 'undefined') return;\n    let channel: BroadcastChannel;\n    try {\n      channel = new BroadcastChannel(channelName);\n    } catch {\n      return;\n    }\n    channelRef.current = channel;\n    const post = (message: TabShareMessage) => {\n      try {\n        channel.postMessage(message);\n      } catch {\n        // A page that cannot be cloned or a closed channel: the other tabs read for themselves.\n      }\n    };\n    channel.onmessage = (event: MessageEvent) => {\n      const message = parseTabShareMessage(event.data);\n      if (!message) return;\n      if (message.kind === 'claim') {\n        claims.set(message.key, Date.now() + TAB_SHARE_CLAIM_MS);\n        return;\n      }\n      // The claim stands until it lapses: a tab whose rows the page still\n      // leaves out reads for itself once it does, not all of them at once.\n      applySharedPage(queryClient, message);\n    };\n    // Only a read that STARTED while this channel was open is shared on it.\n    // The channel is named for the workspace the current credential resolved\n    // to; a read started before (under the previous credential, perhaps for\n    // another workspace) may still land after the switch, and its rows must\n    // never reach this workspace's tabs.\n    const startedHere = new Set<string>();\n    const unsubscribe = queryClient.getQueryCache().subscribe((event) => {\n      if (event.type === 'removed') {\n        startedHere.delete(event.query.queryHash);\n        return;\n      }\n      if (event.type !== 'updated') return;\n      const { queryKey, queryHash } = event.query;\n      if (!isFirstPageKey(queryKey)) return;\n      if (event.action.type === 'fetch') {\n        startedHere.add(queryHash);\n        return;\n      }\n      if (event.action.type === 'error') {\n        startedHere.delete(queryHash);\n        return;\n      }\n      if (event.action.type !== 'success') return;\n      // A page set by hand (one another tab shared, an optimistic patch) is not news to them.\n      if ((event.action as { manual?: boolean }).manual) return;\n      if (!startedHere.delete(queryHash)) return;\n      if (!isPage(event.query.state.data)) return;\n      post({\n        v: MESSAGE_VERSION,\n        kind: 'page',\n        key: sessionListShareKey(queryKey),\n        queryKey,\n        data: event.query.state.data,\n        updatedAt: event.query.state.dataUpdatedAt,\n      });\n    });\n    return () => {\n      unsubscribe();\n      if (channelRef.current === channel) channelRef.current = null;\n      channel.onmessage = null;\n      channel.close();\n    };\n  }, [channelName, claims, queryClient]);\n\n  return useMemo<SessionListTabShare>(() => {\n    if (!isSupported) return NO_SHARE;\n    return {\n      claimedUntil: (key) => {\n        const until = claims.get(key);\n        if (until === undefined) return null;\n        if (until <= Date.now()) {\n          claims.delete(key);\n          return null;\n        }\n        return until;\n      },\n      claim: (key) => {\n        try {\n          channelRef.current?.postMessage({\n            v: MESSAGE_VERSION,\n            kind: 'claim',\n            key,\n          } satisfies TabShareMessage);\n        } catch {\n          // Closed: nothing to coordinate with.\n        }\n      },\n    };\n  }, [isSupported, claims]);\n}\n"],"names":["CONVERSATION_LIST_QUERY_KEY_ROOT","keyPartFingerprint","useMemo","useRef","useEffect"],"mappings":";;;;;AA+BO,MAAM,qBAAqB;AAElC,MAAM,iBAAiB;AACvB,MAAM,kBAAkB;AAgBxB,MAAM,WAAgC;AAAA,EACpC,cAAc,MAAM;AAAA,EACpB,OAAO,MAAM;AACf;AAGO,SAAS,oBAAoB,UAA4B;AAC9D,SAAO,KAAK,UAAU,QAAQ;AAChC;AAEA,SAAS,eAAe,UAAyC;AAC/D,SACE,MAAM,QAAQ,QAAQ,KACtB,SAAS,CAAC,MAAMA,iBAAAA,oCAChB,SAAS,SAAS,SAAS,CAAC,MAAM;AAEtC;AAEA,SAAS,OAAO,OAA+C;AAC7D,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,EAAE,OAAO,QAAA,IAAY;AAC3B,SAAO,MAAM,QAAQ,KAAK,KAAK,OAAO,YAAY;AACpD;AAGO,SAAS,qBAAqB,KAAsC;AACzE,MAAI,OAAO,QAAQ,YAAY,QAAQ,KAAM,QAAO;AACpD,QAAM,UAAU;AAChB,MAAI,QAAQ,MAAM,mBAAmB,OAAO,QAAQ,QAAQ,SAAU,QAAO;AAC7E,MAAI,QAAQ,SAAS,QAAS,QAAO,EAAE,GAAG,iBAAiB,MAAM,SAAS,KAAK,QAAQ,IAAA;AACvF,MACE,QAAQ,SAAS,UACjB,eAAe,QAAQ,QAAQ,KAC/B,oBAAoB,QAAQ,QAAQ,MAAM,QAAQ,OAClD,OAAO,QAAQ,IAAI,KACnB,OAAO,QAAQ,cAAc,UAC7B;AACA,WAAO;AAAA,MACL,GAAG;AAAA,MACH,MAAM;AAAA,MACN,KAAK,QAAQ;AAAA,MACb,UAAU,QAAQ;AAAA,MAClB,MAAM,QAAQ;AAAA,MACd,WAAW,QAAQ;AAAA,IAAA;AAAA,EAEvB;AACA,SAAO;AACT;AAOO,SAAS,gBACd,aACA,SACS;AACT,QAAM,QAAQ,YAAY,cAAc,QAAQ,QAAQ;AACxD,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,MAAM,iBAAiB,QAAQ,UAAW,QAAO;AACrD,cAAY,aAAa,QAAQ,UAAU,QAAQ,MAAM,EAAE,WAAW,QAAQ,WAAW;AACzF,SAAO;AACT;AAOO,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AACF,GAGwB;AACtB,QAAM,cAAc,WAChB,GAAG,cAAc,GAAGC,mBAAAA;AAAAA,IAClB,CAAC,SAAS,YAAY,SAAS,QAAQ,SAAS,WAAW,EAAE,KAAK,IAAQ;AAAA,EAAA,CAC3E,KACD;AACJ,QAAM,SAASC,MAAAA,QAAQ,MAAM,oBAAI,OAAuB,CAAC,WAAW,CAAC;AAIrE,QAAM,aAAaC,MAAAA,OAAgC,IAAI;AACvD,QAAM,cAAc,gBAAgB,QAAQ,OAAO,qBAAqB;AAExEC,QAAAA,UAAU,MAAM;AACd,QAAI,CAAC,eAAe,OAAO,qBAAqB,YAAa;AAC7D,QAAI;AACJ,QAAI;AACF,gBAAU,IAAI,iBAAiB,WAAW;AAAA,IAC5C,QAAQ;AACN;AAAA,IACF;AACA,eAAW,UAAU;AACrB,UAAM,OAAO,CAAC,YAA6B;AACzC,UAAI;AACF,gBAAQ,YAAY,OAAO;AAAA,MAC7B,QAAQ;AAAA,MAER;AAAA,IACF;AACA,YAAQ,YAAY,CAAC,UAAwB;AAC3C,YAAM,UAAU,qBAAqB,MAAM,IAAI;AAC/C,UAAI,CAAC,QAAS;AACd,UAAI,QAAQ,SAAS,SAAS;AAC5B,eAAO,IAAI,QAAQ,KAAK,KAAK,IAAA,IAAQ,kBAAkB;AACvD;AAAA,MACF;AAGA,sBAAgB,aAAa,OAAO;AAAA,IACtC;AAMA,UAAM,kCAAkB,IAAA;AACxB,UAAM,cAAc,YAAY,cAAA,EAAgB,UAAU,CAAC,UAAU;AACnE,UAAI,MAAM,SAAS,WAAW;AAC5B,oBAAY,OAAO,MAAM,MAAM,SAAS;AACxC;AAAA,MACF;AACA,UAAI,MAAM,SAAS,UAAW;AAC9B,YAAM,EAAE,UAAU,UAAA,IAAc,MAAM;AACtC,UAAI,CAAC,eAAe,QAAQ,EAAG;AAC/B,UAAI,MAAM,OAAO,SAAS,SAAS;AACjC,oBAAY,IAAI,SAAS;AACzB;AAAA,MACF;AACA,UAAI,MAAM,OAAO,SAAS,SAAS;AACjC,oBAAY,OAAO,SAAS;AAC5B;AAAA,MACF;AACA,UAAI,MAAM,OAAO,SAAS,UAAW;AAErC,UAAK,MAAM,OAAgC,OAAQ;AACnD,UAAI,CAAC,YAAY,OAAO,SAAS,EAAG;AACpC,UAAI,CAAC,OAAO,MAAM,MAAM,MAAM,IAAI,EAAG;AACrC,WAAK;AAAA,QACH,GAAG;AAAA,QACH,MAAM;AAAA,QACN,KAAK,oBAAoB,QAAQ;AAAA,QACjC;AAAA,QACA,MAAM,MAAM,MAAM,MAAM;AAAA,QACxB,WAAW,MAAM,MAAM,MAAM;AAAA,MAAA,CAC9B;AAAA,IACH,CAAC;AACD,WAAO,MAAM;AACX,kBAAA;AACA,UAAI,WAAW,YAAY,QAAS,YAAW,UAAU;AACzD,cAAQ,YAAY;AACpB,cAAQ,MAAA;AAAA,IACV;AAAA,EACF,GAAG,CAAC,aAAa,QAAQ,WAAW,CAAC;AAErC,SAAOF,MAAAA,QAA6B,MAAM;AACxC,QAAI,CAAC,YAAa,QAAO;AACzB,WAAO;AAAA,MACL,cAAc,CAAC,QAAQ;AACrB,cAAM,QAAQ,OAAO,IAAI,GAAG;AAC5B,YAAI,UAAU,OAAW,QAAO;AAChC,YAAI,SAAS,KAAK,OAAO;AACvB,iBAAO,OAAO,GAAG;AACjB,iBAAO;AAAA,QACT;AACA,eAAO;AAAA,MACT;AAAA,MACA,OAAO,CAAC,QAAQ;;AACd,YAAI;AACF,2BAAW,YAAX,mBAAoB,YAAY;AAAA,YAC9B,GAAG;AAAA,YACH,MAAM;AAAA,YACN;AAAA,UAAA;AAAA,QAEJ,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IAAA;AAAA,EAEJ,GAAG,CAAC,aAAa,MAAM,CAAC;AAC1B;;;;;;"}

package/dist/threads/session-list-tab-share.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Open tabs of one signed-in user share their session-list reads.
+ *
+ * A pushed conversation-index change reaches every open tab at once, and each
+ * one used to re-read the same lists. With this in place:
+ *
+ * - **Pages are shared.** Whenever a tab reads a list's first page, it posts
+ *   the page on a `BroadcastChannel` named for the backend, the user and the
+ *   workspace. A tab that holds the same list (same query key) and has an
+ *   older copy takes it, so the new row appears there without a request.
+ * - **One tab reads for the others.** Before an index-triggered refresh, a tab
+ *   claims the list on the channel. The other tabs hold their own refresh for
+ *   that list for {@link TAB_SHARE_CLAIM_MS}; the claimer's page normally
+ *   lands well before then. If it does not (the claimer failed or closed),
+ *   they refresh themselves.
+ *
+ * Only same-origin tabs can hear a `BroadcastChannel`, and only tabs signed in
+ * as the same user to the same workspace and backend use the same channel, so
+ * a page never reaches another account. Without a signed-in user, a
+ * workspace, or `BroadcastChannel` (older browsers, SSR, tests), every call is
+ * a no-op and each tab reads for itself, as before.
+ */
+import { type ConversationListPage } from '../agent-runtime/src/index';
+import type { QueryClient, QueryKey } from '@tanstack/react-query';
+/** How long a claim by another tab holds this tab's own refresh of that list. */
+export declare const TAB_SHARE_CLAIM_MS = 5000;
+type TabShareMessage = {
+    v: number;
+    kind: 'page';
+    key: string;
+    queryKey: QueryKey;
+    data: ConversationListPage;
+    updatedAt: number;
+} | {
+    v: number;
+    kind: 'claim';
+    key: string;
+};
+export interface SessionListTabShare {
+    /**
+     * Whether another tab has claimed the list with this query key and its
+     * claim still stands: when it lapses (epoch ms), or `null`.
+     */
+    claimedUntil(key: string): number | null;
+    /** Tell the other tabs this one is reading the list now. */
+    claim(key: string): void;
+}
+/** A list's first-page query key, as the stable string the channel names it by. */
+export declare function sessionListShareKey(queryKey: QueryKey): string;
+/** Parse a channel message, or `null` for anything this version does not send. Exported for tests. */
+export declare function parseTabShareMessage(raw: unknown): TabShareMessage | null;
+/**
+ * Take a page another tab read: only into a list this tab holds, and only
+ * when it is newer than this tab's copy. Returns whether it was taken.
+ * Exported for tests.
+ */
+export declare function applySharedPage(queryClient: QueryClient, message: Extract<TabShareMessage, {
+    kind: 'page';
+}>): boolean;
+/**
+ * Share this provider's session-list first pages with the user's other open
+ * tabs, and hear theirs. `identity` is `null` when sharing must stay off (no
+ * signed-in user or workspace known yet).
+ */
+export declare function useSessionListTabShare({ queryClient, identity, }: {
+    queryClient: QueryClient;
+    identity: {
+        backendUrl: string;
+        userId: string;
+        workspaceId: string;
+    } | null;
+}): SessionListTabShare;
+export {};

package/dist/threads/session-list-tab-share.js

@@ -0,0 +1,150 @@
+import { useMemo, useRef, useEffect } from "react";
+import { keyPartFingerprint } from "../lib/use-athena-rest-query.js";
+import { CONVERSATION_LIST_QUERY_KEY_ROOT } from "../agent-runtime/src/conversation-list.js";
+const TAB_SHARE_CLAIM_MS = 5e3;
+const CHANNEL_PREFIX = "athena-sdk:session-list:";
+const MESSAGE_VERSION = 1;
+const NO_SHARE = {
+  claimedUntil: () => null,
+  claim: () => void 0
+};
+function sessionListShareKey(queryKey) {
+  return JSON.stringify(queryKey);
+}
+function isFirstPageKey(queryKey) {
+  return Array.isArray(queryKey) && queryKey[0] === CONVERSATION_LIST_QUERY_KEY_ROOT && queryKey[queryKey.length - 1] === "first-page";
+}
+function isPage(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const { items, hasMore } = value;
+  return Array.isArray(items) && typeof hasMore === "boolean";
+}
+function parseTabShareMessage(raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const message = raw;
+  if (message.v !== MESSAGE_VERSION || typeof message.key !== "string") return null;
+  if (message.kind === "claim") return { v: MESSAGE_VERSION, kind: "claim", key: message.key };
+  if (message.kind === "page" && isFirstPageKey(message.queryKey) && sessionListShareKey(message.queryKey) === message.key && isPage(message.data) && typeof message.updatedAt === "number") {
+    return {
+      v: MESSAGE_VERSION,
+      kind: "page",
+      key: message.key,
+      queryKey: message.queryKey,
+      data: message.data,
+      updatedAt: message.updatedAt
+    };
+  }
+  return null;
+}
+function applySharedPage(queryClient, message) {
+  const state = queryClient.getQueryState(message.queryKey);
+  if (!state) return false;
+  if (state.dataUpdatedAt >= message.updatedAt) return false;
+  queryClient.setQueryData(message.queryKey, message.data, { updatedAt: message.updatedAt });
+  return true;
+}
+function useSessionListTabShare({
+  queryClient,
+  identity
+}) {
+  const channelName = identity ? `${CHANNEL_PREFIX}${keyPartFingerprint(
+    [identity.backendUrl, identity.userId, identity.workspaceId].join("\0")
+  )}` : null;
+  const claims = useMemo(() => /* @__PURE__ */ new Map(), [channelName]);
+  const channelRef = useRef(null);
+  const isSupported = channelName !== null && typeof BroadcastChannel !== "undefined";
+  useEffect(() => {
+    if (!channelName || typeof BroadcastChannel === "undefined") return;
+    let channel;
+    try {
+      channel = new BroadcastChannel(channelName);
+    } catch {
+      return;
+    }
+    channelRef.current = channel;
+    const post = (message) => {
+      try {
+        channel.postMessage(message);
+      } catch {
+      }
+    };
+    channel.onmessage = (event) => {
+      const message = parseTabShareMessage(event.data);
+      if (!message) return;
+      if (message.kind === "claim") {
+        claims.set(message.key, Date.now() + TAB_SHARE_CLAIM_MS);
+        return;
+      }
+      applySharedPage(queryClient, message);
+    };
+    const startedHere = /* @__PURE__ */ new Set();
+    const unsubscribe = queryClient.getQueryCache().subscribe((event) => {
+      if (event.type === "removed") {
+        startedHere.delete(event.query.queryHash);
+        return;
+      }
+      if (event.type !== "updated") return;
+      const { queryKey, queryHash } = event.query;
+      if (!isFirstPageKey(queryKey)) return;
+      if (event.action.type === "fetch") {
+        startedHere.add(queryHash);
+        return;
+      }
+      if (event.action.type === "error") {
+        startedHere.delete(queryHash);
+        return;
+      }
+      if (event.action.type !== "success") return;
+      if (event.action.manual) return;
+      if (!startedHere.delete(queryHash)) return;
+      if (!isPage(event.query.state.data)) return;
+      post({
+        v: MESSAGE_VERSION,
+        kind: "page",
+        key: sessionListShareKey(queryKey),
+        queryKey,
+        data: event.query.state.data,
+        updatedAt: event.query.state.dataUpdatedAt
+      });
+    });
+    return () => {
+      unsubscribe();
+      if (channelRef.current === channel) channelRef.current = null;
+      channel.onmessage = null;
+      channel.close();
+    };
+  }, [channelName, claims, queryClient]);
+  return useMemo(() => {
+    if (!isSupported) return NO_SHARE;
+    return {
+      claimedUntil: (key) => {
+        const until = claims.get(key);
+        if (until === void 0) return null;
+        if (until <= Date.now()) {
+          claims.delete(key);
+          return null;
+        }
+        return until;
+      },
+      claim: (key) => {
+        var _a;
+        try {
+          (_a = channelRef.current) == null ? void 0 : _a.postMessage({
+            v: MESSAGE_VERSION,
+            kind: "claim",
+            key
+          });
+        } catch {
+        }
+      }
+    };
+  }, [isSupported, claims]);
+}
+export {
+  TAB_SHARE_CLAIM_MS,
+  applySharedPage,
+  parseTabShareMessage,
+  sessionListShareKey,
+  useSessionListTabShare
+};
+//# sourceMappingURL=session-list-tab-share.js.map

package/dist/threads/session-list-tab-share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list-tab-share.js","sources":["../../src/threads/session-list-tab-share.ts"],"sourcesContent":["/**\n * Open tabs of one signed-in user share their session-list reads.\n *\n * A pushed conversation-index change reaches every open tab at once, and each\n * one used to re-read the same lists. With this in place:\n *\n * - **Pages are shared.** Whenever a tab reads a list's first page, it posts\n *   the page on a `BroadcastChannel` named for the backend, the user and the\n *   workspace. A tab that holds the same list (same query key) and has an\n *   older copy takes it, so the new row appears there without a request.\n * - **One tab reads for the others.** Before an index-triggered refresh, a tab\n *   claims the list on the channel. The other tabs hold their own refresh for\n *   that list for {@link TAB_SHARE_CLAIM_MS}; the claimer's page normally\n *   lands well before then. If it does not (the claimer failed or closed),\n *   they refresh themselves.\n *\n * Only same-origin tabs can hear a `BroadcastChannel`, and only tabs signed in\n * as the same user to the same workspace and backend use the same channel, so\n * a page never reaches another account. Without a signed-in user, a\n * workspace, or `BroadcastChannel` (older browsers, SSR, tests), every call is\n * a no-op and each tab reads for itself, as before.\n */\nimport {\n  type ConversationListPage,\n  CONVERSATION_LIST_QUERY_KEY_ROOT,\n} from '@athenaintel/agent-runtime';\nimport type { QueryClient, QueryKey } from '@tanstack/react-query';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { keyPartFingerprint } from '../lib/use-athena-rest-query';\n\n/** How long a claim by another tab holds this tab's own refresh of that list. */\nexport const TAB_SHARE_CLAIM_MS = 5_000;\n\nconst CHANNEL_PREFIX = 'athena-sdk:session-list:';\nconst MESSAGE_VERSION = 1;\n\ntype TabShareMessage =\n  | { v: number; kind: 'page'; key: string; queryKey: QueryKey; data: ConversationListPage; updatedAt: number }\n  | { v: number; kind: 'claim'; key: string };\n\nexport interface SessionListTabShare {\n  /**\n   * Whether another tab has claimed the list with this query key and its\n   * claim still stands: when it lapses (epoch ms), or `null`.\n   */\n  claimedUntil(key: string): number | null;\n  /** Tell the other tabs this one is reading the list now. */\n  claim(key: string): void;\n}\n\nconst NO_SHARE: SessionListTabShare = {\n  claimedUntil: () => null,\n  claim: () => undefined,\n};\n\n/** A list's first-page query key, as the stable string the channel names it by. */\nexport function sessionListShareKey(queryKey: QueryKey): string {\n  return JSON.stringify(queryKey);\n}\n\nfunction isFirstPageKey(queryKey: unknown): queryKey is QueryKey {\n  return (\n    Array.isArray(queryKey) &&\n    queryKey[0] === CONVERSATION_LIST_QUERY_KEY_ROOT &&\n    queryKey[queryKey.length - 1] === 'first-page'\n  );\n}\n\nfunction isPage(value: unknown): value is ConversationListPage {\n  if (typeof value !== 'object' || value === null) return false;\n  const { items, hasMore } = value as Record<string, unknown>;\n  return Array.isArray(items) && typeof hasMore === 'boolean';\n}\n\n/** Parse a channel message, or `null` for anything this version does not send. Exported for tests. */\nexport function parseTabShareMessage(raw: unknown): TabShareMessage | null {\n  if (typeof raw !== 'object' || raw === null) return null;\n  const message = raw as Record<string, unknown>;\n  if (message.v !== MESSAGE_VERSION || typeof message.key !== 'string') return null;\n  if (message.kind === 'claim') return { v: MESSAGE_VERSION, kind: 'claim', key: message.key };\n  if (\n    message.kind === 'page' &&\n    isFirstPageKey(message.queryKey) &&\n    sessionListShareKey(message.queryKey) === message.key &&\n    isPage(message.data) &&\n    typeof message.updatedAt === 'number'\n  ) {\n    return {\n      v: MESSAGE_VERSION,\n      kind: 'page',\n      key: message.key,\n      queryKey: message.queryKey,\n      data: message.data,\n      updatedAt: message.updatedAt,\n    };\n  }\n  return null;\n}\n\n/**\n * Take a page another tab read: only into a list this tab holds, and only\n * when it is newer than this tab's copy. Returns whether it was taken.\n * Exported for tests.\n */\nexport function applySharedPage(\n  queryClient: QueryClient,\n  message: Extract<TabShareMessage, { kind: 'page' }>,\n): boolean {\n  const state = queryClient.getQueryState(message.queryKey);\n  if (!state) return false;\n  if (state.dataUpdatedAt >= message.updatedAt) return false;\n  queryClient.setQueryData(message.queryKey, message.data, { updatedAt: message.updatedAt });\n  return true;\n}\n\n/**\n * Share this provider's session-list first pages with the user's other open\n * tabs, and hear theirs. `identity` is `null` when sharing must stay off (no\n * signed-in user or workspace known yet).\n */\nexport function useSessionListTabShare({\n  queryClient,\n  identity,\n}: {\n  queryClient: QueryClient;\n  identity: { backendUrl: string; userId: string; workspaceId: string } | null;\n}): SessionListTabShare {\n  const channelName = identity\n    ? `${CHANNEL_PREFIX}${keyPartFingerprint(\n        [identity.backendUrl, identity.userId, identity.workspaceId].join('\\u0000'),\n      )}`\n    : null;\n  const claims = useMemo(() => new Map<string, number>(), [channelName]);\n  // The channel is opened by the effect that closes it, so each setup has its\n  // own (StrictMode's setup, cleanup, setup included), and `claim` posts on\n  // whichever one is open now.\n  const channelRef = useRef<BroadcastChannel | null>(null);\n  const isSupported = channelName !== null && typeof BroadcastChannel !== 'undefined';\n\n  useEffect(() => {\n    if (!channelName || typeof BroadcastChannel === 'undefined') return;\n    let channel: BroadcastChannel;\n    try {\n      channel = new BroadcastChannel(channelName);\n    } catch {\n      return;\n    }\n    channelRef.current = channel;\n    const post = (message: TabShareMessage) => {\n      try {\n        channel.postMessage(message);\n      } catch {\n        // A page that cannot be cloned or a closed channel: the other tabs read for themselves.\n      }\n    };\n    channel.onmessage = (event: MessageEvent) => {\n      const message = parseTabShareMessage(event.data);\n      if (!message) return;\n      if (message.kind === 'claim') {\n        claims.set(message.key, Date.now() + TAB_SHARE_CLAIM_MS);\n        return;\n      }\n      // The claim stands until it lapses: a tab whose rows the page still\n      // leaves out reads for itself once it does, not all of them at once.\n      applySharedPage(queryClient, message);\n    };\n    // Only a read that STARTED while this channel was open is shared on it.\n    // The channel is named for the workspace the current credential resolved\n    // to; a read started before (under the previous credential, perhaps for\n    // another workspace) may still land after the switch, and its rows must\n    // never reach this workspace's tabs.\n    const startedHere = new Set<string>();\n    const unsubscribe = queryClient.getQueryCache().subscribe((event) => {\n      if (event.type === 'removed') {\n        startedHere.delete(event.query.queryHash);\n        return;\n      }\n      if (event.type !== 'updated') return;\n      const { queryKey, queryHash } = event.query;\n      if (!isFirstPageKey(queryKey)) return;\n      if (event.action.type === 'fetch') {\n        startedHere.add(queryHash);\n        return;\n      }\n      if (event.action.type === 'error') {\n        startedHere.delete(queryHash);\n        return;\n      }\n      if (event.action.type !== 'success') return;\n      // A page set by hand (one another tab shared, an optimistic patch) is not news to them.\n      if ((event.action as { manual?: boolean }).manual) return;\n      if (!startedHere.delete(queryHash)) return;\n      if (!isPage(event.query.state.data)) return;\n      post({\n        v: MESSAGE_VERSION,\n        kind: 'page',\n        key: sessionListShareKey(queryKey),\n        queryKey,\n        data: event.query.state.data,\n        updatedAt: event.query.state.dataUpdatedAt,\n      });\n    });\n    return () => {\n      unsubscribe();\n      if (channelRef.current === channel) channelRef.current = null;\n      channel.onmessage = null;\n      channel.close();\n    };\n  }, [channelName, claims, queryClient]);\n\n  return useMemo<SessionListTabShare>(() => {\n    if (!isSupported) return NO_SHARE;\n    return {\n      claimedUntil: (key) => {\n        const until = claims.get(key);\n        if (until === undefined) return null;\n        if (until <= Date.now()) {\n          claims.delete(key);\n          return null;\n        }\n        return until;\n      },\n      claim: (key) => {\n        try {\n          channelRef.current?.postMessage({\n            v: MESSAGE_VERSION,\n            kind: 'claim',\n            key,\n          } satisfies TabShareMessage);\n        } catch {\n          // Closed: nothing to coordinate with.\n        }\n      },\n    };\n  }, [isSupported, claims]);\n}\n"],"names":[],"mappings":"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"}

package/dist/threads/session-row-parts.d.ts

@@ -4,7 +4,7 @@
  * attention-toned status chip, and a labelled icon action that never selects
  * its row.
  */
-import type { ConversationPullRequest } from '@athenaintel/agent-runtime';
+import type { ConversationPullRequest } from '../agent-runtime/src/index';
 import type { FC, MouseEvent, ReactNode } from 'react';
 import { type PullRequestChip as PullRequestChipModel } from './session-list-model';
 import type { SessionStatusTone } from './sessions-page-model';

package/dist/threads/sessions-query.d.ts

@@ -13,7 +13,7 @@
  * applied at all on that server (`unavailable`: the UI disables those
  * controls).
  */
-import type { ConversationSummary } from '@athenaintel/agent-runtime';
+import type { ConversationSummary } from '../agent-runtime/src/index';
 import type { ThreadListFilterBody } from './api';
 export type AthenaSessionsSort = 'updated' | 'created';
 export type AthenaSessionsDirection = 'desc' | 'asc';

package/dist/threads/statewire-thread-list.cjs

@@ -13,6 +13,8 @@ const credentialShape = require("./credential-shape.cjs");
 const mintThreadId = require("./mint-thread-id.cjs");
 const threadIdContext = require("./thread-id-context.cjs");
 const threadPrefetcher = require("./thread-prefetcher.cjs");
+const indexTriggeredRefresh = require("./index-triggered-refresh.cjs");
+const sessionListTabShare = require("./session-list-tab-share.cjs");
 const title = require("./title.cjs");
 const authRefusalRestart = require("../runtime/auth-refusal-restart.cjs");
 const credentialRenewal = require("../runtime/credential-renewal.cjs");
@@ -85,6 +87,7 @@ function withPinnedConversations({
 }
 const AthenaSessionsLiveContext = react.createContext(null);
 const THREAD_LIST_PAGE_SIZE = 50;
+const EMPTY_THREAD_IDS = /* @__PURE__ */ new Set();
 const MAX_PINNED_PAGES = 10;
 function StatewireThreadListState({
   backendUrl,
@@ -340,24 +343,45 @@ function StatewireThreadListState({
   const fetchNextPage = react.useCallback(() => {
     void listFetchNextPage();
   }, [listFetchNextPage]);
-  const refreshedForRef = react.useRef(/* @__PURE__ */ new Set());
-  react.useEffect(() => {
-    if (index.entries === null) return;
-    const unlisted = indexedThreadsToRefreshFor({
+  const listedThreadIds = react.useMemo(
+    () => new Set(list.conversations.map((conversation) => conversation.threadId)),
+    [list.conversations]
+  );
+  const unlistedIndexedThreads = react.useMemo(
+    () => index.entries === null ? [] : indexedThreadsToRefreshFor({
       entries: index.entries,
-      listedThreadIds: new Set(list.conversations.map((conversation) => conversation.threadId)),
-      refreshedThreadIds: refreshedForRef.current,
+      listedThreadIds,
+      refreshedThreadIds: EMPTY_THREAD_IDS,
       appId,
       additionalAppIds: listedAppIds
-    });
-    for (const threadId of unlisted) refreshedForRef.current.add(threadId);
-    if (unlisted.length > 0) void listRefresh();
-  }, [index.entries, list.conversations, appId, listedAppIds, listRefresh]);
-  const selectThread = react.useCallback((threadId) => {
+    }),
+    [index.entries, listedThreadIds, appId, listedAppIds]
+  );
+  const tabShare = sessionListTabShare.useSessionListTabShare({
+    queryClient,
+    identity: indexWorkspaceId && indexUserId ? { backendUrl, userId: indexUserId, workspaceId: indexWorkspaceId } : null
+  });
+  const listShareKey = sessionListTabShare.sessionListShareKey(
+    conversationList.conversationListQueryKeys.firstPage(
+      listScopeKey,
+      conversationList.conversationListFilterKey(filter),
+      THREAD_LIST_PAGE_SIZE
+    )
+  );
+  indexTriggeredRefresh.useIndexTriggeredRefresh({
+    pending: unlistedIndexedThreads,
+    refresh: listRefresh,
+    // Held only while the page is being read (its first read and that read's
+    // own retries included). A first page that was refused does not hold it:
+    // the index-triggered refresh is then how the list recovers.
+    enabled: hasAuth && index.entries !== null && !list.isFetching,
+    tabShare,
+    shareKey: listShareKey
+  });
+  const selectThread = react.useCallback((threadId, options) => {
     if (!threadId) return;
-    setActive(
-      (current) => current.id === threadId ? current : { id: threadId, isNew: false }
-    );
+    const isNew = (options == null ? void 0 : options.isNew) === true;
+    setActive((current) => current.id === threadId ? current : { id: threadId, isNew });
   }, []);
   const prefetchScope = `${backendUrl}::${principal}::${credentialGeneration}`;
   const prefetchScopeRef = react.useRef(prefetchScope);
@@ -473,7 +497,8 @@ function StatewireThreadListState({
       },
       indexByThread,
       indexEntries: index.entries,
-      applyOverrides
+      applyOverrides,
+      tabShare
     }),
     [
       backendUrl,
@@ -487,7 +512,8 @@ function StatewireThreadListState({
       listedAppIds,
       indexByThread,
       index.entries,
-      applyOverrides
+      applyOverrides,
+      tabShare
     ]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(AthenaStatewireThreadListContext.Provider, { value, children: /* @__PURE__ */ jsxRuntime.jsx(AthenaSessionsLiveContext.Provider, { value: live, children }) });