@digitalsee-ai/rcs 1.0.16 → 1.1.1

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;
@@ -23,7 +26,7 @@ export interface NodeTypeItem {
     defaultExpanded?: boolean;
     matchType?: 'CONNECTOR_ONL' | 'CONNECTOR_ONLY' | 'ACTION_ONLY' | 'BOTH_MATCHED' | 'BOTH' | string;
     connector?: ConnectorInfo;
-    /** DIP 节点版本号（Next 模式使用） */
+    /** 新版 NodeSchema 版本号；CLASSIC nodepackage 兼容链路也会使用 */
     nodeVersion?: number;
 }
 /**
@@ -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;
@@ -54,11 +63,11 @@ export interface ActionItem {
     connector_name: string;
     config_schema?: any;
     node_schema?: DipNodeSchema;
-    /** NEXT 兼容节点 key（Classic 模式下由 action_key 映射） */
+    /** nodepackage 节点 key；CLASSIC 模式下由 action_key 映射 */
     nodeKey?: string;
-    /** DIP 节点版本号（Next 模式使用，来自 DipNodeSummary.version） */
+    /** 新版 NodeSchema 版本号；CLASSIC nodepackage 兼容链路也会使用 */
     nodeVersion?: number;
-    /** 节点分类（Next 模式用于匹配节点配置） */
+    /** 节点分类；NEXT 暂废分支和 CLASSIC nodepackage 兼容链路都会传递 */
     category?: string;
     /** 是否为动作节点 */
     isAction?: boolean;
@@ -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;
@@ -119,11 +134,12 @@ export interface ApiActionItem {
 /**
  * 面板属性接口定义
  */
+export type CategoryRequestType = 'trigger' | 'action' | 'tool' | 'mcp' | 'mcp_trigger' | 'model' | 'memory';
 export interface ModernNodeSelectorProps {
     availableCategories?: CategoryItem[];
     initialCategory?: string;
     onSearch?: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
-    onFetchCategories?: (type?: 'trigger' | 'action' | 'tool' | 'mcp' | 'model' | 'memory') => Promise<CategoryItem[]>;
+    onFetchCategories?: (type?: CategoryRequestType) => Promise<CategoryItem[]>;
     onFetchNodesByCategory?: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
     onFetchSubCategories?: (categoryId: string) => Promise<CategoryItem[]>;
     restrictToCategory?: string;
@@ -133,9 +149,13 @@ 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;
+    action_type?: string;
     page?: number;
     size?: number;
     type?: 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 {};

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

@@ -0,0 +1,35 @@
+import { ApiActionItem, ConnectorInfo } from '../types';
+export interface NormalizedConnectableCategory {
+    /** 面板稳定 key；有 categoryId 时与 categoryId 一致。 */
+    id: string;
+    /** 后端分类筛选参数；缺失时该分类只能展示，不能用于过滤。 */
+    categoryId?: string | number;
+    name: string;
+    description: string;
+    icon?: string;
+    searchAction: boolean;
+    filterable: boolean;
+}
+export interface NormalizedConnectableConnector extends ConnectorInfo {
+    selectable: boolean;
+    identifierSource?: string;
+}
+export interface NormalizedConnectableAction extends ApiActionItem {
+    selectable: boolean;
+    identifierSource?: string;
+}
+export interface NormalizedConnectablePluginItem {
+    connector: NormalizedConnectableConnector;
+    matched_actions: NormalizedConnectableAction[];
+    default_expanded: boolean;
+    match_type?: string;
+}
+export interface NormalizedConnectablePluginPage {
+    items: NormalizedConnectablePluginItem[];
+    total: number;
+    size: number;
+    page: number;
+    pages: number;
+}
+export declare const normalizeConnectableCategories: (response: unknown) => NormalizedConnectableCategory[];
+export declare const normalizeConnectablePluginPage: (response: unknown) => NormalizedConnectablePluginPage;

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

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

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

@@ -1,7 +1,18 @@
-import { ActionItem, ApiActionItem, ConnectorInfo, LinkSearchParams, NodeFetchResult } from '../types';
+import { ActionItem, ApiActionItem, CategoryItem, CategoryRequestType, ConnectorInfo, LinkSearchParams, NodeFetchResult } from '../types';
+import { QueryConnectableNodePackageDto } from '../../../api/connectable.types';
 export declare const transformAction: (action: ApiActionItem, connector: ConnectorInfo) => ActionItem;
+/**
+ * 将 connectable 分类响应转换成现有面板模型。
+ */
+export declare const transformConnectableCategoriesResponse: (response: unknown) => CategoryItem[];
+/**
+ * 将 connectable 节点包分页响应转换成现有面板模型。
+ */
+export declare const transformConnectablePluginResponse: (response: unknown) => NodeFetchResult;
+export declare const fetchConnectableCategories: (query: QueryConnectableNodePackageDto) => Promise<CategoryItem[]>;
+export declare const fetchConnectableNodes: (query: QueryConnectableNodePackageDto) => Promise<NodeFetchResult>;
 export declare const fetchNodesByCategory: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
-export declare const fetchCategories: (type?: "trigger" | "action" | "tool" | "mcp" | "model" | "memory") => Promise<import('../types').CategoryItem[] | {
+export declare const fetchCategories: (type?: CategoryRequestType) => Promise<CategoryItem[] | {
     id: any;
     name: any;
     description: any;

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

@@ -0,0 +1,62 @@
+import { DipNodeSchema } from '../../../api/dip';
+import { ActionItem, NodeFetchResult } from '../types';
+import { PortConnectionEdge, PortConnectionNode } from '../../../utils/portConnectionValidator';
+import { Edge, Node } from '@xyflow/react';
+type SourceSchema = Pick<DipNodeSchema, 'outputs'>;
+type TargetSchema = Pick<DipNodeSchema, 'inputs'>;
+/** 边中插入候选动作执行双侧本地校验所需的稳定上下文。 */
+export interface EdgeInsertActionFilterContext {
+    sourceNode: PortConnectionNode;
+    targetNode: PortConnectionNode;
+    sourceSchema: SourceSchema;
+    targetSchema: TargetSchema;
+    sourceHandle: string;
+    targetHandle: string;
+    edges?: readonly PortConnectionEdge[];
+    replacedEdgeId?: string;
+}
+export interface EdgeInsertActionFilterStats {
+    contextReady: boolean;
+    serverActionCount: number;
+    compatibleActionCount: number;
+    filteredActionCount: number;
+    sourceCompatibleActionCount: number;
+    targetCompatibleActionCount: number;
+    missingActionSchemaCount: number;
+}
+export interface EdgeInsertActionFilterResult {
+    actions: ActionItem[];
+    stats: EdgeInsertActionFilterStats;
+}
+export interface EdgeInsertEndpointContext {
+    sourceId: string | number;
+    targetId: string | number;
+    sourceHandle: string;
+    targetHandle: string;
+}
+export type EdgeInsertActionFilterContextResolutionCode = 'READY' | 'SOURCE_NODE_NOT_FOUND' | 'TARGET_NODE_NOT_FOUND' | 'SOURCE_SCHEMA_NOT_READY' | 'TARGET_SCHEMA_NOT_READY';
+export interface EdgeInsertActionFilterContextResolution {
+    code: EdgeInsertActionFilterContextResolutionCode;
+    context: EdgeInsertActionFilterContext | null;
+}
+export interface ResolveEdgeInsertActionFilterContextInput {
+    edgeContext: EdgeInsertEndpointContext;
+    nodes: readonly Node[];
+    edges: readonly Edge[];
+    replacedEdgeId?: string;
+}
+/**
+ * 对边中插入动作执行 source→candidate 与 candidate→target 的本地求交。
+ *
+ * 后端明确禁止同时携带 source/target 端点，因此 target 侧使用动作响应中的完整
+ * NodeSchema 在前端二次过滤。
+ */
+export declare function filterEdgeInsertActions(actions: readonly ActionItem[], context: EdgeInsertActionFilterContext | null): EdgeInsertActionFilterResult;
+/** 从当前 ReactFlow 快照解析候选过滤所需的原边两端。 */
+export declare function resolveEdgeInsertActionFilterContext({ edgeContext, nodes, edges, replacedEdgeId, }: ResolveEdgeInsertActionFilterContextInput): EdgeInsertActionFilterContextResolution;
+/** 对 connectable 连接器分页中的所有 matchedActions 执行双侧求交并汇总统计。 */
+export declare function filterEdgeInsertNodePage(page: NodeFetchResult, context: EdgeInsertActionFilterContext | null): {
+    page: NodeFetchResult;
+    stats: EdgeInsertActionFilterStats;
+};
+export {};

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

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

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

@@ -0,0 +1,26 @@
+import { ConnectableQueryContext } from './connectableQuery';
+interface EdgeInsertInfo {
+    source?: string | number;
+    target?: string | number;
+    sourceHandle?: string | null;
+    sourceHandleId?: string | null;
+    targetHandle?: string | null;
+    targetHandleId?: string | null;
+}
+export interface NodeAddContextInput {
+    sourceNodeId?: string;
+    sourceHandle?: string;
+    targetNodeId?: string;
+    targetHandle?: string;
+    edge?: EdgeInsertInfo | null;
+    position?: {
+        x: number;
+        y: number;
+    };
+    trigger?: boolean;
+}
+/**
+ * 将画布面板上下文收敛为 connectable 查询的四种前端模式。
+ */
+export declare const resolveConnectableQueryContext: (info: NodeAddContextInput | null | undefined) => ConnectableQueryContext | null;
+export {};

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

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

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

@@ -0,0 +1,18 @@
+import { NodeProtocol } from '../../../types/NodeProtocol';
+interface CanvasContextNode {
+    data?: {
+        __isMcpServerCanvas?: unknown;
+    };
+}
+interface ResolveNodeSelectorProtocolParams {
+    protocol?: string;
+    sourceNode?: CanvasContextNode | null;
+    targetNode?: CanvasContextNode | null;
+}
+/**
+ * Resolve the protocol used by node-catalog requests without changing the
+ * selector's entry mode. MCP execution-node selectors have no entry protocol,
+ * so they fall back to the canvas marker carried by their source/target node.
+ */
+export declare const resolveNodeSelectorProtocol: ({ protocol, sourceNode, targetNode, }: ResolveNodeSelectorProtocolParams) => NodeProtocol.AI_LANGUAGE_MODEL | NodeProtocol.AI_MEMORY | NodeProtocol.MCP | NodeProtocol.MCP_SERVER;
+export {};

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

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

package/dist/components/digitalsee/workflow/Panels/SimpleNodeSelectorPanel/index.d.ts

@@ -1,9 +1,10 @@
 import { default as React } from 'react';
 /**
- * 简化版节点选择面板（DIP Next 模式专用）
+ * 简化版节点选择面板（暂废的 DIP Next 模式专用）
  *
  * 仅依赖 GET /dip/api/nodes 获取全部节点列表
  * 支持客户端搜索和按 pluginId 分组显示
+ * 当前 nodepackage 节点仍通过 Classic 的 ModernNodeSelectorPanel 获取 ACM actions。
  */
 declare const SimpleNodeSelectorPanel: React.FC;
 export default SimpleNodeSelectorPanel;

package/dist/components/digitalsee/workflow/api/connectable.test.d.ts

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

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

@@ -0,0 +1,75 @@
+/**
+ * ACM 的 Long ID 在 JSON 响应中序列化为字符串，19 位雪花 ID 不能转成 JS number。
+ * 请求侧保留字符串可避免精度损失；Jackson 可将纯数字字符串反序列化为 Long。
+ */
+export type ConnectablePersistedNodeId = string | number;
+/**
+ * 可连线节点包查询的公共筛选条件。
+ *
+ * `mode` 是前端判别字段，API 方法发送请求前会将它移除。
+ */
+export interface ConnectableNodePackageQueryBase {
+    scene: string;
+    trigger: boolean;
+    categoryId?: ConnectablePersistedNodeId;
+    linkId?: string;
+    keyword?: string;
+    page?: number;
+    size?: number;
+}
+export interface IndependentConnectableNodePackageQuery extends ConnectableNodePackageQueryBase {
+    mode: 'independent';
+    sourceId?: never;
+    sourceHandle?: never;
+    targetId?: never;
+    targetHandle?: never;
+}
+export interface SourceConnectableNodePackageQuery extends ConnectableNodePackageQueryBase {
+    mode: 'source';
+    sourceId: ConnectablePersistedNodeId;
+    sourceHandle: string;
+    targetId?: never;
+    targetHandle?: never;
+}
+export interface TargetConnectableNodePackageQuery extends ConnectableNodePackageQueryBase {
+    mode: 'target';
+    targetId: ConnectablePersistedNodeId;
+    targetHandle: string;
+    sourceId?: never;
+    sourceHandle?: never;
+}
+/**
+ * 前端使用的强类型 QueryConnectableNodePackageDto。
+ *
+ * 判别联合在编译期排除 source/target 半组参数以及两组参数同时出现的情况。
+ */
+export type QueryConnectableNodePackageDto = IndependentConnectableNodePackageQuery | SourceConnectableNodePackageQuery | TargetConnectableNodePackageQuery;
+interface ConnectableNodePackageRequestBase {
+    scene: string;
+    trigger: boolean;
+    category_id?: ConnectablePersistedNodeId;
+    link_id?: string;
+    keyword?: string;
+    page?: number;
+    size?: number;
+}
+/** 实际发送给 ACM SNAKE_CASE ObjectMapper 的 wire DTO。 */
+export type QueryConnectableNodePackageRequestBody = (ConnectableNodePackageRequestBase & {
+    source_id?: never;
+    source_handle?: never;
+    target_id?: never;
+    target_handle?: never;
+}) | (ConnectableNodePackageRequestBase & {
+    source_id: ConnectablePersistedNodeId;
+    source_handle: string;
+    target_id?: never;
+    target_handle?: never;
+}) | (ConnectableNodePackageRequestBase & {
+    target_id: ConnectablePersistedNodeId;
+    target_handle: string;
+    source_id?: never;
+    source_handle?: never;
+});
+/** 移除只在前端使用的判别字段，避免污染后端请求体。 */
+export declare const toConnectableNodePackageRequestBody: (query: QueryConnectableNodePackageDto) => QueryConnectableNodePackageRequestBody;
+export {};

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

@@ -300,10 +300,10 @@ export interface DipWorkflowDefinition {
  * | `SELECT` | 下拉选择 | Select |
  * | `DATETIME` | 日期时间 | DatePicker |
  * | `OBJECT` | 嵌套对象 | 递归渲染子字段 |
- * | `ARRAY` | 数组/列表 | 动态增减表单项 |
+ * | `ARRAY` / `DYNAMIC_ARRAY` | 数组/列表 | 动态增减表单项 |
  * | `KEYVALUE` | 键值对列表 | Key-Value 编辑器 |
  */
-export type DipFieldType = 'STRING' | 'TEXTAREA' | 'PASSWORD' | 'HIDDEN' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATETIME' | 'OBJECT' | 'ARRAY' | 'KEYVALUE';
+export type DipFieldType = 'STRING' | 'TEXTAREA' | 'PASSWORD' | 'HIDDEN' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATETIME' | 'OBJECT' | 'ARRAY' | 'DYNAMIC_ARRAY' | 'KEYVALUE';
 /**
  * 数组元素类型
  *
@@ -381,8 +381,12 @@ export interface DipFieldValidation {
     pattern?: string;
     /** 最小字符长度（STRING / TEXTAREA 类型） */
     minLength?: number;
+    /** 最小字符长度（后端 snake_case 字段） */
+    min_length?: number;
     /** 最大字符长度（STRING / TEXTAREA 类型） */
     maxLength?: number;
+    /** 最大字符长度（后端 snake_case 字段） */
+    max_length?: number;
 }
 /**
  * 字段 Schema 定义
@@ -393,7 +397,7 @@ export interface DipFieldValidation {
  *
  * 不同 {@link DipFieldType} 使用不同的可选字段：
  * - `SELECT` → `options`
- * - `ARRAY` → `item_type`, `item_schema`, `item_label`, `min_items`, `max_items`
+ * - `ARRAY` / `DYNAMIC_ARRAY` → `item_type`, `item_schema`, `item_label`, `min_items`, `max_items`
  * - `OBJECT` → `properties`
  * - `KEYVALUE` → `key_placeholder`, `value_placeholder`
  * - `DATETIME` → `picker_mode`
@@ -419,7 +423,7 @@ export interface DipFieldSchema {
     example?: string;
     /** 下拉选项列表（仅 type 为 SELECT 时使用） */
     options?: DipSelectOption[];
-    /** 数组元素类型（仅 type 为 ARRAY 时使用） */
+    /** 数组元素类型（仅 type 为 ARRAY / DYNAMIC_ARRAY 时使用） */
     item_type?: DipItemType;
     /** 数组元素为 OBJECT 时的子字段 Schema（递归定义） */
     item_schema?: DipFieldSchema[];
@@ -461,6 +465,36 @@ export interface DipPortSchema {
     name: string;
     /** UI 显示名称，如 "输入"、"True 分支"、"默认输出" */
     displayName?: string;
+    /** ACM SNAKE_CASE 传输字段；消费前由 normalizePortSchema 归一化 */
+    display_name?: string;
+    /**
+     * 端口连接能力类型，缺失或空字符串时按 `main` 处理。
+     *
+     * 常见值：`main`、`trigger`、`control`、`ai_model`、`ai_tool`、`ai_memory`。
+     */
+    type?: string;
+    /** 输入端口是否必须存在至少一条连线 */
+    required?: boolean;
+    /** 端口允许的最大连线数，`null` 或缺失表示不限制 */
+    maxConnections?: number | null;
+    /** ACM SNAKE_CASE 传输字段 */
+    max_connections?: number | null;
+    /** 输入端口允许连接的源节点 schema key 白名单，空列表表示不限制 */
+    allowedSourceNodeKeys?: string[];
+    /** ACM SNAKE_CASE 传输字段 */
+    allowed_source_node_keys?: string[];
+    /** 输出端口允许连接的目标节点 schema key 白名单，空列表表示不限制 */
+    allowedTargetNodeKeys?: string[];
+    /** ACM SNAKE_CASE 传输字段 */
+    allowed_target_node_keys?: string[];
+    /** 输入端口禁止连接的源节点 schema key 黑名单 */
+    deniedSourceNodeKeys?: string[];
+    /** ACM SNAKE_CASE 传输字段 */
+    denied_source_node_keys?: string[];
+    /** 输出端口禁止连接的目标节点 schema key 黑名单 */
+    deniedTargetNodeKeys?: string[];
+    /** ACM SNAKE_CASE 传输字段 */
+    denied_target_node_keys?: string[];
 }
 /**
  * 节点输出字段 Schema

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

@@ -1,6 +1,8 @@
+import { QueryConnectableNodePackageDto } from './connectable.types';
 import { DipNodeSchema } from './dip.types';
 import { LinkSearchParams, LinkSearchResponse } from '../Panels/ModernNodeSelectorPanel/types';
 import { AxiosRequestConfig } from 'axios';
+export type { ConnectableNodePackageQueryBase, ConnectablePersistedNodeId, IndependentConnectableNodePackageQuery, QueryConnectableNodePackageDto, QueryConnectableNodePackageRequestBody, SourceConnectableNodePackageQuery, TargetConnectableNodePackageQuery, } from './connectable.types';
 export interface WorkflowRequestOptions {
     method?: AxiosRequestConfig['method'];
     headers?: Record<string, string>;
@@ -13,6 +15,8 @@ export interface WorkflowApiEndpoints {
     nodeCategory: string;
     nodesList: string;
     searchLinks: string;
+    connectableNodePackageCategories: string;
+    connectableNodePackagePlugins: string;
     actions: string;
     actionNodeSchema: string;
     createNode: string;
@@ -78,13 +82,19 @@ export declare function apiGetNodesList(params: {
     name?: string;
 }): Promise<unknown>;
 export declare function apiSearchLinks(params: LinkSearchParams): Promise<LinkSearchResponse>;
+export declare function apiQueryConnectableNodePackageCategories(query: QueryConnectableNodePackageDto): Promise<unknown>;
+export declare function apiQueryConnectableNodePackagePlugins(query: QueryConnectableNodePackageDto): Promise<unknown>;
 export declare const apiGetActions: (params: {
     linkId?: string;
     name?: string;
     actionType?: string;
+    action_type?: string;
     trigger?: boolean;
     protocol?: string;
-    flowId: string;
+    page?: number;
+    size?: number;
+    flow_id?: string;
+    flowId?: string;
 }) => Promise<any>;
 export declare const apiGetActionNodeSchema: (nodeKey: string, version: number) => Promise<DipNodeSchema>;
 export declare function apiCreateNode(data: any): Promise<unknown>;
@@ -195,4 +205,3 @@ export declare function onlineFlow(id: any): Promise<unknown>;
 export declare const apiGetAccountInstanceV2: (linkId?: string | null, actionAccountSchemaId?: string | number) => Promise<unknown>;
 export declare const getAppList: (params: any, formData?: any) => Promise<unknown>;
 export declare const fetchSubFlowList: (name: any, formData?: any) => Promise<unknown>;
-export {};

package/dist/components/digitalsee/workflow/config/defaultCanvasEngineConfig.test.d.ts

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

package/dist/components/digitalsee/workflow/config/defaultNodeSelectorConfig.d.ts

@@ -0,0 +1,9 @@
+/** 未显式接入的宿主默认关闭可连线节点包能力。 */
+export declare const defaultNodeSelectorConfig: {
+    readonly connectable: {
+        readonly enabled: false;
+        readonly scene: "normal";
+        readonly fallbackToLegacy: true;
+        readonly debug: false;
+    };
+};

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

@@ -3,11 +3,14 @@
  */
 /**
  * 引擎模式
+ *
+ * 当前 AI 连接流主路径是 CLASSIC。日常描述里的“新版节点”通常指
+ * CLASSIC 模式兼容渲染新版 NodeSchema 的 nodepackage 节点，不是 NEXT 模式。
  */
 export declare enum EngineMode {
-    /** 经典模式，使用 ACM 后端 */
+    /** 经典模式，使用 ACM 后端；同时承载 nodepackage 节点的新版 schema 兼容渲染 */
     CLASSIC = "classic",
-    /** Next 模式，使用 DIP 后端 + DynamicForm */
+    /** Next 模式，使用 DIP 后端 + DynamicForm；当前为暂废保留分支 */
     NEXT = "next"
 }
 /**

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

@@ -19,6 +19,8 @@ export declare enum NodeType {
     SELF_LOOP = "SelfLoopNode",
     /** MCP服务节点 */
     MCPServer = "MCPServerNode",
+    /** MCP网关触发节点 */
+    MCP_TRIGGER_NODE = "MCP_TRIGGER_NODE",
     /** 内置MCP节点 */
     BuiltinMCP = "BuiltinMCPNode",
     /** 向量存储节点 */
@@ -31,6 +33,8 @@ export declare enum NodeType {
     AI_SUB_NODE = "AISubNode",
     /** MCP工具节点 */
     MCP_TOOL = "MCPToolNode",
+    /** MCP网关工具列表节点 */
+    MCP_TOOLS_NODE = "MCP_TOOLS_NODE",
     /** 多分支节点 */
     SWITCH = "SwitchNode",
     /** 便签节点 */