@petukhovart/agent-view 0.17.0 → 0.17.1
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.
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-view",
|
|
3
3
|
"description": "Visual verification CLI for Electron/Tauri/Chromium apps via Chrome DevTools Protocol. Ships with verify skill for easy and cheap checks against a live app, including heap-snapshot memory-leak debugging.",
|
|
4
|
-
"version": "0.17.
|
|
4
|
+
"version": "0.17.1",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cdp",
|
|
7
7
|
"electron",
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: act-decider
|
|
3
|
+
description: Drives one UI scenario in a running app step by step through `agent-view act`, choosing each click or input from a numbered control table. Use when the goal and a done-condition (a test id or selector that appears on success) are known; diagnosis and visual checks go to cdp-verifier.
|
|
4
|
+
model: sonnet
|
|
5
|
+
effort: low
|
|
6
|
+
maxTurns: 40
|
|
7
|
+
tools: Bash
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
You get a goal, a done-condition and a working directory. Your only job is the `act` loop. You do not read code, take screenshots or debug.
|
|
11
|
+
|
|
12
|
+
Run every command from the working directory you were given, with the environment variables you were given.
|
|
13
|
+
|
|
14
|
+
1. `agent-view act start --until-testid <id> --save <name>` (or `--until-selector <css>`; `--save` only if you were given a name). It prints a control table:
|
|
15
|
+
`[3] button "Войти" testid=login-btn`. Numbers are valid only for the table printed last.
|
|
16
|
+
2. Pick exactly one action for the goal and run it:
|
|
17
|
+
- `agent-view act click <n>`
|
|
18
|
+
- `agent-view act type <n> '<text>'` — for a text field; it focuses the field itself, no click first
|
|
19
|
+
- `agent-view act do "type <n> <text>" "type <m> <text>" "click <k>"` — several steps you can already decide from this one table (a whole form). All numbers refer to this table.
|
|
20
|
+
- `agent-view act select <n> '<option>'` — native select only
|
|
21
|
+
- `agent-view act scroll down` / `up` — when the control you need is not in the table and the table says more are below
|
|
22
|
+
- `agent-view act drag <n>` — drag row n onto the middle of the screen; `agent-view act drag <n> <m>` — onto row m; when the goal names where to drop, use `agent-view act drag <n> testid=<id> <edge>` (edge: left|right|top|bottom|center). Only when the goal says to drag or place something.
|
|
23
|
+
- `agent-view act wait` — when the table shows the app busy (fields disabled, a spinner) and nothing to act on yet
|
|
24
|
+
3. Read the output:
|
|
25
|
+
- `DONE: …` — stop. The done-condition was checked by agent-view, not by you.
|
|
26
|
+
- `✓ …` and a new table — go to 2.
|
|
27
|
+
- `BLOCKED: …` — the table under it is fresh. Choose another action from it. If the same step blocks twice, stop.
|
|
28
|
+
|
|
29
|
+
Write no text between commands — only tool calls until the final reply.
|
|
30
|
+
Run `act start` once, at the beginning — it wipes the recorded steps. If a command errors or the table is empty (the window is reloading), run `agent-view act wait`.
|
|
31
|
+
Never pass a number from an older table. Never guess text the goal did not give you. If the goal cannot be reached from the controls you see, stop.
|
|
32
|
+
|
|
33
|
+
Final reply, nothing else:
|
|
34
|
+
```
|
|
35
|
+
verdict: DONE | BLOCKED | STUCK
|
|
36
|
+
steps: <n>
|
|
37
|
+
<one line per action: op [n] role "name">
|
|
38
|
+
last: <the DONE/BLOCKED line, or why you stopped>
|
|
39
|
+
candidates: <for BLOCKED/STUCK: the 3–5 rows closest to what you needed, copied verbatim>
|
|
40
|
+
```
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@petukhovart/agent-view",
|
|
3
|
-
"version": "0.17.
|
|
3
|
+
"version": "0.17.1",
|
|
4
4
|
"description": "CLI tool for visual verification of desktop apps (Electron/Tauri) via Chrome DevTools Protocol",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
"files": [
|
|
11
11
|
"dist",
|
|
12
12
|
".claude-plugin",
|
|
13
|
+
"agents",
|
|
13
14
|
"skills",
|
|
14
15
|
"README.md",
|
|
15
16
|
"LICENSE"
|
package/skills/verify/SKILL.md
CHANGED
|
@@ -50,7 +50,7 @@ Verifications cost very different amounts. Pick the cheapest tool that can actua
|
|
|
50
50
|
| Does `window.X` / a globally-exposed API exist? | `eval "typeof window.X"` | DOM doesn't show JS globals; only authoritative check |
|
|
51
51
|
| Acting on an element `dom` shows with `[testid=…]` | `click` / `fill` / `wait --testid <id>` | Survives HMR, navigation and copy changes; a ref and a text filter do not |
|
|
52
52
|
| An element that has not rendered yet | `wait --filter "<text>"` | Exits on appearance and non-zero on timeout — a real gate, unlike a fixed pause |
|
|
53
|
-
| A multi-step UI scenario with a known end state (login, a form) | `act start --until-testid <id>` … `act replay <name>` | One call per step with a small table; the done check and the replay need no model
|
|
53
|
+
| A multi-step UI scenario with a known end state (login, a form) | `act start --until-testid <id>` … `act replay <name>` | One call per step with a small table; hand the loop to the `act-decider` agent — the done check and the replay need no model |
|
|
54
54
|
| State *trajectory* — what changed during/after an action | `watch "expr" --until …` or `--max-changes 1` | `eval` shows the final snapshot only; `watch` shows the diffs in order |
|
|
55
55
|
| Worker logic (SharedWorker / ServiceWorker) | `eval --target <name>` | Workers have no DOM at all |
|
|
56
56
|
| Did the last action throw or warn? | `console --clear` before, `console --level error,warn` after | Catches errors that don't surface in the DOM |
|