Composite Actions

Execute multiple browser steps in a single command with bap act. Fewer commands, fewer tokens, fewer roundtrips.

Composite Actions

bap act is the killer feature of BAP CLI. It batches multiple browser steps into a single command and a single server call.

Syntax

bap act <step1> <step2> <step3> ...

Each step follows the format:

action:selector=value    (for actions that need a value)
action:selector          (for actions without a value)

Examples

Login flow

bap act fill:label:"Email"="[e-mail]" \
        fill:label:"Password"="secret" \
        click:role:button:"Sign in"

Supported Actions

The following actions can be used in composite steps:

Action	Syntax	Description
click	click:selector	Click an element
fill	fill:selector=value	Fill an input field
type	type:text	Type text into focused element
press	press:key	Press a keyboard key
select	select:selector=value	Select a dropdown option
check	check:selector	Check a checkbox
uncheck	uncheck:selector	Uncheck a checkbox
hover	hover:selector	Hover over an element
goto	goto:url	Navigate to a URL

Fused Observation

Combine act with --observe to get the resulting page state in the same server call:

bap act click:role:button:"Submit" --observe
bap act click:e3 --observe --tier=interactive

This turns 3 roundtrips (act + observe + process) into 1.

--observe · flag

Perform a post-observation after all steps complete. Returns updated page elements.

--tier · string · default: "full"

Response tier for the fused observation: full, interactive, or minimal.

Selector Syntax in Steps

Within composite steps, the parser splits on the first : for the action name, then scans right-to-left for an unquoted = to separate the selector from the value.

fill:role:textbox:"Email"="[e-mail]"
|    |                    |
|    selector             value
action

If your value contains =, wrap it in quotes: fill:e5="a=b". The parser finds the rightmost unquoted = to split.

Comparison

Approach	Commands	Server calls	LLM reasoning cycles
Individual commands	3	3	3
bap act	1	1	1
bap act --observe	1	1	1 (with page state)