bling-docs-mcp 1.0.0

package/dist/tools/compare-with-postman.js

@@ -0,0 +1,257 @@
+/**
+ * Compare with Postman Tool
+ * Compares our indexed data with what Postman would see
+ * to ensure we're extracting the same information
+ */
+/**
+ * Compare our extraction with raw OpenAPI data
+ * This simulates what Postman would see vs what we extract
+ */
+export function compareWithPostman(input, indexedData, spec) {
+    const differences = [];
+    const matches = [];
+    const recommendations = [];
+    // If no sample endpoint provided, use first one
+    let sampleEndpoint = input.sampleEndpoint;
+    if (!sampleEndpoint && indexedData.endpoints.length > 0) {
+        const first = indexedData.endpoints[0];
+        sampleEndpoint = `${first.method} ${first.path}`;
+    }
+    if (!sampleEndpoint) {
+        return {
+            comparison: {
+                ourExtraction: null,
+                rawOpenAPIData: null,
+                differences: ['No endpoints available'],
+                matches: []
+            },
+            recommendations: ['Load OpenAPI spec first']
+        };
+    }
+    // Parse endpoint
+    const [method, path] = sampleEndpoint.split(' ', 2);
+    const methodLower = method.toLowerCase();
+    // Get our extraction
+    const key = `${method.toUpperCase()} ${path}`;
+    const ourData = indexedData.endpointsByPath.get(key);
+    if (!ourData) {
+        return {
+            comparison: {
+                ourExtraction: null,
+                rawOpenAPIData: null,
+                differences: [`Endpoint not found in our index: ${sampleEndpoint}`],
+                matches: []
+            },
+            recommendations: ['Check if endpoint exists in OpenAPI spec']
+        };
+    }
+    // Get raw OpenAPI data
+    const pathItem = spec.paths[path];
+    const operation = pathItem?.[methodLower];
+    if (!operation) {
+        return {
+            comparison: {
+                ourExtraction: ourData,
+                rawOpenAPIData: null,
+                differences: [`Endpoint not found in OpenAPI spec: ${sampleEndpoint}`],
+                matches: []
+            },
+            recommendations: ['This is a bug - endpoint in index but not in spec']
+        };
+    }
+    // Compare fields
+    // 1. Summary
+    if (ourData.summary === operation.summary) {
+        matches.push('✓ Summary matches');
+    }
+    else {
+        differences.push(`✗ Summary differs: "${ourData.summary}" vs "${operation.summary}"`);
+    }
+    // 2. Description
+    if (ourData.description === (operation.description || '')) {
+        matches.push('✓ Description matches');
+    }
+    else {
+        differences.push(`✗ Description differs`);
+    }
+    // 3. Tags
+    const specTags = operation.tags || [];
+    if (JSON.stringify(ourData.tags.sort()) === JSON.stringify(specTags.sort())) {
+        matches.push('✓ Tags match');
+    }
+    else {
+        differences.push(`✗ Tags differ: [${ourData.tags.join(', ')}] vs [${specTags.join(', ')}]`);
+    }
+    // 4. Parameters
+    const specParams = [
+        ...(pathItem?.parameters || []),
+        ...(operation.parameters || [])
+    ].filter(p => p && !('$ref' in p));
+    if (ourData.parameters.length === specParams.length) {
+        matches.push(`✓ Parameter count matches (${specParams.length})`);
+    }
+    else {
+        differences.push(`✗ Parameter count differs: ${ourData.parameters.length} vs ${specParams.length}`);
+        recommendations.push('Check parameter extraction logic');
+    }
+    // Check each parameter
+    for (const specParam of specParams) {
+        const ourParam = ourData.parameters.find(p => p.name === specParam.name);
+        if (!ourParam) {
+            differences.push(`✗ Missing parameter: ${specParam.name}`);
+            recommendations.push(`Add parameter extraction for: ${specParam.name}`);
+        }
+        else {
+            // Check parameter fields
+            if (ourParam.in === specParam.in) {
+                matches.push(`✓ Parameter "${specParam.name}" location matches (${specParam.in})`);
+            }
+            else {
+                differences.push(`✗ Parameter "${specParam.name}" location differs: ${ourParam.in} vs ${specParam.in}`);
+            }
+            if (ourParam.required === (specParam.required || false)) {
+                matches.push(`✓ Parameter "${specParam.name}" required matches`);
+            }
+            else {
+                differences.push(`✗ Parameter "${specParam.name}" required differs`);
+            }
+        }
+    }
+    // 5. Request Body
+    const hasRequestBody = operation.requestBody !== undefined;
+    const weHaveRequestBody = ourData.requestBody !== undefined;
+    if (hasRequestBody === weHaveRequestBody) {
+        matches.push(`✓ Request body presence matches (${hasRequestBody})`);
+        if (hasRequestBody && ourData.requestBody) {
+            const specBody = operation.requestBody;
+            const specRequired = specBody.required || false;
+            if (ourData.requestBody.required === specRequired) {
+                matches.push('✓ Request body required matches');
+            }
+            else {
+                differences.push(`✗ Request body required differs: ${ourData.requestBody.required} vs ${specRequired}`);
+            }
+            // Check content type
+            const specContentTypes = Object.keys(specBody.content || {});
+            if (specContentTypes.includes(ourData.requestBody.contentType)) {
+                matches.push(`✓ Request body content type matches (${ourData.requestBody.contentType})`);
+            }
+            else {
+                differences.push(`✗ Request body content type differs: ${ourData.requestBody.contentType} vs [${specContentTypes.join(', ')}]`);
+            }
+        }
+    }
+    else {
+        differences.push(`✗ Request body presence differs: we have ${weHaveRequestBody}, spec has ${hasRequestBody}`);
+        recommendations.push('Check request body extraction logic');
+    }
+    // 6. Responses
+    const specResponses = Object.keys(operation.responses || {});
+    const ourResponses = ourData.responses.map(r => r.statusCode);
+    if (ourResponses.length === specResponses.length) {
+        matches.push(`✓ Response count matches (${specResponses.length})`);
+    }
+    else {
+        differences.push(`✗ Response count differs: ${ourResponses.length} vs ${specResponses.length}`);
+    }
+    // Check each response
+    for (const statusCode of specResponses) {
+        const ourResponse = ourData.responses.find(r => r.statusCode === statusCode);
+        if (!ourResponse) {
+            differences.push(`✗ Missing response: ${statusCode}`);
+            recommendations.push(`Add response extraction for status: ${statusCode}`);
+        }
+        else {
+            matches.push(`✓ Response ${statusCode} present`);
+            const specResponse = operation.responses[statusCode];
+            if (ourResponse.description === (specResponse.description || '')) {
+                matches.push(`✓ Response ${statusCode} description matches`);
+            }
+            else {
+                differences.push(`✗ Response ${statusCode} description differs`);
+            }
+        }
+    }
+    // 7. Security
+    const specSecurity = operation.security || [];
+    const hasSecurity = specSecurity.length > 0;
+    const weHaveSecurity = ourData.security !== undefined;
+    if (hasSecurity === weHaveSecurity) {
+        matches.push(`✓ Security presence matches (${hasSecurity})`);
+    }
+    else {
+        differences.push(`✗ Security presence differs: we have ${weHaveSecurity}, spec has ${hasSecurity}`);
+    }
+    // Generate recommendations
+    if (differences.length === 0) {
+        recommendations.push('✓ Perfect match! Our extraction is complete and accurate.');
+    }
+    else {
+        recommendations.push(`Found ${differences.length} differences. Review extraction logic.`);
+    }
+    if (matches.length > differences.length) {
+        recommendations.push(`Good coverage: ${matches.length} matches vs ${differences.length} differences`);
+    }
+    return {
+        comparison: {
+            ourExtraction: {
+                path: ourData.path,
+                method: ourData.method,
+                summary: ourData.summary,
+                description: ourData.description,
+                tags: ourData.tags,
+                parameterCount: ourData.parameters.length,
+                parameters: ourData.parameters.map(p => ({
+                    name: p.name,
+                    in: p.in,
+                    required: p.required,
+                    type: p.type
+                })),
+                hasRequestBody: ourData.requestBody !== undefined,
+                requestBody: ourData.requestBody ? {
+                    required: ourData.requestBody.required,
+                    contentType: ourData.requestBody.contentType
+                } : null,
+                responseCount: ourData.responses.length,
+                responses: ourData.responses.map(r => ({
+                    statusCode: r.statusCode,
+                    description: r.description,
+                    hasSchema: r.schema !== undefined
+                })),
+                hasSecurity: ourData.security !== undefined,
+                security: ourData.security
+            },
+            rawOpenAPIData: {
+                path,
+                method: methodLower,
+                summary: operation.summary,
+                description: operation.description,
+                tags: operation.tags,
+                parameterCount: specParams.length,
+                parameters: specParams.map((p) => ({
+                    name: p.name,
+                    in: p.in,
+                    required: p.required,
+                    schema: p.schema
+                })),
+                hasRequestBody: operation.requestBody !== undefined,
+                requestBody: operation.requestBody ? {
+                    required: operation.requestBody.required,
+                    contentTypes: Object.keys(operation.requestBody.content || {})
+                } : null,
+                responseCount: specResponses.length,
+                responses: specResponses.map(code => ({
+                    statusCode: code,
+                    description: operation.responses[code].description,
+                    hasContent: operation.responses[code].content !== undefined
+                })),
+                hasSecurity: specSecurity.length > 0,
+                security: specSecurity
+            },
+            differences,
+            matches
+        },
+        recommendations
+    };
+}
+//# sourceMappingURL=compare-with-postman.js.map

package/dist/tools/compare-with-postman.js.map

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

package/dist/tools/describe.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Describe Tool
+ * Returns a complete overview of the API — ideal as the FIRST call
+ * to orient the LLM about what the API offers
+ */
+import type { IndexedData } from '../lib/types.js';
+import type { OpenAPISpec } from '../lib/loader.js';
+export interface DescribeOutput {
+    api: {
+        title: string;
+        version: string;
+        description: string;
+        baseUrl: string;
+        docsUrl?: string;
+    };
+    authentication: {
+        type: string;
+        description?: string;
+        flows?: any;
+        scopes?: Record<string, string>;
+    }[];
+    modules: {
+        name: string;
+        description?: string;
+        endpointCount: number;
+    }[];
+    totalEndpoints: number;
+    totalSchemas: number;
+    commonParameters?: {
+        name: string;
+        in: string;
+        description?: string;
+        required: boolean;
+        type: string;
+    }[];
+    usage: string;
+}
+export declare function describe(indexedData: IndexedData, spec: OpenAPISpec): DescribeOutput;
+//# sourceMappingURL=describe.d.ts.map

package/dist/tools/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/tools/describe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,EAAE,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,QAAQ,CACtB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,WAAW,GAChB,cAAc,CA2DhB"}

package/dist/tools/describe.js

@@ -0,0 +1,64 @@
+/**
+ * Describe Tool
+ * Returns a complete overview of the API — ideal as the FIRST call
+ * to orient the LLM about what the API offers
+ */
+export function describe(indexedData, spec) {
+    // Build authentication info
+    const authentication = indexedData.securitySchemes.map(s => {
+        const scopes = {};
+        if (s.flows) {
+            const flow = s.flows.authorizationCode || s.flows.clientCredentials || s.flows.implicit;
+            if (flow?.scopes)
+                Object.assign(scopes, flow.scopes);
+        }
+        return {
+            type: s.type,
+            description: s.description,
+            flows: s.flows,
+            scopes: Object.keys(scopes).length > 0 ? scopes : undefined,
+        };
+    });
+    // Common parameters from components/parameters
+    const commonParameters = [];
+    const compParams = spec.components?.parameters;
+    if (compParams) {
+        for (const [, param] of Object.entries(compParams)) {
+            const p = param;
+            commonParameters.push({
+                name: p.name,
+                in: p.in,
+                description: p.description,
+                required: p.required === true,
+                type: p.schema?.type || 'string',
+            });
+        }
+    }
+    const usage = `USAGE GUIDE:
+1. Call 'search_endpoints' to find endpoints by natural language query or filter by tag/method
+2. Call 'get_endpoint_details' with path+method to get full parameters, request body, and response schemas
+3. Call 'get_schema' without arguments to list all schemas, or with 'ref' to get a specific schema with example
+4. Call 'read_documentation_page' to read guides, webhooks docs, limits, changelogs, FAQs, etc.
+5. Call 'search_documentation' for full-text search across all documentation pages
+6. This 'describe' tool gives you the overall picture — call it once at the start`;
+    return {
+        api: {
+            title: spec.info?.title || 'Bling API',
+            version: spec.info?.version || '',
+            description: spec.info?.description || '',
+            baseUrl: indexedData.baseUrl,
+            docsUrl: spec.info?.['x-docs-url'] || spec.externalDocs?.url,
+        },
+        authentication,
+        modules: indexedData.tags.map(t => ({
+            name: t.name,
+            description: t.description,
+            endpointCount: t.endpointCount,
+        })),
+        totalEndpoints: indexedData.endpoints.length,
+        totalSchemas: indexedData.schemas.size,
+        commonParameters: commonParameters.length > 0 ? commonParameters : undefined,
+        usage,
+    };
+}
+//# sourceMappingURL=describe.js.map

package/dist/tools/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/tools/describe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH,MAAM,UAAU,QAAQ,CACtB,WAAwB,EACxB,IAAiB;IAEjB,4BAA4B;IAC5B,MAAM,cAAc,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACzD,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxF,IAAI,IAAI,EAAE,MAAM;gBAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QACD,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,MAAM,gBAAgB,GAAuC,EAAE,CAAC;IAChE,MAAM,UAAU,GAAI,IAAY,CAAC,UAAU,EAAE,UAAU,CAAC;IACxD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,KAAY,CAAC;YACvB,gBAAgB,CAAC,IAAI,CAAC;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ,KAAK,IAAI;gBAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,QAAQ;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG;;;;;;kFAMkE,CAAC;IAEjF,OAAO;QACL,GAAG,EAAE;YACH,KAAK,EAAG,IAAI,CAAC,IAAY,EAAE,KAAK,IAAI,WAAW;YAC/C,OAAO,EAAG,IAAI,CAAC,IAAY,EAAE,OAAO,IAAI,EAAE;YAC1C,WAAW,EAAG,IAAI,CAAC,IAAY,EAAE,WAAW,IAAI,EAAE;YAClD,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,OAAO,EAAG,IAAI,CAAC,IAAY,EAAE,CAAC,YAAY,CAAC,IAAK,IAAY,CAAC,YAAY,EAAE,GAAG;SAC/E;QACD,cAAc;QACd,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;SAC/B,CAAC,CAAC;QACH,cAAc,EAAE,WAAW,CAAC,SAAS,CAAC,MAAM;QAC5C,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI;QACtC,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;QAC5E,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/tools/get-auth-info.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Get Auth Info Tool
+ * Returns authentication information including security schemes and base URL
+ */
+import type { IndexedData } from '../lib/types.js';
+/**
+ * Input parameters for get_auth_info tool
+ */
+export interface GetAuthInfoInput {
+}
+/**
+ * Output format for get_auth_info tool
+ */
+export interface GetAuthInfoOutput {
+    securitySchemes: {
+        name: string;
+        type: string;
+        description?: string;
+        scheme?: string;
+        bearerFormat?: string;
+        in?: string;
+        flows?: any;
+    }[];
+    baseUrl: string;
+}
+/**
+ * Get authentication information from the API spec
+ * @param input - Empty input (no parameters needed)
+ * @param indexedData - Indexed OpenAPI data
+ * @returns Authentication information including security schemes and base URL
+ */
+export declare function getAuthInfo(input: GetAuthInfoInput, indexedData: IndexedData): GetAuthInfoOutput;
+//# sourceMappingURL=get-auth-info.d.ts.map

package/dist/tools/get-auth-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-auth-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-auth-info.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,iBAAiB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,gBAAgB;CAEhC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,GAAG,CAAC;KACb,EAAE,CAAC;IACJ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,WAAW,GACvB,iBAAiB,CAgBnB"}

package/dist/tools/get-auth-info.js

@@ -0,0 +1,27 @@
+/**
+ * Get Auth Info Tool
+ * Returns authentication information including security schemes and base URL
+ */
+/**
+ * Get authentication information from the API spec
+ * @param input - Empty input (no parameters needed)
+ * @param indexedData - Indexed OpenAPI data
+ * @returns Authentication information including security schemes and base URL
+ */
+export function getAuthInfo(input, indexedData) {
+    // Map security schemes to output format
+    const securitySchemes = indexedData.securitySchemes.map(scheme => ({
+        name: scheme.name,
+        type: scheme.type,
+        description: scheme.description,
+        scheme: scheme.scheme,
+        bearerFormat: scheme.bearerFormat,
+        in: scheme.in,
+        flows: scheme.flows,
+    }));
+    return {
+        securitySchemes,
+        baseUrl: indexedData.baseUrl,
+    };
+}
+//# sourceMappingURL=get-auth-info.js.map

package/dist/tools/get-auth-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-auth-info.js","sourceRoot":"","sources":["../../src/tools/get-auth-info.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,KAAuB,EACvB,WAAwB;IAExB,wCAAwC;IACxC,MAAM,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,eAAe;QACf,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,CAAC;AACJ,CAAC"}

package/dist/tools/get-endpoint-details.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Get Endpoint Details Tool
+ * Returns complete details for a specific API endpoint including
+ * auto-generated request body example via openapi-sampler
+ */
+import type { IndexedData, RequestBodyInfo } from '../lib/types.js';
+import type { OpenAPISpec } from '../lib/loader.js';
+export interface GetEndpointDetailsInput {
+    path: string;
+    method: string;
+}
+export declare function getEndpointDetails(input: GetEndpointDetailsInput, indexedData: IndexedData, spec: OpenAPISpec): {
+    path: string;
+    method: string;
+    operationId: string | undefined;
+    summary: string;
+    description: string;
+    tags: string[];
+    deprecated: true | undefined;
+    security: string[] | undefined;
+    parameters: import("../lib/types.js").ParameterInfo[];
+    requestBody: (RequestBodyInfo & {
+        example?: any;
+    }) | undefined;
+    responses: import("../lib/types.js").ResponseInfo[];
+};
+//# sourceMappingURL=get-endpoint-details.d.ts.map

package/dist/tools/get-endpoint-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-endpoint-details.d.ts","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,EAC9B,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,WAAW;;;;;;;;;;;kBAWuC,GAAG;;;EA0C5D"}

package/dist/tools/get-endpoint-details.js

@@ -0,0 +1,59 @@
+/**
+ * Get Endpoint Details Tool
+ * Returns complete details for a specific API endpoint including
+ * auto-generated request body example via openapi-sampler
+ */
+import { resolveSchema } from '../lib/schema-resolver.js';
+// @ts-ignore — openapi-sampler has no complete types
+import openapiSampler from 'openapi-sampler';
+export function getEndpointDetails(input, indexedData, spec) {
+    const methodUpper = input.method.toUpperCase();
+    const key = `${methodUpper} ${input.path}`;
+    const endpoint = indexedData.endpointsByPath.get(key);
+    if (!endpoint) {
+        throw new Error(`Endpoint not found: ${methodUpper} ${input.path}. Use search_endpoints to find valid paths.`);
+    }
+    // Resolve request body schema
+    let resolvedRequestBody;
+    if (endpoint.requestBody) {
+        const resolvedSchema = resolveSchema(endpoint.requestBody.schema, spec);
+        let example;
+        try {
+            example = openapiSampler.sample(endpoint.requestBody.schema, {}, spec);
+        }
+        catch {
+            // ignore — example generation is best-effort
+        }
+        resolvedRequestBody = {
+            required: endpoint.requestBody.required,
+            contentType: endpoint.requestBody.contentType,
+            schema: resolvedSchema,
+            description: endpoint.requestBody.description,
+            ...(example !== undefined && { example }),
+        };
+    }
+    // Resolve response schemas
+    const resolvedResponses = endpoint.responses.map(response => {
+        if (response.schema) {
+            return {
+                ...response,
+                schema: resolveSchema(response.schema, spec),
+            };
+        }
+        return response;
+    });
+    return {
+        path: endpoint.path,
+        method: endpoint.method,
+        operationId: endpoint.operationId,
+        summary: endpoint.summary,
+        description: endpoint.description,
+        tags: endpoint.tags,
+        deprecated: endpoint.deprecated || undefined,
+        security: endpoint.security,
+        parameters: endpoint.parameters,
+        requestBody: resolvedRequestBody,
+        responses: resolvedResponses,
+    };
+}
+//# sourceMappingURL=get-endpoint-details.js.map

package/dist/tools/get-endpoint-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-endpoint-details.js","sourceRoot":"","sources":["../../src/tools/get-endpoint-details.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,qDAAqD;AACrD,OAAO,cAAc,MAAM,iBAAiB,CAAC;AAO7C,MAAM,UAAU,kBAAkB,CAChC,KAA8B,EAC9B,WAAwB,EACxB,IAAiB;IAEjB,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,WAAW,IAAI,KAAK,CAAC,IAAI,6CAA6C,CAAC,CAAC;IACjH,CAAC;IAED,8BAA8B;IAC9B,IAAI,mBAAsE,CAAC;IAC3E,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxE,IAAI,OAAY,CAAC;QACjB,IAAI,CAAC;YACH,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAa,EAAE,EAAE,EAAE,IAAW,CAAC,CAAC;QACvF,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QACD,mBAAmB,GAAG;YACpB,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ;YACvC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW;YAC7C,MAAM,EAAE,cAAc;YACtB,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW;YAC7C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;QAC1D,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO;gBACL,GAAG,QAAQ;gBACX,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;aAC7C,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,SAAS;QAC5C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,iBAAiB;KAC7B,CAAC;AACJ,CAAC"}

package/dist/tools/get-schema.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Get Schema Tool — Dual Mode
+ * - Without 'ref': lists all schemas (names + types + brief description)
+ * - With 'ref': returns full resolved schema + auto-generated JSON example
+ */
+import type { IndexedData } from '../lib/types.js';
+import type { OpenAPISpec } from '../lib/loader.js';
+export interface GetSchemaInput {
+    ref?: string;
+    filter?: string;
+}
+export declare function getSchema(input: GetSchemaInput, indexedData: IndexedData, spec: OpenAPISpec): {
+    mode: "list";
+    schemas: {
+        name: string;
+        type: any;
+        description: any;
+    }[];
+    total: number;
+    hint: string;
+} | {
+    example?: any;
+    mode: "detail";
+    name: string;
+    type: string;
+    description: string | undefined;
+    properties: import("../lib/types.js").PropertyInfo[] | undefined;
+    required: string[] | undefined;
+    enum: any[] | undefined;
+    schemas?: undefined;
+    total?: undefined;
+    hint?: undefined;
+};
+//# sourceMappingURL=get-schema.d.ts.map

package/dist/tools/get-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;EA+DlB"}

package/dist/tools/get-schema.js

@@ -0,0 +1,64 @@
+/**
+ * Get Schema Tool — Dual Mode
+ * - Without 'ref': lists all schemas (names + types + brief description)
+ * - With 'ref': returns full resolved schema + auto-generated JSON example
+ */
+import { resolveSchema } from '../lib/schema-resolver.js';
+// @ts-ignore
+import openapiSampler from 'openapi-sampler';
+export function getSchema(input, indexedData, spec) {
+    // --- LIST MODE: no ref provided ---
+    if (!input.ref) {
+        let schemas = [...indexedData.schemas.entries()];
+        if (input.filter) {
+            const f = input.filter.toLowerCase();
+            schemas = schemas.filter(([name, s]) => name.toLowerCase().includes(f) ||
+                (s.description || '').toLowerCase().includes(f));
+        }
+        return {
+            mode: 'list',
+            schemas: schemas.map(([name, schema]) => ({
+                name,
+                type: schema.type || 'object',
+                description: schema.description,
+            })),
+            total: schemas.length,
+            hint: 'Use get_schema with { "ref": "SchemaName" } to get full details and an example for a specific schema.',
+        };
+    }
+    // --- DETAIL MODE: resolve the specific schema ---
+    // Support both a plain name ("ProdutoDTO") and $ref paths (#/components/schemas/ProdutoDTO)
+    const refClean = input.ref.replace(/^#\/components\/schemas\//, '');
+    const rawSchema = indexedData.schemas.get(refClean);
+    if (!rawSchema) {
+        // Try case-insensitive match
+        const lower = refClean.toLowerCase();
+        const match = [...indexedData.schemas.keys()].find(k => k.toLowerCase() === lower);
+        if (!match) {
+            const names = [...indexedData.schemas.keys()].slice(0, 20).join(', ');
+            throw new Error(`Schema not found: "${input.ref}". Available schemas (first 20): ${names}`);
+        }
+        // Recurse with corrected casing
+        return getSchema({ ref: match, filter: input.filter }, indexedData, spec);
+    }
+    const resolved = resolveSchema(rawSchema, spec);
+    // Generate example
+    let example;
+    try {
+        example = openapiSampler.sample(rawSchema, {}, spec);
+    }
+    catch {
+        // best-effort
+    }
+    return {
+        mode: 'detail',
+        name: refClean,
+        type: resolved.type,
+        description: resolved.description,
+        properties: resolved.properties,
+        required: resolved.required,
+        enum: resolved.enum,
+        ...(example !== undefined && { example }),
+    };
+}
+//# sourceMappingURL=get-schema.js.map