@gendive/chatllm 0.6.12 → 0.8.0

package/dist/react/index.d.mts

@@ -68,6 +68,75 @@ interface MarkdownRendererProps {
 }
 declare const MarkdownRenderer: React$1.FC<MarkdownRendererProps>;
 
+/**
+ * @description 메모리 시스템 타입 정의
+ * @license MIT
+ */
+/** @description 메모리 저장소 타입 */
+type MemoryStorageType = 'localStorage' | 'postgresql' | 'memory';
+/** @description 메모리 엔트리 기본 타입 */
+interface MemoryEntry {
+    key: string;
+    value: unknown;
+    createdAt: number;
+    updatedAt: number;
+}
+/** @description 확장된 메모리 엔트리 (자동 추출 시 사용) */
+interface ExtendedMemoryEntry extends MemoryEntry {
+    category?: MemoryCategory;
+    confidence?: number;
+    source?: string;
+}
+/** @description 메모리 카테고리 */
+type MemoryCategory = 'basic' | 'professional' | 'preferences' | 'context';
+/** @description 글로벌 메모리 설정 */
+interface GlobalMemoryConfig {
+    storageType: MemoryStorageType;
+    /** localStorage 설정 */
+    localStorage?: {
+        key: string;
+    };
+    /** PostgreSQL 설정 */
+    postgresql?: {
+        apiEndpoint: string;
+        userId: string;
+        authToken?: string;
+    };
+}
+/** @description 압축 상태 */
+interface CompressionState {
+    contextSummary?: string;
+    summaryAfterIndex?: number;
+    compressionCount: number;
+    lastCompressionAt?: number;
+}
+/** @description 정보 추출 설정 */
+interface InfoExtractionConfig {
+    /** 자동 추출 활성화 여부 */
+    enabled: boolean;
+    /** 추출에 사용할 모델 (저렴한 모델 권장) */
+    model?: string;
+    /** 최소 confidence 임계값 (기본: 0.8) */
+    minConfidence: number;
+}
+/** @description useGlobalMemory 훅 상태 */
+interface GlobalMemoryState {
+    entries: Map<string, ExtendedMemoryEntry>;
+    isLoading: boolean;
+    error: Error | null;
+}
+/** @description useGlobalMemory 훅 반환 타입 */
+interface UseGlobalMemoryReturn {
+    state: GlobalMemoryState;
+    set: (key: string, value: unknown, meta?: Partial<ExtendedMemoryEntry>) => Promise<void>;
+    get: <T>(key: string) => T | undefined;
+    remove: (key: string) => Promise<void>;
+    has: (key: string) => boolean;
+    clear: () => Promise<void>;
+    toPromptContext: () => string;
+    refresh: () => Promise<void>;
+}
+
 /**
  * @description React UI 컴포넌트 타입 정의
  */
@@ -102,8 +171,12 @@ interface ChatSession {
     model: string;
     createdAt: number;
     updatedAt: number;
+    /** @deprecated Use compressionState.contextSummary instead */
     contextSummary?: string;
+    /** @deprecated Use compressionState.summaryAfterIndex instead */
     summaryAfterIndex?: number;
+    /** 압축 상태 (점진적 압축용) */
+    compressionState?: CompressionState;
 }
 interface ActionItem {
     id: string;
@@ -159,9 +232,9 @@ interface ChatUIProps {
     showModelSelector?: boolean;
     /** 초기 시스템 프롬프트 */
     systemPrompt?: string;
-    /** 컨텍스트 압축 임계값 */
+    /** 컨텍스트 압축 임계값 (기본: 20) */
     contextCompressionThreshold?: number;
-    /** 압축 후 유지할 메시지 수 */
+    /** 압축 후 유지할 메시지 수 (기본: 6) */
     keepRecentMessages?: number;
     /** 스토리지 키 (로컬 저장용) */
     storageKey?: string;
@@ -173,6 +246,20 @@ interface ChatUIProps {
     onSessionChange?: (session: ChatSession | null) => void;
     /** 에러 핸들러 */
     onError?: (error: Error) => void;
+    /** @Todo vibecode - 세션 제목 변경 핸들러 */
+    onTitleChange?: (sessionId: string, newTitle: string) => void;
+    /** 재압축 임계값 - 새 메시지 수 (기본: 10) */
+    recompressionThreshold?: number;
+    /** 토큰 한도 (기본: 8000) */
+    tokenLimit?: number;
+    /** 글로벌 메모리 사용 여부 (기본: true) */
+    useGlobalMemory?: boolean;
+    /** 글로벌 메모리 설정 */
+    globalMemoryConfig?: GlobalMemoryConfig;
+    /** 자동 정보 추출 활성화 (기본: true) */
+    enableAutoExtraction?: boolean;
+    /** 정보 추출 설정 */
+    infoExtractionConfig?: Partial<InfoExtractionConfig>;
 }
 interface SendMessageParams {
     messages: {
@@ -215,6 +302,8 @@ interface SidebarProps {
     onSelectSession: (id: string) => void;
     onNewSession: () => void;
     onDeleteSession: (id: string) => void;
+    /** @Todo vibecode - 세션 제목 변경 핸들러 */
+    onRenameSession?: (id: string, newTitle: string) => void;
     isOpen: boolean;
     onToggle: () => void;
 }
@@ -319,6 +408,8 @@ interface UseChatUIReturn {
     newSession: () => void;
     selectSession: (id: string) => void;
     deleteSession: (id: string) => void;
+    /** @Todo vibecode - 세션 제목 변경 함수 */
+    renameSession: (id: string, newTitle: string) => void;
     setModel: (model: string) => void;
     toggleSidebar: () => void;
     openSettings: () => void;
@@ -335,6 +426,12 @@ interface UseChatUIReturn {
     getActiveAlternative: (assistantMessageId: string) => number;
     updatePersonalization: (config: Partial<PersonalizationConfig>) => void;
     models: ModelConfig[];
+    /** 글로벌 메모리 상태 */
+    globalMemory: UseGlobalMemoryReturn | null;
+    /** 현재 세션의 압축 상태 */
+    compressionState: CompressionState | null;
+    /** 수동으로 정보 추출 트리거 */
+    extractUserInfo: () => Promise<void>;
 }
 
 /**
@@ -374,6 +471,14 @@ interface UseChatUIOptions {
     onSessionChange?: (session: ChatSession | null) => void;
     /** 에러 핸들러 */
     onError?: (error: Error) => void;
+    /** @Todo vibecode - 세션 제목 변경 핸들러 */
+    onTitleChange?: (sessionId: string, newTitle: string) => void;
+    /** 글로벌 메모리 사용 여부 (기본: true) */
+    useGlobalMemoryEnabled?: boolean;
+    /** 글로벌 메모리 설정 */
+    globalMemoryConfig?: GlobalMemoryConfig;
+    /** 자동 정보 추출 활성화 (기본: true) */
+    enableAutoExtraction?: boolean;
 }
 declare const useChatUI: (options: UseChatUIOptions) => UseChatUIReturn;
 

package/dist/react/index.d.ts

@@ -68,6 +68,75 @@ interface MarkdownRendererProps {
 }
 declare const MarkdownRenderer: React$1.FC<MarkdownRendererProps>;
 
+/**
+ * @description 메모리 시스템 타입 정의
+ * @license MIT
+ */
+/** @description 메모리 저장소 타입 */
+type MemoryStorageType = 'localStorage' | 'postgresql' | 'memory';
+/** @description 메모리 엔트리 기본 타입 */
+interface MemoryEntry {
+    key: string;
+    value: unknown;
+    createdAt: number;
+    updatedAt: number;
+}
+/** @description 확장된 메모리 엔트리 (자동 추출 시 사용) */
+interface ExtendedMemoryEntry extends MemoryEntry {
+    category?: MemoryCategory;
+    confidence?: number;
+    source?: string;
+}
+/** @description 메모리 카테고리 */
+type MemoryCategory = 'basic' | 'professional' | 'preferences' | 'context';
+/** @description 글로벌 메모리 설정 */
+interface GlobalMemoryConfig {
+    storageType: MemoryStorageType;
+    /** localStorage 설정 */
+    localStorage?: {
+        key: string;
+    };
+    /** PostgreSQL 설정 */
+    postgresql?: {
+        apiEndpoint: string;
+        userId: string;
+        authToken?: string;
+    };
+}
+/** @description 압축 상태 */
+interface CompressionState {
+    contextSummary?: string;
+    summaryAfterIndex?: number;
+    compressionCount: number;
+    lastCompressionAt?: number;
+}
+/** @description 정보 추출 설정 */
+interface InfoExtractionConfig {
+    /** 자동 추출 활성화 여부 */
+    enabled: boolean;
+    /** 추출에 사용할 모델 (저렴한 모델 권장) */
+    model?: string;
+    /** 최소 confidence 임계값 (기본: 0.8) */
+    minConfidence: number;
+}
+/** @description useGlobalMemory 훅 상태 */
+interface GlobalMemoryState {
+    entries: Map<string, ExtendedMemoryEntry>;
+    isLoading: boolean;
+    error: Error | null;
+}
+/** @description useGlobalMemory 훅 반환 타입 */
+interface UseGlobalMemoryReturn {
+    state: GlobalMemoryState;
+    set: (key: string, value: unknown, meta?: Partial<ExtendedMemoryEntry>) => Promise<void>;
+    get: <T>(key: string) => T | undefined;
+    remove: (key: string) => Promise<void>;
+    has: (key: string) => boolean;
+    clear: () => Promise<void>;
+    toPromptContext: () => string;
+    refresh: () => Promise<void>;
+}
+
 /**
  * @description React UI 컴포넌트 타입 정의
  */
@@ -102,8 +171,12 @@ interface ChatSession {
     model: string;
     createdAt: number;
     updatedAt: number;
+    /** @deprecated Use compressionState.contextSummary instead */
     contextSummary?: string;
+    /** @deprecated Use compressionState.summaryAfterIndex instead */
     summaryAfterIndex?: number;
+    /** 압축 상태 (점진적 압축용) */
+    compressionState?: CompressionState;
 }
 interface ActionItem {
     id: string;
@@ -159,9 +232,9 @@ interface ChatUIProps {
     showModelSelector?: boolean;
     /** 초기 시스템 프롬프트 */
     systemPrompt?: string;
-    /** 컨텍스트 압축 임계값 */
+    /** 컨텍스트 압축 임계값 (기본: 20) */
     contextCompressionThreshold?: number;
-    /** 압축 후 유지할 메시지 수 */
+    /** 압축 후 유지할 메시지 수 (기본: 6) */
     keepRecentMessages?: number;
     /** 스토리지 키 (로컬 저장용) */
     storageKey?: string;
@@ -173,6 +246,20 @@ interface ChatUIProps {
     onSessionChange?: (session: ChatSession | null) => void;
     /** 에러 핸들러 */
     onError?: (error: Error) => void;
+    /** @Todo vibecode - 세션 제목 변경 핸들러 */
+    onTitleChange?: (sessionId: string, newTitle: string) => void;
+    /** 재압축 임계값 - 새 메시지 수 (기본: 10) */
+    recompressionThreshold?: number;
+    /** 토큰 한도 (기본: 8000) */
+    tokenLimit?: number;
+    /** 글로벌 메모리 사용 여부 (기본: true) */
+    useGlobalMemory?: boolean;
+    /** 글로벌 메모리 설정 */
+    globalMemoryConfig?: GlobalMemoryConfig;
+    /** 자동 정보 추출 활성화 (기본: true) */
+    enableAutoExtraction?: boolean;
+    /** 정보 추출 설정 */
+    infoExtractionConfig?: Partial<InfoExtractionConfig>;
 }
 interface SendMessageParams {
     messages: {
@@ -215,6 +302,8 @@ interface SidebarProps {
     onSelectSession: (id: string) => void;
     onNewSession: () => void;
     onDeleteSession: (id: string) => void;
+    /** @Todo vibecode - 세션 제목 변경 핸들러 */
+    onRenameSession?: (id: string, newTitle: string) => void;
     isOpen: boolean;
     onToggle: () => void;
 }
@@ -319,6 +408,8 @@ interface UseChatUIReturn {
     newSession: () => void;
     selectSession: (id: string) => void;
     deleteSession: (id: string) => void;
+    /** @Todo vibecode - 세션 제목 변경 함수 */
+    renameSession: (id: string, newTitle: string) => void;
     setModel: (model: string) => void;
     toggleSidebar: () => void;
     openSettings: () => void;
@@ -335,6 +426,12 @@ interface UseChatUIReturn {
     getActiveAlternative: (assistantMessageId: string) => number;
     updatePersonalization: (config: Partial<PersonalizationConfig>) => void;
     models: ModelConfig[];
+    /** 글로벌 메모리 상태 */
+    globalMemory: UseGlobalMemoryReturn | null;
+    /** 현재 세션의 압축 상태 */
+    compressionState: CompressionState | null;
+    /** 수동으로 정보 추출 트리거 */
+    extractUserInfo: () => Promise<void>;
 }
 
 /**
@@ -374,6 +471,14 @@ interface UseChatUIOptions {
     onSessionChange?: (session: ChatSession | null) => void;
     /** 에러 핸들러 */
     onError?: (error: Error) => void;
+    /** @Todo vibecode - 세션 제목 변경 핸들러 */
+    onTitleChange?: (sessionId: string, newTitle: string) => void;
+    /** 글로벌 메모리 사용 여부 (기본: true) */
+    useGlobalMemoryEnabled?: boolean;
+    /** 글로벌 메모리 설정 */
+    globalMemoryConfig?: GlobalMemoryConfig;
+    /** 자동 정보 추출 활성화 (기본: true) */
+    enableAutoExtraction?: boolean;
 }
 declare const useChatUI: (options: UseChatUIOptions) => UseChatUIReturn;