@digitalsee-ai/rcs 1.0.16 → 1.1.1

package/dist/components/digitalsee/workflow/Canvas/NextConfigModalWrapper.d.ts

@@ -1,5 +1,5 @@
 /**
- * Next 模式配置弹窗包装器
+ * EngineMode.NEXT 配置弹窗包装器（暂废保留分支）
  *
  * 职责：
  * - 从 ReactFlow store 根据 currentNodeConfigVisibleId 取当前节点数据

package/dist/components/digitalsee/workflow/Canvas/actionItemToNodeData.d.ts

@@ -0,0 +1,14 @@
+import { NodeData as NodeFactoryData } from '../Nodes/NodeFactory';
+import { ActionItem } from '../Panels/ModernNodeSelectorPanel/types';
+type ConvertibleActionItem = Partial<ActionItem> & {
+    status?: string;
+    protocol?: string;
+} & Record<string, unknown>;
+/** 将节点动作转换为 CLASSIC 画布节点数据。 */
+export declare const convertActionItemToNodeData: (actionItem: ConvertibleActionItem) => NodeFactoryData;
+/**
+ * NEXT 模式专用转换函数（暂废保留分支）：额外保留 name 字段。
+ * 当前 nodepackage 节点仍走 CLASSIC 的 convertActionItemToNodeData。
+ */
+export declare const convertActionItemToNodeDataNext: (actionItem: ConvertibleActionItem) => NodeFactoryData;
+export {};

package/dist/components/digitalsee/workflow/Canvas/constants.d.ts

@@ -1,9 +1,8 @@
 import { EdgeType } from '../enums/edge';
-import { NodeData as NodeFactoryData } from '../Nodes/NodeFactory';
-import { ActionItem } from '../Panels/ModernNodeSelectorPanel/types';
 import { CanvasAPI } from '../types/engine';
 import { NodeType } from '../types/Node';
 import { Edge, MarkerType, Node, Viewport } from '@xyflow/react';
+export { convertActionItemToNodeData, convertActionItemToNodeDataNext, } from './actionItemToNodeData';
 export declare const startNode: {
     type: NodeType;
     id: string;
@@ -19,18 +18,6 @@ export declare const startNode: {
         description: string;
     };
 };
-export declare const convertActionItemToNodeData: (actionItem: Partial<ActionItem> & {
-    status?: string;
-    protocol?: string;
-} & Record<string, any>) => NodeFactoryData;
-/**
- * NEXT 模式专用转换函数：在 convertActionItemToNodeData 基础上额外保留 name 字段
- * name 在 NEXT 模式下作为节点实例的唯一显示名称
- */
-export declare const convertActionItemToNodeDataNext: (actionItem: Partial<ActionItem> & {
-    status?: string;
-    protocol?: string;
-} & Record<string, any>) => NodeFactoryData;
 export declare const nodeTypes: Record<NodeType, import('react').ComponentType<any>>;
 export declare const edgeTypes: {
     main: import('react').FC<import('../Edges/BaseEdge').CustomEdgeProps>;

package/dist/components/digitalsee/workflow/Canvas/constants.test.d.ts

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

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

@@ -0,0 +1,31 @@
+import { NodeData as NodeFactoryData } from '../../Nodes/NodeFactory';
+import { NodeAddInfo } from '../../types/NodeAddContext';
+import { EdgeConfig } from '../../types/engine';
+import { Edge, Node } from '@xyflow/react';
+type ReportConnectable = (messageId: string, details: Record<string, unknown>) => void;
+type ReportAmbiguousPorts = (details: Record<string, unknown>) => void;
+export interface TryConnectClassicNodePackageParams {
+    info: NodeAddInfo;
+    newNode: Node<NodeFactoryData>;
+    currentNodes: Node[];
+    currentEdges: Edge[];
+    canUseConnectablePorts: boolean;
+    addEdges: (edges: Edge[]) => void;
+    removeEdges: (edgeIds: string[]) => void;
+    handleEdgeAddNode: (position: {
+        x: number;
+        y: number;
+    }, edge?: Edge) => void;
+    saveFlow: () => Promise<void>;
+    reportConnectableFallback: ReportConnectable;
+    reportAmbiguousPorts: ReportAmbiguousPorts;
+    validateConnectionAgainstSnapshot: (edge: EdgeConfig, nodes: Node[], edges: Edge[]) => boolean;
+}
+/**
+ * 尝试按 NodePackage Schema 连接新建节点。
+ *
+ * 返回 true 表示该上下文已完整处理（成功连线或保留独立节点并给出提示）；
+ * 返回 false 时调用方继续 legacy 固定 handle 流程。
+ */
+export declare function tryConnectClassicNodePackage({ info, newNode, currentNodes, currentEdges, canUseConnectablePorts, addEdges, removeEdges, handleEdgeAddNode, saveFlow, reportConnectableFallback, reportAmbiguousPorts, validateConnectionAgainstSnapshot, }: TryConnectClassicNodePackageParams): Promise<boolean>;
+export {};

package/dist/components/digitalsee/workflow/Canvas/hooks/classicNodeAddConnection.test.d.ts

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

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

@@ -1,29 +1,15 @@
 import { WorkflowCanvasStrategy } from '../types';
 import { NodeData as NodeFactoryData } from '../../Nodes/NodeFactory';
 import { ActionItem } from '../../Panels/ModernNodeSelectorPanel/types';
+import { NodeAddInfo } from '../../types/NodeAddContext';
 import { Edge, Node } from '@xyflow/react';
-interface NodeAddInfo {
-    sourceNodeId?: string;
-    sourceHandle?: string;
-    targetNodeId?: string;
-    targetHandle?: string;
-    position?: {
-        x: number;
-        y: number;
-    };
-    trigger?: boolean;
-    edge?: any;
-    sourceNode?: any;
-    targetNode?: any;
-    protocol?: string;
-    refresh?: boolean;
-}
 interface CreateNodeAddHandlerNextParams {
     workflowId?: string;
     strategy: WorkflowCanvasStrategy;
     store: {
         getState: () => {
             nodes: Node[];
+            edges: Edge[];
         };
     };
     addNodes: (nodes: Node<NodeFactoryData>[]) => void;
@@ -40,6 +26,9 @@ interface CreateNodeAddHandlerNextParams {
 /**
  * 创建 NEXT 模式的节点添加处理函数（纯函数，非 Hook）
  *
+ * 该分支目前暂废保留；当前 AI 连接流里的 nodepackage 节点是在
+ * CLASSIC 画布中兼容渲染新版 NodeSchema，不走这里的添加逻辑。
+ *
  * 与 Classic 模式的关键区别：
  * 1. 端口名称完全由 DIP Schema 动态定义（通过 getCachedNextNodeSchema 获取）
  * 2. 使用 convertActionItemToNodeDataNext 转换数据（保留 name 字段）

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

@@ -2,29 +2,16 @@ import { WorkflowCanvasStrategy } from '../types';
 import { EngineMode } from '../../enums/workflow';
 import { NodeData as NodeFactoryData } from '../../Nodes/NodeFactory';
 import { ActionItem } from '../../Panels/ModernNodeSelectorPanel/types';
+import { EdgeConfig } from '../../types/engine';
+import { NodeAddInfo } from '../../types/NodeAddContext';
 import { Edge, Node } from '@xyflow/react';
-interface NodeAddInfo {
-    sourceNodeId?: string;
-    sourceHandle?: string;
-    targetNodeId?: string;
-    targetHandle?: string;
-    position?: {
-        x: number;
-        y: number;
-    };
-    trigger?: boolean;
-    edge?: any;
-    sourceNode?: any;
-    targetNode?: any;
-    protocol?: string;
-    refresh?: boolean;
-}
 interface UseNodeAddCallbackParams {
     workflowId?: string;
     strategy: WorkflowCanvasStrategy;
     store: {
         getState: () => {
             nodes: Node[];
+            edges: Edge[];
         };
     };
     addNodes: (nodes: Node<NodeFactoryData>[]) => void;
@@ -37,8 +24,9 @@ interface UseNodeAddCallbackParams {
     }, edge?: Edge) => void;
     setNodeConfigVisible: (nodeId: string | null) => void;
     setNodeFitHumanView: (nodeId: string) => void;
+    validateConnectionAgainstSnapshot: (edge: EdgeConfig, nodes: Node[], edges: Edge[]) => boolean;
     saveFlow: () => Promise<void>;
     engineMode: EngineMode;
 }
-export declare function useNodeAddCallback({ workflowId, strategy, store, addNodes, addEdges, removeEdges, setNodeAddCallback, handleEdgeAddNode, setNodeConfigVisible, setNodeFitHumanView, saveFlow, engineMode, }: UseNodeAddCallbackParams): void;
+export declare function useNodeAddCallback({ workflowId, strategy, store, addNodes, addEdges, removeEdges, setNodeAddCallback, handleEdgeAddNode, setNodeConfigVisible, setNodeFitHumanView, validateConnectionAgainstSnapshot, saveFlow, engineMode, }: UseNodeAddCallbackParams): void;
 export {};

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

@@ -6,7 +6,7 @@ import { useNodesInteraction } from '../../hooks/use-nodes-interaction';
 import { usePanel } from '../../hooks/usePanel';
 import { useWorkflow } from '../../hooks/useWorkflow';
 import { useAppDispatch } from '../../store';
-import { CanvasAPI } from '../../types/engine';
+import { CanvasAPI, EdgeConfig as EngineEdgeConfig } from '../../types/engine';
 import { Connection, Edge, EdgeChange, Node, NodeChange, useEdgesState, useNodesState, useReactFlow, useStoreApi } from '@xyflow/react';
 import { default as React } from 'react';
 export interface WorkflowCanvasStateResult {
@@ -35,6 +35,8 @@ export interface WorkflowCanvasStateResult {
     onNodesChange: (changes: NodeChange[]) => void;
     handleEdgesChange: (changes: EdgeChange[]) => void;
     handleConnect: (params: Connection) => void;
+    isValidConnection: (params: Connection | Edge) => boolean;
+    validateConnectionAgainstSnapshot: (edge: EngineEdgeConfig, nodes: Node[], edges: Edge[]) => boolean;
     handleEdgeAddNode: (position: {
         x: number;
         y: number;

package/dist/components/digitalsee/workflow/Handles/CustomHandle.d.ts

@@ -1,3 +1,4 @@
+import { DipPortSchema } from '../api/dip';
 import { Connection, HandleType as FlowHandleType, Position, IsValidConnection as ReactFlowIsValidConnection } from '@xyflow/react';
 import { default as React } from 'react';
 import { NodeStatus } from '../types/Node';
@@ -20,6 +21,8 @@ interface CustomHandleProps {
     square?: boolean;
     shape?: 'square' | 'circle' | 'rhombus';
     protocol?: string;
+    /** NodePackage 真实端口 Schema；仅用于保留端口元数据，不改变 input 只接收连线的语义。 */
+    portSchema?: DipPortSchema;
 }
 /**
  * @description 自定义连接桩组件，统一输出 11×11px 菱形桩点并同步节点状态色。

package/dist/components/digitalsee/workflow/Handles/customHandleConnectable.d.ts

@@ -0,0 +1,35 @@
+import { Node } from '@xyflow/react';
+import { NodeAddInfo } from '../types/NodeAddContext';
+interface HandleExtenderVisibilityOptions {
+    type: 'source' | 'target';
+    isFull: boolean;
+    connectionInProgress: boolean;
+    canEdit: boolean;
+}
+/**
+ * 判断连接桩是否展示快捷新增入口。
+ *
+ * 画布连线始终由 output/source 发起，input/target 只接收连线，
+ * 因此快捷新增入口只允许展示在输出桩。连接数达到上限时隐藏入口。
+ */
+export declare function shouldShowHandleExtender(options: HandleExtenderVisibilityOptions): boolean;
+/** output 只能发起连线，input 只能接收连线；空间布局不改变端口语义。 */
+export declare function getHandleConnectionPermissions(type: 'source' | 'target', canEdit: boolean): {
+    isConnectableStart: boolean;
+    isConnectableEnd: boolean;
+};
+interface BuildHandleNodeAddInfoOptions {
+    type: 'source' | 'target';
+    nodeId: string;
+    handleId: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    protocol?: string;
+    anchorNode?: Node;
+    refresh: boolean;
+}
+/** 构造连接桩快捷新增上下文，避免输入桩误带 source/protocol 语义。 */
+export declare function buildHandleNodeAddInfo(options: BuildHandleNodeAddInfoOptions): NodeAddInfo;
+export {};

package/dist/components/digitalsee/workflow/Handles/customHandleConnectable.test.d.ts

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

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

@@ -1,6 +1,6 @@
+import { NodeData, NodeStatus } from '../types/Node';
 import { Node, NodeProps } from '@xyflow/react';
 import { default as React } from 'react';
-import { NodeData, NodeStatus } from '../types/Node';
 interface ActionNodeProps extends NodeProps<Node<NodeData>> {
     status?: NodeStatus;
 }

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

@@ -1,6 +1,6 @@
+import { NodeStatus } from '../types/Node';
 import { NodeProps } from '@xyflow/react';
 import { default as React } from 'react';
-import { NodeStatus } from '../types/Node';
 interface ConditionNodeProps extends NodeProps {
     status?: NodeStatus;
 }

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

@@ -1,9 +1,10 @@
 import { ComponentType } from 'react';
 /**
- * NEXT 模式专属节点工厂
+ * NEXT 模式专属节点工厂（暂废保留分支）
  *
  * 提供 NEXT 模式的 nodeTypes 映射，所有节点基于 DIP Schema 动态渲染锚点
  * 与 classic 模式完全隔离，直接使用 DIP 端口名，无需适配层
+ * 当前 nodepackage 节点使用 Classic NodeFactory，并在配置面板兼容新版 NodeSchema。
  */
 declare class NextNodeFactory {
     static getNodeTypes(): Record<string, ComponentType<any>>;

package/dist/components/digitalsee/workflow/Nodes/NextNodes/NextBaseNode.d.ts

@@ -6,10 +6,11 @@ interface NextBaseNodeProps extends NodeProps {
     className?: string;
 }
 /**
- * NEXT 模式基础节点组件
+ * NEXT 模式基础节点组件（暂废保留分支）
  *
  * 根据 DIP Schema 动态渲染锚点，直接使用 DIP 端口名作为 handle ID
  * 不再需要端口适配层，实现 NEXT 模式与 classic 模式的完全隔离
+ * 当前 nodepackage 节点仍复用 Classic 节点外观，仅配置面板兼容新版 NodeSchema。
  */
 declare const NextBaseNode: React.FC<NextBaseNodeProps>;
 export default NextBaseNode;

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

@@ -1,6 +1,6 @@
+import { NodeData, NodeType } from '../types/Node';
 import { Node, XYPosition } from '@xyflow/react';
 import { ComponentType } from 'react';
-import { NodeData, NodeType } from '../types/Node';
 export type { NodeData } from '../types/Node';
 export interface BackendNodeData {
     node_type: string;

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

@@ -1,14 +1,19 @@
-import { Position } from '@xyflow/react';
-import { default as React } from 'react';
+import { DipPortSchema } from '../api/dip';
 import { HandleType } from '../types/Handle';
 import { NodeData, NodeStatus, NodeType } from '../types/Node';
+import { Position } from '@xyflow/react';
+import { default as React } from 'react';
 export interface HandleConfig {
     id: string;
     position: Position;
     type: HandleType;
     isMain?: boolean;
-    label?: string;
+    label?: React.ReactNode;
     maxConnections?: number;
+    /** NodePackage 端口的连接类型；与 legacy protocol 语义保持隔离。 */
+    connectionType?: string;
+    /** 原始端口 Schema，供统一连线校验器读取 type/required/黑白名单等约束。 */
+    portSchema?: DipPortSchema;
     style?: React.CSSProperties;
     category?: string;
     protocol?: string;

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

@@ -1,6 +1,6 @@
+import { NodeStatus } from '../types/Node';
 import { NodeProps } from '@xyflow/react';
 import { default as React } from 'react';
-import { NodeStatus } from '../types/Node';
 interface SwitchNodeProps extends NodeProps {
     status?: NodeStatus;
 }

package/dist/components/digitalsee/workflow/Nodes/classicNodePackageNodes.test.d.ts

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

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

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

package/dist/components/digitalsee/workflow/Nodes/classicNodePackagePortLayout.test.d.ts

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

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

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { NodeType } from '../../types/Node';
+import { default as React } from 'react';
 export interface NextNodeOperationsProps {
     nodeId: string;
     type: NodeType;

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

@@ -0,0 +1,26 @@
+import { DipNodeSchema } from '../api/dip';
+import { HandleConfig } from './SuperBaseNode';
+import { NodeData, NodeType } from '../types/Node';
+type PortLoadStatus = 'legacy' | 'loading' | 'ready' | 'error';
+interface UseClassicNodePackagePortsOptions {
+    nodeType: NodeType;
+    data: NodeData;
+    legacyInputs: HandleConfig[];
+    legacyOutputs: HandleConfig[];
+}
+interface ClassicNodePackagePortsResult {
+    inputs: HandleConfig[];
+    outputs: HandleConfig[];
+    height?: number;
+    status: PortLoadStatus;
+    isNodePackage: boolean;
+    schema: DipNodeSchema | null;
+}
+/**
+ * 为 CLASSIC nodepackage 节点加载 NodeSchema 并生成动态端口。
+ *
+ * 仅当宿主开启 connectable 能力、引擎是 CLASSIC 且
+ * isClassicNextCompatibleNode 返回 true 时生效；其它节点完整保留 legacy 端口。
+ */
+export declare function useClassicNodePackagePorts({ nodeType, data, legacyInputs, legacyOutputs, }: UseClassicNodePackagePortsOptions): ClassicNodePackagePortsResult;
+export {};

package/dist/components/digitalsee/workflow/Nodes/useClassicNodePackagePorts.test.d.ts

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

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

@@ -1,5 +1,7 @@
+import { NodeType } from '../../types/Node';
 interface ActionNodeConfigProps {
     nodeId: string;
+    nodeType?: NodeType | string;
     data: any;
     onSubmit: (values: any, isRunNodeTest?: boolean) => void;
 }

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

@@ -1,8 +1,10 @@
 /**
- * 新版节点配置组件（Next 版本）
+ * EngineMode.NEXT 配置组件（暂废保留分支）
  *
- * 根据 nodeKey 获取 NodeSchema，用 DynamicForm 渲染配置表单。
+ * 根据 nodeKey 从 DIP 获取 NodeSchema，用 DynamicForm 渲染配置表单。
  * 当 NodeSchema.credentials 非空时，显示凭据选择器。
+ * 当前日常说的“新版节点”一般指 CLASSIC 兼容渲染 NodeSchema 的 nodepackage 节点，
+ * 不走这个组件。
  */
 interface NextNodeConfigProps {
     nodeId: string;

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

@@ -1,8 +1,10 @@
 import { ExecuteAction } from '../../define/actions';
+import { NodeType } from '../../../types/Node';
 interface IFormFieldRendererProps {
     action: ExecuteAction & {
         proxy_id?: string;
     };
+    nodeType?: NodeType | string;
     connector?: {
         id: string;
         deployment_type?: string;

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

@@ -0,0 +1,23 @@
+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 渲染/保存。
+ *
+ * 返回 true 的含义不是 EngineMode.NEXT 节点，而是 nodepackage 节点：
+ * classic 配置面板里要启用 DynamicForm + NodeSchema 兼容链路。
+ * 判定顺序按后端数据可信度从强到弱：
+ *
+ * 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`，但会出现控制节点业务配置，
+ *    这些也必须继续走专用控制表单。
+ */
+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 {};

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

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

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

@@ -1,5 +1,5 @@
-import { default as React } from 'react';
 import { ActionItem as ActionItemType, NodeTypeItem } from '../types';
+import { default as React } from 'react';
 interface ActionItemProps {
     action: ActionItemType;
     parentNode: NodeTypeItem;

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

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export type EntryMode = 'automation' | 'mcp' | null;
+interface EntryTypeSelectorProps {
+    onSelect: (mode: Exclude<EntryMode, null>) => void;
+}
+/** @description 首节点入口类型选择。 */
+declare const EntryTypeSelector: React.FC<EntryTypeSelectorProps>;
+export default EntryTypeSelector;

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

@@ -0,0 +1,19 @@
+import { NodeActionMeta } from '../hooks/useNodeActionState';
+import { ActionItem, NodeTypeItem } from '../types';
+import { default as React } from 'react';
+interface NodeCardListProps {
+    isSearching: boolean;
+    visibleNodes: NodeTypeItem[];
+    useConnectableDataSource: boolean;
+    expandedNodeIds: string[];
+    nodeActionsMap: Record<string, NodeActionMeta>;
+    searchText: string;
+    isLoadingNodes: boolean;
+    hasMore: boolean;
+    onNodeToggle: (node: NodeTypeItem) => void;
+    onActionSelect: (node: NodeTypeItem, action: ActionItem) => void;
+    onLoadAllActions: (node: NodeTypeItem) => void;
+}
+/** @description 节点卡片集合及其加载、空态和分页尾部。 */
+declare const NodeCardList: React.FC<NodeCardListProps>;
+export default NodeCardList;

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

@@ -5,6 +5,8 @@ interface UseActionsProps {
 }
 interface FetchNodeActionOptions {
     suppressLoading?: boolean;
+    page?: number;
+    size?: number;
 }
 /**
  * @description 节点动作获取相关能力，返回动作加载状态与查询方法。

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

@@ -1,13 +1,16 @@
-import { CategoryItem } from '../types';
+import { CategoryItem, CategoryRequestType } from '../types';
+import { NodeAddInfo } from '../../../types/NodeAddContext';
 interface UseCategoriesProps {
-    onFetchCategories: (type?: 'trigger' | 'action' | 'tool' | 'mcp' | 'model' | 'memory') => Promise<CategoryItem[]>;
+    onFetchCategories: (type?: CategoryRequestType) => Promise<CategoryItem[]>;
     restrictToCategory?: string;
     nodeSelectorVisible: boolean;
-    nodeAddInfo?: any;
+    nodeAddInfo?: NodeAddInfo | null;
     fallbackCategories?: CategoryItem[];
+    requestContextKey: string;
 }
-export declare const useCategories: ({ onFetchCategories, restrictToCategory, nodeSelectorVisible, nodeAddInfo, fallbackCategories, }: UseCategoriesProps) => {
+export declare const useCategories: ({ onFetchCategories, restrictToCategory, nodeSelectorVisible, nodeAddInfo, fallbackCategories, requestContextKey, }: UseCategoriesProps) => {
     categories: CategoryItem[];
+    categoriesReady: boolean;
     isLoadingCategories: boolean;
     setCategories: import('react').Dispatch<import('react').SetStateAction<CategoryItem[]>>;
 };

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

@@ -0,0 +1,40 @@
+import { ActionItem, LinkSearchParams, ModernNodeSelectorProps, NodeFetchResult, NodeTypeItem } from '../types';
+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;
+    onFetchCategories?: CategoryHandler;
+    onFetchNodesByCategory?: NodeCategoryHandler;
+    fetchLegacyNodeActions: (node: NodeTypeItem, options?: FetchNodeActionOptions) => Promise<ActionItem[]>;
+}
+/**
+ * @description 为 NodePackage 连线场景选择数据源，并封装查询、边中插入求交与旧接口回退。
+ */
+export declare function useConnectableNodeSelector({ nodeSelectorVisible, entryMode, effectiveNodeAddInfo, workflowId, onSearch, onFetchCategories, onFetchNodesByCategory, fetchLegacyNodeActions, }: UseConnectableNodeSelectorProps): {
+    actionRequestContextKey: string;
+    connectableContext: import('../utils/connectableQuery').ConnectableQueryContext;
+    useConnectableDataSource: boolean;
+    onSearch: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
+    onFetchCategories: (type?: import('../types').CategoryRequestType) => Promise<import('../types').CategoryItem[] | {
+        id: any;
+        name: any;
+        description: any;
+        icon: any;
+        search_action: any;
+        children: any;
+        nodes: any[];
+    }[]>;
+    onFetchNodesByCategory: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
+    fetchNodeActions: (node: NodeTypeItem, options?: FetchNodeActionOptions) => Promise<ActionItem[]>;
+};
+export {};

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

@@ -1,14 +1,16 @@
 import { CategoryItem, LinkSearchParams, NodeFetchResult, NodeTypeItem } from '../types';
+import { NodeAddInfo } from '../../../types/NodeAddContext';
 interface UseNavigationProps {
     categories: CategoryItem[];
+    categoriesReady: boolean;
     initialCategory?: string;
     nodeSelectorVisible: boolean;
-    nodeAddInfo?: any;
+    nodeAddInfo?: NodeAddInfo | null;
     onFetchNodesByCategory: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
     defaultPageSize?: number;
     flowId?: string;
 }
-export declare const useNavigation: ({ categories, initialCategory, nodeSelectorVisible, nodeAddInfo, onFetchNodesByCategory, defaultPageSize, flowId, }: UseNavigationProps) => {
+export declare const useNavigation: ({ categories, categoriesReady, initialCategory, nodeSelectorVisible, nodeAddInfo, onFetchNodesByCategory, defaultPageSize, flowId, }: UseNavigationProps) => {
     categoryNodes: NodeTypeItem[];
     currentCategory: CategoryItem;
     isLoadingNodes: boolean;

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

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

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

@@ -0,0 +1,30 @@
+import { ActionItem, NodeTypeItem } from '../types';
+export interface NodeActionMeta {
+    actions: ActionItem[];
+    loading: boolean;
+    source?: 'search-partial' | 'full';
+}
+interface UseNodeActionStateProps {
+    actionRequestContextKey: string;
+    contextMode?: string;
+    fetchNodeActions: (node: NodeTypeItem, options?: {
+        suppressLoading?: boolean;
+    }) => Promise<ActionItem[]>;
+    isMcpServerEntryMode: boolean;
+    visibleNodes: NodeTypeItem[];
+    searchResults: NodeTypeItem[];
+    searchText: string;
+    activeCategoryId?: string;
+}
+/**
+ * @description 管理连接器的展开状态、动作缓存，以及异步动作请求的竞态保护。
+ */
+export declare function useNodeActionState({ actionRequestContextKey, contextMode, fetchNodeActions, isMcpServerEntryMode, visibleNodes, searchResults, searchText, activeCategoryId, }: UseNodeActionStateProps): {
+    expandedNodeIds: string[];
+    nodeActionsMap: Record<string, NodeActionMeta>;
+    handleNodeToggle: (node: NodeTypeItem) => Promise<void>;
+    handleLoadAllActions: (node: NodeTypeItem) => Promise<void>;
+    resetNodeActionState: () => void;
+    setExpandedNodeIds: import('react').Dispatch<import('react').SetStateAction<string[]>>;
+};
+export {};