@athenaintel/react 0.41.2 → 0.42.1

package/dist/threads/offline-session-list.js

@@ -0,0 +1,75 @@
+import { useRef, useEffect } from "react";
+import { CONVERSATION_LIST_QUERY_KEY_ROOT } from "../agent-runtime/src/conversation-list.js";
+const OFFLINE_SESSION_LIST_KEY = "session-list";
+const MAX_OFFLINE_SESSION_LIST_PAGES = 4;
+const RESTORED_UPDATED_AT = 1;
+function isSessionListFirstPage(queryKey) {
+  return queryKey[0] === CONVERSATION_LIST_QUERY_KEY_ROOT && queryKey[4] === "first-page";
+}
+function isFirstPageKey(queryKey) {
+  return Array.isArray(queryKey) && queryKey.length === 5 && isSessionListFirstPage(queryKey) && typeof queryKey[1] === "string" && typeof queryKey[2] === "string" && typeof queryKey[3] === "number";
+}
+function isConversationRow(row) {
+  if (typeof row !== "object" || row === null) return false;
+  const { threadId, title, updatedAt } = row;
+  return typeof threadId === "string" && typeof title === "string" && typeof updatedAt === "string";
+}
+function isConversationListPage(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const { items, hasMore, totalCount } = value;
+  return Array.isArray(items) && items.every(isConversationRow) && typeof hasMore === "boolean" && (totalCount === null || typeof totalCount === "number");
+}
+function isKeptPage(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const { queryKey, data } = value;
+  return isFirstPageKey(queryKey) && isConversationListPage(data);
+}
+function useOfflineSessionList({
+  queryClient,
+  offlineList
+}) {
+  const mirror = offlineList == null ? void 0 : offlineList.mirror;
+  const ownerId = offlineList == null ? void 0 : offlineList.ownerId;
+  const boundOwner = useRef(null);
+  useEffect(() => {
+    if (!mirror || !ownerId) return;
+    if (boundOwner.current !== null && boundOwner.current !== ownerId) {
+      void queryClient.cancelQueries({ queryKey: [CONVERSATION_LIST_QUERY_KEY_ROOT] });
+      queryClient.removeQueries({ queryKey: [CONVERSATION_LIST_QUERY_KEY_ROOT] });
+    }
+    boundOwner.current = ownerId;
+    const boundAt = Date.now();
+    let stopped = false;
+    void mirror.loadList({ ownerId, listKey: OFFLINE_SESSION_LIST_KEY }).then((kept) => {
+      if (stopped || !kept || !Array.isArray(kept.value)) return;
+      for (const page of kept.value) {
+        if (!isKeptPage(page)) continue;
+        if (queryClient.getQueryData(page.queryKey) !== void 0) continue;
+        queryClient.setQueryData(page.queryKey, page.data, { updatedAt: RESTORED_UPDATED_AT });
+      }
+    });
+    const write = () => {
+      const pages = queryClient.getQueryCache().findAll({ predicate: (query) => isSessionListFirstPage(query.queryKey) }).filter(
+        (query) => query.state.status === "success" && query.state.dataUpdatedAt >= boundAt && isConversationListPage(query.state.data)
+      ).sort((a, b) => b.state.dataUpdatedAt - a.state.dataUpdatedAt).slice(0, MAX_OFFLINE_SESSION_LIST_PAGES).map((query) => ({ queryKey: query.queryKey, data: query.state.data }));
+      if (pages.length > 0) mirror.writeList({ ownerId, listKey: OFFLINE_SESSION_LIST_KEY, value: pages });
+    };
+    const unsubscribe = queryClient.getQueryCache().subscribe((event) => {
+      if (event.type !== "updated" || event.action.type !== "success") return;
+      if (!isSessionListFirstPage(event.query.queryKey)) return;
+      if (event.query.state.dataUpdatedAt === RESTORED_UPDATED_AT) return;
+      write();
+    });
+    return () => {
+      stopped = true;
+      unsubscribe();
+    };
+  }, [queryClient, mirror, ownerId]);
+}
+export {
+  MAX_OFFLINE_SESSION_LIST_PAGES,
+  OFFLINE_SESSION_LIST_KEY,
+  isSessionListFirstPage,
+  useOfflineSessionList
+};
+//# sourceMappingURL=offline-session-list.js.map

package/dist/threads/offline-session-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-session-list.js","sources":["../../src/threads/offline-session-list.ts"],"sourcesContent":["import {\n  CONVERSATION_LIST_QUERY_KEY_ROOT,\n  type ConversationListPage,\n  type ThreadSnapshotMirror,\n} from '@athenaintel/agent-runtime';\nimport type { QueryClient, QueryKey } from '@tanstack/react-query';\nimport { useEffect, useRef } from 'react';\n\n/** Under this name the list's pages are kept, per owner. */\nexport const OFFLINE_SESSION_LIST_KEY = 'session-list';\n/** The first pages kept: one per filter the list was read with, the newest first. */\nexport const MAX_OFFLINE_SESSION_LIST_PAGES = 4;\n/**\n * Restored pages are stamped this old, so they paint at once and are read again on mount whenever\n * Athena can be reached (and never replace a page already read in this provider).\n */\nconst RESTORED_UPDATED_AT = 1;\n\ninterface KeptPage {\n  queryKey: QueryKey;\n  data: ConversationListPage;\n}\n\n/** A conversation list's live first page (`conversationListQueryKeys.firstPage`). */\nexport function isSessionListFirstPage(queryKey: QueryKey): boolean {\n  return queryKey[0] === CONVERSATION_LIST_QUERY_KEY_ROOT && queryKey[4] === 'first-page';\n}\n\n/** Exactly `conversationListQueryKeys.firstPage(scopeKey, filterKey, pageSize)`. */\nfunction isFirstPageKey(queryKey: unknown): queryKey is QueryKey {\n  return (\n    Array.isArray(queryKey) &&\n    queryKey.length === 5 &&\n    isSessionListFirstPage(queryKey) &&\n    typeof queryKey[1] === 'string' &&\n    typeof queryKey[2] === 'string' &&\n    typeof queryKey[3] === 'number'\n  );\n}\n\nfunction isConversationRow(row: unknown): boolean {\n  if (typeof row !== 'object' || row === null) return false;\n  const { threadId, title, updatedAt } = row as Record<string, unknown>;\n  return typeof threadId === 'string' && typeof title === 'string' && typeof updatedAt === 'string';\n}\n\n/** A page the list can render: its rows carry the fields every row reads. */\nfunction isConversationListPage(value: unknown): value is ConversationListPage {\n  if (typeof value !== 'object' || value === null) return false;\n  const { items, hasMore, totalCount } = value as Record<string, unknown>;\n  return (\n    Array.isArray(items) &&\n    items.every(isConversationRow) &&\n    typeof hasMore === 'boolean' &&\n    (totalCount === null || typeof totalCount === 'number')\n  );\n}\n\nfunction isKeptPage(value: unknown): value is KeptPage {\n  if (typeof value !== 'object' || value === null) return false;\n  const { queryKey, data } = value as Record<string, unknown>;\n  return isFirstPageKey(queryKey) && isConversationListPage(data);\n}\n\n/**\n * The session list's first pages, kept on this device sealed under the host's key\n * (`offlineList`'s mirror, `AthenaProvider`'s `offlineHistory`): restored into the list's own query\n * client before it is read, so the list paints at once and reads while Athena can't be reached,\n * and written back (debounced by the mirror) each time a first page is read. Without `offlineList`,\n * nothing.\n *\n * Owner-bound. A list kept for one owner is never restored for another, and a change of owner\n * drops every page of the list's cache before the new owner's are restored (in API-key mode two\n * people read the same list keys); only pages read since the owner was bound are kept for them. A\n * restored page that is not a list page the rows can render is left out.\n */\nexport function useOfflineSessionList({\n  queryClient,\n  offlineList,\n}: {\n  queryClient: QueryClient;\n  offlineList: { mirror: ThreadSnapshotMirror; ownerId: string } | undefined;\n}): void {\n  const mirror = offlineList?.mirror;\n  const ownerId = offlineList?.ownerId;\n  const boundOwner = useRef<string | null>(null);\n  useEffect(() => {\n    if (!mirror || !ownerId) return;\n    if (boundOwner.current !== null && boundOwner.current !== ownerId) {\n      void queryClient.cancelQueries({ queryKey: [CONVERSATION_LIST_QUERY_KEY_ROOT] });\n      queryClient.removeQueries({ queryKey: [CONVERSATION_LIST_QUERY_KEY_ROOT] });\n    }\n    boundOwner.current = ownerId;\n    const boundAt = Date.now();\n    let stopped = false;\n    void mirror.loadList({ ownerId, listKey: OFFLINE_SESSION_LIST_KEY }).then((kept) => {\n      if (stopped || !kept || !Array.isArray(kept.value)) return;\n      for (const page of kept.value) {\n        if (!isKeptPage(page)) continue;\n        if (queryClient.getQueryData(page.queryKey) !== undefined) continue;\n        queryClient.setQueryData(page.queryKey, page.data, { updatedAt: RESTORED_UPDATED_AT });\n      }\n    });\n    const write = (): void => {\n      const pages: KeptPage[] = queryClient\n        .getQueryCache()\n        .findAll({ predicate: (query) => isSessionListFirstPage(query.queryKey) })\n        .filter(\n          (query) =>\n            query.state.status === 'success' &&\n            query.state.dataUpdatedAt >= boundAt &&\n            isConversationListPage(query.state.data),\n        )\n        .sort((a, b) => b.state.dataUpdatedAt - a.state.dataUpdatedAt)\n        .slice(0, MAX_OFFLINE_SESSION_LIST_PAGES)\n        .map((query) => ({ queryKey: query.queryKey, data: query.state.data as ConversationListPage }));\n      if (pages.length > 0) mirror.writeList({ ownerId, listKey: OFFLINE_SESSION_LIST_KEY, value: pages });\n    };\n    const unsubscribe = queryClient.getQueryCache().subscribe((event) => {\n      if (event.type !== 'updated' || event.action.type !== 'success') return;\n      if (!isSessionListFirstPage(event.query.queryKey)) return;\n      // A page restored from the device is not news to write back.\n      if (event.query.state.dataUpdatedAt === RESTORED_UPDATED_AT) return;\n      write();\n    });\n    return () => {\n      stopped = true;\n      unsubscribe();\n    };\n  }, [queryClient, mirror, ownerId]);\n}\n"],"names":[],"mappings":"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"}

package/dist/threads/pull-request-display.d.ts

@@ -4,7 +4,7 @@
  * workbench's Pull requests pane: one icon and one colour per state, one
  * phrase per checks state.
  */
-import type { ConversationPullRequest } from '@athenaintel/agent-runtime';
+import type { ConversationPullRequest } from '../agent-runtime/src/index';
 import type { FC } from 'react';
 import type { PullRequestChipState } from './session-list-model';
 export declare const PR_STATE_ICON: Record<PullRequestChipState, FC<{

package/dist/threads/session-list-model.d.ts

@@ -6,7 +6,7 @@
  * hosts that draw their own rows (`useAthenaSessionAttention`) can reuse the
  * same rules.
  */
-import type { ConversationPullRequest } from '@athenaintel/agent-runtime';
+import type { ConversationPullRequest } from '../agent-runtime/src/index';
 import type { AthenaStatewireThreadSummary } from './statewire-thread-list';
 export type SessionListGroup = 'Needs you' | 'Working' | 'Pinned' | 'Recent';
 /** Display order; a session appears once, in the FIRST group that applies. */

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

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const useAthenaRestQuery = require("../lib/use-athena-rest-query.cjs");
+const conversationList = require("../agent-runtime/src/conversation-list.cjs");
+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] === conversationList.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}${useAthenaRestQuery.keyPartFingerprint(
+    [identity.backendUrl, identity.userId, identity.workspaceId].join("\0")
+  )}` : null;
+  const claims = react.useMemo(() => /* @__PURE__ */ new Map(), [channelName]);
+  const channelRef = react.useRef(null);
+  const isSupported = channelName !== null && typeof BroadcastChannel !== "undefined";
+  react.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 react.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]);
+}
+exports.TAB_SHARE_CLAIM_MS = TAB_SHARE_CLAIM_MS;
+exports.applySharedPage = applySharedPage;
+exports.parseTabShareMessage = parseTabShareMessage;
+exports.sessionListShareKey = sessionListShareKey;
+exports.useSessionListTabShare = useSessionListTabShare;
+//# sourceMappingURL=session-list-tab-share.cjs.map

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":"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"}

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';