mcp-from-openapi 2.5.1 → 2.6.1

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-from-openapi",
-  "version": "2.5.1",
+  "version": "2.6.1",
   "description": "Production-ready library for converting OpenAPI specifications into MCP tool definitions",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -49,9 +49,9 @@
     }
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^15.3.5",
+    "@apidevtools/json-schema-ref-parser": "^15.5.1",
     "openapi-types": "^12.1.3",
-    "yaml": "^2.8.3"
+    "yaml": "^2.9.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0"

package/generator.d.ts

@@ -1,4 +1,5 @@
 import type { OpenAPIDocument, LoadOptions, GenerateOptions, McpOpenAPITool, ValidationResult } from './types';
+import { type LintResult } from './lint';
 /**
  * Main class for generating MCP tools from OpenAPI specifications
  */
@@ -13,7 +14,7 @@ export declare class OpenAPIToolGenerator {
     /**
      * Create generator from a URL
      */
-    static fromURL(url: string, options?: LoadOptions): Promise<OpenAPIToolGenerator>;
+    static fromURL(url: string, rawOptions?: LoadOptions): Promise<OpenAPIToolGenerator>;
     /**
      * Create generator from a file path
      */
@@ -34,6 +35,13 @@ export declare class OpenAPIToolGenerator {
      * Validate the OpenAPI document
      */
     validate(): Promise<ValidationResult>;
+    /**
+     * Lint the loaded document for agent-readiness (missing operationIds,
+     * vague descriptions, unpaginated lists, oversized schemas, ...). Runs
+     * after overlays and dereferencing so findings reflect what tools would
+     * actually be generated from.
+     */
+    lint(): Promise<LintResult>;
     /**
      * Build $RefParser options based on refResolution configuration.
      * Defaults: allow http/https, block file://, block internal IPs.

package/index.d.ts

@@ -5,9 +5,23 @@ export { ResponseBuilder } from './response-builder';
 export { Validator } from './validator';
 export { SecurityResolver, createSecurityContext } from './security-resolver';
 export { BUILTIN_FORMAT_RESOLVERS, resolveSchemaFormats } from './format-resolver';
-export { OpenAPIToolError, LoadError, SsrfError, ParseError, ValidationError, GenerationError, SchemaError } from './errors';
+export { inferAnnotationsFromMethod, extractExtensionOverrides, resolveExtensionEnabled } from './annotations';
+export type { ExtensionToolOverrides } from './annotations';
+export { applyClientTarget, inlineLocalRefs, ensureArrayItems, collapseRootCompositions, collapseNestedUnions, demoteFormats, enforceClosedObjects, requireAllProperties, } from './client-targets';
+export type { ClientTarget } from './client-targets';
+export { buildHttpRequest } from './request-builder';
+export type { BuildHttpRequestOptions, BuiltHttpRequest } from './request-builder';
+export { toSdkTool } from './sdk';
+export type { SdkToolConfig, SdkSchemaWrapper } from './sdk';
+export { estimateToolTokens, analyzeToolSet } from './token-report';
+export type { ToolTokenEstimate, ToolSetReport, AnalyzeToolSetOptions } from './token-report';
+export { applyOverlay } from './overlay';
+export type { OverlayDocument, OverlayAction } from './overlay';
+export { lintDocument } from './lint';
+export type { LintResult, LintFinding, LintSeverity } from './lint';
+export { OpenAPIToolError, LoadError, SsrfError, ParseError, ValidationError, GenerationError, SchemaError, RequestBuildError, OverlayError } from './errors';
 export { assertUrlSafe, safeFetch, isBlockedAddress, isBlockedHostname, decodeIpv4MappedIpv6, normalizeSsrfOptions, defaultLookup, BLOCKED_HOSTNAMES, } from './ssrf';
 export type { ResolvedSsrfOptions, ResolvedAddress, SsrfHostLookup, SafeFetchOptions } from './ssrf';
-export type { McpOpenAPITool, ParameterMapper, ToolMetadata, FrontMcpExtensionData, SerializationInfo, SecurityRequirement, SecurityParameterInfo, ServerInfo, RefResolutionOptions, LoadOptions, GenerateOptions, FormatResolver, JsonSchema, NamingStrategy, OperationWithContext, OpenAPIDocument, OpenAPIVersion, HTTPMethod, ParameterLocation, AuthType, OperationObject, ParameterObject, RequestBodyObject, ResponseObject, ResponsesObject, MediaTypeObject, HeaderObject, ExampleObject, PathItemObject, PathsObject, ServerObject, SecuritySchemeObject, ReferenceObject, TagObject, ExternalDocumentationObject, ServerVariableObject, EncodingObject, SecurityRequirementObject, SchemaObject, ValidationResult, ValidationErrorDetail, ValidationWarning, } from './types';
+export type { McpOpenAPITool, ToolAnnotations, ParameterMapper, ToolMetadata, ResponseHints, FrontMcpExtensionData, SerializationInfo, SecurityRequirement, SecurityParameterInfo, ServerInfo, RefResolutionOptions, LoadOptions, GenerateOptions, FormatResolver, JsonSchema, NamingStrategy, OperationWithContext, OpenAPIDocument, OpenAPIVersion, HTTPMethod, ParameterLocation, AuthType, OperationObject, ParameterObject, RequestBodyObject, ResponseObject, ResponsesObject, MediaTypeObject, HeaderObject, ExampleObject, PathItemObject, PathsObject, ServerObject, SecuritySchemeObject, ReferenceObject, TagObject, ExternalDocumentationObject, ServerVariableObject, EncodingObject, SecurityRequirementObject, SchemaObject, ValidationResult, ValidationErrorDetail, ValidationWarning, } from './types';
 export type { SecurityContext, ResolvedSecurity, DigestAuthCredentials, ClientCertificate, AWSCredentials, SignatureData, } from './security-resolver';
 export { isReferenceObject, toJsonSchema } from './types';