@trenchwork/erosolar 1.1.16

package/dist/tools/skillTools.js

@@ -0,0 +1,140 @@
+/**
+ * Skills — Claude-Code-parity skill registry.
+ *
+ * A skill is a markdown file that documents a reusable approach
+ * (e.g., "simplify", "security-review", "init-project") with
+ * frontmatter metadata. The agent invokes a skill via
+ * `Skill({ name })`, which loads the skill body and returns it as
+ * the tool result. The model then follows the instructions inline.
+ *
+ * Storage layout (priority order — both load, project takes precedence):
+ *   <workingDir>/.erosolar/skills/<skill-name>/SKILL.md
+ *   ~/.erosolar/skills/<skill-name>/SKILL.md
+ *
+ * Frontmatter:
+ *   ---
+ *   name: simplify
+ *   description: Review changed code for reuse and quality.
+ *   ---
+ *
+ *   Body — instructions, examples, anything markdown.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { parseFrontmatter } from '../utils/frontmatter.js';
+function skillDirs(workingDir) {
+    return [
+        join(workingDir, '.erosolar', 'skills'),
+        join(homedir(), '.erosolar', 'skills'),
+    ];
+}
+/**
+ * Discover skills from disk. Project-local skills override
+ * user-global ones with the same name. Each entry must be either
+ * `<name>/SKILL.md` (folder form) or `<name>.md` (flat form).
+ */
+function loadSkills(workingDir) {
+    const out = new Map();
+    // Visit user-global FIRST so project-local can overwrite.
+    for (const dir of [...skillDirs(workingDir)].reverse()) {
+        if (!existsSync(dir))
+            continue;
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const entryPath = join(dir, entry);
+            let mdPath = null;
+            try {
+                const st = statSync(entryPath);
+                if (st.isDirectory()) {
+                    const candidate = join(entryPath, 'SKILL.md');
+                    if (existsSync(candidate))
+                        mdPath = candidate;
+                }
+                else if (st.isFile() && entry.toLowerCase().endsWith('.md')) {
+                    mdPath = entryPath;
+                }
+            }
+            catch {
+                continue;
+            }
+            if (!mdPath)
+                continue;
+            let raw;
+            try {
+                raw = readFileSync(mdPath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const { attributes, body } = parseFrontmatter(raw);
+            const name = (attributes.name ?? entry.replace(/\.md$/i, '').replace(/[\\/]/g, '_')).trim();
+            if (!name)
+                continue;
+            const description = (attributes.description ?? '').trim() || '(no description)';
+            out.set(name, { name, description, body: body.trim(), source: mdPath });
+        }
+    }
+    return out;
+}
+export function createSkillTools(workingDir) {
+    return [
+        {
+            name: 'list_skills',
+            description: 'List available agent skills (reusable prompts/playbooks loaded from `.erosolar/skills/`). Each skill has a name + one-line description; load one with the `Skill` tool to read its full body.',
+            parameters: { type: 'object', properties: {}, additionalProperties: false },
+            handler: async () => {
+                const skills = loadSkills(workingDir);
+                if (skills.size === 0) {
+                    return 'No skills installed. Add one at .erosolar/skills/<name>/SKILL.md (with a `name:` and `description:` in frontmatter).';
+                }
+                const lines = [`Skills (${skills.size}):`];
+                for (const s of [...skills.values()].sort((a, b) => a.name.localeCompare(b.name))) {
+                    lines.push(`  - ${s.name} — ${s.description}`);
+                }
+                return lines.join('\n');
+            },
+        },
+        {
+            name: 'Skill',
+            description: 'Load a named skill\'s body (a markdown playbook). The returned text is instructions for the agent to follow for this turn. Use list_skills FIRST to discover what\'s installed. Skills express reusable approaches — "simplify", "security-review", etc. — so you don\'t have to re-prompt the same workflow each turn.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Skill name (matching the `name:` frontmatter or directory name).' },
+                },
+                required: ['name'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const name = String(args['name'] ?? '').trim();
+                if (!name)
+                    return 'Error: name is required.';
+                const skills = loadSkills(workingDir);
+                const skill = skills.get(name);
+                if (!skill) {
+                    const available = [...skills.keys()].sort().join(', ') || '(none installed)';
+                    return `Skill not found: ${name}. Available: ${available}`;
+                }
+                if (!skill.body) {
+                    return `Skill ${name} has no body.`;
+                }
+                return [
+                    `# Skill: ${skill.name}`,
+                    skill.description,
+                    '',
+                    '---',
+                    '',
+                    skill.body,
+                ].join('\n');
+            },
+        },
+    ];
+}
+//# sourceMappingURL=skillTools.js.map

package/dist/tools/skillTools.js.map

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

package/dist/tools/todoTools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * TodoWrite tool — Claude-Code-parity task list.
+ *
+ * The agent uses TodoWrite to track multi-step work. Each call
+ * REPLACES the entire list (not append) so the agent owns the full
+ * state each turn. The list is rendered via formatPlan and is
+ * surfaced to the user as scrollback so they see what the agent is
+ * planning vs. completing.
+ *
+ * State is kept per-process (CLI = single process), so a session-long
+ * todo list persists across turns until the agent rewrites it.
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+import { type PlanStatus } from '../utils/planFormatter.js';
+interface Todo {
+    content: string;
+    status: PlanStatus;
+    activeForm?: string;
+}
+export declare function getCurrentTodos(): readonly Todo[];
+export declare function clearCurrentTodos(): void;
+export declare function createTodoTools(): ToolDefinition[];
+export {};
+//# sourceMappingURL=todoTools.d.ts.map

package/dist/tools/todoTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoTools.d.ts","sourceRoot":"","sources":["../../src/tools/todoTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAExE,UAAU,IAAI;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,eAAe,IAAI,SAAS,IAAI,EAAE,CAEjD;AACD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAqBD,wBAAgB,eAAe,IAAI,cAAc,EAAE,CAuDlD"}

package/dist/tools/todoTools.js

@@ -0,0 +1,101 @@
+/**
+ * TodoWrite tool — Claude-Code-parity task list.
+ *
+ * The agent uses TodoWrite to track multi-step work. Each call
+ * REPLACES the entire list (not append) so the agent owns the full
+ * state each turn. The list is rendered via formatPlan and is
+ * surfaced to the user as scrollback so they see what the agent is
+ * planning vs. completing.
+ *
+ * State is kept per-process (CLI = single process), so a session-long
+ * todo list persists across turns until the agent rewrites it.
+ */
+import { formatPlan } from '../utils/planFormatter.js';
+/**
+ * Module-scoped state. CLI runs one process per session; the list
+ * stays in memory until the process exits or the agent rewrites it.
+ */
+let CURRENT_TODOS = [];
+export function getCurrentTodos() {
+    return CURRENT_TODOS;
+}
+export function clearCurrentTodos() {
+    CURRENT_TODOS = [];
+}
+function normalize(input) {
+    if (!Array.isArray(input))
+        return [];
+    const out = [];
+    for (const item of input) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const rec = item;
+        const content = typeof rec['content'] === 'string' ? rec['content'].trim() : '';
+        if (!content)
+            continue;
+        const rawStatus = typeof rec['status'] === 'string' ? rec['status'].toLowerCase() : 'pending';
+        const status = rawStatus === 'completed' ? 'completed'
+            : rawStatus === 'in_progress' || rawStatus === 'in-progress' ? 'in_progress'
+                : 'pending';
+        const activeForm = typeof rec['activeForm'] === 'string' ? rec['activeForm'].trim() : undefined;
+        out.push({ content, status, ...(activeForm ? { activeForm } : {}) });
+    }
+    return out;
+}
+export function createTodoTools() {
+    return [
+        {
+            name: 'TodoWrite',
+            description: [
+                'Create or replace the agent\'s working task list. Use proactively for any',
+                'multi-step task (3+ distinct steps). Pass the COMPLETE list every time —',
+                'each call replaces the previous list. Mark a task `in_progress` BEFORE',
+                'starting it and `completed` IMMEDIATELY after, before moving to the next.',
+                'The list shows the user what the agent is planning vs. what\'s done.',
+            ].join(' '),
+            parameters: {
+                type: 'object',
+                properties: {
+                    todos: {
+                        type: 'array',
+                        description: 'The full task list. Replaces the previous one entirely.',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                content: { type: 'string', description: 'Imperative task title (e.g. "Fix the auth bug").' },
+                                status: {
+                                    type: 'string',
+                                    enum: ['pending', 'in_progress', 'completed'],
+                                    description: 'Current state. Exactly one task should be in_progress at a time.',
+                                },
+                                activeForm: {
+                                    type: 'string',
+                                    description: 'Present-continuous form shown while in_progress (e.g. "Fixing the auth bug"). Optional.',
+                                },
+                            },
+                            required: ['content', 'status'],
+                        },
+                    },
+                },
+                required: ['todos'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const todos = normalize(args['todos']);
+                CURRENT_TODOS = todos;
+                // Soft validation: at most one in_progress at a time.
+                const inProgressCount = todos.filter((t) => t.status === 'in_progress').length;
+                const validationNote = inProgressCount > 1
+                    ? `\n  Warning: ${inProgressCount} tasks are in_progress — only one should be active at a time.`
+                    : '';
+                const planItems = todos.map((t) => ({
+                    step: t.status === 'in_progress' && t.activeForm ? t.activeForm : t.content,
+                    status: t.status,
+                }));
+                const formatted = formatPlan(planItems, { heading: 'Updated Plan' });
+                return `${formatted}${validationNote}`;
+            },
+        },
+    ];
+}
+//# sourceMappingURL=todoTools.js.map

package/dist/tools/todoTools.js.map

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

package/dist/tools/webTools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Web Tools - Web search and content extraction capabilities
+ *
+ * Provides:
+ * - WebSearch: Search the web using Tavily
+ * - WebExtract: Extract and summarize content from URLs
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+interface TavilySearchResult {
+    title: string;
+    url: string;
+    content: string;
+    score?: number;
+    published_date?: string;
+}
+interface TavilySearchResponse {
+    results: TavilySearchResult[];
+    answer?: string;
+    query: string;
+}
+/**
+ * Create web tools for search and extraction.
+ */
+export declare function createWebTools(): ToolDefinition[];
+export type { TavilySearchResponse };
+//# sourceMappingURL=webTools.d.ts.map

package/dist/tools/webTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTools.d.ts","sourceRoot":"","sources":["../../src/tools/webTools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,oBAAoB;IAC5B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AASD;;GAEG;AACH,wBAAgB,cAAc,IAAI,cAAc,EAAE,CA+JjD;AAmMD,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/tools/webTools.js

@@ -0,0 +1,332 @@
+/**
+ * Web Tools - Web search and content extraction capabilities
+ *
+ * Provides:
+ * - WebSearch: Search the web using Tavily
+ * - WebExtract: Extract and summarize content from URLs
+ */
+import { getSecretValue } from '../core/secretStore.js';
+import { buildError } from '../core/errors.js';
+/**
+ * Create web tools for search and extraction.
+ */
+export function createWebTools() {
+    return [
+        {
+            name: 'WebSearch',
+            description: 'Search the web for current/up-to-date information using Tavily. Use proactively for news, events, recent releases, library docs that may have changed, or any time-sensitive lookup. Works out of the box via the Erosolar-hosted proxy; set TAVILY_API_KEY for unlimited use.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'The search query',
+                    },
+                    maxResults: {
+                        type: 'number',
+                        description: 'Maximum number of results to return (default: 5, max: 10)',
+                    },
+                    searchDepth: {
+                        type: 'string',
+                        enum: ['basic', 'advanced'],
+                        description: 'Search depth: basic (fast) or advanced (thorough). Default: basic',
+                    },
+                    includeAnswer: {
+                        type: 'boolean',
+                        description: 'Include AI-generated answer summary. Default: true',
+                    },
+                },
+                required: ['query'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const query = args['query'];
+                if (typeof query !== 'string' || !query.trim()) {
+                    return 'Error: query is required';
+                }
+                const maxResults = Math.min(typeof args['maxResults'] === 'number' ? args['maxResults'] : 5, 10);
+                const searchDepth = args['searchDepth'] === 'advanced' ? 'advanced' : 'basic';
+                const includeAnswer = args['includeAnswer'] !== false;
+                try {
+                    const tavilyKey = getSecretValue('TAVILY_API_KEY');
+                    if (tavilyKey) {
+                        return await searchTavily(query, tavilyKey, { maxResults, searchDepth, includeAnswer });
+                    }
+                    // No local key — fall back to the Erosolar-hosted Tavily proxy so
+                    // the agent can search proactively out of the box. Counts against
+                    // the operator's Tavily quota; users wanting unlimited can set
+                    // TAVILY_API_KEY locally.
+                    return await searchTavilyViaProxy(query, { maxResults, searchDepth, includeAnswer });
+                }
+                catch (error) {
+                    return buildError('WebSearch', error, { query });
+                }
+            },
+        },
+        {
+            name: 'WebExtract',
+            description: 'Extract and summarize content from one or more URLs using Tavily. Use after WebSearch when you need the full content of a specific page (docs, articles, GitHub issues). Requires TAVILY_API_KEY.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    urls: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'URLs to extract content from (max 5)',
+                    },
+                    url: {
+                        type: 'string',
+                        description: 'Single URL to extract content from (alternative to urls array)',
+                    },
+                },
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                let urls = [];
+                if (Array.isArray(args['urls'])) {
+                    urls = args['urls'].filter((u) => typeof u === 'string');
+                }
+                else if (typeof args['url'] === 'string') {
+                    urls = [args['url']];
+                }
+                if (urls.length === 0) {
+                    return 'Error: at least one URL is required';
+                }
+                // Limit to 5 URLs
+                urls = urls.slice(0, 5);
+                const tavilyKey = getSecretValue('TAVILY_API_KEY');
+                if (!tavilyKey) {
+                    return 'WebExtract requires TAVILY_API_KEY to be configured. Use /secrets set TAVILY_API_KEY to configure.';
+                }
+                try {
+                    return await extractTavily(urls, tavilyKey);
+                }
+                catch (error) {
+                    return buildError('WebExtract', error, { urls: urls.join(', ') });
+                }
+            },
+        },
+        {
+            name: 'WebFetch',
+            description: 'Fetch the raw content of a single URL via HTTP GET. Returns the response body as text (HTML/JSON/plain). Use this when you need the LITERAL page content (e.g., reading a specific docs page, fetching a JSON API). For research / "what does the web say about X" queries, use WebSearch instead — Tavily returns clean summaries.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    url: { type: 'string', description: 'Absolute http(s):// URL to fetch.' },
+                    maxBytes: { type: 'number', description: 'Cap the response at this many bytes (default 200_000, max 2_000_000).' },
+                },
+                required: ['url'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const url = args['url']?.trim();
+                if (!url)
+                    return 'Error: url is required.';
+                if (!/^https?:\/\//i.test(url))
+                    return 'Error: url must start with http:// or https://.';
+                const requestedCap = typeof args['maxBytes'] === 'number' ? args['maxBytes'] : 200_000;
+                const cap = Math.max(1024, Math.min(2_000_000, requestedCap));
+                try {
+                    // 30s upper bound — long enough for slow doc sites, short
+                    // enough that the user doesn't watch a stalled spinner.
+                    const controller = new AbortController();
+                    const timer = setTimeout(() => controller.abort(), 30_000);
+                    const res = await fetch(url, {
+                        redirect: 'follow',
+                        signal: controller.signal,
+                        headers: { 'User-Agent': 'erosolar-coder/WebFetch' },
+                    }).finally(() => clearTimeout(timer));
+                    if (!res.ok) {
+                        return `Error: HTTP ${res.status} ${res.statusText} fetching ${url}`;
+                    }
+                    const ctype = res.headers.get('content-type') || 'unknown';
+                    const buf = await res.arrayBuffer();
+                    const truncated = buf.byteLength > cap;
+                    const slice = truncated ? buf.slice(0, cap) : buf;
+                    // Decode as UTF-8. Binary content will look like garbage —
+                    // we're optimizing for HTML/text/JSON which dominates web
+                    // fetching.
+                    const text = new TextDecoder('utf-8', { fatal: false }).decode(slice);
+                    const headerLines = [
+                        `[WebFetch ${url}]`,
+                        `Status: ${res.status}  Content-Type: ${ctype}  Size: ${buf.byteLength} bytes${truncated ? ` (truncated to ${cap})` : ''}`,
+                        '',
+                    ];
+                    return headerLines.join('\n') + text;
+                }
+                catch (error) {
+                    if (error.name === 'AbortError') {
+                        return `Error: WebFetch timed out (30s) for ${url}`;
+                    }
+                    return buildError('WebFetch', error, { url });
+                }
+            },
+        },
+    ];
+}
+// Erosolar's hosted Tavily proxy (AWS API Gateway → Lambda). Lets the CLI
+// search out of the box for users who haven't set TAVILY_API_KEY locally;
+// counts against the operator's Tavily quota.
+const EROSOLAR_TAVILY_PROXY_URL = 'https://cfqeqx4lt9.execute-api.us-east-1.amazonaws.com/api/tavilySearch';
+/**
+ * Fallback for users without a local TAVILY_API_KEY: hit the Erosolar
+ * server-side proxy which uses the operator's key. Returns the same
+ * markdown shape as `searchTavily`. Errors propagate as a string for the
+ * tool harness to surface without crashing the agent loop.
+ */
+async function searchTavilyViaProxy(query, options) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 30_000);
+    try {
+        const res = await fetch(EROSOLAR_TAVILY_PROXY_URL, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                query,
+                maxResults: options.maxResults,
+                depth: options.searchDepth,
+                includeAnswer: options.includeAnswer,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            if (res.status === 503) {
+                return 'WebSearch is temporarily unavailable on the Erosolar proxy. Set TAVILY_API_KEY locally with `/secrets set TAVILY_API_KEY` for unlimited use.';
+            }
+            throw new Error(`Erosolar Tavily proxy error: ${res.status} ${text.slice(0, 300)}`);
+        }
+        const data = (await res.json());
+        return formatTavilyResults(data, 'Tavily (via Erosolar)');
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error('WebSearch via Erosolar proxy timed out after 30 seconds');
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Search using Tavily API (recommended provider)
+ */
+async function searchTavily(query, apiKey, options) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 24 * 60 * 60 * 1000); // 24 hour timeout
+    try {
+        const response = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                api_key: apiKey,
+                query,
+                search_depth: options.searchDepth,
+                include_answer: options.includeAnswer,
+                max_results: options.maxResults,
+            }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`Tavily API error: ${response.status} ${text}`);
+        }
+        const data = (await response.json());
+        return formatTavilyResults(data, 'Tavily');
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error('Tavily search timed out after 30 seconds');
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Extract content using Tavily Extract API
+ */
+async function extractTavily(urls, apiKey) {
+    const response = await fetch('https://api.tavily.com/extract', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            api_key: apiKey,
+            urls,
+        }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Tavily Extract API error: ${response.status} ${text}`);
+    }
+    const data = (await response.json());
+    return formatExtractResults(data);
+}
+/**
+ * Format Tavily search results with enhanced markdown formatting
+ */
+function formatTavilyResults(data, provider) {
+    const lines = [`[WebSearch via ${provider}]`, ''];
+    if (data.answer) {
+        lines.push('**Summary:**', data.answer, '');
+    }
+    if (!data.results || data.results.length === 0) {
+        lines.push('No results found.');
+        return lines.join('\n');
+    }
+    if (data.results.length > 0) {
+        lines.push('**Search Results:**');
+        lines.push('');
+        for (let i = 0; i < data.results.length; i++) {
+            const result = data.results[i];
+            // Format as numbered list with clickable title link
+            lines.push(`${i + 1}. **[${result.title}](${result.url})**`);
+            if (result.content) {
+                const snippet = result.content.length > 300
+                    ? result.content.slice(0, 300) + '...'
+                    : result.content;
+                lines.push(`   ${snippet}`);
+            }
+            if (result.published_date) {
+                lines.push(`   *Published: ${result.published_date}*`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format Tavily extract results with enhanced markdown formatting
+ */
+function formatExtractResults(data) {
+    const lines = ['[WebExtract via Tavily]', ''];
+    if (!data.results || data.results.length === 0) {
+        lines.push('No content extracted.');
+        return lines.join('\n');
+    }
+    for (let i = 0; i < data.results.length; i++) {
+        const result = data.results[i];
+        lines.push(`### Source ${i + 1}: [${result.url}](${result.url})`);
+        lines.push('');
+        if (result.raw_content) {
+            // Truncate very long content
+            const content = result.raw_content.length > 5000
+                ? result.raw_content.slice(0, 5000) + '\n\n*[Content truncated...]*'
+                : result.raw_content;
+            lines.push(content);
+        }
+        lines.push('');
+        if (i < data.results.length - 1) {
+            lines.push('---');
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=webTools.js.map