@swmansion/argent 0.27.1-next.8 → 0.27.1-next.9

package/dist/tool-args.generated.d.ts

@@ -406,6 +406,8 @@ export interface ArgentToolArgs {
         bundleId: string;
         /** Android-only: fully-qualified Activity name (e.g. `.MainActivity` or `com.example/com.example.MainActivity`). If omitted on Android, the app's default launcher activity is used. Ignored on iOS / Chromium. */
         activity?: string;
+        /** Apple simulators only: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. A running app is relaunched to apply them. Ignored on other targets, including a physical iPhone. */
+        launchArgs?: Array<string>;
     };
     "list-devices": Record<string, never>;
     "native-describe-screen": {
@@ -747,6 +749,8 @@ export interface ArgentToolArgs {
         bundleId: string;
         /** Android-only: relaunch a non-launcher Activity (e.g. `.SettingsActivity` or `com.example/com.example.SettingsActivity`). If omitted, the app's default launcher activity is used. Ignored on iOS. */
         activity?: string;
+        /** Apple simulators only: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. Ignored on other targets, including a physical iPhone. */
+        launchArgs?: Array<string>;
     };
     rotate: {
         /** Target device id from `list-devices` (iOS UDID or Android serial). */

package/dist/tool-server.cjs

@@ -122190,10 +122190,24 @@ function makeIosImpl(registry2) {
         const blocked = await precheckNativeDevtools(nativeDevtools, params.udid);
         if (blocked) return blocked;
       }
+      if (params.launchArgs?.length) {
+        try {
+          await execFileAsync19(
+            "xcrun",
+            await simctlArgsForUdid(params.udid, ["terminate", params.udid, params.bundleId])
+          );
+        } catch {
+        }
+      }
       try {
         await execFileAsync19(
           "xcrun",
-          await simctlArgsForUdid(params.udid, ["launch", params.udid, params.bundleId])
+          await simctlArgsForUdid(params.udid, [
+            "launch",
+            params.udid,
+            params.bundleId,
+            ...params.launchArgs ?? []
+          ])
         );
       } catch (err) {
         throw new FailureError(
@@ -122292,8 +122306,14 @@ function buildIosLaunchHandler(backend) {
   return async (services, params) => {
     const blocked = await precheckNativeDevtools(services.nativeDevtools, params.udid);
     if (blocked) return blocked;
+    if (params.launchArgs?.length) {
+      try {
+        await backend.terminate(params.udid, params.bundleId);
+      } catch {
+      }
+    }
     try {
-      await backend.launch(params.udid, params.bundleId);
+      await backend.launch(params.udid, params.bundleId, params.launchArgs);
     } catch (err) {
       throw new FailureError(
         `Failed to launch iOS app ${params.bundleId} on ${params.udid}.`,
@@ -122428,6 +122448,9 @@ var zodSchema10 = external_exports.object({
   ),
   activity: external_exports.string().regex(ACTIVITY_PATTERN, "activity may only contain letters, digits, '.', '_', '-' and '/'").optional().describe(
     "Android-only: fully-qualified Activity name (e.g. `.MainActivity` or `com.example/com.example.MainActivity`). If omitted on Android, the app's default launcher activity is used. Ignored on iOS / Chromium."
+  ),
+  launchArgs: external_exports.array(external_exports.string()).optional().describe(
+    'Apple simulators only: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. A running app is relaunched to apply them. Ignored on other targets, including a physical iPhone.'
   )
 });
 var capability2 = {
@@ -122507,7 +122530,10 @@ function makeIosImpl2(registry2) {
       } catch {
       }
       try {
-        await execFileAsync20("xcrun", await simctlArgsForUdid(udid, ["launch", udid, bundleId]));
+        await execFileAsync20(
+          "xcrun",
+          await simctlArgsForUdid(udid, ["launch", udid, bundleId, ...params.launchArgs ?? []])
+        );
       } catch (err) {
         throw new FailureError(
           `Failed to restart iOS app ${bundleId} on ${udid}.`,
@@ -122557,7 +122583,7 @@ function buildIosRestartHandler(backend) {
     } catch {
     }
     try {
-      await backend.launch(udid, bundleId);
+      await backend.launch(udid, bundleId, params.launchArgs);
     } catch (err) {
       throw new FailureError(
         `Failed to restart iOS app ${bundleId} on ${udid}.`,
@@ -122639,6 +122665,9 @@ var zodSchema11 = external_exports.object({
   bundleId: external_exports.string().min(1).regex(BUNDLE_ID_PATTERN, BUNDLE_ID_MESSAGE).describe("App identifier. iOS: bundle id. Android: package name."),
   activity: external_exports.string().regex(ACTIVITY_PATTERN2, "activity may only contain letters, digits, '.', '_', '-' and '/'").optional().describe(
     "Android-only: relaunch a non-launcher Activity (e.g. `.SettingsActivity` or `com.example/com.example.SettingsActivity`). If omitted, the app's default launcher activity is used. Ignored on iOS."
+  ),
+  launchArgs: external_exports.array(external_exports.string()).optional().describe(
+    'Apple simulators only: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. Ignored on other targets, including a physical iPhone.'
   )
 });
 var capability3 = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.27.1-next.8",
+  "version": "0.27.1-next.9",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",