aggroot 1.0.0

package/.env.example

@@ -0,0 +1,173 @@
+# ============================================
+# AggRoot Node.js AI Assistant - Environment Configuration
+# ============================================
+# This is a template file. Copy to .env and fill in your actual values.
+# Never commit .env file to version control.
+
+# Application Environment
+# ----------------------
+# Options: development, production, test
+NODE_ENV=development
+
+# AggRoot Home Directory (optional)
+# ------------------------------
+# Override the default ~/.aggroot data directory.
+# Useful for running multiple isolated instances:
+#   AGGROOT_HOME=~/.aggroot-project-a aggroot -d /path/to/project-a
+#   AGGROOT_HOME=~/.aggroot-project-b aggroot -d /path/to/project-b
+# Default: ~/.aggroot
+# AGGROOT_HOME=
+
+# Logging Configuration
+# ---------------------
+# Log level: debug, info, warn, error, fatal
+LOG_LEVEL=info
+
+# AI Provider Configuration
+# -------------------------
+# DeepSeek API (default provider)
+DEEPSEEK_API_KEY=your_deepseek_api_key_here
+DEEPSEEK_BASE_URL=https://api.deepseek.com
+
+# OpenAI API (alternative provider)
+OPENAI_API_KEY=your_openai_api_key_here
+OPENAI_BASE_URL=https://api.openai.com/v1
+
+# ZhipuGLM API (智谱 AI)
+ZHIPU_API_KEY=your_zhipu_api_key_here
+ZHIPU_BASE_URL=https://open.bigmodel.cn/api/paas/v4
+
+# Kimi API (Moonshot AI)
+KIMI_API_KEY=your_kimi_api_key_here
+KIMI_BASE_URL=https://api.moonshot.cn/v1
+
+# Ollama (Local Models)
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL_NAME=llama3.2
+OLLAMA_CONTEXT_LENGTH=4096
+
+# Claude API (via OpenAI-compatible endpoint)
+CLAUDE_API_KEY=your_claude_api_key_here
+CLAUDE_BASE_URL=https://api.anthropic.com/v1
+
+# MiniMax API
+MINIMAX_API_KEY=your_minimax_api_key_here
+MINIMAX_BASE_URL=https://api.minimaxi.com/v1
+
+# NVIDIA NIM API (OpenAI-compatible)
+NVIDIA_API_KEY=your_nvidia_api_key_here
+NVIDIA_BASE_URL=https://integrate.api.nvidia.com/v1
+# Per-model API keys (optional, override NVIDIA_API_KEY for specific models)
+# Format: NVIDIA_API_KEY_{MODEL_ID} where MODEL_ID is uppercased with / . replaced by _
+# Examples:
+#   NVIDIA_API_KEY_Z_AI_GLM_51=nvapi-xxxx
+#   NVIDIA_API_KEY_DEEPSEEK_AI_DEEPSEEK_R1=nvapi-xxxx
+#   NVIDIA_API_KEY_META_LLAMA_3_3_70B_INSTRUCT=nvapi-xxxx
+#   NVIDIA_API_KEY_NVIDIA_LLAMA_3_1_NEMOTRON_70B_INSTRUCT=nvapi-xxxx
+#   NVIDIA_API_KEY_QWEN_QWEN25_72B_INSTRUCT=nvapi-xxxx
+#   NVIDIA_API_KEY_QWEN_QWEN25_CODER_32B_INSTRUCT=nvapi-xxxx
+# Per-model base URLs (optional, override NVIDIA_BASE_URL)
+#   NVIDIA_BASE_URL_QWEN_QWEN25_CODER_32B_INSTRUCT=https://integrate.api.nvidia.com/v1
+
+
+# Shell Configuration
+# -------------------
+# Default shell for command execution
+# Options: auto (platform default), powershell, cmd, bash, nushell, wsl
+# auto: uses powershell on Windows, bash on Linux/Mac
+DEFAULT_SHELL=nushell
+
+# Execution Timeouts
+# ------------------
+# Maximum execution time for shell commands (milliseconds)
+SHELL_TIMEOUT=30000
+
+# Maximum execution time for code execution (seconds)
+CODE_EXECUTION_TIMEOUT=30
+
+# Web Tools Configuration
+# -----------------------
+# Browser type for web automation: chromium, firefox, webkit
+BROWSER_TYPE=chromium
+
+# Headless mode for browser (true/false)
+BROWSER_HEADLESS=true
+
+# Domain Reputation Check APIs
+# ----------------------------
+# Google Safe Browsing API Key (https://console.cloud.google.com/apis/api/safebrowsing.googleapis.com)
+GOOGLE_SAFE_BROWSING_API_KEY=
+
+# VirusTotal API Key (https://www.virustotal.com/gui/my-apikey)
+VIRUSTOTAL_API_KEY=
+
+# PhishTank API Key (optional, https://www.phishtank.com/developer_info.php)
+PHISHTANK_API_KEY=
+
+# OWASP ZAP Configuration
+# -----------------------
+# ZAP API URL (default: http://localhost:8080)
+ZAP_API_URL=http://localhost:8080
+
+# ZAP API Key (if configured)
+ZAP_API_KEY=
+
+# Session Management
+# ------------------
+# Maximum session history to keep (number of messages)
+MAX_SESSION_HISTORY=50
+
+# Session timeout (minutes)
+SESSION_TIMEOUT=60
+
+# File Operations
+# ---------------
+# Maximum file size to read (bytes)
+MAX_FILE_SIZE=10485760  # 10MB
+
+# Allowed file extensions for code execution
+ALLOWED_FILE_EXTENSIONS=.js,.ts,.py,.json,.txt,.md
+
+# Security Settings
+# -----------------
+# Enable safe mode for code execution (true/false)
+SAFE_MODE=true
+
+NODE_OPTIONS=--max-old-space-size=4096
+
+# List of dangerous commands to block
+DANGEROUS_COMMANDS=rm -rf,format,del /f /q,shutdown,reboot
+
+# Development Settings
+# --------------------
+# Enable debug mode for verbose output
+DEBUG=false
+
+AGGROOT_UI="ink-custom"
+
+# Enable experimental features
+EXPERIMENTAL_FEATURES=false
+
+# Vision Service (Image Understanding)
+# ------------------------------------
+# Enable vision service for image analysis (true/false)
+VISION_ENABLED=false
+
+# Vision API endpoint (OpenAI-compatible)
+# SiliconFlow: https://api.siliconflow.cn/v1
+# DashScope: https://dashscope.aliyuncs.com/compatible-mode/v1
+# vLLM local: http://localhost:6000/v1
+VISION_ENDPOINT=
+
+# Vision API key
+VISION_API_KEY=
+
+# Vision model name
+VISION_MODEL=Qwen/Qwen3-VL-8B-Instruct
+
+# ============================================
+# Notes:
+# 1. Copy this file to .env and fill in your actual values
+# 2. Never commit .env file to version control
+# 3. Required variables: DEEPSEEK_API_KEY or OPENAI_API_KEY
+# ============================================

package/README.md

@@ -0,0 +1,43 @@
+# AggRoot - AI Coding Assistant
+
+A powerful, extensible AI coding assistant built with Node.js and TypeScript.
+
+## Features
+
+- **Multi-Model Support** - DeepSeek, OpenAI GPT, Claude, Ollama, Qwen, Kimi, and more
+- **Intelligent Code Tools** - Read, Write, Edit, Grep, Glob with syntax-aware processing
+- **Shell Execution** - Run commands with cross-platform support (Bash, PowerShell, NuShell)
+- **Sub-Agent System** - Delegate tasks to specialized agents (explore, plan, code-review)
+- **Document Reading** - Word (.docx), PowerPoint (.pptx), Excel (.xlsx), images, PDFs
+- **Git Integration** - Status, diff, log, blame, and more
+- **Web Tools** - Search and fetch web content
+- **MCP Protocol** - Connect external tools via Model Context Protocol
+- **Plugin Architecture** - Hot-pluggable DDD-based plugin system
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g aggroot-node
+
+# Run
+aggroot
+```
+
+## Configuration
+
+Create a `.env` file in your project directory:
+
+```env
+DEEPSEEK_API_KEY=your-api-key
+# or
+OPENAI_API_KEY=your-api-key
+```
+
+## Requirements
+
+- Node.js >= 20.0.0
+
+## License
+
+MIT

package/dist/cli.cjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+// AggRoot CLI wrapper - ensures Node.js heap is large enough for long sessions.
+const v8 = require('node:v8');
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+const heapLimitMB = Math.round(v8.getHeapStatistics().heap_size_limit / 1024 / 1024);
+
+if (heapLimitMB < 3500 && !process.env.AGGROOT_SPAWNED) {
+  // Re-spawn with larger heap, inheriting stdio for seamless UX
+  const child = spawn(process.execPath, [
+    '--max-old-space-size=4096',
+    '--no-warnings',
+    path.resolve(__dirname, 'index.cjs'),
+    ...process.argv.slice(2),
+  ], {
+    stdio: 'inherit',
+    env: { ...process.env, AGGROOT_SPAWNED: '1' },
+  });
+  child.on('exit', (code) => process.exit(code ?? 0));
+} else {
+  require('./index.cjs');
+}