@webpieces/core-util 0.4.806 → 0.4.807

package/src/mcp/DtoSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"DtoSchema.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/DtoSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\n\nconst DTO_MARKER = 'webpieces:dto-schema';\nconst DTO_FIELDS = 'webpieces:dto-fields';\nconst RESPONSE_DTOS = 'webpieces:response-dtos';\n\n// webpieces-disable no-any-unknown -- abstract class tokens necessarily erase constructor parameters\nexport type DtoClass = abstract new (...args: any[]) => unknown;\n/** The element type of an array or the value type of a map; TypeScript erases both at runtime. */\nexport type DtoElementType = 'string' | 'number' | 'integer' | 'boolean' | DtoClass;\n/** Runtime values accepted at the DTO validation boundary. */\nexport type DtoValue = object | string | number | boolean | null;\n\n/** Additive field metadata; the scalar/object type itself comes from `design:type`. */\nexport class WpDtoFieldOptions {\n    constructor(\n        public readonly description: string,\n        /** Required/optional is explicit because TypeScript erases `?` at runtime. */\n        public readonly required: boolean,\n        /** Required for arrays because TypeScript erases their element type. */\n        public readonly arrayItems?: DtoElementType,\n        /** A reflected Number is otherwise emitted as JSON Schema `number`. */\n        public readonly integer: boolean = false,\n        public readonly minimum?: number,\n        public readonly maximum?: number,\n        public readonly enumValues?: readonly [string, ...string[]],\n        /** MCP 2026 SEP-2243 header mirrored as `Mcp-Param-{name}`. */\n        public readonly mcpHeader?: WpMcpHeader,\n    ) {}\n}\n\n/**\n * Names the `x-mcp-header` a primitive tool parameter is mirrored into (`Mcp-Param-{name}`). A class,\n * not a bare string, so the 8th `WpDtoFieldOptions` argument can never be mistaken for a map value\n * type (maps use `WpDtoMapFieldOptions`).\n */\nexport class WpMcpHeader {\n    constructor(public readonly name: string) {}\n}\n\n/**\n * Field metadata for a typed map such as `Record<string, string>` or `Record<string, SomeDto>`.\n * Keys are open strings; every VALUE must match `mapValues`. The value type is explicit for the same\n * reason `arrayItems` is: TypeScript erases it, and a `Record` reflects as plain `Object`.\n */\nexport class WpDtoMapFieldOptions {\n    constructor(\n        public readonly description: string,\n        /** Required/optional is explicit because TypeScript erases `?` at runtime. */\n        public readonly required: boolean,\n        public readonly mapValues: DtoElementType,\n    ) {}\n}\n\nexport class WpDtoFieldMetadata {\n    constructor(\n        public readonly propertyKey: string,\n        public readonly options: WpDtoFieldOptions | WpDtoMapFieldOptions,\n    ) {}\n}\n\n/** The JSON Schema subset emitted for Webpieces API DTOs. */\nexport class ApiJsonSchema {\n    type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array';\n    description?: string;\n    properties?: Record<string, ApiJsonSchema>;\n    required?: string[];\n    /** `false` closes an object; a schema makes it a typed map whose values all match that schema. */\n    additionalProperties?: boolean | ApiJsonSchema;\n    items?: ApiJsonSchema;\n    enum?: string[];\n    minimum?: number;\n    maximum?: number;\n    /** MCP 2026 SEP-2243 schema extension consumed by the official SDK. */\n    declare 'x-mcp-header'?: string;\n\n    constructor(type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array') {\n        this.type = type;\n    }\n}\n\n/** A validation result safe to show to an API caller/model. */\nexport class DtoValidationFailure {\n    constructor(\n        /** JSON path of the offending value, e.g. `$.address.city`. */\n        public readonly field: string,\n        public readonly message: string,\n    ) {}\n}\n\n/** Marks a request/response class as a schema-bearing DTO, including intentionally empty DTOs. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpDto(): ClassDecorator {\n    return (target: Function): void => Reflect.defineMetadata(DTO_MARKER, true, target);\n}\n\n/** Adds documentation and runtime-only shape facts to a DTO property. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpDtoField(options: WpDtoFieldOptions | WpDtoMapFieldOptions): PropertyDecorator {\n    if (options.description.trim() === '') {\n        throw new Error('@WpDtoField requires non-empty field documentation.');\n    }\n    return (target: object, propertyKey: string | symbol): void => {\n        const dtoClass = target.constructor;\n        const fields: Record<string, WpDtoFieldMetadata> =\n            Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};\n        const name = String(propertyKey);\n        fields[name] = new WpDtoFieldMetadata(name, options);\n        Reflect.defineMetadata(DTO_FIELDS, fields, dtoClass);\n    };\n}\n\n/** Declares an async API method's response DTO because reflection sees Promise, not its generic. */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpResponseDto(responseDto: () => DtoClass): MethodDecorator {\n    return (target: object, propertyKey: string | symbol): void => {\n        const apiClass = target.constructor;\n        const responses: Record<string, () => DtoClass> =\n            Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};\n        responses[String(propertyKey)] = responseDto;\n        Reflect.defineMetadata(RESPONSE_DTOS, responses, apiClass);\n    };\n}\n\n/** Builds and validates the same DTO schema used for MCP input and structured output. */\nexport class DtoSchemaBuilder {\n    requestClassOf(apiClass: Function, methodName: string): DtoClass {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns erased runtime constructor tokens\n        const params = Reflect.getMetadata('design:paramtypes', apiClass.prototype, methodName) as\n            | DtoClass[]\n            | undefined;\n        if (!params || params.length !== 1) {\n            throw new Error(\n                `${apiClass.name}.${methodName} must take exactly one @WpDto request class to be an MCP tool.`,\n            );\n        }\n        return params[0];\n    }\n\n    responseClassOf(apiClass: Function, methodName: string): DtoClass {\n        const responses: Record<string, () => DtoClass> =\n            Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};\n        const response = responses[methodName];\n        if (!response) {\n            throw new Error(\n                `${apiClass.name}.${methodName} must declare @WpResponseDto(() => ResponseClass) before MCP exposure.`,\n            );\n        }\n        return response();\n    }\n\n    /**\n     * The one closure gate for an object schema. Closed means no key can carry an unspecified value:\n     * either extra keys are forbidden (`additionalProperties: false`) or every extra key's value is\n     * typed (`additionalProperties: <schema>`, a typed map). A missing or `true` value is open.\n     * Use this instead of `schema.additionalProperties === false`, which rejects typed maps.\n     */\n    isClosedSchema(schema: ApiJsonSchema): boolean {\n        const extra = schema.additionalProperties;\n        return extra === false || (typeof extra === 'object' && extra !== null);\n    }\n\n    build(dtoClass: DtoClass): ApiJsonSchema {\n        const schema = this.buildAt(dtoClass, new Set<DtoClass>());\n        this.validateMcpHeaders(schema, new Map<string, string>());\n        return schema;\n    }\n\n    validate(dtoClass: DtoClass, value: DtoValue): DtoValidationFailure | undefined {\n        return this.validateAt(dtoClass, value, '$');\n    }\n\n    private buildAt(dtoClass: DtoClass, parents: Set<DtoClass>): ApiJsonSchema {\n        this.requireDto(dtoClass);\n        if (parents.has(dtoClass)) {\n            throw new Error(`Recursive DTO ${dtoClass.name} cannot use an inline MCP schema.`);\n        }\n        const nextParents = new Set(parents);\n        nextParents.add(dtoClass);\n        const schema = new ApiJsonSchema('object');\n        schema.properties = {};\n        schema.additionalProperties = false;\n        const required: string[] = [];\n        for (const field of this.fields(dtoClass)) {\n            schema.properties[field.propertyKey] = this.fieldSchema(dtoClass, field, nextParents);\n            if (field.options.required) required.push(field.propertyKey);\n        }\n        if (required.length > 0) schema.required = required;\n        return schema;\n    }\n\n    private fieldSchema(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        parents: Set<DtoClass>,\n    ): ApiJsonSchema {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token\n        const reflected = Reflect.getMetadata(\n            'design:type',\n            dtoClass.prototype,\n            field.propertyKey,\n        ) as DtoClass | undefined;\n        if (!reflected)\n            throw new Error(`No reflected type for ${dtoClass.name}.${field.propertyKey}.`);\n        this.validateOptions(dtoClass, field, reflected);\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) {\n            const mapSchema = new ApiJsonSchema('object');\n            mapSchema.description = options.description;\n            mapSchema.additionalProperties = this.itemSchema(options.mapValues, parents);\n            return mapSchema;\n        }\n        let schema: ApiJsonSchema;\n        switch (reflected.name) {\n            case 'String':\n                schema = new ApiJsonSchema('string');\n                break;\n            case 'Number':\n                schema = new ApiJsonSchema(options.integer ? 'integer' : 'number');\n                break;\n            case 'Boolean':\n                schema = new ApiJsonSchema('boolean');\n                break;\n            case 'Array':\n                if (!options.arrayItems) {\n                    throw new Error(\n                        `${dtoClass.name}.${field.propertyKey} must declare arrayItems.`,\n                    );\n                }\n                schema = new ApiJsonSchema('array');\n                schema.items = this.itemSchema(options.arrayItems, parents);\n                break;\n            default:\n                schema = this.buildAt(reflected, parents);\n        }\n        schema.description = options.description;\n        if (options.minimum !== undefined) schema.minimum = options.minimum;\n        if (options.maximum !== undefined) schema.maximum = options.maximum;\n        if (options.enumValues) schema.enum = [...options.enumValues];\n        if (options.mcpHeader) schema['x-mcp-header'] = options.mcpHeader.name;\n        return schema;\n    }\n\n    private validateOptions(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        reflected: DtoClass,\n    ): void {\n        const label = `${dtoClass.name}.${field.propertyKey}`;\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) {\n            if (reflected !== Object) {\n                throw new Error(\n                    `${label} declares mapValues but is not a map (Record<string, V>).`,\n                );\n            }\n            return;\n        }\n        if (reflected === Object) {\n            throw new Error(\n                `${label} has type Object: an interface or Record can never be a @WpDto. ` +\n                    'For a map, use WpDtoMapFieldOptions.',\n            );\n        }\n        if (reflected.name !== 'Array' && options.arrayItems) {\n            throw new Error(`${label} declares arrayItems but is not an array.`);\n        }\n        if (\n            reflected.name !== 'Number' &&\n            (options.integer || options.minimum !== undefined || options.maximum !== undefined)\n        ) {\n            throw new Error(`${label} declares numeric constraints but is not a number.`);\n        }\n        if (\n            options.minimum !== undefined &&\n            options.maximum !== undefined &&\n            options.minimum > options.maximum\n        ) {\n            throw new Error(`${label} minimum cannot exceed maximum.`);\n        }\n        if (options.enumValues && reflected.name !== 'String') {\n            throw new Error(`${label} enumValues require a string field.`);\n        }\n        if (options.mcpHeader !== undefined) {\n            if (!/^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/.test(options.mcpHeader.name)) {\n                throw new Error(`${label} mcpHeader must be an RFC 9110 token.`);\n            }\n            if (!['String', 'Number', 'Boolean'].includes(reflected.name)) {\n                throw new Error(`${label} mcpHeader requires a primitive field.`);\n            }\n            if (reflected.name === 'Number' && !options.integer) {\n                throw new Error(\n                    `${label} mcpHeader cannot mirror a non-integer number (MCP 2026-07-28).`,\n                );\n            }\n        }\n    }\n\n    private itemSchema(item: DtoElementType, parents: Set<DtoClass>): ApiJsonSchema {\n        if (typeof item !== 'string') return this.buildAt(item, parents);\n        return new ApiJsonSchema(item === 'integer' ? 'integer' : item);\n    }\n\n    private validateMcpHeaders(schema: ApiJsonSchema, seen: Map<string, string>): void {\n        const header = schema['x-mcp-header'];\n        if (header) {\n            const key = header.toLowerCase();\n            const prior = seen.get(key);\n            if (prior) {\n                throw new Error(`mcpHeader '${header}' duplicates '${prior}' case-insensitively.`);\n            }\n            seen.set(key, header);\n        }\n        for (const child of Object.values(schema.properties ?? {})) {\n            this.validateMcpHeaders(child, seen);\n        }\n    }\n\n    private validateAt(\n        dtoClass: DtoClass,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        this.requireDto(dtoClass);\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            return new DtoValidationFailure(path, `${path} must be an object`);\n        }\n        const fields = this.fields(dtoClass);\n        const known = new Set(fields.map((field: WpDtoFieldMetadata) => field.propertyKey));\n        for (const key of Object.keys(value)) {\n            if (!known.has(key))\n                return new DtoValidationFailure(`${path}.${key}`, `${path}.${key} is not allowed`);\n        }\n        for (const field of fields) {\n            const fieldValue = Object.getOwnPropertyDescriptor(value, field.propertyKey)?.value;\n            if (fieldValue === undefined) {\n                if (field.options.required) {\n                    return new DtoValidationFailure(\n                        `${path}.${field.propertyKey}`,\n                        `${path}.${field.propertyKey} is required`,\n                    );\n                }\n                continue;\n            }\n            const failure = this.validateField(\n                dtoClass,\n                field,\n                fieldValue,\n                `${path}.${field.propertyKey}`,\n            );\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateField(\n        dtoClass: DtoClass,\n        field: WpDtoFieldMetadata,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token\n        const reflected = Reflect.getMetadata(\n            'design:type',\n            dtoClass.prototype,\n            field.propertyKey,\n        ) as DtoClass;\n        const options = field.options;\n        if (options instanceof WpDtoMapFieldOptions) return this.validateMap(options, value, path);\n        const expected = reflected?.name;\n        if (expected === 'Array') return this.validateArray(options, value, path);\n        if (expected === 'String') {\n            if (typeof value !== 'string')\n                return new DtoValidationFailure(path, `${path} must be a string`);\n            if (options.enumValues && !options.enumValues.includes(value)) {\n                return new DtoValidationFailure(\n                    path,\n                    `${path} must be one of: ${options.enumValues.join(', ')}`,\n                );\n            }\n            return undefined;\n        }\n        if (expected === 'Number') {\n            if (typeof value !== 'number' || !Number.isFinite(value)) {\n                return new DtoValidationFailure(path, `${path} must be a number`);\n            }\n            if (options.integer && !Number.isInteger(value)) {\n                return new DtoValidationFailure(path, `${path} must be an integer`);\n            }\n            if (options.minimum !== undefined && value < options.minimum) {\n                return new DtoValidationFailure(path, `${path} must be >= ${options.minimum}`);\n            }\n            if (options.maximum !== undefined && value > options.maximum) {\n                return new DtoValidationFailure(path, `${path} must be <= ${options.maximum}`);\n            }\n            return undefined;\n        }\n        if (expected === 'Boolean') {\n            return typeof value === 'boolean'\n                ? undefined\n                : new DtoValidationFailure(path, `${path} must be a boolean`);\n        }\n        return this.validateAt(reflected, value, path);\n    }\n\n    private validateArray(\n        options: WpDtoFieldOptions,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (!Array.isArray(value))\n            return new DtoValidationFailure(path, `${path} must be an array`);\n        if (!options.arrayItems) return new DtoValidationFailure(path, `${path} has no item type`);\n        for (let index = 0; index < value.length; index += 1) {\n            const failure = this.validateElement(\n                options.arrayItems,\n                value[index],\n                `${path}[${index}]`,\n            );\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateMap(\n        options: WpDtoMapFieldOptions,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            return new DtoValidationFailure(path, `${path} must be an object map`);\n        }\n        const prototype: object | null = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null) {\n            return new DtoValidationFailure(path, `${path} must be a plain object map`);\n        }\n        for (const key of Object.keys(value)) {\n            const entry: DtoValue = Object.getOwnPropertyDescriptor(value, key)?.value;\n            const failure = this.validateElement(options.mapValues, entry, `${path}.${key}`);\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateElement(\n        type: DtoElementType,\n        item: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof type !== 'string') return this.validateAt(type, item, path);\n        const wanted = type === 'integer' ? 'number' : type;\n        if (typeof item !== wanted || (type === 'integer' && !Number.isInteger(item))) {\n            return new DtoValidationFailure(path, `${path} must be ${type}`);\n        }\n        return undefined;\n    }\n\n    private fields(dtoClass: DtoClass): WpDtoFieldMetadata[] {\n        const fields: Record<string, WpDtoFieldMetadata> =\n            Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};\n        return Object.values(fields);\n    }\n\n    private requireDto(dtoClass: DtoClass): void {\n        if (!Reflect.getMetadata(DTO_MARKER, dtoClass)) {\n            throw new Error(\n                `${dtoClass.name} must be decorated with @WpDto() for schema generation.`,\n            );\n        }\n    }\n}\n"]}
+{"version":3,"file":"DtoSchema.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/DtoSchema.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The JSON Schema subset webpieces publishes on its API boundaries, and the ONE runtime validator of\n * it.\n *\n * ## Nothing here reads reflect-metadata any more\n *\n * Until #984 this file also carried `@WpDto`, `@WpDtoField`, `WpDtoFieldOptions`,\n * `WpDtoMapFieldOptions`, `WpMcpHeader`, `@WpResponseDto` and `DtoSchemaBuilder` — a second, runtime\n * spelling of facts the TypeScript compiler already holds. #983 measured the two against each other\n * and found the compiler reproduces every one of those arguments byte for byte, so they are deleted\n * rather than deprecated (`.claude/rules/no-backwards-compat.md`): a schema is now BUILT at build\n * time from the source by `@webpieces/api-doc-model`, and the runtime is HANDED the result.\n *\n * What survives is the schema itself, a builder for the boundaries that construct one by hand, and a\n * validator that reads the schema instead of a decorator.\n */\n\n/** Runtime values accepted at the DTO validation boundary. */\nexport type DtoValue = object | string | number | boolean | null;\n\n/**\n * One JSON Schema `type`. `null` is a member because NULLABLE is expressed as `[\"string\", \"null\"]`,\n * which is how JSON Schema says \"present, and may hold null\" — a different wire document from an\n * ABSENT property, and one the reflect-metadata runtime could neither see nor write down.\n */\nexport type ApiJsonSchemaType =\n    | 'object'\n    | 'string'\n    | 'number'\n    | 'integer'\n    | 'boolean'\n    | 'array'\n    | 'null';\n\n/** The JSON Schema subset emitted for Webpieces API DTOs. */\nexport class ApiJsonSchema {\n    /** One type, or `[T, \"null\"]` for a nullable field. */\n    type?: ApiJsonSchemaType | readonly ApiJsonSchemaType[];\n    description?: string;\n    properties?: Record<string, ApiJsonSchema>;\n    required?: string[];\n    /** `false` closes an object; a schema makes it a typed map whose values all match that schema. */\n    additionalProperties?: boolean | ApiJsonSchema;\n    items?: ApiJsonSchema;\n    enum?: string[];\n    minimum?: number;\n    maximum?: number;\n    /** MCP 2026 SEP-2243 schema extension consumed by the official SDK. */\n    declare 'x-mcp-header'?: string;\n\n    constructor(type?: ApiJsonSchemaType | readonly ApiJsonSchemaType[]) {\n        this.type = type;\n    }\n\n    /**\n     * The non-`null` member of the type, which is the one that decides how a value is checked.\n     *\n     * These three are STATIC and not instance methods on purpose: an instance method would put a\n     * function on the structural type, and this class is handed straight to the MCP SDK, whose\n     * parameter types are index-signature JSON objects that a class carrying methods no longer\n     * satisfies. It stays a data-only structure (`CLAUDE.md` §1) and the helpers live beside it.\n     */\n    // webpieces-disable no-function-outside-class -- static reader of this class\n    static baseTypeOf(schema: ApiJsonSchema): ApiJsonSchemaType | undefined {\n        if (schema.type === undefined) return undefined;\n        if (typeof schema.type === 'string') return schema.type;\n        return schema.type.find((one: ApiJsonSchemaType) => one !== 'null');\n    }\n\n    /** True when the schema was widened with `\"null\"`, i.e. the property may hold `null`. */\n    // webpieces-disable no-function-outside-class -- static reader of this class\n    static allowsNull(schema: ApiJsonSchema): boolean {\n        return typeof schema.type !== 'string' && (schema.type?.includes('null') ?? false);\n    }\n\n    /**\n     * The one closure gate for an object schema. Closed means no key can carry an unspecified value:\n     * either extra keys are forbidden (`additionalProperties: false`) or every extra key's value is\n     * typed (`additionalProperties: <schema>`, a typed map). A missing or `true` value is open.\n     * Use this instead of `schema.additionalProperties === false`, which rejects typed maps.\n     */\n    // webpieces-disable no-function-outside-class -- static reader of this class\n    static isClosed(schema: ApiJsonSchema): boolean {\n        const extra = schema.additionalProperties;\n        return extra === false || (typeof extra === 'object' && extra !== null);\n    }\n}\n\n/**\n * Builds the CLOSED object schema a hand-written runtime boundary validates against — `@WpStream`'s\n * two event schemas are the whole of its client list today.\n *\n * It exists because the alternative spellings are both worse: a decorator that re-states the field\n * types the compiler already knows is exactly what #984 deleted, and a bare object literal is what\n * `CLAUDE.md` §3 forbids. A generated schema never comes through here — it is read from the build's\n * own artifact.\n */\nexport class ObjectSchemaBuilder {\n    private readonly schema = new ApiJsonSchema('object');\n    private readonly requiredNames: string[] = [];\n\n    constructor() {\n        this.schema.properties = {};\n        this.schema.additionalProperties = false;\n    }\n\n    required(name: string, type: ApiJsonSchema): this {\n        this.requiredNames.push(name);\n        return this.optional(name, type);\n    }\n\n    optional(name: string, type: ApiJsonSchema): this {\n        this.schema.properties![name] = type;\n        return this;\n    }\n\n    build(): ApiJsonSchema {\n        if (this.requiredNames.length > 0) this.schema.required = [...this.requiredNames];\n        return this.schema;\n    }\n}\n\n/** A validation result safe to show to an API caller/model. */\nexport class DtoValidationFailure {\n    constructor(\n        /** JSON path of the offending value, e.g. `$.address.city`. */\n        public readonly field: string,\n        public readonly message: string,\n    ) {}\n}\n\n/**\n * Validates a value against an {@link ApiJsonSchema} — the ONE runtime narrowing boundary for MCP\n * tool arguments, MCP structured output and typed stream events.\n *\n * It reads the SCHEMA, which is the same object the build published to agents, so a document that\n * says a field is required and a server that accepts it missing cannot disagree. The predecessor\n * walked reflect-metadata instead, which meant the published document and the accepted request were\n * derived from two different declarations.\n */\nexport class ApiJsonSchemaValidator {\n    validate(schema: ApiJsonSchema, value: DtoValue): DtoValidationFailure | undefined {\n        return this.validateAt(schema, value, '$');\n    }\n\n    private validateAt(\n        schema: ApiJsonSchema,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (value === null) {\n            return ApiJsonSchema.allowsNull(schema)\n                ? undefined\n                : new DtoValidationFailure(path, `${path} must not be null`);\n        }\n        switch (ApiJsonSchema.baseTypeOf(schema)) {\n            case 'object':\n                return this.validateObject(schema, value, path);\n            case 'array':\n                return this.validateArray(schema, value, path);\n            case 'string':\n                return this.validateString(schema, value, path);\n            case 'number':\n            case 'integer':\n                return this.validateNumber(schema, value, path);\n            case 'boolean':\n                return typeof value === 'boolean'\n                    ? undefined\n                    : new DtoValidationFailure(path, `${path} must be a boolean`);\n            default:\n                return undefined;\n        }\n    }\n\n    private validateObject(\n        schema: ApiJsonSchema,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            return new DtoValidationFailure(path, `${path} must be an object`);\n        }\n        const properties = schema.properties ?? {};\n        const extra = schema.additionalProperties;\n        for (const key of Object.keys(value)) {\n            const entry: DtoValue = Object.getOwnPropertyDescriptor(value, key)?.value;\n            const declared = Object.getOwnPropertyDescriptor(properties, key)?.value as\n                | ApiJsonSchema\n                | undefined;\n            if (declared === undefined) {\n                if (typeof extra !== 'object' || extra === null) {\n                    return new DtoValidationFailure(\n                        `${path}.${key}`,\n                        `${path}.${key} is not allowed`,\n                    );\n                }\n                const failure = this.validateAt(extra, entry, `${path}.${key}`);\n                if (failure) return failure;\n                continue;\n            }\n            const failure = this.validateAt(declared, entry, `${path}.${key}`);\n            if (failure) return failure;\n        }\n        for (const name of schema.required ?? []) {\n            if (Object.getOwnPropertyDescriptor(value, name)?.value === undefined) {\n                return new DtoValidationFailure(`${path}.${name}`, `${path}.${name} is required`);\n            }\n        }\n        return undefined;\n    }\n\n    private validateArray(\n        schema: ApiJsonSchema,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (!Array.isArray(value)) {\n            return new DtoValidationFailure(path, `${path} must be an array`);\n        }\n        const items = schema.items;\n        if (items === undefined) return undefined;\n        for (let index = 0; index < value.length; index += 1) {\n            const failure = this.validateAt(items, value[index], `${path}[${index}]`);\n            if (failure) return failure;\n        }\n        return undefined;\n    }\n\n    private validateString(\n        schema: ApiJsonSchema,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof value !== 'string') {\n            return new DtoValidationFailure(path, `${path} must be a string`);\n        }\n        if (schema.enum && !schema.enum.includes(value)) {\n            return new DtoValidationFailure(\n                path,\n                `${path} must be one of: ${schema.enum.join(', ')}`,\n            );\n        }\n        return undefined;\n    }\n\n    private validateNumber(\n        schema: ApiJsonSchema,\n        value: DtoValue,\n        path: string,\n    ): DtoValidationFailure | undefined {\n        if (typeof value !== 'number' || !Number.isFinite(value)) {\n            return new DtoValidationFailure(path, `${path} must be a number`);\n        }\n        if (ApiJsonSchema.baseTypeOf(schema) === 'integer' && !Number.isInteger(value)) {\n            return new DtoValidationFailure(path, `${path} must be an integer`);\n        }\n        if (schema.minimum !== undefined && value < schema.minimum) {\n            return new DtoValidationFailure(path, `${path} must be >= ${schema.minimum}`);\n        }\n        if (schema.maximum !== undefined && value > schema.maximum) {\n            return new DtoValidationFailure(path, `${path} must be <= ${schema.maximum}`);\n        }\n        return undefined;\n    }\n}\n"]}

package/src/mcp/McpCompileAssertions.js

@@ -2,34 +2,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const McpMetadata_1 = require("./McpMetadata");
-const DtoSchema_1 = require("./DtoSchema");
-const invalidEmptyEnum = new DtoSchema_1.WpDtoFieldOptions('invalid enum', true, undefined, false, undefined, undefined, 
-// @ts-expect-error enumValues must contain at least one allowed string
-[]);
-// @ts-expect-error a map's value type must be a scalar name or a DtoClass
-const invalidMapValue = new DtoSchema_1.WpDtoMapFieldOptions('invalid map', true, 'date');
-// @ts-expect-error a map value type is mandatory: it is the whole point of WpDtoMapFieldOptions
-const missingMapValue = new DtoSchema_1.WpDtoMapFieldOptions('invalid map', true);
-const noEighthFieldArgument = new DtoSchema_1.WpDtoFieldOptions('maps are not a WpDtoFieldOptions argument', false, undefined, false, undefined, undefined, undefined, 
-// @ts-expect-error maps use WpDtoMapFieldOptions; the 8th argument is only a WpMcpHeader
-'string');
+/**
+ * Compile-time pins for `@WpMcpTool`. These live in a COMPILED file rather than a `.spec.ts` because
+ * vitest strips types with esbuild and `tsconfig.lib.json` excludes specs, so a `@ts-expect-error` in
+ * a spec is inert (`.claude/rules/no-backwards-compat.md` shim shape #4). Here, tsc fails the build
+ * with TS2578 the moment one of these starts compiling.
+ */
 class InvalidMcpContract {
-    invalid(_request) {
+    // @ts-expect-error @WpMcpTool takes the stable protocol NAME, not an options object
+    options(_request) {
+        throw new Error('contract only');
+    }
+    // @ts-expect-error side-effect claims belong on @Endpoint.operation, never @WpMcpTool
+    hints(_request) {
         throw new Error('contract only');
     }
 }
 tslib_1.__decorate([
-    (0, McpMetadata_1.WpMcpTool)({
-        name: 'invalid',
-        description: 'This declaration must never compile.',
-        // @ts-expect-error side-effect claims belong on @Endpoint.operation, never @WpMcpTool
-        readOnlyHint: true,
-        openWorldHint: false,
-    }),
+    (0, McpMetadata_1.WpMcpTool)({ name: 'invalid' }),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], InvalidMcpContract.prototype, "options", null);
+tslib_1.__decorate([
+    (0, McpMetadata_1.WpMcpTool)('invalid', true),
     tslib_1.__metadata("design:type", Function),
     tslib_1.__metadata("design:paramtypes", [Object]),
     tslib_1.__metadata("design:returntype", Promise)
-], InvalidMcpContract.prototype, "invalid", null);
+], InvalidMcpContract.prototype, "hints", null);
 class InvalidMcpArities {
     // @ts-expect-error MCP tools require exactly one request DTO
     zero() {
@@ -41,29 +41,17 @@ class InvalidMcpArities {
     }
 }
 tslib_1.__decorate([
-    (0, McpMetadata_1.WpMcpTool)({
-        name: 'zero-arity',
-        description: 'This declaration must never compile.',
-        openWorldHint: false,
-    }),
+    (0, McpMetadata_1.WpMcpTool)('zero-arity'),
     tslib_1.__metadata("design:type", Function),
     tslib_1.__metadata("design:paramtypes", []),
     tslib_1.__metadata("design:returntype", Promise)
 ], InvalidMcpArities.prototype, "zero", null);
 tslib_1.__decorate([
-    (0, McpMetadata_1.WpMcpTool)({
-        name: 'multi-arity',
-        description: 'This declaration must never compile.',
-        openWorldHint: false,
-    }),
+    (0, McpMetadata_1.WpMcpTool)('multi-arity'),
     tslib_1.__metadata("design:type", Function),
     tslib_1.__metadata("design:paramtypes", [Object, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], InvalidMcpArities.prototype, "multi", null);
 void InvalidMcpContract;
 void InvalidMcpArities;
-void invalidEmptyEnum;
-void invalidMapValue;
-void missingMapValue;
-void noEighthFieldArgument;
 //# sourceMappingURL=McpCompileAssertions.js.map

package/src/mcp/McpCompileAssertions.js.map

@@ -1 +1 @@
-{"version":3,"file":"McpCompileAssertions.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAC1C,2CAAsE;AAEtE,MAAM,gBAAgB,GAAG,IAAI,6BAAiB,CAC1C,cAAc,EACd,IAAI,EACJ,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS;AACT,uEAAuE;AACvE,EAAE,CACL,CAAC;AAEF,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,gCAAoB,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE9E,gGAAgG;AAChG,MAAM,eAAe,GAAG,IAAI,gCAAoB,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAEtE,MAAM,qBAAqB,GAAG,IAAI,6BAAiB,CAC/C,2CAA2C,EAC3C,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS,EACT,SAAS;AACT,yFAAyF;AACzF,QAAQ,CACX,CAAC;AAEF,MAAe,kBAAkB;IAQ7B,OAAO,CAAC,QAAgB;QACpB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAHG;IAPC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sCAAsC;QACnD,sFAAsF;QACtF,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;iDAGD;AAGL,MAAe,iBAAiB;IAC5B,6DAA6D;IAM7D,IAAI;QACA,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,6DAA6D;IAM7D,KAAK,CAAC,MAAc,EAAE,OAAe;QACjC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAbG;IALC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,sCAAsC;QACnD,aAAa,EAAE,KAAK;KACvB,CAAC;;;;6CAGD;AAQD;IALC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sCAAsC;QACnD,aAAa,EAAE,KAAK;KACvB,CAAC;;;;8CAGD;AAGL,KAAK,kBAAkB,CAAC;AACxB,KAAK,iBAAiB,CAAC;AACvB,KAAK,gBAAgB,CAAC;AACtB,KAAK,eAAe,CAAC;AACrB,KAAK,eAAe,CAAC;AACrB,KAAK,qBAAqB,CAAC","sourcesContent":["import { WpMcpTool } from './McpMetadata';\nimport { WpDtoFieldOptions, WpDtoMapFieldOptions } from './DtoSchema';\n\nconst invalidEmptyEnum = new WpDtoFieldOptions(\n    'invalid enum',\n    true,\n    undefined,\n    false,\n    undefined,\n    undefined,\n    // @ts-expect-error enumValues must contain at least one allowed string\n    [],\n);\n\n// @ts-expect-error a map's value type must be a scalar name or a DtoClass\nconst invalidMapValue = new WpDtoMapFieldOptions('invalid map', true, 'date');\n\n// @ts-expect-error a map value type is mandatory: it is the whole point of WpDtoMapFieldOptions\nconst missingMapValue = new WpDtoMapFieldOptions('invalid map', true);\n\nconst noEighthFieldArgument = new WpDtoFieldOptions(\n    'maps are not a WpDtoFieldOptions argument',\n    false,\n    undefined,\n    false,\n    undefined,\n    undefined,\n    undefined,\n    // @ts-expect-error maps use WpDtoMapFieldOptions; the 8th argument is only a WpMcpHeader\n    'string',\n);\n\nabstract class InvalidMcpContract {\n    @WpMcpTool({\n        name: 'invalid',\n        description: 'This declaration must never compile.',\n        // @ts-expect-error side-effect claims belong on @Endpoint.operation, never @WpMcpTool\n        readOnlyHint: true,\n        openWorldHint: false,\n    })\n    invalid(_request: object): Promise<object> {\n        throw new Error('contract only');\n    }\n}\n\nabstract class InvalidMcpArities {\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool({\n        name: 'zero-arity',\n        description: 'This declaration must never compile.',\n        openWorldHint: false,\n    })\n    zero(): Promise<object> {\n        throw new Error('contract only');\n    }\n\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool({\n        name: 'multi-arity',\n        description: 'This declaration must never compile.',\n        openWorldHint: false,\n    })\n    multi(_first: object, _second: object): Promise<object> {\n        throw new Error('contract only');\n    }\n}\n\nvoid InvalidMcpContract;\nvoid InvalidMcpArities;\nvoid invalidEmptyEnum;\nvoid invalidMapValue;\nvoid missingMapValue;\nvoid noEighthFieldArgument;\n"]}
+{"version":3,"file":"McpCompileAssertions.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAE1C;;;;;GAKG;AACH,MAAe,kBAAkB;IAC7B,oFAAoF;IAEpF,OAAO,CAAC,QAAgB;QACpB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,sFAAsF;IAEtF,KAAK,CAAC,QAAgB;QAClB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AATG;IADC,IAAA,uBAAS,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;;;iDAG9B;AAID;IADC,IAAA,uBAAS,EAAC,SAAS,EAAE,IAAI,CAAC;;;;+CAG1B;AAGL,MAAe,iBAAiB;IAC5B,6DAA6D;IAE7D,IAAI;QACA,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,6DAA6D;IAE7D,KAAK,CAAC,MAAc,EAAE,OAAe;QACjC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AATG;IADC,IAAA,uBAAS,EAAC,YAAY,CAAC;;;;6CAGvB;AAID;IADC,IAAA,uBAAS,EAAC,aAAa,CAAC;;;;8CAGxB;AAGL,KAAK,kBAAkB,CAAC;AACxB,KAAK,iBAAiB,CAAC","sourcesContent":["import { WpMcpTool } from './McpMetadata';\n\n/**\n * Compile-time pins for `@WpMcpTool`. These live in a COMPILED file rather than a `.spec.ts` because\n * vitest strips types with esbuild and `tsconfig.lib.json` excludes specs, so a `@ts-expect-error` in\n * a spec is inert (`.claude/rules/no-backwards-compat.md` shim shape #4). Here, tsc fails the build\n * with TS2578 the moment one of these starts compiling.\n */\nabstract class InvalidMcpContract {\n    // @ts-expect-error @WpMcpTool takes the stable protocol NAME, not an options object\n    @WpMcpTool({ name: 'invalid' })\n    options(_request: object): Promise<object> {\n        throw new Error('contract only');\n    }\n\n    // @ts-expect-error side-effect claims belong on @Endpoint.operation, never @WpMcpTool\n    @WpMcpTool('invalid', true)\n    hints(_request: object): Promise<object> {\n        throw new Error('contract only');\n    }\n}\n\nabstract class InvalidMcpArities {\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool('zero-arity')\n    zero(): Promise<object> {\n        throw new Error('contract only');\n    }\n\n    // @ts-expect-error MCP tools require exactly one request DTO\n    @WpMcpTool('multi-arity')\n    multi(_first: object, _second: object): Promise<object> {\n        throw new Error('contract only');\n    }\n}\n\nvoid InvalidMcpContract;\nvoid InvalidMcpArities;\n"]}

package/src/mcp/McpMetadata.d.ts

@@ -8,15 +8,6 @@ export declare class WpMcpToolHints {
     readonly openWorldHint: boolean;
     constructor(readOnlyHint: boolean, destructiveHint: boolean, idempotentHint: boolean, openWorldHint: boolean);
 }
-type CommonToolOptions = {
-    /** Stable protocol name. Renaming this breaks saved agent workflows. */
-    name: string;
-    /** Tool-level documentation published verbatim by tools/list. */
-    description: string;
-    openWorldHint: boolean;
-};
-/** Tool-specific declarations. Side-effect hints come only from the endpoint operation. */
-export type WpMcpToolOptions = CommonToolOptions;
 type AsyncObjectMethod = (...args: never[]) => Promise<object>;
 type ExactOneParameter<TMethod extends AsyncObjectMethod> = Parameters<TMethod>['length'] extends 1 ? object : never;
 type ExactOneMethodDescriptor<TMethod extends AsyncObjectMethod> = TypedPropertyDescriptor<TMethod> & ExactOneParameter<TMethod>;
@@ -26,18 +17,33 @@ export type WpMcpMethodDecorator = <TMethod extends AsyncObjectMethod>(target: o
 export declare class WpMcpToolMetadata {
     readonly methodName: string;
     readonly name: string;
-    readonly description: string;
-    readonly openWorldHint: boolean;
-    constructor(methodName: string, name: string, description: string, openWorldHint: boolean);
+    constructor(methodName: string, name: string);
 }
 /**
- * Explicitly publishes an existing `@Endpoint(POST, path, WRITE, RPC)` method as an MCP tool.
+ * Explicitly publishes an existing `@Endpoint(POST, path, WRITE, RPC)` method as an MCP tool, under
+ * the STABLE protocol name given here.
+ *
+ * The name is the whole argument, and deliberately the only one. It is independent of the method
+ * name because renaming a method must not break a saved agent workflow, and nothing else about a
+ * tool is unsayable in the source:
+ *
+ * | fact | where it comes from |
+ * |---|---|
+ * | `description` | the method's JSDoc body, or its `@mcp` tag — the same words the partner reads |
+ * | `readOnlyHint` / `destructiveHint` / `idempotentHint` | `@Endpoint`'s `operation`, via {@link mcpHintsForOperation} |
+ * | `openWorldHint` | `@Endpoint`'s `openWorld` option |
+ * | `inputSchema` / `outputSchema` | the declared request and response types |
+ *
+ * ```typescript
+ * @WpMcpTool('search_stores')
+ * ```
  *
- * This annotation owns tool-level documentation only. Input/output field documentation and JSON
- * Schema come from the request/response DTO metadata. The endpoint's `@WpAuth*` annotation remains
- * the sole runtime authorization policy.
+ * Until #984 it also took a `description`, duplicating the JSDoc. Two authored copies of one
+ * paragraph drift the first time somebody edits one, and nothing catches it — the partner reads the
+ * OpenAPI text and the agent reads the decorator text. With `description` gone the options object
+ * held one field, so it is a plain string and `WpMcpToolOptions` is deleted with it.
  */
-export declare function WpMcpTool(options: WpMcpToolOptions): WpMcpMethodDecorator;
+export declare function WpMcpTool(name: string): WpMcpMethodDecorator;
 /** The one mapping from endpoint side effects to MCP advisory annotations. */
 export declare function mcpHintsForOperation(operation: EndpointOperation, openWorldHint: boolean): WpMcpToolHints;
 /** Returns only methods explicitly opted in through {@link WpMcpTool}. */

package/src/mcp/McpMetadata.js

@@ -25,35 +25,45 @@ exports.WpMcpToolHints = WpMcpToolHints;
 class WpMcpToolMetadata {
     methodName;
     name;
-    description;
-    openWorldHint;
-    constructor(methodName, name, description, openWorldHint) {
+    constructor(methodName, name) {
         this.methodName = methodName;
         this.name = name;
-        this.description = description;
-        this.openWorldHint = openWorldHint;
     }
 }
 exports.WpMcpToolMetadata = WpMcpToolMetadata;
 /**
- * Explicitly publishes an existing `@Endpoint(POST, path, WRITE, RPC)` method as an MCP tool.
+ * Explicitly publishes an existing `@Endpoint(POST, path, WRITE, RPC)` method as an MCP tool, under
+ * the STABLE protocol name given here.
+ *
+ * The name is the whole argument, and deliberately the only one. It is independent of the method
+ * name because renaming a method must not break a saved agent workflow, and nothing else about a
+ * tool is unsayable in the source:
  *
- * This annotation owns tool-level documentation only. Input/output field documentation and JSON
- * Schema come from the request/response DTO metadata. The endpoint's `@WpAuth*` annotation remains
- * the sole runtime authorization policy.
+ * | fact | where it comes from |
+ * |---|---|
+ * | `description` | the method's JSDoc body, or its `@mcp` tag — the same words the partner reads |
+ * | `readOnlyHint` / `destructiveHint` / `idempotentHint` | `@Endpoint`'s `operation`, via {@link mcpHintsForOperation} |
+ * | `openWorldHint` | `@Endpoint`'s `openWorld` option |
+ * | `inputSchema` / `outputSchema` | the declared request and response types |
+ *
+ * ```typescript
+ * @WpMcpTool('search_stores')
+ * ```
+ *
+ * Until #984 it also took a `description`, duplicating the JSDoc. Two authored copies of one
+ * paragraph drift the first time somebody edits one, and nothing catches it — the partner reads the
+ * OpenAPI text and the agent reads the decorator text. With `description` gone the options object
+ * held one field, so it is a plain string and `WpMcpToolOptions` is deleted with it.
  */
 // webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope
-function WpMcpTool(options) {
-    if (options.name.trim() === '')
+function WpMcpTool(name) {
+    if (name.trim() === '')
         throw new Error('@WpMcpTool requires a non-empty stable name.');
-    if (options.description.trim() === '') {
-        throw new Error('@WpMcpTool requires non-empty tool documentation.');
-    }
     return (target, propertyKey, _descriptor) => {
         const apiClass = target.constructor;
         const tools = Reflect.getMetadata(decorators_1.METADATA_KEYS.MCP_TOOLS, apiClass) ?? {};
         const methodName = String(propertyKey);
-        tools[methodName] = new WpMcpToolMetadata(methodName, options.name, options.description, options.openWorldHint);
+        tools[methodName] = new WpMcpToolMetadata(methodName, name);
         Reflect.defineMetadata(decorators_1.METADATA_KEYS.MCP_TOOLS, tools, apiClass);
     };
 }

package/src/mcp/McpMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"McpMetadata.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpMetadata.ts"],"names":[],"mappings":";;;AA8DA,8BAsBC;AAID,oDAYC;AAID,sCAIC;AA5GD,4BAA0B;AAC1B,mDAAmD;AACnD,qEAKqC;AAErC,wFAAwF;AACxF,MAAa,cAAc;IAEH;IACA;IACA;IACA;IAJpB,YACoB,YAAqB,EACrB,eAAwB,EACxB,cAAuB,EACvB,aAAsB;QAHtB,iBAAY,GAAZ,YAAY,CAAS;QACrB,oBAAe,GAAf,eAAe,CAAS;QACxB,mBAAc,GAAd,cAAc,CAAS;QACvB,kBAAa,GAAb,aAAa,CAAS;IACvC,CAAC;CACP;AAPD,wCAOC;AA2BD,4DAA4D;AAC5D,MAAa,iBAAiB;IAEN;IACA;IACA;IACA;IAJpB,YACoB,UAAkB,EAClB,IAAY,EACZ,WAAmB,EACnB,aAAsB;QAHtB,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAQ;QACnB,kBAAa,GAAb,aAAa,CAAS;IACvC,CAAC;CACP;AAPD,8CAOC;AAED;;;;;;GAMG;AACH,iGAAiG;AACjG,SAAgB,SAAS,CAAC,OAAyB;IAC/C,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAChG,IAAI,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,CACH,MAAc,EACd,WAA4B,EAC5B,WAA8C,EAC1C,EAAE;QACN,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC;QACpC,MAAM,KAAK,GACP,OAAO,CAAC,WAAW,CAAC,0BAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,iBAAiB,CACrC,UAAU,EACV,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,aAAa,CACxB,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,0BAAa,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,kGAAkG;AAClG,SAAgB,oBAAoB,CAChC,SAA4B,EAC5B,aAAsB;IAEtB,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,0BAAI;YACL,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QAChE,KAAK,sCAAgB;YACjB,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QAChE,KAAK,2BAAK;YACN,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IACrE,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,2FAA2F;AAC3F,SAAgB,aAAa,CAAC,QAAkB;IAC5C,MAAM,KAAK,GACP,OAAO,CAAC,WAAW,CAAC,0BAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { METADATA_KEYS } from '../http/decorators';\nimport {\n    EndpointOperation,\n    READ,\n    WRITE_IDEMPOTENT,\n    WRITE,\n} from '../http/HttpEndpointOptions';\n\n/** The immutable hints MCP clients use when deciding whether and how to call a tool. */\nexport class WpMcpToolHints {\n    constructor(\n        public readonly readOnlyHint: boolean,\n        public readonly destructiveHint: boolean,\n        public readonly idempotentHint: boolean,\n        public readonly openWorldHint: boolean,\n    ) {}\n}\n\ntype CommonToolOptions = {\n    /** Stable protocol name. Renaming this breaks saved agent workflows. */\n    name: string;\n    /** Tool-level documentation published verbatim by tools/list. */\n    description: string;\n    openWorldHint: boolean;\n};\n\n/** Tool-specific declarations. Side-effect hints come only from the endpoint operation. */\nexport type WpMcpToolOptions = CommonToolOptions;\n\ntype AsyncObjectMethod = (...args: never[]) => Promise<object>;\ntype ExactOneParameter<TMethod extends AsyncObjectMethod> = Parameters<TMethod>['length'] extends 1\n    ? object\n    : never;\ntype ExactOneMethodDescriptor<TMethod extends AsyncObjectMethod> =\n    TypedPropertyDescriptor<TMethod> & ExactOneParameter<TMethod>;\n\n/** Method decorator restricted to one request DTO and one async response DTO. */\nexport type WpMcpMethodDecorator = <TMethod extends AsyncObjectMethod>(\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: ExactOneMethodDescriptor<TMethod>,\n) => void;\n\n/** Runtime metadata for one explicitly exposed endpoint. */\nexport class WpMcpToolMetadata {\n    constructor(\n        public readonly methodName: string,\n        public readonly name: string,\n        public readonly description: string,\n        public readonly openWorldHint: boolean,\n    ) {}\n}\n\n/**\n * Explicitly publishes an existing `@Endpoint(POST, path, WRITE, RPC)` method as an MCP tool.\n *\n * This annotation owns tool-level documentation only. Input/output field documentation and JSON\n * Schema come from the request/response DTO metadata. The endpoint's `@WpAuth*` annotation remains\n * the sole runtime authorization policy.\n */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpMcpTool(options: WpMcpToolOptions): WpMcpMethodDecorator {\n    if (options.name.trim() === '') throw new Error('@WpMcpTool requires a non-empty stable name.');\n    if (options.description.trim() === '') {\n        throw new Error('@WpMcpTool requires non-empty tool documentation.');\n    }\n    return <TMethod extends AsyncObjectMethod>(\n        target: object,\n        propertyKey: string | symbol,\n        _descriptor: ExactOneMethodDescriptor<TMethod>,\n    ): void => {\n        const apiClass = target.constructor;\n        const tools: Record<string, WpMcpToolMetadata> =\n            Reflect.getMetadata(METADATA_KEYS.MCP_TOOLS, apiClass) ?? {};\n        const methodName = String(propertyKey);\n        tools[methodName] = new WpMcpToolMetadata(\n            methodName,\n            options.name,\n            options.description,\n            options.openWorldHint,\n        );\n        Reflect.defineMetadata(METADATA_KEYS.MCP_TOOLS, tools, apiClass);\n    };\n}\n\n/** The one mapping from endpoint side effects to MCP advisory annotations. */\n// webpieces-disable no-function-outside-class -- pure metadata mapping shared by MCP registration\nexport function mcpHintsForOperation(\n    operation: EndpointOperation,\n    openWorldHint: boolean,\n): WpMcpToolHints {\n    switch (operation) {\n        case READ:\n            return new WpMcpToolHints(true, false, true, openWorldHint);\n        case WRITE_IDEMPOTENT:\n            return new WpMcpToolHints(false, true, true, openWorldHint);\n        case WRITE:\n            return new WpMcpToolHints(false, true, false, openWorldHint);\n    }\n}\n\n/** Returns only methods explicitly opted in through {@link WpMcpTool}. */\n// webpieces-disable no-function-outside-class -- metadata reader paired with the decorator\nexport function getWpMcpTools(apiClass: Function): WpMcpToolMetadata[] {\n    const tools: Record<string, WpMcpToolMetadata> =\n        Reflect.getMetadata(METADATA_KEYS.MCP_TOOLS, apiClass) ?? {};\n    return Object.values(tools);\n}\n"]}
+{"version":3,"file":"McpMetadata.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpMetadata.ts"],"names":[],"mappings":";;;AA6DA,8BAcC;AAID,oDAYC;AAID,sCAIC;AAnGD,4BAA0B;AAC1B,mDAAmD;AACnD,qEAA+F;AAE/F,wFAAwF;AACxF,MAAa,cAAc;IAEH;IACA;IACA;IACA;IAJpB,YACoB,YAAqB,EACrB,eAAwB,EACxB,cAAuB,EACvB,aAAsB;QAHtB,iBAAY,GAAZ,YAAY,CAAS;QACrB,oBAAe,GAAf,eAAe,CAAS;QACxB,mBAAc,GAAd,cAAc,CAAS;QACvB,kBAAa,GAAb,aAAa,CAAS;IACvC,CAAC;CACP;AAPD,wCAOC;AAgBD,4DAA4D;AAC5D,MAAa,iBAAiB;IAEN;IACA;IAFpB,YACoB,UAAkB,EAClB,IAAY;QADZ,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAQ;IAC7B,CAAC;CACP;AALD,8CAKC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iGAAiG;AACjG,SAAgB,SAAS,CAAC,IAAY;IAClC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACxF,OAAO,CACH,MAAc,EACd,WAA4B,EAC5B,WAA8C,EAC1C,EAAE;QACN,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC;QACpC,MAAM,KAAK,GACP,OAAO,CAAC,WAAW,CAAC,0BAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,cAAc,CAAC,0BAAa,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC,CAAC;AACN,CAAC;AAED,8EAA8E;AAC9E,kGAAkG;AAClG,SAAgB,oBAAoB,CAChC,SAA4B,EAC5B,aAAsB;IAEtB,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,0BAAI;YACL,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QAChE,KAAK,sCAAgB;YACjB,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;QAChE,KAAK,2BAAK;YACN,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IACrE,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,2FAA2F;AAC3F,SAAgB,aAAa,CAAC,QAAkB;IAC5C,MAAM,KAAK,GACP,OAAO,CAAC,WAAW,CAAC,0BAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { METADATA_KEYS } from '../http/decorators';\nimport { EndpointOperation, READ, WRITE_IDEMPOTENT, WRITE } from '../http/HttpEndpointOptions';\n\n/** The immutable hints MCP clients use when deciding whether and how to call a tool. */\nexport class WpMcpToolHints {\n    constructor(\n        public readonly readOnlyHint: boolean,\n        public readonly destructiveHint: boolean,\n        public readonly idempotentHint: boolean,\n        public readonly openWorldHint: boolean,\n    ) {}\n}\n\ntype AsyncObjectMethod = (...args: never[]) => Promise<object>;\ntype ExactOneParameter<TMethod extends AsyncObjectMethod> = Parameters<TMethod>['length'] extends 1\n    ? object\n    : never;\ntype ExactOneMethodDescriptor<TMethod extends AsyncObjectMethod> =\n    TypedPropertyDescriptor<TMethod> & ExactOneParameter<TMethod>;\n\n/** Method decorator restricted to one request DTO and one async response DTO. */\nexport type WpMcpMethodDecorator = <TMethod extends AsyncObjectMethod>(\n    target: object,\n    propertyKey: string | symbol,\n    descriptor: ExactOneMethodDescriptor<TMethod>,\n) => void;\n\n/** Runtime metadata for one explicitly exposed endpoint. */\nexport class WpMcpToolMetadata {\n    constructor(\n        public readonly methodName: string,\n        public readonly name: string,\n    ) {}\n}\n\n/**\n * Explicitly publishes an existing `@Endpoint(POST, path, WRITE, RPC)` method as an MCP tool, under\n * the STABLE protocol name given here.\n *\n * The name is the whole argument, and deliberately the only one. It is independent of the method\n * name because renaming a method must not break a saved agent workflow, and nothing else about a\n * tool is unsayable in the source:\n *\n * | fact | where it comes from |\n * |---|---|\n * | `description` | the method's JSDoc body, or its `@mcp` tag — the same words the partner reads |\n * | `readOnlyHint` / `destructiveHint` / `idempotentHint` | `@Endpoint`'s `operation`, via {@link mcpHintsForOperation} |\n * | `openWorldHint` | `@Endpoint`'s `openWorld` option |\n * | `inputSchema` / `outputSchema` | the declared request and response types |\n *\n * ```typescript\n * @WpMcpTool('search_stores')\n * ```\n *\n * Until #984 it also took a `description`, duplicating the JSDoc. Two authored copies of one\n * paragraph drift the first time somebody edits one, and nothing catches it — the partner reads the\n * OpenAPI text and the agent reads the decorator text. With `description` gone the options object\n * held one field, so it is a plain string and `WpMcpToolOptions` is deleted with it.\n */\n// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope\nexport function WpMcpTool(name: string): WpMcpMethodDecorator {\n    if (name.trim() === '') throw new Error('@WpMcpTool requires a non-empty stable name.');\n    return <TMethod extends AsyncObjectMethod>(\n        target: object,\n        propertyKey: string | symbol,\n        _descriptor: ExactOneMethodDescriptor<TMethod>,\n    ): void => {\n        const apiClass = target.constructor;\n        const tools: Record<string, WpMcpToolMetadata> =\n            Reflect.getMetadata(METADATA_KEYS.MCP_TOOLS, apiClass) ?? {};\n        const methodName = String(propertyKey);\n        tools[methodName] = new WpMcpToolMetadata(methodName, name);\n        Reflect.defineMetadata(METADATA_KEYS.MCP_TOOLS, tools, apiClass);\n    };\n}\n\n/** The one mapping from endpoint side effects to MCP advisory annotations. */\n// webpieces-disable no-function-outside-class -- pure metadata mapping shared by MCP registration\nexport function mcpHintsForOperation(\n    operation: EndpointOperation,\n    openWorldHint: boolean,\n): WpMcpToolHints {\n    switch (operation) {\n        case READ:\n            return new WpMcpToolHints(true, false, true, openWorldHint);\n        case WRITE_IDEMPOTENT:\n            return new WpMcpToolHints(false, true, true, openWorldHint);\n        case WRITE:\n            return new WpMcpToolHints(false, true, false, openWorldHint);\n    }\n}\n\n/** Returns only methods explicitly opted in through {@link WpMcpTool}. */\n// webpieces-disable no-function-outside-class -- metadata reader paired with the decorator\nexport function getWpMcpTools(apiClass: Function): WpMcpToolMetadata[] {\n    const tools: Record<string, WpMcpToolMetadata> =\n        Reflect.getMetadata(METADATA_KEYS.MCP_TOOLS, apiClass) ?? {};\n    return Object.values(tools);\n}\n"]}

package/src/mcp/McpToolCatalog.d.ts

@@ -0,0 +1,83 @@
+import { ApiJsonSchema } from './DtoSchema';
+import { WpMcpToolHints } from './McpMetadata';
+/**
+ * ONE MCP tool, as `tools/list` publishes it.
+ *
+ * It is BUILT from the source by `@webpieces/api-doc-model`'s `McpSchemaRenderer` at build time, and
+ * READ here at boot — so the tool an agent is shown and the tool the server accepts are the same
+ * bytes by construction, not by two declarations agreeing.
+ *
+ * It lives in `core-util` rather than in the extractor package because both ends need it and only
+ * one end may depend on the TypeScript compiler API. `ApiJsonSchema` and {@link WpMcpToolHints},
+ * which it is made of, are already here for the same reason.
+ */
+export declare class McpToolDefinition {
+    /** The stable protocol name from `@WpMcpTool('...')`. */
+    readonly name: string;
+    /** The contract method it was rendered from, so a mismatch report can name the source. */
+    readonly methodName: string;
+    /**
+     * The tool documentation: the method's `@mcp` tag when it has one, its JSDoc body otherwise.
+     * Documentation has exactly ONE source — the doc comment above the declaration — for the
+     * partner reading OpenAPI and the agent reading `tools/list` alike.
+     */
+    readonly description: string;
+    /**
+     * All four hints. Three are COMPUTED from `@Endpoint`'s `operation` by
+     * `mcpHintsForOperation`, which is the one place that mapping lives; `openWorldHint` comes
+     * from `@Endpoint`'s `openWorld` option.
+     */
+    readonly hints: WpMcpToolHints;
+    readonly inputSchema: ApiJsonSchema;
+    readonly outputSchema: ApiJsonSchema;
+    constructor(
+    /** The stable protocol name from `@WpMcpTool('...')`. */
+    name: string, 
+    /** The contract method it was rendered from, so a mismatch report can name the source. */
+    methodName: string, 
+    /**
+     * The tool documentation: the method's `@mcp` tag when it has one, its JSDoc body otherwise.
+     * Documentation has exactly ONE source — the doc comment above the declaration — for the
+     * partner reading OpenAPI and the agent reading `tools/list` alike.
+     */
+    description: string, 
+    /**
+     * All four hints. Three are COMPUTED from `@Endpoint`'s `operation` by
+     * `mcpHintsForOperation`, which is the one place that mapping lives; `openWorldHint` comes
+     * from `@Endpoint`'s `openWorld` option.
+     */
+    hints: WpMcpToolHints, inputSchema: ApiJsonSchema, outputSchema: ApiJsonSchema);
+}
+/** Thrown when the catalog a server was handed is not a catalog this release can read. */
+export declare class McpToolCatalogError extends Error {
+    /** What to do instead, in one sentence. */
+    readonly cure: string;
+    constructor(message: string, 
+    /** What to do instead, in one sentence. */
+    cure: string);
+}
+/**
+ * Every MCP tool one build published, keyed by protocol name — the artifact `wp-openapi` writes as
+ * `mcp-tools.json` and `WpMcpServer` is constructed with.
+ *
+ * A tool the build never saw is a tool whose schema nobody checked, so `McpToolRegistry` fails fast
+ * at boot rather than publishing a shape derived from a second source.
+ */
+export declare class McpToolCatalog {
+    readonly tools: readonly McpToolDefinition[];
+    private readonly byName;
+    constructor(tools: readonly McpToolDefinition[]);
+    find(name: string): McpToolDefinition | undefined;
+    /** The names this catalog carries, sorted, so a failure can print what WAS published. */
+    names(): readonly string[];
+    /** The bytes `wp-openapi` writes. Sorted by name so the artifact is diffable. */
+    toJsonText(): string;
+    /**
+     * Reads `mcp-tools.json`. Every nested value is rebuilt as a real class instance, because this is
+     * the one place untyped bytes become the schemas a live protocol surface publishes.
+     *
+     * Malformed JSON is not caught here: it throws `SyntaxError` to the caller's own top-level
+     * handler, which is where every other read-the-world failure in webpieces is reported.
+     */
+    static fromJsonText(text: string): McpToolCatalog;
+}