@poolzin/pool-bot 2026.2.21 → 2026.2.23

package/dist/cli/browser-cli-extension.js

@@ -1,31 +1,42 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { STATE_DIR } from "../config/paths.js";
+import { movePathToTrash } from "../browser/trash.js";
+import { resolveStateDir } from "../config/paths.js";
 import { danger, info } from "../globals.js";
 import { copyToClipboard } from "../infra/clipboard.js";
 import { defaultRuntime } from "../runtime.js";
-import { movePathToTrash } from "../browser/trash.js";
 import { formatDocsLink } from "../terminal/links.js";
 import { theme } from "../terminal/theme.js";
 import { shortenHomePath } from "../utils.js";
 import { formatCliCommand } from "./command-format.js";
-function bundledExtensionRootDir() {
-    const here = path.dirname(fileURLToPath(import.meta.url));
+export function resolveBundledExtensionRootDir(here = path.dirname(fileURLToPath(import.meta.url))) {
+    let current = here;
+    while (true) {
+        const candidate = path.join(current, "assets", "chrome-extension");
+        if (hasManifest(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
     return path.resolve(here, "../../assets/chrome-extension");
 }
 function installedExtensionRootDir() {
-    return path.join(STATE_DIR, "browser", "chrome-extension");
+    return path.join(resolveStateDir(), "browser", "chrome-extension");
 }
 function hasManifest(dir) {
     return fs.existsSync(path.join(dir, "manifest.json"));
 }
 export async function installChromeExtension(opts) {
-    const src = opts?.sourceDir ?? bundledExtensionRootDir();
+    const src = opts?.sourceDir ?? resolveBundledExtensionRootDir();
     if (!hasManifest(src)) {
-        throw new Error("Bundled Chrome extension is missing. Reinstall Poolbot and try again.");
+        throw new Error("Bundled Chrome extension is missing. Reinstall Pool Bot and try again.");
     }
-    const stateDir = opts?.stateDir ?? STATE_DIR;
+    const stateDir = opts?.stateDir ?? resolveStateDir();
     const dest = path.join(stateDir, "browser", "chrome-extension");
     fs.mkdirSync(path.dirname(dest), { recursive: true });
     if (fs.existsSync(dest)) {
@@ -54,6 +65,7 @@ export function registerBrowserExtensionCommands(browser, parentOpts) {
         catch (err) {
             defaultRuntime.error(danger(String(err)));
             defaultRuntime.exit(1);
+            return;
         }
         if (parent?.json) {
             defaultRuntime.log(JSON.stringify({ ok: true, path: installed.path }, null, 2));
@@ -67,9 +79,9 @@ export function registerBrowserExtensionCommands(browser, parentOpts) {
             "Next:",
             `- Chrome → chrome://extensions → enable “Developer mode”`,
             `- “Load unpacked” → select: ${displayPath}`,
-            `- Pin “Poolbot Browser Relay”, then click it on the tab (badge shows ON)`,
+            `- Pin “Pool Bot Browser Relay”, then click it on the tab (badge shows ON)`,
             "",
-            `${theme.muted("Docs:")} ${formatDocsLink("/tools/chrome-extension", "docs.molt.bot/tools/chrome-extension")}`,
+            `${theme.muted("Docs:")} ${formatDocsLink("/tools/chrome-extension", "docs.poolbot.ai/tools/chrome-extension")}`,
         ].join("\n")));
     });
     ext
@@ -81,7 +93,7 @@ export function registerBrowserExtensionCommands(browser, parentOpts) {
         if (!hasManifest(dir)) {
             defaultRuntime.error(danger([
                 `Chrome extension is not installed. Run: "${formatCliCommand("poolbot browser extension install")}"`,
-                `Docs: ${formatDocsLink("/tools/chrome-extension", "docs.molt.bot/tools/chrome-extension")}`,
+                `Docs: ${formatDocsLink("/tools/chrome-extension", "docs.poolbot.ai/tools/chrome-extension")}`,
             ].join("\n")));
             defaultRuntime.exit(1);
         }
@@ -92,7 +104,8 @@ export function registerBrowserExtensionCommands(browser, parentOpts) {
         const displayPath = shortenHomePath(dir);
         defaultRuntime.log(displayPath);
         const copied = await copyToClipboard(dir).catch(() => false);
-        if (copied)
+        if (copied) {
             defaultRuntime.error(info("Copied to clipboard."));
+        }
     });
 }

package/dist/cli/browser-cli-state.cookies-storage.js

@@ -1,6 +1,19 @@
 import { danger } from "../globals.js";
 import { defaultRuntime } from "../runtime.js";
 import { callBrowserRequest } from "./browser-cli-shared.js";
+import { inheritOptionFromParent } from "./command-options.js";
+function resolveTargetId(rawTargetId, command) {
+    const local = typeof rawTargetId === "string" ? rawTargetId.trim() : "";
+    if (local) {
+        return local;
+    }
+    const inherited = inheritOptionFromParent(command, "targetId");
+    if (typeof inherited !== "string") {
+        return undefined;
+    }
+    const trimmed = inherited.trim();
+    return trimmed ? trimmed : undefined;
+}
 export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
     const cookies = browser.command("cookies").description("Read/write cookies");
     cookies
@@ -8,12 +21,13 @@ export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
         .action(async (opts, cmd) => {
         const parent = parentOpts(cmd);
         const profile = parent?.browserProfile;
+        const targetId = resolveTargetId(opts.targetId, cmd);
         try {
             const result = await callBrowserRequest(parent, {
                 method: "GET",
                 path: "/cookies",
                 query: {
-                    targetId: opts.targetId?.trim() || undefined,
+                    targetId,
                     profile,
                 },
             }, { timeoutMs: 20000 });
@@ -38,13 +52,14 @@ export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
         .action(async (name, value, opts, cmd) => {
         const parent = parentOpts(cmd);
         const profile = parent?.browserProfile;
+        const targetId = resolveTargetId(opts.targetId, cmd);
         try {
             const result = await callBrowserRequest(parent, {
                 method: "POST",
                 path: "/cookies/set",
                 query: profile ? { profile } : undefined,
                 body: {
-                    targetId: opts.targetId?.trim() || undefined,
+                    targetId,
                     cookie: { name, value, url: opts.url },
                 },
             }, { timeoutMs: 20000 });
@@ -66,13 +81,14 @@ export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
         .action(async (opts, cmd) => {
         const parent = parentOpts(cmd);
         const profile = parent?.browserProfile;
+        const targetId = resolveTargetId(opts.targetId, cmd);
         try {
             const result = await callBrowserRequest(parent, {
                 method: "POST",
                 path: "/cookies/clear",
                 query: profile ? { profile } : undefined,
                 body: {
-                    targetId: opts.targetId?.trim() || undefined,
+                    targetId,
                 },
             }, { timeoutMs: 20000 });
             if (parent?.json) {
@@ -97,13 +113,14 @@ export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
             .action(async (key, opts, cmd2) => {
             const parent = parentOpts(cmd2);
             const profile = parent?.browserProfile;
+            const targetId = resolveTargetId(opts.targetId, cmd2);
             try {
                 const result = await callBrowserRequest(parent, {
                     method: "GET",
                     path: `/storage/${kind}`,
                     query: {
                         key: key?.trim() || undefined,
-                        targetId: opts.targetId?.trim() || undefined,
+                        targetId,
                         profile,
                     },
                 }, { timeoutMs: 20000 });
@@ -127,6 +144,7 @@ export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
             .action(async (key, value, opts, cmd2) => {
             const parent = parentOpts(cmd2);
             const profile = parent?.browserProfile;
+            const targetId = resolveTargetId(opts.targetId, cmd2);
             try {
                 const result = await callBrowserRequest(parent, {
                     method: "POST",
@@ -135,7 +153,7 @@ export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
                     body: {
                         key,
                         value,
-                        targetId: opts.targetId?.trim() || undefined,
+                        targetId,
                     },
                 }, { timeoutMs: 20000 });
                 if (parent?.json) {
@@ -156,13 +174,14 @@ export function registerBrowserCookiesAndStorageCommands(browser, parentOpts) {
             .action(async (opts, cmd2) => {
             const parent = parentOpts(cmd2);
             const profile = parent?.browserProfile;
+            const targetId = resolveTargetId(opts.targetId, cmd2);
             try {
                 const result = await callBrowserRequest(parent, {
                     method: "POST",
                     path: `/storage/${kind}/clear`,
                     query: profile ? { profile } : undefined,
                     body: {
-                        targetId: opts.targetId?.trim() || undefined,
+                        targetId,
                     },
                 }, { timeoutMs: 20000 });
                 if (parent?.json) {

package/dist/cli/browser-cli-state.js

@@ -1,6 +1,7 @@
 import { danger } from "../globals.js";
 import { defaultRuntime } from "../runtime.js";
 import { parseBooleanValue } from "../utils/boolean.js";
+import { runBrowserResizeWithOutput } from "./browser-cli-resize.js";
 import { callBrowserRequest } from "./browser-cli-shared.js";
 import { registerBrowserCookiesAndStorageCommands } from "./browser-cli-state.cookies-storage.js";
 import { runCommandWithRuntime } from "./cli-utils.js";
@@ -14,6 +15,22 @@ function runBrowserCommand(action) {
         defaultRuntime.exit(1);
     });
 }
+async function runBrowserSetRequest(params) {
+    await runBrowserCommand(async () => {
+        const profile = params.parent?.browserProfile;
+        const result = await callBrowserRequest(params.parent, {
+            method: "POST",
+            path: params.path,
+            query: profile ? { profile } : undefined,
+            body: params.body,
+        }, { timeoutMs: 20000 });
+        if (params.parent?.json) {
+            defaultRuntime.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        defaultRuntime.log(params.successMessage);
+    });
+}
 export function registerBrowserStateCommands(browser, parentOpts) {
     registerBrowserCookiesAndStorageCommands(browser, parentOpts);
     const set = browser.command("set").description("Browser environment settings");
@@ -26,28 +43,16 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .action(async (width, height, opts, cmd) => {
         const parent = parentOpts(cmd);
         const profile = parent?.browserProfile;
-        if (!Number.isFinite(width) || !Number.isFinite(height)) {
-            defaultRuntime.error(danger("width and height must be numbers"));
-            defaultRuntime.exit(1);
-            return;
-        }
         await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/act",
-                query: profile ? { profile } : undefined,
-                body: {
-                    kind: "resize",
-                    width,
-                    height,
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(`viewport set: ${width}x${height}`);
+            await runBrowserResizeWithOutput({
+                parent,
+                profile,
+                width,
+                height,
+                targetId: opts.targetId,
+                timeoutMs: 20000,
+                successMessage: `viewport set: ${width}x${height}`,
+            });
         });
     });
     set
@@ -57,48 +62,47 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .option("--target-id <id>", "CDP target id (or unique prefix)")
         .action(async (value, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
         const offline = parseOnOff(value);
         if (offline === null) {
             defaultRuntime.error(danger("Expected on|off"));
             defaultRuntime.exit(1);
             return;
         }
-        await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/set/offline",
-                query: profile ? { profile } : undefined,
-                body: {
-                    offline,
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(`offline: ${offline}`);
+        await runBrowserSetRequest({
+            parent,
+            path: "/set/offline",
+            body: {
+                offline,
+                targetId: opts.targetId?.trim() || undefined,
+            },
+            successMessage: `offline: ${offline}`,
         });
     });
     set
         .command("headers")
         .description("Set extra HTTP headers (JSON object)")
-        .requiredOption("--json <json>", "JSON object of headers")
+        .argument("[headersJson]", "JSON object of headers (alternative to --headers-json)")
+        .option("--headers-json <json>", "JSON object of headers")
         .option("--target-id <id>", "CDP target id (or unique prefix)")
-        .action(async (opts, cmd) => {
+        .action(async (headersJson, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
         await runBrowserCommand(async () => {
-            const parsed = JSON.parse(String(opts.json));
+            const headersJsonValue = (typeof opts.headersJson === "string" && opts.headersJson.trim()) ||
+                (headersJson?.trim() ? headersJson.trim() : undefined);
+            if (!headersJsonValue) {
+                throw new Error("Missing headers JSON (pass --headers-json or positional JSON argument)");
+            }
+            const parsed = JSON.parse(String(headersJsonValue));
             if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-                throw new Error("headers json must be an object");
+                throw new Error("Headers JSON must be a JSON object");
             }
             const headers = {};
             for (const [k, v] of Object.entries(parsed)) {
-                if (typeof v === "string")
+                if (typeof v === "string") {
                     headers[k] = v;
+                }
             }
+            const profile = parent?.browserProfile;
             const result = await callBrowserRequest(parent, {
                 method: "POST",
                 path: "/set/headers",
@@ -124,24 +128,16 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .option("--target-id <id>", "CDP target id (or unique prefix)")
         .action(async (username, password, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
-        await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/set/credentials",
-                query: profile ? { profile } : undefined,
-                body: {
-                    username: username?.trim() || undefined,
-                    password,
-                    clear: Boolean(opts.clear),
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(opts.clear ? "credentials cleared" : "credentials set");
+        await runBrowserSetRequest({
+            parent,
+            path: "/set/credentials",
+            body: {
+                username: username?.trim() || undefined,
+                password,
+                clear: Boolean(opts.clear),
+                targetId: opts.targetId?.trim() || undefined,
+            },
+            successMessage: opts.clear ? "credentials cleared" : "credentials set",
         });
     });
     set
@@ -155,26 +151,18 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .option("--target-id <id>", "CDP target id (or unique prefix)")
         .action(async (latitude, longitude, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
-        await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/set/geolocation",
-                query: profile ? { profile } : undefined,
-                body: {
-                    latitude: Number.isFinite(latitude) ? latitude : undefined,
-                    longitude: Number.isFinite(longitude) ? longitude : undefined,
-                    accuracy: Number.isFinite(opts.accuracy) ? opts.accuracy : undefined,
-                    origin: opts.origin?.trim() || undefined,
-                    clear: Boolean(opts.clear),
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(opts.clear ? "geolocation cleared" : "geolocation set");
+        await runBrowserSetRequest({
+            parent,
+            path: "/set/geolocation",
+            body: {
+                latitude: Number.isFinite(latitude) ? latitude : undefined,
+                longitude: Number.isFinite(longitude) ? longitude : undefined,
+                accuracy: Number.isFinite(opts.accuracy) ? opts.accuracy : undefined,
+                origin: opts.origin?.trim() || undefined,
+                clear: Boolean(opts.clear),
+                targetId: opts.targetId?.trim() || undefined,
+            },
+            successMessage: opts.clear ? "geolocation cleared" : "geolocation set",
         });
     });
     set
@@ -184,7 +172,6 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .option("--target-id <id>", "CDP target id (or unique prefix)")
         .action(async (value, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
         const v = value.trim().toLowerCase();
         const colorScheme = v === "dark" ? "dark" : v === "light" ? "light" : v === "none" ? "none" : null;
         if (!colorScheme) {
@@ -192,21 +179,14 @@ export function registerBrowserStateCommands(browser, parentOpts) {
             defaultRuntime.exit(1);
             return;
         }
-        await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/set/media",
-                query: profile ? { profile } : undefined,
-                body: {
-                    colorScheme,
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(`media colorScheme: ${colorScheme}`);
+        await runBrowserSetRequest({
+            parent,
+            path: "/set/media",
+            body: {
+                colorScheme,
+                targetId: opts.targetId?.trim() || undefined,
+            },
+            successMessage: `media colorScheme: ${colorScheme}`,
         });
     });
     set
@@ -216,22 +196,14 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .option("--target-id <id>", "CDP target id (or unique prefix)")
         .action(async (timezoneId, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
-        await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/set/timezone",
-                query: profile ? { profile } : undefined,
-                body: {
-                    timezoneId,
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(`timezone: ${timezoneId}`);
+        await runBrowserSetRequest({
+            parent,
+            path: "/set/timezone",
+            body: {
+                timezoneId,
+                targetId: opts.targetId?.trim() || undefined,
+            },
+            successMessage: `timezone: ${timezoneId}`,
         });
     });
     set
@@ -241,22 +213,14 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .option("--target-id <id>", "CDP target id (or unique prefix)")
         .action(async (locale, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
-        await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/set/locale",
-                query: profile ? { profile } : undefined,
-                body: {
-                    locale,
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(`locale: ${locale}`);
+        await runBrowserSetRequest({
+            parent,
+            path: "/set/locale",
+            body: {
+                locale,
+                targetId: opts.targetId?.trim() || undefined,
+            },
+            successMessage: `locale: ${locale}`,
         });
     });
     set
@@ -266,22 +230,14 @@ export function registerBrowserStateCommands(browser, parentOpts) {
         .option("--target-id <id>", "CDP target id (or unique prefix)")
         .action(async (name, opts, cmd) => {
         const parent = parentOpts(cmd);
-        const profile = parent?.browserProfile;
-        await runBrowserCommand(async () => {
-            const result = await callBrowserRequest(parent, {
-                method: "POST",
-                path: "/set/device",
-                query: profile ? { profile } : undefined,
-                body: {
-                    name,
-                    targetId: opts.targetId?.trim() || undefined,
-                },
-            }, { timeoutMs: 20000 });
-            if (parent?.json) {
-                defaultRuntime.log(JSON.stringify(result, null, 2));
-                return;
-            }
-            defaultRuntime.log(`device: ${name}`);
+        await runBrowserSetRequest({
+            parent,
+            path: "/set/device",
+            body: {
+                name,
+                targetId: opts.targetId?.trim() || undefined,
+            },
+            successMessage: `device: ${name}`,
         });
     });
 }

package/dist/cli/command-options.js

@@ -4,3 +4,31 @@ export function hasExplicitOptions(command, names) {
     }
     return names.some((name) => command.getOptionValueSource(name) === "cli");
 }
+function getOptionSource(command, name) {
+    if (typeof command.getOptionValueSource !== "function") {
+        return undefined;
+    }
+    return command.getOptionValueSource(name);
+}
+// Defensive guardrail: allow expected parent/grandparent inheritance without unbounded deep traversal.
+const MAX_INHERIT_DEPTH = 2;
+export function inheritOptionFromParent(command, name) {
+    if (!command) {
+        return undefined;
+    }
+    const childSource = getOptionSource(command, name);
+    if (childSource && childSource !== "default") {
+        return undefined;
+    }
+    let depth = 0;
+    let ancestor = command.parent;
+    while (ancestor && depth < MAX_INHERIT_DEPTH) {
+        const source = getOptionSource(ancestor, name);
+        if (source && source !== "default") {
+            return ancestor.opts()[name];
+        }
+        depth += 1;
+        ancestor = ancestor.parent;
+    }
+    return undefined;
+}

package/dist/cli/completion-cli.js

@@ -78,7 +78,7 @@ function formatCompletionSourceLine(shell, binName, cachePath) {
     return `source "${cachePath}"`;
 }
 function isCompletionProfileHeader(line) {
-    return line.trim() === "# OpenClaw Completion";
+    return line.trim() === "# Pool Bot Completion";
 }
 function isCompletionProfileLine(line, binName, cachePath) {
     if (line.includes(`${binName} completion`)) {
@@ -91,7 +91,7 @@ function isCompletionProfileLine(line, binName, cachePath) {
 }
 /** Check if a line uses the slow dynamic completion pattern (source <(...)) */
 function isSlowDynamicCompletionLine(line, binName) {
-    // Matches patterns like: source <(openclaw completion --shell zsh)
+    // Matches patterns like: source <(poolbot completion --shell zsh)
     return (line.includes(`<(${binName} completion`) ||
         (line.includes(`${binName} completion`) && line.includes("| source")));
 }
@@ -113,7 +113,7 @@ function updateCompletionProfile(content, binName, cachePath, sourceLine) {
         filtered.push(line);
     }
     const trimmed = filtered.join("\n").trimEnd();
-    const block = `# OpenClaw Completion\n${sourceLine}`;
+    const block = `# Pool Bot Completion\n${sourceLine}`;
     const next = trimmed ? `${trimmed}\n\n${block}\n` : `${block}\n`;
     return { next, changed: next !== content, hadExisting };
 }
@@ -147,7 +147,7 @@ export async function isCompletionInstalled(shell, binName = "poolbot") {
 }
 /**
  * Check if the profile uses the slow dynamic completion pattern.
- * Returns true if profile has `source <(openclaw completion ...)` instead of cached file.
+ * Returns true if profile has `source <(poolbot completion ...)` instead of cached file.
  */
 export async function usesSlowDynamicCompletion(shell, binName = "poolbot") {
     const profilePath = getShellProfilePath(shell);
@@ -498,7 +498,7 @@ function generateFishCompletion(program) {
             fullPath.push(cmdName);
         } // Only push if not root, or consistent root handling
         // Fish uses 'seen_subcommand_from' to determine context.
-        // For root: complete -c openclaw -n "__fish_use_subcommand" -a "subcmd" -d "desc"
+        // For root: complete -c poolbot -n "__fish_use_subcommand" -a "subcmd" -d "desc"
         // Root logic
         if (parents.length === 0) {
             // Subcommands of root
@@ -531,7 +531,7 @@ function generateFishCompletion(program) {
             // But fish completion logic is simpler if we just say "if we haven't seen THIS command yet but seen parent"
             // Actually, a robust fish completion often requires defining a function to check current line.
             // For simplicity, we'll assume standard fish helper __fish_seen_subcommand_from.
-            // To properly scope to 'openclaw gateway' and not 'openclaw other gateway', we need to check the sequence.
+            // To properly scope to 'poolbot gateway' and not 'poolbot other gateway', we need to check the sequence.
             // A simplified approach:
             // Subcommands
             for (const sub of cmd.commands) {