mirror of
https://github.com/stablyai/orca.git
synced 2026-10-13 08:02:52 +00:00
e623372cdb
* feat(cli): add browser tab profile controls * feat(cli): add tab profile automation primitives * refactor(cli): narrow tab profile automation scope * chore: retrigger PR checks * review: harden tab profile automation CLI - Wait for tab re-registration after browser.tabSetProfile so a follow-up tab list --show-profile reads the new sessionProfileId from BrowserManager instead of the stale one from the previous webview - Wait for tab registration after browser.tabProfileClone, matching browser.tabCreate, so the cloned browserPageId is operable when the CLI returns - Short-circuit browser.tabSetProfile when the tab is already on the requested profile so we do not tear down and remount the webview for a no-op switch - Switch TabShow.worktree from OptionalPlainString to OptionalString to match every other tab schema; empty --worktree should fall back to the active worktree, not pass through as the empty string - Add max-lines disable to browser.test.ts (file grew past 300 lines after adding the new tab-profile and tab-show tests) * review: fix useIpcEvents test setup for tab profile API CI failure: useIpcEvents.test.ts threw at module load with TypeError: window.addEventListener is not a function. The chain: the rebased useIpcEvents.ts imports destroyPersistentWebview from webview-registry, which calls window.addEventListener at module load. The test stubs window via vi.stubGlobal as a plain object without addEventListener, so the typeof window check passes but the call throws. - webview-registry.ts: tighten the module-load guard to also check that window.addEventListener is callable, so importing this module from a non-DOM-ish test env (vitest node env with stubbed window) does not throw at module load - useIpcEvents.test.ts: add the new onRequestTabSetProfile and replyTabSetProfile stubs to all 8 window.api.ui mocks so the new IPC subscription registered by useIpcEvents resolves * review: restore profile CRUD lost during rebase onto 1397-merged main The rebase brought commit 3242aa27 (refactor: narrow tab profile automation scope) onto a main that already had the lifecycle CRUD from 1397. The refactor commit removes BrowserProfileList/Create/Delete types, runtime methods, RPC registrations and schemas, plus the help/specs entries, because those were the precursor versions in commit 1 of this branch. Post-rebase those removals land on the hardened versions inherited from main, breaking 1397. Restore: - runtime-types.ts: BrowserSessionProfile import; ProfileList/Create/Delete result types - orca-runtime.ts: ProfileList/Create/Delete result type imports; browserProfileList/Create/Delete methods - browser-core.ts: ProfileCreate, ProfileDelete schema imports; browser.profileList/profileCreate/profileDelete RPC registrations - browser-schemas.ts: ProfileCreate, ProfileDelete zod schemas - help.ts: list/create/delete subcommand lines under Browser Automation - specs/browser-basic.ts: list/create/delete spec entries --------- Co-authored-by: Nikolatesla-lj <Nikolatesla-lj@users.noreply.github.com> Co-authored-by: Jinwoo-H <jinwoo0825@gmail.com>
239 lines
8.6 KiB
TypeScript
239 lines
8.6 KiB
TypeScript
import type { CommandSpec } from '../args'
|
|
import { GLOBAL_FLAGS } from '../args'
|
|
|
|
export const BROWSER_BASIC_COMMAND_SPECS: CommandSpec[] = [
|
|
{
|
|
path: ['snapshot'],
|
|
summary: 'Capture an accessibility snapshot of the active browser tab',
|
|
usage: 'orca snapshot [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['screenshot'],
|
|
summary: 'Capture a viewport screenshot of the active browser tab',
|
|
usage: 'orca screenshot [--format <png|jpeg>] [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'format', 'worktree']
|
|
},
|
|
{
|
|
path: ['click'],
|
|
summary: 'Click a browser element by ref',
|
|
usage: 'orca click --element <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'worktree']
|
|
},
|
|
{
|
|
path: ['fill'],
|
|
summary: 'Clear and fill a browser input by ref',
|
|
usage: 'orca fill --element <ref> --value <text> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'value', 'worktree']
|
|
},
|
|
{
|
|
path: ['type'],
|
|
summary: 'Type text at the current browser focus',
|
|
usage: 'orca type --input <text> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'input', 'worktree']
|
|
},
|
|
{
|
|
path: ['select'],
|
|
summary: 'Select a dropdown option by ref',
|
|
usage: 'orca select --element <ref> --value <value> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'value', 'worktree']
|
|
},
|
|
{
|
|
path: ['scroll'],
|
|
summary: 'Scroll the browser viewport',
|
|
usage: 'orca scroll --direction <up|down> [--amount <pixels>] [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'direction', 'amount', 'worktree']
|
|
},
|
|
{
|
|
path: ['goto'],
|
|
summary: 'Navigate the active browser tab to a URL',
|
|
usage: 'orca goto --url <url> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'url', 'worktree']
|
|
},
|
|
{
|
|
path: ['back'],
|
|
summary: 'Navigate back in browser history',
|
|
usage: 'orca back [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['reload'],
|
|
summary: 'Reload the active browser tab',
|
|
usage: 'orca reload [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['eval'],
|
|
summary: 'Evaluate JavaScript in the browser page context',
|
|
usage: 'orca eval --expression <js> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'expression', 'worktree']
|
|
},
|
|
{
|
|
path: ['wait'],
|
|
summary: 'Wait for element, text, URL, load state, JS condition, or timeout',
|
|
usage:
|
|
'orca wait [--selector <sel>] [--timeout <ms>] [--text <text>] [--url <pattern>] [--load <state>] [--fn <js>] [--state <hidden|visible>] [--worktree <selector>] [--json]',
|
|
allowedFlags: [
|
|
...GLOBAL_FLAGS,
|
|
'selector',
|
|
'timeout',
|
|
'text',
|
|
'url',
|
|
'load',
|
|
'fn',
|
|
'state',
|
|
'worktree'
|
|
]
|
|
},
|
|
{
|
|
path: ['check'],
|
|
summary: 'Check a checkbox/radio by ref',
|
|
usage: 'orca check --element <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'worktree']
|
|
},
|
|
{
|
|
path: ['uncheck'],
|
|
summary: 'Uncheck a checkbox/radio by ref',
|
|
usage: 'orca uncheck --element <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'worktree']
|
|
},
|
|
{
|
|
path: ['focus'],
|
|
summary: 'Focus a browser element by ref',
|
|
usage: 'orca focus --element <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'worktree']
|
|
},
|
|
{
|
|
path: ['clear'],
|
|
summary: 'Clear an input element by ref',
|
|
usage: 'orca clear --element <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'worktree']
|
|
},
|
|
{
|
|
path: ['select-all'],
|
|
summary: 'Select all text in an input by ref',
|
|
usage: 'orca select-all --element <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'worktree']
|
|
},
|
|
{
|
|
path: ['keypress'],
|
|
summary: 'Press a key (Enter, Tab, Escape, ArrowDown, etc.)',
|
|
usage: 'orca keypress --key <name> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'key', 'worktree']
|
|
},
|
|
{
|
|
path: ['pdf'],
|
|
summary: 'Export the active browser tab as PDF',
|
|
usage: 'orca pdf [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['full-screenshot'],
|
|
summary: 'Capture a full-page screenshot (beyond viewport)',
|
|
usage: 'orca full-screenshot [--format <png|jpeg>] [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'format', 'worktree']
|
|
},
|
|
{
|
|
path: ['hover'],
|
|
summary: 'Hover over a browser element by ref',
|
|
usage: 'orca hover --element <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'worktree']
|
|
},
|
|
{
|
|
path: ['drag'],
|
|
summary: 'Drag from one element to another',
|
|
usage: 'orca drag --from <ref> --to <ref> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'from', 'to', 'worktree']
|
|
},
|
|
{
|
|
path: ['upload'],
|
|
summary: 'Upload files to a file input element',
|
|
usage: 'orca upload --element <ref> --files <path,...> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'element', 'files', 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'list'],
|
|
summary: 'List open browser tabs',
|
|
usage: 'orca tab list [--worktree <selector|all>] [--show-profile] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree', 'show-profile']
|
|
},
|
|
{
|
|
path: ['tab', 'show'],
|
|
summary: 'Show one browser tab by page id',
|
|
usage: 'orca tab show --page <id> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'current'],
|
|
summary: 'Show the current browser tab',
|
|
usage: 'orca tab current [--worktree <selector|all>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'switch'],
|
|
summary: 'Switch the active browser tab',
|
|
usage: 'orca tab switch (--index <n> | --page <id>) [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'index', 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'create'],
|
|
summary: 'Create a new browser tab in the current worktree',
|
|
usage: 'orca tab create [--url <url>] [--worktree <selector>] [--profile <id>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'url', 'worktree', 'profile']
|
|
},
|
|
{
|
|
path: ['tab', 'profile', 'list'],
|
|
summary: 'List browser session profiles available to browser tabs',
|
|
usage: 'orca tab profile list [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS]
|
|
},
|
|
{
|
|
path: ['tab', 'profile', 'create'],
|
|
summary: 'Create a browser session profile for browser tabs',
|
|
usage: 'orca tab profile create --label <name> [--scope <isolated|imported>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'label', 'scope']
|
|
},
|
|
{
|
|
path: ['tab', 'profile', 'delete'],
|
|
summary: 'Delete a browser session profile used by browser tabs',
|
|
usage: 'orca tab profile delete --profile <id> [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'profile']
|
|
},
|
|
{
|
|
path: ['tab', 'profile', 'set'],
|
|
summary: 'Switch a browser tab to a different browser profile',
|
|
usage: 'orca tab profile set (--page <id> | --worktree <selector>) --profile <id> [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'profile', 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'profile', 'show'],
|
|
summary: 'Show the browser profile bound to a tab',
|
|
usage: 'orca tab profile show --page <id> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'profile', 'use-default'],
|
|
summary: 'Switch a browser tab back to the default browser profile',
|
|
usage: 'orca tab profile use-default --page <id> [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'profile', 'clone'],
|
|
summary: 'Clone a browser tab into a different browser profile',
|
|
usage: 'orca tab profile clone --profile <id> [--page <id>] [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'profile', 'worktree']
|
|
},
|
|
{
|
|
path: ['tab', 'close'],
|
|
summary: 'Close a browser tab',
|
|
usage: 'orca tab close [--index <n>] [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'index', 'worktree']
|
|
},
|
|
{
|
|
path: ['exec'],
|
|
summary: 'Run any agent-browser command against the active browser tab',
|
|
usage: 'orca exec --command "<agent-browser command>" [--worktree <selector>] [--json]',
|
|
allowedFlags: [...GLOBAL_FLAGS, 'command', 'worktree']
|
|
}
|
|
]
|