@yiyi_zhang/reactflow-ui 1.0.0 → 1.2.0

package/README.md

@@ -1,14 +1,39 @@
-# Conductor Workflow IDE (`@yiyi_zhang/reactflow-ui` v1.0.0)
+# Conductor Workflow IDE (`@yiyi_zhang/reactflow-ui` v1.1.0)
 
 基于 **React 19、ReactFlow 与 Zustand** 构建的下一代企业级 [Netflix Conductor](https://conductor-oss.org/) 工作流可视化设计器与 AI 原生编排 IDE。
 
 提供两个可独立按需集成的核心组件入口：
-- **`WorkflowIDE`**（主入口 `@yiyi_zhang/reactflow-ui`）— 面向专业编排与研发人员的完整可视化 IDE
+- **`WorkflowIDE`**（主入口 `@yiyi_zhang/reactflow-ui`）— 双模全融合，支持面向业务与运维的**业务卡片流 (StepFlow)**，以及面向架构研发的**专业开发者 DAG 拓扑**同屏热切换
 - **`AiWorkflowIDE`**（子路径 `@yiyi_zhang/reactflow-ui/ai`）— 对话优先、AI 驱动，支持多轮 Agentic 编排、子工作流库复用与混合交互
 
 ---
 
-## 🌟 v1.0.0 四大核心支柱架构 (Next-Gen Architecture)
+## ⚡ v1.1.0 业务与技术全融合核心新特性 (New in v1.1.0)
+
+### 👔 支柱一：业务卡片流设计器 (Business StepFlow) 与双模同屏无损热切换
+- **双模毫秒级热切换**：工具栏一键切换 `👔 业务模式` ⇄ `💻 开发者模式`。业务模式下将复杂的微服务连线拓扑解构为清晰直观的业务卡片流，支持任意位置插入步骤、上下重排与内联表单配置。
+- **StepModel 双向无损编译引擎**：提供递归编译器与反编译器，保证卡片流与原生 Conductor DAG 之间 100% 状态保真转换，非标任务通过 `isProFallback` 严格兜底。
+
+### ☁️ 支柱二：内置云平台动作库与动态参数胶囊
+- **首发生态对接类阿里云云主机 (ECS) 全生命周期动作**：创建云主机、启停机、磁盘快照备份、平滑升降规格、释放实例等。
+- **动态参数胶囊与智能上游引用**：表单输入项胶囊化呈现，一键联想并安全绑定上游步骤产出的参数引用。
+
+### 🔀 支柱三：业务容器化高级控制流卡片
+- **分支路由卡片 (`DecisionBranchCard`)**：分支 Tabs 导航、条件参数配置、分支内多步骤嵌套编排。
+- **并行任务泳道卡片 (`ForkJoinCard`)**：多泳道并发设计器，动态增删泳道。
+- **循环迭代容器卡片 (`LoopDoWhileCard`)**：循环体内嵌任务序列、继续条件表达式与防死循环熔断保护。
+
+### 🪄 支柱四：生产实例一键脱敏提炼为模板工具链 (Template Extractor)
+- **生产资产一键沉淀**：将生产环境或演练场调试好的工作流一键提炼为公共模板，智能隐私脱敏引擎自动擦除内网 IP、密钥、密码与机密 ID。
+- **8 大开箱即用场景模板中心**：覆盖云主机自动化、扩容容灾、定时省电关机等高频场景，支持全流程浏览器沙箱试跑验证。
+
+### 📖 支柱五：运行故事线时间轴与生活化诊断自愈建议
+- **流水账故事线展开 (`RunStoryTimeline`)**：运行态以自然语言叙述工作流执行过程，直观呈现每一步耗时与数据快照。
+- **生活化故障诊断自愈**：告别晦涩堆栈报错，提供通俗易懂的根因诊断与可直接操作的自愈行动建议。
+
+---
+
+## 🌟 v1.0.0 四大确定性工程底座 (Foundation)
 
 ### 🧬 支柱一：确定性工作流语言服务 (W-LSP) 与数据血缘图谱
 - **0ms 确定性 JSONPath 补全**：在节点配置面板输入 `${` 时，W-LSP 引擎实时遍历当前节点的所有**合法上游祖先节点**，融合五类数据源（运行态真实 Output、人工 Mock Output、`TaskSchema` 注册表、节点配置自省、类型默认字段）弹出零延迟自动补全，并附带 `⚡ 实时值预览`。

package/dist/AiWorkflowIDE.d.ts

@@ -10,6 +10,7 @@ import type { WorkflowDef, WorkflowInstance } from './types/conductor';
 import type { AiConfig } from './services/ai/protocolAdapter';
 import type { AiMetrics } from './store/aiStore';
 import type { WorkflowLibraryItem } from './types/workflowLibrary';
+import type { LibraryProvider } from './library/types';
 import type { ExecutionActions, ThemeMode, ThemeColor, LayoutDirection, ViewMode, WorkflowExecutionInput } from './types/workflow';
 import type { CustomTool } from './services/ai/toolRegistry';
 import type { CustomValidationRule } from './services/ai/ruleEngine';
@@ -42,6 +43,26 @@ export interface AiWorkflowIDEProps {
      * ```
      */
     workflowLibrary?: WorkflowLibraryItem[];
+    /**
+     * 流程库数据源（LibraryProvider）。提供后，库内流程 / 任务定义经规范化后同时投影为
+     * AI 目录（`workflowLibrary`）、任务 Schema（`taskSchemas`）与检索工具的数据来源；
+     * 同名条目 Provider 优先于静态 prop，静态 prop 仍可单独使用。
+     *
+     * `libraryProvider` 引用变化时重新加载，组件卸载时中止进行中的请求。
+     * AI 新建的 SUB_WORKFLOW 会固定为目录当前最新版本，已有版本号不会被自动改变。
+     *
+     * ```tsx
+     * const provider = createConductorLibraryProvider({ baseUrl, headers });
+     * <AiWorkflowIDE libraryProvider={provider} />
+     * ```
+     */
+    libraryProvider?: LibraryProvider;
+    /**
+     * 流程库目录注入系统提示词的条数上限，默认 50（按层级 L3 -> L1 截断）。
+     * 超出部分会提示 AI 改用 `search_workflow_library` 检索。
+     * 提供 `libraryProvider` 时，任务 Schema 段落同样受此上限约束。
+     */
+    promptCatalogLimit?: number;
     /**
      * AI 模型配置（集成方提供）。
      *

package/dist/WorkflowIDE.d.ts

@@ -1,6 +1,9 @@
 import { ThemeMode, ThemeColor, LayoutDirection, ValidationResults, ExecutionActions, ViewMode, WorkflowExecutionInput } from './types/workflow';
 import { WorkflowDef, WorkflowInstance } from './types/conductor';
 import { AIServiceConfig } from './services/aiService';
+import { ActionDefinition } from './actions/types';
+import type { WorkflowLevel } from './types/workflowLibrary';
+import type { LibraryProvider } from './library/types';
 import './styles/tokens.css';
 import './styles/executionStyles.css';
 /**
@@ -92,6 +95,37 @@ export interface WorkflowIDEProps {
      * AI 配置。通过 Props 注入优先于 localStorage 配置。
      */
     aiConfig?: Partial<AIServiceConfig>;
+    /**
+     * UI 体验模式：
+     * - `pro` (默认): 专业开发者模式，展示完整 DAG 画布、底层参数、Monaco JSON
+     * - `business`: 面向普通使用者的业务模式，提供卡片步骤流、业务动作与数据胶囊
+     * @default 'pro'
+     */
+    uiMode?: 'pro' | 'business';
+    /**
+     * 自定义扩展的业务动作定义列表。
+     * 宿主可传入自定义业务动作（如私有云/特定系统连接器）。
+     */
+    actions?: ActionDefinition[];
+    /**
+     * 流程库数据源（LibraryProvider）。提供后，库内流程 / 任务定义会生成业务动作并注册到本实例的动作库：
+     * 流程库能力编译为 `SUB_WORKFLOW`，步骤在首次引用时固定为目录当前最新版本，
+     * 库发布新版本后步骤不会自动跟随，徽标提示「有新版本」，由用户确认差异后手动升级。
+     *
+     * 同名动作 Provider 优先于 `actions`；不传时 `actions` 的行为完全不变。
+     * `libraryProvider` 引用变化时重新加载，组件卸载时中止进行中的请求。
+     *
+     * ```tsx
+     * const provider = createConductorLibraryProvider({ baseUrl, headers });
+     * <WorkflowIDE uiMode="business" libraryProvider={provider} />
+     * ```
+     */
+    libraryProvider?: LibraryProvider;
+    /**
+     * 当前正在编辑的工作流层级（L1 / L2 / L3）。
+     * 提供时，动作选择器隐藏违反分层调用规则的流程库动作（L1 不显示 L2/L3，L2 不显示 L3）；未提供则不过滤。
+     */
+    currentWorkflowLevel?: WorkflowLevel;
     /**
      * 组件容器高度。
      * @default '100%'

package/dist/actions/builtin/common.d.ts

@@ -0,0 +1,8 @@
+import type { ActionDefinition } from '../types';
+export declare const notifySendMessageAction: ActionDefinition;
+export declare const humanApprovalAction: ActionDefinition;
+export declare const controlWaitAction: ActionDefinition;
+export declare const controlDecisionAction: ActionDefinition;
+export declare const controlForkAction: ActionDefinition;
+export declare const controlLoopAction: ActionDefinition;
+export declare const BUILTIN_COMMON_ACTIONS: ActionDefinition[];

package/dist/actions/builtin/ecs.d.ts

@@ -0,0 +1,12 @@
+import type { ActionDefinition } from '../types';
+export declare const ecsCreateInstanceAction: ActionDefinition;
+export declare const ecsQueryInstanceAction: ActionDefinition;
+export declare const ecsStartInstanceAction: ActionDefinition;
+export declare const ecsStopInstanceAction: ActionDefinition;
+export declare const ecsRestartInstanceAction: ActionDefinition;
+export declare const ecsModifySpecAction: ActionDefinition;
+export declare const ecsCreateSnapshotAction: ActionDefinition;
+export declare const ecsRunCommandAction: ActionDefinition;
+export declare const ecsGetMonitorMetricsAction: ActionDefinition;
+export declare const ecsReleaseInstanceAction: ActionDefinition;
+export declare const BUILTIN_ECS_ACTIONS: ActionDefinition[];

package/dist/actions/fromDefinitions.d.ts

@@ -0,0 +1,70 @@
+import type { SchemaDef, WorkflowDef } from '../types/conductor';
+import type { ActionCategory, ActionDefinition, ActionField, ActionOutputField } from './types';
+import type { WorkflowLevel } from '../types/workflowLibrary';
+/**
+ * 从 Conductor OSS 标准定义（WorkflowDef / 已注册 TaskDef）生成业务动作。
+ *
+ * 设计原则：
+ * - 库本身不发请求：定义数据由接入方从治理层取得（权限过滤也在治理层完成）。
+ * - 标准结构给不了的信息（中文名、分类、图标、风险等级、特殊控件、层级、标签）
+ *   通过可选的 ActionExtension 补充；缺省时按合理默认值降级，保证任何定义都能出现在动作库里。
+ */
+/** 治理层/接入方提供的补充字段（均可选，按名称一一对应） */
+export interface ActionExtension {
+    /** 业务展示名（缺省使用定义名称） */
+    label?: string;
+    description?: string;
+    category?: ActionCategory;
+    icon?: string;
+    riskLevel?: 'safe' | 'sensitive';
+    connector?: string;
+    level?: WorkflowLevel;
+    /** 业务域展示名 */
+    domain?: string;
+    tags?: string[];
+    /** 为 true 时不进入动作库（例如用户无权限、已下线） */
+    hidden?: boolean;
+    /** 按入参 key 覆盖表单字段属性（中文标签、控件类型、下拉选项等） */
+    fieldOverrides?: Record<string, Partial<ActionField>>;
+    /** 按出参 key 覆盖出参说明（中文标签、示例值） */
+    outputOverrides?: Record<string, Partial<ActionOutputField>>;
+}
+/** Conductor `/metadata/taskdefs` 返回的已注册任务定义（只列本模块用到的标准字段） */
+export interface RegisteredTaskDef {
+    name: string;
+    description?: string;
+    /** 仅文档用途，不强制 */
+    inputKeys?: string[];
+    outputKeys?: string[];
+    inputTemplate?: Record<string, any>;
+    inputSchema?: SchemaDef;
+    outputSchema?: SchemaDef;
+    ownerEmail?: string;
+}
+/**
+ * 将 JSON Schema 的 properties 转为表单字段；没有 schema 时退化为仅有 key 列表
+ * （Conductor 的 inputKeys / inputParameters 只有名称），类型一律按文本处理。
+ */
+export declare function buildFields(schema: SchemaDef | undefined, fallbackKeys: string[], inputTemplate?: Record<string, any>): ActionField[];
+/** 出参：优先 outputSchema；其次 outputKeys / outputParameters 的 key（后者是输出模板，其 key 即对外接口） */
+export declare function buildOutputs(schema: SchemaDef | undefined, fallbackKeys: string[], outputTemplate?: Record<string, any>): ActionOutputField[];
+/**
+ * 把流程库中的一个工作流定义生成为动作：业务用户只面对入参表单与出参，
+ * 编译为 SUB_WORKFLOW 引用。版本由步骤上的 libraryRef 决定（首次引用时固定）。
+ * 被 extension.hidden 标记时返回 null。
+ */
+export declare function buildActionFromWorkflowDef(def: WorkflowDef, ext?: ActionExtension): ActionDefinition | null;
+/** 已注册任务定义生成原子动作，编译为同名 SIMPLE 任务。 */
+export declare function buildActionFromTaskDef(def: RegisteredTaskDef, ext?: ActionExtension): ActionDefinition | null;
+export interface LibraryWorkflowEntry {
+    workflowDef: WorkflowDef;
+    extension?: ActionExtension;
+}
+export interface RegisteredTaskEntry {
+    taskDef: RegisteredTaskDef;
+    extension?: ActionExtension;
+}
+/** 批量生成流程库动作（自动跳过 hidden） */
+export declare function buildActionsFromLibrary(entries: LibraryWorkflowEntry[]): ActionDefinition[];
+/** 批量生成原子任务动作（自动跳过 hidden） */
+export declare function buildActionsFromTaskDefs(entries: RegisteredTaskEntry[]): ActionDefinition[];

package/dist/actions/registry.d.ts

@@ -0,0 +1,24 @@
+import type { ActionDefinition, ActionCategory } from './types';
+import type { TaskDef } from '../types/conductor';
+export declare class ActionRegistry {
+    private actions;
+    constructor(initialActions?: ActionDefinition[]);
+    register(action: ActionDefinition): void;
+    registerAll(actions: ActionDefinition[]): void;
+    unregister(id: string): void;
+    getAction(id: string): ActionDefinition | undefined;
+    getAllActions(): ActionDefinition[];
+    getActionsByCategory(category?: ActionCategory): ActionDefinition[];
+    /**
+     * Given a Conductor TaskDef, attempt to find a matching ActionDefinition
+     * and decompile it into friendly form values.
+     */
+    findActionForTask(task: TaskDef): {
+        action: ActionDefinition;
+        values: Record<string, any>;
+    } | null;
+}
+/**
+ * Global default ActionRegistry pre-populated with Cloud Host (ECS) and Common actions
+ */
+export declare const defaultActionRegistry: ActionRegistry;

package/dist/actions/types.d.ts

@@ -0,0 +1,71 @@
+import type { TaskDef } from '../types/conductor';
+import type { WorkflowLevel } from '../types/workflowLibrary';
+export type ActionCategory = 'compute' | 'storage' | 'network' | 'monitor' | 'notify' | 'logic' | 'human' | 'custom';
+export type ActionFieldType = 'text' | 'textarea' | 'number' | 'select' | 'boolean' | 'account' | 'cron-friendly';
+export interface ActionFieldOption {
+    label: string;
+    value: any;
+    description?: string;
+}
+export interface ActionField {
+    key: string;
+    label: string;
+    type: ActionFieldType;
+    help?: string;
+    placeholder?: string;
+    required?: boolean;
+    defaultValue?: any;
+    options?: ActionFieldOption[];
+    acceptsPills?: boolean;
+}
+export interface ActionOutputField {
+    key: string;
+    label: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    example?: any;
+    description?: string;
+}
+export interface CompileCtx {
+    taskReferenceName: string;
+    stepIndex: number;
+    workflowName?: string;
+    /**
+     * 该步骤引用流程库能力时记录的 {名称, 版本}。
+     * 版本在首次引用时固定，库升级后不会自动跟随；version 缺省表示沿用原定义（不显式指定版本）。
+     */
+    libraryRef?: LibraryRef;
+}
+/** 步骤对流程库能力（SUB_WORKFLOW）的引用记录 */
+export interface LibraryRef {
+    name: string;
+    version?: number;
+}
+export interface ActionDefinition {
+    id: string;
+    name: string;
+    category: ActionCategory;
+    icon: string;
+    description: string;
+    connector?: string;
+    /** 动作来源：task = 原子任务（默认），workflow = 流程库能力（以 SUB_WORKFLOW 引用） */
+    kind?: 'task' | 'workflow';
+    /** kind = workflow 时：库中该能力的当前最新版本，用于提示“有新版本可升级” */
+    workflowRef?: {
+        name: string;
+        version: number;
+    };
+    /** 流程库层级 L1 / L2 / L3（调用方向规则见 workflowLibrary） */
+    level?: WorkflowLevel;
+    /** 业务域展示名（流程库动作）；动作选择器据此分组，缺省归入「其他」 */
+    domain?: string;
+    /** 已下线 / 不建议新引用：动作选择器隐藏，但已引用的步骤照常显示与编译 */
+    deprecated?: boolean;
+    tags?: string[];
+    ownerEmail?: string;
+    riskLevel: 'safe' | 'sensitive';
+    fields: ActionField[];
+    outputs: ActionOutputField[];
+    compile: (values: Record<string, any>, ctx: CompileCtx) => TaskDef;
+    decompile?: (task: TaskDef) => Record<string, any> | null;
+    mockOutput?: (values: Record<string, any>) => Record<string, any>;
+}

package/dist/ai.d.ts

@@ -21,6 +21,15 @@ export type { CustomTool } from './services/ai/toolRegistry';
 export type { CustomValidationRule } from './services/ai/ruleEngine';
 export type { TaskSchema } from './services/ai/schemaRegistry';
 export type { WorkflowLevel, WorkflowLibraryItem, WorkflowLibraryDetail } from './types/workflowLibrary';
+export type { LibraryProvider, LibraryExtension, LibraryWorkflowRecord, LibraryTaskRecord, LibraryListResult, LibrarySearchOptions, LibraryLoadStatus, } from './library/types';
+export { LibraryCatalog } from './library/catalog';
+export type { LibraryEntry, LibraryCatalogSnapshot, LibraryCatalogOptions } from './library/catalog';
+export { toActions, toTaskSchemas, toLibraryItems } from './library/projections';
+export { parseWorkflowName, validateWorkflowName } from './library/naming';
+export type { ParsedWorkflowName, WorkflowNameType } from './library/naming';
+export { createConductorLibraryProvider } from './library/conductorProvider';
+export type { ConductorLibraryProviderOptions } from './library/conductorProvider';
+export { DEFAULT_PROMPT_CATALOG_LIMIT } from './services/ai/systemPrompt';
 export type { AiEvent, AiEventType } from './types/aiEvents';
 export type { DiffSummary, PartialAcceptSelection, PatchOp } from './services/ai/toolExecutor';
 export { applyPartialProposal, describeDiff, computeDiff } from './services/ai/toolExecutor';

package/dist/components/AiNative/AiCommandCenter.d.ts

@@ -12,6 +12,10 @@ import type { AiEvent } from '../../types/aiEvents';
 interface AiCommandCenterProps {
     systemPrompt?: string;
     systemPromptExtra?: string;
+    /** 流程库目录注入提示词的条数上限（缺省 50） */
+    promptCatalogLimit?: number;
+    /** 任务 Schema 注入提示词的条数上限（缺省不限制） */
+    promptSchemaLimit?: number;
     showConfigButton?: boolean;
     onShowConfig: () => void;
     executionActions?: ExecutionActions;

package/dist/components/business/ActionForm.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+export interface ActionFormProps {
+    step: BusinessStep;
+    upstreamSteps: BusinessStep[];
+    workflowInputParams?: any[];
+    registry?: ActionRegistry;
+    onChange: (updatedStep: BusinessStep) => void;
+    disabled?: boolean;
+}
+export declare const ActionForm: React.FC<ActionFormProps>;

package/dist/components/business/ActionPickerModal.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
+import type { LibraryCatalog } from '../../library/catalog';
+export interface ActionPickerModalProps {
+    registry: ActionRegistry;
+    /** 展示用的步骤序号（从 1 开始） */
+    stepNumber: number;
+    onClose: () => void;
+    onSelect: (action: ActionDefinition) => void;
+    /**
+     * 当前正在编辑的工作流层级。提供时隐藏违反分层调用规则的流程库动作
+     * （L1 不显示 L2/L3，L2 不显示 L3）；未提供则不按层级过滤。
+     */
+    currentWorkflowLevel?: WorkflowLevel;
+    /** 流程库目录：用于显示「加载中 / 加载失败，点击重试」状态 */
+    libraryCatalog?: LibraryCatalog;
+}
+/**
+ * 业务动作选择弹窗：分类筛选 + 关键字搜索。
+ * 筛选状态与过滤计算都放在弹窗内部：仅在弹窗打开时才会随输入重新计算，
+ * 不再拖累编辑器每次渲染（动作库可能有成百上千项）。
+ */
+export declare const ActionPickerModal: React.FC<ActionPickerModalProps>;

package/dist/components/business/DataPillInput.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+export interface DataPillInputProps {
+    value: any;
+    onChange: (val: any) => void;
+    placeholder?: string;
+    multiline?: boolean;
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    workflowInputParams?: any[];
+    disabled?: boolean;
+    /** 初始即展开「插入数据」选择面板（例如下拉字段刚切换为动态取值时） */
+    defaultShowPicker?: boolean;
+}
+export declare const DataPillInput: React.FC<DataPillInputProps>;

package/dist/components/business/DecisionBranchCard.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+export interface DecisionBranchCardProps {
+    step: BusinessStep;
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    disabled?: boolean;
+    onChange: (updated: BusinessStep) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
+    depth?: number;
+}
+export declare const DecisionBranchCard: React.FC<DecisionBranchCardProps>;

package/dist/components/business/ForkJoinCard.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+export interface ForkJoinCardProps {
+    step: BusinessStep;
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    disabled?: boolean;
+    onChange: (updated: BusinessStep) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
+    depth?: number;
+}
+export declare const ForkJoinCard: React.FC<ForkJoinCardProps>;

package/dist/components/business/FriendlyErrorCard.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export interface FriendlyErrorCardProps {
+    rawError?: string;
+    statusCode?: number;
+    taskName?: string;
+    onActionClick?: (actionKey?: string) => void;
+}
+export declare const FriendlyErrorCard: React.FC<FriendlyErrorCardProps>;

package/dist/components/business/LibraryVersionBadge.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import type { ActionDefinition } from '../../actions/types';
+import type { LibraryCatalog } from '../../library/catalog';
+import { type WorkflowVersionDiff } from '../../library/diff';
+export interface LibraryVersionBadgeProps {
+    step: BusinessStep;
+    action?: ActionDefinition;
+    disabled?: boolean;
+    /**
+     * 流程库目录。提供后：
+     * - 升级前取旧、新两个版本的定义，展示入参 / 出参差异再确认
+     * - 固定版本在库中不存在 / 已下线时显示「⚠ 版本不可用」
+     * 未提供时沿用旧行为（只按动作上记录的最新版本提示升级）。
+     */
+    catalog?: LibraryCatalog;
+    /** 其它步骤中引用了本步骤哪些出参 key（用于差异里的「下游引用将失效」提示） */
+    getReferencedOutputs?: () => Iterable<string>;
+    /** 用户确认升级后回调：库中最新版本号，以及（能取到两个版本定义时的）升级差异 */
+    onUpgrade: (latestVersion: number, diff?: WorkflowVersionDiff) => void;
+}
+/**
+ * 流程库能力的版本标记：
+ * - 显示步骤引用时固定的版本（库升级后不会自动跟随）
+ * - 库中有更新版本时，提示并允许用户在看过升级差异后手动升级
+ * - 固定版本不可用（不存在 / 已下线）时给出警示，保持原样编译，不自动改版本
+ * - 目录加载失败时不显示新版本提示，不影响编辑与编译
+ */
+export declare const LibraryVersionBadge: React.FC<LibraryVersionBadgeProps>;

package/dist/components/business/LoopDoWhileCard.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+export interface LoopDoWhileCardProps {
+    step: BusinessStep;
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    disabled?: boolean;
+    onChange: (updated: BusinessStep) => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** 嵌套深度：顶层卡片为 0，其内部子控制流依次 +1 */
+    depth?: number;
+}
+export declare const LoopDoWhileCard: React.FC<LoopDoWhileCardProps>;

package/dist/components/business/NestedControlStep.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+export interface NestedControlStepProps {
+    step: BusinessStep;
+    index: number;
+    /** 当前嵌套层级（顶层卡片内的第一层子控制流为 1），用于缩进与视觉区分 */
+    depth?: number;
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    disabled?: boolean;
+    onChange: (updated: BusinessStep) => void;
+    onDelete: () => void;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+}
+/**
+ * 分支 / 并行泳道 / 循环体内部的"子控制流"渲染器。
+ * 通过它，DecisionBranchCard / ForkJoinCard / LoopDoWhileCard 可以互相递归嵌套，
+ * 支持例如「分支 A 内再包含一个分支」「泳道内再有并行或循环」等任意层级。
+ */
+export declare const NestedControlStep: React.FC<NestedControlStepProps>;

package/dist/components/business/PillPicker.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { BusinessStep, PillToken } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+export interface PillPickerProps {
+    upstreamSteps: BusinessStep[];
+    onSelect: (pill: PillToken) => void;
+    onClose: () => void;
+    registry?: ActionRegistry;
+    workflowInputParams?: any[];
+}
+export declare const PillPicker: React.FC<PillPickerProps>;

package/dist/components/business/RunStoryTimeline.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { WorkflowInstance } from '../../types/conductor';
+import { ActionRegistry } from '../../actions/registry';
+export interface RunStoryTimelineProps {
+    instance: WorkflowInstance;
+    registry?: ActionRegistry;
+    onInspectStep?: (taskRef: string) => void;
+}
+export declare const RunStoryTimeline: React.FC<RunStoryTimelineProps>;

package/dist/components/business/StepFlowEditor.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { WorkflowDef, WorkflowInstance } from '../../types/conductor';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { LibraryCatalog } from '../../library/catalog';
+import type { WorkflowLevel } from '../../types/workflowLibrary';
+export interface StepFlowEditorProps {
+    workflowDef: WorkflowDef | null;
+    onChange: (def: WorkflowDef) => void;
+    registry?: ActionRegistry;
+    readOnly?: boolean;
+    workflowExecution?: WorkflowInstance;
+    /** 流程库目录（由 WorkflowIDE 按 libraryProvider 创建）：用于动作选择器状态与版本徽标 */
+    libraryCatalog?: LibraryCatalog;
+    /** 当前正在编辑的工作流层级：提供时选择器隐藏违反分层调用规则的流程库动作 */
+    currentWorkflowLevel?: WorkflowLevel;
+    /** 提供时，步骤头部显示「🤖」按钮，点击请 AI 介绍该步骤（AI IDE 中使用） */
+    onAskAi?: (step: BusinessStep) => void;
+}
+export declare const StepFlowEditor: React.FC<StepFlowEditorProps>;

package/dist/components/business/StepListEditor.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { BusinessStep } from '../../stepmodel/types';
+import { ActionRegistry } from '../../actions/registry';
+import type { ActionDefinition } from '../../actions/types';
+export interface StepListEditorProps {
+    steps: BusinessStep[];
+    onStepsChange: (next: BusinessStep[]) => void;
+    /** 本列表之前的所有上游步骤（用于参数胶囊联想）；列表内前序步骤会自动追加 */
+    upstreamSteps: BusinessStep[];
+    registry?: ActionRegistry;
+    disabled?: boolean;
+    /** 本列表所在容器的嵌套深度（顶层容器为 0） */
+    depth: number;
+    onOpenInsertModal: (callback: (action: ActionDefinition) => void) => void;
+    /** regular：分支 / 循环体内的宽松行；compact：并行泳道内的窄列行 */
+    variant?: 'regular' | 'compact';
+    /** 行背景色调；展开区域使用相反色调，保持层次 */
+    rowTone?: 'primary' | 'secondary';
+    /** 序号徽标前缀，如「轮内 」 */
+    indexPrefix?: string;
+    /** 序号徽标是否使用强调色（默认为中性底色） */
+    accentIndexBadge?: boolean;
+}
+/**
+ * 分支 / 并行泳道 / 循环体共用的"子步骤列表"：
+ * - 普通动作渲染为可展开的表单行
+ * - 控制流步骤（分支 / 并行 / 循环）交给 NestedControlStep 递归渲染，因此可任意层级嵌套
+ */
+export declare const StepListEditor: React.FC<StepListEditorProps>;

package/dist/components/template/TemplateExtractor.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { WorkflowInstance } from '../../types/conductor';
+import type { WorkflowTemplate } from '../../template/types';
+export interface TemplateExtractorProps {
+    isOpen: boolean;
+    instance: WorkflowInstance;
+    onClose: () => void;
+    onPublished?: (template: WorkflowTemplate) => void;
+}
+export declare const TemplateExtractor: React.FC<TemplateExtractorProps>;

package/dist/components/template/TemplateGallery.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { WorkflowDef } from '../../types/conductor';
+import { TemplateStore } from '../../template/templateStore';
+export interface TemplateGalleryProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSelectTemplate: (configuredDef: WorkflowDef) => void;
+    templateStore?: TemplateStore;
+}
+export declare const TemplateGallery: React.FC<TemplateGalleryProps>;

package/dist/components/template/TemplateSetupWizard.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { WorkflowDef } from '../../types/conductor';
+import type { WorkflowTemplate } from '../../template/types';
+export interface TemplateSetupWizardProps {
+    template: WorkflowTemplate;
+    onApply: (configuredDef: WorkflowDef) => void;
+    onClose: () => void;
+}
+export declare const TemplateSetupWizard: React.FC<TemplateSetupWizardProps>;