@redigg/redigg 0.1.0

package/dist/skills/research/academic-survey-self-improve/SKILL.md

@@ -0,0 +1,17 @@
+# Academic Survey Self-Improve
+
+## Description
+Conducts a comprehensive academic survey on a given topic using arXiv and LLM-based analysis. It iteratively refines the search based on initial findings to improve the quality of the survey.
+
+## Author
+vixuowis
+
+## Version
+0.1.0
+
+## Usage
+- `topic`: The research topic to survey.
+- `depth`: (Optional) Depth of the survey (default: "brief").
+
+## Tags
+research, survey, academic, self-improve

package/dist/skills/research/academic-survey-self-improve/index.d.ts

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

package/dist/skills/research/academic-survey-self-improve/index.js

@@ -0,0 +1,75 @@
+import { ScholarTool } from '../../../src/skills/lib/ScholarTool.js';
+export default class AcademicSurveySelfImproveSkill {
+    id = 'academic_survey_self_improve';
+    name = 'Academic Survey (Self-Improve)';
+    description = 'Conducts an academic survey and iteratively refines it.';
+    tags = ['research', 'survey', 'academic'];
+    async execute(context, params) {
+        const { topic, depth = 'brief' } = params;
+        context.log('thinking', `Starting academic survey on: ${topic}`);
+        if (context.updateProgress) {
+            await context.updateProgress(10, 'Initializing search', { topic });
+        }
+        const scholar = new ScholarTool();
+        let papers = await scholar.searchPapers(topic, 5);
+        if (papers.length === 0) {
+            context.log('thinking', 'No papers found. Attempting to broaden search...');
+            if (context.updateProgress) {
+                await context.updateProgress(30, 'No results found, refining query...', { originalTopic: topic });
+            }
+            const betterQuery = await this.refineQuery(context, topic);
+            if (betterQuery !== topic) {
+                context.log('thinking', `Refined query to: ${betterQuery}`);
+                if (context.updateProgress) {
+                    await context.updateProgress(40, `Searching with refined query: ${betterQuery}`);
+                }
+                papers = await scholar.searchPapers(betterQuery, 5);
+            }
+        }
+        if (papers.length === 0) {
+            if (context.updateProgress) {
+                await context.updateProgress(100, 'Survey failed: No papers found');
+            }
+            return {
+                success: false,
+                message: 'No papers found even after refinement.',
+                papers: []
+            };
+        }
+        context.log('thinking', `Found ${papers.length} papers. Analyzing...`);
+        if (context.updateProgress) {
+            await context.updateProgress(60, `Analyzing ${papers.length} papers`, { papers });
+        }
+        // Summarize
+        const summary = await this.summarizePapers(context, topic, papers);
+        if (context.updateProgress) {
+            await context.updateProgress(100, 'Survey complete');
+        }
+        return {
+            success: true,
+            summary,
+            papers,
+            formatted_output: summary
+        };
+    }
+    async refineQuery(context, originalQuery) {
+        const prompt = `The user searched for "${originalQuery}" on arXiv but found no results. Suggest a broader or more effective search query for the same intent. Return ONLY the new query string.`;
+        const response = await context.llm.chat([{ role: 'user', content: prompt }]);
+        return response.content.trim().replace(/^"|"$/g, '');
+    }
+    async summarizePapers(context, topic, papers) {
+        const papersText = papers.map((p, i) => `[${i + 1}] ${p.title} (${p.year})\nSummary: ${p.summary}`).join('\n\n');
+        const prompt = `
+      Perform a literature survey on the topic: "${topic}".
+      Based on the following papers found:
+      
+      ${papersText}
+      
+      Synthesize a coherent summary of the state of research. Highlight key trends, methodologies, and findings.
+      Format as Markdown.
+      `;
+        const response = await context.llm.chat([{ role: 'user', content: prompt }]);
+        return response.content;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/research/academic-survey-self-improve/index.js.map

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

package/dist/skills/research/concept-explainer/SKILL.md

@@ -0,0 +1,3 @@
+# Concept Explainer
+
+Explain a complex scientific or technical concept in simple terms, with examples and historical context.

package/dist/skills/research/concept-explainer/index.d.ts

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

package/dist/skills/research/concept-explainer/index.js

@@ -0,0 +1,37 @@
+export default class ConceptExplainerSkill {
+    id = 'concept_explainer';
+    name = 'Concept Explainer';
+    description = 'Explain a complex scientific concept';
+    tags = ['research', 'education', 'explanation'];
+    async execute(ctx, params) {
+        const concept = params.concept || params.topic || params.query;
+        if (!concept) {
+            throw new Error('Concept is required');
+        }
+        ctx.log('thinking', `Explaining concept: ${concept}`);
+        if (ctx.updateProgress)
+            await ctx.updateProgress(10, `Researching concept: ${concept}`);
+        const prompt = `
+      You are an expert science communicator (like Feynman).
+      Explain the following concept in a clear, engaging, and depth-first manner: "${concept}"
+
+      Structure:
+      1. **Definition**: Simple, one-sentence definition.
+      2. **The "Why"**: Why is this concept important?
+      3. **Deep Dive**: How does it work? (Use analogies).
+      4. **History**: Who discovered it and when?
+      5. **Applications**: Real-world examples.
+      6. **Related Concepts**: What else should I know?
+    `;
+        const response = await ctx.llm.complete(prompt);
+        const explanation = response.content;
+        if (ctx.updateProgress)
+            await ctx.updateProgress(100, `Explanation ready.`);
+        return {
+            concept,
+            explanation,
+            formatted_output: `### Concept: ${concept}\n\n${explanation}`
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/research/concept-explainer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../skills/research/concept-explainer/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,qBAAqB;IACxC,EAAE,GAAG,mBAAmB,CAAC;IACzB,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GAAG,sCAAsC,CAAC;IACrD,IAAI,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IAEhD,KAAK,CAAC,OAAO,CAAC,GAAiB,EAAE,MAAmB;QAClD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,uBAAuB,OAAO,EAAE,CAAC,CAAC;QACtD,IAAI,GAAG,CAAC,cAAc;YAAE,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,wBAAwB,OAAO,EAAE,CAAC,CAAC;QAExF,MAAM,MAAM,GAAG;;qFAEkE,OAAO;;;;;;;;;KASvF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;QAErC,IAAI,GAAG,CAAC,cAAc;YAAE,MAAM,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAE5E,OAAO;YACL,OAAO;YACP,WAAW;YACX,gBAAgB,EAAE,gBAAgB,OAAO,OAAO,WAAW,EAAE;SAC9D,CAAC;IACJ,CAAC;CACF"}

package/dist/skills/research/literature-review/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: literature-review
+description: Search for papers and generate a literature review
+tags: [research, literature, review]
+---
+
+# Literature Review
+
+This skill performs an automated literature review on a given topic.
+
+## Instructions
+
+1.  **Search**: Queries academic databases (e.g. arXiv, Semantic Scholar) for relevant papers.
+2.  **Filter**: Selects the most relevant papers based on the topic.
+3.  **Analyze**: Extracts key insights, methodologies, and findings.
+4.  **Synthesize**: Generates a comprehensive review summary.
+
+## Parameters
+
+- `topic` (required): The research topic or question.
+
+## Examples
+
+- "Do a literature review on Large Language Model reasoning"
+- "Survey recent advances in multimodal agents"

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

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

package/dist/skills/research/literature-review/index.js

@@ -0,0 +1,132 @@
+import { ScholarTool } from '../../../src/skills/lib/ScholarTool.js';
+export default class LiteratureReviewSkill {
+    id = 'literature_review';
+    name = 'Literature Review';
+    description = 'Search for papers and generate a literature review';
+    tags = ['research', 'literature', 'review'];
+    scholar = new ScholarTool();
+    async execute(ctx, params) {
+        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.addPaper === 'function') {
+                await ctx.memory.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
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/research/literature-review/index.js.map

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

package/dist/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/dist/skills/research/paper-analysis/index.d.ts

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

package/dist/skills/research/paper-analysis/index.js

@@ -0,0 +1,64 @@
+import { ScholarTool } from '../../../src/skills/lib/ScholarTool.js';
+export default class PaperAnalysisSkill {
+    id = 'paper_analysis';
+    name = 'Paper Analysis';
+    description = 'Analyze a scientific paper in depth';
+    tags = ['research', 'analysis', 'critique'];
+    scholar = new ScholarTool();
+    async execute(ctx, params) {
+        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})`
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/research/paper-analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../skills/research/paper-analysis/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAErE,MAAM,CAAC,OAAO,OAAO,kBAAkB;IACrC,EAAE,GAAG,gBAAgB,CAAC;IACtB,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG,qCAAqC,CAAC;IACpD,IAAI,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAEpC,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAEpC,KAAK,CAAC,OAAO,CAAC,GAAiB,EAAE,MAAmB;QAClD,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QACtE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,oBAAoB,UAAU,EAAE,CAAC,CAAC;QACtD,IAAI,GAAG,CAAC,cAAc;YAAE,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAE3F,6EAA6E;QAC7E,oDAAoD;QACpD,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAgC,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAE9D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACnE,IAAI,GAAG,CAAC,cAAc;YAAE,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAEpF,uBAAuB;QACvB,kFAAkF;QAClF,iFAAiF;QACjF,6DAA6D;QAE7D,MAAM,MAAM,GAAG;;;;eAIJ,KAAK,CAAC,KAAK;iBACT,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;cAC3B,KAAK,CAAC,IAAI;kBACN,KAAK,CAAC,OAAO;aAClB,KAAK,CAAC,GAAG,IAAI,KAAK;;;;;;;;;;;KAW1B,CAAC;QAEF,IAAI,GAAG,CAAC,cAAc;YAAE,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,sBAAsB,CAAC,CAAC;QAE7E,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC;QAElC,IAAI,GAAG,CAAC,cAAc;YAAE,MAAM,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QAE5E,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,QAAQ;YAClB,gBAAgB,EAAE,uBAAuB,KAAK,CAAC,KAAK,OAAO,QAAQ,oBAAoB,KAAK,CAAC,GAAG,GAAG;SACpG,CAAC;IACJ,CAAC;CACF"}

package/dist/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/dist/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/dist/skills/research/pdf-generator/index.js

@@ -0,0 +1,88 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+import PDFDocument from 'pdfkit';
+export default class PdfGeneratorSkill {
+    id = 'pdf_generator';
+    name = 'PDF Generator';
+    description = 'Generate a PDF from text/markdown using PDFKit';
+    tags = ['research', 'document', 'pdf'];
+    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
+        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})`
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/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/dist/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")`

package/dist/skills/system/code-analysis/index.d.ts

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