autoscholar-cli 1.0.0

package/dist/cli/outputsCommand.js

@@ -0,0 +1,191 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listOutputs = listOutputs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const loader_1 = require("../config/loader");
+const banner_1 = require("./banner");
+async function listOutputs() {
+    (0, banner_1.printSection)('Research Outputs');
+    const projectsDir = (0, loader_1.getProjectsDir)();
+    if (!fs.existsSync(projectsDir)) {
+        (0, banner_1.printInfo)('No projects found yet. Run "autoscholar run" to start.');
+        return;
+    }
+    const dirs = fs.readdirSync(projectsDir).filter((d) => {
+        return fs.statSync(path.join(projectsDir, d)).isDirectory();
+    });
+    if (dirs.length === 0) {
+        (0, banner_1.printInfo)('No projects found yet. Run "autoscholar run" to start.');
+        return;
+    }
+    const projects = [];
+    for (const dir of dirs) {
+        const metaPath = path.join(projectsDir, dir, 'meta.json');
+        if (fs.existsSync(metaPath)) {
+            try {
+                const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+                projects.push({
+                    id: dir,
+                    topic: meta.topic || 'Unknown',
+                    status: meta.status || 'unknown',
+                    createdAt: meta.createdAt || 'unknown',
+                    method: meta.method,
+                    pdfPath: meta.pdfPath,
+                    figureCount: meta.figureCount,
+                });
+            }
+            catch {
+                projects.push({
+                    id: dir,
+                    topic: 'Unknown',
+                    status: 'unknown',
+                    createdAt: 'unknown',
+                });
+            }
+        }
+    }
+    projects.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    const table = new cli_table3_1.default({
+        head: [
+            chalk_1.default.cyan('ID'),
+            chalk_1.default.cyan('Topic'),
+            chalk_1.default.cyan('Status'),
+            chalk_1.default.cyan('Method'),
+            chalk_1.default.cyan('Figures'),
+            chalk_1.default.cyan('Date'),
+        ],
+        colWidths: [14, 40, 12, 16, 9, 12],
+        style: { 'padding-left': 1, 'padding-right': 1 },
+    });
+    for (const p of projects) {
+        const statusColor = p.status === 'complete' ? chalk_1.default.green : p.status === 'running' ? chalk_1.default.yellow : chalk_1.default.dim;
+        table.push([
+            chalk_1.default.dim(p.id.substring(0, 12)),
+            p.topic.substring(0, 38),
+            statusColor(p.status),
+            p.method || chalk_1.default.dim('—'),
+            p.figureCount !== undefined ? String(p.figureCount) : chalk_1.default.dim('—'),
+            p.createdAt.substring(0, 10),
+        ]);
+    }
+    console.log(table.toString());
+    console.log();
+    if (projects.length > 0) {
+        const { action } = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'Actions:',
+                choices: [
+                    { name: 'View project details', value: 'view' },
+                    { name: 'Open PDF', value: 'pdf' },
+                    { name: 'Back', value: 'back' },
+                ],
+            },
+        ]);
+        if (action === 'view' || action === 'pdf') {
+            const { projectId } = await inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'projectId',
+                    message: 'Select project:',
+                    choices: projects.map((p) => ({
+                        name: `${p.id.substring(0, 8)} — ${p.topic.substring(0, 50)}`,
+                        value: p.id,
+                    })),
+                },
+            ]);
+            if (action === 'view') {
+                viewProject(projectId);
+            }
+            else {
+                openPdf(projectId);
+            }
+        }
+    }
+}
+function viewProject(projectId) {
+    const projectDir = path.join((0, loader_1.getProjectsDir)(), projectId);
+    (0, banner_1.printSection)(`Project: ${projectId}`);
+    const showDir = (dir, indent = '  ') => {
+        if (!fs.existsSync(dir))
+            return;
+        const items = fs.readdirSync(dir);
+        for (const item of items) {
+            const fullPath = path.join(dir, item);
+            const stat = fs.statSync(fullPath);
+            if (stat.isDirectory()) {
+                console.log(chalk_1.default.cyan(`${indent}📁 ${item}/`));
+                showDir(fullPath, indent + '  ');
+            }
+            else {
+                const size = (stat.size / 1024).toFixed(1);
+                console.log(chalk_1.default.dim(`${indent}📄 ${item} (${size} KB)`));
+            }
+        }
+    };
+    showDir(projectDir);
+    console.log();
+}
+function openPdf(projectId) {
+    const projectDir = path.join((0, loader_1.getProjectsDir)(), projectId);
+    const outputDir = path.join(projectDir, 'output');
+    if (!fs.existsSync(outputDir)) {
+        (0, banner_1.printWarning)('No output directory found');
+        return;
+    }
+    const pdfs = fs.readdirSync(outputDir).filter((f) => f.endsWith('.pdf'));
+    if (pdfs.length === 0) {
+        (0, banner_1.printWarning)('No PDF files found');
+        return;
+    }
+    const pdfPath = path.join(outputDir, pdfs[0]);
+    (0, banner_1.printInfo)(`Opening: ${pdfPath}`);
+    const { execSync } = require('child_process');
+    try {
+        execSync(`open "${pdfPath}"`);
+    }
+    catch {
+        (0, banner_1.printInfo)(`PDF path: ${pdfPath}`);
+    }
+}

package/dist/cli/resumeCommand.js

@@ -0,0 +1,78 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resumeProject = resumeProject;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const loader_1 = require("../config/loader");
+const runCommand_1 = require("./runCommand");
+const banner_1 = require("./banner");
+async function resumeProject(projectId, config) {
+    (0, banner_1.printSection)(`Resuming Project: ${projectId}`);
+    const projectDir = path.join((0, loader_1.getProjectsDir)(), projectId);
+    if (!fs.existsSync(projectDir)) {
+        (0, banner_1.printError)(`Project not found: ${projectId}`);
+        (0, banner_1.printInfo)('Run "autoscholar outputs" to see available projects.');
+        return;
+    }
+    const metaPath = path.join(projectDir, 'meta.json');
+    if (!fs.existsSync(metaPath)) {
+        (0, banner_1.printError)('Project metadata not found');
+        return;
+    }
+    const meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+    if (meta.status === 'complete') {
+        (0, banner_1.printInfo)('This project is already complete.');
+        (0, banner_1.printInfo)(`PDF: ${path.join(projectDir, 'output', 'paper.pdf')}`);
+        return;
+    }
+    console.log(chalk_1.default.dim(`  Topic: ${meta.topic}`));
+    console.log(chalk_1.default.dim(`  Status: ${meta.status}`));
+    console.log(chalk_1.default.dim(`  Last stage: ${meta.lastStage || 'unknown'}`));
+    console.log();
+    const opts = {
+        topic: meta.topic,
+        assets: meta.assets,
+        method: meta.method,
+        hf: meta.highFrequency,
+        resumeFrom: meta.lastStage,
+        projectId: projectId,
+    };
+    await (0, runCommand_1.runPipeline)(opts, config);
+}

package/dist/cli/runCommand.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPipeline = runPipeline;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const project_1 = require("../utils/project");
+const logger_1 = require("../utils/logger");
+const euler_1 = require("../agents/euler");
+const runner_1 = require("../python/runner");
+const banner_1 = require("./banner");
+async function runPipeline(opts, config) {
+    if (!opts.topic) {
+        (0, banner_1.printError)('No topic specified. Use --topic or interactive mode.');
+        return;
+    }
+    (0, banner_1.printSection)('Pre-flight Checks');
+    console.log();
+    const spinner = (0, ora_1.default)({
+        text: chalk_1.default.hex('#94A3B8')('Checking Python environment...'),
+        indent: 2,
+        spinner: 'dots12',
+        color: 'cyan',
+    }).start();
+    const pyCheck = await (0, runner_1.checkPythonDeps)();
+    spinner.stop();
+    if (!pyCheck.available) {
+        (0, banner_1.printError)('Missing required Python packages:');
+        for (const pkg of pyCheck.missing) {
+            console.log(chalk_1.default.hex('#EF4444')(`      \u2022 ${pkg}`));
+        }
+        console.log();
+        (0, banner_1.printInfo)(`Install with: ${chalk_1.default.white.bold(`pip3 install ${pyCheck.missing.join(' ')}`)}`);
+        return;
+    }
+    (0, banner_1.printSuccess)(`Python ${chalk_1.default.hex('#94A3B8')(`(${pyCheck.python})`)} \u2014 ${pyCheck.installed.length} packages ready`);
+    (0, banner_1.printSuccess)(`API keys \u2014 ${countActiveKeys(config)} configured`);
+    console.log();
+    const { meta, dir } = opts.projectId
+        ? { meta: { id: opts.projectId, topic: opts.topic }, dir: '' }
+        : (0, project_1.createProject)(opts.topic, opts.assets, opts.method, opts.hf);
+    const projectId = meta.id;
+    const logger = new logger_1.Logger(dir || require('path').join(require('os').homedir(), '.autoscholar', 'projects', projectId));
+    (0, banner_1.printKV)('Project', projectId);
+    (0, banner_1.printKV)('Output', `~/.autoscholar/projects/${projectId}/`);
+    console.log();
+    logger.info(`Starting pipeline for: ${opts.topic}`);
+    logger.info(`Options: ${JSON.stringify(opts)}`);
+    try {
+        const result = await (0, euler_1.runEulerPipeline)(opts.topic, projectId, config, logger, {
+            assets: opts.assets,
+            method: opts.method,
+            hf: opts.hf,
+            dryRun: opts.dry,
+            resumeFrom: opts.resumeFrom,
+        });
+        if (result.success) {
+            const summaryLines = [
+                chalk_1.default.hex('#22C55E').bold(`\u2714 Paper generated successfully`),
+                '',
+                `${chalk_1.default.hex('#94A3B8')('Title')}    ${chalk_1.default.white(result.title || opts.topic)}`,
+                result.pdfPath ? `${chalk_1.default.hex('#94A3B8')('PDF')}      ${chalk_1.default.white(result.pdfPath)}` : '',
+                `${chalk_1.default.hex('#94A3B8')('Figures')}  ${chalk_1.default.white(String(result.figureCount))}`,
+                result.pageCount ? `${chalk_1.default.hex('#94A3B8')('Pages')}    ${chalk_1.default.white(String(result.pageCount))}` : '',
+                `${chalk_1.default.hex('#94A3B8')('Project')}  ${chalk_1.default.hex('#60A5FA')(`~/.autoscholar/projects/${projectId}/`)}`,
+            ].filter(Boolean);
+            (0, banner_1.printSummaryBox)(summaryLines, true);
+        }
+        else {
+            const summaryLines = [
+                chalk_1.default.hex('#F59E0B').bold(`\u26A0 Pipeline completed with issues`),
+                '',
+                `${chalk_1.default.hex('#94A3B8')('Logs')}  ${chalk_1.default.hex('#60A5FA')(`~/.autoscholar/projects/${projectId}/logs/`)}`,
+            ];
+            (0, banner_1.printSummaryBox)(summaryLines, false);
+        }
+    }
+    catch (err) {
+        (0, banner_1.printError)(`Pipeline error: ${err.message}`);
+        logger.error(`Fatal: ${err.message}`);
+        (0, project_1.updateProject)(projectId, { status: 'failed' });
+    }
+    finally {
+        logger.close();
+    }
+}
+function countActiveKeys(config) {
+    return Object.values(config).filter((v) => v && String(v).length > 0).length;
+}

package/dist/config/loader.js

@@ -0,0 +1,154 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigDir = getConfigDir;
+exports.getEnvPath = getEnvPath;
+exports.getProjectsDir = getProjectsDir;
+exports.ensureDirectories = ensureDirectories;
+exports.envExists = envExists;
+exports.loadConfig = loadConfig;
+exports.validateConfig = validateConfig;
+exports.ensureConfig = ensureConfig;
+exports.saveEnvFile = saveEnvFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const dotenv = __importStar(require("dotenv"));
+const chalk_1 = __importDefault(require("chalk"));
+const setup_1 = require("./setup");
+const banner_1 = require("../cli/banner");
+const CONFIG_DIR = path.join(os.homedir(), '.autoscholar');
+const ENV_PATH = path.join(CONFIG_DIR, '.env');
+const PROJECTS_DIR = path.join(CONFIG_DIR, 'projects');
+function getConfigDir() {
+    return CONFIG_DIR;
+}
+function getEnvPath() {
+    return ENV_PATH;
+}
+function getProjectsDir() {
+    return PROJECTS_DIR;
+}
+function ensureDirectories() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    if (!fs.existsSync(PROJECTS_DIR)) {
+        fs.mkdirSync(PROJECTS_DIR, { recursive: true });
+    }
+}
+function envExists() {
+    return fs.existsSync(ENV_PATH);
+}
+function loadConfig() {
+    if (!envExists())
+        return null;
+    dotenv.config({ path: ENV_PATH });
+    const config = {
+        ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY || '',
+        OPENAI_API_KEY: process.env.OPENAI_API_KEY || '',
+        FMP_API_KEY: process.env.FMP_API_KEY || '',
+        EODHD_API_KEY: process.env.EODHD_API_KEY || '',
+        FRED_API_KEY: process.env.FRED_API_KEY || '',
+        SERPER_API_KEY: process.env.SERPER_API_KEY || '',
+        SERPAPI_API_KEY: process.env.SERPAPI_API_KEY || '',
+        FIRECRAWL_API_KEY: process.env.FIRECRAWL_API_KEY || '',
+        TAVILY_API_KEY: process.env.TAVILY_API_KEY || '',
+        EXA_API_KEY: process.env.EXA_API_KEY || '',
+    };
+    return config;
+}
+function validateConfig(config) {
+    const errors = [];
+    const warnings = [];
+    if (!config.ANTHROPIC_API_KEY) {
+        errors.push('ANTHROPIC_API_KEY is required (powers the AI agents)');
+    }
+    if (!config.FMP_API_KEY) {
+        warnings.push('FMP_API_KEY not set — financial data collection will be limited');
+    }
+    if (!config.EODHD_API_KEY) {
+        warnings.push('EODHD_API_KEY not set — historical price data will be limited');
+    }
+    if (!config.FRED_API_KEY) {
+        warnings.push('FRED_API_KEY not set — macroeconomic data will be limited');
+    }
+    if (!config.SERPER_API_KEY && !config.SERPAPI_API_KEY) {
+        warnings.push('No search API key set — web research will be limited');
+    }
+    if (!config.FIRECRAWL_API_KEY) {
+        warnings.push('FIRECRAWL_API_KEY not set — web scraping will be unavailable');
+    }
+    return { valid: errors.length === 0, warnings, errors };
+}
+async function ensureConfig() {
+    ensureDirectories();
+    if (!envExists()) {
+        console.log(chalk_1.default.yellow('  No configuration found. Starting setup wizard...\n'));
+        const config = await (0, setup_1.runSetupWizard)();
+        if (!config) {
+            (0, banner_1.printError)('Setup cancelled. Run "autoscholar config" to configure later.');
+            return null;
+        }
+        return config;
+    }
+    const config = loadConfig();
+    if (!config) {
+        (0, banner_1.printError)('Failed to load configuration.');
+        return null;
+    }
+    const validation = validateConfig(config);
+    if (!validation.valid) {
+        for (const err of validation.errors) {
+            (0, banner_1.printError)(err);
+        }
+        console.log(chalk_1.default.dim('\n  Run "autoscholar config" to fix configuration.\n'));
+        return null;
+    }
+    for (const warn of validation.warnings) {
+        (0, banner_1.printWarning)(warn);
+    }
+    return config;
+}
+function saveEnvFile(config) {
+    ensureDirectories();
+    const lines = Object.entries(config)
+        .filter(([_, v]) => v && v.trim().length > 0)
+        .map(([k, v]) => `${k}=${v}`);
+    fs.writeFileSync(ENV_PATH, lines.join('\n') + '\n', 'utf-8');
+}

package/dist/config/setup.js

@@ -0,0 +1,179 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSetupWizard = runSetupWizard;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const axios_1 = __importDefault(require("axios"));
+const loader_1 = require("./loader");
+const banner_1 = require("../cli/banner");
+const API_KEYS = [
+    {
+        name: 'Anthropic API Key',
+        envKey: 'ANTHROPIC_API_KEY',
+        description: 'Powers all AI agents (Euler, Gauss, Turing, Newton, Fisher)',
+        required: true,
+    },
+    {
+        name: 'OpenAI API Key',
+        envKey: 'OPENAI_API_KEY',
+        description: 'Optional fallback LLM provider',
+        required: false,
+    },
+    {
+        name: 'FMP API Key',
+        envKey: 'FMP_API_KEY',
+        description: 'Financial Modeling Prep — company fundamentals, market data, SEC filings',
+        required: false,
+        testUrl: (key) => `https://financialmodelingprep.com/stable/profile?symbol=AAPL&apikey=${key}`,
+    },
+    {
+        name: 'EODHD API Key',
+        envKey: 'EODHD_API_KEY',
+        description: 'Historical prices, intraday data, options chains with Greeks',
+        required: false,
+        testUrl: (key) => `https://eodhd.com/api/eod/AAPL.US?api_token=${key}&fmt=json&limit=1`,
+    },
+    {
+        name: 'FRED API Key',
+        envKey: 'FRED_API_KEY',
+        description: 'Federal Reserve Economic Data — 840,000+ macroeconomic series',
+        required: false,
+        testUrl: (key) => `https://api.stlouisfed.org/fred/series?series_id=GDP&api_key=${key}&file_type=json`,
+    },
+    {
+        name: 'Serper API Key',
+        envKey: 'SERPER_API_KEY',
+        description: 'Google Search API for web research',
+        required: false,
+    },
+    {
+        name: 'SerpAPI Key',
+        envKey: 'SERPAPI_API_KEY',
+        description: 'Google Scholar search for academic papers',
+        required: false,
+    },
+    {
+        name: 'Firecrawl API Key',
+        envKey: 'FIRECRAWL_API_KEY',
+        description: 'Web scraping and data extraction',
+        required: false,
+    },
+    {
+        name: 'Tavily API Key',
+        envKey: 'TAVILY_API_KEY',
+        description: 'AI-powered web search with generated answers',
+        required: false,
+    },
+    {
+        name: 'Exa API Key',
+        envKey: 'EXA_API_KEY',
+        description: 'Semantic neural search for research discovery',
+        required: false,
+    },
+];
+async function runSetupWizard() {
+    (0, banner_1.printSection)('AutoScholar Setup Wizard');
+    console.log(chalk_1.default.gray('  Configure your API keys to enable data collection and analysis.\n'));
+    console.log(chalk_1.default.gray('  Required keys are marked with *. Press Enter to skip optional keys.\n'));
+    const envValues = {};
+    for (const key of API_KEYS) {
+        const label = key.required
+            ? chalk_1.default.bold.white(`  ${key.name}`) + chalk_1.default.red(' *')
+            : chalk_1.default.white(`  ${key.name}`);
+        console.log(label);
+        console.log(chalk_1.default.dim(`    ${key.description}`));
+        const { value } = await inquirer_1.default.prompt([
+            {
+                type: 'password',
+                name: 'value',
+                message: `  ${key.envKey}:`,
+                mask: '*',
+                validate: (input) => {
+                    if (key.required && (!input || input.trim().length === 0)) {
+                        return `${key.name} is required`;
+                    }
+                    return true;
+                },
+            },
+        ]);
+        if (value && value.trim().length > 0) {
+            envValues[key.envKey] = value.trim();
+        }
+        console.log();
+    }
+    (0, banner_1.printSection)('Validating API Keys');
+    const spinner = (0, ora_1.default)({ text: 'Testing connections...', indent: 2 }).start();
+    let allValid = true;
+    const results = [];
+    for (const key of API_KEYS) {
+        const val = envValues[key.envKey];
+        if (!val) {
+            results.push({ name: key.name, status: 'skip' });
+            continue;
+        }
+        if (key.testUrl) {
+            try {
+                spinner.text = `Testing ${key.name}...`;
+                const resp = await axios_1.default.get(key.testUrl(val), { timeout: 10000 });
+                if (resp.status === 200) {
+                    results.push({ name: key.name, status: 'ok' });
+                }
+                else {
+                    results.push({ name: key.name, status: 'fail' });
+                    allValid = false;
+                }
+            }
+            catch {
+                results.push({ name: key.name, status: 'fail' });
+                allValid = false;
+            }
+        }
+        else {
+            results.push({ name: key.name, status: 'ok' });
+        }
+    }
+    spinner.stop();
+    for (const r of results) {
+        if (r.status === 'ok') {
+            (0, banner_1.printSuccess)(`${r.name} — connected`);
+        }
+        else if (r.status === 'skip') {
+            console.log(chalk_1.default.dim(`  ○ ${r.name} — skipped`));
+        }
+        else {
+            (0, banner_1.printError)(`${r.name} — invalid key`);
+        }
+    }
+    if (!allValid) {
+        console.log();
+        (0, banner_1.printWarning)('Some keys failed validation. They will still be saved.');
+    }
+    (0, loader_1.saveEnvFile)(envValues);
+    console.log();
+    (0, banner_1.printSuccess)('AutoScholar CLI successfully configured');
+    console.log(chalk_1.default.dim(`  Config saved to ~/.autoscholar/.env\n`));
+    const config = {
+        ANTHROPIC_API_KEY: envValues.ANTHROPIC_API_KEY || '',
+        OPENAI_API_KEY: envValues.OPENAI_API_KEY,
+        FMP_API_KEY: envValues.FMP_API_KEY,
+        EODHD_API_KEY: envValues.EODHD_API_KEY,
+        FRED_API_KEY: envValues.FRED_API_KEY,
+        SERPER_API_KEY: envValues.SERPER_API_KEY,
+        SERPAPI_API_KEY: envValues.SERPAPI_API_KEY,
+        FIRECRAWL_API_KEY: envValues.FIRECRAWL_API_KEY,
+        TAVILY_API_KEY: envValues.TAVILY_API_KEY,
+        EXA_API_KEY: envValues.EXA_API_KEY,
+    };
+    const validation = (0, loader_1.validateConfig)(config);
+    if (!validation.valid) {
+        for (const err of validation.errors) {
+            (0, banner_1.printError)(err);
+        }
+        return null;
+    }
+    return config;
+}