@player-devtools/mcp 0.16.1-next.3 → 1.0.0-next.0

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.
@@ -486,7 +486,7 @@ function allowlistEventProperties(event) {
486
486
  }
487
487
 
488
488
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
489
- var MCP_VERSION = true ? "0.16.1-next.3" : "unstamped";
489
+ var MCP_VERSION = true ? "1.0.0-next.0" : "unstamped";
490
490
  function createAnalytics(server, deps) {
491
491
  try {
492
492
  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/flipper.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: {\n description: string;\n inputSchema: ToolDef[\"inputSchema\"];\n annotations?: ToolDef[\"annotations\"];\n },\n cb: (args: unknown) => CallToolResult | Promise<CallToolResult>,\n ) => unknown;\n\n register(\n def.name,\n {\n description: def.description,\n inputSchema: def.inputSchema,\n annotations: def.annotations,\n },\n (args) => def.handle(this.client, args, this.transport),\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 { ok, err, 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\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 { ok, err, 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 ok({ players: Object.keys(players), current: current.player });\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 err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n return ok({ active: player.active, plugins: Object.keys(player.plugins) });\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 { ok, err, 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\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 { ok, err, 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\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 { Transport } from \"@player-devtools/types\";\nimport { FlipperServerTransport } from \"@player-devtools/client-flipper\";\nimport { z } from \"zod\";\n\nimport { ok, err, type ToolDef } from \"./index\";\n\nconst clientIdShape = {\n clientId: z\n .string()\n .optional()\n .describe(\n \"Flipper client ID — a transport-level device/app connection, NOT a Player devtools playerId (see list_players/select_player). A client can be connected, and even activated, before any Player instance on it is visible to those tools. Unlike playerId, there is no 'currently selected' client: omitting this targets every connected client — for enable/disable, only clients not already in the desired state are messaged.\",\n ),\n};\n\nconst ClientIdInput = z.object(clientIdShape);\n\n/** Narrow the generic `Transport` to the concrete Flipper implementation. */\nfunction asFlipperTransport(\n transport: Transport | undefined,\n): FlipperServerTransport | null {\n return transport instanceof FlipperServerTransport ? transport : null;\n}\n\nexport function handleGetFlipperStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, host, port } = flipper.getDiagnostics();\n return ok({ connected, host, port });\n}\n\nexport function handleGetFlipperConsumers(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { owns, refs, activeClientIds, connectedClientIds } =\n flipper.getDiagnostics();\n return ok({ owns, refs, activeClientIds, connectedClientIds });\n}\n\nexport async function handleRestartFlipperServer(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const result = await flipper.restart();\n if (!result.ok) return err(result.reason);\n return ok({ restarted: true, host: result.host, port: result.port });\n}\n\nexport async function handleGetFlipperPluginInstallStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n if (!flipper.getDiagnostics().connected) {\n return err(\"flipper transport not connected\");\n }\n\n const status = await flipper.getPluginInstallStatus();\n if (!status.installed && status.reason) return err(status.reason);\n return ok(status);\n}\n\nexport const getFlipperStatusDef: ToolDef = {\n name: \"get_flipper_connection_status\",\n description:\n \"Get the MCP server's basic connection health to the shared flipper-server daemon: whether it's connected, and the host/port it's connected to. For ownership/refcount/client info, use get_flipper_consumers instead.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperStatus,\n};\n\nexport const getFlipperConsumersDef: ToolDef = {\n name: \"get_flipper_consumers\",\n description:\n \"Get who else is attached to the shared flipper-server daemon: whether this process owns it, the daemon-wide refcount (reflects all consumers, not just this process), and the connected/active devtools clients on this connection.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperConsumers,\n};\n\nexport const restartFlipperServerDef: ToolDef = {\n name: \"restart_flipper_server\",\n description:\n \"Restart the shared flipper-server daemon. Only succeeds when this MCP server owns the daemon and is its sole consumer; otherwise returns a soft error rather than disrupting other consumers.\",\n inputSchema: {},\n annotations: { readOnlyHint: false, destructiveHint: true },\n handle: handleRestartFlipperServer,\n};\n\nexport const getFlipperPluginInstallStatusDef: ToolDef = {\n name: \"get_flipper_plugin_install_status\",\n description:\n \"Check whether the Player UI Devtools Flipper plugin is installed on the connected daemon.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginInstallStatus,\n};\n\nexport function handleGetFlipperPluginActivationStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, connectedClientIds, activeClientIds } =\n flipper.getDiagnostics();\n if (!connected) return err(\"flipper transport not connected\");\n\n const active = new Set(activeClientIds);\n return ok({\n activeClientIds,\n inactiveClientIds: connectedClientIds.filter((id) => !active.has(id)),\n });\n}\n\nexport async function handleEnableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.enablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ enabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport async function handleDisableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.disablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ disabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport const getFlipperPluginActivationStatusDef: ToolDef = {\n name: \"get_flipper_plugin_activation_status\",\n description:\n \"Get per-client activation status of the Player UI Devtools Flipper plugin: which connected clients have completed the init handshake (active) versus which are connected but not yet activated (inactive). Distinct from get_flipper_plugin_install_status, which only reports whether the plugin is installed on the daemon, not activated for any specific client.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginActivationStatus,\n};\n\nexport const enableFlipperPluginDef: ToolDef = {\n name: \"enable_flipper_plugin\",\n description:\n \"Activate the Player UI Devtools Flipper plugin for a client by sending the init handshake (installing the plugin on the daemon first, if needed). Pass clientId to target one client, or omit it to activate every connected client not already active. There is no direct mapping from clientId to the playerId(s) it hosts — after activating, poll list_players until the expected Player appears.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleEnableFlipperPlugin,\n};\n\nexport const disableFlipperPluginDef: ToolDef = {\n name: \"disable_flipper_plugin\",\n description:\n \"Deactivate the Player UI Devtools Flipper plugin for a client by sending the deinit handshake, without disconnecting it from flipper-server. Pass clientId to target one client, or omit it to deactivate every currently active client.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleDisableFlipperPlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type {\n CallToolResult,\n ToolAnnotations,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { Transport } from \"@player-devtools/types\";\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, the\n * validated args, and the raw `Transport` for tools that need connection-level\n * diagnostics `ExtensionClient` doesn't expose.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n annotations?: ToolAnnotations;\n handle: (\n client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n ) => CallToolResult | Promise<CallToolResult>;\n};\n\n/** Shared JSON-envelope helpers used by every tool handler in this package. */\nexport function ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\nexport * from \"./flipper\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\nimport {\n getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\n} from \"./flipper\";\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 getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\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","import_zod","import_zod","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/flipper.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: {\n description: string;\n inputSchema: ToolDef[\"inputSchema\"];\n annotations?: ToolDef[\"annotations\"];\n },\n cb: (args: unknown) => CallToolResult | Promise<CallToolResult>,\n ) => unknown;\n\n register(\n def.name,\n {\n description: def.description,\n inputSchema: def.inputSchema,\n annotations: def.annotations,\n },\n (args) => def.handle(this.client, args, this.transport),\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 { ok, err, 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\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 { ok, err, 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 ok({ players: Object.keys(players), current: current.player });\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 err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n return ok({ active: player.active, plugins: Object.keys(player.plugins) });\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 { ok, err, 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\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 { ok, err, 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\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 { Transport } from \"@player-devtools/types\";\nimport { FlipperServerTransport } from \"@player-devtools/client-flipper\";\nimport { z } from \"zod\";\n\nimport { ok, err, type ToolDef } from \"./index\";\n\nconst clientIdShape = {\n clientId: z\n .string()\n .optional()\n .describe(\n \"Flipper client ID — a transport-level device/app connection, NOT a Player devtools playerId (see list_players/select_player). A client can be connected, and even activated, before any Player instance on it is visible to those tools. Unlike playerId, there is no 'currently selected' client: omitting this targets every connected client — for enable/disable, only clients not already in the desired state are messaged.\",\n ),\n};\n\nconst ClientIdInput = z.object(clientIdShape);\n\n/** Narrow the generic `Transport` to the concrete Flipper implementation. */\nfunction asFlipperTransport(\n transport: Transport | undefined,\n): FlipperServerTransport | null {\n return transport instanceof FlipperServerTransport ? transport : null;\n}\n\nexport function handleGetFlipperStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, host, port } = flipper.getDiagnostics();\n return ok({ connected, host, port });\n}\n\nexport function handleGetFlipperConsumers(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { owns, refs, activeClientIds, connectedClientIds } =\n flipper.getDiagnostics();\n return ok({ owns, refs, activeClientIds, connectedClientIds });\n}\n\nexport async function handleRestartFlipperServer(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const result = await flipper.restart();\n if (!result.ok) return err(result.reason);\n return ok({ restarted: true, host: result.host, port: result.port });\n}\n\nexport async function handleGetFlipperPluginInstallStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n if (!flipper.getDiagnostics().connected) {\n return err(\"flipper transport not connected\");\n }\n\n const status = await flipper.getPluginInstallStatus();\n if (!status.installed && status.reason) return err(status.reason);\n return ok(status);\n}\n\nexport const getFlipperStatusDef: ToolDef = {\n name: \"get_flipper_connection_status\",\n description:\n \"Get the MCP server's basic connection health to the shared flipper-server daemon: whether it's connected, and the host/port it's connected to. For ownership/refcount/client info, use get_flipper_consumers instead.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperStatus,\n};\n\nexport const getFlipperConsumersDef: ToolDef = {\n name: \"get_flipper_consumers\",\n description:\n \"Get who else is attached to the shared flipper-server daemon: whether this process owns it, the daemon-wide refcount (reflects all consumers, not just this process), and the connected/active devtools clients on this connection.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperConsumers,\n};\n\nexport const restartFlipperServerDef: ToolDef = {\n name: \"restart_flipper_server\",\n description:\n \"Restart the shared flipper-server daemon. Only succeeds when this MCP server owns the daemon and is its sole consumer; otherwise returns a soft error rather than disrupting other consumers.\",\n inputSchema: {},\n annotations: { readOnlyHint: false, destructiveHint: true },\n handle: handleRestartFlipperServer,\n};\n\nexport const getFlipperPluginInstallStatusDef: ToolDef = {\n name: \"get_flipper_plugin_install_status\",\n description:\n \"Check whether the Player UI Devtools Flipper plugin is installed on the connected daemon.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginInstallStatus,\n};\n\nexport function handleGetFlipperPluginActivationStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, connectedClientIds, activeClientIds } =\n flipper.getDiagnostics();\n if (!connected) return err(\"flipper transport not connected\");\n\n const active = new Set(activeClientIds);\n return ok({\n activeClientIds,\n inactiveClientIds: connectedClientIds.filter((id) => !active.has(id)),\n });\n}\n\nexport async function handleEnableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.enablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ enabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport async function handleDisableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.disablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ disabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport const getFlipperPluginActivationStatusDef: ToolDef = {\n name: \"get_flipper_plugin_activation_status\",\n description:\n \"Get per-client activation status of the Player UI Devtools Flipper plugin: which connected clients have completed the init handshake (active) versus which are connected but not yet activated (inactive). Distinct from get_flipper_plugin_install_status, which only reports whether the plugin is installed on the daemon, not activated for any specific client.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginActivationStatus,\n};\n\nexport const enableFlipperPluginDef: ToolDef = {\n name: \"enable_flipper_plugin\",\n description:\n \"Activate the Player UI Devtools Flipper plugin for a client by sending the init handshake (installing the plugin on the daemon first, if needed). Pass clientId to target one client, or omit it to activate every connected client not already active. There is no direct mapping from clientId to the playerId(s) it hosts — after activating, poll list_players until the expected Player appears.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleEnableFlipperPlugin,\n};\n\nexport const disableFlipperPluginDef: ToolDef = {\n name: \"disable_flipper_plugin\",\n description:\n \"Deactivate the Player UI Devtools Flipper plugin for a client by sending the deinit handshake, without disconnecting it from flipper-server. Pass clientId to target one client, or omit it to deactivate every currently active client.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleDisableFlipperPlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type {\n CallToolResult,\n ToolAnnotations,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { Transport } from \"@player-devtools/types\";\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, the\n * validated args, and the raw `Transport` for tools that need connection-level\n * diagnostics `ExtensionClient` doesn't expose.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n annotations?: ToolAnnotations;\n handle: (\n client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n ) => CallToolResult | Promise<CallToolResult>;\n};\n\n/** Shared JSON-envelope helpers used by every tool handler in this package. */\nexport function ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\nexport * from \"./flipper\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\nimport {\n getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\n} from \"./flipper\";\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 getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\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\n// Scoped to this module so that packages declaring the same define don't\n// collide in a shared TS program.\ndeclare const __VERSION__: string;\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","import_zod","import_zod","os","err"]}
@@ -452,7 +452,7 @@ function allowlistEventProperties(event) {
452
452
  }
453
453
 
454
454
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
455
- var MCP_VERSION = true ? "0.16.1-next.3" : "unstamped";
455
+ var MCP_VERSION = true ? "1.0.0-next.0" : "unstamped";
456
456
  function createAnalytics(server, deps) {
457
457
  try {
458
458
  const config = resolveTelemetryConfig();
package/dist/index.mjs CHANGED
@@ -452,7 +452,7 @@ function allowlistEventProperties(event) {
452
452
  }
453
453
 
454
454
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
455
- var MCP_VERSION = true ? "0.16.1-next.3" : "unstamped";
455
+ var MCP_VERSION = true ? "1.0.0-next.0" : "unstamped";
456
456
  function createAnalytics(server, deps) {
457
457
  try {
458
458
  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/flipper.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: {\n description: string;\n inputSchema: ToolDef[\"inputSchema\"];\n annotations?: ToolDef[\"annotations\"];\n },\n cb: (args: unknown) => CallToolResult | Promise<CallToolResult>,\n ) => unknown;\n\n register(\n def.name,\n {\n description: def.description,\n inputSchema: def.inputSchema,\n annotations: def.annotations,\n },\n (args) => def.handle(this.client, args, this.transport),\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 { ok, err, 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\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 { ok, err, 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 ok({ players: Object.keys(players), current: current.player });\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 err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n return ok({ active: player.active, plugins: Object.keys(player.plugins) });\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 { ok, err, 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\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 { ok, err, 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\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 { Transport } from \"@player-devtools/types\";\nimport { FlipperServerTransport } from \"@player-devtools/client-flipper\";\nimport { z } from \"zod\";\n\nimport { ok, err, type ToolDef } from \"./index\";\n\nconst clientIdShape = {\n clientId: z\n .string()\n .optional()\n .describe(\n \"Flipper client ID — a transport-level device/app connection, NOT a Player devtools playerId (see list_players/select_player). A client can be connected, and even activated, before any Player instance on it is visible to those tools. Unlike playerId, there is no 'currently selected' client: omitting this targets every connected client — for enable/disable, only clients not already in the desired state are messaged.\",\n ),\n};\n\nconst ClientIdInput = z.object(clientIdShape);\n\n/** Narrow the generic `Transport` to the concrete Flipper implementation. */\nfunction asFlipperTransport(\n transport: Transport | undefined,\n): FlipperServerTransport | null {\n return transport instanceof FlipperServerTransport ? transport : null;\n}\n\nexport function handleGetFlipperStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, host, port } = flipper.getDiagnostics();\n return ok({ connected, host, port });\n}\n\nexport function handleGetFlipperConsumers(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { owns, refs, activeClientIds, connectedClientIds } =\n flipper.getDiagnostics();\n return ok({ owns, refs, activeClientIds, connectedClientIds });\n}\n\nexport async function handleRestartFlipperServer(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const result = await flipper.restart();\n if (!result.ok) return err(result.reason);\n return ok({ restarted: true, host: result.host, port: result.port });\n}\n\nexport async function handleGetFlipperPluginInstallStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n if (!flipper.getDiagnostics().connected) {\n return err(\"flipper transport not connected\");\n }\n\n const status = await flipper.getPluginInstallStatus();\n if (!status.installed && status.reason) return err(status.reason);\n return ok(status);\n}\n\nexport const getFlipperStatusDef: ToolDef = {\n name: \"get_flipper_connection_status\",\n description:\n \"Get the MCP server's basic connection health to the shared flipper-server daemon: whether it's connected, and the host/port it's connected to. For ownership/refcount/client info, use get_flipper_consumers instead.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperStatus,\n};\n\nexport const getFlipperConsumersDef: ToolDef = {\n name: \"get_flipper_consumers\",\n description:\n \"Get who else is attached to the shared flipper-server daemon: whether this process owns it, the daemon-wide refcount (reflects all consumers, not just this process), and the connected/active devtools clients on this connection.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperConsumers,\n};\n\nexport const restartFlipperServerDef: ToolDef = {\n name: \"restart_flipper_server\",\n description:\n \"Restart the shared flipper-server daemon. Only succeeds when this MCP server owns the daemon and is its sole consumer; otherwise returns a soft error rather than disrupting other consumers.\",\n inputSchema: {},\n annotations: { readOnlyHint: false, destructiveHint: true },\n handle: handleRestartFlipperServer,\n};\n\nexport const getFlipperPluginInstallStatusDef: ToolDef = {\n name: \"get_flipper_plugin_install_status\",\n description:\n \"Check whether the Player UI Devtools Flipper plugin is installed on the connected daemon.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginInstallStatus,\n};\n\nexport function handleGetFlipperPluginActivationStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, connectedClientIds, activeClientIds } =\n flipper.getDiagnostics();\n if (!connected) return err(\"flipper transport not connected\");\n\n const active = new Set(activeClientIds);\n return ok({\n activeClientIds,\n inactiveClientIds: connectedClientIds.filter((id) => !active.has(id)),\n });\n}\n\nexport async function handleEnableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.enablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ enabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport async function handleDisableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.disablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ disabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport const getFlipperPluginActivationStatusDef: ToolDef = {\n name: \"get_flipper_plugin_activation_status\",\n description:\n \"Get per-client activation status of the Player UI Devtools Flipper plugin: which connected clients have completed the init handshake (active) versus which are connected but not yet activated (inactive). Distinct from get_flipper_plugin_install_status, which only reports whether the plugin is installed on the daemon, not activated for any specific client.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginActivationStatus,\n};\n\nexport const enableFlipperPluginDef: ToolDef = {\n name: \"enable_flipper_plugin\",\n description:\n \"Activate the Player UI Devtools Flipper plugin for a client by sending the init handshake (installing the plugin on the daemon first, if needed). Pass clientId to target one client, or omit it to activate every connected client not already active. There is no direct mapping from clientId to the playerId(s) it hosts — after activating, poll list_players until the expected Player appears.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleEnableFlipperPlugin,\n};\n\nexport const disableFlipperPluginDef: ToolDef = {\n name: \"disable_flipper_plugin\",\n description:\n \"Deactivate the Player UI Devtools Flipper plugin for a client by sending the deinit handshake, without disconnecting it from flipper-server. Pass clientId to target one client, or omit it to deactivate every currently active client.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleDisableFlipperPlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type {\n CallToolResult,\n ToolAnnotations,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { Transport } from \"@player-devtools/types\";\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, the\n * validated args, and the raw `Transport` for tools that need connection-level\n * diagnostics `ExtensionClient` doesn't expose.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n annotations?: ToolAnnotations;\n handle: (\n client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n ) => CallToolResult | Promise<CallToolResult>;\n};\n\n/** Shared JSON-envelope helpers used by every tool handler in this package. */\nexport function ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\nexport * from \"./flipper\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\nimport {\n getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\n} from \"./flipper\";\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 getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\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","z","z","z","z","z","z","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/flipper.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: {\n description: string;\n inputSchema: ToolDef[\"inputSchema\"];\n annotations?: ToolDef[\"annotations\"];\n },\n cb: (args: unknown) => CallToolResult | Promise<CallToolResult>,\n ) => unknown;\n\n register(\n def.name,\n {\n description: def.description,\n inputSchema: def.inputSchema,\n annotations: def.annotations,\n },\n (args) => def.handle(this.client, args, this.transport),\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 { ok, err, 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\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 { ok, err, 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 ok({ players: Object.keys(players), current: current.player });\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 err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n return ok({ active: player.active, plugins: Object.keys(player.plugins) });\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 { ok, err, 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\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 { ok, err, 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\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 { Transport } from \"@player-devtools/types\";\nimport { FlipperServerTransport } from \"@player-devtools/client-flipper\";\nimport { z } from \"zod\";\n\nimport { ok, err, type ToolDef } from \"./index\";\n\nconst clientIdShape = {\n clientId: z\n .string()\n .optional()\n .describe(\n \"Flipper client ID — a transport-level device/app connection, NOT a Player devtools playerId (see list_players/select_player). A client can be connected, and even activated, before any Player instance on it is visible to those tools. Unlike playerId, there is no 'currently selected' client: omitting this targets every connected client — for enable/disable, only clients not already in the desired state are messaged.\",\n ),\n};\n\nconst ClientIdInput = z.object(clientIdShape);\n\n/** Narrow the generic `Transport` to the concrete Flipper implementation. */\nfunction asFlipperTransport(\n transport: Transport | undefined,\n): FlipperServerTransport | null {\n return transport instanceof FlipperServerTransport ? transport : null;\n}\n\nexport function handleGetFlipperStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, host, port } = flipper.getDiagnostics();\n return ok({ connected, host, port });\n}\n\nexport function handleGetFlipperConsumers(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { owns, refs, activeClientIds, connectedClientIds } =\n flipper.getDiagnostics();\n return ok({ owns, refs, activeClientIds, connectedClientIds });\n}\n\nexport async function handleRestartFlipperServer(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const result = await flipper.restart();\n if (!result.ok) return err(result.reason);\n return ok({ restarted: true, host: result.host, port: result.port });\n}\n\nexport async function handleGetFlipperPluginInstallStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n if (!flipper.getDiagnostics().connected) {\n return err(\"flipper transport not connected\");\n }\n\n const status = await flipper.getPluginInstallStatus();\n if (!status.installed && status.reason) return err(status.reason);\n return ok(status);\n}\n\nexport const getFlipperStatusDef: ToolDef = {\n name: \"get_flipper_connection_status\",\n description:\n \"Get the MCP server's basic connection health to the shared flipper-server daemon: whether it's connected, and the host/port it's connected to. For ownership/refcount/client info, use get_flipper_consumers instead.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperStatus,\n};\n\nexport const getFlipperConsumersDef: ToolDef = {\n name: \"get_flipper_consumers\",\n description:\n \"Get who else is attached to the shared flipper-server daemon: whether this process owns it, the daemon-wide refcount (reflects all consumers, not just this process), and the connected/active devtools clients on this connection.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperConsumers,\n};\n\nexport const restartFlipperServerDef: ToolDef = {\n name: \"restart_flipper_server\",\n description:\n \"Restart the shared flipper-server daemon. Only succeeds when this MCP server owns the daemon and is its sole consumer; otherwise returns a soft error rather than disrupting other consumers.\",\n inputSchema: {},\n annotations: { readOnlyHint: false, destructiveHint: true },\n handle: handleRestartFlipperServer,\n};\n\nexport const getFlipperPluginInstallStatusDef: ToolDef = {\n name: \"get_flipper_plugin_install_status\",\n description:\n \"Check whether the Player UI Devtools Flipper plugin is installed on the connected daemon.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginInstallStatus,\n};\n\nexport function handleGetFlipperPluginActivationStatus(\n _client: ExtensionClient,\n _args: unknown,\n transport?: Transport,\n): CallToolResult {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { connected, connectedClientIds, activeClientIds } =\n flipper.getDiagnostics();\n if (!connected) return err(\"flipper transport not connected\");\n\n const active = new Set(activeClientIds);\n return ok({\n activeClientIds,\n inactiveClientIds: connectedClientIds.filter((id) => !active.has(id)),\n });\n}\n\nexport async function handleEnableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.enablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ enabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport async function handleDisableFlipperPlugin(\n _client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n): Promise<CallToolResult> {\n const flipper = asFlipperTransport(transport);\n if (!flipper) return err(\"not using a Flipper transport\");\n\n const { clientId } = ClientIdInput.parse(args);\n try {\n await flipper.disablePlugin(clientId);\n } catch (error) {\n return err(error instanceof Error ? error.message : String(error));\n }\n return ok({ disabled: true, clientId: clientId ?? \"all\" });\n}\n\nexport const getFlipperPluginActivationStatusDef: ToolDef = {\n name: \"get_flipper_plugin_activation_status\",\n description:\n \"Get per-client activation status of the Player UI Devtools Flipper plugin: which connected clients have completed the init handshake (active) versus which are connected but not yet activated (inactive). Distinct from get_flipper_plugin_install_status, which only reports whether the plugin is installed on the daemon, not activated for any specific client.\",\n inputSchema: {},\n annotations: { readOnlyHint: true, destructiveHint: false },\n handle: handleGetFlipperPluginActivationStatus,\n};\n\nexport const enableFlipperPluginDef: ToolDef = {\n name: \"enable_flipper_plugin\",\n description:\n \"Activate the Player UI Devtools Flipper plugin for a client by sending the init handshake (installing the plugin on the daemon first, if needed). Pass clientId to target one client, or omit it to activate every connected client not already active. There is no direct mapping from clientId to the playerId(s) it hosts — after activating, poll list_players until the expected Player appears.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleEnableFlipperPlugin,\n};\n\nexport const disableFlipperPluginDef: ToolDef = {\n name: \"disable_flipper_plugin\",\n description:\n \"Deactivate the Player UI Devtools Flipper plugin for a client by sending the deinit handshake, without disconnecting it from flipper-server. Pass clientId to target one client, or omit it to deactivate every currently active client.\",\n inputSchema: clientIdShape,\n annotations: { readOnlyHint: false, destructiveHint: false },\n handle: handleDisableFlipperPlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type {\n CallToolResult,\n ToolAnnotations,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport type { Transport } from \"@player-devtools/types\";\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, the\n * validated args, and the raw `Transport` for tools that need connection-level\n * diagnostics `ExtensionClient` doesn't expose.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n annotations?: ToolAnnotations;\n handle: (\n client: ExtensionClient,\n args: unknown,\n transport?: Transport,\n ) => CallToolResult | Promise<CallToolResult>;\n};\n\n/** Shared JSON-envelope helpers used by every tool handler in this package. */\nexport function ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\nexport * from \"./flipper\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\nimport {\n getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\n} from \"./flipper\";\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 getFlipperStatusDef,\n getFlipperConsumersDef,\n restartFlipperServerDef,\n getFlipperPluginInstallStatusDef,\n getFlipperPluginActivationStatusDef,\n enableFlipperPluginDef,\n disableFlipperPluginDef,\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\n// Scoped to this module so that packages declaring the same define don't\n// collide in a shared TS program.\ndeclare const __VERSION__: string;\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","z","z","z","z","z","z","os","err"]}
package/package.json CHANGED
@@ -5,7 +5,7 @@
5
5
  "bin"
6
6
  ],
7
7
  "name": "@player-devtools/mcp",
8
- "version": "0.16.1-next.3",
8
+ "version": "1.0.0-next.0",
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.16.1-next.3",
18
- "@player-devtools/client-flipper": "0.16.1-next.3",
19
- "@player-devtools/messenger": "0.16.1-next.3",
20
- "@player-devtools/types": "0.16.1-next.3",
17
+ "@player-devtools/client": "1.0.0-next.0",
18
+ "@player-devtools/client-flipper": "1.0.0-next.0",
19
+ "@player-devtools/messenger": "1.0.0-next.0",
20
+ "@player-devtools/types": "1.0.0-next.0",
21
21
  "@modelcontextprotocol/sdk": "^1.0.0",
22
22
  "@posthog/mcp": "0.10.8",
23
23
  "@types/node": "^24.0.1",