@meetsmore-oss/use-ai-client 1.5.0 → 1.6.0

package/dist/index.d.ts

@@ -351,19 +351,30 @@ interface FileTransformerContext {
 }
 /**
  * A transformer that converts files into string representations for the AI.
+ *
+ * Receives all files that were matched to this transformer instance
+ * and returns one string per file in the same order.
+ *
+ * @example
+ * ```typescript
+ * const pdfTransformer: FileTransformer = {
+ *   transform: async (files, context) =>
+ *     Promise.all(files.map(f => extractText(f))),
+ * };
+ * ```
  */
 interface FileTransformer {
     /**
-     * Transform the file into a string representation for the AI.
+     * Transform files into string representations for the AI.
      *
-     * @param file - The file to transform
+     * @param files - The files to transform (all matched to this transformer instance)
      * @param context - Context including the current chat and its metadata
      * @param onProgress - Optional callback for reporting progress (0-100).
      *                     If called, UI shows progress bar; otherwise shows spinner.
-     * @returns A string representation the AI will receive
+     * @returns One string per input file, in the same order
      * @throws If transformation fails
      */
-    transform(file: File, context: FileTransformerContext, onProgress?: (progress: number) => void): Promise<string>;
+    transform(files: File[], context: FileTransformerContext, onProgress?: (progress: number) => void): Promise<string[]>;
 }
 /**
  * Map of MIME type patterns to transformers.
@@ -702,6 +713,24 @@ declare const defaultStrings: {
         /** Fallback messages when no tool title is provided (one randomly selected) */
         fallbackMessages: string[];
     };
+    toolApproval: {
+        /** Title shown in the approval dialog */
+        title: string;
+        /** Message shown in the approval dialog. {toolName} is replaced with tool name. */
+        message: string;
+        /** Message shown when multiple tools are awaiting approval. {count} is replaced with number. */
+        batchMessage: string;
+        /** Label for approve button */
+        approve: string;
+        /** Label for approve all button (batch mode) */
+        approveAll: string;
+        /** Label for reject button */
+        reject: string;
+        /** Label for reject all button (batch mode) */
+        rejectAll: string;
+        /** Label for showing tool arguments */
+        showDetails: string;
+    };
 };
 /**
  * Customizable text labels for the chat UI.
@@ -859,12 +888,23 @@ interface UseAIChatPanelProps {
     feedbackEnabled?: boolean;
     /** Callback when user submits feedback on a message */
     onFeedback?: (messageId: string, traceId: string, feedback: FeedbackValue) => void;
+    /** Pending tool approvals awaiting user confirmation */
+    pendingApprovals?: Array<{
+        toolCallId: string;
+        toolCallName: string;
+        toolCallArgs: Record<string, unknown>;
+        annotations?: ToolAnnotations;
+    }>;
+    /** Callback to approve all pending tool calls */
+    onApproveToolCall?: () => void;
+    /** Callback to reject all pending tool calls */
+    onRejectToolCall?: (reason?: string) => void;
 }
 /**
  * Chat panel content - fills its container.
  * Use directly for embedded mode, or wrap with UseAIFloatingChatWrapper for floating mode.
  */
-declare function UseAIChatPanel({ onSendMessage, messages, loading, connected, streamingText, currentChatId, onNewChat, onLoadChat, onDeleteChat, onListChats, onGetChat, suggestions, availableAgents, defaultAgent, selectedAgent, onAgentChange, fileUploadConfig, fileProcessing, commands, onSaveCommand, onRenameCommand, onDeleteCommand, closeButton, executingTool, feedbackEnabled, onFeedback, }: UseAIChatPanelProps): react_jsx_runtime.JSX.Element;
+declare function UseAIChatPanel({ onSendMessage, messages, loading, connected, streamingText, currentChatId, onNewChat, onLoadChat, onDeleteChat, onListChats, onGetChat, suggestions, availableAgents, defaultAgent, selectedAgent, onAgentChange, fileUploadConfig, fileProcessing, commands, onSaveCommand, onRenameCommand, onDeleteCommand, closeButton, executingTool, feedbackEnabled, onFeedback, pendingApprovals, onApproveToolCall, onRejectToolCall, }: UseAIChatPanelProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Handler for AG-UI events from the server.
@@ -964,6 +1004,14 @@ declare class UseAIClient {
      * @param state - Optional updated state to send back to the AI
      */
     sendToolResponse(toolCallId: string, result: unknown, state?: unknown): void;
+    /**
+     * Sends a tool approval response back to the server.
+     *
+     * @param toolCallId - The ID of the tool call being approved/rejected
+     * @param approved - Whether the tool execution is approved
+     * @param reason - Optional reason for rejection (shown to AI)
+     */
+    sendToolApprovalResponse(toolCallId: string, approved: boolean, reason?: string): void;
     /**
      * Retrieves accumulated tool call data for a specific tool call ID.
      * Used to get the complete tool name and arguments after they've been streamed
@@ -1132,6 +1180,8 @@ interface UseChatManagementOptions {
     connected?: boolean;
     /** Whether the AI is currently loading/processing a response */
     loading?: boolean;
+    /** Whether there's a pending tool approval blocking the queue */
+    hasPendingApproval?: boolean;
 }
 interface UseChatManagementReturn {
     /** Current active chat ID where AI responses are saved */
@@ -1202,7 +1252,7 @@ interface UseChatManagementReturn {
  * });
  * ```
  */
-declare function useChatManagement({ repository, clientRef, messages, setMessages, onSendMessage, setOpen, connected, loading, }: UseChatManagementOptions): UseChatManagementReturn;
+declare function useChatManagement({ repository, clientRef, messages, setMessages, onSendMessage, setOpen, connected, loading, hasPendingApproval, }: UseChatManagementOptions): UseChatManagementReturn;
 
 /**
  * Chat management context (from useChatManagement hook).
@@ -1770,7 +1820,8 @@ declare function useFileUpload({ config, disabled, resetDependency, getCurrentCh
  */
 declare function matchesMimeType(mimeType: string, pattern: string): boolean;
 /**
- * Find the most specific transformer for a MIME type.
+ * Find the most specific transformer pattern key for a MIME type.
+ * Returns the pattern string (e.g., 'application/pdf', 'image/*') or undefined.
  *
  * Specificity rules:
  * 1. Exact match (no wildcard) always wins
@@ -1781,7 +1832,7 @@ declare function matchesMimeType(mimeType: string, pattern: string): boolean;
  * - 'image/*' (length 7, second)
  * - '*' (length 1, last)
  */
-declare function findTransformer(mimeType: string, transformers: FileTransformerMap | undefined): FileTransformer | undefined;
+declare function findTransformerPattern(mimeType: string, transformers: FileTransformerMap | undefined): string | undefined;
 
 /**
  * Configuration for processing file attachments.
@@ -1800,6 +1851,9 @@ interface ProcessAttachmentsConfig {
  * Process file attachments into multimodal content for AI.
  * Handles transformation (with caching) or URL encoding.
  *
+ * Files matching the same transformer are grouped and passed together
+ * to `transformer.transform()`.
+ *
  * @param attachments - The file attachments to process
  * @param config - Processing configuration
  * @returns Array of multimodal content parts
@@ -2244,4 +2298,4 @@ interface UseDropdownStateOptions {
  */
 declare function useDropdownState(options?: UseDropdownStateOptions): UseDropdownStateReturn;
 
-export { type AgentContextValue, type Chat, type ChatContextValue, type ChatMetadata, type ChatPanelProps, type ChatRepository, CloseButton, type CommandContextValue, type CommandRepository, type CreateChatOptions, type CreateCommandOptions, DEFAULT_MAX_FILE_SIZE, type DefinedTool, type DropZoneProps, EmbedFileUploadBackend, type FileAttachment, type FileProcessingState, type FileProcessingStatus, type FileTransformer, type FileTransformerContext, type FileTransformerMap, type FileUploadBackend, type FileUploadConfig, type FloatingButtonProps, type InlineSaveProps, type ListChatsOptions, type ListCommandsOptions, LocalStorageChatRepository, LocalStorageCommandRepository, type Message, type PersistedContentPart, type PersistedFileContent, type PersistedFileMetadata, type PersistedMessage, type PersistedMessageContent, type PersistedTextContent, type ProcessAttachmentsConfig, type PromptsContextValue, type RegisterToolsOptions, type SavedCommand, type SendMessageOptions, type ToolOptions, type ToolRegistryContextValue, type ToolsDefinition, type TriggerWorkflowOptions, UseAIChat, UseAIChatPanel, type UseAIChatPanelProps, type UseAIChatPanelStrings, type UseAIChatPanelTheme, type UseAIChatProps, UseAIClient, type UseAIConfig, type UseAIContextValue, UseAIFloatingButton, UseAIFloatingChatWrapper, type UseAIOptions, UseAIProvider, type UseAIProviderProps, type UseAIResult, type UseAIStrings, type UseAITheme, type UseAIWorkflowResult, type UseAgentSelectionOptions, type UseAgentSelectionReturn, type UseChatManagementOptions, type UseChatManagementReturn, type UseCommandManagementOptions, type UseCommandManagementReturn, type UseDropdownStateOptions, type UseDropdownStateReturn, type UseFeedbackOptions, type UseFeedbackReturn, type UseFileUploadOptions, type UseFileUploadReturn, type UsePromptStateOptions, type UsePromptStateReturn, type UseSlashCommandsOptions, type UseSlashCommandsReturn, type UseToolRegistryReturn, type WorkflowProgress, clearTransformationCache, convertToolsToDefinitions, defaultStrings, defaultTheme, defineTool, executeDefinedTool, findTransformer, generateChatId, generateCommandId, generateMessageId, matchesMimeType, processAttachments, useAI, useAIContext, useAIWorkflow, useAgentSelection, useChatManagement, useCommandManagement, useDropdownState, useFeedback, useFileUpload, usePromptState, useSlashCommands, useStableTools, useStrings, useTheme, useToolRegistry, validateCommandName };
+export { type AgentContextValue, type Chat, type ChatContextValue, type ChatMetadata, type ChatPanelProps, type ChatRepository, CloseButton, type CommandContextValue, type CommandRepository, type CreateChatOptions, type CreateCommandOptions, DEFAULT_MAX_FILE_SIZE, type DefinedTool, type DropZoneProps, EmbedFileUploadBackend, type FileAttachment, type FileProcessingState, type FileProcessingStatus, type FileTransformer, type FileTransformerContext, type FileTransformerMap, type FileUploadBackend, type FileUploadConfig, type FloatingButtonProps, type InlineSaveProps, type ListChatsOptions, type ListCommandsOptions, LocalStorageChatRepository, LocalStorageCommandRepository, type Message, type PersistedContentPart, type PersistedFileContent, type PersistedFileMetadata, type PersistedMessage, type PersistedMessageContent, type PersistedTextContent, type ProcessAttachmentsConfig, type PromptsContextValue, type RegisterToolsOptions, type SavedCommand, type SendMessageOptions, type ToolOptions, type ToolRegistryContextValue, type ToolsDefinition, type TriggerWorkflowOptions, UseAIChat, UseAIChatPanel, type UseAIChatPanelProps, type UseAIChatPanelStrings, type UseAIChatPanelTheme, type UseAIChatProps, UseAIClient, type UseAIConfig, type UseAIContextValue, UseAIFloatingButton, UseAIFloatingChatWrapper, type UseAIOptions, UseAIProvider, type UseAIProviderProps, type UseAIResult, type UseAIStrings, type UseAITheme, type UseAIWorkflowResult, type UseAgentSelectionOptions, type UseAgentSelectionReturn, type UseChatManagementOptions, type UseChatManagementReturn, type UseCommandManagementOptions, type UseCommandManagementReturn, type UseDropdownStateOptions, type UseDropdownStateReturn, type UseFeedbackOptions, type UseFeedbackReturn, type UseFileUploadOptions, type UseFileUploadReturn, type UsePromptStateOptions, type UsePromptStateReturn, type UseSlashCommandsOptions, type UseSlashCommandsReturn, type UseToolRegistryReturn, type WorkflowProgress, clearTransformationCache, convertToolsToDefinitions, defaultStrings, defaultTheme, defineTool, executeDefinedTool, findTransformerPattern, generateChatId, generateCommandId, generateMessageId, matchesMimeType, processAttachments, useAI, useAIContext, useAIWorkflow, useAgentSelection, useChatManagement, useCommandManagement, useDropdownState, useFeedback, useFileUpload, usePromptState, useSlashCommands, useStableTools, useStrings, useTheme, useToolRegistry, validateCommandName };