@knotx/core 0.2.5 → 0.2.6

package/dist/definition.d.cts

@@ -1,3 +1,4 @@
+import 'jsonschema';
 import 'rxjs';
-export { C as Container, E as EdgeData, o as EdgeOperation, m as EdgeOperationPipe, q as EdgeOperatorFunction, i as EdgeProps, d as EdgeRenderType, H as HorizontalAlignment, I as IEngineRuntime, a as IPlugin, b as Layer, L as LayerComponent, N as NodeData, g as NodeMeasured, n as NodeOperation, l as NodeOperationPipe, p as NodeOperatorFunction, f as NodePosition, h as NodeProps, c as NodeRenderType, P as Plugin, k as PluginConfigs, e as PluginData, j as Position, R as RenderType, V as VerticalAlignment } from './shared/core.BKaZlwmj.cjs';
+export { C as Container, E as EdgeData, r as EdgeOperation, p as EdgeOperationPipe, t as EdgeOperatorFunction, l as EdgeProps, d as EdgeRenderType, H as HorizontalAlignment, I as IEngineRuntime, a as IPlugin, g as IPluginInfo, h as IPluginToolInfo, b as Layer, L as LayerComponent, N as NodeData, j as NodeMeasured, q as NodeOperation, o as NodeOperationPipe, s as NodeOperatorFunction, i as NodePosition, k as NodeProps, c as NodeRenderType, P as Plugin, n as PluginConfigs, e as PluginData, f as PluginTools, m as Position, R as RenderType, V as VerticalAlignment } from './shared/core.BUBec6Va.cjs';
 import '@knotx/data';

package/dist/definition.d.mts

@@ -1,3 +1,4 @@
+import 'jsonschema';
 import 'rxjs';
-export { C as Container, E as EdgeData, o as EdgeOperation, m as EdgeOperationPipe, q as EdgeOperatorFunction, i as EdgeProps, d as EdgeRenderType, H as HorizontalAlignment, I as IEngineRuntime, a as IPlugin, b as Layer, L as LayerComponent, N as NodeData, g as NodeMeasured, n as NodeOperation, l as NodeOperationPipe, p as NodeOperatorFunction, f as NodePosition, h as NodeProps, c as NodeRenderType, P as Plugin, k as PluginConfigs, e as PluginData, j as Position, R as RenderType, V as VerticalAlignment } from './shared/core.BKaZlwmj.mjs';
+export { C as Container, E as EdgeData, r as EdgeOperation, p as EdgeOperationPipe, t as EdgeOperatorFunction, l as EdgeProps, d as EdgeRenderType, H as HorizontalAlignment, I as IEngineRuntime, a as IPlugin, g as IPluginInfo, h as IPluginToolInfo, b as Layer, L as LayerComponent, N as NodeData, j as NodeMeasured, q as NodeOperation, o as NodeOperationPipe, s as NodeOperatorFunction, i as NodePosition, k as NodeProps, c as NodeRenderType, P as Plugin, n as PluginConfigs, e as PluginData, f as PluginTools, m as Position, R as RenderType, V as VerticalAlignment } from './shared/core.BUBec6Va.mjs';
 import '@knotx/data';

package/dist/definition.d.ts

@@ -1,3 +1,4 @@
+import 'jsonschema';
 import 'rxjs';
-export { C as Container, E as EdgeData, o as EdgeOperation, m as EdgeOperationPipe, q as EdgeOperatorFunction, i as EdgeProps, d as EdgeRenderType, H as HorizontalAlignment, I as IEngineRuntime, a as IPlugin, b as Layer, L as LayerComponent, N as NodeData, g as NodeMeasured, n as NodeOperation, l as NodeOperationPipe, p as NodeOperatorFunction, f as NodePosition, h as NodeProps, c as NodeRenderType, P as Plugin, k as PluginConfigs, e as PluginData, j as Position, R as RenderType, V as VerticalAlignment } from './shared/core.BKaZlwmj.js';
+export { C as Container, E as EdgeData, r as EdgeOperation, p as EdgeOperationPipe, t as EdgeOperatorFunction, l as EdgeProps, d as EdgeRenderType, H as HorizontalAlignment, I as IEngineRuntime, a as IPlugin, g as IPluginInfo, h as IPluginToolInfo, b as Layer, L as LayerComponent, N as NodeData, j as NodeMeasured, q as NodeOperation, o as NodeOperationPipe, s as NodeOperatorFunction, i as NodePosition, k as NodeProps, c as NodeRenderType, P as Plugin, n as PluginConfigs, e as PluginData, f as PluginTools, m as Position, R as RenderType, V as VerticalAlignment } from './shared/core.BUBec6Va.js';
 import '@knotx/data';

package/dist/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 const definition = require('./definition.cjs');
+const jsonschema = require('jsonschema');
 const lodashEs = require('lodash-es');
 const rxjs = require('rxjs');
 const core = require('@knotx/core');
@@ -148,6 +149,8 @@ class Engine {
     __publicField$2(this, "nodeRenderers$", new rxjs.BehaviorSubject(/* @__PURE__ */ new Map()));
     __publicField$2(this, "edgeRenderers$", new rxjs.BehaviorSubject(/* @__PURE__ */ new Map()));
     __publicField$2(this, "_pluginDataContainer", {});
+    __publicField$2(this, "toolParamsValidator", new jsonschema.Validator());
+    __publicField$2(this, "_pluginToolsContainer", {});
     var _a;
     this.runtime = (_a = options.runtime) != null ? _a : {};
     this.container$.next(options.container);
@@ -184,6 +187,7 @@ class Engine {
         continue;
       }
       this._pluginDataContainer[plugin.name] = {};
+      this._pluginToolsContainer[plugin.name] = {};
       const engineSymbol = utils.getSymbol("engine");
       if (!Reflect.has(plugin, engineSymbol)) {
         Reflect.set(plugin, engineSymbol, new rxjs.BehaviorSubject(null));
@@ -258,6 +262,15 @@ class Engine {
   registerPluginData(pluginName, property, data) {
     lodashEs.set(this, ["_pluginDataContainer", pluginName, property], data);
   }
+  resetPluginData(pluginName) {
+    lodashEs.set(this, ["_pluginDataContainer", pluginName], void 0);
+  }
+  registerPluginTool(pluginName, property, data) {
+    lodashEs.set(this, ["_pluginToolsContainer", pluginName, property], data);
+  }
+  resetPluginTool(pluginName) {
+    lodashEs.set(this, ["_pluginToolsContainer", pluginName], void 0);
+  }
   registerNodeRenderer(type, renderer) {
     const nodeRenderers = this.nodeRenderers$.value;
     nodeRenderers.set(type, renderer);
@@ -287,6 +300,54 @@ class Engine {
   endInteraction(pluginId, type) {
     this.interactionManager.endInteraction(pluginId, type);
   }
+  callTool(pluginName, toolName, params) {
+    const toolDefinition = lodashEs.get(this, ["_pluginToolsContainer", pluginName, toolName]);
+    const tool = toolDefinition == null ? void 0 : toolDefinition.func;
+    if (!tool || typeof tool !== "function") {
+      throw new Error(`Tool ${String(toolName)} not found in plugin ${pluginName}`);
+    }
+    const validator = this.toolParamsValidator.validate(params, toolDefinition.params);
+    if (validator.errors.length > 0) {
+      throw new Error(`Invalid tool params: ${validator.errors.map((e) => e.stack).join(", ")}`);
+    }
+    return tool(params);
+  }
+  listPlugins() {
+    return this.plugins$.value.map((plugin) => ({
+      name: plugin.name,
+      description: plugin.description
+    }));
+  }
+  listPluginTools(pluginName) {
+    return Object.entries(lodashEs.get(this, ["_pluginToolsContainer", pluginName]) || {}).map(([toolName, toolDefinition]) => ({
+      type: "function",
+      name: toolName,
+      description: toolDefinition.description,
+      parameters: toolDefinition.params
+    }));
+  }
+  listEngineTools() {
+    return [
+      {
+        type: "function",
+        name: "listPlugins",
+        description: "List all plugins",
+        parameters: {}
+      },
+      {
+        type: "function",
+        name: "listPluginTools",
+        description: "List all tools of a plugin",
+        parameters: {
+          type: "object",
+          properties: {
+            pluginName: { type: "string" }
+          },
+          required: ["pluginName"]
+        }
+      }
+    ];
+  }
   destroy() {
     this.plugins$.value.forEach((plugin) => {
       var _a;
@@ -299,6 +360,8 @@ class Engine {
     this.edges$.complete();
     this.nodeRenderers$.complete();
     this.edgeRenderers$.complete();
+    this._pluginToolsContainer = {};
+    this._pluginDataContainer = {};
   }
 }
 
@@ -319,7 +382,6 @@ const _BasePlugin = class _BasePlugin {
     return `${this.name}:${this._instanceId}`;
   }
   onDestroy() {
-    var _a;
     this.subscriptions.forEach((subscription) => {
       if (typeof subscription === "function") {
         subscription();
@@ -327,7 +389,10 @@ const _BasePlugin = class _BasePlugin {
         subscription.unsubscribe();
       }
     });
-    (_a = Reflect.get(this, utils.getSymbol("engine"))) == null ? void 0 : _a.complete();
+    const engin$ = Reflect.get(this, utils.getSymbol("engine"));
+    engin$.value.resetPluginData(this.name);
+    engin$.value.resetPluginTool(this.name);
+    engin$.complete();
   }
 };
 __publicField$1(_BasePlugin, "_instanceId", 0);

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { C as Container, P as Plugin, N as NodeData, E as EdgeData, I as IEngineRuntime, R as RenderType, L as LayerComponent, a as IPlugin, b as Layer, c as NodeRenderType, d as EdgeRenderType, e as PluginData } from './shared/core.BKaZlwmj.cjs';
-export { B as BasePlugin, o as EdgeOperation, m as EdgeOperationPipe, q as EdgeOperatorFunction, i as EdgeProps, H as HorizontalAlignment, g as NodeMeasured, n as NodeOperation, l as NodeOperationPipe, p as NodeOperatorFunction, f as NodePosition, h as NodeProps, k as PluginConfigs, j as Position, V as VerticalAlignment } from './shared/core.BKaZlwmj.cjs';
+import { C as Container, P as Plugin, N as NodeData, E as EdgeData, I as IEngineRuntime, R as RenderType, L as LayerComponent, a as IPlugin, b as Layer, c as NodeRenderType, d as EdgeRenderType, e as PluginData, f as PluginTools, g as IPluginInfo, h as IPluginToolInfo } from './shared/core.BUBec6Va.cjs';
+export { B as BasePlugin, r as EdgeOperation, p as EdgeOperationPipe, t as EdgeOperatorFunction, l as EdgeProps, H as HorizontalAlignment, j as NodeMeasured, q as NodeOperation, o as NodeOperationPipe, s as NodeOperatorFunction, i as NodePosition, k as NodeProps, n as PluginConfigs, m as Position, V as VerticalAlignment } from './shared/core.BUBec6Va.cjs';
+import { Schema } from 'jsonschema';
 import { BehaviorSubject } from 'rxjs';
 import { DataManager, DataOperationPipe, DataOperation } from '@knotx/data';
 export * from '@knotx/data';
@@ -105,6 +106,8 @@ declare class Engine<TRenderType extends RenderType = RenderType> {
     private nodeRenderers$;
     private edgeRenderers$;
     private _pluginDataContainer;
+    private toolParamsValidator;
+    private _pluginToolsContainer;
     get container(): Container;
     set container(value: Container);
     get nodes(): NodeData<any>[];
@@ -129,11 +132,22 @@ declare class Engine<TRenderType extends RenderType = RenderType> {
     getEdges(): EdgeData[];
     getEdgeRenderer(type: string): EdgeRenderType | undefined;
     registerPluginData<T extends keyof PluginData, TP extends keyof PluginData[T]>(pluginName: T, property: TP, data: BehaviorSubject<PluginData[T][TP]>): void;
+    resetPluginData<T extends keyof PluginData>(pluginName: T): void;
+    registerPluginTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, property: TP, data: {
+        description: string;
+        params: Schema;
+        func: PluginTools[T][TP];
+    }): void;
+    resetPluginTool<T extends keyof PluginTools>(pluginName: T): void;
     registerNodeRenderer(type: string, renderer: NodeRenderType): () => void;
     registerEdgeRenderer(type: string, renderer: EdgeRenderType): (() => void);
     canInteract(pluginId: string, type: string, autoStartPriority?: InteractionPriority): boolean;
     startInteraction(pluginId: string, type: string, priority: InteractionPriority): void;
     endInteraction(pluginId: string, type: string): void;
+    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, params: any): any;
+    listPlugins(): IPluginInfo[];
+    listPluginTools(pluginName: string): IPluginToolInfo[];
+    listEngineTools(): IPluginToolInfo[];
     destroy(): void;
 }
 
@@ -200,4 +214,4 @@ declare function use<T, TContext>(hook: () => {
     __contextValue__: TContext;
 }, context: TContext): T;
 
-export { Container, EdgeData, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, NodeData, NodeRenderType, Plugin, PluginData, RenderType, Runtime, getLayerRenders, use };
+export { Container, EdgeData, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, NodeData, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { C as Container, P as Plugin, N as NodeData, E as EdgeData, I as IEngineRuntime, R as RenderType, L as LayerComponent, a as IPlugin, b as Layer, c as NodeRenderType, d as EdgeRenderType, e as PluginData } from './shared/core.BKaZlwmj.mjs';
-export { B as BasePlugin, o as EdgeOperation, m as EdgeOperationPipe, q as EdgeOperatorFunction, i as EdgeProps, H as HorizontalAlignment, g as NodeMeasured, n as NodeOperation, l as NodeOperationPipe, p as NodeOperatorFunction, f as NodePosition, h as NodeProps, k as PluginConfigs, j as Position, V as VerticalAlignment } from './shared/core.BKaZlwmj.mjs';
+import { C as Container, P as Plugin, N as NodeData, E as EdgeData, I as IEngineRuntime, R as RenderType, L as LayerComponent, a as IPlugin, b as Layer, c as NodeRenderType, d as EdgeRenderType, e as PluginData, f as PluginTools, g as IPluginInfo, h as IPluginToolInfo } from './shared/core.BUBec6Va.mjs';
+export { B as BasePlugin, r as EdgeOperation, p as EdgeOperationPipe, t as EdgeOperatorFunction, l as EdgeProps, H as HorizontalAlignment, j as NodeMeasured, q as NodeOperation, o as NodeOperationPipe, s as NodeOperatorFunction, i as NodePosition, k as NodeProps, n as PluginConfigs, m as Position, V as VerticalAlignment } from './shared/core.BUBec6Va.mjs';
+import { Schema } from 'jsonschema';
 import { BehaviorSubject } from 'rxjs';
 import { DataManager, DataOperationPipe, DataOperation } from '@knotx/data';
 export * from '@knotx/data';
@@ -105,6 +106,8 @@ declare class Engine<TRenderType extends RenderType = RenderType> {
     private nodeRenderers$;
     private edgeRenderers$;
     private _pluginDataContainer;
+    private toolParamsValidator;
+    private _pluginToolsContainer;
     get container(): Container;
     set container(value: Container);
     get nodes(): NodeData<any>[];
@@ -129,11 +132,22 @@ declare class Engine<TRenderType extends RenderType = RenderType> {
     getEdges(): EdgeData[];
     getEdgeRenderer(type: string): EdgeRenderType | undefined;
     registerPluginData<T extends keyof PluginData, TP extends keyof PluginData[T]>(pluginName: T, property: TP, data: BehaviorSubject<PluginData[T][TP]>): void;
+    resetPluginData<T extends keyof PluginData>(pluginName: T): void;
+    registerPluginTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, property: TP, data: {
+        description: string;
+        params: Schema;
+        func: PluginTools[T][TP];
+    }): void;
+    resetPluginTool<T extends keyof PluginTools>(pluginName: T): void;
     registerNodeRenderer(type: string, renderer: NodeRenderType): () => void;
     registerEdgeRenderer(type: string, renderer: EdgeRenderType): (() => void);
     canInteract(pluginId: string, type: string, autoStartPriority?: InteractionPriority): boolean;
     startInteraction(pluginId: string, type: string, priority: InteractionPriority): void;
     endInteraction(pluginId: string, type: string): void;
+    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, params: any): any;
+    listPlugins(): IPluginInfo[];
+    listPluginTools(pluginName: string): IPluginToolInfo[];
+    listEngineTools(): IPluginToolInfo[];
     destroy(): void;
 }
 
@@ -200,4 +214,4 @@ declare function use<T, TContext>(hook: () => {
     __contextValue__: TContext;
 }, context: TContext): T;
 
-export { Container, EdgeData, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, NodeData, NodeRenderType, Plugin, PluginData, RenderType, Runtime, getLayerRenders, use };
+export { Container, EdgeData, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, NodeData, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { C as Container, P as Plugin, N as NodeData, E as EdgeData, I as IEngineRuntime, R as RenderType, L as LayerComponent, a as IPlugin, b as Layer, c as NodeRenderType, d as EdgeRenderType, e as PluginData } from './shared/core.BKaZlwmj.js';
-export { B as BasePlugin, o as EdgeOperation, m as EdgeOperationPipe, q as EdgeOperatorFunction, i as EdgeProps, H as HorizontalAlignment, g as NodeMeasured, n as NodeOperation, l as NodeOperationPipe, p as NodeOperatorFunction, f as NodePosition, h as NodeProps, k as PluginConfigs, j as Position, V as VerticalAlignment } from './shared/core.BKaZlwmj.js';
+import { C as Container, P as Plugin, N as NodeData, E as EdgeData, I as IEngineRuntime, R as RenderType, L as LayerComponent, a as IPlugin, b as Layer, c as NodeRenderType, d as EdgeRenderType, e as PluginData, f as PluginTools, g as IPluginInfo, h as IPluginToolInfo } from './shared/core.BUBec6Va.js';
+export { B as BasePlugin, r as EdgeOperation, p as EdgeOperationPipe, t as EdgeOperatorFunction, l as EdgeProps, H as HorizontalAlignment, j as NodeMeasured, q as NodeOperation, o as NodeOperationPipe, s as NodeOperatorFunction, i as NodePosition, k as NodeProps, n as PluginConfigs, m as Position, V as VerticalAlignment } from './shared/core.BUBec6Va.js';
+import { Schema } from 'jsonschema';
 import { BehaviorSubject } from 'rxjs';
 import { DataManager, DataOperationPipe, DataOperation } from '@knotx/data';
 export * from '@knotx/data';
@@ -105,6 +106,8 @@ declare class Engine<TRenderType extends RenderType = RenderType> {
     private nodeRenderers$;
     private edgeRenderers$;
     private _pluginDataContainer;
+    private toolParamsValidator;
+    private _pluginToolsContainer;
     get container(): Container;
     set container(value: Container);
     get nodes(): NodeData<any>[];
@@ -129,11 +132,22 @@ declare class Engine<TRenderType extends RenderType = RenderType> {
     getEdges(): EdgeData[];
     getEdgeRenderer(type: string): EdgeRenderType | undefined;
     registerPluginData<T extends keyof PluginData, TP extends keyof PluginData[T]>(pluginName: T, property: TP, data: BehaviorSubject<PluginData[T][TP]>): void;
+    resetPluginData<T extends keyof PluginData>(pluginName: T): void;
+    registerPluginTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, property: TP, data: {
+        description: string;
+        params: Schema;
+        func: PluginTools[T][TP];
+    }): void;
+    resetPluginTool<T extends keyof PluginTools>(pluginName: T): void;
     registerNodeRenderer(type: string, renderer: NodeRenderType): () => void;
     registerEdgeRenderer(type: string, renderer: EdgeRenderType): (() => void);
     canInteract(pluginId: string, type: string, autoStartPriority?: InteractionPriority): boolean;
     startInteraction(pluginId: string, type: string, priority: InteractionPriority): void;
     endInteraction(pluginId: string, type: string): void;
+    callTool<T extends keyof PluginTools, TP extends keyof PluginTools[T]>(pluginName: T, toolName: TP, params: any): any;
+    listPlugins(): IPluginInfo[];
+    listPluginTools(pluginName: string): IPluginToolInfo[];
+    listEngineTools(): IPluginToolInfo[];
     destroy(): void;
 }
 
@@ -200,4 +214,4 @@ declare function use<T, TContext>(hook: () => {
     __contextValue__: TContext;
 }, context: TContext): T;
 
-export { Container, EdgeData, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, NodeData, NodeRenderType, Plugin, PluginData, RenderType, Runtime, getLayerRenders, use };
+export { Container, EdgeData, EdgeRenderType, Engine, type EngineOptions, IEngineRuntime, IPlugin, IPluginInfo, IPluginToolInfo, type Interaction, InteractionManager, InteractionPriority, Layer, LayerComponent, NodeData, NodeRenderType, Plugin, PluginData, PluginTools, RenderType, Runtime, getLayerRenders, use };

package/dist/index.js

@@ -1,4 +1,5 @@
 export { Layer } from './definition.js';
+import { Validator } from 'jsonschema';
 import { set, get } from 'lodash-es';
 import { BehaviorSubject, identity } from 'rxjs';
 import { Layer } from '@knotx/core';
@@ -148,6 +149,8 @@ class Engine {
     __publicField$2(this, "nodeRenderers$", new BehaviorSubject(/* @__PURE__ */ new Map()));
     __publicField$2(this, "edgeRenderers$", new BehaviorSubject(/* @__PURE__ */ new Map()));
     __publicField$2(this, "_pluginDataContainer", {});
+    __publicField$2(this, "toolParamsValidator", new Validator());
+    __publicField$2(this, "_pluginToolsContainer", {});
     var _a;
     this.runtime = (_a = options.runtime) != null ? _a : {};
     this.container$.next(options.container);
@@ -184,6 +187,7 @@ class Engine {
         continue;
       }
       this._pluginDataContainer[plugin.name] = {};
+      this._pluginToolsContainer[plugin.name] = {};
       const engineSymbol = getSymbol("engine");
       if (!Reflect.has(plugin, engineSymbol)) {
         Reflect.set(plugin, engineSymbol, new BehaviorSubject(null));
@@ -258,6 +262,15 @@ class Engine {
   registerPluginData(pluginName, property, data) {
     set(this, ["_pluginDataContainer", pluginName, property], data);
   }
+  resetPluginData(pluginName) {
+    set(this, ["_pluginDataContainer", pluginName], void 0);
+  }
+  registerPluginTool(pluginName, property, data) {
+    set(this, ["_pluginToolsContainer", pluginName, property], data);
+  }
+  resetPluginTool(pluginName) {
+    set(this, ["_pluginToolsContainer", pluginName], void 0);
+  }
   registerNodeRenderer(type, renderer) {
     const nodeRenderers = this.nodeRenderers$.value;
     nodeRenderers.set(type, renderer);
@@ -287,6 +300,54 @@ class Engine {
   endInteraction(pluginId, type) {
     this.interactionManager.endInteraction(pluginId, type);
   }
+  callTool(pluginName, toolName, params) {
+    const toolDefinition = get(this, ["_pluginToolsContainer", pluginName, toolName]);
+    const tool = toolDefinition == null ? void 0 : toolDefinition.func;
+    if (!tool || typeof tool !== "function") {
+      throw new Error(`Tool ${String(toolName)} not found in plugin ${pluginName}`);
+    }
+    const validator = this.toolParamsValidator.validate(params, toolDefinition.params);
+    if (validator.errors.length > 0) {
+      throw new Error(`Invalid tool params: ${validator.errors.map((e) => e.stack).join(", ")}`);
+    }
+    return tool(params);
+  }
+  listPlugins() {
+    return this.plugins$.value.map((plugin) => ({
+      name: plugin.name,
+      description: plugin.description
+    }));
+  }
+  listPluginTools(pluginName) {
+    return Object.entries(get(this, ["_pluginToolsContainer", pluginName]) || {}).map(([toolName, toolDefinition]) => ({
+      type: "function",
+      name: toolName,
+      description: toolDefinition.description,
+      parameters: toolDefinition.params
+    }));
+  }
+  listEngineTools() {
+    return [
+      {
+        type: "function",
+        name: "listPlugins",
+        description: "List all plugins",
+        parameters: {}
+      },
+      {
+        type: "function",
+        name: "listPluginTools",
+        description: "List all tools of a plugin",
+        parameters: {
+          type: "object",
+          properties: {
+            pluginName: { type: "string" }
+          },
+          required: ["pluginName"]
+        }
+      }
+    ];
+  }
   destroy() {
     this.plugins$.value.forEach((plugin) => {
       var _a;
@@ -299,6 +360,8 @@ class Engine {
     this.edges$.complete();
     this.nodeRenderers$.complete();
     this.edgeRenderers$.complete();
+    this._pluginToolsContainer = {};
+    this._pluginDataContainer = {};
   }
 }
 
@@ -319,7 +382,6 @@ const _BasePlugin = class _BasePlugin {
     return `${this.name}:${this._instanceId}`;
   }
   onDestroy() {
-    var _a;
     this.subscriptions.forEach((subscription) => {
       if (typeof subscription === "function") {
         subscription();
@@ -327,7 +389,10 @@ const _BasePlugin = class _BasePlugin {
         subscription.unsubscribe();
       }
     });
-    (_a = Reflect.get(this, getSymbol("engine"))) == null ? void 0 : _a.complete();
+    const engin$ = Reflect.get(this, getSymbol("engine"));
+    engin$.value.resetPluginData(this.name);
+    engin$.value.resetPluginTool(this.name);
+    engin$.complete();
   }
 };
 __publicField$1(_BasePlugin, "_instanceId", 0);

package/dist/shared/{core.BKaZlwmj.d.cts → core.BUBec6Va.d.cts}

@@ -1,3 +1,4 @@
+import { Schema } from 'jsonschema';
 import { SubscriptionLike, BehaviorSubject } from 'rxjs';
 import { DataOperationPipe, DataOperation } from '@knotx/data';
 
@@ -79,6 +80,7 @@ interface LayerComponent<TRenderType> {
 interface IPlugin<TPluginName extends string = string, TPluginConfig extends Record<string, any> | undefined = any, TRenderType extends RenderType = RenderType> {
     name: TPluginName;
     pluginId: string;
+    description?: string;
     onInit?: (config: TPluginConfig) => void;
     onConfigChange?: (config: TPluginConfig) => void;
     onDestroy?: () => void;
@@ -101,6 +103,29 @@ type PluginConfigs<TPlugins extends Plugin[]> = ((TPlugins[number] extends Plugi
  */
 interface PluginData {
 }
+/**
+ * plugin tools host
+ * @example
+ * `declare module '@knotx/core' {
+ *   interface PluginTools {
+ *     pluginName: {
+ *       toolName: (params: any) => any
+ *     }
+ *   }
+ * }`
+ */
+interface PluginTools {
+}
+interface IPluginInfo {
+    name: string;
+    description?: string;
+}
+interface IPluginToolInfo {
+    type: 'function';
+    name: string;
+    description: string;
+    parameters: Schema;
+}
 type NodeOperationPipe<T = any> = DataOperationPipe<NodeData<T>>;
 type EdgeOperationPipe<T = any> = DataOperationPipe<EdgeData<T>>;
 type NodeOperation<T = any> = DataOperation<NodeData<T>>;
@@ -117,4 +142,4 @@ interface IEngineRuntime {
     };
 }
 
-export { BasePlugin as B, type Container as C, type EdgeData as E, type HorizontalAlignment as H, type IEngineRuntime as I, type LayerComponent as L, type NodeData as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IPlugin as a, Layer as b, type NodeRenderType as c, type EdgeRenderType as d, type PluginData as e, type NodePosition as f, type NodeMeasured as g, type NodeProps as h, type EdgeProps as i, type Position as j, type PluginConfigs as k, type NodeOperationPipe as l, type EdgeOperationPipe as m, type NodeOperation as n, type EdgeOperation as o, type NodeOperatorFunction as p, type EdgeOperatorFunction as q };
+export { BasePlugin as B, type Container as C, type EdgeData as E, type HorizontalAlignment as H, type IEngineRuntime as I, type LayerComponent as L, type NodeData as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IPlugin as a, Layer as b, type NodeRenderType as c, type EdgeRenderType as d, type PluginData as e, type PluginTools as f, type IPluginInfo as g, type IPluginToolInfo as h, type NodePosition as i, type NodeMeasured as j, type NodeProps as k, type EdgeProps as l, type Position as m, type PluginConfigs as n, type NodeOperationPipe as o, type EdgeOperationPipe as p, type NodeOperation as q, type EdgeOperation as r, type NodeOperatorFunction as s, type EdgeOperatorFunction as t };

package/dist/shared/{core.BKaZlwmj.d.mts → core.BUBec6Va.d.mts}

@@ -1,3 +1,4 @@
+import { Schema } from 'jsonschema';
 import { SubscriptionLike, BehaviorSubject } from 'rxjs';
 import { DataOperationPipe, DataOperation } from '@knotx/data';
 
@@ -79,6 +80,7 @@ interface LayerComponent<TRenderType> {
 interface IPlugin<TPluginName extends string = string, TPluginConfig extends Record<string, any> | undefined = any, TRenderType extends RenderType = RenderType> {
     name: TPluginName;
     pluginId: string;
+    description?: string;
     onInit?: (config: TPluginConfig) => void;
     onConfigChange?: (config: TPluginConfig) => void;
     onDestroy?: () => void;
@@ -101,6 +103,29 @@ type PluginConfigs<TPlugins extends Plugin[]> = ((TPlugins[number] extends Plugi
  */
 interface PluginData {
 }
+/**
+ * plugin tools host
+ * @example
+ * `declare module '@knotx/core' {
+ *   interface PluginTools {
+ *     pluginName: {
+ *       toolName: (params: any) => any
+ *     }
+ *   }
+ * }`
+ */
+interface PluginTools {
+}
+interface IPluginInfo {
+    name: string;
+    description?: string;
+}
+interface IPluginToolInfo {
+    type: 'function';
+    name: string;
+    description: string;
+    parameters: Schema;
+}
 type NodeOperationPipe<T = any> = DataOperationPipe<NodeData<T>>;
 type EdgeOperationPipe<T = any> = DataOperationPipe<EdgeData<T>>;
 type NodeOperation<T = any> = DataOperation<NodeData<T>>;
@@ -117,4 +142,4 @@ interface IEngineRuntime {
     };
 }
 
-export { BasePlugin as B, type Container as C, type EdgeData as E, type HorizontalAlignment as H, type IEngineRuntime as I, type LayerComponent as L, type NodeData as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IPlugin as a, Layer as b, type NodeRenderType as c, type EdgeRenderType as d, type PluginData as e, type NodePosition as f, type NodeMeasured as g, type NodeProps as h, type EdgeProps as i, type Position as j, type PluginConfigs as k, type NodeOperationPipe as l, type EdgeOperationPipe as m, type NodeOperation as n, type EdgeOperation as o, type NodeOperatorFunction as p, type EdgeOperatorFunction as q };
+export { BasePlugin as B, type Container as C, type EdgeData as E, type HorizontalAlignment as H, type IEngineRuntime as I, type LayerComponent as L, type NodeData as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IPlugin as a, Layer as b, type NodeRenderType as c, type EdgeRenderType as d, type PluginData as e, type PluginTools as f, type IPluginInfo as g, type IPluginToolInfo as h, type NodePosition as i, type NodeMeasured as j, type NodeProps as k, type EdgeProps as l, type Position as m, type PluginConfigs as n, type NodeOperationPipe as o, type EdgeOperationPipe as p, type NodeOperation as q, type EdgeOperation as r, type NodeOperatorFunction as s, type EdgeOperatorFunction as t };

package/dist/shared/{core.BKaZlwmj.d.ts → core.BUBec6Va.d.ts}

@@ -1,3 +1,4 @@
+import { Schema } from 'jsonschema';
 import { SubscriptionLike, BehaviorSubject } from 'rxjs';
 import { DataOperationPipe, DataOperation } from '@knotx/data';
 
@@ -79,6 +80,7 @@ interface LayerComponent<TRenderType> {
 interface IPlugin<TPluginName extends string = string, TPluginConfig extends Record<string, any> | undefined = any, TRenderType extends RenderType = RenderType> {
     name: TPluginName;
     pluginId: string;
+    description?: string;
     onInit?: (config: TPluginConfig) => void;
     onConfigChange?: (config: TPluginConfig) => void;
     onDestroy?: () => void;
@@ -101,6 +103,29 @@ type PluginConfigs<TPlugins extends Plugin[]> = ((TPlugins[number] extends Plugi
  */
 interface PluginData {
 }
+/**
+ * plugin tools host
+ * @example
+ * `declare module '@knotx/core' {
+ *   interface PluginTools {
+ *     pluginName: {
+ *       toolName: (params: any) => any
+ *     }
+ *   }
+ * }`
+ */
+interface PluginTools {
+}
+interface IPluginInfo {
+    name: string;
+    description?: string;
+}
+interface IPluginToolInfo {
+    type: 'function';
+    name: string;
+    description: string;
+    parameters: Schema;
+}
 type NodeOperationPipe<T = any> = DataOperationPipe<NodeData<T>>;
 type EdgeOperationPipe<T = any> = DataOperationPipe<EdgeData<T>>;
 type NodeOperation<T = any> = DataOperation<NodeData<T>>;
@@ -117,4 +142,4 @@ interface IEngineRuntime {
     };
 }
 
-export { BasePlugin as B, type Container as C, type EdgeData as E, type HorizontalAlignment as H, type IEngineRuntime as I, type LayerComponent as L, type NodeData as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IPlugin as a, Layer as b, type NodeRenderType as c, type EdgeRenderType as d, type PluginData as e, type NodePosition as f, type NodeMeasured as g, type NodeProps as h, type EdgeProps as i, type Position as j, type PluginConfigs as k, type NodeOperationPipe as l, type EdgeOperationPipe as m, type NodeOperation as n, type EdgeOperation as o, type NodeOperatorFunction as p, type EdgeOperatorFunction as q };
+export { BasePlugin as B, type Container as C, type EdgeData as E, type HorizontalAlignment as H, type IEngineRuntime as I, type LayerComponent as L, type NodeData as N, type Plugin as P, type RenderType as R, type VerticalAlignment as V, type IPlugin as a, Layer as b, type NodeRenderType as c, type EdgeRenderType as d, type PluginData as e, type PluginTools as f, type IPluginInfo as g, type IPluginToolInfo as h, type NodePosition as i, type NodeMeasured as j, type NodeProps as k, type EdgeProps as l, type Position as m, type PluginConfigs as n, type NodeOperationPipe as o, type EdgeOperationPipe as p, type NodeOperation as q, type EdgeOperation as r, type NodeOperatorFunction as s, type EdgeOperatorFunction as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knotx/core",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Core for Knotx",
   "author": "boenfu",
   "license": "MIT",
@@ -43,16 +43,17 @@
     "dist"
   ],
   "dependencies": {
+    "jsonschema": "^1.5.0",
     "lodash-es": "^4.17.21",
     "rxjs": "^7.8.1",
-    "@knotx/data": "0.2.5",
-    "@knotx/utils": "0.2.5"
+    "@knotx/data": "0.2.6",
+    "@knotx/utils": "0.2.6"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
-    "@knotx/build-config": "0.2.5",
-    "@knotx/eslint-config": "0.2.5",
-    "@knotx/typescript-config": "0.2.5"
+    "@knotx/build-config": "0.2.6",
+    "@knotx/eslint-config": "0.2.6",
+    "@knotx/typescript-config": "0.2.6"
   },
   "scripts": {
     "build": "unbuild",