@digitalsee-ai/rcs 1.1.8 → 2.0.0-beta2

package/dist/components/digitalsee/workflow/enums/node.d.ts

@@ -5,8 +5,6 @@
  * 节点渲染类型（ReactFlow 层概念）
  */
 export declare enum NodeType {
-    /** 开始节点 */
-    START = "START",
     /** 触发节点 */
     TRIGGER = "StartEventNode",
     /** 动作节点 */
@@ -17,11 +15,8 @@ export declare enum NodeType {
     LOOP = "LoopNode",
     /** 自环节点 */
     SELF_LOOP = "SelfLoopNode",
-    /** MCP服务节点 */
     MCPServer = "MCPServerNode",
-    /** MCP网关触发节点 */
     MCP_TRIGGER_NODE = "MCP_TRIGGER_NODE",
-    /** 内置MCP节点 */
     BuiltinMCP = "BuiltinMCPNode",
     /** 向量存储节点 */
     VECTOR_STORE = "VectorStoreNode",
@@ -42,7 +37,11 @@ export declare enum NodeType {
     /**
      * 自定义节点类型（内部扩展用）
      */
-    CUSTOM = "custom"
+    CUSTOM = "custom",
+    /**
+     * 动态 NodePackage节点
+     */
+    DYNAMIC = "dynamic"
 }
 /**
  * 节点运行状态

package/dist/components/digitalsee/workflow/enums/workflow.d.ts

@@ -87,4 +87,4 @@ export declare enum ConditionCompare {
      */
     is_not_null = "is_not_null"
 }
-export { CanvasLayoutSource, CanvasLayoutTarget, EngineMode, SaveStatus, } from './canvas';
+export { CanvasLayoutSource, CanvasLayoutTarget, SaveStatus, } from './canvas';

package/dist/components/digitalsee/workflow/examples/global-config-example.d.ts

@@ -6,7 +6,7 @@
 export declare function WorkflowPageExample(): import("react/jsx-runtime").JSX.Element;
 export declare const setupCustomClient: () => void;
 export declare function useWorkflowAuth(): {
-    updateToken: (token: string) => void;
+    updateToken: (_token: string) => void;
     clearToken: () => void;
 };
 export declare function LoginExample(): import("react/jsx-runtime").JSX.Element;

package/dist/components/digitalsee/workflow/hooks/state.hooks.d.ts

@@ -1,9 +1,3 @@
-import { FlowStatus } from '../NodesConfig/define/flow';
-/**
- * 判断当前流程是否允许编辑。
- *
- * 已发布及发布中的流程始终只读，不能因启用版本管理而绕过状态限制。
- */
-export declare const resolveFlowEditable: (isLocked: boolean, opStatus: FlowStatus) => boolean;
 export declare const useFlowEditable: () => boolean;
 export declare const useCurrentFlowId: () => string;
+export declare const useCurrentFlowMeta: () => Record<string, unknown>;

package/dist/components/digitalsee/workflow/hooks/use-flow-data-operation.d.ts

@@ -1,6 +1,6 @@
 export declare const useFlowDataOperation: () => {
     getNodes: () => import('@xyflow/react').Node[];
-    removeNodes: (nids: string[]) => void;
+    removeNodes: (nodeIds: string[]) => void;
     removeEdges: (edgeIds: string[]) => void;
     addEdges: (newEdges: any[]) => void;
     addNodes: (newNodes: any[]) => void;

package/dist/components/digitalsee/workflow/hooks/useCanvasLayout.d.ts

@@ -1,5 +1,5 @@
-import { CanvasLayoutResult } from '../utils/layoutUtils';
 import { CanvasLayoutTarget } from '../enums/workflow';
+import { CanvasLayoutResult } from '../utils/layoutUtils';
 export declare const useCanvasLayout: (id?: string) => {
     layout: (target?: CanvasLayoutTarget, shouldFitView?: boolean) => CanvasLayoutResult;
     autoLayout: (shouldFitView?: boolean) => CanvasLayoutResult;

package/dist/components/digitalsee/workflow/hooks/useCanvasMode.d.ts

@@ -0,0 +1,8 @@
+import { WorkflowCanvasMode } from '../types/engine';
+/**
+ * 画布模式统一读取入口。
+ *
+ * canvas.mode 已在入口（index.tsx）由 resolveCanvasMode 收敛旧 props 后写入，
+ * 下游一律经由此 hook 读取，缺省回退 edit。
+ */
+export declare const useCanvasMode: () => WorkflowCanvasMode;

package/dist/components/digitalsee/workflow/hooks/useHandleConnections.d.ts

@@ -1,5 +1,13 @@
 import { HandleDirection } from '../enums/handle';
+import { Edge } from '@xyflow/react';
+/**
+ * 过滤指定 Handle 上的边，用于 maxConnections 计数。
+ *
+ * 自环边（source === target，如 LOOP 的 loop -> input）不占 target 桩的
+ * maxConnections 名额；handleStatus 仍将其视为已连接样式。
+ */
+export declare const filterHandleConnections: (edges: readonly Edge[], nodeId: string, handleId: string, handleType: HandleDirection) => Edge[];
 export declare function useHandleConnections(): {
-    getHandleConnections: (nodeId: string, handleId: string, handleType: HandleDirection) => import('@xyflow/react').Edge[];
+    getHandleConnections: (nodeId: string, handleId: string, handleType: HandleDirection) => Edge[];
     handleStatus: (nodeId: string, handleId: string) => "default" | "connected";
 };

package/dist/components/digitalsee/workflow/hooks/useVariables.d.ts

@@ -32,6 +32,7 @@ interface UseVariablesReturn {
     globalVariables: EnhancedGlobalVariable[];
     nodeVariables: EnhancedVarDatum[];
     isLoading: boolean;
+    error: Error | null;
     refresh: () => void;
 }
 /**

package/dist/components/digitalsee/workflow/hooks/useWorkflow.d.ts

@@ -17,7 +17,6 @@ export declare function useWorkflow(id?: string): {
     onEdgesChange: OnEdgesChange;
     onConnect: OnConnect;
     onEdgeUpdate: (oldEdge: Edge<EdgeData>, newConnection: Connection) => void;
-    addNodes: (newNodes: Node[]) => void;
     addEdges: (newEdges: Edge[]) => void;
     removeNodes: (nodeIds: string[]) => void;
     removeEdges: (edgeIds: string[]) => void;
@@ -31,4 +30,5 @@ export declare function useWorkflow(id?: string): {
     isLocked: boolean;
     setLocked: (locked: boolean) => void;
     autoSaveFlow: () => void;
+    flowMetadata: Record<string, unknown>;
 };

package/dist/components/digitalsee/workflow/index.d.ts

@@ -1,7 +1,6 @@
 import { default as defaultCanvasEngineConfig } from './config/defaultCanvasEngineConfig';
-import { CanvasEngineConfig, DeepPartial, CanvasAPI, HistoryNavigator, HttpClient } from './types/engine';
+import { CanvasEngineConfig, DeepPartial, WorkflowCanvasMode, CanvasAPI, HistoryNavigator, HttpClient } from './types/engine';
 import { mergeConfig } from './utils/mergeConfig';
-import { EngineMode } from './enums/workflow';
 import { FlowDraftPayload } from './types/flowVersion';
 import { LocaleType } from '../../../locales';
 /**
@@ -17,29 +16,11 @@ export interface DigitalseeWorkFlowProps {
      */
     workflowId?: string;
     /**
-     * 是否只读模式
+     * 画布模式（默认 'edit'）
      *
-     * @description 只读模式下禁用所有编辑能力
+     * @description edit=可编辑可改名；flow=不能改名字、返回 history.back()；preview=只读展示、不渲染 Header
      */
-    readOnly?: boolean;
-    /**
-     * 是否预览模式
-     *
-     * @description 预览模式下仅展示，不允许交互
-     */
-    preview?: boolean;
-    /**
-     * 预览使用的工作流 ID
-     */
-    previewId?: string;
-    /**
-     * 是否应用流模式
-     */
-    appFlowMode?: boolean;
-    /**
-     * 是否链接模式
-     */
-    linkMode?: boolean;
+    mode?: WorkflowCanvasMode;
     /**
      * 保存回调
      *
@@ -63,23 +44,12 @@ export interface DigitalseeWorkFlowProps {
      *
      * @description Defaults to zh-CN when omitted
      */
-    locale?: LocaleType;
-    /**
-     * Base URL for workflow service APIs
-     *
-     * @description When provided, all internal API calls will prepend this URL
-     */
-    apiBaseUrl?: string;
-    /**
-     * Authorization token for workflow service APIs
-     *
-     * @description Injected as the Authorization header for every API call
-     */
-    apiToken?: string;
+    locale?: LocaleType | string;
     /**
      * HTTP 客户端实例
      *
-     * @description 用于执行所有 HTTP 请求，可传入自定义的 HTTP 客户端（如 axios 实例）
+     * @description 用于执行所有 HTTP 请求，可传入自定义的 HTTP 客户端（如 axios 实例）。
+     * 认证（token 等）与地址（baseUrl 等）完全由该客户端负责
      */
     httpClient?: HttpClient;
     /**
@@ -89,13 +59,15 @@ export interface DigitalseeWorkFlowProps {
      */
     history?: HistoryNavigator;
     /**
-     * 引擎模式
-     *
-     * @description 'classic' 是当前 AI 连接流主路径，使用 ACM 后端，并兼容渲染
-     * nodepackage 节点的新版 NodeSchema 配置；'next' 是暂废保留的 DIP 直连分支。
-     * @default 'classic'
+     * 宿主响应连接流下线逻辑
+     * @param workflowId
+     * @returns 是否成功下线
+     */
+    onOffline?: (workflowId: string) => Promise<boolean>;
+    /**
+     * 场景值
      */
-    engineMode?: EngineMode;
+    scene?: string;
 }
 /**
  * DigitalseeWorkFlow 工作流画布组件
@@ -108,13 +80,15 @@ export { configureWorkflow, getGlobalWorkflowConfig, resetGlobalWorkflowConfig,
 export * from './config/themeConfig';
 export { useCanvasApi } from './context/canvasApiContext';
 export { useCanvasConfig } from './context/canvasConfig';
+export * from './design-system';
 export { default as EdgeFactory } from './Edges/EdgeFactory';
 export { NodeStatus, NodeType } from './enums/node';
-export { EngineMode, WorkflowOpStatus } from './enums/workflow';
+export { WorkflowOpStatus } from './enums/workflow';
 export { default as HandleFactory } from './Handles/HandleFactory';
 export { useCanvasLayout } from './hooks/useCanvasLayout';
 export { useUndo } from './hooks/useUndo';
 export { useWorkflow } from './hooks/useWorkflow';
+export { default as AiFlowNodeStatusBadge, type NodeStatusBadgeProps as AiFlowNodeStatusBadgeProps, } from './Nodes/components/NodeStatusBadge';
 export { default as NodeFactory } from './Nodes/NodeFactory';
 export * from './types/Edge';
 export type { CanvasAPI, CanvasEngineConfig, DeepPartial, HistoryNavigator, HttpClient, } from './types/engine';

package/dist/components/digitalsee/workflow/migration/umi.d.ts

@@ -1,7 +1,6 @@
 import { FormattedMessage } from 'react-intl';
 import * as history from 'history';
 declare const context: history.BrowserHistory;
-export { FormattedMessage };
-export { context as history };
+export { context as history, FormattedMessage };
 export declare function Link(props: any): import("react/jsx-runtime").JSX.Element;
 export declare const useSearchParams: (url?: string) => URLSearchParams[];

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/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,19 @@ export interface HistoryNavigator {
     goForward(): void;
     listen?(listener: (location: any, action: any) => void): () => 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 +32,7 @@ export interface CanvasEngineConfig {
     nodeConfigPanel: NodeConfigPanelConfig;
     httpClient?: HttpClient;
     history?: HistoryNavigator;
+    scene?: string;
 }
 /**
  * NodePackage 可连线候选能力配置。
@@ -56,7 +64,7 @@ export interface CanvasCoreConfig {
         size?: number;
     };
     allowRemoveTrigger?: boolean;
-    mode?: 'edit' | 'preview';
+    mode?: WorkflowCanvasMode;
     miniMap?: boolean;
     header?: boolean;
     controls?: boolean;
@@ -158,17 +166,16 @@ export interface ToolbarConfig {
     enableOnlineConfirmMessage?: string;
     enableFlowText?: string;
     /**
-     * 自定义上线API，用于自定义MFA流程上线
+     * 连接流版本管理集成回调，仅 CLASSIC/ACM 画布支持。
+     *
+     * 注意：「是否启用版本管理」由 `flowMetadata.version_group_id` 自动判定（归属版本组的流程即为版本管理流），
+     * 宿主无需配置 `enabled` 开关；提供下方任一回调即在版本管理流中显示对应入口。
      */
-    customOnlineApi?: (workflowId: string) => Promise<void>;
-    /**
-     * 自定义下线API，用于自定义MFA流程下线
-     */
-    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 +283,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/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;