@mostra/protocol 0.14.0 → 0.15.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 (125) hide show
  1. package/dist/artifact-path.d.ts +22 -0
  2. package/dist/artifact-path.d.ts.map +1 -0
  3. package/dist/artifact-path.js +39 -0
  4. package/dist/artifact-path.js.map +1 -0
  5. package/dist/diagnostics/codes/index.d.ts +5 -2
  6. package/dist/diagnostics/codes/index.d.ts.map +1 -1
  7. package/dist/diagnostics/codes/index.js +7 -1
  8. package/dist/diagnostics/codes/index.js.map +1 -1
  9. package/dist/diagnostics/codes/license.d.ts +8 -0
  10. package/dist/diagnostics/codes/license.d.ts.map +1 -0
  11. package/dist/diagnostics/codes/license.js +55 -0
  12. package/dist/diagnostics/codes/license.js.map +1 -0
  13. package/dist/diagnostics/codes/pack.d.ts +8 -0
  14. package/dist/diagnostics/codes/pack.d.ts.map +1 -0
  15. package/dist/diagnostics/codes/pack.js +110 -0
  16. package/dist/diagnostics/codes/pack.js.map +1 -0
  17. package/dist/diagnostics/codes/plugin.d.ts +8 -0
  18. package/dist/diagnostics/codes/plugin.d.ts.map +1 -0
  19. package/dist/diagnostics/codes/plugin.js +154 -0
  20. package/dist/diagnostics/codes/plugin.js.map +1 -0
  21. package/dist/diagnostics/diagnostic.d.ts +1 -1
  22. package/dist/diagnostics/diagnostic.d.ts.map +1 -1
  23. package/dist/diagnostics/diagnostic.js +4 -1
  24. package/dist/diagnostics/diagnostic.js.map +1 -1
  25. package/dist/index.d.ts +13 -1
  26. package/dist/index.js +13 -1
  27. package/dist/methods/deps/add.d.ts +6 -0
  28. package/dist/methods/deps/add.d.ts.map +1 -1
  29. package/dist/methods/deps/add.js +1 -0
  30. package/dist/methods/deps/add.js.map +1 -1
  31. package/dist/methods/index.d.ts.map +1 -1
  32. package/dist/methods/index.js +15 -1
  33. package/dist/methods/index.js.map +1 -1
  34. package/dist/methods/mostra/initialize.d.ts +7 -0
  35. package/dist/methods/mostra/initialize.d.ts.map +1 -1
  36. package/dist/methods/mostra/initialize.js +4 -2
  37. package/dist/methods/mostra/initialize.js.map +1 -1
  38. package/dist/methods/pack/add.d.ts +80 -0
  39. package/dist/methods/pack/add.d.ts.map +1 -0
  40. package/dist/methods/pack/add.js +59 -0
  41. package/dist/methods/pack/add.js.map +1 -0
  42. package/dist/methods/plugin/add.d.ts +43 -0
  43. package/dist/methods/plugin/add.d.ts.map +1 -0
  44. package/dist/methods/plugin/add.js +39 -0
  45. package/dist/methods/plugin/add.js.map +1 -0
  46. package/dist/methods/plugin/commands.d.ts +38 -0
  47. package/dist/methods/plugin/commands.d.ts.map +1 -0
  48. package/dist/methods/plugin/commands.js +33 -0
  49. package/dist/methods/plugin/commands.js.map +1 -0
  50. package/dist/methods/plugin/export.d.ts +58 -0
  51. package/dist/methods/plugin/export.d.ts.map +1 -0
  52. package/dist/methods/plugin/export.js +57 -0
  53. package/dist/methods/plugin/export.js.map +1 -0
  54. package/dist/methods/plugin/list.d.ts +26 -0
  55. package/dist/methods/plugin/list.d.ts.map +1 -0
  56. package/dist/methods/plugin/list.js +30 -0
  57. package/dist/methods/plugin/list.js.map +1 -0
  58. package/dist/methods/plugin/remove.d.ts +32 -0
  59. package/dist/methods/plugin/remove.d.ts.map +1 -0
  60. package/dist/methods/plugin/remove.js +33 -0
  61. package/dist/methods/plugin/remove.js.map +1 -0
  62. package/dist/methods/plugin/validate.d.ts +35 -0
  63. package/dist/methods/plugin/validate.d.ts.map +1 -0
  64. package/dist/methods/plugin/validate.js +33 -0
  65. package/dist/methods/plugin/validate.js.map +1 -0
  66. package/dist/plugin/contract-versions.generated.js +14 -0
  67. package/dist/plugin/contract-versions.generated.js.map +1 -0
  68. package/dist/plugin/contracts.d.ts +51 -0
  69. package/dist/plugin/contracts.d.ts.map +1 -0
  70. package/dist/plugin/contracts.js +129 -0
  71. package/dist/plugin/contracts.js.map +1 -0
  72. package/dist/plugin/license.d.ts +87 -0
  73. package/dist/plugin/license.d.ts.map +1 -0
  74. package/dist/plugin/license.js +243 -0
  75. package/dist/plugin/license.js.map +1 -0
  76. package/dist/plugin/manifest.d.ts +141 -0
  77. package/dist/plugin/manifest.d.ts.map +1 -0
  78. package/dist/plugin/manifest.js +281 -0
  79. package/dist/plugin/manifest.js.map +1 -0
  80. package/dist/plugin/registry-item.d.ts +171 -0
  81. package/dist/plugin/registry-item.d.ts.map +1 -0
  82. package/dist/plugin/registry-item.js +162 -0
  83. package/dist/plugin/registry-item.js.map +1 -0
  84. package/dist/plugin/spdx.generated.d.ts +9 -0
  85. package/dist/plugin/spdx.generated.d.ts.map +1 -0
  86. package/dist/plugin/spdx.generated.js +846 -0
  87. package/dist/plugin/spdx.generated.js.map +1 -0
  88. package/dist/plugin.d.ts +7 -0
  89. package/dist/plugin.js +6 -0
  90. package/dist/plugins.d.ts +118 -0
  91. package/dist/plugins.d.ts.map +1 -0
  92. package/dist/plugins.js +109 -0
  93. package/dist/plugins.js.map +1 -0
  94. package/package.json +19 -4
  95. package/schemas/plugin-manifest.draft-07.json +611 -0
  96. package/schemas/plugin-manifest.schema.json +607 -0
  97. package/schemas/protocol.draft-07.json +899 -1
  98. package/schemas/protocol.schema.json +875 -1
  99. package/src/artifact-path.ts +46 -0
  100. package/src/diagnostics/codes/index.ts +14 -2
  101. package/src/diagnostics/codes/license.ts +65 -0
  102. package/src/diagnostics/codes/pack.ts +125 -0
  103. package/src/diagnostics/codes/plugin.ts +173 -0
  104. package/src/diagnostics/diagnostic.ts +7 -1
  105. package/src/index.ts +57 -0
  106. package/src/methods/deps/add.ts +7 -0
  107. package/src/methods/index.ts +14 -0
  108. package/src/methods/mostra/initialize.ts +9 -1
  109. package/src/methods/pack/add.ts +133 -0
  110. package/src/methods/plugin/add.ts +70 -0
  111. package/src/methods/plugin/commands.ts +67 -0
  112. package/src/methods/plugin/export.ts +100 -0
  113. package/src/methods/plugin/list.ts +45 -0
  114. package/src/methods/plugin/remove.ts +58 -0
  115. package/src/methods/plugin/validate.ts +60 -0
  116. package/src/plugin/contract-versions.generated.ts +15 -0
  117. package/src/plugin/contracts.ts +171 -0
  118. package/src/plugin/license.ts +320 -0
  119. package/src/plugin/manifest.ts +546 -0
  120. package/src/plugin/registry-item.ts +330 -0
  121. package/src/plugin/spdx-tables.ts +74 -0
  122. package/src/plugin/spdx.generated.ts +844 -0
  123. package/src/plugin.ts +77 -0
  124. package/src/plugins.ts +239 -0
  125. package/LICENSE +0 -202
@@ -235,6 +235,76 @@
235
235
  "$ref": "#/definitions/MostraShutdownResult"
236
236
  }
237
237
  },
238
+ "pack/add": {
239
+ "direction": "client-to-instance",
240
+ "mutating": true,
241
+ "params": {
242
+ "$ref": "#/definitions/PackAddParams"
243
+ },
244
+ "result": {
245
+ "$ref": "#/definitions/PackAddResult"
246
+ }
247
+ },
248
+ "plugin/add": {
249
+ "direction": "client-to-instance",
250
+ "mutating": true,
251
+ "params": {
252
+ "$ref": "#/definitions/PluginAddParams"
253
+ },
254
+ "result": {
255
+ "$ref": "#/definitions/PluginAddResult"
256
+ }
257
+ },
258
+ "plugin/commands": {
259
+ "direction": "client-to-instance",
260
+ "mutating": false,
261
+ "params": {
262
+ "$ref": "#/definitions/PluginCommandsParams"
263
+ },
264
+ "result": {
265
+ "$ref": "#/definitions/PluginCommandsResult"
266
+ }
267
+ },
268
+ "plugin/export": {
269
+ "direction": "client-to-instance",
270
+ "mutating": false,
271
+ "params": {
272
+ "$ref": "#/definitions/PluginExportParams"
273
+ },
274
+ "result": {
275
+ "$ref": "#/definitions/PluginExportResult"
276
+ }
277
+ },
278
+ "plugin/list": {
279
+ "direction": "client-to-instance",
280
+ "mutating": false,
281
+ "params": {
282
+ "$ref": "#/definitions/PluginListParams"
283
+ },
284
+ "result": {
285
+ "$ref": "#/definitions/PluginListResult"
286
+ }
287
+ },
288
+ "plugin/remove": {
289
+ "direction": "client-to-instance",
290
+ "mutating": true,
291
+ "params": {
292
+ "$ref": "#/definitions/PluginRemoveParams"
293
+ },
294
+ "result": {
295
+ "$ref": "#/definitions/PluginRemoveResult"
296
+ }
297
+ },
298
+ "plugin/validate": {
299
+ "direction": "client-to-instance",
300
+ "mutating": false,
301
+ "params": {
302
+ "$ref": "#/definitions/PluginValidateParams"
303
+ },
304
+ "result": {
305
+ "$ref": "#/definitions/PluginValidateResult"
306
+ }
307
+ },
238
308
  "port/addressing.externalBase": {
239
309
  "direction": "instance-to-host",
240
310
  "mutating": false,
@@ -1941,6 +2011,18 @@
1941
2011
  "pattern": "^cmt_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
1942
2012
  "description": "Comment ID: \"cmt_\" followed by a 26-character ULID."
1943
2013
  },
2014
+ "ContractName": {
2015
+ "type": "string",
2016
+ "enum": [
2017
+ "embed-engine",
2018
+ "exporter",
2019
+ "verify-check",
2020
+ "anchor-provider",
2021
+ "connector",
2022
+ "cli-command"
2023
+ ],
2024
+ "description": "An extension contract: each is its own @mostra/contract-<name> package (D30)."
2025
+ },
1944
2026
  "ControlsPolicy": {
1945
2027
  "type": "object",
1946
2028
  "properties": {
@@ -2085,6 +2167,15 @@
2085
2167
  "minLength": 1
2086
2168
  }
2087
2169
  },
2170
+ "acceptLicenses": {
2171
+ "readOnly": true,
2172
+ "type": "array",
2173
+ "items": {
2174
+ "type": "string",
2175
+ "minLength": 1,
2176
+ "maxLength": 256
2177
+ }
2178
+ },
2088
2179
  "requestId": {
2089
2180
  "type": "string",
2090
2181
  "minLength": 1
@@ -3520,9 +3611,16 @@
3520
3611
  "items": {
3521
3612
  "$ref": "#/definitions/SubmitChannel"
3522
3613
  }
3614
+ },
3615
+ "licenses": {
3616
+ "allOf": [
3617
+ {
3618
+ "$ref": "#/definitions/LicensePolicy"
3619
+ }
3620
+ ]
3523
3621
  }
3524
3622
  },
3525
- "description": "Home settings from a spawning host; path is a check against the instance's home (D84), dependencies the dependency policy (D43), submission the home's policy (D102), ports those the host always provides (D105)."
3623
+ "description": "Home settings from a spawning host; path is a check against the instance's home (D84), dependencies the dependency policy (D43), submission the home's policy (D102), ports those the host always provides (D105), licenses those it accepts for every install (D31)."
3526
3624
  },
3527
3625
  "HomeId": {
3528
3626
  "type": "string",
@@ -4015,6 +4113,113 @@
4015
4113
  ],
4016
4114
  "description": "A successful JSON-RPC 2.0 response."
4017
4115
  },
4116
+ "LicenseAcknowledgment": {
4117
+ "type": "string",
4118
+ "enum": [
4119
+ "not-needed",
4120
+ "accepted",
4121
+ "host",
4122
+ "missing"
4123
+ ],
4124
+ "description": "Where a license's acknowledgment stands: not-needed, accepted, host or missing."
4125
+ },
4126
+ "LicenseClass": {
4127
+ "type": "string",
4128
+ "enum": [
4129
+ "osi-permissive",
4130
+ "osi-copyleft",
4131
+ "public-domain",
4132
+ "free",
4133
+ "source-available",
4134
+ "proprietary",
4135
+ "unknown"
4136
+ ],
4137
+ "description": "What a license is (D31): OSI-approved (permissive, copyleft), public-domain, free, source-available, proprietary or unknown; the last three need an acknowledgment."
4138
+ },
4139
+ "LicenseDisclosure": {
4140
+ "type": "object",
4141
+ "properties": {
4142
+ "id": {
4143
+ "type": "string",
4144
+ "minLength": 1
4145
+ },
4146
+ "class": {
4147
+ "$ref": "#/definitions/LicenseClass"
4148
+ },
4149
+ "packages": {
4150
+ "readOnly": true,
4151
+ "type": "array",
4152
+ "items": {
4153
+ "$ref": "#/definitions/LicensedPackage"
4154
+ }
4155
+ },
4156
+ "acknowledgment": {
4157
+ "$ref": "#/definitions/LicenseAcknowledgment"
4158
+ },
4159
+ "acceptedAt": {
4160
+ "type": "string",
4161
+ "format": "date-time",
4162
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
4163
+ },
4164
+ "summary": {
4165
+ "type": "string"
4166
+ },
4167
+ "url": {
4168
+ "type": "string"
4169
+ }
4170
+ },
4171
+ "required": [
4172
+ "id",
4173
+ "class",
4174
+ "packages",
4175
+ "acknowledgment"
4176
+ ],
4177
+ "description": "A license an install brings: its ID and class, the packages under it and where its acknowledgment stands (D31)."
4178
+ },
4179
+ "LicensePolicy": {
4180
+ "type": "object",
4181
+ "properties": {
4182
+ "accept": {
4183
+ "readOnly": true,
4184
+ "maxItems": 256,
4185
+ "type": "array",
4186
+ "items": {
4187
+ "type": "string",
4188
+ "minLength": 1,
4189
+ "maxLength": 256
4190
+ }
4191
+ }
4192
+ },
4193
+ "required": [
4194
+ "accept"
4195
+ ],
4196
+ "description": "The licenses a home's host accepts for every install (D31): IDs, or * for any. Kept in config.json."
4197
+ },
4198
+ "LicensedPackage": {
4199
+ "type": "object",
4200
+ "properties": {
4201
+ "name": {
4202
+ "type": "string",
4203
+ "minLength": 1
4204
+ },
4205
+ "version": {
4206
+ "type": "string",
4207
+ "minLength": 1
4208
+ },
4209
+ "license": {
4210
+ "type": "string"
4211
+ },
4212
+ "item": {
4213
+ "type": "boolean",
4214
+ "const": true
4215
+ }
4216
+ },
4217
+ "required": [
4218
+ "name",
4219
+ "license"
4220
+ ],
4221
+ "description": "A package under a license (its name, version and declared license), or a source pack item."
4222
+ },
4018
4223
  "LinkId": {
4019
4224
  "type": "string",
4020
4225
  "pattern": "^lnk_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
@@ -4277,6 +4482,699 @@
4277
4482
  ],
4278
4483
  "description": "An owner instance's link on its binding session: its link ID, its relay mark and the hosted home's position it committed."
4279
4484
  },
4485
+ "PackAddParams": {
4486
+ "type": "object",
4487
+ "properties": {
4488
+ "artifact": {
4489
+ "$ref": "#/definitions/SourceRef"
4490
+ },
4491
+ "specs": {
4492
+ "readOnly": true,
4493
+ "minItems": 1,
4494
+ "type": "array",
4495
+ "items": {
4496
+ "type": "string",
4497
+ "minLength": 1
4498
+ }
4499
+ },
4500
+ "overwrite": {
4501
+ "type": "boolean"
4502
+ },
4503
+ "acceptLicenses": {
4504
+ "readOnly": true,
4505
+ "type": "array",
4506
+ "items": {
4507
+ "type": "string",
4508
+ "minLength": 1,
4509
+ "maxLength": 256
4510
+ }
4511
+ },
4512
+ "environment": {
4513
+ "type": "object",
4514
+ "propertyNames": {
4515
+ "type": "string",
4516
+ "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
4517
+ },
4518
+ "additionalProperties": {
4519
+ "type": "string"
4520
+ }
4521
+ },
4522
+ "requestId": {
4523
+ "type": "string",
4524
+ "minLength": 1
4525
+ }
4526
+ },
4527
+ "required": [
4528
+ "artifact",
4529
+ "specs"
4530
+ ]
4531
+ },
4532
+ "PackAddResult": {
4533
+ "type": "object",
4534
+ "properties": {
4535
+ "items": {
4536
+ "readOnly": true,
4537
+ "type": "array",
4538
+ "items": {
4539
+ "$ref": "#/definitions/PackItemSummary"
4540
+ }
4541
+ },
4542
+ "files": {
4543
+ "readOnly": true,
4544
+ "type": "array",
4545
+ "items": {
4546
+ "$ref": "#/definitions/PackFileChange"
4547
+ }
4548
+ },
4549
+ "packages": {
4550
+ "readOnly": true,
4551
+ "type": "array",
4552
+ "items": {
4553
+ "$ref": "#/definitions/AddedPackage"
4554
+ }
4555
+ },
4556
+ "licenses": {
4557
+ "readOnly": true,
4558
+ "type": "array",
4559
+ "items": {
4560
+ "$ref": "#/definitions/LicenseDisclosure"
4561
+ }
4562
+ },
4563
+ "lockDigest": {
4564
+ "type": "string",
4565
+ "pattern": "^[0-9a-f]{64}$"
4566
+ },
4567
+ "notes": {
4568
+ "readOnly": true,
4569
+ "type": "array",
4570
+ "items": {
4571
+ "$ref": "#/definitions/Diagnostic"
4572
+ }
4573
+ }
4574
+ },
4575
+ "required": [
4576
+ "items",
4577
+ "files",
4578
+ "packages",
4579
+ "licenses",
4580
+ "notes"
4581
+ ]
4582
+ },
4583
+ "PackFileChange": {
4584
+ "type": "object",
4585
+ "properties": {
4586
+ "path": {
4587
+ "type": "string",
4588
+ "minLength": 1
4589
+ },
4590
+ "action": {
4591
+ "type": "string",
4592
+ "enum": [
4593
+ "created",
4594
+ "overwritten",
4595
+ "unchanged",
4596
+ "updated"
4597
+ ]
4598
+ }
4599
+ },
4600
+ "required": [
4601
+ "path",
4602
+ "action"
4603
+ ]
4604
+ },
4605
+ "PackItemSummary": {
4606
+ "type": "object",
4607
+ "properties": {
4608
+ "name": {
4609
+ "type": "string"
4610
+ },
4611
+ "type": {
4612
+ "type": "string"
4613
+ },
4614
+ "address": {
4615
+ "type": "string"
4616
+ },
4617
+ "source": {
4618
+ "type": "string"
4619
+ },
4620
+ "requiredBy": {
4621
+ "type": "string"
4622
+ },
4623
+ "fields": {
4624
+ "readOnly": true,
4625
+ "type": "array",
4626
+ "items": {
4627
+ "type": "string"
4628
+ }
4629
+ }
4630
+ },
4631
+ "required": [
4632
+ "name",
4633
+ "type",
4634
+ "address",
4635
+ "source"
4636
+ ]
4637
+ },
4638
+ "PluginAddParams": {
4639
+ "type": "object",
4640
+ "properties": {
4641
+ "artifact": {
4642
+ "allOf": [
4643
+ {
4644
+ "$ref": "#/definitions/SourceRef"
4645
+ }
4646
+ ]
4647
+ },
4648
+ "home": {
4649
+ "type": "boolean"
4650
+ },
4651
+ "packages": {
4652
+ "readOnly": true,
4653
+ "minItems": 1,
4654
+ "type": "array",
4655
+ "items": {
4656
+ "type": "string",
4657
+ "minLength": 1
4658
+ }
4659
+ },
4660
+ "acceptLicenses": {
4661
+ "readOnly": true,
4662
+ "type": "array",
4663
+ "items": {
4664
+ "type": "string",
4665
+ "minLength": 1,
4666
+ "maxLength": 256
4667
+ }
4668
+ },
4669
+ "requestId": {
4670
+ "type": "string",
4671
+ "minLength": 1
4672
+ }
4673
+ },
4674
+ "required": [
4675
+ "packages"
4676
+ ]
4677
+ },
4678
+ "PluginAddResult": {
4679
+ "type": "object",
4680
+ "properties": {
4681
+ "plugins": {
4682
+ "readOnly": true,
4683
+ "type": "array",
4684
+ "items": {
4685
+ "$ref": "#/definitions/PluginSummary"
4686
+ }
4687
+ },
4688
+ "added": {
4689
+ "readOnly": true,
4690
+ "type": "array",
4691
+ "items": {
4692
+ "type": "string"
4693
+ }
4694
+ },
4695
+ "licenses": {
4696
+ "readOnly": true,
4697
+ "type": "array",
4698
+ "items": {
4699
+ "$ref": "#/definitions/LicenseDisclosure"
4700
+ }
4701
+ },
4702
+ "lockDigest": {
4703
+ "type": "string",
4704
+ "pattern": "^[0-9a-f]{64}$"
4705
+ }
4706
+ },
4707
+ "required": [
4708
+ "plugins",
4709
+ "added",
4710
+ "licenses",
4711
+ "lockDigest"
4712
+ ]
4713
+ },
4714
+ "PluginCommandInfo": {
4715
+ "type": "object",
4716
+ "properties": {
4717
+ "command": {
4718
+ "type": "string",
4719
+ "minLength": 1
4720
+ },
4721
+ "package": {
4722
+ "type": "string",
4723
+ "minLength": 1
4724
+ },
4725
+ "version": {
4726
+ "type": "string",
4727
+ "minLength": 1
4728
+ },
4729
+ "scope": {
4730
+ "$ref": "#/definitions/PluginScope"
4731
+ },
4732
+ "file": {
4733
+ "type": "string",
4734
+ "pattern": "^(?:\\/|[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\])"
4735
+ },
4736
+ "export": {
4737
+ "type": "string",
4738
+ "minLength": 1
4739
+ }
4740
+ },
4741
+ "required": [
4742
+ "command",
4743
+ "package",
4744
+ "version",
4745
+ "scope",
4746
+ "file",
4747
+ "export"
4748
+ ]
4749
+ },
4750
+ "PluginCommandsParams": {
4751
+ "type": "object",
4752
+ "properties": {
4753
+ "artifact": {
4754
+ "allOf": [
4755
+ {
4756
+ "$ref": "#/definitions/SourceRef"
4757
+ }
4758
+ ]
4759
+ }
4760
+ }
4761
+ },
4762
+ "PluginCommandsResult": {
4763
+ "type": "object",
4764
+ "properties": {
4765
+ "commands": {
4766
+ "readOnly": true,
4767
+ "type": "array",
4768
+ "items": {
4769
+ "$ref": "#/definitions/PluginCommandInfo"
4770
+ }
4771
+ }
4772
+ },
4773
+ "required": [
4774
+ "commands"
4775
+ ]
4776
+ },
4777
+ "PluginContribution": {
4778
+ "type": "object",
4779
+ "properties": {
4780
+ "contract": {
4781
+ "$ref": "#/definitions/ContractName"
4782
+ },
4783
+ "id": {
4784
+ "type": "string",
4785
+ "minLength": 1
4786
+ }
4787
+ },
4788
+ "required": [
4789
+ "contract",
4790
+ "id"
4791
+ ],
4792
+ "description": "A plugin's contribution: the contract it implements and its ID."
4793
+ },
4794
+ "PluginExportParams": {
4795
+ "type": "object",
4796
+ "properties": {
4797
+ "artifact": {
4798
+ "$ref": "#/definitions/ArtifactRef"
4799
+ },
4800
+ "version": {
4801
+ "anyOf": [
4802
+ {
4803
+ "type": "integer",
4804
+ "minimum": 1,
4805
+ "maximum": 9007199254740991
4806
+ },
4807
+ {
4808
+ "type": "string",
4809
+ "minLength": 1
4810
+ }
4811
+ ]
4812
+ },
4813
+ "exporter": {
4814
+ "type": "string",
4815
+ "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
4816
+ },
4817
+ "out": {
4818
+ "type": "string",
4819
+ "minLength": 1
4820
+ },
4821
+ "options": {
4822
+ "type": "object",
4823
+ "propertyNames": {
4824
+ "type": "string"
4825
+ },
4826
+ "additionalProperties": {}
4827
+ }
4828
+ },
4829
+ "required": [
4830
+ "artifact",
4831
+ "exporter",
4832
+ "out"
4833
+ ]
4834
+ },
4835
+ "PluginExportResult": {
4836
+ "type": "object",
4837
+ "properties": {
4838
+ "files": {
4839
+ "readOnly": true,
4840
+ "type": "array",
4841
+ "items": {
4842
+ "type": "string"
4843
+ }
4844
+ },
4845
+ "entry": {
4846
+ "type": "string"
4847
+ },
4848
+ "versionId": {
4849
+ "type": "string"
4850
+ },
4851
+ "exporter": {
4852
+ "type": "object",
4853
+ "properties": {
4854
+ "id": {
4855
+ "type": "string"
4856
+ },
4857
+ "package": {
4858
+ "type": "string"
4859
+ }
4860
+ },
4861
+ "required": [
4862
+ "id",
4863
+ "package"
4864
+ ]
4865
+ },
4866
+ "findings": {
4867
+ "readOnly": true,
4868
+ "type": "array",
4869
+ "items": {
4870
+ "$ref": "#/definitions/PluginFinding"
4871
+ }
4872
+ }
4873
+ },
4874
+ "required": [
4875
+ "files",
4876
+ "versionId",
4877
+ "exporter",
4878
+ "findings"
4879
+ ]
4880
+ },
4881
+ "PluginFinding": {
4882
+ "type": "object",
4883
+ "properties": {
4884
+ "code": {
4885
+ "type": "string",
4886
+ "minLength": 1,
4887
+ "maxLength": 64
4888
+ },
4889
+ "severity": {
4890
+ "type": "string",
4891
+ "enum": [
4892
+ "error",
4893
+ "warning",
4894
+ "hint"
4895
+ ]
4896
+ },
4897
+ "message": {
4898
+ "type": "string"
4899
+ },
4900
+ "hint": {
4901
+ "type": "string"
4902
+ },
4903
+ "location": {
4904
+ "type": "object",
4905
+ "properties": {
4906
+ "file": {
4907
+ "type": "string"
4908
+ },
4909
+ "line": {
4910
+ "type": "integer",
4911
+ "minimum": 1,
4912
+ "maximum": 9007199254740991
4913
+ },
4914
+ "column": {
4915
+ "type": "integer",
4916
+ "minimum": 1,
4917
+ "maximum": 9007199254740991
4918
+ }
4919
+ },
4920
+ "required": [
4921
+ "file"
4922
+ ]
4923
+ }
4924
+ },
4925
+ "required": [
4926
+ "code",
4927
+ "severity",
4928
+ "message"
4929
+ ],
4930
+ "description": "Something a plugin's contribution reported, in the plugin's own code."
4931
+ },
4932
+ "PluginListParams": {
4933
+ "type": "object",
4934
+ "properties": {
4935
+ "artifact": {
4936
+ "allOf": [
4937
+ {
4938
+ "$ref": "#/definitions/SourceRef"
4939
+ }
4940
+ ]
4941
+ },
4942
+ "home": {
4943
+ "type": "boolean"
4944
+ }
4945
+ }
4946
+ },
4947
+ "PluginListResult": {
4948
+ "type": "object",
4949
+ "properties": {
4950
+ "plugins": {
4951
+ "readOnly": true,
4952
+ "type": "array",
4953
+ "items": {
4954
+ "$ref": "#/definitions/PluginSummary"
4955
+ }
4956
+ },
4957
+ "licenses": {
4958
+ "readOnly": true,
4959
+ "type": "array",
4960
+ "items": {
4961
+ "$ref": "#/definitions/LicenseDisclosure"
4962
+ }
4963
+ }
4964
+ },
4965
+ "required": [
4966
+ "plugins",
4967
+ "licenses"
4968
+ ]
4969
+ },
4970
+ "PluginRemoveParams": {
4971
+ "type": "object",
4972
+ "properties": {
4973
+ "artifact": {
4974
+ "allOf": [
4975
+ {
4976
+ "$ref": "#/definitions/SourceRef"
4977
+ }
4978
+ ]
4979
+ },
4980
+ "home": {
4981
+ "type": "boolean"
4982
+ },
4983
+ "packages": {
4984
+ "readOnly": true,
4985
+ "minItems": 1,
4986
+ "type": "array",
4987
+ "items": {
4988
+ "type": "string",
4989
+ "minLength": 1
4990
+ }
4991
+ },
4992
+ "requestId": {
4993
+ "type": "string",
4994
+ "minLength": 1
4995
+ }
4996
+ },
4997
+ "required": [
4998
+ "packages"
4999
+ ]
5000
+ },
5001
+ "PluginRemoveResult": {
5002
+ "type": "object",
5003
+ "properties": {
5004
+ "removed": {
5005
+ "readOnly": true,
5006
+ "type": "array",
5007
+ "items": {
5008
+ "type": "string"
5009
+ }
5010
+ },
5011
+ "plugins": {
5012
+ "readOnly": true,
5013
+ "type": "array",
5014
+ "items": {
5015
+ "$ref": "#/definitions/PluginSummary"
5016
+ }
5017
+ },
5018
+ "lockDigest": {
5019
+ "type": "string",
5020
+ "pattern": "^[0-9a-f]{64}$"
5021
+ }
5022
+ },
5023
+ "required": [
5024
+ "removed",
5025
+ "plugins",
5026
+ "lockDigest"
5027
+ ]
5028
+ },
5029
+ "PluginScope": {
5030
+ "type": "string",
5031
+ "enum": [
5032
+ "artifact",
5033
+ "home"
5034
+ ],
5035
+ "description": "Where a plugin is installed: one artifact, or the whole home (exporters and CLI commands)."
5036
+ },
5037
+ "PluginSummary": {
5038
+ "type": "object",
5039
+ "properties": {
5040
+ "package": {
5041
+ "type": "string",
5042
+ "minLength": 1
5043
+ },
5044
+ "version": {
5045
+ "type": "string",
5046
+ "minLength": 1
5047
+ },
5048
+ "name": {
5049
+ "type": "string",
5050
+ "minLength": 1
5051
+ },
5052
+ "title": {
5053
+ "type": "string"
5054
+ },
5055
+ "description": {
5056
+ "type": "string"
5057
+ },
5058
+ "scope": {
5059
+ "$ref": "#/definitions/PluginScope"
5060
+ },
5061
+ "contracts": {
5062
+ "type": "object",
5063
+ "propertyNames": {
5064
+ "type": "string"
5065
+ },
5066
+ "additionalProperties": {
5067
+ "type": "string"
5068
+ }
5069
+ },
5070
+ "contributions": {
5071
+ "readOnly": true,
5072
+ "type": "array",
5073
+ "items": {
5074
+ "$ref": "#/definitions/PluginContribution"
5075
+ }
5076
+ },
5077
+ "packs": {
5078
+ "readOnly": true,
5079
+ "type": "array",
5080
+ "items": {
5081
+ "type": "string"
5082
+ }
5083
+ },
5084
+ "effects": {
5085
+ "readOnly": true,
5086
+ "type": "array",
5087
+ "items": {
5088
+ "type": "string"
5089
+ }
5090
+ },
5091
+ "license": {
5092
+ "type": "string"
5093
+ },
5094
+ "platforms": {
5095
+ "readOnly": true,
5096
+ "type": "array",
5097
+ "items": {
5098
+ "type": "string"
5099
+ }
5100
+ },
5101
+ "status": {
5102
+ "type": "string",
5103
+ "enum": [
5104
+ "ok",
5105
+ "error"
5106
+ ]
5107
+ },
5108
+ "diagnostics": {
5109
+ "readOnly": true,
5110
+ "type": "array",
5111
+ "items": {
5112
+ "$ref": "#/definitions/Diagnostic"
5113
+ }
5114
+ }
5115
+ },
5116
+ "required": [
5117
+ "package",
5118
+ "version",
5119
+ "name",
5120
+ "scope",
5121
+ "contracts",
5122
+ "contributions",
5123
+ "packs",
5124
+ "effects",
5125
+ "license",
5126
+ "status",
5127
+ "diagnostics"
5128
+ ],
5129
+ "description": "A plugin as plugin/* reports it: its package, manifest, scope, contributions, licenses and whether it loads (D30)."
5130
+ },
5131
+ "PluginValidateParams": {
5132
+ "type": "object",
5133
+ "properties": {
5134
+ "path": {
5135
+ "type": "string",
5136
+ "pattern": "^(?:\\/|[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\])"
5137
+ },
5138
+ "acceptLicenses": {
5139
+ "readOnly": true,
5140
+ "type": "array",
5141
+ "items": {
5142
+ "type": "string",
5143
+ "minLength": 1,
5144
+ "maxLength": 256
5145
+ }
5146
+ }
5147
+ },
5148
+ "required": [
5149
+ "path"
5150
+ ]
5151
+ },
5152
+ "PluginValidateResult": {
5153
+ "type": "object",
5154
+ "properties": {
5155
+ "valid": {
5156
+ "type": "boolean"
5157
+ },
5158
+ "plugin": {
5159
+ "allOf": [
5160
+ {
5161
+ "$ref": "#/definitions/PluginSummary"
5162
+ }
5163
+ ]
5164
+ },
5165
+ "diagnostics": {
5166
+ "readOnly": true,
5167
+ "type": "array",
5168
+ "items": {
5169
+ "$ref": "#/definitions/Diagnostic"
5170
+ }
5171
+ }
5172
+ },
5173
+ "required": [
5174
+ "valid",
5175
+ "diagnostics"
5176
+ ]
5177
+ },
4280
5178
  "PollResult": {
4281
5179
  "type": "object",
4282
5180
  "properties": {