@poolzin/pool-bot 2026.3.9 → 2026.3.11

package/CHANGELOG.md

@@ -1,3 +1,38 @@
+## v2026.3.11 (2026-03-11)
+
+### Features
+- **Mavalie Plugin Template:** new example plugin `extensions/mavalie/` demonstrating proper PoolBot plugin structure
+  - Minimal valid plugin using `poolbot/plugin-sdk` with `emptyPluginConfigSchema()`
+  - TypeScript entry point with jiti transpilation support
+  - Provider registration example with API key authentication pattern
+  - Comprehensive README with plugin development guidelines
+
+---
+
+## v2026.3.10 (2026-03-10)
+
+### Features
+- **Telemetry Alert System:** intelligent alerting engine for proactive monitoring
+  - Real-time alert evaluation with configurable thresholds
+  - Built-in rules for cron failures, security scans, swarm tasks, gateway health
+  - Webhook and announce channel notifications
+  - Alert history tracking with automatic cleanup
+- **Swarm State Persistence:** swarm task state now persisted to `~/.poolbot/swarm-state.json`
+  - Survives gateway restarts without losing task queue
+  - Automatic state recovery on startup
+- **HexStrike Bridge Telemetry:** comprehensive metrics for HexStrike AI integration
+  - Request latency tracking with histograms
+  - Rate limiting with configurable thresholds
+  - Health check monitoring with automatic failover
+- **Critical Bug Fix:** telemetry service now properly starts with gateway (was missing `await`)
+
+### Improvements
+- Optimized alert thresholds for production workloads
+- Enhanced gateway instrumentation with memory and CPU metrics
+- Improved error handling in telemetry pipeline
+
+---
+
 ## v2026.3.9 (2026-03-09)
 
 ### Features

package/README.md

@@ -1,123 +1,201 @@
 # 🎱 Pool Bot
 
-> Your AI pool of knowledge
+> **The AI Gateway for Teams That Need More Than Chatbots**
 
-**Pool Bot** is a professional AI assistant with advanced PLCODE integrations and development-focused features.
+Pool Bot transforms your messaging apps into a powerful AI command center. Connect Claude, GPT, Gemini, and local models to WhatsApp, Telegram, Discord, Slack, Signal, and 15+ other channels—then extend with custom skills for your specific workflows.
+
+[![npm version](https://img.shields.io/npm/v/@poolzin/pool-bot)](https://www.npmjs.com/package/@poolzin/pool-bot)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-docs.poolbot.dev-green)](https://docs.poolbot.dev)
 
 ![Pool Bot](README-header.png)
 
-## 🌟 What Makes Pool Bot Different
+---
 
-- 🎱 **PLCODE Integration** - Native support for coding workflows
-- 🧠 **Enhanced Memory** - Advanced context management
-- 🛠️ **Developer Tools** - Built for development teams
-- 🔒 **Private & Secure** - Your data, your control
-- 🌐 **Multi-Channel Support** - WhatsApp, Telegram, Discord, Slack, Signal, and more
+## ✨ What Makes Pool Bot Different
 
-## Installation
+| Feature | What It Means For You |
+|---------|----------------------|
+| **🧩 Modular Skills System** | Add capabilities via YAML-based skills—no coding required for most extensions |
+| **🌐 Universal Gateway** | One AI backend, unlimited channels. Add new messaging platforms without reconfiguration |
+| **🧠 Advanced Memory** | MMR reranking, temporal decay, hybrid search—conversations that actually remember context |
+| **⚡ Provider Infrastructure** | Multi-key pools, intelligent rate limiting, automatic failover across 10+ LLM providers |
+| **🔒 Security-First** | Command approval workflows, audit logging, PII detection, configurable guardrails |
+| **📱 Device Control** | Pair iOS/Android devices for remote automation, screenshots, and notifications |
 
-```bash
-npm install -g @poolzin/pool-bot
-poolbot --help
-```
+---
 
-## Quick Start
+## 🚀 Quick Start
 
 ```bash
+# Install globally
+npm install -g @poolzin/pool-bot
+
 # Start the gateway
 poolbot gateway start
 
-# Connect WhatsApp
-poolbot channels login
+# Connect your first channel
+poolbot channels login whatsapp
 
-# Check status
+# Check everything is running
 poolbot status
 ```
 
-## Features
+**That's it.** Your AI assistant is now available on WhatsApp. Add more channels anytime.
 
-- 🌐 **Multi-Channel Support** - WhatsApp, Telegram, Discord, Slack, Signal, and more
-- 🤖 **AI Agents** - Claude, GPT, Gemini, and local models
-- 🧠 **Memory System** - Context-aware conversations with semantic search
-- 📱 **Node Pairing** - Control iOS/Android devices remotely
-- 🎨 **Canvas** - Visual browser automation
-- 🔧 **Skills System** - Extensible plugin architecture
-- 📊 **PLCODE Dashboard** - Real-time development metrics
+---
+
+## 📡 Supported Channels
 
-## Documentation
+**Messaging Platforms:**
+WhatsApp • Telegram • Discord • Slack • Signal • iMessage • Facebook Messenger • Instagram • LINE • Matrix • Mattermost • Zalo • Microsoft Teams
 
-Full documentation is available at [docs.poolbot.dev](https://docs.poolbot.dev)
+**Voice & Web:**
+Web Interface • WebRTC • Voice Calls
 
-## Skills
+**Custom:**
+Webhooks • API • Custom integrations via skills
 
-Pool Bot supports an extensible skills system:
+---
 
-- 🎮 **WebGPU Three.js TSL** - 3D development with WebGPU
-- 🔍 **GitHub Integration** - Issues, PRs, and CI management
-- 🌦️ **Weather** - Current weather and forecasts
-- 📧 **Notion** - Database and page management
-- 🐦 **X/Twitter** - Social media engagement
-- And more...
+## 🤖 Supported AI Providers
 
-See [skills directory](skills/) for the full list.
+| Provider | Models | Features |
+|----------|--------|----------|
+| **Anthropic** | Claude 3.5/3 Opus/Sonnet/Haiku | Full tool use, vision, extended thinking |
+| **OpenAI** | GPT-4o, GPT-4, GPT-3.5 | Function calling, vision, DALL-E |
+| **Google** | Gemini 1.5 Pro/Flash | Multimodal, 1M+ context window |
+| **Groq** | Llama 3, Mixtral | Ultra-fast inference |
+| **Ollama** | Local models | Privacy-first, offline capable |
+| **Together** | 50+ open models | Mixtral, Llama, Qwen, and more |
+| **OpenRouter** | 100+ models | Unified API for multiple providers |
+| **Mistral** | Mistral Large/Medium/Small | European AI, GDPR compliant |
+| **Cohere** | Command R/R+ | Enterprise-focused |
+| **AI21** | Jamba/Jurassic | Long context specialist |
 
-## Companion Apps
+---
 
-Official companion apps for connecting devices to your Pool Bot gateway:
+## 🛠️ Skills System
 
-- **[Pool Apps](https://github.com/plcunha/pool-apps)** - Windows, Android, iOS nodes
-  - 🪟 **Windows Node v2** (Python) - Local LLM, STT/TTS, automation
-  - 📱 **Android** - Native mobile app
-  - 🍎 **iOS/macOS** - Apple ecosystem apps
+Pool Bot's unique skill system lets you add capabilities without touching core code:
 
-## Configuration
+```yaml
+# Example: Weather Skill (skills/weather/SKILL.md)
+---
+name: weather
+description: Get weather forecasts
+tools:
+  - name: get_weather
+    description: Get current weather for a location
+    parameters:
+      location: string
+      units: enum[celsius, fahrenheit]
+---
+```
 
-Pool Bot uses a profile-based configuration system:
+**Built-in Skills:**
+- 🎮 **WebGPU Three.js** - 3D development and visualization
+- 🔍 **GitHub** - Issues, PRs, CI/CD management
+- 🌦️ **Weather** - Current conditions and forecasts
+- 📝 **Notion** - Database and page management
+- 🐦 **X/Twitter** - Social media automation
+- 📧 **Gmail** - Email management
+- 📅 **Calendar** - Schedule management
+- 🔐 **1Password** - Secure credential access
+- 🎨 **Canvas** - Visual browser automation
+- 🖼️ **Image Generation** - DALL-E, Stable Diffusion integration
 
-```bash
-# Use default profile
-poolbot gateway start
+**Create your own:** See [Creating Skills](https://docs.poolbot.dev/skills/creating)
 
-# Use custom profile
-poolbot --profile production gateway start
+---
 
-# Use dev profile (isolated state)
-poolbot --dev gateway start
-```
+## 🏗️ Architecture Highlights
+
+### Provider Infrastructure
+- **Multi-key pools** - Rotate across multiple API keys for higher rate limits
+- **Intelligent routing** - Route by model capability, cost, or latency
+- **Automatic failover** - Seamless fallback when providers degrade
+- **Usage tracking** - Per-key, per-model cost analytics
+
+### Memory System
+- **Semantic search** - Find relevant context across conversation history
+- **MMR reranking** - Diverse, non-redundant context retrieval
+- **Temporal decay** - Recent conversations weighted higher
+- **Hybrid search** - Combine vector similarity with keyword matching
+
+---
 
-## Development
+## 📱 Companion Apps
+
+Extend Pool Bot to your devices:
+
+| Platform | Features | Repository |
+|----------|----------|------------|
+| **Windows** | Local LLM, STT/TTS, automation, system control | [pool-apps](https://github.com/plcunha/pool-apps) |
+| **Android** | Native messaging, notifications, device automation | [pool-apps](https://github.com/plcunha/pool-apps) |
+| **iOS/macOS** | Apple ecosystem integration, Shortcuts support | [pool-apps](https://github.com/plcunha/pool-apps) |
+
+---
+
+## 💻 Development
 
 ```bash
-# Clone repository
+# Clone and setup
 git clone https://github.com/plcunha/pool-bot.git
 cd pool-bot
-
-# Install dependencies
 pnpm install
 
+# Development mode
+pnpm dev
+
 # Build
 pnpm build
 
 # Run tests
 pnpm test
 
-# Start gateway
-node dist/entry.js gateway
+# Lint and format
+pnpm lint
+pnpm format
 ```
 
-## Support
+---
+
+## 📚 Documentation
+
+- **[Getting Started](https://docs.poolbot.dev/getting-started)** - Installation and first steps
+- **[Configuration](https://docs.poolbot.dev/configuration)** - Profiles, channels, and providers
+- **[Skills](https://docs.poolbot.dev/skills)** - Built-in and custom skills
+- **[Architecture](https://docs.poolbot.dev/architecture)** - Mesh networking, memory, security
+- **[API Reference](https://docs.poolbot.dev/api)** - REST API and webhooks
+- **[Deployment](https://docs.poolbot.dev/deployment)** - Docker, cloud, and self-hosting
+
+---
+
+## 🔐 Security
+
+- **Command Approval** - Require human approval for destructive operations
+- **Audit Logging** - Complete trace of all AI actions
+- **PII Detection** - Automatic redaction of sensitive data
+- **Sandboxed Execution** - Isolated environment for untrusted skills
+- **End-to-End Encryption** - For supported channels
+
+See [Security Documentation](https://docs.poolbot.dev/security)
+
+---
+
+## 🤝 Community
+
+- **Discord:** [discord.gg/poolbot](https://discord.gg/poolbot)
+- **GitHub Issues:** [Report bugs, request features](https://github.com/plcunha/pool-bot/issues)
+- **Discussions:** [Q&A, show and tell](https://github.com/plcunha/pool-bot/discussions)
 
-- **Documentation**: https://docs.poolbot.dev
-- **GitHub Issues**: https://github.com/plcunha/pool-bot/issues
-- **Community**: https://discord.com/discord.gg/poolbot
+---
 
-## Author
+## 📄 License
 
-João Vitor Cunha dos Santos
-- Email: jvsantos.cunha@gmail.com
-- GitHub: @plcunha
-- Telegram: @poolzin
+MIT License - see [LICENSE](LICENSE) file for details.
 
-## License
+---
 
-MIT License - see LICENSE file for details
+**Made with 🎱 by [João Vitor Cunha](https://github.com/plcunha)**

package/dist/.buildstamp

@@ -1 +1 @@
-1773025806569
+1773140740628

package/dist/agents/error-classifier.js

@@ -13,38 +13,15 @@ const OPENAI_PATTERNS = {
         /too many tokens/i,
         /rate_limit_exceeded.*context/i,
     ],
-    rate_limit: [
-        /rate limit exceeded/i,
-        /too many requests/i,
-        /ratelimit/i,
-    ],
-    authentication: [
-        /invalid api key/i,
-        /incorrect api key/i,
-        /authentication/i,
-        /unauthorized/i,
-    ],
-    invalid_request: [
-        /invalid_request_error/i,
-        /bad request/i,
-        /invalid parameter/i,
-    ],
+    rate_limit: [/rate limit exceeded/i, /too many requests/i, /ratelimit/i],
+    authentication: [/invalid api key/i, /incorrect api key/i, /authentication/i, /unauthorized/i],
+    invalid_request: [/invalid_request_error/i, /bad request/i, /invalid parameter/i],
 };
 // Anthropic error patterns
 const ANTHROPIC_PATTERNS = {
-    context_overflow: [
-        /context window exceeded/i,
-        /maximum token count/i,
-        /too many tokens/i,
-    ],
-    rate_limit: [
-        /rate limit/i,
-        /too many requests/i,
-    ],
-    authentication: [
-        /invalid api key/i,
-        /authentication failed/i,
-    ],
+    context_overflow: [/context window exceeded/i, /maximum token count/i, /too many tokens/i],
+    rate_limit: [/rate limit/i, /too many requests/i],
+    authentication: [/invalid api key/i, /authentication failed/i],
     authorization: [
         /forbidden/i,
         /access denied/i,
@@ -54,21 +31,9 @@ const ANTHROPIC_PATTERNS = {
 };
 // Google/Gemini error patterns
 const GEMINI_PATTERNS = {
-    context_overflow: [
-        /token limit exceeded/i,
-        /maximum input size/i,
-        /context too long/i,
-    ],
-    rate_limit: [
-        /rate limit exceeded/i,
-        /quota exceeded/i,
-        /too many requests/i,
-    ],
-    quota_exceeded: [
-        /quota exceeded/i,
-        /billing limit/i,
-        /project quota/i,
-    ],
+    context_overflow: [/token limit exceeded/i, /maximum input size/i, /context too long/i],
+    rate_limit: [/rate limit exceeded/i, /quota exceeded/i, /too many requests/i],
+    quota_exceeded: [/quota exceeded/i, /billing limit/i, /project quota/i],
 };
 // Generic patterns
 const GENERIC_PATTERNS = {
@@ -80,37 +45,11 @@ const GENERIC_PATTERNS = {
         /message too long/i,
         /input too long/i,
     ],
-    rate_limit: [
-        /rate.?limit/i,
-        /too many requests/i,
-        /throttled/i,
-        /429/i,
-    ],
-    timeout: [
-        /timeout/i,
-        /timed out/i,
-        /etimedout/i,
-    ],
-    network_error: [
-        /network error/i,
-        /econnreset/i,
-        /econnrefused/i,
-        /enotfound/i,
-        /network/i,
-    ],
-    server_error: [
-        /server error/i,
-        /internal error/i,
-        /500/i,
-        /502/i,
-        /503/i,
-        /504/i,
-    ],
-    compaction_failure: [
-        /compaction failed/i,
-        /summarization failed/i,
-        /failed to compact/i,
-    ],
+    rate_limit: [/rate.?limit/i, /too many requests/i, /throttled/i, /429/i],
+    timeout: [/timeout/i, /timed out/i, /etimedout/i],
+    network_error: [/network error/i, /econnreset/i, /econnrefused/i, /enotfound/i, /network/i],
+    server_error: [/server error/i, /internal error/i, /500/i, /502/i, /503/i, /504/i],
+    compaction_failure: [/compaction failed/i, /summarization failed/i, /failed to compact/i],
 };
 /**
  * Classify an error based on message patterns
@@ -125,7 +64,12 @@ export function classifyError(error) {
     }
     const message = error.message.toLowerCase();
     // Check context overflow first (highest priority for LLM errors)
-    for (const pattern of [...OPENAI_PATTERNS.context_overflow, ...ANTHROPIC_PATTERNS.context_overflow, ...GEMINI_PATTERNS.context_overflow, ...GENERIC_PATTERNS.context_overflow]) {
+    for (const pattern of [
+        ...OPENAI_PATTERNS.context_overflow,
+        ...ANTHROPIC_PATTERNS.context_overflow,
+        ...GEMINI_PATTERNS.context_overflow,
+        ...GENERIC_PATTERNS.context_overflow,
+    ]) {
         if (pattern.test(message)) {
             return {
                 type: "context_overflow",
@@ -145,7 +89,12 @@ export function classifyError(error) {
         }
     }
     // Check rate limit
-    for (const pattern of [...OPENAI_PATTERNS.rate_limit, ...ANTHROPIC_PATTERNS.rate_limit, ...GEMINI_PATTERNS.rate_limit, ...GENERIC_PATTERNS.rate_limit]) {
+    for (const pattern of [
+        ...OPENAI_PATTERNS.rate_limit,
+        ...ANTHROPIC_PATTERNS.rate_limit,
+        ...GEMINI_PATTERNS.rate_limit,
+        ...GENERIC_PATTERNS.rate_limit,
+    ]) {
         if (pattern.test(message)) {
             return {
                 type: "rate_limit",

package/dist/agents/skills/security.js

@@ -111,13 +111,7 @@ export function scanSkill(skillName, content) {
         }
     }
     // Sort by severity
-    const severityOrder = [
-        "critical",
-        "high",
-        "medium",
-        "low",
-        "info",
-    ];
+    const severityOrder = ["critical", "high", "medium", "low", "info"];
     findings.sort((a, b) => severityOrder.indexOf(a.severity) - severityOrder.indexOf(b.severity));
     return {
         skillName,

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.3.9",
-  "commit": "d5b6ac08110e3d6f001682436afdb5921d394bca",
-  "builtAt": "2026-03-09T04:38:56.911Z"
+  "version": "2026.3.11",
+  "commit": "e464b86a7613500e5f85a0ea9dcf1f3ebdb25745",
+  "builtAt": "2026-03-11T01:05:20.779Z"
 }