donobu 5.17.2 → 5.18.0

package/dist/esm/managers/ToolRegistry.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultToolRegistry = createDefaultToolRegistry;
+const AcknowledgeUserInstruction_1 = require("../tools/AcknowledgeUserInstruction");
+const AnalyzePageTextTool_1 = require("../tools/AnalyzePageTextTool");
+const AssertPageTextTool_1 = require("../tools/AssertPageTextTool");
+const AssertPageTool_1 = require("../tools/AssertPageTool");
+const AssertTool_1 = require("../tools/AssertTool");
+const ChangeWebBrowserTabTool_1 = require("../tools/ChangeWebBrowserTabTool");
+const ChooseSelectOptionTool_1 = require("../tools/ChooseSelectOptionTool");
+const ClickTool_1 = require("../tools/ClickTool");
+const CreateBrowserCookieReportTool_1 = require("../tools/CreateBrowserCookieReportTool");
+const DetectBrokenLinksTool_1 = require("../tools/DetectBrokenLinksTool");
+const DoubleClickTool_1 = require("../tools/DoubleClickTool");
+const DownloadPdfTool_1 = require("../tools/DownloadPdfTool");
+const GoForwardOrBackTool_1 = require("../tools/GoForwardOrBackTool");
+const GoToWebpageTool_1 = require("../tools/GoToWebpageTool");
+const HandleBrowserDialogTool_1 = require("../tools/HandleBrowserDialogTool");
+const HoverOverElementTool_1 = require("../tools/HoverOverElementTool");
+const InputFakerTool_1 = require("../tools/InputFakerTool");
+const InputRandomizedEmailAddressTool_1 = require("../tools/InputRandomizedEmailAddressTool");
+const InputTextTool_1 = require("../tools/InputTextTool");
+const MakeCommentTool_1 = require("../tools/MakeCommentTool");
+const MarkObjectiveCompleteTool_1 = require("../tools/MarkObjectiveCompleteTool");
+const MarkObjectiveNotCompletableTool_1 = require("../tools/MarkObjectiveNotCompletableTool");
+const PauseForUserInteractionTool_1 = require("../tools/PauseForUserInteractionTool");
+const PressKeyTool_1 = require("../tools/PressKeyTool");
+const ReloadPageTool_1 = require("../tools/ReloadPageTool");
+const RememberPageTextTool_1 = require("../tools/RememberPageTextTool");
+const RunAccessibilityTestTool_1 = require("../tools/RunAccessibilityTestTool");
+const RunInlineJavaScriptCodeTool_1 = require("../tools/RunInlineJavaScriptCodeTool");
+const RunSandboxedJavaScriptCodeTool_1 = require("../tools/RunSandboxedJavaScriptCodeTool");
+const SaveWebpageAsPdfTool_1 = require("../tools/SaveWebpageAsPdfTool");
+const ScrollPageTool_1 = require("../tools/ScrollPageTool");
+const SetRunModeTool_1 = require("../tools/SetRunModeTool");
+const SummarizeLearningsTool_1 = require("../tools/SummarizeLearningsTool");
+const TriggerDonobuFlowTool_1 = require("../tools/TriggerDonobuFlowTool");
+const WaitTool_1 = require("../tools/WaitTool");
+const PluginLoader_1 = require("./PluginLoader");
+// ---------------------------------------------------------------------------
+// Built-in tool catalog
+// ---------------------------------------------------------------------------
+const DEFAULT_TOOL_NAMES = new Set([
+    AnalyzePageTextTool_1.AnalyzePageTextTool.NAME,
+    AssertTool_1.AssertTool.NAME,
+    AssertPageTool_1.AssertPageTool.NAME,
+    ChangeWebBrowserTabTool_1.ChangeWebBrowserTabTool.NAME,
+    ChooseSelectOptionTool_1.ChooseSelectOptionTool.NAME,
+    ClickTool_1.ClickTool.NAME,
+    DoubleClickTool_1.DoubleClickTool.NAME,
+    GoForwardOrBackTool_1.GoForwardOrBackTool.NAME,
+    GoToWebpageTool_1.GoToWebpageTool.NAME,
+    HandleBrowserDialogTool_1.HandleBrowserDialogTool.NAME,
+    HoverOverElementTool_1.HoverOverElementTool.NAME,
+    InputFakerTool_1.InputFakerTool.NAME,
+    InputRandomizedEmailAddressTool_1.InputRandomizedEmailAddressTool.NAME,
+    InputTextTool_1.InputTextTool.NAME,
+    MakeCommentTool_1.MakeCommentTool.NAME,
+    MarkObjectiveCompleteTool_1.MarkObjectiveCompleteTool.NAME,
+    MarkObjectiveNotCompletableTool_1.MarkObjectiveNotCompletableTool.NAME,
+    PressKeyTool_1.PressKeyTool.NAME,
+    RememberPageTextTool_1.RememberPageTextTool.NAME,
+    SetRunModeTool_1.SetRunModeTool.NAME,
+    ScrollPageTool_1.ScrollPageTool.NAME,
+    WaitTool_1.WaitTool.NAME,
+]);
+function createPrepackagedTools() {
+    return [
+        new AcknowledgeUserInstruction_1.AcknowledgeUserInstructionTool(),
+        new AnalyzePageTextTool_1.AnalyzePageTextTool(),
+        new AssertTool_1.AssertTool(),
+        new AssertPageTextTool_1.AssertPageTextTool(),
+        new AssertPageTool_1.AssertPageTool(),
+        new CreateBrowserCookieReportTool_1.CreateBrowserCookieReportTool(),
+        new ChangeWebBrowserTabTool_1.ChangeWebBrowserTabTool(),
+        new ChooseSelectOptionTool_1.ChooseSelectOptionTool(),
+        new ClickTool_1.ClickTool(),
+        new DoubleClickTool_1.DoubleClickTool(),
+        new DownloadPdfTool_1.DownloadPdfTool(),
+        new DetectBrokenLinksTool_1.DetectBrokenLinksTool(),
+        new GoForwardOrBackTool_1.GoForwardOrBackTool(),
+        new GoToWebpageTool_1.GoToWebpageTool(),
+        new HandleBrowserDialogTool_1.HandleBrowserDialogTool(),
+        new HoverOverElementTool_1.HoverOverElementTool(),
+        new InputFakerTool_1.InputFakerTool(),
+        new InputRandomizedEmailAddressTool_1.InputRandomizedEmailAddressTool(),
+        new InputTextTool_1.InputTextTool(),
+        new MakeCommentTool_1.MakeCommentTool(),
+        new MarkObjectiveCompleteTool_1.MarkObjectiveCompleteTool(),
+        new MarkObjectiveNotCompletableTool_1.MarkObjectiveNotCompletableTool(),
+        new PauseForUserInteractionTool_1.PauseForUserInteractionTool(),
+        new PressKeyTool_1.PressKeyTool(),
+        new ReloadPageTool_1.ReloadPageTool(),
+        new RememberPageTextTool_1.RememberPageTextTool(),
+        new RunAccessibilityTestTool_1.RunAccessibilityTestTool(),
+        new RunInlineJavaScriptCodeTool_1.RunInlineJavaScriptCodeTool(),
+        new RunSandboxedJavaScriptCodeTool_1.RunSandboxedJavaScriptCodeTool(),
+        new SaveWebpageAsPdfTool_1.SaveWebpageAsPdfTool(),
+        new ScrollPageTool_1.ScrollPageTool(),
+        new SetRunModeTool_1.SetRunModeTool(),
+        new SummarizeLearningsTool_1.SummarizeLearningsTool(),
+        new TriggerDonobuFlowTool_1.TriggerDonobuFlowTool(),
+        new WaitTool_1.WaitTool(),
+    ];
+}
+function createMinimalTools() {
+    return [
+        new MarkObjectiveCompleteTool_1.MarkObjectiveCompleteTool(),
+        new MarkObjectiveNotCompletableTool_1.MarkObjectiveNotCompletableTool(),
+    ];
+}
+// ---------------------------------------------------------------------------
+// Default implementation
+// ---------------------------------------------------------------------------
+class DefaultToolRegistry {
+    constructor(_pluginTools, _minimalTools, _prepackagedTools, _defaultTools, _allTools) {
+        this._pluginTools = _pluginTools;
+        this._minimalTools = _minimalTools;
+        this._prepackagedTools = _prepackagedTools;
+        this._defaultTools = _defaultTools;
+        this._allTools = _allTools;
+    }
+    pluginTools() {
+        return this._pluginTools;
+    }
+    minimalTools() {
+        return this._minimalTools;
+    }
+    prepackagedTools() {
+        return this._prepackagedTools;
+    }
+    defaultTools() {
+        return this._defaultTools;
+    }
+    allTools() {
+        return this._allTools;
+    }
+    toolsForTarget(targetType) {
+        return this._allTools.filter((t) => t.supportedTargets.length === 0 ||
+            t.supportedTargets.includes(targetType));
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates the default {@link ToolRegistry} by loading plugins and eagerly
+ * computing every tool collection. This is the only async entry point —
+ * once the registry is created, all access is synchronous.
+ *
+ * @param preloadedPluginTools Plugin tools that have already been loaded
+ *   (e.g. by the server entry point). When provided, the factory skips
+ *   the filesystem scan entirely.
+ */
+async function createDefaultToolRegistry(preloadedPluginTools) {
+    // Resolve plugins — the only async step.
+    let pluginTools;
+    if (preloadedPluginTools) {
+        pluginTools = preloadedPluginTools;
+    }
+    else {
+        const loader = await PluginLoader_1.PluginLoader.create();
+        const { tools } = await loader.loadAllPlugins();
+        pluginTools = tools;
+    }
+    const minimalTools = createMinimalTools();
+    const prepackagedTools = createPrepackagedTools();
+    // allTools: prepackaged + plugins, plugins override by name.
+    const pluginsByName = new Map(pluginTools.map((t) => [t.name, t]));
+    const dedupedPrepackaged = prepackagedTools.filter((t) => !pluginsByName.has(t.name));
+    const allTools = [...dedupedPrepackaged, ...pluginTools];
+    // defaultTools: curated subset of prepackaged + all plugins.
+    const defaultPrepackaged = prepackagedTools.filter((t) => DEFAULT_TOOL_NAMES.has(t.name));
+    const dedupedDefaults = defaultPrepackaged.filter((t) => !pluginsByName.has(t.name));
+    const defaultTools = [...dedupedDefaults, ...pluginTools];
+    return new DefaultToolRegistry(pluginTools, minimalTools, prepackagedTools, defaultTools, allTools);
+}
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/esm/persistence/PersistencePlugin.d.ts

@@ -16,14 +16,13 @@ export interface PersistencePlugin {
     createEnvPersistence(): Promise<EnvPersistence | null>;
 }
 /**
- * Register a persistence plugin under the given key. The key should match
- * an entry in the PERSISTENCE_PRIORITY environment variable so that the
- * registries can discover and use it.
+ * An immutable registry of persistence plugins, keyed by their config string.
+ * Created once at startup and threaded through the application.
  */
-export declare function registerPersistencePlugin(key: string, plugin: PersistencePlugin): void;
-/**
- * Look up a registered persistence plugin by key.
- * @internal Not part of the public API — used by the persistence registries.
- */
-export declare function getPersistencePlugin(key: string): PersistencePlugin | undefined;
+export declare class PersistencePluginRegistry {
+    private readonly plugins;
+    constructor(plugins?: ReadonlyMap<string, PersistencePlugin>);
+    /** Look up a registered persistence plugin by key. */
+    get(key: string): PersistencePlugin | undefined;
+}
 //# sourceMappingURL=PersistencePlugin.d.ts.map

package/dist/esm/persistence/PersistencePlugin.js

@@ -1,21 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerPersistencePlugin = registerPersistencePlugin;
-exports.getPersistencePlugin = getPersistencePlugin;
-const plugins = new Map();
+exports.PersistencePluginRegistry = void 0;
 /**
- * Register a persistence plugin under the given key. The key should match
- * an entry in the PERSISTENCE_PRIORITY environment variable so that the
- * registries can discover and use it.
+ * An immutable registry of persistence plugins, keyed by their config string.
+ * Created once at startup and threaded through the application.
  */
-function registerPersistencePlugin(key, plugin) {
-    plugins.set(key, plugin);
-}
-/**
- * Look up a registered persistence plugin by key.
- * @internal Not part of the public API — used by the persistence registries.
- */
-function getPersistencePlugin(key) {
-    return plugins.get(key);
+class PersistencePluginRegistry {
+    constructor(plugins = new Map()) {
+        this.plugins = plugins;
+    }
+    /** Look up a registered persistence plugin by key. */
+    get(key) {
+        return this.plugins.get(key);
+    }
 }
+exports.PersistencePluginRegistry = PersistencePluginRegistry;
 //# sourceMappingURL=PersistencePlugin.js.map

package/dist/esm/persistence/env/EnvPersistenceRegistry.d.ts

@@ -1,5 +1,6 @@
 import type { EnvPick } from 'env-struct';
 import type { env } from '../../envVars';
+import { PersistencePluginRegistry } from '../PersistencePlugin';
 import type { EnvPersistence } from './EnvPersistence';
 import { EnvPersistenceVolatile } from './EnvPersistenceVolatile';
 /**
@@ -39,7 +40,7 @@ export declare class EnvPersistenceRegistryImpl implements EnvPersistenceRegistr
      * `process.env` snapshot) remain accessible to flows regardless of how the
      * caller configured persistence priority.
      */
-    static fromEnvironment(envPersistenceVolatile: EnvPersistenceVolatile | null, environ: EnvPick<typeof env, 'PERSISTENCE_PRIORITY'>): Promise<EnvPersistenceRegistryImpl>;
+    static fromEnvironment(envPersistenceVolatile: EnvPersistenceVolatile | null, environ: EnvPick<typeof env, 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<EnvPersistenceRegistryImpl>;
     /** Returns all persistence layers. Note that the returned list may be empty! */
     getAll(): Promise<EnvPersistence[]>;
 }

package/dist/esm/persistence/env/EnvPersistenceRegistry.js

@@ -31,7 +31,7 @@ class EnvPersistenceRegistryImpl {
      * `process.env` snapshot) remain accessible to flows regardless of how the
      * caller configured persistence priority.
      */
-    static async fromEnvironment(envPersistenceVolatile, environ) {
+    static async fromEnvironment(envPersistenceVolatile, environ, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const layers = [];
         let volatileIncluded = false;
         for (const key of environ.data.PERSISTENCE_PRIORITY) {
@@ -44,7 +44,7 @@ class EnvPersistenceRegistryImpl {
                     volatileIncluded = true;
                     break;
                 default: {
-                    const plugin = (0, PersistencePlugin_1.getPersistencePlugin)(key);
+                    const plugin = persistencePlugins.get(key);
                     if (plugin) {
                         const impl = await plugin.createEnvPersistence();
                         if (impl) {

package/dist/esm/persistence/flows/FlowsPersistenceRegistry.d.ts

@@ -1,5 +1,6 @@
 import type { EnvPick } from 'env-struct';
 import type { env } from '../../envVars';
+import { PersistencePluginRegistry } from '../PersistencePlugin';
 import type { FlowsPersistence } from './FlowsPersistence';
 export interface FlowsPersistenceRegistry {
     /**
@@ -23,7 +24,7 @@ export declare class FlowsPersistenceRegistryImpl implements FlowsPersistenceReg
      * Creates an instance by reading environment variables and eagerly constructing
      * all applicable persistence layers.
      */
-    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>): Promise<FlowsPersistenceRegistryImpl>;
+    static fromEnvironment(environ: EnvPick<typeof env, 'DONOBU_API_BASE_URL' | 'DONOBU_API_KEY' | 'PERSISTENCE_PRIORITY'>, persistencePlugins?: PersistencePluginRegistry): Promise<FlowsPersistenceRegistryImpl>;
     /**
      * Returns the primary persistence layer.
      */

package/dist/esm/persistence/flows/FlowsPersistenceRegistry.js

@@ -24,7 +24,7 @@ class FlowsPersistenceRegistryImpl {
      * Creates an instance by reading environment variables and eagerly constructing
      * all applicable persistence layers.
      */
-    static async fromEnvironment(environ) {
+    static async fromEnvironment(environ, persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry()) {
         const donobuApiBaseUrl = environ.data.DONOBU_API_BASE_URL;
         const donobuApiKey = environ.data.DONOBU_API_KEY;
         const layers = [];
@@ -42,7 +42,7 @@ class FlowsPersistenceRegistryImpl {
                     layers.push(new FlowsPersistenceVolatile_1.FlowsPersistenceVolatile());
                     break;
                 default: {
-                    const plugin = (0, PersistencePlugin_1.getPersistencePlugin)(key);
+                    const plugin = persistencePlugins.get(key);
                     if (plugin) {
                         const impl = await plugin.createFlowsPersistence();
                         if (impl) {

package/dist/esm/targets/TargetRuntimePlugin.d.ts

@@ -89,17 +89,15 @@ export interface TargetRuntimePlugin {
     prepareToolCallsForRerun(toolCalls: ToolCall[], options: CodeGenerationOptions): Promise<ProposedToolCall[]>;
 }
 /**
- * Register a target runtime plugin under its declared type. The type should
- * match the `target` field on flow creation requests so that
- * {@link resolveTargetRuntime} can discover and use it.
+ * An immutable registry of target runtime plugins, keyed by target type.
+ * Created once at startup and threaded through the application.
  */
-export declare function registerTargetRuntimePlugin(plugin: TargetRuntimePlugin): void;
-/**
- * Look up a registered target runtime plugin by target type.
- */
-export declare function getTargetRuntimePlugin(type: string): TargetRuntimePlugin | undefined;
-/**
- * Return all registered target runtime plugins.
- */
-export declare function getAllTargetRuntimePlugins(): TargetRuntimePlugin[];
+export declare class TargetRuntimePluginRegistry {
+    private readonly plugins;
+    constructor(plugins: TargetRuntimePlugin[]);
+    /** Look up a registered target runtime plugin by target type. */
+    get(type: string): TargetRuntimePlugin | undefined;
+    /** Return all registered target runtime plugins. */
+    getAll(): TargetRuntimePlugin[];
+}
 //# sourceMappingURL=TargetRuntimePlugin.d.ts.map

package/dist/esm/targets/TargetRuntimePlugin.js

@@ -1,30 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerTargetRuntimePlugin = registerTargetRuntimePlugin;
-exports.getTargetRuntimePlugin = getTargetRuntimePlugin;
-exports.getAllTargetRuntimePlugins = getAllTargetRuntimePlugins;
-// ---------------------------------------------------------------------------
-// Plugin registry — same pattern as GptClientPlugin
-// ---------------------------------------------------------------------------
-const plugins = new Map();
+exports.TargetRuntimePluginRegistry = void 0;
 /**
- * Register a target runtime plugin under its declared type. The type should
- * match the `target` field on flow creation requests so that
- * {@link resolveTargetRuntime} can discover and use it.
+ * An immutable registry of target runtime plugins, keyed by target type.
+ * Created once at startup and threaded through the application.
  */
-function registerTargetRuntimePlugin(plugin) {
-    plugins.set(plugin.type, plugin);
-}
-/**
- * Look up a registered target runtime plugin by target type.
- */
-function getTargetRuntimePlugin(type) {
-    return plugins.get(type);
-}
-/**
- * Return all registered target runtime plugins.
- */
-function getAllTargetRuntimePlugins() {
-    return Array.from(plugins.values());
+class TargetRuntimePluginRegistry {
+    constructor(plugins) {
+        this.plugins = new Map(plugins.map((p) => [p.type, p]));
+    }
+    /** Look up a registered target runtime plugin by target type. */
+    get(type) {
+        return this.plugins.get(type);
+    }
+    /** Return all registered target runtime plugins. */
+    getAll() {
+        return Array.from(this.plugins.values());
+    }
 }
+exports.TargetRuntimePluginRegistry = TargetRuntimePluginRegistry;
 //# sourceMappingURL=TargetRuntimePlugin.js.map

package/dist/esm/targets/resolveTargetRuntime.d.ts

@@ -1,16 +1,14 @@
 import type { TargetRuntime } from './TargetRuntime';
-import type { TargetRuntimeParams } from './TargetRuntimePlugin';
+import type { TargetRuntimeParams, TargetRuntimePluginRegistry } from './TargetRuntimePlugin';
 /**
  * Resolve a {@link TargetRuntime} for the given flow parameters.
  *
- * Looks up the registered {@link TargetRuntimePlugin} for the flow's target
- * type, validates the target-specific parameters, and creates a live runtime.
- *
- * Built-in targets (`web`) are registered at startup. Additional
- * targets can be registered via the plugin system.
+ * Looks up the {@link TargetRuntimePlugin} in the provided registry for the
+ * flow's target type, validates the target-specific parameters, and creates
+ * a live runtime.
  *
  * @throws {@link InvalidParamValueException} if no plugin is registered for
  *   the requested target type.
  */
-export declare function resolveTargetRuntime(params: TargetRuntimeParams): Promise<TargetRuntime>;
+export declare function resolveTargetRuntime(params: TargetRuntimeParams, targetRuntimePlugins: TargetRuntimePluginRegistry): Promise<TargetRuntime>;
 //# sourceMappingURL=resolveTargetRuntime.d.ts.map

package/dist/esm/targets/resolveTargetRuntime.js

@@ -2,22 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveTargetRuntime = resolveTargetRuntime;
 const InvalidParamValueException_1 = require("../exceptions/InvalidParamValueException");
-const TargetRuntimePlugin_1 = require("./TargetRuntimePlugin");
 /**
  * Resolve a {@link TargetRuntime} for the given flow parameters.
  *
- * Looks up the registered {@link TargetRuntimePlugin} for the flow's target
- * type, validates the target-specific parameters, and creates a live runtime.
- *
- * Built-in targets (`web`) are registered at startup. Additional
- * targets can be registered via the plugin system.
+ * Looks up the {@link TargetRuntimePlugin} in the provided registry for the
+ * flow's target type, validates the target-specific parameters, and creates
+ * a live runtime.
  *
  * @throws {@link InvalidParamValueException} if no plugin is registered for
  *   the requested target type.
  */
-async function resolveTargetRuntime(params) {
+async function resolveTargetRuntime(params, targetRuntimePlugins) {
     const targetType = params.flowParams.target;
-    const plugin = (0, TargetRuntimePlugin_1.getTargetRuntimePlugin)(targetType);
+    const plugin = targetRuntimePlugins.get(targetType);
     if (!plugin) {
         throw new InvalidParamValueException_1.InvalidParamValueException('target', targetType, `no target runtime plugin is registered for '${targetType}'`);
     }

package/dist/lib/ai/PageAi.js

@@ -105,11 +105,12 @@ class PageAiRunner {
      * a narrower list.
      */
     async buildToolManager(allowedToolsByName) {
+        const registry = this.donobu.toolRegistry;
         if (allowedToolsByName.length === 0) {
-            return new ToolManager_1.ToolManager(await ToolManager_1.ToolManager.defaultTools());
+            return new ToolManager_1.ToolManager(registry.defaultTools());
         }
-        const allTools = await ToolManager_1.ToolManager.allTools();
-        const minimalToolsByName = (await ToolManager_1.ToolManager.minimalTools()).map((t) => t.name);
+        const allTools = registry.allTools();
+        const minimalToolsByName = registry.minimalTools().map((t) => t.name);
         const semifinalToolNames = new Set([
             ...allowedToolsByName,
             ...minimalToolsByName,

package/dist/lib/page/extendPage.js

@@ -489,7 +489,7 @@ async function runTool(page, toolName, toolParams, gptClient) {
         metadata: page._dnb.donobuFlowMetadata,
         toolCallId: clonedParams.toolCallId ?? MiscUtils_1.MiscUtils.createAdHocToolCallId(),
     };
-    const tools = await ToolManager_1.ToolManager.allTools();
+    const tools = page._dnb.donobuStack.toolRegistry.allTools();
     const result = await new ToolManager_1.ToolManager(tools).invokeTool(toolCallContext, toolName, clonedParams, false);
     return result;
 }

package/dist/lib/test/utils/selfHealing.js

@@ -37,7 +37,6 @@ exports.selfHeal = selfHeal;
 const fs = __importStar(require("fs"));
 const v4_1 = require("zod/v4");
 const DonobuFlowsManager_1 = require("../../../managers/DonobuFlowsManager");
-const ToolManager_1 = require("../../../managers/ToolManager");
 const CodeGenerationOptions_1 = require("../../../models/CodeGenerationOptions");
 const AnalyzePageTextTool_1 = require("../../../tools/AnalyzePageTextTool");
 const AssertPageTextTool_1 = require("../../../tools/AssertPageTextTool");
@@ -106,7 +105,7 @@ async function selfHeal(gptClient, testInfo, page) {
         testInfo.setTimeout(testInfo.timeout + selfHealTimeoutMs);
         Logger_1.appLogger.info(`Extending the test timeout ${selfHealTimeoutMs}ms for self-healing...`);
         Logger_1.appLogger.info('Attempting to self-heal by creating a new autonomous flow...');
-        const allowedTools = await buildToolList(donobuFlowMetadata);
+        const allowedTools = await buildToolList(donobuFlowMetadata, donobu.toolRegistry);
         const objectiveWhileSelfHealing = `
 Use tool calling to follow along with the intent of this Playwright test.
 The test had failed, so some parts may need to be adjusted along the way, but
@@ -267,7 +266,7 @@ to someone who is tasked with completing it as a goal.
         };
     }
 }
-async function buildToolList(donobuFlowMetadata) {
+async function buildToolList(donobuFlowMetadata, toolRegistry) {
     const baseTools = [
         AnalyzePageTextTool_1.AnalyzePageTextTool.NAME,
         AssertTool_1.AssertTool.NAME,
@@ -293,7 +292,7 @@ async function buildToolList(donobuFlowMetadata) {
         WaitTool_1.WaitTool.NAME,
     ];
     // Always allow tools from plugins.
-    const toolsFromPlugins = (await ToolManager_1.ToolManager.pluginTools()).map((t) => t.name);
+    const toolsFromPlugins = toolRegistry.pluginTools().map((t) => t.name);
     const defaultTools = new Set([
         ...(donobuFlowMetadata.allowedTools ? donobuFlowMetadata.allowedTools : []),
         ...baseTools,

package/dist/main.d.ts

@@ -2,7 +2,7 @@ export { AnthropicGptClient } from './clients/AnthropicGptClient';
 export { DonobuGptClient } from './clients/DonobuGptClient';
 export { fixAssertFields, GoogleGenerativeAiGptClient, } from './clients/GoogleGenerativeAiGptClient';
 export { GptClient } from './clients/GptClient';
-export { type GptClientPlugin, registerGptClientPlugin, } from './clients/GptClientPlugin';
+export { type GptClientPlugin, GptClientPluginRegistry, } from './clients/GptClientPlugin';
 export { OpenAiGptClient } from './clients/OpenAiGptClient';
 export { VercelAiGptClient } from './clients/VercelAiGptClient';
 export { runGenerateSiteTests } from './codegen/runGenerateSiteTests';
@@ -25,9 +25,10 @@ export { DonobuFlow } from './managers/DonobuFlow';
 export { distillAllowedEnvVariableNames, DonobuFlowsManager, } from './managers/DonobuFlowsManager';
 export { type DonobuStack, setupDonobuStack } from './managers/DonobuStack';
 export { InteractionVisualizer } from './managers/InteractionVisualizer';
-export { type PluginDependencies, PluginLoader } from './managers/PluginLoader';
+export { type LoadedPlugins, type PluginDependencies, PluginLoader, } from './managers/PluginLoader';
 export type * from './managers/TargetInspector';
 export { ToolManager } from './managers/ToolManager';
+export { createDefaultToolRegistry, type ToolRegistry, } from './managers/ToolRegistry';
 export * from './managers/WebTargetInspector';
 export * from './models/BrowserStorageState';
 export * from './models/CodeGenerationOptions';
@@ -48,9 +49,9 @@ export * from './models/ToolSchema';
 export type { VideoSegment } from './models/VideoSegment';
 export type { EnvPersistence } from './persistence/env/EnvPersistence';
 export type { FlowsPersistence } from './persistence/flows/FlowsPersistence';
-export { type PersistencePlugin, registerPersistencePlugin, } from './persistence/PersistencePlugin';
+export { type PersistencePlugin, PersistencePluginRegistry, } from './persistence/PersistencePlugin';
 export type { TargetRuntime } from './targets/TargetRuntime';
-export { registerTargetRuntimePlugin, type TargetRuntimeParams, type TargetRuntimePlugin, } from './targets/TargetRuntimePlugin';
+export { type TargetRuntimeParams, type TargetRuntimePlugin, TargetRuntimePluginRegistry, } from './targets/TargetRuntimePlugin';
 export * from './tools/ReplayableInteraction';
 export * from './tools/Tool';
 export * from './utils/createTool';

package/dist/main.js

@@ -14,18 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerTargetRuntimePlugin = exports.registerPersistencePlugin = exports.ToolManager = exports.PluginLoader = exports.InteractionVisualizer = exports.setupDonobuStack = exports.DonobuFlowsManager = exports.distillAllowedEnvVariableNames = exports.DonobuFlow = exports.env = exports.runGenerateSiteTests = exports.VercelAiGptClient = exports.OpenAiGptClient = exports.registerGptClientPlugin = exports.GptClient = exports.GoogleGenerativeAiGptClient = exports.fixAssertFields = exports.DonobuGptClient = exports.AnthropicGptClient = void 0;
+exports.TargetRuntimePluginRegistry = exports.PersistencePluginRegistry = exports.createDefaultToolRegistry = exports.ToolManager = exports.PluginLoader = exports.InteractionVisualizer = exports.setupDonobuStack = exports.DonobuFlowsManager = exports.distillAllowedEnvVariableNames = exports.DonobuFlow = exports.env = exports.runGenerateSiteTests = exports.VercelAiGptClient = exports.OpenAiGptClient = exports.GptClientPluginRegistry = exports.GptClient = exports.GoogleGenerativeAiGptClient = exports.fixAssertFields = exports.DonobuGptClient = exports.AnthropicGptClient = void 0;
 exports.startDonobuServer = startDonobuServer;
 const commander_1 = require("commander");
 const v4_1 = require("zod/v4");
 const envVars_1 = require("./envVars");
 const init_1 = require("./init");
 const AdminApiController_1 = require("./managers/AdminApiController");
-const PluginLoader_1 = require("./managers/PluginLoader");
-const ToolManager_1 = require("./managers/ToolManager");
 const ControlPanel_1 = require("./models/ControlPanel");
-const TargetRuntimePlugin_1 = require("./targets/TargetRuntimePlugin");
-const WebTargetRuntime_1 = require("./targets/WebTargetRuntime");
 const Logger_1 = require("./utils/Logger");
 const PlaywrightUtils_1 = require("./utils/PlaywrightUtils");
 var AnthropicGptClient_1 = require("./clients/AnthropicGptClient");
@@ -38,7 +34,7 @@ Object.defineProperty(exports, "GoogleGenerativeAiGptClient", { enumerable: true
 var GptClient_1 = require("./clients/GptClient");
 Object.defineProperty(exports, "GptClient", { enumerable: true, get: function () { return GptClient_1.GptClient; } });
 var GptClientPlugin_1 = require("./clients/GptClientPlugin");
-Object.defineProperty(exports, "registerGptClientPlugin", { enumerable: true, get: function () { return GptClientPlugin_1.registerGptClientPlugin; } });
+Object.defineProperty(exports, "GptClientPluginRegistry", { enumerable: true, get: function () { return GptClientPlugin_1.GptClientPluginRegistry; } });
 var OpenAiGptClient_1 = require("./clients/OpenAiGptClient");
 Object.defineProperty(exports, "OpenAiGptClient", { enumerable: true, get: function () { return OpenAiGptClient_1.OpenAiGptClient; } });
 var VercelAiGptClient_1 = require("./clients/VercelAiGptClient");
@@ -69,10 +65,12 @@ var DonobuStack_1 = require("./managers/DonobuStack");
 Object.defineProperty(exports, "setupDonobuStack", { enumerable: true, get: function () { return DonobuStack_1.setupDonobuStack; } });
 var InteractionVisualizer_1 = require("./managers/InteractionVisualizer");
 Object.defineProperty(exports, "InteractionVisualizer", { enumerable: true, get: function () { return InteractionVisualizer_1.InteractionVisualizer; } });
-var PluginLoader_2 = require("./managers/PluginLoader");
-Object.defineProperty(exports, "PluginLoader", { enumerable: true, get: function () { return PluginLoader_2.PluginLoader; } });
-var ToolManager_2 = require("./managers/ToolManager");
-Object.defineProperty(exports, "ToolManager", { enumerable: true, get: function () { return ToolManager_2.ToolManager; } });
+var PluginLoader_1 = require("./managers/PluginLoader");
+Object.defineProperty(exports, "PluginLoader", { enumerable: true, get: function () { return PluginLoader_1.PluginLoader; } });
+var ToolManager_1 = require("./managers/ToolManager");
+Object.defineProperty(exports, "ToolManager", { enumerable: true, get: function () { return ToolManager_1.ToolManager; } });
+var ToolRegistry_1 = require("./managers/ToolRegistry");
+Object.defineProperty(exports, "createDefaultToolRegistry", { enumerable: true, get: function () { return ToolRegistry_1.createDefaultToolRegistry; } });
 __exportStar(require("./managers/WebTargetInspector"), exports);
 __exportStar(require("./models/BrowserStorageState"), exports);
 __exportStar(require("./models/CodeGenerationOptions"), exports);
@@ -85,9 +83,9 @@ __exportStar(require("./models/TargetConfig"), exports);
 __exportStar(require("./models/ToolCallResult"), exports);
 __exportStar(require("./models/ToolSchema"), exports);
 var PersistencePlugin_1 = require("./persistence/PersistencePlugin");
-Object.defineProperty(exports, "registerPersistencePlugin", { enumerable: true, get: function () { return PersistencePlugin_1.registerPersistencePlugin; } });
-var TargetRuntimePlugin_2 = require("./targets/TargetRuntimePlugin");
-Object.defineProperty(exports, "registerTargetRuntimePlugin", { enumerable: true, get: function () { return TargetRuntimePlugin_2.registerTargetRuntimePlugin; } });
+Object.defineProperty(exports, "PersistencePluginRegistry", { enumerable: true, get: function () { return PersistencePlugin_1.PersistencePluginRegistry; } });
+var TargetRuntimePlugin_1 = require("./targets/TargetRuntimePlugin");
+Object.defineProperty(exports, "TargetRuntimePluginRegistry", { enumerable: true, get: function () { return TargetRuntimePlugin_1.TargetRuntimePluginRegistry; } });
 __exportStar(require("./tools/ReplayableInteraction"), exports);
 __exportStar(require("./tools/Tool"), exports);
 __exportStar(require("./utils/createTool"), exports);
@@ -104,17 +102,6 @@ const DEFAULT_PORT = 31000;
  */
 async function startDonobuServer({ port = DEFAULT_PORT, controlPanelHost = ControlPanel_1.NoOpControlPanelFactory, } = {}) {
     try {
-        // Register built-in target runtime plugins before external plugins,
-        // so that external plugins can override them if needed.
-        (0, TargetRuntimePlugin_1.registerTargetRuntimePlugin)(WebTargetRuntime_1.webTargetRuntimePlugin);
-        // Load all plugins (tools + persistence + target runtimes) in a single
-        // directory scan. Persistence plugins must be registered before
-        // setupDonobuStack() runs (which happens inside AdminApiController.create
-        // below).
-        const pluginLoader = await PluginLoader_1.PluginLoader.create();
-        const { tools } = await pluginLoader.loadAllPlugins();
-        ToolManager_1.ToolManager.setPluginTools(tools);
-        void (await ToolManager_1.ToolManager.allTools());
         const adminController = await AdminApiController_1.AdminApiController.create(envVars_1.env.data.DONOBU_DEPLOYMENT_ENVIRONMENT ?? 'LOCAL', controlPanelHost, envVars_1.env);
         adminController.start(port);
         Logger_1.appLogger.info(`Donobu API server available on http://localhost:${port}`);

package/dist/managers/AdminApiController.js

@@ -233,13 +233,13 @@ class AdminApiController {
             gptConfigsApi: new GptConfigsApi_1.GptConfigsApi(donobuStack.gptConfigsManager, donobuStack.agentsManager),
             agentsApi: new AgentsApi_1.AgentsApi(donobuStack.agentsManager),
             askAiApi: new AskAiApi_1.AskAiApi(donobuStack.gptClientFactory, donobuStack.gptConfigsManager, donobuStack.agentsManager),
-            toolsApi: new ToolsApi_1.ToolsApi(),
+            toolsApi: new ToolsApi_1.ToolsApi(donobuStack.toolRegistry),
             flowsApi: new FlowsApi_1.FlowsApi(donobuStack.flowsManager),
             flowsFilesApi: new FlowsFilesApi_1.FlowsFilesApi(donobuStack.flowsPersistenceRegistry),
             flowsToolCallsApi: new FlowsToolCallsApi_1.FlowsToolCallsApi(donobuStack.flowsManager),
             pingApi: new PingApi_1.PingApi(),
             schemaApi: new SchemaApi_1.SchemaApi(),
-            targetsApi: new TargetsApi_1.TargetsApi(),
+            targetsApi: new TargetsApi_1.TargetsApi(donobuStack.targetRuntimePlugins),
         };
     }
     /**