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.
Files changed (91) hide show
  1. package/README.md +2 -9
  2. package/dist/src/797.js +1 -1
  3. package/dist/src/bin.js +5 -5
  4. package/dist/src/daemon.js +16 -20
  5. package/package.json +7 -9
  6. package/skills/agent-device/SKILL.md +3 -6
  7. package/skills/agent-device/references/permissions.md +3 -15
  8. package/skills/agent-device/references/snapshot-refs.md +1 -4
  9. package/dist/bin/axsnapshot +0 -0
  10. package/ios-runner/AXSnapshot/Package.swift +0 -18
  11. package/ios-runner/AXSnapshot/Sources/AXSnapshot/main.swift +0 -444
  12. package/src/__tests__/cli-close.test.ts +0 -155
  13. package/src/__tests__/cli-help.test.ts +0 -102
  14. package/src/bin.ts +0 -3
  15. package/src/cli.ts +0 -305
  16. package/src/core/__tests__/capabilities.test.ts +0 -75
  17. package/src/core/__tests__/dispatch-open.test.ts +0 -25
  18. package/src/core/__tests__/open-target.test.ts +0 -55
  19. package/src/core/capabilities.ts +0 -57
  20. package/src/core/dispatch.ts +0 -382
  21. package/src/core/open-target.ts +0 -27
  22. package/src/daemon/__tests__/device-ready.test.ts +0 -52
  23. package/src/daemon/__tests__/is-predicates.test.ts +0 -68
  24. package/src/daemon/__tests__/selectors.test.ts +0 -261
  25. package/src/daemon/__tests__/session-routing.test.ts +0 -108
  26. package/src/daemon/__tests__/session-selector.test.ts +0 -64
  27. package/src/daemon/__tests__/session-store.test.ts +0 -142
  28. package/src/daemon/__tests__/snapshot-processing.test.ts +0 -47
  29. package/src/daemon/action-utils.ts +0 -29
  30. package/src/daemon/context.ts +0 -48
  31. package/src/daemon/device-ready.ts +0 -155
  32. package/src/daemon/handlers/__tests__/find.test.ts +0 -99
  33. package/src/daemon/handlers/__tests__/interaction.test.ts +0 -22
  34. package/src/daemon/handlers/__tests__/replay-heal.test.ts +0 -509
  35. package/src/daemon/handlers/__tests__/session-reinstall.test.ts +0 -219
  36. package/src/daemon/handlers/__tests__/session.test.ts +0 -820
  37. package/src/daemon/handlers/__tests__/snapshot-handler.test.ts +0 -92
  38. package/src/daemon/handlers/__tests__/snapshot.test.ts +0 -128
  39. package/src/daemon/handlers/find.ts +0 -324
  40. package/src/daemon/handlers/interaction.ts +0 -550
  41. package/src/daemon/handlers/parse-utils.ts +0 -8
  42. package/src/daemon/handlers/record-trace.ts +0 -154
  43. package/src/daemon/handlers/session.ts +0 -1137
  44. package/src/daemon/handlers/snapshot.ts +0 -439
  45. package/src/daemon/is-predicates.ts +0 -46
  46. package/src/daemon/selectors.ts +0 -540
  47. package/src/daemon/session-routing.ts +0 -22
  48. package/src/daemon/session-selector.ts +0 -39
  49. package/src/daemon/session-store.ts +0 -296
  50. package/src/daemon/snapshot-processing.ts +0 -131
  51. package/src/daemon/types.ts +0 -56
  52. package/src/daemon-client.ts +0 -272
  53. package/src/daemon.ts +0 -295
  54. package/src/platforms/__tests__/boot-diagnostics.test.ts +0 -59
  55. package/src/platforms/android/__tests__/index.test.ts +0 -274
  56. package/src/platforms/android/devices.ts +0 -196
  57. package/src/platforms/android/index.ts +0 -784
  58. package/src/platforms/android/ui-hierarchy.ts +0 -312
  59. package/src/platforms/boot-diagnostics.ts +0 -128
  60. package/src/platforms/ios/__tests__/index.test.ts +0 -312
  61. package/src/platforms/ios/__tests__/runner-client.test.ts +0 -155
  62. package/src/platforms/ios/apps.ts +0 -358
  63. package/src/platforms/ios/ax-snapshot.ts +0 -207
  64. package/src/platforms/ios/config.ts +0 -28
  65. package/src/platforms/ios/devicectl.ts +0 -134
  66. package/src/platforms/ios/devices.ts +0 -100
  67. package/src/platforms/ios/index.ts +0 -20
  68. package/src/platforms/ios/runner-client.ts +0 -994
  69. package/src/platforms/ios/simulator.ts +0 -164
  70. package/src/utils/__tests__/args.test.ts +0 -239
  71. package/src/utils/__tests__/daemon-client.test.ts +0 -95
  72. package/src/utils/__tests__/exec.test.ts +0 -16
  73. package/src/utils/__tests__/finders.test.ts +0 -34
  74. package/src/utils/__tests__/keyed-lock.test.ts +0 -55
  75. package/src/utils/__tests__/process-identity.test.ts +0 -33
  76. package/src/utils/__tests__/retry.test.ts +0 -44
  77. package/src/utils/args.ts +0 -239
  78. package/src/utils/command-schema.ts +0 -622
  79. package/src/utils/device.ts +0 -84
  80. package/src/utils/errors.ts +0 -35
  81. package/src/utils/exec.ts +0 -339
  82. package/src/utils/finders.ts +0 -101
  83. package/src/utils/interactive.ts +0 -4
  84. package/src/utils/interactors.ts +0 -173
  85. package/src/utils/keyed-lock.ts +0 -14
  86. package/src/utils/output.ts +0 -204
  87. package/src/utils/process-identity.ts +0 -100
  88. package/src/utils/retry.ts +0 -180
  89. package/src/utils/snapshot.ts +0 -64
  90. package/src/utils/timeouts.ts +0 -9
  91. 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
- });