@orion-agents/orion-code 0.1.0

package/dist/tools/web.js

@@ -0,0 +1,586 @@
+"use strict";
+/**
+ * orion code - Web Tools
+ *
+ * WebFetch: Fetch URL content and process with prompt
+ * WebSearch: delegate search to provider MCP service
+ *
+ * Issue #32 #3.7: SSRF 拦截 - 拒绝访问内网地址 + Content-Length 上限
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEB_TOOLS = exports.webSearchTool = exports.webFetchTool = void 0;
+exports.isUrlSafeForSSRF = isUrlSafeForSSRF;
+exports.clearWebFetchCache = clearWebFetchCache;
+exports.resetWebSearchMcpClientForTests = resetWebSearchMcpClientForTests;
+const tool_1 = require("../framework/tool");
+const config_1 = require("../services/config");
+const web_search_mcp_1 = require("../services/web-search-mcp");
+const web_search_provider_1 = require("../services/web-search-provider");
+const web_search_adapters_1 = require("../services/web-search-adapters");
+// ============================================================================
+// SSRF Protection - Issue #32 #3.7
+// ============================================================================
+/** 内网 IP 地址范围（禁止访问） */
+const BLOCKED_IP_PATTERNS = [
+    /^127\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/, // 127.x.x.x (localhost range)
+    /^10\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/, // 10.x.x.x (private class A)
+    /^192\.168\.(\d{1,3})\.(\d{1,3})$/, // 192.168.x.x (private class C)
+    /^169\.254\.(\d{1,3})\.(\d{1,3})$/, // 169.254.x.x (link-local)
+    /^172\.(1[6-9]|2\d|3[01])\.(\d{1,3})\.(\d{1,3})$/, // 172.16-31.x.x (private class B)
+    /^0\.0\.0\.0$/, // 0.0.0.0
+    /^::1$/, // IPv6 localhost
+    /^fc[0-9a-f]{2}:/i, // IPv6 unique local
+    /^fe[8-9a-f][0-9a-f]:/i, // IPv6 link-local
+];
+/** 禁止访问的主机名 */
+const BLOCKED_HOSTNAMES = [
+    'localhost',
+    'localhost.localdomain',
+    'ip6-localhost',
+    'ip6-loopback',
+    'metadata.google.internal', // GCP metadata server
+    'metadata', // Azure metadata
+    'kubernetes.default', // K8s internal
+    'kubernetes.default.svc',
+];
+/** 最大响应内容长度 (10MB) */
+const MAX_CONTENT_LENGTH = 10 * 1024 * 1024;
+/**
+ * 检查 URL 是否为内网地址
+ * @param url - 要检查的 URL
+ * @returns 是否为安全的（非内网）地址
+ */
+function isUrlSafeForSSRF(url) {
+    try {
+        const parsed = new URL(url);
+        let hostname = parsed.hostname.toLowerCase();
+        // URL.hostname keeps brackets around IPv6 literals (e.g. "[::1]"); strip them
+        // so the BLOCKED_IP_PATTERNS anchors (^::1$, etc.) can match.
+        if (hostname.startsWith('[') && hostname.endsWith(']')) {
+            hostname = hostname.slice(1, -1);
+        }
+        // 检查禁止的主机名
+        if (BLOCKED_HOSTNAMES.includes(hostname)) {
+            return { safe: false, reason: `Blocked hostname: ${hostname}` };
+        }
+        // 检查内网 IP 模式
+        for (const pattern of BLOCKED_IP_PATTERNS) {
+            if (pattern.test(hostname)) {
+                return { safe: false, reason: `Blocked IP range: ${hostname}` };
+            }
+        }
+        // 检查 IP 编码绕过（十进制/十六进制/八进制/IPv6-mapped IPv4）。
+        // 这些形式在 fetch 时会被解析为内网地址，但字符串正则无法识别。
+        const normalizedV4 = parseIPv4Loose(hostname);
+        if (normalizedV4) {
+            for (const pattern of BLOCKED_IP_PATTERNS) {
+                if (pattern.test(normalizedV4)) {
+                    return { safe: false, reason: `Blocked IP range: ${hostname} (resolves to ${normalizedV4})` };
+                }
+            }
+        }
+        // 检查以 .internal, .local, .localhost 结尾的主机名
+        if (hostname.endsWith('.internal') || hostname.endsWith('.local') || hostname.endsWith('.localhost')) {
+            return { safe: false, reason: `Blocked internal hostname: ${hostname}` };
+        }
+        return { safe: true };
+    }
+    catch {
+        // URL 解析失败
+        return { safe: false, reason: 'Invalid URL format' };
+    }
+}
+/**
+ * 将各种 IPv4 编码形式归一化为点分十进制。
+ * 覆盖：纯十进制整数、十六进制、八进制、IPv6-mapped IPv4 (::ffff:a.b.c.d)。
+ * 无法识别时返回 null。
+ */
+function parseIPv4Loose(host) {
+    // IPv6-mapped IPv4, dotted form: ::ffff:127.0.0.1 / ::ffff:0:127.0.0.1
+    const v6dotted = host.match(/::ffff:(?:0+:)?(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/i);
+    if (v6dotted)
+        return normalizeDotted(v6dotted[1]);
+    // IPv6-mapped IPv4, hex form: ::ffff:7f00:1 (Node's URL canonicalizes to this)
+    const v6hex = host.match(/::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/i);
+    if (v6hex) {
+        const hi = parseInt(v6hex[1], 16);
+        const lo = parseInt(v6hex[2], 16);
+        return `${(hi >>> 8) & 255}.${hi & 255}.${(lo >>> 8) & 255}.${lo & 255}`;
+    }
+    // 单个十进制整数（如 2130706433 -> 127.0.0.1）
+    if (/^\d+$/.test(host)) {
+        const n = Number(host);
+        if (n <= 0xffffffff && Number.isSafeInteger(n)) {
+            return `${(n >>> 24) & 255}.${(n >>> 16) & 255}.${(n >>> 8) & 255}.${n & 255}`;
+        }
+    }
+    // 单个十六进制（如 0x7f000001）
+    if (/^0x[0-9a-f]+$/i.test(host)) {
+        const n = parseInt(host, 16);
+        if (n <= 0xffffffff) {
+            return `${(n >>> 24) & 255}.${(n >>> 16) & 255}.${(n >>> 8) & 255}.${n & 255}`;
+        }
+    }
+    // 点分形式，各段可为十进制/八进制/十六进制（如 0177.0.0.1）
+    if (host.includes('.')) {
+        const parts = host.split('.');
+        if (parts.length === 4) {
+            const octets = parts.map(parseOctet);
+            if (octets.every(o => o !== null && o >= 0 && o <= 255)) {
+                return octets.join('.');
+            }
+        }
+    }
+    return null;
+}
+function parseOctet(s) {
+    if (/^0x[0-9a-f]+$/i.test(s))
+        return parseInt(s, 16);
+    if (/^0[0-7]+$/.test(s))
+        return parseInt(s, 8);
+    if (/^\d+$/.test(s))
+        return parseInt(s, 10);
+    return null;
+}
+function normalizeDotted(dotted) {
+    const parts = dotted.split('.');
+    if (parts.length !== 4)
+        return null;
+    const octets = parts.map(p => {
+        const n = parseInt(p, 10);
+        return Number.isFinite(n) && n >= 0 && n <= 255 ? n : null;
+    });
+    if (octets.some(o => o === null))
+        return null;
+    return octets.join('.');
+}
+// ============================================================================
+// WebFetch Tool
+// ============================================================================
+/** Preapproved hosts that don't need permission */
+const PREAPPROVED_HOSTS = [
+    'github.com',
+    'docs.google.com',
+    'stackoverflow.com',
+    'npmjs.com',
+    'nodejs.org',
+    'typescriptlang.org',
+    'reactjs.org',
+    'vuejs.org',
+    'python.org',
+    'golang.org',
+    'rust-lang.org',
+    'mdn.mozilla.org',
+    'developer.mozilla.org',
+    'wikipedia.org',
+    'arxiv.org',
+];
+const MAX_MARKDOWN_LENGTH = 100000;
+const FETCH_CACHE_TTL_MS = 15 * 60 * 1000;
+const FETCH_CACHE_MAX_ENTRIES = 50;
+const fetchCache = new Map();
+function cacheGet(url) {
+    const entry = fetchCache.get(url);
+    if (!entry)
+        return null;
+    if (Date.now() - entry.ts > FETCH_CACHE_TTL_MS) {
+        fetchCache.delete(url);
+        return null;
+    }
+    return entry.data;
+}
+function cacheSet(url, data) {
+    // Cap size — drop oldest entry when full
+    if (fetchCache.size >= FETCH_CACHE_MAX_ENTRIES) {
+        const oldest = fetchCache.keys().next().value;
+        if (oldest)
+            fetchCache.delete(oldest);
+    }
+    fetchCache.set(url, { ts: Date.now(), data });
+}
+function isPreapprovedHost(hostname, _pathname) {
+    return PREAPPROVED_HOSTS.some(host => hostname === host || hostname.endsWith('.' + host));
+}
+/** Simple HTML to Markdown converter */
+function htmlToMarkdown(html) {
+    let md = html;
+    // Remove script, style, nav, header, footer tags
+    md = md.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '');
+    md = md.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '');
+    md = md.replace(/<nav[^>]*>[\s\S]*?<\/nav>/gi, '');
+    md = md.replace(/<header[^>]*>[\s\S]*?<\/header>/gi, '');
+    md = md.replace(/<footer[^>]*>[\s\S]*?<\/footer>/gi, '');
+    // Convert headings
+    md = md.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '# $1\n\n');
+    md = md.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '## $1\n\n');
+    md = md.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '### $1\n\n');
+    md = md.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, '#### $1\n\n');
+    md = md.replace(/<h5[^>]*>([\s\S]*?)<\/h5>/gi, '##### $1\n\n');
+    md = md.replace(/<h6[^>]*>([\s\S]*?)<\/h6>/gi, '###### $1\n\n');
+    // Bold and italic
+    md = md.replace(/<strong[^>]*>([\s\S]*?)<\/strong>/gi, '**$1**');
+    md = md.replace(/<b[^>]*>([\s\S]*?)<\/b>/gi, '**$1**');
+    md = md.replace(/<em[^>]*>([\s\S]*?)<\/em>/gi, '*$1*');
+    md = md.replace(/<i[^>]*>([\s\S]*?)<\/i>/gi, '*$1*');
+    // Links
+    md = md.replace(/<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)');
+    // Code blocks
+    md = md.replace(/<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/gi, '\n```\n$1\n```\n');
+    md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, '`$1`');
+    // Lists
+    md = md.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '- $1\n');
+    md = md.replace(/<ul[^>]*>([\s\S]*?)<\/ul>/gi, '$1');
+    md = md.replace(/<ol[^>]*>([\s\S]*?)<\/ol>/gi, '$1');
+    // Paragraphs and divs
+    md = md.replace(/<p[^>]*>([\s\S]*?)<\/p>/gi, '$1\n\n');
+    md = md.replace(/<div[^>]*>([\s\S]*?)<\/div>/gi, '$1\n');
+    md = md.replace(/<br\s*\/?>/gi, '\n');
+    // Remove remaining tags
+    md = md.replace(/<[^>]+>/g, '');
+    // Clean up whitespace
+    md = md.replace(/\n{3,}/g, '\n\n');
+    md = md.trim();
+    return md;
+}
+async function fetchUrl(url, _maxRedirects = 5) {
+    const cached = cacheGet(url);
+    if (cached)
+        return { ...cached, url };
+    // Issue #32 #3.7: SSRF 检查
+    const ssrfCheck = isUrlSafeForSSRF(url);
+    if (!ssrfCheck.safe) {
+        return {
+            content: `SSRF blocked: ${ssrfCheck.reason}`,
+            code: 403,
+            contentType: 'text/plain',
+            errorType: 'SSRF_BLOCKED',
+        };
+    }
+    try {
+        // Issue #20 修复：启用 redirect: 'follow' 自动跟随重定向
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'Orion-Code/0.2.27',
+                'Accept': 'text/html,application/xhtml+xml,text/markdown,text/plain,*/*',
+            },
+            redirect: 'follow', // 自动跟随重定向（最多 20 次，由 fetch 内置限制）
+        });
+        // Issue #32 #3.7: Content-Length 检查
+        const contentLength = response.headers.get('content-length');
+        if (contentLength && parseInt(contentLength, 10) > MAX_CONTENT_LENGTH) {
+            return {
+                content: `Response too large: Content-Length ${contentLength} exceeds ${MAX_CONTENT_LENGTH} bytes`,
+                code: 413,
+                contentType: 'text/plain',
+                errorType: 'CONTENT_TOO_LARGE',
+            };
+        }
+        const contentType = response.headers.get('content-type') || 'text/plain';
+        const finalUrl = response.url;
+        const redirects = [];
+        // 记录重定向信息（如果发生了重定向）
+        if (response.redirected && finalUrl !== url) {
+            redirects.push(finalUrl);
+        }
+        if (!response.ok) {
+            return {
+                content: `HTTP Error ${response.status}: ${response.statusText}`,
+                code: response.status,
+                contentType,
+                url: finalUrl,
+                redirects,
+                errorType: 'HTTP_ERROR',
+            };
+        }
+        const text = await response.text();
+        // Convert to markdown if HTML
+        let content = text;
+        if (contentType.includes('text/html')) {
+            content = htmlToMarkdown(text);
+        }
+        // Truncate if too large
+        if (content.length > MAX_MARKDOWN_LENGTH) {
+            content = content.slice(0, MAX_MARKDOWN_LENGTH) + '\n\n[... content truncated]';
+        }
+        const result = {
+            content,
+            code: response.status,
+            contentType,
+            url: finalUrl,
+            redirects,
+        };
+        if (response.ok)
+            cacheSet(url, { content, code: response.status, contentType });
+        return result;
+    }
+    catch (err) {
+        return {
+            content: `Fetch error: ${err.message}`,
+            code: 0,
+            contentType: 'text/plain',
+            errorType: 'NETWORK_ERROR',
+        };
+    }
+}
+/** Clear the fetch cache (test helper / debugging) */
+function clearWebFetchCache() {
+    fetchCache.clear();
+}
+/** Apply prompt to content using simple extraction */
+function applyPromptToContent(content, prompt) {
+    // For simple prompts, return the content directly
+    const lowerPrompt = prompt.toLowerCase();
+    if (lowerPrompt.includes('title') || lowerPrompt.includes('name')) {
+        // Try to extract title
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        if (titleMatch) {
+            return `Title: ${titleMatch[1]}\n\n${content}`;
+        }
+    }
+    if (lowerPrompt.includes('summary') || lowerPrompt.includes('summarize')) {
+        // Return first few paragraphs as summary
+        const paragraphs = content.split('\n\n').filter(p => p.length > 50);
+        const summary = paragraphs.slice(0, 3).join('\n\n');
+        return `Summary:\n${summary}\n\n---\n\nFull content:\n${content}`;
+    }
+    // Default: return content with prompt context
+    return `Prompt: "${prompt}"\n\nContent:\n${content}`;
+}
+exports.webFetchTool = (0, tool_1.buildTool)({
+    name: 'web_fetch',
+    description: `Fetch content from a URL and process with a prompt.
+IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs.
+Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub).`,
+    parameters: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The URL to fetch content from (must be a valid URL)',
+            },
+            prompt: {
+                type: 'string',
+                description: 'The prompt to run on the fetched content (e.g. "extract the title", "summarize the content")',
+            },
+        },
+        required: ['url', 'prompt'],
+    },
+    execute: async (args) => {
+        const url = args.url;
+        const prompt = args.prompt;
+        if (!url || typeof url !== 'string') {
+            return { success: false, output: '', error: 'web_fetch requires a url parameter' };
+        }
+        if (!prompt || typeof prompt !== 'string') {
+            return { success: false, output: '', error: 'web_fetch requires a prompt parameter' };
+        }
+        // Validate URL
+        try {
+            const parsed = new URL(url);
+            if (!parsed.protocol.startsWith('http')) {
+                return { success: false, output: '', error: 'URL must use http or https protocol' };
+            }
+        }
+        catch {
+            return { success: false, output: '', error: `Invalid URL: ${url}` };
+        }
+        const { content, code, url: finalUrl, redirects, errorType } = await fetchUrl(url);
+        // Issue #20 修复：返回结构化结果
+        // Issue #32 #3.7: SSRF 和 Content-Length 错误处理
+        if (code !== 200) {
+            const errorInfo = {
+                type: errorType || 'HTTP_ERROR',
+                code,
+                message: content,
+                url: finalUrl,
+                redirects: redirects || [],
+            };
+            // SSRF 或 Content-Length 错误时返回更详细的错误
+            if (errorType === 'SSRF_BLOCKED') {
+                return {
+                    success: false,
+                    output: '',
+                    error: `Security policy blocked access to internal network address. ${content}`,
+                };
+            }
+            if (errorType === 'CONTENT_TOO_LARGE') {
+                return {
+                    success: false,
+                    output: '',
+                    error: `Response exceeds maximum allowed size (${MAX_CONTENT_LENGTH} bytes). ${content}`,
+                };
+            }
+            return {
+                success: false,
+                output: '',
+                error: JSON.stringify(errorInfo),
+            };
+        }
+        const resultContent = applyPromptToContent(content, prompt);
+        const finalUrlInfo = finalUrl !== url ? `\n\nFinal URL (after redirects): ${finalUrl}` : '';
+        return {
+            success: true,
+            output: resultContent + finalUrlInfo,
+        };
+    },
+    isReadOnly: () => true,
+    isConcurrencySafe: () => true,
+    checkPermissions: (args) => {
+        const url = args.url;
+        try {
+            const parsed = new URL(url);
+            if (isPreapprovedHost(parsed.hostname, parsed.pathname)) {
+                return { behavior: 'allow', reason: 'Preapproved host' };
+            }
+        }
+        catch {
+            // Invalid URL - will fail in execute
+        }
+        return { behavior: 'ask', reason: 'Fetching external URL' };
+    },
+    userFacingName: (args) => {
+        try {
+            const url = new URL(args.url);
+            return `Fetch ${url.hostname}`;
+        }
+        catch {
+            return `Fetch ${args.url}`;
+        }
+    },
+});
+// ============================================================================
+// WebSearch Tool - provider MCP delegation
+// ============================================================================
+let cachedWebSearchClient = null;
+function getWebSearchMcpClient() {
+    const config = (0, config_1.loadConfig)();
+    const webSearch = (0, web_search_provider_1.resolveWebSearchMcpConfig)(config);
+    const key = JSON.stringify({
+        provider: webSearch.provider,
+        endpoint: webSearch.endpoint,
+        apiKey: webSearch.apiKey ? `${webSearch.apiKey.slice(0, 8)}...` : '',
+        toolName: webSearch.toolName || '',
+        timeoutMs: webSearch.timeoutMs || 0,
+        authType: webSearch.authType || '',
+        apiKeyHeader: webSearch.apiKeyHeader || '',
+        apiKeyQueryParam: webSearch.apiKeyQueryParam || '',
+        headers: Object.keys(webSearch.headers || {}).sort(),
+    });
+    if (!cachedWebSearchClient || cachedWebSearchClient.key !== key) {
+        cachedWebSearchClient = {
+            key,
+            client: new web_search_mcp_1.WebSearchMcpClient(webSearch),
+        };
+    }
+    return cachedWebSearchClient.client;
+}
+function resetWebSearchMcpClientForTests() {
+    cachedWebSearchClient = null;
+}
+exports.webSearchTool = (0, tool_1.buildTool)({
+    name: 'web_search',
+    description: `Search the web through the built-in WebSearch provider chain.
+Orion Code tries provider-native MCP first in auto mode, then falls back to configured search adapters such as Tavily, Brave, custom search, or DuckDuckGo.
+You MUST include the Sources section with markdown hyperlinks in your response.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query (minimum 2 characters)',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of results (optional, default 5)',
+            },
+        },
+        required: ['query'],
+    },
+    execute: async (args) => {
+        const query = args.query;
+        const limit = args.limit || 5;
+        if (!query || typeof query !== 'string') {
+            return { success: false, output: '', error: 'web_search requires a query parameter' };
+        }
+        if (query.length < 2) {
+            return { success: false, output: '', error: 'Query must be at least 2 characters' };
+        }
+        const config = (0, config_1.loadConfig)();
+        const mode = (0, web_search_adapters_1.getWebSearchMode)(config);
+        let mcpError = null;
+        if ((0, web_search_adapters_1.shouldTryMcpFirst)(mode)) {
+            try {
+                const result = await getWebSearchMcpClient().search(query, limit);
+                return {
+                    success: true,
+                    output: result.output,
+                    metadata: { source: 'websearch-mcp', provider: result.provider, endpoint: result.endpoint, tool: result.toolName },
+                };
+            }
+            catch (err) {
+                const resolvedConfig = (0, web_search_provider_1.resolveWebSearchMcpConfig)(config);
+                mcpError = err instanceof web_search_mcp_1.WebSearchMcpError
+                    ? err
+                    : new web_search_mcp_1.WebSearchMcpError('WEBSEARCH_MCP_ERROR', err.message || String(err), resolvedConfig.endpoint || web_search_mcp_1.DEFAULT_WEBSEARCH_MCP_ENDPOINT);
+                if (!(0, web_search_adapters_1.shouldFallbackToAdapters)(mode)) {
+                    return {
+                        success: false,
+                        output: '',
+                        error: JSON.stringify({
+                            type: mcpError.type,
+                            source: 'websearch-mcp',
+                            endpoint: mcpError.endpoint,
+                            message: mcpError.message,
+                            suggestion: (0, web_search_provider_1.getWebSearchMcpErrorSuggestion)(resolvedConfig),
+                        }),
+                        metadata: { source: 'websearch-mcp', provider: resolvedConfig.provider, endpoint: mcpError.endpoint },
+                    };
+                }
+            }
+        }
+        try {
+            const adapterResult = await (0, web_search_adapters_1.runWebSearchAdapters)({ query, limit }, (0, web_search_adapters_1.isExplicitAdapterMode)(mode) ? mode : 'auto');
+            return {
+                success: true,
+                output: (0, web_search_adapters_1.formatAdapterOutput)(adapterResult, query),
+                metadata: { source: 'websearch-adapter', provider: adapterResult.provider, mcpError: mcpError?.type },
+            };
+        }
+        catch (adapterErr) {
+            const resolvedConfig = (0, web_search_provider_1.resolveWebSearchMcpConfig)(config);
+            return {
+                success: false,
+                output: '',
+                error: JSON.stringify({
+                    type: 'WEBSEARCH_UNAVAILABLE',
+                    source: 'websearch',
+                    mode,
+                    mcp: mcpError
+                        ? {
+                            type: mcpError.type,
+                            endpoint: mcpError.endpoint,
+                            message: mcpError.message,
+                        }
+                        : undefined,
+                    adapter: adapterErr?.message || String(adapterErr),
+                    suggestion: [
+                        (0, web_search_provider_1.getWebSearchMcpErrorSuggestion)(resolvedConfig),
+                        'Or set ORION_CODE_WEBSEARCH_PROVIDER=ddg/tavily/brave/custom with the matching adapter configuration.',
+                    ].join(' '),
+                }),
+                metadata: { source: 'websearch', provider: resolvedConfig.provider, endpoint: resolvedConfig.endpoint },
+            };
+        }
+    },
+    isReadOnly: () => true,
+    isConcurrencySafe: () => true,
+    checkPermissions: () => {
+        return { behavior: 'ask', reason: 'Web search may query external services' };
+    },
+    userFacingName: (args) => `Search "${args.query?.slice(0, 30)}"`,
+});
+// ============================================================================
+// Export
+// ============================================================================
+exports.WEB_TOOLS = [exports.webFetchTool, exports.webSearchTool];
+//# sourceMappingURL=web.js.map

package/dist/tools/web.js.map

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

package/dist/tui-core/frame.d.ts

@@ -0,0 +1,37 @@
+import { type TuiStyle } from './style';
+export interface TuiCursor {
+    row: number;
+    column: number;
+    visible: boolean;
+}
+export interface TuiCell {
+    char: string;
+    width: 0 | 1 | 2;
+    /** Normalized style. Defaults to DEFAULT_STYLE (shared immutable). */
+    style: TuiStyle;
+}
+export interface TuiFrame {
+    width: number;
+    height: number;
+    rows: TuiCell[][];
+    cursor: TuiCursor;
+}
+export interface TuiFrameDiff {
+    changedRows: number[];
+    cursorChanged: boolean;
+}
+export declare function createTuiFrame(width: number, height: number): TuiFrame;
+export declare function writeFrameText(frame: TuiFrame, row: number, column: number, text: string, style?: TuiStyle): void;
+export declare function setFrameCursor(frame: TuiFrame, row: number, column: number, visible?: boolean): void;
+export declare function renderFrameRows(frame: TuiFrame): string[];
+export declare function diffTuiFrames(previous: TuiFrame | null, next: TuiFrame): TuiFrameDiff;
+/**
+ * Render a single frame row into styled spans by merging consecutive cells
+ * with the same style key. Continuation cells (width 0) are skipped.
+ * The encoder emits SGR per span and SGR0 at row end.
+ */
+export declare function renderStyledFrameRow(cells: TuiCell[]): {
+    text: string;
+    style: TuiStyle;
+}[];
+//# sourceMappingURL=frame.d.ts.map

package/dist/tui-core/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/tui-core/frame.ts"],"names":[],"mappings":"AACA,OAAO,EAA2C,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjF,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,sEAAsE;IACtE,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAStE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,QAAwB,GAAG,IAAI,CA4BhI;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,IAAI,CAMjG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAIzD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,GAAG,YAAY,CAuBrF;AA2CD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,EAAE,CA4B1F"}