@contractspec/bundle.library 2.5.0 → 2.6.0

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

@@ -1,72 +1,161 @@
 // src/application/mcp/common.ts
 import { PresentationRegistry } from "@contractspec/lib.contracts-spec/presentations";
 import { createMcpServer } from "@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";
-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));
-    }
-  };
-}
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { Elysia } from "elysia";
+import { randomUUID } from "node:crypto";
 var baseCtx = {
   actor: "anonymous",
   decide: async () => ({ effect: "allow" })
 };
-function createMcpElysiaHandler({
+function createJsonRpcErrorResponse(status, code, message, data) {
+  return new Response(JSON.stringify({
+    jsonrpc: "2.0",
+    error: {
+      code,
+      message,
+      ...data ? { data } : {}
+    },
+    id: null
+  }), {
+    status,
+    headers: {
+      "content-type": "application/json"
+    }
+  });
+}
+function createSessionState({
   logger,
-  path,
   serverName,
   ops,
   resources,
   prompts,
-  presentations
+  presentations,
+  stateful
 }) {
-  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,
+  const server = new McpServer({
+    name: serverName,
+    version: "1.0.0"
+  }, {
     capabilities: {
       tools: {},
       resources: {},
       prompts: {},
       logging: {}
-    },
-    setupServer: (server) => {
-      logger.info("Setting up MCP server...");
-      createMcpServer(server, ops, resources, prompts, {
+    }
+  });
+  logger.info("Setting up MCP server...");
+  createMcpServer(server, ops, resources, prompts, {
+    logger,
+    toolCtx: () => baseCtx,
+    promptCtx: () => ({ locale: "en" }),
+    resourceCtx: () => ({ locale: "en" }),
+    presentations: new PresentationRegistry(presentations)
+  });
+  const transport = new WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: stateful ? () => randomUUID() : undefined,
+    enableJsonResponse: true
+  });
+  return server.connect(transport).then(() => ({ server, transport }));
+}
+async function closeSessionState(state) {
+  await Promise.allSettled([state.transport.close(), state.server.close()]);
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function createMcpElysiaHandler({
+  logger,
+  path,
+  serverName,
+  ops,
+  resources,
+  prompts,
+  presentations
+}) {
+  logger.info("Setting up MCP handler...");
+  const isStateful = process.env.CONTRACTSPEC_MCP_STATEFUL === "1";
+  const sessions = new Map;
+  async function handleStateless(request) {
+    const state = await createSessionState({
+      logger,
+      path,
+      serverName,
+      ops,
+      resources,
+      prompts,
+      presentations,
+      stateful: false
+    });
+    try {
+      return await state.transport.handleRequest(request);
+    } finally {
+      await closeSessionState(state);
+    }
+  }
+  async function closeSession(sessionId) {
+    const state = sessions.get(sessionId);
+    if (!state)
+      return;
+    sessions.delete(sessionId);
+    await closeSessionState(state);
+  }
+  async function handleStateful(request) {
+    const requestedSessionId = request.headers.get("mcp-session-id");
+    let state;
+    let createdState = false;
+    if (requestedSessionId) {
+      const existing = sessions.get(requestedSessionId);
+      if (!existing) {
+        return createJsonRpcErrorResponse(404, -32001, "Session not found");
+      }
+      state = existing;
+    } else {
+      state = await createSessionState({
         logger,
-        toolCtx: () => baseCtx,
-        promptCtx: () => ({ locale: "en" }),
-        resourceCtx: () => ({ locale: "en" }),
-        presentations: new PresentationRegistry(presentations)
+        path,
+        serverName,
+        ops,
+        resources,
+        prompts,
+        presentations,
+        stateful: true
+      });
+      createdState = true;
+    }
+    try {
+      const response = await state.transport.handleRequest(request);
+      const activeSessionId = state.transport.sessionId;
+      if (activeSessionId && !sessions.has(activeSessionId)) {
+        sessions.set(activeSessionId, state);
+      }
+      if (request.method === "DELETE" && activeSessionId) {
+        await closeSession(activeSessionId);
+      } else if (!activeSessionId && createdState) {
+        await closeSessionState(state);
+      }
+      return response;
+    } catch (error) {
+      if (createdState) {
+        await closeSessionState(state);
+      }
+      throw error;
+    }
+  }
+  return new Elysia({ name: `mcp-${serverName}` }).all(path, async ({ request }) => {
+    try {
+      if (isStateful) {
+        return await handleStateful(request);
+      }
+      return await handleStateless(request);
+    } catch (error) {
+      logger.error("Error handling MCP request", {
+        path,
+        method: request.method,
+        error: toErrorMessage(error)
       });
+      return createJsonRpcErrorResponse(500, -32000, "Internal error");
     }
   });
 }

package/dist/node/application/mcp/index.js

@@ -1,72 +1,161 @@
 // src/application/mcp/common.ts
 import { PresentationRegistry } from "@contractspec/lib.contracts-spec/presentations";
 import { createMcpServer } from "@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";
-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));
-    }
-  };
-}
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { Elysia } from "elysia";
+import { randomUUID } from "node:crypto";
 var baseCtx = {
   actor: "anonymous",
   decide: async () => ({ effect: "allow" })
 };
-function createMcpElysiaHandler({
+function createJsonRpcErrorResponse(status, code, message, data) {
+  return new Response(JSON.stringify({
+    jsonrpc: "2.0",
+    error: {
+      code,
+      message,
+      ...data ? { data } : {}
+    },
+    id: null
+  }), {
+    status,
+    headers: {
+      "content-type": "application/json"
+    }
+  });
+}
+function createSessionState({
   logger,
-  path,
   serverName,
   ops,
   resources,
   prompts,
-  presentations
+  presentations,
+  stateful
 }) {
-  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,
+  const server = new McpServer({
+    name: serverName,
+    version: "1.0.0"
+  }, {
     capabilities: {
       tools: {},
       resources: {},
       prompts: {},
       logging: {}
-    },
-    setupServer: (server) => {
-      logger.info("Setting up MCP server...");
-      createMcpServer(server, ops, resources, prompts, {
+    }
+  });
+  logger.info("Setting up MCP server...");
+  createMcpServer(server, ops, resources, prompts, {
+    logger,
+    toolCtx: () => baseCtx,
+    promptCtx: () => ({ locale: "en" }),
+    resourceCtx: () => ({ locale: "en" }),
+    presentations: new PresentationRegistry(presentations)
+  });
+  const transport = new WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: stateful ? () => randomUUID() : undefined,
+    enableJsonResponse: true
+  });
+  return server.connect(transport).then(() => ({ server, transport }));
+}
+async function closeSessionState(state) {
+  await Promise.allSettled([state.transport.close(), state.server.close()]);
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function createMcpElysiaHandler({
+  logger,
+  path,
+  serverName,
+  ops,
+  resources,
+  prompts,
+  presentations
+}) {
+  logger.info("Setting up MCP handler...");
+  const isStateful = process.env.CONTRACTSPEC_MCP_STATEFUL === "1";
+  const sessions = new Map;
+  async function handleStateless(request) {
+    const state = await createSessionState({
+      logger,
+      path,
+      serverName,
+      ops,
+      resources,
+      prompts,
+      presentations,
+      stateful: false
+    });
+    try {
+      return await state.transport.handleRequest(request);
+    } finally {
+      await closeSessionState(state);
+    }
+  }
+  async function closeSession(sessionId) {
+    const state = sessions.get(sessionId);
+    if (!state)
+      return;
+    sessions.delete(sessionId);
+    await closeSessionState(state);
+  }
+  async function handleStateful(request) {
+    const requestedSessionId = request.headers.get("mcp-session-id");
+    let state;
+    let createdState = false;
+    if (requestedSessionId) {
+      const existing = sessions.get(requestedSessionId);
+      if (!existing) {
+        return createJsonRpcErrorResponse(404, -32001, "Session not found");
+      }
+      state = existing;
+    } else {
+      state = await createSessionState({
         logger,
-        toolCtx: () => baseCtx,
-        promptCtx: () => ({ locale: "en" }),
-        resourceCtx: () => ({ locale: "en" }),
-        presentations: new PresentationRegistry(presentations)
+        path,
+        serverName,
+        ops,
+        resources,
+        prompts,
+        presentations,
+        stateful: true
+      });
+      createdState = true;
+    }
+    try {
+      const response = await state.transport.handleRequest(request);
+      const activeSessionId = state.transport.sessionId;
+      if (activeSessionId && !sessions.has(activeSessionId)) {
+        sessions.set(activeSessionId, state);
+      }
+      if (request.method === "DELETE" && activeSessionId) {
+        await closeSession(activeSessionId);
+      } else if (!activeSessionId && createdState) {
+        await closeSessionState(state);
+      }
+      return response;
+    } catch (error) {
+      if (createdState) {
+        await closeSessionState(state);
+      }
+      throw error;
+    }
+  }
+  return new Elysia({ name: `mcp-${serverName}` }).all(path, async ({ request }) => {
+    try {
+      if (isStateful) {
+        return await handleStateful(request);
+      }
+      return await handleStateless(request);
+    } catch (error) {
+      logger.error("Error handling MCP request", {
+        path,
+        method: request.method,
+        error: toErrorMessage(error)
       });
+      return createJsonRpcErrorResponse(500, -32000, "Internal error");
     }
   });
 }

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

@@ -1,72 +1,161 @@
 // src/application/mcp/common.ts
 import { PresentationRegistry } from "@contractspec/lib.contracts-spec/presentations";
 import { createMcpServer } from "@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";
-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));
-    }
-  };
-}
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { Elysia } from "elysia";
+import { randomUUID } from "node:crypto";
 var baseCtx = {
   actor: "anonymous",
   decide: async () => ({ effect: "allow" })
 };
-function createMcpElysiaHandler({
+function createJsonRpcErrorResponse(status, code, message, data) {
+  return new Response(JSON.stringify({
+    jsonrpc: "2.0",
+    error: {
+      code,
+      message,
+      ...data ? { data } : {}
+    },
+    id: null
+  }), {
+    status,
+    headers: {
+      "content-type": "application/json"
+    }
+  });
+}
+function createSessionState({
   logger,
-  path,
   serverName,
   ops,
   resources,
   prompts,
-  presentations
+  presentations,
+  stateful
 }) {
-  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,
+  const server = new McpServer({
+    name: serverName,
+    version: "1.0.0"
+  }, {
     capabilities: {
       tools: {},
       resources: {},
       prompts: {},
       logging: {}
-    },
-    setupServer: (server) => {
-      logger.info("Setting up MCP server...");
-      createMcpServer(server, ops, resources, prompts, {
+    }
+  });
+  logger.info("Setting up MCP server...");
+  createMcpServer(server, ops, resources, prompts, {
+    logger,
+    toolCtx: () => baseCtx,
+    promptCtx: () => ({ locale: "en" }),
+    resourceCtx: () => ({ locale: "en" }),
+    presentations: new PresentationRegistry(presentations)
+  });
+  const transport = new WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: stateful ? () => randomUUID() : undefined,
+    enableJsonResponse: true
+  });
+  return server.connect(transport).then(() => ({ server, transport }));
+}
+async function closeSessionState(state) {
+  await Promise.allSettled([state.transport.close(), state.server.close()]);
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function createMcpElysiaHandler({
+  logger,
+  path,
+  serverName,
+  ops,
+  resources,
+  prompts,
+  presentations
+}) {
+  logger.info("Setting up MCP handler...");
+  const isStateful = process.env.CONTRACTSPEC_MCP_STATEFUL === "1";
+  const sessions = new Map;
+  async function handleStateless(request) {
+    const state = await createSessionState({
+      logger,
+      path,
+      serverName,
+      ops,
+      resources,
+      prompts,
+      presentations,
+      stateful: false
+    });
+    try {
+      return await state.transport.handleRequest(request);
+    } finally {
+      await closeSessionState(state);
+    }
+  }
+  async function closeSession(sessionId) {
+    const state = sessions.get(sessionId);
+    if (!state)
+      return;
+    sessions.delete(sessionId);
+    await closeSessionState(state);
+  }
+  async function handleStateful(request) {
+    const requestedSessionId = request.headers.get("mcp-session-id");
+    let state;
+    let createdState = false;
+    if (requestedSessionId) {
+      const existing = sessions.get(requestedSessionId);
+      if (!existing) {
+        return createJsonRpcErrorResponse(404, -32001, "Session not found");
+      }
+      state = existing;
+    } else {
+      state = await createSessionState({
         logger,
-        toolCtx: () => baseCtx,
-        promptCtx: () => ({ locale: "en" }),
-        resourceCtx: () => ({ locale: "en" }),
-        presentations: new PresentationRegistry(presentations)
+        path,
+        serverName,
+        ops,
+        resources,
+        prompts,
+        presentations,
+        stateful: true
+      });
+      createdState = true;
+    }
+    try {
+      const response = await state.transport.handleRequest(request);
+      const activeSessionId = state.transport.sessionId;
+      if (activeSessionId && !sessions.has(activeSessionId)) {
+        sessions.set(activeSessionId, state);
+      }
+      if (request.method === "DELETE" && activeSessionId) {
+        await closeSession(activeSessionId);
+      } else if (!activeSessionId && createdState) {
+        await closeSessionState(state);
+      }
+      return response;
+    } catch (error) {
+      if (createdState) {
+        await closeSessionState(state);
+      }
+      throw error;
+    }
+  }
+  return new Elysia({ name: `mcp-${serverName}` }).all(path, async ({ request }) => {
+    try {
+      if (isStateful) {
+        return await handleStateful(request);
+      }
+      return await handleStateless(request);
+    } catch (error) {
+      logger.error("Error handling MCP request", {
+        path,
+        method: request.method,
+        error: toErrorMessage(error)
       });
+      return createJsonRpcErrorResponse(500, -32000, "Internal error");
     }
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.library",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "type": "module",
   "scripts": {
     "clean": "rm -rf dist",
@@ -2053,17 +2053,17 @@
   },
   "dependencies": {
     "@apollo/client": "^4.1.4",
-    "@contractspec/lib.contracts-spec": "2.5.0",
-    "@contractspec/lib.contracts-library": "2.5.0",
-    "@contractspec/lib.contracts-runtime-server-mcp": "2.5.0",
-    "@contractspec/lib.design-system": "2.5.0",
-    "@contractspec/lib.example-shared-ui": "2.5.0",
-    "@contractspec/lib.logger": "2.5.0",
-    "@contractspec/lib.runtime-sandbox": "1.5.0",
-    "@contractspec/lib.schema": "2.5.0",
-    "@contractspec/lib.ui-kit-web": "2.5.0",
-    "@contractspec/lib.ui-link": "2.5.0",
-    "@contractspec/module.examples": "2.5.0",
+    "@contractspec/lib.contracts-spec": "2.6.0",
+    "@contractspec/lib.contracts-library": "2.6.0",
+    "@contractspec/lib.contracts-runtime-server-mcp": "2.6.0",
+    "@contractspec/lib.design-system": "2.6.0",
+    "@contractspec/lib.example-shared-ui": "2.6.0",
+    "@contractspec/lib.logger": "2.6.0",
+    "@contractspec/lib.runtime-sandbox": "1.6.0",
+    "@contractspec/lib.schema": "2.6.0",
+    "@contractspec/lib.ui-kit-web": "2.6.0",
+    "@contractspec/lib.ui-link": "2.6.0",
+    "@contractspec/module.examples": "2.6.0",
     "@dnd-kit/core": "^6.1.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -2079,16 +2079,16 @@
     "posthog-react-native": "^4.34.0",
     "react-hook-form": "^7.70.0",
     "zod": "^4.3.5",
-    "@contractspec/lib.contracts-integrations": "2.5.0",
-    "@contractspec/lib.contracts-runtime-server-rest": "2.5.0",
-    "@contractspec/lib.contracts-runtime-server-graphql": "2.5.0"
+    "@contractspec/lib.contracts-integrations": "2.6.0",
+    "@contractspec/lib.contracts-runtime-server-rest": "2.6.0",
+    "@contractspec/lib.contracts-runtime-server-graphql": "2.6.0"
   },
   "devDependencies": {
     "@types/react": "~19.2.14",
-    "@contractspec/tool.typescript": "2.5.0",
+    "@contractspec/tool.typescript": "2.6.0",
     "typescript": "^5.9.3",
     "@types/bun": "~1.3.9",
-    "@contractspec/tool.bun": "2.5.0"
+    "@contractspec/tool.bun": "2.6.0"
   },
   "publishConfig": {
     "access": "public",