@hef2024/llmasaservice-ui 0.16.10 → 0.18.0

package/README.md

@@ -157,6 +157,34 @@ See our storybook documentation showing how to theme, size and use the variaous
 
 https://predictabilityatscale.github.io/llmasaservice-ui/?path=/docs/chatpanel--docs
 
+## Programmatic Conversation Starting (v0.17.0+)
+
+Create conversations programmatically with auto-sent prompts using the imperative `startNewConversation` API:
+
+```typescript
+import { useRef } from 'react';
+import AIAgentPanel, { AIAgentPanelHandle } from '@hef2024/llmasaservice-ui';
+
+const panelRef = useRef<AIAgentPanelHandle>(null);
+
+// Quick action button that starts a conversation
+<button onClick={() => 
+  panelRef.current?.startNewConversation('Give me a summary')
+}>
+  Quick Summary
+</button>
+
+<AIAgentPanel ref={panelRef} agents={['agent-id']} customerId="user-123" />
+```
+
+Perfect for quick actions, contextual help, onboarding flows, and more!
+
+**📖 [Read Full Documentation](./docs/CONVERSATION-STARTING.md)** - Complete guide with examples and best practices.
+
+## Additional Documentation
+
+- **[Conversation History Settings](./docs/CONVERSATION-HISTORY.md)** - Configure conversation history sidebar (show/hide, position, collapse)
+- **[Full API Documentation](./local-dev-docs/AIAGENTPANEL.md)** - Complete props reference and advanced features
 
 ## License
 This project is licensed under the MIT License.

package/dist/index.d.mts

@@ -170,6 +170,12 @@ interface AgentConfig {
     localName?: string;
     avatarUrl?: string;
 }
+/**
+ * Imperative handle for programmatic control of AIAgentPanel
+ */
+interface AIAgentPanelHandle {
+    startNewConversation: (prompt: string, agent?: string) => void;
+}
 /**
  * Props for AIAgentPanel
  */
@@ -218,12 +224,15 @@ interface AIAgentPanelProps {
         clickCode?: string;
         style?: string;
     }[];
+    initialPrompt?: string;
+    initialMessage?: string;
+    hideInitialPrompt?: boolean;
     followOnQuestions?: string[];
     followOnPrompt?: string;
     historyListLimit?: number;
     showConversationHistory?: boolean;
 }
-declare const AIAgentPanel: React__default.FC<AIAgentPanelProps>;
+declare const AIAgentPanel: React__default.ForwardRefExoticComponent<AIAgentPanelProps & React__default.RefAttributes<AIAgentPanelHandle>>;
 
 /**
  * AIChatPanel - A modern chat interface using shadcn-style components

package/dist/index.d.ts

@@ -170,6 +170,12 @@ interface AgentConfig {
     localName?: string;
     avatarUrl?: string;
 }
+/**
+ * Imperative handle for programmatic control of AIAgentPanel
+ */
+interface AIAgentPanelHandle {
+    startNewConversation: (prompt: string, agent?: string) => void;
+}
 /**
  * Props for AIAgentPanel
  */
@@ -218,12 +224,15 @@ interface AIAgentPanelProps {
         clickCode?: string;
         style?: string;
     }[];
+    initialPrompt?: string;
+    initialMessage?: string;
+    hideInitialPrompt?: boolean;
     followOnQuestions?: string[];
     followOnPrompt?: string;
     historyListLimit?: number;
     showConversationHistory?: boolean;
 }
-declare const AIAgentPanel: React__default.FC<AIAgentPanelProps>;
+declare const AIAgentPanel: React__default.ForwardRefExoticComponent<AIAgentPanelProps & React__default.RefAttributes<AIAgentPanelHandle>>;
 
 /**
  * AIChatPanel - A modern chat interface using shadcn-style components

package/dist/index.js

@@ -3669,6 +3669,7 @@ var AIChatPanel = ({
   const prevIdleRef = (0, import_react11.useRef)(true);
   const hasNotifiedCompletionRef = (0, import_react11.useRef)(true);
   const latestHistoryRef = (0, import_react11.useRef)(initialHistory);
+  const initialPromptSentRef = (0, import_react11.useRef)(false);
   (0, import_react11.useEffect)(() => {
     if (!initialHistory) return;
     setHistory((prev) => {
@@ -3913,11 +3914,22 @@ var AIChatPanel = ({
     const promptToSend = promptText;
     if (!promptToSend || !promptToSend.trim()) return;
     setIsLoading(true);
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const promptKey = `${timestamp}:${promptToSend.trim()}`;
+    setHistory((prevHistory) => __spreadProps(__spreadValues({}, prevHistory), {
+      [promptKey]: { content: "", callId: "" }
+    }));
+    setLastPrompt(promptToSend.trim());
+    setLastKey(promptKey);
+    setTimeout(() => {
+      scrollToBottom();
+    }, 0);
     console.log("AIChatPanel.continueChat - about to call ensureConversation");
     ensureConversation().then((convId) => {
       console.log("AIChatPanel.continueChat - ensureConversation resolved with:", convId);
       const messagesAndHistory = [];
       Object.entries(history).forEach(([historyPrompt, historyEntry]) => {
+        if (historyPrompt === promptKey) return;
         let promptForHistory = historyPrompt;
         const isoTimestampRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z:/;
         if (isoTimestampRegex.test(historyPrompt)) {
@@ -3930,13 +3942,8 @@ var AIChatPanel = ({
         messagesAndHistory.push({ role: "user", content: promptForHistory });
         messagesAndHistory.push({ role: "assistant", content: historyEntry.content });
       });
-      const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-      const promptKey = `${timestamp}:${promptToSend.trim()}`;
-      setHistory((prevHistory) => __spreadProps(__spreadValues({}, prevHistory), {
-        [promptKey]: { content: "", callId: "" }
-      }));
       let fullPromptToSend = promptToSend.trim();
-      if (Object.keys(history).length === 0 && promptTemplate) {
+      if (messagesAndHistory.length === 0 && promptTemplate) {
         fullPromptToSend = promptTemplate.replace("{{prompt}}", fullPromptToSend);
       }
       if (followOnPrompt) {
@@ -3963,17 +3970,12 @@ ${followOnPrompt}`;
         // Use the conversation ID from ensureConversation
         newController
       );
-      setLastPrompt(promptToSend.trim());
       setLastMessages(messagesAndHistory);
-      setLastKey(promptKey);
       if (convId && onConversationCreated) {
         setTimeout(() => {
           onConversationCreated(convId);
         }, 100);
       }
-      setTimeout(() => {
-        scrollToBottom();
-      }, 0);
     });
   }, [
     idle,
@@ -4128,50 +4130,11 @@ ${followOnPrompt}`;
     };
   }, []);
   (0, import_react11.useEffect)(() => {
-    const hasLoadedHistory = initialHistory && Object.keys(initialHistory).length > 0;
-    if (!project_id) {
-      return;
-    }
-    if (initialPrompt && initialPrompt !== "" && initialPrompt !== lastPrompt && !hasLoadedHistory) {
-      setIsLoading(true);
-      setThinkingBlocks([]);
-      setCurrentThinkingIndex(0);
-      setUserHasScrolled(false);
-      ensureConversation().then((convId) => {
-        const controller = new AbortController();
-        setLastController(controller);
-        const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-        const promptKey = `${timestamp}:${initialPrompt}`;
-        setHistory({ [promptKey]: { content: "", callId: "" } });
-        let fullPrompt = initialPrompt;
-        if (promptTemplate) {
-          fullPrompt = promptTemplate.replace("{{prompt}}", initialPrompt);
-        }
-        send(
-          fullPrompt,
-          [],
-          [
-            ...dataWithExtras(),
-            { key: "--messages", data: "0" }
-          ],
-          true,
-          true,
-          service,
-          convId,
-          // Use conversation ID from ensureConversation
-          controller
-        );
-        setLastPrompt(initialPrompt);
-        setLastMessages([]);
-        setLastKey(promptKey);
-        if (convId && onConversationCreated) {
-          setTimeout(() => {
-            onConversationCreated(convId);
-          }, 100);
-        }
-      });
+    if (initialPrompt && initialPrompt !== "" && !initialPromptSentRef.current) {
+      initialPromptSentRef.current = true;
+      continueChat(initialPrompt);
     }
-  }, [initialPrompt, initialHistory, ensureConversation, promptTemplate, send, dataWithExtras, service, lastPrompt, project_id, onConversationCreated]);
+  }, [initialPrompt, continueChat]);
   const CodeBlock = (0, import_react11.useCallback)((_a) => {
     var _b = _a, { node, inline, className, children } = _b, props = __objRest(_b, ["node", "inline", "className", "children"]);
     const match = /language-(\w+)/.exec(className || "");
@@ -4688,6 +4651,9 @@ var ChatPanelWrapper = ({
   effectiveCustomer,
   showPoweredBy,
   actions,
+  initialPrompt,
+  initialMessage,
+  hideInitialPrompt,
   followOnQuestions,
   followOnPrompt,
   agentOptions,
@@ -4698,7 +4664,8 @@ var ChatPanelWrapper = ({
   totalContextTokens,
   maxContextTokens,
   enableContextDetailView,
-  onConversationCreated
+  onConversationCreated,
+  conversationInitialPrompt
 }) => {
   var _a, _b;
   const convAgentProfile = getAgent(activeConv.agentId);
@@ -4734,6 +4701,7 @@ var ChatPanelWrapper = ({
   const mcpServers = (0, import_react13.useMemo)(() => {
     return (convAgentProfile == null ? void 0 : convAgentProfile.mcpServers) || EMPTY_ARRAY;
   }, [convAgentProfile == null ? void 0 : convAgentProfile.mcpServers]);
+  const effectiveInitialPrompt = conversationInitialPrompt || initialPrompt;
   if (!convAgentMetadata) return null;
   return /* @__PURE__ */ import_react13.default.createElement(
     "div",
@@ -4750,10 +4718,10 @@ var ChatPanelWrapper = ({
         title: "",
         theme,
         promptTemplate: convAgentMetadata.displayPromptTemplate || "{{prompt}}",
-        initialMessage: convAgentMetadata.displayStartMessageOrPrompt === "message" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0,
-        initialPrompt: convAgentMetadata.displayStartMessageOrPrompt === "prompt" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0,
+        initialMessage: initialMessage || (convAgentMetadata.displayStartMessageOrPrompt === "message" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0),
+        initialPrompt: effectiveInitialPrompt || (convAgentMetadata.displayStartMessageOrPrompt === "prompt" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0),
         placeholder: convAgentMetadata.displayPlaceholder || "Type a message...",
-        hideInitialPrompt: (_a = convAgentMetadata.displayHideInitialPrompt) != null ? _a : true,
+        hideInitialPrompt: (_a = hideInitialPrompt != null ? hideInitialPrompt : convAgentMetadata.displayHideInitialPrompt) != null ? _a : true,
         data: chatPanelData,
         agent: activeConv.agentId,
         conversation: activeConv.conversationId.startsWith("new-") ? void 0 : activeConv.conversationId,
@@ -4787,7 +4755,7 @@ var ChatPanelWrapper = ({
   );
 };
 ChatPanelWrapper.displayName = "ChatPanelWrapper";
-var AIAgentPanel = ({
+var AIAgentPanel = import_react13.default.forwardRef(({
   agents,
   defaultAgent,
   customerId,
@@ -4819,11 +4787,14 @@ var AIAgentPanel = ({
   showPoweredBy = true,
   conversation,
   actions = [],
+  initialPrompt,
+  initialMessage,
+  hideInitialPrompt,
   followOnQuestions = [],
   followOnPrompt = "",
   historyListLimit = 50,
   showConversationHistory = true
-}) => {
+}, ref) => {
   var _a, _b, _c, _d;
   const [isCollapsed, setIsCollapsed] = (0, import_react13.useState)(defaultCollapsed);
   const [isHistoryCollapsed, setIsHistoryCollapsed] = (0, import_react13.useState)(() => {
@@ -4905,6 +4876,29 @@ var AIAgentPanel = ({
   activeConversationsRef.current = activeConversations;
   const currentConversationIdRef = (0, import_react13.useRef)(currentConversationId);
   currentConversationIdRef.current = currentConversationId;
+  import_react13.default.useImperativeHandle(ref, () => ({
+    startNewConversation: (prompt, agent) => {
+      const targetAgent = agent || currentAgentId;
+      const tempId = `new-${Date.now()}`;
+      setActiveConversations((prev) => {
+        const next = new Map(prev);
+        next.set(tempId, {
+          conversationId: tempId,
+          stableKey: tempId,
+          agentId: targetAgent,
+          history: {},
+          isLoading: false,
+          title: "New conversation",
+          conversationInitialPrompt: prompt
+        });
+        return next;
+      });
+      setCurrentConversationId(tempId);
+      if (onConversationChange) {
+        onConversationChange(tempId);
+      }
+    }
+  }), [currentAgentId, onConversationChange]);
   const [showContextNotification, setShowContextNotification] = (0, import_react13.useState)(false);
   const prevContextRef = (0, import_react13.useRef)(null);
   const contextNotificationTimeoutRef = (0, import_react13.useRef)(null);
@@ -5248,15 +5242,17 @@ var AIAgentPanel = ({
     let filtered = apiConversations;
     if (searchQuery) {
       const query = searchQuery.toLowerCase();
-      filtered = filtered.filter(
-        (conv) => {
-          var _a2, _b2;
-          return ((_a2 = conv.title) == null ? void 0 : _a2.toLowerCase().includes(query)) || ((_b2 = conv.summary) == null ? void 0 : _b2.toLowerCase().includes(query));
-        }
-      );
+      filtered = filtered.filter((conv) => {
+        var _a2, _b2;
+        if ((_a2 = conv.title) == null ? void 0 : _a2.toLowerCase().includes(query)) return true;
+        if ((_b2 = conv.summary) == null ? void 0 : _b2.toLowerCase().includes(query)) return true;
+        const firstPrompt = conversationFirstPrompts[conv.conversationId];
+        if (firstPrompt == null ? void 0 : firstPrompt.toLowerCase().includes(query)) return true;
+        return false;
+      });
     }
     return groupConversationsByTime(filtered, true);
-  }, [apiConversations, searchQuery]);
+  }, [apiConversations, searchQuery, conversationFirstPrompts]);
   const effectiveCustomer = (0, import_react13.useMemo)(() => {
     return __spreadProps(__spreadValues({}, customer), {
       customer_id: customerId
@@ -5865,6 +5861,9 @@ var AIAgentPanel = ({
         effectiveCustomer,
         showPoweredBy,
         actions,
+        initialPrompt,
+        initialMessage,
+        hideInitialPrompt,
         followOnQuestions,
         followOnPrompt,
         agentOptions,
@@ -5875,7 +5874,8 @@ var AIAgentPanel = ({
         totalContextTokens: mergedContext.totalTokens || 0,
         maxContextTokens,
         enableContextDetailView,
-        onConversationCreated: handleConversationCreated
+        onConversationCreated: handleConversationCreated,
+        conversationInitialPrompt: activeConv.conversationInitialPrompt
       }
     )), loadingConversationId && /* @__PURE__ */ import_react13.default.createElement("div", { className: "ai-agent-panel__conversation-loading-overlay" }, /* @__PURE__ */ import_react13.default.createElement("div", { className: "ai-agent-panel__loading-spinner" }), /* @__PURE__ */ import_react13.default.createElement("p", null, "Loading conversation...")), currentAgentMetadata && activeConversationsList.length === 0 && !loadingConversationId && /* @__PURE__ */ import_react13.default.createElement("div", { className: "ai-agent-panel__empty-chat" }, /* @__PURE__ */ import_react13.default.createElement(MessageIcon, null), /* @__PURE__ */ import_react13.default.createElement("p", null, "Select a conversation or start a new one"), /* @__PURE__ */ import_react13.default.createElement(Button, { variant: "default", size: "sm", onClick: handleNewConversation }, "New Conversation")), agentsLoading && !currentAgentMetadata && /* @__PURE__ */ import_react13.default.createElement("div", { className: "ai-agent-panel__loading" }, /* @__PURE__ */ import_react13.default.createElement("div", { className: "ai-agent-panel__loading-spinner" }), /* @__PURE__ */ import_react13.default.createElement("p", null, "Loading agent..."))),
     /* @__PURE__ */ import_react13.default.createElement(
@@ -5889,7 +5889,8 @@ var AIAgentPanel = ({
       /* @__PURE__ */ import_react13.default.createElement(DialogFooter, null, /* @__PURE__ */ import_react13.default.createElement(Button, { variant: "outline", onClick: handleHandoffCancel }, "Stay with current agent"), /* @__PURE__ */ import_react13.default.createElement(Button, { onClick: handleHandoffConfirm }, "Switch agent"))
     )
   );
-};
+});
+AIAgentPanel.displayName = "AIAgentPanel";
 var AIAgentPanel_default = AIAgentPanel;
 
 // src/hooks/useConversationStore.ts

package/dist/index.mjs

@@ -3636,6 +3636,7 @@ var AIChatPanel = ({
   const prevIdleRef = useRef5(true);
   const hasNotifiedCompletionRef = useRef5(true);
   const latestHistoryRef = useRef5(initialHistory);
+  const initialPromptSentRef = useRef5(false);
   useEffect7(() => {
     if (!initialHistory) return;
     setHistory((prev) => {
@@ -3880,11 +3881,22 @@ var AIChatPanel = ({
     const promptToSend = promptText;
     if (!promptToSend || !promptToSend.trim()) return;
     setIsLoading(true);
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    const promptKey = `${timestamp}:${promptToSend.trim()}`;
+    setHistory((prevHistory) => __spreadProps(__spreadValues({}, prevHistory), {
+      [promptKey]: { content: "", callId: "" }
+    }));
+    setLastPrompt(promptToSend.trim());
+    setLastKey(promptKey);
+    setTimeout(() => {
+      scrollToBottom();
+    }, 0);
     console.log("AIChatPanel.continueChat - about to call ensureConversation");
     ensureConversation().then((convId) => {
       console.log("AIChatPanel.continueChat - ensureConversation resolved with:", convId);
       const messagesAndHistory = [];
       Object.entries(history).forEach(([historyPrompt, historyEntry]) => {
+        if (historyPrompt === promptKey) return;
         let promptForHistory = historyPrompt;
         const isoTimestampRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z:/;
         if (isoTimestampRegex.test(historyPrompt)) {
@@ -3897,13 +3909,8 @@ var AIChatPanel = ({
         messagesAndHistory.push({ role: "user", content: promptForHistory });
         messagesAndHistory.push({ role: "assistant", content: historyEntry.content });
       });
-      const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-      const promptKey = `${timestamp}:${promptToSend.trim()}`;
-      setHistory((prevHistory) => __spreadProps(__spreadValues({}, prevHistory), {
-        [promptKey]: { content: "", callId: "" }
-      }));
       let fullPromptToSend = promptToSend.trim();
-      if (Object.keys(history).length === 0 && promptTemplate) {
+      if (messagesAndHistory.length === 0 && promptTemplate) {
         fullPromptToSend = promptTemplate.replace("{{prompt}}", fullPromptToSend);
       }
       if (followOnPrompt) {
@@ -3930,17 +3937,12 @@ ${followOnPrompt}`;
         // Use the conversation ID from ensureConversation
         newController
       );
-      setLastPrompt(promptToSend.trim());
       setLastMessages(messagesAndHistory);
-      setLastKey(promptKey);
       if (convId && onConversationCreated) {
         setTimeout(() => {
           onConversationCreated(convId);
         }, 100);
       }
-      setTimeout(() => {
-        scrollToBottom();
-      }, 0);
     });
   }, [
     idle,
@@ -4095,50 +4097,11 @@ ${followOnPrompt}`;
     };
   }, []);
   useEffect7(() => {
-    const hasLoadedHistory = initialHistory && Object.keys(initialHistory).length > 0;
-    if (!project_id) {
-      return;
-    }
-    if (initialPrompt && initialPrompt !== "" && initialPrompt !== lastPrompt && !hasLoadedHistory) {
-      setIsLoading(true);
-      setThinkingBlocks([]);
-      setCurrentThinkingIndex(0);
-      setUserHasScrolled(false);
-      ensureConversation().then((convId) => {
-        const controller = new AbortController();
-        setLastController(controller);
-        const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-        const promptKey = `${timestamp}:${initialPrompt}`;
-        setHistory({ [promptKey]: { content: "", callId: "" } });
-        let fullPrompt = initialPrompt;
-        if (promptTemplate) {
-          fullPrompt = promptTemplate.replace("{{prompt}}", initialPrompt);
-        }
-        send(
-          fullPrompt,
-          [],
-          [
-            ...dataWithExtras(),
-            { key: "--messages", data: "0" }
-          ],
-          true,
-          true,
-          service,
-          convId,
-          // Use conversation ID from ensureConversation
-          controller
-        );
-        setLastPrompt(initialPrompt);
-        setLastMessages([]);
-        setLastKey(promptKey);
-        if (convId && onConversationCreated) {
-          setTimeout(() => {
-            onConversationCreated(convId);
-          }, 100);
-        }
-      });
+    if (initialPrompt && initialPrompt !== "" && !initialPromptSentRef.current) {
+      initialPromptSentRef.current = true;
+      continueChat(initialPrompt);
     }
-  }, [initialPrompt, initialHistory, ensureConversation, promptTemplate, send, dataWithExtras, service, lastPrompt, project_id, onConversationCreated]);
+  }, [initialPrompt, continueChat]);
   const CodeBlock = useCallback2((_a) => {
     var _b = _a, { node, inline, className, children } = _b, props = __objRest(_b, ["node", "inline", "className", "children"]);
     const match = /language-(\w+)/.exec(className || "");
@@ -4655,6 +4618,9 @@ var ChatPanelWrapper = ({
   effectiveCustomer,
   showPoweredBy,
   actions,
+  initialPrompt,
+  initialMessage,
+  hideInitialPrompt,
   followOnQuestions,
   followOnPrompt,
   agentOptions,
@@ -4665,7 +4631,8 @@ var ChatPanelWrapper = ({
   totalContextTokens,
   maxContextTokens,
   enableContextDetailView,
-  onConversationCreated
+  onConversationCreated,
+  conversationInitialPrompt
 }) => {
   var _a, _b;
   const convAgentProfile = getAgent(activeConv.agentId);
@@ -4701,6 +4668,7 @@ var ChatPanelWrapper = ({
   const mcpServers = useMemo4(() => {
     return (convAgentProfile == null ? void 0 : convAgentProfile.mcpServers) || EMPTY_ARRAY;
   }, [convAgentProfile == null ? void 0 : convAgentProfile.mcpServers]);
+  const effectiveInitialPrompt = conversationInitialPrompt || initialPrompt;
   if (!convAgentMetadata) return null;
   return /* @__PURE__ */ React12.createElement(
     "div",
@@ -4717,10 +4685,10 @@ var ChatPanelWrapper = ({
         title: "",
         theme,
         promptTemplate: convAgentMetadata.displayPromptTemplate || "{{prompt}}",
-        initialMessage: convAgentMetadata.displayStartMessageOrPrompt === "message" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0,
-        initialPrompt: convAgentMetadata.displayStartMessageOrPrompt === "prompt" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0,
+        initialMessage: initialMessage || (convAgentMetadata.displayStartMessageOrPrompt === "message" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0),
+        initialPrompt: effectiveInitialPrompt || (convAgentMetadata.displayStartMessageOrPrompt === "prompt" ? convAgentMetadata.displayInitialMessageOrPrompt : void 0),
         placeholder: convAgentMetadata.displayPlaceholder || "Type a message...",
-        hideInitialPrompt: (_a = convAgentMetadata.displayHideInitialPrompt) != null ? _a : true,
+        hideInitialPrompt: (_a = hideInitialPrompt != null ? hideInitialPrompt : convAgentMetadata.displayHideInitialPrompt) != null ? _a : true,
         data: chatPanelData,
         agent: activeConv.agentId,
         conversation: activeConv.conversationId.startsWith("new-") ? void 0 : activeConv.conversationId,
@@ -4754,7 +4722,7 @@ var ChatPanelWrapper = ({
   );
 };
 ChatPanelWrapper.displayName = "ChatPanelWrapper";
-var AIAgentPanel = ({
+var AIAgentPanel = React12.forwardRef(({
   agents,
   defaultAgent,
   customerId,
@@ -4786,11 +4754,14 @@ var AIAgentPanel = ({
   showPoweredBy = true,
   conversation,
   actions = [],
+  initialPrompt,
+  initialMessage,
+  hideInitialPrompt,
   followOnQuestions = [],
   followOnPrompt = "",
   historyListLimit = 50,
   showConversationHistory = true
-}) => {
+}, ref) => {
   var _a, _b, _c, _d;
   const [isCollapsed, setIsCollapsed] = useState8(defaultCollapsed);
   const [isHistoryCollapsed, setIsHistoryCollapsed] = useState8(() => {
@@ -4872,6 +4843,29 @@ var AIAgentPanel = ({
   activeConversationsRef.current = activeConversations;
   const currentConversationIdRef = useRef6(currentConversationId);
   currentConversationIdRef.current = currentConversationId;
+  React12.useImperativeHandle(ref, () => ({
+    startNewConversation: (prompt, agent) => {
+      const targetAgent = agent || currentAgentId;
+      const tempId = `new-${Date.now()}`;
+      setActiveConversations((prev) => {
+        const next = new Map(prev);
+        next.set(tempId, {
+          conversationId: tempId,
+          stableKey: tempId,
+          agentId: targetAgent,
+          history: {},
+          isLoading: false,
+          title: "New conversation",
+          conversationInitialPrompt: prompt
+        });
+        return next;
+      });
+      setCurrentConversationId(tempId);
+      if (onConversationChange) {
+        onConversationChange(tempId);
+      }
+    }
+  }), [currentAgentId, onConversationChange]);
   const [showContextNotification, setShowContextNotification] = useState8(false);
   const prevContextRef = useRef6(null);
   const contextNotificationTimeoutRef = useRef6(null);
@@ -5215,15 +5209,17 @@ var AIAgentPanel = ({
     let filtered = apiConversations;
     if (searchQuery) {
       const query = searchQuery.toLowerCase();
-      filtered = filtered.filter(
-        (conv) => {
-          var _a2, _b2;
-          return ((_a2 = conv.title) == null ? void 0 : _a2.toLowerCase().includes(query)) || ((_b2 = conv.summary) == null ? void 0 : _b2.toLowerCase().includes(query));
-        }
-      );
+      filtered = filtered.filter((conv) => {
+        var _a2, _b2;
+        if ((_a2 = conv.title) == null ? void 0 : _a2.toLowerCase().includes(query)) return true;
+        if ((_b2 = conv.summary) == null ? void 0 : _b2.toLowerCase().includes(query)) return true;
+        const firstPrompt = conversationFirstPrompts[conv.conversationId];
+        if (firstPrompt == null ? void 0 : firstPrompt.toLowerCase().includes(query)) return true;
+        return false;
+      });
     }
     return groupConversationsByTime(filtered, true);
-  }, [apiConversations, searchQuery]);
+  }, [apiConversations, searchQuery, conversationFirstPrompts]);
   const effectiveCustomer = useMemo4(() => {
     return __spreadProps(__spreadValues({}, customer), {
       customer_id: customerId
@@ -5832,6 +5828,9 @@ var AIAgentPanel = ({
         effectiveCustomer,
         showPoweredBy,
         actions,
+        initialPrompt,
+        initialMessage,
+        hideInitialPrompt,
         followOnQuestions,
         followOnPrompt,
         agentOptions,
@@ -5842,7 +5841,8 @@ var AIAgentPanel = ({
         totalContextTokens: mergedContext.totalTokens || 0,
         maxContextTokens,
         enableContextDetailView,
-        onConversationCreated: handleConversationCreated
+        onConversationCreated: handleConversationCreated,
+        conversationInitialPrompt: activeConv.conversationInitialPrompt
       }
     )), loadingConversationId && /* @__PURE__ */ React12.createElement("div", { className: "ai-agent-panel__conversation-loading-overlay" }, /* @__PURE__ */ React12.createElement("div", { className: "ai-agent-panel__loading-spinner" }), /* @__PURE__ */ React12.createElement("p", null, "Loading conversation...")), currentAgentMetadata && activeConversationsList.length === 0 && !loadingConversationId && /* @__PURE__ */ React12.createElement("div", { className: "ai-agent-panel__empty-chat" }, /* @__PURE__ */ React12.createElement(MessageIcon, null), /* @__PURE__ */ React12.createElement("p", null, "Select a conversation or start a new one"), /* @__PURE__ */ React12.createElement(Button, { variant: "default", size: "sm", onClick: handleNewConversation }, "New Conversation")), agentsLoading && !currentAgentMetadata && /* @__PURE__ */ React12.createElement("div", { className: "ai-agent-panel__loading" }, /* @__PURE__ */ React12.createElement("div", { className: "ai-agent-panel__loading-spinner" }), /* @__PURE__ */ React12.createElement("p", null, "Loading agent..."))),
     /* @__PURE__ */ React12.createElement(
@@ -5856,7 +5856,8 @@ var AIAgentPanel = ({
       /* @__PURE__ */ React12.createElement(DialogFooter, null, /* @__PURE__ */ React12.createElement(Button, { variant: "outline", onClick: handleHandoffCancel }, "Stay with current agent"), /* @__PURE__ */ React12.createElement(Button, { onClick: handleHandoffConfirm }, "Switch agent"))
     )
   );
-};
+});
+AIAgentPanel.displayName = "AIAgentPanel";
 var AIAgentPanel_default = AIAgentPanel;
 
 // src/hooks/useConversationStore.ts