donobu 5.17.2 → 5.18.0

package/dist/esm/managers/DonobuStack.d.ts

@@ -5,11 +5,15 @@ import type { AgentsPersistence } from '../persistence/agents/AgentsPersistence'
 import type { EnvPersistenceVolatile } from '../persistence/env/EnvPersistenceVolatile';
 import { type FlowsPersistenceRegistry } from '../persistence/flows/FlowsPersistenceRegistry';
 import type { GptConfigsPersistence } from '../persistence/gptconfigs/GptConfigsPersistence';
+import { TargetRuntimePluginRegistry } from '../targets/TargetRuntimePlugin';
 import { AgentsManager } from './AgentsManager';
 import { DonobuFlowsManager } from './DonobuFlowsManager';
 import { EnvDataManager } from './EnvDataManager';
 import { GptConfigsManager } from './GptConfigsManager';
+import type { ToolRegistry } from './ToolRegistry';
 export type DonobuStack = {
+    toolRegistry: ToolRegistry;
+    targetRuntimePlugins: TargetRuntimePluginRegistry;
     gptClientFactory: GptClientFactory;
     gptConfigsPersistence: GptConfigsPersistence;
     gptConfigsManager: GptConfigsManager;

package/dist/esm/managers/DonobuStack.js

@@ -2,16 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupDonobuStack = setupDonobuStack;
 const GptClientFactory_1 = require("../clients/GptClientFactory");
+const GptClientPlugin_1 = require("../clients/GptClientPlugin");
 const envVars_1 = require("../envVars");
 const AgentsPersistenceSqlite_1 = require("../persistence/agents/AgentsPersistenceSqlite");
 const DonobuSqliteDb_1 = require("../persistence/DonobuSqliteDb");
 const EnvPersistenceRegistry_1 = require("../persistence/env/EnvPersistenceRegistry");
 const FlowsPersistenceRegistry_1 = require("../persistence/flows/FlowsPersistenceRegistry");
 const GptConfigsPersistenceSqlite_1 = require("../persistence/gptconfigs/GptConfigsPersistenceSqlite");
+const PersistencePlugin_1 = require("../persistence/PersistencePlugin");
+const TargetRuntimePlugin_1 = require("../targets/TargetRuntimePlugin");
+const WebTargetRuntime_1 = require("../targets/WebTargetRuntime");
 const AgentsManager_1 = require("./AgentsManager");
 const DonobuFlowsManager_1 = require("./DonobuFlowsManager");
 const EnvDataManager_1 = require("./EnvDataManager");
 const GptConfigsManager_1 = require("./GptConfigsManager");
+const PluginLoader_1 = require("./PluginLoader");
+const ToolRegistry_1 = require("./ToolRegistry");
 /**
  * Create a new Donobu application stack.
  *
@@ -24,17 +30,24 @@ const GptConfigsManager_1 = require("./GptConfigsManager");
  *       environment variables.
  */
 async function setupDonobuStack(donobuDeploymentEnvironment, controlPanelFactory, envPersistenceVolatile, environ = envVars_1.env.pick('ANTHROPIC_API_KEY', 'ANTHROPIC_MODEL_NAME', 'AWS_ACCESS_KEY_ID', 'AWS_BEDROCK_MODEL_NAME', 'AWS_SECRET_ACCESS_KEY', 'BASE64_GPT_CONFIG', 'BROWSERBASE_API_KEY', 'BROWSERBASE_PROJECT_ID', 'DONOBU_API_BASE_URL', 'DONOBU_API_KEY', 'GOOGLE_GENERATIVE_AI_API_KEY', 'GOOGLE_GENERATIVE_AI_MODEL_NAME', 'OPENAI_API_KEY', 'OPENAI_API_MODEL_NAME', 'PERSISTENCE_PRIORITY')) {
-    const gptClientFactory = new GptClientFactory_1.GptClientFactoryImpl();
+    const loadedPlugins = await loadDefaultPlugins();
+    const resolvedToolRegistry = await (0, ToolRegistry_1.createDefaultToolRegistry)(loadedPlugins.tools);
+    const persistencePlugins = new PersistencePlugin_1.PersistencePluginRegistry(loadedPlugins.persistencePlugins);
+    const gptClientPlugins = new GptClientPlugin_1.GptClientPluginRegistry(loadedPlugins.gptClientPlugins);
+    const targetRuntimePlugins = new TargetRuntimePlugin_1.TargetRuntimePluginRegistry(loadedPlugins.targetRuntimePlugins);
+    const gptClientFactory = new GptClientFactory_1.GptClientFactoryImpl(gptClientPlugins);
     const sqliteDb = await (0, DonobuSqliteDb_1.getDonobuSqliteDatabase)();
     const gptConfigsPersistence = await GptConfigsPersistenceSqlite_1.GptConfigsPersistenceSqlite.create(sqliteDb);
     const gptConfigsManager = await GptConfigsManager_1.GptConfigsManager.create(gptConfigsPersistence, gptClientFactory);
     const agentsPersistence = await AgentsPersistenceSqlite_1.AgentsPersistenceSqlite.create(sqliteDb);
     const agentsManager = await AgentsManager_1.AgentsManager.create(agentsPersistence, gptConfigsManager);
-    const flowsPersistenceRegistry = await FlowsPersistenceRegistry_1.FlowsPersistenceRegistryImpl.fromEnvironment(environ);
-    const envPersistenceFactory = await EnvPersistenceRegistry_1.EnvPersistenceRegistryImpl.fromEnvironment(envPersistenceVolatile ?? null, environ);
+    const flowsPersistenceRegistry = await FlowsPersistenceRegistry_1.FlowsPersistenceRegistryImpl.fromEnvironment(environ, persistencePlugins);
+    const envPersistenceFactory = await EnvPersistenceRegistry_1.EnvPersistenceRegistryImpl.fromEnvironment(envPersistenceVolatile ?? null, environ, persistencePlugins);
     const envDataManager = new EnvDataManager_1.EnvDataManager(envPersistenceFactory);
-    const flowsManager = new DonobuFlowsManager_1.DonobuFlowsManager(donobuDeploymentEnvironment, gptClientFactory, gptConfigsManager, agentsManager, flowsPersistenceRegistry, envDataManager, controlPanelFactory, environ);
+    const flowsManager = new DonobuFlowsManager_1.DonobuFlowsManager(donobuDeploymentEnvironment, gptClientFactory, gptConfigsManager, agentsManager, flowsPersistenceRegistry, envDataManager, controlPanelFactory, environ, resolvedToolRegistry, targetRuntimePlugins);
     return {
+        toolRegistry: resolvedToolRegistry,
+        targetRuntimePlugins,
         gptClientFactory,
         gptConfigsPersistence,
         gptConfigsManager,
@@ -45,4 +58,14 @@ async function setupDonobuStack(donobuDeploymentEnvironment, controlPanelFactory
         envDataManager,
     };
 }
+/**
+ * Discover and load all plugins from disk, prepending the built-in web
+ * target runtime so it's always available.
+ */
+async function loadDefaultPlugins() {
+    const pluginLoader = await PluginLoader_1.PluginLoader.create();
+    const plugins = await pluginLoader.loadAllPlugins();
+    plugins.targetRuntimePlugins.unshift(WebTargetRuntime_1.webTargetRuntimePlugin);
+    return plugins;
+}
 //# sourceMappingURL=DonobuStack.js.map

package/dist/esm/managers/PluginLoader.d.ts

@@ -1,7 +1,17 @@
 import * as playwright from 'playwright';
 import type sharp from 'sharp';
 import type { z } from 'zod/v4';
+import type { GptClientPlugin } from '../clients/GptClientPlugin';
+import type { PersistencePlugin } from '../persistence/PersistencePlugin';
+import type { TargetRuntimePlugin } from '../targets/TargetRuntimePlugin';
 import type { Tool } from '../tools/Tool';
+/** The result of loading all plugins — no global state, just data. */
+export type LoadedPlugins = {
+    tools: Tool<z.ZodObject, z.ZodObject>[];
+    persistencePlugins: Map<string, PersistencePlugin>;
+    gptClientPlugins: GptClientPlugin[];
+    targetRuntimePlugins: TargetRuntimePlugin[];
+};
 export type PluginDependencies = {
     donobu: typeof import('../main');
     playwright: typeof playwright;
@@ -41,12 +51,9 @@ export declare class PluginLoader {
     static create(pluginsPath?: string, pluginDependencies?: PluginDependencies): Promise<PluginLoader>;
     /**
      * Discovers and loads all plugins from both the app-data directory and
-     * `node_modules`. Tool plugins are collected and returned; other plugin
-     * types (persistence, GPT client, target runtime) are registered globally.
+     * `node_modules`. All plugin types are collected and returned.
      */
-    loadAllPlugins(): Promise<{
-        tools: Tool<z.ZodObject, z.ZodObject>[];
-    }>;
+    loadAllPlugins(): Promise<LoadedPlugins>;
     /**
      * Scan the app-data plugins directory for standalone plugin bundles.
      * Each plugin is a directory containing an `index.mjs` entry point.

package/dist/esm/managers/PluginLoader.js

@@ -41,9 +41,6 @@ const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_url_1 = require("node:url");
 const playwright = __importStar(require("playwright"));
-const GptClientPlugin_1 = require("../clients/GptClientPlugin");
-const PersistencePlugin_1 = require("../persistence/PersistencePlugin");
-const TargetRuntimePlugin_1 = require("../targets/TargetRuntimePlugin");
 const Logger_1 = require("../utils/Logger");
 const MiscUtils_1 = require("../utils/MiscUtils");
 async function getDefaultDependencies() {
@@ -114,8 +111,7 @@ class PluginLoader {
     }
     /**
      * Discovers and loads all plugins from both the app-data directory and
-     * `node_modules`. Tool plugins are collected and returned; other plugin
-     * types (persistence, GPT client, target runtime) are registered globally.
+     * `node_modules`. All plugin types are collected and returned.
      */
     async loadAllPlugins() {
         const dirPlugins = await this.discoverDirectoryPlugins();
@@ -130,6 +126,9 @@ class PluginLoader {
             }
         }
         const tools = [];
+        const persistencePlugins = new Map();
+        const gptClientPlugins = [];
+        const targetRuntimePlugins = [];
         for (const plugin of allPlugins) {
             Logger_1.appLogger.info(`↳ Loading plugin "${plugin.name}" from ${plugin.entryPoint}`);
             try {
@@ -151,8 +150,8 @@ class PluginLoader {
                     'function') {
                     const result = await mod.loadPersistencePlugin(this.pluginDependencies);
                     if (result) {
-                        (0, PersistencePlugin_1.registerPersistencePlugin)(result.key, result.plugin);
-                        Logger_1.appLogger.info(`  ✔ Registered persistence plugin "${result.key}" from "${plugin.name}".`);
+                        persistencePlugins.set(result.key, result.plugin);
+                        Logger_1.appLogger.info(`  ✔ Loaded persistence plugin "${result.key}" from "${plugin.name}".`);
                     }
                 }
                 // GPT client plugins
@@ -160,8 +159,8 @@ class PluginLoader {
                     'function') {
                     const gptPlugins = await mod.loadGptClientPlugins(this.pluginDependencies);
                     for (const gptPlugin of gptPlugins) {
-                        (0, GptClientPlugin_1.registerGptClientPlugin)(gptPlugin);
-                        Logger_1.appLogger.info(`  ✔ Registered GPT client plugin "${gptPlugin.type}" from "${plugin.name}".`);
+                        gptClientPlugins.push(gptPlugin);
+                        Logger_1.appLogger.info(`  ✔ Loaded GPT client plugin "${gptPlugin.type}" from "${plugin.name}".`);
                     }
                 }
                 // Target runtime plugins
@@ -170,8 +169,8 @@ class PluginLoader {
                     const targetPlugins = await mod
                         .loadTargetRuntimePlugins(this.pluginDependencies);
                     for (const targetPlugin of targetPlugins) {
-                        (0, TargetRuntimePlugin_1.registerTargetRuntimePlugin)(targetPlugin);
-                        Logger_1.appLogger.info(`  ✔ Registered target runtime plugin "${targetPlugin.type}" from "${plugin.name}".`);
+                        targetRuntimePlugins.push(targetPlugin);
+                        Logger_1.appLogger.info(`  ✔ Loaded target runtime plugin "${targetPlugin.type}" from "${plugin.name}".`);
                     }
                 }
             }
@@ -181,7 +180,12 @@ class PluginLoader {
             }
         }
         Logger_1.appLogger.info(`Loaded ${tools.length} custom tool(s) from plugins.`);
-        return { tools };
+        return {
+            tools,
+            persistencePlugins,
+            gptClientPlugins,
+            targetRuntimePlugins,
+        };
     }
     // ---------------------------------------------------------------------------
     // Discovery: app-data plugins directory

package/dist/esm/managers/ToolManager.d.ts

@@ -4,33 +4,14 @@ import type { ToolCallContext } from '../models/ToolCallContext';
 import type { ToolTemplateDataSource } from '../models/ToolTemplateDataSource';
 import type { Tool } from '../tools/Tool';
 /**
- * Manages calls to a given list of tools.
+ * Executes tool calls against a given list of tools.
+ *
+ * Construct with the specific tool set a flow is allowed to use. Tool
+ * *discovery* (which tools exist, defaults, plugins) is handled by
+ * {@link ToolRegistry} — this class only cares about *execution*.
  */
 export declare class ToolManager {
     readonly tools: Tool<z.ZodObject, z.ZodObject>[];
-    private static PLUGIN_TOOLS;
-    private static MINIMAL_TOOLS;
-    private static ALL_TOOLS;
-    private static PREPACKAGED_TOOLS;
-    private static DEFAULT_TOOLS;
-    private static pluginLoader;
-    /**
-     * Pre-populate the plugin tools cache. When called before
-     * {@link pluginTools}, this avoids a redundant directory scan.
-     */
-    static setPluginTools(tools: Tool<z.ZodObject, z.ZodObject>[]): void;
-    static pluginTools(): Promise<Tool<z.ZodObject, z.ZodObject>[]>;
-    static minimalTools(): Promise<Tool<z.ZodObject, z.ZodObject>[]>;
-    static prepackagedTools(): Promise<Tool<z.ZodObject, z.ZodObject>[]>;
-    static defaultTools(): Promise<Tool<z.ZodObject, z.ZodObject>[]>;
-    /**
-     * Returns all tools compatible with the given target type.
-     *
-     * A tool is compatible if its `supportedTargets` array is empty
-     * (target-agnostic) or contains the given `targetType`.
-     */
-    static toolsForTarget(targetType: string): Promise<Tool<z.ZodObject, z.ZodObject>[]>;
-    static allTools(): Promise<Tool<z.ZodObject, z.ZodObject>[]>;
     constructor(tools: Tool<z.ZodObject, z.ZodObject>[]);
     /**
      * Invokes a tool by name with the provided parameters.
@@ -50,14 +31,14 @@ export declare class ToolManager {
      * @returns A Promise resolving to a ToolCall object containing execution details and results
      */
     invokeTool(context: ToolCallContext, toolName: string, toolParameters: Record<string, any>, isFromGpt: boolean): Promise<ToolCall>;
-    /**
-     * Builds a data source for interpolation for that includes the interpolated parameters
-     * of previous tool calls. This method assumes the first tool call in the given history
-     * requires no interpolation, and then works its way through the history so that each
-     * subsequent tool call can be interpolated with the results of the previous ones.
-     *
-     * Public for testing purposes only.
-     */
-    static buildDataSourceForInterpolation(envData: Record<string, string>, previousToolCalls: ToolCall[]): ToolTemplateDataSource;
 }
+/**
+ * Builds a data source for template interpolation that includes the
+ * interpolated parameters of previous tool calls.
+ *
+ * The first tool call in the given history is assumed to require no
+ * interpolation; each subsequent call can reference the results of the
+ * ones before it via `{{$.calls[n].result}}` syntax.
+ */
+export declare function buildToolInterpolationDataSource(envData: Record<string, string>, previousToolCalls: ToolCall[]): ToolTemplateDataSource;
 //# sourceMappingURL=ToolManager.d.ts.map

package/dist/esm/managers/ToolManager.js

@@ -1,181 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolManager = void 0;
+exports.buildToolInterpolationDataSource = buildToolInterpolationDataSource;
 const v4_1 = require("zod/v4");
 const PageClosedException_1 = require("../exceptions/PageClosedException");
 const ToolRequiresGptException_1 = require("../exceptions/ToolRequiresGptException");
-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 JsonUtils_1 = require("../utils/JsonUtils");
 const Logger_1 = require("../utils/Logger");
 const PlaywrightUtils_1 = require("../utils/PlaywrightUtils");
 const TemplateInterpolator_1 = require("../utils/TemplateInterpolator");
-const PluginLoader_1 = require("./PluginLoader");
 /**
- * Manages calls to a given list of tools.
+ * Executes tool calls against a given list of tools.
+ *
+ * Construct with the specific tool set a flow is allowed to use. Tool
+ * *discovery* (which tools exist, defaults, plugins) is handled by
+ * {@link ToolRegistry} — this class only cares about *execution*.
  */
 class ToolManager {
-    /**
-     * Pre-populate the plugin tools cache. When called before
-     * {@link pluginTools}, this avoids a redundant directory scan.
-     */
-    static setPluginTools(tools) {
-        this.PLUGIN_TOOLS = tools;
-    }
-    static async pluginTools() {
-        if (!this.PLUGIN_TOOLS) {
-            if (!this.pluginLoader) {
-                this.pluginLoader = await PluginLoader_1.PluginLoader.create();
-            }
-            const { tools } = await this.pluginLoader.loadAllPlugins();
-            this.PLUGIN_TOOLS = tools;
-        }
-        return this.PLUGIN_TOOLS;
-    }
-    static async minimalTools() {
-        if (!this.MINIMAL_TOOLS) {
-            this.MINIMAL_TOOLS = [
-                new MarkObjectiveCompleteTool_1.MarkObjectiveCompleteTool(),
-                new MarkObjectiveNotCompletableTool_1.MarkObjectiveNotCompletableTool(),
-            ];
-        }
-        return this.MINIMAL_TOOLS;
-    }
-    static async prepackagedTools() {
-        if (!this.PREPACKAGED_TOOLS) {
-            this.PREPACKAGED_TOOLS = [
-                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(),
-            ];
-        }
-        return this.PREPACKAGED_TOOLS;
-    }
-    static async defaultTools() {
-        if (!this.DEFAULT_TOOLS) {
-            const defaultDefaultToolNames = [
-                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,
-            ];
-            const prepackagedTools = await this.prepackagedTools();
-            const defaultDefaultTools = prepackagedTools.filter((t) => {
-                return defaultDefaultToolNames.includes(t.name);
-            });
-            const toolsFromPlugins = await this.pluginTools();
-            const pluginToolsByName = new Map(toolsFromPlugins.map((tool) => [tool.name, tool]));
-            // Allow plugins to override default tools.
-            const dedupedDefaultTools = defaultDefaultTools.filter((tool) => !pluginToolsByName.has(tool.name));
-            this.DEFAULT_TOOLS = [...dedupedDefaultTools, ...toolsFromPlugins];
-        }
-        return this.DEFAULT_TOOLS;
-    }
-    /**
-     * Returns all tools compatible with the given target type.
-     *
-     * A tool is compatible if its `supportedTargets` array is empty
-     * (target-agnostic) or contains the given `targetType`.
-     */
-    static async toolsForTarget(targetType) {
-        const all = await this.allTools();
-        return all.filter((t) => t.supportedTargets.length === 0 ||
-            t.supportedTargets.includes(targetType));
-    }
-    static async allTools() {
-        if (!this.ALL_TOOLS) {
-            const toolsFromPlugins = await this.pluginTools();
-            const pluginToolsByName = new Map(toolsFromPlugins.map((tool) => [tool.name, tool]));
-            // Allow plugins to override prepackaged tools.
-            const prepackagedTools = await this.prepackagedTools();
-            const dedupedPrepackagedTools = prepackagedTools.filter((tool) => !pluginToolsByName.has(tool.name));
-            this.ALL_TOOLS = [...dedupedPrepackagedTools, ...toolsFromPlugins];
-        }
-        return this.ALL_TOOLS;
-    }
     constructor(tools) {
         this.tools = tools;
         this.tools = tools;
@@ -237,7 +78,7 @@ class ToolManager {
                     state: context.metadata.state,
                     headline: tool.controlPanelMessage,
                 });
-                const interpolatedDataSource = ToolManager.buildDataSourceForInterpolation(context.envData, context.invokedToolCalls);
+                const interpolatedDataSource = buildToolInterpolationDataSource(context.envData, context.invokedToolCalls);
                 // Interpolate the parameters for this tool call using the interpolated data source.
                 const interpolatedParameters = (0, TemplateInterpolator_1.interpolateObject)(toolParameters, interpolatedDataSource);
                 Logger_1.appLogger.debug(`Non-interpolated parameters for ${toolName} tool: ${JSON.stringify(toolParameters, null, 2)}`);
@@ -329,42 +170,35 @@ class ToolManager {
         context.invokedToolCalls.push(toolCall);
         return toolCall;
     }
-    /**
-     * Builds a data source for interpolation for that includes the interpolated parameters
-     * of previous tool calls. This method assumes the first tool call in the given history
-     * requires no interpolation, and then works its way through the history so that each
-     * subsequent tool call can be interpolated with the results of the previous ones.
-     *
-     * Public for testing purposes only.
-     */
-    static buildDataSourceForInterpolation(envData, previousToolCalls) {
-        // Start with an empty data source
-        const dataSource = {
+}
+exports.ToolManager = ToolManager;
+/**
+ * Builds a data source for template interpolation that includes the
+ * interpolated parameters of previous tool calls.
+ *
+ * The first tool call in the given history is assumed to require no
+ * interpolation; each subsequent call can reference the results of the
+ * ones before it via `{{$.calls[n].result}}` syntax.
+ */
+function buildToolInterpolationDataSource(envData, previousToolCalls) {
+    const dataSource = {
+        env: envData,
+        calls: [],
+    };
+    const interpolatedPastToolCalls = [];
+    for (const toolCall of previousToolCalls) {
+        const tempDataSource = {
             env: envData,
-            calls: [],
+            calls: [...interpolatedPastToolCalls],
         };
-        // Process each tool call in sequence
-        const interpolatedPastToolCalls = [];
-        for (const toolCall of previousToolCalls) {
-            // Create a temporary data source with just the tool calls processed so far
-            const tempDataSource = {
-                env: envData,
-                calls: [...interpolatedPastToolCalls],
-            };
-            // Process this tool call's parameters using the temporary data source
-            const processedParameters = (0, TemplateInterpolator_1.interpolateObject)(toolCall.parameters, tempDataSource);
-            // Create an entry for this tool call with its processed parameters and
-            // add it to our accumulating list.
-            interpolatedPastToolCalls.push({
-                name: toolCall.toolName,
-                args: processedParameters,
-                result: toolCall.outcome.forLlm,
-            });
-            // Update the dataSource with the current state of pastToolCalls
-            dataSource.calls = [...interpolatedPastToolCalls];
-        }
-        return dataSource;
+        const processedParameters = (0, TemplateInterpolator_1.interpolateObject)(toolCall.parameters, tempDataSource);
+        interpolatedPastToolCalls.push({
+            name: toolCall.toolName,
+            args: processedParameters,
+            result: toolCall.outcome.forLlm,
+        });
+        dataSource.calls = [...interpolatedPastToolCalls];
     }
+    return dataSource;
 }
-exports.ToolManager = ToolManager;
 //# sourceMappingURL=ToolManager.js.map

package/dist/esm/managers/ToolRegistry.d.ts

@@ -0,0 +1,34 @@
+import type { z } from 'zod/v4';
+import type { Tool } from '../tools/Tool';
+/**
+ * Read-only registry that provides curated collections of tools.
+ *
+ * All methods are synchronous — the one-time async work (plugin loading) is
+ * handled by {@link createDefaultToolRegistry} before the registry is created.
+ * Tests can supply a plain object literal that satisfies this interface.
+ */
+export interface ToolRegistry {
+    /** Tools loaded from external plugins. */
+    pluginTools(): Tool<z.ZodObject, z.ZodObject>[];
+    /** The minimal set of tools that every flow must include (objective bookkeeping). */
+    minimalTools(): Tool<z.ZodObject, z.ZodObject>[];
+    /** All built-in (prepackaged) tools shipped with Donobu. */
+    prepackagedTools(): Tool<z.ZodObject, z.ZodObject>[];
+    /** Curated default tool set for web targets (prepackaged + plugin overrides). */
+    defaultTools(): Tool<z.ZodObject, z.ZodObject>[];
+    /** Every available tool: prepackaged + plugins, with plugin overrides applied. */
+    allTools(): Tool<z.ZodObject, z.ZodObject>[];
+    /** All tools compatible with the given target type (e.g. `'web'`, `'mobile'`). */
+    toolsForTarget(targetType: string): Tool<z.ZodObject, z.ZodObject>[];
+}
+/**
+ * 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.
+ */
+export declare function createDefaultToolRegistry(preloadedPluginTools?: Tool<z.ZodObject, z.ZodObject>[]): Promise<ToolRegistry>;
+//# sourceMappingURL=ToolRegistry.d.ts.map