mcp-from-openapi 2.6.1 → 2.8.0

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-from-openapi",
-  "version": "2.6.1",
+  "version": "2.8.0",
   "description": "Production-ready library for converting OpenAPI specifications into MCP tool definitions",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -28,7 +28,7 @@
   },
   "homepage": "https://github.com/agentfront/mcp-from-openapi#readme",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.19.0"
   },
   "type": "module",
   "main": "../index.js",
@@ -49,7 +49,7 @@
     }
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^15.5.1",
+    "@apidevtools/json-schema-ref-parser": "^16.0.2",
     "openapi-types": "^12.1.3",
     "yaml": "^2.9.0"
   },
@@ -57,14 +57,16 @@
     "zod": "^4.0.0"
   },
   "devDependencies": {
-    "@swc/core": "~1.5.7",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@swc/core": "~1.16.1",
     "@swc/helpers": "^0.5.18",
     "@swc/jest": "~0.2.38",
-    "@types/jest": "^29.5.0",
+    "@types/jest": "^30.0.0",
     "@types/json-schema": "^7.0.15",
-    "@types/node": "^24.0.0",
-    "esbuild": "^0.27.2",
-    "jest": "^29.7.0",
+    "@types/node": "^26.4.1",
+    "ajv": "^8.17.0",
+    "esbuild": "^0.28.2",
+    "jest": "^30.5.1",
     "tslib": "^2.8.1",
     "typescript": "^5.0.0",
     "zod": "^4.0.0"

package/generator.d.ts

@@ -1,5 +1,19 @@
 import type { OpenAPIDocument, LoadOptions, GenerateOptions, McpOpenAPITool, ValidationResult } from './types';
 import { type LintResult } from './lint';
+/**
+ * 32-bit FNV-1a hash rendered as 8 hex chars. Used for stable, content-derived
+ * name suffixes (no Node `crypto` dependency, so V8-isolate runtimes work).
+ */
+export declare function fnv1aHex(input: string): string;
+/**
+ * Sanitize and cap a tool name per MCP rules: only `[A-Za-z0-9_.-]`, 1-128
+ * chars. Invalid characters become underscores (collapsed); names longer than
+ * `maxLength` are truncated with a hash suffix derived from the FULL original
+ * name, keeping truncated names unique and stable across regenerations.
+ * `fallbackSeed` names the operation (method + path) when sanitization leaves
+ * nothing usable.
+ */
+export declare function normalizeToolName(raw: string, maxLength: number, fallbackSeed: string): string;
 /**
  * Main class for generating MCP tools from OpenAPI specifications
  */

package/index.d.ts

@@ -7,6 +7,16 @@ export { SecurityResolver, createSecurityContext } from './security-resolver';
 export { BUILTIN_FORMAT_RESOLVERS, resolveSchemaFormats } from './format-resolver';
 export { inferAnnotationsFromMethod, extractExtensionOverrides, resolveExtensionEnabled } from './annotations';
 export type { ExtensionToolOverrides } from './annotations';
+export { emitToolTypeScript, toPascalIdentifier } from './type-signature';
+export type { ToolTypeScriptInfo, TypeSignatureOptions } from './type-signature';
+export { dottedNaming, CODECALL_RESERVED_NAMESPACES } from './naming-presets';
+export type { DottedNamingOptions } from './naming-presets';
+export { deriveSecurityElicitations } from './elicitation';
+export type { SecurityElicitation, ElicitationField } from './elicitation';
+export { fromArazzo } from './arazzo';
+export type { FromArazzoOptions, ArazzoGenerateOptions } from './arazzo';
+export { parseRuntimeExpression } from './arazzo-expressions';
+export type { ArazzoDocument, ArazzoInfo, ArazzoSourceDescription, ArazzoWorkflow, ArazzoStep, ArazzoParameter, ArazzoRequestBody, ArazzoPayloadReplacement, ArazzoCriterion, ArazzoCriterionType, ArazzoSuccessAction, ArazzoFailureAction, ArazzoReusableObject, ArazzoComponents, WorkflowIR, WorkflowStepIR, OperationStepIR, NestedWorkflowStepIR, StepOperationIR, StepParameterIR, StepRequestBodyIR, PayloadExpressionIR, PayloadReplacementIR, CriterionIR, ActionIR, RuntimeExpressionAST, RuntimeExpressionType, ExpressionValueIR, } from './arazzo-types';
 export { applyClientTarget, inlineLocalRefs, ensureArrayItems, collapseRootCompositions, collapseNestedUnions, demoteFormats, enforceClosedObjects, requireAllProperties, } from './client-targets';
 export type { ClientTarget } from './client-targets';
 export { buildHttpRequest } from './request-builder';
@@ -19,9 +29,9 @@ 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 { OpenAPIToolError, LoadError, SsrfError, ParseError, ValidationError, GenerationError, SchemaError, RequestBuildError, OverlayError, ArazzoError } 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, 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 { McpOpenAPITool, ToolAnnotations, ToolIcon, 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';