@player-devtools/mcp 0.14.3--canary.24.1132 → 0.15.1

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/README.md CHANGED
@@ -104,9 +104,10 @@ await server.start();
104
104
  | `autoEnablePlugin` | `false` | Automatically call `enablePlugin()` for every client that connects (see [Plugin activation](#plugin-activation) below). |
105
105
 
106
106
  The CLI (`player-devtools-mcp` / `bin/run`) reads `open`/`url` from
107
- `PLAYER_DEVTOOLS_FLIPPER_OPEN` / `PLAYER_DEVTOOLS_FLIPPER_URL`, and always
108
- installs the plugin and enables it for connected/connecting clients on
109
- startup (see below) — no manual Flipper UI interaction is required.
107
+ `PLAYER_DEVTOOLS_FLIPPER_OPEN` / `PLAYER_DEVTOOLS_FLIPPER_URL`, and sets
108
+ `autoEnablePlugin: true` so every connecting client gets the plugin installed
109
+ (if needed) and activated automatically (see below) — no manual Flipper UI
110
+ interaction is required.
110
111
 
111
112
  ### Plugin installation
112
113
 
@@ -126,6 +127,13 @@ await transport.connect();
126
127
  await transport.ensurePluginInstalled();
127
128
  ```
128
129
 
130
+ `enablePlugin()` (below) already calls this internally before every
131
+ activation — the plugin can be installed or removed on the attached
132
+ flipper-server independently of this transport (e.g. a human using the
133
+ desktop UI concurrently), so there's no "already installed" snapshot that
134
+ stays trustworthy across calls. Call `ensurePluginInstalled()` directly only
135
+ if you need the installed version without also activating a client.
136
+
129
137
  ### Plugin activation
130
138
 
131
139
  Flipper only opens a live connection for a plugin (and starts relaying its
@@ -136,8 +144,8 @@ applies to `flipper-plugin-player-ui-devtools` or to a headless MCP session,
136
144
  so `FlipperServerTransport` exposes the handshake directly:
137
145
 
138
146
  ```ts
139
- await transport.enablePlugin(); // activate for every connected client
140
- await transport.enablePlugin(id); // or just one
147
+ await transport.enablePlugin(); // activate every connected client not already active
148
+ await transport.enablePlugin(id); // or just one, regardless of its active state
141
149
  await transport.disablePlugin(id); // release it again, without disconnecting
142
150
  ```
143
151
 
package/bin/run CHANGED
@@ -1,9 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  const { MCPServer } = require("@player-devtools/mcp");
4
- const {
5
- FlipperServerTransport,
6
- } = require("@player-devtools/client-flipper");
4
+ const { FlipperServerTransport } = require("@player-devtools/client-flipper");
7
5
 
8
6
  // PLAYER_DEVTOOLS_FLIPPER_OPEN=true opens a browser/PWA UI once flipper-server
9
7
  // is up (off by default — an agent has no use for a browser tab).
@@ -22,21 +20,8 @@ const server = new MCPServer(transport);
22
20
 
23
21
  server
24
22
  .start()
25
- .then(async () => {
26
- try {
27
- await transport.ensurePluginInstalled();
28
- // Catch up any client that connected before this resolved — going
29
- // forward, autoEnablePlugin covers newly-connecting clients.
30
- await transport.enablePlugin();
31
- } catch (err) {
32
- console.warn(
33
- "[bin/run] Failed to install/activate the devtools plugin:",
34
- err,
35
- );
36
- }
37
- })
38
23
  .catch((err) => {
39
- console.error("Failed to start MCP server:", err);
24
+ console.error("[@player-devtools/mcp] Failed to start MCP server:", err);
40
25
  process.exit(1);
41
26
  });
42
27
 
@@ -396,7 +396,7 @@ function allowlistEventProperties(event) {
396
396
  }
397
397
 
398
398
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
399
- var MCP_VERSION = true ? "0.14.3--canary.24.1132" : "unstamped";
399
+ var MCP_VERSION = true ? "0.15.1" : "unstamped";
400
400
  function createAnalytics(server, deps) {
401
401
  try {
402
402
  const config = resolveTelemetryConfig();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts"],"sourcesContent":["export { MCPServer } from \"./server\";\n","import {\n createExtensionClient,\n type ExtensionClient,\n} from \"@player-devtools/client\";\nimport type { Transport } from \"@player-devtools/types\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { PostHog } from \"posthog-node\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\nimport { createAnalytics, MCP_VERSION } from \"./telemetry\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n private analytics: PostHog | null;\n private transportConnected = false;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({\n name: \"player-devtools\",\n version: MCP_VERSION,\n });\n // Instrument before registering tools so every handler is wrapped.\n this.analytics = createAnalytics(this.server, {\n isTransportConnected: () => this.transportConnected,\n });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n this.transportConnected = true;\n } catch (err) {\n console.warn(\n \"[MCPServer] Transport connect failed (will operate in disconnected mode):\",\n err instanceof Error ? err.message : err,\n );\n }\n }\n\n async stop(): Promise<void> {\n // Flush buffered events first: bin/run calls process.exit(0) as soon as\n // this resolves, which would otherwise drop them. Never fail shutdown on a\n // telemetry error.\n try {\n await this.analytics?.shutdown();\n } catch {\n /* best-effort */\n }\n this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n","import * as os from \"os\";\nimport { instrument } from \"@posthog/mcp\";\nimport { PostHog } from \"posthog-node\";\n\nimport { resolveTelemetryConfig } from \"./config\";\nimport { getInstallId } from \"./installId\";\nimport { allowlistEventProperties } from \"./redaction\";\n\nexport {\n ALLOWED_EVENT_PROPERTIES,\n allowlistEventProperties,\n} from \"./redaction\";\nexport { resolveTelemetryConfig, type TelemetryConfig } from \"./config\";\nexport { getInstallId, type InstallIdDeps } from \"./installId\";\n\ndeclare global {\n const __VERSION__: string;\n}\n\n/**\n * Stamped at release build time by tsup (see devtools/tsup.config.ts). The\n * guard is required — the global is absent in local and test builds.\n */\nexport const MCP_VERSION: string =\n typeof __VERSION__ !== \"undefined\" ? __VERSION__ : \"unstamped\";\n\nexport type AnalyticsDeps = {\n /** Reports whether the devtools transport is currently connected. */\n isTransportConnected: () => boolean;\n};\n\n/**\n * Instruments `server` with anonymous usage analytics.\n *\n * Returns the PostHog client so the caller can flush it on shutdown, or `null`\n * when telemetry is disabled or no durable identity is available. Never throws:\n * telemetry must not be able to prevent the server from starting.\n */\nexport function createAnalytics(\n server: object,\n deps: AnalyticsDeps,\n): PostHog | null {\n try {\n const config = resolveTelemetryConfig();\n if (!config.enabled) return null;\n\n const installId = getInstallId();\n if (installId === null) return null;\n\n const posthog = new PostHog(config.apiKey, {\n host: config.host,\n // The load-bearing privacy control. Runs inside posthog-node's capture(),\n // so it applies to everything the MCP SDK emits regardless of the SDK's\n // own hooks. See redaction.ts for why this is an allowlist.\n before_send: [allowlistEventProperties],\n });\n\n instrument(server, posthog, {\n // Defaults to ON, and would inject a *required* `context` parameter into\n // every tool schema asking the agent to narrate user intent — mutating\n // our public tool API and adding per-call token cost.\n context: false,\n identify: { distinctId: installId },\n eventProperties: () => ({\n mcp_version: MCP_VERSION,\n os_platform: os.platform(),\n node_major: Number.parseInt(\n process.versions.node.split(\".\")[0] ?? \"\",\n 10,\n ),\n transport_connected: deps.isTransportConnected(),\n surface: \"mcp-server\",\n }),\n // Redundant with `before_send` above, kept as a second independent layer.\n // This hook fails closed: the SDK drops the event if it throws.\n beforeSend: allowlistEventProperties,\n });\n\n return posthog;\n } catch {\n // Telemetry is strictly best-effort — a misconfiguration must never take\n // down the server.\n return null;\n }\n}\n","declare global {\n const __POSTHOG_KEY__: string;\n}\n\n/**\n * PostHog project API key, stamped at release build time from the\n * `POSTHOG_PROJECT_KEY` CI environment variable (see\n * helpers/release/workspace-status.sh and tsup.config.ts), mirroring how\n * `__VERSION__` is stamped.\n *\n * This is a *public, write-only* ingestion token — it can only send events and\n * cannot read data back, which is why it is safe to ship in an open-source\n * package.\n *\n * The `typeof` guard is required: the global is absent in local and test\n * builds, where it resolves to an empty string and disables telemetry.\n */\nconst POSTHOG_PROJECT_KEY =\n typeof __POSTHOG_KEY__ !== \"undefined\" ? __POSTHOG_KEY__ : \"\";\n\nconst DEFAULT_POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nexport type TelemetryConfig =\n | { readonly enabled: false }\n | { readonly enabled: true; readonly apiKey: string; readonly host: string };\n\n/**\n * Presence of the variable opts out, *except* for explicit negatives —\n * `DO_NOT_TRACK=0` means \"tracking is fine\", not \"opted out\".\n */\nfunction isTruthy(value: string | undefined): boolean {\n if (value === undefined) return false;\n const normalized = value.trim().toLowerCase();\n if (normalized === \"\" || normalized === \"0\" || normalized === \"false\") {\n return false;\n }\n return true;\n}\n\nfunction isOptedOut(env: NodeJS.ProcessEnv): boolean {\n return (\n isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) ||\n // Cross-vendor convention (consoledonottrack.com) — honored so a user who\n // sets it once is covered everywhere.\n isTruthy(env.DO_NOT_TRACK)\n );\n}\n\nexport function resolveTelemetryConfig(\n env: NodeJS.ProcessEnv = process.env,\n): TelemetryConfig {\n if (isOptedOut(env)) return { enabled: false };\n\n const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;\n // Unstamped (local/dev builds) or unset in CI — stay silent rather than\n // firing doomed requests at PostHog on every startup.\n if (!apiKey) return { enabled: false };\n // Only public write-only project keys may ship. A `phx_` (personal) or\n // `phs_` (project secret) key is a real credential and must never be baked\n // into a published artifact, so refuse to use one even if stamped.\n if (!apiKey.startsWith(\"phc_\")) return { enabled: false };\n\n const host = (\n env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST\n ).replace(/\\/+$/, \"\");\n\n return { enabled: true, apiKey, host };\n}\n","import { randomUUID } from \"crypto\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\n\nexport type InstallIdDeps = {\n /** Resolves the user's home directory. */\n homedir: () => string;\n /** Reads the install file. */\n readFileSync: typeof fs.readFileSync;\n /** Writes the install file. */\n writeFileSync: typeof fs.writeFileSync;\n /** Creates the install directory. */\n mkdirSync: typeof fs.mkdirSync;\n /** Mints a new identifier. */\n randomUUID: () => string;\n};\n\nconst defaultDeps: InstallIdDeps = {\n homedir: os.homedir,\n readFileSync: fs.readFileSync,\n writeFileSync: fs.writeFileSync,\n mkdirSync: fs.mkdirSync,\n randomUUID,\n};\n\ntype InstallFile = { installId: string };\n\nconst UUID_PATTERN =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport const INSTALL_DIR_NAME = \".player-ui-devtools\";\nexport const INSTALL_FILE_NAME = \"install.json\";\n\n/**\n * A stable, anonymous per-machine identifier.\n *\n * Stored under the user's home directory rather than the OS temp dir the\n * flipper refcount uses: temp is periodically reaped, which would regenerate\n * the id on every reboot and turn \"unique installs\" into \"unique boots\".\n *\n * Returns `null` when the id can neither be read nor persisted (read-only FS,\n * sandbox, absent HOME). Callers treat that as \"telemetry off\" — returning an\n * in-memory id instead would register a brand-new install on every run and\n * systematically inflate counts for exactly the sandboxed population least\n * likely to be real users.\n */\nexport function getInstallId(deps: InstallIdDeps = defaultDeps): string | null {\n const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);\n const file = path.join(dir, INSTALL_FILE_NAME);\n\n try {\n const parsed = JSON.parse(\n deps.readFileSync(file, \"utf8\") as string,\n ) as Partial<InstallFile>;\n // Validate the shape, not just the parse: `{\"installId\": 42}` parses fine\n // but is not a usable identity.\n if (\n typeof parsed.installId === \"string\" &&\n UUID_PATTERN.test(parsed.installId)\n ) {\n return parsed.installId;\n }\n } catch {\n /* missing or corrupt — fall through and regenerate */\n }\n\n const installId = deps.randomUUID();\n try {\n deps.mkdirSync(dir, { recursive: true });\n const contents: InstallFile = { installId };\n // 0600: a stable per-user identifier should not be world-readable.\n deps.writeFileSync(file, JSON.stringify(contents), { mode: 0o600 });\n } catch {\n return null;\n }\n\n return installId;\n}\n","/**\n * Event property allowlist.\n *\n * `@posthog/mcp` captures tool arguments (`$mcp_parameters`) and tool results\n * (`$mcp_response`) unconditionally — there is no SDK option to disable it, and\n * its built-in sanitizer only matches sensitive *key names* (`token`,\n * `password`, ...), so a field named `flowContent` would be transmitted\n * verbatim. Devtools tool arguments carry player/plugin ids and `invoke_action`\n * payloads, i.e. potentially customer flow data.\n *\n * This is an allowlist rather than a denylist on purpose: the SDK is 0.x and\n * ships frequently, so a denylist naming today's two payload keys would\n * silently start leaking the moment a release adds a third. Anything not\n * explicitly listed here never reaches the wire.\n */\nexport const ALLOWED_EVENT_PROPERTIES: ReadonlySet<string> = new Set([\n // MCP tool call shape — names and timings only, never payloads.\n \"$mcp_tool_name\",\n \"$mcp_duration_ms\",\n \"$mcp_is_error\",\n \"$mcp_error_type\",\n \"$mcp_listed_tool_names\",\n \"$mcp_missing_capability\",\n // Which editor/agent is driving the server.\n \"$mcp_client_name\",\n \"$mcp_client_version\",\n \"$mcp_server_name\",\n \"$mcp_server_version\",\n \"$mcp_protocol_version\",\n // PostHog bookkeeping.\n \"$session_id\",\n \"$process_person_profile\",\n \"$lib\",\n \"$lib_version\",\n // Our own event properties.\n \"mcp_version\",\n \"os_platform\",\n \"node_major\",\n \"transport_connected\",\n \"surface\",\n]);\n\nexport type CapturedEvent = {\n /** Event name. */\n event?: string;\n /** Event properties. */\n properties?: Record<string, unknown>;\n};\n\n/**\n * Drops every property not in {@link ALLOWED_EVENT_PROPERTIES}.\n *\n * Installed as a `posthog-node` client-level `before_send`, which runs inside\n * `capture()` — a chokepoint the MCP SDK cannot route around, since we own the\n * client instance and it does not.\n *\n * Accepts `null` because `before_send` hooks compose: an earlier hook may have\n * already dropped the event.\n */\nexport function allowlistEventProperties<Event extends CapturedEvent>(\n event: Event | null,\n): Event | null {\n if (!event?.properties) return event;\n\n event.properties = Object.fromEntries(\n Object.entries(event.properties).filter(([key]) =>\n ALLOWED_EVENT_PROPERTIES.has(key),\n ),\n );\n\n return event;\n}\n"],"mappings":"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","names":["import_mcp","import_zod","playerIdShape","import_zod","err","ok","import_zod","err","ok","os","err"]}
1
+ {"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts"],"sourcesContent":["export { MCPServer } from \"./server\";\n","import {\n createExtensionClient,\n type ExtensionClient,\n} from \"@player-devtools/client\";\nimport type { Transport } from \"@player-devtools/types\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { PostHog } from \"posthog-node\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\nimport { createAnalytics, MCP_VERSION } from \"./telemetry\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n private analytics: PostHog | null;\n private transportConnected = false;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({\n name: \"player-devtools\",\n version: MCP_VERSION,\n });\n // Instrument before registering tools so every handler is wrapped.\n this.analytics = createAnalytics(this.server, {\n isTransportConnected: () => this.transportConnected,\n });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n this.transportConnected = true;\n } catch (err) {\n console.warn(\n \"[MCPServer] Transport connect failed (will operate in disconnected mode):\",\n err instanceof Error ? err.message : err,\n );\n }\n }\n\n async stop(): Promise<void> {\n // Flush buffered events first: bin/run calls process.exit(0) as soon as\n // this resolves, which would otherwise drop them. Never fail shutdown on a\n // telemetry error.\n try {\n await this.analytics?.shutdown();\n } catch {\n /* best-effort */\n }\n this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n","import * as os from \"os\";\nimport { instrument } from \"@posthog/mcp\";\nimport { PostHog } from \"posthog-node\";\n\nimport { resolveTelemetryConfig } from \"./config\";\nimport { getInstallId } from \"./installId\";\nimport { allowlistEventProperties } from \"./redaction\";\n\nexport {\n ALLOWED_EVENT_PROPERTIES,\n allowlistEventProperties,\n} from \"./redaction\";\nexport { resolveTelemetryConfig, type TelemetryConfig } from \"./config\";\nexport { getInstallId, type InstallIdDeps } from \"./installId\";\n\ndeclare global {\n const __VERSION__: string;\n}\n\n/**\n * Stamped at release build time by tsup (see devtools/tsup.config.ts). The\n * guard is required — the global is absent in local and test builds.\n */\nexport const MCP_VERSION: string =\n typeof __VERSION__ !== \"undefined\" ? __VERSION__ : \"unstamped\";\n\nexport type AnalyticsDeps = {\n /** Reports whether the devtools transport is currently connected. */\n isTransportConnected: () => boolean;\n};\n\n/**\n * Instruments `server` with anonymous usage analytics.\n *\n * Returns the PostHog client so the caller can flush it on shutdown, or `null`\n * when telemetry is disabled or no durable identity is available. Never throws:\n * telemetry must not be able to prevent the server from starting.\n */\nexport function createAnalytics(\n server: object,\n deps: AnalyticsDeps,\n): PostHog | null {\n try {\n const config = resolveTelemetryConfig();\n if (!config.enabled) return null;\n\n const installId = getInstallId();\n if (installId === null) return null;\n\n const posthog = new PostHog(config.apiKey, {\n host: config.host,\n // The load-bearing privacy control. Runs inside posthog-node's capture(),\n // so it applies to everything the MCP SDK emits regardless of the SDK's\n // own hooks. See redaction.ts for why this is an allowlist.\n before_send: [allowlistEventProperties],\n });\n\n instrument(server, posthog, {\n // Defaults to ON, and would inject a *required* `context` parameter into\n // every tool schema asking the agent to narrate user intent — mutating\n // our public tool API and adding per-call token cost.\n context: false,\n identify: { distinctId: installId },\n eventProperties: () => ({\n mcp_version: MCP_VERSION,\n os_platform: os.platform(),\n node_major: Number.parseInt(\n process.versions.node.split(\".\")[0] ?? \"\",\n 10,\n ),\n transport_connected: deps.isTransportConnected(),\n surface: \"mcp-server\",\n }),\n // Redundant with `before_send` above, kept as a second independent layer.\n // This hook fails closed: the SDK drops the event if it throws.\n beforeSend: allowlistEventProperties,\n });\n\n return posthog;\n } catch {\n // Telemetry is strictly best-effort — a misconfiguration must never take\n // down the server.\n return null;\n }\n}\n","declare global {\n const __POSTHOG_KEY__: string;\n}\n\n/**\n * PostHog project API key, stamped at release build time from the\n * `POSTHOG_PROJECT_KEY` CI environment variable (see\n * helpers/release/workspace-status.sh and tsup.config.ts), mirroring how\n * `__VERSION__` is stamped.\n *\n * This is a *public, write-only* ingestion token — it can only send events and\n * cannot read data back, which is why it is safe to ship in an open-source\n * package.\n *\n * The `typeof` guard is required: the global is absent in local and test\n * builds, where it resolves to an empty string and disables telemetry.\n */\nconst POSTHOG_PROJECT_KEY =\n typeof __POSTHOG_KEY__ !== \"undefined\" ? __POSTHOG_KEY__ : \"\";\n\nconst DEFAULT_POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nexport type TelemetryConfig =\n | { readonly enabled: false }\n | { readonly enabled: true; readonly apiKey: string; readonly host: string };\n\n/**\n * Presence of the variable opts out, *except* for explicit negatives —\n * `DO_NOT_TRACK=0` means \"tracking is fine\", not \"opted out\".\n */\nfunction isTruthy(value: string | undefined): boolean {\n if (value === undefined) return false;\n const normalized = value.trim().toLowerCase();\n if (normalized === \"\" || normalized === \"0\" || normalized === \"false\") {\n return false;\n }\n return true;\n}\n\nfunction isOptedOut(env: NodeJS.ProcessEnv): boolean {\n return (\n isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) ||\n // Cross-vendor convention (consoledonottrack.com) — honored so a user who\n // sets it once is covered everywhere.\n isTruthy(env.DO_NOT_TRACK)\n );\n}\n\nexport function resolveTelemetryConfig(\n env: NodeJS.ProcessEnv = process.env,\n): TelemetryConfig {\n if (isOptedOut(env)) return { enabled: false };\n\n const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;\n // Unstamped (local/dev builds) or unset in CI — stay silent rather than\n // firing doomed requests at PostHog on every startup.\n if (!apiKey) return { enabled: false };\n // Only public write-only project keys may ship. A `phx_` (personal) or\n // `phs_` (project secret) key is a real credential and must never be baked\n // into a published artifact, so refuse to use one even if stamped.\n if (!apiKey.startsWith(\"phc_\")) return { enabled: false };\n\n const host = (\n env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST\n ).replace(/\\/+$/, \"\");\n\n return { enabled: true, apiKey, host };\n}\n","import { randomUUID } from \"crypto\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\n\nexport type InstallIdDeps = {\n /** Resolves the user's home directory. */\n homedir: () => string;\n /** Reads the install file. */\n readFileSync: typeof fs.readFileSync;\n /** Writes the install file. */\n writeFileSync: typeof fs.writeFileSync;\n /** Creates the install directory. */\n mkdirSync: typeof fs.mkdirSync;\n /** Mints a new identifier. */\n randomUUID: () => string;\n};\n\nconst defaultDeps: InstallIdDeps = {\n homedir: os.homedir,\n readFileSync: fs.readFileSync,\n writeFileSync: fs.writeFileSync,\n mkdirSync: fs.mkdirSync,\n randomUUID,\n};\n\ntype InstallFile = { installId: string };\n\nconst UUID_PATTERN =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport const INSTALL_DIR_NAME = \".player-ui-devtools\";\nexport const INSTALL_FILE_NAME = \"install.json\";\n\n/**\n * A stable, anonymous per-machine identifier.\n *\n * Stored under the user's home directory rather than the OS temp dir the\n * flipper refcount uses: temp is periodically reaped, which would regenerate\n * the id on every reboot and turn \"unique installs\" into \"unique boots\".\n *\n * Returns `null` when the id can neither be read nor persisted (read-only FS,\n * sandbox, absent HOME). Callers treat that as \"telemetry off\" — returning an\n * in-memory id instead would register a brand-new install on every run and\n * systematically inflate counts for exactly the sandboxed population least\n * likely to be real users.\n */\nexport function getInstallId(deps: InstallIdDeps = defaultDeps): string | null {\n const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);\n const file = path.join(dir, INSTALL_FILE_NAME);\n\n try {\n const parsed = JSON.parse(\n deps.readFileSync(file, \"utf8\") as string,\n ) as Partial<InstallFile>;\n // Validate the shape, not just the parse: `{\"installId\": 42}` parses fine\n // but is not a usable identity.\n if (\n typeof parsed.installId === \"string\" &&\n UUID_PATTERN.test(parsed.installId)\n ) {\n return parsed.installId;\n }\n } catch {\n /* missing or corrupt — fall through and regenerate */\n }\n\n const installId = deps.randomUUID();\n try {\n deps.mkdirSync(dir, { recursive: true });\n const contents: InstallFile = { installId };\n // 0600: a stable per-user identifier should not be world-readable.\n deps.writeFileSync(file, JSON.stringify(contents), { mode: 0o600 });\n } catch {\n return null;\n }\n\n return installId;\n}\n","/**\n * Event property allowlist.\n *\n * `@posthog/mcp` captures tool arguments (`$mcp_parameters`) and tool results\n * (`$mcp_response`) unconditionally — there is no SDK option to disable it, and\n * its built-in sanitizer only matches sensitive *key names* (`token`,\n * `password`, ...), so a field named `flowContent` would be transmitted\n * verbatim. Devtools tool arguments carry player/plugin ids and `invoke_action`\n * payloads, i.e. potentially customer flow data.\n *\n * This is an allowlist rather than a denylist on purpose: the SDK is 0.x and\n * ships frequently, so a denylist naming today's two payload keys would\n * silently start leaking the moment a release adds a third. Anything not\n * explicitly listed here never reaches the wire.\n */\nexport const ALLOWED_EVENT_PROPERTIES: ReadonlySet<string> = new Set([\n // MCP tool call shape — names and timings only, never payloads.\n \"$mcp_tool_name\",\n \"$mcp_duration_ms\",\n \"$mcp_is_error\",\n \"$mcp_error_type\",\n \"$mcp_listed_tool_names\",\n \"$mcp_missing_capability\",\n // Which editor/agent is driving the server.\n \"$mcp_client_name\",\n \"$mcp_client_version\",\n \"$mcp_server_name\",\n \"$mcp_server_version\",\n \"$mcp_protocol_version\",\n // PostHog bookkeeping.\n \"$session_id\",\n \"$process_person_profile\",\n \"$lib\",\n \"$lib_version\",\n // Our own event properties.\n \"mcp_version\",\n \"os_platform\",\n \"node_major\",\n \"transport_connected\",\n \"surface\",\n]);\n\nexport type CapturedEvent = {\n /** Event name. */\n event?: string;\n /** Event properties. */\n properties?: Record<string, unknown>;\n};\n\n/**\n * Drops every property not in {@link ALLOWED_EVENT_PROPERTIES}.\n *\n * Installed as a `posthog-node` client-level `before_send`, which runs inside\n * `capture()` — a chokepoint the MCP SDK cannot route around, since we own the\n * client instance and it does not.\n *\n * Accepts `null` because `before_send` hooks compose: an earlier hook may have\n * already dropped the event.\n */\nexport function allowlistEventProperties<Event extends CapturedEvent>(\n event: Event | null,\n): Event | null {\n if (!event?.properties) return event;\n\n event.properties = Object.fromEntries(\n Object.entries(event.properties).filter(([key]) =>\n ALLOWED_EVENT_PROPERTIES.has(key),\n ),\n );\n\n return event;\n}\n"],"mappings":"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","names":["import_mcp","import_zod","playerIdShape","import_zod","err","ok","import_zod","err","ok","os","err"]}
@@ -362,7 +362,7 @@ function allowlistEventProperties(event) {
362
362
  }
363
363
 
364
364
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
365
- var MCP_VERSION = true ? "0.14.3--canary.24.1132" : "unstamped";
365
+ var MCP_VERSION = true ? "0.15.1" : "unstamped";
366
366
  function createAnalytics(server, deps) {
367
367
  try {
368
368
  const config = resolveTelemetryConfig();
package/dist/index.mjs CHANGED
@@ -362,7 +362,7 @@ function allowlistEventProperties(event) {
362
362
  }
363
363
 
364
364
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
365
- var MCP_VERSION = true ? "0.14.3--canary.24.1132" : "unstamped";
365
+ var MCP_VERSION = true ? "0.15.1" : "unstamped";
366
366
  function createAnalytics(server, deps) {
367
367
  try {
368
368
  const config = resolveTelemetryConfig();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts"],"sourcesContent":["import {\n createExtensionClient,\n type ExtensionClient,\n} from \"@player-devtools/client\";\nimport type { Transport } from \"@player-devtools/types\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { PostHog } from \"posthog-node\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\nimport { createAnalytics, MCP_VERSION } from \"./telemetry\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n private analytics: PostHog | null;\n private transportConnected = false;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({\n name: \"player-devtools\",\n version: MCP_VERSION,\n });\n // Instrument before registering tools so every handler is wrapped.\n this.analytics = createAnalytics(this.server, {\n isTransportConnected: () => this.transportConnected,\n });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n this.transportConnected = true;\n } catch (err) {\n console.warn(\n \"[MCPServer] Transport connect failed (will operate in disconnected mode):\",\n err instanceof Error ? err.message : err,\n );\n }\n }\n\n async stop(): Promise<void> {\n // Flush buffered events first: bin/run calls process.exit(0) as soon as\n // this resolves, which would otherwise drop them. Never fail shutdown on a\n // telemetry error.\n try {\n await this.analytics?.shutdown();\n } catch {\n /* best-effort */\n }\n this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n","import * as os from \"os\";\nimport { instrument } from \"@posthog/mcp\";\nimport { PostHog } from \"posthog-node\";\n\nimport { resolveTelemetryConfig } from \"./config\";\nimport { getInstallId } from \"./installId\";\nimport { allowlistEventProperties } from \"./redaction\";\n\nexport {\n ALLOWED_EVENT_PROPERTIES,\n allowlistEventProperties,\n} from \"./redaction\";\nexport { resolveTelemetryConfig, type TelemetryConfig } from \"./config\";\nexport { getInstallId, type InstallIdDeps } from \"./installId\";\n\ndeclare global {\n const __VERSION__: string;\n}\n\n/**\n * Stamped at release build time by tsup (see devtools/tsup.config.ts). The\n * guard is required — the global is absent in local and test builds.\n */\nexport const MCP_VERSION: string =\n typeof __VERSION__ !== \"undefined\" ? __VERSION__ : \"unstamped\";\n\nexport type AnalyticsDeps = {\n /** Reports whether the devtools transport is currently connected. */\n isTransportConnected: () => boolean;\n};\n\n/**\n * Instruments `server` with anonymous usage analytics.\n *\n * Returns the PostHog client so the caller can flush it on shutdown, or `null`\n * when telemetry is disabled or no durable identity is available. Never throws:\n * telemetry must not be able to prevent the server from starting.\n */\nexport function createAnalytics(\n server: object,\n deps: AnalyticsDeps,\n): PostHog | null {\n try {\n const config = resolveTelemetryConfig();\n if (!config.enabled) return null;\n\n const installId = getInstallId();\n if (installId === null) return null;\n\n const posthog = new PostHog(config.apiKey, {\n host: config.host,\n // The load-bearing privacy control. Runs inside posthog-node's capture(),\n // so it applies to everything the MCP SDK emits regardless of the SDK's\n // own hooks. See redaction.ts for why this is an allowlist.\n before_send: [allowlistEventProperties],\n });\n\n instrument(server, posthog, {\n // Defaults to ON, and would inject a *required* `context` parameter into\n // every tool schema asking the agent to narrate user intent — mutating\n // our public tool API and adding per-call token cost.\n context: false,\n identify: { distinctId: installId },\n eventProperties: () => ({\n mcp_version: MCP_VERSION,\n os_platform: os.platform(),\n node_major: Number.parseInt(\n process.versions.node.split(\".\")[0] ?? \"\",\n 10,\n ),\n transport_connected: deps.isTransportConnected(),\n surface: \"mcp-server\",\n }),\n // Redundant with `before_send` above, kept as a second independent layer.\n // This hook fails closed: the SDK drops the event if it throws.\n beforeSend: allowlistEventProperties,\n });\n\n return posthog;\n } catch {\n // Telemetry is strictly best-effort — a misconfiguration must never take\n // down the server.\n return null;\n }\n}\n","declare global {\n const __POSTHOG_KEY__: string;\n}\n\n/**\n * PostHog project API key, stamped at release build time from the\n * `POSTHOG_PROJECT_KEY` CI environment variable (see\n * helpers/release/workspace-status.sh and tsup.config.ts), mirroring how\n * `__VERSION__` is stamped.\n *\n * This is a *public, write-only* ingestion token — it can only send events and\n * cannot read data back, which is why it is safe to ship in an open-source\n * package.\n *\n * The `typeof` guard is required: the global is absent in local and test\n * builds, where it resolves to an empty string and disables telemetry.\n */\nconst POSTHOG_PROJECT_KEY =\n typeof __POSTHOG_KEY__ !== \"undefined\" ? __POSTHOG_KEY__ : \"\";\n\nconst DEFAULT_POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nexport type TelemetryConfig =\n | { readonly enabled: false }\n | { readonly enabled: true; readonly apiKey: string; readonly host: string };\n\n/**\n * Presence of the variable opts out, *except* for explicit negatives —\n * `DO_NOT_TRACK=0` means \"tracking is fine\", not \"opted out\".\n */\nfunction isTruthy(value: string | undefined): boolean {\n if (value === undefined) return false;\n const normalized = value.trim().toLowerCase();\n if (normalized === \"\" || normalized === \"0\" || normalized === \"false\") {\n return false;\n }\n return true;\n}\n\nfunction isOptedOut(env: NodeJS.ProcessEnv): boolean {\n return (\n isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) ||\n // Cross-vendor convention (consoledonottrack.com) — honored so a user who\n // sets it once is covered everywhere.\n isTruthy(env.DO_NOT_TRACK)\n );\n}\n\nexport function resolveTelemetryConfig(\n env: NodeJS.ProcessEnv = process.env,\n): TelemetryConfig {\n if (isOptedOut(env)) return { enabled: false };\n\n const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;\n // Unstamped (local/dev builds) or unset in CI — stay silent rather than\n // firing doomed requests at PostHog on every startup.\n if (!apiKey) return { enabled: false };\n // Only public write-only project keys may ship. A `phx_` (personal) or\n // `phs_` (project secret) key is a real credential and must never be baked\n // into a published artifact, so refuse to use one even if stamped.\n if (!apiKey.startsWith(\"phc_\")) return { enabled: false };\n\n const host = (\n env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST\n ).replace(/\\/+$/, \"\");\n\n return { enabled: true, apiKey, host };\n}\n","import { randomUUID } from \"crypto\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\n\nexport type InstallIdDeps = {\n /** Resolves the user's home directory. */\n homedir: () => string;\n /** Reads the install file. */\n readFileSync: typeof fs.readFileSync;\n /** Writes the install file. */\n writeFileSync: typeof fs.writeFileSync;\n /** Creates the install directory. */\n mkdirSync: typeof fs.mkdirSync;\n /** Mints a new identifier. */\n randomUUID: () => string;\n};\n\nconst defaultDeps: InstallIdDeps = {\n homedir: os.homedir,\n readFileSync: fs.readFileSync,\n writeFileSync: fs.writeFileSync,\n mkdirSync: fs.mkdirSync,\n randomUUID,\n};\n\ntype InstallFile = { installId: string };\n\nconst UUID_PATTERN =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport const INSTALL_DIR_NAME = \".player-ui-devtools\";\nexport const INSTALL_FILE_NAME = \"install.json\";\n\n/**\n * A stable, anonymous per-machine identifier.\n *\n * Stored under the user's home directory rather than the OS temp dir the\n * flipper refcount uses: temp is periodically reaped, which would regenerate\n * the id on every reboot and turn \"unique installs\" into \"unique boots\".\n *\n * Returns `null` when the id can neither be read nor persisted (read-only FS,\n * sandbox, absent HOME). Callers treat that as \"telemetry off\" — returning an\n * in-memory id instead would register a brand-new install on every run and\n * systematically inflate counts for exactly the sandboxed population least\n * likely to be real users.\n */\nexport function getInstallId(deps: InstallIdDeps = defaultDeps): string | null {\n const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);\n const file = path.join(dir, INSTALL_FILE_NAME);\n\n try {\n const parsed = JSON.parse(\n deps.readFileSync(file, \"utf8\") as string,\n ) as Partial<InstallFile>;\n // Validate the shape, not just the parse: `{\"installId\": 42}` parses fine\n // but is not a usable identity.\n if (\n typeof parsed.installId === \"string\" &&\n UUID_PATTERN.test(parsed.installId)\n ) {\n return parsed.installId;\n }\n } catch {\n /* missing or corrupt — fall through and regenerate */\n }\n\n const installId = deps.randomUUID();\n try {\n deps.mkdirSync(dir, { recursive: true });\n const contents: InstallFile = { installId };\n // 0600: a stable per-user identifier should not be world-readable.\n deps.writeFileSync(file, JSON.stringify(contents), { mode: 0o600 });\n } catch {\n return null;\n }\n\n return installId;\n}\n","/**\n * Event property allowlist.\n *\n * `@posthog/mcp` captures tool arguments (`$mcp_parameters`) and tool results\n * (`$mcp_response`) unconditionally — there is no SDK option to disable it, and\n * its built-in sanitizer only matches sensitive *key names* (`token`,\n * `password`, ...), so a field named `flowContent` would be transmitted\n * verbatim. Devtools tool arguments carry player/plugin ids and `invoke_action`\n * payloads, i.e. potentially customer flow data.\n *\n * This is an allowlist rather than a denylist on purpose: the SDK is 0.x and\n * ships frequently, so a denylist naming today's two payload keys would\n * silently start leaking the moment a release adds a third. Anything not\n * explicitly listed here never reaches the wire.\n */\nexport const ALLOWED_EVENT_PROPERTIES: ReadonlySet<string> = new Set([\n // MCP tool call shape — names and timings only, never payloads.\n \"$mcp_tool_name\",\n \"$mcp_duration_ms\",\n \"$mcp_is_error\",\n \"$mcp_error_type\",\n \"$mcp_listed_tool_names\",\n \"$mcp_missing_capability\",\n // Which editor/agent is driving the server.\n \"$mcp_client_name\",\n \"$mcp_client_version\",\n \"$mcp_server_name\",\n \"$mcp_server_version\",\n \"$mcp_protocol_version\",\n // PostHog bookkeeping.\n \"$session_id\",\n \"$process_person_profile\",\n \"$lib\",\n \"$lib_version\",\n // Our own event properties.\n \"mcp_version\",\n \"os_platform\",\n \"node_major\",\n \"transport_connected\",\n \"surface\",\n]);\n\nexport type CapturedEvent = {\n /** Event name. */\n event?: string;\n /** Event properties. */\n properties?: Record<string, unknown>;\n};\n\n/**\n * Drops every property not in {@link ALLOWED_EVENT_PROPERTIES}.\n *\n * Installed as a `posthog-node` client-level `before_send`, which runs inside\n * `capture()` — a chokepoint the MCP SDK cannot route around, since we own the\n * client instance and it does not.\n *\n * Accepts `null` because `before_send` hooks compose: an earlier hook may have\n * already dropped the event.\n */\nexport function allowlistEventProperties<Event extends CapturedEvent>(\n event: Event | null,\n): Event | null {\n if (!event?.properties) return event;\n\n event.properties = Object.fromEntries(\n Object.entries(event.properties).filter(([key]) =>\n ALLOWED_EVENT_PROPERTIES.has(key),\n ),\n );\n\n return event;\n}\n"],"mappings":"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","names":["z","playerIdShape","z","err","ok","z","err","ok","os","err"]}
1
+ {"version":3,"sources":["../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts"],"sourcesContent":["import {\n createExtensionClient,\n type ExtensionClient,\n} from \"@player-devtools/client\";\nimport type { Transport } from \"@player-devtools/types\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { PostHog } from \"posthog-node\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\nimport { createAnalytics, MCP_VERSION } from \"./telemetry\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n private analytics: PostHog | null;\n private transportConnected = false;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({\n name: \"player-devtools\",\n version: MCP_VERSION,\n });\n // Instrument before registering tools so every handler is wrapped.\n this.analytics = createAnalytics(this.server, {\n isTransportConnected: () => this.transportConnected,\n });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n this.transportConnected = true;\n } catch (err) {\n console.warn(\n \"[MCPServer] Transport connect failed (will operate in disconnected mode):\",\n err instanceof Error ? err.message : err,\n );\n }\n }\n\n async stop(): Promise<void> {\n // Flush buffered events first: bin/run calls process.exit(0) as soon as\n // this resolves, which would otherwise drop them. Never fail shutdown on a\n // telemetry error.\n try {\n await this.analytics?.shutdown();\n } catch {\n /* best-effort */\n }\n this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n","import * as os from \"os\";\nimport { instrument } from \"@posthog/mcp\";\nimport { PostHog } from \"posthog-node\";\n\nimport { resolveTelemetryConfig } from \"./config\";\nimport { getInstallId } from \"./installId\";\nimport { allowlistEventProperties } from \"./redaction\";\n\nexport {\n ALLOWED_EVENT_PROPERTIES,\n allowlistEventProperties,\n} from \"./redaction\";\nexport { resolveTelemetryConfig, type TelemetryConfig } from \"./config\";\nexport { getInstallId, type InstallIdDeps } from \"./installId\";\n\ndeclare global {\n const __VERSION__: string;\n}\n\n/**\n * Stamped at release build time by tsup (see devtools/tsup.config.ts). The\n * guard is required — the global is absent in local and test builds.\n */\nexport const MCP_VERSION: string =\n typeof __VERSION__ !== \"undefined\" ? __VERSION__ : \"unstamped\";\n\nexport type AnalyticsDeps = {\n /** Reports whether the devtools transport is currently connected. */\n isTransportConnected: () => boolean;\n};\n\n/**\n * Instruments `server` with anonymous usage analytics.\n *\n * Returns the PostHog client so the caller can flush it on shutdown, or `null`\n * when telemetry is disabled or no durable identity is available. Never throws:\n * telemetry must not be able to prevent the server from starting.\n */\nexport function createAnalytics(\n server: object,\n deps: AnalyticsDeps,\n): PostHog | null {\n try {\n const config = resolveTelemetryConfig();\n if (!config.enabled) return null;\n\n const installId = getInstallId();\n if (installId === null) return null;\n\n const posthog = new PostHog(config.apiKey, {\n host: config.host,\n // The load-bearing privacy control. Runs inside posthog-node's capture(),\n // so it applies to everything the MCP SDK emits regardless of the SDK's\n // own hooks. See redaction.ts for why this is an allowlist.\n before_send: [allowlistEventProperties],\n });\n\n instrument(server, posthog, {\n // Defaults to ON, and would inject a *required* `context` parameter into\n // every tool schema asking the agent to narrate user intent — mutating\n // our public tool API and adding per-call token cost.\n context: false,\n identify: { distinctId: installId },\n eventProperties: () => ({\n mcp_version: MCP_VERSION,\n os_platform: os.platform(),\n node_major: Number.parseInt(\n process.versions.node.split(\".\")[0] ?? \"\",\n 10,\n ),\n transport_connected: deps.isTransportConnected(),\n surface: \"mcp-server\",\n }),\n // Redundant with `before_send` above, kept as a second independent layer.\n // This hook fails closed: the SDK drops the event if it throws.\n beforeSend: allowlistEventProperties,\n });\n\n return posthog;\n } catch {\n // Telemetry is strictly best-effort — a misconfiguration must never take\n // down the server.\n return null;\n }\n}\n","declare global {\n const __POSTHOG_KEY__: string;\n}\n\n/**\n * PostHog project API key, stamped at release build time from the\n * `POSTHOG_PROJECT_KEY` CI environment variable (see\n * helpers/release/workspace-status.sh and tsup.config.ts), mirroring how\n * `__VERSION__` is stamped.\n *\n * This is a *public, write-only* ingestion token — it can only send events and\n * cannot read data back, which is why it is safe to ship in an open-source\n * package.\n *\n * The `typeof` guard is required: the global is absent in local and test\n * builds, where it resolves to an empty string and disables telemetry.\n */\nconst POSTHOG_PROJECT_KEY =\n typeof __POSTHOG_KEY__ !== \"undefined\" ? __POSTHOG_KEY__ : \"\";\n\nconst DEFAULT_POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nexport type TelemetryConfig =\n | { readonly enabled: false }\n | { readonly enabled: true; readonly apiKey: string; readonly host: string };\n\n/**\n * Presence of the variable opts out, *except* for explicit negatives —\n * `DO_NOT_TRACK=0` means \"tracking is fine\", not \"opted out\".\n */\nfunction isTruthy(value: string | undefined): boolean {\n if (value === undefined) return false;\n const normalized = value.trim().toLowerCase();\n if (normalized === \"\" || normalized === \"0\" || normalized === \"false\") {\n return false;\n }\n return true;\n}\n\nfunction isOptedOut(env: NodeJS.ProcessEnv): boolean {\n return (\n isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) ||\n // Cross-vendor convention (consoledonottrack.com) — honored so a user who\n // sets it once is covered everywhere.\n isTruthy(env.DO_NOT_TRACK)\n );\n}\n\nexport function resolveTelemetryConfig(\n env: NodeJS.ProcessEnv = process.env,\n): TelemetryConfig {\n if (isOptedOut(env)) return { enabled: false };\n\n const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;\n // Unstamped (local/dev builds) or unset in CI — stay silent rather than\n // firing doomed requests at PostHog on every startup.\n if (!apiKey) return { enabled: false };\n // Only public write-only project keys may ship. A `phx_` (personal) or\n // `phs_` (project secret) key is a real credential and must never be baked\n // into a published artifact, so refuse to use one even if stamped.\n if (!apiKey.startsWith(\"phc_\")) return { enabled: false };\n\n const host = (\n env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST\n ).replace(/\\/+$/, \"\");\n\n return { enabled: true, apiKey, host };\n}\n","import { randomUUID } from \"crypto\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\n\nexport type InstallIdDeps = {\n /** Resolves the user's home directory. */\n homedir: () => string;\n /** Reads the install file. */\n readFileSync: typeof fs.readFileSync;\n /** Writes the install file. */\n writeFileSync: typeof fs.writeFileSync;\n /** Creates the install directory. */\n mkdirSync: typeof fs.mkdirSync;\n /** Mints a new identifier. */\n randomUUID: () => string;\n};\n\nconst defaultDeps: InstallIdDeps = {\n homedir: os.homedir,\n readFileSync: fs.readFileSync,\n writeFileSync: fs.writeFileSync,\n mkdirSync: fs.mkdirSync,\n randomUUID,\n};\n\ntype InstallFile = { installId: string };\n\nconst UUID_PATTERN =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport const INSTALL_DIR_NAME = \".player-ui-devtools\";\nexport const INSTALL_FILE_NAME = \"install.json\";\n\n/**\n * A stable, anonymous per-machine identifier.\n *\n * Stored under the user's home directory rather than the OS temp dir the\n * flipper refcount uses: temp is periodically reaped, which would regenerate\n * the id on every reboot and turn \"unique installs\" into \"unique boots\".\n *\n * Returns `null` when the id can neither be read nor persisted (read-only FS,\n * sandbox, absent HOME). Callers treat that as \"telemetry off\" — returning an\n * in-memory id instead would register a brand-new install on every run and\n * systematically inflate counts for exactly the sandboxed population least\n * likely to be real users.\n */\nexport function getInstallId(deps: InstallIdDeps = defaultDeps): string | null {\n const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);\n const file = path.join(dir, INSTALL_FILE_NAME);\n\n try {\n const parsed = JSON.parse(\n deps.readFileSync(file, \"utf8\") as string,\n ) as Partial<InstallFile>;\n // Validate the shape, not just the parse: `{\"installId\": 42}` parses fine\n // but is not a usable identity.\n if (\n typeof parsed.installId === \"string\" &&\n UUID_PATTERN.test(parsed.installId)\n ) {\n return parsed.installId;\n }\n } catch {\n /* missing or corrupt — fall through and regenerate */\n }\n\n const installId = deps.randomUUID();\n try {\n deps.mkdirSync(dir, { recursive: true });\n const contents: InstallFile = { installId };\n // 0600: a stable per-user identifier should not be world-readable.\n deps.writeFileSync(file, JSON.stringify(contents), { mode: 0o600 });\n } catch {\n return null;\n }\n\n return installId;\n}\n","/**\n * Event property allowlist.\n *\n * `@posthog/mcp` captures tool arguments (`$mcp_parameters`) and tool results\n * (`$mcp_response`) unconditionally — there is no SDK option to disable it, and\n * its built-in sanitizer only matches sensitive *key names* (`token`,\n * `password`, ...), so a field named `flowContent` would be transmitted\n * verbatim. Devtools tool arguments carry player/plugin ids and `invoke_action`\n * payloads, i.e. potentially customer flow data.\n *\n * This is an allowlist rather than a denylist on purpose: the SDK is 0.x and\n * ships frequently, so a denylist naming today's two payload keys would\n * silently start leaking the moment a release adds a third. Anything not\n * explicitly listed here never reaches the wire.\n */\nexport const ALLOWED_EVENT_PROPERTIES: ReadonlySet<string> = new Set([\n // MCP tool call shape — names and timings only, never payloads.\n \"$mcp_tool_name\",\n \"$mcp_duration_ms\",\n \"$mcp_is_error\",\n \"$mcp_error_type\",\n \"$mcp_listed_tool_names\",\n \"$mcp_missing_capability\",\n // Which editor/agent is driving the server.\n \"$mcp_client_name\",\n \"$mcp_client_version\",\n \"$mcp_server_name\",\n \"$mcp_server_version\",\n \"$mcp_protocol_version\",\n // PostHog bookkeeping.\n \"$session_id\",\n \"$process_person_profile\",\n \"$lib\",\n \"$lib_version\",\n // Our own event properties.\n \"mcp_version\",\n \"os_platform\",\n \"node_major\",\n \"transport_connected\",\n \"surface\",\n]);\n\nexport type CapturedEvent = {\n /** Event name. */\n event?: string;\n /** Event properties. */\n properties?: Record<string, unknown>;\n};\n\n/**\n * Drops every property not in {@link ALLOWED_EVENT_PROPERTIES}.\n *\n * Installed as a `posthog-node` client-level `before_send`, which runs inside\n * `capture()` — a chokepoint the MCP SDK cannot route around, since we own the\n * client instance and it does not.\n *\n * Accepts `null` because `before_send` hooks compose: an earlier hook may have\n * already dropped the event.\n */\nexport function allowlistEventProperties<Event extends CapturedEvent>(\n event: Event | null,\n): Event | null {\n if (!event?.properties) return event;\n\n event.properties = Object.fromEntries(\n Object.entries(event.properties).filter(([key]) =>\n ALLOWED_EVENT_PROPERTIES.has(key),\n ),\n );\n\n return event;\n}\n"],"mappings":"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","names":["z","playerIdShape","z","err","ok","z","err","ok","os","err"]}
package/package.json CHANGED
@@ -5,7 +5,7 @@
5
5
  "bin"
6
6
  ],
7
7
  "name": "@player-devtools/mcp",
8
- "version": "0.14.3--canary.24.1132",
8
+ "version": "0.15.1",
9
9
  "main": "dist/cjs/index.cjs",
10
10
  "bin": {
11
11
  "player-devtools-mcp": "bin/run"
@@ -14,10 +14,10 @@
14
14
  "node": "^20.20.0 || >=22.22.0"
15
15
  },
16
16
  "dependencies": {
17
- "@player-devtools/client": "0.14.3--canary.24.1132",
18
- "@player-devtools/client-flipper": "0.14.3--canary.24.1132",
19
- "@player-devtools/messenger": "0.14.3--canary.24.1132",
20
- "@player-devtools/types": "0.14.3--canary.24.1132",
17
+ "@player-devtools/client": "0.15.1",
18
+ "@player-devtools/client-flipper": "0.15.1",
19
+ "@player-devtools/messenger": "0.15.1",
20
+ "@player-devtools/types": "0.15.1",
21
21
  "@modelcontextprotocol/sdk": "^1.0.0",
22
22
  "@posthog/mcp": "0.10.8",
23
23
  "@types/node": "^24.0.1",