mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-14 15:20:44 +00:00
fix(browser): lazy-load browser CLI runtime
Co-authored-by: pandego <7780875+pandego@users.noreply.github.com> Co-authored-by: Tianworld <3580442280@qq.com>
This commit is contained in:
Peter Steinberger
@@ -1,12 +1,15 @@
|
||||
import type { Command } from "commander";
|
||||
import { registerBrowserActionInputCommands } from "./browser-cli-actions-input.js";
|
||||
import { registerBrowserActionObserveCommands } from "./browser-cli-actions-observe.js";
|
||||
import { registerBrowserDebugCommands } from "./browser-cli-debug.js";
|
||||
import {
|
||||
buildCommandGroupEntries,
|
||||
registerCommandGroups,
|
||||
resolveCliArgvInvocation,
|
||||
shouldEagerRegisterSubcommands,
|
||||
type CommandGroupEntry,
|
||||
type CommandGroupDescriptorSpec,
|
||||
type NamedCommandDescriptor,
|
||||
} from "openclaw/plugin-sdk/cli-runtime";
|
||||
import { browserActionExamples, browserCoreExamples } from "./browser-cli-examples.js";
|
||||
import { registerBrowserInspectCommands } from "./browser-cli-inspect.js";
|
||||
import { registerBrowserManageCommands } from "./browser-cli-manage.js";
|
||||
import type { BrowserParentOpts } from "./browser-cli-shared.js";
|
||||
import { registerBrowserStateCommands } from "./browser-cli-state.js";
|
||||
import {
|
||||
addGatewayClientOptions,
|
||||
danger,
|
||||
@@ -17,7 +20,211 @@ import {
|
||||
theme,
|
||||
} from "./core-api.js";
|
||||
|
||||
export function registerBrowserCli(program: Command) {
|
||||
type BrowserCommandDescriptor = NamedCommandDescriptor;
|
||||
type BrowserCommandRegistrar = (args: {
|
||||
browser: Command;
|
||||
parentOpts: (cmd: Command) => BrowserParentOpts;
|
||||
}) => Promise<void> | void;
|
||||
|
||||
const browserCommandDescriptors: readonly BrowserCommandDescriptor[] = [
|
||||
{ name: "status", description: "Show browser status", hasSubcommands: false },
|
||||
{
|
||||
name: "start",
|
||||
description: "Start the browser (no-op if already running)",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "stop", description: "Stop the browser (best-effort)", hasSubcommands: false },
|
||||
{
|
||||
name: "reset-profile",
|
||||
description: "Reset browser profile (moves it to Trash)",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "tabs", description: "List open tabs", hasSubcommands: false },
|
||||
{ name: "tab", description: "Tab shortcuts (index-based)", hasSubcommands: true },
|
||||
{ name: "open", description: "Open a URL in a new tab", hasSubcommands: false },
|
||||
{
|
||||
name: "focus",
|
||||
description: "Focus a tab by target id (or unique prefix)",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "close", description: "Close a tab (target id optional)", hasSubcommands: false },
|
||||
{ name: "profiles", description: "List all browser profiles", hasSubcommands: false },
|
||||
{ name: "create-profile", description: "Create a new browser profile", hasSubcommands: false },
|
||||
{ name: "delete-profile", description: "Delete a browser profile", hasSubcommands: false },
|
||||
{ name: "screenshot", description: "Capture a screenshot (MEDIA:<path>)", hasSubcommands: false },
|
||||
{
|
||||
name: "snapshot",
|
||||
description: "Capture a snapshot (default: ai; aria is the accessibility tree)",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "navigate", description: "Navigate the current tab to a URL", hasSubcommands: false },
|
||||
{ name: "resize", description: "Resize the viewport", hasSubcommands: false },
|
||||
{ name: "click", description: "Click an element by ref from snapshot", hasSubcommands: false },
|
||||
{ name: "click-coords", description: "Click viewport coordinates", hasSubcommands: false },
|
||||
{ name: "type", description: "Type into an element by ref from snapshot", hasSubcommands: false },
|
||||
{ name: "press", description: "Press a key", hasSubcommands: false },
|
||||
{ name: "hover", description: "Hover an element by ai ref", hasSubcommands: false },
|
||||
{
|
||||
name: "scrollintoview",
|
||||
description: "Scroll an element into view by ref from snapshot",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "drag", description: "Drag from one ref to another", hasSubcommands: false },
|
||||
{ name: "select", description: "Select option(s) in a select element", hasSubcommands: false },
|
||||
{
|
||||
name: "upload",
|
||||
description: "Arm file upload for the next file chooser",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{
|
||||
name: "waitfordownload",
|
||||
description: "Wait for the next download (and save it)",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{
|
||||
name: "download",
|
||||
description: "Click a ref and save the resulting download",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{
|
||||
name: "dialog",
|
||||
description: "Arm the next modal dialog (alert/confirm/prompt)",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "fill", description: "Fill a form with JSON field descriptors", hasSubcommands: false },
|
||||
{
|
||||
name: "wait",
|
||||
description: "Wait for time, selector, URL, load state, or JS conditions",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{
|
||||
name: "evaluate",
|
||||
description: "Evaluate a function against the page or a ref",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "console", description: "Get recent console messages", hasSubcommands: false },
|
||||
{ name: "pdf", description: "Save page as PDF", hasSubcommands: false },
|
||||
{
|
||||
name: "responsebody",
|
||||
description: "Wait for a network response and return its body",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "highlight", description: "Highlight an element by ref", hasSubcommands: false },
|
||||
{ name: "errors", description: "Get recent page errors", hasSubcommands: false },
|
||||
{
|
||||
name: "requests",
|
||||
description: "Get recent network requests (best-effort)",
|
||||
hasSubcommands: false,
|
||||
},
|
||||
{ name: "doctor", description: "Diagnose browser readiness", hasSubcommands: false },
|
||||
{ name: "trace", description: "Record a Playwright trace", hasSubcommands: true },
|
||||
{ name: "cookies", description: "Read/write cookies", hasSubcommands: true },
|
||||
{ name: "storage", description: "Read/write localStorage/sessionStorage", hasSubcommands: true },
|
||||
{ name: "set", description: "Browser environment settings", hasSubcommands: true },
|
||||
];
|
||||
|
||||
const browserCommandGroupSpecs: readonly CommandGroupDescriptorSpec<BrowserCommandRegistrar>[] = [
|
||||
{
|
||||
commandNames: [
|
||||
"status",
|
||||
"start",
|
||||
"stop",
|
||||
"reset-profile",
|
||||
"tabs",
|
||||
"tab",
|
||||
"open",
|
||||
"focus",
|
||||
"close",
|
||||
"profiles",
|
||||
"create-profile",
|
||||
"delete-profile",
|
||||
],
|
||||
register: async (args) => {
|
||||
const module = await import("./browser-cli-manage.js");
|
||||
module.registerBrowserManageCommands(args.browser, args.parentOpts);
|
||||
},
|
||||
},
|
||||
{
|
||||
commandNames: ["screenshot", "snapshot"],
|
||||
register: async (args) => {
|
||||
const module = await import("./browser-cli-inspect.js");
|
||||
module.registerBrowserInspectCommands(args.browser, args.parentOpts);
|
||||
},
|
||||
},
|
||||
{
|
||||
commandNames: [
|
||||
"navigate",
|
||||
"resize",
|
||||
"click",
|
||||
"click-coords",
|
||||
"type",
|
||||
"press",
|
||||
"hover",
|
||||
"scrollintoview",
|
||||
"drag",
|
||||
"select",
|
||||
"upload",
|
||||
"waitfordownload",
|
||||
"download",
|
||||
"dialog",
|
||||
"fill",
|
||||
"wait",
|
||||
"evaluate",
|
||||
],
|
||||
register: async (args) => {
|
||||
const module = await import("./browser-cli-actions-input.js");
|
||||
module.registerBrowserActionInputCommands(args.browser, args.parentOpts);
|
||||
},
|
||||
},
|
||||
{
|
||||
commandNames: ["console", "pdf", "responsebody"],
|
||||
register: async (args) => {
|
||||
const module = await import("./browser-cli-actions-observe.js");
|
||||
module.registerBrowserActionObserveCommands(args.browser, args.parentOpts);
|
||||
},
|
||||
},
|
||||
{
|
||||
commandNames: ["highlight", "errors", "requests", "doctor", "trace"],
|
||||
register: async (args) => {
|
||||
const module = await import("./browser-cli-debug.js");
|
||||
module.registerBrowserDebugCommands(args.browser, args.parentOpts);
|
||||
},
|
||||
},
|
||||
{
|
||||
commandNames: ["cookies", "storage", "set"],
|
||||
register: async (args) => {
|
||||
const module = await import("./browser-cli-state.js");
|
||||
module.registerBrowserStateCommands(args.browser, args.parentOpts);
|
||||
},
|
||||
},
|
||||
];
|
||||
|
||||
function buildBrowserCommandGroups(params: {
|
||||
browser: Command;
|
||||
parentOpts: (cmd: Command) => BrowserParentOpts;
|
||||
}): CommandGroupEntry[] {
|
||||
return buildCommandGroupEntries(
|
||||
browserCommandDescriptors,
|
||||
browserCommandGroupSpecs,
|
||||
(register) => async () => await register(params),
|
||||
);
|
||||
}
|
||||
|
||||
function registerLazyBrowserCommands(
|
||||
browser: Command,
|
||||
parentOpts: (cmd: Command) => BrowserParentOpts,
|
||||
argv: string[],
|
||||
) {
|
||||
const { primary, commandPath } = resolveCliArgvInvocation(argv);
|
||||
const subcommand = primary === "browser" ? (commandPath[1] ?? null) : null;
|
||||
registerCommandGroups(browser, buildBrowserCommandGroups({ browser, parentOpts }), {
|
||||
eager: shouldEagerRegisterSubcommands(),
|
||||
primary: subcommand,
|
||||
registerPrimaryOnly: subcommand !== null,
|
||||
});
|
||||
}
|
||||
|
||||
export function registerBrowserCli(program: Command, argv: string[] = process.argv) {
|
||||
const browser = program
|
||||
.command("browser")
|
||||
.description("Manage OpenClaw's dedicated browser (Chrome/Chromium)")
|
||||
@@ -46,10 +253,5 @@ export function registerBrowserCli(program: Command) {
|
||||
|
||||
const parentOpts = (cmd: Command) => cmd.parent?.opts?.() as BrowserParentOpts;
|
||||
|
||||
registerBrowserManageCommands(browser, parentOpts);
|
||||
registerBrowserInspectCommands(browser, parentOpts);
|
||||
registerBrowserActionInputCommands(browser, parentOpts);
|
||||
registerBrowserActionObserveCommands(browser, parentOpts);
|
||||
registerBrowserDebugCommands(browser, parentOpts);
|
||||
registerBrowserStateCommands(browser, parentOpts);
|
||||
registerLazyBrowserCommands(browser, parentOpts, argv);
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user