feat(browser): add scrollintoview action

src/browser/client-actions-core.ts

@@ -36,6 +36,12 @@ export type BrowserActRequest =
     }
   | { kind: "press"; key: string; targetId?: string; delayMs?: number }
   | { kind: "hover"; ref: string; targetId?: string; timeoutMs?: number }
+  | {
+      kind: "scrollIntoView";
+      ref: string;
+      targetId?: string;
+      timeoutMs?: number;
+    }
   | {
       kind: "drag";
       startRef: string;

src/browser/pw-ai.ts

@@ -30,6 +30,7 @@ export {
   pressKeyViaPlaywright,
   resizeViewportViaPlaywright,
   responseBodyViaPlaywright,
+  scrollIntoViewViaPlaywright,
   selectOptionViaPlaywright,
   setDeviceViaPlaywright,
   setExtraHTTPHeadersViaPlaywright,

src/browser/pw-tools-core.ts

@@ -1160,6 +1160,25 @@ export async function responseBodyViaPlaywright(opts: {
   };
 }
 
+export async function scrollIntoViewViaPlaywright(opts: {
+  cdpUrl: string;
+  targetId?: string;
+  ref: string;
+  timeoutMs?: number;
+}): Promise<void> {
+  const page = await getPageForTargetId(opts);
+  ensurePageState(page);
+  const timeout = normalizeTimeoutMs(opts.timeoutMs, 20_000);
+
+  const ref = requireRef(opts.ref);
+  const locator = refLocator(page, ref);
+  try {
+    await locator.scrollIntoViewIfNeeded({ timeout });
+  } catch (err) {
+    throw toAIFriendlyError(err, ref);
+  }
+}
+
 export async function navigateViaPlaywright(opts: {
   cdpUrl: string;
   targetId?: string;

src/browser/routes/agent.ts

@@ -29,6 +29,7 @@ type ActKind =
   | "evaluate"
   | "fill"
   | "hover"
+  | "scrollIntoView"
   | "press"
   | "resize"
   | "select"
@@ -154,6 +155,7 @@ export function registerBrowserAgentRoutes(
       kind !== "evaluate" &&
       kind !== "fill" &&
       kind !== "hover" &&
+      kind !== "scrollIntoView" &&
       kind !== "press" &&
       kind !== "resize" &&
       kind !== "select" &&
@@ -257,6 +259,21 @@ export function registerBrowserAgentRoutes(
           });
           return res.json({ ok: true, targetId: tab.targetId });
         }
+        case "scrollIntoView": {
+          const ref = toStringOrEmpty(body.ref);
+          if (!ref) return jsonError(res, 400, "ref is required");
+          const timeoutMs = toNumber(body.timeoutMs);
+          const scrollRequest: Parameters<
+            typeof pw.scrollIntoViewViaPlaywright
+          >[0] = {
+            cdpUrl,
+            targetId: tab.targetId,
+            ref,
+          };
+          if (timeoutMs) scrollRequest.timeoutMs = timeoutMs;
+          await pw.scrollIntoViewViaPlaywright(scrollRequest);
+          return res.json({ ok: true, targetId: tab.targetId });
+        }
         case "drag": {
           const startRef = toStringOrEmpty(body.startRef);
           const endRef = toStringOrEmpty(body.endRef);