@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/application/mcp/cliMcp.js

@@ -0,0 +1,231 @@
+import { createMcpElysiaHandler } from "./common.js";
+import { appLogger } from "../../infrastructure/elysia/logger.js";
+import fs from "node:fs/promises";
+import { OperationSpecRegistry, PromptRegistry, ResourceRegistry, defineCommand, definePrompt, defineResourceTemplate, installOp } from "@contractspec/lib.contracts";
+import z from "zod";
+import path from "path";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/application/mcp/cliMcp.ts
+const CLI_DOC_PATHS = {
+	quickstart: "packages/apps/cli-contractspec/QUICK_START.md",
+	reference: "packages/apps/cli-contractspec/QUICK_REFERENCE.md",
+	readme: "packages/apps/cli-contractspec/README.md"
+};
+const CLI_DOC_FALLBACK = {
+	quickstart: "# ContractSpec CLI quickstart\n\ncontractspec create\ncontractspec build <spec>\ncontractspec validate <spec>",
+	reference: "# ContractSpec CLI reference\n\nKey commands: create, build, validate. See README for full options.",
+	readme: "# ContractSpec CLI\n\nStabilize AI-generated code across API, DB, UI, events. Use create/build/validate commands."
+};
+const CLI_DOC_TAGS = ["cli", "mcp"];
+const CLI_OWNERS = ["@contractspec"];
+const candidateRoots = (() => {
+	const roots = new Set([
+		process.cwd(),
+		path.resolve(process.cwd(), ".."),
+		path.resolve(process.cwd(), "../.."),
+		path.resolve(process.cwd(), "../../..")
+	]);
+	if (typeof __dirname === "string") roots.add(path.resolve(__dirname, "../../../../.."));
+	return [...roots];
+})();
+const docCache = /* @__PURE__ */ new Map();
+async function loadCliDoc(key) {
+	if (docCache.has(key)) return docCache.get(key);
+	const relative = CLI_DOC_PATHS[key];
+	for (const root of candidateRoots) {
+		const candidate = path.resolve(root, relative);
+		try {
+			const data = await fs.readFile(candidate, "utf8");
+			docCache.set(key, data);
+			return data;
+		} catch {}
+	}
+	const fallback = CLI_DOC_FALLBACK[key];
+	docCache.set(key, fallback);
+	return fallback;
+}
+function buildCliResources() {
+	const resources = new ResourceRegistry();
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "cli://doc/{slug}",
+			title: "CLI documentation",
+			description: "Quickstart, reference, and README for the CLI.",
+			mimeType: "text/markdown",
+			tags: CLI_DOC_TAGS
+		},
+		input: z.object({ slug: z.enum([
+			"quickstart",
+			"reference",
+			"readme"
+		]) }),
+		resolve: async ({ slug }) => {
+			const data = await loadCliDoc(slug);
+			return {
+				uri: `cli://doc/${slug}`,
+				mimeType: "text/markdown",
+				data
+			};
+		}
+	}));
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "cli://commands",
+			title: "CLI commands summary",
+			description: "Key ContractSpec CLI commands and when to use them.",
+			mimeType: "application/json",
+			tags: CLI_DOC_TAGS
+		},
+		input: z.object({}),
+		resolve: async () => {
+			return {
+				uri: "cli://commands",
+				mimeType: "application/json",
+				data: JSON.stringify([
+					{
+						command: "contractspec create",
+						summary: "Interactive wizard to author specs (with optional AI).",
+						doc: "cli://doc/quickstart"
+					},
+					{
+						command: "contractspec build <specPath>",
+						summary: "Generate implementation code from a ContractSpec (agents + templates).",
+						doc: "cli://doc/reference"
+					},
+					{
+						command: "contractspec validate <specPath>",
+						summary: "Validate specs and optionally check implementations against them.",
+						doc: "cli://doc/reference"
+					}
+				], null, 2)
+			};
+		}
+	}));
+	return resources;
+}
+function buildCliPrompts() {
+	const prompts = new PromptRegistry();
+	prompts.register(definePrompt({
+		meta: {
+			key: "cli.usage",
+			version: "1.0.0",
+			title: "Use ContractSpec CLI safely",
+			description: "Remind agents to read CLI docs and pick commands from the canonical list.",
+			tags: CLI_DOC_TAGS,
+			stability: "beta",
+			owners: CLI_OWNERS
+		},
+		args: [{
+			name: "goal",
+			description: "Task the user wants to achieve.",
+			required: false,
+			schema: z.string().optional()
+		}],
+		input: z.object({ goal: z.string().optional() }),
+		render: async ({ goal }) => [
+			{
+				type: "text",
+				text: `Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${goal ? ` Goal: ${goal}.` : ""}`
+			},
+			{
+				type: "resource",
+				uri: "cli://commands",
+				title: "Commands"
+			},
+			{
+				type: "resource",
+				uri: "cli://doc/quickstart",
+				title: "Quickstart"
+			}
+		]
+	}));
+	return prompts;
+}
+function buildCliOps() {
+	const registry = new OperationSpecRegistry();
+	const CliSuggestInput = defineSchemaModel({
+		name: "CliSuggestInput",
+		fields: {
+			goal: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			},
+			prefersAi: {
+				type: ScalarTypeEnum.Boolean(),
+				isOptional: true
+			}
+		}
+	});
+	const CliSuggestOutput = defineSchemaModel({
+		name: "CliSuggestOutput",
+		fields: {
+			command: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			},
+			docUri: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			},
+			reason: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			}
+		}
+	});
+	installOp(registry, defineCommand({
+		meta: {
+			key: "cli.suggestCommand",
+			version: "1.0.0",
+			stability: "stable",
+			owners: CLI_OWNERS,
+			tags: CLI_DOC_TAGS,
+			description: "Recommend a CLI command for the requested goal.",
+			goal: "Help AI agents choose the correct CLI entrypoint quickly.",
+			context: "Used inside the CLI MCP server."
+		},
+		io: {
+			input: CliSuggestInput,
+			output: CliSuggestOutput
+		},
+		policy: { auth: "anonymous" }
+	}), async ({ goal, prefersAi }) => {
+		const lower = goal.toLowerCase();
+		if (lower.includes("create") || lower.includes("new")) return {
+			command: prefersAi ? "contractspec create --ai" : "contractspec create",
+			docUri: "cli://doc/quickstart",
+			reason: "Creates a new ContractSpec interactively (optionally with AI)."
+		};
+		if (lower.includes("build") || lower.includes("generate")) return {
+			command: "contractspec build <path-to-spec>",
+			docUri: "cli://doc/reference",
+			reason: "Builds implementation code from a spec using agents + templates."
+		};
+		if (lower.includes("validate") || lower.includes("check")) return {
+			command: "contractspec validate <path-to-spec>",
+			docUri: "cli://doc/reference",
+			reason: "Validates a spec and optionally checks its implementation for drift."
+		};
+		return {
+			command: "contractspec --help",
+			docUri: "cli://doc/readme",
+			reason: "Fallback when the goal is unclear; read README for options."
+		};
+	});
+	return registry;
+}
+function createCliMcpHandler(path = "/api/mcp/cli") {
+	return createMcpElysiaHandler({
+		logger: appLogger,
+		path,
+		serverName: "contractspec-cli-mcp",
+		ops: buildCliOps(),
+		resources: buildCliResources(),
+		prompts: buildCliPrompts()
+	});
+}
+
+//#endregion
+export { createCliMcpHandler };
+//# sourceMappingURL=cliMcp.js.map

package/dist/application/mcp/cliMcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliMcp.js","names":[],"sources":["../../../src/application/mcp/cliMcp.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'path';\nimport {\n  defineCommand,\n  definePrompt,\n  defineResourceTemplate,\n  installOp,\n  OperationSpecRegistry,\n  PromptRegistry,\n  ResourceRegistry,\n} from '@contractspec/lib.contracts';\nimport { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\nimport z from 'zod';\nimport { createMcpElysiaHandler } from './common';\nimport { appLogger } from '../../infrastructure/elysia/logger';\n\nconst CLI_DOC_PATHS = {\n  quickstart: 'packages/apps/cli-contractspec/QUICK_START.md',\n  reference: 'packages/apps/cli-contractspec/QUICK_REFERENCE.md',\n  readme: 'packages/apps/cli-contractspec/README.md',\n};\n\nconst CLI_DOC_FALLBACK = {\n  quickstart:\n    '# ContractSpec CLI quickstart\\n\\ncontractspec create\\ncontractspec build <spec>\\ncontractspec validate <spec>',\n  reference:\n    '# ContractSpec CLI reference\\n\\nKey commands: create, build, validate. See README for full options.',\n  readme:\n    '# ContractSpec CLI\\n\\nStabilize AI-generated code across API, DB, UI, events. Use create/build/validate commands.',\n};\n\nconst CLI_DOC_TAGS = ['cli', 'mcp'];\nconst CLI_OWNERS = ['@contractspec'];\n\nconst candidateRoots = (() => {\n  const roots = new Set<string>([\n    process.cwd(),\n    path.resolve(process.cwd(), '..'),\n    path.resolve(process.cwd(), '../..'),\n    path.resolve(process.cwd(), '../../..'),\n  ]);\n  if (typeof __dirname === 'string') {\n    roots.add(path.resolve(__dirname, '../../../../..'));\n  }\n  return [...roots];\n})();\n\nconst docCache = new Map<string, string>();\n\nasync function loadCliDoc(key: keyof typeof CLI_DOC_PATHS): Promise<string> {\n  if (docCache.has(key)) {\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n    return docCache.get(key)!;\n  }\n\n  const relative = CLI_DOC_PATHS[key];\n  for (const root of candidateRoots) {\n    const candidate = path.resolve(root, relative);\n    try {\n      const data = await fs.readFile(candidate, 'utf8');\n      docCache.set(key, data);\n      return data;\n    } catch {\n      // try next candidate\n    }\n  }\n\n  const fallback = CLI_DOC_FALLBACK[key];\n  docCache.set(key, fallback);\n  return fallback;\n}\n\nfunction buildCliResources() {\n  const resources = new ResourceRegistry();\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'cli://doc/{slug}',\n        title: 'CLI documentation',\n        description: 'Quickstart, reference, and README for the CLI.',\n        mimeType: 'text/markdown',\n        tags: CLI_DOC_TAGS,\n      },\n      input: z.object({\n        slug: z.enum(['quickstart', 'reference', 'readme']),\n      }),\n      resolve: async ({ slug }) => {\n        const data = await loadCliDoc(slug);\n        return {\n          uri: `cli://doc/${slug}`,\n          mimeType: 'text/markdown',\n          data,\n        };\n      },\n    })\n  );\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'cli://commands',\n        title: 'CLI commands summary',\n        description: 'Key ContractSpec CLI commands and when to use them.',\n        mimeType: 'application/json',\n        tags: CLI_DOC_TAGS,\n      },\n      input: z.object({}),\n      resolve: async () => {\n        const commands = [\n          {\n            command: 'contractspec create',\n            summary: 'Interactive wizard to author specs (with optional AI).',\n            doc: 'cli://doc/quickstart',\n          },\n          {\n            command: 'contractspec build <specPath>',\n            summary:\n              'Generate implementation code from a ContractSpec (agents + templates).',\n            doc: 'cli://doc/reference',\n          },\n          {\n            command: 'contractspec validate <specPath>',\n            summary:\n              'Validate specs and optionally check implementations against them.',\n            doc: 'cli://doc/reference',\n          },\n        ];\n\n        return {\n          uri: 'cli://commands',\n          mimeType: 'application/json',\n          data: JSON.stringify(commands, null, 2),\n        };\n      },\n    })\n  );\n\n  return resources;\n}\n\nfunction buildCliPrompts() {\n  const prompts = new PromptRegistry();\n\n  prompts.register(\n    definePrompt({\n      meta: {\n        key: 'cli.usage',\n        version: '1.0.0',\n        title: 'Use ContractSpec CLI safely',\n        description:\n          'Remind agents to read CLI docs and pick commands from the canonical list.',\n        tags: CLI_DOC_TAGS,\n        stability: 'beta',\n        owners: CLI_OWNERS,\n      },\n      args: [\n        {\n          name: 'goal',\n          description: 'Task the user wants to achieve.',\n          required: false,\n          schema: z.string().optional(),\n        },\n      ],\n      input: z.object({ goal: z.string().optional() }),\n      render: async ({ goal }) => [\n        {\n          type: 'text',\n          text: `Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${goal ? ` Goal: ${goal}.` : ''}`,\n        },\n        { type: 'resource' as const, uri: 'cli://commands', title: 'Commands' },\n        {\n          type: 'resource' as const,\n          uri: 'cli://doc/quickstart',\n          title: 'Quickstart',\n        },\n      ],\n    })\n  );\n\n  return prompts;\n}\n\nfunction buildCliOps() {\n  const registry = new OperationSpecRegistry();\n\n  const CliSuggestInput = defineSchemaModel({\n    name: 'CliSuggestInput',\n    fields: {\n      goal: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      prefersAi: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    },\n  });\n\n  const CliSuggestOutput = defineSchemaModel({\n    name: 'CliSuggestOutput',\n    fields: {\n      command: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      docUri: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n      reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    },\n  });\n\n  const suggestSpec = defineCommand({\n    meta: {\n      key: 'cli.suggestCommand',\n      version: '1.0.0',\n      stability: 'stable',\n      owners: CLI_OWNERS,\n      tags: CLI_DOC_TAGS,\n      description: 'Recommend a CLI command for the requested goal.',\n      goal: 'Help AI agents choose the correct CLI entrypoint quickly.',\n      context: 'Used inside the CLI MCP server.',\n    },\n    io: {\n      input: CliSuggestInput,\n      output: CliSuggestOutput,\n    },\n    policy: {\n      auth: 'anonymous',\n    },\n  });\n\n  installOp(registry, suggestSpec, async ({ goal, prefersAi }) => {\n    const lower = goal.toLowerCase();\n\n    if (lower.includes('create') || lower.includes('new')) {\n      return {\n        command: prefersAi ? 'contractspec create --ai' : 'contractspec create',\n        docUri: 'cli://doc/quickstart',\n        reason:\n          'Creates a new ContractSpec interactively (optionally with AI).',\n      };\n    }\n\n    if (lower.includes('build') || lower.includes('generate')) {\n      return {\n        command: 'contractspec build <path-to-spec>',\n        docUri: 'cli://doc/reference',\n        reason:\n          'Builds implementation code from a spec using agents + templates.',\n      };\n    }\n\n    if (lower.includes('validate') || lower.includes('check')) {\n      return {\n        command: 'contractspec validate <path-to-spec>',\n        docUri: 'cli://doc/reference',\n        reason:\n          'Validates a spec and optionally checks its implementation for drift.',\n      };\n    }\n\n    return {\n      command: 'contractspec --help',\n      docUri: 'cli://doc/readme',\n      reason: 'Fallback when the goal is unclear; read README for options.',\n    };\n  });\n\n  return registry;\n}\n\nexport function createCliMcpHandler(path = '/api/mcp/cli') {\n  return createMcpElysiaHandler({\n    logger: appLogger,\n    path,\n    serverName: 'contractspec-cli-mcp',\n    ops: buildCliOps(),\n    resources: buildCliResources(),\n    prompts: buildCliPrompts(),\n  });\n}\n"],"mappings":"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"}

package/dist/application/mcp/common.d.ts

@@ -0,0 +1,120 @@
+import { OperationSpecRegistry, PromptRegistry, ResourceRegistry } from "@contractspec/lib.contracts";
+import { PresentationSpec as PresentationSpec$1 } from "@contractspec/lib.contracts/presentations";
+import { Logger } from "@contractspec/lib.logger";
+import * as _modelcontextprotocol_sdk_types_js0 from "@modelcontextprotocol/sdk/types.js";
+import * as elysia from "elysia";
+
+//#region src/application/mcp/common.d.ts
+interface McpHttpHandlerConfig {
+  path: string;
+  serverName: string;
+  ops: OperationSpecRegistry;
+  resources: ResourceRegistry;
+  prompts: PromptRegistry;
+  presentations?: PresentationSpec$1[];
+  logger: Logger;
+}
+declare function createMcpElysiaHandler({
+  logger,
+  path,
+  serverName,
+  ops,
+  resources,
+  prompts,
+  presentations
+}: McpHttpHandlerConfig): elysia.default<"", {
+  decorator: {};
+  store: {
+    authInfo: AuthInfo | undefined;
+  };
+  derive: {};
+  resolve: {};
+}, {
+  typebox: {};
+  error: {};
+}, {
+  schema: {};
+  standaloneSchema: {};
+  macro: {};
+  macroFn: {};
+  parser: {};
+  response: {};
+}, {
+  [x: string]: {
+    "*": {
+      [x: string]: {
+        body: unknown;
+        params: {
+          "*": string;
+        } & {};
+        query: unknown;
+        headers: unknown;
+        response: {
+          200: {} | {
+            jsonrpc: string;
+            error: {
+              code: _modelcontextprotocol_sdk_types_js0.ErrorCode;
+              message: string;
+              data: string;
+            };
+            id: null;
+          };
+          422: {
+            type: "validation";
+            on: string;
+            summary?: string;
+            message?: string;
+            found?: unknown;
+            property?: string;
+            expected?: string;
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    [x: string]: {
+      body: unknown;
+      params: {};
+      query: unknown;
+      headers: unknown;
+      response: {
+        200: {} | {
+          jsonrpc: string;
+          error: {
+            code: _modelcontextprotocol_sdk_types_js0.ErrorCode;
+            message: string;
+            data: string;
+          };
+          id: null;
+        };
+      };
+    };
+  };
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {};
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {
+    200: {} | {
+      jsonrpc: string;
+      error: {
+        code: _modelcontextprotocol_sdk_types_js0.ErrorCode;
+        message: string;
+        data: string;
+      };
+      id: null;
+    };
+  };
+}>;
+//#endregion
+export { createMcpElysiaHandler };
+//# sourceMappingURL=common.d.ts.map

package/dist/application/mcp/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","names":[],"sources":["../../../src/application/mcp/common.ts"],"mappings":";;;;;;;UAyCU,oBAAA;EACR,IAAA;EACA,UAAA;EACA,GAAA,EAAK,qBAAA;EACL,SAAA,EAAW,gBAAA;EACX,OAAA,EAAS,cAAA;EACT,aAAA,GAAgB,kBAAA;EAChB,MAAA,EAAQ,MAAA;AAAA;AAAA,iBAuCM,sBAAA,CAAA;EACd,MAAA;EACA,IAAA;EACA,UAAA;EACA,GAAA;EACA,SAAA;EACA,OAAA;EACA;AAAA,GACC,oBAAA,UAAoB,OAAA"}

package/dist/application/mcp/common.js

@@ -0,0 +1,66 @@
+import { PresentationRegistry, createMcpServer } from "@contractspec/lib.contracts";
+import { mcp } from "elysia-mcp";
+import { Logger } from "@contractspec/lib.logger";
+
+//#region src/application/mcp/common.ts
+function createConsoleLikeLogger(logger) {
+	const isDebug = process.env.CONTRACTSPEC_MCP_DEBUG === "1";
+	const toMessage = (args) => args.map((a) => typeof a === "string" ? a : JSON.stringify(a)).join(" ");
+	return {
+		log: (...args) => {
+			if (!isDebug) return;
+			logger.info(toMessage(args));
+		},
+		info: (...args) => {
+			if (!isDebug) return;
+			logger.info(toMessage(args));
+		},
+		warn: (...args) => {
+			logger.warn(toMessage(args));
+		},
+		error: (...args) => {
+			logger.error(toMessage(args));
+		},
+		debug: (...args) => {
+			if (!isDebug) return;
+			logger.debug(toMessage(args));
+		}
+	};
+}
+const baseCtx = {
+	actor: "anonymous",
+	decide: async () => ({ effect: "allow" })
+};
+function createMcpElysiaHandler({ logger, path, serverName, ops, resources, prompts, presentations }) {
+	logger.info("Setting up MCP handler...");
+	return mcp({
+		basePath: path,
+		logger: createConsoleLikeLogger(logger),
+		serverInfo: {
+			name: serverName,
+			version: "1.0.0"
+		},
+		stateless: process.env.CONTRACTSPEC_MCP_STATEFUL !== "1",
+		enableJsonResponse: true,
+		capabilities: {
+			tools: {},
+			resources: {},
+			prompts: {},
+			logging: {}
+		},
+		setupServer: (server) => {
+			logger.info("Setting up MCP server...");
+			createMcpServer(server, ops, resources, prompts, {
+				logger,
+				toolCtx: () => baseCtx,
+				promptCtx: () => ({ locale: "en" }),
+				resourceCtx: () => ({ locale: "en" }),
+				presentations: new PresentationRegistry(presentations)
+			});
+		}
+	});
+}
+
+//#endregion
+export { createMcpElysiaHandler };
+//# sourceMappingURL=common.js.map

package/dist/application/mcp/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":[],"sources":["../../../src/application/mcp/common.ts"],"sourcesContent":["import type {\n  OperationSpecRegistry,\n  PromptRegistry,\n  ResourceRegistry,\n} from '@contractspec/lib.contracts';\nimport {\n  createMcpServer,\n  PresentationRegistry,\n} from '@contractspec/lib.contracts';\nimport type { PresentationSpec } from '@contractspec/lib.contracts/presentations';\nimport { mcp } from 'elysia-mcp';\nimport { Logger } from '@contractspec/lib.logger';\n\nfunction createConsoleLikeLogger(logger: Logger) {\n  const isDebug = process.env.CONTRACTSPEC_MCP_DEBUG === '1';\n\n  const toMessage = (args: unknown[]) =>\n    args.map((a) => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ');\n\n  return {\n    log: (...args: unknown[]) => {\n      if (!isDebug) return;\n      logger.info(toMessage(args));\n    },\n    info: (...args: unknown[]) => {\n      if (!isDebug) return;\n      logger.info(toMessage(args));\n    },\n    warn: (...args: unknown[]) => {\n      logger.warn(toMessage(args));\n    },\n    error: (...args: unknown[]) => {\n      logger.error(toMessage(args));\n    },\n    debug: (...args: unknown[]) => {\n      if (!isDebug) return;\n      logger.debug(toMessage(args));\n    },\n  };\n}\n\ninterface McpHttpHandlerConfig {\n  path: string;\n  serverName: string;\n  ops: OperationSpecRegistry;\n  resources: ResourceRegistry;\n  prompts: PromptRegistry;\n  presentations?: PresentationSpec[];\n  logger: Logger;\n}\n\nconst baseCtx = {\n  actor: 'anonymous' as const,\n  decide: async () => ({ effect: 'allow' as const }),\n};\n\n// export function createMcpNextjsHandler({\n//   path,\n//   serverName,\n//   ops,\n//   resources,\n//   prompts,\n//   presentationsV2,\n// }: McpHttpHandlerConfig) {\n//   return createMcpHandler(\n//     (server) => {\n//       createMcpServer(server, ops, resources, prompts, {\n//         toolCtx: () => baseCtx,\n//         promptCtx: () => ({ locale: 'en' }),\n//         resourceCtx: () => ({ locale: 'en' }),\n//         presentationsV2,\n//       });\n//     },\n//     {\n//       serverInfo: {\n//         name: serverName,\n//         version: '1.0.0',\n//       },\n//     },\n//     {\n//       // basePath: path,\n//       disableSse: true,\n//       verboseLogs: true,\n//     }\n//   );\n// }\n\nexport function createMcpElysiaHandler({\n  logger,\n  path,\n  serverName,\n  ops,\n  resources,\n  prompts,\n  presentations,\n}: McpHttpHandlerConfig) {\n  logger.info('Setting up MCP handler...');\n  return mcp({\n    basePath: path,\n    // Do NOT use console.* in production paths; adapt to console-like interface for the plugin.\n    logger: createConsoleLikeLogger(logger),\n    serverInfo: {\n      name: serverName,\n      version: '1.0.0',\n    },\n    // Cursor MCP HTTP clients may not persist Mcp-Session-Id headers reliably.\n    // Run in stateless + JSON response mode by default to maximize compatibility.\n    // Set CONTRACTSPEC_MCP_STATEFUL=1 to restore sessionful behavior.\n    stateless: process.env.CONTRACTSPEC_MCP_STATEFUL !== '1',\n    enableJsonResponse: true,\n    capabilities: {\n      tools: {},\n      resources: {},\n      prompts: {},\n      logging: {},\n    },\n    setupServer: (server) => {\n      logger.info('Setting up MCP server...');\n      createMcpServer(server, ops, resources, prompts, {\n        logger,\n        toolCtx: () => baseCtx,\n        promptCtx: () => ({ locale: 'en' }),\n        resourceCtx: () => ({ locale: 'en' }),\n        presentations: new PresentationRegistry(presentations),\n      });\n    },\n  });\n}\n"],"mappings":";;;;;AAaA,SAAS,wBAAwB,QAAgB;CAC/C,MAAM,UAAU,QAAQ,IAAI,2BAA2B;CAEvD,MAAM,aAAa,SACjB,KAAK,KAAK,MAAO,OAAO,MAAM,WAAW,IAAI,KAAK,UAAU,EAAE,CAAE,CAAC,KAAK,IAAI;AAE5E,QAAO;EACL,MAAM,GAAG,SAAoB;AAC3B,OAAI,CAAC,QAAS;AACd,UAAO,KAAK,UAAU,KAAK,CAAC;;EAE9B,OAAO,GAAG,SAAoB;AAC5B,OAAI,CAAC,QAAS;AACd,UAAO,KAAK,UAAU,KAAK,CAAC;;EAE9B,OAAO,GAAG,SAAoB;AAC5B,UAAO,KAAK,UAAU,KAAK,CAAC;;EAE9B,QAAQ,GAAG,SAAoB;AAC7B,UAAO,MAAM,UAAU,KAAK,CAAC;;EAE/B,QAAQ,GAAG,SAAoB;AAC7B,OAAI,CAAC,QAAS;AACd,UAAO,MAAM,UAAU,KAAK,CAAC;;EAEhC;;AAaH,MAAM,UAAU;CACd,OAAO;CACP,QAAQ,aAAa,EAAE,QAAQ,SAAkB;CAClD;AAiCD,SAAgB,uBAAuB,EACrC,QACA,MACA,YACA,KACA,WACA,SACA,iBACuB;AACvB,QAAO,KAAK,4BAA4B;AACxC,QAAO,IAAI;EACT,UAAU;EAEV,QAAQ,wBAAwB,OAAO;EACvC,YAAY;GACV,MAAM;GACN,SAAS;GACV;EAID,WAAW,QAAQ,IAAI,8BAA8B;EACrD,oBAAoB;EACpB,cAAc;GACZ,OAAO,EAAE;GACT,WAAW,EAAE;GACb,SAAS,EAAE;GACX,SAAS,EAAE;GACZ;EACD,cAAc,WAAW;AACvB,UAAO,KAAK,2BAA2B;AACvC,mBAAgB,QAAQ,KAAK,WAAW,SAAS;IAC/C;IACA,eAAe;IACf,kBAAkB,EAAE,QAAQ,MAAM;IAClC,oBAAoB,EAAE,QAAQ,MAAM;IACpC,eAAe,IAAI,qBAAqB,cAAc;IACvD,CAAC;;EAEL,CAAC"}

package/dist/application/mcp/docsMcp.d.ts

@@ -0,0 +1,100 @@
+import * as _modelcontextprotocol_sdk_types_js0 from "@modelcontextprotocol/sdk/types.js";
+import * as elysia from "elysia";
+
+//#region src/application/mcp/docsMcp.d.ts
+declare function createDocsMcpHandler(path?: string): elysia.default<"", {
+  decorator: {};
+  store: {
+    authInfo: AuthInfo | undefined;
+  };
+  derive: {};
+  resolve: {};
+}, {
+  typebox: {};
+  error: {};
+}, {
+  schema: {};
+  standaloneSchema: {};
+  macro: {};
+  macroFn: {};
+  parser: {};
+  response: {};
+}, {
+  [x: string]: {
+    "*": {
+      [x: string]: {
+        body: unknown;
+        params: {
+          "*": string;
+        } & {};
+        query: unknown;
+        headers: unknown;
+        response: {
+          200: {} | {
+            jsonrpc: string;
+            error: {
+              code: _modelcontextprotocol_sdk_types_js0.ErrorCode;
+              message: string;
+              data: string;
+            };
+            id: null;
+          };
+          422: {
+            type: "validation";
+            on: string;
+            summary?: string;
+            message?: string;
+            found?: unknown;
+            property?: string;
+            expected?: string;
+          };
+        };
+      };
+    };
+  };
+} & {
+  [x: string]: {
+    [x: string]: {
+      body: unknown;
+      params: {};
+      query: unknown;
+      headers: unknown;
+      response: {
+        200: {} | {
+          jsonrpc: string;
+          error: {
+            code: _modelcontextprotocol_sdk_types_js0.ErrorCode;
+            message: string;
+            data: string;
+          };
+          id: null;
+        };
+      };
+    };
+  };
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {};
+}, {
+  derive: {};
+  resolve: {};
+  schema: {};
+  standaloneSchema: {};
+  response: {
+    200: {} | {
+      jsonrpc: string;
+      error: {
+        code: _modelcontextprotocol_sdk_types_js0.ErrorCode;
+        message: string;
+        data: string;
+      };
+      id: null;
+    };
+  };
+}>;
+//#endregion
+export { createDocsMcpHandler };
+//# sourceMappingURL=docsMcp.d.ts.map

package/dist/application/mcp/docsMcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsMcp.d.ts","names":[],"sources":["../../../src/application/mcp/docsMcp.ts"],"mappings":";;;;iBAoLgB,oBAAA,CAAqB,IAAA,mBAAsB,OAAA"}