@digitalsee-ai/rcs 2.0.4-beta4 → 2.0.4-beta5

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

@@ -1,8 +1,9 @@
+import { PortNodeKeyAccessCode } from './portConnectionValidator';
 import { Node } from '@xyflow/react';
 /**
- * 统一连线检查的结果码，命名对齐 portConnectionValidator 的 code 风格。
+ * 统一连线检查的结果码，端口黑白名单部分复用 PortNodeKeyAccessCode。
  */
-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 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' | PortNodeKeyAccessCode;
 export interface ConnectionCheckResult {
     valid: boolean;
     code: ConnectionCheckCode;
@@ -22,7 +23,8 @@ export interface ConnectionCheckConnection {
  * 范围（与手动拖线今天的实际行为一致，再叠自连规则门）：
  * 1. 节点存在性；
  * 2. 协议一致性（大小写不敏感；双侧均无法解析协议时放行，保留旧 `?? ''` 行为）；
- * 3. 自连（source === target）必须命中节点声明的 auto_connect 规则。
+ * 3. 自连（source === target）必须命中节点声明的 auto_connect 规则；
+ * 4. NodePackage schema.input / schema.output 的 node key 黑白名单（放在最后验证）。
  *
  * workflowConnectionValidator 的重链（edgeRules / connectable / native 校验）
  * 有意不在本检查内，仍由各自的既有入口负责。

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

@@ -1,5 +1,5 @@
 import { DipNodeSchema } from '../api/dip';
-import { PortConnectionEdge, PortConnectionValidationCode } from './portConnectionValidator';
+import { NormalizedDipPortSchema, PortConnectionEdge, PortConnectionValidationCode } from './portConnectionValidator';
 import { Node } from '@xyflow/react';
 export type NodePackageConnectionCode = PortConnectionValidationCode | 'NOT_APPLICABLE' | 'SCHEMA_NOT_READY';
 export interface NodePackageConnectionResult {
@@ -19,6 +19,11 @@ export interface ValidateNodePackageConnectionInput {
 /** 同步解析已预加载的 NodePackage Schema。 */
 export declare function resolveNodePackageSchema(node?: Node | null): DipNodeSchema | null;
 export declare function isNodePackageConnectionNode(node?: Node | null): boolean;
+/**
+ * 读取 NodePackage 节点 schema 指定方向的端口定义（schema.inputs / schema.outputs）。
+ * 非 NodePackage 节点、Schema 未预热或端口未声明时返回 null，视为无黑白名单约束。
+ */
+export declare function findNodePackagePort(node: Node | undefined, handle: string | null | undefined, side: 'inputs' | 'outputs'): NormalizedDipPortSchema | null;
 /**
  * 校验两个 NodePackage 节点之间的端口连接。
  *

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

@@ -57,6 +57,28 @@ export interface PortConnectionValidationResult {
 export declare const normalizePortSchema: (port: DipPortSchema) => NormalizedDipPortSchema;
 /** 从 ReactFlow 节点 data 中解析用于黑白名单判断的 NodePackage schema key。 */
 export declare const getPortConnectionNodeIdentity: (node?: PortConnectionNode | null) => string | null;
+/** 端口 node key 黑白名单校验失败的返回码。 */
+export type PortNodeKeyAccessCode = 'SOURCE_NODE_DENIED' | 'TARGET_NODE_DENIED' | 'SOURCE_NODE_NOT_ALLOWED' | 'TARGET_NODE_NOT_ALLOWED';
+export interface PortNodeKeyAccessViolation {
+    code: PortNodeKeyAccessCode;
+    /** 中文兜底原因，便于 console 调试。 */
+    reason: string;
+}
+/** 黑白名单校验的单侧输入：本侧端口 Schema 约束匹配的是对端节点的身份。 */
+export interface PortNodeKeyAccessSide {
+    port: NormalizedDipPortSchema | null;
+    identity: string | null;
+}
+/**
+ * 按连接方向校验端口 node key 黑白名单（schema.input / schema.output）：
+ * - 未配置（缺失或为空）不限制；
+ * - 黑名单命中即拒绝；
+ * - 白名单非空时，过滤完黑名单后必须命中白名单；
+ * - 不在黑名单且未配置白名单则允许。
+ *
+ * 双侧 port 均可为 null（该侧无 Schema 约束，仅跳过该侧规则）；返回 null 表示放行。
+ */
+export declare const checkPortNodeKeyAccess: (source: PortNodeKeyAccessSide, target: PortNodeKeyAccessSide) => PortNodeKeyAccessViolation | null;
 /**
  * 按 NodePackage PortSchema 校验一条准备创建的连接。
  *