What keeper is#

keeper.mjs owns the browser context, profile, account-bound proxy and persona, evidence capture, and action-log bookkeeping. action.mjs is a sidecar: it writes one structured command to ~/.weles/keeper/<session>/socket, and the keeper executes it in-process without exposing a CDP debug port.

Keeper is not a second production scheduler and not blanket permission to improvise against a website. It is a controlled discovery mode; production still resolves an approved trajectory and verified browser release.

Read and navigation commands#

Command	Arguments	Effect
`screenshot`	—	Capture the current page into the keeper work/evidence directory.
`dump`	—	Save the current document HTML for diagnosis.
`url`	—	Return the active page URL.
`cookies`	—	Read cookies from the current context.
`nav`	<url>	Navigate the active page.
`ctx_pages / all_pages`	—	List pages in the active context or all tracked contexts.
`switch_page`	<index>	Select a page by index.
`switch_to_url`	<pattern>	Select a page whose URL matches the supplied pattern.
`iframes`	—	List frames available to frame-scoped actions.

Interaction commands#

Command	Arguments	Effect
`humanclick`	<x> <y>	Click through the humanized pointer atom.
`humanmove`	<x> <y>	Move the pointer through the humanized motion atom.
`humanscroll`	[delta] [bursts]	Scroll in timed bursts.
`humanidle`	[kind]	Apply an intentional human idle profile.
`type`	<text>	Type through the active element.
`press`	<key>	Send one keyboard key.
`click / click_any`	<selector>	Click the first matching visible element, or permit a non-visible match for click_any.
`click_fast / dispatch_click`	<selector>	Fast keeper-only click paths; use only where the reviewed trajectory explicitly allows them.
`fill / fill_any`	<selector> <text>	Fill a matching control.
`fill_fast / set_value`	<selector> <text>	Direct keeper-only value paths for controlled fields.
`iframe_click`	<frame> <selector>	Click inside a selected frame.
`iframe_fill / iframe_fill_any`	<frame> <selector> <text>	Fill inside a selected frame.
`set_input_files`	<selector> <path> [force] [timeout]	Attach a local file to an input.
`humanfill_email_password`	<email> <password>	Fill the standard email/password pair through keeper atoms.
`click_signin_submit`	—	Submit the recognized sign-in form.
`fill_stripe`	—	Fill the reviewed Stripe form path.

Challenge, diagnostics, and terminal commands#

Command	Arguments	Effect
`solvecaptcha`	—	Detect the supported page challenge and run the unified solver path.
`solverecaptcha`	—	Run the dedicated reCAPTCHA path.
`eval`	<JavaScript>	Diagnostics only. The guard rejects raw DOM interaction that would create untrusted events.
`api_post`	<url> <body>	Issue the reviewed keeper-side API POST.
`save_account`	<platform> <username> <email> <password> <name> <status>	Persist the resulting account through the product account boundary and close successful bookkeeping.
`mark_failed`	[signal] [reason]	Close the action-log row as failed with an exact reason and last URL.