@poolzin/pool-bot 2026.1.26 → 2026.1.29

package/dist/auto-reply/commands-registry.data.js

@@ -20,6 +20,7 @@ function defineChatCommand(command) {
         argsMenu: command.argsMenu,
         textAliases: aliases,
         scope,
+        category: command.category,
     };
 }
 function defineDockCommand(dock) {
@@ -28,6 +29,7 @@ function defineDockCommand(dock) {
         nativeName: `dock_${dock.id}`,
         description: `Switch to ${dock.id} for replies.`,
         textAliases: [`/dock-${dock.id}`, `/dock_${dock.id}`],
+        category: "docks",
     });
 }
 function registerAlias(commands, key, ...aliases) {
@@ -101,18 +103,21 @@ function buildChatCommands() {
             nativeName: "help",
             description: "Show available commands.",
             textAlias: "/help",
+            category: "status",
         }),
         defineChatCommand({
             key: "commands",
             nativeName: "commands",
             description: "List all slash commands.",
             textAlias: "/commands",
+            category: "status",
         }),
         defineChatCommand({
             key: "skill",
             nativeName: "skill",
             description: "Run a skill by name.",
             textAlias: "/skill",
+            category: "tools",
             args: [
                 {
                     name: "name",
@@ -133,6 +138,7 @@ function buildChatCommands() {
             nativeName: "status",
             description: "Show current status.",
             textAlias: "/status",
+            category: "status",
         }),
         defineChatCommand({
             key: "allowlist",
@@ -140,6 +146,7 @@ function buildChatCommands() {
             textAlias: "/allowlist",
             acceptsArgs: true,
             scope: "text",
+            category: "management",
         }),
         defineChatCommand({
             key: "approve",
@@ -147,6 +154,7 @@ function buildChatCommands() {
             description: "Approve or deny exec requests.",
             textAlias: "/approve",
             acceptsArgs: true,
+            category: "management",
         }),
         defineChatCommand({
             key: "context",
@@ -154,25 +162,63 @@ function buildChatCommands() {
             description: "Explain how context is built and used.",
             textAlias: "/context",
             acceptsArgs: true,
+            category: "status",
         }),
         defineChatCommand({
             key: "tts",
             nativeName: "tts",
-            description: "Configure text-to-speech.",
+            description: "Control text-to-speech (TTS).",
             textAlias: "/tts",
-            acceptsArgs: true,
+            category: "media",
+            args: [
+                {
+                    name: "action",
+                    description: "TTS action",
+                    type: "string",
+                    choices: [
+                        { value: "on", label: "On" },
+                        { value: "off", label: "Off" },
+                        { value: "status", label: "Status" },
+                        { value: "provider", label: "Provider" },
+                        { value: "limit", label: "Limit" },
+                        { value: "summary", label: "Summary" },
+                        { value: "audio", label: "Audio" },
+                        { value: "help", label: "Help" },
+                    ],
+                },
+                {
+                    name: "value",
+                    description: "Provider, limit, or text",
+                    type: "string",
+                    captureRemaining: true,
+                },
+            ],
+            argsMenu: {
+                arg: "action",
+                title: "TTS Actions:\n" +
+                    "• On – Enable TTS for responses\n" +
+                    "• Off – Disable TTS\n" +
+                    "• Status – Show current settings\n" +
+                    "• Provider – Set voice provider (edge, elevenlabs, openai)\n" +
+                    "• Limit – Set max characters for TTS\n" +
+                    "• Summary – Toggle AI summary for long texts\n" +
+                    "• Audio – Generate TTS from custom text\n" +
+                    "• Help – Show usage guide",
+            },
         }),
         defineChatCommand({
             key: "whoami",
             nativeName: "whoami",
             description: "Show your sender id.",
             textAlias: "/whoami",
+            category: "status",
         }),
         defineChatCommand({
             key: "subagents",
             nativeName: "subagents",
             description: "List/stop/log/info subagent runs for this session.",
             textAlias: "/subagents",
+            category: "management",
             args: [
                 {
                     name: "action",
@@ -199,6 +245,7 @@ function buildChatCommands() {
             nativeName: "config",
             description: "Show or set config values.",
             textAlias: "/config",
+            category: "management",
             args: [
                 {
                     name: "action",
@@ -226,6 +273,7 @@ function buildChatCommands() {
             nativeName: "debug",
             description: "Set runtime debug overrides.",
             textAlias: "/debug",
+            category: "management",
             args: [
                 {
                     name: "action",
@@ -253,6 +301,7 @@ function buildChatCommands() {
             nativeName: "usage",
             description: "Usage footer or cost summary.",
             textAlias: "/usage",
+            category: "options",
             args: [
                 {
                     name: "mode",
@@ -268,18 +317,21 @@ function buildChatCommands() {
             nativeName: "stop",
             description: "Stop the current run.",
             textAlias: "/stop",
+            category: "session",
         }),
         defineChatCommand({
             key: "restart",
             nativeName: "restart",
-            description: "Restart Clawdbot.",
+            description: "Restart Moltbot.",
             textAlias: "/restart",
+            category: "tools",
         }),
         defineChatCommand({
             key: "activation",
             nativeName: "activation",
             description: "Set group activation mode.",
             textAlias: "/activation",
+            category: "management",
             args: [
                 {
                     name: "mode",
@@ -295,6 +347,7 @@ function buildChatCommands() {
             nativeName: "send",
             description: "Set send policy.",
             textAlias: "/send",
+            category: "management",
             args: [
                 {
                     name: "mode",
@@ -311,6 +364,7 @@ function buildChatCommands() {
             description: "Reset the current session.",
             textAlias: "/reset",
             acceptsArgs: true,
+            category: "session",
         }),
         defineChatCommand({
             key: "new",
@@ -318,12 +372,14 @@ function buildChatCommands() {
             description: "Start a new session.",
             textAlias: "/new",
             acceptsArgs: true,
+            category: "session",
         }),
         defineChatCommand({
             key: "compact",
             description: "Compact the session context.",
             textAlias: "/compact",
             scope: "text",
+            category: "session",
             args: [
                 {
                     name: "instructions",
@@ -338,6 +394,7 @@ function buildChatCommands() {
             nativeName: "think",
             description: "Set thinking level.",
             textAlias: "/think",
+            category: "options",
             args: [
                 {
                     name: "level",
@@ -353,6 +410,7 @@ function buildChatCommands() {
             nativeName: "verbose",
             description: "Toggle verbose mode.",
             textAlias: "/verbose",
+            category: "options",
             args: [
                 {
                     name: "mode",
@@ -368,6 +426,7 @@ function buildChatCommands() {
             nativeName: "reasoning",
             description: "Toggle reasoning visibility.",
             textAlias: "/reasoning",
+            category: "options",
             args: [
                 {
                     name: "mode",
@@ -383,6 +442,7 @@ function buildChatCommands() {
             nativeName: "elevated",
             description: "Toggle elevated mode.",
             textAlias: "/elevated",
+            category: "options",
             args: [
                 {
                     name: "mode",
@@ -398,6 +458,7 @@ function buildChatCommands() {
             nativeName: "exec",
             description: "Set exec defaults for this session.",
             textAlias: "/exec",
+            category: "options",
             args: [
                 {
                     name: "options",
@@ -412,6 +473,7 @@ function buildChatCommands() {
             nativeName: "model",
             description: "Show or set the model.",
             textAlias: "/model",
+            category: "options",
             args: [
                 {
                     name: "model",
@@ -427,12 +489,14 @@ function buildChatCommands() {
             textAlias: "/models",
             argsParsing: "none",
             acceptsArgs: true,
+            category: "options",
         }),
         defineChatCommand({
             key: "queue",
             nativeName: "queue",
             description: "Adjust queue settings.",
             textAlias: "/queue",
+            category: "options",
             args: [
                 {
                     name: "mode",
@@ -465,6 +529,7 @@ function buildChatCommands() {
             description: "Run host shell commands (host-only).",
             textAlias: "/bash",
             scope: "text",
+            category: "tools",
             args: [
                 {
                     name: "command",

package/dist/auto-reply/commands-registry.js

@@ -195,17 +195,20 @@ export function resolveCommandArgChoices(params) {
     if (!arg.choices)
         return [];
     const provided = arg.choices;
-    if (Array.isArray(provided))
-        return provided;
-    const defaults = resolveDefaultCommandContext(cfg);
-    const context = {
-        cfg,
-        provider: params.provider ?? defaults.provider,
-        model: params.model ?? defaults.model,
-        command,
-        arg,
-    };
-    return provided(context);
+    const raw = Array.isArray(provided)
+        ? provided
+        : (() => {
+            const defaults = resolveDefaultCommandContext(cfg);
+            const context = {
+                cfg,
+                provider: params.provider ?? defaults.provider,
+                model: params.model ?? defaults.model,
+                command,
+                arg,
+            };
+            return provided(context);
+        })();
+    return raw.map((choice) => typeof choice === "string" ? { value: choice, label: choice } : choice);
 }
 export function resolveCommandArgMenu(params) {
     const { command, args, cfg } = params;

package/dist/auto-reply/reply/agent-runner-execution.js

@@ -29,6 +29,7 @@ export async function runAgentTurnWithFallback(params) {
         registerAgentRunContext(runId, {
             sessionKey: params.sessionKey,
             verboseLevel: params.resolvedVerboseLevel,
+            isHeartbeat: params.isHeartbeat,
         });
     }
     let runResult;
@@ -78,6 +79,7 @@ export async function runAgentTurnWithFallback(params) {
                 cfg: params.followupRun.run.config,
                 provider: params.followupRun.run.provider,
                 model: params.followupRun.run.model,
+                agentDir: params.followupRun.run.agentDir,
                 fallbacksOverride: resolveAgentModelFallbacksOverride(params.followupRun.run.config, resolveAgentIdFromSessionKey(params.followupRun.run.sessionKey)),
                 run: (provider, model) => {
                     // Notify that model selection is complete (including after fallback).
@@ -116,6 +118,17 @@ export async function runAgentTurnWithFallback(params) {
                             images: params.opts?.images,
                         })
                             .then((result) => {
+                            // CLI backends don't emit streaming assistant events, so we need to
+                            // emit one with the final text so server-chat can populate its buffer
+                            // and send the response to TUI/WebSocket clients.
+                            const cliText = result.payloads?.[0]?.text?.trim();
+                            if (cliText) {
+                                emitAgentEvent({
+                                    runId,
+                                    stream: "assistant",
+                                    data: { text: cliText },
+                                });
+                            }
                             emitAgentEvent({
                                 runId,
                                 stream: "lifecycle",
@@ -154,6 +167,10 @@ export async function runAgentTurnWithFallback(params) {
                         groupId: resolveGroupSessionKey(params.sessionCtx)?.id,
                         groupChannel: params.sessionCtx.GroupChannel?.trim() ?? params.sessionCtx.GroupSubject?.trim(),
                         groupSpace: params.sessionCtx.GroupSpace?.trim() ?? undefined,
+                        senderId: params.sessionCtx.SenderId?.trim() || undefined,
+                        senderName: params.sessionCtx.SenderName?.trim() || undefined,
+                        senderUsername: params.sessionCtx.SenderUsername?.trim() || undefined,
+                        senderE164: params.sessionCtx.SenderE164?.trim() || undefined,
                         // Provider threading context for tool auto-injection
                         ...buildThreadingToolContext({
                             sessionCtx: params.sessionCtx,
@@ -285,12 +302,13 @@ export async function runAgentTurnWithFallback(params) {
                                 if (params.blockStreamingEnabled && params.blockReplyPipeline) {
                                     params.blockReplyPipeline.enqueue(blockPayload);
                                 }
-                                else {
-                                    // Send directly when flushing before tool execution (no streaming).
+                                else if (params.blockStreamingEnabled) {
+                                    // Send directly when flushing before tool execution (no pipeline but streaming enabled).
                                     // Track sent key to avoid duplicate in final payloads.
                                     directlySentBlockKeys.add(createBlockReplyPayloadKey(blockPayload));
                                     await params.opts?.onBlockReply?.(blockPayload);
                                 }
+                                // When streaming is disabled entirely, blocks are accumulated in final text instead.
                             }
                             : undefined,
                         onBlockReplyFlush: params.blockStreamingEnabled && blockReplyPipeline
@@ -428,7 +446,7 @@ export async function runAgentTurnWithFallback(params) {
                 ? "⚠️ Context overflow — prompt too large for this model. Try a shorter message or a larger-context model."
                 : isRoleOrderingError
                     ? "⚠️ Message ordering conflict - please try again. If this persists, use /new to start a fresh session."
-                    : `⚠️ Agent failed before reply: ${trimmedMessage}.\nLogs: clawdbot logs --follow`;
+                    : `⚠️ Agent failed before reply: ${trimmedMessage}.\nLogs: poolbot logs --follow`;
             return {
                 kind: "final",
                 payload: {

package/dist/auto-reply/reply/agent-runner-memory.js

@@ -63,6 +63,7 @@ export async function runMemoryFlushIfNeeded(params) {
             cfg: params.followupRun.run.config,
             provider: params.followupRun.run.provider,
             model: params.followupRun.run.model,
+            agentDir: params.followupRun.run.agentDir,
             fallbacksOverride: resolveAgentModelFallbacksOverride(params.followupRun.run.config, resolveAgentIdFromSessionKey(params.followupRun.run.sessionKey)),
             run: (provider, model) => {
                 const authProfileId = provider === params.followupRun.run.provider
@@ -81,6 +82,10 @@ export async function runMemoryFlushIfNeeded(params) {
                         config: params.followupRun.run.config,
                         hasRepliedRef: params.opts?.hasRepliedRef,
                     }),
+                    senderId: params.sessionCtx.SenderId?.trim() || undefined,
+                    senderName: params.sessionCtx.SenderName?.trim() || undefined,
+                    senderUsername: params.sessionCtx.SenderUsername?.trim() || undefined,
+                    senderE164: params.sessionCtx.SenderE164?.trim() || undefined,
                     sessionFile: params.followupRun.run.sessionFile,
                     workspaceDir: params.followupRun.run.workspaceDir,
                     agentDir: params.followupRun.run.agentDir,

package/dist/auto-reply/reply/bash-command.js

@@ -140,14 +140,14 @@ function formatElevatedUnavailableMessage(params) {
     lines.push("- agents.list[].tools.elevated.enabled");
     lines.push("- agents.list[].tools.elevated.allowFrom.<provider>");
     if (params.sessionKey) {
-        lines.push(`See: ${formatCliCommand(`clawdbot sandbox explain --session ${params.sessionKey}`)}`);
+        lines.push(`See: ${formatCliCommand(`poolbot sandbox explain --session ${params.sessionKey}`)}`);
     }
     return lines.join("\n");
 }
 export async function handleBashChatCommand(params) {
     if (params.cfg.commands?.bash !== true) {
         return {
-            text: "⚠️ bash is disabled. Set commands.bash=true to enable. Docs: https://docs.clawd.bot/tools/slash-commands#config",
+            text: "⚠️ bash is disabled. Set commands.bash=true to enable. Docs: https://docs.molt.bot/tools/slash-commands#config",
         };
     }
     const agentId = params.agentId ??

package/dist/auto-reply/reply/commands-context-report.js

@@ -1,6 +1,6 @@
 import { resolveSessionAgentIds } from "../../agents/agent-scope.js";
 import { resolveBootstrapMaxChars } from "../../agents/pi-embedded-helpers.js";
-import { createClawdbotCodingTools } from "../../agents/pi-tools.js";
+import { createMoltbotCodingTools } from "../../agents/pi-tools.js";
 import { resolveSandboxRuntimeStatus } from "../../agents/sandbox.js";
 import { buildWorkspaceSkillSnapshot } from "../../agents/skills.js";
 import { getSkillsSnapshotVersion } from "../../agents/skills/refresh.js";
@@ -66,7 +66,7 @@ async function resolveContextReport(params) {
     });
     const tools = (() => {
         try {
-            return createClawdbotCodingTools({
+            return createMoltbotCodingTools({
                 config: params.cfg,
                 workspaceDir,
                 sessionKey: params.sessionKey,

package/dist/auto-reply/reply/commands-info.js

@@ -1,6 +1,6 @@
 import { logVerbose } from "../../globals.js";
-import { listSkillCommandsForWorkspace } from "../skill-commands.js";
-import { buildCommandsMessage, buildHelpMessage } from "../status.js";
+import { listSkillCommandsForAgents } from "../skill-commands.js";
+import { buildCommandsMessage, buildCommandsMessagePaginated, buildHelpMessage, } from "../status.js";
 import { buildStatusReply } from "./commands-status.js";
 import { buildContextReply } from "./commands-context-report.js";
 export const handleHelpCommand = async (params, allowTextCommands) => {
@@ -27,15 +27,60 @@ export const handleCommandsListCommand = async (params, allowTextCommands) => {
         return { shouldContinue: false };
     }
     const skillCommands = params.skillCommands ??
-        listSkillCommandsForWorkspace({
-            workspaceDir: params.workspaceDir,
+        listSkillCommandsForAgents({
             cfg: params.cfg,
+            agentIds: params.agentId ? [params.agentId] : undefined,
         });
+    const surface = params.ctx.Surface;
+    if (surface === "telegram") {
+        const result = buildCommandsMessagePaginated(params.cfg, skillCommands, {
+            page: 1,
+            surface,
+        });
+        if (result.totalPages > 1) {
+            return {
+                shouldContinue: false,
+                reply: {
+                    text: result.text,
+                    channelData: {
+                        telegram: {
+                            buttons: buildCommandsPaginationKeyboard(result.currentPage, result.totalPages, params.agentId),
+                        },
+                    },
+                },
+            };
+        }
+        return {
+            shouldContinue: false,
+            reply: { text: result.text },
+        };
+    }
     return {
         shouldContinue: false,
-        reply: { text: buildCommandsMessage(params.cfg, skillCommands) },
+        reply: { text: buildCommandsMessage(params.cfg, skillCommands, { surface }) },
     };
 };
+export function buildCommandsPaginationKeyboard(currentPage, totalPages, agentId) {
+    const buttons = [];
+    const suffix = agentId ? `:${agentId}` : "";
+    if (currentPage > 1) {
+        buttons.push({
+            text: "◀ Prev",
+            callback_data: `commands_page_${currentPage - 1}${suffix}`,
+        });
+    }
+    buttons.push({
+        text: `${currentPage}/${totalPages}`,
+        callback_data: `commands_page_noop${suffix}`,
+    });
+    if (currentPage < totalPages) {
+        buttons.push({
+            text: "Next ▶",
+            callback_data: `commands_page_${currentPage + 1}${suffix}`,
+        });
+    }
+    return [buttons];
+}
 export const handleStatusCommand = async (params, allowTextCommands) => {
     if (!allowTextCommands)
         return null;

package/dist/auto-reply/reply/commands-session.js

@@ -2,7 +2,7 @@ import { abortEmbeddedPiRun } from "../../agents/pi-embedded.js";
 import { updateSessionStore } from "../../config/sessions.js";
 import { logVerbose } from "../../globals.js";
 import { createInternalHookEvent, triggerInternalHook } from "../../hooks/internal-hooks.js";
-import { scheduleGatewaySigusr1Restart, triggerClawdbotRestart } from "../../infra/restart.js";
+import { scheduleGatewaySigusr1Restart, triggerMoltbotRestart } from "../../infra/restart.js";
 import { parseActivationCommand } from "../group-activation.js";
 import { parseSendPolicyCommand } from "../send-policy.js";
 import { normalizeUsageDisplay, resolveResponseUsageMode } from "../thinking.js";
@@ -210,11 +210,11 @@ export const handleRestartCommand = async (params, allowTextCommands) => {
         return {
             shouldContinue: false,
             reply: {
-                text: "⚙️ Restarting clawdbot in-process (SIGUSR1); back in a few seconds.",
+                text: "⚙️ Restarting poolbot in-process (SIGUSR1); back in a few seconds.",
             },
         };
     }
-    const restartMethod = triggerClawdbotRestart();
+    const restartMethod = triggerMoltbotRestart();
     if (!restartMethod.ok) {
         const detail = restartMethod.detail ? ` Details: ${restartMethod.detail}` : "";
         return {
@@ -227,7 +227,7 @@ export const handleRestartCommand = async (params, allowTextCommands) => {
     return {
         shouldContinue: false,
         reply: {
-            text: `⚙️ Restarting clawdbot via ${restartMethod.method}; give me a few seconds to come back online.`,
+            text: `⚙️ Restarting poolbot via ${restartMethod.method}; give me a few seconds to come back online.`,
         },
     };
 };