@cyanheads/interpro-mcp-server 0.0.0-stage → 0.1.2

package/dist/services/interpro/budget.js

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Shared byte budget for one tool result's domain output, and whole-item fitting.
+ * @module services/interpro/budget
+ */
+/** Most UTF-8 bytes one result's domain output may occupy when serialized as compact JSON. */
+export const RESPONSE_BYTE_BUDGET = 100_000;
+/** UTF-8 bytes of a value serialized as compact JSON, the form both result surfaces carry. */
+export function jsonByteLength(value) {
+    return Buffer.byteLength(JSON.stringify(value), 'utf8');
+}
+/**
+ * The largest count from 1 to `max` whose `build(count)` fits {@link RESPONSE_BYTE_BUDGET},
+ * found by binary search on the assumption that the built size grows with the count. Returns 1
+ * when even one item overflows, so a continuation always advances, and 0 when none remain.
+ */
+export function largestFittingCount(max, build) {
+    if (max <= 0)
+        return 0;
+    let fits = 1;
+    let overflows = max + 1;
+    while (overflows - fits > 1) {
+        const middle = Math.floor((fits + overflows) / 2);
+        if (jsonByteLength(build(middle)) <= RESPONSE_BYTE_BUDGET)
+            fits = middle;
+        else
+            overflows = middle;
+    }
+    return fits;
+}
+/** The budget as it reads in notices. */
+export const BUDGET_LABEL = `${RESPONSE_BYTE_BUDGET.toLocaleString('en-US')}-byte response budget`;
+/**
+ * Builds the largest whole-item output that fits the budget. `oversized` is set when even the
+ * smallest non-empty output exceeds it, so the output carries one indivisible item alone.
+ */
+export function fitWithinBudget(max, build) {
+    const count = largestFittingCount(max, build);
+    const output = build(count);
+    return { count, output, oversized: count > 0 && jsonByteLength(output) > RESPONSE_BYTE_BUDGET };
+}
+//# sourceMappingURL=budget.js.map

package/dist/services/interpro/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/services/interpro/budget.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,KAAiC;IAChF,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACvB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC;IACxB,OAAO,SAAS,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,oBAAoB;YAAE,IAAI,GAAG,MAAM,CAAC;;YACpE,SAAS,GAAG,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,uBAAuB,CAAC;AAEnG;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,KAA2B;IAE3B,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,oBAAoB,EAAE,CAAC;AAClG,CAAC"}

package/dist/services/interpro/cursors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Query-bound, versioned pagination tokens.
+ * @module services/interpro/cursors
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/** Deterministic canonical scope, independent of object key insertion order. */
+export declare function cursorScope(value: unknown): string;
+/** Code-unit string order, the tiebreak used wherever a page boundary must be deterministic. */
+export declare const compareText: (a: string, b: string) => -1 | 0 | 1;
+/** Encode only the continuation value, never an upstream request URL. */
+export declare function encodeCursor(operation: string, scope: unknown, upstreamCursor: string): string;
+/** Reject malformed tokens and tokens reused with a changed target or filter. */
+export declare function decodeCursor(token: string | undefined, operation: string, scope: unknown): string | undefined;
+/** Encode a tool-defined resumption point, for walks that can stop inside an upstream page. */
+export declare function encodePositionCursor(operation: string, scope: unknown, position: unknown): string;
+/** Decode a resumption point and validate it against the tool's own position schema. */
+export declare function decodePositionCursor<T extends z.ZodType>(token: string | undefined, operation: string, scope: unknown, schema: T): z.output<T> | undefined;
+/**
+ * Truncation guidance for a capped cursor page: the call that continues it, plus a larger
+ * `limit` only while the current one is below the tool's maximum.
+ */
+export declare function pageGuidance(toolName: string, noun: string, limit: number, maxLimit: number): string;
+/** Extract the sole usable continuation field without trusting URL origin/path. */
+export declare function continuation(next: string | null, seen?: ReadonlySet<string>): string | undefined;
+//# sourceMappingURL=cursors.d.ts.map

package/dist/services/interpro/cursors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.d.ts","sourceRoot":"","sources":["../../../src/services/interpro/cursors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAsB3C,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMlD;AACD,gGAAgG;AAChG,eAAO,MAAM,WAAW,MAAO,MAAM,KAAK,MAAM,eAAiC,CAAC;AAkClF,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAE9F;AACD,iFAAiF;AACjF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,SAAS,CAKpB;AACD,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAEjG;AACD,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACtD,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,CAAC,GACR,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAEzB;AACD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AACD,mFAAmF;AACnF,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GACpC,MAAM,GAAG,SAAS,CAkBpB"}

package/dist/services/interpro/cursors.js

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview Query-bound, versioned pagination tokens.
+ * @module services/interpro/cursors
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { serviceUnavailable, validationError } from '@cyanheads/mcp-ts-core/errors';
+import { API_BASE } from './routing.js';
+/**
+ * Every token carries exactly one continuation: the upstream cursor of the next page, or a
+ * tool-defined position for a walk that resumes inside a page.
+ */
+const CursorSchema = z
+    .object({
+    v: z.literal(1),
+    operation: z.string().min(1),
+    scope: z.string(),
+    upstreamCursor: z.string().min(1).optional(),
+    position: z.json().optional(),
+})
+    .strict()
+    .refine((cursor) => (cursor.upstreamCursor === undefined) !== (cursor.position === undefined), 'A cursor carries exactly one continuation.');
+/** Deterministic canonical scope, independent of object key insertion order. */
+export function cursorScope(value) {
+    return JSON.stringify(value, (_key, item) => item && typeof item === 'object' && !Array.isArray(item)
+        ? Object.fromEntries(Object.entries(item).sort(([a], [b]) => a.localeCompare(b)))
+        : item);
+}
+/** Code-unit string order, the tiebreak used wherever a page boundary must be deterministic. */
+export const compareText = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+function seal(operation, scope, resumption) {
+    const token = Buffer.from(JSON.stringify({ v: 1, operation, scope: cursorScope(scope), ...resumption })).toString('base64url');
+    if (token.length > 4096)
+        throw serviceUnavailable('InterPro continuation exceeds the supported token size.', {
+            reason: 'upstream_shape_invalid',
+            retryable: false,
+        });
+    return token;
+}
+function open(token, operation, scope, read) {
+    if (token === undefined)
+        return undefined;
+    try {
+        if (token.length > 4096 || !/^[A-Za-z0-9_-]+$/.test(token))
+            throw new Error('Invalid cursor encoding.');
+        const parsed = CursorSchema.parse(JSON.parse(Buffer.from(token, 'base64url').toString('utf8')));
+        if (parsed.operation !== operation || parsed.scope !== cursorScope(scope))
+            throw new Error('Cursor scope differs.');
+        return read(parsed);
+    }
+    catch (cause) {
+        throw validationError('Cursor is invalid or belongs to a different query.', { reason: 'invalid_cursor', retryable: false }, { cause });
+    }
+}
+/** Encode only the continuation value, never an upstream request URL. */
+export function encodeCursor(operation, scope, upstreamCursor) {
+    return seal(operation, scope, { upstreamCursor });
+}
+/** Reject malformed tokens and tokens reused with a changed target or filter. */
+export function decodeCursor(token, operation, scope) {
+    return open(token, operation, scope, ({ upstreamCursor }) => {
+        if (upstreamCursor === undefined)
+            throw new Error('Cursor carries no upstream continuation.');
+        return upstreamCursor;
+    });
+}
+/** Encode a tool-defined resumption point, for walks that can stop inside an upstream page. */
+export function encodePositionCursor(operation, scope, position) {
+    return seal(operation, scope, { position });
+}
+/** Decode a resumption point and validate it against the tool's own position schema. */
+export function decodePositionCursor(token, operation, scope, schema) {
+    return open(token, operation, scope, ({ position }) => schema.parse(position));
+}
+/**
+ * Truncation guidance for a capped cursor page: the call that continues it, plus a larger
+ * `limit` only while the current one is below the tool's maximum.
+ */
+export function pageGuidance(toolName, noun, limit, maxLimit) {
+    return `More ${noun} remain: repeat ${toolName} with the same arguments and cursor set to page.nextCursor${limit < maxLimit ? `; limit may rise to ${maxLimit} for larger pages` : ''}.`;
+}
+/** Extract the sole usable continuation field without trusting URL origin/path. */
+export function continuation(next, seen = new Set()) {
+    if (next === null)
+        return undefined;
+    let cursor;
+    try {
+        cursor = new URL(next, API_BASE).searchParams.get('cursor');
+    }
+    catch (cause) {
+        throw serviceUnavailable('InterPro returned an invalid continuation URL.', { reason: 'upstream_shape_invalid', retryable: false }, { cause });
+    }
+    if (!cursor?.trim() || seen.has(cursor))
+        throw serviceUnavailable('InterPro returned a missing or repeated continuation cursor.', {
+            reason: 'upstream_shape_invalid',
+            retryable: false,
+        });
+    return cursor;
+}
+//# sourceMappingURL=cursors.js.map

package/dist/services/interpro/cursors.js.map

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

package/dist/services/interpro/description-text.d.ts

@@ -0,0 +1,3 @@
+/** Decode description fragments without executing markup or changing the source description. */
+export declare function descriptionText(description: unknown): string | undefined;
+//# sourceMappingURL=description-text.d.ts.map

package/dist/services/interpro/description-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-text.d.ts","sourceRoot":"","sources":["../../../src/services/interpro/description-text.ts"],"names":[],"mappings":"AAwBA,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA0IxE"}

package/dist/services/interpro/description-text.js

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview Readable projection of InterPro HTML description fragments.
+ * @module services/interpro/description-text
+ */
+import { Tokenizer } from 'htmlparser2';
+const PARAGRAPHS = new Set([
+    'p',
+    'div',
+    'section',
+    'article',
+    'blockquote',
+    'pre',
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'table',
+    'dl',
+]);
+const REFERENCES = /\b(?:IPR[0-9]{6}|PUB[0-9]+)\b/gi;
+/** Decode description fragments without executing markup or changing the source description. */
+export function descriptionText(description) {
+    const fragments = typeof description === 'string'
+        ? [description]
+        : Array.isArray(description)
+            ? description.flatMap((item) => item && typeof item === 'object' && 'text' in item && typeof item.text === 'string'
+                ? [item.text]
+                : [])
+            : [];
+    const rendered = fragments
+        .map((fragment) => {
+        const chunks = [];
+        let pending = '';
+        let bullet = false;
+        let listDepth = 0;
+        let suppressed;
+        let openingTag = '';
+        let attributeName = '';
+        let attributeChunks = [];
+        let href;
+        let anchor;
+        const boundary = (separator) => {
+            const rank = (value) => value === '\n\n' ? 4 : value === '\n' ? 3 : value === '\t' ? 2 : value === ' ' ? 1 : 0;
+            if (rank(separator) > rank(pending))
+                pending = separator;
+        };
+        const open = (name) => {
+            if (name === 'script' || name === 'style')
+                suppressed = name;
+            if (suppressed)
+                return;
+            if (name === 'a') {
+                closeAnchor();
+                if (href)
+                    anchor = { href, text: [] };
+            }
+            if (name === 'ul' || name === 'ol') {
+                if (!listDepth)
+                    boundary('\n\n');
+                listDepth += 1;
+            }
+            else if (name === 'li') {
+                boundary('\n');
+                bullet = true;
+            }
+            else if (PARAGRAPHS.has(name))
+                boundary('\n\n');
+            else if (name === 'br' || name === 'tr' || name === 'dt' || name === 'dd')
+                boundary('\n');
+        };
+        const append = (value) => {
+            if (suppressed)
+                return;
+            anchor?.text.push(value);
+            const normalized = value.replace(/[\t\n\f\r ]+/g, ' ');
+            const text = normalized.trim();
+            if (text) {
+                if (chunks.length)
+                    chunks.push(pending || (normalized.startsWith(' ') ? ' ' : ''));
+                if (bullet)
+                    chunks.push('- ');
+                chunks.push(text);
+                pending = normalized.endsWith(' ') ? ' ' : '';
+                bullet = false;
+            }
+            else if (normalized)
+                boundary(' ');
+        };
+        const closeAnchor = () => {
+            if (!anchor)
+                return;
+            const visible = new Set([...anchor.text.join('').matchAll(REFERENCES)].map(([token]) => token.toUpperCase()));
+            const references = new Set([...anchor.href.matchAll(REFERENCES)].map(([token]) => token.toUpperCase()));
+            anchor = undefined;
+            const missing = [...references].filter((token) => !visible.has(token));
+            if (missing.length)
+                append(` (${missing.join(', ')})`);
+        };
+        const close = (name) => {
+            if (name === suppressed) {
+                suppressed = undefined;
+                return;
+            }
+            if (suppressed)
+                return;
+            if (name === 'a')
+                closeAnchor();
+            if (name === 'ul' || name === 'ol') {
+                listDepth = Math.max(0, listDepth - 1);
+                boundary(listDepth ? '\n' : '\n\n');
+            }
+            else if (name === 'li') {
+                bullet = false;
+                boundary('\n');
+            }
+            else if (PARAGRAPHS.has(name))
+                boundary('\n\n');
+            else if (name === 'tr' || name === 'dt' || name === 'dd')
+                boundary('\n');
+            else if (name === 'td' || name === 'th')
+                boundary('\t');
+        };
+        /** Token callbacks need no open-element stack; even deeply nested fragments stay streaming. */
+        const tokenizer = new Tokenizer({ decodeEntities: true }, {
+            onopentagname(start, end) {
+                openingTag = fragment.slice(start, end).toLowerCase();
+                href = undefined;
+            },
+            onopentagend() {
+                open(openingTag);
+            },
+            onselfclosingtag() {
+                open(openingTag);
+                if (openingTag !== 'script' && openingTag !== 'style')
+                    close(openingTag);
+            },
+            onclosetag(start, end) {
+                close(fragment.slice(start, end).toLowerCase());
+            },
+            ontext(start, end) {
+                append(fragment.slice(start, end));
+            },
+            ontextentity(codepoint) {
+                append(String.fromCodePoint(codepoint));
+            },
+            onattribdata(start, end) {
+                if (attributeName === 'href')
+                    attributeChunks.push(fragment.slice(start, end));
+            },
+            onattribentity(codepoint) {
+                if (attributeName === 'href')
+                    attributeChunks.push(String.fromCodePoint(codepoint));
+            },
+            onattribend() {
+                if (attributeName === 'href')
+                    href = attributeChunks.join('');
+            },
+            onattribname(start, end) {
+                attributeName = fragment.slice(start, end).toLowerCase();
+                attributeChunks = [];
+            },
+            oncdata() { },
+            oncomment() { },
+            ondeclaration() { },
+            onprocessinginstruction() { },
+            onend() {
+                closeAnchor();
+            },
+        });
+        tokenizer.write(fragment);
+        tokenizer.end();
+        return chunks.join('');
+    })
+        .filter(Boolean);
+    return rendered.length ? rendered.join('\n\n') : undefined;
+}
+//# sourceMappingURL=description-text.js.map

package/dist/services/interpro/description-text.js.map

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

package/dist/services/interpro/format.d.ts

@@ -0,0 +1,17 @@
+/** Convert Wikipedia's base64 thumbnail strings to data URIs before constructing either output surface. */
+export declare function normalizeImages<T>(value: T): T;
+/**
+ * Keep or drop the base64 `thumbnail` on each Wikipedia page of a detail record. Dropping it
+ * removes only that key, so every other page field survives, and the returned notice states
+ * what was removed and names `includeThumbnail: true` on `toolName` as the way to get it.
+ */
+export declare function projectWikipediaThumbnails<T extends Record<string, unknown>>(metadata: T, include: boolean, toolName: string): {
+    metadata: T;
+    notice?: string;
+};
+/** Emit every field losslessly as compact JSON; source text remains inert inside a growing fence. */
+export declare function formatInterpro(value: unknown): {
+    type: 'text';
+    text: string;
+}[];
+//# sourceMappingURL=format.d.ts.map

package/dist/services/interpro/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/services/interpro/format.ts"],"names":[],"mappings":"AAyBA,2GAA2G;AAC3G,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAW9C;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,GACf;IAAE,QAAQ,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBlC;AAED,qGAAqG;AACrG,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CA4D/E"}

package/dist/services/interpro/format.js

@@ -0,0 +1,130 @@
+/**
+ * @fileoverview Reversible JSON output with usable source URL and image indexes.
+ * @module services/interpro/format
+ */
+import { markdown } from '@cyanheads/mcp-ts-core/utils';
+/** Base64 prefixes of the image formats Wikipedia thumbnails arrive in, with their media types. */
+const THUMBNAIL_SIGNATURES = [
+    ['iVBORw0KGgo', 'image/png'],
+    ['/9j/', 'image/jpeg'],
+    ['R0lGOD', 'image/gif'],
+];
+/** The whole string is standard base64, padded only at the end. */
+const BASE64 = /^[A-Za-z0-9+/]+={0,2}$/;
+/** The whole string is a base64 PNG, JPEG, or GIF data URI: the only data URI indexed as an image. */
+const DATA_IMAGE = /^data:image\/(?:png|jpeg|gif);base64,[A-Za-z0-9+/]+={0,2}$/;
+/** An image file extension at the end of a URL path. */
+const IMAGE_PATH = /\.(?:png|jpe?g|gif|webp|svg|avif)$/i;
+function thumbnailDataUri(item) {
+    if (!BASE64.test(item))
+        return undefined;
+    const mediaType = THUMBNAIL_SIGNATURES.find(([prefix]) => item.startsWith(prefix))?.[1];
+    return mediaType && `data:${mediaType};base64,${item}`;
+}
+/** Convert Wikipedia's base64 thumbnail strings to data URIs before constructing either output surface. */
+export function normalizeImages(value) {
+    if (Array.isArray(value))
+        return value.map(normalizeImages);
+    if (value && typeof value === 'object')
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+            key,
+            (key === 'thumbnail' && typeof item === 'string' && thumbnailDataUri(item)) ||
+                normalizeImages(item),
+        ]));
+    return value;
+}
+/**
+ * Keep or drop the base64 `thumbnail` on each Wikipedia page of a detail record. Dropping it
+ * removes only that key, so every other page field survives, and the returned notice states
+ * what was removed and names `includeThumbnail: true` on `toolName` as the way to get it.
+ */
+export function projectWikipediaThumbnails(metadata, include, toolName) {
+    if (include)
+        return { metadata };
+    let count = 0;
+    let bytes = 0;
+    const strip = (page) => {
+        if (!page || typeof page !== 'object' || Array.isArray(page))
+            return page;
+        const { thumbnail, ...rest } = page;
+        if (typeof thumbnail !== 'string' || thumbnail === '')
+            return page;
+        count += 1;
+        bytes += thumbnail.length;
+        return rest;
+    };
+    const { wikipedia } = metadata;
+    const pages = Array.isArray(wikipedia) ? wikipedia.map(strip) : strip(wikipedia);
+    if (!count)
+        return { metadata };
+    const subject = count === 1 ? 'the Wikipedia thumbnail' : `${count} Wikipedia thumbnails`;
+    return {
+        metadata: { ...metadata, wikipedia: pages },
+        notice: `Omitted ${subject} (${bytes.toLocaleString('en-US')} bytes of base64 image data); repeat ${toolName} with includeThumbnail: true to include ${count === 1 ? 'it' : 'them'}.`,
+    };
+}
+/** Emit every field losslessly as compact JSON; source text remains inert inside a growing fence. */
+export function formatInterpro(value) {
+    const urls = new Set();
+    const images = new Set();
+    /**
+     * Record a parseable URL. A whole-string value whose path has an image extension is also an
+     * image; a URL found inside prose is only a link, since clients fetch images unprompted.
+     */
+    const addUrl = (candidate, whole) => {
+        try {
+            const { pathname } = new URL(candidate);
+            urls.add(candidate);
+            if (whole && IMAGE_PATH.test(pathname))
+                images.add(candidate);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const inspect = (item) => {
+        if (typeof item === 'string') {
+            if (DATA_IMAGE.test(item)) {
+                images.add(item);
+                return;
+            }
+            if (/^https?:\/\//.test(item) && !/[\s\p{Cc}]/u.test(item) && addUrl(item, true))
+                return;
+            for (const match of item.matchAll(/https?:\/\/[^\s<>"'\p{Cc}]+/gu))
+                addUrl(match[0], false);
+        }
+        else if (Array.isArray(item))
+            item.forEach(inspect);
+        else if (item && typeof item === 'object')
+            Object.values(item).forEach(inspect);
+    };
+    inspect(value);
+    const json = JSON.stringify(value)
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+    const output = markdown().codeBlock(json, 'json');
+    /**
+     * CommonMark angle destinations retain parentheses, and entities decode to the original URL.
+     * Whitespace and control characters, which no indexed URL holds, are percent-encoded as a
+     * backstop so no destination can span a line.
+     */
+    const destination = (url) => url
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/\\/g, '&#92;')
+        .replace(/[\s\p{Cc}]/gu, encodeURIComponent);
+    if (urls.size)
+        output
+            .raw('\n\nSources and links:\n')
+            .raw([...urls].map((url, index) => `[Link ${index + 1}](<${destination(url)}>)`).join('\n\n'));
+    if (images.size)
+        output
+            .raw('\n\nImages:\n')
+            .raw([...images]
+            .map((url, index) => `![Image ${index + 1}](<${destination(url)}>)`)
+            .join('\n\n'));
+    return [{ type: 'text', text: output.build() }];
+}
+//# sourceMappingURL=format.js.map

package/dist/services/interpro/format.js.map

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

package/dist/services/interpro/http-adapter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Bounded HTTP/1.1 adapter for InterPro's malformed bodyless 204 responses.
+ * @module services/interpro/http-adapter
+ */
+/** Maximum decoded response size, shared by native and injected transports. */
+export declare const MAX_RESPONSE_BYTES: number;
+/** Fetch-compatible injection seam; callers supply the composed request signal. */
+export type InterproFetch = (url: string, init: RequestInit) => Promise<Response>;
+/** Collect one response without following redirects or retaining malformed connections. */
+export declare const interproHttpFetch: InterproFetch;
+//# sourceMappingURL=http-adapter.d.ts.map

package/dist/services/interpro/http-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../../../src/services/interpro/http-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAClD,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElF,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,EAAE,aAkK5B,CAAC"}