@digitalsee-ai/rcs 1.1.2 → 1.1.4

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

@@ -1,15 +1,17 @@
 import { CategoryItem, LinkSearchParams, NodeFetchResult, NodeTypeItem } from '../types';
-import { NodeAddInfo } from '../../../store/panelSlice';
+import { NodeAddInfo } from '../../../types/NodeAddContext';
 interface UseNavigationProps {
     categories: CategoryItem[];
+    categoriesReady: boolean;
     initialCategory?: string;
     nodeSelectorVisible: boolean;
     nodeAddInfo?: NodeAddInfo | null;
     onFetchNodesByCategory: (params?: LinkSearchParams) => Promise<NodeFetchResult>;
     defaultPageSize?: number;
     flowId?: string;
+    useConnectableDataSource?: boolean;
 }
-export declare const useNavigation: ({ categories, initialCategory, nodeSelectorVisible, nodeAddInfo, onFetchNodesByCategory, defaultPageSize, flowId, }: UseNavigationProps) => {
+export declare const useNavigation: ({ categories, categoriesReady, initialCategory, nodeSelectorVisible, nodeAddInfo, onFetchNodesByCategory, defaultPageSize, flowId, useConnectableDataSource, }: 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,25 @@
+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;
+    useConnectableDataSource?: boolean;
+}
+/**
+ * @description 汇总节点选择器的协议展示状态和列表/搜索派生参数。
+ */
+export declare function useNodeSelectorPresentation({ effectiveNodeAddInfo, isEntryTypeSelection, activeCategoryId, currentCategory, categoryNodes, searchResults, searchText, isRealTriggerMode, workflowId, useConnectableDataSource, }: UseNodeSelectorPresentationProps): {
+    panelTitle: string;
+    searchPlaceholder: string;
+    visibleNodes: NodeTypeItem[];
+    buildSearchParams: () => LinkSearchParams;
+    isMcpServerEntryMode: boolean;
+};
+export {};

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

@@ -0,0 +1 @@
+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 接口需要的后端原始分类 name。 */
+    categoryName?: string;
+    /** 缺少后端原始 name 时仍展示，但不能作为服务端筛选条件。 */
+    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;
+    categoryName?: string;
     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/connectableDataSource.d.ts

@@ -0,0 +1,15 @@
+import { EntryMode } from '../components/EntryTypeSelector';
+import { NodeAddInfo } from '../../../types/NodeAddContext';
+interface ConnectableDataSourceInput {
+    enabled: boolean;
+    hasContext: boolean;
+    entryMode: EntryMode;
+    protocol?: string | null;
+}
+/** 将初始化入口选择转换为实际查询上下文；MCP Server 仍属于触发节点。 */
+export declare function resolveNodeSelectorEntryContext(nodeAddInfo: NodeAddInfo | null | undefined, entryMode: EntryMode): NodeAddInfo | null | undefined;
+/** 初始化 MCP Server 入口是唯一允许携带 protocol 使用 connectable 接口的特殊入口。 */
+export declare function shouldUseConnectableDataSource({ enabled, hasContext, entryMode, protocol, }: ConnectableDataSourceInput): boolean;
+/** MCP Server 初始化入口固定查询 mcp 场景，其他入口沿用宿主配置。 */
+export declare function resolveConnectableRequestScene(configuredScene: string, entryMode: EntryMode): string;
+export {};

package/dist/components/digitalsee/workflow/Panels/ModernNodeSelectorPanel/utils/connectableDataSource.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;
+    categoryName?: string | 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；有 categoryName 时与后端原始 name 一致。 */
+    id: string;
+    /** 后端 category_name 筛选参数；缺失时该分类只能展示，不能用于过滤。 */
+    categoryName?: string;
+    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, CategoryRequestType, ConnectorInfo, LinkSearchParams, NodeFetchResult } from '../types';
+import { QueryConnectableNodePackageDto } from '../../../api/connectable.types';
+import { ActionItem, ApiActionItem, CategoryItem, CategoryRequestType, ConnectorInfo, LinkSearchParams, NodeFetchResult } from '../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?: CategoryRequestType) => 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/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;
+    categoryName?: string;
+    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_name?: string;
+    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

@@ -299,11 +299,13 @@ export interface DipWorkflowDefinition {
  * | `BOOLEAN` | 布尔开关 | Switch |
  * | `SELECT` | 下拉选择 | Select |
  * | `DATETIME` | 日期时间 | DatePicker |
+ * | `CODE` | 代码/JSON 文本 | 工作流代码编辑器 |
+ * | `PROXY` | 代理网关 | 工作流代理网关选择器 |
  * | `OBJECT` | 嵌套对象 | 递归渲染子字段 |
  * | `ARRAY` / `DYNAMIC_ARRAY` | 数组/列表 | 动态增减表单项 |
  * | `KEYVALUE` | 键值对列表 | Key-Value 编辑器 |
  */
-export type DipFieldType = 'STRING' | 'TEXTAREA' | 'PASSWORD' | 'HIDDEN' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATETIME' | 'OBJECT' | 'ARRAY' | 'DYNAMIC_ARRAY' | 'KEYVALUE';
+export type DipFieldType = 'STRING' | 'TEXTAREA' | 'PASSWORD' | 'HIDDEN' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATETIME' | 'CODE' | 'PROXY' | 'OBJECT' | 'ARRAY' | 'DYNAMIC_ARRAY' | 'KEYVALUE';
 /**
  * 数组元素类型
  *
@@ -322,6 +324,14 @@ export type DipItemType = 'STRING' | 'NUMBER' | 'BOOLEAN' | 'OBJECT';
  * - `'DATETIME'` — 同时选择日期和时间
  */
 export type DipPickerMode = 'DATE' | 'TIME' | 'DATETIME';
+/**
+ * 字段值输入策略
+ *
+ * - `'TEXT'` — 仅文本模式
+ * - `'EXPRESSION'` — 仅表达式模式
+ * - `'BOTH'` — 文本和表达式模式均可用
+ */
+export type DipValueModePolicy = 'TEXT' | 'EXPRESSION' | 'BOTH';
 /**
  * 下拉选项
  *
@@ -443,8 +453,8 @@ export interface DipFieldSchema {
     picker_mode?: DipPickerMode;
     /** 条件显示规则，满足条件时字段才可见 */
     visible_when?: VisibleWhen;
-    /** 是否支持变量插值（如 `{{node1.output.field}}`） */
-    supports_variables?: boolean;
+    /** 文本/表达式输入策略（后端 snake_case 字段） */
+    value_mode_policy?: DipValueModePolicy;
     /** 字段值校验规则 */
     validation?: DipFieldValidation;
 }
@@ -465,6 +475,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,9 @@
+import { QueryConnectableNodePackageDto } from './connectable.types';
 import { DipNodeSchema } from './dip.types';
 import { LinkSearchParams, LinkSearchResponse } from '../Panels/ModernNodeSelectorPanel/types';
+import { FlowDraftPayload, FlowVersionDetailVO, FlowVersionPage, FlowVersionPublishRequest, FlowVersionStatusVO, FlowVersionVO } from '../types/flowVersion';
 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 +16,8 @@ export interface WorkflowApiEndpoints {
     nodeCategory: string;
     nodesList: string;
     searchLinks: string;
+    connectableNodePackageCategories: string;
+    connectableNodePackagePlugins: string;
     actions: string;
     actionNodeSchema: string;
     createNode: string;
@@ -59,6 +64,12 @@ export interface WorkflowApiEndpoints {
     templateTagRelation: string;
     getAppList: string;
     subFlowList: string;
+    flowVersionPublish: string;
+    flowVersionList: string;
+    flowVersionDetail: string;
+    flowVersionRollback: string;
+    flowVersionLoadDraft: string;
+    flowVersionStatus: string;
 }
 export interface WorkflowApiConfig {
     endpoints: WorkflowApiEndpoints;
@@ -78,6 +89,8 @@ 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;
@@ -196,7 +209,21 @@ export declare function apiRemoveEdges(flowId: string, edges: string[]): Promise
 export declare function apiGetSelectOptions(type: string): Promise<unknown>;
 export declare function updateFlowOpStatus(paramsId: any, opStatus: any): Promise<unknown>;
 export declare function onlineFlow(id: any): Promise<unknown>;
+/** 发布当前草稿为新的生效版本。 */
+export declare function apiPublishFlowVersion(flowId: string, data: FlowVersionPublishRequest): Promise<FlowVersionVO>;
+/** 查询发布版本历史。 */
+export declare function apiGetFlowVersions(flowId: string, params?: {
+    page: number;
+    size: number;
+}): Promise<FlowVersionPage>;
+/** 查询历史版本详情。 */
+export declare function apiGetFlowVersionDetail(flowId: string, versionFlowId: string): Promise<FlowVersionDetailVO>;
+/** 将线上生效版本切换到指定历史版本。 */
+export declare function apiRollbackFlowVersion(flowId: string, versionFlowId: string): Promise<FlowVersionVO>;
+/** 使用指定历史版本覆盖唯一草稿。 */
+export declare function apiLoadFlowVersionAsDraft(flowId: string, versionFlowId: string): Promise<FlowDraftPayload>;
+/** 查询草稿与线上生效版本的关系。 */
+export declare function apiGetFlowVersionStatus(flowId: string): Promise<FlowVersionStatusVO>;
 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/events/eventBus.d.ts

@@ -1,16 +1,6 @@
 import { NodeTypeItem } from '../Panels/ModernNodeSelectorPanel/types';
-export interface NodeAddInfo {
-    sourceNodeId?: string;
-    sourceHandle?: string;
-    targetNodeId?: string;
-    targetHandle?: string;
-    position: {
-        x: number;
-        y: number;
-    };
-    trigger?: boolean;
-    edge?: any;
-}
+import { NodeAddInfo } from '../types/NodeAddContext';
+export type { NodeAddInfo } from '../types/NodeAddContext';
 export type NodeAddEvent = {
     info: NodeAddInfo;
     nodeType: NodeTypeItem;