@blueking/bkflow-canvas-editor 1.1.0-beta.9 → 1.2.0-beta.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as vue from 'vue';
-import { ComputedRef, Ref } from 'vue';
+import { Component, ComputedRef, Ref } from 'vue';
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 import * as _blueking_flow_canvas from '@blueking/flow-canvas';
 import { ZoomToFitOptions, CanvasUiEvent, QuickAddConfig, CanvasSchema, FlowModel, FlowNodeModel, NodeActionsConfig, ConnectionValidator, CanvasPlugin, CanvasToolbarItem, CommandEnvelope } from '@blueking/flow-canvas';
@@ -17,12 +17,7 @@ interface FlowApiConfig {
     /** CSRF cookie 名称（可选，用于创建新的 axios 实例时设置 xsrfCookieName） */
     xsrfCookieName?: string;
     /** 作用域数据（必需，由外部传入） */
-    scopeData: {
-        scope_type: string;
-        scope_value: number;
-        /** 业务方传入的空间 ID，调试接口专用，语义独立于 scope_value */
-        space_id: number;
-    };
+    scopeData: ScopeData;
     /**
      * 用户查询 API 地址（可选）
      * @deprecated 请改用 FlowEdit/FlowView 顶层组件的 `memberSelectorConfig.fetchUserApi`。
@@ -32,6 +27,12 @@ interface FlowApiConfig {
     /** 是否启用第三方插件（可选，默认为 true） */
     enableThirdPlugin?: boolean;
 }
+interface ScopeData {
+    scope_type: string;
+    scope_value: number;
+    /** 业务方传入的空间 ID，语义独立于 scope_value。 */
+    space_id: number;
+}
 
 type __VLS_Slots$7 = {
     header?: () => any;
@@ -111,6 +112,11 @@ interface NodeExecutionState {
     actions?: ExecutionNodeAction[];
     /** 兼容旧版后端直接透出的动作数组字段 */
     action_list?: ExecutionNodeAction[];
+    /**
+     * 条件网关命中的出边 flow_id。
+     * 有值时执行态连线优先按它着色，不要求目标节点已经执行（网关单步不会跑下游）。
+     */
+    selectedFlowIds?: string[];
 }
 type TaskExecutionStates = Record<string, NodeExecutionState>;
 
@@ -118,7 +124,7 @@ type PortOrientation = 'Top' | 'Right' | 'Bottom' | 'Left';
 
 type GatewayType = 'ExclusiveGateway' | 'ParallelGateway' | 'ConditionalParallelGateway' | 'ConvergeGateway';
 
-type NodeType = StartEvent | EndEvent | Activity | Gateway;
+type NodeType = StartEvent | EndEvent | Activity | SubProcessActivity | Gateway;
 
 interface PluginInputDataItem {
   value:
@@ -164,29 +170,122 @@ interface Activity {
   type: 'ServiceActivity';
   retryable: boolean;
   skippable: boolean;
+  /** 是否可选节点（执行时可选跳过）默认 true */
+  optional: boolean;
+  auto_retry: {
+    enable: boolean;
+    interval: number;
+    times: number;
+  };
+  timeout_config: {
+    enable: boolean;
+    seconds: number;
+    action: string;
+  };
+  status?: NodeExecutionStatus;
+  /** 执行态：实际重试次数 */
+  retry?: number;
+  /** 执行态：是否被跳过 */
+  skip?: boolean;
+  /** 执行态：是否自动忽略错误 */
+  error_ignored?: boolean;
+  /** 执行态：循环执行次数（未执行时为 null，与 SubProcessActivity 同源于执行态接口） */
+  loop?: number | null;
+  /** 执行态：生命周期阶段 */
+  phase?: number;
+}
+
+/**
+ * 循环执行配置（子流程 / 循环容器节点的 loop_config）
+ */
+interface LoopConfig {
+  /** 是否启用循环执行 */
+  enable: boolean;
+  /** array_loop 按数组变量循环 / time_loop 固定循环次数 */
+  type: 'array_loop' | 'time_loop';
+  /** 固定循环次数（time_loop，默认 3，最大 100）；array_loop 且数据来源含变量时为 null */
+  loop_times?: number | null;
+  /**
+   * 数组循环变量（array_loop）：循环变量名 → 数据来源。
+   * 编辑态为 UI 数组 [{name, value}]；保存输出为 key-value 对象（如 { '${loop_test1}': '1,2' }）。
+   */
+  loop_params?: { name: string; value: string }[] | Record<string, string>;
+  /** 循环失败自动跳过（AS） */
+  fail_skip?: boolean;
+  /** 循环失败手动重试（MR） */
+  retryable?: boolean;
+  /** 循环失败手动跳过（MS） */
+  skippable?: boolean;
+  /** 循环输出变量outputs */
+  outputs_key?: string;
+  [key: string]: any;
+}
+
+/**
+ * 子流程（SubProcess）活动节点。
+ */
+interface SubProcessActivity {
+  id: string;
+  name: string;
+  stage_name?: string;
+  incoming: string[];
+  outgoing: string;
+  type: 'SubProcess';
+  /** 被引用的模板 ID */
+  template_id: string | number;
+  /** 模板版本 */
+  version?: string;
+  /** 变量映射常量 */
+  constants?: Record<string, any>;
+  /** 是否始终使用最新版本 */
+  always_use_latest?: boolean;
+  /** 生效版本方案列表 */
+  scheme_id_list?: string[];
+  /** 模板来源 */
+  template_source?: string;
+  /** 是否自动忽略错误（AS） */
+  error_ignorable: boolean;
+  /** 是否可手动重试（MR） */
+  retryable: boolean;
+  /** 是否可手动跳过（MS） */
+  skippable: boolean;
+  /** 是否可选节点（执行时可选跳过）BKFlow 必填 */
+  optional: boolean;
+  /** 已勾选（关联全局变量）的 key 列表 */
+  hooked_constants?: string[];
+  /** 自动重试配置（AR） */
   auto_retry: {
     enable: boolean;
     interval: number;
     times: number;
   };
+  /** 超时控制配置 */
   timeout_config: {
     enable: boolean;
     seconds: number;
     action: string;
   };
+  /** 循环执行配置 */
+  loop_config?: LoopConfig;
+  /** 父级分组 ID（SubCanvas 循环容器嵌套场景），顶层节点为 null */
+  parent?: string | null;
+  /** 节点标签 */
+  labels?: string[];
   status?: NodeExecutionStatus;
+  /** 执行态：循环执行次数（未执行时为 null） */
+  loop?: number | null;
   /** 执行态：实际重试次数 */
   retry?: number;
   /** 执行态：是否被跳过 */
   skip?: boolean;
   /** 执行态：是否自动忽略错误 */
   error_ignored?: boolean;
-  /** 执行态：循环执行次数 */
-  loop?: number;
   /** 执行态：生命周期阶段 */
   phase?: number;
 }
 
+type ActivityUnion = Activity | SubProcessActivity;
+
 interface StartEvent {
   id: string;
   name: string;
@@ -243,6 +342,7 @@ interface Location {
     | 'startpoint'
     | 'endpoint'
     | 'tasknode'
+    | 'subflow'
     | 'branchgateway'
     | 'convergegateway'
     | 'parallelgateway'
@@ -297,7 +397,7 @@ interface Variable {
 }
 
 interface PipelineTree {
-  activities: Record<string, Activity>;
+  activities: Record<string, ActivityUnion>;
   end_event: EndEvent;
   flows: Record<string, Flow>;
   gateways: Record<string, Gateway>;
@@ -415,6 +515,42 @@ interface UniformApiPluginInputsItem$1 {
   _slots?: Record<string, SlotFieldConfig | SlotArgConfig>;
 }
 
+interface SubflowTemplateItem {
+    id: number | string;
+    name: string;
+    /** 模板版本（不传则默认使用最新版本） */
+    version?: string;
+    /** 展示用副文本（如更新时间 / 描述等，可选） */
+    description?: string;
+    /** 兼容接入方列表接口的扩展字段 */
+    [key: string]: any;
+}
+interface SubflowUpdateItem {
+    /** 子流程节点 ID（对应 pipeline_tree.activities 的 key） */
+    nodeId: string;
+    /** 该节点引用的子流程模板是否有新版本（true 时节点显示红点并计入提示条） */
+    expired: boolean;
+    /** 子流程模板名称（可选，仅作提示展示） */
+    templateName?: string;
+    /** 兼容接入方的扩展字段 */
+    [key: string]: any;
+}
+interface SubprocessInfoItem {
+    /** 子流程模板 ID */
+    subprocess_template_id: string | number;
+    /** 子流程节点 ID（对应 pipeline_tree.activities 的 key） */
+    subprocess_node_id: string;
+    /** 节点当前引用的子流程模板版本 */
+    version: string;
+    /** 是否总是使用最新版本 */
+    always_use_latest: boolean;
+    /** 引用的子流程模板是否有新版本 */
+    expired: boolean;
+    /** 子流程模板名称 */
+    subprocess_template_name?: string;
+    /** 兼容接入方的扩展字段 */
+    [key: string]: any;
+}
 interface FlowTemplate {
     id: number;
     name: string;
@@ -424,6 +560,8 @@ interface FlowTemplate {
     extra_info: Record<string, any>;
     triggers: TriggerItem[];
     version: string;
+    /** 子流程更新信息（后端计算好 expired 状态，SDK 据此渲染红点/提示条） */
+    subprocess_info?: SubprocessInfoItem[];
 }
 interface FlowDetailByVersion {
     constants_not_referred: Record<string, Variable>;
@@ -697,13 +835,181 @@ interface CustomVariableType {
     code: string;
 }
 
+/**
+ * filter 变量的宿主配置契约与注入。
+ *
+ * `RetrievalFilterField` 与 `getValues` 的返回结构和宿主
+ * `src/components/bk-monitor-retieval-filter/types.d.ts` 里的 `IFilterField`
+ * 逐字段一致——依赖包不带 `.d.ts`，宿主已经自己维护了一份，这里刻意同源，
+ * 避免出现两套形状相近但不兼容的类型。
+ */
+
+/**
+ * 关联节点的插件配置摘要。getFields 在节点表单未挂载时要用它自行取维度，
+ * 不能依赖「打开过节点配置」留下的内存缓存。
+ */
+interface FilterVariableSourceNodeComponent {
+    code?: string;
+    api_meta?: {
+        id?: string;
+    };
+    data?: Record<string, {
+        value?: unknown;
+    }>;
+}
+/** 关联来源。创建时由宿主锁定，用户不能在编辑器里改 */
+interface FilterVariableSourceContext {
+    sourceNodeId: string;
+    sourceNodeName: string;
+    /** 关联表单项稳定 KEY，例如 query_condition */
+    sourceFieldKey: string;
+    sourceFieldName: string;
+    /** 关联节点当前 component，供宿主 getFields 在节点配置未打开时解析 */
+    sourceNodeComponent?: FilterVariableSourceNodeComponent;
+}
+interface RetrievalFilterField {
+    alias: string;
+    name: string;
+    type: string;
+    isEnableOptions?: boolean;
+    methods: Array<{
+        alias: string;
+        value: string;
+        placeholder?: string;
+        wildcardValue?: string;
+        options?: unknown[];
+    }>;
+}
+/**
+ * 候选值查询参数。
+ *
+ * 这是适配器归一化之后的稳定形状：依赖组件内部有四条 `getValueFn` 调用路径，
+ * 参数形状互不一致（`search`/`field`/`isInit__` vs `where` + `operator` vs
+ * `where` + `method`），禁止把 raw params 直接透给宿主。升级依赖时需重新核对。
+ */
+interface FilterCandidateQuery {
+    field?: string;
+    keyword?: string;
+    limit?: number;
+    method?: string;
+    /** 通配搜索路径会带 `options.is_wildcard`，宿主据此选择精确或模糊匹配 */
+    isWildcard?: boolean;
+}
+interface FilterVariableConfig {
+    /**
+     * 宿主注入的 **原始** `RetrievalFilter` 组件，即
+     * `import { RetrievalFilter } from '@blueking/monitor-vue3-components'`。
+     *
+     * 必须是原始组件而不是宿主自己的封装（例如 bk-incident 的
+     * `BkMonitorRetievalFilter`）：封装层 props 是 `filters/fieldList/query`、事件是
+     * `change`，与适配器传入的 `fields/where` + `whereChange` 不兼容；且它的
+     * `getValueFn` 只透传 `fields`，会丢掉搜索关键词，候选值搜索无法工作。
+     *
+     * 编辑器不把该依赖列入自身 dependencies，所以拿不到注入就是不可用。
+     */
+    retrievalFilterComponent: Component;
+    getFields(source: FilterVariableSourceContext): Promise<RetrievalFilterField[]>;
+    getValues(source: FilterVariableSourceContext, params: FilterCandidateQuery): Promise<{
+        count: number;
+        list: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>;
+    /** 传给依赖组件的 `zIndex`，用于让候选值弹层盖在侧滑之上 */
+    popupZIndex?: number;
+    loadDelay?: number;
+    limit?: number;
+}
+/**
+ * 在顶层组件中提供 FilterVariableConfig。
+ *
+ * 与 `provideMemberSelectorConfig` 一致：`config` 为 undefined 时不调用 provide，
+ * 避免遮蔽父级已提供的配置。
+ */
+declare function provideFilterVariableConfig(config?: FilterVariableConfig): void;
+
+/**
+ * filter（复合条件选择）变量的领域逻辑。
+ *
+ * `Variable.value` 直接就是提交给后端的条件数组 `{ key, operator, value, options }[]`，
+ * 不引入编辑态中间形状：编辑器与依赖组件之间只有一处命名差异（`operator` ⇄ `method`），
+ * 那一次转换收在适配器边界上（见 retrieval-filter-adapter/index.vue）。
+ *
+ * 关联标识复用 `Variable.source_info`（C-09），不另立字段。既有的节点删除清理逻辑
+ * 原先只放行 component_inputs / component_outputs，已显式把 filter 一并纳入
+ * （canvas-adapter/plugin/index.ts 的节点删除，以及 node-config-sideslider 保存时
+ * 对照节点数据里是否还引用 `${var}`）。节点删掉或表单里取消引用后不清理，
+ * 就会留下用户无法修复的孤儿变量——关联信息是只读的。
+ */
+
+/**
+ * 条件值标量。
+ *
+ * 必须允许 number：依赖协议里 `value` 是 `number[] | string[]`，整型字段的候选值
+ * 就是数字，统一转成字符串会改变提交给后端的类型。
+ */
+type FilterConditionValue = string | number;
+/**
+ * 单条条件的附加选项。
+ *
+ * `is_wildcard`（通配匹配）与 `group_relation`（多值关系）由依赖组件在运算符的
+ * `methods[].options` 里声明、由用户勾选，并原样带在条件上。丢掉它等于静默改写
+ * 用户的选择，所以读写两侧都必须透传，也不做已知字段白名单。
+ */
+interface FilterConditionOptions {
+    is_wildcard?: boolean;
+    group_relation?: boolean;
+    [key: string]: unknown;
+}
+/** 单条条件，即 Variable.value 的元素。形状对齐宿主既有协议 */
+interface FilterWhereItem {
+    key: string;
+    operator: string;
+    value: FilterConditionValue[];
+    options?: FilterConditionOptions;
+}
+type FilterWhereValue = FilterWhereItem[];
+
+/**
+ * 全局变量受控创建的对外契约与守卫。
+ *
+ * filter 变量不能从普通「新建变量」入口创建——它必须携带关联节点与关联字段，
+ * 所以对外只暴露这一个方法，由宿主在节点表单里发起。
+ */
+
+interface OpenFilterVariableCreateRequest {
+    defaultCustomType: 'filter';
+    /** 关联来源，filter 场景必填 */
+    filterContext: FilterVariableSourceContext;
+    keyword?: string;
+    /**
+     * 可选：把宿主表单里已配好的真实维度条件带进来作为默认值。
+     * 已 hook 的 `${var}` 占位会被丢掉，不能当默认条件。
+     */
+    initialValue?: FilterWhereValue;
+    onCreated?: (variable: Variable) => void;
+}
+interface OpenStandardVariableCreateRequest {
+    defaultCustomType?: string;
+    filterContext?: never;
+    keyword?: string;
+    cursorIndex?: number;
+    onCreated?: (variable: Variable) => void;
+}
+type OpenGlobalVariableCreateRequest = OpenFilterVariableCreateRequest | OpenStandardVariableCreateRequest;
+
 /** 画布视口相关方法，供 FlowView / FlowEdit 对外透传 */
 interface CanvasViewportExpose {
     zoomToFit: (options?: ZoomToFitOptions) => void;
     centerContent: () => void;
     getZoom: () => number;
 }
-interface FlowEditExpose extends CanvasViewportExpose {
+/** 受控创建能力。返回 false 表示未通过同步守卫，开发态会打印具体原因 */
+interface GlobalVariableCreateExpose {
+    openGlobalVariableCreate: (request?: OpenGlobalVariableCreateRequest) => boolean;
+}
+interface FlowEditExpose extends CanvasViewportExpose, GlobalVariableCreateExpose {
     isFlowEdited: boolean;
     updateNodeInputParams: (inputParams: Record<string, PluginInputDataItem>) => void;
     openGlobalVariables: () => void;
@@ -711,7 +1017,7 @@ interface FlowEditExpose extends CanvasViewportExpose {
 interface FlowViewExpose extends CanvasViewportExpose {
 }
 /** FlowDetail 统一详情页对外暴露（设计 §7.1） */
-interface FlowDetailExpose extends CanvasViewportExpose {
+interface FlowDetailExpose extends CanvasViewportExpose, GlobalVariableCreateExpose {
     isFlowEdited: boolean;
     updateNodeInputParams: (inputParams: Record<string, PluginInputDataItem>) => void;
     openGlobalVariables: () => void;
@@ -720,13 +1026,12 @@ interface FlowDetailExpose extends CanvasViewportExpose {
 }
 
 type DebugContextStatus = 'idle' | 'running' | 'terminating';
-type DebugNodeStatus = 'not_run' | 'running' | 'waiting' | 'paused' | 'finished' | 'failed' | 'suspended' | 'skipped';
+type DebugNodeStatus = 'not_run' | 'running' | 'waiting' | 'paused' | 'finished' | 'failed' | 'revoked' | 'suspended' | 'skipped';
 type DebugExecutionMode = 'real' | 'mock';
 interface DebugMissingVar {
     key: string;
     source_node_id: string | null;
 }
-type DebugRunMode = DebugExecutionMode | 'mixed';
 type DebugRunType = 'global' | 'step';
 type DebugRunStatus = 'not_run' | 'running' | 'waiting' | 'paused' | 'terminating' | 'finished' | 'failed' | 'revoked';
 /** 运行级 / 节点级错误详情（last_error_detail、nodes[].error_detail）。 */
@@ -743,6 +1048,15 @@ interface DebugErrorDetail {
     failures?: DebugErrorFailure[];
     [key: string]: unknown;
 }
+/** 条件网关分支求值结果（`debug_context.nodes[].condition_results`）。 */
+interface DebugConditionResult {
+    flow_id: string;
+    name?: string;
+    expression?: string;
+    resolved_expression?: string;
+    matched?: boolean;
+    [key: string]: unknown;
+}
 interface DebugContextNode {
     node_id: string;
     node_type: string;
@@ -751,6 +1065,10 @@ interface DebugContextNode {
     can_step: boolean;
     missing_vars: DebugMissingVar[];
     waiting_reason?: string | null;
+    /** 是否支持单步调试；并行/汇聚网关为 false，仅用于展示全局调试状态。 */
+    supports_step?: boolean;
+    /** 是否支持 Mock；全部网关为 false。 */
+    supports_mock?: boolean;
     mock_result?: 'success' | 'fail' | null;
     error_detail?: DebugErrorDetail | string | null;
     duration_ms?: number | null;
@@ -762,6 +1080,10 @@ interface DebugContextNode {
     mock_outputs?: Record<string, unknown> | null;
     mock_error?: string | null;
     outputs?: Record<string, unknown> | null;
+    /** 条件网关命中的出边 flow_id；画布用它把命中连线标绿。 */
+    selected_flow_ids?: string[];
+    /** 条件网关每个分支的表达式与命中结果。 */
+    condition_results?: DebugConditionResult[];
 }
 /**
  * /debug_context/ 顶层结构。
@@ -800,28 +1122,10 @@ interface DebugInputSchema {
     constants?: Record<string, unknown>;
     [key: string]: unknown;
 }
-interface DebugHistoryRun {
-    task_id?: number | string | null;
-    operator?: string;
-    started_at?: string;
-    finished_at?: string;
-    status?: DebugRunStatus | string;
-    run_type?: DebugRunType;
-    run_mode?: DebugRunMode;
-    [key: string]: unknown;
-}
-interface DebugHistory {
-    runs?: DebugHistoryRun[];
-    [key: string]: unknown;
-}
 interface DebugResetImpact {
     reset_node_ids: string[];
     reasons?: Record<string, string>;
 }
-interface DebugGlobalVarsResult {
-    global_vars: Record<string, unknown>;
-    [key: string]: unknown;
-}
 interface UpdateNodeDebugMockResult {
     node_id: string;
     execution_mode: DebugExecutionMode;
@@ -835,6 +1139,8 @@ interface RunNodeDebugStepResult {
     error_detail?: unknown;
     updated_global_vars?: Record<string, unknown>;
     log_ref?: DebugContextNode['log_ref'];
+    selected_flow_ids?: string[];
+    condition_results?: DebugConditionResult[];
     [key: string]: unknown;
 }
 interface RunGlobalDebugResult {
@@ -842,19 +1148,22 @@ interface RunGlobalDebugResult {
     status: DebugContextStatus;
     [key: string]: unknown;
 }
+/**
+ * /debug_terminate/ 返回。
+ *
+ * 全局终止返回 `terminating`，需要继续轮询 /debug_context/ 直到 idle + last_run_status=revoked；
+ * 单节点终止直接返回 `idle`，并用 reset_node_ids 告知哪些节点被恢复为「未调试」。
+ */
 interface TerminateDebugResult {
     status?: DebugContextStatus;
+    /** 单节点终止：被恢复为 not_run 的节点，本地需同步清空输入、输出、耗时、错误与日志。 */
+    reset_node_ids?: string[];
     [key: string]: unknown;
 }
 interface DebugResetResult {
     reset_node_ids?: string[];
     [key: string]: unknown;
 }
-interface UpdateDebugContextVariableParams {
-    templateId: string | number;
-    key: string;
-    value: unknown;
-}
 interface UpdateNodeDebugMockParams {
     templateId: string | number;
     nodeId: string;
@@ -887,9 +1196,7 @@ interface ResetDebugResultParams {
 interface DebugApiServices {
     fetchDebugContext(templateId: string | number): Promise<DebugContext>;
     fetchDebugInputSchema(templateId: string | number): Promise<DebugInputSchema>;
-    fetchDebugHistory(templateId: string | number): Promise<DebugHistory>;
     fetchDebugResetImpact(templateId: string | number): Promise<DebugResetImpact>;
-    updateDebugContextVariable(params: UpdateDebugContextVariableParams): Promise<DebugGlobalVarsResult>;
     updateNodeDebugMock(params: UpdateNodeDebugMockParams): Promise<UpdateNodeDebugMockResult>;
     runNodeDebugStep(params: RunNodeDebugStepParams): Promise<RunNodeDebugStepResult>;
     runGlobalDebug(params: RunGlobalDebugParams): Promise<RunGlobalDebugResult>;
@@ -925,6 +1232,7 @@ interface FetchTaskStateParams {
 interface FetchTaskNodeDetailParams {
     task_id: number | string;
     node_id: string;
+    component_code?: string;
 }
 interface FetchTaskNodeSnapshotParams {
     task_id: number | string;
@@ -950,6 +1258,8 @@ interface FlowTaskDetail {
     id: number | string;
     template_id: number;
     pipeline_tree: PipelineTree;
+    /** 任务已耗时（秒），调试摘要弹层刷新恢复用。 */
+    elapsed_time?: number;
     [key: string]: unknown;
 }
 interface CreateFlowTaskParams {
@@ -1016,7 +1326,7 @@ interface FlowViewApiConfig {
         space_id: number;
     };
     fetchFlowDraftDetail?: (id: string) => Promise<FlowDraftDetail>;
-    fetchFlowDetailByVersion?: (id: string, version: string) => Promise<FlowDetailByVersion>;
+    fetchFlowDetailByVersion?: (id: string, version?: string) => Promise<FlowDetailByVersion>;
     fetchVariableRef?: (params: {
         template_id: number;
         activities: Record<string, any>;
@@ -1070,6 +1380,10 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     saveFlow: (id: string, params: UpdateFlowParams) => Promise<void>;
     fetchBkFlowInnerPluginList: () => Promise<BkflowInnerPluginMetaItem[]>;
     fetchBkFlowInnerPluginDetail: (code: string, version: string) => Promise<BkflowInnerPluginMetaItem>;
+    fetchSubprocessOutput: (params?: {
+        code?: string;
+        version?: string;
+    }) => Promise<BkflowInnerPluginMetaItem>;
     fetchInnerVariableDetail: (code: string) => Promise<BkflowInnerPluginMetaItem>;
     fetchBkFlowThirdPartyPluginList: (tag: number) => Promise<{
         data: {
@@ -1090,6 +1404,20 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchPluginGroupList: () => Promise<PluginGroupConfig[]>;
     fetchCategoryPlugins: (category: string) => Promise<PluginMetaItem[]>;
     fetchAllPluginGroups: () => Promise<GroupsPluginItem[]>;
+    /**
+     * 获取子流程模板列表
+     */
+    fetchSubflowTemplateList?: (params: {
+        /** 每页条数 */
+        limit: number;
+        /** 偏移量 */
+        offset: number;
+        /** 名称模糊搜索*/
+        keyword?: string;
+    }) => Promise<{
+        results: SubflowTemplateItem[];
+        count: number;
+    }>;
     enableThirdPlugin?: boolean;
     fetchPluginDetail?: (id: string) => Promise<UniformApiPluginDetail>;
     fetchApplyInstructionData?: (params: any) => Promise<any>;
@@ -1362,6 +1690,8 @@ type __VLS_Props$4 = {
     onExecuteSuccess?: (result: FlowTaskExecuteSuccessResult) => void;
     bkflowSaasUrl?: string;
     memberSelectorConfig?: MemberSelectorConfig;
+    /** 执行时填写 filter 变量条件所需的能力；不传则这类变量退化为只读文本 */
+    filterVariableConfig?: FilterVariableConfig;
 };
 declare const __VLS_base$4: vue.DefineComponent<__VLS_Props$4, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     close: (...args: any[]) => void;
@@ -1394,6 +1724,12 @@ declare namespace __create_task_vue {
   };
 }
 
+interface CreateVariablePayload {
+    keyword?: string;
+    cursorIndex?: number;
+    defaultCustomType?: string;
+}
+
 type __VLS_Slots$3 = {
     header?: () => any;
     inputParams?: (props: {
@@ -1432,6 +1768,8 @@ type __VLS_Props$3 = {
     useCustomDebugConfirm?: boolean;
     selectPanelConfig?: SelectPanelConfig;
     memberSelectorConfig?: MemberSelectorConfig;
+    /** 复合条件选择（filter）变量的宿主配置；不传则该类型变量不可用，其余功能不受影响 */
+    filterVariableConfig?: FilterVariableConfig;
     onSave?: (flowData: FlowTemplate) => void;
     onSaveSuccess?: () => void;
     onBack?: () => void;
@@ -1441,6 +1779,7 @@ type __VLS_Props$3 = {
         taskId: number | string;
         templateId: number | string;
     }) => void;
+    onSubflowView?: (template: SubflowTemplateItem) => void;
     enableVersion?: boolean;
     flowVersion?: string;
     defaultZoom?: number;
@@ -1449,11 +1788,13 @@ type __VLS_Props$3 = {
     quickAdd?: QuickAddConfig;
     /** 是否隐藏基础信息中的触发器配置表单，默认 false */
     hideTrigger?: boolean;
+    subflowUpdateList?: SubflowUpdateItem[];
 };
 declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$3, {
     isFlowEdited: ComputedRef<FlowEditExpose["isFlowEdited"]>;
     updateNodeInputParams: FlowEditExpose["updateNodeInputParams"];
     openGlobalVariables: FlowEditExpose["openGlobalVariables"];
+    openGlobalVariableCreate: FlowEditExpose["openGlobalVariableCreate"];
     zoomToFit: FlowEditExpose["zoomToFit"];
     centerContent: FlowEditExpose["centerContent"];
     getZoom: FlowEditExpose["getZoom"];
@@ -1467,10 +1808,8 @@ declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$3, {
     saveSuccess: () => any;
     exitEdit: () => any;
     debugBeforeClose: () => any;
-    createVariable: (payload: {
-        keyword: string;
-        cursorIndex: number;
-    }) => any;
+    createVariable: (payload: CreateVariablePayload) => any;
+    subflowView: (template: SubflowTemplateItem) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props$3> & Readonly<{
     onBack?: (() => any) | undefined;
     onSave?: ((flowData: FlowTemplate) => any) | undefined;
@@ -1481,10 +1820,8 @@ declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$3, {
     onSaveSuccess?: (() => any) | undefined;
     onExitEdit?: (() => any) | undefined;
     onDebugBeforeClose?: (() => any) | undefined;
-    onCreateVariable?: ((payload: {
-        keyword: string;
-        cursorIndex: number;
-    }) => any) | undefined;
+    onCreateVariable?: ((payload: CreateVariablePayload) => any) | undefined;
+    onSubflowView?: ((template: SubflowTemplateItem) => any) | undefined;
 }>, {
     quickAdd: QuickAddConfig;
     enableThirdPlugin: boolean;
@@ -1562,6 +1899,7 @@ type __VLS_Props$2 = {
     }) => void;
     /** 是否隐藏基础信息中的触发器配置表单，默认 false */
     hideTrigger?: boolean;
+    subflowUpdateList?: SubflowUpdateItem[];
 };
 declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$2, {
     zoomToFit: (options?: ZoomToFitOptions) => void;
@@ -1614,6 +1952,7 @@ declare namespace __view_vue {
 interface FlowDetailPermissions {
     canEdit: boolean;
     canDebug: boolean;
+    canExecute: boolean;
 }
 
 type __VLS_Slots$1 = {
@@ -1633,6 +1972,12 @@ type __VLS_Slots$1 = {
         updateNodeInputParams: (inputParams: Record<string, PluginInputDataItem>) => void;
         updateVariableSourceInfo: (variableKey: string, nodeId: string, formKey: string) => void;
     }) => any;
+    customFormContent?: (props: {
+        customFormData: Record<string, any>;
+        additionalTaskParams: Record<string, any>;
+        updateCustomFormData: (data: Record<string, any>) => void;
+        updateAdditionalTaskParams: (params: Record<string, any>) => void;
+    }) => any;
 };
 type __VLS_Props$1 = {
     flowId: string;
@@ -1647,14 +1992,18 @@ type __VLS_Props$1 = {
     hideTrigger?: boolean;
     selectPanelConfig?: SelectPanelConfig;
     memberSelectorConfig?: MemberSelectorConfig;
+    /** 复合条件选择（filter）变量的宿主配置；不传则该类型变量不可用，其余功能不受影响 */
+    filterVariableConfig?: FilterVariableConfig;
     onSave?: (flowData: FlowTemplate) => void;
     onSaveSuccess?: () => void;
+    onExecuteSuccess?: (result: FlowTaskExecuteSuccessResult) => void;
     onBack?: () => void;
 };
 declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {
     isFlowEdited: ComputedRef<boolean>;
     updateNodeInputParams: FlowDetailExpose["updateNodeInputParams"];
     openGlobalVariables: FlowDetailExpose["openGlobalVariables"];
+    openGlobalVariableCreate: FlowDetailExpose["openGlobalVariableCreate"];
     refreshDebugContext: FlowDetailExpose["refreshDebugContext"];
     openDebugResult: FlowDetailExpose["openDebugResult"];
     zoomToFit: FlowDetailExpose["zoomToFit"];
@@ -1664,18 +2013,14 @@ declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {
     back: () => any;
     save: (flowData: FlowTemplate) => any;
     saveSuccess: () => any;
-    createVariable: (payload: {
-        keyword: string;
-        cursorIndex: number;
-    }) => any;
+    createVariable: (payload: CreateVariablePayload) => any;
+    executeSuccess: (result: FlowTaskExecuteSuccessResult) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
     onBack?: (() => any) | undefined;
     onSave?: ((flowData: FlowTemplate) => any) | undefined;
     onSaveSuccess?: (() => any) | undefined;
-    onCreateVariable?: ((payload: {
-        keyword: string;
-        cursorIndex: number;
-    }) => any) | undefined;
+    onCreateVariable?: ((payload: CreateVariablePayload) => any) | undefined;
+    onExecuteSuccess?: ((result: FlowTaskExecuteSuccessResult) => any) | undefined;
 }>, {
     quickAdd: QuickAddConfig;
     enableThirdPlugin: boolean;
@@ -1741,10 +2086,19 @@ declare function isMockableNode(node: NodeType | Activity | undefined | null): n
 declare const random4: () => string;
 declare const generateId: (group?: number) => string;
 
+interface ValidatePipelineTreeOptions {
+    /**
+     * 需要「已配置插件」的节点集合，不传时要求全部节点均已配置。
+     *
+     * 单步 / Mock 调试只依赖目标节点自身的配置（后端 step_run 用目标节点单独拼一棵最小流程树），
+     * 画布其余未配置节点不影响调试，因此这类场景只传目标节点，允许空节点先存为草稿。
+     */
+    requireConfiguredNodeIds?: string[];
+}
 /**
  * 画布pipeline_tree数据校验
  */
-declare const validatePipelineTree: (pipelineTree: PipelineTree) => {
+declare const validatePipelineTree: (pipelineTree: PipelineTree, options?: ValidatePipelineTreeOptions) => {
     valid: boolean;
     message: string;
     ids: string[];
@@ -1787,6 +2141,13 @@ declare class BkFlowNodeAccessor {
     get convergeGatewayId(): string | undefined;
     get isGateway(): boolean;
     get isTask(): boolean;
+    get templateId(): string | number | undefined;
+    get subflowConstants(): Record<string, any> | undefined;
+    get subflowVersion(): string | undefined;
+    get alwaysUseLatest(): boolean | undefined;
+    get schemeIdList(): string[] | undefined;
+    get templateSource(): string | undefined;
+    get isSubflow(): boolean;
     get nodeModel(): FlowNodeModel;
 }
 declare class BkFlowModelAccessor {
@@ -1810,10 +2171,23 @@ declare class BkFlowModelAccessor {
  */
 interface DebugCanvasContext {
     isMockNode(nodeId: string): boolean;
+    /** 节点调试状态；任务节点用它补充未执行（not_run）标识，不写入连线执行态。 */
+    getNodeStatus?(nodeId: string): string | undefined;
     /** 当前独立调试聚焦节点（不复用 X6 编辑选择态，设计 §9.3.2） */
     focusedNodeId?(): string;
     /** 打开该节点详情侧滑的“调试配置”Tab */
     openNodeDebugPanel?(nodeId: string): void;
+    /** 调试锁定期（running/terminating）；节点配置据此展示只读说明 Alert */
+    isLocked?(): boolean;
+}
+interface SubflowUpdateCanvasContext {
+    /** 节点是否引用了已过期的子流程模板（红点显隐） */
+    isNodeExpired(nodeId: string): boolean;
+    /**
+     * 红点动画的重播序号（每次"查看需要更新的子流程"定位时递增）。
+     * 节点用其作 :key 重挂载红点元素以重新触发 ripple 动画；未实现时返回 0（仅首轮动画）。
+     */
+    getDotEpoch?(nodeId: string): number;
 }
 
 type __VLS_Props = {
@@ -1828,6 +2202,7 @@ type __VLS_Props = {
     toolbarItems?: CanvasToolbarItem[];
     simulateDebugContext?: SimulateDebugCanvasContext;
     debugContext?: DebugCanvasContext;
+    subflowUpdateContext?: SubflowUpdateCanvasContext;
 };
 declare var __VLS_8: {};
 declare var __VLS_22: {
@@ -2003,5 +2378,5 @@ declare const _default: {
     FlowMockDebug: () => Promise<typeof __mock_vue>;
 };
 
-export { _default$1 as BkFlowCanvas, BkFlowModelAccessor, BkFlowNodeAccessor, _default$5 as FlowCreateTask, _default$7 as FlowDebug, _default$2 as FlowDetail, _default$4 as FlowEdit, _default$6 as FlowExecute, _default$8 as FlowMockDebug, _default$3 as FlowView, bkflowConnectionValidator, createBkflowPlugin, createBkflowSchema, createExecutionStatusPlugin, _default as default, exportToPipelineTree, generateId, getUniformApiPluginFormValue, getVariableDefaultConfig, importFromPipelineTree, isMockableNode, mergeOutputs, normalizePluginOutputItems, provideFlowApiConfig, provideMemberSelectorConfig, provideSelectPanelConfig, random4, resolveExecutionActions, resolveMockFormControl, useFlowApiConfig, useFlowEditApiConfig, useFlowViewApiConfig, useMemberSelectorConfig, useSelectPanelConfig, validatePipelineTree };
-export type { Activity, CanvasViewportExpose, CreateFlowTaskResult, DndNodeItem, ExecuteFlowTaskResult, ExecutionNodeAction, FlowApiConfig, FlowDetailExpose, FlowDetailPermissions, FlowEditExpose, FlowTaskExecuteSuccessResult, FlowTemplate, FlowViewExpose, Gateway, GatewayCondition, MemberSelectorConfig, MockOutputField, NodeExecutionState, NodeExecutionStatus, NodeMockConfig, NotifyConfig, PipelineTree, PluginDetailCommon, PluginInputDataItem, SelectPanelConfig, SimulateDebugCanvasContext, SimulateDebugStage, SimulateDebugState, SpaceFlowConfig, TaskExecutionStates, TemplateConfigs, TriggerCron, TriggerItem, UniformApiPluginInputsItem, UpdateFlowParams, Variable, VariableReference };
+export { _default$1 as BkFlowCanvas, BkFlowModelAccessor, BkFlowNodeAccessor, _default$5 as FlowCreateTask, _default$7 as FlowDebug, _default$2 as FlowDetail, _default$4 as FlowEdit, _default$6 as FlowExecute, _default$8 as FlowMockDebug, _default$3 as FlowView, bkflowConnectionValidator, createBkflowPlugin, createBkflowSchema, createExecutionStatusPlugin, _default as default, exportToPipelineTree, generateId, getUniformApiPluginFormValue, getVariableDefaultConfig, importFromPipelineTree, isMockableNode, mergeOutputs, normalizePluginOutputItems, provideFilterVariableConfig, provideFlowApiConfig, provideMemberSelectorConfig, provideSelectPanelConfig, random4, resolveExecutionActions, resolveMockFormControl, useFlowApiConfig, useFlowEditApiConfig, useFlowViewApiConfig, useMemberSelectorConfig, useSelectPanelConfig, validatePipelineTree };
+export type { Activity, CanvasViewportExpose, CreateFlowTaskResult, DndNodeItem, ExecuteFlowTaskResult, ExecutionNodeAction, FilterCandidateQuery, FilterConditionOptions, FilterConditionValue, FilterVariableConfig, FilterVariableSourceContext, FilterVariableSourceNodeComponent, FilterWhereItem, FilterWhereValue, FlowApiConfig, FlowDetailExpose, FlowDetailPermissions, FlowEditExpose, FlowTaskExecuteSuccessResult, FlowTemplate, FlowViewExpose, Gateway, GatewayCondition, GlobalVariableCreateExpose, MemberSelectorConfig, MockOutputField, NodeExecutionState, NodeExecutionStatus, NodeMockConfig, NotifyConfig, OpenFilterVariableCreateRequest, OpenGlobalVariableCreateRequest, OpenStandardVariableCreateRequest, PipelineTree, PluginDetailCommon, PluginInputDataItem, RetrievalFilterField, SelectPanelConfig, SimulateDebugCanvasContext, SimulateDebugStage, SimulateDebugState, SpaceFlowConfig, TaskExecutionStates, TemplateConfigs, TriggerCron, TriggerItem, UniformApiPluginInputsItem, UpdateFlowParams, Variable, VariableReference };