@poolzin/pool-bot 2026.2.24 → 2026.2.26

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));

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

@@ -1,24 +1,31 @@
 import { isTruthyEnvValue } from "../../infra/env.js";
-import { buildParseArgv, getPrimaryCommand, hasHelpOrVersion } from "../argv.js";
-import { resolveActionArgs } from "./helpers.js";
+import { getPrimaryCommand, hasHelpOrVersion } from "../argv.js";
+import { reparseProgramFromActionArgs } from "./action-reparse.js";
+import { removeCommand, removeCommandByName } from "./command-tree.js";
 const shouldRegisterPrimaryOnly = (argv) => {
-    if (isTruthyEnvValue(process.env.POOLBOT_DISABLE_LAZY_SUBCOMMANDS || process.env.CLAWDBOT_DISABLE_LAZY_SUBCOMMANDS))
+    if (isTruthyEnvValue(process.env.POOLBOT_DISABLE_LAZY_SUBCOMMANDS)) {
         return false;
-    if (hasHelpOrVersion(argv))
+    }
+    if (hasHelpOrVersion(argv)) {
         return false;
+    }
     return true;
 };
 const shouldEagerRegisterSubcommands = (_argv) => {
-    return isTruthyEnvValue(process.env.POOLBOT_DISABLE_LAZY_SUBCOMMANDS || process.env.CLAWDBOT_DISABLE_LAZY_SUBCOMMANDS);
+    return isTruthyEnvValue(process.env.POOLBOT_DISABLE_LAZY_SUBCOMMANDS);
 };
 const loadConfig = async () => {
     const mod = await import("../../config/config.js");
     return mod.loadConfig();
 };
+// Note for humans and agents:
+// If you update the list of commands, also check whether they have subcommands
+// and set the flag accordingly.
 const entries = [
     {
         name: "acp",
         description: "Agent Control Protocol tools",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../acp-cli.js");
             mod.registerAcpCli(program);
@@ -26,7 +33,8 @@ const entries = [
     },
     {
         name: "gateway",
-        description: "Gateway control",
+        description: "Run, inspect, and query the WebSocket Gateway",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../gateway-cli.js");
             mod.registerGatewayCli(program);
@@ -35,6 +43,7 @@ const entries = [
     {
         name: "daemon",
         description: "Gateway service (legacy alias)",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../daemon-cli.js");
             mod.registerDaemonCli(program);
@@ -42,7 +51,8 @@ const entries = [
     },
     {
         name: "logs",
-        description: "Gateway logs",
+        description: "Tail gateway file logs via RPC",
+        hasSubcommands: false,
         register: async (program) => {
             const mod = await import("../logs-cli.js");
             mod.registerLogsCli(program);
@@ -51,6 +61,7 @@ const entries = [
     {
         name: "system",
         description: "System events, heartbeat, and presence",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../system-cli.js");
             mod.registerSystemCli(program);
@@ -58,7 +69,8 @@ const entries = [
     },
     {
         name: "models",
-        description: "Model configuration",
+        description: "Discover, scan, and configure models",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../models-cli.js");
             mod.registerModelsCli(program);
@@ -66,7 +78,8 @@ const entries = [
     },
     {
         name: "approvals",
-        description: "Exec approvals",
+        description: "Manage exec approvals (gateway or node host)",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../exec-approvals-cli.js");
             mod.registerExecApprovalsCli(program);
@@ -74,7 +87,8 @@ const entries = [
     },
     {
         name: "nodes",
-        description: "Node commands",
+        description: "Manage gateway-owned node pairing and node commands",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../nodes-cli.js");
             mod.registerNodesCli(program);
@@ -83,6 +97,7 @@ const entries = [
     {
         name: "devices",
         description: "Device pairing + token management",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../devices-cli.js");
             mod.registerDevicesCli(program);
@@ -90,7 +105,8 @@ const entries = [
     },
     {
         name: "node",
-        description: "Node control",
+        description: "Run and manage the headless node host service",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../node-cli.js");
             mod.registerNodeCli(program);
@@ -98,7 +114,8 @@ const entries = [
     },
     {
         name: "sandbox",
-        description: "Sandbox tools",
+        description: "Manage sandbox containers for agent isolation",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../sandbox-cli.js");
             mod.registerSandboxCli(program);
@@ -106,7 +123,8 @@ const entries = [
     },
     {
         name: "tui",
-        description: "Terminal UI",
+        description: "Open a terminal UI connected to the Gateway",
+        hasSubcommands: false,
         register: async (program) => {
             const mod = await import("../tui-cli.js");
             mod.registerTuiCli(program);
@@ -114,7 +132,8 @@ const entries = [
     },
     {
         name: "cron",
-        description: "Cron scheduler",
+        description: "Manage cron jobs via the Gateway scheduler",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../cron-cli.js");
             mod.registerCronCli(program);
@@ -122,7 +141,8 @@ const entries = [
     },
     {
         name: "dns",
-        description: "DNS helpers",
+        description: "DNS helpers for wide-area discovery (Tailscale + CoreDNS)",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../dns-cli.js");
             mod.registerDnsCli(program);
@@ -130,7 +150,8 @@ const entries = [
     },
     {
         name: "docs",
-        description: "Docs helpers",
+        description: "Search the live Pool Bot docs",
+        hasSubcommands: false,
         register: async (program) => {
             const mod = await import("../docs-cli.js");
             mod.registerDocsCli(program);
@@ -138,7 +159,8 @@ const entries = [
     },
     {
         name: "hooks",
-        description: "Hooks tooling",
+        description: "Manage internal agent hooks",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../hooks-cli.js");
             mod.registerHooksCli(program);
@@ -146,23 +168,49 @@ const entries = [
     },
     {
         name: "webhooks",
-        description: "Webhook helpers",
+        description: "Webhook helpers and integrations",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../webhooks-cli.js");
             mod.registerWebhooksCli(program);
         },
     },
+    {
+        name: "qr",
+        description: "Generate iOS pairing QR/setup code",
+        hasSubcommands: false,
+        register: async (program) => {
+            const mod = await import("../qr-cli.js");
+            mod.registerQrCli(program);
+        },
+    },
+    {
+        name: "clawbot",
+        description: "Legacy clawbot command aliases",
+        hasSubcommands: true,
+        register: async (program) => {
+            const mod = await import("../clawbot-cli.js");
+            mod.registerClawbotCli(program);
+        },
+    },
     {
         name: "pairing",
-        description: "Pairing helpers",
+        description: "Secure DM pairing (approve inbound requests)",
+        hasSubcommands: true,
         register: async (program) => {
+            // Initialize plugins before registering pairing CLI.
+            // The pairing CLI calls listPairingChannels() at registration time,
+            // which requires the plugin registry to be populated with channel plugins.
+            const { registerPluginCliCommands } = await import("../../plugins/cli.js");
+            registerPluginCliCommands(program, await loadConfig());
             const mod = await import("../pairing-cli.js");
             mod.registerPairingCli(program);
         },
     },
     {
         name: "plugins",
-        description: "Plugin management",
+        description: "Manage Pool Bot plugins and extensions",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../plugins-cli.js");
             mod.registerPluginsCli(program);
@@ -172,7 +220,8 @@ const entries = [
     },
     {
         name: "channels",
-        description: "Channel management",
+        description: "Manage connected chat channels (Telegram, Discord, etc.)",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../channels-cli.js");
             mod.registerChannelsCli(program);
@@ -180,7 +229,8 @@ const entries = [
     },
     {
         name: "directory",
-        description: "Directory commands",
+        description: "Lookup contact and group IDs (self, peers, groups) for supported chat channels",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../directory-cli.js");
             mod.registerDirectoryCli(program);
@@ -188,7 +238,8 @@ const entries = [
     },
     {
         name: "security",
-        description: "Security helpers",
+        description: "Security tools and local config audits",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../security-cli.js");
             mod.registerSecurityCli(program);
@@ -196,7 +247,8 @@ const entries = [
     },
     {
         name: "skills",
-        description: "Skills management",
+        description: "List and inspect available skills",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../skills-cli.js");
             mod.registerSkillsCli(program);
@@ -204,34 +256,35 @@ const entries = [
     },
     {
         name: "update",
-        description: "CLI update helpers",
+        description: "Update Pool Bot and inspect update channel status",
+        hasSubcommands: true,
         register: async (program) => {
             const mod = await import("../update-cli.js");
             mod.registerUpdateCli(program);
         },
     },
+    {
+        name: "completion",
+        description: "Generate shell completion script",
+        hasSubcommands: false,
+        register: async (program) => {
+            const mod = await import("../completion-cli.js");
+            mod.registerCompletionCli(program);
+        },
+    },
 ];
-function removeCommand(program, command) {
-    const commands = program.commands;
-    const index = commands.indexOf(command);
-    if (index >= 0) {
-        commands.splice(index, 1);
-    }
-}
 export function getSubCliEntries() {
-    return entries.map((e) => ({ name: e.name, description: e.description }));
+    return entries;
 }
 export function getSubCliCommandsWithSubcommands() {
-    // Sub-CLI commands all potentially have subcommands
-    return entries.map((e) => e.name);
+    return entries.filter((entry) => entry.hasSubcommands).map((entry) => entry.name);
 }
 export async function registerSubCliByName(program, name) {
     const entry = entries.find((candidate) => candidate.name === name);
-    if (!entry)
+    if (!entry) {
         return false;
-    const existing = program.commands.find((cmd) => cmd.name() === entry.name);
-    if (existing)
-        removeCommand(program, existing);
+    }
+    removeCommandByName(program, entry.name);
     await entry.register(program);
     return true;
 }
@@ -242,19 +295,7 @@ function registerLazyCommand(program, entry) {
     placeholder.action(async (...actionArgs) => {
         removeCommand(program, placeholder);
         await entry.register(program);
-        const actionCommand = actionArgs.at(-1);
-        const root = actionCommand?.parent ?? program;
-        const rawArgs = root.rawArgs;
-        const actionArgsList = resolveActionArgs(actionCommand);
-        const fallbackArgv = actionCommand?.name()
-            ? [actionCommand.name(), ...actionArgsList]
-            : actionArgsList;
-        const parseArgv = buildParseArgv({
-            programName: program.name(),
-            rawArgs,
-            fallbackArgv,
-        });
-        await program.parseAsync(parseArgv);
+        await reparseProgramFromActionArgs(program, actionArgs);
     });
 }
 export function registerSubCliCommands(program, argv = process.argv) {

package/dist/cli/route.js

@@ -1,11 +1,11 @@
-import { defaultRuntime } from "../runtime.js";
-import { ensurePluginRegistryLoaded } from "./plugin-registry.js";
 import { isTruthyEnvValue } from "../infra/env.js";
-import { emitCliBanner } from "./banner.js";
+import { defaultRuntime } from "../runtime.js";
 import { VERSION } from "../version.js";
 import { getCommandPath, hasHelpOrVersion } from "./argv.js";
+import { emitCliBanner } from "./banner.js";
+import { ensurePluginRegistryLoaded } from "./plugin-registry.js";
 import { ensureConfigReady } from "./program/config-guard.js";
-import { findRoutedCommand } from "./program/command-registry.js";
+import { findRoutedCommand } from "./program/routes.js";
 async function prepareRoutedCommand(params) {
     emitCliBanner(VERSION, { argv: params.argv });
     await ensureConfigReady({ runtime: defaultRuntime, commandPath: params.commandPath });
@@ -14,16 +14,20 @@ async function prepareRoutedCommand(params) {
     }
 }
 export async function tryRouteCli(argv) {
-    if (isTruthyEnvValue(process.env.POOLBOT_DISABLE_ROUTE_FIRST || process.env.CLAWDBOT_DISABLE_ROUTE_FIRST))
+    if (isTruthyEnvValue(process.env.POOLBOT_DISABLE_ROUTE_FIRST)) {
         return false;
-    if (hasHelpOrVersion(argv))
+    }
+    if (hasHelpOrVersion(argv)) {
         return false;
+    }
     const path = getCommandPath(argv, 2);
-    if (!path[0])
+    if (!path[0]) {
         return false;
+    }
     const route = findRoutedCommand(path);
-    if (!route)
+    if (!route) {
         return false;
+    }
     await prepareRoutedCommand({ argv, commandPath: path, loadPlugins: route.loadPlugins });
     return route.run(argv);
 }

package/dist/cli/system-cli.js

@@ -5,12 +5,29 @@ import { theme } from "../terminal/theme.js";
 import { addGatewayClientOptions, callGatewayFromCli } from "./gateway-rpc.js";
 const normalizeWakeMode = (raw) => {
     const mode = typeof raw === "string" ? raw.trim() : "";
-    if (!mode)
+    if (!mode) {
         return "next-heartbeat";
-    if (mode === "now" || mode === "next-heartbeat")
+    }
+    if (mode === "now" || mode === "next-heartbeat") {
         return mode;
+    }
     throw new Error("--mode must be now or next-heartbeat");
 };
+async function runSystemGatewayCommand(opts, action, successText) {
+    try {
+        const result = await action();
+        if (opts.json || successText === undefined) {
+            defaultRuntime.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            defaultRuntime.log(successText);
+        }
+    }
+    catch (err) {
+        defaultRuntime.error(danger(String(err)));
+        defaultRuntime.exit(1);
+    }
+}
 export function registerSystemCli(program) {
     const system = program
         .command("system")
@@ -22,77 +39,50 @@ export function registerSystemCli(program) {
         .requiredOption("--text <text>", "System event text")
         .option("--mode <mode>", "Wake mode (now|next-heartbeat)", "next-heartbeat")
         .option("--json", "Output JSON", false)).action(async (opts) => {
-        try {
+        await runSystemGatewayCommand(opts, async () => {
             const text = typeof opts.text === "string" ? opts.text.trim() : "";
-            if (!text)
+            if (!text) {
                 throw new Error("--text is required");
+            }
             const mode = normalizeWakeMode(opts.mode);
-            const result = await callGatewayFromCli("wake", opts, { mode, text }, { expectFinal: false });
-            if (opts.json)
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-            else
-                defaultRuntime.log("ok");
-        }
-        catch (err) {
-            defaultRuntime.error(danger(String(err)));
-            defaultRuntime.exit(1);
-        }
+            return await callGatewayFromCli("wake", opts, { mode, text }, { expectFinal: false });
+        }, "ok");
     });
     const heartbeat = system.command("heartbeat").description("Heartbeat controls");
     addGatewayClientOptions(heartbeat
         .command("last")
         .description("Show the last heartbeat event")
         .option("--json", "Output JSON", false)).action(async (opts) => {
-        try {
-            const result = await callGatewayFromCli("last-heartbeat", opts, undefined, {
+        await runSystemGatewayCommand(opts, async () => {
+            return await callGatewayFromCli("last-heartbeat", opts, undefined, {
                 expectFinal: false,
             });
-            defaultRuntime.log(JSON.stringify(result, null, 2));
-        }
-        catch (err) {
-            defaultRuntime.error(danger(String(err)));
-            defaultRuntime.exit(1);
-        }
+        });
     });
     addGatewayClientOptions(heartbeat
         .command("enable")
         .description("Enable heartbeats")
         .option("--json", "Output JSON", false)).action(async (opts) => {
-        try {
-            const result = await callGatewayFromCli("set-heartbeats", opts, { enabled: true }, { expectFinal: false });
-            defaultRuntime.log(JSON.stringify(result, null, 2));
-        }
-        catch (err) {
-            defaultRuntime.error(danger(String(err)));
-            defaultRuntime.exit(1);
-        }
+        await runSystemGatewayCommand(opts, async () => {
+            return await callGatewayFromCli("set-heartbeats", opts, { enabled: true }, { expectFinal: false });
+        });
     });
     addGatewayClientOptions(heartbeat
         .command("disable")
         .description("Disable heartbeats")
         .option("--json", "Output JSON", false)).action(async (opts) => {
-        try {
-            const result = await callGatewayFromCli("set-heartbeats", opts, { enabled: false }, { expectFinal: false });
-            defaultRuntime.log(JSON.stringify(result, null, 2));
-        }
-        catch (err) {
-            defaultRuntime.error(danger(String(err)));
-            defaultRuntime.exit(1);
-        }
+        await runSystemGatewayCommand(opts, async () => {
+            return await callGatewayFromCli("set-heartbeats", opts, { enabled: false }, { expectFinal: false });
+        });
     });
     addGatewayClientOptions(system
         .command("presence")
         .description("List system presence entries")
         .option("--json", "Output JSON", false)).action(async (opts) => {
-        try {
-            const result = await callGatewayFromCli("system-presence", opts, undefined, {
+        await runSystemGatewayCommand(opts, async () => {
+            return await callGatewayFromCli("system-presence", opts, undefined, {
                 expectFinal: false,
             });
-            defaultRuntime.log(JSON.stringify(result, null, 2));
-        }
-        catch (err) {
-            defaultRuntime.error(danger(String(err)));
-            defaultRuntime.exit(1);
-        }
+        });
     });
 }

package/dist/cli/test-runtime-capture.js

@@ -0,0 +1,24 @@
+export function createCliRuntimeCapture() {
+    const runtimeLogs = [];
+    const runtimeErrors = [];
+    const stringifyArgs = (args) => args.map((value) => String(value)).join(" ");
+    return {
+        runtimeLogs,
+        runtimeErrors,
+        defaultRuntime: {
+            log: (...args) => {
+                runtimeLogs.push(stringifyArgs(args));
+            },
+            error: (...args) => {
+                runtimeErrors.push(stringifyArgs(args));
+            },
+            exit: (code) => {
+                throw new Error(`__exit__:${code}`);
+            },
+        },
+        resetRuntimeCapture: () => {
+            runtimeLogs.length = 0;
+            runtimeErrors.length = 0;
+        },
+    };
+}

package/dist/cli/update-cli/shared.js

@@ -13,9 +13,19 @@ import { runCommandWithTimeout } from "../../process/exec.js";
 import { defaultRuntime } from "../../runtime.js";
 import { theme } from "../../terminal/theme.js";
 import { pathExists } from "../../utils.js";
-const POOLBOT_REPO_URL = "https://github.com/poolbot/poolbot.git";
+const INVALID_TIMEOUT_ERROR = "--timeout must be a positive integer (seconds)";
+export function parseTimeoutMsOrExit(timeout) {
+    const timeoutMs = timeout ? Number.parseInt(timeout, 10) * 1000 : undefined;
+    if (timeoutMs !== undefined && (Number.isNaN(timeoutMs) || timeoutMs <= 0)) {
+        defaultRuntime.error(INVALID_TIMEOUT_ERROR);
+        defaultRuntime.exit(1);
+        return null;
+    }
+    return timeoutMs;
+}
+const POOLBOT_REPO_URL = "https://github.com/plcunha/pool-bot.git";
 const MAX_LOG_CHARS = 8000;
-export const DEFAULT_PACKAGE_NAME = "poolbot";
+export const DEFAULT_PACKAGE_NAME = "@poolzin/pool-bot";
 const CORE_PACKAGE_NAMES = new Set([DEFAULT_PACKAGE_NAME]);
 export function normalizeTag(value) {
     if (!value) {
@@ -25,8 +35,8 @@ export function normalizeTag(value) {
     if (!trimmed) {
         return null;
     }
-    if (trimmed.startsWith("poolbot@")) {
-        return trimmed.slice("poolbot@".length);
+    if (trimmed.startsWith("pool-bot@")) {
+        return trimmed.slice("pool-bot@".length);
     }
     if (trimmed.startsWith(`${DEFAULT_PACKAGE_NAME}@`)) {
         return trimmed.slice(`${DEFAULT_PACKAGE_NAME}@`.length);
@@ -143,7 +153,7 @@ export async function ensureGitCheckout(params) {
     if (!(await isGitCheckout(params.dir))) {
         const empty = await isEmptyDir(params.dir);
         if (!empty) {
-            throw new Error(`POOLBOT_GIT_DIR points at a non-git directory: ${params.dir}. Set POOLBOT_GIT_DIR to an empty folder or an poolbot checkout.`);
+            throw new Error(`POOLBOT_GIT_DIR points at a non-git directory: ${params.dir}. Set POOLBOT_GIT_DIR to an empty folder or a pool-bot checkout.`);
         }
         return await runUpdateStep({
             name: "git clone",
@@ -159,10 +169,7 @@ export async function ensureGitCheckout(params) {
     return null;
 }
 export async function resolveGlobalManager(params) {
-    const runCommand = async (argv, options) => {
-        const res = await runCommandWithTimeout(argv, options);
-        return { stdout: res.stdout, stderr: res.stderr, code: res.code };
-    };
+    const runCommand = createGlobalCommandRunner();
     if (params.installKind === "package") {
         const detected = await detectGlobalInstallManagerForRoot(runCommand, params.root, params.timeoutMs);
         if (detected) {
@@ -194,3 +201,9 @@ export async function tryWriteCompletionCache(root, jsonMode) {
         defaultRuntime.log(theme.warn(`Completion cache update failed${detail}.`));
     }
 }
+export function createGlobalCommandRunner() {
+    return async (argv, options) => {
+        const res = await runCommandWithTimeout(argv, options);
+        return { stdout: res.stdout, stderr: res.stderr, code: res.code };
+    };
+}