@webpieces/core-util 0.4.762 → 0.4.765

package/src/ipc/IpcProtocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"IpcProtocol.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/ipc/IpcProtocol.ts"],"names":[],"mappings":"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","sourcesContent":["import { ApiErrorPayload, InternalError } from '../errors';\nimport { IpcIdentity } from './IpcIdentity';\n\nexport class IpcCallContext {\n    constructor(\n        readonly txId: string,\n        readonly callId: string,\n        readonly parentCallId?: string,\n    ) {\n        IpcIdentity.assert(txId, 'transaction');\n        IpcIdentity.assert(callId, 'call');\n        if (parentCallId !== undefined) IpcIdentity.assert(parentCallId, 'parent call');\n    }\n}\n\nexport class IpcRequest {\n    readonly version = 1;\n    readonly type = 'request';\n    constructor(\n        readonly apiId: string,\n        readonly methodId: string,\n        readonly context: IpcCallContext,\n        // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n        readonly body: unknown,\n    ) {}\n}\nexport class IpcSuccess {\n    readonly version = 1;\n    readonly type = 'success';\n    constructor(\n        readonly context: IpcCallContext,\n        // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n        readonly body: unknown,\n    ) {}\n}\nexport class IpcFailure {\n    readonly version = 1;\n    readonly type = 'failure';\n    constructor(\n        readonly context: IpcCallContext,\n        readonly error: ApiErrorPayload,\n    ) {}\n}\nexport type IpcReply = IpcSuccess | IpcFailure;\nexport type IpcMessage = IpcRequest | IpcReply;\n\nexport class IpcProtocol {\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary; webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n    static record(value: unknown): Record<string, unknown> {\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            throw new InternalError('Malformed IPC envelope');\n        }\n        // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n        return value as Record<string, unknown>;\n    }\n\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary\n    static parse(json: string): IpcMessage {\n        const value = IpcProtocol.record(JSON.parse(json));\n        if (value['version'] !== 1) throw new InternalError('Unsupported IPC protocol version');\n        const raw = IpcProtocol.record(value['context']);\n        const context = new IpcCallContext(\n            raw['txId'] as string,\n            raw['callId'] as string,\n            raw['parentCallId'] as string | undefined,\n        );\n        switch (value['type']) {\n            case 'request':\n                IpcIdentity.assert(value['apiId'], 'API');\n                IpcIdentity.assert(value['methodId'], 'method');\n                if (!Object.prototype.hasOwnProperty.call(value, 'body'))\n                    throw new InternalError('Missing IPC request body');\n                return new IpcRequest(value['apiId'], value['methodId'], context, value['body']);\n            case 'success':\n                if (!Object.prototype.hasOwnProperty.call(value, 'body'))\n                    throw new InternalError('Missing IPC success body');\n                return new IpcSuccess(context, value['body']);\n            case 'failure':\n                return new IpcFailure(\n                    context,\n                    // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n                    IpcProtocol.record(value['error']) as unknown as ApiErrorPayload,\n                );\n            default:\n                throw new InternalError('Invalid IPC message discriminator');\n        }\n    }\n\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary\n    static sameContext(a: IpcCallContext, b: IpcCallContext): boolean {\n        return a.callId === b.callId && a.txId === b.txId && a.parentCallId === b.parentCallId;\n    }\n}\n"]}
+{"version":3,"file":"IpcProtocol.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/ipc/IpcProtocol.ts"],"names":[],"mappings":"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","sourcesContent":["import { ApiErrorPayload, ApiImplementationError } from '../errors';\nimport { IpcIdentity } from './IpcIdentity';\n\nexport class IpcCallContext {\n    constructor(\n        readonly txId: string,\n        readonly callId: string,\n        readonly parentCallId?: string,\n    ) {\n        IpcIdentity.assert(txId, 'transaction');\n        IpcIdentity.assert(callId, 'call');\n        if (parentCallId !== undefined) IpcIdentity.assert(parentCallId, 'parent call');\n    }\n}\n\nexport class IpcRequest {\n    readonly version = 1;\n    readonly type = 'request';\n    constructor(\n        readonly apiId: string,\n        readonly methodId: string,\n        readonly context: IpcCallContext,\n        // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n        readonly body: unknown,\n    ) {}\n}\nexport class IpcSuccess {\n    readonly version = 1;\n    readonly type = 'success';\n    constructor(\n        readonly context: IpcCallContext,\n        // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n        readonly body: unknown,\n    ) {}\n}\nexport class IpcFailure {\n    readonly version = 1;\n    readonly type = 'failure';\n    constructor(\n        readonly context: IpcCallContext,\n        readonly error: ApiErrorPayload,\n    ) {}\n}\nexport type IpcReply = IpcSuccess | IpcFailure;\nexport type IpcMessage = IpcRequest | IpcReply;\n\nexport class IpcProtocol {\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary; webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n    static record(value: unknown): Record<string, unknown> {\n        if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n            throw new ApiImplementationError('Malformed IPC envelope');\n        }\n        // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n        return value as Record<string, unknown>;\n    }\n\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary\n    static parse(json: string): IpcMessage {\n        const value = IpcProtocol.record(JSON.parse(json));\n        if (value['version'] !== 1)\n            throw new ApiImplementationError('Unsupported IPC protocol version');\n        const raw = IpcProtocol.record(value['context']);\n        const context = new IpcCallContext(\n            raw['txId'] as string,\n            raw['callId'] as string,\n            raw['parentCallId'] as string | undefined,\n        );\n        switch (value['type']) {\n            case 'request':\n                IpcIdentity.assert(value['apiId'], 'API');\n                IpcIdentity.assert(value['methodId'], 'method');\n                if (!Object.prototype.hasOwnProperty.call(value, 'body'))\n                    throw new ApiImplementationError('Missing IPC request body');\n                return new IpcRequest(value['apiId'], value['methodId'], context, value['body']);\n            case 'success':\n                if (!Object.prototype.hasOwnProperty.call(value, 'body'))\n                    throw new ApiImplementationError('Missing IPC success body');\n                return new IpcSuccess(context, value['body']);\n            case 'failure':\n                return new IpcFailure(\n                    context,\n                    // webpieces-disable no-any-unknown -- untrusted IPC data is schema-validated; generic dispatch cannot assume a DTO type before validation\n                    IpcProtocol.record(value['error']) as unknown as ApiErrorPayload,\n                );\n            default:\n                throw new ApiImplementationError('Invalid IPC message discriminator');\n        }\n    }\n\n    // webpieces-disable no-function-outside-class -- portable stateless IPC primitive; no platform DI container exists on this boundary\n    static sameContext(a: IpcCallContext, b: IpcCallContext): boolean {\n        return a.callId === b.callId && a.txId === b.txId && a.parentCallId === b.parentCallId;\n    }\n}\n"]}

package/src/ipc/index.d.ts

@@ -12,5 +12,5 @@ export { MaskLog } from '../http/decorators';
 export { ApiMethodInfo } from '../http/ApiMethodInfo';
 export { LogApiCallImpl } from '../http/LogApiCall';
 export type { ApiCallContext } from '../http/ApiCallContext';
-export { TimeoutError } from '../http/TimeoutError';
+export { ApiCallTimeoutError } from '../http/ApiCallTimeoutError';
 export { toError } from '../lib/errorUtils';

package/src/ipc/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toError = exports.TimeoutError = exports.LogApiCallImpl = exports.ApiMethodInfo = exports.MaskLog = exports.MaskSpec = exports.IpcCallLogger = exports.IpcErrors = exports.IpcTransportError = exports.IpcConnectionOptions = exports.IpcConnection = exports.IpcProtocol = exports.IpcFailure = exports.IpcSuccess = exports.IpcRequest = exports.IpcCallContext = exports.IPC_METADATA_KEYS = exports.assertNotInternalApi = exports.assertInternalApi = exports.getIpcMaskSpec = exports.getIpcEndpointKind = exports.getIpcEndpoints = exports.getIpcApiId = exports.isInternalApi = exports.WpIpcEndpoint = exports.WpInternal = exports.IpcIdentity = void 0;
+exports.toError = exports.ApiCallTimeoutError = exports.LogApiCallImpl = exports.ApiMethodInfo = exports.MaskLog = exports.MaskSpec = exports.IpcCallLogger = exports.IpcErrors = exports.IpcTransportError = exports.IpcConnectionOptions = exports.IpcConnection = exports.IpcProtocol = exports.IpcFailure = exports.IpcSuccess = exports.IpcRequest = exports.IpcCallContext = exports.IPC_METADATA_KEYS = exports.assertNotInternalApi = exports.assertInternalApi = exports.getIpcMaskSpec = exports.getIpcEndpointKind = exports.getIpcEndpoints = exports.getIpcApiId = exports.isInternalApi = exports.WpIpcEndpoint = exports.WpInternal = exports.IpcIdentity = void 0;
 var IpcIdentity_1 = require("./IpcIdentity");
 Object.defineProperty(exports, "IpcIdentity", { enumerable: true, get: function () { return IpcIdentity_1.IpcIdentity; } });
 var IpcDecorators_1 = require("./IpcDecorators");
@@ -35,8 +35,8 @@ var ApiMethodInfo_1 = require("../http/ApiMethodInfo");
 Object.defineProperty(exports, "ApiMethodInfo", { enumerable: true, get: function () { return ApiMethodInfo_1.ApiMethodInfo; } });
 var LogApiCall_1 = require("../http/LogApiCall");
 Object.defineProperty(exports, "LogApiCallImpl", { enumerable: true, get: function () { return LogApiCall_1.LogApiCallImpl; } });
-var TimeoutError_1 = require("../http/TimeoutError");
-Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return TimeoutError_1.TimeoutError; } });
+var ApiCallTimeoutError_1 = require("../http/ApiCallTimeoutError");
+Object.defineProperty(exports, "ApiCallTimeoutError", { enumerable: true, get: function () { return ApiCallTimeoutError_1.ApiCallTimeoutError; } });
 var errorUtils_1 = require("../lib/errorUtils");
 Object.defineProperty(exports, "toError", { enumerable: true, get: function () { return errorUtils_1.toError; } });
 //# sourceMappingURL=index.js.map

package/src/ipc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/ipc/index.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAWyB;AAVrB,2GAAA,UAAU,OAAA;AACV,8GAAA,aAAa,OAAA;AACb,8GAAA,aAAa,OAAA;AACb,4GAAA,WAAW,OAAA;AACX,gHAAA,eAAe,OAAA;AACf,mHAAA,kBAAkB,OAAA;AAClB,+GAAA,cAAc,OAAA;AACd,kHAAA,iBAAiB,OAAA;AACjB,qHAAA,oBAAoB,OAAA;AACpB,kHAAA,iBAAiB,OAAA;AAGrB,6CAAgG;AAAvF,6GAAA,cAAc,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,0GAAA,WAAW,OAAA;AAExE,iDAAoG;AAA3F,8GAAA,aAAa,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AAAE,0GAAA,SAAS,OAAA;AAE1E,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AAEtB,qDAAgD;AAAvC,wGAAA,QAAQ,OAAA;AACjB,iDAA6C;AAApC,qGAAA,OAAO,OAAA;AAChB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,iDAAoD;AAA3C,4GAAA,cAAc,OAAA;AAEvB,qDAAoD;AAA3C,4GAAA,YAAY,OAAA;AAErB,gDAA4C;AAAnC,qGAAA,OAAO,OAAA","sourcesContent":["export { IpcIdentity } from './IpcIdentity';\nexport {\n    WpInternal,\n    WpIpcEndpoint,\n    isInternalApi,\n    getIpcApiId,\n    getIpcEndpoints,\n    getIpcEndpointKind,\n    getIpcMaskSpec,\n    assertInternalApi,\n    assertNotInternalApi,\n    IPC_METADATA_KEYS,\n} from './IpcDecorators';\nexport type { IpcApiType, IpcEndpointKind, IpcEndpointOptions } from './IpcDecorators';\nexport { IpcCallContext, IpcRequest, IpcSuccess, IpcFailure, IpcProtocol } from './IpcProtocol';\nexport type { IpcReply, IpcMessage } from './IpcProtocol';\nexport { IpcConnection, IpcConnectionOptions, IpcTransportError, IpcErrors } from './IpcConnection';\nexport type { IpcTransport, IpcScheduler, IpcErrorOwner } from './IpcConnection';\nexport { IpcCallLogger } from './IpcLogging';\nexport type { IpcLogging } from './IpcLogging';\nexport { MaskSpec } from '../http/LogFieldMask';\nexport { MaskLog } from '../http/decorators';\nexport { ApiMethodInfo } from '../http/ApiMethodInfo';\nexport { LogApiCallImpl } from '../http/LogApiCall';\nexport type { ApiCallContext } from '../http/ApiCallContext';\nexport { TimeoutError } from '../http/TimeoutError';\n\nexport { toError } from '../lib/errorUtils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/ipc/index.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAWyB;AAVrB,2GAAA,UAAU,OAAA;AACV,8GAAA,aAAa,OAAA;AACb,8GAAA,aAAa,OAAA;AACb,4GAAA,WAAW,OAAA;AACX,gHAAA,eAAe,OAAA;AACf,mHAAA,kBAAkB,OAAA;AAClB,+GAAA,cAAc,OAAA;AACd,kHAAA,iBAAiB,OAAA;AACjB,qHAAA,oBAAoB,OAAA;AACpB,kHAAA,iBAAiB,OAAA;AAGrB,6CAAgG;AAAvF,6GAAA,cAAc,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,0GAAA,WAAW,OAAA;AAExE,iDAAoG;AAA3F,8GAAA,aAAa,OAAA;AAAE,qHAAA,oBAAoB,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AAAE,0GAAA,SAAS,OAAA;AAE1E,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AAEtB,qDAAgD;AAAvC,wGAAA,QAAQ,OAAA;AACjB,iDAA6C;AAApC,qGAAA,OAAO,OAAA;AAChB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,iDAAoD;AAA3C,4GAAA,cAAc,OAAA;AAEvB,mEAAkE;AAAzD,0HAAA,mBAAmB,OAAA;AAE5B,gDAA4C;AAAnC,qGAAA,OAAO,OAAA","sourcesContent":["export { IpcIdentity } from './IpcIdentity';\nexport {\n    WpInternal,\n    WpIpcEndpoint,\n    isInternalApi,\n    getIpcApiId,\n    getIpcEndpoints,\n    getIpcEndpointKind,\n    getIpcMaskSpec,\n    assertInternalApi,\n    assertNotInternalApi,\n    IPC_METADATA_KEYS,\n} from './IpcDecorators';\nexport type { IpcApiType, IpcEndpointKind, IpcEndpointOptions } from './IpcDecorators';\nexport { IpcCallContext, IpcRequest, IpcSuccess, IpcFailure, IpcProtocol } from './IpcProtocol';\nexport type { IpcReply, IpcMessage } from './IpcProtocol';\nexport { IpcConnection, IpcConnectionOptions, IpcTransportError, IpcErrors } from './IpcConnection';\nexport type { IpcTransport, IpcScheduler, IpcErrorOwner } from './IpcConnection';\nexport { IpcCallLogger } from './IpcLogging';\nexport type { IpcLogging } from './IpcLogging';\nexport { MaskSpec } from '../http/LogFieldMask';\nexport { MaskLog } from '../http/decorators';\nexport { ApiMethodInfo } from '../http/ApiMethodInfo';\nexport { LogApiCallImpl } from '../http/LogApiCall';\nexport type { ApiCallContext } from '../http/ApiCallContext';\nexport { ApiCallTimeoutError } from '../http/ApiCallTimeoutError';\n\nexport { toError } from '../lib/errorUtils';\n"]}

package/src/mcp/DtoSchema.d.ts

@@ -0,0 +1,70 @@
+import 'reflect-metadata';
+export type DtoClass = abstract new (...args: any[]) => unknown;
+export type DtoArrayItem = 'string' | 'number' | 'integer' | 'boolean' | DtoClass;
+/** Runtime values accepted at the DTO validation boundary. */
+export type DtoValue = object | string | number | boolean | null;
+/** Additive field metadata; the scalar/object type itself comes from `design:type`. */
+export declare class WpDtoFieldOptions {
+    readonly description: string;
+    /** Required/optional is explicit because TypeScript erases `?` at runtime. */
+    readonly required: boolean;
+    /** Required for arrays because TypeScript erases their element type. */
+    readonly arrayItems?: DtoArrayItem | undefined;
+    /** A reflected Number is otherwise emitted as JSON Schema `number`. */
+    readonly integer: boolean;
+    readonly minimum?: number | undefined;
+    readonly maximum?: number | undefined;
+    readonly enumValues?: readonly [string, ...string[]] | undefined;
+    constructor(description: string, 
+    /** Required/optional is explicit because TypeScript erases `?` at runtime. */
+    required: boolean, 
+    /** Required for arrays because TypeScript erases their element type. */
+    arrayItems?: DtoArrayItem | undefined, 
+    /** A reflected Number is otherwise emitted as JSON Schema `number`. */
+    integer?: boolean, minimum?: number | undefined, maximum?: number | undefined, enumValues?: readonly [string, ...string[]] | undefined);
+}
+export declare class WpDtoFieldMetadata {
+    readonly propertyKey: string;
+    readonly options: WpDtoFieldOptions;
+    constructor(propertyKey: string, options: WpDtoFieldOptions);
+}
+/** The JSON Schema subset emitted for Webpieces API DTOs. */
+export declare class ApiJsonSchema {
+    type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array';
+    description?: string;
+    properties?: Record<string, ApiJsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+    items?: ApiJsonSchema;
+    enum?: string[];
+    minimum?: number;
+    maximum?: number;
+    constructor(type?: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array');
+}
+/** A validation result safe to show to an API caller/model. */
+export declare class DtoValidationFailure {
+    readonly message: string;
+    constructor(message: string);
+}
+/** Marks a request/response class as a schema-bearing DTO, including intentionally empty DTOs. */
+export declare function WpDto(): ClassDecorator;
+/** Adds documentation and runtime-only shape facts to a DTO property. */
+export declare function WpDtoField(options: WpDtoFieldOptions): PropertyDecorator;
+/** Declares an async API method's response DTO because reflection sees Promise, not its generic. */
+export declare function WpResponseDto(responseDto: () => DtoClass): MethodDecorator;
+/** Builds and validates the same DTO schema used for MCP input and structured output. */
+export declare class DtoSchemaBuilder {
+    requestClassOf(apiClass: Function, methodName: string): DtoClass;
+    responseClassOf(apiClass: Function, methodName: string): DtoClass;
+    build(dtoClass: DtoClass): ApiJsonSchema;
+    validate(dtoClass: DtoClass, value: DtoValue): DtoValidationFailure | undefined;
+    private buildAt;
+    private fieldSchema;
+    private validateOptions;
+    private itemSchema;
+    private validateAt;
+    private validateField;
+    private validateArray;
+    private fields;
+    private requireDto;
+}

package/src/mcp/DtoSchema.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DtoSchemaBuilder = exports.DtoValidationFailure = exports.ApiJsonSchema = exports.WpDtoFieldMetadata = exports.WpDtoFieldOptions = void 0;
+exports.WpDto = WpDto;
+exports.WpDtoField = WpDtoField;
+exports.WpResponseDto = WpResponseDto;
+require("reflect-metadata");
+const DTO_MARKER = 'webpieces:dto-schema';
+const DTO_FIELDS = 'webpieces:dto-fields';
+const RESPONSE_DTOS = 'webpieces:response-dtos';
+/** Additive field metadata; the scalar/object type itself comes from `design:type`. */
+class WpDtoFieldOptions {
+    description;
+    required;
+    arrayItems;
+    integer;
+    minimum;
+    maximum;
+    enumValues;
+    constructor(description, 
+    /** Required/optional is explicit because TypeScript erases `?` at runtime. */
+    required, 
+    /** Required for arrays because TypeScript erases their element type. */
+    arrayItems, 
+    /** A reflected Number is otherwise emitted as JSON Schema `number`. */
+    integer = false, minimum, maximum, enumValues) {
+        this.description = description;
+        this.required = required;
+        this.arrayItems = arrayItems;
+        this.integer = integer;
+        this.minimum = minimum;
+        this.maximum = maximum;
+        this.enumValues = enumValues;
+    }
+}
+exports.WpDtoFieldOptions = WpDtoFieldOptions;
+class WpDtoFieldMetadata {
+    propertyKey;
+    options;
+    constructor(propertyKey, options) {
+        this.propertyKey = propertyKey;
+        this.options = options;
+    }
+}
+exports.WpDtoFieldMetadata = WpDtoFieldMetadata;
+/** The JSON Schema subset emitted for Webpieces API DTOs. */
+class ApiJsonSchema {
+    type;
+    description;
+    properties;
+    required;
+    additionalProperties;
+    items;
+    enum;
+    minimum;
+    maximum;
+    constructor(type) {
+        this.type = type;
+    }
+}
+exports.ApiJsonSchema = ApiJsonSchema;
+/** A validation result safe to show to an API caller/model. */
+class DtoValidationFailure {
+    message;
+    constructor(message) {
+        this.message = message;
+    }
+}
+exports.DtoValidationFailure = DtoValidationFailure;
+/** Marks a request/response class as a schema-bearing DTO, including intentionally empty DTOs. */
+// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope
+function WpDto() {
+    return (target) => Reflect.defineMetadata(DTO_MARKER, true, target);
+}
+/** Adds documentation and runtime-only shape facts to a DTO property. */
+// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope
+function WpDtoField(options) {
+    if (options.description.trim() === '') {
+        throw new Error('@WpDtoField requires non-empty field documentation.');
+    }
+    return (target, propertyKey) => {
+        const dtoClass = target.constructor;
+        const fields = Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};
+        const name = String(propertyKey);
+        fields[name] = new WpDtoFieldMetadata(name, options);
+        Reflect.defineMetadata(DTO_FIELDS, fields, dtoClass);
+    };
+}
+/** Declares an async API method's response DTO because reflection sees Promise, not its generic. */
+// webpieces-disable no-function-outside-class -- decorator factories are inherently module-scope
+function WpResponseDto(responseDto) {
+    return (target, propertyKey) => {
+        const apiClass = target.constructor;
+        const responses = Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};
+        responses[String(propertyKey)] = responseDto;
+        Reflect.defineMetadata(RESPONSE_DTOS, responses, apiClass);
+    };
+}
+/** Builds and validates the same DTO schema used for MCP input and structured output. */
+class DtoSchemaBuilder {
+    requestClassOf(apiClass, methodName) {
+        // webpieces-disable no-any-unknown -- reflect-metadata returns erased runtime constructor tokens
+        const params = Reflect.getMetadata('design:paramtypes', apiClass.prototype, methodName);
+        if (!params || params.length !== 1) {
+            throw new Error(`${apiClass.name}.${methodName} must take exactly one @WpDto request class to be an MCP tool.`);
+        }
+        return params[0];
+    }
+    responseClassOf(apiClass, methodName) {
+        const responses = Reflect.getMetadata(RESPONSE_DTOS, apiClass) ?? {};
+        const response = responses[methodName];
+        if (!response) {
+            throw new Error(`${apiClass.name}.${methodName} must declare @WpResponseDto(() => ResponseClass) before MCP exposure.`);
+        }
+        return response();
+    }
+    build(dtoClass) {
+        return this.buildAt(dtoClass, new Set());
+    }
+    validate(dtoClass, value) {
+        return this.validateAt(dtoClass, value, '$');
+    }
+    buildAt(dtoClass, parents) {
+        this.requireDto(dtoClass);
+        if (parents.has(dtoClass)) {
+            throw new Error(`Recursive DTO ${dtoClass.name} cannot use an inline MCP schema.`);
+        }
+        const nextParents = new Set(parents);
+        nextParents.add(dtoClass);
+        const schema = new ApiJsonSchema('object');
+        schema.properties = {};
+        schema.additionalProperties = false;
+        const required = [];
+        for (const field of this.fields(dtoClass)) {
+            schema.properties[field.propertyKey] = this.fieldSchema(dtoClass, field, nextParents);
+            if (field.options.required)
+                required.push(field.propertyKey);
+        }
+        if (required.length > 0)
+            schema.required = required;
+        return schema;
+    }
+    fieldSchema(dtoClass, field, parents) {
+        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token
+        const reflected = Reflect.getMetadata('design:type', dtoClass.prototype, field.propertyKey);
+        if (!reflected)
+            throw new Error(`No reflected type for ${dtoClass.name}.${field.propertyKey}.`);
+        const options = field.options;
+        this.validateOptions(dtoClass, field, reflected);
+        let schema;
+        switch (reflected.name) {
+            case 'String':
+                schema = new ApiJsonSchema('string');
+                break;
+            case 'Number':
+                schema = new ApiJsonSchema(options.integer ? 'integer' : 'number');
+                break;
+            case 'Boolean':
+                schema = new ApiJsonSchema('boolean');
+                break;
+            case 'Array':
+                if (!options.arrayItems) {
+                    throw new Error(`${dtoClass.name}.${field.propertyKey} must declare arrayItems.`);
+                }
+                schema = new ApiJsonSchema('array');
+                schema.items = this.itemSchema(options.arrayItems, parents);
+                break;
+            default:
+                schema = this.buildAt(reflected, parents);
+        }
+        schema.description = options.description;
+        if (options.minimum !== undefined)
+            schema.minimum = options.minimum;
+        if (options.maximum !== undefined)
+            schema.maximum = options.maximum;
+        if (options.enumValues)
+            schema.enum = [...options.enumValues];
+        return schema;
+    }
+    validateOptions(dtoClass, field, reflected) {
+        const label = `${dtoClass.name}.${field.propertyKey}`;
+        const options = field.options;
+        if (reflected.name !== 'Array' && options.arrayItems) {
+            throw new Error(`${label} declares arrayItems but is not an array.`);
+        }
+        if (reflected.name !== 'Number' &&
+            (options.integer || options.minimum !== undefined || options.maximum !== undefined)) {
+            throw new Error(`${label} declares numeric constraints but is not a number.`);
+        }
+        if (options.minimum !== undefined && options.maximum !== undefined && options.minimum > options.maximum) {
+            throw new Error(`${label} minimum cannot exceed maximum.`);
+        }
+        if (options.enumValues && reflected.name !== 'String') {
+            throw new Error(`${label} enumValues require a string field.`);
+        }
+    }
+    itemSchema(item, parents) {
+        if (typeof item !== 'string')
+            return this.buildAt(item, parents);
+        return new ApiJsonSchema(item === 'integer' ? 'integer' : item);
+    }
+    validateAt(dtoClass, value, path) {
+        this.requireDto(dtoClass);
+        if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+            return new DtoValidationFailure(`${path} must be an object`);
+        }
+        const fields = this.fields(dtoClass);
+        const known = new Set(fields.map((field) => field.propertyKey));
+        for (const key of Object.keys(value)) {
+            if (!known.has(key))
+                return new DtoValidationFailure(`${path}.${key} is not allowed`);
+        }
+        for (const field of fields) {
+            const fieldValue = Object.getOwnPropertyDescriptor(value, field.propertyKey)?.value;
+            if (fieldValue === undefined) {
+                if (field.options.required) {
+                    return new DtoValidationFailure(`${path}.${field.propertyKey} is required`);
+                }
+                continue;
+            }
+            const failure = this.validateField(dtoClass, field, fieldValue, `${path}.${field.propertyKey}`);
+            if (failure)
+                return failure;
+        }
+        return undefined;
+    }
+    validateField(dtoClass, field, value, path) {
+        // webpieces-disable no-any-unknown -- reflect-metadata returns an erased constructor token
+        const reflected = Reflect.getMetadata('design:type', dtoClass.prototype, field.propertyKey);
+        const expected = reflected?.name;
+        if (expected === 'Array')
+            return this.validateArray(field.options, value, path);
+        if (expected === 'String') {
+            if (typeof value !== 'string')
+                return new DtoValidationFailure(`${path} must be a string`);
+            if (field.options.enumValues && !field.options.enumValues.includes(value)) {
+                return new DtoValidationFailure(`${path} must be one of: ${field.options.enumValues.join(', ')}`);
+            }
+            return undefined;
+        }
+        if (expected === 'Number') {
+            if (typeof value !== 'number' || !Number.isFinite(value)) {
+                return new DtoValidationFailure(`${path} must be a number`);
+            }
+            if (field.options.integer && !Number.isInteger(value)) {
+                return new DtoValidationFailure(`${path} must be an integer`);
+            }
+            if (field.options.minimum !== undefined && value < field.options.minimum) {
+                return new DtoValidationFailure(`${path} must be >= ${field.options.minimum}`);
+            }
+            if (field.options.maximum !== undefined && value > field.options.maximum) {
+                return new DtoValidationFailure(`${path} must be <= ${field.options.maximum}`);
+            }
+            return undefined;
+        }
+        if (expected === 'Boolean') {
+            return typeof value === 'boolean'
+                ? undefined
+                : new DtoValidationFailure(`${path} must be a boolean`);
+        }
+        return this.validateAt(reflected, value, path);
+    }
+    validateArray(options, value, path) {
+        if (!Array.isArray(value))
+            return new DtoValidationFailure(`${path} must be an array`);
+        if (!options.arrayItems)
+            return new DtoValidationFailure(`${path} has no item type`);
+        for (let index = 0; index < value.length; index += 1) {
+            const item = value[index];
+            if (typeof options.arrayItems !== 'string') {
+                const nested = this.validateAt(options.arrayItems, item, `${path}[${index}]`);
+                if (nested)
+                    return nested;
+                continue;
+            }
+            const wanted = options.arrayItems === 'integer' ? 'number' : options.arrayItems;
+            if (typeof item !== wanted || (options.arrayItems === 'integer' && !Number.isInteger(item))) {
+                return new DtoValidationFailure(`${path}[${index}] must be ${options.arrayItems}`);
+            }
+        }
+        return undefined;
+    }
+    fields(dtoClass) {
+        const fields = Reflect.getMetadata(DTO_FIELDS, dtoClass) ?? {};
+        return Object.values(fields);
+    }
+    requireDto(dtoClass) {
+        if (!Reflect.getMetadata(DTO_MARKER, dtoClass)) {
+            throw new Error(`${dtoClass.name} must be decorated with @WpDto() for schema generation.`);
+        }
+    }
+}
+exports.DtoSchemaBuilder = DtoSchemaBuilder;
+//# sourceMappingURL=DtoSchema.js.map

package/src/mcp/DtoSchema.js.map

@@ -0,0 +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;\nexport type DtoArrayItem = '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?: DtoArrayItem,\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    ) {}\n}\n\nexport class WpDtoFieldMetadata {\n    constructor(\n        public readonly propertyKey: string,\n        public readonly options: WpDtoFieldOptions,\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    additionalProperties?: boolean;\n    items?: ApiJsonSchema;\n    enum?: string[];\n    minimum?: number;\n    maximum?: number;\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(public readonly message: string) {}\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): 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    build(dtoClass: DtoClass): ApiJsonSchema {\n        return this.buildAt(dtoClass, new Set<DtoClass>());\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) throw new Error(`No reflected type for ${dtoClass.name}.${field.propertyKey}.`);\n        const options = field.options;\n        this.validateOptions(dtoClass, field, reflected);\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(`${dtoClass.name}.${field.propertyKey} must declare arrayItems.`);\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        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 (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 (options.minimum !== undefined && options.maximum !== undefined && options.minimum > options.maximum) {\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    }\n\n    private itemSchema(item: DtoArrayItem, 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 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} 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)) return new DtoValidationFailure(`${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(`${path}.${field.propertyKey} is required`);\n                }\n                continue;\n            }\n            const failure = this.validateField(dtoClass, field, fieldValue, `${path}.${field.propertyKey}`);\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 expected = reflected?.name;\n        if (expected === 'Array') return this.validateArray(field.options, value, path);\n        if (expected === 'String') {\n            if (typeof value !== 'string') return new DtoValidationFailure(`${path} must be a string`);\n            if (field.options.enumValues && !field.options.enumValues.includes(value)) {\n                return new DtoValidationFailure(`${path} must be one of: ${field.options.enumValues.join(', ')}`);\n            }\n            return undefined;\n        }\n        if (expected === 'Number') {\n            if (typeof value !== 'number' || !Number.isFinite(value)) {\n                return new DtoValidationFailure(`${path} must be a number`);\n            }\n            if (field.options.integer && !Number.isInteger(value)) {\n                return new DtoValidationFailure(`${path} must be an integer`);\n            }\n            if (field.options.minimum !== undefined && value < field.options.minimum) {\n                return new DtoValidationFailure(`${path} must be >= ${field.options.minimum}`);\n            }\n            if (field.options.maximum !== undefined && value > field.options.maximum) {\n                return new DtoValidationFailure(`${path} must be <= ${field.options.maximum}`);\n            }\n            return undefined;\n        }\n        if (expected === 'Boolean') {\n            return typeof value === 'boolean'\n                ? undefined\n                : new DtoValidationFailure(`${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)) return new DtoValidationFailure(`${path} must be an array`);\n        if (!options.arrayItems) return new DtoValidationFailure(`${path} has no item type`);\n        for (let index = 0; index < value.length; index += 1) {\n            const item = value[index];\n            if (typeof options.arrayItems !== 'string') {\n                const nested = this.validateAt(options.arrayItems, item, `${path}[${index}]`);\n                if (nested) return nested;\n                continue;\n            }\n            const wanted = options.arrayItems === 'integer' ? 'number' : options.arrayItems;\n            if (typeof item !== wanted || (options.arrayItems === 'integer' && !Number.isInteger(item))) {\n                return new DtoValidationFailure(`${path}[${index}] must be ${options.arrayItems}`);\n            }\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(`${dtoClass.name} must be decorated with @WpDto() for schema generation.`);\n        }\n    }\n}\n"]}

package/src/mcp/McpCompileAssertions.d.ts

@@ -0,0 +1 @@
+export {};

package/src/mcp/McpCompileAssertions.js

@@ -0,0 +1,65 @@
+"use strict";
+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
+[]);
+class InvalidMcpContract {
+    // @ts-expect-error read-only tools cannot also claim to be destructive
+    invalid() {
+        throw new Error('contract only');
+    }
+}
+tslib_1.__decorate([
+    (0, McpMetadata_1.WpMcpTool)({
+        name: 'invalid',
+        description: 'This declaration must never compile.',
+        readOnlyHint: true,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    }),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], InvalidMcpContract.prototype, "invalid", null);
+class InvalidMcpArities {
+    // @ts-expect-error MCP tools require exactly one request DTO
+    zero() {
+        throw new Error('contract only');
+    }
+    // @ts-expect-error MCP tools require exactly one request DTO
+    multi(_first, _second) {
+        throw new Error('contract only');
+    }
+}
+tslib_1.__decorate([
+    (0, McpMetadata_1.WpMcpTool)({
+        name: 'zero-arity',
+        description: 'This declaration must never compile.',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    }),
+    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.',
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    }),
+    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;
+//# sourceMappingURL=McpCompileAssertions.js.map

package/src/mcp/McpCompileAssertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpCompileAssertions.js","sourceRoot":"","sources":["../../../../../../packages/core/core-util/src/mcp/McpCompileAssertions.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAC1C,2CAAgD;AAEhD,MAAM,gBAAgB,GAAG,IAAI,6BAAiB,CAC1C,cAAc,EACd,IAAI,EACJ,SAAS,EACT,KAAK,EACL,SAAS,EACT,SAAS;AACT,uEAAuE;AACvE,EAAE,CACL,CAAC;AAEF,MAAe,kBAAkB;IAC7B,uEAAuE;IASvE,OAAO;QACH,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAHG;IARC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;iDAGD;AAGL,MAAe,iBAAiB;IAC5B,6DAA6D;IAQ7D,IAAI;QACA,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,6DAA6D;IAQ7D,KAAK,CAAC,MAAc,EAAE,OAAe;QACjC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;CACJ;AAfG;IAPC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;6CAGD;AAUD;IAPC,IAAA,uBAAS,EAAC;QACP,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB,CAAC;;;;8CAGD;AAGL,KAAK,kBAAkB,CAAC;AACxB,KAAK,iBAAiB,CAAC;AACvB,KAAK,gBAAgB,CAAC","sourcesContent":["import { WpMcpTool } from './McpMetadata';\nimport { WpDtoFieldOptions } 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\nabstract class InvalidMcpContract {\n    // @ts-expect-error read-only tools cannot also claim to be destructive\n    @WpMcpTool({\n        name: 'invalid',\n        description: 'This declaration must never compile.',\n        readOnlyHint: true,\n        destructiveHint: true,\n        idempotentHint: true,\n        openWorldHint: false,\n    })\n    invalid(): Promise<void> {\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        readOnlyHint: true,\n        idempotentHint: true,\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        readOnlyHint: true,\n        idempotentHint: true,\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;\n"]}

package/src/mcp/McpMetadata.d.ts

@@ -0,0 +1,51 @@
+import 'reflect-metadata';
+/** The immutable hints MCP clients use when deciding whether and how to call a tool. */
+export declare class WpMcpToolHints {
+    readonly readOnlyHint: boolean;
+    readonly destructiveHint: boolean;
+    readonly idempotentHint: boolean;
+    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;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};
+type ReadOnlyToolOptions = CommonToolOptions & {
+    readOnlyHint: true;
+    destructiveHint?: never;
+};
+type MutatingToolOptions = CommonToolOptions & {
+    readOnlyHint: false;
+    destructiveHint: boolean;
+};
+/** Compiler-enforced exposure: a read-only tool cannot also claim to be destructive. */
+export type WpMcpToolOptions = ReadOnlyToolOptions | MutatingToolOptions;
+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>;
+/** Method decorator restricted to one request DTO and one async response DTO. */
+export type WpMcpMethodDecorator = <TMethod extends AsyncObjectMethod>(target: object, propertyKey: string | symbol, descriptor: ExactOneMethodDescriptor<TMethod>) => void;
+/** Runtime metadata for one explicitly exposed endpoint. */
+export declare class WpMcpToolMetadata {
+    readonly methodName: string;
+    readonly name: string;
+    readonly description: string;
+    readonly hints: WpMcpToolHints;
+    constructor(methodName: string, name: string, description: string, hints: WpMcpToolHints);
+}
+/**
+ * Explicitly publishes an existing `@Endpoint(..., 'rpc')` method as an MCP tool.
+ *
+ * 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.
+ */
+export declare function WpMcpTool(options: WpMcpToolOptions): WpMcpMethodDecorator;
+/** Returns only methods explicitly opted in through {@link WpMcpTool}. */
+export declare function getWpMcpTools(apiClass: Function): WpMcpToolMetadata[];
+export {};