@topline-build/harness-mcp 0.9.12 → 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,10 @@
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
+
5
9
  ## 0.9.12 - 2026-11-10
6
10
 
7
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.
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.12";
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[];
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.12";
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":
@@ -2064,6 +2065,41 @@ const BUILD_MCP_TOOLS = [
2064
2065
  required: ["ok", "phase", "artifactId"]
2065
2066
  }
2066
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
+ },
2067
2103
  {
2068
2104
  name: "platform_open_artifact",
2069
2105
  description: "Return the operator URL and latest draft/live URLs for a hosted artifact app.",
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "@topline-build/harness-mcp",
5
- "version": "0.9.12",
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.12"
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.",
@@ -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.12`
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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@topline-build/harness-mcp",
3
- "version": "0.9.12",
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",