@ttoss/http-server-mcp-openapi 0.2.13 → 0.2.15

package/README.md

@@ -61,7 +61,11 @@ Each OpenAPI operation with an `operationId` and a supported HTTP method
 | operation `description`   | tool description (quotes/newlines sanitised) |
 
 Path params are always required strings. Query and body params carry their
-declared type and `required` flag. Array params keep their `items` schema.
+declared type and `required` flag. Array params keep their `items` schema. A
+body property declared as a single-entry `allOf` (usually `allOf: [{ $ref }]`
+beside its own `description`) takes `type`, `nullable` and `items` from the
+referenced schema; a multi-entry `allOf` is forwarded verbatim, and a property
+with no declared type is advertised untyped so it accepts any value.
 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`.
@@ -69,6 +73,11 @@ 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.
 
+Query params honour their declared `style` and `explode`. `form` (the default)
+repeats array values, `spaceDelimited`/`pipeDelimited` join them, and
+`deepObject` emits bracketed keys — including nested objects and arrays, so
+`{ documentId: { $eq: 'doc_1' } }` becomes `filters[documentId][$eq]=doc_1`.
+
 ## `registerOpenApiTools`
 
 | Field      | Description                                                                                                   |

package/dist/index.cjs

@@ -117,22 +117,108 @@ var buildPathFn = (pathTemplate, pathParams) => {
     return result;
   };
 };
+var NON_EXPLODED_DELIMITERS = {
+  form: ",",
+  spaceDelimited: " ",
+  pipeDelimited: "|"
+};
+var isRecord = value => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+/**
+* Appends a `deepObject` value as bracketed keys — `filters[documentId][$eq]`.
+* OpenAPI only defines one level, but the APIs that ask for `deepObject`
+* (Strapi, Directus) nest, so nested objects and arrays recurse instead of
+* being stringified into `[object Object]`.
+*/
+var appendDeepObject = args => {
+  if (args.value === void 0 || args.value === null) return;
+  if (Array.isArray(args.value)) {
+    for (const [index, item] of args.value.entries()) appendDeepObject({
+      search: args.search,
+      key: `${args.key}[${index}]`,
+      value: item
+    });
+    return;
+  }
+  if (isRecord(args.value)) {
+    for (const [property, propertyValue] of Object.entries(args.value)) appendDeepObject({
+      search: args.search,
+      key: `${args.key}[${property}]`,
+      value: propertyValue
+    });
+    return;
+  }
+  args.search.append(args.key, String(args.value));
+};
+var appendArrayValue = args => {
+  if (args.explode) {
+    for (const item of args.value) args.search.append(args.name, String(item));
+    return;
+  }
+  args.search.append(args.name, args.value.map(String).join(args.delimiter));
+};
+var appendObjectValue = args => {
+  const entries = Object.entries(args.value).filter(([, entryValue]) => {
+    return entryValue !== void 0 && entryValue !== null;
+  });
+  if (args.explode) {
+    for (const [property, entryValue] of entries) args.search.append(property, String(entryValue));
+    return;
+  }
+  args.search.append(args.name, entries.flatMap(([property, entryValue]) => {
+    return [property, String(entryValue)];
+  }).join(args.delimiter));
+};
+var appendQueryValue = args => {
+  const style = args.param.style ?? "form";
+  if (style === "deepObject") {
+    appendDeepObject({
+      search: args.search,
+      key: args.param.name,
+      value: args.value
+    });
+    return;
+  }
+  const serialization = {
+    search: args.search,
+    name: args.param.name,
+    explode: args.param.explode ?? style === "form",
+    delimiter: NON_EXPLODED_DELIMITERS[style] ?? ","
+  };
+  if (Array.isArray(args.value)) {
+    appendArrayValue({
+      ...serialization,
+      value: args.value
+    });
+    return;
+  }
+  if (isRecord(args.value)) {
+    appendObjectValue({
+      ...serialization,
+      value: args.value
+    });
+    return;
+  }
+  args.search.append(args.param.name, String(args.value));
+};
 /**
 * Builds a function that serialises query params into a query string
-* (including the leading `?`). Returns `undefined` when the op has no query
-* params. Array values are appended once per element.
+* (including the leading `?`), honouring each param's OpenAPI `style` and
+* `explode`. Returns `undefined` when the op has no query params.
 */
 var buildQueryFn = queryParams => {
   if (queryParams.length === 0) return void 0;
   return args => {
     const search = new URLSearchParams();
-    for (const {
-      name,
-      camelName
-    } of queryParams) {
-      const value = args[camelName];
+    for (const param of queryParams) {
+      const value = args[param.camelName];
       if (value === void 0 || value === null) continue;
-      if (Array.isArray(value)) for (const item of value) search.append(name, String(item));else search.append(name, String(value));
+      appendQueryValue({
+        search,
+        param,
+        value
+      });
     }
     const qs = search.toString();
     return qs ? `?${qs}` : "";
@@ -186,11 +272,13 @@ var sanitizeDescription = description => {
   return (description || "").replace(/'/g, "\\'").replace(/\n/g, " ").trim();
 };
 /**
-* Builds a single body/query property's `JsonSchemaProperty`. Split out of
-* {@link buildInputSchema} to keep that function's size and branching down.
+* Forwards a property's `oneOf` / `anyOf` / multi-entry `allOf` verbatim, or
+* returns `undefined` when it declares none.
 */
-var buildTypedProperty = param => {
-  const description = sanitizeDescription(param.description);
+var buildComposedProperty = param => {
+  const {
+    description
+  } = param;
   if (param.oneOf && param.oneOf.length > 0) return {
     oneOf: param.oneOf,
     description
@@ -199,6 +287,25 @@ var buildTypedProperty = param => {
     anyOf: param.anyOf,
     description
   };
+  if (param.allOf && param.allOf.length > 0) return {
+    allOf: param.allOf,
+    description
+  };
+};
+/**
+* Builds a single body/query property's `JsonSchemaProperty`. Split out of
+* {@link buildInputSchema} to keep that function's size and branching down.
+*/
+var buildTypedProperty = param => {
+  const description = sanitizeDescription(param.description);
+  const composed = buildComposedProperty({
+    ...param,
+    description
+  });
+  if (composed) return composed;
+  if (param.type === void 0) return {
+    description
+  };
   const jsonType = getJsonSchemaType(param.type);
   const finalType = param.nullable === true ? [jsonType, "null"] : jsonType;
   if (param.type === "array") return {
@@ -230,7 +337,7 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     return p.camelName;
   })];
   const properties = {};
-  for (const param of allParams) properties[param.camelName] = "type" in param ? buildTypedProperty(param) : {
+  for (const param of allParams) properties[param.camelName] = "description" in param ? buildTypedProperty(param) : {
     type: "string",
     description: ""
   };
@@ -275,7 +382,9 @@ var extractQueryParams = args => {
       camelName: snakeToCamel(p.name || ""),
       description: p.description || "",
       required: p.required || false,
-      type: p.schema?.type || "string"
+      type: p.schema?.type || "string",
+      style: p.style,
+      explode: p.explode
     };
   }));
 };
@@ -291,23 +400,47 @@ var extractAcceptedBodyFields = args => {
   const bodySchema = resolveBodySchema(args);
   return Object.keys(bodySchema?.properties ?? {});
 };
+var isPlainObject = value => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+/**
+* Folds a single-entry `allOf` into the property that wraps it. OpenAPI
+* declares `allOf: [{ $ref }]` so a property can carry its own `description`
+* next to a referenced schema; without folding, the referenced `type`,
+* `nullable` and `items` would be lost. Keys on the wrapper win over the
+* referenced schema's. Multi-entry `allOf` is left intact.
+*/
+var flattenSingleAllOf = schema => {
+  const {
+    allOf,
+    ...rest
+  } = schema;
+  if (!Array.isArray(allOf) || allOf.length !== 1) return schema;
+  const [entry] = allOf;
+  if (!isPlainObject(entry)) return rest;
+  return {
+    ...flattenSingleAllOf(entry),
+    ...rest
+  };
+};
 var extractBodyProps = args => {
   const bodySchema = resolveBodySchema(args);
   if (!bodySchema?.properties) return [];
   return Object.entries(bodySchema.properties).filter(([, value]) => {
     return !value[args.serverManagedExtension];
   }).map(([key, value]) => {
-    const val = value;
+    const val = flattenSingleAllOf(value);
     return {
       snakeName: key,
       camelName: snakeToCamel(key),
       description: typeof val.description === "string" ? val.description : "",
       required: (bodySchema.required || []).includes(key),
-      type: typeof val.type === "string" ? val.type : "string",
+      type: typeof val.type === "string" ? val.type : void 0,
       items: val.items,
       nullable: val.nullable === true,
       oneOf: Array.isArray(val.oneOf) ? val.oneOf : void 0,
-      anyOf: Array.isArray(val.anyOf) ? val.anyOf : void 0
+      anyOf: Array.isArray(val.anyOf) ? val.anyOf : void 0,
+      allOf: Array.isArray(val.allOf) ? val.allOf : void 0
     };
   });
 };

package/dist/index.d.cts

@@ -13,7 +13,9 @@ type JsonSchemaPrimitiveType = 'string' | 'number' | 'boolean' | 'array' | 'inte
  * client-side validator enforces the same alternatives the REST API does,
  * rather than collapsing to a single guessed primitive. `type` may be an
  * array of two entries (e.g. `['string', 'null']`) to represent an OpenAPI
- * `nullable: true` property without losing its declared type.
+ * `nullable: true` property without losing its declared type. A property with
+ * no declared type is emitted untyped (only `description`), so it accepts any
+ * value instead of a guessed `string`.
  */
 type JsonSchemaProperty = {
   type: JsonSchemaPrimitiveType | JsonSchemaPrimitiveType[];
@@ -22,6 +24,7 @@ type JsonSchemaProperty = {
 } | {
   oneOf?: unknown[];
   anyOf?: unknown[];
+  allOf?: unknown[];
   description?: string;
 };
 /**
@@ -93,7 +96,9 @@ interface OperationSpec {
     name?: string;
     in?: string;
     required?: boolean;
-    description?: string;
+    description?: string; /** Query serialisation style, e.g. `form` (default) or `deepObject`. */
+    style?: string; /** Whether each value gets its own key. Defaults to `true` for `form`. */
+    explode?: boolean;
     schema?: {
       type?: string;
       items?: {
@@ -212,6 +217,8 @@ declare const resolveParameter: (param: Record<string, unknown> | undefined, spe
   in?: string;
   required?: boolean;
   description?: string;
+  style?: string;
+  explode?: boolean;
   schema?: {
     type?: string;
     items?: {
@@ -224,15 +231,19 @@ declare const buildPathFn: (pathTemplate: string, pathParams: Array<{
   name: string;
   camelName: string;
 }>) => ((args: Record<string, unknown>) => string);
+/** Query parameter with the OpenAPI serialisation rules declared for it. */
+type QueryParamSerialization = {
+  name: string;
+  camelName: string; /** OpenAPI `style` (`form`, `deepObject`, `spaceDelimited`, `pipeDelimited`). */
+  style?: string; /** OpenAPI `explode`. Defaults to `true` for `form`, `false` otherwise. */
+  explode?: boolean;
+};
 /**
  * Builds a function that serialises query params into a query string
- * (including the leading `?`). Returns `undefined` when the op has no query
- * params. Array values are appended once per element.
+ * (including the leading `?`), honouring each param's OpenAPI `style` and
+ * `explode`. Returns `undefined` when the op has no query params.
  */
-declare const buildQueryFn: (queryParams: Array<{
-  name: string;
-  camelName: string;
-}>) => ((args: Record<string, unknown>) => string) | undefined;
+declare const buildQueryFn: (queryParams: QueryParamSerialization[]) => ((args: Record<string, unknown>) => string) | undefined;
 /**
  * Builds a function that maps camelCase args back to a snake_case request
  * body, skipping `undefined` args. Returns `undefined` when the op has no body.
@@ -266,11 +277,12 @@ declare const buildInputSchema: (pathParams: Array<{
   camelName: string;
   description: string;
   required: boolean;
-  type: string;
+  type?: string;
   items?: unknown;
   nullable?: boolean;
   oneOf?: unknown[];
   anyOf?: unknown[];
+  allOf?: unknown[];
 }>) => JsonObjectSchema;
 declare const extractPathParams: (args: {
   parameters?: Array<{
@@ -296,6 +308,8 @@ declare const extractQueryParams: (args: {
   description: string;
   required: boolean;
   type: string;
+  style?: string;
+  explode?: boolean;
 }>;
 /**
  * snake_case names of every top-level property an operation's request schema
@@ -314,11 +328,12 @@ declare const extractBodyProps: (args: {
   camelName: string;
   description: string;
   required: boolean;
-  type: string;
+  type?: string;
   items?: unknown;
   nullable: boolean;
   oneOf?: unknown[];
   anyOf?: unknown[];
+  allOf?: unknown[];
 }>;
 declare const processOperation: (args: {
   pathTemplate: string;
@@ -360,4 +375,4 @@ declare const openApiToToolDefinitions: (args: {
   options?: OpenApiToToolsOptions;
 }) => ToolDefinition[];
 //#endregion
-export { DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedRequest, type ToolDefinition, buildBodyFn, buildInputSchema, buildPathFn, buildQueryFn, dereferenceSchema, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, operationIdToToolName, processOperation, processPath, registerOpenApiTools, resolveParameter, resolveSchema, snakeToCamel };
+export { DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type QueryParamSerialization, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedRequest, type ToolDefinition, buildBodyFn, buildInputSchema, buildPathFn, buildQueryFn, dereferenceSchema, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, operationIdToToolName, processOperation, processPath, registerOpenApiTools, resolveParameter, resolveSchema, snakeToCamel };

package/dist/index.d.mts

@@ -13,7 +13,9 @@ type JsonSchemaPrimitiveType = 'string' | 'number' | 'boolean' | 'array' | 'inte
  * client-side validator enforces the same alternatives the REST API does,
  * rather than collapsing to a single guessed primitive. `type` may be an
  * array of two entries (e.g. `['string', 'null']`) to represent an OpenAPI
- * `nullable: true` property without losing its declared type.
+ * `nullable: true` property without losing its declared type. A property with
+ * no declared type is emitted untyped (only `description`), so it accepts any
+ * value instead of a guessed `string`.
  */
 type JsonSchemaProperty = {
   type: JsonSchemaPrimitiveType | JsonSchemaPrimitiveType[];
@@ -22,6 +24,7 @@ type JsonSchemaProperty = {
 } | {
   oneOf?: unknown[];
   anyOf?: unknown[];
+  allOf?: unknown[];
   description?: string;
 };
 /**
@@ -93,7 +96,9 @@ interface OperationSpec {
     name?: string;
     in?: string;
     required?: boolean;
-    description?: string;
+    description?: string; /** Query serialisation style, e.g. `form` (default) or `deepObject`. */
+    style?: string; /** Whether each value gets its own key. Defaults to `true` for `form`. */
+    explode?: boolean;
     schema?: {
       type?: string;
       items?: {
@@ -212,6 +217,8 @@ declare const resolveParameter: (param: Record<string, unknown> | undefined, spe
   in?: string;
   required?: boolean;
   description?: string;
+  style?: string;
+  explode?: boolean;
   schema?: {
     type?: string;
     items?: {
@@ -224,15 +231,19 @@ declare const buildPathFn: (pathTemplate: string, pathParams: Array<{
   name: string;
   camelName: string;
 }>) => ((args: Record<string, unknown>) => string);
+/** Query parameter with the OpenAPI serialisation rules declared for it. */
+type QueryParamSerialization = {
+  name: string;
+  camelName: string; /** OpenAPI `style` (`form`, `deepObject`, `spaceDelimited`, `pipeDelimited`). */
+  style?: string; /** OpenAPI `explode`. Defaults to `true` for `form`, `false` otherwise. */
+  explode?: boolean;
+};
 /**
  * Builds a function that serialises query params into a query string
- * (including the leading `?`). Returns `undefined` when the op has no query
- * params. Array values are appended once per element.
+ * (including the leading `?`), honouring each param's OpenAPI `style` and
+ * `explode`. Returns `undefined` when the op has no query params.
  */
-declare const buildQueryFn: (queryParams: Array<{
-  name: string;
-  camelName: string;
-}>) => ((args: Record<string, unknown>) => string) | undefined;
+declare const buildQueryFn: (queryParams: QueryParamSerialization[]) => ((args: Record<string, unknown>) => string) | undefined;
 /**
  * Builds a function that maps camelCase args back to a snake_case request
  * body, skipping `undefined` args. Returns `undefined` when the op has no body.
@@ -266,11 +277,12 @@ declare const buildInputSchema: (pathParams: Array<{
   camelName: string;
   description: string;
   required: boolean;
-  type: string;
+  type?: string;
   items?: unknown;
   nullable?: boolean;
   oneOf?: unknown[];
   anyOf?: unknown[];
+  allOf?: unknown[];
 }>) => JsonObjectSchema;
 declare const extractPathParams: (args: {
   parameters?: Array<{
@@ -296,6 +308,8 @@ declare const extractQueryParams: (args: {
   description: string;
   required: boolean;
   type: string;
+  style?: string;
+  explode?: boolean;
 }>;
 /**
  * snake_case names of every top-level property an operation's request schema
@@ -314,11 +328,12 @@ declare const extractBodyProps: (args: {
   camelName: string;
   description: string;
   required: boolean;
-  type: string;
+  type?: string;
   items?: unknown;
   nullable: boolean;
   oneOf?: unknown[];
   anyOf?: unknown[];
+  allOf?: unknown[];
 }>;
 declare const processOperation: (args: {
   pathTemplate: string;
@@ -360,4 +375,4 @@ declare const openApiToToolDefinitions: (args: {
   options?: OpenApiToToolsOptions;
 }) => ToolDefinition[];
 //#endregion
-export { DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedRequest, type ToolDefinition, buildBodyFn, buildInputSchema, buildPathFn, buildQueryFn, dereferenceSchema, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, operationIdToToolName, processOperation, processPath, registerOpenApiTools, resolveParameter, resolveSchema, snakeToCamel };
+export { DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type QueryParamSerialization, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedRequest, type ToolDefinition, buildBodyFn, buildInputSchema, buildPathFn, buildQueryFn, dereferenceSchema, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, operationIdToToolName, processOperation, processPath, registerOpenApiTools, resolveParameter, resolveSchema, snakeToCamel };

package/dist/index.mjs

@@ -114,22 +114,108 @@ var buildPathFn = (pathTemplate, pathParams) => {
     return result;
   };
 };
+var NON_EXPLODED_DELIMITERS = {
+  form: ",",
+  spaceDelimited: " ",
+  pipeDelimited: "|"
+};
+var isRecord = value => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+/**
+* Appends a `deepObject` value as bracketed keys — `filters[documentId][$eq]`.
+* OpenAPI only defines one level, but the APIs that ask for `deepObject`
+* (Strapi, Directus) nest, so nested objects and arrays recurse instead of
+* being stringified into `[object Object]`.
+*/
+var appendDeepObject = args => {
+  if (args.value === void 0 || args.value === null) return;
+  if (Array.isArray(args.value)) {
+    for (const [index, item] of args.value.entries()) appendDeepObject({
+      search: args.search,
+      key: `${args.key}[${index}]`,
+      value: item
+    });
+    return;
+  }
+  if (isRecord(args.value)) {
+    for (const [property, propertyValue] of Object.entries(args.value)) appendDeepObject({
+      search: args.search,
+      key: `${args.key}[${property}]`,
+      value: propertyValue
+    });
+    return;
+  }
+  args.search.append(args.key, String(args.value));
+};
+var appendArrayValue = args => {
+  if (args.explode) {
+    for (const item of args.value) args.search.append(args.name, String(item));
+    return;
+  }
+  args.search.append(args.name, args.value.map(String).join(args.delimiter));
+};
+var appendObjectValue = args => {
+  const entries = Object.entries(args.value).filter(([, entryValue]) => {
+    return entryValue !== void 0 && entryValue !== null;
+  });
+  if (args.explode) {
+    for (const [property, entryValue] of entries) args.search.append(property, String(entryValue));
+    return;
+  }
+  args.search.append(args.name, entries.flatMap(([property, entryValue]) => {
+    return [property, String(entryValue)];
+  }).join(args.delimiter));
+};
+var appendQueryValue = args => {
+  const style = args.param.style ?? "form";
+  if (style === "deepObject") {
+    appendDeepObject({
+      search: args.search,
+      key: args.param.name,
+      value: args.value
+    });
+    return;
+  }
+  const serialization = {
+    search: args.search,
+    name: args.param.name,
+    explode: args.param.explode ?? style === "form",
+    delimiter: NON_EXPLODED_DELIMITERS[style] ?? ","
+  };
+  if (Array.isArray(args.value)) {
+    appendArrayValue({
+      ...serialization,
+      value: args.value
+    });
+    return;
+  }
+  if (isRecord(args.value)) {
+    appendObjectValue({
+      ...serialization,
+      value: args.value
+    });
+    return;
+  }
+  args.search.append(args.param.name, String(args.value));
+};
 /**
 * Builds a function that serialises query params into a query string
-* (including the leading `?`). Returns `undefined` when the op has no query
-* params. Array values are appended once per element.
+* (including the leading `?`), honouring each param's OpenAPI `style` and
+* `explode`. Returns `undefined` when the op has no query params.
 */
 var buildQueryFn = queryParams => {
   if (queryParams.length === 0) return void 0;
   return args => {
     const search = new URLSearchParams();
-    for (const {
-      name,
-      camelName
-    } of queryParams) {
-      const value = args[camelName];
+    for (const param of queryParams) {
+      const value = args[param.camelName];
       if (value === void 0 || value === null) continue;
-      if (Array.isArray(value)) for (const item of value) search.append(name, String(item));else search.append(name, String(value));
+      appendQueryValue({
+        search,
+        param,
+        value
+      });
     }
     const qs = search.toString();
     return qs ? `?${qs}` : "";
@@ -183,11 +269,13 @@ var sanitizeDescription = description => {
   return (description || "").replace(/'/g, "\\'").replace(/\n/g, " ").trim();
 };
 /**
-* Builds a single body/query property's `JsonSchemaProperty`. Split out of
-* {@link buildInputSchema} to keep that function's size and branching down.
+* Forwards a property's `oneOf` / `anyOf` / multi-entry `allOf` verbatim, or
+* returns `undefined` when it declares none.
 */
-var buildTypedProperty = param => {
-  const description = sanitizeDescription(param.description);
+var buildComposedProperty = param => {
+  const {
+    description
+  } = param;
   if (param.oneOf && param.oneOf.length > 0) return {
     oneOf: param.oneOf,
     description
@@ -196,6 +284,25 @@ var buildTypedProperty = param => {
     anyOf: param.anyOf,
     description
   };
+  if (param.allOf && param.allOf.length > 0) return {
+    allOf: param.allOf,
+    description
+  };
+};
+/**
+* Builds a single body/query property's `JsonSchemaProperty`. Split out of
+* {@link buildInputSchema} to keep that function's size and branching down.
+*/
+var buildTypedProperty = param => {
+  const description = sanitizeDescription(param.description);
+  const composed = buildComposedProperty({
+    ...param,
+    description
+  });
+  if (composed) return composed;
+  if (param.type === void 0) return {
+    description
+  };
   const jsonType = getJsonSchemaType(param.type);
   const finalType = param.nullable === true ? [jsonType, "null"] : jsonType;
   if (param.type === "array") return {
@@ -227,7 +334,7 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     return p.camelName;
   })];
   const properties = {};
-  for (const param of allParams) properties[param.camelName] = "type" in param ? buildTypedProperty(param) : {
+  for (const param of allParams) properties[param.camelName] = "description" in param ? buildTypedProperty(param) : {
     type: "string",
     description: ""
   };
@@ -272,7 +379,9 @@ var extractQueryParams = args => {
       camelName: snakeToCamel(p.name || ""),
       description: p.description || "",
       required: p.required || false,
-      type: p.schema?.type || "string"
+      type: p.schema?.type || "string",
+      style: p.style,
+      explode: p.explode
     };
   }));
 };
@@ -288,23 +397,47 @@ var extractAcceptedBodyFields = args => {
   const bodySchema = resolveBodySchema(args);
   return Object.keys(bodySchema?.properties ?? {});
 };
+var isPlainObject = value => {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+/**
+* Folds a single-entry `allOf` into the property that wraps it. OpenAPI
+* declares `allOf: [{ $ref }]` so a property can carry its own `description`
+* next to a referenced schema; without folding, the referenced `type`,
+* `nullable` and `items` would be lost. Keys on the wrapper win over the
+* referenced schema's. Multi-entry `allOf` is left intact.
+*/
+var flattenSingleAllOf = schema => {
+  const {
+    allOf,
+    ...rest
+  } = schema;
+  if (!Array.isArray(allOf) || allOf.length !== 1) return schema;
+  const [entry] = allOf;
+  if (!isPlainObject(entry)) return rest;
+  return {
+    ...flattenSingleAllOf(entry),
+    ...rest
+  };
+};
 var extractBodyProps = args => {
   const bodySchema = resolveBodySchema(args);
   if (!bodySchema?.properties) return [];
   return Object.entries(bodySchema.properties).filter(([, value]) => {
     return !value[args.serverManagedExtension];
   }).map(([key, value]) => {
-    const val = value;
+    const val = flattenSingleAllOf(value);
     return {
       snakeName: key,
       camelName: snakeToCamel(key),
       description: typeof val.description === "string" ? val.description : "",
       required: (bodySchema.required || []).includes(key),
-      type: typeof val.type === "string" ? val.type : "string",
+      type: typeof val.type === "string" ? val.type : void 0,
       items: val.items,
       nullable: val.nullable === true,
       oneOf: Array.isArray(val.oneOf) ? val.oneOf : void 0,
-      anyOf: Array.isArray(val.anyOf) ? val.anyOf : void 0
+      anyOf: Array.isArray(val.anyOf) ? val.anyOf : void 0,
+      allOf: Array.isArray(val.allOf) ? val.allOf : void 0
     };
   });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp-openapi",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "Generate Model Context Protocol (MCP) tools from an OpenAPI specification for @ttoss/http-server-mcp",
   "keywords": [
     "ai",
@@ -42,8 +42,8 @@
     "jest": "^30.4.2",
     "supertest": "^7.2.2",
     "tsdown": "^0.22.2",
-    "@ttoss/http-server": "^0.8.1",
-    "@ttoss/config": "^1.38.0"
+    "@ttoss/config": "^1.38.0",
+    "@ttoss/http-server": "^0.8.1"
   },
   "publishConfig": {
     "access": "public",