@topline-build/harness-mcp 0.9.11 → 0.9.13

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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,15 @@
2
2
 
3
3
  All notable customer-visible Build MCP changes are recorded here. A source change is not a published package or customer release.
4
4
 
5
+ ## 0.9.13 - 2026-11-10
6
+
7
+ - New `platform_read_logs`, for Topline staff only: bounded, redacted reads of the platform API and worker logs and of one-off task logs (connector syncs, one-off scripts, route optimization, link migrations, a coding task's runtime lines). It forwards to the hosted Build MCP, which checks operator access and audits every read.
8
+
9
+ ## 0.9.12 - 2026-11-10
10
+
11
+ - `platform_storybook_access` says it opens your company's design system Storybook (the components artifacts use), not Topline's own app screens, and points to the new hosted tool `platform_storybook`, which lists components, reads their docs (several at once) and links story previews on this connection with no second MCP server.
12
+ - Its `auth.resourceMetadataUrl` names the Storybook MCP's own sign-in metadata. The Build MCP's metadata it named before made Claude Code and Cursor refuse to sign in to that server.
13
+
5
14
  ## 0.9.11 - 2026-11-09
6
15
 
7
16
  - Tool descriptions match the server's: `platform_artifact_validation_status` explains its version check and that an operation from another build session is refused; `platform_request_artifact_validation` gives the `waitMs` range (0 to 1000) and says an approved review leaves the draft ready for an operator to publish; `platform_run_acceptance_checks` says its pass counts cover acceptance checks only and that `renderedSmoke` reports rendered smoke.
package/dist/index.d.ts CHANGED
@@ -42,7 +42,7 @@ type ToolProgressReporter = (progress: number, message: string) => void | Promis
42
42
  export type McpSurface = "build" | "topline" | "harness";
43
43
  export declare const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
44
44
  export declare const BUILD_MCP_SERVER_NAME = "topline-build-stdio";
45
- export declare const HARNESS_MCP_VERSION = "0.9.11";
45
+ export declare const HARNESS_MCP_VERSION = "0.9.13";
46
46
  export declare const DEFAULT_OAUTH_SCOPES: readonly string[];
47
47
  /** The Topline server's scopes: Build and Workspace. Consent shows what the seat allows. */
48
48
  export declare const TOPLINE_OAUTH_SCOPES: readonly string[];
@@ -224,6 +224,7 @@ export declare function storybookAccess(opts: HarnessMcpStdioOptions): {
224
224
  scope: string;
225
225
  manualBearerEnv: string;
226
226
  };
227
+ tools: string[];
227
228
  operatorAction: string;
228
229
  };
229
230
  export declare function packArtifactAppDirectory(appDir: string, archivePrefix?: string): Promise<PackedArtifactAppBundle>;
package/dist/index.js CHANGED
@@ -19,7 +19,7 @@ const MCP_SURFACES = ["build", "topline", "harness"];
19
19
  export const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
20
20
  const DEFAULT_TIMEOUT_MS = 120_000;
21
21
  export const BUILD_MCP_SERVER_NAME = "topline-build-stdio";
22
- export const HARNESS_MCP_VERSION = "0.9.11";
22
+ export const HARNESS_MCP_VERSION = "0.9.13";
23
23
  export const DEFAULT_OAUTH_SCOPES = Object.freeze(["harness:artifact:read", "harness:artifact:write", "harness:artifact:deploy", "harness:artifact:delete"]);
24
24
  /** The Topline server's scopes: Build and Workspace. Consent shows what the seat allows. */
25
25
  export const TOPLINE_OAUTH_SCOPES = Object.freeze([
@@ -833,6 +833,7 @@ export async function callHarnessTool(opts, name, args, hooks) {
833
833
  case "platform_validate_artifact":
834
834
  case "platform_plan_artifact_draft_delete":
835
835
  case "platform_delete_artifact_draft":
836
+ case "platform_read_logs":
836
837
  result = toolResult(await callHostedBuildTool(opts, name, input));
837
838
  break;
838
839
  case "platform_run_artifact_smoke":
@@ -1547,11 +1548,13 @@ export function storybookAccess(opts) {
1547
1548
  auth: {
1548
1549
  mcp: "topline_harness_bearer_with_harness_artifact_read",
1549
1550
  preview: "topline_browser_session",
1550
- resourceMetadataUrl: `${baseUrl}/.well-known/oauth-protected-resource/mcp/${mcpSurface(opts)}`,
1551
+ // The Storybook MCP's own protected resource: OAuth clients refuse metadata for another address.
1552
+ resourceMetadataUrl: `${baseUrl}/.well-known/oauth-protected-resource/api/design-systems/storybook/mcp`,
1551
1553
  scope: "harness:artifact:read",
1552
1554
  manualBearerEnv: "TOPLINE_MCP_TOKEN"
1553
1555
  },
1554
- operatorAction: "Use cursorMcpJson for MCP clients with HTTP OAuth support. If your client requires static headers, use manualBearerMcpJson with a read-scoped TOPLINE_MCP_TOKEN. Open the preview URL in a browser signed in to Topline."
1556
+ tools: ["platform_storybook"],
1557
+ operatorAction: "This is the company's design system Storybook (the components artifacts use), not Topline's own app UI. Read its components with platform_storybook on this connection; no second MCP server is needed. To add the Storybook MCP separately anyway, use cursorMcpJson for MCP clients with HTTP OAuth support, or manualBearerMcpJson with a read-scoped TOPLINE_MCP_TOKEN. Open the preview URL in a browser signed in to Topline."
1555
1558
  };
1556
1559
  }
1557
1560
  export async function packArtifactAppDirectory(appDir, archivePrefix = "") {
@@ -2062,6 +2065,41 @@ const BUILD_MCP_TOOLS = [
2062
2065
  required: ["ok", "phase", "artifactId"]
2063
2066
  }
2064
2067
  },
2068
+ {
2069
+ name: "platform_read_logs",
2070
+ description: "Topline staff only. Read bounded, redacted logs for this Topline account: target api or worker (the platform API and worker), all (both), or task (one-off ECS tasks: connector syncs, one-off scripts, route optimization, link migrations; kind coding_runtime reads a coding task's runtime lines in Topline's own workspace). For task, no taskId or runId lists recent tasks; taskId reads one task with its exit code; runId (a Sync history run) finds the sync task that ran it. Task logs need Task logs turned on for the account. Every read is audited.",
2071
+ annotations: mcpToolAnnotations("platform_read_logs", { readOnly: true }),
2072
+ inputSchema: {
2073
+ type: "object",
2074
+ properties: {
2075
+ target: { type: "string", enum: ["api", "worker", "all", "task"], description: "api, worker or all: the platform service logs. task: one-off ECS task logs." },
2076
+ kind: { type: "string", enum: ["any", "pipeline", "one_off", "route_optimization", "link_migration", "coding_runtime"], description: "task: which tasks. any (default) is every kind but coding_runtime." },
2077
+ taskId: { type: "string", maxLength: 64, description: "task: one ECS task id (32 hex characters), or the coding task id for kind coding_runtime." },
2078
+ runId: { type: "string", format: "uuid", description: "task: a task run id from Sync history." },
2079
+ query: { type: "string", maxLength: 200, description: "Case-insensitive substring filter on the redacted lines." },
2080
+ level: { type: "string", enum: ["error", "warning", "info", "debug"], description: "Minimum severity. Defaults to info." },
2081
+ since: { type: "string", description: "ISO timestamp. Defaults to windowMinutes back from now." },
2082
+ windowMinutes: { type: "number", minimum: 1, maximum: 1440, description: "Recent window when since is omitted. Defaults to 60." },
2083
+ limit: { type: "number", minimum: 1, maximum: 200, description: "Maximum lines returned. Defaults to 50." },
2084
+ purpose: { type: "string", maxLength: 300, description: "Short reason, kept in the audit row." }
2085
+ },
2086
+ required: ["target"],
2087
+ additionalProperties: false
2088
+ },
2089
+ outputSchema: {
2090
+ type: "object",
2091
+ properties: {
2092
+ status: { type: "string" },
2093
+ service: { type: ["string", "null"] },
2094
+ summary: { type: "string" },
2095
+ nextAction: { type: "string" },
2096
+ logCount: { type: "number" },
2097
+ logs: { type: "array", items: { type: "object" } },
2098
+ tasks: { type: "array", items: { type: "object" } }
2099
+ },
2100
+ required: ["status", "summary"]
2101
+ }
2102
+ },
2065
2103
  {
2066
2104
  name: "platform_open_artifact",
2067
2105
  description: "Return the operator URL and latest draft/live URLs for a hosted artifact app.",
@@ -2083,7 +2121,7 @@ const BUILD_MCP_TOOLS = [
2083
2121
  },
2084
2122
  {
2085
2123
  name: "platform_storybook_access",
2086
- description: "Return the tenant Storybook preview URL and HTTP MCP server config.",
2124
+ description: "Return the preview URL and optional separate HTTP MCP config for this company's design system Storybook (the components artifacts use, not Topline's own app UI). To read component docs or preview stories, call platform_storybook on this connection instead; no second server is needed.",
2087
2125
  annotations: mcpToolAnnotations("platform_storybook_access", { readOnly: true }),
2088
2126
  inputSchema: {
2089
2127
  type: "object",
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "@topline-build/harness-mcp",
5
- "version": "0.9.11",
5
+ "version": "0.9.13",
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.11"
15
+ "version": "0.9.13"
16
16
  }
17
17
  },
18
18
  "generatedFrom": {
@@ -1929,6 +1929,188 @@
1929
1929
  }
1930
1930
  ]
1931
1931
  },
1932
+ {
1933
+ "name": "platform_read_logs",
1934
+ "description": "Topline staff only. Read bounded, redacted logs for this Topline account: target api or worker (the platform API and worker), all (both), or task (one-off ECS tasks: connector syncs, one-off scripts, route optimization, link migrations; kind coding_runtime reads a coding task's runtime lines in Topline's own workspace). For task, no taskId or runId lists recent tasks; taskId reads one task with its exit code; runId (a Sync history run) finds the sync task that ran it. Task logs need Task logs turned on for the account. Every read is audited.",
1935
+ "annotations": {
1936
+ "title": "Platform Read Logs",
1937
+ "readOnlyHint": true,
1938
+ "destructiveHint": false,
1939
+ "openWorldHint": false
1940
+ },
1941
+ "inputSchema": {
1942
+ "type": "object",
1943
+ "properties": {
1944
+ "target": {
1945
+ "type": "string",
1946
+ "enum": [
1947
+ "api",
1948
+ "worker",
1949
+ "all",
1950
+ "task"
1951
+ ],
1952
+ "description": "api, worker or all: the platform service logs. task: one-off ECS task logs."
1953
+ },
1954
+ "kind": {
1955
+ "type": "string",
1956
+ "enum": [
1957
+ "any",
1958
+ "pipeline",
1959
+ "one_off",
1960
+ "route_optimization",
1961
+ "link_migration",
1962
+ "coding_runtime"
1963
+ ],
1964
+ "description": "task: which tasks. any (default) is every kind but coding_runtime."
1965
+ },
1966
+ "taskId": {
1967
+ "type": "string",
1968
+ "maxLength": 64,
1969
+ "description": "task: one ECS task id (32 hex characters), or the coding task id for kind coding_runtime."
1970
+ },
1971
+ "runId": {
1972
+ "type": "string",
1973
+ "format": "uuid",
1974
+ "description": "task: a task run id from Sync history."
1975
+ },
1976
+ "query": {
1977
+ "type": "string",
1978
+ "maxLength": 200,
1979
+ "description": "Case-insensitive substring filter on the redacted lines."
1980
+ },
1981
+ "level": {
1982
+ "type": "string",
1983
+ "enum": [
1984
+ "error",
1985
+ "warning",
1986
+ "info",
1987
+ "debug"
1988
+ ],
1989
+ "description": "Minimum severity. Defaults to info."
1990
+ },
1991
+ "since": {
1992
+ "type": "string",
1993
+ "description": "ISO timestamp. Defaults to windowMinutes back from now."
1994
+ },
1995
+ "windowMinutes": {
1996
+ "type": "number",
1997
+ "minimum": 1,
1998
+ "maximum": 1440,
1999
+ "description": "Recent window when since is omitted. Defaults to 60."
2000
+ },
2001
+ "limit": {
2002
+ "type": "number",
2003
+ "minimum": 1,
2004
+ "maximum": 200,
2005
+ "description": "Maximum lines returned. Defaults to 50."
2006
+ },
2007
+ "purpose": {
2008
+ "type": "string",
2009
+ "maxLength": 300,
2010
+ "description": "Short reason, kept in the audit row."
2011
+ }
2012
+ },
2013
+ "required": [
2014
+ "target"
2015
+ ],
2016
+ "additionalProperties": false
2017
+ },
2018
+ "outputSchema": {
2019
+ "type": "object",
2020
+ "oneOf": [
2021
+ {
2022
+ "type": "object",
2023
+ "properties": {
2024
+ "status": {
2025
+ "type": "string"
2026
+ },
2027
+ "service": {
2028
+ "type": [
2029
+ "string",
2030
+ "null"
2031
+ ]
2032
+ },
2033
+ "summary": {
2034
+ "type": "string"
2035
+ },
2036
+ "nextAction": {
2037
+ "type": "string"
2038
+ },
2039
+ "logCount": {
2040
+ "type": "number"
2041
+ },
2042
+ "logs": {
2043
+ "type": "array",
2044
+ "items": {
2045
+ "type": "object"
2046
+ }
2047
+ },
2048
+ "tasks": {
2049
+ "type": "array",
2050
+ "items": {
2051
+ "type": "object"
2052
+ }
2053
+ }
2054
+ },
2055
+ "required": [
2056
+ "status",
2057
+ "summary"
2058
+ ]
2059
+ },
2060
+ {
2061
+ "type": "object",
2062
+ "properties": {
2063
+ "ok": {
2064
+ "const": false
2065
+ },
2066
+ "error": {
2067
+ "type": "object",
2068
+ "properties": {
2069
+ "code": {
2070
+ "type": "string"
2071
+ },
2072
+ "message": {
2073
+ "type": "string"
2074
+ },
2075
+ "retryable": {
2076
+ "type": "boolean"
2077
+ },
2078
+ "recoveryAction": {
2079
+ "type": "string"
2080
+ },
2081
+ "signInUrl": {
2082
+ "type": "string"
2083
+ }
2084
+ },
2085
+ "required": [
2086
+ "code",
2087
+ "message",
2088
+ "retryable",
2089
+ "recoveryAction"
2090
+ ],
2091
+ "additionalProperties": false
2092
+ }
2093
+ },
2094
+ "required": [
2095
+ "ok",
2096
+ "error"
2097
+ ],
2098
+ "additionalProperties": false
2099
+ }
2100
+ ]
2101
+ },
2102
+ "examples": [
2103
+ {
2104
+ "request": {
2105
+ "target": "api"
2106
+ },
2107
+ "success": {
2108
+ "status": "<status>",
2109
+ "summary": "<summary>"
2110
+ }
2111
+ }
2112
+ ]
2113
+ },
1932
2114
  {
1933
2115
  "name": "platform_open_artifact",
1934
2116
  "description": "Return the operator URL and latest draft/live URLs for a hosted artifact app.",
@@ -2054,7 +2236,7 @@
2054
2236
  },
2055
2237
  {
2056
2238
  "name": "platform_storybook_access",
2057
- "description": "Return the tenant Storybook preview URL and HTTP MCP server config.",
2239
+ "description": "Return the preview URL and optional separate HTTP MCP config for this company's design system Storybook (the components artifacts use, not Topline's own app UI). To read component docs or preview stories, call platform_storybook on this connection instead; no second server is needed.",
2058
2240
  "annotations": {
2059
2241
  "title": "Platform Storybook Access",
2060
2242
  "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.11`
5
+ Package: `@topline-build/harness-mcp@0.9.13`
6
6
  Transport: `stdio`
7
7
  Default protocol: `2025-11-25`
8
8
  Canonical guide: https://topline.build/docs/build-mcp-guide
@@ -1657,6 +1657,200 @@ Output schema:
1657
1657
  }
1658
1658
  ```
1659
1659
 
1660
+ ### `platform_read_logs`
1661
+
1662
+ Topline staff only. Read bounded, redacted logs for this Topline account: target api or worker (the platform API and worker), all (both), or task (one-off ECS tasks: connector syncs, one-off scripts, route optimization, link migrations; kind coding_runtime reads a coding task's runtime lines in Topline's own workspace). For task, no taskId or runId lists recent tasks; taskId reads one task with its exit code; runId (a Sync history run) finds the sync task that ran it. Task logs need Task logs turned on for the account. Every read is audited.
1663
+
1664
+ Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
1665
+
1666
+ Example request:
1667
+
1668
+ ```json
1669
+ {
1670
+ "target": "api"
1671
+ }
1672
+ ```
1673
+
1674
+ Example success:
1675
+
1676
+ ```json
1677
+ {
1678
+ "status": "<status>",
1679
+ "summary": "<summary>"
1680
+ }
1681
+ ```
1682
+
1683
+ Input schema:
1684
+
1685
+ ```json
1686
+ {
1687
+ "type": "object",
1688
+ "properties": {
1689
+ "target": {
1690
+ "type": "string",
1691
+ "enum": [
1692
+ "api",
1693
+ "worker",
1694
+ "all",
1695
+ "task"
1696
+ ],
1697
+ "description": "api, worker or all: the platform service logs. task: one-off ECS task logs."
1698
+ },
1699
+ "kind": {
1700
+ "type": "string",
1701
+ "enum": [
1702
+ "any",
1703
+ "pipeline",
1704
+ "one_off",
1705
+ "route_optimization",
1706
+ "link_migration",
1707
+ "coding_runtime"
1708
+ ],
1709
+ "description": "task: which tasks. any (default) is every kind but coding_runtime."
1710
+ },
1711
+ "taskId": {
1712
+ "type": "string",
1713
+ "maxLength": 64,
1714
+ "description": "task: one ECS task id (32 hex characters), or the coding task id for kind coding_runtime."
1715
+ },
1716
+ "runId": {
1717
+ "type": "string",
1718
+ "format": "uuid",
1719
+ "description": "task: a task run id from Sync history."
1720
+ },
1721
+ "query": {
1722
+ "type": "string",
1723
+ "maxLength": 200,
1724
+ "description": "Case-insensitive substring filter on the redacted lines."
1725
+ },
1726
+ "level": {
1727
+ "type": "string",
1728
+ "enum": [
1729
+ "error",
1730
+ "warning",
1731
+ "info",
1732
+ "debug"
1733
+ ],
1734
+ "description": "Minimum severity. Defaults to info."
1735
+ },
1736
+ "since": {
1737
+ "type": "string",
1738
+ "description": "ISO timestamp. Defaults to windowMinutes back from now."
1739
+ },
1740
+ "windowMinutes": {
1741
+ "type": "number",
1742
+ "minimum": 1,
1743
+ "maximum": 1440,
1744
+ "description": "Recent window when since is omitted. Defaults to 60."
1745
+ },
1746
+ "limit": {
1747
+ "type": "number",
1748
+ "minimum": 1,
1749
+ "maximum": 200,
1750
+ "description": "Maximum lines returned. Defaults to 50."
1751
+ },
1752
+ "purpose": {
1753
+ "type": "string",
1754
+ "maxLength": 300,
1755
+ "description": "Short reason, kept in the audit row."
1756
+ }
1757
+ },
1758
+ "required": [
1759
+ "target"
1760
+ ],
1761
+ "additionalProperties": false
1762
+ }
1763
+ ```
1764
+
1765
+ Output schema:
1766
+
1767
+ ```json
1768
+ {
1769
+ "type": "object",
1770
+ "oneOf": [
1771
+ {
1772
+ "type": "object",
1773
+ "properties": {
1774
+ "status": {
1775
+ "type": "string"
1776
+ },
1777
+ "service": {
1778
+ "type": [
1779
+ "string",
1780
+ "null"
1781
+ ]
1782
+ },
1783
+ "summary": {
1784
+ "type": "string"
1785
+ },
1786
+ "nextAction": {
1787
+ "type": "string"
1788
+ },
1789
+ "logCount": {
1790
+ "type": "number"
1791
+ },
1792
+ "logs": {
1793
+ "type": "array",
1794
+ "items": {
1795
+ "type": "object"
1796
+ }
1797
+ },
1798
+ "tasks": {
1799
+ "type": "array",
1800
+ "items": {
1801
+ "type": "object"
1802
+ }
1803
+ }
1804
+ },
1805
+ "required": [
1806
+ "status",
1807
+ "summary"
1808
+ ]
1809
+ },
1810
+ {
1811
+ "type": "object",
1812
+ "properties": {
1813
+ "ok": {
1814
+ "const": false
1815
+ },
1816
+ "error": {
1817
+ "type": "object",
1818
+ "properties": {
1819
+ "code": {
1820
+ "type": "string"
1821
+ },
1822
+ "message": {
1823
+ "type": "string"
1824
+ },
1825
+ "retryable": {
1826
+ "type": "boolean"
1827
+ },
1828
+ "recoveryAction": {
1829
+ "type": "string"
1830
+ },
1831
+ "signInUrl": {
1832
+ "type": "string"
1833
+ }
1834
+ },
1835
+ "required": [
1836
+ "code",
1837
+ "message",
1838
+ "retryable",
1839
+ "recoveryAction"
1840
+ ],
1841
+ "additionalProperties": false
1842
+ }
1843
+ },
1844
+ "required": [
1845
+ "ok",
1846
+ "error"
1847
+ ],
1848
+ "additionalProperties": false
1849
+ }
1850
+ ]
1851
+ }
1852
+ ```
1853
+
1660
1854
  ### `platform_open_artifact`
1661
1855
 
1662
1856
  Return the operator URL and latest draft/live URLs for a hosted artifact app.
@@ -1794,7 +1988,7 @@ Output schema:
1794
1988
 
1795
1989
  ### `platform_storybook_access`
1796
1990
 
1797
- Return the tenant Storybook preview URL and HTTP MCP server config.
1991
+ Return the preview URL and optional separate HTTP MCP config for this company's design system Storybook (the components artifacts use, not Topline's own app UI). To read component docs or preview stories, call platform_storybook on this connection instead; no second server is needed.
1798
1992
 
1799
1993
  Safety: read-only=true, destructive=false, idempotent=false, open-world=false.
1800
1994
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topline-build/harness-mcp",
3
- "version": "0.9.11",
3
+ "version": "0.9.13",
4
4
  "description": "Topline Build MCP for creating and deploying artifact app drafts.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",