playwright-e2e-mcp 0.9.0 → 0.11.0

package/dist/utils/client-metadata.js.map

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

package/dist/utils/compact-schema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Smaller advertised input schemas.
+ *
+ * Tool definitions are sent to the model with every request, so each
+ * keyword in them costs tokens on every turn. This drops the keywords an
+ * agent does not need to write a correct call (length and item limits,
+ * `propertyNames`, `$schema`, an empty `additionalProperties`). The server
+ * still validates every call against the full schema, so an argument
+ * outside a limit is refused with a message that names the limit.
+ *
+ * Numeric `minimum` / `maximum` stay: they steer timeouts and sizes, where
+ * a guessed value would otherwise cost a failed call.
+ */
+import type { StandardSchemaWithJSON } from '@modelcontextprotocol/server';
+export declare function compactJsonSchema(node: unknown, inMap?: boolean): unknown;
+/**
+ * Wrap a schema so the JSON Schema listed in tools/list is compacted while
+ * validation (`~standard.validate`) still runs the original schema.
+ */
+export declare function withCompactJsonSchema(schema: StandardSchemaWithJSON): StandardSchemaWithJSON;

package/dist/utils/compact-schema.js

@@ -0,0 +1,55 @@
+/**
+ * Smaller advertised input schemas.
+ *
+ * Tool definitions are sent to the model with every request, so each
+ * keyword in them costs tokens on every turn. This drops the keywords an
+ * agent does not need to write a correct call (length and item limits,
+ * `propertyNames`, `$schema`, an empty `additionalProperties`). The server
+ * still validates every call against the full schema, so an argument
+ * outside a limit is refused with a message that names the limit.
+ *
+ * Numeric `minimum` / `maximum` stay: they steer timeouts and sizes, where
+ * a guessed value would otherwise cost a failed call.
+ */
+const DROPPED = new Set(['$schema', 'propertyNames', 'minLength', 'maxLength', 'minItems', 'maxItems']);
+/** Keys whose value is a map of names to schemas, where names are not keywords. */
+const SCHEMA_MAPS = new Set(['properties', 'patternProperties', '$defs', 'definitions']);
+export function compactJsonSchema(node, inMap = false) {
+    if (Array.isArray(node))
+        return node.map((item) => compactJsonSchema(item));
+    if (!node || typeof node !== 'object')
+        return node;
+    const out = {};
+    for (const [key, value] of Object.entries(node)) {
+        if (!inMap) {
+            if (DROPPED.has(key))
+                continue;
+            // `additionalProperties: {}` allows anything, the same as leaving it out.
+            if (key === 'additionalProperties' && value && typeof value === 'object' && Object.keys(value).length === 0)
+                continue;
+        }
+        out[key] = compactJsonSchema(value, !inMap && SCHEMA_MAPS.has(key));
+    }
+    return out;
+}
+/**
+ * Wrap a schema so the JSON Schema listed in tools/list is compacted while
+ * validation (`~standard.validate`) still runs the original schema.
+ */
+export function withCompactJsonSchema(schema) {
+    const std = schema['~standard'];
+    if (!std.jsonSchema)
+        return schema;
+    const jsonSchema = std.jsonSchema;
+    return {
+        '~standard': {
+            ...std,
+            validate: std.validate.bind(std),
+            jsonSchema: {
+                input: (options) => compactJsonSchema(jsonSchema.input(options)),
+                output: (options) => compactJsonSchema(jsonSchema.output(options)),
+            },
+        },
+    };
+}
+//# sourceMappingURL=compact-schema.js.map

package/dist/utils/compact-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-schema.js","sourceRoot":"","sources":["../../src/utils/compact-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAExG,mFAAmF;AACnF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,mBAAmB,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AAEzF,MAAM,UAAU,iBAAiB,CAAC,IAAa,EAAE,KAAK,GAAG,KAAK;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC/B,0EAA0E;YAC1E,IAAI,GAAG,KAAK,sBAAsB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;QACxH,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA8B;IAClE,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAwC,CAAC;IACvE,IAAI,CAAC,GAAG,CAAC,UAAU;QAAE,OAAO,MAAM,CAAC;IACnC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,OAAO;QACL,WAAW,EAAE;YACX,GAAG,GAAG;YACN,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;YAChC,UAAU,EAAE;gBACV,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAA4B;gBAC3F,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAA4B;aAC9F;SACF;KACwB,CAAC;AAC9B,CAAC"}

package/dist/utils/confirm.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Ask the person before a tool changes files in their project.
+ *
+ * Tools that write test code or project state (suggest-fix `apply`,
+ * generate-e2e-test, quarantine add/remove, compare-visual-state `baseline`)
+ * call `ctx.confirmWrite()` right before the write, with the exact change
+ * they are about to make. When the client can show a form (MCP elicitation),
+ * the server answers the call with an `input_required` result (the
+ * 2026-07-28 multi-round-trip pattern; the SDK turns it into a classic
+ * elicitation request for 2025 clients). The client shows the change, the
+ * person says yes or no, and the client retries the call with the answer.
+ *
+ * The approval is bound to the change: the question's key is a hash of the
+ * tool, title and detail, so if the retried call would write something
+ * different it asks again instead of reusing an old "yes".
+ *
+ * PW_MCP_CONFIRM_WRITES:
+ *   auto   (default) ask when the client supports elicitation; otherwise
+ *          write as before and say no one was asked
+ *   always ask, and refuse to write when the client cannot ask
+ *   off    never ask
+ */
+import type { InputRequiredResult } from '@modelcontextprotocol/server';
+export type ConfirmMode = 'auto' | 'always' | 'off';
+/** What the tool is about to do, shown to the person. */
+export interface WriteConfirmation {
+    /** One line: "Apply this fix to tests/cart.spec.ts:42?" */
+    title: string;
+    /** The change itself (a diff, the file to be written, the entry to add). */
+    detail: string;
+}
+/**
+ * - `approved`: the person said yes.
+ * - `declined`: the person said no (or cancelled): do not write.
+ * - `not-asked`: confirmation is off, or the client cannot ask: write as before.
+ */
+export type ConfirmOutcome = 'approved' | 'declined' | 'not-asked';
+export type ConfirmWrite = (request: WriteConfirmation) => Promise<ConfirmOutcome>;
+/**
+ * Thrown by `confirmWrite` when the person has to be asked. It carries the
+ * `input_required` result; the server returns it instead of a tool result.
+ * Tools must let it through (guard() rethrows it).
+ */
+export declare class ConfirmationPending extends Error {
+    readonly result: InputRequiredResult;
+    constructor(result: InputRequiredResult);
+}
+export declare function confirmMode(value?: string | undefined): ConfirmMode;
+/** Longest change shown in the question; clients show it as plain text. */
+export declare const MAX_DETAIL_CHARS = 4000;
+/** Whether declared client capabilities include form-mode elicitation. */
+export declare function supportsFormElicitation(capabilities: unknown): boolean;
+/** The input key for one exact change: a new change gets a new question. */
+export declare function confirmationKey(tool: string, request: WriteConfirmation): string;
+export interface ConfirmerOptions {
+    tool: string;
+    /** Retried-call answers (`ctx.mcpReq.inputResponses`). */
+    inputResponses?: Record<string, unknown>;
+    /** Per-request envelope (2026-07-28) or undefined on 2025 connections. */
+    envelope?: Record<string, unknown>;
+    /** Capabilities from the 2025 initialize handshake. */
+    sessionCapabilities?: unknown;
+    mode?: ConfirmMode;
+}
+/** Build the `confirmWrite` a tool call gets in its context. */
+export declare function createConfirmWrite(options: ConfirmerOptions): ConfirmWrite;
+/** The line tools add to a result when the person was or was not asked. */
+export declare function confirmationNote(outcome: ConfirmOutcome): string | undefined;

package/dist/utils/confirm.js

@@ -0,0 +1,120 @@
+/**
+ * Ask the person before a tool changes files in their project.
+ *
+ * Tools that write test code or project state (suggest-fix `apply`,
+ * generate-e2e-test, quarantine add/remove, compare-visual-state `baseline`)
+ * call `ctx.confirmWrite()` right before the write, with the exact change
+ * they are about to make. When the client can show a form (MCP elicitation),
+ * the server answers the call with an `input_required` result (the
+ * 2026-07-28 multi-round-trip pattern; the SDK turns it into a classic
+ * elicitation request for 2025 clients). The client shows the change, the
+ * person says yes or no, and the client retries the call with the answer.
+ *
+ * The approval is bound to the change: the question's key is a hash of the
+ * tool, title and detail, so if the retried call would write something
+ * different it asks again instead of reusing an old "yes".
+ *
+ * PW_MCP_CONFIRM_WRITES:
+ *   auto   (default) ask when the client supports elicitation; otherwise
+ *          write as before and say no one was asked
+ *   always ask, and refuse to write when the client cannot ask
+ *   off    never ask
+ */
+import { createHash } from 'node:crypto';
+import { CLIENT_CAPABILITIES_META_KEY, inputRequired, inputResponse } from '@modelcontextprotocol/server';
+import { PlaywrightMcpError } from '../types/index.js';
+/**
+ * Thrown by `confirmWrite` when the person has to be asked. It carries the
+ * `input_required` result; the server returns it instead of a tool result.
+ * Tools must let it through (guard() rethrows it).
+ */
+export class ConfirmationPending extends Error {
+    result;
+    constructor(result) {
+        super('waiting for the person to confirm a file change');
+        this.name = 'ConfirmationPending';
+        this.result = result;
+    }
+}
+export function confirmMode(value = process.env.PW_MCP_CONFIRM_WRITES) {
+    const normalized = (value ?? '').trim().toLowerCase();
+    if (normalized === 'off' || normalized === '0' || normalized === 'false')
+        return 'off';
+    if (normalized === 'always' || normalized === 'require' || normalized === 'required')
+        return 'always';
+    return 'auto';
+}
+/** Longest change shown in the question; clients show it as plain text. */
+export const MAX_DETAIL_CHARS = 4_000;
+/** Whether declared client capabilities include form-mode elicitation. */
+export function supportsFormElicitation(capabilities) {
+    if (!capabilities || typeof capabilities !== 'object')
+        return false;
+    const elicitation = capabilities.elicitation;
+    if (!elicitation || typeof elicitation !== 'object')
+        return false;
+    const modes = elicitation;
+    // `{}` (2025-06-18) means form mode; a client that lists modes must list form.
+    if ('form' in modes || 'url' in modes)
+        return 'form' in modes;
+    return true;
+}
+/** The input key for one exact change: a new change gets a new question. */
+export function confirmationKey(tool, request) {
+    const digest = createHash('sha256').update(`${tool}\n${request.title}\n${request.detail}`).digest('hex');
+    return `confirm_write_${digest.slice(0, 20)}`;
+}
+function questionText(tool, request) {
+    const detail = request.detail.length > MAX_DETAIL_CHARS
+        ? `${request.detail.slice(0, MAX_DETAIL_CHARS)}\n… (${request.detail.length - MAX_DETAIL_CHARS} more characters)`
+        : request.detail;
+    return `${request.title}\n\n${detail}\n\n(${tool} asks before changing files in your project. Set PW_MCP_CONFIRM_WRITES=off to stop asking.)`;
+}
+/** Build the `confirmWrite` a tool call gets in its context. */
+export function createConfirmWrite(options) {
+    return async (request) => {
+        const mode = options.mode ?? confirmMode();
+        if (mode === 'off')
+            return 'not-asked';
+        const key = confirmationKey(options.tool, request);
+        const answer = inputResponse(options.inputResponses, key);
+        if (answer.kind === 'elicit') {
+            return answer.action === 'accept' && answer.content?.confirm === true ? 'approved' : 'declined';
+        }
+        const capabilities = options.envelope?.[CLIENT_CAPABILITIES_META_KEY] ?? options.sessionCapabilities;
+        if (!supportsFormElicitation(capabilities)) {
+            if (mode === 'always') {
+                throw new PlaywrightMcpError(`Not written: ${request.title.replace(/\?$/, '')} needs your confirmation, and this client cannot ask`, 'INVALID_INPUT', {
+                    hint: 'PW_MCP_CONFIRM_WRITES=always refuses file changes in clients without elicitation. Use a client that supports it, or set PW_MCP_CONFIRM_WRITES=auto.',
+                });
+            }
+            return 'not-asked';
+        }
+        throw new ConfirmationPending(inputRequired({
+            inputRequests: {
+                [key]: inputRequired.elicit({
+                    message: questionText(options.tool, request),
+                    requestedSchema: {
+                        type: 'object',
+                        properties: {
+                            confirm: {
+                                type: 'boolean',
+                                title: 'Make this change',
+                                description: 'Yes writes the change. No leaves your files as they are.',
+                                default: false,
+                            },
+                        },
+                        required: ['confirm'],
+                    },
+                }),
+            },
+        }));
+    };
+}
+/** The line tools add to a result when the person was or was not asked. */
+export function confirmationNote(outcome) {
+    if (outcome === 'approved')
+        return '> ✅ You confirmed this change.';
+    return undefined;
+}
+//# sourceMappingURL=confirm.js.map

package/dist/utils/confirm.js.map

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

package/dist/utils/locator-map.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Compact rendering of inspect-page's locator map.
+ *
+ * Two things keep it short without losing what an agent acts on:
+ *
+ * - Alternatives are listed only when they add a different, stable way to
+ *   reach the element (a test id or role next to a text locator, say).
+ *   getByText and raw CSS alternatives are dropped: the best locator is
+ *   already verified unique.
+ * - Repeated blocks (product cards, table rows, list items) are shown once
+ *   and the rest are summarised by name, since their locators differ only
+ *   in the item's name or number.
+ */
+import type { ElementInfo } from '../types/index.js';
+export declare function renderLocatorLine(element: ElementInfo, position: number): string;
+/**
+ * The shape of an element's locator with every name and number blanked,
+ * so the "Add to cart" button of card 3 and card 7 compare equal.
+ */
+export declare function locatorShape(element: ElementInfo): string;
+/**
+ * Render the locator map, numbered by position in `elements`, with
+ * repeated blocks collapsed after their first occurrence.
+ */
+export declare function renderLocatorMap(elements: ElementInfo[]): string[];

package/dist/utils/locator-map.js

@@ -0,0 +1,113 @@
+/**
+ * Compact rendering of inspect-page's locator map.
+ *
+ * Two things keep it short without losing what an agent acts on:
+ *
+ * - Alternatives are listed only when they add a different, stable way to
+ *   reach the element (a test id or role next to a text locator, say).
+ *   getByText and raw CSS alternatives are dropped: the best locator is
+ *   already verified unique.
+ * - Repeated blocks (product cards, table rows, list items) are shown once
+ *   and the rest are summarised by name, since their locators differ only
+ *   in the item's name or number.
+ */
+import { formatLocator } from './locator-expr.js';
+/** Alternatives worth a reader's tokens: they address the element another stable way. */
+const USEFUL_ALT = /^(getByTestId|getByRole|getByLabel|getByPlaceholder)\(/;
+function clip(text, max) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+function method(locator) {
+    return locator.slice(0, locator.indexOf('(') + 1);
+}
+function best(element) {
+    const chain = element.locators?.[0];
+    return chain ? formatLocator(chain) : element.selector;
+}
+export function renderLocatorLine(element, position) {
+    const first = best(element);
+    const alts = (element.locators ?? [])
+        .slice(1)
+        .map((chain) => formatLocator(chain))
+        .filter((alt) => USEFUL_ALT.test(alt) && method(alt) !== method(first))
+        .slice(0, 1)
+        .map((alt) => `\`${alt}\``);
+    const label = element.role ? `${element.role}${element.name ? ` "${clip(element.name, 60)}"` : ''}` : element.tag;
+    return `${position}. \`${first}\` — ${label}${alts.length > 0 ? ` · also ${alts.join(', ')}` : ''}`;
+}
+/**
+ * The shape of an element's locator with every name and number blanked,
+ * so the "Add to cart" button of card 3 and card 7 compare equal.
+ */
+export function locatorShape(element) {
+    const shape = best(element)
+        .replace(/'(?:[^'\\]|\\.)*'/g, "'…'")
+        .replace(/"(?:[^"\\]|\\.)*"/g, '"…"')
+        .replace(/\d+/g, '#');
+    return `${element.role ?? element.tag}|${shape}`;
+}
+/** The longest run of a repeated block starting at `start` (block size 1–8, at least 3 repeats, 5 hidden lines). */
+function findRun(shapes, start) {
+    let found;
+    for (let size = 1; size <= 8 && start + size * 3 <= shapes.length; size += 1) {
+        let repeats = 1;
+        while (start + (repeats + 1) * size <= shapes.length) {
+            let same = true;
+            for (let k = 0; k < size; k += 1) {
+                if (shapes[start + repeats * size + k] !== shapes[start + k]) {
+                    same = false;
+                    break;
+                }
+            }
+            if (!same)
+                break;
+            repeats += 1;
+        }
+        // Collapse only when it hides at least five lines; shorter runs read better in full.
+        if (repeats >= 3 && (repeats - 1) * size >= 5 && (!found || repeats * size > found.repeats * found.size))
+            found = { start, size, repeats };
+    }
+    return found;
+}
+/** A block's display name: its first named element (a heading or image name, usually). */
+function blockName(block) {
+    const named = block.find((el) => el.name && el.name.trim()) ?? block.find((el) => el.text && el.text.trim());
+    const text = named?.name ?? named?.text;
+    return text ? clip(text, 40) : undefined;
+}
+/**
+ * Render the locator map, numbered by position in `elements`, with
+ * repeated blocks collapsed after their first occurrence.
+ */
+export function renderLocatorMap(elements) {
+    const shapes = elements.map(locatorShape);
+    const lines = [];
+    let i = 0;
+    while (i < elements.length) {
+        const run = findRun(shapes, i);
+        if (!run) {
+            lines.push(renderLocatorLine(elements[i], i + 1));
+            i += 1;
+            continue;
+        }
+        for (let k = 0; k < run.size; k += 1)
+            lines.push(renderLocatorLine(elements[i + k], i + k + 1));
+        const restStart = i + run.size;
+        const restEnd = i + run.size * run.repeats;
+        const names = [];
+        for (let b = restStart; b < restEnd; b += run.size) {
+            const name = blockName(elements.slice(b, b + run.size));
+            if (name)
+                names.push(`"${name}"`);
+        }
+        const shown = names.slice(0, 30);
+        const more = names.length > shown.length ? `, …${names.length - shown.length} more` : '';
+        lines.push(`${restStart + 1}–${restEnd}. ↳ ${run.repeats - 1} more blocks like ${run.size === 1 ? i + 1 : `${i + 1}–${restStart}`}: same locators with the item's own name or number` +
+            (shown.length > 0 ? `: ${shown.join(', ')}${more}` : '') +
+            '. Pass `selector` to list one in full.');
+        i = restEnd;
+    }
+    return lines;
+}
+//# sourceMappingURL=locator-map.js.map

package/dist/utils/locator-map.js.map

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

package/examples/github-actions/playwright-e2e.yml

@@ -38,7 +38,7 @@ jobs:
 
       - name: Run Playwright E2E diagnosis action
         id: e2e
-        uses: xsignon-secure/E2E@v0.9.0
+        uses: xsignon-secure/E2E@v0.11.0
         with:
           # Directory containing playwright.config.* (default is workspace root)
           project-root: .

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright-e2e-mcp",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "MCP server and agent skill that run, diagnose and fix failing Playwright tests (TypeScript and pytest): CI report diagnosis, trace analysis, verified locator fixes, flaky verdicts, breaking commits, heal guard, accessibility and Web Vitals audits.",
   "author": "xsignon-secure (https://github.com/xsignon-secure)",
   "mcpName": "io.github.xsignon-secure/E2E",

package/skill/playwright-e2e-mcp/SKILL.md

@@ -13,7 +13,7 @@ and concrete next steps. It can also propose and apply a verified fix for a brok
 locator, inspect pages behind a login, run long suites in the background and keep
 a local history of every run.
 
-This skill is written for playwright-e2e-mcp 0.9.0 and works with 0.2.0 or
+This skill is written for playwright-e2e-mcp 0.11.0 and works with 0.2.0 or
 newer. If `suggest-fix`, `get-run-status` or `analyze-history` is missing, the
 server is older than 0.2.0: use the steps that do not need those tools and tell
 the user to update it. `diagnose-flaky`'s per-test table and `isolate` option
@@ -27,7 +27,12 @@ history views and strict-mode fixes in `suggest-fix` arrived in 0.5.0;
 pytest-playwright projects (`run-test`, `get-failure`, `list-tests`) arrived in
 0.8.0; the free self-hosted history server (`PW_MCP_HISTORY_URL` /
 `PW_MCP_HISTORY_TOKEN`, replacing the old Pro settings, which still work) arrived
-in 0.9.0. If `doctor` says a newer version is out, pass its upgrade command on to
+in 0.9.0; asking before changing files, the interactive test report (MCP Apps)
+and sign-in with Client ID Metadata Documents arrived in 0.10.0; the compact
+`inspect-page` locator map as the default view and `load-tools` (`--tools=auto`)
+arrived in 0.11.0. If a tool that
+writes returns `declined: true`, the user said no: do not retry the write, show
+them the proposed change instead. If `doctor` says a newer version is out, pass its upgrade command on to
 the user.
 
 ## Before you start
@@ -46,8 +51,10 @@ the user.
    `references/writing-tests.md`. Do not fall back to shelling out to `npx playwright test` unless
    the user asks. If only some are missing, the server may run a smaller tool
    profile (`--tools=core` exposes `run-test`, `get-run-status`, `get-failure`,
-   `suggest-fix`, `diagnose-flaky`, `check-test-change` and `list-tests`); work with what is there and
-   mention the profile when a task needs a page tool.
+   `suggest-fix`, `diagnose-flaky`, `check-test-change` and `list-tests`). If a `load-tools`
+   tool is listed, call it with the profile you need (`inspect`, `triage`, `author`) or the tool
+   names, then use them; otherwise work with what is there and mention the profile when a task
+   needs a page tool.
 3. Every tool except `get-run-status` takes an optional `projectRoot`. Leave it
    out unless the user works in a sub-project; the server defaults to `PW_MCP_PROJECT_ROOT` or its working
    directory, and rejects any root outside its allowed roots.
@@ -283,7 +290,7 @@ with the commit it tested. `analyze-history` views:
   `selector` for one region) returns the accessibility snapshot and a
   `toMatchAriaSnapshot` assertion to paste into a spec.
 - **Set up CI:** when the user wants the same diagnosis on every pull request,
-  point them to the GitHub Action (`uses: xsignon-secure/E2E@v0.9.0`) or the
+  point them to the GitHub Action (`uses: xsignon-secure/E2E@v0.11.0`) or the
   `npx -y playwright-e2e-mcp ci` command in `references/setup.md`. It writes the
   run, flaky verdicts and fix diffs to the job summary and one PR comment.
 - **Accessibility:** `audit-accessibility` with `url` runs axe-core against

package/skill/playwright-e2e-mcp/references/setup.md

@@ -77,7 +77,7 @@ Set these in the server's `env` block. None of them are secrets except
 | Variable | Default | Purpose |
 | --- | --- | --- |
 | `PW_MCP_PROJECT_ROOT` | server working directory | Default project root for every tool |
-| `PW_MCP_TOOLS` | all | Tools to expose: names and/or profiles `core`, `triage`, `inspect`, `author` (same as the `--tools=` flag). `core` halves the tool-definition context |
+| `PW_MCP_TOOLS` | all | Tools to expose: names and/or profiles `core`, `triage`, `inspect`, `author` (same as the `--tools=` flag). `core` cuts the tool-definition context by about four fifths; `auto` starts with `core` plus `load-tools`, which loads the other tools when you need them |
 | `PW_MCP_ALLOWED_ROOTS` | none | Extra directories allowed as `projectRoot` (`:`-separated, `;` on Windows) |
 | `PW_MCP_BLOCK_PRIVATE_URLS` | off for stdio | `1` makes the URL tools refuse loopback, private-network and cloud-metadata addresses |
 | `PW_MCP_STORAGE_STATE` | none | Default Playwright storageState JSON (inside the project) for the page tools, so signed-in pages open logged in |
@@ -119,7 +119,7 @@ Exit code 0 means passed, 1 tests failed, 2 the run itself failed. On GitHub
 Actions it also writes to the job summary. As an Action:
 
 ```yaml
-- uses: xsignon-secure/E2E@v0.9.0
+- uses: xsignon-secure/E2E@v0.11.0
   with:
     flaky-runs: 3
     suggest: 2

package/skill/playwright-e2e-mcp/references/tools.md

@@ -65,7 +65,7 @@ becomes the last run for `get-failure`, `suggest-fix` and `diagnose-flaky`.
 | `waitUntil` | `load` \| `domcontentloaded` \| `networkidle` | Navigation wait |
 | `includeHtml` | boolean | Include rendered HTML (capped by `maxHtmlChars`, default 20000) |
 | `timeoutMs` | number | Default 45000 |
-| `view` | `elements` \| `locators` \| `aria` | `locators`: compact map of interactive elements with verified locators; `aria` (0.5.0+): accessibility snapshot of the page or of `selector`, with a `toMatchAriaSnapshot` assertion |
+| `view` | `elements` \| `locators` \| `aria` | `locators` (default): compact map of interactive elements with verified locators, repeated blocks shown once; `elements`: full DOM inventory; `aria` (0.5.0+): accessibility snapshot of the page or of `selector`, with a `toMatchAriaSnapshot` assertion |
 | `storageState` | string | Playwright storageState JSON inside the project (signed-in session); defaults to `PW_MCP_STORAGE_STATE` |
 | `headers` | object | Extra HTTP headers |
 | `actions` | array | Up to 20 steps after load: `{ type: click\|dblclick\|fill\|press\|check\|uncheck\|select\|hover\|wait\|goto, locator?, value?, url?, ms? }`. Locators may start with `frameLocator('#frame')` or use `.contentFrame()` for iframes (0.6.1+). `{ type: 'switchTab', value?: 'last'\|'first'\|'2'\|text in URL or title }` moves to a popup or new tab (0.8.0+) |