playwright-e2e-mcp 0.5.1 → 0.6.1

package/dist/tools/structured.d.ts

@@ -0,0 +1,334 @@
+/**
+ * Structured results: every tool returns, next to its Markdown, a JSON
+ * object (`structuredContent`) described by an output schema, so agents
+ * and apps can read verdicts, counts and file:line positions without
+ * parsing prose.
+ *
+ * All results share an envelope (`ok`, and `error` when the call failed);
+ * the tools agents chain most also fill in their own fields. Every field
+ * past `ok` is optional, so a tool may add detail without breaking older
+ * readers.
+ */
+import { z } from 'zod';
+import type { RunTestResult, TestFailure } from '../types/index.js';
+declare const failureSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodString;
+    project: z.ZodOptional<z.ZodString>;
+    kind: z.ZodString;
+    message: z.ZodString;
+    tracePath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const runSchema: z.ZodObject<{
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    flaky: z.ZodNumber;
+    skipped: z.ZodNumber;
+    durationMs: z.ZodNumber;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    partial: z.ZodBoolean;
+    failures: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodString;
+        project: z.ZodOptional<z.ZodString>;
+        kind: z.ZodString;
+        message: z.ZodString;
+        tracePath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    failuresTruncated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Output schema shared by every tool: the envelope plus each tool's fields. */
+export declare const toolOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    run: z.ZodOptional<z.ZodObject<{
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        flaky: z.ZodNumber;
+        skipped: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        partial: z.ZodBoolean;
+        failures: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodOptional<z.ZodNumber>;
+            title: z.ZodString;
+            project: z.ZodOptional<z.ZodString>;
+            kind: z.ZodString;
+            message: z.ZodString;
+            tracePath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        failuresTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    runId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    failure: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodString;
+        project: z.ZodOptional<z.ZodString>;
+        kind: z.ZodString;
+        message: z.ZodString;
+        tracePath: z.ZodOptional<z.ZodString>;
+        expected: z.ZodOptional<z.ZodString>;
+        actual: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    index: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodNumber>;
+    tests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodString;
+        project: z.ZodOptional<z.ZodString>;
+        verdict: z.ZodOptional<z.ZodEnum<{
+            "CONSISTENTLY FAILING": "CONSISTENTLY FAILING";
+            FLAKY: "FLAKY";
+            "NO TESTS RAN": "NO TESTS RAN";
+            "NOT REPRODUCING": "NOT REPRODUCING";
+        }>>;
+        passed: z.ZodOptional<z.ZodNumber>;
+        failed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    verdict: z.ZodOptional<z.ZodEnum<{
+        "CONSISTENTLY FAILING": "CONSISTENTLY FAILING";
+        FLAKY: "FLAKY";
+        "NO TESTS RAN": "NO TESTS RAN";
+        "NOT REPRODUCING": "NOT REPRODUCING";
+    }>>;
+    fix: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        before: z.ZodString;
+        after: z.ZodString;
+        kind: z.ZodEnum<{
+            expectation: "expectation";
+            locator: "locator";
+        }>;
+        confidence: z.ZodString;
+        why: z.ZodString;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    applied: z.ZodOptional<z.ZodBoolean>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+    violations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        impact: z.ZodString;
+        help: z.ZodString;
+        helpUrl: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            cls: "cls";
+            fcp: "fcp";
+            inp: "inp";
+            lcp: "lcp";
+            tbt: "tbt";
+            ttfb: "ttfb";
+        }>;
+        value: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodEnum<{
+            ms: "ms";
+            score: "score";
+        }>;
+        rating: z.ZodOptional<z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>>;
+        budget: z.ZodOptional<z.ZodNumber>;
+        overBudget: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    url: z.ZodOptional<z.ZodString>;
+    findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        rule: z.ZodString;
+        severity: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>;
+        message: z.ZodString;
+        fix: z.ZodOptional<z.ZodString>;
+        test: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    firstBad: z.ZodOptional<z.ZodObject<{
+        sha: z.ZodString;
+        subject: z.ZodString;
+        author: z.ZodString;
+        date: z.ZodString;
+        files: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        commit: z.ZodString;
+        verdict: z.ZodEnum<{
+            bad: "bad";
+            good: "good";
+            skip: "skip";
+        }>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    valid: z.ZodOptional<z.ZodBoolean>;
+    matches: z.ZodOptional<z.ZodNumber>;
+    locator: z.ZodOptional<z.ZodString>;
+    httpStatus: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type StructuredResult = z.infer<typeof toolOutputSchema>;
+export declare function failureData(failure: TestFailure): z.infer<typeof failureSchema>;
+export declare function runData(result: RunTestResult): z.infer<typeof runSchema>;
+/**
+ * The output schema for one tool: the envelope plus only that tool's fields,
+ * so tools/list does not repeat every tool's fields sixteen times. Tools
+ * with no fields of their own declare none (their results still carry the
+ * envelope): each schema is context a client pays for on every request.
+ */
+export declare function outputSchemaFor(toolName: string): z.ZodObject<{
+    ok: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    run: z.ZodOptional<z.ZodObject<{
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        flaky: z.ZodNumber;
+        skipped: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        partial: z.ZodBoolean;
+        failures: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodOptional<z.ZodNumber>;
+            title: z.ZodString;
+            project: z.ZodOptional<z.ZodString>;
+            kind: z.ZodString;
+            message: z.ZodString;
+            tracePath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        failuresTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    runId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    failure: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodString;
+        project: z.ZodOptional<z.ZodString>;
+        kind: z.ZodString;
+        message: z.ZodString;
+        tracePath: z.ZodOptional<z.ZodString>;
+        expected: z.ZodOptional<z.ZodString>;
+        actual: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    index: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodNumber>;
+    tests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodString;
+        project: z.ZodOptional<z.ZodString>;
+        verdict: z.ZodOptional<z.ZodEnum<{
+            "CONSISTENTLY FAILING": "CONSISTENTLY FAILING";
+            FLAKY: "FLAKY";
+            "NO TESTS RAN": "NO TESTS RAN";
+            "NOT REPRODUCING": "NOT REPRODUCING";
+        }>>;
+        passed: z.ZodOptional<z.ZodNumber>;
+        failed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    verdict: z.ZodOptional<z.ZodEnum<{
+        "CONSISTENTLY FAILING": "CONSISTENTLY FAILING";
+        FLAKY: "FLAKY";
+        "NO TESTS RAN": "NO TESTS RAN";
+        "NOT REPRODUCING": "NOT REPRODUCING";
+    }>>;
+    fix: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        before: z.ZodString;
+        after: z.ZodString;
+        kind: z.ZodEnum<{
+            expectation: "expectation";
+            locator: "locator";
+        }>;
+        confidence: z.ZodString;
+        why: z.ZodString;
+        alternatives: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    applied: z.ZodOptional<z.ZodBoolean>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+    violations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        impact: z.ZodString;
+        help: z.ZodString;
+        helpUrl: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            cls: "cls";
+            fcp: "fcp";
+            inp: "inp";
+            lcp: "lcp";
+            tbt: "tbt";
+            ttfb: "ttfb";
+        }>;
+        value: z.ZodOptional<z.ZodNumber>;
+        unit: z.ZodEnum<{
+            ms: "ms";
+            score: "score";
+        }>;
+        rating: z.ZodOptional<z.ZodEnum<{
+            good: "good";
+            "needs-improvement": "needs-improvement";
+            poor: "poor";
+        }>>;
+        budget: z.ZodOptional<z.ZodNumber>;
+        overBudget: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    url: z.ZodOptional<z.ZodString>;
+    findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        rule: z.ZodString;
+        severity: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            medium: "medium";
+        }>;
+        message: z.ZodString;
+        fix: z.ZodOptional<z.ZodString>;
+        test: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    firstBad: z.ZodOptional<z.ZodObject<{
+        sha: z.ZodString;
+        subject: z.ZodString;
+        author: z.ZodString;
+        date: z.ZodString;
+        files: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        commit: z.ZodString;
+        verdict: z.ZodEnum<{
+            bad: "bad";
+            good: "good";
+            skip: "skip";
+        }>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    valid: z.ZodOptional<z.ZodBoolean>;
+    matches: z.ZodOptional<z.ZodNumber>;
+    locator: z.ZodOptional<z.ZodString>;
+    httpStatus: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip> | undefined;
+export {};

package/dist/tools/structured.js

@@ -0,0 +1,176 @@
+/**
+ * Structured results: every tool returns, next to its Markdown, a JSON
+ * object (`structuredContent`) described by an output schema, so agents
+ * and apps can read verdicts, counts and file:line positions without
+ * parsing prose.
+ *
+ * All results share an envelope (`ok`, and `error` when the call failed);
+ * the tools agents chain most also fill in their own fields. Every field
+ * past `ok` is optional, so a tool may add detail without breaking older
+ * readers.
+ */
+import { z } from 'zod';
+const failureSchema = z.object({
+    file: z.string(),
+    line: z.number().int().optional(),
+    title: z.string(),
+    project: z.string().optional(),
+    kind: z.string(),
+    message: z.string(),
+    tracePath: z.string().optional(),
+});
+const runSchema = z.object({
+    passed: z.number().int(),
+    failed: z.number().int(),
+    flaky: z.number().int(),
+    skipped: z.number().int(),
+    durationMs: z.number(),
+    exitCode: z.number().int().nullable(),
+    partial: z.boolean(),
+    failures: z.array(failureSchema),
+    failuresTruncated: z.boolean().optional(),
+});
+const errorSchema = z.object({ kind: z.string(), message: z.string(), hint: z.string().optional() });
+const verdictSchema = z.enum(['NOT REPRODUCING', 'FLAKY', 'CONSISTENTLY FAILING', 'NO TESTS RAN']);
+const fixSchema = z.object({
+    file: z.string(),
+    line: z.number().int(),
+    before: z.string(),
+    after: z.string(),
+    kind: z.enum(['locator', 'expectation']),
+    confidence: z.string(),
+    why: z.string(),
+    alternatives: z.array(z.string()).optional(),
+});
+/** Output schema shared by every tool: the envelope plus each tool's fields. */
+export const toolOutputSchema = z.object({
+    ok: z.boolean().describe('false when the call failed (see error) or the tests it ran failed'),
+    error: errorSchema.optional(),
+    // run-test, get-run-status
+    run: runSchema.optional(),
+    runId: z.string().optional(),
+    status: z.string().optional(),
+    // get-failure
+    failure: failureSchema.extend({ expected: z.string().optional(), actual: z.string().optional() }).optional(),
+    index: z.number().int().optional(),
+    total: z.number().int().optional(),
+    // list-tests
+    tests: z
+        .array(z.object({
+        file: z.string(),
+        line: z.number().int().optional(),
+        title: z.string(),
+        project: z.string().optional(),
+        verdict: verdictSchema.optional(),
+        passed: z.number().int().optional(),
+        failed: z.number().int().optional(),
+    }))
+        .optional(),
+    truncated: z.boolean().optional(),
+    // diagnose-flaky
+    verdict: verdictSchema.optional(),
+    // suggest-fix
+    fix: fixSchema.optional(),
+    applied: z.boolean().optional(),
+    verified: z.boolean().optional(),
+    // audit-accessibility
+    violations: z
+        .array(z.object({ id: z.string(), impact: z.string(), help: z.string(), helpUrl: z.string(), count: z.number().int() }))
+        .optional(),
+    // audit-performance
+    metrics: z
+        .array(z.object({
+        id: z.enum(['lcp', 'cls', 'inp', 'tbt', 'fcp', 'ttfb']),
+        value: z.number().optional(),
+        unit: z.enum(['ms', 'score']),
+        rating: z.enum(['good', 'needs-improvement', 'poor']).optional(),
+        budget: z.number().optional(),
+        overBudget: z.boolean(),
+    }))
+        .optional(),
+    url: z.string().optional(),
+    // audit-tests
+    findings: z
+        .array(z.object({
+        file: z.string(),
+        line: z.number().int(),
+        rule: z.string(),
+        severity: z.enum(['high', 'medium', 'low']),
+        message: z.string(),
+        fix: z.string().optional().describe('the replacement line, when the fix is mechanical'),
+        test: z.string().optional(),
+    }))
+        .optional(),
+    // bisect-failure
+    firstBad: z
+        .object({ sha: z.string(), subject: z.string(), author: z.string(), date: z.string(), files: z.array(z.string()) })
+        .optional(),
+    steps: z
+        .array(z.object({ commit: z.string(), verdict: z.enum(['good', 'bad', 'skip']), note: z.string().optional() }))
+        .optional(),
+    // validate-selector, inspect-page
+    valid: z.boolean().optional().describe('validate-selector: the selector parsed and ran'),
+    matches: z.number().int().optional().describe('elements matched; actions need exactly 1'),
+    locator: z.string().optional().describe('a verified unique locator for the first match'),
+    httpStatus: z.number().int().optional().describe("the page's HTTP status"),
+});
+/** Keep long messages short: an agent that wants all of it calls get-failure. */
+function firstLines(text, lines = 6, chars = 600) {
+    const head = text.split('\n').slice(0, lines).join('\n');
+    return head.length > chars ? `${head.slice(0, chars)}…` : head;
+}
+export function failureData(failure) {
+    return {
+        file: failure.file,
+        ...(failure.line !== undefined ? { line: failure.line } : {}),
+        title: failure.title,
+        ...(failure.project ? { project: failure.project } : {}),
+        kind: failure.failureKind,
+        message: firstLines(failure.message ?? ''),
+        ...(failure.tracePath ? { tracePath: failure.tracePath } : {}),
+    };
+}
+export function runData(result) {
+    const stats = result.stats;
+    return {
+        passed: stats?.expected ?? 0,
+        failed: stats?.unexpected ?? result.failures.length,
+        flaky: stats?.flaky ?? 0,
+        skipped: stats?.skipped ?? 0,
+        durationMs: Math.round(result.durationMs),
+        exitCode: result.exitCode,
+        partial: result.partial,
+        failures: result.failures.map(failureData),
+        ...(result.failuresTruncated ? { failuresTruncated: true } : {}),
+    };
+}
+/** The fields each tool fills in, beyond the envelope (ok, error). */
+const TOOL_FIELDS = {
+    'run-test': ['run', 'runId', 'status'],
+    'get-run-status': ['run', 'runId', 'status'],
+    'get-failure': ['failure', 'index', 'total'],
+    'list-tests': ['tests', 'total', 'truncated'],
+    'diagnose-flaky': ['verdict', 'tests'],
+    'suggest-fix': ['fix', 'applied', 'verified'],
+    'audit-accessibility': ['url', 'violations'],
+    'audit-performance': ['url', 'metrics'],
+    'audit-tests': ['findings', 'total', 'truncated', 'applied', 'verified'],
+    'bisect-failure': ['status', 'firstBad', 'steps'],
+    'validate-selector': ['url', 'valid', 'matches', 'locator', 'httpStatus'],
+};
+/**
+ * The output schema for one tool: the envelope plus only that tool's fields,
+ * so tools/list does not repeat every tool's fields sixteen times. Tools
+ * with no fields of their own declare none (their results still carry the
+ * envelope): each schema is context a client pays for on every request.
+ */
+export function outputSchemaFor(toolName) {
+    const fields = TOOL_FIELDS[toolName];
+    if (!fields)
+        return undefined;
+    const mask = { ok: true, error: true };
+    for (const field of fields)
+        mask[field] = true;
+    return toolOutputSchema.pick(mask);
+}
+//# sourceMappingURL=structured.js.map

package/dist/tools/structured.js.map

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

package/dist/tools/suggest-fix.js

@@ -437,7 +437,7 @@ export const suggestFixTool = {
                 : picked;
             const listing = strict.matches.map((m, i) => `${i + 1}. \`${m.locator}\` · \`${clipLines(m.html, 1, 120)}\``);
             if (args.candidate !== undefined && !chosen) {
-                throw new PlaywrightMcpError(`candidate ${args.candidate} is out of range: Playwright listed ${strict.matches.length} match(es)`, 'INVALID_PATH', {
+                throw new PlaywrightMcpError(`candidate ${args.candidate} is out of range: Playwright listed ${strict.matches.length} match(es)`, 'INVALID_INPUT', {
                     hint: 'Call suggest-fix without candidate to see the list.',
                 });
             }
@@ -550,6 +550,16 @@ export const suggestFixTool = {
             return toolText(out.join('\n'));
         }
         const diff = unifiedDiff(failure.file, lines, proposal.lineNo, proposal.after);
+        const fix = {
+            file: failure.file,
+            line: proposal.lineNo,
+            before: proposal.before,
+            after: proposal.after,
+            kind: proposal.kind,
+            confidence: proposal.confidence,
+            why: proposal.why,
+            ...(proposal.alternatives?.length ? { alternatives: proposal.alternatives } : {}),
+        };
         out.push(`### Proposed ${proposal.kind === 'locator' ? 'locator fix' : 'expectation update'} — confidence **${proposal.confidence}**`, '', proposal.why, '', codeFence(diff, 'diff'), '');
         if (proposal.alternatives && proposal.alternatives.length > 0) {
             out.push(`Other candidates: ${proposal.alternatives.map((a) => `\`${a}\``).join(', ')}`, '');
@@ -559,11 +569,11 @@ export const suggestFixTool = {
             out.push(mayApply
                 ? '> Next: call **suggest-fix** again with `apply: true` to write this change and re-run the test to verify it.'
                 : '> This changes what the test asserts. Apply it by hand, or pass `apply: true, allowExpectationUpdate: true` if the new text is intended.');
-            return toolText(out.join('\n'));
+            return toolText(out.join('\n'), { fix, applied: false });
         }
         if (!mayApply) {
             out.push('> ⛔ Not applied: expectation updates need `allowExpectationUpdate: true`, because they can hide a real regression.');
-            return toolText(out.join('\n'));
+            return toolText(out.join('\n'), { fix, applied: false });
         }
         // Apply: refuse if the file changed since we read it.
         const current = await readFile(specPath, 'utf8');
@@ -578,7 +588,7 @@ export const suggestFixTool = {
         out.push(`**Applied** to \`${failure.file}:${proposal.lineNo}\`.`, '');
         if (args.verify === false) {
             out.push('> Not verified (verify: false). Re-run with **run-test** to check it.');
-            return toolText(out.join('\n'));
+            return toolText(out.join('\n'), { fix, applied: true });
         }
         const detection = await detectProject(root);
         const configPath = resolveConfigSelection(detection, args.config);
@@ -611,7 +621,7 @@ export const suggestFixTool = {
             const first = result.failures[0];
             out.push(`### ❌ Still failing — the change was reverted`, '', first ? codeFence(clipLines(first.message, 8, 1_200), 'text') : (result.errorMessage ?? 'The run failed without a test failure.'), '', '> The original file is restored. Call **get-failure** for the new failure, or try another candidate by hand.');
         }
-        return toolText(out.join('\n'));
+        return toolText(out.join('\n'), { ok: result.ok, fix, applied: result.ok, verified: result.ok });
     }),
 };
 //# sourceMappingURL=suggest-fix.js.map