@frontmcp/sdk 0.4.1 → 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}"`);
@@ -117,46 +120,124 @@ let ToolsListFlow = class ToolsListFlow extends common_1.FlowBase {
     }
     async parseTools() {
         this.logger.verbose('parseTools:start');
-        const resolved = this.state.required.resolvedTools;
-        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.
-                    // eslint-disable-next-line
-                    inputSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(zod_1.z.object(tool.inputSchema));
+        try {
+            const resolved = this.state.required.resolvedTools;
+            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: {} };
+                    }
                 }
-                catch (e) {
-                    this.logger.warn(`Failed to convert inputSchema for tool ${finalName}:`, e);
+                else {
+                    // No schema defined - use empty object schema
                     inputSchema = { type: 'object', properties: {} };
                 }
-            }
-            else {
-                // No schema defined - use empty object schema
-                inputSchema = { type: 'object', properties: {} };
-            }
-            return {
-                name: finalName,
-                title: tool.metadata.name,
-                description: tool.metadata.description,
-                annotations: tool.metadata.annotations,
-                inputSchema,
-            };
-        });
-        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}`);
-        this.respond({ tools });
-        this.logger.info('parseTools: response sent');
-        this.logger.verbose('parseTools:done');
+                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}`);
+            this.respond({ tools });
+            this.logger.info('parseTools: response sent');
+            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;
+        }
     }
 };
 tslib_1.__decorate([

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    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          // eslint-disable-next-line\n          inputSchema = zodToJsonSchema(z.object(tool.inputSchema) as any) as any;\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      return {\n        name: finalName,\n        title: tool.metadata.name,\n        description: tool.metadata.description,\n        annotations: tool.metadata.annotations,\n        inputSchema,\n      };\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  }\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":"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","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 -------------------- */