@athenaintel/react 0.9.6 → 0.9.8

package/dist/index.d.ts

@@ -72,13 +72,13 @@ export declare interface AthenaChatProps {
     toolUIs?: Record<string, ToolCallMessagePartComponent>;
     /** Mention tools available in the composer. */
     mentionTools?: MentionTool[];
-    /** Suggestion cards shown on the welcome screen. Pass `[]` to hide. */
+    /** Suggestion cards shown on the welcome screen. Pass `[]` to hide.
+     *  For workflow launchers outside AthenaChat, use `useSendMessage()`.
+     */
     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 +99,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 +133,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 +172,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;
@@ -197,7 +214,7 @@ export declare interface AthenaRuntimeConfig {
 export declare interface AthenaTheme {
     /** Brand / accent color. Send button, active states, focus ring, spinner. */
     primary?: string;
-    /** Text color on primary background. */
+    /** Text color on primary background. Set this with `primary` when you change contrast significantly. */
     primaryForeground?: string;
     /** Page / panel background. */
     background?: string;
@@ -243,11 +260,11 @@ export declare interface AthenaTheme {
     sidebarWidth?: string;
     /** User message bubble background. Falls back to muted. */
     userBubble?: string;
-    /** User message bubble text color. Falls back to foreground. */
+    /** User message bubble text color. Falls back to foreground. Set this when `userBubble` is dark or saturated. */
     userBubbleForeground?: string;
     /** User message bubble border radius. e.g. '1rem', '0.5rem'. */
     userBubbleRadius?: string;
-    /** Assistant message text color. Falls back to foreground. */
+    /** Assistant message text color. Falls back to foreground. Set this when `assistantBubble` reduces contrast. */
     assistantForeground?: string;
     /** Assistant message bubble background. Transparent by default. */
     assistantBubble?: string;
@@ -413,7 +430,7 @@ export declare interface ParentBridgeState {
     token: string | null;
     /** Sync server chat URL provided by the Marathon wrapper. */
     apiUrl: string | null;
-    /** Agora backend URL provided by the Marathon wrapper. */
+    /** Athena backend URL provided by the Marathon wrapper. */
     backendUrl: string | null;
     /** Athena frontend origin provided by the parent wrapper. */
     appUrl: string | null;
@@ -455,6 +472,14 @@ declare interface ScopeRegistryEntry {
     fetchStates: Map<string, FetchState>;
 }
 
+export declare interface SendMessageOptions {
+    /**
+     * Replace the current composer text before sending.
+     * Defaults to `true`.
+     */
+    replace?: boolean;
+}
+
 declare interface SourceContext {
     scope: MenuScope;
     query: string;
@@ -616,7 +641,7 @@ export declare interface ThreadListProps {
 }
 
 /**
- * Agora thread API client.
+ * Athena thread API client.
  * Calls existing REST endpoints for thread CRUD.
  */
 export declare interface ThreadSummary {
@@ -816,7 +841,10 @@ export declare interface UploadProgress {
 }
 
 /**
- * Hook to programmatically append text to the composer.
+ * Hook to programmatically append text to the composer without sending it.
+ *
+ * Use `useSendMessage()` for workflow shortcuts or other UI that should
+ * immediately submit a prompt.
  *
  * Usage:
  *   const append = useAppendToComposer();
@@ -829,7 +857,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 +898,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:
@@ -923,6 +951,21 @@ export declare function useQuote(): QuoteContextValue;
 /** Trigger a re-fetch of the thread list. No-op outside of thread list mode. */
 export declare function useRefreshThreadList(): (() => void) | null;
 
+/**
+ * Hook to programmatically send a user message from anywhere inside AthenaProvider.
+ *
+ * This is intended for custom workflow buttons, sidebar shortcuts, or other UI
+ * that lives outside the AthenaChat thread tree. Unlike `aui.thread().append()`,
+ * this uses the provider-scoped composer runtime and does not depend on
+ * ThreadPrimitive context.
+ *
+ * Usage:
+ *   const sendMessage = useSendMessage();
+ *   await sendMessage("Run the quarterly workflow");
+ *   await sendMessage("Add this follow-up", { replace: false });
+ */
+export declare function useSendMessage(): (text: string, options?: SendMessageOptions) => Promise<void>;
+
 export declare type ViewMode = 'tabs' | 'tiled';
 
 export declare const WebSearchToolUI: ToolCallMessagePartComponent;

package/dist/index.js

@@ -16473,8 +16473,16 @@ 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 MARATHON_APP_PORT = "8082";
+const SPACES_PATHNAME = "dashboard/spaces/";
 const normalizeBaseUrl = (url) => url.replace(/\/+$/, "");
+const createUrlWithFallback = (url, fallbackUrl) => {
+  try {
+    return new URL(`${normalizeBaseUrl(url)}/`);
+  } catch {
+    return new URL(`${normalizeBaseUrl(fallbackUrl)}/`);
+  }
+};
 const getHostname = (value) => {
   if (!value) return null;
   try {
@@ -16496,7 +16504,7 @@ const deriveWorkspaceAppUrl = ({
     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}`;
+    return `${parsedUrl.protocol}//${match2.groups.prefix}--${MARATHON_APP_PORT}.${match2.groups.domain}`;
   } catch {
     return null;
   }
@@ -16545,7 +16553,7 @@ function createAthenaSpacesUrl({
   assetIds,
   sessionId
 }) {
-  const url = new URL(SPACES_PATHNAME, `${normalizeBaseUrl(appUrl)}/`);
+  const url = new URL(SPACES_PATHNAME, createUrlWithFallback(appUrl, DEFAULT_APP_URL));
   if (assetIds) {
     const normalizedAssetIds = (Array.isArray(assetIds) ? assetIds : [assetIds]).map((assetId) => assetId.trim()).filter((assetId) => assetId.length > 0);
     if (normalizedAssetIds.length > 0) {
@@ -20607,7 +20615,9 @@ const toolMessageSchema = objectType({
   type: literalType("tool"),
   content: toolMessageContentSchema,
   tool_call_id: stringType(),
-  name: stringType().nullable(),
+  // Some backend/tool result flows omit the tool name entirely.
+  // The converter already treats toolName as optional, so accept that shape.
+  name: nullableToOptionalString,
   artifact: anyType().optional(),
   status: enumType(["success", "error"]),
   additional_kwargs: recordType(stringType(), unknownType()).optional()
@@ -20759,7 +20769,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,14 +20777,16 @@ 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) },
     body: JSON.stringify({
       limit: opts.limit ?? 50,
       offset: opts.offset ?? 0,
-      exclude_triggered: opts.exclude_triggered ?? true
+      // Default to the full recent-conversations set unless a caller
+      // explicitly asks to hide triggered/background sessions.
+      exclude_triggered: opts.exclude_triggered ?? false
     })
   });
   if (!res.ok) {
@@ -20796,7 +20808,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 +20823,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 +24637,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 +24785,7 @@ function AthenaWithThreadList({
 }
 function AthenaProvider({
   children,
+  config: config2,
   apiKey,
   token: tokenProp,
   agent: agent2,
@@ -24783,15 +24805,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;
+  const effectiveBackendUrl = configuredBackendUrl ?? bridge.backendUrl ?? environmentUrls.backendUrl;
+  const effectiveAppUrl = configuredAppUrl ?? bridge.appUrl ?? deriveAthenaAppUrl({ apiUrl: effectiveApiUrl, backendUrl: effectiveBackendUrl }) ?? environmentUrls.appUrl;
   if (!bridge.ready) {
     return null;
   }
@@ -24803,7 +24831,7 @@ function AthenaProvider({
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
         appUrl: effectiveAppUrl,
-        apiKey,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -24823,7 +24851,7 @@ function AthenaProvider({
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
         appUrl: effectiveAppUrl,
-        apiKey,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -60752,7 +60780,7 @@ const TiptapComposer = ({ tools = [] }) => {
       composerRuntime.send();
     }
     editor2.commands.clearContent();
-  }, [aui, composerRuntime, clearAttachments, clearQuote]);
+  }, [aui, composerRuntime, clearAttachments, clearQuote, appUrl]);
   const handleSubmitRef = useRef(handleSubmit);
   handleSubmitRef.current = handleSubmit;
   const editor = useEditor({
@@ -63662,9 +63690,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) {
@@ -63927,6 +63952,23 @@ const ComposerDropZone = ({
     }
   );
 };
+function useSendMessage() {
+  const aui = useAui();
+  return useCallback(
+    async (text2, options) => {
+      if (!text2.trim()) return;
+      const composer = aui.composer();
+      const currentText = composer.getState().text;
+      const shouldReplace = (options == null ? void 0 : options.replace) ?? true;
+      composer.setText(
+        shouldReplace || !currentText ? text2 : `${currentText}
+${text2}`
+      );
+      await composer.send();
+    },
+    [aui]
+  );
+}
 const EMPTY_MENTION_TOOLS = [];
 function QuotePostMessageBridge() {
   useQuoteFromPostMessage();
@@ -63958,14 +64000,11 @@ const SuggestionCard = ({
   suggestion,
   index: index2
 }) => {
-  const aui = useAui();
   const Icon2 = suggestion.icon;
+  const sendMessage = useSendMessage();
   const handleClick2 = useCallback(() => {
-    aui.thread().append({
-      role: "user",
-      content: [{ type: "text", text: suggestion.prompt }]
-    });
-  }, [aui, suggestion.prompt]);
+    void sendMessage(suggestion.prompt);
+  }, [sendMessage, suggestion.prompt]);
   return /* @__PURE__ */ jsxs(
     "button",
     {
@@ -64112,7 +64151,7 @@ const ComposerSendWithQuote = () => {
     editor == null ? void 0 : editor.clear();
     clearQuote();
     clearAttachments();
-  }, [aui, quote, attachments, isUploading, clearQuote, clearAttachments, editorRef]);
+  }, [aui, quote, attachments, isUploading, clearQuote, clearAttachments, editorRef, appUrl]);
   if (hasExtras) {
     return /* @__PURE__ */ jsx(
       TooltipIconButton,
@@ -64265,8 +64304,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;
@@ -64754,6 +64793,7 @@ export {
   useParentAuth,
   useParentBridge,
   useQuote,
-  useRefreshThreadList
+  useRefreshThreadList,
+  useSendMessage
 };
 //# sourceMappingURL=index.js.map