@athenaintel/react 0.9.6 → 0.9.7

package/dist/index.d.ts

@@ -76,9 +76,7 @@ export declare interface AthenaChatProps {
     welcomeSuggestions?: WelcomeSuggestion[];
 }
 
-export declare interface AthenaConfig {
-    apiKey?: string;
-    token?: string | null;
+export declare interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {
     backendUrl: string;
     appUrl: string;
 }
@@ -99,15 +97,32 @@ export declare interface AthenaLayoutProps {
     minPercent?: number;
 }
 
-export declare function AthenaProvider({ children, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, appUrl, environment, workbench, knowledgeBase, systemPrompt, threadId: threadIdProp, enableThreadList, theme, }: AthenaProviderProps): JSX.Element | null;
+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 AthenaProviderConfig {
+    /** API key for standalone authentication when no token is provided. */
+    apiKey?: string;
+    /** PropelAuth token. Takes priority over apiKey when provided. */
+    token?: string | null;
+    /** URL for the chat streaming endpoint. Defaults to the matching Athena environment. */
+    apiUrl?: string;
+    /** URL for the Athena backend API. Defaults to the matching Athena environment. */
+    backendUrl?: string;
+    /** URL for the Athena frontend app origin. Defaults to the matching Athena environment. */
+    appUrl?: string;
+    /** Athena environment preset used when URLs are not explicitly provided. */
+    environment?: AthenaEnvironment;
+}
 
 export declare interface AthenaProviderProps {
     children: ReactNode;
-    /** API key for authentication. Used when running standalone (not in Olympus iframe). */
+    /** Preferred structured config for auth and Athena endpoint settings. */
+    config?: AthenaProviderConfig;
+    /** @deprecated Prefer `config.apiKey`. API key for authentication in standalone mode. */
     apiKey?: string;
-    /** PropelAuth token. If provided, takes priority over apiKey. If omitted, the SDK
+    /** @deprecated Prefer `config.token`. 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;
+    token?: string | null;
     /** Agent name to use. Defaults to 'athena_assist_agent'. */
     agent?: string;
     /** LLM model identifier. Defaults to 'claude-opus-4-6-thinking-max-fast'. */
@@ -116,13 +131,13 @@ export declare interface AthenaProviderProps {
     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. */
+    /** @deprecated Prefer `config.apiUrl`. URL for the chat streaming endpoint. */
     apiUrl?: string;
-    /** URL for the Agora backend API. Defaults to Athena production. */
+    /** @deprecated Prefer `config.backendUrl`. URL for the Athena backend API. */
     backendUrl?: string;
-    /** URL for the Athena frontend app origin. Defaults to the matching Athena environment. */
+    /** @deprecated Prefer `config.appUrl`. URL for the Athena frontend app origin. */
     appUrl?: string;
-    /** Athena environment preset used when URLs are not explicitly provided. */
+    /** @deprecated Prefer `config.environment`. Athena environment preset used when URLs are not explicitly provided. */
     environment?: AthenaEnvironment;
     /** Asset IDs to include in the workbench. */
     workbench?: string[];
@@ -155,7 +170,7 @@ export declare interface AthenaRuntimeConfig {
     apiUrl?: string;
     /** URL for the sync server resume endpoint. Derived from apiUrl if not provided. */
     resumeApiUrl?: string;
-    /** URL for the Agora backend API. Defaults to Athena production API. */
+    /** URL for the Athena backend API. Defaults to Athena production API. */
     backendUrl?: string;
     /** API key for authentication. Used when no auth token is provided. */
     apiKey?: string;
@@ -616,7 +631,7 @@ export declare interface ThreadListProps {
 }
 
 /**
- * Agora thread API client.
+ * Athena thread API client.
  * Calls existing REST endpoints for thread CRUD.
  */
 export declare interface ThreadSummary {
@@ -829,7 +844,7 @@ export declare function useAppendToComposer(): (text: string, opts?: {
 
 /**
  * Hook to generate an embed URL for rendering an asset in an iframe.
- * Calls the Agora `/api/embed/generate-token` endpoint.
+ * Calls the Athena embed token endpoint.
  */
 export declare function useAssetEmbed(assetId: string | null, options?: UseAssetEmbedOptions & {
     backendUrl: string;
@@ -870,7 +885,7 @@ export declare function useComposerAttachment(): {
 };
 
 /**
- * Hook for uploading files to the Athena platform via Agora's `/api/upload/` endpoint.
+ * Hook for uploading files to the Athena platform via the Athena upload endpoint.
  * Files become Athena assets (documents, spreadsheets, PDFs, images, etc.).
  *
  * Usage:

package/dist/index.js

@@ -20759,7 +20759,7 @@ function getAuthHeaders(auth) {
   }
   return {};
 }
-function getAgoraBaseUrl(backendUrl) {
+function getAthenaApiBaseUrl(backendUrl) {
   const stripped = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
   if (stripped === backendUrl) {
     return backendUrl.replace(/\/$/, "");
@@ -20767,7 +20767,7 @@ function getAgoraBaseUrl(backendUrl) {
   return stripped;
 }
 async function listThreads(backendUrl, auth, opts = {}) {
-  const base2 = getAgoraBaseUrl(backendUrl);
+  const base2 = getAthenaApiBaseUrl(backendUrl);
   const res = await fetch(`${base2}/api/conversations/threads/list`, {
     method: "POST",
     headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
@@ -20796,7 +20796,7 @@ function deserializeMessage(msg) {
   return msg;
 }
 async function getThreadState(backendUrl, auth, threadId) {
-  const base2 = getAgoraBaseUrl(backendUrl);
+  const base2 = getAthenaApiBaseUrl(backendUrl);
   const res = await fetch(`${base2}/api/unstable/threads/${threadId}`, {
     method: "GET",
     headers: { ...getAuthHeaders(auth) }
@@ -20811,7 +20811,7 @@ async function getThreadState(backendUrl, auth, threadId) {
   return data;
 }
 async function archiveThread(backendUrl, auth, threadId) {
-  const base2 = getAgoraBaseUrl(backendUrl);
+  const base2 = getAthenaApiBaseUrl(backendUrl);
   const res = await fetch(`${base2}/api/conversations/threads/archive`, {
     method: "POST",
     headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
@@ -24625,6 +24625,15 @@ const themes = {
     radius: "0.625rem"
   }
 };
+const resolveTokenOverride = ({
+  config: config2,
+  token
+}) => {
+  if ((config2 == null ? void 0 : config2.token) !== void 0) {
+    return config2.token;
+  }
+  return token;
+};
 function AthenaStandalone({
   children,
   apiUrl,
@@ -24764,6 +24773,7 @@ function AthenaWithThreadList({
 }
 function AthenaProvider({
   children,
+  config: config2,
   apiKey,
   token: tokenProp,
   agent: agent2,
@@ -24783,15 +24793,21 @@ function AthenaProvider({
 }) {
   const frontendToolNames = useMemo(() => Object.keys(frontendTools), [frontendTools]);
   const themeStyleVars = useMemo(() => theme ? themeToStyleVars(theme) : void 0, [theme]);
+  const configuredEnvironment = (config2 == null ? void 0 : config2.environment) ?? environment;
   const environmentUrls = useMemo(
-    () => getAthenaEnvironmentUrls({ environment }),
-    [environment]
+    () => getAthenaEnvironmentUrls({ environment: configuredEnvironment }),
+    [configuredEnvironment]
   );
+  const configuredApiKey = (config2 == null ? void 0 : config2.apiKey) ?? apiKey;
+  const configuredToken = resolveTokenOverride({ config: config2, token: tokenProp });
+  const configuredApiUrl = (config2 == null ? void 0 : config2.apiUrl) ?? apiUrl;
+  const configuredBackendUrl = (config2 == null ? void 0 : config2.backendUrl) ?? backendUrl;
+  const configuredAppUrl = (config2 == null ? void 0 : config2.appUrl) ?? appUrl;
   const bridge = useParentBridge();
-  const effectiveToken = tokenProp ?? bridge.token;
-  const effectiveApiUrl = apiUrl ?? bridge.apiUrl ?? environmentUrls.apiUrl ?? DEFAULT_API_URL;
-  const effectiveBackendUrl = backendUrl ?? bridge.backendUrl ?? environmentUrls.backendUrl ?? DEFAULT_BACKEND_URL;
-  const effectiveAppUrl = appUrl ?? bridge.appUrl ?? deriveAthenaAppUrl({ apiUrl: effectiveApiUrl, backendUrl: effectiveBackendUrl }) ?? environmentUrls.appUrl ?? DEFAULT_APP_URL;
+  const effectiveToken = configuredToken !== void 0 ? configuredToken : bridge.token;
+  const effectiveApiUrl = configuredApiUrl ?? bridge.apiUrl ?? environmentUrls.apiUrl ?? DEFAULT_API_URL;
+  const effectiveBackendUrl = configuredBackendUrl ?? bridge.backendUrl ?? environmentUrls.backendUrl ?? DEFAULT_BACKEND_URL;
+  const effectiveAppUrl = configuredAppUrl ?? bridge.appUrl ?? deriveAthenaAppUrl({ apiUrl: effectiveApiUrl, backendUrl: effectiveBackendUrl }) ?? environmentUrls.appUrl ?? DEFAULT_APP_URL;
   if (!bridge.ready) {
     return null;
   }
@@ -24803,7 +24819,7 @@ function AthenaProvider({
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
         appUrl: effectiveAppUrl,
-        apiKey,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -24823,7 +24839,7 @@ function AthenaProvider({
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
         appUrl: effectiveAppUrl,
-        apiKey,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -63662,9 +63678,6 @@ function useFileUpload() {
           formData.append("files", file, file.name);
         }
         const baseUrl = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
-        if (baseUrl === backendUrl) {
-          console.warn("[AthenaSDK] useFileUpload: backendUrl does not end with /api/assistant-ui — upload URL may be incorrect:", `${baseUrl}/api/upload/`);
-        }
         const uploadUrl = `${baseUrl}/api/upload/`;
         const headers = {};
         if (token) {
@@ -64265,8 +64278,8 @@ function useAssetEmbed(assetId, options = {
       setError(null);
       return;
     }
-    const agoraBase = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
-    const endpoint = `${agoraBase}/api/embed/generate-token`;
+    const apiBaseUrl = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
+    const endpoint = `${apiBaseUrl}/api/embed/generate-token`;
     (_a2 = abortRef.current) == null ? void 0 : _a2.abort();
     const controller = new AbortController();
     abortRef.current = controller;