@blueking/bkflow-canvas-editor 1.1.0-beta.0 → 1.1.0-beta.10

package/dist/advanced.d.ts

@@ -1,6 +1,51 @@
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 
-type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED';
+type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED' | 'SKIP';
+type ExecutionNodeAction = 'retry' | 'skip' | 'resume' | 'approve' | 'forceFail' | 'gatewaySkip';
+interface NodeExecutionState {
+    status: NodeExecutionStatus;
+    version?: string;
+    start_time?: string;
+    finish_time?: string;
+    elapsed_time?: number;
+    /** 旧版任务引擎的 task 状态，优先用于识别 REVOKED */
+    taskState?: string;
+    /** 兼容旧版 snake_case 字段 */
+    task_state?: string;
+    /** 节点组件 code，如 pause_node / bk_approve，用于动作分流 */
+    nodeCode?: string;
+    /** 兼容旧版 snake_case 字段 */
+    code?: string;
+    /** 编辑态配置：失败可重试 */
+    retryable?: boolean;
+    /** 编辑态配置：失败可跳过 */
+    skippable?: boolean;
+    /** 编辑态配置：自动忽略错误（隐含 retry/skip 权限） */
+    errorIgnorable?: boolean;
+    /** 兼容旧版 snake_case 字段 */
+    error_ignorable?: boolean;
+    /** 是否有管理员权限，影响强制终止按钮 */
+    hasAdminPerm?: boolean;
+    /** 兼容旧版 snake_case 字段 */
+    has_admin_perm?: boolean;
+    /** 运行时信息：实际重试次数 */
+    retry?: number;
+    /** 运行时信息：是否已跳过 */
+    skip?: boolean;
+    /** 运行时信息：是否自动忽略错误 */
+    errorIgnored?: boolean;
+    /** 兼容旧版 snake_case 字段 */
+    error_ignored?: boolean;
+    /** 运行时信息：循环次数 */
+    loop?: number;
+    /** 运行时信息：生命周期阶段 */
+    phase?: number;
+    /** 若由上游直接给出操作列表，则 resolver 不再推导 */
+    actions?: ExecutionNodeAction[];
+    /** 兼容旧版后端直接透出的动作数组字段 */
+    action_list?: ExecutionNodeAction[];
+}
+type TaskExecutionStates = Record<string, NodeExecutionState>;
 
 type PortOrientation = 'Top' | 'Right' | 'Bottom' | 'Left';
 
@@ -470,6 +515,19 @@ interface BkflowThirdPartyPluginAppDetail {
 interface GroupsPluginItem extends PluginGroupConfig {
     children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem)[];
 }
+interface UniformApiPluginOutputItem {
+    key: string;
+    name?: string;
+    type?: string;
+    description?: string;
+    schema?: Record<string, any>;
+    form_type?: string;
+    options?: Array<{
+        label?: string;
+        value?: unknown;
+        text?: string;
+    }>;
+}
 interface UniformApiPluginDetail {
     alias: string;
     bk_tenant_id: string;
@@ -484,7 +542,7 @@ interface UniformApiPluginDetail {
     url: string;
     methods: string[];
     inputs: Record<string, any>;
-    outputs: string[];
+    outputs?: Array<UniformApiPluginOutputItem | string>;
     scope_id: string;
     sign: string;
     updated_at: string;
@@ -542,6 +600,184 @@ interface CustomVariableType {
     code: string;
 }
 
+type DebugContextStatus = 'idle' | 'running' | 'terminating';
+type DebugNodeStatus = 'not_run' | 'running' | 'waiting' | 'paused' | 'finished' | 'failed' | '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）。 */
+interface DebugErrorFailure {
+    message: string;
+    node_id?: string;
+    template_node_id?: string;
+    [key: string]: unknown;
+}
+interface DebugErrorDetail {
+    type?: string;
+    message?: string;
+    task_id?: number | string;
+    failures?: DebugErrorFailure[];
+    [key: string]: unknown;
+}
+interface DebugContextNode {
+    node_id: string;
+    node_type: string;
+    execution_mode: DebugExecutionMode;
+    status: DebugNodeStatus;
+    can_step: boolean;
+    missing_vars: DebugMissingVar[];
+    waiting_reason?: string | null;
+    mock_result?: 'success' | 'fail' | null;
+    error_detail?: DebugErrorDetail | string | null;
+    duration_ms?: number | null;
+    log_ref?: {
+        instance_id: number | string;
+        node_id: string;
+        version: string;
+    } | null;
+    mock_outputs?: Record<string, unknown> | null;
+    mock_error?: string | null;
+    outputs?: Record<string, unknown> | null;
+}
+/**
+ * /debug_context/ 顶层结构。
+ *
+ * 前端按 status 分支：
+ * - running：任务定位用 active_*，进度用 last_run_status
+ * - terminating：继续用 active_*，UI 展示「终止中」并轮询
+ * - idle：active_* 为空，结果摘要用 last_*；last_task_id=null 表示尚无调试记录
+ */
+interface DebugContext {
+    template_id: number;
+    status: DebugContextStatus;
+    locked_by: string;
+    active_task_id: number | string | null;
+    active_run_type: DebugRunType | null;
+    active_node_id: string | null;
+    last_task_id: number | string | null;
+    last_run_type: DebugRunType | null;
+    last_run_status: DebugRunStatus | null;
+    last_error_detail?: DebugErrorDetail | null;
+    last_inputs?: Record<string, unknown>;
+    global_vars: Record<string, unknown>;
+    missing_vars?: DebugMissingVar[];
+    nodes: DebugContextNode[];
+}
+interface DebugInputSchemaField {
+    key: string;
+    name: string;
+    type: string;
+    default?: unknown;
+    required?: boolean;
+    [key: string]: unknown;
+}
+interface DebugInputSchema {
+    fields?: DebugInputSchemaField[];
+    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;
+    updated_global_vars?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface RunNodeDebugStepResult {
+    node_id: string;
+    status: DebugNodeStatus;
+    outputs?: Record<string, unknown> | null;
+    error_detail?: unknown;
+    updated_global_vars?: Record<string, unknown>;
+    log_ref?: DebugContextNode['log_ref'];
+    [key: string]: unknown;
+}
+interface RunGlobalDebugResult {
+    task_id: number | string;
+    status: DebugContextStatus;
+    [key: string]: unknown;
+}
+interface TerminateDebugResult {
+    status?: DebugContextStatus;
+    [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;
+    enable: boolean;
+    mockResult?: 'success' | 'fail';
+    mockOutputs?: Record<string, unknown>;
+    mockError?: string;
+}
+interface RunNodeDebugStepParams {
+    templateId: string | number;
+    nodeId: string;
+    mode: 'real' | 'mock';
+    inputOverrides?: Record<string, unknown>;
+    mockResult?: 'success' | 'fail';
+    mockOutputs?: Record<string, unknown>;
+    mockError?: string;
+}
+interface RunGlobalDebugParams {
+    templateId: string | number;
+    inputs: Record<string, unknown>;
+}
+interface TerminateDebugParams {
+    templateId: string | number;
+    nodeId?: string;
+}
+interface ResetDebugResultParams {
+    templateId: string | number;
+    nodeIds?: string[];
+}
+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>;
+    terminateDebug(params: TerminateDebugParams): Promise<TerminateDebugResult>;
+    resetDebugResult(params: ResetDebugResultParams): Promise<DebugResetResult>;
+}
+
 /**
  * Flow API 配置接口
  */
@@ -558,8 +794,14 @@ interface FlowApiConfig {
     scopeData: {
         scope_type: string;
         scope_value: number;
+        /** 业务方传入的空间 ID，调试接口专用，语义独立于 scope_value */
+        space_id: number;
     };
-    /** 用户查询 API 地址（可选） */
+    /**
+     * 用户查询 API 地址（可选）
+     * @deprecated 请改用 FlowEdit/FlowView 顶层组件的 `memberSelectorConfig.fetchUserApi`。
+     * 该字段仅保留向后兼容，未来版本会移除。
+     */
     fetchUserApi?: string;
     /** 是否启用第三方插件（可选，默认为 true） */
     enableThirdPlugin?: boolean;
@@ -573,16 +815,109 @@ interface DrawPipelineParams {
     gateway_size?: [number, number];
     start?: [number, number];
 }
+interface CreateMockDebugTaskParams {
+    template_id: number;
+    name: string;
+    pipeline_tree: PipelineTree;
+    mock_data: {
+        nodes: string[];
+        outputs: Record<string, Record<string, unknown>>;
+        mock_data_ids?: Record<string, number | string>;
+    };
+    creator?: string;
+}
+interface StopMockDebugTaskParams {
+    task_id: number | string;
+}
+interface FetchTaskStateParams {
+    task_id: number | string;
+}
+interface FetchTaskNodeDetailParams {
+    task_id: number | string;
+    node_id: string;
+}
+interface FetchTaskNodeSnapshotParams {
+    task_id: number | string;
+    node_id: string;
+}
+interface FetchTaskNodeLogParams {
+    task_id: number | string;
+    node_id: string;
+    version: string;
+}
+interface OperateTaskNodeParams {
+    task_id: number | string;
+    node_id: string;
+    action: ExecutionNodeAction;
+    data?: Record<string, unknown>;
+    /** 自定义 operation，优先级高于 action 默认映射 */
+    operation?: string;
+}
+interface GetFlowTaskDetailParams {
+    task_id: number | string;
+}
+interface FlowTaskDetail {
+    id: number | string;
+    template_id: number;
+    pipeline_tree: PipelineTree;
+    [key: string]: unknown;
+}
+interface CreateFlowTaskParams {
+    template_id: number;
+    name: string;
+    creator: string;
+    constants: Record<string, any>;
+    label_ids?: number[];
+    [key: string]: unknown;
+}
+interface CreateFlowTaskResult {
+    data: {
+        id: number | string;
+        template_id?: number;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+interface ExecuteFlowTaskResult {
+    result?: boolean;
+    code?: number;
+    data?: {
+        /** 任务详情页跳转地址（含正确的 bkflow task id 与 templateId） */
+        url?: string;
+        [key: string]: unknown;
+    };
+    message?: string | null;
+    request_id?: string;
+    trace_id?: string | null;
+    [key: string]: unknown;
+}
+interface TaskStateResult {
+    state?: string;
+    status?: string;
+    node_states?: TaskExecutionStates;
+    states?: Record<string, unknown>;
+    children?: Record<string, unknown> | unknown[];
+    nodes?: Record<string, unknown> | unknown[];
+    activities?: Record<string, unknown>;
+    gateways?: Record<string, unknown>;
+    [key: string]: unknown;
+}
 
 interface FlowViewApiConfig {
     fetchFlowDetail: (id: string) => Promise<FlowTemplate>;
     fetchSpaceFlowConfig: (id: string) => Promise<SpaceFlowConfig>;
     fetchSystemVariables: (id: string) => Promise<Variable[]>;
+    /**
+     * 用户查询 API 地址
+     * @deprecated 请改用 memberSelectorConfig.fetchUserApi（顶层组件 prop）
+     */
     fetchUserApi?: string;
     /** 作用域数据（必需，由外部传入） */
     scopeData: {
         scope_type: string;
         scope_value: number;
+        /** 业务方传入的空间 ID，调试接口专用，语义独立于 scope_value */
+        space_id: number;
     };
     fetchFlowDraftDetail?: (id: string) => Promise<FlowDraftDetail>;
     fetchFlowDetailByVersion?: (id: string, version: string) => Promise<FlowDetailByVersion>;
@@ -602,24 +937,32 @@ interface FlowViewApiConfig {
             data: any[];
         };
     }>;
-    createFlowTask?: (params: {
-        template_id: number;
-        name: string;
-        creator: string;
-        constants: Record<string, any>;
-    }) => Promise<{
-        data: {
-            id: number;
-            template_id: number;
-        };
-    }>;
+    createFlowTask?: (params: CreateFlowTaskParams) => Promise<CreateFlowTaskResult>;
     executeFlowTask?: (params: {
-        task_id: number;
-        action: string;
+        task_id: number | string;
         resource_type: string;
-        resource_id: number;
+        resource_id: number | string;
+        permission_type: string;
+    }) => Promise<ExecuteFlowTaskResult>;
+    revokeFlowTask?: (params: {
+        task_id: number | string;
+        resource_type: string;
+        resource_id: number | string;
         permission_type: string;
     }) => Promise<any>;
+    createMockDebugTask?: (params: CreateMockDebugTaskParams) => Promise<{
+        data: {
+            id: number | string;
+            template_id: number;
+        };
+    }>;
+    stopMockDebugTask?: (params: StopMockDebugTaskParams) => Promise<void>;
+    fetchTaskState?: (params: FetchTaskStateParams) => Promise<TaskStateResult>;
+    fetchTaskNodeDetail?: (params: FetchTaskNodeDetailParams) => Promise<unknown>;
+    fetchTaskNodeSnapshot?: (params: FetchTaskNodeSnapshotParams) => Promise<unknown>;
+    fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
+    operateTaskNode?: (params: OperateTaskNodeParams) => Promise<unknown>;
+    getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
     fetchControlConfig?: () => Promise<Record<string, any>>;
     checkSpaceConfig?: (scopeValue: number, params: {
         name: string;
@@ -647,7 +990,7 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchBkFlowThirdPartyPluginTags: () => Promise<BkflowThirdPartyPluginGroupItem[]>;
     fetchBkFlowThirdPartyPluginMeta: (plugin_code: string) => Promise<BkflowThirdPartyPluginMetaDetail>;
     fetchBkFlowThirdPartyPluginDetail: (plugin_code: string, plugin_version: string) => Promise<BkflowThirdPartyPluginDetail>;
-    fetchBkFlowThirdPartyPluginAppDetail: (plugin_code: string) => Promise<BkflowThirdPartyPluginAppDetail>;
+    fetchBkFlowThirdPartyPluginAppDetail: (plugin_code: string, plugin_version: string) => Promise<BkflowThirdPartyPluginAppDetail>;
     fetchPluginGroupList: () => Promise<PluginGroupConfig[]>;
     fetchCategoryPlugins: (category: string) => Promise<PluginMetaItem[]>;
     fetchAllPluginGroups: () => Promise<GroupsPluginItem[]>;
@@ -657,33 +1000,42 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     drawPipeline?: (params: DrawPipelineParams) => Promise<{
         pipeline_tree: PipelineTree;
     }>;
-    createFlowTask?: (params: {
-        template_id: number;
-        name: string;
-        creator: string;
-        constants: Record<string, any>;
-    }) => Promise<{
-        data: {
-            id: number;
-            template_id: number;
-        };
-    }>;
+    createFlowTask?: (params: CreateFlowTaskParams) => Promise<CreateFlowTaskResult>;
     executeFlowTask?: (params: {
-        task_id: number;
-        action: string;
+        task_id: number | string;
+        resource_type: string;
+        resource_id: number | string;
+        permission_type: string;
+    }) => Promise<ExecuteFlowTaskResult>;
+    revokeFlowTask?: (params: {
+        task_id: number | string;
         resource_type: string;
-        resource_id: number;
+        resource_id: number | string;
         permission_type: string;
     }) => Promise<any>;
+    createMockDebugTask?: (params: CreateMockDebugTaskParams) => Promise<{
+        data: {
+            id: number | string;
+            template_id: number;
+        };
+    }>;
+    stopMockDebugTask?: (params: StopMockDebugTaskParams) => Promise<void>;
+    fetchTaskState?: (params: FetchTaskStateParams) => Promise<TaskStateResult>;
+    fetchTaskNodeDetail?: (params: FetchTaskNodeDetailParams) => Promise<unknown>;
+    fetchTaskNodeSnapshot?: (params: FetchTaskNodeSnapshotParams) => Promise<unknown>;
+    fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
+    getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
+}
+interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices> {
 }
 
 declare const PLUGIN_GROUP_ICON_MAP: Record<string, string>;
 
 /**
  * 使用 Flow API 的 composable
- * 返回所有 API 方法，兼容 FlowEditApiConfig 接口
+ * 返回所有 API 方法，兼容 FlowDetailApiConfig 接口（含调试 API）
  */
-declare function useFlowApi(config: FlowApiConfig): FlowEditApiConfig;
+declare function useFlowApi(config: FlowApiConfig): FlowDetailApiConfig;
 
 export { PLUGIN_GROUP_ICON_MAP, useFlowApi };
-export type { CustomVariableType, EndEvent, Flow, FlowEditApiConfig, FlowListItem, FlowViewApiConfig, GatewayType, Line, Location, NodeConfigData, NodeType, NotifyConfig, PluginGroupConfig, PluginOutputItem, PortOrientation, StartEvent, TemplateConfigs, UniformApiPluginConfig, UniformApiPluginInputsItem, VariableRefRequestParams };
+export type { CustomVariableType, DebugApiServices, DebugContext, DebugContextNode, DebugContextStatus, DebugErrorDetail, DebugExecutionMode, DebugInputSchema, DebugMissingVar, DebugNodeStatus, DebugRunStatus, DebugRunType, EndEvent, Flow, FlowDetailApiConfig, FlowEditApiConfig, FlowListItem, FlowViewApiConfig, GatewayType, Line, Location, NodeConfigData, NodeType, NotifyConfig, PluginGroupConfig, PluginOutputItem, PortOrientation, StartEvent, TemplateConfigs, UniformApiPluginConfig, UniformApiPluginInputsItem, VariableRefRequestParams };

package/dist/advanced.esm.js

@@ -1,4 +1,4 @@
-import { P as s, u as _ } from "./composable-QLQKeBKC.js";
+import { P as s, u as _ } from "./composable-Cf47ka9M.js";
 export {
   s as PLUGIN_GROUP_ICON_MAP,
   _ as useFlowApi

package/dist/bkflow-canvas-editor_false-B70uLuHL.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={};throw new Error('Could not resolve "@blueking/bk-user-selector/vue3/vue3.css" imported by "@blueking/bkflow-canvas-editor".');exports.default=e;

package/dist/bkflow-canvas-editor_false-BlC281Zg.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={};throw new Error('Could not resolve "@blueking/bk-user-selector" imported by "@blueking/bkflow-canvas-editor".');exports.default=e;

package/dist/bkflow-canvas-editor_false-Casww7p4.js

@@ -0,0 +1,5 @@
+const e = {};
+throw new Error('Could not resolve "@blueking/bk-user-selector/vue3/vue3.css" imported by "@blueking/bkflow-canvas-editor".');
+export {
+  e as default
+};

package/dist/bkflow-canvas-editor_false-i9G8sqQi.js

@@ -0,0 +1,5 @@
+const e = {};
+throw new Error('Could not resolve "@blueking/bk-user-selector" imported by "@blueking/bkflow-canvas-editor".');
+export {
+  e as default
+};