@poolzin/pool-bot 2026.2.25 → 2026.2.26

package/dist/cli/plugins-cli.js

@@ -4,6 +4,7 @@ import path from "node:path";
 import { loadConfig, writeConfigFile } from "../config/config.js";
 import { resolveStateDir } from "../config/paths.js";
 import { resolveArchiveKind } from "../infra/archive.js";
+import { enablePluginInConfig } from "../plugins/enable.js";
 import { installPluginFromNpmSpec, installPluginFromPath } from "../plugins/install.js";
 import { recordPluginInstall } from "../plugins/installs.js";
 import { clearPluginManifestRegistryCache } from "../plugins/manifest-registry.js";
@@ -95,21 +96,6 @@ function createPluginInstallLogger() {
         warn: (msg) => defaultRuntime.log(theme.warn(msg)),
     };
 }
-function enablePluginInConfig(config, pluginId) {
-    return {
-        ...config,
-        plugins: {
-            ...config.plugins,
-            entries: {
-                ...config.plugins?.entries,
-                [pluginId]: {
-                    ...config.plugins?.entries?.[pluginId],
-                    enabled: true,
-                },
-            },
-        },
-    };
-}
 function logSlotWarnings(warnings) {
     if (warnings.length === 0) {
         return;
@@ -122,7 +108,7 @@ export function registerPluginsCli(program) {
     const plugins = program
         .command("plugins")
         .description("Manage Pool Bot plugins and extensions")
-        .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/plugins", "docs.poolbot.ai/cli/plugins")}\n`);
+        .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/plugins", "docs.molt.bot/cli/plugins")}\n`);
     plugins
         .command("list")
         .description("List discovered plugins")
@@ -289,24 +275,17 @@ export function registerPluginsCli(program) {
         .argument("<id>", "Plugin id")
         .action(async (id) => {
         const cfg = loadConfig();
-        let next = {
-            ...cfg,
-            plugins: {
-                ...cfg.plugins,
-                entries: {
-                    ...cfg.plugins?.entries,
-                    [id]: {
-                        ...cfg.plugins?.entries?.[id],
-                        enabled: true,
-                    },
-                },
-            },
-        };
+        const enableResult = enablePluginInConfig(cfg, id);
+        let next = enableResult.config;
         const slotResult = applySlotSelectionForPlugin(next, id);
         next = slotResult.config;
         await writeConfigFile(next);
         logSlotWarnings(slotResult.warnings);
-        defaultRuntime.log(`Enabled plugin "${id}". Restart the gateway to apply.`);
+        if (enableResult.enabled) {
+            defaultRuntime.log(`Enabled plugin "${id}". Restart the gateway to apply.`);
+            return;
+        }
+        defaultRuntime.log(theme.warn(`Plugin "${id}" could not be enabled (${enableResult.reason ?? "unknown reason"}).`));
     });
     plugins
         .command("disable")
@@ -476,7 +455,7 @@ export function registerPluginsCli(program) {
                             paths: merged,
                         },
                     },
-                }, probe.pluginId);
+                }, probe.pluginId).config;
                 next = recordPluginInstall(next, {
                     pluginId: probe.pluginId,
                     source: "path",
@@ -503,7 +482,7 @@ export function registerPluginsCli(program) {
             // Plugin CLI registrars may have warmed the manifest registry cache before install;
             // force a rescan so config validation sees the freshly installed plugin.
             clearPluginManifestRegistryCache();
-            let next = enablePluginInConfig(cfg, result.pluginId);
+            let next = enablePluginInConfig(cfg, result.pluginId).config;
             const source = resolveArchiveKind(resolved) ? "archive" : "path";
             next = recordPluginInstall(next, {
                 pluginId: result.pluginId,
@@ -549,15 +528,14 @@ export function registerPluginsCli(program) {
         }
         // Ensure config validation sees newly installed plugin(s) even if the cache was warmed at startup.
         clearPluginManifestRegistryCache();
-        let next = enablePluginInConfig(cfg, result.pluginId);
-        // PB's installPluginFromNpmSpec does not return npmResolution metadata yet;
-        // record what we can (version from manifest) and store the raw spec.
-        const recordSpec = opts.pin && result.version ? `${result.pluginId}@${result.version}` : raw;
-        if (opts.pin && !result.version) {
+        let next = enablePluginInConfig(cfg, result.pluginId).config;
+        const resolvedSpec = result.npmResolution?.resolvedSpec;
+        const recordSpec = opts.pin && resolvedSpec ? resolvedSpec : raw;
+        if (opts.pin && !resolvedSpec) {
             defaultRuntime.log(theme.warn("Could not resolve exact npm version for --pin; storing original npm spec."));
         }
-        if (opts.pin && result.version) {
-            defaultRuntime.log(`Pinned npm install record to ${result.pluginId}@${result.version}.`);
+        if (opts.pin && resolvedSpec) {
+            defaultRuntime.log(`Pinned npm install record to ${resolvedSpec}.`);
         }
         next = recordPluginInstall(next, {
             pluginId: result.pluginId,
@@ -565,6 +543,12 @@ export function registerPluginsCli(program) {
             spec: recordSpec,
             installPath: result.targetDir,
             version: result.version,
+            resolvedName: result.npmResolution?.name,
+            resolvedVersion: result.npmResolution?.version,
+            resolvedSpec: result.npmResolution?.resolvedSpec,
+            integrity: result.npmResolution?.integrity,
+            shasum: result.npmResolution?.shasum,
+            resolvedAt: result.npmResolution?.resolvedAt,
         });
         const slotResult = applySlotSelectionForPlugin(next, result.pluginId);
         next = slotResult.config;
@@ -599,7 +583,16 @@ export function registerPluginsCli(program) {
                 info: (msg) => defaultRuntime.log(msg),
                 warn: (msg) => defaultRuntime.log(theme.warn(msg)),
             },
-            // NOTE: onIntegrityDrift is available in OC but not yet ported to PB's update module.
+            onIntegrityDrift: async (drift) => {
+                const specLabel = drift.resolvedSpec ?? drift.spec;
+                defaultRuntime.log(theme.warn(`Integrity drift detected for "${drift.pluginId}" (${specLabel})` +
+                    `\nExpected: ${drift.expectedIntegrity}` +
+                    `\nActual:   ${drift.actualIntegrity}`));
+                if (drift.dryRun) {
+                    return true;
+                }
+                return await promptYesNo(`Continue updating "${drift.pluginId}" with this artifact?`);
+            },
         });
         for (const outcome of result.outcomes) {
             if (outcome.status === "error") {
@@ -645,7 +638,7 @@ export function registerPluginsCli(program) {
                 lines.push(`- ${target}${diag.message}`);
             }
         }
-        const docs = formatDocsLink("/plugin", "docs.poolbot.ai/plugin");
+        const docs = formatDocsLink("/plugin", "docs.molt.bot/plugin");
         lines.push("");
         lines.push(`${theme.muted("Docs:")} ${docs}`);
         defaultRuntime.log(lines.join("\n"));

package/dist/cli/ports.js

@@ -1,24 +1,24 @@
 import { execFileSync } from "node:child_process";
 import { resolveLsofCommandSync } from "../infra/ports-lsof.js";
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
+import { sleep } from "../utils.js";
 export function parseLsofOutput(output) {
     const lines = output.split(/\r?\n/).filter(Boolean);
     const results = [];
     let current = {};
     for (const line of lines) {
         if (line.startsWith("p")) {
-            if (current.pid)
+            if (current.pid) {
                 results.push(current);
+            }
             current = { pid: Number.parseInt(line.slice(1), 10) };
         }
         else if (line.startsWith("c")) {
             current.command = line.slice(1);
         }
     }
-    if (current.pid)
+    if (current.pid) {
         results.push(current);
+    }
     return results;
 }
 export function listPortListeners(port) {
@@ -33,10 +33,11 @@ export function listPortListeners(port) {
         const status = err.status;
         const code = err.code;
         if (code === "ENOENT") {
-            throw new Error("lsof not found; required for --force");
+            throw new Error("lsof not found; required for --force", { cause: err });
         }
-        if (status === 1)
-            return []; // no listeners
+        if (status === 1) {
+            return [];
+        } // no listeners
         throw err instanceof Error ? err : new Error(String(err));
     }
 }
@@ -47,7 +48,7 @@ export function forceFreePort(port) {
             process.kill(proc.pid, "SIGTERM");
         }
         catch (err) {
-            throw new Error(`failed to kill pid ${proc.pid}${proc.command ? ` (${proc.command})` : ""}: ${String(err)}`);
+            throw new Error(`failed to kill pid ${proc.pid}${proc.command ? ` (${proc.command})` : ""}: ${String(err)}`, { cause: err });
         }
     }
     return listeners;
@@ -58,7 +59,7 @@ function killPids(listeners, signal) {
             process.kill(proc.pid, signal);
         }
         catch (err) {
-            throw new Error(`failed to kill pid ${proc.pid}${proc.command ? ` (${proc.command})` : ""}: ${String(err)}`);
+            throw new Error(`failed to kill pid ${proc.pid}${proc.command ? ` (${proc.command})` : ""}: ${String(err)}`, { cause: err });
         }
     }
 }

package/dist/cli/program/command-registry.js

@@ -1,5 +1,6 @@
 import { getPrimaryCommand, hasHelpOrVersion } from "../argv.js";
 import { reparseProgramFromActionArgs } from "./action-reparse.js";
+import { removeCommandByName } from "./command-tree.js";
 import { registerSubCliCommands } from "./register.subclis.js";
 const shouldRegisterCorePrimaryOnly = (argv) => {
     if (hasHelpOrVersion(argv)) {
@@ -197,21 +198,11 @@ export function getCoreCliCommandNames() {
 export function getCoreCliCommandsWithSubcommands() {
     return collectCoreCliCommandNames((command) => command.hasSubcommands);
 }
-function removeCommand(program, command) {
-    const commands = program.commands;
-    const index = commands.indexOf(command);
-    if (index >= 0) {
-        commands.splice(index, 1);
-    }
-}
 function removeEntryCommands(program, entry) {
     // Some registrars install multiple top-level commands (e.g. status/health/sessions).
     // Remove placeholders/old registrations for all names in the entry before re-registering.
     for (const cmd of entry.commands) {
-        const existing = program.commands.find((c) => c.name() === cmd.name);
-        if (existing) {
-            removeCommand(program, existing);
-        }
+        removeCommandByName(program, cmd.name);
     }
 }
 function registerLazyCoreCommand(program, ctx, entry, command) {

package/dist/cli/program/command-tree.js

@@ -0,0 +1,16 @@
+export function removeCommand(program, command) {
+    const commands = program.commands;
+    const index = commands.indexOf(command);
+    if (index < 0) {
+        return false;
+    }
+    commands.splice(index, 1);
+    return true;
+}
+export function removeCommandByName(program, name) {
+    const existing = program.commands.find((command) => command.name() === name);
+    if (!existing) {
+        return false;
+    }
+    return removeCommand(program, existing);
+}

package/dist/cli/program/preaction.js

@@ -1,10 +1,8 @@
+import { setVerbose } from "../../globals.js";
+import { isTruthyEnvValue } from "../../infra/env.js";
 import { defaultRuntime } from "../../runtime.js";
-import { emitCliBanner } from "../banner.js";
 import { getCommandPath, getVerboseFlag, hasHelpOrVersion } from "../argv.js";
-import { ensureConfigReady } from "./config-guard.js";
-import { ensurePluginRegistryLoaded } from "../plugin-registry.js";
-import { isTruthyEnvValue } from "../../infra/env.js";
-import { setVerbose } from "../../globals.js";
+import { emitCliBanner } from "../banner.js";
 import { resolveCliName } from "../cli-name.js";
 function setProcessTitleForCommand(actionCommand) {
     let current = actionCommand;
@@ -13,8 +11,9 @@ function setProcessTitleForCommand(actionCommand) {
     }
     const name = current.name();
     const cliName = resolveCliName();
-    if (!name || name === cliName)
+    if (!name || name === cliName) {
         return;
+    }
     process.title = `${cliName}-${name}`;
 }
 // Commands that need channel plugins loaded
@@ -23,11 +22,13 @@ export function registerPreActionHooks(program, programVersion) {
     program.hook("preAction", async (_thisCommand, actionCommand) => {
         setProcessTitleForCommand(actionCommand);
         const argv = process.argv;
-        if (hasHelpOrVersion(argv))
+        if (hasHelpOrVersion(argv)) {
             return;
+        }
         const commandPath = getCommandPath(argv, 2);
-        const hideBanner = isTruthyEnvValue(process.env.POOLBOT_HIDE_BANNER || process.env.CLAWDBOT_HIDE_BANNER) ||
+        const hideBanner = isTruthyEnvValue(process.env.POOLBOT_HIDE_BANNER) ||
             commandPath[0] === "update" ||
+            commandPath[0] === "completion" ||
             (commandPath[0] === "plugins" && commandPath[1] === "update");
         if (!hideBanner) {
             emitCliBanner(programVersion);
@@ -37,11 +38,14 @@ export function registerPreActionHooks(program, programVersion) {
         if (!verbose) {
             process.env.NODE_NO_WARNINGS ??= "1";
         }
-        if (commandPath[0] === "doctor")
+        if (commandPath[0] === "doctor" || commandPath[0] === "completion") {
             return;
+        }
+        const { ensureConfigReady } = await import("./config-guard.js");
         await ensureConfigReady({ runtime: defaultRuntime, commandPath });
         // Load plugins for commands that need channel access
         if (PLUGIN_REQUIRED_COMMANDS.has(commandPath[0])) {
+            const { ensurePluginRegistryLoaded } = await import("../plugin-registry.js");
             ensurePluginRegistryLoaded();
         }
     });

package/dist/cli/program/register.configure.js

@@ -1,4 +1,4 @@
-import { CONFIGURE_WIZARD_SECTIONS, configureCommand, configureCommandWithSections, } from "../../commands/configure.js";
+import { CONFIGURE_WIZARD_SECTIONS, configureCommandFromSectionsArg, } from "../../commands/configure.js";
 import { defaultRuntime } from "../../runtime.js";
 import { formatDocsLink } from "../../terminal/links.js";
 import { theme } from "../../terminal/theme.js";
@@ -6,27 +6,12 @@ import { runCommandWithRuntime } from "../cli-utils.js";
 export function registerConfigureCommand(program) {
     program
         .command("configure")
-        .description("Interactive prompt to set up credentials, devices, and agent defaults")
+        .description("Interactive setup wizard for credentials, channels, gateway, and agent defaults")
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/configure", "docs.molt.bot/cli/configure")}\n`)
         .option("--section <section>", `Configuration sections (repeatable). Options: ${CONFIGURE_WIZARD_SECTIONS.join(", ")}`, (value, previous) => [...previous, value], [])
         .action(async (opts) => {
         await runCommandWithRuntime(defaultRuntime, async () => {
-            const sections = Array.isArray(opts.section)
-                ? opts.section
-                    .map((value) => (typeof value === "string" ? value.trim() : ""))
-                    .filter(Boolean)
-                : [];
-            if (sections.length === 0) {
-                await configureCommand(defaultRuntime);
-                return;
-            }
-            const invalid = sections.filter((s) => !CONFIGURE_WIZARD_SECTIONS.includes(s));
-            if (invalid.length > 0) {
-                defaultRuntime.error(`Invalid --section: ${invalid.join(", ")}. Expected one of: ${CONFIGURE_WIZARD_SECTIONS.join(", ")}.`);
-                defaultRuntime.exit(1);
-                return;
-            }
-            await configureCommandWithSections(sections, defaultRuntime);
+            await configureCommandFromSectionsArg(opts.section, defaultRuntime);
         });
     });
 }

package/dist/cli/program/register.maintenance.js

@@ -36,11 +36,11 @@ export function registerMaintenanceCommands(program) {
         .command("dashboard")
         .description("Open the Control UI with your current token")
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/dashboard", "docs.molt.bot/cli/dashboard")}\n`)
-        .option("--no-open", "Print URL but do not launch a browser", false)
+        .option("--no-open", "Print URL but do not launch a browser")
         .action(async (opts) => {
         await runCommandWithRuntime(defaultRuntime, async () => {
             await dashboardCommand(defaultRuntime, {
-                noOpen: Boolean(opts.noOpen),
+                noOpen: opts.open === false,
             });
         });
     });

package/dist/cli/program/register.onboard.js

@@ -114,6 +114,8 @@ export function registerOnboardCommand(program) {
                 xiaomiApiKey: opts.xiaomiApiKey,
                 qianfanApiKey: opts.qianfanApiKey,
                 minimaxApiKey: opts.minimaxApiKey,
+                volcengineApiKey: opts.volcengineApiKey,
+                byteplusApiKey: opts.byteplusApiKey,
                 syntheticApiKey: opts.syntheticApiKey,
                 veniceApiKey: opts.veniceApiKey,
                 togetherApiKey: opts.togetherApiKey,

package/dist/cli/program/register.status-health-sessions.js

@@ -20,6 +20,17 @@ function parseTimeoutMs(timeout) {
     }
     return parsed;
 }
+async function runWithVerboseAndTimeout(opts, action) {
+    const verbose = resolveVerbose(opts);
+    setVerbose(verbose);
+    const timeoutMs = parseTimeoutMs(opts.timeout);
+    if (timeoutMs === null) {
+        return;
+    }
+    await runCommandWithRuntime(defaultRuntime, async () => {
+        await action({ verbose, timeoutMs });
+    });
+}
 export function registerStatusHealthSessionsCommands(program) {
     program
         .command("status")
@@ -44,19 +55,13 @@ export function registerStatusHealthSessionsCommands(program) {
     ])}`)
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/status", "docs.molt.bot/cli/status")}\n`)
         .action(async (opts) => {
-        const verbose = resolveVerbose(opts);
-        setVerbose(verbose);
-        const timeout = parseTimeoutMs(opts.timeout);
-        if (timeout === null) {
-            return;
-        }
-        await runCommandWithRuntime(defaultRuntime, async () => {
+        await runWithVerboseAndTimeout(opts, async ({ verbose, timeoutMs }) => {
             await statusCommand({
                 json: Boolean(opts.json),
                 all: Boolean(opts.all),
                 deep: Boolean(opts.deep),
                 usage: Boolean(opts.usage),
-                timeoutMs: timeout,
+                timeoutMs,
                 verbose,
             }, defaultRuntime);
         });
@@ -70,16 +75,10 @@ export function registerStatusHealthSessionsCommands(program) {
         .option("--debug", "Alias for --verbose", false)
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/health", "docs.molt.bot/cli/health")}\n`)
         .action(async (opts) => {
-        const verbose = resolveVerbose(opts);
-        setVerbose(verbose);
-        const timeout = parseTimeoutMs(opts.timeout);
-        if (timeout === null) {
-            return;
-        }
-        await runCommandWithRuntime(defaultRuntime, async () => {
+        await runWithVerboseAndTimeout(opts, async ({ verbose, timeoutMs }) => {
             await healthCommand({
                 json: Boolean(opts.json),
-                timeoutMs: timeout,
+                timeoutMs,
                 verbose,
             }, defaultRuntime);
         });
@@ -96,7 +95,7 @@ export function registerStatusHealthSessionsCommands(program) {
         ["poolbot sessions --active 120", "Only last 2 hours."],
         ["poolbot sessions --json", "Machine-readable output."],
         ["poolbot sessions --store ./tmp/sessions.json", "Use a specific session store."],
-    ])}\n\n${theme.muted("Shows token usage per session when the agent reports it; set agents.defaults.contextTokens to see % of your model window.")}`)
+    ])}\n\n${theme.muted("Shows token usage per session when the agent reports it; set agents.defaults.contextTokens to cap the window and show %.")}`)
         .addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/sessions", "docs.molt.bot/cli/sessions")}\n`)
         .action(async (opts) => {
         setVerbose(Boolean(opts.verbose));