agent-device 0.21.32 → 0.21.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.32.apk → agent-device-android-ime-helper-0.21.33.apk} +0 -0
  2. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.33.apk.sha256 +1 -0
  3. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.32.manifest.json → agent-device-android-ime-helper-0.21.33.manifest.json} +4 -4
  4. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.32.apk → agent-device-android-snapshot-helper-0.21.33.apk} +0 -0
  5. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.33.apk.sha256 +1 -0
  6. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.32.manifest.json → agent-device-android-snapshot-helper-0.21.33.manifest.json} +7 -7
  7. package/apple/fold-helper/Fold.m +32 -11
  8. package/apple/snapshot-bridge/ForegroundApplicationGeometry.h +4 -16
  9. package/apple/snapshot-bridge/SnapshotBridgeRuntime.m +1 -2
  10. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAXSnapshotBridge.h +36 -58
  11. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAXSnapshotBridge.m +66 -111
  12. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerScrollViewportPolicy.swift +1 -2
  13. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.h +2 -2
  14. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.m +5 -29
  15. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +4 -17
  16. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +66 -117
  17. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+ScrollDragExecution.swift +4 -4
  18. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedGesturePolicy.swift +21 -75
  19. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedInteraction.swift +7 -61
  20. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TypeExecution.swift +1 -4
  21. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +24 -53
  22. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +13 -39
  23. package/dist/src/app-backend.js +1 -1
  24. package/dist/src/app-launch.js +1 -1
  25. package/dist/src/command-metadata.js +1 -1
  26. package/dist/src/config.js +1 -1
  27. package/dist/src/device-readiness-runtime.js +1 -1
  28. package/dist/src/display-inventory.js +1 -1
  29. package/dist/src/fold-helper.js +2 -2
  30. package/dist/src/fold-runtime.js +1 -0
  31. package/dist/src/interactor.js +5 -5
  32. package/dist/src/internal/bin.js +1 -1
  33. package/dist/src/mechanics.js +12 -12
  34. package/dist/src/physical-device-control.js +1 -1
  35. package/dist/src/runtime.js +3 -3
  36. package/dist/src/runtime3.js +5 -5
  37. package/dist/src/simulator.js +1 -1
  38. package/package.json +7 -2
  39. package/server.json +2 -2
  40. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.32.apk.sha256 +0 -1
  41. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.32.apk.sha256 +0 -1
@@ -0,0 +1 @@
1
+ 15f9597c6f5d1a04ebb921d43938af297d60b3daa717ab0a745d43ec55c2e6ea agent-device-android-ime-helper-0.21.33.apk
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "android-ime-helper",
3
- "version": "0.21.32",
4
- "assetName": "agent-device-android-ime-helper-0.21.32.apk",
5
- "sha256": "3f4409c09c27a9202163140f0cd1c23df781ec8d25f52c390d6948d4aa735876",
3
+ "version": "0.21.33",
4
+ "assetName": "agent-device-android-ime-helper-0.21.33.apk",
5
+ "sha256": "15f9597c6f5d1a04ebb921d43938af297d60b3daa717ab0a745d43ec55c2e6ea",
6
6
  "packageName": "com.callstack.agentdevice.imehelper",
7
- "versionCode": 21032,
7
+ "versionCode": 21033,
8
8
  "serviceComponent": "com.callstack.agentdevice.imehelper/.TestInputMethodService",
9
9
  "broadcastProtocol": "android-ime-helper-v1"
10
10
  }
@@ -0,0 +1 @@
1
+ 5fefecd7cd8b72ad0fd964065983493b5daa50b2dd7868c5c3c32903f83c21c4 agent-device-android-snapshot-helper-0.21.33.apk
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "android-snapshot-helper",
3
- "version": "0.21.32",
4
- "releaseTag": "v0.21.32",
5
- "assetName": "agent-device-android-snapshot-helper-0.21.32.apk",
6
- "apkUrl": "https://github.com/callstack/agent-device/releases/download/v0.21.32/agent-device-android-snapshot-helper-0.21.32.apk",
7
- "sha256": "39e02e88a4790b5503ba095c163451bc195e7b719435ba992732431a25e119e0",
8
- "checksumName": "agent-device-android-snapshot-helper-0.21.32.apk.sha256",
3
+ "version": "0.21.33",
4
+ "releaseTag": "v0.21.33",
5
+ "assetName": "agent-device-android-snapshot-helper-0.21.33.apk",
6
+ "apkUrl": "https://github.com/callstack/agent-device/releases/download/v0.21.33/agent-device-android-snapshot-helper-0.21.33.apk",
7
+ "sha256": "5fefecd7cd8b72ad0fd964065983493b5daa50b2dd7868c5c3c32903f83c21c4",
8
+ "checksumName": "agent-device-android-snapshot-helper-0.21.33.apk.sha256",
9
9
  "packageName": "com.callstack.agentdevice.snapshothelper",
10
- "versionCode": 21032,
10
+ "versionCode": 21033,
11
11
  "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
12
12
  "minSdk": 23,
13
13
  "targetSdk": 36,
@@ -5,8 +5,8 @@
5
5
  #import <math.h>
6
6
  #import <objc/message.h>
7
7
 
8
- // Private simulator HID entry points. `set` only dispatches; `hinge` and `panels` only observe, so
9
- // the host verifies a pose with a separate process that never sends HID.
8
+ // Private simulator HID entry points. `set` and `rotate` only dispatch; `hinge` and `panels` only
9
+ // observe, so the host verifies a pose with a separate process that never sends HID.
10
10
  extern CFDataRef IOCFSerialize(CFTypeRef object, CFOptionFlags options);
11
11
  extern CFTypeRef IOHIDEventCreateVendorDefinedEvent(CFAllocatorRef allocator, uint64_t timestamp,
12
12
  uint32_t usagePage, uint32_t usage, uint32_t version, const uint8_t *data,
@@ -14,10 +14,10 @@ extern CFTypeRef IOHIDEventCreateVendorDefinedEvent(CFAllocatorRef allocator, ui
14
14
  extern CFTypeRef IOHIDEventSystemClientCreate(CFAllocatorRef allocator);
15
15
  extern void IOHIDEventSystemClientDispatchEvent(CFTypeRef client, CFTypeRef event);
16
16
 
17
- static BOOL sendAngle(CFTypeRef client, double angle) {
17
+ static BOOL sendControl(CFTypeRef client, NSString *source, NSString *type, id value) {
18
18
  NSDictionary *payload = @{
19
19
  @"provider": @"com.apple.Virtualization.VirtualMachines",
20
- @"source": @"hinge-slider-control", @"type": @"range", @"value": @(angle),
20
+ @"source": source, @"type": type, @"value": value,
21
21
  };
22
22
  CFDataRef data = IOCFSerialize((__bridge CFTypeRef)payload, 1);
23
23
  if (!data) return NO;
@@ -30,6 +30,10 @@ static BOOL sendAngle(CFTypeRef client, double angle) {
30
30
  return YES;
31
31
  }
32
32
 
33
+ static BOOL sendAngle(CFTypeRef client, double angle) {
34
+ return sendControl(client, @"hinge-slider-control", @"range", @(angle));
35
+ }
36
+
33
37
  static BOOL validNumber(id value) {
34
38
  return [value isKindOfClass:NSNumber.class] &&
35
39
  CFGetTypeID((__bridge CFTypeRef)value) != CFBooleanGetTypeID() && isfinite([value doubleValue]);
@@ -84,18 +88,33 @@ static BOOL runFrames(CFTypeRef client, NSArray *frames) {
84
88
  }
85
89
  }
86
90
 
91
+ static int dispatchEvents(BOOL (^send)(CFTypeRef client)) {
92
+ CFTypeRef client = IOHIDEventSystemClientCreate(kCFAllocatorDefault);
93
+ if (!client) return 1;
94
+ BOOL dispatched = send(client);
95
+ CFRelease(client);
96
+ if (!dispatched) fprintf(stderr, "Unable to create simulator HID event\n");
97
+ return dispatched ? 0 : 1;
98
+ }
99
+
87
100
  static int runSet(NSString *argument) {
88
101
  NSArray *frames = readFrames(argument);
89
102
  if (!frames) {
90
103
  fprintf(stderr, "Expected a pose or 2-64 {atMs,angle} keyframes spanning 0 to at most 60000ms\n");
91
104
  return 2;
92
105
  }
93
- CFTypeRef client = IOHIDEventSystemClientCreate(kCFAllocatorDefault);
94
- if (!client) return 1;
95
- BOOL dispatched = runFrames(client, frames);
96
- CFRelease(client);
97
- if (!dispatched) fprintf(stderr, "Unable to create simulator HID event\n");
98
- return dispatched ? 0 : 1;
106
+ return dispatchEvents(^BOOL(CFTypeRef client) { return runFrames(client, frames); });
107
+ }
108
+
109
+ // The orientation control has no upside-down value.
110
+ static int runRotate(NSString *orientation) {
111
+ if (![@[@"portrait", @"landscape-left", @"landscape-right"] containsObject:orientation]) {
112
+ fprintf(stderr, "Expected orientation portrait, landscape-left or landscape-right\n");
113
+ return 2;
114
+ }
115
+ return dispatchEvents(^BOOL(CFTypeRef client) {
116
+ return sendControl(client, @"orientation-picker-control", @"enum", orientation);
117
+ });
99
118
  }
100
119
 
101
120
  static BOOL responds(id target, SEL selector) {
@@ -236,11 +255,13 @@ int main(int argc, const char *argv[]) {
236
255
  @autoreleasepool {
237
256
  NSString *mode = argc >= 2 ? @(argv[1]) : nil;
238
257
  if ([mode isEqualToString:@"set"] && argc == 3) return runSet(@(argv[2]));
258
+ if ([mode isEqualToString:@"rotate"] && argc == 3) return runRotate(@(argv[2]));
239
259
  if ([mode isEqualToString:@"hinge"] && (argc == 2 || argc == 3)) {
240
260
  return readHinge(argc == 3 ? @(argv[2]) : nil);
241
261
  }
242
262
  if ([mode isEqualToString:@"panels"] && argc == 2) return readPanels();
243
- fprintf(stderr, "Usage: fold-helper set <pose|keyframes-json> | hinge [window-ms] | panels\n");
263
+ fprintf(stderr,
264
+ "Usage: fold-helper set <pose|keyframes-json> | rotate <orientation> | hinge [window-ms] | panels\n");
244
265
  return 2;
245
266
  }
246
267
  }
@@ -1,13 +1,7 @@
1
- // ForegroundApplicationGeometry.h — the one full-screen rule two native targets ask.
2
- //
3
- // The Simulator snapshot bridge refuses a capture whose app window does not fill the screen
4
- // (`app-window-not-full-screen`, #3844), and the iOS runner refuses to route a window-less
5
- // gesture onto a screen it cannot prove the app fills. Both include this header, so the rule is
6
- // one compilation, not a pinned copy. Each caller keeps its own unknown policy: the bridge keeps
7
- // a capture it cannot measure, the runner refuses authorization it cannot prove.
8
- //
9
- // Both consumers include this file by bare name: the snapshot bridge compiles it from its own
10
- // directory, the runner's UITests target finds it through HEADER_SEARCH_PATHS.
1
+ // ForegroundApplicationGeometry.h — the one full-screen rule the Simulator snapshot bridge and
2
+ // the iOS runner both include, by bare name, so the rule is one compilation and not a pinned
3
+ // copy. Each keeps its own unknown policy: the bridge keeps a capture it cannot measure, the
4
+ // runner refuses to authorize a route it cannot prove.
11
5
 
12
6
  #import <CoreGraphics/CoreGraphics.h>
13
7
  #import <Foundation/Foundation.h>
@@ -22,12 +16,6 @@ NS_ASSUME_NONNULL_BEGIN
22
16
  - (CGRect)frame;
23
17
  @end
24
18
 
25
- // While a system surface owns the foreground, no screen is the target app's to fill and no tree is
26
- // the target app's to capture (ADR 0004, foreground ownership).
27
- static inline BOOL AgentDeviceForegroundOwnershipMatches(pid_t primaryProcessID, pid_t targetProcessID) {
28
- return primaryProcessID == targetProcessID;
29
- }
30
-
31
19
  // Sub-pixel layout rounding is not a window; anything past this is one that shows the app in part
32
20
  // of the screen (Windowed Apps or Stage Manager).
33
21
  #define AGENT_DEVICE_FULL_SCREEN_FRAME_TOLERANCE 0.5
@@ -182,7 +182,7 @@ static void finishRequestWatchdog(dispatch_source_t watchdog, SnapshotWatchdogSt
182
182
  if (![elementClass respondsToSelector:@selector(primaryApp)]) return NO;
183
183
  id<AgentDeviceForegroundElement> application = [elementClass primaryApp];
184
184
  return [application respondsToSelector:@selector(pid)] &&
185
- AgentDeviceForegroundOwnershipMatches([application pid], pid);
185
+ [application pid] == pid;
186
186
  }
187
187
 
188
188
  // The snapshot API reports the frames of an app that runs in an iPadOS window relative to that
@@ -224,7 +224,6 @@ static void finishRequestWatchdog(dispatch_source_t watchdog, SnapshotWatchdogSt
224
224
  CGRect rect = CGRectZero;
225
225
  if (_valueGetValue(raw, 3, &rect)) return rectDictionary(rect);
226
226
  }
227
- if ([name isEqualToString:kAttributeFrame]) return nil;
228
227
  return nil;
229
228
  }
230
229
 
@@ -4,27 +4,25 @@
4
4
 
5
5
  NS_ASSUME_NONNULL_BEGIN
6
6
 
7
- /// Keys of the `deepExtension` dictionary in the snapshot response, shared
8
- /// with the Swift consumer so the response shape has one spelling.
7
+ /// Keys of the `deepExtension` dictionary in the snapshot response, shared with the Swift consumer
8
+ /// so the response shape has one spelling.
9
9
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotDeepExtensionKey;
10
10
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotDeepExtensionCallsKey;
11
11
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotDeepExtensionNodesAddedKey;
12
12
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotDeepExtensionPendingKey;
13
13
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotDeepExtensionMissedKey;
14
14
 
15
- /// Keys of the `customActions` dictionary in the snapshot response: how many
16
- /// merged elements were eligible for an action read, and how many the bounded
17
- /// pass actually reached. Present only when the capture asked for actions.
15
+ /// Keys of the `customActions` dictionary in the snapshot response: how many merged elements were
16
+ /// eligible for an action read, and how many the bounded pass actually reached. Present only when
17
+ /// the capture asked for actions.
18
18
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsKey;
19
19
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsReadKey;
20
20
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsCandidatesKey;
21
21
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsTruncatedKey;
22
22
  FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsBlockedKey;
23
23
 
24
- /// A depth-capped childless node awaiting an element-rooted follow-up request.
25
- /// Public so the runner unit bundle can drive the extension's miss paths with
26
- /// fabricated snapshots — the executed contract that missed frontiers are
27
- /// counted, never silently dropped.
24
+ /// A depth-capped childless node awaiting an element-rooted follow-up request. Public so the runner
25
+ /// unit bundle can drive the extension's miss paths with fabricated snapshots.
28
26
  @interface RunnerAXSnapshotFrontier : NSObject
29
27
  @property(nonatomic, strong, nullable) id snapshot;
30
28
  @property(nonatomic, strong, nullable) NSMutableDictionary *node;
@@ -33,15 +31,12 @@ FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsBlockedKey;
33
31
 
34
32
  @interface RunnerAXSnapshotBridge : NSObject
35
33
 
36
- /// Captures the app's accessibility tree, then chains element-rooted follow-up
37
- /// requests from depth-capped frontier nodes (the AX depth limit is
38
- /// per-request, so re-rooting reaches content the app-rooted request could
39
- /// not). The response gains a `deepExtension` {calls, nodesAdded,
40
- /// pendingFrontiers, missedFrontiers} dictionary when any frontier existed and
41
- /// the call limit allowed extension. Pass 0 to disable extension entirely.
42
- ///
43
- /// `customActionLimit` bounds the per-element custom-action reads described on
44
- /// `customActionNamesForElement:axClient:`; pass 0 to skip them entirely.
34
+ /// Captures the app's accessibility tree, then chains element-rooted follow-up requests from
35
+ /// depth-capped frontier nodes: the AX depth limit is per-request, so re-rooting reaches content
36
+ /// the app-rooted request could not. The response gains a `deepExtension` {calls, nodesAdded,
37
+ /// pendingFrontiers, missedFrontiers} dictionary when any frontier existed and the call limit
38
+ /// allowed extension. Pass 0 to disable extension entirely. `customActionLimit` bounds the
39
+ /// per-element custom-action reads; pass 0 to skip them entirely.
45
40
  + (NSDictionary<NSString *, id> *)snapshotTreeForApplication:(XCUIApplication *)application
46
41
  maxDepth:(NSInteger)maxDepth
47
42
  maxNodes:(NSInteger)maxNodes
@@ -49,10 +44,9 @@ FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsBlockedKey;
49
44
  customActionLimit:(NSInteger)customActionLimit
50
45
  deadline:(nullable NSDate *)deadline;
51
46
 
52
- /// The capture behind `snapshotTreeForApplication:`, for an AX client and target
53
- /// application element that are already resolved. Every request, extension, and
54
- /// custom-action decision happens here; the application entry point only resolves
55
- /// the two identities.
47
+ /// The capture behind `snapshotTreeForApplication:`, for an AX client and target application
48
+ /// element that are already resolved. Every request, extension, and custom-action decision happens
49
+ /// here; the application entry point only resolves the two identities.
56
50
  + (NSDictionary<NSString *, id> *)snapshotTreeWithClient:(id)axClient
57
51
  target:(id)target
58
52
  maxDepth:(NSInteger)maxDepth
@@ -61,37 +55,25 @@ FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsBlockedKey;
61
55
  customActionLimit:(NSInteger)customActionLimit
62
56
  deadline:(nullable NSDate *)deadline;
63
57
 
64
- /// Names of the element's UIAccessibilityCustomActions, or nil when it has
65
- /// none.
66
- ///
67
- /// One element per call on purpose. The bulk snapshot request cannot carry this
68
- /// attribute: adding it makes testmanagerd's reply decoder reject the nested
69
- /// arrays a custom action serializes into ("value for key 'NS.objects' was of
70
- /// unexpected class 'NSArray'"), drop the reply, and time the request out after
71
- /// ~65s instead of the usual ~110ms. Per-element reads use a different XPC
72
- /// message and answer normally.
73
- ///
74
- /// Reading is all we can do: the actions are not invocable from the runner.
75
- /// XCUIElement exposes no custom-action API; XCAXClient_iOS's
76
- /// performAction:onElement:value: answers kAXErrorCannotComplete for every AX
77
- /// action number; setAttribute: on the custom-actions attribute reports success
78
- /// and does nothing; parameterizedAttribute: answers kAXErrorNoValue; and the
79
- /// raw AXUIElement C API cannot be aimed at app elements because
80
- /// XCAccessibilityElement is token-based and answers nil for AXUIElement.
58
+ /// Names of the element's UIAccessibilityCustomActions, or nil when it has none. One element per
59
+ /// call on purpose: the bulk snapshot request cannot carry this attribute — its nested arrays make
60
+ /// testmanagerd's reply decoder drop the reply and time the request out — while per-element reads
61
+ /// use a different XPC message and answer normally. Reading is all this does: none of the
62
+ /// invocation routes work from the runner (XCUIElement exposes no API, XCAXClient_iOS
63
+ /// performAction:onElement:value: answers kAXErrorCannotComplete, setAttribute: silently no-ops,
64
+ /// and the raw AXUIElement C API cannot be aimed at app elements).
81
65
  + (nullable NSArray<NSString *> *)customActionNamesForElement:(id)element
82
66
  axClient:(id)axClient
83
67
  completed:(BOOL *)completed;
84
68
 
85
- /// Bounds one element's contribution to the response (max actions, max name
86
- /// length). Reports whether anything was clipped so truncation is disclosed
87
- /// rather than silently presented as a complete list.
69
+ /// Bounds one element's action list (max actions, max name length) and reports whether anything
70
+ /// was clipped, so a clipped list is disclosed rather than silently presented as a complete list.
88
71
  + (NSArray<NSString *> *)cappedActionNames:(NSArray<NSString *> *)names
89
72
  truncated:(BOOL *)truncated;
90
73
 
91
- /// The bounded read pass over merged leaves, exposed for the runner unit
92
- /// bundle: the containment contract (a hung read blocks the pass and is
93
- /// disclosed, and adds no further dispatches) is only executable from here.
94
- /// Returns {read, candidates, truncated, blocked}.
74
+ /// The bounded read pass over merged leaves, exposed for the runner unit bundle: the containment
75
+ /// contract (a hung read blocks the pass, is disclosed, and adds no further dispatches) is only
76
+ /// executable from here. Returns {read, candidates, truncated, blocked}.
95
77
  + (NSDictionary<NSString *, NSNumber *> *)
96
78
  annotateCustomActionsOnMergedLeaves:(nullable NSArray<RunnerAXSnapshotFrontier *> *)leaves
97
79
  axClient:(id)axClient
@@ -99,21 +81,19 @@ FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsBlockedKey;
99
81
  rootFrame:(CGRect)rootFrame
100
82
  deadline:(nullable NSDate *)deadline;
101
83
 
102
- /// Reads dispatched but not yet returned. The AX call cannot be cancelled, so a
103
- /// read that blew its deadline stays counted here until it finally returns —
104
- /// which is precisely the state in which further reads must be refused rather
105
- /// than queued behind it. Consumed by the read pass to disclose the skip.
84
+ /// Reads dispatched but not yet returned. The AX call cannot be cancelled, so a read that blew its
85
+ /// deadline stays counted here until it returns — the state in which further reads are refused
86
+ /// rather than queued behind it.
106
87
  + (NSInteger)customActionReadsInFlight;
107
88
 
108
- /// Total reads ever dispatched. The containment invariant is "a blocked capture
109
- /// adds no work", which is only observable as this counter standing still.
89
+ /// Total reads ever dispatched.
110
90
  + (NSInteger)customActionReadDispatchCount;
111
91
 
112
92
  /// Total reads refused by single-flight admission.
113
93
  + (NSInteger)customActionReadBlockedCount;
114
94
 
115
- /// The shared AX client (`XCUIDevice.accessibilityInterface`), or nil when the
116
- /// private interface is unavailable.
95
+ /// The shared AX client (`XCUIDevice.accessibilityInterface`), or nil when the private interface is
96
+ /// unavailable.
117
97
  + (nullable id)accessibilityClient;
118
98
 
119
99
  + (NSInteger)processIdentifierForApplication:(XCUIApplication *)application;
@@ -122,10 +102,8 @@ FOUNDATION_EXPORT NSString *const RunnerAXSnapshotCustomActionsBlockedKey;
122
102
  /// snapshot target match uses; pids only — the client resolves no bundle id for an arbitrary app.
123
103
  + (NSArray<NSNumber *> *)activeApplicationProcessIdentifiers;
124
104
 
125
- /// The frontier-extension loop, exposed for the runner unit bundle: a frontier
126
- /// whose element vanished or whose re-rooted request fails must count as
127
- /// missed (see the deepExtension keys above) — an all-miss extension reporting
128
- /// itself drained would present a capped capture as complete.
105
+ /// The frontier-extension loop, exposed for the runner unit bundle: a frontier whose element
106
+ /// vanished or whose re-rooted request fails must count as missed, never as drained.
129
107
  + (nullable NSDictionary *)extendSnapshotFrontiers:(NSMutableArray<RunnerAXSnapshotFrontier *> *)frontiers
130
108
  axClient:(id)axClient
131
109
  attributes:(NSArray *)attributes