@yiyi_zhang/reactflow-ui 0.2.0 → 0.4.0

package/dist/sample-executions/switch-branches.json

@@ -3,8 +3,14 @@
     "status": "COMPLETED",
     "startTime": 1704546000000,
     "endTime": 1704546090000,
-    "input": { "userType": "premium", "requestId": "req_555" },
-    "output": { "processed": true, "tier": "premium" },
+    "input": {
+        "userType": "premium",
+        "requestId": "req_555"
+    },
+    "output": {
+        "processed": true,
+        "tier": "premium"
+    },
     "workflowDefinition": {
         "name": "user_tier_workflow",
         "description": "SWITCH 分支演示：根据用户类型走不同处理路径（premium 分支执行）",
@@ -34,13 +40,18 @@
                             "name": "premium_processing",
                             "taskReferenceName": "premium_proc_ref",
                             "type": "SIMPLE",
-                            "inputParameters": { "priority": "high", "sla": "1h" }
+                            "inputParameters": {
+                                "priority": "high",
+                                "sla": "1h"
+                            }
                         },
                         {
                             "name": "premium_notify",
                             "taskReferenceName": "premium_notify_ref",
                             "type": "EVENT",
-                            "inputParameters": { "sink": "sqs:premium-events" }
+                            "inputParameters": {
+                                "sink": "sqs:premium-events"
+                            }
                         }
                     ],
                     "standard": [
@@ -48,7 +59,10 @@
                             "name": "standard_processing",
                             "taskReferenceName": "standard_proc_ref",
                             "type": "SIMPLE",
-                            "inputParameters": { "priority": "normal", "sla": "24h" }
+                            "inputParameters": {
+                                "priority": "normal",
+                                "sla": "24h"
+                            }
                         }
                     ],
                     "free": [
@@ -56,7 +70,9 @@
                             "name": "queue_request",
                             "taskReferenceName": "queue_ref",
                             "type": "SET_VARIABLE",
-                            "inputParameters": { "queuePosition": "${workflow.input.requestId}" }
+                            "inputParameters": {
+                                "queuePosition": "${workflow.input.requestId}"
+                            }
                         }
                     ]
                 },
@@ -81,7 +97,8 @@
                 }
             }
         ],
-        "schemaVersion": 2
+        "schemaVersion": 2,
+        "restartable": true
     },
     "tasks": [
         {
@@ -91,8 +108,14 @@
             "taskType": "HTTP",
             "startTime": 1704546000000,
             "endTime": 1704546005000,
-            "inputData": { "uri": "https://api.example.com/users/req_555" },
-            "outputData": { "userId": "usr_999", "tier": "premium", "email": "user@example.com" }
+            "inputData": {
+                "uri": "https://api.example.com/users/req_555"
+            },
+            "outputData": {
+                "userId": "usr_999",
+                "tier": "premium",
+                "email": "user@example.com"
+            }
         },
         {
             "taskId": "task_switch_001",
@@ -101,8 +124,12 @@
             "taskType": "SWITCH",
             "startTime": 1704546006000,
             "endTime": 1704546006500,
-            "inputData": { "switchCaseValue": "premium" },
-            "outputData": { "caseOutput": "premium" }
+            "inputData": {
+                "switchCaseValue": "premium"
+            },
+            "outputData": {
+                "caseOutput": "premium"
+            }
         },
         {
             "taskId": "task_premium_proc_001",
@@ -111,8 +138,14 @@
             "taskType": "SIMPLE",
             "startTime": 1704546007000,
             "endTime": 1704546040000,
-            "inputData": { "priority": "high", "sla": "1h" },
-            "outputData": { "jobId": "job_premium_789", "estimatedTime": "45m" }
+            "inputData": {
+                "priority": "high",
+                "sla": "1h"
+            },
+            "outputData": {
+                "jobId": "job_premium_789",
+                "estimatedTime": "45m"
+            }
         },
         {
             "taskId": "task_premium_notify_001",
@@ -121,7 +154,9 @@
             "taskType": "EVENT",
             "startTime": 1704546041000,
             "endTime": 1704546043000,
-            "outputData": { "eventId": "evt_premium_sent" }
+            "outputData": {
+                "eventId": "evt_premium_sent"
+            }
         },
         {
             "taskId": "task_log_001",
@@ -130,7 +165,9 @@
             "taskType": "INLINE",
             "startTime": 1704546044000,
             "endTime": 1704546046000,
-            "outputData": { "result": "logged" }
+            "outputData": {
+                "result": "logged"
+            }
         }
     ]
-}
+}

package/dist/services/aiService.d.ts

@@ -18,6 +18,26 @@ export declare const callAICopilot: (messages: ChatMessage[], config?: Partial<A
  * 流式调用 - 通过 onToken 回调逐 token 返回内容
  */
 export declare const callAICopilotStream: (messages: ChatMessage[], config: Partial<AIServiceConfig> | undefined, onToken: (token: string) => void, onDone?: () => void, signal?: AbortSignal) => Promise<string>;
+/**
+ * 生成任务 inputParameters 的 AI prompt（P4.1）
+ */
+export declare const generateTaskParametersPrompt: (taskType: string, taskRef: string, workflowInputParams: string[], upstreamTasks: Array<{
+    ref: string;
+    type: string;
+    name: string;
+}>, currentParams: Record<string, any>) => string;
+/**
+ * System Prompt for execution analysis / fault diagnosis（P4.3）
+ */
+export declare const EXECUTION_ANALYSIS_SYSTEM_PROMPT = "\nYou are a Netflix Conductor workflow debugging expert.\nWhen given a failed workflow execution, you analyze the task inputs, outputs, and errors to diagnose root causes.\n\nFocus on:\n1. JSONPath expressions that failed to resolve (NullPointerException, PathNotFoundException)\n2. Wrong or missing parameter fields for the task type\n3. Type mismatches between upstream output and task input\n4. Timeout and retry configuration issues\n5. HTTP error codes and what they imply about the request parameters\n\nAlways respond in Chinese. Be concise and actionable.\nIf you suggest a fix, describe specifically which task and which parameter field to change.\n";
+/**
+ * AI 自动生成任务 inputParameters（P4.1）
+ */
+export declare const generateTaskParameters: (taskType: string, taskRef: string, workflowInputParams: string[], upstreamTasks: Array<{
+    ref: string;
+    type: string;
+    name: string;
+}>, currentParams: Record<string, any>, config?: Partial<AIServiceConfig>) => Promise<Record<string, any>>;
 /**
  * System Prompt for Conductor Workflow Modeling
  */

package/dist/types/conductor.d.ts

@@ -72,6 +72,27 @@ export interface TaskDef {
     timeoutSeconds?: number;
     timeoutPolicy?: 'RETRY' | 'TIME_OUT_WF' | 'ALERT_ONLY' | 'FAIL_WORKFLOW';
 }
+/**
+ * 工作流入参定义（结构化，向后兼容 string[] 旧格式）
+ */
+export interface WorkflowInputParam {
+    /** 参数名 */
+    name: string;
+    /** 参数类型 */
+    type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    /** 用途说明 */
+    description?: string;
+    /** 是否必填 */
+    required?: boolean;
+    /** 默认值 */
+    defaultValue?: any;
+    /** 示例值（在执行验证表单中展示） */
+    example?: any;
+}
+/**
+ * 解析工作流入参声明：兼容 string[] 旧格式与 WorkflowInputParam[] 新格式
+ */
+export declare function parseWorkflowInputParams(raw: any[] | undefined): WorkflowInputParam[];
 /**
  * Conductor 工作流定义
  */
@@ -87,8 +108,8 @@ export interface WorkflowDef {
     version?: number;
     /** 任务列表 (DAG 定义) */
     tasks: TaskDef[];
-    /** 输入参数定义 (用于文档生成) */
-    inputParameters?: any[];
+    /** 输入参数定义：支持 string[]（旧格式）或 WorkflowInputParam[]（结构化新格式） */
+    inputParameters?: string[] | WorkflowInputParam[];
     /** 输出参数映射 */
     outputParameters?: Record<string, any>;
     schemaVersion?: number;

package/dist/types/workflow.d.ts

@@ -1,5 +1,70 @@
 import { Node, Edge, Position } from 'reactflow';
 import { WorkflowDef, TaskDef, WorkflowInstance, TaskInstance } from './conductor';
+/**
+ * 视图详情级别（独立于编辑模式）
+ * - `business`：仅展示核心业务节点，控制/数据节点折叠为边标签
+ * - `standard`：业务 + 控制流节点
+ * - `developer`：全部节点（含数据转换等）
+ */
+export type ViewMode = 'business' | 'standard' | 'developer';
+export interface WorkflowDiffRow {
+    kind: 'add' | 'mod' | 'del';
+    desc: string;
+}
+export type WorkflowPatchOp = {
+    op: 'patchTask';
+    ref: string;
+    set: Partial<TaskDef>;
+} | {
+    op: 'insertAfter';
+    after: string;
+    edgeTo: string;
+    task: TaskDef;
+} | {
+    op: 'insertBefore';
+    before: string;
+    task: TaskDef;
+} | {
+    op: 'addTask';
+    task: TaskDef;
+    extraEdges?: Array<{
+        from: string;
+        to: string;
+        label?: string;
+    }>;
+    removeEdges?: Array<{
+        from: string;
+        to: string;
+    }>;
+} | {
+    op: 'removeTask';
+    ref: string;
+} | {
+    op: 'addEdge';
+    from: string;
+    to: string;
+    label?: string;
+} | {
+    op: 'removeEdge';
+    from: string;
+    to: string;
+};
+export interface WorkflowDiff {
+    kind: 'add' | 'mod' | 'del' | 'replace';
+    summary: string;
+    rows: WorkflowDiffRow[];
+    patch?: WorkflowPatchOp[];
+    payload?: WorkflowDef;
+}
+export interface AIChatMessage {
+    id: string;
+    role: 'user' | 'ai';
+    content?: string;
+    thinking?: boolean;
+    diff?: WorkflowDiff;
+    applied?: boolean;
+    inverse?: WorkflowDiff;
+}
 /**
  * 布局方向
  */
@@ -74,6 +139,10 @@ export interface WorkflowNodeData {
     parentRef?: string;
     edgeData?: Record<string, any>;
     isDynamicRuntime?: boolean;
+    simRunning?: boolean;
+    simDone?: boolean;
+    _layoutWidth?: number;
+    _layoutHeight?: number;
 }
 /**
  * 强类型节点
@@ -91,11 +160,21 @@ export type ThemeMode = 'dark' | 'light';
  * - `orange`: 活力橙
  */
 export type ThemeColor = 'blue' | 'orange';
+/**
+ * 执行触发状态机
+ * - `idle`: 未触发
+ * - `triggering`: 正在调用 onTriggerExecution
+ * - `polling`: 已获得 workflowId，正在轮询执行结果
+ * - `done`: 执行到达终态（COMPLETED/FAILED/TIMED_OUT/TERMINATED）
+ * - `error`: 触发或轮询过程中发生错误
+ */
+export type RunState = 'idle' | 'triggering' | 'polling' | 'done' | 'error';
 /**
  * 工作流存储状态
  */
 export interface WorkflowState {
     mode: EditorMode;
+    viewMode: ViewMode;
     workflowDef: WorkflowDef | null;
     workflowInstance: WorkflowInstance | null;
     nodes: WorkflowNode[];
@@ -113,6 +192,18 @@ export interface WorkflowState {
     nodesLocked: boolean;
     copiedTask: TaskDef | null;
     isDetailPanelOpen: boolean;
+    simState: Record<string, 'idle' | 'running' | 'done'>;
+    isSimRunning: boolean;
+    /** 每次 setWorkflow() 调用时递增，用于触发 WorkflowDesigner 的 fitView */
+    workflowLoadKey: number;
+    /** P4.2 执行触发状态 */
+    runState: RunState;
+    pendingExecutionId: string | null;
+    executionError: string | null;
+    showRunPanel: boolean;
+    showAnalysisPanel: boolean;
+    /** P4.1 聚焦参数字段（"去修复"跳转时使用） */
+    focusedParamKey: string | null;
 }
 /**
  * 工作流操作接口
@@ -139,6 +230,7 @@ export interface WorkflowActions {
     removeLoopTask: (loopRef: string, taskRef: string) => void;
     addDecisionBranch: (taskRef: string, caseName: string) => void;
     removeDecisionBranch: (taskRef: string, caseName: string) => void;
+    renameDecisionBranch: (taskRef: string, oldName: string, newName: string) => void;
     addForkBranch: (taskRef: string) => void;
     copyTask: (task: TaskDef) => void;
     pasteTask: (task: TaskDef) => void;
@@ -150,18 +242,75 @@ export interface WorkflowActions {
     applyAIGeneratedWorkflow: (workflowJson: any) => void;
     setIsDetailPanelOpen: (isOpen: boolean) => void;
     selectTaskAction: (task: TaskDef | null, openPanel?: boolean) => void;
+    setViewMode: (viewMode: ViewMode) => void;
+    startSimulation: () => void;
+    stopSimulation: () => void;
+    /** P4.2: 显示/隐藏执行触发面板 */
+    setShowRunPanel: (show: boolean) => void;
+    /** P4.2: 显示/隐藏执行分析面板 */
+    setShowAnalysisPanel: (show: boolean) => void;
+    /** P4.2: 更新执行触发状态 */
+    setRunState: (state: RunState, execId?: string | null, error?: string | null) => void;
+    /** P4.3: 切回 edit 模式并聚焦到指定任务的指定参数字段 */
+    switchToEditAndFocusParam: (taskRef: string, paramKey?: string) => void;
+}
+/**
+ * 重启选项
+ * - `useLatestDef: true`  使用当前最新工作流定义版本重启
+ * - `useLatestDef: false` 使用本次执行时的定义版本重启（默认）
+ */
+export interface RestartOptions {
+    useLatestDef?: boolean;
 }
 /**
  * 运行态操作回调
- * 集成方通过此接口注入工作流执行操作（暂停/恢复/停止/重试/重启）的回调函数。
- * 未传入的回调对应的按钮不会渲染。
+ * 集成方通过此接口注入工作流执行操作的回调函数；未传入的回调对应的按钮不会渲染。
+ *
+ * 工作流级别操作：暂停、继续、终止、重试、重新运行（支持版本选择）
+ * 任务级别操作：从指定任务重新运行、跳过任务
  */
 export interface ExecutionActions {
-    onRestart?: (workflowId: string) => void;
+    /**
+     * 是否允许操作。
+     * - `true`（默认）：所有操作按钮正常可用。
+     * - `false`：所有操作按钮置灰并提示"操作权限受限"。
+     * @default true
+     */
+    allowOperations?: boolean;
+    /** 暂停工作流（RUNNING → PAUSED） */
     onPause?: (workflowId: string) => void;
+    /** 继续执行暂停中的工作流（PAUSED → RUNNING） */
     onResume?: (workflowId: string) => void;
+    /** 终止工作流（RUNNING/PAUSED → TERMINATED） */
     onTerminate?: (workflowId: string) => void;
+    /** 重试失败的工作流（FAILED/TIMED_OUT/TERMINATED） */
     onRetry?: (workflowId: string) => void;
+    /**
+     * 重新运行工作流（需要 workflowDef.restartable = true）
+     * @param options.useLatestDef true=使用最新定义版本；false=使用执行时的版本（默认）
+     */
+    onRestart?: (workflowId: string, options?: RestartOptions) => void;
+    /**
+     * 从指定任务重新运行（工作流须处于终态：FAILED/TERMINATED/COMPLETED）
+     *
+     * 对应 Conductor OSS API：POST /workflow/{workflowId}/rerun
+     * - body: { reRunFromTaskId: taskId, taskInput: {} }
+     *
+     * @param workflowId    工作流实例 ID
+     * @param taskReferenceName 目标任务的引用名（taskReferenceName）
+     * @param taskId        目标任务实例 ID（对应 Conductor API 的 reRunFromTaskId）
+     */
+    onRerunFromTask?: (workflowId: string, taskReferenceName: string, taskId?: string) => void;
+    /**
+     * 跳过指定任务（任务须处于 SCHEDULED 或 IN_PROGRESS 状态）
+     *
+     * 对应 Conductor OSS API：PUT /workflow/{workflowId}/skiptask/{taskReferenceName}
+     *
+     * @param workflowId        工作流实例 ID
+     * @param taskReferenceName 目标任务的引用名（URL path 参数）
+     * @param taskId            目标任务实例 ID（可用于请求体附加校验）
+     */
+    onSkipTask?: (workflowId: string, taskReferenceName: string, taskId?: string) => void;
 }
 /**
  * 组合 Store 类型

package/dist/utils/executionAnalyzer.d.ts

@@ -0,0 +1,32 @@
+import { TaskExecutionData, ExecutionStatus } from '../types/workflow';
+import { WorkflowInstance } from '../types/conductor';
+export interface DiagnosticResult {
+    category: 'parameter' | 'timeout' | 'auth' | 'network' | 'logic';
+    title: string;
+    explanation: string;
+    suggestEditParam?: string;
+}
+export interface StepInfo {
+    taskRef: string;
+    status: ExecutionStatus;
+    startTime?: number;
+    endTime?: number;
+    durationMs?: number;
+    retryCount: number;
+    reasonForIncompletion?: string;
+    diagnostics: DiagnosticResult[];
+}
+export interface ExecutionSummary {
+    totalTasks: number;
+    completedTasks: number;
+    failedTasks: number;
+    skippedTasks: number;
+    totalDurationMs: number;
+    steps: StepInfo[];
+    hasFailed: boolean;
+}
+export declare function diagnoseTask(taskRef: string, executionData: Record<string, TaskExecutionData>): DiagnosticResult[];
+export declare function analyzeExecution(executionData: Record<string, TaskExecutionData>, workflowInstance: WorkflowInstance | null): ExecutionSummary;
+export declare function formatDuration(ms?: number): string;
+export declare function getCategoryIcon(category: DiagnosticResult['category']): string;
+export declare function getCategoryColor(category: DiagnosticResult['category']): string;

package/dist/utils/nodeMeta.d.ts

@@ -0,0 +1,11 @@
+import { ViewMode, WorkflowNodeData } from '../types/workflow';
+declare function truncate(s: string, max: number): string;
+/**
+ * Returns the meta subtitle for a node based on the current viewMode.
+ * - business:  task.description (fallback to label)
+ * - standard:  unchanged (returns fallback)
+ * - developer: key config field for the task type
+ */
+export declare function getNodeMeta(taskType: string, data: WorkflowNodeData, viewMode: ViewMode, fallback: string): string;
+/** Truncate helper exported for use in node components (e.g. DecisionNode). */
+export { truncate };

package/dist/utils/simulateWorkflow.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 对工作流任务进行拓扑排序，返回按并行波浪分组的执行顺序。
+ * 每一波内的任务可以并行执行，波与波之间有依赖关系。
+ */
+export declare function buildExecutionWaves(taskRefs: string[], edges: Array<{
+    source: string;
+    target: string;
+}>): string[][];

package/dist/utils/workflowDiff.d.ts

@@ -0,0 +1,15 @@
+import { WorkflowDef } from '../types/conductor';
+import { WorkflowDiff } from '../types/workflow';
+/**
+ * 将 WorkflowDiff 应用到 WorkflowDef，返回新的 def 以及用于撤销的逆操作 diff。
+ * 不修改入参（深拷贝）。
+ */
+export declare function applyWorkflowDiff(def: WorkflowDef, diff: WorkflowDiff): {
+    next: WorkflowDef;
+    inverse: WorkflowDiff;
+};
+/**
+ * 从 AI 响应文本中提取 ```diff-json ... ``` 块并解析为 WorkflowDiff。
+ * 找不到或解析失败时返回 null。
+ */
+export declare function parseDiffFromAIResponse(text: string): WorkflowDiff | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiyi_zhang/reactflow-ui",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Conductor Workflow IDE — a visual workflow designer built with React 19, ReactFlow and Zustand for editing, validating and monitoring Netflix Conductor workflows.",
   "keywords": [
     "conductor",
@@ -36,7 +36,7 @@
   ],
   "scripts": {
     "dev": "vite",
-    "build": "tsc && vite build && tsc -p tsconfig.build.json",
+    "build": "vite build && tsc -p tsconfig.build.json",
     "lint": "eslint .",
     "preview": "vite preview"
   },