Metadata-Version: 2.5
Name: claros-browser
Version: 0.1.4
Summary: Claros guard for browser-use agents: consequential clicks and submits are checked against your experts' rules before they reach the app
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: browser-use<0.14,>=0.9.2
Description-Content-Type: text/markdown

# claros-browser

Claros guard for [browser-use](https://github.com/browser-use/browser-use) agents. Consequential clicks, submits and
Enter presses are held in the page and checked against your team's rules before they reach the app: **stop**, **ask**
a person, or **nudge** with a fix.

```python
from browser_use import Agent, Tools
from claros_browser import guard_tools

tools = Tools()
guard_tools(tools)          # CLAROS_KEY from the env; the server is found via the Claros web app
Agent(task=..., llm=..., tools=tools)
```

Claros unreachable means stopped (fail closed) unless `fail_open=True`. An ask (a rule that says ask first) goes to the
person the agent works for (Let it / Stop it / Ask <owner> in their notch): the action waits up to `ask_wait` seconds
(default 25; 0 = don't) and runs only if they let this exact action through. No answer by then, or an ask that is with
the rule's owner: the action is dropped and the agent is told who was asked and to carry on; once they let it, the same
action goes through when it's tried again. Docs: https://claros.sh/docs

MIT licence.
