browser4-cli 4.12.0-rc.3 → 4.12.1

package/README.md

@@ -88,7 +88,7 @@ browser4-cli agent run "Search amazon for mechanical keyboards, compare the top
 
 # Parallel scraping with swarm
 browser4-cli swarm create --max-open-tabs 12 --display-mode HEADLESS
-browser4-cli swarm submit --seed-file ./urls.txt --refresh --store-content
+browser4-cli swarm submit --seed-file ./urls.txt --refresh
 browser4-cli swarm result scrape-task-1
 
 # Batch multiple commands
@@ -247,16 +247,19 @@ browser4-cli pdf --filename page.pdf
 
 | Command | Description |
 |---|---|
-| `tab-list` | List all tabs with their zero-based index. |
+| `tab-list` | List all tabs with their zero-based index and stable GUID. Use `--json` for full GUIDs. |
 | `tab-new [url]` | Open a new tab. |
-| `tab-close [index]` | Close a tab (current tab if no index). |
-| `tab-select <index>` | Switch to a tab by index. |
+| `tab-close [index]` | Close a tab (current tab if no index). Use `--guid <guid>` for GUID-based close. |
+| `tab-select <index>` | Switch to a tab by index. Use `--guid <guid>` for GUID-based select. |
 
 ```bash
 browser4-cli tab-list
+browser4-cli tab-list --json            # JSON output with full GUIDs
 browser4-cli tab-select 1
+browser4-cli tab-select --guid 1B46D74FB  # select by stable GUID
 browser4-cli tab-new https://example.com
 browser4-cli tab-close 1
+browser4-cli tab-close --guid 1B46D74FB  # close by stable GUID
 ```
 
 ### Element inspection
@@ -382,17 +385,21 @@ instructions that always match the installed CLI version.
 | `skills list` | List available bundled skills with file counts. |
 | `skills get <name>` | Output a skill's SKILL.md content. `--full` includes references and templates. `--all` outputs every skill. |
 | `skills path [name]` | Print the skills directory path. With a name, prints the path to that skill's subdirectory. |
+| `skills unpack [dest]` | Unpack bundled skill files to a directory (defaults to the skills directory). |
 
 Skill files are unpacked to the versioned installation directory during `browser4-cli install`.
+Use `skills unpack` to refresh or relocate skill files without reinstalling.
 Set `BROWSER4_SKILLS_DIR` to override the skills directory path.
 
 ```bash
-browser4-cli skills                        # List bundled skills
-browser4-cli skills get browser4-cli       # Get the CLI skill's main content
+browser4-cli skills                         # List bundled skills
+browser4-cli skills get browser4-cli        # Get the CLI skill's main content
 browser4-cli skills get browser4-cli --full # Include references and templates
-browser4-cli skills get --all              # Output every skill
-browser4-cli skills path                   # Print skills root directory
-browser4-cli skills path browser4-cli      # Print path to a specific skill
+browser4-cli skills get --all               # Output every skill
+browser4-cli skills path                    # Print skills root directory
+browser4-cli skills path browser4-cli       # Print path to a specific skill
+browser4-cli skills unpack                  # Unpack to default skills directory
+browser4-cli skills unpack /custom/path     # Unpack to a custom directory
 ```
 
 ### Other
@@ -489,7 +496,7 @@ browser4-cli htmlsnapshot
 browser4-cli htmlsnapshot get <field> [selector] [name]
 browser4-cli htmlsnapshot get all <field> [selector] [name]
 browser4-cli htmlsnapshot query [url] --sql <query>
-browser4-cli htmlsnapshot export [--file <path>]
+browser4-cli htmlsnapshot export [--file <path>] [--clean]
 browser4-cli htmlsnapshot summary
 browser4-cli htmlsnapshot grep [OPTIONS] <pattern>
 browser4-cli htmlsnapshot inspect [selector] [--max N] [--depth D]
@@ -581,10 +588,11 @@ browser4-cli htmlsnapshot query --sql "
 
 #### htmlsnapshot export
 
-Save the full snapshot HTML to a local file.
+Save the full snapshot HTML to a local file. Use `--clean` to strip `<script>`, `<style>`, comments, and non-standard attributes — producing minimal HTML ideal for LLM consumption.
 
 ```bash
 browser4-cli htmlsnapshot export --file snapshot.html
+browser4-cli htmlsnapshot export --file page.html --clean
 ```
 
 #### htmlsnapshot summary
@@ -735,13 +743,12 @@ line; `#` comments and blank lines ignored), or both.
 | `--expires <duration>` | Cache expiration (e.g. `1d`, `1h`) |
 | `--refresh` | Force fresh fetch, ignore cache |
 | `--parse` | Parse page immediately after fetching |
-| `--store-content` | Persist page content to storage |
 
 ```bash
 # Submit URLs from a file
 browser4-cli swarm submit --seed-file ./urls.txt \
   --deadline 2026-03-30T00:00:00Z \
-  --expires 1d --refresh --store-content
+  --expires 1d --refresh
 
 # Submit with inline X-SQL
 browser4-cli swarm submit "https://www.amazon.com/dp/B08PP5MSVB" --sql "
@@ -800,7 +807,6 @@ browser4-cli crawl <url> [options]
 | `-a`, `--args` | — | Additional LoadOptions passthrough (e.g. `-a "-nMaxRetry 5"`) |
 | `--refresh` | — | Force fresh fetch |
 | `--parse` | — | Parse pages immediately after fetching |
-| `--store-content` | — | Persist page content |
 | `--expires` | — | Cache expiration (e.g. `1d`, `1h`, `30m`) |
 | `-p`, `--priority` | — | Queue priority (lower = higher) |
 | `--ignore-url-query` | — | Strip query params during URL normalization |
@@ -821,7 +827,7 @@ browser4-cli crawl "https://shop.example.com" \
   --top-links 10
 
 # Deep crawl with refresh and content storage
-browser4-cli crawl "https://example.com" --depth 3 --refresh --store-content
+browser4-cli crawl "https://example.com" --depth 3 --refresh
 
 # Background crawl — submit and return immediately
 browser4-cli crawl "https://example.com" -ol "a[href]" --background

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser4-cli",
-  "version": "4.12.0-rc.3",
+  "version": "4.12.1",
   "description": "Browser automation CLI for AI agents",
   "type": "module",
   "files": [

package/scripts/build-all-platforms.ps1

@@ -1,104 +1,104 @@
-[CmdletBinding()]
-param(
-    [string]$ProjectRoot = (Resolve-Path (Join-Path $PSScriptRoot "..")).Path,
-    [string]$ImageName = "browser4-builder",
-    [switch]$SkipDockerBuild,
-    [switch]$DryRun
-)
-
-Set-StrictMode -Version Latest
-$ErrorActionPreference = "Stop"
-
-$OutputDir = Join-Path $ProjectRoot "bin"
-$CliDir = Join-Path $ProjectRoot "browser4-cli"
-$DockerfilePath = Join-Path $ProjectRoot "docker/Dockerfile.build"
-
-$Targets = @(
-    @{ Target = "x86_64-unknown-linux-gnu"; Output = "browser4-cli-linux-x64" },
-    @{ Target = "aarch64-unknown-linux-gnu"; Output = "browser4-cli-linux-arm64" },
-    @{ Target = "x86_64-pc-windows-gnu"; Output = "browser4-cli-win32-x64.exe" },
-    @{ Target = "x86_64-apple-darwin"; Output = "browser4-cli-darwin-x64" },
-    @{ Target = "aarch64-apple-darwin"; Output = "browser4-cli-darwin-arm64" },
-    @{ Target = "x86_64-unknown-linux-musl"; Output = "browser4-cli-linux-musl-x64" },
-    @{ Target = "aarch64-unknown-linux-musl"; Output = "browser4-cli-linux-musl-arm64" }
-)
-
-function Invoke-DockerCommand {
-    param([string[]]$Args)
-
-    if ($DryRun) {
-        Write-Host ("[DRY-RUN] docker " + ($Args -join " ")) -ForegroundColor DarkYellow
-        return
-    }
-
-    & docker @Args
-    if ($LASTEXITCODE -ne 0) {
-        throw "Docker command failed with exit code $LASTEXITCODE"
-    }
-}
-
-function Build-Target {
-    param(
-        [string]$Target,
-        [string]$OutputName
-    )
-
-    Write-Host "Building for $Target..." -ForegroundColor Yellow
-
-    $containerCmd = "cargo zigbuild --release --target $Target && cp /build/target/$Target/release/browser4-cli* /output/$OutputName && chmod +x /output/$OutputName 2>/dev/null || true"
-
-    Invoke-DockerCommand -Args @(
-        "run", "--rm",
-        "-v", "${CliDir}:/build",
-        "-v", "${OutputDir}:/output",
-        $ImageName,
-        "-c", $containerCmd
-    )
-
-    $artifactPath = Join-Path $OutputDir $OutputName
-    if (-not (Test-Path -Path $artifactPath -PathType Leaf)) {
-        throw "Failed to build $OutputName"
-    }
-
-    $artifactSize = (Get-Item -Path $artifactPath).Length
-    if ($artifactSize -le 0) {
-        throw "Built artifact is empty: $OutputName"
-    }
-
-    Write-Host "Built $OutputName" -ForegroundColor Green
-}
-
-if (-not (Get-Command docker -ErrorAction SilentlyContinue)) {
-    throw "Docker CLI not found in PATH. Install Docker Desktop and retry."
-}
-
-Write-Host "Building browser4-cli for all platforms..." -ForegroundColor Yellow
-Write-Host ""
-
-New-Item -ItemType Directory -Force -Path $OutputDir | Out-Null
-
-if (-not $SkipDockerBuild) {
-    Write-Host "Building Docker cross-compilation image..." -ForegroundColor Yellow
-    Invoke-DockerCommand -Args @(
-        "build",
-        "-t", $ImageName,
-        "-f", $DockerfilePath,
-        $ProjectRoot
-    )
-    Write-Host ""
-}
-
-foreach ($entry in $Targets) {
-    Build-Target -Target $entry.Target -OutputName $entry.Output
-}
-
-Write-Host ""
-Write-Host "Build complete" -ForegroundColor Green
-Write-Host "Binaries are in: $OutputDir"
-
-if ($DryRun) {
-    Write-Host "[DRY-RUN] Skipping artifact listing." -ForegroundColor DarkYellow
-}
-else {
-    Get-ChildItem -Path $OutputDir -Filter "browser4-cli-*" | Select-Object Name, Length, LastWriteTime
-}
+[CmdletBinding()]
+param(
+    [string]$ProjectRoot = (Resolve-Path (Join-Path $PSScriptRoot "..")).Path,
+    [string]$ImageName = "browser4-builder",
+    [switch]$SkipDockerBuild,
+    [switch]$DryRun
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$OutputDir = Join-Path $ProjectRoot "bin"
+$CliDir = Join-Path $ProjectRoot "browser4-cli"
+$DockerfilePath = Join-Path $ProjectRoot "docker/Dockerfile.build"
+
+$Targets = @(
+    @{ Target = "x86_64-unknown-linux-gnu"; Output = "browser4-cli-linux-x64" },
+    @{ Target = "aarch64-unknown-linux-gnu"; Output = "browser4-cli-linux-arm64" },
+    @{ Target = "x86_64-pc-windows-gnu"; Output = "browser4-cli-win32-x64.exe" },
+    @{ Target = "x86_64-apple-darwin"; Output = "browser4-cli-darwin-x64" },
+    @{ Target = "aarch64-apple-darwin"; Output = "browser4-cli-darwin-arm64" },
+    @{ Target = "x86_64-unknown-linux-musl"; Output = "browser4-cli-linux-musl-x64" },
+    @{ Target = "aarch64-unknown-linux-musl"; Output = "browser4-cli-linux-musl-arm64" }
+)
+
+function Invoke-DockerCommand {
+    param([string[]]$Args)
+
+    if ($DryRun) {
+        Write-Host ("[DRY-RUN] docker " + ($Args -join " ")) -ForegroundColor DarkYellow
+        return
+    }
+
+    & docker @Args
+    if ($LASTEXITCODE -ne 0) {
+        throw "Docker command failed with exit code $LASTEXITCODE"
+    }
+}
+
+function Build-Target {
+    param(
+        [string]$Target,
+        [string]$OutputName
+    )
+
+    Write-Host "Building for $Target..." -ForegroundColor Yellow
+
+    $containerCmd = "cargo zigbuild --release --target $Target && cp /build/target/$Target/release/browser4-cli* /output/$OutputName && chmod +x /output/$OutputName 2>/dev/null || true"
+
+    Invoke-DockerCommand -Args @(
+        "run", "--rm",
+        "-v", "${CliDir}:/build",
+        "-v", "${OutputDir}:/output",
+        $ImageName,
+        "-c", $containerCmd
+    )
+
+    $artifactPath = Join-Path $OutputDir $OutputName
+    if (-not (Test-Path -Path $artifactPath -PathType Leaf)) {
+        throw "Failed to build $OutputName"
+    }
+
+    $artifactSize = (Get-Item -Path $artifactPath).Length
+    if ($artifactSize -le 0) {
+        throw "Built artifact is empty: $OutputName"
+    }
+
+    Write-Host "Built $OutputName" -ForegroundColor Green
+}
+
+if (-not (Get-Command docker -ErrorAction SilentlyContinue)) {
+    throw "Docker CLI not found in PATH. Install Docker Desktop and retry."
+}
+
+Write-Host "Building browser4-cli for all platforms..." -ForegroundColor Yellow
+Write-Host ""
+
+New-Item -ItemType Directory -Force -Path $OutputDir | Out-Null
+
+if (-not $SkipDockerBuild) {
+    Write-Host "Building Docker cross-compilation image..." -ForegroundColor Yellow
+    Invoke-DockerCommand -Args @(
+        "build",
+        "-t", $ImageName,
+        "-f", $DockerfilePath,
+        $ProjectRoot
+    )
+    Write-Host ""
+}
+
+foreach ($entry in $Targets) {
+    Build-Target -Target $entry.Target -OutputName $entry.Output
+}
+
+Write-Host ""
+Write-Host "Build complete" -ForegroundColor Green
+Write-Host "Binaries are in: $OutputDir"
+
+if ($DryRun) {
+    Write-Host "[DRY-RUN] Skipping artifact listing." -ForegroundColor DarkYellow
+}
+else {
+    Get-ChildItem -Path $OutputDir -Filter "browser4-cli-*" | Select-Object Name, Length, LastWriteTime
+}