@athenaintel/react 0.9.12 → 0.9.14

package/dist/index.d.ts

@@ -26,7 +26,12 @@ export declare const AppendDocumentToolUI: ToolCallMessagePartComponent;
 
 declare type AssetIconType = "doc" | "pdf" | "sheet";
 
-export declare const AssetPanel: FC;
+export declare const AssetPanel: FC<AssetPanelProps>;
+
+export declare interface AssetPanelProps {
+    /** Register this panel as an asset-panel host when used outside AthenaLayout. */
+    manageAssetPanelHostRegistration?: boolean;
+}
 
 export declare interface AssetPanelState {
     isOpen: boolean;
@@ -34,10 +39,14 @@ export declare interface AssetPanelState {
     activeTabId: string | null;
     viewMode: ViewMode;
     isFullscreen: boolean;
+    /** Number of registered hosts that can reveal the asset panel. */
+    assetPanelHostCount: number;
     /** Generation counter for auto-open tracking — incremented on reset */
     autoOpenGeneration: number;
     /** Tracks which assets have been auto-opened in the current generation */
     autoOpenedAssets: Map<string, number>;
+    registerAssetPanelHost: () => void;
+    unregisterAssetPanelHost: () => void;
     openAsset: (assetId: string, meta?: {
         name?: string;
         type?: AssetType;
@@ -113,9 +122,44 @@ export declare interface AthenaChatProps {
     components?: AthenaChatComponents;
 }
 
+export declare interface AthenaCitationLinkClickContext extends AthenaLinkClickContext {
+    kind: 'athena-citation';
+    citation: AthenaCitationLinkMetadata;
+    assetId: string;
+    assetIds: string[];
+    assetType: AssetType | null;
+    openInAssetPanel: () => void;
+}
+
+/**
+ * @deprecated Prefer `AthenaLinkClickHandleInput`.
+ */
+export declare type AthenaCitationLinkHandleInput = AthenaLinkClickHandleInput;
+
+/**
+ * @deprecated Prefer `AthenaLinkClickHandler`.
+ */
+export declare type AthenaCitationLinkHandler = AthenaLinkClickHandler;
+
+export declare interface AthenaCitationLinkMetadata {
+    assetId: string;
+    assetIds: string[];
+    assetType: AssetType | null;
+}
+
+/**
+ * @deprecated Prefer `AthenaLinkClickOptions`. This remains supported as a citation-only alias.
+ */
+export declare interface AthenaCitationLinkOptions {
+    interceptAthenaCitations?: boolean;
+    onClick?: (context: AthenaCitationLinkClickContext) => boolean | void;
+}
+
 export declare interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {
     backendUrl: string;
     appUrl: string;
+    linkClicks?: AthenaLinkClickOptions;
+    citationLinks?: AthenaCitationLinkOptions;
 }
 
 export declare type AthenaEnvironment = 'production' | 'staging';
@@ -134,7 +178,44 @@ export declare interface AthenaLayoutProps {
     minPercent?: number;
 }
 
-export declare function AthenaProvider({ children, config, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, appUrl, environment, workbench, knowledgeBase, systemPrompt, threadId: threadIdProp, enableThreadList, theme, }: AthenaProviderProps): JSX.Element | null;
+export declare interface AthenaLinkClickContext {
+    href: string;
+    url: URL;
+    target: string | null;
+    linkText: string | null;
+    isAssetPanelAvailable: boolean;
+    kind: AthenaLinkKind;
+    citation: AthenaCitationLinkMetadata | null;
+    nativeEvent: MouseEvent | null;
+    openInAssetPanel?: () => void;
+    openInBrowser: (target?: string | null) => void;
+}
+
+export declare interface AthenaLinkClickHandleInput {
+    href: string;
+    linkText?: string | null;
+    target?: string | null;
+    nativeEvent?: MouseEvent | null;
+}
+
+export declare type AthenaLinkClickHandler = (input: AthenaLinkClickHandleInput) => boolean;
+
+export declare interface AthenaLinkClickOptions {
+    /**
+     * Whether Athena citation links should be intercepted by the SDK.
+     * Defaults to `true`.
+     */
+    interceptAthenaCitations?: boolean;
+    /**
+     * Optional override invoked when any rendered chat link is clicked.
+     * Return `true` to mark the click as handled and skip the default SDK behavior.
+     */
+    onClick?: (context: AthenaLinkClickContext) => boolean | void;
+}
+
+export declare type AthenaLinkKind = 'athena-citation' | 'athena-app' | 'external';
+
+export declare function AthenaProvider({ children, config, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, appUrl, environment, workbench, knowledgeBase, systemPrompt, threadId: threadIdProp, enableThreadList, theme, linkClicks, citationLinks, }: AthenaProviderProps): JSX.Element | null;
 
 export declare interface AthenaProviderConfig {
     /** API key for standalone authentication when no token is provided. */
@@ -200,6 +281,10 @@ export declare interface AthenaProviderProps {
      *  <AthenaProvider theme={{ ...themes.dark, primary: '#22c55e' }}>
      */
     theme?: AthenaTheme;
+    /** Customize how rendered chat links behave. */
+    linkClicks?: AthenaLinkClickOptions;
+    /** @deprecated Prefer `linkClicks`. Customize how Athena citation links rendered in chat messages behave. */
+    citationLinks?: AthenaCitationLinkOptions;
 }
 
 export declare const AthenaReasoningPart: FC<AthenaReasoningPartProps>;
@@ -431,6 +516,11 @@ export declare function getAssetInfo(assetId: string): {
     icon: AssetIconType;
 };
 
+export declare const isAthenaCitationUrl: ({ href, appUrl, }: {
+    href: string;
+    appUrl?: string | null;
+}) => boolean;
+
 /** Item cache: deduplicates items by ID, tracks scope membership */
 declare interface ItemCache {
     items: Map<string, MenuItem>;
@@ -485,6 +575,18 @@ export declare interface ParentBridgeState {
     ready: boolean;
 }
 
+export declare const parseAthenaCitationLink: ({ href, appUrl, }: {
+    href: string;
+    appUrl?: string | null;
+}) => ParsedAthenaCitationLink | null;
+
+export declare interface ParsedAthenaCitationLink {
+    url: URL;
+    assetId: string;
+    assetIds: string[];
+    assetType: AssetType | null;
+}
+
 declare interface QuoteContextValue {
     quote: QuoteData | null;
     setQuote: (quote: QuoteData | null) => void;
@@ -925,8 +1027,12 @@ export declare interface UseAssetEmbedResult {
 
 export declare const useAssetPanelStore: UseBoundStore<StoreApi<AssetPanelState>>;
 
+export declare const useAthenaCitationLinkHandler: () => AthenaCitationLinkHandler;
+
 export declare function useAthenaConfig(): AthenaConfig;
 
+export declare const useAthenaLinkClickHandler: () => AthenaLinkClickHandler;
+
 export declare const useAthenaRuntime: (config: AthenaRuntimeConfig) => AssistantRuntime;
 
 /**