@athenaintel/react 0.14.0 → 0.15.0

package/dist/chat/ComposerEditorContext.d.ts

@@ -13,6 +13,12 @@ interface EditorHandle {
     isEmpty: () => boolean;
     /** Insert text at the end of the editor. */
     insertText: (text: string) => void;
+    /**
+     * Submit the draft through the composer's canonical send path — the same
+     * path the editor's Enter keybinding uses, including quote/attachment
+     * composition and upload/mid-run guards.
+     */
+    submit: () => void;
 }
 type EditorRef = MutableRefObject<EditorHandle | null>;
 interface EditorContextValue {

package/dist/chat-ui/composer/composer-action.d.ts

@@ -1,5 +1,12 @@
 export type ComposerAction = "send" | "queue" | "stop";
-export declare function resolveComposerAction({ hasDraft, isRunning, }: {
+export declare function resolveComposerAction({ hasDraft, isRunning, canQueue, }: {
     hasDraft: boolean;
     isRunning: boolean;
+    /**
+     * Whether a draft may be queued behind an active run. Transports without a
+     * server-owned queue (the SDK's legacy assistant-transport) pass false so a
+     * running thread always resolves to stop — a mid-run dispatch there would
+     * orphan the in-flight run.
+     */
+    canQueue?: boolean;
 }): ComposerAction;

package/dist/chat-ui/index.d.ts

@@ -12,7 +12,7 @@ export type { ChatThreadMessageComponents, ChatThreadShellProps, } from "./threa
 export { ChatComposerDock } from "./thread/chat-composer-dock";
 export type { ChatComposerDockProps } from "./thread/chat-composer-dock";
 export { ComposerSendOrStop } from "./thread/composer-send-or-stop";
-export type { ComposerSendOrStopProps, ComposerStopControls, } from "./thread/composer-send-or-stop";
+export type { ComposerSendOrStopComponents, ComposerSendOrStopProps, ComposerStopControls, ComposerSubmitHandle, } from "./thread/composer-send-or-stop";
 export { TiptapComposer, plainTextToTiptapContent, type TiptapComposerHandle, type TiptapComposerProps, } from "./composer/tiptap-composer";
 export { PendingAttachmentUploads } from "./composer/pending-attachment-uploads";
 export { resolveComposerAction, type ComposerAction, } from "./composer/composer-action";
@@ -29,6 +29,6 @@ export { buildRootMenuItems } from "./mentions/suggestions/data/sources";
 export { assetTypeToIcon, assetTypeToThumb, configureAssetIconBasePath, } from "./mentions/suggestions/data/sources/asset-type-icons";
 export { MentionMenuSection, type MenuItem, type MenuScope, type WebpageMention, type WebpageMentionScope, } from "./mentions/suggestions/data/types";
 export { createOlympusAssetUrl } from "./lib/asset-urls";
-export { COMPOSER_DOCK_CLASS, COMPOSER_EDITOR_ROW_CLASS, COMPOSER_SURFACE_CLASS, COMPOSER_TOOLBAR_CLASS, BranchPicker, ComposerSendButton, ComposerStopButton, IconButton, MarkdownText, SmallIconButton, THREAD_HEADER_ACTIONS_CLASS, THREAD_HEADER_CLASS, THREAD_HEADER_ICON_CLASS, THREAD_HEADER_PILL_CLASS, THREAD_PANEL_CLASS, THREAD_SCROLL_TO_BOTTOM_CLASS, UserMessage, createAssistantMessage, type CreateAssistantMessageOptions, } from "./messages/message-components";
+export { COMPOSER_DOCK_CLASS, COMPOSER_EDITOR_ROW_CLASS, COMPOSER_SURFACE_CLASS, COMPOSER_TOOLBAR_CLASS, BranchPicker, ComposerSendButton, ComposerStopButton, type ComposerSendButtonProps, type ComposerStopButtonProps, IconButton, MarkdownText, SmallIconButton, THREAD_HEADER_ACTIONS_CLASS, THREAD_HEADER_CLASS, THREAD_HEADER_ICON_CLASS, THREAD_HEADER_PILL_CLASS, THREAD_PANEL_CLASS, THREAD_SCROLL_TO_BOTTOM_CLASS, UserMessage, createAssistantMessage, type CreateAssistantMessageOptions, } from "./messages/message-components";
 export { TextShimmerLoader, ThreadRunningIndicator, } from "./messages/running-indicator";
 export { SignInCard, SignInConsent, SignInFallbackSection, SignInSecondaryButton, SignInSelect, SignInTextField, } from "./auth/sign-in-card";

package/dist/chat-ui/messages/message-components.d.ts

@@ -41,16 +41,18 @@ export declare const COMPOSER_SURFACE_CLASS = "relative flex flex-col gap-1 roun
 export declare const COMPOSER_EDITOR_ROW_CLASS = "px-2.5 pt-1";
 export declare const COMPOSER_TOOLBAR_CLASS = "flex items-center gap-1 border-t border-neutral-100 px-2 py-1.5";
 export declare const THREAD_SCROLL_TO_BOTTOM_CLASS = "inline-flex items-center justify-center rounded-full border bg-background/80 p-1 shadow-sm backdrop-blur transition-opacity hover:bg-accent disabled:invisible";
-/** Stop control shown while a run is in flight and there is nothing queued. */
-export declare const ComposerStopButton: FC<{
+export interface ComposerStopButtonProps {
     onStop: () => void;
     disabled?: boolean;
     title?: string;
-}>;
-/** Send control, which becomes a queue control while a run is in flight. */
-export declare const ComposerSendButton: FC<{
+}
+export interface ComposerSendButtonProps {
     action: Extract<ComposerAction, "send" | "queue">;
     onSend: () => void;
     disabled?: boolean;
     title?: string;
-}>;
+}
+/** Stop control shown while a run is in flight and there is nothing queued. */
+export declare const ComposerStopButton: FC<ComposerStopButtonProps>;
+/** Send control, which becomes a queue control while a run is in flight. */
+export declare const ComposerSendButton: FC<ComposerSendButtonProps>;

package/dist/chat-ui/thread/chat-composer-dock.d.ts

@@ -1,5 +1,17 @@
 import type { ReactNode } from "react";
 export interface ChatComposerDockProps {
+    /**
+     * Replaces the dock chrome (padding + background around the surface).
+     * Hosts with their own composer chrome system (AthenaChat's `aui-*`
+     * classes) pass their chrome here; the scaffolding structure stays shared.
+     */
+    className?: string;
+    /** Replaces the bordered composer-surface chrome. */
+    surfaceClassName?: string;
+    /** Replaces the editor-row chrome. */
+    editorRowClassName?: string;
+    /** Replaces the toolbar-row chrome. */
+    toolbarClassName?: string;
     /** Rendered inside the dock, above the composer surface (error banners). */
     aboveSurface?: ReactNode;
     /**
@@ -19,4 +31,4 @@ export interface ChatComposerDockProps {
  * editor row, and the toolbar with its start/end slots around a flexible
  * spacer. Hosts supply the editor element and toolbar controls.
  */
-export declare function ChatComposerDock({ aboveSurface, beforeEditor, editor, toolbarStart, toolbarEnd, }: ChatComposerDockProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatComposerDock({ className, surfaceClassName, editorRowClassName, toolbarClassName, aboveSurface, beforeEditor, editor, toolbarStart, toolbarEnd, }: ChatComposerDockProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat-ui/thread/chat-thread-shell.d.ts

@@ -4,6 +4,13 @@ export interface ChatThreadMessageComponents {
     AssistantMessage: FC;
 }
 export interface ChatThreadShellProps {
+    /**
+     * Rendered as the first child of the panel — for absolutely-positioned
+     * scrims that must cover the whole panel (AthenaChat's thread-loading
+     * overlay). The shell does not force a positioning context; hosts include
+     * `relative` in `panelClassName` when the scrim anchors to the panel.
+     */
+    overlay?: ReactNode;
     /**
      * Rendered above the viewport, inside the panel: header rows, slide-over
      * panels, and anything else the host docks at the top.
@@ -13,8 +20,8 @@ export interface ChatThreadShellProps {
     banners?: ReactNode;
     /**
      * Nodes rendered inside the scroll viewport before the message column —
-     * absolutely-positioned overlays (thread-switch skeletons) and invisible
-     * observers (read receipts).
+     * absolutely/sticky-positioned overlays (thread-switch skeletons,
+     * scroll-to-top controls) and invisible observers (read receipts).
      */
     viewportOverlay?: ReactNode;
     /** Empty-thread state, rendered via ThreadPrimitive.Empty when provided. */
@@ -33,14 +40,58 @@ export interface ChatThreadShellProps {
     belowViewport?: ReactNode;
     /** The composer dock (or a read-only notice replacing it). */
     composer?: ReactNode;
+    /**
+     * Replaces the docked-panel card chrome — for hosts that render a
+     * full-page column (AthenaChat's `aui-*` surface) instead of the
+     * side-panel/task-pane card.
+     */
+    panelClassName?: string;
+    /**
+     * Value of the `--thread-max-width` variable read by width-capped
+     * message/welcome/footer columns. Panels fill their width (the default,
+     * "100%"); full-page hosts cap the column (AthenaChat defaults to 44rem).
+     */
+    maxWidth?: string;
+    /**
+     * Anchors the latest turn to the top of the viewport instead of pinning
+     * scroll to the bottom (AthenaChat). Omitted = the primitive's default.
+     */
+    turnAnchor?: "top" | "bottom";
+    /** Replaces the scroll-viewport chrome (padding, overflow tuning). */
+    viewportClassName?: string;
+    /**
+     * Replaces the message-column chrome. Hosts whose welcome screen centers
+     * vertically make this a flex column so the welcome node can grow.
+     */
+    contentClassName?: string;
+    /**
+     * Thread-level "Thinking..." indicator rendered after the messages. Hosts
+     * whose message components render their own per-message indicators pass
+     * null so the two never double up.
+     */
+    runningIndicator?: ReactNode;
+    /**
+     * Replaces the default centered scroll-to-bottom pill inside the sticky
+     * viewport footer (AthenaChat floats a circular button above its composer).
+     */
+    scrollToBottom?: ReactNode;
+    /**
+     * Content docked inside the sticky viewport footer, after the
+     * scroll-to-bottom control — for hosts whose banners + composer float over
+     * the scrolling messages (AthenaChat) instead of sitting below the
+     * viewport via `belowViewport`/`composer`.
+     */
+    viewportFooter?: ReactNode;
+    /** Replaces the sticky viewport-footer chrome. */
+    viewportFooterClassName?: string;
 }
 /**
- * The shared side-panel/task-pane thread layout: panel chrome, scroll
- * viewport with welcome + messages + running indicator, the sticky
- * scroll-to-bottom control, and the host-supplied composer dock.
+ * The shared thread layout: panel chrome, scroll viewport with welcome +
+ * messages + running indicator, the sticky scroll-to-bottom control, and the
+ * host-supplied composer dock.
  *
  * Hosts express their genuine divergences through the slots above; the
  * layout, scroll behaviour, and empty/running states stay identical across
  * surfaces so fixes land once.
  */
-export declare function ChatThreadShell({ header, banners, viewportOverlay, welcome, components, renderMessages, belowViewport, composer, }: ChatThreadShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatThreadShell({ overlay, header, banners, viewportOverlay, welcome, components, renderMessages, belowViewport, composer, panelClassName, maxWidth, turnAnchor, viewportClassName, contentClassName, runningIndicator, scrollToBottom, viewportFooter, viewportFooterClassName, }: ChatThreadShellProps): import("react/jsx-runtime").JSX.Element;

package/dist/chat-ui/thread/composer-send-or-stop.d.ts

@@ -1,6 +1,14 @@
 import type { FC, RefObject } from "react";
 import { type ComposerAction } from "../composer/composer-action";
-import type { TiptapComposerHandle } from "../composer/tiptap-composer";
+import { type ComposerSendButtonProps, type ComposerStopButtonProps } from "../messages/message-components";
+/**
+ * The slice of a composer handle this control needs: something whose draft
+ * can be submitted. `TiptapComposerHandle` satisfies it; hosts with their own
+ * editor plumbing (the SDK's AthenaChat) expose a compatible handle.
+ */
+export interface ComposerSubmitHandle {
+    submit: () => void | Promise<void>;
+}
 export interface ComposerStopControls {
     /**
      * Cancels the active run via the runtime. Returns false when cancellation
@@ -9,9 +17,23 @@ export interface ComposerStopControls {
      */
     cancelRun: () => boolean;
 }
+/**
+ * Control renderers, for hosts with their own published theming contract
+ * (AthenaChat's `aui-*` class system). Defaults render the shared buttons.
+ */
+export interface ComposerSendOrStopComponents {
+    SendButton?: FC<ComposerSendButtonProps>;
+    StopButton?: FC<ComposerStopButtonProps>;
+}
 export interface ComposerSendOrStopProps {
-    composerRef: RefObject<TiptapComposerHandle | null>;
+    composerRef: RefObject<ComposerSubmitHandle | null>;
     hasDraft: boolean;
+    /**
+     * Whether a draft may queue behind an active run (server-owned queue).
+     * Hosts on transports without a queue pass false so an active run always
+     * resolves to stop. Defaults to true.
+     */
+    canQueue?: boolean;
     /** Disables both send and stop (e.g. while a conversation restores). */
     disabled?: boolean;
     /**
@@ -35,6 +57,7 @@ export interface ComposerSendOrStopProps {
      * work sequence it around `controls.cancelRun()`. Default: cancel the run.
      */
     onStop?: (controls: ComposerStopControls) => void;
+    components?: ComposerSendOrStopComponents;
 }
 /**
  * The shared send/queue/stop control: sends the composer draft, queues it as