fastmcp 4.21.2 → 4.22.1

package/dist/openapi/index.cjs

@@ -2,8 +2,8 @@
 
 
 
-var _chunkC5VOVQPCcjs = require('../chunk-C5VOVQPC.cjs');
-require('../chunk-GTPK7A57.cjs');
+var _chunkRN2Z26T4cjs = require('../chunk-RN2Z26T4.cjs');
+require('../chunk-YOBCXNFP.cjs');
 require('../chunk-O22SYZMC.cjs');
 
 // 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;
     }
   }
@@ -123,7 +129,7 @@ async function executeRequest(options) {
   });
   const text = await response.text();
   if (!response.ok) {
-    throw new (0, _chunkC5VOVQPCcjs.UserError)(
+    throw new (0, _chunkRN2Z26T4cjs.UserError)(
       `${options.route.method.toUpperCase()} ${path} failed with ${response.status}: ${text.slice(0, 2e3)}`
     );
   }
@@ -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(_nullishCoalesce(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 _optionalChain([param, 'access', _11 => _11.schema, 'optionalAccess', _12 => _12.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(_nullishCoalesce(document.paths, () => ( {})))) {
-    const pathItem = resolvePathItem(document, rawPathItem);
-    const pathLevelParams = (_nullishCoalesce(pathItem.parameters, () => ( []))).map(
-      (param) => resolveRef(document, param)
-    );
-    for (const method of HTTP_METHODS) {
-      const operation = pathItem[method];
-      if (!operation) {
-        continue;
-      }
-      const operationParams = (_nullishCoalesce(operation.parameters, () => ( []))).map(
-        (param) => resolveRef(document, param)
-      );
-      routes.push({
-        deprecated: _nullishCoalesce(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) => _optionalChain([servers, 'optionalAccess', _13 => _13.length])
-        ),
-        summary: operation.summary,
-        tags: _nullishCoalesce(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 = _optionalChain([node, 'optionalAccess', _14 => _14[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(
         _nullishCoalesce(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);
       }
@@ -406,7 +304,7 @@ function buildFlatSchema(route, sharedDefs) {
   };
 }
 function buildSharedDefs(document) {
-  const schemas = _optionalChain([document, 'access', _15 => _15.components, 'optionalAccess', _16 => _16.schemas]);
+  const schemas = _optionalChain([document, 'access', _11 => _11.components, 'optionalAccess', _12 => _12.schemas]);
   if (!schemas || Object.keys(schemas).length === 0) {
     return void 0;
   }
@@ -418,7 +316,7 @@ function buildOutputSchema(route, sharedDefs) {
   const successEntry = Object.entries(_nullishCoalesce(route.responses, () => ( {}))).find(
     ([code]) => SUCCESS_STATUS_PATTERN.test(code)
   );
-  const declaredSchema = _optionalChain([successEntry, 'optionalAccess', _17 => _17[1], 'access', _18 => _18.content, 'optionalAccess', _19 => _19["application/json"], 'optionalAccess', _20 => _20.schema]);
+  const declaredSchema = _optionalChain([successEntry, 'optionalAccess', _13 => _13[1], 'access', _14 => _14.content, 'optionalAccess', _15 => _15["application/json"], 'optionalAccess', _16 => _16.schema]);
   if (!declaredSchema) {
     return void 0;
   }
@@ -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 : _optionalChain([sharedDefs, 'optionalAccess', _17 => _17[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);
 }
@@ -460,7 +374,7 @@ function componentSchemaName(ref) {
 }
 function extractBodyProperties(requestBody, sharedDefs) {
   const properties = /* @__PURE__ */ new Map();
-  const content = _optionalChain([requestBody, 'optionalAccess', _21 => _21.content]);
+  const content = _optionalChain([requestBody, 'optionalAccess', _18 => _18.content]);
   if (!content) {
     return { properties };
   }
@@ -471,7 +385,7 @@ function extractBodyProperties(requestBody, sharedDefs) {
     return contentTypes.length > 0 ? { properties, unsupportedBodyContentType: contentTypes[0] } : { properties };
   }
   const bodyEncoding = hasJson ? "json" : "form";
-  const declaredSchema = hasJson ? _optionalChain([content, 'access', _22 => _22["application/json"], 'optionalAccess', _23 => _23.schema]) : _optionalChain([content, 'access', _24 => _24["application/x-www-form-urlencoded"], 'optionalAccess', _25 => _25.schema]);
+  const declaredSchema = hasJson ? _optionalChain([content, 'access', _19 => _19["application/json"], 'optionalAccess', _20 => _20.schema]) : _optionalChain([content, 'access', _21 => _21["application/x-www-form-urlencoded"], 'optionalAccess', _22 => _22.schema]);
   if (!declaredSchema) {
     return { bodyEncoding, properties };
   }
@@ -496,7 +410,7 @@ function extractBodyProperties(requestBody, sharedDefs) {
     };
   }
   properties.set("body", {
-    required: _nullishCoalesce(_optionalChain([requestBody, 'optionalAccess', _26 => _26.required]), () => ( false)),
+    required: _nullishCoalesce(_optionalChain([requestBody, 'optionalAccess', _23 => _23.required]), () => ( false)),
     schema
   });
   return { bodyEncoding, properties, wholeBodyKey: "body" };
@@ -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 : _optionalChain([sharedDefs, 'optionalAccess', _27 => _27[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(_nullishCoalesce(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(_nullishCoalesce(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(_nullishCoalesce(document.paths, () => ( {})))) {
+    const pathItem = resolvePathItem(document, rawPathItem);
+    const pathLevelParams = (_nullishCoalesce(pathItem.parameters, () => ( []))).map(
+      (param) => resolveRef(document, param)
+    );
+    for (const method of HTTP_METHODS) {
+      const operation = pathItem[method];
+      if (!operation) {
+        continue;
+      }
+      const operationParams = (_nullishCoalesce(operation.parameters, () => ( []))).map(
+        (param) => resolveRef(document, param)
+      );
+      routes.push({
+        deprecated: _nullishCoalesce(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) => _optionalChain([servers, 'optionalAccess', _24 => _24.length])
+        ),
+        summary: operation.summary,
+        tags: _nullishCoalesce(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 = _optionalChain([node, 'optionalAccess', _25 => _25[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 = {
@@ -663,8 +679,8 @@ async function fromOpenAPI(options) {
   const selected = selectRoutes(routes, options);
   const names = generateNames(selected, options.mcpNames);
   const sharedDefs = buildSharedDefs(document);
-  const server = _nullishCoalesce(options.server, () => ( new (0, _chunkC5VOVQPCcjs.FastMCP)({
-    name: _nullishCoalesce(_nullishCoalesce(options.name, () => ( _optionalChain([document, 'access', _28 => _28.info, 'optionalAccess', _29 => _29.title]))), () => ( "OpenAPI Server")),
+  const server = _nullishCoalesce(options.server, () => ( new (0, _chunkRN2Z26T4cjs.FastMCP)({
+    name: _nullishCoalesce(_nullishCoalesce(options.name, () => ( _optionalChain([document, 'access', _26 => _26.info, 'optionalAccess', _27 => _27.title]))), () => ( "OpenAPI Server")),
     version: _nullishCoalesce(options.version, () => ( "1.0.0"))
   })));
   const skippedOperations = [];
@@ -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,
@@ -709,7 +725,7 @@ async function fromOpenAPI(options) {
       continue;
     }
     const outputSchemaJson = buildOutputSchema(route, sharedDefs);
-    const outputSchema = outputSchemaJson ? _chunkC5VOVQPCcjs.jsonSchemaAdapter.call(void 0, outputSchemaJson) : void 0;
+    const outputSchema = outputSchemaJson ? _chunkRN2Z26T4cjs.jsonSchemaAdapter.call(void 0, outputSchemaJson) : void 0;
     server.addTool({
       description: _nullishCoalesce(route.summary, () => ( `${route.method.toUpperCase()} ${route.path}`)),
       execute: async (args) => {
@@ -722,7 +738,7 @@ async function fromOpenAPI(options) {
         return resolveToolResult(result, outputSchema);
       },
       name,
-      parameters: _chunkC5VOVQPCcjs.jsonSchemaAdapter.call(void 0, flatSchema),
+      parameters: _chunkRN2Z26T4cjs.jsonSchemaAdapter.call(void 0, flatSchema),
       ...outputSchema ? { outputSchema } : {}
     });
   }