agent-device 0.4.2 → 0.5.0
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/README.md +2 -9
- package/dist/src/797.js +1 -1
- package/dist/src/bin.js +5 -5
- package/dist/src/daemon.js +16 -20
- package/package.json +7 -9
- package/skills/agent-device/SKILL.md +3 -6
- package/skills/agent-device/references/permissions.md +3 -15
- package/skills/agent-device/references/snapshot-refs.md +1 -4
- package/dist/bin/axsnapshot +0 -0
- package/ios-runner/AXSnapshot/Package.swift +0 -18
- package/ios-runner/AXSnapshot/Sources/AXSnapshot/main.swift +0 -444
- package/src/__tests__/cli-close.test.ts +0 -155
- package/src/__tests__/cli-help.test.ts +0 -102
- package/src/bin.ts +0 -3
- package/src/cli.ts +0 -305
- package/src/core/__tests__/capabilities.test.ts +0 -75
- package/src/core/__tests__/dispatch-open.test.ts +0 -25
- package/src/core/__tests__/open-target.test.ts +0 -55
- package/src/core/capabilities.ts +0 -57
- package/src/core/dispatch.ts +0 -382
- package/src/core/open-target.ts +0 -27
- package/src/daemon/__tests__/device-ready.test.ts +0 -52
- package/src/daemon/__tests__/is-predicates.test.ts +0 -68
- package/src/daemon/__tests__/selectors.test.ts +0 -261
- package/src/daemon/__tests__/session-routing.test.ts +0 -108
- package/src/daemon/__tests__/session-selector.test.ts +0 -64
- package/src/daemon/__tests__/session-store.test.ts +0 -142
- package/src/daemon/__tests__/snapshot-processing.test.ts +0 -47
- package/src/daemon/action-utils.ts +0 -29
- package/src/daemon/context.ts +0 -48
- package/src/daemon/device-ready.ts +0 -155
- package/src/daemon/handlers/__tests__/find.test.ts +0 -99
- package/src/daemon/handlers/__tests__/interaction.test.ts +0 -22
- package/src/daemon/handlers/__tests__/replay-heal.test.ts +0 -509
- package/src/daemon/handlers/__tests__/session-reinstall.test.ts +0 -219
- package/src/daemon/handlers/__tests__/session.test.ts +0 -820
- package/src/daemon/handlers/__tests__/snapshot-handler.test.ts +0 -92
- package/src/daemon/handlers/__tests__/snapshot.test.ts +0 -128
- package/src/daemon/handlers/find.ts +0 -324
- package/src/daemon/handlers/interaction.ts +0 -550
- package/src/daemon/handlers/parse-utils.ts +0 -8
- package/src/daemon/handlers/record-trace.ts +0 -154
- package/src/daemon/handlers/session.ts +0 -1137
- package/src/daemon/handlers/snapshot.ts +0 -439
- package/src/daemon/is-predicates.ts +0 -46
- package/src/daemon/selectors.ts +0 -540
- package/src/daemon/session-routing.ts +0 -22
- package/src/daemon/session-selector.ts +0 -39
- package/src/daemon/session-store.ts +0 -296
- package/src/daemon/snapshot-processing.ts +0 -131
- package/src/daemon/types.ts +0 -56
- package/src/daemon-client.ts +0 -272
- package/src/daemon.ts +0 -295
- package/src/platforms/__tests__/boot-diagnostics.test.ts +0 -59
- package/src/platforms/android/__tests__/index.test.ts +0 -274
- package/src/platforms/android/devices.ts +0 -196
- package/src/platforms/android/index.ts +0 -784
- package/src/platforms/android/ui-hierarchy.ts +0 -312
- package/src/platforms/boot-diagnostics.ts +0 -128
- package/src/platforms/ios/__tests__/index.test.ts +0 -312
- package/src/platforms/ios/__tests__/runner-client.test.ts +0 -155
- package/src/platforms/ios/apps.ts +0 -358
- package/src/platforms/ios/ax-snapshot.ts +0 -207
- package/src/platforms/ios/config.ts +0 -28
- package/src/platforms/ios/devicectl.ts +0 -134
- package/src/platforms/ios/devices.ts +0 -100
- package/src/platforms/ios/index.ts +0 -20
- package/src/platforms/ios/runner-client.ts +0 -994
- package/src/platforms/ios/simulator.ts +0 -164
- package/src/utils/__tests__/args.test.ts +0 -239
- package/src/utils/__tests__/daemon-client.test.ts +0 -95
- package/src/utils/__tests__/exec.test.ts +0 -16
- package/src/utils/__tests__/finders.test.ts +0 -34
- package/src/utils/__tests__/keyed-lock.test.ts +0 -55
- package/src/utils/__tests__/process-identity.test.ts +0 -33
- package/src/utils/__tests__/retry.test.ts +0 -44
- package/src/utils/args.ts +0 -239
- package/src/utils/command-schema.ts +0 -622
- package/src/utils/device.ts +0 -84
- package/src/utils/errors.ts +0 -35
- package/src/utils/exec.ts +0 -339
- package/src/utils/finders.ts +0 -101
- package/src/utils/interactive.ts +0 -4
- package/src/utils/interactors.ts +0 -173
- package/src/utils/keyed-lock.ts +0 -14
- package/src/utils/output.ts +0 -204
- package/src/utils/process-identity.ts +0 -100
- package/src/utils/retry.ts +0 -180
- package/src/utils/snapshot.ts +0 -64
- package/src/utils/timeouts.ts +0 -9
- package/src/utils/version.ts +0 -26
|
@@ -1,820 +0,0 @@
|
|
|
1
|
-
import test from 'node:test';
|
|
2
|
-
import assert from 'node:assert/strict';
|
|
3
|
-
import fs from 'node:fs';
|
|
4
|
-
import os from 'node:os';
|
|
5
|
-
import path from 'node:path';
|
|
6
|
-
import { handleSessionCommands } from '../session.ts';
|
|
7
|
-
import { SessionStore } from '../../session-store.ts';
|
|
8
|
-
import type { DaemonRequest, DaemonResponse, SessionState } from '../../types.ts';
|
|
9
|
-
|
|
10
|
-
function makeSessionStore(): SessionStore {
|
|
11
|
-
const root = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-device-session-handler-'));
|
|
12
|
-
return new SessionStore(path.join(root, 'sessions'));
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
function makeSession(name: string, device: SessionState['device']): SessionState {
|
|
16
|
-
return {
|
|
17
|
-
name,
|
|
18
|
-
device,
|
|
19
|
-
createdAt: Date.now(),
|
|
20
|
-
actions: [],
|
|
21
|
-
};
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
const noopInvoke = async (_req: DaemonRequest): Promise<DaemonResponse> => ({ ok: true, data: {} });
|
|
25
|
-
|
|
26
|
-
test('boot requires session or explicit selector', async () => {
|
|
27
|
-
const sessionStore = makeSessionStore();
|
|
28
|
-
const response = await handleSessionCommands({
|
|
29
|
-
req: {
|
|
30
|
-
token: 't',
|
|
31
|
-
session: 'default',
|
|
32
|
-
command: 'boot',
|
|
33
|
-
positionals: [],
|
|
34
|
-
flags: {},
|
|
35
|
-
},
|
|
36
|
-
sessionName: 'default',
|
|
37
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
38
|
-
sessionStore,
|
|
39
|
-
invoke: noopInvoke,
|
|
40
|
-
ensureReady: async () => {},
|
|
41
|
-
});
|
|
42
|
-
assert.ok(response);
|
|
43
|
-
assert.equal(response?.ok, false);
|
|
44
|
-
if (response && !response.ok) {
|
|
45
|
-
assert.equal(response.error.code, 'INVALID_ARGS');
|
|
46
|
-
}
|
|
47
|
-
});
|
|
48
|
-
|
|
49
|
-
test('boot succeeds for iOS physical devices', async () => {
|
|
50
|
-
const sessionStore = makeSessionStore();
|
|
51
|
-
const sessionName = 'ios-device-session';
|
|
52
|
-
sessionStore.set(
|
|
53
|
-
sessionName,
|
|
54
|
-
makeSession(sessionName, {
|
|
55
|
-
platform: 'ios',
|
|
56
|
-
id: 'ios-device-1',
|
|
57
|
-
name: 'iPhone Device',
|
|
58
|
-
kind: 'device',
|
|
59
|
-
booted: true,
|
|
60
|
-
}),
|
|
61
|
-
);
|
|
62
|
-
let ensureCalls = 0;
|
|
63
|
-
const response = await handleSessionCommands({
|
|
64
|
-
req: {
|
|
65
|
-
token: 't',
|
|
66
|
-
session: sessionName,
|
|
67
|
-
command: 'boot',
|
|
68
|
-
positionals: [],
|
|
69
|
-
flags: {},
|
|
70
|
-
},
|
|
71
|
-
sessionName,
|
|
72
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
73
|
-
sessionStore,
|
|
74
|
-
invoke: noopInvoke,
|
|
75
|
-
ensureReady: async () => {
|
|
76
|
-
ensureCalls += 1;
|
|
77
|
-
},
|
|
78
|
-
});
|
|
79
|
-
assert.ok(response);
|
|
80
|
-
assert.equal(response?.ok, true);
|
|
81
|
-
assert.equal(ensureCalls, 1);
|
|
82
|
-
if (response && response.ok) {
|
|
83
|
-
assert.equal(response.data?.platform, 'ios');
|
|
84
|
-
assert.equal(response.data?.booted, true);
|
|
85
|
-
}
|
|
86
|
-
});
|
|
87
|
-
|
|
88
|
-
test('boot succeeds for supported device in session', async () => {
|
|
89
|
-
const sessionStore = makeSessionStore();
|
|
90
|
-
const sessionName = 'android-session';
|
|
91
|
-
sessionStore.set(
|
|
92
|
-
sessionName,
|
|
93
|
-
makeSession(sessionName, {
|
|
94
|
-
platform: 'android',
|
|
95
|
-
id: 'emulator-5554',
|
|
96
|
-
name: 'Pixel Emulator',
|
|
97
|
-
kind: 'emulator',
|
|
98
|
-
booted: true,
|
|
99
|
-
}),
|
|
100
|
-
);
|
|
101
|
-
let ensureCalls = 0;
|
|
102
|
-
const response = await handleSessionCommands({
|
|
103
|
-
req: {
|
|
104
|
-
token: 't',
|
|
105
|
-
session: sessionName,
|
|
106
|
-
command: 'boot',
|
|
107
|
-
positionals: [],
|
|
108
|
-
flags: {},
|
|
109
|
-
},
|
|
110
|
-
sessionName,
|
|
111
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
112
|
-
sessionStore,
|
|
113
|
-
invoke: noopInvoke,
|
|
114
|
-
ensureReady: async () => {
|
|
115
|
-
ensureCalls += 1;
|
|
116
|
-
},
|
|
117
|
-
});
|
|
118
|
-
assert.ok(response);
|
|
119
|
-
assert.equal(response?.ok, true);
|
|
120
|
-
assert.equal(ensureCalls, 1);
|
|
121
|
-
if (response && response.ok) {
|
|
122
|
-
assert.equal(response.data?.platform, 'android');
|
|
123
|
-
assert.equal(response.data?.booted, true);
|
|
124
|
-
}
|
|
125
|
-
});
|
|
126
|
-
|
|
127
|
-
test('boot prefers explicit device selector over active session device', async () => {
|
|
128
|
-
const sessionStore = makeSessionStore();
|
|
129
|
-
const sessionName = 'default';
|
|
130
|
-
sessionStore.set(
|
|
131
|
-
sessionName,
|
|
132
|
-
makeSession(sessionName, {
|
|
133
|
-
platform: 'android',
|
|
134
|
-
id: 'emulator-5554',
|
|
135
|
-
name: 'Pixel Emulator',
|
|
136
|
-
kind: 'emulator',
|
|
137
|
-
booted: true,
|
|
138
|
-
}),
|
|
139
|
-
);
|
|
140
|
-
const selectedDevice: SessionState['device'] = {
|
|
141
|
-
platform: 'ios',
|
|
142
|
-
id: 'sim-2',
|
|
143
|
-
name: 'iPhone 17 Pro',
|
|
144
|
-
kind: 'simulator',
|
|
145
|
-
booted: true,
|
|
146
|
-
};
|
|
147
|
-
|
|
148
|
-
const ensured: string[] = [];
|
|
149
|
-
const response = await handleSessionCommands({
|
|
150
|
-
req: {
|
|
151
|
-
token: 't',
|
|
152
|
-
session: sessionName,
|
|
153
|
-
command: 'boot',
|
|
154
|
-
positionals: [],
|
|
155
|
-
flags: { platform: 'ios', device: 'iPhone 17 Pro' },
|
|
156
|
-
},
|
|
157
|
-
sessionName,
|
|
158
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
159
|
-
sessionStore,
|
|
160
|
-
invoke: noopInvoke,
|
|
161
|
-
ensureReady: async (device) => {
|
|
162
|
-
ensured.push(device.id);
|
|
163
|
-
},
|
|
164
|
-
resolveTargetDevice: async () => selectedDevice,
|
|
165
|
-
});
|
|
166
|
-
|
|
167
|
-
assert.ok(response);
|
|
168
|
-
assert.equal(response?.ok, true);
|
|
169
|
-
assert.deepEqual(ensured, ['sim-2']);
|
|
170
|
-
if (response && response.ok) {
|
|
171
|
-
assert.equal(response.data?.platform, 'ios');
|
|
172
|
-
assert.equal(response.data?.id, 'sim-2');
|
|
173
|
-
}
|
|
174
|
-
});
|
|
175
|
-
|
|
176
|
-
test('appstate on iOS requires active session on selected device', async () => {
|
|
177
|
-
const sessionStore = makeSessionStore();
|
|
178
|
-
const sessionName = 'default';
|
|
179
|
-
sessionStore.set(
|
|
180
|
-
sessionName,
|
|
181
|
-
{
|
|
182
|
-
...makeSession(sessionName, {
|
|
183
|
-
platform: 'ios',
|
|
184
|
-
id: 'sim-1',
|
|
185
|
-
name: 'iPhone 15',
|
|
186
|
-
kind: 'simulator',
|
|
187
|
-
booted: true,
|
|
188
|
-
}),
|
|
189
|
-
appBundleId: 'com.apple.Preferences',
|
|
190
|
-
appName: 'Settings',
|
|
191
|
-
},
|
|
192
|
-
);
|
|
193
|
-
const selectedDevice: SessionState['device'] = {
|
|
194
|
-
platform: 'ios',
|
|
195
|
-
id: 'sim-2',
|
|
196
|
-
name: 'iPhone 17 Pro',
|
|
197
|
-
kind: 'simulator',
|
|
198
|
-
booted: true,
|
|
199
|
-
};
|
|
200
|
-
|
|
201
|
-
const response = await handleSessionCommands({
|
|
202
|
-
req: {
|
|
203
|
-
token: 't',
|
|
204
|
-
session: sessionName,
|
|
205
|
-
command: 'appstate',
|
|
206
|
-
positionals: [],
|
|
207
|
-
flags: { platform: 'ios', device: 'iPhone 17 Pro' },
|
|
208
|
-
},
|
|
209
|
-
sessionName,
|
|
210
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
211
|
-
sessionStore,
|
|
212
|
-
invoke: noopInvoke,
|
|
213
|
-
ensureReady: async () => {},
|
|
214
|
-
resolveTargetDevice: async () => selectedDevice,
|
|
215
|
-
dispatch: async () => {
|
|
216
|
-
throw new Error('snapshot dispatch should not run');
|
|
217
|
-
},
|
|
218
|
-
});
|
|
219
|
-
|
|
220
|
-
assert.ok(response);
|
|
221
|
-
assert.equal(response?.ok, false);
|
|
222
|
-
if (response && !response.ok) {
|
|
223
|
-
assert.equal(response.error.code, 'SESSION_NOT_FOUND');
|
|
224
|
-
assert.match(response.error.message, /requires an active session/i);
|
|
225
|
-
}
|
|
226
|
-
});
|
|
227
|
-
|
|
228
|
-
test('appstate with explicit selector matching session returns session state', async () => {
|
|
229
|
-
const sessionStore = makeSessionStore();
|
|
230
|
-
const sessionName = 'sim';
|
|
231
|
-
sessionStore.set(
|
|
232
|
-
sessionName,
|
|
233
|
-
{
|
|
234
|
-
...makeSession(sessionName, {
|
|
235
|
-
platform: 'ios',
|
|
236
|
-
id: 'sim-1',
|
|
237
|
-
name: 'iPhone 17 Pro',
|
|
238
|
-
kind: 'simulator',
|
|
239
|
-
booted: true,
|
|
240
|
-
}),
|
|
241
|
-
appBundleId: 'com.apple.Maps',
|
|
242
|
-
appName: 'Maps',
|
|
243
|
-
},
|
|
244
|
-
);
|
|
245
|
-
|
|
246
|
-
const response = await handleSessionCommands({
|
|
247
|
-
req: {
|
|
248
|
-
token: 't',
|
|
249
|
-
session: sessionName,
|
|
250
|
-
command: 'appstate',
|
|
251
|
-
positionals: [],
|
|
252
|
-
flags: { platform: 'ios', device: 'iPhone 17 Pro' },
|
|
253
|
-
},
|
|
254
|
-
sessionName,
|
|
255
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
256
|
-
sessionStore,
|
|
257
|
-
invoke: noopInvoke,
|
|
258
|
-
ensureReady: async () => {},
|
|
259
|
-
dispatch: async () => {
|
|
260
|
-
throw new Error('snapshot dispatch should not run');
|
|
261
|
-
},
|
|
262
|
-
resolveTargetDevice: async () => {
|
|
263
|
-
throw new Error('resolveTargetDevice should not run');
|
|
264
|
-
},
|
|
265
|
-
});
|
|
266
|
-
|
|
267
|
-
assert.ok(response);
|
|
268
|
-
assert.equal(response?.ok, true);
|
|
269
|
-
if (response && response.ok) {
|
|
270
|
-
assert.equal(response.data?.platform, 'ios');
|
|
271
|
-
assert.equal(response.data?.appName, 'Maps');
|
|
272
|
-
assert.equal(response.data?.appBundleId, 'com.apple.Maps');
|
|
273
|
-
assert.equal(response.data?.source, 'session');
|
|
274
|
-
}
|
|
275
|
-
});
|
|
276
|
-
|
|
277
|
-
test('appstate returns session appName when bundle id is unavailable', async () => {
|
|
278
|
-
const sessionStore = makeSessionStore();
|
|
279
|
-
const sessionName = 'sim';
|
|
280
|
-
sessionStore.set(
|
|
281
|
-
sessionName,
|
|
282
|
-
{
|
|
283
|
-
...makeSession(sessionName, {
|
|
284
|
-
platform: 'ios',
|
|
285
|
-
id: 'sim-1',
|
|
286
|
-
name: 'iPhone 17 Pro',
|
|
287
|
-
kind: 'simulator',
|
|
288
|
-
booted: true,
|
|
289
|
-
}),
|
|
290
|
-
appName: 'Maps',
|
|
291
|
-
},
|
|
292
|
-
);
|
|
293
|
-
|
|
294
|
-
const response = await handleSessionCommands({
|
|
295
|
-
req: {
|
|
296
|
-
token: 't',
|
|
297
|
-
session: sessionName,
|
|
298
|
-
command: 'appstate',
|
|
299
|
-
positionals: [],
|
|
300
|
-
flags: { platform: 'ios', device: 'iPhone 17 Pro' },
|
|
301
|
-
},
|
|
302
|
-
sessionName,
|
|
303
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
304
|
-
sessionStore,
|
|
305
|
-
invoke: noopInvoke,
|
|
306
|
-
ensureReady: async () => {},
|
|
307
|
-
dispatch: async () => {
|
|
308
|
-
throw new Error('snapshot dispatch should not run');
|
|
309
|
-
},
|
|
310
|
-
resolveTargetDevice: async () => {
|
|
311
|
-
throw new Error('resolveTargetDevice should not run');
|
|
312
|
-
},
|
|
313
|
-
});
|
|
314
|
-
|
|
315
|
-
assert.ok(response);
|
|
316
|
-
assert.equal(response?.ok, true);
|
|
317
|
-
if (response && response.ok) {
|
|
318
|
-
assert.equal(response.data?.platform, 'ios');
|
|
319
|
-
assert.equal(response.data?.appName, 'Maps');
|
|
320
|
-
assert.equal(response.data?.appBundleId, undefined);
|
|
321
|
-
assert.equal(response.data?.source, 'session');
|
|
322
|
-
}
|
|
323
|
-
});
|
|
324
|
-
|
|
325
|
-
test('appstate fails when iOS session has no tracked app', async () => {
|
|
326
|
-
const sessionStore = makeSessionStore();
|
|
327
|
-
const sessionName = 'sim';
|
|
328
|
-
sessionStore.set(
|
|
329
|
-
sessionName,
|
|
330
|
-
makeSession(sessionName, {
|
|
331
|
-
platform: 'ios',
|
|
332
|
-
id: 'sim-1',
|
|
333
|
-
name: 'iPhone 17 Pro',
|
|
334
|
-
kind: 'simulator',
|
|
335
|
-
booted: true,
|
|
336
|
-
}),
|
|
337
|
-
);
|
|
338
|
-
|
|
339
|
-
const response = await handleSessionCommands({
|
|
340
|
-
req: {
|
|
341
|
-
token: 't',
|
|
342
|
-
session: sessionName,
|
|
343
|
-
command: 'appstate',
|
|
344
|
-
positionals: [],
|
|
345
|
-
flags: { platform: 'ios', device: 'iPhone 17 Pro' },
|
|
346
|
-
},
|
|
347
|
-
sessionName,
|
|
348
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
349
|
-
sessionStore,
|
|
350
|
-
invoke: noopInvoke,
|
|
351
|
-
ensureReady: async () => {},
|
|
352
|
-
});
|
|
353
|
-
|
|
354
|
-
assert.ok(response);
|
|
355
|
-
assert.equal(response?.ok, false);
|
|
356
|
-
if (response && !response.ok) {
|
|
357
|
-
assert.equal(response.error.code, 'COMMAND_FAILED');
|
|
358
|
-
assert.match(response.error.message, /no foreground app is tracked/i);
|
|
359
|
-
}
|
|
360
|
-
});
|
|
361
|
-
|
|
362
|
-
test('appstate without session on iOS selector returns SESSION_NOT_FOUND', async () => {
|
|
363
|
-
const sessionStore = makeSessionStore();
|
|
364
|
-
const selectedDevice: SessionState['device'] = {
|
|
365
|
-
platform: 'ios',
|
|
366
|
-
id: 'sim-2',
|
|
367
|
-
name: 'iPhone 17 Pro',
|
|
368
|
-
kind: 'simulator',
|
|
369
|
-
booted: true,
|
|
370
|
-
};
|
|
371
|
-
|
|
372
|
-
const response = await handleSessionCommands({
|
|
373
|
-
req: {
|
|
374
|
-
token: 't',
|
|
375
|
-
session: 'default',
|
|
376
|
-
command: 'appstate',
|
|
377
|
-
positionals: [],
|
|
378
|
-
flags: { platform: 'ios', device: 'iPhone 17 Pro' },
|
|
379
|
-
},
|
|
380
|
-
sessionName: 'default',
|
|
381
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
382
|
-
sessionStore,
|
|
383
|
-
invoke: noopInvoke,
|
|
384
|
-
ensureReady: async () => {},
|
|
385
|
-
resolveTargetDevice: async () => selectedDevice,
|
|
386
|
-
});
|
|
387
|
-
|
|
388
|
-
assert.ok(response);
|
|
389
|
-
assert.equal(response?.ok, false);
|
|
390
|
-
if (response && !response.ok) {
|
|
391
|
-
assert.equal(response.error.code, 'SESSION_NOT_FOUND');
|
|
392
|
-
}
|
|
393
|
-
});
|
|
394
|
-
|
|
395
|
-
test('appstate with explicit missing session returns SESSION_NOT_FOUND', async () => {
|
|
396
|
-
const sessionStore = makeSessionStore();
|
|
397
|
-
const response = await handleSessionCommands({
|
|
398
|
-
req: {
|
|
399
|
-
token: 't',
|
|
400
|
-
session: 'sim',
|
|
401
|
-
command: 'appstate',
|
|
402
|
-
positionals: [],
|
|
403
|
-
flags: { session: 'sim', platform: 'ios', device: 'iPhone 17 Pro' },
|
|
404
|
-
},
|
|
405
|
-
sessionName: 'sim',
|
|
406
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
407
|
-
sessionStore,
|
|
408
|
-
invoke: noopInvoke,
|
|
409
|
-
});
|
|
410
|
-
|
|
411
|
-
assert.ok(response);
|
|
412
|
-
assert.equal(response?.ok, false);
|
|
413
|
-
if (response && !response.ok) {
|
|
414
|
-
assert.equal(response.error.code, 'SESSION_NOT_FOUND');
|
|
415
|
-
assert.match(response.error.message, /no active session "sim"/i);
|
|
416
|
-
assert.doesNotMatch(response.error.message, /omit --session/i);
|
|
417
|
-
}
|
|
418
|
-
});
|
|
419
|
-
|
|
420
|
-
test('open URL on existing iOS session clears stale app bundle id', async () => {
|
|
421
|
-
const sessionStore = makeSessionStore();
|
|
422
|
-
const sessionName = 'ios-session';
|
|
423
|
-
sessionStore.set(
|
|
424
|
-
sessionName,
|
|
425
|
-
{
|
|
426
|
-
...makeSession(sessionName, {
|
|
427
|
-
platform: 'ios',
|
|
428
|
-
id: 'sim-1',
|
|
429
|
-
name: 'iPhone 15',
|
|
430
|
-
kind: 'simulator',
|
|
431
|
-
booted: true,
|
|
432
|
-
}),
|
|
433
|
-
appBundleId: 'com.example.old',
|
|
434
|
-
appName: 'Old App',
|
|
435
|
-
},
|
|
436
|
-
);
|
|
437
|
-
|
|
438
|
-
let dispatchedContext: Record<string, unknown> | undefined;
|
|
439
|
-
const response = await handleSessionCommands({
|
|
440
|
-
req: {
|
|
441
|
-
token: 't',
|
|
442
|
-
session: sessionName,
|
|
443
|
-
command: 'open',
|
|
444
|
-
positionals: ['https://example.com/path'],
|
|
445
|
-
flags: {},
|
|
446
|
-
},
|
|
447
|
-
sessionName,
|
|
448
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
449
|
-
sessionStore,
|
|
450
|
-
invoke: noopInvoke,
|
|
451
|
-
dispatch: async (_device, _command, _positionals, _out, context) => {
|
|
452
|
-
dispatchedContext = context as Record<string, unknown> | undefined;
|
|
453
|
-
return {};
|
|
454
|
-
},
|
|
455
|
-
ensureReady: async () => {},
|
|
456
|
-
});
|
|
457
|
-
|
|
458
|
-
assert.ok(response);
|
|
459
|
-
assert.equal(response?.ok, true);
|
|
460
|
-
const updated = sessionStore.get(sessionName);
|
|
461
|
-
assert.equal(updated?.appBundleId, undefined);
|
|
462
|
-
assert.equal(updated?.appName, 'https://example.com/path');
|
|
463
|
-
assert.equal(dispatchedContext?.appBundleId, undefined);
|
|
464
|
-
});
|
|
465
|
-
|
|
466
|
-
test('open URL on existing iOS device session preserves app bundle id context', async () => {
|
|
467
|
-
const sessionStore = makeSessionStore();
|
|
468
|
-
const sessionName = 'ios-device-session';
|
|
469
|
-
sessionStore.set(
|
|
470
|
-
sessionName,
|
|
471
|
-
{
|
|
472
|
-
...makeSession(sessionName, {
|
|
473
|
-
platform: 'ios',
|
|
474
|
-
id: 'ios-device-1',
|
|
475
|
-
name: 'iPhone Device',
|
|
476
|
-
kind: 'device',
|
|
477
|
-
booted: true,
|
|
478
|
-
}),
|
|
479
|
-
appBundleId: 'com.example.app',
|
|
480
|
-
appName: 'Example App',
|
|
481
|
-
},
|
|
482
|
-
);
|
|
483
|
-
|
|
484
|
-
let dispatchedContext: Record<string, unknown> | undefined;
|
|
485
|
-
const response = await handleSessionCommands({
|
|
486
|
-
req: {
|
|
487
|
-
token: 't',
|
|
488
|
-
session: sessionName,
|
|
489
|
-
command: 'open',
|
|
490
|
-
positionals: ['myapp://item/42'],
|
|
491
|
-
flags: {},
|
|
492
|
-
},
|
|
493
|
-
sessionName,
|
|
494
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
495
|
-
sessionStore,
|
|
496
|
-
invoke: noopInvoke,
|
|
497
|
-
dispatch: async (_device, _command, _positionals, _out, context) => {
|
|
498
|
-
dispatchedContext = context as Record<string, unknown> | undefined;
|
|
499
|
-
return {};
|
|
500
|
-
},
|
|
501
|
-
ensureReady: async () => {},
|
|
502
|
-
});
|
|
503
|
-
|
|
504
|
-
assert.ok(response);
|
|
505
|
-
assert.equal(response?.ok, true);
|
|
506
|
-
const updated = sessionStore.get(sessionName);
|
|
507
|
-
assert.equal(updated?.appBundleId, 'com.example.app');
|
|
508
|
-
assert.equal(updated?.appName, 'myapp://item/42');
|
|
509
|
-
assert.equal(dispatchedContext?.appBundleId, 'com.example.app');
|
|
510
|
-
});
|
|
511
|
-
|
|
512
|
-
test('open web URL on iOS device session without active app falls back to Safari', async () => {
|
|
513
|
-
const sessionStore = makeSessionStore();
|
|
514
|
-
const sessionName = 'ios-device-session';
|
|
515
|
-
sessionStore.set(
|
|
516
|
-
sessionName,
|
|
517
|
-
makeSession(sessionName, {
|
|
518
|
-
platform: 'ios',
|
|
519
|
-
id: 'ios-device-1',
|
|
520
|
-
name: 'iPhone Device',
|
|
521
|
-
kind: 'device',
|
|
522
|
-
booted: true,
|
|
523
|
-
}),
|
|
524
|
-
);
|
|
525
|
-
|
|
526
|
-
let dispatchedContext: Record<string, unknown> | undefined;
|
|
527
|
-
const response = await handleSessionCommands({
|
|
528
|
-
req: {
|
|
529
|
-
token: 't',
|
|
530
|
-
session: sessionName,
|
|
531
|
-
command: 'open',
|
|
532
|
-
positionals: ['https://example.com/path'],
|
|
533
|
-
flags: {},
|
|
534
|
-
},
|
|
535
|
-
sessionName,
|
|
536
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
537
|
-
sessionStore,
|
|
538
|
-
invoke: noopInvoke,
|
|
539
|
-
dispatch: async (_device, _command, _positionals, _out, context) => {
|
|
540
|
-
dispatchedContext = context as Record<string, unknown> | undefined;
|
|
541
|
-
return {};
|
|
542
|
-
},
|
|
543
|
-
ensureReady: async () => {},
|
|
544
|
-
});
|
|
545
|
-
|
|
546
|
-
assert.ok(response);
|
|
547
|
-
assert.equal(response?.ok, true);
|
|
548
|
-
const updated = sessionStore.get(sessionName);
|
|
549
|
-
assert.equal(updated?.appBundleId, 'com.apple.mobilesafari');
|
|
550
|
-
assert.equal(updated?.appName, 'https://example.com/path');
|
|
551
|
-
assert.equal(dispatchedContext?.appBundleId, 'com.apple.mobilesafari');
|
|
552
|
-
});
|
|
553
|
-
|
|
554
|
-
test('open app and URL on existing iOS device session keeps app context', async () => {
|
|
555
|
-
const sessionStore = makeSessionStore();
|
|
556
|
-
const sessionName = 'ios-device-session';
|
|
557
|
-
sessionStore.set(
|
|
558
|
-
sessionName,
|
|
559
|
-
{
|
|
560
|
-
...makeSession(sessionName, {
|
|
561
|
-
platform: 'ios',
|
|
562
|
-
id: 'ios-device-1',
|
|
563
|
-
name: 'iPhone Device',
|
|
564
|
-
kind: 'device',
|
|
565
|
-
booted: true,
|
|
566
|
-
}),
|
|
567
|
-
appBundleId: 'com.example.previous',
|
|
568
|
-
appName: 'Previous App',
|
|
569
|
-
},
|
|
570
|
-
);
|
|
571
|
-
|
|
572
|
-
let dispatchedPositionals: string[] | undefined;
|
|
573
|
-
let dispatchedContext: Record<string, unknown> | undefined;
|
|
574
|
-
const response = await handleSessionCommands({
|
|
575
|
-
req: {
|
|
576
|
-
token: 't',
|
|
577
|
-
session: sessionName,
|
|
578
|
-
command: 'open',
|
|
579
|
-
positionals: ['Settings', 'myapp://screen/to'],
|
|
580
|
-
flags: {},
|
|
581
|
-
},
|
|
582
|
-
sessionName,
|
|
583
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
584
|
-
sessionStore,
|
|
585
|
-
invoke: noopInvoke,
|
|
586
|
-
dispatch: async (_device, _command, positionals, _out, context) => {
|
|
587
|
-
dispatchedPositionals = positionals;
|
|
588
|
-
dispatchedContext = context as Record<string, unknown> | undefined;
|
|
589
|
-
return {};
|
|
590
|
-
},
|
|
591
|
-
ensureReady: async () => {},
|
|
592
|
-
});
|
|
593
|
-
|
|
594
|
-
assert.ok(response);
|
|
595
|
-
assert.equal(response?.ok, true);
|
|
596
|
-
const updated = sessionStore.get(sessionName);
|
|
597
|
-
assert.equal(updated?.appBundleId, 'com.apple.Preferences');
|
|
598
|
-
assert.equal(updated?.appName, 'Settings');
|
|
599
|
-
assert.deepEqual(dispatchedPositionals, ['Settings', 'myapp://screen/to']);
|
|
600
|
-
assert.equal(dispatchedContext?.appBundleId, 'com.apple.Preferences');
|
|
601
|
-
});
|
|
602
|
-
|
|
603
|
-
test('open app on existing iOS session resolves and stores bundle id', async () => {
|
|
604
|
-
const sessionStore = makeSessionStore();
|
|
605
|
-
const sessionName = 'ios-session';
|
|
606
|
-
sessionStore.set(
|
|
607
|
-
sessionName,
|
|
608
|
-
{
|
|
609
|
-
...makeSession(sessionName, {
|
|
610
|
-
platform: 'ios',
|
|
611
|
-
id: 'sim-1',
|
|
612
|
-
name: 'iPhone 15',
|
|
613
|
-
kind: 'simulator',
|
|
614
|
-
booted: true,
|
|
615
|
-
}),
|
|
616
|
-
appBundleId: 'com.example.old',
|
|
617
|
-
appName: 'Old App',
|
|
618
|
-
},
|
|
619
|
-
);
|
|
620
|
-
|
|
621
|
-
let dispatchedContext: Record<string, unknown> | undefined;
|
|
622
|
-
const response = await handleSessionCommands({
|
|
623
|
-
req: {
|
|
624
|
-
token: 't',
|
|
625
|
-
session: sessionName,
|
|
626
|
-
command: 'open',
|
|
627
|
-
positionals: ['settings'],
|
|
628
|
-
flags: {},
|
|
629
|
-
},
|
|
630
|
-
sessionName,
|
|
631
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
632
|
-
sessionStore,
|
|
633
|
-
invoke: noopInvoke,
|
|
634
|
-
dispatch: async (_device, _command, _positionals, _out, context) => {
|
|
635
|
-
dispatchedContext = context as Record<string, unknown> | undefined;
|
|
636
|
-
return {};
|
|
637
|
-
},
|
|
638
|
-
ensureReady: async () => {},
|
|
639
|
-
});
|
|
640
|
-
|
|
641
|
-
assert.ok(response);
|
|
642
|
-
assert.equal(response?.ok, true);
|
|
643
|
-
const updated = sessionStore.get(sessionName);
|
|
644
|
-
assert.equal(updated?.appBundleId, 'com.apple.Preferences');
|
|
645
|
-
assert.equal(updated?.appName, 'settings');
|
|
646
|
-
assert.equal(dispatchedContext?.appBundleId, 'com.apple.Preferences');
|
|
647
|
-
});
|
|
648
|
-
|
|
649
|
-
test('open --relaunch closes and reopens active session app', async () => {
|
|
650
|
-
const sessionStore = makeSessionStore();
|
|
651
|
-
const sessionName = 'android-session';
|
|
652
|
-
sessionStore.set(
|
|
653
|
-
sessionName,
|
|
654
|
-
{
|
|
655
|
-
...makeSession(sessionName, {
|
|
656
|
-
platform: 'android',
|
|
657
|
-
id: 'emulator-5554',
|
|
658
|
-
name: 'Pixel Emulator',
|
|
659
|
-
kind: 'emulator',
|
|
660
|
-
booted: true,
|
|
661
|
-
}),
|
|
662
|
-
appName: 'com.example.app',
|
|
663
|
-
},
|
|
664
|
-
);
|
|
665
|
-
|
|
666
|
-
const calls: Array<{ command: string; positionals: string[] }> = [];
|
|
667
|
-
const response = await handleSessionCommands({
|
|
668
|
-
req: {
|
|
669
|
-
token: 't',
|
|
670
|
-
session: sessionName,
|
|
671
|
-
command: 'open',
|
|
672
|
-
positionals: [],
|
|
673
|
-
flags: { relaunch: true },
|
|
674
|
-
},
|
|
675
|
-
sessionName,
|
|
676
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
677
|
-
sessionStore,
|
|
678
|
-
invoke: noopInvoke,
|
|
679
|
-
dispatch: async (_device, command, positionals) => {
|
|
680
|
-
calls.push({ command, positionals });
|
|
681
|
-
return {};
|
|
682
|
-
},
|
|
683
|
-
ensureReady: async () => {},
|
|
684
|
-
});
|
|
685
|
-
|
|
686
|
-
assert.ok(response);
|
|
687
|
-
assert.equal(response?.ok, true);
|
|
688
|
-
assert.equal(calls.length, 2);
|
|
689
|
-
assert.deepEqual(calls[0], { command: 'close', positionals: ['com.example.app'] });
|
|
690
|
-
assert.deepEqual(calls[1], { command: 'open', positionals: ['com.example.app'] });
|
|
691
|
-
});
|
|
692
|
-
|
|
693
|
-
test('open --relaunch rejects URL targets', async () => {
|
|
694
|
-
const sessionStore = makeSessionStore();
|
|
695
|
-
const response = await handleSessionCommands({
|
|
696
|
-
req: {
|
|
697
|
-
token: 't',
|
|
698
|
-
session: 'default',
|
|
699
|
-
command: 'open',
|
|
700
|
-
positionals: ['https://example.com/path'],
|
|
701
|
-
flags: { relaunch: true },
|
|
702
|
-
},
|
|
703
|
-
sessionName: 'default',
|
|
704
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
705
|
-
sessionStore,
|
|
706
|
-
invoke: noopInvoke,
|
|
707
|
-
});
|
|
708
|
-
|
|
709
|
-
assert.ok(response);
|
|
710
|
-
assert.equal(response?.ok, false);
|
|
711
|
-
if (response && !response.ok) {
|
|
712
|
-
assert.equal(response.error.code, 'INVALID_ARGS');
|
|
713
|
-
assert.match(response.error.message, /does not support URL targets/i);
|
|
714
|
-
}
|
|
715
|
-
});
|
|
716
|
-
|
|
717
|
-
test('open --relaunch fails without app when no session exists', async () => {
|
|
718
|
-
const sessionStore = makeSessionStore();
|
|
719
|
-
const response = await handleSessionCommands({
|
|
720
|
-
req: {
|
|
721
|
-
token: 't',
|
|
722
|
-
session: 'default',
|
|
723
|
-
command: 'open',
|
|
724
|
-
positionals: [],
|
|
725
|
-
flags: { relaunch: true },
|
|
726
|
-
},
|
|
727
|
-
sessionName: 'default',
|
|
728
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
729
|
-
sessionStore,
|
|
730
|
-
invoke: noopInvoke,
|
|
731
|
-
});
|
|
732
|
-
|
|
733
|
-
assert.ok(response);
|
|
734
|
-
assert.equal(response?.ok, false);
|
|
735
|
-
if (response && !response.ok) {
|
|
736
|
-
assert.equal(response.error.code, 'INVALID_ARGS');
|
|
737
|
-
assert.match(response.error.message, /requires an app argument/i);
|
|
738
|
-
}
|
|
739
|
-
});
|
|
740
|
-
|
|
741
|
-
test('open on in-use device returns DEVICE_IN_USE before readiness checks', async () => {
|
|
742
|
-
const sessionStore = makeSessionStore();
|
|
743
|
-
sessionStore.set(
|
|
744
|
-
'busy-session',
|
|
745
|
-
makeSession('busy-session', {
|
|
746
|
-
platform: 'ios',
|
|
747
|
-
id: 'ios-device-1',
|
|
748
|
-
name: 'iPhone Device',
|
|
749
|
-
kind: 'device',
|
|
750
|
-
booted: true,
|
|
751
|
-
}),
|
|
752
|
-
);
|
|
753
|
-
|
|
754
|
-
let ensureReadyCalls = 0;
|
|
755
|
-
const response = await handleSessionCommands({
|
|
756
|
-
req: {
|
|
757
|
-
token: 't',
|
|
758
|
-
session: 'default',
|
|
759
|
-
command: 'open',
|
|
760
|
-
positionals: ['settings'],
|
|
761
|
-
flags: { platform: 'ios' },
|
|
762
|
-
},
|
|
763
|
-
sessionName: 'default',
|
|
764
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
765
|
-
sessionStore,
|
|
766
|
-
invoke: noopInvoke,
|
|
767
|
-
ensureReady: async () => {
|
|
768
|
-
ensureReadyCalls += 1;
|
|
769
|
-
},
|
|
770
|
-
resolveTargetDevice: async () => ({
|
|
771
|
-
platform: 'ios',
|
|
772
|
-
id: 'ios-device-1',
|
|
773
|
-
name: 'iPhone Device',
|
|
774
|
-
kind: 'device',
|
|
775
|
-
booted: true,
|
|
776
|
-
}),
|
|
777
|
-
});
|
|
778
|
-
|
|
779
|
-
assert.ok(response);
|
|
780
|
-
assert.equal(response?.ok, false);
|
|
781
|
-
if (response && !response.ok) {
|
|
782
|
-
assert.equal(response.error.code, 'DEVICE_IN_USE');
|
|
783
|
-
}
|
|
784
|
-
assert.equal(ensureReadyCalls, 0);
|
|
785
|
-
});
|
|
786
|
-
|
|
787
|
-
test('replay parses open --relaunch flag and replays open with relaunch semantics', async () => {
|
|
788
|
-
const sessionStore = makeSessionStore();
|
|
789
|
-
const replayRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'agent-device-replay-relaunch-'));
|
|
790
|
-
const replayPath = path.join(replayRoot, 'relaunch.ad');
|
|
791
|
-
fs.writeFileSync(replayPath, 'open "Settings" --relaunch\n');
|
|
792
|
-
|
|
793
|
-
const invoked: DaemonRequest[] = [];
|
|
794
|
-
const response = await handleSessionCommands({
|
|
795
|
-
req: {
|
|
796
|
-
token: 't',
|
|
797
|
-
session: 'default',
|
|
798
|
-
command: 'replay',
|
|
799
|
-
positionals: [replayPath],
|
|
800
|
-
flags: {},
|
|
801
|
-
},
|
|
802
|
-
sessionName: 'default',
|
|
803
|
-
logPath: path.join(os.tmpdir(), 'daemon.log'),
|
|
804
|
-
sessionStore,
|
|
805
|
-
invoke: async (req) => {
|
|
806
|
-
invoked.push(req);
|
|
807
|
-
return { ok: true, data: {} };
|
|
808
|
-
},
|
|
809
|
-
});
|
|
810
|
-
|
|
811
|
-
assert.ok(response);
|
|
812
|
-
assert.equal(response?.ok, true);
|
|
813
|
-
if (response && response.ok) {
|
|
814
|
-
assert.equal(response.data?.replayed, 1);
|
|
815
|
-
}
|
|
816
|
-
assert.equal(invoked.length, 1);
|
|
817
|
-
assert.equal(invoked[0]?.command, 'open');
|
|
818
|
-
assert.deepEqual(invoked[0]?.positionals, ['Settings']);
|
|
819
|
-
assert.equal(invoked[0]?.flags?.relaunch, true);
|
|
820
|
-
});
|