@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/application/mcp/docsMcp.js

@@ -0,0 +1,145 @@
+import { docsSearchSpec } from "../../features/docs/docs.contracts.js";
+import "../../features/docs/index.js";
+import { createMcpElysiaHandler } from "./common.js";
+import { appLogger } from "../../infrastructure/elysia/logger.js";
+import { OperationSpecRegistry, PromptRegistry, ResourceRegistry, defaultDocRegistry, definePrompt, defineResourceTemplate, installOp } from "@contractspec/lib.contracts";
+import z from "zod";
+
+//#region src/application/mcp/docsMcp.ts
+const DOC_OWNERS = ["@contractspec"];
+const DOC_TAGS = ["docs", "mcp"];
+function buildDocResources(routes) {
+	const resources = new ResourceRegistry();
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "docs://list",
+			title: "DocBlocks index",
+			description: "All registered DocBlocks with route, visibility, tags, and summary.",
+			mimeType: "application/json",
+			tags: DOC_TAGS
+		},
+		input: z.object({}),
+		resolve: async () => {
+			const docs = routes.map(({ block, route }) => ({
+				id: block.id,
+				title: block.title,
+				summary: block.summary ?? "",
+				tags: block.tags ?? [],
+				visibility: block.visibility ?? "public",
+				route
+			}));
+			return {
+				uri: "docs://list",
+				mimeType: "application/json",
+				data: JSON.stringify(docs, null, 2)
+			};
+		}
+	}));
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "docs://doc/{id}",
+			title: "DocBlock markdown",
+			description: "Fetch DocBlock body by id as markdown.",
+			mimeType: "text/markdown",
+			tags: DOC_TAGS
+		},
+		input: z.object({ id: z.string() }),
+		resolve: async ({ id }) => {
+			const found = defaultDocRegistry.get(id);
+			if (!found) return {
+				uri: `docs://doc/${encodeURIComponent(id)}`,
+				mimeType: "text/plain",
+				data: `DocBlock not found: ${id}`
+			};
+			return {
+				uri: `docs://doc/${encodeURIComponent(id)}`,
+				mimeType: "text/markdown",
+				data: String(found.block.body ?? "")
+			};
+		}
+	}));
+	return resources;
+}
+function buildDocPrompts() {
+	const prompts = new PromptRegistry();
+	prompts.register(definePrompt({
+		meta: {
+			key: "docs.navigator",
+			version: "1.0.0",
+			title: "Find relevant ContractSpec docs",
+			description: "Guide agents to pick the right DocBlock by topic or tag.",
+			tags: DOC_TAGS,
+			stability: "beta",
+			owners: DOC_OWNERS
+		},
+		args: [{
+			name: "topic",
+			description: "Goal or subject to search for.",
+			required: false,
+			schema: z.string().optional()
+		}, {
+			name: "tag",
+			description: "Optional tag filter.",
+			required: false,
+			schema: z.string().optional()
+		}],
+		input: z.object({
+			topic: z.string().optional(),
+			tag: z.string().optional()
+		}),
+		render: async ({ topic, tag }) => {
+			return [{
+				type: "text",
+				text: `Use the docs index to choose DocBlocks. If a specific topic is provided, prefer docs whose id/title/summary match it.${topic ? ` Topic: ${topic}.` : ""}${tag ? ` Tag: ${tag}.` : ""}`
+			}, {
+				type: "resource",
+				uri: "docs://list",
+				title: "DocBlocks index"
+			}];
+		}
+	}));
+	return prompts;
+}
+function buildDocOps(routes) {
+	const registry = new OperationSpecRegistry();
+	installOp(registry, docsSearchSpec, async (args) => {
+		const query = args.query?.toLowerCase().trim();
+		const tagsFilter = args.tag?.map((t) => t.toLowerCase().trim()) ?? [];
+		const visibility = args.visibility?.toLowerCase().trim();
+		const docs = routes.map(({ block, route }) => ({
+			id: block.id,
+			title: block.title,
+			summary: block.summary ?? "",
+			tags: block.tags ?? [],
+			visibility: (block.visibility ?? "public").toLowerCase(),
+			route
+		})).filter((doc) => {
+			const matchesQuery = query ? doc.id.toLowerCase().includes(query) || doc.title.toLowerCase().includes(query) || doc.summary.toLowerCase().includes(query) : true;
+			const matchesTags = tagsFilter.length ? tagsFilter.every((t) => doc.tags.some((tag) => tag.toLowerCase().includes(t))) : true;
+			const matchesVisibility = visibility ? doc.visibility === visibility : true;
+			return matchesQuery && matchesTags && matchesVisibility;
+		});
+		return {
+			docs,
+			items: docs,
+			total: docs.length
+		};
+	});
+	return registry;
+}
+function createDocsMcpHandler(path = "/api/mcp/docs") {
+	const routes = defaultDocRegistry.list();
+	return createMcpElysiaHandler({
+		logger: appLogger,
+		path,
+		serverName: "contractspec-docs-mcp",
+		ops: buildDocOps(routes),
+		resources: buildDocResources(routes),
+		prompts: buildDocPrompts(),
+		presentations: routes.map(({ descriptor }) => descriptor)
+	});
+}
+
+//#endregion
+export { createDocsMcpHandler };
+//# sourceMappingURL=docsMcp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docsMcp.js","names":[],"sources":["../../../src/application/mcp/docsMcp.ts"],"sourcesContent":["import {\n  defaultDocRegistry,\n  definePrompt,\n  defineResourceTemplate,\n  installOp,\n  OperationSpecRegistry,\n  PromptRegistry,\n  ResourceRegistry,\n} from '@contractspec/lib.contracts';\nimport z from 'zod';\nimport type { DocPresentationRoute } from '@contractspec/lib.contracts/docs';\nimport { createMcpElysiaHandler } from './common';\nimport { appLogger } from '../../infrastructure/elysia/logger';\nimport { docsSearchSpec } from '../../features/docs';\n\nconst DOC_OWNERS = ['@contractspec'];\nconst DOC_TAGS = ['docs', 'mcp'];\n\nfunction buildDocResources(routes: DocPresentationRoute[]) {\n  const resources = new ResourceRegistry();\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'docs://list',\n        title: 'DocBlocks index',\n        description:\n          'All registered DocBlocks with route, visibility, tags, and summary.',\n        mimeType: 'application/json',\n        tags: DOC_TAGS,\n      },\n      input: z.object({}),\n      resolve: async () => {\n        const docs = routes.map(({ block, route }) => ({\n          id: block.id,\n          title: block.title,\n          summary: block.summary ?? '',\n          tags: block.tags ?? [],\n          visibility: block.visibility ?? 'public',\n          route,\n        }));\n\n        return {\n          uri: 'docs://list',\n          mimeType: 'application/json',\n          data: JSON.stringify(docs, null, 2),\n        };\n      },\n    })\n  );\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'docs://doc/{id}',\n        title: 'DocBlock markdown',\n        description: 'Fetch DocBlock body by id as markdown.',\n        mimeType: 'text/markdown',\n        tags: DOC_TAGS,\n      },\n      input: z.object({ id: z.string() }),\n      resolve: async ({ id }) => {\n        const found = defaultDocRegistry.get(id);\n        if (!found) {\n          return {\n            uri: `docs://doc/${encodeURIComponent(id)}`,\n            mimeType: 'text/plain',\n            data: `DocBlock not found: ${id}`,\n          };\n        }\n\n        return {\n          uri: `docs://doc/${encodeURIComponent(id)}`,\n          mimeType: 'text/markdown',\n          data: String(found.block.body ?? ''),\n        };\n      },\n    })\n  );\n\n  return resources;\n}\n\nfunction buildDocPrompts() {\n  const prompts = new PromptRegistry();\n\n  prompts.register(\n    definePrompt({\n      meta: {\n        key: 'docs.navigator',\n        version: '1.0.0',\n        title: 'Find relevant ContractSpec docs',\n        description: 'Guide agents to pick the right DocBlock by topic or tag.',\n        tags: DOC_TAGS,\n        stability: 'beta',\n        owners: DOC_OWNERS,\n      },\n      args: [\n        {\n          name: 'topic',\n          description: 'Goal or subject to search for.',\n          required: false,\n          schema: z.string().optional(),\n        },\n        {\n          name: 'tag',\n          description: 'Optional tag filter.',\n          required: false,\n          schema: z.string().optional(),\n        },\n      ],\n      input: z.object({\n        topic: z.string().optional(),\n        tag: z.string().optional(),\n      }),\n      render: async ({ topic, tag }) => {\n        const parts = [\n          {\n            type: 'text' as const,\n            text: `Use the docs index to choose DocBlocks. If a specific topic is provided, prefer docs whose id/title/summary match it.${topic ? ` Topic: ${topic}.` : ''}${tag ? ` Tag: ${tag}.` : ''}`,\n          },\n          {\n            type: 'resource' as const,\n            uri: 'docs://list',\n            title: 'DocBlocks index',\n          },\n        ];\n        return parts;\n      },\n    })\n  );\n\n  return prompts;\n}\n\nfunction buildDocOps(routes: DocPresentationRoute[]) {\n  const registry = new OperationSpecRegistry();\n\n  // Use the module-level spec from docs.contracts.ts\n  installOp(registry, docsSearchSpec, async (args) => {\n    const query = args.query?.toLowerCase().trim();\n    const tagsFilter = args.tag?.map((t) => t.toLowerCase().trim()) ?? [];\n    const visibility = args.visibility?.toLowerCase().trim();\n\n    const docs = routes\n      .map(({ block, route }) => ({\n        id: block.id,\n        title: block.title,\n        summary: block.summary ?? '',\n        tags: block.tags ?? [],\n        visibility: (block.visibility ?? 'public').toLowerCase(),\n        route,\n      }))\n      .filter((doc) => {\n        const matchesQuery = query\n          ? doc.id.toLowerCase().includes(query) ||\n            doc.title.toLowerCase().includes(query) ||\n            doc.summary.toLowerCase().includes(query)\n          : true;\n        const matchesTags = tagsFilter.length\n          ? tagsFilter.every((t) =>\n              doc.tags.some((tag) => tag.toLowerCase().includes(t))\n            )\n          : true;\n        const matchesVisibility = visibility\n          ? doc.visibility === visibility\n          : true;\n        return matchesQuery && matchesTags && matchesVisibility;\n      });\n\n    return {\n      docs,\n      items: docs,\n      total: docs.length,\n    };\n  });\n\n  return registry;\n}\n\nexport function createDocsMcpHandler(path = '/api/mcp/docs') {\n  const routes = defaultDocRegistry.list();\n\n  return createMcpElysiaHandler({\n    logger: appLogger,\n    path,\n    serverName: 'contractspec-docs-mcp',\n    ops: buildDocOps(routes),\n    resources: buildDocResources(routes),\n    prompts: buildDocPrompts(),\n    presentations: routes.map(({ descriptor }) => descriptor),\n  });\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+import { createDocsMcpHandler } from "./docsMcp.js";
+import { createCliMcpHandler } from "./cliMcp.js";
+import { createInternalMcpHandler } from "./internalMcp.js";
+export { createCliMcpHandler, createDocsMcpHandler, createInternalMcpHandler };

package/dist/application/mcp/index.js

@@ -0,0 +1,5 @@
+import { createDocsMcpHandler } from "./docsMcp.js";
+import { createCliMcpHandler } from "./cliMcp.js";
+import { createInternalMcpHandler } from "./internalMcp.js";
+
+export { createCliMcpHandler, createDocsMcpHandler, createInternalMcpHandler };

package/dist/application/mcp/internalMcp.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/internalMcp.d.ts
+declare function createInternalMcpHandler(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 { createInternalMcpHandler };
+//# sourceMappingURL=internalMcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internalMcp.d.ts","names":[],"sources":["../../../src/application/mcp/internalMcp.ts"],"mappings":";;;;iBAyNgB,wBAAA,CAAyB,IAAA,mBAA0B,OAAA"}

package/dist/application/mcp/internalMcp.js

@@ -0,0 +1,182 @@
+import { createMcpElysiaHandler } from "./common.js";
+import { appLogger } from "../../infrastructure/elysia/logger.js";
+import { getExample, listExamples, searchExamples } from "@contractspec/module.examples";
+import { OperationSpecRegistry, PromptRegistry, ResourceRegistry, defineCommand, definePrompt, defineResourceTemplate, installOp } from "@contractspec/lib.contracts";
+import z from "zod";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/application/mcp/internalMcp.ts
+const INTERNAL_TAGS = ["internal", "mcp"];
+const INTERNAL_OWNERS = ["@contractspec"];
+const ENDPOINTS = {
+	docs: "/api/mcp/docs",
+	cli: "/api/mcp/cli",
+	internal: "/api/mcp/internal",
+	graphql: "/graphql",
+	health: "/health"
+};
+function buildInternalResources() {
+	const resources = new ResourceRegistry();
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "examples://list{?q}",
+			title: "ContractSpec examples registry",
+			description: "List available examples (templates, integrations, knowledge, scripts). Optional query `q` filters results.",
+			mimeType: "application/json",
+			tags: ["examples", ...INTERNAL_TAGS]
+		},
+		input: z.object({ q: z.string().optional() }),
+		resolve: async ({ q }) => {
+			const items = q ? searchExamples(q) : [...listExamples()];
+			return {
+				uri: q ? `examples://list?q=${encodeURIComponent(q)}` : "examples://list",
+				mimeType: "application/json",
+				data: JSON.stringify(items, null, 2)
+			};
+		}
+	}));
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "examples://example/{id}",
+			title: "ContractSpec example (by id)",
+			description: "Fetch a single example manifest by id.",
+			mimeType: "application/json",
+			tags: ["examples", ...INTERNAL_TAGS]
+		},
+		input: z.object({ id: z.string().min(1) }),
+		resolve: async ({ id }) => {
+			const example = getExample(id);
+			if (!example) return {
+				uri: `examples://example/${encodeURIComponent(id)}`,
+				mimeType: "application/json",
+				data: JSON.stringify({
+					error: "not_found",
+					id,
+					message: `Unknown example id: ${id}`
+				}, null, 2)
+			};
+			return {
+				uri: `examples://example/${encodeURIComponent(id)}`,
+				mimeType: "application/json",
+				data: JSON.stringify(example, null, 2)
+			};
+		}
+	}));
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "internal://endpoints",
+			title: "ContractSpec MCP endpoints",
+			description: "Endpoints for docs, CLI, internal MCP servers.",
+			mimeType: "application/json",
+			tags: INTERNAL_TAGS
+		},
+		input: z.object({}),
+		resolve: async () => ({
+			uri: "internal://endpoints",
+			mimeType: "application/json",
+			data: JSON.stringify(ENDPOINTS, null, 2)
+		})
+	}));
+	resources.register(defineResourceTemplate({
+		meta: {
+			uriTemplate: "internal://playbook",
+			title: "Internal MCP usage playbook",
+			description: "How internal agents should discover docs, CLI usage, and endpoints.",
+			mimeType: "text/markdown",
+			tags: INTERNAL_TAGS
+		},
+		input: z.object({}),
+		resolve: async () => ({
+			uri: "internal://playbook",
+			mimeType: "text/markdown",
+			data: [
+				"# Internal MCP playbook",
+				"- Connect to docs MCP first for canonical specs.",
+				"- Use CLI MCP to surface quickstart/reference before running commands.",
+				"- Keep calls read-only unless explicitly approved.",
+				`- Endpoints: ${ENDPOINTS.docs}, ${ENDPOINTS.cli}, ${ENDPOINTS.internal}.`,
+				"- For API work, GraphQL at /graphql; health at /health."
+			].join("\n")
+		})
+	}));
+	return resources;
+}
+function buildInternalPrompts() {
+	const prompts = new PromptRegistry();
+	prompts.register(definePrompt({
+		meta: {
+			key: "internal.bootstrap",
+			version: "1.0.0",
+			title: "Bootstrap internal ContractSpec agent",
+			description: "Points agents to the correct MCP endpoints and guardrails.",
+			tags: INTERNAL_TAGS,
+			owners: INTERNAL_OWNERS,
+			stability: "beta"
+		},
+		args: [],
+		input: z.object({}),
+		render: async () => [{
+			type: "text",
+			text: "Start with internal://endpoints to pick the right MCP. Use docs MCP for specifications and CLI MCP for commands. Keep actions read-only unless explicitly approved."
+		}, {
+			type: "resource",
+			uri: "internal://endpoints",
+			title: "Endpoints"
+		}]
+	}));
+	return prompts;
+}
+function buildInternalOps() {
+	const registry = new OperationSpecRegistry();
+	const InternalDescribeOutput = defineSchemaModel({
+		name: "InternalDescribeOutput",
+		fields: {
+			endpoints: {
+				type: ScalarTypeEnum.JSONObject(),
+				isOptional: false
+			},
+			notes: {
+				type: ScalarTypeEnum.String_unsecure(),
+				isOptional: false
+			}
+		}
+	});
+	installOp(registry, defineCommand({
+		meta: {
+			key: "internal.describe",
+			version: "1.0.0",
+			stability: "stable",
+			owners: INTERNAL_OWNERS,
+			tags: INTERNAL_TAGS,
+			description: "Return MCP endpoints and guidance for internal ContractSpec agents.",
+			goal: "Speed up internal development with the correct MCP entrypoints.",
+			context: "Used by internal MCP surface; read-only."
+		},
+		io: {
+			input: defineSchemaModel({
+				name: "InternalDescribeInput",
+				fields: {}
+			}),
+			output: InternalDescribeOutput
+		},
+		policy: { auth: "anonymous" }
+	}), async () => ({
+		endpoints: ENDPOINTS,
+		notes: "Use docs MCP for canonical specs, CLI MCP for contractspec commands, and keep side-effecting actions gated behind human review."
+	}));
+	return registry;
+}
+function createInternalMcpHandler(path = "/api/mcp/internal") {
+	return createMcpElysiaHandler({
+		logger: appLogger,
+		path,
+		serverName: "contractspec-internal-mcp",
+		ops: buildInternalOps(),
+		resources: buildInternalResources(),
+		prompts: buildInternalPrompts()
+	});
+}
+
+//#endregion
+export { createInternalMcpHandler };
+//# sourceMappingURL=internalMcp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internalMcp.js","names":[],"sources":["../../../src/application/mcp/internalMcp.ts"],"sourcesContent":["import {\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';\nimport {\n  getExample,\n  listExamples,\n  searchExamples,\n} from '@contractspec/module.examples';\n\nconst INTERNAL_TAGS = ['internal', 'mcp'];\nconst INTERNAL_OWNERS = ['@contractspec'];\n\nconst ENDPOINTS = {\n  docs: '/api/mcp/docs',\n  cli: '/api/mcp/cli',\n  internal: '/api/mcp/internal',\n  graphql: '/graphql',\n  health: '/health',\n};\n\nfunction buildInternalResources() {\n  const resources = new ResourceRegistry();\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'examples://list{?q}',\n        title: 'ContractSpec examples registry',\n        description:\n          'List available examples (templates, integrations, knowledge, scripts). Optional query `q` filters results.',\n        mimeType: 'application/json',\n        tags: ['examples', ...INTERNAL_TAGS],\n      },\n      input: z.object({ q: z.string().optional() }),\n      resolve: async ({ q }) => {\n        const items = q ? searchExamples(q) : [...listExamples()];\n        return {\n          uri: q\n            ? `examples://list?q=${encodeURIComponent(q)}`\n            : 'examples://list',\n          mimeType: 'application/json',\n          data: JSON.stringify(items, null, 2),\n        };\n      },\n    })\n  );\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'examples://example/{id}',\n        title: 'ContractSpec example (by id)',\n        description: 'Fetch a single example manifest by id.',\n        mimeType: 'application/json',\n        tags: ['examples', ...INTERNAL_TAGS],\n      },\n      input: z.object({ id: z.string().min(1) }),\n      resolve: async ({ id }) => {\n        const example = getExample(id);\n        if (!example) {\n          return {\n            uri: `examples://example/${encodeURIComponent(id)}`,\n            mimeType: 'application/json',\n            data: JSON.stringify(\n              { error: 'not_found', id, message: `Unknown example id: ${id}` },\n              null,\n              2\n            ),\n          };\n        }\n        return {\n          uri: `examples://example/${encodeURIComponent(id)}`,\n          mimeType: 'application/json',\n          data: JSON.stringify(example, null, 2),\n        };\n      },\n    })\n  );\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'internal://endpoints',\n        title: 'ContractSpec MCP endpoints',\n        description: 'Endpoints for docs, CLI, internal MCP servers.',\n        mimeType: 'application/json',\n        tags: INTERNAL_TAGS,\n      },\n      input: z.object({}),\n      resolve: async () => ({\n        uri: 'internal://endpoints',\n        mimeType: 'application/json',\n        data: JSON.stringify(ENDPOINTS, null, 2),\n      }),\n    })\n  );\n\n  resources.register(\n    defineResourceTemplate({\n      meta: {\n        uriTemplate: 'internal://playbook',\n        title: 'Internal MCP usage playbook',\n        description:\n          'How internal agents should discover docs, CLI usage, and endpoints.',\n        mimeType: 'text/markdown',\n        tags: INTERNAL_TAGS,\n      },\n      input: z.object({}),\n      resolve: async () => ({\n        uri: 'internal://playbook',\n        mimeType: 'text/markdown',\n        data: [\n          '# Internal MCP playbook',\n          '- Connect to docs MCP first for canonical specs.',\n          '- Use CLI MCP to surface quickstart/reference before running commands.',\n          '- Keep calls read-only unless explicitly approved.',\n          `- Endpoints: ${ENDPOINTS.docs}, ${ENDPOINTS.cli}, ${ENDPOINTS.internal}.`,\n          '- For API work, GraphQL at /graphql; health at /health.',\n        ].join('\\n'),\n      }),\n    })\n  );\n\n  return resources;\n}\n\nfunction buildInternalPrompts() {\n  const prompts = new PromptRegistry();\n\n  prompts.register(\n    definePrompt({\n      meta: {\n        key: 'internal.bootstrap',\n        version: '1.0.0',\n        title: 'Bootstrap internal ContractSpec agent',\n        description:\n          'Points agents to the correct MCP endpoints and guardrails.',\n        tags: INTERNAL_TAGS,\n        owners: INTERNAL_OWNERS,\n        stability: 'beta',\n      },\n      args: [],\n      input: z.object({}),\n      render: async () => [\n        {\n          type: 'text',\n          text: 'Start with internal://endpoints to pick the right MCP. Use docs MCP for specifications and CLI MCP for commands. Keep actions read-only unless explicitly approved.',\n        },\n        {\n          type: 'resource' as const,\n          uri: 'internal://endpoints',\n          title: 'Endpoints',\n        },\n      ],\n    })\n  );\n\n  return prompts;\n}\n\nfunction buildInternalOps() {\n  const registry = new OperationSpecRegistry();\n\n  const InternalDescribeOutput = defineSchemaModel({\n    name: 'InternalDescribeOutput',\n    fields: {\n      endpoints: {\n        type: ScalarTypeEnum.JSONObject(),\n        isOptional: false,\n      },\n      notes: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    },\n  });\n\n  const describeSpec = defineCommand({\n    meta: {\n      key: 'internal.describe',\n      version: '1.0.0',\n      stability: 'stable',\n      owners: INTERNAL_OWNERS,\n      tags: INTERNAL_TAGS,\n      description:\n        'Return MCP endpoints and guidance for internal ContractSpec agents.',\n      goal: 'Speed up internal development with the correct MCP entrypoints.',\n      context: 'Used by internal MCP surface; read-only.',\n    },\n    io: {\n      input: defineSchemaModel({\n        name: 'InternalDescribeInput',\n        fields: {},\n      }),\n      output: InternalDescribeOutput,\n    },\n    policy: {\n      auth: 'anonymous',\n    },\n  });\n\n  installOp(registry, describeSpec, async () => ({\n    endpoints: ENDPOINTS,\n    notes:\n      'Use docs MCP for canonical specs, CLI MCP for contractspec commands, and keep side-effecting actions gated behind human review.',\n  }));\n\n  return registry;\n}\n\nexport function createInternalMcpHandler(path = '/api/mcp/internal') {\n  return createMcpElysiaHandler({\n    logger: appLogger,\n    path,\n    serverName: 'contractspec-internal-mcp',\n    ops: buildInternalOps(),\n    resources: buildInternalResources(),\n    prompts: buildInternalPrompts(),\n  });\n}\n"],"mappings":"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"}

package/dist/components/docs/DocsIndexPage.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/DocsIndexPage.d.ts
+declare function DocsIndexPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsIndexPage };
+//# sourceMappingURL=DocsIndexPage.d.ts.map

package/dist/components/docs/DocsIndexPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsIndexPage.d.ts","names":[],"sources":["../../../src/components/docs/DocsIndexPage.tsx"],"mappings":";;;iBA6BgB,aAAA,CAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA"}