@foris/ai-agent 1.0.5 → 1.0.7

package/dist/components/chat-panel/{ChatPanel.d.ts → chat-panel/ChatPanel.d.ts}

@@ -1,26 +1,12 @@
 import type { FC } from 'react';
 import { type AiAgentTheme, type ResolveSyntaxAppearanceFn } from '@/context/AiAgentThemeContext';
-import type { SuggestionType } from '../../types/chat';
-import type { DataSource } from '../../types/dataSource';
-export interface ChatPanelTranslations {
-    title?: string;
-    welcomeTitle?: string;
-    welcomeDescription?: string;
-    suggestionsTitle?: string;
-    placeholder?: string;
-    disclaimer?: string;
-    clearChatTitle?: string;
-    clearChatDescription?: string;
-    clearChatConfirm?: string;
-    clearChatCancel?: string;
-    clearChatTooltipTitle?: string;
-    clearChatTooltipDescription?: string;
-}
+import type { SuggestionType } from '../../../types/chat';
+import type { DataSource } from '../../../types/dataSource';
+import type { ChatPanelTranslations } from './chatPanel.types';
 interface ChatPanelProps extends React.HTMLAttributes<HTMLDivElement> {
     dataSource: DataSource;
     className?: string;
     onClose?: () => void;
-    onMenuClick?: () => void;
     locale?: 'en' | 'es';
     translations?: ChatPanelTranslations;
     initialSuggestions?: SuggestionType[];

package/dist/components/chat-panel/chat-panel/chatPanel.constants.d.ts

@@ -0,0 +1,6 @@
+import type { MessageType } from './chatPanel.types';
+/**
+ * Mock fixtures for dev / storybook visibility of every MessageType variant.
+ * Not used by production code paths.
+ */
+export declare const MOCK_MESSAGES: MessageType[];

package/dist/components/chat-panel/chat-panel/chatPanel.types.d.ts

@@ -0,0 +1,84 @@
+import type { ToolCall } from '../../../types/chat';
+export type ErrorMessageKind = 'connection' | 'response';
+export interface ChatPanelTranslations {
+    title?: string;
+    welcomeTitle?: string;
+    welcomeDescription?: string;
+    suggestionsTitle?: string;
+    placeholder?: string;
+    placeholderProcessing?: string;
+    placeholderDisconnected?: string;
+    processingTooltip?: string;
+    sendMessageAriaLabel?: string;
+    disclaimer?: string;
+    clearChatTitle?: string;
+    clearChatDescription?: string;
+    clearChatConfirm?: string;
+    clearChatCancel?: string;
+    clearChatTooltipTitle?: string;
+    clearChatTooltipDescription?: string;
+    suggestionsTooltipTitle?: string;
+    suggestionsTooltipDescription?: string;
+    footerResponseCopyTooltip?: string;
+    footerResponseCopiedTooltip?: string;
+    errorFullBodyTitle?: string;
+    errorFullBodyDescription?: string;
+    errorFullBodyRetry?: string;
+    errorFullBodyReconnecting?: string;
+    errorConnectionInlineTitle?: string;
+    errorConnectionInlineRetry?: string;
+    errorResponseTitle?: string;
+    errorResponseRetry?: string;
+    thinkingStep1?: string;
+    thinkingStep2?: string;
+    thinkingUsingTool?: string;
+    thinkingPreparing?: string;
+    reasoningTraceSingular?: string;
+    reasoningTracePlural?: string;
+    reasoningTraceParameters?: string;
+    reasoningTraceResult?: string;
+}
+export interface UserMessage {
+    key: string;
+    from: 'user';
+    generatedAt?: number;
+    sources?: {
+        href: string;
+        title: string;
+    }[];
+    versions: {
+        id: string;
+        content: string;
+    }[];
+    reasoning?: {
+        content: string;
+        duration: number;
+    };
+    tools?: ToolCall[];
+}
+export interface AssistantMessage {
+    key: string;
+    from: 'assistant';
+    generatedAt?: number;
+    sources?: {
+        href: string;
+        title: string;
+    }[];
+    versions: {
+        id: string;
+        content: string;
+    }[];
+    reasoning?: {
+        content: string;
+        duration: number;
+    };
+    tools?: ToolCall[];
+}
+export interface ErrorMessage {
+    key: string;
+    from: 'error';
+    kind: ErrorMessageKind;
+    failedUserMessageKey: string;
+}
+export type MessageType = UserMessage | AssistantMessage | ErrorMessage;
+export declare const isErrorMessage: (message: MessageType) => message is ErrorMessage;

package/dist/components/chat-panel/chat-panel/index.d.ts

@@ -0,0 +1,3 @@
+export { ChatPanel } from './ChatPanel';
+export type { ChatPanelTranslations } from './chatPanel.types';
+export type { MessageType } from './chatPanel.types';

package/dist/components/chat-panel/{ChatPanelClearDialog.d.ts → clear-dialog/ClearDialog.d.ts}

@@ -1,5 +1,5 @@
 import type { FC } from 'react';
-interface ChatPanelClearDialogProps {
+interface ClearDialogProps {
     isOpen: boolean;
     onOpenChange: (open: boolean) => void;
     container: HTMLElement | null;
@@ -9,5 +9,5 @@ interface ChatPanelClearDialogProps {
     cancelLabel: string;
     onConfirm: () => void;
 }
-declare const ChatPanelClearDialog: FC<ChatPanelClearDialogProps>;
-export default ChatPanelClearDialog;
+declare const ClearDialog: FC<ClearDialogProps>;
+export default ClearDialog;

package/dist/components/chat-panel/clear-dialog/index.d.ts

@@ -0,0 +1 @@
+export { default as ClearDialog } from './ClearDialog';

package/dist/components/chat-panel/error-connection-fullbody/ErrorConnectionFullBody.d.ts

@@ -0,0 +1,4 @@
+import { type FC } from 'react';
+import type { ErrorConnectionFullBodyProps } from './errorConnectionFullBody.type';
+declare const ErrorConnectionFullBody: FC<ErrorConnectionFullBodyProps>;
+export default ErrorConnectionFullBody;

package/dist/components/chat-panel/error-connection-fullbody/errorConnectionFullBody.type.d.ts

@@ -0,0 +1,11 @@
+export interface ErrorConnectionFullBodyTranslations {
+    title?: string;
+    description?: string;
+    retryLabel?: string;
+    reconnectingLabel?: string;
+}
+export interface ErrorConnectionFullBodyProps {
+    onRetry: () => Promise<void> | void;
+    translations?: ErrorConnectionFullBodyTranslations;
+    className?: string;
+}

package/dist/components/chat-panel/error-connection-fullbody/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ErrorConnectionFullBody } from './ErrorConnectionFullBody';
+export type { ErrorConnectionFullBodyProps, ErrorConnectionFullBodyTranslations, } from './errorConnectionFullBody.type';

package/dist/components/chat-panel/error-connection-inline/ErrorConnectionInline.d.ts

@@ -0,0 +1,4 @@
+import type { FC } from 'react';
+import type { ErrorConnectionInlineProps } from './errorConnectionInline.type';
+declare const ErrorConnectionInline: FC<ErrorConnectionInlineProps>;
+export default ErrorConnectionInline;

package/dist/components/chat-panel/error-connection-inline/errorConnectionInline.type.d.ts

@@ -0,0 +1,10 @@
+export interface ErrorConnectionInlineTranslations {
+    title?: string;
+    retryLabel?: string;
+}
+export interface ErrorConnectionInlineProps {
+    failedUserMessageKey: string;
+    onRetry: (failedUserMessageKey: string) => Promise<void> | void;
+    translations?: ErrorConnectionInlineTranslations;
+    className?: string;
+}

package/dist/components/chat-panel/error-connection-inline/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ErrorConnectionInline } from './ErrorConnectionInline';
+export type { ErrorConnectionInlineProps, ErrorConnectionInlineTranslations, } from './errorConnectionInline.type';

package/dist/components/chat-panel/footer/Footer.d.ts

@@ -0,0 +1,4 @@
+import type { FC } from 'react';
+import type { FooterProps } from './footer.type';
+declare const Footer: FC<FooterProps>;
+export default Footer;

package/dist/components/chat-panel/footer/footer.type.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="react" />
+export type FooterState = 'idle' | 'processing' | 'disconnected';
+export interface FooterTranslations {
+    placeholderIdle: string;
+    placeholderProcessing: string;
+    placeholderDisconnected: string;
+    processingTooltip: string;
+    sendMessageAriaLabel: string;
+}
+export interface FooterProps {
+    input: string;
+    onInputChange: (value: string) => void;
+    onSubmit: (e: React.FormEvent<HTMLFormElement>) => void;
+    onKeyDown: (e: React.KeyboardEvent<HTMLTextAreaElement>) => void;
+    state: FooterState;
+    disclaimer: string;
+    translations: FooterTranslations;
+}

package/dist/components/chat-panel/footer/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Footer } from './Footer';
+export type { FooterProps, FooterState, FooterTranslations, } from './footer.type';

package/dist/components/chat-panel/{ChatPanelHeader.d.ts → header/Header.d.ts}

@@ -1,14 +1,13 @@
-import type { FC } from 'react';
-interface ChatPanelHeaderProps {
+import type { FC, ReactNode } from 'react';
+interface HeaderProps {
     title: string;
     isExpanded: boolean;
     onToggleExpand: () => void;
     onClose?: () => void;
-    onMenuClick?: () => void;
     onClearChat?: () => void;
     clearChatTooltipTitle?: string;
     clearChatTooltipDescription?: string;
-    isOverlay?: boolean;
+    headerActionsSlot?: ReactNode;
 }
-declare const ChatPanelHeader: FC<ChatPanelHeaderProps>;
-export default ChatPanelHeader;
+declare const Header: FC<HeaderProps>;
+export default Header;

package/dist/components/chat-panel/header/index.d.ts

@@ -0,0 +1 @@
+export { default as Header } from './Header';

package/dist/components/chat-panel/index.d.ts

@@ -1,3 +1,3 @@
-export { ChatPanel, type ChatPanelTranslations } from './ChatPanel';
+export { ChatPanel, type ChatPanelTranslations } from './chat-panel';
 export type { SuggestionType } from '../../types/chat';
 export type { AiAgentTheme, SyntaxAppearance, ResolveSyntaxAppearanceFn, } from '../../context/AiAgentThemeContext';

package/dist/components/chat-panel/locale/en.json.d.ts

@@ -1,16 +1,40 @@
 declare const _default: {
-  "title": "Foris Agent",
+  "title": "Foris AI",
   "welcomeTitle": "How can I help you?",
   "welcomeDescription": "Choose a suggestion or ask me a question.",
   "suggestionsTitle": "Suggestions",
   "placeholder": "Ask or create something...",
+  "placeholderProcessing": "Processing request...",
+  "placeholderDisconnected": "Not available",
+  "processingTooltip": "You have a request in progress",
+  "sendMessageAriaLabel": "Send message",
   "disclaimer": "Foris AI may make mistakes. Verify the responses.",
   "clearChatTitle": "Clear current conversation",
   "clearChatDescription": "All messages will be deleted and the current context will be lost. This action cannot be undone.",
   "clearChatConfirm": "Clear conversation",
   "clearChatCancel": "Cancel",
   "clearChatTooltipTitle": "Clear current conversation",
-  "clearChatTooltipDescription": "The current conversation context will be lost."
+  "clearChatTooltipDescription": "The current conversation context will be lost.",
+  "suggestionsTooltipTitle": "Suggestions",
+  "suggestionsTooltipDescription": "Select an option",
+  "footerResponseCopyTooltip": "Copy",
+  "footerResponseCopiedTooltip": "Copied",
+  "errorFullBodyTitle": "We couldn't connect",
+  "errorFullBodyDescription": "Please check your internet connection and try again.",
+  "errorFullBodyRetry": "Try again",
+  "errorFullBodyReconnecting": "Reconnecting...",
+  "errorResponseTitle": "We couldn't generate a response. Try again or ask another question.",
+  "errorResponseRetry": "Retry",
+  "errorConnectionInlineTitle": "We couldn't send your message. Check your connection and try again.",
+  "errorConnectionInlineRetry": "Retry",
+  "thinkingStep1": "Thinking...",
+  "thinkingStep2": "Understanding your request...",
+  "thinkingUsingTool": "Using: {tool}",
+  "thinkingPreparing": "Preparing response...",
+  "reasoningTraceSingular": "Reasoning · 1 tool used",
+  "reasoningTracePlural": "Reasoning · {count} tools used",
+  "reasoningTraceParameters": "Parameters",
+  "reasoningTraceResult": "Result"
 }
 ;
 

package/dist/components/chat-panel/locale/es.json.d.ts

@@ -1,16 +1,40 @@
 declare const _default: {
-  "title": "Foris Agent",
+  "title": "Foris AI",
   "welcomeTitle": "¿Cómo puedo ayudarte?",
   "welcomeDescription": "Puedes elegir una sugerencia o hacerme una pregunta.",
   "suggestionsTitle": "Sugerencias",
   "placeholder": "Pregunta o crea algo...",
+  "placeholderProcessing": "Procesando solicitud...",
+  "placeholderDisconnected": "No disponible",
+  "processingTooltip": "Tienes una solicitud en curso",
+  "sendMessageAriaLabel": "Enviar mensaje",
   "disclaimer": "Foris AI puede cometer errores. Verifica sus respuestas.",
   "clearChatTitle": "Limpiar conversación actual",
   "clearChatDescription": "Se borrarán todos los mensajes y se perderá el contexto actual. Esta acción no se puede deshacer.",
   "clearChatConfirm": "Limpiar conversación",
   "clearChatCancel": "Cancelar",
   "clearChatTooltipTitle": "Limpiar conversación actual",
-  "clearChatTooltipDescription": "Se perderá el contexto actual de la conversación."
+  "clearChatTooltipDescription": "Se perderá el contexto actual de la conversación.",
+  "suggestionsTooltipTitle": "Sugerencias",
+  "suggestionsTooltipDescription": "Selecciona una opción",
+  "footerResponseCopyTooltip": "Copiar",
+  "footerResponseCopiedTooltip": "Copiado",
+  "errorFullBodyTitle": "No pudimos conectarnos",
+  "errorFullBodyDescription": "Por favor, verifica tu conexión a internet e intenta nuevamente",
+  "errorFullBodyRetry": "Vuelve a intentarlo",
+  "errorFullBodyReconnecting": "Reconectando...",
+  "errorResponseTitle": "No fue posible generar una respuesta. Intenta de nuevo o haz otra pregunta.",
+  "errorResponseRetry": "Reintentar",
+  "errorConnectionInlineTitle": "No pudimos enviar tu mensaje. Verifica tu conexión e intenta de nuevo.",
+  "errorConnectionInlineRetry": "Reintentar",
+  "thinkingStep1": "Pensando...",
+  "thinkingStep2": "Entendiendo tu solicitud...",
+  "thinkingUsingTool": "Usando: {tool}",
+  "thinkingPreparing": "Preparando respuesta...",
+  "reasoningTraceSingular": "Razonamiento · 1 herramienta utilizada",
+  "reasoningTracePlural": "Razonamiento · {count} herramientas utilizadas",
+  "reasoningTraceParameters": "Parámetros",
+  "reasoningTraceResult": "Resultado"
 }
 ;
 

package/dist/components/chat-panel/message-item/AssistantResponseFooter.d.ts

@@ -0,0 +1,13 @@
+import type { FC, ReactNode } from 'react';
+/** Figma time row: lowercase meridiem (e.g. `pm` not `PM`). */
+export declare function formatAssistantGenerationTime(locale: 'en' | 'es', ms: number): string;
+export interface AssistantResponseFooterProps {
+    children: ReactNode;
+    textToCopy: string;
+    generatedAt?: number;
+    locale: 'en' | 'es';
+    copyTooltip: string;
+    copiedTooltip: string;
+    regionLabel?: string;
+}
+export declare const AssistantResponseFooter: FC<AssistantResponseFooterProps>;

package/dist/components/chat-panel/message-item/MessageItem.d.ts

@@ -0,0 +1,19 @@
+import type { FC } from 'react';
+import type { MessageType } from '../chat-panel/chatPanel.types';
+interface MessageItemProps {
+    message: MessageType;
+    locale?: 'en' | 'es';
+    footerResponseCopyTooltip?: string;
+    footerResponseCopiedTooltip?: string;
+    onRetryMessage?: (key?: string) => Promise<void> | void;
+    errorConnectionInlineTitle?: string;
+    errorConnectionInlineRetry?: string;
+    errorResponseTitle?: string;
+    errorResponseRetry?: string;
+    reasoningTraceSingular?: string;
+    reasoningTracePlural?: string;
+    reasoningTraceParameters?: string;
+    reasoningTraceResult?: string;
+}
+declare const MessageItem: FC<MessageItemProps>;
+export default MessageItem;

package/dist/components/chat-panel/message-item/index.d.ts

@@ -0,0 +1 @@
+export { default as MessageItem } from './MessageItem';

package/dist/components/chat-panel/reasoning-trace/ReasoningTrace.d.ts

@@ -0,0 +1,4 @@
+import { type FC } from 'react';
+import type { ReasoningTraceProps } from './reasoningTrace.type';
+declare const ReasoningTrace: FC<ReasoningTraceProps>;
+export { ReasoningTrace };

package/dist/components/chat-panel/reasoning-trace/index.d.ts

@@ -0,0 +1,2 @@
+export { ReasoningTrace } from './ReasoningTrace';
+export type { ReasoningTraceProps, ReasoningTraceTranslations } from './reasoningTrace.type';

package/dist/components/chat-panel/reasoning-trace/reasoningTrace.type.d.ts

@@ -0,0 +1,12 @@
+import type { ToolCall } from '../../../types/chat';
+export interface ReasoningTraceTranslations {
+    headerSingular?: string;
+    headerPlural?: string;
+    parameters?: string;
+    result?: string;
+}
+export interface ReasoningTraceProps {
+    tools: ToolCall[];
+    translations?: ReasoningTraceTranslations;
+    className?: string;
+}

package/dist/components/chat-panel/suggestions/Suggestions.d.ts

@@ -0,0 +1,7 @@
+import type { SuggestionType } from '../../../types/chat';
+interface SuggestionsProps {
+    suggestion: SuggestionType;
+    onClick: () => void;
+}
+export declare const Suggestions: ({ suggestion, onClick, }: SuggestionsProps) => import("react/jsx-runtime").JSX.Element;
+export default Suggestions;

package/dist/components/chat-panel/suggestions/index.d.ts

@@ -0,0 +1 @@
+export { default as Suggestions } from './Suggestions';

package/dist/components/chat-panel/thinking-indicator/ThinkingIndicator.d.ts

@@ -0,0 +1,8 @@
+import { type FC } from 'react';
+import type { ThinkingPhase } from '../../../hooks/useThinkingPhase';
+interface ThinkingIndicatorProps {
+    phase: ThinkingPhase;
+    label: string;
+}
+declare const ThinkingIndicator: FC<ThinkingIndicatorProps>;
+export { ThinkingIndicator };

package/dist/components/chat-panel/thinking-indicator/index.d.ts

@@ -0,0 +1 @@
+export { ThinkingIndicator } from './ThinkingIndicator';

package/dist/components/chat-panel/typing/Typing.d.ts

@@ -0,0 +1,3 @@
+import type { FC } from 'react';
+declare const Typing: FC;
+export default Typing;

package/dist/components/chat-panel/typing/index.d.ts

@@ -0,0 +1 @@
+export { default as Typing } from './Typing';

package/dist/components/chat-panel/welcome/Welcome.d.ts

@@ -0,0 +1,10 @@
+import type { FC } from 'react';
+import type { SuggestionType } from '../../../types/chat';
+interface WelcomeProps {
+    welcomeTitle: string;
+    welcomeDescription: string;
+    suggestions: SuggestionType[];
+    onSuggestionClick: (suggestion: SuggestionType) => void;
+}
+declare const Welcome: FC<WelcomeProps>;
+export default Welcome;

package/dist/components/chat-panel/welcome/index.d.ts

@@ -0,0 +1 @@
+export { default as Welcome } from './Welcome';

package/dist/components/ui/card/Card.d.ts

@@ -0,0 +1,4 @@
+import type { FC } from 'react';
+import type { CardProps } from './card.types';
+declare const Card: FC<CardProps>;
+export default Card;

package/dist/components/ui/card/card.types.d.ts

@@ -0,0 +1,9 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export type CardVariant = 'warning';
+export type CardTypo = 'border' | 'opacity';
+export interface CardProps extends HTMLAttributes<HTMLDivElement> {
+    variant?: CardVariant;
+    typo?: CardTypo;
+    children: ReactNode;
+    className?: string;
+}

package/dist/components/ui/card/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Card } from './Card';
+export type { CardProps, CardVariant, CardTypo } from './card.types';

package/dist/components/ui/icon-menu/IconMenu.d.ts

@@ -0,0 +1,20 @@
+import type { FC } from 'react';
+import type { IconTypes } from '@foris/avocado-icons';
+export interface IconMenuItem {
+    key: string;
+    icon?: IconTypes;
+    title: string;
+    description?: string;
+    onClick: () => void;
+}
+export interface IconMenuProps {
+    items: IconMenuItem[];
+    triggerIcon: IconTypes;
+    triggerAriaLabel: string;
+    header?: string;
+    listOrigin?: 'left' | 'right';
+    triggerTooltipTitle?: string;
+    triggerTooltipDescription?: string;
+}
+declare const IconMenu: FC<IconMenuProps>;
+export default IconMenu;

package/dist/components/ui/icon-menu/index.d.ts

@@ -0,0 +1,2 @@
+export { default as IconMenu } from './IconMenu';
+export type { IconMenuProps, IconMenuItem } from './IconMenu';

package/dist/components/ui/thinking-text/ThinkingText.d.ts

@@ -0,0 +1,7 @@
+import type { FC } from 'react';
+interface ThinkingTextProps {
+    text: string;
+    className?: string;
+}
+declare const ThinkingText: FC<ThinkingTextProps>;
+export { ThinkingText };

package/dist/components/ui/thinking-text/index.d.ts

@@ -0,0 +1 @@
+export { ThinkingText } from './ThinkingText';

package/dist/components/ui/tooltip.d.ts

@@ -1,7 +1,12 @@
-import * as React from "react";
-import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+import * as React from 'react';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 declare function TooltipProvider({ delayDuration, ...props }: React.ComponentProps<typeof TooltipPrimitive.Provider>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Requires a `<TooltipProvider>` ancestor. Unlike the previous version, this
+ * component no longer provides its own provider — wrap a shared
+ * `<TooltipProvider>` around the subtree that contains tooltips.
+ */
 declare function Tooltip({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
 declare function TooltipTrigger({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
-declare function TooltipContent({ className, sideOffset, children, ...props }: React.ComponentProps<typeof TooltipPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+declare function TooltipContent({ sideOffset, arrowPadding, collisionPadding, children, ...props }: React.ComponentProps<typeof TooltipPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/hooks/chat.constants.d.ts

@@ -0,0 +1,2 @@
+/** Default chat stream identifier shared by useChat and useConnectivityPing. */
+export declare const DEFAULT_CHAT_STREAM_ID = "demo-123";

package/dist/hooks/useChat.d.ts

@@ -1,14 +1,18 @@
-import type { MutableRefObject } from 'react';
 import { ApiManager } from '@foris/mango-core';
 import type { ChatMessage } from '../types/chat';
+import { DEFAULT_CHAT_STREAM_ID } from './chat.constants';
 export interface OnSubmitProps {
-    params?: any;
+    params?: Record<string, unknown>;
     input: string;
-    abortRef: MutableRefObject<AbortController | null>;
 }
+export { DEFAULT_CHAT_STREAM_ID };
 /** When apiManager is passed, streaming uses mango (fetch or axios depending on delegate). */
 export declare const useChat: (api: string, headers?: Record<string, string>, apiManager?: ApiManager) => {
-    onSubmit: ({ params, input, abortRef }: OnSubmitProps) => Promise<void>;
+    onSubmit: ({ params, input }: OnSubmitProps) => Promise<void>;
     messages: ChatMessage[];
+    isLoading: boolean;
+    retryLastMessage: (key?: string) => Promise<void>;
     clearMessages: () => void;
+    initialLoadError: boolean;
+    retryInitialPing: () => Promise<void>;
 };

package/dist/hooks/useChatSubmit.d.ts

@@ -6,14 +6,14 @@ import { type OnSubmitProps } from './useChat';
 interface UseChatSubmitOptions {
     dataSource: DataSource;
     messages: ChatMessage[];
+    isLoading: boolean;
     onSubmit: (props: OnSubmitProps) => Promise<void>;
     resetUserScrolling: () => void;
     scrollToBottom: (immediate?: boolean) => void;
 }
-export declare const useChatSubmit: ({ dataSource, messages, onSubmit, resetUserScrolling, scrollToBottom, }: UseChatSubmitOptions) => {
+export declare const useChatSubmit: ({ dataSource, messages, isLoading, onSubmit, resetUserScrolling, scrollToBottom, }: UseChatSubmitOptions) => {
     input: string;
     setInput: import("react").Dispatch<import("react").SetStateAction<string>>;
-    isLoadingMessage: boolean;
     isChatStarted: boolean;
     handleSubmit: (message: PromptInputMessage) => Promise<void>;
     handleFooterSubmit: (e: React.FormEvent<HTMLFormElement>) => void;

package/dist/hooks/useClickOutside.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface UseClickOutsideProps {
+    ref?: React.RefObject<HTMLElement | null>;
+    shouldIgnore?: boolean;
+    onClickOutside?: () => void;
+}
+export declare const useClickOutside: ({ ref, shouldIgnore, onClickOutside, }: UseClickOutsideProps) => void;
+export {};

package/dist/hooks/useConnectivityPing.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Non-empty `message` for the connectivity POST (chat APIs reject empty messages).
+ * Backend may treat this sentinel as a no-op until a dedicated ping exists.
+ */
+export declare const CONNECTIVITY_PROBE_MESSAGE = "[connectivity-probe]";
+/**
+ * Same JSON shape as `useChat` / `postStream` (`chat_id` + `message`). When the
+ * backend exposes a dedicated ping contract, switch the body / URL here.
+ */
+export declare const CONNECTIVITY_PROBE_BODY: string;
+/**
+ * Stable string for cache keys so the same logical headers map to the same entry.
+ * Exported for tests that reset or assert cache behaviour.
+ */
+export declare function pingHeadersFingerprint(headers?: Record<string, string>): string;
+/** Drop cached probe(s) for `url` (all header variants), or clear the entire cache. */
+export declare const resetConnectivityPingCache: (url?: string) => void;
+export interface UseConnectivityPingResult {
+    initialLoadError: boolean;
+    retryInitialPing: () => Promise<void>;
+}
+/**
+ * Fires a one-shot `POST` connectivity probe per page session for `(pingUrl, headers)`.
+ * Body matches the streaming chat payload (`chat_id` + `message`) because many backends
+ * reject `HEAD` (405). Replace with a dedicated ping payload when the API supports it.
+ */
+export declare const useConnectivityPing: (pingUrl?: string, headers?: Record<string, string>) => UseConnectivityPingResult;