@generativereality/browser-automation 0.3.1 → 0.4.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/.claude-plugin/plugin.json +1 -1
- package/README.md +1 -0
- package/dist/index.js +52 -5
- package/package.json +1 -1
- package/skills/browser/SKILL.md +1 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "browser-automation",
|
|
3
3
|
"description": "Daemonless, per-tab-isolated browser automation for Claude Code via the `browser-automation` CLI. Drives one shared headed Chrome (persistent profile + extensions) over per-target CDP — many parallel sessions, no focus stealing, nothing long-lived to crash.",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.4.0",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "generativereality"
|
|
7
7
|
},
|
package/README.md
CHANGED
|
@@ -96,6 +96,7 @@ browser-automation bind -s bank -m nordnet # …or adopt it into a session
|
|
|
96
96
|
| `eval (-s\|-m\|-t) <js>` | Evaluate a JS expression in the tab (escape hatch) |
|
|
97
97
|
| `download (-s\|-m\|-t) (--click <ref>\|--url <href>)` | Capture a file/CSV download, wait for completion, print the path |
|
|
98
98
|
| `network (-s\|-m\|-t) [--reload\|--click\|--nav] [--filter --headers --body]` | Capture network requests (find the API, headers, response bodies) |
|
|
99
|
+
| `screenshot (-s\|-m\|-t) [--full] [-o path]` | Save a PNG screenshot (viewport or full page) |
|
|
99
100
|
| `close (-s\|-m\|-t) [--tab]` | Forget the session (tab stays open); `--tab` also closes the browser tab |
|
|
100
101
|
|
|
101
102
|
## How refs work
|
package/dist/index.js
CHANGED
|
@@ -7,7 +7,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, s
|
|
|
7
7
|
import { spawnSync } from "node:child_process";
|
|
8
8
|
import { fileURLToPath } from "node:url";
|
|
9
9
|
//#region package.json
|
|
10
|
-
var version = "0.
|
|
10
|
+
var version = "0.4.0";
|
|
11
11
|
var description = "Daemonless, per-tab-isolated browser automation CLI for Claude Code. Drives one shared headed Chrome (persistent profile + extensions) over per-target CDP — many parallel sessions, no focus stealing, nothing long-lived to crash.";
|
|
12
12
|
//#endregion
|
|
13
13
|
//#region src/core/session.ts
|
|
@@ -202,6 +202,16 @@ async function evaluateUntil(targetId, expression, ready, { timeout = 5e3, inter
|
|
|
202
202
|
}
|
|
203
203
|
return last;
|
|
204
204
|
}
|
|
205
|
+
/** Capture a PNG screenshot of a page target (optionally the full page). */
|
|
206
|
+
async function captureScreenshot(targetId, { fullPage = false } = {}) {
|
|
207
|
+
return withPage(targetId, async (s) => {
|
|
208
|
+
const r = await s.send("Page.captureScreenshot", {
|
|
209
|
+
format: "png",
|
|
210
|
+
captureBeyondViewport: fullPage
|
|
211
|
+
});
|
|
212
|
+
return Buffer.from(r.data, "base64");
|
|
213
|
+
});
|
|
214
|
+
}
|
|
205
215
|
/** Navigate a page target and wait for load (or timeout). */
|
|
206
216
|
async function navigate(targetId, url, { timeout = 3e4 } = {}) {
|
|
207
217
|
return withPage(targetId, async (s) => {
|
|
@@ -656,7 +666,7 @@ function urlTriggerExpr(url) {
|
|
|
656
666
|
}
|
|
657
667
|
//#endregion
|
|
658
668
|
//#region src/commands/download.ts
|
|
659
|
-
const DEFAULT_DIR = join(homedir(), ".browser-automation", "downloads");
|
|
669
|
+
const DEFAULT_DIR$1 = join(homedir(), ".browser-automation", "downloads");
|
|
660
670
|
const downloadCommand = define({
|
|
661
671
|
name: "download",
|
|
662
672
|
description: "Capture a file download (e.g. a CSV export): trigger it with --click <ref> or --url, wait for completion",
|
|
@@ -673,7 +683,7 @@ const downloadCommand = define({
|
|
|
673
683
|
dir: {
|
|
674
684
|
type: "string",
|
|
675
685
|
short: "d",
|
|
676
|
-
description: `Directory to save into (default: ${DEFAULT_DIR})`
|
|
686
|
+
description: `Directory to save into (default: ${DEFAULT_DIR$1})`
|
|
677
687
|
},
|
|
678
688
|
timeout: {
|
|
679
689
|
type: "number",
|
|
@@ -691,7 +701,7 @@ const downloadCommand = define({
|
|
|
691
701
|
consola.error(`--click expects a ref like e42 (run snapshot first)`);
|
|
692
702
|
process.exit(1);
|
|
693
703
|
}
|
|
694
|
-
const r = await captureDownload(await resolveExistingTargetId(targetOpts(ctx.values)), ctx.values.dir || DEFAULT_DIR, click ? clickTriggerExpr(click) : urlTriggerExpr(url), ctx.values.timeout ?? 3e4);
|
|
704
|
+
const r = await captureDownload(await resolveExistingTargetId(targetOpts(ctx.values)), ctx.values.dir || DEFAULT_DIR$1, click ? clickTriggerExpr(click) : urlTriggerExpr(url), ctx.values.timeout ?? 3e4);
|
|
695
705
|
consola.success(`Downloaded ${r.filename} (${r.bytes} bytes)`);
|
|
696
706
|
process.stdout.write(r.path + "\n");
|
|
697
707
|
}
|
|
@@ -711,7 +721,11 @@ async function captureNetwork(targetId, opts) {
|
|
|
711
721
|
if (!wsUrl) throw new TargetGoneError(targetId);
|
|
712
722
|
const s = await connect(wsUrl);
|
|
713
723
|
try {
|
|
714
|
-
|
|
724
|
+
try {
|
|
725
|
+
await s.send("Network.enable", {}, 8e3);
|
|
726
|
+
} catch {
|
|
727
|
+
throw new Error("Network.enable stalled — the page renderer is busy. Let the page finish loading and retry, and prefer --click over --reload on heavy SPAs.");
|
|
728
|
+
}
|
|
715
729
|
const byId = /* @__PURE__ */ new Map();
|
|
716
730
|
s.on("Network.requestWillBeSent", (p) => {
|
|
717
731
|
byId.set(p.requestId, {
|
|
@@ -830,6 +844,37 @@ const networkCommand = define({
|
|
|
830
844
|
}
|
|
831
845
|
});
|
|
832
846
|
//#endregion
|
|
847
|
+
//#region src/commands/screenshot.ts
|
|
848
|
+
const DEFAULT_DIR = join(homedir(), ".browser-automation", "screenshots");
|
|
849
|
+
const screenshotCommand = define({
|
|
850
|
+
name: "screenshot",
|
|
851
|
+
description: "Save a PNG screenshot of a tab (--full for the whole page)",
|
|
852
|
+
args: {
|
|
853
|
+
...targetArgs,
|
|
854
|
+
out: {
|
|
855
|
+
type: "string",
|
|
856
|
+
short: "o",
|
|
857
|
+
description: "Output file path (default: ~/.browser-automation/screenshots/<ts>.png)"
|
|
858
|
+
},
|
|
859
|
+
full: {
|
|
860
|
+
type: "boolean",
|
|
861
|
+
description: "Capture the full scrollable page, not just the viewport"
|
|
862
|
+
}
|
|
863
|
+
},
|
|
864
|
+
async run(ctx) {
|
|
865
|
+
const targetId = await resolveExistingTargetId(targetOpts(ctx.values));
|
|
866
|
+
const png = await captureScreenshot(targetId, { fullPage: ctx.values.full });
|
|
867
|
+
let out = ctx.values.out;
|
|
868
|
+
if (!out) {
|
|
869
|
+
mkdirSync(DEFAULT_DIR, { recursive: true });
|
|
870
|
+
out = join(DEFAULT_DIR, `${((await listPageTargets()).find((p) => p.id === targetId)?.title || "page").replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "").slice(0, 40) || "page"}.png`);
|
|
871
|
+
}
|
|
872
|
+
writeFileSync(out, png);
|
|
873
|
+
consola.success(`Saved screenshot (${png.length} bytes)`);
|
|
874
|
+
process.stdout.write(out + "\n");
|
|
875
|
+
}
|
|
876
|
+
});
|
|
877
|
+
//#endregion
|
|
833
878
|
//#region src/commands/list.ts
|
|
834
879
|
const listCommand = define({
|
|
835
880
|
name: "list",
|
|
@@ -1020,6 +1065,8 @@ const subCommands = new Map([
|
|
|
1020
1065
|
["eval", evalCommand],
|
|
1021
1066
|
["download", downloadCommand],
|
|
1022
1067
|
["network", networkCommand],
|
|
1068
|
+
["screenshot", screenshotCommand],
|
|
1069
|
+
["shot", screenshotCommand],
|
|
1023
1070
|
["list", listCommand],
|
|
1024
1071
|
["ls", listCommand],
|
|
1025
1072
|
["close", closeCommand],
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@generativereality/browser-automation",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Daemonless, per-tab-isolated browser automation CLI for Claude Code. Drives one shared headed Chrome (persistent profile + extensions) over per-target CDP — many parallel sessions, no focus stealing, nothing long-lived to crash.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/skills/browser/SKILL.md
CHANGED
|
@@ -84,6 +84,7 @@ Page commands take a tab selector — `-s <session>` (default `$BAC_SESSION`, el
|
|
|
84
84
|
| Evaluate JS in the tab (escape hatch) | `browser-automation eval -m op.fi 'document.title'` |
|
|
85
85
|
| Download a file / CSV export | `browser-automation download -m bank --click e42` (or `--url <href>`) |
|
|
86
86
|
| Inspect network (find the API, headers, bodies) | `browser-automation network -m bank --reload --filter api --headers --body` |
|
|
87
|
+
| Screenshot a tab | `browser-automation screenshot -m op.fi --full -o shot.png` |
|
|
87
88
|
| Forget a session (tab stays open) | `browser-automation close -s work` |
|
|
88
89
|
| Forget **and** close the browser tab | `browser-automation close -s work --tab` |
|
|
89
90
|
|