@digitalsee-ai/rcs 1.1.2 → 1.1.4

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

@@ -1,23 +1,9 @@
 import { ActionItem } from '../Panels/ModernNodeSelectorPanel/types';
-export interface NodeAddInfo {
-    sourceNodeId?: string;
-    sourceHandle?: string;
-    targetNodeId?: string;
-    targetHandle?: string;
-    position?: {
-        x: number;
-        y: number;
-    };
-    edge?: any;
-    sourceNode?: any;
-    targetNode?: any;
-    trigger?: boolean;
-    protocol?: string;
-    refresh?: boolean;
-}
+import { NodeAddInfo } from '../types/NodeAddContext';
+export type { NodeAddInfo } from '../types/NodeAddContext';
 export declare function usePanel(): {
     nodeSelectorVisible: boolean;
-    nodeAddInfo: import('../store/panelSlice').NodeAddInfo;
+    nodeAddInfo: NodeAddInfo;
     openNodeSelector: (info: NodeAddInfo) => void;
     closeNodeSelector: () => void;
     handleNodeSelect: (nodeType: ActionItem) => void;

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

@@ -2,6 +2,7 @@ import { default as defaultCanvasEngineConfig } from './config/defaultCanvasEngi
 import { CanvasEngineConfig, DeepPartial, 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';
 /**
  * DigitalseeWorkFlow 组件对外暴露的属性定义
@@ -44,7 +45,7 @@ export interface DigitalseeWorkFlowProps {
      *
      * @param workflow 当前工作流数据
      */
-    onSave?: (workflow: any) => void;
+    onSave?: (workflow: FlowDraftPayload) => void | Promise<void>;
     /**
      * 画布初始化回调
      *
@@ -117,6 +118,7 @@ export { useWorkflow } from './hooks/useWorkflow';
 export { default as NodeFactory } from './Nodes/NodeFactory';
 export * from './types/Edge';
 export type { CanvasAPI, CanvasEngineConfig, DeepPartial, HistoryNavigator, HttpClient, } from './types/engine';
+export * from './types/flowVersion';
 export * from './types/Node';
 export * from './types/Workflow';
 export type { LocaleType as WorkflowLocale, TranslateFn as WorkflowTranslateFn, } from '../../../locales';

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

@@ -1,21 +1,6 @@
 import { PayloadAction } from '@reduxjs/toolkit';
 import { ActionItem, NodeTypeItem } from '../Panels/ModernNodeSelectorPanel/types';
-export interface NodeAddInfo {
-    sourceNodeId: string;
-    sourceHandle: string;
-    targetNodeId?: string;
-    targetHandle?: string;
-    position: {
-        x: number;
-        y: number;
-    };
-    edge?: any;
-    sourceNode?: any;
-    targetNode?: any;
-    trigger?: boolean;
-    protocol?: string;
-    refresh?: boolean;
-}
+import { NodeAddInfo } from '../types/NodeAddContext';
 type NodeAddCallback = ((info: NodeAddInfo, nodeType: ActionItem) => void) | null;
 export interface PanelState {
     nodeSelectorVisible: boolean;
@@ -26,17 +11,40 @@ export declare const panelSlice: import('@reduxjs/toolkit').Slice<PanelState, {
     openNodeSelector: (state: {
         nodeSelectorVisible: boolean;
         nodeAddInfo: {
-            sourceNodeId: string;
-            sourceHandle: string;
+            sourceNodeId?: string;
+            sourceHandle?: string;
             targetNodeId?: string;
             targetHandle?: string;
-            position: {
+            position?: {
                 x: number;
                 y: number;
             };
-            edge?: any;
-            sourceNode?: any;
-            targetNode?: any;
+            edge?: {
+                id: string;
+                source: string;
+                target: string;
+                sourceHandle?: string | null;
+                sourceHandleId?: string | null;
+                targetHandle?: string | null;
+                targetHandleId?: string | null;
+                data?: {
+                    [x: string]: unknown;
+                };
+            };
+            sourceNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
+            targetNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
             trigger?: boolean;
             protocol?: string;
             refresh?: boolean;
@@ -46,17 +54,40 @@ export declare const panelSlice: import('@reduxjs/toolkit').Slice<PanelState, {
     closeNodeSelector: (state: {
         nodeSelectorVisible: boolean;
         nodeAddInfo: {
-            sourceNodeId: string;
-            sourceHandle: string;
+            sourceNodeId?: string;
+            sourceHandle?: string;
             targetNodeId?: string;
             targetHandle?: string;
-            position: {
+            position?: {
                 x: number;
                 y: number;
             };
-            edge?: any;
-            sourceNode?: any;
-            targetNode?: any;
+            edge?: {
+                id: string;
+                source: string;
+                target: string;
+                sourceHandle?: string | null;
+                sourceHandleId?: string | null;
+                targetHandle?: string | null;
+                targetHandleId?: string | null;
+                data?: {
+                    [x: string]: unknown;
+                };
+            };
+            sourceNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
+            targetNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
             trigger?: boolean;
             protocol?: string;
             refresh?: boolean;
@@ -66,17 +97,40 @@ export declare const panelSlice: import('@reduxjs/toolkit').Slice<PanelState, {
     setNodeAddCallback: (state: {
         nodeSelectorVisible: boolean;
         nodeAddInfo: {
-            sourceNodeId: string;
-            sourceHandle: string;
+            sourceNodeId?: string;
+            sourceHandle?: string;
             targetNodeId?: string;
             targetHandle?: string;
-            position: {
+            position?: {
                 x: number;
                 y: number;
             };
-            edge?: any;
-            sourceNode?: any;
-            targetNode?: any;
+            edge?: {
+                id: string;
+                source: string;
+                target: string;
+                sourceHandle?: string | null;
+                sourceHandleId?: string | null;
+                targetHandle?: string | null;
+                targetHandleId?: string | null;
+                data?: {
+                    [x: string]: unknown;
+                };
+            };
+            sourceNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
+            targetNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
             trigger?: boolean;
             protocol?: string;
             refresh?: boolean;
@@ -86,17 +140,40 @@ export declare const panelSlice: import('@reduxjs/toolkit').Slice<PanelState, {
     executeNodeAddCallback: (state: {
         nodeSelectorVisible: boolean;
         nodeAddInfo: {
-            sourceNodeId: string;
-            sourceHandle: string;
+            sourceNodeId?: string;
+            sourceHandle?: string;
             targetNodeId?: string;
             targetHandle?: string;
-            position: {
+            position?: {
                 x: number;
                 y: number;
             };
-            edge?: any;
-            sourceNode?: any;
-            targetNode?: any;
+            edge?: {
+                id: string;
+                source: string;
+                target: string;
+                sourceHandle?: string | null;
+                sourceHandleId?: string | null;
+                targetHandle?: string | null;
+                targetHandleId?: string | null;
+                data?: {
+                    [x: string]: unknown;
+                };
+            };
+            sourceNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
+            targetNode?: {
+                data: {
+                    [x: string]: unknown;
+                };
+                id: string;
+                type?: string;
+            };
             trigger?: boolean;
             protocol?: string;
             refresh?: boolean;
@@ -104,6 +181,6 @@ export declare const panelSlice: import('@reduxjs/toolkit').Slice<PanelState, {
         nodeAddCallback: NodeAddCallback;
     }, action: PayloadAction<NodeTypeItem>) => void;
 }, "panel", "panel", import('@reduxjs/toolkit').SliceSelectors<PanelState>>;
-export declare const openNodeSelector: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<NodeAddInfo, "panel/openNodeSelector">, closeNodeSelector: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"panel/closeNodeSelector">, setNodeAddCallback: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<(info: NodeAddInfo, nodeType: ActionItem) => void, "panel/setNodeAddCallback">, executeNodeAddCallback: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<NodeTypeItem, "panel/executeNodeAddCallback">;
+export declare const openNodeSelector: import('@reduxjs/toolkit').ActionCreatorWithNonInferrablePayload<"panel/openNodeSelector">, closeNodeSelector: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"panel/closeNodeSelector">, setNodeAddCallback: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<(info: NodeAddInfo, nodeType: ActionItem) => void, "panel/setNodeAddCallback">, executeNodeAddCallback: import('@reduxjs/toolkit').ActionCreatorWithOptionalPayload<NodeTypeItem, "panel/executeNodeAddCallback">;
 declare const _default: import('@reduxjs/toolkit').Reducer<PanelState>;
 export default _default;

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

@@ -22,6 +22,7 @@ export interface WorkflowState {
     currentNodeConfigVisibleId: string | null;
     isLocked: boolean;
     executionControl: ExecutionControlState | null;
+    flowMetadata: Record<string, unknown>;
 }
 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;
@@ -39,6 +40,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">, 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">, resetFlow: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/resetFlow">, executeAutoSave: import('@reduxjs/toolkit').ActionCreatorWithoutPayload<"workflow/executeAutoSave">;
 declare const _default: import('@reduxjs/toolkit').Reducer<WorkflowState>;
 export default _default;

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

@@ -1,7 +1,7 @@
-import { Node as ReactFlowNode } from '@xyflow/react';
 import { ActionItem } from '../Panels/ModernNodeSelectorPanel/types';
+import { Node as ReactFlowNode } from '@xyflow/react';
 import { NodeStatus } from '../enums/node';
-export { NodeType, NodeStatus } from '../enums/node';
+export { NodeStatus, NodeType } from '../enums/node';
 export type NodeData = ActionItem & {
     connector_name: string;
     description: string;
@@ -22,7 +22,7 @@ export type NodeData = ActionItem & {
     /** 动作 ID */
     action_id?: string;
     /** 连接器 ID */
-    connector_id?: string;
+    connector_id?: string | null;
     /** 后端节点 ID */
     n_id?: string;
     /** 账号 ID */

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

@@ -0,0 +1,31 @@
+import { Node } from '@xyflow/react';
+/** 节点选择器只需保留 MCP 判定需要的轻量锚点信息，避免 Redux 声明泄漏 ReactFlow 样式类型。 */
+export type NodeAddAnchorNode = Pick<Node, 'id' | 'type' | 'data'>;
+/** 边上插入节点时保留的原边上下文。 */
+export interface NodeAddEdgeContext {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null;
+    sourceHandleId?: string | null;
+    targetHandle?: string | null;
+    targetHandleId?: string | null;
+    data?: Record<string, unknown>;
+}
+/** 节点选择器与节点创建回调共享的唯一新增上下文。 */
+export interface NodeAddInfo {
+    sourceNodeId?: string;
+    sourceHandle?: string;
+    targetNodeId?: string;
+    targetHandle?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    edge?: NodeAddEdgeContext;
+    sourceNode?: NodeAddAnchorNode;
+    targetNode?: NodeAddAnchorNode;
+    trigger?: boolean;
+    protocol?: string;
+    refresh?: boolean;
+}

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

@@ -18,6 +18,7 @@ export interface CanvasEngineConfig {
     flowId: string;
     engineMode?: EngineMode;
     canvas: CanvasCoreConfig;
+    nodeSelector: NodeSelectorConfig;
     nodeTypes: NodeTypesRegistryConfig;
     edgeRules: EdgeRulesConfig;
     toolbar: ToolbarConfig;
@@ -25,6 +26,20 @@ export interface CanvasEngineConfig {
     httpClient?: HttpClient;
     history?: HistoryNavigator;
 }
+/**
+ * NodePackage 可连线候选能力配置。
+ *
+ * 默认关闭，由 CLASSIC/ACM 宿主显式启用，便于在接口联调异常时快速回退旧候选链路。
+ */
+export interface NodeSelectorConnectableConfig {
+    enabled: boolean;
+    scene: string;
+    fallbackToLegacy: boolean;
+    debug: boolean;
+}
+export interface NodeSelectorConfig {
+    connectable: NodeSelectorConnectableConfig;
+}
 type NativeReactFLowProps = ComponentProps<typeof ReactFlow>;
 export interface RegisterComponents {
     form: {
@@ -151,6 +166,11 @@ export interface ToolbarConfig {
      * 自定义下线API，用于自定义MFA流程下线
      */
     customOfflineApi?: (workflowId: string) => Promise<void>;
+    /** 连接流版本管理，仅 CLASSIC/ACM 画布支持。 */
+    versionManagement?: {
+        enabled?: boolean;
+        canManage?: boolean;
+    };
 }
 export interface ToolbarButtonConfig {
     id: string;
@@ -256,6 +276,6 @@ export interface CanvasAPI {
      * @param handler 事件处理器
      */
     once<T = any>(event: CanvasEventType, handler: CanvasEventHandler<T>): void;
-    saveFlow(): Promise<void>;
+    saveFlow(): Promise<import('./flowVersion').FlowDraftPayload | undefined>;
 }
 export {};

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

@@ -0,0 +1,53 @@
+/** 连接流草稿发布所需的完整数据。 */
+export interface FlowDraftPayload {
+    id: string;
+    name: string;
+    description?: string;
+    business_type?: number;
+    flow_type?: number;
+    op_status?: string;
+    status?: string;
+    connections: unknown[];
+    nodes: unknown[];
+    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;
+    published: boolean;
+    effective_version_id?: string | null;
+    effective_version_no?: number | null;
+    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/classicNodeActionIdentity.d.ts

@@ -0,0 +1,7 @@
+import { ActionItem } from '../Panels/ModernNodeSelectorPanel/types';
+/**
+ * 解析 CLASSIC create-node API 使用的原始 Long action_id。
+ *
+ * NodePackage 的 UI key 通常是 actionKey，而后端 action id 可能为 0/负数；两者不可混用。
+ */
+export declare function resolveClassicCreateActionId(action: Pick<ActionItem, 'id' | 'backendActionId' | 'action_id'>): string;

package/dist/components/digitalsee/workflow/utils/classicNodeActionIdentity.test.d.ts

@@ -0,0 +1 @@
+export {};

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

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

package/dist/components/digitalsee/workflow/utils/classicNodePackageConnection.test.d.ts

@@ -0,0 +1 @@
+export {};

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

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

package/dist/components/digitalsee/workflow/utils/classicNodePackageGraphValidation.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,79 @@
+import { DipNodeSchema } from '../api/dip.types';
+import { PortConnectionEdge, PortConnectionNode, PortConnectionValidationCode } from './portConnectionValidator';
+type SourceNodeSchema = Pick<DipNodeSchema, 'outputs'>;
+type TargetNodeSchema = Pick<DipNodeSchema, 'inputs'>;
+type InsertedNodeSchema = Pick<DipNodeSchema, 'inputs' | 'outputs'>;
+export type CompatiblePortSelectionCode = 'COMPATIBLE_PORT_PAIR_FOUND' | 'SOURCE_PORTS_EMPTY' | 'TARGET_PORTS_EMPTY' | 'SOURCE_HANDLE_NOT_FOUND' | 'TARGET_HANDLE_NOT_FOUND' | 'NO_COMPATIBLE_PORT_PAIR';
+/** 自动选端口的结构化结果；compatibleCount 大于 1 时调用方可记录歧义日志。 */
+export interface CompatiblePortSelectionResult {
+    valid: boolean;
+    code: CompatiblePortSelectionCode;
+    reason: string;
+    sourceHandle: string | null;
+    targetHandle: string | null;
+    compatibleCount: number;
+    /** 未找到组合时记录首个候选的底层校验码，便于 UI 映射文案。 */
+    validationCode: PortConnectionValidationCode | null;
+}
+export interface SelectCompatiblePortPairInput {
+    sourceNode: PortConnectionNode;
+    targetNode: PortConnectionNode;
+    sourceSchema: SourceNodeSchema;
+    targetSchema: TargetNodeSchema;
+    edges?: readonly PortConnectionEdge[];
+    /** 已存在的源 handle；缺失时按 sourceSchema.outputs 顺序枚举。 */
+    sourceHandle?: string | null;
+    /** 已存在的目标 handle；缺失时按 targetSchema.inputs 顺序枚举。 */
+    targetHandle?: string | null;
+}
+export interface SelectSourceToNewCompatiblePortInput {
+    sourceNode: PortConnectionNode;
+    newNode: PortConnectionNode;
+    sourceSchema: SourceNodeSchema;
+    newNodeSchema: TargetNodeSchema;
+    sourceHandle: string | null | undefined;
+    edges?: readonly PortConnectionEdge[];
+}
+export interface SelectNewToTargetCompatiblePortInput {
+    newNode: PortConnectionNode;
+    targetNode: PortConnectionNode;
+    newNodeSchema: SourceNodeSchema;
+    targetSchema: TargetNodeSchema;
+    targetHandle: string | null | undefined;
+    edges?: readonly PortConnectionEdge[];
+}
+export type EdgeInsertPortSelectionCode = 'EDGE_INSERT_PORTS_FOUND' | 'SOURCE_TO_NEW_INCOMPATIBLE' | 'NEW_TO_TARGET_INCOMPATIBLE';
+export interface EdgeInsertPortSelectionResult {
+    valid: boolean;
+    code: EdgeInsertPortSelectionCode;
+    reason: string;
+    /** 两段可选组合数的乘积。 */
+    compatibleCount: number;
+    sourceToNew: CompatiblePortSelectionResult;
+    newToTarget: CompatiblePortSelectionResult | null;
+}
+export interface SelectCompatiblePortsForEdgeInsertInput {
+    sourceNode: PortConnectionNode;
+    newNode: PortConnectionNode;
+    targetNode: PortConnectionNode;
+    sourceSchema: SourceNodeSchema;
+    newNodeSchema: InsertedNodeSchema;
+    targetSchema: TargetNodeSchema;
+    sourceHandle: string | null | undefined;
+    targetHandle: string | null | undefined;
+    edges?: readonly PortConnectionEdge[];
+    /** 插边成功后会替换的旧边；校验连接数时必须先排除。 */
+    replacedEdgeId?: string;
+}
+/**
+ * 按 source outputs → target inputs 的 Schema 顺序枚举所有组合。
+ * 会继续扫描首个成功组合之后的候选，以便返回准确的 compatibleCount。
+ */
+export declare const selectCompatiblePortPair: ({ sourceNode, targetNode, sourceSchema, targetSchema, sourceHandle, targetHandle, edges, }: SelectCompatiblePortPairInput) => CompatiblePortSelectionResult;
+/** 从已有输出端口增加新节点：仅枚举新节点 inputs。 */
+export declare const selectSourceToNewCompatiblePort: ({ sourceNode, newNode, sourceSchema, newNodeSchema, sourceHandle, edges, }: SelectSourceToNewCompatiblePortInput) => CompatiblePortSelectionResult;
+/** 从已有输入端口增加前置节点：仅枚举新节点 outputs。 */
+export declare const selectNewToTargetCompatiblePort: ({ newNode, targetNode, newNodeSchema, targetSchema, targetHandle, edges, }: SelectNewToTargetCompatiblePortInput) => CompatiblePortSelectionResult;
+/** 插边时同时选择 source→new 与 new→target 两段端口。 */
+export declare const selectCompatiblePortsForEdgeInsert: ({ sourceNode, newNode, targetNode, sourceSchema, newNodeSchema, targetSchema, sourceHandle, targetHandle, edges, replacedEdgeId, }: SelectCompatiblePortsForEdgeInsertInput) => EdgeInsertPortSelectionResult;
+export {};

package/dist/components/digitalsee/workflow/utils/compatiblePortSelection.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -2,5 +2,13 @@ import { DipNodeSchema } from '../api/dip';
 export declare function clearNextNodeSchemaCache(): void;
 export declare function setCachedNextNodeSchema(nodeKey: string, nodeVersion: number | undefined, schema: DipNodeSchema): void;
 export declare function setCachedClassicNextNodeSchema(nodeKey: string, nodeVersion: number | undefined, schema: DipNodeSchema): void;
+/**
+ * 同步读取已预加载的 CLASSIC nodepackage Schema，不触发网络请求。
+ *
+ * 手动拖线发生在 ReactFlow 的同步校验阶段，无法等待异步 Schema 请求；
+ * 因此画布加载/选择器转换阶段会先预热缓存，再由这里读取。缺失版本时与
+ * `getCachedClassicNextNodeSchema` 保持一致，按 ACM 版本 1 兜底。
+ */
+export declare function peekCachedClassicNextNodeSchema(nodeKey: string, nodeVersion?: number): DipNodeSchema | null;
 export declare function getCachedClassicNextNodeSchema(nodeKey: string, nodeVersion?: number): Promise<DipNodeSchema | null>;
 export declare function getCachedNextNodeSchema(nodeKey: string, nodeVersion?: number): Promise<DipNodeSchema | null>;

package/dist/components/digitalsee/workflow/utils/nodeDataFormatter.test.d.ts

@@ -0,0 +1 @@
+export {};