@nexus-cortex/executors 4.26.0

package/dist/implementations/web/WebFetchTool.js

@@ -0,0 +1,484 @@
+/**
+ * WebFetch Tool Executor
+ *
+ * Processes content from URLs embedded in a prompt using Gemini API's built-in urlContext tool.
+ * Includes fallback to local fetch + html-to-text for private IPs and failed requests.
+ *
+ * Based on Gemini CLI web-fetch.ts implementation
+ * Uses FREE Gemini API built-in tools with automatic fallback
+ */
+import { GoogleGenAI } from '@google/genai';
+import { convert } from 'html-to-text';
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { resolveProvider, anthropicFetch, xaiFetch, openaiFetch, } from './webBackends.js';
+import { browseEscalationDirective } from './escalateDirective.js';
+import { buildBrowserFetchInit } from './webFetchRequestInit.js';
+// Selected web tools model — read at call time so /set updates apply live.
+// Empty string means "no provider configured" → direct-fetch fallback.
+const getWebToolsModel = () => process.env.WEB_TOOLS_MODEL?.trim() || '';
+// Fetch configuration
+const URL_FETCH_TIMEOUT_MS = 30000; // 30s — gov/county sites are often slow
+const MAX_CONTENT_LENGTH = 100000; // 100,000 characters
+/**
+ * WebFetch Tool Executor
+ *
+ * Features:
+ * - Uses Gemini API urlContext built-in tool (FREE)
+ * - Automatic grounding metadata with source attribution
+ * - UTF-8 byte-accurate citation insertion
+ * - Fallback to local fetch + html-to-text for:
+ *   - Private IPs (localhost, 192.168.x.x, etc.)
+ *   - Failed URL retrievals
+ * - GitHub blob URL → raw URL conversion
+ * - HTML to text conversion
+ */
+export class WebFetchTool extends BaseTool {
+    config;
+    genAI = null;
+    constructor(config) {
+        super('WebFetch', 'WebFetch', `Processes content from URL(s), including local and private network addresses (e.g., localhost), embedded in a prompt.
+
+Include up to 20 URLs and instructions directly in the 'prompt' parameter. The tool fetches and processes the content, returning structured information with citations.`, {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: 'A comprehensive prompt that includes the URL(s) (up to 20) to fetch and specific instructions on how to process their content (e.g., "Summarize https://example.com/article and extract key points from https://another.com/data"). All URLs must be valid and complete, starting with "http://" or "https://".',
+                },
+            },
+            required: ['prompt'],
+        });
+        this.config = config;
+    }
+    /**
+     * Initialize Gemini API client
+     */
+    getGeminiClient() {
+        if (!this.genAI) {
+            const apiKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
+            if (!apiKey) {
+                throw new Error('Google API key not found. Please set GEMINI_API_KEY or GOOGLE_API_KEY environment variable.');
+            }
+            this.genAI = new GoogleGenAI({ apiKey });
+        }
+        return this.genAI;
+    }
+    validateToolParams(params) {
+        // Models frequently send { url: "...", prompt: "instructions" } instead of
+        // embedding the URL in the prompt string. Merge url into prompt so
+        // downstream parsing and provider dispatch see it.
+        const extra = params.url;
+        if (typeof extra === 'string' && extra.trim()) {
+            const trimmed = extra.trim();
+            if (!params.prompt.includes(trimmed)) {
+                params.prompt = `${trimmed} ${params.prompt}`;
+            }
+        }
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Empty prompt check
+        if (!params.prompt || params.prompt.trim() === '') {
+            return "The 'prompt' parameter cannot be empty and must contain URL(s) and instructions.";
+        }
+        // Parse and validate URLs
+        const { validUrls, errors } = this.parsePrompt(params.prompt);
+        if (errors.length > 0) {
+            return `Error(s) in prompt URLs:\n- ${errors.join('\n- ')}`;
+        }
+        if (validUrls.length === 0) {
+            return "The 'prompt' must contain at least one valid URL (starting with http:// or https://).";
+        }
+        return null;
+    }
+    getDescription(params) {
+        const displayPrompt = params.prompt.length > 100 ? params.prompt.substring(0, 97) + '...' : params.prompt;
+        return `Processing URLs and instructions from prompt: "${displayPrompt}"`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Parse URLs from prompt
+            const { validUrls: urls } = this.parsePrompt(params.prompt);
+            // Should not happen due to validation, but check anyway
+            if (urls.length === 0) {
+                return {
+                    ...this.createErrorResult('No valid URLs found in prompt'),
+                    metadata: { executionTime: Date.now() - startTime },
+                };
+            }
+            const url = urls[0]; // Primary URL (guaranteed by validation check above)
+            // Check for private IP - use direct-fetch fallback immediately (any provider's
+            // hosted web tool will refuse to fetch private IPs anyway).
+            if (this.isPrivateIp(url)) {
+                return await this.executeFallback(params, url, signal, startTime);
+            }
+            // Provider-native dispatch: Anthropic + XAI go through their server-side
+            // web tools. Google Gemini and the no-provider case fall through to the
+            // existing urlContext pipeline (with direct-fetch fallback).
+            const modelId = getWebToolsModel();
+            const provider = resolveProvider(modelId);
+            if (provider === 'anthropic' && process.env.ANTHROPIC_API_KEY) {
+                try {
+                    const r = await anthropicFetch(params.prompt, modelId);
+                    return this.formatBackendResult(r, urls, startTime);
+                }
+                catch (err) {
+                    console.warn(`[web-tools] anthropic fetch failed: ${err.message}`);
+                    return await this.executeFallback(params, url, signal, startTime);
+                }
+            }
+            if (provider === 'xai' && process.env.XAI_API_KEY) {
+                try {
+                    const r = await xaiFetch(params.prompt, modelId);
+                    return this.formatBackendResult(r, urls, startTime);
+                }
+                catch (err) {
+                    console.warn(`[web-tools] xai fetch failed: ${err.message}`);
+                    return await this.executeFallback(params, url, signal, startTime);
+                }
+            }
+            if (provider === 'openai' && process.env.OPENAI_API_KEY) {
+                try {
+                    const r = await openaiFetch(params.prompt, modelId);
+                    return this.formatBackendResult(r, urls, startTime);
+                }
+                catch (err) {
+                    console.warn(`[web-tools] openai fetch failed: ${err.message}`);
+                    return await this.executeFallback(params, url, signal, startTime);
+                }
+            }
+            // No Gemini key + no other provider key → skip Gemini SDK call, go to fallback.
+            const hasGeminiKey = !!(process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY);
+            if (!hasGeminiKey) {
+                return await this.executeFallback(params, url, signal, startTime);
+            }
+            // Try primary execution with urlContext (Gemini)
+            return await this.executePrimary(params, urls, signal, startTime);
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Fetch operation was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Handle API errors - try fallback
+            const { validUrls: urls } = this.parsePrompt(params.prompt);
+            if (urls.length > 0 && urls[0]) {
+                try {
+                    return await this.executeFallback(params, urls[0], signal, startTime);
+                }
+                catch (fallbackError) {
+                    const errorMessage = fallbackError.message || String(fallbackError);
+                    return {
+                        ...this.createErrorResult(`Error processing web content: ${errorMessage}\n\n` +
+                            browseEscalationDirective(urls[0])),
+                        metadata: {
+                            executionTime: Date.now() - startTime,
+                            error: errorMessage,
+                        },
+                    };
+                }
+            }
+            const errorMessage = error.message || String(error);
+            const { validUrls: failedUrls } = this.parsePrompt(params.prompt);
+            return {
+                ...this.createErrorResult(`Error processing web content: ${errorMessage}\n\n` +
+                    browseEscalationDirective(failedUrls[0])),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Format a provider-native backend result into the WebFetch tool result shape.
+     */
+    formatBackendResult(r, urls, startTime) {
+        let body = r.text;
+        if (r.sources.length > 0) {
+            const list = r.sources
+                .map((s, i) => `[${i + 1}] ${s.title ?? 'Untitled'} (${s.url})`)
+                .join('\n');
+            body += `\n\nSources:\n${list}`;
+        }
+        return {
+            ...this.createSuccessResult(body),
+            sources: r.sources.map((s) => ({ web: { title: s.title, uri: s.url } })),
+            metadata: {
+                executionTime: Date.now() - startTime,
+                urls,
+                sourceCount: r.sources.length,
+                method: 'primary',
+                backend: r.backend,
+            },
+        };
+    }
+    /**
+     * Primary execution using Gemini API urlContext
+     */
+    async executePrimary(params, urls, signal, startTime) {
+        // Get Gemini client
+        const genAI = this.getGeminiClient();
+        // Make request with urlContext tool enabled
+        const result = await genAI.models.generateContent({
+            model: getWebToolsModel(),
+            contents: params.prompt,
+            config: {
+                tools: [{ urlContext: {} }],
+            },
+        });
+        // Extract response and metadata
+        let responseText = result.text || '';
+        const candidate = result.candidates?.[0];
+        const urlContextMeta = candidate?.urlContextMetadata;
+        const groundingMetadata = candidate?.groundingMetadata;
+        const sources = groundingMetadata?.groundingChunks;
+        const groundingSupports = groundingMetadata?.groundingSupports;
+        // Check for processing errors
+        let processingError = false;
+        if (urlContextMeta?.urlMetadata && urlContextMeta.urlMetadata.length > 0) {
+            const allStatuses = urlContextMeta.urlMetadata.map((m) => m.urlRetrievalStatus);
+            if (allStatuses.every((s) => s !== 'URL_RETRIEVAL_STATUS_SUCCESS')) {
+                processingError = true;
+            }
+        }
+        else if (!responseText.trim() && !sources?.length) {
+            processingError = true;
+        }
+        if (!processingError && !responseText.trim() && (!sources || sources.length === 0)) {
+            processingError = true;
+        }
+        // Fallback if primary failed
+        if (processingError) {
+            return await this.executeFallback(params, urls[0], signal, startTime);
+        }
+        // Insert citations (UTF-8 byte-accurate)
+        if (groundingSupports && groundingSupports.length > 0) {
+            responseText = this.insertCitationsUTF8(responseText, groundingSupports);
+        }
+        // Append source list
+        if (sources && sources.length > 0) {
+            const sourceList = sources
+                .map((source, index) => {
+                const title = source.web?.title || 'Untitled';
+                const uri = source.web?.uri || 'Unknown URI';
+                return `[${index + 1}] ${title} (${uri})`;
+            })
+                .join('\n');
+            responseText += `\n\nSources:\n${sourceList}`;
+        }
+        return {
+            ...this.createSuccessResult(responseText),
+            sources,
+            metadata: {
+                executionTime: Date.now() - startTime,
+                urls,
+                sourceCount: sources?.length || 0,
+                method: 'primary',
+            },
+        };
+    }
+    /**
+     * Fallback execution using local fetch + html-to-text
+     */
+    async executeFallback(params, url, signal, startTime) {
+        // Convert GitHub blob URL to raw URL
+        if (url.includes('github.com') && url.includes('/blob/')) {
+            url = url.replace('github.com', 'raw.githubusercontent.com').replace('/blob/', '/');
+        }
+        // Fetch with timeout
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), URL_FETCH_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, buildBrowserFetchInit(controller.signal));
+            clearTimeout(timeout);
+            if (!response.ok) {
+                throw new Error(`Request failed with status code ${response.status} ${response.statusText}`);
+            }
+            const rawContent = await response.text();
+            const contentType = response.headers.get('content-type') || '';
+            let textContent;
+            // Use html-to-text for HTML content
+            if (contentType.toLowerCase().includes('text/html') || contentType === '') {
+                textContent = convert(rawContent, {
+                    wordwrap: false,
+                    selectors: [
+                        { selector: 'a', options: { ignoreHref: true } },
+                        { selector: 'img', format: 'skip' },
+                    ],
+                });
+            }
+            else {
+                // For other content types (text/plain, JSON, etc.), use raw text
+                textContent = rawContent;
+            }
+            // Truncate to max length
+            textContent = textContent.substring(0, MAX_CONTENT_LENGTH);
+            // Send to Gemini Flash for processing
+            const genAI = this.getGeminiClient();
+            const fallbackPrompt = `The user requested the following: "${params.prompt}".
+
+I was unable to access the URL directly. Instead, I have fetched the raw content of the page. Please use the following content to answer the request. Do not attempt to access the URL again.
+
+---
+${textContent}
+---
+`;
+            const result = await genAI.models.generateContent({
+                model: getWebToolsModel(),
+                contents: fallbackPrompt,
+            });
+            const resultText = result.text || '';
+            return {
+                ...this.createSuccessResult(resultText),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    url,
+                    fallback: true,
+                    method: 'fallback',
+                },
+            };
+        }
+        catch (error) {
+            clearTimeout(timeout);
+            throw new Error(`Error during fallback fetch for ${url}: ${error.message}`);
+        }
+    }
+    /**
+     * Parse URLs from prompt text
+     */
+    parsePrompt(text) {
+        const tokens = text.split(/\s+/);
+        const validUrls = [];
+        const errors = [];
+        for (const token of tokens) {
+            if (!token)
+                continue;
+            // Heuristic: check for :// in token
+            if (token.includes('://')) {
+                try {
+                    const url = new URL(token);
+                    // Allow only http/https
+                    if (['http:', 'https:'].includes(url.protocol)) {
+                        validUrls.push(url.href);
+                    }
+                    else {
+                        errors.push(`Unsupported protocol in URL: "${token}". Only http and https are supported.`);
+                    }
+                }
+                catch {
+                    errors.push(`Malformed URL detected: "${token}".`);
+                }
+            }
+        }
+        return { validUrls, errors };
+    }
+    /**
+     * Check if URL points to a private IP address
+     */
+    isPrivateIp(url) {
+        try {
+            const parsedUrl = new URL(url);
+            const hostname = parsedUrl.hostname;
+            // Check for localhost
+            if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1') {
+                return true;
+            }
+            // Check for private IP ranges
+            const ipv4Regex = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/;
+            const match = hostname.match(ipv4Regex);
+            if (match) {
+                const parts = match.slice(1).map(Number); // Extract octets
+                const [a, b, c, d] = parts;
+                // 10.0.0.0/8
+                if (a === 10)
+                    return true;
+                // 172.16.0.0/12
+                if (a === 172 && b !== undefined && b >= 16 && b <= 31)
+                    return true;
+                // 192.168.0.0/16
+                if (a === 192 && b === 168)
+                    return true;
+                // 169.254.0.0/16 (link-local)
+                if (a === 169 && b === 254)
+                    return true;
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Insert citations at UTF-8 byte-accurate positions
+     *
+     * Gemini API returns byte positions (not character positions) for grounding metadata.
+     * This method handles multi-byte UTF-8 characters correctly.
+     *
+     * @param responseText The response text to insert citations into
+     * @param groundingSupports Array of grounding support items with byte positions
+     * @returns Text with citations inserted
+     */
+    insertCitationsUTF8(responseText, groundingSupports) {
+        if (!groundingSupports || groundingSupports.length === 0) {
+            return responseText;
+        }
+        // Collect insertion points
+        const insertions = [];
+        for (const support of groundingSupports) {
+            if (support.segment && support.groundingChunkIndices) {
+                const citationMarker = support.groundingChunkIndices
+                    .map((chunkIndex) => `[${chunkIndex + 1}]`)
+                    .join('');
+                insertions.push({
+                    index: support.segment.endIndex,
+                    marker: citationMarker,
+                });
+            }
+        }
+        // Sort in descending order to avoid index shifting
+        insertions.sort((a, b) => b.index - a.index);
+        // Use TextEncoder/TextDecoder for UTF-8 byte manipulation
+        const encoder = new TextEncoder();
+        const responseBytes = encoder.encode(responseText);
+        const parts = [];
+        let lastIndex = responseBytes.length;
+        for (const ins of insertions) {
+            const pos = Math.min(ins.index, lastIndex);
+            parts.unshift(responseBytes.subarray(pos, lastIndex)); // Content after marker
+            parts.unshift(encoder.encode(ins.marker)); // Marker
+            lastIndex = pos;
+        }
+        parts.unshift(responseBytes.subarray(0, lastIndex)); // Content before first marker
+        // Concatenate byte arrays
+        const totalLength = parts.reduce((sum, part) => sum + part.length, 0);
+        const finalBytes = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const part of parts) {
+            finalBytes.set(part, offset);
+            offset += part.length;
+        }
+        // Decode back to string
+        return new TextDecoder().decode(finalBytes);
+    }
+}
+//# sourceMappingURL=WebFetchTool.js.map

package/dist/implementations/web/WebFetchTool.js.map

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

package/dist/implementations/web/WebSearchTool.d.ts

@@ -0,0 +1,53 @@
+/**
+ * WebSearch Tool Executor — multi-provider.
+ *
+ * Backends (selected by WEB_TOOLS_MODEL env var):
+ *   - Anthropic Claude   → web_search_20250305 server tool
+ *   - XAI Grok           → Responses API web_search server tool
+ *   - Google Gemini      → googleSearch grounding (UTF-8 byte-accurate citations)
+ *   - DuckDuckGo HTML    → fallback when no provider key is available
+ *
+ * nexus-browser is intentionally not a backend here. It is exposed as a
+ * gated MCP server and reached only via the MCP transport.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+interface GroundingChunkItem {
+    web?: {
+        uri?: string;
+        title?: string;
+    };
+}
+export interface WebSearchToolParams {
+    /** The search query to find information on the web */
+    query: string;
+    /**
+     * 'fast' (default) → provider-native search via runWebSearch.
+     * 'interactive' → dispatch a nexus-browser subagent to search and interact
+     * with results pages. Useful when provider-native search misses JS-rendered
+     * SPAs or behind-login content.
+     */
+    mode?: 'fast' | 'interactive';
+}
+export interface WebSearchToolResult extends ToolResult {
+    sources?: GroundingChunkItem[];
+}
+export declare class WebSearchTool extends BaseTool<WebSearchToolParams, WebSearchToolResult> {
+    private config;
+    private genAI;
+    constructor(config: ExecutorConfig);
+    private getGeminiClient;
+    validateToolParams(params: WebSearchToolParams): string | null;
+    getDescription(params: WebSearchToolParams): string;
+    execute(params: WebSearchToolParams, signal: AbortSignal): Promise<WebSearchToolResult>;
+    private formatBackendOutput;
+    private runGeminiSearch;
+    /**
+     * Insert citations at UTF-8 byte-accurate positions. Gemini grounding
+     * metadata uses byte offsets (not character indices), so multi-byte UTF-8
+     * characters must be handled via TextEncoder/TextDecoder.
+     */
+    private insertCitationsUTF8;
+}
+export {};
+//# sourceMappingURL=WebSearchTool.d.ts.map

package/dist/implementations/web/WebSearchTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSearchTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/web/WebSearchTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAQjE,UAAU,kBAAkB;IAC1B,GAAG,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAaD,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,qBAAa,aAAc,SAAQ,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAGvE,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,KAAK,CAA4B;gBAErB,MAAM,EAAE,cAAc;IAkC1C,OAAO,CAAC,eAAe;IAavB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;IAS9D,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM;IAI7C,OAAO,CACX,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,mBAAmB,CAAC;IAwE/B,OAAO,CAAC,mBAAmB;YAWb,eAAe;IAoE7B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAuC5B"}