@beryl-so/cli 0.51.0 → 0.52.0

package/dist/beryl-test-skill.js

@@ -365,6 +365,17 @@ ${JSON.stringify(BERYL_TEST_SKILL_EXAMPLE_PLAN, null, 2)
    shows any, offer them once (\`tests_set_groups\`); no answer = leave it ungrouped and
    move on. Never create a group yourself, that is the user's call.
 
+### Testing a mobile or tablet viewport
+A test runs at a desktop viewport unless you say otherwise. To cover a responsive layout,
+set \`device\` on the plan: \`"mobile"\` or \`"tablet"\` (default \`"desktop"\`). This is
+full Chromium device emulation, not a resize: the viewport, a mobile Chrome user-agent,
+touch and the device pixel ratio all change together, so a hamburger or a nav that only
+exists on small screens actually renders and is testable. \`mobile\` emulates a Pixel-class
+phone, \`tablet\` a Galaxy-class tablet; both keep a Chrome user-agent so the emulated UA
+matches the engine. Author the flow at that size over the Playwright MCP (resize the MCP
+browser to match) so the refs you act on are the ones the small-screen layout renders. The
+account, session and teardown rules are unchanged; \`device\` only sets the frame it runs in.
+
 ### The outcome assertion is the whole game
 
 A flow is only worth banking if you can point at the **success signal** — the one

package/dist/schema.generated.js

@@ -36,6 +36,16 @@ export const ACTION_PLAN_SCHEMA = {
             "title": "AuthMode",
             "type": "string"
         },
+        "DeviceClass": {
+            "description": "The viewport and device a test runs at. The AUTHOR sets it when a flow is specific\nto a form factor (a mobile-only nav, a hamburger, a stacked layout); omit it and the\ntest runs at the default desktop viewport.\n\n``mobile`` / ``tablet`` are full Chromium device emulation, not a bare resize: the\nviewport, a mobile Chrome user-agent, touch, and the device pixel ratio all change\ntogether, so a control gated behind a touch or mobile-UA media query actually appears.",
+            "enum": [
+                "desktop",
+                "tablet",
+                "mobile"
+            ],
+            "title": "DeviceClass",
+            "type": "string"
+        },
         "DialogChoice": {
             "enum": [
                 "accept",
@@ -1344,6 +1354,11 @@ export const ACTION_PLAN_SCHEMA = {
             "title": "Before",
             "type": "array"
         },
+        "device": {
+            "$ref": "#/$defs/DeviceClass",
+            "default": "desktop",
+            "description": "Viewport and device to run at. 'mobile' and 'tablet' apply full Chromium device emulation (viewport, mobile user-agent, touch, pixel ratio); 'desktop' (default) runs at the standard desktop viewport."
+        },
         "requires_auth": {
             "default": false,
             "title": "Requires Auth",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beryl-so/cli",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "description": "Beryl on the command line — projects, runs, the exploring agent, and an MCP server over the same commands.",
   "license": "MIT",
   "type": "module",