Metadata-Version: 2.5
Name: claros-browser
Version: 0.1.3
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) doesn't wait
by default: the action is dropped and the agent is told who was asked and to carry on; once they approve, the same
action goes through when it's tried again. `ask_wait=<s>` waits instead and runs it only if they approved this exact
action. Docs: https://claros.sh/docs

MIT licence.
