research-agent-ui 0.1.0

package/dist/components/MessageComposer/MessageInputIconSet.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Central `Icons` export map of Lucide icons and custom SVGs (Thinking clock, SelectArrow)
+ * used across MessageComposer and related components.
+ */
+import React from "react";
+export declare const Icons: {
+    Plus: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Paperclip: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Cloud: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Upload: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    File: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    SquarePen: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Thinking: (props: React.SVGProps<SVGSVGElement>) => React.JSX.Element;
+    SelectArrow: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    ArrowUp: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    X: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    FileText: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Loader2: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Check: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Archive: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Mic: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Stop: React.ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+    Clock: (props: React.SVGProps<SVGSVGElement>) => React.JSX.Element;
+};

package/dist/components/MessageComposer/PastedContentCard.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Small card shown in the attachment tray when a large block of text (>300 chars) is pasted into the input;
+ * displays a truncated preview with a "PASTED" label and a hover-revealed remove button.
+ */
+import React from "react";
+import { PastedContent } from "../../types/research";
+interface PastedContentCardProps {
+    content: PastedContent;
+    onRemove: (id: string) => void;
+}
+export declare const PastedContentCard: React.FC<PastedContentCardProps>;
+export {};

package/dist/components/SearchConfig/CategoriesMenu.d.ts

@@ -0,0 +1,2 @@
+declare const Category: () => import("react").JSX.Element;
+export default Category;

package/dist/components/SearchConfig/ChatModelSelector.d.ts

@@ -0,0 +1,2 @@
+declare const ModelSelector: () => import("react").JSX.Element;
+export default ModelSelector;

package/dist/components/SearchConfig/ModelSelector.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import { ChatModelProvider } from "../../types/chat";
+interface ModelSelectorProps {
+    chatModelProvider?: ChatModelProvider;
+    onSelect?: (provider: ChatModelProvider) => void;
+}
+export declare const ModelSelector: React.FC<ModelSelectorProps>;
+export {};

package/dist/components/SearchConfig/ModelSelectorSubmenu.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const ModelSelectorSubmenu: React.FC;

package/dist/components/SearchConfig/ResearchFocusToggleButton.d.ts

@@ -0,0 +1,2 @@
+declare const Focus: () => import("react").JSX.Element;
+export default Focus;

package/dist/components/SearchConfig/SearchOptimizationSelector.d.ts

@@ -0,0 +1,2 @@
+declare const Optimization: () => import("react").JSX.Element;
+export default Optimization;

package/dist/components/SearchConfig/categories.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Static array of search category metadata (code, SVG icon, display name) shared across CategoriesMenu,
+ * FileUploadDropdown, and SearchSpotlight components.
+ */
+import IconSearchWeb from '../../icons/IconSearchWeb';
+export declare const categories: {
+    code: string;
+    icon: typeof IconSearchWeb;
+    name: string;
+}[];

package/dist/components/SearchResults/MessageSources.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Source card grid with category tabs (Web/News/Videos/Images/Academic/Files) that renders search results as
+ * image tiles, video thumbnails, or web-result cards; supports infinite scroll pagination and opens URLs in
+ * the article extract panel. Auto-opens the first source on desktop.
+ */
+import type { Document } from 'extract-webpage/search';
+declare const MessageSources: ({ sources: initialSources, query, }: {
+    sources: Document[];
+    query?: string;
+}) => import("react").JSX.Element;
+export default MessageSources;

package/dist/components/SearchResults/NewsArticleWidget.d.ts

@@ -0,0 +1,2 @@
+declare const NewsArticleWidget: () => import("react").JSX.Element;
+export default NewsArticleWidget;

package/dist/components/SearchResults/SearchProgressIndicator.d.ts

@@ -0,0 +1,8 @@
+import { SearchQuery } from '../ChatConversation/ChatWindow';
+interface SearchProgressIndicatorProps {
+    queries: SearchQuery[];
+    /** True while the parent section is still streaming */
+    loading: boolean;
+}
+export default function SearchProgressIndicator({ queries, loading }: SearchProgressIndicatorProps): import("react").JSX.Element;
+export {};

package/dist/components/SearchResults/WebCitationBadge.d.ts

@@ -0,0 +1,7 @@
+import type { Document } from 'extract-webpage/search';
+declare const Citation: ({ href, children, sources, }: {
+    href: string;
+    children: React.ReactNode;
+    sources?: Document[];
+}) => import("react").JSX.Element;
+export default Citation;

package/dist/config.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={appName:`QwkSearch`,defaultSummarizePrompt:`Summarize in bullet points and bold topics`,maxArticleLength:1500,downloadChromeUrl:`https://chromewebstore.google.com/detail/tab-manager-ai/manhemnhmipdhdpabojcplebckhckeko`,downloadWindowsStoreId:`9PCGF9GNK460`,footerLinks:[],googleApiKey:``,getAutoMediaSearch:()=>!0};function t(t){Object.assign(e,t)}exports.configureResearchAgentUI=t,exports.researchAgentUIConfig=e;

package/dist/config.d.ts

@@ -0,0 +1,54 @@
+export interface FooterLink {
+    url: string;
+    text: string;
+    icon?: string;
+}
+/**
+ * Auth client shape expected by `SessionProvider`. Matches the subset of the
+ * better-auth React client actually used by this package, so the consuming
+ * app can pass its own configured instance without this package depending on
+ * `better-auth` directly.
+ */
+export interface ResearchAgentAuthClient {
+    getSession: (...args: any[]) => Promise<any>;
+    oneTap: (opts: {
+        fetchOptions: {
+            onSuccess: () => void;
+        };
+    }) => void;
+    signIn: {
+        social: (opts: {
+            provider: string;
+            callbackURL: string;
+        }) => void;
+    };
+    signOut: (opts: {
+        fetchOptions: {
+            onSuccess: () => void;
+        };
+    }) => Promise<any>;
+}
+export interface ResearchAgentUIConfig {
+    /** Product name shown in document titles, etc. */
+    appName: string;
+    /** Default prompt used to summarize an extracted article. */
+    defaultSummarizePrompt: string;
+    /** Max character length for article body sent to the LLM. */
+    maxArticleLength: number;
+    /** Chrome Web Store URL advertised on the homepage. */
+    downloadChromeUrl: string;
+    /** Microsoft Store product ID advertised on the homepage. */
+    downloadWindowsStoreId: string;
+    /** Links rendered in the homepage footer. */
+    footerLinks: FooterLink[];
+    /** Google API key used by the Google Drive file picker. */
+    googleApiKey: string;
+    /** Whether to auto-trigger image/video media search after a response completes. */
+    getAutoMediaSearch: () => boolean;
+}
+export declare const researchAgentUIConfig: ResearchAgentUIConfig;
+/**
+ * Overrides default configuration. Call once, before rendering, from the
+ * consuming app (e.g. in the root layout) to wire up app-specific values.
+ */
+export declare function configureResearchAgentUI(overrides: Partial<ResearchAgentUIConfig>): void;

package/dist/config.mjs

@@ -0,0 +1,16 @@
+//#region src/config.ts
+var e = {
+	appName: "QwkSearch",
+	defaultSummarizePrompt: "Summarize in bullet points and bold topics",
+	maxArticleLength: 1500,
+	downloadChromeUrl: "https://chromewebstore.google.com/detail/tab-manager-ai/manhemnhmipdhdpabojcplebckhckeko",
+	downloadWindowsStoreId: "9PCGF9GNK460",
+	footerLinks: [],
+	googleApiKey: "",
+	getAutoMediaSearch: () => !0
+};
+function t(t) {
+	Object.assign(e, t);
+}
+//#endregion
+export { t as configureResearchAgentUI, e as researchAgentUIConfig };

package/dist/hooks/useChat/ChatContext.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @fileoverview React Context for the chat system.
+ * Provides the ChatContext and useChat hook for accessing chat state
+ * and actions throughout the application.
+ * @module components/ResearchAgent/state/chat/ChatContext
+ */
+import { ChatTurn, Message } from '../../components/ChatConversation/ChatWindow';
+import { ChatFile, ChatModelProvider, Section } from '../../types/chat';
+/**
+ * The value provided by the ChatContext.
+ * Contains all state and actions available to chat consumers.
+ */
+export interface ChatContextValue {
+    /** All messages in the current chat (user, assistant, source, suggestion) */
+    messages: Message[];
+    /** Filtered list of only user and assistant messages */
+    chatTurns: ChatTurn[];
+    /** Processed sections for UI rendering with citations and formatting */
+    sections: Section[];
+    /** Conversation history as [role, content] pairs for AI context */
+    chatHistory: [string, string][];
+    /** Files attached to the chat */
+    files: ChatFile[];
+    /** IDs of attached files for API requests */
+    fileIds: string[];
+    /** Current search/focus mode (e.g., 'webSearch', 'academic') */
+    focusMode: string;
+    /** Current category for filtering search results */
+    category: string;
+    /** Unique identifier for the current chat session */
+    chatId: string | undefined;
+    /** Response optimization mode (e.g., 'speed', 'quality') */
+    optimizationMode: string;
+    /** Whether messages have been loaded from storage/API */
+    isMessagesLoaded: boolean;
+    /** Whether a message is currently being sent/processed */
+    loading: boolean;
+    /** Whether the requested chat was not found */
+    notFound: boolean;
+    /** Whether the AI response has started appearing */
+    messageAppeared: boolean;
+    /** Whether the chat system is fully initialized and ready */
+    isReady: boolean;
+    /** Whether an error occurred during initialization */
+    hasError: boolean;
+    /** Current AI model provider configuration */
+    chatModelProvider: ChatModelProvider;
+    /**
+     * Sets the response optimization mode.
+     * @param mode - The optimization mode ('speed' or 'quality')
+     */
+    setOptimizationMode: (mode: string) => void;
+    /**
+     * Sets the search/focus mode.
+     * @param mode - The focus mode (e.g., 'webSearch', 'academic')
+     */
+    setFocusMode: (mode: string) => void;
+    /**
+     * Sets the search category.
+     * @param category - The category for filtering results
+     */
+    setCategory: (category: string) => void;
+    /**
+     * Sets the files attached to the chat.
+     * @param files - Array of ChatFile objects
+     */
+    setFiles: (files: ChatFile[]) => void;
+    /**
+     * Sets the file IDs for attached files.
+     * @param fileIds - Array of file ID strings
+     */
+    setFileIds: (fileIds: string[]) => void;
+    /**
+     * Sends a message to the chat.
+     * @param message - The message content to send
+     * @param messageId - Optional custom message ID
+     * @param rewrite - Whether this is a rewrite of a previous message
+     */
+    sendMessage: (message: string, messageId?: string, rewrite?: boolean) => Promise<void>;
+    /**
+     * Rewrites a previous AI response.
+     * Removes messages after the specified one and regenerates the response.
+     * @param messageId - The ID of the assistant message to rewrite
+     */
+    rewrite: (messageId: string) => void;
+    /**
+     * Updates the AI model provider configuration.
+     * @param provider - The new provider configuration
+     */
+    setChatModelProvider: (provider: ChatModelProvider) => void;
+    /**
+     * Stops the currently streaming response.
+     * Aborts the fetch request and finalizes with whatever content was received.
+     */
+    stopStreaming: () => void;
+    /**
+     * Clears the current chat and starts a new session.
+     * Resets all messages, history, and generates a new chat ID.
+     */
+    newChat: () => void;
+    /**
+     * Whether incognito mode is active.
+     * When true, messages are not saved to history or cloud.
+     */
+    incognito: boolean;
+    /**
+     * Toggles incognito mode on or off.
+     */
+    setIncognito: (value: boolean) => void;
+}
+/**
+ * React Context for the chat system.
+ *
+ * Provides access to chat state and actions throughout the component tree.
+ * Should be used with the ChatProvider component at the app root.
+ *
+ * @example
+ * ```tsx
+ * // In a component
+ * const { messages, sendMessage, loading } = useChat();
+ * ```
+ */
+export declare const chatContext: import("react").Context<ChatContextValue>;
+/**
+ * Hook for accessing the chat context.
+ *
+ * Provides access to all chat state and actions.
+ * Must be used within a ChatProvider component.
+ *
+ * @returns The current ChatContextValue
+ *
+ * @example
+ * ```tsx
+ * function ChatInput() {
+ *   const { sendMessage, loading } = useChat();
+ *
+ *   const handleSubmit = (message: string) => {
+ *     if (!loading) {
+ *       sendMessage(message);
+ *     }
+ *   };
+ *
+ *   return <input disabled={loading} onSubmit={handleSubmit} />;
+ * }
+ * ```
+ */
+export declare function useChat(): ChatContextValue;

package/dist/hooks/useChat/ChatProvider.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview React Provider component for the chat system.
+ * Orchestrates all chat functionality including state management,
+ * message loading, sending, and persistence.
+ * @module components/ResearchAgent/state/chat/ChatProvider
+ */
+/**
+ * Provider component that manages the chat system state and side effects.
+ *
+ * This component:
+ * - Initializes chat configuration (model provider selection)
+ * - Loads existing messages for a chat ID from URL params
+ * - Creates new chat sessions when needed
+ * - Persists guest chats to localStorage
+ * - Handles initial messages from URL query params
+ * - Provides the chat context to child components
+ *
+ * @param props - Component props
+ * @param props.children - Child components that will have access to chat context
+ *
+ * @example
+ * ```tsx
+ * // In app layout
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <ChatProvider>
+ *       {children}
+ *     </ChatProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function ChatProvider({ children }: {
+    children: React.ReactNode;
+}): import("react").JSX.Element;

package/dist/hooks/useChat/buildSections.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Message parsing and section building for the chat UI.
+ * Transforms raw message arrays into structured sections that group
+ * user messages with their corresponding AI responses, sources, and suggestions.
+ * @module components/ResearchAgent/state/chat/buildSections
+ */
+import { Message } from "../../components/ChatConversation/ChatWindow";
+import { Section } from "../../types/chat";
+/**
+ * Transforms a flat array of messages into structured UI sections.
+ *
+ * Each section groups together:
+ * - A user message
+ * - The corresponding AI assistant response
+ * - Source citations used for the response
+ * - Follow-up suggestions
+ *
+ * The function also performs message processing:
+ * - Converts citation markers `[1]`, `[2,3]` into clickable `<citation>` elements
+ * - Handles thinking/reasoning tags (`<think>...</think>`)
+ * - Creates a speech-friendly version with citations removed
+ *
+ * @param messages - Array of all chat messages (user, assistant, source, suggestion)
+ * @returns Array of Section objects for rendering in the UI
+ *
+ * @example
+ * ```typescript
+ * const sections = buildSections(messages);
+ *
+ * //     userMessage: { role: 'user', content: 'What is React?' },
+ * //     assistantMessage: { role: 'assistant', content: 'React is...' },
+ * //     parsedAssistantMessage: 'React is... <citation href="...">1</citation>',
+ * //     speechMessage: 'React is...',
+ * //     sourceMessage: { sources: [...] },
+ * //     thinkingEnded: true,
+ * //     suggestions: ['How does React compare to Vue?', ...]
+ * ```
+ */
+export declare const buildSections: (messages: Message[]) => Section[];

package/dist/hooks/useChat/chatConfig.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Chat configuration and model provider initialization.
+ * Handles loading and selecting the appropriate AI model provider and model
+ * based on user preferences stored in localStorage or system defaults.
+ * @module components/ResearchAgent/state/chat/chatConfig
+ */
+import { ChatModelProvider } from "../../types/chat";
+/**
+ * Initializes and validates the chat model configuration.
+ *
+ * This function performs the following steps:
+ * 1. Fetches available providers from the API
+ * 2. Loads user preferences from localStorage (if any)
+ * 3. Selects an appropriate provider (preferring OpenRouter)
+ * 4. Selects an appropriate model (preferring Nemotron 3 Super 120B)
+ * 5. Saves the selection to localStorage for future sessions
+ *
+ * @param setChatModelProvider - Callback to set the selected provider configuration
+ * @param setIsConfigReady - Callback to signal configuration completion
+ * @param setHasError - Callback to signal configuration errors
+ *
+ * @example
+ * ```typescript
+ * useEffect(() => {
+ *   checkConfig(setChatModelProvider, setIsConfigReady, setHasError);
+ * }, []);
+ * ```
+ *
+ * @throws Will call setHasError(true) if no providers or models are available
+ */
+export declare const checkConfig: (setChatModelProvider: (provider: ChatModelProvider) => void, setIsConfigReady: (ready: boolean) => void, setHasError: (hasError: boolean) => void) => Promise<void>;

package/dist/hooks/useChat/chatMessages.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Chat message loading functionality.
+ * Handles loading chat messages from localStorage (for guest chats),
+ * the API (for authenticated users), or the API for public shared chats (for unauthenticated users).
+ * @module components/ResearchAgent/state/chat/chatMessages
+ */
+import { Message } from "../../components/ChatConversation/ChatWindow";
+import { ChatFile } from "../../types/chat";
+/**
+ * Loads chat messages and metadata for an existing chat session.
+ *
+ * This function handles three scenarios:
+ * - **Guest users**: Loads messages from localStorage via `getGuestChat()`, then tries API for public shared chats if not found
+ * - **Public shared chats**: Unauthenticated users can view public chats via the API without sign-in
+ * - **Authenticated users**: Fetches messages from the `/api/chats/:id` endpoint
+ *
+ * After loading, it:
+ * - Sets the document title to the first message
+ * - Builds the chat history for context
+ * - Loads attached files and their IDs
+ * - Sets the focus mode from the saved chat
+ *
+ * @param chatId - The unique identifier of the chat to load
+ * @param isAuthenticated - Whether the current user is authenticated
+ * @param setMessages - Callback to set the loaded messages
+ * @param setIsMessagesLoaded - Callback to signal loading completion
+ * @param setChatHistory - Callback to set the conversation history
+ * @param setFocusMode - Callback to set the chat's focus mode
+ * @param setNotFound - Callback to signal if the chat doesn't exist
+ * @param setFiles - Callback to set the attached files
+ * @param setFileIds - Callback to set the file IDs
+ *
+ * @example
+ * ```typescript
+ * await loadMessages(
+ *   chatId,
+ *   isAuthenticated,
+ *   setMessages,
+ *   setIsMessagesLoaded,
+ *   setChatHistory,
+ *   setFocusMode,
+ *   setNotFound,
+ *   setFiles,
+ *   setFileIds,
+ * );
+ * ```
+ */
+export declare const loadMessages: (chatId: string, isAuthenticated: boolean, setMessages: (messages: Message[]) => void, setIsMessagesLoaded: (loaded: boolean) => void, setChatHistory: (history: [string, string][]) => void, setFocusMode: (mode: string) => void, setNotFound: (notFound: boolean) => void, setFiles: (files: ChatFile[]) => void, setFileIds: (fileIds: string[]) => void) => Promise<void>;

package/dist/hooks/useChat/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Chat system module exports.
+ *
+ * This module provides a complete chat system implementation with:
+ * - **State management**: Centralized state via `useChatState` hook
+ * - **Context provider**: `ChatProvider` for React context
+ * - **Message handling**: Send, receive, and stream chat messages
+ * - **Persistence**: Guest chat storage in localStorage
+ * - **Configuration**: AI model provider selection and setup
+ *
+ * ## Architecture
+ *
+ * ```
+ * ChatProvider (orchestration)
+ *   └── useChatState (state management)
+ *         ├── checkConfig (model configuration)
+ *         ├── loadMessages (message loading)
+ *         ├── sendMessage (message sending)
+ *         └── buildSections (UI processing)
+ * ```
+ *
+ * ## Quick Start
+ *
+ * ```tsx
+ * // 1. Wrap your app with ChatProvider
+ * import { ChatProvider } from 'research-agent-ui';
+ *
+ * function App({ children }) {
+ *   return <ChatProvider>{children}</ChatProvider>;
+ * }
+ *
+ * // 2. Use the chat hook in components
+ * import { useChat } from 'research-agent-ui';
+ *
+ * function ChatComponent() {
+ *   const { messages, sendMessage, loading } = useChat();
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => <Message key={msg.messageId} {...msg} />)}
+ *       <Input onSubmit={sendMessage} disabled={loading} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @module components/ResearchAgent/state/chat
+ */
+export * from "../../types/chat";
+export { checkConfig } from "./chatConfig";
+export { loadMessages } from "./chatMessages";
+export { buildSections } from "./buildSections";
+export { sendMessage } from "./sendMessage";
+export { useChatState } from "./useChatState";
+export type { ChatState, ChatStateSetters, UseChatStateReturn, } from "./useChatState";
+export { chatContext, useChat } from "./ChatContext";
+export type { ChatContextValue } from "./ChatContext";
+export { ChatProvider } from "./ChatProvider";

package/dist/hooks/useChat/sendMessage.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Message sending and streaming response handling.
+ * Handles the complete flow of sending a chat message, receiving streamed
+ * responses, and updating the UI state accordingly.
+ * @module components/ResearchAgent/state/chat/sendMessage
+ */
+import { Message } from "../../components/ChatConversation/ChatWindow";
+import { ChatModelProvider } from "../../types/chat";
+/**
+ * Parameters for sending a chat message.
+ */
+export interface SendMessageParams {
+    /** The message content to send */
+    message: string;
+    /** Optional custom message ID (used when rewriting) */
+    messageId?: string;
+    /** Whether this is a rewrite of a previous response */
+    rewrite?: boolean;
+}
+/**
+ * Dependencies required by the sendMessage function.
+ * These are passed from the ChatProvider to allow the function
+ * to access and modify chat state.
+ */
+export interface SendMessageDeps {
+    /** Current chat session ID */
+    chatId: string;
+    /** Whether a message is currently being sent */
+    loading: boolean;
+    /** Current messages in the chat */
+    messages: Message[];
+    /** IDs of files attached to the chat */
+    fileIds: string[];
+    /** Current search/focus mode */
+    focusMode: string;
+    /** Current category for search filtering */
+    category: string;
+    /** Response optimization mode */
+    optimizationMode: string;
+    /** Conversation history for context */
+    chatHistory: [string, string][];
+    /** AI model provider configuration */
+    chatModelProvider: ChatModelProvider;
+    /** Whether the user is authenticated */
+    isAuthenticated: boolean;
+    /** Ref to current messages (avoids stale closures) */
+    messagesRef: React.MutableRefObject<Message[]>;
+    /** Ref to the AbortController for cancelling the stream */
+    abortControllerRef: React.MutableRefObject<AbortController | null>;
+    /** Setter for loading state */
+    setLoading: (loading: boolean) => void;
+    /** Setter for message appeared state */
+    setMessageAppeared: (appeared: boolean) => void;
+    /** Setter for messages array */
+    setMessages: React.Dispatch<React.SetStateAction<Message[]>>;
+    /** Setter for chat history */
+    setChatHistory: React.Dispatch<React.SetStateAction<[string, string][]>>;
+    /** Setter for the selected chat model provider (optional — used to reset on model errors) */
+    setChatModelProvider?: (provider: ChatModelProvider) => void;
+}
+/**
+ * Sends a message to the chat API and handles the streaming response.
+ *
+ * This function:
+ * 1. Adds the user message to the chat immediately
+ * 2. Sends the request to `/api/chat`
+ * 3. Processes the streaming response (sources, message chunks, completion)
+ * 4. Updates the URL to include the chat ID
+ * 5. Triggers auto media search if enabled
+ * 6. Fetches follow-up suggestions after the response completes
+ *
+ * The streaming response is expected in newline-delimited JSON format with
+ * message types: 'sources', 'message', 'messageEnd', 'error'.
+ *
+ * @param params - The message parameters
+ * @param deps - State and setter dependencies from ChatProvider
+ *
+ * @example
+ * ```typescript
+ * await sendMessage(
+ *   { message: 'What is TypeScript?', rewrite: false },
+ *   {
+ *     chatId: 'abc123',
+ *     loading: false,
+ *     messages: [],
+ *     // ... other dependencies
+ *   }
+ * );
+ * ```
+ */
+export declare function sendMessage(params: SendMessageParams, deps: SendMessageDeps): Promise<void>;

package/dist/hooks/useChat/useChat.d.ts

@@ -0,0 +1,3 @@
+export { ChatProvider, useChat, chatContext } from '.';
+export type { ChatContextValue as ChatContext } from '.';
+export type { Section, ChatFile as File } from '.';