@contractspec/bundle.library 3.8.10 → 3.8.12

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

@@ -1,410 +1,2 @@
-// src/infrastructure/elysia/logger.ts
-import { Logger, LogLevel } from "@contractspec/lib.logger";
-var createAppLogger = () => new Logger({
-  level: LogLevel.INFO,
-  environment: "production",
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: false
-});
-var appLogger = createAppLogger();
-var dbLogger = new Logger({
-  level: LogLevel.WARN,
-  environment: "production",
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: false
-});
-var authLogger = new Logger({
-  level: LogLevel.INFO,
-  environment: "production",
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: false
-});
-// src/application/mcp/normalizeMcpRequest.ts
-var REQUIRED_ACCEPT_TYPES = ["application/json", "text/event-stream"];
-function canNormalizeAcceptHeader(acceptHeader) {
-  return !acceptHeader || acceptHeader.includes("*/*") || acceptHeader.includes("application/*") || REQUIRED_ACCEPT_TYPES.some((value) => acceptHeader.includes(value));
-}
-function normalizeMcpRequest(request) {
-  if (request.method !== "POST")
-    return request;
-  const acceptHeader = request.headers.get("accept");
-  if (!canNormalizeAcceptHeader(acceptHeader))
-    return request;
-  const missingTypes = REQUIRED_ACCEPT_TYPES.filter((value) => !acceptHeader?.includes(value));
-  if (missingTypes.length === 0)
-    return request;
-  const headers = new Headers(request.headers);
-  headers.set("accept", [acceptHeader, ...missingTypes].filter(Boolean).join(", "));
-  return new Request(request, { headers });
-}
-
-// src/application/mcp/common.ts
-import { createMcpServer } from "@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";
-import { PresentationRegistry } from "@contractspec/lib.contracts-spec/presentations";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
-import { randomUUID } from "crypto";
-import { Elysia } from "elysia";
-var baseCtx = {
-  actor: "anonymous",
-  decide: async () => ({ effect: "allow" })
-};
-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,
-  serverName,
-  ops,
-  resources,
-  prompts,
-  presentations,
-  stateful
-}) {
-  const server = new McpServer({
-    name: serverName,
-    version: "1.0.0"
-  }, {
-    capabilities: {
-      tools: {},
-      resources: {},
-      prompts: {},
-      logging: {}
-    }
-  });
-  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,
-  validateAuth,
-  requiredAuthMethods
-}) {
-  logger.info("Setting up MCP handler...", {
-    requiredAuthMethods: requiredAuthMethods ?? []
-  });
-  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(normalizeMcpRequest(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,
-        path,
-        serverName,
-        ops,
-        resources,
-        prompts,
-        presentations,
-        stateful: true
-      });
-      createdState = true;
-    }
-    try {
-      const response = await state.transport.handleRequest(normalizeMcpRequest(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 (validateAuth) {
-        const authResult = await validateAuth(request);
-        if (!authResult.valid) {
-          return createJsonRpcErrorResponse(401, -32002, "Authentication failed", authResult.reason);
-        }
-      }
-      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");
-    }
-  });
-}
-
-// src/application/mcp/internalMcp.ts
-import {
-  defineCommand,
-  definePrompt,
-  defineResourceTemplate,
-  installOp,
-  OperationSpecRegistry,
-  PromptRegistry,
-  ResourceRegistry
-} from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-import {
-  getExample,
-  listExamples,
-  searchExamples
-} from "@contractspec/module.examples";
-import z from "zod";
-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(`
-`)
-    })
-  }));
-  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 }
-    }
-  });
-  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()
-  });
-}
-export {
-  createInternalMcpHandler
-};
+import{Logger as G,LogLevel as P}from"@contractspec/lib.logger";function _(){return"production"}var v=()=>new G({level:P.INFO,environment:_(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),y=v(),kj=new G({level:P.WARN,environment:_(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),Cj=new G({level:P.INFO,environment:_(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});var O=["application/json","text/event-stream"];function S(j){return!j||j.includes("*/*")||j.includes("application/*")||O.some((w)=>j.includes(w))}function f(j){if(j.method!=="POST")return j;let w=j.headers.get("accept");if(!S(w))return j;let B=O.filter((F)=>!w?.includes(F));if(B.length===0)return j;let Y=new Headers(j.headers);return Y.set("accept",[w,...B].filter(Boolean).join(", ")),new Request(j,{headers:Y})}import{createMcpServer as m}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as N}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as n}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as l}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as g}from"crypto";import{Elysia as u}from"elysia";var d={actor:"anonymous",decide:async()=>({effect:"allow"})};function b(j,w,B,Y){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:w,message:B,...Y?{data:Y}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function R({logger:j,serverName:w,ops:B,resources:Y,prompts:F,presentations:H,stateful:W}){let J=new n({name:w,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),m(J,B,Y,F,{logger:j,toolCtx:()=>d,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new N(H)});let z=new l({sessionIdGenerator:W?()=>g():void 0,enableJsonResponse:!0});return J.connect(z).then(()=>({server:J,transport:z}))}async function D(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function p(j){return j instanceof Error?j.stack??j.message:String(j)}function A({logger:j,path:w,serverName:B,ops:Y,resources:F,prompts:H,presentations:W,validateAuth:J,requiredAuthMethods:z}){j.info("Setting up MCP handler...",{requiredAuthMethods:z??[]});let T=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",Z=new Map;async function I(Q){let U=await R({logger:j,path:w,serverName:B,ops:Y,resources:F,prompts:H,presentations:W,stateful:!1});try{return await U.transport.handleRequest(f(Q))}finally{await D(U)}}async function c(Q){let U=Z.get(Q);if(!U)return;Z.delete(Q),await D(U)}async function q(Q){let U=Q.headers.get("mcp-session-id"),k,x=!1;if(U){let K=Z.get(U);if(!K)return b(404,-32001,"Session not found");k=K}else k=await R({logger:j,path:w,serverName:B,ops:Y,resources:F,prompts:H,presentations:W,stateful:!0}),x=!0;try{let K=await k.transport.handleRequest(f(Q)),V=k.transport.sessionId;if(V&&!Z.has(V))Z.set(V,k);if(Q.method==="DELETE"&&V)await c(V);else if(!V&&x)await D(k);return K}catch(K){if(x)await D(k);throw K}}return new u({name:`mcp-${B}`}).all(w,async({request:Q})=>{try{if(J){let U=await J(Q);if(!U.valid)return b(401,-32002,"Authentication failed",U.reason)}if(T)return await q(Q);return await I(Q)}catch(U){return j.error("Error handling MCP request",{path:w,method:Q.method,error:p(U)}),b(500,-32000,"Internal error")}})}import{defineCommand as i,definePrompt as o,defineResourceTemplate as M,installOp as a,OperationSpecRegistry as t,PromptRegistry as r,ResourceRegistry as s}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as E,ScalarTypeEnum as h}from"@contractspec/lib.schema";import{getExample as e,listExamples as jj,searchExamples as wj}from"@contractspec/module.examples";import C from"zod";var X=["internal","mcp"],L=["@contractspec"],$={docs:"/api/mcp/docs",cli:"/api/mcp/cli",internal:"/api/mcp/internal",graphql:"/graphql",health:"/health"};function Bj(){let j=new s;return j.register(M({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",...X]},input:C.object({q:C.string().optional()}),resolve:async({q:w})=>{let B=w?wj(w):[...jj()];return{uri:w?`examples://list?q=${encodeURIComponent(w)}`:"examples://list",mimeType:"application/json",data:JSON.stringify(B,null,2)}}})),j.register(M({meta:{uriTemplate:"examples://example/{id}",title:"ContractSpec example (by id)",description:"Fetch a single example manifest by id.",mimeType:"application/json",tags:["examples",...X]},input:C.object({id:C.string().min(1)}),resolve:async({id:w})=>{let B=e(w);if(!B)return{uri:`examples://example/${encodeURIComponent(w)}`,mimeType:"application/json",data:JSON.stringify({error:"not_found",id:w,message:`Unknown example id: ${w}`},null,2)};return{uri:`examples://example/${encodeURIComponent(w)}`,mimeType:"application/json",data:JSON.stringify(B,null,2)}}})),j.register(M({meta:{uriTemplate:"internal://endpoints",title:"ContractSpec MCP endpoints",description:"Endpoints for docs, CLI, internal MCP servers.",mimeType:"application/json",tags:X},input:C.object({}),resolve:async()=>({uri:"internal://endpoints",mimeType:"application/json",data:JSON.stringify($,null,2)})})),j.register(M({meta:{uriTemplate:"internal://playbook",title:"Internal MCP usage playbook",description:"How internal agents should discover docs, CLI usage, and endpoints.",mimeType:"text/markdown",tags:X},input:C.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: ${$.docs}, ${$.cli}, ${$.internal}.`,"- For API work, GraphQL at /graphql; health at /health."].join(`
+`)})})),j}function Qj(){let j=new r;return j.register(o({meta:{key:"internal_bootstrap",version:"1.0.0",title:"Bootstrap internal ContractSpec agent",description:"Points agents to the correct MCP endpoints and guardrails.",tags:X,owners:L,stability:"beta"},args:[],input:C.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"}]})),j}function Uj(){let j=new t,w=E({name:"InternalDescribeOutput",fields:{endpoints:{type:h.JSONObject(),isOptional:!1},notes:{type:h.String_unsecure(),isOptional:!1}}}),B=i({meta:{key:"internal_describe",version:"1.0.0",stability:"stable",owners:L,tags:X,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:E({name:"InternalDescribeInput",fields:{}}),output:w},policy:{auth:"anonymous"}});return a(j,B,async()=>({endpoints:$,notes:"Use docs MCP for canonical specs, CLI MCP for contractspec commands, and keep side-effecting actions gated behind human review."})),j}function fj(j="/api/mcp/internal"){return A({logger:y,path:j,serverName:"contractspec-internal-mcp",ops:Uj(),resources:Bj(),prompts:Qj()})}export{fj as createInternalMcpHandler};

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

@@ -1,21 +1 @@
-// src/application/mcp/normalizeMcpRequest.ts
-var REQUIRED_ACCEPT_TYPES = ["application/json", "text/event-stream"];
-function canNormalizeAcceptHeader(acceptHeader) {
-  return !acceptHeader || acceptHeader.includes("*/*") || acceptHeader.includes("application/*") || REQUIRED_ACCEPT_TYPES.some((value) => acceptHeader.includes(value));
-}
-function normalizeMcpRequest(request) {
-  if (request.method !== "POST")
-    return request;
-  const acceptHeader = request.headers.get("accept");
-  if (!canNormalizeAcceptHeader(acceptHeader))
-    return request;
-  const missingTypes = REQUIRED_ACCEPT_TYPES.filter((value) => !acceptHeader?.includes(value));
-  if (missingTypes.length === 0)
-    return request;
-  const headers = new Headers(request.headers);
-  headers.set("accept", [acceptHeader, ...missingTypes].filter(Boolean).join(", "));
-  return new Request(request, { headers });
-}
-export {
-  normalizeMcpRequest
-};
+var o=["application/json","text/event-stream"];function c(n){return!n||n.includes("*/*")||n.includes("application/*")||o.some((e)=>n.includes(e))}function l(n){if(n.method!=="POST")return n;let e=n.headers.get("accept");if(!c(e))return n;let t=o.filter((s)=>!e?.includes(s));if(t.length===0)return n;let i=new Headers(n.headers);return i.set("accept",[e,...t].filter(Boolean).join(", ")),new Request(n,{headers:i})}export{l as normalizeMcpRequest};