@athenaintel/react 0.9.12 → 0.9.14

package/README.md

@@ -48,6 +48,44 @@ function App() {
 
 If `config.appUrl` is omitted, the provider resolves it from the parent bridge or from the matching Athena environment defaults. Known Athena staging and production `apiUrl` and `backendUrl` values automatically fall back to the corresponding frontend origin.
 
+## 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.
+
+If your host app wants different behavior, configure `linkClicks` on `<AthenaProvider>` or use `useAthenaLinkClickHandler()` inside a custom message renderer. The hook runs for every rendered link; only Athena citation links are intercepted by default.
+
+```tsx
+import { useMemo } from 'react';
+import { AthenaChat, AthenaLayout, AthenaProvider } from '@athenaintel/react';
+
+function App() {
+  const linkClicks = useMemo(
+    () => ({
+      onClick: (link) => {
+        if (link.kind !== 'athena-citation' || !link.openInAssetPanel) {
+          return false;
+        }
+
+        console.log('Citation clicked:', link.citation?.assetId);
+        link.openInAssetPanel();
+        return true;
+      },
+    }),
+    [],
+  );
+
+  return (
+    <AthenaProvider linkClicks={linkClicks}>
+      <AthenaLayout>
+        <AthenaChat />
+      </AthenaLayout>
+    </AthenaProvider>
+  );
+}
+```
+
+Set `linkClicks={{ interceptAthenaCitations: false }}` to keep Athena citation links opening in the browser while still letting your app observe all link clicks.
+
 ## Theming
 
 ```tsx