@beryl-so/cli 0.22.0 → 0.24.1

package/dist/skill-tables.js

@@ -0,0 +1,74 @@
+// Table rows derive from the schema snapshot at module load, so the skill can never
+// drift from the plan language; only the one-liners are hand-written, and parity
+// tests fail when a schema enum gains or loses a member the docs don't cover.
+import { ACTION_PLAN_SCHEMA } from "./schema.generated.js";
+const defs = ACTION_PLAN_SCHEMA.$defs;
+export const ACTION_TYPES = defs.ActionType.enum;
+export const EXPECT_KINDS = defs.ExpectKind.enum;
+export const EMAIL_EXTRACTS = defs.EmailExtract.enum;
+function actionRequires(action) {
+    const rule = defs.PlanStep.allOf.find((r) => r.if.properties.action?.const === action && !r.if.properties.extract);
+    return rule?.then.required ?? [];
+}
+function expectRequires(kind) {
+    const rule = defs.PlanStep.allOf.find((r) => r.if.properties.expect_kind?.const === kind);
+    return rule?.then.required ?? [];
+}
+export const ACTION_DOCS = {
+    goto: "Navigate to `url` — a path on your app, absolute only for another origin",
+    fill: "Type `value` into the `selector` element",
+    click: "Click the `selector` element",
+    press: "Press keyboard `key` (e.g. `Enter`) on the `selector` element",
+    check: "Check the `selector` checkbox",
+    uncheck: "Uncheck the `selector` checkbox",
+    select: "Choose `option` in the `selector` dropdown",
+    hover: "Hover the `selector` element",
+    scroll: "Scroll the page (no selector) or bring `selector` into view — see below",
+    wait_for: "Wait for the `selector` element to appear",
+    expect: "Assert — kinds in the expect table below",
+    capture_count: "Bank the live count of `selector` matches under `capture_as` for a later `count_delta`",
+    await_email: "Await mail in the run inbox, bank the extracted value under `capture_as` (§5)",
+    upload: "Set a file input: `value` names a project config file — see below",
+    dialog: "Arm a one-shot accept/dismiss handler for the NEXT step's dialog — see below",
+    switch_tab: "Make another open tab the active page; `value` picks it — see below",
+    close_tab: "Close the active tab (optional `value` picks one) and fall back to the previous",
+    drag: "Drag the `selector` element onto the `value` TARGET selector",
+};
+export const EXPECT_DOCS = {
+    visible: "The element is visible",
+    attached: "In the DOM, maybe not shown — for carousel/slider content where `visible` is timing-flaky",
+    hidden: "The element is not visible",
+    checked: "The checkbox/radio is checked",
+    enabled: "The element is enabled",
+    disabled: "The element is disabled",
+    have_text: "The element's text EXACTLY equals `expect_text`",
+    have_value: "The input's value equals `expect_text`",
+    have_url: "The page URL contains `expect_text` (page-level, no selector)",
+    have_title: "The page title contains `expect_text` (page-level, no selector)",
+    have_count: "Exactly `expect_count` elements match `selector`",
+    persisted: "The record just created is present — a visible match for the `{{unique}}`-named row",
+    gone: "Zero matches — absent from the DOM, stronger than `hidden`",
+    count_delta: "The match count moved by signed `expect_delta` vs the `capture_ref` baseline",
+};
+export const EXTRACT_DOCS = {
+    code: "the one-time code",
+    link: "the sign-in/verify URL",
+    pattern: "your own regex in `extract_pattern`, exactly one capture group",
+};
+function table(header, rows) {
+    return [
+        `| ${header} | required fields | meaning |`,
+        "|---|---|---|",
+        ...rows.map(([name, req, doc]) => `| \`${name}\` | ${req} | ${doc} |`),
+    ].join("\n");
+}
+const fields = (names) => names.map((f) => `\`${f}\``).join(", ") || "—";
+export function actionTable() {
+    return table("action", ACTION_TYPES.map((a) => [a, fields(actionRequires(a)), ACTION_DOCS[a] ?? ""]));
+}
+export function expectTable() {
+    return table("expect_kind", EXPECT_KINDS.map((k) => [k, fields(expectRequires(k)), EXPECT_DOCS[k] ?? ""]));
+}
+export function extractLine() {
+    return EMAIL_EXTRACTS.map((e) => `\`${e}\` (${EXTRACT_DOCS[e] ?? ""})`).join(", ");
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beryl-so/cli",
-  "version": "0.22.0",
-  "description": "Beryl on the command line \u2014 projects, runs, the exploring agent, and an MCP server over the same commands.",
+  "version": "0.24.1",
+  "description": "Beryl on the command line — projects, runs, the exploring agent, and an MCP server over the same commands.",
   "license": "MIT",
   "type": "module",
   "homepage": "https://beryl.so/docs/cli",