@frontmcp/sdk 0.4.0 → 0.5.0

package/src/tool/flows/tools-list.flow.js

@@ -5,12 +5,15 @@ const tslib_1 = require("tslib");
 const common_1 = require("../../common");
 require("reflect-metadata");
 const zod_1 = require("zod");
+const v4_1 = require("zod/v4");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const zod_to_json_schema_1 = require("zod-to-json-schema");
 const errors_1 = require("../../errors");
+const ui_1 = require("../ui");
+const build_1 = require("@frontmcp/ui/build");
+const types_1 = require("@frontmcp/ui/types");
 const inputSchema = zod_1.z.object({
     request: types_js_1.ListToolsRequestSchema,
-    ctx: zod_1.z.any(),
+    ctx: zod_1.z.unknown(),
 });
 const outputSchema = types_js_1.ListToolsResultSchema;
 const stateSchema = zod_1.z.object({
@@ -49,7 +52,7 @@ let ToolsListFlow = class ToolsListFlow extends common_1.FlowBase {
             params = inputData.request.params;
         }
         catch (e) {
-            throw new errors_1.InvalidInputError('Invalid request format', e instanceof zod_1.z.ZodError ? e.errors : undefined);
+            throw new errors_1.InvalidInputError('Invalid request format', e instanceof zod_1.z.ZodError ? e.issues : undefined);
         }
         if (method !== 'tools/list') {
             this.logger.warn(`parseInput: invalid method "${method}"`);
@@ -119,13 +122,109 @@ let ToolsListFlow = class ToolsListFlow extends common_1.FlowBase {
         this.logger.verbose('parseTools:start');
         try {
             const resolved = this.state.required.resolvedTools;
-            const tools = resolved.map(({ finalName, tool }) => ({
-                name: finalName,
-                title: tool.metadata.name,
-                description: tool.metadata.description,
-                annotations: tool.metadata.annotations,
-                inputSchema: tool.metadata.rawInputSchema ?? (0, zod_to_json_schema_1.zodToJsonSchema)(zod_1.z.object(tool.metadata.inputSchema)),
-            }));
+            const tools = resolved.map(({ finalName, tool }) => {
+                // Get the input schema - prefer rawInputSchema (JSON Schema), then convert from tool.inputSchema
+                let inputSchema;
+                if (tool.rawInputSchema) {
+                    // Already converted to JSON Schema
+                    inputSchema = tool.rawInputSchema;
+                }
+                else if (tool.inputSchema && Object.keys(tool.inputSchema).length > 0) {
+                    // tool.inputSchema is a ZodRawShape (extracted .shape from ZodObject in ToolInstance constructor)
+                    // Convert to JSON Schema
+                    try {
+                        // as any used here to prevent hard ts-check on tool input that is redundant
+                        // and just slow down the build process. types here are unnecessary.
+                        inputSchema = (0, v4_1.toJSONSchema)(zod_1.z.object(tool.inputSchema));
+                    }
+                    catch (e) {
+                        this.logger.warn(`Failed to convert inputSchema for tool ${finalName}:`, e);
+                        inputSchema = { type: 'object', properties: {} };
+                    }
+                }
+                else {
+                    // No schema defined - use empty object schema
+                    inputSchema = { type: 'object', properties: {} };
+                }
+                const item = {
+                    name: finalName,
+                    title: tool.metadata.name,
+                    description: tool.metadata.description,
+                    annotations: tool.metadata.annotations,
+                    inputSchema,
+                };
+                // Add OpenAI _meta for tools with UI configuration
+                // This is CRITICAL for ChatGPT to discover widget-producing tools at listing time
+                // NOTE: Use static URI (like pizzaz example: ui://widget/tool-name.html), NOT template with {requestId}
+                // OpenAI tries to fetch the outputTemplate URI directly at discovery time
+                if ((0, ui_1.hasUIConfig)(tool.metadata)) {
+                    const uiConfig = tool.metadata.ui;
+                    if (!uiConfig) {
+                        // This should never happen if hasUIConfig returned true
+                        return item;
+                    }
+                    // Get manifest info from registry (if available)
+                    // Type guard: verify scope has toolUI with required methods before accessing
+                    const isValidScope = (obj) => {
+                        return (obj !== null &&
+                            typeof obj === 'object' &&
+                            'toolUI' in obj &&
+                            typeof obj.toolUI === 'object' &&
+                            obj.toolUI !== null &&
+                            typeof obj.toolUI.getManifest === 'function' &&
+                            typeof obj.toolUI.detectUIType === 'function');
+                    };
+                    if (!isValidScope(this.scope)) {
+                        this.logger.warn(`parseTools: toolUI not available in scope for ${finalName}`);
+                        return item;
+                    }
+                    const scope = this.scope;
+                    // Get manifest and detect UI type with error handling
+                    let manifest;
+                    let detectedType;
+                    try {
+                        manifest = scope.toolUI.getManifest(finalName);
+                        detectedType = scope.toolUI.detectUIType(uiConfig.template);
+                    }
+                    catch (error) {
+                        this.logger.warn(`parseTools: failed to access toolUI for ${finalName}`, error);
+                        return item;
+                    }
+                    // Use centralized type guard from @frontmcp/ui/types
+                    const uiType = manifest?.uiType ?? ((0, types_1.isUIType)(detectedType) ? detectedType : 'auto');
+                    // Always include outputTemplate for all UI tools
+                    // - static mode: Full widget with React runtime and bridge
+                    // - inline mode: Lean shell (just HTML + theme), actual widget comes in tool response
+                    const meta = {
+                        'openai/outputTemplate': `ui://widget/${encodeURIComponent(finalName)}.html`,
+                        'openai/resultCanProduceWidget': true,
+                        'openai/widgetAccessible': uiConfig.widgetAccessible ?? false,
+                        // CDN info for client-side resource loading
+                        'ui/cdn': (0, build_1.buildCDNInfoForUIType)(uiType),
+                    };
+                    // Add manifest information for client-side renderer selection
+                    if (manifest) {
+                        meta['ui/type'] = manifest.uiType;
+                        meta['ui/manifestUri'] = `ui://widget/${encodeURIComponent(finalName)}/manifest.json`;
+                        meta['ui/displayMode'] = manifest.displayMode;
+                        meta['ui/bundlingMode'] = manifest.bundlingMode;
+                    }
+                    else if (uiConfig.template) {
+                        // Fallback to detecting UI type from template
+                        meta['ui/type'] = uiType;
+                        // Note: ui/manifestUri is only set when a manifest exists in the registry
+                    }
+                    // Add invocation status if configured
+                    if (uiConfig.invocationStatus?.invoking) {
+                        meta['openai/toolInvocation/invoking'] = uiConfig.invocationStatus.invoking;
+                    }
+                    if (uiConfig.invocationStatus?.invoked) {
+                        meta['openai/toolInvocation/invoked'] = uiConfig.invocationStatus.invoked;
+                    }
+                    item._meta = meta;
+                }
+                return item;
+            });
             const preview = this.sample(tools.map((t) => t.name)).join(', ');
             const extra = tools.length > 5 ? `, +${tools.length - 5} more` : '';
             this.logger.info(`parseTools: prepared ${tools.length} tool descriptor(s): ${preview}${extra}`);
@@ -134,6 +233,8 @@ let ToolsListFlow = class ToolsListFlow extends common_1.FlowBase {
             this.logger.verbose('parseTools:done');
         }
         catch (error) {
+            if (error instanceof common_1.FlowControl)
+                throw error;
             this.logger.error('parseTools: failed to parse tools', error);
             throw error;
         }

package/src/tool/flows/tools-list.flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools-list.flow.js","sourceRoot":"","sources":["../../../../src/tool/flows/tools-list.flow.ts"],"names":[],"mappings":"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","sourcesContent":["// tools/flows/list-tools.flow.ts\nimport { Flow, FlowBase, FlowHooksOf, FlowPlan, FlowRunOptions, ToolEntry } from '../../common';\nimport 'reflect-metadata';\nimport { z } from 'zod';\nimport { ListToolsRequestSchema, ListToolsResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { zodToJsonSchema } from 'zod-to-json-schema';\nimport { InvalidMethodError, InvalidInputError } from '../../errors';\n\nconst inputSchema = z.object({\n  request: ListToolsRequestSchema,\n  ctx: z.any(),\n});\n\nconst outputSchema = ListToolsResultSchema;\n\nconst stateSchema = z.object({\n  cursor: z.string().optional(),\n  tools: z.array(\n    z.object({\n      appName: z.string(),\n      tool: z.instanceof(ToolEntry),\n    }),\n  ),\n  resolvedTools: z.array(\n    z.object({\n      appName: z.string(),\n      tool: z.instanceof(ToolEntry),\n      finalName: z.string(),\n    }),\n  ),\n});\n\ntype ResponseToolItem = z.infer<typeof outputSchema>['tools'][number];\n\n// TODO: add support for pagination\n// TODO: add support for session based tools\nconst plan = {\n  pre: ['parseInput'],\n  execute: ['findTools', 'resolveConflicts'],\n  post: ['parseTools'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'tools:list-tools': FlowRunOptions<\n      ToolsListFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'tools:list-tools' as const;\nconst { Stage } = FlowHooksOf('tools:list-tools');\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class ToolsListFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('ToolsListFlow');\n\n  private sample<T>(arr: T[], n = 5): T[] {\n    return arr.slice(0, n);\n  }\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: any;\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params;\n    } catch (e) {\n      throw new InvalidInputError('Invalid request format', e instanceof z.ZodError ? e.errors : undefined);\n    }\n\n    if (method !== 'tools/list') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'tools/list');\n    }\n\n    const cursor = params?.cursor;\n    if (cursor) this.logger.verbose(`parseInput: cursor=${cursor}`);\n    this.state.set('cursor', cursor);\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('findTools')\n  async findTools() {\n    this.logger.info('findTools:start');\n\n    try {\n      const apps = this.scope.apps.getApps();\n      this.logger.info(`findTools: discovered ${apps.length} app(s)`);\n\n      const tools: Array<{ appName: string; tool: ToolEntry }> = [];\n\n      const scopeTools = this.scope.tools.getTools();\n      this.logger.verbose(`findTools: scope tools=${scopeTools.length}`);\n\n      for (const tool of scopeTools) {\n        tools.push({ appName: tool.owner.id, tool });\n      }\n\n      this.logger.info(`findTools: total tools collected=${tools.length}`);\n      if (tools.length === 0) {\n        this.logger.warn('findTools: no tools found across apps');\n      }\n\n      this.state.set('tools', tools);\n      this.logger.verbose('findTools:done');\n    } catch (error) {\n      this.logger.error('findTools: failed to collect tools', error);\n      throw error;\n    }\n  }\n\n  @Stage('resolveConflicts')\n  async resolveConflicts() {\n    this.logger.verbose('resolveConflicts:start');\n\n    try {\n      const found = this.state.required.tools;\n\n      const counts = new Map<string, number>();\n      for (const { tool } of found) {\n        const baseName = tool.metadata.id ?? tool.metadata.name;\n        counts.set(baseName, (counts.get(baseName) ?? 0) + 1);\n      }\n\n      const conflicts = new Set<string>([...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k));\n\n      if (conflicts.size > 0) {\n        const preview = this.sample(Array.from(conflicts)).join(', ');\n        const extra = conflicts.size > 5 ? `, +${conflicts.size - 5} more` : '';\n        this.logger.warn(`resolveConflicts: ${conflicts.size} name conflict(s) detected: ${preview}${extra}`);\n      } else {\n        this.logger.info('resolveConflicts: no name conflicts detected');\n      }\n\n      const resolved = found.map(({ appName, tool }) => {\n        const baseName = tool.metadata.id ?? tool.metadata.name;\n        const finalName = conflicts.has(baseName) ? `${appName}:${baseName}` : baseName;\n        return { appName, tool, finalName };\n      });\n\n      this.state.set('resolvedTools', resolved);\n      this.logger.verbose('resolveConflicts:done');\n    } catch (error) {\n      this.logger.error('resolveConflicts: failed to resolve conflicts', error);\n      throw error;\n    }\n  }\n\n  @Stage('parseTools')\n  async parseTools() {\n    this.logger.verbose('parseTools:start');\n\n    try {\n      const resolved = this.state.required.resolvedTools;\n\n      const tools: ResponseToolItem[] = resolved.map(({ finalName, tool }) => ({\n        name: finalName,\n        title: tool.metadata.name,\n        description: tool.metadata.description,\n        annotations: tool.metadata.annotations,\n        inputSchema:\n          (tool.metadata as any).rawInputSchema ?? (zodToJsonSchema(z.object(tool.metadata.inputSchema) as any) as any),\n      }));\n\n      const preview = this.sample(tools.map((t) => t.name)).join(', ');\n      const extra = tools.length > 5 ? `, +${tools.length - 5} more` : '';\n      this.logger.info(`parseTools: prepared ${tools.length} tool descriptor(s): ${preview}${extra}`);\n\n      this.respond({ tools });\n      this.logger.info('parseTools: response sent');\n      this.logger.verbose('parseTools:done');\n    } catch (error) {\n      this.logger.error('parseTools: failed to parse tools', error);\n      throw error;\n    }\n  }\n}\n"]}
+{"version":3,"file":"tools-list.flow.js","sourceRoot":"","sources":["../../../../src/tool/flows/tools-list.flow.ts"],"names":[],"mappings":"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","sourcesContent":["// tools/flows/list-tools.flow.ts\nimport { Flow, FlowBase, FlowControl, FlowHooksOf, FlowPlan, FlowRunOptions, ToolEntry } from '../../common';\nimport 'reflect-metadata';\nimport { z } from 'zod';\nimport { toJSONSchema } from 'zod/v4';\nimport { ListToolsRequestSchema, ListToolsResultSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { InvalidMethodError, InvalidInputError } from '../../errors';\nimport { hasUIConfig } from '../ui';\nimport { buildCDNInfoForUIType, type UIType } from '@frontmcp/ui/build';\nimport { isUIType } from '@frontmcp/ui/types';\nimport type { Scope } from '../../scope/scope.instance';\n\nconst inputSchema = z.object({\n  request: ListToolsRequestSchema,\n  ctx: z.unknown(),\n});\n\nconst outputSchema = ListToolsResultSchema;\n\nconst stateSchema = z.object({\n  cursor: z.string().optional(),\n  tools: z.array(\n    z.object({\n      appName: z.string(),\n      tool: z.instanceof(ToolEntry),\n    }),\n  ),\n  resolvedTools: z.array(\n    z.object({\n      appName: z.string(),\n      tool: z.instanceof(ToolEntry),\n      finalName: z.string(),\n    }),\n  ),\n});\n\ntype ResponseToolItem = z.infer<typeof outputSchema>['tools'][number];\n\n// TODO: add support for pagination\n// TODO: add support for session based tools\nconst plan = {\n  pre: ['parseInput'],\n  execute: ['findTools', 'resolveConflicts'],\n  post: ['parseTools'],\n} as const satisfies FlowPlan<string>;\n\ndeclare global {\n  interface ExtendFlows {\n    'tools:list-tools': FlowRunOptions<\n      ToolsListFlow,\n      typeof plan,\n      typeof inputSchema,\n      typeof outputSchema,\n      typeof stateSchema\n    >;\n  }\n}\n\nconst name = 'tools:list-tools' as const;\nconst { Stage } = FlowHooksOf('tools:list-tools');\n\n@Flow({\n  name,\n  plan,\n  inputSchema,\n  outputSchema,\n  access: 'authorized',\n})\nexport default class ToolsListFlow extends FlowBase<typeof name> {\n  logger = this.scopeLogger.child('ToolsListFlow');\n\n  private sample<T>(arr: T[], n = 5): T[] {\n    return arr.slice(0, n);\n  }\n\n  @Stage('parseInput')\n  async parseInput() {\n    this.logger.verbose('parseInput:start');\n\n    let method!: string;\n    let params: any;\n    try {\n      const inputData = inputSchema.parse(this.rawInput);\n      method = inputData.request.method;\n      params = inputData.request.params;\n    } catch (e) {\n      throw new InvalidInputError('Invalid request format', e instanceof z.ZodError ? e.issues : undefined);\n    }\n\n    if (method !== 'tools/list') {\n      this.logger.warn(`parseInput: invalid method \"${method}\"`);\n      throw new InvalidMethodError(method, 'tools/list');\n    }\n\n    const cursor = params?.cursor;\n    if (cursor) this.logger.verbose(`parseInput: cursor=${cursor}`);\n    this.state.set('cursor', cursor);\n    this.logger.verbose('parseInput:done');\n  }\n\n  @Stage('findTools')\n  async findTools() {\n    this.logger.info('findTools:start');\n\n    try {\n      const apps = this.scope.apps.getApps();\n      this.logger.info(`findTools: discovered ${apps.length} app(s)`);\n\n      const tools: Array<{ appName: string; tool: ToolEntry }> = [];\n\n      const scopeTools = this.scope.tools.getTools();\n      this.logger.verbose(`findTools: scope tools=${scopeTools.length}`);\n\n      for (const tool of scopeTools) {\n        tools.push({ appName: tool.owner.id, tool });\n      }\n\n      this.logger.info(`findTools: total tools collected=${tools.length}`);\n      if (tools.length === 0) {\n        this.logger.warn('findTools: no tools found across apps');\n      }\n\n      this.state.set('tools', tools);\n      this.logger.verbose('findTools:done');\n    } catch (error) {\n      this.logger.error('findTools: failed to collect tools', error);\n      throw error;\n    }\n  }\n\n  @Stage('resolveConflicts')\n  async resolveConflicts() {\n    this.logger.verbose('resolveConflicts:start');\n\n    try {\n      const found = this.state.required.tools;\n\n      const counts = new Map<string, number>();\n      for (const { tool } of found) {\n        const baseName = tool.metadata.id ?? tool.metadata.name;\n        counts.set(baseName, (counts.get(baseName) ?? 0) + 1);\n      }\n\n      const conflicts = new Set<string>([...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k));\n\n      if (conflicts.size > 0) {\n        const preview = this.sample(Array.from(conflicts)).join(', ');\n        const extra = conflicts.size > 5 ? `, +${conflicts.size - 5} more` : '';\n        this.logger.warn(`resolveConflicts: ${conflicts.size} name conflict(s) detected: ${preview}${extra}`);\n      } else {\n        this.logger.info('resolveConflicts: no name conflicts detected');\n      }\n\n      const resolved = found.map(({ appName, tool }) => {\n        const baseName = tool.metadata.id ?? tool.metadata.name;\n        const finalName = conflicts.has(baseName) ? `${appName}:${baseName}` : baseName;\n        return { appName, tool, finalName };\n      });\n\n      this.state.set('resolvedTools', resolved);\n      this.logger.verbose('resolveConflicts:done');\n    } catch (error) {\n      this.logger.error('resolveConflicts: failed to resolve conflicts', error);\n      throw error;\n    }\n  }\n\n  @Stage('parseTools')\n  async parseTools() {\n    this.logger.verbose('parseTools:start');\n\n    try {\n      const resolved = this.state.required.resolvedTools;\n\n      const tools: ResponseToolItem[] = resolved.map(({ finalName, tool }) => {\n        // Get the input schema - prefer rawInputSchema (JSON Schema), then convert from tool.inputSchema\n        let inputSchema: any;\n        if (tool.rawInputSchema) {\n          // Already converted to JSON Schema\n          inputSchema = tool.rawInputSchema;\n        } else if (tool.inputSchema && Object.keys(tool.inputSchema).length > 0) {\n          // tool.inputSchema is a ZodRawShape (extracted .shape from ZodObject in ToolInstance constructor)\n          // Convert to JSON Schema\n          try {\n            // as any used here to prevent hard ts-check on tool input that is redundant\n            // and just slow down the build process. types here are unnecessary.\n            inputSchema = toJSONSchema(z.object(tool.inputSchema));\n          } catch (e) {\n            this.logger.warn(`Failed to convert inputSchema for tool ${finalName}:`, e);\n            inputSchema = { type: 'object', properties: {} };\n          }\n        } else {\n          // No schema defined - use empty object schema\n          inputSchema = { type: 'object', properties: {} };\n        }\n\n        const item: ResponseToolItem = {\n          name: finalName,\n          title: tool.metadata.name,\n          description: tool.metadata.description,\n          annotations: tool.metadata.annotations,\n          inputSchema,\n        };\n\n        // Add OpenAI _meta for tools with UI configuration\n        // This is CRITICAL for ChatGPT to discover widget-producing tools at listing time\n        // NOTE: Use static URI (like pizzaz example: ui://widget/tool-name.html), NOT template with {requestId}\n        // OpenAI tries to fetch the outputTemplate URI directly at discovery time\n        if (hasUIConfig(tool.metadata)) {\n          const uiConfig = tool.metadata.ui;\n          if (!uiConfig) {\n            // This should never happen if hasUIConfig returned true\n            return item;\n          }\n\n          // Get manifest info from registry (if available)\n          // Type guard: verify scope has toolUI with required methods before accessing\n          const isValidScope = (obj: unknown): obj is Scope => {\n            return (\n              obj !== null &&\n              typeof obj === 'object' &&\n              'toolUI' in obj &&\n              typeof (obj as { toolUI?: unknown }).toolUI === 'object' &&\n              (obj as { toolUI?: unknown }).toolUI !== null &&\n              typeof (obj as { toolUI: { getManifest?: unknown } }).toolUI.getManifest === 'function' &&\n              typeof (obj as { toolUI: { detectUIType?: unknown } }).toolUI.detectUIType === 'function'\n            );\n          };\n\n          if (!isValidScope(this.scope)) {\n            this.logger.warn(`parseTools: toolUI not available in scope for ${finalName}`);\n            return item;\n          }\n          const scope = this.scope;\n\n          // Get manifest and detect UI type with error handling\n          let manifest;\n          let detectedType: string;\n          try {\n            manifest = scope.toolUI.getManifest(finalName);\n            detectedType = scope.toolUI.detectUIType(uiConfig.template);\n          } catch (error) {\n            this.logger.warn(`parseTools: failed to access toolUI for ${finalName}`, error);\n            return item;\n          }\n\n          // Use centralized type guard from @frontmcp/ui/types\n          const uiType: UIType = manifest?.uiType ?? (isUIType(detectedType) ? detectedType : 'auto');\n\n          // Always include outputTemplate for all UI tools\n          // - static mode: Full widget with React runtime and bridge\n          // - inline mode: Lean shell (just HTML + theme), actual widget comes in tool response\n          const meta: Record<string, unknown> = {\n            'openai/outputTemplate': `ui://widget/${encodeURIComponent(finalName)}.html`,\n            'openai/resultCanProduceWidget': true,\n            'openai/widgetAccessible': uiConfig.widgetAccessible ?? false,\n            // CDN info for client-side resource loading\n            'ui/cdn': buildCDNInfoForUIType(uiType),\n          };\n\n          // Add manifest information for client-side renderer selection\n          if (manifest) {\n            meta['ui/type'] = manifest.uiType;\n            meta['ui/manifestUri'] = `ui://widget/${encodeURIComponent(finalName)}/manifest.json`;\n            meta['ui/displayMode'] = manifest.displayMode;\n            meta['ui/bundlingMode'] = manifest.bundlingMode;\n          } else if (uiConfig.template) {\n            // Fallback to detecting UI type from template\n            meta['ui/type'] = uiType;\n            // Note: ui/manifestUri is only set when a manifest exists in the registry\n          }\n\n          // Add invocation status if configured\n          if (uiConfig.invocationStatus?.invoking) {\n            meta['openai/toolInvocation/invoking'] = uiConfig.invocationStatus.invoking;\n          }\n          if (uiConfig.invocationStatus?.invoked) {\n            meta['openai/toolInvocation/invoked'] = uiConfig.invocationStatus.invoked;\n          }\n\n          item._meta = meta;\n        }\n\n        return item;\n      });\n\n      const preview = this.sample(tools.map((t) => t.name)).join(', ');\n      const extra = tools.length > 5 ? `, +${tools.length - 5} more` : '';\n      this.logger.info(`parseTools: prepared ${tools.length} tool descriptor(s): ${preview}${extra}`);\n\n      this.respond({ tools });\n      this.logger.info('parseTools: response sent');\n      this.logger.verbose('parseTools:done');\n    } catch (error) {\n      if (error instanceof FlowControl) throw error;\n      this.logger.error('parseTools: failed to parse tools', error);\n      throw error;\n    }\n  }\n}\n"]}

package/src/tool/tool.events.d.ts

@@ -1,8 +1,15 @@
 import { ToolInstance } from './tool.instance';
 export type ToolChangeKind = 'added' | 'updated' | 'removed' | 'reset';
+/**
+ * The scope of a change event.
+ * - `global`: Change affects all sessions
+ * - `session`: Change affects only a specific session
+ */
+export type ToolChangeScope = 'global' | 'session';
 export type ToolChangeEvent = {
     kind: ToolChangeKind;
-    scope: 'global' | 'session';
+    /** Whether the change affects all sessions or a specific session */
+    changeScope: ToolChangeScope;
     sessionId?: string;
     relatedRequestId?: string;
     version: number;

package/src/tool/tool.events.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.events.js","sourceRoot":"","sources":["../../../src/tool/tool.events.ts"],"names":[],"mappings":";;;AAcA,MAAa,WAAW;IACd,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAExC,EAAE,CAAC,CAAW;QACZ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,CAAkB;QACrB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF;AAXD,kCAWC","sourcesContent":["import { ToolInstance } from './tool.instance';\n\nexport type ToolChangeKind = 'added' | 'updated' | 'removed' | 'reset';\nexport type ToolChangeEvent = {\n  kind: ToolChangeKind;\n  scope: 'global' | 'session';\n  sessionId?: string;\n  relatedRequestId?: string;\n  version: number;\n  snapshot: readonly ToolInstance[];\n};\n\ntype Listener = (e: ToolChangeEvent) => void;\n\nexport class ToolEmitter {\n  private listeners = new Set<Listener>();\n\n  on(l: Listener): () => void {\n    this.listeners.add(l);\n    return () => this.listeners.delete(l);\n  }\n\n  emit(e: ToolChangeEvent) {\n    for (const l of [...this.listeners]) l(e);\n  }\n}\n"]}
+{"version":3,"file":"tool.events.js","sourceRoot":"","sources":["../../../src/tool/tool.events.ts"],"names":[],"mappings":";;;AAuBA,MAAa,WAAW;IACd,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAExC,EAAE,CAAC,CAAW;QACZ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,CAAkB;QACrB,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF;AAXD,kCAWC","sourcesContent":["import { ToolInstance } from './tool.instance';\n\nexport type ToolChangeKind = 'added' | 'updated' | 'removed' | 'reset';\n\n/**\n * The scope of a change event.\n * - `global`: Change affects all sessions\n * - `session`: Change affects only a specific session\n */\nexport type ToolChangeScope = 'global' | 'session';\n\nexport type ToolChangeEvent = {\n  kind: ToolChangeKind;\n  /** Whether the change affects all sessions or a specific session */\n  changeScope: ToolChangeScope;\n  sessionId?: string;\n  relatedRequestId?: string;\n  version: number;\n  snapshot: readonly ToolInstance[];\n};\n\ntype Listener = (e: ToolChangeEvent) => void;\n\nexport class ToolEmitter {\n  private listeners = new Set<Listener>();\n\n  on(l: Listener): () => void {\n    this.listeners.add(l);\n    return () => this.listeners.delete(l);\n  }\n\n  emit(e: ToolChangeEvent) {\n    for (const l of [...this.listeners]) l(e);\n  }\n}\n"]}

package/src/tool/tool.instance.d.ts

@@ -14,7 +14,9 @@ export declare class ToolInstance<InSchema extends ToolInputType = ToolInputType
     readonly hooks: HookRegistry;
     constructor(record: ToolRecord, providers: ProviderRegistry, owner: EntryOwnerRef);
     protected initialize(): Promise<void>;
-    getMetadata(): import("../common").ToolMetadata<z.ZodRawShape, ToolOutputType>;
+    getMetadata(): import("../common").ToolMetadata<Readonly<{
+        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    }>, ToolOutputType>;
     getOutputSchema(): OutSchema | undefined;
     create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<InSchema, OutSchema, In, Out>;
     parseInput(input: CallToolRequest['params']): CallToolRequest['params']['arguments'];

package/src/tool/tool.instance.js

@@ -6,6 +6,7 @@ const common_1 = require("../common");
 const zod_1 = require("zod");
 const hooks_utils_1 = require("../hooks/hooks.utils");
 const tool_utils_1 = require("./tool.utils");
+const mcp_error_1 = require("../errors/mcp.error");
 class ToolInstance extends common_1.ToolEntry {
     providers;
     scope;
@@ -28,9 +29,22 @@ class ToolInstance extends common_1.ToolEntry {
         this.ready = this.initialize();
     }
     async initialize() {
-        const hooks = (0, hooks_utils_1.normalizeHooksFromCls)(this.record.provide).filter((hook) => hook.metadata.flow === 'tools:call-tool' || hook.metadata.flow === 'tools:list-tools');
-        if (hooks.length > 0) {
-            await this.hooks.registerHooks(true, ...hooks);
+        // Valid flows for tool hooks
+        const validFlows = ['tools:call-tool', 'tools:list-tools'];
+        const allHooks = (0, hooks_utils_1.normalizeHooksFromCls)(this.record.provide);
+        // Separate valid and invalid hooks
+        const validHooks = allHooks.filter((hook) => validFlows.includes(hook.metadata.flow));
+        const invalidHooks = allHooks.filter((hook) => !validFlows.includes(hook.metadata.flow));
+        // Throw error for invalid hooks (fail fast)
+        if (invalidHooks.length > 0) {
+            const className = this.record.provide?.name ?? 'Unknown';
+            const invalidFlowNames = invalidHooks.map((h) => h.metadata.flow).join(', ');
+            throw new mcp_error_1.InvalidHookFlowError(`Tool "${className}" has hooks for unsupported flows: ${invalidFlowNames}. ` +
+                `Only tool flows (${validFlows.join(', ')}) are supported on tool classes.`);
+        }
+        // Register valid hooks
+        if (validHooks.length > 0) {
+            await this.hooks.registerHooks(true, ...validHooks);
         }
         return Promise.resolve();
     }

package/src/tool/tool.instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.instance.js","sourceRoot":"","sources":["../../../src/tool/tool.instance.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAE3C,sCAgBmB;AAEnB,6BAAwB;AAGxB,sDAA6D;AAE7D,6CAAqD;AAErD,MAAa,YAKX,SAAQ,kBAAuC;IAC9B,SAAS,CAAmB;IACpC,KAAK,CAAQ;IACb,KAAK,CAAe;IAE7B,YAAY,MAAkB,EAAE,SAA2B,EAAE,KAAoB;QAC/E,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC;QAErD,MAAM,MAAM,GAAQ,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChD,+CAA+C;QAC/C,IAAI,CAAC,WAAW,GAAG,MAAM,YAAY,OAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;QAE/E,gEAAgE;QAChE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QAErD,oFAAoF;QACpF,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAyB,CAAC;QAE9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAES,KAAK,CAAC,UAAU;QACxB,MAAM,KAAK,GAAG,IAAA,mCAAqB,EAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAC7D,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,kBAAkB,CAChG,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEQ,MAAM,CAAC,KAAmB,EAAE,GAAkB;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAE9B,MAAM,YAAY,GAAqB;YACrC,QAAQ;YACR,KAAK,EAAE,KAAW;YAClB,SAAS;YACT,MAAM;YACN,QAAQ;SACT,CAAC;QACF,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,KAAK,iBAAQ,CAAC,WAAW;gBACvB,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAA8C,CAAC;YAC5F,KAAK,iBAAQ,CAAC,QAAQ;gBACpB,OAAO,IAAI,mBAAmB,CAA+B,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAEQ,UAAU,CAAC,KAAgC;QAClD,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IACD;;;;;;;;;;OAUG;IACM,WAAW,CAAC,GAA6B;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAmB,CAAC;QAE5C,OAAO,IAAA,kCAAqB,EAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAEQ,eAAe,CAAC,GAA6B;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAmB,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAA,kCAAqB,EAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;QACzE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AArGD,oCAqGC;AAED,MAAM,mBAKJ,SAAQ,oBAAyC;IACpB;IAA7B,YAA6B,MAA+B,EAAE,IAAsB;QAClF,KAAK,CAAC,IAAI,CAAC,CAAC;QADe,WAAM,GAAN,MAAM,CAAyB;IAE5D,CAAC;IAED,OAAO,CAAC,KAAS;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["// file: libs/sdk/src/tool/tool.instance.ts\n\nimport {\n  EntryOwnerRef,\n  ToolCallArgs,\n  ToolCallExtra,\n  ToolContext,\n  ToolCtorArgs,\n  ToolEntry,\n  ToolFunctionTokenRecord,\n  ToolInputType,\n  ToolKind,\n  ToolOutputType,\n  ToolRecord,\n  ParsedToolResult,\n  ToolInputOf,\n  ToolOutputOf,\n  SafeTransformResult,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { z } from 'zod';\nimport HookRegistry from '../hooks/hook.registry';\nimport { Scope } from '../scope';\nimport { normalizeHooksFromCls } from '../hooks/hooks.utils';\nimport type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { buildParsedToolResult } from './tool.utils';\n\nexport class ToolInstance<\n  InSchema extends ToolInputType = ToolInputType,\n  OutSchema extends ToolOutputType = ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> extends ToolEntry<InSchema, OutSchema, In, Out> {\n  private readonly providers: ProviderRegistry;\n  readonly scope: Scope;\n  readonly hooks: HookRegistry;\n\n  constructor(record: ToolRecord, providers: ProviderRegistry, owner: EntryOwnerRef) {\n    super(record);\n    this.owner = owner;\n    this.providers = providers;\n    this.name = record.metadata.id || record.metadata.name;\n    this.fullName = this.owner.id + ':' + this.name;\n    this.scope = this.providers.getActiveScope();\n    this.hooks = this.scope.providers.getHooksRegistry();\n\n    const schema: any = record.metadata.inputSchema;\n    // Support both Zod objects and raw ZodRawShape\n    this.inputSchema = schema instanceof z.ZodObject ? schema.shape : schema ?? {};\n\n    // Whatever JSON schema representation you’re storing for inputs\n    this.rawInputSchema = record.metadata.rawInputSchema;\n\n    // IMPORTANT: keep the *raw* outputSchema (string literal, zod, raw shape, or array)\n    this.outputSchema = record.metadata.outputSchema as OutSchema;\n\n    this.ready = this.initialize();\n  }\n\n  protected async initialize() {\n    const hooks = normalizeHooksFromCls(this.record.provide).filter(\n      (hook) => hook.metadata.flow === 'tools:call-tool' || hook.metadata.flow === 'tools:list-tools',\n    );\n    if (hooks.length > 0) {\n      await this.hooks.registerHooks(true, ...hooks);\n    }\n    return Promise.resolve();\n  }\n\n  getMetadata() {\n    return this.record.metadata;\n  }\n\n  override getOutputSchema() {\n    return this.outputSchema;\n  }\n\n  override create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<InSchema, OutSchema, In, Out> {\n    const metadata = this.metadata;\n    const providers = this.providers;\n    const scope = this.providers.getActiveScope();\n    const logger = scope.logger;\n    const authInfo = ctx.authInfo;\n\n    const toolCtorArgs: ToolCtorArgs<In> = {\n      metadata,\n      input: input as In,\n      providers,\n      logger,\n      authInfo,\n    };\n    switch (this.record.kind) {\n      case ToolKind.CLASS_TOKEN:\n        return new this.record.provide(toolCtorArgs) as ToolContext<InSchema, OutSchema, In, Out>;\n      case ToolKind.FUNCTION:\n        return new FunctionToolContext<InSchema, OutSchema, In, Out>(this.record, toolCtorArgs);\n    }\n  }\n\n  override parseInput(input: CallToolRequest['params']): CallToolRequest['params']['arguments'] {\n    const inputSchema = z.object(this.inputSchema);\n    return inputSchema.parse(input.arguments);\n  }\n  /**\n   * Turn the raw tool function result into an MCP-compliant CallToolResult:\n   *   - `content`: list of ContentBlocks (text / image / audio / resource / resource_link)\n   *   - `structuredContent`: sanitized JSON when outputSchema is \"json-like\"\n   *\n   * Rules:\n   *   - If outputSchema is a JS array → multiple content items, each with its own type.\n   *   - Primitive → stringifies into a TextContent block.\n   *   - image/audio/resource/resource_link → passed through as-is.\n   *   - JSON / structured → JSON.stringify for text, and full sanitized JSON in structuredContent.\n   */\n  override parseOutput(raw: Out | Partial<Out> | any): ParsedToolResult {\n    const descriptor = this.outputSchema as any;\n\n    return buildParsedToolResult(descriptor, raw);\n  }\n\n  override safeParseOutput(raw: Out | Partial<Out> | any): SafeTransformResult<ParsedToolResult> {\n    const descriptor = this.outputSchema as any;\n    try {\n      return { success: true, data: buildParsedToolResult(descriptor, raw) };\n    } catch (error: any) {\n      return { success: false, error };\n    }\n  }\n}\n\nclass FunctionToolContext<\n  InSchema extends ToolInputType,\n  OutSchema extends ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> extends ToolContext<InSchema, OutSchema, In, Out> {\n  constructor(private readonly record: ToolFunctionTokenRecord, args: ToolCtorArgs<In>) {\n    super(args);\n  }\n\n  execute(input: In): Promise<Out> {\n    return this.record.provide(input, this);\n  }\n}\n"]}
+{"version":3,"file":"tool.instance.js","sourceRoot":"","sources":["../../../src/tool/tool.instance.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;AAE3C,sCAgBmB;AAEnB,6BAAwB;AAGxB,sDAA6D;AAE7D,6CAAqD;AACrD,mDAA2D;AAE3D,MAAa,YAKX,SAAQ,kBAAuC;IAC9B,SAAS,CAAmB;IACpC,KAAK,CAAQ;IACb,KAAK,CAAe;IAE7B,YAAY,MAAkB,EAAE,SAA2B,EAAE,KAAoB;QAC/E,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC;QAErD,MAAM,MAAM,GAAQ,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChD,+CAA+C;QAC/C,IAAI,CAAC,WAAW,GAAG,MAAM,YAAY,OAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;QAE/E,gEAAgE;QAChE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QAErD,oFAAoF;QACpF,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAyB,CAAC;QAE9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAES,KAAK,CAAC,UAAU;QACxB,6BAA6B;QAC7B,MAAM,UAAU,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;QAE3D,MAAM,QAAQ,GAAG,IAAA,mCAAqB,EAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE5D,mCAAmC;QACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACtF,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAEzF,4CAA4C;QAC5C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAI,IAAI,CAAC,MAAM,CAAC,OAAe,EAAE,IAAI,IAAI,SAAS,CAAC;YAClE,MAAM,gBAAgB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7E,MAAM,IAAI,gCAAoB,CAC5B,SAAS,SAAS,sCAAsC,gBAAgB,IAAI;gBAC1E,oBAAoB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,kCAAkC,CAC9E,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAEQ,eAAe;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEQ,MAAM,CAAC,KAAmB,EAAE,GAAkB;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAE9B,MAAM,YAAY,GAAqB;YACrC,QAAQ;YACR,KAAK,EAAE,KAAW;YAClB,SAAS;YACT,MAAM;YACN,QAAQ;SACT,CAAC;QACF,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,KAAK,iBAAQ,CAAC,WAAW;gBACvB,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAA8C,CAAC;YAC5F,KAAK,iBAAQ,CAAC,QAAQ;gBACpB,OAAO,IAAI,mBAAmB,CAA+B,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAEQ,UAAU,CAAC,KAAgC;QAClD,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IACD;;;;;;;;;;OAUG;IACM,WAAW,CAAC,GAA6B;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAmB,CAAC;QAE5C,OAAO,IAAA,kCAAqB,EAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAEQ,eAAe,CAAC,GAA6B;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAmB,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAA,kCAAqB,EAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC;QACzE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AAtHD,oCAsHC;AAED,MAAM,mBAKJ,SAAQ,oBAAyC;IACpB;IAA7B,YAA6B,MAA+B,EAAE,IAAsB;QAClF,KAAK,CAAC,IAAI,CAAC,CAAC;QADe,WAAM,GAAN,MAAM,CAAyB;IAE5D,CAAC;IAED,OAAO,CAAC,KAAS;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF","sourcesContent":["// file: libs/sdk/src/tool/tool.instance.ts\n\nimport {\n  EntryOwnerRef,\n  ToolCallArgs,\n  ToolCallExtra,\n  ToolContext,\n  ToolCtorArgs,\n  ToolEntry,\n  ToolFunctionTokenRecord,\n  ToolInputType,\n  ToolKind,\n  ToolOutputType,\n  ToolRecord,\n  ParsedToolResult,\n  ToolInputOf,\n  ToolOutputOf,\n  SafeTransformResult,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { z } from 'zod';\nimport HookRegistry from '../hooks/hook.registry';\nimport { Scope } from '../scope';\nimport { normalizeHooksFromCls } from '../hooks/hooks.utils';\nimport type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';\nimport { buildParsedToolResult } from './tool.utils';\nimport { InvalidHookFlowError } from '../errors/mcp.error';\n\nexport class ToolInstance<\n  InSchema extends ToolInputType = ToolInputType,\n  OutSchema extends ToolOutputType = ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> extends ToolEntry<InSchema, OutSchema, In, Out> {\n  private readonly providers: ProviderRegistry;\n  readonly scope: Scope;\n  readonly hooks: HookRegistry;\n\n  constructor(record: ToolRecord, providers: ProviderRegistry, owner: EntryOwnerRef) {\n    super(record);\n    this.owner = owner;\n    this.providers = providers;\n    this.name = record.metadata.id || record.metadata.name;\n    this.fullName = this.owner.id + ':' + this.name;\n    this.scope = this.providers.getActiveScope();\n    this.hooks = this.scope.providers.getHooksRegistry();\n\n    const schema: any = record.metadata.inputSchema;\n    // Support both Zod objects and raw ZodRawShape\n    this.inputSchema = schema instanceof z.ZodObject ? schema.shape : schema ?? {};\n\n    // Whatever JSON schema representation you’re storing for inputs\n    this.rawInputSchema = record.metadata.rawInputSchema;\n\n    // IMPORTANT: keep the *raw* outputSchema (string literal, zod, raw shape, or array)\n    this.outputSchema = record.metadata.outputSchema as OutSchema;\n\n    this.ready = this.initialize();\n  }\n\n  protected async initialize() {\n    // Valid flows for tool hooks\n    const validFlows = ['tools:call-tool', 'tools:list-tools'];\n\n    const allHooks = normalizeHooksFromCls(this.record.provide);\n\n    // Separate valid and invalid hooks\n    const validHooks = allHooks.filter((hook) => validFlows.includes(hook.metadata.flow));\n    const invalidHooks = allHooks.filter((hook) => !validFlows.includes(hook.metadata.flow));\n\n    // Throw error for invalid hooks (fail fast)\n    if (invalidHooks.length > 0) {\n      const className = (this.record.provide as any)?.name ?? 'Unknown';\n      const invalidFlowNames = invalidHooks.map((h) => h.metadata.flow).join(', ');\n      throw new InvalidHookFlowError(\n        `Tool \"${className}\" has hooks for unsupported flows: ${invalidFlowNames}. ` +\n          `Only tool flows (${validFlows.join(', ')}) are supported on tool classes.`,\n      );\n    }\n\n    // Register valid hooks\n    if (validHooks.length > 0) {\n      await this.hooks.registerHooks(true, ...validHooks);\n    }\n    return Promise.resolve();\n  }\n\n  getMetadata() {\n    return this.record.metadata;\n  }\n\n  override getOutputSchema() {\n    return this.outputSchema;\n  }\n\n  override create(input: ToolCallArgs, ctx: ToolCallExtra): ToolContext<InSchema, OutSchema, In, Out> {\n    const metadata = this.metadata;\n    const providers = this.providers;\n    const scope = this.providers.getActiveScope();\n    const logger = scope.logger;\n    const authInfo = ctx.authInfo;\n\n    const toolCtorArgs: ToolCtorArgs<In> = {\n      metadata,\n      input: input as In,\n      providers,\n      logger,\n      authInfo,\n    };\n    switch (this.record.kind) {\n      case ToolKind.CLASS_TOKEN:\n        return new this.record.provide(toolCtorArgs) as ToolContext<InSchema, OutSchema, In, Out>;\n      case ToolKind.FUNCTION:\n        return new FunctionToolContext<InSchema, OutSchema, In, Out>(this.record, toolCtorArgs);\n    }\n  }\n\n  override parseInput(input: CallToolRequest['params']): CallToolRequest['params']['arguments'] {\n    const inputSchema = z.object(this.inputSchema);\n    return inputSchema.parse(input.arguments);\n  }\n  /**\n   * Turn the raw tool function result into an MCP-compliant CallToolResult:\n   *   - `content`: list of ContentBlocks (text / image / audio / resource / resource_link)\n   *   - `structuredContent`: sanitized JSON when outputSchema is \"json-like\"\n   *\n   * Rules:\n   *   - If outputSchema is a JS array → multiple content items, each with its own type.\n   *   - Primitive → stringifies into a TextContent block.\n   *   - image/audio/resource/resource_link → passed through as-is.\n   *   - JSON / structured → JSON.stringify for text, and full sanitized JSON in structuredContent.\n   */\n  override parseOutput(raw: Out | Partial<Out> | any): ParsedToolResult {\n    const descriptor = this.outputSchema as any;\n\n    return buildParsedToolResult(descriptor, raw);\n  }\n\n  override safeParseOutput(raw: Out | Partial<Out> | any): SafeTransformResult<ParsedToolResult> {\n    const descriptor = this.outputSchema as any;\n    try {\n      return { success: true, data: buildParsedToolResult(descriptor, raw) };\n    } catch (error: any) {\n      return { success: false, error };\n    }\n  }\n}\n\nclass FunctionToolContext<\n  InSchema extends ToolInputType,\n  OutSchema extends ToolOutputType,\n  In = ToolInputOf<{ inputSchema: InSchema }>,\n  Out = ToolOutputOf<{ outputSchema: OutSchema }>,\n> extends ToolContext<InSchema, OutSchema, In, Out> {\n  constructor(private readonly record: ToolFunctionTokenRecord, args: ToolCtorArgs<In>) {\n    super(args);\n  }\n\n  execute(input: In): Promise<Out> {\n    return this.record.provide(input, this);\n  }\n}\n"]}

package/src/tool/tool.registry.d.ts

@@ -3,7 +3,8 @@ import { ToolChangeEvent } from './tool.events';
 import ProviderRegistry from '../provider/provider.registry';
 import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
 import { ToolInstance } from './tool.instance';
-import { ExportNameOptions } from "./tool.types";
+import { ExportNameOptions } from './tool.types';
+import { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
 export default class ToolRegistry extends RegistryAbstract<ToolInstance, // IMPORTANT: instances map holds ToolInstance (not the interface)
 ToolRecord, ToolType[]> implements ToolRegistryInterface {
     /** Who owns this registry (used for provenance). Optional. */
@@ -69,4 +70,9 @@ ToolRecord, ToolType[]> implements ToolRegistryInterface {
     private providerIdOf;
     /** True if this registry (or adopted children) has any tools. */
     hasAny(): boolean;
+    /**
+     * Get the MCP capabilities for tools.
+     * These are reported to clients during initialization.
+     */
+    getCapabilities(): Partial<ServerCapabilities>;
 }

package/src/tool/tool.registry.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const metadata_utils_1 = require("../utils/metadata.utils");
+const utils_1 = require("../utils");
 const tool_events_1 = require("./tool.events");
 const tool_utils_1 = require("./tool.utils");
-const token_utils_1 = require("../utils/token.utils");
 const regsitry_1 = require("../regsitry");
 const tool_instance_1 = require("./tool.instance");
 const tool_types_1 = require("./tool.types");
@@ -124,11 +123,14 @@ class ToolRegistry extends regsitry_1.RegistryAbstract {
         this.reindex();
         this.bump('reset');
     }
+    // NOTE: `any` is intentional here - heterogeneous tool collections can't use `unknown`
+    // because ToolEntry has constrained generics (InSchema extends ToolInputType, etc.)
     getTools(includeHidden = false) {
-        const local = [...this.localRows].flat().map(t => t.instance);
-        const adopted = [...this.adopted.values()].flat().map(t => t.instance);
-        return [...local, ...adopted].filter(t => t.metadata.hideFromDiscovery !== true || includeHidden);
+        const local = [...this.localRows].flat().map((t) => t.instance);
+        const adopted = [...this.adopted.values()].flat().map((t) => t.instance);
+        return [...local, ...adopted].filter((t) => t.metadata.hideFromDiscovery !== true || includeHidden);
     }
+    // NOTE: `any` is intentional - see getTools comment above
     getInlineTools() {
         return [...this.instances.values()];
     }
@@ -257,7 +259,7 @@ class ToolRegistry extends regsitry_1.RegistryAbstract {
         if (opts.immediate) {
             cb({
                 kind: 'reset',
-                scope: 'global',
+                changeScope: 'global',
                 version: this.version,
                 snapshot: this.listAllInstances().filter(filter),
             });
@@ -266,7 +268,7 @@ class ToolRegistry extends regsitry_1.RegistryAbstract {
     }
     bump(kind) {
         const version = ++this.version;
-        this.emitter.emit({ kind, scope: 'global', version, snapshot: this.listAllInstances() });
+        this.emitter.emit({ kind, changeScope: 'global', version, snapshot: this.listAllInstances() });
     }
     /* -------------------- Helpers -------------------- */
     /** Build an IndexedTool row */
@@ -274,7 +276,7 @@ class ToolRegistry extends regsitry_1.RegistryAbstract {
         const ownerKey = (0, tool_utils_1.ownerKeyOf)(lineage);
         const baseName = instance.name;
         const qualifiedName = (0, tool_utils_1.qualifiedNameOf)(lineage, baseName);
-        const qualifiedId = `${ownerKey}:${(0, token_utils_1.tokenName)(token)}`;
+        const qualifiedId = `${ownerKey}:${(0, utils_1.tokenName)(token)}`;
         return { token, instance, baseName, lineage, ownerKey, qualifiedName, qualifiedId, source };
     }
     /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */
@@ -283,7 +285,7 @@ class ToolRegistry extends regsitry_1.RegistryAbstract {
         const lineage = dedupLineage(merged);
         const ownerKey = (0, tool_utils_1.ownerKeyOf)(lineage);
         const qualifiedName = (0, tool_utils_1.qualifiedNameOf)(lineage, row.baseName);
-        const qualifiedId = `${ownerKey}:${(0, token_utils_1.tokenName)(row.token)}`;
+        const qualifiedId = `${ownerKey}:${(0, utils_1.tokenName)(row.token)}`;
         return {
             token: row.token,
             instance: row.instance, // REFERENCE the same instance
@@ -305,7 +307,7 @@ class ToolRegistry extends regsitry_1.RegistryAbstract {
                 return maybe;
             const cls = meta && meta.cls ? meta.cls : undefined;
             if (cls) {
-                const id = (0, metadata_utils_1.getMetadata)('id', cls);
+                const id = (0, utils_1.getMetadata)('id', cls);
                 if (typeof id === 'string' && id.length)
                     return id;
                 if (cls.name)
@@ -321,6 +323,20 @@ class ToolRegistry extends regsitry_1.RegistryAbstract {
     hasAny() {
         return this.listAllIndexed().length > 0 || this.tokens.size > 0;
     }
+    /**
+     * Get the MCP capabilities for tools.
+     * These are reported to clients during initialization.
+     */
+    getCapabilities() {
+        return this.hasAny()
+            ? {
+                tools: {
+                    // List change notifications are supported if we have any tools registered
+                    listChanged: true,
+                },
+            }
+            : {};
+    }
 }
 exports.default = ToolRegistry;
 /* -------------------- lineage utility -------------------- */

package/src/tool/tool.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.registry.js","sourceRoot":"","sources":["../../../src/tool/tool.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  EntryLineage,\n  EntryOwnerRef,\n  Token,\n  ToolEntry,\n  ToolRecord,\n  ToolRegistryInterface,\n  ToolType\n} from '../common';\nimport {getMetadata} from '../utils/metadata.utils';\nimport {ToolChangeEvent, ToolEmitter} from './tool.events';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {\n  ensureMaxLen,\n  normalizeOwnerPath,\n  normalizeProviderId,\n  normalizeSegment,\n  normalizeTool, ownerKeyOf, qualifiedNameOf, sepFor,\n  toolDiscoveryDeps\n} from './tool.utils';\nimport {tokenName} from '../utils/token.utils';\nimport {RegistryAbstract, RegistryBuildMapResult} from '../regsitry';\nimport {ToolInstance} from './tool.instance';\nimport {DEFAULT_EXPORT_OPTS, ExportNameOptions, IndexedTool} from \"./tool.types\";\nimport ToolsListFlow from \"./flows/tools-list.flow\";\nimport CallToolFlow from \"./flows/call-tool.flow\";\n\n\nexport default class ToolRegistry\n  extends RegistryAbstract<\n    ToolInstance, // IMPORTANT: instances map holds ToolInstance (not the interface)\n    ToolRecord,\n    ToolType[]\n  >\n  implements ToolRegistryInterface\n{\n  /** Who owns this registry (used for provenance). Optional. */\n  owner: EntryOwnerRef;\n\n  /** Tools truly owned/constructed by THIS registry (with lineage applied) */\n  private localRows: IndexedTool[] = [];\n\n  /** Adopted tool rows from each child registry (references to the same instances) */\n  private adopted = new Map<ToolRegistry, IndexedTool[]>();\n\n  /** Children registries that we track */\n  private children = new Set<ToolRegistry>();\n\n  // ---- O(1) indexes over EFFECTIVE set (local + adopted) ----\n  private byQualifiedId = new Map<string, IndexedTool>(); // qualifiedId -> row\n  private byName = new Map<string, IndexedTool[]>(); // baseName -> rows\n  private byOwnerAndName = new Map<string, IndexedTool>(); // \"ownerKey:name\" -> row\n  private byProviderAndName = new Map<string, IndexedTool>(); // \"providerId:name\" -> row (best-effort)\n  private byOwner = new Map<string, IndexedTool[]>(); // ownerKey -> rows\n\n  // version + emitter\n  private version = 0;\n  private emitter = new ToolEmitter();\n\n  constructor(providers: ProviderRegistry, list: ToolType[], owner: EntryOwnerRef) {\n    // disable auto so subclass fields initialize first\n    super('ToolRegistry', providers, list, false);\n    this.owner = owner;\n\n    // now it’s safe to run the lifecycle\n    this.buildGraph();\n    this.ready = this.initialize();\n  }\n\n  /* -------------------- Build-time: defs + dep checks -------------------- */\n\n  protected override buildMap(list: ToolType[]): RegistryBuildMapResult<ToolRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, ToolRecord>();\n    const graph = new Map<Token, Set<Token>>();\n    for (const raw of list) {\n      const rec = normalizeTool(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = toolDiscoveryDeps(rec);\n\n      for (const d of deps) {\n        // Validate against hierarchical providers; throws early if missing\n        this.providers.get(d);\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  /* -------------------- Initialize: create ONE FrontMcpToolInstance per local tool -------------------- */\n\n  protected override async initialize(): Promise<void> {\n    // Instantiate each local tool once and store in this.instances (from RegistryAbstract)\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n\n      // Single, authoritative instance per local tool\n      const ti = new ToolInstance(rec, this.providers, this.owner);\n      this.instances.set(token as Token<ToolInstance>, ti);\n\n      const lineage: EntryLineage = this.owner ? [this.owner] : [];\n      const row = this.makeRow(token, ti, lineage, this);\n      this.localRows.push(row);\n    }\n\n    const childAppRegistries = this.providers.getRegistries('AppRegistry');\n    childAppRegistries.forEach((appRegistry) => {\n      const apps = appRegistry.getApps();\n      for (const app of apps) {\n        const appToolsRegistries = app.providers.getRegistries('ToolRegistry');\n        appToolsRegistries\n          .filter((t) => t.owner.kind === 'app')\n          .forEach((appToolRegistry) => {\n            this.adoptFromChild(appToolRegistry as ToolRegistry, appToolRegistry.owner);\n          });\n      }\n    });\n\n    const childToolRegistries = this.providers.getRegistries('ToolRegistry');\n    childToolRegistries\n      .filter((t) => t != this)\n      .forEach((toolRegistry) => {\n        this.adoptFromChild(toolRegistry as ToolRegistry, toolRegistry.owner);\n      });\n\n    // Build effective indexes from (locals + already adopted children)\n    this.reindex();\n    this.bump('reset');\n\n    const scope = this.providers.getActiveScope();\n    await scope.registryFlows(ToolsListFlow, CallToolFlow);\n  }\n\n  /* -------------------- Adoption: reference child instances (no cloning) -------------------- */\n\n  /**\n   * Adopt tools from a child registry. Parent runs after children are ready.\n   * We *reference* the child's tool instances; no duplicates are created.\n   *\n   * IMPORTANT:\n   * - Child rows already include the child's own lineage (e.g., adapter:openapi).\n   * - Here we only prepend the **parent's** owner, to avoid double-prefixing the child.\n   */\n  adoptFromChild(child: ToolRegistry, _childOwner: EntryOwnerRef): void {\n    if (this.children.has(child)) return;\n\n    const childRows = child.listAllIndexed(); // includes child's lineage\n    const prepend: EntryLineage = this.owner ? [this.owner] : [];\n\n    const adoptedRows = childRows.map((r) => this.relineage(r, prepend));\n\n    this.adopted.set(child, adoptedRows);\n    this.children.add(child);\n\n    // keep live if child changes\n    child.subscribe({ immediate: false }, () => {\n      const latest = child.listAllIndexed().map((r) => this.relineage(r, prepend));\n      this.adopted.set(child, latest);\n      this.reindex();\n      this.bump('reset');\n    });\n\n    this.reindex();\n    this.bump('reset');\n  }\n\n  getTools(includeHidden = false): ToolEntry<any, any>[] {\n    const local = [...this.localRows].flat().map(t => t.instance);\n    const adopted = [...this.adopted.values()].flat().map(t => t.instance);\n    return [...local, ...adopted].filter(t => t.metadata.hideFromDiscovery !== true || includeHidden);\n  }\n\n  getInlineTools(): ToolEntry<any, any>[] {\n    return [...this.instances.values()];\n  }\n\n  /** Internal snapshot of effective indexed rows (locals + adopted). */\n  private listAllIndexed(): IndexedTool[] {\n    return [...this.localRows, ...[...this.adopted.values()].flat()];\n  }\n\n  /* -------------------- Indexing & lookups -------------------- */\n\n  private reindex() {\n    const effective = this.listAllIndexed();\n\n    this.byQualifiedId.clear();\n    this.byName.clear();\n    this.byOwnerAndName.clear();\n    this.byProviderAndName.clear();\n    this.byOwner.clear();\n\n    for (const r of effective) {\n      this.byQualifiedId.set(r.qualifiedId, r);\n\n      const listByName = this.byName.get(r.baseName) ?? [];\n      listByName.push(r);\n      this.byName.set(r.baseName, listByName);\n\n      const byOwnerKey = this.byOwner.get(r.ownerKey) ?? [];\n      byOwnerKey.push(r);\n      this.byOwner.set(r.ownerKey, byOwnerKey);\n\n      const on = `${r.ownerKey}:${r.baseName}`;\n      if (!this.byOwnerAndName.has(on)) this.byOwnerAndName.set(on, r);\n\n      const provId = this.providerIdOf(r.instance);\n      if (provId) {\n        const pn = `${provId}:${r.baseName}`;\n        if (!this.byProviderAndName.has(pn)) this.byProviderAndName.set(pn, r);\n      }\n    }\n  }\n\n  /** List all instances (locals + adopted). */\n  listAllInstances(): readonly ToolInstance[] {\n    return this.listAllIndexed().map((r) => r.instance);\n  }\n\n  /** List instances by owner path (e.g. \"app:Portal/plugin:Okta\") */\n  listByOwner(ownerPath: string): readonly ToolInstance[] {\n    return (this.byOwner.get(ownerPath) ?? []).map((r) => r.instance);\n  }\n\n  /* -------------------- Conflict-aware exported names -------------------- */\n\n  /**\n   * Produce unique, MCP-valid exported names.\n   * - Base (standardized) = metadata.name cased (snake/camel/kebab/dot)\n   * - If conflicting:\n   *    - Locals keep bare base (unless >1 locals conflict → they get owner prefixes)\n   *    - Children with same base get prefixed by providerId (or owner path)\n   */\n  exportResolvedNames(opts?: ExportNameOptions): Array<{ name: string; instance: ToolInstance }> {\n    const cfg = { ...DEFAULT_EXPORT_OPTS, ...(opts ?? {}) };\n\n    const rows = this.listAllIndexed().map((r) => {\n      const base = normalizeSegment(r.baseName, cfg.case);\n      const isLocal = r.source === this;\n      const provider = normalizeProviderId(this.providerIdOf(r.instance), cfg.case);\n      const ownerPath = normalizeOwnerPath(r.ownerKey, cfg.case);\n      return { base, row: r, isLocal, provider, ownerPath };\n    });\n\n    // group by standardized base\n    const byBase = new Map<string, typeof rows>();\n    for (const r of rows) {\n      const list = byBase.get(r.base) ?? [];\n      list.push(r);\n      byBase.set(r.base, list);\n    }\n\n    const out = new Map<string, ToolInstance>();\n\n    for (const [base, group] of byBase.entries()) {\n      if (group.length === 1) {\n        const g = group[0];\n        out.set(ensureMaxLen(base, cfg.maxLen), g.row.instance);\n        continue;\n      }\n\n      const locals = group.filter((g) => g.isLocal);\n      const children = group.filter((g) => !g.isLocal);\n\n      if (cfg.prefixChildrenOnConflict && locals.length > 0) {\n        // Locals\n        if (locals.length === 1) {\n          const localName = ensureMaxLen(base, cfg.maxLen);\n          out.set(disambiguate(localName, out, cfg), locals[0].row.instance);\n        } else {\n          for (const l of locals) {\n            const pref = normalizeOwnerPath(l.ownerPath, cfg.case);\n            const name = ensureMaxLen(`${pref}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n            out.set(disambiguate(name, out, cfg), l.row.instance);\n          }\n        }\n\n        // Children\n        for (const c of children) {\n          const pre = cfg.prefixSource === 'provider' ? c.provider ?? c.ownerPath : c.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), c.row.instance);\n        }\n      } else {\n        // Prefix everyone by source\n        for (const r of group) {\n          const pre = cfg.prefixSource === 'provider' ? r.provider ?? r.ownerPath : r.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), r.row.instance);\n        }\n      }\n    }\n\n    return [...out.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([name, instance]) => ({ name, instance }));\n\n    function disambiguate(candidate: string, pool: Map<string, any>, cfg: Required<ExportNameOptions>): string {\n      if (!pool.has(candidate)) return candidate;\n      let n = 2;\n      while (true) {\n        const withN = ensureMaxLen(`${candidate}${sepFor(cfg.case)}${n}`, cfg.maxLen);\n        if (!pool.has(withN)) return withN;\n        n++;\n      }\n    }\n  }\n\n  /** Lookup by the exported (resolved) name. */\n  getExported(name: string, opts?: ExportNameOptions): ToolInstance | undefined {\n    const pairs = this.exportResolvedNames(opts);\n    return pairs.find((p) => p.name === name)?.instance;\n  }\n\n  /* -------------------- Subscriptions -------------------- */\n\n  subscribe(\n    opts: { immediate?: boolean; filter?: (i: ToolInstance) => boolean },\n    cb: (evt: ToolChangeEvent) => void,\n  ): () => void {\n    const filter = opts.filter ?? (() => true);\n    if (opts.immediate) {\n      cb({\n        kind: 'reset',\n        scope: 'global',\n        version: this.version,\n        snapshot: this.listAllInstances().filter(filter),\n      });\n    }\n    return this.emitter.on((e) => cb({ ...e, snapshot: this.listAllInstances().filter(filter) }));\n  }\n\n  private bump(kind: ToolChangeEvent['kind']) {\n    const version = ++this.version;\n    this.emitter.emit({ kind, scope: 'global', version, snapshot: this.listAllInstances() });\n  }\n\n  /* -------------------- Helpers -------------------- */\n\n  /** Build an IndexedTool row */\n  private makeRow(token: Token, instance: ToolInstance, lineage: EntryLineage, source: ToolRegistry): IndexedTool {\n    const ownerKey = ownerKeyOf(lineage);\n    const baseName = instance.name;\n    const qualifiedName = qualifiedNameOf(lineage, baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(token)}`;\n    return { token, instance, baseName, lineage, ownerKey, qualifiedName, qualifiedId, source };\n  }\n\n  /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */\n  private relineage(row: IndexedTool, prepend: EntryLineage): IndexedTool {\n    const merged = [...prepend, ...row.lineage];\n    const lineage = dedupLineage(merged);\n\n    const ownerKey = ownerKeyOf(lineage);\n    const qualifiedName = qualifiedNameOf(lineage, row.baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(row.token)}`;\n    return {\n      token: row.token,\n      instance: row.instance, // REFERENCE the same instance\n      baseName: row.baseName,\n      lineage,\n      ownerKey,\n      qualifiedName,\n      qualifiedId,\n      source: row.source, // keep original source (who constructed instance)\n    };\n  }\n\n  /** Best-effort provider id used for prefixing (inspects class metadata if present). */\n  private providerIdOf(inst: ToolInstance): string | undefined {\n    // Try reading provider id from the tool class metadata (if your decorators set one)\n    try {\n      const meta: any = inst.getMetadata?.();\n      const maybe = meta?.providerId ?? meta?.provider ?? meta?.ownerId ?? undefined;\n      if (typeof maybe === 'string' && maybe.length) return maybe;\n\n      const cls: any = meta && meta.cls ? meta.cls : undefined;\n      if (cls) {\n        const id = getMetadata('id', cls);\n        if (typeof id === 'string' && id.length) return id;\n        if (cls.name) return cls.name;\n      }\n    } catch {\n      /* ignore */\n    }\n    return undefined;\n  }\n\n  /** True if this registry (or adopted children) has any tools. */\n  hasAny(): boolean {\n    return this.listAllIndexed().length > 0 || this.tokens.size > 0;\n  }\n}\n\n/* -------------------- lineage utility -------------------- */\n\n/** Remove only adjacent duplicates like [adapter:x, adapter:x] → [adapter:x] */\nfunction dedupLineage(l: EntryLineage): EntryLineage {\n  const out: EntryLineage = [];\n  for (const o of l) {\n    const last = out[out.length - 1];\n    if (!last || last.kind !== o.kind || last.id !== o.id) out.push(o);\n  }\n  return out;\n}\n"]}
+{"version":3,"file":"tool.registry.js","sourceRoot":"","sources":["../../../src/tool/tool.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntryLineage, EntryOwnerRef, Token, ToolEntry, ToolRecord, ToolRegistryInterface, ToolType } from '../common';\nimport { getMetadata, tokenName } from '../utils';\nimport { ToolChangeEvent, ToolEmitter } from './tool.events';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {\n  ensureMaxLen,\n  normalizeOwnerPath,\n  normalizeProviderId,\n  normalizeSegment,\n  normalizeTool,\n  ownerKeyOf,\n  qualifiedNameOf,\n  sepFor,\n  toolDiscoveryDeps,\n} from './tool.utils';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { ToolInstance } from './tool.instance';\nimport { DEFAULT_EXPORT_OPTS, ExportNameOptions, IndexedTool } from './tool.types';\nimport ToolsListFlow from './flows/tools-list.flow';\nimport CallToolFlow from './flows/call-tool.flow';\nimport { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';\n\nexport default class ToolRegistry\n  extends RegistryAbstract<\n    ToolInstance, // IMPORTANT: instances map holds ToolInstance (not the interface)\n    ToolRecord,\n    ToolType[]\n  >\n  implements ToolRegistryInterface\n{\n  /** Who owns this registry (used for provenance). Optional. */\n  owner: EntryOwnerRef;\n\n  /** Tools truly owned/constructed by THIS registry (with lineage applied) */\n  private localRows: IndexedTool[] = [];\n\n  /** Adopted tool rows from each child registry (references to the same instances) */\n  private adopted = new Map<ToolRegistry, IndexedTool[]>();\n\n  /** Children registries that we track */\n  private children = new Set<ToolRegistry>();\n\n  // ---- O(1) indexes over EFFECTIVE set (local + adopted) ----\n  private byQualifiedId = new Map<string, IndexedTool>(); // qualifiedId -> row\n  private byName = new Map<string, IndexedTool[]>(); // baseName -> rows\n  private byOwnerAndName = new Map<string, IndexedTool>(); // \"ownerKey:name\" -> row\n  private byProviderAndName = new Map<string, IndexedTool>(); // \"providerId:name\" -> row (best-effort)\n  private byOwner = new Map<string, IndexedTool[]>(); // ownerKey -> rows\n\n  // version + emitter\n  private version = 0;\n  private emitter = new ToolEmitter();\n\n  constructor(providers: ProviderRegistry, list: ToolType[], owner: EntryOwnerRef) {\n    // disable auto so subclass fields initialize first\n    super('ToolRegistry', providers, list, false);\n    this.owner = owner;\n\n    // now it’s safe to run the lifecycle\n    this.buildGraph();\n    this.ready = this.initialize();\n  }\n\n  /* -------------------- Build-time: defs + dep checks -------------------- */\n\n  protected override buildMap(list: ToolType[]): RegistryBuildMapResult<ToolRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, ToolRecord>();\n    const graph = new Map<Token, Set<Token>>();\n    for (const raw of list) {\n      const rec = normalizeTool(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = toolDiscoveryDeps(rec);\n\n      for (const d of deps) {\n        // Validate against hierarchical providers; throws early if missing\n        this.providers.get(d);\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  /* -------------------- Initialize: create ONE FrontMcpToolInstance per local tool -------------------- */\n\n  protected override async initialize(): Promise<void> {\n    // Instantiate each local tool once and store in this.instances (from RegistryAbstract)\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n\n      // Single, authoritative instance per local tool\n      const ti = new ToolInstance(rec, this.providers, this.owner);\n      this.instances.set(token as Token<ToolInstance>, ti);\n\n      const lineage: EntryLineage = this.owner ? [this.owner] : [];\n      const row = this.makeRow(token, ti, lineage, this);\n      this.localRows.push(row);\n    }\n\n    const childAppRegistries = this.providers.getRegistries('AppRegistry');\n    childAppRegistries.forEach((appRegistry) => {\n      const apps = appRegistry.getApps();\n      for (const app of apps) {\n        const appToolsRegistries = app.providers.getRegistries('ToolRegistry');\n        appToolsRegistries\n          .filter((t) => t.owner.kind === 'app')\n          .forEach((appToolRegistry) => {\n            this.adoptFromChild(appToolRegistry as ToolRegistry, appToolRegistry.owner);\n          });\n      }\n    });\n\n    const childToolRegistries = this.providers.getRegistries('ToolRegistry');\n    childToolRegistries\n      .filter((t) => t != this)\n      .forEach((toolRegistry) => {\n        this.adoptFromChild(toolRegistry as ToolRegistry, toolRegistry.owner);\n      });\n\n    // Build effective indexes from (locals + already adopted children)\n    this.reindex();\n    this.bump('reset');\n\n    const scope = this.providers.getActiveScope();\n    await scope.registryFlows(ToolsListFlow, CallToolFlow);\n  }\n\n  /* -------------------- Adoption: reference child instances (no cloning) -------------------- */\n\n  /**\n   * Adopt tools from a child registry. Parent runs after children are ready.\n   * We *reference* the child's tool instances; no duplicates are created.\n   *\n   * IMPORTANT:\n   * - Child rows already include the child's own lineage (e.g., adapter:openapi).\n   * - Here we only prepend the **parent's** owner, to avoid double-prefixing the child.\n   */\n  adoptFromChild(child: ToolRegistry, _childOwner: EntryOwnerRef): void {\n    if (this.children.has(child)) return;\n\n    const childRows = child.listAllIndexed(); // includes child's lineage\n    const prepend: EntryLineage = this.owner ? [this.owner] : [];\n\n    const adoptedRows = childRows.map((r) => this.relineage(r, prepend));\n\n    this.adopted.set(child, adoptedRows);\n    this.children.add(child);\n\n    // keep live if child changes\n    child.subscribe({ immediate: false }, () => {\n      const latest = child.listAllIndexed().map((r) => this.relineage(r, prepend));\n      this.adopted.set(child, latest);\n      this.reindex();\n      this.bump('reset');\n    });\n\n    this.reindex();\n    this.bump('reset');\n  }\n\n  // NOTE: `any` is intentional here - heterogeneous tool collections can't use `unknown`\n  // because ToolEntry has constrained generics (InSchema extends ToolInputType, etc.)\n  getTools(includeHidden = false): ToolEntry<any, any>[] {\n    const local = [...this.localRows].flat().map((t) => t.instance);\n    const adopted = [...this.adopted.values()].flat().map((t) => t.instance);\n    return [...local, ...adopted].filter((t) => t.metadata.hideFromDiscovery !== true || includeHidden);\n  }\n\n  // NOTE: `any` is intentional - see getTools comment above\n  getInlineTools(): ToolEntry<any, any>[] {\n    return [...this.instances.values()];\n  }\n\n  /** Internal snapshot of effective indexed rows (locals + adopted). */\n  private listAllIndexed(): IndexedTool[] {\n    return [...this.localRows, ...[...this.adopted.values()].flat()];\n  }\n\n  /* -------------------- Indexing & lookups -------------------- */\n\n  private reindex() {\n    const effective = this.listAllIndexed();\n\n    this.byQualifiedId.clear();\n    this.byName.clear();\n    this.byOwnerAndName.clear();\n    this.byProviderAndName.clear();\n    this.byOwner.clear();\n\n    for (const r of effective) {\n      this.byQualifiedId.set(r.qualifiedId, r);\n\n      const listByName = this.byName.get(r.baseName) ?? [];\n      listByName.push(r);\n      this.byName.set(r.baseName, listByName);\n\n      const byOwnerKey = this.byOwner.get(r.ownerKey) ?? [];\n      byOwnerKey.push(r);\n      this.byOwner.set(r.ownerKey, byOwnerKey);\n\n      const on = `${r.ownerKey}:${r.baseName}`;\n      if (!this.byOwnerAndName.has(on)) this.byOwnerAndName.set(on, r);\n\n      const provId = this.providerIdOf(r.instance);\n      if (provId) {\n        const pn = `${provId}:${r.baseName}`;\n        if (!this.byProviderAndName.has(pn)) this.byProviderAndName.set(pn, r);\n      }\n    }\n  }\n\n  /** List all instances (locals + adopted). */\n  listAllInstances(): readonly ToolInstance[] {\n    return this.listAllIndexed().map((r) => r.instance);\n  }\n\n  /** List instances by owner path (e.g. \"app:Portal/plugin:Okta\") */\n  listByOwner(ownerPath: string): readonly ToolInstance[] {\n    return (this.byOwner.get(ownerPath) ?? []).map((r) => r.instance);\n  }\n\n  /* -------------------- Conflict-aware exported names -------------------- */\n\n  /**\n   * Produce unique, MCP-valid exported names.\n   * - Base (standardized) = metadata.name cased (snake/camel/kebab/dot)\n   * - If conflicting:\n   *    - Locals keep bare base (unless >1 locals conflict → they get owner prefixes)\n   *    - Children with same base get prefixed by providerId (or owner path)\n   */\n  exportResolvedNames(opts?: ExportNameOptions): Array<{ name: string; instance: ToolInstance }> {\n    const cfg = { ...DEFAULT_EXPORT_OPTS, ...(opts ?? {}) };\n\n    const rows = this.listAllIndexed().map((r) => {\n      const base = normalizeSegment(r.baseName, cfg.case);\n      const isLocal = r.source === this;\n      const provider = normalizeProviderId(this.providerIdOf(r.instance), cfg.case);\n      const ownerPath = normalizeOwnerPath(r.ownerKey, cfg.case);\n      return { base, row: r, isLocal, provider, ownerPath };\n    });\n\n    // group by standardized base\n    const byBase = new Map<string, typeof rows>();\n    for (const r of rows) {\n      const list = byBase.get(r.base) ?? [];\n      list.push(r);\n      byBase.set(r.base, list);\n    }\n\n    const out = new Map<string, ToolInstance>();\n\n    for (const [base, group] of byBase.entries()) {\n      if (group.length === 1) {\n        const g = group[0];\n        out.set(ensureMaxLen(base, cfg.maxLen), g.row.instance);\n        continue;\n      }\n\n      const locals = group.filter((g) => g.isLocal);\n      const children = group.filter((g) => !g.isLocal);\n\n      if (cfg.prefixChildrenOnConflict && locals.length > 0) {\n        // Locals\n        if (locals.length === 1) {\n          const localName = ensureMaxLen(base, cfg.maxLen);\n          out.set(disambiguate(localName, out, cfg), locals[0].row.instance);\n        } else {\n          for (const l of locals) {\n            const pref = normalizeOwnerPath(l.ownerPath, cfg.case);\n            const name = ensureMaxLen(`${pref}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n            out.set(disambiguate(name, out, cfg), l.row.instance);\n          }\n        }\n\n        // Children\n        for (const c of children) {\n          const pre = cfg.prefixSource === 'provider' ? c.provider ?? c.ownerPath : c.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), c.row.instance);\n        }\n      } else {\n        // Prefix everyone by source\n        for (const r of group) {\n          const pre = cfg.prefixSource === 'provider' ? r.provider ?? r.ownerPath : r.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), r.row.instance);\n        }\n      }\n    }\n\n    return [...out.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([name, instance]) => ({ name, instance }));\n\n    function disambiguate(candidate: string, pool: Map<string, any>, cfg: Required<ExportNameOptions>): string {\n      if (!pool.has(candidate)) return candidate;\n      let n = 2;\n      while (true) {\n        const withN = ensureMaxLen(`${candidate}${sepFor(cfg.case)}${n}`, cfg.maxLen);\n        if (!pool.has(withN)) return withN;\n        n++;\n      }\n    }\n  }\n\n  /** Lookup by the exported (resolved) name. */\n  getExported(name: string, opts?: ExportNameOptions): ToolInstance | undefined {\n    const pairs = this.exportResolvedNames(opts);\n    return pairs.find((p) => p.name === name)?.instance;\n  }\n\n  /* -------------------- Subscriptions -------------------- */\n\n  subscribe(\n    opts: { immediate?: boolean; filter?: (i: ToolInstance) => boolean },\n    cb: (evt: ToolChangeEvent) => void,\n  ): () => void {\n    const filter = opts.filter ?? (() => true);\n    if (opts.immediate) {\n      cb({\n        kind: 'reset',\n        changeScope: 'global',\n        version: this.version,\n        snapshot: this.listAllInstances().filter(filter),\n      });\n    }\n    return this.emitter.on((e) => cb({ ...e, snapshot: this.listAllInstances().filter(filter) }));\n  }\n\n  private bump(kind: ToolChangeEvent['kind']) {\n    const version = ++this.version;\n    this.emitter.emit({ kind, changeScope: 'global', version, snapshot: this.listAllInstances() });\n  }\n\n  /* -------------------- Helpers -------------------- */\n\n  /** Build an IndexedTool row */\n  private makeRow(token: Token, instance: ToolInstance, lineage: EntryLineage, source: ToolRegistry): IndexedTool {\n    const ownerKey = ownerKeyOf(lineage);\n    const baseName = instance.name;\n    const qualifiedName = qualifiedNameOf(lineage, baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(token)}`;\n    return { token, instance, baseName, lineage, ownerKey, qualifiedName, qualifiedId, source };\n  }\n\n  /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */\n  private relineage(row: IndexedTool, prepend: EntryLineage): IndexedTool {\n    const merged = [...prepend, ...row.lineage];\n    const lineage = dedupLineage(merged);\n\n    const ownerKey = ownerKeyOf(lineage);\n    const qualifiedName = qualifiedNameOf(lineage, row.baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(row.token)}`;\n    return {\n      token: row.token,\n      instance: row.instance, // REFERENCE the same instance\n      baseName: row.baseName,\n      lineage,\n      ownerKey,\n      qualifiedName,\n      qualifiedId,\n      source: row.source, // keep original source (who constructed instance)\n    };\n  }\n\n  /** Best-effort provider id used for prefixing (inspects class metadata if present). */\n  private providerIdOf(inst: ToolInstance): string | undefined {\n    // Try reading provider id from the tool class metadata (if your decorators set one)\n    try {\n      const meta: any = inst.getMetadata?.();\n      const maybe = meta?.providerId ?? meta?.provider ?? meta?.ownerId ?? undefined;\n      if (typeof maybe === 'string' && maybe.length) return maybe;\n\n      const cls: any = meta && meta.cls ? meta.cls : undefined;\n      if (cls) {\n        const id = getMetadata('id', cls);\n        if (typeof id === 'string' && id.length) return id;\n        if (cls.name) return cls.name;\n      }\n    } catch {\n      /* ignore */\n    }\n    return undefined;\n  }\n\n  /** True if this registry (or adopted children) has any tools. */\n  hasAny(): boolean {\n    return this.listAllIndexed().length > 0 || this.tokens.size > 0;\n  }\n\n  /**\n   * Get the MCP capabilities for tools.\n   * These are reported to clients during initialization.\n   */\n  getCapabilities(): Partial<ServerCapabilities> {\n    return this.hasAny()\n      ? {\n          tools: {\n            // List change notifications are supported if we have any tools registered\n            listChanged: true,\n          },\n        }\n      : {};\n  }\n}\n\n/* -------------------- lineage utility -------------------- */\n\n/** Remove only adjacent duplicates like [adapter:x, adapter:x] → [adapter:x] */\nfunction dedupLineage(l: EntryLineage): EntryLineage {\n  const out: EntryLineage = [];\n  for (const o of l) {\n    const last = out[out.length - 1];\n    if (!last || last.kind !== o.kind || last.id !== o.id) out.push(o);\n  }\n  return out;\n}\n"]}