@ingcreators/annot-mcp 0.1.1 → 0.2.0

package/dist/index.js

@@ -1,57 +1,57 @@
-import { SHARED_DEFS as K, BBOX_ANNOTATION_SCHEMA as Z, bboxAnnotationsToSvg as I, BBOX_REDACT_REGION_SCHEMA as Q, createAnnotator as tt } from "@ingcreators/annot-annotator";
-import { BBOX_ANNOTATION_SCHEMA as Ee, BBOX_REDACT_REGION_SCHEMA as xe, arrowBetween as Le, bboxAnnotationsToSvg as Pe, rectForBoundingBox as Ae, textAt as Oe } from "@ingcreators/annot-annotator";
-import { loadImage as T, createCanvas as _ } from "@napi-rs/canvas";
-import et from "pixelmatch";
-import { readFile as rt, writeFile as $ } from "node:fs/promises";
-import { isAbsolute as w } from "node:path";
-import { Server as ot } from "@modelcontextprotocol/sdk/server/index.js";
-import { ListToolsRequestSchema as nt, CallToolRequestSchema as it } from "@modelcontextprotocol/sdk/types.js";
-import { StdioServerTransport as at } from "@modelcontextprotocol/sdk/server/stdio.js";
-const st = { width: 1280, height: 800, deviceScaleFactor: 1 }, ct = "load";
-async function k(t, e) {
-  const r = { ...st, ...e.viewport }, o = e.waitFor ?? ct, i = e.fullPage ?? !1, a = await t.acquire();
-  let n, s = !1;
-  const c = () => {
-    s || (s = !0, t.release());
+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 {
-    n = await a.newContext({
-      viewport: { width: r.width, height: r.height },
-      deviceScaleFactor: r.deviceScaleFactor
+    r = await c.newContext({
+      viewport: { width: o.width, height: o.height },
+      deviceScaleFactor: o.deviceScaleFactor
     });
-    const u = await n.newPage();
-    await u.goto(e.url, { waitUntil: o });
-    const l = await u.screenshot({ fullPage: i, type: "png" }), h = new Uint8Array(l.buffer, l.byteOffset, l.byteLength), R = n;
-    return { pngBytes: h, handle: {
-      page: u,
+    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 (!s)
+        if (!a)
           try {
-            await R.close();
+            await u.close();
           } finally {
-            c();
+            i();
           }
       }
     } };
-  } catch (u) {
-    if (n)
+  } catch (d) {
+    if (r)
       try {
-        await n.close();
+        await r.close();
       } catch {
       }
-    throw c(), u;
+    throw i(), d;
   }
 }
-const ut = 3e4;
-class lt {
+const me = 3e4;
+class ge {
+  #s;
   #i;
-  #a;
-  #t;
-  #o;
-  #e = 0;
+  #e;
   #r;
-  constructor(e, r = {}) {
-    this.#i = e, this.#a = r.idleTimeoutMs ?? ut;
+  #t = 0;
+  #o;
+  constructor(t, o = {}) {
+    this.#s = t, this.#i = o.idleTimeoutMs ?? me;
   }
   /**
    * Acquire a browser instance. The pool launches lazily on the
@@ -64,9 +64,9 @@ class lt {
    * accurately.
    */
   async acquire() {
-    return this.#n(), this.#e += 1, this.#t ? this.#t : (this.#o || (this.#o = this.#i.launch().then((e) => (this.#t = e, this.#o = void 0, e)).catch((e) => {
-      throw this.#o = void 0, this.#e = Math.max(0, this.#e - 1), e;
-    })), this.#o);
+    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
@@ -75,7 +75,7 @@ class lt {
    * instance; otherwise the timer fires and the browser closes.
    */
   release() {
-    this.#e !== 0 && (this.#e -= 1, this.#e === 0 && this.#t && this.#s());
+    this.#t !== 0 && (this.#t -= 1, this.#t === 0 && this.#e && this.#a());
   }
   /**
    * Close the pooled browser immediately, regardless of refcount.
@@ -84,239 +84,239 @@ class lt {
    */
   async shutdown() {
     this.#n();
-    const e = this.#t;
-    this.#t = void 0, this.#e = 0, e && await e.close();
+    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.#e;
+    return this.#t;
   }
   /** Whether a browser is currently launched. Exposed for tests. */
   get isLaunched() {
-    return this.#t !== void 0;
+    return this.#e !== void 0;
   }
   // ─── internals ────────────────────────────────────────────────
   #n() {
-    this.#r && (clearTimeout(this.#r), this.#r = void 0);
+    this.#o && (clearTimeout(this.#o), this.#o = void 0);
   }
-  #s() {
-    this.#n(), this.#r = setTimeout(() => {
-      const e = this.#t;
-      this.#t = void 0, this.#r = void 0, e?.close().catch(() => {
+  #a() {
+    this.#n(), this.#o = setTimeout(() => {
+      const t = this.#e;
+      this.#e = void 0, this.#o = void 0, t?.close().catch(() => {
       });
-    }, this.#a), this.#r.unref?.();
+    }, this.#i), this.#o.unref?.();
   }
 }
-function dt(t = {}) {
-  return new lt(
+function ye(e = {}) {
+  return new ge(
     {
       async launch() {
-        let e;
+        let t;
         try {
-          ({ chromium: e } = await import("playwright-core"));
-        } catch (r) {
-          throw new C(
+          ({ chromium: t } = await import("playwright-core"));
+        } catch (o) {
+          throw new q(
             "Failed to load `playwright-core`. Reinstall `@ingcreators/annot-mcp` to restore the dependency.",
-            r
+            o
           );
         }
         try {
-          return await e.launch({ headless: !0 });
-        } catch (r) {
-          throw new C(
+          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.",
-            r
+            o
           );
         }
       }
     },
-    t
+    e
   );
 }
-class C extends Error {
+class q extends Error {
   cause;
-  constructor(e, r) {
-    super(e), this.name = "ChromiumUnavailableError", this.cause = r;
+  constructor(t, o) {
+    super(t), this.name = "ChromiumUnavailableError", this.cause = o;
   }
 }
-class F extends Error {
+class N extends Error {
   locator;
-  constructor(e, r) {
-    super(r), this.name = "LocatorResolutionError", this.locator = e;
+  constructor(t, o) {
+    super(o), this.name = "LocatorResolutionError", this.locator = t;
   }
 }
-async function f(t, e) {
-  const r = await t.locator(e).boundingBox();
-  if (!r)
-    throw new F(
-      e,
-      `Locator "${e}" resolved to no visible element. Check the selector matches at least one element and the element is inside the captured viewport.`
+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 r;
+  return o;
 }
-async function ft(t, e) {
-  switch (e.type) {
+async function we(e, t) {
+  switch (t.type) {
     case "rect": {
-      const r = e.bbox ?? await f(t, p(e.locator));
-      return { ...m(e), type: "rect", bbox: r };
+      const o = t.bbox ?? await f(e, m(t.locator));
+      return { ...g(t), type: "rect", bbox: o };
     }
     case "circle": {
-      if (e.center !== void 0 && e.radius !== void 0)
+      if (t.center !== void 0 && t.radius !== void 0)
         return {
-          ...m(e),
+          ...g(t),
           type: "circle",
-          center: e.center,
-          radius: e.radius
+          center: t.center,
+          radius: t.radius
         };
-      const r = await f(t, p(e.locator));
+      const o = await f(e, m(t.locator));
       return {
-        ...m(e),
+        ...g(t),
         type: "circle",
-        center: P(r),
-        radius: Math.min(r.width, r.height) / 2
+        center: T(o),
+        radius: Math.min(o.width, o.height) / 2
       };
     }
     case "arrow": {
-      const r = e.from ?? P(await f(t, p(e.fromLocator))), o = e.to ?? P(await f(t, p(e.toLocator)));
+      const o = t.from ?? T(await f(e, m(t.fromLocator))), n = t.to ?? T(await f(e, m(t.toLocator)));
       return {
-        ...m(e),
+        ...g(t),
         type: "arrow",
-        from: r,
-        to: o
+        from: o,
+        to: n
       };
     }
     case "text": {
-      const r = e.at ?? mt(
-        await f(t, p(e.locator)),
-        e.fontSize
-      ), o = {
-        ...m(e),
+      const o = t.at ?? $e(
+        await f(e, m(t.locator)),
+        t.fontSize
+      ), n = {
+        ...g(t),
         type: "text",
-        at: r,
-        content: e.content
+        at: o,
+        content: t.content
       };
-      return e.fontSize !== void 0 && (o.fontSize = e.fontSize), e.anchor !== void 0 && (o.anchor = e.anchor), o;
+      return t.fontSize !== void 0 && (n.fontSize = t.fontSize), t.anchor !== void 0 && (n.anchor = t.anchor), n;
     }
     case "callout": {
-      const r = e.at ?? await pt(t, e.atLocator), o = e.targetBbox ?? await f(t, p(e.targetLocator));
+      const o = t.at ?? await ve(e, t.atLocator), n = t.targetBbox ?? await f(e, m(t.targetLocator));
       return {
-        ...m(e),
+        ...g(t),
         type: "callout",
-        at: r,
-        targetBbox: o,
-        content: e.content
+        at: o,
+        targetBbox: n,
+        content: t.content
       };
     }
     case "raw":
-      return e;
+      return t;
   }
 }
-async function ht(t, e) {
-  const r = [];
-  for (const o of e)
-    r.push(await ft(t, o));
-  return r;
+async function be(e, t) {
+  const o = [];
+  for (const n of t)
+    o.push(await we(e, n));
+  return o;
 }
-async function pt(t, e) {
-  if (!e)
-    throw new F(
+async function ve(e, t) {
+  if (!t)
+    throw new N(
       "<callout.at>",
       "callout annotations require either `at` or `atLocator`."
     );
-  const r = await f(t, e);
-  return P(r);
+  const o = await f(e, t);
+  return T(o);
 }
-function P(t) {
-  return { x: t.x + t.width / 2, y: t.y + t.height / 2 };
+function T(e) {
+  return { x: e.x + e.width / 2, y: e.y + e.height / 2 };
 }
-function mt(t, e) {
-  const r = (e ?? 14) + 2;
-  return { x: t.x, y: Math.max(0, t.y - r) };
+function $e(e, t) {
+  const o = (t ?? 14) + 2;
+  return { x: e.x, y: Math.max(0, e.y - o) };
 }
-function p(t) {
-  if (t === void 0)
-    throw new F(
+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 t;
+  return e;
 }
-function m(t) {
-  if (t.type === "raw")
+function g(e) {
+  if (e.type === "raw")
     return {};
-  const e = {};
-  return t.intent !== void 0 && (e.intent = t.intent), t.stroke !== void 0 && (e.stroke = t.stroke), t.strokeWidth !== void 0 && (e.strokeWidth = t.strokeWidth), t.fill !== void 0 && (e.fill = t.fill), t.color !== void 0 && (e.color = t.color), e;
+  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;
 }
-const gt = 4;
-function yt(t, e, r) {
-  const o = new Uint8Array(e * r), i = [];
-  for (let a = 0; a < r; a++)
-    for (let n = 0; n < e; n++) {
-      const s = a * e + n;
-      if (o[s] || !G(t, s)) continue;
-      const c = wt(t, o, n, a, e, r);
-      c.count >= gt && i.push({
-        x: c.minX,
-        y: c.minY,
-        width: c.maxX - c.minX + 1,
-        height: c.maxY - c.minY + 1
+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 i;
+  return s;
 }
-function G(t, e) {
-  return t[e * 4 + 3] > 0;
+function X(e, t) {
+  return e[t * 4 + 3] > 0;
 }
-function wt(t, e, r, o, i, a) {
-  const n = {
+function Oe(e, t, o, n, s, c) {
+  const r = {
     count: 0,
-    minX: r,
-    minY: o,
-    maxX: r,
-    maxY: o
-  }, s = [r, o];
-  for (; s.length > 0; ) {
-    const c = s.pop(), u = s.pop();
-    if (u < 0 || u >= i || c < 0 || c >= a) continue;
-    const l = c * i + u;
-    e[l] || G(t, l) && (e[l] = 1, n.count += 1, u < n.minX && (n.minX = u), c < n.minY && (n.minY = c), u > n.maxX && (n.maxX = u), c > n.maxY && (n.maxY = c), s.push(u + 1, c), s.push(u - 1, c), s.push(u, c + 1), s.push(u, c - 1));
+    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 n;
+  return r;
 }
-class bt extends Error {
-  constructor(e, r) {
+class Pe extends Error {
+  constructor(t, o) {
     super(
-      `Cannot compare screenshots of different dimensions: before is ${e.width}×${e.height}, after is ${r.width}×${r.height}.`
+      `Cannot compare screenshots of different dimensions: before is ${t.width}×${t.height}, after is ${o.width}×${o.height}.`
     ), this.name = "DimensionMismatchError";
   }
 }
-async function vt(t, e, r = {}) {
-  const [o, i] = await Promise.all([
-    T(Buffer.from(t)),
-    T(Buffer.from(e))
+async function Se(e, t, o = {}) {
+  const [n, s] = await Promise.all([
+    C(Buffer.from(e)),
+    C(Buffer.from(t))
   ]);
-  if (o.width !== i.width || o.height !== i.height)
-    throw new bt(
-      { width: o.width, height: o.height },
-      { width: i.width, height: i.height }
+  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: a, height: n } = o, s = N(o, a, n), c = N(i, a, n), u = new Uint8Array(a * n * 4), l = et(s, c, u, a, n, {
-    threshold: r.threshold ?? 0.1,
+  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
-  }), h = yt(u, a, n);
-  return { mismatchedPixels: l, regions: h, width: a, height: n };
+  }), v = xe(d, c, r);
+  return { mismatchedPixels: l, regions: v, width: c, height: r };
 }
-function N(t, e, r) {
-  const i = _(e, r).getContext("2d");
-  i.drawImage(t, 0, 0);
-  const a = i.getImageData(0, 0, e, r).data;
-  return new Uint8Array(a.buffer, a.byteOffset, a.byteLength);
+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);
 }
-const O = {
-  ...K,
+const I = {
+  ...te,
   Locator: { type: "string", minLength: 1 }
-}, $t = {
+}, Le = {
   type: "object",
   required: ["type"],
   additionalProperties: !1,
@@ -331,7 +331,7 @@ const O = {
     color: { type: "string" }
   },
   anyOf: [{ required: ["bbox"] }, { required: ["locator"] }]
-}, Et = {
+}, Ae = {
   type: "object",
   required: ["type"],
   additionalProperties: !1,
@@ -347,7 +347,7 @@ const O = {
     color: { type: "string" }
   },
   anyOf: [{ required: ["center", "radius"] }, { required: ["locator"] }]
-}, xt = {
+}, Te = {
   type: "object",
   required: ["type"],
   additionalProperties: !1,
@@ -366,7 +366,7 @@ const O = {
     { anyOf: [{ required: ["from"] }, { required: ["fromLocator"] }] },
     { anyOf: [{ required: ["to"] }, { required: ["toLocator"] }] }
   ]
-}, Lt = {
+}, Re = {
   type: "object",
   required: ["type", "content"],
   additionalProperties: !1,
@@ -381,7 +381,7 @@ const O = {
     color: { type: "string" }
   },
   anyOf: [{ required: ["at"] }, { required: ["locator"] }]
-}, Pt = {
+}, Ie = {
   type: "object",
   required: ["type", "content"],
   additionalProperties: !1,
@@ -400,7 +400,7 @@ const O = {
     { anyOf: [{ required: ["at"] }, { required: ["atLocator"] }] },
     { anyOf: [{ required: ["targetBbox"] }, { required: ["targetLocator"] }] }
   ]
-}, At = {
+}, _e = {
   type: "object",
   required: ["type", "svgFragment"],
   additionalProperties: !1,
@@ -408,9 +408,40 @@ const O = {
     type: { const: "raw" },
     svgFragment: { type: "string" }
   }
-}, Ot = {
-  oneOf: [$t, Et, xt, Lt, Pt, At]
-}, Rt = {
+}, 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: {
@@ -420,125 +451,144 @@ const O = {
     color: { type: "string" }
   },
   anyOf: [{ required: ["bbox"] }, { required: ["locator"] }]
-}, B = [137, 80, 78, 71, 13, 10, 26, 10], E = 12, St = "IHDR", Tt = 16, It = 20, U = 24;
-class v extends Error {
-  constructor(e) {
-    super(e), this.name = "InvalidPngError";
+}, 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";
   }
 }
-function M(t) {
-  if (t.byteLength < U)
-    throw new v(
-      `Expected at least ${U} bytes for a PNG header, got ${t.byteLength}.`
+function B(e) {
+  if (e.byteLength < G)
+    throw new x(
+      `Expected at least ${G} bytes for a PNG header, got ${e.byteLength}.`
     );
-  for (let a = 0; a < B.length; a++)
-    if (t[a] !== B[a])
-      throw new v(
+  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 e = new DataView(t.buffer, t.byteOffset, t.byteLength), r = String.fromCharCode(
-    t[E],
-    t[E + 1],
-    t[E + 2],
-    t[E + 3]
+  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 (r !== St)
-    throw new v(
-      `Expected IHDR chunk after PNG signature, found "${r}". The file may be a corrupt or non-standard PNG.`
+  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 o = e.getUint32(Tt, !1), i = e.getUint32(It, !1);
-  if (o === 0 || i === 0)
-    throw new v(`PNG dimensions ${o}×${i} include a zero axis.`);
-  return { width: o, height: i };
+  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 };
 }
-class y extends Error {
-  constructor(e) {
-    super(e), this.name = "InvalidImageInputError";
+class w extends Error {
+  constructor(t) {
+    super(t), this.name = "InvalidImageInputError";
   }
 }
-const _t = "data:", Ft = /^data:image\/png;base64,/i;
-async function A(t) {
-  if (typeof t != "string" || t.length === 0)
-    throw new y(
+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 (t.startsWith(_t))
-    return Ct(t);
-  if (!w(t))
-    throw new y(
-      `Filesystem path "${t}" is not absolute. Pass an absolute path so resolution doesn't depend on the MCP server's working directory.`
+  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 Nt(t);
+  return je(e);
 }
-function Ct(t) {
-  if (!Ft.test(t))
-    throw new y(
+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 e = t.slice(t.indexOf(",") + 1), r = Bt(e), o = H(r);
-  return { bytes: r, dataUrl: t, dimensions: o };
+  const t = e.slice(e.indexOf(",") + 1), o = Ge(t), n = z(o);
+  return { bytes: o, dataUrl: e, dimensions: n };
 }
-async function Nt(t) {
-  let e;
+async function je(e) {
+  let t;
   try {
-    const i = await rt(t);
-    e = new Uint8Array(i.buffer, i.byteOffset, i.byteLength);
-  } catch (i) {
-    const a = i instanceof Error ? i.message : String(i);
-    throw new y(`Failed to read image at "${t}": ${a}`);
+    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 r = H(e), o = `data:image/png;base64,${Ut(e)}`;
-  return { bytes: e, dataUrl: o, dimensions: r };
+  const o = z(t), n = `data:image/png;base64,${Me(t)}`;
+  return { bytes: t, dataUrl: n, dimensions: o };
 }
-function H(t) {
+function z(e) {
   try {
-    return M(t);
-  } catch (e) {
-    throw e instanceof v ? new y(e.message) : e;
+    return B(e);
+  } catch (t) {
+    throw t instanceof x ? new w(t.message) : t;
   }
 }
-function Bt(t) {
-  const e = Buffer.from(t, "base64");
-  return new Uint8Array(e.buffer, e.byteOffset, e.byteLength);
+function Ge(e) {
+  const t = Buffer.from(e, "base64");
+  return new Uint8Array(t.buffer, t.byteOffset, t.byteLength);
 }
-function Ut(t) {
-  return Buffer.from(t.buffer, t.byteOffset, t.byteLength).toString("base64");
+function Me(e) {
+  return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
 }
-const qt = "solid", Dt = "#000000", q = 16, kt = 12;
-async function W(t, e) {
-  if (e.length === 0)
-    return t;
-  const r = await T(Buffer.from(t)), o = _(r.width, r.height), i = o.getContext("2d");
-  i.drawImage(r, 0, 0);
-  for (const n of e) {
-    if (n.bbox.width <= 0 || n.bbox.height <= 0) continue;
-    switch (n.style ?? qt) {
+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":
-        Gt(i, n.bbox, n.color ?? Dt);
+        ze(s, r.bbox, r.color ?? We);
         break;
       case "mosaic":
-        Mt(i, r, n.bbox);
+        Ye(s, o, r.bbox);
         break;
       case "blur":
-        Ht(i, r, n.bbox);
+        Ve(s, o, r.bbox);
         break;
     }
   }
-  const a = o.toBuffer("image/png");
-  return new Uint8Array(a.buffer, a.byteOffset, a.byteLength);
+  const c = n.toBuffer("image/png");
+  return new Uint8Array(c.buffer, c.byteOffset, c.byteLength);
 }
-function Gt(t, e, r) {
-  t.save(), t.fillStyle = r, t.fillRect(e.x, e.y, e.width, e.height), t.restore();
+function ze(e, t, o) {
+  e.save(), e.fillStyle = o, e.fillRect(t.x, t.y, t.width, t.height), e.restore();
 }
-function Mt(t, e, r) {
-  const o = Math.max(1, Math.round(r.width / q)), i = Math.max(1, Math.round(r.height / q)), a = _(o, i), n = a.getContext("2d");
-  n.imageSmoothingEnabled = !1, n.drawImage(e, r.x, r.y, r.width, r.height, 0, 0, o, i), t.save(), t.imageSmoothingEnabled = !1, t.drawImage(a, 0, 0, o, i, r.x, r.y, r.width, r.height), t.restore();
+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 Ht(t, e, r) {
-  t.save(), t.beginPath(), t.rect(r.x, r.y, r.width, r.height), t.clip(), t.filter = `blur(${kt}px)`, t.drawImage(e, 0, 0), t.restore();
+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();
 }
-const j = "annot_annotate_screenshot", Wt = {
-  name: j,
+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 } : {}
+  };
+}
+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",
@@ -557,76 +607,92 @@ const j = "annot_annotate_screenshot", Wt = {
       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: {
-      ...O,
-      BboxAnnotation: Z
+      ...I,
+      BboxAnnotation: ne,
+      EncodeOptions: P
     }
   }
 };
-async function jt(t, e) {
+async function Qe(e, t) {
   try {
-    const r = Xt(t), o = await A(r.image), i = I(r.annotations), a = e.annotator.toPng({
-      originalDataUrl: o.dataUrl,
-      annotationsSvg: i,
-      width: o.dimensions.width,
-      height: o.dimensions.height
-    });
-    return r.output ? (await $(r.output, a), {
-      content: [
-        {
-          type: "text",
-          text: `Wrote ${a.byteLength}-byte annotated PNG to ${r.output} (${o.dimensions.width}×${o.dimensions.height}, ${r.annotations.length} annotation${r.annotations.length === 1 ? "" : "s"}).`
-        }
-      ]
-    }) : {
+    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: zt(a),
-          mimeType: "image/png"
+          data: et(r.bytes),
+          mimeType: r.mimeType
         }
       ]
     };
-  } catch (r) {
-    return Yt(r);
+  } catch (o) {
+    return Ze(o);
   }
 }
-function Xt(t) {
-  if (typeof t.image != "string")
-    throw new y("`image` is required and must be a string.");
-  if (!Array.isArray(t.annotations))
-    throw new S("`annotations` is required and must be an array.");
-  const e = t.annotations;
-  let r;
-  if (t.output !== void 0) {
-    if (typeof t.output != "string")
-      throw new S("`output` must be a string when provided.");
-    if (!w(t.output))
-      throw new S(
-        `\`output\` path "${t.output}" must be absolute so the file lands at a predictable location.`
+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.`
       );
-    r = t.output;
+    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: t.image, annotations: e, output: r };
+  return { image: e.image, annotations: t, output: o, encode: n };
 }
-class S extends Error {
-  constructor(e) {
-    super(e), this.name = "InvalidToolInputError";
+class A extends Error {
+  constructor(t) {
+    super(t), this.name = "InvalidToolInputError";
   }
 }
-function Yt(t) {
+function Ze(e) {
   return {
-    content: [{ type: "text", text: t instanceof Error ? `${t.name}: ${t.message}` : `Unknown error: ${String(t)}` }],
+    content: [{ type: "text", text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}` }],
     isError: !0
   };
 }
-function zt(t) {
-  return Buffer.from(t.buffer, t.byteOffset, t.byteLength).toString("base64");
+function et(e) {
+  return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
 }
-const X = "annot_annotate_url", Vt = {
-  name: X,
+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",
@@ -666,104 +732,121 @@ const X = "annot_annotate_url", Vt = {
       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: {
-      ...O,
-      LocatorAnnotation: Ot
+      ...I,
+      LocatorAnnotation: Ce,
+      EncodeOptions: P
     }
   }
 };
-class b extends Error {
-  constructor(e) {
-    super(e), this.name = "InvalidAnnotateUrlInputError";
+class y extends Error {
+  constructor(t) {
+    super(t), this.name = "InvalidAnnotateUrlInputError";
   }
 }
-async function Jt(t, e) {
+async function ot(e, t) {
   try {
-    const r = Kt(t), o = await k(e.pool, {
-      url: r.url,
-      viewport: r.viewport,
-      fullPage: r.fullPage,
-      waitFor: r.waitFor
+    const o = rt(e), n = await W(t.pool, {
+      url: o.url,
+      viewport: o.viewport,
+      fullPage: o.fullPage,
+      waitFor: o.waitFor
     });
-    let i;
+    let s;
     try {
-      i = await ht(
-        o.handle.page,
-        r.annotations
+      s = await be(
+        n.handle.page,
+        o.annotations
       );
     } finally {
-      await o.handle.close();
+      await n.handle.close();
     }
-    const a = M(o.pngBytes), n = I(i), s = e.annotator.toPng({
-      originalDataUrl: `data:image/png;base64,${D(o.pngBytes)}`,
-      annotationsSvg: n,
-      width: a.width,
-      height: a.height
-    });
-    return r.output ? (await $(r.output, s), {
-      content: [
-        {
-          type: "text",
-          text: `Wrote ${s.byteLength}-byte annotated PNG to ${r.output} (${a.width}×${a.height}, ${r.annotations.length} annotation${r.annotations.length === 1 ? "" : "s"}, captured from ${r.url}).`
-        }
-      ]
-    }) : {
+    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: D(s),
-          mimeType: "image/png"
+          data: H(i.bytes),
+          mimeType: i.mimeType
         }
       ]
     };
-  } catch (r) {
-    return Zt(r);
+  } catch (o) {
+    return nt(o);
   }
 }
-function Kt(t) {
-  if (typeof t.url != "string" || t.url.length === 0)
-    throw new b("`url` is required and must be a non-empty string.");
-  if (!Array.isArray(t.annotations))
-    throw new b("`annotations` is required and must be an array.");
-  const e = t.annotations;
-  let r;
-  if (t.viewport !== void 0) {
-    if (typeof t.viewport != "object" || t.viewport === null)
-      throw new b("`viewport` must be an object when provided.");
-    const n = t.viewport, s = typeof n.width == "number" ? n.width : 1280, c = typeof n.height == "number" ? n.height : 800, u = typeof n.deviceScaleFactor == "number" ? n.deviceScaleFactor : 1;
-    r = { width: s, height: c, deviceScaleFactor: u };
+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 o = t.fullPage === !0, i = t.waitFor === "domcontentloaded" || t.waitFor === "networkidle" ? t.waitFor : "load";
-  let a;
-  if (t.output !== void 0) {
-    if (typeof t.output != "string")
-      throw new b("`output` must be a string when provided.");
-    if (!w(t.output))
-      throw new b(`\`output\` path "${t.output}" must be absolute.`);
-    a = t.output;
+  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: t.url,
-    annotations: e,
-    viewport: r,
-    fullPage: o,
-    waitFor: i,
-    output: a
+    url: e.url,
+    annotations: t,
+    viewport: o,
+    fullPage: n,
+    waitFor: s,
+    output: c,
+    encode: r
   };
 }
-function Zt(t) {
+function nt(e) {
   return {
-    content: [{ type: "text", text: t instanceof Error ? `${t.name}: ${t.message}` : `Unknown error: ${String(t)}` }],
+    content: [{ type: "text", text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}` }],
     isError: !0
   };
 }
-function D(t) {
-  return Buffer.from(t.buffer, t.byteOffset, t.byteLength).toString("base64");
+function H(e) {
+  return Buffer.from(e.buffer, e.byteOffset, e.byteLength).toString("base64");
 }
-const Y = "annot_compare_screenshots", Qt = {
-  name: Y,
+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",
@@ -790,69 +873,88 @@ const Y = "annot_compare_screenshots", Qt = {
         default: !1,
         description: "When true, append a text content block listing the changed-region bboxes alongside the annotated PNG."
       },
-      output: { type: "string" }
+      output: { type: "string" },
+      encode: { $ref: "#/$defs/EncodeOptions" }
+    },
+    $defs: {
+      EncodeOptions: P
     }
   }
 };
-class x extends Error {
-  constructor(e) {
-    super(e), this.name = "InvalidCompareInputError";
+class $ extends Error {
+  constructor(t) {
+    super(t), this.name = "InvalidCompareInputError";
   }
 }
-async function te(t, e) {
+async function it(e, t) {
   try {
-    if (typeof t.before != "string")
-      throw new x("`before` is required and must be a string.");
-    if (typeof t.after != "string")
-      throw new x("`after` is required and must be a string.");
-    const r = typeof t.threshold == "number" ? t.threshold : 0.1, o = t.includeChangeList === !0;
-    let i;
-    if (t.output !== void 0) {
-      if (typeof t.output != "string")
-        throw new x("`output` must be a string when provided.");
-      if (!w(t.output))
-        throw new x(`\`output\` path "${t.output}" must be absolute.`);
-      i = t.output;
+    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;
     }
-    const [a, n] = await Promise.all([
-      A(t.before),
-      A(t.after)
-    ]), s = await vt(a.bytes, n.bytes, { threshold: r }), c = s.regions.map((d) => ({
+    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: d,
+      bbox: h,
       intent: "warning"
-    })), u = I(c), l = e.annotator.toPng({
-      originalDataUrl: n.dataUrl,
-      annotationsSvg: u,
-      width: s.width,
-      height: s.height
-    });
-    if (i)
-      return await $(i, l), { content: [{ type: "text", text: `Wrote ${l.byteLength}-byte diff-annotated PNG to ${i} (${s.width}×${s.height}, ${s.regions.length} changed region${s.regions.length === 1 ? "" : "s"}, ${s.mismatchedPixels} mismatched pixel${s.mismatchedPixels === 1 ? "" : "s"}).` }] };
-    const h = {
+    })), 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(l.buffer, l.byteOffset, l.byteLength).toString(
-        "base64"
-      ),
-      mimeType: "image/png"
+      data: Buffer.from(
+        u.bytes.buffer,
+        u.bytes.byteOffset,
+        u.bytes.byteLength
+      ).toString("base64"),
+      mimeType: u.mimeType
     };
-    if (!o)
-      return { content: [h] };
-    const R = `${s.regions.length} changed region${s.regions.length === 1 ? "" : "s"}, ${s.mismatchedPixels} mismatched pixel${s.mismatchedPixels === 1 ? "" : "s"}:
-` + s.regions.map((d, J) => `  [${J + 1}] x=${d.x} y=${d.y} w=${d.width} h=${d.height}`).join(`
+    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: [h, { type: "text", text: R }]
+      content: [_, { type: "text", text: ee }]
     };
-  } catch (r) {
+  } catch (o) {
     return {
-      content: [{ type: "text", text: r instanceof Error ? `${r.name}: ${r.message}` : `Unknown error: ${String(r)}` }],
+      content: [{ type: "text", text: o instanceof Error ? `${o.name}: ${o.message}` : `Unknown error: ${String(o)}` }],
       isError: !0
     };
   }
 }
-const z = "annot_redact_screenshot", ee = {
-  name: z,
+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",
@@ -867,64 +969,80 @@ const z = "annot_redact_screenshot", ee = {
         type: "array",
         items: { $ref: "#/$defs/BboxRedactRegion" }
       },
-      output: { type: "string" }
+      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: {
-      ...O,
-      BboxRedactRegion: Q
+      ...I,
+      BboxRedactRegion: se,
+      EncodeOptions: P
     }
   }
 };
-class L extends Error {
-  constructor(e) {
-    super(e), this.name = "InvalidRedactInputError";
+class E extends Error {
+  constructor(t) {
+    super(t), this.name = "InvalidRedactInputError";
   }
 }
-async function re(t) {
+async function ct(e) {
   try {
-    if (typeof t.image != "string")
-      throw new L("`image` is required and must be a string.");
-    if (!Array.isArray(t.regions))
-      throw new L("`regions` is required and must be an array.");
-    const e = t.regions;
-    let r;
-    if (t.output !== void 0) {
-      if (typeof t.output != "string")
-        throw new L("`output` must be a string when provided.");
-      if (!w(t.output))
-        throw new L(`\`output\` path "${t.output}" must be absolute.`);
-      r = t.output;
+    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;
     }
-    const o = await A(t.image), i = await W(o.bytes, e);
-    return r ? (await $(r, i), {
-      content: [
-        {
-          type: "text",
-          text: `Wrote ${i.byteLength}-byte redacted PNG to ${r} (${o.dimensions.width}×${o.dimensions.height}, ${e.length} region${e.length === 1 ? "" : "s"}).`
-        }
-      ]
-    }) : {
+    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(
-            i.buffer,
-            i.byteOffset,
-            i.byteLength
+            r.bytes.buffer,
+            r.bytes.byteOffset,
+            r.bytes.byteLength
           ).toString("base64"),
-          mimeType: "image/png"
+          mimeType: r.mimeType
         }
       ]
     };
-  } catch (e) {
+  } catch (t) {
     return {
-      content: [{ type: "text", text: e instanceof Error ? `${e.name}: ${e.message}` : `Unknown error: ${String(e)}` }],
+      content: [{ type: "text", text: t instanceof Error ? `${t.name}: ${t.message}` : `Unknown error: ${String(t)}` }],
       isError: !0
     };
   }
 }
-const V = "annot_redact_url", oe = {
-  name: V,
+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",
@@ -951,186 +1069,199 @@ const V = "annot_redact_url", oe = {
         enum: ["load", "domcontentloaded", "networkidle"],
         default: "load"
       },
-      output: { type: "string" }
+      output: { type: "string" },
+      encode: { $ref: "#/$defs/EncodeOptions" }
     },
     $defs: {
-      ...O,
-      LocatorRedactRegion: Rt
+      ...I,
+      LocatorRedactRegion: Ue,
+      EncodeOptions: P
     }
   }
 };
-class g extends Error {
-  constructor(e) {
-    super(e), this.name = "InvalidRedactUrlInputError";
+class p extends Error {
+  constructor(t) {
+    super(t), this.name = "InvalidRedactUrlInputError";
   }
 }
-async function ne(t, e) {
+async function lt(e, t) {
   try {
-    const r = ie(t), o = await k(e.pool, {
-      url: r.url,
-      viewport: r.viewport,
-      fullPage: r.fullPage,
-      waitFor: r.waitFor
+    const o = ut(e), n = await W(t.pool, {
+      url: o.url,
+      viewport: o.viewport,
+      fullPage: o.fullPage,
+      waitFor: o.waitFor
     });
-    let i;
+    let s;
     try {
-      i = [];
-      for (const n of r.regions) {
-        const c = { bbox: await ae(o.handle.page, n) };
-        n.style !== void 0 && (c.style = n.style), n.color !== void 0 && (c.color = n.color), i.push(c);
+      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 o.handle.close();
+      await n.handle.close();
     }
-    const a = await W(o.pngBytes, i);
-    return r.output ? (await $(r.output, a), {
-      content: [
-        {
-          type: "text",
-          text: `Wrote ${a.byteLength}-byte redacted PNG to ${r.output} (${r.regions.length} region${r.regions.length === 1 ? "" : "s"}, captured from ${r.url}).`
-        }
-      ]
-    }) : {
+    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.buffer,
-            a.byteOffset,
-            a.byteLength
+            a.bytes.buffer,
+            a.bytes.byteOffset,
+            a.bytes.byteLength
           ).toString("base64"),
-          mimeType: "image/png"
+          mimeType: a.mimeType
         }
       ]
     };
-  } catch (r) {
+  } catch (o) {
     return {
-      content: [{ type: "text", text: r instanceof Error ? `${r.name}: ${r.message}` : `Unknown error: ${String(r)}` }],
+      content: [{ type: "text", text: o instanceof Error ? `${o.name}: ${o.message}` : `Unknown error: ${String(o)}` }],
       isError: !0
     };
   }
 }
-function ie(t) {
-  if (typeof t.url != "string" || t.url.length === 0)
-    throw new g("`url` is required and must be a non-empty string.");
-  if (!Array.isArray(t.regions))
-    throw new g("`regions` is required and must be an array.");
-  const e = t.regions;
-  let r;
-  if (t.viewport !== void 0) {
-    if (typeof t.viewport != "object" || t.viewport === null)
-      throw new g("`viewport` must be an object when provided.");
-    const n = t.viewport, s = typeof n.width == "number" ? n.width : 1280, c = typeof n.height == "number" ? n.height : 800, u = typeof n.deviceScaleFactor == "number" ? n.deviceScaleFactor : 1;
-    r = { width: s, height: c, deviceScaleFactor: u };
+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 o = t.fullPage === !0, i = t.waitFor === "domcontentloaded" || t.waitFor === "networkidle" ? t.waitFor : "load";
-  let a;
-  if (t.output !== void 0) {
-    if (typeof t.output != "string")
-      throw new g("`output` must be a string when provided.");
-    if (!w(t.output))
-      throw new g(`\`output\` path "${t.output}" must be absolute.`);
-    a = t.output;
+  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;
   }
-  return { url: t.url, regions: e, viewport: r, fullPage: o, waitFor: i, output: a };
+  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 };
 }
-async function ae(t, e) {
-  if (e.bbox !== void 0) return e.bbox;
-  if (e.locator !== void 0) return f(t, e.locator);
-  throw new g("redact region requires either `bbox` or `locator`.");
+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`.");
 }
-const se = "annot-mcp", ce = "0.1.0", ue = [
-  Wt,
-  Vt,
-  ee,
-  oe,
-  Qt
+const ft = "annot-mcp", pt = "0.1.0", mt = [
+  Je,
+  tt,
+  at,
+  dt,
+  st
 ];
-function le(t = {}) {
-  const e = new ot(
+function gt(e = {}) {
+  const t = new de(
     {
-      name: se,
-      version: t.version ?? ce
+      name: ft,
+      version: e.version ?? pt
     },
     {
       capabilities: {
         tools: {}
       }
     }
-  ), r = t.annotator ?? tt(t.annotatorOptions ?? {}), o = t.pool ?? dt();
-  return e.setRequestHandler(nt, async () => ({ tools: ue })), e.setRequestHandler(it, async (i) => {
-    const { name: a, arguments: n } = i.params;
-    let s;
-    switch (a) {
-      case j:
-        s = await jt(n ?? {}, { annotator: r });
+  ), 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 X:
-        s = await Jt(n ?? {}, { annotator: r, pool: o });
+      case J:
+        a = await ot(r ?? {}, { annotator: o, pool: n });
         break;
-      case z:
-        s = await re(n ?? {});
+      case K:
+        a = await ct(r ?? {});
         break;
-      case V:
-        s = await ne(n ?? {}, { pool: o });
+      case Z:
+        a = await lt(r ?? {}, { pool: n });
         break;
-      case Y:
-        s = await te(n ?? {}, { annotator: r });
+      case Q:
+        a = await it(r ?? {}, { annotator: o });
         break;
       default:
-        s = {
-          content: [{ type: "text", text: `Unknown tool: ${a}` }],
+        a = {
+          content: [{ type: "text", text: `Unknown tool: ${c}` }],
           isError: !0
         };
     }
-    return s;
-  }), e;
+    return a;
+  }), t;
 }
-async function be() {
-  const t = le(), e = new at();
-  await t.connect(e);
+async function Pt() {
+  const e = gt(), t = new he();
+  await e.connect(t);
 }
 export {
-  j as ANNOTATE_SCREENSHOT_TOOL_NAME,
-  X as ANNOTATE_URL_TOOL_NAME,
-  Ee as BBOX_ANNOTATION_SCHEMA,
-  xe as BBOX_REDACT_REGION_SCHEMA,
-  lt as BrowserPool,
-  Y as COMPARE_SCREENSHOTS_TOOL_NAME,
-  C as ChromiumUnavailableError,
-  bt as DimensionMismatchError,
-  y as InvalidImageInputError,
-  v as InvalidPngError,
-  Ot as LOCATOR_ANNOTATION_SCHEMA,
-  Rt as LOCATOR_REDACT_REGION_SCHEMA,
-  F as LocatorResolutionError,
-  z as REDACT_SCREENSHOT_TOOL_NAME,
-  V as REDACT_URL_TOOL_NAME,
-  O as SHARED_DEFS,
-  yt as aggregateDiffRegions,
-  Wt as annotateScreenshotTool,
-  Vt as annotateUrlTool,
-  Le as arrowBetween,
-  Pe as bboxAnnotationsToSvg,
-  W as burnRedactions,
-  k as capturePage,
-  Qt as compareScreenshotsTool,
-  dt as createChromiumPool,
-  le as createServer,
-  vt as diffScreenshots,
-  jt as handleAnnotateScreenshot,
-  Jt as handleAnnotateUrl,
-  te as handleCompareScreenshots,
-  re as handleRedactScreenshot,
-  ne as handleRedactUrl,
-  M as readPngDimensions,
-  Ae as rectForBoundingBox,
-  ee as redactScreenshotTool,
-  oe as redactUrlTool,
-  A as resolveImageInput,
+  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,
-  ft as resolveLocatorAnnotation,
-  ht as resolveLocatorAnnotations,
-  be as runStdioServer,
-  Oe as textAt
+  we as resolveLocatorAnnotation,
+  be as resolveLocatorAnnotations,
+  Pt as runStdioServer,
+  Ct as textAt
 };