@growthub/cli 0.3.13 → 0.3.15

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

@@ -0,0 +1,224 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,192 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,224 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-tool-registry.js","sourceRoot":"","sources":["../../src/services/plugin-tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AA2J5C,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAmC;IAEnC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAE9D,8CAA8C;IAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEtD,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEhD,0EAA0E;IAC1E,mBAAmB;IACnB,0EAA0E;IAE1E,SAAS,SAAS,CAAC,QAAgB,EAAE,QAAgB;QACnD,OAAO,GAAG,QAAQ,GAAG,wBAAwB,GAAG,QAAQ,EAAE,CAAC;IAC7D,CAAC;IAED,SAAS,SAAS,CAAC,cAAsB;QACvC,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;QACtE,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;YAC3C,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;SAC7C,CAAC;IACJ,CAAC;IAED,SAAS,OAAO,CAAC,QAAgB,EAAE,IAA2B,EAAE,UAAkB;QAChF,MAAM,cAAc,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtD,MAAM,KAAK,GAAmB;YAC5B,QAAQ;YACR,UAAU;YACV,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,cAAc;YACd,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC;QAEF,WAAW,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAEvC,IAAI,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACtC,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,iBAAiB,CAAC,QAAgB;QACzC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,WAAW;YAAE,OAAO,CAAC,CAAC;QAE3B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0EAA0E;IAC1E,aAAa;IACb,0EAA0E;IAE1E,OAAO;QACL,cAAc,CAAC,QAAgB,EAAE,QAAmC,EAAE,UAAmB;YACvF,MAAM,IAAI,GAAG,UAAU,IAAI,QAAQ,CAAC;YAEpC,sEAAsE;YACtE,MAAM,aAAa,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,GAAG,CAAC,KAAK,CACP,EAAE,QAAQ,EAAE,aAAa,EAAE,EAC3B,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,GAAG,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,0BAA0B,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;YAED,GAAG,CAAC,IAAI,CACN;gBACE,QAAQ;gBACR,SAAS,EAAE,KAAK,CAAC,MAAM;gBACvB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;aACrD,EACD,cAAc,KAAK,CAAC,MAAM,qBAAqB,CAChD,CAAC;QACJ,CAAC;QAED,gBAAgB,CAAC,QAAgB;YAC/B,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,GAAG,CAAC,IAAI,CACN,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,EACnC,gBAAgB,OAAO,qBAAqB,CAC7C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,CAAC,cAAsB;YAC5B,OAAO,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC;QACjD,CAAC;QAED,eAAe,CAAC,QAAgB,EAAE,QAAgB;YAChD,MAAM,cAAc,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACrD,OAAO,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC;QACjD,CAAC;QAED,SAAS,CAAC,MAAuB;YAC/B,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACrB,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAClD,IAAI,CAAC,WAAW;oBAAE,OAAO,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAqB,EAAE,CAAC;gBACpC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;oBAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACnC,IAAI,IAAI;wBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,mBAAmB,CAAC,cAAsB;YACxC,OAAO,SAAS,CAAC,cAAc,CAAC,CAAC;QACnC,CAAC;QAED,mBAAmB,CAAC,QAAgB,EAAE,QAAgB;YACpD,OAAO,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,WAAW,CACf,cAAsB,EACtB,UAAmB,EACnB,UAA0B;YAE1B,iCAAiC;YACjC,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,sBAAsB,cAAc,kCAAkC,wBAAwB,aAAa,CAC5G,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;YAEtC,mCAAmC;YACnC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CACb,SAAS,cAAc,uBAAuB;oBAC9C,mEAAmE,CACpE,CAAC;YACJ,CAAC;YAED,4CAA4C;YAC5C,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACb,wBAAwB,cAAc,oCAAoC;oBAC1E,gDAAgD,CACjD,CAAC;YACJ,CAAC;YAED,yEAAyE;YACzE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7B,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,wBAAwB,cAAc,MAAM;oBAC5C,sBAAsB,QAAQ,mBAAmB,CAClD,CAAC;YACJ,CAAC;YAED,qDAAqD;YACrD,GAAG,CAAC,KAAK,CACP,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,EAC9G,kCAAkC,CACnC,CAAC;YAEF,MAAM,SAAS,GAAsB;gBACnC,QAAQ;gBACR,UAAU;gBACV,UAAU;aACX,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;YAExE,GAAG,CAAC,KAAK,CACP;gBACE,QAAQ;gBACR,QAAQ;gBACR,cAAc;gBACd,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;gBAC5B,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS;gBAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK;aACzB,EACD,0BAA0B,CAC3B,CAAC;YAEF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACxC,CAAC;QAED,SAAS,CAAC,QAAiB;YACzB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,WAAW,CAAC,IAAI,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}