@digitalsee-ai/rcs 1.0.16 → 1.1.1

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

@@ -0,0 +1,66 @@
+import { DipPortSchema } from '../api/dip.types';
+export declare const DEFAULT_PORT_CONNECTION_TYPE = "main";
+/** 已完成运行时默认值归一化的端口 Schema。 */
+export interface NormalizedDipPortSchema extends DipPortSchema {
+    type: string;
+}
+/**
+ * 校验器所需的最小节点结构，可直接接收 ReactFlow Node。
+ *
+ * 节点 schema key 必须放在 data.action_key/actionKey/nodeKey/node_key 中；
+ * ReactFlow 的 node.type 只是渲染类型，不能作为连接白名单身份。
+ */
+export interface PortConnectionNode {
+    id: string;
+    data?: Record<string, unknown> | null;
+}
+/** 校验器所需的最小边结构，可直接接收 ReactFlow Edge。 */
+export interface PortConnectionEdge {
+    id?: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+}
+export interface PortConnectionValidationOptions {
+    /**
+     * 显式兼容旧 CLASSIC handle：source `output`、target `input` 映射到 Schema `main`。
+     * nodepackage 节点必须保持默认 false，避免把真实的 `input/output/main` 端口混为一谈。
+     */
+    allowLegacyMainHandleAliases?: boolean;
+}
+export interface ValidatePortConnectionInput {
+    sourceNode?: PortConnectionNode | null;
+    targetNode?: PortConnectionNode | null;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+    /** 源节点的 output Schema 列表。 */
+    sourcePorts?: readonly DipPortSchema[] | null;
+    /** 目标节点的 input Schema 列表。 */
+    targetPorts?: readonly DipPortSchema[] | null;
+    /** 当前画布已有边；新建边本身不应提前加入此列表。 */
+    edges?: readonly PortConnectionEdge[] | null;
+    options?: PortConnectionValidationOptions;
+}
+export type PortConnectionValidationCode = 'VALID' | 'SOURCE_NODE_NOT_FOUND' | 'TARGET_NODE_NOT_FOUND' | 'SOURCE_PORT_NOT_FOUND' | 'TARGET_PORT_NOT_FOUND' | 'PORT_TYPE_MISMATCH' | 'SOURCE_NODE_NOT_ALLOWED' | 'TARGET_NODE_NOT_ALLOWED' | 'SOURCE_NODE_DENIED' | 'TARGET_NODE_DENIED' | 'SOURCE_MAX_CONNECTIONS_REACHED' | 'TARGET_MAX_CONNECTIONS_REACHED' | 'SELF_CONNECTION_NOT_ALLOWED';
+export interface PortConnectionValidationResult {
+    valid: boolean;
+    code: PortConnectionValidationCode;
+    /** 可直接用于调试的中文兜底原因；界面层应优先按 code 映射 i18n 文案。 */
+    reason: string;
+    sourcePort: NormalizedDipPortSchema | null;
+    targetPort: NormalizedDipPortSchema | null;
+}
+/**
+ * 将端口运行时默认值和 ACM SNAKE_CASE 响应统一为内部 camelCase，不修改原始对象。
+ */
+export declare const normalizePortSchema: (port: DipPortSchema) => NormalizedDipPortSchema;
+/** 从 ReactFlow 节点 data 中解析用于黑白名单判断的 NodePackage schema key。 */
+export declare const getPortConnectionNodeIdentity: (node?: PortConnectionNode | null) => string | null;
+/**
+ * 按 NodePackage PortSchema 校验一条准备创建的连接。
+ *
+ * 本函数拒绝直接自连，但不校验多节点环路、MCP 等画布专项规则；调用方应按
+ * “通用图结构规则 → Schema 规则 → 专项规则”的顺序组合。
+ */
+export declare const validatePortConnection: ({ sourceNode, targetNode, sourceHandle, targetHandle, sourcePorts, targetPorts, edges, options, }: ValidatePortConnectionInput) => PortConnectionValidationResult;

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

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

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

@@ -0,0 +1,20 @@
+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;
+}
+/**
+ * 校验一条准备创建的画布连接。
+ *
+ * 手动拖线与程序化新增都传入各自的节点/边快照，从而复用 NodePackage、MCP、
+ * 宿主 edgeRules 和 ReactFlow native validator。边中插入可由调用方先从快照移除旧边。
+ */
+export declare function validateWorkflowConnection({ edge, nodes, edges, engineMode, connectable, validators, nativeIsValidConnection, }: ValidateWorkflowConnectionInput): boolean;
+export {};

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

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

package/dist/locales/en-US/link/flow.d.ts

@@ -145,6 +145,28 @@ declare const _default: {
     'link.flow.force_online_confirm': string;
     'link.flow.offline_success': string;
     'link.flow.operation_title': string;
+    'link.flow.connectable.category_unavailable': string;
+    'link.flow.connectable.connector_unavailable': string;
+    'link.flow.connectable.action_unavailable': string;
+    'link.flow.connectable.load_failed': string;
+    'link.flow.connectable.no_compatible_nodes': string;
+    'link.flow.connectable.no_compatible_input': string;
+    'link.flow.connectable.no_compatible_output': string;
+    'link.flow.connectable.no_bidirectional_compatible_port': string;
+    'link.flow.connectable.schema_unavailable': string;
+    'link.flow.connectable.existing_edge_invalid': string;
+    'link.flow.connectable.validation.source_node_not_found': string;
+    'link.flow.connectable.validation.target_node_not_found': string;
+    'link.flow.connectable.validation.source_port_not_found': string;
+    'link.flow.connectable.validation.target_port_not_found': string;
+    'link.flow.connectable.validation.port_type_mismatch': string;
+    'link.flow.connectable.validation.source_node_not_allowed': string;
+    'link.flow.connectable.validation.target_node_not_allowed': string;
+    'link.flow.connectable.validation.source_node_denied': string;
+    'link.flow.connectable.validation.target_node_denied': string;
+    'link.flow.connectable.validation.source_max_connections_reached': string;
+    'link.flow.connectable.validation.target_max_connections_reached': string;
+    'link.flow.connectable.validation.self_connection_not_allowed': string;
     'link.flow.switch.condition_one': string;
     'link.flow.switch.condition_two': string;
     'link.flow.switch.condition_n': string;

package/dist/locales/en-US.d.ts

@@ -145,6 +145,28 @@ declare const _default: {
     'link.flow.force_online_confirm': string;
     'link.flow.offline_success': string;
     'link.flow.operation_title': string;
+    'link.flow.connectable.category_unavailable': string;
+    'link.flow.connectable.connector_unavailable': string;
+    'link.flow.connectable.action_unavailable': string;
+    'link.flow.connectable.load_failed': string;
+    'link.flow.connectable.no_compatible_nodes': string;
+    'link.flow.connectable.no_compatible_input': string;
+    'link.flow.connectable.no_compatible_output': string;
+    'link.flow.connectable.no_bidirectional_compatible_port': string;
+    'link.flow.connectable.schema_unavailable': string;
+    'link.flow.connectable.existing_edge_invalid': string;
+    'link.flow.connectable.validation.source_node_not_found': string;
+    'link.flow.connectable.validation.target_node_not_found': string;
+    'link.flow.connectable.validation.source_port_not_found': string;
+    'link.flow.connectable.validation.target_port_not_found': string;
+    'link.flow.connectable.validation.port_type_mismatch': string;
+    'link.flow.connectable.validation.source_node_not_allowed': string;
+    'link.flow.connectable.validation.target_node_not_allowed': string;
+    'link.flow.connectable.validation.source_node_denied': string;
+    'link.flow.connectable.validation.target_node_denied': string;
+    'link.flow.connectable.validation.source_max_connections_reached': string;
+    'link.flow.connectable.validation.target_max_connections_reached': string;
+    'link.flow.connectable.validation.self_connection_not_allowed': string;
     'link.flow.switch.condition_one': string;
     'link.flow.switch.condition_two': string;
     'link.flow.switch.condition_n': string;

package/dist/locales/zh-CN/link/flow.d.ts

@@ -145,6 +145,28 @@ declare const _default: {
     'link.flow.force_online_confirm': string;
     'link.flow.offline_success': string;
     'link.flow.operation_title': string;
+    'link.flow.connectable.category_unavailable': string;
+    'link.flow.connectable.connector_unavailable': string;
+    'link.flow.connectable.action_unavailable': string;
+    'link.flow.connectable.load_failed': string;
+    'link.flow.connectable.no_compatible_nodes': string;
+    'link.flow.connectable.no_compatible_input': string;
+    'link.flow.connectable.no_compatible_output': string;
+    'link.flow.connectable.no_bidirectional_compatible_port': string;
+    'link.flow.connectable.schema_unavailable': string;
+    'link.flow.connectable.existing_edge_invalid': string;
+    'link.flow.connectable.validation.source_node_not_found': string;
+    'link.flow.connectable.validation.target_node_not_found': string;
+    'link.flow.connectable.validation.source_port_not_found': string;
+    'link.flow.connectable.validation.target_port_not_found': string;
+    'link.flow.connectable.validation.port_type_mismatch': string;
+    'link.flow.connectable.validation.source_node_not_allowed': string;
+    'link.flow.connectable.validation.target_node_not_allowed': string;
+    'link.flow.connectable.validation.source_node_denied': string;
+    'link.flow.connectable.validation.target_node_denied': string;
+    'link.flow.connectable.validation.source_max_connections_reached': string;
+    'link.flow.connectable.validation.target_max_connections_reached': string;
+    'link.flow.connectable.validation.self_connection_not_allowed': string;
     'link.flow.switch.condition_one': string;
     'link.flow.switch.condition_two': string;
     'link.flow.switch.condition_n': string;

package/dist/locales/zh-CN.d.ts

@@ -145,6 +145,28 @@ declare const _default: {
     'link.flow.force_online_confirm': string;
     'link.flow.offline_success': string;
     'link.flow.operation_title': string;
+    'link.flow.connectable.category_unavailable': string;
+    'link.flow.connectable.connector_unavailable': string;
+    'link.flow.connectable.action_unavailable': string;
+    'link.flow.connectable.load_failed': string;
+    'link.flow.connectable.no_compatible_nodes': string;
+    'link.flow.connectable.no_compatible_input': string;
+    'link.flow.connectable.no_compatible_output': string;
+    'link.flow.connectable.no_bidirectional_compatible_port': string;
+    'link.flow.connectable.schema_unavailable': string;
+    'link.flow.connectable.existing_edge_invalid': string;
+    'link.flow.connectable.validation.source_node_not_found': string;
+    'link.flow.connectable.validation.target_node_not_found': string;
+    'link.flow.connectable.validation.source_port_not_found': string;
+    'link.flow.connectable.validation.target_port_not_found': string;
+    'link.flow.connectable.validation.port_type_mismatch': string;
+    'link.flow.connectable.validation.source_node_not_allowed': string;
+    'link.flow.connectable.validation.target_node_not_allowed': string;
+    'link.flow.connectable.validation.source_node_denied': string;
+    'link.flow.connectable.validation.target_node_denied': string;
+    'link.flow.connectable.validation.source_max_connections_reached': string;
+    'link.flow.connectable.validation.target_max_connections_reached': string;
+    'link.flow.connectable.validation.self_connection_not_allowed': string;
     'link.flow.switch.condition_one': string;
     'link.flow.switch.condition_two': string;
     'link.flow.switch.condition_n': string;

package/dist/locales/zh-TW/link/flow.d.ts

@@ -144,6 +144,28 @@ declare const _default: {
     'link.flow.force_online_confirm': string;
     'link.flow.offline_success': string;
     'link.flow.operation_title': string;
+    'link.flow.connectable.category_unavailable': string;
+    'link.flow.connectable.connector_unavailable': string;
+    'link.flow.connectable.action_unavailable': string;
+    'link.flow.connectable.load_failed': string;
+    'link.flow.connectable.no_compatible_nodes': string;
+    'link.flow.connectable.no_compatible_input': string;
+    'link.flow.connectable.no_compatible_output': string;
+    'link.flow.connectable.no_bidirectional_compatible_port': string;
+    'link.flow.connectable.schema_unavailable': string;
+    'link.flow.connectable.existing_edge_invalid': string;
+    'link.flow.connectable.validation.source_node_not_found': string;
+    'link.flow.connectable.validation.target_node_not_found': string;
+    'link.flow.connectable.validation.source_port_not_found': string;
+    'link.flow.connectable.validation.target_port_not_found': string;
+    'link.flow.connectable.validation.port_type_mismatch': string;
+    'link.flow.connectable.validation.source_node_not_allowed': string;
+    'link.flow.connectable.validation.target_node_not_allowed': string;
+    'link.flow.connectable.validation.source_node_denied': string;
+    'link.flow.connectable.validation.target_node_denied': string;
+    'link.flow.connectable.validation.source_max_connections_reached': string;
+    'link.flow.connectable.validation.target_max_connections_reached': string;
+    'link.flow.connectable.validation.self_connection_not_allowed': string;
     'link.flow.switch.condition_one': string;
     'link.flow.switch.condition_two': string;
     'link.flow.switch.condition_n': string;

package/dist/locales/zh-TW.d.ts

@@ -144,6 +144,28 @@ declare const _default: {
     'link.flow.force_online_confirm': string;
     'link.flow.offline_success': string;
     'link.flow.operation_title': string;
+    'link.flow.connectable.category_unavailable': string;
+    'link.flow.connectable.connector_unavailable': string;
+    'link.flow.connectable.action_unavailable': string;
+    'link.flow.connectable.load_failed': string;
+    'link.flow.connectable.no_compatible_nodes': string;
+    'link.flow.connectable.no_compatible_input': string;
+    'link.flow.connectable.no_compatible_output': string;
+    'link.flow.connectable.no_bidirectional_compatible_port': string;
+    'link.flow.connectable.schema_unavailable': string;
+    'link.flow.connectable.existing_edge_invalid': string;
+    'link.flow.connectable.validation.source_node_not_found': string;
+    'link.flow.connectable.validation.target_node_not_found': string;
+    'link.flow.connectable.validation.source_port_not_found': string;
+    'link.flow.connectable.validation.target_port_not_found': string;
+    'link.flow.connectable.validation.port_type_mismatch': string;
+    'link.flow.connectable.validation.source_node_not_allowed': string;
+    'link.flow.connectable.validation.target_node_not_allowed': string;
+    'link.flow.connectable.validation.source_node_denied': string;
+    'link.flow.connectable.validation.target_node_denied': string;
+    'link.flow.connectable.validation.source_max_connections_reached': string;
+    'link.flow.connectable.validation.target_max_connections_reached': string;
+    'link.flow.connectable.validation.self_connection_not_allowed': string;
     'link.flow.switch.condition_one': string;
     'link.flow.switch.condition_two': string;
     'link.flow.switch.condition_n': string;