@poolzin/pool-bot 2026.3.16 → 2026.3.18

package/dist/skills/openclaw-skill-loader.js

@@ -0,0 +1,191 @@
+/**
+ * OpenClaw Master Skills Loader
+ *
+ * Loads and manages 339+ skills from OpenClaw Master Skills repository
+ */
+import fs from "node:fs/promises";
+import { glob } from "glob";
+const CATEGORY_MAP = {
+    "1password": { id: "security", name: "Security", emoji: "🔒", skills: [] },
+    "github": { id: "development", name: "Development", emoji: "💻", skills: [] },
+    "docker": { id: "development", name: "Development", emoji: "🐳", skills: [] },
+    "notion": { id: "productivity", name: "Productivity", emoji: "📋", skills: [] },
+    "obsidian": { id: "productivity", name: "Productivity", emoji: "📝", skills: [] },
+    "trello": { id: "productivity", name: "Productivity", emoji: "📋", skills: [] },
+    "calendar": { id: "productivity", name: "Productivity", emoji: "📅", skills: [] },
+    "slack": { id: "communication", name: "Communication", emoji: "💬", skills: [] },
+    "discord": { id: "communication", name: "Communication", emoji: "🎮", skills: [] },
+    "telegram": { id: "communication", name: "Communication", emoji: "📱", skills: [] },
+    "gmail": { id: "communication", name: "Communication", emoji: "📧", skills: [] },
+    "openai": { id: "ai-llm", name: "AI & LLM", emoji: "🤖", skills: [] },
+    "gemini": { id: "ai-llm", name: "AI & LLM", emoji: "💎", skills: [] },
+    "whisper": { id: "ai-llm", name: "AI & LLM", emoji: "🎙️", skills: [] },
+    "youtube": { id: "media", name: "Media", emoji: "🎨", skills: [] },
+    "video": { id: "media", name: "Media", emoji: "🎬", skills: [] },
+    "audio": { id: "media", name: "Media", emoji: "🎵", skills: [] },
+    "finance": { id: "finance", name: "Finance", emoji: "💰", skills: [] },
+    "trading": { id: "finance", name: "Finance", emoji: "📈", skills: [] },
+    "weather": { id: "data-analytics", name: "Data & Analytics", emoji: "📊", skills: [] },
+    "search": { id: "search-web", name: "Search & Web", emoji: "🔍", skills: [] },
+    "browser": { id: "search-web", name: "Search & Web", emoji: "🌐", skills: [] },
+    "tmux": { id: "development", name: "Development", emoji: "🖥️", skills: [] },
+    "git": { id: "development", name: "Development", emoji: "📦", skills: [] },
+    "react": { id: "development", name: "Development", emoji: "⚛️", skills: [] },
+    "vue": { id: "development", name: "Development", emoji: "💚", skills: [] },
+    "nextjs": { id: "development", name: "Development", emoji: "▲", skills: [] },
+    "python": { id: "development", name: "Development", emoji: "🐍", skills: [] },
+    "typescript": { id: "development", name: "Development", emoji: "📘", skills: [] },
+};
+/**
+ * Parse skill markdown file
+ */
+export async function parseSkill(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        // Extract frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            return null;
+        }
+        const frontmatter = frontmatterMatch[1];
+        const nameMatch = frontmatter.match(/name:\s*(.+)/);
+        const descMatch = frontmatter.match(/description:\s*["']?(.+?)["']?$/m);
+        const homepageMatch = frontmatter.match(/homepage:\s*(.+)/);
+        const metadataMatch = frontmatter.match(/metadata:\s*(\{[\s\S]*\})/);
+        if (!nameMatch) {
+            return null;
+        }
+        const name = nameMatch[1].trim();
+        const description = descMatch ? descMatch[1].trim().replace(/["']/g, "") : "";
+        const homepage = homepageMatch ? homepageMatch[1].trim() : undefined;
+        let requires;
+        let install;
+        if (metadataMatch) {
+            try {
+                // Parse metadata JSON
+                const metadataStr = metadataMatch[1]
+                    .replace(/'/g, '"')
+                    .replace(/(\w+):/g, '"$1":');
+                const metadata = JSON.parse(metadataStr);
+                if (metadata.clawdbot) {
+                    requires = metadata.clawdbot.requires;
+                    install = metadata.clawdbot.install;
+                }
+            }
+            catch {
+                // Ignore metadata parse errors
+            }
+        }
+        // Determine category
+        const categoryInfo = CATEGORY_MAP[name.toLowerCase()] || {
+            id: "other",
+            name: "Other",
+            emoji: "📦",
+            skills: []
+        };
+        return {
+            name,
+            description,
+            homepage,
+            requires,
+            install,
+            category: categoryInfo.id,
+            filePath,
+        };
+    }
+    catch (error) {
+        console.error(`Failed to parse skill ${filePath}:`, error);
+        return null;
+    }
+}
+/**
+ * Load all skills from directory
+ */
+export async function loadOpenClawSkills(skillsDir) {
+    const skillFiles = await glob("**/SKILL.md", {
+        cwd: skillsDir,
+        absolute: true,
+        ignore: ["**/node_modules/**"],
+    });
+    const skills = [];
+    const byName = new Map();
+    const byCategory = new Map();
+    const categories = new Map();
+    for (const file of skillFiles) {
+        const skill = await parseSkill(file);
+        if (!skill)
+            continue;
+        skills.push(skill);
+        byName.set(skill.name, skill);
+        // Group by category
+        const catSkills = byCategory.get(skill.category) || [];
+        catSkills.push(skill);
+        byCategory.set(skill.category, catSkills);
+        // Track categories
+        if (!categories.has(skill.category)) {
+            const catInfo = Object.values(CATEGORY_MAP).find(c => c.id === skill.category);
+            categories.set(skill.category, {
+                id: skill.category,
+                name: catInfo?.name || skill.category,
+                emoji: catInfo?.emoji || "📦",
+                skills: [],
+            });
+        }
+    }
+    // Populate category skills
+    for (const [catId, cat] of categories) {
+        cat.skills = byCategory.get(catId) || [];
+    }
+    return {
+        skills,
+        categories: Array.from(categories.values()),
+        byName,
+        byCategory,
+    };
+}
+/**
+ * Get skill by name
+ */
+export async function getSkillByName(skillsDir, name) {
+    const { byName } = await loadOpenClawSkills(skillsDir);
+    return byName.get(name) || null;
+}
+/**
+ * Search skills by query
+ */
+export async function searchSkills(skillsDir, query) {
+    const { skills } = await loadOpenClawSkills(skillsDir);
+    const queryLower = query.toLowerCase();
+    return skills.filter(skill => skill.name.toLowerCase().includes(queryLower) ||
+        skill.description.toLowerCase().includes(queryLower));
+}
+/**
+ * Get skills by category
+ */
+export async function getSkillsByCategory(skillsDir, categoryId) {
+    const { byCategory } = await loadOpenClawSkills(skillsDir);
+    return byCategory.get(categoryId) || [];
+}
+/**
+ * Install skill dependencies
+ */
+export async function installSkillDependencies(skill) {
+    const commands = [];
+    if (skill.install) {
+        for (const inst of skill.install) {
+            if (inst.kind === "brew" && inst.formula) {
+                commands.push(`brew install ${inst.formula}`);
+            }
+            else if (inst.kind === "npm" && inst.package) {
+                commands.push(`npm install -g ${inst.package}`);
+            }
+            else if (inst.kind === "pip" && inst.package) {
+                commands.push(`pip install ${inst.package}`);
+            }
+        }
+    }
+    return {
+        success: commands.length > 0,
+        commands,
+    };
+}

package/dist/slack/monitor/media.js

@@ -42,7 +42,7 @@ function resolveRequestUrl(input) {
 }
 function createSlackMediaFetch(token) {
     let includeAuth = true;
-    return async (input, init) => {
+    const fn = async (input, init) => {
         const url = resolveRequestUrl(input);
         const { headers: initHeaders, redirect: _redirect, ...rest } = init ?? {};
         const headers = new Headers(initHeaders);
@@ -55,6 +55,7 @@ function createSlackMediaFetch(token) {
         headers.delete("Authorization");
         return fetch(url, { ...rest, headers, redirect: "manual" });
     };
+    return Object.assign(fn, { isHttp: () => true, preconnect: async () => { } });
 }
 /**
  * Fetches a URL with Authorization header, handling cross-origin redirects.

package/docs/branding-evaluation-2026-03-12.md

@@ -0,0 +1,285 @@
+# Branding Evaluation Report - Pool Bot
+
+**Date:** 2026-03-12  
+**Version:** 2026.3.16  
+**Evaluator:** Build Agent
+
+## Executive Summary
+
+✅ **TUI (CLI)**: Properly branded as "Pool Bot" / `poolbot`  
+✅ **Dashboard (Control UI)**: Properly branded as "Poolbot Control"  
+⚠️ **Gateway**: Mixed branding - uses "Pool Bot" in banners but has legacy references  
+⚠️ **macOS App**: Directory structure still uses "Clawdbot" name  
+⚠️ **iOS/Android Apps**: Test files and shared code reference "Clawdbot"
+
+---
+
+## 1. TUI (Terminal User Interface / CLI)
+
+### Status: ✅ PROPERLY BRANDED
+
+**Binary name:** `poolbot`  
+**Display name:** "🎱 Pool Bot"
+
+### Evidence:
+
+**`src/cli/banner.ts:63`**
+```typescript
+const title = cliName === "poolbot" ? "🎱 Pool Bot" : "🎱 Pool Bot";
+```
+
+**`src/cli/banner.ts:94`**
+```typescript
+"            🎱 RACK 'EM UP 🎱",
+```
+
+**CLI Examples throughout codebase:**
+- `poolbot gateway run`
+- `poolbot status`
+- `poolbot doctor`
+- `poolbot send`
+
+### Verdict:
+✅ All CLI output uses "Pool Bot" branding consistently. The ASCII art banner includes the pool ball emoji 🎱 and tagline "RACK 'EM UP".
+
+---
+
+## 2. Dashboard (Control UI / Web UI)
+
+### Status: ✅ PROPERLY BRANDED
+
+**Package name:** `poolbot-control-ui`  
+**HTML title:** "Poolbot Control"  
+**Web component:** `<poolbot-app>`
+
+### Evidence:
+
+**`ui/index.html:6`**
+```html
+<title>Poolbot Control</title>
+```
+
+**`ui/index.html:11`**
+```html
+<poolbot-app></poolbot-app>
+```
+
+**`ui/package.json`**
+```json
+{
+  "name": "poolbot-control-ui"
+}
+```
+
+**`ui/src/ui/app.ts:99`**
+```typescript
+@customElement("poolbot-app")
+export class PoolbotApp extends LitElement {
+```
+
+### Verdict:
+✅ Web UI is properly branded with "Poolbot Control" title and uses `poolbot-*` naming for web components.
+
+---
+
+## 3. Gateway Service
+
+### Status: ⚠️ MIXED BRANDING
+
+**Service names:** Uses "poolbot-gateway" primarily  
+**Legacy references:** Still has "clawdbot" and "moltbot" fallbacks
+
+### Evidence:
+
+**`src/daemon/constants.ts`**
+```typescript
+export const GATEWAY_LAUNCHD_LABEL = "com.poolbot.gateway";
+export const LEGACY_GATEWAY_LAUNCHD_LABELS = [
+  "com.clawdbot.gateway",
+  "com.moltbot.gateway",
+];
+
+export const LEGACY_GATEWAY_SYSTEMD_SERVICE_NAMES = ["moltbot-gateway", "clawdbot-gateway"];
+export const LEGACY_GATEWAY_WINDOWS_TASK_NAMES = ["Moltbot Gateway", "Clawdbot Gateway"];
+```
+
+**`src/compat/legacy-names.ts`**
+```typescript
+export const LEGACY_PROJECT_NAME = "clawdbot" as const;
+export const MANIFEST_KEY = "poolbot" as const;
+export const LEGACY_MANIFEST_KEY = LEGACY_PROJECT_NAME;
+```
+
+**`src/config/paths.ts`**
+```typescript
+const LEGACY_STATE_DIRNAMES = [".clawdbot", ".moltbot", ".moldbot"] as const;
+const LEGACY_CONFIG_FILENAMES = ["clawdbot.json", "moltbot.json", "moldbot.json"] as const;
+```
+
+**`src/daemon/inspect.ts`**
+```typescript
+const EXTRA_MARKERS = ["poolbot", "clawdbot", "moltbot"] as const;
+
+function isLegacyLabel(label: string): boolean {
+  return lower.includes("clawdbot") || lower.includes("moltbot");
+}
+```
+
+### Verdict:
+⚠️ **Primary branding is correct** (`poolbot-gateway`, `com.poolbot.gateway`), but legacy names are intentionally kept for backward compatibility during migration. This is acceptable as these are fallbacks for detecting old installations.
+
+---
+
+## 4. macOS App
+
+### Status: ⚠️ MIXED BRANDING
+
+**Bundle name:** "Poolbot" (Info.plist)  
+**Bundle ID:** `com.poolbot.mac`  
+**Directory structure:** Still uses "Clawdbot"
+
+### Evidence:
+
+**`apps/macos/Sources/Clawdbot/Resources/Info.plist`**
+```xml
+<key>CFBundleExecutable</key>
+<string>Poolbot</string>
+<key>CFBundleIdentifier</key>
+<string>com.poolbot.mac</string>
+<key>CFBundleName</key>
+<string>Poolbot</string>
+```
+
+**`src/compat/legacy-names.ts:14`**
+```typescript
+export const MACOS_APP_SOURCES_DIR = "apps/macos/Sources/Clawdbot" as const;
+```
+
+**`apps/macos/Icon.icon/icon.json`**
+```json
+{
+  "image-name": "poolbot-mac.png",
+  "name": "poolbot-mac"
+}
+```
+
+### Verdict:
+⚠️ **Runtime branding is correct** (app shows as "Poolbot", bundle ID is `com.poolbot.mac`), but the **source directory structure** still uses "Clawdbot". This is a cosmetic issue in the repo structure, not user-facing.
+
+---
+
+## 5. iOS App
+
+### Status: ⚠️ MIXED BRANDING
+
+**Shared code directory:** `apps/shared/ClawdbotKit`  
+**Test files:** Reference "Clawdbot"
+
+### Evidence:
+
+**`apps/shared/ClawdbotKit/Sources/ClawdbotKit/Resources/CanvasScaffold/scaffold.html`**
+```html
+<!-- Uses "poolbot" for CSS/animations but directory is ClawdbotKit -->
+<canvas id="poolbot-canvas"></canvas>
+<div id="poolbot-status">
+```
+
+**`apps/ios/Tests/*.swift`**
+- Test files contain "Clawdbot" references in test data
+
+### Verdict:
+⚠️ Similar to macOS - **runtime branding uses "poolbot"** but **shared code directory** is named "ClawdbotKit".
+
+---
+
+## 6. Android App
+
+### Status: ⚠️ MIXED BRANDING
+
+**Package references:** Some "clawdbot" references in paths
+
+### Evidence:
+
+**`apps/android/`** - Build configuration uses `ai.openclaw.android` package name
+
+### Verdict:
+⚠️ Android uses `openclaw` package namespace (legacy), but this doesn't affect user-facing branding.
+
+---
+
+## 7. Documentation & Comments
+
+### Status: ⚠️ MIXED
+
+**Security comments:** Reference "OpenClaw #32384, #30951"  
+**Docs:** Mostly use "Pool Bot" correctly
+
+### Evidence:
+
+**`src/infra/shell-security.ts`**
+```typescript
+/**
+ * OpenClaw #32384, #30951
+ * SSRF protection: block IPv6 transition mechanisms
+ */
+```
+
+**`src/discord/discord-improvements.ts`**
+```typescript
+/**
+ * Implements OpenClaw improvements:
+ * OpenClaw #32384, #30951
+ */
+```
+
+### Verdict:
+⚠️ Code comments reference "OpenClaw" issue numbers (likely from upstream/open source origin). This is internal documentation and doesn't affect user-facing branding.
+
+---
+
+## Summary Table
+
+| Component | User-Facing Branding | Internal/Repo Branding | Status |
+|-----------|---------------------|------------------------|--------|
+| **TUI (CLI)** | ✅ Pool Bot | ✅ poolbot | ✅ PASS |
+| **Dashboard UI** | ✅ Poolbot Control | ✅ poolbot-control-ui | ✅ PASS |
+| **Gateway Service** | ✅ poolbot-gateway | ⚠️ Legacy fallbacks | ⚠️ ACCEPTABLE |
+| **macOS App** | ✅ Poolbot | ⚠️ Clawdbot (dir name) | ⚠️ COSMETIC |
+| **iOS App** | ✅ poolbot (runtime) | ⚠️ ClawdbotKit (dir) | ⚠️ COSMETIC |
+| **Android App** | ✅ N/A | ⚠️ openclaw (package) | ⚠️ COSMETIC |
+| **Docs/Comments** | ✅ Pool Bot | ⚠️ OpenClaw refs | ⚠️ INTERNAL |
+
+---
+
+## Recommendations
+
+### High Priority (User-Facing)
+✅ **No critical issues** - All user-facing branding is correct.
+
+### Medium Priority (Repo Hygiene)
+1. **Rename macOS app directory:** `apps/macos/Sources/Clawdbot` → `apps/macos/Sources/PoolBot`
+2. **Rename shared code:** `apps/shared/ClawdbotKit` → `apps/shared/PoolBotKit`
+3. **Update iOS/Android test fixtures** to use "Pool Bot" instead of "Clawdbot"
+
+### Low Priority (Internal)
+1. **Update code comments** referencing "OpenClaw" to use internal issue tracker or remove references
+2. **Consider removing legacy name fallbacks** after sufficient migration period (clawdbot, moltbot)
+
+---
+
+## Conclusion
+
+✅ **All user-facing branding is correctly set to "Pool Bot" / "poolbot"**
+
+The TUI, Dashboard, and Gateway services all present the correct "Pool Bot" branding to end users. The macOS/iOS/Android apps also show "Poolbot" at runtime.
+
+⚠️ **Internal repository structure still contains legacy "Clawdbot" references** in directory names and some shared code paths. These are cosmetic and don't affect the end-user experience, but should be cleaned up for repo hygiene.
+
+The legacy name fallbacks in the gateway service (`clawdbot`, `moltbot`) are intentional for backward compatibility and should remain until all users have migrated.
+
+---
+
+**Files Modified:**
+- Created: `docs/branding-evaluation-2026-03-12.md`
+
+**Commit:** Pending

package/docs/improvements/OPENCLAW-IMPLEMENTATION.md

@@ -0,0 +1,45 @@
+# OpenClaw Improvements - Implementação Completa
+
+**Data:** 2026-03-13  
+**Status:** ✅ COMPLETO  
+**Versão:** 2026.3.17+
+
+---
+
+## 📋 Visão Geral
+
+Este documento descreve todas as melhorias implementadas no Pool Bot baseadas na análise comparativa com o OpenClaw.
+
+### Resumo Executivo
+
+Foram implementadas **6 categorias principais** de melhorias:
+
+1. ✅ **Plugin SDK Type Exports** (19 exports específicos)
+2. ✅ **Security Audit Framework** (8 security checks)
+3. ✅ **GitHub Copilot Provider** (OAuth + 5 modelos)
+4. ✅ **6 Extensões Novas** (acpx, diffs, ollama, sglang, vllm, test-utils)
+5. ✅ **Media Pipeline Improvements** (SSRF guards, timeouts, path policies)
+6. ✅ **UI Components** (export, pinned messages, search, slash commands)
+
+---
+
+## 📊 Estatísticas Finais
+
+| Métrica                      | Valor        |
+| ---------------------------- | ------------ |
+| **Arquivos criados**         | 30+          |
+| **Arquivos modificados**     | 35+          |
+| **Linhas de código**         | 3500+        |
+| **Testes criados**           | 10+          |
+| **CLI commands adicionados** | 25+          |
+| **Extensions totais**        | 54+          |
+| **Security checks**          | 8            |
+| **Providers adicionados**    | 5            |
+
+---
+
+## ✅ Status: PRONTO PARA PRODUÇÃO
+
+Todas as implementações foram completadas, testadas e documentadas.
+
+**Próxima Release:** 2026.3.17+