@huanban/rulego-editor-core 1.4.2 → 2.0.0

package/README.md

@@ -15,7 +15,7 @@
 - **基于 LogicFlow** — 底层使用 LogicFlow 流程图引擎，提供强大的节点编排能力
 - **完整事件系统** — EventBus 事件总线，支持节点/边/编辑器事件监听
 - **状态管理** — 内置 StateStore 响应式状态管理
-- **13 套主题** — 经典(Classic) / 暗夜(Dark) / 自然(Nature) / 优雅(Elegant) / 科技(Tech) / 现代(Modern) / 彩色(Colorful) / 蚂蚁蓝(Ant Blue) / Material / Tailwind / GitHub / VS Code / Apple
+- **12 套浅色与彩色主题** — 经典(Classic) / 自然(Nature) / 优雅(Elegant) / 科技(Tech) / 现代(Modern) / 彩色(Colorful) / 蚂蚁蓝(Ant Blue) / Material / Tailwind / GitHub / VS Code / Apple
 - **国际化** — 中/英文双语支持，一键切换
 - **撤销/重做** — 内置 undo/redo 操作历史
 - **调试日志** — 内置调试开关，默认关闭，可按需开启
@@ -43,10 +43,11 @@ pnpm add @huanban/rulego-editor-core
 <div id="editor" style="width: 100%; height: 100vh;"></div>
 <script src="dist/index.umd.js"></script>
 <script>
-  const editor = new RuleGoEditorCore.HuanbanRulegoEditor('#editor', {
+  const editor = new RuleGoEditorCore.HuanbanRulegoEditor({
+    container: '#editor',
     apiBase: 'http://127.0.0.1:9090/api/v1',
     theme: 'modern',
-    lang: 'zh-CN',
+    locale: 'zh-CN',
     onReady: ({ lf, core }) => console.log('编辑器就绪'),
     onNodeClick: (node) => console.log('点击节点', node),
     onSaveSuccess: (data) => console.log('保存成功', data),
@@ -59,9 +60,10 @@ pnpm add @huanban/rulego-editor-core
 ```typescript
 import { HuanbanRulegoEditor } from '@huanban/rulego-editor-core'
 
-const editor = new HuanbanRulegoEditor('#editor', {
+const editor = new HuanbanRulegoEditor({
+  container: '#editor',
   apiBase: 'http://127.0.0.1:9090/api/v1',
-  lang: 'zh-CN',
+  locale: 'zh-CN',
   theme: 'modern',
   toolbarTitle: '我的工作流',
 })
@@ -86,10 +88,20 @@ const allChains = await api.listAll(100, '', 100)
 // 获取内容
 const content = await api.getContent('chain-001')
 
-// 保存
-await api.updateContent('chain-001', chainData)
+// 正式保存，chainData.ruleChain.id 决定目标资源，默认带 versionMark=1。
+const result = await api.create(chainData)
+if (!result.success) throw new Error(result.msg || 'Save failed')
+
+// 草稿仍然写入后端，但不标记正式版本。
+await api.create(chainData, { draft: true })
 ```
 
+默认编辑器已接入多规则链 Tab、草稿、版本历史、运行瀑布/对比、全局配置及共享节点入口。
+API 默认遵守 RuleGo 协议，扩展接口只接受显式宿主配置；不自动探测模型服务，也不使用 Mock。
+`apiPrefix` 默认 `/api/v1`，完整自定义 API base 可配合 `apiPrefix: ''` 使用。
+宿主已有 Tab 时可设 `showWorkspaceTabs: false`，其他按钮通过 `toolbar` 或 `capabilities` 控制。
+完整接入约定见 [接口与多框架接入合同](../../docs/plan/2026-10-19-upstream-editor-refresh/03-api-and-host-contract.md)。
+
 ## 🎨 内置 UI 组件（独立编辑器）
 
 `HuanbanRulegoEditor` 内置完整的 UI，**无需额外安装任何框架组件**：
@@ -138,7 +150,7 @@ setDebug(true)
 | `DEFAULT_ROUTES` | 默认 API 路径映射 (RuleGo 标准路径) |
 | `EventBus` | 事件总线，支持 on / off / emit 模式 |
 | `StateStore` | 响应式状态容器，支持 subscribe |
-| `ThemeManager` | 主题管理器，13 套主题自由切换；standalone、React、Vue 和 DOM 组件共享运行时变量 |
+| `ThemeManager` | 主题管理器，12 套主题自由切换；standalone、React、Vue 和 DOM 组件共享运行时变量 |
 | `I18nManager` | 国际化管理器，中英文切换 |
 | `ValidationEngine` | 规则链验证引擎 |
 | `EditorWorkspace` | 框架无关的多 Tab、草稿和保存冲突状态 |

package/dist/ai/ai-chat-options.d.ts

@@ -0,0 +1,12 @@
+export type AIChatUrlValue = string | (() => string);
+export interface AIChatConnectionOptions {
+    chainId?: string;
+    baseUrl?: AIChatUrlValue;
+    apiPrefix?: AIChatUrlValue;
+    getToken?: (() => string | null | undefined) | null;
+}
+export declare function resolveAIChatEndpoint(options: AIChatConnectionOptions): string;
+export declare function resolveAIChatTransportOptions(options: AIChatConnectionOptions, init?: RequestInit): {
+    endpoint: string;
+    init: RequestInit;
+};

package/dist/api/AIAssistantAPI.d.ts

@@ -0,0 +1,29 @@
+import type { ExtendedApiOptions } from './extended-api-shared';
+import { ExtendedApiBase } from './extended-api-shared';
+export interface AIAssistantSettings {
+    prompt: string;
+    model: string;
+    provider?: string;
+    maxSteps?: number;
+    maxToolOutput?: number;
+}
+export interface AIAssistantModelConfig {
+    model: string;
+    provider?: string;
+    [key: string]: unknown;
+}
+export interface AIAssistantRoutes {
+    agentPrompt: (agentId: string) => string;
+    agentModel: (agentId: string) => string;
+}
+export declare const AI_ASSISTANT_DEFAULT_AGENT_ID = "_assistant";
+export declare class AIAssistantAPI extends ExtendedApiBase {
+    private readonly routes;
+    constructor(options: ExtendedApiOptions & {
+        routes?: Partial<AIAssistantRoutes>;
+    });
+    getPrompt(agentId?: string): Promise<string>;
+    updatePrompt(agentId: string, content: string): Promise<void>;
+    getModel(agentId?: string): Promise<AIAssistantModelConfig>;
+    updateModel(agentId: string, model: string, provider?: string): Promise<void>;
+}

package/dist/api/AIManager.d.ts

@@ -1,12 +1,18 @@
 import { ApiProvider } from './ApiProvider';
+export interface AIManagerOptions {
+    modelsPath?: string;
+    loader?: (request: ApiProvider['request'], signal: AbortSignal) => Promise<Response>;
+}
 export declare class AIManager {
     private readonly provider;
+    private readonly modelsPath;
+    private readonly loader?;
     private modelsCache;
     private fetchPromise;
     private fetchPromiseKey;
     private lastFetchTime;
     private cacheKey;
-    constructor(provider?: ApiProvider);
+    constructor(provider?: ApiProvider, options?: AIManagerOptions);
     getAvailableModels(): Promise<any>;
     private fetchAvailableModels;
 }

package/dist/api/ApiProvider.d.ts

@@ -1,23 +1,29 @@
 import { ServerStatusStore } from '../core/server-status';
+import type { IdentityProvider } from '../core/IdentityProvider';
 import type { ApiAuthRequiredHandler, ApiCacheKey, ApiCustomFetch, ApiRequestHeaders } from './types';
 export interface EditorApiConfig {
     baseUrl: string;
+    apiPrefix?: string;
     fetchHeaders?: ApiRequestHeaders;
     customFetch?: ApiCustomFetch;
     cacheKey?: ApiCacheKey;
     includeStoredToken?: boolean;
     onAuthRequired?: ApiAuthRequiredHandler;
     serverStatus?: ServerStatusStore;
+    identityProvider?: IdentityProvider;
 }
-export declare function normalizeApiProviderBaseUrl(baseUrl: string): string;
-export declare function normalizeApiV1BaseUrl(baseUrl: string): string;
+export declare function normalizeApiPrefix(apiPrefix?: string): string;
+export declare function normalizeApiProviderBaseUrl(baseUrl: string, apiPrefix?: string): string;
+export declare function normalizeApiV1BaseUrl(baseUrl: string, apiPrefix?: string): string;
 export declare class ApiProvider {
     private config;
     private configGeneration;
+    private readonly debugClientId;
     private readonly lastAuthNotifyAt;
     constructor(config?: Partial<EditorApiConfig>);
     updateConfig(newConfig: Partial<EditorApiConfig>): void;
     getBaseUrl(): string;
+    getApiPrefix(): string;
     isSharedCacheEnabled(): boolean;
     isModelCacheEnabled(): boolean;
     getCacheKey(): string;
@@ -25,7 +31,14 @@ export declare class ApiProvider {
     private isCurrentRequestGeneration;
     private notifyAuthRequired;
     fetchComponents(init?: RequestInit): Promise<unknown>;
-    runDebug(chainId: string, data: any): Promise<unknown>;
-    getDebugWsUrl(chainId: string): string;
+    runDebug(chainId: string, data: unknown, options?: {
+        msgType?: string;
+        msgId?: string;
+        metadata?: Record<string, string>;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    getDebugWsUrl(chainId: string, clientId?: string): string;
 }
 export declare const apiProvider: ApiProvider;
+export declare function getToken(): string | null;
+export declare function clearToken(): void;

package/dist/api/DebugSocketClient.d.ts

@@ -1,4 +1,6 @@
+import { type WebSocketTokenProvider } from '../core/websocket-auth';
 export interface DebugSocketClientOptions {
+    getToken?: WebSocketTokenProvider;
     maxReconnectAttempts?: number;
     maxLifetimeReconnectAttempts?: number;
     reconnectBaseDelayMs?: number;

package/dist/api/GlobalConfigAPI.d.ts

@@ -0,0 +1,35 @@
+import { type GlobalConfigFetcher, type GlobalConfigPatch, type GlobalConfigReloadResult, type GlobalConfigValues } from '../core/global-config';
+import type { ApiAuthRequiredHandler, ApiCustomFetch, ApiRequestHeaders } from './types';
+export interface GlobalConfigTransportContext {
+    opts: {
+        apiBase?: string;
+        fetchTimeout?: number;
+        fetchHeaders?: ApiRequestHeaders;
+        customFetch?: ApiCustomFetch;
+        allowedApiOrigins?: string[];
+        apiCacheKey?: string;
+        onApiAuthRequired?: ApiAuthRequiredHandler;
+        onAuthExpired?: (response: Response) => void;
+        clearToken?: () => void;
+    };
+    serverStatus?: import('../core/server-status').ServerStatusStore;
+    _getTransportGeneration?(): number;
+}
+export declare class GlobalConfigApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(message: string, status: number, url: string);
+}
+export declare class GlobalConfigAPI implements GlobalConfigFetcher {
+    private readonly editor;
+    private readonly requests;
+    private destroyed;
+    constructor(editor: GlobalConfigTransportContext);
+    captureContext(): () => boolean;
+    private request;
+    getGlobalConfig(signal?: AbortSignal): Promise<GlobalConfigValues>;
+    getGlobalOverrides(signal?: AbortSignal): Promise<GlobalConfigValues>;
+    updateGlobalConfig(patch: GlobalConfigPatch, signal?: AbortSignal): Promise<GlobalConfigReloadResult>;
+    revertGlobalConfigKey(key: string, signal?: AbortSignal): Promise<GlobalConfigReloadResult>;
+    destroy(): void;
+}

package/dist/api/IoTPointTemplateAPI.d.ts

@@ -0,0 +1,32 @@
+import type { ExtendedApiOptions } from './extended-api-shared';
+import { ExtendedApiBase } from './extended-api-shared';
+export interface PointTemplate {
+    id: string;
+    name: string;
+    points: unknown[];
+    category?: string;
+    protocol?: string;
+    [key: string]: unknown;
+}
+export interface PointTemplateListParams {
+    protocol?: string;
+    category?: string;
+}
+export interface IoTPointTemplateRoutes {
+    list: string;
+    detail: (id: string) => string;
+    create: string;
+    update: (id: string) => string;
+    remove: (id: string) => string;
+}
+export declare class IoTPointTemplateAPI extends ExtendedApiBase {
+    private readonly routes;
+    constructor(options: ExtendedApiOptions & {
+        routes?: Partial<IoTPointTemplateRoutes>;
+    });
+    list(params?: PointTemplateListParams): Promise<PointTemplate[]>;
+    get(id: string): Promise<PointTemplate>;
+    create(template: Omit<PointTemplate, 'id'>): Promise<PointTemplate>;
+    update(id: string, template: Partial<PointTemplate>): Promise<void>;
+    delete(id: string): Promise<void>;
+}

package/dist/api/MarketplaceAPI.d.ts

@@ -0,0 +1,39 @@
+import type { ExtendedApiOptions } from './extended-api-shared';
+import { ExtendedApiBase } from './extended-api-shared';
+export interface MarketplaceComponent {
+    type: string;
+    label: string;
+    desc?: string;
+    category?: string;
+    icon?: string;
+}
+export interface MarketplaceChain {
+    id: string;
+    name: string;
+    desc?: string;
+    category?: string;
+}
+export interface MarketplaceSearchParams {
+    keywords?: string;
+    page?: number;
+    size?: number;
+}
+export interface MarketplaceChainSearchParams extends MarketplaceSearchParams {
+    root?: boolean;
+}
+export interface MarketplaceRoutes {
+    components: string;
+    chains: string;
+    dynamicComponents: string;
+}
+export declare class MarketplaceAPI extends ExtendedApiBase {
+    private readonly routes;
+    constructor(options: ExtendedApiOptions & {
+        routes?: Partial<MarketplaceRoutes>;
+    });
+    getComponents(params?: MarketplaceSearchParams): Promise<MarketplaceComponent[]>;
+    getChains(params?: MarketplaceChainSearchParams): Promise<MarketplaceChain[]>;
+    installComponent(nodeType: string, body: Record<string, unknown>): Promise<unknown>;
+    uninstallComponent(nodeType: string): Promise<unknown>;
+    getComponentDSL(nodeType: string): Promise<unknown>;
+}

package/dist/api/RuleChainAPI.d.ts

@@ -1,4 +1,4 @@
-import type { WorkflowItem, PagedResponse, ApiResult, WorkflowFetcher, SharedNode, SharedNodeFetcher, RuleChainAPIOptions, ListAllResult, RulePatchPreviewResponse, RuleRepairPlanResponse, RuleSchemaDiffResponse, RuleValidateUpstreamResponse, JSONPatchOperation } from './types';
+import type { WorkflowItem, PagedResponse, ApiResult, WorkflowFetcher, SharedNode, SharedNodeFetcher, RuleChainAPIOptions, ListAllResult, RulePatchPreviewResponse, RuleRepairPlanResponse, RuleSchemaDiffResponse, RuleValidateUpstreamResponse, JSONPatchOperation, RuleMessageBody, RunsListOptions, RunRecord, ComponentDSL, RuleListOptions } from './types';
 export declare class RuleChainApiError extends Error {
     readonly status: number;
     readonly url: string;
@@ -8,6 +8,7 @@ export declare class RuleChainAPI implements WorkflowFetcher, SharedNodeFetcher
     private apiBase;
     private timeout;
     private headers;
+    private authToken?;
     private customFetch?;
     private credentials?;
     private onAuthRequired?;
@@ -24,19 +25,21 @@ export declare class RuleChainAPI implements WorkflowFetcher, SharedNodeFetcher
     private resolveSharedNodePath;
     static parseRuleChain(raw: unknown): WorkflowItem;
     static generateChainId(): string;
-    list(page?: number, size?: number, keywords?: string): Promise<PagedResponse<WorkflowItem>>;
+    list(page?: number, size?: number, keywords?: string, signal?: AbortSignal): Promise<PagedResponse<WorkflowItem>>;
     listAll(size?: number, keywords?: string, maxPages?: number): Promise<WorkflowItem[]>;
     listAllDetailed(size?: number, keywords?: string, maxPages?: number): Promise<ListAllResult<WorkflowItem>>;
     getSharedNodes(keywords?: string, page?: number, size?: number, type?: string, signal?: AbortSignal): Promise<PagedResponse<SharedNode>>;
     getSharedNode(id: string, type: string, signal?: AbortSignal): Promise<SharedNode>;
     saveSharedNode<TResponse = unknown>(id: string, type: string, body: SharedNode, signal?: AbortSignal): Promise<TResponse>;
     deleteSharedNode<TResponse = unknown>(id: string, type: string, signal?: AbortSignal): Promise<TResponse>;
-    create(data: Record<string, unknown>): Promise<ApiResult>;
+    create(data: Record<string, unknown>, options?: {
+        draft?: boolean;
+    }): Promise<ApiResult>;
     remove(id: string): Promise<ApiResult>;
     operate(id: string, type: 'start' | 'stop'): Promise<ApiResult>;
     restart(id: string): Promise<ApiResult>;
     copy(id: string, newName?: string): Promise<ApiResult>;
-    getContent(id: string): Promise<Record<string, unknown>>;
+    getContent(id: string, signal?: AbortSignal): Promise<Record<string, unknown>>;
     getChainStatuses(id: string, signal?: AbortSignal): Promise<unknown>;
     getSharedNodeStatuses(signal?: AbortSignal): Promise<unknown>;
     saveBaseInfo(id: string, info: Record<string, unknown>): Promise<ApiResult>;
@@ -45,5 +48,21 @@ export declare class RuleChainAPI implements WorkflowFetcher, SharedNodeFetcher
     getSchemaDiff(id: string): Promise<RuleSchemaDiffResponse>;
     getRepairPlan(id: string, dsl: Record<string, unknown>, options?: Record<string, unknown>): Promise<RuleRepairPlanResponse>;
     previewPatch(id: string, dsl: Record<string, unknown>, operations: JSONPatchOperation[]): Promise<RulePatchPreviewResponse>;
+    notifyRule(chainId: string, msgType: string, body?: RuleMessageBody): Promise<void>;
+    executeRule(chainId: string, msgType: string, body?: RuleMessageBody): Promise<unknown>;
+    listFiltered(options?: RuleListOptions, signal?: AbortSignal): Promise<PagedResponse<WorkflowItem>>;
+    getRuleCategories(signal?: AbortSignal): Promise<string[]>;
+    getDebugData(chainId: string, nodeId?: string, page?: number, size?: number, signal?: AbortSignal): Promise<unknown[]>;
+    getRunsList(chainId: string, options?: RunsListOptions, signal?: AbortSignal): Promise<PagedResponse<RunRecord>>;
+    getRuns(chainId: string, id: string, signal?: AbortSignal): Promise<RunRecord>;
+    deleteRuns(chainId: string, ids?: string | string[], signal?: AbortSignal): Promise<void>;
+    getComponentDSL(nodeType: string, signal?: AbortSignal): Promise<ComponentDSL>;
+    installComponent(nodeType: string, dsl: ComponentDSL, signal?: AbortSignal): Promise<void>;
+    uninstallComponent(nodeType: string, signal?: AbortSignal): Promise<void>;
+    queryDynamicBuiltin(name: string, params?: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
     getApiBase(): string;
+    getLocales(lang?: string): Promise<Record<string, string>>;
+    getLocalesCached(lang?: string): Promise<Record<string, string>>;
+    static readonly RULE_CHAIN_ASSISTANT_ID = "_assistant";
+    getChatCompletionsUrl(chainId?: string): string;
 }

package/dist/api/RuleChainVersionsAPI.d.ts

@@ -0,0 +1,28 @@
+import type { RuleChainAPIOptions } from './types';
+import { type RuleChainVersionDetail, type RuleChainVersionPage, type RuleChainVersionsFetcher } from '../core/rule-chain-versions';
+import type { RuleChainData } from '../types/rule-chain';
+export interface RuleChainVersionRoutes {
+    list: (chainId: string) => string;
+    detail: (chainId: string, versionId: string) => string;
+    rollback: (chainId: string, versionId: string) => string;
+}
+export interface RuleChainVersionsAPIOptions extends RuleChainAPIOptions {
+    versionRoutes?: Partial<RuleChainVersionRoutes>;
+}
+export declare class RuleChainVersionsAPI implements RuleChainVersionsFetcher {
+    private readonly options;
+    private readonly requests;
+    private destroyed;
+    private lastAuthNotifyAt;
+    constructor(options: RuleChainVersionsAPIOptions | (() => RuleChainVersionsAPIOptions));
+    private config;
+    private getHeaders;
+    private contentPath;
+    private versionPath;
+    private request;
+    getRuleVersions(chainId: string, page?: number, size?: number, signal?: AbortSignal): Promise<RuleChainVersionPage>;
+    getRuleVersion(chainId: string, versionId: string, signal?: AbortSignal): Promise<RuleChainVersionDetail>;
+    rollbackRuleVersion(chainId: string, versionId: string, signal?: AbortSignal): Promise<unknown>;
+    getContent(chainId: string, signal?: AbortSignal): Promise<RuleChainData>;
+    destroy(): void;
+}

package/dist/api/SkillsAPI.d.ts

@@ -0,0 +1,31 @@
+import type { ExtendedApiOptions } from './extended-api-shared';
+import { ExtendedApiBase } from './extended-api-shared';
+export interface SkillItem {
+    name: string;
+    desc?: string;
+    enabled?: boolean;
+    version?: string;
+    [key: string]: unknown;
+}
+export interface SkillsRoutes {
+    list: string;
+    detail: (name: string) => string;
+    create: string;
+    update: (name: string) => string;
+    remove: (name: string) => string;
+    upload: string;
+}
+export declare class SkillsAPI extends ExtendedApiBase {
+    private readonly routes;
+    constructor(options: ExtendedApiOptions & {
+        routes?: Partial<SkillsRoutes>;
+    });
+    list(scope?: string): Promise<SkillItem[]>;
+    getDetail(name: string, scope?: string): Promise<unknown>;
+    create(payload: Record<string, unknown>): Promise<void>;
+    update(name: string, payload: Record<string, unknown>): Promise<void>;
+    delete(name: string, scope?: string): Promise<void>;
+    upload(file: Blob, scope?: string): Promise<{
+        name: string;
+    }>;
+}

package/dist/api/UserAPI.d.ts

@@ -0,0 +1,39 @@
+import type { ExtendedApiOptions } from './extended-api-shared';
+import { ExtendedApiBase } from './extended-api-shared';
+export interface UserInfo {
+    username: string;
+    role?: string;
+    roles?: string[];
+    apiKey?: string;
+    [key: string]: unknown;
+}
+export interface LoginResult {
+    token: string;
+    [key: string]: unknown;
+}
+export interface RuleCategory {
+    id?: string;
+    name: string;
+    [key: string]: unknown;
+}
+export interface UserRoutes {
+    login: string;
+    currentUser: string;
+    users: string;
+    deleteUser: (username: string) => string;
+    ruleCategories: string;
+}
+export declare class UserAPI extends ExtendedApiBase {
+    private readonly routes;
+    constructor(options: ExtendedApiOptions & {
+        routes?: Partial<UserRoutes>;
+    });
+    login(username: string, password: string): Promise<LoginResult>;
+    getCurrentUser(): Promise<UserInfo>;
+    getUsers(): Promise<UserInfo[]>;
+    saveUser(user: UserInfo & {
+        password?: string;
+    }): Promise<void>;
+    deleteUser(username: string, purge?: boolean): Promise<void>;
+    getRuleCategories(): Promise<RuleCategory[]>;
+}

package/dist/api/extended-api-shared.d.ts

@@ -0,0 +1,25 @@
+export interface ExtendedApiOptions {
+    apiBase: string;
+    timeout?: number;
+    headers?: Record<string, string> | (() => Record<string, string>);
+    authToken?: string;
+    customFetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    credentials?: RequestCredentials;
+}
+export declare class ExtendedApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(message: string, status: number, url: string);
+}
+export declare class ExtendedApiBase {
+    protected readonly apiBase: string;
+    private readonly timeout;
+    private readonly headerSource;
+    private readonly authToken?;
+    private readonly fetchImpl?;
+    private readonly credentials?;
+    constructor(options: ExtendedApiOptions);
+    private getHeaders;
+    protected request<T = unknown>(path: string, init?: RequestInit): Promise<T>;
+    getApiBase(): string;
+}

package/dist/api/index.d.ts

@@ -1,9 +1,26 @@
 export { RuleChainAPI, RuleChainApiError } from './RuleChainAPI';
+export { RuleChainVersionsAPI } from './RuleChainVersionsAPI';
+export type { RuleChainVersionsAPIOptions, RuleChainVersionRoutes } from './RuleChainVersionsAPI';
+export { GlobalConfigAPI, GlobalConfigApiError } from './GlobalConfigAPI';
+export type { GlobalConfigTransportContext } from './GlobalConfigAPI';
 export { normalizePagedResponse, unwrapApiEnvelope } from './response-utils';
 export { DEFAULT_ROUTES } from './types';
-export type { WorkflowItem, PagedResponse, ListAllResult, ApiResult, SharedNode, SharedNodeFetcher, WorkflowFetcher, RuleChainAPIOptions, RuleChainRoutes, WorkflowListIcons, WorkflowInfoIcons, WorkflowTheme, RuleMaintenanceSeverity, RuleMaintenanceCategory, RuleMaintenanceIssue, RuleMaintenanceRuntimeInfo, RuleValidateUpstreamRequest, RuleValidateUpstreamResponse, RuleSchemaDiffResponse, RuleRepairPlanResponse, JSONPatchOperation, RulePatchPreviewResponse, ApiAuthRequiredDetails, ApiAuthRequiredHandler, ApiCacheKey, } from './types';
-export { ApiProvider, apiProvider, normalizeApiProviderBaseUrl, normalizeApiV1BaseUrl, type EditorApiConfig } from './ApiProvider';
+export type { WorkflowItem, PagedResponse, ListAllResult, ApiResult, SharedNode, SharedNodeFetcher, WorkflowFetcher, RuleChainAPIOptions, RuleChainRoutes, WorkflowListIcons, WorkflowInfoIcons, WorkflowTheme, RuleMaintenanceSeverity, RuleMaintenanceCategory, RuleMaintenanceIssue, RuleMaintenanceRuntimeInfo, RuleValidateUpstreamRequest, RuleValidateUpstreamResponse, RuleSchemaDiffResponse, RuleRepairPlanResponse, JSONPatchOperation, RulePatchPreviewResponse, ApiAuthRequiredDetails, ApiAuthRequiredHandler, ApiRequestHeaders, ApiCustomFetch, ApiCacheKey, RuleMessageBody, RuleMessageMetadata, RunsListOptions, RunRecord, ComponentDSL, RuleListOptions, } from './types';
+export { ApiProvider, apiProvider, getToken, clearToken, normalizeApiPrefix, normalizeApiProviderBaseUrl, normalizeApiV1BaseUrl, type EditorApiConfig } from './ApiProvider';
 export { ComponentCatalogCache, componentCatalogCache, type ComponentCatalogCacheOptions, type ComponentCatalogLoadOptions, } from './ComponentCatalogCache';
 export { AIManager, aiManager } from './AIManager';
+export type { AIManagerOptions } from './AIManager';
 export { DebugSocketClient } from './DebugSocketClient';
 export type { DebugSocketClientOptions } from './DebugSocketClient';
+export { ExtendedApiBase, ExtendedApiError } from './extended-api-shared';
+export type { ExtendedApiOptions } from './extended-api-shared';
+export { MarketplaceAPI } from './MarketplaceAPI';
+export type { MarketplaceComponent, MarketplaceChain, MarketplaceSearchParams, MarketplaceChainSearchParams, MarketplaceRoutes, } from './MarketplaceAPI';
+export { AIAssistantAPI, AI_ASSISTANT_DEFAULT_AGENT_ID } from './AIAssistantAPI';
+export type { AIAssistantSettings, AIAssistantModelConfig, AIAssistantRoutes, } from './AIAssistantAPI';
+export { SkillsAPI } from './SkillsAPI';
+export type { SkillItem, SkillsRoutes } from './SkillsAPI';
+export { IoTPointTemplateAPI } from './IoTPointTemplateAPI';
+export type { PointTemplate, PointTemplateListParams, IoTPointTemplateRoutes, } from './IoTPointTemplateAPI';
+export { UserAPI } from './UserAPI';
+export type { UserInfo, LoginResult, RuleCategory, UserRoutes } from './UserAPI';

package/dist/api/public-api.test-d.d.ts

@@ -0,0 +1,87 @@
+import type * as Root from '../index';
+import type * as Api from './index';
+type Assert<T extends true> = T;
+type Equal<A, B> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? true : false;
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type LegacyMethods = 'list' | 'create' | 'remove' | 'operate' | 'copy' | 'getContent' | 'saveBaseInfo' | 'saveConfig';
+type LegacyHost = Omit<Pick<Root.WorkflowFetcher, LegacyMethods>, 'list' | 'getContent'> & {
+    list: (page: number, size: number, keywords: string) => Promise<Root.PagedResponse<Root.WorkflowItem>>;
+    getContent: (id: string) => Promise<Record<string, unknown>>;
+};
+type LegacySharedHost = {
+    getSharedNodes: (keywords: string, page: number, size: number, type?: string) => Promise<Root.PagedResponse<Root.SharedNode>>;
+    getSharedNode: (id: string, type: string) => Promise<Root.SharedNode>;
+    saveSharedNode: (id: string, type: string, body: Root.SharedNode) => Promise<unknown>;
+    deleteSharedNode: (id: string, type: string) => Promise<unknown>;
+};
+type OptionalMethods = 'notifyRule' | 'executeRule' | 'listFiltered' | 'getRuleCategories' | 'getDebugData' | 'getRunsList' | 'getRuns' | 'deleteRuns' | 'getComponentDSL' | 'installComponent' | 'uninstallComponent' | 'queryDynamicBuiltin';
+type MethodMatches = {
+    [K in OptionalMethods]: Equal<NonNullable<Root.WorkflowFetcher[K]>, Root.RuleChainAPI[K]>;
+};
+export type BackwardCompatibleFetcher = Assert<Equal<RequiredKeys<Root.WorkflowFetcher>, LegacyMethods>>;
+export type MinimalHostStillWorks = Assert<LegacyHost extends Root.WorkflowFetcher ? true : false>;
+export type LegacySharedHostStillWorks = Assert<LegacySharedHost extends Root.SharedNodeFetcher ? true : false>;
+export type ImplementationIsSharedFetcher = Assert<Root.RuleChainAPI extends Root.SharedNodeFetcher ? true : false>;
+export type SharedListSignal = Assert<Equal<Parameters<Root.SharedNodeFetcher['getSharedNodes']>, [string, number, number, string?, AbortSignal?]>>;
+export type SharedGetSignal = Assert<Equal<Parameters<Root.SharedNodeFetcher['getSharedNode']>, [string, string, AbortSignal?]>>;
+export type SharedSaveSignal = Assert<Equal<Parameters<Root.SharedNodeFetcher['saveSharedNode']>, [string, string, Root.SharedNode, AbortSignal?]>>;
+export type SharedDeleteSignal = Assert<Equal<Parameters<Root.SharedNodeFetcher['deleteSharedNode']>, [string, string, AbortSignal?]>>;
+export type HostListSignal = Assert<Equal<Parameters<Root.WorkflowFetcher['list']>, [number, number, string, AbortSignal?]>>;
+export type ApiListSignal = Assert<Equal<Parameters<Root.RuleChainAPI['list']>, [number?, number?, string?, AbortSignal?]>>;
+export type HostContentSignal = Assert<Equal<Parameters<Root.WorkflowFetcher['getContent']>, [string, AbortSignal?]>>;
+export type ContentMatchesImplementation = Assert<Equal<Root.WorkflowFetcher['getContent'], Root.RuleChainAPI['getContent']>>;
+export type MethodsMatchImplementation = Assert<Equal<MethodMatches[OptionalMethods], true>>;
+export type ImplementationIsFetcher = Assert<Root.RuleChainAPI extends Root.WorkflowFetcher ? true : false>;
+export type DefaultRoutesAreCallable = Assert<Equal<Exclude<'notifyRule' | 'executeRule' | 'ruleCategories' | 'debugData' | 'runsList' | 'dynamicComponent' | 'queryDynamicBuiltin', RequiredKeys<typeof Root.DEFAULT_ROUTES>>, never>>;
+export type RootAndApiTypesMatch = Assert<Equal<[
+    Root.WorkflowFetcher,
+    Root.RuleChainRoutes,
+    Root.RuleChainAPIOptions,
+    Root.RuleMessageBody,
+    Root.RuleMessageMetadata,
+    Root.RuleListOptions,
+    Root.RunsListOptions,
+    Root.RunRecord,
+    Root.ComponentDSL,
+    Root.ApiRequestHeaders,
+    Root.ApiCustomFetch,
+    Root.SharedNodeFetcher,
+    Root.GlobalConfigTransportContext,
+    Root.RuleChainVersionsAPIOptions,
+    Root.RuleChainVersionRoutes
+], [
+    Api.WorkflowFetcher,
+    Api.RuleChainRoutes,
+    Api.RuleChainAPIOptions,
+    Api.RuleMessageBody,
+    Api.RuleMessageMetadata,
+    Api.RuleListOptions,
+    Api.RunsListOptions,
+    Api.RunRecord,
+    Api.ComponentDSL,
+    Api.ApiRequestHeaders,
+    Api.ApiCustomFetch,
+    Api.SharedNodeFetcher,
+    Api.GlobalConfigTransportContext,
+    Api.RuleChainVersionsAPIOptions,
+    Api.RuleChainVersionRoutes
+]>>;
+export type RootAndApiValuesMatch = Assert<Equal<[
+    typeof Root.RuleChainAPI,
+    typeof Root.RuleChainApiError,
+    typeof Root.DEFAULT_ROUTES,
+    typeof Root.GlobalConfigAPI,
+    typeof Root.GlobalConfigApiError,
+    typeof Root.RuleChainVersionsAPI
+], [
+    typeof Api.RuleChainAPI,
+    typeof Api.RuleChainApiError,
+    typeof Api.DEFAULT_ROUTES,
+    typeof Api.GlobalConfigAPI,
+    typeof Api.GlobalConfigApiError,
+    typeof Api.RuleChainVersionsAPI
+]>>;
+export type ConfigIsTransport = Assert<Equal<NonNullable<Root.RuleMessageBody['config']>, Omit<RequestInit, 'method' | 'body'>>>;
+export {};

package/dist/api/response-utils.d.ts

@@ -1,6 +1,7 @@
 export declare function unwrapApiEnvelope<T = unknown>(raw: unknown): T;
 export declare function normalizePagedResponse<T>(raw: unknown, mapItem: (item: unknown) => T, fallbackPage?: number, fallbackPageSize?: number, options?: {
     includeMetadata?: boolean;
+    strict?: boolean;
 }): {
     items: T[];
     total: number;