@swmansion/argent 0.22.2-next.9 → 0.23.1-next.0

package/README.md

@@ -23,7 +23,7 @@ Argent drives a growing set of targets through a single toolkit, each with the r
 
 | Platform          | Targets                                                                 | Interaction      |
 | ----------------- | ----------------------------------------------------------------------- | ---------------- |
-| **iOS**           | Simulators                                                              | Touch / gesture  |
+| **iOS**           | Simulators and physical iPhones (USB)                                   | Touch / gesture  |
 | **Android**       | Emulators (AVDs) and physical devices over adb                          | Touch / gesture  |
 | **TV**            | Apple TV (tvOS), Android TV / Google TV, Amazon Fire TV (Vega)          | D-pad / remote   |
 | **Desktop & web** | Electron and Chromium apps (incl. React Native Web / Expo web) over CDP | Mouse / keyboard |

package/dist/cli-cmds.mjs

@@ -2290,6 +2290,18 @@ var FAILURE_CODES = {
   SIMULATOR_COMMAND_REJECTED: "SIMULATOR_COMMAND_REJECTED",
   SIMULATOR_COMMAND_ACK_TIMEOUT: "SIMULATOR_COMMAND_ACK_TIMEOUT",
   SIMULATOR_COMMAND_TRANSPORT_FAILED: "SIMULATOR_COMMAND_TRANSPORT_FAILED",
+  // Physical iOS devices: the XCUITest-runner blueprint lifecycle, the runner
+  // command client, and the `xcrun devicectl` subprocess wrapper (simulators
+  // use the SIMULATOR_* set).
+  IOS_DEVICE_RUNNER_FACTORY_OPTIONS_MISSING: "IOS_DEVICE_RUNNER_FACTORY_OPTIONS_MISSING",
+  IOS_DEVICE_RUNNER_NOT_READY: "IOS_DEVICE_RUNNER_NOT_READY",
+  IOS_DEVICE_RUNNER_TERMINATED: "IOS_DEVICE_RUNNER_TERMINATED",
+  IOS_DEVICE_RUNNER_EXITED: "IOS_DEVICE_RUNNER_EXITED",
+  // The runner answered a command with an ok:false envelope.
+  IOS_DEVICE_RUNNER_COMMAND_FAILED: "IOS_DEVICE_RUNNER_COMMAND_FAILED",
+  // The usbmux or HTTP exchange with a reachable runner failed.
+  IOS_DEVICE_RUNNER_TRANSPORT_FAILED: "IOS_DEVICE_RUNNER_TRANSPORT_FAILED",
+  IOS_DEVICECTL_COMMAND_FAILED: "IOS_DEVICECTL_COMMAND_FAILED",
   AX_QUERY_TIMEOUT: "AX_QUERY_TIMEOUT",
   AX_DAEMON_READY_TIMEOUT: "AX_DAEMON_READY_TIMEOUT",
   AX_DAEMON_EXITED_BEFORE_READY: "AX_DAEMON_EXITED_BEFORE_READY",
@@ -2460,6 +2472,7 @@ var FAILURE_CODES = {
   KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
   KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
   KEYBOARD_TEXT_AND_KEY_COMBINED: "KEYBOARD_TEXT_AND_KEY_COMBINED",
+  KEYBOARD_INPUT_NOT_FOCUSED: "KEYBOARD_INPUT_NOT_FOCUSED",
   SECRET_PLACEHOLDER_UNKNOWN: "SECRET_PLACEHOLDER_UNKNOWN",
   SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
@@ -2504,7 +2517,9 @@ var FAILURE_COMMANDS = [
   "electron",
   "npm",
   "npx",
-  "unknown"
+  "unknown",
+  "devicectl",
+  "xcodebuild"
 ];
 var FAILURE_SIGNAL_NAMES = [
   "SIGABRT",
@@ -3292,6 +3307,14 @@ var CONFIG_SCHEMA = [
     // drained/reset, not just the file rewritten.
     manageCommand: "argent telemetry"
   },
+  {
+    key: "allowlist.enabled",
+    description: "Whether `argent update` re-applies editor auto-approve allowlist rules. Unset (the default) keeps the current behavior: update refreshes the rules for editors that already have argent configured. Set to `false` to keep update from touching editor allowlists. `false` in either scope wins, so a committed project opt-out holds for every teammate.",
+    scopes: ["project", "global"],
+    parse: asBoolean,
+    merge: "prioritize-restrictive",
+    example: "false"
+  },
   {
     key: "lens.agent",
     description: "Coding-agent id remembered by `argent lens` to skip the picker.",
@@ -7217,7 +7240,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.22.2-next.9";
+    return "0.23.1-next.0";
   }
   return "0.0.0";
 }

package/dist/installer.mjs

@@ -15095,6 +15095,31 @@ function readConfigObject(scope = "global", options = {}) {
   }
   return {};
 }
+var FORBIDDEN_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+function splitKey(dottedKey) {
+  const parts = dottedKey.split(".");
+  if (parts.length === 0 || parts.some((p) => p === "")) {
+    throw new Error(`Invalid config key "${dottedKey}": empty path segment`);
+  }
+  for (const p of parts) {
+    if (FORBIDDEN_SEGMENTS.has(p)) {
+      throw new Error(`Invalid config key "${dottedKey}": forbidden segment "${p}"`);
+    }
+  }
+  return parts;
+}
+function isPlainObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function getAtPath(obj, dottedKey) {
+  const parts = splitKey(dottedKey);
+  let cur = obj;
+  for (const part of parts) {
+    if (!isPlainObject(cur)) return void 0;
+    cur = cur[part];
+  }
+  return cur;
+}
 var LOCK_STALE_MS = 1e4;
 var LOCK_MAX_WAIT_MS = 2e3;
 var LOCK_RETRY_MS = 25;
@@ -15172,8 +15197,162 @@ var import_dotenv = __toESM(require_main(), 1);
 import * as fs4 from "node:fs";
 import * as path5 from "node:path";
 
+// ../configuration-core/src/merge.ts
+function mergeRestrictive(local, global2) {
+  if (local === void 0) return global2;
+  if (global2 === void 0) return local;
+  if (typeof local === "boolean" && typeof global2 === "boolean") {
+    return local && global2;
+  }
+  if (typeof local === "number" && typeof global2 === "number") {
+    return Math.min(local, global2);
+  }
+  return local;
+}
+function toArray(value) {
+  return Array.isArray(value) ? value : null;
+}
+function mergeUnion(local, global2) {
+  const l2 = toArray(local);
+  const g = toArray(global2);
+  if (l2 === null && g === null) return local ?? global2;
+  const merged = [...g ?? [], ...l2 ?? []];
+  return Array.from(new Set(merged));
+}
+function mergeIntersection(local, global2) {
+  const l2 = toArray(local);
+  const g = toArray(global2);
+  if (l2 === null && g === null) return local ?? global2;
+  if (l2 === null) return global2;
+  if (g === null) return local;
+  const globalSet = new Set(g);
+  return l2.filter((item) => globalSet.has(item));
+}
+function applyMergePolicy(policy, local, global2) {
+  if (typeof policy === "function") return policy({ local, global: global2 });
+  switch (policy) {
+    case "prioritize-local":
+      return local ?? global2;
+    case "prioritize-global":
+      return global2 ?? local;
+    case "prioritize-restrictive":
+      return mergeRestrictive(local, global2);
+    case "union":
+      return mergeUnion(local, global2);
+    case "intersection":
+      return mergeIntersection(local, global2);
+    default: {
+      const _exhaustive = policy;
+      return _exhaustive;
+    }
+  }
+}
+
+// ../configuration-core/src/config-schema.ts
+function asBoolean(raw) {
+  return typeof raw === "boolean" ? raw : void 0;
+}
+function asString(raw) {
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function asStringArray(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const out = [];
+  for (const item of raw) {
+    if (typeof item === "string" && item.trim() !== "") out.push(item.trim());
+  }
+  return out;
+}
+var CONFIG_SCHEMA = [
+  {
+    key: "telemetry.enabled",
+    description: "Whether anonymous opt-out telemetry is enabled (on by default; environment opt-outs like DO_NOT_TRACK are not reflected here \u2014 `argent telemetry status` shows effective consent). `false` in either scope wins, so a committed project opt-out holds for every teammate.",
+    scopes: ["project", "global"],
+    parse: asBoolean,
+    merge: "prioritize-restrictive",
+    // Opt-out: consent.ts reads an unstored value as enabled, so the config
+    // surface must show the same rather than "(unset)".
+    default: true,
+    // Opt-in/out goes through the dedicated command so the live client is
+    // drained/reset, not just the file rewritten.
+    manageCommand: "argent telemetry"
+  },
+  {
+    key: "allowlist.enabled",
+    description: "Whether `argent update` re-applies editor auto-approve allowlist rules. Unset (the default) keeps the current behavior: update refreshes the rules for editors that already have argent configured. Set to `false` to keep update from touching editor allowlists. `false` in either scope wins, so a committed project opt-out holds for every teammate.",
+    scopes: ["project", "global"],
+    parse: asBoolean,
+    merge: "prioritize-restrictive",
+    example: "false"
+  },
+  {
+    key: "lens.agent",
+    description: "Coding-agent id remembered by `argent lens` to skip the picker.",
+    scopes: ["project", "global"],
+    parse: asString,
+    merge: "prioritize-local",
+    example: "claude"
+  },
+  {
+    key: "ios.additionalDeviceSets",
+    description: "Additional CoreSimulator device-set directories whose simulators argent should see alongside the default set. Absolute paths (or ~/\u2026); relative entries resolve against the project root (project scope) or home (global scope).",
+    scopes: ["project", "global"],
+    parse: asStringArray,
+    // Additive rather than shadowing: global baseline first, project extras
+    // after, deduplicated. `getAdditionalIosDeviceSets` re-implements this union
+    // (path resolution must precede dedup) and guards on the preset staying "union".
+    merge: "union",
+    example: '["~/DeviceSets/ci"]'
+  },
+  {
+    key: "recordings.directory",
+    description: "Directory where finished screen recordings (mp4) are saved on the client host. Absolute, `~`-prefixed, or relative to the project root (home dir when not in a project). Unset \u21D2 `.argent/recordings` under the project root.",
+    scopes: ["project", "global"],
+    parse: asString,
+    // Resolved on the client (the machine the mp4 is persisted to), so with a
+    // remote `argent link` tool-server it is the *client's* config that decides.
+    merge: "prioritize-local",
+    example: "~/Movies/argent"
+  }
+];
+function getConfigDefinition(key, registry = CONFIG_SCHEMA) {
+  return registry.find((def) => def.key === key);
+}
+
 // ../configuration-core/src/config-access.ts
 import * as path6 from "node:path";
+function readScopeValue(def, scope, options) {
+  if (!def.scopes.includes(scope)) return void 0;
+  const raw = getAtPath(readConfigObject(scope, options), def.key);
+  return raw === void 0 ? void 0 : def.parse(raw);
+}
+function getConfigValue(def, options = {}) {
+  const local = readScopeValue(def, "project", options);
+  const global2 = readScopeValue(def, "global", options);
+  const merged = applyMergePolicy(def.merge, local, global2);
+  return merged ?? def.default;
+}
+function getConfigValueByKey(key, options = {}, registry = CONFIG_SCHEMA) {
+  const def = requireDefinition(key, registry);
+  return getConfigValue(def, options);
+}
+function requireDefinition(key, registry = CONFIG_SCHEMA) {
+  const def = getConfigDefinition(key, registry);
+  if (!def) {
+    throw new UnknownConfigKeyError(key);
+  }
+  return def;
+}
+var UnknownConfigKeyError = class extends Error {
+  constructor(key) {
+    super(`Unknown configuration key "${key}".`);
+    this.key = key;
+    this.name = "UnknownConfigKeyError";
+  }
+  key;
+};
 
 // ../telemetry/src/paths.ts
 function identityFilePath() {
@@ -15446,6 +15625,18 @@ var FAILURE_CODES = {
   SIMULATOR_COMMAND_REJECTED: "SIMULATOR_COMMAND_REJECTED",
   SIMULATOR_COMMAND_ACK_TIMEOUT: "SIMULATOR_COMMAND_ACK_TIMEOUT",
   SIMULATOR_COMMAND_TRANSPORT_FAILED: "SIMULATOR_COMMAND_TRANSPORT_FAILED",
+  // Physical iOS devices: the XCUITest-runner blueprint lifecycle, the runner
+  // command client, and the `xcrun devicectl` subprocess wrapper (simulators
+  // use the SIMULATOR_* set).
+  IOS_DEVICE_RUNNER_FACTORY_OPTIONS_MISSING: "IOS_DEVICE_RUNNER_FACTORY_OPTIONS_MISSING",
+  IOS_DEVICE_RUNNER_NOT_READY: "IOS_DEVICE_RUNNER_NOT_READY",
+  IOS_DEVICE_RUNNER_TERMINATED: "IOS_DEVICE_RUNNER_TERMINATED",
+  IOS_DEVICE_RUNNER_EXITED: "IOS_DEVICE_RUNNER_EXITED",
+  // The runner answered a command with an ok:false envelope.
+  IOS_DEVICE_RUNNER_COMMAND_FAILED: "IOS_DEVICE_RUNNER_COMMAND_FAILED",
+  // The usbmux or HTTP exchange with a reachable runner failed.
+  IOS_DEVICE_RUNNER_TRANSPORT_FAILED: "IOS_DEVICE_RUNNER_TRANSPORT_FAILED",
+  IOS_DEVICECTL_COMMAND_FAILED: "IOS_DEVICECTL_COMMAND_FAILED",
   AX_QUERY_TIMEOUT: "AX_QUERY_TIMEOUT",
   AX_DAEMON_READY_TIMEOUT: "AX_DAEMON_READY_TIMEOUT",
   AX_DAEMON_EXITED_BEFORE_READY: "AX_DAEMON_EXITED_BEFORE_READY",
@@ -15616,6 +15807,7 @@ var FAILURE_CODES = {
   KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
   KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
   KEYBOARD_TEXT_AND_KEY_COMBINED: "KEYBOARD_TEXT_AND_KEY_COMBINED",
+  KEYBOARD_INPUT_NOT_FOCUSED: "KEYBOARD_INPUT_NOT_FOCUSED",
   SECRET_PLACEHOLDER_UNKNOWN: "SECRET_PLACEHOLDER_UNKNOWN",
   SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
@@ -15660,7 +15852,9 @@ var FAILURE_COMMANDS = [
   "electron",
   "npm",
   "npx",
-  "unknown"
+  "unknown",
+  "devicectl",
+  "xcodebuild"
 ];
 var FAILURE_SIGNAL_NAMES = [
   "SIGABRT",
@@ -16431,7 +16625,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.22.2-next.9";
+    return "0.23.1-next.0";
   }
   return "0.0.0";
 }
@@ -23372,12 +23566,15 @@ async function update(args) {
           )
         );
       }
-      for (const [scope, adapters] of adaptersByScope) {
-        for (const adapter of adapters) {
-          if (!adapter.addAllowlist) continue;
-          try {
-            adapter.addAllowlist(projectRoot, scope);
-          } catch {
+      const allowlistDisabled = getConfigValueByKey("allowlist.enabled", { cwd: projectRoot }) === false;
+      if (!allowlistDisabled) {
+        for (const [scope, adapters] of adaptersByScope) {
+          for (const adapter of adapters) {
+            if (!adapter.addAllowlist) continue;
+            try {
+              adapter.addAllowlist(projectRoot, scope);
+            } catch {
+            }
           }
         }
       }
@@ -23388,6 +23585,11 @@ async function update(args) {
         ...copyRulesAndAgents(localAdapters, projectRoot, "local", RULES_DIR, AGENTS_DIR)
       ];
       spinner2.stop("Configuration refreshed.");
+      if (allowlistDisabled) {
+        log.info(
+          import_picocolors11.default.dim("Left editor auto-approve allowlists alone (allowlist.enabled is false).")
+        );
+      }
       if (results.length > 0) {
         note(results.join("\n"), "MCP Configs Updated");
       }

package/dist/ios-device-runner/ArgentRunner/ArgentRunner/RunnerHostApp.swift

@@ -0,0 +1,37 @@
+import UIKit
+
+/// Placeholder host application for the Argent runner's UI-test bundle.
+///
+/// It never participates in automation (every command targets another app by
+/// bundle id), but XCUITest requires a host app to exist, and testmanagerd
+/// launches it once when the session starts. The single black screen makes it
+/// obvious on the device that the runner, not a user app, is frontmost.
+@main
+final class RunnerHostAppDelegate: UIResponder, UIApplicationDelegate {
+  var window: UIWindow?
+
+  func application(
+    _ application: UIApplication,
+    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
+  ) -> Bool {
+    let controller = UIViewController()
+    controller.view.backgroundColor = .black
+
+    let label = UILabel()
+    label.text = "Argent Runner"
+    label.textColor = .white
+    label.font = .systemFont(ofSize: 22, weight: .semibold)
+    label.translatesAutoresizingMaskIntoConstraints = false
+    controller.view.addSubview(label)
+    NSLayoutConstraint.activate([
+      label.centerXAnchor.constraint(equalTo: controller.view.centerXAnchor),
+      label.centerYAnchor.constraint(equalTo: controller.view.centerYAnchor),
+    ])
+
+    let window = UIWindow(frame: UIScreen.main.bounds)
+    window.rootViewController = controller
+    window.makeKeyAndVisible()
+    self.window = window
+    return true
+  }
+}