@contractspec/bundle.library 1.12.0 → 1.14.0

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"internalMcp.d.ts","names":[],"sources":["../../../src/application/mcp/internalMcp.ts"],"mappings":";;;;iBAyNgB,wBAAA,CAAyB,IAAA,mBAA0B,OAAA"}
+{"version":3,"file":"internalMcp.d.ts","sourceRoot":"","sources":["../../../src/application/mcp/internalMcp.ts"],"names":[],"mappings":"AAyNA,wBAAgB,wBAAwB,CAAC,IAAI,SAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAUirF,CAAC;+BAAuB,CAAC;6BAAqB,CAAC;gCAAyB,CAAC;gCAAwB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GADr1F"}

package/dist/application/mcp/internalMcp.js

@@ -1,182 +1,295 @@
-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";
+// @bun
+// src/application/mcp/common.ts
+import {
+  createMcpServer,
+  PresentationRegistry
+} from "@contractspec/lib.contracts";
+import { mcp } from "elysia-mcp";
+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));
+    }
+  };
+}
+var 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)
+      });
+    }
+  });
+}
 
-//#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"
+// src/infrastructure/elysia/logger.ts
+import { Logger, LogLevel } from "@contractspec/lib.logger";
+var createAppLogger = () => new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableTracing: true,
+  enableTiming: true,
+  enableContext: true,
+  enableColors: true
+});
+var appLogger = createAppLogger();
+var dbLogger = new Logger({
+  level: LogLevel.DEBUG,
+  environment: "development",
+  enableTracing: true,
+  enableTiming: true,
+  enableContext: true,
+  enableColors: true
+});
+var authLogger = new Logger({
+  level: LogLevel.INFO,
+  environment: "development",
+  enableTracing: true,
+  enableTiming: true,
+  enableContext: true,
+  enableColors: true
+});
+// src/application/mcp/internalMcp.ts
+import {
+  defineCommand,
+  definePrompt,
+  defineResourceTemplate,
+  installOp,
+  OperationSpecRegistry,
+  PromptRegistry,
+  ResourceRegistry
+} from "@contractspec/lib.contracts";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+import z from "zod";
+import {
+  getExample,
+  listExamples,
+  searchExamples
+} from "@contractspec/module.examples";
+var INTERNAL_TAGS = ["internal", "mcp"];
+var INTERNAL_OWNERS = ["@contractspec"];
+var 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;
+  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(`
+`)
+    })
+  }));
+  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;
+  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;
+  const registry = new OperationSpecRegistry;
+  const InternalDescribeOutput = defineSchemaModel({
+    name: "InternalDescribeOutput",
+    fields: {
+      endpoints: {
+        type: ScalarTypeEnum.JSONObject(),
+        isOptional: false
+      },
+      notes: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+    }
+  });
+  const describeSpec = 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"
+    }
+  });
+  installOp(registry, describeSpec, 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()
-	});
+  return createMcpElysiaHandler({
+    logger: appLogger,
+    path,
+    serverName: "contractspec-internal-mcp",
+    ops: buildInternalOps(),
+    resources: buildInternalResources(),
+    prompts: buildInternalPrompts()
+  });
 }
-
-//#endregion
-export { createInternalMcpHandler };
-//# sourceMappingURL=internalMcp.js.map
+export {
+  createInternalMcpHandler
+};

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

@@ -1,7 +1,2 @@
-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 };
+export declare function DocsIndexPage(): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=DocsIndexPage.d.ts.map

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

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