@ttoss/http-server-mcp-openapi 0.1.0 → 0.1.2

package/README.md

@@ -62,6 +62,9 @@ Each OpenAPI operation with an `operationId` and a supported HTTP method
 
 Path params are always required strings. Query and body params carry their
 declared type and `required` flag. Array params keep their `items` schema.
+Parameters declared at the **path-item level** (shared by every operation on a
+path) are merged into each operation; an operation-level parameter overrides a
+path-item one with the same `name`+`in`.
 
 Tool arguments are **camelCase** (`agentId`, `projectId`); the generated
 request path, query string, and body use the original **snake_case** names.

package/dist/index.cjs

@@ -227,8 +227,18 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     required: requiredFields.length > 0 ? requiredFields : void 0
   };
 };
+/**
+* Deduplicates parameter entries by `name`, keeping the last occurrence. When
+* path-item-level and operation-level parameters are concatenated (operation
+* last), this makes the operation-level entry win — as the OpenAPI spec requires.
+*/
+var dedupeByName = items => {
+  const byName = /* @__PURE__ */new Map();
+  for (const item of items) byName.set(item.name, item);
+  return [...byName.values()];
+};
 var extractPathParams = args => {
-  return (args.parameters || []).map(p => {
+  return dedupeByName((args.parameters || []).map(p => {
     return resolveParameter(p, args.spec);
   }).filter(p => {
     return p.in === "path";
@@ -237,10 +247,10 @@ var extractPathParams = args => {
       name: p.name || "",
       camelName: snakeToCamel(p.name || "")
     };
-  });
+  }));
 };
 var extractQueryParams = args => {
-  return (args.parameters || []).map(p => {
+  return dedupeByName((args.parameters || []).map(p => {
     return resolveParameter(p, args.spec);
   }).filter(p => {
     return p.in === "query";
@@ -252,7 +262,7 @@ var extractQueryParams = args => {
       required: p.required || false,
       type: p.schema?.type || "string"
     };
-  });
+  }));
 };
 var resolveBodySchema = args => {
   const rawBodySchema = args.requestBody?.content?.["application/json"]?.schema;
@@ -295,12 +305,13 @@ var processOperation = args => {
   if (!args.operation.operationId) return null;
   if (args.operation[args.options.excludeExtension]) return null;
   const toolName = operationIdToToolName(args.operation.operationId);
+  const parameters = [...(args.pathItemParameters ?? []), ...(args.operation.parameters ?? [])];
   const pathParams = extractPathParams({
-    parameters: args.operation.parameters || [],
+    parameters,
     spec: args.spec
   });
   const queryParams = extractQueryParams({
-    parameters: args.operation.parameters || [],
+    parameters,
     spec: args.spec
   });
   const bodyProps = extractBodyProps({
@@ -328,14 +339,18 @@ var processOperation = args => {
   };
 };
 var processPath = args => {
+  const rawPathItemParameters = args.pathItem.parameters;
+  const pathItemParameters = Array.isArray(rawPathItemParameters) ? rawPathItemParameters : [];
   const tools = [];
   for (const [method, operation] of Object.entries(args.pathItem)) {
+    if (method === "parameters") continue;
     const tool = processOperation({
       pathTemplate: args.pathTemplate,
       method,
       operation,
       spec: args.spec,
-      options: args.options
+      options: args.options,
+      pathItemParameters
     });
     if (tool) tools.push(tool);
   }

package/dist/index.d.cts

@@ -308,6 +308,16 @@ declare const processOperation: (args: {
   operation: OperationSpec;
   spec: OpenApiSpec;
   options: Required<OpenApiToToolsOptions>;
+  /**
+   * Parameters declared at the path-item level (shared by every operation on
+   * the path). Merged ahead of the operation's own parameters so operation-level
+   * entries win on a `name`+`in` clash.
+   */
+  pathItemParameters?: Array<{
+    name?: string;
+    in?: string;
+    [key: string]: unknown;
+  }>;
 }) => ToolDefinition | null;
 declare const processPath: (args: {
   pathTemplate: string;

package/dist/index.d.mts

@@ -308,6 +308,16 @@ declare const processOperation: (args: {
   operation: OperationSpec;
   spec: OpenApiSpec;
   options: Required<OpenApiToToolsOptions>;
+  /**
+   * Parameters declared at the path-item level (shared by every operation on
+   * the path). Merged ahead of the operation's own parameters so operation-level
+   * entries win on a `name`+`in` clash.
+   */
+  pathItemParameters?: Array<{
+    name?: string;
+    in?: string;
+    [key: string]: unknown;
+  }>;
 }) => ToolDefinition | null;
 declare const processPath: (args: {
   pathTemplate: string;

package/dist/index.mjs

@@ -224,8 +224,18 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     required: requiredFields.length > 0 ? requiredFields : void 0
   };
 };
+/**
+* Deduplicates parameter entries by `name`, keeping the last occurrence. When
+* path-item-level and operation-level parameters are concatenated (operation
+* last), this makes the operation-level entry win — as the OpenAPI spec requires.
+*/
+var dedupeByName = items => {
+  const byName = /* @__PURE__ */new Map();
+  for (const item of items) byName.set(item.name, item);
+  return [...byName.values()];
+};
 var extractPathParams = args => {
-  return (args.parameters || []).map(p => {
+  return dedupeByName((args.parameters || []).map(p => {
     return resolveParameter(p, args.spec);
   }).filter(p => {
     return p.in === "path";
@@ -234,10 +244,10 @@ var extractPathParams = args => {
       name: p.name || "",
       camelName: snakeToCamel(p.name || "")
     };
-  });
+  }));
 };
 var extractQueryParams = args => {
-  return (args.parameters || []).map(p => {
+  return dedupeByName((args.parameters || []).map(p => {
     return resolveParameter(p, args.spec);
   }).filter(p => {
     return p.in === "query";
@@ -249,7 +259,7 @@ var extractQueryParams = args => {
       required: p.required || false,
       type: p.schema?.type || "string"
     };
-  });
+  }));
 };
 var resolveBodySchema = args => {
   const rawBodySchema = args.requestBody?.content?.["application/json"]?.schema;
@@ -292,12 +302,13 @@ var processOperation = args => {
   if (!args.operation.operationId) return null;
   if (args.operation[args.options.excludeExtension]) return null;
   const toolName = operationIdToToolName(args.operation.operationId);
+  const parameters = [...(args.pathItemParameters ?? []), ...(args.operation.parameters ?? [])];
   const pathParams = extractPathParams({
-    parameters: args.operation.parameters || [],
+    parameters,
     spec: args.spec
   });
   const queryParams = extractQueryParams({
-    parameters: args.operation.parameters || [],
+    parameters,
     spec: args.spec
   });
   const bodyProps = extractBodyProps({
@@ -325,14 +336,18 @@ var processOperation = args => {
   };
 };
 var processPath = args => {
+  const rawPathItemParameters = args.pathItem.parameters;
+  const pathItemParameters = Array.isArray(rawPathItemParameters) ? rawPathItemParameters : [];
   const tools = [];
   for (const [method, operation] of Object.entries(args.pathItem)) {
+    if (method === "parameters") continue;
     const tool = processOperation({
       pathTemplate: args.pathTemplate,
       method,
       operation,
       spec: args.spec,
-      options: args.options
+      options: args.options,
+      pathItemParameters
     });
     if (tool) tools.push(tool);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp-openapi",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Generate Model Context Protocol (MCP) tools from an OpenAPI specification for @ttoss/http-server-mcp",
   "keywords": [
     "ai",
@@ -35,7 +35,7 @@
     "dist"
   ],
   "dependencies": {
-    "@ttoss/http-server-mcp": "^0.22.0"
+    "@ttoss/http-server-mcp": "^0.23.0"
   },
   "devDependencies": {
     "jest": "^30.4.2",