@digitalsee-ai/rcs 2.0.0-beta13 → 2.0.0-beta15

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

@@ -4,5 +4,12 @@ type GetHelperLinesResult = {
     vertical?: number;
     snapPosition: Partial<XYPosition>;
 };
-export declare function getHelperLines(change: NodePositionChange, nodes: Node[], distance?: number): GetHelperLinesResult;
+/**
+ * 计算拖拽节点的对齐辅助线（在 onNodesChange 中调用）。
+ *
+ * 遍历所有其它节点，分别在 x 轴（x1/x2 即左右边缘）与 y 轴（y1/y2 即上下边缘）上
+ * 取与当前节点最接近的边缘组合：无论距离多远，参考线始终返回最接近的对齐位置；
+ * 仅当距离小于 snapDistance 时才同时返回吸附位置。
+ */
+export declare function getHelperLines(change: NodePositionChange, nodes: Node[], snapDistance?: number): GetHelperLinesResult;
 export {};

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/hooks/useNavigation.d.ts

@@ -15,6 +15,7 @@ export declare const useNavigation: ({ categories, categoriesReady, initialCateg
     categoryNodes: NodeTypeItem[];
     currentCategory: CategoryItem;
     isLoadingNodes: boolean;
+    isLoadingMore: boolean;
     isRealTriggerMode: boolean;
     isAIToolMode: boolean;
     isBuiltinMCPMode: boolean;

package/dist/components/digitalsee/workflow/api/dip.types.d.ts

@@ -518,7 +518,7 @@ export interface DipPortSchema {
     /**
      * 端口在节点边框上的渲染位置，对齐 ReactFlow `Position` 枚举字符串值。
      *
-     * 缺省时由前端 `ACTION_KEY_HANDLE_LAYOUT` 兜底，再缺省为 Left/Right。
+     * 缺省为 Left/Right；MCP Server 画布会再强制 Left→Top、Right→Bottom。
      * 仅影响视觉布局，不参与连线协议匹配。
      */
     position?: 'left' | 'top' | 'right' | 'bottom';

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

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