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.
- 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
- package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.33.apk.sha256 +1 -0
- 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
- 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
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.33.apk.sha256 +1 -0
- 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
- package/apple/fold-helper/Fold.m +32 -11
- package/apple/snapshot-bridge/ForegroundApplicationGeometry.h +4 -16
- package/apple/snapshot-bridge/SnapshotBridgeRuntime.m +1 -2
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAXSnapshotBridge.h +36 -58
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAXSnapshotBridge.m +66 -111
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerScrollViewportPolicy.swift +1 -2
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.h +2 -2
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.m +5 -29
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +4 -17
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +66 -117
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+ScrollDragExecution.swift +4 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedGesturePolicy.swift +21 -75
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedInteraction.swift +7 -61
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TypeExecution.swift +1 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +24 -53
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +13 -39
- package/dist/src/app-backend.js +1 -1
- package/dist/src/app-launch.js +1 -1
- package/dist/src/command-metadata.js +1 -1
- package/dist/src/config.js +1 -1
- package/dist/src/device-readiness-runtime.js +1 -1
- package/dist/src/display-inventory.js +1 -1
- package/dist/src/fold-helper.js +2 -2
- package/dist/src/fold-runtime.js +1 -0
- package/dist/src/interactor.js +5 -5
- package/dist/src/internal/bin.js +1 -1
- package/dist/src/mechanics.js +12 -12
- package/dist/src/physical-device-control.js +1 -1
- package/dist/src/runtime.js +3 -3
- package/dist/src/runtime3.js +5 -5
- package/dist/src/simulator.js +1 -1
- package/package.json +7 -2
- package/server.json +2 -2
- package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.32.apk.sha256 +0 -1
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.32.apk.sha256 +0 -1
|
Binary file
|
|
@@ -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.
|
|
4
|
-
"assetName": "agent-device-android-ime-helper-0.21.
|
|
5
|
-
"sha256": "
|
|
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":
|
|
7
|
+
"versionCode": 21033,
|
|
8
8
|
"serviceComponent": "com.callstack.agentdevice.imehelper/.TestInputMethodService",
|
|
9
9
|
"broadcastProtocol": "android-ime-helper-v1"
|
|
10
10
|
}
|
|
Binary file
|
|
@@ -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.
|
|
4
|
-
"releaseTag": "v0.21.
|
|
5
|
-
"assetName": "agent-device-android-snapshot-helper-0.21.
|
|
6
|
-
"apkUrl": "https://github.com/callstack/agent-device/releases/download/v0.21.
|
|
7
|
-
"sha256": "
|
|
8
|
-
"checksumName": "agent-device-android-snapshot-helper-0.21.
|
|
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":
|
|
10
|
+
"versionCode": 21033,
|
|
11
11
|
"instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
|
|
12
12
|
"minSdk": 23,
|
|
13
13
|
"targetSdk": 36,
|
package/apple/fold-helper/Fold.m
CHANGED
|
@@ -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
|
|
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
|
|
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":
|
|
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
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
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,
|
|
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
|
|
2
|
-
//
|
|
3
|
-
//
|
|
4
|
-
//
|
|
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
|
-
|
|
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
|
|
package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAXSnapshotBridge.h
CHANGED
|
@@ -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
|
-
///
|
|
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
|
-
///
|
|
17
|
-
///
|
|
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
|
-
///
|
|
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
|
-
///
|
|
38
|
-
///
|
|
39
|
-
///
|
|
40
|
-
///
|
|
41
|
-
///
|
|
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
|
-
///
|
|
54
|
-
///
|
|
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
|
-
///
|
|
66
|
-
///
|
|
67
|
-
///
|
|
68
|
-
///
|
|
69
|
-
///
|
|
70
|
-
///
|
|
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
|
|
86
|
-
///
|
|
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
|
-
///
|
|
93
|
-
///
|
|
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
|
-
///
|
|
104
|
-
///
|
|
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.
|
|
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
|
-
///
|
|
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
|
-
///
|
|
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
|