@swmansion/argent 0.26.1-next.8 → 0.27.0

package/dist/installer.mjs

@@ -16730,7 +16730,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.26.1-next.8";
+    return "0.27.0";
   }
   return "0.0.0";
 }
@@ -23224,9 +23224,13 @@ async function terminatePid(pid, stillOurs) {
 }
 async function killToolServer(bundlePath) {
   const state2 = await readState(bundlePath);
-  if (!state2) return;
-  await terminatePid(state2.pid);
+  if (!state2) return false;
+  const stillOurs = () => couldBeOurToolServer(state2.pid, state2.bundlePath);
+  const alive = isProcessAlive(state2.pid);
+  if (alive && !stillOurs()) return false;
+  if (alive) await terminatePid(state2.pid, stillOurs);
   await clearToolsServerState(bundlePath ?? state2.bundlePath);
+  return alive;
 }
 function isPathWithin(child, parent) {
   const rel = path18.relative(parent, child);
@@ -23263,8 +23267,10 @@ async function killToolServerForInstallDir(packageDir) {
 }
 var PS_BIN = ["/bin/ps", "/usr/bin/ps"].find((p) => fs17.existsSync(p)) ?? "ps";
 var PS_WIDTH_FLAGS = ["-ww"];
-function readProcessCommandLine(pid, flags = PS_WIDTH_FLAGS) {
+var PS_LOCALE = process.platform === "darwin" ? "en_US.UTF-8" : "C.UTF-8";
+function readProcessCommandLine(pid, flags = PS_WIDTH_FLAGS, env = { ...process.env, LC_ALL: PS_LOCALE }) {
   return execFileSync5(PS_BIN, [...flags, "-p", String(pid), "-o", "command="], {
+    env,
     encoding: "utf8",
     timeout: 2e3,
     // A recycled pid can sit on a process with an argv past Node's 1 MiB exec
@@ -23279,19 +23285,27 @@ function readProcessCommandLine(pid, flags = PS_WIDTH_FLAGS) {
 function couldBeOurToolServer(pid, marker) {
   if (!marker) return false;
   if (process.platform === "win32") return true;
-  let cmd;
-  try {
-    cmd = readProcessCommandLine(pid);
-  } catch (err) {
+  const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const ours = new RegExp(`(?:^|[\\t\\n\\v\\f\\r ])${escaped} start(?:[\\t\\n\\v\\f\\r ]|$)`);
+  const nonAscii = [...marker].some((c2) => c2.charCodeAt(0) > 127);
+  let failure;
+  for (const env of [void 0, process.env]) {
+    try {
+      if (ours.test(readProcessCommandLine(pid, PS_WIDTH_FLAGS, env))) return true;
+      failure = void 0;
+      if (!nonAscii) break;
+    } catch (err) {
+      failure = String(err);
+      if (err.code === "ETIMEDOUT") break;
+    }
+  }
+  if (failure !== void 0) {
     process.stderr.write(
-      `[launcher] ps could not read pid ${pid}'s command line; leaving it alone: ${String(err)}
+      `[launcher] ps could not read pid ${pid}'s command line; leaving it alone: ${failure}
 `
     );
-    return false;
   }
-  if (!cmd) return false;
-  const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return new RegExp(`(?:^|\\s)${escaped} start(?:\\s|$)`).test(cmd);
+  return false;
 }
 
 // ../argent-tools-client/src/link-config.ts

package/dist/mcp-server.mjs

@@ -15932,7 +15932,9 @@ function spawnToolsServer(paths, port, options = {}) {
     } catch {
       logFd = fs.openSync("/dev/null", "w");
     }
-    const child = spawn("node", [paths.bundlePath, "start"], {
+    const { bun, deno, electron } = process.versions;
+    const nodeBin = !(bun || deno || electron) && fs.existsSync(process.execPath) ? process.execPath : "node";
+    const child = spawn(nodeBin, [paths.bundlePath, "start"], {
       detached: true,
       stdio: ["ignore", "pipe", logFd],
       env: buildToolsServerEnv(paths, port, process.env, options)
@@ -15940,7 +15942,14 @@ function spawnToolsServer(paths, port, options = {}) {
     child.unref();
     const pid = child.pid;
     if (!pid) {
-      reject(new Error("Failed to get PID of spawned tools server"));
+      child.once(
+        "error",
+        (err) => reject(
+          new Error(
+            err.code === "ENOENT" && nodeBin === "node" ? "Could not start the argent tool-server: `node` was not found on PATH. Install Node.js 20+ or add it to PATH." : `Could not start the argent tool-server: ${err.message}`
+          )
+        )
+      );
       return;
     }
     let settled = false;
@@ -16095,8 +16104,10 @@ async function terminatePid(pid, stillOurs) {
 }
 var PS_BIN = ["/bin/ps", "/usr/bin/ps"].find((p) => fs.existsSync(p)) ?? "ps";
 var PS_WIDTH_FLAGS = ["-ww"];
-function readProcessCommandLine(pid, flags = PS_WIDTH_FLAGS) {
+var PS_LOCALE = process.platform === "darwin" ? "en_US.UTF-8" : "C.UTF-8";
+function readProcessCommandLine(pid, flags = PS_WIDTH_FLAGS, env = { ...process.env, LC_ALL: PS_LOCALE }) {
   return execFileSync(PS_BIN, [...flags, "-p", String(pid), "-o", "command="], {
+    env,
     encoding: "utf8",
     timeout: 2e3,
     // A recycled pid can sit on a process with an argv past Node's 1 MiB exec
@@ -16111,19 +16122,27 @@ function readProcessCommandLine(pid, flags = PS_WIDTH_FLAGS) {
 function couldBeOurToolServer(pid, marker) {
   if (!marker) return false;
   if (process.platform === "win32") return true;
-  let cmd;
-  try {
-    cmd = readProcessCommandLine(pid);
-  } catch (err) {
+  const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const ours = new RegExp(`(?:^|[\\t\\n\\v\\f\\r ])${escaped} start(?:[\\t\\n\\v\\f\\r ]|$)`);
+  const nonAscii = [...marker].some((c) => c.charCodeAt(0) > 127);
+  let failure;
+  for (const env of [void 0, process.env]) {
+    try {
+      if (ours.test(readProcessCommandLine(pid, PS_WIDTH_FLAGS, env))) return true;
+      failure = void 0;
+      if (!nonAscii) break;
+    } catch (err) {
+      failure = String(err);
+      if (err.code === "ETIMEDOUT") break;
+    }
+  }
+  if (failure !== void 0) {
     process.stderr.write(
-      `[launcher] ps could not read pid ${pid}'s command line; leaving it alone: ${String(err)}
+      `[launcher] ps could not read pid ${pid}'s command line; leaving it alone: ${failure}
 `
     );
-    return false;
   }
-  if (!cmd) return false;
-  const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  return new RegExp(`(?:^|\\s)${escaped} start(?:\\s|$)`).test(cmd);
+  return false;
 }
 var LOCK_WAIT_TIMEOUT_MS = 3e4;
 var LOCK_STALE_MS = 45e3;
@@ -16796,7 +16815,7 @@ function sha256File(filePath) {
     createReadStream(filePath).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve8(hash.digest("hex"))).on("error", reject);
   });
 }
-async function uploadTar(tarPath, endpoint) {
+async function uploadTar(tarPath, endpoint, signal) {
   const init = {
     method: "POST",
     headers: {
@@ -16804,7 +16823,8 @@ async function uploadTar(tarPath, endpoint) {
       ...endpoint.token ? { Authorization: `Bearer ${endpoint.token}` } : {}
     },
     body: createReadStream(tarPath),
-    duplex: "half"
+    duplex: "half",
+    signal
   };
   const res = await fetch(`${endpoint.url}/upload`, init);
   if (!res.ok) {
@@ -16856,7 +16876,7 @@ async function prepareFileInputs(specs, args, opts) {
           );
           tarPath = await tarball(filePath);
           wire.contentHash = await sha256File(tarPath);
-          wire.uploadId = await uploadTar(tarPath, opts.uploadEndpoint);
+          wire.uploadId = await uploadTar(tarPath, opts.uploadEndpoint, opts.signal);
         } finally {
           if (tarPath) await rm2(tarPath, { force: true }).catch(() => {
           });
@@ -17524,7 +17544,8 @@ async function materializeArtifacts(result, ctx) {
             return null;
           }
           const res = await fetchFn(`${ctx.toolsUrl}/artifacts/${value.id}`, {
-            headers: authHeaders2
+            headers: authHeaders2,
+            signal: ctx.signal
           });
           if (!res.ok) return null;
           const data = await readCapped(res, value.size);
@@ -17551,7 +17572,8 @@ async function materializeArtifacts(result, ctx) {
       }
       try {
         const res = await fetchFn(`${ctx.toolsUrl}/artifacts/${value.id}`, {
-          headers: authHeaders2
+          headers: authHeaders2,
+          signal: ctx.signal
         });
         if (!res.ok) return null;
         const data = Buffer.from(await res.arrayBuffer());

package/dist/tool-server.cjs

@@ -73390,6 +73390,9 @@ function resolveDevice(udid) {
 function isIosPhysicalDevice(device) {
   return device.platform === "ios" && device.kind === "device";
 }
+function isIosSimulator(device) {
+  return device.platform === "ios" && device.kind === "simulator" || device.platform === "ios-remote";
+}
 function parseChromiumCdpPort(udid) {
   if (!udid.startsWith(CHROMIUM_ID_PREFIX)) return null;
   const tail = udid.slice(CHROMIUM_ID_PREFIX.length);
@@ -94811,7 +94814,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.26.1-next.8";
+    return "0.27.0";
   }
   return "0.0.0";
 }
@@ -96171,7 +96174,7 @@ var import_node_path6 = __toESM(require("node:path"));
 var import_semver2 = __toESM(require_semver2());
 
 // ../tool-server/package.json
-var version2 = "0.26.0";
+var version2 = "0.27.0";
 
 // ../tool-server/src/utils/update-checker.ts
 var import_update_core = __toESM(require_dist4());
@@ -96626,6 +96629,7 @@ var path11 = __toESM(require("node:path"));
 var import_node_child_process7 = require("node:child_process");
 var import_node_util6 = require("node:util");
 init_external_devices();
+init_device_info();
 var execFileAsync6 = (0, import_node_util6.promisify)(import_node_child_process7.execFile);
 async function listDeviceSetSimulators(deviceSet) {
   if (deviceSet && !fs12.existsSync(deviceSet)) return [];
@@ -96686,11 +96690,15 @@ var runtimeKindCache = /* @__PURE__ */ new Map();
 async function getSimulatorRuntimeKind(udid) {
   const cached3 = runtimeKindCache.get(udid);
   if (cached3) return cached3;
-  const listing = isExternalId(udid) ? await listDeviceSetSimulators(await deviceSetForUdid(udid)) : await listIosSimulators();
-  const kind = listing.find((s) => s.udid === externalNativeId(udid))?.runtimeKind;
+  const kind = (await findIosSimulator(udid))?.runtimeKind;
   if (kind) runtimeKindCache.set(udid, kind);
   return kind;
 }
+async function findIosSimulator(udid) {
+  const listing = isExternalId(udid) ? await listDeviceSetSimulators(await deviceSetForUdid(udid)) : await listIosSimulators();
+  const native = externalNativeId(udid);
+  return listing.find((s) => s.udid === native);
+}
 async function isTvOsSimulator(udid) {
   return await getSimulatorRuntimeKind(udid) === "tv";
 }
@@ -96754,11 +96762,11 @@ async function isFoldableDeviceType(identifier) {
   return foldable;
 }
 async function isFoldableSimulator(udid) {
+  const device = resolveDevice(udid);
+  if (device.platform !== "ios" || device.kind !== "simulator") return false;
   const cached3 = foldableCache.get(udid);
   if (cached3 !== void 0) return cached3;
-  const listing = isExternalId(udid) ? await listDeviceSetSimulators(await deviceSetForUdid(udid)) : await listIosSimulators();
-  const native = externalNativeId(udid);
-  const found = listing.find((s) => s.udid === native);
+  const found = await findIosSimulator(udid);
   const foldable = found?.foldable === true;
   if (found) foldableCache.set(udid, foldable);
   return foldable;
@@ -108053,14 +108061,16 @@ async function pointerPost(api, body, signal) {
     return false;
   }
 }
-async function setSimulatorClipboardText(api, text, signal) {
+var SENSITIVE_TEXT_REFUSED = "refused to set sensitive text";
+async function setSimulatorClipboardText(api, text, options = {}) {
+  const { sensitive = false, signal } = options;
   if (api.external) assertAllowedSimServerEndpoint("/api/clipboard/text");
   let res;
   try {
     res = await fetch(`${api.apiUrl}/api/clipboard/text`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ text }),
+      body: JSON.stringify(sensitive ? { text, sensitive } : { text }),
       signal
     });
   } catch (err) {
@@ -108079,6 +108089,7 @@ async function setSimulatorClipboardText(api, text, signal) {
     );
   }
   const body = await res.json().catch(() => null);
+  if (sensitive && body?.error?.includes(SENSITIVE_TEXT_REFUSED)) return "refused";
   if (!res.ok || body?.status !== "ok") {
     throw new FailureError(
       `Paste failed: could not set the device clipboard (${body?.error ?? `HTTP ${res.status}`}).`,
@@ -108090,6 +108101,7 @@ async function setSimulatorClipboardText(api, text, signal) {
       }
     );
   }
+  return "set";
 }
 async function simulatorPost(toolLabel, api, endpoint, reqBody, signal, fallbackHint) {
   if (api.external) assertAllowedSimServerEndpoint(endpoint);
@@ -125806,10 +125818,12 @@ var pasteZodSchema = external_exports.object({
 });
 
 // ../tool-server/src/tools/paste/platforms/ios.ts
+init_src2();
 var LEFT_GUI_KEYCODE = 227;
 var V_KEYCODE = charToKeyPress("v").keyCode;
 var CHORD_STEP_MS = 50;
 var sleep10 = (ms) => new Promise((r) => setTimeout(r, ms));
+var typesAsText = (char) => !"\n\r	".includes(char) && !!charToKeyPress(char);
 function rejectTv(device) {
   throw new UnsupportedOperationError(
     "paste",
@@ -125817,8 +125831,22 @@ function rejectTv(device) {
     "tvOS has no pasteboard to paste from \u2014 type into the focused field with keyboard instead"
   );
 }
-async function pasteSimulator(api, text) {
-  await setSimulatorClipboardText(api, text);
+async function pasteSimulator(registry2, device, api, params) {
+  const sensitive = params.hasSecrets === true;
+  if (await setSimulatorClipboardText(api, params.text, { sensitive }) === "refused") {
+    if (![...params.text].every(typesAsText)) {
+      throw new InvalidToolInputError(
+        "Paste failed: Device Hub has opened this simulator, so a secret is typed instead of pasted, and this secret holds a newline, a tab or a character the keyboard cannot type. Nothing was typed.",
+        {
+          error_code: FAILURE_CODES.KEYBOARD_CHARACTER_UNSUPPORTED,
+          failure_stage: "paste_secret_typed_simulator",
+          error_kind: "unsupported"
+        }
+      );
+    }
+    await typeSimulatorServer(registry2, device, { udid: params.udid, text: params.text });
+    return { pasted: true, via: "keyboard" };
+  }
   await api.pressKey("Down", LEFT_GUI_KEYCODE);
   await sleep10(CHORD_STEP_MS);
   await api.pressKey("Down", V_KEYCODE);
@@ -125838,7 +125866,7 @@ function makeIosImpl4(registry2) {
       if (await isTvOsSimulator(device.id)) rejectTv(device);
       const ref = simulatorServerRef(device);
       const api = await registry2.resolveService(ref.urn, ref.options);
-      return pasteSimulator(api, params.text);
+      return pasteSimulator(registry2, device, api, params);
     }
   };
 }
@@ -125930,9 +125958,9 @@ function createPasteTool(registry2) {
       completedMsg: () => "Pasted text",
       failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to paste text: ${failureSignal2.error_code}`
     },
-    description: `Paste text into the focused field: puts \`text\` on the DEVICE clipboard (the host clipboard is untouched), then triggers the platform's paste shortcut (iOS simulator, Android emulator).
+    description: `Paste text into the focused field: puts \`text\` on the DEVICE clipboard, then triggers the platform's paste shortcut (iOS simulator, Android emulator).
 Do NOT use this in place of \`keyboard\`. \`keyboard\` types as a user would and is the default for all text entry; use \`paste\` only where a real user would paste \u2014 a 2FA/OTP code copied from another app, a long link or token, or when testing the app's own paste handling.
-Tap the field first so it has focus. Returns { pasted: true }. Fails on a TV target, when the device clipboard cannot be set, or when the simulator-server build lacks clipboard support.
+Tap the field first so it has focus. Returns { pasted: true }, plus via: "keyboard" when a secret was typed instead of pasted. Fails on a TV target, when the device clipboard cannot be set, when a secret that has to be typed holds a character that cannot be typed, or when the simulator-server build lacks clipboard support.
 Supports \`{{secret:<NAME>}}\` placeholders like \`keyboard\`; the value is never echoed back.`,
     searchHint: "paste clipboard pasteboard otp 2fa code fill field",
     zodSchema: pasteZodSchema,
@@ -125943,7 +125971,7 @@ Supports \`{{secret:<NAME>}}\` placeholders like \`keyboard\`; the value is neve
       return serializedPerDevice(params.udid, async () => {
         if (secrets.length === 0) return dispatch(services, params, options);
         try {
-          return await dispatch(services, { ...params, text }, options);
+          return await dispatch(services, { ...params, text, hasSecrets: true }, options);
         } catch (err) {
           throw redactSecretsFromError(err, secrets);
         }
@@ -134469,22 +134497,36 @@ function buildTextTree(data, opts) {
     }
   }
   const lines = [];
-  const turn = opts.uiOrientation && opts.uiOrientation !== "unknown" && opts.uiOrientation !== "ambiguous" ? opts.uiOrientation : void 0;
+  const turn = opts.uiOrientation && opts.uiOrientation !== "unknown" && opts.uiOrientation !== "ambiguous" && opts.uiOrientation !== "mismatched" ? opts.uiOrientation : void 0;
   if (canNormalize) {
     lines.push(`Screen: ${screenW}x${screenH}`);
-    if (turn && turn !== "portrait") {
+    if (opts.uiOrientation === "mismatched") {
+      lines.push(
+        "Note: The udid is not the UDID of the simulator that shows this app. Thus, the tool did not use the udid. If the UI is landscape, the tap points are not correct. The describe tool gives correct tap points. This tool also gives correct tap points with the UDID of the simulator that shows this app."
+      );
+    } else if (turn && turn !== "portrait") {
       lines.push(
         `The UI is ${turn} on the screen. The tap points are on the screen's axes, which the gesture tools use.`
       );
     } else if (opts.uiOrientation === "ambiguous" && screenW > screenH) {
       lines.push(
-        "Note: the UI is landscape, and two booted simulators have this device's name, so its orientation could not be read. The tap points are on the UI's axes, so a tap can miss. Call again with the simulator's udid, or use describe for tap points."
+        "Note: the UI is landscape, and two booted simulators have this device's name, so its orientation could not be read. The tap points are on the UI's axes, so a tap can miss. Use describe for tap points, or call again with the udid of the simulator that shows this app."
       );
     } else if (opts.uiOrientation === "unknown" && screenW > screenH) {
       lines.push(
         "Note: the UI is landscape, and its orientation could not be read. The tap points are on the UI's axes, so a tap can miss. Use describe for tap points."
       );
     }
+    if (opts.readInsteadOfUdid) {
+      lines.push(
+        `Note: the udid is not the UDID of the simulator that shows this app. The tool used ${opts.readInsteadOfUdid}, the UDID of that simulator.`
+      );
+    }
+    if (opts.udidUnchecked && (screenW > screenH || turn !== void 0 && turn !== "portrait")) {
+      lines.push(
+        "Note: two booted simulators have this device's name, so the tool could not check that the udid is the simulator that shows this app. If it is another simulator, a tap can miss. Use describe for tap points."
+      );
+    }
     lines.push("");
   }
   function formatLabel2(c) {
@@ -134588,14 +134630,57 @@ async function debuggedBundleId(api, appName) {
 }
 var BUNDLE_ID_NAMED_TARGET = /^[\w-]+(\.[\w-]+)+( \(|$)/;
 var AMBIGUOUS_SIMULATOR = "ambiguous-simulator";
-function isIosSimulator(device) {
-  return device.platform === "ios" && device.kind === "simulator" || device.platform === "ios-remote";
-}
+var MISMATCHED_UDID = "mismatched-udid";
+var UNLISTED_UDID = "unlisted-udid";
 async function iosSimulatorOf(app) {
-  if (app.udid) {
-    const named2 = resolveDevice(app.udid);
-    return isIosSimulator(named2) ? named2 : void 0;
+  if (!app.udid) {
+    const session2 = await iosSimulatorOfSession(app);
+    return session2 === AMBIGUOUS_SIMULATOR || !session2 ? session2 : { device: session2 };
+  }
+  const named = resolveDevice(app.udid);
+  const own = resolveDevice(canonicalDeviceId(app.deviceId) ?? app.deviceId);
+  if (isIosSimulator(own)) {
+    if (own.id === named.id) return { device: own };
+    if (isIosSimulator(named)) {
+      const [listed2, ownListed] = await Promise.all([
+        listedAs(named, app.deviceName),
+        listedAs(own, app.deviceName)
+      ]);
+      if (listed2 === "booted" && ownListed !== "booted") return { device: named };
+    }
+    return { device: own, readInsteadOfUdid: own.id };
   }
+  const [listed, session] = await Promise.all([
+    isIosSimulator(named) ? listedAs(named, app.deviceName) : void 0,
+    iosSimulatorOfSession(app)
+  ]);
+  if (listed === "booted" || listed === "twin") {
+    const sole = session === void 0 || session !== AMBIGUOUS_SIMULATOR && session.id === named.id;
+    return listed === "booted" && sole ? { device: named } : { device: named, udidUnchecked: true };
+  }
+  if (session === AMBIGUOUS_SIMULATOR) return MISMATCHED_UDID;
+  if (session) {
+    return session.id === named.id ? { device: session } : { device: session, readInsteadOfUdid: session.id };
+  }
+  return listed === "unlisted" ? UNLISTED_UDID : void 0;
+}
+async function listedAs(device, name) {
+  if (device.platform !== "ios-remote") {
+    const sim2 = await findIosSimulator(device.id);
+    if (!sim2) return "unlisted";
+    return sim2.state === "Booted" && sim2.name === name ? "booted" : "other";
+  }
+  const listing = Object.values(
+    (await simctlListDevices({ timeoutMs: ORIENTATION_READ_TIMEOUT_MS }).catch(() => ({
+      devices: {}
+    }))).devices
+  ).flat();
+  const sim = listing.find((d) => d.udid === stripRemotePrefix(device.id));
+  if (!sim) return "unlisted";
+  if (sim.state !== "Booted" || sim.name !== name) return "other";
+  return listing.some((d) => d !== sim && d.state === "Booted" && d.name === name) ? "twin" : "booted";
+}
+async function iosSimulatorOfSession(app) {
   const device = resolveDevice(canonicalDeviceId(app.deviceId) ?? app.deviceId);
   if (isIosSimulator(device)) return device;
   const logicalKeyed = app.deviceId === app.logicalDeviceId || isLogicalKeyedDevice(app.deviceId);
@@ -134608,22 +134693,28 @@ async function iosSimulatorOf(app) {
 }
 async function readTapAxes(registry2, app) {
   const read = (async () => {
-    const device = await iosSimulatorOf(app);
-    if (device === void 0) return void 0;
-    if (device === AMBIGUOUS_SIMULATOR) return "ambiguous";
+    const pick2 = await iosSimulatorOf(app);
+    if (pick2 === void 0) return {};
+    if (pick2 === AMBIGUOUS_SIMULATOR) return { uiOrientation: "ambiguous" };
+    if (pick2 === MISMATCHED_UDID) return { uiOrientation: "mismatched" };
+    if (pick2 === UNLISTED_UDID) return { uiOrientation: "unknown" };
+    const { device, ...udid } = pick2;
     const ref = nativeDevtoolsRef(device);
     const api = await registry2.resolveService(ref.urn, ref.options);
     const bundleId = await debuggedBundleId(api, app.appName);
-    if (!bundleId) return "unknown";
+    if (!bundleId) return { uiOrientation: "unknown", ...udid };
     const raw = await api.queryViewHierarchy(bundleId, "ViewHierarchy.getFullHierarchy", {
       fields: ["className"],
       maxDepth: 1
     });
-    return asUiOrientation(raw?.screen?.interfaceOrientation) ?? "unknown";
-  })().catch(() => "unknown");
+    return {
+      uiOrientation: asUiOrientation(raw?.screen?.interfaceOrientation) ?? "unknown",
+      ...udid
+    };
+  })().catch(() => ({ uiOrientation: "unknown" }));
   let timer;
   const timeout = new Promise((resolve14) => {
-    timer = setTimeout(() => resolve14("unknown"), ORIENTATION_READ_TIMEOUT_MS);
+    timer = setTimeout(() => resolve14({ uiOrientation: "unknown" }), ORIENTATION_READ_TIMEOUT_MS);
   });
   try {
     return await Promise.race([read, timeout]);
@@ -134637,7 +134728,7 @@ var zodSchema34 = external_exports.object({
     "Device id from list-devices \u2014 the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial)."
   ),
   udid: external_exports.string().optional().describe(
-    "iOS simulator UDID from list-devices. Pass it when device_id is a logicalDeviceId (two or more devices share one Metro), so that the tap coordinates of a landscape UI are on the screen's axes."
+    "iOS simulator UDID from list-devices. Pass it when device_id is a logicalDeviceId (two or more devices share one Metro), so that the tap coordinates of a landscape UI are on the screen's axes. Give the UDID of the simulator that shows the app."
   ),
   onScreenOnly: external_exports.boolean().default(true).describe(
     "When true (default), only components visible on screen are returned. Set to false to include all mounted components including those scrolled off-screen. Useful when you need to understand the full page structure."
@@ -134716,7 +134807,7 @@ Use when you need tap coordinates for a React Native UI element. Returns a compa
         onScreenOnly: params.onScreenOnly,
         maxNodes: params.maxNodes,
         includeSkipped: params.includeSkipped,
-        uiOrientation: await tapAxes
+        ...await tapAxes
       });
       const deviceLine = [
         `device: ${api.deviceName}`,
@@ -150259,7 +150350,7 @@ async function runSwipe(env, step) {
     toPoint = p;
   }
   const orientation = env.lastRead?.uiOrientation;
-  if (settle.warning !== void 0 && step.direction) {
+  if (settle.warning !== void 0 && step.direction && isIosSimulator(env.device)) {
     settle = { ...settle, warning: `${settle.warning} ${unreadOrientationNote(orientation)}` };
   }
   let start2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.26.1-next.8",
+  "version": "0.27.0",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",
@@ -9,6 +9,31 @@
     "url": "git+https://github.com/software-mansion/argent.git"
   },
   "type": "module",
+  "exports": {
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./assets/manifest": "./assets/manifest.json",
+    "./assets/trace-processor/engine": "./assets/trace-processor/engine.mjs",
+    "./assets/trace-processor/engine_bundle.node": "./assets/trace-processor/engine_bundle.node.js",
+    "./bin/argent-simulator-server": "./bin/argent-simulator-server.cjs",
+    "./dist/bundled-paths": "./dist/bundled-paths.js",
+    "./dist/cli": "./dist/cli.js",
+    "./dist/cli-cmds": "./dist/cli-cmds.mjs",
+    "./dist/fatal-handlers": "./dist/fatal-handlers.js",
+    "./dist/flow-script-runner": "./dist/flow-script-runner.mjs",
+    "./dist/flow-script-watchdog-deadline": "./dist/flow-script-watchdog-deadline.mjs",
+    "./dist/flow-script-watchdog-lifeline": "./dist/flow-script-watchdog-lifeline.mjs",
+    "./dist/installer": "./dist/installer.mjs",
+    "./dist/installer-help": "./dist/installer-help.js",
+    "./dist/mcp-server": "./dist/mcp-server.mjs",
+    "./dist/preview-ui/theme": "./dist/preview-ui/theme.css",
+    "./dist/preview-window/main": "./dist/preview-window/main.cjs",
+    "./dist/tool-server": "./dist/tool-server.cjs",
+    "./package": "./package.json",
+    "./*": "./*"
+  },
   "bin": {
     "argent": "dist/cli.js",
     "argent-simulator-server": "bin/argent-simulator-server.cjs"
@@ -54,6 +79,7 @@
   },
   "devDependencies": {
     "@argent/cli": "file:../argent-cli",
+    "@argent/configuration-core": "file:../configuration-core",
     "@argent/installer": "file:../argent-installer",
     "@argent/mcp": "file:../argent-mcp",
     "@argent/tools-client": "file:../argent-tools-client",

package/skills/argent-device-interact/SKILL.md

@@ -185,7 +185,7 @@ Where the value is read from, and the rules for using a placeholder — includin
 { "udid": "<UDID>", "text": "482913" }
 ```
 
-Puts `text` on the **device** clipboard (the host clipboard is untouched) and triggers the platform's paste shortcut. iOS simulator and Android emulator only; a TV target, a physical device, Chromium and Vega are rejected.
+Puts `text` on the **device** clipboard and triggers the platform's paste shortcut. iOS simulator and Android emulator only; a TV target, a physical device, Chromium and Vega are rejected.
 
 `paste` is **not** a faster `keyboard`. `keyboard` types the way a user types and stays the default for every text entry — a search query, a login, a form field. Reach for `paste` only where a real user would paste: a 2FA / OTP code copied from another app, a long link or token, or to test how the app handles pasted input. It also carries what `keyboard` can't type on a given platform (multi-line text, non-ASCII on Android), but that alone is not a reason to paste — ask whether the user would.