mcp-expose 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +39 -0
- package/LICENSE +21 -0
- package/README.md +708 -0
- package/dist/adonisjs/index.cjs +708 -0
- package/dist/adonisjs/index.cjs.map +1 -0
- package/dist/adonisjs/index.d.cts +68 -0
- package/dist/adonisjs/index.d.ts +68 -0
- package/dist/adonisjs/index.js +684 -0
- package/dist/adonisjs/index.js.map +1 -0
- package/dist/express/index.cjs +789 -0
- package/dist/express/index.cjs.map +1 -0
- package/dist/express/index.d.cts +61 -0
- package/dist/express/index.d.ts +61 -0
- package/dist/express/index.js +763 -0
- package/dist/express/index.js.map +1 -0
- package/dist/fastify/index.cjs +660 -0
- package/dist/fastify/index.cjs.map +1 -0
- package/dist/fastify/index.d.cts +42 -0
- package/dist/fastify/index.d.ts +42 -0
- package/dist/fastify/index.js +635 -0
- package/dist/fastify/index.js.map +1 -0
- package/dist/hono/index.cjs +656 -0
- package/dist/hono/index.cjs.map +1 -0
- package/dist/hono/index.d.cts +44 -0
- package/dist/hono/index.d.ts +44 -0
- package/dist/hono/index.js +630 -0
- package/dist/hono/index.js.map +1 -0
- package/dist/index.cjs +720 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +81 -0
- package/dist/index.d.ts +81 -0
- package/dist/index.js +686 -0
- package/dist/index.js.map +1 -0
- package/dist/koa/index.cjs +739 -0
- package/dist/koa/index.cjs.map +1 -0
- package/dist/koa/index.d.cts +68 -0
- package/dist/koa/index.d.ts +68 -0
- package/dist/koa/index.js +709 -0
- package/dist/koa/index.js.map +1 -0
- package/dist/nestjs/index.cjs +1117 -0
- package/dist/nestjs/index.cjs.map +1 -0
- package/dist/nestjs/index.d.cts +104 -0
- package/dist/nestjs/index.d.ts +104 -0
- package/dist/nestjs/index.js +1079 -0
- package/dist/nestjs/index.js.map +1 -0
- package/dist/server-fzkb-wJo.d.cts +194 -0
- package/dist/server-fzkb-wJo.d.ts +194 -0
- package/package.json +225 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/nestjs/index.ts","../../src/core/dispatch.ts","../../src/core/node.ts","../../src/core/schema.ts","../../src/core/route-tool.ts","../../src/core/server.ts","../../src/nestjs/dto-schema.ts"],"sourcesContent":["import {\n All,\n Controller,\n Inject,\n Injectable,\n Module,\n Req,\n Res,\n SetMetadata,\n UseGuards,\n VERSION_NEUTRAL,\n type CanActivate,\n type DynamicModule,\n type Type,\n} from '@nestjs/common';\nimport { ApplicationConfig, DiscoveryModule, DiscoveryService } from '@nestjs/core';\nimport type { IncomingMessage } from 'node:http';\nimport { createFetchDispatcher } from '../core/dispatch.js';\nimport { loopbackBaseUrl, normalizeHeaders } from '../core/node.js';\nimport { createRouteTool, joinPaths, sanitizeToolName } from '../core/route-tool.js';\nimport { McpServer } from '../core/server.js';\nimport type { JsonSchema, McpServerOptions, McpToolDefinition, RouteToolOptions, ToolContext } from '../core/types.js';\nimport { dtoToJsonSchema, primitiveSchema, type ClassValidatorStorage } from './dto-schema.js';\n\nexport { dtoToJsonSchema } from './dto-schema.js';\n\n// Nest's metadata keys (stable across Nest 8 – 12).\nconst PATH_METADATA = 'path';\nconst METHOD_METADATA = 'method';\nconst ROUTE_ARGS_METADATA = '__routeArguments__';\nconst VERSION_METADATA = '__version__';\nconst REQUEST_METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'ALL', 'OPTIONS', 'HEAD'];\nconst PARAMTYPE_BODY = 3;\nconst PARAMTYPE_QUERY = 4;\nconst PARAMTYPE_PARAM = 5;\n\nexport const MCP_TOOL_METADATA = 'mcp-expose:tool';\nexport const MCP_MODULE_OPTIONS = Symbol('MCP_MODULE_OPTIONS');\n\ndeclare const Reflect: {\n getMetadata(key: unknown, target: object, prop?: string | symbol): any;\n};\n\n/**\n * Expose a controller method as an MCP tool.\n *\n * @Get(':id')\n * @McpTool({ description: 'Get a user by id' })\n * findOne(@Param('id') id: string) { ... }\n *\n * The input schema is derived from `@Param()`, `@Query()` and `@Body()` DTOs\n * (class-validator rules and @ApiProperty descriptions), unless you pass\n * `input` / `body` / `query` / `params` yourself.\n */\nexport function McpTool(options: RouteToolOptions = {}): MethodDecorator {\n return SetMetadata(MCP_TOOL_METADATA, options);\n}\n\nexport interface McpModuleOptions extends McpServerOptions {\n /**\n * Path of the MCP endpoint. @default 'mcp'\n * The app's global prefix applies to it unless you exclude it.\n */\n path?: string;\n /** Guards for the MCP endpoint itself, e.g. `[JwtAuthGuard]`. Global guards apply too. */\n guards?: (Type<CanActivate> | CanActivate)[];\n /**\n * Base URL for internal calls. Defaults to loopback on the port the MCP\n * request arrived on.\n */\n baseUrl?: string;\n /**\n * Prefix added to every tool route. Normally not needed: the app's global\n * prefix and URI versioning are detected automatically.\n */\n pathPrefix?: string;\n /** Extra hand-written tools (see `defineTool`). */\n tools?: McpToolDefinition[];\n /**\n * class-validator's metadata storage, used to turn DTOs into JSON Schema.\n * Loaded automatically from `class-validator` when installed.\n */\n classValidatorStorage?: ClassValidatorStorage;\n}\n\nexport interface McpModuleAsyncOptions extends Pick<McpModuleOptions, 'path' | 'guards'> {\n /** Modules that export the providers listed in `inject`. */\n imports?: NonNullable<DynamicModule['imports']>;\n /** Providers passed to `useFactory`. */\n inject?: (string | symbol | Function)[];\n /** Returns the remaining options (everything except `path` and `guards`). */\n useFactory: (\n ...args: any[]\n ) => Omit<McpModuleOptions, 'path' | 'guards'> | Promise<Omit<McpModuleOptions, 'path' | 'guards'>>;\n}\n\ninterface ControllerWrapper {\n metatype?: Function | null;\n instance?: object;\n}\n\n/** Holds the MCP server and discovers `@McpTool()` handlers. Inject it to add tools at runtime. */\nexport class McpService {\n readonly server: McpServer;\n\n constructor(\n private readonly discovery: DiscoveryService,\n private readonly appConfig: ApplicationConfig,\n private readonly options: McpModuleOptions,\n ) {\n this.server = new McpServer(options);\n for (const t of options.tools ?? []) this.server.addTool(t);\n const dispatch = createFetchDispatcher({\n baseUrl: options.baseUrl ?? ((ctx) => loopbackBaseUrl(ctx.raw as IncomingMessage)),\n });\n this.server.onLoad(async () => {\n const storage = options.classValidatorStorage ?? (await loadClassValidator());\n for (const t of this.discover(storage)) {\n this.server.addTool(createRouteTool(t.route, t.options, dispatch, options));\n }\n });\n }\n\n private globalPrefix(): string {\n return this.appConfig.getGlobalPrefix?.() ?? '';\n }\n\n private versionSegment(controller: Function, handler: Function): string | undefined {\n const versioning = (\n this.appConfig as {\n getVersioning?(): { type: number; prefix?: string | false; defaultVersion?: unknown } | undefined;\n }\n ).getVersioning?.();\n if (!versioning || versioning.type !== 0 /* VersioningType.URI */) return undefined;\n let version =\n Reflect.getMetadata(VERSION_METADATA, handler) ??\n Reflect.getMetadata(VERSION_METADATA, controller) ??\n versioning.defaultVersion;\n if (Array.isArray(version)) version = version[0];\n if (version === undefined || typeof version === 'symbol') return undefined;\n const prefix = versioning.prefix === false ? '' : (versioning.prefix ?? 'v');\n return `${prefix}${String(version)}`;\n }\n\n private discover(storage: ClassValidatorStorage | undefined) {\n const found: { route: { method: string; path: string }; options: RouteToolOptions }[] = [];\n for (const wrapper of this.discovery.getControllers() as ControllerWrapper[]) {\n const controller = wrapper.metatype;\n if (!controller?.prototype) continue;\n const proto = controller.prototype;\n const ctrlPaths = toArray(Reflect.getMetadata(PATH_METADATA, controller) ?? '/');\n const ctrlName = controller.name.replace(/Controller$/, '');\n\n for (const key of Object.getOwnPropertyNames(proto)) {\n if (key === 'constructor') continue;\n const handler = Object.getOwnPropertyDescriptor(proto, key)?.value;\n if (typeof handler !== 'function') continue;\n const meta: RouteToolOptions | undefined = Reflect.getMetadata(MCP_TOOL_METADATA, handler);\n if (!meta) continue;\n const method = REQUEST_METHODS[Reflect.getMetadata(METHOD_METADATA, handler) as number] ?? 'GET';\n const methodPath = toArray(Reflect.getMetadata(PATH_METADATA, handler) ?? '/')[0] as string;\n const path = joinPaths(\n this.globalPrefix(),\n this.versionSegment(controller, handler),\n this.options.pathPrefix,\n ctrlPaths[0] as string,\n methodPath,\n );\n found.push({\n route: { method: method === 'ALL' ? 'POST' : method, path },\n options: {\n name: sanitizeToolName(`${toSnake(ctrlName)}_${toSnake(key)}`),\n ...describeArgs(controller, key, storage),\n ...meta,\n },\n });\n }\n }\n return found;\n }\n}\n\n/** Derive params/query/body schemas from the handler's decorated arguments. */\nfunction describeArgs(controller: Function, key: string, storage: ClassValidatorStorage | undefined): RouteToolOptions {\n const args: Record<string, { index: number; data?: unknown }> =\n Reflect.getMetadata(ROUTE_ARGS_METADATA, controller, key) ?? {};\n const types: unknown[] = Reflect.getMetadata('design:paramtypes', controller.prototype, key) ?? [];\n const params: JsonSchema = { type: 'object', properties: {} };\n const query: JsonSchema = { type: 'object', properties: {}, required: [] };\n let body: JsonSchema | undefined;\n\n const schemaFor = (t: unknown): JsonSchema =>\n primitiveSchema(t) ?? (typeof t === 'function' ? dtoToJsonSchema(t, storage) : {});\n\n for (const [k, arg] of Object.entries(args)) {\n const paramtype = Number(k.split(':')[0]);\n const t = types[arg.index];\n const field = typeof arg.data === 'string' ? arg.data : undefined;\n if (paramtype === PARAMTYPE_PARAM && field) {\n params.properties![field] = primitiveSchema(t) ?? { type: 'string' };\n } else if (paramtype === PARAMTYPE_QUERY) {\n if (field) query.properties![field] = primitiveSchema(t) ?? { type: 'string' };\n else Object.assign(query, mergeObject(query, schemaFor(t)));\n } else if (paramtype === PARAMTYPE_BODY) {\n if (field) {\n body ??= { type: 'object', properties: {}, required: [] };\n body.properties![field] = schemaFor(t);\n (body.required as string[]).push(field);\n } else {\n body = mergeObject(body, schemaFor(t));\n }\n }\n }\n const out: RouteToolOptions = { params };\n if (Object.keys(query.properties!).length) out.query = query;\n if (body) out.body = body;\n return out;\n}\n\nfunction mergeObject(a: JsonSchema | undefined, b: JsonSchema): JsonSchema {\n if (!a) return b;\n return {\n type: 'object',\n properties: { ...a.properties, ...b.properties },\n required: [...(a.required ?? []), ...(b.required ?? [])],\n };\n}\n\nasync function loadClassValidator(): Promise<ClassValidatorStorage | undefined> {\n try {\n const cv = (await import('class-validator')) as { getMetadataStorage?: () => ClassValidatorStorage };\n return cv.getMetadataStorage?.();\n } catch {\n return undefined;\n }\n}\n\nfunction toArray<T>(v: T | T[]): T[] {\n return Array.isArray(v) ? v : [v];\n}\n\nfunction toSnake(s: string): string {\n return s\n .replace(/([a-z0-9])([A-Z])/g, '$1_$2')\n .replace(/[-\\s]+/g, '_')\n .toLowerCase();\n}\n\n// Decorators are applied by hand so this package builds without\n// `experimentalDecorators` / `emitDecoratorMetadata`.\nInjectable()(McpService);\nInject(DiscoveryService)(McpService, undefined as never, 0);\nInject(ApplicationConfig)(McpService, undefined as never, 1);\nInject(MCP_MODULE_OPTIONS)(McpService, undefined as never, 2);\n\ninterface AnyReq {\n method: string;\n headers: Record<string, string | string[] | undefined>;\n body?: unknown;\n ip?: string;\n raw?: IncomingMessage;\n socket?: unknown;\n}\ninterface AnyRes {\n // Express\n status?(code: number): AnyRes;\n set?(headers: Record<string, string>): AnyRes;\n // Fastify\n code?(code: number): AnyRes;\n headers?(headers: Record<string, string>): AnyRes;\n send(body?: unknown): unknown;\n end?(body?: unknown): unknown;\n}\n\nfunction createMcpController(options: Pick<McpModuleOptions, 'path' | 'guards'>): Type<unknown> {\n class McpController {\n constructor(readonly mcp: McpService) {}\n\n async handle(req: AnyReq, res: AnyRes) {\n const nodeReq = (req.raw ?? req) as IncomingMessage;\n const headers = normalizeHeaders(req.headers);\n const ctx: ToolContext = { headers, clientIp: req.ip, raw: nodeReq };\n const out = await this.mcp.server.handleHttp({ method: req.method, headers, body: req.body }, ctx);\n if (typeof res.code === 'function') {\n res.code(out.status).headers!(out.headers).send(out.body);\n } else {\n res.status!(out.status).set!(out.headers);\n if (out.body === undefined) res.end!();\n else res.send(out.body);\n }\n }\n }\n const proto = McpController.prototype;\n const descriptor = Object.getOwnPropertyDescriptor(proto, 'handle')!;\n // Version-neutral so URI versioning never moves the endpoint to /v1/mcp.\n Controller({ path: options.path ?? 'mcp', version: VERSION_NEUTRAL })(McpController);\n Inject(McpService)(McpController, undefined as never, 0);\n All()(proto, 'handle', descriptor);\n Req()(proto, 'handle', 0);\n Res()(proto, 'handle', 1);\n if (options.guards?.length) UseGuards(...options.guards)(McpController);\n return McpController;\n}\n\n/**\n * Adds an MCP endpoint to a NestJS app (Express or Fastify platform):\n *\n * @Module({ imports: [McpModule.forRoot({ name: 'shop-api' })] })\n *\n * Remember to exclude the MCP path from your global prefix if you want it at\n * `/mcp`: `app.setGlobalPrefix('api', { exclude: ['mcp'] })`.\n */\nexport class McpModule {\n static forRoot(options: McpModuleOptions): DynamicModule {\n return {\n module: McpModule,\n global: true,\n imports: [DiscoveryModule],\n controllers: [createMcpController(options)],\n providers: [{ provide: MCP_MODULE_OPTIONS, useValue: options }, McpService],\n exports: [McpService],\n };\n }\n\n /**\n * Resolve the options from other providers, e.g. `ConfigService`:\n *\n * McpModule.forRootAsync({\n * imports: [ConfigModule],\n * inject: [ConfigService],\n * useFactory: (config: ConfigService) => ({ name: config.get('APP_NAME') }),\n * })\n *\n * `path` and `guards` define the MCP controller, so they are passed directly.\n */\n static forRootAsync(options: McpModuleAsyncOptions): DynamicModule {\n return {\n module: McpModule,\n global: true,\n imports: [DiscoveryModule, ...(options.imports ?? [])],\n controllers: [createMcpController(options)],\n providers: [\n {\n provide: MCP_MODULE_OPTIONS,\n inject: options.inject ?? [],\n useFactory: async (...args: unknown[]) => ({\n ...(await options.useFactory(...args)),\n ...(options.path ? { path: options.path } : {}),\n }),\n },\n McpService,\n ],\n exports: [McpService],\n };\n }\n}\nModule({})(McpModule);\n","import type { Dispatcher, RouteRequest, ToolContext } from './types.js';\n\nexport function buildUrl(base: string, req: Pick<RouteRequest, 'path' | 'query'>): string {\n const url = new URL(base.replace(/\\/+$/, '') + req.path);\n for (const [k, v] of Object.entries(req.query)) {\n for (const item of Array.isArray(v) ? v : [v]) url.searchParams.append(k, item);\n }\n return url.toString();\n}\n\nexport interface FetchDispatcherOptions {\n /**\n * Base URL of the API, e.g. `http://127.0.0.1:3000` or `https://api.example.com/v1`.\n * A function lets adapters resolve it per call (e.g. from the local port).\n */\n baseUrl: string | ((ctx: ToolContext) => string);\n /** Custom fetch implementation. Defaults to the global `fetch`. */\n fetch?: typeof fetch;\n /** Per-request timeout in ms. @default 30_000 */\n timeoutMs?: number;\n}\n\n/**\n * Dispatches tool calls as real HTTP requests. Used for loopback calls into the\n * host app (Express, Koa, NestJS) and for standalone gateways in front of any API.\n */\nexport function createFetchDispatcher(opts: FetchDispatcherOptions): Dispatcher {\n const doFetch = opts.fetch ?? fetch;\n return async (req, ctx) => {\n const base = typeof opts.baseUrl === 'function' ? opts.baseUrl(ctx) : opts.baseUrl;\n const res = await doFetch(buildUrl(base, req), {\n method: req.method,\n headers: req.headers,\n body:\n req.body === undefined || req.method === 'GET' || req.method === 'HEAD' ? undefined : JSON.stringify(req.body),\n signal: AbortSignal.timeout(opts.timeoutMs ?? 30_000),\n });\n const headers: Record<string, string> = {};\n res.headers.forEach((v, k) => (headers[k] = v));\n return { status: res.status, headers, body: await res.text() };\n };\n}\n","import type { IncomingMessage, ServerResponse } from 'node:http';\nimport type { McpHttpResponse } from './server.js';\n\n/** Flatten Node's IncomingHttpHeaders into lower-cased single strings. */\nexport function normalizeHeaders(headers: Record<string, string | string[] | undefined>): Record<string, string> {\n const out: Record<string, string> = {};\n for (const [k, v] of Object.entries(headers)) {\n if (v === undefined) continue;\n out[k.toLowerCase()] = Array.isArray(v) ? v.join(', ') : String(v);\n }\n return out;\n}\n\n/** Read and return the raw body of a Node request (for frameworks without a JSON body parser). */\nexport function readRawBody(req: IncomingMessage, limit = 4 * 1024 * 1024): Promise<string> {\n return new Promise((resolve, reject) => {\n let size = 0;\n const chunks: Buffer[] = [];\n req.on('data', (c: Buffer) => {\n size += c.length;\n if (size > limit) {\n reject(new Error('Request body too large'));\n req.destroy();\n } else chunks.push(c);\n });\n req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));\n req.on('error', reject);\n });\n}\n\n/** Base URL that reaches the same server the MCP request arrived on. */\nexport function loopbackBaseUrl(req: IncomingMessage): string {\n const socket = req.socket as IncomingMessage['socket'] & {\n encrypted?: boolean;\n server?: { address(): { address: string } | string | null };\n };\n const port = socket.localPort;\n const encrypted = socket.encrypted;\n // Prefer the address the server is bound to: when it listens on all\n // interfaces this yields 127.0.0.1, so internal calls come from loopback\n // (which `trust proxy: 'loopback'` style settings rely on).\n const bound = socket.server?.address();\n let host = (typeof bound === 'object' && bound?.address) || socket.localAddress || '127.0.0.1';\n if (host.startsWith('::ffff:')) host = host.slice(7);\n if (host === '::' || host === '0.0.0.0') host = '127.0.0.1';\n if (host.includes(':')) host = `[${host}]`;\n return `${encrypted ? 'https' : 'http'}://${host}:${port}`;\n}\n\nexport function writeNodeResponse(res: ServerResponse, out: McpHttpResponse): void {\n res.statusCode = out.status;\n for (const [k, v] of Object.entries(out.headers)) res.setHeader(k, v);\n res.end(out.body);\n}\n","import type { JsonSchema, McpToolDefinition, SchemaLike } from './types.js';\n\ninterface StandardSchemaV1 {\n '~standard': {\n validate?: (value: unknown) => unknown;\n jsonSchema?: { input?: (opts: { target: string }) => unknown };\n };\n}\n\nfunction isStandard(s: unknown): s is StandardSchemaV1 {\n return typeof s === 'object' && s !== null && '~standard' in s;\n}\n\n/** Convert any supported schema flavour into a plain JSON Schema object. */\nexport function toJsonSchema(schema: SchemaLike | undefined): JsonSchema | undefined {\n if (schema === undefined || schema === null) return undefined;\n let out: unknown;\n if (isStandard(schema) && typeof schema['~standard'].jsonSchema?.input === 'function') {\n out = schema['~standard'].jsonSchema.input({ target: 'draft-2020-12' });\n } else if (typeof (schema as { toJSONSchema?: unknown }).toJSONSchema === 'function') {\n out = (schema as { toJSONSchema(): unknown }).toJSONSchema();\n } else if (isStandard(schema)) {\n throw new Error(\n 'mcp-expose: this schema library does not support JSON Schema export. Pass a plain JSON Schema instead.',\n );\n } else {\n out = schema;\n }\n const { $schema: _ignored, ...rest } = out as JsonSchema;\n return rest;\n}\n\n/** Build a validator from a Standard Schema, if the input is one. */\nexport function toValidator(schema: SchemaLike | undefined): McpToolDefinition['validate'] {\n if (!isStandard(schema) || typeof schema['~standard'].validate !== 'function') return undefined;\n const validate = schema['~standard'].validate;\n return async (value) => {\n const result = (await validate(value)) as {\n value?: unknown;\n issues?: { message: string; path?: (PropertyKey | { key: PropertyKey })[] }[];\n };\n if (!result.issues) return { ok: true, value: result.value };\n const message = result.issues\n .map((i) => {\n const path = (i.path ?? []).map((p) => (typeof p === 'object' ? String(p.key) : String(p))).join('.');\n return path ? `${path}: ${i.message}` : i.message;\n })\n .join('; ');\n return { ok: false, message };\n };\n}\n\n/** Very small structural check used when no Standard Schema validator exists. */\nexport function checkRequired(schema: JsonSchema, args: Record<string, unknown>): string | undefined {\n const missing = (schema.required ?? []).filter((k) => args[k] === undefined);\n return missing.length ? `Missing required argument(s): ${missing.join(', ')}` : undefined;\n}\n","import { checkRequired, toJsonSchema, toValidator } from './schema.js';\nimport type {\n Dispatcher,\n JsonSchema,\n McpServerOptions,\n McpToolDefinition,\n RouteResponse,\n RouteSpec,\n RouteToolOptions,\n ToolAnnotations,\n ToolContext,\n ToolResult,\n} from './types.js';\n\nexport const DEFAULT_FORWARD_HEADERS = ['authorization', 'cookie', 'x-api-key', 'accept-language'];\nconst BODY_METHODS = new Set(['POST', 'PUT', 'PATCH']);\nconst PARAM_RE = /:([A-Za-z0-9_]+)\\??|\\{([A-Za-z0-9_]+)\\}/g;\n\n/** Names of the path parameters in a route path (`/a/:id/{slug}` -> ['id', 'slug']). */\nexport function pathParams(path: string): string[] {\n return [...path.matchAll(PARAM_RE)].map((m) => (m[1] ?? m[2]) as string);\n}\n\n/**\n * Encode one path-parameter value. Rejects empty, `.` and `..` values: after URL\n * normalisation they would change which route is called (e.g. `/orders/../admin`),\n * letting an agent reach routes that were never exposed as tools.\n */\nfunction encodeSegment(name: string, value: unknown): string {\n const raw = String(value);\n if (raw === '' || raw === '.' || raw === '..') {\n throw new Error(`Invalid value for path parameter \"${name}\": ${JSON.stringify(raw)}`);\n }\n return encodeURIComponent(raw);\n}\n\n/** Replace path placeholders with URL-encoded values. Missing optional params drop their segment. */\nexport function interpolatePath(path: string, values: Record<string, unknown>): string {\n return path\n .replace(/\\/:([A-Za-z0-9_]+)\\?/g, (_, k: string) =>\n values[k] === undefined ? '' : `/${encodeSegment(k, values[k])}`,\n )\n .replace(PARAM_RE, (_, a?: string, b?: string) => {\n const k = (a ?? b) as string;\n return encodeSegment(k, values[k]);\n });\n}\n\n/** Join path segments, normalising slashes. */\nexport function joinPaths(...parts: (string | undefined)[]): string {\n const joined = parts\n .filter((p): p is string => !!p && p !== '/')\n .map((p) => p.replace(/^\\/+|\\/+$/g, ''))\n .filter(Boolean)\n .join('/');\n return `/${joined}`;\n}\n\n/** `GET /users/:id/orders` -> `get_users_by_id_orders` */\nexport function toolNameFromRoute(method: string, path: string): string {\n const segments = path\n .split('/')\n .filter(Boolean)\n .map((s) => {\n const m = /^(?::([A-Za-z0-9_]+)\\??|\\{([A-Za-z0-9_]+)\\})$/.exec(s);\n return m ? `by_${m[1] ?? m[2]}` : s;\n });\n return sanitizeToolName([method.toLowerCase(), ...segments].join('_'));\n}\n\nexport function sanitizeToolName(name: string): string {\n return name\n .replace(/[^A-Za-z0-9_-]+/g, '_')\n .replace(/_+/g, '_')\n .replace(/^_|_$/g, '')\n .slice(0, 64);\n}\n\nfunction defaultAnnotations(method: string): ToolAnnotations {\n switch (method) {\n case 'GET':\n case 'HEAD':\n return { readOnlyHint: true, openWorldHint: false };\n case 'DELETE':\n return { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false };\n case 'PUT':\n return { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };\n default:\n return { readOnlyHint: false, destructiveHint: false, openWorldHint: false };\n }\n}\n\ninterface ArgMapping {\n params: string[];\n query: Set<string>;\n body: Set<string>;\n /** Body schema is not an object: the whole body is passed under the `body` key. */\n wholeBody: boolean;\n bodyMethod: boolean;\n}\n\n/**\n * Build the flat input schema an agent sees, and remember which argument goes\n * to the path, query string or body when the tool is called.\n */\nexport function buildInputSchema(\n route: RouteSpec,\n opts: RouteToolOptions,\n): { schema: JsonSchema; mapping: ArgMapping } {\n const method = route.method.toUpperCase();\n const params = pathParams(route.path);\n const mapping: ArgMapping = {\n params,\n query: new Set(),\n body: new Set(),\n wholeBody: false,\n bodyMethod: BODY_METHODS.has(method),\n };\n\n if (opts.input) {\n const schema = toJsonSchema(opts.input) as JsonSchema;\n return { schema: { type: 'object', ...schema }, mapping };\n }\n\n const properties: Record<string, JsonSchema> = {};\n const required = new Set<string>();\n\n const paramSchema = toJsonSchema(opts.params);\n for (const p of params) {\n properties[p] = paramSchema?.properties?.[p] ?? { type: 'string', description: `Path parameter \"${p}\"` };\n if (!route.path.includes(`:${p}?`)) required.add(p);\n }\n\n const querySchema = toJsonSchema(opts.query);\n for (const [k, v] of Object.entries(querySchema?.properties ?? {})) {\n properties[k] = v;\n mapping.query.add(k);\n }\n for (const k of querySchema?.required ?? []) required.add(k);\n\n const bodySchema = toJsonSchema(opts.body);\n if (bodySchema) {\n if (bodySchema.properties && (bodySchema.type === undefined || bodySchema.type === 'object')) {\n for (const [k, v] of Object.entries(bodySchema.properties)) {\n properties[k] = v;\n mapping.body.add(k);\n }\n for (const k of bodySchema.required ?? []) required.add(k);\n } else {\n properties.body = bodySchema;\n required.add('body');\n mapping.wholeBody = true;\n }\n }\n\n const schema: JsonSchema = { type: 'object', properties };\n if (required.size) schema.required = [...required];\n return { schema, mapping };\n}\n\nfunction splitArgs(args: Record<string, unknown>, mapping: ArgMapping) {\n const pathValues: Record<string, unknown> = {};\n const query: Record<string, string | string[]> = {};\n let body: Record<string, unknown> | unknown | undefined;\n\n for (const [k, v] of Object.entries(args)) {\n if (v === undefined) continue;\n if (mapping.params.includes(k)) {\n pathValues[k] = v;\n } else if (mapping.wholeBody && k === 'body') {\n body = v;\n } else if (mapping.query.has(k) || (!mapping.body.has(k) && !mapping.bodyMethod)) {\n query[k] = Array.isArray(v) ? v.map(String) : typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v);\n } else {\n body = { ...((body as Record<string, unknown>) ?? {}), [k]: v };\n }\n }\n if (body === undefined && mapping.bodyMethod) body = {};\n return { pathValues, query, body };\n}\n\nexport function responseToResult(res: RouteResponse, maxChars: number): ToolResult {\n let text = res.body;\n if (text.length > maxChars) text = `${text.slice(0, maxChars)}\\n…[truncated ${text.length - maxChars} chars]`;\n const isError = res.status >= 400;\n const result: ToolResult = {\n content: [{ type: 'text', text: isError ? `HTTP ${res.status}\\n${text}` : text || `HTTP ${res.status}` }],\n };\n if (isError) {\n result.isError = true;\n return result;\n }\n if ((res.headers['content-type'] ?? '').includes('json') && text === res.body) {\n try {\n const parsed = JSON.parse(res.body);\n if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) result.structuredContent = parsed;\n } catch {\n /* not JSON after all */\n }\n }\n return result;\n}\n\nexport function pickForwardHeaders(ctx: ToolContext, names: string[]): Record<string, string> {\n const out: Record<string, string> = {};\n for (const name of names) {\n const v = ctx.headers[name.toLowerCase()];\n if (v !== undefined) out[name.toLowerCase()] = v;\n }\n return out;\n}\n\n/**\n * Turn an HTTP route + options into an MCP tool whose handler calls the route\n * through `dispatch`, so auth guards, validation and rate limits all still apply.\n */\nexport function createRouteTool(\n route: RouteSpec,\n opts: RouteToolOptions,\n dispatch: Dispatcher,\n serverOpts: Pick<McpServerOptions, 'forwardHeaders' | 'maxResponseChars'> = {},\n): McpToolDefinition {\n const method = route.method.toUpperCase();\n const name = sanitizeToolName(opts.name ?? toolNameFromRoute(method, route.path));\n const { schema, mapping } = buildInputSchema(route, opts);\n const forward = serverOpts.forwardHeaders ?? DEFAULT_FORWARD_HEADERS;\n const maxChars = serverOpts.maxResponseChars ?? 100_000;\n\n return {\n name,\n title: opts.title,\n description: opts.description ?? `${method} ${route.path}`,\n inputSchema: schema,\n annotations: { ...defaultAnnotations(method), ...opts.annotations },\n validate: toValidator(opts.input),\n async handler(args, ctx) {\n const missing = opts.input ? undefined : checkRequired(schema, args);\n if (missing) return { isError: true, content: [{ type: 'text', text: missing }] };\n\n const { pathValues, query, body } = splitArgs(args, mapping);\n const headers: Record<string, string> = {\n accept: 'application/json',\n ...pickForwardHeaders(ctx, forward),\n ...opts.headers,\n 'x-mcp-tool': name,\n };\n if (ctx.clientIp) headers['x-forwarded-for'] = ctx.clientIp;\n if (body !== undefined) headers['content-type'] = 'application/json';\n\n let path: string;\n try {\n path = interpolatePath(route.path, pathValues);\n } catch (err) {\n return { isError: true, content: [{ type: 'text', text: (err as Error).message }] };\n }\n const res = await dispatch({ method, path, query, body, headers }, ctx);\n return responseToResult(res, maxChars);\n },\n };\n}\n","import type { McpServerOptions, McpToolDefinition, ToolContext, ToolResult } from './types.js';\n\nexport const SUPPORTED_PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05'];\nexport const LATEST_PROTOCOL_VERSION = SUPPORTED_PROTOCOL_VERSIONS[0] as string;\n\ntype JsonRpcId = string | number | null;\ninterface JsonRpcRequest {\n jsonrpc: '2.0';\n id?: JsonRpcId;\n method: string;\n params?: Record<string, unknown>;\n}\nexport interface JsonRpcResponse {\n jsonrpc: '2.0';\n id: JsonRpcId;\n result?: unknown;\n error?: { code: number; message: string; data?: unknown };\n}\n\nconst PARSE_ERROR = -32700;\nconst INVALID_REQUEST = -32600;\nconst METHOD_NOT_FOUND = -32601;\nconst INVALID_PARAMS = -32602;\n\nconst ok = (id: JsonRpcId, result: unknown): JsonRpcResponse => ({ jsonrpc: '2.0', id, result });\nconst fail = (id: JsonRpcId, code: number, message: string): JsonRpcResponse => ({\n jsonrpc: '2.0',\n id,\n error: { code, message },\n});\n\n/** Minimal HTTP request/response shapes, so each adapter can bridge its own framework. */\nexport interface McpHttpRequest {\n method: string;\n headers: Record<string, string>;\n /** Parsed JSON body, or the raw string. */\n body: unknown;\n}\nexport interface McpHttpResponse {\n status: number;\n headers: Record<string, string>;\n body?: string;\n}\n\n/**\n * A stateless MCP server speaking the Streamable HTTP transport (JSON responses).\n * Holds the tool registry and answers JSON-RPC messages.\n */\nexport class McpServer {\n private readonly tools = new Map<string, McpToolDefinition>();\n private loaders: (() => void | Promise<void>)[] = [];\n\n constructor(readonly options: McpServerOptions) {}\n\n /** Register a tool. Throws on duplicate names. */\n addTool(tool: McpToolDefinition): this {\n if (this.tools.has(tool.name)) {\n throw new Error(`mcp-expose: duplicate tool name \"${tool.name}\". Set an explicit \\`name\\`.`);\n }\n this.tools.set(tool.name, tool);\n return this;\n }\n\n /** Register a function that adds tools lazily, right before the first MCP request is served. */\n onLoad(loader: () => void | Promise<void>): this {\n this.loaders.push(loader);\n return this;\n }\n\n async listTools(): Promise<McpToolDefinition[]> {\n await this.load();\n return [...this.tools.values()];\n }\n\n private async load() {\n if (!this.loaders.length) return;\n const loaders = this.loaders;\n this.loaders = [];\n for (const l of loaders) await l();\n }\n\n /** Handle one JSON-RPC message (or a batch). Returns null when no response is due. */\n async handleMessage(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | JsonRpcResponse[] | null> {\n if (Array.isArray(message)) {\n const results = (await Promise.all(message.map((m) => this.handleOne(m, ctx)))).filter(\n (r): r is JsonRpcResponse => r !== null,\n );\n return results.length ? results : null;\n }\n return this.handleOne(message, ctx);\n }\n\n private async handleOne(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | null> {\n const msg = message as Partial<JsonRpcRequest>;\n if (!msg || typeof msg !== 'object' || msg.jsonrpc !== '2.0') {\n return fail(null, INVALID_REQUEST, 'Invalid JSON-RPC message');\n }\n // Responses from the client or notifications: acknowledge, no reply.\n if (typeof msg.method !== 'string' || msg.id === undefined) return null;\n const id = msg.id;\n const params = msg.params ?? {};\n\n await this.load();\n switch (msg.method) {\n case 'initialize': {\n const requested = params.protocolVersion as string | undefined;\n const protocolVersion =\n requested && SUPPORTED_PROTOCOL_VERSIONS.includes(requested) ? requested : LATEST_PROTOCOL_VERSION;\n return ok(id, {\n protocolVersion,\n capabilities: { tools: { listChanged: false } },\n serverInfo: { name: this.options.name, version: this.options.version ?? '1.0.0' },\n ...(this.options.instructions ? { instructions: this.options.instructions } : {}),\n });\n }\n case 'ping':\n return ok(id, {});\n case 'tools/list':\n return ok(id, {\n tools: [...this.tools.values()].map((t) => ({\n name: t.name,\n ...(t.title ? { title: t.title } : {}),\n description: t.description,\n inputSchema: t.inputSchema,\n ...(t.annotations ? { annotations: t.annotations } : {}),\n })),\n });\n case 'tools/call': {\n const tool = this.tools.get(params.name as string);\n if (!tool) return fail(id, INVALID_PARAMS, `Unknown tool: ${String(params.name)}`);\n return ok(id, await this.callTool(tool, (params.arguments ?? {}) as Record<string, unknown>, ctx));\n }\n case 'resources/list':\n return ok(id, { resources: [] });\n case 'prompts/list':\n return ok(id, { prompts: [] });\n default:\n return fail(id, METHOD_NOT_FOUND, `Method not found: ${msg.method}`);\n }\n }\n\n private async callTool(\n tool: McpToolDefinition,\n args: Record<string, unknown>,\n ctx: ToolContext,\n ): Promise<ToolResult> {\n try {\n if (tool.validate) {\n const v = await tool.validate(args);\n if (!v.ok) return { isError: true, content: [{ type: 'text', text: `Invalid arguments: ${v.message}` }] };\n args = v.value as Record<string, unknown>;\n }\n return await tool.handler(args, ctx);\n } catch (err) {\n // Tool failures are reported in-band so the model can react to them.\n return { isError: true, content: [{ type: 'text', text: `Tool error: ${(err as Error).message}` }] };\n }\n }\n\n /** Check the Origin header (DNS rebinding protection). */\n isOriginAllowed(origin: string | undefined): boolean {\n if (!origin) return true;\n const allowed = this.options.allowedOrigins;\n if (allowed === '*') return true;\n return (allowed ?? []).includes(origin);\n }\n\n /**\n * Framework-neutral Streamable HTTP handler. Adapters convert their request\n * into McpHttpRequest, call this, and write the McpHttpResponse back.\n */\n async handleHttp(req: McpHttpRequest, ctx: ToolContext): Promise<McpHttpResponse> {\n const json = { 'content-type': 'application/json' };\n if (!this.isOriginAllowed(req.headers.origin)) {\n return { status: 403, headers: json, body: JSON.stringify(fail(null, INVALID_REQUEST, 'Origin not allowed')) };\n }\n if (req.method.toUpperCase() !== 'POST') {\n // Stateless server: no standalone SSE stream and no sessions to delete.\n return { status: 405, headers: { allow: 'POST' } };\n }\n let body = req.body;\n if (typeof body === 'string' || body instanceof Uint8Array) {\n try {\n body = JSON.parse(typeof body === 'string' ? body : new TextDecoder().decode(body));\n } catch {\n return { status: 400, headers: json, body: JSON.stringify(fail(null, PARSE_ERROR, 'Parse error')) };\n }\n }\n const response = await this.handleMessage(body, ctx);\n if (response === null) return { status: 202, headers: {} };\n return { status: 200, headers: json, body: JSON.stringify(response) };\n }\n}\n","import type { JsonSchema } from '../core/types.js';\n\ninterface ValidationMetadata {\n type: string;\n name?: string;\n propertyName: string;\n constraints?: unknown[];\n each?: boolean;\n}\n\nexport interface ClassValidatorStorage {\n getTargetValidationMetadatas(\n target: Function,\n targetSchema: string,\n always: boolean,\n strictGroups: boolean,\n ): ValidationMetadata[];\n}\n\ndeclare const Reflect: { getMetadata?(key: string, target: object, prop?: string | symbol): unknown };\n\nconst PRIMITIVES = new Map<unknown, JsonSchema>([\n [String, { type: 'string' }],\n [Number, { type: 'number' }],\n [Boolean, { type: 'boolean' }],\n [Date, { type: 'string', format: 'date-time' }],\n [Array, { type: 'array' }],\n [Object, { type: 'object' }],\n]);\n\nexport function primitiveSchema(type: unknown): JsonSchema | undefined {\n const s = PRIMITIVES.get(type);\n return s ? { ...s } : undefined;\n}\n\n/** Apply one class-validator rule to a (property or `items`) schema. */\nfunction applyRule(s: JsonSchema, name: string, c: unknown[] = []): void {\n switch (name) {\n case 'isString':\n s.type = 'string';\n break;\n case 'isNumber':\n case 'isNumberString':\n s.type = name === 'isNumber' ? 'number' : 'string';\n break;\n case 'isInt':\n s.type = 'integer';\n break;\n case 'isBoolean':\n s.type = 'boolean';\n break;\n case 'isDate':\n case 'isDateString':\n case 'isISO8601':\n s.type = 'string';\n s.format = 'date-time';\n break;\n case 'isEmail':\n s.type = 'string';\n s.format = 'email';\n break;\n case 'isUrl':\n s.type = 'string';\n s.format = 'uri';\n break;\n case 'isUUID':\n s.type = 'string';\n s.format = 'uuid';\n break;\n case 'isPositive':\n s.exclusiveMinimum = 0;\n break;\n case 'isNegative':\n s.exclusiveMaximum = 0;\n break;\n case 'min':\n s.minimum = c[0];\n break;\n case 'max':\n s.maximum = c[0];\n break;\n case 'minLength':\n s.minLength = c[0];\n break;\n case 'maxLength':\n s.maxLength = c[0];\n break;\n case 'length':\n s.minLength = c[0];\n if (c[1] !== undefined) s.maxLength = c[1];\n break;\n case 'matches':\n if (c[0] instanceof RegExp) s.pattern = c[0].source;\n break;\n case 'isIn':\n s.enum = c[0] as unknown[];\n break;\n case 'isEnum':\n s.enum = (c[1] as unknown[]) ?? Object.values(c[0] as object);\n break;\n case 'isNotEmpty':\n if (s.type === 'string') s.minLength = Math.max(1, Number(s.minLength ?? 0));\n break;\n case 'isArray':\n s.type = 'array';\n break;\n case 'arrayMinSize':\n s.minItems = c[0];\n break;\n case 'arrayMaxSize':\n s.maxItems = c[0];\n break;\n case 'isObject':\n s.type = 'object';\n break;\n }\n}\n\n/**\n * Derive a JSON Schema from a class-validator DTO. Only used to *describe* the\n * tool to the agent: the real validation still happens in your ValidationPipe.\n */\nexport function dtoToJsonSchema(dto: Function, storage: ClassValidatorStorage | undefined, depth = 0): JsonSchema {\n const schema: JsonSchema = { type: 'object', properties: {} };\n if (!storage || depth > 5) return schema;\n const metas = storage.getTargetValidationMetadatas(dto, '', true, false);\n const properties: Record<string, JsonSchema> = {};\n const optional = new Set<string>();\n\n for (const m of metas) {\n const prop = (properties[m.propertyName] ??= initial(dto, m.propertyName));\n if (m.type === 'conditionalValidation' && m.name === 'isOptional') {\n optional.add(m.propertyName);\n } else if (m.type === 'nestedValidation') {\n const nestedType = Reflect.getMetadata?.('design:type', dto.prototype, m.propertyName);\n if (typeof nestedType === 'function' && !PRIMITIVES.has(nestedType)) {\n Object.assign(prop, dtoToJsonSchema(nestedType, storage, depth + 1));\n }\n } else if (m.type === 'customValidation' && m.name) {\n if (m.each) {\n prop.type = 'array';\n const items = (prop.items ??= {}) as JsonSchema;\n applyRule(items, m.name, m.constraints);\n } else {\n applyRule(prop, m.name, m.constraints);\n }\n }\n }\n\n schema.properties = properties;\n const required = Object.keys(properties).filter((p) => !optional.has(p));\n if (required.length) schema.required = required;\n return schema;\n}\n\nfunction initial(dto: Function, prop: string): JsonSchema {\n const designType = Reflect.getMetadata?.('design:type', dto.prototype, prop);\n const s: JsonSchema = primitiveSchema(designType) ?? {};\n // Pick up @nestjs/swagger @ApiProperty() descriptions/examples when present.\n const api = Reflect.getMetadata?.('swagger/apiModelProperties', dto.prototype, prop) as\n { description?: string; example?: unknown; enum?: unknown } | undefined;\n if (api?.description) s.description = api.description;\n if (api?.example !== undefined) s.examples = [api.example];\n if (Array.isArray(api?.enum)) s.enum = api.enum;\n return s;\n}\n"],"mappings":";;;;AAAA,SACEA,KACAC,YACAC,QACAC,YACAC,QACAC,KACAC,KACAC,aACAC,WACAC,uBAIK;AACP,SAASC,mBAAmBC,iBAAiBC,wBAAwB;;;ACb9D,SAASC,SAASC,MAAcC,KAAyC;AAC9E,QAAMC,MAAM,IAAIC,IAAIH,KAAKI,QAAQ,QAAQ,EAAA,IAAMH,IAAII,IAAI;AACvD,aAAW,CAACC,GAAGC,CAAAA,KAAMC,OAAOC,QAAQR,IAAIS,KAAK,GAAG;AAC9C,eAAWC,QAAQC,MAAMC,QAAQN,CAAAA,IAAKA,IAAI;MAACA;MAAIL,KAAIY,aAAaC,OAAOT,GAAGK,IAAAA;EAC5E;AACA,SAAOT,IAAIc,SAAQ;AACrB;AANgBjB;AAwBT,SAASkB,sBAAsBC,MAA4B;AAChE,QAAMC,UAAUD,KAAKE,SAASA;AAC9B,SAAO,OAAOnB,KAAKoB,QAAAA;AACjB,UAAMrB,OAAO,OAAOkB,KAAKI,YAAY,aAAaJ,KAAKI,QAAQD,GAAAA,IAAOH,KAAKI;AAC3E,UAAMC,MAAM,MAAMJ,QAAQpB,SAASC,MAAMC,GAAAA,GAAM;MAC7CuB,QAAQvB,IAAIuB;MACZC,SAASxB,IAAIwB;MACbC,MACEzB,IAAIyB,SAASC,UAAa1B,IAAIuB,WAAW,SAASvB,IAAIuB,WAAW,SAASG,SAAYC,KAAKC,UAAU5B,IAAIyB,IAAI;MAC/GI,QAAQC,YAAYC,QAAQd,KAAKe,aAAa,GAAA;IAChD,CAAA;AACA,UAAMR,UAAkC,CAAC;AACzCF,QAAIE,QAAQS,QAAQ,CAAC3B,GAAGD,MAAOmB,QAAQnB,CAAAA,IAAKC,CAAAA;AAC5C,WAAO;MAAE4B,QAAQZ,IAAIY;MAAQV;MAASC,MAAM,MAAMH,IAAIa,KAAI;IAAG;EAC/D;AACF;AAfgBnB;;;ACtBT,SAASoB,iBAAiBC,SAAsD;AACrF,QAAMC,MAA8B,CAAC;AACrC,aAAW,CAACC,GAAGC,CAAAA,KAAMC,OAAOC,QAAQL,OAAAA,GAAU;AAC5C,QAAIG,MAAMG,OAAW;AACrBL,QAAIC,EAAEK,YAAW,CAAA,IAAMC,MAAMC,QAAQN,CAAAA,IAAKA,EAAEO,KAAK,IAAA,IAAQC,OAAOR,CAAAA;EAClE;AACA,SAAOF;AACT;AAPgBF;AA2BT,SAASa,gBAAgBC,KAAoB;AAClD,QAAMC,SAASD,IAAIC;AAInB,QAAMC,OAAOD,OAAOE;AACpB,QAAMC,YAAYH,OAAOG;AAIzB,QAAMC,QAAQJ,OAAOK,QAAQC,QAAAA;AAC7B,MAAIC,OAAQ,OAAOH,UAAU,YAAYA,OAAOE,WAAYN,OAAOQ,gBAAgB;AACnF,MAAID,KAAKE,WAAW,SAAA,EAAYF,QAAOA,KAAKG,MAAM,CAAA;AAClD,MAAIH,SAAS,QAAQA,SAAS,UAAWA,QAAO;AAChD,MAAIA,KAAKI,SAAS,GAAA,EAAMJ,QAAO,IAAIA,IAAAA;AACnC,SAAO,GAAGJ,YAAY,UAAU,MAAA,MAAYI,IAAAA,IAAQN,IAAAA;AACtD;AAhBgBH;;;ACtBhB,SAASc,WAAWC,GAAU;AAC5B,SAAO,OAAOA,MAAM,YAAYA,MAAM,QAAQ,eAAeA;AAC/D;AAFSD;AAKF,SAASE,aAAaC,QAA8B;AACzD,MAAIA,WAAWC,UAAaD,WAAW,KAAM,QAAOC;AACpD,MAAIC;AACJ,MAAIL,WAAWG,MAAAA,KAAW,OAAOA,OAAO,WAAA,EAAaG,YAAYC,UAAU,YAAY;AACrFF,UAAMF,OAAO,WAAA,EAAaG,WAAWC,MAAM;MAAEC,QAAQ;IAAgB,CAAA;EACvE,WAAW,OAAQL,OAAsCM,iBAAiB,YAAY;AACpFJ,UAAOF,OAAuCM,aAAY;EAC5D,WAAWT,WAAWG,MAAAA,GAAS;AAC7B,UAAM,IAAIO,MACR,wGAAA;EAEJ,OAAO;AACLL,UAAMF;EACR;AACA,QAAM,EAAEQ,SAASC,UAAU,GAAGC,KAAAA,IAASR;AACvC,SAAOQ;AACT;AAhBgBX;AAmBT,SAASY,YAAYX,QAA8B;AACxD,MAAI,CAACH,WAAWG,MAAAA,KAAW,OAAOA,OAAO,WAAA,EAAaY,aAAa,WAAY,QAAOX;AACtF,QAAMW,WAAWZ,OAAO,WAAA,EAAaY;AACrC,SAAO,OAAOC,UAAAA;AACZ,UAAMC,SAAU,MAAMF,SAASC,KAAAA;AAI/B,QAAI,CAACC,OAAOC,OAAQ,QAAO;MAAEC,IAAI;MAAMH,OAAOC,OAAOD;IAAM;AAC3D,UAAMI,UAAUH,OAAOC,OACpBG,IAAI,CAACC,MAAAA;AACJ,YAAMC,QAAQD,EAAEC,QAAQ,CAAA,GAAIF,IAAI,CAACG,MAAO,OAAOA,MAAM,WAAWC,OAAOD,EAAEE,GAAG,IAAID,OAAOD,CAAAA,CAAAA,EAAKG,KAAK,GAAA;AACjG,aAAOJ,OAAO,GAAGA,IAAAA,KAASD,EAAEF,OAAO,KAAKE,EAAEF;IAC5C,CAAA,EACCO,KAAK,IAAA;AACR,WAAO;MAAER,IAAI;MAAOC;IAAQ;EAC9B;AACF;AAjBgBN;AAoBT,SAASc,cAAczB,QAAoB0B,MAA6B;AAC7E,QAAMC,WAAW3B,OAAO4B,YAAY,CAAA,GAAIC,OAAO,CAACC,MAAMJ,KAAKI,CAAAA,MAAO7B,MAAAA;AAClE,SAAO0B,QAAQI,SAAS,iCAAiCJ,QAAQH,KAAK,IAAA,CAAA,KAAUvB;AAClF;AAHgBwB;;;ACvCT,IAAMO,0BAA0B;EAAC;EAAiB;EAAU;EAAa;;AAChF,IAAMC,eAAe,oBAAIC,IAAI;EAAC;EAAQ;EAAO;CAAQ;AACrD,IAAMC,WAAW;AAGV,SAASC,WAAWC,MAAY;AACrC,SAAO;OAAIA,KAAKC,SAASH,QAAAA;IAAWI,IAAI,CAACC,MAAOA,EAAE,CAAA,KAAMA,EAAE,CAAA,CAAE;AAC9D;AAFgBJ;AAShB,SAASK,cAAcC,MAAcC,OAAc;AACjD,QAAMC,MAAMC,OAAOF,KAAAA;AACnB,MAAIC,QAAQ,MAAMA,QAAQ,OAAOA,QAAQ,MAAM;AAC7C,UAAM,IAAIE,MAAM,qCAAqCJ,IAAAA,MAAUK,KAAKC,UAAUJ,GAAAA,CAAAA,EAAM;EACtF;AACA,SAAOK,mBAAmBL,GAAAA;AAC5B;AANSH;AASF,SAASS,gBAAgBb,MAAcc,QAA+B;AAC3E,SAAOd,KACJe,QAAQ,yBAAyB,CAACC,GAAGC,MACpCH,OAAOG,CAAAA,MAAOC,SAAY,KAAK,IAAId,cAAca,GAAGH,OAAOG,CAAAA,CAAE,CAAA,EAAG,EAEjEF,QAAQjB,UAAU,CAACkB,GAAGG,GAAYC,MAAAA;AACjC,UAAMH,IAAKE,KAAKC;AAChB,WAAOhB,cAAca,GAAGH,OAAOG,CAAAA,CAAE;EACnC,CAAA;AACJ;AATgBJ;AAYT,SAASQ,aAAaC,OAA6B;AACxD,QAAMC,SAASD,MACZE,OAAO,CAACC,MAAmB,CAAC,CAACA,KAAKA,MAAM,GAAA,EACxCvB,IAAI,CAACuB,MAAMA,EAAEV,QAAQ,cAAc,EAAA,CAAA,EACnCS,OAAOE,OAAAA,EACPC,KAAK,GAAA;AACR,SAAO,IAAIJ,MAAAA;AACb;AAPgBF;AAUT,SAASO,kBAAkBC,QAAgB7B,MAAY;AAC5D,QAAM8B,WAAW9B,KACd+B,MAAM,GAAA,EACNP,OAAOE,OAAAA,EACPxB,IAAI,CAAC8B,MAAAA;AACJ,UAAM7B,IAAI,gDAAgD8B,KAAKD,CAAAA;AAC/D,WAAO7B,IAAI,MAAMA,EAAE,CAAA,KAAMA,EAAE,CAAA,CAAE,KAAK6B;EACpC,CAAA;AACF,SAAOE,iBAAiB;IAACL,OAAOM,YAAW;OAAOL;IAAUH,KAAK,GAAA,CAAA;AACnE;AATgBC;AAWT,SAASM,iBAAiB7B,MAAY;AAC3C,SAAOA,KACJU,QAAQ,oBAAoB,GAAA,EAC5BA,QAAQ,OAAO,GAAA,EACfA,QAAQ,UAAU,EAAA,EAClBqB,MAAM,GAAG,EAAA;AACd;AANgBF;AAQhB,SAASG,mBAAmBR,QAAc;AACxC,UAAQA,QAAAA;IACN,KAAK;IACL,KAAK;AACH,aAAO;QAAES,cAAc;QAAMC,eAAe;MAAM;IACpD,KAAK;AACH,aAAO;QAAED,cAAc;QAAOE,iBAAiB;QAAMC,gBAAgB;QAAMF,eAAe;MAAM;IAClG,KAAK;AACH,aAAO;QAAED,cAAc;QAAOE,iBAAiB;QAAOC,gBAAgB;QAAMF,eAAe;MAAM;IACnG;AACE,aAAO;QAAED,cAAc;QAAOE,iBAAiB;QAAOD,eAAe;MAAM;EAC/E;AACF;AAZSF;AA2BF,SAASK,iBACdC,OACAC,MAAsB;AAEtB,QAAMf,SAASc,MAAMd,OAAOgB,YAAW;AACvC,QAAMC,SAAS/C,WAAW4C,MAAM3C,IAAI;AACpC,QAAM+C,UAAsB;IAC1BD;IACAE,OAAO,oBAAInD,IAAAA;IACXoD,MAAM,oBAAIpD,IAAAA;IACVqD,WAAW;IACXC,YAAYvD,aAAawD,IAAIvB,MAAAA;EAC/B;AAEA,MAAIe,KAAKS,OAAO;AACd,UAAMC,UAASC,aAAaX,KAAKS,KAAK;AACtC,WAAO;MAAEC,QAAQ;QAAEE,MAAM;QAAU,GAAGF;MAAO;MAAGP;IAAQ;EAC1D;AAEA,QAAMU,aAAyC,CAAC;AAChD,QAAMC,WAAW,oBAAI7D,IAAAA;AAErB,QAAM8D,cAAcJ,aAAaX,KAAKE,MAAM;AAC5C,aAAWrB,KAAKqB,QAAQ;AACtBW,eAAWhC,CAAAA,IAAKkC,aAAaF,aAAahC,CAAAA,KAAM;MAAE+B,MAAM;MAAUI,aAAa,mBAAmBnC,CAAAA;IAAK;AACvG,QAAI,CAACkB,MAAM3C,KAAK6D,SAAS,IAAIpC,CAAAA,GAAI,EAAGiC,UAASI,IAAIrC,CAAAA;EACnD;AAEA,QAAMsC,cAAcR,aAAaX,KAAKI,KAAK;AAC3C,aAAW,CAAC/B,GAAG+C,CAAAA,KAAMC,OAAOC,QAAQH,aAAaN,cAAc,CAAC,CAAA,GAAI;AAClEA,eAAWxC,CAAAA,IAAK+C;AAChBjB,YAAQC,MAAMc,IAAI7C,CAAAA;EACpB;AACA,aAAWA,KAAK8C,aAAaL,YAAY,CAAA,EAAIA,UAASI,IAAI7C,CAAAA;AAE1D,QAAMkD,aAAaZ,aAAaX,KAAKK,IAAI;AACzC,MAAIkB,YAAY;AACd,QAAIA,WAAWV,eAAeU,WAAWX,SAAStC,UAAaiD,WAAWX,SAAS,WAAW;AAC5F,iBAAW,CAACvC,GAAG+C,CAAAA,KAAMC,OAAOC,QAAQC,WAAWV,UAAU,GAAG;AAC1DA,mBAAWxC,CAAAA,IAAK+C;AAChBjB,gBAAQE,KAAKa,IAAI7C,CAAAA;MACnB;AACA,iBAAWA,KAAKkD,WAAWT,YAAY,CAAA,EAAIA,UAASI,IAAI7C,CAAAA;IAC1D,OAAO;AACLwC,iBAAWR,OAAOkB;AAClBT,eAASI,IAAI,MAAA;AACbf,cAAQG,YAAY;IACtB;EACF;AAEA,QAAMI,SAAqB;IAAEE,MAAM;IAAUC;EAAW;AACxD,MAAIC,SAASU,KAAMd,QAAOI,WAAW;OAAIA;;AACzC,SAAO;IAAEJ;IAAQP;EAAQ;AAC3B;AArDgBL;AAuDhB,SAAS2B,UAAUC,MAA+BvB,SAAmB;AACnE,QAAMwB,aAAsC,CAAC;AAC7C,QAAMvB,QAA2C,CAAC;AAClD,MAAIC;AAEJ,aAAW,CAAChC,GAAG+C,CAAAA,KAAMC,OAAOC,QAAQI,IAAAA,GAAO;AACzC,QAAIN,MAAM9C,OAAW;AACrB,QAAI6B,QAAQD,OAAOe,SAAS5C,CAAAA,GAAI;AAC9BsD,iBAAWtD,CAAAA,IAAK+C;IAClB,WAAWjB,QAAQG,aAAajC,MAAM,QAAQ;AAC5CgC,aAAOe;IACT,WAAWjB,QAAQC,MAAMI,IAAInC,CAAAA,KAAO,CAAC8B,QAAQE,KAAKG,IAAInC,CAAAA,KAAM,CAAC8B,QAAQI,YAAa;AAChFH,YAAM/B,CAAAA,IAAKuD,MAAMC,QAAQT,CAAAA,IAAKA,EAAE9D,IAAIM,MAAAA,IAAU,OAAOwD,MAAM,YAAYA,MAAM,OAAOtD,KAAKC,UAAUqD,CAAAA,IAAKxD,OAAOwD,CAAAA;IACjH,OAAO;AACLf,aAAO;QAAE,GAAKA,QAAoC,CAAC;QAAI,CAAChC,CAAAA,GAAI+C;MAAE;IAChE;EACF;AACA,MAAIf,SAAS/B,UAAa6B,QAAQI,WAAYF,QAAO,CAAC;AACtD,SAAO;IAAEsB;IAAYvB;IAAOC;EAAK;AACnC;AAnBSoB;AAqBF,SAASK,iBAAiBC,KAAoBC,UAAgB;AACnE,MAAIC,OAAOF,IAAI1B;AACf,MAAI4B,KAAKC,SAASF,SAAUC,QAAO,GAAGA,KAAKzC,MAAM,GAAGwC,QAAAA,CAAAA;mBAA0BC,KAAKC,SAASF,QAAAA;AAC5F,QAAMG,UAAUJ,IAAIK,UAAU;AAC9B,QAAMC,SAAqB;IACzBC,SAAS;MAAC;QAAE1B,MAAM;QAAQqB,MAAME,UAAU,QAAQJ,IAAIK,MAAM;EAAKH,IAAAA,KAASA,QAAQ,QAAQF,IAAIK,MAAM;MAAG;;EACzG;AACA,MAAID,SAAS;AACXE,WAAOF,UAAU;AACjB,WAAOE;EACT;AACA,OAAKN,IAAIQ,QAAQ,cAAA,KAAmB,IAAItB,SAAS,MAAA,KAAWgB,SAASF,IAAI1B,MAAM;AAC7E,QAAI;AACF,YAAMmC,SAAS1E,KAAK2E,MAAMV,IAAI1B,IAAI;AAClC,UAAImC,UAAU,OAAOA,WAAW,YAAY,CAACZ,MAAMC,QAAQW,MAAAA,EAASH,QAAOK,oBAAoBF;IACjG,QAAQ;IAER;EACF;AACA,SAAOH;AACT;AApBgBP;AAsBT,SAASa,mBAAmBC,KAAkBC,OAAe;AAClE,QAAMC,MAA8B,CAAC;AACrC,aAAWrF,QAAQoF,OAAO;AACxB,UAAMzB,IAAIwB,IAAIL,QAAQ9E,KAAK8B,YAAW,CAAA;AACtC,QAAI6B,MAAM9C,OAAWwE,KAAIrF,KAAK8B,YAAW,CAAA,IAAM6B;EACjD;AACA,SAAO0B;AACT;AAPgBH;AAaT,SAASI,gBACdhD,OACAC,MACAgD,UACAC,aAA4E,CAAC,GAAC;AAE9E,QAAMhE,SAASc,MAAMd,OAAOgB,YAAW;AACvC,QAAMxC,OAAO6B,iBAAiBU,KAAKvC,QAAQuB,kBAAkBC,QAAQc,MAAM3C,IAAI,CAAA;AAC/E,QAAM,EAAEsD,QAAQP,QAAO,IAAKL,iBAAiBC,OAAOC,IAAAA;AACpD,QAAMkD,UAAUD,WAAWE,kBAAkBpG;AAC7C,QAAMiF,WAAWiB,WAAWG,oBAAoB;AAEhD,SAAO;IACL3F;IACA4F,OAAOrD,KAAKqD;IACZrC,aAAahB,KAAKgB,eAAe,GAAG/B,MAAAA,IAAUc,MAAM3C,IAAI;IACxDkG,aAAa5C;IACb6C,aAAa;MAAE,GAAG9D,mBAAmBR,MAAAA;MAAS,GAAGe,KAAKuD;IAAY;IAClEC,UAAUC,YAAYzD,KAAKS,KAAK;IAChC,MAAMiD,QAAQhC,MAAMkB,KAAG;AACrB,YAAMe,UAAU3D,KAAKS,QAAQnC,SAAYsF,cAAclD,QAAQgB,IAAAA;AAC/D,UAAIiC,QAAS,QAAO;QAAExB,SAAS;QAAMG,SAAS;UAAC;YAAE1B,MAAM;YAAQqB,MAAM0B;UAAQ;;MAAG;AAEhF,YAAM,EAAEhC,YAAYvB,OAAOC,KAAI,IAAKoB,UAAUC,MAAMvB,OAAAA;AACpD,YAAMoC,UAAkC;QACtCsB,QAAQ;QACR,GAAGlB,mBAAmBC,KAAKM,OAAAA;QAC3B,GAAGlD,KAAKuC;QACR,cAAc9E;MAChB;AACA,UAAImF,IAAIkB,SAAUvB,SAAQ,iBAAA,IAAqBK,IAAIkB;AACnD,UAAIzD,SAAS/B,OAAWiE,SAAQ,cAAA,IAAkB;AAElD,UAAInF;AACJ,UAAI;AACFA,eAAOa,gBAAgB8B,MAAM3C,MAAMuE,UAAAA;MACrC,SAASoC,KAAK;AACZ,eAAO;UAAE5B,SAAS;UAAMG,SAAS;YAAC;cAAE1B,MAAM;cAAQqB,MAAO8B,IAAcC;YAAQ;;QAAG;MACpF;AACA,YAAMjC,MAAM,MAAMiB,SAAS;QAAE/D;QAAQ7B;QAAMgD;QAAOC;QAAMkC;MAAQ,GAAGK,GAAAA;AACnE,aAAOd,iBAAiBC,KAAKC,QAAAA;IAC/B;EACF;AACF;AA3CgBe;;;ACtNT,IAAMkB,8BAA8B;EAAC;EAAc;EAAc;EAAc;;AAC/E,IAAMC,0BAA0BD,4BAA4B,CAAA;AAgBnE,IAAME,cAAc;AACpB,IAAMC,kBAAkB;AACxB,IAAMC,mBAAmB;AACzB,IAAMC,iBAAiB;AAEvB,IAAMC,KAAK,wBAACC,IAAeC,YAAsC;EAAEC,SAAS;EAAOF;EAAIC;AAAO,IAAnF;AACX,IAAME,OAAO,wBAACH,IAAeI,MAAcC,aAAsC;EAC/EH,SAAS;EACTF;EACAM,OAAO;IAAEF;IAAMC;EAAQ;AACzB,IAJa;AAuBN,IAAME,YAAN,MAAMA;EA9Cb,OA8CaA;;;;EACMC,QAAQ,oBAAIC,IAAAA;EACrBC,UAA0C,CAAA;EAElD,YAAqBC,SAA2B;SAA3BA,UAAAA;EAA4B;;EAGjDC,QAAQC,MAA+B;AACrC,QAAI,KAAKL,MAAMM,IAAID,KAAKE,IAAI,GAAG;AAC7B,YAAM,IAAIC,MAAM,oCAAoCH,KAAKE,IAAI,8BAA8B;IAC7F;AACA,SAAKP,MAAMS,IAAIJ,KAAKE,MAAMF,IAAAA;AAC1B,WAAO;EACT;;EAGAK,OAAOC,QAA0C;AAC/C,SAAKT,QAAQU,KAAKD,MAAAA;AAClB,WAAO;EACT;EAEA,MAAME,YAA0C;AAC9C,UAAM,KAAKC,KAAI;AACf,WAAO;SAAI,KAAKd,MAAMe,OAAM;;EAC9B;EAEA,MAAcD,OAAO;AACnB,QAAI,CAAC,KAAKZ,QAAQc,OAAQ;AAC1B,UAAMd,UAAU,KAAKA;AACrB,SAAKA,UAAU,CAAA;AACf,eAAWe,KAAKf,QAAS,OAAMe,EAAAA;EACjC;;EAGA,MAAMC,cAAcrB,SAAkBsB,KAAuE;AAC3G,QAAIC,MAAMC,QAAQxB,OAAAA,GAAU;AAC1B,YAAMyB,WAAW,MAAMC,QAAQC,IAAI3B,QAAQ4B,IAAI,CAACC,MAAM,KAAKC,UAAUD,GAAGP,GAAAA,CAAAA,CAAAA,GAAQS,OAC9E,CAACC,MAA4BA,MAAM,IAAA;AAErC,aAAOP,QAAQN,SAASM,UAAU;IACpC;AACA,WAAO,KAAKK,UAAU9B,SAASsB,GAAAA;EACjC;EAEA,MAAcQ,UAAU9B,SAAkBsB,KAAmD;AAC3F,UAAMW,MAAMjC;AACZ,QAAI,CAACiC,OAAO,OAAOA,QAAQ,YAAYA,IAAIpC,YAAY,OAAO;AAC5D,aAAOC,KAAK,MAAMP,iBAAiB,0BAAA;IACrC;AAEA,QAAI,OAAO0C,IAAIC,WAAW,YAAYD,IAAItC,OAAOwC,OAAW,QAAO;AACnE,UAAMxC,KAAKsC,IAAItC;AACf,UAAMyC,SAASH,IAAIG,UAAU,CAAC;AAE9B,UAAM,KAAKnB,KAAI;AACf,YAAQgB,IAAIC,QAAM;MAChB,KAAK,cAAc;AACjB,cAAMG,YAAYD,OAAOE;AACzB,cAAMA,kBACJD,aAAajD,4BAA4BmD,SAASF,SAAAA,IAAaA,YAAYhD;AAC7E,eAAOK,GAAGC,IAAI;UACZ2C;UACAE,cAAc;YAAErC,OAAO;cAAEsC,aAAa;YAAM;UAAE;UAC9CC,YAAY;YAAEhC,MAAM,KAAKJ,QAAQI;YAAMiC,SAAS,KAAKrC,QAAQqC,WAAW;UAAQ;UAChF,GAAI,KAAKrC,QAAQsC,eAAe;YAAEA,cAAc,KAAKtC,QAAQsC;UAAa,IAAI,CAAC;QACjF,CAAA;MACF;MACA,KAAK;AACH,eAAOlD,GAAGC,IAAI,CAAC,CAAA;MACjB,KAAK;AACH,eAAOD,GAAGC,IAAI;UACZQ,OAAO;eAAI,KAAKA,MAAMe,OAAM;YAAIU,IAAI,CAACiB,OAAO;YAC1CnC,MAAMmC,EAAEnC;YACR,GAAImC,EAAEC,QAAQ;cAAEA,OAAOD,EAAEC;YAAM,IAAI,CAAC;YACpCC,aAAaF,EAAEE;YACfC,aAAaH,EAAEG;YACf,GAAIH,EAAEI,cAAc;cAAEA,aAAaJ,EAAEI;YAAY,IAAI,CAAC;UACxD,EAAA;QACF,CAAA;MACF,KAAK,cAAc;AACjB,cAAMzC,OAAO,KAAKL,MAAM+C,IAAId,OAAO1B,IAAI;AACvC,YAAI,CAACF,KAAM,QAAOV,KAAKH,IAAIF,gBAAgB,iBAAiB0D,OAAOf,OAAO1B,IAAI,CAAA,EAAG;AACjF,eAAOhB,GAAGC,IAAI,MAAM,KAAKyD,SAAS5C,MAAO4B,OAAOiB,aAAa,CAAC,GAA+B/B,GAAAA,CAAAA;MAC/F;MACA,KAAK;AACH,eAAO5B,GAAGC,IAAI;UAAE2D,WAAW,CAAA;QAAG,CAAA;MAChC,KAAK;AACH,eAAO5D,GAAGC,IAAI;UAAE4D,SAAS,CAAA;QAAG,CAAA;MAC9B;AACE,eAAOzD,KAAKH,IAAIH,kBAAkB,qBAAqByC,IAAIC,MAAM,EAAE;IACvE;EACF;EAEA,MAAckB,SACZ5C,MACAgD,MACAlC,KACqB;AACrB,QAAI;AACF,UAAId,KAAKiD,UAAU;AACjB,cAAMC,IAAI,MAAMlD,KAAKiD,SAASD,IAAAA;AAC9B,YAAI,CAACE,EAAEhE,GAAI,QAAO;UAAEiE,SAAS;UAAMC,SAAS;YAAC;cAAEC,MAAM;cAAQC,MAAM,sBAAsBJ,EAAE1D,OAAO;YAAG;;QAAG;AACxGwD,eAAOE,EAAEK;MACX;AACA,aAAO,MAAMvD,KAAKwD,QAAQR,MAAMlC,GAAAA;IAClC,SAAS2C,KAAK;AAEZ,aAAO;QAAEN,SAAS;QAAMC,SAAS;UAAC;YAAEC,MAAM;YAAQC,MAAM,eAAgBG,IAAcjE,OAAO;UAAG;;MAAG;IACrG;EACF;;EAGAkE,gBAAgBC,QAAqC;AACnD,QAAI,CAACA,OAAQ,QAAO;AACpB,UAAMC,UAAU,KAAK9D,QAAQ+D;AAC7B,QAAID,YAAY,IAAK,QAAO;AAC5B,YAAQA,WAAW,CAAA,GAAI7B,SAAS4B,MAAAA;EAClC;;;;;EAMA,MAAMG,WAAWC,KAAqBjD,KAA4C;AAChF,UAAMkD,OAAO;MAAE,gBAAgB;IAAmB;AAClD,QAAI,CAAC,KAAKN,gBAAgBK,IAAIE,QAAQN,MAAM,GAAG;AAC7C,aAAO;QAAEO,QAAQ;QAAKD,SAASD;QAAMG,MAAMC,KAAKC,UAAU/E,KAAK,MAAMP,iBAAiB,oBAAA,CAAA;MAAuB;IAC/G;AACA,QAAIgF,IAAIrC,OAAO4C,YAAW,MAAO,QAAQ;AAEvC,aAAO;QAAEJ,QAAQ;QAAKD,SAAS;UAAEM,OAAO;QAAO;MAAE;IACnD;AACA,QAAIJ,OAAOJ,IAAII;AACf,QAAI,OAAOA,SAAS,YAAYA,gBAAgBK,YAAY;AAC1D,UAAI;AACFL,eAAOC,KAAKK,MAAM,OAAON,SAAS,WAAWA,OAAO,IAAIO,YAAAA,EAAcC,OAAOR,IAAAA,CAAAA;MAC/E,QAAQ;AACN,eAAO;UAAED,QAAQ;UAAKD,SAASD;UAAMG,MAAMC,KAAKC,UAAU/E,KAAK,MAAMR,aAAa,aAAA,CAAA;QAAgB;MACpG;IACF;AACA,UAAM8F,WAAW,MAAM,KAAK/D,cAAcsD,MAAMrD,GAAAA;AAChD,QAAI8D,aAAa,KAAM,QAAO;MAAEV,QAAQ;MAAKD,SAAS,CAAC;IAAE;AACzD,WAAO;MAAEC,QAAQ;MAAKD,SAASD;MAAMG,MAAMC,KAAKC,UAAUO,QAAAA;IAAU;EACtE;AACF;;;AC3KA,IAAMC,aAAa,oBAAIC,IAAyB;EAC9C;IAACC;IAAQ;MAAEC,MAAM;IAAS;;EAC1B;IAACC;IAAQ;MAAED,MAAM;IAAS;;EAC1B;IAACE;IAAS;MAAEF,MAAM;IAAU;;EAC5B;IAACG;IAAM;MAAEH,MAAM;MAAUI,QAAQ;IAAY;;EAC7C;IAACC;IAAO;MAAEL,MAAM;IAAQ;;EACxB;IAACM;IAAQ;MAAEN,MAAM;IAAS;;CAC3B;AAEM,SAASO,gBAAgBP,MAAa;AAC3C,QAAMQ,IAAIX,WAAWY,IAAIT,IAAAA;AACzB,SAAOQ,IAAI;IAAE,GAAGA;EAAE,IAAIE;AACxB;AAHgBH;AAMhB,SAASI,UAAUH,GAAeI,MAAcC,IAAe,CAAA,GAAE;AAC/D,UAAQD,MAAAA;IACN,KAAK;AACHJ,QAAER,OAAO;AACT;IACF,KAAK;IACL,KAAK;AACHQ,QAAER,OAAOY,SAAS,aAAa,WAAW;AAC1C;IACF,KAAK;AACHJ,QAAER,OAAO;AACT;IACF,KAAK;AACHQ,QAAER,OAAO;AACT;IACF,KAAK;IACL,KAAK;IACL,KAAK;AACHQ,QAAER,OAAO;AACTQ,QAAEJ,SAAS;AACX;IACF,KAAK;AACHI,QAAER,OAAO;AACTQ,QAAEJ,SAAS;AACX;IACF,KAAK;AACHI,QAAER,OAAO;AACTQ,QAAEJ,SAAS;AACX;IACF,KAAK;AACHI,QAAER,OAAO;AACTQ,QAAEJ,SAAS;AACX;IACF,KAAK;AACHI,QAAEM,mBAAmB;AACrB;IACF,KAAK;AACHN,QAAEO,mBAAmB;AACrB;IACF,KAAK;AACHP,QAAEQ,UAAUH,EAAE,CAAA;AACd;IACF,KAAK;AACHL,QAAES,UAAUJ,EAAE,CAAA;AACd;IACF,KAAK;AACHL,QAAEU,YAAYL,EAAE,CAAA;AAChB;IACF,KAAK;AACHL,QAAEW,YAAYN,EAAE,CAAA;AAChB;IACF,KAAK;AACHL,QAAEU,YAAYL,EAAE,CAAA;AAChB,UAAIA,EAAE,CAAA,MAAOH,OAAWF,GAAEW,YAAYN,EAAE,CAAA;AACxC;IACF,KAAK;AACH,UAAIA,EAAE,CAAA,aAAcO,OAAQZ,GAAEa,UAAUR,EAAE,CAAA,EAAGS;AAC7C;IACF,KAAK;AACHd,QAAEe,OAAOV,EAAE,CAAA;AACX;IACF,KAAK;AACHL,QAAEe,OAAQV,EAAE,CAAA,KAAoBP,OAAOkB,OAAOX,EAAE,CAAA,CAAE;AAClD;IACF,KAAK;AACH,UAAIL,EAAER,SAAS,SAAUQ,GAAEU,YAAYO,KAAKC,IAAI,GAAGzB,OAAOO,EAAEU,aAAa,CAAA,CAAA;AACzE;IACF,KAAK;AACHV,QAAER,OAAO;AACT;IACF,KAAK;AACHQ,QAAEmB,WAAWd,EAAE,CAAA;AACf;IACF,KAAK;AACHL,QAAEoB,WAAWf,EAAE,CAAA;AACf;IACF,KAAK;AACHL,QAAER,OAAO;AACT;EACJ;AACF;AAhFSW;AAsFF,SAASkB,gBAAgBC,KAAeC,SAA4CC,QAAQ,GAAC;AAClG,QAAMC,SAAqB;IAAEjC,MAAM;IAAUkC,YAAY,CAAC;EAAE;AAC5D,MAAI,CAACH,WAAWC,QAAQ,EAAG,QAAOC;AAClC,QAAME,QAAQJ,QAAQK,6BAA6BN,KAAK,IAAI,MAAM,KAAA;AAClE,QAAMI,aAAyC,CAAC;AAChD,QAAMG,WAAW,oBAAIC,IAAAA;AAErB,aAAWC,KAAKJ,OAAO;AACrB,UAAMK,OAAQN,WAAWK,EAAEE,YAAY,MAAMC,QAAQZ,KAAKS,EAAEE,YAAY;AACxE,QAAIF,EAAEvC,SAAS,2BAA2BuC,EAAE3B,SAAS,cAAc;AACjEyB,eAASM,IAAIJ,EAAEE,YAAY;IAC7B,WAAWF,EAAEvC,SAAS,oBAAoB;AACxC,YAAM4C,aAAaC,QAAQC,cAAc,eAAehB,IAAIiB,WAAWR,EAAEE,YAAY;AACrF,UAAI,OAAOG,eAAe,cAAc,CAAC/C,WAAWmD,IAAIJ,UAAAA,GAAa;AACnEtC,eAAO2C,OAAOT,MAAMX,gBAAgBe,YAAYb,SAASC,QAAQ,CAAA,CAAA;MACnE;IACF,WAAWO,EAAEvC,SAAS,sBAAsBuC,EAAE3B,MAAM;AAClD,UAAI2B,EAAEW,MAAM;AACVV,aAAKxC,OAAO;AACZ,cAAMmD,QAASX,KAAKW,UAAU,CAAC;AAC/BxC,kBAAUwC,OAAOZ,EAAE3B,MAAM2B,EAAEa,WAAW;MACxC,OAAO;AACLzC,kBAAU6B,MAAMD,EAAE3B,MAAM2B,EAAEa,WAAW;MACvC;IACF;EACF;AAEAnB,SAAOC,aAAaA;AACpB,QAAMmB,WAAW/C,OAAOgD,KAAKpB,UAAAA,EAAYqB,OAAO,CAACC,MAAM,CAACnB,SAASW,IAAIQ,CAAAA,CAAAA;AACrE,MAAIH,SAASI,OAAQxB,QAAOoB,WAAWA;AACvC,SAAOpB;AACT;AA/BgBJ;AAiChB,SAASa,QAAQZ,KAAeU,MAAY;AAC1C,QAAMkB,aAAab,QAAQC,cAAc,eAAehB,IAAIiB,WAAWP,IAAAA;AACvE,QAAMhC,IAAgBD,gBAAgBmD,UAAAA,KAAe,CAAC;AAEtD,QAAMC,MAAMd,QAAQC,cAAc,8BAA8BhB,IAAIiB,WAAWP,IAAAA;AAE/E,MAAImB,KAAKC,YAAapD,GAAEoD,cAAcD,IAAIC;AAC1C,MAAID,KAAKE,YAAYnD,OAAWF,GAAEsD,WAAW;IAACH,IAAIE;;AAClD,MAAIxD,MAAM0D,QAAQJ,KAAKpC,IAAAA,EAAOf,GAAEe,OAAOoC,IAAIpC;AAC3C,SAAOf;AACT;AAVSkC;;;ANhIT,IAAMsB,gBAAgB;AACtB,IAAMC,kBAAkB;AACxB,IAAMC,sBAAsB;AAC5B,IAAMC,mBAAmB;AACzB,IAAMC,kBAAkB;EAAC;EAAO;EAAQ;EAAO;EAAU;EAAS;EAAO;EAAW;;AACpF,IAAMC,iBAAiB;AACvB,IAAMC,kBAAkB;AACxB,IAAMC,kBAAkB;AAEjB,IAAMC,oBAAoB;AAC1B,IAAMC,qBAAqBC,uBAAO,oBAAA;AAiBlC,SAASC,QAAQC,UAA4B,CAAC,GAAC;AACpD,SAAOC,YAAYL,mBAAmBI,OAAAA;AACxC;AAFgBD;AAgDT,IAAMG,aAAN,MAAMA;EAtGb,OAsGaA;;;;;;EACFC;EAET,YACmBC,WACAC,WACAL,SACjB;SAHiBI,YAAAA;SACAC,YAAAA;SACAL,UAAAA;AAEjB,SAAKG,SAAS,IAAIG,UAAUN,OAAAA;AAC5B,eAAWO,KAAKP,QAAQQ,SAAS,CAAA,EAAI,MAAKL,OAAOM,QAAQF,CAAAA;AACzD,UAAMG,WAAWC,sBAAsB;MACrCC,SAASZ,QAAQY,YAAY,CAACC,QAAQC,gBAAgBD,IAAIE,GAAG;IAC/D,CAAA;AACA,SAAKZ,OAAOa,OAAO,YAAA;AACjB,YAAMC,UAAUjB,QAAQkB,yBAA0B,MAAMC,mBAAAA;AACxD,iBAAWZ,KAAK,KAAKa,SAASH,OAAAA,GAAU;AACtC,aAAKd,OAAOM,QAAQY,gBAAgBd,EAAEe,OAAOf,EAAEP,SAASU,UAAUV,OAAAA,CAAAA;MACpE;IACF,CAAA;EACF;EAEQuB,eAAuB;AAC7B,WAAO,KAAKlB,UAAUmB,kBAAe,KAAQ;EAC/C;EAEQC,eAAeC,YAAsBC,SAAuC;AAClF,UAAMC,aACJ,KAAKvB,UAGLwB,gBAAa;AACf,QAAI,CAACD,cAAcA,WAAWE,SAAS,EAA4B,QAAOC;AAC1E,QAAIC,UACFC,QAAQC,YAAY3C,kBAAkBoC,OAAAA,KACtCM,QAAQC,YAAY3C,kBAAkBmC,UAAAA,KACtCE,WAAWO;AACb,QAAIC,MAAMC,QAAQL,OAAAA,EAAUA,WAAUA,QAAQ,CAAA;AAC9C,QAAIA,YAAYD,UAAa,OAAOC,YAAY,SAAU,QAAOD;AACjE,UAAMO,SAASV,WAAWU,WAAW,QAAQ,KAAMV,WAAWU,UAAU;AACxE,WAAO,GAAGA,MAAAA,GAASC,OAAOP,OAAAA,CAAAA;EAC5B;EAEQZ,SAASH,SAA4C;AAC3D,UAAMuB,QAAkF,CAAA;AACxF,eAAWC,WAAW,KAAKrC,UAAUsC,eAAc,GAA2B;AAC5E,YAAMhB,aAAae,QAAQE;AAC3B,UAAI,CAACjB,YAAYkB,UAAW;AAC5B,YAAMC,QAAQnB,WAAWkB;AACzB,YAAME,YAAYC,QAAQd,QAAQC,YAAY9C,eAAesC,UAAAA,KAAe,GAAA;AAC5E,YAAMsB,WAAWtB,WAAWuB,KAAKC,QAAQ,eAAe,EAAA;AAExD,iBAAWC,OAAOC,OAAOC,oBAAoBR,KAAAA,GAAQ;AACnD,YAAIM,QAAQ,cAAe;AAC3B,cAAMxB,UAAUyB,OAAOE,yBAAyBT,OAAOM,GAAAA,GAAMI;AAC7D,YAAI,OAAO5B,YAAY,WAAY;AACnC,cAAM6B,OAAqCvB,QAAQC,YAAYtC,mBAAmB+B,OAAAA;AAClF,YAAI,CAAC6B,KAAM;AACX,cAAMC,SAASjE,gBAAgByC,QAAQC,YAAY7C,iBAAiBsC,OAAAA,CAAAA,KAAuB;AAC3F,cAAM+B,aAAaX,QAAQd,QAAQC,YAAY9C,eAAeuC,OAAAA,KAAY,GAAA,EAAK,CAAA;AAC/E,cAAMgC,OAAOC,UACX,KAAKrC,aAAY,GACjB,KAAKE,eAAeC,YAAYC,OAAAA,GAChC,KAAK3B,QAAQ6D,YACbf,UAAU,CAAA,GACVY,UAAAA;AAEFlB,cAAMsB,KAAK;UACTxC,OAAO;YAAEmC,QAAQA,WAAW,QAAQ,SAASA;YAAQE;UAAK;UAC1D3D,SAAS;YACPiD,MAAMc,iBAAiB,GAAGC,QAAQhB,QAAAA,CAAAA,IAAagB,QAAQb,GAAAA,CAAAA,EAAM;YAC7D,GAAGc,aAAavC,YAAYyB,KAAKlC,OAAAA;YACjC,GAAGuC;UACL;QACF,CAAA;MACF;IACF;AACA,WAAOhB;EACT;AACF;AAGA,SAASyB,aAAavC,YAAsByB,KAAalC,SAA0C;AACjG,QAAMiD,OACJjC,QAAQC,YAAY5C,qBAAqBoC,YAAYyB,GAAAA,KAAQ,CAAC;AAChE,QAAMgB,QAAmBlC,QAAQC,YAAY,qBAAqBR,WAAWkB,WAAWO,GAAAA,KAAQ,CAAA;AAChG,QAAMiB,SAAqB;IAAEtC,MAAM;IAAUuC,YAAY,CAAC;EAAE;AAC5D,QAAMC,QAAoB;IAAExC,MAAM;IAAUuC,YAAY,CAAC;IAAGE,UAAU,CAAA;EAAG;AACzE,MAAIC;AAEJ,QAAMC,YAAY,wBAAClE,MACjBmE,gBAAgBnE,CAAAA,MAAO,OAAOA,MAAM,aAAaoE,gBAAgBpE,GAAGU,OAAAA,IAAW,CAAC,IADhE;AAGlB,aAAW,CAAC2D,GAAGC,GAAAA,KAAQzB,OAAO0B,QAAQZ,IAAAA,GAAO;AAC3C,UAAMa,YAAYC,OAAOJ,EAAEK,MAAM,GAAA,EAAK,CAAA,CAAE;AACxC,UAAM1E,IAAI4D,MAAMU,IAAIK,KAAK;AACzB,UAAMC,QAAQ,OAAON,IAAIO,SAAS,WAAWP,IAAIO,OAAOrD;AACxD,QAAIgD,cAAcpF,mBAAmBwF,OAAO;AAC1Cf,aAAOC,WAAYc,KAAAA,IAAST,gBAAgBnE,CAAAA,KAAM;QAAEuB,MAAM;MAAS;IACrE,WAAWiD,cAAcrF,iBAAiB;AACxC,UAAIyF,MAAOb,OAAMD,WAAYc,KAAAA,IAAST,gBAAgBnE,CAAAA,KAAM;QAAEuB,MAAM;MAAS;UACxEsB,QAAOiC,OAAOf,OAAOgB,YAAYhB,OAAOG,UAAUlE,CAAAA,CAAAA,CAAAA;IACzD,WAAWwE,cAActF,gBAAgB;AACvC,UAAI0F,OAAO;AACTX,iBAAS;UAAE1C,MAAM;UAAUuC,YAAY,CAAC;UAAGE,UAAU,CAAA;QAAG;AACxDC,aAAKH,WAAYc,KAAAA,IAASV,UAAUlE,CAAAA;AACnCiE,aAAKD,SAAsBT,KAAKqB,KAAAA;MACnC,OAAO;AACLX,eAAOc,YAAYd,MAAMC,UAAUlE,CAAAA,CAAAA;MACrC;IACF;EACF;AACA,QAAMgF,MAAwB;IAAEnB;EAAO;AACvC,MAAIhB,OAAOoC,KAAKlB,MAAMD,UAAU,EAAGoB,OAAQF,KAAIjB,QAAQA;AACvD,MAAIE,KAAMe,KAAIf,OAAOA;AACrB,SAAOe;AACT;AAlCStB;AAoCT,SAASqB,YAAYI,GAA2BC,GAAa;AAC3D,MAAI,CAACD,EAAG,QAAOC;AACf,SAAO;IACL7D,MAAM;IACNuC,YAAY;MAAE,GAAGqB,EAAErB;MAAY,GAAGsB,EAAEtB;IAAW;IAC/CE,UAAU;SAAKmB,EAAEnB,YAAY,CAAA;SAASoB,EAAEpB,YAAY,CAAA;;EACtD;AACF;AAPSe;AAST,eAAenE,qBAAAA;AACb,MAAI;AACF,UAAMyE,KAAM,MAAM,OAAO,iBAAA;AACzB,WAAOA,GAAGC,qBAAkB;EAC9B,QAAQ;AACN,WAAO9D;EACT;AACF;AAPeZ;AASf,SAAS4B,QAAW+C,GAAU;AAC5B,SAAO1D,MAAMC,QAAQyD,CAAAA,IAAKA,IAAI;IAACA;;AACjC;AAFS/C;AAIT,SAASiB,QAAQ+B,GAAS;AACxB,SAAOA,EACJ7C,QAAQ,sBAAsB,OAAA,EAC9BA,QAAQ,WAAW,GAAA,EACnB8C,YAAW;AAChB;AALShC;AASTiC,WAAAA,EAAa/F,UAAAA;AACbgG,OAAOC,gBAAAA,EAAkBjG,YAAY6B,QAAoB,CAAA;AACzDmE,OAAOE,iBAAAA,EAAmBlG,YAAY6B,QAAoB,CAAA;AAC1DmE,OAAOrG,kBAAAA,EAAoBK,YAAY6B,QAAoB,CAAA;AAqB3D,SAASsE,oBAAoBrG,SAAkD;AAC7E,MAAMsG,gBAAN,MAAMA,cAAAA;IAnRR,OAmRQA;;;;IACJ,YAAqBC,KAAiB;WAAjBA,MAAAA;IAAkB;IAEvC,MAAMC,OAAOC,KAAaC,KAAa;AACrC,YAAMC,UAAWF,IAAI1F,OAAO0F;AAC5B,YAAMG,UAAUC,iBAAiBJ,IAAIG,OAAO;AAC5C,YAAM/F,MAAmB;QAAE+F;QAASE,UAAUL,IAAIM;QAAIhG,KAAK4F;MAAQ;AACnE,YAAMpB,MAAM,MAAM,KAAKgB,IAAIpG,OAAO6G,WAAW;QAAEvD,QAAQgD,IAAIhD;QAAQmD;QAASpC,MAAMiC,IAAIjC;MAAK,GAAG3D,GAAAA;AAC9F,UAAI,OAAO6F,IAAIO,SAAS,YAAY;AAClCP,YAAIO,KAAK1B,IAAI2B,MAAM,EAAEN,QAASrB,IAAIqB,OAAO,EAAEO,KAAK5B,IAAIf,IAAI;MAC1D,OAAO;AACLkC,YAAIQ,OAAQ3B,IAAI2B,MAAM,EAAEE,IAAK7B,IAAIqB,OAAO;AACxC,YAAIrB,IAAIf,SAASzC,OAAW2E,KAAIW,IAAG;YAC9BX,KAAIS,KAAK5B,IAAIf,IAAI;MACxB;IACF;EACF;AACA,QAAM3B,QAAQyD,cAAc1D;AAC5B,QAAM0E,aAAalE,OAAOE,yBAAyBT,OAAO,QAAA;AAE1D0E,aAAW;IAAE5D,MAAM3D,QAAQ2D,QAAQ;IAAO3B,SAASwF;EAAgB,CAAA,EAAGlB,aAAAA;AACtEJ,SAAOhG,UAAAA,EAAYoG,eAAevE,QAAoB,CAAA;AACtD0F,MAAAA,EAAM5E,OAAO,UAAUyE,UAAAA;AACvBI,MAAAA,EAAM7E,OAAO,UAAU,CAAA;AACvB8E,MAAAA,EAAM9E,OAAO,UAAU,CAAA;AACvB,MAAI7C,QAAQ4H,QAAQnC,OAAQoC,WAAAA,GAAa7H,QAAQ4H,MAAM,EAAEtB,aAAAA;AACzD,SAAOA;AACT;AA5BSD;AAsCF,IAAMyB,YAAN,MAAMA,WAAAA;EAxTb,OAwTaA;;;EACX,OAAOC,QAAQ/H,SAA0C;AACvD,WAAO;MACLgI,QAAQF;MACRG,QAAQ;MACRC,SAAS;QAACC;;MACVC,aAAa;QAAC/B,oBAAoBrG,OAAAA;;MAClCqI,WAAW;QAAC;UAAEC,SAASzI;UAAoB0I,UAAUvI;QAAQ;QAAGE;;MAChEsI,SAAS;QAACtI;;IACZ;EACF;;;;;;;;;;;;EAaA,OAAOuI,aAAazI,SAA+C;AACjE,WAAO;MACLgI,QAAQF;MACRG,QAAQ;MACRC,SAAS;QAACC;WAAqBnI,QAAQkI,WAAW,CAAA;;MAClDE,aAAa;QAAC/B,oBAAoBrG,OAAAA;;MAClCqI,WAAW;QACT;UACEC,SAASzI;UACT6I,QAAQ1I,QAAQ0I,UAAU,CAAA;UAC1BC,YAAY,iCAAUzE,UAAqB;YACzC,GAAI,MAAMlE,QAAQ2I,WAAU,GAAIzE,IAAAA;YAChC,GAAIlE,QAAQ2D,OAAO;cAAEA,MAAM3D,QAAQ2D;YAAK,IAAI,CAAC;UAC/C,IAHY;QAId;QACAzD;;MAEFsI,SAAS;QAACtI;;IACZ;EACF;AACF;AACA0I,OAAO,CAAC,CAAA,EAAGd,SAAAA;","names":["All","Controller","Inject","Injectable","Module","Req","Res","SetMetadata","UseGuards","VERSION_NEUTRAL","ApplicationConfig","DiscoveryModule","DiscoveryService","buildUrl","base","req","url","URL","replace","path","k","v","Object","entries","query","item","Array","isArray","searchParams","append","toString","createFetchDispatcher","opts","doFetch","fetch","ctx","baseUrl","res","method","headers","body","undefined","JSON","stringify","signal","AbortSignal","timeout","timeoutMs","forEach","status","text","normalizeHeaders","headers","out","k","v","Object","entries","undefined","toLowerCase","Array","isArray","join","String","loopbackBaseUrl","req","socket","port","localPort","encrypted","bound","server","address","host","localAddress","startsWith","slice","includes","isStandard","s","toJsonSchema","schema","undefined","out","jsonSchema","input","target","toJSONSchema","Error","$schema","_ignored","rest","toValidator","validate","value","result","issues","ok","message","map","i","path","p","String","key","join","checkRequired","args","missing","required","filter","k","length","DEFAULT_FORWARD_HEADERS","BODY_METHODS","Set","PARAM_RE","pathParams","path","matchAll","map","m","encodeSegment","name","value","raw","String","Error","JSON","stringify","encodeURIComponent","interpolatePath","values","replace","_","k","undefined","a","b","joinPaths","parts","joined","filter","p","Boolean","join","toolNameFromRoute","method","segments","split","s","exec","sanitizeToolName","toLowerCase","slice","defaultAnnotations","readOnlyHint","openWorldHint","destructiveHint","idempotentHint","buildInputSchema","route","opts","toUpperCase","params","mapping","query","body","wholeBody","bodyMethod","has","input","schema","toJsonSchema","type","properties","required","paramSchema","description","includes","add","querySchema","v","Object","entries","bodySchema","size","splitArgs","args","pathValues","Array","isArray","responseToResult","res","maxChars","text","length","isError","status","result","content","headers","parsed","parse","structuredContent","pickForwardHeaders","ctx","names","out","createRouteTool","dispatch","serverOpts","forward","forwardHeaders","maxResponseChars","title","inputSchema","annotations","validate","toValidator","handler","missing","checkRequired","accept","clientIp","err","message","SUPPORTED_PROTOCOL_VERSIONS","LATEST_PROTOCOL_VERSION","PARSE_ERROR","INVALID_REQUEST","METHOD_NOT_FOUND","INVALID_PARAMS","ok","id","result","jsonrpc","fail","code","message","error","McpServer","tools","Map","loaders","options","addTool","tool","has","name","Error","set","onLoad","loader","push","listTools","load","values","length","l","handleMessage","ctx","Array","isArray","results","Promise","all","map","m","handleOne","filter","r","msg","method","undefined","params","requested","protocolVersion","includes","capabilities","listChanged","serverInfo","version","instructions","t","title","description","inputSchema","annotations","get","String","callTool","arguments","resources","prompts","args","validate","v","isError","content","type","text","value","handler","err","isOriginAllowed","origin","allowed","allowedOrigins","handleHttp","req","json","headers","status","body","JSON","stringify","toUpperCase","allow","Uint8Array","parse","TextDecoder","decode","response","PRIMITIVES","Map","String","type","Number","Boolean","Date","format","Array","Object","primitiveSchema","s","get","undefined","applyRule","name","c","exclusiveMinimum","exclusiveMaximum","minimum","maximum","minLength","maxLength","RegExp","pattern","source","enum","values","Math","max","minItems","maxItems","dtoToJsonSchema","dto","storage","depth","schema","properties","metas","getTargetValidationMetadatas","optional","Set","m","prop","propertyName","initial","add","nestedType","Reflect","getMetadata","prototype","has","assign","each","items","constraints","required","keys","filter","p","length","designType","api","description","example","examples","isArray","PATH_METADATA","METHOD_METADATA","ROUTE_ARGS_METADATA","VERSION_METADATA","REQUEST_METHODS","PARAMTYPE_BODY","PARAMTYPE_QUERY","PARAMTYPE_PARAM","MCP_TOOL_METADATA","MCP_MODULE_OPTIONS","Symbol","McpTool","options","SetMetadata","McpService","server","discovery","appConfig","McpServer","t","tools","addTool","dispatch","createFetchDispatcher","baseUrl","ctx","loopbackBaseUrl","raw","onLoad","storage","classValidatorStorage","loadClassValidator","discover","createRouteTool","route","globalPrefix","getGlobalPrefix","versionSegment","controller","handler","versioning","getVersioning","type","undefined","version","Reflect","getMetadata","defaultVersion","Array","isArray","prefix","String","found","wrapper","getControllers","metatype","prototype","proto","ctrlPaths","toArray","ctrlName","name","replace","key","Object","getOwnPropertyNames","getOwnPropertyDescriptor","value","meta","method","methodPath","path","joinPaths","pathPrefix","push","sanitizeToolName","toSnake","describeArgs","args","types","params","properties","query","required","body","schemaFor","primitiveSchema","dtoToJsonSchema","k","arg","entries","paramtype","Number","split","index","field","data","assign","mergeObject","out","keys","length","a","b","cv","getMetadataStorage","v","s","toLowerCase","Injectable","Inject","DiscoveryService","ApplicationConfig","createMcpController","McpController","mcp","handle","req","res","nodeReq","headers","normalizeHeaders","clientIp","ip","handleHttp","code","status","send","set","end","descriptor","Controller","VERSION_NEUTRAL","All","Req","Res","guards","UseGuards","McpModule","forRoot","module","global","imports","DiscoveryModule","controllers","providers","provide","useValue","exports","forRootAsync","inject","useFactory","Module"]}
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared types for mcp-expose. Everything in `core` is runtime-agnostic
|
|
3
|
+
* (no `node:*` imports) so it also works on Bun, Deno and edge runtimes.
|
|
4
|
+
*/
|
|
5
|
+
/** A JSON Schema object. Kept intentionally loose. */
|
|
6
|
+
interface JsonSchema {
|
|
7
|
+
type?: string | string[];
|
|
8
|
+
properties?: Record<string, JsonSchema>;
|
|
9
|
+
required?: string[];
|
|
10
|
+
items?: JsonSchema | JsonSchema[];
|
|
11
|
+
description?: string;
|
|
12
|
+
enum?: unknown[];
|
|
13
|
+
[key: string]: unknown;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Anything we can turn into a JSON Schema:
|
|
17
|
+
* - a plain JSON Schema object
|
|
18
|
+
* - a Standard Schema / Standard JSON Schema object (zod >= 4.2, valibot, arktype, ...)
|
|
19
|
+
* - any object with a `toJSONSchema()` method (zod 4)
|
|
20
|
+
*/
|
|
21
|
+
type SchemaLike = JsonSchema | {
|
|
22
|
+
'~standard': unknown;
|
|
23
|
+
} | {
|
|
24
|
+
toJSONSchema(): unknown;
|
|
25
|
+
};
|
|
26
|
+
/** MCP tool annotations (hints for clients, never trusted for security). */
|
|
27
|
+
interface ToolAnnotations {
|
|
28
|
+
title?: string;
|
|
29
|
+
readOnlyHint?: boolean;
|
|
30
|
+
destructiveHint?: boolean;
|
|
31
|
+
idempotentHint?: boolean;
|
|
32
|
+
openWorldHint?: boolean;
|
|
33
|
+
}
|
|
34
|
+
type TextContent = {
|
|
35
|
+
type: 'text';
|
|
36
|
+
text: string;
|
|
37
|
+
};
|
|
38
|
+
interface ToolResult {
|
|
39
|
+
content: TextContent[];
|
|
40
|
+
structuredContent?: Record<string, unknown>;
|
|
41
|
+
isError?: boolean;
|
|
42
|
+
}
|
|
43
|
+
/** Per-call context, derived from the incoming MCP HTTP request. */
|
|
44
|
+
interface ToolContext {
|
|
45
|
+
/** Lower-cased headers of the MCP request (used for auth forwarding). */
|
|
46
|
+
headers: Record<string, string>;
|
|
47
|
+
/** IP address of the MCP client, if known. Forwarded as `X-Forwarded-For`. */
|
|
48
|
+
clientIp?: string;
|
|
49
|
+
/** Framework-specific raw request object (Express req, Koa ctx, Hono context...). */
|
|
50
|
+
raw?: unknown;
|
|
51
|
+
}
|
|
52
|
+
/** A fully resolved MCP tool. */
|
|
53
|
+
interface McpToolDefinition {
|
|
54
|
+
name: string;
|
|
55
|
+
title?: string;
|
|
56
|
+
description: string;
|
|
57
|
+
inputSchema: JsonSchema;
|
|
58
|
+
annotations?: ToolAnnotations;
|
|
59
|
+
handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<ToolResult>;
|
|
60
|
+
/** Optional validator run before the handler (from Standard Schema inputs). */
|
|
61
|
+
validate?: (args: unknown) => Promise<{
|
|
62
|
+
ok: true;
|
|
63
|
+
value: unknown;
|
|
64
|
+
} | {
|
|
65
|
+
ok: false;
|
|
66
|
+
message: string;
|
|
67
|
+
}>;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Options a developer attaches to a route to expose it as a tool.
|
|
71
|
+
* Used by every framework adapter (`@McpTool()`, `mcpTool()`, `config.mcp`, ...).
|
|
72
|
+
*/
|
|
73
|
+
interface RouteToolOptions {
|
|
74
|
+
/** Tool name. Defaults to a name derived from the route (e.g. `get_users_by_id`). */
|
|
75
|
+
name?: string;
|
|
76
|
+
title?: string;
|
|
77
|
+
/** What the tool does. Agents read this to decide when to call it. Write it well. */
|
|
78
|
+
description?: string;
|
|
79
|
+
/** Full input schema. Overrides `params` / `query` / `body`. */
|
|
80
|
+
input?: SchemaLike;
|
|
81
|
+
/** Schema for path parameters (`:id`). Defaults to string params. */
|
|
82
|
+
params?: SchemaLike;
|
|
83
|
+
/** Schema for the query string. */
|
|
84
|
+
query?: SchemaLike;
|
|
85
|
+
/** Schema for the JSON request body. */
|
|
86
|
+
body?: SchemaLike;
|
|
87
|
+
annotations?: ToolAnnotations;
|
|
88
|
+
/** Extra static headers sent with the internal request. */
|
|
89
|
+
headers?: Record<string, string>;
|
|
90
|
+
}
|
|
91
|
+
/** HTTP route that backs a tool. `path` may use `:param` or `{param}` placeholders. */
|
|
92
|
+
interface RouteSpec {
|
|
93
|
+
method: string;
|
|
94
|
+
path: string;
|
|
95
|
+
}
|
|
96
|
+
/** Internal request produced by a tool call, handed to a Dispatcher. */
|
|
97
|
+
interface RouteRequest {
|
|
98
|
+
method: string;
|
|
99
|
+
/** Interpolated path, e.g. `/users/42`. */
|
|
100
|
+
path: string;
|
|
101
|
+
query: Record<string, string | string[]>;
|
|
102
|
+
body?: unknown;
|
|
103
|
+
headers: Record<string, string>;
|
|
104
|
+
}
|
|
105
|
+
interface RouteResponse {
|
|
106
|
+
status: number;
|
|
107
|
+
headers: Record<string, string>;
|
|
108
|
+
body: string;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Sends a RouteRequest through the host application. Adapters pick the best
|
|
112
|
+
* strategy: in-process injection (Fastify, Hono) or loopback HTTP (Express, Koa, NestJS).
|
|
113
|
+
* Either way the request runs through the app's full middleware/guard/pipe stack.
|
|
114
|
+
*/
|
|
115
|
+
type Dispatcher = (req: RouteRequest, ctx: ToolContext) => Promise<RouteResponse>;
|
|
116
|
+
/** Options shared by every adapter. */
|
|
117
|
+
interface McpServerOptions {
|
|
118
|
+
/** Server name reported to MCP clients. */
|
|
119
|
+
name: string;
|
|
120
|
+
/** Server version reported to MCP clients. */
|
|
121
|
+
version?: string;
|
|
122
|
+
/** Optional instructions shown to the model about how to use this server. */
|
|
123
|
+
instructions?: string;
|
|
124
|
+
/**
|
|
125
|
+
* Allowed values of the `Origin` header. Requests carrying any other Origin
|
|
126
|
+
* are rejected (DNS-rebinding protection, required by the MCP spec).
|
|
127
|
+
* Requests without an Origin header (CLI/desktop clients, server-to-server) are always allowed.
|
|
128
|
+
* Use `'*'` to disable the check.
|
|
129
|
+
*/
|
|
130
|
+
allowedOrigins?: string[] | '*';
|
|
131
|
+
/**
|
|
132
|
+
* Request headers copied from the MCP request to the internal API request.
|
|
133
|
+
* This is how your existing auth (JWT, sessions, API keys) keeps working.
|
|
134
|
+
* @default ['authorization', 'cookie', 'x-api-key', 'accept-language']
|
|
135
|
+
*/
|
|
136
|
+
forwardHeaders?: string[];
|
|
137
|
+
/** Max characters of an API response returned to the model. @default 100_000 */
|
|
138
|
+
maxResponseChars?: number;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
|
|
142
|
+
declare const LATEST_PROTOCOL_VERSION: string;
|
|
143
|
+
type JsonRpcId = string | number | null;
|
|
144
|
+
interface JsonRpcResponse {
|
|
145
|
+
jsonrpc: '2.0';
|
|
146
|
+
id: JsonRpcId;
|
|
147
|
+
result?: unknown;
|
|
148
|
+
error?: {
|
|
149
|
+
code: number;
|
|
150
|
+
message: string;
|
|
151
|
+
data?: unknown;
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
/** Minimal HTTP request/response shapes, so each adapter can bridge its own framework. */
|
|
155
|
+
interface McpHttpRequest {
|
|
156
|
+
method: string;
|
|
157
|
+
headers: Record<string, string>;
|
|
158
|
+
/** Parsed JSON body, or the raw string. */
|
|
159
|
+
body: unknown;
|
|
160
|
+
}
|
|
161
|
+
interface McpHttpResponse {
|
|
162
|
+
status: number;
|
|
163
|
+
headers: Record<string, string>;
|
|
164
|
+
body?: string;
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* A stateless MCP server speaking the Streamable HTTP transport (JSON responses).
|
|
168
|
+
* Holds the tool registry and answers JSON-RPC messages.
|
|
169
|
+
*/
|
|
170
|
+
declare class McpServer {
|
|
171
|
+
readonly options: McpServerOptions;
|
|
172
|
+
private readonly tools;
|
|
173
|
+
private loaders;
|
|
174
|
+
constructor(options: McpServerOptions);
|
|
175
|
+
/** Register a tool. Throws on duplicate names. */
|
|
176
|
+
addTool(tool: McpToolDefinition): this;
|
|
177
|
+
/** Register a function that adds tools lazily, right before the first MCP request is served. */
|
|
178
|
+
onLoad(loader: () => void | Promise<void>): this;
|
|
179
|
+
listTools(): Promise<McpToolDefinition[]>;
|
|
180
|
+
private load;
|
|
181
|
+
/** Handle one JSON-RPC message (or a batch). Returns null when no response is due. */
|
|
182
|
+
handleMessage(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | JsonRpcResponse[] | null>;
|
|
183
|
+
private handleOne;
|
|
184
|
+
private callTool;
|
|
185
|
+
/** Check the Origin header (DNS rebinding protection). */
|
|
186
|
+
isOriginAllowed(origin: string | undefined): boolean;
|
|
187
|
+
/**
|
|
188
|
+
* Framework-neutral Streamable HTTP handler. Adapters convert their request
|
|
189
|
+
* into McpHttpRequest, call this, and write the McpHttpResponse back.
|
|
190
|
+
*/
|
|
191
|
+
handleHttp(req: McpHttpRequest, ctx: ToolContext): Promise<McpHttpResponse>;
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
export { type Dispatcher as D, type JsonSchema as J, LATEST_PROTOCOL_VERSION as L, type McpServerOptions as M, type RouteToolOptions as R, type SchemaLike as S, type ToolContext as T, type McpToolDefinition as a, McpServer as b, type RouteSpec as c, type ToolAnnotations as d, type ToolResult as e, type JsonRpcResponse as f, type McpHttpRequest as g, type McpHttpResponse as h, type RouteRequest as i, type RouteResponse as j, SUPPORTED_PROTOCOL_VERSIONS as k, type TextContent as l };
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared types for mcp-expose. Everything in `core` is runtime-agnostic
|
|
3
|
+
* (no `node:*` imports) so it also works on Bun, Deno and edge runtimes.
|
|
4
|
+
*/
|
|
5
|
+
/** A JSON Schema object. Kept intentionally loose. */
|
|
6
|
+
interface JsonSchema {
|
|
7
|
+
type?: string | string[];
|
|
8
|
+
properties?: Record<string, JsonSchema>;
|
|
9
|
+
required?: string[];
|
|
10
|
+
items?: JsonSchema | JsonSchema[];
|
|
11
|
+
description?: string;
|
|
12
|
+
enum?: unknown[];
|
|
13
|
+
[key: string]: unknown;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Anything we can turn into a JSON Schema:
|
|
17
|
+
* - a plain JSON Schema object
|
|
18
|
+
* - a Standard Schema / Standard JSON Schema object (zod >= 4.2, valibot, arktype, ...)
|
|
19
|
+
* - any object with a `toJSONSchema()` method (zod 4)
|
|
20
|
+
*/
|
|
21
|
+
type SchemaLike = JsonSchema | {
|
|
22
|
+
'~standard': unknown;
|
|
23
|
+
} | {
|
|
24
|
+
toJSONSchema(): unknown;
|
|
25
|
+
};
|
|
26
|
+
/** MCP tool annotations (hints for clients, never trusted for security). */
|
|
27
|
+
interface ToolAnnotations {
|
|
28
|
+
title?: string;
|
|
29
|
+
readOnlyHint?: boolean;
|
|
30
|
+
destructiveHint?: boolean;
|
|
31
|
+
idempotentHint?: boolean;
|
|
32
|
+
openWorldHint?: boolean;
|
|
33
|
+
}
|
|
34
|
+
type TextContent = {
|
|
35
|
+
type: 'text';
|
|
36
|
+
text: string;
|
|
37
|
+
};
|
|
38
|
+
interface ToolResult {
|
|
39
|
+
content: TextContent[];
|
|
40
|
+
structuredContent?: Record<string, unknown>;
|
|
41
|
+
isError?: boolean;
|
|
42
|
+
}
|
|
43
|
+
/** Per-call context, derived from the incoming MCP HTTP request. */
|
|
44
|
+
interface ToolContext {
|
|
45
|
+
/** Lower-cased headers of the MCP request (used for auth forwarding). */
|
|
46
|
+
headers: Record<string, string>;
|
|
47
|
+
/** IP address of the MCP client, if known. Forwarded as `X-Forwarded-For`. */
|
|
48
|
+
clientIp?: string;
|
|
49
|
+
/** Framework-specific raw request object (Express req, Koa ctx, Hono context...). */
|
|
50
|
+
raw?: unknown;
|
|
51
|
+
}
|
|
52
|
+
/** A fully resolved MCP tool. */
|
|
53
|
+
interface McpToolDefinition {
|
|
54
|
+
name: string;
|
|
55
|
+
title?: string;
|
|
56
|
+
description: string;
|
|
57
|
+
inputSchema: JsonSchema;
|
|
58
|
+
annotations?: ToolAnnotations;
|
|
59
|
+
handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<ToolResult>;
|
|
60
|
+
/** Optional validator run before the handler (from Standard Schema inputs). */
|
|
61
|
+
validate?: (args: unknown) => Promise<{
|
|
62
|
+
ok: true;
|
|
63
|
+
value: unknown;
|
|
64
|
+
} | {
|
|
65
|
+
ok: false;
|
|
66
|
+
message: string;
|
|
67
|
+
}>;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Options a developer attaches to a route to expose it as a tool.
|
|
71
|
+
* Used by every framework adapter (`@McpTool()`, `mcpTool()`, `config.mcp`, ...).
|
|
72
|
+
*/
|
|
73
|
+
interface RouteToolOptions {
|
|
74
|
+
/** Tool name. Defaults to a name derived from the route (e.g. `get_users_by_id`). */
|
|
75
|
+
name?: string;
|
|
76
|
+
title?: string;
|
|
77
|
+
/** What the tool does. Agents read this to decide when to call it. Write it well. */
|
|
78
|
+
description?: string;
|
|
79
|
+
/** Full input schema. Overrides `params` / `query` / `body`. */
|
|
80
|
+
input?: SchemaLike;
|
|
81
|
+
/** Schema for path parameters (`:id`). Defaults to string params. */
|
|
82
|
+
params?: SchemaLike;
|
|
83
|
+
/** Schema for the query string. */
|
|
84
|
+
query?: SchemaLike;
|
|
85
|
+
/** Schema for the JSON request body. */
|
|
86
|
+
body?: SchemaLike;
|
|
87
|
+
annotations?: ToolAnnotations;
|
|
88
|
+
/** Extra static headers sent with the internal request. */
|
|
89
|
+
headers?: Record<string, string>;
|
|
90
|
+
}
|
|
91
|
+
/** HTTP route that backs a tool. `path` may use `:param` or `{param}` placeholders. */
|
|
92
|
+
interface RouteSpec {
|
|
93
|
+
method: string;
|
|
94
|
+
path: string;
|
|
95
|
+
}
|
|
96
|
+
/** Internal request produced by a tool call, handed to a Dispatcher. */
|
|
97
|
+
interface RouteRequest {
|
|
98
|
+
method: string;
|
|
99
|
+
/** Interpolated path, e.g. `/users/42`. */
|
|
100
|
+
path: string;
|
|
101
|
+
query: Record<string, string | string[]>;
|
|
102
|
+
body?: unknown;
|
|
103
|
+
headers: Record<string, string>;
|
|
104
|
+
}
|
|
105
|
+
interface RouteResponse {
|
|
106
|
+
status: number;
|
|
107
|
+
headers: Record<string, string>;
|
|
108
|
+
body: string;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Sends a RouteRequest through the host application. Adapters pick the best
|
|
112
|
+
* strategy: in-process injection (Fastify, Hono) or loopback HTTP (Express, Koa, NestJS).
|
|
113
|
+
* Either way the request runs through the app's full middleware/guard/pipe stack.
|
|
114
|
+
*/
|
|
115
|
+
type Dispatcher = (req: RouteRequest, ctx: ToolContext) => Promise<RouteResponse>;
|
|
116
|
+
/** Options shared by every adapter. */
|
|
117
|
+
interface McpServerOptions {
|
|
118
|
+
/** Server name reported to MCP clients. */
|
|
119
|
+
name: string;
|
|
120
|
+
/** Server version reported to MCP clients. */
|
|
121
|
+
version?: string;
|
|
122
|
+
/** Optional instructions shown to the model about how to use this server. */
|
|
123
|
+
instructions?: string;
|
|
124
|
+
/**
|
|
125
|
+
* Allowed values of the `Origin` header. Requests carrying any other Origin
|
|
126
|
+
* are rejected (DNS-rebinding protection, required by the MCP spec).
|
|
127
|
+
* Requests without an Origin header (CLI/desktop clients, server-to-server) are always allowed.
|
|
128
|
+
* Use `'*'` to disable the check.
|
|
129
|
+
*/
|
|
130
|
+
allowedOrigins?: string[] | '*';
|
|
131
|
+
/**
|
|
132
|
+
* Request headers copied from the MCP request to the internal API request.
|
|
133
|
+
* This is how your existing auth (JWT, sessions, API keys) keeps working.
|
|
134
|
+
* @default ['authorization', 'cookie', 'x-api-key', 'accept-language']
|
|
135
|
+
*/
|
|
136
|
+
forwardHeaders?: string[];
|
|
137
|
+
/** Max characters of an API response returned to the model. @default 100_000 */
|
|
138
|
+
maxResponseChars?: number;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
|
|
142
|
+
declare const LATEST_PROTOCOL_VERSION: string;
|
|
143
|
+
type JsonRpcId = string | number | null;
|
|
144
|
+
interface JsonRpcResponse {
|
|
145
|
+
jsonrpc: '2.0';
|
|
146
|
+
id: JsonRpcId;
|
|
147
|
+
result?: unknown;
|
|
148
|
+
error?: {
|
|
149
|
+
code: number;
|
|
150
|
+
message: string;
|
|
151
|
+
data?: unknown;
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
/** Minimal HTTP request/response shapes, so each adapter can bridge its own framework. */
|
|
155
|
+
interface McpHttpRequest {
|
|
156
|
+
method: string;
|
|
157
|
+
headers: Record<string, string>;
|
|
158
|
+
/** Parsed JSON body, or the raw string. */
|
|
159
|
+
body: unknown;
|
|
160
|
+
}
|
|
161
|
+
interface McpHttpResponse {
|
|
162
|
+
status: number;
|
|
163
|
+
headers: Record<string, string>;
|
|
164
|
+
body?: string;
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* A stateless MCP server speaking the Streamable HTTP transport (JSON responses).
|
|
168
|
+
* Holds the tool registry and answers JSON-RPC messages.
|
|
169
|
+
*/
|
|
170
|
+
declare class McpServer {
|
|
171
|
+
readonly options: McpServerOptions;
|
|
172
|
+
private readonly tools;
|
|
173
|
+
private loaders;
|
|
174
|
+
constructor(options: McpServerOptions);
|
|
175
|
+
/** Register a tool. Throws on duplicate names. */
|
|
176
|
+
addTool(tool: McpToolDefinition): this;
|
|
177
|
+
/** Register a function that adds tools lazily, right before the first MCP request is served. */
|
|
178
|
+
onLoad(loader: () => void | Promise<void>): this;
|
|
179
|
+
listTools(): Promise<McpToolDefinition[]>;
|
|
180
|
+
private load;
|
|
181
|
+
/** Handle one JSON-RPC message (or a batch). Returns null when no response is due. */
|
|
182
|
+
handleMessage(message: unknown, ctx: ToolContext): Promise<JsonRpcResponse | JsonRpcResponse[] | null>;
|
|
183
|
+
private handleOne;
|
|
184
|
+
private callTool;
|
|
185
|
+
/** Check the Origin header (DNS rebinding protection). */
|
|
186
|
+
isOriginAllowed(origin: string | undefined): boolean;
|
|
187
|
+
/**
|
|
188
|
+
* Framework-neutral Streamable HTTP handler. Adapters convert their request
|
|
189
|
+
* into McpHttpRequest, call this, and write the McpHttpResponse back.
|
|
190
|
+
*/
|
|
191
|
+
handleHttp(req: McpHttpRequest, ctx: ToolContext): Promise<McpHttpResponse>;
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
export { type Dispatcher as D, type JsonSchema as J, LATEST_PROTOCOL_VERSION as L, type McpServerOptions as M, type RouteToolOptions as R, type SchemaLike as S, type ToolContext as T, type McpToolDefinition as a, McpServer as b, type RouteSpec as c, type ToolAnnotations as d, type ToolResult as e, type JsonRpcResponse as f, type McpHttpRequest as g, type McpHttpResponse as h, type RouteRequest as i, type RouteResponse as j, SUPPORTED_PROTOCOL_VERSIONS as k, type TextContent as l };
|