visus-mcp 0.6.2 → 0.9.0

package/lambda-package/tools/fetch-structured.js.map

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

package/lambda-package/tools/fetch.d.ts

@@ -1,49 +0,0 @@
-/**
- * visus_fetch MCP Tool
- *
- * Fetches a web page and returns sanitized content in markdown or text format.
- *
- * CRITICAL: ALL content MUST pass through the sanitizer. This cannot be bypassed.
- */
-import type { VisusFetchInput, VisusFetchOutput, Result } from '../types.js';
-/**
- * visus_fetch tool implementation
- *
- * @param input Tool input parameters
- * @returns Sanitized page content with metadata
- */
-export declare function visusFetch(input: VisusFetchInput): Promise<Result<VisusFetchOutput, Error>>;
-/**
- * MCP tool definition for registration
- */
-export declare const visusFetchToolDefinition: {
-    name: string;
-    title: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-            };
-            format: {
-                type: string;
-                enum: string[];
-                description: string;
-                default: string;
-            };
-            timeout_ms: {
-                type: string;
-                description: string;
-                default: number;
-            };
-        };
-        required: string[];
-    };
-    readOnlyHint: boolean;
-    destructiveHint: boolean;
-    idempotentHint: boolean;
-    openWorldHint: boolean;
-};
-//# sourceMappingURL=fetch.d.ts.map

package/lambda-package/tools/fetch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/tools/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG7E;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAwFjG;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BpC,CAAC"}

package/lambda-package/tools/fetch.js

@@ -1,131 +0,0 @@
-/**
- * visus_fetch MCP Tool
- *
- * Fetches a web page and returns sanitized content in markdown or text format.
- *
- * CRITICAL: ALL content MUST pass through the sanitizer. This cannot be bypassed.
- */
-import { renderPage } from '../browser/playwright-renderer.js';
-import { sanitize } from '../sanitizer/index.js';
-import { truncateContent } from '../utils/truncate.js';
-import { detectFormat, convertJson, convertXml, convertRss } from '../utils/format-converter.js';
-import { Err } from '../types.js';
-/**
- * visus_fetch tool implementation
- *
- * @param input Tool input parameters
- * @returns Sanitized page content with metadata
- */
-export async function visusFetch(input) {
-    const { url, format = 'markdown', timeout_ms = 10000 } = input;
-    // Validate inputs
-    if (!url || typeof url !== 'string') {
-        return Err(new Error('Invalid input: url must be a non-empty string'));
-    }
-    try {
-        // Step 1: Render the page using Playwright
-        const renderResult = await renderPage(url, {
-            timeout_ms,
-            format: format === 'text' ? 'text' : 'markdown'
-        });
-        if (!renderResult.ok) {
-            return Err(renderResult.error);
-        }
-        const { html, title, contentType } = renderResult.value;
-        const rawContent = html || '';
-        // Step 2: Detect format and apply format-appropriate conversion
-        const detectedContentType = contentType || 'text/html';
-        const formatType = detectFormat(detectedContentType);
-        let processedContent = rawContent;
-        // Apply format-specific conversion (skip Readability for non-HTML)
-        if (formatType === 'json') {
-            processedContent = convertJson(rawContent);
-        }
-        else if (formatType === 'xml') {
-            processedContent = convertXml(rawContent);
-        }
-        else if (formatType === 'rss') {
-            processedContent = convertRss(rawContent);
-        }
-        // For 'html' format, processedContent remains as rawContent
-        // Step 3: CRITICAL - Sanitize content (injection detection + PII redaction with allowlisting)
-        // This step CANNOT be skipped or bypassed
-        const sanitizationResult = sanitize(processedContent, url);
-        // Step 3: Apply token ceiling truncation (AFTER sanitization)
-        // Anthropic MCP Directory enforces 25,000 token response limit
-        const truncationResult = truncateContent(sanitizationResult.content);
-        // Step 4: Build output
-        const output = {
-            url,
-            content: truncationResult.content,
-            sanitization: {
-                patterns_detected: sanitizationResult.sanitization.patterns_detected,
-                pii_types_redacted: sanitizationResult.sanitization.pii_types_redacted,
-                pii_allowlisted: sanitizationResult.sanitization.pii_allowlisted,
-                content_modified: sanitizationResult.sanitization.content_modified
-            },
-            metadata: {
-                title: title || 'Untitled',
-                fetched_at: new Date().toISOString(),
-                content_length_original: sanitizationResult.metadata.original_length,
-                content_length_sanitized: sanitizationResult.metadata.sanitized_length,
-                format_detected: formatType,
-                content_type: detectedContentType,
-                ...(truncationResult.truncated && {
-                    truncated: true,
-                    truncated_at_chars: truncationResult.truncated_at_chars
-                })
-            },
-            // Include threat_report only if findings exist
-            ...(sanitizationResult.threat_report && { threat_report: sanitizationResult.threat_report })
-        };
-        // Log to stderr if critical threats detected
-        if (sanitizationResult.metadata.has_critical_threats) {
-            console.error(JSON.stringify({
-                timestamp: new Date().toISOString(),
-                event: 'critical_threat_detected',
-                url,
-                patterns: sanitizationResult.sanitization.patterns_detected,
-                severity_score: sanitizationResult.metadata.severity_score
-            }));
-        }
-        return { ok: true, value: output };
-    }
-    catch (error) {
-        return Err(error instanceof Error ? error : new Error(String(error)));
-    }
-}
-/**
- * MCP tool definition for registration
- */
-export const visusFetchToolDefinition = {
-    name: 'visus_fetch',
-    title: 'Fetch Web Page (Sanitized)',
-    description: 'Fetch and sanitize web page content. Returns clean, injection-free content in markdown or text format. SECURITY: All content passes through prompt injection sanitization (43 pattern categories) and PII redaction BEFORE reaching the LLM. This ensures safe consumption of untrusted web content.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            url: {
-                type: 'string',
-                description: 'The URL to fetch (must be http:// or https://)'
-            },
-            format: {
-                type: 'string',
-                enum: ['markdown', 'text'],
-                description: 'Output format: markdown (default) or plain text',
-                default: 'markdown'
-            },
-            timeout_ms: {
-                type: 'number',
-                description: 'Request timeout in milliseconds (default: 10000)',
-                default: 10000
-            }
-        },
-        required: ['url']
-    },
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-};
-//# sourceMappingURL=fetch.js.map

package/lambda-package/tools/fetch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/tools/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEjG,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAE/D,kBAAkB;IAClB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC;QACH,2CAA2C;QAC3C,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE;YACzC,UAAU;YACV,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;SAChD,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAE9B,gEAAgE;QAChE,MAAM,mBAAmB,GAAG,WAAW,IAAI,WAAW,CAAC;QACvD,MAAM,UAAU,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAErD,IAAI,gBAAgB,GAAG,UAAU,CAAC;QAElC,mEAAmE;QACnE,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC1B,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YAChC,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YAChC,gBAAgB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QACD,4DAA4D;QAE5D,8FAA8F;QAC9F,0CAA0C;QAC1C,MAAM,kBAAkB,GAAG,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAE3D,8DAA8D;QAC9D,+DAA+D;QAC/D,MAAM,gBAAgB,GAAG,eAAe,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAErE,uBAAuB;QACvB,MAAM,MAAM,GAAqB;YAC/B,GAAG;YACH,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,YAAY,EAAE;gBACZ,iBAAiB,EAAE,kBAAkB,CAAC,YAAY,CAAC,iBAAiB;gBACpE,kBAAkB,EAAE,kBAAkB,CAAC,YAAY,CAAC,kBAAkB;gBACtE,eAAe,EAAE,kBAAkB,CAAC,YAAY,CAAC,eAAe;gBAChE,gBAAgB,EAAE,kBAAkB,CAAC,YAAY,CAAC,gBAAgB;aACnE;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,KAAK,IAAI,UAAU;gBAC1B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,uBAAuB,EAAE,kBAAkB,CAAC,QAAQ,CAAC,eAAe;gBACpE,wBAAwB,EAAE,kBAAkB,CAAC,QAAQ,CAAC,gBAAgB;gBACtE,eAAe,EAAE,UAAU;gBAC3B,YAAY,EAAE,mBAAmB;gBACjC,GAAG,CAAC,gBAAgB,CAAC,SAAS,IAAI;oBAChC,SAAS,EAAE,IAAI;oBACf,kBAAkB,EAAE,gBAAgB,CAAC,kBAAkB;iBACxD,CAAC;aACH;YACD,+CAA+C;YAC/C,GAAG,CAAC,kBAAkB,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC;SAC7F,CAAC;QAEF,6CAA6C;QAC7C,IAAI,kBAAkB,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,0BAA0B;gBACjC,GAAG;gBACH,QAAQ,EAAE,kBAAkB,CAAC,YAAY,CAAC,iBAAiB;gBAC3D,cAAc,EAAE,kBAAkB,CAAC,QAAQ,CAAC,cAAc;aAC3D,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAErC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,4BAA4B;IACnC,WAAW,EAAE,sSAAsS;IACnT,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;gBAC1B,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE,UAAU;aACpB;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;gBAC/D,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;IACD,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;CACpB,CAAC"}

package/lambda-package/tools/read.d.ts

@@ -1,51 +0,0 @@
-/**
- * visus_read MCP Tool
- *
- * Extracts clean article content from a web page using Mozilla Readability,
- * stripping navigation, ads, and boilerplate. Full prompt injection sanitization
- * and PII redaction applied before content reaches the LLM.
- *
- * CRITICAL: ALL content MUST pass through the sanitizer. This cannot be bypassed.
- *
- * Pipeline order:
- * 1. Playwright renders page (full JS execution)
- * 2. Reader extracts main content (reduces input size)
- * 3. Sanitizer runs on clean text
- * 4. Token ceiling applied (24,000 token cap)
- */
-import type { VisusReadInput, VisusReadOutput, Result } from '../types.js';
-/**
- * visus_read tool implementation
- *
- * @param input Tool input parameters
- * @returns Sanitized article content with metadata
- */
-export declare function visusRead(input: VisusReadInput): Promise<Result<VisusReadOutput, Error>>;
-/**
- * MCP tool definition for registration
- */
-export declare const visusReadToolDefinition: {
-    name: string;
-    title: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            url: {
-                type: string;
-                description: string;
-            };
-            timeout_ms: {
-                type: string;
-                description: string;
-                default: number;
-            };
-        };
-        required: string[];
-    };
-    readOnlyHint: boolean;
-    destructiveHint: boolean;
-    idempotentHint: boolean;
-    openWorldHint: boolean;
-};
-//# sourceMappingURL=read.d.ts.map

package/lambda-package/tools/read.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG3E;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAqF9F;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;CAuBnC,CAAC"}

package/lambda-package/tools/read.js

@@ -1,127 +0,0 @@
-/**
- * visus_read MCP Tool
- *
- * Extracts clean article content from a web page using Mozilla Readability,
- * stripping navigation, ads, and boilerplate. Full prompt injection sanitization
- * and PII redaction applied before content reaches the LLM.
- *
- * CRITICAL: ALL content MUST pass through the sanitizer. This cannot be bypassed.
- *
- * Pipeline order:
- * 1. Playwright renders page (full JS execution)
- * 2. Reader extracts main content (reduces input size)
- * 3. Sanitizer runs on clean text
- * 4. Token ceiling applied (24,000 token cap)
- */
-import { renderPage } from '../browser/playwright-renderer.js';
-import { extractArticle } from '../browser/reader.js';
-import { sanitize } from '../sanitizer/index.js';
-import { truncateContent } from '../utils/truncate.js';
-import { Err } from '../types.js';
-/**
- * visus_read tool implementation
- *
- * @param input Tool input parameters
- * @returns Sanitized article content with metadata
- */
-export async function visusRead(input) {
-    const { url, timeout_ms = 10000 } = input;
-    // Validate inputs
-    if (!url || typeof url !== 'string') {
-        return Err(new Error('Invalid input: url must be a non-empty string'));
-    }
-    try {
-        // Step 1: Render the page using Playwright
-        const renderResult = await renderPage(url, {
-            timeout_ms,
-            format: 'html'
-        });
-        if (!renderResult.ok) {
-            return Err(renderResult.error);
-        }
-        const { html, title: pageTitle } = renderResult.value;
-        // Step 2: Extract article content using Readability
-        const readerResult = extractArticle(html, url);
-        if (!readerResult.ok) {
-            return Err(readerResult.error);
-        }
-        const article = readerResult.value;
-        // Step 3: CRITICAL - Sanitize content (injection detection + PII redaction)
-        // Sanitization runs AFTER Readability, not before
-        // This step CANNOT be skipped or bypassed
-        const sanitizationResult = sanitize(article.content, url);
-        // Step 4: Apply token ceiling truncation (AFTER sanitization)
-        // Anthropic MCP Directory enforces 25,000 token response limit
-        const truncationResult = truncateContent(sanitizationResult.content);
-        // Step 5: Build output
-        const output = {
-            url,
-            content: truncationResult.content,
-            metadata: {
-                title: article.title || pageTitle || 'Untitled',
-                author: article.byline,
-                published: article.publishedTime,
-                word_count: article.wordCount,
-                reader_mode_available: article.readerModeAvailable,
-                sanitized: true,
-                injections_removed: sanitizationResult.sanitization.patterns_detected.length,
-                pii_redacted: sanitizationResult.sanitization.pii_types_redacted.length,
-                truncated: truncationResult.truncated,
-                fetched_at: new Date().toISOString()
-            },
-            // Include threat_report only if findings exist
-            ...(sanitizationResult.threat_report && { threat_report: sanitizationResult.threat_report })
-        };
-        // Log to stderr if critical threats detected
-        if (sanitizationResult.metadata.has_critical_threats) {
-            console.error(JSON.stringify({
-                timestamp: new Date().toISOString(),
-                event: 'reader_critical_threat_detected',
-                url,
-                patterns: sanitizationResult.sanitization.patterns_detected,
-                severity_score: sanitizationResult.metadata.severity_score
-            }));
-        }
-        // Log to stderr if reader mode failed (non-article page)
-        if (!article.readerModeAvailable) {
-            console.error(JSON.stringify({
-                timestamp: new Date().toISOString(),
-                event: 'reader_mode_fallback',
-                url,
-                reason: 'Readability could not extract article structure'
-            }));
-        }
-        return { ok: true, value: output };
-    }
-    catch (error) {
-        return Err(error instanceof Error ? error : new Error(String(error)));
-    }
-}
-/**
- * MCP tool definition for registration
- */
-export const visusReadToolDefinition = {
-    name: 'visus_read',
-    title: 'Read Web Page (Reader Mode + Sanitized)',
-    description: 'Extracts clean article content from a web page using Mozilla Readability, stripping navigation, ads, and boilerplate. Full prompt injection sanitization and PII redaction applied before content reaches the LLM. Optimized for context-efficient, safe web reading in Claude Desktop.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            url: {
-                type: 'string',
-                description: 'The URL to fetch (must be http:// or https://)'
-            },
-            timeout_ms: {
-                type: 'number',
-                description: 'Request timeout in milliseconds (default: 10000)',
-                default: 10000
-            }
-        },
-        required: ['url']
-    },
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-};
-//# sourceMappingURL=read.js.map

package/lambda-package/tools/read.js.map

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

package/lambda-package/tools/search.d.ts

@@ -1,45 +0,0 @@
-/**
- * Visus Search Tool - Safe Web Search
- *
- * Queries DuckDuckGo's Instant Answer API and sanitizes all results
- * before returning them to the LLM.
- *
- * SECURITY: Every search result snippet and title passes through the
- * sanitization pipeline. This prevents prompt injection via search results.
- */
-import type { VisusSearchInput, VisusSearchOutput, Result } from '../types.js';
-/**
- * Search the web via DuckDuckGo and return sanitized results
- *
- * @param input Search query and options
- * @returns Sanitized search results with injection detection metadata
- */
-export declare function visusSearch(input: VisusSearchInput): Promise<Result<VisusSearchOutput, Error>>;
-/**
- * Tool definition for MCP registration
- */
-export declare const visusSearchToolDefinition: {
-    name: string;
-    title: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            query: {
-                type: string;
-                description: string;
-            };
-            max_results: {
-                type: string;
-                description: string;
-                default: number;
-            };
-        };
-        required: string[];
-    };
-    readOnlyHint: boolean;
-    destructiveHint: boolean;
-    idempotentHint: boolean;
-    openWorldHint: boolean;
-};
-//# sourceMappingURL=search.d.ts.map

package/lambda-package/tools/search.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiB/E;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAkLpG;AAuBD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CAuBrC,CAAC"}

package/lambda-package/tools/search.js

@@ -1,220 +0,0 @@
-/**
- * Visus Search Tool - Safe Web Search
- *
- * Queries DuckDuckGo's Instant Answer API and sanitizes all results
- * before returning them to the LLM.
- *
- * SECURITY: Every search result snippet and title passes through the
- * sanitization pipeline. This prevents prompt injection via search results.
- */
-import { sanitize } from '../sanitizer/index.js';
-import { generateThreatReport } from '../sanitizer/threat-reporter.js';
-import { Ok, Err } from '../types.js';
-/**
- * Search the web via DuckDuckGo and return sanitized results
- *
- * @param input Search query and options
- * @returns Sanitized search results with injection detection metadata
- */
-export async function visusSearch(input) {
-    // Validate input
-    if (!input.query || typeof input.query !== 'string' || input.query.trim().length === 0) {
-        return Err(new Error('query must be a non-empty string'));
-    }
-    // Enforce max_results cap
-    const maxResults = Math.min(input.max_results ?? 5, 10);
-    try {
-        // Call DuckDuckGo Instant Answer API
-        const query = encodeURIComponent(input.query.trim());
-        const apiUrl = `https://api.duckduckgo.com/?q=${query}&format=json&no_redirect=1&no_html=1`;
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 8000);
-        let response;
-        try {
-            response = await fetch(apiUrl, {
-                signal: controller.signal,
-                headers: {
-                    'User-Agent': 'visus-mcp/0.3.0 (https://github.com/lateos/visus-mcp)'
-                }
-            });
-        }
-        finally {
-            clearTimeout(timeout);
-        }
-        if (!response.ok) {
-            return Ok({
-                query: input.query,
-                result_count: 0,
-                sanitized: true,
-                results: [],
-                total_injections_removed: 0,
-                message: `Search unavailable (HTTP ${response.status})`
-            });
-        }
-        const data = await response.json();
-        // Extract results from DuckDuckGo response
-        const rawResults = [];
-        // Add AbstractText as first result if present
-        if (data.AbstractText && data.AbstractURL) {
-            rawResults.push({
-                title: extractTitle(data.AbstractText),
-                url: data.AbstractURL,
-                snippet: data.AbstractText
-            });
-        }
-        // Extract from RelatedTopics
-        if (data.RelatedTopics) {
-            for (const topic of data.RelatedTopics) {
-                // Handle both direct topics and nested topic groups
-                if ('Topics' in topic && Array.isArray(topic.Topics)) {
-                    // Nested topics group
-                    for (const nestedTopic of topic.Topics) {
-                        if (nestedTopic.Text && nestedTopic.FirstURL) {
-                            rawResults.push({
-                                title: extractTitle(nestedTopic.Text),
-                                url: nestedTopic.FirstURL,
-                                snippet: nestedTopic.Text
-                            });
-                        }
-                    }
-                }
-                else if ('Text' in topic && topic.Text && topic.FirstURL) {
-                    // Direct topic
-                    rawResults.push({
-                        title: extractTitle(topic.Text),
-                        url: topic.FirstURL,
-                        snippet: topic.Text
-                    });
-                }
-                // Stop if we've collected enough results
-                if (rawResults.length >= maxResults) {
-                    break;
-                }
-            }
-        }
-        // Filter out results with empty URLs and limit to max_results
-        const validResults = rawResults
-            .filter(r => r.url && r.url.trim().length > 0)
-            .slice(0, maxResults);
-        // If no results found, return empty array with message
-        if (validResults.length === 0) {
-            return Ok({
-                query: input.query,
-                result_count: 0,
-                sanitized: true,
-                results: [],
-                total_injections_removed: 0,
-                message: 'No results found'
-            });
-        }
-        // Sanitize each result independently
-        const sanitizedResults = [];
-        const allPatternsDetected = new Set();
-        let totalInjectionsRemoved = 0;
-        let totalPIIRedacted = 0;
-        for (const result of validResults) {
-            // Sanitize title
-            const titleSanitization = sanitize(result.title);
-            // Sanitize snippet
-            const snippetSanitization = sanitize(result.snippet);
-            const injectionsRemoved = titleSanitization.sanitization.patterns_detected.length +
-                snippetSanitization.sanitization.patterns_detected.length;
-            const piiRedacted = titleSanitization.sanitization.pii_types_redacted.length +
-                snippetSanitization.sanitization.pii_types_redacted.length;
-            totalInjectionsRemoved += injectionsRemoved;
-            totalPIIRedacted += piiRedacted;
-            // Collect all patterns detected across all results
-            titleSanitization.sanitization.patterns_detected.forEach(p => allPatternsDetected.add(p));
-            snippetSanitization.sanitization.patterns_detected.forEach(p => allPatternsDetected.add(p));
-            sanitizedResults.push({
-                title: titleSanitization.content,
-                url: result.url,
-                snippet: snippetSanitization.content,
-                injections_removed: injectionsRemoved,
-                pii_redacted: piiRedacted
-            });
-        }
-        // Generate aggregated threat report for all search results
-        const threatReport = generateThreatReport({
-            patterns_detected: Array.from(allPatternsDetected),
-            pii_redacted: totalPIIRedacted,
-            source_url: `DuckDuckGo Search: ${input.query}`
-        });
-        return Ok({
-            query: input.query,
-            result_count: sanitizedResults.length,
-            sanitized: true,
-            results: sanitizedResults,
-            total_injections_removed: totalInjectionsRemoved,
-            // Include threat_report only if findings exist
-            ...(threatReport && { threat_report: threatReport })
-        });
-    }
-    catch (error) {
-        // Handle timeout or network errors
-        if (error instanceof Error && error.name === 'AbortError') {
-            return Ok({
-                query: input.query,
-                result_count: 0,
-                sanitized: true,
-                results: [],
-                total_injections_removed: 0,
-                message: 'Search unavailable (timeout)'
-            });
-        }
-        return Ok({
-            query: input.query,
-            result_count: 0,
-            sanitized: true,
-            results: [],
-            total_injections_removed: 0,
-            message: `Search unavailable: ${error instanceof Error ? error.message : String(error)}`
-        });
-    }
-}
-/**
- * Extract title from text (first sentence or up to 80 chars)
- */
-function extractTitle(text) {
-    // Try to find first sentence
-    const firstSentenceMatch = text.match(/^[^.!?]+[.!?]/);
-    if (firstSentenceMatch) {
-        const sentence = firstSentenceMatch[0].trim();
-        if (sentence.length <= 80) {
-            return sentence;
-        }
-    }
-    // Fallback to first 80 chars
-    if (text.length <= 80) {
-        return text.trim();
-    }
-    return text.substring(0, 77).trim() + '...';
-}
-/**
- * Tool definition for MCP registration
- */
-export const visusSearchToolDefinition = {
-    name: 'visus_search',
-    title: 'Search the Web (Sanitized)',
-    description: 'Searches the web via DuckDuckGo and returns sanitized results with prompt injection and PII removed before reaching the LLM. Use before visus_fetch or visus_read to safely discover and then read pages.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            query: {
-                type: 'string',
-                description: 'Search query'
-            },
-            max_results: {
-                type: 'number',
-                description: 'Maximum number of results to return (default: 5, max: 10)',
-                default: 5
-            }
-        },
-        required: ['query']
-    },
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-};
-//# sourceMappingURL=search.js.map