strapi-plugin-ai-sdk 0.9.0 → 0.10.0

package/README.md

@@ -312,6 +312,8 @@ The plugin exposes an [MCP](https://modelcontextprotocol.io/) server at `/api/ai
 - Tool names are converted from camelCase to snake_case (`listContentTypes` -> `list_content_types`)
 - Each tool includes a `title` (e.g. "Strapi: Search Content") and `annotations` (`readOnlyHint`, `destructiveHint`) for better client integration
 - All tool schemas include `additionalProperties: false` to ensure compatibility with `mcp-remote` and Claude Desktop
+- Custom Zod-to-JSON Schema converter that supports both Zod 3 and Zod 4, producing complete type information (types, descriptions, defaults, enums, constraints) for every parameter
+- MCP arguments are coerced through the Zod schema before execution — stringified JSON values (e.g. `fields: '["title"]'`) are automatically parsed to their expected types, and defaults are applied for omitted optional parameters
 - The server returns dynamic `instructions` during initialization so clients know when to load tools — plugins that provide `getMeta()` get keyword-driven entries (e.g. `/youtube`, `/octalens`), others get auto-generated summaries
 - Sessions expire after the configured timeout (default: 4 hours)
 - Maximum concurrent sessions can be configured (default: 100)

package/dist/server/index.js

@@ -167,6 +167,14 @@ function buildInstructions(registry) {
   );
   return lines.join("\n");
 }
+function getZodType(field) {
+  const def = field?._def;
+  if (!def) return void 0;
+  return def.typeName ?? def.type;
+}
+function getDescription(field) {
+  return field?.description ?? field?._def?.description;
+}
 function zodToInputSchema(schema2) {
   const shape = schema2.shape;
   const properties = {};
@@ -190,26 +198,35 @@ function zodToInputSchema(schema2) {
 }
 function isOptionalOrDefaulted(field) {
   if (!field) return true;
-  const def = field._def;
-  if (!def) return false;
-  const typeName = def.typeName;
-  if (typeName === "ZodOptional" || typeName === "ZodDefault") return true;
-  if (def.innerType) return isOptionalOrDefaulted(def.innerType);
+  const t = getZodType(field);
+  if (!t) return false;
+  const normalized = normalizeType(t);
+  if (normalized === "optional" || normalized === "default") return true;
+  if (field._def?.innerType) return isOptionalOrDefaulted(field._def.innerType);
   return false;
 }
+function normalizeType(t) {
+  if (t.startsWith("Zod")) return t.slice(3).toLowerCase();
+  return t.toLowerCase();
+}
 function zodFieldToJsonSchema(field) {
-  if (!field?._def) return {};
+  const rawType = getZodType(field);
+  if (!rawType) return {};
+  const t = normalizeType(rawType);
   const def = field._def;
-  const typeName = def.typeName;
   const prop = {};
-  if (def.description) prop.description = def.description;
-  switch (typeName) {
-    case "ZodString":
+  const desc = getDescription(field);
+  if (desc) prop.description = desc;
+  switch (t) {
+    case "string":
       prop.type = "string";
       break;
-    case "ZodNumber":
+    case "number": {
       prop.type = "number";
-      if (def.checks) {
+      if (field.isInt) prop.type = "integer";
+      if (typeof field.minValue === "number" && field.minValue > -Number.MAX_SAFE_INTEGER) prop.minimum = field.minValue;
+      if (typeof field.maxValue === "number" && field.maxValue < Number.MAX_SAFE_INTEGER) prop.maximum = field.maxValue;
+      if (def.checks && Array.isArray(def.checks)) {
         for (const check of def.checks) {
           if (check.kind === "min") prop.minimum = check.value;
           if (check.kind === "max") prop.maximum = check.value;
@@ -217,20 +234,31 @@ function zodFieldToJsonSchema(field) {
         }
       }
       break;
-    case "ZodBoolean":
+    }
+    case "boolean":
       prop.type = "boolean";
       break;
-    case "ZodEnum":
+    case "enum": {
       prop.type = "string";
-      prop.enum = def.values;
+      if (Array.isArray(def.values)) {
+        prop.enum = def.values;
+      } else if (def.entries) {
+        prop.enum = Object.keys(def.entries);
+      } else if (Array.isArray(field.options)) {
+        prop.enum = field.options;
+      }
       break;
-    case "ZodArray":
+    }
+    case "array": {
       prop.type = "array";
-      if (def.type) {
-        prop.items = zodFieldToJsonSchema(def.type);
+      const itemType = def.element ?? def.type;
+      if (itemType) {
+        const itemSchema = zodFieldToJsonSchema(itemType);
+        prop.items = Object.keys(itemSchema).length > 0 ? itemSchema : { type: "string" };
       }
       break;
-    case "ZodObject":
+    }
+    case "object": {
       prop.type = "object";
       if (field.shape) {
         const nested = {};
@@ -241,29 +269,72 @@ function zodFieldToJsonSchema(field) {
         prop.additionalProperties = false;
       }
       break;
-    case "ZodOptional":
-      return { ...zodFieldToJsonSchema(def.innerType), ...def.description ? { description: def.description } : {} };
-    case "ZodDefault":
-      return {
-        ...zodFieldToJsonSchema(def.innerType),
-        default: def.defaultValue(),
-        ...def.description ? { description: def.description } : {}
-      };
-    case "ZodEffects":
-      return zodFieldToJsonSchema(def.schema);
-    case "ZodNullable":
+    }
+    case "optional": {
+      const inner = zodFieldToJsonSchema(def.innerType);
+      if (desc) inner.description = desc;
+      return inner;
+    }
+    case "default": {
+      const inner = zodFieldToJsonSchema(def.innerType);
+      const dv = typeof def.defaultValue === "function" ? def.defaultValue() : def.defaultValue;
+      if (dv !== void 0) inner.default = dv;
+      if (desc) inner.description = desc;
+      return inner;
+    }
+    case "effects":
+      return zodFieldToJsonSchema(def.schema ?? def.innerType);
+    case "nullable":
       return zodFieldToJsonSchema(def.innerType);
-    case "ZodUnion":
-      if (def.options?.length) {
-        return zodFieldToJsonSchema(def.options[0]);
+    case "union": {
+      const options2 = def.options;
+      if (Array.isArray(options2) && options2.length > 0) {
+        return zodFieldToJsonSchema(options2[0]);
       }
       break;
-    case "ZodRecord":
+    }
+    case "record":
       prop.type = "object";
       break;
+    case "literal":
+      if (def.value !== void 0) {
+        prop.type = typeof def.value;
+        prop.enum = [def.value];
+      }
+      break;
   }
   return prop;
 }
+function coerceArgs(args, schema2) {
+  const shape = schema2.shape;
+  const result = { ...args };
+  for (const [key, value] of Object.entries(result)) {
+    if (typeof value !== "string") continue;
+    const fieldDef = shape[key];
+    if (!fieldDef) continue;
+    const expectedType = resolveBaseType(fieldDef);
+    if (expectedType === "object" || expectedType === "array") {
+      try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed === "object" && parsed !== null) {
+          result[key] = parsed;
+        }
+      } catch {
+      }
+    }
+  }
+  return result;
+}
+function resolveBaseType(field) {
+  const rawType = getZodType(field);
+  if (!rawType) return void 0;
+  const t = normalizeType(rawType);
+  if ((t === "optional" || t === "default" || t === "nullable") && field._def?.innerType) {
+    return resolveBaseType(field._def.innerType);
+  }
+  if (t === "record") return "object";
+  return t;
+}
 function createMcpServer(strapi) {
   const plugin = strapi.plugin("ai-sdk");
   const registry = plugin.toolRegistry;
@@ -316,7 +387,9 @@ function createMcpServer(strapi) {
       };
     }
     try {
-      const result = await def.execute(args ?? {}, strapi);
+      const coerced = coerceArgs(args ?? {}, def.schema);
+      const validated = def.schema.parse(coerced);
+      const result = await def.execute(validated, strapi);
       return {
         content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
       };

package/dist/server/index.mjs

@@ -147,6 +147,14 @@ function buildInstructions(registry) {
   );
   return lines.join("\n");
 }
+function getZodType(field) {
+  const def = field?._def;
+  if (!def) return void 0;
+  return def.typeName ?? def.type;
+}
+function getDescription(field) {
+  return field?.description ?? field?._def?.description;
+}
 function zodToInputSchema(schema2) {
   const shape = schema2.shape;
   const properties = {};
@@ -170,26 +178,35 @@ function zodToInputSchema(schema2) {
 }
 function isOptionalOrDefaulted(field) {
   if (!field) return true;
-  const def = field._def;
-  if (!def) return false;
-  const typeName = def.typeName;
-  if (typeName === "ZodOptional" || typeName === "ZodDefault") return true;
-  if (def.innerType) return isOptionalOrDefaulted(def.innerType);
+  const t = getZodType(field);
+  if (!t) return false;
+  const normalized = normalizeType(t);
+  if (normalized === "optional" || normalized === "default") return true;
+  if (field._def?.innerType) return isOptionalOrDefaulted(field._def.innerType);
   return false;
 }
+function normalizeType(t) {
+  if (t.startsWith("Zod")) return t.slice(3).toLowerCase();
+  return t.toLowerCase();
+}
 function zodFieldToJsonSchema(field) {
-  if (!field?._def) return {};
+  const rawType = getZodType(field);
+  if (!rawType) return {};
+  const t = normalizeType(rawType);
   const def = field._def;
-  const typeName = def.typeName;
   const prop = {};
-  if (def.description) prop.description = def.description;
-  switch (typeName) {
-    case "ZodString":
+  const desc = getDescription(field);
+  if (desc) prop.description = desc;
+  switch (t) {
+    case "string":
       prop.type = "string";
       break;
-    case "ZodNumber":
+    case "number": {
       prop.type = "number";
-      if (def.checks) {
+      if (field.isInt) prop.type = "integer";
+      if (typeof field.minValue === "number" && field.minValue > -Number.MAX_SAFE_INTEGER) prop.minimum = field.minValue;
+      if (typeof field.maxValue === "number" && field.maxValue < Number.MAX_SAFE_INTEGER) prop.maximum = field.maxValue;
+      if (def.checks && Array.isArray(def.checks)) {
         for (const check of def.checks) {
           if (check.kind === "min") prop.minimum = check.value;
           if (check.kind === "max") prop.maximum = check.value;
@@ -197,20 +214,31 @@ function zodFieldToJsonSchema(field) {
         }
       }
       break;
-    case "ZodBoolean":
+    }
+    case "boolean":
       prop.type = "boolean";
       break;
-    case "ZodEnum":
+    case "enum": {
       prop.type = "string";
-      prop.enum = def.values;
+      if (Array.isArray(def.values)) {
+        prop.enum = def.values;
+      } else if (def.entries) {
+        prop.enum = Object.keys(def.entries);
+      } else if (Array.isArray(field.options)) {
+        prop.enum = field.options;
+      }
       break;
-    case "ZodArray":
+    }
+    case "array": {
       prop.type = "array";
-      if (def.type) {
-        prop.items = zodFieldToJsonSchema(def.type);
+      const itemType = def.element ?? def.type;
+      if (itemType) {
+        const itemSchema = zodFieldToJsonSchema(itemType);
+        prop.items = Object.keys(itemSchema).length > 0 ? itemSchema : { type: "string" };
       }
       break;
-    case "ZodObject":
+    }
+    case "object": {
       prop.type = "object";
       if (field.shape) {
         const nested = {};
@@ -221,29 +249,72 @@ function zodFieldToJsonSchema(field) {
         prop.additionalProperties = false;
       }
       break;
-    case "ZodOptional":
-      return { ...zodFieldToJsonSchema(def.innerType), ...def.description ? { description: def.description } : {} };
-    case "ZodDefault":
-      return {
-        ...zodFieldToJsonSchema(def.innerType),
-        default: def.defaultValue(),
-        ...def.description ? { description: def.description } : {}
-      };
-    case "ZodEffects":
-      return zodFieldToJsonSchema(def.schema);
-    case "ZodNullable":
+    }
+    case "optional": {
+      const inner = zodFieldToJsonSchema(def.innerType);
+      if (desc) inner.description = desc;
+      return inner;
+    }
+    case "default": {
+      const inner = zodFieldToJsonSchema(def.innerType);
+      const dv = typeof def.defaultValue === "function" ? def.defaultValue() : def.defaultValue;
+      if (dv !== void 0) inner.default = dv;
+      if (desc) inner.description = desc;
+      return inner;
+    }
+    case "effects":
+      return zodFieldToJsonSchema(def.schema ?? def.innerType);
+    case "nullable":
       return zodFieldToJsonSchema(def.innerType);
-    case "ZodUnion":
-      if (def.options?.length) {
-        return zodFieldToJsonSchema(def.options[0]);
+    case "union": {
+      const options2 = def.options;
+      if (Array.isArray(options2) && options2.length > 0) {
+        return zodFieldToJsonSchema(options2[0]);
       }
       break;
-    case "ZodRecord":
+    }
+    case "record":
       prop.type = "object";
       break;
+    case "literal":
+      if (def.value !== void 0) {
+        prop.type = typeof def.value;
+        prop.enum = [def.value];
+      }
+      break;
   }
   return prop;
 }
+function coerceArgs(args, schema2) {
+  const shape = schema2.shape;
+  const result = { ...args };
+  for (const [key, value] of Object.entries(result)) {
+    if (typeof value !== "string") continue;
+    const fieldDef = shape[key];
+    if (!fieldDef) continue;
+    const expectedType = resolveBaseType(fieldDef);
+    if (expectedType === "object" || expectedType === "array") {
+      try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed === "object" && parsed !== null) {
+          result[key] = parsed;
+        }
+      } catch {
+      }
+    }
+  }
+  return result;
+}
+function resolveBaseType(field) {
+  const rawType = getZodType(field);
+  if (!rawType) return void 0;
+  const t = normalizeType(rawType);
+  if ((t === "optional" || t === "default" || t === "nullable") && field._def?.innerType) {
+    return resolveBaseType(field._def.innerType);
+  }
+  if (t === "record") return "object";
+  return t;
+}
 function createMcpServer(strapi) {
   const plugin = strapi.plugin("ai-sdk");
   const registry = plugin.toolRegistry;
@@ -296,7 +367,9 @@ function createMcpServer(strapi) {
       };
     }
     try {
-      const result = await def.execute(args ?? {}, strapi);
+      const coerced = coerceArgs(args ?? {}, def.schema);
+      const validated = def.schema.parse(coerced);
+      const result = await def.execute(validated, strapi);
       return {
         content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
       };

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.0",
+  "version": "0.10.0",
   "keywords": [
     "strapi",
     "strapi-plugin",