@gendive/chatllm 0.16.0 → 0.17.0

package/dist/react/index.d.mts

@@ -386,6 +386,16 @@ 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[];
 }
 interface ChatMessage {
     id: string;
@@ -457,8 +467,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 +535,12 @@ 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 스킬 실행 상태 (메시지에 첨부)
@@ -741,6 +758,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 +886,11 @@ interface SidebarProps {
     renderAfterHeader?: () => React.ReactNode;
     /** @Todo vibecode - 세션 목록 아래, 사이드바 하단에 커스텀 콘텐츠 렌더링 */
     renderFooter?: () => React.ReactNode;
+    /**
+     * @description 세션 목록 로딩 상태
+     * @Todo vibecode - true 시 스켈레톤 UI 표시
+     */
+    isLoading?: boolean;
 }
 interface MessageListProps {
     messages: ChatMessage[];
@@ -1089,6 +1126,11 @@ interface UseChatUIReturn {
      * @Todo vibecode - 외부 스토리지 사용 시 세션 상세 로드 중
      */
     isSessionLoading: boolean;
+    /**
+     * @description 모델 목록 로딩 상태
+     * @Todo vibecode - onLoadModels 실행 중
+     */
+    isModelsLoading: boolean;
     /**
      * @description 심층연구 모드 활성화 여부
      * @Todo vibecode - 심층연구 버튼 토글 상태
@@ -1345,6 +1387,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,16 @@ 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[];
 }
 interface ChatMessage {
     id: string;
@@ -457,8 +467,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 +535,12 @@ 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 스킬 실행 상태 (메시지에 첨부)
@@ -741,6 +758,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 +886,11 @@ interface SidebarProps {
     renderAfterHeader?: () => React.ReactNode;
     /** @Todo vibecode - 세션 목록 아래, 사이드바 하단에 커스텀 콘텐츠 렌더링 */
     renderFooter?: () => React.ReactNode;
+    /**
+     * @description 세션 목록 로딩 상태
+     * @Todo vibecode - true 시 스켈레톤 UI 표시
+     */
+    isLoading?: boolean;
 }
 interface MessageListProps {
     messages: ChatMessage[];
@@ -1089,6 +1126,11 @@ interface UseChatUIReturn {
      * @Todo vibecode - 외부 스토리지 사용 시 세션 상세 로드 중
      */
     isSessionLoading: boolean;
+    /**
+     * @description 모델 목록 로딩 상태
+     * @Todo vibecode - onLoadModels 실행 중
+     */
+    isModelsLoading: boolean;
     /**
      * @description 심층연구 모드 활성화 여부
      * @Todo vibecode - 심층연구 버튼 토글 상태
@@ -1345,6 +1387,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;