@topline-build/harness-mcp 0.9.13 → 0.9.15

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.9.13`
5
+ Package: `@topline-build/harness-mcp@0.9.15`
6
6
  Transport: `stdio`
7
7
  Default protocol: `2025-11-25`
8
8
  Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -81,6 +81,8 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
81
81
  - `build_session_id_required` (not automatically retryable): The fields named after the code only work inside a build session. Remove them for a plain deploy of an app you created over MCP, or start a session and pass its sessionId.
82
82
  - `artifact_external_session_active` (not automatically retryable): An open build session holds this app. If it is yours, pass its sessionId; otherwise close it with platform_close_build_session or wait for it to end.
83
83
  - `artifact_deploy_wait_timeout` (retryable): Call platform_wait_artifact_deploy again with the same artifactId and operationId.
84
+ - `artifact_deploy_failed` (not automatically retryable): The deploy finished and failed; the code after artifact_deploy_failed names why. Call platform_deploy_operation with the same artifactId and operationId for failure.detail (the build's own error) and failure.nextAction. Fix the source, run platform_inspect_artifact_app, then deploy again. Retrying the wait or redeploying the same source fails the same way.
85
+ - `validation_already_completed` (not automatically retryable): A review already approved this version and completed the build session. Don't request another review or start a new session to repeat it; read the verdict with platform_artifact_validation_status. Publishing is the person's step in Topline.
84
86
  - `artifact_delete_plan_stale` (retryable): Call platform_plan_artifact_draft_delete again, review the new effects, and use its planToken.
85
87
  - `artifact_app_bundle_changed_after_inspection` (retryable): Call platform_inspect_artifact_app again, review the new bundle hash, then retry deployment with that hash.
86
88
  - `artifact_app_bundle_hardlink_forbidden` (not automatically retryable): Replace the hard link with a regular file copied into appDir, then inspect again.
@@ -93,8 +95,8 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
93
95
  - `artifact_app_scaffold_starter_shape_conflict` (not automatically retryable): A starter scaffolds the single shape; leave shape out or set it to single.
94
96
  - `artifact_version_conflict` (not automatically retryable): The session moved to a newer version. Read the session (platform_read_build_session). A build session always starts from the app's current version; Build MCP can't check out an older saved version, so to go back, deploy source you saved before (or ask the coding agent in Topline to go back to version N). For a refused deploy: keep your local edits, run platform_inspect_artifact_app again, then deploy with the current artifactVersionId and the new inspectedSourceHash. For a refused validation request: don't deploy again. Wait for the current version's deploy to settle (platform_deploy_operation), run its checks and smoke, prepare it with platform_prepare_artifact_validation, then call platform_request_artifact_validation with that prepared evidence.
95
97
  - `build_session_deployment_arguments_required` (not automatically retryable): Inside a build session a deploy needs artifactVersionId, idempotencyKey, and the inspectedSourceHash and expectedBundleSha256 that platform_inspect_artifact_app returned. The fields named after the code are missing; add them and call again.
96
- - `artifact_source_conflict` (not automatically retryable): inspectedSourceHash no longer matches the session's source fence. Read the session for its current sourceHash (or check out again into a new directory), keep your local edits, inspect again, then deploy with the fresh hash.
97
- - `artifact_operation_pending` (not automatically retryable): Another operation on this app has not settled. Read it with platform_deploy_operation (a deploy that already landed settles on that read), or platform_read_build_session, then call this tool again once it is terminal.
98
+ - `artifact_source_conflict` (not automatically retryable): inspectedSourceHash no longer matches the session's source fence. Use currentSourceHash from this error when present, or read the session for its current sourceHash (or check out again into a new directory). Keep your local edits, inspect again, then deploy with the fresh hash.
99
+ - `artifact_operation_pending` (retryable): Another operation on this app has not settled. Read it with platform_deploy_operation, using pendingOperationId from this error when present (a deploy that already landed settles on that read), or platform_read_build_session, then call this tool again once it is terminal.
98
100
  - `artifact_deploy_in_flight` (retryable): A deploy for this app is still running. Wait until platform_deploy_operation says it is terminal, then retry the call that was refused (checkout, delete or deploy).
99
101
  - `artifact_logs_deployment_not_found` (not automatically retryable): There is no deployment to read runtime logs from yet. For a failed build, read platform_deploy_operation: its failure field carries the build error.
100
102
 
@@ -195,6 +197,15 @@ Output schema:
195
197
  },
196
198
  "signInUrl": {
197
199
  "type": "string"
200
+ },
201
+ "currentSourceHash": {
202
+ "type": "string"
203
+ },
204
+ "pendingOperationId": {
205
+ "type": "string"
206
+ },
207
+ "pendingKind": {
208
+ "type": "string"
198
209
  }
199
210
  },
200
211
  "required": [
@@ -302,6 +313,15 @@ Output schema:
302
313
  },
303
314
  "signInUrl": {
304
315
  "type": "string"
316
+ },
317
+ "currentSourceHash": {
318
+ "type": "string"
319
+ },
320
+ "pendingOperationId": {
321
+ "type": "string"
322
+ },
323
+ "pendingKind": {
324
+ "type": "string"
305
325
  }
306
326
  },
307
327
  "required": [
@@ -492,6 +512,15 @@ Output schema:
492
512
  },
493
513
  "signInUrl": {
494
514
  "type": "string"
515
+ },
516
+ "currentSourceHash": {
517
+ "type": "string"
518
+ },
519
+ "pendingOperationId": {
520
+ "type": "string"
521
+ },
522
+ "pendingKind": {
523
+ "type": "string"
495
524
  }
496
525
  },
497
526
  "required": [
@@ -681,6 +710,15 @@ Output schema:
681
710
  },
682
711
  "signInUrl": {
683
712
  "type": "string"
713
+ },
714
+ "currentSourceHash": {
715
+ "type": "string"
716
+ },
717
+ "pendingOperationId": {
718
+ "type": "string"
719
+ },
720
+ "pendingKind": {
721
+ "type": "string"
684
722
  }
685
723
  },
686
724
  "required": [
@@ -704,7 +742,7 @@ Output schema:
704
742
 
705
743
  ### `platform_inspect_artifact_app`
706
744
 
707
- Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft.
745
+ Inspect local artifact paths and package boundaries without authenticating, uploading, or creating a remote draft. Also runs the manifest and data-binding checks Topline's build would fail (datasets[].name and route, routes[].path, ./_artifact/data/<name> references with no matching dataset) and a node --check of each .js/.mjs/.cjs file (javascript_syntax_error with file and line); packageReady is false and problems lists each one until they are fixed. warnings lists static text the build's page-text rules would refuse if the page shows it.
708
746
 
709
747
  Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
710
748
 
@@ -769,6 +807,20 @@ Output schema:
769
807
  "packageReady": {
770
808
  "type": "boolean"
771
809
  },
810
+ "problems": {
811
+ "type": "array",
812
+ "items": {
813
+ "type": "object"
814
+ },
815
+ "description": "Checks Topline's build would fail: each has code, path (manifest field or file, with :line for javascript_syntax_error) and detail. packageReady is false while any remain."
816
+ },
817
+ "warnings": {
818
+ "type": "array",
819
+ "items": {
820
+ "type": "object"
821
+ },
822
+ "description": "Static text that matches a rule Topline's render smoke applies to the page (rendered_text_rule:sample_or_mock_data_text), with the file and phrase. The build fails only if the rendered page shows it."
823
+ },
772
824
  "serverManifestValidationRequired": {
773
825
  "type": "boolean"
774
826
  },
@@ -822,6 +874,15 @@ Output schema:
822
874
  },
823
875
  "signInUrl": {
824
876
  "type": "string"
877
+ },
878
+ "currentSourceHash": {
879
+ "type": "string"
880
+ },
881
+ "pendingOperationId": {
882
+ "type": "string"
883
+ },
884
+ "pendingKind": {
885
+ "type": "string"
825
886
  }
826
887
  },
827
888
  "required": [
@@ -921,6 +982,15 @@ Output schema:
921
982
  },
922
983
  "signInUrl": {
923
984
  "type": "string"
985
+ },
986
+ "currentSourceHash": {
987
+ "type": "string"
988
+ },
989
+ "pendingOperationId": {
990
+ "type": "string"
991
+ },
992
+ "pendingKind": {
993
+ "type": "string"
924
994
  }
925
995
  },
926
996
  "required": [
@@ -1030,6 +1100,15 @@ Output schema:
1030
1100
  },
1031
1101
  "signInUrl": {
1032
1102
  "type": "string"
1103
+ },
1104
+ "currentSourceHash": {
1105
+ "type": "string"
1106
+ },
1107
+ "pendingOperationId": {
1108
+ "type": "string"
1109
+ },
1110
+ "pendingKind": {
1111
+ "type": "string"
1033
1112
  }
1034
1113
  },
1035
1114
  "required": [
@@ -1184,6 +1263,15 @@ Output schema:
1184
1263
  },
1185
1264
  "signInUrl": {
1186
1265
  "type": "string"
1266
+ },
1267
+ "currentSourceHash": {
1268
+ "type": "string"
1269
+ },
1270
+ "pendingOperationId": {
1271
+ "type": "string"
1272
+ },
1273
+ "pendingKind": {
1274
+ "type": "string"
1187
1275
  }
1188
1276
  },
1189
1277
  "required": [
@@ -1207,7 +1295,7 @@ Output schema:
1207
1295
 
1208
1296
  ### `platform_wait_artifact_deploy`
1209
1297
 
1210
- Wait for a durable deployment operation and stream server-derived progress.
1298
+ Wait for a durable deployment operation and stream server-derived progress. A failed deploy returns artifact_deploy_failed:<failure code>; read platform_deploy_operation for the build's own error (failure.detail) and next step. A successful deploy returns the session's next sourceHash for the following deploy.
1211
1299
 
1212
1300
  Safety: read-only=true, destructive=false, idempotent=false, open-world=true.
1213
1301
 
@@ -1339,6 +1427,15 @@ Output schema:
1339
1427
  },
1340
1428
  "signInUrl": {
1341
1429
  "type": "string"
1430
+ },
1431
+ "currentSourceHash": {
1432
+ "type": "string"
1433
+ },
1434
+ "pendingOperationId": {
1435
+ "type": "string"
1436
+ },
1437
+ "pendingKind": {
1438
+ "type": "string"
1342
1439
  }
1343
1440
  },
1344
1441
  "required": [
@@ -1463,6 +1560,15 @@ Output schema:
1463
1560
  },
1464
1561
  "signInUrl": {
1465
1562
  "type": "string"
1563
+ },
1564
+ "currentSourceHash": {
1565
+ "type": "string"
1566
+ },
1567
+ "pendingOperationId": {
1568
+ "type": "string"
1569
+ },
1570
+ "pendingKind": {
1571
+ "type": "string"
1466
1572
  }
1467
1573
  },
1468
1574
  "required": [
@@ -1636,6 +1742,15 @@ Output schema:
1636
1742
  },
1637
1743
  "signInUrl": {
1638
1744
  "type": "string"
1745
+ },
1746
+ "currentSourceHash": {
1747
+ "type": "string"
1748
+ },
1749
+ "pendingOperationId": {
1750
+ "type": "string"
1751
+ },
1752
+ "pendingKind": {
1753
+ "type": "string"
1639
1754
  }
1640
1755
  },
1641
1756
  "required": [
@@ -1830,6 +1945,15 @@ Output schema:
1830
1945
  },
1831
1946
  "signInUrl": {
1832
1947
  "type": "string"
1948
+ },
1949
+ "currentSourceHash": {
1950
+ "type": "string"
1951
+ },
1952
+ "pendingOperationId": {
1953
+ "type": "string"
1954
+ },
1955
+ "pendingKind": {
1956
+ "type": "string"
1833
1957
  }
1834
1958
  },
1835
1959
  "required": [
@@ -1965,6 +2089,15 @@ Output schema:
1965
2089
  },
1966
2090
  "signInUrl": {
1967
2091
  "type": "string"
2092
+ },
2093
+ "currentSourceHash": {
2094
+ "type": "string"
2095
+ },
2096
+ "pendingOperationId": {
2097
+ "type": "string"
2098
+ },
2099
+ "pendingKind": {
2100
+ "type": "string"
1968
2101
  }
1969
2102
  },
1970
2103
  "required": [
@@ -2071,6 +2204,15 @@ Output schema:
2071
2204
  },
2072
2205
  "signInUrl": {
2073
2206
  "type": "string"
2207
+ },
2208
+ "currentSourceHash": {
2209
+ "type": "string"
2210
+ },
2211
+ "pendingOperationId": {
2212
+ "type": "string"
2213
+ },
2214
+ "pendingKind": {
2215
+ "type": "string"
2074
2216
  }
2075
2217
  },
2076
2218
  "required": [
@@ -2152,6 +2294,15 @@ Output schema:
2152
2294
  },
2153
2295
  "signInUrl": {
2154
2296
  "type": "string"
2297
+ },
2298
+ "currentSourceHash": {
2299
+ "type": "string"
2300
+ },
2301
+ "pendingOperationId": {
2302
+ "type": "string"
2303
+ },
2304
+ "pendingKind": {
2305
+ "type": "string"
2155
2306
  }
2156
2307
  },
2157
2308
  "required": [
@@ -2271,6 +2422,15 @@ Output schema:
2271
2422
  },
2272
2423
  "signInUrl": {
2273
2424
  "type": "string"
2425
+ },
2426
+ "currentSourceHash": {
2427
+ "type": "string"
2428
+ },
2429
+ "pendingOperationId": {
2430
+ "type": "string"
2431
+ },
2432
+ "pendingKind": {
2433
+ "type": "string"
2274
2434
  }
2275
2435
  },
2276
2436
  "required": [
@@ -2421,6 +2581,15 @@ Output schema:
2421
2581
  },
2422
2582
  "signInUrl": {
2423
2583
  "type": "string"
2584
+ },
2585
+ "currentSourceHash": {
2586
+ "type": "string"
2587
+ },
2588
+ "pendingOperationId": {
2589
+ "type": "string"
2590
+ },
2591
+ "pendingKind": {
2592
+ "type": "string"
2424
2593
  }
2425
2594
  },
2426
2595
  "required": [
@@ -2547,6 +2716,15 @@ Output schema:
2547
2716
  },
2548
2717
  "signInUrl": {
2549
2718
  "type": "string"
2719
+ },
2720
+ "currentSourceHash": {
2721
+ "type": "string"
2722
+ },
2723
+ "pendingOperationId": {
2724
+ "type": "string"
2725
+ },
2726
+ "pendingKind": {
2727
+ "type": "string"
2550
2728
  }
2551
2729
  },
2552
2730
  "required": [
@@ -2671,6 +2849,15 @@ Output schema:
2671
2849
  },
2672
2850
  "signInUrl": {
2673
2851
  "type": "string"
2852
+ },
2853
+ "currentSourceHash": {
2854
+ "type": "string"
2855
+ },
2856
+ "pendingOperationId": {
2857
+ "type": "string"
2858
+ },
2859
+ "pendingKind": {
2860
+ "type": "string"
2674
2861
  }
2675
2862
  },
2676
2863
  "required": [
@@ -2825,6 +3012,15 @@ Output schema:
2825
3012
  },
2826
3013
  "signInUrl": {
2827
3014
  "type": "string"
3015
+ },
3016
+ "currentSourceHash": {
3017
+ "type": "string"
3018
+ },
3019
+ "pendingOperationId": {
3020
+ "type": "string"
3021
+ },
3022
+ "pendingKind": {
3023
+ "type": "string"
2828
3024
  }
2829
3025
  },
2830
3026
  "required": [
@@ -2970,6 +3166,15 @@ Output schema:
2970
3166
  },
2971
3167
  "signInUrl": {
2972
3168
  "type": "string"
3169
+ },
3170
+ "currentSourceHash": {
3171
+ "type": "string"
3172
+ },
3173
+ "pendingOperationId": {
3174
+ "type": "string"
3175
+ },
3176
+ "pendingKind": {
3177
+ "type": "string"
2973
3178
  }
2974
3179
  },
2975
3180
  "required": [
@@ -3096,6 +3301,15 @@ Output schema:
3096
3301
  },
3097
3302
  "signInUrl": {
3098
3303
  "type": "string"
3304
+ },
3305
+ "currentSourceHash": {
3306
+ "type": "string"
3307
+ },
3308
+ "pendingOperationId": {
3309
+ "type": "string"
3310
+ },
3311
+ "pendingKind": {
3312
+ "type": "string"
3099
3313
  }
3100
3314
  },
3101
3315
  "required": [
@@ -3219,6 +3433,15 @@ Output schema:
3219
3433
  },
3220
3434
  "signInUrl": {
3221
3435
  "type": "string"
3436
+ },
3437
+ "currentSourceHash": {
3438
+ "type": "string"
3439
+ },
3440
+ "pendingOperationId": {
3441
+ "type": "string"
3442
+ },
3443
+ "pendingKind": {
3444
+ "type": "string"
3222
3445
  }
3223
3446
  },
3224
3447
  "required": [
@@ -3306,6 +3529,15 @@ Output schema:
3306
3529
  },
3307
3530
  "signInUrl": {
3308
3531
  "type": "string"
3532
+ },
3533
+ "currentSourceHash": {
3534
+ "type": "string"
3535
+ },
3536
+ "pendingOperationId": {
3537
+ "type": "string"
3538
+ },
3539
+ "pendingKind": {
3540
+ "type": "string"
3309
3541
  }
3310
3542
  },
3311
3543
  "required": [
@@ -3437,6 +3669,15 @@ Output schema:
3437
3669
  },
3438
3670
  "signInUrl": {
3439
3671
  "type": "string"
3672
+ },
3673
+ "currentSourceHash": {
3674
+ "type": "string"
3675
+ },
3676
+ "pendingOperationId": {
3677
+ "type": "string"
3678
+ },
3679
+ "pendingKind": {
3680
+ "type": "string"
3440
3681
  }
3441
3682
  },
3442
3683
  "required": [
@@ -3533,6 +3774,15 @@ Output schema:
3533
3774
  },
3534
3775
  "signInUrl": {
3535
3776
  "type": "string"
3777
+ },
3778
+ "currentSourceHash": {
3779
+ "type": "string"
3780
+ },
3781
+ "pendingOperationId": {
3782
+ "type": "string"
3783
+ },
3784
+ "pendingKind": {
3785
+ "type": "string"
3536
3786
  }
3537
3787
  },
3538
3788
  "required": [
@@ -3629,6 +3879,15 @@ Output schema:
3629
3879
  },
3630
3880
  "signInUrl": {
3631
3881
  "type": "string"
3882
+ },
3883
+ "currentSourceHash": {
3884
+ "type": "string"
3885
+ },
3886
+ "pendingOperationId": {
3887
+ "type": "string"
3888
+ },
3889
+ "pendingKind": {
3890
+ "type": "string"
3632
3891
  }
3633
3892
  },
3634
3893
  "required": [
@@ -3652,7 +3911,7 @@ Output schema:
3652
3911
 
3653
3912
  ### `platform_run_artifact_workspace_sql`
3654
3913
 
3655
- Run guarded SQL using the exact session, version and retry key. Without scope, or scope "artifact", it reads and writes this app's own build-checkpoint and cache tables. With scope "company", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.
3914
+ Run guarded SQL using the exact session, version and retry key. Without scope, or scope "artifact", it reads and writes this app's own build-checkpoint and cache tables; when the build session's workspace.routing is company_tables there are no private tables and every statement runs against company tables, as with scope "company". A statement the database rejects returns sql_statement_failed:<SQLSTATE> (company tables: company_table_sql_failed:<SQLSTATE>) with a fixed hint. With scope "company", it creates, changes or drops a company table in company_data, or changes its rows, at once with no confirmation step; check the catalog before creating one, and declare tables an app uses in manifest tables[]. The company scope needs the harness:company:tables:write permission on your sign-in and the build session. CREATE TABLE/ADD COLUMN require documentation (company tables: a description and sensitivity for every column). Enforced non-admin writes remain denied; unknown writes are never replayed.
3656
3915
 
3657
3916
  Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
3658
3917
 
@@ -3775,6 +4034,15 @@ Output schema:
3775
4034
  },
3776
4035
  "signInUrl": {
3777
4036
  "type": "string"
4037
+ },
4038
+ "currentSourceHash": {
4039
+ "type": "string"
4040
+ },
4041
+ "pendingOperationId": {
4042
+ "type": "string"
4043
+ },
4044
+ "pendingKind": {
4045
+ "type": "string"
3778
4046
  }
3779
4047
  },
3780
4048
  "required": [
@@ -3877,6 +4145,15 @@ Output schema:
3877
4145
  },
3878
4146
  "signInUrl": {
3879
4147
  "type": "string"
4148
+ },
4149
+ "currentSourceHash": {
4150
+ "type": "string"
4151
+ },
4152
+ "pendingOperationId": {
4153
+ "type": "string"
4154
+ },
4155
+ "pendingKind": {
4156
+ "type": "string"
3880
4157
  }
3881
4158
  },
3882
4159
  "required": [
@@ -3973,6 +4250,15 @@ Output schema:
3973
4250
  },
3974
4251
  "signInUrl": {
3975
4252
  "type": "string"
4253
+ },
4254
+ "currentSourceHash": {
4255
+ "type": "string"
4256
+ },
4257
+ "pendingOperationId": {
4258
+ "type": "string"
4259
+ },
4260
+ "pendingKind": {
4261
+ "type": "string"
3976
4262
  }
3977
4263
  },
3978
4264
  "required": [
@@ -4086,6 +4372,15 @@ Output schema:
4086
4372
  },
4087
4373
  "signInUrl": {
4088
4374
  "type": "string"
4375
+ },
4376
+ "currentSourceHash": {
4377
+ "type": "string"
4378
+ },
4379
+ "pendingOperationId": {
4380
+ "type": "string"
4381
+ },
4382
+ "pendingKind": {
4383
+ "type": "string"
4089
4384
  }
4090
4385
  },
4091
4386
  "required": [
@@ -4202,6 +4497,15 @@ Output schema:
4202
4497
  },
4203
4498
  "signInUrl": {
4204
4499
  "type": "string"
4500
+ },
4501
+ "currentSourceHash": {
4502
+ "type": "string"
4503
+ },
4504
+ "pendingOperationId": {
4505
+ "type": "string"
4506
+ },
4507
+ "pendingKind": {
4508
+ "type": "string"
4205
4509
  }
4206
4510
  },
4207
4511
  "required": [
@@ -4298,6 +4602,15 @@ Output schema:
4298
4602
  },
4299
4603
  "signInUrl": {
4300
4604
  "type": "string"
4605
+ },
4606
+ "currentSourceHash": {
4607
+ "type": "string"
4608
+ },
4609
+ "pendingOperationId": {
4610
+ "type": "string"
4611
+ },
4612
+ "pendingKind": {
4613
+ "type": "string"
4301
4614
  }
4302
4615
  },
4303
4616
  "required": [
@@ -4415,6 +4728,15 @@ Output schema:
4415
4728
  },
4416
4729
  "signInUrl": {
4417
4730
  "type": "string"
4731
+ },
4732
+ "currentSourceHash": {
4733
+ "type": "string"
4734
+ },
4735
+ "pendingOperationId": {
4736
+ "type": "string"
4737
+ },
4738
+ "pendingKind": {
4739
+ "type": "string"
4418
4740
  }
4419
4741
  },
4420
4742
  "required": [
@@ -4438,7 +4760,7 @@ Output schema:
4438
4760
 
4439
4761
  ### `platform_run_acceptance_checks`
4440
4762
 
4441
- Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version, which also gates validation.
4763
+ Run required acceptance checks for the exact current draft revision through the shared service. Pass counts cover acceptance checks only; renderedSmoke reports the latest rendered smoke for this version (passed, passed_with_warnings with qualityWarnings codes, failed with failingChecks, or not_run), which also gates validation.
4442
4764
 
4443
4765
  Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4444
4766
 
@@ -4525,6 +4847,15 @@ Output schema:
4525
4847
  },
4526
4848
  "signInUrl": {
4527
4849
  "type": "string"
4850
+ },
4851
+ "currentSourceHash": {
4852
+ "type": "string"
4853
+ },
4854
+ "pendingOperationId": {
4855
+ "type": "string"
4856
+ },
4857
+ "pendingKind": {
4858
+ "type": "string"
4528
4859
  }
4529
4860
  },
4530
4861
  "required": [
@@ -4657,6 +4988,15 @@ Output schema:
4657
4988
  },
4658
4989
  "signInUrl": {
4659
4990
  "type": "string"
4991
+ },
4992
+ "currentSourceHash": {
4993
+ "type": "string"
4994
+ },
4995
+ "pendingOperationId": {
4996
+ "type": "string"
4997
+ },
4998
+ "pendingKind": {
4999
+ "type": "string"
4660
5000
  }
4661
5001
  },
4662
5002
  "required": [
@@ -4771,6 +5111,15 @@ Output schema:
4771
5111
  },
4772
5112
  "signInUrl": {
4773
5113
  "type": "string"
5114
+ },
5115
+ "currentSourceHash": {
5116
+ "type": "string"
5117
+ },
5118
+ "pendingOperationId": {
5119
+ "type": "string"
5120
+ },
5121
+ "pendingKind": {
5122
+ "type": "string"
4774
5123
  }
4775
5124
  },
4776
5125
  "required": [
@@ -4794,7 +5143,7 @@ Output schema:
4794
5143
 
4795
5144
  ### `platform_request_artifact_validation`
4796
5145
 
4797
- Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish.
5146
+ Request the independent reviewer for the exact deployment and bounded evidence. Returns durable operation status; unavailable infrastructure leaves operator review required, never approval. waitMs is 0 to 1000 (milliseconds to wait before returning); poll platform_artifact_validation_status for longer reviews. An approved review marks the private draft ready for an operator to publish and completes this build session; asking again returns validation_already_completed. A needs_fix review keeps the session active: fix, deploy a new version, smoke, then request a review of that version. If the draft isn't ready, the refusal names the blocker platform_prepare_artifact_validation reports.
4798
5147
 
4799
5148
  Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4800
5149
 
@@ -4856,10 +5205,12 @@ Input schema:
4856
5205
  "description": "Milliseconds to wait for the review before returning, 0 to 1000."
4857
5206
  },
4858
5207
  "buildOk": {
4859
- "type": "boolean"
5208
+ "type": "boolean",
5209
+ "description": "Your own local build result. Omit if you did not run one; the reviewer is told separately that Topline's trusted build deployed this version."
4860
5210
  },
4861
5211
  "typecheckOk": {
4862
- "type": "boolean"
5212
+ "type": "boolean",
5213
+ "description": "Your own local typecheck result. Omit if you did not run one."
4863
5214
  },
4864
5215
  "docImpact": {
4865
5216
  "type": "string",
@@ -4932,6 +5283,15 @@ Output schema:
4932
5283
  },
4933
5284
  "signInUrl": {
4934
5285
  "type": "string"
5286
+ },
5287
+ "currentSourceHash": {
5288
+ "type": "string"
5289
+ },
5290
+ "pendingOperationId": {
5291
+ "type": "string"
5292
+ },
5293
+ "pendingKind": {
5294
+ "type": "string"
4935
5295
  }
4936
5296
  },
4937
5297
  "required": [
@@ -5044,6 +5404,15 @@ Output schema:
5044
5404
  },
5045
5405
  "signInUrl": {
5046
5406
  "type": "string"
5407
+ },
5408
+ "currentSourceHash": {
5409
+ "type": "string"
5410
+ },
5411
+ "pendingOperationId": {
5412
+ "type": "string"
5413
+ },
5414
+ "pendingKind": {
5415
+ "type": "string"
5047
5416
  }
5048
5417
  },
5049
5418
  "required": [
@@ -5167,6 +5536,15 @@ Output schema:
5167
5536
  },
5168
5537
  "signInUrl": {
5169
5538
  "type": "string"
5539
+ },
5540
+ "currentSourceHash": {
5541
+ "type": "string"
5542
+ },
5543
+ "pendingOperationId": {
5544
+ "type": "string"
5545
+ },
5546
+ "pendingKind": {
5547
+ "type": "string"
5170
5548
  }
5171
5549
  },
5172
5550
  "required": [
@@ -5403,6 +5781,15 @@ Output schema:
5403
5781
  "signInUrl": {
5404
5782
  "type": "string"
5405
5783
  },
5784
+ "currentSourceHash": {
5785
+ "type": "string"
5786
+ },
5787
+ "pendingOperationId": {
5788
+ "type": "string"
5789
+ },
5790
+ "pendingKind": {
5791
+ "type": "string"
5792
+ },
5406
5793
  "recovery": {
5407
5794
  "type": "object",
5408
5795
  "additionalProperties": true
@@ -5535,6 +5922,15 @@ Output schema:
5535
5922
  "signInUrl": {
5536
5923
  "type": "string"
5537
5924
  },
5925
+ "currentSourceHash": {
5926
+ "type": "string"
5927
+ },
5928
+ "pendingOperationId": {
5929
+ "type": "string"
5930
+ },
5931
+ "pendingKind": {
5932
+ "type": "string"
5933
+ },
5538
5934
  "recovery": {
5539
5935
  "type": "object",
5540
5936
  "additionalProperties": true
@@ -5675,6 +6071,15 @@ Output schema:
5675
6071
  "signInUrl": {
5676
6072
  "type": "string"
5677
6073
  },
6074
+ "currentSourceHash": {
6075
+ "type": "string"
6076
+ },
6077
+ "pendingOperationId": {
6078
+ "type": "string"
6079
+ },
6080
+ "pendingKind": {
6081
+ "type": "string"
6082
+ },
5678
6083
  "recovery": {
5679
6084
  "type": "object",
5680
6085
  "additionalProperties": true
@@ -5783,6 +6188,15 @@ Output schema:
5783
6188
  "signInUrl": {
5784
6189
  "type": "string"
5785
6190
  },
6191
+ "currentSourceHash": {
6192
+ "type": "string"
6193
+ },
6194
+ "pendingOperationId": {
6195
+ "type": "string"
6196
+ },
6197
+ "pendingKind": {
6198
+ "type": "string"
6199
+ },
5786
6200
  "recovery": {
5787
6201
  "type": "object",
5788
6202
  "additionalProperties": true
@@ -5892,6 +6306,15 @@ Output schema:
5892
6306
  "signInUrl": {
5893
6307
  "type": "string"
5894
6308
  },
6309
+ "currentSourceHash": {
6310
+ "type": "string"
6311
+ },
6312
+ "pendingOperationId": {
6313
+ "type": "string"
6314
+ },
6315
+ "pendingKind": {
6316
+ "type": "string"
6317
+ },
5895
6318
  "recovery": {
5896
6319
  "type": "object",
5897
6320
  "additionalProperties": true
@@ -6006,6 +6429,15 @@ Output schema:
6006
6429
  "signInUrl": {
6007
6430
  "type": "string"
6008
6431
  },
6432
+ "currentSourceHash": {
6433
+ "type": "string"
6434
+ },
6435
+ "pendingOperationId": {
6436
+ "type": "string"
6437
+ },
6438
+ "pendingKind": {
6439
+ "type": "string"
6440
+ },
6009
6441
  "recovery": {
6010
6442
  "type": "object",
6011
6443
  "additionalProperties": true