@redigg/redigg 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 redigg.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,145 @@
+<div align="center">
+  <img src="https://media.giphy.com/media/v1.Y2lkPTc5MGI3NjExcDNoM3Z5ZGR5dXJ5ODF5ZGR5dXJ5ODF5ZGR5dXJ5ODF5ZGR5dXJ5ODF5ZCZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/3oKIPnAiaMCws8nOsE/giphy.gif" alt="Redigg Demo" width="100%">
+  
+  # Redigg 🦎
+  
+  **Autonomous Research Agent for Scientific Discovery**
+  
+  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+  [![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
+  [![OpenClaw](https://img.shields.io/badge/Powered%20by-OpenClaw-orange)](https://github.com/openclaw)
+
+  [English](#english) | [中文](#chinese)
+</div>
+
+---
+
+<a name="english"></a>
+## 🇬🇧 English
+
+### 📖 Introduction
+Redigg is an advanced autonomous research agent designed to accelerate scientific discovery. Built on the OpenClaw architecture, it acts as a tireless research assistant that can autonomously search for literature, analyze papers, explain complex concepts, and generate comprehensive PDF reports. It features a self-evolving memory system that learns from every interaction.
+
+### ✨ Key Features
+- **Autonomous Research**: Performs deep literature reviews, finding and summarizing relevant papers from the web.
+- **Auto-Research Loop**: Continuously improves research reports through iterative planning, critiquing, and refinement.
+- **Memory & Evolution**: Remembers past interactions and evolves its skills over time.
+- **Multi-Modal Output**: Generates structured markdown summaries and professional PDF reports.
+- **Code & Paper Analysis**: Can analyze local codebases and specific scientific papers in depth.
+
+### 🚀 Modes
+1.  **Research Chat**: Have a natural conversation with the agent. It will use its tools (search, analysis) as needed to answer your questions.
+2.  **Literature Review**: Ask for a review on a specific topic (e.g., "Literature review on LLM agents"). Redigg will scour the web for papers and synthesize a report.
+3.  **Auto-Research**: Enable "Auto Mode" to let Redigg iteratively refine a document. It will draft, critique, improve, and generate new PDF versions in a loop until satisfied.
+4.  **Concept Explainer**: Ask "Explain [Concept]" for a detailed, pedagogical breakdown of complex topics.
+
+### 🛠️ Quick Start
+
+**Prerequisites**: Node.js >= 22.0.0
+
+#### Option 1: Install via NPM (Recommended)
+
+```bash
+npm install -g @redigg/redigg
+redigg start
+```
+This will start the Gateway on `http://localhost:4000` (serving the Dashboard).
+
+#### Option 2: Run from Source
+
+1.  **Clone & Install**
+    ```bash
+    git clone https://github.com/redigg/redigg.git
+    cd redigg
+    npm install
+    ```
+
+2.  **Configure**
+    Copy `.env.example` to `.env` and add your OpenAI API Key:
+    ```bash
+    cp .env.example .env
+    # Edit .env file
+    ```
+
+3.  **Run**
+    Start both the backend gateway and frontend UI with a single command:
+    ```bash
+    npm run dev
+    ```
+    - **UI**: http://localhost:5173
+    - **Gateway**: http://localhost:4000
+
+### 💡 Examples
+- **"Perform a literature review on multi-agent reinforcement learning."** -> *Generates a summary and list of papers.*
+- **"Explain the concept of Transformer architecture."** -> *Provides a detailed explanation.*
+- **"Analyze this paper: [Title]"** -> *Deep dives into a specific paper.*
+- **"Auto-research: Future of AI in Healthcare (3 iterations)"** -> *Produces a refined PDF report after 3 rounds of self-improvement.*
+
+---
+
+<a name="chinese"></a>
+## 🇨🇳 中文 (Chinese)
+
+### 📖 简介
+Redigg 是一个专为加速科学发现而设计的先进自主研究智能体。基于 OpenClaw 架构构建，它就像一位不知疲倦的研究助手，能够自主搜索文献、分析论文、解释复杂概念，并生成专业的 PDF 报告。它具备自进化记忆系统，能够从每一次交互中学习并变得更强。
+
+### ✨ 核心功能
+- **自主研究**: 进行深度的文献综述，从网络上搜索并总结相关论文。
+- **自动研究闭环 (Auto-Research)**: 通过迭代式的规划、批判和优化，持续改进研究报告质量。
+- **记忆与进化**: 能够记住过去的交互，并随着时间推移进化其技能。
+- **多模态输出**: 生成结构化的 Markdown 摘要和专业的 PDF 报告。
+- **代码与论文分析**: 支持分析本地代码库结构以及深度解读特定科学论文。
+
+### 🚀 运行模式
+1.  **研究对话 (Research Chat)**: 与智能体进行自然对话。它会根据需要自动调用工具（搜索、分析）来回答你的问题。
+2.  **文献综述 (Literature Review)**: 指定一个主题（例如：“关于 LLM 智能体的文献综述”），Redigg 将全网搜寻论文并合成报告。
+3.  **自动研究 (Auto-Research)**: 开启“自动模式”，让 Redigg 迭代打磨文档。它会循环执行“起草-批判-改进-生成 PDF”的流程，直到达到满意的效果。
+4.  **概念解释 (Concept Explainer)**: 发送“Explain [概念]”，它会像教授一样详细拆解复杂的科学概念。
+
+### 🛠️ 快速开始
+
+**前置要求**: Node.js >= 22.0.0
+
+#### 方式 1: 通过 NPM 安装 (推荐)
+
+```bash
+npm install -g @redigg/redigg
+redigg start
+```
+这将在 `http://localhost:4000` 启动网关和界面。
+
+#### 方式 2: 源码运行
+
+1.  **克隆与安装**
+    ```bash
+    git clone https://github.com/redigg/redigg.git
+    cd redigg
+    npm install
+    ```
+
+2.  **配置**
+    复制 `.env.example` 为 `.env` 并填入你的 OpenAI API Key：
+    ```bash
+    cp .env.example .env
+    # 编辑 .env 文件
+    ```
+
+3.  **运行**
+    使用一条命令同时启动后端网关和前端界面：
+    ```bash
+    npm run dev
+    ```
+    - **界面 (UI)**: http://localhost:5173
+    - **网关 (Gateway)**: http://localhost:4000
+
+### 💡 使用示例
+- **"Perform a literature review on multi-agent reinforcement learning."** -> *生成论文摘要和列表。*
+- **"Explain the concept of Transformer architecture."** -> *提供详细的概念解释。*
+- **"Analyze this paper: [Title]"** -> *深入分析特定论文。*
+- **"Auto-research: Future of AI in Healthcare (3 iterations)"** -> *经过 3 轮自我优化后生成一份精炼的 PDF 报告。*
+
+---
+
+<div align="center">
+  <sub>Built with ❤️ by the Redigg AI Team</sub>
+</div>

package/dist/agent/ResearchAgent.d.ts

@@ -0,0 +1,35 @@
+import { MemoryManager } from '../memory/MemoryManager.js';
+import { MemoryEvolutionSystem } from '../memory/evolution/MemoryEvolutionSystem.js';
+import { LLMClient } from '../llm/LLMClient.js';
+import { SkillManager } from '../skills/SkillManager.js';
+import { SessionManager, Session } from '../session/SessionManager.js';
+import { CronManager } from '../scheduling/CronManager.js';
+import { EventManager } from '../events/EventManager.js';
+import { QualityManager } from '../quality/QualityManager.js';
+export declare class ResearchAgent {
+    memoryManager: MemoryManager;
+    private memoryEvo;
+    private skillEvo;
+    private llm;
+    skillManager: SkillManager;
+    sessionManager: SessionManager;
+    cronManager: CronManager;
+    eventManager: EventManager;
+    qualityManager: QualityManager;
+    private heartbeatInterval;
+    constructor(memoryManager: MemoryManager, memoryEvo: MemoryEvolutionSystem, llm: LLMClient, skillManager?: SkillManager);
+    private setupEventListeners;
+    start(): Promise<void>;
+    stop(): void;
+    private heartbeat;
+    chat(userId: string, message: string, onProgress?: (type: 'token' | 'log' | 'plan' | 'todo', content: any) => void, sessionId?: string, options?: {
+        autoMode?: boolean;
+    }): Promise<string>;
+    private createPlan;
+    private executeStep;
+    private handlePostProcessing;
+    executeLegacyLogic(session: Session, userId: string, message: string, log: (content: string, stats?: any) => void, onProgress?: (type: 'token' | 'log' | 'plan' | 'todo', content: any) => void): Promise<string>;
+    private generateSessionTitle;
+    private executeLiteratureReview;
+    private shouldSearch;
+}