@apteva/apteva-kit 0.1.31 → 0.1.33

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import * as react from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ClassValue } from 'clsx';
 
@@ -363,7 +364,17 @@ interface UseAptevaKitReturn {
     error: Error | null;
 }
 
-declare function Chat({ agentId, threadId, initialMessages, context, apiUrl, apiKey, useMock, initialMode, showModeToggle, onModeChange, commandVariant, planMode, onPlanModeChange, enableStreaming, showProgress, loadingText, welcomeTitle, welcomeSubtitle, welcomeIcon, suggestedPrompts, welcomeVariant, onThreadChange, onMessageSent, onAction, onFileUpload, onComplete, onError, onToolResult, placeholder, showHeader, headerTitle, enableWidgets, availableWidgets, compactWidgetContext, onWidgetRender, className, }: ChatProps): react_jsx_runtime.JSX.Element;
+interface ChatHandle {
+    /** Send a message programmatically (as if the user typed it) */
+    sendMessage: (text: string) => Promise<void>;
+    /** Send a system/background message (not shown as user message, just triggers agent) */
+    sendSystemMessage: (text: string) => Promise<void>;
+    /** Get current messages */
+    getMessages: () => Message[];
+    /** Clear all messages */
+    clearMessages: () => void;
+}
+declare const Chat: react.ForwardRefExoticComponent<ChatProps & react.RefAttributes<ChatHandle>>;
 
 declare function Command({ agentId, command: initialCommand, context, autoExecute, allowInput, placeholder, submitButtonText, variant, useMock, planMode, onPlanModeChange, enableFileUpload, onStart, onProgress, onChunk, onComplete, onError, onFileUpload, onAction, loadingText, showProgress, enableStreaming, resultRenderer, className, }: CommandProps): react_jsx_runtime.JSX.Element;
 
@@ -474,4 +485,4 @@ declare const mockMessages: Message[];
 declare const mockThreads: Thread[];
 declare const mockWidgets: Widget[];
 
-export { type Action, type ActionEvent, AptevaClient, type AptevaClientConfig, type AptevaKitControl, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, Command, type CommandProps, type CommandResult, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, List, type ListItem, type ListWidget, type MapWidget, type Message, Prompt, type PromptProps, type SendMessageParams, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, aptevaClient, cn, getThemeScript, mockMessages, mockThreads, mockWidgets };
+export { type Action, type ActionEvent, AptevaClient, type AptevaClientConfig, type AptevaKitControl, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatHandle, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, Command, type CommandProps, type CommandResult, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, List, type ListItem, type ListWidget, type MapWidget, type Message, Prompt, type PromptProps, type SendMessageParams, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, aptevaClient, cn, getThemeScript, mockMessages, mockThreads, mockWidgets };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as react from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ClassValue } from 'clsx';
 
@@ -363,7 +364,17 @@ interface UseAptevaKitReturn {
     error: Error | null;
 }
 
-declare function Chat({ agentId, threadId, initialMessages, context, apiUrl, apiKey, useMock, initialMode, showModeToggle, onModeChange, commandVariant, planMode, onPlanModeChange, enableStreaming, showProgress, loadingText, welcomeTitle, welcomeSubtitle, welcomeIcon, suggestedPrompts, welcomeVariant, onThreadChange, onMessageSent, onAction, onFileUpload, onComplete, onError, onToolResult, placeholder, showHeader, headerTitle, enableWidgets, availableWidgets, compactWidgetContext, onWidgetRender, className, }: ChatProps): react_jsx_runtime.JSX.Element;
+interface ChatHandle {
+    /** Send a message programmatically (as if the user typed it) */
+    sendMessage: (text: string) => Promise<void>;
+    /** Send a system/background message (not shown as user message, just triggers agent) */
+    sendSystemMessage: (text: string) => Promise<void>;
+    /** Get current messages */
+    getMessages: () => Message[];
+    /** Clear all messages */
+    clearMessages: () => void;
+}
+declare const Chat: react.ForwardRefExoticComponent<ChatProps & react.RefAttributes<ChatHandle>>;
 
 declare function Command({ agentId, command: initialCommand, context, autoExecute, allowInput, placeholder, submitButtonText, variant, useMock, planMode, onPlanModeChange, enableFileUpload, onStart, onProgress, onChunk, onComplete, onError, onFileUpload, onAction, loadingText, showProgress, enableStreaming, resultRenderer, className, }: CommandProps): react_jsx_runtime.JSX.Element;
 
@@ -474,4 +485,4 @@ declare const mockMessages: Message[];
 declare const mockThreads: Thread[];
 declare const mockWidgets: Widget[];
 
-export { type Action, type ActionEvent, AptevaClient, type AptevaClientConfig, type AptevaKitControl, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, Command, type CommandProps, type CommandResult, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, List, type ListItem, type ListWidget, type MapWidget, type Message, Prompt, type PromptProps, type SendMessageParams, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, aptevaClient, cn, getThemeScript, mockMessages, mockThreads, mockWidgets };
+export { type Action, type ActionEvent, AptevaClient, type AptevaClientConfig, type AptevaKitControl, Button, type ButtonGroupWidget, type ButtonWidget, Card, type CardWidget, type ChartWidget, Chat, type ChatHandle, type ChatMessage, type ChatProps, type ChatRequest, type ChatResponse, Command, type CommandProps, type CommandResult, type FormField, type FormWidget, type GalleryWidget, type ImageWidget, List, type ListItem, type ListWidget, type MapWidget, type Message, Prompt, type PromptProps, type SendMessageParams, Stream, type StreamChunk, type StreamProps, type SuggestedPrompt, type TableColumn, type TableWidget, type Thread, Threads, type ThreadsProps, type UseAptevaKitReturn, type Widget, Widgets, type WidgetsProps, aptevaClient, cn, getThemeScript, mockMessages, mockThreads, mockWidgets };

package/dist/index.js

@@ -2256,7 +2256,7 @@ var aptevaClient = new AptevaClient();
 
 // src/components/Chat/Chat.tsx
 
-function Chat({
+var Chat = _react.forwardRef.call(void 0, function Chat2({
   agentId,
   threadId,
   initialMessages = [],
@@ -2299,7 +2299,7 @@ function Chat({
   compactWidgetContext = false,
   onWidgetRender,
   className
-}) {
+}, ref) {
   const [messages, setMessages] = _react.useState.call(void 0, initialMessages);
   const [isLoading, setIsLoading] = _react.useState.call(void 0, false);
   const [currentThreadId, setCurrentThreadId] = _react.useState.call(void 0, threadId || null);
@@ -2318,6 +2318,21 @@ function Chat({
   const [internalPlanMode, setInternalPlanMode] = _react.useState.call(void 0, planMode);
   const [showSettingsMenu, setShowSettingsMenu] = _react.useState.call(void 0, false);
   const fileInputRef = _react.useRef.call(void 0, null);
+  const handleSendMessageRef = _react.useRef.call(void 0, null);
+  _react.useImperativeHandle.call(void 0, ref, () => ({
+    sendMessage: async (text) => {
+      if (handleSendMessageRef.current) {
+        await handleSendMessageRef.current(text);
+      }
+    },
+    sendSystemMessage: async (text) => {
+      if (handleSendMessageRef.current) {
+        await handleSendMessageRef.current(text, void 0, true);
+      }
+    },
+    getMessages: () => messages,
+    clearMessages: () => setMessages([])
+  }), [messages]);
   const effectiveContext = _react.useMemo.call(void 0, () => {
     if (!enableWidgets) return context;
     const widgetContext = compactWidgetContext ? generateCompactWidgetContext(availableWidgets) : generateWidgetContext(availableWidgets);
@@ -2360,19 +2375,21 @@ ${widgetContext}` : widgetContext;
     }
   };
   const defaultPlaceholder = mode === "chat" ? "Type a message..." : "Enter your command...";
-  const handleSendMessage = async (text, files) => {
+  const handleSendMessage = async (text, files, isSystem) => {
     const hasFiles = files && files.length > 0;
     const fileNames = hasFiles ? files.map((f) => f.name) : [];
     const displayContent = hasFiles ? `${text}${text ? "\n" : ""}[Attached: ${fileNames.join(", ")}]` : text;
-    const userMessage = {
-      id: `msg-${Date.now()}`,
-      role: "user",
-      content: displayContent,
-      timestamp: /* @__PURE__ */ new Date(),
-      metadata: hasFiles ? { attachments: fileNames } : void 0
-    };
-    setMessages((prev) => [...prev, userMessage]);
-    _optionalChain([onMessageSent, 'optionalCall', _58 => _58(userMessage)]);
+    if (!isSystem) {
+      const userMessage = {
+        id: `msg-${Date.now()}`,
+        role: "user",
+        content: displayContent,
+        timestamp: /* @__PURE__ */ new Date(),
+        metadata: hasFiles ? { attachments: fileNames } : void 0
+      };
+      setMessages((prev) => [...prev, userMessage]);
+      _optionalChain([onMessageSent, 'optionalCall', _58 => _58(userMessage)]);
+    }
     setIsLoading(true);
     try {
       const messagePayload = await buildMessageWithAttachments(text, files);
@@ -2561,6 +2578,7 @@ ${widgetContext}` : widgetContext;
       setIsLoading(false);
     }
   };
+  handleSendMessageRef.current = handleSendMessage;
   const executeCommand = async (commandOverride, files) => {
     const currentCommand = commandOverride || commandInput;
     if (!currentCommand.trim() && (!files || files.length === 0)) {
@@ -2858,7 +2876,7 @@ ${planToExecute}`;
         `
     } })
   ] });
-}
+});
 
 // src/components/Chat/CommandOutput.tsx