@digitalsee-ai/rcs 1.1.9 → 2.0.0-beta3

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 {};