@claude-flow/cli 3.10.45 → 3.11.0

package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js

@@ -0,0 +1,98 @@
+/**
+ * Smoke tests for python_exec — ADR-133-PR4
+ *
+ * Run with:
+ *   cd v3/@claude-flow/cli
+ *   npx tsx src/benchmarks/gaia-tools/python_exec.smoke.ts
+ *
+ * Expects python3 to be installed and on PATH.
+ *
+ * Refs: ADR-133, #2156
+ */
+import { createPythonExecTool } from './python_exec.js';
+async function runTest(name, fn) {
+    try {
+        await fn();
+        return { name, passed: true, message: 'OK' };
+    }
+    catch (e) {
+        return { name, passed: false, message: String(e) };
+    }
+}
+function assert(condition, msg) {
+    if (!condition)
+        throw new Error(`Assertion failed: ${msg}`);
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+const tool = createPythonExecTool();
+const tests = [
+    runTest('Test 1: basic arithmetic — print(2+2)', async () => {
+        const out = await tool.execute({ code: 'print(2+2)' });
+        assert(out.includes('4'), `Expected stdout to contain "4", got:\n${out}`);
+        assert(out.includes('exit_code: 0'), `Expected exit_code 0, got:\n${out}`);
+    }),
+    runTest('Test 2: large computation — sum(range(1000000))', async () => {
+        const out = await tool.execute({ code: 'print(sum(range(1000000)))' });
+        assert(out.includes('499999500000'), `Expected "499999500000", got:\n${out}`);
+        assert(out.includes('exit_code: 0'), `Expected exit_code 0, got:\n${out}`);
+    }),
+    runTest('Test 3: stdlib import — math.sqrt(144)', async () => {
+        const out = await tool.execute({
+            code: 'import math; print(math.sqrt(144))',
+        });
+        assert(out.includes('12.0'), `Expected "12.0", got:\n${out}`);
+        assert(out.includes('exit_code: 0'), `Expected exit_code 0, got:\n${out}`);
+    }),
+    runTest('Test 4: timeout — infinite loop with 2s limit', async () => {
+        const start = Date.now();
+        const out = await tool.execute({
+            code: 'while True: pass',
+            timeout_seconds: 2,
+        });
+        const elapsed = Date.now() - start;
+        assert(elapsed < 6_000, `Timeout should have fired within ~2s, took ${elapsed}ms`);
+        const hasTimedOut = out.includes('timed out') ||
+            out.includes('exit_code: 124') ||
+            // SIGKILL on some platforms gives exit code -9 or 137
+            out.includes('exit_code: -9') ||
+            out.includes('exit_code: 137');
+        assert(hasTimedOut, `Expected timeout signal, got:\n${out}`);
+    }),
+    runTest('Test 5: syntax error — exit_code != 0, stderr contains SyntaxError', async () => {
+        const out = await tool.execute({ code: 'x = (' });
+        assert(out.includes('SyntaxError'), `Expected SyntaxError in output, got:\n${out}`);
+        const hasNonZeroExit = !out.includes('exit_code: 0') || out.includes('stderr:');
+        assert(hasNonZeroExit, `Expected non-zero exit code or stderr for syntax error, got:\n${out}`);
+    }),
+];
+// ---------------------------------------------------------------------------
+// Runner
+// ---------------------------------------------------------------------------
+async function main() {
+    console.log('python_exec smoke tests — ADR-133-PR4\n');
+    const results = await Promise.all(tests);
+    let passed = 0;
+    let failed = 0;
+    for (const r of results) {
+        const icon = r.passed ? 'PASS' : 'FAIL';
+        console.log(`[${icon}] ${r.name}`);
+        if (!r.passed) {
+            console.log(`       ${r.message}`);
+        }
+        if (r.passed)
+            passed++;
+        else
+            failed++;
+    }
+    console.log(`\nResults: ${passed}/${results.length} passed`);
+    if (failed > 0) {
+        process.exit(1);
+    }
+}
+main().catch((e) => {
+    console.error('Fatal:', e);
+    process.exit(1);
+});
+//# sourceMappingURL=python_exec.smoke.js.map

package/dist/src/benchmarks/gaia-tools/python_exec.smoke.js.map

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

package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts

@@ -0,0 +1,52 @@
+/**
+ * GAIA Tool: visit_webpage — iter-57 (upgraded from iter-54 base)
+ *
+ * Fetches the FULL readable text content of a webpage URL — not just snippets.
+ * This closes the HAL parity gap identified in iter-51 surrender analysis
+ * (~25-35% of L1 questions need full page reading that snippet-only tools miss).
+ *
+ * Upgrade over iter-54 base (iter-57 changes):
+ *   - max_chars input parameter (default 50k, was hardcoded 8k)
+ *   - Test hooks interface (visitWebpageTestHooks) for unit tests without live HTTP
+ *   - URL validation with helpful error messages
+ *   - Link extraction (up to 30 links) — enables follow-up navigation
+ *   - Better HTML extraction: content-block heuristics (main/article selection)
+ *   - AIDefence PII gate (optional dep, graceful skip if not installed)
+ *   - Structured VisitWebpageResult type + diagnostic stderr logging
+ *   - Python bs4 primary path preserved (already in benchmark env)
+ *
+ * Extraction pipeline:
+ *   1. fetch() + Python bs4.get_text() (primary — better quality, handles encoding)
+ *   2. Regex-based fallback (no external dep) if bs4 unavailable or output too short
+ *   3. Content passed through AIDefence PII gate before returning to agent
+ *
+ * Refs: ADR-138, ADR-133, iter-54, iter-57, #2156
+ */
+import { GaiaTool, ToolDefinition } from './types.js';
+export interface VisitWebpageResult {
+    title: string;
+    content: string;
+    links: Array<{
+        href: string;
+        text: string;
+    }>;
+    sources_consulted: string[];
+    chars_returned: number;
+    truncated: boolean;
+}
+export interface VisitWebpageTestHooks {
+    /** Override the HTTP fetch so tests never make live calls. */
+    fetchHtml?: (url: string) => Promise<{
+        html: string;
+        finalUrl: string;
+    }>;
+}
+export declare const visitWebpageTestHooks: VisitWebpageTestHooks;
+export declare function visitWebpage(url: string, maxChars?: number): Promise<VisitWebpageResult>;
+export declare class VisitWebpageTool implements GaiaTool {
+    readonly name = "visit_webpage";
+    readonly definition: ToolDefinition;
+    execute(input: Record<string, unknown>): Promise<string>;
+}
+export declare function createVisitWebpageTool(): VisitWebpageTool;
+//# sourceMappingURL=visit_webpage.d.ts.map

package/dist/src/benchmarks/gaia-tools/visit_webpage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visit_webpage.d.ts","sourceRoot":"","sources":["../../../../src/benchmarks/gaia-tools/visit_webpage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiBtD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,eAAO,MAAM,qBAAqB,EAAE,qBAA0B,CAAC;AAkL/D,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AA6BD,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAwBjC;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAyB/D;AAMD,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}

package/dist/src/benchmarks/gaia-tools/visit_webpage.js

@@ -0,0 +1,304 @@
+/**
+ * GAIA Tool: visit_webpage — iter-57 (upgraded from iter-54 base)
+ *
+ * Fetches the FULL readable text content of a webpage URL — not just snippets.
+ * This closes the HAL parity gap identified in iter-51 surrender analysis
+ * (~25-35% of L1 questions need full page reading that snippet-only tools miss).
+ *
+ * Upgrade over iter-54 base (iter-57 changes):
+ *   - max_chars input parameter (default 50k, was hardcoded 8k)
+ *   - Test hooks interface (visitWebpageTestHooks) for unit tests without live HTTP
+ *   - URL validation with helpful error messages
+ *   - Link extraction (up to 30 links) — enables follow-up navigation
+ *   - Better HTML extraction: content-block heuristics (main/article selection)
+ *   - AIDefence PII gate (optional dep, graceful skip if not installed)
+ *   - Structured VisitWebpageResult type + diagnostic stderr logging
+ *   - Python bs4 primary path preserved (already in benchmark env)
+ *
+ * Extraction pipeline:
+ *   1. fetch() + Python bs4.get_text() (primary — better quality, handles encoding)
+ *   2. Regex-based fallback (no external dep) if bs4 unavailable or output too short
+ *   3. Content passed through AIDefence PII gate before returning to agent
+ *
+ * Refs: ADR-138, ADR-133, iter-54, iter-57, #2156
+ */
+import { execFileSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_MAX_CHARS = 50_000;
+const MIN_CONTENT_CHARS = 50;
+const REQUEST_TIMEOUT_MS = 30_000;
+const MAX_LINKS = 30;
+const UA = 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36';
+export const visitWebpageTestHooks = {};
+// ---------------------------------------------------------------------------
+// URL validation
+// ---------------------------------------------------------------------------
+function validateUrl(url) {
+    if (!url || typeof url !== 'string') {
+        throw new Error('visit_webpage: `url` must be a non-empty string.');
+    }
+    if (!url.startsWith('http://') && !url.startsWith('https://')) {
+        throw new Error(`visit_webpage: URL must start with http:// or https://. Got: "${url}"`);
+    }
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new Error(`visit_webpage: invalid URL: "${url}"`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Page fetcher (uses Node built-in fetch — Node 18+)
+// ---------------------------------------------------------------------------
+async function fetchPage(url) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    let res;
+    try {
+        res = await fetch(url, {
+            headers: {
+                'User-Agent': UA,
+                Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                'Accept-Language': 'en-US,en;q=0.9',
+            },
+            signal: controller.signal,
+            redirect: 'follow',
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!res.ok) {
+        throw new Error(`visit_webpage: HTTP ${res.status} for ${url}`);
+    }
+    const ct = res.headers.get('content-type') ?? '';
+    if (ct.includes('application/pdf')) {
+        throw new Error(`visit_webpage: URL returns a PDF. Use file_read with the downloaded path instead. URL: ${url}`);
+    }
+    const html = await res.text();
+    const finalUrl = res.url || url;
+    return { html, finalUrl };
+}
+// ---------------------------------------------------------------------------
+// HTML extraction helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract title from raw HTML.
+ */
+function extractTitle(html) {
+    const match = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    if (!match)
+        return '';
+    return match[1]
+        .replace(/<[^>]+>/g, '')
+        .replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"').replace(/&nbsp;/g, ' ')
+        .trim();
+}
+/**
+ * Extract anchor links from HTML (up to MAX_LINKS).
+ */
+function extractLinks(html, baseUrl) {
+    const links = [];
+    const anchorRe = /<a[^>]+href="([^"#][^"]*)"[^>]*>([\s\S]*?)<\/a>/gi;
+    let match;
+    let base;
+    try {
+        base = new URL(baseUrl);
+    }
+    catch {
+        return links;
+    }
+    while ((match = anchorRe.exec(html)) !== null && links.length < MAX_LINKS) {
+        const rawHref = match[1].trim();
+        const rawText = match[2].replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 120);
+        if (!rawText || rawHref.startsWith('javascript:') || rawHref.startsWith('mailto:'))
+            continue;
+        let href;
+        try {
+            href = new URL(rawHref, base.origin + base.pathname).href;
+        }
+        catch {
+            continue;
+        }
+        links.push({ href, text: rawText });
+    }
+    return links;
+}
+/**
+ * Primary extraction: Python bs4.get_text().
+ * bs4 is available in the benchmark env (already installed for gaia-codeagent).
+ * HTML is passed via stdin to avoid shell-escaping issues.
+ */
+function extractTextViaPython(html) {
+    const script = [
+        'import sys, re',
+        'from bs4 import BeautifulSoup',
+        'html = sys.stdin.read()',
+        "soup = BeautifulSoup(html, 'html.parser')",
+        "for tag in soup(['script', 'style', 'nav', 'footer', 'header', 'aside']):",
+        '    tag.decompose()',
+        "text = soup.get_text(separator='\\n', strip=True)",
+        "text = re.sub(r'\\n{3,}', '\\n\\n', text)",
+        'print(text)',
+    ].join('\n');
+    try {
+        return execFileSync('python3', ['-'], {
+            input: script + '\n' + html,
+            encoding: 'utf-8',
+            timeout: 15_000,
+            env: { ...process.env, PYTHONIOENCODING: 'utf-8' },
+            maxBuffer: 10 * 1024 * 1024,
+        }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Fallback: regex-based HTML stripping (no external dep, less accurate).
+ */
+function extractTextViaRegex(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[\s\S]*?<\/style>/gi, '')
+        .replace(/<nav[\s\S]*?<\/nav>/gi, '')
+        .replace(/<footer[\s\S]*?<\/footer>/gi, '')
+        .replace(/<header[\s\S]*?<\/header>/gi, '')
+        .replace(/<\/?(p|div|section|article|main|li|h[1-6]|br)[^>]*>/gi, '\n')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"').replace(/&nbsp;/g, ' ').replace(/&#x27;/g, "'")
+        .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(Number(n)))
+        .replace(/ +/g, ' ')
+        .replace(/\n{4,}/g, '\n\n\n')
+        .replace(/^\s+|\s+$/gm, '')
+        .trim();
+}
+// ---------------------------------------------------------------------------
+// AIDefence PII gate (optional — graceful skip if not installed)
+// ---------------------------------------------------------------------------
+async function applyPiiGate(content) {
+    try {
+        const aidefence = await import('@claude-flow/aidefence').catch(() => null);
+        if (!aidefence)
+            return content;
+        const { hasPii } = aidefence;
+        if (typeof hasPii !== 'function')
+            return content;
+        const detected = await hasPii(content);
+        if (detected) {
+            process.stderr.write('[visit_webpage] AIDefence: PII detected in page content (not blocked)\n');
+        }
+    }
+    catch {
+        // AIDefence unavailable — continue without gate
+    }
+    return content;
+}
+// ---------------------------------------------------------------------------
+// Core visit logic (exported for unit testing via visitWebpageTestHooks)
+// ---------------------------------------------------------------------------
+export async function visitWebpage(url, maxChars = DEFAULT_MAX_CHARS) {
+    const sourcesConsulted = [url];
+    const { html, finalUrl } = visitWebpageTestHooks.fetchHtml
+        ? await visitWebpageTestHooks.fetchHtml(url)
+        : await fetchPage(url);
+    if (finalUrl !== url)
+        sourcesConsulted.push(finalUrl);
+    const title = extractTitle(html);
+    const links = extractLinks(html, finalUrl);
+    // Primary: Python bs4; fallback: regex
+    let content = extractTextViaPython(html);
+    if (!content || content.length < MIN_CONTENT_CHARS) {
+        content = extractTextViaRegex(html);
+    }
+    content = await applyPiiGate(content);
+    const truncated = content.length > maxChars;
+    if (truncated)
+        content = content.slice(0, maxChars);
+    return {
+        title,
+        content,
+        links: links.slice(0, MAX_LINKS),
+        sources_consulted: sourcesConsulted,
+        chars_returned: content.length,
+        truncated,
+    };
+}
+// ---------------------------------------------------------------------------
+// Format output for Claude
+// ---------------------------------------------------------------------------
+function formatResult(result, url) {
+    const lines = [];
+    lines.push(`[visit_webpage: ${url}]`);
+    if (result.title)
+        lines.push(`Title: ${result.title}`);
+    if (result.sources_consulted.length > 1) {
+        lines.push(`Redirected to: ${result.sources_consulted[result.sources_consulted.length - 1]}`);
+    }
+    if (result.truncated)
+        lines.push(`[Content truncated at ${result.chars_returned} chars]`);
+    lines.push('');
+    lines.push(result.content || '[No readable content extracted]');
+    if (result.links.length > 0) {
+        lines.push('');
+        lines.push(`Links (${result.links.length}):`);
+        for (const link of result.links)
+            lines.push(`  ${link.text} → ${link.href}`);
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// GaiaTool implementation
+// ---------------------------------------------------------------------------
+export class VisitWebpageTool {
+    name = 'visit_webpage';
+    definition = {
+        name: 'visit_webpage',
+        description: 'Fetch the FULL text content of a webpage URL. Unlike web_search (snippets only) ' +
+            'or grounded_query (synthesised summary), visit_webpage returns the complete readable ' +
+            "text — equivalent to HAL's visit_webpage tool. Use this when you need to read a " +
+            'specific Wikipedia article, documentation page, government site, or any web page ' +
+            'in full to extract detailed facts, tables, or text not available from snippets. ' +
+            'Returns: page title, full text content (up to max_chars), and up to 30 extracted links. ' +
+            `Default max_chars: ${DEFAULT_MAX_CHARS}. Maximum: 100,000.`,
+        input_schema: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'The full URL (http:// or https://) of the webpage to fetch.',
+                },
+                max_chars: {
+                    type: 'number',
+                    description: `Maximum characters of content to return (default: ${DEFAULT_MAX_CHARS}, max: 100000).`,
+                },
+            },
+            required: ['url'],
+        },
+    };
+    async execute(input) {
+        const url = String(input['url'] ?? '').trim();
+        validateUrl(url);
+        const maxChars = Math.min(Math.max(500, Number(input['max_chars'] ?? DEFAULT_MAX_CHARS)), 100_000);
+        process.stderr.write(`[visit_webpage] url=${url} max_chars=${maxChars}\n`);
+        const result = await visitWebpage(url, maxChars);
+        process.stderr.write(`[visit_webpage] title=${JSON.stringify(result.title)} ` +
+            `chars=${result.chars_returned} truncated=${result.truncated} ` +
+            `links=${result.links.length}\n`);
+        if (!result.content || result.content.length < MIN_CONTENT_CHARS) {
+            return `[visit_webpage: page at ${url} returned no readable text content]`;
+        }
+        return formatResult(result, url);
+    }
+}
+// ---------------------------------------------------------------------------
+// Convenience factory
+// ---------------------------------------------------------------------------
+export function createVisitWebpageTool() {
+    return new VisitWebpageTool();
+}
+//# sourceMappingURL=visit_webpage.js.map

package/dist/src/benchmarks/gaia-tools/visit_webpage.js.map

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

package/dist/src/benchmarks/gaia-tools/web_browse.d.ts

@@ -0,0 +1,61 @@
+/**
+ * GAIA Tool: web_browse — ADR-133-PR5
+ *
+ * Opens a URL in a headless Chromium browser via Playwright and extracts
+ * page content (text, HTML, or screenshot).  Covers the ~10-15pp of GAIA
+ * Level-1 questions that require navigating dynamic JS pages, video pages
+ * (YouTube, Vimeo), and paywalled/login-required content.
+ *
+ * ============================================================
+ * PLAYWRIGHT DEPENDENCY — OPT-IN INSTALL
+ * ============================================================
+ * Playwright is NOT a hard runtime dep of @claude-flow/cli.  It is loaded
+ * lazily via a dynamic import so the package installs cleanly without it.
+ *
+ * To use web_browse, run once:
+ *   npm install playwright
+ *   npx playwright install chromium
+ *
+ * If Playwright is not installed, execute() returns a structured error
+ * message that Claude can relay to the user rather than crashing.
+ *
+ * Install size: ~80 MB for the Playwright package + Chromium binary.
+ * Add as a devDependency in benchmark-specific contexts to avoid bloating
+ * the production bundle.
+ *
+ * ============================================================
+ * RESOURCE CAPS
+ * ============================================================
+ * - Text/HTML extraction capped at 8 000 characters (prevents context-window
+ *   overflow; roughly 2 000 tokens).
+ * - Default timeout: 30 seconds.
+ * - Screenshots returned as base64-encoded PNG strings.
+ * - Browser instance is always closed in a `finally` block.
+ *
+ * Refs: ADR-133, #2156
+ */
+import { GaiaTool, ToolDefinition } from './types.js';
+export type BrowseExtract = 'text' | 'html' | 'screenshot';
+export interface WebBrowseInput {
+    url: string;
+    wait_for_selector?: string;
+    extract?: BrowseExtract;
+    timeout_seconds?: number;
+}
+export interface WebBrowseResult {
+    content: string;
+    final_url: string;
+    status: number;
+    truncated?: boolean;
+}
+export declare class WebBrowseTool implements GaiaTool {
+    readonly name = "web_browse";
+    readonly definition: ToolDefinition;
+    execute(input: Record<string, unknown>): Promise<string>;
+}
+export interface WebBrowseToolOptions {
+    /** Override default timeout in milliseconds. */
+    defaultTimeoutMs?: number;
+}
+export declare function createWebBrowseTool(_opts?: WebBrowseToolOptions): WebBrowseTool;
+//# sourceMappingURL=web_browse.d.ts.map

package/dist/src/benchmarks/gaia-tools/web_browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_browse.d.ts","sourceRoot":"","sources":["../../../../src/benchmarks/gaia-tools/web_browse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAatD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA6JD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAoCjC;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAoB/D;AAMD,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAE/E"}