@gendive/chatllm 0.15.4 → 0.16.0

package/dist/react/index.d.mts

@@ -75,6 +75,11 @@ interface MarkdownRendererProps {
      * @Todo vibecode - true면 펼쳐진 상태로 표시 (기본: false)
      */
     thinkingDefaultOpen?: boolean;
+    /**
+     * @description 인라인 소스 참조용 출처 목록
+     * @Todo vibecode - [1], [2] 패턴을 소스 URL 링크로 변환
+     */
+    sources?: SourceItem[];
 }
 declare const MarkdownRenderer: React$1.FC<MarkdownRendererProps>;
 
@@ -302,6 +307,10 @@ interface ToolResultContentPart {
     type: 'tool_result';
     toolName: string;
     result: ToolCallResult;
+    /** @Todo vibecode - UI 표시용 레이블 (예: '웹 검색', '이미지 생성') */
+    label?: string;
+    /** @Todo vibecode - UI 표시용 아이콘 (예: 'search', 'image') */
+    icon?: string;
 }
 /** @Todo vibecode - 에러 콘텐츠 파트 */
 interface ErrorContentPart {
@@ -315,6 +324,41 @@ interface ToolCallResult {
     type: 'text' | 'image' | 'file' | 'error';
     content: string;
     metadata?: Record<string, any>;
+    /** @Todo vibecode - 도구 결과에 포함된 출처 목록 (웹 검색 등) */
+    sources?: SourceItem[];
+}
+/**
+ * @description 프로젝트 파일 메타데이터 (실제 파일 저장은 호스트 앱에 위임)
+ * @Todo vibecode - 프로젝트 컨텍스트 파일 관리
+ */
+interface ProjectFile {
+    id: string;
+    name: string;
+    type: 'image' | 'pdf' | 'text' | 'code' | 'other';
+    url: string;
+    size?: number;
+    mimeType?: string;
+    description?: string;
+    uploadedAt: number;
+}
+/**
+ * @description 채팅 프로젝트 - 세션을 그룹화하는 작업 단위
+ * @Todo vibecode - 프로젝트별 지침, 파일 메타데이터, 메모리 스코프 관리
+ */
+interface ChatProject {
+    id: string;
+    title: string;
+    description?: string;
+    /** 프로젝트별 시스템 프롬프트 (세션 프롬프트에 자동 주입) */
+    instructions?: string;
+    /** 파일 메타데이터 목록 */
+    files: ProjectFile[];
+    createdAt: number;
+    updatedAt: number;
+    /** UI 표시용 색상 */
+    color?: string;
+    /** UI 표시용 아이콘 */
+    icon?: string;
 }
 /** @Todo vibecode - 채팅 입력 파일 첨부 */
 interface ChatAttachment {
@@ -395,6 +439,11 @@ interface ChatSession {
     summaryAfterIndex?: number;
     /** 압축 상태 (점진적 압축용) */
     compressionState?: CompressionState;
+    /**
+     * @description 소속 프로젝트 ID (enableProjects 시 할당)
+     * @Todo vibecode - optional로 하위호환성 유지, 런타임에서는 항상 할당
+     */
+    projectId?: string;
 }
 interface ActionItem {
     id: string;
@@ -519,7 +568,7 @@ interface PromptTemplate {
     category: string;
     icon?: string;
 }
-type SettingsTab = 'general' | 'personalization' | 'data' | 'memory' | 'api';
+type SettingsTab = 'general' | 'personalization' | 'data' | 'memory' | 'project-memory' | 'api';
 type ThemeMode = 'light' | 'dark' | 'system';
 interface ThemeConfig {
     mode: ThemeMode;
@@ -557,6 +606,10 @@ interface ChatUIProps {
     showSidebar?: boolean;
     /** @Todo vibecode - 사이드바 너비 (기본: 288px) */
     sidebarWidth?: number | string;
+    /** @Todo vibecode - 새 채팅 버튼 아래, 세션 목록 위에 커스텀 콘텐츠 렌더링 */
+    sidebarRenderAfterHeader?: () => React.ReactNode;
+    /** @Todo vibecode - 세션 목록 아래, 사이드바 하단에 커스텀 콘텐츠 렌더링 */
+    sidebarRenderFooter?: () => React.ReactNode;
     /** 설정 버튼 표시 여부 */
     showSettings?: boolean;
     /** 모델 선택기 표시 여부 */
@@ -632,6 +685,8 @@ interface ChatUIProps {
             role: 'USER' | 'ASSISTANT' | 'user' | 'assistant';
             message?: string;
             content?: string;
+            /** @Todo vibecode - 멀티 콘텐츠 파트 (이미지/파일 등 복원용) */
+            contentParts?: MessageContentPart[];
             created_at?: string;
         }>;
         memory_data?: object;
@@ -653,6 +708,7 @@ interface ChatUIProps {
     onSaveMessages?: (sessionId: string, messages: {
         role: 'user' | 'assistant';
         message: string;
+        contentParts?: MessageContentPart[];
     }[]) => Promise<void>;
     /**
      * @description Thinking 블록 표시 여부
@@ -685,6 +741,52 @@ interface ChatUIProps {
      * @Todo vibecode - 라이브러리가 도구 호출 판단 후 호스트에 실행 위임
      */
     onToolCall?: (name: string, params: Record<string, unknown>) => Promise<ToolCallResult>;
+    /**
+     * @description 프로젝트 기능 활성화 여부 (기본: false)
+     * @Todo vibecode - true 시 프로젝트 그룹핑, 지침, 메모리 계층 활성화
+     */
+    enableProjects?: boolean;
+    /**
+     * @description 프로젝트 목록 로드 콜백
+     * @Todo vibecode - 외부 스토리지 사용 시 컴포넌트 마운트 시 호출
+     */
+    onLoadProjects?: () => Promise<{
+        id: string;
+        title: string;
+    }[]>;
+    /**
+     * @description 프로젝트 생성 콜백
+     * @Todo vibecode - 새 프로젝트 생성 시 호출
+     */
+    onCreateProject?: (data: Partial<ChatProject>) => Promise<{
+        id: string;
+        title: string;
+    }>;
+    /**
+     * @description 프로젝트 상세 로드 콜백 (lazy loading)
+     * @Todo vibecode - 프로젝트 선택 시 호출
+     */
+    onLoadProject?: (projectId: string) => Promise<ChatProject>;
+    /**
+     * @description 프로젝트 수정 콜백
+     * @Todo vibecode - 프로젝트 정보 수정 시 호출
+     */
+    onUpdateProject?: (projectId: string, data: Partial<ChatProject>) => Promise<void>;
+    /**
+     * @description 프로젝트 삭제 콜백
+     * @Todo vibecode - 프로젝트 삭제 시 소속 세션도 함께 삭제
+     */
+    onDeleteProject?: (projectId: string) => Promise<void>;
+    /**
+     * @description 프로젝트 파일 추가 콜백 (호스트가 업로드 처리 후 메타데이터 반환)
+     * @Todo vibecode - 파일 저장은 호스트에 위임
+     */
+    onAddProjectFile?: (projectId: string, file: File) => Promise<ProjectFile>;
+    /**
+     * @description 프로젝트 파일 삭제 콜백
+     * @Todo vibecode - 파일 삭제 시 호출
+     */
+    onDeleteProjectFile?: (projectId: string, fileId: string) => Promise<void>;
 }
 interface SendMessageParams {
     messages: {
@@ -735,6 +837,23 @@ interface SidebarProps {
     width?: number | string;
     /** @Todo vibecode - 테마 모드 (chatllm-root 밖에서 사용 시 CSS 변수 직접 적용) */
     theme?: ThemeMode;
+    /**
+     * @description 프로젝트 목록 (enableProjects 시 표시)
+     * @Todo vibecode - 프로젝트 선택 드롭다운용
+     */
+    projects?: ChatProject[];
+    /** @Todo vibecode - 현재 선택된 프로젝트 ID */
+    currentProjectId?: string | null;
+    /** @Todo vibecode - 프로젝트 선택 핸들러 */
+    onSelectProject?: (id: string) => void;
+    /** @Todo vibecode - 새 프로젝트 생성 핸들러 */
+    onNewProject?: () => void;
+    /** @Todo vibecode - 프로젝트 설정 열기 핸들러 */
+    onProjectSettings?: (id: string) => void;
+    /** @Todo vibecode - 새 채팅 버튼 아래, 세션 목록 위에 커스텀 콘텐츠 렌더링 */
+    renderAfterHeader?: () => React.ReactNode;
+    /** @Todo vibecode - 세션 목록 아래, 사이드바 하단에 커스텀 콘텐츠 렌더링 */
+    renderFooter?: () => React.ReactNode;
 }
 interface MessageListProps {
     messages: ChatMessage[];
@@ -1020,6 +1139,41 @@ interface UseChatUIReturn {
      * @Todo vibecode - 프리뷰에서 삭제 시 objectURL 해제 포함
      */
     removeAttachment: (id: string) => void;
+    /**
+     * @description 프로젝트 목록
+     * @Todo vibecode - enableProjects=false이면 빈 배열
+     */
+    projects: ChatProject[];
+    /** @Todo vibecode - 현재 선택된 프로젝트 ID */
+    currentProjectId: string | null;
+    /** @Todo vibecode - 현재 선택된 프로젝트 객체 */
+    currentProject: ChatProject | null;
+    /** @Todo vibecode - 프로젝트 목록 로딩 상태 */
+    isProjectsLoading: boolean;
+    /** @Todo vibecode - 프로젝트 생성 */
+    createProject: (data: {
+        title: string;
+        description?: string;
+        instructions?: string;
+    }) => Promise<string>;
+    /** @Todo vibecode - 프로젝트 선택 (세션 필터링 변경) */
+    selectProject: (projectId: string) => Promise<void>;
+    /** @Todo vibecode - 프로젝트 수정 */
+    updateProject: (projectId: string, data: Partial<ChatProject>) => Promise<void>;
+    /** @Todo vibecode - 프로젝트 삭제 (기본 프로젝트 삭제 불가) */
+    deleteProject: (projectId: string) => Promise<void>;
+    /** @Todo vibecode - 프로젝트 파일 추가 */
+    addProjectFile: (projectId: string, file: File) => Promise<void>;
+    /** @Todo vibecode - 프로젝트 파일 삭제 */
+    deleteProjectFile: (projectId: string, fileId: string) => Promise<void>;
+    /** @Todo vibecode - 프로젝트 설정 모달 열림 상태 */
+    projectSettingsOpen: boolean;
+    /** @Todo vibecode - 프로젝트 설정 모달 열기 */
+    openProjectSettings: () => void;
+    /** @Todo vibecode - 프로젝트 설정 모달 닫기 */
+    closeProjectSettings: () => void;
+    /** @Todo vibecode - 프로젝트 메모리 (계층형 3-tier 중 프로젝트 레벨) */
+    projectMemory: UseGlobalMemoryReturn | null;
 }
 
 /**
@@ -1116,6 +1270,8 @@ interface UseChatUIOptions {
             role: 'USER' | 'ASSISTANT' | 'user' | 'assistant';
             message?: string;
             content?: string;
+            /** @Todo vibecode - 멀티 콘텐츠 파트 (이미지/파일 등 복원용) */
+            contentParts?: MessageContentPart[];
             created_at?: string;
         }>;
         memory_data?: object;
@@ -1132,11 +1288,12 @@ interface UseChatUIOptions {
     onUpdateSessionTitle?: (sessionId: string, title: string) => Promise<void>;
     /**
      * @description 메시지 저장 콜백
-     * @Todo vibecode - 메시지 전송 완료 후 호출
+     * @Todo vibecode - 메시지 전송 완료 후 호출, contentParts로 이미지/파일 등 저장
      */
     onSaveMessages?: (sessionId: string, messages: {
         role: 'user' | 'assistant';
         message: string;
+        contentParts?: MessageContentPart[];
     }[]) => Promise<void>;
     /**
      * @description 심층연구 콜백 (onWebSearch 필수)
@@ -1163,6 +1320,31 @@ interface UseChatUIOptions {
      * @Todo vibecode - 라이브러리가 도구 호출 판단 후 호스트에 실행 위임
      */
     onToolCall?: (name: string, params: Record<string, unknown>) => Promise<ToolCallResult>;
+    /**
+     * @description 프로젝트 기능 활성화 여부 (기본: false)
+     * @Todo vibecode - true 시 프로젝트 그룹핑, 지침, 메모리 계층 활성화
+     */
+    enableProjects?: boolean;
+    /** @Todo vibecode - 프로젝트 목록 로드 콜백 */
+    onLoadProjects?: () => Promise<{
+        id: string;
+        title: string;
+    }[]>;
+    /** @Todo vibecode - 프로젝트 생성 콜백 */
+    onCreateProject?: (data: Partial<ChatProject>) => Promise<{
+        id: string;
+        title: string;
+    }>;
+    /** @Todo vibecode - 프로젝트 상세 로드 콜백 */
+    onLoadProject?: (projectId: string) => Promise<ChatProject>;
+    /** @Todo vibecode - 프로젝트 수정 콜백 */
+    onUpdateProject?: (projectId: string, data: Partial<ChatProject>) => Promise<void>;
+    /** @Todo vibecode - 프로젝트 삭제 콜백 */
+    onDeleteProject?: (projectId: string) => Promise<void>;
+    /** @Todo vibecode - 프로젝트 파일 추가 콜백 */
+    onAddProjectFile?: (projectId: string, file: File) => Promise<ProjectFile>;
+    /** @Todo vibecode - 프로젝트 파일 삭제 콜백 */
+    onDeleteProjectFile?: (projectId: string, fileId: string) => Promise<void>;
 }
 declare const useChatUI: (options: UseChatUIOptions) => UseChatUIReturn;
 
@@ -1263,6 +1445,52 @@ interface UseSkillsReturn {
 }
 declare const useSkills: (options: UseSkillsOptions) => UseSkillsReturn;
 
+/**
+ * @description 프로젝트 관리 훅 - CRUD, lazy loading, 기본 프로젝트 관리
+ * @Todo vibecode - useChatUI의 세션 관리 패턴을 따름
+ */
+
+interface UseProjectOptions {
+    /** @Todo vibecode - false이면 Hook 내부 로직 비활성 (Hook 규칙 준수용) */
+    enabled?: boolean;
+    /** 외부 스토리지 사용 여부 */
+    useExternalStorage?: boolean;
+    /** 스토리지 키 (localStorage 사용 시) */
+    storageKey?: string;
+    /** @Todo vibecode - 외부 스토리지 콜백들 */
+    onLoadProjects?: () => Promise<{
+        id: string;
+        title: string;
+    }[]>;
+    onCreateProject?: (data: Partial<ChatProject>) => Promise<{
+        id: string;
+        title: string;
+    }>;
+    onLoadProject?: (projectId: string) => Promise<ChatProject>;
+    onUpdateProject?: (projectId: string, data: Partial<ChatProject>) => Promise<void>;
+    onDeleteProject?: (projectId: string) => Promise<void>;
+    onAddProjectFile?: (projectId: string, file: File) => Promise<ProjectFile>;
+    onDeleteProjectFile?: (projectId: string, fileId: string) => Promise<void>;
+    onError?: (error: Error) => void;
+}
+interface UseProjectReturn {
+    projects: ChatProject[];
+    currentProjectId: string | null;
+    currentProject: ChatProject | null;
+    isProjectsLoading: boolean;
+    createProject: (data: {
+        title: string;
+        description?: string;
+        instructions?: string;
+    }) => Promise<string>;
+    selectProject: (projectId: string) => Promise<void>;
+    updateProject: (projectId: string, data: Partial<ChatProject>) => Promise<void>;
+    deleteProject: (projectId: string) => Promise<void>;
+    addFile: (projectId: string, file: File) => Promise<void>;
+    deleteFile: (projectId: string, fileId: string) => Promise<void>;
+}
+declare const useProject: (options: UseProjectOptions) => UseProjectReturn;
+
 /**
  * @description 고급 딥리서치 스킬 생성기
  * @Todo vibecode - useDeepResearch 4단계 파이프라인을 SkillConfig으로 통합
@@ -1472,6 +1700,16 @@ interface SettingsModalProps {
     onClearMemory?: () => void;
     /** @Todo vibecode - 개인화 설정 저장 핸들러 (저장 버튼 클릭 시) */
     onSave?: () => void;
+    /** @description 프로젝트 메모리 아이템 목록 @Todo vibecode */
+    projectMemoryItems?: MemoryItem[];
+    /** @description 프로젝트 메모리 항목 삭제 핸들러 @Todo vibecode */
+    onDeleteProjectMemory?: (key: string) => void;
+    /** @description 프로젝트 메모리 전체 삭제 핸들러 @Todo vibecode */
+    onClearProjectMemory?: () => void;
+    /** @description 프로젝트 기능 활성화 여부 @Todo vibecode */
+    enableProjects?: boolean;
+    /** @description 현재 프로젝트 이름 @Todo vibecode */
+    currentProjectTitle?: string;
 }
 declare const SettingsModal: React$1.FC<SettingsModalProps>;
 
@@ -1540,6 +1778,7 @@ interface ContentPartRendererProps {
 /**
  * @description contentParts 배열을 타입별로 렌더링
  * @Todo vibecode - text, image, file, search_result, tool_loading, tool_result, error 지원
+ * tool_result → ToolStatusCard 기반 구조화 렌더링
  */
 declare const ContentPartRenderer: React$1.FC<ContentPartRendererProps>;
 
@@ -1573,6 +1812,37 @@ interface FileContentCardProps {
  */
 declare const FileContentCard: React$1.FC<FileContentCardProps>;
 
+/**
+ * @description 프로젝트 선택 드롭다운 - 사이드바 상단에 배치
+ * @Todo vibecode - 프로젝트 전환, 생성, 설정 접근
+ */
+
+interface ProjectSelectorProps {
+    projects: ChatProject[];
+    currentProjectId: string | null;
+    onSelectProject: (id: string) => void;
+    onNewProject: () => void;
+    onProjectSettings: (id: string) => void;
+}
+declare const ProjectSelector: React$1.FC<ProjectSelectorProps>;
+
+/**
+ * @description 프로젝트 설정 모달 - 일반/지침/파일 3탭 구조
+ * @Todo vibecode - 프로젝트 정보 편집, Instructions, 파일 메타데이터 관리
+ */
+
+interface ProjectSettingsModalProps {
+    isOpen: boolean;
+    project: ChatProject | null;
+    onClose: () => void;
+    onUpdateProject: (projectId: string, data: Partial<ChatProject>) => void;
+    onAddFile: (projectId: string, file: File) => void;
+    onDeleteFile: (projectId: string, fileId: string) => void;
+    /** @Todo vibecode - 프로젝트 삭제 핸들러 (기본 프로젝트 삭제 불가) */
+    onDeleteProject?: (projectId: string) => void;
+}
+declare const ProjectSettingsModal: React$1.FC<ProjectSettingsModalProps>;
+
 /**
  * @description Tool → Skill 변환 어댑터
  * @Todo vibecode - ChatToolDefinition을 SkillConfig로 변환하여 기존 Skills 인프라 재사용
@@ -1590,4 +1860,19 @@ declare const FileContentCard: React$1.FC<FileContentCardProps>;
  */
 declare const convertToolsToSkills: (tools: ChatToolDefinition[], onToolCall: (name: string, params: Record<string, unknown>) => Promise<ToolCallResult>) => Record<string, SkillConfig>;
 
-export { type ActionItem, type ActionMenuProps, type AdvancedResearchOptions, type AlternativeResponse, type ChatAttachment, ChatHeader, ChatInput, type ChatMessage, type ChatSession, ChatSidebar, type ChatToolDefinition, type ChatToolParameter, ChatUI, type ChatUIComponents, type ChatUIProps, ContentPartRenderer, type ContentPartRendererProps, type DeepResearchCallbacks, type DeepResearchProgress, DeepResearchProgressUI, EmptyState, type EmptyStateProps, type ErrorContentPart, FileContentCard, type FileContentCardProps, type FileContentPart, 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 PersonalizationConfig, type PollBlock, PollCard, type PollCardProps, type PollOption, type PollQuestion, type PollResponse, type PollState, type PromptTemplate, type ProviderType, type ResponseStyle, type SearchResult, type SearchResultContentPart, type SendMessageParams, type SendMessageResponse, 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 TextContentPart, type ThemeConfig, type ThemeMode, type ToolCallResult, type ToolLoadingContentPart, type ToolResultContentPart, type UseChatUIOptions, type UseChatUIReturn, type UseDeepResearchOptions, type UseSkillsOptions, type UseSkillsReturn, type UserProfile, convertToolsToSkills, createAdvancedResearchSkill, createDeepResearchSkill, useChatUI, useDeepResearch, useSkills };
+/**
+ * @description localStorage 세션을 프로젝트 구조로 마이그레이션
+ * @Todo vibecode - enableProjects 활성화 시 기존 세션에 projectId 할당
+ */
+
+/** @Todo vibecode - 기본 프로젝트 ID 상수 */
+declare const DEFAULT_PROJECT_ID = "default";
+/** @Todo vibecode - 기본 프로젝트 제목 */
+declare const DEFAULT_PROJECT_TITLE = "\uAE30\uBCF8 \uD504\uB85C\uC81D\uD2B8";
+/**
+ * @description localStorage 세션 데이터를 프로젝트 구조로 마이그레이션
+ * @Todo vibecode - 기존 세션에 projectId: 'default' 할당, 기본 프로젝트 생성
+ */
+declare const migrateSessionsToProjects: (storageKey: string) => void;
+
+export { type ActionItem, type ActionMenuProps, type AdvancedResearchOptions, type AlternativeResponse, type ChatAttachment, ChatHeader, ChatInput, type ChatMessage, type ChatProject, type ChatSession, ChatSidebar, type ChatToolDefinition, type ChatToolParameter, ChatUI, type ChatUIComponents, type ChatUIProps, ContentPartRenderer, type ContentPartRendererProps, DEFAULT_PROJECT_ID, DEFAULT_PROJECT_TITLE, type DeepResearchCallbacks, type DeepResearchProgress, DeepResearchProgressUI, EmptyState, type EmptyStateProps, type ErrorContentPart, FileContentCard, type FileContentCardProps, type FileContentPart, 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 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 ResponseStyle, type SearchResult, type SearchResultContentPart, type SendMessageParams, type SendMessageResponse, 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 TextContentPart, type ThemeConfig, type ThemeMode, type ToolCallResult, type ToolLoadingContentPart, type ToolResultContentPart, type UseChatUIOptions, type UseChatUIReturn, type UseDeepResearchOptions, type UseProjectOptions, type UseProjectReturn, type UseSkillsOptions, type UseSkillsReturn, type UserProfile, convertToolsToSkills, createAdvancedResearchSkill, createDeepResearchSkill, migrateSessionsToProjects, useChatUI, useDeepResearch, useProject, useSkills };