@yiyi_zhang/reactflow-ui 1.1.0 → 1.3.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/sandboxRunObserver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * store 动作的观察者（专业模式埋点用）。
+ *
+ * - 试跑：专业模式的本地试跑统一经过 store 的 `runLocalSandboxDryRun`（ActionBar 一键试跑与
+ *   SandboxConfigModal 都走它），在那里通知即可，不必在每个入口各自埋点。只传最终状态（或 'error'），
+ *   不传输入 / 输出数据。业务模式（StepFlowEditor）与模板试跑不经过该 action，由各自的回调上报，因此不会重复。
+ * - 新增步骤：画布「+」与 Cmd+K 内联 Copilot 都经过 store 的 `addNode`，来源固定为 'builtin'。
+ *
+ * 模块级集合：IDE 挂载时订阅、卸载时取消。store 本身是页面内单例，同一页面挂载多个 IDE 时各自都会收到通知。
+ */
+export type SandboxRunObserver = (result: string) => void;
+export type StepAddedObserver = (source: 'builtin') => void;
+/** 订阅试跑结果；返回取消订阅函数 */
+export declare function subscribeSandboxRun(observer: SandboxRunObserver): () => void;
+/** 通知试跑结果；观察者抛错不影响试跑 */
+export declare function notifySandboxRun(result: string): void;
+/** 订阅专业模式新增步骤；返回取消订阅函数 */
+export declare function subscribeStepAdded(observer: StepAddedObserver): () => void;
+export declare function notifyStepAdded(source: 'builtin'): void;

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/telemetry/buffer.d.ts

@@ -0,0 +1,37 @@
+import type { IdeEvent, TelemetrySink } from './types';
+/** 定时器注入点（测试用）；默认使用全局 setTimeout / clearTimeout */
+export interface TelemetryTimers {
+    set(fn: () => void, ms: number): unknown;
+    clear(handle: unknown): void;
+}
+/** 最小事件目标接口（document / window 或测试替身） */
+export interface TelemetryEventTarget {
+    addEventListener(type: string, listener: () => void): void;
+    removeEventListener(type: string, listener: () => void): void;
+}
+export interface TelemetryBufferOptions {
+    /** 距第一条待发送事件多久后 flush。默认 5000 */
+    flushIntervalMs?: number;
+    /** 累计多少条立即 flush。默认 20 */
+    maxBatchSize?: number;
+    timers?: TelemetryTimers;
+    /** 监听 `visibilitychange`（读取 visibilityState）；默认取全局 document，非浏览器环境忽略 */
+    document?: (TelemetryEventTarget & {
+        visibilityState?: string;
+    }) | null;
+    /** 监听 `pagehide`；默认取全局 window，非浏览器环境忽略 */
+    window?: TelemetryEventTarget | null;
+}
+export interface TelemetryBuffer {
+    /** 入队；sink 缺失时丢弃。永不抛出 */
+    push(event: IdeEvent): void;
+    /** 立即发送队列中的事件。永不抛出 */
+    flush(): void;
+    /** flush 并移除定时器与页面监听；之后 push 无效 */
+    dispose(): void;
+}
+/**
+ * 创建埋点缓冲：批量发送、页面隐藏时 flush、吞掉 sink 的任何错误（只 warn 一次）。
+ * sink 为空时 push 直接丢弃，不产生定时器与监听。
+ */
+export declare function createTelemetryBuffer(sink: TelemetrySink | undefined | null, opts?: TelemetryBufferOptions): TelemetryBuffer;

package/dist/telemetry/once.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 「每个实例只执行一次」的守卫，用于 `ide_opened` 去重。
+ *
+ * React StrictMode（开发环境）会把 effect 执行 → 清理 → 再执行一次，但 `useRef` 的值在两次之间保留，
+ * 所以把守卫放在 ref 里即可保证同一个 IDE 实例只上报一次；真正重新挂载（新实例）会得到新的守卫。
+ */
+export interface OnceGuard {
+    /** 第一次调用返回 true，之后都返回 false */
+    take(): boolean;
+}
+export declare function createOnceGuard(): OnceGuard;

package/dist/telemetry/track.d.ts

@@ -0,0 +1,17 @@
+import type { IdeEvent, IdeEventName } from './types';
+export type IdeEventProps = Record<string, string | number | boolean>;
+/**
+ * 只保留 string / number（有限）/ boolean 的属性值，其余（对象、数组、函数、null、undefined、NaN）一律丢弃，
+ * 避免上层误把参数、表达式等载荷塞进埋点。全部被丢弃时返回 undefined。
+ */
+export declare function sanitizeProps(props: Record<string, unknown> | undefined | null): IdeEventProps | undefined;
+export interface TrackerOptions {
+    ide: 'workflow' | 'ai';
+    /** 返回当前流程名；每次 track 时调用 */
+    getWorkflowName: () => string | undefined;
+    /** 事件发往的缓冲；返回 undefined 表示没有 sink */
+    push: (event: IdeEvent) => void;
+    now?: () => number;
+}
+/** 构造事件并交给 push：补齐 at / ide / workflowName，清洗 props。永不抛出。 */
+export declare function createTracker(opts: TrackerOptions): (name: IdeEventName, props?: Record<string, unknown>) => void;

package/dist/telemetry/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 接入埋点：事件与 Sink 契约（设计见 docs/design/v1.3.0-自助接入设计.md 第 5 节）。
+ *
+ * 只采集「用了什么功能」，不采集参数值、表达式、提示词、对话内容、执行数据。
+ */
+/**
+ * 事件名清单（首批，与设计文档 5.2 节、接入指南「接入埋点」表一致；
+ * 单测会校验三处同步，新增事件时请一并更新文档）。
+ */
+export declare const IDE_EVENT_NAMES: readonly ["ide_opened", "trial_started", "workflow_created", "step_added", "api_imported", "sandbox_run", "workflow_saved", "promotion_requested", "promotion_state", "ai_event"];
+export type IdeEventName = typeof IDE_EVENT_NAMES[number];
+export interface IdeEvent {
+    name: IdeEventName;
+    /** epoch ms */
+    at: number;
+    ide: 'workflow' | 'ai';
+    /** 不含任何参数值 */
+    workflowName?: string;
+    props?: Record<string, string | number | boolean>;
+}
+export interface TelemetrySink {
+    /** SDK 侧批量调用（默认 5 秒或 20 条），页面隐藏时强制 flush */
+    track(events: IdeEvent[]): void | Promise<void>;
+}

package/dist/telemetry/useTelemetry.d.ts

@@ -0,0 +1,22 @@
+import type { IdeEventName, TelemetrySink } from './types';
+/**
+ * IDE 内部使用：按解析后的 sink 维护一个缓冲，返回稳定的 `track(name, props?)`。
+ * - `at` / `ide` / `workflowName`（取当前画布流程名）自动补齐；
+ * - `props` 只保留 string / number / boolean；
+ * - sink 变化时先把旧缓冲 flush 给旧 sink；卸载时 flush；
+ * - 没有 sink 时 track 为空操作。
+ */
+export declare function useTelemetry(ide: 'workflow' | 'ai', sink: TelemetrySink | undefined): (name: IdeEventName, props?: Record<string, unknown>) => void;
+type Track = (name: IdeEventName, props?: Record<string, unknown>) => void;
+/**
+ * 挂载时上报一次 `ide_opened`。守卫放在 ref 里：StrictMode 的「执行 → 清理 → 再执行」不会重复上报；
+ * 真正重新挂载（新实例）会得到新的守卫。
+ */
+export declare function useIdeOpenedOnce(track: Track): void;
+/**
+ * 专业模式经 store 的操作统一上报：
+ * - 本地试跑（`runLocalSandboxDryRun`）→ `sandbox_run`，`entry: 'pro'`
+ * - 画布新增步骤（`addNode`）→ `step_added`，`source: 'builtin'`
+ */
+export declare function useProStoreTelemetry(track: Track): void;
+export {};

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.3.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;