@loxia-labs/loxia-autopilot-one 1.0.1

package/README.md

@@ -0,0 +1,509 @@
+<div align="center">
+
+# 🚀 Loxia Autopilot One
+
+**Autonomous AI Agent System for Software Development**
+
+[![npm version](https://img.shields.io/npm/v/loxia-autopilot-one.svg?style=flat-square)](https://www.npmjs.com/package/loxia-autopilot-one)
+[![Node.js Version](https://img.shields.io/node/v/loxia-autopilot-one.svg?style=flat-square)](https://nodejs.org)
+[![License: Commercial](https://img.shields.io/badge/License-Commercial-blue.svg?style=flat-square)](./LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](CONTRIBUTING.md)
+
+**[Quick Start](#-quick-start)** • **[Features](#-features)** • **[Documentation](#-documentation)** • **[Tools](#-ai-powered-tools)** • **[Web UI](#-web-interface)**
+
+</div>
+
+---
+
+## 🎯 What is Loxia Autopilot One?
+
+Loxia Autopilot One is a **production-ready autonomous AI agent system** that empowers developers with intelligent coding assistance. It combines the power of multiple AI models with a comprehensive toolkit for software development, code analysis, and automation.
+
+### Why Loxia?
+
+- 🤖 **Multi-Agent Orchestration** - Run multiple AI agents simultaneously with isolated workspaces
+- 🔧 **Rich Tool Ecosystem** - 18+ specialized tools for development, analysis, and automation
+- 🌐 **Dual Interface** - Modern Web UI + powerful CLI for any workflow
+- 📊 **Real-Time Monitoring** - Track agent activity, costs, and performance
+- 💾 **Persistent State** - Resume conversations and continue work across sessions
+- 🔒 **Secure by Design** - Agent isolation, resource limits, and security scanning
+
+---
+
+## ✨ Features
+
+### Core Capabilities
+
+<table>
+<tr>
+<td width="50%">
+
+#### 🤖 **Intelligent Agent System**
+- Multi-agent conversation orchestration
+- Automatic model selection and routing
+- Task-based agent specialization
+- Inter-agent communication
+- Background task management
+
+</td>
+<td width="50%">
+
+#### 🛠️ **Professional Tooling**
+- Terminal command execution
+- File system operations
+- Web browsing and scraping
+- Image generation (DALL-E, Flux)
+- Code analysis and refactoring
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+#### 📈 **Development Features**
+- Import/export analysis
+- Dependency resolution
+- Static code analysis
+- Clone detection
+- Security scanning
+
+</td>
+<td width="50%">
+
+#### 💡 **Smart Assistance**
+- Context-aware responses
+- File attachments in chat
+- Conversation compaction
+- Task management
+- Progress tracking
+
+</td>
+</tr>
+</table>
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+**Registration Required**: Loxia Autopilot One requires authentication to use. You'll need:
+- Active subscription or valid license
+- Authentication credentials from [loxia.ai](https://loxia.ai)
+
+**Not registered yet?** Visit [loxia.ai/register](https://loxia.ai/register) to create an account.
+
+### Installation
+
+```bash
+# Install globally via npm
+npm install -g loxia-autopilot-one
+
+# Start Loxia (you'll be prompted for credentials)
+loxia
+```
+
+On first run, you'll be prompted to enter your authentication credentials.
+
+The Web UI will automatically open at `http://localhost:8080`
+
+### CLI Options
+
+```bash
+loxia                 # Start with Web UI + CLI
+loxia --no-web        # CLI only
+loxia --web-only      # Web UI server only
+loxia --port 3000     # Custom port
+loxia --host 0.0.0.0  # Custom host binding
+loxia --help          # Show all options
+```
+
+### First Steps
+
+1. **Create an Agent**
+   ```bash
+   loxia> /create DevAssistant
+   ```
+
+2. **Start a Conversation**
+   ```
+   loxia:DevAssistant> Analyze the imports in my project
+   ```
+
+3. **Use Tools**
+   ```
+   loxia:DevAssistant> Run npm test and fix any failures
+   ```
+
+---
+
+## 🌐 Web Interface
+
+The modern Web UI provides an intuitive interface for managing agents and conversations:
+
+### Key Features
+
+- 💬 **Chat Interface** - Clean, responsive chat with markdown support
+- 📁 **File Attachments** - Drag and drop files into conversations
+- 🎛️ **Agent Management** - Create, switch, and manage multiple agents
+- 📊 **Real-Time Updates** - Live agent status and output streaming
+- 🎨 **Model Selection** - Switch between AI models on the fly
+- 📝 **Task Tracking** - Visual task lists with progress indicators
+- 🔍 **Search & Filter** - Find conversations and messages quickly
+- 🌓 **Modern UI** - Built with React, TailwindCSS, and WebSockets
+
+### Web UI Screenshots
+
+*Coming soon - the interface provides a clean, modern experience for interacting with AI agents*
+
+---
+
+## 🔧 AI-Powered Tools
+
+Loxia comes with 18+ specialized tools that agents can use autonomously:
+
+### Development Tools
+
+| Tool | Description | Key Features |
+|------|-------------|--------------|
+| 🖥️ **Terminal** | Execute shell commands | Background processes, stdin input, prompt detection |
+| 📂 **File System** | File operations | Create, read, update, delete files and directories |
+| 🌐 **Browser** | Web automation | Headless browsing, screenshots, scraping with Puppeteer |
+| 🔍 **Seek** | Code search | Pattern matching, multi-directory support |
+| 🌲 **File Tree** | Directory visualization | Tree structure generation, filtering |
+
+### Analysis Tools
+
+| Tool | Description | Key Features |
+|------|-------------|--------------|
+| 📦 **Import Analyzer** | Import/export analysis | ES6, CommonJS, circular dependencies, unused exports |
+| 🔗 **Dependency Resolver** | Dependency management | Semantic versioning, conflict detection, upgrade paths |
+| 🔬 **Static Analysis** | Code quality | ESLint, Prettier, TypeScript, Stylelint integration |
+| 👯 **Clone Detection** | Code duplication | AST-based analysis, similarity scoring |
+| 🔒 **Security Scanner** | Security audits | npm audit, dependency vulnerabilities, deployment checks |
+
+### AI & Automation Tools
+
+| Tool | Description | Key Features |
+|------|-------------|--------------|
+| 🖼️ **Image Generator** | AI image creation | DALL-E 3, Stable Diffusion, Flux support |
+| 📝 **Task Manager** | Task tracking | Todo lists, progress tracking, agent synchronization |
+| 📡 **Web Tool** | HTTP requests | GET, POST, API testing, webhook debugging |
+| 🔄 **File Content Replace** | Bulk replacements | Pattern-based, multi-file, preview changes |
+| 💬 **Agent Communication** | Inter-agent messaging | Task delegation, collaborative workflows |
+
+### System Tools
+
+| Tool | Description | Key Features |
+|------|-------------|--------------|
+| ⏸️ **Agent Delay** | Pause agent execution | Timed delays, background operation support |
+| ✅ **Job Done** | Task completion | Mark tasks complete, trigger workflows |
+| 🔧 **Async Tool Manager** | Background task handling | Long-running operations, status tracking |
+
+---
+
+## 📋 System Requirements
+
+- **Node.js**: >= 16.0.0 (18.x or 20.x LTS recommended)
+- **npm**: >= 7.0.0
+- **Operating System**: Windows, macOS, Linux
+- **Memory**: 2GB minimum, 4GB+ recommended
+- **Disk Space**: 500MB for package and dependencies
+
+### Optional Dependencies
+
+For full functionality, install these tools:
+
+```bash
+# Security scanning
+npm install -g eslint prettier typescript stylelint
+
+# For development
+npm install -g nodemon jest
+```
+
+---
+
+## 🏗️ Architecture
+
+### High-Level Overview
+
+```
+┌─────────────────────────────────────────────────┐
+│               Client Interfaces                 │
+│  ┌─────────────┐  ┌────────────────────────┐  │
+│  │   Web UI    │  │      CLI Interface     │  │
+│  │  (React)    │  │   (Interactive Shell)  │  │
+│  └─────────────┘  └────────────────────────┘  │
+└───────────────────┬─────────────────────────────┘
+                    │ WebSocket / IPC
+        ┌───────────▼──────────────┐
+        │   Orchestrator Service   │
+        │  (Request Coordination)  │
+        └────────┬────────┬────────┘
+                 │        │
+      ┌──────────▼──┐  ┌─▼──────────────┐
+      │ Agent Pool  │  │  AI Service    │
+      │ • Lifecycle │  │  • Model Router│
+      │ • Scheduling│  │  • Backend API │
+      └──────┬──────┘  └────────────────┘
+             │
+      ┌──────▼──────────────────────┐
+      │   Message Processor         │
+      │   • Tool Registry           │
+      │   • Command Extraction      │
+      │   • Execution Engine        │
+      └─────────────────────────────┘
+```
+
+### Key Components
+
+- **Orchestrator**: Central coordination hub for all requests
+- **Agent Pool**: Manages agent lifecycle, isolation, and communication
+- **Message Processor**: Parses and executes tool commands from AI responses
+- **AI Service**: Routes requests to appropriate AI backends
+- **State Manager**: Persistent storage and session management
+- **Tool Registry**: Extensible tool system with 18+ built-in tools
+
+---
+
+## 📖 Documentation
+
+### For Users
+
+- **[Installation Guide](./INSTALLATION.md)** - Detailed installation and setup
+- **[CLI Reference](./docs/CLI.md)** - Complete CLI command reference
+- **[Tool Documentation](./docs/TOOLS.md)** - How to use each tool
+- **[Configuration](./docs/CONFIGURATION.md)** - Environment variables and settings
+
+### For Developers
+
+- **[Architecture Overview](./docs/ARCHITECTURE.md)** - System design and components
+- **[API Reference](./docs/API.md)** - Backend API specification
+- **[Creating Tools](./docs/CREATING_TOOLS.md)** - Build custom tools
+- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute
+
+---
+
+## 🔐 Security & Privacy
+
+### Built-In Security Features
+
+- ✅ **Agent Isolation** - Each agent has isolated workspace and permissions
+- ✅ **Resource Limits** - Prevents resource exhaustion (CPU, memory, commands)
+- ✅ **Path Validation** - Prevents directory traversal attacks
+- ✅ **Command Sanitization** - Protects against command injection
+- ✅ **Security Scanning** - Built-in vulnerability detection
+- ✅ **Audit Logging** - Comprehensive activity logs
+
+### Privacy
+
+- 🔐 **Authentication Only** - Only credential verification communicates with servers
+- 🏠 **Local-First** - All work data stays on your machine
+- 🔒 **No Usage Telemetry** - No tracking or analytics of your work
+- 📝 **State Control** - Full control over conversation history
+- 🗑️ **Easy Cleanup** - Delete state directory to remove all local data
+- ✅ **Secure Communication** - Authentication data protected during transmission
+
+---
+
+## 🎯 Use Cases
+
+### Software Development
+
+```
+✓ Code refactoring and modernization
+✓ Dependency updates and conflict resolution
+✓ Test generation and debugging
+✓ Documentation generation
+✓ Code review automation
+```
+
+### Project Analysis
+
+```
+✓ Import/export dependency mapping
+✓ Circular dependency detection
+✓ Code duplication analysis
+✓ Security vulnerability scanning
+✓ Code quality assessment
+```
+
+### Automation
+
+```
+✓ Build and deployment scripts
+✓ Batch file operations
+✓ API testing and monitoring
+✓ Web scraping and data collection
+✓ Image generation workflows
+```
+
+---
+
+## 📊 Performance
+
+### Benchmarks
+
+- **Agent Response Time**: < 2s for simple queries
+- **Tool Execution**: < 100ms overhead per tool
+- **Memory Usage**: ~150-300MB per agent
+- **Concurrent Agents**: Up to 10 agents per instance
+- **Message Processing**: 1000+ messages/second
+
+### Conversation Compaction
+
+Loxia automatically compacts long conversations to stay within token limits:
+
+- **Intelligent Summarization** - Preserves context while reducing tokens
+- **Configurable Strategies** - Aggressive or balanced compaction
+- **Index Tracking** - References original message ranges for retrieval
+
+---
+
+## 🛣️ Roadmap
+
+### Current Version (1.0.0)
+
+- ✅ Multi-agent orchestration
+- ✅ 18+ specialized tools
+- ✅ Web UI + CLI interfaces
+- ✅ Conversation compaction
+- ✅ File attachments
+- ✅ Task management
+
+### Upcoming Features
+
+- 🔄 **VSCode Extension** - Native IDE integration
+- 🔄 **Plugin System** - Custom tool marketplace
+- 🔄 **Team Features** - Shared agents and workspaces
+- 🔄 **Cloud Sync** - Optional cloud backup (opt-in)
+- 🔄 **Voice Interface** - Speech-to-text integration
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Here's how you can help:
+
+### Ways to Contribute
+
+- 🐛 **Report Bugs** - Open an issue with reproduction steps
+- 💡 **Suggest Features** - Share ideas for improvements
+- 📝 **Improve Documentation** - Fix typos, add examples
+- 🔧 **Build Tools** - Create new tools for the ecosystem
+- 🎨 **UI/UX** - Enhance the Web interface
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/loxia-ai/autopilot-cli-v10.git
+cd autopilot-cli-v10
+
+# Install dependencies
+npm install
+
+# Build Web UI
+cd web-ui && npm install && npm run build && cd ..
+
+# Start in development mode
+npm run dev
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
+
+---
+
+## 📜 License
+
+**Commercial License** - see [LICENSE](./LICENSE) file for complete terms.
+
+### Key Terms
+
+- 🔐 **Authentication Required** - Valid subscription or license needed to use
+- ✅ **Commercial Use** - Use in your own projects and services (with active subscription)
+- ✅ **Modify Configuration** - Customize settings and configuration files
+- ❌ **No Free Use** - Requires active subscription or valid license
+- ❌ **No Credential Sharing** - Personal credentials cannot be shared
+- ❌ **No Redistribution** - Cannot resell, redistribute, or sublicense
+- ❌ **No Reverse Engineering** - Code is obfuscated and protected
+- ❌ **No Derivative Products** - Cannot create competing products
+
+### Subscription & Access
+
+- **Registration**: Sign up at [loxia.ai/register](https://loxia.ai/register)
+- **Authentication**: Software requires valid credentials to operate
+- **Verification**: Periodic authentication checks with licensing server
+- **Expiration**: Access ends when subscription expires (renewable)
+
+**Copyright © 2025 Loxia AI. All rights reserved.**
+
+By installing or using this software, you agree to the terms of the [LICENSE](./LICENSE).
+
+---
+
+## 🆘 Support
+
+### Getting Help
+
+- 📖 **Documentation**: Check the [docs](./docs/) directory
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/loxia-ai/autopilot-cli-v10/discussions)
+- 🐛 **Bug Reports**: [GitHub Issues](https://github.com/loxia-ai/autopilot-cli-v10/issues)
+- 📧 **Email**: support@loxia.ai
+
+### Troubleshooting
+
+**Web UI won't start?**
+```bash
+# Check if port is in use
+lsof -i :8080
+
+# Use a different port
+loxia --port 3000
+```
+
+**Agent not responding?**
+```bash
+# Check logs
+cat .loxia-state/logs/system.log
+
+# Restart with debug logging
+LOXIA_LOG_LEVEL=debug loxia
+```
+
+**Installation issues?**
+```bash
+# Clear npm cache
+npm cache clean --force
+
+# Reinstall
+npm install -g loxia-autopilot-one --force
+```
+
+---
+
+## 🌟 Acknowledgments
+
+Built with love using:
+
+- [Node.js](https://nodejs.org/) - Runtime environment
+- [Express](https://expressjs.com/) - Web server framework
+- [React](https://reactjs.org/) - UI framework
+- [Puppeteer](https://pptr.dev/) - Browser automation
+- [TailwindCSS](https://tailwindcss.com/) - Styling
+- [WebSockets](https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API) - Real-time communication
+
+Special thanks to the open-source community for the amazing tools and libraries that make this project possible.
+
+---
+
+<div align="center">
+
+**Made with ❤️ by the Loxia team**
+
+[Website](https://loxia.ai) • [Twitter](https://twitter.com/loxia_ai) • [Discord](https://discord.gg/loxia)
+
+⭐ **Star us on GitHub** if you find this project useful!
+
+</div>

package/bin/cli.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+
+/**
+ * Loxia Autopilot One - CLI Entry Point
+ *
+ * This is the executable entry point for the `loxia` command.
+ * It parses CLI arguments and launches the system with appropriate configuration.
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { spawn } from 'child_process';
+import { readFileSync } from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Parse CLI arguments
+const args = process.argv.slice(2);
+const flags = {
+  noWeb: args.includes('--no-web'),
+  webOnly: args.includes('--web-only'),
+  port: null,
+  host: null,
+  help: args.includes('--help') || args.includes('-h'),
+  version: args.includes('--version') || args.includes('-v')
+};
+
+// Extract port and host if provided
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--port' && args[i + 1]) {
+    flags.port = parseInt(args[i + 1], 10);
+  }
+  if (args[i] === '--host' && args[i + 1]) {
+    flags.host = args[i + 1];
+  }
+}
+
+// Show version
+if (flags.version) {
+  const pkgPath = join(__dirname, '..', 'package.json');
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+  console.log(`Loxia Autopilot One v${pkg.version}`);
+  process.exit(0);
+}
+
+// Show help
+if (flags.help) {
+  console.log(`
+Loxia Autopilot One - AI Agent System
+
+Usage:
+  loxia [options]
+
+Options:
+  --no-web          Start CLI only (disable Web UI)
+  --web-only        Start Web UI server only (no interactive CLI)
+  --port <number>   Specify port for Web UI (default: 8080)
+  --host <host>     Specify host for Web UI (default: 0.0.0.0)
+  -h, --help        Show this help message
+  -v, --version     Show version number
+
+Examples:
+  loxia                    # Start with CLI and Web UI
+  loxia --no-web           # Start CLI only
+  loxia --web-only         # Start Web UI server only
+  loxia --port 3000        # Use custom port
+  loxia --host localhost   # Use custom host
+
+Documentation:
+  https://github.com/loxia-ai/autopilot-one
+
+`);
+  process.exit(0);
+}
+
+// Set environment variables based on flags
+const env = { ...process.env };
+
+if (flags.noWeb) {
+  env.LOXIA_DISABLE_WEB = 'true';
+}
+
+if (flags.webOnly) {
+  env.LOXIA_WEB_ONLY = 'true';
+}
+
+if (flags.port) {
+  env.LOXIA_PORT = flags.port.toString();
+}
+
+if (flags.host) {
+  env.LOXIA_HOST = flags.host;
+}
+
+// Launch the main application
+const mainScript = join(__dirname, '..', 'src', 'index.js');
+
+const child = spawn('node', [mainScript], {
+  stdio: 'inherit',
+  env,
+  cwd: join(__dirname, '..')
+});
+
+// Forward signals
+process.on('SIGINT', () => {
+  child.kill('SIGINT');
+});
+
+process.on('SIGTERM', () => {
+  child.kill('SIGTERM');
+});
+
+// Exit with same code as child process
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});