@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
 
3
3
  > Generated from `src/index.ts#BUILD_MCP_TOOLS`. Do not edit this file by hand.
4
4
 
5
- Package: `@topline-build/harness-mcp@0.6.0`
5
+ Package: `@topline-build/harness-mcp@0.7.0`
6
6
  Transport: `stdio`
7
7
  Default protocol: `2025-11-25`
8
8
  Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -32,7 +32,39 @@ The first authenticated tool call normally opens browser approval. Set `TOPLINE_
32
32
 
33
33
  Tool failures set `isError: true` and return `structuredContent.error` with `code`, `message`, `retryable`, and `recoveryAction`.
34
34
 
35
+ - `capability_unavailable` (not automatically retryable): 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.
36
+ - `domain_manage_required` (not automatically retryable): 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.
37
+ - `artifact_not_found` (not automatically retryable): 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.
38
+ - `artifact_app_required` (not automatically retryable): 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.
39
+ - `domain_not_found` (not automatically retryable): 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.
40
+ - `domain_not_connected` (not automatically retryable): 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.
41
+ - `operation_not_found` (not automatically retryable): 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.
42
+ - `hostname_required` (not automatically retryable): 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.
43
+ - `hostname_invalid` (not automatically retryable): 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.
44
+ - `subdomain_required` (not automatically retryable): 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.
45
+ - `topline_domain_not_customer_domain` (not automatically retryable): 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.
46
+ - `path_required` (not automatically retryable): 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.
47
+ - `path_invalid` (not automatically retryable): 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.
48
+ - `path_reserved` (not automatically retryable): 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.
49
+ - `zone_invalid` (not automatically retryable): 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.
50
+ - `domain_path_in_use` (not automatically retryable): 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.
51
+ - `domain_already_claimed` (not automatically retryable): 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.
52
+ - `address_state_changed` (not automatically retryable): 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.
53
+ - `domain_state_changed` (not automatically retryable): 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.
54
+ - `plan_expired` (not automatically retryable): 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.
55
+ - `plan_already_used` (not automatically retryable): 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.
56
+ - `verification_interrupted` (not automatically retryable): 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.
57
+ - `verification_pending` (not automatically retryable): 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.
58
+ - `verification_rate_limited` (not automatically retryable): 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.
59
+ - `waiting_for_dns` (not automatically retryable): 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.
60
+ - `idempotency_conflict` (not automatically retryable): 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.
61
+ - `domain_setup_limit` (not automatically retryable): 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.
62
+ - `domain_operation_failed` (not automatically retryable): 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.
63
+ - `invalid_arguments` (not automatically retryable): 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.
35
64
  - `authorization_required` (not automatically retryable): 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.
65
+ - `scope_required` (not automatically retryable): Reconnect the Build MCP and approve the requested scope.
66
+ - `domain_tools_require_build_oauth` (not automatically retryable): 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.
67
+ - `domain_result_unknown` (not automatically retryable): 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.
36
68
  - `platform_harness_timeout` (retryable): Retry the call. For a deployment, use platform_list_artifact_drafts to recover the artifact and platform_wait_artifact_deploy to resume progress.
37
69
  - `platform_mcp_tool_error` (not automatically retryable): Read the returned error code, correct the request or OAuth scopes, then retry.
38
70
  - `artifact_deploy_wait_timeout` (retryable): Call platform_wait_artifact_deploy again with the same artifactId and operationId.
@@ -42,7 +74,6 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
42
74
  - `artifact_app_auth_file_inside_app_dir` (not automatically retryable): Move TOPLINE_MCP_AUTH_FILE outside appDir, reconnect the Build MCP, then inspect again.
43
75
  - `artifact_app_manifest_not_found` (not automatically retryable): Create artifact-app.json inside appDir, or correct appDir, then inspect again.
44
76
  - `artifact_app_manifest_too_large` (not automatically retryable): Keep artifact-app.json below 512 KiB. Move application data and source into separate files, then inspect again.
45
- - `scope_required` (not automatically retryable): Reconnect the Build MCP and approve the requested scope.
46
77
  - `artifact_app_scaffold_target_not_empty` (not automatically retryable): Choose an empty appDir or deploy the existing app without scaffolding.
47
78
 
48
79
  ## Tools
@@ -4613,3 +4644,827 @@ Output schema:
4613
4644
  ]
4614
4645
  }
4615
4646
  ```
4647
+
4648
+ ### `platform_read_artifact_domains`
4649
+
4650
+ 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.
4651
+
4652
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=false.
4653
+
4654
+ Example request:
4655
+
4656
+ ```json
4657
+ {}
4658
+ ```
4659
+
4660
+ Example success:
4661
+
4662
+ ```json
4663
+ {}
4664
+ ```
4665
+
4666
+ Input schema:
4667
+
4668
+ ```json
4669
+ {
4670
+ "type": "object",
4671
+ "additionalProperties": false,
4672
+ "properties": {
4673
+ "limit": {
4674
+ "type": "integer",
4675
+ "minimum": 1,
4676
+ "maximum": 100
4677
+ },
4678
+ "cursor": {
4679
+ "type": "integer",
4680
+ "minimum": 0,
4681
+ "maximum": 10000
4682
+ },
4683
+ "includePending": {
4684
+ "type": "boolean"
4685
+ },
4686
+ "domainId": {
4687
+ "type": "string",
4688
+ "format": "uuid"
4689
+ },
4690
+ "zoneName": {
4691
+ "type": "string",
4692
+ "minLength": 1,
4693
+ "maxLength": 253
4694
+ },
4695
+ "recovery": {
4696
+ "oneOf": [
4697
+ {
4698
+ "type": "object",
4699
+ "additionalProperties": false,
4700
+ "properties": {
4701
+ "operationId": {
4702
+ "type": "string",
4703
+ "format": "uuid"
4704
+ }
4705
+ },
4706
+ "required": [
4707
+ "operationId"
4708
+ ]
4709
+ },
4710
+ {
4711
+ "type": "object",
4712
+ "additionalProperties": false,
4713
+ "properties": {
4714
+ "kind": {
4715
+ "enum": [
4716
+ "request",
4717
+ "verify"
4718
+ ]
4719
+ },
4720
+ "idempotencyKey": {
4721
+ "type": "string",
4722
+ "minLength": 1,
4723
+ "maxLength": 128,
4724
+ "pattern": "^[\\x21-\\x7E]+$"
4725
+ }
4726
+ },
4727
+ "required": [
4728
+ "kind",
4729
+ "idempotencyKey"
4730
+ ]
4731
+ }
4732
+ ]
4733
+ }
4734
+ },
4735
+ "required": [],
4736
+ "oneOf": [
4737
+ {
4738
+ "not": {
4739
+ "anyOf": [
4740
+ {
4741
+ "required": [
4742
+ "domainId"
4743
+ ]
4744
+ },
4745
+ {
4746
+ "required": [
4747
+ "recovery"
4748
+ ]
4749
+ },
4750
+ {
4751
+ "required": [
4752
+ "zoneName"
4753
+ ]
4754
+ }
4755
+ ]
4756
+ }
4757
+ },
4758
+ {
4759
+ "required": [
4760
+ "domainId"
4761
+ ],
4762
+ "not": {
4763
+ "anyOf": [
4764
+ {
4765
+ "required": [
4766
+ "limit"
4767
+ ]
4768
+ },
4769
+ {
4770
+ "required": [
4771
+ "cursor"
4772
+ ]
4773
+ },
4774
+ {
4775
+ "required": [
4776
+ "includePending"
4777
+ ]
4778
+ },
4779
+ {
4780
+ "required": [
4781
+ "recovery"
4782
+ ]
4783
+ }
4784
+ ]
4785
+ }
4786
+ },
4787
+ {
4788
+ "required": [
4789
+ "recovery"
4790
+ ],
4791
+ "not": {
4792
+ "anyOf": [
4793
+ {
4794
+ "required": [
4795
+ "domainId"
4796
+ ]
4797
+ },
4798
+ {
4799
+ "required": [
4800
+ "zoneName"
4801
+ ]
4802
+ },
4803
+ {
4804
+ "required": [
4805
+ "cursor"
4806
+ ]
4807
+ },
4808
+ {
4809
+ "required": [
4810
+ "limit"
4811
+ ]
4812
+ },
4813
+ {
4814
+ "required": [
4815
+ "includePending"
4816
+ ]
4817
+ }
4818
+ ]
4819
+ }
4820
+ }
4821
+ ]
4822
+ }
4823
+ ```
4824
+
4825
+ Output schema:
4826
+
4827
+ ```json
4828
+ {
4829
+ "type": "object",
4830
+ "oneOf": [
4831
+ {
4832
+ "type": "object",
4833
+ "properties": {
4834
+ "ok": {
4835
+ "const": true
4836
+ }
4837
+ }
4838
+ },
4839
+ {
4840
+ "type": "object",
4841
+ "properties": {
4842
+ "ok": {
4843
+ "const": false
4844
+ },
4845
+ "error": {
4846
+ "type": "object",
4847
+ "properties": {
4848
+ "code": {
4849
+ "type": "string"
4850
+ },
4851
+ "message": {
4852
+ "type": "string"
4853
+ },
4854
+ "retryable": {
4855
+ "type": "boolean"
4856
+ },
4857
+ "recoveryAction": {
4858
+ "type": "string"
4859
+ },
4860
+ "recovery": {
4861
+ "type": "object",
4862
+ "additionalProperties": true
4863
+ }
4864
+ },
4865
+ "required": [
4866
+ "code",
4867
+ "message",
4868
+ "retryable",
4869
+ "recoveryAction"
4870
+ ],
4871
+ "additionalProperties": false
4872
+ }
4873
+ },
4874
+ "required": [
4875
+ "ok",
4876
+ "error"
4877
+ ],
4878
+ "additionalProperties": false
4879
+ }
4880
+ ]
4881
+ }
4882
+ ```
4883
+
4884
+ ### `platform_get_artifact_address`
4885
+
4886
+ 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.
4887
+
4888
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=false.
4889
+
4890
+ Example request:
4891
+
4892
+ ```json
4893
+ {
4894
+ "artifactId": "00000000-0000-4000-8000-000000000001"
4895
+ }
4896
+ ```
4897
+
4898
+ Example success:
4899
+
4900
+ ```json
4901
+ {}
4902
+ ```
4903
+
4904
+ Input schema:
4905
+
4906
+ ```json
4907
+ {
4908
+ "type": "object",
4909
+ "additionalProperties": false,
4910
+ "properties": {
4911
+ "artifactId": {
4912
+ "type": "string",
4913
+ "format": "uuid"
4914
+ },
4915
+ "recovery": {
4916
+ "oneOf": [
4917
+ {
4918
+ "type": "object",
4919
+ "additionalProperties": false,
4920
+ "properties": {
4921
+ "operationId": {
4922
+ "type": "string",
4923
+ "format": "uuid"
4924
+ }
4925
+ },
4926
+ "required": [
4927
+ "operationId"
4928
+ ]
4929
+ },
4930
+ {
4931
+ "type": "object",
4932
+ "additionalProperties": false,
4933
+ "properties": {
4934
+ "idempotencyKey": {
4935
+ "type": "string",
4936
+ "minLength": 1,
4937
+ "maxLength": 128,
4938
+ "pattern": "^[\\x21-\\x7E]+$"
4939
+ }
4940
+ },
4941
+ "required": [
4942
+ "idempotencyKey"
4943
+ ]
4944
+ }
4945
+ ]
4946
+ }
4947
+ },
4948
+ "required": [
4949
+ "artifactId"
4950
+ ]
4951
+ }
4952
+ ```
4953
+
4954
+ Output schema:
4955
+
4956
+ ```json
4957
+ {
4958
+ "type": "object",
4959
+ "oneOf": [
4960
+ {
4961
+ "type": "object",
4962
+ "properties": {
4963
+ "ok": {
4964
+ "const": true
4965
+ }
4966
+ }
4967
+ },
4968
+ {
4969
+ "type": "object",
4970
+ "properties": {
4971
+ "ok": {
4972
+ "const": false
4973
+ },
4974
+ "error": {
4975
+ "type": "object",
4976
+ "properties": {
4977
+ "code": {
4978
+ "type": "string"
4979
+ },
4980
+ "message": {
4981
+ "type": "string"
4982
+ },
4983
+ "retryable": {
4984
+ "type": "boolean"
4985
+ },
4986
+ "recoveryAction": {
4987
+ "type": "string"
4988
+ },
4989
+ "recovery": {
4990
+ "type": "object",
4991
+ "additionalProperties": true
4992
+ }
4993
+ },
4994
+ "required": [
4995
+ "code",
4996
+ "message",
4997
+ "retryable",
4998
+ "recoveryAction"
4999
+ ],
5000
+ "additionalProperties": false
5001
+ }
5002
+ },
5003
+ "required": [
5004
+ "ok",
5005
+ "error"
5006
+ ],
5007
+ "additionalProperties": false
5008
+ }
5009
+ ]
5010
+ }
5011
+ ```
5012
+
5013
+ ### `platform_plan_artifact_address`
5014
+
5015
+ 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.
5016
+
5017
+ Safety: read-only=false, destructive=false, idempotent=false, open-world=false.
5018
+
5019
+ Example request:
5020
+
5021
+ ```json
5022
+ {
5023
+ "artifactId": "00000000-0000-4000-8000-000000000001",
5024
+ "domainId": "00000000-0000-4000-8000-000000000001",
5025
+ "path": "<path>"
5026
+ }
5027
+ ```
5028
+
5029
+ Example success:
5030
+
5031
+ ```json
5032
+ {}
5033
+ ```
5034
+
5035
+ Input schema:
5036
+
5037
+ ```json
5038
+ {
5039
+ "type": "object",
5040
+ "additionalProperties": false,
5041
+ "properties": {
5042
+ "artifactId": {
5043
+ "type": "string",
5044
+ "format": "uuid"
5045
+ },
5046
+ "domainId": {
5047
+ "type": [
5048
+ "string",
5049
+ "null"
5050
+ ],
5051
+ "format": "uuid"
5052
+ },
5053
+ "path": {
5054
+ "type": "string",
5055
+ "minLength": 1,
5056
+ "maxLength": 70
5057
+ }
5058
+ },
5059
+ "required": [
5060
+ "artifactId",
5061
+ "domainId"
5062
+ ],
5063
+ "oneOf": [
5064
+ {
5065
+ "properties": {
5066
+ "domainId": {
5067
+ "type": "string",
5068
+ "format": "uuid"
5069
+ }
5070
+ },
5071
+ "required": [
5072
+ "path"
5073
+ ]
5074
+ },
5075
+ {
5076
+ "properties": {
5077
+ "domainId": {
5078
+ "type": "null"
5079
+ }
5080
+ },
5081
+ "not": {
5082
+ "required": [
5083
+ "path"
5084
+ ]
5085
+ }
5086
+ }
5087
+ ]
5088
+ }
5089
+ ```
5090
+
5091
+ Output schema:
5092
+
5093
+ ```json
5094
+ {
5095
+ "type": "object",
5096
+ "oneOf": [
5097
+ {
5098
+ "type": "object",
5099
+ "properties": {
5100
+ "ok": {
5101
+ "const": true
5102
+ }
5103
+ }
5104
+ },
5105
+ {
5106
+ "type": "object",
5107
+ "properties": {
5108
+ "ok": {
5109
+ "const": false
5110
+ },
5111
+ "error": {
5112
+ "type": "object",
5113
+ "properties": {
5114
+ "code": {
5115
+ "type": "string"
5116
+ },
5117
+ "message": {
5118
+ "type": "string"
5119
+ },
5120
+ "retryable": {
5121
+ "type": "boolean"
5122
+ },
5123
+ "recoveryAction": {
5124
+ "type": "string"
5125
+ },
5126
+ "recovery": {
5127
+ "type": "object",
5128
+ "additionalProperties": true
5129
+ }
5130
+ },
5131
+ "required": [
5132
+ "code",
5133
+ "message",
5134
+ "retryable",
5135
+ "recoveryAction"
5136
+ ],
5137
+ "additionalProperties": false
5138
+ }
5139
+ },
5140
+ "required": [
5141
+ "ok",
5142
+ "error"
5143
+ ],
5144
+ "additionalProperties": false
5145
+ }
5146
+ ]
5147
+ }
5148
+ ```
5149
+
5150
+ ### `platform_apply_artifact_address`
5151
+
5152
+ 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.
5153
+
5154
+ Safety: read-only=false, destructive=true, idempotent=true, open-world=false.
5155
+
5156
+ Example request:
5157
+
5158
+ ```json
5159
+ {
5160
+ "planId": "00000000-0000-4000-8000-000000000001",
5161
+ "idempotencyKey": "example-request"
5162
+ }
5163
+ ```
5164
+
5165
+ Example success:
5166
+
5167
+ ```json
5168
+ {}
5169
+ ```
5170
+
5171
+ Input schema:
5172
+
5173
+ ```json
5174
+ {
5175
+ "type": "object",
5176
+ "additionalProperties": false,
5177
+ "properties": {
5178
+ "planId": {
5179
+ "type": "string",
5180
+ "format": "uuid"
5181
+ },
5182
+ "idempotencyKey": {
5183
+ "type": "string",
5184
+ "minLength": 1,
5185
+ "maxLength": 128,
5186
+ "pattern": "^[\\x21-\\x7E]+$"
5187
+ }
5188
+ },
5189
+ "required": [
5190
+ "planId",
5191
+ "idempotencyKey"
5192
+ ]
5193
+ }
5194
+ ```
5195
+
5196
+ Output schema:
5197
+
5198
+ ```json
5199
+ {
5200
+ "type": "object",
5201
+ "oneOf": [
5202
+ {
5203
+ "type": "object",
5204
+ "properties": {
5205
+ "ok": {
5206
+ "const": true
5207
+ }
5208
+ }
5209
+ },
5210
+ {
5211
+ "type": "object",
5212
+ "properties": {
5213
+ "ok": {
5214
+ "const": false
5215
+ },
5216
+ "error": {
5217
+ "type": "object",
5218
+ "properties": {
5219
+ "code": {
5220
+ "type": "string"
5221
+ },
5222
+ "message": {
5223
+ "type": "string"
5224
+ },
5225
+ "retryable": {
5226
+ "type": "boolean"
5227
+ },
5228
+ "recoveryAction": {
5229
+ "type": "string"
5230
+ },
5231
+ "recovery": {
5232
+ "type": "object",
5233
+ "additionalProperties": true
5234
+ }
5235
+ },
5236
+ "required": [
5237
+ "code",
5238
+ "message",
5239
+ "retryable",
5240
+ "recoveryAction"
5241
+ ],
5242
+ "additionalProperties": false
5243
+ }
5244
+ },
5245
+ "required": [
5246
+ "ok",
5247
+ "error"
5248
+ ],
5249
+ "additionalProperties": false
5250
+ }
5251
+ ]
5252
+ }
5253
+ ```
5254
+
5255
+ ### `platform_request_artifact_domain`
5256
+
5257
+ 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.
5258
+
5259
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=false.
5260
+
5261
+ Example request:
5262
+
5263
+ ```json
5264
+ {
5265
+ "hostname": "<hostname>",
5266
+ "idempotencyKey": "example-request"
5267
+ }
5268
+ ```
5269
+
5270
+ Example success:
5271
+
5272
+ ```json
5273
+ {}
5274
+ ```
5275
+
5276
+ Input schema:
5277
+
5278
+ ```json
5279
+ {
5280
+ "type": "object",
5281
+ "additionalProperties": false,
5282
+ "properties": {
5283
+ "hostname": {
5284
+ "type": "string",
5285
+ "minLength": 1,
5286
+ "maxLength": 253
5287
+ },
5288
+ "idempotencyKey": {
5289
+ "type": "string",
5290
+ "minLength": 1,
5291
+ "maxLength": 128,
5292
+ "pattern": "^[\\x21-\\x7E]+$"
5293
+ }
5294
+ },
5295
+ "required": [
5296
+ "hostname",
5297
+ "idempotencyKey"
5298
+ ]
5299
+ }
5300
+ ```
5301
+
5302
+ Output schema:
5303
+
5304
+ ```json
5305
+ {
5306
+ "type": "object",
5307
+ "oneOf": [
5308
+ {
5309
+ "type": "object",
5310
+ "properties": {
5311
+ "ok": {
5312
+ "const": true
5313
+ }
5314
+ }
5315
+ },
5316
+ {
5317
+ "type": "object",
5318
+ "properties": {
5319
+ "ok": {
5320
+ "const": false
5321
+ },
5322
+ "error": {
5323
+ "type": "object",
5324
+ "properties": {
5325
+ "code": {
5326
+ "type": "string"
5327
+ },
5328
+ "message": {
5329
+ "type": "string"
5330
+ },
5331
+ "retryable": {
5332
+ "type": "boolean"
5333
+ },
5334
+ "recoveryAction": {
5335
+ "type": "string"
5336
+ },
5337
+ "recovery": {
5338
+ "type": "object",
5339
+ "additionalProperties": true
5340
+ }
5341
+ },
5342
+ "required": [
5343
+ "code",
5344
+ "message",
5345
+ "retryable",
5346
+ "recoveryAction"
5347
+ ],
5348
+ "additionalProperties": false
5349
+ }
5350
+ },
5351
+ "required": [
5352
+ "ok",
5353
+ "error"
5354
+ ],
5355
+ "additionalProperties": false
5356
+ }
5357
+ ]
5358
+ }
5359
+ ```
5360
+
5361
+ ### `platform_verify_artifact_domain`
5362
+
5363
+ 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.
5364
+
5365
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
5366
+
5367
+ Example request:
5368
+
5369
+ ```json
5370
+ {
5371
+ "domainId": "00000000-0000-4000-8000-000000000001",
5372
+ "expectedConnectionGeneration": 0,
5373
+ "idempotencyKey": "example-request"
5374
+ }
5375
+ ```
5376
+
5377
+ Example success:
5378
+
5379
+ ```json
5380
+ {}
5381
+ ```
5382
+
5383
+ Input schema:
5384
+
5385
+ ```json
5386
+ {
5387
+ "type": "object",
5388
+ "additionalProperties": false,
5389
+ "properties": {
5390
+ "domainId": {
5391
+ "type": "string",
5392
+ "format": "uuid"
5393
+ },
5394
+ "expectedConnectionGeneration": {
5395
+ "type": "integer",
5396
+ "minimum": 0
5397
+ },
5398
+ "idempotencyKey": {
5399
+ "type": "string",
5400
+ "minLength": 1,
5401
+ "maxLength": 128,
5402
+ "pattern": "^[\\x21-\\x7E]+$"
5403
+ }
5404
+ },
5405
+ "required": [
5406
+ "domainId",
5407
+ "expectedConnectionGeneration",
5408
+ "idempotencyKey"
5409
+ ]
5410
+ }
5411
+ ```
5412
+
5413
+ Output schema:
5414
+
5415
+ ```json
5416
+ {
5417
+ "type": "object",
5418
+ "oneOf": [
5419
+ {
5420
+ "type": "object",
5421
+ "properties": {
5422
+ "ok": {
5423
+ "const": true
5424
+ }
5425
+ }
5426
+ },
5427
+ {
5428
+ "type": "object",
5429
+ "properties": {
5430
+ "ok": {
5431
+ "const": false
5432
+ },
5433
+ "error": {
5434
+ "type": "object",
5435
+ "properties": {
5436
+ "code": {
5437
+ "type": "string"
5438
+ },
5439
+ "message": {
5440
+ "type": "string"
5441
+ },
5442
+ "retryable": {
5443
+ "type": "boolean"
5444
+ },
5445
+ "recoveryAction": {
5446
+ "type": "string"
5447
+ },
5448
+ "recovery": {
5449
+ "type": "object",
5450
+ "additionalProperties": true
5451
+ }
5452
+ },
5453
+ "required": [
5454
+ "code",
5455
+ "message",
5456
+ "retryable",
5457
+ "recoveryAction"
5458
+ ],
5459
+ "additionalProperties": false
5460
+ }
5461
+ },
5462
+ "required": [
5463
+ "ok",
5464
+ "error"
5465
+ ],
5466
+ "additionalProperties": false
5467
+ }
5468
+ ]
5469
+ }
5470
+ ```