@alfe.ai/browser 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -0
- package/dist/index.cjs +729 -153
- package/dist/index.d.cts +58 -14
- package/dist/index.d.ts +58 -14
- package/dist/index.js +730 -154
- package/package.json +3 -2
package/README.md
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# @alfe.ai/browser
|
|
2
|
+
|
|
3
|
+
CDP-driven shared browser surface for Alfe agent automation and human
|
|
4
|
+
co-browse takeover. One persistent Chrome profile is streamed to authorized
|
|
5
|
+
viewers while an explicit controller session owns all human input.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @alfe.ai/browser
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Callers provide the Chrome executable/profile paths and should provide
|
|
14
|
+
`isNavigationAllowed` for their network policy. The predicate is applied both
|
|
15
|
+
to agent navigation and every intercepted page request, including redirects
|
|
16
|
+
and human-clicked navigation. The package bounds viewports, screencast frames,
|
|
17
|
+
automation input/results, and keeps replacement Chrome/CDP generations from
|
|
18
|
+
mutating current state.
|
|
19
|
+
|
|
20
|
+
## Browser integration verification
|
|
21
|
+
|
|
22
|
+
Run `BROWSER_TEST_EXECUTABLE_PATH=/path/to/chrome pnpm test:integration` from
|
|
23
|
+
this package. This dedicated suite launches a real headless Chrome with a fresh
|
|
24
|
+
temporary profile and local HTTP/WebSocket fixtures. It exercises streamed
|
|
25
|
+
JPEGs, human keyboard/mouse input, login popups, hand-back, and cookie persistence
|
|
26
|
+
after browser restart; it never attaches to an existing browser profile.
|
|
27
|
+
|
|
28
|
+
Part of [Alfe](https://alfe.ai). See the
|
|
29
|
+
[documentation](https://docs.alfe.ai) for platform setup.
|