@flowriki/agent 0.1.0-beta.52 → 0.1.0-beta.55

package/dist/{chunk-KDW65RBE.js → chunk-3XKTIMRP.js}

@@ -14,7 +14,9 @@ import { spawn as spawn2 } from "child_process";
 import fs3 from "fs";
 import os3 from "os";
 import path3 from "path";
+import { execFile as execFile2 } from "child_process";
 import fs4 from "fs";
+import os4 from "os";
 import path4 from "path";
 
 // ../test-model/dist/chunk-I5COYCQ5.js
@@ -2568,6 +2570,10 @@ async function localCapabilities(target, udid, opts = {}) {
       "appium:appPackage": app.id,
       ...app.activity ? { "appium:appActivity": app.activity } : {},
       "appium:appWaitActivity": "*",
+      // Its own ports: two phones on one Appium each need their own driver
+      // server and picture stream, or the second session steals the first's.
+      ...opts.ports?.system ? { "appium:systemPort": opts.ports.system } : {},
+      ...opts.ports?.mjpeg ? { "appium:mjpegServerPort": opts.ports.mjpeg } : {},
       "appium:autoGrantPermissions": false,
       "appium:disableWindowAnimation": true,
       "appium:uiautomator2ServerLaunchTimeout": 12e4,
@@ -2584,6 +2590,8 @@ async function localCapabilities(target, udid, opts = {}) {
     "appium:bundleId": app.id,
     "appium:wdaLaunchTimeout": 24e4,
     "appium:wdaConnectionTimeout": 24e4,
+    ...opts.ports?.wda ? { "appium:wdaLocalPort": opts.ports.wda } : {},
+    ...opts.ports?.mjpeg ? { "appium:mjpegServerPort": opts.ports.mjpeg } : {},
     ...target.mobile.ios?.teamId ? { "appium:xcodeOrgId": target.mobile.ios.teamId, "appium:xcodeSigningId": "Apple Development" } : {}
   };
 }
@@ -2641,7 +2649,7 @@ async function cloudDevices(account, key) {
     if (!res.ok) throw new Error(`${account.provider} answered ${res.status}.`);
     return res.json();
   };
-  const platformOf = (os4) => /android/i.test(os4) ? "android" : /ios/i.test(os4) ? "ios" : null;
+  const platformOf = (os5) => /android/i.test(os5) ? "android" : /ios/i.test(os5) ? "ios" : null;
   const out = [];
   if (account.provider === "browserstack") {
     for (const d of await get("https://api-cloud.browserstack.com/app-automate/devices.json")) {
@@ -2655,11 +2663,11 @@ async function cloudDevices(account, key) {
       if (p) out.push({ name: d.name, platform: p, osVersion: d.osVersion });
     }
   } else {
-    for (const os4 of ["android", "ios"]) {
-      const listed = await get(`https://mobile-api.lambdatest.com/mobile-automation/api/v1/list?region=us&os=${os4}`);
+    for (const os5 of ["android", "ios"]) {
+      const listed = await get(`https://mobile-api.lambdatest.com/mobile-automation/api/v1/list?region=us&os=${os5}`);
       for (const [, devices] of Object.entries(listed)) {
         if (!Array.isArray(devices)) continue;
-        for (const d of devices) out.push({ name: d.deviceName, platform: os4, osVersion: d.platformVersion });
+        for (const d of devices) out.push({ name: d.deviceName, platform: os5, osVersion: d.platformVersion });
       }
     }
   }
@@ -3203,6 +3211,8 @@ async function checkMobileAssertion(session, a, timeoutMs = 3e3) {
   throw last;
 }
 var uploaded = /* @__PURE__ */ new Map();
+var OPEN = /* @__PURE__ */ new Map();
+var openSessionOn = (platform) => OPEN.get(platform) ?? null;
 var MobileSession = class _MobileSession {
   constructor(driver, platform, appId, deviceName, cloud) {
     this.driver = driver;
@@ -3243,6 +3253,7 @@ var MobileSession = class _MobileSession {
         throw new Error(`${CLOUD_PROVIDER_NAME[choice2.provider]} could not open ${choice2.device}: ${e.message}`);
       });
       const cloudSession = new _MobileSession(driver2, target.platform, app.id, choice2.device, true);
+      OPEN.set(target.platform, cloudSession);
       await cloudSession.settle(2e4);
       return cloudSession;
     }
@@ -3256,12 +3267,14 @@ var MobileSession = class _MobileSession {
     const endpoint = await appiumServer();
     const buildFile = app.build ? await localBuild(app.build) : null;
     say(`Opening the app on ${known.name}\u2026`);
-    const capabilities = await localCapabilities(target, udid, { buildFile });
+    const ports = target.platform === "android" ? { system: await freePort(), mjpeg: await freePort() } : { wda: await freePort(), mjpeg: await freePort() };
+    const capabilities = await localCapabilities(target, udid, { buildFile, ports });
     const driver = await WebDriverSession.create(endpoint, capabilities).catch((e) => {
       const tail = appiumLog().filter((l) => /error/i.test(l)).slice(-2).join(" ");
       throw new Error(explainStartFailure(e.message, target.platform) + (tail ? ` (${tail.slice(0, 300)})` : ""));
     });
     const session = new _MobileSession(driver, target.platform, app.id, known.name, false);
+    OPEN.set(target.platform, session);
     await session.terminateApp().catch(() => {
     });
     await session.launchApp().catch(() => {
@@ -3302,6 +3315,16 @@ var MobileSession = class _MobileSession {
     }
     return png;
   }
+  /** The screen as a picture to LOOK at — the recorder's mirror, the run
+   *  page's live phone — at most `maxPx` on its longer side. A phone's own
+   *  resolution is three to four times what a mirror draws, and every byte
+   *  of it crosses the control channel each time; on macOS `sips` shrinks it
+   *  in a few milliseconds, elsewhere the full picture is sent. Evidence
+   *  files keep the full size. */
+  async preview(maxPx = 900) {
+    const png = await this.screenshot();
+    return shrink(png, maxPx);
+  }
   /** Android: the activity on screen. iOS has none worth reading. */
   async currentScreenName() {
     if (this.platform !== "android") return "";
@@ -3494,10 +3517,27 @@ var MobileSession = class _MobileSession {
     return { relPath: path4.basename(file), bytes: bytes.length };
   }
   async close() {
+    if (OPEN.get(this.platform) === this) OPEN.delete(this.platform);
     if (this.recording) await this.stopVideo(null);
     await this.driver.close();
   }
 };
+async function shrink(png, maxPx) {
+  if (process.platform !== "darwin") return png;
+  const dir = fs4.mkdtempSync(path4.join(os4.tmpdir(), "flowriki-shot-"));
+  const file = path4.join(dir, "s.png");
+  try {
+    fs4.writeFileSync(file, png);
+    await new Promise((resolve, reject) => {
+      execFile2("/usr/bin/sips", ["-Z", String(maxPx), file], { timeout: 5e3 }, (error) => error ? reject(error) : resolve());
+    });
+    return fs4.readFileSync(file);
+  } catch {
+    return png;
+  } finally {
+    fs4.rmSync(dir, { recursive: true, force: true });
+  }
+}
 var ANDROID_KEYS = {
   enter: 66,
   return: 66,
@@ -4152,7 +4192,9 @@ export {
   CheckError,
   textOf,
   checkMobileAssertion,
+  openSessionOn,
   MobileSession,
+  shrink,
   MOBILE_TIMEOUTS,
   performMobileStep,
   runMobileSteps,

package/dist/{chunk-Z3SL46OX.js → chunk-NWJWMDVO.js}

@@ -47,6 +47,7 @@ import {
   nodeAt,
   normalizeStartUrl,
   openMobileSession,
+  openSessionOn,
   parseFlowDocument,
   performMobileStep,
   platformsOf,
@@ -67,7 +68,7 @@ import {
   textIndependent,
   validateActors,
   webCloudOf
-} from "./chunk-KDW65RBE.js";
+} from "./chunk-3XKTIMRP.js";
 
 // src/engine/machine.ts
 import fs from "fs";
@@ -75,7 +76,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.52";
+var AGENT_VERSION = "0.1.0-beta.55";
 async function prepareBrowsers() {
   if (browsersReady()) {
     return { ok: true, already: true, message: "chromium is already installed" };
@@ -135,7 +136,7 @@ async function checkMachine() {
     }
   } catch {
   }
-  const { mobileDoctor: mobileDoctor2 } = await import("./dist-R2I4D66B.js");
+  const { mobileDoctor: mobileDoctor2 } = await import("./dist-RTDFWPOC.js");
   return {
     agentVersion: AGENT_VERSION,
     node: process.versions.node,
@@ -234,7 +235,7 @@ function forgetConnection(service, env = process.env) {
 }
 var fingerprint = (secret2) => crypto2.createHash("sha256").update(secret2).digest("hex").slice(0, 12);
 
-// ../contracts/dist/chunk-S3GLB3QV.js
+// ../contracts/dist/chunk-NTBXG5EZ.js
 import { z } from "zod";
 var PROTOCOL_VERSION = 1;
 var PAIRING_CODE_TTL_MS = 5 * 60 * 1e3;
@@ -283,6 +284,9 @@ var CommandNameSchema = z.enum([
   // Reading a live phone session: its screen as a picture, and what is under
   // a point. Not effectful — a picture is far too big to keep as a result.
   "mobile.screen",
+  // The screen of whatever phone session is open on a platform — a run's,
+  // a recording's — as a picture, for the live mirror. Reading.
+  "mobile.peek",
   // What this computer has installed for web and phone testing. Reading.
   "machine.check"
 ]);
@@ -3962,7 +3966,7 @@ async function replayCase(opts) {
   let status2 = "passed";
   let error = null;
   const browserRows = occurrences.filter((o) => o.platform !== "android" && o.platform !== "ios");
-  const laneOf = new Map(sessionLanes(browserRows, opts.defaultActorId).map((plan, i) => [browserRows[i].occurrenceId, plan]));
+  const laneOf2 = new Map(sessionLanes(browserRows, opts.defaultActorId).map((plan, i) => [browserRows[i].occurrenceId, plan]));
   try {
     for (const [index, occurrence] of occurrences.entries()) {
       if (status2 !== "passed" || opts.signal?.aborted) {
@@ -4014,7 +4018,7 @@ async function replayCase(opts) {
       const navigates = navigatesFirst(occurrence);
       const who = occurrence.actorId ?? opts.defaultActorId ?? "default";
       const entry = resolveStartUrl(occurrence.baseUrl ?? baseUrl, occurrence.startPath ?? "/");
-      const plan = laneOf.get(occurrence.occurrenceId);
+      const plan = laneOf2.get(occurrence.occurrenceId);
       try {
         if (plan.opens && startOf(occurrence) === "fresh") await actors.restart(who, entry);
         else if (plan.opens) await actors.select(who, entry);
@@ -7990,6 +7994,105 @@ var BrowserBusy = class extends Error {
     this.name = "BrowserBusy";
   }
 };
+var LANES = ["web", "android", "ios"];
+var OneLane = class {
+  owner = null;
+  phase = "idle";
+  since = null;
+  /** Take the lane, or report who has it. Never awaits — that is the point. */
+  acquire(owner) {
+    if (this.owner !== null) {
+      return { ok: false, heldBy: this.owner, phase: this.phase };
+    }
+    this.owner = owner;
+    this.phase = "starting";
+    this.since = Date.now();
+    return { ok: true };
+  }
+  /** The holder finished starting and is now doing the thing. */
+  activate(owner) {
+    if (this.owner === owner) this.phase = "active";
+  }
+  /** The holder has begun shutting down. Still not idle: a second stop must
+   *  join the first rather than starting its own. */
+  beginRelease(owner) {
+    if (this.owner !== owner || this.phase === "stopping") return false;
+    this.phase = "stopping";
+    return true;
+  }
+  release(owner) {
+    if (this.owner !== owner) return;
+    this.owner = null;
+    this.phase = "idle";
+    this.since = null;
+  }
+  forceRelease() {
+    this.owner = null;
+    this.phase = "idle";
+    this.since = null;
+  }
+  state() {
+    return { owner: this.owner, phase: this.phase, since: this.since };
+  }
+};
+var BrowserLease = class {
+  lanes = { web: new OneLane(), android: new OneLane(), ios: new OneLane() };
+  /** The web lane's methods, as they always were: the browser coordinators
+   *  drive one platform and need not know about lanes. */
+  acquire(owner, lane = "web") {
+    return this.lanes[lane].acquire(owner);
+  }
+  activate(owner, lane = "web") {
+    this.lanes[lane].activate(owner);
+  }
+  beginRelease(owner, lane = "web") {
+    return this.lanes[lane].beginRelease(owner);
+  }
+  release(owner, lane = "web") {
+    this.lanes[lane].release(owner);
+  }
+  state(lane = "web") {
+    return this.lanes[lane].state();
+  }
+  /** One lane, bound: what a coordinator for that platform is handed. */
+  lane(lane) {
+    return this.lanes[lane];
+  }
+  /** Take several lanes at once — all or none, so a job on two platforms
+   *  never holds one while refused the other. */
+  acquireAll(owner, lanes) {
+    const taken = [];
+    for (const lane of new Set(lanes)) {
+      const claim = this.lanes[lane].acquire(owner);
+      if (!claim.ok) {
+        for (const had of taken) this.lanes[had].release(owner);
+        return { ok: false, lane, heldBy: claim.heldBy, phase: claim.phase };
+      }
+      taken.push(lane);
+    }
+    return { ok: true };
+  }
+  activateAll(owner, lanes) {
+    for (const lane of new Set(lanes)) this.lanes[lane].activate(owner);
+  }
+  releaseAll(owner, lanes) {
+    for (const lane of new Set(lanes)) this.lanes[lane].release(owner);
+  }
+  /** Drop every lane whoever holds it — shutdown, and nothing else. */
+  forceRelease() {
+    for (const lane of LANES) this.lanes[lane].forceRelease();
+  }
+  /** The sentence a refused caller is shown. Names what is happening and on
+   *  what, because "busy" leaves someone hunting for a window they cannot find. */
+  static refusal(heldBy, phase, lane = "web") {
+    const what = heldBy === "recording" ? "a recording" : heldBy === "debug" ? "a debug session" : "a run";
+    const where = lane === "web" ? "the browser" : lane === "android" ? "the Android phone" : "the iPhone";
+    if (phase === "starting") return `${what} is starting on ${where} \u2014 wait for it to open, or stop it first`;
+    if (phase === "stopping") return `${what} is still closing on ${where} \u2014 try again in a moment`;
+    return `${what} is already using ${where} \u2014 stop it before starting another`;
+  }
+};
+var laneOf = (platform) => platform === "android" || platform === "ios" ? platform : "web";
 var COMMANDS = /* @__PURE__ */ new Set([
   "play",
   "pause",
@@ -8166,11 +8269,12 @@ async function verifyFlowSteps(deps, opts) {
   const steps = (opts.steps ?? flow.steps).map((s2) => DraftStepSchema.parse(s2));
   if (!opts.verifyIds.length) return { results: [], error: null, failedAtStepId: null, ok: true };
   const baseUrl = store.baseUrlFor(flow);
-  const claim = deps.lease?.acquire("run");
+  const lane = laneOf(flow.platform);
+  const claim = deps.lease?.acquire("run", lane);
   if (claim && !claim.ok) {
-    throw new BrowserBusy(`the browser on this machine is in use (${claim.heldBy}, ${claim.phase})`);
+    throw new BrowserBusy(`${lane === "web" ? "the browser" : lane === "android" ? "the Android phone" : "the iPhone"} on this machine is in use (${claim.heldBy}, ${claim.phase})`);
   }
-  deps.lease?.activate("run");
+  deps.lease?.activate("run", lane);
   try {
     const secrets = store.readSecrets();
     if (isMobile(flow.platform)) {
@@ -8215,7 +8319,7 @@ async function verifyFlowSteps(deps, opts) {
       resolveSecret: (ref) => secrets[ref]
     });
   } finally {
-    deps.lease?.release("run");
+    deps.lease?.release("run", lane);
   }
 }
 function deliveredRun(delivered) {
@@ -8235,55 +8339,6 @@ function deliveredRun(delivered) {
     resolveFile: () => void 0
   };
 }
-var BrowserLease = class {
-  owner = null;
-  phase = "idle";
-  since = null;
-  /** Take the lease, or report who has it. Never awaits — that is the point. */
-  acquire(owner) {
-    if (this.owner !== null) {
-      return { ok: false, heldBy: this.owner, phase: this.phase };
-    }
-    this.owner = owner;
-    this.phase = "starting";
-    this.since = Date.now();
-    return { ok: true };
-  }
-  /** The holder finished starting and is now doing the thing. */
-  activate(owner) {
-    if (this.owner === owner) this.phase = "active";
-  }
-  /** The holder has begun shutting down. Still not idle: a second stop must
-   *  join the first rather than starting its own. */
-  beginRelease(owner) {
-    if (this.owner !== owner || this.phase === "stopping") return false;
-    this.phase = "stopping";
-    return true;
-  }
-  release(owner) {
-    if (this.owner !== owner) return;
-    this.owner = null;
-    this.phase = "idle";
-    this.since = null;
-  }
-  /** Drop the lease whoever holds it — shutdown, and nothing else. */
-  forceRelease() {
-    this.owner = null;
-    this.phase = "idle";
-    this.since = null;
-  }
-  state() {
-    return { owner: this.owner, phase: this.phase, since: this.since };
-  }
-  /** The sentence a refused caller is shown. Names what is happening, because
-   *  "busy" leaves someone hunting for a window they cannot find. */
-  static refusal(heldBy, phase) {
-    const what = heldBy === "recording" ? "a recording" : heldBy === "debug" ? "a debug session" : "a run";
-    if (phase === "starting") return `${what} is starting \u2014 wait for it to open, or stop it first`;
-    if (phase === "stopping") return `${what} is still closing \u2014 try again in a moment`;
-    return `${what} is already using the browser \u2014 stop it before starting another`;
-  }
-};
 
 // src/engine/checkouts.ts
 function resolveCheckouts(dirs) {
@@ -9240,11 +9295,12 @@ function executionHandlers(ctx) {
           detail: `this flow needs ${missing.length} secret value(s) that are not on this machine (${missing.map((m) => m.ref || m.field).join(", ")}) \u2014 set them on the machine that runs it`
         };
       }
-      const claim = lease?.acquire("run");
+      const lanes = [laneOf(flow.platform)];
+      const claim = lease?.acquireAll("run", lanes);
       if (claim && !claim.ok) {
-        return { ok: false, reason: "busy", detail: `the browser on this machine is in use (${claim.heldBy})` };
+        return { ok: false, reason: "busy", detail: BrowserLease.refusal(claim.heldBy, claim.phase, claim.lane) };
       }
-      lease?.activate("run");
+      lease?.activateAll("run", lanes);
       onActivity?.({ kind: "run", projectId: project.id, detail: flow.name });
       const aborter = new AbortController();
       cancels.set(command.id, { projectId: project.id, cancel: () => aborter.abort() });
@@ -9279,6 +9335,8 @@ function executionHandlers(ctx) {
           ok: true,
           result: {
             runId: outcome.run?.id ?? null,
+            // What it was called, for a service that only knew its id.
+            flowName: flow.name,
             // The WHOLE outcome, not a summary of it. A dashboard renders the
             // per-step report exactly as the local app does, and a result
             // carrying only counts makes that screen crash rather than degrade.
@@ -9294,7 +9352,7 @@ function executionHandlers(ctx) {
         if (typeof cancelKey === "string" && cancelKey.startsWith("suite:")) cancels.delete(cancelKey);
         if (runId) cancels.delete(runId);
         onActivity?.(null);
-        lease?.release("run");
+        lease?.releaseAll("run", lanes);
       }
     },
     /** Run a test case: several flows, one browser, in order.
@@ -9312,11 +9370,12 @@ function executionHandlers(ctx) {
       if (testCase.occurrences.length === 0) {
         return { ok: false, reason: "failed", detail: `"${testCase.name}" has no flows in it to run` };
       }
-      const claim = lease?.acquire("run");
+      const lanes = [...new Set(testCase.occurrences.map((o) => laneOf(o.platform)))];
+      const claim = lease?.acquireAll("run", lanes);
       if (claim && !claim.ok) {
-        return { ok: false, reason: "busy", detail: `the browser on this machine is in use (${claim.heldBy})` };
+        return { ok: false, reason: "busy", detail: BrowserLease.refusal(claim.heldBy, claim.phase, claim.lane) };
       }
-      lease?.activate("run");
+      lease?.activateAll("run", lanes);
       onActivity?.({ kind: "run", projectId: project.id, detail: testCase.name });
       const aborter = new AbortController();
       cancels.set(command.id, { projectId: project.id, cancel: () => aborter.abort() });
@@ -9355,6 +9414,8 @@ function executionHandlers(ctx) {
           ok: true,
           result: {
             runId: run?.id ?? null,
+            // What it was called, for a service that only knew its id.
+            caseName: testCase.name,
             // The whole outcome, per-flow groups included: a dashboard renders
             // the report from this, and a result carrying only counts makes
             // that screen crash rather than degrade.
@@ -9366,7 +9427,7 @@ function executionHandlers(ctx) {
         if (typeof cancelKey === "string" && cancelKey.startsWith("suite:")) cancels.delete(cancelKey);
         if (runId) cancels.delete(runId);
         onActivity?.(null);
-        lease?.release("run");
+        lease?.releaseAll("run", lanes);
       }
     },
     "run.cancel": async (command, project) => {
@@ -9779,12 +9840,17 @@ var runFile = (file2, args, timeoutMs) => new Promise((resolve2, reject) => {
     resolve2({ code, stdout: String(stdout), stderr: String(stderr) });
   });
 });
-var live = null;
+var live = /* @__PURE__ */ new Map();
+var liveById = (sessionId) => [...live.values()].find((l) => l.id === sessionId);
+var ownerOf = (l) => l.draft ? "recording" : "debug";
 var SECRET_WORDS = /password|passwd|pass[-_\s]?code|pwd|secret|otp|\bpin\b|cvv|cvc/i;
 async function screenOf(l, withImage = false) {
   l.session.changed();
-  const screen = await l.session.screen();
-  const png = withImage ? await l.session.screenshot() : null;
+  const [screen, png, where] = await Promise.all([
+    l.session.screen(),
+    withImage ? l.session.preview() : Promise.resolve(null),
+    l.session.currentScreenName()
+  ]);
   return {
     ...png ? { image: png.toString("base64") } : {},
     width: screen.size.width,
@@ -9799,14 +9865,15 @@ async function screenOf(l, withImage = false) {
       ...n2.value ? { value: n2.password ? "\u2022\u2022\u2022" : n2.value } : {},
       ...n2.id ? { id: n2.id } : {}
     })),
-    where: await l.session.currentScreenName(),
+    where,
     device: l.session.deviceName
   };
 }
 function mobileHandlers(ctx) {
   const require2 = (command) => {
-    if (!live || command.args["sessionId"] !== live.id) throw new Error("that phone session has ended \u2014 open it again");
-    return live;
+    const l = liveById(command.args["sessionId"]);
+    if (!l) throw new Error("that phone session has ended \u2014 open it again");
+    return l;
   };
   return {
     // Everything this computer has for testing — web and phones — for the Guide.
@@ -9817,6 +9884,21 @@ function mobileHandlers(ctx) {
       const devices = await listDevices();
       return { ok: true, result: { devices, ...command.args["doctor"] === true ? { doctor: await mobileDoctor() } : {} } };
     },
+    // THE PHONE A RUN IS DRIVING, as a picture: whatever session is open on
+    // that platform — a run's, a recording's. Not effectful, never kept, and
+    // nothing when no phone is open: the mirror then shows that.
+    "mobile.peek": async (command) => {
+      const platform = command.args["platform"];
+      if (!isMobile(platform)) return { ok: false, reason: "failed", detail: "say which phone: android or ios" };
+      const session = live.get(platform)?.session ?? openSessionOn(platform);
+      if (!session) return { ok: true, result: { image: null } };
+      try {
+        const png = await session.preview(720);
+        return { ok: true, result: { image: png.toString("base64"), device: session.deviceName } };
+      } catch {
+        return { ok: true, result: { image: null } };
+      }
+    },
     "mobile.screen": async (command) => {
       try {
         const l = require2(command);
@@ -9833,14 +9915,21 @@ function mobileHandlers(ctx) {
     },
     "mobile.session": async (command, project) => {
       const op = String(command.args["op"] ?? "");
+      let claimed = null;
       try {
         if (op === "start") {
-          if (live) {
-            await live.session.close().catch(() => void 0);
-            live = null;
-          }
           const platform = command.args["platform"];
           if (!isMobile(platform)) return { ok: false, reason: "failed", detail: "say which phone: android or ios" };
+          const prior = live.get(platform);
+          if (prior) {
+            live.delete(prior.platform);
+            await prior.session.close().catch(() => void 0);
+            ctx.lease?.release(ownerOf(prior), prior.platform);
+          }
+          const owner = command.args["record"] === true ? "recording" : "debug";
+          const claim = ctx.lease?.acquire(owner, platform);
+          if (claim && !claim.ok) return { ok: false, reason: "busy", detail: BrowserLease.refusal(claim.heldBy, claim.phase, platform) };
+          claimed = { owner, platform };
           const config = command.args["config"] ?? {};
           const secrets = command.args["secrets"] ?? {};
           const device = command.args["device"] ? DeviceChoiceSchema.parse(command.args["device"]) : void 0;
@@ -9875,7 +9964,8 @@ function mobileHandlers(ctx) {
               ...auth?.profileId ? { signIn: auth } : {}
             };
           }
-          live = l2;
+          live.set(l2.platform, l2);
+          ctx.lease?.activate(owner, l2.platform);
           if (/^[a-z][\w+.-]*:\/\//i.test(startPath)) await session.openLink(startPath);
           const opening = [
             ...l2.draft?.signIn ? [RecordedStepSchema.parse({ id: "sign-in", type: "signIn", auth: l2.draft.signIn, role: "", name: "Sign in", scope: "", value: "", secret: false, legacySelector: "", proposals: [] })] : [],
@@ -9916,18 +10006,18 @@ function mobileHandlers(ctx) {
             if (op === "run" || step.type === "signIn" || step.type === "assert") {
               const done = await runMobileSteps(l.session, [step], { values: l.values, resolveSecret: l.resolveSecret, resolveAuth: l.resolveAuth, ...l.runHelper ? { runHelper: l.runHelper } : {} });
               const result = done.results[0];
-              if (op === "run") return { ok: true, result: { result: result ?? null, screen: await screenOf(l) } };
+              if (op === "run") return { ok: true, result: { result: result ?? null } };
               if (done.status !== "passed") throw new Error(result?.detail ?? done.error ?? "it did not work");
             } else {
               await performMobileStep(l.session, step, { values: l.values, resolveSecret: l.resolveSecret, resolveAuth: l.resolveAuth, ...l.runHelper ? { runHelper: l.runHelper } : {} });
             }
           } catch (error) {
             if (secret2) l.typed.delete(ref);
-            return { ok: true, result: { kept: false, error: error.message.split("\n")[0], screen: await screenOf(l) } };
+            return { ok: true, result: { kept: false, error: error.message.split("\n")[0] } };
           }
-          await new Promise((r) => setTimeout(r, 500));
+          await new Promise((r) => setTimeout(r, 300));
           l.draft?.steps.push(step);
-          return { ok: true, result: { kept: true, step, durationMs: Date.now() - t0, steps: l.draft?.steps ?? [], screen: await screenOf(l) } };
+          return { ok: true, result: { kept: true, step, durationMs: Date.now() - t0, steps: l.draft?.steps ?? [] } };
         }
         if (op === "check") {
           const assertion = RecordedStepSchema.shape.proposals.element.parse({ enabled: true, ...command.args["assertion"] });
@@ -9958,7 +10048,8 @@ function mobileHandlers(ctx) {
           return { ok: true, result: { steps: l.draft.steps } };
         }
         if (op === "stop" || op === "discard") {
-          live = null;
+          live.delete(l.platform);
+          ctx.lease?.release(ownerOf(l), l.platform);
           await l.session.close().catch(() => void 0);
           if (op === "discard" || !l.draft) return { ok: true, result: { ended: true } };
           const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -9982,6 +10073,7 @@ function mobileHandlers(ctx) {
         }
         return { ok: false, reason: "failed", detail: `unknown phone session operation "${op}"` };
       } catch (error) {
+        if (claimed && !live.has(claimed.platform)) ctx.lease?.release(claimed.owner, claimed.platform);
         return { ok: false, reason: "failed", detail: error.message.split("\n")[0] ?? "the phone session failed" };
       }
     }
@@ -10247,75 +10339,15 @@ function createClaudeCli(options) {
     ask(ask) {
       if (current) return { started: false, detail: "The assistant is already answering a question on this machine." };
       fs43.mkdirSync(scratchRoot2, { recursive: true, mode: 448 });
-      const dir = fs43.mkdtempSync(path42.join(scratchRoot2, "ask-"));
+      const dir = path42.join(scratchRoot2, `project-${ask.projectId.replace(/[^A-Za-z0-9_-]/g, "_")}`);
+      fs43.mkdirSync(dir, { recursive: true, mode: 448 });
       const mcpConfigPath = path42.join(dir, "mcp.json");
       fs43.writeFileSync(
         mcpConfigPath,
         JSON.stringify({ mcpServers: { [MCP_SERVER_NAME]: { command: options.mcp.command, args: options.mcp.args } } }),
         { mode: 384 }
       );
-      let child;
-      try {
-        child = spawn2(
-          binary,
-          buildAskArgs({
-            prompt: ask.prompt,
-            mcpConfigPath,
-            projectId: ask.projectId,
-            projectName: ask.projectName,
-            ...ask.sessionId ? { sessionId: ask.sessionId } : {},
-            ...ask.folders?.length ? { folders: ask.folders } : {},
-            ...ask.mode ? { mode: ask.mode } : {}
-          }),
-          // THE SCRATCH FOLDER, not the project: nothing here to read or write.
-          { cwd: dir, stdio: ["ignore", "pipe", "pipe"] }
-        );
-      } catch {
-        fs43.rmSync(dir, { recursive: true, force: true });
-        return { started: false, detail: "The assistant\u2019s command-line tool could not be started." };
-      }
-      current = { askId: ask.askId, child };
-      let buffer = "", stderr = "", sawDone = false, ended = false;
-      const handleLine = (line) => {
-        for (const event of eventsFromLine(ask.askId, line)) {
-          if (event.name === "assistant.done") sawDone = true;
-          ask.emit(event.name, event.data);
-        }
-      };
-      const end = (ok, detail) => {
-        if (ended) return;
-        ended = true;
-        clearTimeout(timer);
-        if (buffer.trim()) handleLine(buffer);
-        if (!sawDone) ask.emit("assistant.done", { askId: ask.askId, ok, result: detail });
-        current = null;
-        fs43.rmSync(dir, { recursive: true, force: true });
-      };
-      const timer = setTimeout(() => {
-        child.kill("SIGTERM");
-        end(false, `Stopped after ${Math.max(1, Math.round(maxAskMs / 6e4))} minutes. Whatever it saved so far is on the Branches page \u2014 send \u201Ccontinue\u201D to carry on.`);
-      }, maxAskMs);
-      timer.unref?.();
-      child.stdout?.on("data", (chunk) => {
-        buffer += chunk.toString();
-        let at;
-        while ((at = buffer.indexOf("\n")) >= 0) {
-          handleLine(buffer.slice(0, at));
-          buffer = buffer.slice(at + 1);
-        }
-      });
-      child.stderr?.on("data", (chunk) => {
-        stderr = (stderr + chunk.toString()).slice(-2e3);
-      });
-      child.on("error", () => end(false, "The assistant\u2019s command-line tool could not be started."));
-      child.on(
-        "close",
-        (code) => end(
-          code === 0,
-          cancelled === ask.askId ? "Stopped." : code === 0 ? "" : stderr.trim().split("\n").slice(-3).join(" ") || `The assistant stopped (exit ${code ?? "?"}).`
-        )
-      );
-      return { started: true };
+      return launch(ask, dir, mcpConfigPath, ask.sessionId);
     },
     cancel(askId) {
       if (!current || current.askId !== askId) return false;
@@ -10325,8 +10357,85 @@ function createClaudeCli(options) {
       setTimeout(() => child.kill("SIGKILL"), 3e3).unref?.();
       return true;
     },
-    busy: () => current !== null
+    busy() {
+      return current !== null;
+    }
   };
+  function launch(ask, dir, mcpConfigPath, sessionId) {
+    let child;
+    try {
+      child = spawn2(
+        binary,
+        buildAskArgs({
+          prompt: ask.prompt,
+          mcpConfigPath,
+          projectId: ask.projectId,
+          projectName: ask.projectName,
+          ...sessionId ? { sessionId } : {},
+          ...ask.folders?.length ? { folders: ask.folders } : {},
+          ...ask.mode ? { mode: ask.mode } : {},
+          ...ask.brief ? { brief: ask.brief } : {}
+        }),
+        // THE SCRATCH FOLDER, not the project: nothing here to read or write.
+        { cwd: dir, stdio: ["ignore", "pipe", "pipe"] }
+      );
+    } catch {
+      return { started: false, detail: "The assistant\u2019s command-line tool could not be started." };
+    }
+    current = { askId: ask.askId, child };
+    let buffer = "", stderr = "", sawDone = false, ended = false;
+    let silentFailure = false;
+    const handleLine = (line) => {
+      for (const event of eventsFromLine(ask.askId, line)) {
+        if (event.name === "assistant.done" && event.data["ok"] === false && !String(event.data["result"] ?? "").trim()) {
+          silentFailure = true;
+          continue;
+        }
+        if (event.name === "assistant.done") sawDone = true;
+        ask.emit(event.name, event.data);
+      }
+    };
+    const end = (ok, detail) => {
+      if (ended) return;
+      ended = true;
+      clearTimeout(timer);
+      if (buffer.trim()) handleLine(buffer);
+      current = null;
+      if (silentFailure && sessionId && /no conversation found/i.test(stderr) && cancelled !== ask.askId) {
+        const again = launch(ask, dir, mcpConfigPath, void 0);
+        if (again.started) return;
+      }
+      if (!sawDone) {
+        const why = detail || stderr.trim().split("\n").filter((l) => l && !/^Warning:/.test(l)).slice(-3).join(" ") || "The assistant stopped without saying why.";
+        ask.emit("assistant.done", { askId: ask.askId, ok: ok && !silentFailure, result: ok && !silentFailure ? "" : why });
+      }
+    };
+    const timer = setTimeout(() => {
+      child.kill("SIGTERM");
+      end(false, `Stopped after ${Math.max(1, Math.round(maxAskMs / 6e4))} minutes. Whatever it saved so far is on the Branches page \u2014 send \u201Ccontinue\u201D to carry on.`);
+    }, maxAskMs);
+    timer.unref?.();
+    child.stdout?.on("data", (chunk) => {
+      buffer += chunk.toString();
+      let at;
+      while ((at = buffer.indexOf("\n")) >= 0) {
+        handleLine(buffer.slice(0, at));
+        buffer = buffer.slice(at + 1);
+      }
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderr = (stderr + chunk.toString()).slice(-2e3);
+    });
+    child.on("error", () => end(false, "The assistant\u2019s command-line tool could not be started."));
+    child.on(
+      "close",
+      (code) => end(
+        code === 0,
+        cancelled === ask.askId ? "Stopped." : code === 0 ? "" : stderr.trim().split("\n").filter((l) => l && !/^Warning:/.test(l)).slice(-3).join(" ") || `The assistant stopped (exit ${code ?? "?"}).`
+      )
+    );
+    return { started: true };
+  }
 }
 function createAgentRuntime(options) {
   const lease = new BrowserLease();

package/dist/cli.js

@@ -23,7 +23,7 @@ import {
   runtimeValue,
   start,
   status
-} from "./chunk-Z3SL46OX.js";
+} from "./chunk-NWJWMDVO.js";
 import {
   CLOUD_PROVIDERS,
   CLOUD_PROVIDER_NAME,
@@ -49,7 +49,7 @@ import {
   screenLines,
   stepRefusedOn,
   targetFor
-} from "./chunk-KDW65RBE.js";
+} from "./chunk-3XKTIMRP.js";
 
 // src/cli.ts
 import { parseArgs } from "util";

package/dist/{dist-R2I4D66B.js → dist-RTDFWPOC.js}

@@ -31,6 +31,7 @@ import {
   mobileSetup,
   nodeAt,
   openMobileSession,
+  openSessionOn,
   performMobileStep,
   readScreen,
   replayMobileCase,
@@ -39,12 +40,13 @@ import {
   run,
   runMobileSteps,
   screenLines,
+  shrink,
   stopAppium,
   targetFor,
   textOf,
   toolEnv,
   typesSecrets
-} from "./chunk-KDW65RBE.js";
+} from "./chunk-3XKTIMRP.js";
 export {
   AGENT_HOME,
   APPIUM_DIR,
@@ -77,6 +79,7 @@ export {
   mobileSetup,
   nodeAt,
   openMobileSession,
+  openSessionOn,
   performMobileStep,
   readScreen,
   replayMobileCase,
@@ -85,6 +88,7 @@ export {
   runMobileSteps,
   run as runTool,
   screenLines,
+  shrink,
   stopAppium,
   targetFor,
   textOf,

package/dist/engine.js

@@ -9,8 +9,8 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-Z3SL46OX.js";
-import "./chunk-KDW65RBE.js";
+} from "./chunk-NWJWMDVO.js";
+import "./chunk-3XKTIMRP.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

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