playwright-e2e-mcp 0.1.0

package/dist/tools/inspect-page.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Tool 3 — inspect-page: launch a headless browser against a live URL
+ * and return the rendered DOM: element inventory with unique CSS
+ * selectors, visibility, boxes, text and attributes, optional HTML and
+ * captured console messages.
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResponse } from '../types/index.js';
+declare const inspectPageInput: z.ZodObject<{
+    url: z.ZodString;
+    projectRoot: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    waitFor: z.ZodOptional<z.ZodString>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    includeHtml: z.ZodOptional<z.ZodBoolean>;
+    maxHtmlChars: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type InspectPageInput = z.infer<typeof inspectPageInput>;
+export declare const inspectPageSchema: z.ZodObject<{
+    url: z.ZodString;
+    projectRoot: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    waitFor: z.ZodOptional<z.ZodString>;
+    waitUntil: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    includeHtml: z.ZodOptional<z.ZodBoolean>;
+    maxHtmlChars: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const inspectPageTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        url: z.ZodString;
+        projectRoot: z.ZodOptional<z.ZodString>;
+        selector: z.ZodOptional<z.ZodString>;
+        waitFor: z.ZodOptional<z.ZodString>;
+        waitUntil: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        includeHtml: z.ZodOptional<z.ZodBoolean>;
+        maxHtmlChars: z.ZodOptional<z.ZodNumber>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    handler: (args: InspectPageInput, ctx: ToolContext) => Promise<ToolResponse>;
+};
+export {};

package/dist/tools/inspect-page.js

@@ -0,0 +1,124 @@
+/**
+ * Tool 3 — inspect-page: launch a headless browser against a live URL
+ * and return the rendered DOM: element inventory with unique CSS
+ * selectors, visibility, boxes, text and attributes, optional HTML and
+ * captured console messages.
+ */
+import { z } from 'zod';
+import { assertHttpUrl, clipLines, guard, resolveProjectRoot, runBrowserScript, toolError, toolText, } from './shared.js';
+const inspectPageInput = z.object({
+    url: z.string().describe('Full URL of the page to open (http/https)'),
+    projectRoot: z
+        .string()
+        .optional()
+        .describe('Project whose Playwright install launches the browser; defaults to the server working directory'),
+    selector: z
+        .string()
+        .optional()
+        .describe('CSS selector: inspect matches instead of the whole DOM'),
+    waitFor: z
+        .string()
+        .optional()
+        .describe('Wait for this selector (CSS or "text=...") to appear before inspecting'),
+    waitUntil: z
+        .enum(['load', 'domcontentloaded', 'networkidle'])
+        .optional()
+        .describe('Navigation wait condition (default domcontentloaded)'),
+    includeHtml: z.boolean().optional().describe('Include the rendered HTML (truncated)'),
+    maxHtmlChars: z.number().int().min(1_000).max(200_000).optional().describe('HTML cap when includeHtml is set (default 20000)'),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(1_000)
+        .max(300_000)
+        .optional()
+        .describe('Overall inspection limit in ms (default 45000)'),
+});
+export const inspectPageSchema = inspectPageInput;
+function renderElement(element, position) {
+    const visibility = element.visible ? 'visible' : 'hidden';
+    const box = element.box
+        ? `${element.box.width}×${element.box.height} at (${element.box.x},${element.box.y})`
+        : 'no box';
+    const lines = [
+        `${position}. \`${element.selector}\` — **${element.tag}** · ${visibility} · ${box}`,
+    ];
+    if (element.text)
+        lines.push(`   text: "${element.text}"`);
+    const attrs = Object.entries(element.attributes).filter(([name]) => name !== 'class' && name !== 'id');
+    if (attrs.length > 0) {
+        const shown = attrs
+            .slice(0, 8)
+            .map(([name, value]) => `\`${name}="${value.length > 80 ? `${value.slice(0, 80)}…` : value}"\``);
+        lines.push(`   attrs: ${shown.join(' ')}`);
+    }
+    return lines.join('\n');
+}
+export const inspectPageTool = {
+    name: 'inspect-page',
+    description: 'Open a URL in a headless browser and return the rendered DOM: elements with unique CSS selectors, visibility, bounding boxes, text, attributes, captured console messages and optional HTML. Use this to understand a live page before writing or fixing selectors/tests. Requires a reachable URL (detects a missing dev server).',
+    inputSchema: inspectPageSchema,
+    handler: async (args, ctx) => guard('inspect-page', async () => {
+        const url = assertHttpUrl(args.url);
+        const root = await resolveProjectRoot(args.projectRoot, ctx);
+        const timeoutMs = args.timeoutMs ?? 45_000;
+        const outcome = await runBrowserScript({
+            mode: 'inspect',
+            projectRoot: root,
+            url,
+            selector: args.selector,
+            waitFor: args.waitFor,
+            waitUntil: args.waitUntil,
+            includeHtml: args.includeHtml,
+            maxHtmlChars: args.maxHtmlChars,
+            gotoTimeout: Math.max(5_000, timeoutMs - 5_000),
+            waitTimeout: Math.min(10_000, Math.max(3_000, timeoutMs - 5_000)),
+            startedAt: Date.now(),
+        }, { timeoutMs, signal: ctx.signal });
+        if (!outcome.ok) {
+            return toolError(outcome.kind ?? 'UNKNOWN', `Could not inspect ${url}: ${outcome.error ?? 'unknown error'}`, outcome.hint, outcome.stderrTail);
+        }
+        const data = outcome.data;
+        if (data.parseError) {
+            return toolError('INVALID_PATH', `Invalid selector "${args.selector}": ${data.parseError}`, 'inspect-page validates CSS selectors only (what document.querySelectorAll accepts).');
+        }
+        const lines = [];
+        const title = data.title ? `"${data.title}"` : '(no title)';
+        lines.push(`## 🔎 ${title}`, '');
+        lines.push(`**URL:** ${url}${data.finalUrl && data.finalUrl !== url ? ` → ${data.finalUrl}` : ''}  `, `**Elements:** ${data.elementCount}  |  **Viewport:** ${data.viewport ? `${data.viewport.width}×${data.viewport.height}` : '—'}  |  **Took:** ${data.durationMs ?? 0}ms`, '');
+        const heading = args.selector
+            ? `### Matches for \`${args.selector}\` (${data.matchCount})`
+            : `### DOM sample (first ${data.elements.length} of ${data.elementCount} elements)`;
+        lines.push(heading, '');
+        if (data.elements.length === 0) {
+            lines.push('_No elements matched._', '');
+        }
+        else {
+            for (let i = 0; i < data.elements.length; i += 1) {
+                lines.push(renderElement(data.elements[i], i + 1), '');
+            }
+            if (data.matchCount > data.elements.length) {
+                lines.push(`_…and ${data.matchCount - data.elements.length} more. Narrow with \`selector\`._`, '');
+            }
+        }
+        const errors = (data.consoleMessages ?? []).filter((m) => m.type === 'error' || m.type === 'pageerror');
+        const messages = [...errors, ...(data.consoleMessages ?? []).filter((m) => m.type !== 'error' && m.type !== 'pageerror')];
+        if (messages.length > 0) {
+            lines.push('### Console', '');
+            for (const message of messages.slice(0, 20)) {
+                lines.push(`- \`${message.type}\`: ${clipLines(message.text, 1, 240)}`);
+            }
+            if (messages.length > 20)
+                lines.push(`- _…${messages.length - 20} more_`);
+            lines.push('');
+        }
+        if (data.html !== undefined) {
+            lines.push(`### HTML${data.htmlTruncated ? ` (truncated at ${data.html.length} chars)` : ''}`, '', '```html', data.html, '```', '');
+        }
+        if (args.selector && data.matchCount > 1) {
+            lines.push(`> \`${args.selector}\` matches ${data.matchCount} elements. If you need exactly one, use the first unique selector above.`);
+        }
+        return toolText(lines.join('\n'));
+    }),
+};
+//# sourceMappingURL=inspect-page.js.map

package/dist/tools/inspect-page.js.map

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

package/dist/tools/list-tests.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tool 4 — list-tests: list the project's Playwright tests (via
+ * `playwright test --list`, falling back to a source scan when
+ * Playwright is missing or the project does not compile).
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResponse } from '../types/index.js';
+declare const listTestsInput: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodString>;
+    testDir: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ListTestsInput = z.infer<typeof listTestsInput>;
+export declare const listTestsSchema: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodString>;
+    testDir: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const listTestsTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        projectRoot: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodString>;
+        testDir: z.ZodOptional<z.ZodString>;
+        filter: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    handler: (args: ListTestsInput, ctx: ToolContext) => Promise<ToolResponse>;
+};
+export {};

package/dist/tools/list-tests.js

@@ -0,0 +1,88 @@
+/**
+ * Tool 4 — list-tests: list the project's Playwright tests (via
+ * `playwright test --list`, falling back to a source scan when
+ * Playwright is missing or the project does not compile).
+ */
+import { z } from 'zod';
+import { detectProject } from '../utils/project-detector.js';
+import { listTests } from '../utils/playwright-runner.js';
+import { isPathInside, normalizePath, sanitizeUserPath, relativeToRoot } from '../utils/path-utils.js';
+import { guard, resolveConfigSelection, resolveProjectRoot, toolText, } from './shared.js';
+const listTestsInput = z.object({
+    projectRoot: z.string().optional().describe('Project directory; defaults to the server working directory'),
+    config: z
+        .string()
+        .optional()
+        .describe('playwright.config path or 1-based index when the project has several configs'),
+    testDir: z.string().optional().describe('Restrict scanning to this directory (inside the project)'),
+    filter: z.string().optional().describe('Case-insensitive substring filter on "file › title"'),
+    limit: z.number().int().min(1).max(5_000).optional().describe('Max tests to return (default 500)'),
+});
+export const listTestsSchema = listTestsInput;
+function renderTests(result, root) {
+    const lines = [];
+    const sourceLabel = result.source === 'playwright-list' ? 'Playwright `--list`' : 'source scan (best effort)';
+    lines.push(`## 📋 ${result.total} test${result.total === 1 ? '' : 's'} found`, '');
+    lines.push(`**Source:** ${sourceLabel}`);
+    if (result.testDir)
+        lines.push(`**testDir:** \`${relativeToRoot(root, result.testDir)}\``);
+    lines.push('');
+    if (result.error) {
+        lines.push(`> ⚠️ Playwright could not list tests (\`${result.error.kind}\`): ${result.error.message}`, result.error.hint ? `> ${result.error.hint.replace(/\n/g, '\n> ')}` : '', '');
+    }
+    if (result.total === 0) {
+        lines.push('_No tests matched._', '', '- Check `testDir` / the `filter`, or', '- Confirm test files are named `*.spec.ts` / `*.test.ts`.');
+        return lines.join('\n');
+    }
+    const groups = new Map();
+    for (const test of result.tests) {
+        const group = groups.get(test.file) ?? [];
+        group.push(test);
+        groups.set(test.file, group);
+    }
+    for (const [file, tests] of groups) {
+        lines.push(`### \`${file}\``);
+        for (const test of tests) {
+            const projects = test.projects && test.projects.length > 0 ? ` \`${test.projects.join(', ')}\`` : '';
+            lines.push(`- ${test.line ? `:${test.line} ` : ''}${test.title}${projects}`);
+        }
+        lines.push('');
+    }
+    if (result.truncated) {
+        lines.push(`_Showing ${result.tests.length} of ${result.total} — raise \`limit\` or refine \`filter\`._`, '');
+    }
+    return lines.join('\n');
+}
+export const listTestsTool = {
+    name: 'list-tests',
+    description: 'List the Playwright tests available in the project (file, line, full title, projects), with optional filtering. Uses `playwright test --list` when Playwright works and falls back to a source scan when the install or config is broken, reporting why.',
+    inputSchema: listTestsSchema,
+    handler: async (args, ctx) => guard('list-tests', async () => {
+        const root = await resolveProjectRoot(args.projectRoot, ctx);
+        const detection = await detectProject(root);
+        const configPath = resolveConfigSelection(detection, args.config);
+        let testDir = detection.testDir;
+        if (args.testDir !== undefined) {
+            // Throws INVALID_PATH when the path escapes the project root.
+            testDir = sanitizeUserPath(args.testDir, root);
+        }
+        else if (testDir !== null && !isPathInside(testDir, root)) {
+            testDir = null;
+        }
+        const result = await listTests({
+            projectRoot: root,
+            configPath,
+            testDir,
+            filter: args.filter,
+            limit: args.limit,
+            signal: ctx.signal,
+        });
+        ctx.logger.info('list-tests finished', {
+            total: result.total,
+            source: result.source,
+            errorKind: result.error?.kind,
+        });
+        return toolText(renderTests(result, normalizePath(root)));
+    }),
+};
+//# sourceMappingURL=list-tests.js.map

package/dist/tools/list-tests.js.map

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

package/dist/tools/run-test.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tool 1 — run-test: execute Playwright tests and report structured
+ * results (stats, failures, diagnostics, hints).
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResponse } from '../types/index.js';
+declare const runTestInput: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    testFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    grep: z.ZodOptional<z.ZodString>;
+    browser: z.ZodOptional<z.ZodEnum<{
+        chromium: "chromium";
+        firefox: "firefox";
+        webkit: "webkit";
+    }>>;
+    headed: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    testTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    workers: z.ZodOptional<z.ZodNumber>;
+    retries: z.ZodOptional<z.ZodNumber>;
+    retryOnFailure: z.ZodOptional<z.ZodBoolean>;
+    lastFailed: z.ZodOptional<z.ZodBoolean>;
+    config: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type RunTestInput = z.infer<typeof runTestInput>;
+export declare const runTestSchema: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    testFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    grep: z.ZodOptional<z.ZodString>;
+    browser: z.ZodOptional<z.ZodEnum<{
+        chromium: "chromium";
+        firefox: "firefox";
+        webkit: "webkit";
+    }>>;
+    headed: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    testTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    workers: z.ZodOptional<z.ZodNumber>;
+    retries: z.ZodOptional<z.ZodNumber>;
+    retryOnFailure: z.ZodOptional<z.ZodBoolean>;
+    lastFailed: z.ZodOptional<z.ZodBoolean>;
+    config: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const runTestTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        projectRoot: z.ZodOptional<z.ZodString>;
+        testFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        grep: z.ZodOptional<z.ZodString>;
+        browser: z.ZodOptional<z.ZodEnum<{
+            chromium: "chromium";
+            firefox: "firefox";
+            webkit: "webkit";
+        }>>;
+        headed: z.ZodOptional<z.ZodBoolean>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        testTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        workers: z.ZodOptional<z.ZodNumber>;
+        retries: z.ZodOptional<z.ZodNumber>;
+        retryOnFailure: z.ZodOptional<z.ZodBoolean>;
+        lastFailed: z.ZodOptional<z.ZodBoolean>;
+        config: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    handler: (args: RunTestInput, ctx: ToolContext) => Promise<ToolResponse>;
+};
+export {};

package/dist/tools/run-test.js

@@ -0,0 +1,169 @@
+/**
+ * Tool 1 — run-test: execute Playwright tests and report structured
+ * results (stats, failures, diagnostics, hints).
+ */
+import { z } from 'zod';
+import { PlaywrightMcpError } from '../types/index.js';
+import { detectProject, missingPlaywrightMessage } from '../utils/project-detector.js';
+import { runTests } from '../utils/playwright-runner.js';
+import { normalizePath, relativeToRoot } from '../utils/path-utils.js';
+import { codeFence, clipLines, formatDuration, guard, renderFailure, resolveConfigSelection, resolveProjectRoot, sanitizeTestPathArgument, testPathExists, toolError, toolText, } from './shared.js';
+const runTestInput = z.object({
+    projectRoot: z
+        .string()
+        .optional()
+        .describe('Project directory; defaults to the server working directory'),
+    testFiles: z
+        .array(z.string())
+        .optional()
+        .describe('Test files/directories relative to the project root; "file:line" is supported. Omit to run the whole suite.'),
+    grep: z.string().optional().describe('Only run tests whose title matches this regex'),
+    browser: z
+        .enum(['chromium', 'firefox', 'webkit'])
+        .optional()
+        .describe('Playwright project name to run (matched against playwright.config projects)'),
+    headed: z.boolean().optional().describe('Run with a visible browser window'),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(1_000)
+        .max(3_600_000)
+        .optional()
+        .describe('Hard wall-clock limit for the whole run; the process tree is killed past it (default 120000)'),
+    testTimeoutMs: z
+        .number()
+        .int()
+        .min(1_000)
+        .max(3_600_000)
+        .optional()
+        .describe('Per-test timeout passed to Playwright'),
+    workers: z.number().int().min(1).max(64).optional(),
+    retries: z.number().int().min(0).max(10).optional(),
+    retryOnFailure: z
+        .boolean()
+        .optional()
+        .describe('Auto retry failing tests once before reporting failure (default true; ignored when retries is set)'),
+    lastFailed: z
+        .boolean()
+        .optional()
+        .describe('Only re-run tests that failed in the previous run (Playwright --last-failed) — the fast fix → re-run loop'),
+    config: z
+        .string()
+        .optional()
+        .describe('playwright.config path or 1-based index when the project has several configs'),
+    args: z
+        .array(z.string())
+        .optional()
+        .describe('Extra Playwright CLI arguments (shell metacharacters are rejected)'),
+});
+export const runTestSchema = runTestInput;
+function renderRunResult(result, root) {
+    const flakyCount = result.stats?.flaky ?? 0;
+    const status = result.ok
+        ? flakyCount > 0
+            ? `✅ PASSED (${flakyCount} flaky)`
+            : '✅ PASSED'
+        : result.timedOut
+            ? '⏱️ KILLED (timeout)'
+            : '❌ FAILED';
+    const lines = [`## Playwright run — ${status}`, ''];
+    lines.push(`**Command:** \`${result.command}\``);
+    const meta = [
+        `duration ${formatDuration(result.durationMs)}`,
+        `exit ${result.exitCode ?? '—'}`,
+    ];
+    if (result.configPath)
+        meta.push(`config \`${relativeToRoot(root, result.configPath)}\``);
+    if (result.autoRetry)
+        meta.push('auto retry ×1');
+    if (result.lastFailed)
+        meta.push('failed tests only (--last-failed)');
+    if (result.timedOut)
+        meta.push('killed at wrapper timeout');
+    if (result.partial)
+        meta.push('partial results');
+    lines.push(`**${meta.join(' · ')}**`, '');
+    if (result.stats) {
+        const s = result.stats;
+        lines.push('| passed | failed | flaky | skipped | duration |', '| ---: | ---: | ---: | ---: | ---: |', `| ${s.expected} | ${s.unexpected} | ${s.flaky} | ${s.skipped} | ${formatDuration(s.duration)} |`, '');
+    }
+    else {
+        lines.push('_No test statistics were reported._', '');
+    }
+    if (flakyCount > 0) {
+        lines.push(`> ⚠️ **${flakyCount} flaky test(s)** failed first but passed on the automatic retry. Re-run to confirm they are stable before trusting them.`, '');
+    }
+    if (result.failures.length > 0) {
+        const more = result.failuresTruncated ? ' (showing the first ones)' : '';
+        lines.push(`### ❌ ${result.failures.length} failing test(s)${more}`, '');
+        for (let i = 0; i < result.failures.length; i += 1) {
+            lines.push(renderFailure(result.failures[i], i, result.failures.length), '');
+        }
+        lines.push('> Next: call **get-failure** with `index` to get the full stack, code frame and a suggested fix for one failure.', '');
+    }
+    if (result.errorKind) {
+        lines.push(`### ⚠️ ${result.errorKind}`, '', result.errorMessage ?? '', '');
+        if (result.hint)
+            lines.push(result.hint, '');
+    }
+    else if (result.hint && result.hint.trim() !== '') {
+        lines.push(`> ${result.hint.replace(/\n/g, '\n> ')}`, '');
+    }
+    if (!result.ok && result.stderrTail.trim() !== '') {
+        lines.push('<details><summary>stderr tail</summary>', '', codeFence(clipLines(result.stderrTail, 40), 'text'), '', '</details>', '');
+    }
+    return lines.join('\n');
+}
+export const runTestTool = {
+    name: 'run-test',
+    description: 'Run Playwright end-to-end tests in the user\'s project and return structured results: pass/fail stats, per-failure messages with file:line, and diagnostics. Detects missing Playwright installs, multiple configs, dead dev servers, syntax errors, browser crashes, timeouts (kills the process tree and returns partial results) and full disks.',
+    inputSchema: runTestSchema,
+    handler: async (args, ctx) => guard('run-test', async () => {
+        const root = await resolveProjectRoot(args.projectRoot, ctx);
+        const detection = await detectProject(root);
+        if (!detection.hasPlaywright) {
+            const { message, hint } = missingPlaywrightMessage(detection);
+            return toolError('NO_PLAYWRIGHT', message, hint);
+        }
+        const configPath = resolveConfigSelection(detection, args.config);
+        const sanitized = [];
+        const missing = [];
+        for (const raw of args.testFiles ?? []) {
+            const absolute = sanitizeTestPathArgument(raw, root);
+            sanitized.push(absolute);
+            if (!(await testPathExists(absolute, root)))
+                missing.push(raw);
+        }
+        if (missing.length > 0) {
+            throw new PlaywrightMcpError(`Test path(s) not found: ${missing.join(', ')}`, 'INVALID_PATH', {
+                hint: `Paths resolve inside ${normalizePath(root)}. Call list-tests to see the available tests.`,
+            });
+        }
+        const options = {
+            projectRoot: root,
+            configPath,
+            testFiles: sanitized,
+            grep: args.grep,
+            browser: args.browser,
+            headed: args.headed,
+            timeoutMs: args.timeoutMs,
+            testTimeoutMs: args.testTimeoutMs,
+            workers: args.workers,
+            retries: args.retries,
+            retryOnFailure: args.retryOnFailure,
+            lastFailed: args.lastFailed,
+            extraArgs: args.args,
+            signal: ctx.signal,
+        };
+        const result = await runTests(options);
+        ctx.store.setLastRun({ projectRoot: root, result, at: Date.now() });
+        ctx.logger.info('run-test finished', {
+            ok: result.ok,
+            exitCode: result.exitCode,
+            durationMs: result.durationMs,
+            failures: result.failures.length,
+        });
+        return toolText(renderRunResult(result, root));
+    }),
+};
+//# sourceMappingURL=run-test.js.map

package/dist/tools/run-test.js.map

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