@ingcreators/annot-mcp 0.2.0 → 0.3.1

package/dist/index.js

@@ -1,1267 +1,1762 @@
-import { SHARED_DEFS as te, DEFAULT_ENCODE_OPTIONS as oe, decodeAndEncodeImage as re, BBOX_ANNOTATION_SCHEMA as ne, bboxAnnotationsToSvg as U, BBOX_REDACT_REGION_SCHEMA as se, createAnnotator as ie } from "@ingcreators/annot-annotator";
-import { BBOX_ANNOTATION_SCHEMA as At, BBOX_REDACT_REGION_SCHEMA as Tt, arrowBetween as Rt, bboxAnnotationsToSvg as It, rectForBoundingBox as _t, textAt as Ct } from "@ingcreators/annot-annotator";
-import { loadImage as C, createCanvas as F } from "@napi-rs/canvas";
-import ae from "pixelmatch";
-import { readFile as ce, writeFile as O } from "node:fs/promises";
-import { isAbsolute as b } from "node:path";
-import { Server as de } from "@modelcontextprotocol/sdk/server/index.js";
-import { ListToolsRequestSchema as le, CallToolRequestSchema as ue } from "@modelcontextprotocol/sdk/types.js";
-import { StdioServerTransport as he } from "@modelcontextprotocol/sdk/server/stdio.js";
-const fe = { width: 1280, height: 800, deviceScaleFactor: 1 }, pe = "load";
-async function W(e, t) {
-  const o = { ...fe, ...t.viewport }, n = t.waitFor ?? pe, s = t.fullPage ?? !1, c = await e.acquire();
-  let r, a = !1;
-  const i = () => {
-    a || (a = !0, e.release());
-  };
-  try {
-    r = await c.newContext({
-      viewport: { width: o.width, height: o.height },
-      deviceScaleFactor: o.deviceScaleFactor
-    });
-    const d = await r.newPage();
-    await d.goto(t.url, { waitUntil: n });
-    const l = await d.screenshot({ fullPage: s, type: "png" }), v = new Uint8Array(l.buffer, l.byteOffset, l.byteLength), u = r;
-    return { pngBytes: v, handle: {
-      page: d,
-      async close() {
-        if (!a)
-          try {
-            await u.close();
-          } finally {
-            i();
-          }
-      }
-    } };
-  } catch (d) {
-    if (r)
-      try {
-        await r.close();
-      } catch {
-      }
-    throw i(), d;
-  }
+import { BBOX_ANNOTATION_SCHEMA as e, BBOX_REDACT_REGION_SCHEMA as t, DEFAULT_ENCODE_OPTIONS as n, SHARED_DEFS as r, arrowBetween as i, bboxAnnotationsToSvg as a, bboxAnnotationsToSvg as o, createAnnotator as s, decodeAndEncodeImage as c, rectForBoundingBox as l, textAt as u } from "@ingcreators/annot-annotator";
+import { createCanvas as d, loadImage as f } from "@napi-rs/canvas";
+import ee from "pixelmatch";
+import { readFile as te, writeFile as p } from "node:fs/promises";
+import { isAbsolute as m } from "node:path";
+import { Server as ne } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema as re, ListToolsRequestSchema as ie } from "@modelcontextprotocol/sdk/types.js";
+import { detectDrift as ae, lintableScreens as oe, parseMdxFile as se, parseSnapshot as ce } from "@ingcreators/annot-product-docs";
+import { StdioServerTransport as le } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region src/browser/capture.ts
+var ue = {
+	width: 1280,
+	height: 800,
+	deviceScaleFactor: 1
+}, de = "load";
+async function h(e, t) {
+	let n = {
+		...ue,
+		...t.viewport
+	}, r = t.waitFor ?? de, i = t.fullPage ?? !1, a = await e.acquire(), o, s = !1, c = () => {
+		s || (s = !0, e.release());
+	};
+	try {
+		o = await a.newContext({
+			viewport: {
+				width: n.width,
+				height: n.height
+			},
+			deviceScaleFactor: n.deviceScaleFactor
+		});
+		let e = await o.newPage();
+		await e.goto(t.url, { waitUntil: r });
+		let l = await e.screenshot({
+			fullPage: i,
+			type: "png"
+		}), u = new Uint8Array(l.buffer, l.byteOffset, l.byteLength), d = o;
+		return {
+			pngBytes: u,
+			handle: {
+				page: e,
+				async close() {
+					if (!s) try {
+						await d.close();
+					} finally {
+						c();
+					}
+				}
+			}
+		};
+	} catch (e) {
+		if (o) try {
+			await o.close();
+		} catch {}
+		throw c(), e;
+	}
 }
-const me = 3e4;
-class ge {
-  #s;
-  #i;
-  #e;
-  #r;
-  #t = 0;
-  #o;
-  constructor(t, o = {}) {
-    this.#s = t, this.#i = o.idleTimeoutMs ?? me;
-  }
-  /**
-   * Acquire a browser instance. The pool launches lazily on the
-   * first call. Subsequent acquires return the same shared
-   * instance until every borrow has been released and the idle
-   * timeout has elapsed.
-   *
-   * The caller MUST call {@link release} (typically in a `finally`)
-   * after they're done so the pool can track outstanding borrows
-   * accurately.
-   */
-  async acquire() {
-    return this.#n(), this.#t += 1, this.#e ? this.#e : (this.#r || (this.#r = this.#s.launch().then((t) => (this.#e = t, this.#r = void 0, t)).catch((t) => {
-      throw this.#r = void 0, this.#t = Math.max(0, this.#t - 1), t;
-    })), this.#r);
-  }
-  /**
-   * Release a previously-acquired browser. Decrements the
-   * refcount; when it reaches zero an idle timer starts. A
-   * follow-up `acquire` within the idle window reuses the same
-   * instance; otherwise the timer fires and the browser closes.
-   */
-  release() {
-    this.#t !== 0 && (this.#t -= 1, this.#t === 0 && this.#e && this.#a());
-  }
-  /**
-   * Close the pooled browser immediately, regardless of refcount.
-   * Intended for explicit teardown (e.g. SIGINT / SIGTERM
-   * handlers); regular flows should rely on the idle timer.
-   */
-  async shutdown() {
-    this.#n();
-    const t = this.#e;
-    this.#e = void 0, this.#t = 0, t && await t.close();
-  }
-  /** Refcount of outstanding borrows. Exposed for tests / metrics. */
-  get activeBorrows() {
-    return this.#t;
-  }
-  /** Whether a browser is currently launched. Exposed for tests. */
-  get isLaunched() {
-    return this.#e !== void 0;
-  }
-  // ─── internals ────────────────────────────────────────────────
-  #n() {
-    this.#o && (clearTimeout(this.#o), this.#o = void 0);
-  }
-  #a() {
-    this.#n(), this.#o = setTimeout(() => {
-      const t = this.#e;
-      this.#e = void 0, this.#o = void 0, t?.close().catch(() => {
-      });
-    }, this.#i), this.#o.unref?.();
-  }
-}
-function ye(e = {}) {
-  return new ge(
-    {
-      async launch() {
-        let t;
-        try {
-          ({ chromium: t } = await import("playwright-core"));
-        } catch (o) {
-          throw new q(
-            "Failed to load `playwright-core`. Reinstall `@ingcreators/annot-mcp` to restore the dependency.",
-            o
-          );
-        }
-        try {
-          return await t.launch({ headless: !0 });
-        } catch (o) {
-          throw new q(
-            "Failed to launch Chromium. Run `npx playwright install chromium` to download the runtime, then retry.",
-            o
-          );
-        }
-      }
-    },
-    e
-  );
+//#endregion
+//#region src/browser/pool.ts
+var fe = 3e4, g = class {
+	#e;
+	#t;
+	#n;
+	#r;
+	#i = 0;
+	#a;
+	constructor(e, t = {}) {
+		this.#e = e, this.#t = t.idleTimeoutMs ?? fe;
+	}
+	async acquire() {
+		return this.#o(), this.#i += 1, this.#n ? this.#n : (this.#r ||= this.#e.launch().then((e) => (this.#n = e, this.#r = void 0, e)).catch((e) => {
+			throw this.#r = void 0, this.#i = Math.max(0, this.#i - 1), e;
+		}), this.#r);
+	}
+	release() {
+		this.#i !== 0 && (--this.#i, this.#i === 0 && this.#n && this.#s());
+	}
+	async shutdown() {
+		this.#o();
+		let e = this.#n;
+		this.#n = void 0, this.#i = 0, e && await e.close();
+	}
+	get activeBorrows() {
+		return this.#i;
+	}
+	get isLaunched() {
+		return this.#n !== void 0;
+	}
+	#o() {
+		this.#a &&= (clearTimeout(this.#a), void 0);
+	}
+	#s() {
+		this.#o(), this.#a = setTimeout(() => {
+			let e = this.#n;
+			this.#n = void 0, this.#a = void 0, e?.close().catch(() => {});
+		}, this.#t), this.#a.unref?.();
+	}
+};
+function pe(e = {}) {
+	return new g({ async launch() {
+		let e;
+		try {
+			({chromium: e} = await import("playwright-core"));
+		} catch (e) {
+			throw new _("Failed to load `playwright-core`. Reinstall `@ingcreators/annot-mcp` to restore the dependency.", e);
+		}
+		try {
+			return await e.launch({ headless: !0 });
+		} catch (e) {
+			throw new _("Failed to launch Chromium. Run `npx playwright install chromium` to download the runtime, then retry.", e);
+		}
+	} }, e);
 }
-class q extends Error {
-  cause;
-  constructor(t, o) {
-    super(t), this.name = "ChromiumUnavailableError", this.cause = o;
-  }
+var _ = class extends Error {
+	cause;
+	constructor(e, t) {
+		super(e), this.name = "ChromiumUnavailableError", this.cause = t;
+	}
+}, v = class extends Error {
+	locator;
+	constructor(e, t) {
+		super(t), this.name = "LocatorResolutionError", this.locator = e;
+	}
+};
+async function y(e, t) {
+	let n = await e.locator(t).boundingBox();
+	if (!n) throw new v(t, `Locator "${t}" resolved to no visible element. Check the selector matches at least one element and the element is inside the captured viewport.`);
+	return n;
 }
-class N extends Error {
-  locator;
-  constructor(t, o) {
-    super(o), this.name = "LocatorResolutionError", this.locator = t;
-  }
+async function me(e, t) {
+	switch (t.type) {
+		case "rect": {
+			let n = t.bbox ?? await y(e, x(t.locator));
+			return {
+				...S(t),
+				type: "rect",
+				bbox: n
+			};
+		}
+		case "circle": {
+			if (t.center !== void 0 && t.radius !== void 0) return {
+				...S(t),
+				type: "circle",
+				center: t.center,
+				radius: t.radius
+			};
+			let n = await y(e, x(t.locator));
+			return {
+				...S(t),
+				type: "circle",
+				center: b(n),
+				radius: Math.min(n.width, n.height) / 2
+			};
+		}
+		case "arrow": {
+			let n = t.from ?? b(await y(e, x(t.fromLocator))), r = t.to ?? b(await y(e, x(t.toLocator)));
+			return {
+				...S(t),
+				type: "arrow",
+				from: n,
+				to: r
+			};
+		}
+		case "text": {
+			let n = t.at ?? _e(await y(e, x(t.locator)), t.fontSize), r = {
+				...S(t),
+				type: "text",
+				at: n,
+				content: t.content
+			};
+			return t.fontSize !== void 0 && (r.fontSize = t.fontSize), t.anchor !== void 0 && (r.anchor = t.anchor), r;
+		}
+		case "callout": {
+			let n = t.at ?? await ge(e, t.atLocator), r = t.targetBbox ?? await y(e, x(t.targetLocator));
+			return {
+				...S(t),
+				type: "callout",
+				at: n,
+				targetBbox: r,
+				content: t.content
+			};
+		}
+		case "raw": return t;
+	}
 }
-async function f(e, t) {
-  const o = await e.locator(t).boundingBox();
-  if (!o)
-    throw new N(
-      t,
-      `Locator "${t}" resolved to no visible element. Check the selector matches at least one element and the element is inside the captured viewport.`
-    );
-  return o;
+async function he(e, t) {
+	let n = [];
+	for (let r of t) n.push(await me(e, r));
+	return n;
 }
-async function we(e, t) {
-  switch (t.type) {
-    case "rect": {
-      const o = t.bbox ?? await f(e, m(t.locator));
-      return { ...g(t), type: "rect", bbox: o };
-    }
-    case "circle": {
-      if (t.center !== void 0 && t.radius !== void 0)
-        return {
-          ...g(t),
-          type: "circle",
-          center: t.center,
-          radius: t.radius
-        };
-      const o = await f(e, m(t.locator));
-      return {
-        ...g(t),
-        type: "circle",
-        center: T(o),
-        radius: Math.min(o.width, o.height) / 2
-      };
-    }
-    case "arrow": {
-      const o = t.from ?? T(await f(e, m(t.fromLocator))), n = t.to ?? T(await f(e, m(t.toLocator)));
-      return {
-        ...g(t),
-        type: "arrow",
-        from: o,
-        to: n
-      };
-    }
-    case "text": {
-      const o = t.at ?? $e(
-        await f(e, m(t.locator)),
-        t.fontSize
-      ), n = {
-        ...g(t),
-        type: "text",
-        at: o,
-        content: t.content
-      };
-      return t.fontSize !== void 0 && (n.fontSize = t.fontSize), t.anchor !== void 0 && (n.anchor = t.anchor), n;
-    }
-    case "callout": {
-      const o = t.at ?? await ve(e, t.atLocator), n = t.targetBbox ?? await f(e, m(t.targetLocator));
-      return {
-        ...g(t),
-        type: "callout",
-        at: o,
-        targetBbox: n,
-        content: t.content
-      };
-    }
-    case "raw":
-      return t;
-  }
+async function ge(e, t) {
+	if (!t) throw new v("<callout.at>", "callout annotations require either `at` or `atLocator`.");
+	return b(await y(e, t));
 }
-async function be(e, t) {
-  const o = [];
-  for (const n of t)
-    o.push(await we(e, n));
-  return o;
+function b(e) {
+	return {
+		x: e.x + e.width / 2,
+		y: e.y + e.height / 2
+	};
 }
-async function ve(e, t) {
-  if (!t)
-    throw new N(
-      "<callout.at>",
-      "callout annotations require either `at` or `atLocator`."
-    );
-  const o = await f(e, t);
-  return T(o);
+function _e(e, t) {
+	let n = (t ?? 14) + 2;
+	return {
+		x: e.x,
+		y: Math.max(0, e.y - n)
+	};
 }
-function T(e) {
-  return { x: e.x + e.width / 2, y: e.y + e.height / 2 };
+function x(e) {
+	if (e === void 0) throw new v("<missing>", "Internal error: annotation passed schema validation without a locator or bbox. This is a bug.");
+	return e;
 }
-function $e(e, t) {
-  const o = (t ?? 14) + 2;
-  return { x: e.x, y: Math.max(0, e.y - o) };
+function S(e) {
+	if (e.type === "raw") return {};
+	let t = {};
+	return e.intent !== void 0 && (t.intent = e.intent), e.stroke !== void 0 && (t.stroke = e.stroke), e.strokeWidth !== void 0 && (t.strokeWidth = e.strokeWidth), e.fill !== void 0 && (t.fill = e.fill), e.color !== void 0 && (t.color = e.color), t;
 }
-function m(e) {
-  if (e === void 0)
-    throw new N(
-      "<missing>",
-      "Internal error: annotation passed schema validation without a locator or bbox. This is a bug."
-    );
-  return e;
+//#endregion
+//#region src/compare/aggregate.ts
+var ve = 4;
+function ye(e, t, n) {
+	let r = new Uint8Array(t * n), i = [];
+	for (let a = 0; a < n; a++) for (let o = 0; o < t; o++) {
+		let s = a * t + o;
+		if (r[s] || !be(e, s)) continue;
+		let c = xe(e, r, o, a, t, n);
+		c.count >= ve && i.push({
+			x: c.minX,
+			y: c.minY,
+			width: c.maxX - c.minX + 1,
+			height: c.maxY - c.minY + 1
+		});
+	}
+	return i;
 }
-function g(e) {
-  if (e.type === "raw")
-    return {};
-  const t = {};
-  return e.intent !== void 0 && (t.intent = e.intent), e.stroke !== void 0 && (t.stroke = e.stroke), e.strokeWidth !== void 0 && (t.strokeWidth = e.strokeWidth), e.fill !== void 0 && (t.fill = e.fill), e.color !== void 0 && (t.color = e.color), t;
+function be(e, t) {
+	return e[t * 4 + 3] > 0;
 }
-const Ee = 4;
-function xe(e, t, o) {
-  const n = new Uint8Array(t * o), s = [];
-  for (let c = 0; c < o; c++)
-    for (let r = 0; r < t; r++) {
-      const a = c * t + r;
-      if (n[a] || !X(e, a)) continue;
-      const i = Oe(e, n, r, c, t, o);
-      i.count >= Ee && s.push({
-        x: i.minX,
-        y: i.minY,
-        width: i.maxX - i.minX + 1,
-        height: i.maxY - i.minY + 1
-      });
-    }
-  return s;
+function xe(e, t, n, r, i, a) {
+	let o = {
+		count: 0,
+		minX: n,
+		minY: r,
+		maxX: n,
+		maxY: r
+	}, s = [n, r];
+	for (; s.length > 0;) {
+		let n = s.pop(), r = s.pop();
+		if (r < 0 || r >= i || n < 0 || n >= a) continue;
+		let c = n * i + r;
+		t[c] || be(e, c) && (t[c] = 1, o.count += 1, r < o.minX && (o.minX = r), n < o.minY && (o.minY = n), r > o.maxX && (o.maxX = r), n > o.maxY && (o.maxY = n), s.push(r + 1, n), s.push(r - 1, n), s.push(r, n + 1), s.push(r, n - 1));
+	}
+	return o;
 }
-function X(e, t) {
-  return e[t * 4 + 3] > 0;
+//#endregion
+//#region src/compare/diff.ts
+var Se = class extends Error {
+	constructor(e, t) {
+		super(`Cannot compare screenshots of different dimensions: before is ${e.width}×${e.height}, after is ${t.width}×${t.height}.`), this.name = "DimensionMismatchError";
+	}
+};
+async function C(e, t, n = {}) {
+	let [r, i] = await Promise.all([f(Buffer.from(e)), f(Buffer.from(t))]);
+	if (r.width !== i.width || r.height !== i.height) throw new Se({
+		width: r.width,
+		height: r.height
+	}, {
+		width: i.width,
+		height: i.height
+	});
+	let { width: a, height: o } = r, s = w(r, a, o), c = w(i, a, o), l = new Uint8Array(a * o * 4);
+	return {
+		mismatchedPixels: ee(s, c, l, a, o, {
+			threshold: n.threshold ?? .1,
+			includeAA: !1,
+			diffMask: !0
+		}),
+		regions: ye(l, a, o),
+		width: a,
+		height: o
+	};
 }
-function Oe(e, t, o, n, s, c) {
-  const r = {
-    count: 0,
-    minX: o,
-    minY: n,
-    maxX: o,
-    maxY: n
-  }, a = [o, n];
-  for (; a.length > 0; ) {
-    const i = a.pop(), d = a.pop();
-    if (d < 0 || d >= s || i < 0 || i >= c) continue;
-    const l = i * s + d;
-    t[l] || X(e, l) && (t[l] = 1, r.count += 1, d < r.minX && (r.minX = d), i < r.minY && (r.minY = i), d > r.maxX && (r.maxX = d), i > r.maxY && (r.maxY = i), a.push(d + 1, i), a.push(d - 1, i), a.push(d, i + 1), a.push(d, i - 1));
-  }
-  return r;
+function w(e, t, n) {
+	let r = d(t, n).getContext("2d");
+	r.drawImage(e, 0, 0);
+	let i = r.getImageData(0, 0, t, n).data;
+	return new Uint8Array(i.buffer, i.byteOffset, i.byteLength);
 }
-class Pe extends Error {
-  constructor(t, o) {
-    super(
-      `Cannot compare screenshots of different dimensions: before is ${t.width}×${t.height}, after is ${o.width}×${o.height}.`
-    ), this.name = "DimensionMismatchError";
-  }
+//#endregion
+//#region src/dsl/schema.ts
+var T = {
+	...r,
+	Locator: {
+		type: "string",
+		minLength: 1
+	}
+}, E = { oneOf: [
+	{
+		type: "object",
+		required: ["type"],
+		additionalProperties: !1,
+		properties: {
+			type: { const: "rect" },
+			bbox: { $ref: "#/$defs/BBox" },
+			locator: { $ref: "#/$defs/Locator" },
+			intent: { $ref: "#/$defs/Intent" },
+			stroke: { type: "string" },
+			strokeWidth: {
+				type: "number",
+				minimum: 0
+			},
+			fill: { type: "string" },
+			color: { type: "string" }
+		},
+		anyOf: [{ required: ["bbox"] }, { required: ["locator"] }]
+	},
+	{
+		type: "object",
+		required: ["type"],
+		additionalProperties: !1,
+		properties: {
+			type: { const: "circle" },
+			center: { $ref: "#/$defs/Point" },
+			radius: {
+				type: "number",
+				minimum: 0
+			},
+			locator: { $ref: "#/$defs/Locator" },
+			intent: { $ref: "#/$defs/Intent" },
+			stroke: { type: "string" },
+			strokeWidth: {
+				type: "number",
+				minimum: 0
+			},
+			fill: { type: "string" },
+			color: { type: "string" }
+		},
+		anyOf: [{ required: ["center", "radius"] }, { required: ["locator"] }]
+	},
+	{
+		type: "object",
+		required: ["type"],
+		additionalProperties: !1,
+		properties: {
+			type: { const: "arrow" },
+			from: { $ref: "#/$defs/Point" },
+			fromLocator: { $ref: "#/$defs/Locator" },
+			to: { $ref: "#/$defs/Point" },
+			toLocator: { $ref: "#/$defs/Locator" },
+			intent: { $ref: "#/$defs/Intent" },
+			stroke: { type: "string" },
+			strokeWidth: {
+				type: "number",
+				minimum: 0
+			},
+			color: { type: "string" }
+		},
+		allOf: [{ anyOf: [{ required: ["from"] }, { required: ["fromLocator"] }] }, { anyOf: [{ required: ["to"] }, { required: ["toLocator"] }] }]
+	},
+	{
+		type: "object",
+		required: ["type", "content"],
+		additionalProperties: !1,
+		properties: {
+			type: { const: "text" },
+			at: { $ref: "#/$defs/Point" },
+			locator: { $ref: "#/$defs/Locator" },
+			content: { type: "string" },
+			fontSize: {
+				type: "number",
+				minimum: 0
+			},
+			anchor: {
+				type: "string",
+				enum: [
+					"start",
+					"middle",
+					"end"
+				]
+			},
+			intent: { $ref: "#/$defs/Intent" },
+			color: { type: "string" }
+		},
+		anyOf: [{ required: ["at"] }, { required: ["locator"] }]
+	},
+	{
+		type: "object",
+		required: ["type", "content"],
+		additionalProperties: !1,
+		properties: {
+			type: { const: "callout" },
+			at: { $ref: "#/$defs/Point" },
+			atLocator: { $ref: "#/$defs/Locator" },
+			targetBbox: { $ref: "#/$defs/BBox" },
+			targetLocator: { $ref: "#/$defs/Locator" },
+			content: { type: "string" },
+			intent: { $ref: "#/$defs/Intent" },
+			stroke: { type: "string" },
+			color: { type: "string" }
+		},
+		allOf: [{ anyOf: [{ required: ["at"] }, { required: ["atLocator"] }] }, { anyOf: [{ required: ["targetBbox"] }, { required: ["targetLocator"] }] }]
+	},
+	{
+		type: "object",
+		required: ["type", "svgFragment"],
+		additionalProperties: !1,
+		properties: {
+			type: { const: "raw" },
+			svgFragment: { type: "string" }
+		}
+	}
+] }, D = {
+	type: "object",
+	additionalProperties: !1,
+	properties: {
+		format: {
+			type: "string",
+			enum: [
+				"smart",
+				"png",
+				"jpeg"
+			],
+			description: "Encoding strategy. `smart` (default) picks PNG-8 for UI-heavy content and PNG-32 / JPEG for photo-heavy content per `smartFallback`. `png` forces PNG-32 (lossless). `jpeg` forces JPEG at `jpegPercent` quality."
+		},
+		saveSizePreset: {
+			type: "string",
+			enum: [
+				"light",
+				"standard",
+				"highQuality",
+				"original"
+			],
+			description: "Max-width cap. `light` = 1280px, `standard` = 1920px (default), `highQuality` = 2560px, `original` = no resize. Aspect-preserving; never upscales."
+		},
+		smartFallback: {
+			type: "string",
+			enum: ["png", "jpeg"],
+			description: "Fallback format used by smart mode when the image is photo-heavy. Default `png`."
+		},
+		smartColorThreshold: {
+			type: "integer",
+			minimum: 1,
+			description: "Unique-colour count above which smart mode treats the image as photo-heavy. Default 15000."
+		},
+		jpegPercent: {
+			type: "integer",
+			minimum: 60,
+			maximum: 100,
+			description: "JPEG quality 60–100. Default 92."
+		}
+	}
+}, Ce = {
+	type: "object",
+	additionalProperties: !1,
+	properties: {
+		bbox: { $ref: "#/$defs/BBox" },
+		locator: { $ref: "#/$defs/Locator" },
+		style: {
+			type: "string",
+			enum: [
+				"solid",
+				"mosaic",
+				"blur"
+			]
+		},
+		color: { type: "string" }
+	},
+	anyOf: [{ required: ["bbox"] }, { required: ["locator"] }]
+}, we = [
+	137,
+	80,
+	78,
+	71,
+	13,
+	10,
+	26,
+	10
+], O = 12, Te = "IHDR", Ee = 16, De = 20, Oe = 24, k = class extends Error {
+	constructor(e) {
+		super(e), this.name = "InvalidPngError";
+	}
+};
+function A(e) {
+	if (e.byteLength < Oe) throw new k(`Expected at least ${Oe} bytes for a PNG header, got ${e.byteLength}.`);
+	for (let t = 0; t < we.length; t++) if (e[t] !== we[t]) throw new k("Input does not start with the PNG signature (89 50 4E 47 0D 0A 1A 0A). Confirm the input is a PNG — JPEG / WebP / other formats are not supported in v1.");
+	let t = new DataView(e.buffer, e.byteOffset, e.byteLength), n = String.fromCharCode(e[O], e[O + 1], e[O + 2], e[O + 3]);
+	if (n !== Te) throw new k(`Expected IHDR chunk after PNG signature, found "${n}". The file may be a corrupt or non-standard PNG.`);
+	let r = t.getUint32(Ee, !1), i = t.getUint32(De, !1);
+	if (r === 0 || i === 0) throw new k(`PNG dimensions ${r}×${i} include a zero axis.`);
+	return {
+		width: r,
+		height: i
+	};
 }
-async function Se(e, t, o = {}) {
-  const [n, s] = await Promise.all([
-    C(Buffer.from(e)),
-    C(Buffer.from(t))
-  ]);
-  if (n.width !== s.width || n.height !== s.height)
-    throw new Pe(
-      { width: n.width, height: n.height },
-      { width: s.width, height: s.height }
-    );
-  const { width: c, height: r } = n, a = k(n, c, r), i = k(s, c, r), d = new Uint8Array(c * r * 4), l = ae(a, i, d, c, r, {
-    threshold: o.threshold ?? 0.1,
-    includeAA: !1,
-    diffMask: !0
-  }), v = xe(d, c, r);
-  return { mismatchedPixels: l, regions: v, width: c, height: r };
+//#endregion
+//#region src/io/read-image.ts
+var j = class extends Error {
+	constructor(e) {
+		super(e), this.name = "InvalidImageInputError";
+	}
+}, ke = "data:", Ae = /^data:image\/png;base64,/i;
+async function M(e) {
+	if (typeof e != "string" || e.length === 0) throw new j("`image` must be a non-empty string (data URL or absolute filesystem path).");
+	if (e.startsWith(ke)) return je(e);
+	if (!m(e)) throw new j(`Filesystem path "${e}" is not absolute. Pass an absolute path so resolution doesn't depend on the MCP server's working directory.`);
+	return Me(e);
 }
-function k(e, t, o) {
-  const s = F(t, o).getContext("2d");
-  s.drawImage(e, 0, 0);
-  const c = s.getImageData(0, 0, t, o).data;
-  return new Uint8Array(c.buffer, c.byteOffset, c.byteLength);
+function je(e) {
+	if (!Ae.test(e)) throw new j("Only `data:image/png;base64,...` URLs are supported. JPEG / WebP / SVG data URLs are not accepted in v1.");
+	let t = Pe(e.slice(e.indexOf(",") + 1));
+	return {
+		bytes: t,
+		dataUrl: e,
+		dimensions: Ne(t)
+	};
 }
-const I = {
-  ...te,
-  Locator: { type: "string", minLength: 1 }
-}, Le = {
-  type: "object",
-  required: ["type"],
-  additionalProperties: !1,
-  properties: {
-    type: { const: "rect" },
-    bbox: { $ref: "#/$defs/BBox" },
-    locator: { $ref: "#/$defs/Locator" },
-    intent: { $ref: "#/$defs/Intent" },
-    stroke: { type: "string" },
-    strokeWidth: { type: "number", minimum: 0 },
-    fill: { type: "string" },
-    color: { type: "string" }
-  },
-  anyOf: [{ required: ["bbox"] }, { required: ["locator"] }]
-}, Ae = {
-  type: "object",
-  required: ["type"],
-  additionalProperties: !1,
-  properties: {
-    type: { const: "circle" },
-    center: { $ref: "#/$defs/Point" },
-    radius: { type: "number", minimum: 0 },
-    locator: { $ref: "#/$defs/Locator" },
-    intent: { $ref: "#/$defs/Intent" },
-    stroke: { type: "string" },
-    strokeWidth: { type: "number", minimum: 0 },
-    fill: { type: "string" },
-    color: { type: "string" }
-  },
-  anyOf: [{ required: ["center", "radius"] }, { required: ["locator"] }]
-}, Te = {
-  type: "object",
-  required: ["type"],
-  additionalProperties: !1,
-  properties: {
-    type: { const: "arrow" },
-    from: { $ref: "#/$defs/Point" },
-    fromLocator: { $ref: "#/$defs/Locator" },
-    to: { $ref: "#/$defs/Point" },
-    toLocator: { $ref: "#/$defs/Locator" },
-    intent: { $ref: "#/$defs/Intent" },
-    stroke: { type: "string" },
-    strokeWidth: { type: "number", minimum: 0 },
-    color: { type: "string" }
-  },
-  allOf: [
-    { anyOf: [{ required: ["from"] }, { required: ["fromLocator"] }] },
-    { anyOf: [{ required: ["to"] }, { required: ["toLocator"] }] }
-  ]
-}, Re = {
-  type: "object",
-  required: ["type", "content"],
-  additionalProperties: !1,
-  properties: {
-    type: { const: "text" },
-    at: { $ref: "#/$defs/Point" },
-    locator: { $ref: "#/$defs/Locator" },
-    content: { type: "string" },
-    fontSize: { type: "number", minimum: 0 },
-    anchor: { type: "string", enum: ["start", "middle", "end"] },
-    intent: { $ref: "#/$defs/Intent" },
-    color: { type: "string" }
-  },
-  anyOf: [{ required: ["at"] }, { required: ["locator"] }]
-}, Ie = {
-  type: "object",
-  required: ["type", "content"],
-  additionalProperties: !1,
-  properties: {
-    type: { const: "callout" },
-    at: { $ref: "#/$defs/Point" },
-    atLocator: { $ref: "#/$defs/Locator" },
-    targetBbox: { $ref: "#/$defs/BBox" },
-    targetLocator: { $ref: "#/$defs/Locator" },
-    content: { type: "string" },
-    intent: { $ref: "#/$defs/Intent" },
-    stroke: { type: "string" },
-    color: { type: "string" }
-  },
-  allOf: [
-    { anyOf: [{ required: ["at"] }, { required: ["atLocator"] }] },
-    { anyOf: [{ required: ["targetBbox"] }, { required: ["targetLocator"] }] }
-  ]
-}, _e = {
-  type: "object",
-  required: ["type", "svgFragment"],
-  additionalProperties: !1,
-  properties: {
-    type: { const: "raw" },
-    svgFragment: { type: "string" }
-  }
-}, Ce = {
-  oneOf: [Le, Ae, Te, Re, Ie, _e]
-}, P = {
-  type: "object",
-  additionalProperties: !1,
-  properties: {
-    format: {
-      type: "string",
-      enum: ["smart", "png", "jpeg"],
-      description: "Encoding strategy. `smart` (default) picks PNG-8 for UI-heavy content and PNG-32 / JPEG for photo-heavy content per `smartFallback`. `png` forces PNG-32 (lossless). `jpeg` forces JPEG at `jpegPercent` quality."
-    },
-    saveSizePreset: {
-      type: "string",
-      enum: ["light", "standard", "highQuality", "original"],
-      description: "Max-width cap. `light` = 1280px, `standard` = 1920px (default), `highQuality` = 2560px, `original` = no resize. Aspect-preserving; never upscales."
-    },
-    smartFallback: {
-      type: "string",
-      enum: ["png", "jpeg"],
-      description: "Fallback format used by smart mode when the image is photo-heavy. Default `png`."
-    },
-    smartColorThreshold: {
-      type: "integer",
-      minimum: 1,
-      description: "Unique-colour count above which smart mode treats the image as photo-heavy. Default 15000."
-    },
-    jpegPercent: {
-      type: "integer",
-      minimum: 60,
-      maximum: 100,
-      description: "JPEG quality 60–100. Default 92."
-    }
-  }
-}, Ue = {
-  type: "object",
-  additionalProperties: !1,
-  properties: {
-    bbox: { $ref: "#/$defs/BBox" },
-    locator: { $ref: "#/$defs/Locator" },
-    style: { type: "string", enum: ["solid", "mosaic", "blur"] },
-    color: { type: "string" }
-  },
-  anyOf: [{ required: ["bbox"] }, { required: ["locator"] }]
-}, j = [137, 80, 78, 71, 13, 10, 26, 10], L = 12, Fe = "IHDR", Ne = 16, Be = 20, G = 24;
-class x extends Error {
-  constructor(t) {
-    super(t), this.name = "InvalidPngError";
-  }
+async function Me(e) {
+	let t;
+	try {
+		let n = await te(e);
+		t = new Uint8Array(n.buffer, n.byteOffset, n.byteLength);
+	} catch (t) {
+		throw new j(`Failed to read image at "${e}": ${t instanceof Error ? t.message : String(t)}`);
+	}
+	let n = Ne(t), r = `data:image/png;base64,${Fe(t)}`;
+	return {
+		bytes: t,
+		dataUrl: r,
+		dimensions: n
+	};
 }
-function B(e) {
-  if (e.byteLength < G)
-    throw new x(
-      `Expected at least ${G} bytes for a PNG header, got ${e.byteLength}.`
-    );
-  for (let c = 0; c < j.length; c++)
-    if (e[c] !== j[c])
-      throw new x(
-        "Input does not start with the PNG signature (89 50 4E 47 0D 0A 1A 0A). Confirm the input is a PNG — JPEG / WebP / other formats are not supported in v1."
-      );
-  const t = new DataView(e.buffer, e.byteOffset, e.byteLength), o = String.fromCharCode(
-    e[L],
-    e[L + 1],
-    e[L + 2],
-    e[L + 3]
-  );
-  if (o !== Fe)
-    throw new x(
-      `Expected IHDR chunk after PNG signature, found "${o}". The file may be a corrupt or non-standard PNG.`
-    );
-  const n = t.getUint32(Ne, !1), s = t.getUint32(Be, !1);
-  if (n === 0 || s === 0)
-    throw new x(`PNG dimensions ${n}×${s} include a zero axis.`);
-  return { width: n, height: s };
+function Ne(e) {
+	try {
+		return A(e);
+	} catch (e) {
+		throw e instanceof k ? new j(e.message) : e;
+	}
 }
-class w extends Error {
-  constructor(t) {
-    super(t), this.name = "InvalidImageInputError";
-  }
+function Pe(e) {
+	let t = Buffer.from(e, "base64");
+	return new Uint8Array(t.buffer, t.byteOffset, t.byteLength);
 }
-const De = "data:", qe = /^data:image\/png;base64,/i;
-async function R(e) {
-  if (typeof e != "string" || e.length === 0)
-    throw new w(
-      "`image` must be a non-empty string (data URL or absolute filesystem path)."
-    );
-  if (e.startsWith(De))
-    return ke(e);
-  if (!b(e))
-    throw new w(
-      `Filesystem path "${e}" is not absolute. Pass an absolute path so resolution doesn't depend on the MCP server's working directory.`
-    );
-  return je(e);
+function Fe(e) {
+	return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
 }
-function ke(e) {
-  if (!qe.test(e))
-    throw new w(
-      "Only `data:image/png;base64,...` URLs are supported. JPEG / WebP / SVG data URLs are not accepted in v1."
-    );
-  const t = e.slice(e.indexOf(",") + 1), o = Ge(t), n = z(o);
-  return { bytes: o, dataUrl: e, dimensions: n };
+//#endregion
+//#region src/redact/burn.ts
+var Ie = "solid", Le = "#000000", Re = 16, ze = 12;
+async function N(e, t) {
+	if (t.length === 0) return e;
+	let n = await f(Buffer.from(e)), r = d(n.width, n.height), i = r.getContext("2d");
+	i.drawImage(n, 0, 0);
+	for (let e of t) if (!(e.bbox.width <= 0 || e.bbox.height <= 0)) switch (e.style ?? Ie) {
+		case "solid":
+			Be(i, e.bbox, e.color ?? Le);
+			break;
+		case "mosaic":
+			Ve(i, n, e.bbox);
+			break;
+		case "blur":
+			He(i, n, e.bbox);
+			break;
+	}
+	let a = r.toBuffer("image/png");
+	return new Uint8Array(a.buffer, a.byteOffset, a.byteLength);
 }
-async function je(e) {
-  let t;
-  try {
-    const s = await ce(e);
-    t = new Uint8Array(s.buffer, s.byteOffset, s.byteLength);
-  } catch (s) {
-    const c = s instanceof Error ? s.message : String(s);
-    throw new w(`Failed to read image at "${e}": ${c}`);
-  }
-  const o = z(t), n = `data:image/png;base64,${Me(t)}`;
-  return { bytes: t, dataUrl: n, dimensions: o };
+function Be(e, t, n) {
+	e.save(), e.fillStyle = n, e.fillRect(t.x, t.y, t.width, t.height), e.restore();
 }
-function z(e) {
-  try {
-    return B(e);
-  } catch (t) {
-    throw t instanceof x ? new w(t.message) : t;
-  }
+function Ve(e, t, n) {
+	let r = Math.max(1, Math.round(n.width / Re)), i = Math.max(1, Math.round(n.height / Re)), a = d(r, i), o = a.getContext("2d");
+	o.imageSmoothingEnabled = !1, o.drawImage(t, n.x, n.y, n.width, n.height, 0, 0, r, i), e.save(), e.imageSmoothingEnabled = !1, e.drawImage(a, 0, 0, r, i, n.x, n.y, n.width, n.height), e.restore();
 }
-function Ge(e) {
-  const t = Buffer.from(e, "base64");
-  return new Uint8Array(t.buffer, t.byteOffset, t.byteLength);
+function He(e, t, n) {
+	e.save(), e.beginPath(), e.rect(n.x, n.y, n.width, n.height), e.clip(), e.filter = `blur(${ze}px)`, e.drawImage(t, 0, 0), e.restore();
 }
-function Me(e) {
-  return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
+//#endregion
+//#region src/io/encode-output.ts
+async function P(e, t, r) {
+	if (!r || Object.keys(r).length === 0) return {
+		bytes: e,
+		mimeType: "image/png",
+		chosen: "png",
+		width: t.width,
+		height: t.height
+	};
+	let i = await c(e, {
+		...n,
+		...r
+	});
+	return {
+		bytes: i.bytes,
+		mimeType: i.chosen === "jpeg" ? "image/jpeg" : "image/png",
+		chosen: i.chosen,
+		width: i.width,
+		height: i.height,
+		...i.reason ? { reason: i.reason } : {}
+	};
 }
-const He = "solid", We = "#000000", M = 16, Xe = 12;
-async function Y(e, t) {
-  if (t.length === 0)
-    return e;
-  const o = await C(Buffer.from(e)), n = F(o.width, o.height), s = n.getContext("2d");
-  s.drawImage(o, 0, 0);
-  for (const r of t) {
-    if (r.bbox.width <= 0 || r.bbox.height <= 0) continue;
-    switch (r.style ?? He) {
-      case "solid":
-        ze(s, r.bbox, r.color ?? We);
-        break;
-      case "mosaic":
-        Ye(s, o, r.bbox);
-        break;
-      case "blur":
-        Ve(s, o, r.bbox);
-        break;
-    }
-  }
-  const c = n.toBuffer("image/png");
-  return new Uint8Array(c.buffer, c.byteOffset, c.byteLength);
-}
-function ze(e, t, o) {
-  e.save(), e.fillStyle = o, e.fillRect(t.x, t.y, t.width, t.height), e.restore();
+//#endregion
+//#region src/tools/annotate-screenshot.ts
+var F = "annot_annotate_screenshot", I = {
+	name: F,
+	description: "Overlay annotations (rectangles, circles, arrows, callouts, text) on a PNG screenshot. Annotation positions are specified as bounding boxes or points; pair with `annot_annotate_url` if you want locator-driven positioning. Returns the annotated PNG inline unless `output` is specified, in which case the PNG is written to that absolute path.",
+	inputSchema: {
+		type: "object",
+		required: ["image", "annotations"],
+		additionalProperties: !1,
+		properties: {
+			image: {
+				type: "string",
+				description: "Source image. Either a `data:image/png;base64,...` URL or an absolute filesystem path to a PNG file."
+			},
+			annotations: {
+				type: "array",
+				items: { $ref: "#/$defs/BboxAnnotation" },
+				description: "Ordered list of annotations to overlay. Each annotation declares its shape, position, and (optionally) an `intent` shorthand for the colour theme (`info` | `warning` | `error` | `success` | `neutral`)."
+			},
+			output: {
+				type: "string",
+				description: "Optional absolute filesystem path. When set, the annotated PNG is written here and the tool returns a text confirmation; otherwise the PNG bytes are returned inline."
+			},
+			encode: {
+				$ref: "#/$defs/EncodeOptions",
+				description: "Optional encoder settings. When set, the output PNG-32 is decoded and re-encoded per `format` / `saveSizePreset` for size savings — `format: \"smart\"` + `saveSizePreset: \"standard\"` gives ~50–80% byte reduction typical for UI screenshots."
+			}
+		},
+		$defs: {
+			...T,
+			BboxAnnotation: e,
+			EncodeOptions: D
+		}
+	}
+};
+async function L(e, t) {
+	try {
+		let n = Ue(e), r = await M(n.image), i = o(n.annotations), a = await P(t.annotator.toPng({
+			originalDataUrl: r.dataUrl,
+			annotationsSvg: i,
+			width: r.dimensions.width,
+			height: r.dimensions.height
+		}), r.dimensions, n.encode);
+		if (n.output) {
+			await p(n.output, a.bytes);
+			let e = a.reason ? `, reason: ${a.reason}` : "";
+			return { content: [{
+				type: "text",
+				text: `Wrote ${a.bytes.byteLength}-byte ${a.chosen.toUpperCase()} to ${n.output} (${a.width}×${a.height}, ${n.annotations.length} annotation${n.annotations.length === 1 ? "" : "s"}${e}).`
+			}] };
+		}
+		return { content: [{
+			type: "image",
+			data: Ge(a.bytes),
+			mimeType: a.mimeType
+		}] };
+	} catch (e) {
+		return We(e);
+	}
 }
-function Ye(e, t, o) {
-  const n = Math.max(1, Math.round(o.width / M)), s = Math.max(1, Math.round(o.height / M)), c = F(n, s), r = c.getContext("2d");
-  r.imageSmoothingEnabled = !1, r.drawImage(t, o.x, o.y, o.width, o.height, 0, 0, n, s), e.save(), e.imageSmoothingEnabled = !1, e.drawImage(c, 0, 0, n, s, o.x, o.y, o.width, o.height), e.restore();
+function Ue(e) {
+	if (typeof e.image != "string") throw new j("`image` is required and must be a string.");
+	if (!Array.isArray(e.annotations)) throw new R("`annotations` is required and must be an array.");
+	let t = e.annotations, n;
+	if (e.output !== void 0) {
+		if (typeof e.output != "string") throw new R("`output` must be a string when provided.");
+		if (!m(e.output)) throw new R(`\`output\` path "${e.output}" must be absolute so the file lands at a predictable location.`);
+		n = e.output;
+	}
+	let r;
+	if (e.encode !== void 0) {
+		if (typeof e.encode != "object" || e.encode === null) throw new R("`encode` must be an object when provided.");
+		r = e.encode;
+	}
+	return {
+		image: e.image,
+		annotations: t,
+		output: n,
+		encode: r
+	};
 }
-function Ve(e, t, o) {
-  e.save(), e.beginPath(), e.rect(o.x, o.y, o.width, o.height), e.clip(), e.filter = `blur(${Xe}px)`, e.drawImage(t, 0, 0), e.restore();
+var R = class extends Error {
+	constructor(e) {
+		super(e), this.name = "InvalidToolInputError";
+	}
+};
+function We(e) {
+	return {
+		content: [{
+			type: "text",
+			text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}`
+		}],
+		isError: !0
+	};
 }
-async function S(e, t, o) {
-  if (!o || Object.keys(o).length === 0)
-    return {
-      bytes: e,
-      mimeType: "image/png",
-      chosen: "png",
-      width: t.width,
-      height: t.height
-    };
-  const n = { ...oe, ...o }, s = await re(e, n);
-  return {
-    bytes: s.bytes,
-    mimeType: s.chosen === "jpeg" ? "image/jpeg" : "image/png",
-    chosen: s.chosen,
-    width: s.width,
-    height: s.height,
-    ...s.reason ? { reason: s.reason } : {}
-  };
+function Ge(e) {
+	return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
 }
-const V = "annot_annotate_screenshot", Je = {
-  name: V,
-  description: "Overlay annotations (rectangles, circles, arrows, callouts, text) on a PNG screenshot. Annotation positions are specified as bounding boxes or points; pair with `annot_annotate_url` if you want locator-driven positioning. Returns the annotated PNG inline unless `output` is specified, in which case the PNG is written to that absolute path.",
-  inputSchema: {
-    type: "object",
-    required: ["image", "annotations"],
-    additionalProperties: !1,
-    properties: {
-      image: {
-        type: "string",
-        description: "Source image. Either a `data:image/png;base64,...` URL or an absolute filesystem path to a PNG file."
-      },
-      annotations: {
-        type: "array",
-        items: { $ref: "#/$defs/BboxAnnotation" },
-        description: "Ordered list of annotations to overlay. Each annotation declares its shape, position, and (optionally) an `intent` shorthand for the colour theme (`info` | `warning` | `error` | `success` | `neutral`)."
-      },
-      output: {
-        type: "string",
-        description: "Optional absolute filesystem path. When set, the annotated PNG is written here and the tool returns a text confirmation; otherwise the PNG bytes are returned inline."
-      },
-      encode: {
-        $ref: "#/$defs/EncodeOptions",
-        description: 'Optional encoder settings. When set, the output PNG-32 is decoded and re-encoded per `format` / `saveSizePreset` for size savings — `format: "smart"` + `saveSizePreset: "standard"` gives ~50–80% byte reduction typical for UI screenshots.'
-      }
-    },
-    $defs: {
-      ...I,
-      BboxAnnotation: ne,
-      EncodeOptions: P
-    }
-  }
+//#endregion
+//#region src/tools/annotate-url.ts
+var z = "annot_annotate_url", B = {
+	name: z,
+	description: "Open a URL in a headless browser, capture a screenshot, and overlay annotations whose positions are specified as Playwright locator strings (`button:has-text(\"Submit\")`, `[data-testid=\"email\"]`, `role=button[name=\"Sign in\"]`) or bounding boxes. Returns the annotated PNG inline unless `output` is specified.",
+	inputSchema: {
+		type: "object",
+		required: ["url", "annotations"],
+		additionalProperties: !1,
+		properties: {
+			url: {
+				type: "string",
+				format: "uri",
+				description: "Page URL to capture."
+			},
+			annotations: {
+				type: "array",
+				items: { $ref: "#/$defs/LocatorAnnotation" },
+				description: "Ordered list of annotations to overlay. Each annotation declares its shape and position via `bbox` / `from` / `to` / `at` (coordinate path) or `locator` / `fromLocator` / `toLocator` / `atLocator` (Playwright locator string)."
+			},
+			viewport: {
+				type: "object",
+				additionalProperties: !1,
+				properties: {
+					width: {
+						type: "integer",
+						minimum: 1,
+						default: 1280
+					},
+					height: {
+						type: "integer",
+						minimum: 1,
+						default: 800
+					},
+					deviceScaleFactor: {
+						type: "number",
+						minimum: .1,
+						default: 1
+					}
+				},
+				description: "Viewport size. Default 1280×800 at 1× device pixel ratio."
+			},
+			fullPage: {
+				type: "boolean",
+				default: !1,
+				description: "Capture the full scrollable page rather than just the visible viewport. Locator resolution still depends on the actual DOM layout — off-viewport locators only resolve when `fullPage` is true."
+			},
+			waitFor: {
+				type: "string",
+				enum: [
+					"load",
+					"domcontentloaded",
+					"networkidle"
+				],
+				default: "load"
+			},
+			output: {
+				type: "string",
+				description: "Optional absolute filesystem path. When set, the annotated PNG is written here and the tool returns a text confirmation."
+			},
+			encode: {
+				$ref: "#/$defs/EncodeOptions",
+				description: "Optional encoder settings (`format` / `saveSizePreset` / `jpegPercent`). Set to shrink the output for ingestion into issue trackers / docs."
+			}
+		},
+		$defs: {
+			...T,
+			LocatorAnnotation: E,
+			EncodeOptions: D
+		}
+	}
+}, V = class extends Error {
+	constructor(e) {
+		super(e), this.name = "InvalidAnnotateUrlInputError";
+	}
 };
-async function Qe(e, t) {
-  try {
-    const o = Ke(e), n = await R(o.image), s = U(o.annotations), c = t.annotator.toPng({
-      originalDataUrl: n.dataUrl,
-      annotationsSvg: s,
-      width: n.dimensions.width,
-      height: n.dimensions.height
-    }), r = await S(c, n.dimensions, o.encode);
-    if (o.output) {
-      await O(o.output, r.bytes);
-      const a = r.reason ? `, reason: ${r.reason}` : "";
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Wrote ${r.bytes.byteLength}-byte ${r.chosen.toUpperCase()} to ${o.output} (${r.width}×${r.height}, ${o.annotations.length} annotation${o.annotations.length === 1 ? "" : "s"}${a}).`
-          }
-        ]
-      };
-    }
-    return {
-      content: [
-        {
-          type: "image",
-          data: et(r.bytes),
-          mimeType: r.mimeType
-        }
-      ]
-    };
-  } catch (o) {
-    return Ze(o);
-  }
+async function Ke(e, t) {
+	try {
+		let n = qe(e), r = await h(t.pool, {
+			url: n.url,
+			viewport: n.viewport,
+			fullPage: n.fullPage,
+			waitFor: n.waitFor
+		}), i;
+		try {
+			i = await he(r.handle.page, n.annotations);
+		} finally {
+			await r.handle.close();
+		}
+		let a = A(r.pngBytes), s = o(i), c = await P(t.annotator.toPng({
+			originalDataUrl: `data:image/png;base64,${Ye(r.pngBytes)}`,
+			annotationsSvg: s,
+			width: a.width,
+			height: a.height
+		}), a, n.encode);
+		if (n.output) {
+			await p(n.output, c.bytes);
+			let e = c.reason ? `, reason: ${c.reason}` : "";
+			return { content: [{
+				type: "text",
+				text: `Wrote ${c.bytes.byteLength}-byte ${c.chosen.toUpperCase()} to ${n.output} (${c.width}×${c.height}, ${n.annotations.length} annotation${n.annotations.length === 1 ? "" : "s"}, captured from ${n.url}${e}).`
+			}] };
+		}
+		return { content: [{
+			type: "image",
+			data: Ye(c.bytes),
+			mimeType: c.mimeType
+		}] };
+	} catch (e) {
+		return Je(e);
+	}
 }
-function Ke(e) {
-  if (typeof e.image != "string")
-    throw new w("`image` is required and must be a string.");
-  if (!Array.isArray(e.annotations))
-    throw new A("`annotations` is required and must be an array.");
-  const t = e.annotations;
-  let o;
-  if (e.output !== void 0) {
-    if (typeof e.output != "string")
-      throw new A("`output` must be a string when provided.");
-    if (!b(e.output))
-      throw new A(
-        `\`output\` path "${e.output}" must be absolute so the file lands at a predictable location.`
-      );
-    o = e.output;
-  }
-  let n;
-  if (e.encode !== void 0) {
-    if (typeof e.encode != "object" || e.encode === null)
-      throw new A("`encode` must be an object when provided.");
-    n = e.encode;
-  }
-  return { image: e.image, annotations: t, output: o, encode: n };
+function qe(e) {
+	if (typeof e.url != "string" || e.url.length === 0) throw new V("`url` is required and must be a non-empty string.");
+	if (!Array.isArray(e.annotations)) throw new V("`annotations` is required and must be an array.");
+	let t = e.annotations, n;
+	if (e.viewport !== void 0) {
+		if (typeof e.viewport != "object" || e.viewport === null) throw new V("`viewport` must be an object when provided.");
+		let t = e.viewport;
+		n = {
+			width: typeof t.width == "number" ? t.width : 1280,
+			height: typeof t.height == "number" ? t.height : 800,
+			deviceScaleFactor: typeof t.deviceScaleFactor == "number" ? t.deviceScaleFactor : 1
+		};
+	}
+	let r = e.fullPage === !0, i = e.waitFor === "domcontentloaded" || e.waitFor === "networkidle" ? e.waitFor : "load", a;
+	if (e.output !== void 0) {
+		if (typeof e.output != "string") throw new V("`output` must be a string when provided.");
+		if (!m(e.output)) throw new V(`\`output\` path "${e.output}" must be absolute.`);
+		a = e.output;
+	}
+	let o;
+	if (e.encode !== void 0) {
+		if (typeof e.encode != "object" || e.encode === null) throw new V("`encode` must be an object when provided.");
+		o = e.encode;
+	}
+	return {
+		url: e.url,
+		annotations: t,
+		viewport: n,
+		fullPage: r,
+		waitFor: i,
+		output: a,
+		encode: o
+	};
 }
-class A extends Error {
-  constructor(t) {
-    super(t), this.name = "InvalidToolInputError";
-  }
+function Je(e) {
+	return {
+		content: [{
+			type: "text",
+			text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}`
+		}],
+		isError: !0
+	};
 }
-function Ze(e) {
-  return {
-    content: [{ type: "text", text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}` }],
-    isError: !0
-  };
+function Ye(e) {
+	return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
 }
-function et(e) {
-  return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
+//#endregion
+//#region src/browser/aria-snapshot.ts
+var Xe = {
+	width: 1280,
+	height: 800,
+	deviceScaleFactor: 1
+}, Ze = "load", Qe = "body";
+async function H(e, t) {
+	let n = {
+		...Xe,
+		...t.viewport
+	}, r = t.waitFor ?? Ze, i = t.rootSelector ?? Qe, a = await e.acquire(), o, s = !1, c = () => {
+		s || (s = !0, e.release());
+	};
+	try {
+		o = await a.newContext({
+			viewport: {
+				width: n.width,
+				height: n.height
+			},
+			deviceScaleFactor: n.deviceScaleFactor
+		});
+		let e = await o.newPage();
+		await e.goto(t.url, { waitUntil: r });
+		let s = await e.locator(i).ariaSnapshot({
+			mode: "ai",
+			...t.timeout === void 0 ? {} : { timeout: t.timeout }
+		});
+		return await o.close(), c(), { yaml: s };
+	} catch (e) {
+		if (o) try {
+			await o.close();
+		} catch {}
+		throw c(), e;
+	}
 }
-const J = "annot_annotate_url", tt = {
-  name: J,
-  description: 'Open a URL in a headless browser, capture a screenshot, and overlay annotations whose positions are specified as Playwright locator strings (`button:has-text("Submit")`, `[data-testid="email"]`, `role=button[name="Sign in"]`) or bounding boxes. Returns the annotated PNG inline unless `output` is specified.',
-  inputSchema: {
-    type: "object",
-    required: ["url", "annotations"],
-    additionalProperties: !1,
-    properties: {
-      url: {
-        type: "string",
-        format: "uri",
-        description: "Page URL to capture."
-      },
-      annotations: {
-        type: "array",
-        items: { $ref: "#/$defs/LocatorAnnotation" },
-        description: "Ordered list of annotations to overlay. Each annotation declares its shape and position via `bbox` / `from` / `to` / `at` (coordinate path) or `locator` / `fromLocator` / `toLocator` / `atLocator` (Playwright locator string)."
-      },
-      viewport: {
-        type: "object",
-        additionalProperties: !1,
-        properties: {
-          width: { type: "integer", minimum: 1, default: 1280 },
-          height: { type: "integer", minimum: 1, default: 800 },
-          deviceScaleFactor: { type: "number", minimum: 0.1, default: 1 }
-        },
-        description: "Viewport size. Default 1280×800 at 1× device pixel ratio."
-      },
-      fullPage: {
-        type: "boolean",
-        default: !1,
-        description: "Capture the full scrollable page rather than just the visible viewport. Locator resolution still depends on the actual DOM layout — off-viewport locators only resolve when `fullPage` is true."
-      },
-      waitFor: {
-        type: "string",
-        enum: ["load", "domcontentloaded", "networkidle"],
-        default: "load"
-      },
-      output: {
-        type: "string",
-        description: "Optional absolute filesystem path. When set, the annotated PNG is written here and the tool returns a text confirmation."
-      },
-      encode: {
-        $ref: "#/$defs/EncodeOptions",
-        description: "Optional encoder settings (`format` / `saveSizePreset` / `jpegPercent`). Set to shrink the output for ingestion into issue trackers / docs."
-      }
-    },
-    $defs: {
-      ...I,
-      LocatorAnnotation: Ce,
-      EncodeOptions: P
-    }
-  }
+//#endregion
+//#region src/tools/aria-snapshot.ts
+var $e = "annot_aria_snapshot", et = {
+	name: $e,
+	description: "Open a URL in a headless browser and return Playwright's AI-mode aria-snapshot (YAML format with `[ref=eN]` markers). The same primitive `playwright-mcp` and `playwright-cli` use. Refs are session-local — store `role + name` (not refs) as persistent identifiers across snapshots.",
+	inputSchema: {
+		type: "object",
+		required: ["url"],
+		additionalProperties: !1,
+		properties: {
+			url: {
+				type: "string",
+				format: "uri",
+				description: "Page URL to snapshot."
+			},
+			viewport: {
+				type: "object",
+				additionalProperties: !1,
+				properties: {
+					width: {
+						type: "integer",
+						minimum: 1,
+						default: 1280
+					},
+					height: {
+						type: "integer",
+						minimum: 1,
+						default: 800
+					},
+					deviceScaleFactor: {
+						type: "number",
+						minimum: .1,
+						default: 1
+					}
+				},
+				description: "Viewport size. Default 1280×800 at 1× device pixel ratio."
+			},
+			waitFor: {
+				type: "string",
+				enum: [
+					"load",
+					"domcontentloaded",
+					"networkidle"
+				],
+				default: "load",
+				description: "Page event to await before snapshotting."
+			},
+			rootSelector: {
+				type: "string",
+				default: "body",
+				description: "Selector for the locator whose subtree is snapshotted. Defaults to `\"body\"` (whole page). Narrow to a specific region (e.g. `\"main\"` or `'[data-testid=\"login-form\"]'`) when only part of the page is relevant."
+			},
+			timeout: {
+				type: "integer",
+				minimum: 0,
+				description: "Timeout in milliseconds for the underlying `locator.ariaSnapshot()` call. Defaults to Playwright's own default (30 s)."
+			},
+			output: {
+				type: "string",
+				description: "Optional absolute filesystem path. When set, the YAML is written here and the tool returns a text confirmation; otherwise the YAML is returned inline."
+			}
+		}
+	}
 };
-class y extends Error {
-  constructor(t) {
-    super(t), this.name = "InvalidAnnotateUrlInputError";
-  }
+async function tt(e, t) {
+	if (typeof e.url != "string" || e.url.length === 0) return U("`url` is required (string).");
+	let n = nt(e.viewport), r = rt(e.waitFor), i = typeof e.rootSelector == "string" ? e.rootSelector : void 0, a = typeof e.timeout == "number" ? e.timeout : void 0, o = it(e.output);
+	if (o && !o.ok) return U(o.error);
+	let s;
+	try {
+		s = await H(t.pool, {
+			url: e.url,
+			viewport: n,
+			waitFor: r,
+			rootSelector: i,
+			timeout: a
+		});
+	} catch (e) {
+		return U(`Failed to capture aria-snapshot: ${e instanceof Error ? e.message : String(e)}`);
+	}
+	if (o) {
+		try {
+			await p(o.path, s.yaml, "utf8");
+		} catch (e) {
+			return U(`Failed to write snapshot to ${o.path}: ${e instanceof Error ? e.message : String(e)}`);
+		}
+		return { content: [{
+			type: "text",
+			text: `Wrote aria-snapshot (${s.yaml.length} bytes) to ${o.path}.`
+		}] };
+	}
+	return { content: [{
+		type: "text",
+		text: s.yaml
+	}] };
 }
-async function ot(e, t) {
-  try {
-    const o = rt(e), n = await W(t.pool, {
-      url: o.url,
-      viewport: o.viewport,
-      fullPage: o.fullPage,
-      waitFor: o.waitFor
-    });
-    let s;
-    try {
-      s = await be(
-        n.handle.page,
-        o.annotations
-      );
-    } finally {
-      await n.handle.close();
-    }
-    const c = B(n.pngBytes), r = U(s), a = t.annotator.toPng({
-      originalDataUrl: `data:image/png;base64,${H(n.pngBytes)}`,
-      annotationsSvg: r,
-      width: c.width,
-      height: c.height
-    }), i = await S(a, c, o.encode);
-    if (o.output) {
-      await O(o.output, i.bytes);
-      const d = i.reason ? `, reason: ${i.reason}` : "";
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Wrote ${i.bytes.byteLength}-byte ${i.chosen.toUpperCase()} to ${o.output} (${i.width}×${i.height}, ${o.annotations.length} annotation${o.annotations.length === 1 ? "" : "s"}, captured from ${o.url}${d}).`
-          }
-        ]
-      };
-    }
-    return {
-      content: [
-        {
-          type: "image",
-          data: H(i.bytes),
-          mimeType: i.mimeType
-        }
-      ]
-    };
-  } catch (o) {
-    return nt(o);
-  }
+function nt(e) {
+	if (typeof e != "object" || !e) return;
+	let t = e, n = typeof t.width == "number" ? t.width : 1280, r = typeof t.height == "number" ? t.height : 800, i = typeof t.deviceScaleFactor == "number" ? t.deviceScaleFactor : void 0;
+	return {
+		width: n,
+		height: r,
+		...i === void 0 ? {} : { deviceScaleFactor: i }
+	};
 }
 function rt(e) {
-  if (typeof e.url != "string" || e.url.length === 0)
-    throw new y("`url` is required and must be a non-empty string.");
-  if (!Array.isArray(e.annotations))
-    throw new y("`annotations` is required and must be an array.");
-  const t = e.annotations;
-  let o;
-  if (e.viewport !== void 0) {
-    if (typeof e.viewport != "object" || e.viewport === null)
-      throw new y("`viewport` must be an object when provided.");
-    const a = e.viewport, i = typeof a.width == "number" ? a.width : 1280, d = typeof a.height == "number" ? a.height : 800, l = typeof a.deviceScaleFactor == "number" ? a.deviceScaleFactor : 1;
-    o = { width: i, height: d, deviceScaleFactor: l };
-  }
-  const n = e.fullPage === !0, s = e.waitFor === "domcontentloaded" || e.waitFor === "networkidle" ? e.waitFor : "load";
-  let c;
-  if (e.output !== void 0) {
-    if (typeof e.output != "string")
-      throw new y("`output` must be a string when provided.");
-    if (!b(e.output))
-      throw new y(`\`output\` path "${e.output}" must be absolute.`);
-    c = e.output;
-  }
-  let r;
-  if (e.encode !== void 0) {
-    if (typeof e.encode != "object" || e.encode === null)
-      throw new y("`encode` must be an object when provided.");
-    r = e.encode;
-  }
-  return {
-    url: e.url,
-    annotations: t,
-    viewport: o,
-    fullPage: n,
-    waitFor: s,
-    output: c,
-    encode: r
-  };
+	if (e === "load" || e === "domcontentloaded" || e === "networkidle") return e;
 }
-function nt(e) {
-  return {
-    content: [{ type: "text", text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}` }],
-    isError: !0
-  };
+function it(e) {
+	if (e != null) return typeof e != "string" || e.length === 0 ? {
+		ok: !1,
+		error: "`output` must be a non-empty string when set."
+	} : m(e) ? {
+		ok: !0,
+		path: e
+	} : {
+		ok: !1,
+		error: `\`output\` must be an absolute path; got ${JSON.stringify(e)}.`
+	};
 }
-function H(e) {
-  return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
+function U(e) {
+	return {
+		content: [{
+			type: "text",
+			text: e
+		}],
+		isError: !0
+	};
 }
-const Q = "annot_compare_screenshots", st = {
-  name: Q,
-  description: "Compare two screenshots (must have identical dimensions) and return a PNG of the `after` image with changed regions highlighted as red rectangles. Useful for visual-diff PR review.",
-  inputSchema: {
-    type: "object",
-    required: ["before", "after"],
-    additionalProperties: !1,
-    properties: {
-      before: {
-        type: "string",
-        description: "`data:image/png;base64,...` URL or absolute filesystem path."
-      },
-      after: {
-        type: "string",
-        description: "`data:image/png;base64,...` URL or absolute filesystem path."
-      },
-      threshold: {
-        type: "number",
-        minimum: 0,
-        maximum: 1,
-        default: 0.1,
-        description: "Pixelmatch sensitivity (0 = strict, 1 = permissive)."
-      },
-      includeChangeList: {
-        type: "boolean",
-        default: !1,
-        description: "When true, append a text content block listing the changed-region bboxes alongside the annotated PNG."
-      },
-      output: { type: "string" },
-      encode: { $ref: "#/$defs/EncodeOptions" }
-    },
-    $defs: {
-      EncodeOptions: P
-    }
-  }
+//#endregion
+//#region src/tools/compare-screenshots.ts
+var W = "annot_compare_screenshots", at = {
+	name: W,
+	description: "Compare two screenshots (must have identical dimensions) and return a PNG of the `after` image with changed regions highlighted as red rectangles. Useful for visual-diff PR review.",
+	inputSchema: {
+		type: "object",
+		required: ["before", "after"],
+		additionalProperties: !1,
+		properties: {
+			before: {
+				type: "string",
+				description: "`data:image/png;base64,...` URL or absolute filesystem path."
+			},
+			after: {
+				type: "string",
+				description: "`data:image/png;base64,...` URL or absolute filesystem path."
+			},
+			threshold: {
+				type: "number",
+				minimum: 0,
+				maximum: 1,
+				default: .1,
+				description: "Pixelmatch sensitivity (0 = strict, 1 = permissive)."
+			},
+			includeChangeList: {
+				type: "boolean",
+				default: !1,
+				description: "When true, append a text content block listing the changed-region bboxes alongside the annotated PNG."
+			},
+			output: { type: "string" },
+			encode: { $ref: "#/$defs/EncodeOptions" }
+		},
+		$defs: { EncodeOptions: D }
+	}
+}, G = class extends Error {
+	constructor(e) {
+		super(e), this.name = "InvalidCompareInputError";
+	}
 };
-class $ extends Error {
-  constructor(t) {
-    super(t), this.name = "InvalidCompareInputError";
-  }
+async function ot(e, t) {
+	try {
+		if (typeof e.before != "string") throw new G("`before` is required and must be a string.");
+		if (typeof e.after != "string") throw new G("`after` is required and must be a string.");
+		let n = typeof e.threshold == "number" ? e.threshold : .1, r = e.includeChangeList === !0, i;
+		if (e.output !== void 0) {
+			if (typeof e.output != "string") throw new G("`output` must be a string when provided.");
+			if (!m(e.output)) throw new G(`\`output\` path "${e.output}" must be absolute.`);
+			i = e.output;
+		}
+		let a;
+		if (e.encode !== void 0) {
+			if (typeof e.encode != "object" || e.encode === null) throw new G("`encode` must be an object when provided.");
+			a = e.encode;
+		}
+		let [s, c] = await Promise.all([M(e.before), M(e.after)]), l = await C(s.bytes, c.bytes, { threshold: n }), u = o(l.regions.map((e) => ({
+			type: "rect",
+			bbox: e,
+			intent: "warning"
+		}))), d = await P(t.annotator.toPng({
+			originalDataUrl: c.dataUrl,
+			annotationsSvg: u,
+			width: l.width,
+			height: l.height
+		}), {
+			width: l.width,
+			height: l.height
+		}, a);
+		if (i) {
+			await p(i, d.bytes);
+			let e = d.reason ? `, reason: ${d.reason}` : "";
+			return { content: [{
+				type: "text",
+				text: `Wrote ${d.bytes.byteLength}-byte diff-annotated ${d.chosen.toUpperCase()} to ${i} (${d.width}×${d.height}, ${l.regions.length} changed region${l.regions.length === 1 ? "" : "s"}, ${l.mismatchedPixels} mismatched pixel${l.mismatchedPixels === 1 ? "" : "s"}${e}).`
+			}] };
+		}
+		let f = {
+			type: "image",
+			data: Buffer.from(d.bytes.buffer, d.bytes.byteOffset, d.bytes.byteLength).toString("base64"),
+			mimeType: d.mimeType
+		};
+		return r ? { content: [f, {
+			type: "text",
+			text: `${l.regions.length} changed region${l.regions.length === 1 ? "" : "s"}, ${l.mismatchedPixels} mismatched pixel${l.mismatchedPixels === 1 ? "" : "s"}:\n` + l.regions.map((e, t) => `  [${t + 1}] x=${e.x} y=${e.y} w=${e.width} h=${e.height}`).join("\n")
+		}] } : { content: [f] };
+	} catch (e) {
+		return {
+			content: [{
+				type: "text",
+				text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}`
+			}],
+			isError: !0
+		};
+	}
+}
+//#endregion
+//#region src/tools/draft-screen-spec.ts
+var st = "annot_draft_screen_spec", ct = {
+	name: st,
+	description: "Given a URL, propose an `.mdx` skeleton for an annot product-docs screen spec. The tool opens the page in a headless browser, takes a Playwright `aria-snapshot`, and emits an MDX with frontmatter + a `<Screen>` block containing one `<Overlay match={{ role, name }}>` per interactive element. The agent fills in the prose body of each overlay; the structural skeleton is mechanical.",
+	inputSchema: {
+		type: "object",
+		required: ["url", "id"],
+		additionalProperties: !1,
+		properties: {
+			url: {
+				type: "string",
+				format: "uri",
+				description: "Page URL to draft from."
+			},
+			id: {
+				type: "string",
+				description: "Screen ID — used as the MDX frontmatter `annot.id` and as the `<Screen id>` prop."
+			},
+			title: {
+				type: "string",
+				description: "Optional screen title (frontmatter `annot.title`)."
+			},
+			book: {
+				type: "string",
+				description: "Optional book name (frontmatter `xlsx.book`)."
+			},
+			screenImageSrc: {
+				type: "string",
+				default: "./shots/{id}.png",
+				description: "Optional `<Screen src>` value. `{id}` is replaced with the screen id. Defaults to `./shots/<id>.png`."
+			},
+			viewport: {
+				type: "object",
+				additionalProperties: !1,
+				properties: {
+					width: {
+						type: "integer",
+						minimum: 1,
+						default: 1280
+					},
+					height: {
+						type: "integer",
+						minimum: 1,
+						default: 800
+					},
+					deviceScaleFactor: {
+						type: "number",
+						minimum: .1,
+						default: 1
+					}
+				}
+			},
+			waitFor: {
+				type: "string",
+				enum: [
+					"load",
+					"domcontentloaded",
+					"networkidle"
+				],
+				default: "load"
+			}
+		}
+	}
+}, lt = new Set([
+	"button",
+	"checkbox",
+	"combobox",
+	"link",
+	"menuitem",
+	"menuitemcheckbox",
+	"menuitemradio",
+	"option",
+	"radio",
+	"searchbox",
+	"slider",
+	"spinbutton",
+	"switch",
+	"tab",
+	"textbox",
+	"treeitem"
+]);
+async function ut(e, t) {
+	if (typeof e.url != "string" || e.url.length === 0) return K("`url` is required (string).");
+	if (typeof e.id != "string" || e.id.length === 0) return K("`id` is required (string).");
+	let n = e.id, r = typeof e.title == "string" ? e.title : void 0, i = typeof e.book == "string" ? e.book : void 0, a = (typeof e.screenImageSrc == "string" ? e.screenImageSrc : "./shots/{id}.png").replace(/\{id\}/g, n), o;
+	try {
+		o = await H(t.pool, {
+			url: e.url,
+			viewport: dt(e.viewport),
+			waitFor: ft(e.waitFor)
+		});
+	} catch (e) {
+		return K(`Failed to capture aria-snapshot: ${e instanceof Error ? e.message : String(e)}`);
+	}
+	let s = ce(o.yaml).filter((e) => lt.has(e.role)).map((e, t) => `<Overlay match={{ role: ${JSON.stringify(e.role)}, name: ${JSON.stringify(e.name)} }} number={${t + 1}}>
+TODO: describe ${e.role} "${e.name}".
+</Overlay>`);
+	return { content: [{
+		type: "text",
+		text: `${[
+			"---",
+			"annot:",
+			`  id: ${n}`,
+			r ? `  title: ${r}` : null,
+			i ? "  xlsx:" : null,
+			i ? `    book: ${i}` : null,
+			i ? "    role: screen" : null,
+			"---"
+		].filter((e) => e !== null).join("\n")}\n\n${[
+			"import Screen from \"@ingcreators/annot-product-docs-astro/components/Screen.astro\";",
+			"import Overlay from \"@ingcreators/annot-product-docs-astro/components/Overlay.astro\";",
+			"",
+			`# ${r ?? n}`,
+			"",
+			`<Screen id="${n}" src="${a}">`,
+			"",
+			...s.flatMap((e) => [e, ""]),
+			"</Screen>",
+			"",
+			"{/* annot:snapshot",
+			o.yaml.trim(),
+			"*/}"
+		].join("\n")}\n`
+	}] };
+}
+function dt(e) {
+	if (typeof e != "object" || !e) return;
+	let t = e, n = typeof t.width == "number" ? t.width : 1280, r = typeof t.height == "number" ? t.height : 800, i = typeof t.deviceScaleFactor == "number" ? t.deviceScaleFactor : void 0;
+	return {
+		width: n,
+		height: r,
+		...i === void 0 ? {} : { deviceScaleFactor: i }
+	};
+}
+function ft(e) {
+	if (e === "load" || e === "domcontentloaded" || e === "networkidle") return e;
 }
-async function it(e, t) {
-  try {
-    if (typeof e.before != "string")
-      throw new $("`before` is required and must be a string.");
-    if (typeof e.after != "string")
-      throw new $("`after` is required and must be a string.");
-    const o = typeof e.threshold == "number" ? e.threshold : 0.1, n = e.includeChangeList === !0;
-    let s;
-    if (e.output !== void 0) {
-      if (typeof e.output != "string")
-        throw new $("`output` must be a string when provided.");
-      if (!b(e.output))
-        throw new $(`\`output\` path "${e.output}" must be absolute.`);
-      s = e.output;
-    }
-    let c;
-    if (e.encode !== void 0) {
-      if (typeof e.encode != "object" || e.encode === null)
-        throw new $("`encode` must be an object when provided.");
-      c = e.encode;
-    }
-    const [r, a] = await Promise.all([
-      R(e.before),
-      R(e.after)
-    ]), i = await Se(r.bytes, a.bytes, { threshold: o }), d = i.regions.map((h) => ({
-      type: "rect",
-      bbox: h,
-      intent: "warning"
-    })), l = U(d), v = t.annotator.toPng({
-      originalDataUrl: a.dataUrl,
-      annotationsSvg: l,
-      width: i.width,
-      height: i.height
-    }), u = await S(
-      v,
-      { width: i.width, height: i.height },
-      c
-    );
-    if (s) {
-      await O(s, u.bytes);
-      const h = u.reason ? `, reason: ${u.reason}` : "";
-      return { content: [{ type: "text", text: `Wrote ${u.bytes.byteLength}-byte diff-annotated ${u.chosen.toUpperCase()} to ${s} (${u.width}×${u.height}, ${i.regions.length} changed region${i.regions.length === 1 ? "" : "s"}, ${i.mismatchedPixels} mismatched pixel${i.mismatchedPixels === 1 ? "" : "s"}${h}).` }] };
-    }
-    const _ = {
-      type: "image",
-      data: Buffer.from(
-        u.bytes.buffer,
-        u.bytes.byteOffset,
-        u.bytes.byteLength
-      ).toString("base64"),
-      mimeType: u.mimeType
-    };
-    if (!n)
-      return { content: [_] };
-    const ee = `${i.regions.length} changed region${i.regions.length === 1 ? "" : "s"}, ${i.mismatchedPixels} mismatched pixel${i.mismatchedPixels === 1 ? "" : "s"}:
-` + i.regions.map((h, D) => `  [${D + 1}] x=${h.x} y=${h.y} w=${h.width} h=${h.height}`).join(`
-`);
-    return {
-      content: [_, { type: "text", text: ee }]
-    };
-  } catch (o) {
-    return {
-      content: [{ type: "text", text: o instanceof Error ? `${o.name}: ${o.message}` : `Unknown error: ${String(o)}` }],
-      isError: !0
-    };
-  }
+function K(e) {
+	return {
+		content: [{
+			type: "text",
+			text: e
+		}],
+		isError: !0
+	};
 }
-const K = "annot_redact_screenshot", at = {
-  name: K,
-  description: "Destructively burn redactions (solid / mosaic / blur) into a PNG screenshot. The original pixels under each region are irrecoverably replaced. Returns the redacted PNG inline unless `output` is specified.",
-  inputSchema: {
-    type: "object",
-    required: ["image", "regions"],
-    additionalProperties: !1,
-    properties: {
-      image: {
-        type: "string",
-        description: "`data:image/png;base64,...` URL or absolute filesystem path."
-      },
-      regions: {
-        type: "array",
-        items: { $ref: "#/$defs/BboxRedactRegion" }
-      },
-      output: { type: "string" },
-      encode: {
-        $ref: "#/$defs/EncodeOptions",
-        description: "Optional encoder settings applied after the redactions are burned in. Useful when the redacted screenshot is destined for an issue tracker / docs and size matters."
-      }
-    },
-    $defs: {
-      ...I,
-      BboxRedactRegion: se,
-      EncodeOptions: P
-    }
-  }
+//#endregion
+//#region src/tools/propose-drift-fixes.ts
+var pt = "annot_propose_drift_fixes", mt = {
+	name: pt,
+	description: "Given an MDX path + the live URL the screen renders at, run drift detection between the stored `<Overlay match>` keys and the current `aria-snapshot`. Returns a structured Markdown report: one section per finding with the kind / severity / message / suggested fix. The agent reads the report and applies edits via its own patch primitive.",
+	inputSchema: {
+		type: "object",
+		required: ["mdxPath", "url"],
+		additionalProperties: !1,
+		properties: {
+			mdxPath: {
+				type: "string",
+				description: "Absolute or cwd-relative path to the `.mdx` file with `annot:` frontmatter."
+			},
+			url: {
+				type: "string",
+				format: "uri",
+				description: "URL to navigate to for the live snapshot."
+			},
+			screenId: {
+				type: "string",
+				description: "Optional `<Screen id>` filter. Default: run drift against every screen in the MDX."
+			},
+			viewport: {
+				type: "object",
+				additionalProperties: !1,
+				properties: {
+					width: {
+						type: "integer",
+						minimum: 1,
+						default: 1280
+					},
+					height: {
+						type: "integer",
+						minimum: 1,
+						default: 800
+					},
+					deviceScaleFactor: {
+						type: "number",
+						minimum: .1,
+						default: 1
+					}
+				}
+			},
+			waitFor: {
+				type: "string",
+				enum: [
+					"load",
+					"domcontentloaded",
+					"networkidle"
+				],
+				default: "load"
+			}
+		}
+	}
 };
-class E extends Error {
-  constructor(t) {
-    super(t), this.name = "InvalidRedactInputError";
-  }
+async function ht(e, t) {
+	if (typeof e.mdxPath != "string" || e.mdxPath.length === 0) return q("`mdxPath` is required (string).");
+	if (typeof e.url != "string" || e.url.length === 0) return q("`url` is required (string).");
+	let n = typeof e.screenId == "string" ? e.screenId : void 0, r = await se(e.mdxPath);
+	if (!r) return q(`${e.mdxPath} has no \`annot:\` frontmatter.`);
+	let i = oe(r.screens).filter((e) => !n || e.id === n);
+	if (i.length === 0) return { content: [{
+		type: "text",
+		text: `No lintable screens in ${e.mdxPath}${n ? ` (screenId=${n})` : ""}.`
+	}] };
+	let a = [];
+	for (let n of i) {
+		let r;
+		try {
+			r = await H(t.pool, {
+				url: e.url,
+				viewport: _t(e.viewport),
+				waitFor: vt(e.waitFor)
+			});
+		} catch (e) {
+			return q(`Failed to capture aria-snapshot for screen=${n.id}: ${e instanceof Error ? e.message : String(e)}`);
+		}
+		let i = ae({
+			screen: n,
+			liveSnapshot: ce(r.yaml)
+		});
+		for (let e of i) a.push({
+			screenId: n.id,
+			finding: e
+		});
+	}
+	return a.length === 0 ? { content: [{
+		type: "text",
+		text: `No drift detected in ${e.mdxPath} against ${e.url}.`
+	}] } : { content: [{
+		type: "text",
+		text: gt(e.mdxPath, e.url, a)
+	}] };
+}
+function gt(e, t, n) {
+	let r = [];
+	r.push(`# Drift report — ${e}`), r.push(""), r.push(`Live URL: ${t}`), r.push(`Findings: ${n.length}`), r.push("");
+	for (let { screenId: e, finding: t } of n) r.push(`## ${t.severity.toUpperCase()} [${e}] ${t.kind}`), r.push(""), r.push(t.message), t.match && (r.push(""), r.push("Current match key:"), r.push("```ts"), r.push(JSON.stringify(t.match, null, 2)), r.push("```")), t.suggestion && (r.push(""), r.push("Suggested replacement:"), r.push("```ts"), r.push(JSON.stringify(t.suggestion, null, 2)), r.push("```")), r.push("");
+	return r.join("\n");
+}
+function _t(e) {
+	if (typeof e != "object" || !e) return;
+	let t = e, n = typeof t.width == "number" ? t.width : 1280, r = typeof t.height == "number" ? t.height : 800, i = typeof t.deviceScaleFactor == "number" ? t.deviceScaleFactor : void 0;
+	return {
+		width: n,
+		height: r,
+		...i === void 0 ? {} : { deviceScaleFactor: i }
+	};
 }
-async function ct(e) {
-  try {
-    if (typeof e.image != "string")
-      throw new E("`image` is required and must be a string.");
-    if (!Array.isArray(e.regions))
-      throw new E("`regions` is required and must be an array.");
-    const t = e.regions;
-    let o;
-    if (e.output !== void 0) {
-      if (typeof e.output != "string")
-        throw new E("`output` must be a string when provided.");
-      if (!b(e.output))
-        throw new E(`\`output\` path "${e.output}" must be absolute.`);
-      o = e.output;
-    }
-    let n;
-    if (e.encode !== void 0) {
-      if (typeof e.encode != "object" || e.encode === null)
-        throw new E("`encode` must be an object when provided.");
-      n = e.encode;
-    }
-    const s = await R(e.image), c = await Y(s.bytes, t), r = await S(c, s.dimensions, n);
-    if (o) {
-      await O(o, r.bytes);
-      const a = r.reason ? `, reason: ${r.reason}` : "";
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Wrote ${r.bytes.byteLength}-byte redacted ${r.chosen.toUpperCase()} to ${o} (${r.width}×${r.height}, ${t.length} region${t.length === 1 ? "" : "s"}${a}).`
-          }
-        ]
-      };
-    }
-    return {
-      content: [
-        {
-          type: "image",
-          data: Buffer.from(
-            r.bytes.buffer,
-            r.bytes.byteOffset,
-            r.bytes.byteLength
-          ).toString("base64"),
-          mimeType: r.mimeType
-        }
-      ]
-    };
-  } catch (t) {
-    return {
-      content: [{ type: "text", text: t instanceof Error ? `${t.name}: ${t.message}` : `Unknown error: ${String(t)}` }],
-      isError: !0
-    };
-  }
+function vt(e) {
+	if (e === "load" || e === "domcontentloaded" || e === "networkidle") return e;
 }
-const Z = "annot_redact_url", dt = {
-  name: Z,
-  description: "Open a URL in a headless browser, capture a screenshot, and destructively burn redactions over regions identified by locator strings or bboxes. Returns the redacted PNG inline unless `output` is specified.",
-  inputSchema: {
-    type: "object",
-    required: ["url", "regions"],
-    additionalProperties: !1,
-    properties: {
-      url: { type: "string", format: "uri" },
-      regions: {
-        type: "array",
-        items: { $ref: "#/$defs/LocatorRedactRegion" }
-      },
-      viewport: {
-        type: "object",
-        additionalProperties: !1,
-        properties: {
-          width: { type: "integer", minimum: 1, default: 1280 },
-          height: { type: "integer", minimum: 1, default: 800 },
-          deviceScaleFactor: { type: "number", minimum: 0.1, default: 1 }
-        }
-      },
-      fullPage: { type: "boolean", default: !1 },
-      waitFor: {
-        type: "string",
-        enum: ["load", "domcontentloaded", "networkidle"],
-        default: "load"
-      },
-      output: { type: "string" },
-      encode: { $ref: "#/$defs/EncodeOptions" }
-    },
-    $defs: {
-      ...I,
-      LocatorRedactRegion: Ue,
-      EncodeOptions: P
-    }
-  }
+function q(e) {
+	return {
+		content: [{
+			type: "text",
+			text: e
+		}],
+		isError: !0
+	};
+}
+//#endregion
+//#region src/tools/redact-screenshot.ts
+var J = "annot_redact_screenshot", yt = {
+	name: J,
+	description: "Destructively burn redactions (solid / mosaic / blur) into a PNG screenshot. The original pixels under each region are irrecoverably replaced. Returns the redacted PNG inline unless `output` is specified.",
+	inputSchema: {
+		type: "object",
+		required: ["image", "regions"],
+		additionalProperties: !1,
+		properties: {
+			image: {
+				type: "string",
+				description: "`data:image/png;base64,...` URL or absolute filesystem path."
+			},
+			regions: {
+				type: "array",
+				items: { $ref: "#/$defs/BboxRedactRegion" }
+			},
+			output: { type: "string" },
+			encode: {
+				$ref: "#/$defs/EncodeOptions",
+				description: "Optional encoder settings applied after the redactions are burned in. Useful when the redacted screenshot is destined for an issue tracker / docs and size matters."
+			}
+		},
+		$defs: {
+			...T,
+			BboxRedactRegion: t,
+			EncodeOptions: D
+		}
+	}
+}, Y = class extends Error {
+	constructor(e) {
+		super(e), this.name = "InvalidRedactInputError";
+	}
 };
-class p extends Error {
-  constructor(t) {
-    super(t), this.name = "InvalidRedactUrlInputError";
-  }
+async function X(e) {
+	try {
+		if (typeof e.image != "string") throw new Y("`image` is required and must be a string.");
+		if (!Array.isArray(e.regions)) throw new Y("`regions` is required and must be an array.");
+		let t = e.regions, n;
+		if (e.output !== void 0) {
+			if (typeof e.output != "string") throw new Y("`output` must be a string when provided.");
+			if (!m(e.output)) throw new Y(`\`output\` path "${e.output}" must be absolute.`);
+			n = e.output;
+		}
+		let r;
+		if (e.encode !== void 0) {
+			if (typeof e.encode != "object" || e.encode === null) throw new Y("`encode` must be an object when provided.");
+			r = e.encode;
+		}
+		let i = await M(e.image), a = await P(await N(i.bytes, t), i.dimensions, r);
+		if (n) {
+			await p(n, a.bytes);
+			let e = a.reason ? `, reason: ${a.reason}` : "";
+			return { content: [{
+				type: "text",
+				text: `Wrote ${a.bytes.byteLength}-byte redacted ${a.chosen.toUpperCase()} to ${n} (${a.width}×${a.height}, ${t.length} region${t.length === 1 ? "" : "s"}${e}).`
+			}] };
+		}
+		return { content: [{
+			type: "image",
+			data: Buffer.from(a.bytes.buffer, a.bytes.byteOffset, a.bytes.byteLength).toString("base64"),
+			mimeType: a.mimeType
+		}] };
+	} catch (e) {
+		return {
+			content: [{
+				type: "text",
+				text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}`
+			}],
+			isError: !0
+		};
+	}
 }
-async function lt(e, t) {
-  try {
-    const o = ut(e), n = await W(t.pool, {
-      url: o.url,
-      viewport: o.viewport,
-      fullPage: o.fullPage,
-      waitFor: o.waitFor
-    });
-    let s;
-    try {
-      s = [];
-      for (const i of o.regions) {
-        const l = { bbox: await ht(n.handle.page, i) };
-        i.style !== void 0 && (l.style = i.style), i.color !== void 0 && (l.color = i.color), s.push(l);
-      }
-    } finally {
-      await n.handle.close();
-    }
-    const c = await Y(n.pngBytes, s), r = B(n.pngBytes), a = await S(c, r, o.encode);
-    if (o.output) {
-      await O(o.output, a.bytes);
-      const i = a.reason ? `, reason: ${a.reason}` : "";
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Wrote ${a.bytes.byteLength}-byte redacted ${a.chosen.toUpperCase()} to ${o.output} (${a.width}×${a.height}, ${o.regions.length} region${o.regions.length === 1 ? "" : "s"}, captured from ${o.url}${i}).`
-          }
-        ]
-      };
-    }
-    return {
-      content: [
-        {
-          type: "image",
-          data: Buffer.from(
-            a.bytes.buffer,
-            a.bytes.byteOffset,
-            a.bytes.byteLength
-          ).toString("base64"),
-          mimeType: a.mimeType
-        }
-      ]
-    };
-  } catch (o) {
-    return {
-      content: [{ type: "text", text: o instanceof Error ? `${o.name}: ${o.message}` : `Unknown error: ${String(o)}` }],
-      isError: !0
-    };
-  }
+//#endregion
+//#region src/tools/redact-url.ts
+var Z = "annot_redact_url", bt = {
+	name: Z,
+	description: "Open a URL in a headless browser, capture a screenshot, and destructively burn redactions over regions identified by locator strings or bboxes. Returns the redacted PNG inline unless `output` is specified.",
+	inputSchema: {
+		type: "object",
+		required: ["url", "regions"],
+		additionalProperties: !1,
+		properties: {
+			url: {
+				type: "string",
+				format: "uri"
+			},
+			regions: {
+				type: "array",
+				items: { $ref: "#/$defs/LocatorRedactRegion" }
+			},
+			viewport: {
+				type: "object",
+				additionalProperties: !1,
+				properties: {
+					width: {
+						type: "integer",
+						minimum: 1,
+						default: 1280
+					},
+					height: {
+						type: "integer",
+						minimum: 1,
+						default: 800
+					},
+					deviceScaleFactor: {
+						type: "number",
+						minimum: .1,
+						default: 1
+					}
+				}
+			},
+			fullPage: {
+				type: "boolean",
+				default: !1
+			},
+			waitFor: {
+				type: "string",
+				enum: [
+					"load",
+					"domcontentloaded",
+					"networkidle"
+				],
+				default: "load"
+			},
+			output: { type: "string" },
+			encode: { $ref: "#/$defs/EncodeOptions" }
+		},
+		$defs: {
+			...T,
+			LocatorRedactRegion: Ce,
+			EncodeOptions: D
+		}
+	}
+}, Q = class extends Error {
+	constructor(e) {
+		super(e), this.name = "InvalidRedactUrlInputError";
+	}
+};
+async function xt(e, t) {
+	try {
+		let n = St(e), r = await h(t.pool, {
+			url: n.url,
+			viewport: n.viewport,
+			fullPage: n.fullPage,
+			waitFor: n.waitFor
+		}), i;
+		try {
+			i = [];
+			for (let e of n.regions) {
+				let t = { bbox: await Ct(r.handle.page, e) };
+				e.style !== void 0 && (t.style = e.style), e.color !== void 0 && (t.color = e.color), i.push(t);
+			}
+		} finally {
+			await r.handle.close();
+		}
+		let a = await P(await N(r.pngBytes, i), A(r.pngBytes), n.encode);
+		if (n.output) {
+			await p(n.output, a.bytes);
+			let e = a.reason ? `, reason: ${a.reason}` : "";
+			return { content: [{
+				type: "text",
+				text: `Wrote ${a.bytes.byteLength}-byte redacted ${a.chosen.toUpperCase()} to ${n.output} (${a.width}×${a.height}, ${n.regions.length} region${n.regions.length === 1 ? "" : "s"}, captured from ${n.url}${e}).`
+			}] };
+		}
+		return { content: [{
+			type: "image",
+			data: Buffer.from(a.bytes.buffer, a.bytes.byteOffset, a.bytes.byteLength).toString("base64"),
+			mimeType: a.mimeType
+		}] };
+	} catch (e) {
+		return {
+			content: [{
+				type: "text",
+				text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}`
+			}],
+			isError: !0
+		};
+	}
 }
-function ut(e) {
-  if (typeof e.url != "string" || e.url.length === 0)
-    throw new p("`url` is required and must be a non-empty string.");
-  if (!Array.isArray(e.regions))
-    throw new p("`regions` is required and must be an array.");
-  const t = e.regions;
-  let o;
-  if (e.viewport !== void 0) {
-    if (typeof e.viewport != "object" || e.viewport === null)
-      throw new p("`viewport` must be an object when provided.");
-    const a = e.viewport, i = typeof a.width == "number" ? a.width : 1280, d = typeof a.height == "number" ? a.height : 800, l = typeof a.deviceScaleFactor == "number" ? a.deviceScaleFactor : 1;
-    o = { width: i, height: d, deviceScaleFactor: l };
-  }
-  const n = e.fullPage === !0, s = e.waitFor === "domcontentloaded" || e.waitFor === "networkidle" ? e.waitFor : "load";
-  let c;
-  if (e.output !== void 0) {
-    if (typeof e.output != "string")
-      throw new p("`output` must be a string when provided.");
-    if (!b(e.output))
-      throw new p(`\`output\` path "${e.output}" must be absolute.`);
-    c = e.output;
-  }
-  let r;
-  if (e.encode !== void 0) {
-    if (typeof e.encode != "object" || e.encode === null)
-      throw new p("`encode` must be an object when provided.");
-    r = e.encode;
-  }
-  return { url: e.url, regions: t, viewport: o, fullPage: n, waitFor: s, output: c, encode: r };
+function St(e) {
+	if (typeof e.url != "string" || e.url.length === 0) throw new Q("`url` is required and must be a non-empty string.");
+	if (!Array.isArray(e.regions)) throw new Q("`regions` is required and must be an array.");
+	let t = e.regions, n;
+	if (e.viewport !== void 0) {
+		if (typeof e.viewport != "object" || e.viewport === null) throw new Q("`viewport` must be an object when provided.");
+		let t = e.viewport;
+		n = {
+			width: typeof t.width == "number" ? t.width : 1280,
+			height: typeof t.height == "number" ? t.height : 800,
+			deviceScaleFactor: typeof t.deviceScaleFactor == "number" ? t.deviceScaleFactor : 1
+		};
+	}
+	let r = e.fullPage === !0, i = e.waitFor === "domcontentloaded" || e.waitFor === "networkidle" ? e.waitFor : "load", a;
+	if (e.output !== void 0) {
+		if (typeof e.output != "string") throw new Q("`output` must be a string when provided.");
+		if (!m(e.output)) throw new Q(`\`output\` path "${e.output}" must be absolute.`);
+		a = e.output;
+	}
+	let o;
+	if (e.encode !== void 0) {
+		if (typeof e.encode != "object" || e.encode === null) throw new Q("`encode` must be an object when provided.");
+		o = e.encode;
+	}
+	return {
+		url: e.url,
+		regions: t,
+		viewport: n,
+		fullPage: r,
+		waitFor: i,
+		output: a,
+		encode: o
+	};
 }
-async function ht(e, t) {
-  if (t.bbox !== void 0) return t.bbox;
-  if (t.locator !== void 0) return f(e, t.locator);
-  throw new p("redact region requires either `bbox` or `locator`.");
+async function Ct(e, t) {
+	if (t.bbox !== void 0) return t.bbox;
+	if (t.locator !== void 0) return y(e, t.locator);
+	throw new Q("redact region requires either `bbox` or `locator`.");
 }
-const ft = "annot-mcp", pt = "0.1.0", mt = [
-  Je,
-  tt,
-  at,
-  dt,
-  st
+//#endregion
+//#region src/tools/translate-screen-spec.ts
+var wt = "annot_translate_screen_spec", Tt = {
+	name: wt,
+	description: "Given an MDX with `annot:` frontmatter and a target locale (e.g. `en-US` / `ja-JP` / `ko-KR`), emit a structured translation manifest listing every translatable string the agent should localise: frontmatter title / purpose, per-overlay Markdown bodies, per-transition prose. The agent translates the strings via its own LLM call and the host writes the localised MDX.",
+	inputSchema: {
+		type: "object",
+		required: ["mdxPath", "targetLocale"],
+		additionalProperties: !1,
+		properties: {
+			mdxPath: {
+				type: "string",
+				description: "Absolute or cwd-relative path to the source `.mdx`."
+			},
+			sourceLocale: {
+				type: "string",
+				description: "BCP-47 locale tag of the source MDX (e.g. `ja-JP`). Informational only — the tool doesn't enforce it."
+			},
+			targetLocale: {
+				type: "string",
+				description: "BCP-47 locale tag of the locale to produce (e.g. `en-US`)."
+			}
+		}
+	}
+};
+async function Et(e) {
+	if (typeof e.mdxPath != "string" || e.mdxPath.length === 0) return $("`mdxPath` is required (string).");
+	if (typeof e.targetLocale != "string" || e.targetLocale.length === 0) return $("`targetLocale` is required (string).");
+	let t = await se(e.mdxPath);
+	if (!t) return $(`${e.mdxPath} has no \`annot:\` frontmatter.`);
+	let n = [];
+	t.frontmatter.title && n.push({
+		location: { kind: "frontmatter.title" },
+		source: t.frontmatter.title
+	}), t.frontmatter.purpose && n.push({
+		location: { kind: "frontmatter.purpose" },
+		source: t.frontmatter.purpose
+	});
+	for (let e of t.screens) {
+		let t = 1;
+		for (let r of e.overlays) {
+			let i = r.number ?? t++;
+			n.push({
+				location: {
+					kind: "overlay.body",
+					screenId: e.id,
+					overlayNumber: i,
+					matchRole: r.match.role,
+					matchName: r.match.name
+				},
+				source: r.body
+			});
+		}
+	}
+	for (let e of t.transitions) n.push({
+		location: {
+			kind: "transition.body",
+			triggerRole: e.trigger.role,
+			triggerName: e.trigger.name
+		},
+		source: e.body
+	});
+	for (let e of t.history) n.push({
+		location: {
+			kind: "history.body",
+			version: e.version
+		},
+		source: e.body
+	});
+	let r = {
+		mdxPath: e.mdxPath,
+		sourceLocale: typeof e.sourceLocale == "string" ? e.sourceLocale : void 0,
+		targetLocale: e.targetLocale,
+		id: t.frontmatter.id,
+		items: n
+	};
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(r, null, 2)
+	}] };
+}
+function $(e) {
+	return {
+		content: [{
+			type: "text",
+			text: e
+		}],
+		isError: !0
+	};
+}
+//#endregion
+//#region src/server.ts
+var Dt = "annot-mcp", Ot = "0.1.0", kt = [
+	I,
+	B,
+	yt,
+	bt,
+	at,
+	et,
+	ct,
+	mt,
+	Tt
 ];
-function gt(e = {}) {
-  const t = new de(
-    {
-      name: ft,
-      version: e.version ?? pt
-    },
-    {
-      capabilities: {
-        tools: {}
-      }
-    }
-  ), o = e.annotator ?? ie(e.annotatorOptions ?? {}), n = e.pool ?? ye();
-  return t.setRequestHandler(le, async () => ({ tools: mt })), t.setRequestHandler(ue, async (s) => {
-    const { name: c, arguments: r } = s.params;
-    let a;
-    switch (c) {
-      case V:
-        a = await Qe(r ?? {}, { annotator: o });
-        break;
-      case J:
-        a = await ot(r ?? {}, { annotator: o, pool: n });
-        break;
-      case K:
-        a = await ct(r ?? {});
-        break;
-      case Z:
-        a = await lt(r ?? {}, { pool: n });
-        break;
-      case Q:
-        a = await it(r ?? {}, { annotator: o });
-        break;
-      default:
-        a = {
-          content: [{ type: "text", text: `Unknown tool: ${c}` }],
-          isError: !0
-        };
-    }
-    return a;
-  }), t;
+function At(e = {}) {
+	let t = new ne({
+		name: Dt,
+		version: e.version ?? Ot
+	}, { capabilities: { tools: {} } }), n = e.annotator ?? s(e.annotatorOptions ?? {}), r = e.pool ?? pe();
+	return t.setRequestHandler(ie, async () => ({ tools: kt })), t.setRequestHandler(re, async (e) => {
+		let { name: t, arguments: i } = e.params, a;
+		switch (t) {
+			case F:
+				a = await L(i ?? {}, { annotator: n });
+				break;
+			case z:
+				a = await Ke(i ?? {}, {
+					annotator: n,
+					pool: r
+				});
+				break;
+			case J:
+				a = await X(i ?? {});
+				break;
+			case Z:
+				a = await xt(i ?? {}, { pool: r });
+				break;
+			case W:
+				a = await ot(i ?? {}, { annotator: n });
+				break;
+			case $e:
+				a = await tt(i ?? {}, { pool: r });
+				break;
+			case st:
+				a = await ut(i ?? {}, { pool: r });
+				break;
+			case pt:
+				a = await ht(i ?? {}, { pool: r });
+				break;
+			case wt:
+				a = await Et(i ?? {});
+				break;
+			default: a = {
+				content: [{
+					type: "text",
+					text: `Unknown tool: ${t}`
+				}],
+				isError: !0
+			};
+		}
+		return a;
+	}), t;
 }
-async function Pt() {
-  const e = gt(), t = new he();
-  await e.connect(t);
+//#endregion
+//#region src/transport.ts
+async function jt() {
+	let e = At(), t = new le();
+	await e.connect(t);
 }
-export {
-  V as ANNOTATE_SCREENSHOT_TOOL_NAME,
-  J as ANNOTATE_URL_TOOL_NAME,
-  At as BBOX_ANNOTATION_SCHEMA,
-  Tt as BBOX_REDACT_REGION_SCHEMA,
-  ge as BrowserPool,
-  Q as COMPARE_SCREENSHOTS_TOOL_NAME,
-  q as ChromiumUnavailableError,
-  Pe as DimensionMismatchError,
-  w as InvalidImageInputError,
-  x as InvalidPngError,
-  Ce as LOCATOR_ANNOTATION_SCHEMA,
-  Ue as LOCATOR_REDACT_REGION_SCHEMA,
-  N as LocatorResolutionError,
-  K as REDACT_SCREENSHOT_TOOL_NAME,
-  Z as REDACT_URL_TOOL_NAME,
-  I as SHARED_DEFS,
-  xe as aggregateDiffRegions,
-  Je as annotateScreenshotTool,
-  tt as annotateUrlTool,
-  Rt as arrowBetween,
-  It as bboxAnnotationsToSvg,
-  Y as burnRedactions,
-  W as capturePage,
-  st as compareScreenshotsTool,
-  ye as createChromiumPool,
-  gt as createServer,
-  Se as diffScreenshots,
-  Qe as handleAnnotateScreenshot,
-  ot as handleAnnotateUrl,
-  it as handleCompareScreenshots,
-  ct as handleRedactScreenshot,
-  lt as handleRedactUrl,
-  B as readPngDimensions,
-  _t as rectForBoundingBox,
-  at as redactScreenshotTool,
-  dt as redactUrlTool,
-  R as resolveImageInput,
-  f as resolveLocator,
-  we as resolveLocatorAnnotation,
-  be as resolveLocatorAnnotations,
-  Pt as runStdioServer,
-  Ct as textAt
-};
+//#endregion
+export { F as ANNOTATE_SCREENSHOT_TOOL_NAME, z as ANNOTATE_URL_TOOL_NAME, e as BBOX_ANNOTATION_SCHEMA, t as BBOX_REDACT_REGION_SCHEMA, g as BrowserPool, W as COMPARE_SCREENSHOTS_TOOL_NAME, _ as ChromiumUnavailableError, Se as DimensionMismatchError, j as InvalidImageInputError, k as InvalidPngError, E as LOCATOR_ANNOTATION_SCHEMA, Ce as LOCATOR_REDACT_REGION_SCHEMA, v as LocatorResolutionError, J as REDACT_SCREENSHOT_TOOL_NAME, Z as REDACT_URL_TOOL_NAME, T as SHARED_DEFS, ye as aggregateDiffRegions, I as annotateScreenshotTool, B as annotateUrlTool, i as arrowBetween, a as bboxAnnotationsToSvg, N as burnRedactions, h as capturePage, at as compareScreenshotsTool, pe as createChromiumPool, At as createServer, C as diffScreenshots, L as handleAnnotateScreenshot, Ke as handleAnnotateUrl, ot as handleCompareScreenshots, X as handleRedactScreenshot, xt as handleRedactUrl, A as readPngDimensions, l as rectForBoundingBox, yt as redactScreenshotTool, bt as redactUrlTool, M as resolveImageInput, y as resolveLocator, me as resolveLocatorAnnotation, he as resolveLocatorAnnotations, jt as runStdioServer, u as textAt };