@athenaintel/react 0.10.36 → 0.10.37

package/README.md

@@ -160,6 +160,11 @@ function AssetView() {
           onCitationClick={({ reference, sourceAssetId }) => {
             console.log('Citation clicked', { reference, sourceAssetId });
           }}
+          onCitationAction={({ action, reference }) => {
+            if (action === 'open-in-spaces') {
+              openAssetInMyApp(reference);
+            }
+          }}
         />
       </div>
     </AthenaProvider>
@@ -167,7 +172,9 @@ function AssetView() {
 }
 ```
 
-When `onCitationClick` is provided, citation navigation is delegated to the host by default. Set `citationBehavior="browser"` to observe the event while preserving Athena's default new-tab navigation, or `citationBehavior="host"` to delegate navigation without providing a callback.
+When `onCitationClick` is provided, citation navigation is delegated to the host by default. Set `citationBehavior="browser"` to observe the event while preserving Athena's default new-tab navigation. Host mode requires `onCitationClick`; without a handler, the SDK safely falls back to browser navigation.
+
+`onCitationAction` handles actions initiated from a citation popover. It currently receives `action: 'open-in-spaces'` when the user clicks the (+) button. Providing the handler delegates that action to the host by default. Set `citationActionBehavior="browser"` to observe the event while preserving Athena's default navigation; requesting host mode without a handler safely falls back to browser behavior.
 
 ## Theming
 

package/dist/assets/AthenaAssetEmbed.d.ts

@@ -1,5 +1,5 @@
 import { type FC, type IframeHTMLAttributes } from "react";
-import { type AthenaAssetCitationBehavior, type AthenaAssetCitationClickEvent } from "./asset-embed-messages";
+import { type AthenaAssetCitationActionEvent, type AthenaAssetCitationBehavior, type AthenaAssetCitationClickEvent } from "./asset-embed-messages";
 export interface AthenaAssetEmbedProps extends Omit<IframeHTMLAttributes<HTMLIFrameElement>, "src" | "onError" | "onLoad"> {
     assetId: string;
     /** Defaults to the native full asset experience. */
@@ -9,6 +9,9 @@ export interface AthenaAssetEmbedProps extends Omit<IframeHTMLAttributes<HTMLIFr
     expiresInSeconds?: number;
     citationBehavior?: AthenaAssetCitationBehavior;
     onCitationClick?: (event: AthenaAssetCitationClickEvent) => void;
+    /** Controls the citation popover's actions, including the (+) Open in Spaces button. */
+    citationActionBehavior?: AthenaAssetCitationBehavior;
+    onCitationAction?: (event: AthenaAssetCitationActionEvent) => void;
     onLoad?: () => void;
     onError?: (error: Error) => void;
     loadingFallback?: React.ReactNode;

package/dist/assets/asset-embed-messages.d.ts

@@ -1,7 +1,9 @@
 export declare const ATHENA_ASSET_EMBED_READY_MESSAGE: "athena:asset-embed-ready";
 export declare const ATHENA_ASSET_EMBED_CONFIG_MESSAGE: "athena:asset-embed-config";
 export declare const ATHENA_ASSET_CITATION_CLICK_MESSAGE: "athena:asset-citation-click";
+export declare const ATHENA_ASSET_CITATION_ACTION_MESSAGE: "athena:asset-citation-action";
 export type AthenaAssetCitationBehavior = "browser" | "host";
+export type AthenaAssetCitationAction = "open-in-spaces";
 export interface AthenaAssetCitationReference {
     id: string;
     anchor?: unknown;
@@ -13,6 +15,12 @@ export interface AthenaAssetCitationClickEvent {
     sourceAssetId?: string;
     reference: AthenaAssetCitationReference;
 }
+export interface AthenaAssetCitationActionEvent {
+    type: typeof ATHENA_ASSET_CITATION_ACTION_MESSAGE;
+    version: 1;
+    action: AthenaAssetCitationAction;
+    reference: AthenaAssetCitationReference;
+}
 export interface AthenaAssetEmbedReadyEvent {
     type: typeof ATHENA_ASSET_EMBED_READY_MESSAGE;
     version: 1;
@@ -22,10 +30,16 @@ export interface AthenaAssetEmbedConfigEvent {
     version: 1;
     token?: string;
     citationBehavior: AthenaAssetCitationBehavior;
+    citationActionBehavior?: AthenaAssetCitationBehavior;
 }
 export declare function resolveAthenaAssetCitationBehavior({ citationBehavior, hasCitationClickHandler, }: {
     citationBehavior?: AthenaAssetCitationBehavior;
     hasCitationClickHandler: boolean;
 }): AthenaAssetCitationBehavior;
+export declare function resolveAthenaAssetCitationActionBehavior({ citationActionBehavior, hasCitationActionHandler, }: {
+    citationActionBehavior?: AthenaAssetCitationBehavior;
+    hasCitationActionHandler: boolean;
+}): AthenaAssetCitationBehavior;
 export declare function isAthenaAssetEmbedReadyEvent(value: unknown): value is AthenaAssetEmbedReadyEvent;
 export declare function isAthenaAssetCitationClickEvent(value: unknown): value is AthenaAssetCitationClickEvent;
+export declare function isAthenaAssetCitationActionEvent(value: unknown): value is AthenaAssetCitationActionEvent;

package/dist/index.cjs

@@ -56254,6 +56254,7 @@ const AthenaUserMessage = ({
 const ATHENA_ASSET_EMBED_READY_MESSAGE = "athena:asset-embed-ready";
 const ATHENA_ASSET_EMBED_CONFIG_MESSAGE = "athena:asset-embed-config";
 const ATHENA_ASSET_CITATION_CLICK_MESSAGE = "athena:asset-citation-click";
+const ATHENA_ASSET_CITATION_ACTION_MESSAGE = "athena:asset-citation-action";
 function resolveAthenaAssetCitationBehavior({
   citationBehavior,
   hasCitationClickHandler
@@ -56261,12 +56262,22 @@ function resolveAthenaAssetCitationBehavior({
   if (citationBehavior === "host" && !hasCitationClickHandler) return "browser";
   return citationBehavior ?? (hasCitationClickHandler ? "host" : "browser");
 }
+function resolveAthenaAssetCitationActionBehavior({
+  citationActionBehavior,
+  hasCitationActionHandler
+}) {
+  if (citationActionBehavior === "host" && !hasCitationActionHandler) return "browser";
+  return citationActionBehavior ?? (hasCitationActionHandler ? "host" : "browser");
+}
 function isAthenaAssetEmbedReadyEvent(value) {
   return typeof value === "object" && value !== null && "type" in value && value.type === ATHENA_ASSET_EMBED_READY_MESSAGE && "version" in value && value.version === 1;
 }
 function isAthenaAssetCitationClickEvent(value) {
   return typeof value === "object" && value !== null && "type" in value && value.type === ATHENA_ASSET_CITATION_CLICK_MESSAGE && "version" in value && value.version === 1 && "reference" in value && typeof value.reference === "object" && value.reference !== null && "id" in value.reference && typeof value.reference.id === "string";
 }
+function isAthenaAssetCitationActionEvent(value) {
+  return typeof value === "object" && value !== null && "type" in value && value.type === ATHENA_ASSET_CITATION_ACTION_MESSAGE && "version" in value && value.version === 1 && "action" in value && value.action === "open-in-spaces" && "reference" in value && typeof value.reference === "object" && value.reference !== null && "id" in value.reference && typeof value.reference.id === "string";
+}
 function buildAssetEmbedRequestBody({
   assetId,
   readOnly,
@@ -56517,6 +56528,8 @@ const AthenaAssetEmbed = ({
   expiresInSeconds,
   citationBehavior,
   onCitationClick,
+  citationActionBehavior,
+  onCitationAction,
   onLoad,
   onError,
   loadingFallback,
@@ -56552,6 +56565,10 @@ const AthenaAssetEmbed = ({
     citationBehavior,
     hasCitationClickHandler: !!onCitationClick
   });
+  const effectiveCitationActionBehavior = resolveAthenaAssetCitationActionBehavior({
+    citationActionBehavior,
+    hasCitationActionHandler: !!onCitationAction
+  });
   const sendConfig = React.useCallback(() => {
     var _a2, _b;
     if (!targetOrigin) return;
@@ -56560,11 +56577,12 @@ const AthenaAssetEmbed = ({
         type: ATHENA_ASSET_EMBED_CONFIG_MESSAGE,
         version: 1,
         ...athenaConfig.token ? { token: athenaConfig.token } : {},
-        citationBehavior: effectiveCitationBehavior
+        citationBehavior: effectiveCitationBehavior,
+        citationActionBehavior: effectiveCitationActionBehavior
       },
       targetOrigin
     );
-  }, [athenaConfig, effectiveCitationBehavior, targetOrigin]);
+  }, [athenaConfig, effectiveCitationActionBehavior, effectiveCitationBehavior, targetOrigin]);
   React.useEffect(() => {
     if (!embedUrl || !targetOrigin) return;
     const handleMessage = (event) => {
@@ -56576,11 +56594,15 @@ const AthenaAssetEmbed = ({
       }
       if (isAthenaAssetCitationClickEvent(event.data)) {
         onCitationClick == null ? void 0 : onCitationClick(event.data);
+        return;
+      }
+      if (isAthenaAssetCitationActionEvent(event.data)) {
+        onCitationAction == null ? void 0 : onCitationAction(event.data);
       }
     };
     window.addEventListener("message", handleMessage);
     return () => window.removeEventListener("message", handleMessage);
-  }, [embedUrl, onCitationClick, sendConfig, targetOrigin]);
+  }, [embedUrl, onCitationAction, onCitationClick, sendConfig, targetOrigin]);
   React.useEffect(() => {
     if (!embedUrl) return;
     sendConfig();