@athenaintel/react 0.36.1 → 0.38.0

package/README.md

@@ -623,8 +623,11 @@ workbench the layout opens no asset column of its own: assets the agent or the
 person opens show as the workbench's **Open assets** tab (closing the tab
 closes the asset panel). Maximize is offered only inside `AthenaLayout`, which
 owns the column's width; collapsing a maximized workspace brings the chat back
-beside the rail. `SessionWorkbench` also works on its own anywhere under
-`<AthenaProvider>`; it then keeps its collapsed state itself.
+beside the rail. Each session keeps its own open or collapsed workspace while
+the layout stays mounted, so `defaultWorkbenchCollapsed` is how a session the
+person has not opened it in starts. `SessionWorkbench` also works on its own
+anywhere under `<AthenaProvider>`; it then keeps its collapsed state itself,
+per session too.
 
 Built-in panes and what each reads:
 
@@ -774,6 +777,25 @@ Both use the same bearer / API key as session creation. The full recipe
 template skill `voice-session-guide.md`. `createAthenaVoiceSession` is also
 exported if you hold the bridge state yourself.
 
+## What's new in 0.38.0
+
+**A brief sign-in hiccup no longer shows your app's sign-in screen.** `AthenaSSOProvider` read the session (`/api/sso/userinfo`) once and showed `displayOnError` on any failure, so a person who was signed in saw the sign-in screen until they reloaded. On computer apps this happens when several tabs load at once: Marathon's credential mint is briefly rate limited and answers `502 {"error":"mint_failed"}`. Each read is now one bounded cycle, the one the parent bridge runs for `/_athena/auth`:
+
+- A transient failure (5xx, 408, 429, a network error, or no answer within 10 s) is retried with capped exponential backoff and jitter: at most 4 requests in all, about 0.5 s, 1 s and 2 s apart.
+- A 401 or 403 (no session) is not retried, and neither is another status or a 2xx without a JSON body.
+- A read that gives up reports one `AthenaSdkError`, with the new code `auth_sso_failed`, the HTTP `status` and `context.attempts`, to the provider's new `onError` prop and on the diagnostics bus. Pass `onError` to `AthenaSSOProvider` to observe it: an `AthenaProvider` nested inside is mounted only after sign-in, so its `onError` cannot see the first read. Nothing reads again on its own after that, except a forced token renewal or a focus revalidation (`revalidateOnWindowFocus`), each one bounded read.
+- A focus revalidation or a forced renewal that starts while a read is in flight joins that read instead of cancelling it, so one mint answers both. A read that fails keeps the session an earlier read answered.
+
+**`displayOnError` can tell a signed-out person from a failed read.** Pass a function and it receives `{ reason, retry }`. `reason` is `unauthenticated` (no session: offer sign-in), `request_failed` (the endpoint did not answer usably, even after retrying: the person may well be signed in, so offer `retry`) or `invalid_response`. `retry()` reads the session again and shows `displayWhileLoading` meanwhile. An element works as before. The types are `AthenaSSOFailure` and `AthenaSSOFailureReason`, from `@athenaintel/react/auth`.
+
+New diagnostics event: `auth.sso.userinfo.retry` (level `warn`, one for each retry, with `status`, `reason`, `attempt`, `max_attempts` and `delay_ms`). A read that gives up emits `auth.sso.userinfo.error`.
+
+No host code changes are needed. To stop showing a sign-in screen after a failed read, pass `displayOnError` as a function and branch on `reason` (see [Loading, sign-in and failures](#loading-sign-in-and-failures)).
+
+## What's new in 0.37.0
+
+**Each session keeps its own open or collapsed workspace.** `SessionWorkbench` already kept each session's tabs; it now keeps whether its workspace is open too. A session the person has not opened or collapsed it in, a new one or one switched to, shows `AthenaLayout`'s `defaultWorkbenchCollapsed`. With `defaultWorkbenchCollapsed`, every session starts with the workspace on its rail, and opening it in one session no longer opens it in the next. An asset the agent or the person opens still brings it out, for that session. Without the prop nothing changes for a session that has not collapsed it, but collapsing one no longer collapses the others.
+
 ## What's new in 0.36.1
 
 **Opening a long session no longer jumps the transcript around.** As older history pages in above what you are reading, the reading position now stays put, instantly. Before, the chat added its own scroll correction on top of the browser's scroll anchoring (a jump by a page's height), let it play through the viewport's smooth scrolling (a fast scroll through the transcript), and missed a page that folds into the first loaded turn, which moved the text under the reader. Cut tool outputs are now read only for messages near the viewport, at most two at a time, instead of every loaded step at once: opening a long agent run sent dozens of reads, each re-rendering the transcript and all queued ahead of your next message. Nothing to change in your app.
@@ -1490,6 +1512,27 @@ import { AthenaSSOProvider } from '@athenaintel/react/auth';
 
 If you need full control, `ssoUserInfoUrl`, `ssoLoginUrl`, and `ssoLogoutUrl` remain available as explicit overrides.
 
+### Loading, sign-in and failures
+
+```tsx
+<AthenaSSOProvider
+  displayWhileLoading={<AppSkeleton />}
+  displayOnError={({ reason, retry }) =>
+    reason === 'unauthenticated' ? <SignIn /> : <SignInCheckFailed onRetry={retry} />
+  }
+>
+  <AthenaProvider>
+    <AthenaChat />
+  </AthenaProvider>
+</AthenaSSOProvider>
+```
+
+- `displayWhileLoading` shows while the provider reads the session. On a normal load that takes well under a second, so an outline of your app reads better than words.
+- A transient failure (5xx, 408, 429, a network error, a timeout) is retried within the read, about 0.5 s, 1 s and 2 s apart, before `displayOnError` shows.
+- Only `unauthenticated` means the person has no session. `request_failed` means the endpoint did not answer usably; the person may well be signed in, so offer `retry` rather than sign-in.
+- `onError` receives the typed `auth_sso_failed` error of a read that gave up.
+- Without `displayOnError`, a person with no session is sent to `ssoLoginUrl`.
+
 ## Citation Links
 
 When you render chat inside `<AthenaLayout>`, Athena citation links (`app.athenaintel.com/dashboard/spaces?...`) now open the referenced asset in the SDK asset pane by default instead of navigating away.

package/dist/assets/AthenaLayout.cjs

@@ -96,8 +96,15 @@ const WorkbenchSplitLayout = ({
     )
   });
   const layoutState = react.useMemo(
-    () => ({ collapsed, setCollapsed, maximized, setMaximized, hostsAssetPanel: true }),
-    [collapsed, maximized, setCollapsed, setMaximized]
+    () => ({
+      collapsed,
+      setCollapsed,
+      defaultCollapsed: defaultWorkbenchCollapsed,
+      maximized,
+      setMaximized,
+      hostsAssetPanel: true
+    }),
+    [collapsed, defaultWorkbenchCollapsed, maximized, setCollapsed, setMaximized]
   );
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { ref: containerRef, className: "flex h-full w-full", children: [
     /* @__PURE__ */ jsxRuntime.jsx(

package/dist/assets/AthenaLayout.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaLayout.cjs","sources":["../../src/assets/AthenaLayout.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  type FC,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { cn } from \"../lib/utils\";\nimport {\n  WorkbenchLayoutContext,\n  type WorkbenchLayoutState,\n} from \"../workbench/workbench-layout-context\";\nimport { useAssetPanelStore } from \"./asset-panel-store\";\nimport { AssetPanel } from \"./AssetPanel\";\n\nexport interface AthenaLayoutProps {\n  children: ReactNode;\n  /** Default width (%) of the chat panel when assets are open. Defaults to 50. */\n  defaultChatPercent?: number;\n  /** Minimum width (%) of each panel. Defaults to 25. */\n  minPercent?: number;\n  /**\n   * A right-hand workspace column beside the chat — typically\n   * `<SessionWorkbench />`. It is always shown (collapsible to a rail,\n   * maximizable over the chat, and resizable by its edge), and the assets the agent or the person opens\n   * render inside it as its \"Open assets\" tab instead of in a column of their\n   * own.\n   */\n  workbench?: ReactNode;\n  /** Default width (%) of the workbench column. Defaults to 40. */\n  defaultWorkbenchPercent?: number;\n  /** Start with the workbench collapsed to its rail. Defaults to `false`. */\n  defaultWorkbenchCollapsed?: boolean;\n}\n\n/** Drag-to-resize for a split: the pointer's x as a share of the container. */\nfunction useSplitDrag({\n  onPercent,\n}: {\n  /** Called with the pointer's x position as a percentage of the container width. */\n  onPercent: (percentFromLeft: number) => void;\n}) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const dragging = useRef(false);\n  const onPointerDown = useCallback((e: React.PointerEvent) => {\n    e.preventDefault();\n    dragging.current = true;\n    (e.target as HTMLElement).setPointerCapture(e.pointerId);\n  }, []);\n  const onPointerMove = useCallback(\n    (e: React.PointerEvent) => {\n      if (!dragging.current || !containerRef.current) return;\n      const rect = containerRef.current.getBoundingClientRect();\n      onPercent(((e.clientX - rect.left) / rect.width) * 100);\n    },\n    [onPercent],\n  );\n  const onPointerUp = useCallback(() => {\n    dragging.current = false;\n  }, []);\n  return { containerRef, handlers: { onPointerDown, onPointerMove, onPointerUp } };\n}\n\nconst RESIZE_HANDLE_CLASS =\n  \"athena-sdk-chrome flex h-full w-1 shrink-0 cursor-col-resize items-center bg-border/40 transition-colors hover:bg-border active:bg-primary/30\";\n\n/**\n * Layout that places the chat on the left and the asset panel on the right.\n * When no assets are open, the chat takes full width. Includes a draggable resize handle.\n * With `workbench`, the right-hand column is the workbench instead (see the prop).\n */\nexport const AthenaLayout: FC<AthenaLayoutProps> = ({ workbench, ...props }) => {\n  const registerAssetPanelHost = useAssetPanelStore((s) => s.registerAssetPanelHost);\n  const unregisterAssetPanelHost = useAssetPanelStore((s) => s.unregisterAssetPanelHost);\n\n  useEffect(() => {\n    registerAssetPanelHost();\n    return () => {\n      unregisterAssetPanelHost();\n    };\n  }, [registerAssetPanelHost, unregisterAssetPanelHost]);\n\n  return workbench === undefined || workbench === null ? (\n    <AssetSplitLayout {...props} />\n  ) : (\n    <WorkbenchSplitLayout {...props} workbench={workbench} />\n  );\n};\n\nconst AssetSplitLayout: FC<Omit<AthenaLayoutProps, \"workbench\">> = ({\n  children,\n  defaultChatPercent = 50,\n  minPercent = 25,\n}) => {\n  const isOpen = useAssetPanelStore((s) => s.isOpen);\n  const [chatPercent, setChatPercent] = useState(defaultChatPercent);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) => setChatPercent(Math.max(minPercent, Math.min(100 - minPercent, pct))),\n      [minPercent],\n    ),\n  });\n\n  if (!isOpen) {\n    return <div className=\"flex h-full w-full flex-col\">{children}</div>;\n  }\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      <div\n        className=\"flex h-full flex-col overflow-hidden\"\n        style={{ width: `${chatPercent}%` }}\n      >\n        {children}\n      </div>\n      <div className={RESIZE_HANDLE_CLASS} {...handlers} />\n      <div className=\"athena-sdk-chrome flex h-full flex-1 flex-col overflow-hidden\">\n        <AssetPanel manageAssetPanelHostRegistration={false} />\n      </div>\n    </div>\n  );\n};\n\nconst WorkbenchSplitLayout: FC<\n  Omit<AthenaLayoutProps, \"workbench\" | \"defaultChatPercent\"> & { workbench: ReactNode }\n> = ({\n  children,\n  workbench,\n  minPercent = 25,\n  defaultWorkbenchPercent = 40,\n  defaultWorkbenchCollapsed = false,\n}) => {\n  const [workbenchPercent, setWorkbenchPercent] = useState(defaultWorkbenchPercent);\n  const [collapsed, setCollapsedState] = useState(defaultWorkbenchCollapsed);\n  const [maximizedState, setMaximizedState] = useState(false);\n  // A rail is never maximized: collapsing restores the chat beside it.\n  const maximized = maximizedState && !collapsed;\n  const setCollapsed = useCallback((next: boolean) => {\n    setCollapsedState(next);\n    if (next) setMaximizedState(false);\n  }, []);\n  const setMaximized = useCallback((next: boolean) => {\n    setMaximizedState(next);\n    if (next) setCollapsedState(false);\n  }, []);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) =>\n        setWorkbenchPercent(Math.max(minPercent, Math.min(100 - minPercent, 100 - pct))),\n      [minPercent],\n    ),\n  });\n  const layoutState = useMemo<WorkbenchLayoutState>(\n    () => ({ collapsed, setCollapsed, maximized, setMaximized, hostsAssetPanel: true }),\n    [collapsed, maximized, setCollapsed, setMaximized],\n  );\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      {/* Hidden, not unmounted, while the workbench is maximized: the chat keeps its thread and draft. */}\n      <div\n        className={cn(\"flex h-full min-w-0 flex-1 flex-col overflow-hidden\", maximized && \"hidden\")}\n      >\n        {children}\n      </div>\n      {collapsed || maximized ? null : (\n        <div\n          role=\"separator\"\n          aria-orientation=\"vertical\"\n          aria-label=\"Resize workspace\"\n          className={RESIZE_HANDLE_CLASS}\n          {...handlers}\n        />\n      )}\n      <div\n        className={cn(\n          \"flex h-full shrink-0 flex-col overflow-hidden\",\n          collapsed && \"w-10\",\n          maximized && \"min-w-0 flex-1\",\n        )}\n        // The dragged width is a runtime percentage — no static utility expresses it.\n        style={collapsed || maximized ? undefined : { width: `${workbenchPercent}%` }}\n      >\n        <WorkbenchLayoutContext.Provider value={layoutState}>\n          {workbench}\n        </WorkbenchLayoutContext.Provider>\n      </div>\n    </div>\n  );\n};\n"],"names":["useRef","useCallback","useAssetPanelStore","useEffect","jsx","useState","jsxs","AssetPanel","useMemo","cn","WorkbenchLayoutContext"],"mappings":"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"}
+{"version":3,"file":"AthenaLayout.cjs","sources":["../../src/assets/AthenaLayout.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  type FC,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { cn } from \"../lib/utils\";\nimport {\n  WorkbenchLayoutContext,\n  type WorkbenchLayoutState,\n} from \"../workbench/workbench-layout-context\";\nimport { useAssetPanelStore } from \"./asset-panel-store\";\nimport { AssetPanel } from \"./AssetPanel\";\n\nexport interface AthenaLayoutProps {\n  children: ReactNode;\n  /** Default width (%) of the chat panel when assets are open. Defaults to 50. */\n  defaultChatPercent?: number;\n  /** Minimum width (%) of each panel. Defaults to 25. */\n  minPercent?: number;\n  /**\n   * A right-hand workspace column beside the chat — typically\n   * `<SessionWorkbench />`. It is always shown (collapsible to a rail,\n   * maximizable over the chat, and resizable by its edge), and the assets the agent or the person opens\n   * render inside it as its \"Open assets\" tab instead of in a column of their\n   * own.\n   */\n  workbench?: ReactNode;\n  /** Default width (%) of the workbench column. Defaults to 40. */\n  defaultWorkbenchPercent?: number;\n  /**\n   * Whether a session's workbench starts collapsed to its rail. Each session\n   * keeps its own open or collapsed workbench while the layout stays mounted,\n   * as it keeps its own tabs, so this is how every session the person has not\n   * opened it in shows it — a new one, or one switched to. Defaults to `false`.\n   */\n  defaultWorkbenchCollapsed?: boolean;\n}\n\n/** Drag-to-resize for a split: the pointer's x as a share of the container. */\nfunction useSplitDrag({\n  onPercent,\n}: {\n  /** Called with the pointer's x position as a percentage of the container width. */\n  onPercent: (percentFromLeft: number) => void;\n}) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const dragging = useRef(false);\n  const onPointerDown = useCallback((e: React.PointerEvent) => {\n    e.preventDefault();\n    dragging.current = true;\n    (e.target as HTMLElement).setPointerCapture(e.pointerId);\n  }, []);\n  const onPointerMove = useCallback(\n    (e: React.PointerEvent) => {\n      if (!dragging.current || !containerRef.current) return;\n      const rect = containerRef.current.getBoundingClientRect();\n      onPercent(((e.clientX - rect.left) / rect.width) * 100);\n    },\n    [onPercent],\n  );\n  const onPointerUp = useCallback(() => {\n    dragging.current = false;\n  }, []);\n  return { containerRef, handlers: { onPointerDown, onPointerMove, onPointerUp } };\n}\n\nconst RESIZE_HANDLE_CLASS =\n  \"athena-sdk-chrome flex h-full w-1 shrink-0 cursor-col-resize items-center bg-border/40 transition-colors hover:bg-border active:bg-primary/30\";\n\n/**\n * Layout that places the chat on the left and the asset panel on the right.\n * When no assets are open, the chat takes full width. Includes a draggable resize handle.\n * With `workbench`, the right-hand column is the workbench instead (see the prop).\n */\nexport const AthenaLayout: FC<AthenaLayoutProps> = ({ workbench, ...props }) => {\n  const registerAssetPanelHost = useAssetPanelStore((s) => s.registerAssetPanelHost);\n  const unregisterAssetPanelHost = useAssetPanelStore((s) => s.unregisterAssetPanelHost);\n\n  useEffect(() => {\n    registerAssetPanelHost();\n    return () => {\n      unregisterAssetPanelHost();\n    };\n  }, [registerAssetPanelHost, unregisterAssetPanelHost]);\n\n  return workbench === undefined || workbench === null ? (\n    <AssetSplitLayout {...props} />\n  ) : (\n    <WorkbenchSplitLayout {...props} workbench={workbench} />\n  );\n};\n\nconst AssetSplitLayout: FC<Omit<AthenaLayoutProps, \"workbench\">> = ({\n  children,\n  defaultChatPercent = 50,\n  minPercent = 25,\n}) => {\n  const isOpen = useAssetPanelStore((s) => s.isOpen);\n  const [chatPercent, setChatPercent] = useState(defaultChatPercent);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) => setChatPercent(Math.max(minPercent, Math.min(100 - minPercent, pct))),\n      [minPercent],\n    ),\n  });\n\n  if (!isOpen) {\n    return <div className=\"flex h-full w-full flex-col\">{children}</div>;\n  }\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      <div\n        className=\"flex h-full flex-col overflow-hidden\"\n        style={{ width: `${chatPercent}%` }}\n      >\n        {children}\n      </div>\n      <div className={RESIZE_HANDLE_CLASS} {...handlers} />\n      <div className=\"athena-sdk-chrome flex h-full flex-1 flex-col overflow-hidden\">\n        <AssetPanel manageAssetPanelHostRegistration={false} />\n      </div>\n    </div>\n  );\n};\n\nconst WorkbenchSplitLayout: FC<\n  Omit<AthenaLayoutProps, \"workbench\" | \"defaultChatPercent\"> & { workbench: ReactNode }\n> = ({\n  children,\n  workbench,\n  minPercent = 25,\n  defaultWorkbenchPercent = 40,\n  defaultWorkbenchCollapsed = false,\n}) => {\n  const [workbenchPercent, setWorkbenchPercent] = useState(defaultWorkbenchPercent);\n  const [collapsed, setCollapsedState] = useState(defaultWorkbenchCollapsed);\n  const [maximizedState, setMaximizedState] = useState(false);\n  // A rail is never maximized: collapsing restores the chat beside it.\n  const maximized = maximizedState && !collapsed;\n  const setCollapsed = useCallback((next: boolean) => {\n    setCollapsedState(next);\n    if (next) setMaximizedState(false);\n  }, []);\n  const setMaximized = useCallback((next: boolean) => {\n    setMaximizedState(next);\n    if (next) setCollapsedState(false);\n  }, []);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) =>\n        setWorkbenchPercent(Math.max(minPercent, Math.min(100 - minPercent, 100 - pct))),\n      [minPercent],\n    ),\n  });\n  const layoutState = useMemo<WorkbenchLayoutState>(\n    () => ({\n      collapsed,\n      setCollapsed,\n      defaultCollapsed: defaultWorkbenchCollapsed,\n      maximized,\n      setMaximized,\n      hostsAssetPanel: true,\n    }),\n    [collapsed, defaultWorkbenchCollapsed, maximized, setCollapsed, setMaximized],\n  );\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      {/* Hidden, not unmounted, while the workbench is maximized: the chat keeps its thread and draft. */}\n      <div\n        className={cn(\"flex h-full min-w-0 flex-1 flex-col overflow-hidden\", maximized && \"hidden\")}\n      >\n        {children}\n      </div>\n      {collapsed || maximized ? null : (\n        <div\n          role=\"separator\"\n          aria-orientation=\"vertical\"\n          aria-label=\"Resize workspace\"\n          className={RESIZE_HANDLE_CLASS}\n          {...handlers}\n        />\n      )}\n      <div\n        className={cn(\n          \"flex h-full shrink-0 flex-col overflow-hidden\",\n          collapsed && \"w-10\",\n          maximized && \"min-w-0 flex-1\",\n        )}\n        // The dragged width is a runtime percentage — no static utility expresses it.\n        style={collapsed || maximized ? undefined : { width: `${workbenchPercent}%` }}\n      >\n        <WorkbenchLayoutContext.Provider value={layoutState}>\n          {workbench}\n        </WorkbenchLayoutContext.Provider>\n      </div>\n    </div>\n  );\n};\n"],"names":["useRef","useCallback","useAssetPanelStore","useEffect","jsx","useState","jsxs","AssetPanel","useMemo","cn","WorkbenchLayoutContext"],"mappings":"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"}

package/dist/assets/AthenaLayout.d.ts

@@ -15,7 +15,12 @@ export interface AthenaLayoutProps {
     workbench?: ReactNode;
     /** Default width (%) of the workbench column. Defaults to 40. */
     defaultWorkbenchPercent?: number;
-    /** Start with the workbench collapsed to its rail. Defaults to `false`. */
+    /**
+     * Whether a session's workbench starts collapsed to its rail. Each session
+     * keeps its own open or collapsed workbench while the layout stays mounted,
+     * as it keeps its own tabs, so this is how every session the person has not
+     * opened it in shows it — a new one, or one switched to. Defaults to `false`.
+     */
     defaultWorkbenchCollapsed?: boolean;
 }
 /**

package/dist/assets/AthenaLayout.js

@@ -94,8 +94,15 @@ const WorkbenchSplitLayout = ({
     )
   });
   const layoutState = useMemo(
-    () => ({ collapsed, setCollapsed, maximized, setMaximized, hostsAssetPanel: true }),
-    [collapsed, maximized, setCollapsed, setMaximized]
+    () => ({
+      collapsed,
+      setCollapsed,
+      defaultCollapsed: defaultWorkbenchCollapsed,
+      maximized,
+      setMaximized,
+      hostsAssetPanel: true
+    }),
+    [collapsed, defaultWorkbenchCollapsed, maximized, setCollapsed, setMaximized]
   );
   return /* @__PURE__ */ jsxs("div", { ref: containerRef, className: "flex h-full w-full", children: [
     /* @__PURE__ */ jsx(

package/dist/assets/AthenaLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaLayout.js","sources":["../../src/assets/AthenaLayout.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  type FC,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { cn } from \"../lib/utils\";\nimport {\n  WorkbenchLayoutContext,\n  type WorkbenchLayoutState,\n} from \"../workbench/workbench-layout-context\";\nimport { useAssetPanelStore } from \"./asset-panel-store\";\nimport { AssetPanel } from \"./AssetPanel\";\n\nexport interface AthenaLayoutProps {\n  children: ReactNode;\n  /** Default width (%) of the chat panel when assets are open. Defaults to 50. */\n  defaultChatPercent?: number;\n  /** Minimum width (%) of each panel. Defaults to 25. */\n  minPercent?: number;\n  /**\n   * A right-hand workspace column beside the chat — typically\n   * `<SessionWorkbench />`. It is always shown (collapsible to a rail,\n   * maximizable over the chat, and resizable by its edge), and the assets the agent or the person opens\n   * render inside it as its \"Open assets\" tab instead of in a column of their\n   * own.\n   */\n  workbench?: ReactNode;\n  /** Default width (%) of the workbench column. Defaults to 40. */\n  defaultWorkbenchPercent?: number;\n  /** Start with the workbench collapsed to its rail. Defaults to `false`. */\n  defaultWorkbenchCollapsed?: boolean;\n}\n\n/** Drag-to-resize for a split: the pointer's x as a share of the container. */\nfunction useSplitDrag({\n  onPercent,\n}: {\n  /** Called with the pointer's x position as a percentage of the container width. */\n  onPercent: (percentFromLeft: number) => void;\n}) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const dragging = useRef(false);\n  const onPointerDown = useCallback((e: React.PointerEvent) => {\n    e.preventDefault();\n    dragging.current = true;\n    (e.target as HTMLElement).setPointerCapture(e.pointerId);\n  }, []);\n  const onPointerMove = useCallback(\n    (e: React.PointerEvent) => {\n      if (!dragging.current || !containerRef.current) return;\n      const rect = containerRef.current.getBoundingClientRect();\n      onPercent(((e.clientX - rect.left) / rect.width) * 100);\n    },\n    [onPercent],\n  );\n  const onPointerUp = useCallback(() => {\n    dragging.current = false;\n  }, []);\n  return { containerRef, handlers: { onPointerDown, onPointerMove, onPointerUp } };\n}\n\nconst RESIZE_HANDLE_CLASS =\n  \"athena-sdk-chrome flex h-full w-1 shrink-0 cursor-col-resize items-center bg-border/40 transition-colors hover:bg-border active:bg-primary/30\";\n\n/**\n * Layout that places the chat on the left and the asset panel on the right.\n * When no assets are open, the chat takes full width. Includes a draggable resize handle.\n * With `workbench`, the right-hand column is the workbench instead (see the prop).\n */\nexport const AthenaLayout: FC<AthenaLayoutProps> = ({ workbench, ...props }) => {\n  const registerAssetPanelHost = useAssetPanelStore((s) => s.registerAssetPanelHost);\n  const unregisterAssetPanelHost = useAssetPanelStore((s) => s.unregisterAssetPanelHost);\n\n  useEffect(() => {\n    registerAssetPanelHost();\n    return () => {\n      unregisterAssetPanelHost();\n    };\n  }, [registerAssetPanelHost, unregisterAssetPanelHost]);\n\n  return workbench === undefined || workbench === null ? (\n    <AssetSplitLayout {...props} />\n  ) : (\n    <WorkbenchSplitLayout {...props} workbench={workbench} />\n  );\n};\n\nconst AssetSplitLayout: FC<Omit<AthenaLayoutProps, \"workbench\">> = ({\n  children,\n  defaultChatPercent = 50,\n  minPercent = 25,\n}) => {\n  const isOpen = useAssetPanelStore((s) => s.isOpen);\n  const [chatPercent, setChatPercent] = useState(defaultChatPercent);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) => setChatPercent(Math.max(minPercent, Math.min(100 - minPercent, pct))),\n      [minPercent],\n    ),\n  });\n\n  if (!isOpen) {\n    return <div className=\"flex h-full w-full flex-col\">{children}</div>;\n  }\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      <div\n        className=\"flex h-full flex-col overflow-hidden\"\n        style={{ width: `${chatPercent}%` }}\n      >\n        {children}\n      </div>\n      <div className={RESIZE_HANDLE_CLASS} {...handlers} />\n      <div className=\"athena-sdk-chrome flex h-full flex-1 flex-col overflow-hidden\">\n        <AssetPanel manageAssetPanelHostRegistration={false} />\n      </div>\n    </div>\n  );\n};\n\nconst WorkbenchSplitLayout: FC<\n  Omit<AthenaLayoutProps, \"workbench\" | \"defaultChatPercent\"> & { workbench: ReactNode }\n> = ({\n  children,\n  workbench,\n  minPercent = 25,\n  defaultWorkbenchPercent = 40,\n  defaultWorkbenchCollapsed = false,\n}) => {\n  const [workbenchPercent, setWorkbenchPercent] = useState(defaultWorkbenchPercent);\n  const [collapsed, setCollapsedState] = useState(defaultWorkbenchCollapsed);\n  const [maximizedState, setMaximizedState] = useState(false);\n  // A rail is never maximized: collapsing restores the chat beside it.\n  const maximized = maximizedState && !collapsed;\n  const setCollapsed = useCallback((next: boolean) => {\n    setCollapsedState(next);\n    if (next) setMaximizedState(false);\n  }, []);\n  const setMaximized = useCallback((next: boolean) => {\n    setMaximizedState(next);\n    if (next) setCollapsedState(false);\n  }, []);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) =>\n        setWorkbenchPercent(Math.max(minPercent, Math.min(100 - minPercent, 100 - pct))),\n      [minPercent],\n    ),\n  });\n  const layoutState = useMemo<WorkbenchLayoutState>(\n    () => ({ collapsed, setCollapsed, maximized, setMaximized, hostsAssetPanel: true }),\n    [collapsed, maximized, setCollapsed, setMaximized],\n  );\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      {/* Hidden, not unmounted, while the workbench is maximized: the chat keeps its thread and draft. */}\n      <div\n        className={cn(\"flex h-full min-w-0 flex-1 flex-col overflow-hidden\", maximized && \"hidden\")}\n      >\n        {children}\n      </div>\n      {collapsed || maximized ? null : (\n        <div\n          role=\"separator\"\n          aria-orientation=\"vertical\"\n          aria-label=\"Resize workspace\"\n          className={RESIZE_HANDLE_CLASS}\n          {...handlers}\n        />\n      )}\n      <div\n        className={cn(\n          \"flex h-full shrink-0 flex-col overflow-hidden\",\n          collapsed && \"w-10\",\n          maximized && \"min-w-0 flex-1\",\n        )}\n        // The dragged width is a runtime percentage — no static utility expresses it.\n        style={collapsed || maximized ? undefined : { width: `${workbenchPercent}%` }}\n      >\n        <WorkbenchLayoutContext.Provider value={layoutState}>\n          {workbench}\n        </WorkbenchLayoutContext.Provider>\n      </div>\n    </div>\n  );\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"AthenaLayout.js","sources":["../../src/assets/AthenaLayout.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  type FC,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { cn } from \"../lib/utils\";\nimport {\n  WorkbenchLayoutContext,\n  type WorkbenchLayoutState,\n} from \"../workbench/workbench-layout-context\";\nimport { useAssetPanelStore } from \"./asset-panel-store\";\nimport { AssetPanel } from \"./AssetPanel\";\n\nexport interface AthenaLayoutProps {\n  children: ReactNode;\n  /** Default width (%) of the chat panel when assets are open. Defaults to 50. */\n  defaultChatPercent?: number;\n  /** Minimum width (%) of each panel. Defaults to 25. */\n  minPercent?: number;\n  /**\n   * A right-hand workspace column beside the chat — typically\n   * `<SessionWorkbench />`. It is always shown (collapsible to a rail,\n   * maximizable over the chat, and resizable by its edge), and the assets the agent or the person opens\n   * render inside it as its \"Open assets\" tab instead of in a column of their\n   * own.\n   */\n  workbench?: ReactNode;\n  /** Default width (%) of the workbench column. Defaults to 40. */\n  defaultWorkbenchPercent?: number;\n  /**\n   * Whether a session's workbench starts collapsed to its rail. Each session\n   * keeps its own open or collapsed workbench while the layout stays mounted,\n   * as it keeps its own tabs, so this is how every session the person has not\n   * opened it in shows it — a new one, or one switched to. Defaults to `false`.\n   */\n  defaultWorkbenchCollapsed?: boolean;\n}\n\n/** Drag-to-resize for a split: the pointer's x as a share of the container. */\nfunction useSplitDrag({\n  onPercent,\n}: {\n  /** Called with the pointer's x position as a percentage of the container width. */\n  onPercent: (percentFromLeft: number) => void;\n}) {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const dragging = useRef(false);\n  const onPointerDown = useCallback((e: React.PointerEvent) => {\n    e.preventDefault();\n    dragging.current = true;\n    (e.target as HTMLElement).setPointerCapture(e.pointerId);\n  }, []);\n  const onPointerMove = useCallback(\n    (e: React.PointerEvent) => {\n      if (!dragging.current || !containerRef.current) return;\n      const rect = containerRef.current.getBoundingClientRect();\n      onPercent(((e.clientX - rect.left) / rect.width) * 100);\n    },\n    [onPercent],\n  );\n  const onPointerUp = useCallback(() => {\n    dragging.current = false;\n  }, []);\n  return { containerRef, handlers: { onPointerDown, onPointerMove, onPointerUp } };\n}\n\nconst RESIZE_HANDLE_CLASS =\n  \"athena-sdk-chrome flex h-full w-1 shrink-0 cursor-col-resize items-center bg-border/40 transition-colors hover:bg-border active:bg-primary/30\";\n\n/**\n * Layout that places the chat on the left and the asset panel on the right.\n * When no assets are open, the chat takes full width. Includes a draggable resize handle.\n * With `workbench`, the right-hand column is the workbench instead (see the prop).\n */\nexport const AthenaLayout: FC<AthenaLayoutProps> = ({ workbench, ...props }) => {\n  const registerAssetPanelHost = useAssetPanelStore((s) => s.registerAssetPanelHost);\n  const unregisterAssetPanelHost = useAssetPanelStore((s) => s.unregisterAssetPanelHost);\n\n  useEffect(() => {\n    registerAssetPanelHost();\n    return () => {\n      unregisterAssetPanelHost();\n    };\n  }, [registerAssetPanelHost, unregisterAssetPanelHost]);\n\n  return workbench === undefined || workbench === null ? (\n    <AssetSplitLayout {...props} />\n  ) : (\n    <WorkbenchSplitLayout {...props} workbench={workbench} />\n  );\n};\n\nconst AssetSplitLayout: FC<Omit<AthenaLayoutProps, \"workbench\">> = ({\n  children,\n  defaultChatPercent = 50,\n  minPercent = 25,\n}) => {\n  const isOpen = useAssetPanelStore((s) => s.isOpen);\n  const [chatPercent, setChatPercent] = useState(defaultChatPercent);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) => setChatPercent(Math.max(minPercent, Math.min(100 - minPercent, pct))),\n      [minPercent],\n    ),\n  });\n\n  if (!isOpen) {\n    return <div className=\"flex h-full w-full flex-col\">{children}</div>;\n  }\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      <div\n        className=\"flex h-full flex-col overflow-hidden\"\n        style={{ width: `${chatPercent}%` }}\n      >\n        {children}\n      </div>\n      <div className={RESIZE_HANDLE_CLASS} {...handlers} />\n      <div className=\"athena-sdk-chrome flex h-full flex-1 flex-col overflow-hidden\">\n        <AssetPanel manageAssetPanelHostRegistration={false} />\n      </div>\n    </div>\n  );\n};\n\nconst WorkbenchSplitLayout: FC<\n  Omit<AthenaLayoutProps, \"workbench\" | \"defaultChatPercent\"> & { workbench: ReactNode }\n> = ({\n  children,\n  workbench,\n  minPercent = 25,\n  defaultWorkbenchPercent = 40,\n  defaultWorkbenchCollapsed = false,\n}) => {\n  const [workbenchPercent, setWorkbenchPercent] = useState(defaultWorkbenchPercent);\n  const [collapsed, setCollapsedState] = useState(defaultWorkbenchCollapsed);\n  const [maximizedState, setMaximizedState] = useState(false);\n  // A rail is never maximized: collapsing restores the chat beside it.\n  const maximized = maximizedState && !collapsed;\n  const setCollapsed = useCallback((next: boolean) => {\n    setCollapsedState(next);\n    if (next) setMaximizedState(false);\n  }, []);\n  const setMaximized = useCallback((next: boolean) => {\n    setMaximizedState(next);\n    if (next) setCollapsedState(false);\n  }, []);\n  const { containerRef, handlers } = useSplitDrag({\n    onPercent: useCallback(\n      (pct: number) =>\n        setWorkbenchPercent(Math.max(minPercent, Math.min(100 - minPercent, 100 - pct))),\n      [minPercent],\n    ),\n  });\n  const layoutState = useMemo<WorkbenchLayoutState>(\n    () => ({\n      collapsed,\n      setCollapsed,\n      defaultCollapsed: defaultWorkbenchCollapsed,\n      maximized,\n      setMaximized,\n      hostsAssetPanel: true,\n    }),\n    [collapsed, defaultWorkbenchCollapsed, maximized, setCollapsed, setMaximized],\n  );\n\n  return (\n    <div ref={containerRef} className=\"flex h-full w-full\">\n      {/* Hidden, not unmounted, while the workbench is maximized: the chat keeps its thread and draft. */}\n      <div\n        className={cn(\"flex h-full min-w-0 flex-1 flex-col overflow-hidden\", maximized && \"hidden\")}\n      >\n        {children}\n      </div>\n      {collapsed || maximized ? null : (\n        <div\n          role=\"separator\"\n          aria-orientation=\"vertical\"\n          aria-label=\"Resize workspace\"\n          className={RESIZE_HANDLE_CLASS}\n          {...handlers}\n        />\n      )}\n      <div\n        className={cn(\n          \"flex h-full shrink-0 flex-col overflow-hidden\",\n          collapsed && \"w-10\",\n          maximized && \"min-w-0 flex-1\",\n        )}\n        // The dragged width is a runtime percentage — no static utility expresses it.\n        style={collapsed || maximized ? undefined : { width: `${workbenchPercent}%` }}\n      >\n        <WorkbenchLayoutContext.Provider value={layoutState}>\n          {workbench}\n        </WorkbenchLayoutContext.Provider>\n      </div>\n    </div>\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/auth/AthenaSSOProvider.cjs

@@ -1,8 +1,129 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
+const reactQuery = require("@tanstack/react-query");
 const react = require("react");
+const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
+const errors = require("../diagnostics/errors.cjs");
+const auth = require("../runtime/auth.cjs");
 const AthenaAuthContext = require("./AthenaAuthContext.cjs");
+const SSO_USERINFO_RETRY_POLICY = {
+  ...auth.DEFAULT_MINT_RETRY_POLICY,
+  timeoutMs: 1e4
+};
+const abortError = () => new DOMException("The session read was cancelled.", "AbortError");
+async function readUserInfoOnce({
+  url,
+  signal,
+  timeoutMs
+}) {
+  if (signal.aborted) throw abortError();
+  const request = new AbortController();
+  const cancel = () => request.abort();
+  signal.addEventListener("abort", cancel, { once: true });
+  let timedOut = false;
+  const timer = setTimeout(() => {
+    timedOut = true;
+    request.abort();
+  }, timeoutMs);
+  try {
+    const response = await fetch(url, { credentials: "include", signal: request.signal });
+    if (response.status === 401 || response.status === 403) return { kind: "unauthenticated" };
+    if (!response.ok) {
+      return auth.isRetryableMintStatus(response.status) ? { kind: "transient", status: response.status, reason: "status" } : { kind: "failed", status: response.status };
+    }
+    let data;
+    try {
+      data = await response.json();
+    } catch (error) {
+      if (signal.aborted) throw abortError();
+      return timedOut ? { kind: "transient", status: null, reason: "timeout", cause: error } : { kind: "failed", status: response.status };
+    }
+    return isValidSSOUserInfo(data) ? { kind: "session", data } : { kind: "invalid_response" };
+  } catch (error) {
+    if (signal.aborted) throw abortError();
+    return { kind: "transient", status: null, reason: timedOut ? "timeout" : "network", cause: error };
+  } finally {
+    clearTimeout(timer);
+    signal.removeEventListener("abort", cancel);
+  }
+}
+async function readSession({
+  url,
+  signal,
+  policy
+}) {
+  const maxAttempts = Math.max(1, Math.floor(policy.maxAttempts));
+  for (let attempts = 1; ; attempts += 1) {
+    const attempt = await readUserInfoOnce({ url, signal, timeoutMs: policy.timeoutMs });
+    if (attempt.kind === "session") return { kind: "session", data: attempt.data };
+    if (attempt.kind === "unauthenticated") return { kind: "no_session", reason: "unauthenticated" };
+    if (attempt.kind === "invalid_response") {
+      console.error(
+        '[AthenaSDK] Invalid SSO userinfo response: expected "user.user_id", "user.email", "orgMemberInfos", and "accessToken"'
+      );
+      return { kind: "no_session", reason: "invalid_response" };
+    }
+    if (attempt.kind === "transient" && attempts < maxAttempts) {
+      const delayMs = auth.getMintRetryDelay({ retry: attempts, policy });
+      athenaDiagnostics.athenaDiagnostics.emit("auth.sso.userinfo.retry", {
+        level: "warn",
+        data: {
+          status: attempt.status,
+          reason: attempt.reason,
+          attempt: attempts,
+          max_attempts: maxAttempts,
+          delay_ms: delayMs
+        }
+      });
+      await waitBeforeRetry({ delayMs, signal });
+      continue;
+    }
+    throw sessionReadError({ url, attempt, attempts });
+  }
+}
+function waitBeforeRetry({ delayMs, signal }) {
+  return new Promise((resolve, reject) => {
+    if (signal.aborted) {
+      reject(abortError());
+      return;
+    }
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(abortError());
+    };
+    const timer = setTimeout(() => {
+      signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, delayMs);
+    signal.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function sessionReadError({
+  url,
+  attempt,
+  attempts
+}) {
+  if (attempt.kind === "failed") {
+    const unreadable = attempt.status >= 200 && attempt.status < 300;
+    return new errors.AthenaSdkError({
+      code: "auth_sso_failed",
+      message: unreadable ? `The SSO session read (${url}) answered HTTP ${attempt.status} without a JSON body.` : `The SSO session read (${url}) answered HTTP ${attempt.status}.`,
+      hint: "Check that ssoBaseUrl / ssoUserInfoUrl point at the SSO userinfo endpoint.",
+      status: attempt.status,
+      context: { attempts, reason: unreadable ? "invalid_body" : "status" }
+    });
+  }
+  const answer = attempt.status !== null ? `HTTP ${attempt.status}` : attempt.reason === "timeout" ? "a timeout" : "a network error";
+  return new errors.AthenaSdkError({
+    code: "auth_sso_failed",
+    message: `The SSO session read (${url}) failed ${attempts} time${attempts === 1 ? "" : "s"} (last: ${answer}).`,
+    hint: "The sign-in service did not answer; the person may still be signed in. Offer a retry (displayOnError receives retry).",
+    ...attempt.status !== null && { status: attempt.status },
+    ...attempt.cause !== void 0 && { cause: attempt.cause },
+    context: { attempts, reason: attempt.reason }
+  });
+}
 const DEFAULT_SSO_PATHS = {
   userInfo: "/api/sso/userinfo",
   login: "/api/sso/initiate",
@@ -54,13 +175,15 @@ function AthenaSSOProvider({
   ssoLogoutUrl,
   displayWhileLoading,
   displayOnError,
-  revalidateOnWindowFocus = false
+  onError,
+  revalidateOnWindowFocus = false,
+  retryPolicy = SSO_USERINFO_RETRY_POLICY
 }) {
-  const [ssoData, setSSOData] = react.useState(null);
-  const [loading, setLoading] = react.useState(true);
-  const [error, setError] = react.useState(null);
-  const activeRequestRef = react.useRef(null);
-  const activeReadRef = react.useRef(null);
+  const [queryClient] = react.useState(() => new reactQuery.QueryClient());
+  const retryPolicyRef = react.useRef(retryPolicy);
+  retryPolicyRef.current = retryPolicy;
+  const onErrorRef = react.useRef(onError);
+  onErrorRef.current = onError;
   const ssoUrls = react.useMemo(
     () => ({
       userInfo: resolveSSOUrl({
@@ -81,101 +204,75 @@ function AthenaSSOProvider({
     }),
     [ssoBaseUrl, ssoUserInfoUrl, ssoLoginUrl, ssoLogoutUrl]
   );
-  const refreshSession = react.useCallback(
-    ({ showLoading = false } = {}) => {
+  const queryKey = react.useMemo(() => ["athena-sdk", "sso-session", ssoUrls.userInfo], [ssoUrls.userInfo]);
+  const queryFn = react.useCallback(
+    async ({ signal }) => {
       var _a;
-      (_a = activeRequestRef.current) == null ? void 0 : _a.abort();
-      const abortController = new AbortController();
-      activeRequestRef.current = abortController;
-      const read = (async () => {
-        if (showLoading) {
-          setLoading(true);
-          setError(null);
-          setSSOData(null);
-        }
-        try {
-          const response = await fetch(ssoUrls.userInfo, {
-            credentials: "include",
-            signal: abortController.signal
-          });
-          if (!response.ok) {
-            if (response.status === 401 || response.status === 403) {
-              setSSOData(null);
-              setError("unauthenticated");
-            } else {
-              setError("request_failed");
-            }
-            return null;
-          }
-          const data = await response.json();
-          if (!isValidSSOUserInfo(data)) {
-            console.error(
-              '[AthenaSDK] Invalid SSO userinfo response: expected "user.user_id", "user.email", "orgMemberInfos", and "accessToken"'
-            );
-            setSSOData(null);
-            setError("invalid_response");
-            return null;
-          }
-          setSSOData((prev) => {
-            if (prev && prev.accessToken === data.accessToken && prev.user.user_id === data.user.user_id) {
-              return prev;
-            }
-            return data;
-          });
-          setError(null);
-          return data;
-        } catch (fetchError) {
-          if (fetchError instanceof DOMException && fetchError.name === "AbortError") {
-            return activeRequestRef.current !== abortController ? activeReadRef.current : null;
-          }
-          setError("request_failed");
-          return null;
-        } finally {
-          if (activeRequestRef.current === abortController) {
-            activeRequestRef.current = null;
-            setLoading(false);
+      try {
+        return await readSession({ url: ssoUrls.userInfo, signal, policy: retryPolicyRef.current });
+      } catch (readError) {
+        if (readError instanceof errors.AthenaSdkError) {
+          athenaDiagnostics.athenaDiagnostics.emit("auth.sso.userinfo.error", { error: readError });
+          try {
+            (_a = onErrorRef.current) == null ? void 0 : _a.call(onErrorRef, readError);
+          } catch (callbackError) {
+            console.error("[AthenaSDK] AthenaSSOProvider onError threw", callbackError);
           }
         }
-      })();
-      activeReadRef.current = read;
-      return read;
+        throw readError;
+      }
     },
     [ssoUrls.userInfo]
   );
-  react.useEffect(() => {
-    void refreshSession({ showLoading: true });
-    return () => {
-      var _a;
-      (_a = activeRequestRef.current) == null ? void 0 : _a.abort();
-    };
-  }, [refreshSession]);
+  const query = reactQuery.useQuery(
+    {
+      queryKey,
+      queryFn,
+      // `readSession` retries a transient failure itself, with the bridge's
+      // policy; the query never retries on top of it, and reads while the
+      // browser reports itself offline too, so that policy decides.
+      retry: false,
+      networkMode: "always",
+      staleTime: Number.POSITIVE_INFINITY,
+      refetchOnWindowFocus: false,
+      refetchOnReconnect: false
+    },
+    queryClient
+  );
+  const answer = query.data;
+  const session = (answer == null ? void 0 : answer.kind) === "session" ? answer.data : null;
+  const loading = query.isPending;
+  const reason = session ? null : (answer == null ? void 0 : answer.kind) === "no_session" ? answer.reason : query.isError ? "request_failed" : null;
+  const signedOut = (answer == null ? void 0 : answer.kind) === "no_session" && answer.signedOut === true;
   react.useEffect(() => {
     if (!revalidateOnWindowFocus || typeof window === "undefined") {
       return;
     }
-    const handleFocus = () => {
-      void refreshSession();
+    const revalidate = () => {
+      void queryClient.refetchQueries({ queryKey }, { cancelRefetch: false });
     };
     const handleVisibilityChange = () => {
       if (document.visibilityState === "visible") {
-        void refreshSession();
+        revalidate();
       }
     };
-    window.addEventListener("focus", handleFocus);
+    window.addEventListener("focus", revalidate);
     document.addEventListener("visibilitychange", handleVisibilityChange);
     return () => {
-      window.removeEventListener("focus", handleFocus);
+      window.removeEventListener("focus", revalidate);
       document.removeEventListener("visibilitychange", handleVisibilityChange);
     };
-  }, [revalidateOnWindowFocus, refreshSession]);
+  }, [revalidateOnWindowFocus, queryClient, queryKey]);
   react.useEffect(() => {
-    if (!loading && error === "unauthenticated" && !displayOnError && typeof window !== "undefined") {
+    if (!loading && reason === "unauthenticated" && !signedOut && !displayOnError && typeof window !== "undefined") {
       window.location.assign(ssoUrls.login);
     }
-  }, [loading, error, displayOnError, ssoUrls.login]);
+  }, [loading, reason, signedOut, displayOnError, ssoUrls.login]);
+  const retry = react.useCallback(() => {
+    void queryClient.resetQueries({ queryKey });
+  }, [queryClient, queryKey]);
   const logout = react.useCallback(async (redirectOnLogout = true) => {
-    var _a;
-    (_a = activeRequestRef.current) == null ? void 0 : _a.abort();
+    await queryClient.cancelQueries({ queryKey });
     try {
       await fetch(ssoUrls.logout, {
         method: "POST",
@@ -184,25 +281,36 @@ function AthenaSSOProvider({
     } catch (logoutError) {
       console.error("[AthenaSDK] Failed to invalidate SSO session during logout", logoutError);
     }
-    setSSOData(null);
-    setError(null);
-    setLoading(false);
+    queryClient.setQueryData(queryKey, {
+      kind: "no_session",
+      reason: "unauthenticated",
+      signedOut: true
+    });
     if (redirectOnLogout && typeof window !== "undefined") {
       window.location.assign(ssoUrls.login);
     }
-  }, [ssoUrls.login, ssoUrls.logout]);
-  const ssoDataRef = react.useRef(ssoData);
-  ssoDataRef.current = ssoData;
+  }, [queryClient, queryKey, ssoUrls.login, ssoUrls.logout]);
+  const sessionRef = react.useRef(session);
+  sessionRef.current = session;
   const getToken = react.useCallback(
     async ({ force = false } = {}) => {
       var _a;
       if (force) {
-        const renewed = await refreshSession();
-        if (renewed) return renewed.accessToken;
+        try {
+          const renewed = await queryClient.fetchQuery({
+            queryKey,
+            queryFn,
+            staleTime: 0,
+            retry: false,
+            networkMode: "always"
+          });
+          if (renewed.kind === "session") return renewed.data.accessToken;
+        } catch {
+        }
       }
-      return ((_a = ssoDataRef.current) == null ? void 0 : _a.accessToken) ?? null;
+      return ((_a = sessionRef.current) == null ? void 0 : _a.accessToken) ?? null;
     },
-    [refreshSession]
+    [queryClient, queryKey, queryFn]
   );
   const authState = react.useMemo(() => {
     if (loading) {
@@ -217,19 +325,7 @@ function AthenaSSOProvider({
         getToken
       };
     }
-    if (error === "request_failed" && ssoData) {
-      const { user: user2, orgs: orgs2, accessToken: accessToken2 } = mapSSOResponse(ssoData);
-      return {
-        isLoggedIn: true,
-        isLoading: false,
-        user: user2,
-        accessToken: accessToken2,
-        orgs: orgs2,
-        logout,
-        getToken
-      };
-    }
-    if (error || !ssoData) {
+    if (!session) {
       return {
         isLoggedIn: false,
         isLoading: false,
@@ -240,7 +336,7 @@ function AthenaSSOProvider({
         getToken
       };
     }
-    const { user, orgs, accessToken } = mapSSOResponse(ssoData);
+    const { user, orgs, accessToken } = mapSSOResponse(session);
     return {
       isLoggedIn: true,
       isLoading: false,
@@ -250,11 +346,14 @@ function AthenaSSOProvider({
       logout,
       getToken
     };
-  }, [loading, error, ssoData, logout, getToken]);
+  }, [loading, session, logout, getToken]);
   if (authState.isLoading) {
     return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: displayWhileLoading ?? null });
   }
   if (!authState.isLoggedIn) {
+    if (typeof displayOnError === "function") {
+      return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: displayOnError({ reason: reason ?? "unauthenticated", retry }) });
+    }
     return displayOnError ? /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: displayOnError }) : null;
   }
   return /* @__PURE__ */ jsxRuntime.jsx(AthenaAuthContext.AthenaAuthContext.Provider, { value: authState, children });