@athenaintel/react 0.9.5 → 0.9.7

package/README.md

@@ -17,7 +17,7 @@ import '@athenaintel/react/styles.css';
 function App() {
   return (
     <AthenaProvider
-      apiKey="your-api-key"
+      config={{ apiKey: 'your-api-key' }}
       tools={[Toolkits.DOCUMENT, Toolkits.WEB_SEARCH]}
     >
       <AthenaChat />
@@ -26,6 +26,28 @@ function App() {
 }
 ```
 
+## Provider Config
+
+```tsx
+<AthenaProvider config={{ environment: 'staging' }}>
+  <AthenaChat />
+</AthenaProvider>
+
+<AthenaProvider
+  config={{
+    apiUrl: 'https://sync.example.com/api/chat',
+    backendUrl: 'https://api.example.com',
+    appUrl: 'https://app.example.com',
+  }}
+>
+  <AthenaChat />
+</AthenaProvider>
+```
+
+`config` accepts `apiKey`, `token`, `apiUrl`, `backendUrl`, `appUrl`, and `environment`. Top-level `apiKey`, `token`, `apiUrl`, `backendUrl`, `appUrl`, and `environment` props remain supported as compatibility aliases, but `config` is now the preferred API.
+
+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.
+
 ## Theming
 
 ```tsx

package/dist/index.cjs

@@ -16475,6 +16475,106 @@ const INTERNAL = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProp
   useSmoothStatus,
   useToolInvocations
 }, Symbol.toStringTag, { value: "Module" }));
+const ATHENA_ENVIRONMENT_URLS = {
+  production: {
+    apiUrl: "https://sync.athenaintel.com/api/chat",
+    backendUrl: "https://api.athenaintel.com/api/assistant-ui",
+    appUrl: "https://app.athenaintel.com"
+  },
+  staging: {
+    apiUrl: "https://staging-sync.athenaintel.com/api/chat",
+    backendUrl: "https://staging-api.athenaintel.com/api/assistant-ui",
+    appUrl: "https://staging-app.athenaintel.com"
+  }
+};
+const DEFAULT_ATHENA_ENVIRONMENT = "production";
+const DEFAULT_API_URL = ATHENA_ENVIRONMENT_URLS.production.apiUrl;
+const DEFAULT_BACKEND_URL = ATHENA_ENVIRONMENT_URLS.production.backendUrl;
+const DEFAULT_APP_URL = ATHENA_ENVIRONMENT_URLS.production.appUrl;
+const SPACES_PATHNAME = "/dashboard/spaces/";
+const normalizeBaseUrl = (url) => url.replace(/\/+$/, "");
+const getHostname = (value) => {
+  if (!value) return null;
+  try {
+    return new URL(value).hostname;
+  } catch {
+    return null;
+  }
+};
+const deriveWorkspaceAppUrl = ({
+  sourceUrl,
+  sourcePort
+}) => {
+  var _a2;
+  try {
+    const parsedUrl = new URL(sourceUrl);
+    const match2 = parsedUrl.hostname.match(
+      new RegExp(`^(?<prefix>.+)--${sourcePort}\\.(?<domain>app\\.athenaintel\\.com|staging-app\\.athenaintel\\.com)$`)
+    );
+    if (!((_a2 = match2 == null ? void 0 : match2.groups) == null ? void 0 : _a2.prefix) || !match2.groups.domain) {
+      return null;
+    }
+    return `${parsedUrl.protocol}//${match2.groups.prefix}--8082.${match2.groups.domain}`;
+  } catch {
+    return null;
+  }
+};
+function getAthenaEnvironmentUrls({
+  environment = DEFAULT_ATHENA_ENVIRONMENT
+} = {}) {
+  return ATHENA_ENVIRONMENT_URLS[environment];
+}
+function deriveAthenaAppUrl({
+  apiUrl,
+  backendUrl
+}) {
+  if (backendUrl) {
+    const workspaceAppUrl = deriveWorkspaceAppUrl({
+      sourceUrl: backendUrl,
+      sourcePort: "8000"
+    });
+    if (workspaceAppUrl) return workspaceAppUrl;
+    const backendHostname = getHostname(backendUrl);
+    if (backendHostname === "api.athenaintel.com") {
+      return ATHENA_ENVIRONMENT_URLS.production.appUrl;
+    }
+    if (backendHostname === "staging-api.athenaintel.com") {
+      return ATHENA_ENVIRONMENT_URLS.staging.appUrl;
+    }
+  }
+  if (apiUrl) {
+    const workspaceAppUrl = deriveWorkspaceAppUrl({
+      sourceUrl: apiUrl,
+      sourcePort: "8787"
+    });
+    if (workspaceAppUrl) return workspaceAppUrl;
+    const apiHostname = getHostname(apiUrl);
+    if (apiHostname === "sync.athenaintel.com") {
+      return ATHENA_ENVIRONMENT_URLS.production.appUrl;
+    }
+    if (apiHostname === "staging-sync.athenaintel.com") {
+      return ATHENA_ENVIRONMENT_URLS.staging.appUrl;
+    }
+  }
+  return null;
+}
+function createAthenaSpacesUrl({
+  appUrl = DEFAULT_APP_URL,
+  assetIds,
+  sessionId
+}) {
+  const url = new URL(SPACES_PATHNAME, `${normalizeBaseUrl(appUrl)}/`);
+  if (assetIds) {
+    const normalizedAssetIds = (Array.isArray(assetIds) ? assetIds : [assetIds]).map((assetId) => assetId.trim()).filter((assetId) => assetId.length > 0);
+    if (normalizedAssetIds.length > 0) {
+      url.searchParams.set("asset_ids", normalizedAssetIds.join(","));
+    }
+  }
+  if (sessionId) {
+    url.searchParams.set("session_id", sessionId);
+  }
+  return url.toString();
+}
 function isTrustedOrigin(origin) {
   try {
     const { hostname } = new URL(origin);
@@ -16490,6 +16590,7 @@ function useParentBridge() {
     token: null,
     apiUrl: null,
     backendUrl: null,
+    appUrl: null,
     // If not in an iframe, we're ready immediately (standalone mode)
     ready: !isInIframe
   });
@@ -16505,7 +16606,8 @@ function useParentBridge() {
         setState((prev) => ({
           ...prev,
           apiUrl: typeof event.data.apiUrl === "string" ? event.data.apiUrl : prev.apiUrl,
-          backendUrl: typeof event.data.backendUrl === "string" ? event.data.backendUrl : prev.backendUrl
+          backendUrl: typeof event.data.backendUrl === "string" ? event.data.backendUrl : prev.backendUrl,
+          appUrl: typeof event.data.appUrl === "string" ? event.data.appUrl : prev.appUrl
           // Don't set ready here — wait for athena-auth (token) or the timeout.
           // Setting ready on config alone causes a race: the thread list fires
           // before the token arrives, falling back to X-API-KEY.
@@ -20675,7 +20777,7 @@ function getAuthHeaders(auth) {
   }
   return {};
 }
-function getAgoraBaseUrl(backendUrl) {
+function getAthenaApiBaseUrl(backendUrl) {
   const stripped = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
   if (stripped === backendUrl) {
     return backendUrl.replace(/\/$/, "");
@@ -20683,7 +20785,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) },
@@ -20712,7 +20814,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) }
@@ -20727,7 +20829,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) },
@@ -20737,8 +20839,6 @@ async function archiveThread(backendUrl, auth, threadId) {
     throw new Error(`[AthenaSDK] Failed to archive thread: ${res.status}`);
   }
 }
-const DEFAULT_API_URL = "https://sync.athenaintel.com/api/chat";
-const DEFAULT_BACKEND_URL = "https://api.athenaintel.com/api/assistant-ui";
 const DEFAULT_MODEL = "claude-opus-4-6-thinking-max-fast";
 const DEFAULT_AGENT = "athena_assist_agent";
 const ATHENA_TRACKING_ID_KEY = "_athena_tracking_id";
@@ -24543,10 +24643,20 @@ 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,
   backendUrl,
+  appUrl,
   apiKey,
   token,
   model,
@@ -24576,8 +24686,8 @@ function AthenaStandalone({
     threadId
   });
   const athenaConfig = React.useMemo(
-    () => ({ backendUrl, apiKey, token }),
-    [backendUrl, apiKey, token]
+    () => ({ backendUrl, appUrl, apiKey, token }),
+    [backendUrl, appUrl, apiKey, token]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(AssistantRuntimeProvider, { aui, runtime, children: /* @__PURE__ */ jsxRuntime.jsx(AthenaContext.Provider, { value: athenaConfig, children: /* @__PURE__ */ jsxRuntime.jsx(TooltipProvider, { children }) }) });
 }
@@ -24602,6 +24712,7 @@ function AthenaWithThreadList({
   children,
   apiUrl,
   backendUrl,
+  appUrl,
   apiKey,
   token,
   model,
@@ -24673,13 +24784,14 @@ function AthenaWithThreadList({
   const auiTools = React.useMemo(() => Tools({ toolkit: frontendTools }), [frontendTools]);
   const aui = useAui({ tools: auiTools });
   const athenaConfig = React.useMemo(
-    () => ({ backendUrl, apiKey, token }),
-    [backendUrl, apiKey, token]
+    () => ({ backendUrl, appUrl, apiKey, token }),
+    [backendUrl, appUrl, apiKey, token]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(AssistantRuntimeProvider, { aui, runtime, children: /* @__PURE__ */ jsxRuntime.jsx(AthenaContext.Provider, { value: athenaConfig, children: /* @__PURE__ */ jsxRuntime.jsx(ThreadListRefreshContext.Provider, { value: handleRefresh, children: /* @__PURE__ */ jsxRuntime.jsx(TooltipProvider, { children }) }) }) });
 }
 function AthenaProvider({
   children,
+  config: config2,
   apiKey,
   token: tokenProp,
   agent: agent2,
@@ -24688,6 +24800,8 @@ function AthenaProvider({
   frontendTools = {},
   apiUrl,
   backendUrl,
+  appUrl,
+  environment,
   workbench,
   knowledgeBase,
   systemPrompt,
@@ -24697,10 +24811,21 @@ function AthenaProvider({
 }) {
   const frontendToolNames = React.useMemo(() => Object.keys(frontendTools), [frontendTools]);
   const themeStyleVars = React.useMemo(() => theme ? themeToStyleVars(theme) : void 0, [theme]);
+  const configuredEnvironment = (config2 == null ? void 0 : config2.environment) ?? environment;
+  const environmentUrls = React.useMemo(
+    () => 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 ?? DEFAULT_API_URL;
-  const effectiveBackendUrl = backendUrl ?? bridge.backendUrl ?? DEFAULT_BACKEND_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;
   }
@@ -24711,7 +24836,8 @@ function AthenaProvider({
       {
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
-        apiKey,
+        appUrl: effectiveAppUrl,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -24730,7 +24856,8 @@ function AthenaProvider({
       {
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
-        apiKey,
+        appUrl: effectiveAppUrl,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -60527,9 +60654,12 @@ function useAttachments() {
   }
   return ctx;
 }
-function buildAttachmentMarkdown(attachments) {
+function buildAttachmentMarkdownWithAppUrl({
+  attachments,
+  appUrl = DEFAULT_APP_URL
+}) {
   if (attachments.length === 0) return "";
-  return attachments.map((a) => `[@${a.title}](https://app.athenaintel.com/dashboard/spaces?asset_id=${a.id})`).join("\n");
+  return attachments.map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`).join("\n");
 }
 const QuoteCtx = React.createContext(null);
 function QuoteProvider({ children }) {
@@ -60595,7 +60725,10 @@ function buildComposedMessage(opts) {
   var _a2;
   const parts = [];
   if (opts.attachments && opts.attachments.length > 0) {
-    const attachmentMd = buildAttachmentMarkdown(opts.attachments);
+    const attachmentMd = buildAttachmentMarkdownWithAppUrl({
+      attachments: opts.attachments,
+      appUrl: opts.appUrl
+    });
     if (attachmentMd) parts.push(attachmentMd);
   }
   if (opts.quote) {
@@ -60616,6 +60749,7 @@ const TiptapComposer = ({ tools = [] }) => {
   const mentionStore = useMentionSuggestions(tools);
   const { attachments, clearAttachments, isUploading } = useAttachments();
   const { quote, clearQuote } = useQuote();
+  const { appUrl } = useAthenaConfig();
   const attachmentsRef = React.useRef(attachments);
   attachmentsRef.current = attachments;
   const quoteRef = React.useRef(quote);
@@ -60636,7 +60770,8 @@ const TiptapComposer = ({ tools = [] }) => {
       const fullMessage = buildComposedMessage({
         attachments: currentAttachments,
         quote: currentQuote,
-        userText: markdown
+        userText: markdown,
+        appUrl
       });
       if (fullMessage) {
         aui.thread().append({
@@ -63561,9 +63696,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) {
@@ -63986,6 +64118,7 @@ const ComposerAction = () => /* @__PURE__ */ jsxRuntime.jsxs("div", { className:
 ] });
 const ComposerSendWithQuote = () => {
   const aui = useAui();
+  const { appUrl } = useAthenaConfig();
   const { quote, clearQuote } = useQuote();
   const { attachments, clearAttachments, isUploading } = useAttachments();
   const editorRef = useComposerEditorRef();
@@ -63999,7 +64132,8 @@ const ComposerSendWithQuote = () => {
     const fullMessage = buildComposedMessage({
       attachments,
       quote,
-      userText
+      userText,
+      appUrl
     });
     if (!fullMessage) return;
     aui.thread().append({
@@ -64083,6 +64217,7 @@ const AssistantMessage = ({ toolUIs }) => /* @__PURE__ */ jsxRuntime.jsxs(
 );
 const AssistantActionBar = () => {
   const threadId = useAthenaThreadId();
+  const { appUrl } = useAthenaConfig();
   return /* @__PURE__ */ jsxRuntime.jsxs(
     ActionBarPrimitiveRoot,
     {
@@ -64112,10 +64247,7 @@ const AssistantActionBar = () => {
                   {
                     className: "aui-action-bar-more-item flex cursor-pointer select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none hover:bg-accent hover:text-accent-foreground focus:bg-accent focus:text-accent-foreground",
                     onClick: () => {
-                      window.open(
-                        `https://app.athenaintel.com/dashboard/spaces?session_id=${threadId}`,
-                        "_blank"
-                      );
+                      window.open(createAthenaSpacesUrl({ appUrl, sessionId: threadId }), "_blank");
                     },
                     children: [
                       /* @__PURE__ */ jsxRuntime.jsx(ExternalLink, { className: "size-4" }),
@@ -64164,8 +64296,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;
@@ -64602,6 +64734,7 @@ exports.CreateNotebookToolUI = CreateNotebookToolUI;
 exports.CreatePresentationToolUI = CreatePresentationToolUI;
 exports.CreateSheetToolUI = CreateSheetToolUI;
 exports.DEFAULT_API_URL = DEFAULT_API_URL;
+exports.DEFAULT_APP_URL = DEFAULT_APP_URL;
 exports.DEFAULT_BACKEND_URL = DEFAULT_BACKEND_URL;
 exports.EmailSearchToolUI = EmailSearchToolUI;
 exports.ExpandableSection = ExpandableSection;