antri_cli 1.26.0

package/dist/core/agent.js

@@ -0,0 +1,232 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { createProvider } from '../providers/index.js';
+import { ConversationHistory } from './history.js';
+import { getAllActiveTools, ToolExecutor } from './tools.js';
+import { TerminalRenderer } from '../cli/renderer.js';
+import { FilePickerService } from '../cli/dialogs/filePicker.js';
+import { CitationEngine } from './citations.js';
+import { memoryManager } from '../memory/manager.js';
+import { profileManager } from '../profiles/profileManager.js';
+import { SelfDebugger } from './debugger.js';
+import { metaOptimizer } from './metaOptimizer.js';
+import { log } from '../utils/logger.js';
+export class AntriAgent {
+    config;
+    history;
+    toolExecutor;
+    citationEngine;
+    constructor(config, history) {
+        this.config = config;
+        this.history = history || new ConversationHistory();
+        this.toolExecutor = new ToolExecutor(config.workingDir);
+        this.citationEngine = new CitationEngine();
+    }
+    getHistory() {
+        return this.history;
+    }
+    updateConfig(newConfig) {
+        this.config = newConfig;
+        this.toolExecutor = new ToolExecutor(newConfig.workingDir);
+    }
+    buildSystemPrompt(recalledMemoryContext = '') {
+        const activeProfileName = profileManager.getActiveProfileName();
+        const activeProfileContent = profileManager.getActiveProfileContent();
+        const mode = this.config.mode || 'vibe';
+        let modeDirective = '';
+        if (mode === 'plan') {
+            modeDirective = `
+⚡ ACTIVE OPERATING MODE: PLAN MODE
+- You are in PLAN MODE. Your primary goal is to collaborate with the user on high-level architecture, design specifications, and step-by-step implementation blueprints BEFORE writing code.
+- Propose structured phased roadmaps (Phase 1, Phase 2, etc.) and list necessary file additions/modifications.
+- Ask sharp clarifying questions regarding trade-offs, tech choices, or edge cases.
+- Do NOT prematurely modify codebase files or execute destructive actions without presenting the plan first and getting user alignment.`;
+        }
+        else {
+            modeDirective = `
+⚡ ACTIVE OPERATING MODE: VIBE MODE
+- You are in VIBE MODE. You directly chat with the user and immediately implement features, write code, run commands, and execute tools in continuous flow.
+- Deliver working, high-quality, production-ready code with maximum speed and precision.`;
+        }
+        const basePrompt = `You are ANTRI Code, an intelligent, terminal-first AI coding companion, proactive facilitator, and autonomous meta-agent.
+
+Core Behavioral Principles:
+1. Lead the Way & Guide Step-by-Step: Don't just give passive answers. Proactively lead the way, lay out step-by-step execution roadmaps, and propose the next logical milestones.
+2. Ask Clarifying Questions: Whenever a requirement is underspecified, has multiple architectural paths, or involves technical trade-offs, ask concise, targeted clarifying questions to ensure perfect alignment with the user's vision.
+3. Adaptive Note-Taking & Feedback Capture: Pay close attention to user feedback, preferred conventions, and mental models. Continuously adapt your explanations and code to their unique thinking style.
+${modeDirective}
+
+Tooling & Workspace Capabilities:
+1. Workspace Tools: read_file, write_file, list_dir, search_files, run_command.
+2. Sandboxed Runtime: execute_python (run safe isolated Python code scripts).
+3. Skill Synthesis: synthesize_skill (create, test, and register new permanent Python tools to ~/.agent-cli/skills/).
+4. Web & Research Tools: web_search (multi-provider search without API key), scrape_url (deep readable content extraction into Markdown), and crawl_docs (recursive documentation crawler).
+5. Persistent Lifelong Memory & Multi-Profile Thinking: Adhere strictly to the active profile markdown context and project conventions.
+
+Autonomous Guidelines:
+- If a user asks for complex calculation, data analysis, or scripting, use 'execute_python'.
+- If a user asks to create a reusable tool or skill, use 'synthesize_skill'.
+- If a user asks for external information, documentation, or libraries, autonomously call 'web_search', 'scrape_url', or 'crawl_docs'.
+- If a user attaches a file ([Attached File: ...]), examine the provided content directly.
+- Cite sources clearly when using web research.
+- Write clean, production-grade, typed code.`;
+        const profileSection = activeProfileContent
+            ? `\n\n--- Active Thinking Profile [${activeProfileName}] ---\n${activeProfileContent}\n---------------------------------------------`
+            : '';
+        const context = `\n\nWorkspace context:
+- Current Working Directory: ${this.config.workingDir}
+- Active Model: ${this.config.model}
+- Active Mode: ${mode.toUpperCase()}
+- Active Profile: ${activeProfileName}${profileSection}${recalledMemoryContext}`;
+        return basePrompt + context;
+    }
+    async chat(userPrompt) {
+        const startTime = Date.now();
+        this.citationEngine.clear();
+        // 1. Capture feedback / note into active profile
+        const activeProfileName = profileManager.getActiveProfileName();
+        const notedInsight = profileManager.extractAndRecordNotes(userPrompt);
+        if (notedInsight) {
+            console.log(chalk.hex('#38bdf8')(`📝 Noted in profile [${activeProfileName}]: "${notedInsight}"`));
+        }
+        // 2. Autonomous Self-Recall into Persistent Memory Hierarchy
+        const geminiKey = this.config.apiKeys.gemini || process.env.GEMINI_API_KEY;
+        const { contextText, recalled } = await memoryManager.selfRecall(userPrompt, this.config.workingDir, geminiKey);
+        if (recalled.hasMemories && (recalled.semanticInsights.length > 0 || recalled.workspaceConventions.length > 0)) {
+            const matchCount = recalled.semanticInsights.length + recalled.workspaceConventions.length;
+            console.log(chalk.hex('#818cf8')(`🧠 Recalled ${matchCount} relevant memory item(s) from persistent store`));
+        }
+        // 3. Resolve any @file attachments in userPrompt
+        const { enhancedPrompt, attachedFiles } = FilePickerService.extractAndReadAttachments(userPrompt, this.config.workingDir);
+        if (attachedFiles.length > 0) {
+            console.log(chalk.hex('#64748b')(`📎 Attached file(s): ${attachedFiles.map((f) => chalk.cyan(f)).join(', ')}`));
+        }
+        // 4. Add user message to history
+        this.history.addMessage({
+            role: 'user',
+            content: enhancedPrompt,
+        });
+        const response = await this.runAgentLoop(0, contextText);
+        // 5. Record interaction into persistent episodic memory & meta-optimizer
+        memoryManager.recordInteraction(userPrompt, response);
+        const duration = Date.now() - startTime;
+        metaOptimizer.recordQuerySuccess(duration);
+        const elapsed = Math.max(0.1, duration / 1000).toFixed(0);
+        const modeTag = (this.config.mode || 'vibe').toUpperCase();
+        console.log(chalk.hex('#64748b')(`* Worked for ${elapsed}s · Mode: ${modeTag} · Profile: ${activeProfileName}`));
+        console.log();
+        return response;
+    }
+    async runAgentLoop(depth = 0, memoryContext = '') {
+        if (depth > 6) {
+            log.warn('Max agent tool iteration depth reached.');
+            return '';
+        }
+        const provider = createProvider(this.config);
+        const systemPrompt = this.buildSystemPrompt(memoryContext);
+        const messagesWithSystem = [
+            { role: 'system', content: systemPrompt },
+            ...this.history.getMessages(),
+        ];
+        const modeLabel = this.config.mode === 'plan' ? 'Planning & Designing Roadmap...' : 'Thinking & Writing Code...';
+        let spinner = ora({
+            text: chalk.hex('#a5b4fc')(modeLabel),
+            spinner: 'dots',
+            color: 'cyan',
+        }).start();
+        let hasStreamedTokens = false;
+        let fullResponse = '';
+        const pendingToolCalls = [];
+        try {
+            const activeTools = this.config.autoExecuteTools ? getAllActiveTools() : [];
+            fullResponse = await provider.sendMessageStream(messagesWithSystem, activeTools, {
+                onToken: (token) => {
+                    if (spinner) {
+                        spinner.stop();
+                        spinner = null;
+                    }
+                    if (!hasStreamedTokens) {
+                        hasStreamedTokens = true;
+                    }
+                    TerminalRenderer.printToken(token);
+                },
+                onToolCall: (toolCall) => {
+                    if (spinner) {
+                        spinner.stop();
+                        spinner = null;
+                    }
+                    pendingToolCalls.push(toolCall);
+                },
+            });
+            if (spinner) {
+                spinner.stop();
+                spinner = null;
+            }
+            if (hasStreamedTokens) {
+                console.log(); // Newline after stream
+                console.log();
+            }
+            // Record assistant message
+            this.history.addMessage({
+                role: 'assistant',
+                content: fullResponse,
+                tool_calls: pendingToolCalls.length > 0 ? pendingToolCalls : undefined,
+            });
+            // If LLM produced tool calls, execute them and continue loop
+            if (pendingToolCalls.length > 0) {
+                for (const tc of pendingToolCalls) {
+                    let parsedArgs = {};
+                    try {
+                        parsedArgs = JSON.parse(tc.function.arguments || '{}');
+                    }
+                    catch {
+                        parsedArgs = {};
+                    }
+                    const toolStart = Date.now();
+                    let result = await this.toolExecutor.execute(tc.function.name, parsedArgs, tc.id);
+                    // Autonomous Self-Debugging Loop on tool failure
+                    if (result.error) {
+                        metaOptimizer.recordToolExecution(tc.function.name, Date.now() - toolStart, true);
+                        const repair = await SelfDebugger.autoDebugAndRepair(tc, result, this.config, (n, a, id) => this.toolExecutor.execute(n, a, id));
+                        if (repair.repaired && repair.repairedResult) {
+                            result = repair.repairedResult;
+                            metaOptimizer.recordSelfHealing();
+                        }
+                    }
+                    else {
+                        metaOptimizer.recordToolExecution(tc.function.name, Date.now() - toolStart, false);
+                    }
+                    // Track citations if web search or scrape
+                    if (tc.function.name === 'web_search' && parsedArgs.query) {
+                        this.citationEngine.addSource(`Web Search: ${parsedArgs.query}`, `https://duckduckgo.com/?q=${encodeURIComponent(parsedArgs.query)}`, undefined, 'DuckDuckGo');
+                    }
+                    else if (tc.function.name === 'scrape_url' && parsedArgs.url) {
+                        this.citationEngine.addSource(`Scraped URL`, parsedArgs.url, undefined, 'Web Reader');
+                    }
+                    else if (tc.function.name === 'crawl_docs' && parsedArgs.url) {
+                        this.citationEngine.addSource(`Documentation Root`, parsedArgs.url, undefined, 'Doc Crawler');
+                    }
+                    // Output compact single-line tool usage
+                    TerminalRenderer.printToolCompact(tc, result);
+                    this.history.addMessage({
+                        role: 'tool',
+                        name: tc.function.name,
+                        tool_call_id: tc.id,
+                        content: result.output,
+                    });
+                }
+                // Loop back to let assistant interpret tool results
+                return await this.runAgentLoop(depth + 1, memoryContext);
+            }
+            return fullResponse;
+        }
+        catch (err) {
+            if (spinner) {
+                spinner.stop();
+            }
+            log.error(`Request failed: ${err.message}`);
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/core/agent.js.map

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

package/dist/core/citations.d.ts

@@ -0,0 +1,19 @@
+export interface CitationSource {
+    id: number;
+    title: string;
+    url: string;
+    snippet?: string;
+    provider?: string;
+}
+export declare class CitationEngine {
+    private sources;
+    private nextId;
+    addSource(title: string, url: string, snippet?: string, provider?: string): CitationSource;
+    getSources(): CitationSource[];
+    clear(): void;
+    /**
+     * Generates a markdown bibliography block
+     */
+    generateBibliography(): string;
+}
+//# sourceMappingURL=citations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citations.d.ts","sourceRoot":"","sources":["../../src/core/citations.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,MAAM,CAAK;IAEZ,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc;IAe1F,UAAU,IAAI,cAAc,EAAE;IAI9B,KAAK,IAAI,IAAI;IAKpB;;OAEG;IACI,oBAAoB,IAAI,MAAM;CAWtC"}

package/dist/core/citations.js

@@ -0,0 +1,40 @@
+export class CitationEngine {
+    sources = new Map();
+    nextId = 1;
+    addSource(title, url, snippet, provider) {
+        if (this.sources.has(url)) {
+            return this.sources.get(url);
+        }
+        const source = {
+            id: this.nextId++,
+            title: title || url,
+            url,
+            snippet,
+            provider,
+        };
+        this.sources.set(url, source);
+        return source;
+    }
+    getSources() {
+        return Array.from(this.sources.values());
+    }
+    clear() {
+        this.sources.clear();
+        this.nextId = 1;
+    }
+    /**
+     * Generates a markdown bibliography block
+     */
+    generateBibliography() {
+        const list = this.getSources();
+        if (list.length === 0)
+            return '';
+        let md = '\n\n### 📚 Sources & Citations\n';
+        for (const s of list) {
+            const prov = s.provider ? ` *(${s.provider})*` : '';
+            md += `- [^${s.id}] [${s.title}](${s.url})${prov}\n`;
+        }
+        return md;
+    }
+}
+//# sourceMappingURL=citations.js.map

package/dist/core/citations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citations.js","sourceRoot":"","sources":["../../src/core/citations.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,cAAc;IACjB,OAAO,GAAgC,IAAI,GAAG,EAAE,CAAC;IACjD,MAAM,GAAG,CAAC,CAAC;IAEZ,SAAS,CAAC,KAAa,EAAE,GAAW,EAAE,OAAgB,EAAE,QAAiB;QAC9E,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAChC,CAAC;QACD,MAAM,MAAM,GAAmB;YAC7B,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;YACjB,KAAK,EAAE,KAAK,IAAI,GAAG;YACnB,GAAG;YACH,OAAO;YACP,QAAQ;SACT,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,UAAU;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,oBAAoB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEjC,IAAI,EAAE,GAAG,kCAAkC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,EAAE,IAAI,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/core/config.d.ts

@@ -0,0 +1,16 @@
+import { AntriConfig, ProviderType, AgentMode } from '../types.js';
+export declare class ConfigManager {
+    private config;
+    constructor();
+    private loadConfig;
+    get(): AntriConfig;
+    set<K extends keyof AntriConfig>(key: K, value: AntriConfig[K]): void;
+    setMode(mode: AgentMode): void;
+    setAlwaysAllow(allow: boolean): void;
+    setApiKey(provider: string, key: string): void;
+    setBaseUrl(provider: string, url: string): void;
+    setProvider(provider: ProviderType, defaultModel?: string): void;
+    saveGlobalConfig(): void;
+}
+export declare const configManager: ConfigManager;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAe,SAAS,EAAE,MAAM,aAAa,CAAC;AAoChF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAc;;IAM5B,OAAO,CAAC,UAAU;IAkDX,GAAG,IAAI,WAAW;IAIlB,GAAG,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAKrE,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAK9B,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKpC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAM9C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAS/C,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAsChE,gBAAgB,IAAI,IAAI;CAUhC;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/config.js

@@ -0,0 +1,172 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import dotenv from 'dotenv';
+// Load .env if present
+dotenv.config();
+const DEFAULT_CONFIG = {
+    provider: 'deepseek',
+    model: 'deepseek-v4-flash-(latest)',
+    version: '1.26.0',
+    mode: 'vibe',
+    alwaysAllow: false,
+    apiKeys: {
+        deepseek: process.env.DEEPSEEK_API_KEY || process.env.ANTRI_API_KEY,
+        openai: process.env.OPENAI_API_KEY,
+        gemini: process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY,
+        anthropic: process.env.ANTHROPIC_API_KEY,
+        nvidia_nim: process.env.NVIDIA_API_KEY || process.env.NVIDIA_NIM_API_KEY,
+        openrouter: process.env.OPENROUTER_API_KEY,
+        custom: process.env.CUSTOM_API_KEY,
+    },
+    customBaseUrls: {
+        deepseek: process.env.DEEPSEEK_BASE_URL || 'https://api.deepseek.com/v1',
+        openai: process.env.OPENAI_BASE_URL || 'https://api.openai.com/v1',
+        ollama: process.env.OLLAMA_BASE_URL || 'http://localhost:11434',
+        nvidia_nim: process.env.NVIDIA_BASE_URL || 'https://integrate.api.nvidia.com/v1',
+        custom: process.env.CUSTOM_BASE_URL || 'http://localhost:8000/v1',
+    },
+    workingDir: process.cwd(),
+    autoExecuteTools: true,
+    debateDepth: 'deep',
+};
+const GLOBAL_CONFIG_DIR = path.join(os.homedir(), '.antri');
+const GLOBAL_CONFIG_FILE = path.join(GLOBAL_CONFIG_DIR, 'config.json');
+const LOCAL_CONFIG_FILE = path.join(process.cwd(), '.antrirc.json');
+export class ConfigManager {
+    config;
+    constructor() {
+        this.config = this.loadConfig();
+    }
+    loadConfig() {
+        let merged = { ...DEFAULT_CONFIG };
+        // 1. Try to load global ~/.antri/config.json
+        if (fs.existsSync(GLOBAL_CONFIG_FILE)) {
+            try {
+                const raw = fs.readFileSync(GLOBAL_CONFIG_FILE, 'utf-8');
+                const parsed = JSON.parse(raw);
+                merged = { ...merged, ...parsed };
+            }
+            catch {
+                // Ignore read errors
+            }
+        }
+        // 2. Try to load local ./.antrirc.json
+        if (fs.existsSync(LOCAL_CONFIG_FILE)) {
+            try {
+                const raw = fs.readFileSync(LOCAL_CONFIG_FILE, 'utf-8');
+                const parsed = JSON.parse(raw);
+                merged = { ...merged, ...parsed };
+            }
+            catch {
+                // Ignore read errors
+            }
+        }
+        // Auto-detect provider if default has no key but another does
+        if (!merged.apiKeys.deepseek && !process.env.DEEPSEEK_API_KEY) {
+            if (merged.apiKeys.openai || process.env.OPENAI_API_KEY) {
+                merged.provider = 'openai';
+                merged.model = 'gpt-4o';
+            }
+            else if (merged.apiKeys.gemini || process.env.GEMINI_API_KEY) {
+                merged.provider = 'gemini';
+                merged.model = 'gemini-2.5-flash';
+            }
+            else if (merged.apiKeys.anthropic || process.env.ANTHROPIC_API_KEY) {
+                merged.provider = 'anthropic';
+                merged.model = 'claude-3-7-sonnet-20250219';
+            }
+            else if (merged.apiKeys.nvidia_nim || process.env.NVIDIA_API_KEY) {
+                merged.provider = 'nvidia-nim';
+                merged.model = 'meta/llama-3.1-8b-instruct';
+            }
+            else if (merged.apiKeys.openrouter || process.env.OPENROUTER_API_KEY) {
+                merged.provider = 'openrouter';
+                merged.model = 'anthropic/claude-3.5-sonnet';
+            }
+            else {
+                merged.provider = 'mock';
+            }
+        }
+        return merged;
+    }
+    get() {
+        return this.config;
+    }
+    set(key, value) {
+        this.config[key] = value;
+        this.saveGlobalConfig();
+    }
+    setMode(mode) {
+        this.config.mode = mode;
+        this.saveGlobalConfig();
+    }
+    setAlwaysAllow(allow) {
+        this.config.alwaysAllow = allow;
+        this.saveGlobalConfig();
+    }
+    setApiKey(provider, key) {
+        const formattedProvider = provider.replace('-', '_');
+        this.config.apiKeys[formattedProvider] = key;
+        this.saveGlobalConfig();
+    }
+    setBaseUrl(provider, url) {
+        const formattedProvider = provider.replace('-', '_');
+        if (!this.config.customBaseUrls) {
+            this.config.customBaseUrls = {};
+        }
+        this.config.customBaseUrls[formattedProvider] = url;
+        this.saveGlobalConfig();
+    }
+    setProvider(provider, defaultModel) {
+        this.config.provider = provider;
+        if (defaultModel) {
+            this.config.model = defaultModel;
+        }
+        else {
+            switch (provider) {
+                case 'ollama':
+                    this.config.model = 'llama3.3:70b';
+                    break;
+                case 'anthropic':
+                    this.config.model = 'claude-3-7-sonnet-20250219';
+                    break;
+                case 'nvidia-nim':
+                    this.config.model = 'meta/llama-3.1-8b-instruct';
+                    break;
+                case 'openai':
+                    this.config.model = 'gpt-4o';
+                    break;
+                case 'gemini':
+                    this.config.model = 'gemini-2.5-flash';
+                    break;
+                case 'deepseek':
+                    this.config.model = 'deepseek-v4-flash-(latest)';
+                    break;
+                case 'custom':
+                    this.config.model = 'custom-model';
+                    break;
+                case 'openrouter':
+                    this.config.model = 'deepseek/deepseek-r1';
+                    break;
+                case 'mock':
+                    this.config.model = 'deepseek-v4-flash-(latest)';
+                    break;
+            }
+        }
+        this.saveGlobalConfig();
+    }
+    saveGlobalConfig() {
+        try {
+            if (!fs.existsSync(GLOBAL_CONFIG_DIR)) {
+                fs.mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
+            }
+            fs.writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(this.config, null, 2), 'utf-8');
+        }
+        catch {
+            // Ignore save failures in restricted environments
+        }
+    }
+}
+export const configManager = new ConfigManager();
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/crawler.d.ts

@@ -0,0 +1,18 @@
+export interface CrawlResult {
+    startUrl: string;
+    pagesCrawled: number;
+    combinedMarkdown: string;
+    sources: {
+        title: string;
+        url: string;
+        charCount: number;
+    }[];
+}
+export declare class DocCrawler {
+    /**
+     * Recursively crawls documentation pages starting from a root URL
+     */
+    static crawl(startUrl: string, maxPages?: number, maxDepth?: number): Promise<CrawlResult>;
+    private static normalizeUrl;
+}
+//# sourceMappingURL=crawler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.d.ts","sourceRoot":"","sources":["../../src/core/crawler.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED,qBAAa,UAAU;IACrB;;OAEG;WACiB,KAAK,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAI,EACZ,QAAQ,SAAI,GACX,OAAO,CAAC,WAAW,CAAC;IAuEvB,OAAO,CAAC,MAAM,CAAC,YAAY;CAY5B"}

package/dist/core/crawler.js

@@ -0,0 +1,83 @@
+import { WebScraper } from './scraper.js';
+export class DocCrawler {
+    /**
+     * Recursively crawls documentation pages starting from a root URL
+     */
+    static async crawl(startUrl, maxPages = 4, maxDepth = 2) {
+        const visited = new Set();
+        const queue = [{ url: startUrl, depth: 0 }];
+        const scrapedPages = [];
+        const root = new URL(startUrl);
+        const allowedHost = root.hostname;
+        while (queue.length > 0 && scrapedPages.length < maxPages) {
+            const current = queue.shift();
+            if (!current)
+                break;
+            const normalizedUrl = this.normalizeUrl(current.url);
+            if (visited.has(normalizedUrl))
+                continue;
+            visited.add(normalizedUrl);
+            // Scrape current page
+            const page = await WebScraper.scrape(current.url, 6000);
+            if (page.charCount > 50) {
+                scrapedPages.push(page);
+            }
+            // If within depth limit, find next doc links
+            if (current.depth < maxDepth) {
+                for (const link of page.links) {
+                    try {
+                        const parsed = new URL(link);
+                        // Same domain check
+                        if (parsed.hostname === allowedHost) {
+                            const normLink = this.normalizeUrl(link);
+                            if (!visited.has(normLink)) {
+                                // Prioritize docs, guide, api, tutorial paths
+                                const isDocLike = parsed.pathname.includes('/doc') ||
+                                    parsed.pathname.includes('/guide') ||
+                                    parsed.pathname.includes('/api') ||
+                                    parsed.pathname.includes('/tutorial') ||
+                                    parsed.pathname.includes('/manual') ||
+                                    parsed.pathname.startsWith(root.pathname);
+                                if (isDocLike) {
+                                    queue.push({ url: link, depth: current.depth + 1 });
+                                }
+                            }
+                        }
+                    }
+                    catch { }
+                }
+            }
+        }
+        // Combine markdown documents into a coherent documentation knowledge base
+        let combined = `# 📖 Crawled Documentation (${scrapedPages.length} pages from ${startUrl})\n\n`;
+        const sources = [];
+        for (let i = 0; i < scrapedPages.length; i++) {
+            const p = scrapedPages[i];
+            sources.push({ title: p.title, url: p.url, charCount: p.charCount });
+            combined += `## [Source ${i + 1}] ${p.title}\n`;
+            combined += `**URL:** ${p.url}\n\n`;
+            combined += `${p.markdown}\n\n`;
+            combined += `---\n\n`;
+        }
+        return {
+            startUrl,
+            pagesCrawled: scrapedPages.length,
+            combinedMarkdown: combined,
+            sources,
+        };
+    }
+    static normalizeUrl(url) {
+        try {
+            const u = new URL(url);
+            u.hash = '';
+            if (u.pathname.endsWith('/') && u.pathname.length > 1) {
+                u.pathname = u.pathname.slice(0, -1);
+            }
+            return u.toString();
+        }
+        catch {
+            return url;
+        }
+    }
+}
+//# sourceMappingURL=crawler.js.map

package/dist/core/crawler.js.map

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