@topline-build/harness-mcp 0.6.0 → 0.7.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.
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "@topline-build/harness-mcp",
5
- "version": "0.6.0",
5
+ "version": "0.7.0",
6
6
  "bin": {
7
7
  "topline-mcp": "dist/cli.js"
8
8
  }
@@ -12,7 +12,7 @@
12
12
  "defaultVersion": "2025-11-25",
13
13
  "server": {
14
14
  "name": "topline-build-stdio",
15
- "version": "0.6.0"
15
+ "version": "0.7.0"
16
16
  }
17
17
  },
18
18
  "generatedFrom": {
@@ -171,11 +171,171 @@
171
171
  "recoveryAction": "Inspect the code and message, correct the input if needed, then retry the same tool."
172
172
  },
173
173
  "catalog": [
174
+ {
175
+ "code": "capability_unavailable",
176
+ "retryable": false,
177
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
178
+ },
179
+ {
180
+ "code": "domain_manage_required",
181
+ "retryable": false,
182
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
183
+ },
184
+ {
185
+ "code": "artifact_not_found",
186
+ "retryable": false,
187
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
188
+ },
189
+ {
190
+ "code": "artifact_app_required",
191
+ "retryable": false,
192
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
193
+ },
194
+ {
195
+ "code": "domain_not_found",
196
+ "retryable": false,
197
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
198
+ },
199
+ {
200
+ "code": "domain_not_connected",
201
+ "retryable": false,
202
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
203
+ },
204
+ {
205
+ "code": "operation_not_found",
206
+ "retryable": false,
207
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
208
+ },
209
+ {
210
+ "code": "hostname_required",
211
+ "retryable": false,
212
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
213
+ },
214
+ {
215
+ "code": "hostname_invalid",
216
+ "retryable": false,
217
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
218
+ },
219
+ {
220
+ "code": "subdomain_required",
221
+ "retryable": false,
222
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
223
+ },
224
+ {
225
+ "code": "topline_domain_not_customer_domain",
226
+ "retryable": false,
227
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
228
+ },
229
+ {
230
+ "code": "path_required",
231
+ "retryable": false,
232
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
233
+ },
234
+ {
235
+ "code": "path_invalid",
236
+ "retryable": false,
237
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
238
+ },
239
+ {
240
+ "code": "path_reserved",
241
+ "retryable": false,
242
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
243
+ },
244
+ {
245
+ "code": "zone_invalid",
246
+ "retryable": false,
247
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
248
+ },
249
+ {
250
+ "code": "domain_path_in_use",
251
+ "retryable": false,
252
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
253
+ },
254
+ {
255
+ "code": "domain_already_claimed",
256
+ "retryable": false,
257
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
258
+ },
259
+ {
260
+ "code": "address_state_changed",
261
+ "retryable": false,
262
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
263
+ },
264
+ {
265
+ "code": "domain_state_changed",
266
+ "retryable": false,
267
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
268
+ },
269
+ {
270
+ "code": "plan_expired",
271
+ "retryable": false,
272
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
273
+ },
274
+ {
275
+ "code": "plan_already_used",
276
+ "retryable": false,
277
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
278
+ },
279
+ {
280
+ "code": "verification_interrupted",
281
+ "retryable": false,
282
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
283
+ },
284
+ {
285
+ "code": "verification_pending",
286
+ "retryable": false,
287
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
288
+ },
289
+ {
290
+ "code": "verification_rate_limited",
291
+ "retryable": false,
292
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
293
+ },
294
+ {
295
+ "code": "waiting_for_dns",
296
+ "retryable": false,
297
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
298
+ },
299
+ {
300
+ "code": "idempotency_conflict",
301
+ "retryable": false,
302
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
303
+ },
304
+ {
305
+ "code": "domain_setup_limit",
306
+ "retryable": false,
307
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
308
+ },
309
+ {
310
+ "code": "domain_operation_failed",
311
+ "retryable": false,
312
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
313
+ },
314
+ {
315
+ "code": "invalid_arguments",
316
+ "retryable": false,
317
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
318
+ },
174
319
  {
175
320
  "code": "authorization_required",
176
321
  "retryable": false,
177
322
  "recoveryAction": "Clear only this connection's cached OAuth credentials, then reconnect the Build MCP through browser sign-in. If using a manual bearer token, replace the expired or revoked token. Recover existing artifact/deployment progress before retrying a write."
178
323
  },
324
+ {
325
+ "code": "scope_required",
326
+ "retryable": false,
327
+ "recoveryAction": "Reconnect the Build MCP and approve the requested scope."
328
+ },
329
+ {
330
+ "code": "domain_tools_require_build_oauth",
331
+ "retryable": false,
332
+ "recoveryAction": "Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect."
333
+ },
334
+ {
335
+ "code": "domain_result_unknown",
336
+ "retryable": false,
337
+ "recoveryAction": "The response did not establish an outcome. Recover the original receipt through platform_get_artifact_address (saved artifactId and apply key) or platform_read_artifact_domains (request/verify kind and key). Preserve the original plan/domain/input/key; an absent, pending or expired receipt does not authorize a fresh key. No mutation is replayed automatically."
338
+ },
179
339
  {
180
340
  "code": "platform_harness_timeout",
181
341
  "retryable": true,
@@ -221,11 +381,6 @@
221
381
  "retryable": false,
222
382
  "recoveryAction": "Keep artifact-app.json below 512 KiB. Move application data and source into separate files, then inspect again."
223
383
  },
224
- {
225
- "code": "scope_required",
226
- "retryable": false,
227
- "recoveryAction": "Reconnect the Build MCP and approve the requested scope."
228
- },
229
384
  {
230
385
  "code": "artifact_app_scaffold_target_not_empty",
231
386
  "retryable": false,
@@ -4361,6 +4516,763 @@
4361
4516
  "success": {}
4362
4517
  }
4363
4518
  ]
4519
+ },
4520
+ {
4521
+ "name": "platform_read_artifact_domains",
4522
+ "description": "Read connected company domains. With domainId, an explicitly scoped manager can read DNS/TLS setup state. With recovery, recover an original request/verify receipt by operation ID or its pre-call key; reads never retry setup or write DNS. Manager detail/recovery requires the setup capability.",
4523
+ "annotations": {
4524
+ "title": "Platform Read Artifact Domains",
4525
+ "readOnlyHint": true,
4526
+ "destructiveHint": false,
4527
+ "idempotentHint": true,
4528
+ "openWorldHint": false
4529
+ },
4530
+ "inputSchema": {
4531
+ "type": "object",
4532
+ "additionalProperties": false,
4533
+ "properties": {
4534
+ "limit": {
4535
+ "type": "integer",
4536
+ "minimum": 1,
4537
+ "maximum": 100
4538
+ },
4539
+ "cursor": {
4540
+ "type": "integer",
4541
+ "minimum": 0,
4542
+ "maximum": 10000
4543
+ },
4544
+ "includePending": {
4545
+ "type": "boolean"
4546
+ },
4547
+ "domainId": {
4548
+ "type": "string",
4549
+ "format": "uuid"
4550
+ },
4551
+ "zoneName": {
4552
+ "type": "string",
4553
+ "minLength": 1,
4554
+ "maxLength": 253
4555
+ },
4556
+ "recovery": {
4557
+ "oneOf": [
4558
+ {
4559
+ "type": "object",
4560
+ "additionalProperties": false,
4561
+ "properties": {
4562
+ "operationId": {
4563
+ "type": "string",
4564
+ "format": "uuid"
4565
+ }
4566
+ },
4567
+ "required": [
4568
+ "operationId"
4569
+ ]
4570
+ },
4571
+ {
4572
+ "type": "object",
4573
+ "additionalProperties": false,
4574
+ "properties": {
4575
+ "kind": {
4576
+ "enum": [
4577
+ "request",
4578
+ "verify"
4579
+ ]
4580
+ },
4581
+ "idempotencyKey": {
4582
+ "type": "string",
4583
+ "minLength": 1,
4584
+ "maxLength": 128,
4585
+ "pattern": "^[\\x21-\\x7E]+$"
4586
+ }
4587
+ },
4588
+ "required": [
4589
+ "kind",
4590
+ "idempotencyKey"
4591
+ ]
4592
+ }
4593
+ ]
4594
+ }
4595
+ },
4596
+ "required": [],
4597
+ "oneOf": [
4598
+ {
4599
+ "not": {
4600
+ "anyOf": [
4601
+ {
4602
+ "required": [
4603
+ "domainId"
4604
+ ]
4605
+ },
4606
+ {
4607
+ "required": [
4608
+ "recovery"
4609
+ ]
4610
+ },
4611
+ {
4612
+ "required": [
4613
+ "zoneName"
4614
+ ]
4615
+ }
4616
+ ]
4617
+ }
4618
+ },
4619
+ {
4620
+ "required": [
4621
+ "domainId"
4622
+ ],
4623
+ "not": {
4624
+ "anyOf": [
4625
+ {
4626
+ "required": [
4627
+ "limit"
4628
+ ]
4629
+ },
4630
+ {
4631
+ "required": [
4632
+ "cursor"
4633
+ ]
4634
+ },
4635
+ {
4636
+ "required": [
4637
+ "includePending"
4638
+ ]
4639
+ },
4640
+ {
4641
+ "required": [
4642
+ "recovery"
4643
+ ]
4644
+ }
4645
+ ]
4646
+ }
4647
+ },
4648
+ {
4649
+ "required": [
4650
+ "recovery"
4651
+ ],
4652
+ "not": {
4653
+ "anyOf": [
4654
+ {
4655
+ "required": [
4656
+ "domainId"
4657
+ ]
4658
+ },
4659
+ {
4660
+ "required": [
4661
+ "zoneName"
4662
+ ]
4663
+ },
4664
+ {
4665
+ "required": [
4666
+ "cursor"
4667
+ ]
4668
+ },
4669
+ {
4670
+ "required": [
4671
+ "limit"
4672
+ ]
4673
+ },
4674
+ {
4675
+ "required": [
4676
+ "includePending"
4677
+ ]
4678
+ }
4679
+ ]
4680
+ }
4681
+ }
4682
+ ]
4683
+ },
4684
+ "outputSchema": {
4685
+ "type": "object",
4686
+ "oneOf": [
4687
+ {
4688
+ "type": "object",
4689
+ "properties": {
4690
+ "ok": {
4691
+ "const": true
4692
+ }
4693
+ }
4694
+ },
4695
+ {
4696
+ "type": "object",
4697
+ "properties": {
4698
+ "ok": {
4699
+ "const": false
4700
+ },
4701
+ "error": {
4702
+ "type": "object",
4703
+ "properties": {
4704
+ "code": {
4705
+ "type": "string"
4706
+ },
4707
+ "message": {
4708
+ "type": "string"
4709
+ },
4710
+ "retryable": {
4711
+ "type": "boolean"
4712
+ },
4713
+ "recoveryAction": {
4714
+ "type": "string"
4715
+ },
4716
+ "recovery": {
4717
+ "type": "object",
4718
+ "additionalProperties": true
4719
+ }
4720
+ },
4721
+ "required": [
4722
+ "code",
4723
+ "message",
4724
+ "retryable",
4725
+ "recoveryAction"
4726
+ ],
4727
+ "additionalProperties": false
4728
+ }
4729
+ },
4730
+ "required": [
4731
+ "ok",
4732
+ "error"
4733
+ ],
4734
+ "additionalProperties": false
4735
+ }
4736
+ ]
4737
+ },
4738
+ "examples": [
4739
+ {
4740
+ "request": {},
4741
+ "success": {}
4742
+ }
4743
+ ]
4744
+ },
4745
+ {
4746
+ "name": "platform_get_artifact_address",
4747
+ "description": "Read an owned hosted app's exact company address, revision, connection and publication state. Optional recovery returns the original address-apply receipt under its current write scopes; it does not reapply. Saving an address never publishes an app or changes audience.",
4748
+ "annotations": {
4749
+ "title": "Platform Get Artifact Address",
4750
+ "readOnlyHint": true,
4751
+ "destructiveHint": false,
4752
+ "idempotentHint": true,
4753
+ "openWorldHint": false
4754
+ },
4755
+ "inputSchema": {
4756
+ "type": "object",
4757
+ "additionalProperties": false,
4758
+ "properties": {
4759
+ "artifactId": {
4760
+ "type": "string",
4761
+ "format": "uuid"
4762
+ },
4763
+ "recovery": {
4764
+ "oneOf": [
4765
+ {
4766
+ "type": "object",
4767
+ "additionalProperties": false,
4768
+ "properties": {
4769
+ "operationId": {
4770
+ "type": "string",
4771
+ "format": "uuid"
4772
+ }
4773
+ },
4774
+ "required": [
4775
+ "operationId"
4776
+ ]
4777
+ },
4778
+ {
4779
+ "type": "object",
4780
+ "additionalProperties": false,
4781
+ "properties": {
4782
+ "idempotencyKey": {
4783
+ "type": "string",
4784
+ "minLength": 1,
4785
+ "maxLength": 128,
4786
+ "pattern": "^[\\x21-\\x7E]+$"
4787
+ }
4788
+ },
4789
+ "required": [
4790
+ "idempotencyKey"
4791
+ ]
4792
+ }
4793
+ ]
4794
+ }
4795
+ },
4796
+ "required": [
4797
+ "artifactId"
4798
+ ]
4799
+ },
4800
+ "outputSchema": {
4801
+ "type": "object",
4802
+ "oneOf": [
4803
+ {
4804
+ "type": "object",
4805
+ "properties": {
4806
+ "ok": {
4807
+ "const": true
4808
+ }
4809
+ }
4810
+ },
4811
+ {
4812
+ "type": "object",
4813
+ "properties": {
4814
+ "ok": {
4815
+ "const": false
4816
+ },
4817
+ "error": {
4818
+ "type": "object",
4819
+ "properties": {
4820
+ "code": {
4821
+ "type": "string"
4822
+ },
4823
+ "message": {
4824
+ "type": "string"
4825
+ },
4826
+ "retryable": {
4827
+ "type": "boolean"
4828
+ },
4829
+ "recoveryAction": {
4830
+ "type": "string"
4831
+ },
4832
+ "recovery": {
4833
+ "type": "object",
4834
+ "additionalProperties": true
4835
+ }
4836
+ },
4837
+ "required": [
4838
+ "code",
4839
+ "message",
4840
+ "retryable",
4841
+ "recoveryAction"
4842
+ ],
4843
+ "additionalProperties": false
4844
+ }
4845
+ },
4846
+ "required": [
4847
+ "ok",
4848
+ "error"
4849
+ ],
4850
+ "additionalProperties": false
4851
+ }
4852
+ ]
4853
+ },
4854
+ "examples": [
4855
+ {
4856
+ "request": {
4857
+ "artifactId": "00000000-0000-4000-8000-000000000001"
4858
+ },
4859
+ "success": {}
4860
+ }
4861
+ ]
4862
+ },
4863
+ {
4864
+ "name": "platform_plan_artifact_address",
4865
+ "description": "Store a ten-minute single-use address preview for the owned app. domainId=null explicitly detaches the company route. Show old/new URLs and readiness before applying; this changes no customer address or DNS.",
4866
+ "annotations": {
4867
+ "title": "Platform Plan Artifact Address",
4868
+ "readOnlyHint": false,
4869
+ "destructiveHint": false,
4870
+ "openWorldHint": false
4871
+ },
4872
+ "inputSchema": {
4873
+ "type": "object",
4874
+ "additionalProperties": false,
4875
+ "properties": {
4876
+ "artifactId": {
4877
+ "type": "string",
4878
+ "format": "uuid"
4879
+ },
4880
+ "domainId": {
4881
+ "type": [
4882
+ "string",
4883
+ "null"
4884
+ ],
4885
+ "format": "uuid"
4886
+ },
4887
+ "path": {
4888
+ "type": "string",
4889
+ "minLength": 1,
4890
+ "maxLength": 70
4891
+ }
4892
+ },
4893
+ "required": [
4894
+ "artifactId",
4895
+ "domainId"
4896
+ ],
4897
+ "oneOf": [
4898
+ {
4899
+ "properties": {
4900
+ "domainId": {
4901
+ "type": "string",
4902
+ "format": "uuid"
4903
+ }
4904
+ },
4905
+ "required": [
4906
+ "path"
4907
+ ]
4908
+ },
4909
+ {
4910
+ "properties": {
4911
+ "domainId": {
4912
+ "type": "null"
4913
+ }
4914
+ },
4915
+ "not": {
4916
+ "required": [
4917
+ "path"
4918
+ ]
4919
+ }
4920
+ }
4921
+ ]
4922
+ },
4923
+ "outputSchema": {
4924
+ "type": "object",
4925
+ "oneOf": [
4926
+ {
4927
+ "type": "object",
4928
+ "properties": {
4929
+ "ok": {
4930
+ "const": true
4931
+ }
4932
+ }
4933
+ },
4934
+ {
4935
+ "type": "object",
4936
+ "properties": {
4937
+ "ok": {
4938
+ "const": false
4939
+ },
4940
+ "error": {
4941
+ "type": "object",
4942
+ "properties": {
4943
+ "code": {
4944
+ "type": "string"
4945
+ },
4946
+ "message": {
4947
+ "type": "string"
4948
+ },
4949
+ "retryable": {
4950
+ "type": "boolean"
4951
+ },
4952
+ "recoveryAction": {
4953
+ "type": "string"
4954
+ },
4955
+ "recovery": {
4956
+ "type": "object",
4957
+ "additionalProperties": true
4958
+ }
4959
+ },
4960
+ "required": [
4961
+ "code",
4962
+ "message",
4963
+ "retryable",
4964
+ "recoveryAction"
4965
+ ],
4966
+ "additionalProperties": false
4967
+ }
4968
+ },
4969
+ "required": [
4970
+ "ok",
4971
+ "error"
4972
+ ],
4973
+ "additionalProperties": false
4974
+ }
4975
+ ]
4976
+ },
4977
+ "examples": [
4978
+ {
4979
+ "request": {
4980
+ "artifactId": "00000000-0000-4000-8000-000000000001",
4981
+ "domainId": "00000000-0000-4000-8000-000000000001",
4982
+ "path": "<path>"
4983
+ },
4984
+ "success": {}
4985
+ }
4986
+ ]
4987
+ },
4988
+ {
4989
+ "name": "platform_apply_artifact_address",
4990
+ "description": "Apply the exact owned address plan with a stable pre-call key. Rechecks authority and address/domain revisions; consumes the plan once, including a no-op. Recover a lost response through the address-read tool before a new effect. No promotion, audience or DNS write.",
4991
+ "annotations": {
4992
+ "title": "Platform Apply Artifact Address",
4993
+ "readOnlyHint": false,
4994
+ "destructiveHint": true,
4995
+ "idempotentHint": true,
4996
+ "openWorldHint": false
4997
+ },
4998
+ "inputSchema": {
4999
+ "type": "object",
5000
+ "additionalProperties": false,
5001
+ "properties": {
5002
+ "planId": {
5003
+ "type": "string",
5004
+ "format": "uuid"
5005
+ },
5006
+ "idempotencyKey": {
5007
+ "type": "string",
5008
+ "minLength": 1,
5009
+ "maxLength": 128,
5010
+ "pattern": "^[\\x21-\\x7E]+$"
5011
+ }
5012
+ },
5013
+ "required": [
5014
+ "planId",
5015
+ "idempotencyKey"
5016
+ ]
5017
+ },
5018
+ "outputSchema": {
5019
+ "type": "object",
5020
+ "oneOf": [
5021
+ {
5022
+ "type": "object",
5023
+ "properties": {
5024
+ "ok": {
5025
+ "const": true
5026
+ }
5027
+ }
5028
+ },
5029
+ {
5030
+ "type": "object",
5031
+ "properties": {
5032
+ "ok": {
5033
+ "const": false
5034
+ },
5035
+ "error": {
5036
+ "type": "object",
5037
+ "properties": {
5038
+ "code": {
5039
+ "type": "string"
5040
+ },
5041
+ "message": {
5042
+ "type": "string"
5043
+ },
5044
+ "retryable": {
5045
+ "type": "boolean"
5046
+ },
5047
+ "recoveryAction": {
5048
+ "type": "string"
5049
+ },
5050
+ "recovery": {
5051
+ "type": "object",
5052
+ "additionalProperties": true
5053
+ }
5054
+ },
5055
+ "required": [
5056
+ "code",
5057
+ "message",
5058
+ "retryable",
5059
+ "recoveryAction"
5060
+ ],
5061
+ "additionalProperties": false
5062
+ }
5063
+ },
5064
+ "required": [
5065
+ "ok",
5066
+ "error"
5067
+ ],
5068
+ "additionalProperties": false
5069
+ }
5070
+ ]
5071
+ },
5072
+ "examples": [
5073
+ {
5074
+ "request": {
5075
+ "planId": "00000000-0000-4000-8000-000000000001",
5076
+ "idempotencyKey": "example-request"
5077
+ },
5078
+ "success": {}
5079
+ }
5080
+ ]
5081
+ },
5082
+ {
5083
+ "name": "platform_request_artifact_domain",
5084
+ "description": "Manager-only request for an owned company subdomain. Save the key before calling. Returns exact ownership/routing DNS records; never writes customer DNS. The existing reconciler may make the first connected domain the initial default. No artifact is reassigned.",
5085
+ "annotations": {
5086
+ "title": "Platform Request Artifact Domain",
5087
+ "readOnlyHint": false,
5088
+ "destructiveHint": false,
5089
+ "idempotentHint": true,
5090
+ "openWorldHint": false
5091
+ },
5092
+ "inputSchema": {
5093
+ "type": "object",
5094
+ "additionalProperties": false,
5095
+ "properties": {
5096
+ "hostname": {
5097
+ "type": "string",
5098
+ "minLength": 1,
5099
+ "maxLength": 253
5100
+ },
5101
+ "idempotencyKey": {
5102
+ "type": "string",
5103
+ "minLength": 1,
5104
+ "maxLength": 128,
5105
+ "pattern": "^[\\x21-\\x7E]+$"
5106
+ }
5107
+ },
5108
+ "required": [
5109
+ "hostname",
5110
+ "idempotencyKey"
5111
+ ]
5112
+ },
5113
+ "outputSchema": {
5114
+ "type": "object",
5115
+ "oneOf": [
5116
+ {
5117
+ "type": "object",
5118
+ "properties": {
5119
+ "ok": {
5120
+ "const": true
5121
+ }
5122
+ }
5123
+ },
5124
+ {
5125
+ "type": "object",
5126
+ "properties": {
5127
+ "ok": {
5128
+ "const": false
5129
+ },
5130
+ "error": {
5131
+ "type": "object",
5132
+ "properties": {
5133
+ "code": {
5134
+ "type": "string"
5135
+ },
5136
+ "message": {
5137
+ "type": "string"
5138
+ },
5139
+ "retryable": {
5140
+ "type": "boolean"
5141
+ },
5142
+ "recoveryAction": {
5143
+ "type": "string"
5144
+ },
5145
+ "recovery": {
5146
+ "type": "object",
5147
+ "additionalProperties": true
5148
+ }
5149
+ },
5150
+ "required": [
5151
+ "code",
5152
+ "message",
5153
+ "retryable",
5154
+ "recoveryAction"
5155
+ ],
5156
+ "additionalProperties": false
5157
+ }
5158
+ },
5159
+ "required": [
5160
+ "ok",
5161
+ "error"
5162
+ ],
5163
+ "additionalProperties": false
5164
+ }
5165
+ ]
5166
+ },
5167
+ "examples": [
5168
+ {
5169
+ "request": {
5170
+ "hostname": "<hostname>",
5171
+ "idempotencyKey": "example-request"
5172
+ },
5173
+ "success": {}
5174
+ }
5175
+ ]
5176
+ },
5177
+ {
5178
+ "name": "platform_verify_artifact_domain",
5179
+ "description": "Manager-only bounded ownership verification for the exact current domain generation and pre-call key. Matching DNS admits the existing TLS reconciler once. Same keys retain outcomes; use a new key only after a definite terminal no-admission outcome and covered retry intent. Read status through domain reads.",
5180
+ "annotations": {
5181
+ "title": "Platform Verify Artifact Domain",
5182
+ "readOnlyHint": false,
5183
+ "destructiveHint": false,
5184
+ "idempotentHint": true,
5185
+ "openWorldHint": true
5186
+ },
5187
+ "inputSchema": {
5188
+ "type": "object",
5189
+ "additionalProperties": false,
5190
+ "properties": {
5191
+ "domainId": {
5192
+ "type": "string",
5193
+ "format": "uuid"
5194
+ },
5195
+ "expectedConnectionGeneration": {
5196
+ "type": "integer",
5197
+ "minimum": 0
5198
+ },
5199
+ "idempotencyKey": {
5200
+ "type": "string",
5201
+ "minLength": 1,
5202
+ "maxLength": 128,
5203
+ "pattern": "^[\\x21-\\x7E]+$"
5204
+ }
5205
+ },
5206
+ "required": [
5207
+ "domainId",
5208
+ "expectedConnectionGeneration",
5209
+ "idempotencyKey"
5210
+ ]
5211
+ },
5212
+ "outputSchema": {
5213
+ "type": "object",
5214
+ "oneOf": [
5215
+ {
5216
+ "type": "object",
5217
+ "properties": {
5218
+ "ok": {
5219
+ "const": true
5220
+ }
5221
+ }
5222
+ },
5223
+ {
5224
+ "type": "object",
5225
+ "properties": {
5226
+ "ok": {
5227
+ "const": false
5228
+ },
5229
+ "error": {
5230
+ "type": "object",
5231
+ "properties": {
5232
+ "code": {
5233
+ "type": "string"
5234
+ },
5235
+ "message": {
5236
+ "type": "string"
5237
+ },
5238
+ "retryable": {
5239
+ "type": "boolean"
5240
+ },
5241
+ "recoveryAction": {
5242
+ "type": "string"
5243
+ },
5244
+ "recovery": {
5245
+ "type": "object",
5246
+ "additionalProperties": true
5247
+ }
5248
+ },
5249
+ "required": [
5250
+ "code",
5251
+ "message",
5252
+ "retryable",
5253
+ "recoveryAction"
5254
+ ],
5255
+ "additionalProperties": false
5256
+ }
5257
+ },
5258
+ "required": [
5259
+ "ok",
5260
+ "error"
5261
+ ],
5262
+ "additionalProperties": false
5263
+ }
5264
+ ]
5265
+ },
5266
+ "examples": [
5267
+ {
5268
+ "request": {
5269
+ "domainId": "00000000-0000-4000-8000-000000000001",
5270
+ "expectedConnectionGeneration": 0,
5271
+ "idempotencyKey": "example-request"
5272
+ },
5273
+ "success": {}
5274
+ }
5275
+ ]
4364
5276
  }
4365
5277
  ]
4366
5278
  }