@athenaintel/react 0.42.2 → 0.48.0

package/dist/chat/AthenaChat.d.ts

@@ -1,11 +1,13 @@
+import { type StatewireDecisionConfirmer } from './StatewireApprovalCard';
+import type { ThreadDriverSurface } from '../agent-runtime/src/thread-driver';
 import { type ComposerSendOrStopProps } from '../chat-ui/thread/composer-send-or-stop';
 import type { DictationEngine } from '../dictation/dictation-engine';
 import type { MentionTool } from '../chat-ui/mentions/suggestions/data/types';
 import { type WelcomeSuggestion } from './athena-chat-welcome';
 import type { EmptyMessagePartComponent, ReasoningMessagePartProps, ReasoningMessagePartComponent, TextMessagePartComponent, ToolCallMessagePartComponent } from '@assistant-ui/react';
 import { type FC, type ReactNode } from 'react';
-import { type AthenaChatVoiceOptions } from './chat-voice-controls';
-export type { AthenaChatVoiceOptions } from './chat-voice-controls';
+import { type AthenaChatContinueByVoice, type AthenaChatVoiceOptions } from './chat-voice-controls';
+export type { AthenaChatContinueByVoice, AthenaChatVoiceOptions } from './chat-voice-controls';
 export type { WelcomeSuggestion } from './athena-chat-welcome';
 export interface AthenaChatProps {
     /** CSS class name for the root element. */
@@ -34,6 +36,22 @@ export interface AthenaChatProps {
      * express a per-thread fence, so the host that knows passes it here.
      */
     readOnly?: boolean;
+    /**
+     * The Athena app this chat runs in. With it, the chat says when the person
+     * is driving the conversation from another of their apps ("Driving on your
+     * phone") above the composer. Omit it in an app that is not one of Athena's
+     * own and nothing shows.
+     */
+    surface?: ThreadDriverSurface;
+    /**
+     * "Confirm with your passkey" before an approval that lets anything run
+     * (identity 0b.9): handed to the chat's approval card, which sends the
+     * token it resolves as `decisionCheck`. An app on another origin than the
+     * Athena web app passes `useAthenaBrowserDecisionConfirmer()`, which runs
+     * the check in a browser tab on the web app. Omit it and approvals are
+     * sent without a check, as before (report-only).
+     */
+    confirmDecision?: StatewireDecisionConfirmer;
     /** Additional tool UIs to register by name. */
     toolUIs?: Record<string, ToolCallMessagePartComponent>;
     /** Tools / Toolkits offered by the composer's `@` menu beside the asset
@@ -78,6 +96,16 @@ export interface AthenaChatProps {
      * The default browser adapter loads its LiveKit dependency only on start.
      */
     voice?: boolean | AthenaChatVoiceOptions;
+    /**
+     * A "Continue by voice" offer for the open conversation, after a handover
+     * the person sent in voice mode landed in this app. The composer shows one
+     * button above the editor while voice is enabled and idle; tapping it starts
+     * a call whose model opens by saying where things stand. `onDone` runs when
+     * the person answers it (the tap, Not now, or a typed or dictated send):
+     * clear the offer then, and when the conversation changes. `null` or absent:
+     * no offer. A `readOnly` chat never shows it.
+     */
+    continueByVoice?: AthenaChatContinueByVoice | null;
 }
 export interface AthenaChatComposerSlots {
     /** The empty composer's hint (default "Type @ to tag an asset"). */
@@ -94,6 +122,18 @@ export interface AthenaChatComposerSlots {
     toolbarEnd?: ReactNode;
     /** Host work to run before a draft submits (also runs for a dictated send). */
     onBeforeSend?: ComposerSendOrStopProps['onBeforeSend'];
+    /**
+     * Why the composer's controls that need Athena are off, while the host knows Athena can't be
+     * reached (from its own reachability: Olympus's model, the desktop app's main process). Attach
+     * (the paperclip), the `@` button, dictation's mic and voice then show disabled with this as their
+     * tooltip, instead of failing once used, and come back as soon as it is cleared. Typing `@` still
+     * opens the mention menu, which fetches nothing from Athena: what it can list without Athena (the
+     * host's tools, what it already loaded) shows, and what would load from Athena says it needs a
+     * connection (`NEEDS_CONNECTION`) instead of spinning. Typing goes on, and Send follows the chat
+     * outbox (a host that has one holds what is sent until Athena is back). A file pasted or dropped
+     * meanwhile is refused as before, by the chat outbox's own reachability. `null` or absent: on.
+     */
+    needsConnectionReason?: string | null;
 }
 export interface AthenaChatDictationOptions {
     /**

package/dist/chat/AthenaChat.js

@@ -5,8 +5,10 @@ import { StatewireApprovalCard } from "./StatewireApprovalCard.js";
 import { StatewireQueuedMessages } from "./StatewireQueuedMessages.js";
 import { StatewireConnectionBanner, StatewireErrorBanner } from "./statewire-banners.js";
 import { AthenaChatModeMenu } from "../catalog/chat-pickers.js";
+import { NEEDS_CONNECTION } from "../agent-runtime/src/offline-status.js";
 import { StatewireRunRefusalNotice } from "./StatewireRunRefusalNotice.js";
 import { WaitingOnYouBanner } from "./WaitingOnYouBanner.js";
+import { DrivingOnChip } from "./DrivingOnChip.js";
 import { OfflineSnapshotBanner } from "../offline/offline-history.js";
 import { WakeMarkerMessage } from "../chat-ui/messages/wake-marker.js";
 import { ToolFallback, ToolFallbackAppearanceProvider } from "../tools/tool-fallback.js";
@@ -37,7 +39,10 @@ import { composeDictationDraft, DICTATION_STATUSES } from "../dictation/dictatio
 import { useAthenaDictationEngine } from "../dictation/use-athena-dictation-engine.js";
 import { TiptapComposer } from "../chat-ui/composer/tiptap-composer.js";
 import { MentionAuthCtx } from "../chat-ui/mentions/suggestions/data/api-client.js";
-import { useAccountWorkspaceId } from "../chat-ui/mentions/use-account-workspace-id.js";
+import { useAccountIdentity } from "../chat-ui/mentions/use-account-workspace-id.js";
+import { AnswerLabel } from "../chat-ui/messages/answer-label.js";
+import { useMessageArrivalAnimation, MESSAGE_ARRIVAL_ANIMATION_CLASS } from "../chat-ui/messages/arrival-animation.js";
+import { MessageImagePart, MessageImageGallery } from "../chat-ui/messages/message-images.js";
 import { ACTION_BAR_REVEAL_CLASS, BranchPicker, UserMessageText } from "../chat-ui/messages/message-components.js";
 import { useMessageActionsReadOnly } from "../chat-ui/messages/message-actions-config.js";
 import { useAthenaRunLive } from "./use-athena-run-live.js";
@@ -71,7 +76,7 @@ import { ThreadScrollToBottom } from "./thread-scroll-to-bottom.js";
 import { QueryClientProvider } from "@tanstack/react-query";
 import { useCatalogQueryClient } from "../catalog/runtime-catalog.js";
 import { isStatewireChannelLive } from "../runtime/statewire-lifecycle.js";
-import { useComposerChatVoice, ChatVoiceButton, ChatVoiceStatus } from "./chat-voice-controls.js";
+import { useComposerChatVoice, ChatVoiceButton, ChatVoiceStatus, ChatVoiceContinueOffer } from "./chat-voice-controls.js";
 import { TASK_TOOL_NAME } from "../agent-runtime/src/tool-names.js";
 import { useTurnToolCallsAwaitingApproval } from "../agent-runtime/src/subagents.js";
 import { isGithubWakeMessage } from "../agent-runtime/src/github-wake-event.js";
@@ -159,6 +164,8 @@ const AthenaChatContent = ({
   maxWidth = "46rem",
   turnAnchor = "bottom",
   readOnly = false,
+  surface,
+  confirmDecision,
   toolUIs,
   mentionTools,
   welcomeSuggestions = DEFAULT_WELCOME_SUGGESTIONS,
@@ -166,7 +173,8 @@ const AthenaChatContent = ({
   groupToolCalls = true,
   composer: composerSlots,
   dictation = true,
-  voice = true
+  voice = true,
+  continueByVoice = null
 }) => {
   var _a, _b, _c, _d, _e, _f;
   const athenaConfig = useAthenaConfig();
@@ -197,7 +205,8 @@ const AthenaChatContent = ({
     },
     [athenaConfig, (_b = authState == null ? void 0 : authState.user) == null ? void 0 : _b.userId]
   );
-  const accountWorkspaceId = useAccountWorkspaceId(mentionCredentials);
+  const account = useAccountIdentity(mentionCredentials, { tokenGetter: athenaConfig.getToken });
+  const accountWorkspaceId = account.workspaceId;
   const mentionAuth = useMemo(
     () => ({
       ...mentionCredentials,
@@ -280,6 +289,8 @@ const AthenaChatContent = ({
       maxWidth,
       turnAnchor,
       readOnly,
+      arrivalThreadId: statewireThreadId,
+      viewerUserId: account.userId ?? null,
       banners: /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsx(OfflineSnapshotBanner, { className: "px-4 pt-3" }),
         /* @__PURE__ */ jsx(WaitingOnYouBanner, { className: "px-4 pt-3" })
@@ -291,14 +302,15 @@ const AthenaChatContent = ({
       beforeMessages: /* @__PURE__ */ jsx(StatewireHistoryEdge, { className: "aui-thread-history-edge" }),
       components: messageComponents,
       runningIndicator: null,
-      scrollToBottom: null,
+      scrollToBottom: /* @__PURE__ */ jsx(ThreadScrollToBottom, {}),
       viewportFooterClassName: "aui-thread-viewport-footer sticky bottom-0 mx-auto mt-auto flex w-full max-w-(--thread-max-width) flex-col gap-4 overflow-visible rounded-t-3xl bg-background pt-4 pb-4 md:pb-6",
       viewportFooter: /* @__PURE__ */ jsxs(Fragment, { children: [
         welcomeSuggestions.length > 0 && /* @__PURE__ */ jsx(ThreadPrimitive.Empty, { children: /* @__PURE__ */ jsx(AthenaChatWelcomeSuggestions, { suggestions: welcomeSuggestions }) }),
+        surface && /* @__PURE__ */ jsx(DrivingOnChip, { here: surface }),
         /* @__PURE__ */ jsx(StatewireConnectionBanner, {}),
         /* @__PURE__ */ jsx(StatewireErrorBanner, { onStartNewSession: startNewSession }),
         /* @__PURE__ */ jsx(StatewireRunRefusalNotice, { onStartNewSession: startNewSession }),
-        /* @__PURE__ */ jsx(StatewireApprovalCard, {}),
+        /* @__PURE__ */ jsx(StatewireApprovalCard, { confirmDecision }),
         /* @__PURE__ */ jsx(StatewireQueuedMessages, {}),
         /* @__PURE__ */ jsx(AttachmentProvider, { children: /* @__PURE__ */ jsxs(QuoteProvider, { children: [
           /* @__PURE__ */ jsx(QuotePostMessageBridge, {}),
@@ -309,6 +321,7 @@ const AthenaChatContent = ({
               slots: composerSlots,
               dictation,
               voice: readOnly ? false : voice,
+              continueByVoice: readOnly ? null : continueByVoice,
               welcomeSuggestionCount: welcomeSuggestions.length
             }
           )
@@ -367,7 +380,7 @@ const ATHENA_CHAT_MENTION_CATEGORIES = [
   "projects",
   "folders"
 ];
-const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welcomeSuggestionCount }) => {
+const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, continueByVoice, welcomeSuggestionCount }) => {
   const aui = useAui();
   const threadId = useAthenaStatewireThreadId();
   const { appUrl } = useAthenaConfig();
@@ -387,6 +400,7 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
     [setAttachNotice]
   );
   const notice = composerNotice ?? attachNotice;
+  const needsConnectionReason = (slots == null ? void 0 : slots.needsConnectionReason) || null;
   const isRunning = useAuiState((state) => {
     var _a;
     return ((_a = state.optional.thread) == null ? void 0 : _a.isRunning) ?? false;
@@ -478,6 +492,17 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
     },
     [appUrl, aui, clearAttachments, clearQuote, threadId]
   );
+  const continueByVoiceRef = useRef(continueByVoice);
+  continueByVoiceRef.current = continueByVoice;
+  const settleContinueByVoice = useCallback(() => {
+    var _a;
+    return (_a = continueByVoiceRef.current) == null ? void 0 : _a.onDone();
+  }, []);
+  const { onSubmitted: onKeyboardHintSubmitted } = keyboardHint;
+  const handleComposerSubmitted = useCallback(() => {
+    onKeyboardHintSubmitted();
+    settleContinueByVoice();
+  }, [onKeyboardHintSubmitted, settleContinueByVoice]);
   const interceptSubmit = useCallback(
     async (text, draftMarkdown) => {
       if (attachmentsRef.current.length > 0 || quoteRef.current !== null) {
@@ -549,6 +574,7 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
       });
       return;
     }
+    settleContinueByVoice();
     if (extras) {
       sendComposed(send);
       return;
@@ -556,7 +582,17 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
     prepareComposerSend({ threadId, ...send });
     aui.composer.setText(send.text);
     aui.composer.send({ steer: false });
-  }, [appendSpokenText, aui, dictationCtl, isRunning, sendComposed, sessionLane, slots, threadId]);
+  }, [
+    appendSpokenText,
+    aui,
+    dictationCtl,
+    isRunning,
+    sendComposed,
+    sessionLane,
+    settleContinueByVoice,
+    slots,
+    threadId
+  ]);
   return /* @__PURE__ */ jsxs(ComposerDropZone, { onDragActiveChange: setDragActive, children: [
     /* @__PURE__ */ jsx("audio", { ref: audioRef, autoPlay: true, playsInline: true }),
     /* @__PURE__ */ jsx(
@@ -570,9 +606,25 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
           {
             appearance: "paper",
             dragActive,
-            aboveSurface: /* @__PURE__ */ jsx(ThreadScrollToBottom, {}),
             beforeEditor: /* @__PURE__ */ jsxs(Fragment, { children: [
-              /* @__PURE__ */ jsx(ChatVoiceStatus, { voice }),
+              /* @__PURE__ */ jsx(
+                ChatVoiceStatus,
+                {
+                  voice,
+                  offerMove: voiceEnabled,
+                  moveDisabled: isUploading || dictationCtl.isActive || !isStatewireChannelLive(connection),
+                  moveDisabledReason: needsConnectionReason
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                ChatVoiceContinueOffer,
+                {
+                  voice,
+                  offer: voiceEnabled ? continueByVoice : null,
+                  disabled: isUploading || dictationCtl.isActive || !isStatewireChannelLive(connection),
+                  disabledReason: needsConnectionReason
+                }
+              ),
               /* @__PURE__ */ jsx(ComposerQuotePreview, {}),
               /* @__PURE__ */ jsx(ComposerAttachmentPreview, {})
             ] }),
@@ -587,13 +639,14 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
                   tools,
                   rootCategories,
                   onDraftStateChange,
+                  mentionSearchUnavailable: needsConnectionReason ? NEEDS_CONNECTION : null,
                   waitForHostUploads,
                   interceptSubmit,
                   hasPendingExtras,
                   holdPendingExtras,
                   onAttachmentError: setComposerNotice,
                   fileIntake,
-                  onSubmitted: keyboardHint.onSubmitted
+                  onSubmitted: handleComposerSubmitted
                 }
               ) }),
               notice && /* @__PURE__ */ jsx("p", { className: "aui-composer-notice px-1.5 pb-1 text-destructive text-xs", role: "alert", children: notice }),
@@ -609,14 +662,21 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
               dictationEnabled && dictationCtl.status === DICTATION_STATUSES.error && dictationCtl.error && /* @__PURE__ */ jsx("p", { className: "aui-dictation-error px-1.5 pb-1 text-destructive text-xs", role: "alert", children: dictationCtl.error.message })
             ] }),
             toolbarStart: /* @__PURE__ */ jsx("div", { className: "flex items-center gap-1", children: recording ? /* @__PURE__ */ jsx(DictationCancelButton, { onClick: dictationCtl.cancel }) : /* @__PURE__ */ jsxs(Fragment, { children: [
-              /* @__PURE__ */ jsx(FileUploadButton, { className: "aui-composer-attach size-8 rounded-full p-0 disabled:opacity-30" }),
+              /* @__PURE__ */ jsx(
+                FileUploadButton,
+                {
+                  className: "aui-composer-attach size-8 rounded-full p-0 disabled:opacity-30",
+                  disabledReason: needsConnectionReason
+                }
+              ),
               /* @__PURE__ */ jsx(
                 AthenaComposerMentionButton,
                 {
                   onClick: () => {
                     var _a, _b;
                     return (_b = (_a = composerRef.current) == null ? void 0 : _a.openMentionMenu) == null ? void 0 : _b.call(_a);
-                  }
+                  },
+                  disabledReason: needsConnectionReason
                 }
               ),
               /* @__PURE__ */ jsx(AthenaChatModeMenu, {}),
@@ -641,14 +701,29 @@ const AthenaChatComposer = ({ tools, slots, dictation, voice: voiceOptions, welc
               )
             ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
               slots == null ? void 0 : slots.toolbarEnd,
-              showMic && /* @__PURE__ */ jsx(DictationMicButton, { onClick: dictationCtl.start, disabled: isUploading }),
-              voiceEnabled && /* @__PURE__ */ jsx(ChatVoiceButton, { voice, disabled: isUploading || dictationCtl.isActive || !isStatewireChannelLive(connection) }),
+              showMic && /* @__PURE__ */ jsx(
+                DictationMicButton,
+                {
+                  onClick: dictationCtl.start,
+                  disabled: isUploading,
+                  disabledReason: needsConnectionReason
+                }
+              ),
+              voiceEnabled && /* @__PURE__ */ jsx(
+                ChatVoiceButton,
+                {
+                  voice,
+                  disabled: isUploading || dictationCtl.isActive || !isStatewireChannelLive(connection),
+                  disabledReason: needsConnectionReason
+                }
+              ),
               /* @__PURE__ */ jsx(
                 ComposerSendOrStop,
                 {
                   composerRef,
                   hasDraft: hasText || hasExtras,
                   liveVoice: voice.phase === "live" && !hasExtras,
+                  liveSession: voiceActive ? voice : null,
                   sendBlockedReason: isUploading ? "Upload in progress..." : null,
                   onBeforeSend: slots == null ? void 0 : slots.onBeforeSend,
                   components: ATHENA_COMPOSER_COMPONENTS
@@ -943,10 +1018,14 @@ const AthenaAssistantMessage = ({
     }),
     [EmptyComponent, TextComponent, effectiveReasoningComponent, toolUIsWithNestedMessages]
   );
+  const arrivedLive = useMessageArrivalAnimation();
   return /* @__PURE__ */ jsxs(
     MessagePrimitive.Root,
     {
-      className: "aui-assistant-message-root group/aui-assistant-message fade-in slide-in-from-bottom-1 relative mx-auto w-full max-w-(--thread-max-width) animate-in py-3 duration-150",
+      className: cn(
+        "aui-assistant-message-root group/aui-assistant-message relative mx-auto w-full max-w-(--thread-max-width) py-3",
+        arrivedLive && MESSAGE_ARRIVAL_ANIMATION_CLASS
+      ),
       "data-role": "assistant",
       children: [
         /* @__PURE__ */ jsx(MessageDaySeparator, {}),
@@ -960,6 +1039,7 @@ const AthenaAssistantMessage = ({
             }
           ) : null,
           /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+            /* @__PURE__ */ jsx(AnswerLabel, { className: "px-2 pb-1" }),
             /* @__PURE__ */ jsx(AthenaReasoningTextComponentContext.Provider, { value: TextComponent, children: /* @__PURE__ */ jsxs("div", { className: "aui-assistant-message-content wrap-break-word px-2 text-foreground leading-relaxed", children: [
               /* @__PURE__ */ jsx(NestedPtcComponentsProvider, { components: nestedPtcComponents, children: groupToolCalls ? /* @__PURE__ */ jsxs("div", { className: "flex flex-col space-y-2", children: [
                 /* @__PURE__ */ jsx(
@@ -1127,6 +1207,11 @@ const AthenaUserMessage = ({
       return isGithubWakeMessage((_a = s.message.metadata) == null ? void 0 : _a.custom) || isSubscriptionWakeMessage((_b = s.message.metadata) == null ? void 0 : _b.custom);
     }
   );
+  const arrivedLive = useMessageArrivalAnimation();
+  const partComponents = useMemo(
+    () => ({ Text: TextComponent, Image: MessageImagePart }),
+    [TextComponent]
+  );
   if (isWake) {
     return /* @__PURE__ */ jsxs(
       MessagePrimitive.Root,
@@ -1143,12 +1228,15 @@ const AthenaUserMessage = ({
   return /* @__PURE__ */ jsxs(
     MessagePrimitive.Root,
     {
-      className: "aui-user-message-root group/aui-user-message fade-in slide-in-from-bottom-1 mx-auto flex w-full max-w-(--thread-max-width) animate-in flex-col items-end px-2 py-3 duration-150",
+      className: cn(
+        "aui-user-message-root group/aui-user-message mx-auto flex w-full max-w-(--thread-max-width) flex-col items-end px-2 py-3",
+        arrivedLive && MESSAGE_ARRIVAL_ANIMATION_CLASS
+      ),
       "data-role": "user",
       children: [
         /* @__PURE__ */ jsx(MessageDaySeparator, {}),
         /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 max-w-[75%] flex-col items-end gap-1", children: [
-          /* @__PURE__ */ jsx("div", { className: "aui-user-message-content wrap-break-word rounded-2xl bg-muted/70 px-4 py-2.5 text-foreground", children: /* @__PURE__ */ jsx(MessagePrimitive.Parts, { components: { Text: TextComponent } }) }),
+          /* @__PURE__ */ jsx("div", { className: "aui-user-message-content wrap-break-word rounded-2xl bg-muted/70 px-4 py-2.5 text-foreground", children: /* @__PURE__ */ jsx(MessageImageGallery, { children: /* @__PURE__ */ jsx(MessagePrimitive.Parts, { components: partComponents }) }) }),
           /* @__PURE__ */ jsxs("div", { className: "aui-user-message-footer -mr-1 flex items-center gap-1", children: [
             /* @__PURE__ */ jsx(MessageTimestamp, { className: "mr-1 group-hover/aui-user-message:opacity-100" }),
             /* @__PURE__ */ jsx(BranchPicker, {}),