@flowriki/agent 0.1.0-beta.24 → 0.1.0-beta.26

package/dist/{chunk-EBT7VSPY.js → chunk-IH7KFCV4.js}

@@ -6,7 +6,7 @@ import os from "os";
 import path from "path";
 import { createRequire } from "module";
 import { spawnSync } from "child_process";
-var AGENT_VERSION = "0.1.0-beta.24";
+var AGENT_VERSION = "0.1.0-beta.26";
 async function prepareBrowsers() {
   if (browsersReady()) {
     return { ok: true, already: true, message: "chromium is already installed" };
@@ -1053,7 +1053,25 @@ var FlowOccurrenceSchema = z22.object({
      *  against the source can line the two up; nothing depends on it to run. */
     stepIds: z22.record(z22.string(), z22.string()).default({}),
     copiedAt: z22.string()
-  })
+  }),
+  /** WHICH OF THIS ROW'S STEPS ARE WHAT RUNS BEFORE ITS FLOW — the flow's
+   *  sign-in and the prerequisites copied in with it — so the row can be shown
+   *  folded, the way the Flows screen shows the same flow.
+   *
+   *  A description of steps the row already holds, and nothing more: they are
+   *  ordinary copies in `steps` and run in order whatever this says. Kept by
+   *  id, so editing or deleting one of them leaves the rest still grouped.
+   *  Absent on every row copied before this existed, which simply show flat.
+   *  Never sent to a machine — see `withoutFolding`. */
+  before: z22.object({
+    /** The flow's own sign-in, when the copy brought one. */
+    signInStepId: z22.string().optional(),
+    flows: z22.array(z22.object({
+      flowId: z22.string(),
+      name: z22.string(),
+      stepIds: z22.array(z22.string())
+    }).strict()).default([])
+  }).strict().optional()
 }).strict();
 var CASE_SCHEMA_VERSION = 1;
 var TestCaseSchema = z22.object({
@@ -1575,7 +1593,7 @@ function expandForRun(flow, lookup) {
 
 // ../engine-playwright/dist/index.js
 import { createHmac, randomBytes } from "crypto";
-import { errors } from "playwright";
+import { errors as errors2 } from "playwright";
 
 // ../core/dist/index.js
 function proposeAssertions(before, after) {
@@ -1896,7 +1914,7 @@ var STEP_PRESENTATION = {
 // ../engine-playwright/dist/index.js
 import fs4 from "fs";
 import path22 from "path";
-import { chromium, firefox, webkit } from "playwright";
+import { chromium, errors, firefox, webkit } from "playwright";
 
 // ../recorder/dist/index.js
 function openShadowRoots() {
@@ -3569,8 +3587,11 @@ var RunActors = class {
       this.sessions.set(id, session);
       await this.opts.onCreate?.(session);
     }
+    const switching = this.current !== session;
     this.current = session;
     this.currentId = id;
+    if (switching && this.opts.headless === false) await session.page.bringToFront().catch(() => {
+    });
     if (this.initialized.has(id)) return;
     if (startUrl) await session.page.goto(startUrl, { waitUntil: "domcontentloaded" });
     if (actor?.startSignedIn) {
@@ -3923,38 +3944,63 @@ function resolveCapture(options = {}) {
   };
 }
 var forcedHeadless = () => process.env["FLOWRIKI_FORCE_HEADLESS"] === "1";
+var LAUNCH_ATTEMPT_MS = () => Number(process.env["FLOWRIKI_LAUNCH_TIMEOUT_MS"] ?? 45e3);
+var isStartupFailure = (error) => error instanceof errors.TimeoutError || /Target page, context or browser has been closed|Browser has been closed|browser has disconnected/i.test(String(error?.message ?? error));
+async function launchWithRetry(launch, setUp, { attempts = 2, pauseMs = 1e3 } = {}) {
+  let last;
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    let browser = null;
+    try {
+      browser = await launch(LAUNCH_ATTEMPT_MS());
+      return { browser, value: await setUp(browser) };
+    } catch (error) {
+      last = error;
+      await browser?.close().catch(() => {
+      });
+      if (!isStartupFailure(error)) throw error;
+      if (attempt < attempts) await new Promise((r) => setTimeout(r, pauseMs));
+    }
+  }
+  const seconds = Math.round(LAUNCH_ATTEMPT_MS() / 1e3);
+  const why = String(last?.message ?? last).split("\n")[0];
+  throw new Error(
+    `the browser did not start after ${attempts} attempts of ${seconds}s each (${why}) \u2014 on a Mac this is usually a visible browser that could not open a window; run it again, or run it headless`
+  );
+}
 async function launchSession(environment = {}, headlessRequested = true, slowMo = 0, capture = {}, existingBrowser, storageState) {
   const headless = headlessRequested || forcedHeadless();
   const config = { ...DEFAULT_ENVIRONMENT, ...ExecutionEnvironmentSchema.parse(environment) };
   const fullWindow = config.fullWindow === true && !headless;
   const engine = { chromium, firefox, webkit }[config.browser];
-  const browser = existingBrowser ?? await engine.launch({
+  const launch = (timeout) => engine.launch({
     headless,
     slowMo,
+    timeout,
     // Chromium's flag. Firefox and WebKit have no equivalent, and `viewport:
     // null` still gives them a page that fills their default window — bigger
     // than the fixed box, if not maximised.
     ...fullWindow && config.browser === "chromium" ? { args: ["--start-maximized"] } : {}
   });
+  const { viewport, locale, timezoneId, colorScheme } = config;
+  const artifacts = resolveCapture(capture);
+  const makeContext = (browser2) => browser2.newContext({
+    viewport: fullWindow ? null : viewport,
+    locale,
+    timezoneId,
+    colorScheme,
+    ...storageState ? { storageState } : {},
+    // Playwright can only be told to record at context creation, so a video
+    // wanted "on failure" is recorded for every run and thrown away when the
+    // run passes. There is no way to start one after the fact.
+    //
+    // The video still needs a fixed size even when the page has none —
+    // `size` is what the file is encoded at, and Playwright scales the frame
+    // to fit it. The configured viewport is the closest thing to an intended
+    // aspect ratio we have.
+    ...artifacts.video !== "off" && capture.dir ? { recordVideo: { dir: capture.dir, size: viewport } } : {}
+  });
+  const { browser, value: context } = existingBrowser ? { browser: existingBrowser, value: await makeContext(existingBrowser) } : await launchWithRetry(launch, makeContext);
   try {
-    const { viewport, locale, timezoneId, colorScheme } = config;
-    const artifacts = resolveCapture(capture);
-    const context = await browser.newContext({
-      viewport: fullWindow ? null : viewport,
-      locale,
-      timezoneId,
-      colorScheme,
-      ...storageState ? { storageState } : {},
-      // Playwright can only be told to record at context creation, so a video
-      // wanted "on failure" is recorded for every run and thrown away when the
-      // run passes. There is no way to start one after the fact.
-      //
-      // The video still needs a fixed size even when the page has none —
-      // `size` is what the file is encoded at, and Playwright scales the frame
-      // to fit it. The configured viewport is the closest thing to an intended
-      // aspect ratio we have.
-      ...artifacts.video !== "off" && capture.dir ? { recordVideo: { dir: capture.dir, size: viewport } } : {}
-    });
     if (artifacts.trace !== "off" && capture.dir) {
       await context.tracing.start({ screenshots: true, snapshots: true, sources: false });
     }
@@ -4839,7 +4885,7 @@ async function runStepsIn(session, steps, opts) {
         }
       } catch (err) {
         result.status = "failed";
-        result.failureKind = err.kind ?? (/strict mode violation/.test(String(err)) ? "ambiguous" : err instanceof errors.TimeoutError ? "timeout" : "unknown");
+        result.failureKind = err.kind ?? (/strict mode violation/.test(String(err)) ? "ambiguous" : err instanceof errors2.TimeoutError ? "timeout" : "unknown");
         result.detail = firstLine2(err);
       }
       const wantsShot = artifacts.screenshot === "always" || artifacts.screenshot === "on-failure" && result.status === "failed";

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-EBT7VSPY.js";
+} from "./chunk-IH7KFCV4.js";
 
 // src/cli.ts
 import { parseArgs } from "util";

package/dist/engine.js

@@ -9,7 +9,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-EBT7VSPY.js";
+} from "./chunk-IH7KFCV4.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowriki/agent",
-  "version": "0.1.0-beta.24",
+  "version": "0.1.0-beta.26",
   "description": "Run Flowriki UI tests on your own computer. Connects this machine to your Flowriki account.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",