@j0hanz/fetch-url-mcp 1.2.0 → 1.3.0

package/dist/tool-pipeline.js

@@ -0,0 +1,407 @@
+import { z } from 'zod';
+import * as cache from './cache.js';
+import { config } from './config.js';
+import { getErrorMessage } from './errors.js';
+import { fetchNormalizedUrlBuffer, normalizeUrl, transformToRawUrl, } from './fetch.js';
+import { logDebug, logWarn } from './observability.js';
+import { transformBufferToMarkdown } from './transform/transform.js';
+import { isObject } from './type-guards.js';
+function asRecord(value) {
+    return isObject(value) ? value : undefined;
+}
+export function readUnknown(obj, key) {
+    const record = asRecord(obj);
+    return record ? record[key] : undefined;
+}
+export function readString(obj, key) {
+    const value = readUnknown(obj, key);
+    return typeof value === 'string' ? value : undefined;
+}
+export function readNestedRecord(obj, keys) {
+    let current = obj;
+    for (const key of keys) {
+        current = readUnknown(current, key);
+        if (current === undefined)
+            return undefined;
+    }
+    return asRecord(current);
+}
+function safeJsonParse(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function withSignal(signal) {
+    return signal === undefined ? {} : { signal };
+}
+/* -------------------------------------------------------------------------------------------------
+ * Inline content limiting
+ * ------------------------------------------------------------------------------------------------- */
+export const TRUNCATION_MARKER = '...[truncated]';
+function getOpenCodeFence(content) {
+    const FENCE_PATTERN = /^([ \t]*)(`{3,}|~{3,})/gm;
+    let match;
+    let inFence = false;
+    let fenceChar = null;
+    let fenceLength = 0;
+    while ((match = FENCE_PATTERN.exec(content)) !== null) {
+        const marker = match[2];
+        if (!marker)
+            continue;
+        const [char] = marker;
+        if (!char)
+            continue;
+        const { length } = marker;
+        if (!inFence) {
+            inFence = true;
+            fenceChar = char;
+            fenceLength = length;
+        }
+        else if (char === fenceChar && length >= fenceLength) {
+            inFence = false;
+            fenceChar = null;
+            fenceLength = 0;
+        }
+    }
+    if (inFence && fenceChar) {
+        return { fenceChar, fenceLength };
+    }
+    return null;
+}
+function findSafeLinkBoundary(content, limit) {
+    const lastBracket = content.lastIndexOf('[', limit);
+    if (lastBracket === -1)
+        return limit;
+    const afterBracket = content.substring(lastBracket, limit);
+    const closedPattern = /^\[[^\]]*\]\([^)]*\)/;
+    if (closedPattern.test(afterBracket))
+        return limit;
+    const start = lastBracket > 0 && content[lastBracket - 1] === '!'
+        ? lastBracket - 1
+        : lastBracket;
+    return start;
+}
+function truncateWithMarker(content, limit, marker) {
+    if (content.length <= limit)
+        return content;
+    const maxContentLength = Math.max(0, limit - marker.length);
+    const tentativeContent = content.substring(0, maxContentLength);
+    const openFence = getOpenCodeFence(tentativeContent);
+    if (openFence) {
+        const fenceCloser = `\n${openFence.fenceChar.repeat(openFence.fenceLength)}\n`;
+        const adjustedLength = Math.max(0, limit - marker.length - fenceCloser.length);
+        return `${content.substring(0, adjustedLength)}${fenceCloser}${marker}`;
+    }
+    const safeBoundary = findSafeLinkBoundary(content, maxContentLength);
+    if (safeBoundary < maxContentLength) {
+        return `${content.substring(0, safeBoundary)}${marker}`.slice(0, limit);
+    }
+    return `${tentativeContent}${marker}`.slice(0, limit);
+}
+export function appendTruncationMarker(content, marker) {
+    if (!content)
+        return marker;
+    if (content.endsWith(marker))
+        return content;
+    const openFence = getOpenCodeFence(content);
+    const contentWithFence = openFence
+        ? `${content}\n${openFence.fenceChar.repeat(openFence.fenceLength)}\n`
+        : content;
+    const safeBoundary = findSafeLinkBoundary(contentWithFence, contentWithFence.length);
+    if (safeBoundary < contentWithFence.length) {
+        return `${contentWithFence.substring(0, safeBoundary)}${marker}`;
+    }
+    return `${contentWithFence}${marker}`;
+}
+class InlineContentLimiter {
+    apply(content, inlineLimitOverride) {
+        const contentSize = content.length;
+        const inlineLimit = this.resolveInlineLimit(inlineLimitOverride);
+        if (isWithinInlineLimit(contentSize, inlineLimit)) {
+            return { content, contentSize };
+        }
+        const truncatedContent = truncateWithMarker(content, inlineLimit, TRUNCATION_MARKER);
+        return {
+            content: truncatedContent,
+            contentSize,
+            truncated: true,
+        };
+    }
+    resolveInlineLimit(inlineLimitOverride) {
+        const globalLimit = config.constants.maxInlineContentChars;
+        if (inlineLimitOverride === undefined)
+            return globalLimit;
+        if (globalLimit > 0 && inlineLimitOverride > 0) {
+            return Math.min(inlineLimitOverride, globalLimit);
+        }
+        return inlineLimitOverride;
+    }
+}
+function isWithinInlineLimit(contentSize, inlineLimit) {
+    return inlineLimit <= 0 || contentSize <= inlineLimit;
+}
+const inlineLimiter = new InlineContentLimiter();
+function applyInlineContentLimit(content, inlineLimitOverride) {
+    return inlineLimiter.apply(content, inlineLimitOverride);
+}
+function createUrlResolution(params) {
+    return {
+        normalizedUrl: params.normalizedUrl,
+        originalUrl: params.originalUrl,
+        transformed: params.transformed,
+    };
+}
+function resolveNormalizedUrl(url) {
+    const { normalizedUrl: validatedUrl } = normalizeUrl(url);
+    const transformedResult = transformToRawUrl(validatedUrl);
+    if (!transformedResult.transformed) {
+        return createUrlResolution({
+            normalizedUrl: validatedUrl,
+            originalUrl: validatedUrl,
+            transformed: false,
+        });
+    }
+    const { normalizedUrl: transformedUrl } = normalizeUrl(transformedResult.url);
+    return createUrlResolution({
+        normalizedUrl: transformedUrl,
+        originalUrl: validatedUrl,
+        transformed: true,
+    });
+}
+function logRawUrlTransformation(resolvedUrl) {
+    if (!resolvedUrl.transformed)
+        return;
+    logDebug('Using transformed raw content URL', {
+        original: resolvedUrl.originalUrl,
+    });
+}
+/* -------------------------------------------------------------------------------------------------
+ * Cache helpers
+ * ------------------------------------------------------------------------------------------------- */
+function extractTitle(value) {
+    return readString(value, 'title');
+}
+function logCacheMiss(reason, cacheNamespace, normalizedUrl, error) {
+    const log = reason.startsWith('deserialize') ? logWarn : logDebug;
+    log(`Cache miss due to ${reason}`, {
+        namespace: cacheNamespace,
+        url: normalizedUrl,
+        ...(error ? { error: getErrorMessage(error) } : {}),
+    });
+}
+function createCacheHitResult(params) {
+    const finalUrl = params.cachedUrl !== params.normalizedUrl ? params.cachedUrl : undefined;
+    return {
+        data: params.data,
+        fromCache: true,
+        url: params.normalizedUrl,
+        ...(finalUrl ? { finalUrl } : {}),
+        fetchedAt: params.fetchedAt,
+        cacheKey: params.cacheKey,
+    };
+}
+function attemptCacheRetrieval(params) {
+    const { cacheKey, deserialize, cacheNamespace, normalizedUrl } = params;
+    if (!cacheKey)
+        return null;
+    const cached = cache.get(cacheKey);
+    if (!cached)
+        return null;
+    if (!deserialize) {
+        logCacheMiss('missing deserializer', cacheNamespace, normalizedUrl);
+        return null;
+    }
+    let data;
+    try {
+        data = deserialize(cached.content);
+    }
+    catch (error) {
+        logCacheMiss('deserialize exception', cacheNamespace, normalizedUrl, error);
+        return null;
+    }
+    if (data === undefined) {
+        logCacheMiss('deserialize failure', cacheNamespace, normalizedUrl);
+        return null;
+    }
+    logDebug('Cache hit', { namespace: cacheNamespace, url: normalizedUrl });
+    return createCacheHitResult({
+        data,
+        normalizedUrl,
+        cachedUrl: cached.url,
+        fetchedAt: cached.fetchedAt,
+        cacheKey,
+    });
+}
+function persistCache(params) {
+    const { cacheKey, data, serialize, normalizedUrl, cacheNamespace, force } = params;
+    if (!cacheKey)
+        return;
+    const serializer = serialize ?? JSON.stringify;
+    const title = extractTitle(data);
+    const metadata = {
+        url: normalizedUrl,
+        ...(title === undefined ? {} : { title }),
+    };
+    try {
+        cache.set(cacheKey, serializer(data), metadata, force ? { force: true } : undefined);
+    }
+    catch (error) {
+        logWarn('Failed to persist cache entry', {
+            namespace: cacheNamespace,
+            url: normalizedUrl,
+            error: getErrorMessage(error),
+        });
+    }
+}
+/* -------------------------------------------------------------------------------------------------
+ * Pipeline executor
+ * ------------------------------------------------------------------------------------------------- */
+export async function executeFetchPipeline(options) {
+    const resolvedUrl = resolveNormalizedUrl(options.url);
+    logRawUrlTransformation(resolvedUrl);
+    const cacheKey = cache.createCacheKey(options.cacheNamespace, resolvedUrl.normalizedUrl, options.cacheVary);
+    if (!options.forceRefresh) {
+        const cachedResult = attemptCacheRetrieval({
+            cacheKey,
+            deserialize: options.deserialize,
+            cacheNamespace: options.cacheNamespace,
+            normalizedUrl: resolvedUrl.normalizedUrl,
+        });
+        if (cachedResult) {
+            return { ...cachedResult, originalUrl: resolvedUrl.originalUrl };
+        }
+    }
+    logDebug('Fetching URL', { url: resolvedUrl.normalizedUrl });
+    const { buffer, encoding, truncated, finalUrl } = await fetchNormalizedUrlBuffer(resolvedUrl.normalizedUrl, withSignal(options.signal));
+    const transformUrl = finalUrl || resolvedUrl.normalizedUrl;
+    const data = await options.transform({ buffer, encoding, ...(truncated ? { truncated: true } : {}) }, transformUrl);
+    if (cache.isEnabled()) {
+        persistCache({
+            cacheKey,
+            data,
+            serialize: options.serialize,
+            normalizedUrl: finalUrl || resolvedUrl.normalizedUrl,
+            cacheNamespace: options.cacheNamespace,
+        });
+        if (finalUrl && finalUrl !== resolvedUrl.normalizedUrl) {
+            const finalCacheKey = cache.createCacheKey(options.cacheNamespace, finalUrl, options.cacheVary);
+            if (finalCacheKey && finalCacheKey !== cacheKey) {
+                persistCache({
+                    cacheKey: finalCacheKey,
+                    data,
+                    serialize: options.serialize,
+                    normalizedUrl: finalUrl,
+                    cacheNamespace: options.cacheNamespace,
+                });
+            }
+        }
+    }
+    return {
+        data,
+        fromCache: false,
+        url: resolvedUrl.normalizedUrl,
+        originalUrl: resolvedUrl.originalUrl,
+        finalUrl,
+        fetchedAt: new Date().toISOString(),
+        cacheKey,
+    };
+}
+function normalizeExtractedMetadata(metadata) {
+    if (!metadata)
+        return undefined;
+    const normalized = {
+        ...(metadata.title ? { title: metadata.title } : {}),
+        ...(metadata.description ? { description: metadata.description } : {}),
+        ...(metadata.author ? { author: metadata.author } : {}),
+        ...(metadata.image ? { image: metadata.image } : {}),
+        ...(metadata.favicon ? { favicon: metadata.favicon } : {}),
+        ...(metadata.publishedAt ? { publishedAt: metadata.publishedAt } : {}),
+        ...(metadata.modifiedAt ? { modifiedAt: metadata.modifiedAt } : {}),
+    };
+    if (Object.keys(normalized).length === 0)
+        return undefined;
+    return normalized;
+}
+const cachedMarkdownSchema = z
+    .object({
+    markdown: z.string().optional(),
+    content: z.string().optional(),
+    title: z.string().optional(),
+    metadata: 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(),
+    })
+        .optional(),
+    truncated: z.boolean().optional(),
+})
+    .catchall(z.unknown())
+    .refine((value) => typeof value.markdown === 'string' || typeof value.content === 'string', { message: 'Missing markdown/content' });
+export function parseCachedMarkdownResult(cached) {
+    const parsed = safeJsonParse(cached);
+    const result = cachedMarkdownSchema.safeParse(parsed);
+    if (!result.success)
+        return undefined;
+    const markdown = result.data.markdown ?? result.data.content;
+    if (typeof markdown !== 'string')
+        return undefined;
+    const metadata = normalizeExtractedMetadata(result.data.metadata);
+    const truncated = result.data.truncated ?? false;
+    const persistedMarkdown = truncated
+        ? appendTruncationMarker(markdown, TRUNCATION_MARKER)
+        : markdown;
+    return {
+        content: persistedMarkdown,
+        markdown: persistedMarkdown,
+        title: result.data.title,
+        ...(metadata ? { metadata } : {}),
+        truncated,
+    };
+}
+export const markdownTransform = async (input, url, signal, skipNoiseRemoval) => {
+    const result = await transformBufferToMarkdown(input.buffer, url, {
+        includeMetadata: true,
+        encoding: input.encoding,
+        ...withSignal(signal),
+        ...(skipNoiseRemoval ? { skipNoiseRemoval: true } : {}),
+        ...(input.truncated ? { inputTruncated: true } : {}),
+    });
+    const truncated = Boolean(result.truncated || input.truncated);
+    return { ...result, content: result.markdown, truncated };
+};
+export function serializeMarkdownResult(result) {
+    const persistedMarkdown = result.truncated
+        ? appendTruncationMarker(result.markdown, TRUNCATION_MARKER)
+        : result.markdown;
+    return JSON.stringify({
+        markdown: persistedMarkdown,
+        title: result.title,
+        metadata: result.metadata,
+        truncated: result.truncated,
+    });
+}
+export async function performSharedFetch(options, deps = {}) {
+    const executePipeline = deps.executeFetchPipeline ?? executeFetchPipeline;
+    const pipelineOptions = {
+        url: options.url,
+        cacheNamespace: 'markdown',
+        ...withSignal(options.signal),
+        ...(options.cacheVary ? { cacheVary: options.cacheVary } : {}),
+        ...(options.forceRefresh ? { forceRefresh: true } : {}),
+        transform: options.transform,
+        ...(options.serialize ? { serialize: options.serialize } : {}),
+        ...(options.deserialize ? { deserialize: options.deserialize } : {}),
+    };
+    const pipeline = await executePipeline(pipelineOptions);
+    const inlineResult = applyInlineContentLimit(pipeline.data.content, options.maxInlineChars);
+    return { pipeline, inlineResult };
+}
+//# sourceMappingURL=tool-pipeline.js.map

package/dist/tool-pipeline.js.map

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

package/dist/tool-progress.d.ts

@@ -0,0 +1,32 @@
+type ProgressToken = string | number;
+interface RequestMeta {
+    progressToken?: ProgressToken | undefined;
+    [key: string]: unknown;
+}
+export interface ProgressNotificationParams {
+    progressToken: ProgressToken;
+    progress: number;
+    total?: number;
+    message?: string;
+    _meta?: Record<string, unknown>;
+}
+export interface ProgressNotification {
+    method: 'notifications/progress';
+    params: ProgressNotificationParams;
+}
+export interface ToolHandlerExtra {
+    signal?: AbortSignal;
+    requestId?: string | number;
+    sessionId?: unknown;
+    requestInfo?: unknown;
+    _meta?: RequestMeta;
+    sendNotification?: (notification: ProgressNotification) => Promise<void>;
+    onProgress?: (progress: number, message: string) => void;
+}
+export interface ProgressReporter {
+    report: (progress: number, message: string) => Promise<void>;
+}
+export declare const FETCH_PROGRESS_TOTAL = 4;
+export declare function createProgressReporter(extra?: ToolHandlerExtra): ProgressReporter;
+export {};
+//# sourceMappingURL=tool-progress.d.ts.map

package/dist/tool-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-progress.d.ts","sourceRoot":"","sources":["../src/tool-progress.ts"],"names":[],"mappings":"AAQA,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC,UAAU,WAAW;IACnB,aAAa,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,0BAA0B,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAMD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAgItC,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,gBAAgB,GACvB,gBAAgB,CAElB"}

package/dist/tool-progress.js

@@ -0,0 +1,123 @@
+import { getErrorMessage } from './errors.js';
+import { logWarn } from './observability.js';
+import { isObject } from './type-guards.js';
+/* -------------------------------------------------------------------------------------------------
+ * Constants
+ * ------------------------------------------------------------------------------------------------- */
+export const FETCH_PROGRESS_TOTAL = 4;
+const PROGRESS_NOTIFICATION_TIMEOUT_MS = 5000;
+/* -------------------------------------------------------------------------------------------------
+ * Helpers
+ * ------------------------------------------------------------------------------------------------- */
+function resolveRelatedTaskMeta(meta) {
+    if (!meta)
+        return undefined;
+    const related = meta['io.modelcontextprotocol/related-task'];
+    if (!isObject(related))
+        return undefined;
+    const { taskId } = related;
+    return typeof taskId === 'string' ? { taskId } : undefined;
+}
+/* -------------------------------------------------------------------------------------------------
+ * Progress reporter
+ * ------------------------------------------------------------------------------------------------- */
+class ToolProgressReporter {
+    token;
+    sendNotification;
+    relatedTaskMeta;
+    onProgress;
+    reportQueue = Promise.resolve();
+    isTerminal = false;
+    lastProgress = -1;
+    constructor(token, sendNotification, relatedTaskMeta, onProgress) {
+        this.token = token;
+        this.sendNotification = sendNotification;
+        this.relatedTaskMeta = relatedTaskMeta;
+        this.onProgress = onProgress;
+    }
+    static create(extra) {
+        const token = extra?._meta?.progressToken ?? null;
+        const sendNotification = extra?.sendNotification;
+        const relatedTaskMeta = resolveRelatedTaskMeta(extra?._meta);
+        const onProgress = extra?.onProgress;
+        if (token === null && !onProgress) {
+            return { report: async () => { } };
+        }
+        return new ToolProgressReporter(token, sendNotification, relatedTaskMeta, onProgress);
+    }
+    async report(progress, message) {
+        if (this.isTerminal)
+            return;
+        const effectiveProgress = Math.max(progress, this.lastProgress);
+        const isIncreasing = effectiveProgress > this.lastProgress;
+        this.lastProgress = effectiveProgress;
+        if (effectiveProgress >= FETCH_PROGRESS_TOTAL) {
+            this.isTerminal = true;
+        }
+        if (this.onProgress) {
+            try {
+                this.onProgress(effectiveProgress, message);
+            }
+            catch (error) {
+                logWarn('Progress callback failed', {
+                    error: getErrorMessage(error),
+                    progress: effectiveProgress,
+                    message,
+                });
+            }
+        }
+        if (!isIncreasing || this.token === null || !this.sendNotification)
+            return;
+        const { sendNotification } = this;
+        const notification = {
+            method: 'notifications/progress',
+            params: {
+                progressToken: this.token,
+                progress: effectiveProgress,
+                total: FETCH_PROGRESS_TOTAL,
+                message,
+                ...(this.relatedTaskMeta
+                    ? {
+                        _meta: {
+                            'io.modelcontextprotocol/related-task': this.relatedTaskMeta,
+                        },
+                    }
+                    : {}),
+            },
+        };
+        this.reportQueue = this.reportQueue.then(async () => {
+            let timeoutId;
+            const timeoutPromise = new Promise((resolve) => {
+                timeoutId = setTimeout(() => {
+                    resolve({ timeout: true });
+                }, PROGRESS_NOTIFICATION_TIMEOUT_MS);
+                timeoutId.unref();
+            });
+            try {
+                const outcome = await Promise.race([
+                    sendNotification(notification).then(() => ({ ok: true })),
+                    timeoutPromise,
+                ]);
+                if ('timeout' in outcome) {
+                    logWarn('Progress notification timed out', { progress, message });
+                }
+            }
+            catch (error) {
+                logWarn('Failed to send progress notification', {
+                    error: getErrorMessage(error),
+                    progress,
+                    message,
+                });
+            }
+            finally {
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+            }
+        });
+        await this.reportQueue;
+    }
+}
+export function createProgressReporter(extra) {
+    return ToolProgressReporter.create(extra);
+}
+//# sourceMappingURL=tool-progress.js.map

package/dist/tool-progress.js.map

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