@ttoss/http-server-mcp-openapi 0.4.0 → 0.5.1

package/README.md

@@ -157,8 +157,9 @@ registerOpenApiTools({
 
 A value flagged with `serverManagedExtension` is never offered to the model:
 
-- A **request-body property** is hidden from `inputSchema` and never sent (the
-  API sets it itself). It still appears in `acceptedBodyFields`.
+- A **request-body property** is hidden from `inputSchema` and, unless pinned,
+  never sent (the API sets it itself). It still appears in
+  `acceptedBodyFields`.
 - A **path or query parameter** is hidden from `inputSchema` and listed in
   `tool.serverManagedParameters`. `registerOpenApiTools` discards anything the
   model sent for it and fills it from `serverParameters`, keyed by spec name:
@@ -183,6 +184,12 @@ A **string** extension value pins the parameter: `wait` declared with
 `serverParameters`, and the entry in `serverManagedParameters` carries it as
 `value`.
 
+A pinned **request-body property** is sent by `tool.body`, over anything in the
+args, as the JSON type its schema declares: `'true'` on a `boolean` is `true`,
+`'3'` on an `integer` is `3`. A pin its type cannot hold (`'yes'` on a
+`boolean`, any pin on an `object`, `array` or untyped property) throws while
+the tools are generated, naming the operation and property.
+
 ### Reading custom extensions
 
 Every `x-` prefixed extension on an operation is forwarded verbatim on

package/dist/index.cjs

@@ -368,6 +368,57 @@ var withPinned = args => {
     });
   };
 };
+var parseNumber = value => {
+  const parsed = Number(value);
+  return value.trim() !== "" && Number.isFinite(parsed) ? parsed : void 0;
+};
+/** Each JSON type a pin can hold, and how its text reads as that type. */
+var PIN_PARSERS = {
+  string: value => {
+    return value;
+  },
+  boolean: value => {
+    if (value === "true") return true;
+    if (value === "false") return false;
+  },
+  number: parseNumber,
+  integer: value => {
+    const parsed = parseNumber(value);
+    return parsed !== void 0 && Number.isInteger(parsed) ? parsed : void 0;
+  }
+};
+/**
+* Reads a pinned body value as the JSON type its schema declares. A body is
+* JSON, so `'true'` on a boolean must reach the API as `true`; a query string
+* carries the text either way. A pin the type cannot hold is a spec error.
+*/
+var typedPin = args => {
+  const {
+    value,
+    type,
+    where
+  } = args;
+  const typed = (typeof type === "string" ? PIN_PARSERS[type] : void 0)?.(value);
+  if (typed !== void 0) return typed;
+  throw new Error(`${where}: cannot pin '${value}' on a property of type ${JSON.stringify(type ?? "any")}; a pinned body property must be a boolean, integer, number or string that holds the value.`);
+};
+/**
+* Wraps a `body` builder so pinned values replace whatever the args carry. An
+* operation whose only body properties are pinned still gets a builder.
+*/
+var withPinnedBody = args => {
+  const {
+    build,
+    pinned
+  } = args;
+  if (Object.keys(pinned).length === 0) return build;
+  return values => {
+    return {
+      ...(build ? build(values) : {}),
+      ...pinned
+    };
+  };
+};
 var isPlainObject$1 = value => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -505,6 +556,94 @@ var collectServerManagedParameters = args => {
   });
 };
 
+//#endregion
+//#region src/body.ts
+var resolveBodySchema = args => {
+  const rawBodySchema = args.requestBody?.content?.["application/json"]?.schema;
+  return resolveSchema(dereferenceSchema(rawBodySchema, args.spec, args.documents), args.spec, args.documents);
+};
+/**
+* snake_case names of every top-level property an operation's request schema
+* declares, including server-managed ones.
+*/
+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 toArgName = args.toArgName ?? snakeToCamel;
+  const bodySchema = resolveBodySchema(args);
+  if (!bodySchema?.properties) return [];
+  return Object.entries(bodySchema.properties).filter(([, value]) => {
+    return !readServerManaged({
+      node: value,
+      extension: args.serverManagedExtension
+    }).managed;
+  }).map(([key, value]) => {
+    const val = flattenSingleAllOf(value);
+    return {
+      snakeName: key,
+      argName: toArgName(key),
+      description: typeof val.description === "string" ? val.description : "",
+      required: (bodySchema.required || []).includes(key),
+      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,
+      allOf: Array.isArray(val.allOf) ? val.allOf : void 0
+    };
+  });
+};
+/**
+* The value each server-managed body property pins, typed by its schema and
+* keyed by its spec name. A property whose extension is not a string pins
+* nothing: it is only hidden, for the consumer to fill.
+*/
+var extractPinnedBody = args => {
+  const bodySchema = resolveBodySchema(args);
+  const pinned = {};
+  for (const [key, value] of Object.entries(bodySchema?.properties ?? {})) {
+    const node = value;
+    const {
+      value: pin
+    } = readServerManaged({
+      node,
+      extension: args.serverManagedExtension
+    });
+    if (pin === void 0) continue;
+    pinned[key] = typedPin({
+      value: pin,
+      type: flattenSingleAllOf(node).type,
+      where: `${args.operationId} body property '${key}'`
+    });
+  }
+  return pinned;
+};
+
 //#endregion
 //#region src/toolDefinitions.ts
 /** Converts a camelCase `operationId` to a kebab-case tool name. */
@@ -605,66 +744,6 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     } : {})
   };
 };
-var resolveBodySchema = args => {
-  const rawBodySchema = args.requestBody?.content?.["application/json"]?.schema;
-  return resolveSchema(dereferenceSchema(rawBodySchema, args.spec, args.documents), args.spec, args.documents);
-};
-/**
-* snake_case names of every top-level property an operation's request schema
-* declares, including server-managed ones.
-*/
-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 toArgName = args.toArgName ?? snakeToCamel;
-  const bodySchema = resolveBodySchema(args);
-  if (!bodySchema?.properties) return [];
-  return Object.entries(bodySchema.properties).filter(([, value]) => {
-    return !readServerManaged({
-      node: value,
-      extension: args.serverManagedExtension
-    }).managed;
-  }).map(([key, value]) => {
-    const val = flattenSingleAllOf(value);
-    return {
-      snakeName: key,
-      argName: toArgName(key),
-      description: typeof val.description === "string" ? val.description : "",
-      required: (bodySchema.required || []).includes(key),
-      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,
-      allOf: Array.isArray(val.allOf) ? val.allOf : void 0
-    };
-  });
-};
 /** Collects every `x-` prefixed extension declared on the operation. */
 var extractExtensions = operation => {
   const extensions = {};
@@ -697,11 +776,14 @@ var processOperation = args => {
     toArgName,
     serverManagedExtension
   });
-  const bodyProps = extractBodyProps({
+  const bodyArgs = {
     requestBody: args.operation.requestBody,
     spec: args.spec,
     serverManagedExtension,
-    documents,
+    documents
+  };
+  const bodyProps = extractBodyProps({
+    ...bodyArgs,
     toArgName
   });
   const inputSchema = buildInputSchema(pathParams, queryParams, bodyProps);
@@ -710,11 +792,6 @@ var processOperation = args => {
     queryParams
   });
   const pinned = pinnedArgs(serverManagedParameters);
-  const acceptedBodyFields = extractAcceptedBodyFields({
-    requestBody: args.operation.requestBody,
-    spec: args.spec,
-    documents
-  });
   return {
     name: toolName,
     description: sanitizeDescription(args.operation.description),
@@ -730,8 +807,14 @@ var processOperation = args => {
       build: buildQueryFn(queryParams),
       pinned
     }),
-    body: buildBodyFn(bodyProps),
-    acceptedBodyFields,
+    body: withPinnedBody({
+      build: buildBodyFn(bodyProps),
+      pinned: extractPinnedBody({
+        ...bodyArgs,
+        operationId: args.operation.operationId
+      })
+    }),
+    acceptedBodyFields: extractAcceptedBodyFields(bodyArgs),
     extensions: extractExtensions(args.operation),
     serverManagedParameters
   };
@@ -893,6 +976,7 @@ exports.dereferenceSchema = dereferenceSchema;
 exports.extractAcceptedBodyFields = extractAcceptedBodyFields;
 exports.extractBodyProps = extractBodyProps;
 exports.extractPathParams = extractPathParams;
+exports.extractPinnedBody = extractPinnedBody;
 exports.extractQueryParams = extractQueryParams;
 exports.getJsonSchemaType = getJsonSchemaType;
 exports.openApiToToolDefinitions = openApiToToolDefinitions;

package/dist/index.d.cts

@@ -232,6 +232,47 @@ declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
   pinnedValue?: string;
 }>;
 //#endregion
+//#region src/body.d.ts
+/**
+ * snake_case names of every top-level property an operation's request schema
+ * declares, including server-managed ones.
+ */
+declare const extractAcceptedBodyFields: (args: {
+  requestBody?: RequestBodySpec;
+  spec: OpenApiSpec;
+  documents?: OpenApiDocuments;
+}) => string[];
+declare const extractBodyProps: (args: {
+  requestBody?: RequestBodySpec;
+  spec: OpenApiSpec;
+  serverManagedExtension: ServerManagedExtension;
+  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
+  toArgName?: ToArgName;
+}) => Array<{
+  snakeName: string;
+  argName: string;
+  description: string;
+  required: boolean;
+  type?: string;
+  items?: unknown;
+  nullable: boolean;
+  oneOf?: unknown[];
+  anyOf?: unknown[];
+  allOf?: unknown[];
+}>;
+/**
+ * The value each server-managed body property pins, typed by its schema and
+ * keyed by its spec name. A property whose extension is not a string pins
+ * nothing: it is only hidden, for the consumer to fill.
+ */
+declare const extractPinnedBody: (args: {
+  requestBody?: RequestBodySpec;
+  spec: OpenApiSpec;
+  serverManagedExtension: ServerManagedExtension;
+  documents?: OpenApiDocuments;
+  operationId: string;
+}) => Record<string, string | number | boolean>;
+//#endregion
 //#region src/registerOpenApiTools.d.ts
 /** The resolved HTTP request a tool call maps to, before transport concerns. */
 interface ResolvedRequest {
@@ -417,33 +458,6 @@ declare const buildInputSchema: (pathParams: Array<{
   anyOf?: unknown[];
   allOf?: unknown[];
 }>) => JsonObjectSchema;
-/**
- * snake_case names of every top-level property an operation's request schema
- * declares, including server-managed ones.
- */
-declare const extractAcceptedBodyFields: (args: {
-  requestBody?: RequestBodySpec;
-  spec: OpenApiSpec;
-  documents?: OpenApiDocuments;
-}) => string[];
-declare const extractBodyProps: (args: {
-  requestBody?: RequestBodySpec;
-  spec: OpenApiSpec;
-  serverManagedExtension: ServerManagedExtension;
-  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
-  toArgName?: ToArgName;
-}) => Array<{
-  snakeName: string;
-  argName: string;
-  description: string;
-  required: boolean;
-  type?: string;
-  items?: unknown;
-  nullable: boolean;
-  oneOf?: unknown[];
-  anyOf?: unknown[];
-  allOf?: unknown[];
-}>;
 declare const processOperation: (args: {
   pathTemplate: string;
   method: string;
@@ -484,4 +498,4 @@ declare const openApiToToolDefinitions: (args: {
   options?: OpenApiToToolsOptions;
 }) => ToolDefinition[];
 //#endregion
-export { DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, NO_CONTENT_TEXT, type OpenApiDocuments, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type QueryParamSerialization, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedParameter, type ResolvedRequest, type ResolvedToolOptions, type ServerManagedParameter, 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, NO_CONTENT_TEXT, type OpenApiDocuments, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type QueryParamSerialization, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedParameter, type ResolvedRequest, type ResolvedToolOptions, type ServerManagedParameter, type ToolDefinition, buildBodyFn, buildInputSchema, buildPathFn, buildQueryFn, dereferenceSchema, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractPinnedBody, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, operationIdToToolName, processOperation, processPath, registerOpenApiTools, resolveParameter, resolveSchema, snakeToCamel };

package/dist/index.d.mts

@@ -232,6 +232,47 @@ declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
   pinnedValue?: string;
 }>;
 //#endregion
+//#region src/body.d.ts
+/**
+ * snake_case names of every top-level property an operation's request schema
+ * declares, including server-managed ones.
+ */
+declare const extractAcceptedBodyFields: (args: {
+  requestBody?: RequestBodySpec;
+  spec: OpenApiSpec;
+  documents?: OpenApiDocuments;
+}) => string[];
+declare const extractBodyProps: (args: {
+  requestBody?: RequestBodySpec;
+  spec: OpenApiSpec;
+  serverManagedExtension: ServerManagedExtension;
+  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
+  toArgName?: ToArgName;
+}) => Array<{
+  snakeName: string;
+  argName: string;
+  description: string;
+  required: boolean;
+  type?: string;
+  items?: unknown;
+  nullable: boolean;
+  oneOf?: unknown[];
+  anyOf?: unknown[];
+  allOf?: unknown[];
+}>;
+/**
+ * The value each server-managed body property pins, typed by its schema and
+ * keyed by its spec name. A property whose extension is not a string pins
+ * nothing: it is only hidden, for the consumer to fill.
+ */
+declare const extractPinnedBody: (args: {
+  requestBody?: RequestBodySpec;
+  spec: OpenApiSpec;
+  serverManagedExtension: ServerManagedExtension;
+  documents?: OpenApiDocuments;
+  operationId: string;
+}) => Record<string, string | number | boolean>;
+//#endregion
 //#region src/registerOpenApiTools.d.ts
 /** The resolved HTTP request a tool call maps to, before transport concerns. */
 interface ResolvedRequest {
@@ -417,33 +458,6 @@ declare const buildInputSchema: (pathParams: Array<{
   anyOf?: unknown[];
   allOf?: unknown[];
 }>) => JsonObjectSchema;
-/**
- * snake_case names of every top-level property an operation's request schema
- * declares, including server-managed ones.
- */
-declare const extractAcceptedBodyFields: (args: {
-  requestBody?: RequestBodySpec;
-  spec: OpenApiSpec;
-  documents?: OpenApiDocuments;
-}) => string[];
-declare const extractBodyProps: (args: {
-  requestBody?: RequestBodySpec;
-  spec: OpenApiSpec;
-  serverManagedExtension: ServerManagedExtension;
-  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
-  toArgName?: ToArgName;
-}) => Array<{
-  snakeName: string;
-  argName: string;
-  description: string;
-  required: boolean;
-  type?: string;
-  items?: unknown;
-  nullable: boolean;
-  oneOf?: unknown[];
-  anyOf?: unknown[];
-  allOf?: unknown[];
-}>;
 declare const processOperation: (args: {
   pathTemplate: string;
   method: string;
@@ -484,4 +498,4 @@ declare const openApiToToolDefinitions: (args: {
   options?: OpenApiToToolsOptions;
 }) => ToolDefinition[];
 //#endregion
-export { DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, NO_CONTENT_TEXT, type OpenApiDocuments, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type QueryParamSerialization, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedParameter, type ResolvedRequest, type ResolvedToolOptions, type ServerManagedParameter, 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, NO_CONTENT_TEXT, type OpenApiDocuments, type OpenApiSpec, type OpenApiToToolsOptions, type OperationSpec, type QueryParamSerialization, type RegisterOpenApiToolsArgs, type RequestBodySpec, type ResolvedParameter, type ResolvedRequest, type ResolvedToolOptions, type ServerManagedParameter, type ToolDefinition, buildBodyFn, buildInputSchema, buildPathFn, buildQueryFn, dereferenceSchema, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractPinnedBody, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, operationIdToToolName, processOperation, processPath, registerOpenApiTools, resolveParameter, resolveSchema, snakeToCamel };

package/dist/index.mjs

@@ -365,6 +365,57 @@ var withPinned = args => {
     });
   };
 };
+var parseNumber = value => {
+  const parsed = Number(value);
+  return value.trim() !== "" && Number.isFinite(parsed) ? parsed : void 0;
+};
+/** Each JSON type a pin can hold, and how its text reads as that type. */
+var PIN_PARSERS = {
+  string: value => {
+    return value;
+  },
+  boolean: value => {
+    if (value === "true") return true;
+    if (value === "false") return false;
+  },
+  number: parseNumber,
+  integer: value => {
+    const parsed = parseNumber(value);
+    return parsed !== void 0 && Number.isInteger(parsed) ? parsed : void 0;
+  }
+};
+/**
+* Reads a pinned body value as the JSON type its schema declares. A body is
+* JSON, so `'true'` on a boolean must reach the API as `true`; a query string
+* carries the text either way. A pin the type cannot hold is a spec error.
+*/
+var typedPin = args => {
+  const {
+    value,
+    type,
+    where
+  } = args;
+  const typed = (typeof type === "string" ? PIN_PARSERS[type] : void 0)?.(value);
+  if (typed !== void 0) return typed;
+  throw new Error(`${where}: cannot pin '${value}' on a property of type ${JSON.stringify(type ?? "any")}; a pinned body property must be a boolean, integer, number or string that holds the value.`);
+};
+/**
+* Wraps a `body` builder so pinned values replace whatever the args carry. An
+* operation whose only body properties are pinned still gets a builder.
+*/
+var withPinnedBody = args => {
+  const {
+    build,
+    pinned
+  } = args;
+  if (Object.keys(pinned).length === 0) return build;
+  return values => {
+    return {
+      ...(build ? build(values) : {}),
+      ...pinned
+    };
+  };
+};
 var isPlainObject$1 = value => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -502,6 +553,94 @@ var collectServerManagedParameters = args => {
   });
 };
 
+//#endregion
+//#region src/body.ts
+var resolveBodySchema = args => {
+  const rawBodySchema = args.requestBody?.content?.["application/json"]?.schema;
+  return resolveSchema(dereferenceSchema(rawBodySchema, args.spec, args.documents), args.spec, args.documents);
+};
+/**
+* snake_case names of every top-level property an operation's request schema
+* declares, including server-managed ones.
+*/
+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 toArgName = args.toArgName ?? snakeToCamel;
+  const bodySchema = resolveBodySchema(args);
+  if (!bodySchema?.properties) return [];
+  return Object.entries(bodySchema.properties).filter(([, value]) => {
+    return !readServerManaged({
+      node: value,
+      extension: args.serverManagedExtension
+    }).managed;
+  }).map(([key, value]) => {
+    const val = flattenSingleAllOf(value);
+    return {
+      snakeName: key,
+      argName: toArgName(key),
+      description: typeof val.description === "string" ? val.description : "",
+      required: (bodySchema.required || []).includes(key),
+      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,
+      allOf: Array.isArray(val.allOf) ? val.allOf : void 0
+    };
+  });
+};
+/**
+* The value each server-managed body property pins, typed by its schema and
+* keyed by its spec name. A property whose extension is not a string pins
+* nothing: it is only hidden, for the consumer to fill.
+*/
+var extractPinnedBody = args => {
+  const bodySchema = resolveBodySchema(args);
+  const pinned = {};
+  for (const [key, value] of Object.entries(bodySchema?.properties ?? {})) {
+    const node = value;
+    const {
+      value: pin
+    } = readServerManaged({
+      node,
+      extension: args.serverManagedExtension
+    });
+    if (pin === void 0) continue;
+    pinned[key] = typedPin({
+      value: pin,
+      type: flattenSingleAllOf(node).type,
+      where: `${args.operationId} body property '${key}'`
+    });
+  }
+  return pinned;
+};
+
 //#endregion
 //#region src/toolDefinitions.ts
 /** Converts a camelCase `operationId` to a kebab-case tool name. */
@@ -602,66 +741,6 @@ var buildInputSchema = (pathParams, queryParams, bodyProps) => {
     } : {})
   };
 };
-var resolveBodySchema = args => {
-  const rawBodySchema = args.requestBody?.content?.["application/json"]?.schema;
-  return resolveSchema(dereferenceSchema(rawBodySchema, args.spec, args.documents), args.spec, args.documents);
-};
-/**
-* snake_case names of every top-level property an operation's request schema
-* declares, including server-managed ones.
-*/
-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 toArgName = args.toArgName ?? snakeToCamel;
-  const bodySchema = resolveBodySchema(args);
-  if (!bodySchema?.properties) return [];
-  return Object.entries(bodySchema.properties).filter(([, value]) => {
-    return !readServerManaged({
-      node: value,
-      extension: args.serverManagedExtension
-    }).managed;
-  }).map(([key, value]) => {
-    const val = flattenSingleAllOf(value);
-    return {
-      snakeName: key,
-      argName: toArgName(key),
-      description: typeof val.description === "string" ? val.description : "",
-      required: (bodySchema.required || []).includes(key),
-      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,
-      allOf: Array.isArray(val.allOf) ? val.allOf : void 0
-    };
-  });
-};
 /** Collects every `x-` prefixed extension declared on the operation. */
 var extractExtensions = operation => {
   const extensions = {};
@@ -694,11 +773,14 @@ var processOperation = args => {
     toArgName,
     serverManagedExtension
   });
-  const bodyProps = extractBodyProps({
+  const bodyArgs = {
     requestBody: args.operation.requestBody,
     spec: args.spec,
     serverManagedExtension,
-    documents,
+    documents
+  };
+  const bodyProps = extractBodyProps({
+    ...bodyArgs,
     toArgName
   });
   const inputSchema = buildInputSchema(pathParams, queryParams, bodyProps);
@@ -707,11 +789,6 @@ var processOperation = args => {
     queryParams
   });
   const pinned = pinnedArgs(serverManagedParameters);
-  const acceptedBodyFields = extractAcceptedBodyFields({
-    requestBody: args.operation.requestBody,
-    spec: args.spec,
-    documents
-  });
   return {
     name: toolName,
     description: sanitizeDescription(args.operation.description),
@@ -727,8 +804,14 @@ var processOperation = args => {
       build: buildQueryFn(queryParams),
       pinned
     }),
-    body: buildBodyFn(bodyProps),
-    acceptedBodyFields,
+    body: withPinnedBody({
+      build: buildBodyFn(bodyProps),
+      pinned: extractPinnedBody({
+        ...bodyArgs,
+        operationId: args.operation.operationId
+      })
+    }),
+    acceptedBodyFields: extractAcceptedBodyFields(bodyArgs),
     extensions: extractExtensions(args.operation),
     serverManagedParameters
   };
@@ -879,4 +962,4 @@ var registerOpenApiTools = args => {
 };
 
 //#endregion
-export { DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, NO_CONTENT_TEXT, 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, NO_CONTENT_TEXT, buildBodyFn, buildInputSchema, buildPathFn, buildQueryFn, dereferenceSchema, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractPinnedBody, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, operationIdToToolName, processOperation, processPath, registerOpenApiTools, resolveParameter, resolveSchema, snakeToCamel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp-openapi",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Generate Model Context Protocol (MCP) tools from an OpenAPI specification for @ttoss/http-server-mcp",
   "keywords": [
     "ai",
@@ -35,15 +35,15 @@
     "dist"
   ],
   "dependencies": {
-    "@ttoss/http-server-mcp": "^0.29.0"
+    "@ttoss/http-server-mcp": "^0.29.1"
   },
   "devDependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
     "jest": "^30.4.2",
     "supertest": "^7.2.2",
     "tsdown": "^0.22.2",
-    "@ttoss/config": "^1.38.0",
-    "@ttoss/http-server": "^0.8.1"
+    "@ttoss/http-server": "^0.9.0",
+    "@ttoss/config": "^1.39.0"
   },
   "publishConfig": {
     "access": "public",