@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
 
3
3
  > Generated from `src/index.ts#BUILD_MCP_TOOLS`. Do not edit this file by hand.
4
4
 
5
- Package: `@topline-build/harness-mcp@0.5.3`
5
+ Package: `@topline-build/harness-mcp@0.7.0`
6
6
  Transport: `stdio`
7
7
  Default protocol: `2025-11-25`
8
8
  Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -32,7 +32,39 @@ The first authenticated tool call normally opens browser approval. Set `TOPLINE_
32
32
 
33
33
  Tool failures set `isError: true` and return `structuredContent.error` with `code`, `message`, `retryable`, and `recoveryAction`.
34
34
 
35
+ - `capability_unavailable` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
36
+ - `domain_manage_required` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
37
+ - `artifact_not_found` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
38
+ - `artifact_app_required` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
39
+ - `domain_not_found` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
40
+ - `domain_not_connected` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
41
+ - `operation_not_found` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
42
+ - `hostname_required` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
43
+ - `hostname_invalid` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
44
+ - `subdomain_required` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
45
+ - `topline_domain_not_customer_domain` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
46
+ - `path_required` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
47
+ - `path_invalid` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
48
+ - `path_reserved` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
49
+ - `zone_invalid` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
50
+ - `domain_path_in_use` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
51
+ - `domain_already_claimed` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
52
+ - `address_state_changed` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
53
+ - `domain_state_changed` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
54
+ - `plan_expired` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
55
+ - `plan_already_used` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
56
+ - `verification_interrupted` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
57
+ - `verification_pending` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
58
+ - `verification_rate_limited` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
59
+ - `waiting_for_dns` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
60
+ - `idempotency_conflict` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
61
+ - `domain_setup_limit` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
62
+ - `domain_operation_failed` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
63
+ - `invalid_arguments` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
35
64
  - `authorization_required` (not automatically retryable): Clear only this connection's cached OAuth credentials, then reconnect the Build MCP through browser sign-in. If using a manual bearer token, replace the expired or revoked token. Recover existing artifact/deployment progress before retrying a write.
65
+ - `scope_required` (not automatically retryable): Reconnect the Build MCP and approve the requested scope.
66
+ - `domain_tools_require_build_oauth` (not automatically retryable): Read current domain/address state and the original receipt with the saved pre-call key. Retain the exact original input. Review changed state, scopes or configuration before any new plan/key; never assume a rejected delivery means no effect.
67
+ - `domain_result_unknown` (not automatically retryable): The response did not establish an outcome. Recover the original receipt through platform_get_artifact_address (saved artifactId and apply key) or platform_read_artifact_domains (request/verify kind and key). Preserve the original plan/domain/input/key; an absent, pending or expired receipt does not authorize a fresh key. No mutation is replayed automatically.
36
68
  - `platform_harness_timeout` (retryable): Retry the call. For a deployment, use platform_list_artifact_drafts to recover the artifact and platform_wait_artifact_deploy to resume progress.
37
69
  - `platform_mcp_tool_error` (not automatically retryable): Read the returned error code, correct the request or OAuth scopes, then retry.
38
70
  - `artifact_deploy_wait_timeout` (retryable): Call platform_wait_artifact_deploy again with the same artifactId and operationId.
@@ -42,7 +74,6 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
42
74
  - `artifact_app_auth_file_inside_app_dir` (not automatically retryable): Move TOPLINE_MCP_AUTH_FILE outside appDir, reconnect the Build MCP, then inspect again.
43
75
  - `artifact_app_manifest_not_found` (not automatically retryable): Create artifact-app.json inside appDir, or correct appDir, then inspect again.
44
76
  - `artifact_app_manifest_too_large` (not automatically retryable): Keep artifact-app.json below 512 KiB. Move application data and source into separate files, then inspect again.
45
- - `scope_required` (not automatically retryable): Reconnect the Build MCP and approve the requested scope.
46
77
  - `artifact_app_scaffold_target_not_empty` (not automatically retryable): Choose an empty appDir or deploy the existing app without scaffolding.
47
78
 
48
79
  ## Tools
@@ -359,6 +390,31 @@ Input schema:
359
390
  "minLength": 1,
360
391
  "maxLength": 128,
361
392
  "description": "Optional stable retry key; generated deterministically when omitted."
393
+ },
394
+ "sessionId": {
395
+ "type": "string",
396
+ "format": "uuid"
397
+ },
398
+ "artifactVersionId": {
399
+ "type": "string",
400
+ "format": "uuid",
401
+ "description": "Exact current version from the session or checkout; required with sessionId."
402
+ },
403
+ "idempotencyKey": {
404
+ "type": "string",
405
+ "minLength": 1,
406
+ "maxLength": 128,
407
+ "pattern": "^[A-Za-z0-9._:-]+$"
408
+ },
409
+ "inspectedSourceHash": {
410
+ "type": "string",
411
+ "pattern": "^[0-9a-fA-F]{64}$",
412
+ "description": "Echo the session/source checkout hash; required with sessionId. expectedBundleSha256 separately pins the newly inspected local upload."
413
+ },
414
+ "platformAppDir": {
415
+ "type": "string",
416
+ "minLength": 1,
417
+ "description": "Saved remote app root from an existing-app checkout. Session mode only; preserve this when the local checkout directory has a different name."
362
418
  }
363
419
  },
364
420
  "required": [
@@ -495,6 +551,11 @@ Input schema:
495
551
  "appDir": {
496
552
  "type": "string",
497
553
  "minLength": 1
554
+ },
555
+ "platformAppDir": {
556
+ "type": "string",
557
+ "minLength": 1,
558
+ "description": "Preserve the saved remote source root returned by checkout when inspecting an existing app."
498
559
  }
499
560
  },
500
561
  "required": [
@@ -2710,3 +2771,2700 @@ Output schema:
2710
2771
  ]
2711
2772
  }
2712
2773
  ```
2774
+
2775
+ ### `platform_capability_status`
2776
+
2777
+ 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.
2778
+
2779
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
2780
+
2781
+ Example request:
2782
+
2783
+ ```json
2784
+ {}
2785
+ ```
2786
+
2787
+ Example success:
2788
+
2789
+ ```json
2790
+ {}
2791
+ ```
2792
+
2793
+ Input schema:
2794
+
2795
+ ```json
2796
+ {
2797
+ "type": "object",
2798
+ "additionalProperties": false,
2799
+ "properties": {},
2800
+ "required": []
2801
+ }
2802
+ ```
2803
+
2804
+ Output schema:
2805
+
2806
+ ```json
2807
+ {
2808
+ "type": "object",
2809
+ "oneOf": [
2810
+ {
2811
+ "type": "object",
2812
+ "properties": {
2813
+ "ok": {
2814
+ "const": true
2815
+ }
2816
+ }
2817
+ },
2818
+ {
2819
+ "type": "object",
2820
+ "properties": {
2821
+ "ok": {
2822
+ "const": false
2823
+ },
2824
+ "error": {
2825
+ "type": "object",
2826
+ "properties": {
2827
+ "code": {
2828
+ "type": "string"
2829
+ },
2830
+ "message": {
2831
+ "type": "string"
2832
+ },
2833
+ "retryable": {
2834
+ "type": "boolean"
2835
+ },
2836
+ "recoveryAction": {
2837
+ "type": "string"
2838
+ }
2839
+ },
2840
+ "required": [
2841
+ "code",
2842
+ "message",
2843
+ "retryable",
2844
+ "recoveryAction"
2845
+ ],
2846
+ "additionalProperties": false
2847
+ }
2848
+ },
2849
+ "required": [
2850
+ "ok",
2851
+ "error"
2852
+ ],
2853
+ "additionalProperties": false
2854
+ }
2855
+ ]
2856
+ }
2857
+ ```
2858
+
2859
+ ### `platform_start_build_session`
2860
+
2861
+ 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.
2862
+
2863
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
2864
+
2865
+ Example request:
2866
+
2867
+ ```json
2868
+ {
2869
+ "idempotencyKey": "example-request",
2870
+ "budgetCents": 0,
2871
+ "brief": "<brief>"
2872
+ }
2873
+ ```
2874
+
2875
+ Example success:
2876
+
2877
+ ```json
2878
+ {}
2879
+ ```
2880
+
2881
+ Input schema:
2882
+
2883
+ ```json
2884
+ {
2885
+ "type": "object",
2886
+ "additionalProperties": false,
2887
+ "properties": {
2888
+ "idempotencyKey": {
2889
+ "type": "string",
2890
+ "minLength": 1,
2891
+ "maxLength": 128,
2892
+ "pattern": "^[A-Za-z0-9._:-]+$"
2893
+ },
2894
+ "artifactId": {
2895
+ "type": "string",
2896
+ "format": "uuid"
2897
+ },
2898
+ "artifactVersionId": {
2899
+ "type": "string",
2900
+ "format": "uuid"
2901
+ },
2902
+ "manifest": {
2903
+ "type": "object"
2904
+ },
2905
+ "projectId": {
2906
+ "type": "string",
2907
+ "format": "uuid"
2908
+ },
2909
+ "owningConversationId": {
2910
+ "type": "string",
2911
+ "format": "uuid"
2912
+ },
2913
+ "budgetCents": {
2914
+ "type": "integer",
2915
+ "minimum": 0,
2916
+ "maximum": 100000
2917
+ },
2918
+ "brief": {
2919
+ "type": "string",
2920
+ "minLength": 3,
2921
+ "maxLength": 4000
2922
+ }
2923
+ },
2924
+ "required": [
2925
+ "idempotencyKey",
2926
+ "budgetCents",
2927
+ "brief"
2928
+ ]
2929
+ }
2930
+ ```
2931
+
2932
+ Output schema:
2933
+
2934
+ ```json
2935
+ {
2936
+ "type": "object",
2937
+ "oneOf": [
2938
+ {
2939
+ "type": "object",
2940
+ "properties": {
2941
+ "ok": {
2942
+ "const": true
2943
+ }
2944
+ }
2945
+ },
2946
+ {
2947
+ "type": "object",
2948
+ "properties": {
2949
+ "ok": {
2950
+ "const": false
2951
+ },
2952
+ "error": {
2953
+ "type": "object",
2954
+ "properties": {
2955
+ "code": {
2956
+ "type": "string"
2957
+ },
2958
+ "message": {
2959
+ "type": "string"
2960
+ },
2961
+ "retryable": {
2962
+ "type": "boolean"
2963
+ },
2964
+ "recoveryAction": {
2965
+ "type": "string"
2966
+ }
2967
+ },
2968
+ "required": [
2969
+ "code",
2970
+ "message",
2971
+ "retryable",
2972
+ "recoveryAction"
2973
+ ],
2974
+ "additionalProperties": false
2975
+ }
2976
+ },
2977
+ "required": [
2978
+ "ok",
2979
+ "error"
2980
+ ],
2981
+ "additionalProperties": false
2982
+ }
2983
+ ]
2984
+ }
2985
+ ```
2986
+
2987
+ ### `platform_read_build_session`
2988
+
2989
+ Read the owned build session and original pending operations. Does not start another coder or deployment.
2990
+
2991
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
2992
+
2993
+ Example request:
2994
+
2995
+ ```json
2996
+ {
2997
+ "sessionId": "00000000-0000-4000-8000-000000000001"
2998
+ }
2999
+ ```
3000
+
3001
+ Example success:
3002
+
3003
+ ```json
3004
+ {}
3005
+ ```
3006
+
3007
+ Input schema:
3008
+
3009
+ ```json
3010
+ {
3011
+ "type": "object",
3012
+ "additionalProperties": false,
3013
+ "properties": {
3014
+ "sessionId": {
3015
+ "type": "string",
3016
+ "format": "uuid"
3017
+ }
3018
+ },
3019
+ "required": [
3020
+ "sessionId"
3021
+ ]
3022
+ }
3023
+ ```
3024
+
3025
+ Output schema:
3026
+
3027
+ ```json
3028
+ {
3029
+ "type": "object",
3030
+ "oneOf": [
3031
+ {
3032
+ "type": "object",
3033
+ "properties": {
3034
+ "ok": {
3035
+ "const": true
3036
+ }
3037
+ }
3038
+ },
3039
+ {
3040
+ "type": "object",
3041
+ "properties": {
3042
+ "ok": {
3043
+ "const": false
3044
+ },
3045
+ "error": {
3046
+ "type": "object",
3047
+ "properties": {
3048
+ "code": {
3049
+ "type": "string"
3050
+ },
3051
+ "message": {
3052
+ "type": "string"
3053
+ },
3054
+ "retryable": {
3055
+ "type": "boolean"
3056
+ },
3057
+ "recoveryAction": {
3058
+ "type": "string"
3059
+ }
3060
+ },
3061
+ "required": [
3062
+ "code",
3063
+ "message",
3064
+ "retryable",
3065
+ "recoveryAction"
3066
+ ],
3067
+ "additionalProperties": false
3068
+ }
3069
+ },
3070
+ "required": [
3071
+ "ok",
3072
+ "error"
3073
+ ],
3074
+ "additionalProperties": false
3075
+ }
3076
+ ]
3077
+ }
3078
+ ```
3079
+
3080
+ ### `platform_close_build_session`
3081
+
3082
+ Stop new authoring and request pending-operation cancellation. Unknown effects retain their reservation; cancellation does not undo committed writes.
3083
+
3084
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3085
+
3086
+ Example request:
3087
+
3088
+ ```json
3089
+ {
3090
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3091
+ }
3092
+ ```
3093
+
3094
+ Example success:
3095
+
3096
+ ```json
3097
+ {}
3098
+ ```
3099
+
3100
+ Input schema:
3101
+
3102
+ ```json
3103
+ {
3104
+ "type": "object",
3105
+ "additionalProperties": false,
3106
+ "properties": {
3107
+ "sessionId": {
3108
+ "type": "string",
3109
+ "format": "uuid"
3110
+ }
3111
+ },
3112
+ "required": [
3113
+ "sessionId"
3114
+ ]
3115
+ }
3116
+ ```
3117
+
3118
+ Output schema:
3119
+
3120
+ ```json
3121
+ {
3122
+ "type": "object",
3123
+ "oneOf": [
3124
+ {
3125
+ "type": "object",
3126
+ "properties": {
3127
+ "ok": {
3128
+ "const": true
3129
+ }
3130
+ }
3131
+ },
3132
+ {
3133
+ "type": "object",
3134
+ "properties": {
3135
+ "ok": {
3136
+ "const": false
3137
+ },
3138
+ "error": {
3139
+ "type": "object",
3140
+ "properties": {
3141
+ "code": {
3142
+ "type": "string"
3143
+ },
3144
+ "message": {
3145
+ "type": "string"
3146
+ },
3147
+ "retryable": {
3148
+ "type": "boolean"
3149
+ },
3150
+ "recoveryAction": {
3151
+ "type": "string"
3152
+ }
3153
+ },
3154
+ "required": [
3155
+ "code",
3156
+ "message",
3157
+ "retryable",
3158
+ "recoveryAction"
3159
+ ],
3160
+ "additionalProperties": false
3161
+ }
3162
+ },
3163
+ "required": [
3164
+ "ok",
3165
+ "error"
3166
+ ],
3167
+ "additionalProperties": false
3168
+ }
3169
+ ]
3170
+ }
3171
+ ```
3172
+
3173
+ ### `platform_run_artifact_workspace_sql`
3174
+
3175
+ 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.
3176
+
3177
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3178
+
3179
+ Example request:
3180
+
3181
+ ```json
3182
+ {
3183
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3184
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
3185
+ "idempotencyKey": "example-request",
3186
+ "sql": "<sql>",
3187
+ "purpose": "<purpose>"
3188
+ }
3189
+ ```
3190
+
3191
+ Example success:
3192
+
3193
+ ```json
3194
+ {}
3195
+ ```
3196
+
3197
+ Input schema:
3198
+
3199
+ ```json
3200
+ {
3201
+ "type": "object",
3202
+ "additionalProperties": false,
3203
+ "properties": {
3204
+ "sessionId": {
3205
+ "type": "string",
3206
+ "format": "uuid"
3207
+ },
3208
+ "artifactVersionId": {
3209
+ "type": "string",
3210
+ "format": "uuid"
3211
+ },
3212
+ "idempotencyKey": {
3213
+ "type": "string",
3214
+ "minLength": 1,
3215
+ "maxLength": 128,
3216
+ "pattern": "^[A-Za-z0-9._:-]+$"
3217
+ },
3218
+ "sql": {
3219
+ "type": "string",
3220
+ "minLength": 1,
3221
+ "maxLength": 20000
3222
+ },
3223
+ "purpose": {
3224
+ "type": "string",
3225
+ "minLength": 3,
3226
+ "maxLength": 500
3227
+ },
3228
+ "params": {
3229
+ "type": "object",
3230
+ "additionalProperties": true
3231
+ },
3232
+ "maxRows": {
3233
+ "type": "integer",
3234
+ "minimum": 1,
3235
+ "maximum": 5000
3236
+ },
3237
+ "documentation": {
3238
+ "type": "object"
3239
+ },
3240
+ "columnDocumentation": {
3241
+ "type": "object"
3242
+ }
3243
+ },
3244
+ "required": [
3245
+ "sessionId",
3246
+ "artifactVersionId",
3247
+ "idempotencyKey",
3248
+ "sql",
3249
+ "purpose"
3250
+ ]
3251
+ }
3252
+ ```
3253
+
3254
+ Output schema:
3255
+
3256
+ ```json
3257
+ {
3258
+ "type": "object",
3259
+ "oneOf": [
3260
+ {
3261
+ "type": "object",
3262
+ "properties": {
3263
+ "ok": {
3264
+ "const": true
3265
+ }
3266
+ }
3267
+ },
3268
+ {
3269
+ "type": "object",
3270
+ "properties": {
3271
+ "ok": {
3272
+ "const": false
3273
+ },
3274
+ "error": {
3275
+ "type": "object",
3276
+ "properties": {
3277
+ "code": {
3278
+ "type": "string"
3279
+ },
3280
+ "message": {
3281
+ "type": "string"
3282
+ },
3283
+ "retryable": {
3284
+ "type": "boolean"
3285
+ },
3286
+ "recoveryAction": {
3287
+ "type": "string"
3288
+ }
3289
+ },
3290
+ "required": [
3291
+ "code",
3292
+ "message",
3293
+ "retryable",
3294
+ "recoveryAction"
3295
+ ],
3296
+ "additionalProperties": false
3297
+ }
3298
+ },
3299
+ "required": [
3300
+ "ok",
3301
+ "error"
3302
+ ],
3303
+ "additionalProperties": false
3304
+ }
3305
+ ]
3306
+ }
3307
+ ```
3308
+
3309
+ ### `platform_checkout_artifact_app`
3310
+
3311
+ 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.
3312
+
3313
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3314
+
3315
+ Example request:
3316
+
3317
+ ```json
3318
+ {
3319
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3320
+ "targetDir": "<targetDir>"
3321
+ }
3322
+ ```
3323
+
3324
+ Example success:
3325
+
3326
+ ```json
3327
+ {}
3328
+ ```
3329
+
3330
+ Input schema:
3331
+
3332
+ ```json
3333
+ {
3334
+ "type": "object",
3335
+ "additionalProperties": false,
3336
+ "properties": {
3337
+ "sessionId": {
3338
+ "type": "string",
3339
+ "format": "uuid"
3340
+ },
3341
+ "targetDir": {
3342
+ "type": "string",
3343
+ "minLength": 1
3344
+ }
3345
+ },
3346
+ "required": [
3347
+ "sessionId",
3348
+ "targetDir"
3349
+ ]
3350
+ }
3351
+ ```
3352
+
3353
+ Output schema:
3354
+
3355
+ ```json
3356
+ {
3357
+ "type": "object",
3358
+ "oneOf": [
3359
+ {
3360
+ "type": "object",
3361
+ "properties": {
3362
+ "ok": {
3363
+ "const": true
3364
+ }
3365
+ }
3366
+ },
3367
+ {
3368
+ "type": "object",
3369
+ "properties": {
3370
+ "ok": {
3371
+ "const": false
3372
+ },
3373
+ "error": {
3374
+ "type": "object",
3375
+ "properties": {
3376
+ "code": {
3377
+ "type": "string"
3378
+ },
3379
+ "message": {
3380
+ "type": "string"
3381
+ },
3382
+ "retryable": {
3383
+ "type": "boolean"
3384
+ },
3385
+ "recoveryAction": {
3386
+ "type": "string"
3387
+ }
3388
+ },
3389
+ "required": [
3390
+ "code",
3391
+ "message",
3392
+ "retryable",
3393
+ "recoveryAction"
3394
+ ],
3395
+ "additionalProperties": false
3396
+ }
3397
+ },
3398
+ "required": [
3399
+ "ok",
3400
+ "error"
3401
+ ],
3402
+ "additionalProperties": false
3403
+ }
3404
+ ]
3405
+ }
3406
+ ```
3407
+
3408
+ ### `platform_list_asset_folders`
3409
+
3410
+ List the session's permitted reusable asset folders.
3411
+
3412
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
3413
+
3414
+ Example request:
3415
+
3416
+ ```json
3417
+ {
3418
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3419
+ }
3420
+ ```
3421
+
3422
+ Example success:
3423
+
3424
+ ```json
3425
+ {}
3426
+ ```
3427
+
3428
+ Input schema:
3429
+
3430
+ ```json
3431
+ {
3432
+ "type": "object",
3433
+ "additionalProperties": false,
3434
+ "properties": {
3435
+ "sessionId": {
3436
+ "type": "string",
3437
+ "format": "uuid"
3438
+ }
3439
+ },
3440
+ "required": [
3441
+ "sessionId"
3442
+ ]
3443
+ }
3444
+ ```
3445
+
3446
+ Output schema:
3447
+
3448
+ ```json
3449
+ {
3450
+ "type": "object",
3451
+ "oneOf": [
3452
+ {
3453
+ "type": "object",
3454
+ "properties": {
3455
+ "ok": {
3456
+ "const": true
3457
+ }
3458
+ }
3459
+ },
3460
+ {
3461
+ "type": "object",
3462
+ "properties": {
3463
+ "ok": {
3464
+ "const": false
3465
+ },
3466
+ "error": {
3467
+ "type": "object",
3468
+ "properties": {
3469
+ "code": {
3470
+ "type": "string"
3471
+ },
3472
+ "message": {
3473
+ "type": "string"
3474
+ },
3475
+ "retryable": {
3476
+ "type": "boolean"
3477
+ },
3478
+ "recoveryAction": {
3479
+ "type": "string"
3480
+ }
3481
+ },
3482
+ "required": [
3483
+ "code",
3484
+ "message",
3485
+ "retryable",
3486
+ "recoveryAction"
3487
+ ],
3488
+ "additionalProperties": false
3489
+ }
3490
+ },
3491
+ "required": [
3492
+ "ok",
3493
+ "error"
3494
+ ],
3495
+ "additionalProperties": false
3496
+ }
3497
+ ]
3498
+ }
3499
+ ```
3500
+
3501
+ ### `platform_list_assets`
3502
+
3503
+ List permitted reusable asset metadata with bounded pagination; excluded/deleted attachments are omitted.
3504
+
3505
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
3506
+
3507
+ Example request:
3508
+
3509
+ ```json
3510
+ {
3511
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3512
+ }
3513
+ ```
3514
+
3515
+ Example success:
3516
+
3517
+ ```json
3518
+ {}
3519
+ ```
3520
+
3521
+ Input schema:
3522
+
3523
+ ```json
3524
+ {
3525
+ "type": "object",
3526
+ "additionalProperties": false,
3527
+ "properties": {
3528
+ "sessionId": {
3529
+ "type": "string",
3530
+ "format": "uuid"
3531
+ },
3532
+ "query": {
3533
+ "type": "string",
3534
+ "maxLength": 200
3535
+ },
3536
+ "folderId": {
3537
+ "type": "string",
3538
+ "format": "uuid"
3539
+ },
3540
+ "limit": {
3541
+ "type": "integer",
3542
+ "minimum": 1,
3543
+ "maximum": 500
3544
+ },
3545
+ "offset": {
3546
+ "type": "integer",
3547
+ "minimum": 0
3548
+ }
3549
+ },
3550
+ "required": [
3551
+ "sessionId"
3552
+ ]
3553
+ }
3554
+ ```
3555
+
3556
+ Output schema:
3557
+
3558
+ ```json
3559
+ {
3560
+ "type": "object",
3561
+ "oneOf": [
3562
+ {
3563
+ "type": "object",
3564
+ "properties": {
3565
+ "ok": {
3566
+ "const": true
3567
+ }
3568
+ }
3569
+ },
3570
+ {
3571
+ "type": "object",
3572
+ "properties": {
3573
+ "ok": {
3574
+ "const": false
3575
+ },
3576
+ "error": {
3577
+ "type": "object",
3578
+ "properties": {
3579
+ "code": {
3580
+ "type": "string"
3581
+ },
3582
+ "message": {
3583
+ "type": "string"
3584
+ },
3585
+ "retryable": {
3586
+ "type": "boolean"
3587
+ },
3588
+ "recoveryAction": {
3589
+ "type": "string"
3590
+ }
3591
+ },
3592
+ "required": [
3593
+ "code",
3594
+ "message",
3595
+ "retryable",
3596
+ "recoveryAction"
3597
+ ],
3598
+ "additionalProperties": false
3599
+ }
3600
+ },
3601
+ "required": [
3602
+ "ok",
3603
+ "error"
3604
+ ],
3605
+ "additionalProperties": false
3606
+ }
3607
+ ]
3608
+ }
3609
+ ```
3610
+
3611
+ ### `platform_materialize_assets`
3612
+
3613
+ Download exactly selected approved files into a new local directory. Verify each authenticated transfer's hash and size; source and attachment budgets remain separate.
3614
+
3615
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3616
+
3617
+ Example request:
3618
+
3619
+ ```json
3620
+ {
3621
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3622
+ "assetIds": [
3623
+ "00000000-0000-4000-8000-000000000001"
3624
+ ],
3625
+ "targetDir": "<targetDir>"
3626
+ }
3627
+ ```
3628
+
3629
+ Example success:
3630
+
3631
+ ```json
3632
+ {}
3633
+ ```
3634
+
3635
+ Input schema:
3636
+
3637
+ ```json
3638
+ {
3639
+ "type": "object",
3640
+ "additionalProperties": false,
3641
+ "properties": {
3642
+ "sessionId": {
3643
+ "type": "string",
3644
+ "format": "uuid"
3645
+ },
3646
+ "assetIds": {
3647
+ "type": "array",
3648
+ "minItems": 1,
3649
+ "maxItems": 50,
3650
+ "uniqueItems": true,
3651
+ "items": {
3652
+ "type": "string",
3653
+ "format": "uuid"
3654
+ }
3655
+ },
3656
+ "targetDir": {
3657
+ "type": "string",
3658
+ "minLength": 1
3659
+ }
3660
+ },
3661
+ "required": [
3662
+ "sessionId",
3663
+ "assetIds",
3664
+ "targetDir"
3665
+ ]
3666
+ }
3667
+ ```
3668
+
3669
+ Output schema:
3670
+
3671
+ ```json
3672
+ {
3673
+ "type": "object",
3674
+ "oneOf": [
3675
+ {
3676
+ "type": "object",
3677
+ "properties": {
3678
+ "ok": {
3679
+ "const": true
3680
+ }
3681
+ }
3682
+ },
3683
+ {
3684
+ "type": "object",
3685
+ "properties": {
3686
+ "ok": {
3687
+ "const": false
3688
+ },
3689
+ "error": {
3690
+ "type": "object",
3691
+ "properties": {
3692
+ "code": {
3693
+ "type": "string"
3694
+ },
3695
+ "message": {
3696
+ "type": "string"
3697
+ },
3698
+ "retryable": {
3699
+ "type": "boolean"
3700
+ },
3701
+ "recoveryAction": {
3702
+ "type": "string"
3703
+ }
3704
+ },
3705
+ "required": [
3706
+ "code",
3707
+ "message",
3708
+ "retryable",
3709
+ "recoveryAction"
3710
+ ],
3711
+ "additionalProperties": false
3712
+ }
3713
+ },
3714
+ "required": [
3715
+ "ok",
3716
+ "error"
3717
+ ],
3718
+ "additionalProperties": false
3719
+ }
3720
+ ]
3721
+ }
3722
+ ```
3723
+
3724
+ ### `platform_list_build_secrets`
3725
+
3726
+ Read only exact operator-approved binding references for this session. Values are never retrieved. Authoring detach does not prove deployed runtime revocation.
3727
+
3728
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
3729
+
3730
+ Example request:
3731
+
3732
+ ```json
3733
+ {
3734
+ "sessionId": "00000000-0000-4000-8000-000000000001"
3735
+ }
3736
+ ```
3737
+
3738
+ Example success:
3739
+
3740
+ ```json
3741
+ {}
3742
+ ```
3743
+
3744
+ Input schema:
3745
+
3746
+ ```json
3747
+ {
3748
+ "type": "object",
3749
+ "additionalProperties": false,
3750
+ "properties": {
3751
+ "sessionId": {
3752
+ "type": "string",
3753
+ "format": "uuid"
3754
+ }
3755
+ },
3756
+ "required": [
3757
+ "sessionId"
3758
+ ]
3759
+ }
3760
+ ```
3761
+
3762
+ Output schema:
3763
+
3764
+ ```json
3765
+ {
3766
+ "type": "object",
3767
+ "oneOf": [
3768
+ {
3769
+ "type": "object",
3770
+ "properties": {
3771
+ "ok": {
3772
+ "const": true
3773
+ }
3774
+ }
3775
+ },
3776
+ {
3777
+ "type": "object",
3778
+ "properties": {
3779
+ "ok": {
3780
+ "const": false
3781
+ },
3782
+ "error": {
3783
+ "type": "object",
3784
+ "properties": {
3785
+ "code": {
3786
+ "type": "string"
3787
+ },
3788
+ "message": {
3789
+ "type": "string"
3790
+ },
3791
+ "retryable": {
3792
+ "type": "boolean"
3793
+ },
3794
+ "recoveryAction": {
3795
+ "type": "string"
3796
+ }
3797
+ },
3798
+ "required": [
3799
+ "code",
3800
+ "message",
3801
+ "retryable",
3802
+ "recoveryAction"
3803
+ ],
3804
+ "additionalProperties": false
3805
+ }
3806
+ },
3807
+ "required": [
3808
+ "ok",
3809
+ "error"
3810
+ ],
3811
+ "additionalProperties": false
3812
+ }
3813
+ ]
3814
+ }
3815
+ ```
3816
+
3817
+ ### `platform_add_acceptance_check`
3818
+
3819
+ Add a required acceptance check bound to this build session and deployed revision. A semantic control query requires separate Build data-verification consent.
3820
+
3821
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3822
+
3823
+ Example request:
3824
+
3825
+ ```json
3826
+ {
3827
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3828
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
3829
+ "idempotencyKey": "example-request",
3830
+ "description": "<description>"
3831
+ }
3832
+ ```
3833
+
3834
+ Example success:
3835
+
3836
+ ```json
3837
+ {}
3838
+ ```
3839
+
3840
+ Input schema:
3841
+
3842
+ ```json
3843
+ {
3844
+ "type": "object",
3845
+ "additionalProperties": false,
3846
+ "properties": {
3847
+ "sessionId": {
3848
+ "type": "string",
3849
+ "format": "uuid"
3850
+ },
3851
+ "artifactVersionId": {
3852
+ "type": "string",
3853
+ "format": "uuid"
3854
+ },
3855
+ "idempotencyKey": {
3856
+ "type": "string",
3857
+ "minLength": 1,
3858
+ "maxLength": 128,
3859
+ "pattern": "^[A-Za-z0-9._:-]+$"
3860
+ },
3861
+ "description": {
3862
+ "type": "string",
3863
+ "minLength": 3,
3864
+ "maxLength": 1000
3865
+ }
3866
+ },
3867
+ "required": [
3868
+ "sessionId",
3869
+ "artifactVersionId",
3870
+ "idempotencyKey",
3871
+ "description"
3872
+ ]
3873
+ }
3874
+ ```
3875
+
3876
+ Output schema:
3877
+
3878
+ ```json
3879
+ {
3880
+ "type": "object",
3881
+ "oneOf": [
3882
+ {
3883
+ "type": "object",
3884
+ "properties": {
3885
+ "ok": {
3886
+ "const": true
3887
+ }
3888
+ }
3889
+ },
3890
+ {
3891
+ "type": "object",
3892
+ "properties": {
3893
+ "ok": {
3894
+ "const": false
3895
+ },
3896
+ "error": {
3897
+ "type": "object",
3898
+ "properties": {
3899
+ "code": {
3900
+ "type": "string"
3901
+ },
3902
+ "message": {
3903
+ "type": "string"
3904
+ },
3905
+ "retryable": {
3906
+ "type": "boolean"
3907
+ },
3908
+ "recoveryAction": {
3909
+ "type": "string"
3910
+ }
3911
+ },
3912
+ "required": [
3913
+ "code",
3914
+ "message",
3915
+ "retryable",
3916
+ "recoveryAction"
3917
+ ],
3918
+ "additionalProperties": false
3919
+ }
3920
+ },
3921
+ "required": [
3922
+ "ok",
3923
+ "error"
3924
+ ],
3925
+ "additionalProperties": false
3926
+ }
3927
+ ]
3928
+ }
3929
+ ```
3930
+
3931
+ ### `platform_run_acceptance_checks`
3932
+
3933
+ Run required acceptance checks for the exact current draft revision through the shared service.
3934
+
3935
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3936
+
3937
+ Example request:
3938
+
3939
+ ```json
3940
+ {
3941
+ "sessionId": "00000000-0000-4000-8000-000000000001",
3942
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
3943
+ "idempotencyKey": "example-request"
3944
+ }
3945
+ ```
3946
+
3947
+ Example success:
3948
+
3949
+ ```json
3950
+ {}
3951
+ ```
3952
+
3953
+ Input schema:
3954
+
3955
+ ```json
3956
+ {
3957
+ "type": "object",
3958
+ "additionalProperties": false,
3959
+ "properties": {
3960
+ "sessionId": {
3961
+ "type": "string",
3962
+ "format": "uuid"
3963
+ },
3964
+ "artifactVersionId": {
3965
+ "type": "string",
3966
+ "format": "uuid"
3967
+ },
3968
+ "idempotencyKey": {
3969
+ "type": "string",
3970
+ "minLength": 1,
3971
+ "maxLength": 128,
3972
+ "pattern": "^[A-Za-z0-9._:-]+$"
3973
+ }
3974
+ },
3975
+ "required": [
3976
+ "sessionId",
3977
+ "artifactVersionId",
3978
+ "idempotencyKey"
3979
+ ]
3980
+ }
3981
+ ```
3982
+
3983
+ Output schema:
3984
+
3985
+ ```json
3986
+ {
3987
+ "type": "object",
3988
+ "oneOf": [
3989
+ {
3990
+ "type": "object",
3991
+ "properties": {
3992
+ "ok": {
3993
+ "const": true
3994
+ }
3995
+ }
3996
+ },
3997
+ {
3998
+ "type": "object",
3999
+ "properties": {
4000
+ "ok": {
4001
+ "const": false
4002
+ },
4003
+ "error": {
4004
+ "type": "object",
4005
+ "properties": {
4006
+ "code": {
4007
+ "type": "string"
4008
+ },
4009
+ "message": {
4010
+ "type": "string"
4011
+ },
4012
+ "retryable": {
4013
+ "type": "boolean"
4014
+ },
4015
+ "recoveryAction": {
4016
+ "type": "string"
4017
+ }
4018
+ },
4019
+ "required": [
4020
+ "code",
4021
+ "message",
4022
+ "retryable",
4023
+ "recoveryAction"
4024
+ ],
4025
+ "additionalProperties": false
4026
+ }
4027
+ },
4028
+ "required": [
4029
+ "ok",
4030
+ "error"
4031
+ ],
4032
+ "additionalProperties": false
4033
+ }
4034
+ ]
4035
+ }
4036
+ ```
4037
+
4038
+ ### `platform_record_acceptance_review`
4039
+
4040
+ Record the builder's acceptance review without impersonating the independent validator or removing required checks.
4041
+
4042
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4043
+
4044
+ Example request:
4045
+
4046
+ ```json
4047
+ {
4048
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4049
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
4050
+ "idempotencyKey": "example-request",
4051
+ "checkId": "00000000-0000-4000-8000-000000000001",
4052
+ "status": "passed",
4053
+ "summary": "<summary>"
4054
+ }
4055
+ ```
4056
+
4057
+ Example success:
4058
+
4059
+ ```json
4060
+ {}
4061
+ ```
4062
+
4063
+ Input schema:
4064
+
4065
+ ```json
4066
+ {
4067
+ "type": "object",
4068
+ "additionalProperties": false,
4069
+ "properties": {
4070
+ "sessionId": {
4071
+ "type": "string",
4072
+ "format": "uuid"
4073
+ },
4074
+ "artifactVersionId": {
4075
+ "type": "string",
4076
+ "format": "uuid"
4077
+ },
4078
+ "idempotencyKey": {
4079
+ "type": "string",
4080
+ "minLength": 1,
4081
+ "maxLength": 128,
4082
+ "pattern": "^[A-Za-z0-9._:-]+$"
4083
+ },
4084
+ "checkId": {
4085
+ "type": "string",
4086
+ "format": "uuid"
4087
+ },
4088
+ "status": {
4089
+ "type": "string",
4090
+ "enum": [
4091
+ "passed",
4092
+ "failed"
4093
+ ]
4094
+ },
4095
+ "summary": {
4096
+ "type": "string",
4097
+ "minLength": 3,
4098
+ "maxLength": 2000
4099
+ }
4100
+ },
4101
+ "required": [
4102
+ "sessionId",
4103
+ "artifactVersionId",
4104
+ "idempotencyKey",
4105
+ "checkId",
4106
+ "status",
4107
+ "summary"
4108
+ ]
4109
+ }
4110
+ ```
4111
+
4112
+ Output schema:
4113
+
4114
+ ```json
4115
+ {
4116
+ "type": "object",
4117
+ "oneOf": [
4118
+ {
4119
+ "type": "object",
4120
+ "properties": {
4121
+ "ok": {
4122
+ "const": true
4123
+ }
4124
+ }
4125
+ },
4126
+ {
4127
+ "type": "object",
4128
+ "properties": {
4129
+ "ok": {
4130
+ "const": false
4131
+ },
4132
+ "error": {
4133
+ "type": "object",
4134
+ "properties": {
4135
+ "code": {
4136
+ "type": "string"
4137
+ },
4138
+ "message": {
4139
+ "type": "string"
4140
+ },
4141
+ "retryable": {
4142
+ "type": "boolean"
4143
+ },
4144
+ "recoveryAction": {
4145
+ "type": "string"
4146
+ }
4147
+ },
4148
+ "required": [
4149
+ "code",
4150
+ "message",
4151
+ "retryable",
4152
+ "recoveryAction"
4153
+ ],
4154
+ "additionalProperties": false
4155
+ }
4156
+ },
4157
+ "required": [
4158
+ "ok",
4159
+ "error"
4160
+ ],
4161
+ "additionalProperties": false
4162
+ }
4163
+ ]
4164
+ }
4165
+ ```
4166
+
4167
+ ### `platform_prepare_artifact_validation`
4168
+
4169
+ Prepare validation evidence for the exact private draft revision; missing required checks block readiness.
4170
+
4171
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
4172
+
4173
+ Example request:
4174
+
4175
+ ```json
4176
+ {
4177
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4178
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
4179
+ "deploymentRecordId": "00000000-0000-4000-8000-000000000001"
4180
+ }
4181
+ ```
4182
+
4183
+ Example success:
4184
+
4185
+ ```json
4186
+ {}
4187
+ ```
4188
+
4189
+ Input schema:
4190
+
4191
+ ```json
4192
+ {
4193
+ "type": "object",
4194
+ "additionalProperties": false,
4195
+ "properties": {
4196
+ "sessionId": {
4197
+ "type": "string",
4198
+ "format": "uuid"
4199
+ },
4200
+ "artifactVersionId": {
4201
+ "type": "string",
4202
+ "format": "uuid"
4203
+ },
4204
+ "deploymentRecordId": {
4205
+ "type": "string",
4206
+ "format": "uuid"
4207
+ }
4208
+ },
4209
+ "required": [
4210
+ "sessionId",
4211
+ "artifactVersionId",
4212
+ "deploymentRecordId"
4213
+ ]
4214
+ }
4215
+ ```
4216
+
4217
+ Output schema:
4218
+
4219
+ ```json
4220
+ {
4221
+ "type": "object",
4222
+ "oneOf": [
4223
+ {
4224
+ "type": "object",
4225
+ "properties": {
4226
+ "ok": {
4227
+ "const": true
4228
+ }
4229
+ }
4230
+ },
4231
+ {
4232
+ "type": "object",
4233
+ "properties": {
4234
+ "ok": {
4235
+ "const": false
4236
+ },
4237
+ "error": {
4238
+ "type": "object",
4239
+ "properties": {
4240
+ "code": {
4241
+ "type": "string"
4242
+ },
4243
+ "message": {
4244
+ "type": "string"
4245
+ },
4246
+ "retryable": {
4247
+ "type": "boolean"
4248
+ },
4249
+ "recoveryAction": {
4250
+ "type": "string"
4251
+ }
4252
+ },
4253
+ "required": [
4254
+ "code",
4255
+ "message",
4256
+ "retryable",
4257
+ "recoveryAction"
4258
+ ],
4259
+ "additionalProperties": false
4260
+ }
4261
+ },
4262
+ "required": [
4263
+ "ok",
4264
+ "error"
4265
+ ],
4266
+ "additionalProperties": false
4267
+ }
4268
+ ]
4269
+ }
4270
+ ```
4271
+
4272
+ ### `platform_request_artifact_validation`
4273
+
4274
+ Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval.
4275
+
4276
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4277
+
4278
+ Example request:
4279
+
4280
+ ```json
4281
+ {
4282
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4283
+ "artifactVersionId": "00000000-0000-4000-8000-000000000001",
4284
+ "idempotencyKey": "example-request",
4285
+ "deploymentRecordId": "00000000-0000-4000-8000-000000000001",
4286
+ "summary": "<summary>",
4287
+ "docImpact": "material",
4288
+ "docImpactNotes": "<docImpactNotes>",
4289
+ "visualReview": {}
4290
+ }
4291
+ ```
4292
+
4293
+ Example success:
4294
+
4295
+ ```json
4296
+ {}
4297
+ ```
4298
+
4299
+ Input schema:
4300
+
4301
+ ```json
4302
+ {
4303
+ "type": "object",
4304
+ "additionalProperties": false,
4305
+ "properties": {
4306
+ "sessionId": {
4307
+ "type": "string",
4308
+ "format": "uuid"
4309
+ },
4310
+ "artifactVersionId": {
4311
+ "type": "string",
4312
+ "format": "uuid"
4313
+ },
4314
+ "idempotencyKey": {
4315
+ "type": "string",
4316
+ "minLength": 1,
4317
+ "maxLength": 128,
4318
+ "pattern": "^[A-Za-z0-9._:-]+$"
4319
+ },
4320
+ "deploymentRecordId": {
4321
+ "type": "string",
4322
+ "format": "uuid"
4323
+ },
4324
+ "summary": {
4325
+ "type": "string",
4326
+ "minLength": 3,
4327
+ "maxLength": 4000
4328
+ },
4329
+ "waitMs": {
4330
+ "type": "integer",
4331
+ "minimum": 0,
4332
+ "maximum": 1000
4333
+ },
4334
+ "buildOk": {
4335
+ "type": "boolean"
4336
+ },
4337
+ "typecheckOk": {
4338
+ "type": "boolean"
4339
+ },
4340
+ "docImpact": {
4341
+ "type": "string",
4342
+ "enum": [
4343
+ "material",
4344
+ "none"
4345
+ ]
4346
+ },
4347
+ "docImpactNotes": {
4348
+ "type": "string",
4349
+ "minLength": 12,
4350
+ "maxLength": 2000
4351
+ },
4352
+ "visualReview": {
4353
+ "type": "object",
4354
+ "additionalProperties": true
4355
+ },
4356
+ "dataValidation": {
4357
+ "type": "object",
4358
+ "additionalProperties": true
4359
+ }
4360
+ },
4361
+ "required": [
4362
+ "sessionId",
4363
+ "artifactVersionId",
4364
+ "idempotencyKey",
4365
+ "deploymentRecordId",
4366
+ "summary",
4367
+ "docImpact",
4368
+ "docImpactNotes",
4369
+ "visualReview"
4370
+ ]
4371
+ }
4372
+ ```
4373
+
4374
+ Output schema:
4375
+
4376
+ ```json
4377
+ {
4378
+ "type": "object",
4379
+ "oneOf": [
4380
+ {
4381
+ "type": "object",
4382
+ "properties": {
4383
+ "ok": {
4384
+ "const": true
4385
+ }
4386
+ }
4387
+ },
4388
+ {
4389
+ "type": "object",
4390
+ "properties": {
4391
+ "ok": {
4392
+ "const": false
4393
+ },
4394
+ "error": {
4395
+ "type": "object",
4396
+ "properties": {
4397
+ "code": {
4398
+ "type": "string"
4399
+ },
4400
+ "message": {
4401
+ "type": "string"
4402
+ },
4403
+ "retryable": {
4404
+ "type": "boolean"
4405
+ },
4406
+ "recoveryAction": {
4407
+ "type": "string"
4408
+ }
4409
+ },
4410
+ "required": [
4411
+ "code",
4412
+ "message",
4413
+ "retryable",
4414
+ "recoveryAction"
4415
+ ],
4416
+ "additionalProperties": false
4417
+ }
4418
+ },
4419
+ "required": [
4420
+ "ok",
4421
+ "error"
4422
+ ],
4423
+ "additionalProperties": false
4424
+ }
4425
+ ]
4426
+ }
4427
+ ```
4428
+
4429
+ ### `platform_artifact_validation_status`
4430
+
4431
+ Read the original validation result and pending prompts without starting another reviewer or deploy. Current authorization is rechecked before evidence delivery.
4432
+
4433
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
4434
+
4435
+ Example request:
4436
+
4437
+ ```json
4438
+ {
4439
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4440
+ "operationId": "00000000-0000-4000-8000-000000000001"
4441
+ }
4442
+ ```
4443
+
4444
+ Example success:
4445
+
4446
+ ```json
4447
+ {}
4448
+ ```
4449
+
4450
+ Input schema:
4451
+
4452
+ ```json
4453
+ {
4454
+ "type": "object",
4455
+ "additionalProperties": false,
4456
+ "properties": {
4457
+ "sessionId": {
4458
+ "type": "string",
4459
+ "format": "uuid"
4460
+ },
4461
+ "operationId": {
4462
+ "type": "string",
4463
+ "format": "uuid"
4464
+ }
4465
+ },
4466
+ "required": [
4467
+ "sessionId",
4468
+ "operationId"
4469
+ ]
4470
+ }
4471
+ ```
4472
+
4473
+ Output schema:
4474
+
4475
+ ```json
4476
+ {
4477
+ "type": "object",
4478
+ "oneOf": [
4479
+ {
4480
+ "type": "object",
4481
+ "properties": {
4482
+ "ok": {
4483
+ "const": true
4484
+ }
4485
+ }
4486
+ },
4487
+ {
4488
+ "type": "object",
4489
+ "properties": {
4490
+ "ok": {
4491
+ "const": false
4492
+ },
4493
+ "error": {
4494
+ "type": "object",
4495
+ "properties": {
4496
+ "code": {
4497
+ "type": "string"
4498
+ },
4499
+ "message": {
4500
+ "type": "string"
4501
+ },
4502
+ "retryable": {
4503
+ "type": "boolean"
4504
+ },
4505
+ "recoveryAction": {
4506
+ "type": "string"
4507
+ }
4508
+ },
4509
+ "required": [
4510
+ "code",
4511
+ "message",
4512
+ "retryable",
4513
+ "recoveryAction"
4514
+ ],
4515
+ "additionalProperties": false
4516
+ }
4517
+ },
4518
+ "required": [
4519
+ "ok",
4520
+ "error"
4521
+ ],
4522
+ "additionalProperties": false
4523
+ }
4524
+ ]
4525
+ }
4526
+ ```
4527
+
4528
+ ### `platform_answer_operator_prompt`
4529
+
4530
+ 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.
4531
+
4532
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4533
+
4534
+ Example request:
4535
+
4536
+ ```json
4537
+ {
4538
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4539
+ "operationId": "00000000-0000-4000-8000-000000000001",
4540
+ "promptId": "00000000-0000-4000-8000-000000000001",
4541
+ "idempotencyKey": "example-request",
4542
+ "message": "<message>"
4543
+ }
4544
+ ```
4545
+
4546
+ Example success:
4547
+
4548
+ ```json
4549
+ {}
4550
+ ```
4551
+
4552
+ Input schema:
4553
+
4554
+ ```json
4555
+ {
4556
+ "type": "object",
4557
+ "additionalProperties": false,
4558
+ "properties": {
4559
+ "sessionId": {
4560
+ "type": "string",
4561
+ "format": "uuid"
4562
+ },
4563
+ "operationId": {
4564
+ "type": "string",
4565
+ "format": "uuid"
4566
+ },
4567
+ "promptId": {
4568
+ "type": "string",
4569
+ "format": "uuid"
4570
+ },
4571
+ "idempotencyKey": {
4572
+ "type": "string",
4573
+ "minLength": 1,
4574
+ "maxLength": 128,
4575
+ "pattern": "^[A-Za-z0-9._:-]+$"
4576
+ },
4577
+ "message": {
4578
+ "type": "string",
4579
+ "minLength": 3,
4580
+ "maxLength": 4000
4581
+ }
4582
+ },
4583
+ "required": [
4584
+ "sessionId",
4585
+ "operationId",
4586
+ "promptId",
4587
+ "idempotencyKey",
4588
+ "message"
4589
+ ]
4590
+ }
4591
+ ```
4592
+
4593
+ Output schema:
4594
+
4595
+ ```json
4596
+ {
4597
+ "type": "object",
4598
+ "oneOf": [
4599
+ {
4600
+ "type": "object",
4601
+ "properties": {
4602
+ "ok": {
4603
+ "const": true
4604
+ }
4605
+ }
4606
+ },
4607
+ {
4608
+ "type": "object",
4609
+ "properties": {
4610
+ "ok": {
4611
+ "const": false
4612
+ },
4613
+ "error": {
4614
+ "type": "object",
4615
+ "properties": {
4616
+ "code": {
4617
+ "type": "string"
4618
+ },
4619
+ "message": {
4620
+ "type": "string"
4621
+ },
4622
+ "retryable": {
4623
+ "type": "boolean"
4624
+ },
4625
+ "recoveryAction": {
4626
+ "type": "string"
4627
+ }
4628
+ },
4629
+ "required": [
4630
+ "code",
4631
+ "message",
4632
+ "retryable",
4633
+ "recoveryAction"
4634
+ ],
4635
+ "additionalProperties": false
4636
+ }
4637
+ },
4638
+ "required": [
4639
+ "ok",
4640
+ "error"
4641
+ ],
4642
+ "additionalProperties": false
4643
+ }
4644
+ ]
4645
+ }
4646
+ ```
4647
+
4648
+ ### `platform_read_artifact_domains`
4649
+
4650
+ Read connected company domains. With domainId, an explicitly scoped manager can read DNS/TLS setup state. With recovery, recover an original request/verify receipt by operation ID or its pre-call key; reads never retry setup or write DNS. Manager detail/recovery requires the setup capability.
4651
+
4652
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=false.
4653
+
4654
+ Example request:
4655
+
4656
+ ```json
4657
+ {}
4658
+ ```
4659
+
4660
+ Example success:
4661
+
4662
+ ```json
4663
+ {}
4664
+ ```
4665
+
4666
+ Input schema:
4667
+
4668
+ ```json
4669
+ {
4670
+ "type": "object",
4671
+ "additionalProperties": false,
4672
+ "properties": {
4673
+ "limit": {
4674
+ "type": "integer",
4675
+ "minimum": 1,
4676
+ "maximum": 100
4677
+ },
4678
+ "cursor": {
4679
+ "type": "integer",
4680
+ "minimum": 0,
4681
+ "maximum": 10000
4682
+ },
4683
+ "includePending": {
4684
+ "type": "boolean"
4685
+ },
4686
+ "domainId": {
4687
+ "type": "string",
4688
+ "format": "uuid"
4689
+ },
4690
+ "zoneName": {
4691
+ "type": "string",
4692
+ "minLength": 1,
4693
+ "maxLength": 253
4694
+ },
4695
+ "recovery": {
4696
+ "oneOf": [
4697
+ {
4698
+ "type": "object",
4699
+ "additionalProperties": false,
4700
+ "properties": {
4701
+ "operationId": {
4702
+ "type": "string",
4703
+ "format": "uuid"
4704
+ }
4705
+ },
4706
+ "required": [
4707
+ "operationId"
4708
+ ]
4709
+ },
4710
+ {
4711
+ "type": "object",
4712
+ "additionalProperties": false,
4713
+ "properties": {
4714
+ "kind": {
4715
+ "enum": [
4716
+ "request",
4717
+ "verify"
4718
+ ]
4719
+ },
4720
+ "idempotencyKey": {
4721
+ "type": "string",
4722
+ "minLength": 1,
4723
+ "maxLength": 128,
4724
+ "pattern": "^[\\x21-\\x7E]+$"
4725
+ }
4726
+ },
4727
+ "required": [
4728
+ "kind",
4729
+ "idempotencyKey"
4730
+ ]
4731
+ }
4732
+ ]
4733
+ }
4734
+ },
4735
+ "required": [],
4736
+ "oneOf": [
4737
+ {
4738
+ "not": {
4739
+ "anyOf": [
4740
+ {
4741
+ "required": [
4742
+ "domainId"
4743
+ ]
4744
+ },
4745
+ {
4746
+ "required": [
4747
+ "recovery"
4748
+ ]
4749
+ },
4750
+ {
4751
+ "required": [
4752
+ "zoneName"
4753
+ ]
4754
+ }
4755
+ ]
4756
+ }
4757
+ },
4758
+ {
4759
+ "required": [
4760
+ "domainId"
4761
+ ],
4762
+ "not": {
4763
+ "anyOf": [
4764
+ {
4765
+ "required": [
4766
+ "limit"
4767
+ ]
4768
+ },
4769
+ {
4770
+ "required": [
4771
+ "cursor"
4772
+ ]
4773
+ },
4774
+ {
4775
+ "required": [
4776
+ "includePending"
4777
+ ]
4778
+ },
4779
+ {
4780
+ "required": [
4781
+ "recovery"
4782
+ ]
4783
+ }
4784
+ ]
4785
+ }
4786
+ },
4787
+ {
4788
+ "required": [
4789
+ "recovery"
4790
+ ],
4791
+ "not": {
4792
+ "anyOf": [
4793
+ {
4794
+ "required": [
4795
+ "domainId"
4796
+ ]
4797
+ },
4798
+ {
4799
+ "required": [
4800
+ "zoneName"
4801
+ ]
4802
+ },
4803
+ {
4804
+ "required": [
4805
+ "cursor"
4806
+ ]
4807
+ },
4808
+ {
4809
+ "required": [
4810
+ "limit"
4811
+ ]
4812
+ },
4813
+ {
4814
+ "required": [
4815
+ "includePending"
4816
+ ]
4817
+ }
4818
+ ]
4819
+ }
4820
+ }
4821
+ ]
4822
+ }
4823
+ ```
4824
+
4825
+ Output schema:
4826
+
4827
+ ```json
4828
+ {
4829
+ "type": "object",
4830
+ "oneOf": [
4831
+ {
4832
+ "type": "object",
4833
+ "properties": {
4834
+ "ok": {
4835
+ "const": true
4836
+ }
4837
+ }
4838
+ },
4839
+ {
4840
+ "type": "object",
4841
+ "properties": {
4842
+ "ok": {
4843
+ "const": false
4844
+ },
4845
+ "error": {
4846
+ "type": "object",
4847
+ "properties": {
4848
+ "code": {
4849
+ "type": "string"
4850
+ },
4851
+ "message": {
4852
+ "type": "string"
4853
+ },
4854
+ "retryable": {
4855
+ "type": "boolean"
4856
+ },
4857
+ "recoveryAction": {
4858
+ "type": "string"
4859
+ },
4860
+ "recovery": {
4861
+ "type": "object",
4862
+ "additionalProperties": true
4863
+ }
4864
+ },
4865
+ "required": [
4866
+ "code",
4867
+ "message",
4868
+ "retryable",
4869
+ "recoveryAction"
4870
+ ],
4871
+ "additionalProperties": false
4872
+ }
4873
+ },
4874
+ "required": [
4875
+ "ok",
4876
+ "error"
4877
+ ],
4878
+ "additionalProperties": false
4879
+ }
4880
+ ]
4881
+ }
4882
+ ```
4883
+
4884
+ ### `platform_get_artifact_address`
4885
+
4886
+ Read an owned hosted app's exact company address, revision, connection and publication state. Optional recovery returns the original address-apply receipt under its current write scopes; it does not reapply. Saving an address never publishes an app or changes audience.
4887
+
4888
+ Safety: read-only=true, destructive=false, idempotent=true, open-world=false.
4889
+
4890
+ Example request:
4891
+
4892
+ ```json
4893
+ {
4894
+ "artifactId": "00000000-0000-4000-8000-000000000001"
4895
+ }
4896
+ ```
4897
+
4898
+ Example success:
4899
+
4900
+ ```json
4901
+ {}
4902
+ ```
4903
+
4904
+ Input schema:
4905
+
4906
+ ```json
4907
+ {
4908
+ "type": "object",
4909
+ "additionalProperties": false,
4910
+ "properties": {
4911
+ "artifactId": {
4912
+ "type": "string",
4913
+ "format": "uuid"
4914
+ },
4915
+ "recovery": {
4916
+ "oneOf": [
4917
+ {
4918
+ "type": "object",
4919
+ "additionalProperties": false,
4920
+ "properties": {
4921
+ "operationId": {
4922
+ "type": "string",
4923
+ "format": "uuid"
4924
+ }
4925
+ },
4926
+ "required": [
4927
+ "operationId"
4928
+ ]
4929
+ },
4930
+ {
4931
+ "type": "object",
4932
+ "additionalProperties": false,
4933
+ "properties": {
4934
+ "idempotencyKey": {
4935
+ "type": "string",
4936
+ "minLength": 1,
4937
+ "maxLength": 128,
4938
+ "pattern": "^[\\x21-\\x7E]+$"
4939
+ }
4940
+ },
4941
+ "required": [
4942
+ "idempotencyKey"
4943
+ ]
4944
+ }
4945
+ ]
4946
+ }
4947
+ },
4948
+ "required": [
4949
+ "artifactId"
4950
+ ]
4951
+ }
4952
+ ```
4953
+
4954
+ Output schema:
4955
+
4956
+ ```json
4957
+ {
4958
+ "type": "object",
4959
+ "oneOf": [
4960
+ {
4961
+ "type": "object",
4962
+ "properties": {
4963
+ "ok": {
4964
+ "const": true
4965
+ }
4966
+ }
4967
+ },
4968
+ {
4969
+ "type": "object",
4970
+ "properties": {
4971
+ "ok": {
4972
+ "const": false
4973
+ },
4974
+ "error": {
4975
+ "type": "object",
4976
+ "properties": {
4977
+ "code": {
4978
+ "type": "string"
4979
+ },
4980
+ "message": {
4981
+ "type": "string"
4982
+ },
4983
+ "retryable": {
4984
+ "type": "boolean"
4985
+ },
4986
+ "recoveryAction": {
4987
+ "type": "string"
4988
+ },
4989
+ "recovery": {
4990
+ "type": "object",
4991
+ "additionalProperties": true
4992
+ }
4993
+ },
4994
+ "required": [
4995
+ "code",
4996
+ "message",
4997
+ "retryable",
4998
+ "recoveryAction"
4999
+ ],
5000
+ "additionalProperties": false
5001
+ }
5002
+ },
5003
+ "required": [
5004
+ "ok",
5005
+ "error"
5006
+ ],
5007
+ "additionalProperties": false
5008
+ }
5009
+ ]
5010
+ }
5011
+ ```
5012
+
5013
+ ### `platform_plan_artifact_address`
5014
+
5015
+ Store a ten-minute single-use address preview for the owned app. domainId=null explicitly detaches the company route. Show old/new URLs and readiness before applying; this changes no customer address or DNS.
5016
+
5017
+ Safety: read-only=false, destructive=false, idempotent=false, open-world=false.
5018
+
5019
+ Example request:
5020
+
5021
+ ```json
5022
+ {
5023
+ "artifactId": "00000000-0000-4000-8000-000000000001",
5024
+ "domainId": "00000000-0000-4000-8000-000000000001",
5025
+ "path": "<path>"
5026
+ }
5027
+ ```
5028
+
5029
+ Example success:
5030
+
5031
+ ```json
5032
+ {}
5033
+ ```
5034
+
5035
+ Input schema:
5036
+
5037
+ ```json
5038
+ {
5039
+ "type": "object",
5040
+ "additionalProperties": false,
5041
+ "properties": {
5042
+ "artifactId": {
5043
+ "type": "string",
5044
+ "format": "uuid"
5045
+ },
5046
+ "domainId": {
5047
+ "type": [
5048
+ "string",
5049
+ "null"
5050
+ ],
5051
+ "format": "uuid"
5052
+ },
5053
+ "path": {
5054
+ "type": "string",
5055
+ "minLength": 1,
5056
+ "maxLength": 70
5057
+ }
5058
+ },
5059
+ "required": [
5060
+ "artifactId",
5061
+ "domainId"
5062
+ ],
5063
+ "oneOf": [
5064
+ {
5065
+ "properties": {
5066
+ "domainId": {
5067
+ "type": "string",
5068
+ "format": "uuid"
5069
+ }
5070
+ },
5071
+ "required": [
5072
+ "path"
5073
+ ]
5074
+ },
5075
+ {
5076
+ "properties": {
5077
+ "domainId": {
5078
+ "type": "null"
5079
+ }
5080
+ },
5081
+ "not": {
5082
+ "required": [
5083
+ "path"
5084
+ ]
5085
+ }
5086
+ }
5087
+ ]
5088
+ }
5089
+ ```
5090
+
5091
+ Output schema:
5092
+
5093
+ ```json
5094
+ {
5095
+ "type": "object",
5096
+ "oneOf": [
5097
+ {
5098
+ "type": "object",
5099
+ "properties": {
5100
+ "ok": {
5101
+ "const": true
5102
+ }
5103
+ }
5104
+ },
5105
+ {
5106
+ "type": "object",
5107
+ "properties": {
5108
+ "ok": {
5109
+ "const": false
5110
+ },
5111
+ "error": {
5112
+ "type": "object",
5113
+ "properties": {
5114
+ "code": {
5115
+ "type": "string"
5116
+ },
5117
+ "message": {
5118
+ "type": "string"
5119
+ },
5120
+ "retryable": {
5121
+ "type": "boolean"
5122
+ },
5123
+ "recoveryAction": {
5124
+ "type": "string"
5125
+ },
5126
+ "recovery": {
5127
+ "type": "object",
5128
+ "additionalProperties": true
5129
+ }
5130
+ },
5131
+ "required": [
5132
+ "code",
5133
+ "message",
5134
+ "retryable",
5135
+ "recoveryAction"
5136
+ ],
5137
+ "additionalProperties": false
5138
+ }
5139
+ },
5140
+ "required": [
5141
+ "ok",
5142
+ "error"
5143
+ ],
5144
+ "additionalProperties": false
5145
+ }
5146
+ ]
5147
+ }
5148
+ ```
5149
+
5150
+ ### `platform_apply_artifact_address`
5151
+
5152
+ Apply the exact owned address plan with a stable pre-call key. Rechecks authority and address/domain revisions; consumes the plan once, including a no-op. Recover a lost response through the address-read tool before a new effect. No promotion, audience or DNS write.
5153
+
5154
+ Safety: read-only=false, destructive=true, idempotent=true, open-world=false.
5155
+
5156
+ Example request:
5157
+
5158
+ ```json
5159
+ {
5160
+ "planId": "00000000-0000-4000-8000-000000000001",
5161
+ "idempotencyKey": "example-request"
5162
+ }
5163
+ ```
5164
+
5165
+ Example success:
5166
+
5167
+ ```json
5168
+ {}
5169
+ ```
5170
+
5171
+ Input schema:
5172
+
5173
+ ```json
5174
+ {
5175
+ "type": "object",
5176
+ "additionalProperties": false,
5177
+ "properties": {
5178
+ "planId": {
5179
+ "type": "string",
5180
+ "format": "uuid"
5181
+ },
5182
+ "idempotencyKey": {
5183
+ "type": "string",
5184
+ "minLength": 1,
5185
+ "maxLength": 128,
5186
+ "pattern": "^[\\x21-\\x7E]+$"
5187
+ }
5188
+ },
5189
+ "required": [
5190
+ "planId",
5191
+ "idempotencyKey"
5192
+ ]
5193
+ }
5194
+ ```
5195
+
5196
+ Output schema:
5197
+
5198
+ ```json
5199
+ {
5200
+ "type": "object",
5201
+ "oneOf": [
5202
+ {
5203
+ "type": "object",
5204
+ "properties": {
5205
+ "ok": {
5206
+ "const": true
5207
+ }
5208
+ }
5209
+ },
5210
+ {
5211
+ "type": "object",
5212
+ "properties": {
5213
+ "ok": {
5214
+ "const": false
5215
+ },
5216
+ "error": {
5217
+ "type": "object",
5218
+ "properties": {
5219
+ "code": {
5220
+ "type": "string"
5221
+ },
5222
+ "message": {
5223
+ "type": "string"
5224
+ },
5225
+ "retryable": {
5226
+ "type": "boolean"
5227
+ },
5228
+ "recoveryAction": {
5229
+ "type": "string"
5230
+ },
5231
+ "recovery": {
5232
+ "type": "object",
5233
+ "additionalProperties": true
5234
+ }
5235
+ },
5236
+ "required": [
5237
+ "code",
5238
+ "message",
5239
+ "retryable",
5240
+ "recoveryAction"
5241
+ ],
5242
+ "additionalProperties": false
5243
+ }
5244
+ },
5245
+ "required": [
5246
+ "ok",
5247
+ "error"
5248
+ ],
5249
+ "additionalProperties": false
5250
+ }
5251
+ ]
5252
+ }
5253
+ ```
5254
+
5255
+ ### `platform_request_artifact_domain`
5256
+
5257
+ Manager-only request for an owned company subdomain. Save the key before calling. Returns exact ownership/routing DNS records; never writes customer DNS. The existing reconciler may make the first connected domain the initial default. No artifact is reassigned.
5258
+
5259
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=false.
5260
+
5261
+ Example request:
5262
+
5263
+ ```json
5264
+ {
5265
+ "hostname": "<hostname>",
5266
+ "idempotencyKey": "example-request"
5267
+ }
5268
+ ```
5269
+
5270
+ Example success:
5271
+
5272
+ ```json
5273
+ {}
5274
+ ```
5275
+
5276
+ Input schema:
5277
+
5278
+ ```json
5279
+ {
5280
+ "type": "object",
5281
+ "additionalProperties": false,
5282
+ "properties": {
5283
+ "hostname": {
5284
+ "type": "string",
5285
+ "minLength": 1,
5286
+ "maxLength": 253
5287
+ },
5288
+ "idempotencyKey": {
5289
+ "type": "string",
5290
+ "minLength": 1,
5291
+ "maxLength": 128,
5292
+ "pattern": "^[\\x21-\\x7E]+$"
5293
+ }
5294
+ },
5295
+ "required": [
5296
+ "hostname",
5297
+ "idempotencyKey"
5298
+ ]
5299
+ }
5300
+ ```
5301
+
5302
+ Output schema:
5303
+
5304
+ ```json
5305
+ {
5306
+ "type": "object",
5307
+ "oneOf": [
5308
+ {
5309
+ "type": "object",
5310
+ "properties": {
5311
+ "ok": {
5312
+ "const": true
5313
+ }
5314
+ }
5315
+ },
5316
+ {
5317
+ "type": "object",
5318
+ "properties": {
5319
+ "ok": {
5320
+ "const": false
5321
+ },
5322
+ "error": {
5323
+ "type": "object",
5324
+ "properties": {
5325
+ "code": {
5326
+ "type": "string"
5327
+ },
5328
+ "message": {
5329
+ "type": "string"
5330
+ },
5331
+ "retryable": {
5332
+ "type": "boolean"
5333
+ },
5334
+ "recoveryAction": {
5335
+ "type": "string"
5336
+ },
5337
+ "recovery": {
5338
+ "type": "object",
5339
+ "additionalProperties": true
5340
+ }
5341
+ },
5342
+ "required": [
5343
+ "code",
5344
+ "message",
5345
+ "retryable",
5346
+ "recoveryAction"
5347
+ ],
5348
+ "additionalProperties": false
5349
+ }
5350
+ },
5351
+ "required": [
5352
+ "ok",
5353
+ "error"
5354
+ ],
5355
+ "additionalProperties": false
5356
+ }
5357
+ ]
5358
+ }
5359
+ ```
5360
+
5361
+ ### `platform_verify_artifact_domain`
5362
+
5363
+ Manager-only bounded ownership verification for the exact current domain generation and pre-call key. Matching DNS admits the existing TLS reconciler once. Same keys retain outcomes; use a new key only after a definite terminal no-admission outcome and covered retry intent. Read status through domain reads.
5364
+
5365
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
5366
+
5367
+ Example request:
5368
+
5369
+ ```json
5370
+ {
5371
+ "domainId": "00000000-0000-4000-8000-000000000001",
5372
+ "expectedConnectionGeneration": 0,
5373
+ "idempotencyKey": "example-request"
5374
+ }
5375
+ ```
5376
+
5377
+ Example success:
5378
+
5379
+ ```json
5380
+ {}
5381
+ ```
5382
+
5383
+ Input schema:
5384
+
5385
+ ```json
5386
+ {
5387
+ "type": "object",
5388
+ "additionalProperties": false,
5389
+ "properties": {
5390
+ "domainId": {
5391
+ "type": "string",
5392
+ "format": "uuid"
5393
+ },
5394
+ "expectedConnectionGeneration": {
5395
+ "type": "integer",
5396
+ "minimum": 0
5397
+ },
5398
+ "idempotencyKey": {
5399
+ "type": "string",
5400
+ "minLength": 1,
5401
+ "maxLength": 128,
5402
+ "pattern": "^[\\x21-\\x7E]+$"
5403
+ }
5404
+ },
5405
+ "required": [
5406
+ "domainId",
5407
+ "expectedConnectionGeneration",
5408
+ "idempotencyKey"
5409
+ ]
5410
+ }
5411
+ ```
5412
+
5413
+ Output schema:
5414
+
5415
+ ```json
5416
+ {
5417
+ "type": "object",
5418
+ "oneOf": [
5419
+ {
5420
+ "type": "object",
5421
+ "properties": {
5422
+ "ok": {
5423
+ "const": true
5424
+ }
5425
+ }
5426
+ },
5427
+ {
5428
+ "type": "object",
5429
+ "properties": {
5430
+ "ok": {
5431
+ "const": false
5432
+ },
5433
+ "error": {
5434
+ "type": "object",
5435
+ "properties": {
5436
+ "code": {
5437
+ "type": "string"
5438
+ },
5439
+ "message": {
5440
+ "type": "string"
5441
+ },
5442
+ "retryable": {
5443
+ "type": "boolean"
5444
+ },
5445
+ "recoveryAction": {
5446
+ "type": "string"
5447
+ },
5448
+ "recovery": {
5449
+ "type": "object",
5450
+ "additionalProperties": true
5451
+ }
5452
+ },
5453
+ "required": [
5454
+ "code",
5455
+ "message",
5456
+ "retryable",
5457
+ "recoveryAction"
5458
+ ],
5459
+ "additionalProperties": false
5460
+ }
5461
+ },
5462
+ "required": [
5463
+ "ok",
5464
+ "error"
5465
+ ],
5466
+ "additionalProperties": false
5467
+ }
5468
+ ]
5469
+ }
5470
+ ```