agent-device 0.4.2 → 0.5.1

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