@mhome/app-facade-protocol 1.71.0 → 1.81.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.
@@ -0,0 +1,836 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.mhome.ai/app-facade/agent-llm.v1.schema.json",
4
+ "$defs": {
5
+ "LlmMode": {
6
+ "type": "string",
7
+ "enum": [
8
+ "cloud",
9
+ "local"
10
+ ]
11
+ },
12
+ "ListProvidersInput": {
13
+ "type": "object",
14
+ "additionalProperties": false,
15
+ "properties": {
16
+ "llmMode": {
17
+ "$ref": "#/$defs/LlmMode"
18
+ }
19
+ },
20
+ "required": []
21
+ },
22
+ "GetProviderInput": {
23
+ "type": "object",
24
+ "additionalProperties": false,
25
+ "properties": {
26
+ "provider": {
27
+ "type": "string",
28
+ "pattern": "\\S"
29
+ },
30
+ "llmMode": {
31
+ "$ref": "#/$defs/LlmMode"
32
+ }
33
+ },
34
+ "required": [
35
+ "provider",
36
+ "llmMode"
37
+ ]
38
+ },
39
+ "Provider": {
40
+ "type": "object",
41
+ "additionalProperties": false,
42
+ "properties": {
43
+ "provider": {
44
+ "type": "string"
45
+ },
46
+ "displayName": {
47
+ "type": "string"
48
+ },
49
+ "runtime": {
50
+ "type": "string"
51
+ },
52
+ "modelSource": {
53
+ "type": "string"
54
+ },
55
+ "authKind": {
56
+ "type": "string"
57
+ },
58
+ "useCases": {
59
+ "type": "array",
60
+ "items": {
61
+ "type": "string"
62
+ }
63
+ },
64
+ "allowedAgentModes": {
65
+ "type": "object",
66
+ "additionalProperties": {
67
+ "type": "array",
68
+ "items": {
69
+ "type": "string"
70
+ }
71
+ }
72
+ },
73
+ "providerMetadata": {
74
+ "anyOf": [
75
+ {},
76
+ {
77
+ "type": "null"
78
+ }
79
+ ]
80
+ },
81
+ "configuration": {
82
+ "anyOf": [
83
+ {
84
+ "$ref": "#/$defs/ProviderConfiguration"
85
+ },
86
+ {
87
+ "type": "null"
88
+ }
89
+ ]
90
+ }
91
+ },
92
+ "required": [
93
+ "provider",
94
+ "displayName",
95
+ "runtime",
96
+ "modelSource",
97
+ "authKind",
98
+ "useCases",
99
+ "allowedAgentModes"
100
+ ]
101
+ },
102
+ "ProviderConfiguration": {
103
+ "type": "object",
104
+ "additionalProperties": false,
105
+ "properties": {
106
+ "requiresCredential": {
107
+ "type": "boolean"
108
+ },
109
+ "hasCredential": {
110
+ "type": "boolean"
111
+ },
112
+ "ready": {
113
+ "type": "boolean"
114
+ },
115
+ "status": {
116
+ "type": "string"
117
+ },
118
+ "statusLabel": {
119
+ "type": "string"
120
+ },
121
+ "reason": {
122
+ "anyOf": [
123
+ {
124
+ "type": "string"
125
+ },
126
+ {
127
+ "type": "null"
128
+ }
129
+ ]
130
+ },
131
+ "nodeType": {
132
+ "anyOf": [
133
+ {
134
+ "type": "string"
135
+ },
136
+ {
137
+ "type": "null"
138
+ }
139
+ ]
140
+ },
141
+ "nodeBound": {
142
+ "anyOf": [
143
+ {
144
+ "type": "boolean"
145
+ },
146
+ {
147
+ "type": "null"
148
+ }
149
+ ]
150
+ },
151
+ "nodeOnline": {
152
+ "anyOf": [
153
+ {
154
+ "type": "boolean"
155
+ },
156
+ {
157
+ "type": "null"
158
+ }
159
+ ]
160
+ },
161
+ "accountId": {
162
+ "anyOf": [
163
+ {
164
+ "type": "string"
165
+ },
166
+ {
167
+ "type": "null"
168
+ }
169
+ ]
170
+ },
171
+ "expiresAtMs": {
172
+ "anyOf": [
173
+ {
174
+ "type": "integer"
175
+ },
176
+ {
177
+ "type": "null"
178
+ }
179
+ ]
180
+ },
181
+ "metadata": {
182
+ "anyOf": [
183
+ {
184
+ "$ref": "#/$defs/CredentialSettings"
185
+ },
186
+ {
187
+ "type": "null"
188
+ }
189
+ ]
190
+ },
191
+ "supportedUseCases": {
192
+ "type": "array",
193
+ "items": {
194
+ "type": "string"
195
+ }
196
+ },
197
+ "readinessByUseCase": {
198
+ "type": "object",
199
+ "additionalProperties": {
200
+ "$ref": "#/$defs/UseCaseReadiness"
201
+ }
202
+ }
203
+ },
204
+ "required": [
205
+ "requiresCredential",
206
+ "hasCredential",
207
+ "ready",
208
+ "status",
209
+ "statusLabel",
210
+ "supportedUseCases",
211
+ "readinessByUseCase"
212
+ ]
213
+ },
214
+ "CredentialSettings": {
215
+ "type": "object",
216
+ "additionalProperties": false,
217
+ "properties": {
218
+ "region": {
219
+ "anyOf": [
220
+ {
221
+ "type": "string"
222
+ },
223
+ {
224
+ "type": "null"
225
+ }
226
+ ]
227
+ },
228
+ "credentialProfile": {
229
+ "anyOf": [
230
+ {
231
+ "type": "string"
232
+ },
233
+ {
234
+ "type": "null"
235
+ }
236
+ ]
237
+ },
238
+ "workspaceId": {
239
+ "anyOf": [
240
+ {
241
+ "type": "string"
242
+ },
243
+ {
244
+ "type": "null"
245
+ }
246
+ ]
247
+ }
248
+ },
249
+ "required": []
250
+ },
251
+ "UseCaseReadiness": {
252
+ "type": "object",
253
+ "additionalProperties": false,
254
+ "properties": {
255
+ "ready": {
256
+ "type": "boolean"
257
+ },
258
+ "modelCount": {
259
+ "type": "integer"
260
+ },
261
+ "reason": {
262
+ "anyOf": [
263
+ {
264
+ "type": "string"
265
+ },
266
+ {
267
+ "type": "null"
268
+ }
269
+ ]
270
+ }
271
+ },
272
+ "required": [
273
+ "ready",
274
+ "modelCount"
275
+ ]
276
+ },
277
+ "Model": {
278
+ "type": "object",
279
+ "additionalProperties": false,
280
+ "properties": {
281
+ "id": {
282
+ "type": "string"
283
+ },
284
+ "displayName": {
285
+ "type": "string"
286
+ },
287
+ "modelType": {
288
+ "type": "string"
289
+ },
290
+ "available": {
291
+ "type": "boolean"
292
+ },
293
+ "deprecated": {
294
+ "type": "boolean"
295
+ },
296
+ "successor": {
297
+ "anyOf": [
298
+ {
299
+ "type": "string"
300
+ },
301
+ {
302
+ "type": "null"
303
+ }
304
+ ]
305
+ },
306
+ "supportsTools": {
307
+ "type": "boolean"
308
+ },
309
+ "supportsVision": {
310
+ "type": "boolean"
311
+ },
312
+ "contextWindowTokens": {
313
+ "anyOf": [
314
+ {
315
+ "type": "integer"
316
+ },
317
+ {
318
+ "type": "null"
319
+ }
320
+ ]
321
+ },
322
+ "inputModalities": {
323
+ "type": "array",
324
+ "items": {
325
+ "type": "string"
326
+ }
327
+ },
328
+ "outputModalities": {
329
+ "type": "array",
330
+ "items": {
331
+ "type": "string"
332
+ }
333
+ },
334
+ "chatConfig": {
335
+ "anyOf": [
336
+ {
337
+ "$ref": "#/$defs/ModelDefaults"
338
+ },
339
+ {
340
+ "type": "null"
341
+ }
342
+ ]
343
+ },
344
+ "generationControls": {
345
+ "$ref": "#/$defs/GenerationControls"
346
+ },
347
+ "metadata": {
348
+ "anyOf": [
349
+ {},
350
+ {
351
+ "type": "null"
352
+ }
353
+ ]
354
+ }
355
+ },
356
+ "required": [
357
+ "id",
358
+ "displayName",
359
+ "modelType",
360
+ "available",
361
+ "deprecated",
362
+ "supportsTools",
363
+ "supportsVision",
364
+ "inputModalities",
365
+ "outputModalities",
366
+ "generationControls"
367
+ ]
368
+ },
369
+ "ModelDefaults": {
370
+ "type": "object",
371
+ "additionalProperties": false,
372
+ "properties": {
373
+ "temperatureDefault": {
374
+ "anyOf": [
375
+ {
376
+ "type": "number"
377
+ },
378
+ {
379
+ "type": "null"
380
+ }
381
+ ]
382
+ }
383
+ },
384
+ "required": []
385
+ },
386
+ "ModelGroup": {
387
+ "type": "object",
388
+ "additionalProperties": false,
389
+ "properties": {
390
+ "provider": {
391
+ "type": "string"
392
+ },
393
+ "models": {
394
+ "type": "array",
395
+ "items": {
396
+ "$ref": "#/$defs/Model"
397
+ }
398
+ }
399
+ },
400
+ "required": [
401
+ "provider",
402
+ "models"
403
+ ]
404
+ },
405
+ "DefaultProvider": {
406
+ "type": "object",
407
+ "additionalProperties": false,
408
+ "properties": {
409
+ "useCase": {
410
+ "type": "string"
411
+ },
412
+ "llmMode": {
413
+ "$ref": "#/$defs/LlmMode"
414
+ },
415
+ "provider": {
416
+ "type": "string"
417
+ },
418
+ "updatedAtMs": {
419
+ "type": "integer"
420
+ }
421
+ },
422
+ "required": [
423
+ "useCase",
424
+ "llmMode",
425
+ "provider",
426
+ "updatedAtMs"
427
+ ]
428
+ },
429
+ "Mapping": {
430
+ "type": "object",
431
+ "additionalProperties": false,
432
+ "properties": {
433
+ "temperature": {
434
+ "anyOf": [
435
+ {
436
+ "type": "number"
437
+ },
438
+ {
439
+ "type": "null"
440
+ }
441
+ ]
442
+ },
443
+ "reasoningEffort": {
444
+ "anyOf": [
445
+ {
446
+ "type": "string"
447
+ },
448
+ {
449
+ "type": "null"
450
+ }
451
+ ]
452
+ },
453
+ "thinking": {
454
+ "anyOf": [
455
+ {
456
+ "type": "boolean"
457
+ },
458
+ {
459
+ "type": "null"
460
+ }
461
+ ]
462
+ },
463
+ "fastMode": {
464
+ "anyOf": [
465
+ {
466
+ "type": "boolean"
467
+ },
468
+ {
469
+ "type": "null"
470
+ }
471
+ ]
472
+ },
473
+ "useCase": {
474
+ "type": "string"
475
+ },
476
+ "agentModelMode": {
477
+ "type": "string"
478
+ },
479
+ "provider": {
480
+ "anyOf": [
481
+ {
482
+ "type": "string"
483
+ },
484
+ {
485
+ "type": "null"
486
+ }
487
+ ]
488
+ },
489
+ "model": {
490
+ "anyOf": [
491
+ {
492
+ "type": "string"
493
+ },
494
+ {
495
+ "type": "null"
496
+ }
497
+ ]
498
+ },
499
+ "source": {
500
+ "type": "string"
501
+ },
502
+ "configuredModel": {
503
+ "type": "string"
504
+ }
505
+ },
506
+ "required": [
507
+ "useCase",
508
+ "agentModelMode",
509
+ "source",
510
+ "configuredModel"
511
+ ]
512
+ },
513
+ "ModelRequirements": {
514
+ "type": "object",
515
+ "additionalProperties": false,
516
+ "properties": {
517
+ "modelType": {
518
+ "type": "string"
519
+ },
520
+ "requiredInputModalities": {
521
+ "type": "array",
522
+ "items": {
523
+ "type": "string"
524
+ }
525
+ },
526
+ "optionalInputModalities": {
527
+ "type": "array",
528
+ "items": {
529
+ "type": "string"
530
+ }
531
+ },
532
+ "requiredOutputModalities": {
533
+ "type": "array",
534
+ "items": {
535
+ "type": "string"
536
+ }
537
+ },
538
+ "preferredFeatures": {
539
+ "type": "array",
540
+ "items": {
541
+ "type": "string"
542
+ }
543
+ }
544
+ },
545
+ "required": [
546
+ "modelType",
547
+ "requiredInputModalities",
548
+ "optionalInputModalities",
549
+ "requiredOutputModalities",
550
+ "preferredFeatures"
551
+ ]
552
+ },
553
+ "UseCaseMode": {
554
+ "type": "object",
555
+ "additionalProperties": false,
556
+ "properties": {
557
+ "mode": {
558
+ "type": "string"
559
+ },
560
+ "displayName": {
561
+ "type": "string"
562
+ },
563
+ "description": {
564
+ "anyOf": [
565
+ {
566
+ "type": "string"
567
+ },
568
+ {
569
+ "type": "null"
570
+ }
571
+ ]
572
+ },
573
+ "requirements": {
574
+ "$ref": "#/$defs/ModelRequirements"
575
+ }
576
+ },
577
+ "required": [
578
+ "mode",
579
+ "displayName",
580
+ "requirements"
581
+ ]
582
+ },
583
+ "UseCase": {
584
+ "type": "object",
585
+ "additionalProperties": false,
586
+ "properties": {
587
+ "useCase": {
588
+ "type": "string"
589
+ },
590
+ "displayName": {
591
+ "type": "string"
592
+ },
593
+ "description": {
594
+ "anyOf": [
595
+ {
596
+ "type": "string"
597
+ },
598
+ {
599
+ "type": "null"
600
+ }
601
+ ]
602
+ },
603
+ "ownerType": {
604
+ "anyOf": [
605
+ {
606
+ "type": "string"
607
+ },
608
+ {
609
+ "type": "null"
610
+ }
611
+ ]
612
+ },
613
+ "ownerId": {
614
+ "anyOf": [
615
+ {
616
+ "type": "string"
617
+ },
618
+ {
619
+ "type": "null"
620
+ }
621
+ ]
622
+ },
623
+ "executionUseCase": {
624
+ "anyOf": [
625
+ {
626
+ "type": "string"
627
+ },
628
+ {
629
+ "type": "null"
630
+ }
631
+ ]
632
+ },
633
+ "configurable": {
634
+ "type": "boolean"
635
+ },
636
+ "active": {
637
+ "type": "boolean"
638
+ },
639
+ "modes": {
640
+ "type": "array",
641
+ "items": {
642
+ "$ref": "#/$defs/UseCaseMode"
643
+ }
644
+ },
645
+ "updatedAtMs": {
646
+ "anyOf": [
647
+ {
648
+ "type": "integer"
649
+ },
650
+ {
651
+ "type": "null"
652
+ }
653
+ ]
654
+ },
655
+ "lastSeenAtMs": {
656
+ "anyOf": [
657
+ {
658
+ "type": "integer"
659
+ },
660
+ {
661
+ "type": "null"
662
+ }
663
+ ]
664
+ }
665
+ },
666
+ "required": [
667
+ "useCase",
668
+ "displayName",
669
+ "configurable",
670
+ "active",
671
+ "modes"
672
+ ]
673
+ },
674
+ "Summary": {
675
+ "type": "object",
676
+ "additionalProperties": false,
677
+ "properties": {
678
+ "llmMode": {
679
+ "$ref": "#/$defs/LlmMode"
680
+ },
681
+ "providers": {
682
+ "type": "array",
683
+ "items": {
684
+ "$ref": "#/$defs/Provider"
685
+ }
686
+ },
687
+ "providerModels": {
688
+ "type": "array",
689
+ "items": {
690
+ "$ref": "#/$defs/ModelGroup"
691
+ }
692
+ },
693
+ "effectiveMappings": {
694
+ "type": "array",
695
+ "items": {
696
+ "$ref": "#/$defs/Mapping"
697
+ }
698
+ },
699
+ "defaultProviders": {
700
+ "type": "array",
701
+ "items": {
702
+ "$ref": "#/$defs/DefaultProvider"
703
+ }
704
+ },
705
+ "llmUseCases": {
706
+ "type": "array",
707
+ "items": {
708
+ "$ref": "#/$defs/UseCase"
709
+ }
710
+ }
711
+ },
712
+ "required": [
713
+ "llmMode",
714
+ "providers",
715
+ "providerModels",
716
+ "effectiveMappings",
717
+ "defaultProviders",
718
+ "llmUseCases"
719
+ ]
720
+ },
721
+ "ProviderList": {
722
+ "type": "object",
723
+ "additionalProperties": false,
724
+ "properties": {
725
+ "llmMode": {
726
+ "$ref": "#/$defs/LlmMode"
727
+ },
728
+ "providers": {
729
+ "type": "array",
730
+ "items": {
731
+ "$ref": "#/$defs/Provider"
732
+ }
733
+ },
734
+ "providerModels": {
735
+ "type": "array",
736
+ "items": {
737
+ "$ref": "#/$defs/ModelGroup"
738
+ }
739
+ }
740
+ },
741
+ "required": [
742
+ "llmMode",
743
+ "providers",
744
+ "providerModels"
745
+ ]
746
+ },
747
+ "ProviderDetail": {
748
+ "type": "object",
749
+ "additionalProperties": false,
750
+ "properties": {
751
+ "llmMode": {
752
+ "$ref": "#/$defs/LlmMode"
753
+ },
754
+ "provider": {
755
+ "$ref": "#/$defs/Provider"
756
+ },
757
+ "models": {
758
+ "type": "array",
759
+ "items": {
760
+ "$ref": "#/$defs/Model"
761
+ }
762
+ }
763
+ },
764
+ "required": [
765
+ "llmMode",
766
+ "provider",
767
+ "models"
768
+ ]
769
+ },
770
+ "MappingList": {
771
+ "type": "object",
772
+ "additionalProperties": false,
773
+ "properties": {
774
+ "llmMode": {
775
+ "$ref": "#/$defs/LlmMode"
776
+ },
777
+ "effectiveMappings": {
778
+ "type": "array",
779
+ "items": {
780
+ "$ref": "#/$defs/Mapping"
781
+ }
782
+ },
783
+ "defaultProviders": {
784
+ "type": "array",
785
+ "items": {
786
+ "$ref": "#/$defs/DefaultProvider"
787
+ }
788
+ },
789
+ "llmUseCases": {
790
+ "type": "array",
791
+ "items": {
792
+ "$ref": "#/$defs/UseCase"
793
+ }
794
+ }
795
+ },
796
+ "required": [
797
+ "llmMode",
798
+ "effectiveMappings",
799
+ "defaultProviders",
800
+ "llmUseCases"
801
+ ]
802
+ },
803
+ "GenerationControls": {
804
+ "type": "object",
805
+ "additionalProperties": false,
806
+ "properties": {
807
+ "temperature": {
808
+ "type": "boolean"
809
+ },
810
+ "temperatureMax": {
811
+ "type": "number"
812
+ },
813
+ "thinking": {
814
+ "type": "boolean"
815
+ },
816
+ "reasoningEfforts": {
817
+ "type": "array",
818
+ "items": {
819
+ "type": "string"
820
+ }
821
+ },
822
+ "reasoningEffortDefault": {
823
+ "type": "string"
824
+ },
825
+ "fastMode": {
826
+ "type": "boolean"
827
+ }
828
+ },
829
+ "required": [
830
+ "temperature",
831
+ "thinking",
832
+ "fastMode"
833
+ ]
834
+ }
835
+ }
836
+ }