@yiyi_zhang/reactflow-ui 0.3.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/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

@@ -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;
 }
@@ -160,6 +169,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 +205,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 +254,16 @@ export interface WorkflowActions {
     setViewMode: (viewMode: ViewMode) => void;
     startSimulation: () => void;
     stopSimulation: () => void;
+    /** 短暂高亮指定节点（如 AI 提案接受后标记新增/修改的节点），到时自动恢复原选中态 */
+    flashNodes: (refs: string[]) => 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/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/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

@@ -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;