@fortressllm/sybil 0.0.3

package/.env copy

@@ -0,0 +1,91 @@
+# Environment Variables for sybil
+
+# Required
+TELEGRAM_BOT_TOKEN=8532380565:AAEDH2NMymW5LmgIPuZWkEC0zHfC-5r5jX4
+
+
+# ============================================
+# AI Provider Configuration
+# ============================================
+# Choose your AI provider: openai, ollama, or ollama-cloud
+# AI_PROVIDER=openai
+
+# # --- OpenAI Configuration (default) ---
+# OPENAI_API_KEY=your_openai_api_key_here
+# OPENAI_MODEL=gpt-4o
+
+# --- Ollama (Local) Configuration ---
+# Uncomment and configure to use local Ollama instead of OpenAI
+# AI_PROVIDER=ollama
+# OLLAMA_MODEL=rnj-1
+# OLLAMA_BASE_URL=http://localhost:11434/api
+
+
+
+# AI_PROVIDER=custom
+# CUSTOM_BASE_URL=http://dhuvis-pc.local:1234/v1
+# CUSTOM_MODEL=openai/gpt-oss-20b
+# CUSTOM_API_KEY=sk-lm-ENRKUndS:GWGo6fh9Wi6sfqjdBqdK
+
+
+# CUSTOM_BASE_URL=https://integrate.api.nvidia.com/v1
+# CUSTOM_MODEL=moonshotai/kimi-k2.5
+# CUSTOM_API_KEY=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
+
+
+
+
+# curl http://localhost:1234/api/v1/chat \
+#   -H "Content-Type: application/json" \
+#   -d '{
+#     "model": "zai-org/glm-4.6v-flash:2",
+#     "system_prompt": "You answer only in rhymes.",
+#     "input": "What is your favorite color?"
+# }'
+
+# --- NVIDIA AI Configuration ---
+AI_PROVIDER=nvidia
+NVIDIA_API_KEY=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
+NVIDIA_MODEL=openai/gpt-oss-120b
+
+# --- Ollama Cloud Configuration ---
+# Uncomment and configure to use Ollama Cloud
+# AI_PROVIDER=ollama-cloud
+# OLLAMA_API_KEY=your_ollama_cloud_api_key_here
+# OLLAMA_CLOUD_MODEL=ollama-cloud/cogito-2.1:671b
+
+# ============================================
+# Optional Settings
+# ============================================
+DATABASE_URL=file:./mastra.db
+
+# ============================================
+# Vector & Semantic Search Configuration
+# ============================================
+# Embedding model for semantic memory search
+# Options: openai/text-embedding-3-small, openai/text-embedding-3-large,
+#          openai/text-embedding-ada-002, google/gemini-embedding-001
+EMBEDDING_MODEL=nvidia/nvidia/nv-embed-v1
+# Semantic Recall Configuration (optional)
+SEMANTIC_RECALL_TOPK=5        # Number of similar messages to retrieve
+SEMANTIC_RECALL_RANGE=2       # Messages before/after each match
+
+
+PODMAN_WORKSPACE_DIR=/Users/davindersingh/projects/dokkubot/workspace
+PODMAN_AGENT_ID=sybil-agent-007
+
+
+# Enable/disable
+WHATSAPP_AUTOREPLY_ENABLED=true
+# Mode: manual (pending approval), auto (always send), smart (confidence-based)
+WHATSAPP_AUTOREPLY_MODE=smart
+# Debounce time in minutes (1-30)
+WHATSAPP_AUTOREPLY_DEBOUNCE_MINUTES=1
+# Max replies per hour per contact
+WHATSAPP_AUTOREPLY_MAX_REPLIES_PER_HOUR=10
+# Comma-separated phone numbers
+# WHATSAPP_AUTOREPLY_WHITELIST=1234567890,9876543210
+WHATSAPP_AUTOREPLY_BLACKLIST=1111111111,2222222222
+# Custom context and instructions
+WHATSAPP_AUTOREPLY_USER_CONTEXT="I'm a busy professional"
+WHATSAPP_AUTOREPLY_CUSTOM_INSTRUCTIONS="Reply concisely and professionally"

package/.env.example

@@ -0,0 +1,139 @@
+# Environment Variables for sybil
+
+# Required
+TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here
+
+# ============================================
+# AI Provider Configuration
+# ============================================
+# Choose your AI provider: openai, ollama, or ollama-cloud
+AI_PROVIDER=ollama
+
+# --- Ollama (Local) Configuration (RECOMMENDED - Free & Private! 🏠) ---
+AI_PROVIDER=ollama
+OLLAMA_MODEL=llama3.2
+OLLAMA_BASE_URL=http://localhost:11434
+
+# --- OpenAI Configuration ---
+# AI_PROVIDER=openai
+# OPENAI_API_KEY=your_openai_api_key_here
+# OPENAI_MODEL=gpt-4o
+
+# --- Ollama Cloud Configuration ---
+# AI_PROVIDER=ollama-cloud
+# OLLAMA_API_KEY=your_ollama_cloud_api_key_here
+# OLLAMA_CLOUD_MODEL=ollama-cloud/cogito-2.1:671b
+
+# --- NVIDIA AI Configuration ---
+# AI_PROVIDER=nvidia
+# NVIDIA_API_KEY=your_nvidia_api_key_here
+# NVIDIA_MODEL=nvidia/llama-3.1-nemotron-70b-instruct
+
+# --- Anthropic (Claude) Configuration ---
+# AI_PROVIDER=anthropic
+# ANTHROPIC_API_KEY=your_anthropic_api_key_here
+# ANTHROPIC_MODEL=claude-4-5-sonnet
+
+# --- Google Gemini Configuration ---
+# AI_PROVIDER=google
+# GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key_here
+# GOOGLE_MODEL=gemini-2.5-flash
+
+# --- DeepSeek Configuration ---
+# AI_PROVIDER=deepseek
+# DEEPSEEK_API_KEY=your_deepseek_api_key_here
+# DEEPSEEK_MODEL=deepseek-r1
+
+# --- Groq (Fast!) Configuration ---
+# AI_PROVIDER=groq
+# GROQ_API_KEY=your_groq_api_key_here
+# GROQ_MODEL=llama-3.3-70b-versatile
+
+# --- Mistral AI Configuration ---
+# AI_PROVIDER=mistral
+# MISTRAL_API_KEY=your_mistral_api_key_here
+# MISTRAL_MODEL=mistral-large-latest
+
+# --- xAI (Grok) Configuration ---
+# AI_PROVIDER=xai
+# XAI_API_KEY=your_xai_api_key_here
+# XAI_MODEL=grok-4
+
+# --- Perplexity Configuration ---
+# AI_PROVIDER=perplexity
+# PERPLEXITY_API_KEY=your_perplexity_api_key_here
+# PERPLEXITY_MODEL=llama-3.1-sonar-small-128k-online
+
+# --- Cohere Configuration ---
+# AI_PROVIDER=cohere
+# COHERE_API_KEY=your_cohere_api_key_here
+# COHERE_MODEL=command-r-plus
+
+# --- Hugging Face Configuration ---
+# AI_PROVIDER=huggingface
+# HUGGINGFACE_API_KEY=your_huggingface_api_key_here
+# HUGGINGFACE_MODEL=meta-llama/Llama-3.2-90B-Vision-Instruct
+
+# --- Together AI Configuration ---
+# AI_PROVIDER=togetherai
+# TOGETHER_API_KEY=your_together_api_key_here
+# TOGETHERAI_MODEL=meta-llama/Llama-3.3-70B-Instruct-Turbo
+
+# --- Fireworks AI Configuration ---
+# AI_PROVIDER=fireworks-ai
+# FIREWORKS_API_KEY=your_fireworks_api_key_here
+# FIREWORKS_MODEL=accounts/fireworks/models/llama-3.3-70b-instruct
+
+# --- Cerebras Configuration ---
+# AI_PROVIDER=cerebras
+# CEREBRAS_API_KEY=your_cerebras_api_key_here
+# CEREBRAS_MODEL=cerebras/llama-3.3-70b
+
+# --- OpenRouter Configuration ---
+# AI_PROVIDER=openrouter
+# OPENROUTER_API_KEY=your_openrouter_api_key_here
+# OPENROUTER_MODEL=anthropic/claude-haiku-4-5
+
+# --- Custom OpenAI-Compatible Configuration ---
+# AI_PROVIDER=custom
+# CUSTOM_BASE_URL=http://your-custom-endpoint.com/v1
+# CUSTOM_MODEL=your-model-name
+# CUSTOM_API_KEY=your-api-key
+
+# ============================================
+# Vector & Semantic Search Configuration
+# ============================================
+# Embedding model for semantic memory search
+# Options: openai/text-embedding-3-small, openai/text-embedding-3-large,
+#          openai/text-embedding-ada-002, google/gemini-embedding-001
+EMBEDDING_MODEL=openai/text-embedding-3-small
+
+# Semantic Recall Configuration (optional)
+SEMANTIC_RECALL_TOPK=5        # Number of similar messages to retrieve
+SEMANTIC_RECALL_RANGE=2       # Messages before/after each match
+
+# ============================================
+# Optional Settings
+# ============================================
+DATABASE_URL=file:./mastra.db
+
+# ============================================
+# Podman Workspace Configuration (Optional)
+# ============================================
+# Configuration for Podman sandbox MCP server
+# PODMAN_AGENT_ID=your-agent-id
+# PODMAN_WORKSPACE_DIR=/path/to/workspace
+
+# ============================================
+# WhatsApp Web Configuration
+# ============================================
+# Custom Puppeteer executable path (if needed)
+# PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
+
+# ============================================
+# Session Persistence
+# ============================================
+# WhatsApp sessions and settings are automatically saved to:
+# - ~/.sybil/whatsapp-session/ (WhatsApp Web session)
+# - ~/.sybil/settings.json (bot settings)
+#

package/BROWSER_CONTROL.md

@@ -0,0 +1,354 @@
+# Browser Control & HTML to Markdown Conversion
+
+**Status:** ✅ COMPLETED  
+**Date:** February 12, 2026  
+
+---
+
+## Overview
+
+Successfully added complete browser automation and HTML to Markdown conversion capabilities to all Sybil agents. Agents can now browse the web, interact with websites, and save content as clean Markdown files.
+
+---
+
+## Browser Tools Implemented
+
+### Core Browsing Tools (11 tools):
+
+1. **`browser-screenshot`**
+   - Take screenshots of web pages
+   - Save to file or return as base64
+   - Full page or viewport capture
+
+2. **`browser-navigate`**
+   - Navigate to URLs
+   - Track page load time
+   - Return page title and URL
+
+3. **`browser-get-content`** ⭐ **ENHANCED**
+   - Extract text content from pages
+   - Include HTML output option
+   - **NEW: Include Markdown output option** ✨
+   - Use CSS selectors for specific elements
+
+4. **`browser-execute-script`**
+   - Run JavaScript on pages
+   - Return execution results
+   - For dynamic content and interactions
+
+5. **`browser-click`**
+   - Click elements by CSS selector
+   - Navigate before clicking
+   - Handle JavaScript-triggered actions
+
+6. **`browser-type`**
+   - Type text into input fields
+   - Clear field before typing
+   - Fill forms automatically
+
+7. **`browser-wait-for`**
+   - Wait for elements to appear
+   - Multiple wait states (visible, attached, hidden, detached)
+   - Configurable timeout
+
+8. **`browser-get-links`**
+   - Extract all links from a page
+   - Get href and text for each link
+   - Useful for site mapping
+
+9. **`browser-google-search`** ⭐ **NEW**
+   - Perform Google searches
+   - Return top 10 results
+   - Get titles, URLs, and snippets
+
+10. **`browser-scroll-to`**
+    - Scroll to elements
+    - Scroll by pixels
+    - Scroll to top/center/bottom
+
+11. **`browser-close-session`**
+    - Close browser sessions
+    - Clean up resources
+    - Manage multiple concurrent sessions
+
+
+### Markdown Conversion Tools (2 tools):
+
+1. **`html-to-markdown`** ⭐ **NEW**
+   - Convert HTML to Markdown format
+   - Clean, readable output
+   - Word count included
+   - ATX headings, fenced code blocks
+
+2. **`browser-save-content`** ⭐ **NEW**
+   - Extract page content as Markdown
+   - Save to workspace `.md` files
+   - Auto-generate filename with title
+   - Overwrite protection
+
+---
+
+## Integration
+
+### Added to All Agents:
+
+✅ **Autonomous Agent** - Full browsing capabilities  
+✅ **Researcher Agent** - Web research & fact-checking  
+✅ **Executor Agent** - Task execution with automation  
+✅ **Planner Agent** - Navigate complex workflows  
+✅ **WhatsApp Agent** - Can now browse for contact info  
+✅ **Routing Agent** - Coordinates web-based tasks  
+
+---
+
+## Usage Examples
+
+### Basic Navigation & Content Extraction
+```typescript
+// Navigate to a page
+await browserNavigate({ url: "https://example.com" });
+
+// Extract content with Markdown
+const result = await browserGetContent({ 
+  url: "https://example.com",
+  includeMarkdown: true,
+  includeHTML: true,
+});
+```
+
+**Returns:**
+```json
+{
+  "success": true,
+  "title": "Example Domain",
+  "url": "https://example.com",
+  "content": "Example Domain...",,
+  "html": "<!DOCTYPE html>...",
+  "markdown": "# Example Domain\n\nThis domain..."
+}
+```
+
+### Google Search
+```typescript
+// Search Google
+const results = await browserGoogleSearch({ 
+  query: "AI trends 2026" 
+});
+```
+
+**Returns:**
+```json
+{
+  "success": true,
+  "query": "AI trends 2026",
+  "results": [
+    { "title": "AI Trends...", "url": "...", "snippet": "..." },
+    // ... up to 10 results
+  ]
+}
+```
+
+### Save Page as Markdown
+```typescript
+// Save entire page
+await browserSaveContent({
+  url: "https://example.com/article",
+  filename: "my-article",  // Saves as workspace/my-article.md
+  overwrite: true,
+});
+
+// Save specific section
+await browserSaveContent({
+  url: "https://example.com/article",
+  selector: "article",
+  filename: "article-section",
+});
+```
+
+**Returns:**
+```json
+{
+  "success": true,
+  "filepath": "/path/to/workspace/my-article.md",
+  "wordCount": 1523
+}
+```
+
+### Convert HTML to Markdown
+```typescript
+// Convert HTML string
+const result = await htmlToMarkdown({
+  html: "<h1>Title</h1><p>Content</p>"
+});
+```
+
+**Returns:**
+```json
+{
+  "success": true,
+  "markdown": "# Title\n\nContent",
+  "wordCount": 2
+}
+```
+
+### Form Automation
+```typescript
+// Navigate and fill form
+await browserNavigate({ url: "https://example.com/form" });
+await browserType({ 
+  selector: "#name", 
+  text: "John Doe" 
+});
+await browserType({ 
+  selector: "#email", 
+  text: "john@example.com" 
+});
+await browserClick({ 
+  selector: "button[type='submit']" 
+});
+```
+
+---
+
+## Features
+
+### Browser Session Management:
+- **Multiple Sessions:** Create isolated browser sessions with different session IDs
+- **Concurrent Use:** Multiple pages per session
+- **Auto Cleanup:** Automatically closes browsers on process exit
+- **Resource Management:** Efficient handling of browser instances
+
+### Markdown Conversion:
+- **Clean Formatting:** Well-structured Markdown output
+- **Preserves Structure:** Headings, lists, code blocks, links
+- **ATX Headings:** `# H1`, `## H2`, etc.
+- **Fenced Code Blocks:** \`\`\` code blocks
+- **Character Encoding:** UTF-8 support
+
+### Configuration:
+```bash
+# Environment Variables
+BROWSER_HEADLESS=false    # Show browser (default: true for headless)
+```
+
+### Turndown Options:
+- **headings:** ATX style (`# H1`, `## H2`)
+- **code blocks:** Fenced code blocks (\`\`\`)
+- **horizontal rule:** `---`
+- **strikethrough:** `~~text~~`
+- **emphasis:** bold `**text**`, italic `_text_`
+- **links:** `[text](url)`
+
+### Page Content Formats:
+- **Text:** Plain text content
+- **HTML:** Full HTML source
+- **Markdown:** Clean readable format
+- **Screenshots:** Base64 images
+
+---
+
+## Capabilities for Agents
+
+### Research Agent:
+```typescript
+// Agent can research and save articles
+await browserGoogleSearch({ query: "latest AI research papers" });
+await browserNavigate({ url: "https://arxiv.org/..." });
+await browserSaveContent({ filename: "ai-research" });
+await browserCloseSession();
+```
+
+### Executor Agent:
+```typescript
+// Agent can complete web-based tasks
+await browserNavigate({ url: "https://example.com/dashboard" });
+await browserClick({ selector: "#create-button" });
+await browserType({ selector: "#input-name", text: "Task Name" });
+await browserScreenshot({});
+```
+
+### Autonomous Agent:
+```typescript
+// Agent can browse and learn from the web
+await browserNavigate({ url: "https://docs.python.org/3/tutorial" });
+const content = await browserGetContent({ 
+  url: "https://docs.python.org/3/tutorial",
+  includeMarkdown: true 
+});
+const md = await htmlToMarkdown({ html: content.html });
+// Use markdown in learning process
+```
+
+---
+
+## File System Integration
+
+### Supported Operations:
+- **Extract to Markdown:** Save web content as `.md` files
+- **Workspace Storage:** Files saved to `./workspace/` directory
+- **Title Extraction:** Auto-generates Markdown title from page title
+- **Selective Saving:** Save specific elements using CSS selectors
+- **Overwrite Protection:** Prevent accidental file overwrites
+
+### Example:
+```bash
+./workspace/
+├── my-article.md           # Full page saved
+├── article-section.md      # Specific section
+└── research-notes.md       # Search result saved
+```
+
+---
+
+## Dependencies Installed
+
+- ✅ **playwright** - Browser automation framework
+- ✅ **turndown** - HTML to Markdown converter
+- ✅ **@types/turndown** - TypeScript types
+
+---
+
+## Benefits
+
+✅ **Web Automation** - Agents can browse and interact with websites  
+✅ **Content Conversion** - HTML to clean Markdown  
+✅ **Research Capabilities** - Google search and content extraction  
+✅ **Task Automation** - Form filling and clicking  
+✅ **Screenshot Capture** - Visual state documentation  
+✅ **Multi-Session** - Multiple browser instances  
+✅ **File Saving** - Archive web content as Markdown  
+✅ **Session Management** - Clean resource handling  
+✅ **Headless Option** - Run visible or invisible browsers  
+
+---
+
+## Testing
+
+Build successful ✅
+
+```bash
+npm run build
+# No compilation errors
+```
+
+Chromium browser installed ✅
+
+```bash
+npx playwright install chromium
+# Browser binaries downloaded
+```
+
+---
+
+## Next Steps
+
+- Consider adding visual testing capabilities
+- Add retry logic for flaky network operations
+- Implement browser-specific user agents
+- Add cookie/session management for logged-in state
+- Add headless/visible mode toggle
+
+---
+
+**Completed by:** OpenCode Agent  
+**Last Updated:** February 12, 2026