fix: update import paths and refine type definitions for Zod integration

Author: Romakita

packages/platform/platform-mcp/package.json

@@ -23,10 +23,10 @@
     "test:ci": "vitest run --coverage.thresholds.autoUpdate=true"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@modelcontextprotocol/sdk": ">=1.26.0",
     "tslib": "2.7.0",
     "uuid": "^11.0.2",
-    "zod": "3.25.76"
+    "zod": ">=4.3.6"
   },
   "devDependencies": {
     "@tsed/barrels": "workspace:*",

packages/platform/platform-mcp/src/decorators/prompt.spec.ts

@@ -1,7 +1,7 @@
 import {DITest, inject, Injectable} from "@tsed/di";
 import {Description, Title} from "@tsed/schema";
 
-import {Prompt} from "../..";
+import {Prompt} from "./prompt.js";
 
 @Injectable()
 export class TestPrompt {
@@ -22,7 +22,7 @@ describe("Prompt", () => {
       propertyKey: "prompt",
       token: TestPrompt,
       name: "prompt",
-      title: "title",
+      title: "Title",
       description: "Description",
       handler: expect.any(Function)
     });

packages/platform/platform-mcp/src/decorators/resource.spec.ts

@@ -1,7 +1,7 @@
 import {DITest, inject, Injectable} from "@tsed/di";
 import {ContentType, Description, Title} from "@tsed/schema";
 
-import {Resource} from "../..";
+import {Resource} from "./resource.js";
 
 @Injectable()
 export class TestResource {

packages/platform/platform-mcp/src/decorators/tool.spec.ts

@@ -1,7 +1,7 @@
 import {DITest, inject, Injectable} from "@tsed/di";
 import {CollectionOf, Description, Property, Returns} from "@tsed/schema";
 
-import {Tool} from "../..";
+import {Tool} from "./tool.js";
 
 class Model {
   @Property()

packages/platform/platform-mcp/src/fn/defineTool.ts

@@ -74,6 +74,7 @@ export function defineTool<Input, Output = undefined>(options: ToolProps<Input,
 
       return {
         ...opts,
+        name: opts.name,
         inputSchema: toZod(isArrowFn(opts.inputSchema) ? opts.inputSchema() : opts.inputSchema),
         outputSchema: toZod(opts.outputSchema),
         async handler(args: Input, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) {

packages/platform/platform-mcp/src/services/PlatformMcpModule.spec.ts

@@ -13,7 +13,7 @@ export class PlatformMcpModule implements OnRoutesInit {
   protected server = inject<McpServer>(MCP_SERVER);
 
   $onRoutesInit() {
-    if (this.settings?.enabled) {
+    if (this.isEnabled()) {
       const path = this.settings?.path || "/mcp";
 
       this.app.post(
@@ -52,6 +52,10 @@ export class PlatformMcpModule implements OnRoutesInit {
       await transport.close();
     }
   }
+
+  private isEnabled() {
+    return this.settings?.enabled !== false;
+  }
 }
 
 injectable(PlatformMcpModule);

packages/platform/platform-mcp/src/services/PlatformMcpModule.ts

@@ -0,0 +1,75 @@
+export type Serializable = {[key: string]: Serializable} | Serializable[] | string | number | boolean | null;
+
+export type JsonSchema = JsonSchemaObject | boolean;
+export type JsonSchemaObject = {
+  // left permissive by design
+  type?: string | string[];
+
+  // object
+  properties?: {[key: string]: JsonSchema};
+  additionalProperties?: JsonSchema;
+  unevaluatedProperties?: JsonSchema;
+  patternProperties?: {[key: string]: JsonSchema};
+  minProperties?: number;
+  maxProperties?: number;
+  required?: string[] | boolean;
+  propertyNames?: JsonSchema;
+
+  // array
+  items?: JsonSchema | JsonSchema[];
+  additionalItems?: JsonSchema;
+  minItems?: number;
+  maxItems?: number;
+  uniqueItems?: boolean;
+
+  // string
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string;
+  format?: string;
+
+  // number
+  minimum?: number;
+  maximum?: number;
+  exclusiveMinimum?: number | boolean;
+  exclusiveMaximum?: number | boolean;
+  multipleOf?: number;
+
+  // unions
+  anyOf?: JsonSchema[];
+  allOf?: JsonSchema[];
+  oneOf?: JsonSchema[];
+
+  if?: JsonSchema;
+  then?: JsonSchema;
+  else?: JsonSchema;
+
+  // shared
+  const?: Serializable;
+  enum?: Serializable[];
+
+  errorMessage?: {[key: string]: string | undefined};
+} & {[key: string]: any};
+
+export type ParserSelector = (schema: JsonSchemaObject, refs: Refs) => string;
+export type ParserOverride = (schema: JsonSchemaObject, refs: Refs) => string | void;
+
+export type ZodVersion = 3 | 4;
+
+export type Options = {
+  name?: string;
+  module?: "cjs" | "esm" | "none";
+  withoutDefaults?: boolean;
+  withoutDescribes?: boolean;
+  withJsdocs?: boolean;
+  parserOverride?: ParserOverride;
+  depth?: number;
+  type?: boolean | string;
+  noImport?: boolean;
+  zodVersion?: ZodVersion;
+};
+
+export type Refs = Options & {
+  path: (string | number)[];
+  seen: Map<object | boolean, {n: number; r: string | undefined}>;
+};

packages/platform/platform-mcp/src/utils/json-schema-to-zod/Types.ts

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import {mkdirSync, writeFileSync} from "fs";
+import {dirname} from "path";
+
+import {jsonSchemaToZod} from "./jsonSchemaToZod.js";
+import {JsonSchema, ZodVersion} from "./Types.js";
+import {parseArgs, parseOrReadJSON, readPipe} from "./utils/cliTools.js";
+
+const params = {
+  input: {
+    shorthand: "i",
+    value: "string",
+    required: process.stdin.isTTY && "input is required when no JSON or file path is piped",
+    description: "JSON or a source file path. Required if no data is piped."
+  },
+  output: {
+    shorthand: "o",
+    value: "string",
+    description: "A file path to write to. If not supplied stdout will be used."
+  },
+  name: {
+    shorthand: "n",
+    value: "string",
+    description: "The name of the schema in the output."
+  },
+  depth: {
+    shorthand: "d",
+    value: "number",
+    description: "Maximum depth of recursion before falling back to z.any(). Defaults to 0."
+  },
+  module: {
+    shorthand: "m",
+    value: ["esm", "cjs", "none"],
+    description: "Module syntax; 'esm', 'cjs' or 'none'. Defaults to 'esm'."
+  },
+  type: {
+    shorthand: "t",
+    value: "string",
+    description: "The name of the (optional) inferred type export."
+  },
+  noImport: {
+    shorthand: "ni",
+    description: "Removes the `import { z } from 'zod';` or equivalent from the output."
+  },
+  withJsdocs: {
+    shorthand: "wj",
+    description: "Generate jsdocs off of the description property."
+  },
+  zodVersion: {
+    shorthand: "zv",
+    value: "number",
+    description: "Target Zod version: 3 or 4. Defaults to 4."
+  }
+} as const;
+
+async function main() {
+  const args = parseArgs(params, process.argv, true);
+  const input = args.input || (await readPipe());
+  const jsonSchema = parseOrReadJSON(input);
+  const zodVersion = (args.zodVersion === 3 ? 3 : 4) as ZodVersion;
+  const zodSchema = jsonSchemaToZod(jsonSchema as JsonSchema, {
+    name: args.name,
+    depth: args.depth,
+    module: args.module || "esm",
+    noImport: args.noImport,
+    type: args.type,
+    withJsdocs: args.withJsdocs,
+    zodVersion
+  });
+
+  if (args.output) {
+    mkdirSync(dirname(args.output), {recursive: true});
+    writeFileSync(args.output, zodSchema);
+  } else {
+    console.log(zodSchema);
+  }
+}
+
+void main();

packages/platform/platform-mcp/src/utils/json-schema-to-zod/cli.ts

@@ -0,0 +1,26 @@
+export * from "./jsonSchemaToZod.js";
+export * from "./parsers/parseAllOf.js";
+export * from "./parsers/parseAnyOf.js";
+export * from "./parsers/parseArray.js";
+export * from "./parsers/parseBoolean.js";
+export * from "./parsers/parseConst.js";
+export * from "./parsers/parseDefault.js";
+export * from "./parsers/parseEnum.js";
+export * from "./parsers/parseIfThenElse.js";
+export * from "./parsers/parseMultipleType.js";
+export * from "./parsers/parseNot.js";
+export * from "./parsers/parseNull.js";
+export * from "./parsers/parseNullable.js";
+export * from "./parsers/parseNumber.js";
+export * from "./parsers/parseObject.js";
+export * from "./parsers/parseOneOf.js";
+export * from "./parsers/parseSchema.js";
+export * from "./parsers/parseString.js";
+export * from "./Types.js";
+export * from "./utils/half.js";
+export * from "./utils/jsdocs.js";
+export * from "./utils/omit.js";
+export * from "./utils/withMessage.js";
+import {jsonSchemaToZod} from "./jsonSchemaToZod.js";
+
+export default jsonSchemaToZod;