mcp-openapi-schema-explorer 1.0.0

package/dist/src/handlers/component-map-handler.js

@@ -0,0 +1,63 @@
+import { ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RenderableComponentMap, VALID_COMPONENT_TYPES, } from '../rendering/components.js';
+import { createErrorResult } from '../rendering/utils.js';
+// Import shared handler utils
+import { formatResults, isOpenAPIV3, getValidatedComponentMap, // Import the helper
+ } from './handler-utils.js'; // Already has .js
+const BASE_URI = 'openapi://';
+// Removed duplicated FormattedResultItem type - now imported from handler-utils
+// Removed duplicated formatResults function - now imported from handler-utils
+// Removed duplicated isOpenAPIV3 function - now imported from handler-utils
+/**
+ * Handles requests for listing component names of a specific type.
+ * Corresponds to the `openapi://components/{type}` template.
+ */
+export class ComponentMapHandler {
+    constructor(specLoader, formatter // Needed for context
+    ) {
+        this.specLoader = specLoader;
+        this.formatter = formatter;
+        this.handleRequest = async (uri, variables) => {
+            const type = variables.type;
+            const mapUriSuffix = `components/${type}`;
+            const context = { formatter: this.formatter, baseUri: BASE_URI };
+            let resultItems;
+            try {
+                if (!VALID_COMPONENT_TYPES.includes(type)) {
+                    throw new Error(`Invalid component type: ${type}`);
+                }
+                const componentType = type;
+                const spec = await this.specLoader.getTransformedSpec({
+                    resourceType: 'schema', // Use 'schema' for now
+                    format: 'openapi',
+                });
+                // Use imported type guard
+                if (!isOpenAPIV3(spec)) {
+                    throw new Error('Only OpenAPI v3 specifications are supported');
+                }
+                // --- Use helper to get validated component map ---
+                const componentMapObj = getValidatedComponentMap(spec, componentType);
+                // Instantiate RenderableComponentMap with the validated map
+                const renderableMap = new RenderableComponentMap(componentMapObj, // componentMapObj retrieved safely via helper
+                componentType, mapUriSuffix);
+                resultItems = renderableMap.renderList(context);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`Error handling request ${uri.href}: ${message}`);
+                resultItems = createErrorResult(mapUriSuffix, message);
+            }
+            // Use imported formatResults
+            const contents = formatResults(context, resultItems);
+            return { contents };
+        };
+    }
+    getTemplate() {
+        // TODO: Add completion logic if needed
+        return new ResourceTemplate(`${BASE_URI}components/{type}`, {
+            list: undefined,
+            complete: undefined,
+        });
+    }
+}
+//# sourceMappingURL=component-map-handler.js.map

package/dist/src/handlers/component-map-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-map-handler.js","sourceRoot":"","sources":["../../../src/handlers/component-map-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,GACjB,MAAM,yCAAyC,CAAC;AAIjD,OAAO,EACL,sBAAsB,EAEtB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,WAAW,EAEX,wBAAwB,EAAE,oBAAoB;EAC/C,MAAM,oBAAoB,CAAC,CAAC,kBAAkB;AAE/C,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,gFAAgF;AAChF,8EAA8E;AAC9E,4EAA4E;AAE5E;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B,YACU,UAA6B,EAC7B,SAAqB,CAAC,qBAAqB;;QAD3C,eAAU,GAAV,UAAU,CAAmB;QAC7B,cAAS,GAAT,SAAS,CAAY;QAW/B,kBAAa,GAAiC,KAAK,EACjD,GAAQ,EACR,SAAoB,EAC0B,EAAE;YAChD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAc,CAAC;YACtC,MAAM,YAAY,GAAG,cAAc,IAAI,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAkB,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;YAChF,IAAI,WAA+B,CAAC;YAEpC,IAAI,CAAC;gBACH,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,IAAqB,CAAC,EAAE,CAAC;oBAC3D,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;gBACrD,CAAC;gBACD,MAAM,aAAa,GAAG,IAAqB,CAAC;gBAE5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;oBACpD,YAAY,EAAE,QAAQ,EAAE,uBAAuB;oBAC/C,MAAM,EAAE,SAAS;iBAClB,CAAC,CAAC;gBAEH,0BAA0B;gBAC1B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;gBAClE,CAAC;gBAED,oDAAoD;gBACpD,MAAM,eAAe,GAAG,wBAAwB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;gBAEtE,4DAA4D;gBAC5D,MAAM,aAAa,GAAG,IAAI,sBAAsB,CAC9C,eAAe,EAAE,8CAA8C;gBAC/D,aAAa,EACb,YAAY,CACb,CAAC;gBACF,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;gBAChE,WAAW,GAAG,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,CAAC;YAED,6BAA6B;YAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACrD,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC,CAAC;IAtDC,CAAC;IAEJ,WAAW;QACT,uCAAuC;QACvC,OAAO,IAAI,gBAAgB,CAAC,GAAG,QAAQ,mBAAmB,EAAE;YAC1D,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;CA+CF"}

package/dist/src/handlers/handler-utils.d.ts

@@ -0,0 +1,69 @@
+import { OpenAPIV3 } from 'openapi-types';
+import { RenderContext, RenderResultItem } from '../rendering/types.js';
+export type FormattedResultItem = {
+    uri: string;
+    mimeType?: string;
+    text: string;
+    isError?: boolean;
+};
+/**
+ * Formats RenderResultItem array into an array compatible with the 'contents'
+ * property of ReadResourceResultSchema (specifically TextResourceContents).
+ */
+export declare function formatResults(context: RenderContext, items: RenderResultItem[]): FormattedResultItem[];
+/**
+ * Type guard to check if an object is an OpenAPIV3.Document.
+ */
+export declare function isOpenAPIV3(spec: unknown): spec is OpenAPIV3.Document;
+/**
+ * Safely retrieves a PathItemObject from the specification using a Map.
+ * Throws an McpError if the path is not found.
+ *
+ * @param spec The OpenAPIV3 Document.
+ * @param path The decoded path string (e.g., '/users/{id}').
+ * @returns The validated PathItemObject.
+ * @throws {McpError} If the path is not found in spec.paths.
+ */
+export declare function getValidatedPathItem(spec: OpenAPIV3.Document, path: string): OpenAPIV3.PathItemObject;
+/**
+ * Validates requested HTTP methods against a PathItemObject using a Map.
+ * Returns the list of valid requested methods.
+ * Throws an McpError if none of the requested methods are valid for the path item.
+ *
+ * @param pathItem The PathItemObject to check against.
+ * @param requestedMethods An array of lowercase HTTP methods requested by the user.
+ * @param pathForError The path string, used for creating informative error messages.
+ * @returns An array of the requested methods that are valid for this path item.
+ * @throws {McpError} If none of the requested methods are valid.
+ */
+export declare function getValidatedOperations(pathItem: OpenAPIV3.PathItemObject, requestedMethods: string[], pathForError: string): string[];
+/**
+ * Safely retrieves the component map for a specific type (e.g., schemas, responses)
+ * from the specification using a Map.
+ * Throws an McpError if spec.components or the specific type map is not found.
+ *
+ * @param spec The OpenAPIV3 Document.
+ * @param type The ComponentType string (e.g., 'schemas', 'responses').
+ * @returns The validated component map object (e.g., spec.components.schemas).
+ * @throws {McpError} If spec.components or the type map is not found.
+ */
+export declare function getValidatedComponentMap(spec: OpenAPIV3.Document, type: string): NonNullable<OpenAPIV3.ComponentsObject[keyof OpenAPIV3.ComponentsObject]>;
+/**
+ * Validates requested component names against a specific component map (e.g., schemas).
+ * Returns an array of objects containing the valid name and its corresponding detail object.
+ * Throws an McpError if none of the requested names are valid for the component map.
+ *
+ * @param componentMap The specific component map object (e.g., spec.components.schemas).
+ * @param requestedNames An array of component names requested by the user.
+ * @param componentTypeForError The component type string, used for creating informative error messages.
+ * @param detailsMap A Map created from the specific component map object (e.g., new Map(Object.entries(spec.components.schemas))).
+ * @param requestedNames An array of component names requested by the user.
+ * @param componentTypeForError The component type string, used for creating informative error messages.
+ * @returns An array of { name: string, detail: V } for valid requested names, where V is the value type of the Map.
+ * @throws {McpError} If none of the requested names are valid.
+ */
+export declare function getValidatedComponentDetails<V extends OpenAPIV3.ReferenceObject | object>(detailsMap: Map<string, V>, // Accept Map<string, V>
+requestedNames: string[], componentTypeForError: string): {
+    name: string;
+    detail: V;
+}[];

package/dist/src/handlers/handler-utils.js

@@ -0,0 +1,180 @@
+/**
+ * Formats RenderResultItem array into an array compatible with the 'contents'
+ * property of ReadResourceResultSchema (specifically TextResourceContents).
+ */
+export function formatResults(context, items) {
+    // Add type check for formatter existence in context
+    if (!context.formatter) {
+        throw new Error('Formatter is missing in RenderContext for formatResults');
+    }
+    return items.map(item => {
+        const uri = `${context.baseUri}${item.uriSuffix}`;
+        let text;
+        let mimeType;
+        if (item.isError) {
+            text = item.errorText || 'An unknown error occurred.';
+            mimeType = 'text/plain';
+        }
+        else if (item.renderAsList) {
+            text = typeof item.data === 'string' ? item.data : 'Invalid list data';
+            mimeType = 'text/plain';
+        }
+        else {
+            // Detail view: format using the provided formatter
+            try {
+                text = context.formatter.format(item.data);
+                mimeType = context.formatter.getMimeType();
+            }
+            catch (formatError) {
+                text = `Error formatting data for ${uri}: ${formatError instanceof Error ? formatError.message : String(formatError)}`;
+                mimeType = 'text/plain';
+                // Ensure isError is true if formatting fails
+                item.isError = true;
+                item.errorText = text; // Store the formatting error message
+            }
+        }
+        // Construct the final object, prioritizing item.isError
+        const finalItem = {
+            uri: uri,
+            mimeType: mimeType,
+            text: item.isError ? item.errorText || 'An unknown error occurred.' : text,
+            isError: item.isError ?? false, // Default to false if not explicitly set
+        };
+        // Ensure mimeType is text/plain for errors
+        if (finalItem.isError) {
+            finalItem.mimeType = 'text/plain';
+        }
+        return finalItem;
+    });
+}
+/**
+ * Type guard to check if an object is an OpenAPIV3.Document.
+ */
+export function isOpenAPIV3(spec) {
+    return (typeof spec === 'object' &&
+        spec !== null &&
+        'openapi' in spec &&
+        typeof spec.openapi === 'string' &&
+        spec.openapi.startsWith('3.'));
+}
+/**
+ * Safely retrieves a PathItemObject from the specification using a Map.
+ * Throws an McpError if the path is not found.
+ *
+ * @param spec The OpenAPIV3 Document.
+ * @param path The decoded path string (e.g., '/users/{id}').
+ * @returns The validated PathItemObject.
+ * @throws {McpError} If the path is not found in spec.paths.
+ */
+export function getValidatedPathItem(spec, path) {
+    if (!spec.paths) {
+        // Use standard Error
+        throw new Error('Specification does not contain any paths.');
+    }
+    const pathsMap = new Map(Object.entries(spec.paths));
+    const pathItem = pathsMap.get(path);
+    if (!pathItem) {
+        const errorMessage = `Path "${path}" not found in the specification.`;
+        // Use standard Error
+        throw new Error(errorMessage);
+    }
+    // We assume the spec structure is valid if the key exists
+    return pathItem;
+}
+/**
+ * Validates requested HTTP methods against a PathItemObject using a Map.
+ * Returns the list of valid requested methods.
+ * Throws an McpError if none of the requested methods are valid for the path item.
+ *
+ * @param pathItem The PathItemObject to check against.
+ * @param requestedMethods An array of lowercase HTTP methods requested by the user.
+ * @param pathForError The path string, used for creating informative error messages.
+ * @returns An array of the requested methods that are valid for this path item.
+ * @throws {McpError} If none of the requested methods are valid.
+ */
+export function getValidatedOperations(pathItem, requestedMethods, pathForError) {
+    const operationsMap = new Map();
+    Object.entries(pathItem).forEach(([method, operation]) => {
+        // Check if the key is a standard HTTP method before adding
+        if (['get', 'put', 'post', 'delete', 'options', 'head', 'patch', 'trace'].includes(method.toLowerCase())) {
+            operationsMap.set(method.toLowerCase(), operation);
+        }
+    });
+    // Validate using lowercase versions, but preserve original case for return
+    const requestedMethodsLower = requestedMethods.map(m => m.toLowerCase());
+    const validLowerMethods = requestedMethodsLower.filter(m => operationsMap.has(m));
+    if (validLowerMethods.length === 0) {
+        const availableMethods = Array.from(operationsMap.keys()).join(', ');
+        // Show original case in error message for clarity
+        const errorMessage = `None of the requested methods (${requestedMethods.join(', ')}) are valid for path "${pathForError}". Available methods: ${availableMethods}`;
+        // Use standard Error
+        throw new Error(errorMessage);
+    }
+    // Return the methods from the *original* requestedMethods array
+    // that correspond to the valid lowercase methods found.
+    return requestedMethods.filter(m => validLowerMethods.includes(m.toLowerCase()));
+}
+/**
+ * Safely retrieves the component map for a specific type (e.g., schemas, responses)
+ * from the specification using a Map.
+ * Throws an McpError if spec.components or the specific type map is not found.
+ *
+ * @param spec The OpenAPIV3 Document.
+ * @param type The ComponentType string (e.g., 'schemas', 'responses').
+ * @returns The validated component map object (e.g., spec.components.schemas).
+ * @throws {McpError} If spec.components or the type map is not found.
+ */
+export function getValidatedComponentMap(spec, type // Keep as string for validation flexibility
+) {
+    if (!spec.components) {
+        // Use standard Error
+        throw new Error('Specification does not contain a components section.');
+    }
+    // Validate the requested type against the actual keys in spec.components
+    const componentsMap = new Map(Object.entries(spec.components));
+    // Add type assertion for clarity, although the check below handles undefined
+    const componentMapObj = componentsMap.get(type);
+    if (!componentMapObj) {
+        const availableTypes = Array.from(componentsMap.keys()).join(', ');
+        const errorMessage = `Component type "${type}" not found in the specification. Available types: ${availableTypes}`;
+        // Use standard Error
+        throw new Error(errorMessage);
+    }
+    // We assume the spec structure is valid if the key exists
+    return componentMapObj;
+}
+/**
+ * Validates requested component names against a specific component map (e.g., schemas).
+ * Returns an array of objects containing the valid name and its corresponding detail object.
+ * Throws an McpError if none of the requested names are valid for the component map.
+ *
+ * @param componentMap The specific component map object (e.g., spec.components.schemas).
+ * @param requestedNames An array of component names requested by the user.
+ * @param componentTypeForError The component type string, used for creating informative error messages.
+ * @param detailsMap A Map created from the specific component map object (e.g., new Map(Object.entries(spec.components.schemas))).
+ * @param requestedNames An array of component names requested by the user.
+ * @param componentTypeForError The component type string, used for creating informative error messages.
+ * @returns An array of { name: string, detail: V } for valid requested names, where V is the value type of the Map.
+ * @throws {McpError} If none of the requested names are valid.
+ */
+// Modify to accept a Map directly
+export function getValidatedComponentDetails(detailsMap, // Accept Map<string, V>
+requestedNames, componentTypeForError) {
+    // No longer need to create the map inside the function
+    const validDetails = requestedNames
+        .map(name => {
+        const detail = detailsMap.get(name); // detail will be V | undefined
+        return detail ? { name, detail } : null;
+    })
+        // Type predicate ensures we filter out nulls and have the correct type
+        .filter((item) => item !== null);
+    if (validDetails.length === 0) {
+        // Sort available names for deterministic error messages
+        const availableNames = Array.from(detailsMap.keys()).sort().join(', ');
+        const errorMessage = `None of the requested names (${requestedNames.join(', ')}) are valid for component type "${componentTypeForError}". Available names: ${availableNames}`;
+        // Use standard Error
+        throw new Error(errorMessage);
+    }
+    return validDetails;
+}
+//# sourceMappingURL=handler-utils.js.map

package/dist/src/handlers/handler-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-utils.js","sourceRoot":"","sources":["../../../src/handlers/handler-utils.ts"],"names":[],"mappings":"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"}

package/dist/src/handlers/operation-handler.d.ts

@@ -0,0 +1,14 @@
+import { ReadResourceTemplateCallback, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SpecLoaderService } from '../types.js';
+import { IFormatter } from '../services/formatters.js';
+/**
+ * Handles requests for specific operation details within a path.
+ * Corresponds to the `openapi://paths/{path}/{method*}` template.
+ */
+export declare class OperationHandler {
+    private specLoader;
+    private formatter;
+    constructor(specLoader: SpecLoaderService, formatter: IFormatter);
+    getTemplate(): ResourceTemplate;
+    handleRequest: ReadResourceTemplateCallback;
+}

package/dist/src/handlers/operation-handler.js

@@ -0,0 +1,86 @@
+import { ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RenderablePathItem } from '../rendering/path-item.js';
+import { createErrorResult } from '../rendering/utils.js';
+import { buildPathItemUriSuffix } from '../utils/uri-builder.js'; // Added .js extension
+// Import shared handler utils
+import { formatResults, isOpenAPIV3, getValidatedPathItem, // Import new helper
+getValidatedOperations, // Import new helper
+ } from './handler-utils.js'; // Already has .js
+const BASE_URI = 'openapi://';
+// Removed duplicated FormattedResultItem type - now imported from handler-utils
+// Removed duplicated formatResults function - now imported from handler-utils
+// Removed duplicated isOpenAPIV3 function - now imported from handler-utils
+/**
+ * Handles requests for specific operation details within a path.
+ * Corresponds to the `openapi://paths/{path}/{method*}` template.
+ */
+export class OperationHandler {
+    constructor(specLoader, formatter) {
+        this.specLoader = specLoader;
+        this.formatter = formatter;
+        this.handleRequest = async (uri, variables) => {
+            const encodedPath = variables.path;
+            // Correct variable access key: 'method', not 'method*'
+            const methodVar = variables['method']; // Can be string or string[]
+            // Decode the path received from the URI variable
+            const decodedPath = decodeURIComponent(encodedPath || '');
+            // Use the builder to create the suffix, which will re-encode the path correctly
+            const pathUriSuffix = buildPathItemUriSuffix(decodedPath);
+            const context = { formatter: this.formatter, baseUri: BASE_URI };
+            let resultItems;
+            try {
+                // Normalize methods: Handle string for single value, array for multiple.
+                let methods = [];
+                if (Array.isArray(methodVar)) {
+                    methods = methodVar.map(m => String(m).trim().toLowerCase()); // Ensure elements are strings
+                }
+                else if (typeof methodVar === 'string') {
+                    methods = [methodVar.trim().toLowerCase()]; // Treat as single item array
+                }
+                methods = methods.filter(m => m.length > 0); // Remove empty strings
+                if (methods.length === 0) {
+                    throw new Error('No valid HTTP method specified.');
+                }
+                const spec = await this.specLoader.getTransformedSpec({
+                    resourceType: 'schema', // Use 'schema' for now
+                    format: 'openapi',
+                });
+                // Use imported type guard
+                if (!isOpenAPIV3(spec)) {
+                    throw new Error('Only OpenAPI v3 specifications are supported');
+                }
+                // --- Use helper to get validated path item ---
+                const lookupPath = decodedPath.startsWith('/') ? decodedPath : `/${decodedPath}`;
+                const pathItemObj = getValidatedPathItem(spec, lookupPath);
+                // --- Use helper to get validated requested methods ---
+                const validMethods = getValidatedOperations(pathItemObj, methods, lookupPath);
+                // Instantiate RenderablePathItem with the validated pathItemObj
+                const renderablePathItem = new RenderablePathItem(pathItemObj, // pathItemObj retrieved safely via helper
+                lookupPath, // Pass the raw, decoded path
+                pathUriSuffix // Pass the correctly built suffix
+                );
+                // Use the validated methods returned by the helper
+                resultItems = renderablePathItem.renderOperationDetail(context, validMethods);
+            }
+            catch (error) {
+                // Catch errors from helpers (e.g., path/method not found) or rendering
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`Error handling request ${uri.href}: ${message}`);
+                // Create a single error item representing the overall request failure
+                resultItems = createErrorResult(uri.href.substring(BASE_URI.length), // Use request URI suffix
+                message);
+            }
+            // Use imported formatResults
+            const contents = formatResults(context, resultItems);
+            return { contents };
+        };
+    }
+    getTemplate() {
+        // TODO: Add completion logic if needed
+        return new ResourceTemplate(`${BASE_URI}paths/{path}/{method*}`, {
+            list: undefined,
+            complete: undefined,
+        });
+    }
+}
+//# sourceMappingURL=operation-handler.js.map

package/dist/src/handlers/operation-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-handler.js","sourceRoot":"","sources":["../../../src/handlers/operation-handler.ts"],"names":[],"mappings":"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"}

package/dist/src/handlers/path-item-handler.d.ts

@@ -0,0 +1,14 @@
+import { ReadResourceTemplateCallback, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SpecLoaderService } from '../types.js';
+import { IFormatter } from '../services/formatters.js';
+/**
+ * Handles requests for listing methods for a specific path.
+ * Corresponds to the `openapi://paths/{path}` template.
+ */
+export declare class PathItemHandler {
+    private specLoader;
+    private formatter;
+    constructor(specLoader: SpecLoaderService, formatter: IFormatter);
+    getTemplate(): ResourceTemplate;
+    handleRequest: ReadResourceTemplateCallback;
+}

package/dist/src/handlers/path-item-handler.js

@@ -0,0 +1,66 @@
+import { ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RenderablePathItem } from '../rendering/path-item.js';
+import { createErrorResult } from '../rendering/utils.js';
+import { buildPathItemUriSuffix } from '../utils/uri-builder.js'; // Added .js extension
+// Import shared handler utils
+import { formatResults, isOpenAPIV3, getValidatedPathItem, // Import the helper
+ } from './handler-utils.js'; // Already has .js
+const BASE_URI = 'openapi://';
+// Removed duplicated FormattedResultItem type - now imported from handler-utils
+// Removed duplicated formatResults function - now imported from handler-utils
+// Removed duplicated isOpenAPIV3 function - now imported from handler-utils
+/**
+ * Handles requests for listing methods for a specific path.
+ * Corresponds to the `openapi://paths/{path}` template.
+ */
+export class PathItemHandler {
+    constructor(specLoader, formatter // Although unused in list view, needed for context
+    ) {
+        this.specLoader = specLoader;
+        this.formatter = formatter;
+        this.handleRequest = async (uri, variables) => {
+            const encodedPath = variables.path;
+            // Decode the path received from the URI variable
+            const decodedPath = decodeURIComponent(encodedPath || '');
+            // Use the builder to create the suffix, which will re-encode the path correctly
+            const pathUriSuffix = buildPathItemUriSuffix(decodedPath);
+            const context = { formatter: this.formatter, baseUri: BASE_URI };
+            let resultItems;
+            try {
+                const spec = await this.specLoader.getTransformedSpec({
+                    resourceType: 'schema', // Use 'schema' for now
+                    format: 'openapi',
+                });
+                // Use imported type guard
+                if (!isOpenAPIV3(spec)) {
+                    throw new Error('Only OpenAPI v3 specifications are supported');
+                }
+                // --- Use helper to get validated path item ---
+                const lookupPath = decodedPath.startsWith('/') ? decodedPath : `/${decodedPath}`;
+                const pathItemObj = getValidatedPathItem(spec, lookupPath);
+                // Instantiate RenderablePathItem with the validated pathItemObj
+                const renderablePathItem = new RenderablePathItem(pathItemObj, // pathItemObj retrieved safely via helper
+                lookupPath, // Pass the raw, decoded path
+                pathUriSuffix // Pass the correctly built suffix
+                );
+                resultItems = renderablePathItem.renderList(context);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`Error handling request ${uri.href}: ${message}`);
+                resultItems = createErrorResult(pathUriSuffix, message);
+            }
+            // Use imported formatResults
+            const contents = formatResults(context, resultItems);
+            return { contents };
+        };
+    }
+    getTemplate() {
+        // TODO: Add completion logic if needed
+        return new ResourceTemplate(`${BASE_URI}paths/{path}`, {
+            list: undefined,
+            complete: undefined,
+        });
+    }
+}
+//# sourceMappingURL=path-item-handler.js.map

package/dist/src/handlers/path-item-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-item-handler.js","sourceRoot":"","sources":["../../../src/handlers/path-item-handler.ts"],"names":[],"mappings":"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"}

package/dist/src/handlers/top-level-field-handler.d.ts

@@ -0,0 +1,14 @@
+import { ReadResourceTemplateCallback, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SpecLoaderService } from '../types.js';
+import { IFormatter } from '../services/formatters.js';
+/**
+ * Handles requests for top-level OpenAPI fields (info, servers, paths list, components list).
+ * Corresponds to the `openapi://{field}` template.
+ */
+export declare class TopLevelFieldHandler {
+    private specLoader;
+    private formatter;
+    constructor(specLoader: SpecLoaderService, formatter: IFormatter);
+    getTemplate(): ResourceTemplate;
+    handleRequest: ReadResourceTemplateCallback;
+}

package/dist/src/handlers/top-level-field-handler.js

@@ -0,0 +1,72 @@
+import { ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RenderableDocument } from '../rendering/document.js';
+import { RenderablePaths } from '../rendering/paths.js';
+import { RenderableComponents } from '../rendering/components.js';
+import { createErrorResult } from '../rendering/utils.js';
+// Import shared handler utils
+import { formatResults, isOpenAPIV3 } from './handler-utils.js'; // Already has .js
+const BASE_URI = 'openapi://';
+// Removed duplicated FormattedResultItem type - now imported from handler-utils
+// Removed duplicated formatResults function - now imported from handler-utils
+/**
+ * Handles requests for top-level OpenAPI fields (info, servers, paths list, components list).
+ * Corresponds to the `openapi://{field}` template.
+ */
+export class TopLevelFieldHandler {
+    constructor(specLoader, formatter) {
+        this.specLoader = specLoader;
+        this.formatter = formatter;
+        this.handleRequest = async (uri, variables
+        // matchedTemplate is not needed if we only handle one template
+        ) => {
+            // Return type uses the defined array structure
+            const field = variables.field;
+            const context = { formatter: this.formatter, baseUri: BASE_URI };
+            let resultItems;
+            try {
+                const spec = await this.specLoader.getTransformedSpec({
+                    // Use 'schema' as placeholder resourceType for transformation context
+                    resourceType: 'schema',
+                    format: 'openapi',
+                });
+                // Use imported type guard
+                if (!isOpenAPIV3(spec)) {
+                    throw new Error('Only OpenAPI v3 specifications are supported');
+                }
+                const renderableDoc = new RenderableDocument(spec);
+                // Route based on the field name
+                if (field === 'paths') {
+                    const pathsObj = renderableDoc.getPathsObject();
+                    resultItems = new RenderablePaths(pathsObj).renderList(context);
+                }
+                else if (field === 'components') {
+                    const componentsObj = renderableDoc.getComponentsObject();
+                    resultItems = new RenderableComponents(componentsObj).renderList(context);
+                }
+                else {
+                    // Handle other top-level fields (info, servers, tags, etc.)
+                    const fieldObject = renderableDoc.getTopLevelField(field);
+                    resultItems = renderableDoc.renderTopLevelFieldDetail(context, fieldObject, field);
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`Error handling request ${uri.href}: ${message}`);
+                resultItems = createErrorResult(field, message); // Use field as uriSuffix for error
+            }
+            // Format results into the final structure
+            const contents = formatResults(context, resultItems);
+            // Return the object with the correctly typed contents array
+            // Use imported formatResults
+            return { contents };
+        };
+    }
+    getTemplate() {
+        // TODO: Add completion logic if needed
+        return new ResourceTemplate(`${BASE_URI}{field}`, {
+            list: undefined,
+            complete: undefined,
+        });
+    }
+} // Ensure class closing brace is present
+//# sourceMappingURL=top-level-field-handler.js.map

package/dist/src/handlers/top-level-field-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"top-level-field-handler.js","sourceRoot":"","sources":["../../../src/handlers/top-level-field-handler.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};