@athenaintel/react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,291 @@
+import { AssistantRuntime } from '@assistant-ui/react';
+import { ClassProp } from 'class-variance-authority/types';
+import { ClassValue } from 'clsx';
+import { Collapsible as Collapsible_2 } from 'radix-ui';
+import { ComponentPropsWithRef } from 'react';
+import { FC } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { Store } from '@tanstack/react-store';
+import { ToolCallMessagePartComponent } from '@assistant-ui/react';
+import { ToolCallMessagePartStatus } from '@assistant-ui/react';
+import { Toolkit } from '@assistant-ui/react';
+import { Tooltip as Tooltip_2 } from 'radix-ui';
+import { VariantProps } from 'class-variance-authority';
+
+export declare const AppendDocumentToolUI: ToolCallMessagePartComponent;
+
+declare type AssetIconType = "doc" | "pdf" | "sheet";
+
+export declare const AthenaChat: FC<AthenaChatProps>;
+
+export declare interface AthenaChatProps {
+    /** CSS class name for the root element. */
+    className?: string;
+    /** Welcome heading text. Defaults to "Hello there!" */
+    welcomeMessage?: string;
+    /** Welcome subheading text. */
+    welcomeSubtext?: string;
+    /** Maximum width for the thread content. Defaults to "44rem". */
+    maxWidth?: string;
+    /** Additional tool UIs to register by name. */
+    toolUIs?: Record<string, ToolCallMessagePartComponent>;
+    /** Mention tools available in the composer. */
+    mentionTools?: MentionTool[];
+}
+
+export declare function AthenaProvider({ children, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, workbench, knowledgeBase, systemPrompt, threadId, }: AthenaProviderProps): JSX.Element;
+
+export declare interface AthenaProviderProps {
+    children: ReactNode;
+    /** API key for authentication. Used when running standalone (not in Olympus iframe). */
+    apiKey?: string;
+    /** PropelAuth token. If provided, takes priority over apiKey. If omitted, the SDK
+     *  will automatically listen for a token from the parent window via PostMessage. */
+    token?: string;
+    /** Agent name to use. Defaults to 'athena_assist_agent'. */
+    agent?: string;
+    /** LLM model identifier. Defaults to 'claude-sonnet-4-6-low'. */
+    model?: string;
+    /** Backend toolkit IDs to enable (e.g. 'document_toolkit', 'web_search_browse_toolkit'). */
+    tools?: string[];
+    /** Frontend tools that execute in the browser. The agent can invoke these. */
+    frontendTools?: Toolkit;
+    /** URL for the chat streaming endpoint. Defaults to Athena production. */
+    apiUrl?: string;
+    /** URL for the Agora backend API. Defaults to Athena production. */
+    backendUrl?: string;
+    /** Asset IDs to include in the workbench. */
+    workbench?: string[];
+    /** Knowledge base IDs for RAG context. */
+    knowledgeBase?: string[];
+    /** System prompt override. */
+    systemPrompt?: string;
+    /** Thread ID override. Auto-generated if not provided. */
+    threadId?: string;
+}
+
+export declare interface AthenaRuntimeConfig {
+    /** URL for the chat streaming endpoint. Defaults to Athena production sync server. */
+    apiUrl?: string;
+    /** URL for the Agora backend API. Defaults to Athena production API. */
+    backendUrl?: string;
+    /** API key for authentication. Used when no auth token is provided. */
+    apiKey?: string;
+    /** PropelAuth token from parent window. Takes priority over apiKey. */
+    token?: string | null;
+    /** LLM model identifier. */
+    model?: string;
+    /** Agent name to use. */
+    agent?: string;
+    /** Backend toolkit IDs to enable. */
+    tools?: string[];
+    /** Frontend tool IDs to include in enabled_tools. */
+    frontendToolIds?: string[];
+    /** Asset IDs to include in the workbench. */
+    workbench?: string[];
+    /** Knowledge base IDs for RAG context. */
+    knowledgeBase?: string[];
+    /** System prompt override. */
+    systemPrompt?: string;
+    /** Thread ID override. Auto-generated if not provided. */
+    threadId?: string;
+}
+
+export declare const BrowseToolUI: ToolCallMessagePartComponent;
+
+export declare function Button({ className, variant, size, asChild, ...props }: React_2.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+}): JSX.Element;
+
+export declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare function cn(...inputs: ClassValue[]): string;
+
+export declare function Collapsible({ ...props }: React.ComponentProps<typeof Collapsible_2.Root>): JSX.Element;
+
+export declare function CollapsibleContent({ ...props }: React.ComponentProps<typeof Collapsible_2.CollapsibleContent>): JSX.Element;
+
+export declare function CollapsibleTrigger({ ...props }: React.ComponentProps<typeof Collapsible_2.CollapsibleTrigger>): JSX.Element;
+
+export declare const CreateDocumentToolUI: ToolCallMessagePartComponent;
+
+export declare const CreateEmailDraftToolUI: ToolCallMessagePartComponent;
+
+export declare const EmailSearchToolUI: ToolCallMessagePartComponent;
+
+declare interface FetchState {
+    isFetching: boolean;
+    hasNextPage: boolean;
+    error: Error | null;
+    meta: unknown;
+}
+
+export declare function getAssetInfo(assetId: string): {
+    name: string;
+    icon: AssetIconType;
+};
+
+/** Item cache: deduplicates items by ID, tracks scope membership */
+declare interface ItemCache {
+    items: Map<string, MenuItem>;
+}
+
+declare interface MentionSuggestionsState {
+    registry: ScopeRegistry;
+    cache: ItemCache;
+}
+
+declare type MentionSuggestionsStore = Store<MentionSuggestionsState>;
+
+export declare interface MentionTool {
+    id: string;
+    name: string;
+    description?: string;
+    icon?: string;
+    type: "tool" | "toolkit";
+}
+
+declare interface MenuItem {
+    id: string;
+    name: string;
+    type: "menu" | "tool" | "toolkit";
+    fallbackIcon: string;
+    description?: string;
+    visibleInScopes: Set<MenuScope>;
+    navigatesToScope?: MenuScope;
+    isNavigationOnly?: boolean;
+}
+
+/**
+ * Core types for mention suggestions data layer
+ * Simplified from Olympus — only Tool and Toolkit types
+ */
+declare type MenuScope = string;
+
+export declare const ReadAssetToolUI: ToolCallMessagePartComponent;
+
+declare interface ScopeRegistry {
+    entries: Map<MenuScope, ScopeRegistryEntry>;
+}
+
+declare interface ScopeRegistryEntry {
+    sourceFn: SourceFn;
+    fetchStates: Map<string, FetchState>;
+}
+
+declare interface SourceContext {
+    scope: MenuScope;
+    query: string;
+    fetchState: FetchState;
+}
+
+declare type SourceFn = (context: SourceContext) => Promise<SourceResult>;
+
+declare interface SourceResult {
+    items: MenuItem[];
+    pagination?: {
+        hasMore: boolean;
+        totalCount?: number;
+    };
+}
+
+export declare const TiptapComposer: FC<TiptapComposerProps>;
+
+export declare interface TiptapComposerProps {
+    tools?: MentionTool[];
+}
+
+export declare const TiptapText: FC<{
+    text: string;
+}>;
+
+export declare const TOOL_UI_REGISTRY: Record<string, ToolCallMessagePartComponent>;
+
+export { ToolCallMessagePartComponent }
+
+export declare const ToolFallback: ToolCallMessagePartComponent & {
+    Root: typeof ToolFallbackRoot;
+    Trigger: typeof ToolFallbackTrigger;
+    Content: typeof ToolFallbackContent;
+    Args: typeof ToolFallbackArgs;
+    Result: typeof ToolFallbackResult;
+    Error: typeof ToolFallbackError;
+};
+
+export declare function ToolFallbackArgs({ argsText, className, ...props }: React.ComponentProps<"div"> & {
+    argsText?: string;
+}): JSX.Element | null;
+
+export declare function ToolFallbackContent({ className, children, ...props }: React.ComponentProps<typeof CollapsibleContent>): JSX.Element;
+
+export declare function ToolFallbackError({ status, className, ...props }: React.ComponentProps<"div"> & {
+    status?: ToolCallMessagePartStatus;
+}): JSX.Element | null;
+
+export declare function ToolFallbackResult({ result, className, ...props }: React.ComponentProps<"div"> & {
+    result?: unknown;
+}): JSX.Element | null;
+
+export declare function ToolFallbackRoot({ className, open: controlledOpen, onOpenChange: controlledOnOpenChange, defaultOpen, children, ...props }: ToolFallbackRootProps): JSX.Element;
+
+declare type ToolFallbackRootProps = Omit<React.ComponentProps<typeof Collapsible>, "open" | "onOpenChange"> & {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    defaultOpen?: boolean;
+};
+
+export declare function ToolFallbackTrigger({ toolName, argsText, result, status, className, ...props }: React.ComponentProps<typeof CollapsibleTrigger> & {
+    toolName: string;
+    argsText?: string;
+    result?: unknown;
+    status?: ToolCallMessagePartStatus;
+}): JSX.Element;
+
+export { Toolkit }
+
+export declare function Tooltip({ ...props }: React_2.ComponentProps<typeof Tooltip_2.Root>): JSX.Element;
+
+export declare function TooltipContent({ className, sideOffset, children, ...props }: React_2.ComponentProps<typeof Tooltip_2.Content>): JSX.Element;
+
+export declare const TooltipIconButton: ForwardRefExoticComponent<Omit<TooltipIconButtonProps, "ref"> & RefAttributes<HTMLButtonElement>>;
+
+export declare type TooltipIconButtonProps = ComponentPropsWithRef<typeof Button> & {
+    tooltip: string;
+    side?: "top" | "bottom" | "left" | "right";
+};
+
+export declare function TooltipProvider({ delayDuration, ...props }: React_2.ComponentProps<typeof Tooltip_2.Provider>): JSX.Element;
+
+export declare function TooltipTrigger({ ...props }: React_2.ComponentProps<typeof Tooltip_2.Trigger>): JSX.Element;
+
+export declare function tryParseJson(text: string): Record<string, unknown> | null;
+
+export declare const useAthenaRuntime: (config: AthenaRuntimeConfig) => AssistantRuntime;
+
+export declare function useMentionSuggestions(tools: MentionTool[]): MentionSuggestionsStore;
+
+/**
+ * Listens for auth tokens sent from a parent window via PostMessage.
+ *
+ * When the app runs inside an Olympus iframe, the parent sends
+ * the user's PropelAuth access token so the chat authenticates as the
+ * actual viewer — not the hardcoded API key owner.
+ *
+ * Protocol:
+ *   Parent -> iframe: { type: 'athena-auth', token: '<propel-access-token>' }
+ *   iframe -> Parent: { type: 'athena-auth-ready' }
+ *
+ * Falls back to null when running standalone (no parent window).
+ */
+export declare function useParentAuth(): string | null;
+
+export declare const WebSearchToolUI: ToolCallMessagePartComponent;
+
+export { }