@testrelic/mcp 2.1.0

package/dist/tools/coverage/index.js

@@ -0,0 +1,247 @@
+import { z } from "zod";
+/**
+ * Coverage capability — the core intelligence behind the ≥95% User-Coverage
+ * / ≥95% Test-Coverage goal. Every tool is cache-first and uses the 3-state
+ * diff reader for repeat calls on the same project.
+ */
+export const coverageTools = [
+    {
+        name: "tr_user_journeys",
+        capability: "coverage",
+        title: "Top N Amplitude user journeys",
+        description: "Returns the top N user journeys for a project ordered by distinct users in the last 30 days. Uses L1+L2 cache with a 1h TTL.",
+        inputSchema: {
+            project_id: z.string(),
+            limit: z.number().int().min(1).max(200).optional().default(20),
+        },
+        outputSchema: {
+            journeys: z.array(z.object({
+                id: z.string(),
+                name: z.string(),
+                events: z.array(z.string()),
+                user_count: z.number(),
+                session_count: z.number(),
+            })),
+            total_users_tracked: z.number(),
+        },
+        handler: async (input, ctx) => {
+            const project_id = input.project_id;
+            const limit = input.limit ?? 20;
+            const journeys = await ctx.context.journeys.top(project_id, limit);
+            const total = journeys.reduce((s, j) => s + (j.user_count ?? 0), 0);
+            if (!journeys.length) {
+                return { text: `No journeys available for ${project_id}.`, structured: { journeys: [], total_users_tracked: 0 } };
+            }
+            const lines = [`## Top ${journeys.length} user journeys — ${project_id}`, "", `**Total users tracked:** ${total.toLocaleString()}`, ""];
+            for (const j of journeys) {
+                lines.push(`- **\`${j.id}\`** — ${j.name}`);
+                lines.push(`  ${j.user_count.toLocaleString()} users · ${j.session_count.toLocaleString()} sessions · ${j.events.length} steps`);
+                lines.push(`  ${j.events.join(" → ")}`);
+            }
+            return {
+                text: lines.join("\n"),
+                structured: {
+                    journeys: journeys.map((j) => ({
+                        id: j.id,
+                        name: j.name,
+                        events: j.events,
+                        user_count: j.user_count,
+                        session_count: j.session_count,
+                    })),
+                    total_users_tracked: total,
+                },
+            };
+        },
+    },
+    {
+        name: "tr_test_map",
+        capability: "coverage",
+        title: "Test-to-journey/code-node map",
+        description: "Returns the test coverage map for a project — every test_id with the journeys and code nodes it exercises. Large responses are written to the blob store and summarised.",
+        inputSchema: {
+            project_id: z.string(),
+            test_id: z.string().optional(),
+        },
+        handler: async (input, ctx) => {
+            const project_id = input.project_id;
+            const test_id = input.test_id;
+            const all = await ctx.context.coverage.load(project_id);
+            const filtered = test_id ? all.filter((t) => t.test_id === test_id) : all;
+            if (!filtered.length) {
+                return { text: `No coverage entries found for ${project_id}${test_id ? ` / ${test_id}` : ""}.`, structured: { entries: [] } };
+            }
+            const lines = [`## Test map — ${project_id}${test_id ? ` / ${test_id}` : ""}`, "", `**Entries:** ${filtered.length}`, ""];
+            for (const e of filtered.slice(0, 50)) {
+                lines.push(`- **\`${e.test_id}\`** — ${e.test_name} (${e.suite})`);
+                lines.push(`  journeys: ${e.journey_ids.join(", ") || "(none)"}`);
+                lines.push(`  code_nodes: ${e.code_node_ids.slice(0, 5).join(", ")}${e.code_node_ids.length > 5 ? ` (+${e.code_node_ids.length - 5} more)` : ""}`);
+            }
+            if (filtered.length > 50)
+                lines.push(`_…and ${filtered.length - 50} more entries_`);
+            const cache_key = ctx.cache.key("tr_test_map", { project_id, test_id });
+            const sha = ctx.cache.blob.write(JSON.stringify(filtered));
+            ctx.cache.set(cache_key, { blob: sha }, { ttlSeconds: 900 });
+            return { text: lines.join("\n"), structured: { entries: filtered, cache_key }, cacheKey: cache_key };
+        },
+    },
+    {
+        name: "tr_coverage_gaps",
+        capability: "coverage",
+        title: "Ranked coverage gaps",
+        description: "Returns the top-N user journeys with NO test covering them, ordered by user count. Each gap includes the pp coverage gain we'd get by covering it and any partial overlaps with existing tests.",
+        inputSchema: {
+            project_id: z.string(),
+            limit: z.number().int().min(1).max(50).optional().default(10),
+        },
+        outputSchema: {
+            gaps: z.array(z.object({
+                journey_id: z.string(),
+                journey_name: z.string(),
+                user_count: z.number(),
+                pp_coverage_gain: z.number(),
+                events: z.array(z.string()),
+            })),
+        },
+        handler: async (input, ctx) => {
+            const project_id = input.project_id;
+            const limit = input.limit ?? 10;
+            const gaps = await ctx.context.correlator.rankedGaps(project_id, limit);
+            if (!gaps.length) {
+                return { text: `🎉 No coverage gaps in top journeys for ${project_id}.`, structured: { gaps: [] } };
+            }
+            const lines = [`## Coverage gaps — ${project_id}`, "", `**Top ${gaps.length} uncovered journeys (by users):**`, ""];
+            for (const g of gaps) {
+                lines.push(`- **\`${g.journey_id}\`** — ${g.journey_name}`);
+                lines.push(`  ${g.user_count.toLocaleString()} users · +${g.pp_coverage_gain.toFixed(1)}pp user coverage if covered`);
+                lines.push(`  ${g.events.join(" → ")}`);
+                if (g.partial_overlaps?.length) {
+                    lines.push(`  partial overlaps: ${g.partial_overlaps.map((o) => `${o.test_id}(${(o.overlap * 100).toFixed(0)}%)`).join(", ")}`);
+                }
+            }
+            lines.push("");
+            lines.push("Next step: call `tr_plan_test` with the highest-gain `journey_id` to draft a plan.");
+            return { text: lines.join("\n"), structured: { gaps } };
+        },
+    },
+    {
+        name: "tr_coverage_report",
+        capability: "coverage",
+        title: "Coverage report (95% readout)",
+        description: "Returns user_coverage and test_coverage metrics with progress toward the 95/95 targets. Repeat calls return a 3-state diff (unchanged / diff / full) to cut token usage on iteration.",
+        inputSchema: {
+            project_id: z.string(),
+            read_mode: z.enum(["auto", "full"]).optional().default("auto"),
+        },
+        outputSchema: {
+            user_coverage: z.number(),
+            test_coverage: z.number(),
+            meets_95_user: z.boolean(),
+            meets_95_test: z.boolean(),
+        },
+        handler: async (input, ctx) => {
+            const project_id = input.project_id;
+            const mode = input.read_mode ?? "auto";
+            const report = await ctx.context.correlator.coverageReport(project_id);
+            const correlation = await ctx.context.correlator.correlate(project_id);
+            const meets_user = report.user_coverage >= 0.95;
+            const meets_test = report.test_coverage >= 0.95;
+            const fullText = [
+                `## Coverage report — ${project_id}`,
+                `_Generated at ${report.generated_at}_`,
+                "",
+                `| Metric | Value | Target | Status |`,
+                `|---|---|---|---|`,
+                `| User coverage (unweighted) | ${(report.user_coverage * 100).toFixed(1)}% | 95% | ${meets_user ? "✅" : "⚠️"} |`,
+                `| User coverage (weighted by users) | ${(correlation.user_coverage_weighted * 100).toFixed(1)}% | 95% | ${correlation.user_coverage_weighted >= 0.95 ? "✅" : "⚠️"} |`,
+                `| Test coverage (code nodes) | ${(report.test_coverage * 100).toFixed(1)}% | 95% | ${meets_test ? "✅" : "⚠️"} |`,
+                "",
+                `**Total journeys tracked:** ${report.total_journeys}  (${report.covered_journeys} covered, ${report.uncovered_journeys} uncovered)`,
+                `**Total users tracked:** ${correlation.total_users_tracked.toLocaleString()}  (${correlation.total_users_covered.toLocaleString()} covered)`,
+                "",
+                report.gaps_summary.length > 0
+                    ? "### Top gaps by user count\n" + report.gaps_summary.map((g) => `- \`${g.journey_id}\` (${g.user_count.toLocaleString()} users) — ${g.reason}`).join("\n")
+                    : "_No gaps in top journeys._",
+                "",
+                "Next step: call `tr_coverage_gaps` to see the ranked list or `tr_plan_test` on a specific journey.",
+            ].join("\n");
+            if (mode === "full") {
+                return {
+                    text: fullText,
+                    structured: {
+                        report,
+                        user_coverage: report.user_coverage,
+                        test_coverage: report.test_coverage,
+                        meets_95_user: meets_user,
+                        meets_95_test: meets_test,
+                    },
+                };
+            }
+            const state = ctx.cache.diff.read(`coverage-report:${project_id}`, fullText);
+            if (state.state === "unchanged") {
+                return {
+                    text: [`## Coverage report — ${project_id}`, "", `_Unchanged since the last read (fingerprint ${state.fingerprint}). Call with read_mode=full to force a fresh read._`].join("\n"),
+                    structured: {
+                        report,
+                        user_coverage: report.user_coverage,
+                        test_coverage: report.test_coverage,
+                        meets_95_user: meets_user,
+                        meets_95_test: meets_test,
+                        read_state: "unchanged",
+                    },
+                };
+            }
+            if (state.state === "diff") {
+                return {
+                    text: [`## Coverage report — ${project_id} (diff since last read)`, "", "```diff", state.content, "```"].join("\n"),
+                    structured: {
+                        report,
+                        user_coverage: report.user_coverage,
+                        test_coverage: report.test_coverage,
+                        meets_95_user: meets_user,
+                        meets_95_test: meets_test,
+                        read_state: "diff",
+                    },
+                };
+            }
+            return {
+                text: fullText,
+                structured: {
+                    report,
+                    user_coverage: report.user_coverage,
+                    test_coverage: report.test_coverage,
+                    meets_95_user: meets_user,
+                    meets_95_test: meets_test,
+                    read_state: "full",
+                },
+            };
+        },
+    },
+    {
+        name: "tr_fetch_cached",
+        capability: "coverage",
+        title: "Fetch a cached full payload",
+        description: "Fetches a payload referenced by a cache_key returned from another tool. Used to opt into large content only when needed (token efficiency).",
+        inputSchema: {
+            cache_key: z.string(),
+        },
+        handler: async (input, ctx) => {
+            const cache_key = input.cache_key;
+            const hit = ctx.cache.get(cache_key);
+            if (!hit)
+                return { text: `No cached value for key ${cache_key}.`, structured: {} };
+            const value = hit.value;
+            if (value.blob) {
+                const text = ctx.cache.blob.readText(value.blob);
+                if (!text)
+                    return { text: `Blob ${value.blob} missing from L4.`, structured: {} };
+                return { text: ["```json", text.slice(0, 12_000), "```"].join("\n"), structured: { blob: value.blob, cache_key } };
+            }
+            return { text: ["```json", JSON.stringify(value, null, 2), "```"].join("\n"), structured: { value, cache_key } };
+        },
+    },
+];
+export function registerCoverageTools(ctx, register) {
+    for (const t of coverageTools)
+        register(t);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/coverage/index.js.map

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

package/dist/tools/creation/index.d.ts

@@ -0,0 +1,9 @@
+import type { ToolContext, ToolDefinition } from "../../registry/index.js";
+/**
+ * Creation capability — Planner, Generator, DryRun, AssertionHelper,
+ * TemplateCatalog. Uses sampling for LLM-driven synthesis with deterministic
+ * fallbacks so the tools always return something useful even offline.
+ */
+export declare const creationTools: ToolDefinition[];
+export declare function registerCreationTools(ctx: ToolContext, register: (def: ToolDefinition) => void): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/creation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/creation/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAO3E;;;;GAIG;AAEH,eAAO,MAAM,aAAa,EAAE,cAAc,EAgWzC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI,CAErG"}

package/dist/tools/creation/index.js

@@ -0,0 +1,357 @@
+import { z } from "zod";
+import { execFile } from "node:child_process";
+import { writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { TEMPLATES } from "./templates.js";
+import { NotFoundError } from "../../errors.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Creation capability — Planner, Generator, DryRun, AssertionHelper,
+ * TemplateCatalog. Uses sampling for LLM-driven synthesis with deterministic
+ * fallbacks so the tools always return something useful even offline.
+ */
+export const creationTools = [
+    {
+        name: "tr_list_templates",
+        capability: "creation",
+        title: "List framework templates",
+        description: "Returns available test framework templates (Playwright, Cypress, Jest, Vitest).",
+        inputSchema: {},
+        handler: async () => {
+            const lines = ["## Test Framework Templates", ""];
+            const entries = Object.values(TEMPLATES).map((t) => ({
+                framework: t.framework,
+                extension: t.extension,
+                description: t.description,
+            }));
+            for (const t of entries)
+                lines.push(`- **${t.framework}** (\`${t.extension}\`) — ${t.description}`);
+            return { text: lines.join("\n"), structured: { templates: entries } };
+        },
+    },
+    {
+        name: "tr_plan_test",
+        capability: "creation",
+        title: "Planner — design a test plan",
+        description: "Produces a Markdown test plan for a journey gap. Input either a journey_id (preferred) or a freeform goal. Missing PRD/acceptance info is requested via elicitation; the result is cache-keyed on the journey signature.",
+        inputSchema: {
+            project_id: z.string(),
+            journey_id: z.string().optional(),
+            goal: z.string().optional().describe("Freeform goal if journey_id is unknown"),
+            framework: z.enum(["playwright", "cypress", "jest", "vitest"]).optional().default("playwright"),
+            prd: z.string().optional().describe("PRD or acceptance criteria. If omitted, we'll try to elicit it."),
+        },
+        outputSchema: {
+            plan: z.object({
+                journey_id: z.string().optional(),
+                goal: z.string(),
+                framework: z.string(),
+                steps: z.array(z.object({ step: z.number(), action: z.string(), expectation: z.string() })),
+                data_requirements: z.array(z.string()).optional(),
+            }),
+            cache_key: z.string(),
+        },
+        handler: async (input, ctx) => {
+            const project_id = input.project_id;
+            const journey_id = input.journey_id;
+            const framework = input.framework ?? "playwright";
+            let goal = input.goal;
+            let prd = input.prd;
+            let journey;
+            if (journey_id) {
+                journey = await ctx.context.journeys.byId(project_id, journey_id);
+                if (!journey)
+                    throw new NotFoundError(`Journey ${journey_id} not found for ${project_id}`);
+                goal = goal ?? `Cover the user journey "${journey.name}" end-to-end in ${framework}.`;
+            }
+            if (!goal) {
+                return { text: "No goal or journey_id provided. Pass `goal` or `journey_id`.", structured: {} };
+            }
+            if (!prd) {
+                const elicited = await ctx.elicit.ask({
+                    message: `Any PRD, acceptance criteria, or edge cases for "${goal}"? (optional)`,
+                    schema: z.object({ prd: z.string().optional() }),
+                });
+                if (elicited.kind === "accepted" && typeof elicited.content.prd === "string")
+                    prd = elicited.content.prd;
+            }
+            const cache_key = ctx.cache.key("tr_plan_test", { project_id, journey_id, goal, framework, prd });
+            const hit = ctx.cache.get(cache_key);
+            if (hit) {
+                return { text: hit.value.text, structured: { plan: hit.value.plan, cache_key }, cacheKey: cache_key };
+            }
+            // Try sampling; fall back to deterministic skeleton.
+            const samplingPrompt = [
+                `Design a ${framework} test plan that covers the following journey.`,
+                journey ? `Journey path: ${journey.events.join(" → ")}` : "",
+                `Goal: ${goal}`,
+                prd ? `PRD / acceptance criteria:\n${prd}` : "",
+                "",
+                "Respond with a JSON object matching:",
+                '{ "steps": [{ "step": 1, "action": "...", "expectation": "..." }], "data_requirements": ["..."] }',
+            ]
+                .filter(Boolean)
+                .join("\n");
+            const sampled = await ctx.sampling.createMessage(samplingPrompt, {
+                systemPrompt: "You are a senior test engineer writing thorough, deterministic end-to-end tests. Prefer stable locators and explicit assertions.",
+                maxTokens: 800,
+                temperature: 0.2,
+            });
+            const plan = {
+                journey_id,
+                goal,
+                framework,
+                steps: [],
+            };
+            if (!sampled.fallback && sampled.text) {
+                try {
+                    const m = sampled.text.match(/\{[\s\S]*\}/);
+                    if (m) {
+                        const parsed = JSON.parse(m[0]);
+                        if (Array.isArray(parsed.steps))
+                            plan.steps = parsed.steps;
+                        if (Array.isArray(parsed.data_requirements))
+                            plan.data_requirements = parsed.data_requirements;
+                    }
+                }
+                catch {
+                    // fall through to skeleton
+                }
+            }
+            if (plan.steps.length === 0 && journey) {
+                plan.steps = journey.events.map((event, i) => ({
+                    step: i + 1,
+                    action: `Trigger event "${event}"`,
+                    expectation: `Expect the user to reach the next step of ${journey.name}`,
+                }));
+            }
+            if (plan.steps.length === 0) {
+                plan.steps = [
+                    { step: 1, action: "Navigate to the target page", expectation: "Page loads successfully" },
+                    { step: 2, action: `Perform the action implied by: ${goal}`, expectation: "Expected outcome visible" },
+                    { step: 3, action: "Assert the final state", expectation: "State matches acceptance criteria" },
+                ];
+            }
+            const text = [
+                `## Test Plan — ${plan.goal}`,
+                journey ? `**Journey:** \`${journey.id}\` · ${journey.events.join(" → ")}` : "",
+                `**Framework:** ${plan.framework}`,
+                "",
+                "### Steps",
+                ...plan.steps.map((s) => `${s.step}. **${s.action}** → _${s.expectation}_`),
+                plan.data_requirements && plan.data_requirements.length ? `\n### Data requirements\n${plan.data_requirements.map((d) => `- ${d}`).join("\n")}` : "",
+                "",
+                "Next step: call `tr_generate_test` with this plan to produce runnable code.",
+            ]
+                .filter(Boolean)
+                .join("\n");
+            ctx.cache.set(cache_key, { plan, text }, { ttlSeconds: 3600 });
+            return { text, structured: { plan, cache_key }, cacheKey: cache_key };
+        },
+    },
+    {
+        name: "tr_generate_test",
+        capability: "creation",
+        title: "Generator — produce runnable test code",
+        description: "Generates runnable test code (Playwright by default) from a plan. Uses sampling for synthesis with a deterministic template fallback. Writes to {outputDir}/generated/ and returns both the code and a cache_key.",
+        inputSchema: {
+            project_id: z.string(),
+            plan_cache_key: z.string().optional().describe("Cache key returned by tr_plan_test"),
+            plan: z
+                .object({
+                journey_id: z.string().optional(),
+                goal: z.string(),
+                framework: z.enum(["playwright", "cypress", "jest", "vitest"]),
+                steps: z.array(z.object({ step: z.number(), action: z.string(), expectation: z.string() })),
+                data_requirements: z.array(z.string()).optional(),
+            })
+                .optional(),
+            file_name: z.string().optional(),
+        },
+        outputSchema: {
+            file_path: z.string(),
+            framework: z.string(),
+            cache_key: z.string(),
+            code: z.string(),
+        },
+        handler: async (input, ctx) => {
+            let plan = input.plan;
+            if (!plan && input.plan_cache_key) {
+                const cached = ctx.cache.get(input.plan_cache_key);
+                if (cached)
+                    plan = cached.value.plan;
+            }
+            if (!plan) {
+                return {
+                    text: "No plan found. Pass a `plan` object directly or a `plan_cache_key` from tr_plan_test.",
+                    structured: {},
+                };
+            }
+            const template = TEMPLATES[plan.framework];
+            if (!template) {
+                return { text: `Framework "${plan.framework}" has no template. Try playwright, cypress, jest, or vitest.`, structured: {} };
+            }
+            const file_name = input.file_name ?? `generated-${plan.journey_id ?? Date.now()}${template.extension}`;
+            const outDir = join(ctx.config.outputDir, "generated");
+            mkdirSync(outDir, { recursive: true });
+            const file_path = join(outDir, file_name);
+            const samplingPrompt = [
+                `Write ${plan.framework} test code for the following plan:`,
+                `Goal: ${plan.goal}`,
+                "Steps:",
+                ...plan.steps.map((s) => `  ${s.step}. ${s.action} → expect: ${s.expectation}`),
+                plan.data_requirements?.length ? `Data: ${plan.data_requirements.join("; ")}` : "",
+                "",
+                `Return ONLY the body of the test function — one line per action. Use stable locators (getByRole, getByTestId). No preamble, no imports, no \`test(...)\` wrapper.`,
+            ]
+                .filter(Boolean)
+                .join("\n");
+            const sampled = await ctx.sampling.createMessage(samplingPrompt, {
+                systemPrompt: "You are a senior QA engineer. Write deterministic test code with clear assertions.",
+                maxTokens: 1_200,
+                temperature: 0.15,
+            });
+            const steps = [];
+            if (!sampled.fallback && sampled.text.trim()) {
+                for (const line of sampled.text.split(/\r?\n/)) {
+                    const trimmed = line.trim();
+                    if (!trimmed)
+                        continue;
+                    if (trimmed.startsWith("```"))
+                        continue;
+                    steps.push(trimmed);
+                }
+            }
+            if (!steps.length) {
+                for (const s of plan.steps) {
+                    if (plan.framework === "playwright") {
+                        steps.push(`// Step ${s.step}: ${s.action}`);
+                        steps.push(`await test.step("${s.action.replace(/"/g, '\\"')}", async () => { /* TODO: ${s.expectation} */ });`);
+                    }
+                    else if (plan.framework === "cypress") {
+                        steps.push(`cy.log("${s.action.replace(/"/g, '\\"')}"); // TODO: ${s.expectation}`);
+                    }
+                    else {
+                        steps.push(`// Step ${s.step}: ${s.action} — expect: ${s.expectation}`);
+                        steps.push(`expect(true).toBe(true);`);
+                    }
+                }
+            }
+            const code = template.skeleton({ testName: plan.goal, steps });
+            writeFileSync(file_path, code, "utf-8");
+            const cache_key = ctx.cache.key("tr_generate_test", { plan, file_name });
+            const sha = ctx.cache.blob.write(code);
+            ctx.cache.set(cache_key, { file_path, framework: plan.framework, blob: sha }, { ttlSeconds: 3_600 });
+            const text = [
+                `## Generated ${plan.framework} test`,
+                `**File:** \`${file_path}\``,
+                `**Fallback used:** ${sampled.fallback ? "yes (no sampling client)" : "no"}`,
+                "",
+                "```" + (plan.framework === "cypress" ? "ts" : "ts"),
+                code,
+                "```",
+                "",
+                "Next step: call `tr_dry_run_test` with this file path to verify it compiles.",
+            ].join("\n");
+            return {
+                text,
+                structured: { file_path, framework: plan.framework, cache_key, code },
+                cacheKey: cache_key,
+            };
+        },
+    },
+    {
+        name: "tr_dry_run_test",
+        capability: "creation",
+        title: "Dry-run: tsc + framework list",
+        description: "Type-checks the generated file (`tsc --noEmit`) and lists tests (`playwright test --list` when applicable). Returns first-pass errors so the agent can iterate before committing.",
+        inputSchema: {
+            file_path: z.string().describe("Path to the generated test file"),
+            framework: z.enum(["playwright", "cypress", "jest", "vitest"]).optional().default("playwright"),
+        },
+        handler: async (input, ctx) => {
+            const file = input.file_path;
+            const framework = input.framework ?? "playwright";
+            const results = [];
+            try {
+                const { stdout, stderr } = await execFileAsync("npx", ["--yes", "tsc", "--noEmit", "--skipLibCheck", file], {
+                    cwd: process.cwd(),
+                    timeout: ctx.config.timeouts.analysis,
+                });
+                results.push({ step: "tsc --noEmit", ok: true, output: stdout + stderr });
+            }
+            catch (err) {
+                const anyErr = err;
+                results.push({
+                    step: "tsc --noEmit",
+                    ok: false,
+                    output: `${anyErr.stdout ?? ""}\n${anyErr.stderr ?? ""}\n${anyErr.message ?? ""}`.trim() || String(err),
+                });
+            }
+            if (framework === "playwright") {
+                try {
+                    const { stdout, stderr } = await execFileAsync("npx", ["--yes", "playwright", "test", "--list", file], {
+                        cwd: process.cwd(),
+                        timeout: ctx.config.timeouts.analysis,
+                    });
+                    results.push({ step: "playwright test --list", ok: true, output: stdout + stderr });
+                }
+                catch (err) {
+                    const anyErr = err;
+                    results.push({
+                        step: "playwright test --list",
+                        ok: false,
+                        output: `${anyErr.stdout ?? ""}\n${anyErr.stderr ?? ""}\n${anyErr.message ?? ""}`.trim() || String(err),
+                    });
+                }
+            }
+            const ok = results.every((r) => r.ok);
+            const text = [
+                `## Dry-run: ${ok ? "PASS" : "FAIL"}`,
+                ...results.flatMap((r) => [
+                    "",
+                    `### ${r.step}: ${r.ok ? "✅" : "❌"}`,
+                    "```",
+                    r.output.slice(0, 2_000),
+                    "```",
+                ]),
+            ].join("\n");
+            return { text, structured: { ok, results, file } };
+        },
+    },
+    {
+        name: "tr_generate_assertion",
+        capability: "creation",
+        title: "Generate a stable assertion",
+        description: "TestRelic parallel to Playwright's browser_generate_locator. Given a journey step, returns a stable framework-appropriate assertion the agent can paste into a test.",
+        inputSchema: {
+            step: z.string().describe("The journey step to assert, e.g. 'payment success banner visible'"),
+            framework: z.enum(["playwright", "cypress", "jest", "vitest"]).optional().default("playwright"),
+        },
+        handler: async (input, ctx) => {
+            const step = input.step;
+            const framework = input.framework ?? "playwright";
+            const prompt = `Return a single-line ${framework} assertion that confirms: "${step}". Prefer role-based selectors. No preamble.`;
+            const sampled = await ctx.sampling.createMessage(prompt, { temperature: 0.1, maxTokens: 120 });
+            let assertion = sampled.text.trim().split(/\r?\n/)[0] ?? "";
+            if (!assertion) {
+                assertion =
+                    framework === "playwright"
+                        ? `await expect(page.getByText(${JSON.stringify(step)})).toBeVisible();`
+                        : framework === "cypress"
+                            ? `cy.contains(${JSON.stringify(step)}).should("be.visible");`
+                            : `expect(screen.getByText(${JSON.stringify(step)})).toBeTruthy();`;
+            }
+            return {
+                text: ["```ts", assertion, "```"].join("\n"),
+                structured: { framework, assertion, fallback: sampled.fallback },
+            };
+        },
+    },
+];
+export function registerCreationTools(ctx, register) {
+    for (const t of creationTools)
+        register(t);
+}
+//# sourceMappingURL=index.js.map