@huanban/rulego-editor-core 1.1.1 → 1.1.2

package/dist/models/BaseNodeModel.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @file BaseNodeModel.ts
+ * @description 基础节点模型，所有自定义画布节点的基础类
+ */
+import { HtmlNodeModel } from '@logicflow/core';
+/**
+ * @class BaseNodeModel
+ * @description 抽象化基础节点模型。
+ * 该模型承载了 RuleGo 算子的宽高度动态计算，
+ * 并利用 LogicFlow 原生的 rules 机制实现了严密的跨分组碰撞和连线校验逻辑。
+ */
+export declare class BaseNodeModel extends HtmlNodeModel {
+    /**
+     * 初始化并设置节点的基本属性
+     *
+     * - 动态计算算子文本所需的像素宽度
+     * - 设定最小兜底宽度，防止越界
+     */
+    setAttributes(): void;
+    /**
+     * 覆写 LogicFlow 原生的源点连线规则 (从本节点拉出的线)
+     *
+     * - 校验端点配置
+     * - 禁止跨分组连线 (外部不可连接 Group 内，Group 内不可连出)
+     *
+     * @returns {Array} 规则数组
+     */
+    getConnectedSourceRules(): import("@logicflow/core").Model.ConnectRule[];
+    /**
+     * 覆写 LogicFlow 原生的目标点连线规则 (连入本节点的线)
+     *
+     * 允许子类覆盖，如特定起始算子屏蔽被连入。
+     *
+     * @returns {Array} 规则数组
+     */
+    getConnectedTargetRules(): import("@logicflow/core").Model.ConnectRule[];
+}
+//# sourceMappingURL=BaseNodeModel.d.ts.map

package/dist/models/index.d.ts

@@ -0,0 +1,2 @@
+export { BaseNodeModel } from './BaseNodeModel';
+//# sourceMappingURL=index.d.ts.map

package/dist/nodes/AgentOrchestrationNode.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file AgentOrchestrationNode.ts
+ * @description 智能体编排节点 (Agent Orchestration Node)
+ * 继承自基础节点模型，提供了专用于 AI Agent 的特殊排程逻辑和锚点定义。
+ */
+import { BaseNodeModel } from '../models/BaseNodeModel';
+/**
+ * 智能体编排节点数据模型
+ * @class AgentOrchestrationNodeModel
+ * @extends BaseNodeModel
+ * @description
+ * 该模型针对幻伴核心的 AI 排程图引擎定制。
+ * 特别注意，除了标准的输入(左)和输出(右)锚点外，
+ * 它在底部额外定义了 4 个固定的特殊锚点 (llm, tools, memory, knowledge)。
+ * 这对于前端展示与底图追溯逻辑至关重要。
+ */
+export declare class AgentOrchestrationNodeModel extends BaseNodeModel {
+    /**
+     * 初始化节点属性
+     * 设定固定宽高，并注入特殊的锚点偏移位置 (anchorsOffset)。
+     */
+    setAttributes(): void;
+    /**
+     * 覆盖默认锚点获取逻辑
+     * @returns 返回 6 个固定的锚点定义 (包含 4 个禁止添加连线的辅助配置锚点)
+     */
+    getDefaultAnchor(): ({
+        x: number;
+        y: number;
+        type: string;
+        id: string;
+        edgeAddable?: undefined;
+    } | {
+        x: number;
+        y: number;
+        type: string;
+        id: string;
+        edgeAddable: boolean;
+    })[];
+}
+//# sourceMappingURL=AgentOrchestrationNode.d.ts.map

package/dist/nodes/GroupNode.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @file GroupNode.ts
+ * @description 分组嵌套节点 (Group Node)
+ * 允许在逻辑画布上创建可视化分组，用于包含、折叠和展开一批相关的普通节点。
+ */
+import { BaseNodeModel } from '../models/BaseNodeModel';
+/**
+ * 分组节点数据模型
+ * @class GroupNodeModel
+ * @extends BaseNodeModel
+ * @description
+ * 负责控制分组容器的状态机 (折叠/展开) 以及动态的边界盒计算。
+ * 关联子节点的唯一凭证是 `children` Set 集合。
+ */
+export declare class GroupNodeModel extends BaseNodeModel {
+    /** 标识该节点是一个组容器节点 */
+    isGroup: boolean;
+    /** 当前包含在组内的子节点 ID 集合 */
+    children: Set<string>;
+    /** 当前的折叠状态标志位 */
+    isFolded: boolean;
+    /**
+     * 初始化默认的超大宽高以作为初始分组盒
+     */
+    setAttributes(): void;
+    /**
+     * 向分组中添加子节点
+     * @param {string} nodeId - 子节点 ID
+     */
+    addChild(nodeId: string): void;
+    /**
+     * 从分组中移除指定子节点
+     * @param {string} nodeId - 欲移除的子节点 ID
+     */
+    removeChild(nodeId: string): void;
+    /**
+     * 折叠当前分组，隐藏所有子节点并将宽度缩小
+     */
+    fold(): void;
+    /**
+     * 展开当前分组，恢复显示所有子节点并重新计算外包围盒
+     */
+    unfold(): void;
+    /**
+     * 基于内部子节点的物理位置，动态更新当前 Group 的宽高与边界
+     * @private
+     */
+    private updateBounds;
+}
+//# sourceMappingURL=GroupNode.d.ts.map

package/dist/nodes/HeadlessHtmlNode.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file HeadlessHtmlNode.ts
+ * @description 无头模式渲染基类
+ */
+import { BaseNodeModel } from '../models/BaseNodeModel';
+/**
+ * @class HeadlessHtmlNodeModel
+ * @description 废弃传统 LogicFlow 内部 `createApp` 或 `ReactDOM.render` 的侵入式硬编码方案。
+ * 转为无头(Headless) 模式：
+ * 该基类在需要挂载 DOM 时，仅抛出带有节点实例与容器 `rootEl` 的事件。
+ * 外部 React/Vue 层捕获到该事件后，利用各自的 Portal / Teleport 技术完成最终的组件渲染。
+ */
+export declare class HeadlessHtmlNodeModel extends BaseNodeModel {
+    /**
+     * LogicFlow 提供的 HTML 挂载回调钩子
+     * @param rootEl - LogicFlow 提供给该节点用于承载 HTML 内容的原生容器节点
+     */
+    setHtml(rootEl: HTMLElement): void;
+}
+//# sourceMappingURL=HeadlessHtmlNode.d.ts.map

package/dist/nodes/SwitchNode.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file SwitchNode.ts
+ * @description 路由分支节点 (Switch Node)
+ * 继承自基础节点模型，该节点允许在边上挂载动态的条件规则，用于实现规则引擎中的 if/else 逻辑分支。
+ */
+import { BaseNodeModel } from '../models/BaseNodeModel';
+/**
+ * 路由分支节点数据模型
+ * @class SwitchNodeModel
+ * @extends BaseNodeModel
+ * @description
+ * 负责分发和管控下游流程，其最大的特性是`出边必须包含条件表达式`。
+ * 当用户尝试从此节点连出一根边时，会自动触发 `getConnectedSourceRules` 的合法性校验，
+ * 引擎可通过拦截该校验，弹窗要求用户输入表达式。
+ */
+export declare class SwitchNodeModel extends BaseNodeModel {
+    /**
+     * 初始化节点默认宽高
+     */
+    setAttributes(): void;
+    /**
+     * 获取作为起始节点(Source)时的连线规则
+     * @returns {Array} 连线校验规则列表
+     */
+    getConnectedSourceRules(): import("@logicflow/core").Model.ConnectRule[];
+}
+//# sourceMappingURL=SwitchNode.d.ts.map

package/dist/nodes/UnknownNodeModel.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file UnknownNodeModel.ts
+ * @description 兜底渲染节点模型 (降级处理)
+ */
+import { BaseNodeModel } from '../models/BaseNodeModel';
+/**
+ * @class UnknownNodeModel
+ * @description 当后端传递的 `type` 在当前前端工程内找不到对应的 `ComponentDefinition` 时，
+ * 编辑器不应直接白屏崩溃，而是使用该未知节点进行红色虚线框的降级渲染。
+ * 极大地增强了对后端的后向兼容性 (Backward Compatibility)。
+ */
+export declare class UnknownNodeModel extends BaseNodeModel {
+    /**
+     * 覆写属性初始化
+     */
+    setAttributes(): void;
+    /**
+     * 覆写获取节点样式
+     *
+     * - 使用红色虚线与淡红背景警告用户该算子处于未知/缺失状态
+     */
+    getNodeStyle(): import("@logicflow/core").LogicFlow.CommonTheme;
+}
+//# sourceMappingURL=UnknownNodeModel.d.ts.map

package/dist/standalone/HuanbanRulegoEditor.d.ts

@@ -31,10 +31,14 @@
 import LogicFlow from '@logicflow/core';
 import { EditorCore } from '../core/EditorCore';
 import { I18nManager } from '../core/I18nManager';
-import type { EditorOptions } from '../types/editor';
+import type { AiProviderOption, EditorOptions } from '../types/editor';
 import type { RuleChainData } from '../types/rule-chain';
-import type { ComponentDefinition } from '../types/component';
+import type { ComponentDefinition, RawComponentData } from '../types/component';
+import type { SettingsDialogTab } from './editor-dialogs';
 import type { AutoLayoutOptions } from '../core/AutoLayout';
+export declare function normalizeComponentsRawPayload(data: unknown): unknown;
+export declare function normalizeComponentsPayload(data: unknown): ComponentDefinition[];
+export declare function applyComponentsRuntimePayloadOptions(opts: Record<string, any>, data: unknown): unknown;
 /**
  * HuanbanRulegoEditor 配置选项
  */
@@ -69,11 +73,35 @@ export interface HuanbanRulegoEditorOptions {
      *   return fetch(url, init)
      * }
      */
-    customFetch?: (url: string, init: RequestInit) => Promise<Response>;
+    customFetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    /** 允许携带敏感 headers 的 API origin 白名单；默认包含同源和 apiBase origin */
+    allowedApiOrigins?: string[];
+    /** 请求返回 401/403 时触发，宿主可在此刷新登录态 */
+    onAuthExpired?: (response: Response) => void;
+    /** 请求返回 401/403 时触发，宿主可在此清理本地 token */
+    clearToken?: () => void;
     /** 初始规则链数据 */
     data?: RuleChainData | null;
-    /** 初始组件列表 */
-    components?: ComponentDefinition[];
+    /** 初始组件列表，支持数组或官方 /api/v1/components 分段返回 */
+    components?: RawComponentData;
+    /** AI 供应商预设；对齐官方 editorOptions.aiProviders */
+    aiProviders?: AiProviderOption[];
+    /** 运行面板 AI 对话发送到 /rules/{chainId}/v1/chat/completions 的模型名 */
+    runChatModel?: string;
+    /** 兼容旧集成命名；未设置 runChatModel 时作为运行面板 AI 对话默认模型 */
+    defaultChatModel?: string;
+    /** Embedding AI 供应商预设；供本地意图识别等 providerType=embedding 字段使用 */
+    aiEmbeddingProviders?: AiProviderOption[];
+    /** 官方 /components 原始载荷，保留 builtins、skillPath 等属性抽屉需要的附加协议 */
+    componentsPayload?: unknown;
+    /** 兼容历史命名：部分集成方使用 componentPayload 传入官方 /components 原始载荷 */
+    componentPayload?: unknown;
+    /** 内置 AI 工具列表；默认从 componentsPayload.builtins['ai/tools'].tools 提取 */
+    builtinTools?: any[];
+    /** 兼容旧版顶层 tools 字段 */
+    tools?: any[];
+    /** 后端返回的技能目录路径，用于 skill 内置工具提示 */
+    skillPath?: string;
     /** LogicFlow 额外配置 (会与默认配置合并) */
     lfOptions?: Record<string, unknown>;
     /** LogicFlow 插件数组 (不传则自动从全局获取) */
@@ -84,21 +112,43 @@ export interface HuanbanRulegoEditorOptions {
     showToolbar?: boolean;
     /** 工具栏左侧标题 (不设置则不显示标题区域) */
     toolbarTitle?: string;
+    /** 是否显示工具栏按钮文字，默认 false；设为 true 时显示图标 + 文字 */
+    showToolbarButtonLabels?: boolean;
+    /** 工具栏是否只显示图标，默认 true；显式 false 时可显示文字 */
+    toolbarIconOnly?: boolean;
     /** 是否显示侧边栏, 默认 true */
     showSidebar?: boolean;
     /** 侧边栏宽度, 默认 220 */
     sidebarWidth?: number;
     /** 侧边栏是否默认收起, 默认 false */
     sidebarCollapsed?: boolean;
-    /** 是否在工具栏显示「信息」按钮, 默认 false */
+    /** 是否在画布右上工具条显示「信息」按钮, 默认 true */
     showInfoButton?: boolean;
+    /** 是否在画布右上工具条显示「AI 助手」按钮, 默认 true */
+    showAiChatButton?: boolean;
+    /** 是否在画布右上工具条显示「调试面板」按钮, 默认 true */
+    showDebugConsoleButton?: boolean;
+    /** 是否在画布右上工具条显示「清除调试高亮」按钮, 默认 true */
+    showClearDebugHighlightButton?: boolean;
+    /** 是否在画布右上工具条显示「框选」按钮, 默认 false */
+    showSelectionButton?: boolean;
+    /** 是否在顶部工具栏显示「设置」按钮, 默认 true */
+    showSettingsButton?: boolean;
     /** 编辑器就绪 */
     onReady?: (ctx: {
         lf: LogicFlow;
         core: EditorCore;
     }) => void;
     /** 保存回调 */
-    onSave?: (data: any) => void;
+    onSave?: (data: any) => void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    } | Promise<void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    }>;
     /** 节点点击 */
     onNodeClick?: (data: unknown) => void;
     /** 节点双击 */
@@ -113,6 +163,19 @@ export interface HuanbanRulegoEditorOptions {
      * @param chainInfo 当前规则链的配置信息 (ruleChain 对象)
      */
     onInfoClick?: (chainInfo: any) => void;
+    /** 劫持官方设置弹窗，供 Vue/React 宿主使用自定义组件化设置页 */
+    onSettingsClick?: (ctx: {
+        initialTab?: SettingsDialogTab;
+        apiBase?: string;
+        baseUrl?: string;
+    }) => void;
+    /** 内置设置弹窗保存系统设置后触发 */
+    onSettingsSubmit?: (data: {
+        apiBase: string;
+        baseUrl: string;
+    }) => void;
+    /** 内置设置弹窗点击登录时触发；未提供时仅提示宿主接入 */
+    onLoginClick?: () => void;
     /** 是否在工具栏显示「导出」按钮, 默认 true (已有导出功能则显示增强弹窗) */
     showExportDialog?: boolean;
     /** 劫持导出行为, 调用方自行处理; 不设则使用内置弹窗 */
@@ -120,7 +183,7 @@ export interface HuanbanRulegoEditorOptions {
         json: string;
         imageDataUrl?: string;
     }) => void;
-    /** 是否在工具栏显示「运行」按钮, 默认 false */
+    /** 是否在画布右上工具条显示「运行」按钮, 默认 true */
     showRunButton?: boolean;
     /** 劫持运行行为; 不设则使用内置运行 Drawer */
     onRunClick?: (chainId: string) => void;
@@ -141,7 +204,15 @@ export interface HuanbanRulegoEditorOptions {
     /** 是否在工具栏显示「部署/下架/重载」按钮, 默认 true */
     showDeployButton?: boolean;
     /** 劫持部署行为; 不设则使用内置 API 调用 */
-    onDeploy?: (chainId: string, action: 'deploy' | 'undeploy' | 'reload') => void;
+    onDeploy?: (chainId: string, action: 'deploy' | 'undeploy' | 'reload') => void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    } | Promise<void | boolean | {
+        success?: boolean;
+        msg?: string;
+        message?: string;
+    }>;
     /** 规则链列表数据 (初始传入, 用于弹窗列表展示) */
     ruleItems?: any[];
     /** 规则链 API 地址 (如 '/rules'), 用于远程加载规则链列表 */
@@ -157,6 +228,14 @@ export interface HuanbanRulegoEditorOptions {
     /** 运行记录页面 URL (支持 {chainId} 占位符), 如 'http://xxx/ui/#/workflow/runs?chainId={chainId}' */
     runHistoryUrl?: string;
 }
+export interface AIAssistantOpenOptions {
+    /** 打开后默认从此节点上下文发起对话/调试 */
+    fromNodeId?: string;
+    /** 仅使用指定节点上下文 */
+    onlyThisNode?: boolean;
+    /** 宿主或内部入口标识，例如 skills/components/debug */
+    section?: string;
+}
 /**
  * 原生 JS 编辑器 — 一行代码启动完整的 RuleGo 规则链编辑器
  *
@@ -191,6 +270,10 @@ export declare class HuanbanRulegoEditor {
     private statusRunState;
     /** 侧边栏是否折叠 */
     private sidebarCollapsed;
+    /** 工具栏图标定义；画布浮动工具条需要在 LogicFlow 初始化后重建一次 */
+    private toolbarIcons;
+    private aiAssistantOpen;
+    private aiAssistantUnread;
     /** 组件数据 @internal */
     components: ComponentDefinition[];
     /** 左侧分组展开状态 @internal */
@@ -205,12 +288,18 @@ export declare class HuanbanRulegoEditor {
     private _cleanupShortcuts;
     /** 右键菜单清理函数 @internal */
     private _cleanupContextMenu;
+    /** LogicFlow/Core 事件桥接清理函数 @internal */
+    private _cleanupBridgeEvents;
+    /** 全屏状态监听清理函数 */
+    private _cleanupFullscreenState;
     /** 小地图是否可见 @internal */
     _miniMapVisible: boolean;
     /** 内部剪贴板 (用于 Ctrl+C/V 复制粘贴节点) @internal */
     _clipboard: any[];
     /** 自动排版进行中标志 — edge:add 事件检查此标志，跳过弹窗 @internal */
     _isAutoLayouting: boolean;
+    /** 数据加载后是否需要自动优化布局 @internal */
+    _pendingAutoOptimize: boolean;
     constructor(options: HuanbanRulegoEditorOptions);
     /**
      * 翻译便捷方法 — 从当前语言包获取文本
@@ -257,6 +346,8 @@ export declare class HuanbanRulegoEditor {
      */
     private init;
     private createDOM;
+    /** 渲染画布右上浮动工具条；LogicFlow 初始化会清空画布容器，因此 init 后也会调用一次 */
+    private _renderCanvasToolbar;
     /** 工具栏按钮点击事件 — 实现已提取到 editor-toolbar.ts */
     private handleToolbarClick;
     /**
@@ -319,9 +410,9 @@ export declare class HuanbanRulegoEditor {
     updateStatusBar(): void;
     /**
      * 加载组件列表
-     * @param components 组件定义数组
+     * @param components 组件定义数组或官方 /api/v1/components 分段返回
      */
-    loadComponents(components: ComponentDefinition[]): void;
+    loadComponents(components: RawComponentData): void;
     /**
      * 加载规则链数据
      * @param data RuleGo 规则链 JSON 数据
@@ -372,7 +463,26 @@ export declare class HuanbanRulegoEditor {
      * 实现已提取到 editor-dialogs.ts
      */
     /** @internal 子模块(editor-toolbar)使用 */
-    _showRunPanel(): void;
+    _showRunPanel(options?: {
+        fromNodeId?: string;
+        onlyThisNode?: boolean;
+        initialMode?: 'form' | 'chat';
+        initialTab?: 'response' | 'resp_headers' | 'debug' | 'history' | 'integration';
+        section?: string;
+    }): void;
+    /** @internal 子模块(editor-toolbar)使用 */
+    _showSettingsDialog(initialTab?: SettingsDialogTab): void;
+    /** 公开打开官方设置弹窗；Vue/React 包可用该方法保持设置入口协议一致 */
+    openSettings(initialTab?: SettingsDialogTab): void;
+    /**
+     * 公开打开 AI 助手。
+     *
+     * 该方法是 core / Vue / React / UMD 的统一入口。框架组件、属性抽屉、
+     * 画布按钮和宿主系统都应调用这个方法，而不是直接依赖内部运行面板实现。
+     */
+    openAiAssistant(options?: AIAssistantOpenOptions): void;
+    /** 关闭当前 AI 助手/运行面板 Drawer */
+    closeAiAssistant(): void;
     /**
      * 显示组件管理弹窗
      * 实现已提取到 editor-dialogs.ts

package/dist/standalone/ai-providers.d.ts

@@ -0,0 +1,7 @@
+import type { AiProviderOption } from '../types/editor';
+export type { AiProviderOption } from '../types/editor';
+export declare const DEFAULT_AI_PROVIDERS: AiProviderOption[];
+export declare function getGlobalProviderList(name: 'rulegoAiProviders' | 'rulegoAiEmbeddingProviders'): AiProviderOption[];
+export declare function getAiProviders(providers?: AiProviderOption[]): AiProviderOption[];
+export declare function getAiEmbeddingProviders(providers?: AiProviderOption[]): AiProviderOption[];
+//# sourceMappingURL=ai-providers.d.ts.map

package/dist/standalone/auth-fetch.d.ts

@@ -25,6 +25,11 @@
  * @returns 合并后的 headers 对象
  */
 export declare function getAuthHeaders(editor: any): Record<string, string>;
+export interface AuthFetchOptions {
+    timeoutMs?: number;
+    allowedOrigins?: string[];
+    sensitiveHeaderNames?: string[];
+}
 /**
  * 带认证的 fetch 封装
  *
@@ -39,5 +44,5 @@ export declare function getAuthHeaders(editor: any): Record<string, string>;
  * @param editor - HuanbanRulegoEditor 实例
  * @returns fetch Response
  */
-export declare function authFetch(url: string, init: RequestInit | undefined, editor: any): Promise<Response>;
+export declare function authFetch(url: string, init: RequestInit | undefined, editor: any, options?: AuthFetchOptions): Promise<Response>;
 //# sourceMappingURL=auth-fetch.d.ts.map

package/dist/standalone/code-editor.d.ts

@@ -4,9 +4,9 @@
  *
  * 功能:
  * - 创建 CodeMirror 6 编辑器实例 (替代 textarea)
- * - 支持 JavaScript / JSON / Lua 三种语言的语法高亮
+ * - 支持 JavaScript / JSON / Lua / Plain 四种语言模式
  * - 内置暗色主题 (oneDark)、行号、代码折叠、自动补全
- * - 自动语法校验 (JS: linter, JSON: linter, Lua: 基础括号匹配)
+ * - 自动语法校验 (JS: linter, JSON: linter, Lua: 基础括号匹配, Plain: 不阻断)
  * - 获取/设置编辑器内容
  * - 统一销毁管理，避免内存泄漏
  *
@@ -17,13 +17,22 @@
  * @output CodeEditorInstance { getValue, setValue, destroy, view }
  */
 import { EditorView } from '@codemirror/view';
+import { type CompletionSource } from '@codemirror/autocomplete';
 /**
  * 代码编辑器语言类型
  * - js: JavaScript 脚本
  * - json: JSON 数据
  * - lua: Lua 脚本 (仅基础高亮, 无内置 linter)
+ * - plain: SQL/表达式/未知代码类型，统一编辑器外观但不做语法阻断
  */
-export type CodeEditorLang = 'js' | 'json' | 'lua';
+export type CodeEditorLang = 'js' | 'json' | 'lua' | 'plain';
+export type CodeEditorCompletionMode = 'js' | 'sql' | 'plain';
+export interface CodeEditorCompletionItem {
+    label?: string;
+    value?: string;
+    detail?: string;
+    type?: string;
+}
 /**
  * 创建代码编辑器的配置选项
  */
@@ -32,7 +41,7 @@ export interface CodeEditorOptions {
     parent: HTMLElement;
     /** 初始代码内容 */
     value?: string;
-    /** 语言类型: js / json / lua */
+    /** 语言类型: js / json / lua / plain */
     lang?: CodeEditorLang;
     /** 是否只读 */
     readOnly?: boolean;
@@ -46,6 +55,16 @@ export interface CodeEditorOptions {
     maxHeight?: number;
     /** Tab 缩进空格数, 默认 2 */
     tabSize?: number;
+    /** RuleGo 官方补全模式: js / sql / plain */
+    completionMode?: CodeEditorCompletionMode;
+    /** 当前规则链 additionalInfo.inputSchema 解析出的 msg.* 字段 */
+    schemaCompletions?: CodeEditorCompletionItem[];
+    /** LogicFlow 全局变量，用于 ${global.*} 补全 */
+    globalVars?: Array<string | {
+        label?: string;
+        value?: string;
+        name?: string;
+    }>;
 }
 /**
  * 代码编辑器实例 — 对外提供的操作接口
@@ -60,6 +79,23 @@ export interface CodeEditorInstance {
     /** CodeMirror EditorView 实例 (高级用法) */
     view: EditorView;
 }
+/**
+ * 创建 RuleGo 官方补全源。
+ * 覆盖官方 PropertyCodeEditor.vue 中的触发协议:
+ * - `${global.` → lf.globalVars
+ * - `${` → `global.` 前缀
+ * - `msg.` → ruleChain.additionalInfo.inputSchema.properties
+ * - SQL 模式 → StreamSQL 函数/关键字
+ */
+export declare function createRulegoCompletionSource(options?: {
+    mode?: CodeEditorCompletionMode;
+    schemaCompletions?: CodeEditorCompletionItem[];
+    globalVars?: Array<string | {
+        label?: string;
+        value?: string;
+        name?: string;
+    }>;
+}): CompletionSource;
 /**
  * 创建 CodeMirror 6 代码编辑器实例
  *

package/dist/standalone/custom-nodes.d.ts

@@ -7,7 +7,9 @@
  * - BaseNode (RedNode / RedNodeModel): 基础矩形节点
  * - SimpleNode: 带图标的标准节点
  * - StartNode: 起始节点 (不可移动, 只有右锚点)
+ * - EndpointNode: 端点节点 (只有右锚点)
  * - ChainNode: 子规则链节点 (只有左锚点)
+ * - AgentNode / AgentOrchestrationNode: AI 智能体节点
  * - FlowLink: 贝塞尔曲线连线
  *
  * 所有节点采用 Node-RED 风格:
@@ -18,9 +20,10 @@
  *   registerCustomElements(lf)
  */
 import LogicFlow from '@logicflow/core';
+export type CustomNodeTranslator = (key: string, fallback: string) => string;
 /**
  * 注册所有自定义图元到 LogicFlow 实例
  * @param lf - LogicFlow 画布实例
  */
-export declare function registerCustomElements(lf: LogicFlow): void;
+export declare function registerCustomElements(lf: LogicFlow, translate?: CustomNodeTranslator): void;
 //# sourceMappingURL=custom-nodes.d.ts.map

package/dist/standalone/editor-context-menu.d.ts

@@ -3,8 +3,9 @@
  * @description 画布右键菜单模块
  *
  * 功能:
- * - 画布空白处右键: 全选 / 适应画布 / 粘贴节点
- * - 节点右键: 编辑 / 复制 / 删除 / 断开连接
+ * - 画布空白处右键: 全选 / 适应画布 / 重置缩放 / 粘贴节点
+ * - 节点右键: 编辑 / 复制 / 从此节点开始执行 / 仅执行此节点 / 删除 / 断开连接
+ * - 连线右键: 编辑 / 删除
  * - 自动定位在鼠标位置
  * - 点击菜单外自动关闭
  *

package/dist/standalone/editor-debug-ws.d.ts

@@ -35,6 +35,9 @@ export interface DebugWsCallbacks {
     /** 连接状态变化时调用 */
     onStatus: (status: WsStatus) => void;
 }
+export interface LiveTerminalRendererOptions {
+    getNodeName?: (nodeId: string) => string;
+}
 /**
  * 调试日志 WebSocket 管理器
  *
@@ -133,15 +136,23 @@ export declare class LiveTerminalRenderer {
     private container;
     /** 日志缓冲区 */
     private buffer;
+    /** IN 日志时间索引，用于按官方 chainId + msgId + nodeId 计算 OUT 耗时 */
+    private inTsByMsgNode;
     /** 最大缓冲条数 */
     private maxLines;
-    /** HTML 转义函数 */
-    private escapeHtml;
+    /** 渲染选项 */
+    private options;
+    /** 已安排但尚未执行的终端渲染帧 */
+    private pendingRenderFrame;
+    /** requestAnimationFrame 不可用时的降级渲染定时器 */
+    private pendingRenderTimer;
+    /** 是否已经销毁，销毁后不再追加或渲染 */
+    private destroyed;
     /**
      * @param container  - 终端面板元素
-     * @param escapeHtml - HTML 转义函数 (ctx._escapeHtml)
+     * @param _escapeHtml - 兼容旧构造签名；当前渲染使用 textContent，不再需要 HTML 字符串转义
      */
-    constructor(container: HTMLElement, escapeHtml: (text: string) => string);
+    constructor(container: HTMLElement, _escapeHtml: (text: string) => string, options?: LiveTerminalRendererOptions);
     /**
      * 追加一条日志消息
      * @param item - 日志条目对象
@@ -151,6 +162,10 @@ export declare class LiveTerminalRenderer {
      * 清空所有日志
      */
     clear(): void;
+    /**
+     * 销毁渲染器，释放待渲染帧、DOM 内容和内部索引。
+     */
+    destroy(): void;
     /**
      * 获取当前日志条数
      */
@@ -160,11 +175,16 @@ export declare class LiveTerminalRenderer {
      */
     private render;
     /**
-     * 格式化单条日志为终端 HTML
+     * 格式化单条日志为终端结构化文本
      *
      * @param item - 日志条目
-     * @returns HTML 字符串
+     * @returns 终端行数据
      */
     private formatLogLine;
+    /**
+     * 高频 WebSocket 日志下按帧合并渲染，避免每条消息全量 replaceChildren。
+     */
+    private scheduleRender;
+    private cancelScheduledRender;
 }
 //# sourceMappingURL=editor-debug-ws.d.ts.map

package/dist/standalone/editor-delete.d.ts

@@ -0,0 +1,4 @@
+export declare function canDeleteNodesWithInputGuard(editor: any, selectedNodes: any[]): boolean;
+export declare function deleteGraphElementsWithInputGuard(editor: any, nodes?: any[], edges?: any[]): boolean;
+export declare function deleteSelectedElementsWithInputGuard(editor: any): boolean;
+//# sourceMappingURL=editor-delete.d.ts.map