@vforsh/argus 0.1.19 → 0.1.21

package/dist/skill/argus/SKILL.md

@@ -47,6 +47,8 @@ Read:
 
 Use this for any app that needs the user's normal browser profile, cookies, local storage, extensions, or saved login state. Do **not** use `argus start`, `argus chrome start --profile temp`, headless Chrome, or a fresh CDP profile for this flow; those lose the real login/session context.
 
+First-time setup is one command: `argus extension install` (installs native hosts, opens chrome://extensions, waits for connect). The extension ID is pinned and the build ships with the CLI — see [EXTENSION.md](./reference/EXTENSION.md).
+
 ```bash
 APP_URL="https://portal.example/app"
 WATCHER_ID="app"
@@ -134,10 +136,13 @@ argus click app --ref e5
 argus drag app --selector "canvas" --pos 320,240 --by 80,-30
 argus fill app --selector "#email" "user@example.com"
 argus keydown app --key Enter
+argus keydown app --key G
+argus keydown app --code KeyG --print-event
 argus scroll-to app --selector "#footer"
 ```
 
 For iframe-active extension watchers, commands run against the selected iframe target. Screenshots, recordings, selectors, and eval are resolved relative to that iframe.
+Network mocks default to the top-level page; pass `--scope selected` (or `--frame selected`) to intercept requests from the selected iframe.
 
 For deeper command lists, use [INSPECT.md](./reference/INSPECT.md). For screenshots/recording details, use [CAPTURE.md](./reference/CAPTURE.md). For eval flags, polling, file scripts, and args, use [EVAL.md](./reference/EVAL.md).
 
@@ -168,7 +173,7 @@ Keep these commands in the background in agent shells. See [START.md](./referenc
 
 ## Troubleshooting
 
-**No extension-control watcher** — Open/reload the browser extension, then run `argus ext doctor --json`.
+**No extension-control watcher** — First time? Run `argus extension install`. Otherwise open/reload the extension, then run `argus ext doctor --json`.
 
 **Multiple tabs matched** — Use `argus ext tabs --url <url> --json`, choose a `tabId`, then pass `--tab <tabId>`.
 

package/dist/skill/argus/reference/EXTENSION.md

@@ -5,18 +5,23 @@ Debug normal Chrome session without CDP flags.
 ### One-Time Setup
 
 ```bash
-# 1) Build extension
-cd packages/argus-extension && bun run build
+# Installs native hosts, opens chrome://extensions, waits for the extension to connect:
+argus extension install
+#   → click "Load unpacked" and select the printed folder (enable Developer mode if hidden)
+```
 
-# 2) Load in Chrome
-#    chrome://extensions → Developer mode → Load unpacked → select packages/argus-extension
-#    Copy Extension ID (e.g. kkoefnlnjlnlbohcifcbkpgmjaokmipi)
+The extension ID is **pinned** (via a `key` in the manifest), so there's no ID to copy/paste and the prebuilt extension ships with the CLI — no build step. Useful sub-commands:
 
-# 3) Install native host
-argus extension setup <EXTENSION_ID>
-argus extension status
+```bash
+argus extension path      # absolute folder to "Load unpacked"
+argus extension status    # native host config + extension ID
+argus extension install --no-wait   # scripted/non-interactive (skip the connect wait)
 ```
 
+Advanced: `argus extension setup [extensionId]` installs only the native hosts (pass an id to override the pinned one for a differently-keyed build).
+
+> Migration: if you previously loaded an unkeyed build, reload the extension once at `chrome://extensions` so it picks up the pinned ID.
+
 ### Usage
 
 1. Click Argus extension icon

package/dist/skill/argus/reference/INSPECT.md

@@ -74,8 +74,10 @@ argus fill app --selector "#username" "Bob"
 argus fill app --selector "#desc" --value-file ./description.txt
 echo "hello" | argus fill app --selector "#input" --value-stdin
 argus keydown app --key Enter
+argus keydown app --key G
+argus keydown app --code KeyG --print-event
 argus keydown app --key a --selector "#input"
-argus keydown app --key a --modifiers shift,ctrl
+argus keydown app --key a --shift --ctrl
 argus scroll-to app --selector "#footer"
 argus scroll-to app --to 0,1000
 argus scroll-to app --selector ".panel" --by 0,500

package/dist/skill/argus/reference/NET.md

@@ -87,6 +87,7 @@ argus net mock add app --url "*/analytics/*" --block
 argus net mock add app --url "*/api/save" --fail ConnectionRefused
 argus net mock add app --url "*/api/init" --fail TimedOut --times 1
 argus net mock add app --url "*/api/config" --status 200 --body-file ./fixtures/config.json
+argus net mock add extension --scope selected --url "*/api/config" --status 200 --body-file ./fixtures/config.json
 argus net mock add app --url "*/api/config" --status 500 --body '{"error":"maintenance"}'
 echo '{"flags":{"newShop":true}}' | argus net mock add app --url "*/api/flags" --body -
 argus net mock add app --url "*/api/*" --delay 2s --method POST
@@ -97,7 +98,9 @@ argus net mock rm 2 app
 argus net mock clear app
 ```
 
-Rules persist across reloads and reattach until removed. First matching rule wins. `--url` is a case-insensitive wildcard pattern over the full request URL; `*` matches anything, and no `*` means substring match. Use `--times N` for one-shot failures.
+Rules persist across reloads and reattach until removed. First matching rule wins. `--url` is a case-insensitive wildcard pattern over the full request URL; `*` matches anything, and no `*` means substring match. Use `--times N` to limit any rule, including stubbed responses.
+
+Mock scope defaults to `page`, preserving the original top-level behavior. Use `--scope selected` or its `--frame selected` alias for the currently selected iframe; selected rules follow target changes and re-arm after reload/reattach. `--scope` and `--frame` are mutually exclusive.
 
 Exactly one primary action per rule:
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/argus",
-	"version": "0.1.19",
+	"version": "0.1.21",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/vforsh/argus.git",
@@ -36,7 +36,7 @@
 	"scripts": {
 		"clean": "node ../../scripts/clean-dist.mjs",
 		"build": "npm run clean && tsc -b && bun run bundle",
-		"bundle": "bun build dist/bin.js --outfile dist/argus.js --target node --external esbuild && node ../../scripts/copy-argus-skill.mjs",
+		"bundle": "bun build dist/bin.js --outfile dist/argus.js --target node --external esbuild && node ../../scripts/copy-argus-skill.mjs && node ../../scripts/copy-argus-extension.mjs",
 		"typecheck": "tsc -b --pretty false",
 		"chrome:start": "bun src/bin.ts chrome start"
 	}