framewatch-mcp-server 0.1.0 → 0.2.0

package/dist/tools/api-mock.d.ts

@@ -0,0 +1,405 @@
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare const API_MOCK_TOOL_NAME = "framewatch_api_mock";
+/** What one mock answers with, when it answers at all. */
+export declare const mockResponseSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodNumber>;
+    body: z.ZodOptional<z.ZodUnknown>;
+    delay_ms: z.ZodOptional<z.ZodNumber>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status?: number | undefined;
+    body?: unknown;
+    headers?: Record<string, string> | undefined;
+    delay_ms?: number | undefined;
+}, {
+    status?: number | undefined;
+    body?: unknown;
+    headers?: Record<string, string> | undefined;
+    delay_ms?: number | undefined;
+}>;
+/** One rule: what to intercept, and what to do with it. */
+export declare const mockSchema: z.ZodObject<{
+    url_pattern: z.ZodString;
+    scenario: z.ZodOptional<z.ZodEnum<["empty", "error", "unauthorized", "not_found", "slow", "malformed", "offline"]>>;
+    response: z.ZodOptional<z.ZodObject<{
+        status: z.ZodOptional<z.ZodNumber>;
+        body: z.ZodOptional<z.ZodUnknown>;
+        delay_ms: z.ZodOptional<z.ZodNumber>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status?: number | undefined;
+        body?: unknown;
+        headers?: Record<string, string> | undefined;
+        delay_ms?: number | undefined;
+    }, {
+        status?: number | undefined;
+        body?: unknown;
+        headers?: Record<string, string> | undefined;
+        delay_ms?: number | undefined;
+    }>>;
+    abort: z.ZodOptional<z.ZodEnum<["failed", "timedout", "connectionrefused", "internetdisconnected"]>>;
+    times: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    url_pattern: string;
+    response?: {
+        status?: number | undefined;
+        body?: unknown;
+        headers?: Record<string, string> | undefined;
+        delay_ms?: number | undefined;
+    } | undefined;
+    abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+    times?: number | undefined;
+    scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+}, {
+    url_pattern: string;
+    response?: {
+        status?: number | undefined;
+        body?: unknown;
+        headers?: Record<string, string> | undefined;
+        delay_ms?: number | undefined;
+    } | undefined;
+    abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+    times?: number | undefined;
+    scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+}>;
+export declare const apiMockInputShape: {
+    mocks: z.ZodArray<z.ZodObject<{
+        url_pattern: z.ZodString;
+        scenario: z.ZodOptional<z.ZodEnum<["empty", "error", "unauthorized", "not_found", "slow", "malformed", "offline"]>>;
+        response: z.ZodOptional<z.ZodObject<{
+            status: z.ZodOptional<z.ZodNumber>;
+            body: z.ZodOptional<z.ZodUnknown>;
+            delay_ms: z.ZodOptional<z.ZodNumber>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        }, {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        }>>;
+        abort: z.ZodOptional<z.ZodEnum<["failed", "timedout", "connectionrefused", "internetdisconnected"]>>;
+        times: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        url_pattern: string;
+        response?: {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        } | undefined;
+        abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+        times?: number | undefined;
+        scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+    }, {
+        url_pattern: string;
+        response?: {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        } | undefined;
+        abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+        times?: number | undefined;
+        scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+    }>, "many">;
+    block_unmatched: z.ZodDefault<z.ZodBoolean>;
+    include_network: z.ZodDefault<z.ZodBoolean>;
+    url: z.ZodString;
+    duration_ms: z.ZodDefault<z.ZodNumber>;
+    sensitivity: z.ZodDefault<z.ZodNumber>;
+    max_frames: z.ZodDefault<z.ZodNumber>;
+    interval_ms: z.ZodDefault<z.ZodNumber>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodDefault<z.ZodNumber>;
+        height: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width?: number | undefined;
+        height?: number | undefined;
+    }>>;
+    wait_for: z.ZodOptional<z.ZodString>;
+    wait_for_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    interactions: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        delay_ms: z.ZodDefault<z.ZodNumber>;
+        selector: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        delta_x: z.ZodOptional<z.ZodNumber>;
+        delta_y: z.ZodOptional<z.ZodNumber>;
+        action: z.ZodEnum<["click", "tap", "type", "key", "scroll", "swipe", "hover", "select", "wait", "navigate"]>;
+    }, "strip", z.ZodTypeAny, {
+        delay_ms: number;
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }, {
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        delay_ms?: number | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }>, {
+        delay_ms: number;
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }, {
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        delay_ms?: number | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }>, "many">>;
+    interaction_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    include_console: z.ZodDefault<z.ZodBoolean>;
+    include_dom: z.ZodDefault<z.ZodBoolean>;
+    include_performance: z.ZodDefault<z.ZodBoolean>;
+    storage_state: z.ZodOptional<z.ZodString>;
+};
+export declare const apiMockInputSchema: z.ZodObject<{
+    mocks: z.ZodArray<z.ZodObject<{
+        url_pattern: z.ZodString;
+        scenario: z.ZodOptional<z.ZodEnum<["empty", "error", "unauthorized", "not_found", "slow", "malformed", "offline"]>>;
+        response: z.ZodOptional<z.ZodObject<{
+            status: z.ZodOptional<z.ZodNumber>;
+            body: z.ZodOptional<z.ZodUnknown>;
+            delay_ms: z.ZodOptional<z.ZodNumber>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        }, {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        }>>;
+        abort: z.ZodOptional<z.ZodEnum<["failed", "timedout", "connectionrefused", "internetdisconnected"]>>;
+        times: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        url_pattern: string;
+        response?: {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        } | undefined;
+        abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+        times?: number | undefined;
+        scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+    }, {
+        url_pattern: string;
+        response?: {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        } | undefined;
+        abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+        times?: number | undefined;
+        scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+    }>, "many">;
+    block_unmatched: z.ZodDefault<z.ZodBoolean>;
+    include_network: z.ZodDefault<z.ZodBoolean>;
+    url: z.ZodString;
+    duration_ms: z.ZodDefault<z.ZodNumber>;
+    sensitivity: z.ZodDefault<z.ZodNumber>;
+    max_frames: z.ZodDefault<z.ZodNumber>;
+    interval_ms: z.ZodDefault<z.ZodNumber>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodDefault<z.ZodNumber>;
+        height: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width?: number | undefined;
+        height?: number | undefined;
+    }>>;
+    wait_for: z.ZodOptional<z.ZodString>;
+    wait_for_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    interactions: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
+        delay_ms: z.ZodDefault<z.ZodNumber>;
+        selector: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        delta_x: z.ZodOptional<z.ZodNumber>;
+        delta_y: z.ZodOptional<z.ZodNumber>;
+        action: z.ZodEnum<["click", "tap", "type", "key", "scroll", "swipe", "hover", "select", "wait", "navigate"]>;
+    }, "strip", z.ZodTypeAny, {
+        delay_ms: number;
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }, {
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        delay_ms?: number | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }>, {
+        delay_ms: number;
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }, {
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        delay_ms?: number | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }>, "many">>;
+    interaction_timeout_ms: z.ZodDefault<z.ZodNumber>;
+    include_console: z.ZodDefault<z.ZodBoolean>;
+    include_dom: z.ZodDefault<z.ZodBoolean>;
+    include_performance: z.ZodDefault<z.ZodBoolean>;
+    storage_state: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    wait_for_timeout_ms: number;
+    block_unmatched: boolean;
+    duration_ms: number;
+    sensitivity: number;
+    max_frames: number;
+    interval_ms: number;
+    interaction_timeout_ms: number;
+    include_console: boolean;
+    include_network: boolean;
+    include_dom: boolean;
+    include_performance: boolean;
+    mocks: {
+        url_pattern: string;
+        response?: {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        } | undefined;
+        abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+        times?: number | undefined;
+        scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+    }[];
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    wait_for?: string | undefined;
+    storage_state?: string | undefined;
+    interactions?: {
+        delay_ms: number;
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }[] | undefined;
+}, {
+    url: string;
+    mocks: {
+        url_pattern: string;
+        response?: {
+            status?: number | undefined;
+            body?: unknown;
+            headers?: Record<string, string> | undefined;
+            delay_ms?: number | undefined;
+        } | undefined;
+        abort?: "failed" | "timedout" | "connectionrefused" | "internetdisconnected" | undefined;
+        times?: number | undefined;
+        scenario?: "error" | "offline" | "empty" | "unauthorized" | "not_found" | "slow" | "malformed" | undefined;
+    }[];
+    viewport?: {
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    wait_for?: string | undefined;
+    wait_for_timeout_ms?: number | undefined;
+    storage_state?: string | undefined;
+    block_unmatched?: boolean | undefined;
+    duration_ms?: number | undefined;
+    sensitivity?: number | undefined;
+    max_frames?: number | undefined;
+    interval_ms?: number | undefined;
+    interactions?: {
+        action: "type" | "key" | "click" | "tap" | "scroll" | "swipe" | "hover" | "select" | "wait" | "navigate";
+        value?: string | undefined;
+        delay_ms?: number | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+        selector?: string | undefined;
+        delta_x?: number | undefined;
+        delta_y?: number | undefined;
+    }[] | undefined;
+    interaction_timeout_ms?: number | undefined;
+    include_console?: boolean | undefined;
+    include_network?: boolean | undefined;
+    include_dom?: boolean | undefined;
+    include_performance?: boolean | undefined;
+}>;
+export type ApiMockInput = z.input<typeof apiMockInputSchema>;
+type ParsedApiMockInput = z.output<typeof apiMockInputSchema>;
+/**
+ * Show the page the answers it is never given in development.
+ *
+ * Intercepts the requests named in `mocks`, answers them however the caller
+ * says — empty, broken, slow, unauthorised, dead — and records the page's
+ * reaction as diff cards, exactly as `framewatch_capture` would. It is the
+ * same recorder, differ and layers; the only difference is what the network
+ * says back.
+ *
+ * The report leads with what each mock actually did, because the failure this
+ * tool is most likely to hit is the silent one: a pattern that matches nothing,
+ * a page that renders perfectly on real data, and a test that proved nothing at
+ * all.
+ */
+export declare function mockApi(rawInput: ApiMockInput): Promise<CallToolResult>;
+/**
+ * One actionable line for a run that could not happen. Mirrors
+ * `describeCaptureFailure`: match on the failing Playwright call, never on
+ * substrings of a user-supplied selector.
+ */
+export declare function describeApiMockFailure(input: Pick<ParsedApiMockInput, "url" | "wait_for" | "wait_for_timeout_ms">, error: unknown): string;
+export declare function registerApiMockTool(server: McpServer): void;
+export {};

package/dist/tools/api-mock.js

@@ -0,0 +1,186 @@
+import { z } from "zod";
+import { MAX_MOCKS, MAX_MOCK_BODY_BYTES, MAX_MOCK_DELAY_MS } from "../constants.js";
+import { MockRouter } from "../engine/mocks.js";
+import { formatDiffCards } from "../utils/format.js";
+import { ABORT_REASONS, MOCK_SCENARIOS, formatMockReport, resolveMock, } from "../utils/mock-rules.js";
+import { authLines, captureInputShape, runCapture, summariseContext } from "./capture.js";
+export const API_MOCK_TOOL_NAME = "framewatch_api_mock";
+/** What one mock answers with, when it answers at all. */
+export const mockResponseSchema = z.object({
+    status: z.number().int().min(100).max(599).optional().describe("HTTP status to answer with (default 200)"),
+    body: z
+        .unknown()
+        .optional()
+        .describe("The response body. An object or array is sent as JSON; a string is sent exactly as written, which is " +
+        "how you simulate an API that returns broken JSON."),
+    delay_ms: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_MOCK_DELAY_MS)
+        .optional()
+        .describe("Hold the response back this long, so the recording shows the waiting state"),
+    headers: z.record(z.string()).optional().describe("Response headers. A `content-type` here overrides the one the body implies."),
+});
+/** One rule: what to intercept, and what to do with it. */
+export const mockSchema = z.object({
+    url_pattern: z
+        .string()
+        .min(1)
+        .describe("Glob matched against the whole URL, e.g. `**/api/products*`. A bare path like `/api/products` matches " +
+        "nothing — it needs the leading `**`."),
+    scenario: z
+        .enum(MOCK_SCENARIOS)
+        .optional()
+        .describe("Shorthand for a common state: `empty` (200, `[]`), `error` (500), `unauthorized` (401), `not_found` " +
+        "(404), `slow` (200 after 5s), `malformed` (200 with a body that is not JSON), `offline` (the request " +
+        "fails outright). Anything you also put in `response` wins over the shorthand."),
+    response: mockResponseSchema.optional(),
+    abort: z
+        .enum(ABORT_REASONS)
+        .optional()
+        .describe("Fail the request instead of answering it — what the page sees when the network is down"),
+    times: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Only apply to the first N matching requests; later ones fall through to the next mock, or to the real server"),
+});
+export const apiMockInputShape = {
+    ...captureInputShape,
+    mocks: z
+        .array(mockSchema)
+        .min(1)
+        .max(MAX_MOCKS)
+        .describe("The requests to intercept. When two patterns match the same request, the first one listed wins."),
+    block_unmatched: z
+        .boolean()
+        .default(false)
+        .describe("Fail every request no mock matched, instead of letting it reach the real server. Turns the run into " +
+        "'what does this page do with no backend at all'."),
+    // Louder than in framewatch_capture, and deliberately: the whole point here
+    // is what the page did with the answers it was given, so the requests
+    // themselves are part of the result rather than an extra.
+    include_network: z
+        .boolean()
+        .default(true)
+        .describe("Attach network requests (method, url, status, duration) to the frames they settled between"),
+};
+export const apiMockInputSchema = z.object(apiMockInputShape);
+/**
+ * Show the page the answers it is never given in development.
+ *
+ * Intercepts the requests named in `mocks`, answers them however the caller
+ * says — empty, broken, slow, unauthorised, dead — and records the page's
+ * reaction as diff cards, exactly as `framewatch_capture` would. It is the
+ * same recorder, differ and layers; the only difference is what the network
+ * says back.
+ *
+ * The report leads with what each mock actually did, because the failure this
+ * tool is most likely to hit is the silent one: a pattern that matches nothing,
+ * a page that renders perfectly on real data, and a test that proved nothing at
+ * all.
+ */
+export async function mockApi(rawInput) {
+    const parsed = apiMockInputSchema.safeParse(rawInput);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map((i) => `${i.path.join(".") || "input"}: ${i.message}`).join("; ");
+        return errorResult(`API mock run failed: invalid input — ${issues}`);
+    }
+    const input = parsed.data;
+    const mocks = input.mocks.map((mock) => resolveMock(mock));
+    const oversized = tooLarge(mocks);
+    if (oversized)
+        return errorResult(`API mock run of ${input.url} failed: ${oversized}`);
+    const router = new MockRouter({ mocks, block_unmatched: input.block_unmatched });
+    let run;
+    try {
+        run = await runCapture(input, {
+            prepare: (page) => router.install(page),
+            finish: async () => router.dispose(),
+        });
+    }
+    catch (error) {
+        router.dispose();
+        return errorResult(describeApiMockFailure(input, error));
+    }
+    const report = formatMockReport({
+        activity: router.activity,
+        unmatched: router.unmatched,
+        block_unmatched: input.block_unmatched,
+        // The length that was asked for, not the wall clock the recorder measured:
+        // "longer than the 5000ms recording" is what the caller can act on.
+        duration_ms: input.duration_ms,
+    });
+    return formatDiffCards({
+        cards: run.cards,
+        total_frames: run.total_frames,
+        duration_ms: run.duration_ms,
+        url: run.url,
+        final_url: run.final_url,
+        title: run.title,
+        dropped: run.dropped,
+        interactions: run.interactions,
+        viewport: run.viewport,
+        notes: [...report, ...(summariseContext(run.context, run.cards.length) ?? []), ...authLines(run)],
+    });
+}
+/**
+ * The first mock whose body will not fit, if any. Bodies are held in Node,
+ * pushed into the browser and echoed in the report, so an unbounded one is a
+ * way to wedge all three at once.
+ */
+function tooLarge(mocks) {
+    for (let i = 0; i < mocks.length; i++) {
+        const mock = mocks[i];
+        if (mock.kind !== "fulfill")
+            continue;
+        const bytes = Buffer.byteLength(mock.body, "utf8");
+        if (bytes > MAX_MOCK_BODY_BYTES) {
+            return (`mock ${i + 1} (\`${mock.url_pattern}\`) has a ${bytes}-byte body, which is too large — ` +
+                `the limit is ${MAX_MOCK_BODY_BYTES} bytes.`);
+        }
+    }
+    return undefined;
+}
+function errorResult(text) {
+    return { isError: true, content: [{ type: "text", text }] };
+}
+/**
+ * One actionable line for a run that could not happen. Mirrors
+ * `describeCaptureFailure`: match on the failing Playwright call, never on
+ * substrings of a user-supplied selector.
+ */
+export function describeApiMockFailure(input, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const line = message.split("\n")[0];
+    const prefix = `API mock run of ${input.url} failed:`;
+    if (/Executable doesn't exist|browserType\.launch/i.test(message)) {
+        return (`${prefix} Playwright's Chromium browser is not installed. ` +
+            `Run \`npx playwright install chromium\` and try again. (${line})`);
+    }
+    if (input.wait_for && /^page\.waitForSelector:/.test(message)) {
+        return `${prefix} selector "${input.wait_for}" did not become visible within ${input.wait_for_timeout_ms}ms.`;
+    }
+    if (/^page\.goto:/.test(message)) {
+        return `${prefix} the page could not be opened — ${line}`;
+    }
+    return `${prefix} ${line}`;
+}
+export function registerApiMockTool(server) {
+    server.registerTool(API_MOCK_TOOL_NAME, {
+        title: "API mock",
+        description: "Answer the page's API calls yourself and record what it does with the answer. Use it to see the " +
+            "states you cannot reach on real data: an empty list, a 500, a 401, a response that takes five " +
+            "seconds, a body that is not valid JSON, or a request that fails outright. `scenario` covers each of " +
+            "those in a word; `response` sets the status, body, headers and delay by hand. Returns the same diff " +
+            "cards as framewatch_capture, plus a report of what each mock actually served — including the ones " +
+            "that matched nothing, which is how you find out a pattern was wrong instead of trusting a page that " +
+            "looked fine. Requests no mock matched reach the real server and are named; `block_unmatched` cuts " +
+            "them off instead.",
+        inputSchema: apiMockInputShape,
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async (args) => mockApi(args));
+}
+//# sourceMappingURL=api-mock.js.map

package/dist/tools/api-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-mock.js","sourceRoot":"","sources":["../../src/tools/api-mock.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { CallToolResult } from \"@modelcontextprotocol/sdk/types.js\";\nimport { MAX_MOCKS, MAX_MOCK_BODY_BYTES, MAX_MOCK_DELAY_MS } from \"../constants.js\";\nimport { MockRouter } from \"../engine/mocks.js\";\nimport { formatDiffCards } from \"../utils/format.js\";\nimport {\n  ABORT_REASONS,\n  MOCK_SCENARIOS,\n  formatMockReport,\n  resolveMock,\n  type ResolvedMock,\n} from \"../utils/mock-rules.js\";\nimport { authLines, captureInputShape, runCapture, summariseContext, type CaptureRun } from \"./capture.js\";\n\nexport const API_MOCK_TOOL_NAME = \"framewatch_api_mock\";\n\n/** What one mock answers with, when it answers at all. */\nexport const mockResponseSchema = z.object({\n  status: z.number().int().min(100).max(599).optional().describe(\"HTTP status to answer with (default 200)\"),\n  body: z\n    .unknown()\n    .optional()\n    .describe(\n      \"The response body. An object or array is sent as JSON; a string is sent exactly as written, which is \" +\n        \"how you simulate an API that returns broken JSON.\",\n    ),\n  delay_ms: z\n    .number()\n    .int()\n    .min(0)\n    .max(MAX_MOCK_DELAY_MS)\n    .optional()\n    .describe(\"Hold the response back this long, so the recording shows the waiting state\"),\n  headers: z.record(z.string()).optional().describe(\"Response headers. A `content-type` here overrides the one the body implies.\"),\n});\n\n/** One rule: what to intercept, and what to do with it. */\nexport const mockSchema = z.object({\n  url_pattern: z\n    .string()\n    .min(1)\n    .describe(\n      \"Glob matched against the whole URL, e.g. `**/api/products*`. A bare path like `/api/products` matches \" +\n        \"nothing — it needs the leading `**`.\",\n    ),\n  scenario: z\n    .enum(MOCK_SCENARIOS)\n    .optional()\n    .describe(\n      \"Shorthand for a common state: `empty` (200, `[]`), `error` (500), `unauthorized` (401), `not_found` \" +\n        \"(404), `slow` (200 after 5s), `malformed` (200 with a body that is not JSON), `offline` (the request \" +\n        \"fails outright). Anything you also put in `response` wins over the shorthand.\",\n    ),\n  response: mockResponseSchema.optional(),\n  abort: z\n    .enum(ABORT_REASONS)\n    .optional()\n    .describe(\"Fail the request instead of answering it — what the page sees when the network is down\"),\n  times: z\n    .number()\n    .int()\n    .min(1)\n    .optional()\n    .describe(\"Only apply to the first N matching requests; later ones fall through to the next mock, or to the real server\"),\n});\n\nexport const apiMockInputShape = {\n  ...captureInputShape,\n  mocks: z\n    .array(mockSchema)\n    .min(1)\n    .max(MAX_MOCKS)\n    .describe(\"The requests to intercept. When two patterns match the same request, the first one listed wins.\"),\n  block_unmatched: z\n    .boolean()\n    .default(false)\n    .describe(\n      \"Fail every request no mock matched, instead of letting it reach the real server. Turns the run into \" +\n        \"'what does this page do with no backend at all'.\",\n    ),\n  // Louder than in framewatch_capture, and deliberately: the whole point here\n  // is what the page did with the answers it was given, so the requests\n  // themselves are part of the result rather than an extra.\n  include_network: z\n    .boolean()\n    .default(true)\n    .describe(\"Attach network requests (method, url, status, duration) to the frames they settled between\"),\n};\n\nexport const apiMockInputSchema = z.object(apiMockInputShape);\nexport type ApiMockInput = z.input<typeof apiMockInputSchema>;\ntype ParsedApiMockInput = z.output<typeof apiMockInputSchema>;\n\n/**\n * Show the page the answers it is never given in development.\n *\n * Intercepts the requests named in `mocks`, answers them however the caller\n * says — empty, broken, slow, unauthorised, dead — and records the page's\n * reaction as diff cards, exactly as `framewatch_capture` would. It is the\n * same recorder, differ and layers; the only difference is what the network\n * says back.\n *\n * The report leads with what each mock actually did, because the failure this\n * tool is most likely to hit is the silent one: a pattern that matches nothing,\n * a page that renders perfectly on real data, and a test that proved nothing at\n * all.\n */\nexport async function mockApi(rawInput: ApiMockInput): Promise<CallToolResult> {\n  const parsed = apiMockInputSchema.safeParse(rawInput);\n  if (!parsed.success) {\n    const issues = parsed.error.issues.map((i) => `${i.path.join(\".\") || \"input\"}: ${i.message}`).join(\"; \");\n    return errorResult(`API mock run failed: invalid input — ${issues}`);\n  }\n  const input = parsed.data;\n\n  const mocks = input.mocks.map((mock) => resolveMock(mock));\n  const oversized = tooLarge(mocks);\n  if (oversized) return errorResult(`API mock run of ${input.url} failed: ${oversized}`);\n\n  const router = new MockRouter({ mocks, block_unmatched: input.block_unmatched });\n\n  let run: CaptureRun;\n  try {\n    run = await runCapture(input, {\n      prepare: (page) => router.install(page),\n      finish: async () => router.dispose(),\n    });\n  } catch (error) {\n    router.dispose();\n    return errorResult(describeApiMockFailure(input, error));\n  }\n\n  const report = formatMockReport({\n    activity: router.activity,\n    unmatched: router.unmatched,\n    block_unmatched: input.block_unmatched,\n    // The length that was asked for, not the wall clock the recorder measured:\n    // \"longer than the 5000ms recording\" is what the caller can act on.\n    duration_ms: input.duration_ms,\n  });\n\n  return formatDiffCards({\n    cards: run.cards,\n    total_frames: run.total_frames,\n    duration_ms: run.duration_ms,\n    url: run.url,\n    final_url: run.final_url,\n    title: run.title,\n    dropped: run.dropped,\n    interactions: run.interactions,\n    viewport: run.viewport,\n    notes: [...report, ...(summariseContext(run.context, run.cards.length) ?? []), ...authLines(run)],\n  });\n}\n\n/**\n * The first mock whose body will not fit, if any. Bodies are held in Node,\n * pushed into the browser and echoed in the report, so an unbounded one is a\n * way to wedge all three at once.\n */\nfunction tooLarge(mocks: ResolvedMock[]): string | undefined {\n  for (let i = 0; i < mocks.length; i++) {\n    const mock = mocks[i];\n    if (mock.kind !== \"fulfill\") continue;\n    const bytes = Buffer.byteLength(mock.body, \"utf8\");\n    if (bytes > MAX_MOCK_BODY_BYTES) {\n      return (\n        `mock ${i + 1} (\\`${mock.url_pattern}\\`) has a ${bytes}-byte body, which is too large — ` +\n        `the limit is ${MAX_MOCK_BODY_BYTES} bytes.`\n      );\n    }\n  }\n  return undefined;\n}\n\nfunction errorResult(text: string): CallToolResult {\n  return { isError: true, content: [{ type: \"text\", text }] };\n}\n\n/**\n * One actionable line for a run that could not happen. Mirrors\n * `describeCaptureFailure`: match on the failing Playwright call, never on\n * substrings of a user-supplied selector.\n */\nexport function describeApiMockFailure(\n  input: Pick<ParsedApiMockInput, \"url\" | \"wait_for\" | \"wait_for_timeout_ms\">,\n  error: unknown,\n): string {\n  const message = error instanceof Error ? error.message : String(error);\n  const line = message.split(\"\\n\")[0];\n  const prefix = `API mock run of ${input.url} failed:`;\n\n  if (/Executable doesn't exist|browserType\\.launch/i.test(message)) {\n    return (\n      `${prefix} Playwright's Chromium browser is not installed. ` +\n      `Run \\`npx playwright install chromium\\` and try again. (${line})`\n    );\n  }\n  if (input.wait_for && /^page\\.waitForSelector:/.test(message)) {\n    return `${prefix} selector \"${input.wait_for}\" did not become visible within ${input.wait_for_timeout_ms}ms.`;\n  }\n  if (/^page\\.goto:/.test(message)) {\n    return `${prefix} the page could not be opened — ${line}`;\n  }\n  return `${prefix} ${line}`;\n}\n\nexport function registerApiMockTool(server: McpServer): void {\n  server.registerTool(\n    API_MOCK_TOOL_NAME,\n    {\n      title: \"API mock\",\n      description:\n        \"Answer the page's API calls yourself and record what it does with the answer. Use it to see the \" +\n        \"states you cannot reach on real data: an empty list, a 500, a 401, a response that takes five \" +\n        \"seconds, a body that is not valid JSON, or a request that fails outright. `scenario` covers each of \" +\n        \"those in a word; `response` sets the status, body, headers and delay by hand. Returns the same diff \" +\n        \"cards as framewatch_capture, plus a report of what each mock actually served — including the ones \" +\n        \"that matched nothing, which is how you find out a pattern was wrong instead of trusting a page that \" +\n        \"looked fine. Requests no mock matched reach the real server and are named; `block_unmatched` cuts \" +\n        \"them off instead.\",\n      inputSchema: apiMockInputShape,\n      annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true },\n    },\n    async (args) => mockApi(args),\n  );\n}\n"]}