@j0hanz/fetch-url-mcp 1.6.0 → 1.7.0

package/dist/lib/utils.d.ts.map

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

package/dist/lib/utils.js

@@ -50,25 +50,19 @@ function assertAllowedAlgorithm(algorithm) {
         throw new Error(`Hash algorithm not allowed: ${algorithm}`);
     }
 }
-function padBuffer(buffer, length) {
-    const padded = Buffer.alloc(length);
-    buffer.copy(padded);
-    return padded;
-}
-function equalWithPadding(aBuffer, bBuffer, paddedLength) {
-    const paddedA = padBuffer(aBuffer, paddedLength);
-    const paddedB = padBuffer(bBuffer, paddedLength);
-    return timingSafeEqual(paddedA, paddedB) && aBuffer.length === bBuffer.length;
-}
 export function timingSafeEqualUtf8(a, b) {
     const aBuffer = Buffer.from(a, 'utf8');
     const bBuffer = Buffer.from(b, 'utf8');
     if (aBuffer.length === bBuffer.length) {
         return timingSafeEqual(aBuffer, bBuffer);
     }
-    // Avoid early return timing differences on length mismatch.
+    // If lengths differ, compare against a buffer of the same length filled with zeros.
     const maxLength = Math.max(aBuffer.length, bBuffer.length);
-    return equalWithPadding(aBuffer, bBuffer, maxLength);
+    const paddedA = Buffer.alloc(maxLength);
+    aBuffer.copy(paddedA);
+    const paddedB = Buffer.alloc(maxLength);
+    bBuffer.copy(paddedB);
+    return timingSafeEqual(paddedA, paddedB) && aBuffer.length === bBuffer.length;
 }
 function hashHex(algorithm, input) {
     assertAllowedAlgorithm(algorithm);
@@ -96,36 +90,26 @@ export class FetchError extends Error {
         this.url = url;
         this.name = 'FetchError';
         this.statusCode = httpStatus ?? DEFAULT_HTTP_STATUS;
-        this.code = httpStatus ? `HTTP_${httpStatus}` : 'FETCH_ERROR';
         this.details = Object.freeze({ url, httpStatus, ...details });
-        Error.captureStackTrace(this, this.constructor);
+        const explicitCode = this.details['code'];
+        this.code =
+            typeof explicitCode === 'string'
+                ? explicitCode
+                : httpStatus
+                    ? `HTTP_${httpStatus}`
+                    : 'FETCH_ERROR';
     }
 }
 export function getErrorMessage(error) {
     if (isError(error))
         return error.message;
-    if (isNonEmptyString(error))
+    if (typeof error === 'string' && error.length > 0)
         return error;
-    if (isErrorWithMessage(error))
+    if (isObject(error) &&
+        typeof error.message === 'string' &&
+        error.message.length > 0) {
         return error.message;
-    return formatUnknownError(error);
-}
-export function toError(error) {
-    return isError(error) ? error : new Error(getErrorMessage(error));
-}
-export function isAbortError(error) {
-    return isError(error) && error.name === 'AbortError';
-}
-function isNonEmptyString(value) {
-    return typeof value === 'string' && value.length > 0;
-}
-function isErrorWithMessage(error) {
-    if (!isObject(error))
-        return false;
-    const { message } = error;
-    return typeof message === 'string' && message.length > 0;
-}
-function formatUnknownError(error) {
+    }
     if (error === null || error === undefined)
         return UNKNOWN_ERROR_MESSAGE;
     try {
@@ -141,6 +125,12 @@ function formatUnknownError(error) {
         return UNKNOWN_ERROR_MESSAGE;
     }
 }
+export function toError(error) {
+    return isError(error) ? error : new Error(getErrorMessage(error));
+}
+export function isAbortError(error) {
+    return isError(error) && error.name === 'AbortError';
+}
 export function createErrorWithCode(message, code, options) {
     const error = new Error(message, options);
     return Object.assign(error, { code });
@@ -153,74 +143,50 @@ export function isSystemError(error) {
     const { code } = error;
     return typeof code === 'string';
 }
-export const RESOURCE_NOT_FOUND_ERROR_CODE = -32002;
 const MAX_DEPTH = 20;
-const MAX_DEPTH_ERROR = `stableStringify: Max depth (${MAX_DEPTH}) exceeded`;
 const CIRCULAR_ERROR = 'stableStringify: Circular reference detected';
-function compareObjectKeys(a, b) {
-    if (a === b)
-        return 0;
-    return a < b ? -1 : 1;
-}
-function getSortedObjectKeys(obj) {
-    return Object.keys(obj).sort(compareObjectKeys);
-}
-function processValue(obj, depth, seen) {
-    if (typeof obj !== 'object' || obj === null) {
-        return obj;
-    }
-    // Depth guard
-    if (depth > MAX_DEPTH) {
-        throw new Error(MAX_DEPTH_ERROR);
-    }
-    // Cycle detection (track active recursion stack only).
-    if (seen.has(obj)) {
-        throw new Error(CIRCULAR_ERROR);
-    }
-    seen.add(obj);
-    try {
-        if (Array.isArray(obj)) {
-            return obj.map((item) => processValue(item, depth + 1, seen));
+export function stableStringify(obj) {
+    const seen = new WeakSet();
+    const process = (value, depth) => {
+        if (typeof value !== 'object' || value === null)
+            return value;
+        if (depth > MAX_DEPTH) {
+            throw new Error(`stableStringify: Max depth (${MAX_DEPTH}) exceeded`);
         }
-        const keys = getSortedObjectKeys(obj);
-        const record = obj;
-        const sortedObj = {};
-        for (const key of keys) {
-            sortedObj[key] = processValue(record[key], depth + 1, seen);
+        if (seen.has(value)) {
+            throw new Error(CIRCULAR_ERROR);
         }
-        return sortedObj;
-    }
-    finally {
-        seen.delete(obj);
-    }
-}
-export function stableStringify(obj, depth = 0, seen = new WeakSet()) {
-    const processed = processValue(obj, depth, seen);
-    return JSON.stringify(processed);
+        seen.add(value);
+        try {
+            if (Array.isArray(value)) {
+                return value.map((item) => process(item, depth + 1));
+            }
+            const record = value;
+            const sorted = {};
+            for (const key of Object.keys(record).sort()) {
+                sorted[key] = process(record[key], depth + 1);
+            }
+            return sorted;
+        }
+        finally {
+            seen.delete(value);
+        }
+    };
+    return JSON.stringify(process(obj, 0));
 }
 const DROP_LOG_INTERVAL_MS = 10_000;
-function setIfDefined(value, setter) {
-    if (value === undefined)
-        return;
-    setter(value);
-}
-function assignServerValue(server, key, value) {
-    setIfDefined(value, (resolved) => {
-        server[key] = resolved;
-    });
-}
 export function applyHttpServerTuning(server) {
     const { headersTimeoutMs, requestTimeoutMs, keepAliveTimeoutMs, keepAliveTimeoutBufferMs, maxHeadersCount, maxConnections, } = config.server.http;
-    const tuningValues = [
-        ['headersTimeout', headersTimeoutMs],
-        ['requestTimeout', requestTimeoutMs],
-        ['keepAliveTimeout', keepAliveTimeoutMs],
-        ['keepAliveTimeoutBuffer', keepAliveTimeoutBufferMs],
-        ['maxHeadersCount', maxHeadersCount],
-    ];
-    for (const [key, value] of tuningValues) {
-        assignServerValue(server, key, value);
-    }
+    if (headersTimeoutMs !== undefined)
+        server.headersTimeout = headersTimeoutMs;
+    if (requestTimeoutMs !== undefined)
+        server.requestTimeout = requestTimeoutMs;
+    if (keepAliveTimeoutMs !== undefined)
+        server.keepAliveTimeout = keepAliveTimeoutMs;
+    if (keepAliveTimeoutBufferMs !== undefined)
+        server.keepAliveTimeoutBuffer = keepAliveTimeoutBufferMs;
+    if (maxHeadersCount !== undefined)
+        server.maxHeadersCount = maxHeadersCount;
     if (typeof maxConnections === 'number' && maxConnections > 0) {
         server.maxConnections = maxConnections;
         if (typeof server.on === 'function') {

package/dist/lib/zod.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare function formatZodError(error: z.ZodError): string;
+//# sourceMappingURL=zod.d.ts.map

package/dist/lib/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/lib/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAWxD"}

package/dist/lib/zod.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+function formatPathSegment(segment) {
+    if (typeof segment === 'number')
+        return `[${segment}]`;
+    if (typeof segment === 'string')
+        return segment;
+    return segment.description ?? '<symbol>';
+}
+function formatIssuePath(path) {
+    if (path.length === 0)
+        return '';
+    let result = '';
+    for (const segment of path) {
+        if (typeof segment === 'number') {
+            result += formatPathSegment(segment);
+            continue;
+        }
+        const normalized = formatPathSegment(segment);
+        result += result ? `.${normalized}` : normalized;
+    }
+    return result;
+}
+export function formatZodError(error) {
+    const parts = error.issues.map((issue) => {
+        const path = formatIssuePath(issue.path);
+        return path ? `${path}: ${issue.message}` : issue.message;
+    });
+    const unique = [...new Set(parts.filter((value) => value.trim().length > 0))];
+    if (unique.length > 0)
+        return unique.join('; ');
+    const pretty = z.prettifyError(error).replace(/\s+/g, ' ').trim();
+    return pretty || 'Invalid input';
+}

package/dist/prompts/index.d.ts

@@ -1,3 +1,4 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { IconInfo } from '../lib/types.js';
+import { type IconInfo } from '../lib/types.js';
 export declare function registerGetHelpPrompt(server: McpServer, instructions: string, iconInfo?: IconInfo): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CAwBN"}

package/dist/prompts/index.js

@@ -1,21 +1,10 @@
-function buildOptionalPromptIcons(iconInfo) {
-    return iconInfo
-        ? {
-            icons: [
-                {
-                    src: iconInfo.src,
-                    mimeType: iconInfo.mimeType,
-                },
-            ],
-        }
-        : {};
-}
+import { buildOptionalIcons } from '../lib/types.js';
 export function registerGetHelpPrompt(server, instructions, iconInfo) {
     const description = 'Return Fetch URL server instructions: workflows, cache usage, task mode, and error handling.';
     server.registerPrompt('get-help', {
         title: 'Get Help',
         description,
-        ...buildOptionalPromptIcons(iconInfo),
+        ...buildOptionalIcons(iconInfo),
     }, () => ({
         description,
         messages: [

package/dist/resources/index.d.ts

@@ -1,4 +1,5 @@
 import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { IconInfo } from '../lib/types.js';
+import { type IconInfo } from '../lib/types.js';
 export declare function registerInstructionResource(server: McpServer, instructions: string, iconInfo?: IconInfo): void;
 export declare function registerCacheResourceTemplate(server: McpServer, iconInfo?: IconInfo): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEf,MAAM,yCAAyC,CAAC;AAoBjD,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAgXpE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CAwBN;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,EACjB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CA4BN"}

package/dist/resources/index.js

@@ -3,8 +3,9 @@ import { ErrorCode, McpError, SubscribeRequestSchema, UnsubscribeRequestSchema,
 import { get as getCacheEntry, getEntryMeta, keys as listCacheKeys, onCacheUpdate, parseCachedPayload, parseCacheKey, resolveCachedPayloadContent, } from '../lib/core.js';
 import { logWarn } from '../lib/core.js';
 import { registerServerLifecycleCleanup } from '../lib/mcp-tools.js';
-import { RESOURCE_NOT_FOUND_ERROR_CODE } from '../lib/utils.js';
+import { buildOptionalIcons } from '../lib/types.js';
 import { isObject } from '../lib/utils.js';
+const RESOURCE_NOT_FOUND_ERROR_CODE = -32002;
 const CACHE_RESOURCE_TEMPLATE_URI = 'internal://cache/{namespace}/{hash}';
 const CACHE_RESOURCE_PREFIX = 'internal://cache/';
 const CACHE_NAMESPACE_PATTERN = /^[a-z0-9_-]{1,64}$/i;
@@ -18,18 +19,6 @@ function sortAndLimitValues(values) {
         .sort((left, right) => left.localeCompare(right))
         .slice(0, MAX_COMPLETION_VALUES);
 }
-function buildOptionalIcons(iconInfo) {
-    if (!iconInfo)
-        return {};
-    return {
-        icons: [
-            {
-                src: iconInfo.src,
-                mimeType: iconInfo.mimeType,
-            },
-        ],
-    };
-}
 function isValidCacheResourceParts(parts) {
     return (CACHE_NAMESPACE_PATTERN.test(parts.namespace) &&
         CACHE_HASH_PATTERN.test(parts.hash));
@@ -194,14 +183,11 @@ function normalizeSubscriptionUri(uri) {
         return toCacheResourceUri(cacheParts);
     return parsedUri.href;
 }
-// Must only be called once per server instance; duplicate calls would register
-// redundant Subscribe/Unsubscribe handlers and create a second onCacheUpdate
-// listener, causing duplicate notifications.
-let cacheNotificationsRegistered = false;
+const cacheNotificationServers = new WeakSet();
 function registerCacheResourceNotifications(server) {
-    if (cacheNotificationsRegistered)
+    if (cacheNotificationServers.has(server))
         return;
-    cacheNotificationsRegistered = true;
+    cacheNotificationServers.add(server);
     const subscribedResourceUris = new Set();
     const setSubscription = (uri, subscribed) => {
         const normalized = normalizeSubscriptionUri(uri);

package/dist/resources/instructions.d.ts

@@ -1 +1,2 @@
 export declare function buildServerInstructions(): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/resources/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/resources/instructions.ts"],"names":[],"mappings":"AAIA,wBAAgB,uBAAuB,IAAI,MAAM,CA2ChD"}

package/dist/resources/instructions.js

@@ -10,7 +10,9 @@ export function buildServerInstructions() {
 <capabilities>
 - Tools: \`${FETCH_URL_TOOL_NAME}\` (READ-ONLY).
 - Resources: \`internal://instructions\` (server usage guidance).
+- Resource templates: \`internal://cache/{namespace}/{hash}\` (cached markdown entries).
 - Prompts: \`get-help\` (returns these instructions).
+- Completions: resource-template argument completion for cache entries.
 </capabilities>
 
 <workflows>

package/dist/schemas/cache.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const cachedPayloadSchema: z.ZodObject<{
+    markdown: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        favicon: z.ZodOptional<z.ZodString>;
+        publishedAt: z.ZodOptional<z.ZodString>;
+        modifiedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export type CachedPayload = z.infer<typeof cachedPayloadSchema>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/schemas/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/schemas/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAY7B,CAAC;AAEJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/cache.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+const extractedMetadataSchema = z.strictObject({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    author: z.string().optional(),
+    image: z.string().optional(),
+    favicon: z.string().optional(),
+    publishedAt: z.string().optional(),
+    modifiedAt: z.string().optional(),
+});
+export const cachedPayloadSchema = z
+    .looseObject({
+    markdown: z.string().optional(),
+    content: z.string().optional(),
+    title: z.string().optional(),
+    metadata: extractedMetadataSchema.optional(),
+    truncated: z.boolean().optional(),
+})
+    .refine((value) => typeof value.markdown === 'string' || typeof value.content === 'string', { error: 'Missing markdown/content' });

package/dist/schemas/inputs.d.ts

@@ -5,3 +5,4 @@ export declare const fetchUrlInputSchema: z.ZodObject<{
     forceRefresh: z.ZodOptional<z.ZodBoolean>;
     maxInlineChars: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
+//# sourceMappingURL=inputs.d.ts.map

package/dist/schemas/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/schemas/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;;kBAuB9B,CAAC"}

package/dist/schemas/outputs.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 export declare const fetchUrlOutputSchema: z.ZodObject<{
-    url: z.ZodString;
-    inputUrl: z.ZodOptional<z.ZodString>;
-    resolvedUrl: z.ZodOptional<z.ZodString>;
-    finalUrl: z.ZodOptional<z.ZodString>;
+    url: z.ZodURL;
+    inputUrl: z.ZodOptional<z.ZodURL>;
+    resolvedUrl: z.ZodOptional<z.ZodURL>;
+    finalUrl: z.ZodOptional<z.ZodURL>;
     title: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
@@ -16,7 +16,8 @@ export declare const fetchUrlOutputSchema: z.ZodObject<{
     }, z.core.$strict>>;
     markdown: z.ZodOptional<z.ZodString>;
     fromCache: z.ZodOptional<z.ZodBoolean>;
-    fetchedAt: z.ZodOptional<z.ZodString>;
+    fetchedAt: z.ZodOptional<z.ZodISODateTime>;
     contentSize: z.ZodOptional<z.ZodNumber>;
     truncated: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
+//# sourceMappingURL=outputs.d.ts.map

package/dist/schemas/outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../../src/schemas/outputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;kBAkE/B,CAAC"}

package/dist/schemas/outputs.js

@@ -1,23 +1,19 @@
 import { z } from 'zod';
 import { config } from '../lib/core.js';
 export const fetchUrlOutputSchema = z.strictObject({
-    url: z
-        .string()
-        .min(1)
-        .max(config.constants.maxUrlLength)
-        .describe('Fetched URL.'),
+    url: z.httpUrl().max(config.constants.maxUrlLength).describe('Fetched URL.'),
     inputUrl: z
-        .string()
+        .httpUrl()
         .max(config.constants.maxUrlLength)
         .optional()
         .describe('Original requested URL.'),
     resolvedUrl: z
-        .string()
+        .httpUrl()
         .max(config.constants.maxUrlLength)
         .optional()
         .describe('Final URL after raw-content transformations.'),
     finalUrl: z
-        .string()
+        .httpUrl()
         .max(config.constants.maxUrlLength)
         .optional()
         .describe('Final URL after HTTP redirects.'),
@@ -60,7 +56,7 @@ export const fetchUrlOutputSchema = z.strictObject({
         .optional()
         .describe('Extracted Markdown. May be truncated (check truncated field).'),
     fromCache: z.boolean().optional().describe('True if served from cache.'),
-    fetchedAt: z.string().max(64).optional().describe('ISO timestamp of fetch.'),
+    fetchedAt: z.iso.datetime().optional().describe('ISO timestamp of fetch.'),
     contentSize: z
         .number()
         .int()

package/dist/server.d.ts

@@ -2,3 +2,4 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function createMcpServer(): Promise<McpServer>;
 export declare function createMcpServerForHttpSession(): Promise<McpServer>;
 export declare function startStdioServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkGpE,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAE1D;AA8CD,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,SAAS,CAAC,CAExE;AAkFD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD"}

package/dist/server.js

@@ -4,11 +4,11 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { SetLevelRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { config } from './lib/core.js';
-import { logError, logInfo, setLogLevel, setMcpServer } from './lib/core.js';
+import { getSessionId, logError, logInfo, setLogLevel, setMcpServer, } from './lib/core.js';
 import { abortAllTaskExecutions, registerTaskHandlers, } from './lib/mcp-tools.js';
 import { toError } from './lib/utils.js';
 import { registerGetHelpPrompt } from './prompts/index.js';
-import { registerInstructionResource } from './resources/index.js';
+import { registerCacheResourceTemplate, registerInstructionResource, } from './resources/index.js';
 import { buildServerInstructions } from './resources/instructions.js';
 import { registerAllTools } from './tools/index.js';
 import { shutdownTransformWorkerPool } from './transform/transform.js';
@@ -33,8 +33,10 @@ async function getLocalIconInfo() {
 const serverInstructions = buildServerInstructions();
 function createServerCapabilities() {
     return {
+        completions: {},
         logging: {},
         resources: { subscribe: true, listChanged: true },
+        // SDK auto-adds listChanged to tools capability at runtime.
         tools: {},
         prompts: {},
         tasks: {
@@ -84,10 +86,10 @@ async function createMcpServerWithOptions(options) {
     registerAllTools(server);
     registerGetHelpPrompt(server, serverInstructions, localIcon);
     registerInstructionResource(server, serverInstructions, localIcon);
-    // NOTE: Internally patches server.close and server.server.onclose for cleanup
-    // callbacks, and intercepts tools/call via Reflect.get on private SDK state.
-    // See src/lib/task-handlers.ts for risk documentation (S-2, S-3).
-    registerTaskHandlers(server);
+    registerCacheResourceTemplate(server, localIcon);
+    registerTaskHandlers(server, {
+        requireInterception: config.tasks.requireInterception,
+    });
     registerLoggingSetLevelHandler(server);
     attachServerErrorHandler(server);
     return server;
@@ -97,7 +99,7 @@ export async function createMcpServerForHttpSession() {
 }
 function registerLoggingSetLevelHandler(server) {
     server.server.setRequestHandler(SetLevelRequestSchema, (request) => {
-        setLogLevel(request.params.level);
+        setLogLevel(request.params.level, getSessionId());
         return {};
     });
 }

package/dist/tasks/execution.d.ts

@@ -39,3 +39,4 @@ export declare function emitTaskStatusNotification(server: McpServer, task: Task
 export declare function throwTaskNotFound(): never;
 export declare function handleToolCallRequest(server: McpServer, request: ExtendedCallToolRequest, context: ToolCallContext): Promise<ServerResult>;
 export {};
+//# sourceMappingURL=execution.d.ts.map

package/dist/tasks/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/tasks/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oCAAoC,CAAC;AAW5C,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAapB,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAChD,IAAI,CAAC,EACD;YACE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;SAC1B,GACD,SAAS,CAAC;QACd,KAAK,CAAC,EACF;YACE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;YAC5C,sCAAsC,CAAC,EACnC;gBAAE,MAAM,EAAE,MAAM,CAAA;aAAE,GAClB,SAAS,CAAC;YACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,GACD,SAAS,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAyBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKvD;AAMD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,SAA4D,GACxE,MAAM,CASR;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAgBD,KAAK,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5C,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,WAAW,CAUd;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACb,YAAY,CAYd;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,SAAS,GACd,IAAI,CAmBN;AAoBD,wBAAgB,iBAAiB,IAAI,KAAK,CAEzC;AAiND,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,CAAC,CAYvB"}

package/dist/tasks/execution.js

@@ -1,12 +1,12 @@
 import { ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
 import { config } from '../lib/core.js';
 import { logWarn, runWithRequestContext } from '../lib/core.js';
-import { getErrorMessage, RESOURCE_NOT_FOUND_ERROR_CODE, } from '../lib/utils.js';
+import { getErrorMessage } from '../lib/utils.js';
 import { isObject } from '../lib/utils.js';
 import { taskManager, } from './manager.js';
 import { compact, tryReadToolStructuredError, } from './owner.js';
 import { getTaskCapableTool, hasTaskCapableTool, } from './tool-registry.js';
-const TASK_NOT_FOUND_ERROR_CODE = RESOURCE_NOT_FOUND_ERROR_CODE;
+const TASK_NOT_FOUND_ERROR_CODE = ErrorCode.InvalidParams;
 /* -------------------------------------------------------------------------------------------------
  * Abort-controller management for in-flight task executions
  * ------------------------------------------------------------------------------------------------- */
@@ -59,11 +59,6 @@ export function toTaskSummary(task) {
         lastUpdatedAt: task.lastUpdatedAt,
         ttl: task.ttl,
         pollInterval: task.pollInterval,
-        _meta: {
-            'io.modelcontextprotocol/related-task': {
-                taskId: task.taskId,
-            },
-        },
     };
 }
 export function withRelatedTaskMeta(result, taskId) {
@@ -139,20 +134,7 @@ function buildRelatedTaskMeta(taskId, meta) {
     };
 }
 function buildCreateTaskResult(task) {
-    return {
-        task,
-        _meta: {
-            'io.modelcontextprotocol/related-task': {
-                taskId: task.taskId,
-                status: task.status,
-                ...(task.statusMessage ? { statusMessage: task.statusMessage } : {}),
-                createdAt: task.createdAt,
-                lastUpdatedAt: task.lastUpdatedAt,
-                ttl: task.ttl,
-                pollInterval: task.pollInterval,
-            },
-        },
-    };
+    return { task };
 }
 /* -------------------------------------------------------------------------------------------------
  * Execution pipeline

package/dist/tasks/manager.d.ts

@@ -20,6 +20,7 @@ interface CreateTaskOptions {
     ttl?: number;
 }
 export interface CreateTaskResult {
+    [key: string]: unknown;
     task: {
         taskId: string;
         status: TaskStatus;
@@ -28,13 +29,7 @@ export interface CreateTaskResult {
         lastUpdatedAt: string;
         ttl: number;
         pollInterval: number;
-        _meta?: {
-            'io.modelcontextprotocol/related-task': {
-                taskId: string;
-            };
-        };
     };
-    _meta?: Record<string, unknown>;
 }
 declare class TaskManager {
     private tasks;
@@ -81,3 +76,4 @@ declare class TaskManager {
 }
 export declare const taskManager: TaskManager;
 export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/tasks/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/tasks/manager.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAOD,UAAU,iBAAiB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,UAAU,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AA2BD,cAAM,WAAW;IACf,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,eAAe,CAA+C;IAEtE,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,kBAAkB;IAmB1B,UAAU,CACR,OAAO,CAAC,EAAE,iBAAiB,EAC3B,aAAa,SAAiB,EAC9B,QAAQ,GAAE,MAA0B,GACnC,SAAS;IA0BZ,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjE,UAAU,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC,GACxD,IAAI;IAWP,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAgBpE,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,aAAa,SAAkE,GAC9E,SAAS,EAAE;IAgBd,OAAO,CAAC,WAAW;IAwCnB,SAAS,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QACzE,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAiBD,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,YAAY;IAed,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IA6FjC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,wBAAwB;IAIhC,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa5C,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,iBAAiB;CAQ1B;AAgBD,eAAO,MAAM,WAAW,aAAoB,CAAC"}