@poolzin/pool-bot 2026.3.25 → 2026.3.26

package/dist/agents/tool-policy-shared.js

@@ -1,108 +0,0 @@
-const TOOL_NAME_ALIASES = {
-    bash: "exec",
-    "apply-patch": "apply_patch",
-};
-export const TOOL_GROUPS = {
-    // NOTE: Keep canonical (lowercase) tool names here.
-    "group:memory": ["memory_search", "memory_get"],
-    "group:web": ["web_search", "web_fetch"],
-    // Basic workspace/file tools
-    "group:fs": ["read", "write", "edit", "apply_patch"],
-    // Host/runtime execution tools
-    "group:runtime": ["exec", "process"],
-    // Session management tools
-    "group:sessions": [
-        "sessions_list",
-        "sessions_history",
-        "sessions_send",
-        "sessions_spawn",
-        "subagents",
-        "session_status",
-    ],
-    // UI helpers
-    "group:ui": ["browser", "canvas"],
-    // Automation + infra
-    "group:automation": ["cron", "gateway"],
-    // Messaging surface
-    "group:messaging": ["message"],
-    // Nodes + device tools
-    "group:nodes": ["nodes"],
-    // All Pool Bot native tools (excludes provider plugins).
-    "group:poolbot": [
-        "browser",
-        "canvas",
-        "nodes",
-        "cron",
-        "message",
-        "gateway",
-        "agents_list",
-        "sessions_list",
-        "sessions_history",
-        "sessions_send",
-        "sessions_spawn",
-        "subagents",
-        "session_status",
-        "memory_search",
-        "memory_get",
-        "web_search",
-        "web_fetch",
-        "image",
-    ],
-};
-const TOOL_PROFILES = {
-    minimal: {
-        allow: ["session_status"],
-    },
-    coding: {
-        allow: ["group:fs", "group:runtime", "group:sessions", "group:memory", "image"],
-    },
-    messaging: {
-        allow: [
-            "group:messaging",
-            "sessions_list",
-            "sessions_history",
-            "sessions_send",
-            "session_status",
-        ],
-    },
-    full: {},
-};
-export function normalizeToolName(name) {
-    const normalized = name.trim().toLowerCase();
-    return TOOL_NAME_ALIASES[normalized] ?? normalized;
-}
-export function normalizeToolList(list) {
-    if (!list) {
-        return [];
-    }
-    return list.map(normalizeToolName).filter(Boolean);
-}
-export function expandToolGroups(list) {
-    const normalized = normalizeToolList(list);
-    const expanded = [];
-    for (const value of normalized) {
-        const group = TOOL_GROUPS[value];
-        if (group) {
-            expanded.push(...group);
-            continue;
-        }
-        expanded.push(value);
-    }
-    return Array.from(new Set(expanded));
-}
-export function resolveToolProfilePolicy(profile) {
-    if (!profile) {
-        return undefined;
-    }
-    const resolved = TOOL_PROFILES[profile];
-    if (!resolved) {
-        return undefined;
-    }
-    if (!resolved.allow && !resolved.deny) {
-        return undefined;
-    }
-    return {
-        allow: resolved.allow ? [...resolved.allow] : undefined,
-        deny: resolved.deny ? [...resolved.deny] : undefined,
-    };
-}

package/dist/agents/tool-policy.conformance.js

@@ -1,14 +0,0 @@
-/**
- * Conformance snapshot for tool policy.
- *
- * Security note:
- * - This is static, build-time information (no runtime I/O, no network exposure).
- * - Intended for CI/tools to detect drift between the implementation policy and
- *   the formal models/extractors.
- */
-import { TOOL_GROUPS } from "./tool-policy.js";
-// Tool name aliases are intentionally not exported from tool-policy today.
-// Keep the conformance snapshot focused on exported policy constants.
-export const TOOL_POLICY_CONFORMANCE = {
-    toolGroups: TOOL_GROUPS,
-};

package/dist/agents/tool-result-truncation.js

@@ -1,299 +0,0 @@
-/**
- * Tool Result Truncation & Context Pruning
- *
- * Implements:
- * - Head+tail truncation (preserves diagnostics)
- * - Context pruning for tool-results during soft-trim
- * - Preserve recent turns verbatim
- * - Multimodal + tool-result hints
- *
- * OpenClaw #32384, #30951
- */
-/**
- * Default truncation config
- * Head+tail approach preserves important diagnostics
- */
-export const DEFAULT_TRUNCATION_CONFIG = {
-    maxToolResultChars: 50_000,
-    headChars: 10_000,
-    tailChars: 10_000,
-    minCharsForTruncation: 20_000,
-    preserveErrors: true,
-};
-/**
- * Truncate tool result content with head+tail strategy
- * OpenClaw #32384 - preserves diagnostic information
- */
-export function truncateToolResult(content, config = DEFAULT_TRUNCATION_CONFIG) {
-    const originalLength = content.length;
-    // Don't truncate if under threshold
-    if (originalLength <= config.minCharsForTruncation) {
-        return { truncated: content, wasTruncated: false, originalLength };
-    }
-    // Don't truncate if under max
-    if (originalLength <= config.maxToolResultChars) {
-        return { truncated: content, wasTruncated: false, originalLength };
-    }
-    // Head+tail truncation
-    const head = content.slice(0, config.headChars);
-    const tail = content.slice(-config.tailChars);
-    const omitted = originalLength - config.headChars - config.tailChars;
-    const truncated = `${head}\n\n[...${omitted.toLocaleString()} characters omitted...]\n\n${tail}`;
-    return { truncated, wasTruncated: true, originalLength };
-}
-/**
- * Check if a message is a tool result
- */
-export function isToolResultMessage(message) {
-    return message.role === "toolResult";
-}
-/**
- * Check if a tool result contains an error
- */
-export function isToolResultError(message) {
-    if (!isToolResultMessage(message)) {
-        return false;
-    }
-    return message.isError === true;
-}
-/**
- * Extract tool result content from message
- */
-export function extractToolResultContent(message) {
-    const content = message.content;
-    if (typeof content === "string") {
-        return content;
-    }
-    if (content && typeof content === "object") {
-        try {
-            return JSON.stringify(content);
-        }
-        catch {
-            return JSON.stringify({ error: "Failed to stringify content" });
-        }
-    }
-    return "";
-}
-/**
- * Apply truncation to tool result messages
- * Preserves errors by default
- */
-export function truncateToolResultMessages(messages, config = DEFAULT_TRUNCATION_CONFIG) {
-    return messages.map((message) => {
-        if (!isToolResultMessage(message)) {
-            return message;
-        }
-        // Preserve errors if configured
-        if (config.preserveErrors && isToolResultError(message)) {
-            return message;
-        }
-        const content = extractToolResultContent(message);
-        const { truncated, wasTruncated } = truncateToolResult(content, config);
-        if (!wasTruncated) {
-            return message;
-        }
-        // Create new message with truncated content
-        return {
-            ...message,
-            content: truncated,
-        };
-    });
-}
-/**
- * Default context pruning config
- */
-export const DEFAULT_CONTEXT_PRUNING_CONFIG = {
-    keepRecentTurns: 10,
-    pruneToolResultsOlderThan: 20,
-    keepErrorToolResults: true,
-    keepMultimodalContent: true,
-    compressToolResults: false,
-};
-/**
- * Count turns in message history
- * A turn = user message + assistant response
- */
-export function countTurns(messages) {
-    let turns = 0;
-    let hasUserMessage = false;
-    for (const message of messages) {
-        const role = message.role;
-        if (role === "user") {
-            hasUserMessage = true;
-        }
-        else if (role === "assistant" && hasUserMessage) {
-            turns += 1;
-            hasUserMessage = false;
-        }
-    }
-    // Count incomplete turn if there's a user message without response
-    if (hasUserMessage) {
-        turns += 1;
-    }
-    return turns;
-}
-/**
- * Prune context for soft-trim while preserving important information
- * OpenClaw #30951 - maintains diagnostic quality
- */
-export function pruneContextForSoftTrim(messages, config = DEFAULT_CONTEXT_PRUNING_CONFIG) {
-    let currentTurn = 0;
-    // Process messages in reverse to identify recent turns
-    const reversedMessages = [...messages].reverse();
-    const keptMessages = [];
-    for (const message of reversedMessages) {
-        const role = message.role;
-        const isToolResult = isToolResultMessage(message);
-        const isToolError = isToolResultError(message);
-        const hasMultimodal = hasMultimodalContent(message);
-        // Always keep user and assistant messages in recent turns
-        if (role === "user" || role === "assistant") {
-            if (currentTurn < config.keepRecentTurns) {
-                keptMessages.unshift(message);
-                if (role === "assistant") {
-                    currentTurn += 1;
-                }
-            }
-            else {
-                // Older turns: selectively prune
-                if (!isToolResult) {
-                    keptMessages.unshift(message);
-                }
-                else if (config.keepErrorToolResults && isToolError) {
-                    keptMessages.unshift(message);
-                }
-                else if (config.keepMultimodalContent && hasMultimodal) {
-                    keptMessages.unshift(message);
-                }
-                else if (config.compressToolResults) {
-                    // Compress to summary instead of full content
-                    const compressed = compressToolResult(message);
-                    keptMessages.unshift(compressed);
-                }
-            }
-            continue;
-        }
-        // Tool results: apply pruning rules
-        if (isToolResult) {
-            if (currentTurn < config.keepRecentTurns) {
-                // Keep recent tool results
-                keptMessages.unshift(message);
-            }
-            else if (config.keepErrorToolResults && isToolError) {
-                // Always keep errors
-                keptMessages.unshift(message);
-            }
-            else if (config.keepMultimodalContent && hasMultimodal) {
-                // Keep multimodal content
-                keptMessages.unshift(message);
-            }
-            else if (config.compressToolResults) {
-                // Compress older tool results
-                const compressed = compressToolResult(message);
-                keptMessages.unshift(compressed);
-            }
-            // Otherwise: prune (don't add to keptMessages)
-        }
-    }
-    return keptMessages;
-}
-/**
- * Check if a message has multimodal content (images, files, etc.)
- */
-export function hasMultimodalContent(message) {
-    const content = message.content;
-    if (!content) {
-        return false;
-    }
-    if (Array.isArray(content)) {
-        return content.some((item) => {
-            if (!item || typeof item !== "object") {
-                return false;
-            }
-            const record = item;
-            return (typeof record.image === "string" ||
-                typeof record.file === "string" ||
-                typeof record.data === "string" ||
-                typeof record.url === "string");
-        });
-    }
-    return false;
-}
-/**
- * Compress tool result to summary (for context pruning)
- */
-export function compressToolResult(message) {
-    if (!isToolResultMessage(message)) {
-        return message;
-    }
-    const toolName = message.toolName;
-    const toolNameStr = typeof toolName === "string" && toolName.trim() ? toolName : "unknown";
-    const content = extractToolResultContent(message);
-    // Create summary instead of full content
-    const summary = `[Tool: ${toolNameStr}] - ${content.length.toLocaleString()} characters`;
-    return {
-        ...message,
-        content: summary,
-    };
-}
-/**
- * Audit compaction quality
- * OpenClaw #30951 - ensures compaction doesn't lose critical information
- */
-export function auditCompactionQuality(params) {
-    const { originalMessages, compactedMessages, summary } = params;
-    const issues = [];
-    const recommendations = [];
-    let score = 100;
-    // Check 1: Tool errors preserved
-    const originalErrors = originalMessages.filter(isToolResultError).length;
-    const compactedErrors = compactedMessages.filter(isToolResultError).length;
-    if (compactedErrors < originalErrors) {
-        issues.push(`Lost ${originalErrors - compactedErrors} tool error messages`);
-        recommendations.push("Preserve all tool errors during compaction");
-        score -= 20;
-    }
-    // Check 2: Recent turns preserved
-    const originalTurns = countTurns(originalMessages);
-    const compactedTurns = countTurns(compactedMessages);
-    if (compactedTurns < originalTurns * 0.3) {
-        issues.push("Compaction ratio too aggressive (<30% of turns preserved)");
-        recommendations.push("Keep at least 30% of recent turns verbatim");
-        score -= 15;
-    }
-    // Check 3: Summary quality
-    if (summary) {
-        if (summary.length < 50) {
-            issues.push("Summary too short (may lack detail)");
-            recommendations.push("Generate more detailed summaries (min 50 chars)");
-            score -= 10;
-        }
-        if (summary.length > 5000) {
-            issues.push("Summary too long (defeats compaction purpose)");
-            recommendations.push("Keep summaries concise (<5000 chars)");
-            score -= 5;
-        }
-    }
-    // Check 4: Multimodal content
-    const originalMultimodal = originalMessages.filter(hasMultimodalContent).length;
-    const compactedMultimodal = compactedMessages.filter(hasMultimodalContent).length;
-    if (compactedMultimodal < originalMultimodal) {
-        issues.push(`Lost ${originalMultimodal - compactedMultimodal} multimodal messages`);
-        recommendations.push("Preserve multimodal content during compaction");
-        score -= 15;
-    }
-    // Check 5: Message order
-    const lastOriginalRole = originalMessages[originalMessages.length - 1]?.role;
-    const lastCompactedRole = compactedMessages[compactedMessages.length - 1]?.role;
-    if (lastOriginalRole !== lastCompactedRole) {
-        issues.push("Message order may be incorrect (last message role mismatch)");
-        recommendations.push("Verify message ordering after compaction");
-        score -= 10;
-    }
-    return {
-        score: Math.max(0, score),
-        issues,
-        recommendations,
-        passed: score >= 70,
-    };
-}

package/dist/agents/tools/cron-tool.test-helpers.js

@@ -1,12 +0,0 @@
-import { vi } from "vitest";
-export const callGatewayMock = vi.fn();
-vi.mock("../../gateway/call.js", () => ({
-    callGateway: (opts) => callGatewayMock(opts),
-}));
-vi.mock("../agent-scope.js", () => ({
-    resolveSessionAgentId: () => "agent-123",
-}));
-export function resetCronToolGatewayMock() {
-    callGatewayMock.mockReset();
-    callGatewayMock.mockResolvedValue({ ok: true });
-}

package/dist/agents/tools/discord-actions-moderation-shared.js

@@ -1,27 +0,0 @@
-import { PermissionFlagsBits } from "discord-api-types/v10";
-import { readNumberParam, readStringParam } from "./common.js";
-const moderationPermissions = {
-    timeout: PermissionFlagsBits.ModerateMembers,
-    kick: PermissionFlagsBits.KickMembers,
-    ban: PermissionFlagsBits.BanMembers,
-};
-export function isDiscordModerationAction(action) {
-    return action === "timeout" || action === "kick" || action === "ban";
-}
-export function requiredGuildPermissionForModerationAction(action) {
-    return moderationPermissions[action];
-}
-export function readDiscordModerationCommand(action, params) {
-    if (!isDiscordModerationAction(action)) {
-        throw new Error(`Unsupported Discord moderation action: ${action}`);
-    }
-    return {
-        action,
-        guildId: readStringParam(params, "guildId", { required: true }),
-        userId: readStringParam(params, "userId", { required: true }),
-        durationMinutes: readNumberParam(params, "durationMinutes", { integer: true }),
-        until: readStringParam(params, "until"),
-        reason: readStringParam(params, "reason"),
-        deleteMessageDays: readNumberParam(params, "deleteMessageDays", { integer: true }),
-    };
-}

package/dist/agents/tools/discord-actions-presence.js

@@ -1,78 +0,0 @@
-import { getGateway } from "../../discord/monitor/gateway-registry.js";
-import { jsonResult, readStringParam } from "./common.js";
-const ACTIVITY_TYPE_MAP = {
-    playing: 0,
-    streaming: 1,
-    listening: 2,
-    watching: 3,
-    custom: 4,
-    competing: 5,
-};
-const VALID_STATUSES = new Set(["online", "dnd", "idle", "invisible"]);
-export async function handleDiscordPresenceAction(action, params, isActionEnabled) {
-    if (action !== "setPresence") {
-        throw new Error(`Unknown presence action: ${action}`);
-    }
-    if (!isActionEnabled("presence", false)) {
-        throw new Error("Discord presence changes are disabled.");
-    }
-    const accountId = readStringParam(params, "accountId");
-    const gateway = getGateway(accountId);
-    if (!gateway) {
-        throw new Error(`Discord gateway not available${accountId ? ` for account "${accountId}"` : ""}. The bot may not be connected.`);
-    }
-    if (!gateway.isConnected) {
-        throw new Error(`Discord gateway is not connected${accountId ? ` for account "${accountId}"` : ""}.`);
-    }
-    const statusRaw = readStringParam(params, "status") ?? "online";
-    if (!VALID_STATUSES.has(statusRaw)) {
-        throw new Error(`Invalid status "${statusRaw}". Must be one of: ${[...VALID_STATUSES].join(", ")}`);
-    }
-    const status = statusRaw;
-    const activityTypeRaw = readStringParam(params, "activityType");
-    const activityName = readStringParam(params, "activityName");
-    const activities = [];
-    if (activityTypeRaw || activityName) {
-        if (!activityTypeRaw) {
-            throw new Error("activityType is required when activityName is provided. " +
-                `Valid types: ${Object.keys(ACTIVITY_TYPE_MAP).join(", ")}`);
-        }
-        const typeNum = ACTIVITY_TYPE_MAP[activityTypeRaw.toLowerCase()];
-        if (typeNum === undefined) {
-            throw new Error(`Invalid activityType "${activityTypeRaw}". Must be one of: ${Object.keys(ACTIVITY_TYPE_MAP).join(", ")}`);
-        }
-        const activity = {
-            name: activityName ?? "",
-            type: typeNum,
-        };
-        // Streaming URL (Twitch/YouTube). May not render for bots but is the correct payload shape.
-        if (typeNum === 1) {
-            const url = readStringParam(params, "activityUrl");
-            if (url) {
-                activity.url = url;
-            }
-        }
-        const state = readStringParam(params, "activityState");
-        if (state) {
-            activity.state = state;
-        }
-        activities.push(activity);
-    }
-    const presenceData = {
-        since: null,
-        activities,
-        status,
-        afk: false,
-    };
-    gateway.updatePresence(presenceData);
-    return jsonResult({
-        ok: true,
-        status,
-        activities: activities.map((a) => ({
-            type: a.type,
-            name: a.name,
-            ...(a.url ? { url: a.url } : {}),
-            ...(a.state ? { state: a.state } : {}),
-        })),
-    });
-}