@redigg/redigg 0.1.0

package/skills/research/literature-review/index.ts

@@ -0,0 +1,168 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+import { ScholarTool } from '../../../src/skills/lib/ScholarTool.js';
+import chalk from 'chalk';
+
+export default class LiteratureReviewSkill implements Skill {
+  id = 'literature_review';
+  name = 'Literature Review';
+  description = 'Search for papers and generate a literature review';
+  tags = ['research', 'literature', 'review'];
+
+  private scholar = new ScholarTool();
+
+  async execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult> {
+    const topic = params.topic;
+    if (!topic) {
+      throw new Error('Topic is required');
+    }
+
+    ctx.log('thinking', `Starting literature review on topic: ${topic}`);
+
+    if (ctx.updateProgress) {
+      await ctx.updateProgress(10, `Starting literature review on ${topic}`);
+    }
+
+    // 1. Search Papers
+    ctx.log('action', 'Initializing academic search');
+    ctx.log('tool_call', 'Searching for papers', {
+      tool_name: 'ScholarSearch',
+      tool_args: { topic, limit: 5 }
+    });
+
+    const papers = await this.scholar.searchPapers(topic, 5);
+
+    ctx.log('tool_result', `Found ${papers.length} relevant papers`, {
+      tool_name: 'ScholarSearch',
+      papers_count: papers.length
+    });
+    
+    if (ctx.updateProgress) {
+      await ctx.updateProgress(50, `Found ${papers.length} papers, analyzing...`);
+    }
+
+    // 2. Add to Memory (Memory Injection)
+    for (const paper of papers) {
+      // Simulate memory addition (in a real scenario, this would persist the paper as a memory)
+      // Actually, we can use ctx.memory.addPaper() if available, but SkillContext might not have it directly exposed as `addPaper` if it's generic
+      // But we have `memory` which is `MemoryManager`, so we can call it.
+      if (ctx.memory && typeof (ctx.memory as any).addPaper === 'function') {
+         await (ctx.memory as any).addPaper(
+           ctx.userId, 
+           paper.title, 
+           paper.authors, 
+           paper.url, 
+           paper.summary
+         );
+      }
+    }
+
+    // 3. Generate Summary
+    ctx.log('thinking', 'Synthesizing literature review');
+    
+    if (ctx.updateProgress) {
+      await ctx.updateProgress(75, 'Synthesizing literature review...');
+    }
+
+    const prompt = `
+      You are a rigorous academic researcher.
+      Write a literature review summary based on the following papers about "${topic}".
+      
+      CRITICAL INSTRUCTIONS:
+      1. ONLY cite papers that are directly relevant to the user's topic.
+      2. If a paper in the list below is irrelevant, ignore it completely.
+      3. At the end of your summary, provide a "Selected Sources" list containing ONLY the papers you actually used/cited in the text.
+      4. Do not include a "Sources" list if you didn't use any.
+
+      Available Papers:
+      ${papers.map((p, i) => `[${i+1}] ${p.title} (${p.year}): ${p.summary}`).join('\n')}
+
+      Output Format:
+      <Summary text with inline citations like [1]>
+
+      **Selected Sources:**
+      [1] Title (Year)
+      ...
+    `;
+    
+    const summaryResponse = await ctx.llm.complete(prompt);
+    const summary = summaryResponse.content;
+
+    // Parse the LLM response to extract the actually used papers
+    // This is a heuristic: we trust the LLM's "Selected Sources" list or we could parse inline citations.
+    // For now, let's rely on the LLM's output for the summary, but we need to filter the `papers` array returned in result
+    // to match what the user sees.
+    
+    // Actually, the `ResearchAgent.ts` constructs the final response string using `result.papers`.
+    // So we should update `result.papers` to only include relevant ones.
+    
+    // Let's ask the LLM to output a JSON list of indices of used papers to be precise.
+    
+    const promptRefinement = `
+      Based on the summary you just wrote, which of the provided papers (by index 1-${papers.length}) were actually relevant and cited?
+      Return ONLY a JSON array of numbers, e.g., [1, 3, 5]. If none, return [].
+    `;
+    
+    // This second call might be expensive. Alternatively, we can just ask for the filtered list in the first prompt 
+    // and parse it. Let's try a single prompt approach with structured output if possible, 
+    // or just strict formatting.
+    
+    // Let's stick to the prompt update above, but we need to parse the "Selected Sources" section 
+    // to filter the `papers` array returned to the agent.
+    
+    // Simple parsing: check if paper title appears in the "Selected Sources" section of the response.
+    const relevantPapers = papers.filter(p => summary.includes(p.title));
+    
+    // If the heuristic fails (LLM changes title format), we fall back to all papers 
+    // OR we can just return the summary as is (which includes the sources list) 
+    // and pass an empty array for papers so the Agent doesn't duplicate the list.
+    
+    // ResearchAgent.ts does: 
+    // const response = ... result.summary ... \n\n**Sources:**\n${result.papers.map(...)}
+    
+    // So if we include sources in the summary, we should return empty papers to Agent, 
+    // OR we strip sources from summary and return filtered papers.
+    
+    // Let's strip the "Selected Sources" from the LLM output and return the filtered list.
+    
+    let finalSummary = summary;
+    let finalPapers = papers;
+
+    if (summary.includes('**Selected Sources:**')) {
+        const parts = summary.split('**Selected Sources:**');
+        finalSummary = parts[0].trim();
+        const sourcesText = parts[1];
+        
+        // Filter papers based on what's in sourcesText
+        finalPapers = papers.filter(p => sourcesText.includes(p.title) || sourcesText.includes(p.summary.slice(0, 20)));
+    } else if (summary.includes('Selected Sources:')) {
+        const parts = summary.split('Selected Sources:');
+        finalSummary = parts[0].trim();
+        const sourcesText = parts[1];
+        finalPapers = papers.filter(p => sourcesText.includes(p.title) || sourcesText.includes(p.summary.slice(0, 20)));
+    } else {
+        // Fallback: if no explicit sources section, try to filter by inline citations or titles in text
+        // This is safer than returning all papers if the user specifically asked to filter.
+        // But if LLM didn't follow format, we might lose all sources.
+        // Let's keep all papers if format wasn't followed, or maybe try to match titles in summary.
+        const papersInText = papers.filter(p => summary.includes(p.title));
+        if (papersInText.length > 0) {
+            finalPapers = papersInText;
+        }
+    }
+
+    if (ctx.updateProgress) {
+      await ctx.updateProgress(100, `Completed analysis. Selected ${finalPapers.length} relevant sources.`);
+    }
+
+    ctx.log('result', `Completed literature review on ${topic}`, {
+      papers_count: finalPapers.length,
+      summary_length: finalSummary.length
+    });
+
+    return {
+      topic,
+      summary: finalSummary,
+      papers: finalPapers
+    };
+  }
+}

package/skills/research/paper-analysis/SKILL.md

@@ -0,0 +1,3 @@
+# Paper Analysis
+
+Analyze a scientific paper in depth, including summary, methodology, results, and critique.

package/skills/research/paper-analysis/index.ts

@@ -0,0 +1,73 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+import { ScholarTool } from '../../../src/skills/lib/ScholarTool.js';
+
+export default class PaperAnalysisSkill implements Skill {
+  id = 'paper_analysis';
+  name = 'Paper Analysis';
+  description = 'Analyze a scientific paper in depth';
+  tags = ['research', 'analysis', 'critique'];
+
+  private scholar = new ScholarTool();
+
+  async execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult> {
+    const paperTitle = params.paper_title || params.title || params.query;
+    if (!paperTitle) {
+      throw new Error('Paper title is required');
+    }
+
+    ctx.log('thinking', `Analyzing paper: ${paperTitle}`);
+    if (ctx.updateProgress) await ctx.updateProgress(10, `Searching for paper: ${paperTitle}`);
+
+    // 1. Search for the paper to get metadata/summary if we don't have full text
+    // In a real system, we might download the PDF here.
+    ctx.log('action', 'Searching for paper details...');
+    const papers = await this.scholar.searchPapers(paperTitle, 1);
+    
+    if (papers.length === 0) {
+        throw new Error(`Paper not found: ${paperTitle}`);
+    }
+
+    const paper = papers[0];
+    ctx.log('thinking', `Found paper: ${paper.title} (${paper.year})`);
+    if (ctx.updateProgress) await ctx.updateProgress(40, `Found paper: ${paper.title}`);
+
+    // 2. Analyze using LLM
+    // Since we can't read the full PDF yet (ScholarTool just gets metadata/abstract),
+    // we will ask the LLM to analyze based on its internal knowledge + the abstract.
+    // If we had PDF reading capability, we'd feed the text here.
+    
+    const prompt = `
+      You are an expert research scientist.
+      Please perform a deep analysis of the following paper:
+      
+      Title: ${paper.title}
+      Authors: ${paper.authors.join(', ')}
+      Year: ${paper.year}
+      Abstract: ${paper.summary}
+      URL: ${paper.url || 'N/A'}
+
+      If you have internal knowledge about this specific paper (based on title/authors), please use it to enrich the analysis.
+      
+      Structure your response as follows:
+      1. **Executive Summary**: 2-3 sentences.
+      2. **Key Contributions**: Bullet points.
+      3. **Methodology**: How did they do it?
+      4. **Results**: What did they find?
+      5. **Critique & Limitations**: What are the weaknesses?
+      6. **Relevance**: Why does this matter?
+    `;
+
+    if (ctx.updateProgress) await ctx.updateProgress(60, `Analyzing content...`);
+
+    const response = await ctx.llm.complete(prompt);
+    const analysis = response.content;
+
+    if (ctx.updateProgress) await ctx.updateProgress(100, `Analysis complete.`);
+
+    return {
+      paper: paper,
+      analysis: analysis,
+      formatted_output: `### Paper Analysis: ${paper.title}\n\n${analysis}\n\n[View Paper](${paper.url})`
+    };
+  }
+}

package/skills/research/pdf-generator/SKILL.md

@@ -0,0 +1,16 @@
+# PDF Generator (LaTeX)
+
+Generate high-quality PDF documents from text or markdown using LaTeX.
+This skill creates a `.tex` file and compiles it to PDF.
+
+## Dependencies
+- `pdflatex` must be installed on the system (e.g., via TeX Live or MacTeX).
+- Node.js `child_process` to run the command.
+
+## Usage
+Provide the `content` (markdown or plain text) and a `title`.
+The skill will:
+1. Convert the content to LaTeX format (using a template).
+2. Write the `.tex` file.
+3. Run `pdflatex` to generate the PDF.
+4. Return the path to the generated PDF.

package/skills/research/pdf-generator/index.d.ts

@@ -0,0 +1,10 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+export default class PdfGeneratorSkill implements Skill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    private workspaceDir;
+    constructor();
+    execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult>;
+}

package/skills/research/pdf-generator/index.js

@@ -0,0 +1,114 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+const execAsync = promisify(exec);
+export default class PdfGeneratorSkill {
+    id = 'pdf_generator';
+    name = 'PDF Generator (LaTeX)';
+    description = 'Generate a PDF from text/markdown using LaTeX';
+    tags = ['research', 'document', 'pdf', 'latex'];
+    workspaceDir;
+    constructor() {
+        // Ensure output directory exists
+        this.workspaceDir = path.resolve(process.cwd(), 'workspace/output/pdfs');
+    }
+    async execute(ctx, params) {
+        const { title, content, author = 'Redigg AI' } = params;
+        if (!content) {
+            throw new Error('Content is required to generate PDF');
+        }
+        // Ensure output directory exists
+        await fs.mkdir(this.workspaceDir, { recursive: true });
+        ctx.log('thinking', `Generating PDF for "${title || 'Untitled'}"`);
+        if (ctx.updateProgress)
+            await ctx.updateProgress(10, `Preparing LaTeX template...`);
+        // 1. Convert content to LaTeX
+        // For now, we'll do a simple conversion or ask LLM to convert if it's complex markdown.
+        // Let's ask LLM to convert the markdown/text to LaTeX body content.
+        const prompt = `
+      Convert the following Markdown/Text content into LaTeX code suitable for the document body.
+      Do not include \\documentclass, \\begin{document}, or preamble. Just the body content.
+      Use standard LaTeX commands for sections, lists, bold, italics, etc.
+      Escape special characters like %, $, _, etc. properly unless they are math.
+      
+      Content:
+      ${content}
+    `;
+        const llmRes = await ctx.llm.complete(prompt);
+        const latexBody = llmRes.content;
+        if (ctx.updateProgress)
+            await ctx.updateProgress(40, `Compiling LaTeX...`);
+        // 2. Create full LaTeX document
+        const filename = (title || 'document').replace(/[^a-z0-9]/gi, '_').toLowerCase() + '_' + uuidv4().slice(0, 8);
+        const texPath = path.join(this.workspaceDir, `${filename}.tex`);
+        const pdfPath = path.join(this.workspaceDir, `${filename}.pdf`);
+        const latexDoc = `
+\\documentclass[12pt,a4paper]{article}
+\\usepackage[utf8]{inputenc}
+\\usepackage{geometry}
+\\usepackage{hyperref}
+\\usepackage{xcolor}
+\\usepackage{parskip}
+
+\\geometry{
+ a4paper,
+ total={170mm,257mm},
+ left=20mm,
+ top=20mm,
+}
+
+\\title{${title || 'Research Report'}}
+\\author{${author}}
+\\date{\\today}
+
+\\begin{document}
+
+\\maketitle
+
+${latexBody}
+
+\\end{document}
+    `;
+        await fs.writeFile(texPath, latexDoc);
+        // 3. Compile PDF using pdflatex
+        try {
+            ctx.log('action', `Running pdflatex on ${texPath}`);
+            // Check for pdflatex first
+            try {
+                await execAsync('pdflatex --version');
+            }
+            catch (e) {
+                throw new Error('pdflatex is not installed. Please install it:\nMacOS: brew install --cask basictex\nLinux: apt-get install texlive-latex-base');
+            }
+            // Run twice for references/toc if needed, but once is usually fine for simple docs
+            await execAsync(`pdflatex -interaction=nonstopmode -output-directory=${this.workspaceDir} ${texPath}`);
+        }
+        catch (error) {
+            if (error.message.includes('pdflatex is not installed')) {
+                throw error;
+            }
+            // If compilation failed, maybe read the log file?
+            const logPath = texPath.replace('.tex', '.log');
+            let logContent = '';
+            try {
+                logContent = await fs.readFile(logPath, 'utf-8');
+            }
+            catch (e) { }
+            throw new Error(`LaTeX compilation failed: ${error.message}\n\nLog tail:\n${logContent.slice(-500)}`);
+        }
+        if (ctx.updateProgress)
+            await ctx.updateProgress(100, `PDF Generated.`);
+        // Return relative path for frontend to access (assuming static serve)
+        // We need to make sure the workspace/output is served by express.
+        const relativeUrl = `/files/pdfs/${filename}.pdf`;
+        return {
+            success: true,
+            file_path: pdfPath,
+            url: relativeUrl,
+            formatted_output: `### PDF Generated\n\n[Download PDF](${relativeUrl})`
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/skills/research/pdf-generator/index.js.map

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

package/skills/research/pdf-generator/index.ts

@@ -0,0 +1,97 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+import PDFDocument from 'pdfkit';
+
+export default class PdfGeneratorSkill implements Skill {
+  id = 'pdf_generator';
+  name = 'PDF Generator';
+  description = 'Generate a PDF from text/markdown using PDFKit';
+  tags = ['research', 'document', 'pdf'];
+
+  private workspaceDir: string;
+
+  constructor() {
+    // Ensure output directory exists
+    this.workspaceDir = path.resolve(process.cwd(), 'workspace/output/pdfs');
+  }
+
+  async execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult> {
+    const { title, content, author = 'Redigg AI' } = params;
+    
+    if (!content) {
+      throw new Error('Content is required to generate PDF');
+    }
+
+    // Ensure output directory exists
+    if (!fs.existsSync(this.workspaceDir)) {
+      fs.mkdirSync(this.workspaceDir, { recursive: true });
+    }
+
+    ctx.log('thinking', `Generating PDF for "${title || 'Untitled'}"`);
+    if (ctx.updateProgress) await ctx.updateProgress(10, `Initializing PDF document...`);
+
+    const filename = (title || 'document').replace(/[^a-z0-9]/gi, '_').toLowerCase() + '_' + uuidv4().slice(0, 8);
+    const pdfPath = path.join(this.workspaceDir, `${filename}.pdf`);
+    
+    // Create a document
+    const doc = new PDFDocument({ margin: 50 });
+    const stream = fs.createWriteStream(pdfPath);
+    doc.pipe(stream);
+
+    // Title Page
+    doc.fontSize(24).text(title || 'Research Report', { align: 'center' });
+    doc.moveDown();
+    doc.fontSize(14).text(`Author: ${author}`, { align: 'center' });
+    doc.fontSize(12).text(`Date: ${new Date().toLocaleDateString()}`, { align: 'center' });
+    doc.moveDown(2);
+
+    // Content Rendering (Simple Markdown Parser)
+    const lines = content.split('\n');
+    let inList = false;
+
+    for (const line of lines) {
+        const trimmed = line.trim();
+        
+        if (trimmed.startsWith('# ')) {
+            doc.addPage(); // New page for main chapters? Maybe just space
+            doc.fontSize(20).text(trimmed.substring(2), { underline: true });
+            doc.moveDown(0.5);
+        } else if (trimmed.startsWith('## ')) {
+            doc.fontSize(16).text(trimmed.substring(3));
+            doc.moveDown(0.5);
+        } else if (trimmed.startsWith('### ')) {
+            doc.fontSize(14).text(trimmed.substring(4));
+            doc.moveDown(0.5);
+        } else if (trimmed.startsWith('- ') || trimmed.startsWith('* ')) {
+            doc.fontSize(12).text(`• ${trimmed.substring(2)}`, { indent: 20 });
+        } else if (trimmed.match(/^\d+\./)) {
+             doc.fontSize(12).text(trimmed, { indent: 20 });
+        } else if (trimmed === '') {
+            doc.moveDown(0.5);
+        } else {
+            // Normal paragraph
+            // Handle bold **text** (simple regex replace won't work easily with pdfkit text flow without mixed fonts)
+            // For now, just render plain text
+            doc.fontSize(12).text(line, { align: 'justify' });
+        }
+    }
+
+    // Finalize PDF file
+    doc.end();
+
+    if (ctx.updateProgress) await ctx.updateProgress(100, `PDF Generated.`);
+
+    // Return relative path for frontend to access (assuming static serve)
+    // We need to make sure the workspace/output is served by express.
+    const relativeUrl = `/files/pdfs/${filename}.pdf`;
+
+    return {
+      success: true,
+      file_path: pdfPath,
+      url: relativeUrl,
+      formatted_output: `### PDF Generated\n\n[Download PDF](${relativeUrl})`
+    };
+  }
+}

package/skills/system/PACK.md

@@ -0,0 +1,8 @@
+# System Skills Pack
+
+Infrastructure and OS-level capabilities.
+
+## Skills
+
+- `code-analysis`: Analyzing project structure and files
+- `local-file-ops`: Reading and writing files

package/skills/system/code-analysis/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: code-analysis
+description: Analyze project structure, scan codebase stats, and summarize code files
+tags: [code, analysis, summary, scan]
+---
+
+# Code Analysis
+
+This skill provides capabilities to analyze the codebase structure, scan for overall statistics, and summarize individual files.
+
+## Instructions
+
+Use this skill when the user asks to:
+- Understand the project structure
+- Get an overview of the codebase (size, languages, key files)
+- Summarize what a specific file does
+- Analyze code statistics (SLOC, imports, exports)
+
+## Actions
+
+### structure
+Recursively lists the file structure of the project, ignoring `node_modules` and hidden files.
+
+**Parameters:**
+- `path` (optional): The root directory to analyze. Defaults to current working directory.
+
+### scan
+Scans the codebase to provide a high-level summary including total files, directories, size, SLOC, and language breakdown.
+
+**Parameters:**
+- `path` (optional): The root directory to scan. Defaults to current working directory.
+
+### summarize
+Provides a summary of a specific code file or directory. For files, it may use LLM to generate a description.
+
+**Parameters:**
+- `path` (required): The path to the file or directory to summarize.
+
+## Examples
+
+- "Show me the project structure" -> `structure`
+- "Scan the codebase" -> `scan`
+- "Analyze src/index.ts" -> `summarize(path="src/index.ts")`