@zero-library/chat-copilot 3.1.30 → 4.0.0

package/dist/index.d.ts

@@ -449,8 +449,10 @@ interface ToolCallEvent {
     display?: DisplayView | null;
     /** 执行状态 */
     status?: 'pending' | 'running' | 'success' | 'error';
-    /** 该工具是否触发了子智能体（前端动态判断：有 toolCallId 的子消息到达时标记） */
+    /** 该工具是否触发了子智能体（toolResult.metadata.conversationId 存在时标记） */
     hasSubAgent?: boolean;
+    /** 子智能体会话 ID（来自 toolResult.metadata.conversationId），用于独立存储和懒加载 */
+    subConversationId?: string;
     /** 前端内部标记：是否使用 display 协议渲染 */
     displayProtocol?: boolean;
 }
@@ -521,6 +523,52 @@ interface CitationEvent {
     citations?: Citation[];
 }
 type MessageEvent = RunStartedEvent | TextEvent | FilesEvent | StepStartedEvent | StepFinishedEvent | StepErrorEvent | RunFinishedEvent | RunStoppedEvent | ConversationNewTitleEvent | ToolCallEvent | ToolCallDeltaEvent | ToolResultEvent | RunFailedEvent | A2uiCommandEvent | A2uiSchemaEvent | PlanEvent | CitationEvent;
+/** 单条执行事件 */
+interface DebugEvent {
+    /** 事件唯一ID */
+    id: string;
+    /** 所属执行ID */
+    executionId: string;
+    /** 步骤ID（react-step-1, react-step-2...） */
+    stepId?: string | null;
+    /** 父步骤ID（嵌套子智能体时） */
+    parentStepId?: string | null;
+    /** 全局序号 */
+    seq: number;
+    /** 事件类型 */
+    eventType: string;
+    /** 事件载荷（包含完整事件信息） */
+    payloadJson: {
+        depth?: number;
+        event?: Record<string, any>;
+        executionId?: number | string;
+        parentExecutionId?: number | string | null;
+        schemaVersion?: number;
+        seq?: number;
+        timestampMs?: number;
+    };
+    /** 后端记录时间 */
+    createdAt: string;
+}
+/** 执行轨迹响应 */
+interface ExecutionDebug {
+    /** 执行ID */
+    id: string;
+    /** 执行状态：running / finished / error / stopped */
+    status: string;
+    /** 开始时间 */
+    startedAt: string;
+    /** 结束时间 */
+    finishedAt?: string | null;
+    /** 输出消息ID */
+    outputMessageId?: string | null;
+    /** 错误码 */
+    errorCode?: string | null;
+    /** 错误信息 */
+    errorMessage?: string | null;
+    /** 事件列表（按 seq 排序） */
+    events: DebugEvent[];
+}
 /**
  * 消息类型
  * 定义智能体和用户之间的消息结构
@@ -534,7 +582,7 @@ interface ConversationMessage {
     conversationId: string;
     /** 执行ID */
     executionId: string;
-    /** 角色：1-智能体 2-用户 */
+    /** 角色：1-用户 2-智能体（与主会话 conversationRoles 约定一致，左右位置据此外推） */
     role: number;
     /** 消息内容 */
     content: MessageEvent[];
@@ -552,16 +600,24 @@ interface ConversationMessage {
     stopFlag?: boolean;
     /** 是否正在生成中 */
     generating?: boolean;
-    /** 子智能体名称，前端展示用 */
-    subAgentName?: string;
+    /** 子智能体名称，前端展示用（后端字段名 agentName） */
+    agentName?: string;
     /** 父执行 ID，用于关联到主智能体的执行 */
     parentExecutionId?: string;
-    /** 嵌套深度（0=顶层，1=一级子智能体） */
-    subAgentDepth?: number;
+    /** 嵌套深度（0=顶层，1=一级子智能体，后端字段名 depth） */
+    depth?: number;
     /** 父 agent_spawn 工具调用 ID，前端通过此字段将子智能体消息归属到对应工具块 */
     toolCallId?: string;
 }
 
+/**
+ * 智能体执行链展示模式
+ * - aggregate：聚合模式（默认）。将每次执行压缩为「状态图标 + 类型标签 + 单行截断详情」的折叠列表，
+ *   顶部展示「X 项完成 | Y 项失败」汇总头，最终回答独立渲染在列表下方。
+ * - sequence：顺序模式（非聚合）。按真实事件顺序平铺渲染思维链（深度思考）、工具调用、文件、计划与回答，
+ *   不做汇总折叠，忠实还原执行时间线。
+ */
+type AgentExecMode = 'aggregate' | 'sequence';
 /**
  * 聊天布局会话列表配置接口
  * 控制会话列表区域的显示和功能
@@ -874,6 +930,7 @@ declare const createChatService: (request: ReturnType<typeof createRequest>, con
     getAgentAvatar: (path: string) => Promise<Blob>;
     conversationFavorite: (conversationId: string, isFavorite: boolean) => Promise<R<boolean>>;
     shareConversation: (conversationId: string) => Promise<R<ShareConversationResponse>>;
+    fetchExecutionDebug: (conversationId: string) => Promise<R<PageRes<ExecutionDebug>>>;
 };
 
 type RequestInstance = Partial<ReturnType<typeof createChatService>>;
@@ -1830,4 +1887,381 @@ declare const getFileUrl: (params: DownloadFileReq, baseUrl?: string, url?: stri
 
 declare const _default: react.ForwardRefExoticComponent<ChatProps & react.RefAttributes<ChatHandle>>;
 
-export { type AgentConfig, type AgentInfo, type AgentSpec, _default$1 as Attachments, type AttachmentsProps, type ChatConfig, _default as ChatCopilot, type ChatHandle, type ChatHooks, type ChatLayout, type ChatParams, type ChatProps, _default$2 as ChatSender, type ChatServices, type ConversationMessage, type ConversationMessageSend, type ConversationStrategy, type CustomButtonProps, type FileTextType, type FileUploadConfig, type FileUrlType, type InputFile, type MessageRenderProps, type ReferencesType, type RequestInstance, type SenderProps, WorkspaceTypeEnum, getFileIcon, getFileUrl };
+/**
+ * chat-copilot 包命名空间常量
+ *
+ * 命名空间在每个包内部是固定值，统一使用常量引用，避免散落字符串字面量。
+ */
+declare const NS_CHAT_COPILOT = "chat-copilot";
+
+/**
+ * chat-copilot 包英文翻译资源（namespace: chat-copilot）
+ */
+declare const chatCopilotEnUS: {
+    uploadFailed: string;
+    valuePlaceholder: string;
+    checkParams: string;
+    inputPlaceholder: string;
+    numberPlaceholder: string;
+    paramSettings: string;
+    all: string;
+    selectSkill: string;
+    selectKnowledge: string;
+    searchSkill: string;
+    searchKnowledge: string;
+    noDescription: string;
+    noMatch: string;
+    selectedCount: string;
+    added: string;
+    collapse: string;
+    expand: string;
+    history: string;
+    create: string;
+    share: string;
+    linkCopied: string;
+    unfavorite: string;
+    favorite: string;
+    delete: string;
+    tipTitle: string;
+    confirm: string;
+    cancel: string;
+    confirmUnfavorite: string;
+    unfavoriteTitle: string;
+    historyTab: string;
+    historyEmpty: string;
+    favoritesTab: string;
+    favoritesEmpty: string;
+    deepAnalysis: string;
+    summaryAnalysis: string;
+    headerClose: string;
+    deepThinking: string;
+    skill: string;
+    knowledge: string;
+    supportedExtensions: string;
+    empty: string;
+    chatPlaceholder: string;
+    selectFile: string;
+    selectPlaceholder: string;
+    unnamedReport: string;
+    unnamedChart: string;
+    unnamedTable: string;
+    unnamedContent: string;
+    chart: string;
+    exportPng: string;
+    report: string;
+    exportMd: string;
+    table: string;
+    exportCsv: string;
+    exportJson: string;
+    boolYes: string;
+    boolNo: string;
+    formTitle: string;
+    stepIndicator: string;
+    prevStep: string;
+    nextStep: string;
+    submit: string;
+    submitFailed: string;
+    questionCancelled: string;
+    questionAnswered: string;
+    questionDetails: string;
+    basicInfoSubmitted: string;
+    paramsSubmitted: string;
+    backToBasic: string;
+    backToParams: string;
+    createConfirmed: string;
+    actionSelected: string;
+    actionSubmitted: string;
+    actionSubmittedNamed: string;
+    quotedMessage: string;
+    answered: string;
+    inputGenerating: string;
+    inputParams: string;
+    outputResult: string;
+    subAgentRunning: string;
+    subAgentNested: string;
+    noTasks: string;
+    clickHere: string;
+    unsupportedChart: string;
+    unsupportedChartDesc: string;
+    previewEdit: string;
+    copy: string;
+    continueText: string;
+    noVariables: string;
+    stopped: string;
+    greetingHello: string;
+    greetingSubtitle: string;
+    disclaimer: string;
+    uploadFromLocal: string;
+    edit: string;
+    noUserInputFields: string;
+    startConversation: string;
+    helloIam: string;
+    newConversation: string;
+    sendFailed: string;
+    previewNotSupported: string;
+    operationBlocked: string;
+    deleteSuccess: string;
+    favoriteSuccess: string;
+    unfavoriteSuccess: string;
+    feedbackThanks: string;
+};
+
+/**
+ * chat-copilot パッケージ日本語翻訳リソース（namespace: chat-copilot）
+ *
+ * 純データ出口、side-effect を含まない。
+ * ホストプロジェクトは I18nProvider の resources パラメータで注入します。
+ */
+declare const chatCopilotJaJP: {
+    uploadFailed: string;
+    valuePlaceholder: string;
+    checkParams: string;
+    inputPlaceholder: string;
+    numberPlaceholder: string;
+    paramSettings: string;
+    all: string;
+    selectSkill: string;
+    selectKnowledge: string;
+    searchSkill: string;
+    searchKnowledge: string;
+    noDescription: string;
+    noMatch: string;
+    selectedCount: string;
+    added: string;
+    collapse: string;
+    expand: string;
+    history: string;
+    create: string;
+    share: string;
+    linkCopied: string;
+    unfavorite: string;
+    favorite: string;
+    delete: string;
+    tipTitle: string;
+    confirm: string;
+    cancel: string;
+    confirmUnfavorite: string;
+    unfavoriteTitle: string;
+    historyTab: string;
+    historyEmpty: string;
+    favoritesTab: string;
+    favoritesEmpty: string;
+    deepAnalysis: string;
+    summaryAnalysis: string;
+    headerClose: string;
+    deepThinking: string;
+    skill: string;
+    knowledge: string;
+    supportedExtensions: string;
+    empty: string;
+    selectFile: string;
+    unsupportedType: string;
+    maxFileCountExceed: string;
+    maxFileSizeExceed: string;
+    waitUpload: string;
+    checkFailed: string;
+    dropTitle: string;
+    uploadTitle: string;
+    uploadDescription: string;
+    chatPlaceholder: string;
+    selectPlaceholder: string;
+    unnamedReport: string;
+    unnamedChart: string;
+    unnamedTable: string;
+    unnamedContent: string;
+    chart: string;
+    exportPng: string;
+    report: string;
+    exportMd: string;
+    table: string;
+    exportCsv: string;
+    exportJson: string;
+    boolYes: string;
+    boolNo: string;
+    formTitle: string;
+    stepIndicator: string;
+    prevStep: string;
+    nextStep: string;
+    submit: string;
+    submitFailed: string;
+    questionCancelled: string;
+    questionAnswered: string;
+    questionDetails: string;
+    basicInfoSubmitted: string;
+    paramsSubmitted: string;
+    backToBasic: string;
+    backToParams: string;
+    createConfirmed: string;
+    actionSelected: string;
+    actionSubmitted: string;
+    actionSubmittedNamed: string;
+    quotedMessage: string;
+    answered: string;
+    inputGenerating: string;
+    inputParams: string;
+    outputResult: string;
+    subAgentRunning: string;
+    subAgentNested: string;
+    noTasks: string;
+    clickHere: string;
+    unsupportedChart: string;
+    unsupportedChartDesc: string;
+    previewEdit: string;
+    copy: string;
+    continueText: string;
+    noVariables: string;
+    dateToday: string;
+    dateLast7Days: string;
+    dateLast30Days: string;
+    dateLastHalfYear: string;
+    dateEarlier: string;
+    previewNotSupported: string;
+    deleteSuccess: string;
+    operationBlocked: string;
+    favoriteSuccess: string;
+    unfavoriteSuccess: string;
+    feedbackThanks: string;
+    sendFailed: string;
+    newConversationTitle: string;
+    stopped: string;
+    greetingHello: string;
+    greetingSubtitle: string;
+    disclaimer: string;
+    helloIam: string;
+    newConversation: string;
+    uploadFromLocal: string;
+    edit: string;
+    noUserInputFields: string;
+    startConversation: string;
+};
+
+/**
+ * chat-copilot 包中文翻译资源（namespace: chat-copilot）
+ *
+ * 纯数据导出，不含 side-effect。
+ * 宿主项目通过 I18nProvider 的 resources 参数注入。
+ */
+declare const chatCopilotZhCN: {
+    readonly uploadFailed: "上传失败";
+    readonly valuePlaceholder: "请输入值...";
+    readonly checkParams: "请检查输入参数";
+    readonly inputPlaceholder: "请输入值";
+    readonly numberPlaceholder: "请输入数值";
+    readonly paramSettings: "参数设置";
+    readonly all: "全部";
+    readonly selectSkill: "选择技能";
+    readonly selectKnowledge: "选择知识库";
+    readonly searchSkill: "搜索技能名称";
+    readonly searchKnowledge: "搜索知识库名称";
+    readonly noDescription: "暂无描述";
+    readonly noMatch: "暂无匹配的搜索结果";
+    readonly selectedCount: "已选 {{count}}";
+    readonly added: "已添加";
+    readonly collapse: "收起";
+    readonly expand: "展开";
+    readonly history: "历史会话";
+    readonly create: "新建会话";
+    readonly share: "分享";
+    readonly linkCopied: "链接已复制，可直接粘贴分享";
+    readonly unfavorite: "取消收藏";
+    readonly favorite: "收藏";
+    readonly delete: "删除";
+    readonly tipTitle: "提示";
+    readonly confirm: "确定";
+    readonly cancel: "取消";
+    readonly confirmUnfavorite: "确认取消收藏该会话吗？";
+    readonly unfavoriteTitle: "取消收藏";
+    readonly historyTab: "历史会话";
+    readonly historyEmpty: "暂无会话记录";
+    readonly favoritesTab: "收藏会话";
+    readonly favoritesEmpty: "暂无收藏会话";
+    readonly deepAnalysis: "深度解读";
+    readonly summaryAnalysis: "概要解读";
+    readonly headerClose: "关闭";
+    readonly deepThinking: "深度思考";
+    readonly skill: "技能";
+    readonly knowledge: "知识库";
+    readonly supportedExtensions: "支持扩展名：{{types}}";
+    readonly empty: "暂无数据";
+    readonly selectFile: "选择文件";
+    readonly unsupportedType: "不支持的文件类型：{{fileName}} ({{fileType}})";
+    readonly maxFileCountExceed: "【{{fileName}}】所属类型最多只能上传 {{max}} 个文件";
+    readonly maxFileSizeExceed: "文件大小不能超过 {{max}} MB";
+    readonly waitUpload: "请等待所有文件上传完成";
+    readonly checkFailed: "请检查上传失败的文件";
+    readonly dropTitle: "将文件放到这里";
+    readonly uploadTitle: "提交文件";
+    readonly uploadDescription: "单击或拖动文件到此区域进行上传";
+    readonly chatPlaceholder: "今天帮你做些什么？";
+    readonly selectPlaceholder: "请选择...";
+    readonly unnamedReport: "未命名报告";
+    readonly unnamedChart: "未命名图表";
+    readonly unnamedTable: "未命名表格";
+    readonly unnamedContent: "未命名内容";
+    readonly chart: "图表";
+    readonly exportPng: "导出PNG";
+    readonly report: "报告";
+    readonly exportMd: "导出MD";
+    readonly table: "表格";
+    readonly exportCsv: "导出CSV";
+    readonly exportJson: "导出JSON";
+    readonly boolYes: "是";
+    readonly boolNo: "否";
+    readonly formTitle: "表单";
+    readonly stepIndicator: "步骤 {{current}}/{{total}}";
+    readonly prevStep: "上一步";
+    readonly nextStep: "下一步";
+    readonly submit: "提交";
+    readonly submitFailed: "提交失败，请稍后重试";
+    readonly questionCancelled: "Question: 已取消";
+    readonly questionAnswered: "Question: 已回答";
+    readonly questionDetails: "Question: {{details}}";
+    readonly basicInfoSubmitted: "已提交基础信息";
+    readonly paramsSubmitted: "已提交参数配置";
+    readonly backToBasic: "已返回修改基础信息";
+    readonly backToParams: "已返回修改参数";
+    readonly createConfirmed: "已确认创建";
+    readonly actionSelected: "已选择";
+    readonly actionSubmitted: "已提交";
+    readonly actionSubmittedNamed: "已提交动作 ({{name}})";
+    readonly quotedMessage: "【引用消息】：";
+    readonly answered: "已回答";
+    readonly inputGenerating: "输入生成中";
+    readonly inputParams: "输入参数";
+    readonly outputResult: "返回结果";
+    readonly subAgentRunning: "子智能体执行中...";
+    readonly subAgentNested: "子智能体执行内容（嵌套层级 {{depth}}，已折叠）";
+    readonly noTasks: "暂无任务";
+    readonly clickHere: "点击此处";
+    readonly unsupportedChart: "不支持的图表";
+    readonly unsupportedChartDesc: "当前图表类型 \"{{type}}\" 暂未实现，请检查图表类型是否正确。";
+    readonly previewEdit: "预览编辑";
+    readonly copy: "复制";
+    readonly continueText: "继续";
+    readonly noVariables: "暂无可用变量";
+    readonly dateToday: "今天";
+    readonly dateLast7Days: "最近 7 天";
+    readonly dateLast30Days: "最近 30 天";
+    readonly dateLastHalfYear: "最近半年";
+    readonly dateEarlier: "更早";
+    readonly previewNotSupported: "当前环境不支持预览";
+    readonly deleteSuccess: "删除成功";
+    readonly operationBlocked: "操作被阻止";
+    readonly favoriteSuccess: "收藏成功";
+    readonly unfavoriteSuccess: "已取消收藏";
+    readonly feedbackThanks: "感谢您的反馈";
+    readonly sendFailed: "发送失败，请重试";
+    readonly newConversationTitle: "新会话";
+    readonly stopped: "已停止";
+    readonly greetingHello: "你好，我是";
+    readonly greetingSubtitle: "今天想探索点什么？";
+    readonly disclaimer: "内容由AI生成，仅供参考，请仔细甄别";
+    readonly helloIam: "你好，我是{{name}}";
+    readonly newConversation: "新建会话";
+    readonly uploadFromLocal: "从本地上传";
+    readonly edit: "编辑";
+    readonly noUserInputFields: "暂无用户输入字段";
+    readonly startConversation: "开始会话";
+};
+
+export { type AgentConfig, type AgentExecMode, type AgentInfo, type AgentSpec, _default$1 as Attachments, type AttachmentsProps, type ChatConfig, _default as ChatCopilot, type ChatHandle, type ChatHooks, type ChatLayout, type ChatParams, type ChatProps, _default$2 as ChatSender, type ChatServices, type ConversationMessage, type ConversationMessageSend, type ConversationStrategy, type CustomButtonProps, type FileTextType, type FileUploadConfig, type FileUrlType, type InputFile, type MessageRenderProps, NS_CHAT_COPILOT, type ReferencesType, type RequestInstance, type SenderProps, WorkspaceTypeEnum, chatCopilotEnUS, chatCopilotJaJP, chatCopilotZhCN, getFileIcon, getFileUrl };