@strapi/core 5.48.1 → 5.50.0

package/dist/services/mcp/prompt-registry.mjs

@@ -13,6 +13,36 @@ var id = 0;
 function _class_private_field_loose_key(name) {
     return "__private_" + id++ + "_" + name;
 }
+/**
+ * Defines a Strapi MCP prompt with full type inference, ready to pass to
+ * `strapi.ai.mcp.registerPrompt()`. Exposed publicly as `ai.mcp.definePrompt`.
+ *
+ * The returned value is the definition unchanged — this builder only exists to
+ * infer the `name`/`argsSchema` and narrow the access variant (`devModeOnly` vs
+ * `auth`) so the result is directly assignable to `registerPrompt`.
+ *
+ * @param prompt - The prompt definition. Provide either `devModeOnly: true`
+ * (dev-only, no auth) or an `auth` policy set — never both.
+ * @returns The same definition, with its access variant narrowed.
+ *
+ * @example
+ * ```ts
+ * import { ai } from '@strapi/strapi';
+ *
+ * const context = ai.mcp.definePrompt({
+ *   name: 'app-context',
+ *   title: 'App Context',
+ *   description: 'Provides context about the app',
+ *   devModeOnly: true,
+ *   createHandler: (strapi) => async () => ({
+ *     messages: [{ role: 'user', content: { type: 'text', text: 'You are connected to Strapi.' } }],
+ *   }),
+ * });
+ *
+ * // later, in register() or bootstrap():
+ * strapi.ai.mcp.registerPrompt(context);
+ * ```
+ */ const makeMcpPromptDefinition = (definition)=>definition;
 var _strapi = /*#__PURE__*/ _class_private_field_loose_key("_strapi");
 class McpPromptRegistry extends McpCapabilityRegistryBase {
     bind(mcpServer) {
@@ -71,5 +101,5 @@ class McpPromptRegistry extends McpCapabilityRegistryBase {
     }
 }
 
-export { McpPromptRegistry };
+export { McpPromptRegistry, makeMcpPromptDefinition };
 //# sourceMappingURL=prompt-registry.mjs.map

package/dist/services/mcp/prompt-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-registry.mjs","sources":["../../../src/services/mcp/prompt-registry.ts"],"sourcesContent":["// eslint-disable-next-line import/extensions\nimport type { McpServer, RegisteredPrompt } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\n\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\n\nexport const makeMcpPromptDefinition = <Definition extends Modules.MCP.McpPromptDefinition>(\n  prompt: Definition\n): Definition => prompt;\n\nexport class McpPromptRegistry\n  extends McpCapabilityRegistryBase<'prompt', Modules.MCP.McpPromptDefinition, RegisteredPrompt>\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'prompt', Modules.MCP.McpPromptDefinition>;\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, title, description, argsSchema, createHandler } = definition;\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Prompt',\n        name,\n        createHandler,\n        createFallbackHandler(errorMessage) {\n          return async () => ({\n            messages: [\n              {\n                role: 'user' as const,\n                content: {\n                  type: 'text' as const,\n                  text: `Prompt \"${name}\" failed to initialize: ${errorMessage}`,\n                },\n              },\n            ],\n          });\n        },\n        createErrorResult(error) {\n          return {\n            messages: [\n              {\n                role: 'user' as const,\n                content: {\n                  type: 'text' as const,\n                  text: `Prompt \"${name}\" execution failed: ${error.message}`,\n                },\n              },\n            ],\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'prompt',\n            name,\n            definition.telemetry,\n            safeHandler\n          );\n\n          return mcpServer.registerPrompt(\n            name,\n            {\n              title,\n              description,\n              // @ts-expect-error - Internal handler type mismatch due to optional argsSchema\n              argsSchema,\n            },\n            sdkHandler\n          );\n        },\n      });\n    });\n  }\n}\n"],"names":["McpPromptRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","definition","name","title","description","argsSchema","createHandler","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","messages","role","content","type","text","createErrorResult","error","message","registerWithSdk","safeHandler","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerPrompt","ctx","definitions"],"mappings":";;;;AAAA;;;;;;;;;;;AAoBE,IAAA,OAAA,iBAAA,8BAAA,CAAA,SAAA,CAAA;AAJK,MAAMA,iBAAAA,SACHC,yBAAAA,CAAAA;AAaRC,IAAAA,IAAAA,CAAKC,SAAoB,EAAE;AACzB,QAAA,MAAMC,MAAAA,GAAS,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA;QAEpB,KAAK,CAACC,SAAS,CAACC,UAAAA,GAAAA;YACd,MAAM,EAAEC,IAAI,EAAEC,KAAK,EAAEC,WAAW,EAAEC,UAAU,EAAEC,aAAa,EAAE,GAAGL,UAAAA;AAEhE,YAAA,OAAOM,gCAAAA,CAAiC;AACtCR,gBAAAA,MAAAA;gBACAS,cAAAA,EAAgB,QAAA;AAChBN,gBAAAA,IAAAA;AACAI,gBAAAA,aAAAA;AACAG,gBAAAA,qBAAAA,CAAAA,CAAsBC,YAAY,EAAA;AAChC,oBAAA,OAAO,WAAa;4BAClBC,QAAAA,EAAU;AACR,gCAAA;oCACEC,IAAAA,EAAM,MAAA;oCACNC,OAAAA,EAAS;wCACPC,IAAAA,EAAM,MAAA;AACNC,wCAAAA,IAAAA,EAAM,CAAC,QAAQ,EAAEb,IAAAA,CAAK,wBAAwB,EAAEQ,YAAAA,CAAAA;AAClD;AACF;AACD;yBACH,CAAA;AACF,gBAAA,CAAA;AACAM,gBAAAA,iBAAAA,CAAAA,CAAkBC,KAAK,EAAA;oBACrB,OAAO;wBACLN,QAAAA,EAAU;AACR,4BAAA;gCACEC,IAAAA,EAAM,MAAA;gCACNC,OAAAA,EAAS;oCACPC,IAAAA,EAAM,MAAA;oCACNC,IAAAA,EAAM,CAAC,QAAQ,EAAEb,IAAAA,CAAK,oBAAoB,EAAEe,KAAAA,CAAMC,OAAO,CAAA;AAC3D;AACF;AACD;AACH,qBAAA;AACF,gBAAA,CAAA;AACAC,gBAAAA,eAAAA,CAAAA,CAAgBC,WAAW,EAAA;AACzB,oBAAA,MAAMC,aAAaC,+BAAAA,CACjBvB,MAAAA,EACA,UACAG,IAAAA,EACAD,UAAAA,CAAWsB,SAAS,EACpBH,WAAAA,CAAAA;oBAGF,OAAOtB,SAAAA,CAAU0B,cAAc,CAC7BtB,IAAAA,EACA;AACEC,wBAAAA,KAAAA;AACAC,wBAAAA,WAAAA;;AAEAC,wBAAAA;qBACF,EACAgB,UAAAA,CAAAA;AAEJ,gBAAA;AACF,aAAA,CAAA;AACF,QAAA,CAAA,CAAA;AACF,IAAA;AAnEA,IAAA,WAAA,CAAYI,GAGX,CAAE;AACD,QAAA,KAAK,CAACA,GAAAA,CAAIC,WAAW,CAAA,EANvB,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,OAAA,EAAA;;mBAAA;;AAOE,QAAA,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA,GAAUD,IAAI1B,MAAM;AAC3B,IAAA;AA8DF;;;;"}
+{"version":3,"file":"prompt-registry.mjs","sources":["../../../src/services/mcp/prompt-registry.ts"],"sourcesContent":["// eslint-disable-next-line import/extensions\nimport type { McpServer, RegisteredPrompt } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\n\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\n\n/**\n * Defines a Strapi MCP prompt with full type inference, ready to pass to\n * `strapi.ai.mcp.registerPrompt()`. Exposed publicly as `ai.mcp.definePrompt`.\n *\n * The returned value is the definition unchanged — this builder only exists to\n * infer the `name`/`argsSchema` and narrow the access variant (`devModeOnly` vs\n * `auth`) so the result is directly assignable to `registerPrompt`.\n *\n * @param prompt - The prompt definition. Provide either `devModeOnly: true`\n * (dev-only, no auth) or an `auth` policy set — never both.\n * @returns The same definition, with its access variant narrowed.\n *\n * @example\n * ```ts\n * import { ai } from '@strapi/strapi';\n *\n * const context = ai.mcp.definePrompt({\n *   name: 'app-context',\n *   title: 'App Context',\n *   description: 'Provides context about the app',\n *   devModeOnly: true,\n *   createHandler: (strapi) => async () => ({\n *     messages: [{ role: 'user', content: { type: 'text', text: 'You are connected to Strapi.' } }],\n *   }),\n * });\n *\n * // later, in register() or bootstrap():\n * strapi.ai.mcp.registerPrompt(context);\n * ```\n */\nexport const makeMcpPromptDefinition = ((definition: Modules.MCP.McpPromptDefinition) =>\n  definition) as unknown as Modules.MCP.McpPromptBuilder;\n\nexport class McpPromptRegistry\n  extends McpCapabilityRegistryBase<'prompt', Modules.MCP.McpPromptDefinition, RegisteredPrompt>\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'prompt', Modules.MCP.McpPromptDefinition>;\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, title, description, argsSchema, createHandler } = definition;\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Prompt',\n        name,\n        createHandler,\n        createFallbackHandler(errorMessage) {\n          return async () => ({\n            messages: [\n              {\n                role: 'user' as const,\n                content: {\n                  type: 'text' as const,\n                  text: `Prompt \"${name}\" failed to initialize: ${errorMessage}`,\n                },\n              },\n            ],\n          });\n        },\n        createErrorResult(error) {\n          return {\n            messages: [\n              {\n                role: 'user' as const,\n                content: {\n                  type: 'text' as const,\n                  text: `Prompt \"${name}\" execution failed: ${error.message}`,\n                },\n              },\n            ],\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'prompt',\n            name,\n            definition.telemetry,\n            safeHandler\n          );\n\n          return mcpServer.registerPrompt(\n            name,\n            {\n              title,\n              description,\n              // @ts-expect-error - Internal handler type mismatch due to optional argsSchema\n              argsSchema,\n            },\n            sdkHandler\n          );\n        },\n      });\n    });\n  }\n}\n"],"names":["makeMcpPromptDefinition","definition","McpPromptRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","name","title","description","argsSchema","createHandler","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","messages","role","content","type","text","createErrorResult","error","message","registerWithSdk","safeHandler","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerPrompt","ctx","definitions"],"mappings":";;;;AAAA;;;;;;;;;;;AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BC,IACM,MAAMA,uBAAAA,GAA2B,CAACC,aACvCA;AAMA,IAAA,OAAA,iBAAA,8BAAA,CAAA,SAAA,CAAA;AAJK,MAAMC,iBAAAA,SACHC,yBAAAA,CAAAA;AAaRC,IAAAA,IAAAA,CAAKC,SAAoB,EAAE;AACzB,QAAA,MAAMC,MAAAA,GAAS,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA;QAEpB,KAAK,CAACC,SAAS,CAACN,UAAAA,GAAAA;YACd,MAAM,EAAEO,IAAI,EAAEC,KAAK,EAAEC,WAAW,EAAEC,UAAU,EAAEC,aAAa,EAAE,GAAGX,UAAAA;AAEhE,YAAA,OAAOY,gCAAAA,CAAiC;AACtCP,gBAAAA,MAAAA;gBACAQ,cAAAA,EAAgB,QAAA;AAChBN,gBAAAA,IAAAA;AACAI,gBAAAA,aAAAA;AACAG,gBAAAA,qBAAAA,CAAAA,CAAsBC,YAAY,EAAA;AAChC,oBAAA,OAAO,WAAa;4BAClBC,QAAAA,EAAU;AACR,gCAAA;oCACEC,IAAAA,EAAM,MAAA;oCACNC,OAAAA,EAAS;wCACPC,IAAAA,EAAM,MAAA;AACNC,wCAAAA,IAAAA,EAAM,CAAC,QAAQ,EAAEb,IAAAA,CAAK,wBAAwB,EAAEQ,YAAAA,CAAAA;AAClD;AACF;AACD;yBACH,CAAA;AACF,gBAAA,CAAA;AACAM,gBAAAA,iBAAAA,CAAAA,CAAkBC,KAAK,EAAA;oBACrB,OAAO;wBACLN,QAAAA,EAAU;AACR,4BAAA;gCACEC,IAAAA,EAAM,MAAA;gCACNC,OAAAA,EAAS;oCACPC,IAAAA,EAAM,MAAA;oCACNC,IAAAA,EAAM,CAAC,QAAQ,EAAEb,IAAAA,CAAK,oBAAoB,EAAEe,KAAAA,CAAMC,OAAO,CAAA;AAC3D;AACF;AACD;AACH,qBAAA;AACF,gBAAA,CAAA;AACAC,gBAAAA,eAAAA,CAAAA,CAAgBC,WAAW,EAAA;AACzB,oBAAA,MAAMC,aAAaC,+BAAAA,CACjBtB,MAAAA,EACA,UACAE,IAAAA,EACAP,UAAAA,CAAW4B,SAAS,EACpBH,WAAAA,CAAAA;oBAGF,OAAOrB,SAAAA,CAAUyB,cAAc,CAC7BtB,IAAAA,EACA;AACEC,wBAAAA,KAAAA;AACAC,wBAAAA,WAAAA;;AAEAC,wBAAAA;qBACF,EACAgB,UAAAA,CAAAA;AAEJ,gBAAA;AACF,aAAA,CAAA;AACF,QAAA,CAAA,CAAA;AACF,IAAA;AAnEA,IAAA,WAAA,CAAYI,GAGX,CAAE;AACD,QAAA,KAAK,CAACA,GAAAA,CAAIC,WAAW,CAAA,EANvB,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,OAAA,EAAA;;mBAAA;;AAOE,QAAA,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA,GAAUD,IAAIzB,MAAM;AAC3B,IAAA;AA8DF;;;;"}

package/dist/services/mcp/resource-registry.d.ts

@@ -2,7 +2,37 @@ import type { McpServer, RegisteredResource } from '@modelcontextprotocol/sdk/se
 import type { Core, Modules } from '@strapi/types';
 import { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';
 import { type McpCapabilityRegistry, McpCapabilityRegistryBase } from './internal/McpCapabilityRegistry';
-export declare const makeMcpResourceDefinition: <Definition extends Modules.MCP.McpResourceDefinition<string>>(resource: Definition) => Definition;
+/**
+ * Defines a Strapi MCP resource with full type inference, ready to pass to
+ * `strapi.ai.mcp.registerResource()`. Exposed publicly as `ai.mcp.defineResource`.
+ *
+ * The returned value is the definition unchanged — this builder only exists to
+ * infer the `name` and narrow the access variant (`devModeOnly` vs `auth`) so the
+ * result is directly assignable to `registerResource`.
+ *
+ * @param resource - The resource definition. Provide either `devModeOnly: true`
+ * (dev-only, no auth) or an `auth` policy set — never both.
+ * @returns The same definition, with its access variant narrowed.
+ *
+ * @example
+ * ```ts
+ * import { ai } from '@strapi/strapi';
+ *
+ * const appInfo = ai.mcp.defineResource({
+ *   name: 'app-info',
+ *   uri: 'strapi://app/info',
+ *   metadata: { description: 'Metadata about the app', mimeType: 'application/json' },
+ *   devModeOnly: true,
+ *   createHandler: (strapi) => async (uri) => ({
+ *     contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify({ ok: true }) }],
+ *   }),
+ * });
+ *
+ * // later, in register() or bootstrap():
+ * strapi.ai.mcp.registerResource(appInfo);
+ * ```
+ */
+export declare const makeMcpResourceDefinition: Modules.MCP.McpResourceBuilder;
 export declare class McpResourceRegistry extends McpCapabilityRegistryBase<'resource', Modules.MCP.McpResourceDefinition, RegisteredResource> implements McpCapabilityRegistry {
     #private;
     constructor(ctx: {

package/dist/services/mcp/resource-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/resource-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAEnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EACL,KAAK,qBAAqB,EAC1B,yBAAyB,EAC1B,MAAM,kCAAkC,CAAC;AAI1C,eAAO,MAAM,yBAAyB,2EAC1B,UAAU,KACnB,UAAsB,CAAC;AAE1B,qBAAa,mBACX,SAAQ,yBAAyB,CAC/B,UAAU,EACV,OAAO,CAAC,GAAG,CAAC,qBAAqB,EACjC,kBAAkB,CAEpB,YAAW,qBAAqB;;gBAIpB,GAAG,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,+BAA+B,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;KAC7F;IAKD,IAAI,CAAC,SAAS,EAAE,SAAS;CA+C1B"}
+{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/resource-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,kBAAkB,EAEnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EACL,KAAK,qBAAqB,EAC1B,yBAAyB,EAC1B,MAAM,kCAAkC,CAAC;AAI1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,yBAAyB,EACV,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAE3D,qBAAa,mBACX,SAAQ,yBAAyB,CAC/B,UAAU,EACV,OAAO,CAAC,GAAG,CAAC,qBAAqB,EACjC,kBAAkB,CAEpB,YAAW,qBAAqB;;gBAIpB,GAAG,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,+BAA+B,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;KAC7F;IAKD,IAAI,CAAC,SAAS,EAAE,SAAS;CA+C1B"}

package/dist/services/mcp/resource-registry.js

@@ -14,6 +14,36 @@ var id = 0;
 function _class_private_field_loose_key(name) {
     return "__private_" + id++ + "_" + name;
 }
+/**
+ * Defines a Strapi MCP resource with full type inference, ready to pass to
+ * `strapi.ai.mcp.registerResource()`. Exposed publicly as `ai.mcp.defineResource`.
+ *
+ * The returned value is the definition unchanged — this builder only exists to
+ * infer the `name` and narrow the access variant (`devModeOnly` vs `auth`) so the
+ * result is directly assignable to `registerResource`.
+ *
+ * @param resource - The resource definition. Provide either `devModeOnly: true`
+ * (dev-only, no auth) or an `auth` policy set — never both.
+ * @returns The same definition, with its access variant narrowed.
+ *
+ * @example
+ * ```ts
+ * import { ai } from '@strapi/strapi';
+ *
+ * const appInfo = ai.mcp.defineResource({
+ *   name: 'app-info',
+ *   uri: 'strapi://app/info',
+ *   metadata: { description: 'Metadata about the app', mimeType: 'application/json' },
+ *   devModeOnly: true,
+ *   createHandler: (strapi) => async (uri) => ({
+ *     contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify({ ok: true }) }],
+ *   }),
+ * });
+ *
+ * // later, in register() or bootstrap():
+ * strapi.ai.mcp.registerResource(appInfo);
+ * ```
+ */ const makeMcpResourceDefinition = (definition)=>definition;
 var _strapi = /*#__PURE__*/ _class_private_field_loose_key("_strapi");
 class McpResourceRegistry extends McpCapabilityRegistry.McpCapabilityRegistryBase {
     bind(mcpServer) {
@@ -64,4 +94,5 @@ class McpResourceRegistry extends McpCapabilityRegistry.McpCapabilityRegistryBas
 }
 
 exports.McpResourceRegistry = McpResourceRegistry;
+exports.makeMcpResourceDefinition = makeMcpResourceDefinition;
 //# sourceMappingURL=resource-registry.js.map

package/dist/services/mcp/resource-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-registry.js","sources":["../../../src/services/mcp/resource-registry.ts"],"sourcesContent":["import type {\n  McpServer,\n  RegisteredResource,\n  // eslint-disable-next-line import/extensions\n} from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\n\nexport const makeMcpResourceDefinition = <Definition extends Modules.MCP.McpResourceDefinition>(\n  resource: Definition\n): Definition => resource;\n\nexport class McpResourceRegistry\n  extends McpCapabilityRegistryBase<\n    'resource',\n    Modules.MCP.McpResourceDefinition,\n    RegisteredResource\n  >\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'resource', Modules.MCP.McpResourceDefinition>;\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, uri, metadata, createHandler } = definition;\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Resource',\n        name,\n        createHandler,\n        createFallbackHandler(errorMessage) {\n          return async (resourceUri) => ({\n            contents: [\n              {\n                uri: resourceUri.href,\n                text: `Resource \"${name}\" failed to initialize: ${errorMessage}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          });\n        },\n        createErrorResult(error, args) {\n          return {\n            contents: [\n              {\n                uri: args[0] instanceof URL ? args[0].href : uri,\n                text: `Resource \"${name}\" execution failed: ${error.message}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'resource',\n            name,\n            definition.telemetry,\n            safeHandler\n          );\n\n          return mcpServer.registerResource(name, uri, metadata, sdkHandler);\n        },\n      });\n    });\n  }\n}\n"],"names":["McpResourceRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","definition","name","uri","metadata","createHandler","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","resourceUri","contents","href","text","mimeType","createErrorResult","error","args","URL","message","registerWithSdk","safeHandler","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerResource","ctx","definitions"],"mappings":";;;;;;;;;;;;;;;;AA0BE,IAAA,OAAA,iBAAA,8BAAA,CAAA,SAAA,CAAA;AARK,MAAMA,mBAAAA,SACHC,+CAAAA,CAAAA;AAiBRC,IAAAA,IAAAA,CAAKC,SAAoB,EAAE;AACzB,QAAA,MAAMC,MAAAA,GAAS,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA;QAEpB,KAAK,CAACC,SAAS,CAACC,UAAAA,GAAAA;YACd,MAAM,EAAEC,IAAI,EAAEC,GAAG,EAAEC,QAAQ,EAAEC,aAAa,EAAE,GAAGJ,UAAAA;AAE/C,YAAA,OAAOK,iEAAAA,CAAiC;AACtCP,gBAAAA,MAAAA;gBACAQ,cAAAA,EAAgB,UAAA;AAChBL,gBAAAA,IAAAA;AACAG,gBAAAA,aAAAA;AACAG,gBAAAA,qBAAAA,CAAAA,CAAsBC,YAAY,EAAA;oBAChC,OAAO,OAAOC,eAAiB;4BAC7BC,QAAAA,EAAU;AACR,gCAAA;AACER,oCAAAA,GAAAA,EAAKO,YAAYE,IAAI;AACrBC,oCAAAA,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,wBAAwB,EAAEO,YAAAA,CAAAA,CAAc;oCAChEK,QAAAA,EAAU;AACZ;AACD;yBACH,CAAA;AACF,gBAAA,CAAA;gBACAC,iBAAAA,CAAAA,CAAkBC,KAAK,EAAEC,IAAI,EAAA;oBAC3B,OAAO;wBACLN,QAAAA,EAAU;AACR,4BAAA;gCACER,GAAAA,EAAKc,IAAI,CAAC,CAAA,CAAE,YAAYC,GAAAA,GAAMD,IAAI,CAAC,CAAA,CAAE,CAACL,IAAI,GAAGT,GAAAA;gCAC7CU,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,oBAAoB,EAAEc,KAAAA,CAAMG,OAAO,CAAA,CAAE;gCAC7DL,QAAAA,EAAU;AACZ;AACD;AACH,qBAAA;AACF,gBAAA,CAAA;AACAM,gBAAAA,eAAAA,CAAAA,CAAgBC,WAAW,EAAA;AACzB,oBAAA,MAAMC,aAAaC,+DAAAA,CACjBxB,MAAAA,EACA,YACAG,IAAAA,EACAD,UAAAA,CAAWuB,SAAS,EACpBH,WAAAA,CAAAA;AAGF,oBAAA,OAAOvB,SAAAA,CAAU2B,gBAAgB,CAACvB,IAAAA,EAAMC,KAAKC,QAAAA,EAAUkB,UAAAA,CAAAA;AACzD,gBAAA;AACF,aAAA,CAAA;AACF,QAAA,CAAA,CAAA;AACF,IAAA;AAtDA,IAAA,WAAA,CAAYI,GAGX,CAAE;AACD,QAAA,KAAK,CAACA,GAAAA,CAAIC,WAAW,CAAA,EANvB,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,OAAA,EAAA;;mBAAA;;AAOE,QAAA,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA,GAAUD,IAAI3B,MAAM;AAC3B,IAAA;AAiDF;;;;"}
+{"version":3,"file":"resource-registry.js","sources":["../../../src/services/mcp/resource-registry.ts"],"sourcesContent":["import type {\n  McpServer,\n  RegisteredResource,\n  // eslint-disable-next-line import/extensions\n} from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\n\n/**\n * Defines a Strapi MCP resource with full type inference, ready to pass to\n * `strapi.ai.mcp.registerResource()`. Exposed publicly as `ai.mcp.defineResource`.\n *\n * The returned value is the definition unchanged — this builder only exists to\n * infer the `name` and narrow the access variant (`devModeOnly` vs `auth`) so the\n * result is directly assignable to `registerResource`.\n *\n * @param resource - The resource definition. Provide either `devModeOnly: true`\n * (dev-only, no auth) or an `auth` policy set — never both.\n * @returns The same definition, with its access variant narrowed.\n *\n * @example\n * ```ts\n * import { ai } from '@strapi/strapi';\n *\n * const appInfo = ai.mcp.defineResource({\n *   name: 'app-info',\n *   uri: 'strapi://app/info',\n *   metadata: { description: 'Metadata about the app', mimeType: 'application/json' },\n *   devModeOnly: true,\n *   createHandler: (strapi) => async (uri) => ({\n *     contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify({ ok: true }) }],\n *   }),\n * });\n *\n * // later, in register() or bootstrap():\n * strapi.ai.mcp.registerResource(appInfo);\n * ```\n */\nexport const makeMcpResourceDefinition = ((definition: Modules.MCP.McpResourceDefinition) =>\n  definition) as unknown as Modules.MCP.McpResourceBuilder;\n\nexport class McpResourceRegistry\n  extends McpCapabilityRegistryBase<\n    'resource',\n    Modules.MCP.McpResourceDefinition,\n    RegisteredResource\n  >\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'resource', Modules.MCP.McpResourceDefinition>;\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, uri, metadata, createHandler } = definition;\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Resource',\n        name,\n        createHandler,\n        createFallbackHandler(errorMessage) {\n          return async (resourceUri) => ({\n            contents: [\n              {\n                uri: resourceUri.href,\n                text: `Resource \"${name}\" failed to initialize: ${errorMessage}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          });\n        },\n        createErrorResult(error, args) {\n          return {\n            contents: [\n              {\n                uri: args[0] instanceof URL ? args[0].href : uri,\n                text: `Resource \"${name}\" execution failed: ${error.message}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'resource',\n            name,\n            definition.telemetry,\n            safeHandler\n          );\n\n          return mcpServer.registerResource(name, uri, metadata, sdkHandler);\n        },\n      });\n    });\n  }\n}\n"],"names":["makeMcpResourceDefinition","definition","McpResourceRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","name","uri","metadata","createHandler","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","resourceUri","contents","href","text","mimeType","createErrorResult","error","args","URL","message","registerWithSdk","safeHandler","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerResource","ctx","definitions"],"mappings":";;;;;;;;;;;;;;;;AAcA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BC,IACM,MAAMA,yBAAAA,GAA6B,CAACC,aACzCA;AAUA,IAAA,OAAA,iBAAA,8BAAA,CAAA,SAAA,CAAA;AARK,MAAMC,mBAAAA,SACHC,+CAAAA,CAAAA;AAiBRC,IAAAA,IAAAA,CAAKC,SAAoB,EAAE;AACzB,QAAA,MAAMC,MAAAA,GAAS,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA;QAEpB,KAAK,CAACC,SAAS,CAACN,UAAAA,GAAAA;YACd,MAAM,EAAEO,IAAI,EAAEC,GAAG,EAAEC,QAAQ,EAAEC,aAAa,EAAE,GAAGV,UAAAA;AAE/C,YAAA,OAAOW,iEAAAA,CAAiC;AACtCN,gBAAAA,MAAAA;gBACAO,cAAAA,EAAgB,UAAA;AAChBL,gBAAAA,IAAAA;AACAG,gBAAAA,aAAAA;AACAG,gBAAAA,qBAAAA,CAAAA,CAAsBC,YAAY,EAAA;oBAChC,OAAO,OAAOC,eAAiB;4BAC7BC,QAAAA,EAAU;AACR,gCAAA;AACER,oCAAAA,GAAAA,EAAKO,YAAYE,IAAI;AACrBC,oCAAAA,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,wBAAwB,EAAEO,YAAAA,CAAAA,CAAc;oCAChEK,QAAAA,EAAU;AACZ;AACD;yBACH,CAAA;AACF,gBAAA,CAAA;gBACAC,iBAAAA,CAAAA,CAAkBC,KAAK,EAAEC,IAAI,EAAA;oBAC3B,OAAO;wBACLN,QAAAA,EAAU;AACR,4BAAA;gCACER,GAAAA,EAAKc,IAAI,CAAC,CAAA,CAAE,YAAYC,GAAAA,GAAMD,IAAI,CAAC,CAAA,CAAE,CAACL,IAAI,GAAGT,GAAAA;gCAC7CU,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,oBAAoB,EAAEc,KAAAA,CAAMG,OAAO,CAAA,CAAE;gCAC7DL,QAAAA,EAAU;AACZ;AACD;AACH,qBAAA;AACF,gBAAA,CAAA;AACAM,gBAAAA,eAAAA,CAAAA,CAAgBC,WAAW,EAAA;AACzB,oBAAA,MAAMC,aAAaC,+DAAAA,CACjBvB,MAAAA,EACA,YACAE,IAAAA,EACAP,UAAAA,CAAW6B,SAAS,EACpBH,WAAAA,CAAAA;AAGF,oBAAA,OAAOtB,SAAAA,CAAU0B,gBAAgB,CAACvB,IAAAA,EAAMC,KAAKC,QAAAA,EAAUkB,UAAAA,CAAAA;AACzD,gBAAA;AACF,aAAA,CAAA;AACF,QAAA,CAAA,CAAA;AACF,IAAA;AAtDA,IAAA,WAAA,CAAYI,GAGX,CAAE;AACD,QAAA,KAAK,CAACA,GAAAA,CAAIC,WAAW,CAAA,EANvB,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,OAAA,EAAA;;mBAAA;;AAOE,QAAA,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA,GAAUD,IAAI1B,MAAM;AAC3B,IAAA;AAiDF;;;;;"}

package/dist/services/mcp/resource-registry.mjs

@@ -12,6 +12,36 @@ var id = 0;
 function _class_private_field_loose_key(name) {
     return "__private_" + id++ + "_" + name;
 }
+/**
+ * Defines a Strapi MCP resource with full type inference, ready to pass to
+ * `strapi.ai.mcp.registerResource()`. Exposed publicly as `ai.mcp.defineResource`.
+ *
+ * The returned value is the definition unchanged — this builder only exists to
+ * infer the `name` and narrow the access variant (`devModeOnly` vs `auth`) so the
+ * result is directly assignable to `registerResource`.
+ *
+ * @param resource - The resource definition. Provide either `devModeOnly: true`
+ * (dev-only, no auth) or an `auth` policy set — never both.
+ * @returns The same definition, with its access variant narrowed.
+ *
+ * @example
+ * ```ts
+ * import { ai } from '@strapi/strapi';
+ *
+ * const appInfo = ai.mcp.defineResource({
+ *   name: 'app-info',
+ *   uri: 'strapi://app/info',
+ *   metadata: { description: 'Metadata about the app', mimeType: 'application/json' },
+ *   devModeOnly: true,
+ *   createHandler: (strapi) => async (uri) => ({
+ *     contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify({ ok: true }) }],
+ *   }),
+ * });
+ *
+ * // later, in register() or bootstrap():
+ * strapi.ai.mcp.registerResource(appInfo);
+ * ```
+ */ const makeMcpResourceDefinition = (definition)=>definition;
 var _strapi = /*#__PURE__*/ _class_private_field_loose_key("_strapi");
 class McpResourceRegistry extends McpCapabilityRegistryBase {
     bind(mcpServer) {
@@ -61,5 +91,5 @@ class McpResourceRegistry extends McpCapabilityRegistryBase {
     }
 }
 
-export { McpResourceRegistry };
+export { McpResourceRegistry, makeMcpResourceDefinition };
 //# sourceMappingURL=resource-registry.mjs.map

package/dist/services/mcp/resource-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource-registry.mjs","sources":["../../../src/services/mcp/resource-registry.ts"],"sourcesContent":["import type {\n  McpServer,\n  RegisteredResource,\n  // eslint-disable-next-line import/extensions\n} from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\n\nexport const makeMcpResourceDefinition = <Definition extends Modules.MCP.McpResourceDefinition>(\n  resource: Definition\n): Definition => resource;\n\nexport class McpResourceRegistry\n  extends McpCapabilityRegistryBase<\n    'resource',\n    Modules.MCP.McpResourceDefinition,\n    RegisteredResource\n  >\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'resource', Modules.MCP.McpResourceDefinition>;\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, uri, metadata, createHandler } = definition;\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Resource',\n        name,\n        createHandler,\n        createFallbackHandler(errorMessage) {\n          return async (resourceUri) => ({\n            contents: [\n              {\n                uri: resourceUri.href,\n                text: `Resource \"${name}\" failed to initialize: ${errorMessage}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          });\n        },\n        createErrorResult(error, args) {\n          return {\n            contents: [\n              {\n                uri: args[0] instanceof URL ? args[0].href : uri,\n                text: `Resource \"${name}\" execution failed: ${error.message}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'resource',\n            name,\n            definition.telemetry,\n            safeHandler\n          );\n\n          return mcpServer.registerResource(name, uri, metadata, sdkHandler);\n        },\n      });\n    });\n  }\n}\n"],"names":["McpResourceRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","definition","name","uri","metadata","createHandler","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","resourceUri","contents","href","text","mimeType","createErrorResult","error","args","URL","message","registerWithSdk","safeHandler","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerResource","ctx","definitions"],"mappings":";;;;;;;;;;;;;;AA0BE,IAAA,OAAA,iBAAA,8BAAA,CAAA,SAAA,CAAA;AARK,MAAMA,mBAAAA,SACHC,yBAAAA,CAAAA;AAiBRC,IAAAA,IAAAA,CAAKC,SAAoB,EAAE;AACzB,QAAA,MAAMC,MAAAA,GAAS,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA;QAEpB,KAAK,CAACC,SAAS,CAACC,UAAAA,GAAAA;YACd,MAAM,EAAEC,IAAI,EAAEC,GAAG,EAAEC,QAAQ,EAAEC,aAAa,EAAE,GAAGJ,UAAAA;AAE/C,YAAA,OAAOK,gCAAAA,CAAiC;AACtCP,gBAAAA,MAAAA;gBACAQ,cAAAA,EAAgB,UAAA;AAChBL,gBAAAA,IAAAA;AACAG,gBAAAA,aAAAA;AACAG,gBAAAA,qBAAAA,CAAAA,CAAsBC,YAAY,EAAA;oBAChC,OAAO,OAAOC,eAAiB;4BAC7BC,QAAAA,EAAU;AACR,gCAAA;AACER,oCAAAA,GAAAA,EAAKO,YAAYE,IAAI;AACrBC,oCAAAA,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,wBAAwB,EAAEO,YAAAA,CAAAA,CAAc;oCAChEK,QAAAA,EAAU;AACZ;AACD;yBACH,CAAA;AACF,gBAAA,CAAA;gBACAC,iBAAAA,CAAAA,CAAkBC,KAAK,EAAEC,IAAI,EAAA;oBAC3B,OAAO;wBACLN,QAAAA,EAAU;AACR,4BAAA;gCACER,GAAAA,EAAKc,IAAI,CAAC,CAAA,CAAE,YAAYC,GAAAA,GAAMD,IAAI,CAAC,CAAA,CAAE,CAACL,IAAI,GAAGT,GAAAA;gCAC7CU,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,oBAAoB,EAAEc,KAAAA,CAAMG,OAAO,CAAA,CAAE;gCAC7DL,QAAAA,EAAU;AACZ;AACD;AACH,qBAAA;AACF,gBAAA,CAAA;AACAM,gBAAAA,eAAAA,CAAAA,CAAgBC,WAAW,EAAA;AACzB,oBAAA,MAAMC,aAAaC,+BAAAA,CACjBxB,MAAAA,EACA,YACAG,IAAAA,EACAD,UAAAA,CAAWuB,SAAS,EACpBH,WAAAA,CAAAA;AAGF,oBAAA,OAAOvB,SAAAA,CAAU2B,gBAAgB,CAACvB,IAAAA,EAAMC,KAAKC,QAAAA,EAAUkB,UAAAA,CAAAA;AACzD,gBAAA;AACF,aAAA,CAAA;AACF,QAAA,CAAA,CAAA;AACF,IAAA;AAtDA,IAAA,WAAA,CAAYI,GAGX,CAAE;AACD,QAAA,KAAK,CAACA,GAAAA,CAAIC,WAAW,CAAA,EANvB,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,OAAA,EAAA;;mBAAA;;AAOE,QAAA,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA,GAAUD,IAAI3B,MAAM;AAC3B,IAAA;AAiDF;;;;"}
+{"version":3,"file":"resource-registry.mjs","sources":["../../../src/services/mcp/resource-registry.ts"],"sourcesContent":["import type {\n  McpServer,\n  RegisteredResource,\n  // eslint-disable-next-line import/extensions\n} from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\n\n/**\n * Defines a Strapi MCP resource with full type inference, ready to pass to\n * `strapi.ai.mcp.registerResource()`. Exposed publicly as `ai.mcp.defineResource`.\n *\n * The returned value is the definition unchanged — this builder only exists to\n * infer the `name` and narrow the access variant (`devModeOnly` vs `auth`) so the\n * result is directly assignable to `registerResource`.\n *\n * @param resource - The resource definition. Provide either `devModeOnly: true`\n * (dev-only, no auth) or an `auth` policy set — never both.\n * @returns The same definition, with its access variant narrowed.\n *\n * @example\n * ```ts\n * import { ai } from '@strapi/strapi';\n *\n * const appInfo = ai.mcp.defineResource({\n *   name: 'app-info',\n *   uri: 'strapi://app/info',\n *   metadata: { description: 'Metadata about the app', mimeType: 'application/json' },\n *   devModeOnly: true,\n *   createHandler: (strapi) => async (uri) => ({\n *     contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify({ ok: true }) }],\n *   }),\n * });\n *\n * // later, in register() or bootstrap():\n * strapi.ai.mcp.registerResource(appInfo);\n * ```\n */\nexport const makeMcpResourceDefinition = ((definition: Modules.MCP.McpResourceDefinition) =>\n  definition) as unknown as Modules.MCP.McpResourceBuilder;\n\nexport class McpResourceRegistry\n  extends McpCapabilityRegistryBase<\n    'resource',\n    Modules.MCP.McpResourceDefinition,\n    RegisteredResource\n  >\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'resource', Modules.MCP.McpResourceDefinition>;\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, uri, metadata, createHandler } = definition;\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Resource',\n        name,\n        createHandler,\n        createFallbackHandler(errorMessage) {\n          return async (resourceUri) => ({\n            contents: [\n              {\n                uri: resourceUri.href,\n                text: `Resource \"${name}\" failed to initialize: ${errorMessage}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          });\n        },\n        createErrorResult(error, args) {\n          return {\n            contents: [\n              {\n                uri: args[0] instanceof URL ? args[0].href : uri,\n                text: `Resource \"${name}\" execution failed: ${error.message}`,\n                mimeType: 'text/plain',\n              },\n            ],\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'resource',\n            name,\n            definition.telemetry,\n            safeHandler\n          );\n\n          return mcpServer.registerResource(name, uri, metadata, sdkHandler);\n        },\n      });\n    });\n  }\n}\n"],"names":["makeMcpResourceDefinition","definition","McpResourceRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","name","uri","metadata","createHandler","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","resourceUri","contents","href","text","mimeType","createErrorResult","error","args","URL","message","registerWithSdk","safeHandler","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerResource","ctx","definitions"],"mappings":";;;;;;;;;;;;;;AAcA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BC,IACM,MAAMA,yBAAAA,GAA6B,CAACC,aACzCA;AAUA,IAAA,OAAA,iBAAA,8BAAA,CAAA,SAAA,CAAA;AARK,MAAMC,mBAAAA,SACHC,yBAAAA,CAAAA;AAiBRC,IAAAA,IAAAA,CAAKC,SAAoB,EAAE;AACzB,QAAA,MAAMC,MAAAA,GAAS,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA;QAEpB,KAAK,CAACC,SAAS,CAACN,UAAAA,GAAAA;YACd,MAAM,EAAEO,IAAI,EAAEC,GAAG,EAAEC,QAAQ,EAAEC,aAAa,EAAE,GAAGV,UAAAA;AAE/C,YAAA,OAAOW,gCAAAA,CAAiC;AACtCN,gBAAAA,MAAAA;gBACAO,cAAAA,EAAgB,UAAA;AAChBL,gBAAAA,IAAAA;AACAG,gBAAAA,aAAAA;AACAG,gBAAAA,qBAAAA,CAAAA,CAAsBC,YAAY,EAAA;oBAChC,OAAO,OAAOC,eAAiB;4BAC7BC,QAAAA,EAAU;AACR,gCAAA;AACER,oCAAAA,GAAAA,EAAKO,YAAYE,IAAI;AACrBC,oCAAAA,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,wBAAwB,EAAEO,YAAAA,CAAAA,CAAc;oCAChEK,QAAAA,EAAU;AACZ;AACD;yBACH,CAAA;AACF,gBAAA,CAAA;gBACAC,iBAAAA,CAAAA,CAAkBC,KAAK,EAAEC,IAAI,EAAA;oBAC3B,OAAO;wBACLN,QAAAA,EAAU;AACR,4BAAA;gCACER,GAAAA,EAAKc,IAAI,CAAC,CAAA,CAAE,YAAYC,GAAAA,GAAMD,IAAI,CAAC,CAAA,CAAE,CAACL,IAAI,GAAGT,GAAAA;gCAC7CU,IAAAA,EAAM,CAAC,UAAU,EAAEX,IAAAA,CAAK,oBAAoB,EAAEc,KAAAA,CAAMG,OAAO,CAAA,CAAE;gCAC7DL,QAAAA,EAAU;AACZ;AACD;AACH,qBAAA;AACF,gBAAA,CAAA;AACAM,gBAAAA,eAAAA,CAAAA,CAAgBC,WAAW,EAAA;AACzB,oBAAA,MAAMC,aAAaC,+BAAAA,CACjBvB,MAAAA,EACA,YACAE,IAAAA,EACAP,UAAAA,CAAW6B,SAAS,EACpBH,WAAAA,CAAAA;AAGF,oBAAA,OAAOtB,SAAAA,CAAU0B,gBAAgB,CAACvB,IAAAA,EAAMC,KAAKC,QAAAA,EAAUkB,UAAAA,CAAAA;AACzD,gBAAA;AACF,aAAA,CAAA;AACF,QAAA,CAAA,CAAA;AACF,IAAA;AAtDA,IAAA,WAAA,CAAYI,GAGX,CAAE;AACD,QAAA,KAAK,CAACA,GAAAA,CAAIC,WAAW,CAAA,EANvB,MAAA,CAAA,cAAA,CAAA,IAAA,EAAA,OAAA,EAAA;;mBAAA;;AAOE,QAAA,+BAAA,CAAA,IAAI,EAAC,OAAA,CAAA,CAAA,OAAA,CAAA,GAAUD,IAAI1B,MAAM;AAC3B,IAAA;AAiDF;;;;"}

package/dist/services/mcp/routes.d.ts

@@ -7,5 +7,5 @@ export type McpRouteHandlers = {
  * Creates MCP route definitions for registration with Strapi server.
  * @internal
  */
-export declare const createMcpRoutes: (config: McpConfiguration, handlers: McpRouteHandlers) => Omit<Core.Route, 'info'>[];
+export declare const createMcpRoutes: (config: McpConfiguration, handlers: McpRouteHandlers) => Omit<Core.Route, "info">[];
 //# sourceMappingURL=routes.d.ts.map

package/dist/services/mcp/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAgB/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,WAClB,gBAAgB,YACd,gBAAgB,KACzB,KAAK,KAAK,KAAK,EAAE,MAAM,CAAC,EAU1B,CAAC"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAgB/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,gBAAgB,EACxB,UAAU,gBAAgB,KACzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EAU1B,CAAC"}

package/dist/services/mcp/tool-registry.d.ts

@@ -1,17 +1,44 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Core, Modules } from '@strapi/types';
-import { z } from '@strapi/utils';
 import { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';
 import { type McpCapabilityRegistry, McpCapabilityRegistryBase } from './internal/McpCapabilityRegistry';
 import type { McpAdminTokenAbility } from './authentication';
-export declare function makeMcpToolDefinition<Name extends string, Title extends string, Description extends string, OutputSchema extends z.ZodObject<z.ZodRawShape>, InputSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined, Access extends Modules.MCP.McpCapabilityAccess = Modules.MCP.McpCapabilityAccess>(tool: {
-    name: Name;
-    title: Title;
-    description: Description;
-    resolveInputSchema?: (context: Modules.MCP.McpHandlerContext) => InputSchema;
-    resolveOutputSchema: (context: Modules.MCP.McpHandlerContext) => OutputSchema;
-    createHandler: (strapi: Core.Strapi, context: Modules.MCP.McpHandlerContext) => Modules.MCP.McpToolHandler<NoInfer<InputSchema>, NoInfer<OutputSchema>>;
-} & Access): Modules.MCP.McpToolDefinition<Name, InputSchema, OutputSchema, Title, Description> & Access;
+/**
+ * Defines a Strapi MCP tool with full type inference, ready to pass to
+ * `strapi.ai.mcp.registerTool()`. Exposed publicly as `ai.mcp.defineTool`.
+ *
+ * The returned value is the definition unchanged — this builder only exists to
+ * infer the `name`, input/output schemas and handler types, and to narrow the
+ * access variant (`devModeOnly` vs `auth`) so the result is directly assignable
+ * to `registerTool`.
+ *
+ * @param tool - The tool definition. Provide either `devModeOnly: true` (dev-only,
+ * no auth) or an `auth` policy set — never both.
+ * @returns The same definition, with its access variant narrowed.
+ *
+ * @example
+ * ```ts
+ * import { ai } from '@strapi/strapi';
+ * import { z } from '@strapi/utils';
+ *
+ * const greet = ai.mcp.defineTool({
+ *   name: 'greet',
+ *   title: 'Greet',
+ *   description: 'Greets a user by name',
+ *   devModeOnly: true,
+ *   resolveInputSchema: () => z.object({ name: z.string() }),
+ *   resolveOutputSchema: () => z.object({ message: z.string() }),
+ *   createHandler: (strapi) => async ({ args }) => {
+ *     const message = `Hello, ${args.name}!`;
+ *     return { content: [{ type: 'text', text: message }], structuredContent: { message } };
+ *   },
+ * });
+ *
+ * // later, in register() or bootstrap():
+ * strapi.ai.mcp.registerTool(greet);
+ * ```
+ */
+export declare const makeMcpToolDefinition: Modules.MCP.McpToolBuilder;
 export declare class McpToolRegistry extends McpCapabilityRegistryBase<'tool', Modules.MCP.McpToolDefinition, RegisteredTool> implements McpCapabilityRegistry {
     #private;
     constructor(ctx: {

package/dist/services/mcp/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/tool-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EACL,KAAK,qBAAqB,EAC1B,yBAAyB,EAC1B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,wBAAgB,qBAAqB,CACnC,IAAI,SAAS,MAAM,EACnB,KAAK,SAAS,MAAM,EACpB,WAAW,SAAS,MAAM,EAC1B,YAAY,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAC/C,WAAW,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,SAAS,GAAG,SAAS,EACtE,MAAM,SAAS,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAEhF,IAAI,EAAE;IACJ,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,WAAW,CAAC;IAC7E,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,YAAY,CAAC;IAC9E,aAAa,EAAE,CACb,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KACnC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;CAC9E,GAAG,MAAM,GACT,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,MAAM,CAS7F;AAED,qBAAa,eACX,SAAQ,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,cAAc,CACvF,YAAW,qBAAqB;;gBAQpB,GAAG,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,+BAA+B,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACpF,OAAO,EAAE,oBAAoB,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;KAC7C;IAOD,IAAI,CAAC,SAAS,EAAE,SAAS;CAwE1B"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/tool-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EACL,KAAK,qBAAqB,EAC1B,yBAAyB,EAC1B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,qBAAqB,EACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AAEvD,qBAAa,eACX,SAAQ,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,cAAc,CACvF,YAAW,qBAAqB;;gBAQpB,GAAG,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,+BAA+B,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACpF,OAAO,EAAE,oBAAoB,CAAC;QAC9B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;KAC7C;IAOD,IAAI,CAAC,SAAS,EAAE,SAAS;CAwE1B"}

package/dist/services/mcp/tool-registry.js

@@ -15,9 +15,41 @@ var id = 0;
 function _class_private_field_loose_key(name) {
     return "__private_" + id++ + "_" + name;
 }
-function makeMcpToolDefinition(tool) {
-    return tool;
-}
+/**
+ * Defines a Strapi MCP tool with full type inference, ready to pass to
+ * `strapi.ai.mcp.registerTool()`. Exposed publicly as `ai.mcp.defineTool`.
+ *
+ * The returned value is the definition unchanged — this builder only exists to
+ * infer the `name`, input/output schemas and handler types, and to narrow the
+ * access variant (`devModeOnly` vs `auth`) so the result is directly assignable
+ * to `registerTool`.
+ *
+ * @param tool - The tool definition. Provide either `devModeOnly: true` (dev-only,
+ * no auth) or an `auth` policy set — never both.
+ * @returns The same definition, with its access variant narrowed.
+ *
+ * @example
+ * ```ts
+ * import { ai } from '@strapi/strapi';
+ * import { z } from '@strapi/utils';
+ *
+ * const greet = ai.mcp.defineTool({
+ *   name: 'greet',
+ *   title: 'Greet',
+ *   description: 'Greets a user by name',
+ *   devModeOnly: true,
+ *   resolveInputSchema: () => z.object({ name: z.string() }),
+ *   resolveOutputSchema: () => z.object({ message: z.string() }),
+ *   createHandler: (strapi) => async ({ args }) => {
+ *     const message = `Hello, ${args.name}!`;
+ *     return { content: [{ type: 'text', text: message }], structuredContent: { message } };
+ *   },
+ * });
+ *
+ * // later, in register() or bootstrap():
+ * strapi.ai.mcp.registerTool(greet);
+ * ```
+ */ const makeMcpToolDefinition = (definition)=>definition;
 var _strapi = /*#__PURE__*/ _class_private_field_loose_key("_strapi"), _ability = /*#__PURE__*/ _class_private_field_loose_key("_ability"), _user = /*#__PURE__*/ _class_private_field_loose_key("_user");
 class McpToolRegistry extends McpCapabilityRegistry.McpCapabilityRegistryBase {
     bind(mcpServer) {

package/dist/services/mcp/tool-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.js","sources":["../../../src/services/mcp/tool-registry.ts"],"sourcesContent":["// eslint-disable-next-line import/extensions\nimport type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { z } from '@strapi/utils';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport type { McpAdminTokenAbility } from './authentication';\n\nexport function makeMcpToolDefinition<\n  Name extends string,\n  Title extends string,\n  Description extends string,\n  OutputSchema extends z.ZodObject<z.ZodRawShape>,\n  InputSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined,\n  Access extends Modules.MCP.McpCapabilityAccess = Modules.MCP.McpCapabilityAccess,\n>(\n  tool: {\n    name: Name;\n    title: Title;\n    description: Description;\n    resolveInputSchema?: (context: Modules.MCP.McpHandlerContext) => InputSchema;\n    resolveOutputSchema: (context: Modules.MCP.McpHandlerContext) => OutputSchema;\n    createHandler: (\n      strapi: Core.Strapi,\n      context: Modules.MCP.McpHandlerContext\n    ) => Modules.MCP.McpToolHandler<NoInfer<InputSchema>, NoInfer<OutputSchema>>;\n  } & Access\n): Modules.MCP.McpToolDefinition<Name, InputSchema, OutputSchema, Title, Description> & Access {\n  return tool as Modules.MCP.McpToolDefinition<\n    Name,\n    InputSchema,\n    OutputSchema,\n    Title,\n    Description\n  > &\n    Access;\n}\n\nexport class McpToolRegistry\n  extends McpCapabilityRegistryBase<'tool', Modules.MCP.McpToolDefinition, RegisteredTool>\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  #ability: McpAdminTokenAbility;\n\n  #user: Modules.MCP.McpHandlerContext['user'];\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'tool', Modules.MCP.McpToolDefinition>;\n    ability: McpAdminTokenAbility;\n    user: Modules.MCP.McpHandlerContext['user'];\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n    this.#ability = ctx.ability;\n    this.#user = ctx.user;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, title, description, resolveInputSchema, resolveOutputSchema, createHandler } =\n        definition;\n\n      // Bind the session ability and token owner into the handler context so handlers can enforce\n      // field-level and entity-level permission checks and set creator fields.\n      const context: Modules.MCP.McpHandlerContext = {\n        userAbility: this.#ability,\n        user: this.#user,\n      };\n      const createHandlerWithContext = (strapi: Core.Strapi) => createHandler(strapi, context);\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Tool',\n        name,\n        createHandler: createHandlerWithContext,\n        createFallbackHandler(errorMessage) {\n          return async () => ({\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" failed to initialize: ${errorMessage}`,\n              },\n            ],\n            isError: true,\n          });\n        },\n        createErrorResult(error) {\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" execution failed: ${error.message}`,\n              },\n            ],\n            isError: true,\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const inputSchema =\n            resolveInputSchema !== undefined ? resolveInputSchema(context) : undefined;\n          const outputSchema = resolveOutputSchema(context);\n\n          // Adapt from our object-literal handler `({ args, extra })` to\n          // the MCP SDK's positional form `(args, extra)` / `(extra)`.\n          const baseHandler =\n            inputSchema !== undefined\n              ? (args: unknown, extra: unknown) =>\n                  safeHandler({ args, extra } as Parameters<typeof safeHandler>[0])\n              : (extra: unknown) => safeHandler({ extra } as Parameters<typeof safeHandler>[0]);\n\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'tool',\n            name,\n            definition.telemetry,\n            baseHandler\n          );\n\n          return mcpServer.registerTool(\n            name,\n            { title, description, inputSchema, outputSchema },\n            sdkHandler\n          );\n        },\n      });\n    });\n  }\n}\n"],"names":["makeMcpToolDefinition","tool","McpToolRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","definition","name","title","description","resolveInputSchema","resolveOutputSchema","createHandler","context","userAbility","user","createHandlerWithContext","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","content","type","text","isError","createErrorResult","error","message","registerWithSdk","safeHandler","inputSchema","undefined","outputSchema","baseHandler","args","extra","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerTool","ctx","definitions","ability"],"mappings":"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"}
+{"version":3,"file":"tool-registry.js","sources":["../../../src/services/mcp/tool-registry.ts"],"sourcesContent":["// eslint-disable-next-line import/extensions\nimport type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport type { McpAdminTokenAbility } from './authentication';\n\n/**\n * Defines a Strapi MCP tool with full type inference, ready to pass to\n * `strapi.ai.mcp.registerTool()`. Exposed publicly as `ai.mcp.defineTool`.\n *\n * The returned value is the definition unchanged — this builder only exists to\n * infer the `name`, input/output schemas and handler types, and to narrow the\n * access variant (`devModeOnly` vs `auth`) so the result is directly assignable\n * to `registerTool`.\n *\n * @param tool - The tool definition. Provide either `devModeOnly: true` (dev-only,\n * no auth) or an `auth` policy set — never both.\n * @returns The same definition, with its access variant narrowed.\n *\n * @example\n * ```ts\n * import { ai } from '@strapi/strapi';\n * import { z } from '@strapi/utils';\n *\n * const greet = ai.mcp.defineTool({\n *   name: 'greet',\n *   title: 'Greet',\n *   description: 'Greets a user by name',\n *   devModeOnly: true,\n *   resolveInputSchema: () => z.object({ name: z.string() }),\n *   resolveOutputSchema: () => z.object({ message: z.string() }),\n *   createHandler: (strapi) => async ({ args }) => {\n *     const message = `Hello, ${args.name}!`;\n *     return { content: [{ type: 'text', text: message }], structuredContent: { message } };\n *   },\n * });\n *\n * // later, in register() or bootstrap():\n * strapi.ai.mcp.registerTool(greet);\n * ```\n */\nexport const makeMcpToolDefinition = ((definition: Modules.MCP.McpToolDefinition) =>\n  definition) as unknown as Modules.MCP.McpToolBuilder;\n\nexport class McpToolRegistry\n  extends McpCapabilityRegistryBase<'tool', Modules.MCP.McpToolDefinition, RegisteredTool>\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  #ability: McpAdminTokenAbility;\n\n  #user: Modules.MCP.McpHandlerContext['user'];\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'tool', Modules.MCP.McpToolDefinition>;\n    ability: McpAdminTokenAbility;\n    user: Modules.MCP.McpHandlerContext['user'];\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n    this.#ability = ctx.ability;\n    this.#user = ctx.user;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, title, description, resolveInputSchema, resolveOutputSchema, createHandler } =\n        definition;\n\n      // Bind the session ability and token owner into the handler context so handlers can enforce\n      // field-level and entity-level permission checks and set creator fields.\n      const context: Modules.MCP.McpHandlerContext = {\n        userAbility: this.#ability,\n        user: this.#user,\n      };\n      const createHandlerWithContext = (strapi: Core.Strapi) => createHandler(strapi, context);\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Tool',\n        name,\n        createHandler: createHandlerWithContext,\n        createFallbackHandler(errorMessage) {\n          return async () => ({\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" failed to initialize: ${errorMessage}`,\n              },\n            ],\n            isError: true,\n          });\n        },\n        createErrorResult(error) {\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" execution failed: ${error.message}`,\n              },\n            ],\n            isError: true,\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const inputSchema =\n            resolveInputSchema !== undefined ? resolveInputSchema(context) : undefined;\n          const outputSchema = resolveOutputSchema(context);\n\n          // Adapt from our object-literal handler `({ args, extra })` to\n          // the MCP SDK's positional form `(args, extra)` / `(extra)`.\n          const baseHandler =\n            inputSchema !== undefined\n              ? (args: unknown, extra: unknown) =>\n                  safeHandler({ args, extra } as Parameters<typeof safeHandler>[0])\n              : (extra: unknown) => safeHandler({ extra } as Parameters<typeof safeHandler>[0]);\n\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'tool',\n            name,\n            definition.telemetry,\n            baseHandler\n          );\n\n          return mcpServer.registerTool(\n            name,\n            { title, description, inputSchema, outputSchema },\n            sdkHandler\n          );\n        },\n      });\n    });\n  }\n}\n"],"names":["makeMcpToolDefinition","definition","McpToolRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","name","title","description","resolveInputSchema","resolveOutputSchema","createHandler","context","userAbility","user","createHandlerWithContext","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","content","type","text","isError","createErrorResult","error","message","registerWithSdk","safeHandler","inputSchema","undefined","outputSchema","baseHandler","args","extra","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerTool","ctx","definitions","ability"],"mappings":"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"}

package/dist/services/mcp/tool-registry.mjs

@@ -13,9 +13,41 @@ var id = 0;
 function _class_private_field_loose_key(name) {
     return "__private_" + id++ + "_" + name;
 }
-function makeMcpToolDefinition(tool) {
-    return tool;
-}
+/**
+ * Defines a Strapi MCP tool with full type inference, ready to pass to
+ * `strapi.ai.mcp.registerTool()`. Exposed publicly as `ai.mcp.defineTool`.
+ *
+ * The returned value is the definition unchanged — this builder only exists to
+ * infer the `name`, input/output schemas and handler types, and to narrow the
+ * access variant (`devModeOnly` vs `auth`) so the result is directly assignable
+ * to `registerTool`.
+ *
+ * @param tool - The tool definition. Provide either `devModeOnly: true` (dev-only,
+ * no auth) or an `auth` policy set — never both.
+ * @returns The same definition, with its access variant narrowed.
+ *
+ * @example
+ * ```ts
+ * import { ai } from '@strapi/strapi';
+ * import { z } from '@strapi/utils';
+ *
+ * const greet = ai.mcp.defineTool({
+ *   name: 'greet',
+ *   title: 'Greet',
+ *   description: 'Greets a user by name',
+ *   devModeOnly: true,
+ *   resolveInputSchema: () => z.object({ name: z.string() }),
+ *   resolveOutputSchema: () => z.object({ message: z.string() }),
+ *   createHandler: (strapi) => async ({ args }) => {
+ *     const message = `Hello, ${args.name}!`;
+ *     return { content: [{ type: 'text', text: message }], structuredContent: { message } };
+ *   },
+ * });
+ *
+ * // later, in register() or bootstrap():
+ * strapi.ai.mcp.registerTool(greet);
+ * ```
+ */ const makeMcpToolDefinition = (definition)=>definition;
 var _strapi = /*#__PURE__*/ _class_private_field_loose_key("_strapi"), _ability = /*#__PURE__*/ _class_private_field_loose_key("_ability"), _user = /*#__PURE__*/ _class_private_field_loose_key("_user");
 class McpToolRegistry extends McpCapabilityRegistryBase {
     bind(mcpServer) {

package/dist/services/mcp/tool-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.mjs","sources":["../../../src/services/mcp/tool-registry.ts"],"sourcesContent":["// eslint-disable-next-line import/extensions\nimport type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { z } from '@strapi/utils';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport type { McpAdminTokenAbility } from './authentication';\n\nexport function makeMcpToolDefinition<\n  Name extends string,\n  Title extends string,\n  Description extends string,\n  OutputSchema extends z.ZodObject<z.ZodRawShape>,\n  InputSchema extends z.ZodObject<z.ZodRawShape> | undefined = undefined,\n  Access extends Modules.MCP.McpCapabilityAccess = Modules.MCP.McpCapabilityAccess,\n>(\n  tool: {\n    name: Name;\n    title: Title;\n    description: Description;\n    resolveInputSchema?: (context: Modules.MCP.McpHandlerContext) => InputSchema;\n    resolveOutputSchema: (context: Modules.MCP.McpHandlerContext) => OutputSchema;\n    createHandler: (\n      strapi: Core.Strapi,\n      context: Modules.MCP.McpHandlerContext\n    ) => Modules.MCP.McpToolHandler<NoInfer<InputSchema>, NoInfer<OutputSchema>>;\n  } & Access\n): Modules.MCP.McpToolDefinition<Name, InputSchema, OutputSchema, Title, Description> & Access {\n  return tool as Modules.MCP.McpToolDefinition<\n    Name,\n    InputSchema,\n    OutputSchema,\n    Title,\n    Description\n  > &\n    Access;\n}\n\nexport class McpToolRegistry\n  extends McpCapabilityRegistryBase<'tool', Modules.MCP.McpToolDefinition, RegisteredTool>\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  #ability: McpAdminTokenAbility;\n\n  #user: Modules.MCP.McpHandlerContext['user'];\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'tool', Modules.MCP.McpToolDefinition>;\n    ability: McpAdminTokenAbility;\n    user: Modules.MCP.McpHandlerContext['user'];\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n    this.#ability = ctx.ability;\n    this.#user = ctx.user;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, title, description, resolveInputSchema, resolveOutputSchema, createHandler } =\n        definition;\n\n      // Bind the session ability and token owner into the handler context so handlers can enforce\n      // field-level and entity-level permission checks and set creator fields.\n      const context: Modules.MCP.McpHandlerContext = {\n        userAbility: this.#ability,\n        user: this.#user,\n      };\n      const createHandlerWithContext = (strapi: Core.Strapi) => createHandler(strapi, context);\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Tool',\n        name,\n        createHandler: createHandlerWithContext,\n        createFallbackHandler(errorMessage) {\n          return async () => ({\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" failed to initialize: ${errorMessage}`,\n              },\n            ],\n            isError: true,\n          });\n        },\n        createErrorResult(error) {\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" execution failed: ${error.message}`,\n              },\n            ],\n            isError: true,\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const inputSchema =\n            resolveInputSchema !== undefined ? resolveInputSchema(context) : undefined;\n          const outputSchema = resolveOutputSchema(context);\n\n          // Adapt from our object-literal handler `({ args, extra })` to\n          // the MCP SDK's positional form `(args, extra)` / `(extra)`.\n          const baseHandler =\n            inputSchema !== undefined\n              ? (args: unknown, extra: unknown) =>\n                  safeHandler({ args, extra } as Parameters<typeof safeHandler>[0])\n              : (extra: unknown) => safeHandler({ extra } as Parameters<typeof safeHandler>[0]);\n\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'tool',\n            name,\n            definition.telemetry,\n            baseHandler\n          );\n\n          return mcpServer.registerTool(\n            name,\n            { title, description, inputSchema, outputSchema },\n            sdkHandler\n          );\n        },\n      });\n    });\n  }\n}\n"],"names":["makeMcpToolDefinition","tool","McpToolRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","definition","name","title","description","resolveInputSchema","resolveOutputSchema","createHandler","context","userAbility","user","createHandlerWithContext","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","content","type","text","isError","createErrorResult","error","message","registerWithSdk","safeHandler","inputSchema","undefined","outputSchema","baseHandler","args","extra","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerTool","ctx","definitions","ability"],"mappings":"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"}
+{"version":3,"file":"tool-registry.mjs","sources":["../../../src/services/mcp/tool-registry.ts"],"sourcesContent":["// eslint-disable-next-line import/extensions\nimport type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { Core, Modules } from '@strapi/types';\nimport { McpCapabilityDefinitionRegistry } from './internal/McpCapabilityDefinitionRegistry';\nimport {\n  type McpCapabilityRegistry,\n  McpCapabilityRegistryBase,\n} from './internal/McpCapabilityRegistry';\nimport { wrapCapabilityHandlerForMetrics } from './metrics/wrapCapabilityHandlerForMetrics';\nimport { createSafeCapabilityRegistration } from './utils/createSafeCapabilityRegistration';\nimport type { McpAdminTokenAbility } from './authentication';\n\n/**\n * Defines a Strapi MCP tool with full type inference, ready to pass to\n * `strapi.ai.mcp.registerTool()`. Exposed publicly as `ai.mcp.defineTool`.\n *\n * The returned value is the definition unchanged — this builder only exists to\n * infer the `name`, input/output schemas and handler types, and to narrow the\n * access variant (`devModeOnly` vs `auth`) so the result is directly assignable\n * to `registerTool`.\n *\n * @param tool - The tool definition. Provide either `devModeOnly: true` (dev-only,\n * no auth) or an `auth` policy set — never both.\n * @returns The same definition, with its access variant narrowed.\n *\n * @example\n * ```ts\n * import { ai } from '@strapi/strapi';\n * import { z } from '@strapi/utils';\n *\n * const greet = ai.mcp.defineTool({\n *   name: 'greet',\n *   title: 'Greet',\n *   description: 'Greets a user by name',\n *   devModeOnly: true,\n *   resolveInputSchema: () => z.object({ name: z.string() }),\n *   resolveOutputSchema: () => z.object({ message: z.string() }),\n *   createHandler: (strapi) => async ({ args }) => {\n *     const message = `Hello, ${args.name}!`;\n *     return { content: [{ type: 'text', text: message }], structuredContent: { message } };\n *   },\n * });\n *\n * // later, in register() or bootstrap():\n * strapi.ai.mcp.registerTool(greet);\n * ```\n */\nexport const makeMcpToolDefinition = ((definition: Modules.MCP.McpToolDefinition) =>\n  definition) as unknown as Modules.MCP.McpToolBuilder;\n\nexport class McpToolRegistry\n  extends McpCapabilityRegistryBase<'tool', Modules.MCP.McpToolDefinition, RegisteredTool>\n  implements McpCapabilityRegistry\n{\n  #strapi: Core.Strapi;\n\n  #ability: McpAdminTokenAbility;\n\n  #user: Modules.MCP.McpHandlerContext['user'];\n\n  constructor(ctx: {\n    strapi: Core.Strapi;\n    definitions: McpCapabilityDefinitionRegistry<'tool', Modules.MCP.McpToolDefinition>;\n    ability: McpAdminTokenAbility;\n    user: Modules.MCP.McpHandlerContext['user'];\n  }) {\n    super(ctx.definitions);\n    this.#strapi = ctx.strapi;\n    this.#ability = ctx.ability;\n    this.#user = ctx.user;\n  }\n\n  bind(mcpServer: McpServer) {\n    const strapi = this.#strapi;\n\n    super.register((definition) => {\n      const { name, title, description, resolveInputSchema, resolveOutputSchema, createHandler } =\n        definition;\n\n      // Bind the session ability and token owner into the handler context so handlers can enforce\n      // field-level and entity-level permission checks and set creator fields.\n      const context: Modules.MCP.McpHandlerContext = {\n        userAbility: this.#ability,\n        user: this.#user,\n      };\n      const createHandlerWithContext = (strapi: Core.Strapi) => createHandler(strapi, context);\n\n      return createSafeCapabilityRegistration({\n        strapi,\n        capabilityType: 'Tool',\n        name,\n        createHandler: createHandlerWithContext,\n        createFallbackHandler(errorMessage) {\n          return async () => ({\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" failed to initialize: ${errorMessage}`,\n              },\n            ],\n            isError: true,\n          });\n        },\n        createErrorResult(error) {\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: `Tool \"${name}\" execution failed: ${error.message}`,\n              },\n            ],\n            isError: true,\n          };\n        },\n        registerWithSdk(safeHandler) {\n          const inputSchema =\n            resolveInputSchema !== undefined ? resolveInputSchema(context) : undefined;\n          const outputSchema = resolveOutputSchema(context);\n\n          // Adapt from our object-literal handler `({ args, extra })` to\n          // the MCP SDK's positional form `(args, extra)` / `(extra)`.\n          const baseHandler =\n            inputSchema !== undefined\n              ? (args: unknown, extra: unknown) =>\n                  safeHandler({ args, extra } as Parameters<typeof safeHandler>[0])\n              : (extra: unknown) => safeHandler({ extra } as Parameters<typeof safeHandler>[0]);\n\n          const sdkHandler = wrapCapabilityHandlerForMetrics(\n            strapi,\n            'tool',\n            name,\n            definition.telemetry,\n            baseHandler\n          );\n\n          return mcpServer.registerTool(\n            name,\n            { title, description, inputSchema, outputSchema },\n            sdkHandler\n          );\n        },\n      });\n    });\n  }\n}\n"],"names":["makeMcpToolDefinition","definition","McpToolRegistry","McpCapabilityRegistryBase","bind","mcpServer","strapi","register","name","title","description","resolveInputSchema","resolveOutputSchema","createHandler","context","userAbility","user","createHandlerWithContext","createSafeCapabilityRegistration","capabilityType","createFallbackHandler","errorMessage","content","type","text","isError","createErrorResult","error","message","registerWithSdk","safeHandler","inputSchema","undefined","outputSchema","baseHandler","args","extra","sdkHandler","wrapCapabilityHandlerForMetrics","telemetry","registerTool","ctx","definitions","ability"],"mappings":"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"}