aura-code 0.3.0

package/dist/tools/tools.js

@@ -0,0 +1,328 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDir = listDir;
+exports.writeFile = writeFile;
+exports.searchCode = searchCode;
+exports.runShell = runShell;
+exports.runTests = runTests;
+exports.gitStatus = gitStatus;
+exports.gitDiff = gitDiff;
+// ─────────────────────────────────────────────────────────────────────────────
+// list_dir
+// ─────────────────────────────────────────────────────────────────────────────
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const defaults_js_1 = require("../config/defaults.js");
+/** Match a filename against a simple glob pattern (supports leading/trailing *). */
+function matchGlob(name, pattern) {
+    if (!pattern.includes('*'))
+        return name === pattern;
+    if (pattern === '*')
+        return true;
+    if (pattern.startsWith('*') && pattern.endsWith('*'))
+        return name.includes(pattern.slice(1, -1));
+    if (pattern.startsWith('*'))
+        return name.endsWith(pattern.slice(1));
+    if (pattern.endsWith('*'))
+        return name.startsWith(pattern.slice(0, -1));
+    // Multiple wildcards: check prefix and suffix
+    const firstStar = pattern.indexOf('*');
+    const lastStar = pattern.lastIndexOf('*');
+    if (firstStar !== lastStar) {
+        const prefix = pattern.substring(0, firstStar);
+        const suffix = pattern.substring(lastStar + 1);
+        return name.startsWith(prefix) && name.endsWith(suffix);
+    }
+    return name === pattern;
+}
+function listDir(input, cwd) {
+    const dirPath = path.resolve(cwd, input.path ?? '.');
+    if (!fs.existsSync(dirPath))
+        return `Error: Directory not found: ${input.path}`;
+    const lines = [];
+    function walk(dir, prefix, currentDepth) {
+        if (currentDepth > input.depth)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        const filtered = entries.filter(e => !defaults_js_1.IGNORE_PATTERNS.some(p => matchGlob(e.name, p)));
+        filtered.sort((a, b) => {
+            if (a.isDirectory() && !b.isDirectory())
+                return -1;
+            if (!a.isDirectory() && b.isDirectory())
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        for (let i = 0; i < filtered.length; i++) {
+            const e = filtered[i];
+            const isLast = i === filtered.length - 1;
+            const connector = isLast ? '└── ' : '├── ';
+            const childPrefix = isLast ? prefix + '    ' : prefix + '│   ';
+            lines.push(`${prefix}${connector}${e.name}${e.isDirectory() ? '/' : ''}`);
+            if (e.isDirectory() && input.recursive)
+                walk(path.join(dir, e.name), childPrefix, currentDepth + 1);
+        }
+    }
+    const rel = path.relative(cwd, dirPath) || '.';
+    lines.push(rel + '/');
+    walk(dirPath, '', 1);
+    if (lines.length > 200) {
+        return lines.slice(0, 200).join('\n') + `\n\n... (${lines.length - 200} more entries — use a more specific path)`;
+    }
+    return lines.join('\n');
+}
+function writeFile(input, cwd) {
+    const filePath = path.resolve(cwd, input.path);
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const existed = fs.existsSync(filePath);
+    fs.writeFileSync(filePath, input.content, 'utf8');
+    const lines = input.content.split('\n').length;
+    return `✓ ${existed ? 'Overwrote' : 'Created'} ${input.path} (${lines} lines)`;
+}
+function searchCode(input, cwd) {
+    const searchDir = path.resolve(cwd, input.path ?? '.');
+    // Try ripgrep first (much faster), fall back to grep
+    const hasRg = (() => { try {
+        (0, child_process_1.execSync)('which rg', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    } })();
+    const flagsRg = ['-n', '--no-heading', '--max-count=1'];
+    const flagsGrep = ['-rn'];
+    if (!input.case_sensitive) {
+        if (hasRg)
+            flagsRg.push('-i');
+        else
+            flagsGrep.push('-i');
+    }
+    if (input.literal) {
+        if (hasRg)
+            flagsRg.push('-F');
+        else
+            flagsGrep.push('-F');
+    }
+    if (input.file_glob) {
+        if (hasRg)
+            flagsRg.push('--glob=' + input.file_glob);
+        else
+            flagsGrep.push('--include', input.file_glob);
+    }
+    try {
+        if (hasRg) {
+            // Use execFileSync with args array to avoid shell injection
+            const result = (0, child_process_1.execFileSync)('rg', flagsRg.concat([input.pattern, searchDir]), {
+                encoding: 'utf8',
+                maxBuffer: 2 * 1024 * 1024,
+            });
+            const allLines = result.trim() ? result.trim().split('\n').filter(Boolean) : [];
+            const lines = allLines.slice(0, input.max_results);
+            if (lines.length === 0)
+                return 'No results for "' + input.pattern + '"';
+            const relative = lines.map(l => l.replace(searchDir + '/', '').replace(searchDir + path.sep, ''));
+            const truncated = allLines.length > lines.length ? ' (showing first ' + lines.length + ' of ' + allLines.length + ')' : '';
+            return 'Found ' + allLines.length + ' result' + (allLines.length > 1 ? 's' : '') + ' for "' + input.pattern + '"' + truncated + ':\n\n' + relative.join('\n');
+        }
+        else {
+            const result = (0, child_process_1.execFileSync)('grep', flagsGrep.concat(['--', input.pattern, searchDir]), {
+                encoding: 'utf8',
+                maxBuffer: 2 * 1024 * 1024,
+            });
+            const allLines = result.trim() ? result.trim().split('\n').filter(Boolean) : [];
+            const lines = allLines.slice(0, input.max_results);
+            if (lines.length === 0)
+                return 'No results for "' + input.pattern + '"';
+            const relative = lines.map(l => l.replace(searchDir + '/', '').replace(searchDir + path.sep, ''));
+            const truncated = allLines.length > lines.length ? ' (showing first ' + lines.length + ' of ' + allLines.length + ')' : '';
+            return 'Found ' + allLines.length + ' result' + (allLines.length > 1 ? 's' : '') + ' for "' + input.pattern + '"' + truncated + ':\n\n' + relative.join('\n');
+        }
+    }
+    catch (e) {
+        // Exit code 1 from grep/rg means no results
+        if (typeof e === 'object' && e !== null && 'status' in e && e.status === 1) {
+            return 'No results for "' + input.pattern + '"';
+        }
+        return 'Search error: ' + String(e);
+    }
+}
+/**
+ * Run a shell command with SIGKILL escalation on timeout.
+ *
+ * Uses `spawn` with `detached: true` so the child gets its own process group.
+ * On timeout: SIGTERM is sent to the process group; after a grace period,
+ * SIGKILL follows. This handles processes that trap or ignore SIGTERM.
+ *
+ * NOTE: Even SIGKILL cannot terminate a true D-state process blocked on
+ * hardware/network I/O (e.g. an unresponsive FUSE mount). That is a Linux
+ * kernel limitation — the real fix is preventing traversal into such paths
+ * (see BLOCKED_TRAVERSAL_PATHS in config/defaults.ts).
+ */
+async function runShell(input, projectCwd) {
+    const workDir = input.cwd ? path.resolve(projectCwd, input.cwd) : projectCwd;
+    const timeout = input.timeout ?? 30_000;
+    const SIGKILL_GRACE_MS = 2_000;
+    const MAX_BUFFER = 2 * 1024 * 1024;
+    return new Promise((resolve) => {
+        const proc = (0, child_process_1.spawn)(input.command, {
+            shell: true,
+            detached: true,
+            cwd: workDir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let exceededBuffer = false;
+        proc.stdout.on('data', (chunk) => {
+            if (!exceededBuffer) {
+                stdout += chunk.toString();
+                if (stdout.length > MAX_BUFFER)
+                    exceededBuffer = true;
+            }
+        });
+        proc.stderr.on('data', (chunk) => {
+            if (!exceededBuffer) {
+                stderr += chunk.toString();
+                if (stderr.length > MAX_BUFFER)
+                    exceededBuffer = true;
+            }
+        });
+        // Timeout → SIGTERM → grace → SIGKILL
+        const timer = setTimeout(() => {
+            try {
+                process.kill(-proc.pid, 'SIGTERM');
+            }
+            catch { /* already dead */ }
+            const grace = setTimeout(() => {
+                try {
+                    process.kill(-proc.pid, 'SIGKILL');
+                }
+                catch { /* already dead */ }
+            }, SIGKILL_GRACE_MS);
+            proc.on('exit', () => clearTimeout(grace));
+        }, timeout);
+        proc.on('exit', (code, signal) => {
+            clearTimeout(timer);
+            if (exceededBuffer) {
+                resolve(`Error: Output exceeded ${MAX_BUFFER} bytes`);
+                return;
+            }
+            if (signal === 'SIGTERM' || signal === 'SIGKILL') {
+                resolve(`Error: Command timed out after ${timeout}ms`);
+                return;
+            }
+            if (code !== 0 && stderr.trim()) {
+                resolve(stderr.trim());
+                return;
+            }
+            resolve(stdout.trim() || '(command completed with no output)');
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            resolve(`Error: ${err.message}`);
+        });
+    });
+}
+async function runTests(input, cwd) {
+    // Detect test framework
+    let testCmd = detectTestCommand(cwd, input.file_or_pattern);
+    return runShell({ command: testCmd, timeout: 60_000 }, cwd);
+}
+function detectTestCommand(cwd, fileOrPattern) {
+    const pkg = path.join(cwd, 'package.json');
+    if (fs.existsSync(pkg)) {
+        const p = JSON.parse(fs.readFileSync(pkg, 'utf8'));
+        const scripts = p.scripts ?? {};
+        const deps = { ...(p.dependencies ?? {}), ...(p.devDependencies ?? {}) };
+        const pat = fileOrPattern ? ` ${JSON.stringify(fileOrPattern)}` : '';
+        if (deps.vitest || scripts.test?.includes('vitest'))
+            return `npx vitest run${pat}`;
+        if (deps.jest || scripts.test?.includes('jest'))
+            return `npx jest${pat}`;
+        if (scripts.test)
+            return `npm test${fileOrPattern ? ` -- ${fileOrPattern}` : ''}`;
+    }
+    if (fs.existsSync(path.join(cwd, 'pytest.ini')) || fs.existsSync(path.join(cwd, 'setup.py'))) {
+        return `python -m pytest${fileOrPattern ? ` ${fileOrPattern}` : ''} -v`;
+    }
+    if (fs.existsSync(path.join(cwd, 'go.mod'))) {
+        return `go test${fileOrPattern ? ` ${fileOrPattern}` : ' ./...'}`;
+    }
+    if (fs.existsSync(path.join(cwd, 'Cargo.toml'))) {
+        return `cargo test${fileOrPattern ? ` ${fileOrPattern}` : ''}`;
+    }
+    return 'npm test';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// git tools
+// ─────────────────────────────────────────────────────────────────────────────
+function gitStatus(cwd) {
+    try {
+        const status = (0, child_process_1.execSync)('git status --short', { cwd, encoding: 'utf8' }).trim();
+        const log = (0, child_process_1.execSync)('git log --oneline -5', { cwd, encoding: 'utf8' }).trim();
+        const branch = (0, child_process_1.execSync)('git branch --show-current', { cwd, encoding: 'utf8' }).trim();
+        return [
+            `Branch: ${branch}`,
+            '',
+            status ? `Changed files:\n${status}` : 'Working tree clean',
+            '',
+            `Recent commits:\n${log}`,
+        ].join('\n');
+    }
+    catch {
+        return 'Not a git repository (or git not installed)';
+    }
+}
+function gitDiff(input, cwd) {
+    try {
+        const staged = input.staged ? '--staged ' : '';
+        const file = input.path ? `-- ${JSON.stringify(input.path)}` : '';
+        const diff = (0, child_process_1.execSync)(`git diff ${staged}${file}`, { cwd, encoding: 'utf8' });
+        return diff.trim() || `No ${input.staged ? 'staged ' : ''}changes${input.path ? ` in ${input.path}` : ''}`;
+    }
+    catch (e) {
+        return `Git error: ${String(e)}`;
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools/tools.js.map

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

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '../providers/types.js';
+export interface WebFetchInput {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD';
+    headers?: Record<string, string>;
+    body?: string;
+    max_chars?: number;
+    timeout_ms?: number;
+}
+export declare const WEB_FETCH_DEFINITION: ToolDefinition;
+export declare function webFetch(input: WebFetchInput): Promise<string>;

package/dist/tools/web-fetch.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEB_FETCH_DEFINITION = void 0;
+exports.webFetch = webFetch;
+const sanitize_js_1 = require("../util/sanitize.js");
+exports.WEB_FETCH_DEFINITION = {
+    name: 'web_fetch',
+    description: 'Fetch content from a URL. Returns the response body as text. ' +
+        'Supports GET/POST/PUT/DELETE/PATCH/HEAD. Useful for reading web pages, ' +
+        'calling APIs, downloading files. Large responses are truncated.',
+    parameters: {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'The URL to fetch' },
+            method: { type: 'string', description: 'HTTP method (default: GET)' },
+            headers: { type: 'object', description: 'Request headers as key-value string pairs' },
+            body: { type: 'string', description: 'Request body (for POST/PUT/PATCH)' },
+            max_chars: { type: 'number', description: 'Max characters to return (default: 50000)' },
+            timeout_ms: { type: 'number', description: 'Request timeout in ms (default: 15000)' },
+        },
+        required: ['url'],
+    },
+};
+const MAX_CHARS_DEFAULT = 50_000;
+const TIMEOUT_MS_DEFAULT = 15_000;
+const MAX_REDIRECTS = 5;
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max) + `\n\n... [truncated — ${text.length} chars total, showing first ${max}]`;
+}
+async function webFetch(input) {
+    const url = input.url;
+    const method = (input.method ?? 'GET').toUpperCase();
+    const maxChars = input.max_chars ?? MAX_CHARS_DEFAULT;
+    const timeoutMs = input.timeout_ms ?? TIMEOUT_MS_DEFAULT;
+    // Validate URL
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return `Error: Invalid URL: ${url}`;
+    }
+    if (!['http:', 'https:'].includes(parsed.protocol)) {
+        return `Error: Unsupported protocol: ${parsed.protocol} (only http/https supported)`;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const headers = {
+            'User-Agent': 'Aura/0.2.4 (AI Agent)',
+            'Accept': 'text/html,application/xhtml+xml,application/json,text/plain,*/*',
+            ...input.headers,
+        };
+        if (input.body && !headers['Content-Type']) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: input.body,
+            signal: controller.signal,
+            redirect: 'follow',
+        });
+        clearTimeout(timer);
+        const status = response.status;
+        const statusText = response.statusText;
+        const contentType = response.headers.get('content-type') ?? '';
+        const contentLength = response.headers.get('content-length');
+        let body;
+        try {
+            body = await response.text();
+        }
+        catch (e) {
+            return `Error reading response body: ${String(e)}`;
+        }
+        // Build header summary
+        const headerLines = [
+            `HTTP ${status} ${statusText}`,
+            `Content-Type: ${contentType}`,
+        ];
+        if (contentLength) {
+            headerLines.push(`Content-Length: ${contentLength}`);
+        }
+        headerLines.push(`URL: ${url}`);
+        headerLines.push('');
+        const headerBlock = headerLines.join('\n');
+        if (!response.ok) {
+            return `${headerBlock}Error: HTTP ${status} ${statusText}\n\n${truncate(body, maxChars)}`;
+        }
+        // Auto-detect and clean HTML
+        const isHtml = contentType.includes('html');
+        const isJson = contentType.includes('json');
+        let processed = body;
+        if (isHtml) {
+            processed = (0, sanitize_js_1.stripHtml)(body);
+        }
+        // For JSON, try to pretty-print
+        if (isJson) {
+            try {
+                const parsed = JSON.parse(processed);
+                processed = JSON.stringify(parsed, null, 2);
+            }
+            catch {
+                // leave as-is if parse fails
+            }
+        }
+        return `${headerBlock}${truncate(processed, maxChars)}`;
+    }
+    catch (e) {
+        clearTimeout(timer);
+        if (e?.name === 'AbortError') {
+            return `Error: Request timed out after ${timeoutMs}ms — ${url}`;
+        }
+        return `Error fetching ${url}: ${String(e?.message ?? e)}`;
+    }
+}
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/web-fetch.js.map

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

package/dist/tools/web-search.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from '../providers/types.js';
+export interface WebSearchInput {
+    query: string;
+    max_results?: number;
+    region?: string;
+}
+export declare const WEB_SEARCH_DEFINITION: ToolDefinition;
+export declare function webSearch(input: WebSearchInput): Promise<string>;

package/dist/tools/web-search.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEB_SEARCH_DEFINITION = void 0;
+exports.webSearch = webSearch;
+const sanitize_js_1 = require("../util/sanitize.js");
+exports.WEB_SEARCH_DEFINITION = {
+    name: 'web_search',
+    description: 'Search the web using DuckDuckGo. Returns titles, URLs, and snippets. ' +
+        'No API key required. Use for research, fact-checking, finding documentation.',
+    parameters: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'The search query' },
+            max_results: { type: 'number', description: 'Max results to return (default: 10)' },
+            region: { type: 'string', description: 'Search region (default: wt-wt for global)' },
+        },
+        required: ['query'],
+    },
+};
+function extractResults(html) {
+    const results = [];
+    // Match DuckDuckGo result blocks
+    const resultRegex = /<a[^>]+class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<a[^>]+class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+    let match;
+    while ((match = resultRegex.exec(html)) !== null) {
+        let url = match[1];
+        // DuckDuckGo wraps URLs in a redirect — extract the real URL
+        const uddg = url.match(/uddg=([^&]+)/);
+        if (uddg)
+            url = decodeURIComponent(uddg[1]);
+        const title = (0, sanitize_js_1.stripHtml)(match[2]).trim();
+        const snippet = (0, sanitize_js_1.stripHtml)(match[3]).trim();
+        if (title && url) {
+            results.push({ title, url, snippet });
+        }
+    }
+    return results;
+}
+async function webSearch(input) {
+    const maxResults = input.max_results ?? 10;
+    const region = input.region ?? 'wt-wt';
+    const query = input.query;
+    if (!query.trim())
+        return 'Error: query is required';
+    const params = new URLSearchParams({
+        q: query,
+        kl: region,
+        t: 'h_',
+    });
+    const url = `https://html.duckduckgo.com/html/?${params}`;
+    try {
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Accept': 'text/html',
+            },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok) {
+            return `Error: DuckDuckGo returned HTTP ${response.status}`;
+        }
+        const html = await response.text();
+        const results = extractResults(html).slice(0, maxResults);
+        if (results.length === 0) {
+            return `No results found for: "${query}"`;
+        }
+        const lines = [`Search results for: "${query}"`, ''];
+        results.forEach((r, i) => {
+            lines.push(`${i + 1}. ${r.title}`);
+            lines.push(`   ${r.url}`);
+            if (r.snippet)
+                lines.push(`   ${r.snippet}`);
+            lines.push('');
+        });
+        return lines.join('\n');
+    }
+    catch (e) {
+        return `Error searching: ${e?.message ?? String(e)}`;
+    }
+}
+//# sourceMappingURL=web-search.js.map

package/dist/tools/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/tools/web-search.ts"],"names":[],"mappings":";;;AAwDA,8BA+CC;AAtGD,qDAAgD;AAYnC,QAAA,qBAAqB,GAAmB;IACnD,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,uEAAuE;QACvE,8EAA8E;IAChF,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACjE,WAAW,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YACpF,MAAM,EAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;SAC3F;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAQF,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,iCAAiC;IACjC,MAAM,WAAW,GAAG,+HAA+H,CAAC;IACpJ,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,6DAA6D;QAC7D,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACvC,IAAI,IAAI;YAAE,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5C,MAAM,KAAK,GAAG,IAAA,uBAAS,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAA,uBAAS,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE3C,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAE1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,0BAA0B,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,CAAC,EAAE,KAAK;QACR,EAAE,EAAE,MAAM;QACV,CAAC,EAAE,IAAI;KACR,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,qCAAqC,MAAM,EAAE,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,YAAY,EAAE,uGAAuG;gBACrH,QAAQ,EAAE,WAAW;aACtB;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,mCAAmC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAE1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,0BAA0B,KAAK,GAAG,CAAC;QAC5C,CAAC;QAED,MAAM,KAAK,GAAa,CAAC,wBAAwB,KAAK,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,oBAAoB,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/tools/whatsapp.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDefinition } from '../providers/types.js';
+export interface WhatsAppInput {
+    action: 'send' | 'send_media' | 'status';
+    to?: string;
+    message?: string;
+    media_url?: string;
+    from?: string;
+}
+export declare const WHATSAPP_DEFINITION: ToolDefinition;
+export declare function whatsAppTool(input: WhatsAppInput): Promise<string>;