@huyooo/ai-chat-frontend-react 0.2.12 → 0.2.14

package/dist/index.d.ts

@@ -2,8 +2,7 @@ import { ChatMode as ChatMode$1, ThinkingMode, ModelOption as ModelOption$1, Ses
 export { ChatAdapter, ChatEvent, ChatEventType, ChatMode, ChatOptions, MessageRecord, ModelOption, ProviderType, SessionRecord, ThinkingMode } from '@huyooo/ai-chat-bridge-electron/renderer';
 import * as react from 'react';
 import { FC, ReactNode, ComponentType } from 'react';
-import { ContentBlock, ToolRendererProps, TextBlock as TextBlock$1, CodeBlock as CodeBlock$1 } from '@huyooo/ai-chat-shared';
-export { CodeBlock as CodeBlockType, ContentBlock, ContentBlockType, SearchResultItem, TextBlock as TextBlockType, ToolRendererProps, WeatherData, getLanguageDisplayName, highlightCode, parseContent, renderMarkdown } from '@huyooo/ai-chat-shared';
+export { CodeBlock as CodeBlockType, ContentBlock, ContentBlockType, SearchResultItem, TextBlock as TextBlockType, WeatherData, getLanguageDisplayName, highlightCode, parseContent, renderMarkdown } from '@huyooo/ai-chat-shared';
 
 /**
  * Chat Adapter 辅助类型和工具
@@ -77,58 +76,79 @@ interface SearchResult {
     snippet: string;
 }
 /** 文本内容 Part */
-interface TextPart {
+interface TextPart$1 {
     type: 'text';
     text: string;
 }
+/** 代码块 Part（从 text 中解析，或直接返回）*/
+interface CodePart {
+    type: 'code';
+    content: string;
+    language?: string;
+}
 /** 思考过程 Part */
-interface ThinkingPart {
+interface ThinkingPart$1 {
     type: 'thinking';
     text: string;
     status: 'running' | 'done';
     duration?: number;
 }
 /** 搜索 Part */
-interface SearchPart {
+interface SearchPart$1 {
     type: 'search';
     query?: string;
     results?: SearchResult[];
     status: 'running' | 'done';
 }
-/** 工具调用 Part */
-interface ToolCallPart {
+/** 工具调用 Part（仅展示执行过程，结果由具体类型 Part 渲染）*/
+interface ToolCallPart$1 {
     type: 'tool_call';
     id: string;
     name: string;
     args?: Record<string, unknown>;
     status: 'pending' | 'running' | 'done' | 'error' | 'cancelled' | 'skipped';
-    result: unknown | null;
-}
-/** 工具结果 Part - 用于自定义 UI 渲染（备用，主要使用 ToolCallPart） */
-interface ToolResultPart {
-    type: 'tool_result';
-    id: string;
-    name: string;
-    args?: Record<string, unknown>;
-    result: unknown;
-    status: 'done' | 'error' | 'cancelled' | 'skipped';
+    /** 工具执行输出（用于 execute_command 等需要展示 stdout/stderr 的工具） */
+    output?: {
+        stdout?: string;
+        stderr?: string;
+    };
 }
 /** 图片 Part */
-interface ImagePart {
+interface ImagePart$1 {
     type: 'image';
     url: string;
 }
 /** 错误 Part */
-interface ErrorPart {
+interface ErrorPart$1 {
     type: 'error';
     message: string;
     category?: string;
     retryable?: boolean;
 }
-/** 内容 Part 联合类型 */
-type ContentPart = TextPart | ThinkingPart | SearchPart | ToolCallPart | ToolResultPart | ImagePart | ErrorPart;
+/** 天气 Part（由 get_weather 工具生成）*/
+interface WeatherPart {
+    type: 'weather';
+    city: string;
+    temperature: number;
+    condition: string;
+    humidity: number;
+    wind: string;
+    reportTime?: string;
+    province?: string;
+}
+/** 自定义 Part 基础接口（用于扩展）*/
+interface CustomPart {
+    type: string;
+    [key: string]: unknown;
+}
+/** 内置 Part 联合类型 */
+type BuiltinPart = TextPart$1 | CodePart | ThinkingPart$1 | SearchPart$1 | ToolCallPart$1 | ImagePart$1 | ErrorPart$1;
+/** 内容 Part 联合类型（包含内置和扩展类型）*/
+type ContentPart = BuiltinPart | WeatherPart | CustomPart;
 /** 内容 Part 类型字符串 */
-type ContentPartType = ContentPart['type'];
+type ContentPartType = string;
+/** 步骤折叠模式 */
+type StepsExpandedType = 'open' | 'close' | 'auto';
 /** 错误详情（结构化错误信息） */
 interface ErrorDetails {
     category?: string;
@@ -159,7 +179,7 @@ interface ChatMessage {
     /** 是否已复制 */
     copied?: boolean;
     /** 消息时间戳 */
-    timestamp?: Date;
+    timestamp?: number;
     /** 错误详情（如果有错误） */
     error?: ErrorDetails;
     /** 是否被用户中止 */
@@ -240,7 +260,7 @@ declare function useChat(options: UseChatOptions): {
     cancelRequest: () => void;
     copyMessage: (messageId: string) => Promise<void>;
     regenerateMessage: (messageIndex: number) => void;
-    resendFromIndex: (index: number, text: string) => void;
+    resendFromIndex: (index: number, text: string) => Promise<void>;
     setMode: (value: ChatMode$1) => void;
     setModel: (value: string) => void;
     setWebSearch: (value: boolean) => void;
@@ -249,6 +269,12 @@ declare function useChat(options: UseChatOptions): {
     autoRunConfig: AutoRunConfig;
     loadAutoRunConfig: () => Promise<void>;
     saveAutoRunConfig: (config: AutoRunConfig) => Promise<void>;
+    enabledTools: string[] | undefined;
+    allTools: {
+        name: string;
+        description: string;
+    }[];
+    saveEnabledTools: (tools: string[] | undefined) => Promise<void>;
 };
 
 /**
@@ -277,24 +303,21 @@ interface ChatInputProviderProps {
 declare const ChatInputProvider: FC<ChatInputProviderProps>;
 declare function useChatInputContext(): ChatInputContextValue | null;
 
-/** 块渲染器映射 */
-type BlockRenderers = Record<string, ComponentType<{
-    block: ContentBlock;
-}>>;
-/** 工具结果渲染器映射 */
-type ToolRenderers = Record<string, ComponentType<ToolRendererProps>>;
-/** 块渲染器上下文 */
-declare const BlockRenderersContext: react.Context<BlockRenderers>;
-/** 工具结果渲染器上下文 */
-declare const ToolRenderersContext: react.Context<ToolRenderers>;
-/** 渲染器 Provider Props */
-interface RenderersProviderProps {
-    blockRenderers?: BlockRenderers;
-    toolRenderers?: ToolRenderers;
+/** Part 渲染器 Props（每个自定义渲染器接收的 props） */
+interface PartRendererProps {
+    [key: string]: unknown;
+}
+/** Part 渲染器映射（key: part.type, value: 渲染组件） */
+type PartRenderers$1 = Record<string, ComponentType<PartRendererProps>>;
+/** Part 渲染器上下文 */
+declare const PartRenderersContext: react.Context<PartRenderers$1>;
+/** Part 渲染器 Provider Props */
+interface PartRenderersProviderProps {
+    partRenderers?: PartRenderers$1;
     children: ReactNode;
 }
-/** 渲染器 Provider */
-declare const RenderersProvider: FC<RenderersProviderProps>;
+/** Part 渲染器 Provider */
+declare const PartRenderersProvider: FC<PartRenderersProviderProps>;
 
 /** 功能项 */
 interface WelcomeFeature {
@@ -356,8 +379,8 @@ interface ChatPanelProps {
     className?: string;
     /** 欢迎页配置 */
     welcomeConfig?: Partial<WelcomeConfig>;
-    /** 自定义工具结果渲染器 - 根据工具名称选择渲染组件 */
-    toolRenderers?: Record<string, ComponentType<ToolRendererProps>>;
+    /** 自定义 Part 渲染器 - 根据 part.type 选择渲染组件（如 weather, stock 等） */
+    partRenderers?: PartRenderers$1;
     /**
      * 执行步骤折叠模式
      * - 'open': 始终展开
@@ -397,69 +420,77 @@ interface MessageBubbleProps {
     stepsExpandedType?: 'open' | 'close' | 'auto';
     /** 工具调用相关 - 通过 props 传递 */
     adapter?: ChatAdapter;
+    /** 取消工具调用（通常会中止当前请求/流式输出） */
+    onCancelToolCall?: (toolCallId: string) => void;
     autoRunConfig?: AutoRunConfig;
     onSaveConfig?: (config: AutoRunConfig) => Promise<void>;
 }
 declare const MessageBubble: FC<MessageBubbleProps>;
 
-/**
- * 内容渲染器
- * 将原始文本解析为内容块并渲染
- */
-
-interface ContentRendererProps {
-    /** 原始文本内容 */
-    content: string;
-    /** 预解析的块列表（可选，用于流式更新） */
-    blocks?: ContentBlock[];
-    /** 代码复制事件 */
-    onCodeCopy?: (code: string) => void;
+/** Part 渲染器映射类型 */
+type PartRenderers = Record<string, ComponentType<Record<string, unknown>>>;
+interface PartsRendererProps {
+    parts: ContentPart[];
+    expandedType?: StepsExpandedType;
+    /** 自定义 Part 渲染器（props 传入优先级高于 context） */
+    partRenderers?: PartRenderers;
+    adapter?: ChatAdapter;
+    onCancelToolCall?: (toolCallId: string) => void;
+    autoRunConfig?: AutoRunConfig;
+    onSaveConfig?: (config: AutoRunConfig) => Promise<void>;
 }
-declare const ContentRenderer: FC<ContentRendererProps>;
+declare const PartsRenderer: FC<PartsRendererProps>;
 
-/**
- * 文本块组件
- */
-
-interface TextBlockProps {
-    block: TextBlock$1;
+interface TextPartProps {
+    text: string;
 }
-declare const TextBlock: FC<TextBlockProps>;
-
-/**
- * 代码块组件
- */
+declare const TextPart: FC<TextPartProps>;
 
-interface CodeBlockProps {
-    block: CodeBlock$1;
-    onCopy?: (code: string) => void;
+interface ThinkingPartProps {
+    text: string;
+    status: 'running' | 'done';
+    duration?: number;
+    expandedType?: StepsExpandedType;
 }
-declare const CodeBlock: FC<CodeBlockProps>;
-
-/**
- * 工具结果渲染器
- * 根据工具名称选择合适的渲染组件
- */
-
-declare const ToolResultRenderer: FC<ToolRendererProps>;
-
-/**
- * 默认工具结果渲染器
- */
-
-declare const DefaultToolResult: FC<ToolRendererProps>;
+declare const ThinkingPart: FC<ThinkingPartProps>;
 
-/**
- * 天气卡片渲染器
- */
+interface SearchPartProps {
+    query?: string;
+    results?: SearchResult[];
+    status: 'running' | 'done';
+    expandedType?: StepsExpandedType;
+}
+declare const SearchPart: FC<SearchPartProps>;
 
-declare const WeatherCard: FC<ToolRendererProps>;
+interface ToolCallPartProps {
+    id: string;
+    name: string;
+    args?: Record<string, unknown>;
+    output?: {
+        stdout?: string;
+        stderr?: string;
+    };
+    status: 'pending' | 'running' | 'done' | 'error' | 'cancelled' | 'skipped';
+    expandedType?: StepsExpandedType;
+    adapter?: ChatAdapter;
+    onCancelToolCall?: (toolCallId: string) => void;
+    autoRunConfig?: AutoRunConfig;
+    onSaveConfig?: (config: AutoRunConfig) => Promise<void>;
+}
+declare const ToolCallPart: FC<ToolCallPartProps>;
 
-/**
- * 搜索结果渲染器
- */
+interface ImagePartProps {
+    url: string;
+    alt?: string;
+}
+declare const ImagePart: FC<ImagePartProps>;
 
-declare const SearchResults: FC<ToolRendererProps>;
+interface ErrorPartProps {
+    message: string;
+    category?: string;
+    retryable?: boolean;
+}
+declare const ErrorPart: FC<ErrorPartProps>;
 
 /** ChatInput 暴露给外部的方法 */
 interface ChatInputHandle {
@@ -479,9 +510,12 @@ interface ChatInputProps {
     variant?: 'input' | 'message';
     /** 受控值（用于历史消息编辑） */
     value?: string;
+    /** 图片数据（用于历史消息编辑） */
+    images?: string[];
     isLoading?: boolean;
     mode?: ChatMode;
     model?: string;
+    /** 模型列表（tooltip 由后端下发，前端仅透传渲染） */
     models?: ModelOption[];
     webSearchEnabled?: boolean;
     thinkingEnabled?: boolean;
@@ -579,4 +613,4 @@ interface ToastProps {
 }
 declare const Toast: FC<ToastProps>;
 
-export { type BlockRenderers, BlockRenderersContext, ChatHeader, ChatInput, type ChatInputContextValue, type ChatInputOptions, ChatInputProvider, type ChatMessage, ChatPanel, type ChatPanelHandle, CodeBlock, ConfirmDialog, type ContentPart, type ContentPartType, ContentRenderer, type CreateSessionOptions, DefaultToolResult, type ErrorDetails, type ErrorPart, type ImageData, type ImagePart, MessageBubble, RenderersProvider, type SaveMessageOptions, type SearchPart, type SearchResult, SearchResults, type SendMessageOptions, type SideEffect, TextBlock, type TextPart, type ThinkingData, type ThinkingPart, Toast, type ToolCallData, type ToolCallPart, type ToolCompleteEvent, type ToolRenderers, ToolRenderersContext, type ToolResultData, type ToolResultPart, ToolResultRenderer, type UpdateSessionOptions, type UseChatOptions, WeatherCard, type WelcomeConfig, type WelcomeFeature, WelcomeMessage, type WelcomeTask, defaultWelcomeConfig, getMessageText, useChat, useChatInputContext };
+export { ChatHeader, ChatInput, type ChatInputContextValue, type ChatInputOptions, ChatInputProvider, type ChatMessage, ChatPanel, type ChatPanelHandle, ConfirmDialog, type ContentPart, type ContentPartType, type CreateSessionOptions, type ErrorDetails, type ErrorPart$1 as ErrorPart, ErrorPart as ErrorPartComponent, type ImageData, type ImagePart$1 as ImagePart, ImagePart as ImagePartComponent, MessageBubble, type PartRendererProps, type PartRenderers$1 as PartRenderers, PartRenderersContext, PartRenderersProvider, PartsRenderer, type SaveMessageOptions, type SearchPart$1 as SearchPart, SearchPart as SearchPartComponent, type SearchResult, type SendMessageOptions, type SideEffect, type TextPart$1 as TextPart, TextPart as TextPartComponent, type ThinkingData, type ThinkingPart$1 as ThinkingPart, ThinkingPart as ThinkingPartComponent, Toast, type ToolCallData, type ToolCallPart$1 as ToolCallPart, ToolCallPart as ToolCallPartComponent, type ToolCompleteEvent, type ToolResultData, type UpdateSessionOptions, type UseChatOptions, type WelcomeConfig, type WelcomeFeature, WelcomeMessage, type WelcomeTask, defaultWelcomeConfig, getMessageText, useChat, useChatInputContext };