donobu 5.17.2 → 5.18.0

package/dist/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/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

package/dist/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/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/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/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/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/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/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/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