@athenaintel/react 0.9.6 → 0.9.8

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,23 +26,27 @@ function App() {
 }
 ```
 
-## Environment And URLs
+## Provider Config
 
 ```tsx
-<AthenaProvider environment="staging">
+<AthenaProvider config={{ environment: 'staging' }}>
   <AthenaChat />
 </AthenaProvider>
 
 <AthenaProvider
-  apiUrl="https://sync.example.com/api/chat"
-  backendUrl="https://api.example.com/api/assistant-ui"
-  appUrl="https://app.example.com"
+  config={{
+    apiUrl: 'https://sync.example.com/api/chat',
+    backendUrl: 'https://api.example.com',
+    appUrl: 'https://app.example.com',
+  }}
 >
   <AthenaChat />
 </AthenaProvider>
 ```
 
-If `appUrl` is omitted, the provider now resolves it from the parent bridge or from the matching Athena environment defaults. Known Athena staging/prod `apiUrl` and `backendUrl` values automatically fall back to the corresponding frontend origin.
+`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
 
@@ -64,6 +68,26 @@ Preset themes: `light`, `dark`, `midnight`, `warm`, `purple`, `green`.
 - **`<ThreadList>`** — Conversation history sidebar
 - **`Toolkits`** — Constants for all available backend toolkits
 
+## Composer Hooks
+
+Use `useAppendToComposer()` when you want to prefill a draft without sending it.
+
+Use `useSendMessage()` for workflow buttons, sidebar shortcuts, and other UI that lives outside `<AthenaChat>` but still needs to submit a prompt.
+
+```tsx
+import { useSendMessage } from '@athenaintel/react';
+
+function WorkflowButton() {
+  const sendMessage = useSendMessage();
+
+  return (
+    <button onClick={() => void sendMessage('Run the quarterly workflow')}>
+      Run workflow
+    </button>
+  );
+}
+```
+
 ## License
 
 Proprietary. For licensed enterprise customers only.

package/dist/index.cjs

@@ -16491,8 +16491,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 {
@@ -16514,7 +16522,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;
   }
@@ -16563,7 +16571,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) {
@@ -20625,7 +20633,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()
@@ -20777,7 +20787,7 @@ function getAuthHeaders(auth) {
   }
   return {};
 }
-function getAgoraBaseUrl(backendUrl) {
+function getAthenaApiBaseUrl(backendUrl) {
   const stripped = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
   if (stripped === backendUrl) {
     return backendUrl.replace(/\/$/, "");
@@ -20785,14 +20795,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) {
@@ -20814,7 +20826,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) }
@@ -20829,7 +20841,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) },
@@ -24643,6 +24655,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,
@@ -24782,6 +24803,7 @@ function AthenaWithThreadList({
 }
 function AthenaProvider({
   children,
+  config: config2,
   apiKey,
   token: tokenProp,
   agent: agent2,
@@ -24801,15 +24823,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 }),
-    [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;
   }
@@ -24821,7 +24849,7 @@ function AthenaProvider({
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
         appUrl: effectiveAppUrl,
-        apiKey,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -24841,7 +24869,7 @@ function AthenaProvider({
         apiUrl: effectiveApiUrl,
         backendUrl: effectiveBackendUrl,
         appUrl: effectiveAppUrl,
-        apiKey,
+        apiKey: configuredApiKey,
         token: effectiveToken,
         model,
         agent: agent2,
@@ -60770,7 +60798,7 @@ const TiptapComposer = ({ tools = [] }) => {
       composerRuntime.send();
     }
     editor2.commands.clearContent();
-  }, [aui, composerRuntime, clearAttachments, clearQuote]);
+  }, [aui, composerRuntime, clearAttachments, clearQuote, appUrl]);
   const handleSubmitRef = React.useRef(handleSubmit);
   handleSubmitRef.current = handleSubmit;
   const editor = useEditor({
@@ -63680,9 +63708,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) {
@@ -63945,6 +63970,23 @@ const ComposerDropZone = ({
     }
   );
 };
+function useSendMessage() {
+  const aui = useAui();
+  return React.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();
@@ -63976,14 +64018,11 @@ const SuggestionCard = ({
   suggestion,
   index: index2
 }) => {
-  const aui = useAui();
   const Icon2 = suggestion.icon;
+  const sendMessage = useSendMessage();
   const handleClick2 = React.useCallback(() => {
-    aui.thread().append({
-      role: "user",
-      content: [{ type: "text", text: suggestion.prompt }]
-    });
-  }, [aui, suggestion.prompt]);
+    void sendMessage(suggestion.prompt);
+  }, [sendMessage, suggestion.prompt]);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "button",
     {
@@ -64130,7 +64169,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__ */ jsxRuntime.jsx(
       TooltipIconButton,
@@ -64283,8 +64322,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;
@@ -64772,4 +64811,5 @@ exports.useParentAuth = useParentAuth;
 exports.useParentBridge = useParentBridge;
 exports.useQuote = useQuote;
 exports.useRefreshThreadList = useRefreshThreadList;
+exports.useSendMessage = useSendMessage;
 //# sourceMappingURL=index.cjs.map