@foris/ai-agent 1.0.6 → 1.0.7

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

@@ -2,22 +2,7 @@ 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;
-    suggestionsTooltipTitle?: string;
-    suggestionsTooltipDescription?: string;
-}
+import type { ChatPanelTranslations } from './chatPanel.types';
 interface ChatPanelProps extends React.HTMLAttributes<HTMLDivElement> {
     dataSource: DataSource;
     className?: string;

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

@@ -1,7 +1,47 @@
 import type { ToolCall } from '../../../types/chat';
-export type MessageType = {
+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' | 'assistant';
+    from: 'user';
+    generatedAt?: number;
     sources?: {
         href: string;
         title: string;
@@ -14,5 +54,31 @@ export type MessageType = {
         content: string;
         duration: number;
     };
-    tool?: ToolCall;
-};
+    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

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

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

@@ -1,11 +1,4 @@
 import type { FC } from 'react';
-interface FooterProps {
-    input: string;
-    onInputChange: (value: string) => void;
-    onSubmit: (e: React.FormEvent<HTMLFormElement>) => void;
-    onKeyDown: (e: React.KeyboardEvent<HTMLTextAreaElement>) => void;
-    placeholder: string;
-    disclaimer: string;
-}
+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

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

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

@@ -4,6 +4,10 @@ declare const _default: {
   "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.",
@@ -12,7 +16,25 @@ declare const _default: {
   "clearChatTooltipTitle": "Clear current conversation",
   "clearChatTooltipDescription": "The current conversation context will be lost.",
   "suggestionsTooltipTitle": "Suggestions",
-  "suggestionsTooltipDescription": "Select an option"
+  "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

@@ -4,6 +4,10 @@ declare const _default: {
   "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.",
@@ -12,7 +16,25 @@ declare const _default: {
   "clearChatTooltipTitle": "Limpiar conversación actual",
   "clearChatTooltipDescription": "Se perderá el contexto actual de la conversación.",
   "suggestionsTooltipTitle": "Sugerencias",
-  "suggestionsTooltipDescription": "Selecciona una opción"
+  "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

@@ -2,6 +2,18 @@ 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/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/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/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/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/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;

package/dist/hooks/useSplitChunks.d.ts

@@ -1,3 +1,12 @@
-export declare const useSplitChunks: (setMessages: any) => {
-    splitChunks: (res: any) => Promise<void>;
+import type React from 'react';
+import type { StreamResponse } from '@foris/mango-core';
+import type { ChatMessage } from '../types/chat';
+export type SplitChunksResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: Error;
+};
+export declare const useSplitChunks: (setMessages: React.Dispatch<React.SetStateAction<ChatMessage[]>>) => {
+    splitChunks: (res: StreamResponse) => Promise<SplitChunksResult>;
 };

package/dist/hooks/useSplitChunks.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/useThinkingPhase.d.ts

@@ -0,0 +1,19 @@
+import type { ToolCall } from '../types/chat';
+export type ThinkingPhase = 'idle' | 'thinking' | 'tool' | 'preparing' | 'done';
+interface UseThinkingPhaseOptions {
+    isLoading: boolean;
+    streamingTools: ToolCall[];
+    streamingContent: string;
+    labels: {
+        step1: string;
+        step2: string;
+        usingTool: string;
+        preparing: string;
+    };
+}
+interface UseThinkingPhaseResult {
+    phase: ThinkingPhase;
+    label: string;
+}
+export declare const useThinkingPhase: ({ isLoading, streamingTools, streamingContent, labels, }: UseThinkingPhaseOptions) => UseThinkingPhaseResult;
+export {};

package/dist/hooks/useThinkingPhase.test.d.ts

@@ -0,0 +1 @@
+export {};