@swmansion/argent 0.32.1-next.2 → 0.32.1-next.20

package/dist/client.d.ts

@@ -12,6 +12,11 @@ export interface ArgentToolResult<T = unknown> {
     data: T;
     /** Optional advisory note the tool attached to the result. */
     note?: string;
+    /**
+     * Why the call did not do its job though it returned, such as an e2e test
+     * that does not pass. See the tool-server API reference for the list.
+     */
+    failure?: string;
 }
 /**
  * A node of the `ui-tree` result. A flag is set only when true; a field named in

package/dist/client.js

@@ -7802,6 +7802,10 @@ var FLAG_REGISTRY = [
     name: "video-watermark",
     description: "Overlay the argent corner watermark on recorded screen videos. On by default; turn it off with `argent disable video-watermark`.",
     defaultEnabled: true
+  },
+  {
+    name: "macos-apps",
+    description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. Off by default."
   }
 ];
 function getFlagDefinition(name, registry = FLAG_REGISTRY) {
@@ -9025,6 +9029,8 @@ var FAILURE_CODES = {
   CLI_RUN_ARGS_JSON_INVALID: "CLI_RUN_ARGS_JSON_INVALID",
   CLI_RUN_INPUT_VALIDATION_FAILED: "CLI_RUN_INPUT_VALIDATION_FAILED",
   CLI_RUN_TOOL_CALL_FAILED: "CLI_RUN_TOOL_CALL_FAILED",
+  // The result carried the tool-server's `failure` field.
+  CLI_RUN_TOOL_RESULT_FAILED: "CLI_RUN_TOOL_RESULT_FAILED",
   CLI_RUN_SAVE_IMAGE_FAILED: "CLI_RUN_SAVE_IMAGE_FAILED",
   TOOL_CAPABILITY_UNSUPPORTED_OPERATION: "TOOL_CAPABILITY_UNSUPPORTED_OPERATION",
   TOOL_PLATFORM_NOT_IMPLEMENTED: "TOOL_PLATFORM_NOT_IMPLEMENTED",
@@ -9040,6 +9046,7 @@ var FAILURE_CODES = {
   INSTALL_MODE_FLAG_CONFLICT: "INSTALL_MODE_FLAG_CONFLICT",
   INSTALL_FROM_TAR_PACKAGE_FAILED: "INSTALL_FROM_TAR_PACKAGE_FAILED",
   INSTALL_INIT_TRIGGERED_UPDATE_FAILED: "INSTALL_INIT_TRIGGERED_UPDATE_FAILED",
+  INSTALL_SKILLS_FAILED: "INSTALL_SKILLS_FAILED",
   INSTALL_SKILLS_REFRESH_FAILED: "INSTALL_SKILLS_REFRESH_FAILED",
   INSTALL_UNCLASSIFIED_FAILED: "INSTALL_UNCLASSIFIED_FAILED",
   UPDATE_INSTALLED_VERSION_DETECT_FAILED: "UPDATE_INSTALLED_VERSION_DETECT_FAILED",
@@ -9123,15 +9130,21 @@ var FAILURE_CODES = {
   ANDROID_LAUNCH_AM_START_FAILED: "ANDROID_LAUNCH_AM_START_FAILED",
   ANDROID_OPEN_URL_FAILED: "ANDROID_OPEN_URL_FAILED",
   ANDROID_REINSTALL_INSTALL_FAILED: "ANDROID_REINSTALL_INSTALL_FAILED",
+  ANDROID_REINSTALL_UNINSTALL_FAILED: "ANDROID_REINSTALL_UNINSTALL_FAILED",
   ANDROID_RESTART_FAILED: "ANDROID_RESTART_FAILED",
   ANDROID_SETTINGS_PERMISSION_FAILED: "ANDROID_SETTINGS_PERMISSION_FAILED",
   IOS_LAUNCH_SIMCTL_FAILED: "IOS_LAUNCH_SIMCTL_FAILED",
   IOS_OPEN_URL_FAILED: "IOS_OPEN_URL_FAILED",
   IOS_REINSTALL_INSTALL_FAILED: "IOS_REINSTALL_INSTALL_FAILED",
+  IOS_REINSTALL_UNINSTALL_FAILED: "IOS_REINSTALL_UNINSTALL_FAILED",
   IOS_RESTART_LAUNCH_FAILED: "IOS_RESTART_LAUNCH_FAILED",
+  IOS_RESTART_TERMINATE_FAILED: "IOS_RESTART_TERMINATE_FAILED",
+  IOS_TERMINATE_APP_FAILED: "IOS_TERMINATE_APP_FAILED",
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_FAILED",
+  STOP_METRO_PORT_PROBE_FAILED: "STOP_METRO_PORT_PROBE_FAILED",
+  STOP_METRO_SIGNAL_FAILED: "STOP_METRO_SIGNAL_FAILED",
   // The hinge of a foldable iOS simulator: the server refused the request on a
   // foldable (a bad angle, a hinge that would not move) vs. nothing to fold —
   // a device that is not foldable, no hinge route, a remote simulator.
@@ -9230,6 +9243,8 @@ var FAILURE_CODES = {
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
   REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
+  REACT_PROFILER_SESSION_TAKEN_OVER: "REACT_PROFILER_SESSION_TAKEN_OVER",
+  REACT_PROFILER_STOP_IN_PROGRESS: "REACT_PROFILER_STOP_IN_PROGRESS",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -9277,10 +9292,13 @@ var FAILURE_CODES = {
   FLOW_NAME_INVALID: "FLOW_NAME_INVALID",
   FLOW_NO_ACTIVE_RECORDING: "FLOW_NO_ACTIVE_RECORDING",
   FLOW_FILE_INVALID: "FLOW_FILE_INVALID",
+  FLOW_FILE_NEWER_VERSION: "FLOW_FILE_NEWER_VERSION",
   FLOW_FILE_WRITE_FAILED: "FLOW_FILE_WRITE_FAILED",
   FLOW_ENTRY_UNRECOGNIZED: "FLOW_ENTRY_UNRECOGNIZED",
   FLOW_E2E_HAS_PREREQUISITE: "FLOW_E2E_HAS_PREREQUISITE",
   FLOW_DEVICE_RESOLUTION: "FLOW_DEVICE_RESOLUTION",
+  // The target does not satisfy the test's `requires:` block; a directory run skips it.
+  FLOW_REQUIREMENTS_UNMET: "FLOW_REQUIREMENTS_UNMET",
   PROFILER_QUERY_MODE_INVALID: "PROFILER_QUERY_MODE_INVALID",
   PROFILER_QUERY_REQUIRED_PARAM_MISSING: "PROFILER_QUERY_REQUIRED_PARAM_MISSING",
   PROFILER_DATA_NOT_LOADED: "PROFILER_DATA_NOT_LOADED",
@@ -9299,11 +9317,38 @@ var FAILURE_CODES = {
   CHROMIUM_STORAGE_EVAL_FAILED: "CHROMIUM_STORAGE_EVAL_FAILED",
   CHROMIUM_TAB_NOT_FOUND: "CHROMIUM_TAB_NOT_FOUND",
   CHROMIUM_TAB_OPEN_FAILED: "CHROMIUM_TAB_OPEN_FAILED",
+  CHROMIUM_NAVIGATE_FAILED: "CHROMIUM_NAVIGATE_FAILED",
   CHROMIUM_DESCRIBE_FAILED: "CHROMIUM_DESCRIBE_FAILED",
   CHROMIUM_ELECTRON_APP_PATH_INVALID: "CHROMIUM_ELECTRON_APP_PATH_INVALID",
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
   CHROMIUM_ELECTRON_CDP_TIMEOUT: "CHROMIUM_ELECTRON_CDP_TIMEOUT",
   CHROMIUM_ELECTRON_EXITED_BEFORE_READY: "CHROMIUM_ELECTRON_EXITED_BEFORE_READY",
+  /**
+   * Native Mac apps (the `macos-apps` flag)
+   * @see [macos-app.ts](../../tool-server/src/blueprints/macos-app.ts)
+   */
+  MACOS_APP_UNSUPPORTED_HOST: "MACOS_APP_UNSUPPORTED_HOST",
+  MACOS_APP_PATH_INVALID: "MACOS_APP_PATH_INVALID",
+  MACOS_APP_BUNDLE_INVALID: "MACOS_APP_BUNDLE_INVALID",
+  MACOS_APP_NOT_FOUND: "MACOS_APP_NOT_FOUND",
+  MACOS_APP_HARDENED_RUNTIME: "MACOS_APP_HARDENED_RUNTIME",
+  MACOS_APP_LIBRARY_MISSING: "MACOS_APP_LIBRARY_MISSING",
+  MACOS_APP_LIBRARY_STAGE_FAILED: "MACOS_APP_LIBRARY_STAGE_FAILED",
+  MACOS_APP_ALREADY_RUNNING: "MACOS_APP_ALREADY_RUNNING",
+  MACOS_APP_SPAWN_FAILED: "MACOS_APP_SPAWN_FAILED",
+  MACOS_APP_EXITED_BEFORE_READY: "MACOS_APP_EXITED_BEFORE_READY",
+  MACOS_APP_HANDSHAKE_TIMEOUT: "MACOS_APP_HANDSHAKE_TIMEOUT",
+  MACOS_APP_HANDSHAKE_INVALID: "MACOS_APP_HANDSHAKE_INVALID",
+  MACOS_APP_NOT_RUNNING: "MACOS_APP_NOT_RUNNING",
+  MACOS_APP_NOT_CONNECTED: "MACOS_APP_NOT_CONNECTED",
+  MACOS_APP_CONNECTION_LOST: "MACOS_APP_CONNECTION_LOST",
+  MACOS_APP_CONNECTION_CLOSED: "MACOS_APP_CONNECTION_CLOSED",
+  MACOS_APP_RPC_TIMEOUT: "MACOS_APP_RPC_TIMEOUT",
+  MACOS_APP_RPC_ERROR: "MACOS_APP_RPC_ERROR",
+  MACOS_APP_TERMINATE_FAILED: "MACOS_APP_TERMINATE_FAILED",
+  MACOS_APP_BUNDLE_ID_MISMATCH: "MACOS_APP_BUNDLE_ID_MISMATCH",
+  MACOS_APP_OPEN_URL_FAILED: "MACOS_APP_OPEN_URL_FAILED",
+  MACOS_APP_FILE_ACCESS_FAILED: "MACOS_APP_FILE_ACCESS_FAILED",
   KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
   KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
   KEYBOARD_TEXT_AND_KEY_COMBINED: "KEYBOARD_TEXT_AND_KEY_COMBINED",
@@ -9315,6 +9360,8 @@ var FAILURE_CODES = {
   SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
   BOOT_IOS_UNSUPPORTED_HOST: "BOOT_IOS_UNSUPPORTED_HOST",
+  BOOT_IOS_SIMCTL_LIST_TIMEOUT: "BOOT_IOS_SIMCTL_LIST_TIMEOUT",
+  BOOT_IOS_SIMCTL_TIMEOUT: "BOOT_IOS_SIMCTL_TIMEOUT",
   BOOT_ANDROID_NO_AVDS: "BOOT_ANDROID_NO_AVDS",
   BOOT_ANDROID_AVD_NOT_FOUND: "BOOT_ANDROID_AVD_NOT_FOUND",
   BOOT_ANDROID_ADB_UNAVAILABLE: "BOOT_ANDROID_ADB_UNAVAILABLE",
@@ -10385,7 +10432,8 @@ async function consumeToolStream(name, body, onProgress, signal) {
       final = {
         data: msg.data,
         note: msg.note,
-        ...msg.profiling === true ? { profiling: true } : {}
+        ...msg.profiling === true ? { profiling: true } : {},
+        ...typeof msg.failure === "string" ? { failure: msg.failure } : {}
       };
     } else if (msg.event === "error") {
       throw new ToolInvocationError(msg.error ?? "tool invocation failed", {
@@ -10437,7 +10485,8 @@ async function consumeToolStream(name, body, onProgress, signal) {
   return {
     data: final.data,
     note: final.note,
-    ...final.profiling ? { profiling: true } : {}
+    ...final.profiling ? { profiling: true } : {},
+    ...final.failure !== void 0 ? { failure: final.failure } : {}
   };
 }
 function errorBodyMessage(body) {
@@ -10602,6 +10651,7 @@ function createToolsClient(options = {}) {
     }
     const shadowWarning = await e2eShadowWarningFor(name, args);
     const baselineDirs = [];
+    let unwrittenBaselines = [];
     if (meta?.fileInputs?.length) {
       if (remote) assertRequiredPresent(meta, finalArgs);
       finalArgs = await prepareFileInputs(meta.fileInputs, finalArgs ?? {}, {
@@ -10615,8 +10665,9 @@ function createToolsClient(options = {}) {
         signal: opts?.signal
       });
     }
-    const settle = async (data) => {
-      const applied = await applyClientFileDirectives(data, { allowedDirs: baselineDirs });
+    const settle = async (data2) => {
+      const applied = await applyClientFileDirectives(data2, { allowedDirs: baselineDirs });
+      unwrittenBaselines = applied.failed.map((f) => f.path);
       for (const { path: file, error } of applied.failed) {
         diagnose(`The baseline ${file} was not written on this client: ${error}`);
       }
@@ -10633,6 +10684,7 @@ function createToolsClient(options = {}) {
       }
       return { ...result, warning: shadowWarning };
     };
+    const unwrittenFailure = () => unwrittenBaselines.length > 0 ? `Baselines not written on this client: ${unwrittenBaselines.join(", ")}` : void 0;
     const stream = opts?.onProgress !== void 0 || carriesMembers(finalArgs);
     const sentOnce = carriesUpload(finalArgs);
     const forwarded = remote ? await forwardedSecrets(finalArgs) : void 0;
@@ -10696,11 +10748,14 @@ function createToolsClient(options = {}) {
         }),
         opts?.signal
       );
+      const data2 = await settle(streamed.data);
+      const failure2 = streamed.failure ?? unwrittenFailure();
       return {
-        data: await settle(streamed.data),
+        data: data2,
         note: streamed.note,
         outputHint: meta?.outputHint,
-        ...streamed.profiling ? { profiling: true } : {}
+        ...streamed.profiling ? { profiling: true } : {},
+        ...failure2 !== void 0 ? { failure: failure2 } : {}
       };
     }
     let json;
@@ -10736,11 +10791,14 @@ function createToolsClient(options = {}) {
       });
     }
     opts?.signal?.throwIfAborted();
+    const data = await settle(json.data);
+    const failure = (typeof json.failure === "string" ? json.failure : void 0) ?? unwrittenFailure();
     return {
-      data: await settle(json.data),
+      data,
       note: json.note,
       outputHint: meta?.outputHint,
-      ...json.profiling === true ? { profiling: true } : {}
+      ...json.profiling === true ? { profiling: true } : {},
+      ...failure !== void 0 ? { failure } : {}
     };
   }
   return { fetchTools, fetchTool, callTool, baseUrl };
@@ -11150,7 +11208,11 @@ function createArgentClient() {
         signal: options?.signal
       });
       options?.signal?.throwIfAborted();
-      return { data: result, note: response.note };
+      return {
+        data: result,
+        note: response.note,
+        ...response.failure !== void 0 ? { failure: response.failure } : {}
+      };
     } catch (err) {
       if (err instanceof ToolInvocationError) {
         throw new ArgentToolError(err.message, {