@mostra/protocol 0.13.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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": "#/$defs/MostraShutdownResult"
236
236
  }
237
237
  },
238
+ "pack/add": {
239
+ "direction": "client-to-instance",
240
+ "mutating": true,
241
+ "params": {
242
+ "$ref": "#/$defs/PackAddParams"
243
+ },
244
+ "result": {
245
+ "$ref": "#/$defs/PackAddResult"
246
+ }
247
+ },
248
+ "plugin/add": {
249
+ "direction": "client-to-instance",
250
+ "mutating": true,
251
+ "params": {
252
+ "$ref": "#/$defs/PluginAddParams"
253
+ },
254
+ "result": {
255
+ "$ref": "#/$defs/PluginAddResult"
256
+ }
257
+ },
258
+ "plugin/commands": {
259
+ "direction": "client-to-instance",
260
+ "mutating": false,
261
+ "params": {
262
+ "$ref": "#/$defs/PluginCommandsParams"
263
+ },
264
+ "result": {
265
+ "$ref": "#/$defs/PluginCommandsResult"
266
+ }
267
+ },
268
+ "plugin/export": {
269
+ "direction": "client-to-instance",
270
+ "mutating": false,
271
+ "params": {
272
+ "$ref": "#/$defs/PluginExportParams"
273
+ },
274
+ "result": {
275
+ "$ref": "#/$defs/PluginExportResult"
276
+ }
277
+ },
278
+ "plugin/list": {
279
+ "direction": "client-to-instance",
280
+ "mutating": false,
281
+ "params": {
282
+ "$ref": "#/$defs/PluginListParams"
283
+ },
284
+ "result": {
285
+ "$ref": "#/$defs/PluginListResult"
286
+ }
287
+ },
288
+ "plugin/remove": {
289
+ "direction": "client-to-instance",
290
+ "mutating": true,
291
+ "params": {
292
+ "$ref": "#/$defs/PluginRemoveParams"
293
+ },
294
+ "result": {
295
+ "$ref": "#/$defs/PluginRemoveResult"
296
+ }
297
+ },
298
+ "plugin/validate": {
299
+ "direction": "client-to-instance",
300
+ "mutating": false,
301
+ "params": {
302
+ "$ref": "#/$defs/PluginValidateParams"
303
+ },
304
+ "result": {
305
+ "$ref": "#/$defs/PluginValidateResult"
306
+ }
307
+ },
238
308
  "port/addressing.externalBase": {
239
309
  "direction": "instance-to-host",
240
310
  "mutating": false,
@@ -1897,6 +1967,18 @@
1897
1967
  "pattern": "^cmt_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
1898
1968
  "description": "Comment ID: \"cmt_\" followed by a 26-character ULID."
1899
1969
  },
1970
+ "ContractName": {
1971
+ "type": "string",
1972
+ "enum": [
1973
+ "embed-engine",
1974
+ "exporter",
1975
+ "verify-check",
1976
+ "anchor-provider",
1977
+ "connector",
1978
+ "cli-command"
1979
+ ],
1980
+ "description": "An extension contract: each is its own @mostra/contract-<name> package (D30)."
1981
+ },
1900
1982
  "ControlsPolicy": {
1901
1983
  "type": "object",
1902
1984
  "properties": {
@@ -2041,6 +2123,15 @@
2041
2123
  "minLength": 1
2042
2124
  }
2043
2125
  },
2126
+ "acceptLicenses": {
2127
+ "readOnly": true,
2128
+ "type": "array",
2129
+ "items": {
2130
+ "type": "string",
2131
+ "minLength": 1,
2132
+ "maxLength": 256
2133
+ }
2134
+ },
2044
2135
  "requestId": {
2045
2136
  "type": "string",
2046
2137
  "minLength": 1
@@ -3416,9 +3507,12 @@
3416
3507
  "items": {
3417
3508
  "$ref": "#/$defs/SubmitChannel"
3418
3509
  }
3510
+ },
3511
+ "licenses": {
3512
+ "$ref": "#/$defs/LicensePolicy"
3419
3513
  }
3420
3514
  },
3421
- "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)."
3515
+ "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)."
3422
3516
  },
3423
3517
  "HomeId": {
3424
3518
  "type": "string",
@@ -3899,6 +3993,113 @@
3899
3993
  ],
3900
3994
  "description": "A successful JSON-RPC 2.0 response."
3901
3995
  },
3996
+ "LicenseAcknowledgment": {
3997
+ "type": "string",
3998
+ "enum": [
3999
+ "not-needed",
4000
+ "accepted",
4001
+ "host",
4002
+ "missing"
4003
+ ],
4004
+ "description": "Where a license's acknowledgment stands: not-needed, accepted, host or missing."
4005
+ },
4006
+ "LicenseClass": {
4007
+ "type": "string",
4008
+ "enum": [
4009
+ "osi-permissive",
4010
+ "osi-copyleft",
4011
+ "public-domain",
4012
+ "free",
4013
+ "source-available",
4014
+ "proprietary",
4015
+ "unknown"
4016
+ ],
4017
+ "description": "What a license is (D31): OSI-approved (permissive, copyleft), public-domain, free, source-available, proprietary or unknown; the last three need an acknowledgment."
4018
+ },
4019
+ "LicenseDisclosure": {
4020
+ "type": "object",
4021
+ "properties": {
4022
+ "id": {
4023
+ "type": "string",
4024
+ "minLength": 1
4025
+ },
4026
+ "class": {
4027
+ "$ref": "#/$defs/LicenseClass"
4028
+ },
4029
+ "packages": {
4030
+ "readOnly": true,
4031
+ "type": "array",
4032
+ "items": {
4033
+ "$ref": "#/$defs/LicensedPackage"
4034
+ }
4035
+ },
4036
+ "acknowledgment": {
4037
+ "$ref": "#/$defs/LicenseAcknowledgment"
4038
+ },
4039
+ "acceptedAt": {
4040
+ "type": "string",
4041
+ "format": "date-time",
4042
+ "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))$"
4043
+ },
4044
+ "summary": {
4045
+ "type": "string"
4046
+ },
4047
+ "url": {
4048
+ "type": "string"
4049
+ }
4050
+ },
4051
+ "required": [
4052
+ "id",
4053
+ "class",
4054
+ "packages",
4055
+ "acknowledgment"
4056
+ ],
4057
+ "description": "A license an install brings: its ID and class, the packages under it and where its acknowledgment stands (D31)."
4058
+ },
4059
+ "LicensePolicy": {
4060
+ "type": "object",
4061
+ "properties": {
4062
+ "accept": {
4063
+ "readOnly": true,
4064
+ "maxItems": 256,
4065
+ "type": "array",
4066
+ "items": {
4067
+ "type": "string",
4068
+ "minLength": 1,
4069
+ "maxLength": 256
4070
+ }
4071
+ }
4072
+ },
4073
+ "required": [
4074
+ "accept"
4075
+ ],
4076
+ "description": "The licenses a home's host accepts for every install (D31): IDs, or * for any. Kept in config.json."
4077
+ },
4078
+ "LicensedPackage": {
4079
+ "type": "object",
4080
+ "properties": {
4081
+ "name": {
4082
+ "type": "string",
4083
+ "minLength": 1
4084
+ },
4085
+ "version": {
4086
+ "type": "string",
4087
+ "minLength": 1
4088
+ },
4089
+ "license": {
4090
+ "type": "string"
4091
+ },
4092
+ "item": {
4093
+ "type": "boolean",
4094
+ "const": true
4095
+ }
4096
+ },
4097
+ "required": [
4098
+ "name",
4099
+ "license"
4100
+ ],
4101
+ "description": "A package under a license (its name, version and declared license), or a source pack item."
4102
+ },
3902
4103
  "LinkId": {
3903
4104
  "type": "string",
3904
4105
  "pattern": "^lnk_[0-7][0-9A-HJKMNP-TV-Z]{25}$",
@@ -4153,6 +4354,679 @@
4153
4354
  ],
4154
4355
  "description": "An owner instance's link on its binding session: its link ID, its relay mark and the hosted home's position it committed."
4155
4356
  },
4357
+ "PackAddParams": {
4358
+ "type": "object",
4359
+ "properties": {
4360
+ "artifact": {
4361
+ "$ref": "#/$defs/SourceRef"
4362
+ },
4363
+ "specs": {
4364
+ "readOnly": true,
4365
+ "minItems": 1,
4366
+ "type": "array",
4367
+ "items": {
4368
+ "type": "string",
4369
+ "minLength": 1
4370
+ }
4371
+ },
4372
+ "overwrite": {
4373
+ "type": "boolean"
4374
+ },
4375
+ "acceptLicenses": {
4376
+ "readOnly": true,
4377
+ "type": "array",
4378
+ "items": {
4379
+ "type": "string",
4380
+ "minLength": 1,
4381
+ "maxLength": 256
4382
+ }
4383
+ },
4384
+ "environment": {
4385
+ "type": "object",
4386
+ "propertyNames": {
4387
+ "type": "string",
4388
+ "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
4389
+ },
4390
+ "additionalProperties": {
4391
+ "type": "string"
4392
+ }
4393
+ },
4394
+ "requestId": {
4395
+ "type": "string",
4396
+ "minLength": 1
4397
+ }
4398
+ },
4399
+ "required": [
4400
+ "artifact",
4401
+ "specs"
4402
+ ]
4403
+ },
4404
+ "PackAddResult": {
4405
+ "type": "object",
4406
+ "properties": {
4407
+ "items": {
4408
+ "readOnly": true,
4409
+ "type": "array",
4410
+ "items": {
4411
+ "$ref": "#/$defs/PackItemSummary"
4412
+ }
4413
+ },
4414
+ "files": {
4415
+ "readOnly": true,
4416
+ "type": "array",
4417
+ "items": {
4418
+ "$ref": "#/$defs/PackFileChange"
4419
+ }
4420
+ },
4421
+ "packages": {
4422
+ "readOnly": true,
4423
+ "type": "array",
4424
+ "items": {
4425
+ "$ref": "#/$defs/AddedPackage"
4426
+ }
4427
+ },
4428
+ "licenses": {
4429
+ "readOnly": true,
4430
+ "type": "array",
4431
+ "items": {
4432
+ "$ref": "#/$defs/LicenseDisclosure"
4433
+ }
4434
+ },
4435
+ "lockDigest": {
4436
+ "type": "string",
4437
+ "pattern": "^[0-9a-f]{64}$"
4438
+ },
4439
+ "notes": {
4440
+ "readOnly": true,
4441
+ "type": "array",
4442
+ "items": {
4443
+ "$ref": "#/$defs/Diagnostic"
4444
+ }
4445
+ }
4446
+ },
4447
+ "required": [
4448
+ "items",
4449
+ "files",
4450
+ "packages",
4451
+ "licenses",
4452
+ "notes"
4453
+ ]
4454
+ },
4455
+ "PackFileChange": {
4456
+ "type": "object",
4457
+ "properties": {
4458
+ "path": {
4459
+ "type": "string",
4460
+ "minLength": 1
4461
+ },
4462
+ "action": {
4463
+ "type": "string",
4464
+ "enum": [
4465
+ "created",
4466
+ "overwritten",
4467
+ "unchanged",
4468
+ "updated"
4469
+ ]
4470
+ }
4471
+ },
4472
+ "required": [
4473
+ "path",
4474
+ "action"
4475
+ ]
4476
+ },
4477
+ "PackItemSummary": {
4478
+ "type": "object",
4479
+ "properties": {
4480
+ "name": {
4481
+ "type": "string"
4482
+ },
4483
+ "type": {
4484
+ "type": "string"
4485
+ },
4486
+ "address": {
4487
+ "type": "string"
4488
+ },
4489
+ "source": {
4490
+ "type": "string"
4491
+ },
4492
+ "requiredBy": {
4493
+ "type": "string"
4494
+ },
4495
+ "fields": {
4496
+ "readOnly": true,
4497
+ "type": "array",
4498
+ "items": {
4499
+ "type": "string"
4500
+ }
4501
+ }
4502
+ },
4503
+ "required": [
4504
+ "name",
4505
+ "type",
4506
+ "address",
4507
+ "source"
4508
+ ]
4509
+ },
4510
+ "PluginAddParams": {
4511
+ "type": "object",
4512
+ "properties": {
4513
+ "artifact": {
4514
+ "$ref": "#/$defs/SourceRef"
4515
+ },
4516
+ "home": {
4517
+ "type": "boolean"
4518
+ },
4519
+ "packages": {
4520
+ "readOnly": true,
4521
+ "minItems": 1,
4522
+ "type": "array",
4523
+ "items": {
4524
+ "type": "string",
4525
+ "minLength": 1
4526
+ }
4527
+ },
4528
+ "acceptLicenses": {
4529
+ "readOnly": true,
4530
+ "type": "array",
4531
+ "items": {
4532
+ "type": "string",
4533
+ "minLength": 1,
4534
+ "maxLength": 256
4535
+ }
4536
+ },
4537
+ "requestId": {
4538
+ "type": "string",
4539
+ "minLength": 1
4540
+ }
4541
+ },
4542
+ "required": [
4543
+ "packages"
4544
+ ]
4545
+ },
4546
+ "PluginAddResult": {
4547
+ "type": "object",
4548
+ "properties": {
4549
+ "plugins": {
4550
+ "readOnly": true,
4551
+ "type": "array",
4552
+ "items": {
4553
+ "$ref": "#/$defs/PluginSummary"
4554
+ }
4555
+ },
4556
+ "added": {
4557
+ "readOnly": true,
4558
+ "type": "array",
4559
+ "items": {
4560
+ "type": "string"
4561
+ }
4562
+ },
4563
+ "licenses": {
4564
+ "readOnly": true,
4565
+ "type": "array",
4566
+ "items": {
4567
+ "$ref": "#/$defs/LicenseDisclosure"
4568
+ }
4569
+ },
4570
+ "lockDigest": {
4571
+ "type": "string",
4572
+ "pattern": "^[0-9a-f]{64}$"
4573
+ }
4574
+ },
4575
+ "required": [
4576
+ "plugins",
4577
+ "added",
4578
+ "licenses",
4579
+ "lockDigest"
4580
+ ]
4581
+ },
4582
+ "PluginCommandInfo": {
4583
+ "type": "object",
4584
+ "properties": {
4585
+ "command": {
4586
+ "type": "string",
4587
+ "minLength": 1
4588
+ },
4589
+ "package": {
4590
+ "type": "string",
4591
+ "minLength": 1
4592
+ },
4593
+ "version": {
4594
+ "type": "string",
4595
+ "minLength": 1
4596
+ },
4597
+ "scope": {
4598
+ "$ref": "#/$defs/PluginScope"
4599
+ },
4600
+ "file": {
4601
+ "type": "string",
4602
+ "pattern": "^(?:\\/|[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\])"
4603
+ },
4604
+ "export": {
4605
+ "type": "string",
4606
+ "minLength": 1
4607
+ }
4608
+ },
4609
+ "required": [
4610
+ "command",
4611
+ "package",
4612
+ "version",
4613
+ "scope",
4614
+ "file",
4615
+ "export"
4616
+ ]
4617
+ },
4618
+ "PluginCommandsParams": {
4619
+ "type": "object",
4620
+ "properties": {
4621
+ "artifact": {
4622
+ "$ref": "#/$defs/SourceRef"
4623
+ }
4624
+ }
4625
+ },
4626
+ "PluginCommandsResult": {
4627
+ "type": "object",
4628
+ "properties": {
4629
+ "commands": {
4630
+ "readOnly": true,
4631
+ "type": "array",
4632
+ "items": {
4633
+ "$ref": "#/$defs/PluginCommandInfo"
4634
+ }
4635
+ }
4636
+ },
4637
+ "required": [
4638
+ "commands"
4639
+ ]
4640
+ },
4641
+ "PluginContribution": {
4642
+ "type": "object",
4643
+ "properties": {
4644
+ "contract": {
4645
+ "$ref": "#/$defs/ContractName"
4646
+ },
4647
+ "id": {
4648
+ "type": "string",
4649
+ "minLength": 1
4650
+ }
4651
+ },
4652
+ "required": [
4653
+ "contract",
4654
+ "id"
4655
+ ],
4656
+ "description": "A plugin's contribution: the contract it implements and its ID."
4657
+ },
4658
+ "PluginExportParams": {
4659
+ "type": "object",
4660
+ "properties": {
4661
+ "artifact": {
4662
+ "$ref": "#/$defs/ArtifactRef"
4663
+ },
4664
+ "version": {
4665
+ "anyOf": [
4666
+ {
4667
+ "type": "integer",
4668
+ "minimum": 1,
4669
+ "maximum": 9007199254740991
4670
+ },
4671
+ {
4672
+ "type": "string",
4673
+ "minLength": 1
4674
+ }
4675
+ ]
4676
+ },
4677
+ "exporter": {
4678
+ "type": "string",
4679
+ "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
4680
+ },
4681
+ "out": {
4682
+ "type": "string",
4683
+ "minLength": 1
4684
+ },
4685
+ "options": {
4686
+ "type": "object",
4687
+ "propertyNames": {
4688
+ "type": "string"
4689
+ },
4690
+ "additionalProperties": {}
4691
+ }
4692
+ },
4693
+ "required": [
4694
+ "artifact",
4695
+ "exporter",
4696
+ "out"
4697
+ ]
4698
+ },
4699
+ "PluginExportResult": {
4700
+ "type": "object",
4701
+ "properties": {
4702
+ "files": {
4703
+ "readOnly": true,
4704
+ "type": "array",
4705
+ "items": {
4706
+ "type": "string"
4707
+ }
4708
+ },
4709
+ "entry": {
4710
+ "type": "string"
4711
+ },
4712
+ "versionId": {
4713
+ "type": "string"
4714
+ },
4715
+ "exporter": {
4716
+ "type": "object",
4717
+ "properties": {
4718
+ "id": {
4719
+ "type": "string"
4720
+ },
4721
+ "package": {
4722
+ "type": "string"
4723
+ }
4724
+ },
4725
+ "required": [
4726
+ "id",
4727
+ "package"
4728
+ ]
4729
+ },
4730
+ "findings": {
4731
+ "readOnly": true,
4732
+ "type": "array",
4733
+ "items": {
4734
+ "$ref": "#/$defs/PluginFinding"
4735
+ }
4736
+ }
4737
+ },
4738
+ "required": [
4739
+ "files",
4740
+ "versionId",
4741
+ "exporter",
4742
+ "findings"
4743
+ ]
4744
+ },
4745
+ "PluginFinding": {
4746
+ "type": "object",
4747
+ "properties": {
4748
+ "code": {
4749
+ "type": "string",
4750
+ "minLength": 1,
4751
+ "maxLength": 64
4752
+ },
4753
+ "severity": {
4754
+ "type": "string",
4755
+ "enum": [
4756
+ "error",
4757
+ "warning",
4758
+ "hint"
4759
+ ]
4760
+ },
4761
+ "message": {
4762
+ "type": "string"
4763
+ },
4764
+ "hint": {
4765
+ "type": "string"
4766
+ },
4767
+ "location": {
4768
+ "type": "object",
4769
+ "properties": {
4770
+ "file": {
4771
+ "type": "string"
4772
+ },
4773
+ "line": {
4774
+ "type": "integer",
4775
+ "minimum": 1,
4776
+ "maximum": 9007199254740991
4777
+ },
4778
+ "column": {
4779
+ "type": "integer",
4780
+ "minimum": 1,
4781
+ "maximum": 9007199254740991
4782
+ }
4783
+ },
4784
+ "required": [
4785
+ "file"
4786
+ ]
4787
+ }
4788
+ },
4789
+ "required": [
4790
+ "code",
4791
+ "severity",
4792
+ "message"
4793
+ ],
4794
+ "description": "Something a plugin's contribution reported, in the plugin's own code."
4795
+ },
4796
+ "PluginListParams": {
4797
+ "type": "object",
4798
+ "properties": {
4799
+ "artifact": {
4800
+ "$ref": "#/$defs/SourceRef"
4801
+ },
4802
+ "home": {
4803
+ "type": "boolean"
4804
+ }
4805
+ }
4806
+ },
4807
+ "PluginListResult": {
4808
+ "type": "object",
4809
+ "properties": {
4810
+ "plugins": {
4811
+ "readOnly": true,
4812
+ "type": "array",
4813
+ "items": {
4814
+ "$ref": "#/$defs/PluginSummary"
4815
+ }
4816
+ },
4817
+ "licenses": {
4818
+ "readOnly": true,
4819
+ "type": "array",
4820
+ "items": {
4821
+ "$ref": "#/$defs/LicenseDisclosure"
4822
+ }
4823
+ }
4824
+ },
4825
+ "required": [
4826
+ "plugins",
4827
+ "licenses"
4828
+ ]
4829
+ },
4830
+ "PluginRemoveParams": {
4831
+ "type": "object",
4832
+ "properties": {
4833
+ "artifact": {
4834
+ "$ref": "#/$defs/SourceRef"
4835
+ },
4836
+ "home": {
4837
+ "type": "boolean"
4838
+ },
4839
+ "packages": {
4840
+ "readOnly": true,
4841
+ "minItems": 1,
4842
+ "type": "array",
4843
+ "items": {
4844
+ "type": "string",
4845
+ "minLength": 1
4846
+ }
4847
+ },
4848
+ "requestId": {
4849
+ "type": "string",
4850
+ "minLength": 1
4851
+ }
4852
+ },
4853
+ "required": [
4854
+ "packages"
4855
+ ]
4856
+ },
4857
+ "PluginRemoveResult": {
4858
+ "type": "object",
4859
+ "properties": {
4860
+ "removed": {
4861
+ "readOnly": true,
4862
+ "type": "array",
4863
+ "items": {
4864
+ "type": "string"
4865
+ }
4866
+ },
4867
+ "plugins": {
4868
+ "readOnly": true,
4869
+ "type": "array",
4870
+ "items": {
4871
+ "$ref": "#/$defs/PluginSummary"
4872
+ }
4873
+ },
4874
+ "lockDigest": {
4875
+ "type": "string",
4876
+ "pattern": "^[0-9a-f]{64}$"
4877
+ }
4878
+ },
4879
+ "required": [
4880
+ "removed",
4881
+ "plugins",
4882
+ "lockDigest"
4883
+ ]
4884
+ },
4885
+ "PluginScope": {
4886
+ "type": "string",
4887
+ "enum": [
4888
+ "artifact",
4889
+ "home"
4890
+ ],
4891
+ "description": "Where a plugin is installed: one artifact, or the whole home (exporters and CLI commands)."
4892
+ },
4893
+ "PluginSummary": {
4894
+ "type": "object",
4895
+ "properties": {
4896
+ "package": {
4897
+ "type": "string",
4898
+ "minLength": 1
4899
+ },
4900
+ "version": {
4901
+ "type": "string",
4902
+ "minLength": 1
4903
+ },
4904
+ "name": {
4905
+ "type": "string",
4906
+ "minLength": 1
4907
+ },
4908
+ "title": {
4909
+ "type": "string"
4910
+ },
4911
+ "description": {
4912
+ "type": "string"
4913
+ },
4914
+ "scope": {
4915
+ "$ref": "#/$defs/PluginScope"
4916
+ },
4917
+ "contracts": {
4918
+ "type": "object",
4919
+ "propertyNames": {
4920
+ "type": "string"
4921
+ },
4922
+ "additionalProperties": {
4923
+ "type": "string"
4924
+ }
4925
+ },
4926
+ "contributions": {
4927
+ "readOnly": true,
4928
+ "type": "array",
4929
+ "items": {
4930
+ "$ref": "#/$defs/PluginContribution"
4931
+ }
4932
+ },
4933
+ "packs": {
4934
+ "readOnly": true,
4935
+ "type": "array",
4936
+ "items": {
4937
+ "type": "string"
4938
+ }
4939
+ },
4940
+ "effects": {
4941
+ "readOnly": true,
4942
+ "type": "array",
4943
+ "items": {
4944
+ "type": "string"
4945
+ }
4946
+ },
4947
+ "license": {
4948
+ "type": "string"
4949
+ },
4950
+ "platforms": {
4951
+ "readOnly": true,
4952
+ "type": "array",
4953
+ "items": {
4954
+ "type": "string"
4955
+ }
4956
+ },
4957
+ "status": {
4958
+ "type": "string",
4959
+ "enum": [
4960
+ "ok",
4961
+ "error"
4962
+ ]
4963
+ },
4964
+ "diagnostics": {
4965
+ "readOnly": true,
4966
+ "type": "array",
4967
+ "items": {
4968
+ "$ref": "#/$defs/Diagnostic"
4969
+ }
4970
+ }
4971
+ },
4972
+ "required": [
4973
+ "package",
4974
+ "version",
4975
+ "name",
4976
+ "scope",
4977
+ "contracts",
4978
+ "contributions",
4979
+ "packs",
4980
+ "effects",
4981
+ "license",
4982
+ "status",
4983
+ "diagnostics"
4984
+ ],
4985
+ "description": "A plugin as plugin/* reports it: its package, manifest, scope, contributions, licenses and whether it loads (D30)."
4986
+ },
4987
+ "PluginValidateParams": {
4988
+ "type": "object",
4989
+ "properties": {
4990
+ "path": {
4991
+ "type": "string",
4992
+ "pattern": "^(?:\\/|[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\])"
4993
+ },
4994
+ "acceptLicenses": {
4995
+ "readOnly": true,
4996
+ "type": "array",
4997
+ "items": {
4998
+ "type": "string",
4999
+ "minLength": 1,
5000
+ "maxLength": 256
5001
+ }
5002
+ }
5003
+ },
5004
+ "required": [
5005
+ "path"
5006
+ ]
5007
+ },
5008
+ "PluginValidateResult": {
5009
+ "type": "object",
5010
+ "properties": {
5011
+ "valid": {
5012
+ "type": "boolean"
5013
+ },
5014
+ "plugin": {
5015
+ "$ref": "#/$defs/PluginSummary"
5016
+ },
5017
+ "diagnostics": {
5018
+ "readOnly": true,
5019
+ "type": "array",
5020
+ "items": {
5021
+ "$ref": "#/$defs/Diagnostic"
5022
+ }
5023
+ }
5024
+ },
5025
+ "required": [
5026
+ "valid",
5027
+ "diagnostics"
5028
+ ]
5029
+ },
4156
5030
  "PollResult": {
4157
5031
  "type": "object",
4158
5032
  "properties": {