@topline-build/harness-mcp 0.9.1 → 0.9.3

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.1`
5
+ Package: `@topline-build/harness-mcp@0.9.3`
6
6
  Transport: `stdio`
7
7
  Default protocol: `2025-11-25`
8
8
  Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -61,13 +61,20 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
61
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
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
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.
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.
64
+ - `authorization_required` (not automatically retryable): Call platform_sign_in to start a fresh browser sign-in, and ask the person to choose Allow. If using a manual bearer token, replace the expired or revoked token instead. Recover existing artifact/deployment progress before retrying a write.
65
65
  - `scope_required` (not automatically retryable): Reconnect the Build MCP and approve the requested scope.
66
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
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.
68
68
  - `build_session_tool_unavailable` (not automatically retryable): The connection's hosted Build tool list does not offer this build session tool, so the package does not list or run it. Call platform_capability_status to see what is missing, such as a scope or capability, and reconnect through browser sign-in with any missing scope. The package asks the host to list tools again, so the tool comes back once Topline offers it.
69
+ - `manual_token_sign_in_unavailable` (not automatically retryable): This connection uses a manual bearer token, which only its owner can replace. Ask the person to replace the token in their MCP configuration.
70
+ - `sign_in_unavailable_on_harness_surface` (not automatically retryable): The harness surface signs in with a token, not a browser. Ask the person to check this connection's token.
71
+ - `sign_in_required` (not automatically retryable): Tell the person a Topline sign-in page is open in their browser, and ask them to sign in and choose Allow. If no page opened, give them signInUrl to open when it is present. Do not retry on your own: wait for the person to choose Allow, then call again. Recover existing artifact/deployment progress before retrying a write.
72
+ - `sign_in_renewed` (retryable): The sign-in is already renewed, so call this tool again; the refused call was not replayed. Recover existing artifact/deployment progress before retrying a write.
73
+ - `sign_in_unavailable` (retryable): Topline did not answer the sign-in request. Wait briefly, then call platform_sign_in again.
69
74
  - `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.
70
- - `platform_mcp_tool_error` (not automatically retryable): Read the returned error code, correct the request or OAuth scopes, then retry.
75
+ - `platform_mcp_tool_error` (not automatically retryable): Topline refused the call without a code. Read the message, correct the request, then retry. Reconnect only when the message names a missing scope.
76
+ - `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.
77
+ - `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.
71
78
  - `artifact_deploy_wait_timeout` (retryable): Call platform_wait_artifact_deploy again with the same artifactId and operationId.
72
79
  - `artifact_delete_plan_stale` (retryable): Call platform_plan_artifact_draft_delete again, review the new effects, and use its planToken.
73
80
  - `artifact_app_bundle_changed_after_inspection` (retryable): Call platform_inspect_artifact_app again, review the new bundle hash, then retry deployment with that hash.
@@ -172,6 +179,116 @@ Output schema:
172
179
  },
173
180
  "recoveryAction": {
174
181
  "type": "string"
182
+ },
183
+ "signInUrl": {
184
+ "type": "string"
185
+ }
186
+ },
187
+ "required": [
188
+ "code",
189
+ "message",
190
+ "retryable",
191
+ "recoveryAction"
192
+ ],
193
+ "additionalProperties": false
194
+ }
195
+ },
196
+ "required": [
197
+ "ok",
198
+ "error"
199
+ ],
200
+ "additionalProperties": false
201
+ }
202
+ ]
203
+ }
204
+ ```
205
+
206
+ ### `platform_sign_in`
207
+
208
+ Start a fresh Topline browser sign-in. Use it when the person asks to sign in to Topline again, or Topline keeps refusing this computer's sign-in. Returns at once: tell the person a sign-in page opened and ask them to sign in and choose Allow; if no page opened, give them signInUrl. The saved sign-in is replaced only after Allow, and the Topline tools reload then. Not available with a manual token.
209
+
210
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
211
+
212
+ Example request:
213
+
214
+ ```json
215
+ {}
216
+ ```
217
+
218
+ Example success:
219
+
220
+ ```json
221
+ {
222
+ "ok": true,
223
+ "status": "sign_in_started",
224
+ "message": "<message>"
225
+ }
226
+ ```
227
+
228
+ Input schema:
229
+
230
+ ```json
231
+ {
232
+ "type": "object",
233
+ "properties": {},
234
+ "additionalProperties": false
235
+ }
236
+ ```
237
+
238
+ Output schema:
239
+
240
+ ```json
241
+ {
242
+ "type": "object",
243
+ "oneOf": [
244
+ {
245
+ "type": "object",
246
+ "properties": {
247
+ "ok": {
248
+ "type": "boolean"
249
+ },
250
+ "status": {
251
+ "type": "string",
252
+ "enum": [
253
+ "sign_in_started"
254
+ ]
255
+ },
256
+ "message": {
257
+ "type": "string"
258
+ },
259
+ "signInUrl": {
260
+ "type": "string"
261
+ }
262
+ },
263
+ "required": [
264
+ "ok",
265
+ "status",
266
+ "message"
267
+ ]
268
+ },
269
+ {
270
+ "type": "object",
271
+ "properties": {
272
+ "ok": {
273
+ "const": false
274
+ },
275
+ "error": {
276
+ "type": "object",
277
+ "properties": {
278
+ "code": {
279
+ "type": "string"
280
+ },
281
+ "message": {
282
+ "type": "string"
283
+ },
284
+ "retryable": {
285
+ "type": "boolean"
286
+ },
287
+ "recoveryAction": {
288
+ "type": "string"
289
+ },
290
+ "signInUrl": {
291
+ "type": "string"
175
292
  }
176
293
  },
177
294
  "required": [
@@ -312,6 +429,9 @@ Output schema:
312
429
  },
313
430
  "recoveryAction": {
314
431
  "type": "string"
432
+ },
433
+ "signInUrl": {
434
+ "type": "string"
315
435
  }
316
436
  },
317
437
  "required": [
@@ -498,6 +618,9 @@ Output schema:
498
618
  },
499
619
  "recoveryAction": {
500
620
  "type": "string"
621
+ },
622
+ "signInUrl": {
623
+ "type": "string"
501
624
  }
502
625
  },
503
626
  "required": [
@@ -636,6 +759,9 @@ Output schema:
636
759
  },
637
760
  "recoveryAction": {
638
761
  "type": "string"
762
+ },
763
+ "signInUrl": {
764
+ "type": "string"
639
765
  }
640
766
  },
641
767
  "required": [
@@ -732,6 +858,9 @@ Output schema:
732
858
  },
733
859
  "recoveryAction": {
734
860
  "type": "string"
861
+ },
862
+ "signInUrl": {
863
+ "type": "string"
735
864
  }
736
865
  },
737
866
  "required": [
@@ -838,6 +967,9 @@ Output schema:
838
967
  },
839
968
  "recoveryAction": {
840
969
  "type": "string"
970
+ },
971
+ "signInUrl": {
972
+ "type": "string"
841
973
  }
842
974
  },
843
975
  "required": [
@@ -989,6 +1121,9 @@ Output schema:
989
1121
  },
990
1122
  "recoveryAction": {
991
1123
  "type": "string"
1124
+ },
1125
+ "signInUrl": {
1126
+ "type": "string"
992
1127
  }
993
1128
  },
994
1129
  "required": [
@@ -1141,6 +1276,9 @@ Output schema:
1141
1276
  },
1142
1277
  "recoveryAction": {
1143
1278
  "type": "string"
1279
+ },
1280
+ "signInUrl": {
1281
+ "type": "string"
1144
1282
  }
1145
1283
  },
1146
1284
  "required": [
@@ -1262,6 +1400,9 @@ Output schema:
1262
1400
  },
1263
1401
  "recoveryAction": {
1264
1402
  "type": "string"
1403
+ },
1404
+ "signInUrl": {
1405
+ "type": "string"
1265
1406
  }
1266
1407
  },
1267
1408
  "required": [
@@ -1285,7 +1426,7 @@ Output schema:
1285
1426
 
1286
1427
  ### `platform_read_artifact_logs`
1287
1428
 
1288
- Read bounded, redacted deployment logs for a hosted artifact app.
1429
+ Read bounded, redacted deployment logs for a hosted artifact app. Pass target "sandbox" with sessionId and sandboxId to read your own running dev sandbox's logs instead.
1289
1430
 
1290
1431
  Safety: read-only=true, destructive=false, idempotent=false, open-world=true.
1291
1432
 
@@ -1328,6 +1469,22 @@ Input schema:
1328
1469
  "live"
1329
1470
  ]
1330
1471
  },
1472
+ "target": {
1473
+ "type": "string",
1474
+ "enum": [
1475
+ "draft",
1476
+ "live",
1477
+ "sandbox"
1478
+ ]
1479
+ },
1480
+ "sessionId": {
1481
+ "type": "string",
1482
+ "format": "uuid"
1483
+ },
1484
+ "sandboxId": {
1485
+ "type": "string",
1486
+ "format": "uuid"
1487
+ },
1331
1488
  "limit": {
1332
1489
  "type": "integer",
1333
1490
  "minimum": 1,
@@ -1416,6 +1573,9 @@ Output schema:
1416
1573
  },
1417
1574
  "recoveryAction": {
1418
1575
  "type": "string"
1576
+ },
1577
+ "signInUrl": {
1578
+ "type": "string"
1419
1579
  }
1420
1580
  },
1421
1581
  "required": [
@@ -1548,6 +1708,9 @@ Output schema:
1548
1708
  },
1549
1709
  "recoveryAction": {
1550
1710
  "type": "string"
1711
+ },
1712
+ "signInUrl": {
1713
+ "type": "string"
1551
1714
  }
1552
1715
  },
1553
1716
  "required": [
@@ -1651,6 +1814,9 @@ Output schema:
1651
1814
  },
1652
1815
  "recoveryAction": {
1653
1816
  "type": "string"
1817
+ },
1818
+ "signInUrl": {
1819
+ "type": "string"
1654
1820
  }
1655
1821
  },
1656
1822
  "required": [
@@ -1729,6 +1895,9 @@ Output schema:
1729
1895
  },
1730
1896
  "recoveryAction": {
1731
1897
  "type": "string"
1898
+ },
1899
+ "signInUrl": {
1900
+ "type": "string"
1732
1901
  }
1733
1902
  },
1734
1903
  "required": [
@@ -1845,6 +2014,9 @@ Output schema:
1845
2014
  },
1846
2015
  "recoveryAction": {
1847
2016
  "type": "string"
2017
+ },
2018
+ "signInUrl": {
2019
+ "type": "string"
1848
2020
  }
1849
2021
  },
1850
2022
  "required": [
@@ -1992,6 +2164,9 @@ Output schema:
1992
2164
  },
1993
2165
  "recoveryAction": {
1994
2166
  "type": "string"
2167
+ },
2168
+ "signInUrl": {
2169
+ "type": "string"
1995
2170
  }
1996
2171
  },
1997
2172
  "required": [
@@ -2115,6 +2290,9 @@ Output schema:
2115
2290
  },
2116
2291
  "recoveryAction": {
2117
2292
  "type": "string"
2293
+ },
2294
+ "signInUrl": {
2295
+ "type": "string"
2118
2296
  }
2119
2297
  },
2120
2298
  "required": [
@@ -2236,6 +2414,9 @@ Output schema:
2236
2414
  },
2237
2415
  "recoveryAction": {
2238
2416
  "type": "string"
2417
+ },
2418
+ "signInUrl": {
2419
+ "type": "string"
2239
2420
  }
2240
2421
  },
2241
2422
  "required": [
@@ -2387,6 +2568,9 @@ Output schema:
2387
2568
  },
2388
2569
  "recoveryAction": {
2389
2570
  "type": "string"
2571
+ },
2572
+ "signInUrl": {
2573
+ "type": "string"
2390
2574
  }
2391
2575
  },
2392
2576
  "required": [
@@ -2410,7 +2594,7 @@ Output schema:
2410
2594
 
2411
2595
  ### `platform_run_artifact_smoke`
2412
2596
 
2413
- Rerun the trusted draft smoke check and return fresh rendered-page evidence.
2597
+ Rerun the trusted draft smoke check and return fresh rendered-page evidence. While you hold an open build session on the app, pass its sessionId. Pass target "sandbox" with sessionId and sandboxId to smoke your own running dev sandbox instead (advisory only).
2414
2598
 
2415
2599
  Safety: read-only=false, destructive=false, idempotent=false, open-world=true.
2416
2600
 
@@ -2448,6 +2632,21 @@ Input schema:
2448
2632
  "deploymentRecordId": {
2449
2633
  "type": "string",
2450
2634
  "format": "uuid"
2635
+ },
2636
+ "sessionId": {
2637
+ "type": "string",
2638
+ "format": "uuid"
2639
+ },
2640
+ "target": {
2641
+ "type": "string",
2642
+ "enum": [
2643
+ "draft",
2644
+ "sandbox"
2645
+ ]
2646
+ },
2647
+ "sandboxId": {
2648
+ "type": "string",
2649
+ "format": "uuid"
2451
2650
  }
2452
2651
  },
2453
2652
  "required": [
@@ -2514,6 +2713,9 @@ Output schema:
2514
2713
  },
2515
2714
  "recoveryAction": {
2516
2715
  "type": "string"
2716
+ },
2717
+ "signInUrl": {
2718
+ "type": "string"
2517
2719
  }
2518
2720
  },
2519
2721
  "required": [
@@ -2637,6 +2839,9 @@ Output schema:
2637
2839
  },
2638
2840
  "recoveryAction": {
2639
2841
  "type": "string"
2842
+ },
2843
+ "signInUrl": {
2844
+ "type": "string"
2640
2845
  }
2641
2846
  },
2642
2847
  "required": [
@@ -2757,6 +2962,9 @@ Output schema:
2757
2962
  },
2758
2963
  "recoveryAction": {
2759
2964
  "type": "string"
2965
+ },
2966
+ "signInUrl": {
2967
+ "type": "string"
2760
2968
  }
2761
2969
  },
2762
2970
  "required": [
@@ -2841,6 +3049,9 @@ Output schema:
2841
3049
  },
2842
3050
  "recoveryAction": {
2843
3051
  "type": "string"
3052
+ },
3053
+ "signInUrl": {
3054
+ "type": "string"
2844
3055
  }
2845
3056
  },
2846
3057
  "required": [
@@ -2969,6 +3180,9 @@ Output schema:
2969
3180
  },
2970
3181
  "recoveryAction": {
2971
3182
  "type": "string"
3183
+ },
3184
+ "signInUrl": {
3185
+ "type": "string"
2972
3186
  }
2973
3187
  },
2974
3188
  "required": [
@@ -3062,6 +3276,9 @@ Output schema:
3062
3276
  },
3063
3277
  "recoveryAction": {
3064
3278
  "type": "string"
3279
+ },
3280
+ "signInUrl": {
3281
+ "type": "string"
3065
3282
  }
3066
3283
  },
3067
3284
  "required": [
@@ -3155,6 +3372,9 @@ Output schema:
3155
3372
  },
3156
3373
  "recoveryAction": {
3157
3374
  "type": "string"
3375
+ },
3376
+ "signInUrl": {
3377
+ "type": "string"
3158
3378
  }
3159
3379
  },
3160
3380
  "required": [
@@ -3291,6 +3511,9 @@ Output schema:
3291
3511
  },
3292
3512
  "recoveryAction": {
3293
3513
  "type": "string"
3514
+ },
3515
+ "signInUrl": {
3516
+ "type": "string"
3294
3517
  }
3295
3518
  },
3296
3519
  "required": [
@@ -3390,6 +3613,9 @@ Output schema:
3390
3613
  },
3391
3614
  "recoveryAction": {
3392
3615
  "type": "string"
3616
+ },
3617
+ "signInUrl": {
3618
+ "type": "string"
3393
3619
  }
3394
3620
  },
3395
3621
  "required": [
@@ -3483,6 +3709,9 @@ Output schema:
3483
3709
  },
3484
3710
  "recoveryAction": {
3485
3711
  "type": "string"
3712
+ },
3713
+ "signInUrl": {
3714
+ "type": "string"
3486
3715
  }
3487
3716
  },
3488
3717
  "required": [
@@ -3593,6 +3822,9 @@ Output schema:
3593
3822
  },
3594
3823
  "recoveryAction": {
3595
3824
  "type": "string"
3825
+ },
3826
+ "signInUrl": {
3827
+ "type": "string"
3596
3828
  }
3597
3829
  },
3598
3830
  "required": [
@@ -3706,6 +3938,9 @@ Output schema:
3706
3938
  },
3707
3939
  "recoveryAction": {
3708
3940
  "type": "string"
3941
+ },
3942
+ "signInUrl": {
3943
+ "type": "string"
3709
3944
  }
3710
3945
  },
3711
3946
  "required": [
@@ -3799,6 +4034,9 @@ Output schema:
3799
4034
  },
3800
4035
  "recoveryAction": {
3801
4036
  "type": "string"
4037
+ },
4038
+ "signInUrl": {
4039
+ "type": "string"
3802
4040
  }
3803
4041
  },
3804
4042
  "required": [
@@ -3913,6 +4151,9 @@ Output schema:
3913
4151
  },
3914
4152
  "recoveryAction": {
3915
4153
  "type": "string"
4154
+ },
4155
+ "signInUrl": {
4156
+ "type": "string"
3916
4157
  }
3917
4158
  },
3918
4159
  "required": [
@@ -4020,6 +4261,9 @@ Output schema:
4020
4261
  },
4021
4262
  "recoveryAction": {
4022
4263
  "type": "string"
4264
+ },
4265
+ "signInUrl": {
4266
+ "type": "string"
4023
4267
  }
4024
4268
  },
4025
4269
  "required": [
@@ -4149,6 +4393,9 @@ Output schema:
4149
4393
  },
4150
4394
  "recoveryAction": {
4151
4395
  "type": "string"
4396
+ },
4397
+ "signInUrl": {
4398
+ "type": "string"
4152
4399
  }
4153
4400
  },
4154
4401
  "required": [
@@ -4254,6 +4501,9 @@ Output schema:
4254
4501
  },
4255
4502
  "recoveryAction": {
4256
4503
  "type": "string"
4504
+ },
4505
+ "signInUrl": {
4506
+ "type": "string"
4257
4507
  }
4258
4508
  },
4259
4509
  "required": [
@@ -4411,6 +4661,9 @@ Output schema:
4411
4661
  },
4412
4662
  "recoveryAction": {
4413
4663
  "type": "string"
4664
+ },
4665
+ "signInUrl": {
4666
+ "type": "string"
4414
4667
  }
4415
4668
  },
4416
4669
  "required": [
@@ -4510,6 +4763,9 @@ Output schema:
4510
4763
  },
4511
4764
  "recoveryAction": {
4512
4765
  "type": "string"
4766
+ },
4767
+ "signInUrl": {
4768
+ "type": "string"
4513
4769
  }
4514
4770
  },
4515
4771
  "required": [
@@ -4630,6 +4886,9 @@ Output schema:
4630
4886
  },
4631
4887
  "recoveryAction": {
4632
4888
  "type": "string"
4889
+ },
4890
+ "signInUrl": {
4891
+ "type": "string"
4633
4892
  }
4634
4893
  },
4635
4894
  "required": [
@@ -4863,6 +5122,9 @@ Output schema:
4863
5122
  "recoveryAction": {
4864
5123
  "type": "string"
4865
5124
  },
5125
+ "signInUrl": {
5126
+ "type": "string"
5127
+ },
4866
5128
  "recovery": {
4867
5129
  "type": "object",
4868
5130
  "additionalProperties": true
@@ -4992,6 +5254,9 @@ Output schema:
4992
5254
  "recoveryAction": {
4993
5255
  "type": "string"
4994
5256
  },
5257
+ "signInUrl": {
5258
+ "type": "string"
5259
+ },
4995
5260
  "recovery": {
4996
5261
  "type": "object",
4997
5262
  "additionalProperties": true
@@ -5129,6 +5394,9 @@ Output schema:
5129
5394
  "recoveryAction": {
5130
5395
  "type": "string"
5131
5396
  },
5397
+ "signInUrl": {
5398
+ "type": "string"
5399
+ },
5132
5400
  "recovery": {
5133
5401
  "type": "object",
5134
5402
  "additionalProperties": true
@@ -5234,6 +5502,9 @@ Output schema:
5234
5502
  "recoveryAction": {
5235
5503
  "type": "string"
5236
5504
  },
5505
+ "signInUrl": {
5506
+ "type": "string"
5507
+ },
5237
5508
  "recovery": {
5238
5509
  "type": "object",
5239
5510
  "additionalProperties": true
@@ -5340,6 +5611,9 @@ Output schema:
5340
5611
  "recoveryAction": {
5341
5612
  "type": "string"
5342
5613
  },
5614
+ "signInUrl": {
5615
+ "type": "string"
5616
+ },
5343
5617
  "recovery": {
5344
5618
  "type": "object",
5345
5619
  "additionalProperties": true
@@ -5451,6 +5725,9 @@ Output schema:
5451
5725
  "recoveryAction": {
5452
5726
  "type": "string"
5453
5727
  },
5728
+ "signInUrl": {
5729
+ "type": "string"
5730
+ },
5454
5731
  "recovery": {
5455
5732
  "type": "object",
5456
5733
  "additionalProperties": true
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topline-build/harness-mcp",
3
- "version": "0.9.1",
3
+ "version": "0.9.3",
4
4
  "description": "Topline Build MCP for creating and deploying artifact app drafts.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",