@yiyi_zhang/reactflow-ui 0.4.0 → 0.5.0-beta.0

package/dist/types/aiEvents.d.ts

@@ -0,0 +1,38 @@
+/**
+ * AI Event types for audit logging and analytics.
+ *
+ * Pass an `onAiEvent` callback to <AiWorkflowIDE> to receive all AI lifecycle events.
+ *
+ * ```tsx
+ * <AiWorkflowIDE
+ *   onAiEvent={(event) => auditLog.record(event)}
+ * />
+ * ```
+ */
+export type AiEventType = 'proposal:created' | 'proposal:accepted' | 'proposal:accepted:partial' | 'proposal:rejected' | 'plan:created' | 'plan:executed' | 'plan:cancelled' | 'repair:proposed'
+/** User clicked the inline second-click confirmation before a runtime-mutating repair action fires */
+ | 'repair:confirmed' | 'repair:executed' | 'repair:dismissed' | 'tool:called' | 'undo:applied'
+/** AI request failed (network/HTTP/provider error). The user only ever sees a humanized
+ *  message — the raw diagnostic text is only available here, via `rawMessage`. */
+ | 'ai:error';
+export interface AiEvent {
+    type: AiEventType;
+    timestamp: number;
+    /** For tool:called events */
+    tool?: string;
+    /** For repair:executed / repair:confirmed events */
+    repairActionType?: string;
+    /** For proposal events: change counts */
+    diff?: {
+        added: number;
+        modified: number;
+        removed: number;
+    };
+    /** For proposal:accepted:partial: selected vs total change count */
+    selectedCount?: number;
+    totalCount?: number;
+    /** Inferred workflow level (L1/L2/L3) for proposal events */
+    inferredLevel?: string;
+    /** For ai:error events: the raw underlying error text (HTTP status, provider message, etc.) — not shown to the user */
+    rawMessage?: string;
+}

package/dist/types/workflow.d.ts

@@ -7,6 +7,11 @@ import { WorkflowDef, TaskDef, WorkflowInstance, TaskInstance } from './conducto
  * - `developer`：全部节点（含数据转换等）
  */
 export type ViewMode = 'business' | 'standard' | 'developer';
+/**
+ * `workflowExecution` prop 的公共类型（WorkflowIDE 与 AiWorkflowIDE 共用）。
+ * 兼容两种形态：完整 Conductor Workflow 实例，或裸的任务实例数组（旧兼容模式）。
+ */
+export type WorkflowExecutionInput = WorkflowInstance | TaskInstance[];
 export interface WorkflowDiffRow {
     kind: 'add' | 'mod' | 'del';
     desc: string;
@@ -64,6 +69,8 @@ export interface AIChatMessage {
     diff?: WorkflowDiff;
     applied?: boolean;
     inverse?: WorkflowDiff;
+    /** Special card types rendered inline in the chat stream */
+    cardType?: 'run_card';
 }
 /**
  * 布局方向
@@ -141,6 +148,8 @@ export interface WorkflowNodeData {
     isDynamicRuntime?: boolean;
     simRunning?: boolean;
     simDone?: boolean;
+    /** AI diff overlay: which change category this node belongs to in the pending proposal */
+    proposalStatus?: 'added' | 'modified' | 'removed';
     _layoutWidth?: number;
     _layoutHeight?: number;
 }
@@ -245,6 +254,8 @@ export interface WorkflowActions {
     setViewMode: (viewMode: ViewMode) => void;
     startSimulation: () => void;
     stopSimulation: () => void;
+    /** 短暂高亮指定节点（如 AI 提案接受后标记新增/修改的节点），到时自动恢复原选中态 */
+    flashNodes: (refs: string[]) => void;
     /** P4.2: 显示/隐藏执行触发面板 */
     setShowRunPanel: (show: boolean) => void;
     /** P4.2: 显示/隐藏执行分析面板 */

package/dist/types/workflowLibrary.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Workflow Library types — L1/L2/L3 sub-workflow catalog
+ *
+ * L1: 原子操作（单一功能，不依赖其他业务流程）
+ * L2: 业务场景（完整的单一业务功能，可由 L1 组合而成）
+ * L3: 端到端编排（跨系统复杂场景，可由 L2/L1 组合而成）
+ *
+ * 调用规则：高层可调用低层及同层，禁止反向跨层调用
+ * L3 → L2/L1/L3(同层) ✅
+ * L2 → L1/L2(同层)   ✅
+ * L1 → L1(同层)       ✅
+ * L1 → L2/L3          ❌
+ * L2 → L3             ❌
+ */
+export type WorkflowLevel = 'L1' | 'L2' | 'L3';
+/** 工作流库元数据（列表/搜索返回） */
+export interface WorkflowLibraryItem {
+    workflowName: string;
+    workflowLevel: WorkflowLevel;
+    version: string;
+    description: string;
+    tags: string[];
+}
+/** 工作流库详情（包含完整 WorkflowDef） */
+export interface WorkflowLibraryDetail extends WorkflowLibraryItem {
+    workflowDef: Record<string, any>;
+}

package/dist/utils/nodeMeta.d.ts

@@ -7,5 +7,11 @@ declare function truncate(s: string, max: number): string;
  * - developer: key config field for the task type
  */
 export declare function getNodeMeta(taskType: string, data: WorkflowNodeData, viewMode: ViewMode, fallback: string): string;
+/**
+ * Returns the header label for a node based on the current viewMode.
+ * - business:  Chinese label without the English technical suffix (e.g. "条件分支")
+ * - standard/developer: raw task type string (e.g. "SWITCH")
+ */
+export declare function getNodeHeader(taskType: string, viewMode: ViewMode): string;
 /** Truncate helper exported for use in node components (e.g. DecisionNode). */
 export { truncate };

package/dist/utils/proposalPreview.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Proposal Preview — builds a business-readable step list for an AI proposal (M2.2)
+ *
+ * Merges the current canvas def with the proposed def + diff into a single ordered
+ * list the ProposalPreviewCard renders directly, so users can see what changed
+ * without opening the canvas. Removed tasks are spliced back in at their original
+ * position (struck through) rather than silently disappearing.
+ */
+import type { WorkflowDef, TaskDef } from '../types/conductor';
+import type { DiffSummary } from '../services/ai/toolExecutor';
+export type ProposalStepStatus = 'unchanged' | 'added' | 'modified' | 'removed';
+export interface ProposalStep {
+    ref: string;
+    task: TaskDef;
+    status: ProposalStepStatus;
+    /** Only present for 'modified' steps — field-level change descriptions */
+    changes?: string[];
+}
+export declare function buildProposalSteps(currentDef: WorkflowDef | null, proposedDef: WorkflowDef, diff: DiffSummary): ProposalStep[];

package/dist/utils/taskTypeMeta.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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).
+ */
+export interface TaskTypeMeta {
+    label: string;
+    icon: string;
+    who: string;
+    color: string;
+}
+export declare const TASK_TYPE_LABELS: Record<string, TaskTypeMeta>;
+/** Looks up business-friendly metadata for a task type, falling back to the type name itself as the label. */
+export declare function getTaskTypeMeta(taskType: string): TaskTypeMeta;
+/** Converts a taskReferenceName (e.g. "send_email") into a human-readable name ("Send Email"). */
+export declare function toBusinessName(ref: string): string;

package/dist/utils/workflowToMermaid.d.ts

@@ -0,0 +1,7 @@
+import type { WorkflowDef } from '../types/conductor';
+/**
+ * Generate a Mermaid flowchart from a WorkflowDef.
+ * Technical nodes (SET_VARIABLE, INLINE, etc.) are filtered out.
+ * Node labels use the task `name` field; business language is preserved.
+ */
+export declare function workflowToMermaid(def: WorkflowDef): string;