autoscholar-cli 1.0.0

package/dist/connectors/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIMFData = exports.searchWorldBank = exports.searchExa = exports.searchTavily = exports.searchSerper = exports.getOpenAlexReferences = exports.multiSourceSearch = exports.searchGoogleScholar = exports.searchCrossRef = exports.searchArxiv = exports.searchOpenAlex = exports.FirecrawlClient = exports.FREDClient = exports.EODHDClient = exports.FMPClient = void 0;
+var fmp_1 = require("./fmp");
+Object.defineProperty(exports, "FMPClient", { enumerable: true, get: function () { return fmp_1.FMPClient; } });
+var eodhd_1 = require("./eodhd");
+Object.defineProperty(exports, "EODHDClient", { enumerable: true, get: function () { return eodhd_1.EODHDClient; } });
+var fred_1 = require("./fred");
+Object.defineProperty(exports, "FREDClient", { enumerable: true, get: function () { return fred_1.FREDClient; } });
+var firecrawl_1 = require("./firecrawl");
+Object.defineProperty(exports, "FirecrawlClient", { enumerable: true, get: function () { return firecrawl_1.FirecrawlClient; } });
+var academic_1 = require("./academic");
+Object.defineProperty(exports, "searchOpenAlex", { enumerable: true, get: function () { return academic_1.searchOpenAlex; } });
+Object.defineProperty(exports, "searchArxiv", { enumerable: true, get: function () { return academic_1.searchArxiv; } });
+Object.defineProperty(exports, "searchCrossRef", { enumerable: true, get: function () { return academic_1.searchCrossRef; } });
+Object.defineProperty(exports, "searchGoogleScholar", { enumerable: true, get: function () { return academic_1.searchGoogleScholar; } });
+Object.defineProperty(exports, "multiSourceSearch", { enumerable: true, get: function () { return academic_1.multiSourceSearch; } });
+Object.defineProperty(exports, "getOpenAlexReferences", { enumerable: true, get: function () { return academic_1.getOpenAlexReferences; } });
+var websearch_1 = require("./websearch");
+Object.defineProperty(exports, "searchSerper", { enumerable: true, get: function () { return websearch_1.searchSerper; } });
+Object.defineProperty(exports, "searchTavily", { enumerable: true, get: function () { return websearch_1.searchTavily; } });
+Object.defineProperty(exports, "searchExa", { enumerable: true, get: function () { return websearch_1.searchExa; } });
+Object.defineProperty(exports, "searchWorldBank", { enumerable: true, get: function () { return websearch_1.searchWorldBank; } });
+Object.defineProperty(exports, "getIMFData", { enumerable: true, get: function () { return websearch_1.getIMFData; } });

package/dist/connectors/websearch.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchSerper = searchSerper;
+exports.searchTavily = searchTavily;
+exports.searchExa = searchExa;
+exports.searchWorldBank = searchWorldBank;
+exports.getIMFData = getIMFData;
+const axios_1 = __importDefault(require("axios"));
+async function searchSerper(query, apiKey, options) {
+    try {
+        const response = await axios_1.default.post('https://google.serper.dev/search', {
+            q: query,
+            num: options?.num || 10,
+            type: options?.type || 'search',
+        }, {
+            headers: {
+                'X-API-KEY': apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 15000,
+        });
+        return (response.data.organic || []).map((r) => ({
+            title: r.title || '',
+            url: r.link || '',
+            snippet: r.snippet || '',
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+async function searchTavily(query, apiKey, options) {
+    try {
+        const response = await axios_1.default.post('https://api.tavily.com/search', {
+            query,
+            max_results: options?.maxResults || 10,
+            search_depth: options?.searchDepth || 'basic',
+            include_answer: options?.includeAnswer ?? true,
+            api_key: apiKey,
+        }, { timeout: 20000 });
+        return {
+            answer: response.data.answer,
+            results: (response.data.results || []).map((r) => ({
+                title: r.title || '',
+                url: r.url || '',
+                content: r.content || '',
+                score: r.score || 0,
+            })),
+        };
+    }
+    catch {
+        return { results: [] };
+    }
+}
+async function searchExa(query, apiKey, options) {
+    try {
+        const response = await axios_1.default.post('https://api.exa.ai/search', {
+            query,
+            numResults: options?.numResults || 10,
+            useAutoprompt: options?.useAutoprompt ?? true,
+            type: options?.type || 'neural',
+            contents: { text: true },
+        }, {
+            headers: {
+                'x-api-key': apiKey,
+                'Content-Type': 'application/json',
+            },
+            timeout: 20000,
+        });
+        return (response.data.results || []).map((r) => ({
+            title: r.title || '',
+            url: r.url || '',
+            text: r.text || '',
+            publishedDate: r.publishedDate,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+async function searchWorldBank(indicator, country = 'all', options) {
+    try {
+        const response = await axios_1.default.get(`https://api.worldbank.org/v2/country/${country}/indicator/${indicator}`, {
+            params: {
+                format: 'json',
+                date: options?.dateRange || '2000:2025',
+                per_page: options?.perPage || 500,
+            },
+            timeout: 15000,
+        });
+        if (Array.isArray(response.data) && response.data.length > 1) {
+            return response.data[1] || [];
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+async function getIMFData(datasetId, frequency, country, indicator, startPeriod, endPeriod) {
+    try {
+        const url = `http://dataservices.imf.org/REST/SDMX_JSON.svc/CompactData/${datasetId}/${frequency}.${country}.${indicator}`;
+        const params = {};
+        if (startPeriod)
+            params.startPeriod = startPeriod;
+        if (endPeriod)
+            params.endPeriod = endPeriod;
+        const response = await axios_1.default.get(url, { params, timeout: 20000 });
+        return response.data;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const banner_1 = require("./cli/banner");
+const interactive_1 = require("./cli/interactive");
+const runCommand_1 = require("./cli/runCommand");
+const configCommand_1 = require("./cli/configCommand");
+const outputsCommand_1 = require("./cli/outputsCommand");
+const resumeCommand_1 = require("./cli/resumeCommand");
+const loader_1 = require("./config/loader");
+const program = new commander_1.Command();
+program
+    .name('autoscholar')
+    .description('Autonomous scientific research agent — generate publication-ready papers from your terminal')
+    .version('1.0.0');
+program
+    .command('run')
+    .description('Run full research pipeline')
+    .option('--topic <topic>', 'Research topic')
+    .option('--assets <assets>', 'Comma-separated asset list (e.g. BTC,ETH,WTI)')
+    .option('--method <method>', 'Econometric method (e.g. DCC-GARCH, OLS, VAR)')
+    .option('--hf', 'Use high-frequency data')
+    .option('--dry', 'Dry run — show plan without executing')
+    .option('--background', 'Run in background mode')
+    .action(async (opts) => {
+    (0, banner_1.showBanner)();
+    const config = await (0, loader_1.ensureConfig)();
+    if (!config)
+        return;
+    await (0, runCommand_1.runPipeline)(opts, config);
+});
+program
+    .command('config')
+    .description('Manage API keys and configuration')
+    .action(async () => {
+    (0, banner_1.showBanner)();
+    await (0, configCommand_1.manageConfig)();
+});
+program
+    .command('outputs')
+    .description('View and manage generated research outputs')
+    .action(async () => {
+    (0, banner_1.showBanner)();
+    const config = await (0, loader_1.ensureConfig)();
+    if (!config)
+        return;
+    await (0, outputsCommand_1.listOutputs)();
+});
+program
+    .command('resume <projectId>')
+    .description('Resume an existing research project')
+    .action(async (projectId) => {
+    (0, banner_1.showBanner)();
+    const config = await (0, loader_1.ensureConfig)();
+    if (!config)
+        return;
+    await (0, resumeCommand_1.resumeProject)(projectId, config);
+});
+if (process.argv.length <= 2) {
+    (async () => {
+        (0, banner_1.showBanner)();
+        const config = await (0, loader_1.ensureConfig)();
+        if (!config)
+            return;
+        (0, banner_1.showWelcome)();
+        await (0, interactive_1.runInteractiveMode)(config);
+    })();
+}
+else {
+    program.parse();
+}

package/dist/latex/generator.js

@@ -0,0 +1,413 @@
+"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.generatePaper = generatePaper;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const ora_1 = __importDefault(require("ora"));
+const llm_1 = require("../utils/llm");
+const banner_1 = require("../cli/banner");
+const project_1 = require("../utils/project");
+const SECTIONS = [
+    'introduction',
+    'literature_review',
+    'methodology',
+    'data',
+    'results',
+    'discussion',
+    'conclusion',
+];
+async function generatePaper(input, projectId, config, logger) {
+    const spinner = (0, ora_1.default)({ text: 'Writing paper sections...', indent: 2 }).start();
+    const projectDir = (0, project_1.getProjectDir)(projectId);
+    const outputDir = path.join(projectDir, 'output');
+    if (!fs.existsSync(outputDir))
+        fs.mkdirSync(outputDir, { recursive: true });
+    logger.info(`[LATEX] Starting paper generation: ${input.title}`);
+    const sectionContents = {};
+    for (let i = 0; i < SECTIONS.length; i++) {
+        const section = SECTIONS[i];
+        spinner.text = `Writing section ${i + 1}/${SECTIONS.length}: ${section}...`;
+        logger.info(`[LATEX] Generating section: ${section}`);
+        try {
+            const content = await generateSection(section, input, config);
+            sectionContents[section] = content;
+            logger.info(`[LATEX] Section ${section}: ${content.length} chars`);
+        }
+        catch (err) {
+            logger.warn(`[LATEX] Section ${section} failed: ${err.message}`);
+            sectionContents[section] = `% Section ${section} generation failed\n\\textit{This section could not be generated.}`;
+        }
+    }
+    spinner.text = 'Assembling LaTeX document...';
+    const latex = buildLatexDocument(input, sectionContents);
+    const texPath = path.join(outputDir, 'paper.tex');
+    fs.writeFileSync(texPath, latex, 'utf-8');
+    if (input.bibtexBlock) {
+        const bibPath = path.join(outputDir, 'references.bib');
+        fs.writeFileSync(bibPath, input.bibtexBlock, 'utf-8');
+    }
+    logger.info(`[LATEX] Document assembled: ${texPath}`);
+    spinner.text = 'Compiling LaTeX to PDF...';
+    const compileResult = compilePdf(texPath, outputDir, logger);
+    spinner.stop();
+    if (compileResult.success) {
+        (0, banner_1.printSuccess)(`Paper compiled: ${compileResult.pdfPath}`);
+        (0, banner_1.printInfo)(`Pages: ~${compileResult.pageCount}`);
+    }
+    else {
+        (0, banner_1.printError)('PDF compilation failed — LaTeX source saved');
+        (0, banner_1.printInfo)(`LaTeX: ${texPath}`);
+    }
+    return compileResult;
+}
+async function generateSection(section, input, config) {
+    const sectionPrompts = {
+        introduction: `Write the Introduction section for an academic paper.
+Include: motivation, research question, contribution statement, paper outline.
+Topic: ${input.topic}
+Title: ${input.title}
+Contributions: ${input.contributions.join('; ')}
+Method: ${input.methodology}`,
+        literature_review: `Write the Literature Review section.
+Synthesize the academic literature, organize by themes, identify the gap being addressed.
+Topic: ${input.topic}
+Literature synthesis: ${input.literatureSynthesis.substring(0, 3000)}
+Gap: ${input.gapAnalysis?.recommendedGap?.description || 'N/A'}`,
+        methodology: `Write the Methodology section.
+Explain the econometric/statistical framework, model specification, estimation procedure, and identification strategy.
+Method: ${input.methodology}
+Method type: ${input.methodType}
+Topic: ${input.topic}`,
+        data: `Write the Data Description section.
+Describe data sources, sample construction, variable definitions, and descriptive statistics.
+Sources: ${input.dataDescription.sources.join(', ')}
+Total observations: ${input.dataDescription.totalRows}
+Datasets: ${input.dataDescription.datasets.map((d) => `${d.source}: ${d.description} (${d.rows} rows)`).join('; ')}
+Transformations: ${input.dataDescription.transformations.join(', ')}`,
+        results: `Write the Empirical Results section.
+Present main findings, robustness checks, and statistical significance.
+Models estimated: ${input.analysisResults.models.map((m) => `${m.name} (R²=${m.rSquared?.toFixed(3) || 'N/A'})`).join('; ')}
+Key diagnostics: ${input.analysisResults.diagnostics.join('; ')}
+Summary: ${input.analysisResults.summary}`,
+        discussion: `Write the Discussion section.
+Interpret findings, compare with prior literature, discuss implications, acknowledge limitations.
+Topic: ${input.topic}
+Key findings: ${input.analysisResults.summary}
+Literature context: ${input.literatureSynthesis.substring(0, 1000)}`,
+        conclusion: `Write the Conclusion section.
+Summarize contributions, main findings, policy implications, and future research directions.
+Title: ${input.title}
+Contributions: ${input.contributions.join('; ')}
+Key findings: ${input.analysisResults.summary}`,
+    };
+    const response = await (0, llm_1.callLLM)(config, `You are an expert academic writer producing content for a top-tier journal.
+
+RULES:
+- Write in LaTeX format (no \\section{} header — it will be added automatically)
+- Use proper academic language — formal, precise, citation-rich
+- Reference cite keys using \\cite{key} or \\citet{key}, \\citep{key}
+- Use math mode for equations: $...$ or \\begin{equation}...\\end{equation}
+- Use \\textbf{} for emphasis, not bold
+- Do NOT include \\begin{document} or \\end{document}
+- Write 2-5 pages of content per section
+- Use professional academic English suitable for Journal of Finance / Econometrica`, sectionPrompts[section] || `Write the ${section} section for: ${input.topic}`, { maxTokens: 8192 });
+    let content = response;
+    const latexMatch = response.match(/```(?:latex)?\s*\n?([\s\S]*?)```/);
+    if (latexMatch) {
+        content = latexMatch[1];
+    }
+    return content;
+}
+function buildLatexDocument(input, sections) {
+    const figureIncludes = input.analysisResults.figures
+        .slice(0, 20)
+        .map((fig, i) => {
+        const relPath = `figures/${fig.filename}`;
+        return `
+\\begin{figure}[htbp]
+  \\centering
+  \\includegraphics[width=0.85\\textwidth]{${relPath}}
+  \\caption{${escapeLatex(fig.caption)}}
+  \\label{fig:fig${i + 1}}
+\\end{figure}`;
+    })
+        .join('\n');
+    const tableIncludes = input.analysisResults.tables
+        .slice(0, 10)
+        .map((tbl) => tbl.latex)
+        .join('\n\n');
+    return `\\documentclass[12pt,a4paper]{article}
+
+% ── Encoding & Fonts ──
+\\usepackage[utf8]{inputenc}
+\\usepackage[T1]{fontenc}
+\\usepackage{libertine}
+\\usepackage[libertine]{newtxmath}
+\\usepackage{microtype}
+
+% ── Layout ──
+\\usepackage[margin=1in]{geometry}
+\\usepackage{setspace}
+\\onehalfspacing
+
+% ── Packages ──
+\\usepackage{amsmath,amssymb,amsthm}
+\\usepackage{graphicx}
+\\usepackage{booktabs}
+\\usepackage{longtable}
+\\usepackage{hyperref}
+\\usepackage{natbib}
+\\usepackage{xcolor}
+\\usepackage{float}
+\\usepackage{caption}
+\\usepackage{subcaption}
+\\usepackage{enumitem}
+\\usepackage{tabularx}
+\\usepackage{adjustbox}
+
+% ── Colors ──
+\\definecolor{linkblue}{HTML}{0077B6}
+\\hypersetup{
+  colorlinks=true,
+  linkcolor=linkblue,
+  citecolor=linkblue,
+  urlcolor=linkblue
+}
+
+% ── Theorem Environments ──
+\\newtheorem{theorem}{Theorem}
+\\newtheorem{proposition}{Proposition}
+\\newtheorem{lemma}{Lemma}
+\\newtheorem{corollary}{Corollary}
+\\newtheorem{hypothesis}{Hypothesis}
+
+% ── Custom Commands ──
+\\newcommand{\\E}{\\mathbb{E}}
+\\newcommand{\\Var}{\\text{Var}}
+\\newcommand{\\Cov}{\\text{Cov}}
+
+\\title{\\textbf{${escapeLatex(input.title)}}}
+\\author{Euler --- The AutoScholar Research Agent\\\\\\textit{AutoScholar.ai}}
+\\date{\\today}
+
+\\begin{document}
+
+\\maketitle
+
+\\begin{abstract}
+${input.abstract || 'This paper investigates ' + escapeLatex(input.topic) + '.'}
+\\end{abstract}
+
+\\textbf{Keywords:} ${escapeLatex(input.topic)}
+
+\\textbf{JEL Classification:} G10, G12, C58
+
+\\newpage
+\\tableofcontents
+\\newpage
+
+% ═══════════════════════════════════════════
+\\section{Introduction}
+% ═══════════════════════════════════════════
+
+${sections.introduction || ''}
+
+% ═══════════════════════════════════════════
+\\section{Literature Review}
+% ═══════════════════════════════════════════
+
+${sections.literature_review || ''}
+
+% ═══════════════════════════════════════════
+\\section{Methodology}
+% ═══════════════════════════════════════════
+
+${sections.methodology || ''}
+
+% ═══════════════════════════════════════════
+\\section{Data}
+% ═══════════════════════════════════════════
+
+${sections.data || ''}
+
+% ═══════════════════════════════════════════
+\\section{Empirical Results}
+% ═══════════════════════════════════════════
+
+${sections.results || ''}
+
+${tableIncludes}
+
+${figureIncludes}
+
+% ═══════════════════════════════════════════
+\\section{Discussion}
+% ═══════════════════════════════════════════
+
+${sections.discussion || ''}
+
+% ═══════════════════════════════════════════
+\\section{Conclusion}
+% ═══════════════════════════════════════════
+
+${sections.conclusion || ''}
+
+% ═══════════════════════════════════════════
+% References
+% ═══════════════════════════════════════════
+
+\\bibliographystyle{apalike}
+\\bibliography{references}
+
+% ═══════════════════════════════════════════
+\\appendix
+\\section{AI Disclosure}
+% ═══════════════════════════════════════════
+
+This paper was generated by \\textbf{AutoScholar}, an autonomous scientific research agent.
+The entire research pipeline — from literature review to data collection, econometric analysis,
+and paper writing — was executed autonomously by the Euler orchestration system.
+
+\\begin{itemize}
+  \\item \\textbf{Gauss} (Literature Gap Finder): Searched and analyzed academic literature
+  \\item \\textbf{Turing} (Data Collector): Gathered data from financial and macroeconomic APIs
+  \\item \\textbf{Newton} (Dataset Builder): Constructed and cleaned the analysis dataset
+  \\item \\textbf{Fisher} (Analysis Engine): Estimated econometric models and generated figures
+  \\item \\textbf{Euler} (Orchestrator): Coordinated the pipeline and wrote this paper
+\\end{itemize}
+
+\\end{document}
+`;
+}
+function compilePdf(texPath, outputDir, logger) {
+    const pdfPath = texPath.replace('.tex', '.pdf');
+    const pdflatexPaths = [
+        '/Library/TeX/texbin/pdflatex',
+        '/usr/local/texlive/2025/bin/universal-darwin/pdflatex',
+        '/usr/local/texlive/2024/bin/universal-darwin/pdflatex',
+        '/opt/homebrew/bin/pdflatex',
+        'pdflatex',
+    ];
+    let pdflatex = 'pdflatex';
+    for (const p of pdflatexPaths) {
+        try {
+            (0, child_process_1.execSync)(`${p} --version`, { stdio: 'ignore' });
+            pdflatex = p;
+            break;
+        }
+        catch { }
+    }
+    try {
+        const opts = {
+            cwd: outputDir,
+            timeout: 60000,
+            stdio: 'pipe',
+            maxBuffer: 10 * 1024 * 1024,
+        };
+        const texFile = path.basename(texPath);
+        logger.info('[LATEX] Compilation pass 1...');
+        (0, child_process_1.execSync)(`${pdflatex} -interaction=nonstopmode -halt-on-error "${texFile}"`, opts);
+        const bibFile = path.join(outputDir, 'references.bib');
+        if (fs.existsSync(bibFile)) {
+            try {
+                const auxFile = texFile.replace('.tex', '');
+                const bibtexPaths = [
+                    '/Library/TeX/texbin/bibtex',
+                    '/usr/local/texlive/2025/bin/universal-darwin/bibtex',
+                    '/usr/local/texlive/2024/bin/universal-darwin/bibtex',
+                    'bibtex',
+                ];
+                let bibtex = 'bibtex';
+                for (const p of bibtexPaths) {
+                    try {
+                        (0, child_process_1.execSync)(`${p} --version 2>&1`, { stdio: 'ignore' });
+                        bibtex = p;
+                        break;
+                    }
+                    catch { }
+                }
+                logger.info('[LATEX] Running BibTeX...');
+                (0, child_process_1.execSync)(`${bibtex} "${auxFile}"`, { ...opts, timeout: 30000 });
+            }
+            catch {
+                logger.warn('[LATEX] BibTeX failed — continuing without bibliography');
+            }
+        }
+        logger.info('[LATEX] Compilation pass 2...');
+        (0, child_process_1.execSync)(`${pdflatex} -interaction=nonstopmode "${texFile}"`, opts);
+        logger.info('[LATEX] Compilation pass 3...');
+        (0, child_process_1.execSync)(`${pdflatex} -interaction=nonstopmode "${texFile}"`, opts);
+        if (fs.existsSync(pdfPath)) {
+            const stats = fs.statSync(pdfPath);
+            const pageCount = Math.max(1, Math.round(stats.size / 50000));
+            logger.info(`[LATEX] PDF generated: ${pdfPath} (${stats.size} bytes, ~${pageCount} pages)`);
+            return {
+                success: true,
+                pdfPath,
+                pageCount,
+                compilationLog: 'Compilation successful',
+            };
+        }
+    }
+    catch (err) {
+        logger.error(`[LATEX] Compilation error: ${err.message}`);
+        const logPath = texPath.replace('.tex', '.log');
+        if (fs.existsSync(logPath)) {
+            const log = fs.readFileSync(logPath, 'utf-8');
+            const errors = log.split('\n').filter((l) => l.startsWith('!')).slice(0, 5);
+            logger.error(`[LATEX] Errors: ${errors.join('; ')}`);
+        }
+    }
+    return {
+        success: false,
+        pdfPath: texPath,
+        pageCount: 0,
+        compilationLog: 'Compilation failed',
+    };
+}
+function escapeLatex(text) {
+    if (!text)
+        return '';
+    return text
+        .replace(/\\/g, '\\textbackslash{}')
+        .replace(/[&%$#_{}]/g, (match) => `\\${match}`)
+        .replace(/~/g, '\\textasciitilde{}')
+        .replace(/\^/g, '\\textasciicircum{}');
+}