@j0hanz/fetch-url-mcp 1.11.2 → 1.11.4

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tasks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,yBAAyB,CAAC,KAAK,GAAG,OAAO;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,KAAK,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1E,0BAA0B,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1E,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAID,wBAAgB,uBAAuB,CAAC,KAAK,EAC3C,UAAU,EAAE,yBAAyB,CAAC,KAAK,CAAC,GAC3C,IAAI,CAKN;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GACX,yBAAyB,GAAG,SAAS,CAEvC;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,GACX,sBAAsB,GAAG,SAAS,CAEpC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAIN"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tasks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,yBAAyB,CAAC,KAAK,GAAG,OAAO;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,KAAK,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1E,0BAA0B,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1E,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC;AAID,wBAAgB,uBAAuB,CAAC,KAAK,EAC3C,UAAU,EAAE,yBAAyB,CAAC,KAAK,CAAC,GAC3C,IAAI,CAKN;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GACX,yBAAyB,GAAG,SAAS,CAEvC;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,GACX,sBAAsB,GAAG,SAAS,CAEpC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAIN"}

package/dist/tools/fetch-url.d.ts

@@ -1,10 +1,9 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ContentBlock } from '@modelcontextprotocol/sdk/types.js';
 import type { ServerResult } from '@modelcontextprotocol/sdk/types.js';
-import { z } from 'zod';
+import type { z } from 'zod';
 import type { SharedFetchStage } from '../lib/fetch-pipeline.js';
-import { type ToolHandlerExtra } from '../lib/progress.js';
-import type { ProgressReporter } from '../lib/progress.js';
+import { type ProgressReporter, type ToolHandlerExtra } from '../lib/mcp-interop.js';
 import { fetchUrlInputSchema } from '../schemas.js';
 import { type TaskCapableToolSupport } from '../tasks/registry.js';
 type FetchUrlInput = z.infer<typeof fetchUrlInputSchema>;

package/dist/tools/fetch-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-url.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAU3D,OAAO,EACL,mBAAmB,EAIpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAIL,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAE9B,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzD,UAAU,gBAAgB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAwI/C,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,YAAY,GACnB,MAAM,GAAG,SAAS,CAUpB;AAED,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,WAAW,CAA0B;gBAG1B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,MAAM;IAGlC,WAAW,IAAI,IAAI;IAInB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAO1C,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIxC,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAIvC,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,QAAQ;CAmCjB;AAuED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAqBD,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC3D;AAqBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,wBAAwB,CAmCzE"}
+{"version":3,"file":"fetch-url.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAc7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EACL,mBAAmB,EAIpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAIL,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAE9B,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzD,UAAU,gBAAgB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAwI/C,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,YAAY,GACnB,MAAM,GAAG,SAAS,CAUpB;AAED,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,WAAW,CAA0B;gBAG1B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,MAAM;IAGlC,WAAW,IAAI,IAAI;IAInB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAO1C,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIxC,aAAa,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAIvC,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,QAAQ;CAmCjB;AAuED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAqBD,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC3D;AAqBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,wBAAwB,CAsCzE"}

package/dist/tools/fetch-url.js

@@ -1,9 +1,8 @@
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { z } from 'zod';
 import { config, logDebug, logError, logWarn } from '../lib/core.js';
 import { finalizeInlineMarkdown, markdownTransform, parseCachedMarkdownResult, performSharedFetch, serializeMarkdownResult, withSignal, } from '../lib/fetch-pipeline.js';
-import { handleToolError } from '../lib/mcp-tools.js';
-import { createProgressReporter, } from '../lib/progress.js';
+import { handleToolError } from '../lib/mcp-interop.js';
+import { createProgressReporter, } from '../lib/mcp-interop.js';
 import { composeAbortSignal, isAbortError, parseUrlOrNull, toError, } from '../lib/utils.js';
 import { isObject } from '../lib/utils.js';
 import { formatZodError } from '../lib/zod.js';
@@ -246,7 +245,7 @@ const TOOL_DEFINITION = {
     title: 'Fetch URL',
     description: FETCH_URL_TOOL_DESCRIPTION,
     inputSchema: fetchUrlInputSchema,
-    outputSchema: z.toJSONSchema(fetchUrlOutputSchema),
+    outputSchema: fetchUrlOutputSchema,
     handler: fetchUrlToolHandler,
     annotations: {
         readOnlyHint: true,

package/dist/{lib → transform}/dom-prep.d.ts

@@ -1,4 +1,4 @@
-import type { ExtractedArticle } from '../transform/types.js';
+import type { ExtractedArticle } from './types.js';
 export declare const WP_PHOTON_HOST_PATTERN: RegExp;
 export declare function extractNoscriptImages(document: Document): void;
 export declare function resolveDocumentBody(document: Document): Element;

package/dist/transform/dom-prep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-prep.d.ts","sourceRoot":"","sources":["../../src/transform/dom-prep.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA0mBnD,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAyCvD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CA6B9D;AAuBD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAY/D;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CASR;AA0CD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAG5D;AA0RD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CA2BjE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAE1D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAY9D;AAWD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAQ3D;AAuDD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,IAAI,CAON;AA4BD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,QAAQ,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,MAAM,CAcR;AA0ED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,GAAG,QAAQ,GAChC,MAAM,CAaR;AAiMD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,GAAG,IAAI,CA8BjB"}

package/dist/{lib → transform}/dom-prep.js

@@ -1,6 +1,6 @@
 import { parseHTML } from 'linkedom';
-import { config, logDebug } from './core.js';
-import { CharCode, isWhitespaceChar } from './utils.js';
+import { config, logDebug } from '../lib/core.js';
+import { CharCode, isWhitespaceChar } from '../lib/utils.js';
 // ── Thresholds ──────────────────────────────────────────────────────
 const NOISE_SCAN_LIMIT = 50_000;
 const MIN_BODY_CONTENT_LENGTH = 100;

package/dist/transform/html-translators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-translators.d.ts","sourceRoot":"","sources":["../../src/transform/html-translators.ts"],"names":[],"mappings":"AAiVA,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAkCpB;AAOD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAKpB;AACD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AA0cD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE"}
+{"version":3,"file":"html-translators.d.ts","sourceRoot":"","sources":["../../src/transform/html-translators.ts"],"names":[],"mappings":"AAkVA,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAkCpB;AAOD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAKpB;AACD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AA0cD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/transform/html-translators.js

@@ -1,6 +1,6 @@
 import { NodeHtmlMarkdown, } from 'node-html-markdown';
-import { WP_PHOTON_HOST_PATTERN } from '../lib/dom-prep.js';
 import { isLikeNode, isObject } from '../lib/utils.js';
+import { WP_PHOTON_HOST_PATTERN } from './dom-prep.js';
 // ---------------------------------------------------------------------------
 // Shared constant
 // ---------------------------------------------------------------------------

package/dist/transform/metadata.d.ts

@@ -7,4 +7,12 @@ export declare function extractTitleFromRawMarkdown(content: string): string | u
 export declare function addSourceToMarkdown(content: string, url: string): string;
 export declare function isRawTextContent(content: string): boolean;
 export declare function buildMetadataFooter(metadata?: MetadataBlock, fallbackUrl?: string): string;
+export interface SyntheticTitleContext {
+    readonly title: string | undefined;
+}
+export declare function normalizeSyntheticTitleToken(value: string | undefined): string;
+export declare function shouldPreferPrimaryHeadingTitle(primaryHeading: string | undefined, title: string | undefined): boolean;
+export declare function isGithubRepositoryRootUrl(url: string): boolean;
+export declare function maybeStripGithubPrimaryHeading(markdown: string, primaryHeading: string | undefined, url: string): string;
+export declare function maybePrependSyntheticTitle(markdown: string, context: SyntheticTitleContext): string;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/transform/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/transform/metadata.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgCnE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAkBR;AAuJD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,iBAAiB,CAYnB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,iBAAiB,GAAG,IAAI,CAY1B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,GAAG,IAAI,EAC/B,IAAI,EAAE,iBAAiB,GACtB,iBAAiB,CAmBnB;AA0GD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAOpB;AACD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAuCxE;AAmBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAczD;AAaD,wBAAgB,mBAAmB,CACjC,QAAQ,CAAC,EAAE,aAAa,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAmBR"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/transform/metadata.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgCnE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAkBR;AAuJD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,iBAAiB,CAYnB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,iBAAiB,GAAG,IAAI,CAY1B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,GAAG,IAAI,EAC/B,IAAI,EAAE,iBAAiB,GACtB,iBAAiB,CAmBnB;AA0GD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAOpB;AACD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAuCxE;AAmBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAczD;AAaD,wBAAgB,mBAAmB,CACjC,QAAQ,CAAC,EAAE,aAAa,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAmBR;AAMD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAMD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAER;AAED,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,OAAO,CAWT;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAU9D;AAkCD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,GAAG,EAAE,MAAM,GACV,MAAM,CAMR;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,qBAAqB,GAC7B,MAAM,CAMR"}

package/dist/transform/metadata.js

@@ -393,4 +393,70 @@ export function buildMetadataFooter(metadata, fallbackUrl) {
         lines.push(` <sub>${metadata.description}</sub>`);
     return lines.join('\n');
 }
+const TITLE_PART_SEPARATOR = /\s*(?:[-|:•·]|–|—)\s*/u;
+const LEADING_HEADING_PATTERN = /^(#{1,6})\s+(.+?)\s*$/;
+const HEADING_SCAN_LIMIT = 12;
+export function normalizeSyntheticTitleToken(value) {
+    return (value ?? '').replace(/\s+/g, ' ').trim().toLowerCase();
+}
+export function shouldPreferPrimaryHeadingTitle(primaryHeading, title) {
+    const primary = normalizeSyntheticTitleToken(primaryHeading);
+    if (!primary)
+        return false;
+    const normalizedTitle = normalizeSyntheticTitleToken(title);
+    if (!normalizedTitle)
+        return true;
+    if (normalizedTitle === primary)
+        return true;
+    return normalizedTitle
+        .split(TITLE_PART_SEPARATOR)
+        .some((part) => part === primary);
+}
+export function isGithubRepositoryRootUrl(url) {
+    const parsed = parseUrlOrNull(url);
+    if (!parsed)
+        return false;
+    const hostname = parsed.hostname.toLowerCase();
+    if (hostname !== 'github.com' && hostname !== 'www.github.com') {
+        return false;
+    }
+    return parsed.pathname.split('/').filter(Boolean).length === 2;
+}
+function stripLeadingHeading(markdown, headingText) {
+    if (!markdown)
+        return markdown;
+    const lines = markdown.split('\n');
+    const target = normalizeSyntheticTitleToken(headingText);
+    let nonEmptySeen = 0;
+    for (let index = 0; index < lines.length && nonEmptySeen < HEADING_SCAN_LIMIT; index += 1) {
+        const trimmed = lines[index]?.trim() ?? '';
+        if (!trimmed)
+            continue;
+        nonEmptySeen += 1;
+        const match = LEADING_HEADING_PATTERN.exec(trimmed);
+        if (!match)
+            continue;
+        const current = normalizeSyntheticTitleToken(match[2] ?? '');
+        if (current !== target)
+            return markdown;
+        lines.splice(index, 1);
+        if ((lines[index] ?? '').trim() === '') {
+            lines.splice(index, 1);
+        }
+        return lines.join('\n');
+    }
+    return markdown;
+}
+export function maybeStripGithubPrimaryHeading(markdown, primaryHeading, url) {
+    if (primaryHeading === undefined || !isGithubRepositoryRootUrl(url)) {
+        return markdown;
+    }
+    return stripLeadingHeading(markdown, primaryHeading);
+}
+export function maybePrependSyntheticTitle(markdown, context) {
+    if (!context.title || /^#\s/.test(markdown.trimStart())) {
+        return markdown;
+    }
+    return `# ${context.title}\n\n${markdown}`;
+}
 // endregion

package/dist/transform/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/transform/transform.ts"],"names":[],"mappings":"AA2CA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAoB/B,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AA+BpB,UAAU,WAAW;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4LD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,qBAAqB,GAAG,IAAI,CAE9B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,qBAAqB,GAAG,IAAI,EACrC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,MAAM,CAER;AA4aD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAExD,GACA,gBAAgB,CAGlB;AAuKD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC,GACA,MAAM,CAyBR;AA2DD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,sBAAsB,EAAE,MAAM,GAAG,QAAQ,GACxC,OAAO,CAQT;AAKD,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAC/B,OAAO,IAAI,gBAAgB,CAE7B;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,aAAa,EAAE,iBAAiB,EAChC,wBAAwB,EAAE,OAAO,EACjC,eAAe,EAAE,OAAO,GACvB,aAAa,GAAG,SAAS,CAuB3B;AA6bD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GACxB,uBAAuB,CAMzB;AAaD,UAAU,kBAAkB;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjE;AAED,KAAK,yBAAyB,GAAG,gBAAgB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAuG1E,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,GACrB,CAAC"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/transform/transform.ts"],"names":[],"mappings":"AA2CA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAkB/B,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AA+BpB,UAAU,WAAW;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4LD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,qBAAqB,GAAG,IAAI,CAE9B;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,qBAAqB,GAAG,IAAI,EACrC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,MAAM,CAER;AA4aD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAExD,GACA,gBAAgB,CAGlB;AAuKD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC,GACA,MAAM,CAyBR;AA2DD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,sBAAsB,EAAE,MAAM,GAAG,QAAQ,GACxC,OAAO,CAQT;AAKD,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAC/B,OAAO,IAAI,gBAAgB,CAE7B;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,aAAa,EAAE,iBAAiB,EAChC,wBAAwB,EAAE,OAAO,EACjC,eAAe,EAAE,OAAO,GACvB,aAAa,GAAG,SAAS,CAuB3B;AA6bD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GACxB,uBAAuB,CAMzB;AAaD,UAAU,kBAAkB;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjE;AAED,KAAK,yBAAyB,GAAG,gBAAgB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAuG1E,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,GACrB,CAAC"}

package/dist/transform/transform.js

@@ -3,16 +3,15 @@ import { isProbablyReaderable, Readability } from '@mozilla/readability';
 import { parseHTML } from 'linkedom';
 import { config } from '../lib/core.js';
 import { getOperationId, getRequestId, logDebug, logError, logInfo, logWarn, redactUrl, } from '../lib/core.js';
-import { evaluateArticleContent, extractNoscriptImages, getVisibleTextLength, normalizeTabContent, prepareDocumentForMarkdown, removeNoiseFromHtml, serializeDocumentForMarkdown, stripDocsControls, stripScreenReaderText, surfaceCodeEditorContent, } from '../lib/dom-prep.js';
 import { isRawTextContentUrl } from '../lib/http.js';
 import { composeAbortSignal, FetchError, getErrorMessage, getUtf8ByteLength, isAsciiOnly, isObject, throwIfAborted, toError, trimDanglingTagFragment, truncateToUtf8Boundary, } from '../lib/utils.js';
+import { evaluateArticleContent, extractNoscriptImages, getVisibleTextLength, normalizeTabContent, prepareDocumentForMarkdown, removeNoiseFromHtml, serializeDocumentForMarkdown, stripDocsControls, stripScreenReaderText, surfaceCodeEditorContent, } from './dom-prep.js';
 import { extractLanguageFromClassName } from './html-translators.js';
 import { translateHtmlFragmentToMarkdown } from './html-translators.js';
 import { cleanupMarkdownArtifacts, finalizeMarkdownSections, processFencedContent, } from './markdown-cleanup.js';
 import { addSourceToMarkdown, buildMetadataFooter, extractTitleFromRawMarkdown, isRawTextContent, } from './metadata.js';
-import { extractMetadata, extractMetadataFromHead, mergeMetadata, normalizeDocumentTitle, } from './metadata.js';
+import { extractMetadata, extractMetadataFromHead, isGithubRepositoryRootUrl, maybePrependSyntheticTitle, maybeStripGithubPrimaryHeading, mergeMetadata, normalizeDocumentTitle, shouldPreferPrimaryHeadingTitle, } from './metadata.js';
 import { supplementMarkdownFromNextFlight } from './next-flight.js';
-import { isGithubRepositoryRootUrl, maybePrependSyntheticTitle, maybeStripGithubPrimaryHeading, shouldPreferPrimaryHeadingTitle, } from './title-policy.js';
 import { getOrCreateWorkerPool, getWorkerPoolStats, shutdownWorkerPool, } from './worker-pool.js';
 function decodeInput(input, encoding) {
     if (typeof input === 'string')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/fetch-url-mcp",
-  "version": "1.11.2",
+  "version": "1.11.4",
   "mcpName": "io.github.j0hanz/fetch-url-mcp",
   "description": "A web content fetcher MCP server that converts HTML to clean, AI and human readable markdown.",
   "type": "module",

package/dist/lib/dom-prep.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom-prep.d.ts","sourceRoot":"","sources":["../../src/lib/dom-prep.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA4mB9D,eAAO,MAAM,sBAAsB,QAAmB,CAAC;AAyCvD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CA6B9D;AAuBD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAY/D;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CASR;AA0CD,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAG5D;AA0RD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CA2BjE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAE1D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAY9D;AAWD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAQ3D;AAuDD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,IAAI,CAON;AA4BD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,QAAQ,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,MAAM,CAcR;AA0ED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,GAAG,QAAQ,GAChC,MAAM,CAaR;AAiMD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,GAAG,IAAI,CA8BjB"}

package/dist/lib/mcp-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAK/C,QAAA,MAAM,oBAAoB;;;;;;;kBAKxB,CAAC;AAeH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;oBAGzB,CAAC;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;sBAGxB,CAAC;AACH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC3D,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACjE,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAC/D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE5D;AACD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAEtE;AACD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,mBAAmB,CAE7B;AACD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,kBAAkB,CAE1E;AAUD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG7E;AACD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,OAAO,CAUT;AAMD,KAAK,iBAAiB,GAAG,cAAc,GAAG;IACxC,OAAO,EAAE,IAAI,CAAC;CACf,CAAC;AA6BF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GACA,iBAAiB,CAenB;AAQD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,eAAe,SAAqB,GACnC,iBAAiB,CA2BnB"}

package/dist/lib/mcp-tools.js

@@ -1,129 +0,0 @@
-import {} from '@modelcontextprotocol/sdk/types.js';
-import { z } from 'zod';
-import { FetchError, isAbortError, isSystemError } from './utils.js';
-const paramsSchema = z.looseObject({
-    _meta: z.record(z.string(), z.unknown()).optional(),
-});
-const jsonRpcRequestIdSchema = z.union([z.string(), z.number()]);
-const jsonRpcRequestSchema = z.strictObject({
-    jsonrpc: z.literal('2.0'),
-    method: z.string().min(1),
-    id: jsonRpcRequestIdSchema.optional(),
-    params: paramsSchema.optional(),
-});
-const jsonRpcResultResponseSchema = z.strictObject({
-    jsonrpc: z.literal('2.0'),
-    id: jsonRpcRequestIdSchema,
-    result: z.record(z.string(), z.unknown()),
-});
-const jsonRpcErrorResponseSchema = z.strictObject({
-    jsonrpc: z.literal('2.0'),
-    id: jsonRpcRequestIdSchema.or(z.null()).optional(),
-    error: z.strictObject({
-        code: z.number().int(),
-        message: z.string(),
-        data: z.unknown().optional(),
-    }),
-});
-const jsonRpcResponseSchema = z.union([
-    jsonRpcResultResponseSchema,
-    jsonRpcErrorResponseSchema,
-]);
-const jsonRpcMessageSchema = z.union([
-    jsonRpcRequestSchema,
-    jsonRpcResponseSchema,
-]);
-export function isJsonRpcBatchRequest(body) {
-    return Array.isArray(body);
-}
-export function isMcpRequestBody(body) {
-    return jsonRpcRequestSchema.safeParse(body).success;
-}
-export function isJsonRpcResponseBody(body) {
-    return jsonRpcResponseSchema.safeParse(body).success;
-}
-export function isMcpMessageBody(body) {
-    return jsonRpcMessageSchema.safeParse(body).success;
-}
-function parseAcceptMediaTypes(header) {
-    if (!header)
-        return [];
-    return header
-        .split(',')
-        .map((v) => v.split(';', 1)[0]?.trim().toLowerCase() ?? '')
-        .filter((v) => v.length > 0);
-}
-export function acceptsEventStream(header) {
-    const mediaTypes = parseAcceptMediaTypes(header);
-    return mediaTypes.some((mediaType) => mediaType === 'text/event-stream');
-}
-export function acceptsJsonAndEventStream(header) {
-    const mediaTypes = parseAcceptMediaTypes(header);
-    const acceptsJson = mediaTypes.some((m) => m === '*/*' || m === 'application/json' || m === 'application/*');
-    if (!acceptsJson)
-        return false;
-    return mediaTypes.some((m) => m === '*/*' || m === 'text/event-stream' || m === 'text/*');
-}
-const PUBLIC_ERROR_REASONS = new Set(['aborted', 'queue_full', 'timeout']);
-function sanitizeToolErrorDetails(details) {
-    const sanitized = {};
-    const { retryAfter, timeout, reason } = details;
-    if (typeof retryAfter === 'number' ||
-        typeof retryAfter === 'string' ||
-        retryAfter === null) {
-        sanitized['retryAfter'] = retryAfter;
-    }
-    if (typeof timeout === 'number' && Number.isFinite(timeout) && timeout >= 0) {
-        sanitized['timeout'] = timeout;
-    }
-    if (typeof reason === 'string' && PUBLIC_ERROR_REASONS.has(reason)) {
-        sanitized['reason'] = reason;
-    }
-    return Object.keys(sanitized).length > 0 ? sanitized : undefined;
-}
-export function createToolErrorResponse(message, url, extra) {
-    const errorContent = {
-        error: message,
-        ...(extra?.code ? { code: extra.code } : {}),
-        url,
-        ...(extra?.statusCode !== undefined
-            ? { statusCode: extra.statusCode }
-            : {}),
-        ...(extra?.details ? { details: extra.details } : {}),
-    };
-    return {
-        content: [{ type: 'text', text: JSON.stringify(errorContent) }],
-        isError: true,
-    };
-}
-function isValidationError(error) {
-    return (error instanceof Error &&
-        isSystemError(error) &&
-        error.code === 'VALIDATION_ERROR');
-}
-export function handleToolError(error, url, fallbackMessage = 'Operation failed') {
-    if (error instanceof FetchError) {
-        const { code: detailsCode, reason } = error.details;
-        const code = (typeof detailsCode === 'string'
-            ? detailsCode
-            : reason === 'queue_full'
-                ? 'queue_full'
-                : undefined) ?? error.code;
-        const details = sanitizeToolErrorDetails(error.details);
-        return createToolErrorResponse(error.message, url, {
-            code,
-            statusCode: error.statusCode,
-            ...(details ? { details } : {}),
-        });
-    }
-    if (isValidationError(error)) {
-        return createToolErrorResponse(error.message, url, {
-            code: 'VALIDATION_ERROR',
-        });
-    }
-    const code = isAbortError(error) ? 'ABORTED' : 'FETCH_ERROR';
-    const message = error instanceof Error
-        ? `${fallbackMessage}: ${error.message}`
-        : `${fallbackMessage}: Unknown error`;
-    return createToolErrorResponse(message, url, { code });
-}

package/dist/lib/progress.d.ts

@@ -1,32 +0,0 @@
-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;
-    canReportProgress?: () => boolean;
-}
-export interface ProgressReporter {
-    report: (progress: number, message: string) => void;
-}
-export declare const createProgressReporter: (extra?: ToolHandlerExtra) => ProgressReporter;
-export {};
-//# sourceMappingURL=progress.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"AASA,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;IACzD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AA+KD,eAAO,MAAM,sBAAsB,GACjC,QAAQ,gBAAgB,KACvB,gBAAsD,CAAC"}

package/dist/lib/progress.js

@@ -1,143 +0,0 @@
-import { setTimeout as setTimeoutPromise } from 'node:timers/promises';
-import { logError, logWarn } from './core.js';
-import { getErrorMessage, isObject } from './utils.js';
-const DEFAULT_PROGRESS_TOTAL = 8;
-const PROGRESS_NOTIFICATION_TIMEOUT_MS = 5000;
-function resolveRelatedTaskMeta(meta) {
-    const related = meta?.['io.modelcontextprotocol/related-task'];
-    if (!isObject(related))
-        return undefined;
-    const { taskId } = related;
-    return typeof taskId === 'string' ? { taskId } : undefined;
-}
-class ToolProgressReporter {
-    token;
-    handlers;
-    taskMeta;
-    isTerminal = false;
-    lastProgress = -1;
-    lastMessage;
-    pendingNotification;
-    isDispatching = false;
-    constructor(token, handlers, taskMeta) {
-        this.token = token;
-        this.handlers = handlers;
-        this.taskMeta = taskMeta;
-    }
-    static create(extra = {}) {
-        const token = extra._meta?.progressToken ?? null;
-        const { onProgress } = extra;
-        if (token === null && !onProgress) {
-            return { report: () => { } };
-        }
-        return new ToolProgressReporter(token, {
-            send: extra.sendNotification,
-            onProgress,
-            canReport: extra.canReportProgress,
-        }, resolveRelatedTaskMeta(extra._meta));
-    }
-    /**
-     * Report progress toward completion. Steps are monotonic (never decrease)
-     * and may be skipped under normal conditions (e.g., fast responses skip
-     * intermediate steps). Clients should treat progress as "at least this far"
-     * rather than expecting every step to fire sequentially.
-     */
-    report(progress, message) {
-        if (this.isTerminal || this.handlers.canReport?.() === false)
-            return;
-        const effectiveProgress = Math.max(progress, this.lastProgress);
-        const isIncreasing = effectiveProgress > this.lastProgress;
-        const isMessageChanged = message !== this.lastMessage;
-        this.lastProgress = effectiveProgress;
-        this.lastMessage = message;
-        if (effectiveProgress >= DEFAULT_PROGRESS_TOTAL) {
-            this.isTerminal = true;
-        }
-        if (isIncreasing || isMessageChanged) {
-            try {
-                this.handlers.onProgress?.(effectiveProgress, message);
-            }
-            catch (error) {
-                logError('Progress callback failed', {
-                    error: getErrorMessage(error),
-                    progress: effectiveProgress,
-                    message,
-                });
-            }
-        }
-        if (!isIncreasing || this.token === null || !this.handlers.send)
-            return;
-        this.pendingNotification = this.createProgressNotification(this.token, effectiveProgress, message);
-        this.flushNotifications();
-    }
-    flushNotifications() {
-        if (this.isDispatching || !this.handlers.send)
-            return;
-        this.isDispatching = true;
-        void (async () => {
-            try {
-                while (this.pendingNotification) {
-                    if (this.handlers.canReport?.() === false) {
-                        this.pendingNotification = undefined;
-                        return;
-                    }
-                    const notification = this.pendingNotification;
-                    this.pendingNotification = undefined;
-                    await this.sendWithTimeout(notification);
-                }
-            }
-            finally {
-                this.isDispatching = false;
-            }
-        })();
-    }
-    async sendWithTimeout(notification) {
-        if (!this.handlers.send)
-            return;
-        const ac = new AbortController();
-        const timeoutPromise = setTimeoutPromise(PROGRESS_NOTIFICATION_TIMEOUT_MS, { timeout: true }, { signal: ac.signal, ref: false }).catch((err) => {
-            if (err.name === 'AbortError')
-                return { ok: true };
-            throw err;
-        });
-        try {
-            const outcome = await Promise.race([
-                this.handlers.send(notification).then(() => {
-                    ac.abort();
-                    return { ok: true };
-                }),
-                timeoutPromise,
-            ]);
-            if ('timeout' in outcome) {
-                logWarn('Progress notification timed out', {
-                    progress: notification.params.progress,
-                    message: notification.params.message,
-                });
-            }
-        }
-        catch (error) {
-            logWarn('Failed to send progress notification', {
-                error: getErrorMessage(error),
-                progress: notification.params.progress,
-                message: notification.params.message,
-            });
-        }
-    }
-    createProgressNotification(token, progress, message) {
-        return {
-            method: 'notifications/progress',
-            params: {
-                progressToken: token,
-                progress,
-                total: DEFAULT_PROGRESS_TOTAL,
-                message,
-                ...(this.taskMeta && {
-                    _meta: {
-                        'io.modelcontextprotocol/related-task': this.taskMeta,
-                    },
-                }),
-            },
-        };
-    }
-}
-export const createProgressReporter = (extra) => ToolProgressReporter.create(extra);

package/dist/lib/sdk-interop.d.ts

@@ -1,20 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-type CleanupCallback = () => void;
-type RequestHandlerFn = (request: unknown, extra?: unknown) => Promise<unknown>;
-export declare function registerServerLifecycleCleanup(server: McpServer, callback: CleanupCallback): void;
-/**
- * Retrieves the SDK's internal request-handler map.
- *
- * Depends on SDK private API `_requestHandlers` (verified against ^1.27.1).
- * If the SDK changes this internal, the sdk-compat-guard.test.ts tests will fail.
- */
-export declare function getSdkCallToolHandler(server: McpServer): RequestHandlerFn | null;
-/**
- * Patches the SDK's internal capabilities to enable/disable task-mode tool calls.
- *
- * Depends on SDK private API `_capabilities.tasks.requests` (verified against ^1.27.1).
- * If the SDK changes this internal, the sdk-compat-guard.test.ts tests will fail.
- */
-export declare function setTaskToolCallCapability(server: McpServer, enabled: boolean): void;
-export {};
-//# sourceMappingURL=sdk-interop.d.ts.map

package/dist/lib/sdk-interop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk-interop.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-interop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,KAAK,eAAe,GAAG,MAAM,IAAI,CAAC;AAClC,KAAK,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AA8ChF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,eAAe,GACxB,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,GAChB,gBAAgB,GAAG,IAAI,CAMzB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,OAAO,GACf,IAAI,CAoBN"}