antri_cli 1.26.0

package/dist/core/history.js

@@ -0,0 +1,53 @@
+import fs from 'fs';
+export class ConversationHistory {
+    messages = [];
+    maxHistoryTokens = 40000;
+    constructor() {
+        this.messages = [];
+    }
+    addMessage(message) {
+        this.messages.push({
+            ...message,
+            timestamp: Date.now(),
+        });
+    }
+    getMessages() {
+        return [...this.messages];
+    }
+    getLastUserMessage() {
+        for (let i = this.messages.length - 1; i >= 0; i--) {
+            if (this.messages[i].role === 'user') {
+                return this.messages[i];
+            }
+        }
+        return undefined;
+    }
+    clear() {
+        this.messages = [];
+    }
+    length() {
+        return this.messages.length;
+    }
+    exportMarkdown(filePath) {
+        const lines = [
+            `# ANTRI Code Chat Transcript`,
+            `*Generated on ${new Date().toLocaleString()}*`,
+            `---`,
+            '',
+        ];
+        for (const msg of this.messages) {
+            if (msg.role === 'system')
+                continue;
+            const roleName = msg.role.toUpperCase();
+            lines.push(`### 👤 ${roleName}`);
+            lines.push(msg.content);
+            lines.push('');
+        }
+        const content = lines.join('\n');
+        if (filePath) {
+            fs.writeFileSync(filePath, content, 'utf-8');
+        }
+        return content;
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/core/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/core/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAIpB,MAAM,OAAO,mBAAmB;IACtB,QAAQ,GAAkB,EAAE,CAAC;IAC7B,gBAAgB,GAAW,KAAK,CAAC;IAEzC;QACE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAEM,UAAU,CAAC,OAAoB;QACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,GAAG,OAAO;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAEM,WAAW;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAEM,kBAAkB;QACvB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAEM,cAAc,CAAC,QAAiB;QACrC,MAAM,KAAK,GAAa;YACtB,8BAA8B;YAC9B,iBAAiB,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,GAAG;YAC/C,KAAK;YACL,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/core/metaOptimizer.d.ts

@@ -0,0 +1,27 @@
+export interface MetaMetrics {
+    totalQueries: number;
+    successfulQueries: number;
+    toolCallStats: Record<string, {
+        calls: number;
+        errors: number;
+        totalDurationMs: number;
+    }>;
+    selfHealingRepairs: number;
+    synthesizedSkillsCount: number;
+    learnedPromptHeuristics: string[];
+    averageLatencyMs: number;
+}
+export declare class MetaOptimizer {
+    private metrics;
+    constructor();
+    private load;
+    private save;
+    recordToolExecution(toolName: string, durationMs: number, isError: boolean): void;
+    recordSelfHealing(): void;
+    recordQuerySuccess(durationMs: number): void;
+    addHeuristic(heuristic: string): void;
+    getMetrics(): MetaMetrics;
+    renderMetaStatus(): void;
+}
+export declare const metaOptimizer: MetaOptimizer;
+//# sourceMappingURL=metaOptimizer.d.ts.map

package/dist/core/metaOptimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaOptimizer.d.ts","sourceRoot":"","sources":["../../src/core/metaOptimizer.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAgBD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAc;;IAM7B,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,IAAI;IAQL,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAWjF,iBAAiB,IAAI,IAAI;IAKzB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO5C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOrC,UAAU,IAAI,WAAW;IAIzB,gBAAgB,IAAI,IAAI;CA2BhC;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/metaOptimizer.js

@@ -0,0 +1,98 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import chalk from 'chalk';
+const META_FILE = path.join(os.homedir(), '.antri', 'memory', 'meta_optimization.json');
+const DEFAULT_METRICS = {
+    totalQueries: 0,
+    successfulQueries: 0,
+    toolCallStats: {},
+    selfHealingRepairs: 0,
+    synthesizedSkillsCount: 0,
+    learnedPromptHeuristics: [
+        'For high-ambiguity questions, prefer dialectic debate synthesis over single-pass answers.',
+        'For local workspace operations, verify path existence before executing write_file.',
+        'When searching libraries, prioritize official documentation and version-specific release tags.',
+    ],
+    averageLatencyMs: 1200,
+};
+export class MetaOptimizer {
+    metrics;
+    constructor() {
+        this.metrics = this.load();
+    }
+    load() {
+        try {
+            if (fs.existsSync(META_FILE)) {
+                const raw = fs.readFileSync(META_FILE, 'utf-8');
+                return { ...DEFAULT_METRICS, ...JSON.parse(raw) };
+            }
+        }
+        catch { }
+        return { ...DEFAULT_METRICS };
+    }
+    save() {
+        try {
+            const dir = path.dirname(META_FILE);
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(META_FILE, JSON.stringify(this.metrics, null, 2), 'utf-8');
+        }
+        catch { }
+    }
+    recordToolExecution(toolName, durationMs, isError) {
+        if (!this.metrics.toolCallStats[toolName]) {
+            this.metrics.toolCallStats[toolName] = { calls: 0, errors: 0, totalDurationMs: 0 };
+        }
+        const stat = this.metrics.toolCallStats[toolName];
+        stat.calls += 1;
+        if (isError)
+            stat.errors += 1;
+        stat.totalDurationMs += durationMs;
+        this.save();
+    }
+    recordSelfHealing() {
+        this.metrics.selfHealingRepairs += 1;
+        this.save();
+    }
+    recordQuerySuccess(durationMs) {
+        this.metrics.totalQueries += 1;
+        this.metrics.successfulQueries += 1;
+        this.metrics.averageLatencyMs = Math.round((this.metrics.averageLatencyMs + durationMs) / 2);
+        this.save();
+    }
+    addHeuristic(heuristic) {
+        if (!this.metrics.learnedPromptHeuristics.includes(heuristic)) {
+            this.metrics.learnedPromptHeuristics.push(heuristic);
+            this.save();
+        }
+    }
+    getMetrics() {
+        return this.metrics;
+    }
+    renderMetaStatus() {
+        const totalCalls = Object.values(this.metrics.toolCallStats).reduce((acc, curr) => acc + curr.calls, 0);
+        const totalErrors = Object.values(this.metrics.toolCallStats).reduce((acc, curr) => acc + curr.errors, 0);
+        const successRate = totalCalls > 0 ? Math.round(((totalCalls - totalErrors) / totalCalls) * 100) : 100;
+        console.log(chalk.bold.hex('#c084fc')('\n🧬 Meta-Optimization & Self-Evolution Metrics'));
+        console.log(chalk.hex('#334155')('─'.repeat(72)));
+        console.log(`• ${chalk.bold('Overall Tool Success Rate:')}   ${chalk.green(`${successRate}%`)} (${totalCalls - totalErrors}/${totalCalls} calls)`);
+        console.log(`• ${chalk.bold('Autonomous Self-Healings:')}    ${chalk.cyan(this.metrics.selfHealingRepairs)} automatic repairs`);
+        console.log(`• ${chalk.bold('Average Latency:')}             ${chalk.cyan(`${this.metrics.averageLatencyMs}ms`)}`);
+        console.log(`• ${chalk.bold('Learned Strategy Heuristics:')} ${chalk.cyan(this.metrics.learnedPromptHeuristics.length)} heuristics`);
+        if (Object.keys(this.metrics.toolCallStats).length > 0) {
+            console.log(chalk.bold.hex('#a5b4fc')('\n📊 Tool Performance Breakdown:'));
+            for (const [tool, stat] of Object.entries(this.metrics.toolCallStats)) {
+                const rate = stat.calls > 0 ? Math.round(((stat.calls - stat.errors) / stat.calls) * 100) : 100;
+                const avg = Math.round(stat.totalDurationMs / (stat.calls || 1));
+                console.log(`  - ${chalk.cyan(tool.padEnd(16))} Rate: ${rate >= 90 ? chalk.green(`${rate}%`) : chalk.yellow(`${rate}%`)} · Avg: ${avg}ms · Total: ${stat.calls}`);
+            }
+        }
+        console.log(chalk.bold.hex('#a5b4fc')('\n🧠 Meta-Prompt Heuristics:'));
+        this.metrics.learnedPromptHeuristics.forEach((h) => console.log(`  - ${chalk.hex('#94a3b8')(h)}`));
+        console.log(chalk.hex('#334155')('─'.repeat(72)));
+        console.log();
+    }
+}
+export const metaOptimizer = new MetaOptimizer();
+//# sourceMappingURL=metaOptimizer.js.map

package/dist/core/metaOptimizer.js.map

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

package/dist/core/sandbox.d.ts

@@ -0,0 +1,29 @@
+export interface ExecutionResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+    sandboxed: boolean;
+    isolationType: 'docker' | 'subprocess' | 'python';
+}
+export declare class SandboxEngine {
+    private static pythonCommand;
+    private static dockerAvailable;
+    /**
+     * Auto-detect available Python command (python, python3, py)
+     */
+    static getPythonCommand(): Promise<string>;
+    /**
+     * Check if Docker is installed and running
+     */
+    static isDockerAvailable(): Promise<boolean>;
+    /**
+     * Executes Python code in an isolated temporary runtime environment
+     */
+    static executePython(code: string, workingDir?: string, timeoutMs?: number): Promise<ExecutionResult>;
+    /**
+     * Executes Shell command with subprocess/docker isolation
+     */
+    static executeShell(command: string, workingDir?: string, useDockerIfAvailable?: boolean, timeoutMs?: number): Promise<ExecutionResult>;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/core/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/core/sandbox.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;CACnD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAuB;IACnD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAwB;IAEtD;;OAEG;WACiB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAiBvD;;OAEG;WACiB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAYzD;;OAEG;WACiB,aAAa,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,SAAgB,EAC1B,SAAS,SAAQ,GAChB,OAAO,CAAC,eAAe,CAAC;IA2C3B;;OAEG;WACiB,YAAY,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,SAAgB,EAC1B,oBAAoB,UAAQ,EAC5B,SAAS,SAAQ,GAChB,OAAO,CAAC,eAAe,CAAC;CAgD5B"}

package/dist/core/sandbox.js

@@ -0,0 +1,141 @@
+import { exec } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import util from 'util';
+const execPromise = util.promisify(exec);
+export class SandboxEngine {
+    static pythonCommand = null;
+    static dockerAvailable = null;
+    /**
+     * Auto-detect available Python command (python, python3, py)
+     */
+    static async getPythonCommand() {
+        if (this.pythonCommand)
+            return this.pythonCommand;
+        const candidates = ['python', 'python3', 'py'];
+        for (const cmd of candidates) {
+            try {
+                const { stdout } = await execPromise(`${cmd} --version`);
+                if (stdout || cmd) {
+                    this.pythonCommand = cmd;
+                    return cmd;
+                }
+            }
+            catch { }
+        }
+        this.pythonCommand = 'python';
+        return 'python';
+    }
+    /**
+     * Check if Docker is installed and running
+     */
+    static async isDockerAvailable() {
+        if (this.dockerAvailable !== null)
+            return this.dockerAvailable;
+        try {
+            await execPromise('docker info', { timeout: 3000 });
+            this.dockerAvailable = true;
+        }
+        catch {
+            this.dockerAvailable = false;
+        }
+        return this.dockerAvailable;
+    }
+    /**
+     * Executes Python code in an isolated temporary runtime environment
+     */
+    static async executePython(code, workingDir = process.cwd(), timeoutMs = 30000) {
+        const startTime = Date.now();
+        const pyCmd = await this.getPythonCommand();
+        const tempDir = path.join(os.tmpdir(), 'antri_sandbox');
+        if (!fs.existsSync(tempDir)) {
+            fs.mkdirSync(tempDir, { recursive: true });
+        }
+        const scriptPath = path.join(tempDir, `script_${Date.now()}_${Math.random().toString(36).substring(2, 7)}.py`);
+        fs.writeFileSync(scriptPath, code, 'utf-8');
+        try {
+            const { stdout, stderr } = await execPromise(`"${pyCmd}" "${scriptPath}"`, {
+                cwd: workingDir,
+                timeout: timeoutMs,
+                maxBuffer: 1024 * 1024 * 5,
+            });
+            return {
+                stdout: stdout ? stdout.trim() : '',
+                stderr: stderr ? stderr.trim() : '',
+                exitCode: 0,
+                durationMs: Date.now() - startTime,
+                sandboxed: true,
+                isolationType: 'python',
+            };
+        }
+        catch (err) {
+            return {
+                stdout: err.stdout ? err.stdout.trim() : '',
+                stderr: err.stderr ? err.stderr.trim() : (err.message || 'Execution error'),
+                exitCode: err.code || 1,
+                durationMs: Date.now() - startTime,
+                sandboxed: true,
+                isolationType: 'python',
+            };
+        }
+        finally {
+            try {
+                if (fs.existsSync(scriptPath))
+                    fs.unlinkSync(scriptPath);
+            }
+            catch { }
+        }
+    }
+    /**
+     * Executes Shell command with subprocess/docker isolation
+     */
+    static async executeShell(command, workingDir = process.cwd(), useDockerIfAvailable = false, timeoutMs = 30000) {
+        const startTime = Date.now();
+        // Check Docker container isolation option
+        if (useDockerIfAvailable && (await this.isDockerAvailable())) {
+            try {
+                const dockerCmd = `docker run --rm -v "${workingDir}:/workspace" -w /workspace alpine/sh -c "${command.replace(/"/g, '\\"')}"`;
+                const { stdout, stderr } = await execPromise(dockerCmd, { timeout: timeoutMs });
+                return {
+                    stdout: stdout.trim(),
+                    stderr: stderr.trim(),
+                    exitCode: 0,
+                    durationMs: Date.now() - startTime,
+                    sandboxed: true,
+                    isolationType: 'docker',
+                };
+            }
+            catch {
+                // Fallback to native subprocess
+            }
+        }
+        // Subprocess execution
+        try {
+            const { stdout, stderr } = await execPromise(command, {
+                cwd: workingDir,
+                timeout: timeoutMs,
+                maxBuffer: 1024 * 1024 * 5,
+            });
+            return {
+                stdout: (stdout || '').trim(),
+                stderr: (stderr || '').trim(),
+                exitCode: 0,
+                durationMs: Date.now() - startTime,
+                sandboxed: false,
+                isolationType: 'subprocess',
+            };
+        }
+        catch (err) {
+            return {
+                stdout: (err.stdout || '').trim(),
+                stderr: (err.stderr || err.message || '').trim(),
+                exitCode: err.code || 1,
+                durationMs: Date.now() - startTime,
+                sandboxed: false,
+                isolationType: 'subprocess',
+            };
+        }
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/core/sandbox.js.map

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

package/dist/core/scraper.d.ts

@@ -0,0 +1,22 @@
+export interface ScrapedPage {
+    url: string;
+    title: string;
+    markdown: string;
+    links: string[];
+    charCount: number;
+}
+export declare class WebScraper {
+    private static userAgent;
+    /**
+     * Scrapes a URL, extracts primary article/documentation content, and converts to clean Markdown
+     */
+    static scrape(url: string, maxChars?: number): Promise<ScrapedPage>;
+    /**
+     * Trafilatura / Readability-style HTML cleaner and Markdown converter
+     */
+    private static htmlToMarkdown;
+    private static extractLinks;
+    private static cleanText;
+    private static cleanEntities;
+}
+//# sourceMappingURL=scraper.d.ts.map

package/dist/core/scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scraper.d.ts","sourceRoot":"","sources":["../../src/core/scraper.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,SAAS,CAC4F;IAEpH;;OAEG;WACiB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IA6D/E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA+F7B,OAAO,CAAC,MAAM,CAAC,YAAY;IAwB3B,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB,OAAO,CAAC,MAAM,CAAC,aAAa;CAW7B"}

package/dist/core/scraper.js

@@ -0,0 +1,180 @@
+export class WebScraper {
+    static userAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
+    /**
+     * Scrapes a URL, extracts primary article/documentation content, and converts to clean Markdown
+     */
+    static async scrape(url, maxChars = 10000) {
+        try {
+            const parsedUrl = new URL(url);
+            const res = await fetch(url, {
+                headers: {
+                    'User-Agent': this.userAgent,
+                    Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                    'Accept-Language': 'en-US,en;q=0.9',
+                },
+                signal: AbortSignal.timeout(8000),
+            });
+            if (!res.ok) {
+                throw new Error(`HTTP ${res.status} ${res.statusText}`);
+            }
+            const contentType = res.headers.get('content-type') || '';
+            if (!contentType.includes('text') && !contentType.includes('html') && !contentType.includes('json')) {
+                return {
+                    url,
+                    title: 'Binary Content',
+                    markdown: `[Content is binary/non-text: ${contentType}]`,
+                    links: [],
+                    charCount: 0,
+                };
+            }
+            const rawHtml = await res.text();
+            // Extract page title
+            const titleMatch = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(rawHtml);
+            const title = titleMatch ? this.cleanText(titleMatch[1]) : parsedUrl.hostname;
+            // Extract all internal and external links
+            const links = this.extractLinks(rawHtml, url);
+            // Extract and convert main content to markdown
+            let cleanMarkdown = this.htmlToMarkdown(rawHtml, parsedUrl);
+            if (cleanMarkdown.length > maxChars) {
+                cleanMarkdown = cleanMarkdown.slice(0, maxChars) + '\n\n... [Content Truncated]';
+            }
+            return {
+                url,
+                title,
+                markdown: cleanMarkdown,
+                links,
+                charCount: cleanMarkdown.length,
+            };
+        }
+        catch (err) {
+            return {
+                url,
+                title: 'Error Scraping URL',
+                markdown: `Failed to scrape ${url}: ${err.message}`,
+                links: [],
+                charCount: 0,
+            };
+        }
+    }
+    /**
+     * Trafilatura / Readability-style HTML cleaner and Markdown converter
+     */
+    static htmlToMarkdown(html, baseUrl) {
+        let content = html;
+        // 1. Remove non-content elements
+        content = content
+            .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+            .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+            .replace(/<noscript\b[^<]*(?:(?!<\/noscript>)<[^<]*)*<\/noscript>/gi, '')
+            .replace(/<svg\b[^<]*(?:(?!<\/svg>)<[^<]*)*<\/svg>/gi, '')
+            .replace(/<header\b[^<]*(?:(?!<\/header>)<[^<]*)*<\/header>/gi, '')
+            .replace(/<footer\b[^<]*(?:(?!<\/footer>)<[^<]*)*<\/footer>/gi, '')
+            .replace(/<nav\b[^<]*(?:(?!<\/nav>)<[^<]*)*<\/nav>/gi, '')
+            .replace(/<aside\b[^<]*(?:(?!<\/aside>)<[^<]*)*<\/aside>/gi, '')
+            .replace(/<form\b[^<]*(?:(?!<\/form>)<[^<]*)*<\/form>/gi, '')
+            .replace(/<!--[\s\S]*?-->/g, '');
+        // 2. Locate main content container if available
+        const mainMatch = /<main\b[^>]*>([\s\S]*?)<\/main>/i.exec(content) ||
+            /<article\b[^>]*>([\s\S]*?)<\/article>/i.exec(content) ||
+            /<div\b[^>]*(?:class|id)=["'][^"']*(?:content|docs|documentation|markdown|post|article|body)[^"']*["'][^>]*>([\s\S]*?)<\/div>/i.exec(content);
+        if (mainMatch && mainMatch[1].length > 400) {
+            content = mainMatch[1];
+        }
+        // 3. Preserve code blocks
+        const codeBlocks = [];
+        content = content.replace(/<pre[^>]*><code(?: class=["'](?:language-)?([a-zA-Z0-9_-]+)["'])?[^>]*>([\s\S]*?)<\/code><\/pre>/gi, (match, lang, code) => {
+            const cleanCode = this.cleanEntities(code);
+            const placeholder = `__CODE_BLOCK_${codeBlocks.length}__`;
+            codeBlocks.push(`\`\`\`${lang || ''}\n${cleanCode}\n\`\`\``);
+            return placeholder;
+        });
+        content = content.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, (match, code) => {
+            const cleanCode = this.cleanEntities(code);
+            return ` \`${cleanCode.trim()}\` `;
+        });
+        // 4. Convert headings
+        content = content
+            .replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '\n\n# $1\n\n')
+            .replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '\n\n## $1\n\n')
+            .replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '\n\n### $1\n\n')
+            .replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, '\n\n#### $1\n\n')
+            .replace(/<h5[^>]*>([\s\S]*?)<\/h5>/gi, '\n\n##### $1\n\n')
+            .replace(/<h6[^>]*>([\s\S]*?)<\/h6>/gi, '\n\n###### $1\n\n');
+        // 5. Convert lists
+        content = content
+            .replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '\n• $1')
+            .replace(/<\/(ul|ol)>/gi, '\n\n');
+        // 6. Convert links
+        content = content.replace(/<a\b[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi, (match, href, text) => {
+            const cleanText = this.cleanText(text);
+            if (!cleanText || cleanText.length < 2 || href.startsWith('#') || href.startsWith('javascript:')) {
+                return cleanText;
+            }
+            try {
+                const fullUrl = new URL(href, baseUrl).toString();
+                return `[${cleanText}](${fullUrl})`;
+            }
+            catch {
+                return cleanText;
+            }
+        });
+        // 7. Convert text styles
+        content = content
+            .replace(/<(b|strong)[^>]*>([\s\S]*?)<\/\1>/gi, '**$2**')
+            .replace(/<(i|em)[^>]*>([\s\S]*?)<\/\1>/gi, '*$2*')
+            .replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, '\n> $1\n')
+            .replace(/<hr[^>]*>/gi, '\n---\n')
+            .replace(/<br\s*[\/]?>/gi, '\n')
+            .replace(/<p[^>]*>/gi, '\n\n')
+            .replace(/<\/p>/gi, '\n\n');
+        // 8. Strip remaining HTML tags
+        content = content.replace(/<[^>]+>/g, ' ');
+        // 9. Restore code blocks
+        codeBlocks.forEach((code, idx) => {
+            content = content.replace(`__CODE_BLOCK_${idx}__`, `\n\n${code}\n\n`);
+        });
+        // 10. Normalize whitespace and clean entities
+        content = this.cleanEntities(content);
+        content = content
+            .replace(/[ \t]+/g, ' ')
+            .replace(/\n\s*\n\s*\n+/g, '\n\n')
+            .trim();
+        return content;
+    }
+    static extractLinks(html, currentUrl) {
+        const links = new Set();
+        const linkRegex = /<a\b[^>]*href=["']([^"']+)["'][^>]*>/gi;
+        let match;
+        const base = new URL(currentUrl);
+        while ((match = linkRegex.exec(html)) !== null) {
+            const href = match[1];
+            if (href.startsWith('#') || href.startsWith('mailto:') || href.startsWith('tel:') || href.startsWith('javascript:')) {
+                continue;
+            }
+            try {
+                const resolved = new URL(href, base);
+                // Only keep http/https links
+                if (resolved.protocol === 'http:' || resolved.protocol === 'https:') {
+                    links.add(resolved.toString());
+                }
+            }
+            catch { }
+        }
+        return Array.from(links);
+    }
+    static cleanText(text) {
+        return this.cleanEntities(text.replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim());
+    }
+    static cleanEntities(text) {
+        return text
+            .replace(/&nbsp;/g, ' ')
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'")
+            .replace(/&mdash;/g, '—')
+            .replace(/&ndash;/g, '–');
+    }
+}
+//# sourceMappingURL=scraper.js.map

package/dist/core/scraper.js.map

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

package/dist/core/search.d.ts

@@ -0,0 +1,27 @@
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    source: string;
+}
+export declare class WebSearchEngine {
+    private static userAgent;
+    /**
+     * Autonomous Multi-Provider Web Search (Zero API Key required)
+     */
+    static search(query: string, maxResults?: number): Promise<SearchResult[]>;
+    /**
+     * DuckDuckGo HTML Search Scraper (Free, No API Key)
+     */
+    private static searchDuckDuckGo;
+    /**
+     * DuckDuckGo Lite Search (Fast fallback, No API Key)
+     */
+    private static searchDuckDuckGoLite;
+    /**
+     * Public SearXNG Instances (JSON API, No Key)
+     */
+    private static searchSearXNG;
+    private static stripHtml;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/core/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,SAAS,CAC4F;IAEpH;;OAEG;WACiB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkClF;;OAEG;mBACkB,gBAAgB;IA4FrC;;OAEG;mBACkB,oBAAoB;IAoDzC;;OAEG;mBACkB,aAAa;IA+BlC,OAAO,CAAC,MAAM,CAAC,SAAS;CAYzB"}