@topline-build/harness-mcp 0.9.16 → 0.9.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "@topline-build/harness-mcp",
5
- "version": "0.9.16",
5
+ "version": "0.9.18",
6
6
  "bin": {
7
7
  "topline-mcp": "dist/cli.js"
8
8
  }
@@ -12,7 +12,7 @@
12
12
  "defaultVersion": "2025-11-25",
13
13
  "server": {
14
14
  "name": "topline-build-stdio",
15
- "version": "0.9.16"
15
+ "version": "0.9.18"
16
16
  }
17
17
  },
18
18
  "generatedFrom": {
@@ -482,7 +482,7 @@
482
482
  {
483
483
  "code": "artifact_app_scaffold_starter_invalid",
484
484
  "retryable": false,
485
- "recoveryAction": "Use one of the starters: bounded-bedrock-assistant, cache-warmed-multi-source-dashboard, internal-action-tool, live-operations-dashboard, materialized-sql-data-product, precomputed-s3-report, private-api-first-app, viewer-scoped-customer-portal."
485
+ "recoveryAction": "Use one of the starters: bounded-bedrock-assistant, cache-warmed-multi-source-dashboard, internal-action-tool, live-operations-dashboard, materialized-sql-data-product, precomputed-s3-report, private-api-first-app, table-approvals-app, viewer-scoped-customer-portal."
486
486
  },
487
487
  {
488
488
  "code": "artifact_app_scaffold_starter_shape_conflict",
@@ -795,6 +795,7 @@
795
795
  "materialized-sql-data-product",
796
796
  "precomputed-s3-report",
797
797
  "private-api-first-app",
798
+ "table-approvals-app",
798
799
  "viewer-scoped-customer-portal"
799
800
  ],
800
801
  "description": "Optional Build cookbook example to start from (single shape only). Scaffolds the recipe's page and private routes with placeholder answers and scaffold-labelled checks, and returns the recipe to follow. Datasets, source bindings and secrets are left for you to add from your own data."
@@ -1036,7 +1037,15 @@
1036
1037
  "type": [
1037
1038
  "string",
1038
1039
  "null"
1039
- ]
1040
+ ],
1041
+ "description": "The one deploy id: pass it to platform_wait_artifact_deploy and platform_deploy_operation."
1042
+ },
1043
+ "deployTaskId": {
1044
+ "type": [
1045
+ "string",
1046
+ "null"
1047
+ ],
1048
+ "description": "The worker task that ran the deploy, for logs only. Not an operation id."
1040
1049
  },
1041
1050
  "bundle": {
1042
1051
  "type": "object"
@@ -1130,7 +1139,7 @@
1130
1139
  },
1131
1140
  {
1132
1141
  "name": "platform_inspect_artifact_app",
1133
- "description": "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.",
1142
+ "description": "Inspect local artifact paths and package boundaries without creating a remote draft, building or spending anything. 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). When this computer is signed in to Topline, it also sends the bundle to Topline's preflight, which runs the build's own local validation (undeclared_package_import and the rest) and the manifest rules the server applies on save; serverChecks says whether that ran. 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.",
1134
1143
  "annotations": {
1135
1144
  "title": "Platform Inspect Artifact App",
1136
1145
  "readOnlyHint": true,
@@ -1182,7 +1191,12 @@
1182
1191
  "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."
1183
1192
  },
1184
1193
  "serverManifestValidationRequired": {
1185
- "type": "boolean"
1194
+ "type": "boolean",
1195
+ "description": "True when Topline's preflight did not run (see serverChecks), so the server's manifest rules and the build's local validation are still unchecked."
1196
+ },
1197
+ "serverChecks": {
1198
+ "type": "string",
1199
+ "description": "passed, failed (its problems are in problems), or skipped:<reason> (not signed in, an older Topline without the preflight, or the request failed)."
1186
1200
  },
1187
1201
  "appDir": {
1188
1202
  "type": "string"
@@ -4588,9 +4602,172 @@
4588
4602
  }
4589
4603
  ]
4590
4604
  },
4605
+ {
4606
+ "name": "platform_request_build_secret",
4607
+ "description": "Ask a person for a named key this app needs (an API key, webhook URL or token) without ever seeing it. Check platform_list_build_secrets first and never ask twice. Without source, Topline posts a request card in the session's build thread and returns pending with threadUrl and instructions: tell the person to open threadUrl, find the card titled with your label, and paste the value there or pick a saved key. Never ask them to paste it into your chat. Pass source only when the person says the key is already on this machine: {fromEnv: \"VAR\"} reads an environment variable, {fromFile: \".env\", key: \"VAR\"} reads a dotenv file inside the workspace. This helper reads the value here and uploads it to Topline itself; you get back only provided. Never search files for keys on your own.",
4608
+ "annotations": {
4609
+ "title": "Platform Request Build Secret",
4610
+ "readOnlyHint": false,
4611
+ "destructiveHint": false,
4612
+ "idempotentHint": true,
4613
+ "openWorldHint": true
4614
+ },
4615
+ "inputSchema": {
4616
+ "type": "object",
4617
+ "additionalProperties": false,
4618
+ "properties": {
4619
+ "sessionId": {
4620
+ "type": "string",
4621
+ "format": "uuid"
4622
+ },
4623
+ "idempotencyKey": {
4624
+ "type": "string",
4625
+ "minLength": 1,
4626
+ "maxLength": 128,
4627
+ "pattern": "^[A-Za-z0-9._:-]+$"
4628
+ },
4629
+ "name": {
4630
+ "type": "string",
4631
+ "pattern": "^[a-z][a-z0-9_]{0,30}$"
4632
+ },
4633
+ "label": {
4634
+ "type": "string",
4635
+ "minLength": 1,
4636
+ "maxLength": 200
4637
+ },
4638
+ "reason": {
4639
+ "type": "string",
4640
+ "minLength": 3,
4641
+ "maxLength": 300
4642
+ },
4643
+ "hint": {
4644
+ "type": "string",
4645
+ "maxLength": 300
4646
+ },
4647
+ "source": {
4648
+ "oneOf": [
4649
+ {
4650
+ "type": "object",
4651
+ "additionalProperties": false,
4652
+ "properties": {
4653
+ "fromEnv": {
4654
+ "type": "string",
4655
+ "minLength": 1,
4656
+ "maxLength": 128
4657
+ }
4658
+ },
4659
+ "required": [
4660
+ "fromEnv"
4661
+ ]
4662
+ },
4663
+ {
4664
+ "type": "object",
4665
+ "additionalProperties": false,
4666
+ "properties": {
4667
+ "fromFile": {
4668
+ "type": "string",
4669
+ "minLength": 1
4670
+ },
4671
+ "key": {
4672
+ "type": "string",
4673
+ "minLength": 1,
4674
+ "maxLength": 128
4675
+ }
4676
+ },
4677
+ "required": [
4678
+ "fromFile",
4679
+ "key"
4680
+ ]
4681
+ }
4682
+ ]
4683
+ }
4684
+ },
4685
+ "required": [
4686
+ "sessionId",
4687
+ "idempotencyKey",
4688
+ "name",
4689
+ "label",
4690
+ "reason"
4691
+ ]
4692
+ },
4693
+ "outputSchema": {
4694
+ "type": "object",
4695
+ "oneOf": [
4696
+ {
4697
+ "type": "object",
4698
+ "properties": {
4699
+ "ok": {
4700
+ "const": true
4701
+ }
4702
+ }
4703
+ },
4704
+ {
4705
+ "type": "object",
4706
+ "properties": {
4707
+ "ok": {
4708
+ "const": false
4709
+ },
4710
+ "error": {
4711
+ "type": "object",
4712
+ "properties": {
4713
+ "code": {
4714
+ "type": "string"
4715
+ },
4716
+ "message": {
4717
+ "type": "string"
4718
+ },
4719
+ "retryable": {
4720
+ "type": "boolean"
4721
+ },
4722
+ "recoveryAction": {
4723
+ "type": "string"
4724
+ },
4725
+ "signInUrl": {
4726
+ "type": "string"
4727
+ },
4728
+ "currentSourceHash": {
4729
+ "type": "string"
4730
+ },
4731
+ "pendingOperationId": {
4732
+ "type": "string"
4733
+ },
4734
+ "pendingKind": {
4735
+ "type": "string"
4736
+ }
4737
+ },
4738
+ "required": [
4739
+ "code",
4740
+ "message",
4741
+ "retryable",
4742
+ "recoveryAction"
4743
+ ],
4744
+ "additionalProperties": false
4745
+ }
4746
+ },
4747
+ "required": [
4748
+ "ok",
4749
+ "error"
4750
+ ],
4751
+ "additionalProperties": false
4752
+ }
4753
+ ]
4754
+ },
4755
+ "examples": [
4756
+ {
4757
+ "request": {
4758
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4759
+ "idempotencyKey": "example-request",
4760
+ "name": "slack_webhook_url",
4761
+ "label": "<label>",
4762
+ "reason": "<reason>"
4763
+ },
4764
+ "success": {}
4765
+ }
4766
+ ]
4767
+ },
4591
4768
  {
4592
4769
  "name": "platform_list_build_secrets",
4593
- "description": "Read only exact operator-approved binding references for this session. Values are never retrieved. Authoring detach does not prove deployed runtime revocation.",
4770
+ "description": "Read this session's keys: approved references to bind exactly by name, secretArn and suggestedEnv, the build thread's requests (pending, provided, declined or expired) and a plain nextStep. Read live, so a key provided after the session started counts. Values are never retrieved. Removing a key does not prove deployed runtime revocation.",
4594
4771
  "annotations": {
4595
4772
  "title": "Platform List Build Secrets",
4596
4773
  "readOnlyHint": true,
@@ -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.16`
5
+ Package: `@topline-build/harness-mcp@0.9.18`
6
6
  Transport: `stdio`
7
7
  Default protocol: `2025-11-25`
8
8
  Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -91,7 +91,7 @@ Tool failures set `isError: true` and return `structuredContent.error` with `cod
91
91
  - `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.
92
92
  - `artifact_app_scaffold_target_not_empty` (not automatically retryable): Choose an empty appDir or deploy the existing app without scaffolding.
93
93
  - `artifact_app_scaffold_shape_invalid` (not automatically retryable): Use shape single or web-and-api.
94
- - `artifact_app_scaffold_starter_invalid` (not automatically retryable): Use one of the starters: bounded-bedrock-assistant, cache-warmed-multi-source-dashboard, internal-action-tool, live-operations-dashboard, materialized-sql-data-product, precomputed-s3-report, private-api-first-app, viewer-scoped-customer-portal.
94
+ - `artifact_app_scaffold_starter_invalid` (not automatically retryable): Use one of the starters: bounded-bedrock-assistant, cache-warmed-multi-source-dashboard, internal-action-tool, live-operations-dashboard, materialized-sql-data-product, precomputed-s3-report, private-api-first-app, table-approvals-app, viewer-scoped-customer-portal.
95
95
  - `artifact_app_scaffold_starter_shape_conflict` (not automatically retryable): A starter scaffolds the single shape; leave shape out or set it to single.
96
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.
97
97
  - `artifact_package_not_ready` (not automatically retryable): platform_inspect_artifact_app reports problems Topline's build would fail on (named after the code, with file and line), so nothing was uploaded or spent. Fix them, run platform_inspect_artifact_app until packageReady is true, then deploy with the new expectedBundleSha256.
@@ -407,6 +407,7 @@ Input schema:
407
407
  "materialized-sql-data-product",
408
408
  "precomputed-s3-report",
409
409
  "private-api-first-app",
410
+ "table-approvals-app",
410
411
  "viewer-scoped-customer-portal"
411
412
  ],
412
413
  "description": "Optional Build cookbook example to start from (single shape only). Scaffolds the recipe's page and private routes with placeholder answers and scaffold-labelled checks, and returns the recipe to follow. Datasets, source bindings and secrets are left for you to add from your own data."
@@ -667,7 +668,15 @@ Output schema:
667
668
  "type": [
668
669
  "string",
669
670
  "null"
670
- ]
671
+ ],
672
+ "description": "The one deploy id: pass it to platform_wait_artifact_deploy and platform_deploy_operation."
673
+ },
674
+ "deployTaskId": {
675
+ "type": [
676
+ "string",
677
+ "null"
678
+ ],
679
+ "description": "The worker task that ran the deploy, for logs only. Not an operation id."
671
680
  },
672
681
  "bundle": {
673
682
  "type": "object"
@@ -745,7 +754,7 @@ Output schema:
745
754
 
746
755
  ### `platform_inspect_artifact_app`
747
756
 
748
- 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.
757
+ Inspect local artifact paths and package boundaries without creating a remote draft, building or spending anything. 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). When this computer is signed in to Topline, it also sends the bundle to Topline's preflight, which runs the build's own local validation (undeclared_package_import and the rest) and the manifest rules the server applies on save; serverChecks says whether that ran. 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.
749
758
 
750
759
  Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
751
760
 
@@ -825,7 +834,12 @@ Output schema:
825
834
  "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."
826
835
  },
827
836
  "serverManifestValidationRequired": {
828
- "type": "boolean"
837
+ "type": "boolean",
838
+ "description": "True when Topline's preflight did not run (see serverChecks), so the server's manifest rules and the build's local validation are still unchecked."
839
+ },
840
+ "serverChecks": {
841
+ "type": "string",
842
+ "description": "passed, failed (its problems are in problems), or skipped:<reason> (not signed in, an older Topline without the preflight, or the request failed)."
829
843
  },
830
844
  "appDir": {
831
845
  "type": "string"
@@ -4530,9 +4544,183 @@ Output schema:
4530
4544
  }
4531
4545
  ```
4532
4546
 
4547
+ ### `platform_request_build_secret`
4548
+
4549
+ Ask a person for a named key this app needs (an API key, webhook URL or token) without ever seeing it. Check platform_list_build_secrets first and never ask twice. Without source, Topline posts a request card in the session's build thread and returns pending with threadUrl and instructions: tell the person to open threadUrl, find the card titled with your label, and paste the value there or pick a saved key. Never ask them to paste it into your chat. Pass source only when the person says the key is already on this machine: {fromEnv: "VAR"} reads an environment variable, {fromFile: ".env", key: "VAR"} reads a dotenv file inside the workspace. This helper reads the value here and uploads it to Topline itself; you get back only provided. Never search files for keys on your own.
4550
+
4551
+ Safety: read-only=false, destructive=false, idempotent=true, open-world=true.
4552
+
4553
+ Example request:
4554
+
4555
+ ```json
4556
+ {
4557
+ "sessionId": "00000000-0000-4000-8000-000000000001",
4558
+ "idempotencyKey": "example-request",
4559
+ "name": "slack_webhook_url",
4560
+ "label": "<label>",
4561
+ "reason": "<reason>"
4562
+ }
4563
+ ```
4564
+
4565
+ Example success:
4566
+
4567
+ ```json
4568
+ {}
4569
+ ```
4570
+
4571
+ Input schema:
4572
+
4573
+ ```json
4574
+ {
4575
+ "type": "object",
4576
+ "additionalProperties": false,
4577
+ "properties": {
4578
+ "sessionId": {
4579
+ "type": "string",
4580
+ "format": "uuid"
4581
+ },
4582
+ "idempotencyKey": {
4583
+ "type": "string",
4584
+ "minLength": 1,
4585
+ "maxLength": 128,
4586
+ "pattern": "^[A-Za-z0-9._:-]+$"
4587
+ },
4588
+ "name": {
4589
+ "type": "string",
4590
+ "pattern": "^[a-z][a-z0-9_]{0,30}$"
4591
+ },
4592
+ "label": {
4593
+ "type": "string",
4594
+ "minLength": 1,
4595
+ "maxLength": 200
4596
+ },
4597
+ "reason": {
4598
+ "type": "string",
4599
+ "minLength": 3,
4600
+ "maxLength": 300
4601
+ },
4602
+ "hint": {
4603
+ "type": "string",
4604
+ "maxLength": 300
4605
+ },
4606
+ "source": {
4607
+ "oneOf": [
4608
+ {
4609
+ "type": "object",
4610
+ "additionalProperties": false,
4611
+ "properties": {
4612
+ "fromEnv": {
4613
+ "type": "string",
4614
+ "minLength": 1,
4615
+ "maxLength": 128
4616
+ }
4617
+ },
4618
+ "required": [
4619
+ "fromEnv"
4620
+ ]
4621
+ },
4622
+ {
4623
+ "type": "object",
4624
+ "additionalProperties": false,
4625
+ "properties": {
4626
+ "fromFile": {
4627
+ "type": "string",
4628
+ "minLength": 1
4629
+ },
4630
+ "key": {
4631
+ "type": "string",
4632
+ "minLength": 1,
4633
+ "maxLength": 128
4634
+ }
4635
+ },
4636
+ "required": [
4637
+ "fromFile",
4638
+ "key"
4639
+ ]
4640
+ }
4641
+ ]
4642
+ }
4643
+ },
4644
+ "required": [
4645
+ "sessionId",
4646
+ "idempotencyKey",
4647
+ "name",
4648
+ "label",
4649
+ "reason"
4650
+ ]
4651
+ }
4652
+ ```
4653
+
4654
+ Output schema:
4655
+
4656
+ ```json
4657
+ {
4658
+ "type": "object",
4659
+ "oneOf": [
4660
+ {
4661
+ "type": "object",
4662
+ "properties": {
4663
+ "ok": {
4664
+ "const": true
4665
+ }
4666
+ }
4667
+ },
4668
+ {
4669
+ "type": "object",
4670
+ "properties": {
4671
+ "ok": {
4672
+ "const": false
4673
+ },
4674
+ "error": {
4675
+ "type": "object",
4676
+ "properties": {
4677
+ "code": {
4678
+ "type": "string"
4679
+ },
4680
+ "message": {
4681
+ "type": "string"
4682
+ },
4683
+ "retryable": {
4684
+ "type": "boolean"
4685
+ },
4686
+ "recoveryAction": {
4687
+ "type": "string"
4688
+ },
4689
+ "signInUrl": {
4690
+ "type": "string"
4691
+ },
4692
+ "currentSourceHash": {
4693
+ "type": "string"
4694
+ },
4695
+ "pendingOperationId": {
4696
+ "type": "string"
4697
+ },
4698
+ "pendingKind": {
4699
+ "type": "string"
4700
+ }
4701
+ },
4702
+ "required": [
4703
+ "code",
4704
+ "message",
4705
+ "retryable",
4706
+ "recoveryAction"
4707
+ ],
4708
+ "additionalProperties": false
4709
+ }
4710
+ },
4711
+ "required": [
4712
+ "ok",
4713
+ "error"
4714
+ ],
4715
+ "additionalProperties": false
4716
+ }
4717
+ ]
4718
+ }
4719
+ ```
4720
+
4533
4721
  ### `platform_list_build_secrets`
4534
4722
 
4535
- Read only exact operator-approved binding references for this session. Values are never retrieved. Authoring detach does not prove deployed runtime revocation.
4723
+ Read this session's keys: approved references to bind exactly by name, secretArn and suggestedEnv, the build thread's requests (pending, provided, declined or expired) and a plain nextStep. Read live, so a key provided after the session started counts. Values are never retrieved. Removing a key does not prove deployed runtime revocation.
4536
4724
 
4537
4725
  Safety: read-only=true, destructive=false, idempotent=true, open-world=true.
4538
4726
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topline-build/harness-mcp",
3
- "version": "0.9.16",
3
+ "version": "0.9.18",
4
4
  "description": "Topline Build MCP for creating and deploying artifact app drafts.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -16,6 +16,7 @@
16
16
  "files": [
17
17
  "dist/",
18
18
  "docs/generated/",
19
+ "templates/",
19
20
  "CHANGELOG.md",
20
21
  "README.md",
21
22
  "scripts/certify-live.mjs"