@gendive/chatllm 0.16.1 → 0.17.1

package/dist/react/index.d.mts

@@ -386,6 +386,21 @@ interface ChatToolDefinition {
     label?: string;
     /** @Todo vibecode - UI 표시용 아이콘 ('image', 'search', 'code', 'file') */
     icon?: string;
+    /**
+     * @description 트리거 방식 (기본: 'both')
+     * @Todo vibecode - 'attachment' 시 파일 첨부 자동 실행
+     */
+    trigger?: 'both' | 'attachment';
+    /**
+     * @description 허용 파일 타입 (attachment trigger 전용)
+     * @Todo vibecode - MIME 와일드카드 ('image/*'), 확장자 ('.pdf') 지원
+     */
+    acceptedTypes?: string[];
+    /**
+     * @description 파일 첨부 시 File 객체를 base64 문자열로 자동 변환
+     * @Todo vibecode - true 시 execute()에 { name, mimeType, base64, size } 형태로 전달
+     */
+    autoConvertBase64?: boolean;
 }
 interface ChatMessage {
     id: string;
@@ -457,8 +472,9 @@ interface ActionItem {
  * auto: AI가 <skill_use> 태그로 자동 호출
  * manual: 사용자가 UI에서 직접 선택
  * both: 양쪽 모두 가능
+ * attachment: 파일 첨부 시 자동 실행 (AI 호출 불가, UI 메뉴 미표시)
  */
-type SkillTrigger = 'auto' | 'manual' | 'both';
+type SkillTrigger = 'auto' | 'manual' | 'both' | 'attachment';
 /**
  * @description 스킬 실행 결과
  */
@@ -524,6 +540,17 @@ interface SkillConfig<TParams = Record<string, unknown>> {
     label: string;
     /** 비활성화 여부 */
     disabled?: boolean;
+    /**
+     * @description 허용 파일 타입 (attachment trigger 전용)
+     * @Todo vibecode - MIME 와일드카드 ('image/*'), 확장자 ('.pdf') 지원
+     * @example ['image/*', 'application/pdf', '.docx']
+     */
+    acceptedTypes?: string[];
+    /**
+     * @description 파일 첨부 시 File 객체를 base64 문자열로 자동 변환
+     * @Todo vibecode - true 시 execute()에 { name, mimeType, base64, size } 형태로 전달
+     */
+    autoConvertBase64?: boolean;
 }
 /**
  * @description 스킬 실행 상태 (메시지에 첨부)
@@ -559,6 +586,14 @@ interface ModelConfig {
     name: string;
     provider: ProviderType;
     description?: string;
+    /** @Todo vibecode - UI 표시용 아이콘 (URL 또는 아이콘 이름) */
+    icon?: string;
+    /** @Todo vibecode - 최대 출력 토큰 수 */
+    maxTokens?: number;
+    /** @Todo vibecode - 컨텍스트 윈도우 크기 (토큰) */
+    contextWindow?: number;
+    /** @Todo vibecode - 호스트 커스텀 필드 허용 */
+    [key: string]: unknown;
 }
 interface PromptTemplate {
     id: string;
@@ -741,6 +776,21 @@ interface ChatUIProps {
      * @Todo vibecode - 라이브러리가 도구 호출 판단 후 호스트에 실행 위임
      */
     onToolCall?: (name: string, params: Record<string, unknown>) => Promise<ToolCallResult>;
+    /**
+     * @description 도구/스킬 실행 후 AI 후속 스트리밍 계속 여부 (기본: true)
+     * @Todo vibecode - false 시 도구 결과만 표시하고 AI 후속 응답 생략
+     */
+    continueAfterToolResult?: boolean;
+    /**
+     * @description 스킬 실행 완료 시 콜백 (개별 스킬별 제어)
+     * @Todo vibecode - 'continue' 반환 시 AI 후속 응답, 'stop' 반환 시 중단
+     */
+    onSkillComplete?: (skillName: string, result: SkillExecutionResult) => 'continue' | 'stop';
+    /**
+     * @description 모델 목록 비동기 로드 콜백
+     * @Todo vibecode - 마운트 시 호출, 반환된 모델 목록이 models prop을 대체
+     */
+    onLoadModels?: () => Promise<ModelConfig[]>;
     /**
      * @description 프로젝트 기능 활성화 여부 (기본: false)
      * @Todo vibecode - true 시 프로젝트 그룹핑, 지침, 메모리 계층 활성화
@@ -854,6 +904,11 @@ interface SidebarProps {
     renderAfterHeader?: () => React.ReactNode;
     /** @Todo vibecode - 세션 목록 아래, 사이드바 하단에 커스텀 콘텐츠 렌더링 */
     renderFooter?: () => React.ReactNode;
+    /**
+     * @description 세션 목록 로딩 상태
+     * @Todo vibecode - true 시 스켈레톤 UI 표시
+     */
+    isLoading?: boolean;
 }
 interface MessageListProps {
     messages: ChatMessage[];
@@ -1089,6 +1144,11 @@ interface UseChatUIReturn {
      * @Todo vibecode - 외부 스토리지 사용 시 세션 상세 로드 중
      */
     isSessionLoading: boolean;
+    /**
+     * @description 모델 목록 로딩 상태
+     * @Todo vibecode - onLoadModels 실행 중
+     */
+    isModelsLoading: boolean;
     /**
      * @description 심층연구 모드 활성화 여부
      * @Todo vibecode - 심층연구 버튼 토글 상태
@@ -1345,6 +1405,21 @@ interface UseChatUIOptions {
     onAddProjectFile?: (projectId: string, file: File) => Promise<ProjectFile>;
     /** @Todo vibecode - 프로젝트 파일 삭제 콜백 */
     onDeleteProjectFile?: (projectId: string, fileId: string) => Promise<void>;
+    /**
+     * @description 도구 실행 후 AI 스트리밍 계속 여부 (기본: true, 하위호환)
+     * @Todo vibecode - false 시 도구 결과만 표시하고 AI 후속 응답 생략
+     */
+    continueAfterToolResult?: boolean;
+    /**
+     * @description 스킬 완료 시 콜백 (스트림 제어)
+     * @Todo vibecode - 'continue' 반환 시 AI 응답 생성, 'stop' 반환 시 중단
+     */
+    onSkillComplete?: (skillName: string, result: SkillExecutionResult) => 'continue' | 'stop';
+    /**
+     * @description 모델 목록 비동기 로드 콜백
+     * @Todo vibecode - 제공 시 마운트 시 호출, 완료 전까지 models prop 사용
+     */
+    onLoadModels?: () => Promise<ModelConfig[]>;
 }
 declare const useChatUI: (options: UseChatUIOptions) => UseChatUIReturn;
 

package/dist/react/index.d.ts

@@ -386,6 +386,21 @@ interface ChatToolDefinition {
     label?: string;
     /** @Todo vibecode - UI 표시용 아이콘 ('image', 'search', 'code', 'file') */
     icon?: string;
+    /**
+     * @description 트리거 방식 (기본: 'both')
+     * @Todo vibecode - 'attachment' 시 파일 첨부 자동 실행
+     */
+    trigger?: 'both' | 'attachment';
+    /**
+     * @description 허용 파일 타입 (attachment trigger 전용)
+     * @Todo vibecode - MIME 와일드카드 ('image/*'), 확장자 ('.pdf') 지원
+     */
+    acceptedTypes?: string[];
+    /**
+     * @description 파일 첨부 시 File 객체를 base64 문자열로 자동 변환
+     * @Todo vibecode - true 시 execute()에 { name, mimeType, base64, size } 형태로 전달
+     */
+    autoConvertBase64?: boolean;
 }
 interface ChatMessage {
     id: string;
@@ -457,8 +472,9 @@ interface ActionItem {
  * auto: AI가 <skill_use> 태그로 자동 호출
  * manual: 사용자가 UI에서 직접 선택
  * both: 양쪽 모두 가능
+ * attachment: 파일 첨부 시 자동 실행 (AI 호출 불가, UI 메뉴 미표시)
  */
-type SkillTrigger = 'auto' | 'manual' | 'both';
+type SkillTrigger = 'auto' | 'manual' | 'both' | 'attachment';
 /**
  * @description 스킬 실행 결과
  */
@@ -524,6 +540,17 @@ interface SkillConfig<TParams = Record<string, unknown>> {
     label: string;
     /** 비활성화 여부 */
     disabled?: boolean;
+    /**
+     * @description 허용 파일 타입 (attachment trigger 전용)
+     * @Todo vibecode - MIME 와일드카드 ('image/*'), 확장자 ('.pdf') 지원
+     * @example ['image/*', 'application/pdf', '.docx']
+     */
+    acceptedTypes?: string[];
+    /**
+     * @description 파일 첨부 시 File 객체를 base64 문자열로 자동 변환
+     * @Todo vibecode - true 시 execute()에 { name, mimeType, base64, size } 형태로 전달
+     */
+    autoConvertBase64?: boolean;
 }
 /**
  * @description 스킬 실행 상태 (메시지에 첨부)
@@ -559,6 +586,14 @@ interface ModelConfig {
     name: string;
     provider: ProviderType;
     description?: string;
+    /** @Todo vibecode - UI 표시용 아이콘 (URL 또는 아이콘 이름) */
+    icon?: string;
+    /** @Todo vibecode - 최대 출력 토큰 수 */
+    maxTokens?: number;
+    /** @Todo vibecode - 컨텍스트 윈도우 크기 (토큰) */
+    contextWindow?: number;
+    /** @Todo vibecode - 호스트 커스텀 필드 허용 */
+    [key: string]: unknown;
 }
 interface PromptTemplate {
     id: string;
@@ -741,6 +776,21 @@ interface ChatUIProps {
      * @Todo vibecode - 라이브러리가 도구 호출 판단 후 호스트에 실행 위임
      */
     onToolCall?: (name: string, params: Record<string, unknown>) => Promise<ToolCallResult>;
+    /**
+     * @description 도구/스킬 실행 후 AI 후속 스트리밍 계속 여부 (기본: true)
+     * @Todo vibecode - false 시 도구 결과만 표시하고 AI 후속 응답 생략
+     */
+    continueAfterToolResult?: boolean;
+    /**
+     * @description 스킬 실행 완료 시 콜백 (개별 스킬별 제어)
+     * @Todo vibecode - 'continue' 반환 시 AI 후속 응답, 'stop' 반환 시 중단
+     */
+    onSkillComplete?: (skillName: string, result: SkillExecutionResult) => 'continue' | 'stop';
+    /**
+     * @description 모델 목록 비동기 로드 콜백
+     * @Todo vibecode - 마운트 시 호출, 반환된 모델 목록이 models prop을 대체
+     */
+    onLoadModels?: () => Promise<ModelConfig[]>;
     /**
      * @description 프로젝트 기능 활성화 여부 (기본: false)
      * @Todo vibecode - true 시 프로젝트 그룹핑, 지침, 메모리 계층 활성화
@@ -854,6 +904,11 @@ interface SidebarProps {
     renderAfterHeader?: () => React.ReactNode;
     /** @Todo vibecode - 세션 목록 아래, 사이드바 하단에 커스텀 콘텐츠 렌더링 */
     renderFooter?: () => React.ReactNode;
+    /**
+     * @description 세션 목록 로딩 상태
+     * @Todo vibecode - true 시 스켈레톤 UI 표시
+     */
+    isLoading?: boolean;
 }
 interface MessageListProps {
     messages: ChatMessage[];
@@ -1089,6 +1144,11 @@ interface UseChatUIReturn {
      * @Todo vibecode - 외부 스토리지 사용 시 세션 상세 로드 중
      */
     isSessionLoading: boolean;
+    /**
+     * @description 모델 목록 로딩 상태
+     * @Todo vibecode - onLoadModels 실행 중
+     */
+    isModelsLoading: boolean;
     /**
      * @description 심층연구 모드 활성화 여부
      * @Todo vibecode - 심층연구 버튼 토글 상태
@@ -1345,6 +1405,21 @@ interface UseChatUIOptions {
     onAddProjectFile?: (projectId: string, file: File) => Promise<ProjectFile>;
     /** @Todo vibecode - 프로젝트 파일 삭제 콜백 */
     onDeleteProjectFile?: (projectId: string, fileId: string) => Promise<void>;
+    /**
+     * @description 도구 실행 후 AI 스트리밍 계속 여부 (기본: true, 하위호환)
+     * @Todo vibecode - false 시 도구 결과만 표시하고 AI 후속 응답 생략
+     */
+    continueAfterToolResult?: boolean;
+    /**
+     * @description 스킬 완료 시 콜백 (스트림 제어)
+     * @Todo vibecode - 'continue' 반환 시 AI 응답 생성, 'stop' 반환 시 중단
+     */
+    onSkillComplete?: (skillName: string, result: SkillExecutionResult) => 'continue' | 'stop';
+    /**
+     * @description 모델 목록 비동기 로드 콜백
+     * @Todo vibecode - 제공 시 마운트 시 호출, 완료 전까지 models prop 사용
+     */
+    onLoadModels?: () => Promise<ModelConfig[]>;
 }
 declare const useChatUI: (options: UseChatUIOptions) => UseChatUIReturn;