@yoqa/cli 1.0.5 → 1.0.7

package/dist/main.js

@@ -13059,6 +13059,8 @@ var deviceKindSchema = exports_external.union([
 ]);
 var VIEWPORT_PRESET_NAMES = ["desktop", "mobile"];
 var viewportPresetSchema = exports_external.enum(VIEWPORT_PRESET_NAMES);
+var browserProfileSchema = exports_external.enum(["kept", "clean"]);
+var PROFILE_APP_ID_PATTERN = /^(?!\.{1,2}$)[A-Za-z0-9._-]+$/;
 var deviceSchema = exports_external.object({
   id: exports_external.string().min(1),
   name: exports_external.string().min(1),
@@ -13068,7 +13070,8 @@ var deviceSchema = exports_external.object({
   kind: deviceKindSchema,
   state: exports_external.string().optional(),
   model: exports_external.string().optional(),
-  unavailableReason: exports_external.string().optional()
+  unavailableReason: exports_external.string().optional(),
+  verified: exports_external.boolean().optional()
 });
 var listDevicesResponseSchema = exports_external.object({
   platform: devicePlatformSchema,
@@ -13388,6 +13391,7 @@ var caseScriptSchema = exports_external.object({
   version: exports_external.literal(1),
   sourceRunId: exports_external.string().min(1).optional(),
   savedAt: exports_external.number().int().nonnegative(),
+  profile: browserProfileSchema.optional(),
   actions: exports_external.array(caseScriptActionSchema).min(1)
 });
 var catalogCaseSchema = exports_external.object({
@@ -13635,7 +13639,9 @@ var createRunRequestSchema = exports_external.object({
   executionMode: runExecutionModeSchema.optional(),
   screenMode: runScreenModeSchema.optional(),
   lane: exports_external.union([laneNameSchema, exports_external.literal("auto")]).optional(),
-  recordVideo: exports_external.boolean().optional()
+  recordVideo: exports_external.boolean().optional(),
+  profile: browserProfileSchema.optional(),
+  viewport: viewportPresetSchema.optional()
 });
 var callUsageSchema = exports_external.object({
   inputTokens: exports_external.number().int().nonnegative().nullable(),
@@ -13695,7 +13701,9 @@ var runSchema = exports_external.object({
   lane: laneNameSchema.optional(),
   laneWarning: exports_external.string().min(1).optional(),
   browser: exports_external.string().min(1).optional(),
+  browserProfileName: exports_external.string().min(1).optional(),
   viewport: viewportPresetSchema.optional(),
+  profile: browserProfileSchema.optional(),
   error: exports_external.string().nullable(),
   createdAt: exports_external.number().int().nonnegative(),
   startedAt: exports_external.number().int().nonnegative().nullable(),
@@ -13715,7 +13723,24 @@ var connectDeviceRequestSchema = exports_external.object({
   bundleId: exports_external.string().min(1).optional(),
   appPackage: exports_external.string().min(1).optional(),
   lane: exports_external.union([laneNameSchema, exports_external.literal("auto")]).optional(),
-  viewport: viewportPresetSchema.optional()
+  viewport: viewportPresetSchema.optional(),
+  appId: exports_external.string().regex(PROFILE_APP_ID_PATTERN).optional(),
+  profile: browserProfileSchema.optional(),
+  acceptEverydayWarning: exports_external.boolean().optional()
+});
+var everydayWarningRequiredSchema = exports_external.object({
+  error: exports_external.string(),
+  code: exports_external.literal("EVERYDAY_WARNING_REQUIRED"),
+  appId: exports_external.string().min(1),
+  warning: exports_external.string().min(1)
+});
+var resetWebProfileRequestSchema = exports_external.object({
+  appId: exports_external.string().regex(PROFILE_APP_ID_PATTERN).optional(),
+  browserId: exports_external.string().min(1).optional()
+});
+var resetWebProfileResponseSchema = exports_external.object({
+  appId: exports_external.string(),
+  browserIds: exports_external.array(exports_external.string())
 });
 var streamStateSchema = exports_external.union([
   exports_external.literal("ready"),
@@ -13734,7 +13759,9 @@ var activeDeviceResponseSchema = exports_external.object({
   heldByRunId: exports_external.string().min(1).optional(),
   lane: laneNameSchema.optional(),
   laneWarning: exports_external.string().min(1).optional(),
-  viewport: viewportPresetSchema.optional()
+  viewport: viewportPresetSchema.optional(),
+  browserProfileName: exports_external.string().nullable().optional(),
+  targetApp: exports_external.string().min(1).optional()
 });
 var retargetDeviceRequestSchema = exports_external.object({
   bundleId: exports_external.string().min(1).optional(),
@@ -13747,6 +13774,10 @@ var controlPointerMessageSchema = exports_external.object({
   y: exports_external.number().min(0).max(1000),
   seq: exports_external.number().int().nonnegative()
 });
+var controlScreenChangedMessageSchema = exports_external.object({
+  ok: exports_external.literal(true),
+  type: exports_external.literal("screen-changed")
+});
 var screenElementSchema = exports_external.object({
   type: exports_external.string(),
   label: exports_external.string(),
@@ -13758,11 +13789,16 @@ var screenElementSchema = exports_external.object({
   enabled: exports_external.boolean().optional(),
   visible: exports_external.boolean().optional()
 });
+var screenSourceSchema = exports_external.object({
+  kind: exports_external.enum(["target", "foreground", "system"]),
+  bundleId: exports_external.string().optional()
+});
 var screenResponseSchema = exports_external.object({
   full: exports_external.boolean(),
   window: exports_external.object({ width: exports_external.number(), height: exports_external.number() }),
   elements: exports_external.array(screenElementSchema).optional(),
-  raw: exports_external.string().optional()
+  raw: exports_external.string().optional(),
+  source: screenSourceSchema.optional()
 });
 var screenshotRequestSchema = exports_external.object({
   path: exports_external.string().min(1).optional()
@@ -13819,6 +13855,7 @@ var actionPhasesSchema = exports_external.object({
   actionMs: exports_external.number().nonnegative(),
   settleMs: exports_external.number().nonnegative()
 });
+var appStorageSchema = exports_external.union([exports_external.literal("cleared"), exports_external.literal("kept")]);
 var actionResponseSchema = exports_external.object({
   ok: exports_external.literal(true),
   kind: actionKindSchema,
@@ -13827,7 +13864,8 @@ var actionResponseSchema = exports_external.object({
     y: exports_external.number().optional()
   }).optional(),
   screenshot: actionResultScreenshotSchema.optional(),
-  phases: actionPhasesSchema.optional()
+  phases: actionPhasesSchema.optional(),
+  storage: appStorageSchema.optional()
 });
 var actionBatchRequestSchema = exports_external.object({
   steps: exports_external.array(actionRequestSchema).min(1),
@@ -14198,7 +14236,7 @@ var FIELD_ORDER = [
   "durationMs",
   "reason"
 ];
-var TOP_LEVEL_KEYS = new Set(["version", "name", "sourceRunId", "savedAt", "actions"]);
+var TOP_LEVEL_KEYS = new Set(["version", "name", "sourceRunId", "savedAt", "profile", "actions"]);
 function isActionType(value) {
   return typeof value === "string" && ACTION_TYPES.includes(value);
 }
@@ -14441,6 +14479,14 @@ function parseCaseScriptFile(text, options = {}) {
       message: "sourceRunId must be text"
     });
   }
+  const profile = browserProfileSchema.safeParse(top.profile);
+  if (top.profile != null && !profile.success) {
+    errors3.push({
+      line: lineOf(root.get("profile", true), lineCounter2),
+      action: null,
+      message: `profile must be ${browserProfileSchema.options.join(" or ")}`
+    });
+  }
   const savedAt = top.savedAt;
   const legacy = savedAt !== undefined;
   if (legacy && (typeof savedAt !== "number" || !Number.isInteger(savedAt) || savedAt < 0)) {
@@ -14494,6 +14540,7 @@ function parseCaseScriptFile(text, options = {}) {
       version: 1,
       ...typeof sourceRunId === "string" ? { sourceRunId } : {},
       savedAt: typeof savedAt === "number" ? savedAt : options.savedAt ?? Date.now(),
+      ...profile.success ? { profile: profile.data } : {},
       actions
     }
   };
@@ -14594,6 +14641,8 @@ function formatCaseScriptFile(script, options = {}) {
     lines.push(`name: ${yamlScalar(name)}`);
   if (script.sourceRunId)
     lines.push(`sourceRunId: ${yamlScalar(script.sourceRunId)}`);
+  if (script.profile)
+    lines.push(`profile: ${script.profile}`);
   lines.push("actions:");
   for (const action of script.actions) {
     lines.push(...formatCaseScriptFileItemLines(action, "  "));
@@ -15296,6 +15345,11 @@ function mapCatalogStep(step, screenshotsByStepId) {
     screenshotBase64: screenshotsByStepId[step.id] ?? null
   };
 }
+function reportedBrowser(run) {
+  if (!run.browser)
+    return null;
+  return run.browserProfileName ? `${run.browser} · profile ${run.browserProfileName}` : run.browser;
+}
 function buildRunReportFromCatalogRun(run, meta = {}, screenshotsByStepId = {}) {
   const status = toReportStatus(run.status);
   if (!status) {
@@ -15325,8 +15379,9 @@ function buildRunReportFromCatalogRun(run, meta = {}, screenshotsByStepId = {})
     screenMode: run.screenMode ?? null,
     lane: run.lane ?? null,
     laneWarning: run.laneWarning ?? null,
-    browser: run.browser ?? null,
+    browser: reportedBrowser(run),
     viewport: run.viewport ?? null,
+    profile: run.profile ?? null,
     error: run.error,
     createdAt: run.createdAt,
     startedAt: run.startedAt,
@@ -15387,6 +15442,7 @@ function formatRunReportHtml(doc) {
     ["Platform", doc.platform ?? "—"],
     ...doc.browser ? [["Browser", doc.browser]] : [],
     ...doc.viewport ? [["Viewport", formatViewportPreset(doc.viewport)]] : [],
+    ...doc.profile ? [["Profile", doc.profile]] : [],
     ["Mode", doc.executionMode ?? "—"],
     ...screenRows,
     ["Started", formatWhen(doc.startedAt ?? doc.createdAt)],
@@ -15515,6 +15571,7 @@ function formatRunReportMarkdown(doc) {
     `| Platform | ${escapeMd(doc.platform ?? "—")} |`,
     ...doc.browser ? [`| Browser | ${escapeMd(doc.browser)} |`] : [],
     ...doc.viewport ? [`| Viewport | ${escapeMd(formatViewportPreset(doc.viewport))} |`] : [],
+    ...doc.profile ? [`| Profile | ${escapeMd(doc.profile)} |`] : [],
     `| Mode | ${escapeMd(doc.executionMode ?? "—")} |`,
     ...doc.screenMode ? [`| Screen | ${escapeMd(doc.screenMode)} |`] : [],
     ...doc.lane ? [`| Lane | ${escapeMd(doc.lane)} |`] : [],
@@ -15586,6 +15643,7 @@ function formatRunReportGithubSummary(doc) {
     `| Platform | ${escapeMd(doc.platform ?? "—")} |`,
     ...doc.browser ? [`| Browser | ${escapeMd(doc.browser)} |`] : [],
     ...doc.viewport ? [`| Viewport | ${escapeMd(formatViewportPreset(doc.viewport))} |`] : [],
+    ...doc.profile ? [`| Profile | ${escapeMd(doc.profile)} |`] : [],
     `| Mode | ${escapeMd(doc.executionMode ?? "—")} |`,
     ...doc.screenMode ? [`| Screen | ${escapeMd(doc.screenMode)} |`] : [],
     ...doc.lane ? [`| Lane | ${escapeMd(doc.lane)} |`] : [],
@@ -15623,6 +15681,28 @@ function formatRunReportGithubSummary(doc) {
   return lines.join(`
 `);
 }
+// ../runner-client/src/web-browsers.ts
+var WEB_BROWSERS = [
+  { browser: "chrome", name: "Google Chrome", verified: true },
+  { browser: "edge", name: "Microsoft Edge", verified: true },
+  { browser: "brave", name: "Brave Browser", verified: true },
+  { browser: "chromium", name: "Chromium", verified: true },
+  { browser: "dia", name: "Dia", verified: true },
+  { browser: "arc", name: "Arc", verified: false },
+  { browser: "opera", name: "Opera", verified: false },
+  { browser: "vivaldi", name: "Vivaldi", verified: false }
+];
+function installedBrowserId(browser) {
+  return `web-${browser}`;
+}
+function everydayBrowserId(browser) {
+  return `web-${browser}-everyday`;
+}
+var REMOTE_DEBUGGING_SETTING_URL = "chrome://inspect/#remote-debugging";
+function formatDeviceState(device) {
+  const parts = [device.state, device.verified === false ? "unverified" : null].filter(Boolean);
+  return parts.length > 0 ? parts.join(" · ") : null;
+}
 // ../runner-client/src/index.ts
 var DEFAULT_BASE_URL = "http://127.0.0.1:7420";
 function errorMessageFromBody(json, fallback) {
@@ -15657,6 +15737,36 @@ class RunnerRequestError extends Error {
     this.name = "RunnerRequestError";
   }
 }
+
+class RunnerUnreachableError extends Error {
+  url;
+  constructor(url, options) {
+    const reason = options.cause instanceof Error ? options.cause.message : String(options.cause);
+    super(reason, options);
+    this.url = url;
+    this.name = "RunnerUnreachableError";
+  }
+}
+function answeredFetch(fetchImpl) {
+  const wrapped = async (input, init) => {
+    try {
+      return await fetchImpl(input, init);
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError")
+        throw error;
+      throw new RunnerUnreachableError(String(input instanceof Request ? input.url : input), {
+        cause: error
+      });
+    }
+  };
+  return Object.assign(wrapped, fetchImpl);
+}
+function everydayWarningRequired(error) {
+  if (!(error instanceof RunnerRequestError) || error.status !== 428)
+    return null;
+  const parsed = everydayWarningRequiredSchema.safeParse(error.body);
+  return parsed.success ? parsed.data : null;
+}
 function developerNotTrusted(error) {
   if (!(error instanceof RunnerRequestError) || error.status !== 428)
     return null;
@@ -15679,7 +15789,7 @@ class RunnerClient {
   fetchImpl;
   constructor(options = {}) {
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
-    this.fetchImpl = options.fetchImpl ?? fetch.bind(globalThis);
+    this.fetchImpl = answeredFetch(options.fetchImpl ?? fetch.bind(globalThis));
   }
   async requestJson(path, init, fallbackError) {
     const response = await this.fetchImpl(`${this.baseUrl}${path}`, uncached(init));
@@ -16013,15 +16123,27 @@ class RunnerClient {
   async deleteRunTestVideo(runId, runTestId) {
     await this.requestJson(`/runs/${encodeURIComponent(runId)}/tests/${encodeURIComponent(runTestId)}/video`, { method: "DELETE" }, "Delete video failed");
   }
-  async connectDevice(request) {
+  async connectDevice(request, options = {}) {
     const body = connectDeviceRequestSchema.parse(request);
     const json = await this.requestJson("/devices/connect", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      signal: options.signal
     }, "Connect device failed");
     return activeDeviceResponseSchema.parse(json);
   }
+  async resetWebProfile(request = {}) {
+    const { appId, browserId } = resetWebProfileRequestSchema.parse(request);
+    const params = new URLSearchParams;
+    if (appId)
+      params.set("appId", appId);
+    if (browserId)
+      params.set("browserId", browserId);
+    const query = params.toString();
+    const json = await this.requestJson(`/devices/web/profiles${query ? `?${query}` : ""}`, { method: "DELETE" }, "Reset browser profile failed");
+    return resetWebProfileResponseSchema.parse(json);
+  }
   async getActiveDevice() {
     const response = await this.fetchImpl(`${this.baseUrl}/devices/active?_=${Date.now()}`, uncached());
     if (response.status === 404)
@@ -16512,7 +16634,7 @@ function recommendScreenDefault(vision, tree) {
 // package.json
 var package_default = {
   name: "@yoqa/cli",
-  version: "1.0.5",
+  version: "1.0.7",
   description: "Yoqa CLI — drive local mobile QA from the terminal or CI (talks to the Yoqa runner over HTTP)",
   license: "UNLICENSED",
   type: "module",
@@ -16549,7 +16671,7 @@ var package_default = {
     health: "bun run src/main.ts health"
   },
   dependencies: {
-    "@yoqa/runner": "1.0.5"
+    "@yoqa/runner": "1.0.7"
   },
   devDependencies: {
     "@types/node": "^22.15.30",
@@ -17049,7 +17171,7 @@ function commandChainIncludes(command, name) {
 var PLATFORM_DEVICES_DESCRIPTION = {
   ios: "List iOS devices and simulators",
   android: "List Android devices and emulators",
-  web: "List installed web browsers (attach a Chromium you started by naming its port: chromium-cdp-<port>)"
+  web: "List installed web browsers and your Everyday browsers (CI: attach a Chromium you started by naming its port, chromium-cdp-<port>)"
 };
 function parsePlatform(value) {
   const parsed = devicePlatformSchema.safeParse(value);
@@ -17059,9 +17181,18 @@ function parsePlatform(value) {
   }
   return parsed.data;
 }
-var WEB_DEVICE_ID = /^(web-(chrome|edge|brave|chromium)|chromium-cdp-\d+)$/;
+var INSTALLED_BROWSER_IDS = new Set(WEB_BROWSERS.map(({ browser }) => installedBrowserId(browser)));
+var ATTACH_DEVICE_ID = /^chromium-cdp-\d+$/;
+var EVERYDAY_BROWSER_NAMES = new Map(WEB_BROWSERS.map(({ browser, name }) => [everydayBrowserId(browser), name]));
+function everydayBrowserName(deviceId) {
+  return EVERYDAY_BROWSER_NAMES.get(deviceId) ?? null;
+}
+function isEverydayDeviceId(deviceId) {
+  return everydayBrowserName(deviceId) !== null;
+}
+var UNSUPPORTED_BROWSER_ID = /^web-(firefox|safari)(-everyday)?$/;
 function isWebDeviceId(deviceId) {
-  return WEB_DEVICE_ID.test(deviceId);
+  return INSTALLED_BROWSER_IDS.has(deviceId) || ATTACH_DEVICE_ID.test(deviceId) || isEverydayDeviceId(deviceId) || UNSUPPORTED_BROWSER_ID.test(deviceId);
 }
 function connectPlatform(deviceId, value) {
   if (value === undefined && isWebDeviceId(deviceId))
@@ -17370,12 +17501,13 @@ function client(baseUrl) {
 }
 function describeSession(body) {
   const viewport = body.viewport ? ` viewport ${formatViewportPreset(body.viewport)}` : "";
-  return `${body.platform} ${body.deviceId} lane ${body.lane ?? "direct"}${viewport}`;
+  const profile = body.browserProfileName ? ` profile ${body.browserProfileName}` : "";
+  return `${body.platform} ${body.deviceId} lane ${body.lane ?? "direct"}${viewport}${profile}`;
 }
 function fail(command, error) {
   const message = error instanceof Error ? error.message : String(error);
   console.error(`yoqa ${command} failed: ${message}`);
-  if (!(error instanceof RunnerRequestError) && !message.includes("yoqa serve") && !message.includes("Bun")) {
+  if (error instanceof RunnerUnreachableError) {
     console.error("Is the runner up? Try: yoqa serve");
   }
   process.exitCode = 1;
@@ -17493,6 +17625,10 @@ program2.command("status").description("Show local runner, provider, and active
   }
 });
 var devices = program2.command("devices").description("List local devices, simulators, and emulators");
+var EVERYDAY_HINTS = {
+  "remote debugging off": `Turn it on at ${REMOTE_DEBUGGING_SETTING_URL}, then connect`,
+  "not running": `Open it, turn on remote debugging at ${REMOTE_DEBUGGING_SETTING_URL}, then connect`
+};
 function printDevicesTable(devicesList) {
   if (devicesList.length === 0) {
     console.log("No devices found.");
@@ -17500,16 +17636,21 @@ function printDevicesTable(devicesList) {
   }
   for (const device of devicesList) {
     const label = device.owner ? `${device.name} (${device.owner})` : device.name;
-    const state = device.state ? ` [${device.state}]` : "";
+    const stateLine = formatDeviceState(device);
+    const state = stateLine ? ` [${stateLine}]` : "";
     console.log(`${device.kind.padEnd(10)} ${label} — ${device.osVersion}${state}`);
     console.log(`           ${device.id}`);
     if (device.unavailableReason) {
       console.log(`           Not a target: ${device.unavailableReason}`);
     }
+    const hint = isEverydayDeviceId(device.id) ? EVERYDAY_HINTS[device.state ?? ""] : undefined;
+    if (hint)
+      console.log(`           ${hint}`);
   }
 }
+var platformDevices = {};
 for (const platform of Object.keys(PLATFORM_DEVICES_DESCRIPTION)) {
-  devices.command(platform).description(PLATFORM_DEVICES_DESCRIPTION[platform]).option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--all", "Include unavailable / shutdown devices", true).option("--booted-only", "Only show booted / online devices").action(async (options) => {
+  platformDevices[platform] = devices.command(platform).description(PLATFORM_DEVICES_DESCRIPTION[platform]).option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--all", "Include unavailable / shutdown devices", true).option("--booted-only", "Only show booted / online devices").action(async (options) => {
     try {
       const includeUnavailable = options.bootedOnly ? false : options.all !== false;
       const body = await client(options.baseUrl).listDevices(platform, {
@@ -17525,7 +17666,45 @@ for (const platform of Object.keys(PLATFORM_DEVICES_DESCRIPTION)) {
     }
   });
 }
-devices.command("connect").description("Open a Device Session on a device").argument("<deviceId>", "Device UDID / serial, a browser id (web-chrome), or chromium-cdp-<port> for a Chromium you started").option("--platform <platform>", "ios | android | web (web for web-* and chromium-cdp-<port>)").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--bundle-id <id>", "iOS bundle id to launch").option("--app-package <id>", "Android application id to launch").option("--lane <lane>", "direct | auto (the only Lane is Direct)").option("--viewport <preset>", "Web only: desktop (1280×800, the default) | mobile (390×844, touch and a mobile user agent)").option("--json", "Print raw JSON").action(async (deviceId, options) => {
+platformDevices.web.command("reset-profile").description("Delete a Kept browser profile, signing out of every site in it (refused while its browser is open)").option("--app <app>", "App prefix or id whose profile to reset (default: the default profile)").option("--browser <id>", "One browser's profile, e.g. web-chrome (default: every browser's)").configureHelp({ showGlobalOptions: true }).action(async (_options, command) => {
+  const options = command.optsWithGlobals();
+  try {
+    const c = client(options.baseUrl);
+    const appId = options.app ? findCatalogApp(await c.listApps(), options.app)?.id ?? options.app : undefined;
+    const body = await c.resetWebProfile({ appId, browserId: options.browser });
+    if (options.json) {
+      console.log(JSON.stringify(body, null, 2));
+      return;
+    }
+    if (body.browserIds.length === 0) {
+      const browser = options.browser ? ` in ${options.browser}` : "";
+      console.log(`No Kept profile for ${body.appId}${browser} to reset.`);
+      return;
+    }
+    console.log(`reset the Kept profile for ${body.appId} in ${body.browserIds.join(", ")}`);
+  } catch (error) {
+    fail("devices web reset-profile", error);
+  }
+});
+var ALLOW_LINE_DELAY_MS = 250;
+async function connectEveryday(c, request, browser) {
+  const controller = new AbortController;
+  const cancel = () => controller.abort();
+  process.once("SIGINT", cancel);
+  const allowLine = setTimeout(() => console.error(`Click Allow in ${browser}… (up to 60 s; Ctrl-C cancels)`), ALLOW_LINE_DELAY_MS);
+  try {
+    return await c.connectDevice(request, { signal: controller.signal });
+  } catch (error) {
+    if (controller.signal.aborted)
+      return null;
+    throw error;
+  } finally {
+    clearTimeout(allowLine);
+    process.off("SIGINT", cancel);
+  }
+}
+devices.command("connect").description("Open a Device Session on a device").argument("<deviceId>", "Device UDID / serial, a browser id (web-chrome), your Everyday browser (web-chrome-everyday), or chromium-cdp-<port> for a Chromium you started (CI)").option("--platform <platform>", "ios | android | web (web for web-* and chromium-cdp-<port>)").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--bundle-id <id>", "iOS bundle id to launch").option("--app-package <id>", "Android application id to launch").option("--lane <lane>", "direct | auto (the only Lane is Direct)").option("--viewport <preset>", "Web only: desktop (1280×800, the default) | mobile (390×844, touch and a mobile user agent)").option("--app <app>", "Web only: App prefix or id whose Kept profile to open, and whose Everyday browser warning applies (default: the default profile)").option("--yes", "Everyday browser only: accept its first-use warning for the App").option("--json", "Print raw JSON").action(async (deviceId, options) => {
+  const everyday = everydayBrowserName(deviceId);
   try {
     const platform = connectPlatform(deviceId, options.platform);
     const lane = options.lane;
@@ -17533,14 +17712,27 @@ devices.command("connect").description("Open a Device Session on a device").argu
       throw new Error("--lane must be direct or auto");
     }
     const viewport = parseViewportPreset(options.viewport, platform);
-    const body = await client(options.baseUrl).connectDevice({
+    if (options.app && platform !== "web") {
+      throw new Error("--app is for web devices: a phone takes --bundle-id or --app-package");
+    }
+    const c = client(options.baseUrl);
+    const appId = options.app ? (await resolveAppId(c, options.app)).id : undefined;
+    const request = {
       deviceId,
       platform,
       bundleId: options.bundleId,
       appPackage: options.appPackage,
       lane,
-      ...viewport ? { viewport } : {}
-    });
+      ...viewport ? { viewport } : {},
+      ...appId ? { appId } : {},
+      ...everyday && options.yes ? { acceptEverydayWarning: true } : {}
+    };
+    const body = everyday ? await connectEveryday(c, request, everyday) : await c.connectDevice(request);
+    if (!body) {
+      console.error(`yoqa devices connect cancelled before Allow in ${everyday}`);
+      process.exitCode = 130;
+      return;
+    }
     if (options.json) {
       console.log(JSON.stringify(body, null, 2));
       return;
@@ -17549,6 +17741,16 @@ devices.command("connect").description("Open a Device Session on a device").argu
     if (body.laneWarning)
       console.log(`lane warning: ${body.laneWarning}`);
   } catch (error) {
+    const warning = everydayWarningRequired(error);
+    if (warning) {
+      const app = options.app ? ` --app ${options.app}` : "";
+      console.error(`${warning.warning}
+
+To accept this for ${warning.appId} and connect, run:
+  yoqa devices connect ${deviceId}${app} --yes`);
+      process.exitCode = 1;
+      return;
+    }
     const untrusted = developerNotTrusted(error);
     if (untrusted && !options.json) {
       console.error(formatDeveloperNotTrusted(untrusted, `yoqa devices connect ${deviceId} --platform ${options.platform}`));
@@ -17589,6 +17791,12 @@ devices.command("disconnect").description("Close the active Device Session").opt
     fail("devices disconnect", error);
   }
 });
+function screenSourceLine(source) {
+  if (source.kind === "system")
+    return "Read from the system (SpringBoard), not an app";
+  const app = source.bundleId ?? "an unnamed app";
+  return `Read from ${app} (${source.kind === "target" ? "target app" : "foreground app"})`;
+}
 program2.command("screen").description("Inspect the active device screen (cleaned tree by default)").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--full", "Return the raw accessibility tree").option("--json", "Print raw JSON").action(async (options) => {
   try {
     const body = await client(options.baseUrl).getScreen({ full: options.full });
@@ -17596,6 +17804,8 @@ program2.command("screen").description("Inspect the active device screen (cleane
       console.log(JSON.stringify(body, null, 2));
       return;
     }
+    if (body.source)
+      console.log(screenSourceLine(body.source));
     for (const el of body.elements ?? []) {
       console.log(`${String(el.x).padStart(4)},${String(el.y).padStart(4)}  ${el.width}x${el.height}  ${el.label}`);
     }
@@ -18365,7 +18575,7 @@ runsCmd.command("delete").argument("<runId>", "Run id").option("--base-url <url>
     fail("runs delete", error);
   }
 });
-runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("--cases <numbers>", "Comma-separated case numbers, e.g. 1,2,5").option("--device <id>", "Device id (defaults to active session)").option("--platform <platform>", "ios | android | web (web for web-* and chromium-cdp-<port>; defaults to active session)").option("--build-id <id>", "Registered build id to install before run").option("--build-path <path>", "Absolute build path to register + install").option("--mode <mode>", "auto | script | agent (default: auto)").option("--screen-mode <mode>", "vision | tree — what the agent sees: screenshot only, or also the accessibility tree (default: vision)").option("--lane <lane>", "direct | auto").option("--record-video", "Record a screen video of every case in the run, even cases not set to record").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--wait", "Wait until the run finishes (passed / errored / cancelled)").option("--timeout <seconds>", "Wait timeout in seconds (default: 1800)", String(DEFAULT_RUN_WAIT_TIMEOUT_SECONDS)).option("--github-output", "Write run_id and status to $GITHUB_OUTPUT").option("--no-github-output", "Do not write GitHub step outputs").action(async (appArg, options) => {
+runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("--cases <numbers>", "Comma-separated case numbers, e.g. 1,2,5").option("--device <id>", "Device id (defaults to active session)").option("--platform <platform>", "ios | android | web (web for web-* and chromium-cdp-<port>; defaults to active session)").option("--build-id <id>", "Registered build id to install before run").option("--build-path <path>", "Absolute build path to register + install").option("--mode <mode>", "auto | script | agent (default: auto)").option("--screen-mode <mode>", "vision | tree — what the agent sees: screenshot only, or also the accessibility tree (default: vision)").option("--lane <lane>", "direct | auto").option("--record-video", "Record a screen video of every case in the run, even cases not set to record").option("--profile <profile>", "web: kept | clean — the App's Kept browser profile or a throwaway one, whatever the cases ask (default: clean if a case asks, else kept)").option("--viewport <preset>", "web: desktop | mobile — reopens a session at another preset (default: the session's, else desktop)").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--wait", "Wait until the run finishes (passed / errored / cancelled)").option("--timeout <seconds>", "Wait timeout in seconds (default: 1800)", String(DEFAULT_RUN_WAIT_TIMEOUT_SECONDS)).option("--github-output", "Write run_id and status to $GITHUB_OUTPUT").option("--no-github-output", "Do not write GitHub step outputs").action(async (appArg, options) => {
   try {
     const c = client(options.baseUrl);
     const resolved = await resolveAppId(c, appArg);
@@ -18387,6 +18597,9 @@ runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("
       if (!active) {
         throw new Error("No --device/--platform and no active session. Connect first or pass both flags.");
       }
+      if (!deviceId && isEverydayDeviceId(active.deviceId)) {
+        throw new Error(`The session is on your Everyday browser, which a Run uses only when named. Pass --device ${active.deviceId} to run there.`);
+      }
       deviceId = deviceId ?? active.deviceId;
       platformOption = platformOption ?? active.platform;
     }
@@ -18403,6 +18616,11 @@ runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("
     if (options.lane && !lane) {
       throw new Error("--lane must be direct or auto");
     }
+    const profile = options.profile === "kept" || options.profile === "clean" ? options.profile : undefined;
+    if (options.profile && !profile) {
+      throw new Error("--profile must be kept or clean");
+    }
+    const viewport = parseViewportPreset(options.viewport, platform);
     let run = await c.createRun({
       appId: resolved.id,
       caseIds,
@@ -18413,7 +18631,9 @@ runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("
       executionMode,
       screenMode,
       lane,
-      recordVideo: options.recordVideo || undefined
+      recordVideo: options.recordVideo || undefined,
+      profile,
+      viewport
     });
     if (options.wait) {
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@yoqa/cli",
-	"version": "1.0.5",
+	"version": "1.0.7",
 	"description": "Yoqa CLI — drive local mobile QA from the terminal or CI (talks to the Yoqa runner over HTTP)",
 	"license": "UNLICENSED",
 	"type": "module",
@@ -37,7 +37,7 @@
 		"health": "bun run src/main.ts health"
 	},
 	"dependencies": {
-		"@yoqa/runner": "1.0.5"
+		"@yoqa/runner": "1.0.7"
 	},
 	"devDependencies": {
 		"@types/node": "^22.15.30",