@fortressllm/sybil 0.0.3

package/README.md

@@ -0,0 +1,281 @@
+# Sybil - Advanced Autonomous AI Agent
+
+<p align="center">
+  <img src="assets/logo.png" alt="Sybil Logo" width="400" />
+</p>
+
+An advanced autonomous AI agent built with [Mastra](https://mastra.ai).
+
+## Core Features
+
+🤖 **17+ AI Providers**: OpenAI, Anthropic, Google, NVIDIA, Groq, Mistral, xAI, DeepSeek, Perplexity, Cohere, Hugging Face, Together AI, Fireworks AI, Cerebras, OpenRouter, and Ollama.
+
+🧠 **Vector Memory System**: LibSQL-based vector storage with FastEmbed embeddings for semantic search and intelligent memory retrieval.
+
+🤖 **Agent Networks**: 4 specialized AI agents (Planner, Researcher, Executor, WhatsApp) coordinated by an intelligent Routing agent for complex multi-step workflows.
+
+🔧 **Dynamic Tools**: Create custom tools on demand with automatic code generation and validation (33+ tools available).
+
+📚 **Dynamic Skills**: Learn new capabilities from user interactions with persistent skill storage and activation.
+
+🖥️ **Browser Control**: Full Playwright-based web browsing with page interaction, screenshots, form filling, and HTML-to-Markdown conversion.
+
+🔐 **OTP Authentication**: Secure 6-digit one-time password system for user verification and access control.
+
+📱 **Multi-Platform Messaging**: Telegram bot with streaming responses + WhatsApp Web integration with auto-reply capabilities.
+
+💬 **Streaming Responses**: Real-time message streaming with live progress feedback and step-by-step execution visibility.
+
+🗂️ **Sandboxed Workspace**: File operations with Podman containerized execution for safe code execution and workspace isolation.
+
+💾 **CLI Tools**: Interactive TUI and 12 command-line management tools for complete bot administration.
+
+## Quick Start
+
+### Interactive Setup (Recommended)
+```bash
+# Complete setup in one command
+sybil init
+
+# Follow the interactive wizard:
+# 1. Enter Telegram Bot Token
+# 2. Choose AI provider
+# 3. Add API key
+# 4. Configure WhatsApp (optional)
+```
+
+### Manual Setup
+
+#### 1. Install Dependencies
+```bash
+npm install
+```
+
+#### 2. Create Telegram Bot (Required)
+```bash
+# Open Telegram and message @BotFather
+# Send: /newbot
+# Follow prompts to create your bot
+# Copy the bot token (starts with a number followed by a colon)
+```
+
+#### 3. Configure Environment
+```bash
+cp .env.example .env
+# Edit .env with your credentials
+```
+
+#### 4. Environment Variables
+```env
+# Required: Telegram Bot Token (get from @BotFather)
+TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxyz
+
+# Optional: Podman Workspace Configuration (for MCP server)
+PODMAN_AGENT_ID=your-agent-id
+PODMAN_WORKSPACE_DIR=/path/to/workspace
+```
+
+#### 5. Start Bot
+```bash
+npm start
+# OR use CLI
+sybil start
+```
+
+#### 6. Connect to Bot
+```bash
+# Find your bot on Telegram and start a chat
+# Bot will welcome you and guide next steps
+```
+
+### 3. Start
+
+```bash
+npm start
+```
+
+### 4. Connect Your Telegram Bot
+
+```bash
+# Start a chat with your bot on Telegram
+# Your bot will welcome you and ask for authentication
+```
+
+### 5. Authenticate Users (Optional)
+
+For secure access control:
+
+```bash
+sybil otp
+# Generate OTP → Share 6-digit code → User sends code to your bot
+```
+
+## CLI & TUI Commands
+
+### Interactive Terminal Interface
+```bash
+sybil # Launch interactive TUI menu (no arguments)
+```
+
+### Available Commands (12 total)
+
+| Command | Description |
+|---------|-------------|
+| `sybil init` | Interactive setup wizard with configuration prompts |
+| `sybil start` | Start the bot service |
+| `sybil stop` | Stop the bot service |
+| `sybil status` | Check bot status and health |
+| `sybil doctor` | Run system diagnostics and health checks |
+| `sybil config` | Manage configuration (edit, list, validate) |
+| `sybil logs` | View and filter bot logs |
+| `sybil backup` | Create backup of data and configuration |
+| `sybil restore` | Restore from backup |
+| `sybil update` | Update Sybil to latest version |
+| `sybil whatsapp` | Manage WhatsApp connection and sessions |
+| `sybil otp` | OTP authentication management |
+
+### Usage Examples
+```bash
+# Interactive mode (shows TUI menu)
+sybil
+
+# Setup and configuration
+sybil init
+sybil config --edit
+
+# Service management
+sybil start
+sybil status
+sybil stop
+
+# Authentication
+sybil otp                    # Interactive OTP menu
+sybil otp --generate         # Generate new OTP code
+
+# Monitoring
+sybil logs --follow          # Live log streaming
+sybil doctor                 # System health check
+
+# WhatsApp management
+sybil whatsapp               # Interactive WhatsApp menu
+
+# Backup and maintenance
+sybil backup
+sybil update
+```
+
+### Quick Commands
+```bash
+# Setup & Management
+sybil init         # Interactive setup wizard
+sybil start        # Start bot
+sybil stop         # Stop bot
+sybil status       # Check status
+sybil doctor       # System diagnostics
+
+# Authentication
+sybil otp --generate     # Generate OTP for user
+sybil otp --list        # List pending/authorized users
+sybil otp --revoke 123  # Revoke user access
+
+# Configuration
+sybil config --edit     # Interactive config
+sybil config --list     # Show all settings
+
+# Monitoring
+sybil logs --follow     # Live logs
+sybil whatsapp --status # WhatsApp connection
+```
+
+## Telegram Commands
+
+### Basic Commands
+```
+/start          - Welcome message and bot introduction
+/help           - Show all available commands
+/status         - View your usage statistics and session info
+/memory         - Show what the bot remembers about you
+```
+
+### AI Provider Commands
+```
+/model          - Change AI provider/model (interactive selection)
+/models         - List all available AI providers
+```
+
+### Task Execution Commands
+```
+/plan <goal>    - Create a structured execution plan for complex tasks
+/network <task> - Execute multi-agent coordinated tasks
+/research <topic> - Activate research mode for information gathering
+```
+
+### Tool & Skill Management
+```
+/create-tool    - Generate a new custom tool dynamically
+/list-tools    - View all available tools
+/create-skill  - Create a new skill for specialized tasks
+/list-skills   - View and activate available skills
+```
+
+### WhatsApp Integration
+```
+/whatsapp      - Check WhatsApp connection status
+/whatsapp-send - Send a WhatsApp message
+```
+
+### Session Modes
+```
+/plan          - Switch to planning mode for complex tasks
+/research      - Switch to research mode for information gathering
+/agent         - Switch to agent network mode
+/normal        - Return to normal chat mode
+```
+/start          - Welcome
+/help           - Commands
+/plan <goal>    - Create plan
+/network <task>  - Multi-agent task
+/status         - Your stats
+/memory         - What I remember
+/model <provider> - Change AI model
+
+/create-tool    - New tool
+/create-skill    - New skill
+/list-tools     - All tools
+
+/whatsapp       - WhatsApp status
+```
+
+## Documentation
+
+### Quick Start
+- 📖 [Getting Started](docs/tutorials/getting-started.md) - Complete setup and installation guide
+- 💻 [CLI Guide](docs/cli-tui.md) - Interactive terminal interface and command reference
+- 🔐 [OTP Authentication](TELEGRAM_OTP_AUTH.md) - User access control and verification
+
+### Tutorials
+- 🌐 [Web Browsing](docs/tutorials/web-browsing.md) - Browser automation with Playwright
+- 🤖 [Agent Networks](docs/tutorials/agent-networks.md) - Multi-agent coordination and workflows
+- 🔧 [Dynamic Tools](docs/tutorials/dynamic-tools.md) - Tool creation and management
+- 📚 [Skills System](docs/tutorials/skills.md) - Dynamic skill creation and activation
+
+### Architecture
+- 🏗️ [Architecture Overview](docs/architecture/overview.md) - High-level system architecture
+- 🧠 [Memory System](docs/architecture/memory.md) - Vector memory and semantic search
+- 🤖 [Agent Networks](docs/architecture/agent-networks.md) - Agent coordination and routing
+- 🔧 [Tools System](docs/architecture/tools.md) - Tool registry and dynamic loading
+
+### API Reference
+- 🖥️ [Browser Tools](docs/api/browser-tools.md) - Web automation API
+- 🤖 [Agents](docs/api/agents.md) - Agent configuration and usage
+- 🧠 [Memory](docs/api/memory.md) - Memory system API
+- 📚 [Skills](docs/tutorials/skills.md) - Skills API (see tutorials)
+- 🔧 [Tools](docs/architecture/tools.md) - Tool system reference
+
+### Configuration
+- 📋 [Environment Variables](.env.example) - Complete environment configuration
+- 🗂️ [Podman Workspace](src/tools/podman-workspace-mcp.ts) - Sandboxed execution configuration
+
+## License
+
+MIT

package/RENAME_LOG.md

@@ -0,0 +1,62 @@
+# Sybil - Autonomous AI Agent
+
+**Renamed from sybil to Sybil** ✅  
+**Date:** February 12, 2026
+
+---
+
+## 🔄 Renaming Summary
+
+The project has been successfully renamed from **sybil** to **Sybil**, inspired by the anime "Psycho-Pass" where Sibyl is the omniscient AI system that judges humanity.
+
+### Files Updated
+
+1. **`package.json`** - Project name and CLI binary
+2. **`src/cli.ts`** - CLI interface with new banner and terminology
+3. **`src/index.ts`** - Log file path
+4. **`src/utils/logger.ts`** - Log file configuration
+5. **`src/utils/whatsapp-client.ts`** - Data directory paths
+6. **`src/workspace/index.ts`** - Workspace identifiers
+7. **`src/processors/index.ts`** - Documentation comments
+8. **`src/tools/extended-tools.ts`** - Documentation comments
+9. **`CLI_GUIDE.md`** - Complete CLI documentation
+10. **`plan.md`** - Project planning document
+11. **`PROGRESS.md`** - Progress tracking
+12. **`README.md`** - Project documentation
+
+### Changes Made
+
+#### 🎨 Visual Identity
+- **New Banner:** "SYBIL" ASCII art in CLI
+- **New Colors:** Magenta accent instead of yellow
+- **New Terminology:** "Agent" instead of "Bot"
+
+#### 📁 File Structure
+- **Log Files:** `./logs/sybil.log` → `./logs/sybil.log`
+- **Data Directory:** `~/.sybil/` → `~/.sybil/`
+- **Workspace:** "sybil Workspace" → "Sybil Workspace"
+
+#### 🎯 Terminology Updates
+- **Bot** → **Agent**
+- **sybil** → **Sybil**
+- **Bot Status** → **Agent Status**
+- **Start Bot** → **Start Agent**
+
+#### 📋 CLI Changes
+```bash
+# Old
+sybil
+
+# New
+sybil
+```
+
+### Build Status
+✅ **Successful** - TypeScript compilation completed without errors
+
+### Next Steps
+- Update any external references to the old name
+- Verify all functionality works as expected with new name
+- Update documentation references if needed
+
+The transition from sybil to Sybil is now complete! 🎉

package/SIMPLIFIED_TELEGRAM_UX.md

@@ -0,0 +1,273 @@
+# Simplified Telegram UX Implementation
+
+**Status:** ✅ COMPLETED  
+**Date:** February 12, 2026  
+**Priority:** 🔴 High
+
+---
+
+## Overview
+
+Significantly simplified the Telegram user experience to make it extremely straightforward for users while maintaining all core functionality.
+
+---
+
+## Key UX Improvements
+
+### 1. Authentication Flow
+
+**Before:**
+```
+🔐 Authentication Required
+
+To start chatting with Sybil, you need to authenticate.
+
+1. Ask the administrator to run: `sybil otp`
+2. They will see a 6-digit code on screen
+3. Send that code here
+
+This is a one-time setup for security.
+```
+
+**After:**
+```
+🔐 Send 6-digit code from admin to unlock Sybil Bot
+```
+
+### 2. Post-Authentication Welcome
+
+**Before:**
+```
+✅ Authentication successful!
+
+Welcome to Sybil! I'm your autonomous AI assistant. Type /help to see what I can do.
+```
+
+**After:**
+```
+✅ Welcome to Sybil!
+
+I'm your autonomous AI assistant. Just start chatting with me!
+
+Type /help for commands.
+```
+
+### 3. Help Command
+
+**Before:** Long, detailed help with 15+ sections
+
+**After:**
+```
+🤖 Sybil Commands
+
+📝 Planning:
+/plan <goal> - Create action plan
+/network <task> - Multi-agent task
+
+🧠 Learning:
+/create-tool <desc> - Make new tool
+/create-skill <desc> - Learn new skill
+/list-tools - Show all tools
+/list-skills - Show all skills
+
+📱 WhatsApp:
+/whatsapp - Check connection
+/whatsapp-send <num> <msg> - Send message
+
+⚙️ System:
+/status - Your stats
+/memory - What I remember
+/model <provider> - Change AI model
+
+Just type anything to chat normally!
+```
+
+### 4. Start Command
+
+**Before:** Long welcome message with 10+ bullet points
+
+**After:**
+```
+👋 Hi! I'm Sybil, your AI assistant.
+
+I can:
+• 🧠 Remember our chats
+• 📋 Plan & do tasks
+• 🎓 Learn new skills
+• 🌐 Research online
+• 📱 Send WhatsApp messages
+
+💬 Just start chatting or use /help for commands!
+```
+
+### 5. Network Command Response
+
+**Before:** Static "Processing..." message
+
+**After:** Real-time streaming updates:
+- Shows "🌐 Thinking..." initially
+- Updates message as response builds
+- Shows progress every 100 characters
+- Final "✅ Done:" message with full response
+
+---
+
+## Technical Implementation
+
+### 1. Streamlined Message Handler
+
+```typescript
+// Authentication check simplified
+if (!isAuthenticated(chatId)) {
+  if (text.match(/^\d{6}$/)) {
+    // Handle OTP verification
+    if (verifyOTP(chatId, text.trim())) {
+      // Simple welcome
+      await bot.sendMessage(chatId, "✅ Welcome to Sybil!\n\nJust start chatting!");
+    } else {
+      // Simple error
+      await bot.sendMessage(chatId, "❌ Invalid code.\n\nAsk your admin for a new code.");
+    }
+  } else {
+    // Simple instruction
+    await bot.sendMessage(chatId, "🔐 Send 6-digit code from admin to unlock Sybil Bot");
+  }
+  return;
+}
+```
+
+### 2. Real-time Network Responses
+
+```typescript
+// Stream network responses with live updates
+const msg = await bot.sendMessage(chatId, `🌐 Thinking...`);
+
+let fullText = "";
+await streamWithNetwork(task, threadId, resourceId, (chunk: any) => {
+  if (chunk.type === "text-delta") {
+    fullText += chunk.payload.text;
+    
+    // Update every 100 chars for live feedback
+    if (fullText.length % 100 < 20 && fullText.length > 100) {
+      bot.editMessageText(`🌐 ${fullText.substring(0, 800)}...`, {
+        chat_id: chatId,
+        message_id: msg.message_id
+      }).catch(() => {});
+    }
+  }
+});
+
+// Final response
+await bot.editMessageText(`✅ Done:\n\n${fullText}`, {
+  chat_id: chatId,
+  message_id: msg.message_id
+});
+```
+
+---
+
+## Benefits
+
+✅ **Ultra-Simple Authentication** - One-line instruction  
+✅ **Immediate Feedback** - Live streaming responses  
+✅ **Concise Help** - Organized, scannable commands  
+✅ **Friendly Tone** - Conversational language  
+✅ **Progressive Disclosure** - Details only when needed  
+✅ **Clear Actions** - Direct, actionable instructions  
+✅ **Visual Clarity** - Emoji-based section headers  
+✅ **Fast Onboarding** - From 5 steps to 1 step  
+
+---
+
+## User Journey
+
+### New User:
+1. Receives: `🔐 Send 6-digit code from admin to unlock Sybil Bot`
+2. Sends OTP: `123456`
+3. Receives: `✅ Welcome to Sybil! Just start chatting!`
+
+### Regular User:
+1. Types: `Can you help me plan a trip?`
+2. Sees: `🌐 Thinking...` (immediate feedback)
+3. Sees updates as response builds
+4. Receives final: `✅ Done: Here's your travel plan...`
+
+### Power User:
+1. Types: `/help`
+2. Sees organized command list
+3. Uses specific commands like `/plan` or `/network`
+
+---
+
+## Comparison Metrics
+
+| Aspect | Before | After | Improvement |
+|--------|--------|-------|-------------|
+| Auth Steps | 3 steps + explanation | 1 step | 66% simpler |
+| Help Length | 50+ lines | 25 lines | 50% shorter |
+| Welcome Msg | 150 words | 50 words | 66% shorter |
+| Response Feedback | None until complete | Live updates | Real-time |
+| Cognitive Load | High (many options) | Low (focused) | Much easier |
+
+---
+
+## Testing
+
+Build successful ✅
+
+```bash
+npm run build
+# No compilation errors
+```
+
+Manual testing:
+```bash
+# Test authentication flow
+# 1. Unauthenticated user gets simple instruction
+# 2. Valid OTP grants immediate access
+# 3. Invalid OTP gives clear error
+# 4. /help shows simplified commands
+# 5. /network shows live progress
+```
+
+---
+
+## Integration Points
+
+### With Existing Systems:
+
+- **Authentication:** Uses existing OTP system
+- **Streaming:** Leverages existing network streaming
+- **Commands:** All existing functionality preserved
+- **Memory:** No changes to session/memory handling
+- **Logging:** Preserved existing logging structure
+
+### No Breaking Changes:
+- All existing commands still work
+- Authentication system unchanged
+- Network processing unchanged
+- Only UX presentation improved
+
+---
+
+## Future Enhancements
+
+- [ ] Voice message support
+- [ ] Quick reply buttons for common commands
+- [ ] Typing indicators for all responses
+- [ ] Auto-suggested commands
+- [ ] Contextual help based on user history
+- [ ] Multilingual support
+
+---
+
+## References
+
+- **Telegram Bot API:** https://core.telegram.org/bots/api
+- **UX Principles:** Progressive disclosure, minimal cognitive load
+- **Messaging Patterns:** Immediate feedback, clear actions
+
+---
+
+**Completed by:** OpenCode Agent  
+**Last Updated:** February 12, 2026