@gendive/chatllm 0.21.5 → 0.21.7

package/dist/react/index.d.mts

@@ -1819,6 +1819,46 @@ interface UseFloatingWidgetReturn {
     toggle: () => void;
     setTab: (tabKey: string) => void;
 }
+/**
+ * @description 대화 검색 결과 스니펫
+ * @Todo vibecode - DB에서 반환되는 과거 대화 조각
+ */
+interface ConversationSnippet {
+    /** 세션 ID */
+    sessionId: string;
+    /** 세션 제목 */
+    sessionTitle?: string;
+    /** 발화자 */
+    role: 'user' | 'assistant';
+    /** 메시지 내용 (또는 발췌) */
+    content: string;
+    /** 메시지 타임스탬프 */
+    timestamp?: number;
+    /** 검색 관련도 점수 (0-1) */
+    relevance?: number;
+}
+/**
+ * @description 대화 검색 옵션
+ * @Todo vibecode - 검색 범위 제한용
+ */
+interface ConversationSearchOptions {
+    /** 최대 결과 수 (기본: 5) */
+    limit?: number;
+    /** 특정 세션으로 제한 */
+    sessionId?: string;
+}
+/**
+ * @description createConversationSearchSkill 팩토리 옵션
+ * @Todo vibecode - 소비 앱이 DB 검색 구현을 제공
+ */
+interface ConversationSearchSkillOptions {
+    /** 검색 구현 (호스트 DB 쿼리) */
+    onSearch: (query: string, options?: ConversationSearchOptions) => Promise<ConversationSnippet[]>;
+    /** 스킬 라벨 (기본: '대화 검색') */
+    label?: string;
+    /** 비활성화 여부 */
+    disabled?: boolean;
+}
 
 /**
  * @description ChatUI 메인 컴포넌트
@@ -2401,6 +2441,30 @@ declare const createAdvancedResearchSkill: (options: AdvancedResearchOptions) =>
  */
 declare const createDeepResearchSkill: (callbacks: DeepResearchCallbacks) => SkillConfig;
 
+/**
+ * @description 대화 검색 스킬 팩토리
+ * @Todo vibecode - 호스트 DB 검색을 SkillConfig로 래핑하여 LLM tool use로 과거 대화 검색
+ *
+ * 사용 예시:
+ * ```ts
+ * import { createConversationSearchSkill } from '@gendive/chatllm/react';
+ *
+ * const searchSkill = createConversationSearchSkill({
+ *   onSearch: async (query, options) => {
+ *     return await db.conversations.search(query, options?.limit);
+ *   },
+ * });
+ *
+ * <ChatUI skills={{ conversation_search: searchSkill }} />
+ * ```
+ */
+
+/**
+ * @description 대화 검색 스킬 생성 팩토리
+ * @Todo vibecode - LLM이 tool use로 과거 대화를 검색할 수 있는 스킬 생성
+ */
+declare const createConversationSearchSkill: (options: ConversationSearchSkillOptions) => SkillConfig;
+
 /**
  * @description Remix Icons wrapper component
  * @see https://remixicon.com/
@@ -3018,4 +3082,4 @@ declare const DEFAULT_PROJECT_TITLE = "\uAE30\uBCF8 \uD504\uB85C\uC81D\uD2B8";
  */
 declare const migrateSessionsToProjects: (storageKey: string) => void;
 
-export { type ActionItem, type ActionMenuProps, type AdvancedResearchOptions, type AlternativeResponse, ArtifactCard, type ArtifactCardProps, type ArtifactContentPart, type ChatAttachment, ChatFloatingWidget, type ChatFloatingWidgetProps, ChatHeader, ChatInput, type ChatMessage, type ChatProject, type ChatSession, ChatSidebar, type ChatToolDefinition, type ChatToolParameter, ChatUI, type ChatUIComponents, type ChatUIProps, type ChecklistBlock, ChecklistCard, type ChecklistCardProps, type ChecklistItem, ChecklistMiniIndicator, type ChecklistMiniIndicatorProps, ChecklistPanel, type ChecklistPanelProps, CompactChatView, type CompactChatViewProps, ContentPartRenderer, type ContentPartRendererProps, DEFAULT_PROJECT_ID, DEFAULT_PROJECT_TITLE, type DeepResearchCallbacks, type DeepResearchProgress, DeepResearchProgressUI, DevDiveAvatar, type DevDiveAvatarProps, DevDiveFabCharacter, type DevDiveFabCharacterProps, EmptyState, type EmptyStateProps, type ErrorContentPart, FileContentCard, type FileContentCardProps, type FileContentPart, FloatingFab, type FloatingFabProps, type FloatingNotification, FloatingPanel, type FloatingPanelProps, type FloatingPosition, FloatingTabBar, type FloatingTabBarProps, type FloatingTabItem, type FloatingWidgetTab, type HeaderProps, Icon, type IconName, type IconProps, IconSvg, ImageContentCard, type ImageContentCardProps, type ImageContentPart, type InputProps, LinkChip, type LinkChipProps, type ManualSkillItem, MarkdownRenderer, type MarkdownRendererProps, type MemoryItem, MemoryPanel, type MemoryPanelProps, MessageBubble, type MessageBubbleProps, type MessageContentPart, MessageList, type MessageListProps, type ModelConfig, type ModelSelectorProps, type OpenAITool, type PatternAnalysisResult, type PersonalizationConfig, type PollBlock, PollCard, type PollCardProps, type PollOption, type PollQuestion, type PollResponse, type PollState, type ProjectFile, ProjectSelector, type ProjectSelectorProps, ProjectSettingsModal, type ProjectSettingsModalProps, type PromptTemplate, type ProviderType, type ResizeEdge, ResizeHandles, type ResizeHandlesProps, type ResponseStyle, type SearchResult, type SearchResultContentPart, type SendMessageParams, type SendMessageResponse, type SendMessageResponseBase, type SendMessageResponseWithHeaders, type SessionContext, type SessionContextItem, SettingsModal, type SettingsModalProps, type SettingsTab, type SidebarProps, type SkillConfig, type SkillExecuteCallbacks, type SkillExecution, type SkillExecutionResult, type SkillProgress, SkillProgressUI, type SkillProgressUIProps, type SkillTrigger, type SourceItem, type SubAgentProgress, type SuggestedPrompt, type SystemPromptControl, type TextContentPart, type ThemeConfig, type ThemeMode, type ToolCallAccumulator, type ToolCallResult, type ToolLoadingContentPart, type ToolResultContentPart, type UseChatUIOptions, type UseChatUIReturn, type UseDeepResearchOptions, type UseDragResizeOptions, type UseDragResizeReturn, type UseFloatingWidgetOptions, type UseFloatingWidgetReturn, type UseObserverOptions, type UseObserverReturn, type UseProjectOptions, type UseProjectReturn, type UseSkillsOptions, type UseSkillsReturn, type UserProfile, type WorkflowSuggestion, convertSkillsToOpenAITools, convertToolsToSkills, createAdvancedResearchSkill, createDeepResearchSkill, migrateSessionsToProjects, useChatUI, useDeepResearch, useDragResize, useFloatingWidget, useObserver, useProject, useSkills };
+export { type ActionItem, type ActionMenuProps, type AdvancedResearchOptions, type AlternativeResponse, ArtifactCard, type ArtifactCardProps, type ArtifactContentPart, type ChatAttachment, ChatFloatingWidget, type ChatFloatingWidgetProps, ChatHeader, ChatInput, type ChatMessage, type ChatProject, type ChatSession, ChatSidebar, type ChatToolDefinition, type ChatToolParameter, ChatUI, type ChatUIComponents, type ChatUIProps, type ChecklistBlock, ChecklistCard, type ChecklistCardProps, type ChecklistItem, ChecklistMiniIndicator, type ChecklistMiniIndicatorProps, ChecklistPanel, type ChecklistPanelProps, CompactChatView, type CompactChatViewProps, ContentPartRenderer, type ContentPartRendererProps, type ConversationSearchOptions, type ConversationSearchSkillOptions, type ConversationSnippet, DEFAULT_PROJECT_ID, DEFAULT_PROJECT_TITLE, type DeepResearchCallbacks, type DeepResearchProgress, DeepResearchProgressUI, DevDiveAvatar, type DevDiveAvatarProps, DevDiveFabCharacter, type DevDiveFabCharacterProps, EmptyState, type EmptyStateProps, type ErrorContentPart, FileContentCard, type FileContentCardProps, type FileContentPart, FloatingFab, type FloatingFabProps, type FloatingNotification, FloatingPanel, type FloatingPanelProps, type FloatingPosition, FloatingTabBar, type FloatingTabBarProps, type FloatingTabItem, type FloatingWidgetTab, type HeaderProps, Icon, type IconName, type IconProps, IconSvg, ImageContentCard, type ImageContentCardProps, type ImageContentPart, type InputProps, LinkChip, type LinkChipProps, type ManualSkillItem, MarkdownRenderer, type MarkdownRendererProps, type MemoryItem, MemoryPanel, type MemoryPanelProps, MessageBubble, type MessageBubbleProps, type MessageContentPart, MessageList, type MessageListProps, type ModelConfig, type ModelSelectorProps, type OpenAITool, type PatternAnalysisResult, type PersonalizationConfig, type PollBlock, PollCard, type PollCardProps, type PollOption, type PollQuestion, type PollResponse, type PollState, type ProjectFile, ProjectSelector, type ProjectSelectorProps, ProjectSettingsModal, type ProjectSettingsModalProps, type PromptTemplate, type ProviderType, type ResizeEdge, ResizeHandles, type ResizeHandlesProps, type ResponseStyle, type SearchResult, type SearchResultContentPart, type SendMessageParams, type SendMessageResponse, type SendMessageResponseBase, type SendMessageResponseWithHeaders, type SessionContext, type SessionContextItem, SettingsModal, type SettingsModalProps, type SettingsTab, type SidebarProps, type SkillConfig, type SkillExecuteCallbacks, type SkillExecution, type SkillExecutionResult, type SkillProgress, SkillProgressUI, type SkillProgressUIProps, type SkillTrigger, type SourceItem, type SubAgentProgress, type SuggestedPrompt, type SystemPromptControl, type TextContentPart, type ThemeConfig, type ThemeMode, type ToolCallAccumulator, type ToolCallResult, type ToolLoadingContentPart, type ToolResultContentPart, type UseChatUIOptions, type UseChatUIReturn, type UseDeepResearchOptions, type UseDragResizeOptions, type UseDragResizeReturn, type UseFloatingWidgetOptions, type UseFloatingWidgetReturn, type UseObserverOptions, type UseObserverReturn, type UseProjectOptions, type UseProjectReturn, type UseSkillsOptions, type UseSkillsReturn, type UserProfile, type WorkflowSuggestion, convertSkillsToOpenAITools, convertToolsToSkills, createAdvancedResearchSkill, createConversationSearchSkill, createDeepResearchSkill, migrateSessionsToProjects, useChatUI, useDeepResearch, useDragResize, useFloatingWidget, useObserver, useProject, useSkills };

package/dist/react/index.d.ts

@@ -1819,6 +1819,46 @@ interface UseFloatingWidgetReturn {
     toggle: () => void;
     setTab: (tabKey: string) => void;
 }
+/**
+ * @description 대화 검색 결과 스니펫
+ * @Todo vibecode - DB에서 반환되는 과거 대화 조각
+ */
+interface ConversationSnippet {
+    /** 세션 ID */
+    sessionId: string;
+    /** 세션 제목 */
+    sessionTitle?: string;
+    /** 발화자 */
+    role: 'user' | 'assistant';
+    /** 메시지 내용 (또는 발췌) */
+    content: string;
+    /** 메시지 타임스탬프 */
+    timestamp?: number;
+    /** 검색 관련도 점수 (0-1) */
+    relevance?: number;
+}
+/**
+ * @description 대화 검색 옵션
+ * @Todo vibecode - 검색 범위 제한용
+ */
+interface ConversationSearchOptions {
+    /** 최대 결과 수 (기본: 5) */
+    limit?: number;
+    /** 특정 세션으로 제한 */
+    sessionId?: string;
+}
+/**
+ * @description createConversationSearchSkill 팩토리 옵션
+ * @Todo vibecode - 소비 앱이 DB 검색 구현을 제공
+ */
+interface ConversationSearchSkillOptions {
+    /** 검색 구현 (호스트 DB 쿼리) */
+    onSearch: (query: string, options?: ConversationSearchOptions) => Promise<ConversationSnippet[]>;
+    /** 스킬 라벨 (기본: '대화 검색') */
+    label?: string;
+    /** 비활성화 여부 */
+    disabled?: boolean;
+}
 
 /**
  * @description ChatUI 메인 컴포넌트
@@ -2401,6 +2441,30 @@ declare const createAdvancedResearchSkill: (options: AdvancedResearchOptions) =>
  */
 declare const createDeepResearchSkill: (callbacks: DeepResearchCallbacks) => SkillConfig;
 
+/**
+ * @description 대화 검색 스킬 팩토리
+ * @Todo vibecode - 호스트 DB 검색을 SkillConfig로 래핑하여 LLM tool use로 과거 대화 검색
+ *
+ * 사용 예시:
+ * ```ts
+ * import { createConversationSearchSkill } from '@gendive/chatllm/react';
+ *
+ * const searchSkill = createConversationSearchSkill({
+ *   onSearch: async (query, options) => {
+ *     return await db.conversations.search(query, options?.limit);
+ *   },
+ * });
+ *
+ * <ChatUI skills={{ conversation_search: searchSkill }} />
+ * ```
+ */
+
+/**
+ * @description 대화 검색 스킬 생성 팩토리
+ * @Todo vibecode - LLM이 tool use로 과거 대화를 검색할 수 있는 스킬 생성
+ */
+declare const createConversationSearchSkill: (options: ConversationSearchSkillOptions) => SkillConfig;
+
 /**
  * @description Remix Icons wrapper component
  * @see https://remixicon.com/
@@ -3018,4 +3082,4 @@ declare const DEFAULT_PROJECT_TITLE = "\uAE30\uBCF8 \uD504\uB85C\uC81D\uD2B8";
  */
 declare const migrateSessionsToProjects: (storageKey: string) => void;
 
-export { type ActionItem, type ActionMenuProps, type AdvancedResearchOptions, type AlternativeResponse, ArtifactCard, type ArtifactCardProps, type ArtifactContentPart, type ChatAttachment, ChatFloatingWidget, type ChatFloatingWidgetProps, ChatHeader, ChatInput, type ChatMessage, type ChatProject, type ChatSession, ChatSidebar, type ChatToolDefinition, type ChatToolParameter, ChatUI, type ChatUIComponents, type ChatUIProps, type ChecklistBlock, ChecklistCard, type ChecklistCardProps, type ChecklistItem, ChecklistMiniIndicator, type ChecklistMiniIndicatorProps, ChecklistPanel, type ChecklistPanelProps, CompactChatView, type CompactChatViewProps, ContentPartRenderer, type ContentPartRendererProps, DEFAULT_PROJECT_ID, DEFAULT_PROJECT_TITLE, type DeepResearchCallbacks, type DeepResearchProgress, DeepResearchProgressUI, DevDiveAvatar, type DevDiveAvatarProps, DevDiveFabCharacter, type DevDiveFabCharacterProps, EmptyState, type EmptyStateProps, type ErrorContentPart, FileContentCard, type FileContentCardProps, type FileContentPart, FloatingFab, type FloatingFabProps, type FloatingNotification, FloatingPanel, type FloatingPanelProps, type FloatingPosition, FloatingTabBar, type FloatingTabBarProps, type FloatingTabItem, type FloatingWidgetTab, type HeaderProps, Icon, type IconName, type IconProps, IconSvg, ImageContentCard, type ImageContentCardProps, type ImageContentPart, type InputProps, LinkChip, type LinkChipProps, type ManualSkillItem, MarkdownRenderer, type MarkdownRendererProps, type MemoryItem, MemoryPanel, type MemoryPanelProps, MessageBubble, type MessageBubbleProps, type MessageContentPart, MessageList, type MessageListProps, type ModelConfig, type ModelSelectorProps, type OpenAITool, type PatternAnalysisResult, type PersonalizationConfig, type PollBlock, PollCard, type PollCardProps, type PollOption, type PollQuestion, type PollResponse, type PollState, type ProjectFile, ProjectSelector, type ProjectSelectorProps, ProjectSettingsModal, type ProjectSettingsModalProps, type PromptTemplate, type ProviderType, type ResizeEdge, ResizeHandles, type ResizeHandlesProps, type ResponseStyle, type SearchResult, type SearchResultContentPart, type SendMessageParams, type SendMessageResponse, type SendMessageResponseBase, type SendMessageResponseWithHeaders, type SessionContext, type SessionContextItem, SettingsModal, type SettingsModalProps, type SettingsTab, type SidebarProps, type SkillConfig, type SkillExecuteCallbacks, type SkillExecution, type SkillExecutionResult, type SkillProgress, SkillProgressUI, type SkillProgressUIProps, type SkillTrigger, type SourceItem, type SubAgentProgress, type SuggestedPrompt, type SystemPromptControl, type TextContentPart, type ThemeConfig, type ThemeMode, type ToolCallAccumulator, type ToolCallResult, type ToolLoadingContentPart, type ToolResultContentPart, type UseChatUIOptions, type UseChatUIReturn, type UseDeepResearchOptions, type UseDragResizeOptions, type UseDragResizeReturn, type UseFloatingWidgetOptions, type UseFloatingWidgetReturn, type UseObserverOptions, type UseObserverReturn, type UseProjectOptions, type UseProjectReturn, type UseSkillsOptions, type UseSkillsReturn, type UserProfile, type WorkflowSuggestion, convertSkillsToOpenAITools, convertToolsToSkills, createAdvancedResearchSkill, createDeepResearchSkill, migrateSessionsToProjects, useChatUI, useDeepResearch, useDragResize, useFloatingWidget, useObserver, useProject, useSkills };
+export { type ActionItem, type ActionMenuProps, type AdvancedResearchOptions, type AlternativeResponse, ArtifactCard, type ArtifactCardProps, type ArtifactContentPart, type ChatAttachment, ChatFloatingWidget, type ChatFloatingWidgetProps, ChatHeader, ChatInput, type ChatMessage, type ChatProject, type ChatSession, ChatSidebar, type ChatToolDefinition, type ChatToolParameter, ChatUI, type ChatUIComponents, type ChatUIProps, type ChecklistBlock, ChecklistCard, type ChecklistCardProps, type ChecklistItem, ChecklistMiniIndicator, type ChecklistMiniIndicatorProps, ChecklistPanel, type ChecklistPanelProps, CompactChatView, type CompactChatViewProps, ContentPartRenderer, type ContentPartRendererProps, type ConversationSearchOptions, type ConversationSearchSkillOptions, type ConversationSnippet, DEFAULT_PROJECT_ID, DEFAULT_PROJECT_TITLE, type DeepResearchCallbacks, type DeepResearchProgress, DeepResearchProgressUI, DevDiveAvatar, type DevDiveAvatarProps, DevDiveFabCharacter, type DevDiveFabCharacterProps, EmptyState, type EmptyStateProps, type ErrorContentPart, FileContentCard, type FileContentCardProps, type FileContentPart, FloatingFab, type FloatingFabProps, type FloatingNotification, FloatingPanel, type FloatingPanelProps, type FloatingPosition, FloatingTabBar, type FloatingTabBarProps, type FloatingTabItem, type FloatingWidgetTab, type HeaderProps, Icon, type IconName, type IconProps, IconSvg, ImageContentCard, type ImageContentCardProps, type ImageContentPart, type InputProps, LinkChip, type LinkChipProps, type ManualSkillItem, MarkdownRenderer, type MarkdownRendererProps, type MemoryItem, MemoryPanel, type MemoryPanelProps, MessageBubble, type MessageBubbleProps, type MessageContentPart, MessageList, type MessageListProps, type ModelConfig, type ModelSelectorProps, type OpenAITool, type PatternAnalysisResult, type PersonalizationConfig, type PollBlock, PollCard, type PollCardProps, type PollOption, type PollQuestion, type PollResponse, type PollState, type ProjectFile, ProjectSelector, type ProjectSelectorProps, ProjectSettingsModal, type ProjectSettingsModalProps, type PromptTemplate, type ProviderType, type ResizeEdge, ResizeHandles, type ResizeHandlesProps, type ResponseStyle, type SearchResult, type SearchResultContentPart, type SendMessageParams, type SendMessageResponse, type SendMessageResponseBase, type SendMessageResponseWithHeaders, type SessionContext, type SessionContextItem, SettingsModal, type SettingsModalProps, type SettingsTab, type SidebarProps, type SkillConfig, type SkillExecuteCallbacks, type SkillExecution, type SkillExecutionResult, type SkillProgress, SkillProgressUI, type SkillProgressUIProps, type SkillTrigger, type SourceItem, type SubAgentProgress, type SuggestedPrompt, type SystemPromptControl, type TextContentPart, type ThemeConfig, type ThemeMode, type ToolCallAccumulator, type ToolCallResult, type ToolLoadingContentPart, type ToolResultContentPart, type UseChatUIOptions, type UseChatUIReturn, type UseDeepResearchOptions, type UseDragResizeOptions, type UseDragResizeReturn, type UseFloatingWidgetOptions, type UseFloatingWidgetReturn, type UseObserverOptions, type UseObserverReturn, type UseProjectOptions, type UseProjectReturn, type UseSkillsOptions, type UseSkillsReturn, type UserProfile, type WorkflowSuggestion, convertSkillsToOpenAITools, convertToolsToSkills, createAdvancedResearchSkill, createConversationSearchSkill, createDeepResearchSkill, migrateSessionsToProjects, useChatUI, useDeepResearch, useDragResize, useFloatingWidget, useObserver, useProject, useSkills };

package/dist/react/index.js

@@ -68,6 +68,7 @@ __export(index_exports, {
   convertSkillsToOpenAITools: () => convertSkillsToOpenAITools,
   convertToolsToSkills: () => convertToolsToSkills,
   createAdvancedResearchSkill: () => createAdvancedResearchSkill,
+  createConversationSearchSkill: () => createConversationSearchSkill,
   createDeepResearchSkill: () => createDeepResearchSkill,
   migrateSessionsToProjects: () => migrateSessionsToProjects,
   useChatUI: () => useChatUI,
@@ -2843,6 +2844,11 @@ ${projectMemoryContext}`);
 - \uB370\uC774\uD130 \uBE44\uAD50/\uCD94\uC774 \u2192 html (Chart.js CDN \uC0AC\uC6A9, <artifact> \uD0DC\uADF8)
 - \uC544\uC774\uCF58/\uB85C\uACE0/\uC77C\uB7EC\uC2A4\uD2B8 \u2192 svg
 
+**mermaid \uC8FC\uC758\uC0AC\uD56D:**
+- \uB178\uB4DC \uB77C\uBCA8\uC5D0 \uAD04\uD638 () \uC0AC\uC6A9 \uAE08\uC9C0 \u2192 \uB300\uAD04\uD638 [] \uC0AC\uC6A9: B[\uC0C1\uD0DC \uAD00\uB9AC useState] \u2705 B[\uC0C1\uD0DC \uAD00\uB9AC (useState)] \u274C
+- \uB178\uB4DC \uB77C\uBCA8\uC5D0 \uD2B9\uC218\uBB38\uC790\uAC00 \uC788\uC73C\uBA74 \uD070\uB530\uC634\uD45C\uB85C \uAC10\uC2F8\uAE30: B["API \uD638\uCD9C \u2192 \uC751\uB2F5"]
+- \uC18C\uAD04\uD638 ()\uB294 mermaid \uBB38\uBC95\uC5D0\uC11C \uB465\uADFC \uB178\uB4DC\uB97C \uC758\uBBF8\uD558\uBBC0\uB85C \uB77C\uBCA8 \uD14D\uC2A4\uD2B8\uC5D0 \uC808\uB300 \uD3EC\uD568\uD558\uC9C0 \uB9C8\uC138\uC694
+
 **mermaid \uC608\uC2DC:**
 \`\`\`mermaid
 graph TD
@@ -2867,7 +2873,7 @@ new Chart(document.getElementById('chart'), {
 - html \uC2DC\uAC01\uD654\uB294 \uBC18\uB4DC\uC2DC <artifact language="html"> \uD0DC\uADF8\uB85C \uAC10\uC2F8\uC57C \uD568 (\`\`\`html \uCF54\uB4DC\uBE14\uB85D \uC0AC\uC6A9 \uAE08\uC9C0)
 - \uC0AC\uC6A9\uC790\uAC00 \uC2DC\uAC01\uD654\uB97C \uC694\uCCAD\uD558\uC9C0 \uC54A\uC544\uB3C4 \uC801\uC808\uD558\uBA74 \uC790\uB3D9\uC73C\uB85C \uD3EC\uD568
 - \uC2DC\uAC01\uD654 \uC55E\uB4A4\uC5D0 \uAC04\uACB0\uD55C \uD14D\uC2A4\uD2B8 \uC124\uBA85 \uD3EC\uD568
-- mermaid \uBB38\uBC95 \uC624\uB958 \uC8FC\uC758 (\uD2B9\uD788 \uAD04\uD638, \uB530\uC634\uD45C \uC774\uC2A4\uCF00\uC774\uD504)`);
+- mermaid \uB178\uB4DC \uB77C\uBCA8\uC5D0 \uC18C\uAD04\uD638 () \uC808\uB300 \uC0AC\uC6A9 \uAE08\uC9C0 \u2014 \uD30C\uC2F1 \uC5D0\uB7EC \uC6D0\uC778`);
     if (shouldIncludeSkills) {
       const skillsPrompt = buildSkillsPrompt();
       if (skillsPrompt) {
@@ -3200,18 +3206,29 @@ ${newConversation}
       setIsSessionLoading(true);
       try {
         const sessionDetail = await onLoadSessionRef.current(id);
-        let loadedMessages = sessionDetail.messages.map((m, idx) => ({
-          id: m.id || generateId5("msg"),
-          role: typeof m.role === "string" ? m.role.toLowerCase() : m.role,
-          // API는 message 필드, 내부는 content 필드 사용
-          content: m.content || m.message || "",
-          timestamp: m.created_at ? new Date(m.created_at).getTime() : Date.now() - (sessionDetail.messages.length - idx) * 1e3,
-          model: m.model,
-          alternatives: m.alternatives,
-          sources: m.sources,
-          /** @Todo vibecode - 백엔드에서 전달받은 contentParts 복원 (이미지/파일 등) */
-          ...m.contentParts && { contentParts: m.contentParts }
-        }));
+        let loadedMessages = sessionDetail.messages.map((m, idx) => {
+          const msg = {
+            id: m.id || generateId5("msg"),
+            role: typeof m.role === "string" ? m.role.toLowerCase() : m.role,
+            // API는 message 필드, 내부는 content 필드 사용
+            content: m.content || m.message || "",
+            timestamp: m.created_at ? new Date(m.created_at).getTime() : Date.now() - (sessionDetail.messages.length - idx) * 1e3,
+            model: m.model,
+            alternatives: m.alternatives,
+            sources: m.sources,
+            /** @Todo vibecode - 백엔드에서 전달받은 contentParts 복원 (이미지/파일 등) */
+            ...m.contentParts && { contentParts: m.contentParts }
+          };
+          if (!msg.contentParts && msg.role === "assistant" && hasArtifactTag(msg.content)) {
+            const { artifacts, cleanContent } = parseArtifactsFromContent(msg.content);
+            if (artifacts.length > 0) {
+              const textPart = cleanContent.trim() ? [{ type: "text", content: cleanContent }] : [];
+              msg.content = cleanContent;
+              msg.contentParts = [...textPart, ...artifacts];
+            }
+          }
+          return msg;
+        });
         let resolvedTitle = sessionDetail.title;
         let resolvedSessionContext = sessionDetail.sessionContext;
         if (loadedMessages.length === 0) {
@@ -3586,13 +3603,17 @@ ${finalContent}`;
       for (const [skillName, skillConfig] of attachmentSkills) {
         let matchedFiles = currentAttachments.filter((att) => {
           if (!skillConfig.acceptedTypes || skillConfig.acceptedTypes.length === 0) return true;
+          const fileName = (att.name || "").toLowerCase();
+          const fileMime = (att.mimeType || "").toLowerCase();
+          const fileExt = fileName.includes(".") ? fileName.slice(fileName.lastIndexOf(".")) : "";
           return skillConfig.acceptedTypes.some((type) => {
-            if (type.startsWith(".")) return att.name.toLowerCase().endsWith(type.toLowerCase());
-            if (type.includes("*")) {
-              const regex = new RegExp("^" + type.replace("*", ".*") + "$");
-              return regex.test(att.mimeType);
+            const t = type.toLowerCase();
+            if (t.startsWith(".")) return fileExt === t || fileName.endsWith(t);
+            if (t.includes("*")) {
+              const regex = new RegExp("^" + t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace("\\*", ".*") + "$");
+              return regex.test(fileMime);
             }
-            return att.mimeType === type;
+            return fileMime === t;
           });
         });
         if (skipImageAttachmentSkill) {
@@ -4047,25 +4068,26 @@ ${attachmentContext}
           }
         }
       }
-      const saveMessagesOnEarlyReturn = () => {
+      const saveMessagesOnEarlyReturn = (overrideContentParts) => {
         if (!useExternalStorage || !capturedSessionId) return;
-        queueMicrotask(() => {
+        setTimeout(() => {
           const latestSession = sessionsRef.current.find((s) => s.id === capturedSessionId);
           if (!latestSession) return;
           const latestMessages = latestSession.messages;
           const assistantMsg = [...latestMessages].reverse().find((m) => m.role === "assistant");
           const userMsg = latestMessages.find((m) => m.role === "user" && m.content === finalContent);
           const assistantContent = assistantMsg?.content || "";
-          if (assistantContent && onSaveMessagesRef.current) {
+          const finalContentParts = overrideContentParts || assistantMsg?.contentParts;
+          if ((assistantContent || finalContentParts) && onSaveMessagesRef.current) {
             onSaveMessagesRef.current(capturedSessionId, [
               { role: "user", message: finalContent, ...userMsg?.contentParts && { contentParts: userMsg.contentParts } },
-              { role: "assistant", message: assistantContent, ...assistantMsg?.contentParts && { contentParts: assistantMsg.contentParts } }
+              { role: "assistant", message: assistantContent, ...finalContentParts && { contentParts: finalContentParts } }
             ]).catch((e) => console.error("[useChatUI] Failed to save messages:", e));
           }
           if (latestSession.messages.length > 0) {
             writeSessionCache(storageKey, latestSession);
           }
-        });
+        }, 0);
       };
       if (!shouldSkipSkillParsing) {
         const assistantContent = accumulatedContent;
@@ -4255,7 +4277,7 @@ ${attachmentContext}
                   promoteToSessionContext(capturedSessionId, toolName, result.content, result.metadata, toolLabel || toolName);
                 }
                 if (resultType === "image" || resultType === "file") {
-                  saveMessagesOnEarlyReturn();
+                  saveMessagesOnEarlyReturn(parts);
                   removeLoadingSession(capturedSessionId);
                   abortControllersRef.current.delete(capturedSessionId);
                   return;
@@ -4266,7 +4288,7 @@ ${attachmentContext}
                   shouldContinue = decision === "continue";
                 }
                 if (!shouldContinue) {
-                  saveMessagesOnEarlyReturn();
+                  saveMessagesOnEarlyReturn(parts);
                   removeLoadingSession(capturedSessionId);
                   abortControllersRef.current.delete(capturedSessionId);
                   return;
@@ -4341,13 +4363,13 @@ ${result.content}
                   shouldContinueImgFile = decision === "continue";
                 }
                 if (!shouldContinueImgFile) {
-                  saveMessagesOnEarlyReturn();
+                  saveMessagesOnEarlyReturn(imgFileParts);
                   removeLoadingSession(capturedSessionId);
                   abortControllersRef.current.delete(capturedSessionId);
                   return;
                 }
                 skipNextSkillParsingRef.current = true;
-                saveMessagesOnEarlyReturn();
+                saveMessagesOnEarlyReturn(imgFileParts);
                 const imgFilePrompt = skillResultType === "image" ? `"${detectedSkill.name}" \uC2A4\uD0AC\uB85C \uC774\uBBF8\uC9C0\uAC00 \uC0DD\uC131\uB418\uC5B4 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD45C\uC2DC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC774\uBBF8\uC9C0 URL\uC744 \uD14D\uC2A4\uD2B8\uC5D0 \uD3EC\uD568\uD558\uC9C0 \uB9D0\uACE0, \uC0DD\uC131\uB41C \uC774\uBBF8\uC9C0\uC5D0 \uB300\uD574 \uAC04\uB2E8\uD788 \uC548\uB0B4\uD574\uC8FC\uC138\uC694. skill_use \uD0DC\uADF8\uB294 \uC0AC\uC6A9\uD558\uC9C0 \uB9C8\uC138\uC694.` : `"${detectedSkill.name}" \uC2A4\uD0AC\uB85C \uD30C\uC77C\uC774 \uC0DD\uC131\uB418\uC5B4 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD45C\uC2DC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uD30C\uC77C URL\uC744 \uD14D\uC2A4\uD2B8\uC5D0 \uD3EC\uD568\uD558\uC9C0 \uB9D0\uACE0, \uACB0\uACFC\uC5D0 \uB300\uD574 \uAC04\uB2E8\uD788 \uC548\uB0B4\uD574\uC8FC\uC138\uC694. skill_use \uD0DC\uADF8\uB294 \uC0AC\uC6A9\uD558\uC9C0 \uB9C8\uC138\uC694.`;
                 setTimeout(() => {
                   sendMessage(imgFilePrompt, { hiddenUserMessage: true });
@@ -10285,9 +10307,39 @@ var MermaidArtifact = ({ code }) => {
     }
   );
 };
-var ArtifactActions = ({ code, language }) => {
+var svgToPngBlob = (svgString, scale = 2) => {
+  return new Promise((resolve) => {
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(svgString, "image/svg+xml");
+    const svgEl = doc.querySelector("svg");
+    if (!svgEl) return resolve(null);
+    const w = parseInt(svgEl.getAttribute("width") || "800", 10);
+    const h = parseInt(svgEl.getAttribute("height") || "600", 10);
+    const canvas = document.createElement("canvas");
+    canvas.width = w * scale;
+    canvas.height = h * scale;
+    const ctx = canvas.getContext("2d");
+    if (!ctx) return resolve(null);
+    ctx.scale(scale, scale);
+    const blob = new Blob([new XMLSerializer().serializeToString(svgEl)], { type: "image/svg+xml;charset=utf-8" });
+    const url = URL.createObjectURL(blob);
+    const img = new Image();
+    img.onload = () => {
+      ctx.drawImage(img, 0, 0, w, h);
+      URL.revokeObjectURL(url);
+      canvas.toBlob((pngBlob) => resolve(pngBlob), "image/png");
+    };
+    img.onerror = () => {
+      URL.revokeObjectURL(url);
+      resolve(null);
+    };
+    img.src = url;
+  });
+};
+var ArtifactActions = ({ code, language, containerRef }) => {
   const [showCode, setShowCode] = (0, import_react17.useState)(false);
   const [copied, setCopied] = (0, import_react17.useState)(false);
+  const [saving, setSaving] = (0, import_react17.useState)(false);
   const handleCopy = async () => {
     try {
       await navigator.clipboard.writeText(code);
@@ -10296,6 +10348,39 @@ var ArtifactActions = ({ code, language }) => {
     } catch {
     }
   };
+  const handleSaveImage = async () => {
+    setSaving(true);
+    try {
+      let blob = null;
+      if (language === "svg" || language === "mermaid") {
+        const svgEl = containerRef?.current?.querySelector("svg");
+        if (svgEl) {
+          blob = await svgToPngBlob(svgEl.outerHTML);
+        }
+      } else if (language === "html") {
+        const htmlBlob = new Blob([code], { type: "text/html;charset=utf-8" });
+        const url = URL.createObjectURL(htmlBlob);
+        const a = document.createElement("a");
+        a.href = url;
+        a.download = `artifact.html`;
+        a.click();
+        URL.revokeObjectURL(url);
+        setSaving(false);
+        return;
+      }
+      if (blob) {
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement("a");
+        a.href = url;
+        a.download = `artifact.png`;
+        a.click();
+        URL.revokeObjectURL(url);
+      }
+    } catch {
+    } finally {
+      setSaving(false);
+    }
+  };
   const langLabel = language === "mermaid" ? "Mermaid" : language === "svg" ? "SVG" : "HTML";
   return /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("div", { children: [
     /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(
@@ -10361,6 +10446,30 @@ var ArtifactActions = ({ code, language }) => {
                 copied ? "\uBCF5\uC0AC\uB428" : "\uBCF5\uC0AC"
               ]
             }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(
+            "button",
+            {
+              onClick: handleSaveImage,
+              disabled: saving,
+              style: {
+                display: "flex",
+                alignItems: "center",
+                gap: "4px",
+                padding: "4px 8px",
+                fontSize: "12px",
+                color: "var(--chatllm-text-muted, #64748b)",
+                backgroundColor: "transparent",
+                border: "none",
+                borderRadius: "4px",
+                cursor: saving ? "wait" : "pointer",
+                opacity: saving ? 0.5 : 1
+              },
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(IconSvg, { name: "download-line", size: 12, color: "var(--chatllm-text-muted, #64748b)" }),
+                language === "html" ? "HTML \uC800\uC7A5" : "\uC774\uBBF8\uC9C0 \uC800\uC7A5"
+              ]
+            }
           )
         ]
       }
@@ -10395,6 +10504,7 @@ var ArtifactActions = ({ code, language }) => {
   ] });
 };
 var ArtifactCard = ({ part, index = 0 }) => {
+  const contentRef = (0, import_react17.useRef)(null);
   return /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(
     "div",
     {
@@ -10434,12 +10544,12 @@ var ArtifactCard = ({ part, index = 0 }) => {
             ]
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("div", { style: { padding: part.language === "html" ? 0 : "12px" }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)("div", { ref: contentRef, style: { padding: part.language === "html" ? 0 : "12px" }, children: [
           part.language === "html" && /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(HtmlArtifact, { code: part.code }),
           part.language === "svg" && /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(SvgArtifact, { code: part.code }),
           part.language === "mermaid" && /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(MermaidArtifact, { code: part.code })
         ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(ArtifactActions, { code: part.code, language: part.language })
+        /* @__PURE__ */ (0, import_jsx_runtime14.jsx)(ArtifactActions, { code: part.code, language: part.language, containerRef: contentRef })
       ]
     }
   );
@@ -15278,6 +15388,7 @@ var useDragResize = (options) => {
   const dragStartRef = (0, import_react24.useRef)(null);
   const isDraggingRef = (0, import_react24.useRef)(false);
   const wasDragRef = (0, import_react24.useRef)(false);
+  const userDraggedRef = (0, import_react24.useRef)(false);
   const dragDeltaRef = (0, import_react24.useRef)({ dx: 0, dy: 0 });
   const fabElRef = (0, import_react24.useRef)(null);
   const dragCleanupRef = (0, import_react24.useRef)(null);
@@ -15344,6 +15455,7 @@ var useDragResize = (options) => {
       if (!isDraggingRef.current && distance > DRAG_THRESHOLD) {
         isDraggingRef.current = true;
         wasDragRef.current = true;
+        userDraggedRef.current = true;
         setIsDragging(true);
         fabElRef.current?.classList.add("chatllm-fab-dragging");
       }
@@ -15583,7 +15695,11 @@ var useDragResize = (options) => {
       const newVw = window.innerWidth;
       const newVh = window.innerHeight;
       setViewport({ width: newVw, height: newVh });
-      setFabPos((prev) => clampToViewport(prev.x, prev.y, newVw, newVh));
+      if (!userDraggedRef.current) {
+        setFabPos(getInitialFabPosition(initialPosition));
+      } else {
+        setFabPos((prev) => clampToViewport(prev.x, prev.y, newVw, newVh));
+      }
     };
     window.addEventListener("resize", handleResize);
     return () => window.removeEventListener("resize", handleResize);
@@ -17183,23 +17299,39 @@ var ChatFloatingWidget = ({
     return [chatTab, ...customTabs];
   }, [tabs]);
   const [unreadBadge, setUnreadBadge] = (0, import_react31.useState)(0);
-  const seenMessageIdsRef = (0, import_react31.useRef)(new Set(chatState.messages.map((m) => m.id)));
+  const seenMessageIdsRef = (0, import_react31.useRef)(/* @__PURE__ */ new Set());
+  (0, import_react31.useEffect)(() => {
+    if (seenMessageIdsRef.current.size === 0 && chatState.messages.length > 0) {
+      for (const m of chatState.messages) {
+        seenMessageIdsRef.current.add(m.id);
+      }
+    }
+  }, [chatState.messages]);
   (0, import_react31.useEffect)(() => {
-    if (!isOpen) {
+    if (isOpen) {
+      for (const m of chatState.messages) {
+        seenMessageIdsRef.current.add(m.id);
+      }
+    } else {
       const newAssistant = chatState.messages.filter(
         (m) => m.role === "assistant" && !seenMessageIdsRef.current.has(m.id)
       );
       if (newAssistant.length > 0) {
         setUnreadBadge((prev) => prev + newAssistant.length);
+        for (const m of newAssistant) {
+          seenMessageIdsRef.current.add(m.id);
+        }
       }
     }
-    for (const m of chatState.messages) {
-      seenMessageIdsRef.current.add(m.id);
-    }
   }, [chatState.messages, isOpen]);
   (0, import_react31.useEffect)(() => {
-    if (isOpen) setUnreadBadge(0);
-  }, [isOpen]);
+    if (isOpen) {
+      setUnreadBadge(0);
+      for (const m of chatState.messages) {
+        seenMessageIdsRef.current.add(m.id);
+      }
+    }
+  }, [isOpen, chatState.messages]);
   const totalBadge = (0, import_react31.useMemo)(() => {
     return tabs.reduce((sum, t) => sum + (t.badge || 0), 0) + unreadBadge;
   }, [tabs, unreadBadge]);
@@ -17635,6 +17767,57 @@ var useDeepResearch = (options) => {
   };
 };
 
+// src/react/utils/conversationSearchAdapter.ts
+var formatSearchResults = (results) => {
+  if (results.length === 0) {
+    return "\uAD00\uB828 \uB300\uD654\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.";
+  }
+  const formatted = results.map((r, i) => {
+    const header = r.sessionTitle ? `[${r.sessionTitle}]` : "";
+    const time = r.timestamp ? ` (${new Date(r.timestamp).toLocaleDateString("ko-KR")})` : "";
+    return `[${i + 1}] ${header}${time} (${r.role}): ${r.content}`;
+  }).join("\n\n");
+  return `\uAC80\uC0C9 \uACB0\uACFC (${results.length}\uAC74):
+
+${formatted}`;
+};
+var createConversationSearchSkill = (options) => {
+  const { onSearch, label, disabled } = options;
+  return {
+    description: '\uC774\uC804 \uB300\uD654 \uB0B4\uC6A9\uC744 \uAC80\uC0C9\uD569\uB2C8\uB2E4. \uBC18\uB4DC\uC2DC \uD638\uCD9C\uD574\uC57C \uD558\uB294 \uC0C1\uD669: \uC0AC\uC6A9\uC790\uAC00 "\uC804\uC5D0", "\uC9C0\uB09C\uBC88\uC5D0", "\uC608\uC804\uC5D0", "\uC544\uAE4C", "\uC774\uC804\uC5D0", "\uB2E4\uC2DC \uC54C\uB824\uC918", "\uB610", "\uADF8\uB54C" \uB4F1 \uACFC\uAC70 \uB300\uD654\uB97C \uCC38\uC870\uD558\uB294 \uD45C\uD604\uC744 \uC0AC\uC6A9\uD560 \uB54C. \uACFC\uAC70\uC5D0 \uB17C\uC758\uD588\uB358 \uC8FC\uC81C\uB97C \uB2E4\uC2DC \uBB3C\uC5B4\uBCFC \uB54C\uB3C4 \uD638\uCD9C\uD558\uC138\uC694.',
+    trigger: "auto",
+    label: label || "\uB300\uD654 \uAC80\uC0C9",
+    icon: "search-line",
+    disabled,
+    persist: false,
+    parameters: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC \uB610\uB294 \uBB38\uC7A5 (\uC0AC\uC6A9\uC790 \uC758\uB3C4\uB97C \uBC18\uC601\uD55C \uAC80\uC0C9\uC5B4)"
+        },
+        limit: {
+          type: "number",
+          description: "\uCD5C\uB300 \uACB0\uACFC \uC218 (\uAE30\uBCF8: 5)"
+        }
+      },
+      required: ["query"]
+    },
+    execute: async (params) => {
+      const { query, limit } = params;
+      if (!query) {
+        return { content: "\uAC80\uC0C9\uC5B4\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4." };
+      }
+      const results = await onSearch(query, { limit: limit || 5 });
+      return {
+        content: formatSearchResults(results),
+        metadata: { resultCount: results.length }
+      };
+    }
+  };
+};
+
 // src/react/components/EmptyState.tsx
 var import_jsx_runtime32 = require("react/jsx-runtime");
 var EmptyState = ({
@@ -18151,6 +18334,7 @@ var MemoryPanel = ({
   convertSkillsToOpenAITools,
   convertToolsToSkills,
   createAdvancedResearchSkill,
+  createConversationSearchSkill,
   createDeepResearchSkill,
   migrateSessionsToProjects,
   useChatUI,