@blueking/bkflow-canvas-editor 1.1.0-beta.4 → 1.1.0-beta.41

package/dist/advanced.d.ts

@@ -1,6 +1,6 @@
 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;
@@ -44,6 +44,11 @@ interface NodeExecutionState {
     actions?: ExecutionNodeAction[];
     /** 兼容旧版后端直接透出的动作数组字段 */
     action_list?: ExecutionNodeAction[];
+    /**
+     * 条件网关命中的出边 flow_id。
+     * 有值时执行态连线优先按它着色，不要求目标节点已经执行（网关单步不会跑下游）。
+     */
+    selectedFlowIds?: string[];
 }
 type TaskExecutionStates = Record<string, NodeExecutionState>;
 
@@ -76,13 +81,26 @@ interface ActivityComponent {
   api_meta?: {
     id: string;
     name: string;
+    /** 项目内 uniform_api 仍可能写入；标准运维 V4 对齐 bkflow，不再落这个字段 */
     alias?: string;
-    meta_url: string;
+    /** 目录项有 meta_url 才写；V4 开放插件通常只有 meta_url_template */
+    meta_url?: string;
     api_key: string;
     category: {
       id: string;
       name: string;
     };
+    // 标准运维 V4 开放插件的落库字段，对齐 bkflow NodeConfig.vue `if (isV4)` 保存分支
+    plugin_source?: string;
+    plugin_code?: string;
+    plugin_version?: string;
+    wrapper_version?: string;
+    versions?: string[];
+    meta_url_template?: string;
+    latest_version?: string;
+    default_version?: string;
+    desc?: string;
+    source_key?: string;
   };
 }
 
@@ -392,15 +410,20 @@ interface FlowListItem {
     creator: string;
     update_at: string;
 }
+interface SpaceUniformApiEntry {
+    meta_apis: string;
+    api_categories?: string;
+    display_name?: string;
+    source_key?: string;
+    catalog_mode?: 'remote' | 'cache_first' | 'cache_only';
+    headers?: Record<string, string>;
+}
 interface SpaceFlowConfig {
     gateway_expression?: 'boolrule' | 'FEEL' | 'MAKO';
-    uiform_api?: {
-        api: Record<string, {
-            api_category: string;
-            display_name: string;
-            meta_apis: string;
-        }>;
-    };
+    uniform_api?: {
+        api?: Record<string, SpaceUniformApiEntry | null>;
+        common?: SpaceUniformApiEntry | null;
+    } | null;
 }
 interface UpdateFlowParams {
     name: string;
@@ -430,6 +453,88 @@ interface PluginMetaItem {
     icon?: string;
     category_id: string;
 }
+interface SopsPluginSourceItem {
+    id: string;
+    name: string;
+    /** 空间配置 uniform_api.api[api_name].source_key，缺省时等于 api_name */
+    source_key?: string;
+}
+interface SopsPluginCategory {
+    id: string;
+    name: string;
+}
+interface SopsPluginItem {
+    id: string;
+    name: string;
+    category?: string;
+    category_name?: string;
+    description?: string;
+    meta_url?: string;
+    meta_url_template?: string;
+    plugin_source?: string;
+    plugin_code?: string;
+    source_key?: string;
+    wrapper_version?: string;
+    default_version?: string;
+    latest_version?: string;
+    versions?: string[];
+}
+interface SopsPluginListResult {
+    total: number;
+    apis: SopsPluginItem[];
+}
+/**
+ * 统一插件详情里的表单描述符（bkflow V4 开放插件协议）。
+ * component_js / renderform(string) 走 $.atoms 注册链路，key 即注册用的 atom key；
+ * is_embedded 为 false 时 data 是脚本地址，否则 data 是脚本源码。
+ */
+type SopsPluginFormDescriptor = {
+    type: 'component_js';
+    key: string;
+    data: string;
+    base?: string;
+    is_embedded?: boolean;
+} | {
+    type: 'renderform';
+    key?: string;
+    data: string | RenderformInputsItem[] | Record<string, unknown>;
+    base?: string;
+    is_embedded?: boolean;
+} | {
+    type: 'jsonschema';
+    data: JsonschemaformInputs;
+} | {
+    type: 'api_plugin_json';
+    data?: Record<string, unknown>;
+};
+interface SopsPluginDetail {
+    plugin_type: 'component' | 'remote_plugin' | 'uniform_api';
+    plugin_code: string;
+    plugin_version: string;
+    source_key: string;
+    plugin_source?: string;
+    protocol?: string;
+    wrapper_version?: string;
+    name: string;
+    description?: string;
+    inputs?: UniformApiPluginInputsItem[];
+    outputs?: PluginOutputItem[];
+    credentials?: Record<string, unknown> | null;
+    forms?: {
+        input?: SopsPluginFormDescriptor | null;
+        output?: SopsPluginFormDescriptor | null;
+    } | null;
+    form_schema?: Record<string, unknown> | null;
+    /** 表单脚本运行所需的上下文（site_url / project 等），由插件提供方下发 */
+    form_context?: Record<string, unknown> | null;
+    execution_kind?: string;
+    url?: string;
+    methods?: string[];
+    response_data_path?: string;
+    polling?: Record<string, any> | null;
+    callback?: Record<string, any> | null;
+    credential_key?: string;
+}
 interface BkflowThirdPartyPluginGroupItem {
     code_name: string;
     id: number;
@@ -513,7 +618,7 @@ interface BkflowThirdPartyPluginAppDetail {
     };
 }
 interface GroupsPluginItem extends PluginGroupConfig {
-    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem)[];
+    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem | SopsPluginSourceItem)[];
 }
 interface UniformApiPluginOutputItem {
     key: string;
@@ -565,6 +670,29 @@ interface UniformApiPluginConfig {
         }>;
     };
 }
+interface RenderformInputsItem {
+    name?: string;
+    tag_code: string;
+    type: string;
+    attrs: Record<string, any>;
+    events?: Record<string, any>[];
+    validation?: Record<string, any>[];
+}
+interface JsonschemaformInputs {
+    type: string;
+    properties: Record<string, any>;
+    required?: string[];
+    definitions?: Record<string, {
+        type: string;
+        title: string;
+        description?: string;
+        default?: string | boolean | number | string[] | boolean[] | number[] | Record<string, any>;
+        enum?: string[];
+        items?: Record<string, any>;
+        'ui:props'?: Record<string, any>;
+        'ui:component'?: Record<string, any>;
+    }>;
+}
 interface UniformApiPluginInputsItem {
     desc: string;
     form_type?: string;
@@ -600,6 +728,239 @@ interface CustomVariableType {
     code: string;
 }
 
+interface VariableOption {
+    key: string;
+    name: string;
+    source_type?: string;
+    custom_type?: string;
+}
+interface CreateVariablePayload {
+    keyword?: string;
+    cursorIndex?: number;
+    defaultCustomType?: string;
+}
+/**
+ * 宿主自定义的候选项来源标识。
+ *
+ * 编辑器**不解释**它的内容，只做原样存储与回传：`key` 用于让宿主找到自己的加载器，
+ * `params` 放宿主拉取时需要的补充信息。
+ *
+ * 之所以由宿主带进来而不是编辑器从 pipeline_tree 反查关联节点的插件：节点配置尚未
+ * 保存时，`activities[nodeId].component` 还是换插件之前的那个，反查会拿到错的插件。
+ */
+interface SelectRelatedOptionSourceRef {
+    key: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * select 变量「关联数据」的来源，由宿主在节点表单里发起受控创建时锁定。
+ * 与 filter 的 FilterVariableSourceContext 平行。
+ */
+interface SelectRelatedSourceContext {
+    sourceNodeId: string;
+    /**
+     * 关联来源在「关联数据」栏展示的名字，由宿主决定放什么（bk-incident 放当前选中的插件名）。
+     *
+     * 它**优先于**画布实时解析的节点名：select 的关联源连同候选项来源一起冻结在创建时刻，
+     * 展示名跟着来源走而不是跟着节点实例走。不传则回落实时节点名、再回落裸 nodeId——
+     * 而空节点选插件后配置尚未写回 pipeline_tree，实时节点名恰恰是空的。
+     */
+    sourceNodeName?: string;
+    /** 关联表单项稳定 KEY，例如 index_set_id */
+    sourceFieldKey: string;
+    /**
+     * 关联表单项的展示名，例如「查询条件」——即节点表单上那一栏的标题，不是 fieldKey 本身。
+     * 全局变量侧滑没有加载插件 schema 的时机，不带进来就只能显示裸 fieldKey。
+     */
+    sourceFieldName?: string;
+    /** 候选项从哪来。缺省则该变量没有可拉取的候选项 */
+    optionSource?: SelectRelatedOptionSourceRef;
+}
+interface CreateVariableRequest extends CreateVariablePayload {
+    /** 缺省时 select 仍按「手动输入」初始化，普通「新建变量」入口不受影响 */
+    selectRelatedContext?: SelectRelatedSourceContext;
+    onCreated: (option: VariableOption) => void;
+}
+
+type DebugContextStatus = 'idle' | 'running' | 'terminating';
+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 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;
+}
+/** 条件网关分支求值结果（`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;
+    execution_mode: DebugExecutionMode;
+    status: DebugNodeStatus;
+    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;
+    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;
+    /** 条件网关命中的出边 flow_id；画布用它把命中连线标绿。 */
+    selected_flow_ids?: string[];
+    /** 条件网关每个分支的表达式与命中结果。 */
+    condition_results?: DebugConditionResult[];
+}
+/**
+ * /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 DebugResetImpact {
+    reset_node_ids: string[];
+    reasons?: Record<string, string>;
+}
+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'];
+    selected_flow_ids?: string[];
+    condition_results?: DebugConditionResult[];
+    [key: string]: unknown;
+}
+interface RunGlobalDebugResult {
+    task_id: number | string;
+    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 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>;
+    fetchDebugResetImpact(templateId: string | number): Promise<DebugResetImpact>;
+    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 配置接口
  */
@@ -613,10 +974,7 @@ interface FlowApiConfig {
     /** CSRF cookie 名称（可选，用于创建新的 axios 实例时设置 xsrfCookieName） */
     xsrfCookieName?: string;
     /** 作用域数据（必需，由外部传入） */
-    scopeData: {
-        scope_type: string;
-        scope_value: number;
-    };
+    scopeData: ScopeData;
     /**
      * 用户查询 API 地址（可选）
      * @deprecated 请改用 FlowEdit/FlowView 顶层组件的 `memberSelectorConfig.fetchUserApi`。
@@ -626,6 +984,12 @@ interface FlowApiConfig {
     /** 是否启用第三方插件（可选，默认为 true） */
     enableThirdPlugin?: boolean;
 }
+interface ScopeData {
+    scope_type: string;
+    scope_value: number;
+    /** 业务方传入的空间 ID，语义独立于 scope_value。 */
+    space_id: number;
+}
 
 interface DrawPipelineParams {
     pipeline_tree: PipelineTree;
@@ -655,6 +1019,7 @@ interface FetchTaskStateParams {
 interface FetchTaskNodeDetailParams {
     task_id: number | string;
     node_id: string;
+    component_code?: string;
 }
 interface FetchTaskNodeSnapshotParams {
     task_id: number | string;
@@ -676,10 +1041,67 @@ interface OperateTaskNodeParams {
 interface GetFlowTaskDetailParams {
     task_id: number | string;
 }
+interface SopsPluginCategoryParams {
+    template_id: number | string;
+    /** 空间 uniform_api 配置里的 api_name，如 sops_builtin / sops_third_party */
+    api_name: string;
+}
+interface SopsPluginListParams extends SopsPluginCategoryParams {
+    category?: string;
+    /** 插件名称搜索关键字 */
+    key?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * 统一插件详情请求参数。
+ * 后端 serializer 会拒绝契约外字段（不是静默忽略），调用方不要附加额外参数；
+ * space_id / scope_type / scope_value 由 service 从 scopeData 补齐。
+ */
+interface SopsPluginDetailParams {
+    template_id: number | string;
+    plugin_type: 'component' | 'remote_plugin' | 'uniform_api';
+    /** 标准运维网关 plugin id：内置为 `builtin__<code>`，第三方即裸 code */
+    plugin_code: string;
+    plugin_version: string;
+    /** uniform_api 必填，缺失时后端直接 400 */
+    source_key?: string;
+}
 interface FlowTaskDetail {
     id: number | string;
     template_id: number;
     pipeline_tree: PipelineTree;
+    /** 任务已耗时（秒），调试摘要弹层刷新恢复用。 */
+    elapsed_time?: number;
+    [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 {
@@ -707,6 +1129,8 @@ interface FlowViewApiConfig {
     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>;
@@ -726,23 +1150,13 @@ 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 | string;
         resource_type: string;
         resource_id: number | string;
         permission_type: string;
-    }) => Promise<any>;
+    }) => Promise<ExecuteFlowTaskResult>;
     revokeFlowTask?: (params: {
         task_id: number | string;
         resource_type: string;
@@ -794,28 +1208,21 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchCategoryPlugins: (category: string) => Promise<PluginMetaItem[]>;
     fetchAllPluginGroups: () => Promise<GroupsPluginItem[]>;
     enableThirdPlugin?: boolean;
+    fetchSopsPluginCategories?: (params: SopsPluginCategoryParams) => Promise<SopsPluginCategory[]>;
+    fetchSopsPluginList?: (params: SopsPluginListParams) => Promise<SopsPluginListResult>;
+    fetchSopsPluginDetail?: (params: SopsPluginDetailParams) => Promise<SopsPluginDetail>;
     fetchPluginDetail?: (id: string) => Promise<UniformApiPluginDetail>;
     fetchApplyInstructionData?: (params: any) => Promise<any>;
     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 | string;
         resource_type: string;
         resource_id: number | string;
         permission_type: string;
-    }) => Promise<any>;
+    }) => Promise<ExecuteFlowTaskResult>;
     revokeFlowTask?: (params: {
         task_id: number | string;
         resource_type: string;
@@ -835,14 +1242,38 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
     getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
 }
+interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices> {
+}
 
+declare const SOPS_PLUGIN_GROUP_NAME = "sops";
 declare const PLUGIN_GROUP_ICON_MAP: Record<string, string>;
 
+/** 目录查询接口由宿主注入，三个都要有才能走完「来源 -> 分类 -> 插件 -> 详情」 */
+type SopsPluginCatalogApi = Pick<FlowEditApiConfig, 'fetchSopsPluginCategories' | 'fetchSopsPluginList' | 'fetchSopsPluginDetail'>;
+interface SopsPluginGroupOptions {
+    spaceConfig?: SpaceFlowConfig | null;
+    api: SopsPluginCatalogApi;
+}
+/**
+ * 从 `get_space_related_configs` 的 `uniform_api.api` 里取出标准运维来源。
+ * id 即后续请求分类/插件列表要带的 `api_name`，顺序沿用配置里的顺序。
+ */
+declare function resolveSopsPluginSources(config?: SpaceFlowConfig | null): SopsPluginSourceItem[];
+/**
+ * 空间接入了标准运维、且宿主实现了目录查询接口时，在插件分组末尾补上「标准运维插件」分组；
+ * 否则原样返回。两个条件都要满足：少了接口，分组点开也只是一个永远空着的列表。
+ */
+declare function withSopsPluginGroup(groups: GroupsPluginItem[], options: SopsPluginGroupOptions): GroupsPluginItem[];
+
 /**
  * 使用 Flow API 的 composable
- * 返回所有 API 方法，兼容 FlowEditApiConfig 接口
+ * 返回所有 API 方法，兼容 FlowDetailApiConfig 接口（含调试 API）
  */
-declare function useFlowApi(config: FlowApiConfig): FlowEditApiConfig;
+declare function useFlowApi(config: FlowApiConfig): FlowDetailApiConfig;
+
+type VariableInputCreateVariableHandler = (request: CreateVariableRequest) => void;
+declare const provideVariableInputCreateVariable: (handler: VariableInputCreateVariableHandler) => void;
+declare const useVariableInputCreateVariable: () => VariableInputCreateVariableHandler | null;
 
-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 { PLUGIN_GROUP_ICON_MAP, SOPS_PLUGIN_GROUP_NAME, provideVariableInputCreateVariable, resolveSopsPluginSources, useFlowApi, useVariableInputCreateVariable, withSopsPluginGroup };
+export type { CreateVariablePayload, CreateVariableRequest, CustomVariableType, DebugApiServices, DebugConditionResult, 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, SelectRelatedSourceContext, SopsPluginCategory, SopsPluginCategoryParams, SopsPluginDetail, SopsPluginDetailParams, SopsPluginFormDescriptor, SopsPluginItem, SopsPluginListParams, SopsPluginListResult, SopsPluginSourceItem, SpaceUniformApiEntry, StartEvent, TemplateConfigs, UniformApiPluginConfig, UniformApiPluginInputsItem, VariableInputCreateVariableHandler, VariableOption, VariableRefRequestParams };

package/dist/advanced.esm.js

@@ -1,5 +1,10 @@
-import { P as s, u as _ } from "./composable-CmXOtkXh.js";
+import { P as r, S as s, p as i, r as o, u as p, a as u, w as P } from "./context-De9a4Qek.js";
 export {
-  s as PLUGIN_GROUP_ICON_MAP,
-  _ as useFlowApi
+  r as PLUGIN_GROUP_ICON_MAP,
+  s as SOPS_PLUGIN_GROUP_NAME,
+  i as provideVariableInputCreateVariable,
+  o as resolveSopsPluginSources,
+  p as useFlowApi,
+  u as useVariableInputCreateVariable,
+  P as withSopsPluginGroup
 };