clawdbot 2026.1.4-1

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

@@ -0,0 +1,286 @@
+import { browserCloseTab, browserCreateProfile, browserDeleteProfile, browserFocusTab, browserOpenTab, browserProfiles, browserResetProfile, browserStart, browserStatus, browserStop, browserTabs, resolveBrowserControlUrl, } from "../browser/client.js";
+import { browserAct } from "../browser/client-actions-core.js";
+import { danger, info } from "../globals.js";
+import { defaultRuntime } from "../runtime.js";
+export function registerBrowserManageCommands(browser, parentOpts) {
+    browser
+        .command("status")
+        .description("Show browser status")
+        .action(async (_opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        try {
+            const status = await browserStatus(baseUrl, {
+                profile: parent?.profile,
+            });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify(status, null, 2));
+                return;
+            }
+            defaultRuntime.log([
+                `profile: ${status.profile ?? "clawd"}`,
+                `enabled: ${status.enabled}`,
+                `running: ${status.running}`,
+                `controlUrl: ${status.controlUrl}`,
+                `cdpPort: ${status.cdpPort}`,
+                `cdpUrl: ${status.cdpUrl ?? `http://127.0.0.1:${status.cdpPort}`}`,
+                `browser: ${status.chosenBrowser ?? "unknown"}`,
+                `profileColor: ${status.color}`,
+            ].join("\n"));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("start")
+        .description("Start the browser (no-op if already running)")
+        .action(async (_opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        const profile = parent?.profile;
+        try {
+            await browserStart(baseUrl, { profile });
+            const status = await browserStatus(baseUrl, { profile });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify(status, null, 2));
+                return;
+            }
+            const name = status.profile ?? "clawd";
+            defaultRuntime.log(info(`🦞 browser [${name}] running: ${status.running}`));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("stop")
+        .description("Stop the browser (best-effort)")
+        .action(async (_opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        const profile = parent?.profile;
+        try {
+            await browserStop(baseUrl, { profile });
+            const status = await browserStatus(baseUrl, { profile });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify(status, null, 2));
+                return;
+            }
+            const name = status.profile ?? "clawd";
+            defaultRuntime.log(info(`🦞 browser [${name}] running: ${status.running}`));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("reset-profile")
+        .description("Reset browser profile (moves it to Trash)")
+        .action(async (_opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        const profile = parent?.profile;
+        try {
+            const result = await browserResetProfile(baseUrl, { profile });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (!result.moved) {
+                defaultRuntime.log(info(`🦞 browser profile already missing.`));
+                return;
+            }
+            const dest = result.to ?? result.from;
+            defaultRuntime.log(info(`🦞 browser profile moved to Trash (${dest})`));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("tabs")
+        .description("List open tabs")
+        .action(async (_opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        const profile = parent?.profile;
+        try {
+            const tabs = await browserTabs(baseUrl, { profile });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify({ tabs }, null, 2));
+                return;
+            }
+            if (tabs.length === 0) {
+                defaultRuntime.log("No tabs (browser closed or no targets).");
+                return;
+            }
+            defaultRuntime.log(tabs
+                .map((t, i) => `${i + 1}. ${t.title || "(untitled)"}\n   ${t.url}\n   id: ${t.targetId}`)
+                .join("\n"));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("open")
+        .description("Open a URL in a new tab")
+        .argument("<url>", "URL to open")
+        .action(async (url, _opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        const profile = parent?.profile;
+        try {
+            const tab = await browserOpenTab(baseUrl, url, { profile });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify(tab, null, 2));
+                return;
+            }
+            defaultRuntime.log(`opened: ${tab.url}\nid: ${tab.targetId}`);
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("focus")
+        .description("Focus a tab by target id (or unique prefix)")
+        .argument("<targetId>", "Target id or unique prefix")
+        .action(async (targetId, _opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        const profile = parent?.profile;
+        try {
+            await browserFocusTab(baseUrl, targetId, { profile });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify({ ok: true }, null, 2));
+                return;
+            }
+            defaultRuntime.log(`focused tab ${targetId}`);
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("close")
+        .description("Close a tab (target id optional)")
+        .argument("[targetId]", "Target id or unique prefix (optional)")
+        .action(async (targetId, _opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        const profile = parent?.profile;
+        try {
+            if (targetId?.trim()) {
+                await browserCloseTab(baseUrl, targetId.trim(), { profile });
+            }
+            else {
+                await browserAct(baseUrl, { kind: "close" }, { profile });
+            }
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify({ ok: true }, null, 2));
+                return;
+            }
+            defaultRuntime.log("closed tab");
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    // Profile management commands
+    browser
+        .command("profiles")
+        .description("List all browser profiles")
+        .action(async (_opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        try {
+            const profiles = await browserProfiles(baseUrl);
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify({ profiles }, null, 2));
+                return;
+            }
+            if (profiles.length === 0) {
+                defaultRuntime.log("No profiles configured.");
+                return;
+            }
+            defaultRuntime.log(profiles
+                .map((p) => {
+                const status = p.running ? "running" : "stopped";
+                const tabs = p.running ? ` (${p.tabCount} tabs)` : "";
+                const def = p.isDefault ? " [default]" : "";
+                const loc = p.isRemote
+                    ? `cdpUrl: ${p.cdpUrl}`
+                    : `port: ${p.cdpPort}`;
+                const remote = p.isRemote ? " [remote]" : "";
+                return `${p.name}: ${status}${tabs}${def}${remote}\n  ${loc}, color: ${p.color}`;
+            })
+                .join("\n"));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("create-profile")
+        .description("Create a new browser profile")
+        .requiredOption("--name <name>", "Profile name (lowercase, numbers, hyphens)")
+        .option("--color <hex>", "Profile color (hex format, e.g. #0066CC)")
+        .option("--cdp-url <url>", "CDP URL for remote Chrome (http/https)")
+        .action(async (opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        try {
+            const result = await browserCreateProfile(baseUrl, {
+                name: opts.name,
+                color: opts.color,
+                cdpUrl: opts.cdpUrl,
+            });
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            const loc = result.isRemote
+                ? `  cdpUrl: ${result.cdpUrl}`
+                : `  port: ${result.cdpPort}`;
+            defaultRuntime.log(info(`🦞 Created profile "${result.profile}"\n${loc}\n  color: ${result.color}`));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+    browser
+        .command("delete-profile")
+        .description("Delete a browser profile")
+        .requiredOption("--name <name>", "Profile name to delete")
+        .action(async (opts, cmd) => {
+        const parent = parentOpts(cmd);
+        const baseUrl = resolveBrowserControlUrl(parent?.url);
+        try {
+            const result = await browserDeleteProfile(baseUrl, opts.name);
+            if (parent?.json) {
+                defaultRuntime.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            const msg = result.deleted
+                ? `🦞 Deleted profile "${result.profile}" (user data removed)`
+                : `🦞 Deleted profile "${result.profile}" (no user data found)`;
+            defaultRuntime.log(info(msg));
+        }
+        catch (err) {
+            defaultRuntime.error(danger(String(err)));
+            defaultRuntime.exit(1);
+        }
+    });
+}

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

@@ -0,0 +1 @@
+export {};

package/dist/cli/browser-cli.js

@@ -0,0 +1,26 @@
+import { danger } from "../globals.js";
+import { defaultRuntime } from "../runtime.js";
+import { registerBrowserActionInputCommands } from "./browser-cli-actions-input.js";
+import { registerBrowserActionObserveCommands } from "./browser-cli-actions-observe.js";
+import { browserActionExamples, browserCoreExamples, } from "./browser-cli-examples.js";
+import { registerBrowserInspectCommands } from "./browser-cli-inspect.js";
+import { registerBrowserManageCommands } from "./browser-cli-manage.js";
+export function registerBrowserCli(program) {
+    const browser = program
+        .command("browser")
+        .description("Manage clawd's dedicated browser (Chrome/Chromium)")
+        .option("--url <url>", "Override browser control URL (default from ~/.clawdbot/clawdbot.json)")
+        .option("--profile <name>", "Browser profile name (default from config)")
+        .option("--json", "Output machine-readable JSON", false)
+        .addHelpText("after", `\nExamples:\n  ${[...browserCoreExamples, ...browserActionExamples].join("\n  ")}\n`)
+        .action(() => {
+        browser.outputHelp();
+        defaultRuntime.error(danger('Missing subcommand. Try: "clawdbot browser status"'));
+        defaultRuntime.exit(1);
+    });
+    const parentOpts = (cmd) => cmd.parent?.opts?.();
+    registerBrowserManageCommands(browser, parentOpts);
+    registerBrowserInspectCommands(browser, parentOpts);
+    registerBrowserActionInputCommands(browser, parentOpts);
+    registerBrowserActionObserveCommands(browser, parentOpts);
+}