@digitalsee-ai/rcs 1.1.8 → 2.0.0-beta2

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

@@ -0,0 +1,33 @@
+import { NodeType } from '../types/Node';
+import { Node, NodeProps } from '@xyflow/react';
+import { default as React } from 'react';
+/**
+ * 解析 ReactFlow `node.type` 字符串，拆出 NodeType + nodeKey + version。
+ *
+ * 规则：
+ * - 经典 key（不含 `@`）→ 仅 baseNodeType，nodeKey/nodeVersion 为 undefined
+ * - 2 段（`${nodeType}@${nodeKey}`，version 缺省或为 0 也走 3 段）→ 仅 baseNodeType + nodeKey
+ * - 3 段（`${nodeType}@${nodeKey}@${version}`，含 @0）→ 全部三段，version=0 也保留
+ * - 段数异常或 version 非有限数字 → console.warn 后整体退化为 baseNodeType，
+ *   由调用方再按 NodeType 经典描述符兜底渲染
+ */
+export declare function parseDescriptorTypeKey(type: string): {
+    baseNodeType: NodeType | string;
+    nodeKey?: string;
+    nodeVersion?: number;
+};
+/**
+ * 声明式节点渲染入口。
+ *
+ * 取代 13 个仅做 SuperBaseNode 包装的细瘦组件（Action/Trigger/Condition/Loop/...）。
+ * 节点之间的差异由 CLASSIC_DESCRIPTORS 描述：
+ * - className：驱动 *.less 中的节点变体样式
+ * - fallbackIcon：data.icon 为空时的回退图标
+ * - inputs / outputs / byProtocol：按 (type, protocol) 的静态端口声明
+ *   （经 resolveNodeHandleConfigs 转为端口元数据：id + 位置 + 方向 + 约束）
+ * - useNodePackagePorts：是否走 useNodePackagePorts 加载 schema 端口
+ *
+ * STICKY 节点不复用此组件，由 NodeFactory 单点特判处理。
+ */
+declare const DeclaredNode: React.FC<NodeProps<Node>>;
+export default DeclaredNode;

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

@@ -0,0 +1,24 @@
+import { NodeType } from '../types/Node';
+import { Node, NodeProps } from '@xyflow/react';
+import { default as React } from 'react';
+/**
+ * 解析 ReactFlow `node.type` 字符串，拆出 NodeType + nodeKey + version。
+ *
+ * 规则：
+ * - 经典 key（不含 `@`）→ 仅 baseNodeType，nodeKey/nodeVersion 为 undefined
+ * - 2 段（`${nodeType}@${nodeKey}`，version 缺省或为 0 也走 3 段）→ 仅 baseNodeType + nodeKey
+ * - 3 段（`${nodeType}@${nodeKey}@${version}`，含 @0）→ 全部三段，version=0 也保留
+ * - 段数异常或 version 非有限数字 → console.warn 后整体退化为 baseNodeType，
+ *   由调用方再按 NodeType 经典描述符兜底渲染
+ */
+export declare function parseDescriptorTypeKey(type: string): {
+    baseNodeType: NodeType | string;
+    nodeKey?: string;
+    nodeVersion?: number;
+};
+/**
+ * NodePackage 动态渲染节点
+ *
+ */
+declare const DynamicNode: React.FC<NodeProps<Node>>;
+export default DynamicNode;

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

@@ -1,6 +1,5 @@
 import { NodeData, NodeType } from '../types/Node';
-import { Node, XYPosition } from '@xyflow/react';
-import { ComponentType } from 'react';
+import { Node, NodeTypes, XYPosition } from '@xyflow/react';
 export type { NodeData } from '../types/Node';
 export interface BackendNodeData {
     node_type: string;
@@ -15,10 +14,49 @@ export interface BackendNodeData {
     properties: any;
 }
 declare class NodeFactory {
-    static getNodeTypes(): Record<NodeType, ComponentType<any>>;
+    /**
+     * 节点 → ReactFlow 组件注册表。
+     *
+     * 历史：每个 NodeType 拥有独立 wrapper（如 ActionNode / TriggerNode …），
+     * 各自重复 SuperBaseNode 的包装 + 端口声明；现已统一收敛到 DeclaredNode
+     * + nodeTypeRegistry.ts 中声明式描述。
+     *
+     * 现在：
+     * - STICKY 走独立组件（不挂端口）
+     * - 其余 NodeType 枚举值注册 DeclaredNode 作为经典 wrapper
+     * - 每个已注册到 {@link nodeTypeRegistry} 的动态 descriptorId 注册独立 versioned wrapper
+     *   （key = `${nodeType}@${nodeKey}@${version}`），实现不同版本/不同 nodepackage
+     *   类型在同一画布共存而互不污染。
+     */
+    static getNodeTypes(): NodeTypes;
     static mapTypeToBackendType(type: NodeType | string): string;
-    static createNode(type: NodeType, id: string, data: NodeData, position?: XYPosition): Node<NodeData>;
+    static createNode(type: NodeType | string, id: string, data: NodeData, position?: XYPosition): Node<NodeData>;
     static toBackendFormat(node: Node<NodeData>): BackendNodeData;
     private static extractNodeProperties;
 }
 export default NodeFactory;
+/**
+ * 订阅注册表变更的 React hook。
+ *
+ * - 首次返回当前已合并的经典+动态 wrapper
+ * - 运行期新增/注销动态描述符时返回新 map，触发 ReactFlow 重建 nodeTypes
+ * - `initialSeed` 仅在首次挂载时与内置 map 合并；运行期以 registry 为准
+ */
+export declare function useNodeTypes(initialSeed?: NodeTypes): NodeTypes;
+/**
+ * 确保某个 (nodeType, nodeKey, version) 组合的 ReactFlow wrapper 已注册。
+ *
+ * 入参 data 必须包含以下字段（任一缺失即跳过）：
+ * - `action_key` 或 `nodeKey`：nodepackage 节点标识，缺省视为经典节点
+ * - `node_type` 或 `type`：用于在 CLASSIC_DESCRIPTORS 查找 base 描述符
+ * - `action_ver` 或 `nodeVersion`：schema 版本号；缺省或非数字时 descriptorId 省略末段
+ *
+ * 行为：
+ * - 缺 action_key：console.warn 后返回 null，调用方回退到 NodeType 经典描述符
+ * - 已注册：立即返回 identity（幂等）
+ * - 未注册：从 {@link nodePackageSchemaCache} 拉取 schema（命中即同步返回 / 否则远端拉取）；
+ *   schema 拉取失败仅 console.error，wrapper 仍按 base 注册（行为修复留待后续 PR）
+ *
+ * 该函数必须在 ReactFlow `addNodes` 之前 await 完成，否则节点会因 type 未注册被丢弃。
+ */
+export declare function ensureNodeTypeRegistered(data: Record<string, unknown>): Promise<string | null>;

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

@@ -24,7 +24,8 @@ export interface BaseNodeProps {
     data: NodeData;
     type?: NodeType;
     selected?: boolean;
-    icon?: React.ReactNode;
+    fallbackIcon?: React.ReactNode;
+    iconUri?: string;
     color?: string;
     inputs?: HandleConfig[];
     outputs?: HandleConfig[];

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

@@ -0,0 +1,51 @@
+import { DipPortSchema } from '../api/dip';
+import { HandleConfig } from './SuperBaseNode';
+import { HandleType } from '../types/Handle';
+import { default as React } from 'react';
+/**
+ * 经典节点静态端口声明。
+ *
+ * 形态对齐 NodePackage nodeSchema 的 {@link DipPortSchema}
+ * （name / displayName / type / maxConnections / position…），
+ * 另含经典渲染所需的视觉扩展（shape / category / style）。
+ * 每份声明都是确定值，由 (NodeType, protocol) 组合静态索引，不再依赖节点数据判断。
+ */
+export interface NodePortSchema extends Omit<DipPortSchema, 'protocol'> {
+    /** 连接协议；缺省 'main' */
+    protocol?: string;
+    /** 方向覆盖；缺省 inputs→target / outputs→source */
+    handleType?: HandleType;
+    /** 视觉形状（AI slave 菱形桩等） */
+    shape?: 'circle' | 'square' | 'rhombus';
+    /** CustomHandle 类别（AI slave 桩为 'slave'） */
+    category?: 'main' | 'secondary' | 'slave';
+    /** 手工定位样式（如 { top: '33%' } / { left: '35%' }）；缺省不注入，由 CustomHandle 预设样式定位 */
+    style?: React.CSSProperties;
+    /** isMain 覆盖；缺省 name === 'main' */
+    isMain?: boolean;
+}
+/** (type, protocol) 维度的端口覆盖声明；省略一侧即继承 type 级默认。 */
+export interface NodePortsDeclaration {
+    inputs?: NodePortSchema[];
+    outputs?: NodePortSchema[];
+}
+/**
+ * 节点自身端口间的自动连线声明。
+ *
+ * 添加节点后读取并按协议校验，自动创建节点自身的 source -> target 连线
+ * （如 LOOP 的 `loop -> input` 自环边）。未声明的节点默认不自动连线。
+ */
+export interface NodeAutoConnectRule {
+    /** 连线起点：节点自身端口名 */
+    source: string;
+    /** 连线终点：节点自身端口名 */
+    target: string;
+}
+/**
+ * 静态端口声明 → SuperBaseNode 所需的 handle 配置。
+ *
+ * 纯函数、无数据依赖；声明只读，调用方可安全缓存转换结果。
+ * style 仅透传声明值，未声明时由 CustomHandle 预设样式定位
+ * （避免给 top/bottom 端口注入 top 偏移破坏布局）。
+ */
+export declare function createClassicHandleConfigs(ports: NodePortSchema[] | undefined, side: 'input' | 'output'): HandleConfig[];

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

@@ -0,0 +1,11 @@
+import { NodeStatus } from '../../types/Node';
+import { default as React } from 'react';
+export interface NodeStatusBadgeProps {
+    status: NodeStatus;
+    disabled?: boolean;
+}
+/**
+ * 节点状态统一展示在标题行中，与卡片边缘的连接锚点保持视觉分离。
+ */
+declare const NodeStatusBadge: React.FC<NodeStatusBadgeProps>;
+export default NodeStatusBadge;

package/dist/components/digitalsee/workflow/Nodes/{classicNodePackagePortLayout.d.ts → nodePackagePortLayout.d.ts}

@@ -1,18 +1,18 @@
 import { DipNodeSchema } from '../api/dip';
 import { HandleConfig } from './SuperBaseNode';
-export interface ClassicNodePackagePortLayout {
+export interface NodePackagePortLayout {
     inputs: HandleConfig[];
     outputs: HandleConfig[];
     height: number;
     compact: boolean;
 }
 /**
- * 按端口较多的一侧计算 CLASSIC nodepackage 节点高度。
+ * 按端口较多的一侧计算 NodePackage 节点高度。
  *
  * 1–6 个端口保持 72px；7–12 个端口按 24px 递增；超过 12 个端口
  * 使用 16px 紧凑步长，并在极端 Schema 下限制节点最大高度。
  */
-export declare function getClassicNodePackageHeight(portCount: number): {
+export declare function getNodePackagePortHeight(portCount: number): {
     height: number;
     compact: boolean;
 };
@@ -20,4 +20,4 @@ export declare function getClassicNodePackageHeight(portCount: number): {
  * 将 NodeSchema 的 inputs/outputs 转为 SuperBaseNode 所需的 handle 配置。
  * 不补造默认端口，空数组即代表该方向没有端口。
  */
-export declare function createClassicNodePackagePortLayout(schema: Pick<DipNodeSchema, 'inputs' | 'outputs'>): ClassicNodePackagePortLayout;
+export declare function createNodePackagePortLayout(schema: Pick<DipNodeSchema, 'inputs' | 'outputs'>): NodePackagePortLayout;

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

@@ -0,0 +1,131 @@
+import { NodeAutoConnectRule, NodePortSchema, NodePortsDeclaration } from './classicPortLayout';
+import { HandleConfig } from './SuperBaseNode';
+import { NodeType } from '../types/Node';
+import { resolveSwitchNodePackagePortSchema, SwitchNodePackageBranch } from '../utils/switchNodePackage';
+import { Node } from '@xyflow/react';
+import { default as React } from 'react';
+import { DipPortSchema } from '../api/dip';
+export type NodeLegacyData = Record<string, unknown> | undefined | null;
+export interface NodeTypeDescriptor {
+    type: NodeType | string;
+    className: string;
+    fallbackIcon: React.ReactNode;
+    /** type 级默认输入端口声明（node.data.protocol 缺失或未命中 byProtocol 时使用） */
+    inputs: NodePortSchema[];
+    /** type 级默认输出端口声明 */
+    outputs: NodePortSchema[];
+    /** (type, protocol) 维度端口覆盖；protocol 读取 node.data.protocol */
+    byProtocol?: Record<string, NodePortsDeclaration>;
+    /** 节点自身端口间的自动连线声明（添加节点后创建，如 LOOP 的 loop -> input 自环）；缺省不自动连线 */
+    autoConnect?: NodeAutoConnectRule[];
+    useNodePackagePorts: boolean;
+    /** 动态 nodepackage 节点的 nodeKey（仅动态描述符有） */
+    nodeKey?: string;
+    /** 动态 nodepackage 节点的 schema 版本号（仅动态描述符有） */
+    nodeVersion?: number;
+    /** 描述符唯一 id，等于 `${type}@${nodeKey}@${nodeVersion}`（仅动态描述符有） */
+    descriptorId?: string;
+}
+/**
+ * 经典静态描述符：NodeType 枚举值 → 描述符。
+ *
+ * 每个确定的 (NodeType, protocol) 组合对应一份确定的端口布局等配置：
+ * - inputs / outputs：type 级默认端口声明
+ * - byProtocol：按 node.data.protocol 覆盖端口（如 MCP return-variable 无出桩、
+ *   AI 子节点按协议出对应桩位），取代历史散落在工厂函数里的 isMcpXXX 等节点判断
+ *
+ * 节点系统重构后，这一份仍代表「无 nodeKey/version 时的回退行为」；
+ * 动态 nodepackage 描述符通过 {@link dynamicDescriptors} 独立存储，
+ * 查询时由 {@link getNodeTypeDescriptor} 合并两者。
+ */
+export declare const CLASSIC_DESCRIPTORS: Record<NodeType, NodeTypeDescriptor>;
+/**
+ * 把 (nodeType, nodeKey, version) 拼成描述符 id。
+ *
+ * 规则：
+ * - 缺 nodeKey：返回 null（不注册，由 NodeType 经典描述符兜底）
+ * - 缺 version / version 非有限数字：返回 `${nodeType}@${nodeKey}`（2 段）
+ * - version === 0 或其他有限数字：返回 `${nodeType}@${nodeKey}@${version}`（3 段，含 @0）
+ */
+export declare function buildDescriptorId(nodeKey: string, version?: number | null): string | null;
+/**
+ * 注册动态描述符的入参。
+ *
+ * 与 `NodeTypeDescriptor` 的区别：baseNodeType 只用于查找 base 描述符并继承字段，
+ * 不会以 `type` 形式写入 dynamic 描述符——避免误导使用方。
+ */
+export interface RegisterNodeTypeDescriptorOptions {
+    /** 后端返回的 node_type，用于在 CLASSIC_DESCRIPTORS 查找 base 描述符 */
+    baseNodeType: NodeType | string;
+    /** nodepackage 节点 action_key，缺省时注册被跳过 */
+    nodeKey: string;
+    /** nodepackage 节点 schema 版本号（含 0）。缺省时 descriptorId 省略末段 */
+    nodeVersion?: number;
+}
+/**
+ * 注册动态描述符，返回生成的 descriptorId。
+ *
+ * - 缺 nodeKey：console.warn 后返回 null，由调用方回退到 NodeType 经典描述符
+ * - 同 id 重复注册视为幂等，不会重复触发 listeners
+ * - dynamic 描述符继承 base 描述符的全部字段（className / fallbackIcon /
+ *   useNodePackagePorts / inputs / outputs / byProtocol），仅 metadata 不同
+ */
+export declare function registerNodeTypeDescriptor(options: RegisterNodeTypeDescriptorOptions): string | null;
+/**
+ * 列出当前已注册的所有动态描述符 id（仅动态部分，不含经典）。
+ */
+export declare function listRegisteredDescriptorIds(): string[];
+/**
+ * 监听注册表变更；返回取消订阅函数。
+ *
+ * 通知按帧合并，同一 tick 内多次 register 只触发一次回调，
+ * 避免 ReactFlow 在批量添加节点过程中重复重建 nodeTypes。
+ */
+export declare function subscribeNodeTypeRegistry(listener: () => void): () => void;
+/**
+ * 查询节点描述符：经典 NodeType → CUSTOM 兜底。
+ *
+ * 调用方应当把 ReactFlow `node.type` 原样传入：
+ * - 经典节点 `type = "ActionNode"` → 命中 CLASSIC_DESCRIPTORS
+ * - nodepackage 节点 `type = "ActionNode@plugin.http@3"` → 兜底 CUSTOM 描述符
+ *   （nodepackage 的端口/样式由 nodePackageSchemaCache 驱动，见 DynamicNode）
+ *
+ * 不再接收 data 参数：descriptorId 已包含完整身份信息，无需再用 data 反推。
+ */
+export declare function getNodeTypeDescriptor(type: NodeType | string): NodeTypeDescriptor;
+/**
+ * 从节点数据读取 protocol（仅非空字符串有效，其余视为未携带）。
+ */
+export declare function getNodeProtocol(data?: NodeLegacyData): string | undefined;
+/**
+ * 按 (type, protocol) 解析静态端口声明；protocol 取自 data.protocol，
+ * 缺失或未命中 byProtocol 时回退 type 级默认。
+ */
+export declare function resolveNodePorts(type: NodeType | string, data?: NodeLegacyData): Required<NodePortsDeclaration>;
+/**
+ * 按 (type, protocol) 解析渲染用 handle 配置；声明为静态确定值，转换结果模块级缓存。
+ */
+export declare function resolveNodeHandleConfigs(type: NodeType | string, data?: NodeLegacyData): {
+    inputs: HandleConfig[];
+    outputs: HandleConfig[];
+};
+export declare function peekSchemaHandleInfo(node: Node, handleName: string): DipPortSchema | null;
+export declare function peekHandleInfoByProtocol(node: Node, protocol: string, isInput: boolean, preferredName?: string): DipPortSchema | null;
+/**
+ * 测试与单测 hook：清空动态注册表。
+ *
+ * 业务侧不应调用；保留导出仅供测试隔离用例使用。
+ */
+export declare function __resetDynamicNodeTypeDescriptorsForTests(): void;
+/**
+ * 根据节点实例的 branches 配置构造 Switch legacy outputs，
+ * 端口 id 与 style 推导保持与原 SwitchNode 行为一致。
+ */
+export declare function buildSwitchLegacyOutputs(data?: NodeLegacyData): HandleConfig[];
+/**
+ * 读取节点实例的 Switch 分支原始数据（仅 branches，不做端口映射）。
+ * 供 resolveSwitchNodePackagePortSchema 的 curried resolver 复用同一份数据源。
+ */
+export declare function readSwitchBranches(data?: NodeLegacyData): SwitchNodePackageBranch[];
+export declare function branchesToLegacyOutputs(branches: SwitchNodePackageBranch[]): HandleConfig[];
+export { resolveSwitchNodePackagePortSchema };

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

@@ -0,0 +1,35 @@
+import { DipNodeSchema } from '../api/dip';
+import { HandleConfig } from './SuperBaseNode';
+import { NodeData, NodeType } from '../types/Node';
+type PortLoadStatus = 'legacy' | 'loading' | 'ready' | 'error';
+interface UseNodePackagePortsOptions {
+    nodeType: NodeType | string;
+    data: NodeData;
+    legacyInputs: HandleConfig[];
+    legacyOutputs: HandleConfig[];
+    resolvePortSchema?: (schema: DipNodeSchema) => Pick<DipNodeSchema, 'inputs' | 'outputs'>;
+    /**
+     * 已由 ReactFlow `node.type` 解析出的 nodeKey（仅 dynamic descriptorId 路径提供）。
+     * 命中时跳过 data 上的 action_key / nodeKey / inlineSchema 推断。
+     */
+    overrideNodeKey?: string;
+    /** 已由 ReactFlow `node.type` 解析出的 schema 版本号（仅 dynamic descriptorId 路径提供）。 */
+    overrideNodeVersion?: number;
+}
+interface NodePackagePortsResult {
+    inputs: HandleConfig[];
+    outputs: HandleConfig[];
+    height?: number;
+    status: PortLoadStatus;
+    isNodePackage: boolean;
+    schema: DipNodeSchema | null;
+}
+/**
+ * 为 NodePackage 节点加载 NodeSchema 并生成动态端口。
+ *
+ * 仅当宿主开启 connectable 能力且节点被判定为 NodePackage（action_id <= 0）时生效；
+ * 其它节点完整保留 legacy 端口。Schema 通过 {@link peekNodePackageSchema} 从全局 cache 同步读取，
+ * 未命中时由 {@link getNodePackageSchema} 远端拉取（已通过 connectable 列表预热 cache）。
+ */
+export declare function useNodePackagePorts({ nodeType, data, legacyInputs, legacyOutputs, resolvePortSchema, overrideNodeKey, overrideNodeVersion, }: UseNodePackagePortsOptions): NodePackagePortsResult;
+export {};

package/dist/components/digitalsee/workflow/NodesConfig/NodePackageConfig/fieldSchemaAdapter.d.ts

@@ -0,0 +1,14 @@
+import { FieldDef, FormSchema, VisibleWhen } from '../../../../dynamic-form/types/form-schema';
+import { DipDisplayCondition, DipFieldSchema } from '../../api/dip';
+/**
+ * 将后端 DisplayCondition 转为 DynamicForm VisibleWhen
+ */
+export declare function convertDisplayCondition(condition: DipDisplayCondition | null | undefined): VisibleWhen | undefined;
+/**
+ * 转换单个 DIP FieldSchema → DynamicForm FieldDef
+ */
+export declare function convertFieldSchema(field: DipFieldSchema): FieldDef;
+/**
+ * 将 DIP FieldSchema 数组转换为 DynamicForm FormSchema
+ */
+export declare function convertFieldsToFormSchema(fields: DipFieldSchema[]): FormSchema;

package/dist/components/digitalsee/workflow/NodesConfig/components/FormFieldRenderer/fields/RichTagInput/help.d.ts

@@ -1,3 +1,7 @@
 export declare const TAG_TESTER: RegExp;
 export declare const strToElm: (value: any, capturePattern: any) => any;
-export declare const parseInitValue: (value: any, capturePattern: any) => any;
+export declare const parseInitValue: (value: any, capturePattern: any) => {
+    type: string;
+    className: string;
+    children: any;
+}[];

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

@@ -14,6 +14,7 @@ interface IFormFieldRendererProps {
     onSubmit(properties: any, isRunNodeTest?: boolean): void;
     onNodePackageValuesChange?: (properties: Record<string, unknown>) => void;
     mcpMode?: boolean;
+    preRender?: React.ReactNode;
 }
 /**
  * @description 动作节点配置表单渲染器，负责解析后台 schema、保存配置以及触发节点测试。

package/dist/components/digitalsee/workflow/NodesConfig/components/NodeTest.d.ts

@@ -1,6 +1,8 @@
 interface NodeTestProps {
     nodeId: string;
     beforeHook?: (isRunNodeTest?: boolean, ignore?: boolean, output?: string) => void;
+    onClose: () => void;
+    onExpandPanel: (expand: boolean) => void;
 }
 declare const NodeTest: import('react').ForwardRefExoticComponent<NodeTestProps & import('react').RefAttributes<unknown>>;
 export default NodeTest;

package/dist/components/digitalsee/workflow/NodesConfig/components/NodeTest.helpers.d.ts

@@ -1,4 +1,14 @@
 import { NodeStatus } from '../../types/Node';
+interface NodeTestAvailabilityInput {
+    canEdit: boolean;
+    nodeType?: string;
+    protocol?: string;
+}
+export interface NodeTestAvailability {
+    disabled: boolean;
+    reason?: string;
+}
+export declare const getNodeTestAvailability: ({ canEdit, nodeType, protocol, }: NodeTestAvailabilityInput) => NodeTestAvailability;
 export declare const isFailedNodeTestResponse: (data: unknown) => boolean;
 export declare const getNodeTestStatus: (data: unknown) => NodeStatus.FAILED | NodeStatus.SUCCESS;
 export declare const formatNodeTestResult: (data: unknown) => string;
@@ -11,3 +21,4 @@ export type SampleValidation = {
 };
 /** 校验「使用样本数据」的输入：非空 + 合法 JSON，返回规整后的文本或错误文案。 */
 export declare const validateSampleData: (raw: string) => SampleValidation;
+export {};

package/dist/components/digitalsee/workflow/NodesConfig/components/VariableModal/tree-help.d.ts

@@ -18,23 +18,16 @@ interface Output {
     value: null | string;
 }
 export declare enum Type {
+    Array = "ARRAY",
     Boolean = "BOOLEAN",
+    Null = "NULL",
     Number = "NUMBER",
     Object = "OBJECT",
     String = "STRING"
 }
-export declare const ColorMap: {
-    BOOLEAN: string;
-    NUMBER: string;
-    OBJECT: string;
-    STRING: string;
-};
-export declare const TypeTagMap: {
-    BOOLEAN: string;
-    NUMBER: string;
-    OBJECT: string;
-    STRING: string;
-};
+export declare const ColorMap: Record<string, string>;
+export declare const TypeTagMap: Record<string, string>;
+export declare const getVariableTypeLabel: (type: string, multiValued?: boolean) => string;
 export declare const transformServerTree2Local: (serverData: VarDatum[]) => {
     label: string;
     sub_params: Output[];

package/dist/components/digitalsee/workflow/NodesConfig/submitPayload.d.ts

@@ -1,23 +1,16 @@
-import { NodeType } from '../types/Node';
 type AnyRecord = Record<string, any>;
-export declare function isMcpGatewayNodeType(nodeType?: string | null): nodeType is NodeType;
-export declare function getMcpGatewayActionKey(nodeType?: string | null): string;
-export declare function isNextCompatibleNodeType(nodeType?: string | null): nodeType is NodeType;
 /**
- * 判断 classic 画布中的节点是否需要用新版 NodeSchema 渲染/保存。
+ * 判断节点是否属于 NodePackage 节点（有新版 NodeSchema 描述）。
  *
- * 返回 true 的含义不是 EngineMode.NEXT 节点，而是 nodepackage 节点：
- * classic 配置面板里要启用 DynamicForm + NodeSchema 兼容链路。
- * 判定顺序按后端数据可信度从强到弱：
+ * 唯一强信号：data.action_id 是否 <= 0。
+ * - action_id <= 0（含 undefined / NaN / 0 / 负数）→ NodePackage（dynamic wrapper 路径）
+ * - action_id > 0 → 经典（NodeType 经典描述符路径）
  *
- * 1. `config_schema/properties.sub_params` 是旧节点强信号，直接走旧表单。
- * 2. `action_id/id > 0` 是旧节点强信号；`action_id/id <= 0` 才可能是新版节点。
- * 3. 没有 `action_key/nodeKey` 的节点不能拉新版 schema，仍走旧表单。
- * 4. 老 Loop/If/Switch 保存后没有 `sub_params`，但会出现控制节点业务配置，
- *    这些也必须继续走专用控制表单。
+ * 该规则与 {@link useDataLoading.preloadClassicNodeSchemas} / {@link useDataLoading.ensureClassicNodeTypesRegistered}
+ * 的过滤条件保持一致。Schema 本身已不再写入 node.data，因此不再读取 data.node_schema 作为信号。
  */
-export declare function isClassicNextCompatibleNode(nodeType: string | undefined, data?: AnyRecord): boolean;
-export declare function unwrapNextCompatiblePropertiesEnvelope(value: unknown): AnyRecord;
-export declare function getNextCompatibleSubmittedProperties(values: unknown): AnyRecord;
-export declare function getNextCompatibleAccountId(values: unknown): any;
+export declare function isNodePackageNode(data?: AnyRecord): boolean;
+export declare function unwrapNodePackagePropertiesEnvelope(value: unknown): AnyRecord;
+export declare function getNodePackageSubmittedProperties(values: unknown): AnyRecord;
+export declare function getNodePackageAccountId(values: unknown): any;
 export {};

package/dist/components/digitalsee/workflow/Panels/CanvasConfigDebugger.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { CanvasEngineConfig } from '../types/engine';
+import { default as React } from 'react';
 export interface CanvasConfigDebuggerProps {
     /**
      * 当前画布配置（部分配置即可）

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/components/CategoryItem.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { CategoryItem as CategoryItemType } from '../types';
+import { default as React } from 'react';
 interface CategoryItemProps {
     category: CategoryItemType;
     onClick: (category: CategoryItemType) => void;

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/components/CategoryTabs.d.ts

@@ -7,7 +7,7 @@ interface CategoryTabsProps {
     onChange: (category: CategoryItem) => void;
 }
 /**
- * @description 分类标签组件，承载“全部 + 分类”平铺的快捷筛选。
+ * @description 分类标签组件,承载“全部 + 分类”平铺的快捷筛选。
  * @param {CategoryTabsProps} props 分类与交互参数。
  * @returns {JSX.Element} Tab 渲染结果。
  */

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/components/NodeCard.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { ActionItem, NodeTypeItem } from '../types';
+import { default as React } from 'react';
 interface NodeCardProps {
     node: NodeTypeItem;
     expanded: boolean;

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/components/NodeItem.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { NodeTypeItem } from '../types';
+import { default as React } from 'react';
 interface NodeItemProps {
     node: NodeTypeItem;
     onClick: (node: NodeTypeItem) => void;

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/components/PanelHeader.d.ts

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { CategoryItem, NodeTypeItem } from '../types';
+import { default as React } from 'react';
 interface PanelHeaderProps {
     currentCategory: CategoryItem | null;
     categoryPath: CategoryItem[];

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

@@ -3,13 +3,11 @@ import { NodeAddInfo } from '../../../types/NodeAddContext';
 type SearchHandler = NonNullable<ModernNodeSelectorProps['onSearch']>;
 type CategoryHandler = NonNullable<ModernNodeSelectorProps['onFetchCategories']>;
 type NodeCategoryHandler = NonNullable<ModernNodeSelectorProps['onFetchNodesByCategory']>;
-type EntryMode = 'automation' | 'mcp' | null;
 interface FetchNodeActionOptions {
     suppressLoading?: boolean;
 }
 interface UseConnectableNodeSelectorProps {
     nodeSelectorVisible: boolean;
-    entryMode: EntryMode;
     effectiveNodeAddInfo?: NodeAddInfo | null;
     workflowId?: string;
     onSearch?: SearchHandler;
@@ -20,13 +18,12 @@ interface UseConnectableNodeSelectorProps {
 /**
  * @description 为 NodePackage 连线场景选择数据源，并封装查询与边中插入求交。
  */
-export declare function useConnectableNodeSelector({ nodeSelectorVisible, entryMode, effectiveNodeAddInfo, workflowId, onSearch, onFetchCategories, onFetchNodesByCategory, fetchLegacyNodeActions, }: UseConnectableNodeSelectorProps): {
+export declare function useConnectableNodeSelector({ nodeSelectorVisible, effectiveNodeAddInfo, workflowId, onSearch, onFetchCategories, onFetchNodesByCategory, }: UseConnectableNodeSelectorProps): {
     actionRequestContextKey: string;
     connectableContext: import('../utils/connectableQuery').ConnectableQueryContext;
-    useConnectableDataSource: boolean;
     onSearch: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
     onFetchCategories: (type?: import('../types').CategoryRequestType) => Promise<import('../types').CategoryItem[]>;
     onFetchNodesByCategory: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
-    fetchNodeActions: (node: NodeTypeItem, options?: FetchNodeActionOptions) => Promise<ActionItem[]>;
+    fetchNodeActions: (node: NodeTypeItem, _options?: FetchNodeActionOptions) => Promise<ActionItem[]>;
 };
 export {};