@digitalsee-ai/rcs 1.1.8 → 2.0.0-beta10

package/dist/components/digitalsee/workflow/store/workflowSlice.d.ts

@@ -1,5 +1,6 @@
 import { FlowStatus } from '../NodesConfig/define/flow';
 import { EdgeData } from '../types/Edge';
+import { FlowVersionStatusVO } from '../types/flowVersion';
 import { NodeData, NodeType } from '../types/Node';
 import { Connection, Edge, EdgeChange, Node, NodeChange } from '@xyflow/react';
 export interface ExecutionControlState {
@@ -23,6 +24,8 @@ export interface WorkflowState {
     isLocked: boolean;
     executionControl: ExecutionControlState | null;
     flowMetadata: Record<string, unknown>;
+    /** 用户是否手动删除过 trigger 节点（手动删除后不再展示 NodePlaceholder） */
+    triggerDeleted: boolean;
 }
 export declare const setWorkflowId: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "workflow/setWorkflowId">, setWorkflowName: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "workflow/setWorkflowName">, applyNodesChanges: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<NodeChange[], "workflow/applyNodesChanges">, applyEdgesChanges: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<EdgeChange[], "workflow/applyEdgesChanges">, addConnection: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Connection, "workflow/addConnection">, addNode: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     type: NodeType;
@@ -31,7 +34,7 @@ export declare const setWorkflowId: import('@reduxjs/toolkit').ActionCreatorWith
         y: number;
     };
     data: NodeData;
-}, "workflow/addNode">, addNodes: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Node<NodeData>[], "workflow/addNodes">, addEdges: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Edge<EdgeData>[], "workflow/addEdges">, removeNodes: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string[], "workflow/removeNodes">, removeEdges: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string[], "workflow/removeEdges">, setSelection: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
+}, "workflow/addNode">, addEdges: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Edge<EdgeData>[], "workflow/addEdges">, removeNodes: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string[], "workflow/removeNodes">, removeEdges: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string[], "workflow/removeEdges">, setSelection: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     nodes: Node<NodeData>[];
     edges: Edge<EdgeData>[];
 }, "workflow/setSelection">, updateEdge: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
@@ -40,6 +43,6 @@ export declare const setWorkflowId: import('@reduxjs/toolkit').ActionCreatorWith
 }, "workflow/updateEdge">, setNodes: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Node<NodeData>[], "workflow/setNodes">, setEdges: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Edge<EdgeData>[], "workflow/setEdges">, updateNode: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<{
     id: string;
     data: Partial<NodeData>;
-}, "workflow/updateNode">, setFlowOpStatus: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<FlowStatus, "workflow/setFlowOpStatus">, refreshFlow: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/refreshFlow">, setCurrentNodeConfigVisibleId: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "workflow/setCurrentNodeConfigVisibleId">, setLocked: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<boolean, "workflow/setLocked">, setExecutionControl: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<ExecutionControlState, "workflow/setExecutionControl">, setFlowMetadata: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Record<string, unknown>, "workflow/setFlowMetadata">, resetFlow: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/resetFlow">, executeAutoSave: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/executeAutoSave">;
+}, "workflow/updateNode">, setFlowOpStatus: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<FlowStatus, "workflow/setFlowOpStatus">, refreshFlow: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/refreshFlow">, setCurrentNodeConfigVisibleId: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<string, "workflow/setCurrentNodeConfigVisibleId">, setLocked: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<boolean, "workflow/setLocked">, setExecutionControl: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<ExecutionControlState, "workflow/setExecutionControl">, setFlowMetadata: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<Record<string, unknown>, "workflow/setFlowMetadata">, setTriggerDeleted: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<boolean, "workflow/setTriggerDeleted">, resetFlow: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/resetFlow">, executeAutoSave: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/executeAutoSave">, setFlowVersionMeta: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<FlowVersionStatusVO, "workflow/setFlowVersionMeta">;
 declare const _default: import('@reduxjs/toolkit').Reducer<WorkflowState>;
 export default _default;

package/dist/components/digitalsee/workflow/types/Node.d.ts

@@ -29,6 +29,8 @@ export type NodeData = ActionItem & {
     account_id?: string | null;
     /** 节点协议类型（AI_LANGUAGE_MODEL / MCP 等） */
     protocol?: string;
+    /** 是否是 Trigger 节点 */
+    is_trigger?: boolean;
     /** index signature — 满足 ReactFlow v12 的 Record<string, unknown> 约束 */
     [key: string]: unknown;
 };

package/dist/components/digitalsee/workflow/types/NodeAddContext.d.ts

@@ -1,6 +1,6 @@
 import { Node } from '@xyflow/react';
 /** 节点选择器只需保留 MCP 判定需要的轻量锚点信息，避免 Redux 声明泄漏 ReactFlow 样式类型。 */
-export type NodeAddAnchorNode = Pick<Node, 'id' | 'type' | 'data'>;
+export type NodeAddAnchorNode = Pick<Node, 'id' | 'type' | 'data' | 'position' | 'measured'>;
 /** 边上插入节点时保留的原边上下文。 */
 export interface NodeAddEdgeContext {
     id: string;

package/dist/components/digitalsee/workflow/types/Workflow.d.ts

@@ -1,6 +1,6 @@
+import { WorkflowOpStatus } from '../enums/workflow';
 import { WorkflowEdge } from './Edge';
 import { WorkflowNode } from './Node';
-import { WorkflowOpStatus } from '../enums/workflow';
 /**
  * 工作流定义
  */

package/dist/components/digitalsee/workflow/types/engine.d.ts

@@ -1,7 +1,7 @@
 import { ReactFlow } from '@xyflow/react';
 import { Rule } from 'antd/es/form';
 import { ComponentProps, ReactNode } from 'react';
-import { EngineMode, WorkflowOpStatus } from '../enums/workflow';
+import { WorkflowOpStatus } from '../enums/workflow';
 export type HttpClient = <T = any>(url: string, config: any) => Promise<T>;
 export interface HistoryNavigator {
     push(path: string, state?: any): void;
@@ -11,12 +11,26 @@ export interface HistoryNavigator {
     goForward(): void;
     listen?(listener: (location: any, action: any) => void): () => void;
 }
+/**
+ * 画布内部 URL 跳转回调，由宿主决定如何处理（同页路由 / 新标签 / 拦截等）。
+ *
+ * @param url 目标 URL
+ * @param openInNewTab 是否需要新标签页打开（原 window.open 场景）
+ */
+export type CanvasNavigate = (url: string, openInNewTab?: boolean) => void;
+/**
+ * 画布模式（单一事实源）：取代散落的 readOnly / preview / previewId / appFlowMode 参数。
+ *
+ * - edit   : 可编辑可改名（默认），独立页导航返回 history.push('/link/ai-flow')
+ * - flow   : 应用流嵌入页 不可改名字
+ * - preview: 只读展示，不渲染 Header，节点不可拖/连/选
+ */
+export type WorkflowCanvasMode = 'edit' | 'flow' | 'preview';
 export type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends (...args: any[]) => any ? T[P] : T[P] extends Array<infer U> ? Array<DeepPartial<U>> : T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
 export interface CanvasEngineConfig {
     flowId: string;
-    engineMode?: EngineMode;
     canvas: CanvasCoreConfig;
     nodeSelector: NodeSelectorConfig;
     nodeTypes: NodeTypesRegistryConfig;
@@ -25,6 +39,8 @@ export interface CanvasEngineConfig {
     nodeConfigPanel: NodeConfigPanelConfig;
     httpClient?: HttpClient;
     history?: HistoryNavigator;
+    onNavigate?: CanvasNavigate;
+    scene?: string;
 }
 /**
  * NodePackage 可连线候选能力配置。
@@ -56,7 +72,7 @@ export interface CanvasCoreConfig {
         size?: number;
     };
     allowRemoveTrigger?: boolean;
-    mode?: 'edit' | 'preview';
+    mode?: WorkflowCanvasMode;
     miniMap?: boolean;
     header?: boolean;
     controls?: boolean;
@@ -158,17 +174,16 @@ export interface ToolbarConfig {
     enableOnlineConfirmMessage?: string;
     enableFlowText?: string;
     /**
-     * 自定义上线API，用于自定义MFA流程上线
-     */
-    customOnlineApi?: (workflowId: string) => Promise<void>;
-    /**
-     * 自定义下线API，用于自定义MFA流程下线
+     * 连接流版本管理集成回调，仅 CLASSIC/ACM 画布支持。
+     *
+     * 注意：「是否启用版本管理」由 `flowMetadata.version_group_id` 自动判定（归属版本组的流程即为版本管理流），
+     * 宿主无需配置 `enabled` 开关；提供下方任一回调即在版本管理流中显示对应入口。
      */
-    customOfflineApi?: (workflowId: string) => Promise<void>;
-    /** 连接流版本管理，仅 CLASSIC/ACM 画布支持。 */
     versionManagement?: {
-        enabled?: boolean;
-        canManage?: boolean;
+        /** 宿主提供时才显示「历史版本」入口；点击时调用，由宿主打开历史 UI。 */
+        onShowHistory?: () => void;
+        /** 宿主提供时才显示「发布并启用」入口；点击时回调传入当前画布 payload（含 meta data）。 */
+        onConfirmPublish?: (payload?: any) => void;
     };
 }
 export interface ToolbarButtonConfig {
@@ -276,5 +291,7 @@ export interface CanvasAPI {
      */
     once<T = any>(event: CanvasEventType, handler: CanvasEventHandler<T>): void;
     saveFlow(): Promise<import('./flowVersion').FlowDraftPayload | undefined>;
+    /** 刷新版本状态（版本号、发布状态等），从服务端拉取最新元数据写入 store */
+    refreshFlowVersionStatus(): Promise<void>;
 }
 export {};

package/dist/components/digitalsee/workflow/types/flowVersion.d.ts

@@ -12,24 +12,6 @@ export interface FlowDraftPayload {
     execution_control?: unknown;
     [key: string]: unknown;
 }
-/** 发布版本概要。 */
-export interface FlowVersionVO {
-    id: string;
-    version_group_id: string;
-    version_no: number;
-    version_name?: string;
-    remark?: string;
-    effective: boolean;
-    publish_by?: string;
-    publish_time?: string;
-}
-/** 版本历史分页结果。 */
-export interface FlowVersionPage {
-    items: FlowVersionVO[];
-    total: number;
-    page: number;
-    size: number;
-}
 /** 当前草稿与线上版本状态。 */
 export interface FlowVersionStatusVO {
     version_group_id: string;
@@ -39,15 +21,3 @@ export interface FlowVersionStatusVO {
     has_unpublished_changes: boolean;
     draft_version_no: 0;
 }
-/** 历史版本详情。 */
-export interface FlowVersionDetailVO {
-    version: FlowVersionVO;
-    flow: FlowDraftPayload;
-}
-/** 发布请求。 */
-export interface FlowVersionPublishRequest {
-    flow: FlowDraftPayload;
-    version_name?: string;
-    remark?: string;
-    force: boolean;
-}

package/dist/components/digitalsee/workflow/utils/connectionCheck.d.ts

@@ -0,0 +1,30 @@
+import { Node } from '@xyflow/react';
+/**
+ * 统一连线检查的结果码，命名对齐 portConnectionValidator 的 code 风格。
+ */
+export type ConnectionCheckCode = 'VALID' | 'SOURCE_NODE_NOT_FOUND' | 'TARGET_NODE_NOT_FOUND' | 'SOURCE_PORT_NOT_FOUND' | 'TARGET_PORT_NOT_FOUND' | 'PROTOCOL_MISMATCH' | 'SELF_CONNECTION_NOT_ALLOWED';
+export interface ConnectionCheckResult {
+    valid: boolean;
+    code: ConnectionCheckCode;
+    /** 中文兜底原因，便于 console 调试。 */
+    message: string;
+}
+/** 结构兼容 React Flow 的 Connection / Edge（只取定位字段）。 */
+export interface ConnectionCheckConnection {
+    source?: string | null;
+    target?: string | null;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+}
+/**
+ * 统一连线检查：手动拖线与运行时代码建边共用的入口。
+ *
+ * 范围（与手动拖线今天的实际行为一致，再叠自连规则门）：
+ * 1. 节点存在性；
+ * 2. 协议一致性（大小写不敏感；双侧均无法解析协议时放行，保留旧 `?? ''` 行为）；
+ * 3. 自连（source === target）必须命中节点声明的 auto_connect 规则。
+ *
+ * workflowConnectionValidator 的重链（edgeRules / connectable / native 校验）
+ * 有意不在本检查内，仍由各自的既有入口负责。
+ */
+export declare function checkConnection(nodes: Node[], connection: ConnectionCheckConnection): ConnectionCheckResult;

package/dist/components/digitalsee/workflow/utils/graphLoop.d.ts

@@ -0,0 +1,12 @@
+import { Edge } from '@xyflow/react';
+/**
+ * 判断 fromNodeId -> toNodeId 的连线是否会形成回环。
+ *
+ * 从 fromNodeId 出发沿入边（edge.target === current）向上遍历祖先链：
+ * - 途中遇到 toNodeId，说明已存在 toNodeId -> ... -> fromNodeId 的通路，
+ *   新边将闭合环路，返回 true；
+ * - 遍历到根（无入边）仍未遇到，返回 false。
+ *
+ * 用 visited 集合防止图中已有环导致死循环。
+ */
+export declare function isLoopEdgeLine(fromNodeId: string, toNodeId: string, edges: Edge[]): boolean;

package/dist/components/digitalsee/workflow/utils/layoutUtils.d.ts

@@ -3,7 +3,7 @@ import { NodeData } from '../types/Node';
 import { Edge, Node } from '@xyflow/react';
 import { CanvasLayoutSource, CanvasLayoutTarget } from '../enums/workflow';
 export declare const GRID_SIZE = 20;
-export declare const NODE_SIZE = 300;
+export declare const NODE_SIZE = 222;
 export declare const NODE_X_SPACING: number;
 export declare const NODE_Y_SPACING: number;
 export declare const VERTICAL_NODE_SPACING: number;
@@ -37,6 +37,6 @@ export interface ExtendedNodeData extends NodeData {
     [key: string]: unknown;
 }
 export type NodeDictionary = Record<string, Node<ExtendedNodeData>>;
-export declare function layoutGraph(nodes: Node<any>[], edges: Edge<EdgeData>[], options?: {
+export declare function layoutGraph(nodes: Node[], edges: Edge<EdgeData>[], options?: {
     includeSticky?: boolean;
 }): CanvasLayoutResult;

package/dist/components/digitalsee/workflow/utils/mcpCanvas.d.ts

@@ -1,47 +1,7 @@
-import { HandleConnectionType } from '../types/Handle';
 import { NodeProtocol } from '../types/NodeProtocol';
-import { Edge, Node } from '@xyflow/react';
 export declare const MCP_TRIGGER_CATEGORY = "MCP_TRIGGER";
 export declare const MCP_CATEGORY_TYPE = "mcp_trigger";
-export declare const MCP_ACTION_LINK_ID = "mcp-gateway";
 export declare const MCP_CATALOG_PAGE_SIZE = 200;
 export declare const MCP_ACTION_PAGE_SIZE = 10;
 export declare const MCP_SERVER_PROTOCOL = NodeProtocol.MCP_SERVER;
-export declare const MCP_MAX_TOOLS_PER_SERVER = 20;
-export declare const MCP_TOOL_MAX_DOWNSTREAM = 1;
-export declare const MCP_RETURN_VARIABLE_ACTION_KEY = "dip.core.mcp.return-variable";
 export declare const MCP_SERVER_ACTION_KEY = "dip.core.trigger.mcp-server";
-type McpNodeIdentity = Pick<Node, 'type'> & Partial<Pick<Node, 'data'>>;
-export declare const isMcpServerNode: (node?: McpNodeIdentity | null) => boolean;
-export declare const isMcpToolNode: (node?: Pick<Node, "type"> | null) => boolean;
-export declare const isMcpReturnVariableNode: (node?: (Pick<Node, "data"> & {
-    data?: Record<string, unknown>;
-}) | null) => boolean;
-export declare const isMcpCanvas: (nodes: Array<Pick<Node, "type">>) => boolean;
-export declare const isMcpServerCanvas: (nodes: McpNodeIdentity[]) => boolean;
-export declare const markMcpServerCanvasNode: <T extends Node>(node: T) => T;
-export declare const isMcpServerToolHandle: (handleId?: string | null) => handleId is "main" | HandleConnectionType.BUILTIN_MCP;
-export declare const isMcpToolChainHandle: (handleId?: string | null) => handleId is "main" | HandleConnectionType.OUTPUT;
-export declare const getDirectMcpToolCount: (serverId: string, nodes: Array<Pick<Node, "id" | "type">>, edges: Array<Pick<Edge, "source" | "target">>) => number;
-export declare const canAddMoreMcpTools: (serverId: string, nodes: Array<Pick<Node, "id" | "type">>, edges: Array<Pick<Edge, "source" | "target">>) => boolean;
-export declare const getMcpToolDownstreamCount: (toolId: string, edges: Array<Pick<Edge, "source" | "sourceHandle">>) => number;
-export declare const canAddMcpToolDownstream: (toolId: string, edges: Array<Pick<Edge, "source" | "sourceHandle">>) => boolean;
-export declare const isMcpServerToToolConnection: (sourceNode?: McpNodeIdentity | null, targetNode?: Pick<Node, "type"> | null, _sourceHandle?: string | null) => boolean;
-export declare const isMcpToolToExecutionConnection: (sourceNode?: Pick<Node, "id" | "type"> | null, targetNode?: Pick<Node, "id" | "type"> | null, sourceHandle?: string | null) => boolean;
-export declare const getNodeTypeById: (nodes: Array<Pick<Node, "id" | "type">>, nodeId?: string | null) => string;
-/** MCP 画布只改变端口布局，连接端口 ID 必须始终保留 NodeSchema 的真实名称。 */
-export declare const resolveMcpCanvasTargetHandle: (_nodes: McpNodeIdentity[], fallback?: string | null) => string;
-/** 保存前不得把 Schema 端口改写成视觉方向名称。 */
-export declare const normalizeMcpCanvasEdge: <T extends Pick<Edge, "targetHandle">>(_nodes: McpNodeIdentity[], edge: T) => T;
-export declare const normalizeMcpCanvasEdges: <T extends Pick<Edge, "targetHandle">>(nodes: McpNodeIdentity[], edges: T[]) => T[];
-/** 旧版 MCP 画布把视觉方向写成了 targetHandle（以及部分 NodeSchema inputs.name）。 */
-export declare const LEGACY_MCP_CANVAS_TARGET_HANDLE = "top";
-type McpCanvasEdgeNode = Pick<Node, 'id' | 'type'> & Partial<Pick<Node, 'data'>>;
-/**
- * 升级旧版 MCP 画布的虚拟方向 targetHandle。
- *
- * 旧实现会把 MCP Server 画布上所有边的 targetHandle 写成 `top`。
- * MCP 网关相关节点 Schema 仍声明 top，需保留；经典 Action 等节点入桩是 input，需改回。
- */
-export declare const upgradeLegacyMcpCanvasEdges: <T extends Pick<Edge, "source" | "target" | "sourceHandle" | "targetHandle">>(nodes: McpCanvasEdgeNode[], edges: T[]) => T[];
-export {};

package/dist/components/digitalsee/workflow/utils/mode.d.ts

@@ -0,0 +1,18 @@
+import { WorkflowCanvasMode } from '../types/engine';
+/** resolveCanvasMode 的输入：显式 mode 优先，其次配置，最后默认值。 */
+export interface ResolveCanvasModeInput {
+    /** 显式模式（最高优先级） */
+    mode?: WorkflowCanvasMode;
+    /** 配置中的 canvas.mode（优先级低于 props） */
+    configMode?: WorkflowCanvasMode;
+}
+/**
+ * 解析画布最终模式。
+ *
+ * 优先级：mode > configMode > edit。
+ */
+export declare const resolveCanvasMode: (input: ResolveCanvasModeInput) => WorkflowCanvasMode;
+/** 画布级可编辑：preview 恒不可编辑；其余模式受锁定（isLocked）约束。 */
+export declare const deriveCanEdit: (mode: WorkflowCanvasMode, isLocked: boolean) => boolean;
+/** 是否预览模式（只读展示、不渲染 Header、节点不可交互）。 */
+export declare const deriveIsPreviewMode: (mode: WorkflowCanvasMode) => boolean;

package/dist/components/digitalsee/workflow/utils/nodeAutoConnect.d.ts

@@ -0,0 +1,24 @@
+import { NodeAutoConnectRule } from '../Nodes/classicPortLayout';
+import { Edge, Node } from '@xyflow/react';
+/**
+ * 解析节点声明的自身端口自动连线规则。
+ *
+ * NodePackage（type 含 `@`）读 schema cache 的 `auto_connections`；
+ * 经典节点读 registry 描述符的 `autoConnect`。均未声明时返回空数组（不自动连线）。
+ */
+export declare function resolveNodeAutoConnectRules(node: Node): NodeAutoConnectRule[];
+/**
+ * 判断节点自身端口连线（sourceHandle -> targetHandle）是否被 auto_connect 规则声明。
+ *
+ * 仅当规则中存在完全一致的有序配对时允许；未声明（含 handle 缺失）则拒绝。
+ * 手动拖线的自连与代码建边共用本判定，保证"自己连自己"必须走声明规则。
+ */
+export declare function isSelfConnectionAllowed(node: Node, sourceHandle: string | null | undefined, targetHandle: string | null | undefined): boolean;
+/**
+ * 按声明构建节点自身端口间的自动连线（如 LOOP 的 loop -> input 自环边）。
+ *
+ * 每条规则经端口存在性 + 协议一致性校验，不通过则跳过该条并告警；
+ * data.renderType / connectionType 沿用既有约定取 sourceHandle 名
+ * （BaseEdge 依赖 renderType='loop' 渲染循环边样式）。
+ */
+export declare function buildNodeAutoConnectEdges(node: Node): Edge[];

package/dist/components/digitalsee/workflow/utils/nodeCommon.d.ts

@@ -0,0 +1,5 @@
+import { Node } from '@xyflow/react';
+import { DipPortSchema } from '../api/dip.types';
+export declare const getNodeHandleProtocol: (node: Node, handleName: string) => string | null;
+export declare const getNodeHandle: (node: Node, handleName: string) => DipPortSchema | null;
+export declare const getNodeHandleByProtocol: (node: Node, protocol: string, isInput: boolean, preferredName?: string) => DipPortSchema | null;

package/dist/components/digitalsee/workflow/utils/nodeHandleLayout.d.ts

@@ -0,0 +1,83 @@
+import { Edge, Node, Position } from '@xyflow/react';
+export type LayoutDirection = 'vertical' | 'horizontal';
+export interface NodeHandlePositions {
+    sources: Position[];
+    targets: Position[];
+}
+interface ActionKeyHandleLayout {
+    source: Position;
+    target: Position;
+}
+/**
+ * NodePackage 节点端口 position 的过渡手工映射。
+ *
+ * 字段说明：
+ * - source：source handle 在节点边框上的位置
+ * - target：target handle 在节点边框上的位置
+ *
+ * 优先级：`DipPortSchema.position` > `ACTION_KEY_HANDLE_LAYOUT` > 缺省 Left/Right。
+ * 后续 `DipPortSchema.position` 全量铺开后即可删除本表。
+ */
+export declare const ACTION_KEY_HANDLE_LAYOUT: Record<string, ActionKeyHandleLayout>;
+/**
+ * 给定一个 ReactFlow 节点，返回它所有 source / target handle 的 `Position`。
+ *
+ * 数据源优先级：
+ * 1. NodePackage 节点 → `DipPortSchema.position` > `ACTION_KEY_HANDLE_LAYOUT` > 缺省 Left/Right
+ * 2. 经典节点 → `nodeTypeRegistry` 中的 legacy handles
+ * 3. 兜底：返回空数组
+ *
+ * 该函数只读、不发起网络请求；schema 缺失时按 schema 字段的 `position` → 映射表 → Left/Right 降级。
+ */
+export declare function getNodeHandlePositions(node: Node): NodeHandlePositions;
+/**
+ * 节点是否参与垂直布局（子节点在父节点下方 / 上方）。
+ *
+ * 判定：节点的 source 或 target handle 中任一处于 Top/Bottom 即视为垂直。
+ */
+export declare function isVerticalLayoutNode(node: Node): boolean;
+/**
+ * 节点是否参与水平布局（子节点在父节点右侧 / 左侧）。
+ *
+ * 判定：节点的 source 或 target handle 中任一处于 Left/Right 即视为水平。
+ */
+export declare function isHorizontalLayoutNode(node: Node): boolean;
+/**
+ * 按边的 target handle 位置判定布局方向。
+ *
+ * 规则（与用户约定一致）：
+ * - target handle 在 Bottom/Top → 'vertical'
+ * - target handle 在 Left/Right → 'horizontal'
+ * - 缺省 → null（调用方自行决定 fallback）
+ */
+export declare function getEdgeLayoutDirection(edge: Pick<Edge, 'source' | 'target' | 'sourceHandle' | 'targetHandle'>, sourceNode?: Node | null, targetNode?: Node | null): LayoutDirection | null;
+/**
+ * 取边 source handle 在节点边框上的 `Position`（供连线风格 / 区间重叠判定使用）。
+ * 无 sourceHandle 时取第一个 source handle；找不到匹配时返回 undefined，调用方按水平处理。
+ */
+export declare function getEdgeSourcePosition(edge: Pick<Edge, 'sourceHandle'>, sourceNode: Node): Position | undefined;
+/**
+ * 节点是否拥有 Top 输入 handle，用于区分主流程节点与垂直子节点。
+ *
+ * 旧版用 `node.type === AI_SUB_NODE` 过滤；现在改为：节点的 target 中存在
+ * Top 入桩（典型 AI 子节点升级后通过 Bottom 入桩连接到父节点 ai_* 桩，但若
+ * 仍保留 Top 形态即可识别为"子节点"）。
+ */
+export declare function hasTopInputHandle(node: Node): boolean;
+/**
+ * 节点是否拥有 Top source handle。
+ *
+ * 旧版 `calculateNodePosition` 用 `n.type !== AI_SUB_NODE` 过滤主流程节点；
+ * 现在等价语义改为：节点 source 不在 Top（说明它不向上输出，不会作为垂直子节点）。
+ */
+export declare function hasTopSourceHandle(node: Node): boolean;
+/**
+ * 节点是否属于某个父节点的垂直子布局（向上发送 → 自己即 child）。
+ */
+export declare function isVerticalLayoutChild(node: Node): boolean;
+/**
+ * 画布整体方向：按节点 source handle 的方向统计，少数服从多数。
+ * 缺省（无法判定或平票）走水平。
+ */
+export declare function inferCanvasDirection(nodes: Node[]): LayoutDirection;
+export {};

package/dist/components/digitalsee/workflow/utils/nodePackageConnection.d.ts

@@ -0,0 +1,28 @@
+import { DipNodeSchema } from '../api/dip';
+import { PortConnectionEdge, PortConnectionValidationCode } from './portConnectionValidator';
+import { Node } from '@xyflow/react';
+export type NodePackageConnectionCode = PortConnectionValidationCode | 'NOT_APPLICABLE' | 'SCHEMA_NOT_READY';
+export interface NodePackageConnectionResult {
+    applicable: boolean;
+    valid: boolean;
+    code: NodePackageConnectionCode;
+    reason: string;
+    missingSchemaNodeIds?: string[];
+}
+export interface ValidateNodePackageConnectionInput {
+    sourceNode?: Node | null;
+    targetNode?: Node | null;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+    edges?: readonly PortConnectionEdge[];
+}
+/** 同步解析已预加载的 NodePackage Schema。 */
+export declare function resolveNodePackageSchema(node?: Node | null): DipNodeSchema | null;
+export declare function isNodePackageConnectionNode(node?: Node | null): boolean;
+/**
+ * 校验两个 NodePackage 节点之间的端口连接。
+ *
+ * 混合 legacy/nodepackage 连接保留前端当前精确 handle 名称，并按后端虚拟端口契约
+ * 将 legacy 端口能力类型统一映射为 main。
+ */
+export declare function validateNodePackageConnection({ sourceNode, targetNode, sourceHandle, targetHandle, edges, }: ValidateNodePackageConnectionInput): NodePackageConnectionResult;

package/dist/components/digitalsee/workflow/utils/nodePackageGraphValidation.d.ts

@@ -0,0 +1,29 @@
+import { PortConnectionValidationCode } from './portConnectionValidator';
+import { Edge, Node } from '@xyflow/react';
+export type NodePackageGraphIssueCode = PortConnectionValidationCode | 'REQUIRED_INPUT_MISSING' | 'SCHEMA_NOT_READY';
+export interface NodePackageGraphIssue {
+    code: NodePackageGraphIssueCode;
+    reason: string;
+    blocking: boolean;
+    nodeId?: string;
+    portName?: string;
+    edgeId?: string;
+    sourceNodeId?: string;
+    targetNodeId?: string;
+}
+export interface NodePackageGraphValidationResult {
+    valid: boolean;
+    issues: NodePackageGraphIssue[];
+    blockingIssues: NodePackageGraphIssue[];
+    missingSchemaNodeIds: string[];
+}
+interface ValidateNodePackageGraphInput {
+    nodes: readonly Node[];
+    edges: readonly Edge[];
+}
+/**
+ * 保存前检查当前已知的 NodePackage 端口约束。
+ * Schema 尚未加载属于非阻塞 warning，最终交给 ACM 后端兜底；已知非法端口则阻止保存。
+ */
+export declare function validateNodePackageGraph({ nodes, edges, }: ValidateNodePackageGraphInput): NodePackageGraphValidationResult;
+export {};

package/dist/components/digitalsee/workflow/utils/nodePackageSchemaCache.d.ts

@@ -0,0 +1,15 @@
+import { DipNodeSchema, DipPortSchema } from '../api/dip';
+export declare function clearNodePackageSchemaCache(): void;
+export declare function setNodePackageSchemaCache(nodeKey: string, nodeVersion: number | undefined | null, schema: DipNodeSchema): void;
+/**
+ * 同步读取已预加载的 NodePackage Schema，不触发网络请求。
+ *
+ * 手动拖线发生在 ReactFlow 的同步校验阶段，无法等待异步 Schema 请求；
+ * 因此画布加载/选择器转换阶段会先预热缓存，再由这里读取。
+ */
+export declare function peekNodePackageSchema(nodeKey: string, nodeVersion?: number): DipNodeSchema | null;
+export declare function peekNodePackageSchemaByType(dynamicType: string): DipNodeSchema | null;
+export declare function peekNodePackageSchemaHandleInfo(dynamicType: string, handleName: string): DipPortSchema | null;
+export declare function peekSchemaHandleInfoByProtocol(dynamicType: string, protocol: string, isInput: boolean, preferredName?: string): DipPortSchema | null;
+export declare function getNodePackageSchema(nodeKey: string, nodeVersion?: number): Promise<DipNodeSchema | null>;
+export declare function getNodePackageSchemaByCache(nodeKey: string, nodeVersion?: number): DipNodeSchema | null;

package/dist/components/digitalsee/workflow/utils/onNodeRemoveHook.d.ts

@@ -0,0 +1,13 @@
+import { Node } from '@xyflow/react';
+/** 删除命中该列表的 Trigger 节点时，级联清空整张画布（删除所有其他节点） */
+export declare const TRIGGER_CASCADE_CLEAR_KEYS: readonly string[];
+/**
+ * 判断本次待删除节点中是否包含需要级联清空的 Trigger 节点。
+ * 若命中，返回画布上所有其他节点的 id，供调用方一并删除；否则返回空数组。
+ */
+export declare const onNodeRemoveHook: (nodes: Node[], nodeIds: string[]) => string[];
+/**
+ * 判断本次手动删除的节点中是否包含 trigger 节点。
+ * 命中表示用户主动删除了画布触发节点，画布据此不再展示 NodePlaceholder。
+ */
+export declare const isManualTriggerDeletion: (nodes: Node[], nodeIds: string[]) => boolean;

package/dist/components/digitalsee/workflow/utils/triggerNode.d.ts

@@ -0,0 +1,13 @@
+import { Node } from '@xyflow/react';
+type TriggerCandidate = Pick<Node, 'type'> & Partial<Pick<Node, 'data'>>;
+/**
+ * 判断节点是否为 Trigger 节点。
+ *
+ * - 经典节点：type 固定为 StartEventNode
+ * - NodePackage 节点：判断与 nodeSchema 同级的 is_trigger 属性
+ *   （is_trigger 为 true / 1 / '1' 视为触发节点，'0' / 0 / false 不视为）
+ *
+ * 一个画布最多只有一个 trigger 节点，因此画布级推导只需记录该节点信息即可。
+ */
+export declare const isTriggerNode: (node?: TriggerCandidate | null) => boolean;
+export {};

package/dist/components/digitalsee/workflow/utils/workflowConnectionValidator.d.ts

@@ -1,11 +1,9 @@
-import { EngineMode } from '../enums/workflow';
 import { EdgeConfig, EdgeRulesConfig, NodeSelectorConnectableConfig } from '../types/engine';
 import { Edge, IsValidConnection, Node } from '@xyflow/react';
 interface ValidateWorkflowConnectionInput {
     edge: EdgeConfig;
     nodes: Node[];
     edges: Edge[];
-    engineMode?: EngineMode;
     connectable?: Pick<NodeSelectorConnectableConfig, 'enabled' | 'debug'>;
     validators?: EdgeRulesConfig['validators'];
     nativeIsValidConnection?: IsValidConnection;
@@ -16,5 +14,5 @@ interface ValidateWorkflowConnectionInput {
  * 手动拖线与程序化新增都传入各自的节点/边快照，从而复用 NodePackage、MCP、
  * 宿主 edgeRules 和 ReactFlow native validator。边中插入可由调用方先从快照移除旧边。
  */
-export declare function validateWorkflowConnection({ edge, nodes, edges, engineMode, connectable, validators, nativeIsValidConnection, }: ValidateWorkflowConnectionInput): boolean;
+export declare function validateWorkflowConnection({ edge, nodes, edges, connectable, validators, nativeIsValidConnection, }: ValidateWorkflowConnectionInput): boolean;
 export {};

package/dist/components/digitalsee/workflow/workflow.story-fixtures.d.ts

@@ -0,0 +1,50 @@
+import { WorkflowHttpClient } from './index';
+export declare const DEMO_WORKFLOW_ID = "local-ai-flow-preview";
+export declare const DEMO_CONFIG_NODE_ID = "send-notice";
+export declare const DEMO_NODE_CATALOG_WORKFLOW_ID = "local-ai-flow-node-catalog";
+export declare const DEMO_CLASSIC_FIELDS_WORKFLOW_ID = "local-ai-flow-classic-fields";
+export declare const DEMO_CLASSIC_FIELDS_NODE_ID = "classic-fields-catalog";
+export declare const DEMO_CONTROL_NODES_WORKFLOW_ID = "local-ai-flow-control-nodes";
+export declare const DEMO_CONDITION_NODE_ID = "control-condition";
+export declare const DEMO_SWITCH_NODE_ID = "control-switch";
+export declare const DEMO_LOOP_NODE_ID = "control-loop";
+export declare const DEMO_MCP_TOOL_NODE_ID = "control-mcp-tool";
+export declare const DEMO_CREDENTIAL_WORKFLOW_ID = "local-ai-flow-credential";
+export declare const DEMO_CREDENTIAL_NODE_ID = "credential-database-query";
+type MockFlowNode = {
+    id: string;
+    n_id: string;
+    node_type: string;
+    action_name: string;
+    connector_name: string;
+    connector_id: string;
+    action_id: string;
+    description: string;
+    protocol: string;
+    status: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    properties: Record<string, unknown>;
+    account_id?: string | null;
+    account_schema_id?: string | number;
+    deployment_type?: string;
+    output?: unknown;
+    branches?: Array<{
+        id: string;
+        label: string;
+    }>;
+    note?: string;
+    name?: string;
+};
+export declare const RUNTIME_NODE_CATALOG: MockFlowNode[];
+/**
+ * 为 AI FLOW 源码验收页提供稳定的本地请求响应。
+ *
+ * @param url RCS 组件请求地址。
+ * @param options 请求方法与请求体。
+ * @returns 与线上接口形状一致的模拟数据。
+ */
+export declare const mockAiFlowHttpClient: WorkflowHttpClient;
+export {};