@bastani/atomic 0.8.26-alpha.5 → 0.8.26-alpha.7

package/dist/builtin/subagents/skills/browser-use/references/cdp-python.md

@@ -1,76 +0,0 @@
-# Raw CDP & Python Session Reference
-
-The CLI commands handle most browser interactions. Use `browser-use python` with raw CDP when you need browser-level control the CLI doesn't expose — activating a tab so the user sees it, intercepting network requests, emulating devices, or working with Chrome target IDs directly.
-
-## How the Python session works
-
-`browser-use python "statement"` executes one Python statement per call. Variables persist across calls — set a value in one call, use it in the next.
-
-A `browser` object is pre-injected with sync wrappers for common operations (`browser.goto()`, `browser.click()`, etc.). For anything beyond those, two internals give you full access:
-
-- `browser._run(coroutine)` — run any async coroutine synchronously (60s timeout)
-- `browser._session` — the raw `BrowserSession` with full CDP client access
-
-## Getting a CDP client
-
-```bash
-browser-use python "cdp = browser._run(browser._session.get_or_create_cdp_session())"
-```
-
-After this, `cdp` persists across calls. Use `cdp.cdp_client.send.<Domain>.<method>()` for any CDP command and `cdp.session_id` for the session parameter.
-
-## Recipes
-
-### Activate a tab (make it visible to the user)
-
-The CLI's `tab switch` only changes the agent's internal focus — Chrome's visible tab doesn't change. To actually show the user a specific tab:
-
-```bash
-# Get all targets to find the target ID
-browser-use python "targets = browser._session.session_manager.get_all_page_targets()"
-browser-use python "print([(i, t.url) for i, t in enumerate(targets)])"
-
-# Activate target at index 1 so the user sees it
-browser-use python "cdp = browser._run(browser._session.get_or_create_cdp_session(target_id=None, focus=False))"
-browser-use python "browser._run(cdp.cdp_client.send.Target.activateTarget(params={'targetId': targets[1].target_id}))"
-```
-
-### List all tabs with target IDs
-
-```bash
-browser-use python "targets = browser._session.session_manager.get_all_page_targets()"
-browser-use python "
-for i, t in enumerate(targets):
-    print(f'{i}: {t.target_id[:12]}... {t.url}')
-"
-```
-
-### Run JavaScript and get the result
-
-```bash
-browser-use python "cdp = browser._run(browser._session.get_or_create_cdp_session())"
-browser-use python "result = browser._run(cdp.cdp_client.send.Runtime.evaluate(params={'expression': 'document.title', 'returnByValue': True}, session_id=cdp.session_id))"
-browser-use python "print(result['result']['value'])"
-```
-
-### Emulate a mobile device
-
-```bash
-browser-use python "cdp = browser._run(browser._session.get_or_create_cdp_session())"
-browser-use python "browser._run(cdp.cdp_client.send.Emulation.setDeviceMetricsOverride(params={'width': 375, 'height': 812, 'deviceScaleFactor': 3, 'mobile': True}, session_id=cdp.session_id))"
-```
-
-### Get cookies via CDP
-
-```bash
-browser-use python "cdp = browser._run(browser._session.get_or_create_cdp_session())"
-browser-use python "cookies = browser._run(cdp.cdp_client.send.Network.getCookies(params={}, session_id=cdp.session_id))"
-browser-use python "print(cookies)"
-```
-
-## Tips
-
-- Each `browser-use python` call is one statement. Multi-line strings work for `for` loops and `if` blocks, but you can't mix statements and expressions. Use multiple calls.
-- Variables persist: set `cdp = ...` in one call, use `cdp` in the next.
-- The `browser._run()` bridge has a 60-second timeout. For long operations, increase it or use the async internals directly.
-- All CDP domains are available via `cdp.cdp_client.send.<Domain>.<method>()`. See the [Chrome DevTools Protocol docs](https://chromedevtools.github.io/devtools-protocol/) for the full API.

package/dist/builtin/subagents/skills/browser-use/references/multi-session.md

@@ -1,92 +0,0 @@
-# Multiple Browser Sessions
-
-## Why use multiple sessions
-
-When you need more than one browser at a time:
-- Cloud browser for scraping + local Chrome for authenticated tasks
-- Two different Chrome profiles simultaneously
-- Isolated browser for testing that won't affect the user's browsing
-- Running a headed browser for debugging while headless runs in background
-
-## How sessions are isolated
-
-Each `--session NAME` gets:
-- Its own daemon process
-- Its own Unix socket (`~/.browser-use/{name}.sock`)
-- Its own PID file and state file
-- Its own browser instance (completely independent)
-- Its own tab ownership state (multi-agent locks don't cross sessions)
-
-## The `--session` flag
-
-Must be passed on every command targeting that session:
-
-```bash
-browser-use --session work open <url>      # goes to 'work' daemon
-browser-use --session work state           # reads from 'work' daemon
-browser-use state                          # goes to 'default' daemon (different browser)
-```
-
-If you forget `--session`, the command goes to the `default` session. This is the most common mistake — you'll interact with the wrong browser.
-
-## Combining sessions with browser modes
-
-```bash
-# Session 1: cloud browser
-browser-use --session cloud cloud connect
-
-# Session 2: connect to user's Chrome
-browser-use --session chrome connect
-
-# Session 3: headed Chromium for debugging
-browser-use --session debug --headed open <url>
-```
-
-Each session is fully independent. The cloud session talks to a remote browser, the chrome session talks to the user's Chrome, and the debug session manages its own Chromium — all running simultaneously.
-
-## Listing and managing sessions
-
-```bash
-browser-use sessions
-```
-
-Output:
-```
-SESSION          PHASE          PID      CONFIG
-cloud            running        12345    cloud
-chrome           running        12346    cdp
-debug            ready          12347    headed
-```
-
-PHASE shows the daemon lifecycle state: `initializing`, `ready`, `starting`, `running`, `shutting_down`, `stopped`, `failed`.
-
-```bash
-browser-use --session cloud close           # close one session
-browser-use close --all                     # close every session
-```
-
-## Common patterns
-
-**Cloud + local authenticated:**
-```bash
-browser-use --session scraper cloud connect
-browser-use --session scraper open https://example.com
-# ... scrape data ...
-
-browser-use --session auth --profile "Default" open https://github.com
-browser-use --session auth state
-# ... interact with authenticated site ...
-```
-
-**Throwaway test browser:**
-```bash
-browser-use --session test --headed open https://localhost:3000
-# ... test, debug, inspect ...
-browser-use --session test close    # done, clean up
-```
-
-**Environment variable:**
-```bash
-export BROWSER_USE_SESSION=work
-browser-use open <url>              # uses 'work' session without --session flag
-```