@j0hanz/superfetch 2.5.3 → 2.7.0

package/dist/tools.d.ts

@@ -1,8 +1,11 @@
+import { z } from 'zod';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CallToolResult, ContentBlock } from '@modelcontextprotocol/sdk/types.js';
 import type { MarkdownTransformResult } from './transform-types.js';
 export interface FetchUrlInput {
     url: string;
+    skipNoiseRemoval?: boolean | undefined;
+    forceRefresh?: boolean | undefined;
 }
 export interface ToolContentBlock {
     type: 'text';
@@ -29,6 +32,8 @@ export type ToolErrorResponse = CallToolResult & {
     structuredContent: {
         error: string;
         url: string;
+        statusCode?: number;
+        details?: Record<string, unknown>;
     };
     isError: true;
 };
@@ -38,7 +43,12 @@ export interface FetchPipelineOptions<T> {
     cacheNamespace: string;
     signal?: AbortSignal;
     cacheVary?: Record<string, unknown> | string;
-    transform: (html: string, url: string) => T | Promise<T>;
+    forceRefresh?: boolean;
+    transform: (input: {
+        buffer: Uint8Array;
+        encoding: string;
+        truncated?: boolean;
+    }, url: string) => T | Promise<T>;
     serialize?: (result: T) => string;
     deserialize?: (cached: string) => T | undefined;
 }
@@ -46,6 +56,7 @@ export interface PipelineResult<T> {
     data: T;
     fromCache: boolean;
     url: string;
+    originalUrl?: string;
     fetchedAt: string;
     cacheKey?: string | null;
 }
@@ -68,9 +79,16 @@ export interface ProgressNotification {
 export interface ToolHandlerExtra {
     signal?: AbortSignal;
     requestId?: string | number;
+    sessionId?: unknown;
+    requestInfo?: unknown;
     _meta?: RequestMeta;
     sendNotification?: (notification: ProgressNotification) => Promise<void>;
 }
+export declare const fetchUrlInputSchema: z.ZodObject<{
+    url: z.ZodURL;
+    skipNoiseRemoval: z.ZodOptional<z.ZodBoolean>;
+    forceRefresh: 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>;
@@ -87,8 +105,6 @@ interface InlineContentResult {
 export type InlineResult = ReturnType<InlineContentLimiter['apply']>;
 declare class InlineContentLimiter {
     apply(content: string, cacheKey: string | null): InlineContentResult;
-    private resolveResourceUri;
-    private buildTruncatedFallback;
 }
 export declare function executeFetchPipeline<T>(options: FetchPipelineOptions<T>): Promise<PipelineResult<T>>;
 interface SharedFetchOptions<T extends {
@@ -96,7 +112,13 @@ interface SharedFetchOptions<T extends {
 }> {
     readonly url: string;
     readonly signal?: AbortSignal;
-    readonly transform: (html: string, normalizedUrl: string) => T | Promise<T>;
+    readonly cacheVary?: Record<string, unknown> | string;
+    readonly forceRefresh?: boolean;
+    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;
 }
@@ -109,7 +131,10 @@ export declare function performSharedFetch<T extends {
     pipeline: PipelineResult<T>;
     inlineResult: InlineResult;
 }>;
-export declare function createToolErrorResponse(message: string, url: string): ToolErrorResponse;
+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;