@poolzin/pool-bot 2026.3.25 → 2026.3.26

package/dist/discord/discord-improvements.js

@@ -1,167 +0,0 @@
-/**
- * Discord Channel Improvements
- *
- * Implements OpenClaw improvements:
- * - Thread-bound subagent sessions (enhanced)
- * - Status reactions configuráveis
- * - Voice channel join/leave via /vc
- * - Native slash command auth
- * - Component interactions with wildcard handlers
- *
- * OpenClaw #32384, #30951
- */
-export const DEFAULT_VOICE_CHANNEL_CONFIG = {
-    enabled: true,
-    autoJoin: false,
-    autoLeaveAfterSilenceMs: 5 * 60 * 1000, // 5 minutes
-    maxChannelsPerGuild: 5,
-    enableTts: false,
-};
-const voiceChannelSessions = new Map();
-/**
- * Get or create voice channel session
- */
-export function getOrCreateVoiceChannelSession(params) {
-    const { channelId, guildId, ttsEnabled = false } = params;
-    const key = `${guildId}:${channelId}`;
-    const existing = voiceChannelSessions.get(key);
-    if (existing) {
-        return existing;
-    }
-    const session = {
-        channelId,
-        guildId,
-        joinedAt: Date.now(),
-        lastActivityAt: Date.now(),
-        ttsEnabled,
-    };
-    voiceChannelSessions.set(key, session);
-    return session;
-}
-/**
- * Update voice channel session activity
- */
-export function updateVoiceChannelActivity(channelId, guildId) {
-    const key = `${guildId}:${channelId}`;
-    const session = voiceChannelSessions.get(key);
-    if (session) {
-        session.lastActivityAt = Date.now();
-    }
-}
-/**
- * Remove voice channel session
- */
-export function removeVoiceChannelSession(channelId, guildId) {
-    const key = `${guildId}:${channelId}`;
-    return voiceChannelSessions.delete(key);
-}
-/**
- * Check for stale voice channel sessions
- */
-export function getStaleVoiceChannelSessions(config = DEFAULT_VOICE_CHANNEL_CONFIG) {
-    const now = Date.now();
-    const stale = [];
-    for (const session of voiceChannelSessions.values()) {
-        if (now - session.lastActivityAt > config.autoLeaveAfterSilenceMs) {
-            stale.push(session);
-        }
-    }
-    return stale;
-}
-export const DEFAULT_SLASH_COMMAND_AUTH_CONFIG = {
-    enabled: true,
-    requireAuthForAll: false,
-    protectedCommands: ["admin", "config", "pair", "auth"],
-    allowLoopback: true,
-    authTimeoutMs: 5 * 60 * 1000, // 5 minutes
-};
-/**
- * Check if a slash command requires authentication
- */
-export function isSlashCommandProtected(commandName, config = DEFAULT_SLASH_COMMAND_AUTH_CONFIG) {
-    if (!config.enabled) {
-        return false;
-    }
-    if (config.requireAuthForAll) {
-        return true;
-    }
-    return config.protectedCommands.includes(commandName.toLowerCase());
-}
-export const DEFAULT_COMPONENT_INTERACTION_CONFIG = {
-    enabled: true,
-    wildcardPatterns: ["action:*", "button:*", "select:*", "modal:*"],
-    rateLimitPerMinute: 60,
-    responseTimeoutMs: 3000, // Discord requires response within 3 seconds
-};
-/**
- * Match custom ID against wildcard patterns
- */
-export function matchWildcardPattern(customId, config = DEFAULT_COMPONENT_INTERACTION_CONFIG) {
-    if (!config.enabled) {
-        return null;
-    }
-    for (const pattern of config.wildcardPatterns) {
-        // Convert wildcard pattern to regex
-        // * matches any characters except :
-        const regexPattern = pattern.replace(/\*/g, "[^:]*");
-        const regex = new RegExp(`^${regexPattern}$`);
-        if (regex.test(customId)) {
-            return pattern;
-        }
-    }
-    return null;
-}
-/**
- * Component interaction rate limiting
- */
-const interactionCounts = new Map();
-/**
- * Check if component interaction is rate limited
- */
-export function checkComponentInteractionRateLimit(userId, config = DEFAULT_COMPONENT_INTERACTION_CONFIG) {
-    const now = Date.now();
-    const windowMs = 60_000; // 1 minute
-    const timestamps = interactionCounts.get(userId) ?? [];
-    const recentTimestamps = timestamps.filter((ts) => now - ts < windowMs);
-    if (recentTimestamps.length >= config.rateLimitPerMinute) {
-        const oldestTimestamp = recentTimestamps[0];
-        const retryAfterMs = windowMs - (now - oldestTimestamp);
-        return { allowed: false, retryAfterMs };
-    }
-    recentTimestamps.push(now);
-    interactionCounts.set(userId, recentTimestamps);
-    return { allowed: true };
-}
-export const DEFAULT_THREAD_BINDING_ENHANCEMENT = {
-    autoBindSubagents: true,
-    threadTtlMs: 60 * 60 * 1000, // 1 hour
-    autoUnbindOnSessionEnd: true,
-    maxThreadsPerSession: 10,
-};
-export const DEFAULT_DISCORD_STATUS_REACTION_CONFIG = {
-    enabled: true,
-    showInThreads: true,
-    showInChannels: false, // Don't spam channels by default
-    useEmojiReactions: true,
-    useEmbedStatus: false,
-    emojis: {
-        queued: "👀",
-        thinking: "🤔",
-        tool: "⚡",
-        coding: "👨‍💻",
-        web: "🌐",
-        done: "✅",
-        error: "❌",
-        stallSoft: "⏳",
-        stallHard: "⚠️",
-    },
-};
-/**
- * Get status reaction emoji for a given status
- */
-export function getStatusReactionEmoji(status, config = DEFAULT_DISCORD_STATUS_REACTION_CONFIG) {
-    if (!config.enabled) {
-        return null;
-    }
-    return config.emojis[status.toLowerCase()] ?? null;
-}

package/dist/discord/index.js

@@ -1,2 +0,0 @@
-export { monitorDiscordProvider } from "./monitor.js";
-export { sendMessageDiscord, sendPollDiscord } from "./send.js";

package/dist/hooks/bundled/boot-md/HOOK.md

@@ -1,19 +0,0 @@
----
-name: boot-md
-description: "Run BOOT.md on gateway startup"
-homepage: https://docs.molt.bot/hooks#boot-md
-metadata:
-  {
-    "poolbot":
-      {
-        "emoji": "🚀",
-        "events": ["gateway:startup"],
-        "requires": { "config": ["workspace.dir"] },
-        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with Pool Bot" }],
-      },
-  }
----
-
-# Boot Checklist Hook
-
-Runs `BOOT.md` every time the gateway starts, if the file exists in the workspace.

package/dist/hooks/bundled/command-logger/HOOK.md

@@ -1,122 +0,0 @@
----
-name: command-logger
-description: "Log all command events to a centralized audit file"
-homepage: https://docs.molt.bot/hooks#command-logger
-metadata:
-  {
-    "poolbot":
-      {
-        "emoji": "📝",
-        "events": ["command"],
-        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with Pool Bot" }],
-      },
-  }
----
-
-# Command Logger Hook
-
-Logs all command events (`/new`, `/reset`, `/stop`, etc.) to a centralized audit log file for debugging and monitoring purposes.
-
-## What It Does
-
-Every time you issue a command to the agent:
-
-1. **Captures event details** - Command action, timestamp, session key, sender ID, source
-2. **Appends to log file** - Writes a JSON line to `~/.poolbot/logs/commands.log`
-3. **Silent operation** - Runs in the background without user notifications
-
-## Output Format
-
-Log entries are written in JSONL (JSON Lines) format:
-
-```json
-{"timestamp":"2026-01-16T14:30:00.000Z","action":"new","sessionKey":"agent:main:main","senderId":"+1234567890","source":"telegram"}
-{"timestamp":"2026-01-16T15:45:22.000Z","action":"stop","sessionKey":"agent:main:main","senderId":"user@example.com","source":"whatsapp"}
-```
-
-## Use Cases
-
-- **Debugging**: Track when commands were issued and from which source
-- **Auditing**: Monitor command usage across different channels
-- **Analytics**: Analyze command patterns and frequency
-- **Troubleshooting**: Investigate issues by reviewing command history
-
-## Log File Location
-
-`~/.poolbot/logs/commands.log`
-
-## Requirements
-
-No requirements - this hook works out of the box on all platforms.
-
-## Configuration
-
-No configuration needed. The hook automatically:
-
-- Creates the log directory if it doesn't exist
-- Appends to the log file (doesn't overwrite)
-- Handles errors silently without disrupting command execution
-
-## Disabling
-
-To disable this hook:
-
-```bash
-poolbot hooks disable command-logger
-```
-
-Or via config:
-
-```json
-{
-  "hooks": {
-    "internal": {
-      "entries": {
-        "command-logger": { "enabled": false }
-      }
-    }
-  }
-}
-```
-
-## Log Rotation
-
-The hook does not automatically rotate logs. To manage log size, you can:
-
-1. **Manual rotation**:
-
-   ```bash
-   mv ~/.poolbot/logs/commands.log ~/.poolbot/logs/commands.log.old
-   ```
-
-2. **Use logrotate** (Linux):
-   Create `/etc/logrotate.d/poolbot`:
-   ```
-   /home/username/.poolbot/logs/commands.log {
-       weekly
-       rotate 4
-       compress
-       missingok
-       notifempty
-   }
-   ```
-
-## Viewing Logs
-
-View recent commands:
-
-```bash
-tail -n 20 ~/.poolbot/logs/commands.log
-```
-
-Pretty-print with jq:
-
-```bash
-cat ~/.poolbot/logs/commands.log | jq .
-```
-
-Filter by action:
-
-```bash
-grep '"action":"new"' ~/.poolbot/logs/commands.log | jq .
-```

package/dist/hooks/bundled/session-memory/HOOK.md

@@ -1,86 +0,0 @@
----
-name: session-memory
-description: "Save session context to memory when /new command is issued"
-homepage: https://docs.molt.bot/hooks#session-memory
-metadata:
-  {
-    "poolbot":
-      {
-        "emoji": "💾",
-        "events": ["command:new"],
-        "requires": { "config": ["workspace.dir"] },
-        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with Pool Bot" }],
-      },
-  }
----
-
-# Session Memory Hook
-
-Automatically saves session context to your workspace memory when you issue the `/new` command.
-
-## What It Does
-
-When you run `/new` to start a fresh session:
-
-1. **Finds the previous session** - Uses the pre-reset session entry to locate the correct transcript
-2. **Extracts conversation** - Reads the last 15 lines of conversation from the session
-3. **Generates descriptive slug** - Uses LLM to create a meaningful filename slug based on conversation content
-4. **Saves to memory** - Creates a new file at `<workspace>/memory/YYYY-MM-DD-slug.md`
-5. **Sends confirmation** - Notifies you with the file path
-
-## Output Format
-
-Memory files are created with the following format:
-
-```markdown
-# Session: 2026-01-16 14:30:00 UTC
-
-- **Session Key**: agent:main:main
-- **Session ID**: abc123def456
-- **Source**: telegram
-```
-
-## Filename Examples
-
-The LLM generates descriptive slugs based on your conversation:
-
-- `2026-01-16-vendor-pitch.md` - Discussion about vendor evaluation
-- `2026-01-16-api-design.md` - API architecture planning
-- `2026-01-16-bug-fix.md` - Debugging session
-- `2026-01-16-1430.md` - Fallback timestamp if slug generation fails
-
-## Requirements
-
-- **Config**: `workspace.dir` must be set (automatically configured during onboarding)
-
-The hook uses your configured LLM provider to generate slugs, so it works with any provider (Anthropic, OpenAI, etc.).
-
-## Configuration
-
-No additional configuration required. The hook automatically:
-
-- Uses your workspace directory (`~/clawd` by default)
-- Uses your configured LLM for slug generation
-- Falls back to timestamp slugs if LLM is unavailable
-
-## Disabling
-
-To disable this hook:
-
-```bash
-poolbot hooks disable session-memory
-```
-
-Or remove it from your config:
-
-```json
-{
-  "hooks": {
-    "internal": {
-      "entries": {
-        "session-memory": { "enabled": false }
-      }
-    }
-  }
-}
-```

package/dist/hooks/bundled/soul-evil/HOOK.md

@@ -1,71 +0,0 @@
----
-name: soul-evil
-description: "Swap SOUL.md with SOUL_EVIL.md during a purge window or by random chance"
-homepage: https://docs.molt.bot/hooks/soul-evil
-metadata:
-  {
-    "poolbot":
-      {
-        "emoji": "😈",
-        "events": ["agent:bootstrap"],
-        "requires": { "config": ["hooks.internal.entries.soul-evil.enabled"] },
-        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with Pool Bot" }],
-      },
-  }
----
-
-# SOUL Evil Hook
-
-Replaces the injected `SOUL.md` content with `SOUL_EVIL.md` during a daily purge window or by random chance.
-
-## What It Does
-
-When enabled and the trigger conditions match, the hook swaps the **injected** `SOUL.md` content before the system prompt is built. It does **not** modify files on disk.
-
-## Files
-
-- `SOUL.md` — normal persona (always read)
-- `SOUL_EVIL.md` — alternate persona (read only when triggered)
-
-You can change the filename via hook config.
-
-## Configuration
-
-Add this to your config (`~/.poolbot/poolbot.json`):
-
-```json
-{
-  "hooks": {
-    "internal": {
-      "enabled": true,
-      "entries": {
-        "soul-evil": {
-          "enabled": true,
-          "file": "SOUL_EVIL.md",
-          "chance": 0.1,
-          "purge": { "at": "21:00", "duration": "15m" }
-        }
-      }
-    }
-  }
-}
-```
-
-### Options
-
-- `file` (string): alternate SOUL filename (default: `SOUL_EVIL.md`)
-- `chance` (number 0–1): random chance per run to swap in SOUL_EVIL
-- `purge.at` (HH:mm): daily purge window start time (24h)
-- `purge.duration` (duration): window length (e.g. `30s`, `10m`, `1h`)
-
-**Precedence:** purge window wins over chance.
-
-## Requirements
-
-- `hooks.internal.entries.soul-evil.enabled` must be set to `true`
-
-## Enable
-
-```bash
-poolbot hooks enable soul-evil
-```

package/dist/whatsapp/normalize.js

@@ -1,66 +0,0 @@
-import { normalizeE164 } from "../utils.js";
-const WHATSAPP_USER_JID_RE = /^(\d+)(?::\d+)?@s\.whatsapp\.net$/i;
-const WHATSAPP_LID_RE = /^(\d+)@lid$/i;
-function stripWhatsAppTargetPrefixes(value) {
-    let candidate = value.trim();
-    for (;;) {
-        const before = candidate;
-        candidate = candidate.replace(/^whatsapp:/i, "").trim();
-        if (candidate === before)
-            return candidate;
-    }
-}
-export function isWhatsAppGroupJid(value) {
-    const candidate = stripWhatsAppTargetPrefixes(value);
-    const lower = candidate.toLowerCase();
-    if (!lower.endsWith("@g.us"))
-        return false;
-    const localPart = candidate.slice(0, candidate.length - "@g.us".length);
-    if (!localPart || localPart.includes("@"))
-        return false;
-    return /^[0-9]+(-[0-9]+)*$/.test(localPart);
-}
-/**
- * Check if value looks like a WhatsApp user target (e.g. "41796666864:0@s.whatsapp.net" or "123@lid").
- */
-export function isWhatsAppUserTarget(value) {
-    const candidate = stripWhatsAppTargetPrefixes(value);
-    return WHATSAPP_USER_JID_RE.test(candidate) || WHATSAPP_LID_RE.test(candidate);
-}
-/**
- * Extract the phone number from a WhatsApp user JID.
- * "41796666864:0@s.whatsapp.net" -> "41796666864"
- * "123456@lid" -> "123456"
- */
-function extractUserJidPhone(jid) {
-    const userMatch = jid.match(WHATSAPP_USER_JID_RE);
-    if (userMatch)
-        return userMatch[1];
-    const lidMatch = jid.match(WHATSAPP_LID_RE);
-    if (lidMatch)
-        return lidMatch[1];
-    return null;
-}
-export function normalizeWhatsAppTarget(value) {
-    const candidate = stripWhatsAppTargetPrefixes(value);
-    if (!candidate)
-        return null;
-    if (isWhatsAppGroupJid(candidate)) {
-        const localPart = candidate.slice(0, candidate.length - "@g.us".length);
-        return `${localPart}@g.us`;
-    }
-    // Handle user JIDs (e.g. "41796666864:0@s.whatsapp.net")
-    if (isWhatsAppUserTarget(candidate)) {
-        const phone = extractUserJidPhone(candidate);
-        if (!phone)
-            return null;
-        const normalized = normalizeE164(phone);
-        return normalized.length > 1 ? normalized : null;
-    }
-    // If the caller passed a JID-ish string that we don't understand, fail fast.
-    // Otherwise normalizeE164 would happily treat "group:120@g.us" as a phone number.
-    if (candidate.includes("@"))
-        return null;
-    const normalized = normalizeE164(candidate);
-    return normalized.length > 1 ? normalized : null;
-}

package/dist/whatsapp/resolve-outbound-target.js

@@ -1,42 +0,0 @@
-import { missingTargetError } from "../infra/outbound/target-errors.js";
-import { isWhatsAppGroupJid, normalizeWhatsAppTarget } from "./normalize.js";
-export function resolveWhatsAppOutboundTarget(params) {
-    const trimmed = params.to?.trim() ?? "";
-    const allowListRaw = (params.allowFrom ?? [])
-        .map((entry) => String(entry).trim())
-        .filter(Boolean);
-    const hasWildcard = allowListRaw.includes("*");
-    const allowList = allowListRaw
-        .filter((entry) => entry !== "*")
-        .map((entry) => normalizeWhatsAppTarget(entry))
-        .filter((entry) => Boolean(entry));
-    if (trimmed) {
-        const normalizedTo = normalizeWhatsAppTarget(trimmed);
-        if (!normalizedTo) {
-            return {
-                ok: false,
-                error: missingTargetError("WhatsApp", "<E.164|group JID>"),
-            };
-        }
-        if (isWhatsAppGroupJid(normalizedTo)) {
-            return { ok: true, to: normalizedTo };
-        }
-        if (params.mode === "implicit" || params.mode === "heartbeat") {
-            if (hasWildcard || allowList.length === 0) {
-                return { ok: true, to: normalizedTo };
-            }
-            if (allowList.includes(normalizedTo)) {
-                return { ok: true, to: normalizedTo };
-            }
-            return {
-                ok: false,
-                error: missingTargetError("WhatsApp", "<E.164|group JID>"),
-            };
-        }
-        return { ok: true, to: normalizedTo };
-    }
-    return {
-        ok: false,
-        error: missingTargetError("WhatsApp", "<E.164|group JID>"),
-    };
-}