@contractspec/lib.contracts-runtime-server-mcp 2.0.0

package/dist/node/index.js

@@ -0,0 +1,185 @@
+// src/mcp/registerTools.ts
+import { defaultMcpTool } from "@contractspec/lib.contracts-spec/jsonschema";
+function registerMcpTools(server, ops, ctx) {
+  for (const spec of ops.list()) {
+    if (spec.meta.kind !== "command")
+      continue;
+    const toolName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.key, spec.meta.version);
+    server.registerTool(toolName, {
+      description: spec.meta.description,
+      inputSchema: spec.io.input?.getZod()
+    }, async (args) => {
+      const result = await ops.execute(spec.meta.key, spec.meta.version, args ?? {}, ctx.toolCtx());
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 4) }]
+      };
+    });
+  }
+}
+
+// src/mcp/registerResources.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Buffer } from "node:buffer";
+function mcpResourceMeta(resource) {
+  return {
+    title: resource.meta.title,
+    description: resource.meta.description,
+    mimeType: resource.meta.mimeType,
+    _meta: { tags: resource.meta.tags ?? [] }
+  };
+}
+function registerMcpResources(server, resources, ctx) {
+  for (const resource of resources.listTemplates()) {
+    ctx.logger.debug("Registering resource: " + resource.meta.uriTemplate);
+    server.registerResource(resource.meta.uriTemplate, new ResourceTemplate(resource.meta.uriTemplate, { list: undefined }), mcpResourceMeta(resource), async (_uri, variables) => {
+      const parsedArgs = resource.input.parse(variables);
+      const out = await resource.resolve(parsedArgs, ctx.resourceCtx());
+      if (typeof out.data === "string") {
+        return {
+          contents: [
+            {
+              uri: out.uri,
+              mimeType: out.mimeType ?? resource.meta.mimeType,
+              text: out.data
+            }
+          ]
+        };
+      }
+      return {
+        contents: [
+          {
+            uri: out.uri,
+            mimeType: out.mimeType ?? resource.meta.mimeType,
+            blob: Buffer.from(out.data).toString("base64")
+          }
+        ]
+      };
+    });
+    ctx.logger.debug("Registered resource: " + resource.meta.uriTemplate);
+  }
+}
+
+// src/mcp/registerPrompts.ts
+import { defaultMcpPrompt } from "@contractspec/lib.contracts-spec/jsonschema";
+function promptArgsSchemaFromPromptArgs(args) {
+  const shape = {};
+  for (const a of args)
+    shape[a.name] = a.schema;
+  return shape;
+}
+function registerMcpPrompts(server, prompts, ctx) {
+  for (const prompt of prompts.list()) {
+    const promptName = defaultMcpPrompt(prompt.meta.key);
+    server.registerPrompt(promptName, {
+      title: prompt.meta.title,
+      description: prompt.meta.description,
+      argsSchema: promptArgsSchemaFromPromptArgs(prompt.args)
+    }, async (args) => {
+      const link = (tpl, vars) => {
+        let out = tpl;
+        for (const [k, v] of Object.entries(vars)) {
+          out = out.replace(new RegExp(`\\{${k}\\}`, "g"), encodeURIComponent(String(v)));
+        }
+        return out;
+      };
+      const parts = await prompt.render(prompt.input.parse(args), {
+        ...ctx.promptCtx(),
+        link
+      });
+      const text = parts.map((p) => p.type === "text" ? p.text : `See resource: ${p.title ?? p.uri}
+URI: ${p.uri}`).join(`
+
+`);
+      const contents = {
+        type: "text",
+        text
+      };
+      return {
+        messages: [{ role: "assistant", content: contents }],
+        description: prompt.meta.description
+      };
+    });
+  }
+}
+
+// src/mcp/registerPresentations.ts
+import"@contractspec/lib.contracts-spec/presentations";
+import {
+  createDefaultTransformEngine,
+  registerBasicValidation,
+  registerDefaultReactRenderer
+} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import { sanitizeMcpName } from "@contractspec/lib.contracts-spec/jsonschema";
+function isEngineRenderOutput(x) {
+  if (!x || typeof x !== "object")
+    return false;
+  return "body" in x && typeof x.body === "string";
+}
+function registerMcpPresentations(server, ctx) {
+  if (!ctx.presentations?.count()) {
+    return;
+  }
+  const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+  for (const presentationSpec of ctx.presentations.list()) {
+    const baseKey = sanitizeMcpName(`presentation_${presentationSpec.meta.key}_v${presentationSpec.meta.version}`);
+    const baseUri = `presentation://${presentationSpec.meta.key}/v${presentationSpec.meta.version}`;
+    ctx.logger.debug(`Registering presentation ${baseUri} for ${baseKey}`);
+    server.registerResource(baseKey, baseUri, {
+      title: `${presentationSpec.meta.key} v${presentationSpec.meta.version}`,
+      description: presentationSpec.meta.description ?? "Presentation",
+      mimeType: "application/json"
+    }, async () => {
+      const jsonText = JSON.stringify({
+        meta: presentationSpec.meta,
+        source: presentationSpec.source,
+        targets: presentationSpec.targets
+      }, null, 2);
+      return {
+        contents: [
+          {
+            uri: baseUri,
+            mimeType: "application/json",
+            text: jsonText
+          }
+        ]
+      };
+    });
+    const variants = [{ ext: ".md", target: "markdown" }];
+    for (const v of variants) {
+      const key = `${baseKey}${v.ext}`;
+      const uri = `${baseUri}${v.ext}`;
+      server.registerResource(key, uri, {
+        title: `${presentationSpec.meta.key} v${presentationSpec.meta.version} (${v.ext})`,
+        description: `${presentationSpec.meta.description ?? "Presentation"} (${v.ext})`
+      }, async () => {
+        const out = await engine.render(v.target, presentationSpec);
+        const mimeType = isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target;
+        const text = isEngineRenderOutput(out) && typeof out.body === "string" ? out.body : String(out);
+        return { contents: [{ uri, mimeType, text }] };
+      });
+    }
+  }
+}
+
+// src/mcp/createMcpServer.ts
+function createMcpServer(server, ops, resources, prompts, ctxFactories) {
+  ctxFactories.logger.debug("Creating MCP server");
+  registerMcpTools(server, ops, { toolCtx: ctxFactories.toolCtx });
+  registerMcpResources(server, resources, {
+    logger: ctxFactories.logger,
+    resourceCtx: ctxFactories.resourceCtx
+  });
+  registerMcpPresentations(server, {
+    logger: ctxFactories.logger,
+    presentations: ctxFactories.presentations
+  });
+  registerMcpPrompts(server, prompts, { promptCtx: ctxFactories.promptCtx });
+  return server;
+}
+export {
+  registerMcpTools,
+  registerMcpResources,
+  registerMcpPrompts,
+  registerMcpPresentations,
+  createMcpServer
+};

package/dist/node/mcp/createMcpServer.js

@@ -0,0 +1,181 @@
+// src/mcp/registerTools.ts
+import { defaultMcpTool } from "@contractspec/lib.contracts-spec/jsonschema";
+function registerMcpTools(server, ops, ctx) {
+  for (const spec of ops.list()) {
+    if (spec.meta.kind !== "command")
+      continue;
+    const toolName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.key, spec.meta.version);
+    server.registerTool(toolName, {
+      description: spec.meta.description,
+      inputSchema: spec.io.input?.getZod()
+    }, async (args) => {
+      const result = await ops.execute(spec.meta.key, spec.meta.version, args ?? {}, ctx.toolCtx());
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 4) }]
+      };
+    });
+  }
+}
+
+// src/mcp/registerResources.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Buffer } from "node:buffer";
+function mcpResourceMeta(resource) {
+  return {
+    title: resource.meta.title,
+    description: resource.meta.description,
+    mimeType: resource.meta.mimeType,
+    _meta: { tags: resource.meta.tags ?? [] }
+  };
+}
+function registerMcpResources(server, resources, ctx) {
+  for (const resource of resources.listTemplates()) {
+    ctx.logger.debug("Registering resource: " + resource.meta.uriTemplate);
+    server.registerResource(resource.meta.uriTemplate, new ResourceTemplate(resource.meta.uriTemplate, { list: undefined }), mcpResourceMeta(resource), async (_uri, variables) => {
+      const parsedArgs = resource.input.parse(variables);
+      const out = await resource.resolve(parsedArgs, ctx.resourceCtx());
+      if (typeof out.data === "string") {
+        return {
+          contents: [
+            {
+              uri: out.uri,
+              mimeType: out.mimeType ?? resource.meta.mimeType,
+              text: out.data
+            }
+          ]
+        };
+      }
+      return {
+        contents: [
+          {
+            uri: out.uri,
+            mimeType: out.mimeType ?? resource.meta.mimeType,
+            blob: Buffer.from(out.data).toString("base64")
+          }
+        ]
+      };
+    });
+    ctx.logger.debug("Registered resource: " + resource.meta.uriTemplate);
+  }
+}
+
+// src/mcp/registerPrompts.ts
+import { defaultMcpPrompt } from "@contractspec/lib.contracts-spec/jsonschema";
+function promptArgsSchemaFromPromptArgs(args) {
+  const shape = {};
+  for (const a of args)
+    shape[a.name] = a.schema;
+  return shape;
+}
+function registerMcpPrompts(server, prompts, ctx) {
+  for (const prompt of prompts.list()) {
+    const promptName = defaultMcpPrompt(prompt.meta.key);
+    server.registerPrompt(promptName, {
+      title: prompt.meta.title,
+      description: prompt.meta.description,
+      argsSchema: promptArgsSchemaFromPromptArgs(prompt.args)
+    }, async (args) => {
+      const link = (tpl, vars) => {
+        let out = tpl;
+        for (const [k, v] of Object.entries(vars)) {
+          out = out.replace(new RegExp(`\\{${k}\\}`, "g"), encodeURIComponent(String(v)));
+        }
+        return out;
+      };
+      const parts = await prompt.render(prompt.input.parse(args), {
+        ...ctx.promptCtx(),
+        link
+      });
+      const text = parts.map((p) => p.type === "text" ? p.text : `See resource: ${p.title ?? p.uri}
+URI: ${p.uri}`).join(`
+
+`);
+      const contents = {
+        type: "text",
+        text
+      };
+      return {
+        messages: [{ role: "assistant", content: contents }],
+        description: prompt.meta.description
+      };
+    });
+  }
+}
+
+// src/mcp/registerPresentations.ts
+import"@contractspec/lib.contracts-spec/presentations";
+import {
+  createDefaultTransformEngine,
+  registerBasicValidation,
+  registerDefaultReactRenderer
+} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import { sanitizeMcpName } from "@contractspec/lib.contracts-spec/jsonschema";
+function isEngineRenderOutput(x) {
+  if (!x || typeof x !== "object")
+    return false;
+  return "body" in x && typeof x.body === "string";
+}
+function registerMcpPresentations(server, ctx) {
+  if (!ctx.presentations?.count()) {
+    return;
+  }
+  const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+  for (const presentationSpec of ctx.presentations.list()) {
+    const baseKey = sanitizeMcpName(`presentation_${presentationSpec.meta.key}_v${presentationSpec.meta.version}`);
+    const baseUri = `presentation://${presentationSpec.meta.key}/v${presentationSpec.meta.version}`;
+    ctx.logger.debug(`Registering presentation ${baseUri} for ${baseKey}`);
+    server.registerResource(baseKey, baseUri, {
+      title: `${presentationSpec.meta.key} v${presentationSpec.meta.version}`,
+      description: presentationSpec.meta.description ?? "Presentation",
+      mimeType: "application/json"
+    }, async () => {
+      const jsonText = JSON.stringify({
+        meta: presentationSpec.meta,
+        source: presentationSpec.source,
+        targets: presentationSpec.targets
+      }, null, 2);
+      return {
+        contents: [
+          {
+            uri: baseUri,
+            mimeType: "application/json",
+            text: jsonText
+          }
+        ]
+      };
+    });
+    const variants = [{ ext: ".md", target: "markdown" }];
+    for (const v of variants) {
+      const key = `${baseKey}${v.ext}`;
+      const uri = `${baseUri}${v.ext}`;
+      server.registerResource(key, uri, {
+        title: `${presentationSpec.meta.key} v${presentationSpec.meta.version} (${v.ext})`,
+        description: `${presentationSpec.meta.description ?? "Presentation"} (${v.ext})`
+      }, async () => {
+        const out = await engine.render(v.target, presentationSpec);
+        const mimeType = isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target;
+        const text = isEngineRenderOutput(out) && typeof out.body === "string" ? out.body : String(out);
+        return { contents: [{ uri, mimeType, text }] };
+      });
+    }
+  }
+}
+
+// src/mcp/createMcpServer.ts
+function createMcpServer(server, ops, resources, prompts, ctxFactories) {
+  ctxFactories.logger.debug("Creating MCP server");
+  registerMcpTools(server, ops, { toolCtx: ctxFactories.toolCtx });
+  registerMcpResources(server, resources, {
+    logger: ctxFactories.logger,
+    resourceCtx: ctxFactories.resourceCtx
+  });
+  registerMcpPresentations(server, {
+    logger: ctxFactories.logger,
+    presentations: ctxFactories.presentations
+  });
+  registerMcpPrompts(server, prompts, { promptCtx: ctxFactories.promptCtx });
+  return server;
+}
+export {
+  createMcpServer
+};

package/dist/node/mcp/registerPresentations.js

@@ -0,0 +1,61 @@
+// src/mcp/registerPresentations.ts
+import"@contractspec/lib.contracts-spec/presentations";
+import {
+  createDefaultTransformEngine,
+  registerBasicValidation,
+  registerDefaultReactRenderer
+} from "@contractspec/lib.contracts-spec/presentations/transform-engine";
+import { sanitizeMcpName } from "@contractspec/lib.contracts-spec/jsonschema";
+function isEngineRenderOutput(x) {
+  if (!x || typeof x !== "object")
+    return false;
+  return "body" in x && typeof x.body === "string";
+}
+function registerMcpPresentations(server, ctx) {
+  if (!ctx.presentations?.count()) {
+    return;
+  }
+  const engine = registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+  for (const presentationSpec of ctx.presentations.list()) {
+    const baseKey = sanitizeMcpName(`presentation_${presentationSpec.meta.key}_v${presentationSpec.meta.version}`);
+    const baseUri = `presentation://${presentationSpec.meta.key}/v${presentationSpec.meta.version}`;
+    ctx.logger.debug(`Registering presentation ${baseUri} for ${baseKey}`);
+    server.registerResource(baseKey, baseUri, {
+      title: `${presentationSpec.meta.key} v${presentationSpec.meta.version}`,
+      description: presentationSpec.meta.description ?? "Presentation",
+      mimeType: "application/json"
+    }, async () => {
+      const jsonText = JSON.stringify({
+        meta: presentationSpec.meta,
+        source: presentationSpec.source,
+        targets: presentationSpec.targets
+      }, null, 2);
+      return {
+        contents: [
+          {
+            uri: baseUri,
+            mimeType: "application/json",
+            text: jsonText
+          }
+        ]
+      };
+    });
+    const variants = [{ ext: ".md", target: "markdown" }];
+    for (const v of variants) {
+      const key = `${baseKey}${v.ext}`;
+      const uri = `${baseUri}${v.ext}`;
+      server.registerResource(key, uri, {
+        title: `${presentationSpec.meta.key} v${presentationSpec.meta.version} (${v.ext})`,
+        description: `${presentationSpec.meta.description ?? "Presentation"} (${v.ext})`
+      }, async () => {
+        const out = await engine.render(v.target, presentationSpec);
+        const mimeType = isEngineRenderOutput(out) && out.mimeType ? out.mimeType : v.target === "markdown" ? "text/markdown" : v.target;
+        const text = isEngineRenderOutput(out) && typeof out.body === "string" ? out.body : String(out);
+        return { contents: [{ uri, mimeType, text }] };
+      });
+    }
+  }
+}
+export {
+  registerMcpPresentations
+};

package/dist/node/mcp/registerPrompts.js

@@ -0,0 +1,45 @@
+// src/mcp/registerPrompts.ts
+import { defaultMcpPrompt } from "@contractspec/lib.contracts-spec/jsonschema";
+function promptArgsSchemaFromPromptArgs(args) {
+  const shape = {};
+  for (const a of args)
+    shape[a.name] = a.schema;
+  return shape;
+}
+function registerMcpPrompts(server, prompts, ctx) {
+  for (const prompt of prompts.list()) {
+    const promptName = defaultMcpPrompt(prompt.meta.key);
+    server.registerPrompt(promptName, {
+      title: prompt.meta.title,
+      description: prompt.meta.description,
+      argsSchema: promptArgsSchemaFromPromptArgs(prompt.args)
+    }, async (args) => {
+      const link = (tpl, vars) => {
+        let out = tpl;
+        for (const [k, v] of Object.entries(vars)) {
+          out = out.replace(new RegExp(`\\{${k}\\}`, "g"), encodeURIComponent(String(v)));
+        }
+        return out;
+      };
+      const parts = await prompt.render(prompt.input.parse(args), {
+        ...ctx.promptCtx(),
+        link
+      });
+      const text = parts.map((p) => p.type === "text" ? p.text : `See resource: ${p.title ?? p.uri}
+URI: ${p.uri}`).join(`
+
+`);
+      const contents = {
+        type: "text",
+        text
+      };
+      return {
+        messages: [{ role: "assistant", content: contents }],
+        description: prompt.meta.description
+      };
+    });
+  }
+}
+export {
+  registerMcpPrompts
+};

package/dist/node/mcp/registerResources.js

@@ -0,0 +1,44 @@
+// src/mcp/registerResources.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Buffer } from "node:buffer";
+function mcpResourceMeta(resource) {
+  return {
+    title: resource.meta.title,
+    description: resource.meta.description,
+    mimeType: resource.meta.mimeType,
+    _meta: { tags: resource.meta.tags ?? [] }
+  };
+}
+function registerMcpResources(server, resources, ctx) {
+  for (const resource of resources.listTemplates()) {
+    ctx.logger.debug("Registering resource: " + resource.meta.uriTemplate);
+    server.registerResource(resource.meta.uriTemplate, new ResourceTemplate(resource.meta.uriTemplate, { list: undefined }), mcpResourceMeta(resource), async (_uri, variables) => {
+      const parsedArgs = resource.input.parse(variables);
+      const out = await resource.resolve(parsedArgs, ctx.resourceCtx());
+      if (typeof out.data === "string") {
+        return {
+          contents: [
+            {
+              uri: out.uri,
+              mimeType: out.mimeType ?? resource.meta.mimeType,
+              text: out.data
+            }
+          ]
+        };
+      }
+      return {
+        contents: [
+          {
+            uri: out.uri,
+            mimeType: out.mimeType ?? resource.meta.mimeType,
+            blob: Buffer.from(out.data).toString("base64")
+          }
+        ]
+      };
+    });
+    ctx.logger.debug("Registered resource: " + resource.meta.uriTemplate);
+  }
+}
+export {
+  registerMcpResources
+};

package/dist/node/mcp/registerTools.js

@@ -0,0 +1,21 @@
+// src/mcp/registerTools.ts
+import { defaultMcpTool } from "@contractspec/lib.contracts-spec/jsonschema";
+function registerMcpTools(server, ops, ctx) {
+  for (const spec of ops.list()) {
+    if (spec.meta.kind !== "command")
+      continue;
+    const toolName = spec.transport?.mcp?.toolName ?? defaultMcpTool(spec.meta.key, spec.meta.version);
+    server.registerTool(toolName, {
+      description: spec.meta.description,
+      inputSchema: spec.io.input?.getZod()
+    }, async (args) => {
+      const result = await ops.execute(spec.meta.key, spec.meta.version, args ?? {}, ctx.toolCtx());
+      return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 4) }]
+      };
+    });
+  }
+}
+export {
+  registerMcpTools
+};