@wenathlan/extension 1.1.31 → 1.1.32

package/extension/dist/pagebridge.js

@@ -1,14 +1,339 @@
 "use strict";
 (() => {
+  // policy.ts
+  var sensitiveactions = /* @__PURE__ */ new Set(["click", "type", "navigate", "select", "presskey", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "reload", "back", "forward", "writestorage", "setattribute", "removeattribute", "evaluate", "tabcreate", "tabactivate", "tabclose", "tabreload", "windowcreate", "windowclose", "windowresize", "downloadfile"]);
+  var interactionactions = /* @__PURE__ */ new Set(["focus", "scroll", "hover", "clickdeep", "rightclick", "doubleclick", "scrollpage", "scrollby", "scrollend", "scrolltop", "fullscreen", "zoomset"]);
+  var readactions = /* @__PURE__ */ new Set(["observe", "inspect", "extract", "wait", "waitfor", "waittext", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "readlinks", "readimages", "readmeta", "readforms", "readstorage", "highlight", "tablist", "windowlist", "tabsnapshot"]);
+  var allowedactions = /* @__PURE__ */ new Set([...sensitiveactions, ...interactionactions, ...readactions]);
+  function parseoptions(step) {
+    if (step.options === void 0) return {};
+    let parsed;
+    try {
+      parsed = JSON.parse(step.options);
+    } catch {
+      throw new Error("Step options must be a JSON object.");
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("Step options must be a JSON object.");
+    return parsed;
+  }
+
+  // extension/pageactions.ts
+  function events(target) {
+    target.dispatchEvent(new Event("input", { bubbles: true }));
+    target.dispatchEvent(new Event("change", { bubbles: true }));
+  }
+  function modifiers(options) {
+    return Array.isArray(options.modifiers) ? options.modifiers.filter((item) => typeof item === "string") : [];
+  }
+  function keyevent(type, key, mods) {
+    const code = key.length === 1 ? `Key${key.toUpperCase()}` : key;
+    return new KeyboardEvent(type, { key, code, bubbles: true, cancelable: true, composed: true, ctrlKey: mods.includes("ctrl"), shiftKey: mods.includes("shift"), altKey: mods.includes("alt"), metaKey: mods.includes("meta") });
+  }
+  function fieldlike(target) {
+    return target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement ? target : null;
+  }
+  function stringify(value) {
+    try {
+      return JSON.parse(JSON.stringify(value)) ?? null;
+    } catch {
+      return String(value);
+    }
+  }
+  function runpageaction(step, target) {
+    const options = (() => {
+      try {
+        return parseoptions(step);
+      } catch {
+        return {};
+      }
+    })();
+    switch (step.kind) {
+      case "presskey": {
+        const receiver = target instanceof HTMLElement ? target : document.activeElement instanceof HTMLElement ? document.activeElement : document.body;
+        const key = step.value ?? "";
+        const mods = modifiers(options);
+        receiver.dispatchEvent(keyevent("keydown", key, mods));
+        receiver.dispatchEvent(keyevent("keypress", key, mods));
+        receiver.dispatchEvent(keyevent("keyup", key, mods));
+        return { ok: true, summary: `Key ${key} delivered with ${mods.length} modifier${mods.length === 1 ? "" : "s"}.` };
+      }
+      case "clickdeep": {
+        if (!(target instanceof HTMLElement)) return { ok: false, summary: "Action target is no longer available." };
+        target.dispatchEvent(new PointerEvent("pointerdown", { bubbles: true, cancelable: true, composed: true }));
+        target.dispatchEvent(new MouseEvent("mousedown", { bubbles: true, cancelable: true }));
+        target.dispatchEvent(new PointerEvent("pointerup", { bubbles: true, cancelable: true, composed: true }));
+        target.dispatchEvent(new MouseEvent("mouseup", { bubbles: true, cancelable: true }));
+        target.click();
+        return { ok: true, summary: "Full pointer click sequence delivered." };
+      }
+      case "rightclick": {
+        if (!(target instanceof HTMLElement)) return { ok: false, summary: "Action target is no longer available." };
+        const init = { bubbles: true, cancelable: true, button: 2, buttons: 2 };
+        target.dispatchEvent(new PointerEvent("pointerdown", { ...init, composed: true }));
+        target.dispatchEvent(new MouseEvent("mousedown", init));
+        target.dispatchEvent(new MouseEvent("contextmenu", init));
+        return { ok: true, summary: "Context menu events delivered." };
+      }
+      case "doubleclick": {
+        if (!(target instanceof HTMLElement)) return { ok: false, summary: "Action target is no longer available." };
+        target.click();
+        target.click();
+        target.dispatchEvent(new MouseEvent("dblclick", { bubbles: true, cancelable: true, detail: 2 }));
+        return { ok: true, summary: "Double click sequence delivered." };
+      }
+      case "drag": {
+        if (!(target instanceof HTMLElement)) return { ok: false, summary: "Drag source is no longer available." };
+        const destination = document.querySelector(step.value ?? "");
+        if (!destination) return { ok: false, summary: "Drag destination is no longer available." };
+        const transfer = new DataTransfer();
+        if (typeof options.data === "string") transfer.setData("text/plain", options.data);
+        target.dispatchEvent(new DragEvent("dragstart", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        destination.dispatchEvent(new DragEvent("dragenter", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        destination.dispatchEvent(new DragEvent("dragover", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        destination.dispatchEvent(new DragEvent("drop", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        target.dispatchEvent(new DragEvent("dragend", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        return { ok: true, summary: "Drag and drop sequence delivered." };
+      }
+      case "drop": {
+        if (!(target instanceof HTMLElement)) return { ok: false, summary: "Drop zone is no longer available." };
+        const transfer = new DataTransfer();
+        transfer.setData("text/plain", step.value ?? "");
+        target.dispatchEvent(new DragEvent("dragenter", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        target.dispatchEvent(new DragEvent("dragover", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        target.dispatchEvent(new DragEvent("drop", { bubbles: true, cancelable: true, dataTransfer: transfer }));
+        return { ok: true, summary: "Drop payload delivered." };
+      }
+      case "upload": {
+        if (!(target instanceof HTMLInputElement) || target.type !== "file") return { ok: false, summary: "Target is not a file input." };
+        const transfer = new DataTransfer();
+        transfer.items.add(new File([typeof options.content === "string" ? options.content : ""], step.value ?? "upload", { type: typeof options.type === "string" ? options.type : "text/plain" }));
+        target.files = transfer.files;
+        events(target);
+        return { ok: true, summary: `Uploaded ${step.value ?? "file"} into the reviewed input.` };
+      }
+      case "clear": {
+        const field = fieldlike(target);
+        if (!field) return { ok: false, summary: "Target cannot hold a value." };
+        field.value = "";
+        events(field);
+        return { ok: true, summary: "Field cleared." };
+      }
+      case "check":
+      case "uncheck":
+      case "toggle": {
+        if (!(target instanceof HTMLInputElement) || target.type !== "checkbox" && target.type !== "radio") return { ok: false, summary: "Target is not a checkbox or radio control." };
+        if (step.kind === "uncheck" && target.type === "radio") return { ok: false, summary: "A radio control cannot be unchecked." };
+        target.checked = step.kind === "toggle" ? !target.checked : step.kind === "check";
+        events(target);
+        return { ok: true, summary: `Control is now ${target.checked ? "checked" : "unchecked"}.` };
+      }
+      case "submit": {
+        const form = target instanceof HTMLFormElement ? target : target instanceof HTMLElement ? target.closest("form") : null;
+        if (!form) return { ok: false, summary: "No form owns the reviewed target." };
+        try {
+          form.requestSubmit(target instanceof HTMLFormElement ? void 0 : target);
+        } catch {
+          form.submit();
+        }
+        return { ok: true, summary: "Form submission requested." };
+      }
+      case "setattribute": {
+        if (!target) return { ok: false, summary: "Action target is no longer available." };
+        const name = typeof options.name === "string" ? options.name : "";
+        target.setAttribute(name, typeof options.value === "string" ? options.value : "");
+        return { ok: true, summary: `Attribute ${name} set.` };
+      }
+      case "removeattribute": {
+        if (!target) return { ok: false, summary: "Action target is no longer available." };
+        const name = step.value ?? "";
+        target.removeAttribute(name);
+        return { ok: true, summary: `Attribute ${name} removed.` };
+      }
+      case "writestorage": {
+        try {
+          localStorage.setItem(typeof options.key === "string" ? options.key : "", typeof options.value === "string" ? options.value : "");
+          return { ok: true, summary: `Local storage entry ${String(options.key)} written.` };
+        } catch (error) {
+          return { ok: false, summary: `Local storage refused the write: ${error instanceof Error ? error.message : String(error)}` };
+        }
+      }
+      case "evaluate": {
+        try {
+          let outcome;
+          try {
+            outcome = new Function(`"use strict"; return (${step.value ?? "undefined"});`)();
+          } catch {
+            outcome = new Function(`"use strict"; ${step.value ?? ""}`)();
+          }
+          return { ok: true, summary: `Reviewed expression returned ${outcome === void 0 ? "no value" : "a value"}.`, details: { result: stringify(outcome) } };
+        } catch (error) {
+          return { ok: false, summary: `Reviewed expression failed: ${error instanceof Error ? error.message : String(error)}` };
+        }
+      }
+      case "fullscreen": {
+        const element = target instanceof HTMLElement ? target : document.documentElement;
+        return document.fullscreenElement === element ? document.exitFullscreen().then(() => ({ ok: true, summary: "Fullscreen state cleared." })) : element.requestFullscreen().then(() => ({ ok: true, summary: "Fullscreen state entered." })).catch((error) => ({ ok: false, summary: `Fullscreen was refused: ${error instanceof Error ? error.message : String(error)}` }));
+      }
+      default:
+        return { ok: false, summary: "Unsupported page action." };
+    }
+  }
+
+  // extension/pagereads.ts
+  var highlightid = "devthinkactionhighlight";
+  function clearhighlight() {
+    document.getElementById(highlightid)?.remove();
+  }
+  function highlighttarget(target) {
+    clearhighlight();
+    const rect = target.getBoundingClientRect();
+    const overlay = document.createElement("div");
+    overlay.id = highlightid;
+    overlay.setAttribute("aria-hidden", "true");
+    Object.assign(overlay.style, { position: "fixed", left: `${Math.max(0, rect.left - 3)}px`, top: `${Math.max(0, rect.top - 3)}px`, width: `${rect.width + 6}px`, height: `${rect.height + 6}px`, border: "3px solid #2f9e44", borderRadius: "6px", pointerEvents: "none", zIndex: "2147483647", boxSizing: "border-box" });
+    document.documentElement.append(overlay);
+    window.setTimeout(clearhighlight, 5e3);
+    return { ok: true, summary: "Target outlined for five seconds." };
+  }
+  function poll(predicate, description, timeout) {
+    return new Promise((resolve) => {
+      const started = Date.now();
+      const check = () => {
+        if (predicate()) {
+          resolve({ ok: true, summary: `${description} is now present on the page.` });
+          return;
+        }
+        if (timeout > 0 && Date.now() - started >= timeout) {
+          resolve({ ok: false, summary: `${description} did not appear within ${timeout} milliseconds.` });
+          return;
+        }
+        window.setTimeout(check, 100);
+      };
+      check();
+    });
+  }
+  function formstate() {
+    return [...document.querySelectorAll("input, textarea, select")].map((element) => ({
+      type: element.getAttribute("type") ?? element.tagName.toLowerCase(),
+      name: element.getAttribute("name") ?? "",
+      value: element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement ? element.value : "",
+      ...element instanceof HTMLInputElement && (element.type === "checkbox" || element.type === "radio") ? { checked: element.checked } : {}
+    }));
+  }
+  function runpageread(step, target) {
+    const options = (() => {
+      try {
+        return parseoptions(step);
+      } catch {
+        return {};
+      }
+    })();
+    switch (step.kind) {
+      case "highlight": {
+        if (!target) return { ok: false, summary: "Highlight target is no longer available." };
+        return highlighttarget(target);
+      }
+      case "readattribute": {
+        if (!target) return { ok: false, summary: "Read target is no longer available." };
+        const value = target.getAttribute(step.value ?? "");
+        return value === null ? { ok: false, summary: `Attribute ${step.value} is absent.` } : { ok: true, summary: `Attribute ${step.value} read.`, details: { value } };
+      }
+      case "readstyle": {
+        if (!target) return { ok: false, summary: "Read target is no longer available." };
+        const computed = getComputedStyle(target);
+        const styles = {};
+        for (let index = 0; index < computed.length; index += 1) {
+          const property = computed.item(index);
+          styles[property] = computed.getPropertyValue(property);
+        }
+        return { ok: true, summary: `Read ${computed.length} computed style properties.`, details: { styles } };
+      }
+      case "readgeometry": {
+        if (!target) return { ok: false, summary: "Read target is no longer available." };
+        const rect = target.getBoundingClientRect();
+        const geometry = { x: rect.x, y: rect.y, width: rect.width, height: rect.height, top: rect.top, right: rect.right, bottom: rect.bottom, left: rect.left };
+        return { ok: true, summary: "Target geometry read.", details: { geometry } };
+      }
+      case "readvalue": {
+        if (!(target instanceof HTMLInputElement || target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement)) return { ok: false, summary: "Target does not hold a form value." };
+        return { ok: true, summary: "Form value read.", details: { value: target.value } };
+      }
+      case "readtext": {
+        if (!target) return { ok: false, summary: "Read target is no longer available." };
+        const text = target.textContent ?? "";
+        return { ok: true, summary: `Read ${text.length} characters of text.`, details: { text } };
+      }
+      case "readhtml": {
+        if (!target) return { ok: false, summary: "Read target is no longer available." };
+        return { ok: true, summary: "Target markup read.", details: { html: target.outerHTML } };
+      }
+      case "countelements": {
+        const count = document.querySelectorAll(step.target ?? "").length;
+        return { ok: true, summary: `Selector matches ${count} element${count === 1 ? "" : "s"}.`, details: { count } };
+      }
+      case "readtable": {
+        if (!(target instanceof HTMLTableElement)) return { ok: false, summary: "Read target is not a table element." };
+        const rows = [...target.querySelectorAll("tr")].map((row) => [...row.querySelectorAll("th, td")].map((cell) => cell.textContent?.trim() ?? ""));
+        const headers = rows[0] ?? [];
+        const body = rows.slice(1);
+        return { ok: true, summary: `Read table with ${headers.length} column${headers.length === 1 ? "" : "s"} and ${body.length} row${body.length === 1 ? "" : "s"}.`, details: { headers, rows: body } };
+      }
+      case "readlinks": {
+        const links = [...document.querySelectorAll("a[href]")].map((element) => ({ text: element.textContent?.trim() ?? "", href: element.getAttribute("href") ?? "" }));
+        return { ok: true, summary: `Read ${links.length} link${links.length === 1 ? "" : "s"}.`, details: { links } };
+      }
+      case "readimages": {
+        const images = [...document.querySelectorAll("img")].map((element) => ({ src: element.getAttribute("src") ?? "", alt: element.getAttribute("alt") ?? "" }));
+        return { ok: true, summary: `Read ${images.length} image${images.length === 1 ? "" : "s"}.`, details: { images } };
+      }
+      case "readmeta": {
+        const meta = [...document.querySelectorAll("meta")].map((element) => ({ name: element.getAttribute("name") ?? "", property: element.getAttribute("property") ?? "", content: element.getAttribute("content") ?? "" }));
+        return { ok: true, summary: `Read ${meta.length} meta entr${meta.length === 1 ? "y" : "ies"}.`, details: { meta } };
+      }
+      case "readforms": {
+        const forms = formstate();
+        return { ok: true, summary: `Read ${forms.length} form control${forms.length === 1 ? "" : "s"}.`, details: { forms } };
+      }
+      case "readstorage": {
+        try {
+          if (step.value) {
+            const value = localStorage.getItem(step.value);
+            return { ok: true, summary: `Read local storage entry ${step.value}.`, details: { value } };
+          }
+          const entries = {};
+          for (let index = 0; index < localStorage.length; index += 1) {
+            const key = localStorage.key(index);
+            if (key !== null) entries[key] = localStorage.getItem(key);
+          }
+          return { ok: true, summary: `Read ${Object.keys(entries).length} local storage entr${Object.keys(entries).length === 1 ? "y" : "ies"}.`, details: { entries } };
+        } catch (error) {
+          return { ok: false, summary: `Local storage refused the read: ${error instanceof Error ? error.message : String(error)}` };
+        }
+      }
+      case "waitfor": {
+        const selector2 = step.target ?? "";
+        const timeout = typeof options.timeout === "number" ? options.timeout : 0;
+        return poll(() => Boolean(document.querySelector(selector2)), `Selector ${selector2}`, timeout);
+      }
+      case "waittext": {
+        const text = step.value ?? "";
+        const timeout = typeof options.timeout === "number" ? options.timeout : 0;
+        return poll(() => (document.body?.innerText ?? "").includes(text), `Text ${text}`, timeout);
+      }
+      default:
+        return { ok: false, summary: "Unsupported page read." };
+    }
+  }
+
   // extension/pagebridge.ts
-  function bounded(value, length = 180) {
-    return value.replace(/\s+/g, " ").trim().slice(0, length);
+  function clean(value) {
+    return value.replace(/\s+/g, " ").trim();
   }
   function label(element) {
     const aria = element.getAttribute("aria-label");
     const labelledby = element.getAttribute("aria-labelledby");
     const linked = labelledby ? document.getElementById(labelledby)?.textContent : "";
-    return bounded(aria || linked || element.getAttribute("title") || element.textContent || "");
+    return clean(aria || linked || element.getAttribute("title") || element.textContent || "");
   }
   function selector(element) {
     if (element.id) return `#${CSS.escape(element.id)}`;
@@ -22,6 +347,15 @@
     const peers = [...parent.children].filter((node) => node.tagName === element.tagName);
     return `${tag}:nth-of-type(${peers.indexOf(element) + 1})`;
   }
+  function stepoptions(step) {
+    if (!step.options) return {};
+    try {
+      const parsed = JSON.parse(step.options);
+      return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+    } catch {
+      return {};
+    }
+  }
   var previewid = "devthinktargetpreview";
   function clearpreview() {
     document.getElementById(previewid)?.remove();
@@ -42,28 +376,29 @@
     return { ok: true, summary: `Previewing ${label(target) || target.tagName.toLowerCase()} for five seconds.` };
   }
   function capturesnapshot() {
-    const candidates = [...document.querySelectorAll("a[href], button, input, textarea, select, [role=button], [role=link], [role=combobox], [role=option], details, summary")].slice(0, 80);
+    const candidates = [...document.querySelectorAll("a[href], button, input, textarea, select, [role=button], [role=link], [role=combobox], [role=option], [role=checkbox], [role=radio], [role=switch], [role=tab], details, summary")];
     const interactive = candidates.map((element) => ({ selector: selector(element), role: element.getAttribute("role") || element.tagName.toLowerCase(), label: label(element) })).filter((item) => item.label || item.role);
-    const forms = [...document.querySelectorAll("input, textarea, select")].slice(0, 40).map((element) => ({
+    const forms = [...document.querySelectorAll("input, textarea, select")].map((element) => ({
       label: label(element),
       type: element.getAttribute("type") || element.tagName.toLowerCase(),
       name: element.getAttribute("name") || "",
-      ...element instanceof HTMLSelectElement ? { options: [...element.options].slice(0, 12).map((option) => bounded(option.textContent || option.value, 60)) } : {}
+      ...element instanceof HTMLSelectElement ? { options: [...element.options].map((option) => clean(option.textContent || option.value)) } : {}
     }));
-    const text = bounded(document.body?.innerText || "", 2e3);
-    return { url: location.href, title: bounded(document.title, 180), textpreview: text, textlength: document.body?.innerText.length ?? 0, forms, interactive, capturedat: Date.now() };
+    const text = clean(document.body?.innerText || "");
+    return { schemaversion: 2, url: location.href, title: clean(document.title), textpreview: text, textlength: document.body?.innerText.length ?? 0, forms, interactive, capturedat: Date.now() };
   }
   function extractcontent(targetselector) {
     if (!targetselector) {
-      const links = [...document.querySelectorAll("a[href]")].slice(0, 25).map((element) => {
+      const links = [...document.querySelectorAll("a[href]")].map((element) => {
         const href = element instanceof HTMLAnchorElement ? element.getAttribute("href") ?? "" : "";
-        return `${bounded(element.textContent || "")} (${bounded(href, 120)})`;
+        return { text: element.textContent?.trim() ?? "", href };
       });
-      return { ok: true, summary: `Extracted ${links.length} bounded link entries: ${links.join("; ").slice(0, 180) || "no links present"}.` };
+      return { ok: true, summary: `Extracted ${links.length} link entries.`, details: { links } };
     }
     const target = document.querySelector(targetselector);
     if (!target) return { ok: false, summary: "Extraction target is no longer available." };
-    return { ok: true, summary: `Extracted: ${bounded(target.textContent || "", 180) || "empty target"}.` };
+    const text = target.textContent ?? "";
+    return { ok: true, summary: `Extracted ${text.length} characters of content.`, details: { text } };
   }
   function scrolltarget(target) {
     target.scrollIntoView({ block: "center", inline: "nearest", behavior: "auto" });
@@ -83,15 +418,17 @@
     target.value = option.value;
     target.dispatchEvent(new Event("input", { bubbles: true }));
     target.dispatchEvent(new Event("change", { bubbles: true }));
-    return { ok: true, summary: `Selected ${bounded(option.textContent || option.value, 60)}.` };
+    return { ok: true, summary: `Selected ${clean(option.textContent || option.value)}.` };
   }
+  var readkinds = /* @__PURE__ */ new Set(["readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "readlinks", "readimages", "readmeta", "readforms", "readstorage", "waitfor", "waittext", "highlight"]);
+  var mutatingkinds = /* @__PURE__ */ new Set(["presskey", "clickdeep", "rightclick", "doubleclick", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "setattribute", "removeattribute", "writestorage", "evaluate", "fullscreen"]);
   function performstep(step, expectedorigin) {
     if (location.origin !== expectedorigin) return { ok: false, summary: "Page origin changed before action." };
     if (step.kind === "observe") return { ok: true, summary: "Observation completed." };
     if (step.kind === "wait") {
       const requested = step.value ? Number.parseInt(step.value, 10) : 250;
-      const duration = Number.isFinite(requested) && requested > 0 ? Math.min(requested, 1e4) : 0;
-      return new Promise((resolve) => window.setTimeout(() => resolve({ ok: true, summary: `Bounded wait of ${duration} milliseconds completed.` }), duration));
+      const duration = Number.isFinite(requested) && requested > 0 ? requested : 0;
+      return new Promise((resolve) => window.setTimeout(() => resolve({ ok: true, summary: `Reviewed wait of ${duration} milliseconds completed.` }), duration));
     }
     if (step.kind === "extract") return extractcontent(step.target);
     if (step.kind === "navigate") {
@@ -99,9 +436,41 @@
       location.assign(step.value);
       return { ok: true, summary: "Navigation request sent." };
     }
+    if (step.kind === "reload") {
+      location.reload();
+      return { ok: true, summary: "Page reload requested." };
+    }
+    if (step.kind === "back") {
+      history.back();
+      return { ok: true, summary: "History back requested." };
+    }
+    if (step.kind === "forward") {
+      history.forward();
+      return { ok: true, summary: "History forward requested." };
+    }
+    if (step.kind === "scrollpage") {
+      const options = stepoptions(step);
+      window.scrollBy({ left: typeof options.x === "number" ? options.x : 0, top: typeof options.y === "number" ? options.y : 600, behavior: "auto" });
+      return { ok: true, summary: "Window scrolled by the reviewed amounts." };
+    }
+    if (step.kind === "scrollend") {
+      window.scrollTo(0, document.documentElement.scrollHeight);
+      return { ok: true, summary: "Window scrolled to the page end." };
+    }
+    if (step.kind === "scrolltop") {
+      window.scrollTo(0, 0);
+      return { ok: true, summary: "Window scrolled to the page top." };
+    }
+    if (readkinds.has(step.kind)) return runpageread(step, step.target ? document.querySelector(step.target) : null);
+    if (mutatingkinds.has(step.kind)) return runpageaction(step, step.target ? document.querySelector(step.target) : null);
     if (!step.target) return { ok: false, summary: "Action target is absent." };
     const target = document.querySelector(step.target);
     if (!(target instanceof HTMLElement)) return { ok: false, summary: "Action target is no longer available." };
+    if (step.kind === "scrollby") {
+      const options = stepoptions(step);
+      target.scrollBy({ left: typeof options.x === "number" ? options.x : 0, top: typeof options.y === "number" ? options.y : 600, behavior: "auto" });
+      return { ok: true, summary: "Container scrolled by the reviewed amounts." };
+    }
     if (step.kind === "focus") {
       target.focus();
       return { ok: true, summary: "Target focused." };