agent-device-lab 0.3.0 → 0.3.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.
Files changed (2) hide show
  1. package/README.md +12 -4
  2. package/package.json +8 -3
package/README.md CHANGED
@@ -1,17 +1,17 @@
1
1
  # Agent Device Lab
2
2
 
3
- Agent Device Lab lets a coding agent start your web app, use it on a phone-sized screen, and report what breaks, while you watch.
3
+ Agent Device Lab lets a coding agent start your web app, use it at phone, tablet or desktop size, and report what breaks, while you watch.
4
4
 
5
5
  - **It runs your project.** The lab starts the services your app needs, in order, or attaches to ones already running. When it finishes it stops only what it started.
6
6
  - **It gives the agent a small, exact view.** The agent gets a short list of the controls on screen, each with a ref (`e1`, `e2`, ...). After every click or keystroke it gets only what changed.
7
- - **It finds layout defects.** It records problems a person would hit on a small screen, such as a button pushed off the edge, each with measurements and the steps to reproduce it.
7
+ - **It finds layout defects.** It records problems a person would hit at each screen size, such as a button pushed off the edge on a phone, each with measurements and the steps to reproduce it.
8
8
  - **You stay in charge.** A local dashboard shows the agent's screen live. You can pause the agent, take over the browser, hand it back, or stop the run.
9
9
 
10
10
  The same commands work from a terminal (`agentlab`), from an MCP server for Claude Code and Codex, and in CI with predictable exit codes.
11
11
 
12
12
  ![The dashboard after a run on the demo app: the live viewport in the centre, the timeline of actions on the left, and the findings on the right with one selected to show its evidence and reproduction steps](docs/images/dashboard.png)
13
13
 
14
- **Status:** Web V1 (`0.3.0`). It is tested on Linux x64 (Debian 12 and Ubuntu 24.04) with Node.js 22 and 24. macOS, Windows and arm64 are untested, and Alpine does not work. See [Limitations](#limitations).
14
+ **Status:** Web V1 (`0.3.1`). It is tested on Linux x64 (Debian 12 and Ubuntu 24.04) with Node.js 22 and 24. macOS, Windows and arm64 are untested, and Alpine does not work. See [Limitations](#limitations).
15
15
 
16
16
  ## Install
17
17
 
@@ -43,7 +43,7 @@ In your own project the short version is:
43
43
  cd /path/to/your-app
44
44
 
45
45
  agentlab init # shows what it detected and the agentlab.json it proposes; writes nothing until you confirm
46
- agentlab start # starts your app, opens a phone-sized browser, prints the first observation
46
+ agentlab start # starts your app, opens a browser at the size in your profile (phone by default), prints the first observation
47
47
  agentlab ui # opens the dashboard so you can watch
48
48
 
49
49
  agentlab observe # the controls on screen, with refs
@@ -69,6 +69,8 @@ The lab reads one file in your project, `agentlab.json`. A minimal one:
69
69
  }
70
70
  ```
71
71
 
72
+ `device` sets the screen the agent uses: `mobile-320`, `mobile-390`, `tablet-768` or `desktop-1440`. Everything works the same way at each size.
73
+
72
74
  The lab runs only the commands written there, so committing the file is how you approve them. Every setting is in [docs/configuration.md](docs/configuration.md).
73
75
 
74
76
  ## Use it from your coding agent
@@ -138,6 +140,12 @@ Measurements of the lab, including a benchmark against Playwright MCP and runs o
138
140
 
139
141
  Building, testing and the project's rules are in [CONTRIBUTING.md](CONTRIBUTING.md). Report a security issue privately as described in [SECURITY.md](SECURITY.md), not in a public issue. Changes by release are in [CHANGELOG.md](CHANGELOG.md).
140
142
 
143
+ ## Support development
144
+
145
+ If Agent Device Lab is useful to you, you can support its ongoing development
146
+ for $2/month on [Patreon](https://www.patreon.com/Ikafa).
147
+ Support is completely optional.
148
+
141
149
  ## Licence
142
150
 
143
151
  Apache License 2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE). Copyright 2026 Colony Innovations.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "agent-device-lab",
3
- "version": "0.3.0",
4
- "description": "Lets a coding agent start your web app, use it on a phone-sized screen, and report what breaks, while you watch.",
3
+ "version": "0.3.1",
4
+ "description": "Lets a coding agent start your web app, use it at phone, tablet or desktop size, and report what breaks, while you watch.",
5
5
  "keywords": [
6
6
  "agent",
7
7
  "coding-agent",
@@ -9,6 +9,7 @@
9
9
  "playwright",
10
10
  "responsive",
11
11
  "mobile",
12
+ "desktop",
12
13
  "testing",
13
14
  "dev-server",
14
15
  "claude-code",
@@ -24,6 +25,10 @@
24
25
  "bugs": {
25
26
  "url": "https://github.com/Colony-Innovations/agent-device-lab/issues"
26
27
  },
28
+ "funding": {
29
+ "type": "patreon",
30
+ "url": "https://www.patreon.com/Ikafa"
31
+ },
27
32
  "type": "module",
28
33
  "bin": {
29
34
  "agentlab": "bin/agentlab.js"
@@ -49,7 +54,7 @@
49
54
  "verify:package": "node scripts/verify-package.mjs"
50
55
  },
51
56
  "dependencies": {
52
- "@modelcontextprotocol/sdk": "1.30.1",
57
+ "@modelcontextprotocol/sdk": "1.32.1",
53
58
  "playwright": "1.63.0"
54
59
  },
55
60
  "devDependencies": {