fastmcp 4.21.2 → 4.22.1

package/dist/openapi/index.js

@@ -2,8 +2,8 @@ import {
   FastMCP,
   UserError,
   jsonSchemaAdapter
-} from "../chunk-QMRS4ZLD.js";
-import "../chunk-AR3LVWUF.js";
+} from "../chunk-XFUILY54.js";
+import "../chunk-XPKMA7DH.js";
 import "../chunk-UMDUIBFW.js";
 
 // src/openapi/loadSpec.ts
@@ -91,7 +91,13 @@ async function executeRequest(options) {
         pathParams[mapping.name] = String(value);
         break;
       case "query":
-        appendQueryValue(query, mapping.name, mapping.style, value);
+        appendQueryValue(
+          query,
+          mapping.name,
+          mapping.style,
+          value,
+          mapping.explode
+        );
         break;
     }
   }
@@ -185,7 +191,7 @@ function appendBracketPairs(params, key, value) {
   }
   params.append(key, String(value));
 }
-function appendQueryValue(query, name, style, value) {
+function appendQueryValue(query, name, style, value, explode) {
   if (style === "deepObject") {
     appendBracketPairs(query, name, value);
     return;
@@ -196,6 +202,10 @@ function appendQueryValue(query, name, style, value) {
     query.append(name, items.map(String).join(separator));
     return;
   }
+  if ((style === void 0 || style === "form") && explode === false && Array.isArray(value) && value.length > 0) {
+    query.append(name, value.map(String).join(","));
+    return;
+  }
   for (const item of Array.isArray(value) ? value : [value]) {
     query.append(name, String(item));
   }
@@ -221,123 +231,6 @@ async function resolveHeaders(headers) {
   return typeof headers === "function" ? await headers() : { ...headers };
 }
 
-// src/openapi/resourceMapping.ts
-function buildResourceMapping(route, name, parameterMap, requiredKeys) {
-  const entries = Object.entries(parameterMap);
-  if (entries.length === 0) {
-    return { kind: "resource", uri: `openapi://${name}${route.path}` };
-  }
-  const required = new Set(requiredKeys ?? []);
-  const args = [];
-  const queryKeys = [];
-  let path = route.path;
-  for (const [flatKey, mapping] of entries) {
-    if (mapping.in === "path") {
-      if (flatKey !== mapping.name) {
-        path = path.replaceAll(`{${mapping.name}}`, `{${flatKey}}`);
-      }
-    } else {
-      queryKeys.push(flatKey);
-    }
-    args.push({ name: flatKey, required: required.has(flatKey) });
-  }
-  const uriTemplate = `openapi://${name}${path}` + (queryKeys.length > 0 ? `{?${queryKeys.join(",")}}` : "");
-  return { args, kind: "template", uriTemplate };
-}
-function isEligibleForResource(route) {
-  return route.parameters.every((param) => {
-    if (param.in === "header" || param.in === "cookie") {
-      return false;
-    }
-    return param.schema?.type !== "array";
-  });
-}
-
-// src/openapi/routes.ts
-var HTTP_METHODS = ["get", "put", "post", "delete", "patch"];
-function extractRoutes(document) {
-  const routes = [];
-  for (const [path, rawPathItem] of Object.entries(document.paths ?? {})) {
-    const pathItem = resolvePathItem(document, rawPathItem);
-    const pathLevelParams = (pathItem.parameters ?? []).map(
-      (param) => resolveRef(document, param)
-    );
-    for (const method of HTTP_METHODS) {
-      const operation = pathItem[method];
-      if (!operation) {
-        continue;
-      }
-      const operationParams = (operation.parameters ?? []).map(
-        (param) => resolveRef(document, param)
-      );
-      routes.push({
-        deprecated: operation.deprecated ?? false,
-        method,
-        operationId: operation.operationId,
-        parameters: mergeParameters(pathLevelParams, operationParams),
-        path,
-        requestBody: operation.requestBody ? resolveRef(document, operation.requestBody) : void 0,
-        responses: resolveResponses(document, operation.responses),
-        servers: [operation.servers, pathItem.servers, document.servers].find(
-          (servers) => servers?.length
-        ),
-        summary: operation.summary,
-        tags: operation.tags ?? []
-      });
-    }
-  }
-  return routes;
-}
-function mergeParameters(pathLevel, operationLevel) {
-  const overridden = new Set(
-    operationLevel.map((param) => `${param.in}:${param.name}`)
-  );
-  return [
-    ...pathLevel.filter(
-      (param) => !overridden.has(`${param.in}:${param.name}`)
-    ),
-    ...operationLevel
-  ];
-}
-function resolvePathItem(document, pathItem) {
-  const visited = /* @__PURE__ */ new Set();
-  let resolved = pathItem;
-  while (resolved.$ref && !visited.has(resolved.$ref)) {
-    visited.add(resolved.$ref);
-    const { $ref, ...siblings } = resolved;
-    resolved = { ...resolveRef(document, { $ref }), ...siblings };
-  }
-  return resolved;
-}
-function resolveRef(document, value) {
-  if (!value || typeof value !== "object" || !("$ref" in value)) {
-    return value;
-  }
-  const pointer = value.$ref;
-  if (!pointer.startsWith("#/")) {
-    throw new Error(`Unexpected external $ref after bundling: ${pointer}`);
-  }
-  const segments = pointer.slice(2).split("/").map(
-    (segment) => decodeURIComponent(segment.replaceAll("~1", "/").replaceAll("~0", "~"))
-  );
-  let node = document;
-  for (const segment of segments) {
-    node = node?.[segment];
-  }
-  return node;
-}
-function resolveResponses(document, rawResponses) {
-  if (!rawResponses) {
-    return void 0;
-  }
-  return Object.fromEntries(
-    Object.entries(rawResponses).map(([code, response]) => [
-      code,
-      resolveRef(document, response)
-    ])
-  );
-}
-
 // src/openapi/schemas.ts
 var SCHEMA_MAP_KEYS = /* @__PURE__ */ new Set([
   "$defs",
@@ -374,7 +267,12 @@ function buildFlatSchema(route, sharedDefs) {
       properties[key] = rewriteComponentRefs(
         param.schema ?? { type: "string" }
       );
-      parameterMap[key] = { in: param.in, name, style: param.style };
+      parameterMap[key] = {
+        explode: param.explode,
+        in: param.in,
+        name,
+        style: param.style
+      };
       if (param.in === "path" || param.required) {
         required.push(key);
       }
@@ -441,6 +339,22 @@ function buildOutputSchema(route, sharedDefs) {
     } : {}
   };
 }
+function resolveComponentRef(schema, sharedDefs) {
+  const seen = /* @__PURE__ */ new Set();
+  let current = schema;
+  let ref = current.$ref;
+  while (typeof ref === "string") {
+    const name = componentSchemaName(ref);
+    const target = name === void 0 ? void 0 : sharedDefs?.[name];
+    if (name === void 0 || target === void 0 || seen.has(name)) {
+      break;
+    }
+    seen.add(name);
+    current = target;
+    ref = current.$ref;
+  }
+  return current;
+}
 function rewriteComponentRefs(value, stripExamples = false) {
   return rewriteNode(value, "schema", stripExamples);
 }
@@ -569,22 +483,6 @@ function normalizeNullable(schema) {
   }
   return rest;
 }
-function resolveComponentRef(schema, sharedDefs) {
-  const seen = /* @__PURE__ */ new Set();
-  let current = schema;
-  let ref = current.$ref;
-  while (typeof ref === "string") {
-    const name = componentSchemaName(ref);
-    const target = name === void 0 ? void 0 : sharedDefs?.[name];
-    if (name === void 0 || target === void 0 || seen.has(name)) {
-      break;
-    }
-    seen.add(name);
-    current = target;
-    ref = current.$ref;
-  }
-  return current;
-}
 function rewriteNode(value, mode, stripExamples = false) {
   if (mode === "data") {
     return value;
@@ -610,6 +508,124 @@ function rewriteNode(value, mode, stripExamples = false) {
   return mode === "schemaMap" ? rewritten : normalizeExclusiveBounds(normalizeNullable(rewritten));
 }
 
+// src/openapi/resourceMapping.ts
+function buildResourceMapping(route, name, parameterMap, requiredKeys) {
+  const entries = Object.entries(parameterMap);
+  if (entries.length === 0) {
+    return { kind: "resource", uri: `openapi://${name}${route.path}` };
+  }
+  const required = new Set(requiredKeys ?? []);
+  const args = [];
+  const queryKeys = [];
+  let path = route.path;
+  for (const [flatKey, mapping] of entries) {
+    if (mapping.in === "path") {
+      if (flatKey !== mapping.name) {
+        path = path.replaceAll(`{${mapping.name}}`, `{${flatKey}}`);
+      }
+    } else {
+      queryKeys.push(flatKey);
+    }
+    args.push({ name: flatKey, required: required.has(flatKey) });
+  }
+  const uriTemplate = `openapi://${name}${path}` + (queryKeys.length > 0 ? `{?${queryKeys.join(",")}}` : "");
+  return { args, kind: "template", uriTemplate };
+}
+function isEligibleForResource(route, sharedDefs) {
+  return route.parameters.every((param) => {
+    if (param.in === "header" || param.in === "cookie") {
+      return false;
+    }
+    const type = resolveComponentRef(param.schema ?? {}, sharedDefs).type;
+    return type !== "array" && (!Array.isArray(type) || !type.includes("array"));
+  });
+}
+
+// src/openapi/routes.ts
+var HTTP_METHODS = ["get", "put", "post", "delete", "patch"];
+function extractRoutes(document) {
+  const routes = [];
+  for (const [path, rawPathItem] of Object.entries(document.paths ?? {})) {
+    const pathItem = resolvePathItem(document, rawPathItem);
+    const pathLevelParams = (pathItem.parameters ?? []).map(
+      (param) => resolveRef(document, param)
+    );
+    for (const method of HTTP_METHODS) {
+      const operation = pathItem[method];
+      if (!operation) {
+        continue;
+      }
+      const operationParams = (operation.parameters ?? []).map(
+        (param) => resolveRef(document, param)
+      );
+      routes.push({
+        deprecated: operation.deprecated ?? false,
+        method,
+        operationId: operation.operationId,
+        parameters: mergeParameters(pathLevelParams, operationParams),
+        path,
+        requestBody: operation.requestBody ? resolveRef(document, operation.requestBody) : void 0,
+        responses: resolveResponses(document, operation.responses),
+        servers: [operation.servers, pathItem.servers, document.servers].find(
+          (servers) => servers?.length
+        ),
+        summary: operation.summary,
+        tags: operation.tags ?? []
+      });
+    }
+  }
+  return routes;
+}
+function mergeParameters(pathLevel, operationLevel) {
+  const overridden = new Set(
+    operationLevel.map((param) => `${param.in}:${param.name}`)
+  );
+  return [
+    ...pathLevel.filter(
+      (param) => !overridden.has(`${param.in}:${param.name}`)
+    ),
+    ...operationLevel
+  ];
+}
+function resolvePathItem(document, pathItem) {
+  const visited = /* @__PURE__ */ new Set();
+  let resolved = pathItem;
+  while (resolved.$ref && !visited.has(resolved.$ref)) {
+    visited.add(resolved.$ref);
+    const { $ref, ...siblings } = resolved;
+    resolved = { ...resolveRef(document, { $ref }), ...siblings };
+  }
+  return resolved;
+}
+function resolveRef(document, value) {
+  if (!value || typeof value !== "object" || !("$ref" in value)) {
+    return value;
+  }
+  const pointer = value.$ref;
+  if (!pointer.startsWith("#/")) {
+    throw new Error(`Unexpected external $ref after bundling: ${pointer}`);
+  }
+  const segments = pointer.slice(2).split("/").map(
+    (segment) => decodeURIComponent(segment.replaceAll("~1", "/").replaceAll("~0", "~"))
+  );
+  let node = document;
+  for (const segment of segments) {
+    node = node?.[segment];
+  }
+  return node;
+}
+function resolveResponses(document, rawResponses) {
+  if (!rawResponses) {
+    return void 0;
+  }
+  return Object.fromEntries(
+    Object.entries(rawResponses).map(([code, response]) => [
+      code,
+      resolveRef(document, response)
+    ])
+  );
+}
+
 // src/openapi/selection.ts
 var DEFAULT_MAX_OPERATIONS = 40;
 var METHOD_PRIORITY = {
@@ -689,7 +705,7 @@ async function fromOpenAPI(options) {
       route,
       servers: route.servers
     };
-    if (options.resources && route.method === "get" && isEligibleForResource(route)) {
+    if (options.resources && route.method === "get" && isEligibleForResource(route, sharedDefs)) {
       registerResource(
         server,
         route,