@player-devtools/mcp 0.14.2-next.0 → 0.14.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -26,8 +26,8 @@ The package ships a CLI, `player-devtools-mcp`, which is what an MCP client runs
26
26
 
27
27
  ### Register with Claude Code
28
28
 
29
- Add it as an MCP server with `claude mcp add` — no env vars or tokens are
30
- required:
29
+ Add it as an MCP server with `claude mcp add` — no tokens are required (see
30
+ [Telemetry](#telemetry) for the optional opt-out variables):
31
31
 
32
32
  ```bash
33
33
  claude mcp add player-devtools -- npx -y @player-devtools/mcp@latest
@@ -135,4 +135,58 @@ just mcp-inspect # open the MCP inspector against the server
135
135
  Register it with an MCP client (e.g. Claude) by pointing the client at the
136
136
  `player-devtools-mcp` command over stdio.
137
137
 
138
+ ## Telemetry
139
+
140
+ The server reports anonymous usage analytics so we can tell how widely it's used
141
+ and whether it's working in the field. It is **on by default** and sends:
142
+
143
+ | | |
144
+ | --- | --- |
145
+ | Identity | A random UUID generated on first run and stored at `~/.player-ui-devtools/install.json`. It is not derived from anything about you or your machine — delete the file and a new one is generated. |
146
+ | Events | Session start (`$mcp_initialize`), tool calls (`$mcp_tool_call`), tool listing (`$mcp_tools_list`), and errors (`$exception`). |
147
+ | Properties | Tool **name**, call duration, whether the call errored, the MCP client name/version (e.g. which editor), the devtools version, OS platform, Node major version, and whether the Flipper transport connected. |
148
+
149
+ **Tool arguments and tool responses are never transmitted.** Those can contain
150
+ Player flow content, so every outgoing event is filtered through an allowlist of
151
+ known-safe property names — anything not explicitly listed is dropped before the
152
+ event leaves the process.
153
+
154
+ To opt out, set either variable to any value:
155
+
156
+ ```bash
157
+ export PLAYER_DEVTOOLS_TELEMETRY_DISABLED=1
158
+ # or the cross-vendor convention, which we also honor
159
+ export DO_NOT_TRACK=1
160
+ ```
161
+
162
+ `DO_NOT_TRACK=0` and `DO_NOT_TRACK=false` are treated as "tracking is fine", not
163
+ as an opt-out.
164
+
165
+ Nothing else is needed to make this work — no account, no key, no configuration.
166
+ Builds you make yourself (anything not a tagged release) send nothing at all.
167
+
168
+ <details>
169
+ <summary>Maintainers: how the ingestion key is supplied</summary>
170
+
171
+ The PostHog key is stamped into released builds; it is not in the repo and is
172
+ not something users provide.
173
+
174
+ Set `POSTHOG_PROJECT_KEY` in the release CI environment.
175
+ [`helpers/release/workspace-status.sh`](../../helpers/release/workspace-status.sh)
176
+ emits it as `STABLE_POSTHOG_KEY`, and
177
+ [`tsup.config.ts`](../../tsup.config.ts) substitutes it into the
178
+ `__POSTHOG_KEY__` global — the same mechanism that stamps `__VERSION__`.
179
+
180
+ Stamping only happens under `--config=release`, so PR and local builds resolve
181
+ the global to an empty string and stay silent. Only public `phc_` project keys
182
+ are accepted: the value is baked into published artifacts and the shared remote
183
+ cache, so a `phx_` personal or `phs_` secret key is rejected at runtime rather
184
+ than shipped.
185
+
186
+ To point a build at a different project or region without rebuilding, override
187
+ `PLAYER_DEVTOOLS_TELEMETRY_KEY` / `PLAYER_DEVTOOLS_TELEMETRY_HOST` at runtime —
188
+ useful for verifying against a local listener.
189
+
190
+ </details>
191
+
138
192
  [browser extension]: https://github.com/player-ui/browser-devtools
@@ -1,7 +1,9 @@
1
1
  "use strict";
2
+ var __create = Object.create;
2
3
  var __defProp = Object.defineProperty;
3
4
  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
5
  var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
5
7
  var __hasOwnProp = Object.prototype.hasOwnProperty;
6
8
  var __export = (target, all) => {
7
9
  for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
15
17
  }
16
18
  return to;
17
19
  };
20
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
+ // If the importer is in node compatibility mode or this is not an ESM
22
+ // file that has been converted to a CommonJS file using a Babel-
23
+ // compatible transform (i.e. "__esModule" has not been set), then set
24
+ // "default" to the CommonJS "module.exports" for node compatibility.
25
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
+ mod
27
+ ));
18
28
  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
29
 
20
30
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/index.ts
@@ -26,7 +36,7 @@ module.exports = __toCommonJS(src_exports);
26
36
 
27
37
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts
28
38
  var import_client = require("@player-devtools/client");
29
- var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
39
+ var import_mcp2 = require("@modelcontextprotocol/sdk/server/mcp.js");
30
40
  var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
31
41
 
32
42
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts
@@ -280,12 +290,165 @@ var TOOL_DEFS = [
280
290
  invokeActionDef
281
291
  ];
282
292
 
293
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
294
+ var os2 = __toESM(require("os"));
295
+ var import_mcp = require("@posthog/mcp");
296
+ var import_posthog_node = require("posthog-node");
297
+
298
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts
299
+ var POSTHOG_PROJECT_KEY = true ? "phc_nXLgnaUwZpPWmfFeY99TMYH3mo54bUFmDUsianCPTDUg" : "";
300
+ var DEFAULT_POSTHOG_HOST = "https://us.i.posthog.com";
301
+ function isTruthy(value) {
302
+ if (value === void 0) return false;
303
+ const normalized = value.trim().toLowerCase();
304
+ if (normalized === "" || normalized === "0" || normalized === "false") {
305
+ return false;
306
+ }
307
+ return true;
308
+ }
309
+ function isOptedOut(env) {
310
+ return isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) || // Cross-vendor convention (consoledonottrack.com) — honored so a user who
311
+ // sets it once is covered everywhere.
312
+ isTruthy(env.DO_NOT_TRACK);
313
+ }
314
+ function resolveTelemetryConfig(env = process.env) {
315
+ if (isOptedOut(env)) return { enabled: false };
316
+ const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;
317
+ if (!apiKey) return { enabled: false };
318
+ if (!apiKey.startsWith("phc_")) return { enabled: false };
319
+ const host = (env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST).replace(/\/+$/, "");
320
+ return { enabled: true, apiKey, host };
321
+ }
322
+
323
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts
324
+ var import_crypto = require("crypto");
325
+ var fs = __toESM(require("fs"));
326
+ var os = __toESM(require("os"));
327
+ var path = __toESM(require("path"));
328
+ var defaultDeps = {
329
+ homedir: os.homedir,
330
+ readFileSync: fs.readFileSync,
331
+ writeFileSync: fs.writeFileSync,
332
+ mkdirSync: fs.mkdirSync,
333
+ randomUUID: import_crypto.randomUUID
334
+ };
335
+ var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
336
+ var INSTALL_DIR_NAME = ".player-ui-devtools";
337
+ var INSTALL_FILE_NAME = "install.json";
338
+ function getInstallId(deps = defaultDeps) {
339
+ const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);
340
+ const file = path.join(dir, INSTALL_FILE_NAME);
341
+ try {
342
+ const parsed = JSON.parse(
343
+ deps.readFileSync(file, "utf8")
344
+ );
345
+ if (typeof parsed.installId === "string" && UUID_PATTERN.test(parsed.installId)) {
346
+ return parsed.installId;
347
+ }
348
+ } catch {
349
+ }
350
+ const installId = deps.randomUUID();
351
+ try {
352
+ deps.mkdirSync(dir, { recursive: true });
353
+ const contents = { installId };
354
+ deps.writeFileSync(file, JSON.stringify(contents), { mode: 384 });
355
+ } catch {
356
+ return null;
357
+ }
358
+ return installId;
359
+ }
360
+
361
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts
362
+ var ALLOWED_EVENT_PROPERTIES = /* @__PURE__ */ new Set([
363
+ // MCP tool call shape — names and timings only, never payloads.
364
+ "$mcp_tool_name",
365
+ "$mcp_duration_ms",
366
+ "$mcp_is_error",
367
+ "$mcp_error_type",
368
+ "$mcp_listed_tool_names",
369
+ "$mcp_missing_capability",
370
+ // Which editor/agent is driving the server.
371
+ "$mcp_client_name",
372
+ "$mcp_client_version",
373
+ "$mcp_server_name",
374
+ "$mcp_server_version",
375
+ "$mcp_protocol_version",
376
+ // PostHog bookkeeping.
377
+ "$session_id",
378
+ "$process_person_profile",
379
+ "$lib",
380
+ "$lib_version",
381
+ // Our own event properties.
382
+ "mcp_version",
383
+ "os_platform",
384
+ "node_major",
385
+ "transport_connected",
386
+ "surface"
387
+ ]);
388
+ function allowlistEventProperties(event) {
389
+ if (!event?.properties) return event;
390
+ event.properties = Object.fromEntries(
391
+ Object.entries(event.properties).filter(
392
+ ([key]) => ALLOWED_EVENT_PROPERTIES.has(key)
393
+ )
394
+ );
395
+ return event;
396
+ }
397
+
398
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
399
+ var MCP_VERSION = true ? "0.14.2" : "unstamped";
400
+ function createAnalytics(server, deps) {
401
+ try {
402
+ const config = resolveTelemetryConfig();
403
+ if (!config.enabled) return null;
404
+ const installId = getInstallId();
405
+ if (installId === null) return null;
406
+ const posthog = new import_posthog_node.PostHog(config.apiKey, {
407
+ host: config.host,
408
+ // The load-bearing privacy control. Runs inside posthog-node's capture(),
409
+ // so it applies to everything the MCP SDK emits regardless of the SDK's
410
+ // own hooks. See redaction.ts for why this is an allowlist.
411
+ before_send: [allowlistEventProperties]
412
+ });
413
+ (0, import_mcp.instrument)(server, posthog, {
414
+ // Defaults to ON, and would inject a *required* `context` parameter into
415
+ // every tool schema asking the agent to narrate user intent — mutating
416
+ // our public tool API and adding per-call token cost.
417
+ context: false,
418
+ identify: { distinctId: installId },
419
+ eventProperties: () => ({
420
+ mcp_version: MCP_VERSION,
421
+ os_platform: os2.platform(),
422
+ node_major: Number.parseInt(
423
+ process.versions.node.split(".")[0] ?? "",
424
+ 10
425
+ ),
426
+ transport_connected: deps.isTransportConnected(),
427
+ surface: "mcp-server"
428
+ }),
429
+ // Redundant with `before_send` above, kept as a second independent layer.
430
+ // This hook fails closed: the SDK drops the event if it throws.
431
+ beforeSend: allowlistEventProperties
432
+ });
433
+ return posthog;
434
+ } catch {
435
+ return null;
436
+ }
437
+ }
438
+
283
439
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts
284
440
  var MCPServer = class {
285
441
  constructor(transport) {
286
442
  this.transport = transport;
443
+ this.transportConnected = false;
287
444
  this.client = (0, import_client.createExtensionClient)(transport);
288
- this.server = new import_mcp.McpServer({ name: "player-devtools", version: "0.0.1" });
445
+ this.server = new import_mcp2.McpServer({
446
+ name: "player-devtools",
447
+ version: MCP_VERSION
448
+ });
449
+ this.analytics = createAnalytics(this.server, {
450
+ isTransportConnected: () => this.transportConnected
451
+ });
289
452
  this.registerTools();
290
453
  }
291
454
  registerTools() {
@@ -303,6 +466,7 @@ var MCPServer = class {
303
466
  await this.server.connect(stdioTransport);
304
467
  try {
305
468
  await this.transport.connect();
469
+ this.transportConnected = true;
306
470
  } catch (err4) {
307
471
  console.warn(
308
472
  "[MCPServer] Transport connect failed (will operate in disconnected mode):",
@@ -311,6 +475,10 @@ var MCPServer = class {
311
475
  }
312
476
  }
313
477
  async stop() {
478
+ try {
479
+ await this.analytics?.shutdown();
480
+ } catch {
481
+ }
314
482
  this.client.destroy();
315
483
  await this.transport.close();
316
484
  await this.server.close();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts"],"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\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({ name: \"player-devtools\", version: \"0.0.1\" });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n } 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 this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n"],"mappings":"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","names":["import_zod","playerIdShape","import_zod","err","ok","import_zod","err","ok","err"]}
1
+ {"version":3,"sources":["../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts","../../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts"],"sourcesContent":["export { MCPServer } from \"./server\";\n","import {\n createExtensionClient,\n type ExtensionClient,\n} from \"@player-devtools/client\";\nimport type { Transport } from \"@player-devtools/types\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { PostHog } from \"posthog-node\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\nimport { createAnalytics, MCP_VERSION } from \"./telemetry\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n private analytics: PostHog | null;\n private transportConnected = false;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({\n name: \"player-devtools\",\n version: MCP_VERSION,\n });\n // Instrument before registering tools so every handler is wrapped.\n this.analytics = createAnalytics(this.server, {\n isTransportConnected: () => this.transportConnected,\n });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n this.transportConnected = true;\n } catch (err) {\n console.warn(\n \"[MCPServer] Transport connect failed (will operate in disconnected mode):\",\n err instanceof Error ? err.message : err,\n );\n }\n }\n\n async stop(): Promise<void> {\n // Flush buffered events first: bin/run calls process.exit(0) as soon as\n // this resolves, which would otherwise drop them. Never fail shutdown on a\n // telemetry error.\n try {\n await this.analytics?.shutdown();\n } catch {\n /* best-effort */\n }\n this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n","import * as os from \"os\";\nimport { instrument } from \"@posthog/mcp\";\nimport { PostHog } from \"posthog-node\";\n\nimport { resolveTelemetryConfig } from \"./config\";\nimport { getInstallId } from \"./installId\";\nimport { allowlistEventProperties } from \"./redaction\";\n\nexport {\n ALLOWED_EVENT_PROPERTIES,\n allowlistEventProperties,\n} from \"./redaction\";\nexport { resolveTelemetryConfig, type TelemetryConfig } from \"./config\";\nexport { getInstallId, type InstallIdDeps } from \"./installId\";\n\ndeclare global {\n const __VERSION__: string;\n}\n\n/**\n * Stamped at release build time by tsup (see devtools/tsup.config.ts). The\n * guard is required — the global is absent in local and test builds.\n */\nexport const MCP_VERSION: string =\n typeof __VERSION__ !== \"undefined\" ? __VERSION__ : \"unstamped\";\n\nexport type AnalyticsDeps = {\n /** Reports whether the devtools transport is currently connected. */\n isTransportConnected: () => boolean;\n};\n\n/**\n * Instruments `server` with anonymous usage analytics.\n *\n * Returns the PostHog client so the caller can flush it on shutdown, or `null`\n * when telemetry is disabled or no durable identity is available. Never throws:\n * telemetry must not be able to prevent the server from starting.\n */\nexport function createAnalytics(\n server: object,\n deps: AnalyticsDeps,\n): PostHog | null {\n try {\n const config = resolveTelemetryConfig();\n if (!config.enabled) return null;\n\n const installId = getInstallId();\n if (installId === null) return null;\n\n const posthog = new PostHog(config.apiKey, {\n host: config.host,\n // The load-bearing privacy control. Runs inside posthog-node's capture(),\n // so it applies to everything the MCP SDK emits regardless of the SDK's\n // own hooks. See redaction.ts for why this is an allowlist.\n before_send: [allowlistEventProperties],\n });\n\n instrument(server, posthog, {\n // Defaults to ON, and would inject a *required* `context` parameter into\n // every tool schema asking the agent to narrate user intent — mutating\n // our public tool API and adding per-call token cost.\n context: false,\n identify: { distinctId: installId },\n eventProperties: () => ({\n mcp_version: MCP_VERSION,\n os_platform: os.platform(),\n node_major: Number.parseInt(\n process.versions.node.split(\".\")[0] ?? \"\",\n 10,\n ),\n transport_connected: deps.isTransportConnected(),\n surface: \"mcp-server\",\n }),\n // Redundant with `before_send` above, kept as a second independent layer.\n // This hook fails closed: the SDK drops the event if it throws.\n beforeSend: allowlistEventProperties,\n });\n\n return posthog;\n } catch {\n // Telemetry is strictly best-effort — a misconfiguration must never take\n // down the server.\n return null;\n }\n}\n","declare global {\n const __POSTHOG_KEY__: string;\n}\n\n/**\n * PostHog project API key, stamped at release build time from the\n * `POSTHOG_PROJECT_KEY` CI environment variable (see\n * helpers/release/workspace-status.sh and tsup.config.ts), mirroring how\n * `__VERSION__` is stamped.\n *\n * This is a *public, write-only* ingestion token — it can only send events and\n * cannot read data back, which is why it is safe to ship in an open-source\n * package.\n *\n * The `typeof` guard is required: the global is absent in local and test\n * builds, where it resolves to an empty string and disables telemetry.\n */\nconst POSTHOG_PROJECT_KEY =\n typeof __POSTHOG_KEY__ !== \"undefined\" ? __POSTHOG_KEY__ : \"\";\n\nconst DEFAULT_POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nexport type TelemetryConfig =\n | { readonly enabled: false }\n | { readonly enabled: true; readonly apiKey: string; readonly host: string };\n\n/**\n * Presence of the variable opts out, *except* for explicit negatives —\n * `DO_NOT_TRACK=0` means \"tracking is fine\", not \"opted out\".\n */\nfunction isTruthy(value: string | undefined): boolean {\n if (value === undefined) return false;\n const normalized = value.trim().toLowerCase();\n if (normalized === \"\" || normalized === \"0\" || normalized === \"false\") {\n return false;\n }\n return true;\n}\n\nfunction isOptedOut(env: NodeJS.ProcessEnv): boolean {\n return (\n isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) ||\n // Cross-vendor convention (consoledonottrack.com) — honored so a user who\n // sets it once is covered everywhere.\n isTruthy(env.DO_NOT_TRACK)\n );\n}\n\nexport function resolveTelemetryConfig(\n env: NodeJS.ProcessEnv = process.env,\n): TelemetryConfig {\n if (isOptedOut(env)) return { enabled: false };\n\n const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;\n // Unstamped (local/dev builds) or unset in CI — stay silent rather than\n // firing doomed requests at PostHog on every startup.\n if (!apiKey) return { enabled: false };\n // Only public write-only project keys may ship. A `phx_` (personal) or\n // `phs_` (project secret) key is a real credential and must never be baked\n // into a published artifact, so refuse to use one even if stamped.\n if (!apiKey.startsWith(\"phc_\")) return { enabled: false };\n\n const host = (\n env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST\n ).replace(/\\/+$/, \"\");\n\n return { enabled: true, apiKey, host };\n}\n","import { randomUUID } from \"crypto\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\n\nexport type InstallIdDeps = {\n /** Resolves the user's home directory. */\n homedir: () => string;\n /** Reads the install file. */\n readFileSync: typeof fs.readFileSync;\n /** Writes the install file. */\n writeFileSync: typeof fs.writeFileSync;\n /** Creates the install directory. */\n mkdirSync: typeof fs.mkdirSync;\n /** Mints a new identifier. */\n randomUUID: () => string;\n};\n\nconst defaultDeps: InstallIdDeps = {\n homedir: os.homedir,\n readFileSync: fs.readFileSync,\n writeFileSync: fs.writeFileSync,\n mkdirSync: fs.mkdirSync,\n randomUUID,\n};\n\ntype InstallFile = { installId: string };\n\nconst UUID_PATTERN =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport const INSTALL_DIR_NAME = \".player-ui-devtools\";\nexport const INSTALL_FILE_NAME = \"install.json\";\n\n/**\n * A stable, anonymous per-machine identifier.\n *\n * Stored under the user's home directory rather than the OS temp dir the\n * flipper refcount uses: temp is periodically reaped, which would regenerate\n * the id on every reboot and turn \"unique installs\" into \"unique boots\".\n *\n * Returns `null` when the id can neither be read nor persisted (read-only FS,\n * sandbox, absent HOME). Callers treat that as \"telemetry off\" — returning an\n * in-memory id instead would register a brand-new install on every run and\n * systematically inflate counts for exactly the sandboxed population least\n * likely to be real users.\n */\nexport function getInstallId(deps: InstallIdDeps = defaultDeps): string | null {\n const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);\n const file = path.join(dir, INSTALL_FILE_NAME);\n\n try {\n const parsed = JSON.parse(\n deps.readFileSync(file, \"utf8\") as string,\n ) as Partial<InstallFile>;\n // Validate the shape, not just the parse: `{\"installId\": 42}` parses fine\n // but is not a usable identity.\n if (\n typeof parsed.installId === \"string\" &&\n UUID_PATTERN.test(parsed.installId)\n ) {\n return parsed.installId;\n }\n } catch {\n /* missing or corrupt — fall through and regenerate */\n }\n\n const installId = deps.randomUUID();\n try {\n deps.mkdirSync(dir, { recursive: true });\n const contents: InstallFile = { installId };\n // 0600: a stable per-user identifier should not be world-readable.\n deps.writeFileSync(file, JSON.stringify(contents), { mode: 0o600 });\n } catch {\n return null;\n }\n\n return installId;\n}\n","/**\n * Event property allowlist.\n *\n * `@posthog/mcp` captures tool arguments (`$mcp_parameters`) and tool results\n * (`$mcp_response`) unconditionally — there is no SDK option to disable it, and\n * its built-in sanitizer only matches sensitive *key names* (`token`,\n * `password`, ...), so a field named `flowContent` would be transmitted\n * verbatim. Devtools tool arguments carry player/plugin ids and `invoke_action`\n * payloads, i.e. potentially customer flow data.\n *\n * This is an allowlist rather than a denylist on purpose: the SDK is 0.x and\n * ships frequently, so a denylist naming today's two payload keys would\n * silently start leaking the moment a release adds a third. Anything not\n * explicitly listed here never reaches the wire.\n */\nexport const ALLOWED_EVENT_PROPERTIES: ReadonlySet<string> = new Set([\n // MCP tool call shape — names and timings only, never payloads.\n \"$mcp_tool_name\",\n \"$mcp_duration_ms\",\n \"$mcp_is_error\",\n \"$mcp_error_type\",\n \"$mcp_listed_tool_names\",\n \"$mcp_missing_capability\",\n // Which editor/agent is driving the server.\n \"$mcp_client_name\",\n \"$mcp_client_version\",\n \"$mcp_server_name\",\n \"$mcp_server_version\",\n \"$mcp_protocol_version\",\n // PostHog bookkeeping.\n \"$session_id\",\n \"$process_person_profile\",\n \"$lib\",\n \"$lib_version\",\n // Our own event properties.\n \"mcp_version\",\n \"os_platform\",\n \"node_major\",\n \"transport_connected\",\n \"surface\",\n]);\n\nexport type CapturedEvent = {\n /** Event name. */\n event?: string;\n /** Event properties. */\n properties?: Record<string, unknown>;\n};\n\n/**\n * Drops every property not in {@link ALLOWED_EVENT_PROPERTIES}.\n *\n * Installed as a `posthog-node` client-level `before_send`, which runs inside\n * `capture()` — a chokepoint the MCP SDK cannot route around, since we own the\n * client instance and it does not.\n *\n * Accepts `null` because `before_send` hooks compose: an earlier hook may have\n * already dropped the event.\n */\nexport function allowlistEventProperties<Event extends CapturedEvent>(\n event: Event | null,\n): Event | null {\n if (!event?.properties) return event;\n\n event.properties = Object.fromEntries(\n Object.entries(event.properties).filter(([key]) =>\n ALLOWED_EVENT_PROPERTIES.has(key),\n ),\n );\n\n return event;\n}\n"],"mappings":"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","names":["import_mcp","import_zod","playerIdShape","import_zod","err","ok","import_zod","err","ok","os","err"]}
@@ -256,12 +256,165 @@ var TOOL_DEFS = [
256
256
  invokeActionDef
257
257
  ];
258
258
 
259
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
260
+ import * as os2 from "os";
261
+ import { instrument } from "@posthog/mcp";
262
+ import { PostHog } from "posthog-node";
263
+
264
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts
265
+ var POSTHOG_PROJECT_KEY = true ? "phc_nXLgnaUwZpPWmfFeY99TMYH3mo54bUFmDUsianCPTDUg" : "";
266
+ var DEFAULT_POSTHOG_HOST = "https://us.i.posthog.com";
267
+ function isTruthy(value) {
268
+ if (value === void 0) return false;
269
+ const normalized = value.trim().toLowerCase();
270
+ if (normalized === "" || normalized === "0" || normalized === "false") {
271
+ return false;
272
+ }
273
+ return true;
274
+ }
275
+ function isOptedOut(env) {
276
+ return isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) || // Cross-vendor convention (consoledonottrack.com) — honored so a user who
277
+ // sets it once is covered everywhere.
278
+ isTruthy(env.DO_NOT_TRACK);
279
+ }
280
+ function resolveTelemetryConfig(env = process.env) {
281
+ if (isOptedOut(env)) return { enabled: false };
282
+ const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;
283
+ if (!apiKey) return { enabled: false };
284
+ if (!apiKey.startsWith("phc_")) return { enabled: false };
285
+ const host = (env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST).replace(/\/+$/, "");
286
+ return { enabled: true, apiKey, host };
287
+ }
288
+
289
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts
290
+ import { randomUUID } from "crypto";
291
+ import * as fs from "fs";
292
+ import * as os from "os";
293
+ import * as path from "path";
294
+ var defaultDeps = {
295
+ homedir: os.homedir,
296
+ readFileSync: fs.readFileSync,
297
+ writeFileSync: fs.writeFileSync,
298
+ mkdirSync: fs.mkdirSync,
299
+ randomUUID
300
+ };
301
+ var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
302
+ var INSTALL_DIR_NAME = ".player-ui-devtools";
303
+ var INSTALL_FILE_NAME = "install.json";
304
+ function getInstallId(deps = defaultDeps) {
305
+ const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);
306
+ const file = path.join(dir, INSTALL_FILE_NAME);
307
+ try {
308
+ const parsed = JSON.parse(
309
+ deps.readFileSync(file, "utf8")
310
+ );
311
+ if (typeof parsed.installId === "string" && UUID_PATTERN.test(parsed.installId)) {
312
+ return parsed.installId;
313
+ }
314
+ } catch {
315
+ }
316
+ const installId = deps.randomUUID();
317
+ try {
318
+ deps.mkdirSync(dir, { recursive: true });
319
+ const contents = { installId };
320
+ deps.writeFileSync(file, JSON.stringify(contents), { mode: 384 });
321
+ } catch {
322
+ return null;
323
+ }
324
+ return installId;
325
+ }
326
+
327
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts
328
+ var ALLOWED_EVENT_PROPERTIES = /* @__PURE__ */ new Set([
329
+ // MCP tool call shape — names and timings only, never payloads.
330
+ "$mcp_tool_name",
331
+ "$mcp_duration_ms",
332
+ "$mcp_is_error",
333
+ "$mcp_error_type",
334
+ "$mcp_listed_tool_names",
335
+ "$mcp_missing_capability",
336
+ // Which editor/agent is driving the server.
337
+ "$mcp_client_name",
338
+ "$mcp_client_version",
339
+ "$mcp_server_name",
340
+ "$mcp_server_version",
341
+ "$mcp_protocol_version",
342
+ // PostHog bookkeeping.
343
+ "$session_id",
344
+ "$process_person_profile",
345
+ "$lib",
346
+ "$lib_version",
347
+ // Our own event properties.
348
+ "mcp_version",
349
+ "os_platform",
350
+ "node_major",
351
+ "transport_connected",
352
+ "surface"
353
+ ]);
354
+ function allowlistEventProperties(event) {
355
+ if (!event?.properties) return event;
356
+ event.properties = Object.fromEntries(
357
+ Object.entries(event.properties).filter(
358
+ ([key]) => ALLOWED_EVENT_PROPERTIES.has(key)
359
+ )
360
+ );
361
+ return event;
362
+ }
363
+
364
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
365
+ var MCP_VERSION = true ? "0.14.2" : "unstamped";
366
+ function createAnalytics(server, deps) {
367
+ try {
368
+ const config = resolveTelemetryConfig();
369
+ if (!config.enabled) return null;
370
+ const installId = getInstallId();
371
+ if (installId === null) return null;
372
+ const posthog = new PostHog(config.apiKey, {
373
+ host: config.host,
374
+ // The load-bearing privacy control. Runs inside posthog-node's capture(),
375
+ // so it applies to everything the MCP SDK emits regardless of the SDK's
376
+ // own hooks. See redaction.ts for why this is an allowlist.
377
+ before_send: [allowlistEventProperties]
378
+ });
379
+ instrument(server, posthog, {
380
+ // Defaults to ON, and would inject a *required* `context` parameter into
381
+ // every tool schema asking the agent to narrate user intent — mutating
382
+ // our public tool API and adding per-call token cost.
383
+ context: false,
384
+ identify: { distinctId: installId },
385
+ eventProperties: () => ({
386
+ mcp_version: MCP_VERSION,
387
+ os_platform: os2.platform(),
388
+ node_major: Number.parseInt(
389
+ process.versions.node.split(".")[0] ?? "",
390
+ 10
391
+ ),
392
+ transport_connected: deps.isTransportConnected(),
393
+ surface: "mcp-server"
394
+ }),
395
+ // Redundant with `before_send` above, kept as a second independent layer.
396
+ // This hook fails closed: the SDK drops the event if it throws.
397
+ beforeSend: allowlistEventProperties
398
+ });
399
+ return posthog;
400
+ } catch {
401
+ return null;
402
+ }
403
+ }
404
+
259
405
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts
260
406
  var MCPServer = class {
261
407
  constructor(transport) {
262
408
  this.transport = transport;
409
+ this.transportConnected = false;
263
410
  this.client = createExtensionClient(transport);
264
- this.server = new McpServer({ name: "player-devtools", version: "0.0.1" });
411
+ this.server = new McpServer({
412
+ name: "player-devtools",
413
+ version: MCP_VERSION
414
+ });
415
+ this.analytics = createAnalytics(this.server, {
416
+ isTransportConnected: () => this.transportConnected
417
+ });
265
418
  this.registerTools();
266
419
  }
267
420
  registerTools() {
@@ -279,6 +432,7 @@ var MCPServer = class {
279
432
  await this.server.connect(stdioTransport);
280
433
  try {
281
434
  await this.transport.connect();
435
+ this.transportConnected = true;
282
436
  } catch (err4) {
283
437
  console.warn(
284
438
  "[MCPServer] Transport connect failed (will operate in disconnected mode):",
@@ -287,6 +441,10 @@ var MCPServer = class {
287
441
  }
288
442
  }
289
443
  async stop() {
444
+ try {
445
+ await this.analytics?.shutdown();
446
+ } catch {
447
+ }
290
448
  this.client.destroy();
291
449
  await this.transport.close();
292
450
  await this.server.close();
package/dist/index.mjs CHANGED
@@ -256,12 +256,165 @@ var TOOL_DEFS = [
256
256
  invokeActionDef
257
257
  ];
258
258
 
259
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
260
+ import * as os2 from "os";
261
+ import { instrument } from "@posthog/mcp";
262
+ import { PostHog } from "posthog-node";
263
+
264
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts
265
+ var POSTHOG_PROJECT_KEY = true ? "phc_nXLgnaUwZpPWmfFeY99TMYH3mo54bUFmDUsianCPTDUg" : "";
266
+ var DEFAULT_POSTHOG_HOST = "https://us.i.posthog.com";
267
+ function isTruthy(value) {
268
+ if (value === void 0) return false;
269
+ const normalized = value.trim().toLowerCase();
270
+ if (normalized === "" || normalized === "0" || normalized === "false") {
271
+ return false;
272
+ }
273
+ return true;
274
+ }
275
+ function isOptedOut(env) {
276
+ return isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) || // Cross-vendor convention (consoledonottrack.com) — honored so a user who
277
+ // sets it once is covered everywhere.
278
+ isTruthy(env.DO_NOT_TRACK);
279
+ }
280
+ function resolveTelemetryConfig(env = process.env) {
281
+ if (isOptedOut(env)) return { enabled: false };
282
+ const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;
283
+ if (!apiKey) return { enabled: false };
284
+ if (!apiKey.startsWith("phc_")) return { enabled: false };
285
+ const host = (env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST).replace(/\/+$/, "");
286
+ return { enabled: true, apiKey, host };
287
+ }
288
+
289
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts
290
+ import { randomUUID } from "crypto";
291
+ import * as fs from "fs";
292
+ import * as os from "os";
293
+ import * as path from "path";
294
+ var defaultDeps = {
295
+ homedir: os.homedir,
296
+ readFileSync: fs.readFileSync,
297
+ writeFileSync: fs.writeFileSync,
298
+ mkdirSync: fs.mkdirSync,
299
+ randomUUID
300
+ };
301
+ var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
302
+ var INSTALL_DIR_NAME = ".player-ui-devtools";
303
+ var INSTALL_FILE_NAME = "install.json";
304
+ function getInstallId(deps = defaultDeps) {
305
+ const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);
306
+ const file = path.join(dir, INSTALL_FILE_NAME);
307
+ try {
308
+ const parsed = JSON.parse(
309
+ deps.readFileSync(file, "utf8")
310
+ );
311
+ if (typeof parsed.installId === "string" && UUID_PATTERN.test(parsed.installId)) {
312
+ return parsed.installId;
313
+ }
314
+ } catch {
315
+ }
316
+ const installId = deps.randomUUID();
317
+ try {
318
+ deps.mkdirSync(dir, { recursive: true });
319
+ const contents = { installId };
320
+ deps.writeFileSync(file, JSON.stringify(contents), { mode: 384 });
321
+ } catch {
322
+ return null;
323
+ }
324
+ return installId;
325
+ }
326
+
327
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts
328
+ var ALLOWED_EVENT_PROPERTIES = /* @__PURE__ */ new Set([
329
+ // MCP tool call shape — names and timings only, never payloads.
330
+ "$mcp_tool_name",
331
+ "$mcp_duration_ms",
332
+ "$mcp_is_error",
333
+ "$mcp_error_type",
334
+ "$mcp_listed_tool_names",
335
+ "$mcp_missing_capability",
336
+ // Which editor/agent is driving the server.
337
+ "$mcp_client_name",
338
+ "$mcp_client_version",
339
+ "$mcp_server_name",
340
+ "$mcp_server_version",
341
+ "$mcp_protocol_version",
342
+ // PostHog bookkeeping.
343
+ "$session_id",
344
+ "$process_person_profile",
345
+ "$lib",
346
+ "$lib_version",
347
+ // Our own event properties.
348
+ "mcp_version",
349
+ "os_platform",
350
+ "node_major",
351
+ "transport_connected",
352
+ "surface"
353
+ ]);
354
+ function allowlistEventProperties(event) {
355
+ if (!event?.properties) return event;
356
+ event.properties = Object.fromEntries(
357
+ Object.entries(event.properties).filter(
358
+ ([key]) => ALLOWED_EVENT_PROPERTIES.has(key)
359
+ )
360
+ );
361
+ return event;
362
+ }
363
+
364
+ // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts
365
+ var MCP_VERSION = true ? "0.14.2" : "unstamped";
366
+ function createAnalytics(server, deps) {
367
+ try {
368
+ const config = resolveTelemetryConfig();
369
+ if (!config.enabled) return null;
370
+ const installId = getInstallId();
371
+ if (installId === null) return null;
372
+ const posthog = new PostHog(config.apiKey, {
373
+ host: config.host,
374
+ // The load-bearing privacy control. Runs inside posthog-node's capture(),
375
+ // so it applies to everything the MCP SDK emits regardless of the SDK's
376
+ // own hooks. See redaction.ts for why this is an allowlist.
377
+ before_send: [allowlistEventProperties]
378
+ });
379
+ instrument(server, posthog, {
380
+ // Defaults to ON, and would inject a *required* `context` parameter into
381
+ // every tool schema asking the agent to narrate user intent — mutating
382
+ // our public tool API and adding per-call token cost.
383
+ context: false,
384
+ identify: { distinctId: installId },
385
+ eventProperties: () => ({
386
+ mcp_version: MCP_VERSION,
387
+ os_platform: os2.platform(),
388
+ node_major: Number.parseInt(
389
+ process.versions.node.split(".")[0] ?? "",
390
+ 10
391
+ ),
392
+ transport_connected: deps.isTransportConnected(),
393
+ surface: "mcp-server"
394
+ }),
395
+ // Redundant with `before_send` above, kept as a second independent layer.
396
+ // This hook fails closed: the SDK drops the event if it throws.
397
+ beforeSend: allowlistEventProperties
398
+ });
399
+ return posthog;
400
+ } catch {
401
+ return null;
402
+ }
403
+ }
404
+
259
405
  // ../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts
260
406
  var MCPServer = class {
261
407
  constructor(transport) {
262
408
  this.transport = transport;
409
+ this.transportConnected = false;
263
410
  this.client = createExtensionClient(transport);
264
- this.server = new McpServer({ name: "player-devtools", version: "0.0.1" });
411
+ this.server = new McpServer({
412
+ name: "player-devtools",
413
+ version: MCP_VERSION
414
+ });
415
+ this.analytics = createAnalytics(this.server, {
416
+ isTransportConnected: () => this.transportConnected
417
+ });
265
418
  this.registerTools();
266
419
  }
267
420
  registerTools() {
@@ -279,6 +432,7 @@ var MCPServer = class {
279
432
  await this.server.connect(stdioTransport);
280
433
  try {
281
434
  await this.transport.connect();
435
+ this.transportConnected = true;
282
436
  } catch (err4) {
283
437
  console.warn(
284
438
  "[MCPServer] Transport connect failed (will operate in disconnected mode):",
@@ -287,6 +441,10 @@ var MCPServer = class {
287
441
  }
288
442
  }
289
443
  async stop() {
444
+ try {
445
+ await this.analytics?.shutdown();
446
+ } catch {
447
+ }
290
448
  this.client.destroy();
291
449
  await this.transport.close();
292
450
  await this.server.close();
@@ -1 +1 @@
1
- {"version":3,"sources":["../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts"],"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\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({ name: \"player-devtools\", version: \"0.0.1\" });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n } 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 this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n"],"mappings":"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","names":["z","playerIdShape","z","err","ok","z","err","ok","err"]}
1
+ {"version":3,"sources":["../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/server.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/flow.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/players.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/plugins.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/select.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/tools/index.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/index.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/config.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/installId.ts","../../../../../../../../../../../execroot/_main/bazel-out/k8-fastbuild/bin/devtools/mcp/src/telemetry/redaction.ts"],"sourcesContent":["import {\n createExtensionClient,\n type ExtensionClient,\n} from \"@player-devtools/client\";\nimport type { Transport } from \"@player-devtools/types\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { PostHog } from \"posthog-node\";\n\nimport { TOOL_DEFS, type ToolDef } from \"./tools\";\nimport { createAnalytics, MCP_VERSION } from \"./telemetry\";\n\nexport class MCPServer {\n private client: ExtensionClient;\n private server: McpServer;\n private analytics: PostHog | null;\n private transportConnected = false;\n\n constructor(private transport: Transport) {\n this.client = createExtensionClient(transport);\n this.server = new McpServer({\n name: \"player-devtools\",\n version: MCP_VERSION,\n });\n // Instrument before registering tools so every handler is wrapped.\n this.analytics = createAnalytics(this.server, {\n isTransportConnected: () => this.transportConnected,\n });\n this.registerTools();\n }\n\n private registerTools(): void {\n for (const def of TOOL_DEFS) {\n // `registerTool` is heavily generic over the Zod input shape; inferring\n // that across a heterogeneous array trips TS2589 (excessively deep). The\n // shapes are validated at runtime by the SDK, so register through a\n // loosely-typed view to keep inference shallow.\n const register = this.server.registerTool.bind(this.server) as (\n name: string,\n config: { description: string; inputSchema: ToolDef[\"inputSchema\"] },\n cb: (args: unknown) => CallToolResult,\n ) => unknown;\n\n register(\n def.name,\n { description: def.description, inputSchema: def.inputSchema },\n (args) => def.handle(this.client, args),\n );\n }\n }\n\n async start(): Promise<void> {\n const stdioTransport = new StdioServerTransport();\n await this.server.connect(stdioTransport);\n try {\n await this.transport.connect();\n this.transportConnected = true;\n } catch (err) {\n console.warn(\n \"[MCPServer] Transport connect failed (will operate in disconnected mode):\",\n err instanceof Error ? err.message : err,\n );\n }\n }\n\n async stop(): Promise<void> {\n // Flush buffered events first: bin/run calls process.exit(0) as soon as\n // this resolves, which would otherwise drop them. Never fail shutdown on a\n // telemetry error.\n try {\n await this.analytics?.shutdown();\n } catch {\n /* best-effort */\n }\n this.client.destroy();\n await this.transport.close();\n await this.server.close();\n }\n}\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { PluginData } from \"@player-devtools/types\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\ntype Failure = { error: string };\ntype PlayerOk = {\n id: string;\n player: {\n plugins: Record<string, PluginData>;\n active: boolean;\n config: Record<string, unknown>;\n };\n};\ntype BasicPluginOk = PlayerOk & { basicPlugin: PluginData };\n\n/** Optional player id, shared by the player-scoped read tools. */\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst PlayerInput = z.object(playerIdShape);\n\nfunction resolvePlayer(\n client: ExtensionClient,\n playerId?: string,\n): Failure | PlayerOk {\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return { error: \"no player selected\" };\n const player = players[id];\n if (!player) return { error: `player not found: ${id}` };\n return { id, player };\n}\n\nfunction resolveBasicPlugin(\n client: ExtensionClient,\n playerId?: string,\n): Failure | BasicPluginOk {\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return resolved;\n const { id, player } = resolved;\n // Find the first plugin — by convention the basic plugin is registered first\n const [basicPlugin] = Object.values(player.plugins);\n if (!basicPlugin) return { error: \"no plugin registered for this player\" };\n return { id, player, basicPlugin };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport function handleGetFlow(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow);\n}\n\nexport function handleGetData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n return ok(resolved.basicPlugin.flow?.data ?? null);\n}\n\nexport function handleGetLogs(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = PlayerInput.parse(input);\n const resolved = resolveBasicPlugin(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n // Logs live in the plugin's flow data under a \"logs\" key by convention\n return ok(\n (resolved.basicPlugin.flow?.data as Record<string, unknown>)?.logs ?? [],\n );\n}\n\nconst getPluginDataShape = {\n ...playerIdShape,\n pluginId: z.string().describe(\"Plugin ID.\"),\n dataKey: z.string().describe(\"Key to retrieve from the plugin's data.\"),\n};\n\nconst GetPluginDataInput = z.object(getPluginDataShape);\n\nexport function handleGetPluginData(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, dataKey } = GetPluginDataInput.parse(input);\n const resolved = resolvePlayer(client, playerId);\n if (\"error\" in resolved) return err(resolved.error);\n const plugin = resolved.player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n const value = (plugin.flow?.data as Record<string, unknown> | undefined)?.[\n dataKey\n ];\n return ok(value ?? null);\n}\n\nexport const getFlowDef: ToolDef = {\n name: \"get_flow\",\n description:\n \"Get the current flow from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetFlow,\n};\n\nexport const getDataDef: ToolDef = {\n name: \"get_data\",\n description:\n \"Get the current flow data model from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetData,\n};\n\nexport const getLogsDef: ToolDef = {\n name: \"get_logs\",\n description:\n \"Get the logs from the basic devtools plugin for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetLogs,\n};\n\nexport const getPluginDataDef: ToolDef = {\n name: \"get_plugin_data\",\n description: \"Get a specific data key from any plugin for a Player instance.\",\n inputSchema: getPluginDataShape,\n handle: handleGetPluginData,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst playerIdShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n};\n\nconst GetPlayerStatusInput = z.object(playerIdShape);\n\nexport function handleListPlayers(client: ExtensionClient): CallToolResult {\n const { players, current } = client.getState();\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n players: Object.keys(players),\n current: current.player,\n }),\n },\n ],\n };\n}\n\nexport function handleGetPlayerStatus(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = GetPlayerStatusInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return errorResult(\"no player selected\");\n const player = players[id];\n if (!player) return errorResult(`player not found: ${id}`);\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({\n active: player.active,\n plugins: Object.keys(player.plugins),\n }),\n },\n ],\n };\n}\n\nfunction errorResult(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nexport const listPlayersDef: ToolDef = {\n name: \"list_players\",\n description:\n \"List all Player instances known to the devtools, and which one is currently selected.\",\n inputSchema: {},\n handle: (client) => handleListPlayers(client),\n};\n\nexport const getPlayerStatusDef: ToolDef = {\n name: \"get_player_status\",\n description:\n \"Get the active status and registered plugin IDs for a Player instance.\",\n inputSchema: playerIdShape,\n handle: handleGetPlayerStatus,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst describePluginShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n};\n\nconst DescribePluginInput = z.object(describePluginShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleDescribePlugin(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId } = DescribePluginInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (!plugin.capabilities)\n return err(`plugin \"${pluginId}\" has no capabilities declared`);\n return ok(plugin.capabilities);\n}\n\nexport const describePluginDef: ToolDef = {\n name: \"describe_plugin\",\n description:\n \"Get the capability descriptor declared by a plugin at registration time. Use this to discover what data keys and actions the plugin exposes.\",\n inputSchema: describePluginShape,\n handle: handleDescribePlugin,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport type { ToolDef } from \"./index\";\n\nconst selectPlayerShape = {\n playerId: z.string().describe(\"The Player ID to select.\"),\n};\n\nconst invokeActionShape = {\n playerId: z\n .string()\n .optional()\n .describe(\"Player ID. Defaults to the currently selected player.\"),\n pluginId: z.string().describe(\"Plugin ID.\"),\n action: z.string().describe(\"Action name.\"),\n payload: z.string().optional().describe(\"Optional stringified payload.\"),\n};\n\nconst SelectPlayerInput = z.object(selectPlayerShape);\n\nconst InvokeActionInput = z.object(invokeActionShape);\n\nfunction err(message: string): CallToolResult {\n return {\n content: [{ type: \"text\", text: JSON.stringify({ error: message }) }],\n };\n}\n\nfunction ok(value: unknown): CallToolResult {\n return { content: [{ type: \"text\", text: JSON.stringify(value) }] };\n}\n\nexport function handleSelectPlayer(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId } = SelectPlayerInput.parse(input);\n const { players } = client.getState();\n if (!players[playerId]) return err(`player not found: ${playerId}`);\n client.selectPlayer(playerId);\n return ok({ selected: playerId });\n}\n\nexport function handleInvokeAction(\n client: ExtensionClient,\n input: unknown,\n): CallToolResult {\n const { playerId, pluginId, action, payload } =\n InvokeActionInput.parse(input);\n const { players, current } = client.getState();\n const id = playerId ?? current.player;\n if (!id) return err(\"no player selected\");\n const player = players[id];\n if (!player) return err(`player not found: ${id}`);\n const plugin = player.plugins[pluginId];\n if (!plugin) return err(`plugin not found: ${pluginId}`);\n if (\n plugin.capabilities?.actions &&\n !(action in plugin.capabilities.actions)\n ) {\n return err(`action \"${action}\" not declared in plugin capabilities`);\n }\n client.handleInteraction({ type: action, payload, target: id });\n return ok({ invoked: action });\n}\n\nexport const selectPlayerDef: ToolDef = {\n name: \"select_player\",\n description:\n \"Select a Player instance as the active target for subsequent tool calls.\",\n inputSchema: selectPlayerShape,\n handle: handleSelectPlayer,\n};\n\nexport const invokeActionDef: ToolDef = {\n name: \"invoke_action\",\n description:\n \"Invoke a named action on a plugin. Use describe_plugin first to discover available actions.\",\n inputSchema: invokeActionShape,\n handle: handleInvokeAction,\n};\n","import type { ExtensionClient } from \"@player-devtools/client\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { ZodRawShape } from \"zod\";\n\n/**\n * A tool definition consumed by the MCP server. `inputSchema` is a Zod raw\n * shape — the SDK derives the JSON Schema, validates input, and types the\n * handler's `args`. The handler receives the running devtools client plus the\n * validated args.\n */\nexport type ToolDef<Shape extends ZodRawShape = ZodRawShape> = {\n name: string;\n description: string;\n inputSchema: Shape;\n handle: (client: ExtensionClient, args: unknown) => CallToolResult;\n};\n\nexport * from \"./flow\";\nexport * from \"./players\";\nexport * from \"./plugins\";\nexport * from \"./select\";\n\nimport { listPlayersDef, getPlayerStatusDef } from \"./players\";\nimport { getFlowDef, getDataDef, getLogsDef, getPluginDataDef } from \"./flow\";\nimport { describePluginDef } from \"./plugins\";\nimport { selectPlayerDef, invokeActionDef } from \"./select\";\n\n/** Every tool the MCP server exposes. */\nexport const TOOL_DEFS: ToolDef[] = [\n listPlayersDef,\n getPlayerStatusDef,\n getFlowDef,\n getDataDef,\n getLogsDef,\n getPluginDataDef,\n describePluginDef,\n selectPlayerDef,\n invokeActionDef,\n];\n","import * as os from \"os\";\nimport { instrument } from \"@posthog/mcp\";\nimport { PostHog } from \"posthog-node\";\n\nimport { resolveTelemetryConfig } from \"./config\";\nimport { getInstallId } from \"./installId\";\nimport { allowlistEventProperties } from \"./redaction\";\n\nexport {\n ALLOWED_EVENT_PROPERTIES,\n allowlistEventProperties,\n} from \"./redaction\";\nexport { resolveTelemetryConfig, type TelemetryConfig } from \"./config\";\nexport { getInstallId, type InstallIdDeps } from \"./installId\";\n\ndeclare global {\n const __VERSION__: string;\n}\n\n/**\n * Stamped at release build time by tsup (see devtools/tsup.config.ts). The\n * guard is required — the global is absent in local and test builds.\n */\nexport const MCP_VERSION: string =\n typeof __VERSION__ !== \"undefined\" ? __VERSION__ : \"unstamped\";\n\nexport type AnalyticsDeps = {\n /** Reports whether the devtools transport is currently connected. */\n isTransportConnected: () => boolean;\n};\n\n/**\n * Instruments `server` with anonymous usage analytics.\n *\n * Returns the PostHog client so the caller can flush it on shutdown, or `null`\n * when telemetry is disabled or no durable identity is available. Never throws:\n * telemetry must not be able to prevent the server from starting.\n */\nexport function createAnalytics(\n server: object,\n deps: AnalyticsDeps,\n): PostHog | null {\n try {\n const config = resolveTelemetryConfig();\n if (!config.enabled) return null;\n\n const installId = getInstallId();\n if (installId === null) return null;\n\n const posthog = new PostHog(config.apiKey, {\n host: config.host,\n // The load-bearing privacy control. Runs inside posthog-node's capture(),\n // so it applies to everything the MCP SDK emits regardless of the SDK's\n // own hooks. See redaction.ts for why this is an allowlist.\n before_send: [allowlistEventProperties],\n });\n\n instrument(server, posthog, {\n // Defaults to ON, and would inject a *required* `context` parameter into\n // every tool schema asking the agent to narrate user intent — mutating\n // our public tool API and adding per-call token cost.\n context: false,\n identify: { distinctId: installId },\n eventProperties: () => ({\n mcp_version: MCP_VERSION,\n os_platform: os.platform(),\n node_major: Number.parseInt(\n process.versions.node.split(\".\")[0] ?? \"\",\n 10,\n ),\n transport_connected: deps.isTransportConnected(),\n surface: \"mcp-server\",\n }),\n // Redundant with `before_send` above, kept as a second independent layer.\n // This hook fails closed: the SDK drops the event if it throws.\n beforeSend: allowlistEventProperties,\n });\n\n return posthog;\n } catch {\n // Telemetry is strictly best-effort — a misconfiguration must never take\n // down the server.\n return null;\n }\n}\n","declare global {\n const __POSTHOG_KEY__: string;\n}\n\n/**\n * PostHog project API key, stamped at release build time from the\n * `POSTHOG_PROJECT_KEY` CI environment variable (see\n * helpers/release/workspace-status.sh and tsup.config.ts), mirroring how\n * `__VERSION__` is stamped.\n *\n * This is a *public, write-only* ingestion token — it can only send events and\n * cannot read data back, which is why it is safe to ship in an open-source\n * package.\n *\n * The `typeof` guard is required: the global is absent in local and test\n * builds, where it resolves to an empty string and disables telemetry.\n */\nconst POSTHOG_PROJECT_KEY =\n typeof __POSTHOG_KEY__ !== \"undefined\" ? __POSTHOG_KEY__ : \"\";\n\nconst DEFAULT_POSTHOG_HOST = \"https://us.i.posthog.com\";\n\nexport type TelemetryConfig =\n | { readonly enabled: false }\n | { readonly enabled: true; readonly apiKey: string; readonly host: string };\n\n/**\n * Presence of the variable opts out, *except* for explicit negatives —\n * `DO_NOT_TRACK=0` means \"tracking is fine\", not \"opted out\".\n */\nfunction isTruthy(value: string | undefined): boolean {\n if (value === undefined) return false;\n const normalized = value.trim().toLowerCase();\n if (normalized === \"\" || normalized === \"0\" || normalized === \"false\") {\n return false;\n }\n return true;\n}\n\nfunction isOptedOut(env: NodeJS.ProcessEnv): boolean {\n return (\n isTruthy(env.PLAYER_DEVTOOLS_TELEMETRY_DISABLED) ||\n // Cross-vendor convention (consoledonottrack.com) — honored so a user who\n // sets it once is covered everywhere.\n isTruthy(env.DO_NOT_TRACK)\n );\n}\n\nexport function resolveTelemetryConfig(\n env: NodeJS.ProcessEnv = process.env,\n): TelemetryConfig {\n if (isOptedOut(env)) return { enabled: false };\n\n const apiKey = env.PLAYER_DEVTOOLS_TELEMETRY_KEY ?? POSTHOG_PROJECT_KEY;\n // Unstamped (local/dev builds) or unset in CI — stay silent rather than\n // firing doomed requests at PostHog on every startup.\n if (!apiKey) return { enabled: false };\n // Only public write-only project keys may ship. A `phx_` (personal) or\n // `phs_` (project secret) key is a real credential and must never be baked\n // into a published artifact, so refuse to use one even if stamped.\n if (!apiKey.startsWith(\"phc_\")) return { enabled: false };\n\n const host = (\n env.PLAYER_DEVTOOLS_TELEMETRY_HOST ?? DEFAULT_POSTHOG_HOST\n ).replace(/\\/+$/, \"\");\n\n return { enabled: true, apiKey, host };\n}\n","import { randomUUID } from \"crypto\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\n\nexport type InstallIdDeps = {\n /** Resolves the user's home directory. */\n homedir: () => string;\n /** Reads the install file. */\n readFileSync: typeof fs.readFileSync;\n /** Writes the install file. */\n writeFileSync: typeof fs.writeFileSync;\n /** Creates the install directory. */\n mkdirSync: typeof fs.mkdirSync;\n /** Mints a new identifier. */\n randomUUID: () => string;\n};\n\nconst defaultDeps: InstallIdDeps = {\n homedir: os.homedir,\n readFileSync: fs.readFileSync,\n writeFileSync: fs.writeFileSync,\n mkdirSync: fs.mkdirSync,\n randomUUID,\n};\n\ntype InstallFile = { installId: string };\n\nconst UUID_PATTERN =\n /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nexport const INSTALL_DIR_NAME = \".player-ui-devtools\";\nexport const INSTALL_FILE_NAME = \"install.json\";\n\n/**\n * A stable, anonymous per-machine identifier.\n *\n * Stored under the user's home directory rather than the OS temp dir the\n * flipper refcount uses: temp is periodically reaped, which would regenerate\n * the id on every reboot and turn \"unique installs\" into \"unique boots\".\n *\n * Returns `null` when the id can neither be read nor persisted (read-only FS,\n * sandbox, absent HOME). Callers treat that as \"telemetry off\" — returning an\n * in-memory id instead would register a brand-new install on every run and\n * systematically inflate counts for exactly the sandboxed population least\n * likely to be real users.\n */\nexport function getInstallId(deps: InstallIdDeps = defaultDeps): string | null {\n const dir = path.join(deps.homedir(), INSTALL_DIR_NAME);\n const file = path.join(dir, INSTALL_FILE_NAME);\n\n try {\n const parsed = JSON.parse(\n deps.readFileSync(file, \"utf8\") as string,\n ) as Partial<InstallFile>;\n // Validate the shape, not just the parse: `{\"installId\": 42}` parses fine\n // but is not a usable identity.\n if (\n typeof parsed.installId === \"string\" &&\n UUID_PATTERN.test(parsed.installId)\n ) {\n return parsed.installId;\n }\n } catch {\n /* missing or corrupt — fall through and regenerate */\n }\n\n const installId = deps.randomUUID();\n try {\n deps.mkdirSync(dir, { recursive: true });\n const contents: InstallFile = { installId };\n // 0600: a stable per-user identifier should not be world-readable.\n deps.writeFileSync(file, JSON.stringify(contents), { mode: 0o600 });\n } catch {\n return null;\n }\n\n return installId;\n}\n","/**\n * Event property allowlist.\n *\n * `@posthog/mcp` captures tool arguments (`$mcp_parameters`) and tool results\n * (`$mcp_response`) unconditionally — there is no SDK option to disable it, and\n * its built-in sanitizer only matches sensitive *key names* (`token`,\n * `password`, ...), so a field named `flowContent` would be transmitted\n * verbatim. Devtools tool arguments carry player/plugin ids and `invoke_action`\n * payloads, i.e. potentially customer flow data.\n *\n * This is an allowlist rather than a denylist on purpose: the SDK is 0.x and\n * ships frequently, so a denylist naming today's two payload keys would\n * silently start leaking the moment a release adds a third. Anything not\n * explicitly listed here never reaches the wire.\n */\nexport const ALLOWED_EVENT_PROPERTIES: ReadonlySet<string> = new Set([\n // MCP tool call shape — names and timings only, never payloads.\n \"$mcp_tool_name\",\n \"$mcp_duration_ms\",\n \"$mcp_is_error\",\n \"$mcp_error_type\",\n \"$mcp_listed_tool_names\",\n \"$mcp_missing_capability\",\n // Which editor/agent is driving the server.\n \"$mcp_client_name\",\n \"$mcp_client_version\",\n \"$mcp_server_name\",\n \"$mcp_server_version\",\n \"$mcp_protocol_version\",\n // PostHog bookkeeping.\n \"$session_id\",\n \"$process_person_profile\",\n \"$lib\",\n \"$lib_version\",\n // Our own event properties.\n \"mcp_version\",\n \"os_platform\",\n \"node_major\",\n \"transport_connected\",\n \"surface\",\n]);\n\nexport type CapturedEvent = {\n /** Event name. */\n event?: string;\n /** Event properties. */\n properties?: Record<string, unknown>;\n};\n\n/**\n * Drops every property not in {@link ALLOWED_EVENT_PROPERTIES}.\n *\n * Installed as a `posthog-node` client-level `before_send`, which runs inside\n * `capture()` — a chokepoint the MCP SDK cannot route around, since we own the\n * client instance and it does not.\n *\n * Accepts `null` because `before_send` hooks compose: an earlier hook may have\n * already dropped the event.\n */\nexport function allowlistEventProperties<Event extends CapturedEvent>(\n event: Event | null,\n): Event | null {\n if (!event?.properties) return event;\n\n event.properties = Object.fromEntries(\n Object.entries(event.properties).filter(([key]) =>\n ALLOWED_EVENT_PROPERTIES.has(key),\n ),\n );\n\n return event;\n}\n"],"mappings":"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","names":["z","playerIdShape","z","err","ok","z","err","ok","os","err"]}
package/package.json CHANGED
@@ -5,17 +5,23 @@
5
5
  "bin"
6
6
  ],
7
7
  "name": "@player-devtools/mcp",
8
- "version": "0.14.2-next.0",
8
+ "version": "0.14.2",
9
9
  "main": "dist/cjs/index.cjs",
10
10
  "bin": {
11
11
  "player-devtools-mcp": "bin/run"
12
12
  },
13
+ "engines": {
14
+ "node": "^20.20.0 || >=22.22.0"
15
+ },
13
16
  "dependencies": {
14
- "@player-devtools/client": "0.14.2-next.0",
15
- "@player-devtools/client-flipper": "0.14.2-next.0",
16
- "@player-devtools/messenger": "0.14.2-next.0",
17
- "@player-devtools/types": "0.14.2-next.0",
17
+ "@player-devtools/client": "0.14.2",
18
+ "@player-devtools/client-flipper": "0.14.2",
19
+ "@player-devtools/messenger": "0.14.2",
20
+ "@player-devtools/types": "0.14.2",
18
21
  "@modelcontextprotocol/sdk": "^1.0.0",
22
+ "@posthog/mcp": "0.10.8",
23
+ "@types/node": "^24.0.1",
24
+ "posthog-node": "^5.0.0",
19
25
  "zod": "^3.0.0",
20
26
  "tslib": "^2.6.2"
21
27
  },