@mxf-dev/core 1.0.1 → 2.0.1

package/dist/protocols/mcp/tools/WebTools.d.ts

@@ -18,741 +18,28 @@
  * @documentation https://mxf-dev.github.io/mxf/
  */
 /**
- * Web Search Tool - Performs web searches with content extraction
+ * Search the web and optionally pull the content of each result.
  */
-export declare const webSearchTool: {
-    name: "web_search";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            maxResults: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-            searchEngine: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            extractContent: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        query: string;
-        maxResults?: number;
-        searchEngine?: string;
-        extractContent?: boolean;
-        format?: string;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_search";
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_search";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    }>;
-    enabled: boolean;
-};
+export declare const webSearchTool: import("../defineTool.js").DefinedMcpTool;
 /**
- * Web Navigation Tool - Navigate to URLs and extract content
+ * Load a URL in a browser and extract its content.
  */
-export declare const webNavigationTool: {
-    name: "web_navigate";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-                format: string;
-            };
-            waitStrategy: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            includeScreenshot: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            screenshotFormat: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            extractContent: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        url: string;
-        waitStrategy?: string;
-        includeScreenshot?: boolean;
-        screenshotFormat?: string;
-        extractContent?: boolean;
-        format?: string;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_navigate";
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_navigate";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    }>;
-    enabled: boolean;
-};
+export declare const webNavigationTool: import("../defineTool.js").DefinedMcpTool;
 /**
- * Web Content Extraction Tool - Extract content from multiple URLs
+ * Extract content from several URLs at once.
  */
-export declare const webContentExtractionTool: {
-    name: "web_bulk_extract";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            urls: {
-                type: string;
-                description: string;
-                items: {
-                    type: string;
-                    format: string;
-                };
-                minItems: number;
-                maxItems: number;
-            };
-            concurrency: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        urls: string[];
-        concurrency?: number;
-        format?: string;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_bulk_extract";
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_bulk_extract";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    }>;
-    enabled: boolean;
-};
+export declare const webContentExtractionTool: import("../defineTool.js").DefinedMcpTool;
 /**
- * Web Screenshot Tool - Capture screenshots of web pages
+ * Capture a screenshot of a page.
  */
-export declare const webScreenshotTool: {
-    name: "web_screenshot";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-                format: string;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            fullPage: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            width: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-            height: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        url: string;
-        format?: string;
-        fullPage?: boolean;
-        width?: number;
-        height?: number;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_screenshot";
-            requestId: string;
-            timestamp: string;
-            screenshotSize: number;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_screenshot";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-            screenshotSize?: undefined;
-        };
-    }>;
-    enabled: boolean;
-};
+export declare const webScreenshotTool: import("../defineTool.js").DefinedMcpTool;
 /**
- * Export all web tools
- */
-/**
- * API Fetch Tool - Fetch JSON from API endpoints
+ * Fetch a URL and return the response body.
+ *
+ * The target is checked before the request goes out: the server can reach the
+ * MXF API on localhost, Meilisearch, MongoDB, and a cloud metadata endpoint, and
+ * an unrestricted fetch would let an agent reach all of them through us.
  */
-export declare const apiFetchTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-                format: string;
-            };
-            method: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            headers: {
-                type: string;
-                description: string;
-                additionalProperties: {
-                    type: string;
-                };
-            };
-            body: {
-                type: string;
-                description: string;
-            };
-            timeout: {
-                type: string;
-                description: string;
-                default: number;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        url: string;
-        method?: string;
-        headers?: Record<string, string>;
-        body?: any;
-        timeout?: number;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: string;
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: string;
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    }>;
-    enabled: boolean;
-};
-export declare const webTools: ({
-    name: "web_search";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            maxResults: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-            searchEngine: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            extractContent: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        query: string;
-        maxResults?: number;
-        searchEngine?: string;
-        extractContent?: boolean;
-        format?: string;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_search";
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_search";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    }>;
-    enabled: boolean;
-} | {
-    name: "web_navigate";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-                format: string;
-            };
-            waitStrategy: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            includeScreenshot: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            screenshotFormat: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            extractContent: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        url: string;
-        waitStrategy?: string;
-        includeScreenshot?: boolean;
-        screenshotFormat?: string;
-        extractContent?: boolean;
-        format?: string;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_navigate";
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_navigate";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    }>;
-    enabled: boolean;
-} | {
-    name: "web_bulk_extract";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            urls: {
-                type: string;
-                description: string;
-                items: {
-                    type: string;
-                    format: string;
-                };
-                minItems: number;
-                maxItems: number;
-            };
-            concurrency: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        urls: string[];
-        concurrency?: number;
-        format?: string;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_bulk_extract";
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_bulk_extract";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    }>;
-    enabled: boolean;
-} | {
-    name: "web_screenshot";
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-                format: string;
-            };
-            format: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            fullPage: {
-                type: string;
-                description: string;
-                default: boolean;
-            };
-            width: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-            height: {
-                type: string;
-                description: string;
-                default: number;
-                minimum: number;
-                maximum: number;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        url: string;
-        format?: string;
-        fullPage?: boolean;
-        width?: number;
-        height?: number;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_screenshot";
-            requestId: string;
-            timestamp: string;
-            screenshotSize: number;
-            error?: undefined;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: "web_screenshot";
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-            screenshotSize?: undefined;
-        };
-    }>;
-    enabled: boolean;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-                format: string;
-            };
-            method: {
-                type: string;
-                description: string;
-                enum: string[];
-                default: string;
-            };
-            headers: {
-                type: string;
-                description: string;
-                additionalProperties: {
-                    type: string;
-                };
-            };
-            body: {
-                type: string;
-                description: string;
-            };
-            timeout: {
-                type: string;
-                description: string;
-                default: number;
-            };
-        };
-        required: string[];
-    };
-    handler: (input: {
-        url: string;
-        method?: string;
-        headers?: Record<string, string>;
-        body?: any;
-        timeout?: number;
-    }, context: {
-        requestId: string;
-        agentId?: string;
-        channelId?: string;
-    }) => Promise<{
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: string;
-            requestId: string;
-            timestamp: string;
-            error: boolean;
-        };
-    } | {
-        content: {
-            type: string;
-            text: string;
-        };
-        metadata: {
-            toolName: string;
-            requestId: string;
-            timestamp: string;
-            error?: undefined;
-        };
-    }>;
-    enabled: boolean;
-})[];
+export declare const apiFetchTool: import("../defineTool.js").DefinedMcpTool;
+export declare const webTools: import("../defineTool.js").DefinedMcpTool[];
 //# sourceMappingURL=WebTools.d.ts.map