@perfonext/render-mcp 0.1.0 → 0.3.0

package/dist/tools/run-render-capture.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { getCaptureSession } from '../ingest/server.js';
+export function registerRunRenderCapture(server) {
+    server.registerTool('run_render_capture', {
+        title: 'Run Render Capture',
+        description: 'Called after instrumentation is wired up (steps 1–3 of begin_render_analysis). ' +
+            'Ask the user how they want to generate renders before calling this tool:\n' +
+            '  manual-interaction — start the dev server and the user clicks through the app.\n' +
+            '  test-suite         — run an existing automated test suite against the running app.',
+        inputSchema: {
+            sessionId: z.string().describe('The sessionId returned by begin_render_analysis.'),
+            method: z
+                .enum(['manual-interaction', 'test-suite'])
+                .describe('"manual-interaction": user navigates the app manually (fast, focused). ' +
+                '"test-suite": run an existing test suite (automated; scope to one file/feature to keep payload manageable).'),
+        },
+    }, async ({ sessionId, method }) => {
+        const session = getCaptureSession(sessionId);
+        if (!session || session.status !== 'active') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: `No active session for sessionId "${sessionId}". Call begin_render_analysis first.` }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        if (method === 'manual-interaction') {
+            const result = {
+                method,
+                sessionId,
+                instructions: [
+                    '1. Start the dev server (e.g. `npm run dev`).',
+                    '2. Open the app in your browser and interact with the pages/flows you want to profile.',
+                    '3. When done, call stop_render_capture to end the session.',
+                ].join('\n'),
+                nextStep: `stop_render_capture({ sessionId: "${sessionId}" })`,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        // test-suite
+        const result = {
+            method,
+            sessionId,
+            instructions: [
+                '1. Start the dev server if not already running (e.g. `npm run dev`).',
+                '2. Run your test suite. Scope to a single test file or feature to keep the payload manageable.',
+                '3. When the run finishes, call stop_render_capture to end the session.',
+            ].join('\n'),
+            nextStep: `stop_render_capture({ sessionId: "${sessionId}" })`,
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=run-render-capture.js.map

package/dist/tools/run-render-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-render-capture.js","sourceRoot":"","sources":["../../src/tools/run-render-capture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE;QACxC,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,iFAAiF;YACjF,4EAA4E;YAC5E,oFAAoF;YACpF,sFAAsF;QACxF,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YAClF,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;iBAC1C,QAAQ,CACP,yEAAyE;gBACzE,6GAA6G,CAC9G;SACJ;KACF,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,oCAAoC,SAAS,sCAAsC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC9H,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,oBAAoB,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG;gBACb,MAAM;gBACN,SAAS;gBACT,YAAY,EAAE;oBACZ,+CAA+C;oBAC/C,wFAAwF;oBACxF,4DAA4D;iBAC7D,CAAC,IAAI,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,qCAAqC,SAAS,MAAM;aAC/D,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAED,aAAa;QACb,MAAM,MAAM,GAAG;YACb,MAAM;YACN,SAAS;YACT,YAAY,EAAE;gBACZ,sEAAsE;gBACtE,gGAAgG;gBAChG,wEAAwE;aACzE,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,qCAAqC,SAAS,MAAM;SAC/D,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/stop-render-capture.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerStopRenderCapture(server: McpServer): void;
+//# sourceMappingURL=stop-render-capture.d.ts.map

package/dist/tools/stop-render-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-render-capture.d.ts","sourceRoot":"","sources":["../../src/tools/stop-render-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiEjE"}

package/dist/tools/stop-render-capture.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { deleteCaptureSession, getCaptureSession, stopCaptureSession } from '../ingest/server.js';
+import { adaptReactScanEvents } from '../parser/react-scan-lite.js';
+import { storeRenderProfile } from '../store.js';
+import { formatMs } from '../format.js';
+export function registerStopRenderCapture(server) {
+    server.registerTool('stop_render_capture', {
+        title: 'Stop Render Capture',
+        description: 'Stop a live render-capture session, finalize the buffered events into a render profile, ' +
+            'and return a profileId you can use with get_render_summary, get_slow_components, ' +
+            'get_rerender_causes, and compare_renders.',
+        inputSchema: {
+            sessionId: z.string().describe('The sessionId returned by start_render_capture'),
+        },
+    }, async ({ sessionId }) => {
+        const session = getCaptureSession(sessionId);
+        if (!session) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: `Session "${sessionId}" not found` }, null, 2) }],
+                isError: true,
+            };
+        }
+        if (session.status === 'stopped') {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: `Session "${sessionId}" is already stopped` }, null, 2) }],
+                isError: true,
+            };
+        }
+        // Mark stopped before processing so no new events are accepted.
+        stopCaptureSession(sessionId);
+        const commitCount = session.commits.length;
+        if (commitCount === 0) {
+            const warning = session.profilingAvailable === false
+                ? 'No commits captured. The app reported profiling-hooks-status: false — ' +
+                    'this usually means the app is running a production build. ' +
+                    'Switch to `next dev` or alias react-dom to react-dom/profiling.'
+                : 'No commits captured. Make sure the instrumentation snippet was loaded ' +
+                    'and you interacted with the app while the session was active.';
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ warning, sessionId, commitCount: 0 }, null, 2) }],
+            };
+        }
+        const profile = adaptReactScanEvents(session.commits, sessionId);
+        storeRenderProfile(profile);
+        // Session data is no longer needed — free memory.
+        deleteCaptureSession(sessionId);
+        const result = {
+            profileId: profile.id,
+            sessionId,
+            commitCount: profile.commits.length,
+            componentCount: profile.components.length,
+            totalCommitDuration: formatMs(profile.totalCommitDuration),
+            profilingAvailable: session.profilingAvailable,
+            nextStep: `call get_render_summary with profileId "${profile.id}"`,
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=stop-render-capture.js.map

package/dist/tools/stop-render-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-render-capture.js","sourceRoot":"","sources":["../../src/tools/stop-render-capture.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@perfonext/render-mcp",
-  "version": "0.1.0",
-  "description": "MCP server for analyzing Next.js React Profiler exports and render performance",
+  "version": "0.3.0",
+  "description": "MCP server for analyzing Next.js React Profiler exports: render summaries, rerender causes, hot commits, and profile diffing",
   "type": "module",
   "main": "dist/index.js",
   "bin": {