@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.
- package/CHANGELOG.md +7 -0
- package/README.md +4 -0
- package/dist/domain-tools.d.ts +11 -0
- package/dist/domain-tools.js +53 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +81 -5
- package/docs/generated/build-mcp-manifest.json +919 -7
- package/docs/generated/build-mcp-reference.md +857 -2
- package/package.json +2 -1
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"package": {
|
|
4
4
|
"name": "@topline-build/harness-mcp",
|
|
5
|
-
"version": "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.
|
|
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
|
}
|