@yiyi_zhang/reactflow-ui 0.3.0 → 0.4.0

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

@@ -160,6 +160,15 @@ 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';
 /**
  * 工作流存储状态
  */
@@ -187,6 +196,14 @@ export interface WorkflowState {
     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;
 }
 /**
  * 工作流操作接口
@@ -228,6 +245,14 @@ export interface WorkflowActions {
     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;
 }
 /**
  * 重启选项

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiyi_zhang/reactflow-ui",
-  "version": "0.3.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",