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