@zero-library/chat-copilot 3.1.10 → 3.1.12

package/dist/index.d.mts

@@ -55,7 +55,7 @@ interface FileUploadConfig {
 }
 interface AgentSpec {
     model?: ModelConfig;
-    knowledge?: {
+    knowledges?: {
         items: {
             id: string;
             name: string;
@@ -370,6 +370,64 @@ interface ConversationNewTitleEvent {
     type: 'conversationNewTitle';
     title: string;
 }
+interface DisplayMeta {
+    label: string;
+    value: string;
+}
+interface DisplayKvItem {
+    label: string;
+    value: string;
+}
+interface DisplayLinkItem {
+    title: string;
+    url: string;
+    summary?: string;
+}
+type DisplayStatusLevel = 'info' | 'success' | 'warning' | 'error';
+type DisplayBlock = {
+    kind: 'markdown';
+    title?: string;
+    content: string;
+} | {
+    kind: 'code';
+    title?: string;
+    content: string;
+    lang: string;
+} | {
+    kind: 'key_value';
+    title?: string;
+    items: DisplayKvItem[];
+} | {
+    kind: 'links';
+    title?: string;
+    items: DisplayLinkItem[];
+} | {
+    kind: 'status';
+    level: DisplayStatusLevel;
+    text: string;
+};
+/** 完整展示视图 — ToolCall/ToolResult 事件携带，全量替换语义 */
+interface DisplayView {
+    /** 简短标题（文件路径、命令首行等） */
+    title: string;
+    /** 标题下的一句话摘要 */
+    summary?: string;
+    /** 通用展示块 */
+    blocks?: DisplayBlock[];
+    /** 简短元信息 */
+    meta?: DisplayMeta[];
+}
+/** 流式展示增量 — ToolCallDelta 事件携带，增量追加语义 */
+interface DisplayDelta {
+    /** 标题变更（首次设置或变化时发送，前端直接替换） */
+    title?: string;
+    /** 内容追加片段（节流后发送，前端追加到末尾） */
+    contentAppend?: string;
+    /** 流式内容类型 */
+    kind?: 'markdown' | 'code' | 'text';
+    /** code 类型语言 */
+    lang?: string;
+}
 interface ToolCallEvent {
     type: 'toolCall';
     toolCallId?: string;
@@ -382,6 +440,29 @@ interface ToolCallEvent {
     content?: string;
     /** 工具调用参数 */
     arguments?: any;
+    /** 完整展示视图（全量替换语义，未实现 display 方法的工具为 null） */
+    display?: DisplayView | null;
+    /** 执行状态 */
+    status?: 'pending' | 'running' | 'success' | 'error';
+    /** 该工具是否触发了子智能体（前端动态判断：有 toolCallId 的子消息到达时标记） */
+    hasSubAgent?: boolean;
+    /** 前端内部标记：是否使用 display 协议渲染 */
+    displayProtocol?: boolean;
+}
+interface ToolCallDeltaEvent {
+    type: 'toolCallDelta';
+    toolCallId?: string;
+    toolName?: string | null;
+    /** 工具图标 */
+    toolIcon?: string;
+    /** 工具调用标题 */
+    title?: string;
+    /** 同一消息中多个工具调用的序号 */
+    index?: number;
+    /** 增量参数字符串，需追加拼接 */
+    argumentsDelta?: string;
+    /** 流式展示增量（增量追加语义，无变化时不出现此字段） */
+    displayDelta?: DisplayDelta;
     /** 执行状态 */
     status?: 'pending' | 'running' | 'success' | 'error';
 }
@@ -397,10 +478,16 @@ interface ToolResultEvent {
     content?: string;
     /** 工具执行结果 */
     result?: any;
+    /** 完整展示视图（结果阶段全量替换语义） */
+    display?: DisplayView | null;
     /** 执行状态 */
     status?: 'pending' | 'running' | 'success' | 'error';
+    /** 是否出错（与 status='error' 始终一致，推荐使用此字段） */
+    isError?: boolean;
     errorMessage?: string;
     /** 耗时(ms) */
+    durationMs?: number;
+    /** 兼容旧字段名 */
     duration?: number;
 }
 interface A2uiCommandEvent {
@@ -428,7 +515,7 @@ interface CitationEvent {
     type: 'citation';
     citations?: Citation[];
 }
-type MessageEvent = RunStartedEvent | TextEvent | FilesEvent | StepStartedEvent | StepFinishedEvent | StepErrorEvent | RunFinishedEvent | RunStoppedEvent | ConversationNewTitleEvent | ToolCallEvent | ToolResultEvent | RunFailedEvent | A2uiCommandEvent | A2uiSchemaEvent | PlanEvent | CitationEvent;
+type MessageEvent = RunStartedEvent | TextEvent | FilesEvent | StepStartedEvent | StepFinishedEvent | StepErrorEvent | RunFinishedEvent | RunStoppedEvent | ConversationNewTitleEvent | ToolCallEvent | ToolCallDeltaEvent | ToolResultEvent | RunFailedEvent | A2uiCommandEvent | A2uiSchemaEvent | PlanEvent | CitationEvent;
 /**
  * 消息类型
  * 定义智能体和用户之间的消息结构
@@ -460,6 +547,14 @@ interface ConversationMessage {
     stopFlag?: boolean;
     /** 是否正在生成中 */
     generating?: boolean;
+    /** 子智能体名称，前端展示用 */
+    subAgentName?: string;
+    /** 父执行 ID，用于关联到主智能体的执行 */
+    parentExecutionId?: string;
+    /** 嵌套深度（0=顶层，1=一级子智能体） */
+    subAgentDepth?: number;
+    /** 父 agent_spawn 工具调用 ID，前端通过此字段将子智能体消息归属到对应工具块 */
+    toolCallId?: string;
 }
 
 /**

package/dist/index.d.ts

@@ -55,7 +55,7 @@ interface FileUploadConfig {
 }
 interface AgentSpec {
     model?: ModelConfig;
-    knowledge?: {
+    knowledges?: {
         items: {
             id: string;
             name: string;
@@ -370,6 +370,64 @@ interface ConversationNewTitleEvent {
     type: 'conversationNewTitle';
     title: string;
 }
+interface DisplayMeta {
+    label: string;
+    value: string;
+}
+interface DisplayKvItem {
+    label: string;
+    value: string;
+}
+interface DisplayLinkItem {
+    title: string;
+    url: string;
+    summary?: string;
+}
+type DisplayStatusLevel = 'info' | 'success' | 'warning' | 'error';
+type DisplayBlock = {
+    kind: 'markdown';
+    title?: string;
+    content: string;
+} | {
+    kind: 'code';
+    title?: string;
+    content: string;
+    lang: string;
+} | {
+    kind: 'key_value';
+    title?: string;
+    items: DisplayKvItem[];
+} | {
+    kind: 'links';
+    title?: string;
+    items: DisplayLinkItem[];
+} | {
+    kind: 'status';
+    level: DisplayStatusLevel;
+    text: string;
+};
+/** 完整展示视图 — ToolCall/ToolResult 事件携带，全量替换语义 */
+interface DisplayView {
+    /** 简短标题（文件路径、命令首行等） */
+    title: string;
+    /** 标题下的一句话摘要 */
+    summary?: string;
+    /** 通用展示块 */
+    blocks?: DisplayBlock[];
+    /** 简短元信息 */
+    meta?: DisplayMeta[];
+}
+/** 流式展示增量 — ToolCallDelta 事件携带，增量追加语义 */
+interface DisplayDelta {
+    /** 标题变更（首次设置或变化时发送，前端直接替换） */
+    title?: string;
+    /** 内容追加片段（节流后发送，前端追加到末尾） */
+    contentAppend?: string;
+    /** 流式内容类型 */
+    kind?: 'markdown' | 'code' | 'text';
+    /** code 类型语言 */
+    lang?: string;
+}
 interface ToolCallEvent {
     type: 'toolCall';
     toolCallId?: string;
@@ -382,6 +440,29 @@ interface ToolCallEvent {
     content?: string;
     /** 工具调用参数 */
     arguments?: any;
+    /** 完整展示视图（全量替换语义，未实现 display 方法的工具为 null） */
+    display?: DisplayView | null;
+    /** 执行状态 */
+    status?: 'pending' | 'running' | 'success' | 'error';
+    /** 该工具是否触发了子智能体（前端动态判断：有 toolCallId 的子消息到达时标记） */
+    hasSubAgent?: boolean;
+    /** 前端内部标记：是否使用 display 协议渲染 */
+    displayProtocol?: boolean;
+}
+interface ToolCallDeltaEvent {
+    type: 'toolCallDelta';
+    toolCallId?: string;
+    toolName?: string | null;
+    /** 工具图标 */
+    toolIcon?: string;
+    /** 工具调用标题 */
+    title?: string;
+    /** 同一消息中多个工具调用的序号 */
+    index?: number;
+    /** 增量参数字符串，需追加拼接 */
+    argumentsDelta?: string;
+    /** 流式展示增量（增量追加语义，无变化时不出现此字段） */
+    displayDelta?: DisplayDelta;
     /** 执行状态 */
     status?: 'pending' | 'running' | 'success' | 'error';
 }
@@ -397,10 +478,16 @@ interface ToolResultEvent {
     content?: string;
     /** 工具执行结果 */
     result?: any;
+    /** 完整展示视图（结果阶段全量替换语义） */
+    display?: DisplayView | null;
     /** 执行状态 */
     status?: 'pending' | 'running' | 'success' | 'error';
+    /** 是否出错（与 status='error' 始终一致，推荐使用此字段） */
+    isError?: boolean;
     errorMessage?: string;
     /** 耗时(ms) */
+    durationMs?: number;
+    /** 兼容旧字段名 */
     duration?: number;
 }
 interface A2uiCommandEvent {
@@ -428,7 +515,7 @@ interface CitationEvent {
     type: 'citation';
     citations?: Citation[];
 }
-type MessageEvent = RunStartedEvent | TextEvent | FilesEvent | StepStartedEvent | StepFinishedEvent | StepErrorEvent | RunFinishedEvent | RunStoppedEvent | ConversationNewTitleEvent | ToolCallEvent | ToolResultEvent | RunFailedEvent | A2uiCommandEvent | A2uiSchemaEvent | PlanEvent | CitationEvent;
+type MessageEvent = RunStartedEvent | TextEvent | FilesEvent | StepStartedEvent | StepFinishedEvent | StepErrorEvent | RunFinishedEvent | RunStoppedEvent | ConversationNewTitleEvent | ToolCallEvent | ToolCallDeltaEvent | ToolResultEvent | RunFailedEvent | A2uiCommandEvent | A2uiSchemaEvent | PlanEvent | CitationEvent;
 /**
  * 消息类型
  * 定义智能体和用户之间的消息结构
@@ -460,6 +547,14 @@ interface ConversationMessage {
     stopFlag?: boolean;
     /** 是否正在生成中 */
     generating?: boolean;
+    /** 子智能体名称，前端展示用 */
+    subAgentName?: string;
+    /** 父执行 ID，用于关联到主智能体的执行 */
+    parentExecutionId?: string;
+    /** 嵌套深度（0=顶层，1=一级子智能体） */
+    subAgentDepth?: number;
+    /** 父 agent_spawn 工具调用 ID，前端通过此字段将子智能体消息归属到对应工具块 */
+    toolCallId?: string;
 }
 
 /**