@digitalsee-ai/rcs 1.1.7 → 1.1.8

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

@@ -2,6 +2,7 @@ import { NodeAddInfo } from '../types/NodeAddContext';
 import { Node } from '@xyflow/react';
 interface HandleExtenderVisibilityOptions {
     type: 'source' | 'target';
+    handleId?: string;
     isFull: boolean;
     connectionInProgress: boolean;
     canEdit: boolean;
@@ -9,8 +10,8 @@ interface HandleExtenderVisibilityOptions {
 /**
  * 判断连接桩是否展示快捷新增入口。
  *
- * 画布连线始终由 output/source 发起，input/target 只接收连线，
- * 因此快捷新增入口只允许展示在输出桩。连接数达到上限时隐藏入口。
+ * 默认仅输出桩展示；旧版 AI 孤独入桩（ai_model/ai_memory/ai_tool）虽是 target，
+ * 仍需要半线入口以便按 target_id/target_handle 查询可连接节点。
  */
 export declare function shouldShowHandleExtender(options: HandleExtenderVisibilityOptions): boolean;
 /** output 只能发起连线，input 只能接收连线；空间布局不改变端口语义。 */
@@ -30,6 +31,11 @@ interface BuildHandleNodeAddInfoOptions {
     anchorNode?: Node;
     refresh: boolean;
 }
-/** 构造连接桩快捷新增上下文，避免输入桩误带 source/protocol 语义。 */
+/**
+ * 构造连接桩快捷新增上下文。
+ *
+ * AI 孤独入桩走 target 半组（不带 protocol），以便 connectable 接口使用
+ * target_id/target_handle；其余 source 桩保留 protocol 专项入口语义。
+ */
 export declare function buildHandleNodeAddInfo(options: BuildHandleNodeAddInfoOptions): NodeAddInfo;
 export {};

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

@@ -1,7 +1,7 @@
 import { NodeProps } from '@xyflow/react';
 import { default as React } from 'react';
 /**
- * @description AI 子节点，渲染垂直布局下的 300×72px 卡片样式。
+ * @description AI 子节点，顶部 SOURCE 连入父节点的 ai_* 孤独入桩。
  * @param {NodeProps} props React Flow 传入的节点参数。
  * @returns {JSX.Element} 渲染后的节点。
  */

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

@@ -1,8 +1,8 @@
+import { NodeData } from '../types/Node';
 import { Node, NodeProps } from '@xyflow/react';
 import { default as React } from 'react';
-import { NodeData } from '../types/Node';
 /**
- * @description Agent 节点，包含底部三个菱形子插槽与主输出。
+ * @description Agent 节点，包含底部三个孤独 AI 入桩与主输出。
  * @param {NodeProps<NodeData>} props React Flow 代理节点参数。
  * @returns {JSX.Element} 渲染后的 Agent 节点。
  */

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

@@ -1,8 +1,8 @@
+import { NodeData } from '../types/Node';
 import { Node, NodeProps } from '@xyflow/react';
 import { default as React } from 'react';
-import { NodeData } from '../types/Node';
 /**
- * @description 浏览器节点，提供模型接入与右侧主输出的卡片布局。
+ * @description 浏览器节点，提供底部模型孤独入桩与右侧主输出。
  * @param {NodeProps<NodeData>} props React Flow 浏览器节点参数。
  * @returns {JSX.Element} 渲染后的浏览器节点。
  */

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

@@ -14,13 +14,22 @@ export declare enum HandleType {
 export declare enum HandleConnectionType {
     INPUT = "input",
     OUTPUT = "output",
+    /** @deprecated 旧版 Agent/Browser SOURCE 半线，加载时升级为 AI_MODEL */
     CHAT_MODEL = "chat_model",
     DONE = "done",
     LOOP = "loop",
     FALSE = "false",
     TRUE = "true",
+    /** @deprecated 旧版 Agent SOURCE 半线，加载时升级为 AI_MEMORY */
     MEMORY = "memory",
+    /** @deprecated 旧版 Agent SOURCE 半线，加载时升级为 AI_TOOL */
     TOOLS = "tools",
+    /** 高级 AI / 浏览器节点底部模型入桩（孤独 target） */
+    AI_MODEL = "ai_model",
+    /** 高级 AI 节点底部记忆入桩（孤独 target） */
+    AI_MEMORY = "ai_memory",
+    /** 高级 AI 节点底部工具入桩（孤独 target） */
+    AI_TOOL = "ai_tool",
     BUILTIN_MCP = "builtin_mcp"
 }
 /**

package/dist/components/digitalsee/workflow/utils/legacyAiHandles.d.ts

@@ -0,0 +1,23 @@
+import { HandleConnectionType } from '../types/Handle';
+import { NodeProtocol } from '../types/NodeProtocol';
+import { Edge, Node } from '@xyflow/react';
+/** 旧版高级 AI / 浏览器节点底部孤独入桩（connectable 查询用 target_handle）。 */
+export declare const LEGACY_AI_LONELY_TARGET_HANDLES: readonly [HandleConnectionType.AI_MODEL, HandleConnectionType.AI_MEMORY, HandleConnectionType.AI_TOOL];
+export type LegacyAiLonelyTargetHandle = (typeof LEGACY_AI_LONELY_TARGET_HANDLES)[number];
+export declare function isLegacyAiLonelyTargetHandle(handleId?: string | null): handleId is LegacyAiLonelyTargetHandle;
+/** 将历史 chat_model/memory/tools（及已是 ai_*）映射为固定 target_handle。 */
+export declare function resolveLegacyAiLonelyTargetHandle(handleId?: string | null): LegacyAiLonelyTargetHandle | undefined;
+export declare function getProtocolForLegacyAiLonelyTargetHandle(handleId?: string | null): NodeProtocol | undefined;
+/**
+ * 校验 AI 子节点连入 Agent/Browser 孤独入桩：
+ * 由 AI 子节点 SOURCE 发起，Agent/Browser 的 ai_* TARGET 接收。
+ */
+export declare function isValidLegacyAiLonelyConnection(options: {
+    sourceProtocol?: NodeProtocol | string | null;
+    targetHandle?: string | null;
+}): boolean;
+/**
+ * 将历史「Agent SOURCE(chat_model) → AISub TARGET(input)」边升级为
+ * 「AISub SOURCE(output) → Agent TARGET(ai_model)」。
+ */
+export declare function upgradeLegacyAiCanvasEdges<T extends Pick<Edge, 'source' | 'target' | 'sourceHandle' | 'targetHandle'>>(nodes: Array<Pick<Node, 'id' | 'type'>>, edges: T[]): T[];

package/dist/components/digitalsee/workflow/utils/mcpCanvas.d.ts

@@ -34,11 +34,14 @@ export declare const resolveMcpCanvasTargetHandle: (_nodes: McpNodeIdentity[], f
 /** 保存前不得把 Schema 端口改写成视觉方向名称。 */
 export declare const normalizeMcpCanvasEdge: <T extends Pick<Edge, "targetHandle">>(_nodes: McpNodeIdentity[], edge: T) => T;
 export declare const normalizeMcpCanvasEdges: <T extends Pick<Edge, "targetHandle">>(nodes: McpNodeIdentity[], edges: T[]) => T[];
+/** 旧版 MCP 画布把视觉方向写成了 targetHandle（以及部分 NodeSchema inputs.name）。 */
+export declare const LEGACY_MCP_CANVAS_TARGET_HANDLE = "top";
+type McpCanvasEdgeNode = Pick<Node, 'id' | 'type'> & Partial<Pick<Node, 'data'>>;
 /**
- * 升级旧版 MCP 画布的虚拟方向端口。
+ * 升级旧版 MCP 画布的虚拟方向 targetHandle。
  *
- * 旧实现会在 MCP Server 画布中把 output/top 或 builtin_mcp/top 当作真实端口保存；
- * 新版必须恢复为 NodeSchema 的 main/main，下一次保存时写回正确数据。
+ * 旧实现会把 MCP Server 画布上所有边的 targetHandle 写成 `top`。
+ * MCP 网关相关节点 Schema 仍声明 top，需保留；经典 Action 等节点入桩是 input，需改回。
  */
-export declare const upgradeLegacyMcpCanvasEdges: <T extends Pick<Edge, "sourceHandle" | "targetHandle">>(nodes: McpNodeIdentity[], edges: T[]) => T[];
+export declare const upgradeLegacyMcpCanvasEdges: <T extends Pick<Edge, "source" | "target" | "sourceHandle" | "targetHandle">>(nodes: McpCanvasEdgeNode[], edges: T[]) => T[];
 export {};

package/dist/components/dynamic-form/components/ValueModeWrapper/ValueModeFieldScope.d.ts

@@ -0,0 +1,17 @@
+import { FieldDef, ValueModePolicy } from '../../types/form-schema';
+import type * as React from 'react';
+/**
+ * 将父级 valueModePolicy 注入到子字段；父级未配置时保留子字段自身策略。
+ */
+export declare function withInheritedValueModePolicy<T extends FieldDef>(child: T, parentPolicy?: ValueModePolicy): T;
+type ValueModeFieldScopeProps = {
+    policy?: ValueModePolicy;
+    disabled?: boolean;
+    readOnly?: boolean;
+    children: React.ReactNode;
+};
+/**
+ * 复杂字段第一层值模式作用域：渲染顶层切换器，抑制子级递归切换器。
+ */
+export declare const ValueModeFieldScope: React.FC<ValueModeFieldScopeProps>;
+export {};

package/dist/components/dynamic-form/components/ValueModeWrapper/ValueModePolicyContext.d.ts

@@ -0,0 +1,26 @@
+import { ValueModePolicy } from '../../types/form-schema';
+/** 与 ValueModeWrapper 保持一致的值模式 */
+export type ValueModePolicyScopeMode = 'normal' | 'expression' | 'code';
+/**
+ * 父级表单项的值模式作用域。
+ * 复杂字段（KEY_VALUE / OBJECT / ARRAY 等）在第一层挂载后，
+ * 子输入只消费 mode/policy，不再各自渲染右上角切换器。
+ */
+export type ValueModePolicyContextValue = {
+    policy: ValueModePolicy;
+    mode: ValueModePolicyScopeMode;
+    onModeChange: (mode: ValueModePolicyScopeMode) => void;
+    /** 子级 ValueModeWrapper 隐藏模式切换器 */
+    suppressNestedSwitch: true;
+};
+export declare function useValueModePolicyOptional(): ValueModePolicyContextValue | null;
+export type ValueModePolicyScopeProps = {
+    policy: ValueModePolicy;
+    mode: ValueModePolicyScopeMode;
+    onModeChange: (mode: ValueModePolicyScopeMode) => void;
+    children: React.ReactNode;
+};
+/**
+ * 在表单项第一层建立值模式作用域，向下传递 mode，抑制子级切换器。
+ */
+export declare const ValueModePolicyScope: React.FC<ValueModePolicyScopeProps>;

package/dist/components/dynamic-form/components/ValueModeWrapper/ValueModeSwitch.d.ts

@@ -0,0 +1,16 @@
+import { ValueMode } from './valueModeConfig';
+import { ValueModePolicy } from '../../types/form-schema';
+import type * as React from 'react';
+export type ValueModeSwitchProps = {
+    valueModePolicy: ValueModePolicy;
+    mode: ValueMode;
+    onModeChange?: (mode: ValueMode) => void;
+    disabled?: boolean;
+    readOnly?: boolean;
+    modeSwitchPosition?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+};
+/**
+ * 右上角模式指示/切换器。
+ * BOTH 可切换；TEXT / EXPRESSION 渲染单个选中态选项，便于肉眼识别当前输入模式。
+ */
+export declare const ValueModeSwitch: React.FC<ValueModeSwitchProps>;

package/dist/components/dynamic-form/components/ValueModeWrapper/index.d.ts

@@ -1,10 +1,11 @@
+import { ValueMode } from './valueModeConfig';
 import { ValueModePolicy } from '../../types/form-schema';
 import * as React from 'react';
-export type ValueMode = 'normal' | 'expression' | 'code';
-export declare function getValueModePolicyConfig(policy: ValueModePolicy): {
-    availableModes: ValueMode[];
-    defaultMode: ValueMode;
-};
+export { ValueModeFieldScope, withInheritedValueModePolicy, } from './ValueModeFieldScope';
+export { useValueModePolicyOptional, type ValueModePolicyContextValue, ValueModePolicyScope, type ValueModePolicyScopeProps, } from './ValueModePolicyContext';
+export { ValueModeSwitch, type ValueModeSwitchProps, } from './ValueModeSwitch';
+export type { ValueMode } from './valueModeConfig';
+export { getValueModePolicyConfig } from './valueModeConfig';
 export declare function isEncodedExpressionValue(value: unknown): value is string;
 /**
  * 将节点配置中的历史值统一转换为输入组件可消费的字符串。

package/dist/components/dynamic-form/components/ValueModeWrapper/valueModeConfig.d.ts

@@ -0,0 +1,11 @@
+import { ValueModePolicy } from '../../types/form-schema';
+export type ValueMode = 'normal' | 'expression' | 'code';
+export declare const DEFAULT_AVAILABLE_MODES: ValueMode[];
+export declare const VALUE_MODE_POLICY_CONFIG: Record<ValueModePolicy, {
+    availableModes: ValueMode[];
+    defaultMode: ValueMode;
+}>;
+export declare function getValueModePolicyConfig(policy: ValueModePolicy): {
+    availableModes: ValueMode[];
+    defaultMode: ValueMode;
+};

package/dist/components/dynamic-form/index.d.ts

@@ -1,7 +1,7 @@
 export * from './AntdProvider';
 export { AI_FILL_VALUE, AIFieldWrapper, type AIFieldWrapperProps, } from './components/AIFieldWrapper';
 export { type SelectValueMode, SelectWithExpression, type SelectWithExpressionProps, } from './components/SelectWithExpression';
-export { type ValueMode, ValueModeWrapper, type ValueModeWrapperProps, } from './components/ValueModeWrapper';
+export { useValueModePolicyOptional, type ValueMode, ValueModeFieldScope, ValueModePolicyScope, ValueModeSwitch, type ValueModeSwitchProps, ValueModeWrapper, type ValueModeWrapperProps, withInheritedValueModePolicy, } from './components/ValueModeWrapper';
 export { VariableInput, type VariableInputProps, } from './components/VariableInput';
 export { VariableTextarea, type VariableTextareaProps, } from './components/VariableTextarea';
 export { useRegisterVariableField, useVariableSelector, useVariableSelectorOptional, type VariableInfo, type VariableSelectorContextValue, VariableSelectorProvider, type VariableSelectorProviderProps, } from './context/VariableSelectorContext';