@redocly/redoc 0.129.0-next.1 → 0.129.0-next.3

package/dist/server/plugins/markdown/markdoc/custom-components/openapi/index.d.ts

@@ -5,4 +5,5 @@ export * from './openapi-example.js';
 export * from './step-by-step-wrapper.js';
 export * from './replay-openapi.js';
 export * from './openapi-response-sample.js';
+export * from './json-example.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/markdown/markdoc/custom-components/openapi/index.js

@@ -1 +1 @@
-export*from"./json-schema.js";export*from"./explain-step.js";export*from"./openapi-code-sample.js";export*from"./openapi-example.js";export*from"./step-by-step-wrapper.js";export*from"./replay-openapi.js";export*from"./openapi-response-sample.js";
+export*from"./json-schema.js";export*from"./explain-step.js";export*from"./openapi-code-sample.js";export*from"./openapi-example.js";export*from"./step-by-step-wrapper.js";export*from"./replay-openapi.js";export*from"./openapi-response-sample.js";export*from"./json-example.js";

package/dist/server/plugins/markdown/markdoc/custom-components/openapi/json-example.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export type JsonExampleProps = {
+    title?: string;
+    json: unknown;
+    errors: string[];
+};
+export declare function JsonExample(props: JsonExampleProps): React.JSX.Element;
+//# sourceMappingURL=json-example.d.ts.map

package/dist/server/plugins/markdown/markdoc/custom-components/openapi/json-example.js

@@ -0,0 +1,7 @@
+import r from"react";import l from"styled-components";import{JsonViewer as n}from"@redocly/theme/components/JsonViewer/JsonViewer";import{ClipboardService as a}from"@redocly/theme/core/utils";function E(c){const{json:e,title:t,errors:o}=c;return o.length?r.createElement(i,null,r.createElement(p,null,"error"),r.createElement(n,{data:o,expandLevel:3,onCopyClick:()=>{a.copyCustom(JSON.stringify(o))},title:t})):r.createElement(n,{data:e,expandLevel:3,onCopyClick:()=>{a.copyCustom(JSON.stringify(e))},title:t})}const i=l.div`
+  background-color: var(--code-block-bg-color);
+  border: 2px solid var(--color-error-border);
+`,p=l.p`
+  color: var(--color-error-text);
+  padding-left: var(--spacing-xs);
+`;export{E as JsonExample};

package/dist/server/plugins/markdown/markdoc/partials.js

@@ -1 +1 @@
-import*as l from"path";import{MARKDOC_PARTIALS_DATA_KEY as f,MARKDOC_PARTIALS_DEPS_KEY as D}from"../../../store.js";import{isPartial as h}from"../is-partial.js";function A(e,t){return Promise.all(e.map(t)).then(o=>e.filter((i,n)=>o[n]))}async function C(e,t){const{markdown:o}=await e.getConfig(),i=o?.partialsFolders??[],n=await A(await e.fs.scan(/\.md$/),async a=>!(!l.posix.basename(a.relativePath).endsWith(".md")||await e.isPathIgnored(a.relativePath)||!h(a.relativePath,i)));t.setGlobalConfig({[f]:Object.fromEntries(n.map(a=>[a.relativePath,{}]))});const m={},p={};for(const a of n){const{ast:s,info:r}=await t.parseMarkdoc(a,e);m[a.relativePath]=s;const c=Array.isArray(r.dynamicMarkdocComponents)?r.dynamicMarkdocComponents:[],d=r.sharedDataDeps instanceof Set?Array.from(r.sharedDataDeps):Array.isArray(r.sharedDataDeps)?r.sharedDataDeps:[];p[a.relativePath]={dynamicComponents:new Set(c),sharedDataDeps:new Set(d)}}return t.setGlobalConfig({[D]:Object.fromEntries(Object.entries(p).map(([a,s])=>[a,{dynamicComponents:Array.from(s.dynamicComponents),sharedDataDeps:Array.from(s.sharedDataDeps)}]))}),m}export{C as prepareMarkdocPartials};
+import*as l from"path";import{MARKDOC_PARTIALS_DATA_KEY as f,MARKDOC_PARTIALS_DEPS_KEY as D}from"../../../store.js";import{isPartial as h}from"../is-partial.js";function A(e,t){return Promise.all(e.map(t)).then(o=>e.filter((i,n)=>o[n]))}async function C(e,t){const{markdown:o}=await e.getConfig(),i=o?.partialsFolders??[],n=await A(e.fs.scan(/\.md$/),async a=>!(!l.posix.basename(a.relativePath).endsWith(".md")||await e.isPathIgnored(a.relativePath)||!h(a.relativePath,i)));t.setGlobalConfig({[f]:Object.fromEntries(n.map(a=>[a.relativePath,{}]))});const m={},p={};for(const a of n){const{ast:s,info:r}=await t.parseMarkdoc(a,e);m[a.relativePath]=s;const c=Array.isArray(r.dynamicMarkdocComponents)?r.dynamicMarkdocComponents:[],d=r.sharedDataDeps instanceof Set?Array.from(r.sharedDataDeps):Array.isArray(r.sharedDataDeps)?r.sharedDataDeps:[];p[a.relativePath]={dynamicComponents:new Set(c),sharedDataDeps:new Set(d)}}return t.setGlobalConfig({[D]:Object.fromEntries(Object.entries(p).map(([a,s])=>[a,{dynamicComponents:Array.from(s.dynamicComponents),sharedDataDeps:Array.from(s.sharedDataDeps)}]))}),m}export{C as prepareMarkdocPartials};

package/dist/server/plugins/markdown/markdoc/resolve-raw-partials.js

@@ -1,2 +1,2 @@
-import p from"node:path";import _ from"is-glob";import{slash as $}from"../../../../utils/path/slash.js";import{reporter as d}from"../../../tools/notifiers/reporter.js";import{convertGlobToRegex as h}from"../../../utils/index.js";import{formatMarkdocError as k}from"../errors.js";import{isPartial as E}from"../is-partial.js";const b=/\{\% ?raw-partial file="([^"]+)" ?\/?\%\}/gm,y=async(t,a,i=[],o,l=[a])=>{for(const s of i){const r=_(s)?h(s):new RegExp(`^${s}/`);await o.fs.scan(r)}const n=[],f=t.replace(b,(s,r)=>(n.push(u(s,r)),"_$redocly$"+(n.length-1)+"$")),w=await Promise.all(n);return f.replace(/_\$redocly\$(\d+)\$/g,(s,r)=>w[+r]);async function u(s,r){const e=r.startsWith("/")?r.slice(1):$(p.relative(o.fs.cwd,p.resolve(o.fs.cwd,p.dirname(a),r)));if(l.includes(e)){const c=[...l,e];return await d.panicOnBuildContentError(`Circular reference chain detected when processing raw partials: ${c.map(()=>"%rp").join(" -> ")}`,...c),""}const m=!await o.fs.exists(e),g=!e.endsWith(".md")||await o.isPathIgnored(e)||!E(e,i);if(m||g){const R={type:"resolve_link",lines:[1,t.split(`
+import p from"node:path";import _ from"is-glob";import{slash as $}from"../../../../utils/path/slash.js";import{reporter as d}from"../../../tools/notifiers/reporter.js";import{convertGlobToRegex as h}from"../../../utils/index.js";import{formatMarkdocError as k}from"../errors.js";import{isPartial as E}from"../is-partial.js";const b=/\{\% ?raw-partial file="([^"]+)" ?\/?\%\}/gm,y=async(t,a,i=[],o,l=[a])=>{for(const s of i){const r=_(s)?h(s):new RegExp(`^${s}/`);await o.fs.scan(r)}const n=[],f=t.replace(b,(s,r)=>(n.push(u(s,r)),"_$redocly$"+(n.length-1)+"$")),w=await Promise.all(n);return f.replace(/_\$redocly\$(\d+)\$/g,(s,r)=>w[+r]);async function u(s,r){const e=r.startsWith("/")?r.slice(1):$(p.relative(o.fs.cwd,p.resolve(o.fs.cwd,p.dirname(a),r)));if(l.includes(e)){const c=[...l,e];return await d.panicOnBuildContentError(`Circular reference chain detected when processing raw partials: ${c.map(()=>"%rp").join(" -> ")}`,...c),""}const m=!o.fs.exists(e),g=!e.endsWith(".md")||await o.isPathIgnored(e)||!E(e,i);if(m||g){const R={type:"resolve_link",lines:[1,t.split(`
 `).length],meta:{rawLink:r,link:e},error:{id:"error",level:"error",message:m?"Raw partial file does not exist":"Could not resolve raw partial. Starting with 0.73.0 version all partials should be placed in partials folders"}};return d.reportMarkdocProblem(k(R,a,t)),""}const v=await o.fs.read(e);return await y(v,e,i,o,[...l,e])}};export{y as resolveRawPartials};

package/dist/server/plugins/markdown/markdoc/tags/index.d.ts

@@ -3,6 +3,7 @@ import { openApiCodeSample } from './openapi-code-sample.js';
 import { openApiExample } from './openapi-example.js';
 import { replayOpenApi } from './replay-openapi.js';
 import { openApiResponseSample } from './openapi-response-sample.js';
+import { jsonExample } from './json-example.js';
 declare const _default: {
     [jsonSchema.tagName]: import("@markdoc/markdoc").Schema & {
         dynamicComponentLib: string;
@@ -19,6 +20,9 @@ declare const _default: {
     [openApiResponseSample.tagName]: import("@markdoc/markdoc").Schema & {
         dynamicComponentLib: string;
     };
+    [jsonExample.tagName]: import("@markdoc/markdoc").Schema & {
+        dynamicComponentLib: string;
+    };
 };
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/markdown/markdoc/tags/index.js

@@ -1 +1 @@
-import{jsonSchema as e}from"./json-schema.js";import{openApiCodeSample as m}from"./openapi-code-sample.js";import{openApiExample as a}from"./openapi-example.js";import{replayOpenApi as p}from"./replay-openapi.js";import{openApiResponseSample as o}from"./openapi-response-sample.js";var f={[e.tagName]:e.schema,[m.tagName]:m.schema,[a.tagName]:a.schema,[p.tagName]:p.schema,[o.tagName]:o.schema};export{f as default};
+import{jsonSchema as m}from"./json-schema.js";import{openApiCodeSample as e}from"./openapi-code-sample.js";import{openApiExample as a}from"./openapi-example.js";import{replayOpenApi as p}from"./replay-openapi.js";import{openApiResponseSample as o}from"./openapi-response-sample.js";import{jsonExample as r}from"./json-example.js";var n={[m.tagName]:m.schema,[e.tagName]:e.schema,[a.tagName]:a.schema,[p.tagName]:p.schema,[o.tagName]:o.schema,[r.tagName]:r.schema};export{n as default};

package/dist/server/plugins/markdown/markdoc/tags/json-example.d.ts

@@ -0,0 +1,3 @@
+import type { CustomMarkdocTag } from '../../../../types';
+export declare const jsonExample: CustomMarkdocTag;
+//# sourceMappingURL=json-example.d.ts.map

package/dist/server/plugins/markdown/markdoc/tags/json-example.js

@@ -0,0 +1 @@
+import l from"@markdoc/markdoc";import{SampleFromJsonSchema as m,JsonExampleRef as n}from"../attributes/index.js";const v={schema:{attributes:{value:{type:n,required:!1},schema:{type:m,required:!1},mode:{type:String,matches:["read","write"],required:!1},title:{type:String,required:!1},valueResolved:{required:!1},valueResolvedErrors:{type:Array,default:[]},schemaResolved:{required:!1},schemaResolvedErrors:{type:Array,default:[]}},render:"JsonExample",selfClosing:!0,dynamicComponentLib:"openapi",transform:(e,r)=>{const o=e.transformAttributes(r),{valueResolved:a,schemaResolved:u,schemaResolvedErrors:i,valueResolvedErrors:t,title:s}=o;return a||t.length?new l.Tag("JsonExample",{title:s,json:a,errors:t}):new l.Tag("JsonExample",{title:s,json:u,errors:i})},validate(e){const r=[];return e.attributes.schema&&e.attributes.value&&r.push({id:"schema-and-value-attributes-are-mutually-exclusive",level:"error",message:'The "schema" and "value" attributes are mutually exclusive, you can only use one.'}),!e.attributes.schema&&!e.attributes.value&&r.push({id:"schema-or-value-attribute-required",level:"error",message:'This tag requires the "schema" or "value" attribute to render correctly.'}),r}},tagName:"json-example"};export{v as jsonExample};

package/dist/server/plugins/markdown/markdown-static-data-loader.js

@@ -1 +1 @@
-import A from"path";import{REDOCLY_TEAMS_RBAC as m,REDOCLY_ROUTE_RBAC as y}from"@redocly/config";import{removeTrailingSlash as R}from"../../../utils/url/remove-trailing-slash.js";import{addLeadingSlash as S}from"../../../utils/url/add-leading-slash.js";import{resolveFrontmatterKeys as P}from"../resolve-frontmatter-keys.js";import{resolveItem as T}from"../nav-utils.js";const C=new WeakMap;async function _(l,i,s,e,a){const o=await s.getConfig(),{ast:d,compoundHash:n,info:c}=await a.parseMarkdoc(l,s),g={...o.markdown?.editPage,...e.markdown?.editPage},t=i.fsPath!=null?await s.fs.getFileInfo(i.fsPath):null,f=!g?.hide&&g?.baseUrl?{to:R(g.baseUrl)+S(t?.realRelativePath||i.fsPath||"")}:void 0,k={...o.feedback,...e.feedback},u=e.feedback?{type:k.type||"sentiment",settings:k.settings||{},hide:e.feedback?.hide}:void 0;let w=C.get(d),r=w?.ast;(!r||w?.compoundHash!==n)&&(r=JSON.stringify(d),C.set(d,{ast:r,compoundHash:n}));let h;e.navigation&&(h={...e.navigation,nextButton:await L(e.navigation.nextButton,i,a,s),previousButton:await L(e.navigation.previousButton,i,a,s)});const p=e?.seo?await P(e.seo,["image"],i.fsPath||"",a,s):void 0,v=c.tagList;Array.isArray(v)&&v.includes("code-walkthrough")&&(e.markdown=e.markdown||{},e.markdown.toc={hide:!0},e.footer=e.footer||{},e.footer={hide:!0});const b=e?.seo?.title||await i.getNavText?.();return{ast:r,frontmatter:await P({...e,...u!==void 0?{feedback:u}:{},...p!==void 0?{seo:p}:{},...h!==void 0?{navigation:h}:{}},o.markdown?.frontMatterKeysToResolve||["image","links"],i.fsPath||"",a,s),editPage:f,props:{metadata:{markdoc:{tagList:c.tagList}},seo:{...p,...b?{title:b}:{}}},[m]:i[m],[y]:i[y]}}async function L(l,i,s,e){if(!l||typeof l!="object")return;let a=l,o,d;if("page"in a&&typeof a.page=="string"){const{page:t,...f}=a;a=f,o=t}if("label"in a&&typeof a.label=="string"){const{label:t,...f}=a;a=f,d=t}let n;if(o){const t=await T({page:o},i.fsPath?A.dirname(i.fsPath):".",s,e,{navFile:i.fsPath||""});n=Array.isArray(t)?t[0]:t,n=n?.type!=="error"?n:void 0}const c=n?.routeSlug,g=d??n?.label;return{...a,label:g,link:c}}export{_ as markdownStaticDataLoader};
+import A from"path";import{REDOCLY_TEAMS_RBAC as m,REDOCLY_ROUTE_RBAC as y}from"@redocly/config";import{removeTrailingSlash as R}from"../../../utils/url/remove-trailing-slash.js";import{addLeadingSlash as S}from"../../../utils/url/add-leading-slash.js";import{resolveFrontmatterKeys as P}from"../resolve-frontmatter-keys.js";import{resolveItem as T}from"../nav-utils.js";const C=new WeakMap;async function _(l,i,s,e,a){const o=await s.getConfig(),{ast:d,compoundHash:n,info:c}=await a.parseMarkdoc(l,s),g={...o.markdown?.editPage,...e.markdown?.editPage},t=i.fsPath!=null?s.fs.getFileInfo(i.fsPath):null,f=!g?.hide&&g?.baseUrl?{to:R(g.baseUrl)+S(t?.realRelativePath||i.fsPath||"")}:void 0,k={...o.feedback,...e.feedback},u=e.feedback?{type:k.type||"sentiment",settings:k.settings||{},hide:e.feedback?.hide}:void 0;let w=C.get(d),r=w?.ast;(!r||w?.compoundHash!==n)&&(r=JSON.stringify(d),C.set(d,{ast:r,compoundHash:n}));let h;e.navigation&&(h={...e.navigation,nextButton:await L(e.navigation.nextButton,i,a,s),previousButton:await L(e.navigation.previousButton,i,a,s)});const p=e?.seo?await P(e.seo,["image"],i.fsPath||"",a,s):void 0,v=c.tagList;Array.isArray(v)&&v.includes("code-walkthrough")&&(e.markdown=e.markdown||{},e.markdown.toc={hide:!0},e.footer=e.footer||{},e.footer={hide:!0});const b=e?.seo?.title||await i.getNavText?.();return{ast:r,frontmatter:await P({...e,...u!==void 0?{feedback:u}:{},...p!==void 0?{seo:p}:{},...h!==void 0?{navigation:h}:{}},o.markdown?.frontMatterKeysToResolve||["image","links"],i.fsPath||"",a,s),editPage:f,props:{metadata:{markdoc:{tagList:c.tagList}},seo:{...p,...b?{title:b}:{}}},[m]:i[m],[y]:i[y]}}async function L(l,i,s,e){if(!l||typeof l!="object")return;let a=l,o,d;if("page"in a&&typeof a.page=="string"){const{page:t,...f}=a;a=f,o=t}if("label"in a&&typeof a.label=="string"){const{label:t,...f}=a;a=f,d=t}let n;if(o){const t=await T({page:o},i.fsPath?A.dirname(i.fsPath):".",s,e,{navFile:i.fsPath||""});n=Array.isArray(t)?t[0]:t,n=n?.type!=="error"?n:void 0}const c=n?.routeSlug,g=d??n?.label;return{...a,label:g,link:c}}export{_ as markdownStaticDataLoader};

package/dist/server/plugins/mcp/auth/auth-handlers.d.ts

@@ -1,5 +1,5 @@
 import type { ApiFunctionsContext, ApiFunctionsUser } from '@redocly/config';
-export declare function shouldHandleMcpAuth(context: ApiFunctionsContext): boolean;
+export declare function shouldHandleMcpAuth(requiresLogin: boolean, rbacConfig?: Record<string, unknown>): boolean;
 export declare function handleMcpAuth(request: Request, context: ApiFunctionsContext): Promise<{
     isAuthenticated: boolean;
     isTokenValid?: boolean;

package/dist/server/plugins/mcp/auth/auth-handlers.js

@@ -1 +1 @@
-import{extractTokenFromAuthHeader as u}from"../utils/jwt.js";import{getUserParamsFromCookies as d}from"../../../web-server/auth.js";import{DEFAULT_ANONYMOUS_VISITOR_TEAM as s,RBAC_ALL_OTHER_TEAMS as a}from"../../../../constants/common.js";function c(e){return!e||typeof e!="object"||Object.keys(e).length===0?!1:!(e[s]&&e[s]!=="none"||e[a]&&e[a]!=="none")}function p(e){const o=!!e?.config?.requiresLogin,r=e?.config?.rbac;if(!r||Object.keys(r).length===0)return o;const t=r.content;if(t&&Object.keys(t).length>0&&Object.values(t).some(c))return!0;const i=r.teamFoldersBaseRoles;return c(i)?!0:o}async function g(e,o){const r=e.headers.get("Authorization");if(!r)return{isAuthenticated:!1};const t=u(r),i=o?.config?.ssoDirect||{},n=t?await d(i,{authorization:t,idp_access_token:t}):{};return t&&n&&n.isAuthenticated?{isAuthenticated:!0,isTokenValid:!0,currentUser:{teams:n.teams||[],email:n.email||"",claims:n,isAuthenticated:!0,idpAccessToken:n.idpAccessToken||void 0,idpId:n.idpId||void 0}}:{isAuthenticated:!1,isTokenValid:!1}}function m(e){return new Response(JSON.stringify({error:"unauthorized",message:"Authentication required"}),{status:401,headers:{"Content-Type":"application/json","WWW-Authenticate":`Bearer realm="${e}/.well-known/oauth-protected-resource/mcp"`,"Access-Control-Allow-Origin":"*"}})}function k(){return new Response(JSON.stringify({error:"invalid_token",message:"Invalid or expired token"}),{status:401,headers:{"Content-Type":"application/json","WWW-Authenticate":'Bearer error="invalid_token", error_description="Invalid or expired token"',"Access-Control-Allow-Origin":"*"}})}export{k as constructInvalidTokenResponse,m as constructUnauthorizedResponse,g as handleMcpAuth,p as shouldHandleMcpAuth};
+import{extractTokenFromAuthHeader as u}from"../utils/jwt.js";import{getUserParamsFromCookies as d}from"../../../web-server/auth.js";import{DEFAULT_ANONYMOUS_VISITOR_TEAM as i,RBAC_ALL_OTHER_TEAMS as a}from"../../../../constants/common.js";function c(e){return!e||typeof e!="object"||Object.keys(e).length===0?!1:!(e[i]&&e[i]!=="none"||e[a]&&e[a]!=="none")}function p(e,t){if(!t||Object.keys(t).length===0)return e;const r=t.content;if(r&&Object.keys(r).length>0&&Object.values(r).some(c))return!0;const o=t.teamFoldersBaseRoles;return c(o)?!0:e}async function m(e,t){const r=e.headers.get("Authorization");if(!r)return{isAuthenticated:!1};const o=u(r),s=t?.config?.ssoDirect||{},n=o?await d(s,{authorization:o,idp_access_token:o}):{};return o&&n&&n.isAuthenticated?{isAuthenticated:!0,isTokenValid:!0,currentUser:{teams:n.teams||[],email:n.email||"",claims:n,isAuthenticated:!0,idpAccessToken:n.idpAccessToken||void 0,idpId:n.idpId||void 0}}:{isAuthenticated:!1,isTokenValid:!1}}function k(e){return new Response(JSON.stringify({error:"unauthorized",message:"Authentication required"}),{status:401,headers:{"Content-Type":"application/json","WWW-Authenticate":`Bearer realm="${e}/.well-known/oauth-protected-resource/mcp"`,"Access-Control-Allow-Origin":"*"}})}function T(){return new Response(JSON.stringify({error:"invalid_token",message:"Invalid or expired token"}),{status:401,headers:{"Content-Type":"application/json","WWW-Authenticate":'Bearer error="invalid_token", error_description="Invalid or expired token"',"Access-Control-Allow-Origin":"*"}})}export{T as constructInvalidTokenResponse,k as constructUnauthorizedResponse,m as handleMcpAuth,p as shouldHandleMcpAuth};

package/dist/server/plugins/mcp/docs-mcp/tools/get-endpoint-info.d.ts

@@ -1,4 +1,9 @@
 import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
-import type { OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
-export declare function registerGetEndpointTools(server: McpServer, definitions: OpenAPIDefinition[]): void;
+import type { AccessInfo, ApiDescriptionInfo } from '../../types.js';
+export declare function registerGetEndpointTools({ server, apiDescriptionsMap, outdir, accessInfo, }: {
+    server: McpServer;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+    outdir: string;
+    accessInfo: AccessInfo;
+}): void;
 //# sourceMappingURL=get-endpoint-info.d.ts.map

package/dist/server/plugins/mcp/docs-mcp/tools/get-endpoint-info.js

@@ -1 +1 @@
-import{findDefinitionByName as h,resolveParameters as T,resolveRequestBody as g,resolveResponses as P}from"../utils.js";import{checkEndpointAndDeleteXMcp as v}from"../../utils/xmcp-utils.js";import{telemetry as a}from"../../../../telemetry/index.js";const s="get-endpoint-info",c=["GET","POST","PUT","DELETE","PATCH","OPTIONS","HEAD","TRACE"],O={type:"object",required:["name","path","method"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1},path:{type:"string",description:"Endpoint path (e.g. /api/v1/users)",minLength:1},method:{type:"string",description:"HTTP method (GET, POST, PUT, DELETE, etc.)",enum:[...c,...c.map(n=>n.toLowerCase())],minLength:1}}};function M(n,d){n.tool(s,"Get comprehensive information about specific endpoint including parameters, security, and examples",O,async({name:i,path:o,method:p})=>{try{const e=h(d,i),m=o.startsWith("/")?o:`/${o}`;if(!e)return{content:[{type:"text",text:`No APIs found matching "${i}"`}]};const{title:l=""}=e.info||{},r=e.paths?.[m],u=p.toLowerCase();if(!r)return{content:[{type:"text",text:"Endpoint not found"}],isError:!0};const t=r[u];if(!t||!v(t,"docs"))return{content:[{type:"text",text:"Endpoint not found"}],isError:!0};const y=r?.parameters||[],E=t.parameters||[],f={...t,parameters:T({pathParams:y,opParams:E,definition:e}),requestBody:g(t.requestBody,e),responses:P(t.responses,e)};return a.sendMcpToolCalledMessage({server_type:"docs",tool:s}),{content:[{type:"text",text:JSON.stringify({api:l,version:e.info?.version||"",servers:e.servers||[],endpoint:{path:o,method:p.toUpperCase(),...f},globalSecurity:e.security||[],securitySchemes:e.components?.securitySchemes||[]},null,2)}]}}catch(e){throw a.sendMcpErrorMessage({server_type:"docs",tool:s,message:e?.message||"",stack:e?.stack||""}),e}})}export{M as registerGetEndpointTools};
+import{findApiDescriptionByName as P,resolveParameters as v,resolveRequestBody as x,resolveResponses as O}from"../utils.js";import{checkEndpointAndDeleteXMcp as S}from"../../utils/xmcp-utils.js";import{telemetry as c}from"../../../../telemetry/index.js";import{getApiDescriptionFromFs as A}from"./utils.js";const p="get-endpoint-info",d=["GET","POST","PUT","DELETE","PATCH","OPTIONS","HEAD","TRACE"],L={type:"object",required:["name","path","method"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1},path:{type:"string",description:"Endpoint path (e.g. /api/v1/users)",minLength:1},method:{type:"string",description:"HTTP method (GET, POST, PUT, DELETE, etc.)",enum:[...d,...d.map(n=>n.toLowerCase())],minLength:1}}};function N({server:n,apiDescriptionsMap:m,outdir:l,accessInfo:u}){n.tool(p,"Get comprehensive information about specific endpoint including parameters, security, and examples",L,async({name:s,path:r,method:a})=>{try{const t=P(m,s);if(!t)return{content:[{type:"text",text:`No API found matching "${s}".`}]};const e=await A({relativePath:t?.relativePath||"",outdir:l,accessInfo:u});if(!e)return{content:[{type:"text",text:`Spec not found from the file system with "${s}".`}]};const f=r.startsWith("/")?r:`/${r}`,{title:y=""}=e.info||{},i=e.paths?.[f],h=a.toLowerCase();if(!i)return{content:[{type:"text",text:"Endpoint not found"}],isError:!0};const o=i[h];if(!o||!S(o,"docs"))return{content:[{type:"text",text:"Endpoint not found"}],isError:!0};const E=i?.parameters||[],T=o.parameters||[],g={...o,parameters:v({pathParams:E,opParams:T,definition:e}),requestBody:x(o.requestBody,e),responses:O(o.responses,e)};return c.sendMcpToolCalledMessage({server_type:"docs",tool:p}),{content:[{type:"text",text:JSON.stringify({api:y,version:e.info?.version||"",servers:e.servers||[],endpoint:{path:r,method:a.toUpperCase(),...g},globalSecurity:e.security||[],securitySchemes:e.components?.securitySchemes||[]},null,2)}]}}catch(t){throw c.sendMcpErrorMessage({server_type:"docs",tool:p,message:t?.message||"",stack:t?.stack||""}),t}})}export{N as registerGetEndpointTools};

package/dist/server/plugins/mcp/docs-mcp/tools/get-endpoints.d.ts

@@ -1,4 +1,9 @@
 import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
-import type { OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
-export declare function registerGetEndpointsTools(server: McpServer, definitions: OpenAPIDefinition[]): void;
+import type { AccessInfo, ApiDescriptionInfo } from '../../types.js';
+export declare function registerGetEndpointsTools({ server, apiDescriptionsMap, outdir, accessInfo, }: {
+    server: McpServer;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+    outdir: string;
+    accessInfo: AccessInfo;
+}): void;
 //# sourceMappingURL=get-endpoints.d.ts.map

package/dist/server/plugins/mcp/docs-mcp/tools/get-endpoints.js

@@ -1 +1 @@
-import{findDefinitionByName as p}from"../utils.js";import{getEndpointsFromPaths as c}from"./utils.js";import{telemetry as r}from"../../../../telemetry/index.js";const e="get-endpoints",a={type:"object",required:["name"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1}}};function m(s,i){s.tool(e,"Get all endpoints for a specific API",a,async({name:o})=>{try{const t=p(i,o);if(!t)return{content:[{type:"text",text:`No APIs found matching "${o}"`}]};const n=c(t);return n.length===0?{content:[{type:"text",text:"No endpoints found"}]}:(r.sendMcpToolCalledMessage({server_type:"docs",tool:e}),{content:[{type:"text",text:JSON.stringify({api:t.info?.title||"",version:t.info?.version||"",servers:t.servers||[],endpoints:n},null,2)}]})}catch(t){throw r.sendMcpErrorMessage({server_type:"docs",tool:e,message:t?.message||"",stack:t?.stack||""}),t}})}export{m as registerGetEndpointsTools};
+import{findApiDescriptionByName as f}from"../utils.js";import{getApiDescriptionFromFs as d,getEndpointsFromPaths as l}from"./utils.js";import{telemetry as i}from"../../../../telemetry/index.js";const n="get-endpoints",m={type:"object",required:["name"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1}}};function u({server:s,apiDescriptionsMap:p,outdir:c,accessInfo:a}){s.tool(n,"Get all endpoints for a specific API",m,async({name:o})=>{try{const t=f(p,o);if(!t)return{content:[{type:"text",text:`No API found matching "${o}".`}]};const e=await d({relativePath:t?.relativePath||"",outdir:c,accessInfo:a});if(!e)return{content:[{type:"text",text:`Spec not found from the file system with "${o}".`}]};const r=l(e);return r.length===0?{content:[{type:"text",text:"No endpoints found"}]}:(i.sendMcpToolCalledMessage({server_type:"docs",tool:n}),{content:[{type:"text",text:JSON.stringify({api:e.info?.title||"",version:e.info?.version||"",servers:e.servers||[],endpoints:r},null,2)}]})}catch(t){throw i.sendMcpErrorMessage({server_type:"docs",tool:n,message:t?.message||"",stack:t?.stack||""}),t}})}export{u as registerGetEndpointsTools};

package/dist/server/plugins/mcp/docs-mcp/tools/get-full-api-description.d.ts

@@ -1,4 +1,9 @@
-import type { OpenAPIDefinition } from '@redocly/openapi-docs';
 import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
-export declare function registerGetFullApiDescriptionTools(server: McpServer, definitions: OpenAPIDefinition[]): void;
+import type { AccessInfo, ApiDescriptionInfo } from '../../types.js';
+export declare function registerGetFullApiDescriptionTools({ server, apiDescriptionsMap, outdir, accessInfo, }: {
+    server: McpServer;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+    outdir: string;
+    accessInfo: AccessInfo;
+}): void;
 //# sourceMappingURL=get-full-api-description.d.ts.map

package/dist/server/plugins/mcp/docs-mcp/tools/get-full-api-description.js

@@ -1 +1 @@
-import{findDefinitionByName as s}from"../utils.js";import{telemetry as r}from"../../../../telemetry/index.js";const t="get-full-api-description",p={type:"object",required:["name"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1}}};function l(i,n){i.tool(t,"Get the complete OpenAPI description",p,async({name:o})=>{try{const e=s(n,o);return e?(r.sendMcpToolCalledMessage({server_type:"docs",tool:t}),{content:[{type:"text",text:JSON.stringify({api:e.info?.title||"",version:e.info?.version||"",definition:e},null,2)}]}):{content:[{type:"text",text:`No APIs found matching "${o}"`}]}}catch(e){throw r.sendMcpErrorMessage({server_type:"docs",tool:t,message:e?.message||"",stack:e?.stack||""}),e}})}export{l as registerGetFullApiDescriptionTools};
+import{findApiDescriptionByName as a}from"../utils.js";import{telemetry as r}from"../../../../telemetry/index.js";import{getApiDescriptionFromFs as l}from"./utils.js";const i="get-full-api-description",f={type:"object",required:["name"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1}}};function g({server:n,apiDescriptionsMap:s,outdir:p,accessInfo:c}){n.tool(i,"Get the complete OpenAPI description",f,async({name:o})=>{try{const t=a(s,o);if(!t)return{content:[{type:"text",text:`No API found matching "${o}".`}]};const e=await l({relativePath:t?.relativePath||"",outdir:p,accessInfo:c});return e?(r.sendMcpToolCalledMessage({server_type:"docs",tool:i}),{content:[{type:"text",text:JSON.stringify({api:e.info?.title||"",version:e.info?.version||"",definition:e},null,2)}]}):{content:[{type:"text",text:`Spec not found from the file system with "${o}".`}]}}catch(t){throw r.sendMcpErrorMessage({server_type:"docs",tool:i,message:t?.message||"",stack:t?.stack||""}),t}})}export{g as registerGetFullApiDescriptionTools};

package/dist/server/plugins/mcp/docs-mcp/tools/get-security-schemes.d.ts

@@ -1,4 +1,9 @@
-import type { OpenAPIDefinition } from '@redocly/openapi-docs';
 import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
-export declare function registerGetSecuritySchemesTools(server: McpServer, definitions: OpenAPIDefinition[]): void;
+import type { AccessInfo, ApiDescriptionInfo } from '../../types.js';
+export declare function registerGetSecuritySchemesTools({ server, apiDescriptionsMap, outdir, accessInfo, }: {
+    server: McpServer;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+    outdir: string;
+    accessInfo: AccessInfo;
+}): void;
 //# sourceMappingURL=get-security-schemes.d.ts.map

package/dist/server/plugins/mcp/docs-mcp/tools/get-security-schemes.js

@@ -1 +1 @@
-import{findDefinitionByName as n}from"../utils";import{telemetry as r}from"../../../../telemetry/index.js";const t="get-security-schemes",c={type:"object",required:["name"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1}}};function p(o,i){o.tool(t,"Get the security schemes for a specific API",c,async({name:s})=>{try{const e=n(i,s);return e?(r.sendMcpToolCalledMessage({server_type:"docs",tool:t}),{content:[{type:"text",text:JSON.stringify({name:e.info?.title,version:e.info?.version,securitySchemes:e.components?.securitySchemes||[],security:e.security||[]},null,2)}]}):{content:[{type:"text",text:`No APIs found matching "${s}"`}]}}catch(e){throw r.sendMcpErrorMessage({server_type:"docs",tool:t,message:e?.message||"",stack:e?.stack||""}),e}})}export{p as registerGetSecuritySchemesTools};
+import{findApiDescriptionByName as a}from"../utils";import{telemetry as i}from"../../../../telemetry/index.js";import{getApiDescriptionFromFs as m}from"./utils.js";const o="get-security-schemes",y={type:"object",required:["name"],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",minLength:1}}};function h({server:s,apiDescriptionsMap:n,outdir:c,accessInfo:p}){s.tool(o,"Get the security schemes for a specific API",y,async({name:r})=>{try{const e=a(n,r);if(!e)return{content:[{type:"text",text:`No API found matching "${r}".`}]};const t=await m({relativePath:e?.relativePath||"",outdir:c,accessInfo:p});return t?(i.sendMcpToolCalledMessage({server_type:"docs",tool:o}),{content:[{type:"text",text:JSON.stringify({name:t.info?.title,version:t.info?.version,securitySchemes:t.components?.securitySchemes||[],security:t.security||[]},null,2)}]}):{content:[{type:"text",text:`Spec not found from the file system with "${r}".`}]}}catch(e){throw i.sendMcpErrorMessage({server_type:"docs",tool:o,message:e?.message||"",stack:e?.stack||""}),e}})}export{h as registerGetSecuritySchemesTools};

package/dist/server/plugins/mcp/docs-mcp/tools/index.d.ts

@@ -1,13 +1,14 @@
 import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
-import type { OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
+import type { AccessInfo, ApiDescriptionInfo } from '../../types.js';
 /**
  * Registers all tools with the MCP server
  */
-export declare function registerDocsTools({ server, definitions, baseUrl, outdir, headers, }: {
+export declare function registerDocsTools({ server, baseUrl, outdir, apiDescriptionsMap, headers, accessInfo, }: {
     server: McpServer;
-    definitions: OpenAPIDefinition[];
     baseUrl: string;
     outdir: string;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+    accessInfo: AccessInfo;
     headers?: Record<string, string | string[] | undefined>;
 }): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/mcp/docs-mcp/tools/index.js

@@ -1 +1 @@
-import{registerListApisTools as i}from"./list-apis.js";import{registerGetEndpointsTools as l}from"./get-endpoints.js";import{registerGetEndpointTools as s}from"./get-endpoint-info.js";import{registerGetSecuritySchemesTools as e}from"./get-security-schemes.js";import{registerGetFullApiDescriptionTools as g}from"./get-full-api-description.js";import{registerSearchTool as T}from"./search.js";import{registerWhoAmITool as c}from"./whoami.js";function E({server:o,definitions:t,baseUrl:m,outdir:p,headers:r}){c(o,r),i(o,t),l(o,t),s(o,t),e(o,t),g(o,t),T(o,m,p,r)}export{E as registerDocsTools};
+import{registerListApisTools as g}from"./list-apis.js";import{registerGetEndpointsTools as T}from"./get-endpoints.js";import{registerGetEndpointTools as e}from"./get-endpoint-info.js";import{registerGetSecuritySchemesTools as f}from"./get-security-schemes.js";import{registerGetFullApiDescriptionTools as h}from"./get-full-api-description.js";import{registerSearchTool as A}from"./search.js";import{registerWhoAmITool as G}from"./whoami.js";import{shouldHandleMcpAuth as p}from"../../auth/auth-handlers.js";function F({server:o,baseUrl:l,outdir:m,apiDescriptionsMap:r,headers:i,accessInfo:t}){p(t.requiresLogin,t.rbac)&&G(o,i),g({server:o,apiDescriptionsMap:r}),T({server:o,apiDescriptionsMap:r,outdir:m,accessInfo:t}),e({server:o,apiDescriptionsMap:r,outdir:m,accessInfo:t}),f({server:o,apiDescriptionsMap:r,outdir:m,accessInfo:t}),h({server:o,apiDescriptionsMap:r,outdir:m,accessInfo:t}),A(o,l,m,i)}export{F as registerDocsTools};

package/dist/server/plugins/mcp/docs-mcp/tools/list-apis.d.ts

@@ -1,4 +1,7 @@
-import type { OpenAPIDefinition } from '@redocly/openapi-docs';
 import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
-export declare function registerListApisTools(server: McpServer, definitions: OpenAPIDefinition[]): void;
+import type { ApiDescriptionInfo } from '../../types.js';
+export declare function registerListApisTools({ server, apiDescriptionsMap, }: {
+    server: McpServer;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+}): void;
 //# sourceMappingURL=list-apis.d.ts.map

package/dist/server/plugins/mcp/docs-mcp/tools/list-apis.js

@@ -1 +1 @@
-import{findAllDefinitionsByName as p}from"../utils.js";import{telemetry as a}from"../../../../telemetry/index.js";const r="list-apis",n={type:"object",required:[],additionalProperties:!1,properties:{name:{type:"string",description:"API name (or part of it)",nullable:!0}}};function y(l,o){l.tool(r,"Lists available APIs with their context and purpose",n,async({name:s})=>{try{let e=o;return s&&s!=="null"&&(e=p(o,s)),e.length===0?{content:[{type:"text",text:s?`No APIs found matching "${s}"`:"No APIs available"}]}:(a.sendMcpToolCalledMessage({server_type:"docs",tool:r}),{content:e.map(t=>({type:"text",text:JSON.stringify({name:t.info?.title||"",description:t.info?.description||"",version:t.info?.version||"",paths:Object.keys(t.paths||{}).length,schemas:Object.keys(t.components?.schemas||{}).length,servers:t.servers||[]},null,2)}))})}catch(e){throw a.sendMcpErrorMessage({server_type:"docs",tool:r,message:e?.message||"",stack:e?.stack||""}),e}})}export{y as registerListApisTools};
+import{telemetry as a}from"../../../../telemetry/index.js";import{filterApiDescriptionsByName as g}from"../utils.js";const r="list-apis",f={type:"object",additionalProperties:!1,required:[],properties:{filter:{type:"string",description:"API name (or part of it)",minLength:1},page:{type:"number",description:"Page number",minimum:1,default:1},limit:{type:"number",description:"Number of APIs per page. Default is 300",minimum:1,default:300}}};function b({server:p,apiDescriptionsMap:c}){p.tool(r,"Lists available APIs with their context and purpose",f,async({filter:o,page:i=1,limit:t=300})=>{let e=Object.values(c);o&&(e=g(e,o));const n=(i-1)*t,l=n+t,m=Math.ceil(e.length/t),d=e.length;e=e.slice(n,l);try{return e.length===0?{content:[{type:"text",text:"No APIs available"}]}:(a.sendMcpToolCalledMessage({server_type:"docs",tool:r}),{content:[{type:"text",text:JSON.stringify({items:e.map(({relativePath:s,...u})=>u),limit:t,total:d,page:i,totalPages:m})}]})}catch(s){throw a.sendMcpErrorMessage({server_type:"docs",tool:r,message:s?.message||"",stack:s?.stack||""}),s}})}export{b as registerListApisTools};

package/dist/server/plugins/mcp/docs-mcp/tools/utils.d.ts

@@ -1,10 +1,16 @@
 import type { OpenAPIDefinition, OpenAPIOperation } from '@redocly/openapi-docs';
 import type { SearchItemData } from '@redocly/theme/core/types';
+import type { AccessInfo } from '../../types';
 type EndpointInfo = Pick<OpenAPIOperation, 'summary' | 'description' | 'security'> & {
     method: string;
     path: string;
 };
 export declare function getEndpointsFromPaths(def: OpenAPIDefinition): EndpointInfo[];
 export declare function processDocuments(documents: Record<string, SearchItemData[]>, outdir: string): string;
+export declare function getApiDescriptionFromFs({ relativePath, outdir, accessInfo: { isAuthenticated, email, teams, rbac, requiresLogin }, }: {
+    relativePath: string;
+    outdir: string;
+    accessInfo: AccessInfo;
+}): Promise<OpenAPIDefinition | undefined>;
 export {};
 //# sourceMappingURL=utils.d.ts.map

package/dist/server/plugins/mcp/docs-mcp/tools/utils.js

@@ -1,11 +1,11 @@
-import u from"node:fs";import y from"node:path";import{checkEndpointAndDeleteXMcp as x}from"../../utils/xmcp-utils.js";import{MAX_DOCUMENTS_PER_CATEGORY as O}from"../../constants.js";function E(s){const{paths:c={}}=s,a=[];for(const[l,n]of Object.entries(c)){const f=!x(n,"docs");for(const[m,t]of Object.entries(n))f||!x(t,"docs")||a.push({path:l,method:m.toUpperCase(),summary:t.summary,description:t.description,security:t.security})}return a}function k(s,c){return Object.entries(s).map(([l,n])=>{if(!n||n.length===0)return"";const f=n.slice(0,O).map(m=>{const{document:t,highlight:p}=m,g=p?.title||(Array.isArray(t.title)?t.title[0]:t.title);let r=`Document: ${t.title}`;r+=`### [${g}](${t.url})
+import y from"node:fs";import u from"node:path";import{existsSync as A}from"node:fs";import{readFile as O}from"node:fs/promises";import{replaceFileExtension as g}from"../../../../plugins/openapi-docs/store-definition-bundles";import{PUBLIC_API_DEFINITIONS_FOLDER as j}from"../../../../constants/common";import{filterDataByAccessDeep as F}from"../../../../utils/rbac";import{checkEndpointAndDeleteXMcp as D}from"../../utils/xmcp-utils.js";import{MAX_DOCUMENTS_PER_CATEGORY as C}from"../../constants.js";function T(i){const{paths:o={}}=i,s=[];for(const[c,n]of Object.entries(o)){const a=!D(n,"docs");for(const[f,t]of Object.entries(n))a||!D(t,"docs")||s.push({path:c,method:f.toUpperCase(),summary:t.summary,description:t.description,security:t.security})}return s}function M(i,o){return Object.entries(i).map(([c,n])=>{if(!n||n.length===0)return"";const a=n.slice(0,C).map(f=>{const{document:t,highlight:m}=f,d=m?.title||(Array.isArray(t.title)?t.title[0]:t.title);let r=`Document: ${t.title}`;r+=`### [${d}](${t.url})
 
-`;let i;if(t.url)try{let e=t.url.startsWith("/")?t.url.slice(1):t.url;const o=e.indexOf("#");o!==-1&&(e=e.substring(0,o));const d=y.extname(e);d&&(e=e.slice(0,-d.length));let A=e+".md";const h=y.join(c,A);u.existsSync(h)&&(i=u.readFileSync(h,"utf8"))}catch{}return i||(i=p?.text||(Array.isArray(t.text)?t.text[0]:t.text)),r+=i,t.facets&&(r+=`
+`;let p;if(t.url)try{let e=t.url.startsWith("/")?t.url.slice(1):t.url;const l=e.indexOf("#");l!==-1&&(e=e.substring(0,l));const h=u.extname(e);h&&(e=e.slice(0,-h.length));let E=e+".md";const x=u.join(o,E);y.existsSync(x)&&(p=y.readFileSync(x,"utf8"))}catch{}return p||(p=m?.text||(Array.isArray(t.text)?t.text[0]:t.text)),r+=p,t.facets&&(r+=`
 
 **Categories:**
-`,Object.entries(t.facets).forEach(([e,o])=>{r+=`- ${e}: ${o}
-`})),r});return`## ${l}
+`,Object.entries(t.facets).forEach(([e,l])=>{r+=`- ${e}: ${l}
+`})),r});return`## ${c}
 
-${f}`}).join(`
+${a}`}).join(`
 
-`).trim()}export{E as getEndpointsFromPaths,k as processDocuments};
+`).trim()}async function R({relativePath:i,outdir:o,accessInfo:{isAuthenticated:s,email:c,teams:n,rbac:a={},requiresLogin:f=!1}}){const t=u.join(o||"",j,g(i,".json"));if(!A(t))return;const d=await O(t,"utf-8"),r=JSON.parse(d);return F(r,{isAuthenticated:s,email:c,teams:n},a,f)}export{R as getApiDescriptionFromFs,T as getEndpointsFromPaths,M as processDocuments};

package/dist/server/plugins/mcp/docs-mcp/tools/whoami.js

@@ -1 +1 @@
-import{telemetry as r}from"../../../../telemetry/index";import{getUserInfoFromHeaders as s}from"../../utils/jwt";const t="whoami";function c(o,n){o.tool(t,"Get information about the currently authenticated user",()=>{try{const e=s(n||{});return e?(r.sendMcpToolCalledMessage({server_type:"docs",tool:t}),{content:[{type:"text",text:JSON.stringify({email:e.email,name:e.name,subject:e.sub,clientId:e.client_id,scope:e.scope,issuedAt:e.iat?new Date(e.iat*1e3).toISOString():void 0,expiresAt:e.exp?new Date(e.exp*1e3).toISOString():void 0})}],isError:!1}):{content:[{type:"text",text:JSON.stringify({error:"Not authenticated",message:"No valid authentication token found. Please authenticate first."})}],isError:!0}}catch(e){return r.sendMcpErrorMessage({server_type:"docs",tool:t,message:e?.message||"Failed to get user info",stack:e?.stack||""}),{content:[{type:"text",text:JSON.stringify({error:"Failed to get user info",details:e instanceof Error?e.message:String(e)})}],isError:!0}}})}export{c as registerWhoAmITool};
+import{telemetry as r}from"../../../../telemetry/index";import{getUserInfoFromHeaders as s}from"../../utils/jwt";const t="whoami";function c(o,n){o.tool(t,"Get information about the currently authenticated user",()=>{try{const e=s(n||{});return r.sendMcpToolCalledMessage({server_type:"docs",tool:t}),e?{content:[{type:"text",text:JSON.stringify({email:e.email,name:e.name,subject:e.sub,clientId:e.client_id,scope:e.scope,issuedAt:e.iat?new Date(e.iat*1e3).toISOString():void 0,expiresAt:e.exp?new Date(e.exp*1e3).toISOString():void 0})}],isError:!1}:{content:[{type:"text",text:JSON.stringify({error:"Not authenticated",message:"No valid authentication token found. Please authenticate first."})}],isError:!0}}catch(e){return r.sendMcpErrorMessage({server_type:"docs",tool:t,message:e?.message||"Failed to get user info",stack:e?.stack||""}),{content:[{type:"text",text:JSON.stringify({error:"Failed to get user info",details:e instanceof Error?e.message:String(e)})}],isError:!0}}})}export{c as registerWhoAmITool};

package/dist/server/plugins/mcp/docs-mcp/utils.d.ts

@@ -1,7 +1,7 @@
 import type { OpenAPISchema, OpenAPIParameter, OpenAPIResponse, OpenAPIRequestBody, Referenced, OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
-import type { McpServerType } from '../types';
-export declare function findDefinitionByName(openapiDefinitions: OpenAPIDefinition[], name: string, serverType?: McpServerType): OpenAPIDefinition | undefined;
-export declare function findAllDefinitionsByName(openapiDefinitions: OpenAPIDefinition[], name: string, serverType?: McpServerType): OpenAPIDefinition[];
+import type { ApiDescriptionInfo } from '../types.js';
+export declare function findApiDescriptionByName(apiDescriptionsMap: Record<string, ApiDescriptionInfo>, name: string): ApiDescriptionInfo | undefined;
+export declare function filterApiDescriptionsByName(apiDescriptionsMap: ApiDescriptionInfo[], filter: string): ApiDescriptionInfo[];
 export declare function resolveRef<T>(ref: string, def?: OpenAPIDefinition): T | undefined;
 type ResolveSchemaRefsParams = {
     schema: Referenced<OpenAPISchema> | undefined;

package/dist/server/plugins/mcp/docs-mcp/utils.js

@@ -1 +1 @@
-import{isDefinitionHidden as $}from"../utils/xmcp-utils";function h(t,o,r="docs"){return t.find(({info:e})=>e?.title?.toLowerCase().includes(o.toLowerCase())&&!$(e,r))}function x(t,o,r="docs"){return t.filter(({info:e})=>e?.title?.toLowerCase().includes(o.toLowerCase())&&!$(e,r))}function d(t,o){if(!o||!t?.startsWith("#/"))return;const r=t.slice(2).split("/");let e=o;for(const s of r)if(typeof e=="object"&&e!==null&&s in e)e=e[s];else return;return e}function l({schema:t,definition:o,visitedRefs:r=new Set,maxDepth:e=50,currentDepth:s=0}){if(!t)return;if(s>=e)return{type:"object",description:`Maximum resolution depth exceeded (${e})`};if("$ref"in t&&t.$ref){if(r.has(t.$ref))return{type:"object",description:`Circular reference detected: ${t.$ref}`,"x-circular-ref":t.$ref};const f=new Set(r);f.add(t.$ref);const u=d(t.$ref,o);return u?l({schema:u,definition:o,visitedRefs:f,maxDepth:e,currentDepth:s+1}):{type:"object",description:`Could not resolve reference: ${t.$ref}`,"x-unresolved-ref":t.$ref}}const n={...t};if(n.properties){const f={};for(const[u,i]of Object.entries(n.properties)){const m=l({schema:i,definition:o,visitedRefs:new Set(r),maxDepth:e,currentDepth:s+1});f[u]=m||i}n.properties=f}if(n.items&&typeof n.items=="object")if(Array.isArray(n.items))n.items=n.items.map(f=>l({schema:f,definition:o,visitedRefs:new Set(r),maxDepth:e,currentDepth:s+1})||f);else{const f=l({schema:n.items,definition:o,visitedRefs:new Set(r),maxDepth:e,currentDepth:s+1});f&&(n.items=f)}return["allOf","anyOf","oneOf"].forEach(f=>{const u=n[f];Array.isArray(u)&&(n[f]=u.reduce((i,m)=>{const p=l({schema:m,definition:o,visitedRefs:new Set(r),maxDepth:e,currentDepth:s+1});return p&&i.push(p),i},[]))}),n}function w({pathParams:t,opParams:o,definition:r}){return[...t,...o].reduce((e,s)=>{if(!s)return e;if("$ref"in s&&s.$ref){const n=d(s.$ref,r);return n&&e.push({...n,schema:"schema"in n&&n.schema?l({schema:n.schema,definition:r}):void 0}),e}return e.push({...s,schema:"schema"in s&&s.schema?l({schema:s.schema,definition:r}):void 0}),e},[])}function a(t,o){const r={...t};if(t.example!==void 0&&(r.example=t.example),!t.examples)return r;const e={};for(const[s,n]of Object.entries(t.examples))if("$ref"in n){const c=d(n.$ref,o);c&&(e[s]=c)}else e[s]=n;return r.examples=e,r}function y(t,o){if(!t)return;const r="$ref"in t&&t.$ref?d(t.$ref,o):t;if(!r)return;const e={...r};if("content"in r&&r.content){const s={};for(const[n,c]of Object.entries(r.content))s[n]={...a(c,o),schema:c.schema?l({schema:c.schema,definition:o}):void 0};e.content=s}return e}function b(t,o){return Object.entries(t).reduce((r,[e,s])=>{const n="$ref"in s&&s.$ref?d(s.$ref,o):s;if(!n)return r;const c={...n};if("content"in n&&n.content){const f={};for(const[u,i]of Object.entries(n.content))f[u]={...a(i,o),schema:i.schema?l({schema:i.schema,definition:o}):void 0};c.content=f}return r[e]=c,r},{})}export{x as findAllDefinitionsByName,h as findDefinitionByName,w as resolveParameters,d as resolveRef,y as resolveRequestBody,b as resolveResponses,l as resolveSchemaRefs};
+function a(e,o){if(o)return e[o.toLowerCase()]}function v(e,o){return Object.values(e).filter(({name:n})=>n.toLowerCase().includes(o.toLowerCase()))}function d(e,o){if(!o||!e?.startsWith("#/"))return;const n=e.slice(2).split("/");let t=o;for(const s of n)if(typeof t=="object"&&t!==null&&s in t)t=t[s];else return;return t}function l({schema:e,definition:o,visitedRefs:n=new Set,maxDepth:t=50,currentDepth:s=0}){if(!e)return;if(s>=t)return{type:"object",description:`Maximum resolution depth exceeded (${t})`};if("$ref"in e&&e.$ref){if(n.has(e.$ref))return{type:"object",description:`Circular reference detected: ${e.$ref}`,"x-circular-ref":e.$ref};const f=new Set(n);f.add(e.$ref);const u=d(e.$ref,o);return u?l({schema:u,definition:o,visitedRefs:f,maxDepth:t,currentDepth:s+1}):{type:"object",description:`Could not resolve reference: ${e.$ref}`,"x-unresolved-ref":e.$ref}}const r={...e};if(r.properties){const f={};for(const[u,i]of Object.entries(r.properties)){const p=l({schema:i,definition:o,visitedRefs:new Set(n),maxDepth:t,currentDepth:s+1});f[u]=p||i}r.properties=f}if(r.items&&typeof r.items=="object")if(Array.isArray(r.items))r.items=r.items.map(f=>l({schema:f,definition:o,visitedRefs:new Set(n),maxDepth:t,currentDepth:s+1})||f);else{const f=l({schema:r.items,definition:o,visitedRefs:new Set(n),maxDepth:t,currentDepth:s+1});f&&(r.items=f)}return["allOf","anyOf","oneOf"].forEach(f=>{const u=r[f];Array.isArray(u)&&(r[f]=u.reduce((i,p)=>{const m=l({schema:p,definition:o,visitedRefs:new Set(n),maxDepth:t,currentDepth:s+1});return m&&i.push(m),i},[]))}),r}function h({pathParams:e,opParams:o,definition:n}){return[...e,...o].reduce((t,s)=>{if(!s)return t;if("$ref"in s&&s.$ref){const r=d(s.$ref,n);return r&&t.push({...r,schema:"schema"in r&&r.schema?l({schema:r.schema,definition:n}):void 0}),t}return t.push({...s,schema:"schema"in s&&s.schema?l({schema:s.schema,definition:n}):void 0}),t},[])}function $(e,o){const n={...e};if(e.example!==void 0&&(n.example=e.example),!e.examples)return n;const t={};for(const[s,r]of Object.entries(e.examples))if("$ref"in r){const c=d(r.$ref,o);c&&(t[s]=c)}else t[s]=r;return n.examples=t,n}function x(e,o){if(!e)return;const n="$ref"in e&&e.$ref?d(e.$ref,o):e;if(!n)return;const t={...n};if("content"in n&&n.content){const s={};for(const[r,c]of Object.entries(n.content))s[r]={...$(c,o),schema:c.schema?l({schema:c.schema,definition:o}):void 0};t.content=s}return t}function w(e,o){return Object.entries(e).reduce((n,[t,s])=>{const r="$ref"in s&&s.$ref?d(s.$ref,o):s;if(!r)return n;const c={...r};if("content"in r&&r.content){const f={};for(const[u,i]of Object.entries(r.content))f[u]={...$(i,o),schema:i.schema?l({schema:i.schema,definition:o}):void 0};c.content=f}return n[t]=c,n},{})}export{v as filterApiDescriptionsByName,a as findApiDescriptionByName,h as resolveParameters,d as resolveRef,x as resolveRequestBody,w as resolveResponses,l as resolveSchemaRefs};

package/dist/server/plugins/mcp/handlers/docs-mcp-handler.js

@@ -1 +1 @@
-import{createMcpRequestHandler as v}from"./mcp-request-handler.js";import{createDocsMcpServer as M}from"../servers/docs-server.js";import{filterDefinitionsByRbac as D}from"../utils.js";import{createInternalServerError as h}from"./errors.js";import{McpServerType as y}from"../constants.js";import{telemetry as c}from"../../../telemetry/index.js";import{constructInvalidTokenResponse as R,constructUnauthorizedResponse as S,handleMcpAuth as w,shouldHandleMcpAuth as I}from"../auth/auth-handlers.js";async function T(t,r,o,s){try{c.initialize();const e=r,n=e?.props?.config?.openapiDefinitions||[],a=e?.props?.config?.outdir||"",p=e?.props?.config?.catalogName||"Docs MCP server",f=new URL(s.url).origin,{user:i,config:{rbac:m={},mcp:d={}}}=t,l=D(n,i,m,!!i?.isAuthenticated).map(({definition:g})=>g),u=d.docs?.name||p;return await M(l,u,f,o,a)}catch(e){throw c.sendMcpErrorMessage({server_type:"docs",message:e?.message||"",stack:e?.stack||""}),h(e?.message||"Internal server error mcp docs")}}const U=v({createServerInstance:T,serverType:y.Docs}),b=async(t,r,o)=>{if(I(r)){const{isAuthenticated:s,isTokenValid:e,currentUser:n}=await w(t,r);if(!s)return S(new URL(t.url).origin);if(!e)return R();n&&(r.user=n)}return U(t,r,o)};var B=b;export{B as default};
+import{createMcpRequestHandler as D}from"./mcp-request-handler.js";import{createDocsMcpServer as v}from"../servers/docs-server.js";import{filterApiDescriptionsByRbac as h}from"../utils.js";import{createInternalServerError as y}from"./errors.js";import{McpServerType as m}from"../constants.js";import{telemetry as f}from"../../../telemetry/index.js";import{constructInvalidTokenResponse as A,constructUnauthorizedResponse as L,handleMcpAuth as S,shouldHandleMcpAuth as b}from"../auth/auth-handlers.js";async function I(r,s,i,n){try{f.initialize();const e=s,t=e?.props?.config?.apiDescriptionsMap||{},a=e?.props?.outdir||"",o=e?.props?.config?.mcpDocsServerName||"Docs MCP server",u=new URL(n.url).origin,{user:c,config:{rbac:p={},mcp:l={}}}=r,d=h(t,c,p,r.config.requiresLogin||!1),g=l.docs?.name||o,M={rbac:p,email:c?.email,teams:c?.teams,isAuthenticated:!!c?.isAuthenticated,requiresLogin:r.config.requiresLogin||!1};return await v({name:g,baseUrl:u,headers:i,apiDescriptionsMap:d,outdir:a,accessInfo:M})}catch(e){throw f.sendMcpErrorMessage({server_type:m.Docs,message:e?.message||"",stack:e?.stack||""}),y(e?.message||"Internal server error mcp docs")}}const R=D({createServerInstance:I,serverType:m.Docs}),w=async(r,s,i)=>{const n=!!s?.config?.requiresLogin,e=s?.config?.rbac;if(b(n,e)){const{isAuthenticated:t,isTokenValid:a,currentUser:o}=await S(r,s);if(!t)return L(new URL(r.url).origin);if(!a)return A();o&&(s.user=o)}return R(r,s,i)};var E=w;export{E as default};

package/dist/server/plugins/mcp/index.js

@@ -1 +1 @@
-import{fileURLToPath as m}from"node:url";import{dirname as f,join as l}from"node:path";import{logger as a}from"../../tools/notifiers/logger.js";import{reporter as g}from"../../tools/notifiers/reporter.js";import{filterIgnoredDefinitions as u,getCleanedUpDefinitions as h,isMcpInRedirects as D}from"./utils.js";import{telemetryTraceStep as v}from"../../../cli/telemetry/helpers/trace-step.js";const c="mcp-docs-server-handler",y=f(m(import.meta.url));async function C(){return{id:"mcp",async processContent(i,o){await v("build.plugin.mcp",async r=>{const t=await i.loadOpenApiDefinitions(o),n=await o.getConfig(),{mcp:e,redirects:s}=n;if(r?.setAttribute("config",JSON.stringify(e||{})),!(e?.hide||e?.docs?.hide)&&(D(s)&&await g.panicOnBuildContentError('The reserved route "/mcp" cannot be used in redirect configuration. Please remove any redirects involving "/mcp" from your redocly.yaml config.'),!e?.docs?.hide)){a.info("Configuring MCP servers...");const d=l(y,"./handlers/docs-mcp-handler.js"),p=h(u(t,e?.docs?.ignore||[]));await P(i,d,p,e,i.outdir)}})},async afterRoutesCreated(i,o){const r=await o.getConfig(),{mcp:t}=r;i.setGlobalData({mcpData:{docs:{enabled:!t?.hide&&!t?.docs?.hide,name:t?.docs?.name}}})}}}var E=C;async function P(i,o,r,t,n){i.createRequestHandler(c,o),i.addApiRoute({slug:"/mcp",requestHandlerId:c,httpMethod:"all",getStaticData:async()=>({props:{config:{openapiDefinitions:r.map(e=>({definition:e.definition,relativePath:e.relativePath})),outdir:n,catalogName:t?.docs?.name||"Docs MCP Server"}}})}),a.info("Registered Docs MCP Server endpoint at /mcp")}export{c as MCP_DOCS_SERVER_HANDLER_ID,E as default,C as mcpServerPlugin};
+import{fileURLToPath as g}from"node:url";import{dirname as u,join as D}from"node:path";import{logger as a}from"../../tools/notifiers/logger.js";import{reporter as h}from"../../tools/notifiers/reporter.js";import{filterIgnoredApiDescriptions as v,getCleanedUpApiDescriptions as C,isMcpInRedirects as y}from"./utils.js";import{telemetryTraceStep as P}from"../../../cli/telemetry/helpers/trace-step.js";const p="mcp-docs-server-handler",M=u(g(import.meta.url));async function R(){let o=!1;return{id:"mcp",async processContent(e,i){o||await P("build.plugin.mcp",async n=>{const s=await e.loadOpenApiDefinitions(i),d=await i.getConfig(),{mcp:r,redirects:f}=d;if(n?.setAttribute("config",JSON.stringify(r||{})),!(r?.hide||r?.docs?.hide)&&(y(f)&&await h.panicOnBuildContentError('The reserved route "/mcp" cannot be used in redirect configuration. Please remove any redirects involving "/mcp" from your redocly.yaml config.'),!r?.docs?.hide)){a.info("Configuring MCP servers...");const m=D(M,"./handlers/docs-mcp-handler.js"),l=C(v(s,r?.docs?.ignore||[])),c=new Map;for(const t of l)c.set(t.definition.info?.title?.toLowerCase()||"",{name:t.definition.info?.title||"",description:t.definition.info?.description||"",version:t.definition.info?.version||"",servers:t.definition.servers||[],relativePath:t.relativePath});await S({actions:e,handlerPath:m,apiDescriptionsMap:Object.fromEntries(c),mcpConfig:r}),o=!0}})},async afterRoutesCreated(e,i){const n=await i.getConfig(),{mcp:s}=n;e.setGlobalData({mcpData:{docs:{enabled:!s?.hide&&!s?.docs?.hide,name:s?.docs?.name}}})}}}var I=R;async function S({actions:o,handlerPath:e,apiDescriptionsMap:i,mcpConfig:n}){o.createRequestHandler(p,e),o.addApiRoute({slug:"/mcp",requestHandlerId:p,httpMethod:"all",getStaticData:async()=>({props:{config:{apiDescriptionsMap:i,mcpDocsServerName:n?.docs?.name||"Docs MCP Server"}}})}),a.info("Registered Docs MCP Server endpoint at /mcp")}export{p as MCP_DOCS_SERVER_HANDLER_ID,I as default,R as mcpServerPlugin};

package/dist/server/plugins/mcp/servers/docs-server.d.ts

@@ -1,5 +1,4 @@
-import type { OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
-import type { DocsServerDependencies, McpServerType } from '../types.js';
+import type { AccessInfo, ApiDescriptionInfo, DocsServerDependencies, McpServerType } from '../types.js';
 import { BaseMcpServer } from './base-server.js';
 export declare class DocsMcpServer extends BaseMcpServer {
     private readonly dependencies;
@@ -7,9 +6,17 @@ export declare class DocsMcpServer extends BaseMcpServer {
         baseUrl: string;
         headers: Record<string, string | string[] | undefined>;
         outdir: string;
+        accessInfo: AccessInfo;
     });
     protected registerTools(): void;
     protected getServerType(): McpServerType;
 }
-export declare function createDocsMcpServer(definitions: OpenAPIDefinition[], name: string, baseUrl: string, headers: Record<string, string | string[] | undefined>, outdir: string): Promise<import("../types.js").McpServerInstance>;
+export declare function createDocsMcpServer({ name, baseUrl, headers, apiDescriptionsMap, outdir, accessInfo, }: {
+    name: string;
+    baseUrl: string;
+    headers: Record<string, string | string[] | undefined>;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+    outdir: string;
+    accessInfo: AccessInfo;
+}): Promise<import("../types.js").McpServerInstance>;
 //# sourceMappingURL=docs-server.d.ts.map

package/dist/server/plugins/mcp/servers/docs-server.js

@@ -1 +1 @@
-import{BaseMcpServer as n}from"./base-server.js";import{registerDocsTools as o}from"../docs-mcp/tools/index.js";import{McpServerType as c}from"../constants.js";class p extends n{dependencies;constructor(e){super({name:e.name,version:new Date().toISOString().slice(0,10)}),this.dependencies=e}registerTools(){o({server:this.server,definitions:this.dependencies.definitions,baseUrl:this.dependencies.baseUrl,outdir:this.dependencies.outdir,headers:this.dependencies.headers})}getServerType(){return c.Docs}}async function m(r,e,s,i,t){return await new p({definitions:r,name:e,baseUrl:s,headers:i,outdir:t}).initialize()}export{p as DocsMcpServer,m as createDocsMcpServer};
+import{BaseMcpServer as c}from"./base-server.js";import{registerDocsTools as o}from"../docs-mcp/tools/index.js";import{McpServerType as p}from"../constants.js";class a extends c{dependencies;constructor(e){super({name:e.name,version:new Date().toISOString().slice(0,10)}),this.dependencies=e}registerTools(){o({server:this.server,apiDescriptionsMap:this.dependencies.apiDescriptionsMap,baseUrl:this.dependencies.baseUrl,outdir:this.dependencies.outdir,headers:this.dependencies.headers,accessInfo:this.dependencies.accessInfo})}getServerType(){return p.Docs}}async function S({name:r,baseUrl:e,headers:s,apiDescriptionsMap:i,outdir:t,accessInfo:n}){return await new a({name:r,baseUrl:e,headers:s,apiDescriptionsMap:i,outdir:t,accessInfo:n}).initialize()}export{a as DocsMcpServer,S as createDocsMcpServer};

package/dist/server/plugins/mcp/types.d.ts

@@ -1,11 +1,35 @@
 import type { OpenAPIPath } from '@redocly/openapi-docs/src/types';
 import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
 import type { StreamableHTTPServerTransport } from '@redocly/mcp-typescript-sdk/server/streamableHttp.js';
-import type { OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
+import type { OpenAPIServer } from '@redocly/openapi-docs/lib/types/open-api.js';
 import type { McpErrorCodes, McpServerType } from './constants';
+import type { RbacConfig, PageStaticData } from '@redocly/config';
 type ObjectValues<T> = T[keyof T];
 export type McpServerType = ObjectValues<typeof McpServerType>;
 export type McpErrorCodeTypes = ObjectValues<typeof McpErrorCodes>;
+export type AccessInfo = {
+    isAuthenticated: boolean;
+    email?: string;
+    teams?: string[];
+    rbac: RbacConfig;
+    requiresLogin: boolean;
+};
+export type ApiDescriptionInfo = {
+    name: string;
+    relativePath: string;
+    description?: string;
+    version?: string;
+    servers?: OpenAPIServer[];
+};
+export type McpDocsStaticDataPropsConfig = {
+    mcpDocsServerName: string;
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
+};
+export type McpDocsStaticData = PageStaticData & {
+    props: {
+        config: McpDocsStaticDataPropsConfig;
+    };
+};
 export type McpPath = {
     'x-mcp'?: XMcpConfig;
 } & OpenAPIPath;
@@ -32,7 +56,7 @@ export type McpPluginConfig = {
     };
 };
 export type DocsServerDependencies = {
-    definitions: OpenAPIDefinition[];
+    apiDescriptionsMap: Record<string, ApiDescriptionInfo>;
     readonly name: string;
 };
 export type McpUserInfo = {

package/dist/server/plugins/mcp/utils.d.ts

@@ -1,6 +1,7 @@
 import type { ApiFunctionsUser, RbacConfig, RedirectConfig } from '@redocly/config';
 import type { ProcessContentActions } from '../../types';
-export type Definitions = Awaited<ReturnType<ProcessContentActions['loadOpenApiDefinitions']>>;
+import type { ApiDescriptionInfo } from './types.js';
+export type ApiDescriptions = Awaited<ReturnType<ProcessContentActions['loadOpenApiDefinitions']>>;
 /**
  * Filters out localizations and definitions with no public paths.
  *
@@ -8,7 +9,7 @@ export type Definitions = Awaited<ReturnType<ProcessContentActions['loadOpenApiD
  * and definitions that don't have any public API paths. It also cleans up the remaining
  * definitions by removing internal parsing artifacts.
  *
- * @param definitions - Array of OpenAPI definitions to filter.
+ * @param apiDescriptions - Array of OpenAPI definitions to filter.
  * @returns Filtered array of definitions with only those containing public paths.
  *
  * @example
@@ -17,7 +18,7 @@ export type Definitions = Awaited<ReturnType<ProcessContentActions['loadOpenApiD
  *   { relativePath: 'api.yaml', definition: { paths: { '/users': {} } } }
  * ]); // Returns only the api.yaml definition
  */
-export declare function getCleanedUpDefinitions(definitions: Definitions): Definitions;
+export declare function getCleanedUpApiDescriptions(apiDescriptions: ApiDescriptions): ApiDescriptions;
 /**
  * Filters OpenAPI definitions based on user RBAC permissions.
  *
@@ -25,7 +26,7 @@ export declare function getCleanedUpDefinitions(definitions: Definitions): Defin
  * permissions and filters out definitions the user doesn't have access to. It also
  * applies deep filtering to the definition content based on the user's permissions.
  *
- * @param definitions - Array of OpenAPI definitions to filter.
+ * @param apiDescriptions - Array of OpenAPI definitions to filter.
  * @param user - The user object containing role and permission information.
  * @param rbac - RBAC configuration defining access rules.
  * @param requiresLogin - Whether login is required for access.
@@ -35,7 +36,7 @@ export declare function getCleanedUpDefinitions(definitions: Definitions): Defin
  * filterDefinitionsByRbac(definitions, user, rbac, true);
  * // Returns only definitions the user can access with filtered content
  */
-export declare function filterDefinitionsByRbac(definitions: Definitions, user: ApiFunctionsUser, rbac: RbacConfig, requiresLogin: boolean): Definitions;
+export declare function filterApiDescriptionsByRbac(apiDescriptions: Record<string, ApiDescriptionInfo>, user: ApiFunctionsUser, rbac: RbacConfig, requiresLogin: boolean): Record<string, ApiDescriptionInfo>;
 /**
  * Filters out definitions that match ignored paths from redocly.yaml config.
  *
@@ -43,15 +44,15 @@ export declare function filterDefinitionsByRbac(definitions: Definitions, user:
  * any of the ignored path patterns specified in the redocly configuration.
  * Definitions matching these patterns will be excluded from the result.
  *
- * @param definitions - Array of OpenAPI definitions to filter.
+ * @param apiDescriptions - Array of OpenAPI definitions to filter.
  * @param ignoredPaths - Array of glob patterns for paths to ignore.
  * @returns Array of definitions that don't match any ignored path patterns.
  *
  * @example
- * filterIgnoredDefinitions(definitions, ['path/to/ignore']);
+ * filterIgnoredApiDescriptions(apiDescriptions, ['path/to/ignore']);
  * // Returns definitions not matching test or internal path patterns
  */
-export declare function filterIgnoredDefinitions(definitions: Definitions, ignoredPaths: string[]): Definitions;
+export declare function filterIgnoredApiDescriptions(apiDescriptions: ApiDescriptions, ignoredPaths: string[]): ApiDescriptions;
 /**
  * Checks if the MCP route (/mcp) appears in redirect configuration.
  *

package/dist/server/plugins/mcp/utils.js

@@ -1 +1 @@
-import{join as c}from"node:path";import u from"picomatch";import{PUBLIC_API_DEFINITIONS_FOLDER as p,L10N_DIR_NAME as h,I18N_DIR_NAME as l}from"../../constants/common.js";import{RESERVED_ROUTES as f}from"../../plugins/get-reserved-routes.js";import{canDownloadApiDefinition as m,filterDataByAccessDeep as D}from"../../utils/rbac.js";function s(i){if(typeof i!="object"||i===null)return i;if(Array.isArray(i))return i.map(s);const n={};for(const t in i)if(Object.hasOwn(i,t)){if(t.toString().startsWith("x-parsed-"))continue;n[t]=s(i[t])}return n}function O(i){return i.reduce((n,t)=>(t.relativePath.startsWith(h)||t.relativePath.startsWith(l)||t.definition?.paths&&Object.keys(t.definition.paths).length>0&&n.push({...t,definition:s(t.definition)}),n),[])}function R(i,n,t,r){return i.reduce((e,o)=>{if(!m(c(p,o.relativePath),t,r,n))return e;const a=D(o.definition,n,t,r);return e.push({...o,definition:a}),e},[])}function _(i,n){return i.filter(({relativePath:t})=>!u(n||[])(t))}function g(i={}){for(const[n,t]of Object.entries(i))if(n===f.mcp||(typeof t=="string"?t:t.to)===f.mcp)return!0;return!1}export{R as filterDefinitionsByRbac,_ as filterIgnoredDefinitions,O as getCleanedUpDefinitions,g as isMcpInRedirects};
+import{join as f}from"node:path";import a from"picomatch";import{PUBLIC_API_DEFINITIONS_FOLDER as u,L10N_DIR_NAME as h,I18N_DIR_NAME as l}from"../../constants/common.js";import{RESERVED_ROUTES as p}from"../../plugins/get-reserved-routes.js";import{canDownloadApiDefinition as m}from"../../utils/rbac.js";function n(i){if(typeof i!="object"||i===null)return i;if(Array.isArray(i))return i.map(n);const r={};for(const t in i)if(Object.hasOwn(i,t)){if(t.toString().startsWith("x-parsed-"))continue;r[t]=n(i[t])}return r}function d(i){return i.reduce((r,t)=>(t.relativePath.startsWith(h)||t.relativePath.startsWith(l)||t.definition?.paths&&Object.keys(t.definition.paths).length>0&&r.push({...t,definition:n(t.definition)}),r),[])}function y(i,r,t,e){const o={};for(const[c,s]of Object.entries(i))m(f(u,s.relativePath),t,e,r)&&(o[c]=s);return o}function E(i,r){return i.filter(({relativePath:t})=>!a(r||[])(t))}function R(i={}){for(const[r,t]of Object.entries(i))if(r===p.mcp||(typeof t=="string"?t:t.to)===p.mcp)return!0;return!1}export{y as filterApiDescriptionsByRbac,E as filterIgnoredApiDescriptions,d as getCleanedUpApiDescriptions,R as isMcpInRedirects};

package/dist/server/plugins/mcp/workers/run-api-routes-worker.js

@@ -1 +1 @@
-import*as p from"workerpool";import{withPathPrefix as l}from"@redocly/theme/core/utils";import{TimeoutExceededError as f}from"../../../api-routes/errors/timeout-exceeded.js";import{logger as m}from"../../../tools/notifiers/logger.js";import{serializeRequest as S}from"../../../api-routes/helpers/serialize-request.js";import{API_ROUTES_WORKER_KEY as g}from"../../../workers/api-routes-worker-pool.js";import{mcpWorkers as h}from"../../../workers/mcp-worker-pool.js";const w=15;async function D(o,a,e){const t=a.get("auth"),i=await e.resolveRouteStaticData(o)||{},s=l(o.slug);try{const{status:r,headers:n,body:c,loggerStickyState:u}=await h.exec(g,[{serverOutDir:e.serverOutDir,slug:s,requestHandlerId:o.requestHandlerId,maxResponseSizeMB:w,ctxData:{user:{teams:t.teams,email:t.claims.email,claims:t.claims,idpAccessToken:t.idpAccessToken,idpId:t.claims.idpId,isAuthenticated:t.isAuthenticated},config:e.config},staticData:{...i,props:{...i.props,routeSlug:s,outdir:e.outdir}},req:await S(a.req.raw),loggerStickyState:m.getStickyState()}]);m.setStickyState(u);const d=c.data?Buffer.from(c.data):null;return new Response(d,{status:r,headers:n})}catch(r){throw r instanceof p.Promise.TimeoutError?new f("Timeout exceeded"):r}}export{D as runMcpWorker};
+import*as u from"workerpool";import{withPathPrefix as d}from"@redocly/theme/core/utils";import{TimeoutExceededError as p}from"../../../api-routes/errors/timeout-exceeded.js";import{serializeRequest as l}from"../../../api-routes/helpers/serialize-request.js";import{API_ROUTES_WORKER_KEY as f}from"../../../workers/api-routes-worker-pool.js";import{mcpWorkers as h}from"../../../workers/mcp-worker-pool.js";const w=15;async function A(o,a,t){const e=a.get("auth"),i=await t.resolveRouteStaticData(o)||{},s=d(o.slug);try{const{status:r,headers:m,body:c}=await h.exec(f,[{serverOutDir:t.serverOutDir,slug:s,requestHandlerId:o.requestHandlerId,maxResponseSizeMB:w,ctxData:{user:{teams:e.teams,email:e.claims.email,claims:e.claims,idpAccessToken:e.idpAccessToken,idpId:e.claims.idpId,isAuthenticated:e.isAuthenticated},config:t.config},staticData:{...i,props:{...i.props,routeSlug:s,outdir:t.outdir}},req:await l(a.req.raw)}]),n=c.data?Buffer.from(c.data):null;return new Response(n,{status:r,headers:m})}catch(r){throw r instanceof u.Promise.TimeoutError?new p("Timeout exceeded"):r}}export{A as runMcpWorker};