@growthub/cli 0.3.11 → 0.3.13

package/dist/runtime/server/dist/services/plugin-tool-dispatcher.js

@@ -1,224 +0,0 @@
-/**
- * PluginToolDispatcher — orchestrates plugin tool discovery, lifecycle
- * integration, and execution routing for the agent service.
- *
- * This service sits between the agent service and the lower-level
- * `PluginToolRegistry` + `PluginWorkerManager`, providing a clean API that:
- *
- * - Discovers tools from loaded plugin manifests and registers them
- *   in the tool registry.
- * - Hooks into `PluginLifecycleManager` events to automatically register
- *   and unregister tools when plugins are enabled or disabled.
- * - Exposes the tool list in an agent-friendly format (with namespaced
- *   names, descriptions, parameter schemas).
- * - Routes `executeTool` calls to the correct plugin worker and returns
- *   structured results.
- * - Validates tool parameters against declared schemas before dispatch.
- *
- * The dispatcher is created once at server startup and shared across
- * the application.
- *
- * @see PLUGIN_SPEC.md §11 — Agent Tools
- * @see PLUGIN_SPEC.md §13.10 — `executeTool`
- */
-import { createPluginToolRegistry, } from "./plugin-tool-registry.js";
-import { pluginRegistryService } from "./plugin-registry.js";
-import { logger } from "../middleware/logger.js";
-// ---------------------------------------------------------------------------
-// Factory: createPluginToolDispatcher
-// ---------------------------------------------------------------------------
-/**
- * Create a new `PluginToolDispatcher`.
- *
- * The dispatcher:
- * 1. Creates and owns a `PluginToolRegistry` backed by the given worker manager.
- * 2. Listens for lifecycle events (plugin.enabled, plugin.disabled, plugin.unloaded)
- *    to automatically register and unregister tools.
- * 3. On `initialize()`, loads tools from all currently-ready plugins via the DB.
- *
- * @param options - Configuration options
- *
- * @example
- * ```ts
- * // At server startup
- * const dispatcher = createPluginToolDispatcher({
- *   workerManager,
- *   lifecycleManager,
- *   db,
- * });
- * await dispatcher.initialize();
- *
- * // In agent service — list tools for prompt construction
- * const tools = dispatcher.listToolsForAgent();
- *
- * // In agent service — execute a tool
- * const result = await dispatcher.executeTool(
- *   "acme.linear:search-issues",
- *   { query: "auth bug" },
- *   { agentId: "a-1", runId: "r-1", companyId: "c-1", projectId: "p-1" },
- * );
- * ```
- */
-export function createPluginToolDispatcher(options = {}) {
-    const { workerManager, lifecycleManager, db } = options;
-    const log = logger.child({ service: "plugin-tool-dispatcher" });
-    // Create the underlying tool registry, backed by the worker manager
-    const registry = createPluginToolRegistry(workerManager);
-    // Track lifecycle event listeners so we can remove them on teardown
-    let enabledListener = null;
-    let disabledListener = null;
-    let unloadedListener = null;
-    let initialized = false;
-    // -----------------------------------------------------------------------
-    // Internal helpers
-    // -----------------------------------------------------------------------
-    /**
-     * Attempt to register tools for a plugin by looking up its manifest
-     * from the DB. No-ops gracefully if the plugin or manifest is missing.
-     */
-    async function registerFromDb(pluginId) {
-        if (!db) {
-            log.warn({ pluginId }, "cannot register tools from DB — no database connection configured");
-            return;
-        }
-        const pluginRegistry = pluginRegistryService(db);
-        const plugin = await pluginRegistry.getById(pluginId);
-        if (!plugin) {
-            log.warn({ pluginId }, "plugin not found in registry, cannot register tools");
-            return;
-        }
-        const manifest = plugin.manifestJson;
-        if (!manifest) {
-            log.warn({ pluginId }, "plugin has no manifest, cannot register tools");
-            return;
-        }
-        registry.registerPlugin(plugin.pluginKey, manifest, plugin.id);
-    }
-    /**
-     * Convert a `RegisteredTool` to an `AgentToolDescriptor`.
-     */
-    function toAgentDescriptor(tool) {
-        return {
-            name: tool.namespacedName,
-            displayName: tool.displayName,
-            description: tool.description,
-            parametersSchema: tool.parametersSchema,
-            pluginId: tool.pluginDbId,
-        };
-    }
-    // -----------------------------------------------------------------------
-    // Lifecycle event handlers
-    // -----------------------------------------------------------------------
-    function handlePluginEnabled(payload) {
-        log.debug({ pluginId: payload.pluginId, pluginKey: payload.pluginKey }, "plugin enabled — registering tools");
-        // Async registration from DB — we fire-and-forget since the lifecycle
-        // event handler must be synchronous. Any errors are logged.
-        void registerFromDb(payload.pluginId).catch((err) => {
-            log.error({ pluginId: payload.pluginId, err: err instanceof Error ? err.message : String(err) }, "failed to register tools after plugin enabled");
-        });
-    }
-    function handlePluginDisabled(payload) {
-        log.debug({ pluginId: payload.pluginId, pluginKey: payload.pluginKey }, "plugin disabled — unregistering tools");
-        registry.unregisterPlugin(payload.pluginKey);
-    }
-    function handlePluginUnloaded(payload) {
-        log.debug({ pluginId: payload.pluginId, pluginKey: payload.pluginKey }, "plugin unloaded — unregistering tools");
-        registry.unregisterPlugin(payload.pluginKey);
-    }
-    // -----------------------------------------------------------------------
-    // Public API
-    // -----------------------------------------------------------------------
-    return {
-        async initialize() {
-            if (initialized) {
-                log.warn("dispatcher already initialized, skipping");
-                return;
-            }
-            log.info("initializing plugin tool dispatcher");
-            // Step 1: Load tools from all currently-ready plugins
-            if (db) {
-                const pluginRegistry = pluginRegistryService(db);
-                const readyPlugins = await pluginRegistry.listByStatus("ready");
-                let totalTools = 0;
-                for (const plugin of readyPlugins) {
-                    const manifest = plugin.manifestJson;
-                    if (manifest?.tools && manifest.tools.length > 0) {
-                        registry.registerPlugin(plugin.pluginKey, manifest, plugin.id);
-                        totalTools += manifest.tools.length;
-                    }
-                }
-                log.info({ readyPlugins: readyPlugins.length, registeredTools: totalTools }, "loaded tools from ready plugins");
-            }
-            // Step 2: Subscribe to lifecycle events for dynamic updates
-            if (lifecycleManager) {
-                enabledListener = handlePluginEnabled;
-                disabledListener = handlePluginDisabled;
-                unloadedListener = handlePluginUnloaded;
-                lifecycleManager.on("plugin.enabled", enabledListener);
-                lifecycleManager.on("plugin.disabled", disabledListener);
-                lifecycleManager.on("plugin.unloaded", unloadedListener);
-                log.debug("subscribed to lifecycle events");
-            }
-            else {
-                log.warn("no lifecycle manager provided — tools will not auto-update on plugin state changes");
-            }
-            initialized = true;
-            log.info({ totalTools: registry.toolCount() }, "plugin tool dispatcher initialized");
-        },
-        teardown() {
-            if (!initialized)
-                return;
-            // Unsubscribe from lifecycle events
-            if (lifecycleManager) {
-                if (enabledListener)
-                    lifecycleManager.off("plugin.enabled", enabledListener);
-                if (disabledListener)
-                    lifecycleManager.off("plugin.disabled", disabledListener);
-                if (unloadedListener)
-                    lifecycleManager.off("plugin.unloaded", unloadedListener);
-                enabledListener = null;
-                disabledListener = null;
-                unloadedListener = null;
-            }
-            // Note: we do NOT clear the registry here because teardown may be
-            // called during graceful shutdown where in-flight tool calls should
-            // still be able to resolve their tool entries.
-            initialized = false;
-            log.info("plugin tool dispatcher torn down");
-        },
-        listToolsForAgent(filter) {
-            return registry.listTools(filter).map(toAgentDescriptor);
-        },
-        getTool(namespacedName) {
-            return registry.getTool(namespacedName);
-        },
-        async executeTool(namespacedName, parameters, runContext) {
-            log.debug({
-                tool: namespacedName,
-                agentId: runContext.agentId,
-                runId: runContext.runId,
-            }, "dispatching tool execution");
-            const result = await registry.executeTool(namespacedName, parameters, runContext);
-            log.debug({
-                tool: namespacedName,
-                pluginId: result.pluginId,
-                hasContent: !!result.result.content,
-                hasError: !!result.result.error,
-            }, "tool execution completed");
-            return result;
-        },
-        registerPluginTools(pluginId, manifest) {
-            registry.registerPlugin(pluginId, manifest);
-        },
-        unregisterPluginTools(pluginId) {
-            registry.unregisterPlugin(pluginId);
-        },
-        toolCount(pluginId) {
-            return registry.toolCount(pluginId);
-        },
-        getRegistry() {
-            return registry;
-        },
-    };
-}
-//# sourceMappingURL=plugin-tool-dispatcher.js.map

package/dist/runtime/server/dist/services/plugin-tool-dispatcher.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-tool-dispatcher.js","sourceRoot":"","sources":["../../src/services/plugin-tool-dispatcher.ts"],"names":[],"mappings":"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"}

package/dist/runtime/server/dist/services/plugin-tool-registry.d.ts

@@ -1,192 +0,0 @@
-/**
- * PluginToolRegistry — host-side registry for plugin-contributed agent tools.
- *
- * Responsibilities:
- * - Store tool declarations (from plugin manifests) alongside routing metadata
- *   so the host can resolve namespaced tool names to the owning plugin worker.
- * - Namespace tools automatically: a tool `"search-issues"` from plugin
- *   `"acme.linear"` is exposed to agents as `"acme.linear:search-issues"`.
- * - Route `executeTool` calls to the correct plugin worker via the
- *   `PluginWorkerManager`.
- * - Provide tool discovery queries so agents can list available tools.
- * - Clean up tool registrations when a plugin is unloaded or its worker stops.
- *
- * The registry is an in-memory structure — tool declarations are derived from
- * the plugin manifest at load time and do not need persistence. When a plugin
- * worker restarts, the host re-registers its manifest tools.
- *
- * @see PLUGIN_SPEC.md §11 — Agent Tools
- * @see PLUGIN_SPEC.md §13.10 — `executeTool`
- */
-import type { PaperclipPluginManifestV1 } from "@paperclipai/shared";
-import type { ToolRunContext, ToolResult } from "@paperclipai/plugin-sdk";
-import type { PluginWorkerManager } from "./plugin-worker-manager.js";
-/**
- * Separator between plugin ID and tool name in the namespaced tool identifier.
- *
- * Example: `"acme.linear:search-issues"`
- */
-export declare const TOOL_NAMESPACE_SEPARATOR = ":";
-/**
- * A registered tool entry stored in the registry.
- *
- * Combines the manifest-level declaration with routing metadata so the host
- * can resolve a namespaced tool name → plugin worker in O(1).
- */
-export interface RegisteredTool {
-    /** The plugin key used for namespacing (e.g. `"acme.linear"`). */
-    pluginId: string;
-    /**
-     * The plugin's database UUID, used for worker routing and availability
-     * checks. Falls back to `pluginId` when not provided (e.g. in tests
-     * where `id === pluginKey`).
-     */
-    pluginDbId: string;
-    /** The tool's bare name (without namespace prefix). */
-    name: string;
-    /** Fully namespaced identifier: `"<pluginId>:<toolName>"`. */
-    namespacedName: string;
-    /** Human-readable display name. */
-    displayName: string;
-    /** Description provided to the agent so it knows when to use this tool. */
-    description: string;
-    /** JSON Schema describing the tool's input parameters. */
-    parametersSchema: Record<string, unknown>;
-}
-/**
- * Filter criteria for listing available tools.
- */
-export interface ToolListFilter {
-    /** Only return tools owned by this plugin. */
-    pluginId?: string;
-}
-/**
- * Result of executing a tool, extending `ToolResult` with routing metadata.
- */
-export interface ToolExecutionResult {
-    /** The plugin that handled the tool call. */
-    pluginId: string;
-    /** The bare tool name that was executed. */
-    toolName: string;
-    /** The result returned by the plugin's tool handler. */
-    result: ToolResult;
-}
-/**
- * The host-side tool registry — held by the host process.
- *
- * Created once at server startup and shared across the application. Plugins
- * register their tools when their worker starts, and unregister when the
- * worker stops or the plugin is uninstalled.
- */
-export interface PluginToolRegistry {
-    /**
-     * Register all tools declared in a plugin's manifest.
-     *
-     * Called when a plugin worker starts and its manifest is loaded. Any
-     * previously registered tools for the same plugin are replaced (idempotent).
-     *
-     * @param pluginId - The plugin's unique identifier (e.g. `"acme.linear"`)
-     * @param manifest - The plugin manifest containing the `tools` array
-     * @param pluginDbId - The plugin's database UUID, used for worker routing
-     *   and availability checks. If omitted, `pluginId` is used (backwards-compat).
-     */
-    registerPlugin(pluginId: string, manifest: PaperclipPluginManifestV1, pluginDbId?: string): void;
-    /**
-     * Remove all tool registrations for a plugin.
-     *
-     * Called when a plugin worker stops, crashes, or is uninstalled.
-     *
-     * @param pluginId - The plugin to clear
-     */
-    unregisterPlugin(pluginId: string): void;
-    /**
-     * Look up a registered tool by its namespaced name.
-     *
-     * @param namespacedName - Fully qualified name, e.g. `"acme.linear:search-issues"`
-     * @returns The registered tool entry, or `null` if not found
-     */
-    getTool(namespacedName: string): RegisteredTool | null;
-    /**
-     * Look up a registered tool by plugin ID and bare tool name.
-     *
-     * @param pluginId - The owning plugin
-     * @param toolName - The bare tool name (without namespace prefix)
-     * @returns The registered tool entry, or `null` if not found
-     */
-    getToolByPlugin(pluginId: string, toolName: string): RegisteredTool | null;
-    /**
-     * List all registered tools, optionally filtered.
-     *
-     * @param filter - Optional filter criteria
-     * @returns Array of registered tool entries
-     */
-    listTools(filter?: ToolListFilter): RegisteredTool[];
-    /**
-     * Parse a namespaced tool name into plugin ID and bare tool name.
-     *
-     * @param namespacedName - e.g. `"acme.linear:search-issues"`
-     * @returns `{ pluginId, toolName }` or `null` if the format is invalid
-     */
-    parseNamespacedName(namespacedName: string): {
-        pluginId: string;
-        toolName: string;
-    } | null;
-    /**
-     * Build a namespaced tool name from a plugin ID and bare tool name.
-     *
-     * @param pluginId - e.g. `"acme.linear"`
-     * @param toolName - e.g. `"search-issues"`
-     * @returns The namespaced name, e.g. `"acme.linear:search-issues"`
-     */
-    buildNamespacedName(pluginId: string, toolName: string): string;
-    /**
-     * Execute a tool by its namespaced name, routing to the correct plugin worker.
-     *
-     * Resolves the namespaced name to the owning plugin, validates the tool
-     * exists, and dispatches the `executeTool` RPC call to the worker.
-     *
-     * @param namespacedName - Fully qualified tool name (e.g. `"acme.linear:search-issues"`)
-     * @param parameters - The parsed parameters matching the tool's schema
-     * @param runContext - Agent run context
-     * @returns The execution result with routing metadata
-     * @throws {Error} if the tool is not found or the worker is not running
-     */
-    executeTool(namespacedName: string, parameters: unknown, runContext: ToolRunContext): Promise<ToolExecutionResult>;
-    /**
-     * Get the number of registered tools, optionally scoped to a plugin.
-     *
-     * @param pluginId - If provided, count only this plugin's tools
-     */
-    toolCount(pluginId?: string): number;
-}
-/**
- * Create a new `PluginToolRegistry`.
- *
- * The registry is backed by two in-memory maps:
- * - `byNamespace`: namespaced name → `RegisteredTool` for O(1) lookups.
- * - `byPlugin`: pluginId → Set of namespaced names for efficient per-plugin ops.
- *
- * @param workerManager - The worker manager used to dispatch `executeTool` RPC
- *   calls to plugin workers. If not provided, `executeTool` will throw.
- *
- * @example
- * ```ts
- * const toolRegistry = createPluginToolRegistry(workerManager);
- *
- * // Register tools from a plugin manifest
- * toolRegistry.registerPlugin("acme.linear", linearManifest);
- *
- * // List all available tools for agents
- * const tools = toolRegistry.listTools();
- * // → [{ namespacedName: "acme.linear:search-issues", ... }]
- *
- * // Execute a tool
- * const result = await toolRegistry.executeTool(
- *   "acme.linear:search-issues",
- *   { query: "auth bug" },
- *   { agentId: "agent-1", runId: "run-1", companyId: "co-1", projectId: "proj-1" },
- * );
- * ```
- */
-export declare function createPluginToolRegistry(workerManager?: PluginWorkerManager): PluginToolRegistry;
-//# sourceMappingURL=plugin-tool-registry.d.ts.map

package/dist/runtime/server/dist/services/plugin-tool-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-tool-registry.d.ts","sourceRoot":"","sources":["../../src/services/plugin-tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EAE1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAqB,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAOtE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAM5C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,UAAU,CAAC;CACpB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;OAUG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,yBAAyB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjG;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC;;;;;OAKG;IACH,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAEvD;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAE3E;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAErD;;;;;OAKG;IACH,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE3F;;;;;;OAMG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhE;;;;;;;;;;;OAWG;IACH,WAAW,CACT,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,CAAC,EAAE,mBAAmB,GAClC,kBAAkB,CA4NpB"}

package/dist/runtime/server/dist/services/plugin-tool-registry.js

@@ -1,224 +0,0 @@
-/**
- * PluginToolRegistry — host-side registry for plugin-contributed agent tools.
- *
- * Responsibilities:
- * - Store tool declarations (from plugin manifests) alongside routing metadata
- *   so the host can resolve namespaced tool names to the owning plugin worker.
- * - Namespace tools automatically: a tool `"search-issues"` from plugin
- *   `"acme.linear"` is exposed to agents as `"acme.linear:search-issues"`.
- * - Route `executeTool` calls to the correct plugin worker via the
- *   `PluginWorkerManager`.
- * - Provide tool discovery queries so agents can list available tools.
- * - Clean up tool registrations when a plugin is unloaded or its worker stops.
- *
- * The registry is an in-memory structure — tool declarations are derived from
- * the plugin manifest at load time and do not need persistence. When a plugin
- * worker restarts, the host re-registers its manifest tools.
- *
- * @see PLUGIN_SPEC.md §11 — Agent Tools
- * @see PLUGIN_SPEC.md §13.10 — `executeTool`
- */
-import { logger } from "../middleware/logger.js";
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/**
- * Separator between plugin ID and tool name in the namespaced tool identifier.
- *
- * Example: `"acme.linear:search-issues"`
- */
-export const TOOL_NAMESPACE_SEPARATOR = ":";
-// ---------------------------------------------------------------------------
-// Factory: createPluginToolRegistry
-// ---------------------------------------------------------------------------
-/**
- * Create a new `PluginToolRegistry`.
- *
- * The registry is backed by two in-memory maps:
- * - `byNamespace`: namespaced name → `RegisteredTool` for O(1) lookups.
- * - `byPlugin`: pluginId → Set of namespaced names for efficient per-plugin ops.
- *
- * @param workerManager - The worker manager used to dispatch `executeTool` RPC
- *   calls to plugin workers. If not provided, `executeTool` will throw.
- *
- * @example
- * ```ts
- * const toolRegistry = createPluginToolRegistry(workerManager);
- *
- * // Register tools from a plugin manifest
- * toolRegistry.registerPlugin("acme.linear", linearManifest);
- *
- * // List all available tools for agents
- * const tools = toolRegistry.listTools();
- * // → [{ namespacedName: "acme.linear:search-issues", ... }]
- *
- * // Execute a tool
- * const result = await toolRegistry.executeTool(
- *   "acme.linear:search-issues",
- *   { query: "auth bug" },
- *   { agentId: "agent-1", runId: "run-1", companyId: "co-1", projectId: "proj-1" },
- * );
- * ```
- */
-export function createPluginToolRegistry(workerManager) {
-    const log = logger.child({ service: "plugin-tool-registry" });
-    // Primary index: namespaced name → tool entry
-    const byNamespace = new Map();
-    // Secondary index: pluginId → set of namespaced names (for bulk operations)
-    const byPlugin = new Map();
-    // -----------------------------------------------------------------------
-    // Internal helpers
-    // -----------------------------------------------------------------------
-    function buildName(pluginId, toolName) {
-        return `${pluginId}${TOOL_NAMESPACE_SEPARATOR}${toolName}`;
-    }
-    function parseName(namespacedName) {
-        const sepIndex = namespacedName.lastIndexOf(TOOL_NAMESPACE_SEPARATOR);
-        if (sepIndex <= 0 || sepIndex >= namespacedName.length - 1) {
-            return null;
-        }
-        return {
-            pluginId: namespacedName.slice(0, sepIndex),
-            toolName: namespacedName.slice(sepIndex + 1),
-        };
-    }
-    function addTool(pluginId, decl, pluginDbId) {
-        const namespacedName = buildName(pluginId, decl.name);
-        const entry = {
-            pluginId,
-            pluginDbId,
-            name: decl.name,
-            namespacedName,
-            displayName: decl.displayName,
-            description: decl.description,
-            parametersSchema: decl.parametersSchema,
-        };
-        byNamespace.set(namespacedName, entry);
-        let pluginTools = byPlugin.get(pluginId);
-        if (!pluginTools) {
-            pluginTools = new Set();
-            byPlugin.set(pluginId, pluginTools);
-        }
-        pluginTools.add(namespacedName);
-    }
-    function removePluginTools(pluginId) {
-        const pluginTools = byPlugin.get(pluginId);
-        if (!pluginTools)
-            return 0;
-        const count = pluginTools.size;
-        for (const name of pluginTools) {
-            byNamespace.delete(name);
-        }
-        byPlugin.delete(pluginId);
-        return count;
-    }
-    // -----------------------------------------------------------------------
-    // Public API
-    // -----------------------------------------------------------------------
-    return {
-        registerPlugin(pluginId, manifest, pluginDbId) {
-            const dbId = pluginDbId ?? pluginId;
-            // Remove any previously registered tools for this plugin (idempotent)
-            const previousCount = removePluginTools(pluginId);
-            if (previousCount > 0) {
-                log.debug({ pluginId, previousCount }, "cleared previous tool registrations before re-registering");
-            }
-            const tools = manifest.tools ?? [];
-            if (tools.length === 0) {
-                log.debug({ pluginId }, "plugin declares no tools");
-                return;
-            }
-            for (const decl of tools) {
-                addTool(pluginId, decl, dbId);
-            }
-            log.info({
-                pluginId,
-                toolCount: tools.length,
-                tools: tools.map((t) => buildName(pluginId, t.name)),
-            }, `registered ${tools.length} tool(s) for plugin`);
-        },
-        unregisterPlugin(pluginId) {
-            const removed = removePluginTools(pluginId);
-            if (removed > 0) {
-                log.info({ pluginId, removedCount: removed }, `unregistered ${removed} tool(s) for plugin`);
-            }
-        },
-        getTool(namespacedName) {
-            return byNamespace.get(namespacedName) ?? null;
-        },
-        getToolByPlugin(pluginId, toolName) {
-            const namespacedName = buildName(pluginId, toolName);
-            return byNamespace.get(namespacedName) ?? null;
-        },
-        listTools(filter) {
-            if (filter?.pluginId) {
-                const pluginTools = byPlugin.get(filter.pluginId);
-                if (!pluginTools)
-                    return [];
-                const result = [];
-                for (const name of pluginTools) {
-                    const tool = byNamespace.get(name);
-                    if (tool)
-                        result.push(tool);
-                }
-                return result;
-            }
-            return Array.from(byNamespace.values());
-        },
-        parseNamespacedName(namespacedName) {
-            return parseName(namespacedName);
-        },
-        buildNamespacedName(pluginId, toolName) {
-            return buildName(pluginId, toolName);
-        },
-        async executeTool(namespacedName, parameters, runContext) {
-            // 1. Resolve the namespaced name
-            const parsed = parseName(namespacedName);
-            if (!parsed) {
-                throw new Error(`Invalid tool name "${namespacedName}". Expected format: "<pluginId>${TOOL_NAMESPACE_SEPARATOR}<toolName>"`);
-            }
-            const { pluginId, toolName } = parsed;
-            // 2. Verify the tool is registered
-            const tool = byNamespace.get(namespacedName);
-            if (!tool) {
-                throw new Error(`Tool "${namespacedName}" is not registered. ` +
-                    `The plugin may not be installed or its worker may not be running.`);
-            }
-            // 3. Verify the worker manager is available
-            if (!workerManager) {
-                throw new Error(`Cannot execute tool "${namespacedName}" — no worker manager configured. ` +
-                    `Tool execution requires a PluginWorkerManager.`);
-            }
-            // 4. Verify the plugin worker is running (use DB UUID for worker lookup)
-            const dbId = tool.pluginDbId;
-            if (!workerManager.isRunning(dbId)) {
-                throw new Error(`Cannot execute tool "${namespacedName}" — ` +
-                    `worker for plugin "${pluginId}" is not running.`);
-            }
-            // 5. Dispatch the executeTool RPC call to the worker
-            log.debug({ pluginId, pluginDbId: dbId, toolName, namespacedName, agentId: runContext.agentId, runId: runContext.runId }, "executing tool via plugin worker");
-            const rpcParams = {
-                toolName,
-                parameters,
-                runContext,
-            };
-            const result = await workerManager.call(dbId, "executeTool", rpcParams);
-            log.debug({
-                pluginId,
-                toolName,
-                namespacedName,
-                hasContent: !!result.content,
-                hasData: result.data !== undefined,
-                hasError: !!result.error,
-            }, "tool execution completed");
-            return { pluginId, toolName, result };
-        },
-        toolCount(pluginId) {
-            if (pluginId !== undefined) {
-                return byPlugin.get(pluginId)?.size ?? 0;
-            }
-            return byNamespace.size;
-        },
-    };
-}
-//# sourceMappingURL=plugin-tool-registry.js.map

package/dist/runtime/server/dist/services/plugin-tool-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-tool-registry.js","sourceRoot":"","sources":["../../src/services/plugin-tool-registry.ts"],"names":[],"mappings":"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"}