@yiyi_zhang/reactflow-ui 1.1.0 → 1.2.0

package/dist/sample-workflows/library-capabilities-demo.json

@@ -0,0 +1,66 @@
+{
+  "name": "custom-L2-应用管理-demo-library_showcase",
+  "description": "流程库能力演示：引用治理服务中的库能力并固定版本。含「有新版本」、「版本不可用」（已撤回 / 已下线）与当前版本四种状态。",
+  "version": 1,
+  "schemaVersion": 2,
+  "ownerEmail": "platform-governance@example.com",
+  "tasks": [
+    {
+      "name": "std-L1-配置管理-cmdb-query_ci",
+      "taskReferenceName": "query_ci",
+      "type": "SUB_WORKFLOW",
+      "description": "查询配置项（固定 v1，库已有 v2：新增必填「租户编号」、删除出参「耗时」）",
+      "inputParameters": {
+        "ciType": "服务器",
+        "keyword": "order",
+        "pageSize": 20
+      },
+      "subWorkflowParam": {
+        "name": "std-L1-配置管理-cmdb-query_ci",
+        "version": 1
+      }
+    },
+    {
+      "name": "std-L1-云资源-ecs-snapshot",
+      "taskReferenceName": "snapshot_vm",
+      "type": "SUB_WORKFLOW",
+      "description": "云主机快照（固定 v1，该版本已被治理服务撤回）",
+      "inputParameters": {
+        "instanceId": "i-demo0001"
+      },
+      "subWorkflowParam": {
+        "name": "std-L1-云资源-ecs-snapshot",
+        "version": 1
+      }
+    },
+    {
+      "name": "std-L1-系统工具-sftp-upload_file",
+      "taskReferenceName": "upload_pkg",
+      "type": "SUB_WORKFLOW",
+      "description": "SFTP 上传文件（该能力已下线）",
+      "inputParameters": {
+        "host": "10.20.30.41",
+        "remotePath": "/data/upload",
+        "fileUrl": "http://mock-gateway.internal/files/demo.tar.gz"
+      },
+      "subWorkflowParam": {
+        "name": "std-L1-系统工具-sftp-upload_file",
+        "version": 1
+      }
+    },
+    {
+      "name": "std-L1-通知协助-msg-send_sms",
+      "taskReferenceName": "notify_owner",
+      "type": "SUB_WORKFLOW",
+      "description": "发送短信（固定 v2，即当前最新版本）",
+      "inputParameters": {
+        "phone": "13800000001",
+        "content": "配置项查询完成，共 ${query_ci.output.total} 条，耗时 ${query_ci.output.costMs} 毫秒"
+      },
+      "subWorkflowParam": {
+        "name": "std-L1-通知协助-msg-send_sms",
+        "version": 2
+      }
+    }
+  ]
+}

package/dist/services/ai/agentRunner.d.ts

@@ -15,6 +15,7 @@
  */
 import type { AiStore } from '../../store/aiStore';
 import type { LibraryStore } from '../../store/libraryStore';
+import type { LibraryCatalog } from '../../library/catalog';
 import type { ToolRegistry } from './toolRegistry';
 import type { AiEvent } from '../../types/aiEvents';
 import type { UseBoundStore, StoreApi } from 'zustand';
@@ -26,11 +27,17 @@ export interface AgentRunnerOptions {
         canRepair?: boolean;
     };
     onAiEvent?: (event: AiEvent) => void;
+    /** 流程库目录注入系统提示词的条数上限（缺省 50）；超出部分提示 AI 改用 search_workflow_library */
+    promptCatalogLimit?: number;
+    /** 任务 Schema 注入系统提示词的条数上限（缺省不限制） */
+    promptSchemaLimit?: number;
 }
 export interface AgentRunnerStores {
     aiStore: UseBoundStore<StoreApi<AiStore>>;
     libraryStore: UseBoundStore<StoreApi<LibraryStore>>;
     toolRegistry: ToolRegistry;
+    /** 本 IDE 实例的流程库目录；提供后用于固定子工作流版本与服务端检索 */
+    libraryCatalog?: LibraryCatalog;
 }
 export declare class AgentRunner {
     private getOptions;
@@ -39,7 +46,11 @@ export declare class AgentRunner {
     constructor(getOptions: () => AgentRunnerOptions, stores: AgentRunnerStores);
     abort(): void;
     private toolExecutionContext;
+    /** 子工作流版本固定：把目录里的「当前最新版本」以查询函数的形式注入纯函数的工具执行层 */
+    private latestVersionResolver;
     private buildHistory;
+    /** 服务端检索：Provider 没有 search、或检索失败时返回 undefined（调用方退回本地匹配） */
+    private serverLibrarySearch;
     /**
      * Immediately promotes the current in-progress `workingDraft` (from an interrupted or paused
      * multi-phase session) into a reviewable `pendingProposal`.

package/dist/services/ai/schemaRegistry.d.ts

@@ -45,7 +45,13 @@ declare class SchemaRegistry {
     get(taskName: string): TaskSchema | undefined;
     getAll(): TaskSchema[];
     hasSchemas(): boolean;
-    buildPromptSection(): string | null;
+    /**
+     * @param options.limit 最多注入的 Schema 条数（缺省不限制）。目录很大时用来控制提示词体积，
+     *                      超出部分提示改用 search_workflow_library 检索。
+     */
+    buildPromptSection(options?: {
+        limit?: number;
+    }): string | null;
 }
 export declare const schemaRegistry: SchemaRegistry;
 export {};

package/dist/services/ai/systemPrompt.d.ts

@@ -27,4 +27,15 @@ export declare function buildSystemPrompt(userInput: string, workflowSnapshot: W
     systemPromptExtra?: string;
     viewMode?: ViewMode;
     pendingProposalDef?: import('../../types/conductor').WorkflowDef;
+    /** 流程库目录注入提示词的条数上限，默认 DEFAULT_PROMPT_CATALOG_LIMIT；超出部分提示改用 search_workflow_library */
+    promptCatalogLimit?: number;
+    /** 任务 Schema 注入提示词的条数上限；缺省不限制（保持旧行为） */
+    promptSchemaLimit?: number;
 }): string;
+/** 目录注入提示词的默认条数上限（治理平台可能有 1000+ 工作流，不能全量塞进提示词） */
+export declare const DEFAULT_PROMPT_CATALOG_LIMIT = 50;
+/**
+ * 构建流程库目录段落。
+ * 超过 limit 时按层级 L3 -> L2 -> L1 截断（高层场景优先），并写明剩余数量与检索指引。
+ */
+export declare function buildLibraryCatalog(allItems: WorkflowLibraryItem[], limit?: number): string | null;

package/dist/services/ai/toolExecutor.d.ts

@@ -84,7 +84,19 @@ export interface ToolExecutionContext {
     workingDraft?: WorkflowDef | null;
     validationResults: ValidationResults;
     libraryItems: WorkflowLibraryItem[];
+    /**
+     * 查询流程库中某个名称的当前最新版本（由调用方注入，本模块保持纯净、不读 store）。
+     * 提供后，AI 新建的 SUB_WORKFLOW 缺少版本时固定为库当前版本；已有版本号一律不改。
+     */
+    resolveLatestVersion?: (name: string) => number | undefined;
+    /**
+     * 服务端检索命中（由调用方在调用前预取，通常来自 LibraryProvider.search）。
+     * 提供时 search_workflow_library 直接展示这些结果，不再在 libraryItems 内本地匹配。
+     */
+    librarySearchResults?: WorkflowLibraryItem[];
 }
+/** 工作流库检索结果最多展示的条数（目录可能有上千项，避免一次塞满上下文） */
+export declare const LIBRARY_SEARCH_RESULT_LIMIT = 50;
 export declare function applyPatch(def: WorkflowDef, ops: PatchOp[]): WorkflowDef;
 export declare function computeDiff(before: WorkflowDef | null, after: WorkflowDef): DiffSummary;
 export declare function executeToolCall(toolName: string, args: Record<string, any>, ctx: ToolExecutionContext): ToolCallResult;

package/dist/services/ai/workflowSynthesizer.d.ts

@@ -66,6 +66,21 @@ export interface VerificationSummary {
  * Collects all tasks in execution order (pre-order traversal of top-level and nested tasks).
  */
 export declare function collectAllTasksInOrder(tasks?: TaskDef[]): TaskDef[];
+/**
+ * 规范化选项（均为可选，保持本模块为纯函数：数据由调用方注入，不读取任何 store）。
+ */
+export interface NormalizeOptions {
+    /**
+     * 查询工作流库中某个名称的当前最新版本。提供后，新建的 SUB_WORKFLOW 若没有
+     * `subWorkflowParam.version`，会固定为库当前版本；已有版本号一律不改。
+     */
+    resolveLatestVersion?: (name: string) => number | undefined;
+    /**
+     * 画布上已存在的任务引用名。这些任务不会被自动补版本——
+     * 未固定版本的旧步骤保持原语义，避免 AI 改动其它内容时顺带改变它们。
+     */
+    existingRefs?: ReadonlySet<string>;
+}
 /**
  * Normalizes a single task's structure to prevent common LLM schema mismatches:
  * - Ensures `name` and `taskReferenceName` and `type` exist
@@ -73,7 +88,7 @@ export declare function collectAllTasksInOrder(tasks?: TaskDef[]): TaskDef[];
  * - Normalizes `SUB_WORKFLOW` `workflowName` into `subWorkflowParam.name`
  * - Normalizes `TERMINATE` `terminationStatus` into `inputParameters.terminationStatus`
  */
-export declare function normalizeTaskDef(task: TaskDef, autoFixed?: string[]): TaskDef;
+export declare function normalizeTaskDef(task: TaskDef, autoFixed?: string[], options?: NormalizeOptions): TaskDef;
 /**
  * Extracts all `${...}` expressions from an arbitrary JSON value.
  */
@@ -84,7 +99,17 @@ export declare function extractExpressions(value: any): string[];
  * - Normalizes all tasks and FORK_JOIN <-> JOIN pairings
  * - Auto-collects `${workflow.input.xxx}` into `workflow.inputParameters` if missing
  */
-export declare function normalizeWorkflowDef(def: WorkflowDef): {
+export declare function normalizeWorkflowDef(def: WorkflowDef, options?: NormalizeOptions): {
+    workflow: WorkflowDef;
+    autoFixed: string[];
+};
+/**
+ * 只做「SUB_WORKFLOW 固定版本」的轻量规范化（供 replace_workflow / patch_workflow 使用，
+ * 这两条路径不经过完整的 normalizeWorkflowDef）：
+ * 为新建的、未记录版本的子工作流任务填入流程库当前版本。已有版本号、画布上已存在的任务一律不改。
+ * 未提供 resolveLatestVersion 时原样返回。
+ */
+export declare function pinSubWorkflowVersions(def: WorkflowDef, options: NormalizeOptions): {
     workflow: WorkflowDef;
     autoFixed: string[];
 };
@@ -102,7 +127,7 @@ export declare function applyTopologyScaffold(currentDraft: WorkflowDef | null,
 /**
  * Phase 3: Enriches individual tasks in the working draft with detailed configurations.
  */
-export declare function applyTaskConfigurations(currentDraft: WorkflowDef, args: ConfigureTasksArgs): {
+export declare function applyTaskConfigurations(currentDraft: WorkflowDef, args: ConfigureTasksArgs, options?: NormalizeOptions): {
     workflow: WorkflowDef;
     configuredRefs: string[];
     missingRefs: string[];

package/dist/stepmodel/compile.d.ts

@@ -2,4 +2,10 @@ import type { WorkflowDef, TaskDef } from '../types/conductor';
 import type { BusinessWorkflowModel, BusinessStep } from './types';
 import { ActionRegistry } from '../actions/registry';
 export declare function compileStepToTaskDef(step: BusinessStep, index: number, workflowName: string, registry?: ActionRegistry): TaskDef;
+/**
+ * 编译一组顺序步骤（顶层、分支内、泳道内、循环体内通用，可任意层级嵌套）。
+ * 遇到 FORK_JOIN 时，会在其后自动补全配对的 JOIN 节点，
+ * joinOn 取各泳道编译后的最后一个任务（若泳道末尾是嵌套并行，则为其 JOIN）。
+ */
+export declare function compileStepList(steps: BusinessStep[], workflowName: string, registry?: ActionRegistry): TaskDef[];
 export declare function compileStepModelToWorkflowDef(model: BusinessWorkflowModel, registry?: ActionRegistry): WorkflowDef;

package/dist/stepmodel/decompile.d.ts

@@ -2,4 +2,9 @@ import type { WorkflowDef, TaskDef } from '../types/conductor';
 import type { BusinessWorkflowModel, BusinessStep } from './types';
 import { ActionRegistry } from '../actions/registry';
 export declare function decompileTaskDefToStep(task: TaskDef, index: number, registry?: ActionRegistry): BusinessStep;
+/**
+ * 反编译一组顺序任务（顶层、分支内、泳道内、循环体内通用，可任意层级嵌套）。
+ * FORK_JOIN 后配对的 JOIN 节点会被折叠进并行组（记录在 pairedJoinTaskRef），不单独成步。
+ */
+export declare function decompileTaskList(tasks: TaskDef[], registry?: ActionRegistry): BusinessStep[];
 export declare function decompileWorkflowDefToStepModel(def: WorkflowDef | null | undefined, registry?: ActionRegistry): BusinessWorkflowModel;

package/dist/stepmodel/factory.d.ts

@@ -0,0 +1,8 @@
+import type { ActionDefinition } from '../actions/types';
+import type { BusinessStep } from './types';
+/**
+ * 根据动作定义创建一个新的业务步骤。
+ * 控制流动作（分支 / 并行 / 循环）会生成带 controlType 的容器步骤，
+ * 因此可以在任意层级（顶层、分支内、泳道内、循环体内）递归嵌套。
+ */
+export declare function createStepFromAction(action: ActionDefinition): BusinessStep;

package/dist/stepmodel/types.d.ts

@@ -1,4 +1,5 @@
 import type { TaskDef, WorkflowDef } from '../types/conductor';
+import type { LibraryRef } from '../actions/types';
 export interface PillToken {
     /** The Conductor reference path, e.g. "ecs_create_0.output.instanceId" or "workflow.input.userId" */
     rawRef: string;
@@ -42,6 +43,8 @@ export interface BusinessStep {
      */
     isProFallback?: boolean;
     rawTaskDef?: TaskDef;
+    /** 引用流程库能力时记录的名称与版本（首次引用时固定，不随库升级自动变化） */
+    libraryRef?: LibraryRef;
     controlType?: StepControlType;
     caseParam?: string;
     caseExpression?: string;

package/dist/store/ideStoresContext.d.ts

@@ -20,10 +20,13 @@ import type { UseBoundStore, StoreApi } from 'zustand';
 import type { AiStore } from './aiStore';
 import type { LibraryStore } from './libraryStore';
 import type { ToolRegistry } from '../services/ai/toolRegistry';
+import type { LibraryCatalog } from '../library/catalog';
 export interface IdeStores {
     aiStore: UseBoundStore<StoreApi<AiStore>>;
     libraryStore: UseBoundStore<StoreApi<LibraryStore>>;
     toolRegistry: ToolRegistry;
+    /** 本实例的流程库目录（LibraryProvider 规范化后的单一数据源）；每个实例独立，不是全局单例 */
+    libraryCatalog?: LibraryCatalog;
 }
 export declare function IdeStoresProvider({ stores, children }: {
     stores: IdeStores;

package/dist/store/workflowStore.d.ts

@@ -17,6 +17,7 @@ declare const useWorkflowStore: import("zustand").UseBoundStore<Omit<Omit<import
         workflowDef: WorkflowDef | null;
         layoutDirection: LayoutDirection;
         nodes: import("../types/workflow").WorkflowNode[];
+        graphStale: boolean;
         edges: import("reactflow").Edge[];
         taskMap: Record<string, TaskDef>;
         theme: ThemeMode;

package/dist/types/conductor.d.ts

@@ -74,6 +74,17 @@ export interface TaskDef {
     timeoutSeconds?: number;
     timeoutPolicy?: 'RETRY' | 'TIME_OUT_WF' | 'ALERT_ONLY' | 'FAIL_WORKFLOW';
 }
+/**
+ * Conductor 标准 Schema 定义（WorkflowDef / TaskDef 的 inputSchema / outputSchema）。
+ * 仅 JSON 类型会被服务端真正校验；data 为 JSON Schema 文档本身。
+ */
+export interface SchemaDef {
+    name?: string;
+    version?: number;
+    type?: 'JSON' | 'AVRO' | 'PROTOBUF' | string;
+    data?: Record<string, any>;
+    externalRef?: string;
+}
 /**
  * 工作流入参定义（结构化，向后兼容 string[] 旧格式）
  */
@@ -133,15 +144,9 @@ export interface WorkflowDef {
         concurrentExecLimit?: number;
     };
     /** 输入 Schema 定义 */
-    inputSchema?: {
-        name?: string;
-        type?: string;
-    };
+    inputSchema?: SchemaDef;
     /** 输出 Schema 定义 */
-    outputSchema?: {
-        name?: string;
-        type?: string;
-    };
+    outputSchema?: SchemaDef;
     /** 是否强制 Schema 校验 */
     enforceSchema?: boolean;
 }

package/dist/types/workflow.d.ts

@@ -205,6 +205,11 @@ export interface WorkflowState {
     isSimRunning: boolean;
     /** 每次 setWorkflow() 调用时递增，用于触发 WorkflowDesigner 的 fitView */
     workflowLoadKey: number;
+    /**
+     * 画布数据（nodes/edges/taskMap）是否落后于 workflowDef。
+     * 业务卡片视图下画布未挂载，编辑只更新定义（setWorkflowDefOnly），切回画布前再 refreshGraph()。
+     */
+    graphStale: boolean;
     /** P4.2 执行触发状态 */
     runState: RunState;
     pendingExecutionId: string | null;
@@ -237,6 +242,10 @@ export interface WorkflowState {
  */
 export interface WorkflowActions {
     setWorkflow: (workflowJson: any, direction?: LayoutDirection) => void;
+    /** 仅更新定义与校验结果，不重建画布（业务卡片视图下的高频编辑使用）；画布数据标记为过期 */
+    setWorkflowDefOnly: (workflowJson: any) => void;
+    /** 画布数据过期时，按当前定义重新解析并布局；未过期则什么都不做 */
+    refreshGraph: () => void;
     setMode: (mode: EditorMode) => void;
     setExecutionData: (data: Record<string, TaskExecutionData> | null) => void;
     updateTaskStatus: (taskRef: string, status: ExecutionStatus) => void;

package/dist/types/workflowLibrary.d.ts

@@ -17,6 +17,8 @@ export type WorkflowLevel = 'L1' | 'L2' | 'L3';
 export interface WorkflowLibraryItem {
     workflowName: string;
     workflowLevel: WorkflowLevel;
+    /** 业务域展示名（可选，如「通知协助」） */
+    domain?: string;
     version: string;
     description: string;
     tags: string[];

package/dist/utils/taskTypeMeta.d.ts

@@ -1,9 +1,9 @@
 /**
  * Task Type Meta — business-friendly labels for Conductor task types
  *
- * Shared by BusinessCanvas and ProposalPreviewCard so both surfaces speak the
- * same business language for the same task type (extracted from BusinessCanvas
- * during the UX Phase A proposal-preview work).
+ * Used by ProposalPreviewCard so AI proposals speak business language for each
+ * task type (originally extracted from the former BusinessCanvas, which the AI IDE
+ * business view replaced with StepFlowEditor in 1.2.x).
  */
 export interface TaskTypeMeta {
     label: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiyi_zhang/reactflow-ui",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Conductor Workflow IDE — Next-Gen AI-Native visual workflow designer with W-LSP data lineage, deterministic in-browser sandbox dry-run, time-travel waterfall debugger, and live split-view sync built with React 19, ReactFlow and Zustand.",
   "keywords": [
     "conductor",

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

@@ -1,15 +0,0 @@
-/**
- * BusinessCanvas — renders a WorkflowDef as business-friendly step cards
- * for non-technical users (business view mode).
- */
-import React from 'react';
-import type { WorkflowDef } from '../../types/conductor';
-interface BusinessCanvasProps {
-    workflowDef: WorkflowDef | null;
-    /** Task statuses from execution (ref → status) */
-    executionStatus?: Record<string, string>;
-    /** Called when user clicks a step to ask AI about it */
-    onStepClick?: (taskRef: string, taskType: string) => void;
-}
-declare const BusinessCanvas: React.FC<BusinessCanvasProps>;
-export default BusinessCanvas;