@digitalsee-ai/rcs 1.1.0 → 1.1.1

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,19 +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 模式下作为节点实例的唯一显示名称
- * 当前 nodepackage 节点仍走 CLASSIC 的 convertActionItemToNodeData。
- */
-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,23 +1,8 @@
 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;

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

@@ -2,23 +2,9 @@ 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;
@@ -38,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/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/SuperBaseNode.d.ts

@@ -1,3 +1,4 @@
+import { DipPortSchema } from '../api/dip';
 import { HandleType } from '../types/Handle';
 import { NodeData, NodeStatus, NodeType } from '../types/Node';
 import { Position } from '@xyflow/react';
@@ -7,8 +8,12 @@ export interface HandleConfig {
     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/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/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/useCategories.d.ts

@@ -1,13 +1,16 @@
 import { CategoryItem, CategoryRequestType } from '../types';
+import { NodeAddInfo } from '../../../types/NodeAddContext';
 interface UseCategoriesProps {
     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 {};

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

@@ -0,0 +1,24 @@
+import { CategoryItem, LinkSearchParams, NodeTypeItem } from '../types';
+import { NodeAddInfo } from '../../../types/NodeAddContext';
+interface UseNodeSelectorPresentationProps {
+    effectiveNodeAddInfo?: NodeAddInfo | null;
+    isEntryTypeSelection: boolean;
+    activeCategoryId?: string;
+    currentCategory: CategoryItem | null;
+    categoryNodes: NodeTypeItem[];
+    searchResults: NodeTypeItem[];
+    searchText: string;
+    isRealTriggerMode: boolean;
+    workflowId?: string;
+}
+/**
+ * @description 汇总节点选择器的协议展示状态和列表/搜索派生参数。
+ */
+export declare function useNodeSelectorPresentation({ effectiveNodeAddInfo, isEntryTypeSelection, activeCategoryId, currentCategory, categoryNodes, searchResults, searchText, isRealTriggerMode, workflowId, }: UseNodeSelectorPresentationProps): {
+    panelTitle: string;
+    searchPlaceholder: string;
+    visibleNodes: NodeTypeItem[];
+    buildSearchParams: () => LinkSearchParams;
+    isMcpServerEntryMode: boolean;
+};
+export {};

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

@@ -5,6 +5,9 @@ import { NodeType } from '../../types/Node';
  */
 export interface NodeTypeItem {
     id: string;
+    /** 后端返回稳定标识时才允许展开/选择。 */
+    selectable?: boolean;
+    identifierSource?: string;
     type: string;
     name: string;
     description: string;
@@ -41,6 +44,12 @@ export interface NodeFetchResult {
  */
 export interface ActionItem {
     id: string;
+    /** UI 列表使用稳定 id；创建 CLASSIC 节点时必须使用后端原始 Long action_id。 */
+    backendActionId?: string;
+    action_id?: string;
+    /** 后端返回稳定标识时才允许创建节点。 */
+    selectable?: boolean;
+    identifierSource?: string;
     type: NodeType;
     action_type: NodeType;
     action_key?: string;
@@ -89,6 +98,10 @@ export interface ConnectorInfo {
  */
 export interface CategoryItem {
     id: string;
+    /** connectable 接口需要的数值分类 ID。 */
+    categoryId?: string | number;
+    /** 缺少数值分类 ID 时仍展示，但不能作为服务端筛选条件。 */
+    filterable?: boolean;
     name: string;
     description: string;
     icon?: string;
@@ -101,12 +114,14 @@ export interface CategoryItem {
  */
 export interface ApiActionItem {
     id: string;
+    backendActionId?: string;
+    action_id?: string;
     action_key?: string;
     action_ver?: number;
     is_trigger: number;
     name: string;
     description: string | null;
-    connector_id: string;
+    connector_id: string | null;
     status: number;
     protocol: string;
     config_schema: any;
@@ -134,6 +149,9 @@ export interface ModernNodeSelectorProps {
  */
 export interface LinkSearchParams {
     name?: string;
+    keyword?: string;
+    linkId?: string;
+    categoryId?: string | number;
     build_type?: string;
     deployment_type?: string;
     app_domain_category?: string;

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/utils/connectableActionLoader.d.ts

@@ -0,0 +1,16 @@
+import { QueryConnectableNodePackageDto } from '../../../api/connectable.types';
+import { ActionItem, NodeFetchResult, NodeTypeItem } from '../types';
+interface LoadConnectableNodeActionsOptions {
+    node: NodeTypeItem;
+    query: QueryConnectableNodePackageDto | null;
+    fallbackToLegacy: boolean;
+    fetchConnectablePage: (query: QueryConnectableNodePackageDto) => Promise<NodeFetchResult>;
+    fetchLegacyActions: () => Promise<ActionItem[]>;
+    filterPage?: (page: NodeFetchResult) => NodeFetchResult;
+}
+/**
+ * 加载连接器动作；connectable 查询不可用或明确未发布时回退旧 `/actions/v2`。
+ * 不能回退 `/links/search`，因为该接口在 linkId 场景不会加载 matchedActions。
+ */
+export declare function loadConnectableNodeActions({ node, query, fallbackToLegacy, fetchConnectablePage, fetchLegacyActions, filterPage, }: LoadConnectableNodeActionsOptions): Promise<ActionItem[]>;
+export {};

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/utils/connectableActionLoader.test.d.ts

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

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/utils/connectableFallback.d.ts

@@ -0,0 +1,2 @@
+/** 只有接口未发布（404）或明确未实现（501）时才允许回退 legacy 数据源。 */
+export declare function shouldFallbackConnectableRequest(error: unknown): boolean;

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/utils/connectableFallback.test.d.ts

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

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/utils/connectableQuery.d.ts

@@ -0,0 +1,40 @@
+import { QueryConnectableNodePackageDto } from '../../../api/connectable.types';
+type ConnectableNodeId = string | number;
+export type ConnectableQueryContext = {
+    mode: 'independent';
+} | {
+    mode: 'source';
+    sourceId: ConnectableNodeId;
+    sourceHandle: string;
+} | {
+    mode: 'target';
+    targetId: ConnectableNodeId;
+    targetHandle: string;
+} | {
+    mode: 'edge-insert';
+    sourceId: ConnectableNodeId;
+    sourceHandle: string;
+    targetId: ConnectableNodeId;
+    targetHandle: string;
+};
+export interface ConnectableQueryOptions {
+    scene: string;
+    trigger: boolean;
+    categoryId?: string | number | null;
+    linkId?: string | null;
+    keyword?: string | null;
+    page?: number | null;
+    size?: number | null;
+}
+/**
+ * 校验后端 Long 节点 ID，并保持字符串原值以避免 19 位雪花 ID 精度丢失。
+ * number 只接受 JS 安全正整数；临时 ReactFlow id 返回 undefined。
+ */
+export declare const parsePersistedNodeId: (value: ConnectableNodeId) => string | number | undefined;
+/**
+ * 将节点新增上下文转换为后端三种合法查询之一。
+ *
+ * `edge-insert` 暂按 source 查询，原 target 由调用方保留并在本地求交。
+ */
+export declare const buildConnectableQuery: (context: ConnectableQueryContext, options: ConnectableQueryOptions) => QueryConnectableNodePackageDto | null;
+export {};

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/utils/connectableQuery.test.d.ts

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