@pellux/goodvibes-contracts 0.18.3

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 (34) hide show
  1. package/README.md +39 -0
  2. package/artifacts/operator-contract.json +55157 -0
  3. package/artifacts/peer-contract.json +2384 -0
  4. package/dist/generated/foundation-client-types.d.ts +11213 -0
  5. package/dist/generated/foundation-client-types.d.ts.map +1 -0
  6. package/dist/generated/foundation-client-types.js +2 -0
  7. package/dist/generated/foundation-metadata.d.ts +8 -0
  8. package/dist/generated/foundation-metadata.d.ts.map +1 -0
  9. package/dist/generated/foundation-metadata.js +7 -0
  10. package/dist/generated/operator-contract.d.ts +3 -0
  11. package/dist/generated/operator-contract.d.ts.map +1 -0
  12. package/dist/generated/operator-contract.js +55157 -0
  13. package/dist/generated/operator-method-ids.d.ts +3 -0
  14. package/dist/generated/operator-method-ids.d.ts.map +1 -0
  15. package/dist/generated/operator-method-ids.js +215 -0
  16. package/dist/generated/peer-contract.d.ts +3 -0
  17. package/dist/generated/peer-contract.d.ts.map +1 -0
  18. package/dist/generated/peer-contract.js +2384 -0
  19. package/dist/generated/peer-endpoint-ids.d.ts +3 -0
  20. package/dist/generated/peer-endpoint-ids.d.ts.map +1 -0
  21. package/dist/generated/peer-endpoint-ids.js +8 -0
  22. package/dist/generated/runtime-event-domains.d.ts +4 -0
  23. package/dist/generated/runtime-event-domains.d.ts.map +1 -0
  24. package/dist/generated/runtime-event-domains.js +31 -0
  25. package/dist/index.d.ts +23 -0
  26. package/dist/index.d.ts.map +1 -0
  27. package/dist/index.js +35 -0
  28. package/dist/node.d.ts +3 -0
  29. package/dist/node.d.ts.map +1 -0
  30. package/dist/node.js +7 -0
  31. package/dist/types.d.ts +150 -0
  32. package/dist/types.d.ts.map +1 -0
  33. package/dist/types.js +1 -0
  34. package/package.json +45 -0
@@ -0,0 +1,2384 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "transport": "http-json",
4
+ "basePath": "/api/remote",
5
+ "peerKinds": [
6
+ "node",
7
+ "device"
8
+ ],
9
+ "workTypes": [
10
+ "invoke",
11
+ "status.request",
12
+ "location.request",
13
+ "session.message",
14
+ "automation.run"
15
+ ],
16
+ "scopes": [
17
+ "remote:heartbeat",
18
+ "remote:pull",
19
+ "remote:complete"
20
+ ],
21
+ "recommendedHeartbeatMs": 30000,
22
+ "recommendedWorkPullMs": 2000,
23
+ "endpoints": [
24
+ {
25
+ "id": "pair.request",
26
+ "method": "POST",
27
+ "path": "/api/remote/pair/request",
28
+ "auth": "none",
29
+ "description": "Create a pending pair request and receive a challenge for operator approval.",
30
+ "inputSchema": {
31
+ "type": "object",
32
+ "properties": {
33
+ "peerKind": {
34
+ "type": "string",
35
+ "enum": [
36
+ "node",
37
+ "device"
38
+ ]
39
+ },
40
+ "label": {
41
+ "type": "string"
42
+ },
43
+ "requestedId": {
44
+ "type": "string"
45
+ },
46
+ "platform": {
47
+ "type": "string"
48
+ },
49
+ "deviceFamily": {
50
+ "type": "string"
51
+ },
52
+ "version": {
53
+ "type": "string"
54
+ },
55
+ "clientMode": {
56
+ "type": "string"
57
+ },
58
+ "capabilities": {
59
+ "type": "array",
60
+ "items": {
61
+ "type": "string"
62
+ }
63
+ },
64
+ "commands": {
65
+ "type": "array",
66
+ "items": {
67
+ "type": "string"
68
+ }
69
+ },
70
+ "ttlMs": {
71
+ "type": "number"
72
+ },
73
+ "metadata": {
74
+ "type": "object",
75
+ "additionalProperties": {
76
+ "anyOf": [
77
+ {
78
+ "type": "string"
79
+ },
80
+ {
81
+ "type": "number"
82
+ },
83
+ {
84
+ "type": "boolean"
85
+ },
86
+ {
87
+ "type": "null"
88
+ },
89
+ {
90
+ "type": "object",
91
+ "additionalProperties": {
92
+ "$ref": "$.endpoints[0].inputSchema.properties.metadata.additionalProperties"
93
+ }
94
+ },
95
+ {
96
+ "type": "array",
97
+ "items": {
98
+ "$ref": "$.endpoints[0].inputSchema.properties.metadata.additionalProperties"
99
+ }
100
+ }
101
+ ]
102
+ }
103
+ }
104
+ },
105
+ "required": [
106
+ "peerKind",
107
+ "label"
108
+ ],
109
+ "additionalProperties": true
110
+ },
111
+ "outputSchema": {
112
+ "type": "object",
113
+ "properties": {
114
+ "request": {
115
+ "type": "object",
116
+ "properties": {
117
+ "id": {
118
+ "type": "string"
119
+ },
120
+ "peerKind": {
121
+ "type": "string",
122
+ "enum": [
123
+ "node",
124
+ "device"
125
+ ]
126
+ },
127
+ "requestedId": {
128
+ "type": "string"
129
+ },
130
+ "label": {
131
+ "type": "string"
132
+ },
133
+ "platform": {
134
+ "type": "string"
135
+ },
136
+ "deviceFamily": {
137
+ "type": "string"
138
+ },
139
+ "version": {
140
+ "type": "string"
141
+ },
142
+ "clientMode": {
143
+ "type": "string"
144
+ },
145
+ "capabilities": {
146
+ "type": "array",
147
+ "items": {
148
+ "type": "string"
149
+ }
150
+ },
151
+ "commands": {
152
+ "type": "array",
153
+ "items": {
154
+ "type": "string"
155
+ }
156
+ },
157
+ "requestedBy": {
158
+ "type": "string",
159
+ "enum": [
160
+ "remote",
161
+ "operator"
162
+ ]
163
+ },
164
+ "status": {
165
+ "type": "string",
166
+ "enum": [
167
+ "pending",
168
+ "approved",
169
+ "verified",
170
+ "rejected",
171
+ "expired"
172
+ ]
173
+ },
174
+ "challengePreview": {
175
+ "type": "string"
176
+ },
177
+ "createdAt": {
178
+ "type": "number"
179
+ },
180
+ "updatedAt": {
181
+ "type": "number"
182
+ },
183
+ "approvedAt": {
184
+ "type": "number"
185
+ },
186
+ "verifiedAt": {
187
+ "type": "number"
188
+ },
189
+ "rejectedAt": {
190
+ "type": "number"
191
+ },
192
+ "expiresAt": {
193
+ "type": "number"
194
+ },
195
+ "peerId": {
196
+ "type": "string"
197
+ },
198
+ "remoteAddress": {
199
+ "type": "string"
200
+ },
201
+ "metadata": {
202
+ "type": "object",
203
+ "additionalProperties": {
204
+ "anyOf": [
205
+ {
206
+ "type": "string"
207
+ },
208
+ {
209
+ "type": "number"
210
+ },
211
+ {
212
+ "type": "boolean"
213
+ },
214
+ {
215
+ "type": "null"
216
+ },
217
+ {
218
+ "type": "object",
219
+ "additionalProperties": {
220
+ "$ref": "$.endpoints[0].outputSchema.properties.request.properties.metadata.additionalProperties"
221
+ }
222
+ },
223
+ {
224
+ "type": "array",
225
+ "items": {
226
+ "$ref": "$.endpoints[0].outputSchema.properties.request.properties.metadata.additionalProperties"
227
+ }
228
+ }
229
+ ]
230
+ }
231
+ }
232
+ },
233
+ "required": [
234
+ "id",
235
+ "peerKind",
236
+ "requestedId",
237
+ "label",
238
+ "capabilities",
239
+ "commands",
240
+ "requestedBy",
241
+ "status",
242
+ "challengePreview",
243
+ "createdAt",
244
+ "updatedAt",
245
+ "expiresAt",
246
+ "metadata"
247
+ ],
248
+ "additionalProperties": true
249
+ },
250
+ "challenge": {
251
+ "type": "string"
252
+ }
253
+ },
254
+ "required": [
255
+ "request",
256
+ "challenge"
257
+ ],
258
+ "additionalProperties": false
259
+ }
260
+ },
261
+ {
262
+ "id": "pair.verify",
263
+ "method": "POST",
264
+ "path": "/api/remote/pair/verify",
265
+ "auth": "none",
266
+ "description": "Exchange an approved pair request and challenge for a scoped peer token.",
267
+ "inputSchema": {
268
+ "type": "object",
269
+ "properties": {
270
+ "requestId": {
271
+ "type": "string"
272
+ },
273
+ "challenge": {
274
+ "type": "string"
275
+ },
276
+ "metadata": {
277
+ "type": "object",
278
+ "additionalProperties": {
279
+ "anyOf": [
280
+ {
281
+ "type": "string"
282
+ },
283
+ {
284
+ "type": "number"
285
+ },
286
+ {
287
+ "type": "boolean"
288
+ },
289
+ {
290
+ "type": "null"
291
+ },
292
+ {
293
+ "type": "object",
294
+ "additionalProperties": {
295
+ "$ref": "$.endpoints[1].inputSchema.properties.metadata.additionalProperties"
296
+ }
297
+ },
298
+ {
299
+ "type": "array",
300
+ "items": {
301
+ "$ref": "$.endpoints[1].inputSchema.properties.metadata.additionalProperties"
302
+ }
303
+ }
304
+ ]
305
+ }
306
+ }
307
+ },
308
+ "required": [
309
+ "requestId",
310
+ "challenge"
311
+ ],
312
+ "additionalProperties": true
313
+ },
314
+ "outputSchema": {
315
+ "type": "object",
316
+ "properties": {
317
+ "peer": {
318
+ "type": "object",
319
+ "properties": {
320
+ "id": {
321
+ "type": "string"
322
+ },
323
+ "kind": {
324
+ "type": "string",
325
+ "enum": [
326
+ "node",
327
+ "device"
328
+ ]
329
+ },
330
+ "label": {
331
+ "type": "string"
332
+ },
333
+ "requestedId": {
334
+ "type": "string"
335
+ },
336
+ "platform": {
337
+ "type": "string"
338
+ },
339
+ "deviceFamily": {
340
+ "type": "string"
341
+ },
342
+ "version": {
343
+ "type": "string"
344
+ },
345
+ "clientMode": {
346
+ "type": "string"
347
+ },
348
+ "capabilities": {
349
+ "type": "array",
350
+ "items": {
351
+ "type": "string"
352
+ }
353
+ },
354
+ "commands": {
355
+ "type": "array",
356
+ "items": {
357
+ "type": "string"
358
+ }
359
+ },
360
+ "permissions": {
361
+ "type": "object",
362
+ "additionalProperties": {
363
+ "type": "boolean"
364
+ }
365
+ },
366
+ "status": {
367
+ "type": "string",
368
+ "enum": [
369
+ "paired",
370
+ "connected",
371
+ "idle",
372
+ "disconnected",
373
+ "revoked"
374
+ ]
375
+ },
376
+ "pairedAt": {
377
+ "type": "number"
378
+ },
379
+ "verifiedAt": {
380
+ "type": "number"
381
+ },
382
+ "lastSeenAt": {
383
+ "type": "number"
384
+ },
385
+ "lastConnectedAt": {
386
+ "type": "number"
387
+ },
388
+ "lastDisconnectedAt": {
389
+ "type": "number"
390
+ },
391
+ "lastRemoteAddress": {
392
+ "type": "string"
393
+ },
394
+ "activeTokenId": {
395
+ "type": "string"
396
+ },
397
+ "tokens": {
398
+ "type": "array",
399
+ "items": {
400
+ "type": "object",
401
+ "properties": {
402
+ "id": {
403
+ "type": "string"
404
+ },
405
+ "label": {
406
+ "type": "string"
407
+ },
408
+ "scopes": {
409
+ "type": "array",
410
+ "items": {
411
+ "type": "string"
412
+ }
413
+ },
414
+ "issuedAt": {
415
+ "type": "number"
416
+ },
417
+ "lastUsedAt": {
418
+ "type": "number"
419
+ },
420
+ "rotatedAt": {
421
+ "type": "number"
422
+ },
423
+ "revokedAt": {
424
+ "type": "number"
425
+ },
426
+ "fingerprint": {
427
+ "type": "string"
428
+ }
429
+ },
430
+ "required": [
431
+ "id",
432
+ "label",
433
+ "scopes",
434
+ "issuedAt",
435
+ "fingerprint"
436
+ ],
437
+ "additionalProperties": true
438
+ }
439
+ },
440
+ "metadata": {
441
+ "type": "object",
442
+ "additionalProperties": {
443
+ "anyOf": [
444
+ {
445
+ "type": "string"
446
+ },
447
+ {
448
+ "type": "number"
449
+ },
450
+ {
451
+ "type": "boolean"
452
+ },
453
+ {
454
+ "type": "null"
455
+ },
456
+ {
457
+ "type": "object",
458
+ "additionalProperties": {
459
+ "$ref": "$.endpoints[1].outputSchema.properties.peer.properties.metadata.additionalProperties"
460
+ }
461
+ },
462
+ {
463
+ "type": "array",
464
+ "items": {
465
+ "$ref": "$.endpoints[1].outputSchema.properties.peer.properties.metadata.additionalProperties"
466
+ }
467
+ }
468
+ ]
469
+ }
470
+ }
471
+ },
472
+ "required": [
473
+ "id",
474
+ "kind",
475
+ "label",
476
+ "requestedId",
477
+ "capabilities",
478
+ "commands",
479
+ "status",
480
+ "pairedAt",
481
+ "tokens",
482
+ "metadata"
483
+ ],
484
+ "additionalProperties": true
485
+ },
486
+ "token": {
487
+ "type": "object",
488
+ "properties": {
489
+ "id": {
490
+ "type": "string"
491
+ },
492
+ "label": {
493
+ "type": "string"
494
+ },
495
+ "scopes": {
496
+ "type": "array",
497
+ "items": {
498
+ "type": "string"
499
+ }
500
+ },
501
+ "issuedAt": {
502
+ "type": "number"
503
+ },
504
+ "lastUsedAt": {
505
+ "type": "number"
506
+ },
507
+ "rotatedAt": {
508
+ "type": "number"
509
+ },
510
+ "revokedAt": {
511
+ "type": "number"
512
+ },
513
+ "fingerprint": {
514
+ "type": "string"
515
+ },
516
+ "value": {
517
+ "type": "string"
518
+ }
519
+ },
520
+ "required": [
521
+ "id",
522
+ "label",
523
+ "scopes",
524
+ "issuedAt",
525
+ "fingerprint",
526
+ "value"
527
+ ],
528
+ "additionalProperties": true
529
+ }
530
+ },
531
+ "required": [
532
+ "peer",
533
+ "token"
534
+ ],
535
+ "additionalProperties": false
536
+ }
537
+ },
538
+ {
539
+ "id": "peer.heartbeat",
540
+ "method": "POST",
541
+ "path": "/api/remote/heartbeat",
542
+ "auth": "bearer-peer-token",
543
+ "requiredScope": "remote:heartbeat",
544
+ "description": "Report peer liveness, capability, command, version, and client-mode metadata.",
545
+ "inputSchema": {
546
+ "type": "object",
547
+ "properties": {
548
+ "capabilities": {
549
+ "type": "array",
550
+ "items": {
551
+ "type": "string"
552
+ }
553
+ },
554
+ "commands": {
555
+ "type": "array",
556
+ "items": {
557
+ "type": "string"
558
+ }
559
+ },
560
+ "version": {
561
+ "type": "string"
562
+ },
563
+ "clientMode": {
564
+ "type": "string"
565
+ },
566
+ "metadata": {
567
+ "type": "object",
568
+ "additionalProperties": {
569
+ "anyOf": [
570
+ {
571
+ "type": "string"
572
+ },
573
+ {
574
+ "type": "number"
575
+ },
576
+ {
577
+ "type": "boolean"
578
+ },
579
+ {
580
+ "type": "null"
581
+ },
582
+ {
583
+ "type": "object",
584
+ "additionalProperties": {
585
+ "$ref": "$.endpoints[2].inputSchema.properties.metadata.additionalProperties"
586
+ }
587
+ },
588
+ {
589
+ "type": "array",
590
+ "items": {
591
+ "$ref": "$.endpoints[2].inputSchema.properties.metadata.additionalProperties"
592
+ }
593
+ }
594
+ ]
595
+ }
596
+ }
597
+ },
598
+ "additionalProperties": true
599
+ },
600
+ "outputSchema": {
601
+ "type": "object",
602
+ "properties": {
603
+ "peer": {
604
+ "type": "object",
605
+ "properties": {
606
+ "id": {
607
+ "type": "string"
608
+ },
609
+ "kind": {
610
+ "type": "string",
611
+ "enum": [
612
+ "node",
613
+ "device"
614
+ ]
615
+ },
616
+ "label": {
617
+ "type": "string"
618
+ },
619
+ "requestedId": {
620
+ "type": "string"
621
+ },
622
+ "platform": {
623
+ "type": "string"
624
+ },
625
+ "deviceFamily": {
626
+ "type": "string"
627
+ },
628
+ "version": {
629
+ "type": "string"
630
+ },
631
+ "clientMode": {
632
+ "type": "string"
633
+ },
634
+ "capabilities": {
635
+ "type": "array",
636
+ "items": {
637
+ "type": "string"
638
+ }
639
+ },
640
+ "commands": {
641
+ "type": "array",
642
+ "items": {
643
+ "type": "string"
644
+ }
645
+ },
646
+ "permissions": {
647
+ "type": "object",
648
+ "additionalProperties": {
649
+ "type": "boolean"
650
+ }
651
+ },
652
+ "status": {
653
+ "type": "string",
654
+ "enum": [
655
+ "paired",
656
+ "connected",
657
+ "idle",
658
+ "disconnected",
659
+ "revoked"
660
+ ]
661
+ },
662
+ "pairedAt": {
663
+ "type": "number"
664
+ },
665
+ "verifiedAt": {
666
+ "type": "number"
667
+ },
668
+ "lastSeenAt": {
669
+ "type": "number"
670
+ },
671
+ "lastConnectedAt": {
672
+ "type": "number"
673
+ },
674
+ "lastDisconnectedAt": {
675
+ "type": "number"
676
+ },
677
+ "lastRemoteAddress": {
678
+ "type": "string"
679
+ },
680
+ "activeTokenId": {
681
+ "type": "string"
682
+ },
683
+ "tokens": {
684
+ "type": "array",
685
+ "items": {
686
+ "type": "object",
687
+ "properties": {
688
+ "id": {
689
+ "type": "string"
690
+ },
691
+ "label": {
692
+ "type": "string"
693
+ },
694
+ "scopes": {
695
+ "type": "array",
696
+ "items": {
697
+ "type": "string"
698
+ }
699
+ },
700
+ "issuedAt": {
701
+ "type": "number"
702
+ },
703
+ "lastUsedAt": {
704
+ "type": "number"
705
+ },
706
+ "rotatedAt": {
707
+ "type": "number"
708
+ },
709
+ "revokedAt": {
710
+ "type": "number"
711
+ },
712
+ "fingerprint": {
713
+ "type": "string"
714
+ }
715
+ },
716
+ "required": [
717
+ "id",
718
+ "label",
719
+ "scopes",
720
+ "issuedAt",
721
+ "fingerprint"
722
+ ],
723
+ "additionalProperties": true
724
+ }
725
+ },
726
+ "metadata": {
727
+ "type": "object",
728
+ "additionalProperties": {
729
+ "anyOf": [
730
+ {
731
+ "type": "string"
732
+ },
733
+ {
734
+ "type": "number"
735
+ },
736
+ {
737
+ "type": "boolean"
738
+ },
739
+ {
740
+ "type": "null"
741
+ },
742
+ {
743
+ "type": "object",
744
+ "additionalProperties": {
745
+ "$ref": "$.endpoints[2].outputSchema.properties.peer.properties.metadata.additionalProperties"
746
+ }
747
+ },
748
+ {
749
+ "type": "array",
750
+ "items": {
751
+ "$ref": "$.endpoints[2].outputSchema.properties.peer.properties.metadata.additionalProperties"
752
+ }
753
+ }
754
+ ]
755
+ }
756
+ }
757
+ },
758
+ "required": [
759
+ "id",
760
+ "kind",
761
+ "label",
762
+ "requestedId",
763
+ "capabilities",
764
+ "commands",
765
+ "status",
766
+ "pairedAt",
767
+ "tokens",
768
+ "metadata"
769
+ ],
770
+ "additionalProperties": true
771
+ }
772
+ },
773
+ "required": [
774
+ "peer"
775
+ ],
776
+ "additionalProperties": false
777
+ }
778
+ },
779
+ {
780
+ "id": "work.pull",
781
+ "method": "POST",
782
+ "path": "/api/remote/work/pull",
783
+ "auth": "bearer-peer-token",
784
+ "requiredScope": "remote:pull",
785
+ "description": "Claim queued work for the authenticated peer.",
786
+ "inputSchema": {
787
+ "type": "object",
788
+ "properties": {
789
+ "maxItems": {
790
+ "type": "number"
791
+ },
792
+ "leaseMs": {
793
+ "type": "number"
794
+ }
795
+ },
796
+ "additionalProperties": true
797
+ },
798
+ "outputSchema": {
799
+ "type": "object",
800
+ "properties": {
801
+ "work": {
802
+ "type": "array",
803
+ "items": {
804
+ "type": "object",
805
+ "properties": {
806
+ "id": {
807
+ "type": "string"
808
+ },
809
+ "peerId": {
810
+ "type": "string"
811
+ },
812
+ "peerKind": {
813
+ "type": "string",
814
+ "enum": [
815
+ "node",
816
+ "device"
817
+ ]
818
+ },
819
+ "type": {
820
+ "type": "string",
821
+ "enum": [
822
+ "invoke",
823
+ "status.request",
824
+ "location.request",
825
+ "session.message",
826
+ "automation.run"
827
+ ]
828
+ },
829
+ "command": {
830
+ "type": "string"
831
+ },
832
+ "priority": {
833
+ "type": "string",
834
+ "enum": [
835
+ "default",
836
+ "normal",
837
+ "high"
838
+ ]
839
+ },
840
+ "status": {
841
+ "type": "string",
842
+ "enum": [
843
+ "queued",
844
+ "claimed",
845
+ "completed",
846
+ "failed",
847
+ "cancelled",
848
+ "expired"
849
+ ]
850
+ },
851
+ "payload": {
852
+ "anyOf": [
853
+ {
854
+ "type": "string"
855
+ },
856
+ {
857
+ "type": "number"
858
+ },
859
+ {
860
+ "type": "boolean"
861
+ },
862
+ {
863
+ "type": "null"
864
+ },
865
+ {
866
+ "type": "object",
867
+ "additionalProperties": {
868
+ "$ref": "$.endpoints[3].outputSchema.properties.work.items.properties.payload"
869
+ }
870
+ },
871
+ {
872
+ "type": "array",
873
+ "items": {
874
+ "$ref": "$.endpoints[3].outputSchema.properties.work.items.properties.payload"
875
+ }
876
+ }
877
+ ]
878
+ },
879
+ "createdAt": {
880
+ "type": "number"
881
+ },
882
+ "updatedAt": {
883
+ "type": "number"
884
+ },
885
+ "queuedBy": {
886
+ "type": "string"
887
+ },
888
+ "claimedAt": {
889
+ "type": "number"
890
+ },
891
+ "claimTokenId": {
892
+ "type": "string"
893
+ },
894
+ "leaseExpiresAt": {
895
+ "type": "number"
896
+ },
897
+ "completedAt": {
898
+ "type": "number"
899
+ },
900
+ "timeoutMs": {
901
+ "type": "number"
902
+ },
903
+ "sessionId": {
904
+ "type": "string"
905
+ },
906
+ "routeId": {
907
+ "type": "string"
908
+ },
909
+ "automationRunId": {
910
+ "type": "string"
911
+ },
912
+ "automationJobId": {
913
+ "type": "string"
914
+ },
915
+ "approvalId": {
916
+ "type": "string"
917
+ },
918
+ "result": {
919
+ "anyOf": [
920
+ {
921
+ "type": "string"
922
+ },
923
+ {
924
+ "type": "number"
925
+ },
926
+ {
927
+ "type": "boolean"
928
+ },
929
+ {
930
+ "type": "null"
931
+ },
932
+ {
933
+ "type": "object",
934
+ "additionalProperties": {
935
+ "$ref": "$.endpoints[3].outputSchema.properties.work.items.properties.result"
936
+ }
937
+ },
938
+ {
939
+ "type": "array",
940
+ "items": {
941
+ "$ref": "$.endpoints[3].outputSchema.properties.work.items.properties.result"
942
+ }
943
+ }
944
+ ]
945
+ },
946
+ "error": {
947
+ "type": "string"
948
+ },
949
+ "telemetry": {
950
+ "type": "object",
951
+ "properties": {
952
+ "usage": {
953
+ "type": "object",
954
+ "properties": {
955
+ "inputTokens": {
956
+ "type": "number"
957
+ },
958
+ "outputTokens": {
959
+ "type": "number"
960
+ },
961
+ "cacheReadTokens": {
962
+ "type": "number"
963
+ },
964
+ "cacheWriteTokens": {
965
+ "type": "number"
966
+ },
967
+ "reasoningTokens": {
968
+ "type": "number"
969
+ }
970
+ },
971
+ "required": [
972
+ "inputTokens",
973
+ "outputTokens",
974
+ "cacheReadTokens",
975
+ "cacheWriteTokens"
976
+ ],
977
+ "additionalProperties": false
978
+ },
979
+ "llmCallCount": {
980
+ "type": "number"
981
+ },
982
+ "toolCallCount": {
983
+ "type": "number"
984
+ },
985
+ "turnCount": {
986
+ "type": "number"
987
+ },
988
+ "modelId": {
989
+ "type": "string"
990
+ },
991
+ "providerId": {
992
+ "type": "string"
993
+ },
994
+ "reasoningSummaryPresent": {
995
+ "type": "boolean"
996
+ },
997
+ "source": {
998
+ "type": "string",
999
+ "enum": [
1000
+ "local-agent",
1001
+ "shared-session",
1002
+ "remote-node",
1003
+ "remote-device"
1004
+ ]
1005
+ }
1006
+ },
1007
+ "required": [
1008
+ "usage"
1009
+ ],
1010
+ "additionalProperties": true
1011
+ },
1012
+ "metadata": {
1013
+ "type": "object",
1014
+ "additionalProperties": {
1015
+ "anyOf": [
1016
+ {
1017
+ "type": "string"
1018
+ },
1019
+ {
1020
+ "type": "number"
1021
+ },
1022
+ {
1023
+ "type": "boolean"
1024
+ },
1025
+ {
1026
+ "type": "null"
1027
+ },
1028
+ {
1029
+ "type": "object",
1030
+ "additionalProperties": {
1031
+ "$ref": "$.endpoints[3].outputSchema.properties.work.items.properties.metadata.additionalProperties"
1032
+ }
1033
+ },
1034
+ {
1035
+ "type": "array",
1036
+ "items": {
1037
+ "$ref": "$.endpoints[3].outputSchema.properties.work.items.properties.metadata.additionalProperties"
1038
+ }
1039
+ }
1040
+ ]
1041
+ }
1042
+ }
1043
+ },
1044
+ "required": [
1045
+ "id",
1046
+ "peerId",
1047
+ "peerKind",
1048
+ "type",
1049
+ "command",
1050
+ "priority",
1051
+ "status",
1052
+ "createdAt",
1053
+ "updatedAt",
1054
+ "queuedBy",
1055
+ "metadata"
1056
+ ],
1057
+ "additionalProperties": true
1058
+ }
1059
+ }
1060
+ },
1061
+ "required": [
1062
+ "work"
1063
+ ],
1064
+ "additionalProperties": false
1065
+ }
1066
+ },
1067
+ {
1068
+ "id": "work.complete",
1069
+ "method": "POST",
1070
+ "path": "/api/remote/work/{workId}/complete",
1071
+ "auth": "bearer-peer-token",
1072
+ "requiredScope": "remote:complete",
1073
+ "description": "Complete, fail, or cancel a claimed work item.",
1074
+ "inputSchema": {
1075
+ "type": "object",
1076
+ "properties": {
1077
+ "workId": {
1078
+ "type": "string"
1079
+ },
1080
+ "status": {
1081
+ "type": "string",
1082
+ "enum": [
1083
+ "completed",
1084
+ "failed",
1085
+ "cancelled"
1086
+ ]
1087
+ },
1088
+ "result": {
1089
+ "anyOf": [
1090
+ {
1091
+ "type": "string"
1092
+ },
1093
+ {
1094
+ "type": "number"
1095
+ },
1096
+ {
1097
+ "type": "boolean"
1098
+ },
1099
+ {
1100
+ "type": "null"
1101
+ },
1102
+ {
1103
+ "type": "object",
1104
+ "additionalProperties": {
1105
+ "$ref": "$.endpoints[4].inputSchema.properties.result"
1106
+ }
1107
+ },
1108
+ {
1109
+ "type": "array",
1110
+ "items": {
1111
+ "$ref": "$.endpoints[4].inputSchema.properties.result"
1112
+ }
1113
+ }
1114
+ ]
1115
+ },
1116
+ "error": {
1117
+ "type": "string"
1118
+ },
1119
+ "metadata": {
1120
+ "type": "object",
1121
+ "additionalProperties": {
1122
+ "anyOf": [
1123
+ {
1124
+ "type": "string"
1125
+ },
1126
+ {
1127
+ "type": "number"
1128
+ },
1129
+ {
1130
+ "type": "boolean"
1131
+ },
1132
+ {
1133
+ "type": "null"
1134
+ },
1135
+ {
1136
+ "type": "object",
1137
+ "additionalProperties": {
1138
+ "$ref": "$.endpoints[4].inputSchema.properties.metadata.additionalProperties"
1139
+ }
1140
+ },
1141
+ {
1142
+ "type": "array",
1143
+ "items": {
1144
+ "$ref": "$.endpoints[4].inputSchema.properties.metadata.additionalProperties"
1145
+ }
1146
+ }
1147
+ ]
1148
+ }
1149
+ }
1150
+ },
1151
+ "required": [
1152
+ "workId"
1153
+ ],
1154
+ "additionalProperties": true
1155
+ },
1156
+ "outputSchema": {
1157
+ "type": "object",
1158
+ "properties": {
1159
+ "work": {
1160
+ "type": "object",
1161
+ "properties": {
1162
+ "id": {
1163
+ "type": "string"
1164
+ },
1165
+ "peerId": {
1166
+ "type": "string"
1167
+ },
1168
+ "peerKind": {
1169
+ "type": "string",
1170
+ "enum": [
1171
+ "node",
1172
+ "device"
1173
+ ]
1174
+ },
1175
+ "type": {
1176
+ "type": "string",
1177
+ "enum": [
1178
+ "invoke",
1179
+ "status.request",
1180
+ "location.request",
1181
+ "session.message",
1182
+ "automation.run"
1183
+ ]
1184
+ },
1185
+ "command": {
1186
+ "type": "string"
1187
+ },
1188
+ "priority": {
1189
+ "type": "string",
1190
+ "enum": [
1191
+ "default",
1192
+ "normal",
1193
+ "high"
1194
+ ]
1195
+ },
1196
+ "status": {
1197
+ "type": "string",
1198
+ "enum": [
1199
+ "queued",
1200
+ "claimed",
1201
+ "completed",
1202
+ "failed",
1203
+ "cancelled",
1204
+ "expired"
1205
+ ]
1206
+ },
1207
+ "payload": {
1208
+ "anyOf": [
1209
+ {
1210
+ "type": "string"
1211
+ },
1212
+ {
1213
+ "type": "number"
1214
+ },
1215
+ {
1216
+ "type": "boolean"
1217
+ },
1218
+ {
1219
+ "type": "null"
1220
+ },
1221
+ {
1222
+ "type": "object",
1223
+ "additionalProperties": {
1224
+ "$ref": "$.endpoints[4].outputSchema.properties.work.properties.payload"
1225
+ }
1226
+ },
1227
+ {
1228
+ "type": "array",
1229
+ "items": {
1230
+ "$ref": "$.endpoints[4].outputSchema.properties.work.properties.payload"
1231
+ }
1232
+ }
1233
+ ]
1234
+ },
1235
+ "createdAt": {
1236
+ "type": "number"
1237
+ },
1238
+ "updatedAt": {
1239
+ "type": "number"
1240
+ },
1241
+ "queuedBy": {
1242
+ "type": "string"
1243
+ },
1244
+ "claimedAt": {
1245
+ "type": "number"
1246
+ },
1247
+ "claimTokenId": {
1248
+ "type": "string"
1249
+ },
1250
+ "leaseExpiresAt": {
1251
+ "type": "number"
1252
+ },
1253
+ "completedAt": {
1254
+ "type": "number"
1255
+ },
1256
+ "timeoutMs": {
1257
+ "type": "number"
1258
+ },
1259
+ "sessionId": {
1260
+ "type": "string"
1261
+ },
1262
+ "routeId": {
1263
+ "type": "string"
1264
+ },
1265
+ "automationRunId": {
1266
+ "type": "string"
1267
+ },
1268
+ "automationJobId": {
1269
+ "type": "string"
1270
+ },
1271
+ "approvalId": {
1272
+ "type": "string"
1273
+ },
1274
+ "result": {
1275
+ "anyOf": [
1276
+ {
1277
+ "type": "string"
1278
+ },
1279
+ {
1280
+ "type": "number"
1281
+ },
1282
+ {
1283
+ "type": "boolean"
1284
+ },
1285
+ {
1286
+ "type": "null"
1287
+ },
1288
+ {
1289
+ "type": "object",
1290
+ "additionalProperties": {
1291
+ "$ref": "$.endpoints[4].outputSchema.properties.work.properties.result"
1292
+ }
1293
+ },
1294
+ {
1295
+ "type": "array",
1296
+ "items": {
1297
+ "$ref": "$.endpoints[4].outputSchema.properties.work.properties.result"
1298
+ }
1299
+ }
1300
+ ]
1301
+ },
1302
+ "error": {
1303
+ "type": "string"
1304
+ },
1305
+ "telemetry": {
1306
+ "type": "object",
1307
+ "properties": {
1308
+ "usage": {
1309
+ "type": "object",
1310
+ "properties": {
1311
+ "inputTokens": {
1312
+ "type": "number"
1313
+ },
1314
+ "outputTokens": {
1315
+ "type": "number"
1316
+ },
1317
+ "cacheReadTokens": {
1318
+ "type": "number"
1319
+ },
1320
+ "cacheWriteTokens": {
1321
+ "type": "number"
1322
+ },
1323
+ "reasoningTokens": {
1324
+ "type": "number"
1325
+ }
1326
+ },
1327
+ "required": [
1328
+ "inputTokens",
1329
+ "outputTokens",
1330
+ "cacheReadTokens",
1331
+ "cacheWriteTokens"
1332
+ ],
1333
+ "additionalProperties": false
1334
+ },
1335
+ "llmCallCount": {
1336
+ "type": "number"
1337
+ },
1338
+ "toolCallCount": {
1339
+ "type": "number"
1340
+ },
1341
+ "turnCount": {
1342
+ "type": "number"
1343
+ },
1344
+ "modelId": {
1345
+ "type": "string"
1346
+ },
1347
+ "providerId": {
1348
+ "type": "string"
1349
+ },
1350
+ "reasoningSummaryPresent": {
1351
+ "type": "boolean"
1352
+ },
1353
+ "source": {
1354
+ "type": "string",
1355
+ "enum": [
1356
+ "local-agent",
1357
+ "shared-session",
1358
+ "remote-node",
1359
+ "remote-device"
1360
+ ]
1361
+ }
1362
+ },
1363
+ "required": [
1364
+ "usage"
1365
+ ],
1366
+ "additionalProperties": true
1367
+ },
1368
+ "metadata": {
1369
+ "type": "object",
1370
+ "additionalProperties": {
1371
+ "anyOf": [
1372
+ {
1373
+ "type": "string"
1374
+ },
1375
+ {
1376
+ "type": "number"
1377
+ },
1378
+ {
1379
+ "type": "boolean"
1380
+ },
1381
+ {
1382
+ "type": "null"
1383
+ },
1384
+ {
1385
+ "type": "object",
1386
+ "additionalProperties": {
1387
+ "$ref": "$.endpoints[4].outputSchema.properties.work.properties.metadata.additionalProperties"
1388
+ }
1389
+ },
1390
+ {
1391
+ "type": "array",
1392
+ "items": {
1393
+ "$ref": "$.endpoints[4].outputSchema.properties.work.properties.metadata.additionalProperties"
1394
+ }
1395
+ }
1396
+ ]
1397
+ }
1398
+ }
1399
+ },
1400
+ "required": [
1401
+ "id",
1402
+ "peerId",
1403
+ "peerKind",
1404
+ "type",
1405
+ "command",
1406
+ "priority",
1407
+ "status",
1408
+ "createdAt",
1409
+ "updatedAt",
1410
+ "queuedBy",
1411
+ "metadata"
1412
+ ],
1413
+ "additionalProperties": true
1414
+ }
1415
+ },
1416
+ "required": [
1417
+ "work"
1418
+ ],
1419
+ "additionalProperties": false
1420
+ }
1421
+ },
1422
+ {
1423
+ "id": "operator.snapshot",
1424
+ "method": "GET",
1425
+ "path": "/api/remote",
1426
+ "auth": "bearer-operator-token",
1427
+ "description": "Inspect distributed runtime pair requests, peers, work, and audit state.",
1428
+ "outputSchema": {
1429
+ "type": "object",
1430
+ "properties": {
1431
+ "daemon": {
1432
+ "type": "object",
1433
+ "properties": {
1434
+ "transportState": {
1435
+ "type": "string"
1436
+ },
1437
+ "isRunning": {
1438
+ "type": "boolean"
1439
+ },
1440
+ "reconnectAttempts": {
1441
+ "type": "number"
1442
+ },
1443
+ "runningJobCount": {
1444
+ "type": "number"
1445
+ },
1446
+ "lastError": {
1447
+ "type": "string"
1448
+ }
1449
+ },
1450
+ "required": [
1451
+ "transportState",
1452
+ "isRunning",
1453
+ "reconnectAttempts",
1454
+ "runningJobCount"
1455
+ ],
1456
+ "additionalProperties": true
1457
+ },
1458
+ "acp": {
1459
+ "type": "object",
1460
+ "properties": {
1461
+ "transportState": {
1462
+ "type": "string"
1463
+ },
1464
+ "activeConnectionIds": {
1465
+ "type": "array",
1466
+ "items": {
1467
+ "type": "string"
1468
+ }
1469
+ },
1470
+ "totalSpawned": {
1471
+ "type": "number"
1472
+ },
1473
+ "totalFailed": {
1474
+ "type": "number"
1475
+ },
1476
+ "lastError": {
1477
+ "type": "string"
1478
+ }
1479
+ },
1480
+ "required": [
1481
+ "transportState",
1482
+ "activeConnectionIds",
1483
+ "totalSpawned",
1484
+ "totalFailed"
1485
+ ],
1486
+ "additionalProperties": true
1487
+ },
1488
+ "registry": {
1489
+ "type": "object",
1490
+ "properties": {
1491
+ "pools": {
1492
+ "type": "number"
1493
+ },
1494
+ "contracts": {
1495
+ "type": "number"
1496
+ },
1497
+ "artifacts": {
1498
+ "type": "number"
1499
+ },
1500
+ "poolEntries": {
1501
+ "type": "array",
1502
+ "items": {
1503
+ "type": "object",
1504
+ "properties": {
1505
+ "id": {
1506
+ "type": "string"
1507
+ },
1508
+ "label": {
1509
+ "type": "string"
1510
+ },
1511
+ "trustClass": {
1512
+ "type": "string"
1513
+ },
1514
+ "preferredTemplate": {
1515
+ "type": "string"
1516
+ },
1517
+ "maxRunners": {
1518
+ "type": "number"
1519
+ },
1520
+ "runnerIds": {
1521
+ "type": "array",
1522
+ "items": {
1523
+ "type": "string"
1524
+ }
1525
+ }
1526
+ },
1527
+ "required": [
1528
+ "id",
1529
+ "label",
1530
+ "trustClass",
1531
+ "preferredTemplate",
1532
+ "maxRunners",
1533
+ "runnerIds"
1534
+ ],
1535
+ "additionalProperties": true
1536
+ }
1537
+ },
1538
+ "contractEntries": {
1539
+ "type": "array",
1540
+ "items": {
1541
+ "type": "object",
1542
+ "properties": {
1543
+ "id": {
1544
+ "type": "string"
1545
+ },
1546
+ "runnerId": {
1547
+ "type": "string"
1548
+ },
1549
+ "label": {
1550
+ "type": "string"
1551
+ },
1552
+ "template": {
1553
+ "type": "string"
1554
+ },
1555
+ "poolId": {
1556
+ "type": "string"
1557
+ },
1558
+ "taskId": {
1559
+ "type": "string"
1560
+ },
1561
+ "sourceTransport": {
1562
+ "type": "string"
1563
+ },
1564
+ "trustClass": {
1565
+ "type": "string"
1566
+ },
1567
+ "executionProtocol": {
1568
+ "type": "string"
1569
+ },
1570
+ "reviewMode": {
1571
+ "type": "string"
1572
+ },
1573
+ "communicationLane": {
1574
+ "type": "string"
1575
+ },
1576
+ "transportState": {
1577
+ "type": "string"
1578
+ },
1579
+ "lastError": {
1580
+ "type": "string"
1581
+ }
1582
+ },
1583
+ "required": [
1584
+ "id",
1585
+ "runnerId",
1586
+ "label",
1587
+ "template",
1588
+ "sourceTransport",
1589
+ "trustClass",
1590
+ "executionProtocol",
1591
+ "reviewMode",
1592
+ "communicationLane",
1593
+ "transportState"
1594
+ ],
1595
+ "additionalProperties": true
1596
+ }
1597
+ },
1598
+ "artifactEntries": {
1599
+ "type": "array",
1600
+ "items": {
1601
+ "type": "object",
1602
+ "properties": {
1603
+ "id": {
1604
+ "type": "string"
1605
+ },
1606
+ "runnerId": {
1607
+ "type": "string"
1608
+ },
1609
+ "createdAt": {
1610
+ "type": "number"
1611
+ },
1612
+ "status": {
1613
+ "type": "string"
1614
+ },
1615
+ "summary": {
1616
+ "type": "string"
1617
+ },
1618
+ "error": {
1619
+ "type": "string"
1620
+ }
1621
+ },
1622
+ "required": [
1623
+ "id",
1624
+ "runnerId",
1625
+ "createdAt",
1626
+ "status",
1627
+ "summary"
1628
+ ],
1629
+ "additionalProperties": true
1630
+ }
1631
+ }
1632
+ },
1633
+ "required": [
1634
+ "pools",
1635
+ "contracts",
1636
+ "artifacts",
1637
+ "poolEntries",
1638
+ "contractEntries",
1639
+ "artifactEntries"
1640
+ ],
1641
+ "additionalProperties": false
1642
+ },
1643
+ "supervisor": {
1644
+ "type": "object",
1645
+ "properties": {
1646
+ "sessions": {
1647
+ "type": "number"
1648
+ },
1649
+ "degraded": {
1650
+ "type": "number"
1651
+ },
1652
+ "capturedAt": {
1653
+ "type": "number"
1654
+ },
1655
+ "entries": {
1656
+ "type": "array",
1657
+ "items": {
1658
+ "type": "object",
1659
+ "properties": {
1660
+ "runnerId": {
1661
+ "type": "string"
1662
+ },
1663
+ "label": {
1664
+ "type": "string"
1665
+ },
1666
+ "transportState": {
1667
+ "type": "string"
1668
+ },
1669
+ "heartbeat": {
1670
+ "type": "string"
1671
+ },
1672
+ "taskId": {
1673
+ "type": "string"
1674
+ }
1675
+ },
1676
+ "required": [
1677
+ "runnerId",
1678
+ "label",
1679
+ "transportState",
1680
+ "heartbeat"
1681
+ ],
1682
+ "additionalProperties": true
1683
+ }
1684
+ }
1685
+ },
1686
+ "required": [
1687
+ "sessions",
1688
+ "degraded",
1689
+ "capturedAt",
1690
+ "entries"
1691
+ ],
1692
+ "additionalProperties": false
1693
+ },
1694
+ "distributed": {
1695
+ "type": "object",
1696
+ "properties": {
1697
+ "pairRequests": {
1698
+ "type": "array",
1699
+ "items": {
1700
+ "type": "object",
1701
+ "properties": {
1702
+ "id": {
1703
+ "type": "string"
1704
+ },
1705
+ "peerKind": {
1706
+ "type": "string",
1707
+ "enum": [
1708
+ "node",
1709
+ "device"
1710
+ ]
1711
+ },
1712
+ "requestedId": {
1713
+ "type": "string"
1714
+ },
1715
+ "label": {
1716
+ "type": "string"
1717
+ },
1718
+ "platform": {
1719
+ "type": "string"
1720
+ },
1721
+ "deviceFamily": {
1722
+ "type": "string"
1723
+ },
1724
+ "version": {
1725
+ "type": "string"
1726
+ },
1727
+ "clientMode": {
1728
+ "type": "string"
1729
+ },
1730
+ "capabilities": {
1731
+ "type": "array",
1732
+ "items": {
1733
+ "type": "string"
1734
+ }
1735
+ },
1736
+ "commands": {
1737
+ "type": "array",
1738
+ "items": {
1739
+ "type": "string"
1740
+ }
1741
+ },
1742
+ "requestedBy": {
1743
+ "type": "string",
1744
+ "enum": [
1745
+ "remote",
1746
+ "operator"
1747
+ ]
1748
+ },
1749
+ "status": {
1750
+ "type": "string",
1751
+ "enum": [
1752
+ "pending",
1753
+ "approved",
1754
+ "verified",
1755
+ "rejected",
1756
+ "expired"
1757
+ ]
1758
+ },
1759
+ "challengePreview": {
1760
+ "type": "string"
1761
+ },
1762
+ "createdAt": {
1763
+ "type": "number"
1764
+ },
1765
+ "updatedAt": {
1766
+ "type": "number"
1767
+ },
1768
+ "approvedAt": {
1769
+ "type": "number"
1770
+ },
1771
+ "verifiedAt": {
1772
+ "type": "number"
1773
+ },
1774
+ "rejectedAt": {
1775
+ "type": "number"
1776
+ },
1777
+ "expiresAt": {
1778
+ "type": "number"
1779
+ },
1780
+ "peerId": {
1781
+ "type": "string"
1782
+ },
1783
+ "remoteAddress": {
1784
+ "type": "string"
1785
+ },
1786
+ "metadata": {
1787
+ "type": "object",
1788
+ "additionalProperties": {
1789
+ "anyOf": [
1790
+ {
1791
+ "type": "string"
1792
+ },
1793
+ {
1794
+ "type": "number"
1795
+ },
1796
+ {
1797
+ "type": "boolean"
1798
+ },
1799
+ {
1800
+ "type": "null"
1801
+ },
1802
+ {
1803
+ "type": "object",
1804
+ "additionalProperties": {
1805
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.pairRequests.items.properties.metadata.additionalProperties"
1806
+ }
1807
+ },
1808
+ {
1809
+ "type": "array",
1810
+ "items": {
1811
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.pairRequests.items.properties.metadata.additionalProperties"
1812
+ }
1813
+ }
1814
+ ]
1815
+ }
1816
+ }
1817
+ },
1818
+ "required": [
1819
+ "id",
1820
+ "peerKind",
1821
+ "requestedId",
1822
+ "label",
1823
+ "capabilities",
1824
+ "commands",
1825
+ "requestedBy",
1826
+ "status",
1827
+ "challengePreview",
1828
+ "createdAt",
1829
+ "updatedAt",
1830
+ "expiresAt",
1831
+ "metadata"
1832
+ ],
1833
+ "additionalProperties": true
1834
+ }
1835
+ },
1836
+ "peers": {
1837
+ "type": "array",
1838
+ "items": {
1839
+ "type": "object",
1840
+ "properties": {
1841
+ "id": {
1842
+ "type": "string"
1843
+ },
1844
+ "kind": {
1845
+ "type": "string",
1846
+ "enum": [
1847
+ "node",
1848
+ "device"
1849
+ ]
1850
+ },
1851
+ "label": {
1852
+ "type": "string"
1853
+ },
1854
+ "requestedId": {
1855
+ "type": "string"
1856
+ },
1857
+ "platform": {
1858
+ "type": "string"
1859
+ },
1860
+ "deviceFamily": {
1861
+ "type": "string"
1862
+ },
1863
+ "version": {
1864
+ "type": "string"
1865
+ },
1866
+ "clientMode": {
1867
+ "type": "string"
1868
+ },
1869
+ "capabilities": {
1870
+ "type": "array",
1871
+ "items": {
1872
+ "type": "string"
1873
+ }
1874
+ },
1875
+ "commands": {
1876
+ "type": "array",
1877
+ "items": {
1878
+ "type": "string"
1879
+ }
1880
+ },
1881
+ "permissions": {
1882
+ "type": "object",
1883
+ "additionalProperties": {
1884
+ "type": "boolean"
1885
+ }
1886
+ },
1887
+ "status": {
1888
+ "type": "string",
1889
+ "enum": [
1890
+ "paired",
1891
+ "connected",
1892
+ "idle",
1893
+ "disconnected",
1894
+ "revoked"
1895
+ ]
1896
+ },
1897
+ "pairedAt": {
1898
+ "type": "number"
1899
+ },
1900
+ "verifiedAt": {
1901
+ "type": "number"
1902
+ },
1903
+ "lastSeenAt": {
1904
+ "type": "number"
1905
+ },
1906
+ "lastConnectedAt": {
1907
+ "type": "number"
1908
+ },
1909
+ "lastDisconnectedAt": {
1910
+ "type": "number"
1911
+ },
1912
+ "lastRemoteAddress": {
1913
+ "type": "string"
1914
+ },
1915
+ "activeTokenId": {
1916
+ "type": "string"
1917
+ },
1918
+ "tokens": {
1919
+ "type": "array",
1920
+ "items": {
1921
+ "type": "object",
1922
+ "properties": {
1923
+ "id": {
1924
+ "type": "string"
1925
+ },
1926
+ "label": {
1927
+ "type": "string"
1928
+ },
1929
+ "scopes": {
1930
+ "type": "array",
1931
+ "items": {
1932
+ "type": "string"
1933
+ }
1934
+ },
1935
+ "issuedAt": {
1936
+ "type": "number"
1937
+ },
1938
+ "lastUsedAt": {
1939
+ "type": "number"
1940
+ },
1941
+ "rotatedAt": {
1942
+ "type": "number"
1943
+ },
1944
+ "revokedAt": {
1945
+ "type": "number"
1946
+ },
1947
+ "fingerprint": {
1948
+ "type": "string"
1949
+ }
1950
+ },
1951
+ "required": [
1952
+ "id",
1953
+ "label",
1954
+ "scopes",
1955
+ "issuedAt",
1956
+ "fingerprint"
1957
+ ],
1958
+ "additionalProperties": true
1959
+ }
1960
+ },
1961
+ "metadata": {
1962
+ "type": "object",
1963
+ "additionalProperties": {
1964
+ "anyOf": [
1965
+ {
1966
+ "type": "string"
1967
+ },
1968
+ {
1969
+ "type": "number"
1970
+ },
1971
+ {
1972
+ "type": "boolean"
1973
+ },
1974
+ {
1975
+ "type": "null"
1976
+ },
1977
+ {
1978
+ "type": "object",
1979
+ "additionalProperties": {
1980
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.peers.items.properties.metadata.additionalProperties"
1981
+ }
1982
+ },
1983
+ {
1984
+ "type": "array",
1985
+ "items": {
1986
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.peers.items.properties.metadata.additionalProperties"
1987
+ }
1988
+ }
1989
+ ]
1990
+ }
1991
+ }
1992
+ },
1993
+ "required": [
1994
+ "id",
1995
+ "kind",
1996
+ "label",
1997
+ "requestedId",
1998
+ "capabilities",
1999
+ "commands",
2000
+ "status",
2001
+ "pairedAt",
2002
+ "tokens",
2003
+ "metadata"
2004
+ ],
2005
+ "additionalProperties": true
2006
+ }
2007
+ },
2008
+ "work": {
2009
+ "type": "array",
2010
+ "items": {
2011
+ "type": "object",
2012
+ "properties": {
2013
+ "id": {
2014
+ "type": "string"
2015
+ },
2016
+ "peerId": {
2017
+ "type": "string"
2018
+ },
2019
+ "peerKind": {
2020
+ "type": "string",
2021
+ "enum": [
2022
+ "node",
2023
+ "device"
2024
+ ]
2025
+ },
2026
+ "type": {
2027
+ "type": "string",
2028
+ "enum": [
2029
+ "invoke",
2030
+ "status.request",
2031
+ "location.request",
2032
+ "session.message",
2033
+ "automation.run"
2034
+ ]
2035
+ },
2036
+ "command": {
2037
+ "type": "string"
2038
+ },
2039
+ "priority": {
2040
+ "type": "string",
2041
+ "enum": [
2042
+ "default",
2043
+ "normal",
2044
+ "high"
2045
+ ]
2046
+ },
2047
+ "status": {
2048
+ "type": "string",
2049
+ "enum": [
2050
+ "queued",
2051
+ "claimed",
2052
+ "completed",
2053
+ "failed",
2054
+ "cancelled",
2055
+ "expired"
2056
+ ]
2057
+ },
2058
+ "payload": {
2059
+ "anyOf": [
2060
+ {
2061
+ "type": "string"
2062
+ },
2063
+ {
2064
+ "type": "number"
2065
+ },
2066
+ {
2067
+ "type": "boolean"
2068
+ },
2069
+ {
2070
+ "type": "null"
2071
+ },
2072
+ {
2073
+ "type": "object",
2074
+ "additionalProperties": {
2075
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.work.items.properties.payload"
2076
+ }
2077
+ },
2078
+ {
2079
+ "type": "array",
2080
+ "items": {
2081
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.work.items.properties.payload"
2082
+ }
2083
+ }
2084
+ ]
2085
+ },
2086
+ "createdAt": {
2087
+ "type": "number"
2088
+ },
2089
+ "updatedAt": {
2090
+ "type": "number"
2091
+ },
2092
+ "queuedBy": {
2093
+ "type": "string"
2094
+ },
2095
+ "claimedAt": {
2096
+ "type": "number"
2097
+ },
2098
+ "claimTokenId": {
2099
+ "type": "string"
2100
+ },
2101
+ "leaseExpiresAt": {
2102
+ "type": "number"
2103
+ },
2104
+ "completedAt": {
2105
+ "type": "number"
2106
+ },
2107
+ "timeoutMs": {
2108
+ "type": "number"
2109
+ },
2110
+ "sessionId": {
2111
+ "type": "string"
2112
+ },
2113
+ "routeId": {
2114
+ "type": "string"
2115
+ },
2116
+ "automationRunId": {
2117
+ "type": "string"
2118
+ },
2119
+ "automationJobId": {
2120
+ "type": "string"
2121
+ },
2122
+ "approvalId": {
2123
+ "type": "string"
2124
+ },
2125
+ "result": {
2126
+ "anyOf": [
2127
+ {
2128
+ "type": "string"
2129
+ },
2130
+ {
2131
+ "type": "number"
2132
+ },
2133
+ {
2134
+ "type": "boolean"
2135
+ },
2136
+ {
2137
+ "type": "null"
2138
+ },
2139
+ {
2140
+ "type": "object",
2141
+ "additionalProperties": {
2142
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.work.items.properties.result"
2143
+ }
2144
+ },
2145
+ {
2146
+ "type": "array",
2147
+ "items": {
2148
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.work.items.properties.result"
2149
+ }
2150
+ }
2151
+ ]
2152
+ },
2153
+ "error": {
2154
+ "type": "string"
2155
+ },
2156
+ "telemetry": {
2157
+ "type": "object",
2158
+ "properties": {
2159
+ "usage": {
2160
+ "type": "object",
2161
+ "properties": {
2162
+ "inputTokens": {
2163
+ "type": "number"
2164
+ },
2165
+ "outputTokens": {
2166
+ "type": "number"
2167
+ },
2168
+ "cacheReadTokens": {
2169
+ "type": "number"
2170
+ },
2171
+ "cacheWriteTokens": {
2172
+ "type": "number"
2173
+ },
2174
+ "reasoningTokens": {
2175
+ "type": "number"
2176
+ }
2177
+ },
2178
+ "required": [
2179
+ "inputTokens",
2180
+ "outputTokens",
2181
+ "cacheReadTokens",
2182
+ "cacheWriteTokens"
2183
+ ],
2184
+ "additionalProperties": false
2185
+ },
2186
+ "llmCallCount": {
2187
+ "type": "number"
2188
+ },
2189
+ "toolCallCount": {
2190
+ "type": "number"
2191
+ },
2192
+ "turnCount": {
2193
+ "type": "number"
2194
+ },
2195
+ "modelId": {
2196
+ "type": "string"
2197
+ },
2198
+ "providerId": {
2199
+ "type": "string"
2200
+ },
2201
+ "reasoningSummaryPresent": {
2202
+ "type": "boolean"
2203
+ },
2204
+ "source": {
2205
+ "type": "string",
2206
+ "enum": [
2207
+ "local-agent",
2208
+ "shared-session",
2209
+ "remote-node",
2210
+ "remote-device"
2211
+ ]
2212
+ }
2213
+ },
2214
+ "required": [
2215
+ "usage"
2216
+ ],
2217
+ "additionalProperties": true
2218
+ },
2219
+ "metadata": {
2220
+ "type": "object",
2221
+ "additionalProperties": {
2222
+ "anyOf": [
2223
+ {
2224
+ "type": "string"
2225
+ },
2226
+ {
2227
+ "type": "number"
2228
+ },
2229
+ {
2230
+ "type": "boolean"
2231
+ },
2232
+ {
2233
+ "type": "null"
2234
+ },
2235
+ {
2236
+ "type": "object",
2237
+ "additionalProperties": {
2238
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.work.items.properties.metadata.additionalProperties"
2239
+ }
2240
+ },
2241
+ {
2242
+ "type": "array",
2243
+ "items": {
2244
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.work.items.properties.metadata.additionalProperties"
2245
+ }
2246
+ }
2247
+ ]
2248
+ }
2249
+ }
2250
+ },
2251
+ "required": [
2252
+ "id",
2253
+ "peerId",
2254
+ "peerKind",
2255
+ "type",
2256
+ "command",
2257
+ "priority",
2258
+ "status",
2259
+ "createdAt",
2260
+ "updatedAt",
2261
+ "queuedBy",
2262
+ "metadata"
2263
+ ],
2264
+ "additionalProperties": true
2265
+ }
2266
+ },
2267
+ "audit": {
2268
+ "type": "array",
2269
+ "items": {
2270
+ "type": "object",
2271
+ "properties": {
2272
+ "id": {
2273
+ "type": "string"
2274
+ },
2275
+ "action": {
2276
+ "type": "string",
2277
+ "enum": [
2278
+ "pair-requested",
2279
+ "pair-approved",
2280
+ "pair-rejected",
2281
+ "pair-verified",
2282
+ "pair-expired",
2283
+ "token-rotated",
2284
+ "token-revoked",
2285
+ "peer-connected",
2286
+ "peer-disconnected",
2287
+ "work-queued",
2288
+ "work-claimed",
2289
+ "work-completed",
2290
+ "work-failed",
2291
+ "work-cancelled",
2292
+ "work-expired"
2293
+ ]
2294
+ },
2295
+ "actor": {
2296
+ "type": "string"
2297
+ },
2298
+ "peerId": {
2299
+ "type": "string"
2300
+ },
2301
+ "requestId": {
2302
+ "type": "string"
2303
+ },
2304
+ "workId": {
2305
+ "type": "string"
2306
+ },
2307
+ "createdAt": {
2308
+ "type": "number"
2309
+ },
2310
+ "note": {
2311
+ "type": "string"
2312
+ },
2313
+ "metadata": {
2314
+ "type": "object",
2315
+ "additionalProperties": {
2316
+ "anyOf": [
2317
+ {
2318
+ "type": "string"
2319
+ },
2320
+ {
2321
+ "type": "number"
2322
+ },
2323
+ {
2324
+ "type": "boolean"
2325
+ },
2326
+ {
2327
+ "type": "null"
2328
+ },
2329
+ {
2330
+ "type": "object",
2331
+ "additionalProperties": {
2332
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.audit.items.properties.metadata.additionalProperties"
2333
+ }
2334
+ },
2335
+ {
2336
+ "type": "array",
2337
+ "items": {
2338
+ "$ref": "$.endpoints[5].outputSchema.properties.distributed.properties.audit.items.properties.metadata.additionalProperties"
2339
+ }
2340
+ }
2341
+ ]
2342
+ }
2343
+ }
2344
+ },
2345
+ "required": [
2346
+ "id",
2347
+ "action",
2348
+ "actor",
2349
+ "createdAt",
2350
+ "metadata"
2351
+ ],
2352
+ "additionalProperties": true
2353
+ }
2354
+ }
2355
+ },
2356
+ "required": [
2357
+ "pairRequests",
2358
+ "peers",
2359
+ "work",
2360
+ "audit"
2361
+ ],
2362
+ "additionalProperties": false
2363
+ }
2364
+ },
2365
+ "required": [
2366
+ "daemon",
2367
+ "acp",
2368
+ "registry",
2369
+ "supervisor",
2370
+ "distributed"
2371
+ ],
2372
+ "additionalProperties": false
2373
+ }
2374
+ }
2375
+ ],
2376
+ "workCompletionStatuses": [
2377
+ "completed",
2378
+ "failed",
2379
+ "cancelled"
2380
+ ],
2381
+ "metadata": {
2382
+ "note": "Node/device hosts are external processes. GoodVibes owns the pair/token/work protocol and can be controlled from web, channel, or daemon clients."
2383
+ }
2384
+ }