@blueking/chat-x 2.4.0 → 2.4.1

package/dist/components/chat-content/flow-agent-content/flow-agent-state.d.ts

@@ -1,12 +1,19 @@
 import { type VNode } from 'vue';
 /** 归一后的执行状态 */
-export type ConvergedState = 'failed' | 'pending' | 'running' | 'skipped' | 'success' | 'suspended';
+export type ConvergedState = 'failed' | 'pending' | 'running' | 'skipped' | 'success' | 'suspended' | 'terminated';
 /** 单个归一状态的完整定义 */
-interface FlowStateDef {
-    /** 状态主题色，供统计标签文字与图标语义复用 */
+export interface FlowStateDef {
+    /** 状态主题色，供统计标签文字、整体 header 文案与图标语义复用 */
     color: string;
-    /** 节点状态点的边框色，缺省回退到 color（仅 pending 与主题色不同） */
+    /** 节点 / 统计圆点的边框色，缺省回退到 color（仅 pending 与主题色不同） */
     dotColor?: string;
+    /** 节点 / 统计圆点的填充色；缺省透明（空心环）。已终止等实心底圆点在此声明 */
+    dotFill?: string;
+    /**
+     * 任一任务 task_state 命中该状态时，标题栏前置该标签并括号包裹统计。
+     * 后续若有同类「整体覆盖态」，只需在对应 def 上打开此标记。
+     */
+    flowHeader?: boolean;
     /** 状态图标（VNode）；running 走 Loading 动画，故为 null */
     icon: null | VNode;
     /** 归一状态标识 */
@@ -15,20 +22,30 @@ interface FlowStateDef {
     label: string;
     /** 归一到该状态的后端原始状态枚举 */
     rawStates: string[];
+    /** 是否出现在标题栏 / tooltip 统计；缺省 true */
+    showInStats?: boolean;
 }
 /**
  * 执行状态唯一配置源（Single Source of Truth）。
- * 新增 / 调整状态只需维护此处：归一映射、统计标签、颜色、图标均由它派生，
+ * 新增 / 调整状态只需维护此处：归一映射、统计标签、颜色、图标、整体 header 覆盖均由它派生，
  * 避免状态逻辑散落在组件与 SCSS 多处。
  * 数组顺序即统计概览（visibleStats）的展示顺序。
  */
 export declare const STATE_DEFS: FlowStateDef[];
 /** 后端原始状态归一；未知状态回退 running（保持原有行为） */
 export declare const getConvergedState: (rawState: string) => ConvergedState;
+/**
+ * 根据任务原始状态扫描整体 header 覆盖定义。
+ * 只遍历 task_state（O(任务数)），命中首个 flowHeader 即返回。
+ */
+export declare const getFlowHeaderDef: (rawTaskStates: Iterable<string>) => FlowStateDef | undefined;
+/** 是否进入标题栏 / tooltip 统计；未声明时默认展示 */
+export declare const isShownInStats: (def: FlowStateDef) => boolean;
 /** 状态主题色（用于统计标签文字） */
 export declare const getStateColor: (state: ConvergedState) => string;
-/** 节点状态点边框色 */
+/** 节点 / 统计圆点边框色 */
 export declare const getStateDotColor: (state: ConvergedState) => string;
+/** 节点 / 统计圆点填充色；未声明时返回 undefined，保持空心环 */
+export declare const getStateDotFill: (state: ConvergedState) => string | undefined;
 /** 取状态图标，返回深拷贝的 VNode 以支持多处复用；running 无图标返回 null */
 export declare const getStateIcon: (state: ConvergedState) => null | VNode;
-export {};

package/dist/components/chat-content/flow-agent-content/use-flow-agent.d.ts

@@ -1,10 +1,12 @@
 import { type ComputedRef, type Ref, type VNode } from 'vue';
-import { type ConvergedState } from './flow-agent-state';
 import type { BkFlowMessageContent, BkFlowNode, BkFlowTask } from '../../../ag-ui/types/contents';
+import type { ConvergedState, FlowStateDef } from './flow-agent-state';
 /** 节点视图模型：模板直接消费，避免重复 Object.values / 状态归一 / 时间格式化 */
 export interface FlowNodeVM {
     convergedState: ConvergedState;
     dotColor: string;
+    /** 实心底圆点填充色；空心环时缺省 */
+    dotFill?: string;
     elapsedTimeText: string;
     id: string;
     name: string;
@@ -21,6 +23,8 @@ export interface FlowStatVM {
     display: string;
     /** 状态圆点（环）边框色，pending 等需与文字色区分时回退到独立 dotColor */
     dotColor: string;
+    /** 实心底圆点填充色；空心环时缺省 */
+    dotFill?: string;
     key: ConvergedState;
     label: string;
 }
@@ -43,6 +47,7 @@ export interface FlowTaskVM {
  * 纯派生逻辑（不依赖注入），便于复用与单测。
  */
 export declare const useFlowAgent: (contentRef: Ref<BkFlowMessageContent | undefined>) => {
+    flowHeaderDef: ComputedRef<FlowStateDef | undefined>;
     isTaskExpanded: (task: BkFlowTask) => boolean;
     taskList: ComputedRef<BkFlowTask[]>;
     toggleTaskExpanded: (task: BkFlowTask) => void;

package/dist/icons/execution.d.ts

@@ -4,6 +4,10 @@ export declare const BkFlowSuccessIcon: import("vue").VNode<import("vue").Render
 export declare const BkFlowFailedIcon: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>;
+/** 已终止（REVOKED）任务图标，来自设计稿节点 2013:4495，保留 14×14 原始 path */
+export declare const BkFlowTerminatedIcon: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>;
 export declare const BkFlowSuspendedIcon: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>;