@redocly/revel-reef 0.126.0-next.2 → 0.126.0-next.20

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

@@ -0,0 +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};

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-security-schemes.js","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/get-security-schemes.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,MAAM,SAAS,GAAG,sBAAsB,CAAC;AAGzC,MAAM,gBAAgB,GAA6B;IACjD,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0BAA0B;YACvC,SAAS,EAAE,CAAC;SACb;KACF;CACF,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAC7C,MAAiB,EACjB,WAAgC;IAEhC,MAAM,CAAC,IAAI,CACT,SAAS,EACT,6CAA6C,EAC7C,gBAAgB,EAChB,KAAK,EAAE,EAAE,IAAI,EAAoB,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAEpD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC;YAC5F,CAAC;YAED,SAAS,CAAC,wBAAwB,CAAC;gBACjC,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK;4BACrB,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO;4BAC1B,eAAe,EAAE,GAAG,CAAC,UAAU,EAAE,eAAe,IAAI,EAAE;4BACtD,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;yBAC7B,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,mBAAmB,CAAC;gBAC5B,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,EAAE;gBAC7B,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;aAC1B,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAUrF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,OAAO,GACR,EAAE;IACD,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACzD,GAAG,IAAI,CAQP"}

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

@@ -0,0 +1 @@
+import{registerListApisTools as p}from"./list-apis.js";import{registerGetEndpointsTools as l}from"./get-endpoints.js";import{registerGetEndpointTools as e}from"./get-endpoint-info.js";import{registerGetSecuritySchemesTools as g}from"./get-security-schemes.js";import{registerGetFullDefinitionTools as s}from"./get-full-definition.js";import{registerSearchTool as T}from"./search.js";import{registerWhoAmITool as c}from"./whoami.js";function E({server:o,definitions:t,baseUrl:m,outdir:i,headers:r}){c(o,r),p(o,t),l(o,t),e(o,t),g(o,t),s(o,t),T(o,m,i,r)}export{E as registerDocsTools};

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,WAAW,EACX,OAAO,EACP,MAAM,EACN,OAAO,GAOR;IACC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,yBAAyB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/C,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,+BAA+B,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrD,8BAA8B,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpD,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,4 @@
+import { 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;
+//# sourceMappingURL=list-apis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-apis.d.ts","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/list-apis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAqB3E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI,CA0D/F"}

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

@@ -0,0 +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};

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-apis.js","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/list-apis.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,MAAM,SAAS,GAAG,WAAW,CAAC;AAG9B,MAAM,gBAAgB,GAA6B;IACjD,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,EAAE;IACZ,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0BAA0B;YACvC,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,WAAgC;IACvF,MAAM,CAAC,IAAI,CACT,SAAS,EACT,qDAAqD,EACrD,gBAAgB,EAChB,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,IAAI,IAAI,GAAwB,WAAW,CAAC;YAE5C,wGAAwG;YACxG,gEAAgE;YAChE,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC5B,IAAI,GAAG,wBAAwB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACrD,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,2BAA2B,IAAI,GAAG,CAAC,CAAC,CAAC,mBAAmB;yBACtE;qBACF;iBACF,CAAC;YACJ,CAAC;YACD,SAAS,CAAC,wBAAwB,CAAC;gBACjC,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;oBACjC,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;wBAClC,WAAW,EAAE,UAAU,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE;wBAC/C,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE;wBACvC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM;wBACjD,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM;wBACjE,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,EAAE;qBAClC,EACD,IAAI,EACJ,CAAC,CACF;iBACF,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,mBAAmB,CAAC;gBAC5B,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,EAAE;gBAC7B,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;aAC1B,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
+export declare function registerSearchTool(server: McpServer, baseUrl: string, outdir: string, headers?: Record<string, string | string[] | undefined>): void;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AA0B3E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACtD,IAAI,CAsDN"}

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

@@ -0,0 +1 @@
+import{withPathPrefix as u}from"@redocly/theme/core/utils";import{ServerRoutes as m}from"../../../../../constants/common.js";import{telemetry as s}from"../../../../telemetry/index.js";import{processDocuments as y}from"./utils.js";const o="search",f={type:"object",required:["query"],additionalProperties:!1,properties:{query:{type:"string",description:"Search query. Should be a single word or that phrase that is presented in a documentation.",minLength:1}}};function k(n,a,c,i){n.tool(o,"Search across the documentation to fetch relevant content for a given query",f,async({query:p})=>{try{const e=JSON.stringify({query:p}),h=`${a}${u(m.SEARCH)}`.replace("http","https"),d=`authorization=${String(i?.authorization).replace(/^Bearer /,"")}`,t=await fetch(h,{method:"POST",credentials:"include",headers:{"Content-Type":"application/json",Cookie:d},body:e});if(!t.ok)throw new Error(`Search request failed with status ${t.status}`);const l=await t.json(),r=y(l.documents||{},c);return s.sendMcpToolCalledMessage({server_type:"docs",tool:o}),{content:[{type:"text",text:r.trim().length?r:"No results found."}]}}catch(e){throw s.sendMcpErrorMessage({server_type:"docs",tool:o,message:e?.message||"",stack:e?.stack||""}),e}})}export{k as registerSearchTool};

package/dist/server/plugins/mcp/docs-mcp/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/search.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,SAAS,GAAG,QAAQ,CAAC;AAG3B,MAAM,gBAAgB,GAA6B;IACjD,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,4FAA4F;YAC9F,SAAS,EAAE,CAAC;SACb;KACF;CACF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,OAAe,EACf,MAAc,EACd,OAAuD;IAEvD,MAAM,CAAC,IAAI,CACT,SAAS,EACT,6EAA6E,EAC7E,gBAAgB,EAChB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACvC,+BAA+B;YAC/B,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxF,MAAM,MAAM,GAAG,iBAAiB,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC;YAEzF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,SAAS;gBACtB,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,MAAM,EAAE,MAAM;iBACf;gBACD,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1E,CAAC;YAED,MAAM,cAAc,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;YAEjE,MAAM,eAAe,GAAG,gBAAgB,CAAC,cAAc,CAAC,SAAS,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YAEjF,SAAS,CAAC,wBAAwB,CAAC;gBACjC,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB;qBAC5E;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,mBAAmB,CAAC;gBAC5B,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,EAAE;gBAC7B,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;aAC1B,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+import { SearchItemData } from '@redocly/theme';
+import { OpenAPIDefinition, OpenAPIOperation } from '@redocly/openapi-docs';
+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 {};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAO5E,KAAK,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC,GAAG;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAuB5E;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAC3C,MAAM,EAAE,MAAM,GACb,MAAM,CAkER"}

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

@@ -0,0 +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})
+
+`;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+=`
+
+**Categories:**
+`,Object.entries(t.facets).forEach(([e,o])=>{r+=`- ${e}: ${o}
+`})),r});return`## ${l}
+
+${f}`}).join(`
+
+`).trim()}export{E as getEndpointsFromPaths,k as processDocuments};

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAOhE,MAAM,UAAU,qBAAqB,CAAC,GAAsB;IAC1D,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC;IAC3B,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAwB,EAAE,CAAC;QAC3E,MAAM,YAAY,GAAG,CAAC,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAElE,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1D,IAAI,YAAY,IAAI,CAAC,0BAA0B,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;gBACnE,SAAS;YACX,CAAC;YAED,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI;gBACJ,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;gBAC5B,OAAO,EAAE,SAAS,CAAC,OAAO;gBAC1B,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,QAAQ,EAAE,SAAS,CAAC,QAAQ;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,SAA2C,EAC3C,MAAc;IAEd,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE;QAC7B,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAAG,SAAS;aAC3B,KAAK,CAAC,CAAC,EAAE,0BAA0B,CAAC;aACpC,GAAG,CAAC,CAAC,GAAmB,EAAE,EAAE;YAC3B,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;YAEpC,MAAM,YAAY,GAChB,SAAS,EAAE,KAAK;gBAChB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEvE,IAAI,QAAQ,GAAG,aAAa,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC7C,QAAQ,IAAI,QAAQ,YAAY,KAAK,QAAQ,CAAC,GAAG,OAAO,CAAC;YAEzD,IAAI,WAA+B,CAAC;YAEpC,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAClF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACvC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;wBACrB,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;oBAC5C,CAAC;oBACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAClC,IAAI,GAAG,EAAE,CAAC;wBACR,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC1C,CAAC;oBACD,IAAI,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;oBAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAE7C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC5B,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,6CAA6C;gBAC/C,CAAC;YACH,CAAC;YAED,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW;oBACT,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACzF,CAAC;YAED,QAAQ,IAAI,WAAW,CAAC;YAExB,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpB,QAAQ,IAAI,uBAAuB,CAAC;gBACpC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;oBACvD,QAAQ,IAAI,KAAK,GAAG,KAAK,KAAK,IAAI,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;QAEL,OAAO,MAAM,QAAQ,OAAO,YAAY,EAAE,CAAC;IAC7C,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC;SACZ,IAAI,EAAE,CAAC;IAEV,OAAO,eAAe,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,3 @@
+import { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
+export declare function registerWhoAmITool(server: McpServer, headers?: Record<string, string | string[] | undefined>): void;
+//# sourceMappingURL=whoami.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAQtE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACtD,IAAI,CA+DN"}

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

@@ -0,0 +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};

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

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../../../../../../../src/server/plugins/mcp/docs-mcp/tools/whoami.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,SAAS,GAAG,QAAQ,CAAC;AAE3B,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,OAAuD;IAEvD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,wDAAwD,EAAE,GAAG,EAAE;QACpF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAEvD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,mBAAmB;gCAC1B,OAAO,EAAE,iEAAiE;6BAC3E,CAAC;yBACH;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,SAAS,CAAC,wBAAwB,CAAC;gBACjC,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;4BACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;4BACnB,OAAO,EAAE,QAAQ,CAAC,GAAG;4BACrB,QAAQ,EAAE,QAAQ,CAAC,SAAS;4BAC5B,KAAK,EAAE,QAAQ,CAAC,KAAK;4BACrB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;4BAChF,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;yBAClF,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,mBAAmB,CAAC;gBAC5B,WAAW,EAAE,MAAM;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,yBAAyB;gBACpD,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;aAC1B,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,yBAAyB;4BAChC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAChE,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { OpenAPISchema, OpenAPIParameter, OpenAPIResponse, OpenAPIRequestBody, Referenced, OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
+import { 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[];
+export declare function resolveRef<T>(ref: string, def?: OpenAPIDefinition): T | undefined;
+type ResolveSchemaRefsParams = {
+    schema: Referenced<OpenAPISchema> | undefined;
+    definition: OpenAPIDefinition;
+    visitedRefs?: Set<string>;
+    maxDepth?: number;
+    currentDepth?: number;
+};
+export declare function resolveSchemaRefs({ schema, definition, visitedRefs, maxDepth, currentDepth, }: ResolveSchemaRefsParams): OpenAPISchema | undefined;
+type ResolveParametersParams = {
+    pathParams: Referenced<OpenAPIParameter>[];
+    opParams: Referenced<OpenAPIParameter>[];
+    definition: OpenAPIDefinition;
+};
+export declare function resolveParameters({ pathParams, opParams, definition, }: ResolveParametersParams): OpenAPIParameter[];
+export declare function resolveRequestBody(requestBody: Referenced<OpenAPIRequestBody> | undefined, definition: OpenAPIDefinition): OpenAPIRequestBody | undefined;
+export declare function resolveResponses(responses: Record<string, Referenced<OpenAPIResponse>>, definition: OpenAPIDefinition): Record<string, OpenAPIResponse>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/docs-mcp/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,UAAU,EAGV,iBAAiB,EAClB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,wBAAgB,oBAAoB,CAClC,kBAAkB,EAAE,iBAAiB,EAAE,EACvC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,aAAsB,GACjC,iBAAiB,GAAG,SAAS,CAM/B;AAED,wBAAgB,wBAAwB,CACtC,kBAAkB,EAAE,iBAAiB,EAAE,EACvC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,aAAsB,GACjC,iBAAiB,EAAE,CAMrB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,SAAS,CAcjF;AAED,KAAK,uBAAuB,GAAG;IAC7B,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IAC9C,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,UAAU,EACV,WAAuB,EACvB,QAAa,EACb,YAAgB,GACjB,EAAE,uBAAuB,GAAG,aAAa,GAAG,SAAS,CAyGrD;AAED,KAAK,uBAAuB,GAAG;IAC7B,UAAU,EAAE,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAC3C,QAAQ,EAAE,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;IACzC,UAAU,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,QAAQ,EACR,UAAU,GACX,EAAE,uBAAuB,GAAG,gBAAgB,EAAE,CA0B9C;AAgCD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,UAAU,CAAC,kBAAkB,CAAC,GAAG,SAAS,EACvD,UAAU,EAAE,iBAAiB,GAC5B,kBAAkB,GAAG,SAAS,CA0BhC;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,EACtD,UAAU,EAAE,iBAAiB,GAC5B,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CA8BjC"}

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

@@ -0,0 +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};

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

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

package/dist/server/plugins/mcp/handlers/docs-mcp-handler.d.ts

@@ -0,0 +1,4 @@
+import type { ApiRoutesHandler } from '@redocly/config';
+declare const docsMcpHandler: ApiRoutesHandler;
+export default docsMcpHandler;
+//# sourceMappingURL=docs-mcp-handler.d.ts.map

package/dist/server/plugins/mcp/handlers/docs-mcp-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-mcp-handler.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/handlers/docs-mcp-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAuB,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AAwF7F,QAAA,MAAM,cAAc,EAAE,gBAoBrB,CAAC;AAEF,eAAe,cAAc,CAAC"}

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

@@ -0,0 +1 @@
+import{createMcpRequestHandler as M}from"./mcp-request-handler.js";import{createDocsMcpServer as g}from"../servers/docs-server.js";import{filterDefinitionsByRbac as D}from"../utils.js";import{createInternalServerError as E}from"./errors.js";import{McpServerType as y}from"../constants.js";import{telemetry as i}from"../../../telemetry/index.js";import{constructInvalidTokenResponse as h,constructUnauthorizedResponse as R,handleMcpAuth as A,shouldHandleMcpAuth as N}from"../auth/auth-handlers.js";import{TELEMETRY_ENABLED as T}from"../../../constants/common.js";import{PACKAGE_NAME as S}from"../../../../config/product-gates.js";i.init({otel:{serviceName:"realm-server",serviceVersion:`${S}@${process.env.REDOCLY_PORTAL_VERSION}`,collectorTraceUrl:"https://otel.cloud.redocly.com/v1/traces",isProd:process.env.NODE_ENV==="production",version:"1.0",tracerName:"server-telemetry",delayMillis:100},disabled:!T});async function I(o,r,s,n){try{const e=r,t=e?.props?.config?.openapiDefinitions||[],a=e?.props?.config?.outdir||"",p=e?.props?.config?.catalogName||"Docs MCP server",l=new URL(n.url).origin,{user:c,config:{rbac:m={},mcp:d={}}}=o,f=D(t,c,m,!!c?.isAuthenticated).map(({definition:v})=>v),u=d.docs?.name||p;return await g(f,u,l,s,a)}catch(e){throw i.sendMcpErrorMessage({server_type:"docs",message:e?.message||"",stack:e?.stack||""}),E(e?.message||"Internal server error mcp docs")}}const L=M({createServerInstance:I,serverType:y.Docs}),U=async(o,r,s)=>{if(N(r)){const{isAuthenticated:n,isTokenValid:e,currentUser:t}=await A(o,r);if(!n)return R(new URL(o.url).origin);if(!e)return h();t&&(r.user=t)}return L(o,r,s)};var Y=U;export{Y as default};

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

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

package/dist/server/plugins/mcp/handlers/errors.d.ts

@@ -0,0 +1,38 @@
+import type { McpErrorCodeTypes, McpServerType } from '../types.js';
+export type McpErrorData = {
+    readonly code: McpErrorCodeTypes;
+    readonly message: string;
+    readonly data?: unknown;
+    readonly requestId?: string | number | null;
+};
+export declare class McpError extends Error {
+    readonly code: McpErrorCodeTypes;
+    readonly data?: unknown;
+    readonly requestId?: string | number | null;
+    constructor(code: McpErrorCodeTypes, message: string, data?: unknown, requestId?: string | number | null);
+    /**
+     * Creates a JSON-RPC 2.0 compliant error response
+     */
+    createErrorResponse(): Response;
+}
+/**
+ * Creates a method not allowed error response
+ */
+export declare function createMethodNotAllowedError(requestId?: string | number | null): Response;
+/**
+ * Creates an internal server error response with telemetry
+ */
+export declare function createInternalServerError(error: Error | string, serverType?: McpServerType, requestId?: string | number | null): Response;
+/**
+ * Creates an invalid request error response
+ */
+export declare function createInvalidRequestError(message?: string, requestId?: string | number | null): Response;
+/**
+ * Creates an invalid parameters error response
+ */
+export declare function createInvalidParamsError(message?: string, requestId?: string | number | null): Response;
+/**
+ * Safely handles errors in async functions with proper cleanup
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<T>, serverType: McpServerType, cleanup?: () => Promise<void>): Promise<T | Response>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/server/plugins/mcp/handlers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/handlers/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKpE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,iBAAiB,CAAC;IACxC,SAAgB,IAAI,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAgB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;gBAGjD,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASpC;;OAEG;IACH,mBAAmB,IAAI,QAAQ;CAkBhC;AAqBD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAIxF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,UAAU,GAAE,aAA2C,EACvD,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GACjC,QAAQ,CAkBV;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,MAA0B,EACnC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GACjC,QAAQ,CAIV;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,MAA6B,EACtC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GACjC,QAAQ,CAIV;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,EAAE,aAAa,EACzB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,CAevB"}

package/dist/server/plugins/mcp/handlers/errors.js

@@ -0,0 +1 @@
+import{telemetry as c}from"../../../telemetry/index.js";import{McpErrorCodes as s,McpServerType as d}from"../constants.js";class n extends Error{code;data;requestId;constructor(e,t,o,a){super(t),this.name="McpError",this.code=e,this.data=o,this.requestId=a}createErrorResponse(){const e={jsonrpc:"2.0",error:{code:this.code,message:this.message,...this.data?{data:this.data}:{}},id:this.requestId??null},t=i(this.code);return new Response(JSON.stringify(e),{status:t,headers:{"Content-Type":"application/json"}})}}function i(r){switch(r){case s.InvalidRequest:case s.InvalidParams:return 400;case s.MethodNotFound:return 404;case s.ServerError:return 405;case s.InternalError:default:return 500}}function m(r){return new n(s.ServerError,"Method not allowed",void 0,r).createErrorResponse()}function u(r,e=d.Docs,t){const o=r instanceof Error?r.message:String(r),a=r instanceof Error?r.stack:void 0;return c.sendMcpErrorMessage({server_type:e,message:o,stack:a||""}),new n(s.InternalError,"Internal server error mcp",o,t).createErrorResponse()}function f(r="Invalid request",e){return new n(s.InvalidRequest,r,void 0,e).createErrorResponse()}function h(r="Invalid parameters",e){return new n(s.InvalidParams,r,void 0,e).createErrorResponse()}async function v(r,e,t){try{return await r()}catch(o){return c.sendMcpErrorMessage({server_type:e,message:o?.message||"",stack:o?.stack||""}),t&&t(),u(o,e)}}export{n as McpError,u as createInternalServerError,h as createInvalidParamsError,f as createInvalidRequestError,m as createMethodNotAllowedError,v as withErrorHandling};

package/dist/server/plugins/mcp/handlers/errors.js.map

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

package/dist/server/plugins/mcp/handlers/mcp-request-handler.d.ts

@@ -0,0 +1,12 @@
+import type { ApiFunctionsContext, ApiRoutesHandler, PageStaticData } from '@redocly/config';
+import type { McpServerInstance, McpServerType } from '../types.js';
+export type McpRequestHandlerDependencies = {
+    createServerInstance: (context: ApiFunctionsContext, staticData: PageStaticData, headers: Record<string, string | string[] | undefined>, request: Request) => Promise<McpServerInstance>;
+    serverType: McpServerType;
+    connectionTimeoutMs?: number;
+};
+/**
+ * Creates a standardized MCP request handler
+ */
+export declare function createMcpRequestHandler(dependencies: McpRequestHandlerDependencies): ApiRoutesHandler;
+//# sourceMappingURL=mcp-request-handler.d.ts.map

package/dist/server/plugins/mcp/handlers/mcp-request-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-request-handler.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/handlers/mcp-request-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMpE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,oBAAoB,EAAE,CACpB,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChC,UAAU,EAAE,aAAa,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,6BAA6B,GAC1C,gBAAgB,CAiElB"}

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

@@ -0,0 +1 @@
+import{toFetchResponse as i,toReqRes as E}from"fetch-to-node";import{DEFAULT_CONNECTION_TIMEOUT_MS as w}from"../constants.js";import{createMethodNotAllowedError as R,withErrorHandling as y}from"./errors.js";import{logger as d}from"../../../utils/index.js";function N(u){const{createServerInstance:l,serverType:p,connectionTimeoutMs:m=w}=u;return async(r,h,f)=>{let e,n;const c=async()=>{try{n&&(clearTimeout(n),n=void 0),e&&(await e.cleanup(),e=void 0)}catch(a){d.error("Error during mcp server cleanup:",a)}};return y(async()=>{const a={};r.headers.forEach((o,T)=>{a[T]=o}),e=await l(h,f,a,r);const{req:s,res:t}=E(r);switch(n=setTimeout(()=>{c()},m),t.on("close",()=>{c().catch(o=>{d.error("Error during response close cleanup:",o)})}),r.method){case"GET":return await e.transport.handleRequest(s,t),i(t);case"POST":const o=await r.json();return await e.transport.handleRequest(s,t,o),i(t);default:return R()}},p,c)}}export{N as createMcpRequestHandler};

package/dist/server/plugins/mcp/handlers/mcp-request-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-request-handler.js","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/handlers/mcp-request-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAajD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAA2C;IAE3C,MAAM,EACJ,oBAAoB,EACpB,UAAU,EACV,mBAAmB,GAAG,6BAA6B,GACpD,GAAG,YAAY,CAAC;IAEjB,OAAO,KAAK,EAAE,OAAgB,EAAE,OAA4B,EAAE,UAA0B,EAAE,EAAE;QAC1F,IAAI,cAA6C,CAAC;QAClD,IAAI,SAAqC,CAAC;QAE1C,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;YACxC,IAAI,CAAC;gBACH,IAAI,SAAS,EAAE,CAAC;oBACd,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,SAAS,GAAG,SAAS,CAAC;gBACxB,CAAC;gBACD,IAAI,cAAc,EAAE,CAAC;oBACnB,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC;oBAC/B,cAAc,GAAG,SAAS,CAAC;gBAC7B,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,iBAAiB,CACtB,KAAK,IAAI,EAAE;YACT,MAAM,OAAO,GAAkD,EAAE,CAAC;YAClE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACrC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,cAAc,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAEnF,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YAEzD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,OAAO,EAAE,CAAC;YACZ,CAAC,EAAE,mBAAmB,CAAC,CAAC;YAExB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACxB,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;gBAC9D,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvB,KAAK,KAAK;oBACR,MAAM,cAAc,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC/D,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;gBAElC,KAAK,MAAM;oBACT,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;oBACzC,MAAM,cAAc,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;oBAC5E,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;gBAElC;oBACE,OAAO,2BAA2B,EAAE,CAAC;YACzC,CAAC;QACH,CAAC,EACD,UAAU,EACV,OAAO,CACR,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { LifecyclePluginInstance } from '../../types';
+export declare const MCP_DOCS_SERVER_HANDLER_ID = "mcp-docs-server-handler";
+export declare function mcpServerPlugin(): Promise<LifecyclePluginInstance>;
+export default mcpServerPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/server/plugins/mcp/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,gBAAgB,CAAC;AAOxB,eAAO,MAAM,0BAA0B,4BAA4B,CAAC;AAGpE,wBAAsB,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAgCxE;AAED,eAAe,eAAe,CAAC"}

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

@@ -0,0 +1 @@
+import{fileURLToPath as d}from"node:url";import{dirname as p,join as f}from"node:path";import{logger as a}from"../../utils/index.js";import{filterIgnoredDefinitions as m,getCleanedUpDefinitions as l}from"./utils.js";const s="mcp-docs-server-handler",g=p(d(import.meta.url));async function u(){return{id:"mcp",async processContent(e,n){const t=await e.loadOpenApiDefinitions(n),r=await n.getConfig(),{mcp:i}=r;if(i?.hide)return;a.info("Configuring MCP servers...");const o=f(g,"./handlers/docs-mcp-handler.js");if(!i?.docs?.hide){const c=l(m(t,i?.docs?.ignore||[]));await D(e,o,c,i,e.outdir)}}}}var M=u;async function D(e,n,t,r,i){e.createRequestHandler(s,n),e.addApiRoute({slug:"/mcp",requestHandlerId:s,httpMethod:"all",getStaticData:async()=>({props:{config:{openapiDefinitions:t.map(o=>({definition:o.definition,relativePath:o.relativePath})),outdir:i,catalogName:r?.docs?.name||"Docs MCP Server"}}})}),a.info("Registered Docs MCP Server endpoint at /mcp")}export{s as MCP_DOCS_SERVER_HANDLER_ID,M as default,u as mcpServerPlugin};

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/server/plugins/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAU1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,yBAAyB,CAAC;AACpE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO;QACL,EAAE,EAAE,KAAK;QAET,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,OAAyB;YACrD,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;YAEvB,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAE1C,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;YAE7E,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBACrB,MAAM,WAAW,GAAG,uBAAuB,CACzC,wBAAwB,CAAC,iBAAiB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE,CAAa,CAAC,CACnF,CAAC;gBAEF,MAAM,qBAAqB,CACzB,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,GAAsB,EACtB,OAAO,CAAC,MAAM,CACf,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,eAAe,eAAe,CAAC;AAE/B,KAAK,UAAU,qBAAqB,CAClC,OAA8B,EAC9B,WAAmB,EACnB,WAAgC,EAChC,MAAuB,EACvB,MAAc;IAEd,OAAO,CAAC,oBAAoB,CAAC,0BAA0B,EAAE,WAAW,CAAC,CAAC;IAEtE,OAAO,CAAC,WAAW,CAAC;QAClB,IAAI,EAAE,MAAM;QACZ,gBAAgB,EAAE,0BAA0B;QAC5C,UAAU,EAAE,KAAK;QACjB,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC1B,KAAK,EAAE;gBACL,MAAM,EAAE;oBACN,kBAAkB,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBAC5C,UAAU,EAAE,GAAG,CAAC,UAAU;wBAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;qBAC/B,CAAC,CAAC;oBACH,MAAM;oBACN,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,iBAAiB;iBACrD;aACF;SACF,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,19 @@
+import { McpServer } from '@redocly/mcp-typescript-sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@redocly/mcp-typescript-sdk/server/streamableHttp.js';
+import type { Implementation } from '@redocly/mcp-typescript-sdk/types.js';
+import type { McpServerInstance, McpServerType } from '../types.js';
+export declare abstract class BaseMcpServer {
+    #private;
+    protected server: McpServer;
+    protected transport: StreamableHTTPServerTransport;
+    constructor(config: Implementation);
+    protected abstract registerTools(): void;
+    initialize(): Promise<McpServerInstance>;
+    clearCleanupTimeout(): void;
+    private cleanupPromise?;
+    cleanup(): Promise<void>;
+    private performCleanup;
+    protected abstract getServerType(): McpServerType;
+}
+export declare function createMcpServerInstance<T extends BaseMcpServer>(serverClass: new (...args: any[]) => T, ...args: any[]): Promise<McpServerInstance>;
+//# sourceMappingURL=base-server.d.ts.map

package/dist/server/plugins/mcp/servers/base-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-server.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/servers/base-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAErG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIpE,8BAAsB,aAAa;;IACjC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC;IAC5B,SAAS,CAAC,SAAS,EAAE,6BAA6B,CAAC;gBAIvC,MAAM,EAAE,cAAc;IAOlC,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI;IAElC,UAAU,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAW9C,mBAAmB,IAAI,IAAI;IAO3B,OAAO,CAAC,cAAc,CAAC,CAAgB;IAEjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAShB,cAAc;IAkB5B,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,aAAa;CAClD;AAED,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,aAAa,EACnE,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACtC,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}

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

@@ -0,0 +1 @@
+import{McpServer as t}from"@redocly/mcp-typescript-sdk/server/mcp.js";import{StreamableHTTPServerTransport as s}from"@redocly/mcp-typescript-sdk/server/streamableHttp.js";import{telemetry as i}from"../../../telemetry/index.js";class p{server;transport;#e;#r=!1;constructor(e){this.server=new t(e,{capabilities:{logging:{}}}),this.transport=new s({sessionIdGenerator:void 0})}async initialize(){return this.registerTools(),await this.server.connect(this.transport),{server:this.server,transport:this.transport,cleanup:this.cleanup.bind(this)}}clearCleanupTimeout(){this.#e&&(clearTimeout(this.#e),this.#e=void 0)}cleanupPromise;async cleanup(){return this.cleanupPromise?this.cleanupPromise:(this.cleanupPromise=this.performCleanup(),this.cleanupPromise)}async performCleanup(){if(!this.#r){this.#r=!0,this.clearCleanupTimeout();try{this.transport.close()}catch(e){throw i.sendMcpErrorMessage({server_type:this.getServerType(),message:e?.message||"Unknown cleanup error",stack:e?.stack||""}),e}}}}async function l(r,...e){return await new r(...e).initialize()}export{p as BaseMcpServer,l as createMcpServerInstance};

package/dist/server/plugins/mcp/servers/base-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-server.js","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/servers/base-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAKrG,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,MAAM,OAAgB,aAAa;IACvB,MAAM,CAAY;IAClB,SAAS,CAAgC;IACnD,eAAe,CAAkB;IACjC,YAAY,GAAG,KAAK,CAAC;IAErB,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,SAAS,GAAG,IAAI,6BAA6B,CAAC;YACjD,kBAAkB,EAAE,SAAS;SAC9B,CAAC,CAAC;IACL,CAAC;IAID,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE1C,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;SACjC,CAAC;IACJ,CAAC;IAED,mBAAmB;QACjB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACnC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,cAAc,CAAiB;IAEvC,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAE3B,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,mBAAmB,CAAC;gBAC5B,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE;gBACjC,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,uBAAuB;gBAClD,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;aAC1B,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CAGF;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,WAAsC,EACtC,GAAG,IAAW;IAEd,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;IACxC,OAAO,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { OpenAPIDefinition } from '@redocly/openapi-docs/lib/types/open-api.js';
+import type { DocsServerDependencies, McpServerType } from '../types.js';
+import { BaseMcpServer } from './base-server.js';
+export declare class DocsMcpServer extends BaseMcpServer {
+    private readonly dependencies;
+    constructor(dependencies: DocsServerDependencies & {
+        baseUrl: string;
+        headers: Record<string, string | string[] | undefined>;
+        outdir: string;
+    });
+    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>;
+//# sourceMappingURL=docs-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs-server.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/servers/docs-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,qBAAa,aAAc,SAAQ,aAAa;IAE5C,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,sBAAsB,GAAG;QACtD,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;QACvD,MAAM,EAAE,MAAM,CAAC;KAChB;IAQH,SAAS,CAAC,aAAa,IAAI,IAAI;IAU/B,SAAS,CAAC,aAAa,IAAI,aAAa;CAGzC;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,iBAAiB,EAAE,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,MAAM,EAAE,MAAM,oDAIf"}

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

@@ -0,0 +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};

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs-server.js","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/servers/docs-server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,aAAa,IAAI,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,OAAO,aAAc,SAAQ,aAAa;IAE3B;IADnB,YACmB,YAIhB;QAED,KAAK,CAAC;YACJ,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SAC/C,CAAC,CAAC;QATc,iBAAY,GAAZ,YAAY,CAI5B;IAMH,CAAC;IAES,aAAa;QACrB,iBAAiB,CAAC;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;YAC1C,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO;YAClC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM;YAChC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO;SACnC,CAAC,CAAC;IACL,CAAC;IAES,aAAa;QACrB,OAAO,sBAAsB,CAAC,IAAI,CAAC;IACrC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAgC,EAChC,IAAY,EACZ,OAAe,EACf,OAAsD,EACtD,MAAc;IAEd,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAClF,OAAO,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,50 @@
+import { 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 { McpErrorCodes, McpServerType } from './constants';
+type ObjectValues<T> = T[keyof T];
+export type McpServerType = ObjectValues<typeof McpServerType>;
+export type McpErrorCodeTypes = ObjectValues<typeof McpErrorCodes>;
+export interface McpPath extends OpenAPIPath {
+    'x-mcp'?: XMcpConfig;
+}
+export interface XMcpConfig {
+    docs?: {
+        hide?: boolean;
+    };
+}
+export type McpEndpoint = {
+    'x-mcp'?: XMcpConfig;
+    [key: string]: any;
+};
+export type McpServerInstance = {
+    readonly server: McpServer;
+    readonly transport: StreamableHTTPServerTransport;
+    cleanup(): Promise<void>;
+};
+export type McpPluginConfig = {
+    readonly hide: boolean;
+    readonly docs: {
+        readonly hide: boolean;
+        readonly name: string;
+        readonly ignore: readonly string[];
+    };
+};
+export type DocsServerDependencies = {
+    definitions: OpenAPIDefinition[];
+    readonly name: string;
+};
+export type McpUserInfo = {
+    email?: string;
+    name?: string;
+    sub?: string;
+    aud?: string | string[];
+    client_id?: string;
+    scope?: string;
+    iat?: number;
+    exp?: number;
+    [key: string]: any;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/server/plugins/mcp/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAC1G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3D,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAElC,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;AAEnE,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAC1C,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC"}

package/dist/server/plugins/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/server/plugins/mcp/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,14 @@
+import { McpUserInfo } from '../types';
+/**
+ * Extract JWT token from Authorization header
+ */
+export declare function extractTokenFromAuthHeader(authHeader?: string | string[]): string | null;
+/**
+ * Decode and validate JWT token to get user information
+ */
+export declare function getUserInfoFromToken(token: string): McpUserInfo | null;
+/**
+ * Get user info from MCP request headers
+ */
+export declare function getUserInfoFromHeaders(headers: Record<string, string | string[] | undefined>): McpUserInfo | null;
+//# sourceMappingURL=jwt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/utils/jwt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAOxF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAetE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,WAAW,GAAG,IAAI,CAOpB"}

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

@@ -0,0 +1 @@
+import*as n from"../../../web-server/jwt/jwt.js";function e(t){if(!t)return null;const r=Array.isArray(t)?t[0]:t;return!r||!r.startsWith("Bearer ")?null:r.substring(7)}function u(t){try{const{payload:r}=n.decode(t),o=Math.floor(Date.now()/1e3);return r.exp&&r.exp<o?null:r}catch(r){return console.error("Failed to decode JWT token:",r),null}}function i(t){const r=t.authorization||t.Authorization,o=e(r);return o?u(o):null}export{e as extractTokenFromAuthHeader,i as getUserInfoFromHeaders,u as getUserInfoFromToken};

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

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/utils/jwt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,gCAAgC,CAAC;AAItD;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAA8B;IACvE,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC3E,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpE,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEtC,gCAAgC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,CAAC,gBAAgB;QAC/B,CAAC;QAED,OAAO,OAAsB,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAsD;IAEtD,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,62 @@
+import { OpenAPIDefinition } from '@redocly/openapi-docs';
+import type { XMcpConfig, McpEndpoint, McpServerType } from '../types.js';
+/**
+ * Extracts the x-mcp configuration from an MCP endpoint.
+ *
+ * This function safely retrieves the x-mcp extension property from an endpoint object.
+ * The x-mcp property contains server-specific configuration for MCP (Model Context Protocol) endpoints.
+ *
+ * @param endpoint - The MCP endpoint object to extract configuration from.
+ * @returns The x-mcp configuration object or undefined if not present.
+ *
+ * @example
+ * getXMcpConfig({ 'x-mcp': { gateway: { hide: true } } }); // { gateway: { hide: true } }
+ * getXMcpConfig({}); // undefined
+ */
+export declare function getXMcpConfig(endpoint: McpEndpoint): XMcpConfig | undefined;
+/**
+ * Checks if an endpoint should be hidden for a specific server type.
+ *
+ * This function determines whether an MCP endpoint should be hidden based on the
+ * x-mcp configuration and the target server type (gateway or catalog).
+ *
+ * @param endpoint - The MCP endpoint to check.
+ * @param serverType - The server type to check visibility for ('gateway' or 'catalog').
+ * @returns `true` if the endpoint should be hidden, `false` otherwise.
+ *
+ * @example
+ * isEndpointHidden({ 'x-mcp': { docs: { hide: false } } }, 'docs'); // false
+ */
+export declare function isEndpointHidden(endpoint: McpEndpoint, serverType: McpServerType): boolean;
+/**
+ * Checks endpoint visibility and removes x-mcp configuration from output.
+ *
+ * This function first checks if an endpoint should be hidden for the given server type.
+ * If the endpoint is accessible, it removes the x-mcp configuration to clean up the output.
+ * This is typically used to prepare endpoints for public API documentation.
+ *
+ * @param endpoint - The MCP endpoint to process.
+ * @param serverType - The server type to check visibility for.
+ * @returns `true` if the endpoint is accessible and processed, `false` if hidden.
+ *
+ * @example
+ * checkEndpointAndDeleteXMcp(endpoint, 'docs');
+ * // Returns true and removes x-mcp from endpoint if accessible
+ */
+export declare function checkEndpointAndDeleteXMcp(endpoint: McpEndpoint, serverType: McpServerType): boolean;
+/**
+ * Checks if an OpenAPI definition should be hidden based on x-mcp configuration.
+ *
+ * This function examines the info section of an OpenAPI definition for x-mcp configuration
+ * and determines if the definition should be hidden for the specified server type.
+ * If no server type is provided, it checks if the definition is hidden for any server type.
+ *
+ * @param info - The OpenAPI info object to check.
+ * @param serverType - Optional server type to check ('docs' or 'gateway').
+ * @returns `true` if the definition should be hidden, `false` otherwise.
+ *
+ * @example
+ * isDefinitionHidden({ 'x-mcp': { docs: { hide: false } } }); // false
+ */
+export declare function isDefinitionHidden(info: OpenAPIDefinition['info'], serverType?: McpServerType): boolean;
+//# sourceMappingURL=xmcp-utils.d.ts.map

package/dist/server/plugins/mcp/utils/xmcp-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmcp-utils.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/plugins/mcp/utils/xmcp-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAE3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,GAAG,OAAO,CAE1F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,aAAa,GACxB,OAAO,CAST;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,UAAU,CAAC,EAAE,aAAa,GACzB,OAAO,CAWT"}

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

@@ -0,0 +1 @@
+function r(e){return e?.["x-mcp"]}function i(e,t){return!!r(e)?.[t]?.hide}function c(e,t){return i(e,t)?!1:(e&&delete e["x-mcp"],!0)}function o(e,t){if(!e)return!1;const n=e["x-mcp"];return!n||typeof n!="object"?!1:t?n[t]?.hide===!0:n.docs?.hide}export{c as checkEndpointAndDeleteXMcp,r as getXMcpConfig,o as isDefinitionHidden,i as isEndpointHidden};