@convertcom/mcp-server 0.0.1-beta.15 → 0.0.1-beta.16

package/build/mcp-server-compat.js

@@ -0,0 +1,28 @@
+const FALSY_REQUEST_ID_COMPAT = Symbol('convert.falsy-request-id-cancellation');
+/**
+ * @modelcontextprotocol/server 2.0.0 ignores cancellation for the valid
+ * falsy JSON-RPC IDs 0 and "".
+ * Keep the workaround on each Convert-owned server instance so the published
+ * npm package and Worker bundle have identical behavior without package-manager
+ * patch protocols. Remove this shim once the pinned SDK contains the fix.
+ */
+export function applyFalsyRequestIdCancellationCompat(server) {
+    const protocol = server;
+    if (protocol[FALSY_REQUEST_ID_COMPAT])
+        return;
+    if (typeof protocol._oncancel !== 'function'
+        || !(protocol._requestHandlerAbortControllers instanceof Map)) {
+        throw new Error('MCP server cancellation compatibility seam is unavailable.');
+    }
+    const original = protocol._oncancel.bind(protocol);
+    protocol._oncancel = async (notification) => {
+        const requestId = notification.params.requestId;
+        if (requestId !== 0 && requestId !== '') {
+            await original(notification);
+            return;
+        }
+        protocol._requestHandlerAbortControllers.get(requestId)?.abort(notification.params.reason);
+    };
+    protocol[FALSY_REQUEST_ID_COMPAT] = true;
+}
+//# sourceMappingURL=mcp-server-compat.js.map

package/build/mcp-server-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-compat.js","sourceRoot":"","sources":["../src/mcp-server-compat.ts"],"names":[],"mappings":"AAaA,MAAM,uBAAuB,GAAG,MAAM,CAAC,uCAAuC,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,qCAAqC,CAAC,MAAc;IAClE,MAAM,QAAQ,GAAG,MAAiD,CAAC;IACnE,IAAI,QAAQ,CAAC,uBAAuB,CAAC;QAAE,OAAO;IAC9C,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,UAAU;WACvC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,YAAY,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,GAAG,KAAK,EAAE,YAAY,EAAE,EAAE;QAC1C,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC;QAChD,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,+BAA+B,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7F,CAAC,CAAC;IACF,QAAQ,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC;AAC3C,CAAC"}

package/build/modern-runtime.d.ts

@@ -0,0 +1,13 @@
+import { Server } from '@modelcontextprotocol/server';
+import { type ConvertMcpServerIdentityOptions, type ConvertMcpRuntimeOptions } from './runtime.js';
+/**
+ * Builds the v2 protocol server while keeping catalog and dispatch behavior in
+ * the shared runtime. The HTTP entry must create one of these per request.
+ */
+export declare function createModernConvertMcpServer(options: ConvertMcpRuntimeOptions): Server;
+/**
+ * A listen request needs only identity and capabilities. Keeping this factory
+ * separate prevents a long-lived SSE handler from retaining Convert OAuth
+ * props, catalogs, docs providers, validators, or execution closures.
+ */
+export declare function createModernConvertMcpListenServer(options: ConvertMcpServerIdentityOptions, advertiseListChanged: boolean): Server;

package/build/modern-runtime.js

@@ -0,0 +1,148 @@
+import { CLIENT_INFO_META_KEY, ProtocolError, Server, } from '@modelcontextprotocol/server';
+import { McpError as LegacyMcpError, } from '@modelcontextprotocol/sdk/types.js';
+import { convertMcpServerDefinition, createConvertMcpHandlers, } from './runtime.js';
+import { applyFalsyRequestIdCancellationCompat } from './mcp-server-compat.js';
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function sharedClientInfoFrom(value) {
+    if (!isRecord(value) || typeof value.name !== 'string' || typeof value.version !== 'string')
+        return undefined;
+    const clientInfo = { name: value.name, version: value.version };
+    for (const key of ['title', 'description', 'websiteUrl']) {
+        if (typeof value[key] === 'string')
+            clientInfo[key] = value[key];
+    }
+    if (Array.isArray(value.icons)) {
+        const icons = value.icons
+            .filter(isRecord)
+            .map((icon) => {
+            if (typeof icon.src !== 'string')
+                return undefined;
+            const sanitized = { src: icon.src };
+            if (typeof icon.mimeType === 'string')
+                sanitized.mimeType = icon.mimeType;
+            if (Array.isArray(icon.sizes) && icon.sizes.every((size) => typeof size === 'string')) {
+                sanitized.sizes = icon.sizes;
+            }
+            if (icon.theme === 'light' || icon.theme === 'dark')
+                sanitized.theme = icon.theme;
+            return sanitized;
+        })
+            .filter((icon) => icon !== undefined);
+        if (icons.length > 0)
+            clientInfo.icons = icons;
+    }
+    return clientInfo;
+}
+function clientInfoFromEnvelope(envelope) {
+    if (!envelope)
+        return undefined;
+    const value = envelope[CLIENT_INFO_META_KEY];
+    return sharedClientInfoFrom(value);
+}
+function translateLegacyProtocolError(error) {
+    if (error instanceof LegacyMcpError) {
+        throw new ProtocolError(error.code, error.message, error.data);
+    }
+    throw error;
+}
+async function withModernProtocolErrors(operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        return translateLegacyProtocolError(error);
+    }
+}
+/**
+ * Builds the v2 protocol server while keeping catalog and dispatch behavior in
+ * the shared runtime. The HTTP entry must create one of these per request.
+ */
+export function createModernConvertMcpServer(options) {
+    const definition = convertMcpServerDefinition(options);
+    const capabilities = options.advertiseListChanged === false
+        ? {
+            tools: { listChanged: false },
+            prompts: { listChanged: false },
+            resources: { listChanged: false },
+        }
+        : definition.options.capabilities;
+    const server = new Server(definition.implementation, {
+        ...definition.options,
+        capabilities,
+    });
+    applyFalsyRequestIdCancellationCompat(server);
+    const handlers = createConvertMcpHandlers(options, (extra) => extra.clientInfo ?? sharedClientInfoFrom(server.getClientVersion()));
+    const runtimeExtra = (ctx) => {
+        const extra = {
+            signal: ctx.mcpReq.signal,
+            requestId: ctx.mcpReq.id,
+            sendNotification: (notification) => ctx.mcpReq.notify(notification),
+            clientInfo: clientInfoFromEnvelope(ctx.mcpReq.envelope),
+        };
+        return extra;
+    };
+    server.setRequestHandler('tools/list', async (_request, ctx) => {
+        return await withModernProtocolErrors(async () => {
+            return await handlers.listTools(runtimeExtra(ctx));
+        });
+    });
+    server.setRequestHandler('resources/list', async (_request, ctx) => {
+        return await withModernProtocolErrors(async () => {
+            return await handlers.listResources(runtimeExtra(ctx));
+        });
+    });
+    server.setRequestHandler('resources/templates/list', async (_request, ctx) => {
+        return await withModernProtocolErrors(async () => {
+            return await handlers.listResourceTemplates(runtimeExtra(ctx));
+        });
+    });
+    server.setRequestHandler('resources/read', async (request, ctx) => {
+        return await withModernProtocolErrors(async () => {
+            return await handlers.readResource(request, runtimeExtra(ctx));
+        });
+    });
+    server.setRequestHandler('prompts/list', async (_request, ctx) => {
+        return await withModernProtocolErrors(async () => {
+            return await handlers.listPrompts(runtimeExtra(ctx));
+        });
+    });
+    server.setRequestHandler('prompts/get', async (request, ctx) => {
+        return await withModernProtocolErrors(async () => {
+            return await handlers.getPrompt(request, runtimeExtra(ctx));
+        });
+    });
+    server.setRequestHandler('tools/call', async (request, ctx) => {
+        return await withModernProtocolErrors(async () => {
+            let outputSchema;
+            const result = await handlers.callTool(request, runtimeExtra(ctx), (tool) => {
+                outputSchema = tool?.outputSchema;
+            });
+            // Low-level v2 handlers use this public codec seam. Convert's schemas
+            // and structured results are object-rooted, so projection is identity
+            // today while retaining the SDK's required text fallback behavior.
+            return server.projectCallToolResult(result, outputSchema);
+        });
+    });
+    return server;
+}
+/**
+ * A listen request needs only identity and capabilities. Keeping this factory
+ * separate prevents a long-lived SSE handler from retaining Convert OAuth
+ * props, catalogs, docs providers, validators, or execution closures.
+ */
+export function createModernConvertMcpListenServer(options, advertiseListChanged) {
+    const definition = convertMcpServerDefinition(options);
+    return new Server(definition.implementation, {
+        ...definition.options,
+        capabilities: advertiseListChanged
+            ? definition.options.capabilities
+            : {
+                tools: { listChanged: false },
+                prompts: { listChanged: false },
+                resources: { listChanged: false },
+            },
+    });
+}
+//# sourceMappingURL=modern-runtime.js.map

package/build/modern-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modern-runtime.js","sourceRoot":"","sources":["../src/modern-runtime.ts"],"names":[],"mappings":"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"}

package/build/namespaced.js

@@ -1,5 +1,5 @@
 import { toolDefinitionMap } from './tools.js';
-import { executeToolByName, truncateSchemaText, validateToolArgs } from './executor.js';
+import { executeToolByName, executeValidatedToolByName, truncateSchemaText, validateToolArgs } from './executor.js';
 import { JSON_SCHEMA_DRAFT_2020_12, pathParamsFromTemplate, tryParseJsonLike } from './shared.js';
 import { toolSafetyKindForDelegate } from './tool-safety.js';
 import { MDE_FRACTION_BOUNDARY_VERSION, experienceStatsVersion, usesLegacyFixedMdeScale, } from './stats-engine-version.js';
@@ -2237,7 +2237,7 @@ export async function executeNamespacedTool(toolName, args, executionContext, to
             isError: true,
         }, namespace, action, delegate);
     }
-    const executedResult = await executeToolByName(delegate, flattenedArgs, executionContext);
+    const executedResult = await executeValidatedToolByName(delegate, flattenedArgs, executionContext);
     const approvalAwareResult = normalizeApprovalRequiredError(namespace, action, path, executedResult);
     const result = normalizeProjectCreatePermissionError(namespace, action, approvalAwareResult);
     // Append action-specific guidance to error messages so agents can self-correct