@ttoss/http-server-mcp-openapi 0.8.9 → 0.9.0

package/dist/index.cjs

@@ -494,7 +494,7 @@ var managedFields = flag => {
 var extractPathParams = args => {
   const toArgName = args.toArgName ?? snakeToCamel;
   const flag = args.serverManagedExtension ?? "x-mcp-server-managed";
-  return dedupeByName((args.parameters || []).map(p => {
+  const params = (args.parameters || []).map(p => {
     return resolveParameter(p, args.spec, args.documents);
   }).filter(p => {
     return p.in === "path";
@@ -509,12 +509,13 @@ var extractPathParams = args => {
         extension: flag
       }))
     };
-  }));
+  });
+  return dedupeByName(params);
 };
 var extractQueryParams = args => {
   const toArgName = args.toArgName ?? snakeToCamel;
   const flag = args.serverManagedExtension ?? "x-mcp-server-managed";
-  return dedupeByName((args.parameters || []).map(p => {
+  const params = (args.parameters || []).map(p => {
     return resolveParameter(p, args.spec, args.documents);
   }).filter(p => {
     return p.in === "query";
@@ -533,7 +534,8 @@ var extractQueryParams = args => {
         extension: flag
       }))
     };
-  }));
+  });
+  return dedupeByName(params);
 };
 var collectServerManagedParameters = args => {
   return [...args.pathParams.map(p => {
@@ -564,7 +566,8 @@ var collectServerManagedParameters = args => {
 //#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);
+  const dereferencedBodySchema = dereferenceSchema(rawBodySchema, args.spec, args.documents);
+  return resolveSchema(dereferencedBodySchema, args.spec, args.documents);
 };
 /**
 * snake_case names of every top-level property an operation's request schema
@@ -654,10 +657,10 @@ var extractPinnedBody = args => {
 var isRecord = value => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
-var OPENAPI_ONLY_KEYWORDS = new Set(["discriminator", "example", "externalDocs", "xml"]);
-var SCHEMA_MAPS = new Set(["$defs", "definitions", "dependentSchemas", "patternProperties", "properties"]);
-var SCHEMA_VALUES = new Set(["additionalProperties", "contains", "else", "if", "items", "not", "propertyNames", "then", "unevaluatedItems", "unevaluatedProperties"]);
-var SCHEMA_LISTS = new Set(["anyOf", "oneOf", "prefixItems"]);
+var OPENAPI_ONLY_KEYWORDS = /* @__PURE__ */new Set(["discriminator", "example", "externalDocs", "xml"]);
+var SCHEMA_MAPS = /* @__PURE__ */new Set(["$defs", "definitions", "dependentSchemas", "patternProperties", "properties"]);
+var SCHEMA_VALUES = /* @__PURE__ */new Set(["additionalProperties", "contains", "else", "if", "items", "not", "propertyNames", "then", "unevaluatedItems", "unevaluatedProperties"]);
+var SCHEMA_LISTS = /* @__PURE__ */new Set(["anyOf", "oneOf", "prefixItems"]);
 /**
 * OpenAPI 3.0's `nullable: true` in JSON Schema: `'null'` joins the `type`,
 * and `null` joins an `enum`, which would otherwise still refuse it.
@@ -836,8 +839,9 @@ var createInProcessCallApi = ({
   toError = defaultToError
 }) => {
   return async request => {
+    const target = typeof app === "function" ? await app() : app;
     const response = await (0, _ttoss_http_server.dispatchInProcess)({
-      app: typeof app === "function" ? await app() : app,
+      app: target,
       method: request.method,
       path: request.url,
       headers: {

package/dist/index.d.cts

@@ -1,7 +1,6 @@
 
 import { JsonObjectSchema, Tool } from "@ttoss/http-server-mcp";
 import { App, InProcessResponse } from "@ttoss/http-server";
-
 //#region src/types.d.ts
 /** The JSON Schema primitive types this generator can derive from an OpenAPI `type`. */
 type JsonSchemaPrimitiveType = 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'object' | 'null';
@@ -134,8 +133,10 @@ interface OperationSpec {
     name?: string;
     in?: string;
     required?: boolean;
-    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`. */
+    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;
@@ -217,15 +218,16 @@ interface OpenApiToToolsOptions {
    * ```
    */
   describe?: (args: {
-    operation: OperationSpec; /** Uppercase HTTP method. */
+    operation: OperationSpec;
+    /** Uppercase HTTP method. */
     method: string;
     pathTemplate: string;
   }) => string;
 }
 /** {@link OpenApiToToolsOptions} with every default applied. */
 type ResolvedToolOptions = Required<Omit<OpenApiToToolsOptions, 'documents' | 'describe' | 'schemaDetail'>> & Pick<OpenApiToToolsOptions, 'documents' | 'describe' | 'schemaDetail'>;
-declare const DEFAULT_EXCLUDE_EXTENSION = "x-mcp-exclude";
-declare const DEFAULT_SERVER_MANAGED_EXTENSION = "x-mcp-server-managed";
+export declare const DEFAULT_EXCLUDE_EXTENSION = "x-mcp-exclude";
+export declare const DEFAULT_SERVER_MANAGED_EXTENSION = "x-mcp-server-managed";
 //#endregion
 //#region src/serverManaged.d.ts
 /** One extension name, or several that all mean "the server sets this". */
@@ -237,7 +239,7 @@ type ServerManagedExtension = string | string[];
  * names may be snake_case (`agent_id`) or kebab-case (`list-tools`); with the
  * default `argumentNames: 'camelCase'` both are folded into tool arguments.
  */
-declare const snakeToCamel: (str: string) => string;
+export declare const snakeToCamel: (str: string) => string;
 /** Maps a spec parameter or property name to a tool argument name. */
 type ToArgName = (name: string) => string;
 /** Arguments shared by the parameter extractors. */
@@ -247,25 +249,30 @@ type ExtractParamsArgs = {
     in?: string;
     [key: string]: unknown;
   }>;
-  spec: OpenApiSpec; /** Sibling documents cross-file `$ref`s resolve against. */
-  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
-  toArgName?: ToArgName; /** @default DEFAULT_SERVER_MANAGED_EXTENSION */
+  spec: OpenApiSpec;
+  /** Sibling documents cross-file `$ref`s resolve against. */
+  documents?: OpenApiDocuments;
+  /** Maps a spec name to its tool argument name. @default snakeToCamel */
+  toArgName?: ToArgName;
+  /** @default DEFAULT_SERVER_MANAGED_EXTENSION */
   serverManagedExtension?: ServerManagedExtension;
 };
-declare const extractPathParams: (args: ExtractParamsArgs) => Array<{
+export declare const extractPathParams: (args: ExtractParamsArgs) => Array<{
   name: string;
   argName: string;
-  description?: string; /** The parameter's schema with every `$ref` inlined. */
+  description?: string;
+  /** The parameter's schema with every `$ref` inlined. */
   schema?: Record<string, unknown>;
   serverManaged: boolean;
   pinnedValue?: string;
 }>;
-declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
+export declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
   name: string;
   argName: string;
   description: string;
   required: boolean;
-  type: string; /** The parameter's schema with every `$ref` inlined. */
+  type: string;
+  /** The parameter's schema with every `$ref` inlined. */
   schema?: Record<string, unknown>;
   style?: string;
   explode?: boolean;
@@ -278,16 +285,17 @@ declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
  * snake_case names of every top-level property an operation's request schema
  * declares, including server-managed ones.
  */
-declare const extractAcceptedBodyFields: (args: {
+export declare const extractAcceptedBodyFields: (args: {
   requestBody?: RequestBodySpec;
   spec: OpenApiSpec;
   documents?: OpenApiDocuments;
 }) => string[];
-declare const extractBodyProps: (args: {
+export declare const extractBodyProps: (args: {
   requestBody?: RequestBodySpec;
   spec: OpenApiSpec;
   serverManagedExtension: ServerManagedExtension;
-  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
+  documents?: OpenApiDocuments;
+  /** Maps a spec name to its tool argument name. @default snakeToCamel */
   toArgName?: ToArgName;
 }) => Array<{
   snakeName: string;
@@ -299,7 +307,8 @@ declare const extractBodyProps: (args: {
   nullable: boolean;
   oneOf?: unknown[];
   anyOf?: unknown[];
-  allOf?: unknown[]; /** The property's whole schema, with every `$ref` inlined. */
+  allOf?: unknown[];
+  /** The property's whole schema, with every `$ref` inlined. */
   schema: Record<string, unknown>;
 }>;
 /**
@@ -307,7 +316,7 @@ declare const extractBodyProps: (args: {
  * 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: {
+export declare const extractPinnedBody: (args: {
   requestBody?: RequestBodySpec;
   spec: OpenApiSpec;
   serverManagedExtension: ServerManagedExtension;
@@ -324,7 +333,7 @@ declare const extractPinnedBody: (args: {
  * merged, `nullable` becomes a `'null'` type, and OpenAPI-only keywords and
  * `x-` extensions are dropped. Descriptions are kept verbatim.
  */
-declare const toToolSchema: (value: unknown) => unknown;
+export declare const toToolSchema: (value: unknown) => unknown;
 type FullParam = {
   argName: string;
   required?: boolean;
@@ -342,7 +351,7 @@ type FullBodyProp = {
  * and body property with its whole schema. `properties` is always present,
  * even when empty, because some clients refuse an object schema without it.
  */
-declare const buildFullInputSchema: (args: {
+export declare const buildFullInputSchema: (args: {
   pathParams: FullParam[];
   queryParams: FullParam[];
   bodyProps: FullBodyProp[];
@@ -449,7 +458,7 @@ interface OpenApiTool extends Tool {
   definition: ToolDefinition;
 }
 /** The text the default `toText` answers when the API returned no body. */
-declare const NO_CONTENT_TEXT = "Succeeded. The operation returned no content.";
+export declare const NO_CONTENT_TEXT = "Succeeded. The operation returned no content.";
 /**
  * Derives MCP tools from OpenAPI document(s). Each tool's handler resolves
  * the incoming args into a concrete HTTP request and delegates execution to
@@ -480,7 +489,7 @@ declare const NO_CONTENT_TEXT = "Succeeded. The operation returned no content.";
  * registerTools({ server, tools });
  * ```
  */
-declare const openApiToTools: (args: OpenApiToToolsArgs) => OpenApiTool[];
+export declare const openApiToTools: (args: OpenApiToToolsArgs) => OpenApiTool[];
 //#endregion
 //#region src/inProcessCallApi.d.ts
 interface CreateInProcessCallApiArgs {
@@ -507,7 +516,7 @@ interface CreateInProcessCallApiArgs {
  * `{ error: { code, message } }` (as `code: message`) or `{ message: '…' }`.
  * `null` when the body is none of them.
  */
-declare const errorMessageOf: (body: unknown) => string | null;
+export declare const errorMessageOf: (body: unknown) => string | null;
 /**
  * A `callApi` for {@link openApiToTools} that serves each tool call
  * against the REST app in this same process, with no socket: validation,
@@ -527,11 +536,7 @@ declare const errorMessageOf: (body: unknown) => string | null;
  * });
  * ```
  */
-declare const createInProcessCallApi: ({
-  app,
-  headers,
-  toError
-}: CreateInProcessCallApiArgs) => ((request: ResolvedRequest) => Promise<unknown>);
+export declare const createInProcessCallApi: ({ app, headers, toError }: CreateInProcessCallApiArgs) => ((request: ResolvedRequest) => Promise<unknown>);
 //#endregion
 //#region src/schema.d.ts
 type ResolvedSchema = {
@@ -549,13 +554,13 @@ type ResolvedSchema = {
  *
  * Refs into other files resolve against `documents`; see {@link OpenApiDocuments}.
  */
-declare const dereferenceSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => Record<string, unknown> | undefined;
+export declare const dereferenceSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => Record<string, unknown> | undefined;
 /**
  * Resolves a schema down to a single object shape: follows a top-level `$ref`
  * and merges `oneOf` / `anyOf` alternatives (union of properties, intersection
  * of `required`) so the caller sees one flat property set.
  */
-declare const resolveSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedSchema;
+export declare const resolveSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedSchema;
 /** A parameter object after its `$ref` (if any) is followed. */
 type ResolvedParameter = {
   name?: string;
@@ -576,17 +581,19 @@ type ResolvedParameter = {
  * Follows a parameter `$ref` — into `components.parameters`, or into another
  * file through `documents` — if present.
  */
-declare const resolveParameter: (param: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedParameter;
+export declare const resolveParameter: (param: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedParameter;
 /** Builds a function that substitutes path params into the path template. */
-declare const buildPathFn: (pathTemplate: string, pathParams: Array<{
+export declare const buildPathFn: (pathTemplate: string, pathParams: Array<{
   name: string;
   argName: string;
 }>) => ((args: Record<string, unknown>) => string);
 /** Query parameter with the OpenAPI serialisation rules declared for it. */
 type QueryParamSerialization = {
   name: string;
-  argName: string; /** OpenAPI `style` (`form`, `deepObject`, `spaceDelimited`, `pipeDelimited`). */
-  style?: string; /** OpenAPI `explode`. Defaults to `true` for `form`, `false` otherwise. */
+  argName: string;
+  /** OpenAPI `style` (`form`, `deepObject`, `spaceDelimited`, `pipeDelimited`). */
+  style?: string;
+  /** OpenAPI `explode`. Defaults to `true` for `form`, `false` otherwise. */
   explode?: boolean;
 };
 /**
@@ -594,21 +601,21 @@ type QueryParamSerialization = {
  * (including the leading `?`), honouring each param's OpenAPI `style` and
  * `explode`. Returns `undefined` when the op has no query params.
  */
-declare const buildQueryFn: (queryParams: QueryParamSerialization[]) => ((args: Record<string, unknown>) => string) | undefined;
+export declare const buildQueryFn: (queryParams: QueryParamSerialization[]) => ((args: Record<string, unknown>) => string) | undefined;
 /**
  * Builds a function that maps tool args back to a request body keyed by the
  * spec's property names, skipping `undefined` args. Returns `undefined` when the op has no body.
  */
-declare const buildBodyFn: (bodyProps: Array<{
+export declare const buildBodyFn: (bodyProps: Array<{
   snakeName: string;
   argName: string;
 }>) => ((args: Record<string, unknown>) => Record<string, unknown>) | undefined;
 //#endregion
 //#region src/toolDefinitions.d.ts
 /** Converts a camelCase `operationId` to a kebab-case tool name. */
-declare const operationIdToToolName: (operationId: string) => string;
-declare const getJsonSchemaType: (schemaType: string | undefined) => JsonSchemaProperty["type"];
-declare const buildInputSchema: (pathParams: Array<{
+export declare const operationIdToToolName: (operationId: string) => string;
+export declare const getJsonSchemaType: (schemaType: string | undefined) => JsonSchemaProperty["type"];
+export declare const buildInputSchema: (pathParams: Array<{
   name: string;
   argName: string;
   description?: string;
@@ -632,7 +639,7 @@ declare const buildInputSchema: (pathParams: Array<{
   anyOf?: unknown[];
   allOf?: unknown[];
 }>) => JsonObjectSchema;
-declare const processOperation: (args: {
+export declare const processOperation: (args: {
   pathTemplate: string;
   method: string;
   operation: OperationSpec;
@@ -649,7 +656,7 @@ declare const processOperation: (args: {
     [key: string]: unknown;
   }>;
 }) => ToolDefinition | null;
-declare const processPath: (args: {
+export declare const processPath: (args: {
   pathTemplate: string;
   pathItem: Record<string, OperationSpec>;
   spec: OpenApiSpec;
@@ -667,9 +674,9 @@ declare const processPath: (args: {
  * const tools = openApiToToolDefinitions({ spec: myOpenApiDocument });
  * ```
  */
-declare const openApiToToolDefinitions: (args: {
+export declare const openApiToToolDefinitions: (args: {
   spec: OpenApiSpec | OpenApiSpec[];
   options?: OpenApiToToolsOptions;
 }) => ToolDefinition[];
 //#endregion
-export { type CreateInProcessCallApiArgs, DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, NO_CONTENT_TEXT, type OpenApiDocuments, type OpenApiSpec, type OpenApiToToolsArgs, type OpenApiToToolsOptions, type OpenApiTool, type OperationSpec, type QueryParamSerialization, type RequestBodySpec, type ResolvedParameter, type ResolvedRequest, type ResolvedToolOptions, type ServerManagedParameter, type ToolDefinition, buildBodyFn, buildFullInputSchema, buildInputSchema, buildPathFn, buildQueryFn, createInProcessCallApi, dereferenceSchema, errorMessageOf, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractPinnedBody, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, openApiToTools, operationIdToToolName, processOperation, processPath, resolveParameter, resolveSchema, snakeToCamel, toToolSchema };
+export type { CreateInProcessCallApiArgs, JsonSchemaProperty, OpenApiDocuments, OpenApiSpec, OpenApiToToolsArgs, OpenApiToToolsOptions, OpenApiTool, OperationSpec, QueryParamSerialization, RequestBodySpec, ResolvedParameter, ResolvedRequest, ResolvedToolOptions, ServerManagedParameter, ToolDefinition };

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 
 import { App, InProcessResponse } from "@ttoss/http-server";
 import { JsonObjectSchema, Tool } from "@ttoss/http-server-mcp";
-
 //#region src/types.d.ts
 /** The JSON Schema primitive types this generator can derive from an OpenAPI `type`. */
 type JsonSchemaPrimitiveType = 'string' | 'number' | 'boolean' | 'array' | 'integer' | 'object' | 'null';
@@ -134,8 +133,10 @@ interface OperationSpec {
     name?: string;
     in?: string;
     required?: boolean;
-    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`. */
+    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;
@@ -217,15 +218,16 @@ interface OpenApiToToolsOptions {
    * ```
    */
   describe?: (args: {
-    operation: OperationSpec; /** Uppercase HTTP method. */
+    operation: OperationSpec;
+    /** Uppercase HTTP method. */
     method: string;
     pathTemplate: string;
   }) => string;
 }
 /** {@link OpenApiToToolsOptions} with every default applied. */
 type ResolvedToolOptions = Required<Omit<OpenApiToToolsOptions, 'documents' | 'describe' | 'schemaDetail'>> & Pick<OpenApiToToolsOptions, 'documents' | 'describe' | 'schemaDetail'>;
-declare const DEFAULT_EXCLUDE_EXTENSION = "x-mcp-exclude";
-declare const DEFAULT_SERVER_MANAGED_EXTENSION = "x-mcp-server-managed";
+export declare const DEFAULT_EXCLUDE_EXTENSION = "x-mcp-exclude";
+export declare const DEFAULT_SERVER_MANAGED_EXTENSION = "x-mcp-server-managed";
 //#endregion
 //#region src/serverManaged.d.ts
 /** One extension name, or several that all mean "the server sets this". */
@@ -237,7 +239,7 @@ type ServerManagedExtension = string | string[];
  * names may be snake_case (`agent_id`) or kebab-case (`list-tools`); with the
  * default `argumentNames: 'camelCase'` both are folded into tool arguments.
  */
-declare const snakeToCamel: (str: string) => string;
+export declare const snakeToCamel: (str: string) => string;
 /** Maps a spec parameter or property name to a tool argument name. */
 type ToArgName = (name: string) => string;
 /** Arguments shared by the parameter extractors. */
@@ -247,25 +249,30 @@ type ExtractParamsArgs = {
     in?: string;
     [key: string]: unknown;
   }>;
-  spec: OpenApiSpec; /** Sibling documents cross-file `$ref`s resolve against. */
-  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
-  toArgName?: ToArgName; /** @default DEFAULT_SERVER_MANAGED_EXTENSION */
+  spec: OpenApiSpec;
+  /** Sibling documents cross-file `$ref`s resolve against. */
+  documents?: OpenApiDocuments;
+  /** Maps a spec name to its tool argument name. @default snakeToCamel */
+  toArgName?: ToArgName;
+  /** @default DEFAULT_SERVER_MANAGED_EXTENSION */
   serverManagedExtension?: ServerManagedExtension;
 };
-declare const extractPathParams: (args: ExtractParamsArgs) => Array<{
+export declare const extractPathParams: (args: ExtractParamsArgs) => Array<{
   name: string;
   argName: string;
-  description?: string; /** The parameter's schema with every `$ref` inlined. */
+  description?: string;
+  /** The parameter's schema with every `$ref` inlined. */
   schema?: Record<string, unknown>;
   serverManaged: boolean;
   pinnedValue?: string;
 }>;
-declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
+export declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
   name: string;
   argName: string;
   description: string;
   required: boolean;
-  type: string; /** The parameter's schema with every `$ref` inlined. */
+  type: string;
+  /** The parameter's schema with every `$ref` inlined. */
   schema?: Record<string, unknown>;
   style?: string;
   explode?: boolean;
@@ -278,16 +285,17 @@ declare const extractQueryParams: (args: ExtractParamsArgs) => Array<{
  * snake_case names of every top-level property an operation's request schema
  * declares, including server-managed ones.
  */
-declare const extractAcceptedBodyFields: (args: {
+export declare const extractAcceptedBodyFields: (args: {
   requestBody?: RequestBodySpec;
   spec: OpenApiSpec;
   documents?: OpenApiDocuments;
 }) => string[];
-declare const extractBodyProps: (args: {
+export declare const extractBodyProps: (args: {
   requestBody?: RequestBodySpec;
   spec: OpenApiSpec;
   serverManagedExtension: ServerManagedExtension;
-  documents?: OpenApiDocuments; /** Maps a spec name to its tool argument name. @default snakeToCamel */
+  documents?: OpenApiDocuments;
+  /** Maps a spec name to its tool argument name. @default snakeToCamel */
   toArgName?: ToArgName;
 }) => Array<{
   snakeName: string;
@@ -299,7 +307,8 @@ declare const extractBodyProps: (args: {
   nullable: boolean;
   oneOf?: unknown[];
   anyOf?: unknown[];
-  allOf?: unknown[]; /** The property's whole schema, with every `$ref` inlined. */
+  allOf?: unknown[];
+  /** The property's whole schema, with every `$ref` inlined. */
   schema: Record<string, unknown>;
 }>;
 /**
@@ -307,7 +316,7 @@ declare const extractBodyProps: (args: {
  * 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: {
+export declare const extractPinnedBody: (args: {
   requestBody?: RequestBodySpec;
   spec: OpenApiSpec;
   serverManagedExtension: ServerManagedExtension;
@@ -324,7 +333,7 @@ declare const extractPinnedBody: (args: {
  * merged, `nullable` becomes a `'null'` type, and OpenAPI-only keywords and
  * `x-` extensions are dropped. Descriptions are kept verbatim.
  */
-declare const toToolSchema: (value: unknown) => unknown;
+export declare const toToolSchema: (value: unknown) => unknown;
 type FullParam = {
   argName: string;
   required?: boolean;
@@ -342,7 +351,7 @@ type FullBodyProp = {
  * and body property with its whole schema. `properties` is always present,
  * even when empty, because some clients refuse an object schema without it.
  */
-declare const buildFullInputSchema: (args: {
+export declare const buildFullInputSchema: (args: {
   pathParams: FullParam[];
   queryParams: FullParam[];
   bodyProps: FullBodyProp[];
@@ -449,7 +458,7 @@ interface OpenApiTool extends Tool {
   definition: ToolDefinition;
 }
 /** The text the default `toText` answers when the API returned no body. */
-declare const NO_CONTENT_TEXT = "Succeeded. The operation returned no content.";
+export declare const NO_CONTENT_TEXT = "Succeeded. The operation returned no content.";
 /**
  * Derives MCP tools from OpenAPI document(s). Each tool's handler resolves
  * the incoming args into a concrete HTTP request and delegates execution to
@@ -480,7 +489,7 @@ declare const NO_CONTENT_TEXT = "Succeeded. The operation returned no content.";
  * registerTools({ server, tools });
  * ```
  */
-declare const openApiToTools: (args: OpenApiToToolsArgs) => OpenApiTool[];
+export declare const openApiToTools: (args: OpenApiToToolsArgs) => OpenApiTool[];
 //#endregion
 //#region src/inProcessCallApi.d.ts
 interface CreateInProcessCallApiArgs {
@@ -507,7 +516,7 @@ interface CreateInProcessCallApiArgs {
  * `{ error: { code, message } }` (as `code: message`) or `{ message: '…' }`.
  * `null` when the body is none of them.
  */
-declare const errorMessageOf: (body: unknown) => string | null;
+export declare const errorMessageOf: (body: unknown) => string | null;
 /**
  * A `callApi` for {@link openApiToTools} that serves each tool call
  * against the REST app in this same process, with no socket: validation,
@@ -527,11 +536,7 @@ declare const errorMessageOf: (body: unknown) => string | null;
  * });
  * ```
  */
-declare const createInProcessCallApi: ({
-  app,
-  headers,
-  toError
-}: CreateInProcessCallApiArgs) => ((request: ResolvedRequest) => Promise<unknown>);
+export declare const createInProcessCallApi: ({ app, headers, toError }: CreateInProcessCallApiArgs) => ((request: ResolvedRequest) => Promise<unknown>);
 //#endregion
 //#region src/schema.d.ts
 type ResolvedSchema = {
@@ -549,13 +554,13 @@ type ResolvedSchema = {
  *
  * Refs into other files resolve against `documents`; see {@link OpenApiDocuments}.
  */
-declare const dereferenceSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => Record<string, unknown> | undefined;
+export declare const dereferenceSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => Record<string, unknown> | undefined;
 /**
  * Resolves a schema down to a single object shape: follows a top-level `$ref`
  * and merges `oneOf` / `anyOf` alternatives (union of properties, intersection
  * of `required`) so the caller sees one flat property set.
  */
-declare const resolveSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedSchema;
+export declare const resolveSchema: (schema: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedSchema;
 /** A parameter object after its `$ref` (if any) is followed. */
 type ResolvedParameter = {
   name?: string;
@@ -576,17 +581,19 @@ type ResolvedParameter = {
  * Follows a parameter `$ref` — into `components.parameters`, or into another
  * file through `documents` — if present.
  */
-declare const resolveParameter: (param: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedParameter;
+export declare const resolveParameter: (param: Record<string, unknown> | undefined, spec: OpenApiSpec, documents?: OpenApiDocuments) => ResolvedParameter;
 /** Builds a function that substitutes path params into the path template. */
-declare const buildPathFn: (pathTemplate: string, pathParams: Array<{
+export declare const buildPathFn: (pathTemplate: string, pathParams: Array<{
   name: string;
   argName: string;
 }>) => ((args: Record<string, unknown>) => string);
 /** Query parameter with the OpenAPI serialisation rules declared for it. */
 type QueryParamSerialization = {
   name: string;
-  argName: string; /** OpenAPI `style` (`form`, `deepObject`, `spaceDelimited`, `pipeDelimited`). */
-  style?: string; /** OpenAPI `explode`. Defaults to `true` for `form`, `false` otherwise. */
+  argName: string;
+  /** OpenAPI `style` (`form`, `deepObject`, `spaceDelimited`, `pipeDelimited`). */
+  style?: string;
+  /** OpenAPI `explode`. Defaults to `true` for `form`, `false` otherwise. */
   explode?: boolean;
 };
 /**
@@ -594,21 +601,21 @@ type QueryParamSerialization = {
  * (including the leading `?`), honouring each param's OpenAPI `style` and
  * `explode`. Returns `undefined` when the op has no query params.
  */
-declare const buildQueryFn: (queryParams: QueryParamSerialization[]) => ((args: Record<string, unknown>) => string) | undefined;
+export declare const buildQueryFn: (queryParams: QueryParamSerialization[]) => ((args: Record<string, unknown>) => string) | undefined;
 /**
  * Builds a function that maps tool args back to a request body keyed by the
  * spec's property names, skipping `undefined` args. Returns `undefined` when the op has no body.
  */
-declare const buildBodyFn: (bodyProps: Array<{
+export declare const buildBodyFn: (bodyProps: Array<{
   snakeName: string;
   argName: string;
 }>) => ((args: Record<string, unknown>) => Record<string, unknown>) | undefined;
 //#endregion
 //#region src/toolDefinitions.d.ts
 /** Converts a camelCase `operationId` to a kebab-case tool name. */
-declare const operationIdToToolName: (operationId: string) => string;
-declare const getJsonSchemaType: (schemaType: string | undefined) => JsonSchemaProperty["type"];
-declare const buildInputSchema: (pathParams: Array<{
+export declare const operationIdToToolName: (operationId: string) => string;
+export declare const getJsonSchemaType: (schemaType: string | undefined) => JsonSchemaProperty["type"];
+export declare const buildInputSchema: (pathParams: Array<{
   name: string;
   argName: string;
   description?: string;
@@ -632,7 +639,7 @@ declare const buildInputSchema: (pathParams: Array<{
   anyOf?: unknown[];
   allOf?: unknown[];
 }>) => JsonObjectSchema;
-declare const processOperation: (args: {
+export declare const processOperation: (args: {
   pathTemplate: string;
   method: string;
   operation: OperationSpec;
@@ -649,7 +656,7 @@ declare const processOperation: (args: {
     [key: string]: unknown;
   }>;
 }) => ToolDefinition | null;
-declare const processPath: (args: {
+export declare const processPath: (args: {
   pathTemplate: string;
   pathItem: Record<string, OperationSpec>;
   spec: OpenApiSpec;
@@ -667,9 +674,9 @@ declare const processPath: (args: {
  * const tools = openApiToToolDefinitions({ spec: myOpenApiDocument });
  * ```
  */
-declare const openApiToToolDefinitions: (args: {
+export declare const openApiToToolDefinitions: (args: {
   spec: OpenApiSpec | OpenApiSpec[];
   options?: OpenApiToToolsOptions;
 }) => ToolDefinition[];
 //#endregion
-export { type CreateInProcessCallApiArgs, DEFAULT_EXCLUDE_EXTENSION, DEFAULT_SERVER_MANAGED_EXTENSION, type JsonSchemaProperty, NO_CONTENT_TEXT, type OpenApiDocuments, type OpenApiSpec, type OpenApiToToolsArgs, type OpenApiToToolsOptions, type OpenApiTool, type OperationSpec, type QueryParamSerialization, type RequestBodySpec, type ResolvedParameter, type ResolvedRequest, type ResolvedToolOptions, type ServerManagedParameter, type ToolDefinition, buildBodyFn, buildFullInputSchema, buildInputSchema, buildPathFn, buildQueryFn, createInProcessCallApi, dereferenceSchema, errorMessageOf, extractAcceptedBodyFields, extractBodyProps, extractPathParams, extractPinnedBody, extractQueryParams, getJsonSchemaType, openApiToToolDefinitions, openApiToTools, operationIdToToolName, processOperation, processPath, resolveParameter, resolveSchema, snakeToCamel, toToolSchema };
+export type { CreateInProcessCallApiArgs, JsonSchemaProperty, OpenApiDocuments, OpenApiSpec, OpenApiToToolsArgs, OpenApiToToolsOptions, OpenApiTool, OperationSpec, QueryParamSerialization, RequestBodySpec, ResolvedParameter, ResolvedRequest, ResolvedToolOptions, ServerManagedParameter, ToolDefinition };

package/dist/index.mjs

@@ -491,7 +491,7 @@ var managedFields = flag => {
 var extractPathParams = args => {
   const toArgName = args.toArgName ?? snakeToCamel;
   const flag = args.serverManagedExtension ?? "x-mcp-server-managed";
-  return dedupeByName((args.parameters || []).map(p => {
+  const params = (args.parameters || []).map(p => {
     return resolveParameter(p, args.spec, args.documents);
   }).filter(p => {
     return p.in === "path";
@@ -506,12 +506,13 @@ var extractPathParams = args => {
         extension: flag
       }))
     };
-  }));
+  });
+  return dedupeByName(params);
 };
 var extractQueryParams = args => {
   const toArgName = args.toArgName ?? snakeToCamel;
   const flag = args.serverManagedExtension ?? "x-mcp-server-managed";
-  return dedupeByName((args.parameters || []).map(p => {
+  const params = (args.parameters || []).map(p => {
     return resolveParameter(p, args.spec, args.documents);
   }).filter(p => {
     return p.in === "query";
@@ -530,7 +531,8 @@ var extractQueryParams = args => {
         extension: flag
       }))
     };
-  }));
+  });
+  return dedupeByName(params);
 };
 var collectServerManagedParameters = args => {
   return [...args.pathParams.map(p => {
@@ -561,7 +563,8 @@ var collectServerManagedParameters = args => {
 //#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);
+  const dereferencedBodySchema = dereferenceSchema(rawBodySchema, args.spec, args.documents);
+  return resolveSchema(dereferencedBodySchema, args.spec, args.documents);
 };
 /**
 * snake_case names of every top-level property an operation's request schema
@@ -651,10 +654,10 @@ var extractPinnedBody = args => {
 var isRecord = value => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
-var OPENAPI_ONLY_KEYWORDS = new Set(["discriminator", "example", "externalDocs", "xml"]);
-var SCHEMA_MAPS = new Set(["$defs", "definitions", "dependentSchemas", "patternProperties", "properties"]);
-var SCHEMA_VALUES = new Set(["additionalProperties", "contains", "else", "if", "items", "not", "propertyNames", "then", "unevaluatedItems", "unevaluatedProperties"]);
-var SCHEMA_LISTS = new Set(["anyOf", "oneOf", "prefixItems"]);
+var OPENAPI_ONLY_KEYWORDS = /* @__PURE__ */new Set(["discriminator", "example", "externalDocs", "xml"]);
+var SCHEMA_MAPS = /* @__PURE__ */new Set(["$defs", "definitions", "dependentSchemas", "patternProperties", "properties"]);
+var SCHEMA_VALUES = /* @__PURE__ */new Set(["additionalProperties", "contains", "else", "if", "items", "not", "propertyNames", "then", "unevaluatedItems", "unevaluatedProperties"]);
+var SCHEMA_LISTS = /* @__PURE__ */new Set(["anyOf", "oneOf", "prefixItems"]);
 /**
 * OpenAPI 3.0's `nullable: true` in JSON Schema: `'null'` joins the `type`,
 * and `null` joins an `enum`, which would otherwise still refuse it.
@@ -833,8 +836,9 @@ var createInProcessCallApi = ({
   toError = defaultToError
 }) => {
   return async request => {
+    const target = typeof app === "function" ? await app() : app;
     const response = await dispatchInProcess({
-      app: typeof app === "function" ? await app() : app,
+      app: target,
       method: request.method,
       path: request.url,
       headers: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttoss/http-server-mcp-openapi",
-  "version": "0.8.9",
+  "version": "0.9.0",
   "description": "Generate Model Context Protocol (MCP) tools from an OpenAPI specification for @ttoss/http-server-mcp",
   "keywords": [
     "ai",
@@ -36,15 +36,15 @@
     "dist"
   ],
   "dependencies": {
-    "@ttoss/http-server": "^0.13.1",
-    "@ttoss/http-server-mcp": "^0.37.1"
+    "@ttoss/http-server": "^0.14.0",
+    "@ttoss/http-server-mcp": "^0.38.0"
   },
   "devDependencies": {
-    "@modelcontextprotocol/server": "^2.0.0",
-    "jest": "^30.4.2",
-    "supertest": "^7.2.2",
-    "tsdown": "^0.22.2",
-    "@ttoss/config": "^1.41.0"
+    "@modelcontextprotocol/server": "^2.3.1",
+    "jest": "^30.5.2",
+    "supertest": "^7.3.1",
+    "tsdown": "^0.23.1",
+    "@ttoss/config": "^2.0.0"
   },
   "publishConfig": {
     "access": "public",