@vforsh/argus 0.5.1 → 0.5.3

package/dist/argus.js

@@ -2130,7 +2130,7 @@ var {
 // package.json
 var package_default = {
   name: "@vforsh/argus",
-  version: "0.5.1",
+  version: "0.5.3",
   repository: {
     type: "git",
     url: "git+https://github.com/vforsh/argus.git",
@@ -3551,6 +3551,11 @@ var ARGUS_ERROR_CODES = [
   "argus_executable_not_found",
   "body_not_available",
   "cdp_not_attached",
+  "cdp_renderer_unresponsive",
+  "cdp_target_replaced",
+  "cdp_timeout",
+  "chrome_unreachable",
+  "dialog_blocking",
   "dialog_not_prompt",
   "extension_action_failed",
   "extension_frame_not_ready",
@@ -3580,6 +3585,7 @@ var ARGUS_ERROR_CODES = [
   "session_invalid_request",
   "session_request_timeout",
   "session_unknown_command",
+  "target_not_focused",
   "unexpected_matches",
   "unsupported_platform"
 ];
@@ -4451,7 +4457,7 @@ var buildWatcherUrl = (watcher, path4, query2) => {
   const qs = query2?.toString();
   return `http://${watcher.host}:${watcher.port}${path4}${qs ? `?${qs}` : ""}`;
 };
-var formatWatcherTransportError = (watcher, error) => `${watcher.id}: failed to reach watcher (${formatError(error)})`;
+var formatWatcherTransportError = (watcher, error) => classifyWatcherFailure(error) === "api-rejection" ? `${watcher.id}: watcher rejected the request (${formatError(error)})` : `${watcher.id}: failed to reach watcher (${formatError(error)})`;
 var classifyWatcherFailure = (error) => {
   if (isHttpResponseError(error)) {
     return "api-rejection";
@@ -6104,6 +6110,10 @@ var resolvePath = (input) => {
   const expanded = input.startsWith("~/") || input === "~" ? path4.join(homedir(), input.slice(1)) : input;
   return path4.resolve(expanded);
 };
+var resolveArtifactOutFile = (out) => {
+  const trimmed = out?.trim();
+  return trimmed ? resolvePath(trimmed) : undefined;
+};
 
 // dist/commands/startShared.js
 var resolveInjectScript = async (inject, output) => {
@@ -7105,6 +7115,63 @@ var getErrorCode = (error) => {
 var hasErrorCode = (error, code2) => getErrorCode(error) === code2;
 var createNotAttachedError = (message = "No tab attached via extension") => codedError("cdp_not_attached", message);
 
+// ../argus-watcher/dist/cdp/health.js
+var CDP_HEALTH_PROBE_TIMEOUT_MS = 2000;
+var diagnoseCdpHealth = async (probe) => {
+  const id = probe.watcherId ?? "<id>";
+  if (!probe.isAttached()) {
+    return {
+      code: "cdp_not_attached",
+      message: `The watcher is not attached to a target. Check \`argus watcher status ${id}\` and \`argus doctor\`.`
+    };
+  }
+  const transport = await probe.checkTransport?.() ?? { state: "ok" };
+  if (transport.state === "unreachable") {
+    return {
+      code: "chrome_unreachable",
+      message: `Chrome's CDP endpoint did not answer (${transport.detail}). Restart the browser, then \`argus doctor\`.`
+    };
+  }
+  if (transport.state === "target_gone") {
+    probe.onTargetGone?.();
+    return {
+      code: "cdp_target_replaced",
+      message: `The attached page target is gone (${transport.detail}) — a navigation replaced it. ` + `Argus is reattaching; retry the command, or check \`argus watcher status ${id}\`.`
+    };
+  }
+  const dialog2 = probe.getBlockingDialog?.();
+  if (dialog2) {
+    return {
+      code: "dialog_blocking",
+      message: `A ${dialog2.type} dialog is open and blocking the page. ` + `Dismiss it with \`argus dialog accept ${id}\` or \`argus dialog dismiss ${id}\`, then retry.`
+    };
+  }
+  if (!await probe.probeRenderer()) {
+    return {
+      code: "cdp_renderer_unresponsive",
+      message: `The page's renderer did not answer a trivial evaluation within ${CDP_HEALTH_PROBE_TIMEOUT_MS}ms — its main thread is ` + `blocked, or a cross-origin navigation stranded it. A longer timeout will not help: reload with \`argus reload ${id}\`, ` + "or restart Chrome."
+    };
+  }
+  return {
+    code: "cdp_timeout",
+    message: "The watcher, target, and renderer all answered, so the expression itself exceeded its deadline. Pass a longer timeout."
+  };
+};
+var toDiagnosedError = (diagnosis, original) => {
+  const detail = original instanceof Error ? original.message : String(original);
+  return codedError(diagnosis.code, `${detail}. ${diagnosis.message}`);
+};
+var isCdpTimeoutError = (error) => error instanceof Error && /\b(?:CDP|Bridge|Control) request timed out\b/i.test(error.message);
+var createSessionRendererProbe = (session2) => async () => {
+  try {
+    const params = { expression: "1", returnByValue: true, silent: true };
+    await session2.sendAndWait("Runtime.evaluate", params, { timeoutMs: CDP_HEALTH_PROBE_TIMEOUT_MS });
+    return true;
+  } catch {
+    return false;
+  }
+};
+
 // ../argus-watcher/dist/http/httpUtils.js
 var respondJson = (res, body, status2 = 200) => {
   const payload = JSON.stringify(body);
@@ -7133,6 +7200,17 @@ var respondPayloadTooLarge = (res) => {
 var respondError = (res, error) => {
   respondApiError(res, 500, getErrorCode(error), formatError(error));
 };
+var respondCdpError = async (res, error, diagnose) => {
+  if (!diagnose || !isCdpTimeoutError(error)) {
+    respondError(res, error);
+    return;
+  }
+  try {
+    respondError(res, toDiagnosedError(await diagnose(), error));
+  } catch {
+    respondError(res, error);
+  }
+};
 var readJsonBody = async (req, res) => {
   const chunks = [];
   let size = 0;
@@ -7274,7 +7352,7 @@ var normalizeTimeout = (value) => {
 // ../argus-watcher/package.json
 var package_default2 = {
   name: "@vforsh/argus-watcher",
-  version: "0.5.1",
+  version: "0.5.3",
   repository: {
     type: "git",
     url: "git+https://github.com/vforsh/argus.git",
@@ -7351,7 +7429,7 @@ var defineJsonRoute = (input) => ({
       if (input.handleError?.(res, error)) {
         return;
       }
-      respondError(res, error);
+      await respondCdpError(res, error, ctx.diagnoseCdp);
     }
   }
 });
@@ -9470,6 +9548,7 @@ var shouldMaterializeByValue = (record2) => {
 };
 
 // ../argus-watcher/dist/http/routes/postEval.js
+var DEFAULT_EVAL_CDP_TIMEOUT_MS = 30000;
 var route18 = defineJsonRoute({
   method: "POST",
   path: "/eval",
@@ -9482,7 +9561,7 @@ var route18 = defineJsonRoute({
     replMode: normalizeBoolean(payload.replMode, true),
     returnByValue: normalizeBoolean(payload.returnByValue, true),
     jsonValue: normalizeBoolean(payload.jsonValue, false),
-    timeoutMs: normalizeTimeout(payload.timeoutMs),
+    timeoutMs: normalizeTimeout(payload.timeoutMs) ?? DEFAULT_EVAL_CDP_TIMEOUT_MS,
     scenario: normalizeBoolean(payload.scenario, false),
     scenarioServices: {
       buffer: ctx.buffer,
@@ -11071,25 +11150,44 @@ var dispatchKeydown = async (session2, options) => {
     await session2.sendAndWait("DOM.focus", { nodeId });
     focused = true;
   }
-  const isPrintable = event.text != null && event.text !== "\r";
+  const carriesText = event.text != null;
   const baseParams = {
     code: event.code,
     key: event.key,
     windowsVirtualKeyCode: event.keyCode,
-    nativeVirtualKeyCode: event.keyCode,
     modifiers: event.modifiers
   };
-  if (isPrintable) {
-    await session2.sendAndWait("Input.dispatchKeyEvent", { ...baseParams, type: "keyDown", text: event.text });
-    await session2.sendAndWait("Input.dispatchKeyEvent", { ...baseParams, type: "char", text: event.text });
-    await session2.sendAndWait("Input.dispatchKeyEvent", { ...baseParams, type: "keyUp" });
-  } else {
-    await session2.sendAndWait("Input.dispatchKeyEvent", { ...baseParams, type: "rawKeyDown", text: event.text });
-    await session2.sendAndWait("Input.dispatchKeyEvent", { ...baseParams, type: "keyUp" });
-  }
+  const keyDownParams = carriesText ? { ...baseParams, type: "keyDown", text: event.text, unmodifiedText: event.text } : { ...baseParams, type: "rawKeyDown" };
+  await session2.sendAndWait("Input.dispatchKeyEvent", keyDownParams);
+  await session2.sendAndWait("Input.dispatchKeyEvent", { ...baseParams, type: "keyUp" });
   return { key: event.key, code: event.code, modifiers: event.modifiers, focused, event };
 };
 
+// ../argus-watcher/dist/cdp/pageFocus.js
+var FOCUS_PROBE_TIMEOUT_MS = 3000;
+var ensurePageInputFocus = async (pageSession, visibility2) => {
+  if (!pageSession.isAttached()) {
+    return { activated: false };
+  }
+  if (await hasPageFocus(pageSession)) {
+    return { activated: false };
+  }
+  try {
+    await visibility2.setLock(pageSession, "shown");
+  } catch (error) {
+    throw notFocusedError(`activating it failed: ${formatError(error)}`);
+  }
+  if (!await hasPageFocus(pageSession)) {
+    throw notFocusedError("activating it did not give it focus");
+  }
+  return { activated: true };
+};
+var hasPageFocus = async (pageSession) => {
+  const focused = await tryEvaluateInPage(pageSession, "document.hasFocus()", { timeoutMs: FOCUS_PROBE_TIMEOUT_MS });
+  return focused !== false;
+};
+var notFocusedError = (reason) => codedError("target_not_focused", `The page is not focused, so Chrome would drop the keyboard event — ${reason}. ` + "Run `argus page show <id>` and retry, or start the watcher against a visible page.");
+
 // ../argus-watcher/dist/http/routes/postDomKeydown.js
 var route32 = defineJsonRoute({
   method: "POST",
@@ -11097,6 +11195,7 @@ var route32 = defineJsonRoute({
   bodySchema: domKeydownRequestSchema,
   endpoint: "dom/keydown",
   handle: async ({ ctx, body: payload }) => {
+    const activation = await ensurePageInputFocus(ctx.pageCdpSession, ctx.visibilityController);
     const result = await dispatchKeydown(ctx.cdpSession, {
       key: payload.key,
       code: payload.code,
@@ -11109,6 +11208,7 @@ var route32 = defineJsonRoute({
       code: result.code,
       modifiers: result.modifiers,
       focused: result.focused,
+      activated: activation.activated,
       event: result.event
     };
   }
@@ -13468,6 +13568,47 @@ var decodeInlineSourcemap = (value) => {
   }
 };
 
+// ../argus-watcher/dist/sourcemaps/scriptFetcher.js
+var createScriptFetcher = () => {
+  const rangeHostileOrigins = new Set;
+  return async (scriptUrl, tailBytes) => {
+    const origin = originOf(scriptUrl);
+    const ranged = tailBytes !== null && tailBytes > 0 && !rangeHostileOrigins.has(origin);
+    const response = await fetch(scriptUrl, ranged ? { headers: { Range: `bytes=-${tailBytes}` } } : undefined);
+    if (response.ok) {
+      return readBody(response);
+    }
+    if (!ranged || !looksLikeRangeRejection(response.status)) {
+      return null;
+    }
+    await discardBody(response);
+    const whole = await fetch(scriptUrl);
+    if (!whole.ok) {
+      await discardBody(whole);
+      return null;
+    }
+    if (!rangeHostileOrigins.has(origin)) {
+      rangeHostileOrigins.add(origin);
+      console.warn(`[Sourcemaps] ${origin} rejected a suffix Range request (HTTP ${response.status}); refetching scripts whole.`);
+    }
+    return readBody(whole);
+  };
+};
+var looksLikeRangeRejection = (status2) => status2 === 416 || status2 >= 500;
+var originOf = (scriptUrl) => {
+  try {
+    return new URL(scriptUrl).origin;
+  } catch {
+    return scriptUrl;
+  }
+};
+var readBody = async (response) => ({ text: await response.text(), partial: response.status === 206 });
+var discardBody = async (response) => {
+  try {
+    await response.body?.cancel();
+  } catch {}
+};
+
 // ../argus-watcher/dist/sourcemaps/resolveLocation.js
 var resolveSourcemappedLocationWithMap = (traceMap, location) => {
   if (location.line <= 0 || location.column <= 0) {
@@ -13495,6 +13636,7 @@ var createSourcemapResolver = (options = {}) => {
   const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
   const negativeTtlMs = options.negativeTtlMs ?? DEFAULT_NEGATIVE_TTL_MS;
   const tailBytes = options.tailBytes ?? DEFAULT_TAIL_BYTES;
+  const fetchScript = createScriptFetcher();
   const cache = new Map;
   const pending = new Map;
   let generation = 0;
@@ -13536,7 +13678,7 @@ var createSourcemapResolver = (options = {}) => {
       return inFlight;
     }
     const startedAt = generation;
-    const promise = loadTraceMap(scriptUrl, tailBytes).catch(() => null).then((traceMap) => {
+    const promise = loadTraceMap(scriptUrl, tailBytes, fetchScript).catch(() => null).then((traceMap) => {
       if (startedAt === generation) {
         writeCache(scriptUrl, traceMap);
       }
@@ -13563,7 +13705,7 @@ var createSourcemapResolver = (options = {}) => {
   };
   return { resolve: resolve2, clear };
 };
-var loadTraceMap = async (scriptUrl, tailBytes) => {
+var loadTraceMap = async (scriptUrl, tailBytes, fetchScript) => {
   const tail = await fetchScript(scriptUrl, tailBytes);
   if (!tail) {
     return null;
@@ -13585,14 +13727,6 @@ var loadTraceMap = async (scriptUrl, tailBytes) => {
   }
   return new TraceMap(rawMap, reference.url);
 };
-var fetchScript = async (scriptUrl, tailBytes) => {
-  const init = tailBytes ? { headers: { Range: `bytes=-${tailBytes}` } } : undefined;
-  const response = await fetch(scriptUrl, init);
-  if (!response.ok) {
-    return null;
-  }
-  return { text: await response.text(), partial: response.status === 206 };
-};
 var fetchSourcemap = async (mapUrl) => {
   const response = await fetch(mapUrl);
   if (!response.ok) {
@@ -16211,7 +16345,7 @@ var formatArgs = (args) => {
 
 // ../argus-watcher/dist/cdp/watcherTargets.js
 var findTarget = async (chrome, match) => {
-  const targets = await fetchTargets(chrome);
+  const targets = await fetchCdpTargets(chrome);
   if (targets.length === 0) {
     throw new Error("No CDP targets available");
   }
@@ -16268,8 +16402,9 @@ var matchesTarget = (target, match, targetById, urlRegex2, titleRegex) => {
   }
   return true;
 };
-var fetchTargets = async (chrome) => {
-  const response = await fetch(`http://${chrome.host}:${chrome.port}/json`);
+var TARGET_LIST_TIMEOUT_MS = 5000;
+var fetchCdpTargets = async (chrome, timeoutMs = TARGET_LIST_TIMEOUT_MS) => {
+  const response = await fetch(`http://${chrome.host}:${chrome.port}/json`, { signal: AbortSignal.timeout(timeoutMs) });
   if (!response.ok) {
     throw new Error(`Failed to fetch CDP targets (status ${response.status})`);
   }
@@ -16313,6 +16448,12 @@ var startCdpWatcher = (options) => {
       socket.close();
     }
   };
+  const reconnect = () => {
+    if (stopped) {
+      return;
+    }
+    socket?.close();
+  };
   runLoop();
   session2.onEvent("Runtime.consoleAPICalled", (params) => {
     if (!currentTarget) {
@@ -16345,6 +16486,7 @@ var startCdpWatcher = (options) => {
   });
   return {
     stop,
+    reconnect,
     session: session2,
     getTarget: () => currentTarget ? { ...currentTarget } : null
   };
@@ -16534,9 +16676,29 @@ var createCdpSource = (options) => {
         pageUrl: target?.url ?? null
       };
     },
+    healthChecks: {
+      checkTransport: () => checkCdpTransport(chrome, watcher2),
+      onTargetGone: watcher2.reconnect
+    },
     stop: watcher2.stop
   };
 };
+var checkCdpTransport = async (chrome, watcher2) => {
+  let targets;
+  try {
+    targets = await fetchCdpTargets(chrome, CDP_HEALTH_PROBE_TIMEOUT_MS);
+  } catch (error) {
+    return { state: "unreachable", detail: `${chrome.host}:${chrome.port}: ${formatError(error)}` };
+  }
+  const target = watcher2.getTarget();
+  if (!target) {
+    return { state: "target_gone", detail: "the watcher holds no target" };
+  }
+  if (!targets.some((candidate) => candidate.id === target.id)) {
+    return { state: "target_gone", detail: `Chrome no longer lists target ${target.id} (${target.url})` };
+  }
+  return { state: "ok" };
+};
 
 // ../argus-watcher/dist/native-messaging/messaging.js
 var createNativeMessaging = () => {
@@ -18231,6 +18393,13 @@ var createWatcherHandle = async (options, watcherId) => {
       };
     }
   });
+  const diagnoseCdp = () => diagnoseCdpHealth({
+    watcherId,
+    isAttached: () => sourceHandle.session.isAttached(),
+    probeRenderer: createSessionRendererProbe(sourceHandle.session),
+    getBlockingDialog: () => dialogTracker.getActive(),
+    ...sourceHandle.healthChecks
+  });
   const dialogSession = getPageSession();
   dialogSession.onEvent("Page.javascriptDialogOpening", (params) => {
     const dialog2 = parseDialogStatus(params);
@@ -18263,6 +18432,7 @@ var createWatcherHandle = async (options, watcherId) => {
     throttleController,
     visibilityController,
     netMockController,
+    diagnoseCdp,
     getNetFilterContext: sourceHandle.getNetFilterContext,
     readBrowserCookies: sourceHandle.readBrowserCookies,
     sourceHandle: sourceMode === "extension" ? sourceHandle : undefined,
@@ -19973,7 +20143,7 @@ var resolveAttachedTarget = async (options, output) => {
   try {
     status2 = await fetchJson(statusUrl, { timeoutMs: 2000 });
   } catch (error) {
-    output.writeWarn(`${resolved.watcher.id}: failed to reach watcher (${formatError(error)})`);
+    output.writeWarn(formatWatcherTransportError(resolved.watcher, error));
     process.exitCode = 1;
     return null;
   }
@@ -20898,19 +21068,21 @@ import fs10 from "node:fs/promises";
 import path14 from "node:path";
 
 // dist/eval/evalClient.js
-var DEFAULT_EVAL_REQUEST_TIMEOUT_MS = 1e4;
+var DEFAULT_EVAL_TIMEOUT_MS = 1e4;
+var REQUEST_TIMEOUT_GRACE_MS = 8000;
 var MIN_SUGGESTED_TIMEOUT_MS = 60000;
 var evalOnce = async (input) => {
+  const evalTimeoutMs = input.timeoutMs ?? DEFAULT_EVAL_TIMEOUT_MS;
   const body = {
     expression: input.expression,
     args: input.args,
     awaitPromise: input.awaitPromise,
     replMode: input.replMode,
     returnByValue: input.returnByValue,
-    timeoutMs: input.timeoutMs,
+    timeoutMs: evalTimeoutMs,
     scenario: input.scenario
   };
-  const requestTimeoutMs = input.timeoutMs ? input.timeoutMs + 5000 : DEFAULT_EVAL_REQUEST_TIMEOUT_MS;
+  const requestTimeoutMs = evalTimeoutMs + REQUEST_TIMEOUT_GRACE_MS;
   let response;
   try {
     response = await fetchWatcherJson(input.watcher, {
@@ -20938,11 +21110,11 @@ var evalOnce = async (input) => {
 };
 var formatEvalTransportError = (watcher2, error, timeoutMs) => {
   const baseMessage = formatWatcherTransportError(watcher2, error);
-  if (!isTimeoutError(error)) {
+  if (classifyWatcherFailure(error) === "api-rejection" || !isTimeoutError(error)) {
     return baseMessage;
   }
-  const suggestedTimeoutMs = Math.max(MIN_SUGGESTED_TIMEOUT_MS, (timeoutMs ?? DEFAULT_EVAL_REQUEST_TIMEOUT_MS) * 2);
-  return `${baseMessage}. ` + `Eval may need more time; pass a longer timeout as milliseconds or a duration, for example: ` + `\`argus eval ${watcher2.id} --timeout ${formatSuggestedDuration(suggestedTimeoutMs)} ...\``;
+  const suggestedTimeoutMs = Math.max(MIN_SUGGESTED_TIMEOUT_MS, (timeoutMs ?? DEFAULT_EVAL_TIMEOUT_MS) * 2);
+  return `${baseMessage}. ` + `The watcher did not answer at all, so it may be unresponsive rather than slow: check \`argus watcher status ${watcher2.id}\` ` + `and \`argus doctor\`. If the watcher is healthy, the expression needs more time; pass a longer timeout as milliseconds or a ` + `duration, for example: \`argus eval ${watcher2.id} --timeout ${formatSuggestedDuration(suggestedTimeoutMs)} ...\``;
 };
 var isTimeoutError = (error) => {
   const message = formatError(error);
@@ -48313,9 +48485,12 @@ var runDomKeydown = defineWatcherCommand({
   formatHuman: (response, { options, output }) => {
     if (options.printEvent) {
       output.writeHuman(`Dispatched keydown event: ${JSON.stringify(response.event)}`);
-      return;
+    } else {
+      output.writeHuman(`Dispatched keydown: ${response.key} (code=${response.code})`);
+    }
+    if (response.activated) {
+      output.writeHuman("Page was hidden and has been activated (as `argus page show`); release it with `argus page hide`.");
     }
-    output.writeHuman(`Dispatched keydown: ${response.key} (code=${response.code})`);
   }
 });
 
@@ -48678,7 +48853,7 @@ var buildScreenshotPlan = (options, output) => {
     path: "/screenshot",
     method: "POST",
     body: {
-      outFile: options.out,
+      outFile: resolveArtifactOutFile(options.out),
       selector,
       clip,
       format: "png"
@@ -48800,7 +48975,7 @@ var snapshotCommands = [
     description: "Capture a screenshot to disk on the watcher",
     arguments: [{ flags: "[id]", description: "Watcher id to query" }],
     options: [
-      { flags: "--out <file>", description: "Output file path (absolute or relative to artifacts directory)" },
+      { flags: "--out <file>", description: "Output file path (absolute, or relative to the current working directory)" },
       { flags: "--selector <selector>", description: "Optional CSS selector for element-only capture" },
       { flags: "--clip <x,y,width,height>", description: "Viewport-relative rectangle crop in CSS pixels" },
       { flags: "--testid <id>", description: `Shorthand for --selector "[data-testid='<id>']"` },
@@ -48915,7 +49090,7 @@ var buildRecordStopPlan = (options, output) => {
     method: "POST",
     body: {
       recordId: normalizeString2(options.recordId),
-      outFile: options.out
+      outFile: resolveArtifactOutFile(options.out)
     },
     timeoutMs: RECORD_STOP_TIMEOUT_MS
   };
@@ -48939,7 +49114,7 @@ var buildRecordBody = (options, output) => {
     return null;
   }
   return {
-    outFile: options.out,
+    outFile: resolveArtifactOutFile(options.out),
     selector,
     clip,
     fps,
@@ -49064,7 +49239,7 @@ var recordCommands = [
     arguments: [{ flags: "[id]", description: "Watcher id to query" }],
     options: [
       { flags: "--duration <duration>", description: "Capture for duration (e.g. 3s, 500ms)" },
-      { flags: "--out <file>", description: "Output .mp4 or .webm path (absolute or relative to artifacts directory)" },
+      { flags: "--out <file>", description: "Output .mp4 or .webm path (absolute, or relative to the current working directory)" },
       { flags: "--selector <selector>", description: "Optional CSS selector for element-only recording" },
       { flags: "--clip <x,y,width,height>", description: "Viewport-relative rectangle crop in CSS pixels" },
       { flags: "--testid <id>", description: `Shorthand for --selector "[data-testid='<id>']"` },
@@ -49089,7 +49264,7 @@ var recordCommands = [
         description: "Start a silent video recording",
         arguments: [{ flags: "[id]", description: "Watcher id to query" }],
         options: [
-          { flags: "--out <file>", description: "Output .mp4 or .webm path (absolute or relative to artifacts directory)" },
+          { flags: "--out <file>", description: "Output .mp4 or .webm path (absolute, or relative to the current working directory)" },
           { flags: "--selector <selector>", description: "Optional CSS selector for element-only recording" },
           { flags: "--clip <x,y,width,height>", description: "Viewport-relative rectangle crop in CSS pixels" },
           { flags: "--testid <id>", description: `Shorthand for --selector "[data-testid='<id>']"` },
@@ -49110,7 +49285,10 @@ var recordCommands = [
         arguments: [{ flags: "[id]", description: "Watcher id to query" }],
         options: [
           { flags: "--record-id <id>", description: "Record id returned from start" },
-          { flags: "--out <file>", description: "Move the saved recording to this .mp4 or .webm path before returning" },
+          {
+            flags: "--out <file>",
+            description: "Move the saved recording to this .mp4 or .webm path (absolute, or relative to the current working directory)"
+          },
           jsonOption
         ],
         examples: ["argus record stop app", "argus record stop app --out demo.mp4 --json"],
@@ -49193,7 +49371,7 @@ var runTraceStartInternal = async (watcher2, options, output) => {
       path: "/trace/start",
       method: "POST",
       body: {
-        outFile: options.out,
+        outFile: resolveArtifactOutFile(options.out),
         categories: options.categories,
         options: options.options
       },
@@ -49211,7 +49389,7 @@ var runTraceStopInternal = async (watcher2, options, output) => {
     const response = await fetchWatcherJson(watcher2, {
       path: "/trace/stop",
       method: "POST",
-      body: { traceId: options.traceId, outFile: options.outFile },
+      body: { traceId: options.traceId, outFile: resolveArtifactOutFile(options.outFile) },
       timeoutMs: 20000
     });
     return response;
@@ -49231,7 +49409,7 @@ var traceCommands = [
     arguments: [{ flags: "[id]", description: "Watcher id to query" }],
     options: [
       { flags: "--duration <duration>", description: "Capture for duration (e.g. 3s, 500ms)" },
-      { flags: "--out <file>", description: "Output trace file path (relative to artifacts base directory)" },
+      { flags: "--out <file>", description: "Output trace file path (absolute, or relative to the current working directory)" },
       { flags: "--categories <categories>", description: "Comma-separated tracing categories" },
       { flags: "--options <options>", description: "Tracing options string" },
       jsonOption
@@ -49246,7 +49424,7 @@ var traceCommands = [
         description: "Start Chrome tracing",
         arguments: [{ flags: "[id]", description: "Watcher id to query" }],
         options: [
-          { flags: "--out <file>", description: "Output trace file path (relative to artifacts base directory)" },
+          { flags: "--out <file>", description: "Output trace file path (absolute, or relative to the current working directory)" },
           { flags: "--categories <categories>", description: "Comma-separated tracing categories" },
           { flags: "--options <options>", description: "Tracing options string" },
           jsonOption
@@ -49262,7 +49440,10 @@ var traceCommands = [
         arguments: [{ flags: "[id]", description: "Watcher id to query" }],
         options: [
           { flags: "--trace-id <id>", description: "Trace id returned from start" },
-          { flags: "--out <file>", description: "Move the saved trace file to this path before returning" },
+          {
+            flags: "--out <file>",
+            description: "Move the saved trace file to this path (absolute, or relative to the current working directory)"
+          },
           jsonOption
         ],
         examples: ["argus trace stop app", "argus trace stop app --out trace.json --json"],
@@ -51238,7 +51419,7 @@ var resolveAutoIframe = (iframes, allTargets) => {
 };
 var scoreIframeTarget = (target, page) => {
   let score = 0;
-  if (originOf(target.url) && originOf(target.url) !== originOf(page?.url)) {
+  if (originOf2(target.url) && originOf2(target.url) !== originOf2(page?.url)) {
     score += 4;
   }
   if (target.title && target.title !== target.url && !target.title.startsWith("http")) {
@@ -51290,7 +51471,7 @@ var statusMatchesTarget = (status2, target) => {
   return Boolean(status2.target.title && status2.target.title === target.title && status2.target.url === target.url);
 };
 var includesIgnoreCase = (value, needle) => value.toLowerCase().includes(needle.toLowerCase());
-var originOf = (url) => {
+var originOf2 = (url) => {
   if (!url) {
     return null;
   }

package/dist/cli/register/recordCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recordCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/recordCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAKjE,eAAO,MAAM,cAAc,EAAE,SAAS,sBAAsB,EA6D3D,CAAA"}
+{"version":3,"file":"recordCommands.d.ts","sourceRoot":"","sources":["../../../src/cli/register/recordCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAKjE,eAAO,MAAM,cAAc,EAAE,SAAS,sBAAsB,EAgE3D,CAAA"}

package/dist/cli/register/recordCommands.js

@@ -8,7 +8,7 @@ export const recordCommands = [
         arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
         options: [
             { flags: '--duration <duration>', description: 'Capture for duration (e.g. 3s, 500ms)' },
-            { flags: '--out <file>', description: 'Output .mp4 or .webm path (absolute or relative to artifacts directory)' },
+            { flags: '--out <file>', description: 'Output .mp4 or .webm path (absolute, or relative to the current working directory)' },
             { flags: '--selector <selector>', description: 'Optional CSS selector for element-only recording' },
             { flags: '--clip <x,y,width,height>', description: 'Viewport-relative rectangle crop in CSS pixels' },
             { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
@@ -33,7 +33,7 @@ export const recordCommands = [
                 description: 'Start a silent video recording',
                 arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
                 options: [
-                    { flags: '--out <file>', description: 'Output .mp4 or .webm path (absolute or relative to artifacts directory)' },
+                    { flags: '--out <file>', description: 'Output .mp4 or .webm path (absolute, or relative to the current working directory)' },
                     { flags: '--selector <selector>', description: 'Optional CSS selector for element-only recording' },
                     { flags: '--clip <x,y,width,height>', description: 'Viewport-relative rectangle crop in CSS pixels' },
                     { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },
@@ -54,7 +54,10 @@ export const recordCommands = [
                 arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
                 options: [
                     { flags: '--record-id <id>', description: 'Record id returned from start' },
-                    { flags: '--out <file>', description: 'Move the saved recording to this .mp4 or .webm path before returning' },
+                    {
+                        flags: '--out <file>',
+                        description: 'Move the saved recording to this .mp4 or .webm path (absolute, or relative to the current working directory)',
+                    },
                     jsonOption,
                 ],
                 examples: ['argus record stop app', 'argus record stop app --out demo.mp4 --json'],

package/dist/cli/register/recordCommands.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordCommands.js","sourceRoot":"","sources":["../../../src/cli/register/recordCommands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recordCommands.js","sourceRoot":"","sources":["../../../src/cli/register/recordCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAsC;IAChE;QACC,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,yDAAyD;QACtE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;QAClE,OAAO,EAAE;YACR,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,uCAAuC,EAAE;YACxF,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,oFAAoF,EAAE;YAC5H,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,kDAAkD,EAAE;YACnG,EAAE,KAAK,EAAE,2BAA2B,EAAE,WAAW,EAAE,gDAAgD,EAAE;YACrG,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mDAAmD,EAAE;YAC5F,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,6CAA6C,EAAE;YAClF,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,yEAAyE,EAAE;YACtH,UAAU;SACV;QACD,QAAQ,EAAE;YACT,+CAA+C;YAC/C,qEAAqE;YACrE,qEAAqE;YACrE,gEAAgE;SAChE;QACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;gBAAE,OAAM;YACnC,MAAM,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7B,CAAC;QACD,WAAW,EAAE;YACZ;gBACC,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,gCAAgC;gBAC7C,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;gBAClE,OAAO,EAAE;oBACR,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,oFAAoF,EAAE;oBAC5H,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,kDAAkD,EAAE;oBACnG,EAAE,KAAK,EAAE,2BAA2B,EAAE,WAAW,EAAE,gDAAgD,EAAE;oBACrG,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mDAAmD,EAAE;oBAC5F,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,6CAA6C,EAAE;oBAClF,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,yEAAyE,EAAE;oBACtH,UAAU;iBACV;gBACD,QAAQ,EAAE,CAAC,6DAA6D,CAAC;gBACzE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;oBAC7B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;wBAAE,OAAM;oBACnC,MAAM,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBAClC,CAAC;aACD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,iCAAiC;gBAC9C,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;gBAClE,OAAO,EAAE;oBACR,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,+BAA+B,EAAE;oBAC3E;wBACC,KAAK,EAAE,cAAc;wBACrB,WAAW,EAAE,8GAA8G;qBAC3H;oBACD,UAAU;iBACV;gBACD,QAAQ,EAAE,CAAC,uBAAuB,EAAE,6CAA6C,CAAC;gBAClF,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE;oBAC7B,MAAM,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;gBACjC,CAAC;aACD;SACD;KACD;CACD,CAAA"}

package/dist/cli/register/snapshotCommands.js

@@ -8,7 +8,7 @@ export const snapshotCommands = [
         description: 'Capture a screenshot to disk on the watcher',
         arguments: [{ flags: '[id]', description: 'Watcher id to query' }],
         options: [
-            { flags: '--out <file>', description: 'Output file path (absolute or relative to artifacts directory)' },
+            { flags: '--out <file>', description: 'Output file path (absolute, or relative to the current working directory)' },
             { flags: '--selector <selector>', description: 'Optional CSS selector for element-only capture' },
             { flags: '--clip <x,y,width,height>', description: 'Viewport-relative rectangle crop in CSS pixels' },
             { flags: '--testid <id>', description: 'Shorthand for --selector "[data-testid=\'<id>\']"' },