@topline-build/harness-mcp 0.5.3 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "@topline-build/harness-mcp",
5
- "version": "0.5.3",
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.5.3"
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,
@@ -499,6 +654,31 @@
499
654
  "minLength": 1,
500
655
  "maxLength": 128,
501
656
  "description": "Optional stable retry key; generated deterministically when omitted."
657
+ },
658
+ "sessionId": {
659
+ "type": "string",
660
+ "format": "uuid"
661
+ },
662
+ "artifactVersionId": {
663
+ "type": "string",
664
+ "format": "uuid",
665
+ "description": "Exact current version from the session or checkout; required with sessionId."
666
+ },
667
+ "idempotencyKey": {
668
+ "type": "string",
669
+ "minLength": 1,
670
+ "maxLength": 128,
671
+ "pattern": "^[A-Za-z0-9._:-]+$"
672
+ },
673
+ "inspectedSourceHash": {
674
+ "type": "string",
675
+ "pattern": "^[0-9a-fA-F]{64}$",
676
+ "description": "Echo the session/source checkout hash; required with sessionId. expectedBundleSha256 separately pins the newly inspected local upload."
677
+ },
678
+ "platformAppDir": {
679
+ "type": "string",
680
+ "minLength": 1,
681
+ "description": "Saved remote app root from an existing-app checkout. Session mode only; preserve this when the local checkout directory has a different name."
502
682
  }
503
683
  },
504
684
  "required": [
@@ -623,6 +803,11 @@
623
803
  "appDir": {
624
804
  "type": "string",
625
805
  "minLength": 1
806
+ },
807
+ "platformAppDir": {
808
+ "type": "string",
809
+ "minLength": 1,
810
+ "description": "Preserve the saved remote source root returned by checkout when inspecting an existing app."
626
811
  }
627
812
  },
628
813
  "required": [
@@ -2645,6 +2830,2449 @@
2645
2830
  }
2646
2831
  }
2647
2832
  ]
2833
+ },
2834
+ {
2835
+ "name": "platform_capability_status",
2836
+ "description": "Read the connected Build product's current available, denied, unsupported and unconfigured tool families, contract version and helper requirement. Reconnect explicitly for newly consented scopes.",
2837
+ "annotations": {
2838
+ "title": "Platform Capability Status",
2839
+ "readOnlyHint": true,
2840
+ "destructiveHint": false,
2841
+ "idempotentHint": true,
2842
+ "openWorldHint": true
2843
+ },
2844
+ "inputSchema": {
2845
+ "type": "object",
2846
+ "additionalProperties": false,
2847
+ "properties": {},
2848
+ "required": []
2849
+ },
2850
+ "outputSchema": {
2851
+ "type": "object",
2852
+ "oneOf": [
2853
+ {
2854
+ "type": "object",
2855
+ "properties": {
2856
+ "ok": {
2857
+ "const": true
2858
+ }
2859
+ }
2860
+ },
2861
+ {
2862
+ "type": "object",
2863
+ "properties": {
2864
+ "ok": {
2865
+ "const": false
2866
+ },
2867
+ "error": {
2868
+ "type": "object",
2869
+ "properties": {
2870
+ "code": {
2871
+ "type": "string"
2872
+ },
2873
+ "message": {
2874
+ "type": "string"
2875
+ },
2876
+ "retryable": {
2877
+ "type": "boolean"
2878
+ },
2879
+ "recoveryAction": {
2880
+ "type": "string"
2881
+ }
2882
+ },
2883
+ "required": [
2884
+ "code",
2885
+ "message",
2886
+ "retryable",
2887
+ "recoveryAction"
2888
+ ],
2889
+ "additionalProperties": false
2890
+ }
2891
+ },
2892
+ "required": [
2893
+ "ok",
2894
+ "error"
2895
+ ],
2896
+ "additionalProperties": false
2897
+ }
2898
+ ]
2899
+ },
2900
+ "examples": [
2901
+ {
2902
+ "request": {},
2903
+ "success": {}
2904
+ }
2905
+ ]
2906
+ },
2907
+ {
2908
+ "name": "platform_start_build_session",
2909
+ "description": "Start external authoring with a private artifact identity, current version and platform-operation budget. Launches no internal coder. Existing artifact starts require its current version; new app starts require a manifest. Optional own conversation selects exact operator-approved secret references.",
2910
+ "annotations": {
2911
+ "title": "Platform Start Build Session",
2912
+ "readOnlyHint": false,
2913
+ "destructiveHint": false,
2914
+ "idempotentHint": true,
2915
+ "openWorldHint": true
2916
+ },
2917
+ "inputSchema": {
2918
+ "type": "object",
2919
+ "additionalProperties": false,
2920
+ "properties": {
2921
+ "idempotencyKey": {
2922
+ "type": "string",
2923
+ "minLength": 1,
2924
+ "maxLength": 128,
2925
+ "pattern": "^[A-Za-z0-9._:-]+$"
2926
+ },
2927
+ "artifactId": {
2928
+ "type": "string",
2929
+ "format": "uuid"
2930
+ },
2931
+ "artifactVersionId": {
2932
+ "type": "string",
2933
+ "format": "uuid"
2934
+ },
2935
+ "manifest": {
2936
+ "type": "object"
2937
+ },
2938
+ "projectId": {
2939
+ "type": "string",
2940
+ "format": "uuid"
2941
+ },
2942
+ "owningConversationId": {
2943
+ "type": "string",
2944
+ "format": "uuid"
2945
+ },
2946
+ "budgetCents": {
2947
+ "type": "integer",
2948
+ "minimum": 0,
2949
+ "maximum": 100000
2950
+ },
2951
+ "brief": {
2952
+ "type": "string",
2953
+ "minLength": 3,
2954
+ "maxLength": 4000
2955
+ }
2956
+ },
2957
+ "required": [
2958
+ "idempotencyKey",
2959
+ "budgetCents",
2960
+ "brief"
2961
+ ]
2962
+ },
2963
+ "outputSchema": {
2964
+ "type": "object",
2965
+ "oneOf": [
2966
+ {
2967
+ "type": "object",
2968
+ "properties": {
2969
+ "ok": {
2970
+ "const": true
2971
+ }
2972
+ }
2973
+ },
2974
+ {
2975
+ "type": "object",
2976
+ "properties": {
2977
+ "ok": {
2978
+ "const": false
2979
+ },
2980
+ "error": {
2981
+ "type": "object",
2982
+ "properties": {
2983
+ "code": {
2984
+ "type": "string"
2985
+ },
2986
+ "message": {
2987
+ "type": "string"
2988
+ },
2989
+ "retryable": {
2990
+ "type": "boolean"
2991
+ },
2992
+ "recoveryAction": {
2993
+ "type": "string"
2994
+ }
2995
+ },
2996
+ "required": [
2997
+ "code",
2998
+ "message",
2999
+ "retryable",
3000
+ "recoveryAction"
3001
+ ],
3002
+ "additionalProperties": false
3003
+ }
3004
+ },
3005
+ "required": [
3006
+ "ok",
3007
+ "error"
3008
+ ],
3009
+ "additionalProperties": false
3010
+ }
3011
+ ]
3012
+ },
3013
+ "examples": [
3014
+ {
3015
+ "request": {
3016
+ "idempotencyKey": "example-request",
3017
+ "budgetCents": 0,
3018
+ "brief": "<brief>"
3019
+ },
3020
+ "success": {}
3021
+ }
3022
+ ]
3023
+ },
3024
+ {
3025
+ "name": "platform_read_build_session",
3026
+ "description": "Read the owned build session and original pending operations. Does not start another coder or deployment.",
3027
+ "annotations": {
3028
+ "title": "Platform Read Build Session",
3029
+ "readOnlyHint": true,
3030
+ "destructiveHint": false,
3031
+ "idempotentHint": true,
3032
+ "openWorldHint": true
3033
+ },
3034
+ "inputSchema": {
3035
+ "type": "object",
3036
+ "additionalProperties": false,
3037
+ "properties": {
3038
+ "sessionId": {
3039
+ "type": "string",
3040
+ "format": "uuid"
3041
+ }
3042
+ },
3043
+ "required": [
3044
+ "sessionId"
3045
+ ]
3046
+ },
3047
+ "outputSchema": {
3048
+ "type": "object",
3049
+ "oneOf": [
3050
+ {
3051
+ "type": "object",
3052
+ "properties": {
3053
+ "ok": {
3054
+ "const": true
3055
+ }
3056
+ }
3057
+ },
3058
+ {
3059
+ "type": "object",
3060
+ "properties": {
3061
+ "ok": {
3062
+ "const": false
3063
+ },
3064
+ "error": {
3065
+ "type": "object",
3066
+ "properties": {
3067
+ "code": {
3068
+ "type": "string"
3069
+ },
3070
+ "message": {
3071
+ "type": "string"
3072
+ },
3073
+ "retryable": {
3074
+ "type": "boolean"
3075
+ },
3076
+ "recoveryAction": {
3077
+ "type": "string"
3078
+ }
3079
+ },
3080
+ "required": [
3081
+ "code",
3082
+ "message",
3083
+ "retryable",
3084
+ "recoveryAction"
3085
+ ],
3086
+ "additionalProperties": false
3087
+ }
3088
+ },
3089
+ "required": [
3090
+ "ok",
3091
+ "error"
3092
+ ],
3093
+ "additionalProperties": false
3094
+ }
3095
+ ]
3096
+ },
3097
+ "examples": [
3098
+ {
3099
+ "request": {
3100
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3101
+ },
3102
+ "success": {}
3103
+ }
3104
+ ]
3105
+ },
3106
+ {
3107
+ "name": "platform_close_build_session",
3108
+ "description": "Stop new authoring and request pending-operation cancellation. Unknown effects retain their reservation; cancellation does not undo committed writes.",
3109
+ "annotations": {
3110
+ "title": "Platform Close Build Session",
3111
+ "readOnlyHint": false,
3112
+ "destructiveHint": false,
3113
+ "idempotentHint": true,
3114
+ "openWorldHint": true
3115
+ },
3116
+ "inputSchema": {
3117
+ "type": "object",
3118
+ "additionalProperties": false,
3119
+ "properties": {
3120
+ "sessionId": {
3121
+ "type": "string",
3122
+ "format": "uuid"
3123
+ }
3124
+ },
3125
+ "required": [
3126
+ "sessionId"
3127
+ ]
3128
+ },
3129
+ "outputSchema": {
3130
+ "type": "object",
3131
+ "oneOf": [
3132
+ {
3133
+ "type": "object",
3134
+ "properties": {
3135
+ "ok": {
3136
+ "const": true
3137
+ }
3138
+ }
3139
+ },
3140
+ {
3141
+ "type": "object",
3142
+ "properties": {
3143
+ "ok": {
3144
+ "const": false
3145
+ },
3146
+ "error": {
3147
+ "type": "object",
3148
+ "properties": {
3149
+ "code": {
3150
+ "type": "string"
3151
+ },
3152
+ "message": {
3153
+ "type": "string"
3154
+ },
3155
+ "retryable": {
3156
+ "type": "boolean"
3157
+ },
3158
+ "recoveryAction": {
3159
+ "type": "string"
3160
+ }
3161
+ },
3162
+ "required": [
3163
+ "code",
3164
+ "message",
3165
+ "retryable",
3166
+ "recoveryAction"
3167
+ ],
3168
+ "additionalProperties": false
3169
+ }
3170
+ },
3171
+ "required": [
3172
+ "ok",
3173
+ "error"
3174
+ ],
3175
+ "additionalProperties": false
3176
+ }
3177
+ ]
3178
+ },
3179
+ "examples": [
3180
+ {
3181
+ "request": {
3182
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3183
+ },
3184
+ "success": {}
3185
+ }
3186
+ ]
3187
+ },
3188
+ {
3189
+ "name": "platform_run_artifact_workspace_sql",
3190
+ "description": "Run guarded private artifact SQL using the exact session namespace, version and retry key. CREATE TABLE/ADD COLUMN require documentation. Enforced non-admin writes remain denied; unknown writes are never replayed.",
3191
+ "annotations": {
3192
+ "title": "Platform Run Artifact Workspace Sql",
3193
+ "readOnlyHint": false,
3194
+ "destructiveHint": false,
3195
+ "idempotentHint": true,
3196
+ "openWorldHint": true
3197
+ },
3198
+ "inputSchema": {
3199
+ "type": "object",
3200
+ "additionalProperties": false,
3201
+ "properties": {
3202
+ "sessionId": {
3203
+ "type": "string",
3204
+ "format": "uuid"
3205
+ },
3206
+ "artifactVersionId": {
3207
+ "type": "string",
3208
+ "format": "uuid"
3209
+ },
3210
+ "idempotencyKey": {
3211
+ "type": "string",
3212
+ "minLength": 1,
3213
+ "maxLength": 128,
3214
+ "pattern": "^[A-Za-z0-9._:-]+$"
3215
+ },
3216
+ "sql": {
3217
+ "type": "string",
3218
+ "minLength": 1,
3219
+ "maxLength": 20000
3220
+ },
3221
+ "purpose": {
3222
+ "type": "string",
3223
+ "minLength": 3,
3224
+ "maxLength": 500
3225
+ },
3226
+ "params": {
3227
+ "type": "object",
3228
+ "additionalProperties": true
3229
+ },
3230
+ "maxRows": {
3231
+ "type": "integer",
3232
+ "minimum": 1,
3233
+ "maximum": 5000
3234
+ },
3235
+ "documentation": {
3236
+ "type": "object"
3237
+ },
3238
+ "columnDocumentation": {
3239
+ "type": "object"
3240
+ }
3241
+ },
3242
+ "required": [
3243
+ "sessionId",
3244
+ "artifactVersionId",
3245
+ "idempotencyKey",
3246
+ "sql",
3247
+ "purpose"
3248
+ ]
3249
+ },
3250
+ "outputSchema": {
3251
+ "type": "object",
3252
+ "oneOf": [
3253
+ {
3254
+ "type": "object",
3255
+ "properties": {
3256
+ "ok": {
3257
+ "const": true
3258
+ }
3259
+ }
3260
+ },
3261
+ {
3262
+ "type": "object",
3263
+ "properties": {
3264
+ "ok": {
3265
+ "const": false
3266
+ },
3267
+ "error": {
3268
+ "type": "object",
3269
+ "properties": {
3270
+ "code": {
3271
+ "type": "string"
3272
+ },
3273
+ "message": {
3274
+ "type": "string"
3275
+ },
3276
+ "retryable": {
3277
+ "type": "boolean"
3278
+ },
3279
+ "recoveryAction": {
3280
+ "type": "string"
3281
+ }
3282
+ },
3283
+ "required": [
3284
+ "code",
3285
+ "message",
3286
+ "retryable",
3287
+ "recoveryAction"
3288
+ ],
3289
+ "additionalProperties": false
3290
+ }
3291
+ },
3292
+ "required": [
3293
+ "ok",
3294
+ "error"
3295
+ ],
3296
+ "additionalProperties": false
3297
+ }
3298
+ ]
3299
+ },
3300
+ "examples": [
3301
+ {
3302
+ "request": {
3303
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3304
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
3305
+ "idempotencyKey": "example-request",
3306
+ "sql": "<sql>",
3307
+ "purpose": "<purpose>"
3308
+ },
3309
+ "success": {}
3310
+ }
3311
+ ]
3312
+ },
3313
+ {
3314
+ "name": "platform_checkout_artifact_app",
3315
+ "description": "Download exact saved app source through the owned session, verify archive hash/version/commit and extract regular source files into a new local directory. Missing source is never reconstructed.",
3316
+ "annotations": {
3317
+ "title": "Platform Checkout Artifact App",
3318
+ "readOnlyHint": false,
3319
+ "destructiveHint": false,
3320
+ "idempotentHint": true,
3321
+ "openWorldHint": true
3322
+ },
3323
+ "inputSchema": {
3324
+ "type": "object",
3325
+ "additionalProperties": false,
3326
+ "properties": {
3327
+ "sessionId": {
3328
+ "type": "string",
3329
+ "format": "uuid"
3330
+ },
3331
+ "targetDir": {
3332
+ "type": "string",
3333
+ "minLength": 1
3334
+ }
3335
+ },
3336
+ "required": [
3337
+ "sessionId",
3338
+ "targetDir"
3339
+ ]
3340
+ },
3341
+ "outputSchema": {
3342
+ "type": "object",
3343
+ "oneOf": [
3344
+ {
3345
+ "type": "object",
3346
+ "properties": {
3347
+ "ok": {
3348
+ "const": true
3349
+ }
3350
+ }
3351
+ },
3352
+ {
3353
+ "type": "object",
3354
+ "properties": {
3355
+ "ok": {
3356
+ "const": false
3357
+ },
3358
+ "error": {
3359
+ "type": "object",
3360
+ "properties": {
3361
+ "code": {
3362
+ "type": "string"
3363
+ },
3364
+ "message": {
3365
+ "type": "string"
3366
+ },
3367
+ "retryable": {
3368
+ "type": "boolean"
3369
+ },
3370
+ "recoveryAction": {
3371
+ "type": "string"
3372
+ }
3373
+ },
3374
+ "required": [
3375
+ "code",
3376
+ "message",
3377
+ "retryable",
3378
+ "recoveryAction"
3379
+ ],
3380
+ "additionalProperties": false
3381
+ }
3382
+ },
3383
+ "required": [
3384
+ "ok",
3385
+ "error"
3386
+ ],
3387
+ "additionalProperties": false
3388
+ }
3389
+ ]
3390
+ },
3391
+ "examples": [
3392
+ {
3393
+ "request": {
3394
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3395
+ "targetDir": "<targetDir>"
3396
+ },
3397
+ "success": {}
3398
+ }
3399
+ ]
3400
+ },
3401
+ {
3402
+ "name": "platform_list_asset_folders",
3403
+ "description": "List the session's permitted reusable asset folders.",
3404
+ "annotations": {
3405
+ "title": "Platform List Asset Folders",
3406
+ "readOnlyHint": true,
3407
+ "destructiveHint": false,
3408
+ "idempotentHint": true,
3409
+ "openWorldHint": true
3410
+ },
3411
+ "inputSchema": {
3412
+ "type": "object",
3413
+ "additionalProperties": false,
3414
+ "properties": {
3415
+ "sessionId": {
3416
+ "type": "string",
3417
+ "format": "uuid"
3418
+ }
3419
+ },
3420
+ "required": [
3421
+ "sessionId"
3422
+ ]
3423
+ },
3424
+ "outputSchema": {
3425
+ "type": "object",
3426
+ "oneOf": [
3427
+ {
3428
+ "type": "object",
3429
+ "properties": {
3430
+ "ok": {
3431
+ "const": true
3432
+ }
3433
+ }
3434
+ },
3435
+ {
3436
+ "type": "object",
3437
+ "properties": {
3438
+ "ok": {
3439
+ "const": false
3440
+ },
3441
+ "error": {
3442
+ "type": "object",
3443
+ "properties": {
3444
+ "code": {
3445
+ "type": "string"
3446
+ },
3447
+ "message": {
3448
+ "type": "string"
3449
+ },
3450
+ "retryable": {
3451
+ "type": "boolean"
3452
+ },
3453
+ "recoveryAction": {
3454
+ "type": "string"
3455
+ }
3456
+ },
3457
+ "required": [
3458
+ "code",
3459
+ "message",
3460
+ "retryable",
3461
+ "recoveryAction"
3462
+ ],
3463
+ "additionalProperties": false
3464
+ }
3465
+ },
3466
+ "required": [
3467
+ "ok",
3468
+ "error"
3469
+ ],
3470
+ "additionalProperties": false
3471
+ }
3472
+ ]
3473
+ },
3474
+ "examples": [
3475
+ {
3476
+ "request": {
3477
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3478
+ },
3479
+ "success": {}
3480
+ }
3481
+ ]
3482
+ },
3483
+ {
3484
+ "name": "platform_list_assets",
3485
+ "description": "List permitted reusable asset metadata with bounded pagination; excluded/deleted attachments are omitted.",
3486
+ "annotations": {
3487
+ "title": "Platform List Assets",
3488
+ "readOnlyHint": true,
3489
+ "destructiveHint": false,
3490
+ "idempotentHint": true,
3491
+ "openWorldHint": true
3492
+ },
3493
+ "inputSchema": {
3494
+ "type": "object",
3495
+ "additionalProperties": false,
3496
+ "properties": {
3497
+ "sessionId": {
3498
+ "type": "string",
3499
+ "format": "uuid"
3500
+ },
3501
+ "query": {
3502
+ "type": "string",
3503
+ "maxLength": 200
3504
+ },
3505
+ "folderId": {
3506
+ "type": "string",
3507
+ "format": "uuid"
3508
+ },
3509
+ "limit": {
3510
+ "type": "integer",
3511
+ "minimum": 1,
3512
+ "maximum": 500
3513
+ },
3514
+ "offset": {
3515
+ "type": "integer",
3516
+ "minimum": 0
3517
+ }
3518
+ },
3519
+ "required": [
3520
+ "sessionId"
3521
+ ]
3522
+ },
3523
+ "outputSchema": {
3524
+ "type": "object",
3525
+ "oneOf": [
3526
+ {
3527
+ "type": "object",
3528
+ "properties": {
3529
+ "ok": {
3530
+ "const": true
3531
+ }
3532
+ }
3533
+ },
3534
+ {
3535
+ "type": "object",
3536
+ "properties": {
3537
+ "ok": {
3538
+ "const": false
3539
+ },
3540
+ "error": {
3541
+ "type": "object",
3542
+ "properties": {
3543
+ "code": {
3544
+ "type": "string"
3545
+ },
3546
+ "message": {
3547
+ "type": "string"
3548
+ },
3549
+ "retryable": {
3550
+ "type": "boolean"
3551
+ },
3552
+ "recoveryAction": {
3553
+ "type": "string"
3554
+ }
3555
+ },
3556
+ "required": [
3557
+ "code",
3558
+ "message",
3559
+ "retryable",
3560
+ "recoveryAction"
3561
+ ],
3562
+ "additionalProperties": false
3563
+ }
3564
+ },
3565
+ "required": [
3566
+ "ok",
3567
+ "error"
3568
+ ],
3569
+ "additionalProperties": false
3570
+ }
3571
+ ]
3572
+ },
3573
+ "examples": [
3574
+ {
3575
+ "request": {
3576
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3577
+ },
3578
+ "success": {}
3579
+ }
3580
+ ]
3581
+ },
3582
+ {
3583
+ "name": "platform_materialize_assets",
3584
+ "description": "Download exactly selected approved files into a new local directory. Verify each authenticated transfer's hash and size; source and attachment budgets remain separate.",
3585
+ "annotations": {
3586
+ "title": "Platform Materialize Assets",
3587
+ "readOnlyHint": false,
3588
+ "destructiveHint": false,
3589
+ "idempotentHint": true,
3590
+ "openWorldHint": true
3591
+ },
3592
+ "inputSchema": {
3593
+ "type": "object",
3594
+ "additionalProperties": false,
3595
+ "properties": {
3596
+ "sessionId": {
3597
+ "type": "string",
3598
+ "format": "uuid"
3599
+ },
3600
+ "assetIds": {
3601
+ "type": "array",
3602
+ "minItems": 1,
3603
+ "maxItems": 50,
3604
+ "uniqueItems": true,
3605
+ "items": {
3606
+ "type": "string",
3607
+ "format": "uuid"
3608
+ }
3609
+ },
3610
+ "targetDir": {
3611
+ "type": "string",
3612
+ "minLength": 1
3613
+ }
3614
+ },
3615
+ "required": [
3616
+ "sessionId",
3617
+ "assetIds",
3618
+ "targetDir"
3619
+ ]
3620
+ },
3621
+ "outputSchema": {
3622
+ "type": "object",
3623
+ "oneOf": [
3624
+ {
3625
+ "type": "object",
3626
+ "properties": {
3627
+ "ok": {
3628
+ "const": true
3629
+ }
3630
+ }
3631
+ },
3632
+ {
3633
+ "type": "object",
3634
+ "properties": {
3635
+ "ok": {
3636
+ "const": false
3637
+ },
3638
+ "error": {
3639
+ "type": "object",
3640
+ "properties": {
3641
+ "code": {
3642
+ "type": "string"
3643
+ },
3644
+ "message": {
3645
+ "type": "string"
3646
+ },
3647
+ "retryable": {
3648
+ "type": "boolean"
3649
+ },
3650
+ "recoveryAction": {
3651
+ "type": "string"
3652
+ }
3653
+ },
3654
+ "required": [
3655
+ "code",
3656
+ "message",
3657
+ "retryable",
3658
+ "recoveryAction"
3659
+ ],
3660
+ "additionalProperties": false
3661
+ }
3662
+ },
3663
+ "required": [
3664
+ "ok",
3665
+ "error"
3666
+ ],
3667
+ "additionalProperties": false
3668
+ }
3669
+ ]
3670
+ },
3671
+ "examples": [
3672
+ {
3673
+ "request": {
3674
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3675
+ "assetIds": [
3676
+ "00000000-0000-4000-8000-000000000001"
3677
+ ],
3678
+ "targetDir": "<targetDir>"
3679
+ },
3680
+ "success": {}
3681
+ }
3682
+ ]
3683
+ },
3684
+ {
3685
+ "name": "platform_list_build_secrets",
3686
+ "description": "Read only exact operator-approved binding references for this session. Values are never retrieved. Authoring detach does not prove deployed runtime revocation.",
3687
+ "annotations": {
3688
+ "title": "Platform List Build Secrets",
3689
+ "readOnlyHint": true,
3690
+ "destructiveHint": false,
3691
+ "idempotentHint": true,
3692
+ "openWorldHint": true
3693
+ },
3694
+ "inputSchema": {
3695
+ "type": "object",
3696
+ "additionalProperties": false,
3697
+ "properties": {
3698
+ "sessionId": {
3699
+ "type": "string",
3700
+ "format": "uuid"
3701
+ }
3702
+ },
3703
+ "required": [
3704
+ "sessionId"
3705
+ ]
3706
+ },
3707
+ "outputSchema": {
3708
+ "type": "object",
3709
+ "oneOf": [
3710
+ {
3711
+ "type": "object",
3712
+ "properties": {
3713
+ "ok": {
3714
+ "const": true
3715
+ }
3716
+ }
3717
+ },
3718
+ {
3719
+ "type": "object",
3720
+ "properties": {
3721
+ "ok": {
3722
+ "const": false
3723
+ },
3724
+ "error": {
3725
+ "type": "object",
3726
+ "properties": {
3727
+ "code": {
3728
+ "type": "string"
3729
+ },
3730
+ "message": {
3731
+ "type": "string"
3732
+ },
3733
+ "retryable": {
3734
+ "type": "boolean"
3735
+ },
3736
+ "recoveryAction": {
3737
+ "type": "string"
3738
+ }
3739
+ },
3740
+ "required": [
3741
+ "code",
3742
+ "message",
3743
+ "retryable",
3744
+ "recoveryAction"
3745
+ ],
3746
+ "additionalProperties": false
3747
+ }
3748
+ },
3749
+ "required": [
3750
+ "ok",
3751
+ "error"
3752
+ ],
3753
+ "additionalProperties": false
3754
+ }
3755
+ ]
3756
+ },
3757
+ "examples": [
3758
+ {
3759
+ "request": {
3760
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3761
+ },
3762
+ "success": {}
3763
+ }
3764
+ ]
3765
+ },
3766
+ {
3767
+ "name": "platform_add_acceptance_check",
3768
+ "description": "Add a required acceptance check bound to this build session and deployed revision. A semantic control query requires separate Build data-verification consent.",
3769
+ "annotations": {
3770
+ "title": "Platform Add Acceptance Check",
3771
+ "readOnlyHint": false,
3772
+ "destructiveHint": false,
3773
+ "idempotentHint": true,
3774
+ "openWorldHint": true
3775
+ },
3776
+ "inputSchema": {
3777
+ "type": "object",
3778
+ "additionalProperties": false,
3779
+ "properties": {
3780
+ "sessionId": {
3781
+ "type": "string",
3782
+ "format": "uuid"
3783
+ },
3784
+ "artifactVersionId": {
3785
+ "type": "string",
3786
+ "format": "uuid"
3787
+ },
3788
+ "idempotencyKey": {
3789
+ "type": "string",
3790
+ "minLength": 1,
3791
+ "maxLength": 128,
3792
+ "pattern": "^[A-Za-z0-9._:-]+$"
3793
+ },
3794
+ "description": {
3795
+ "type": "string",
3796
+ "minLength": 3,
3797
+ "maxLength": 1000
3798
+ }
3799
+ },
3800
+ "required": [
3801
+ "sessionId",
3802
+ "artifactVersionId",
3803
+ "idempotencyKey",
3804
+ "description"
3805
+ ]
3806
+ },
3807
+ "outputSchema": {
3808
+ "type": "object",
3809
+ "oneOf": [
3810
+ {
3811
+ "type": "object",
3812
+ "properties": {
3813
+ "ok": {
3814
+ "const": true
3815
+ }
3816
+ }
3817
+ },
3818
+ {
3819
+ "type": "object",
3820
+ "properties": {
3821
+ "ok": {
3822
+ "const": false
3823
+ },
3824
+ "error": {
3825
+ "type": "object",
3826
+ "properties": {
3827
+ "code": {
3828
+ "type": "string"
3829
+ },
3830
+ "message": {
3831
+ "type": "string"
3832
+ },
3833
+ "retryable": {
3834
+ "type": "boolean"
3835
+ },
3836
+ "recoveryAction": {
3837
+ "type": "string"
3838
+ }
3839
+ },
3840
+ "required": [
3841
+ "code",
3842
+ "message",
3843
+ "retryable",
3844
+ "recoveryAction"
3845
+ ],
3846
+ "additionalProperties": false
3847
+ }
3848
+ },
3849
+ "required": [
3850
+ "ok",
3851
+ "error"
3852
+ ],
3853
+ "additionalProperties": false
3854
+ }
3855
+ ]
3856
+ },
3857
+ "examples": [
3858
+ {
3859
+ "request": {
3860
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3861
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
3862
+ "idempotencyKey": "example-request",
3863
+ "description": "<description>"
3864
+ },
3865
+ "success": {}
3866
+ }
3867
+ ]
3868
+ },
3869
+ {
3870
+ "name": "platform_run_acceptance_checks",
3871
+ "description": "Run required acceptance checks for the exact current draft revision through the shared service.",
3872
+ "annotations": {
3873
+ "title": "Platform Run Acceptance Checks",
3874
+ "readOnlyHint": false,
3875
+ "destructiveHint": false,
3876
+ "idempotentHint": true,
3877
+ "openWorldHint": true
3878
+ },
3879
+ "inputSchema": {
3880
+ "type": "object",
3881
+ "additionalProperties": false,
3882
+ "properties": {
3883
+ "sessionId": {
3884
+ "type": "string",
3885
+ "format": "uuid"
3886
+ },
3887
+ "artifactVersionId": {
3888
+ "type": "string",
3889
+ "format": "uuid"
3890
+ },
3891
+ "idempotencyKey": {
3892
+ "type": "string",
3893
+ "minLength": 1,
3894
+ "maxLength": 128,
3895
+ "pattern": "^[A-Za-z0-9._:-]+$"
3896
+ }
3897
+ },
3898
+ "required": [
3899
+ "sessionId",
3900
+ "artifactVersionId",
3901
+ "idempotencyKey"
3902
+ ]
3903
+ },
3904
+ "outputSchema": {
3905
+ "type": "object",
3906
+ "oneOf": [
3907
+ {
3908
+ "type": "object",
3909
+ "properties": {
3910
+ "ok": {
3911
+ "const": true
3912
+ }
3913
+ }
3914
+ },
3915
+ {
3916
+ "type": "object",
3917
+ "properties": {
3918
+ "ok": {
3919
+ "const": false
3920
+ },
3921
+ "error": {
3922
+ "type": "object",
3923
+ "properties": {
3924
+ "code": {
3925
+ "type": "string"
3926
+ },
3927
+ "message": {
3928
+ "type": "string"
3929
+ },
3930
+ "retryable": {
3931
+ "type": "boolean"
3932
+ },
3933
+ "recoveryAction": {
3934
+ "type": "string"
3935
+ }
3936
+ },
3937
+ "required": [
3938
+ "code",
3939
+ "message",
3940
+ "retryable",
3941
+ "recoveryAction"
3942
+ ],
3943
+ "additionalProperties": false
3944
+ }
3945
+ },
3946
+ "required": [
3947
+ "ok",
3948
+ "error"
3949
+ ],
3950
+ "additionalProperties": false
3951
+ }
3952
+ ]
3953
+ },
3954
+ "examples": [
3955
+ {
3956
+ "request": {
3957
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3958
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
3959
+ "idempotencyKey": "example-request"
3960
+ },
3961
+ "success": {}
3962
+ }
3963
+ ]
3964
+ },
3965
+ {
3966
+ "name": "platform_record_acceptance_review",
3967
+ "description": "Record the builder's acceptance review without impersonating the independent validator or removing required checks.",
3968
+ "annotations": {
3969
+ "title": "Platform Record Acceptance Review",
3970
+ "readOnlyHint": false,
3971
+ "destructiveHint": false,
3972
+ "idempotentHint": true,
3973
+ "openWorldHint": true
3974
+ },
3975
+ "inputSchema": {
3976
+ "type": "object",
3977
+ "additionalProperties": false,
3978
+ "properties": {
3979
+ "sessionId": {
3980
+ "type": "string",
3981
+ "format": "uuid"
3982
+ },
3983
+ "artifactVersionId": {
3984
+ "type": "string",
3985
+ "format": "uuid"
3986
+ },
3987
+ "idempotencyKey": {
3988
+ "type": "string",
3989
+ "minLength": 1,
3990
+ "maxLength": 128,
3991
+ "pattern": "^[A-Za-z0-9._:-]+$"
3992
+ },
3993
+ "checkId": {
3994
+ "type": "string",
3995
+ "format": "uuid"
3996
+ },
3997
+ "status": {
3998
+ "type": "string",
3999
+ "enum": [
4000
+ "passed",
4001
+ "failed"
4002
+ ]
4003
+ },
4004
+ "summary": {
4005
+ "type": "string",
4006
+ "minLength": 3,
4007
+ "maxLength": 2000
4008
+ }
4009
+ },
4010
+ "required": [
4011
+ "sessionId",
4012
+ "artifactVersionId",
4013
+ "idempotencyKey",
4014
+ "checkId",
4015
+ "status",
4016
+ "summary"
4017
+ ]
4018
+ },
4019
+ "outputSchema": {
4020
+ "type": "object",
4021
+ "oneOf": [
4022
+ {
4023
+ "type": "object",
4024
+ "properties": {
4025
+ "ok": {
4026
+ "const": true
4027
+ }
4028
+ }
4029
+ },
4030
+ {
4031
+ "type": "object",
4032
+ "properties": {
4033
+ "ok": {
4034
+ "const": false
4035
+ },
4036
+ "error": {
4037
+ "type": "object",
4038
+ "properties": {
4039
+ "code": {
4040
+ "type": "string"
4041
+ },
4042
+ "message": {
4043
+ "type": "string"
4044
+ },
4045
+ "retryable": {
4046
+ "type": "boolean"
4047
+ },
4048
+ "recoveryAction": {
4049
+ "type": "string"
4050
+ }
4051
+ },
4052
+ "required": [
4053
+ "code",
4054
+ "message",
4055
+ "retryable",
4056
+ "recoveryAction"
4057
+ ],
4058
+ "additionalProperties": false
4059
+ }
4060
+ },
4061
+ "required": [
4062
+ "ok",
4063
+ "error"
4064
+ ],
4065
+ "additionalProperties": false
4066
+ }
4067
+ ]
4068
+ },
4069
+ "examples": [
4070
+ {
4071
+ "request": {
4072
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4073
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
4074
+ "idempotencyKey": "example-request",
4075
+ "checkId": "00000000-0000-4000-8000-000000000001",
4076
+ "status": "passed",
4077
+ "summary": "<summary>"
4078
+ },
4079
+ "success": {}
4080
+ }
4081
+ ]
4082
+ },
4083
+ {
4084
+ "name": "platform_prepare_artifact_validation",
4085
+ "description": "Prepare validation evidence for the exact private draft revision; missing required checks block readiness.",
4086
+ "annotations": {
4087
+ "title": "Platform Prepare Artifact Validation",
4088
+ "readOnlyHint": true,
4089
+ "destructiveHint": false,
4090
+ "idempotentHint": true,
4091
+ "openWorldHint": true
4092
+ },
4093
+ "inputSchema": {
4094
+ "type": "object",
4095
+ "additionalProperties": false,
4096
+ "properties": {
4097
+ "sessionId": {
4098
+ "type": "string",
4099
+ "format": "uuid"
4100
+ },
4101
+ "artifactVersionId": {
4102
+ "type": "string",
4103
+ "format": "uuid"
4104
+ },
4105
+ "deploymentRecordId": {
4106
+ "type": "string",
4107
+ "format": "uuid"
4108
+ }
4109
+ },
4110
+ "required": [
4111
+ "sessionId",
4112
+ "artifactVersionId",
4113
+ "deploymentRecordId"
4114
+ ]
4115
+ },
4116
+ "outputSchema": {
4117
+ "type": "object",
4118
+ "oneOf": [
4119
+ {
4120
+ "type": "object",
4121
+ "properties": {
4122
+ "ok": {
4123
+ "const": true
4124
+ }
4125
+ }
4126
+ },
4127
+ {
4128
+ "type": "object",
4129
+ "properties": {
4130
+ "ok": {
4131
+ "const": false
4132
+ },
4133
+ "error": {
4134
+ "type": "object",
4135
+ "properties": {
4136
+ "code": {
4137
+ "type": "string"
4138
+ },
4139
+ "message": {
4140
+ "type": "string"
4141
+ },
4142
+ "retryable": {
4143
+ "type": "boolean"
4144
+ },
4145
+ "recoveryAction": {
4146
+ "type": "string"
4147
+ }
4148
+ },
4149
+ "required": [
4150
+ "code",
4151
+ "message",
4152
+ "retryable",
4153
+ "recoveryAction"
4154
+ ],
4155
+ "additionalProperties": false
4156
+ }
4157
+ },
4158
+ "required": [
4159
+ "ok",
4160
+ "error"
4161
+ ],
4162
+ "additionalProperties": false
4163
+ }
4164
+ ]
4165
+ },
4166
+ "examples": [
4167
+ {
4168
+ "request": {
4169
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4170
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
4171
+ "deploymentRecordId": "00000000-0000-4000-8000-000000000001"
4172
+ },
4173
+ "success": {}
4174
+ }
4175
+ ]
4176
+ },
4177
+ {
4178
+ "name": "platform_request_artifact_validation",
4179
+ "description": "Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval.",
4180
+ "annotations": {
4181
+ "title": "Platform Request Artifact Validation",
4182
+ "readOnlyHint": false,
4183
+ "destructiveHint": false,
4184
+ "idempotentHint": true,
4185
+ "openWorldHint": true
4186
+ },
4187
+ "inputSchema": {
4188
+ "type": "object",
4189
+ "additionalProperties": false,
4190
+ "properties": {
4191
+ "sessionId": {
4192
+ "type": "string",
4193
+ "format": "uuid"
4194
+ },
4195
+ "artifactVersionId": {
4196
+ "type": "string",
4197
+ "format": "uuid"
4198
+ },
4199
+ "idempotencyKey": {
4200
+ "type": "string",
4201
+ "minLength": 1,
4202
+ "maxLength": 128,
4203
+ "pattern": "^[A-Za-z0-9._:-]+$"
4204
+ },
4205
+ "deploymentRecordId": {
4206
+ "type": "string",
4207
+ "format": "uuid"
4208
+ },
4209
+ "summary": {
4210
+ "type": "string",
4211
+ "minLength": 3,
4212
+ "maxLength": 4000
4213
+ },
4214
+ "waitMs": {
4215
+ "type": "integer",
4216
+ "minimum": 0,
4217
+ "maximum": 1000
4218
+ },
4219
+ "buildOk": {
4220
+ "type": "boolean"
4221
+ },
4222
+ "typecheckOk": {
4223
+ "type": "boolean"
4224
+ },
4225
+ "docImpact": {
4226
+ "type": "string",
4227
+ "enum": [
4228
+ "material",
4229
+ "none"
4230
+ ]
4231
+ },
4232
+ "docImpactNotes": {
4233
+ "type": "string",
4234
+ "minLength": 12,
4235
+ "maxLength": 2000
4236
+ },
4237
+ "visualReview": {
4238
+ "type": "object",
4239
+ "additionalProperties": true
4240
+ },
4241
+ "dataValidation": {
4242
+ "type": "object",
4243
+ "additionalProperties": true
4244
+ }
4245
+ },
4246
+ "required": [
4247
+ "sessionId",
4248
+ "artifactVersionId",
4249
+ "idempotencyKey",
4250
+ "deploymentRecordId",
4251
+ "summary",
4252
+ "docImpact",
4253
+ "docImpactNotes",
4254
+ "visualReview"
4255
+ ]
4256
+ },
4257
+ "outputSchema": {
4258
+ "type": "object",
4259
+ "oneOf": [
4260
+ {
4261
+ "type": "object",
4262
+ "properties": {
4263
+ "ok": {
4264
+ "const": true
4265
+ }
4266
+ }
4267
+ },
4268
+ {
4269
+ "type": "object",
4270
+ "properties": {
4271
+ "ok": {
4272
+ "const": false
4273
+ },
4274
+ "error": {
4275
+ "type": "object",
4276
+ "properties": {
4277
+ "code": {
4278
+ "type": "string"
4279
+ },
4280
+ "message": {
4281
+ "type": "string"
4282
+ },
4283
+ "retryable": {
4284
+ "type": "boolean"
4285
+ },
4286
+ "recoveryAction": {
4287
+ "type": "string"
4288
+ }
4289
+ },
4290
+ "required": [
4291
+ "code",
4292
+ "message",
4293
+ "retryable",
4294
+ "recoveryAction"
4295
+ ],
4296
+ "additionalProperties": false
4297
+ }
4298
+ },
4299
+ "required": [
4300
+ "ok",
4301
+ "error"
4302
+ ],
4303
+ "additionalProperties": false
4304
+ }
4305
+ ]
4306
+ },
4307
+ "examples": [
4308
+ {
4309
+ "request": {
4310
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4311
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
4312
+ "idempotencyKey": "example-request",
4313
+ "deploymentRecordId": "00000000-0000-4000-8000-000000000001",
4314
+ "summary": "<summary>",
4315
+ "docImpact": "material",
4316
+ "docImpactNotes": "<docImpactNotes>",
4317
+ "visualReview": {}
4318
+ },
4319
+ "success": {}
4320
+ }
4321
+ ]
4322
+ },
4323
+ {
4324
+ "name": "platform_artifact_validation_status",
4325
+ "description": "Read the original validation result and pending prompts without starting another reviewer or deploy. Current authorization is rechecked before evidence delivery.",
4326
+ "annotations": {
4327
+ "title": "Platform Artifact Validation Status",
4328
+ "readOnlyHint": true,
4329
+ "destructiveHint": false,
4330
+ "idempotentHint": true,
4331
+ "openWorldHint": true
4332
+ },
4333
+ "inputSchema": {
4334
+ "type": "object",
4335
+ "additionalProperties": false,
4336
+ "properties": {
4337
+ "sessionId": {
4338
+ "type": "string",
4339
+ "format": "uuid"
4340
+ },
4341
+ "operationId": {
4342
+ "type": "string",
4343
+ "format": "uuid"
4344
+ }
4345
+ },
4346
+ "required": [
4347
+ "sessionId",
4348
+ "operationId"
4349
+ ]
4350
+ },
4351
+ "outputSchema": {
4352
+ "type": "object",
4353
+ "oneOf": [
4354
+ {
4355
+ "type": "object",
4356
+ "properties": {
4357
+ "ok": {
4358
+ "const": true
4359
+ }
4360
+ }
4361
+ },
4362
+ {
4363
+ "type": "object",
4364
+ "properties": {
4365
+ "ok": {
4366
+ "const": false
4367
+ },
4368
+ "error": {
4369
+ "type": "object",
4370
+ "properties": {
4371
+ "code": {
4372
+ "type": "string"
4373
+ },
4374
+ "message": {
4375
+ "type": "string"
4376
+ },
4377
+ "retryable": {
4378
+ "type": "boolean"
4379
+ },
4380
+ "recoveryAction": {
4381
+ "type": "string"
4382
+ }
4383
+ },
4384
+ "required": [
4385
+ "code",
4386
+ "message",
4387
+ "retryable",
4388
+ "recoveryAction"
4389
+ ],
4390
+ "additionalProperties": false
4391
+ }
4392
+ },
4393
+ "required": [
4394
+ "ok",
4395
+ "error"
4396
+ ],
4397
+ "additionalProperties": false
4398
+ }
4399
+ ]
4400
+ },
4401
+ "examples": [
4402
+ {
4403
+ "request": {
4404
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4405
+ "operationId": "00000000-0000-4000-8000-000000000001"
4406
+ },
4407
+ "success": {}
4408
+ }
4409
+ ]
4410
+ },
4411
+ {
4412
+ "name": "platform_answer_operator_prompt",
4413
+ "description": "Answer the exact saved operator prompt on the original review operation. Appends guidance and reopens the same eligible session; cannot approve validation or widen the saved grant.",
4414
+ "annotations": {
4415
+ "title": "Platform Answer Operator Prompt",
4416
+ "readOnlyHint": false,
4417
+ "destructiveHint": false,
4418
+ "idempotentHint": true,
4419
+ "openWorldHint": true
4420
+ },
4421
+ "inputSchema": {
4422
+ "type": "object",
4423
+ "additionalProperties": false,
4424
+ "properties": {
4425
+ "sessionId": {
4426
+ "type": "string",
4427
+ "format": "uuid"
4428
+ },
4429
+ "operationId": {
4430
+ "type": "string",
4431
+ "format": "uuid"
4432
+ },
4433
+ "promptId": {
4434
+ "type": "string",
4435
+ "format": "uuid"
4436
+ },
4437
+ "idempotencyKey": {
4438
+ "type": "string",
4439
+ "minLength": 1,
4440
+ "maxLength": 128,
4441
+ "pattern": "^[A-Za-z0-9._:-]+$"
4442
+ },
4443
+ "message": {
4444
+ "type": "string",
4445
+ "minLength": 3,
4446
+ "maxLength": 4000
4447
+ }
4448
+ },
4449
+ "required": [
4450
+ "sessionId",
4451
+ "operationId",
4452
+ "promptId",
4453
+ "idempotencyKey",
4454
+ "message"
4455
+ ]
4456
+ },
4457
+ "outputSchema": {
4458
+ "type": "object",
4459
+ "oneOf": [
4460
+ {
4461
+ "type": "object",
4462
+ "properties": {
4463
+ "ok": {
4464
+ "const": true
4465
+ }
4466
+ }
4467
+ },
4468
+ {
4469
+ "type": "object",
4470
+ "properties": {
4471
+ "ok": {
4472
+ "const": false
4473
+ },
4474
+ "error": {
4475
+ "type": "object",
4476
+ "properties": {
4477
+ "code": {
4478
+ "type": "string"
4479
+ },
4480
+ "message": {
4481
+ "type": "string"
4482
+ },
4483
+ "retryable": {
4484
+ "type": "boolean"
4485
+ },
4486
+ "recoveryAction": {
4487
+ "type": "string"
4488
+ }
4489
+ },
4490
+ "required": [
4491
+ "code",
4492
+ "message",
4493
+ "retryable",
4494
+ "recoveryAction"
4495
+ ],
4496
+ "additionalProperties": false
4497
+ }
4498
+ },
4499
+ "required": [
4500
+ "ok",
4501
+ "error"
4502
+ ],
4503
+ "additionalProperties": false
4504
+ }
4505
+ ]
4506
+ },
4507
+ "examples": [
4508
+ {
4509
+ "request": {
4510
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4511
+ "operationId": "00000000-0000-4000-8000-000000000001",
4512
+ "promptId": "00000000-0000-4000-8000-000000000001",
4513
+ "idempotencyKey": "example-request",
4514
+ "message": "<message>"
4515
+ },
4516
+ "success": {}
4517
+ }
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
+ ]
2648
5276
  }
2649
5277
  ]
2650
5278
  }