@j0hanz/fetch-url-mcp 1.2.0 → 1.3.0

package/dist/tools.d.ts

@@ -1,72 +1,22 @@
-import { z } from 'zod';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import type { MarkdownTransformResult } from './transform-types.js';
+import type { ContentBlock } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { type ToolHandlerExtra } from './tool-progress.js';
+export { createToolErrorResponse, handleToolError } from './tool-errors.js';
+export { executeFetchPipeline, parseCachedMarkdownResult, performSharedFetch, } from './tool-pipeline.js';
+export { createProgressReporter, type ProgressNotification, type ProgressNotificationParams, } from './tool-progress.js';
 export interface FetchUrlInput {
     url: string;
     skipNoiseRemoval?: boolean | undefined;
     forceRefresh?: boolean | undefined;
     maxInlineChars?: number | undefined;
 }
-type ToolErrorResponse = CallToolResult & {
-    structuredContent: {
-        error: string;
-        url: string;
-        statusCode?: number;
-        details?: Record<string, unknown>;
-    };
-    isError: true;
-};
-type ToolResponseBase = CallToolResult & {
-    structuredContent: Record<string, unknown>;
-};
-interface FetchPipelineOptions<T> {
-    url: string;
-    cacheNamespace: string;
-    signal?: AbortSignal;
-    cacheVary?: Record<string, unknown> | string;
-    forceRefresh?: boolean;
-    transform: (input: {
-        buffer: Uint8Array;
-        encoding: string;
-        truncated?: boolean;
-    }, url: string) => T | Promise<T>;
-    serialize?: (result: T) => string;
-    deserialize?: (cached: string) => T | undefined;
-}
-interface PipelineResult<T> {
-    data: T;
-    fromCache: boolean;
-    url: string;
-    originalUrl?: string;
-    finalUrl?: string;
-    fetchedAt: string;
-    cacheKey?: string | null;
-}
-type ProgressToken = string | number;
-interface RequestMeta {
-    progressToken?: ProgressToken | undefined;
+type ToolContentBlockUnion = ContentBlock;
+interface ToolResponseBase {
     [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;
-}
-interface ToolHandlerExtra {
-    signal?: AbortSignal;
-    requestId?: string | number;
-    sessionId?: unknown;
-    requestInfo?: unknown;
-    _meta?: RequestMeta;
-    sendNotification?: (notification: ProgressNotification) => Promise<void>;
-    onProgress?: (progress: number, message: string) => void;
+    content: ToolContentBlockUnion[];
+    structuredContent?: Record<string, unknown> | undefined;
+    isError?: boolean;
 }
 export declare const fetchUrlInputSchema: z.ZodObject<{
     url: z.ZodURL;
@@ -74,57 +24,31 @@ export declare const fetchUrlInputSchema: z.ZodObject<{
     forceRefresh: z.ZodOptional<z.ZodBoolean>;
     maxInlineChars: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
+export declare const fetchUrlOutputSchema: z.ZodObject<{
+    url: z.ZodString;
+    inputUrl: z.ZodOptional<z.ZodString>;
+    resolvedUrl: z.ZodOptional<z.ZodString>;
+    finalUrl: z.ZodOptional<z.ZodString>;
+    cacheResourceUri: 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>>;
+    markdown: z.ZodOptional<z.ZodString>;
+    fromCache: z.ZodOptional<z.ZodBoolean>;
+    fetchedAt: z.ZodOptional<z.ZodString>;
+    contentSize: z.ZodOptional<z.ZodNumber>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
 export declare const FETCH_URL_TOOL_NAME = "fetch-url";
-interface ProgressReporter {
-    report: (progress: number, message: string) => Promise<void>;
-}
-export declare function createProgressReporter(extra?: ToolHandlerExtra): ProgressReporter;
-interface InlineContentResult {
-    content?: string;
-    contentSize: number;
-    truncated?: boolean;
-}
-type InlineResult = ReturnType<InlineContentLimiter['apply']>;
-declare class InlineContentLimiter {
-    apply(content: string, inlineLimitOverride?: number): InlineContentResult;
-    private resolveInlineLimit;
-}
-export declare function executeFetchPipeline<T>(options: FetchPipelineOptions<T>): Promise<PipelineResult<T>>;
-interface SharedFetchOptions<T extends {
-    content: string;
-}> {
-    readonly url: string;
-    readonly signal?: AbortSignal;
-    readonly cacheVary?: Record<string, unknown> | string;
-    readonly forceRefresh?: boolean;
-    readonly maxInlineChars?: number;
-    readonly transform: (input: {
-        buffer: Uint8Array;
-        encoding: string;
-        truncated?: boolean;
-    }, normalizedUrl: string) => T | Promise<T>;
-    readonly serialize?: (result: T) => string;
-    readonly deserialize?: (cached: string) => T | undefined;
-}
-interface SharedFetchDeps {
-    readonly executeFetchPipeline?: typeof executeFetchPipeline;
-}
-export declare function performSharedFetch<T extends {
-    content: string;
-}>(options: SharedFetchOptions<T>, deps?: SharedFetchDeps): Promise<{
-    pipeline: PipelineResult<T>;
-    inlineResult: InlineResult;
-}>;
-export declare function createToolErrorResponse(message: string, url: string, extra?: {
-    statusCode?: number;
-    details?: Record<string, unknown>;
-}): ToolErrorResponse;
-export declare function handleToolError(error: unknown, url: string, fallbackMessage?: string): ToolErrorResponse;
-type MarkdownPipelineResult = MarkdownTransformResult & {
-    readonly content: string;
-};
-export declare function parseCachedMarkdownResult(cached: string): MarkdownPipelineResult | undefined;
+export declare function getUrlContext(urlStr: string): string;
 export declare function fetchUrlToolHandler(input: FetchUrlInput, extra?: ToolHandlerExtra): Promise<ToolResponseBase>;
 export declare function withRequestContextIfMissing<TParams, TResult, TExtra = unknown>(handler: (params: TParams, extra?: TExtra) => Promise<TResult>): (params: TParams, extra?: TExtra) => Promise<TResult>;
 export declare function registerTools(server: McpServer): void;
-export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAEV,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,KAAK,qBAAqB,GAAG,YAAY,CAAC;AAG1C,UAAU,gBAAgB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB;;;;;kBA6B9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;kBAyF/B,CAAC;AAEH,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAmQ/C,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAcpD;AA+ED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAmCD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAC5E,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7D,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAmBvD;AAwBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiBrD"}