@digitalsee-ai/rcs 2.0.4-alpha → 2.0.4-beta10

package/dist/components/digitalsee/workflow/Canvas/hooks/useWorkflowCanvasState.d.ts

@@ -2,7 +2,7 @@ import { WorkflowCanvasProps } from '../constants';
 import { SaveStatus } from '../../enums/workflow';
 import { useEdgesInteraction } from '../../hooks/use-edges-interaction';
 import { useFlowDataOperation } from '../../hooks/use-flow-data-operation';
-import { useNodesInteraction } from '../../hooks/use-nodes-interaction';
+import { useNodeHoverHandlers } from '../../hooks/use-nodes-interaction';
 import { usePanel } from '../../hooks/usePanel';
 import { useWorkflow } from '../../hooks/useWorkflow';
 import { useAppDispatch } from '../../store';
@@ -63,8 +63,8 @@ export interface WorkflowCanvasStateResult {
     handleTidy: () => void;
     onEdgeMouseEnter: ReturnType<typeof useEdgesInteraction>['onEdgeMouseEnter'];
     onEdgeMouseLeave: ReturnType<typeof useEdgesInteraction>['onEdgeMouseLeave'];
-    onNodeMouseEnter: ReturnType<typeof useNodesInteraction>['onNodeMouseEnter'];
-    onNodeMouseLeave: ReturnType<typeof useNodesInteraction>['onNodeMouseLeave'];
+    onNodeMouseEnter: ReturnType<typeof useNodeHoverHandlers>['onNodeMouseEnter'];
+    onNodeMouseLeave: ReturnType<typeof useNodeHoverHandlers>['onNodeMouseLeave'];
     onNodeContextMenu: (event: React.MouseEvent, node: Node) => void;
     onPaneContextMenu: (event: React.MouseEvent) => void;
     updateSaveStatus: (status: SaveStatus, error?: Error) => void;

package/dist/components/digitalsee/workflow/Edges/EdgeFactory.d.ts

@@ -1,9 +1,11 @@
 import { EdgeType } from '../enums/edge';
 import { EdgeData } from '../types/Edge';
-import { Edge } from '@xyflow/react';
-interface EdgeCreationOptions {
+import { Edge, Node } from '@xyflow/react';
+export interface EdgeCreationOptions {
     sourceHandle?: string;
     targetHandle?: string;
+    sourceNode?: Node | null;
+    targetNode?: Node | null;
     data?: EdgeData;
     onAddNode?: (position: {
         x: number;
@@ -27,12 +29,12 @@ declare class EdgeFactory {
     static getEdgeComponent(type: EdgeType): import('react').FC<import('./BaseEdge').CustomEdgeProps>;
     /**
      * 创建一个连线实例
-     * @param type 连线类型
+     * @param type 连线类型（若不提供或为 MAIN，则仅当 source/target 为 NodePackage 节点时取其 handle 对应类型，否则为 MAIN）
      * @param id 连线ID
      * @param source 源节点ID
      * @param target 目标节点ID
-     * @param options 可选参数，包括sourceHandle, targetHandle, data和回调函数
+     * @param options 可选参数，包括sourceHandle, targetHandle, sourceNode, targetNode, data和回调函数
      */
-    static createEdge(type: EdgeType | string, id: string, source: string, target: string, options?: EdgeCreationOptions): Edge;
+    static createEdge(type: EdgeType | string | undefined | null, id: string, source: string, target: string, options?: EdgeCreationOptions): Edge;
 }
 export default EdgeFactory;

package/dist/components/digitalsee/workflow/Nodes/classicPortLayout.d.ts

@@ -23,6 +23,8 @@ export interface NodePortSchema extends Omit<DipPortSchema, 'protocol'> {
     style?: React.CSSProperties;
     /** isMain 覆盖；缺省 name === 'main' */
     isMain?: boolean;
+    /** 针对某种支持多种协议的情况 */
+    protocols?: string[];
 }
 /** (type, protocol) 维度的端口覆盖声明；省略一侧即继承 type 级默认。 */
 export interface NodePortsDeclaration {

package/dist/components/digitalsee/workflow/NodesConfig/components/FormFieldRenderer/fields/TextField/index.d.ts

@@ -15,6 +15,7 @@ interface TextFieldProps extends IFieldSuperProps {
     lang?: CodeEditorLanguage;
     onFocus?: () => void;
     onBlur?: () => void;
+    required?: boolean;
 }
 export declare const TextField: (props: TextFieldProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -303,11 +303,12 @@ export interface DipWorkflowDefinition {
  * | `DATETIME` | 日期时间 | DatePicker |
  * | `CODE` | 代码/JSON 文本 | 工作流代码编辑器 |
  * | `PROXY` | 代理网关 | 工作流代理网关选择器 |
+ * | `GLOBAL_VARIABLE_KEY` | 全局变量键 | 工作流全局变量选择器 |
  * | `OBJECT` | 嵌套对象 | 递归渲染子字段 |
  * | `ARRAY` / `DYNAMIC_ARRAY` | 数组/列表 | 动态增减表单项 |
  * | `KEYVALUE` | 键值对列表 | Key-Value 编辑器 |
  */
-export type DipFieldType = 'STRING' | 'TEXTAREA' | 'PASSWORD' | 'HIDDEN' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATETIME' | 'CODE' | 'PROXY' | 'OBJECT' | 'ARRAY' | 'DYNAMIC_ARRAY' | 'KEYVALUE';
+export type DipFieldType = 'STRING' | 'TEXTAREA' | 'PASSWORD' | 'HIDDEN' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATETIME' | 'CODE' | 'PROXY' | 'GLOBAL_VARIABLE_KEY' | 'OBJECT' | 'ARRAY' | 'DYNAMIC_ARRAY' | 'KEYVALUE';
 /**
  * 数组元素类型
  *

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

@@ -168,7 +168,11 @@ export interface FlowOutputTreeRequest {
     edges?: any[];
 }
 export declare function apiGetFlowOutputTree(flowId: string, data: FlowOutputTreeRequest): Promise<any>;
-export declare function apiGetGlobalVariables(): Promise<any>;
+export interface GlobalVariablesQuery {
+    /** 传 1 时仅返回允许流程更新的全局变量 */
+    allowFlowUpdate?: 0 | 1;
+}
+export declare function apiGetGlobalVariables(query?: GlobalVariablesQuery): Promise<any>;
 /**
  * Fetches the account model for a credential schema key.
  *

package/dist/components/digitalsee/workflow/context/canvasConfig.d.ts

@@ -1,3 +1,9 @@
 import { CanvasEngineConfig } from '../types/engine';
+/**
+ * 判断当前是否处于工作流画布内（画布入口同时挂载 redux、CanvasConfig、ReactFlow 三个 Provider）。
+ *
+ * 仅用于区分「画布内组件」与「独立使用的表单组件」；业务组件取配置请用 useCanvasConfig。
+ */
+export declare const useHasCanvasConfig: () => boolean;
 export declare const useCanvasConfig: () => CanvasEngineConfig;
 export declare const CanvasConfigProvider: import('react').Provider<CanvasEngineConfig>;

package/dist/components/digitalsee/workflow/enums/node.d.ts

@@ -113,6 +113,7 @@ export declare enum NodeProtocol {
     AI_TEXT_SPLITTER = "AI_TEXTSPLITTER",
     AI_EMBEDDING = "AI_EMBEDDING",
     AI_TOOL = "AI_TOOL",
+    KNOWLEDGE = "KNOWLEDGE",
     MCP = "MCP",
     BUILTIN_MCP = "BUILTIN_MCP",
     MCP_SERVER = "MCP_SERVER"

package/dist/components/digitalsee/workflow/hooks/use-nodes-interaction.d.ts

@@ -1,8 +1,21 @@
 import { NodeType } from '../types/Node';
-import { NodeMouseHandler, OnNodesChange } from '@xyflow/react';
-export declare const useNodesInteraction: () => {
+import { Node, NodeMouseHandler } from '@xyflow/react';
+/** 受控画布 setNodes 的函数式签名（hover 只用函数式更新，保证不读到滞后快照）。 */
+type SetNodesFn = (updater: (nodes: Node[]) => Node[]) => void;
+type NodeHoverHandlersOptions = {
+    /**
+     * 受控画布的 React state 写入器（useNodesState 的 setNodes）。
+     * hover 等改动必须写受控 state：直写 RF store 会被 StoreUpdater 在下一次
+     * 同步时覆盖，且与 store 快照互写会放大选中态的代际差（双选中 bug 根因之一）。
+     */
+    setNodes: SetNodesFn;
+};
+/** 节点 hover 高亮：写受控 React state，不直写 RF store。 */
+export declare const useNodeHoverHandlers: ({ setNodes }: NodeHoverHandlersOptions) => {
     onNodeMouseEnter: NodeMouseHandler;
     onNodeMouseLeave: NodeMouseHandler;
-    handleNodesChange: OnNodesChange;
+};
+export declare const useNodesInteraction: () => {
     handleNodesDelete: (nodeIds: string[], nodeType: NodeType) => void;
 };
+export {};

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

@@ -252,6 +252,8 @@ export interface CanvasAPI {
     getNode(id: string): NodeConfig | null;
     selectNode(id: string): void;
     clearSelection(): void;
+    /** 清除单个节点的选中/悬停高亮（写受控 state，避免直写 RF store 被 StoreUpdater 覆盖）。 */
+    clearNodeHighlight(id: string): void;
     moveNode(id: string, pos: {
         x: number;
         y: number;

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

@@ -85,4 +85,8 @@ export declare function base64ToString(base64Str: string): string;
  * ```
  */
 export declare function isValidBase64(str: string): boolean;
+/**
+ * 模块级翻译函数：调用时动态读取全局 locale（由 DigitalseeWorkFlow 依据宿主传入的 locale 同步），
+ * 适用于工具函数、事件回调等非 React 上下文；渲染路径中的文案建议用 useIntl()/FormattedMessage（响应式）。
+ */
 export declare const t: import('../../../../locales').TranslateFn;

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/flowDataAdapter.d.ts

@@ -51,7 +51,7 @@ export declare function convertNodesToReactFlowFormat(backendNodes: BackendNode[
 /**
  * 将后端连接数据转换为前端可用的边数据
  */
-export declare function convertConnectionsToReactFlowEdges(connections: BackendConnection): Edge[];
+export declare function convertConnectionsToReactFlowEdges(connections: BackendConnection, nodes?: Node[]): Edge[];
 /**
  * 将后端响应数据转换为前端工作流数据
  */

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 校验一条准备创建的连接。
  *

package/dist/components/dynamic-form/components/ValueModeWrapper/index.d.ts

@@ -84,6 +84,8 @@ export interface ValueModeWrapperProps {
      * 代码编辑器语言（json / javascript）
      */
     lang?: CodeEditorLanguage;
+    /** 是否必填 */
+    required?: boolean;
 }
 export declare const ValueModeWrapper: React.FC<ValueModeWrapperProps>;
 export default ValueModeWrapper;

package/dist/components/dynamic-form/fields/special/GlobalVariableKeyField.d.ts

@@ -0,0 +1,3 @@
+/** 全局变量键的数据源动作名，宿主 optionsLoader 需实现该 action */
+export declare const GLOBAL_VARIABLE_KEY_ACTION = "globalVariables";
+export declare const GlobalVariableKeyField: import('../../types/field-component').FieldComponentDefinition<import('../../types/form-schema').FieldDef>;

package/dist/components/dynamic-form/fields/special/index.d.ts

@@ -1,5 +1,6 @@
 export { AutoCompleteField } from './AutoCompleteField';
 export { ColorPickerField } from './ColorPickerField';
+export { GlobalVariableKeyField, GLOBAL_VARIABLE_KEY_ACTION, } from './GlobalVariableKeyField';
 export { MentionsField } from './MentionsField';
 export { RateField } from './RateField';
 export { SliderField } from './SliderField';

package/dist/components/dynamic-form/types/field-component.d.ts

@@ -66,6 +66,8 @@ export interface FieldComponentProps<T extends FieldDef = FieldDef, K = unknown>
     onChange?: (value: unknown) => void;
     /** 字段 ID（由 Form.Item 注入） */
     id?: string;
+    /** 是否必填 */
+    required?: boolean;
 }
 /**
  * 字段组件元数据

package/dist/components/dynamic-form/types/form-schema.d.ts

@@ -65,6 +65,7 @@ export declare enum DynamicFormField {
     JSON = "JSON",// JSON 编辑器
     CODE = "CODE",// 工作流代码/JSON 编辑器（由宿主作用域注册）
     PROXY = "PROXY",// 工作流代理网关选择器（由宿主作用域注册）
+    GLOBAL_VARIABLE_KEY = "GLOBAL_VARIABLE_KEY",// 全局变量键选择器（选项由宿主 optionsLoader 提供）
     DIVIDER = "DIVIDER",// 分割线
     INFO_CARD = "INFO_CARD",// 展示卡片
     ARRAY = "ARRAY",// 简单数组
@@ -246,6 +247,12 @@ export type InfoCardField = BaseField & {
     closable?: boolean;
     showIcon?: boolean;
 };
+/** 全局变量键字段定义 */
+export type GlobalVariableKeyField = BaseField & {
+    type: DynamicFormField.GLOBAL_VARIABLE_KEY;
+    /** 静态兜底选项（宿主未提供 optionsLoader 时使用） */
+    options?: Option[];
+};
 /** 数组字段定义 */
 export type ArrayField = BaseField & {
     type: DynamicFormField.ARRAY;
@@ -298,7 +305,7 @@ export type ArrayObjectField = BaseField & {
     }) => Record<string, unknown>;
 };
 /** 字段定义联合类型 */
-export type FieldDef = BaseField | TextareaField | SelectField | RadioField | CheckboxGroupField | DateField | DateRangeField | TimeField | TimeRangeField | NumberField | UploadField | SliderField | RateField | CascaderField | TreeSelectField | AutoCompleteField | SwitchField | InfoCardField | ArrayField | ObjectField | KeyValueField | ArrayObjectField;
+export type FieldDef = BaseField | TextareaField | SelectField | RadioField | CheckboxGroupField | DateField | DateRangeField | TimeField | TimeRangeField | NumberField | UploadField | SliderField | RateField | CascaderField | TreeSelectField | AutoCompleteField | SwitchField | InfoCardField | GlobalVariableKeyField | ArrayField | ObjectField | KeyValueField | ArrayObjectField;
 /** 表单 Schema */
 export type FormSchema = {
     fields: FieldDef[];