@topazlabs/mcp 0.1.0

package/README.md

@@ -0,0 +1,96 @@
+# @topazlabs/mcp
+
+AI image enhancement and comparison for LLMs via the [Model Context Protocol](https://modelcontextprotocol.io).
+
+Built by [Topaz Labs](https://www.topazlabs.com) — the company behind industry-leading AI upscaling and enhancement tools.
+
+## Quick Start
+
+```bash
+npx @topazlabs/mcp
+```
+
+No install required. The server starts on stdio and connects to any MCP client.
+
+## Configuration
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "topaz": {
+      "command": "npx",
+      "args": ["-y", "@topazlabs/mcp"],
+      "env": {
+        "TOPAZ_API_KEY": "<your-api-key>"
+      }
+    }
+  }
+}
+```
+
+### HTTP Mode (hosted)
+
+```bash
+TOPAZ_API_KEY=<key> MCP_AUTH_TOKEN=<token> PORT=3001 npx @topazlabs/mcp --http
+```
+
+## Tools
+
+### `enhance`
+
+Enhance an image using Topaz Labs AI. Upscales, sharpens, and improves quality.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `image` | string | ✅ | Local file path or URL |
+| `size` | object | | Output size spec (see below) |
+| `model` | string | | Model name (auto-selects if omitted) |
+
+**Size options:**
+
+```json
+{ "width": 1920, "height": 1080 }  // Exact dimensions
+{ "width": 1920 }                   // Scale proportionally
+{ "height": 1080 }                  // Scale proportionally
+{ "scale": 2.5 }                    // Multiply original dimensions
+```
+
+Blank defaults to auto-upscale: images under 4K get upscaled to 4K width; images already 4K+ stay at 1x.
+
+**Auto model selection:**
+
+| Image Size | Default Model |
+|-----------|--------------|
+| Under 4K | Wonder |
+| 4K+ | Standard V2 (with face enhancement) |
+
+**Available models:** Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, Redefine, Recovery V2, Standard MAX, Wonder, Bloom
+
+### `compare`
+
+Compare two images side-by-side with an interactive before/after slider viewer.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `before` | string | ✅ | Path or URL to the "before" image |
+| `after` | string | ✅ | Path or URL to the "after" image |
+| `label_before` | string | | Label for before image (default: "Before") |
+| `label_after` | string | | Label for after image (default: "After") |
+
+**Viewer features:** Draggable slider, zoom (100%/200%/400%), pan, keyboard shortcuts (1/2/3 for before/split/after).
+
+## API Key
+
+Get your API key at [topazlabs.com](https://www.topazlabs.com). Set it as the `TOPAZ_API_KEY` environment variable.
+
+## License
+
+MIT

package/dist/api/client.d.ts

@@ -0,0 +1,31 @@
+import type { EnhanceRequest, SubmitResponse, StatusResponse, DownloadResponse } from "./types.js";
+export interface TopazClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}
+export declare class TopazClient {
+    private apiKey;
+    private baseUrl;
+    private pollIntervalMs;
+    private timeoutMs;
+    constructor(options: TopazClientOptions);
+    private headers;
+    private buildFormData;
+    enhance(req: EnhanceRequest): Promise<SubmitResponse>;
+    private submitJob;
+    getStatus(processId: string): Promise<StatusResponse>;
+    getDownloadUrl(processId: string): Promise<DownloadResponse>;
+    downloadToFile(processId: string, outputDir: string): Promise<string>;
+    pollUntilComplete(processId: string, onProgress?: (status: StatusResponse) => void): Promise<StatusResponse>;
+}
+export declare class TopazApiError extends Error {
+    statusCode: number;
+    constructor(statusCode: number, message: string);
+}
+export declare function readImageFile(filePath: string): {
+    buffer: Buffer;
+    filename: string;
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,kBAAkB;IAOvC,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,aAAa;IA6Bf,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;YAW7C,SAAS;IA6BjB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcrD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAc5D,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBrE,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAC5C,OAAO,CAAC,cAAc,CAAC;CAqB3B;AAED,qBAAa,aAAc,SAAQ,KAAK;IAC/B,UAAU,EAAE,MAAM,CAAC;gBACd,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKhD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAKA"}

package/dist/api/client.js

@@ -0,0 +1,150 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { validateReadPath } from "../lib/path-security.js";
+import { isGenerativeEnhanceModel } from "./models.js";
+const BASE_URL = "https://api.topazlabs.com/image/v1";
+const DEFAULT_POLL_INTERVAL_MS = 2000;
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
+export class TopazClient {
+    apiKey;
+    baseUrl;
+    pollIntervalMs;
+    timeoutMs;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? BASE_URL;
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    headers() {
+        return { "X-API-Key": this.apiKey };
+    }
+    buildFormData(params, imageBuffer, imageFilename) {
+        const form = new FormData();
+        if (imageBuffer) {
+            const filename = imageFilename ?? "image.jpg";
+            const ext = path.extname(filename).toLowerCase();
+            const mimeMap = {
+                ".jpg": "image/jpeg",
+                ".jpeg": "image/jpeg",
+                ".png": "image/png",
+                ".tif": "image/tiff",
+                ".tiff": "image/tiff",
+                ".webp": "image/webp",
+            };
+            const mime = mimeMap[ext] ?? "image/jpeg";
+            const blob = new Blob([new Uint8Array(imageBuffer)], { type: mime });
+            form.append("image", blob, filename);
+        }
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (key === "image" || key === "image_filename")
+                continue;
+            form.append(key, String(value));
+        }
+        return form;
+    }
+    async enhance(req) {
+        const isGen = req.model ? isGenerativeEnhanceModel(req.model) : false;
+        const endpoint = isGen ? "/enhance-gen/async" : "/enhance/async";
+        return this.submitJob(endpoint, req, req.image, req.image_filename);
+    }
+    async submitJob(endpoint, params, imageBuffer, imageFilename) {
+        const form = this.buildFormData(params, imageBuffer, imageFilename);
+        const resp = await fetch(`${this.baseUrl}${endpoint}`, {
+            method: "POST",
+            headers: this.headers(),
+            body: form,
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new TopazApiError(resp.status, `Submit failed: ${resp.status} ${text}`);
+        }
+        const json = (await resp.json());
+        const processId = json.process_id ?? resp.headers.get("X-Process-ID");
+        const eta = json.eta ?? (Number(resp.headers.get("X-ETA")) || 0);
+        if (!processId) {
+            throw new TopazApiError(0, "No process_id in response");
+        }
+        return { process_id: processId, eta };
+    }
+    async getStatus(processId) {
+        const resp = await fetch(`${this.baseUrl}/status/${processId}`, {
+            headers: this.headers(),
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new TopazApiError(resp.status, `Status check failed: ${resp.status} ${text}`);
+        }
+        return (await resp.json());
+    }
+    async getDownloadUrl(processId) {
+        const resp = await fetch(`${this.baseUrl}/download/${processId}`, {
+            headers: this.headers(),
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new TopazApiError(resp.status, `Download URL fetch failed: ${resp.status} ${text}`);
+        }
+        return (await resp.json());
+    }
+    async downloadToFile(processId, outputDir) {
+        const { download_url } = await this.getDownloadUrl(processId);
+        const resp = await fetch(download_url);
+        if (!resp.ok) {
+            throw new TopazApiError(resp.status, `Image download failed: ${resp.status}`);
+        }
+        const ct = resp.headers.get("content-type") ?? "image/png";
+        const extMap = {
+            "image/jpeg": ".jpg",
+            "image/png": ".png",
+            "image/tiff": ".tiff",
+        };
+        const ext = extMap[ct] ?? ".png";
+        const filename = `topaz-${processId}${ext}`;
+        const filepath = path.join(outputDir, filename);
+        fs.mkdirSync(outputDir, { recursive: true });
+        const buffer = Buffer.from(await resp.arrayBuffer());
+        fs.writeFileSync(filepath, buffer);
+        return filepath;
+    }
+    async pollUntilComplete(processId, onProgress) {
+        const startTime = Date.now();
+        while (true) {
+            const status = await this.getStatus(processId);
+            if (onProgress)
+                onProgress(status);
+            if (status.status === "Completed")
+                return status;
+            if (status.status === "Failed") {
+                throw new TopazApiError(0, `Job ${processId} failed`);
+            }
+            if (status.status === "Cancelled") {
+                throw new TopazApiError(0, `Job ${processId} was cancelled`);
+            }
+            if (Date.now() - startTime > this.timeoutMs) {
+                throw new TopazApiError(0, `Job ${processId} timed out after ${this.timeoutMs / 1000}s`);
+            }
+            await sleep(this.pollIntervalMs);
+        }
+    }
+}
+export class TopazApiError extends Error {
+    statusCode;
+    constructor(statusCode, message) {
+        super(message);
+        this.name = "TopazApiError";
+        this.statusCode = statusCode;
+    }
+}
+export function readImageFile(filePath) {
+    const validatedPath = validateReadPath(filePath);
+    const buffer = fs.readFileSync(validatedPath);
+    const filename = path.basename(validatedPath);
+    return { buffer, filename };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/models.d.ts

@@ -0,0 +1,19 @@
+import type { EnhanceModel, EnhanceGenerativeModel } from "./types.js";
+export interface ModelInfo {
+    description: string;
+    type: "standard" | "generative";
+    bestFor: string;
+}
+export declare const ENHANCE_MODELS: Record<EnhanceModel, ModelInfo>;
+export declare function isGenerativeEnhanceModel(model: string): model is EnhanceGenerativeModel;
+/** 4K width threshold */
+export declare const FOUR_K_WIDTH = 3840;
+/**
+ * Auto-select model based on image dimensions.
+ * Under 4K → Wonder (best for low-res), 4K+ → Standard V2.
+ */
+export declare function autoSelectModel(imageWidth: number): {
+    model: EnhanceModel;
+    faceEnhancement: boolean;
+};
+//# sourceMappingURL=models.d.ts.map

package/dist/api/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/api/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,CAmD1D,CAAC;AAUF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,sBAAsB,CAEjC;AAED,yBAAyB;AACzB,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IACnD,KAAK,EAAE,YAAY,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAKA"}

package/dist/api/models.js

@@ -0,0 +1,75 @@
+export const ENHANCE_MODELS = {
+    "Standard V2": {
+        description: "Balanced enhancement for most photos",
+        type: "standard",
+        bestFor: "General photos",
+    },
+    "Low Resolution V2": {
+        description: "Best for very small or low-quality images",
+        type: "standard",
+        bestFor: "Tiny images, thumbnails",
+    },
+    CGI: {
+        description: "Optimized for digital art, renders, and illustrations",
+        type: "standard",
+        bestFor: "Digital art, CGI, illustrations",
+    },
+    "High Fidelity V2": {
+        description: "Maximum detail preservation for high-quality sources",
+        type: "standard",
+        bestFor: "Already-good photos needing upscale",
+    },
+    "Text Refine": {
+        description: "Preserves and sharpens text in images",
+        type: "standard",
+        bestFor: "Screenshots, documents, text-heavy images",
+    },
+    Redefine: {
+        description: "AI-powered creative enhancement",
+        type: "generative",
+        bestFor: "Creative reinterpretation",
+    },
+    "Recovery V2": {
+        description: "Restores old, damaged, or heavily degraded photos",
+        type: "generative",
+        bestFor: "Old photos, damaged images",
+    },
+    "Standard MAX": {
+        description: "Maximum quality generative enhancement",
+        type: "generative",
+        bestFor: "Best possible quality, slow",
+    },
+    Wonder: {
+        description: "Best for low-res images with text, logos, or fine detail",
+        type: "generative",
+        bestFor: "Low-res images, text, logos",
+    },
+    Bloom: {
+        description: "Creative/artistic generative enhancement",
+        type: "generative",
+        bestFor: "Stylistic detail, creative enhancement",
+    },
+};
+const GENERATIVE_ENHANCE_MODELS = new Set([
+    "Redefine",
+    "Recovery V2",
+    "Standard MAX",
+    "Wonder",
+    "Bloom",
+]);
+export function isGenerativeEnhanceModel(model) {
+    return GENERATIVE_ENHANCE_MODELS.has(model);
+}
+/** 4K width threshold */
+export const FOUR_K_WIDTH = 3840;
+/**
+ * Auto-select model based on image dimensions.
+ * Under 4K → Wonder (best for low-res), 4K+ → Standard V2.
+ */
+export function autoSelectModel(imageWidth) {
+    if (imageWidth < FOUR_K_WIDTH) {
+        return { model: "Wonder", faceEnhancement: false };
+    }
+    return { model: "Standard V2", faceEnhancement: true };
+}
+//# sourceMappingURL=models.js.map

package/dist/api/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/api/models.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,cAAc,GAAoC;IAC7D,aAAa,EAAE;QACb,WAAW,EAAE,sCAAsC;QACnD,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,gBAAgB;KAC1B;IACD,mBAAmB,EAAE;QACnB,WAAW,EAAE,2CAA2C;QACxD,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,yBAAyB;KACnC;IACD,GAAG,EAAE;QACH,WAAW,EAAE,uDAAuD;QACpE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,iCAAiC;KAC3C;IACD,kBAAkB,EAAE;QAClB,WAAW,EAAE,sDAAsD;QACnE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,qCAAqC;KAC/C;IACD,aAAa,EAAE;QACb,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,2CAA2C;KACrD;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,iCAAiC;QAC9C,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,2BAA2B;KACrC;IACD,aAAa,EAAE;QACb,WAAW,EAAE,mDAAmD;QAChE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,4BAA4B;KACtC;IACD,cAAc,EAAE;QACd,WAAW,EAAE,wCAAwC;QACrD,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,6BAA6B;KACvC;IACD,MAAM,EAAE;QACN,WAAW,EAAE,0DAA0D;QACvE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,6BAA6B;KACvC;IACD,KAAK,EAAE;QACL,WAAW,EAAE,0CAA0C;QACvD,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,wCAAwC;KAClD;CACF,CAAC;AAEF,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS;IAChD,UAAU;IACV,aAAa;IACb,cAAc;IACd,QAAQ;IACR,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACtC,KAAa;IAEb,OAAO,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAIhD,IAAI,UAAU,GAAG,YAAY,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC"}

package/dist/api/types.d.ts

@@ -0,0 +1,40 @@
+export type ImageFormat = "jpeg" | "png" | "tiff";
+export type JobStatus = "Pending" | "Processing" | "Completed" | "Failed" | "Cancelled";
+export type EnhanceStandardModel = "Standard V2" | "Low Resolution V2" | "CGI" | "High Fidelity V2" | "Text Refine";
+export type EnhanceGenerativeModel = "Redefine" | "Recovery V2" | "Standard MAX" | "Wonder" | "Bloom";
+export type EnhanceModel = EnhanceStandardModel | EnhanceGenerativeModel;
+export interface EnhanceRequest {
+    image?: Buffer;
+    image_filename?: string;
+    source_url?: string;
+    model?: EnhanceModel;
+    output_width?: number;
+    output_height?: number;
+    output_format?: ImageFormat;
+    face_enhancement?: boolean;
+}
+export interface SubmitResponse {
+    process_id: string;
+    eta: number;
+}
+export interface StatusResponse {
+    process_id: string;
+    input_format?: string;
+    input_height?: number;
+    input_width?: number;
+    output_format?: string;
+    output_height?: number;
+    output_width?: number;
+    model?: string;
+    status: JobStatus;
+    progress: number;
+    eta: number;
+    creation_time: number;
+    modification_time: number;
+}
+export interface DownloadResponse {
+    download_url: string;
+    input_download_url?: string;
+    expiration: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAExF,MAAM,MAAM,oBAAoB,GAC5B,aAAa,GACb,mBAAmB,GACnB,KAAK,GACL,kBAAkB,GAClB,aAAa,CAAC;AAElB,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,aAAa,GACb,cAAc,GACd,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,sBAAsB,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/api/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":""}

package/dist/apps/viewer.html

@@ -0,0 +1,51 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Compare</title>
+  <script type="module" crossorigin>(function(){const o=document.createElement("link").relList;if(o&&o.supports&&o.supports("modulepreload"))return;for(const n of document.querySelectorAll('link[rel="modulepreload"]'))r(n);new MutationObserver(n=>{for(const i of n)if(i.type==="childList")for(const b of i.addedNodes)b.tagName==="LINK"&&b.rel==="modulepreload"&&r(b)}).observe(document,{childList:!0,subtree:!0});function s(n){const i={};return n.integrity&&(i.integrity=n.integrity),n.referrerPolicy&&(i.referrerPolicy=n.referrerPolicy),n.crossOrigin==="use-credentials"?i.credentials="include":n.crossOrigin==="anonymous"?i.credentials="omit":i.credentials="same-origin",i}function r(n){if(n.ep)return;n.ep=!0;const i=s(n);fetch(n.href,i)}})();const y=window.__COMPARE_DATA__??{before:"",after:"",labelBefore:"Before",labelAfter:"After"},t=document.getElementById("viewport"),B=document.getElementById("canvas"),d=document.getElementById("img-before"),f=document.getElementById("img-after"),P=document.getElementById("clip-before"),R=document.getElementById("slider"),Z=document.getElementById("label-before"),_=document.getElementById("label-after"),M=document.getElementById("meta-before"),$=document.getElementById("meta-after"),F=document.getElementById("zoom-level"),w=document.getElementById("btn-before"),C=document.getElementById("btn-split"),A=document.getElementById("btn-after"),T=document.getElementById("btn-zoom-in"),D=document.getElementById("btn-zoom-out"),N=document.getElementById("btn-zoom-fit");let c=0,a=0,l=1,m=0,p=0,L=.5,S="split";const E=[.25,.5,.75,1,1.5,2,3,4];Z.textContent=y.labelBefore;_.textContent=y.labelAfter;let I=0;function k(e,o){const s=e==="before"?M:$;s.textContent=`${y[`label${e==="before"?"Before":"After"}`]}: ${o.naturalWidth}×${o.naturalHeight}`,I++,I>=2&&q()}d.onload=()=>k("before",d);f.onload=()=>k("after",f);d.onerror=()=>{M.textContent="Failed to load before image"};f.onerror=()=>{$.textContent="Failed to load after image"};d.src=y.before;f.src=y.after;function q(){c=Math.max(d.naturalWidth,f.naturalWidth),a=Math.max(d.naturalHeight,f.naturalHeight),v()}function v(){const e=t.clientWidth,o=t.clientHeight;!c||!a||!e||!o||(l=Math.min(e/c,o/a,1),m=(e-c*l)/2,p=(o-a*l)/2,x())}function x(){B.style.transform=`translate(${m}px, ${p}px) scale(${l})`,B.style.width=`${c}px`,B.style.height=`${a}px`,d.style.width=f.style.width=`${c}px`,d.style.height=f.style.height=`${a}px`,O(),F.textContent=`${Math.round(l*100)}%`,t.classList.toggle("can-pan",l>Math.min(t.clientWidth/c,t.clientHeight/a,1)+.01)}function O(){const e=L*c;P.style.width=`${e}px`,R.style.left=`${e}px`}function u(e){S=e,t.classList.remove("mode-before","mode-after"),e!=="split"&&t.classList.add(`mode-${e}`),w.classList.toggle("active",e==="before"),C.classList.toggle("active",e==="split"),A.classList.toggle("active",e==="after")}w.addEventListener("click",()=>u("before"));C.addEventListener("click",()=>u("split"));A.addEventListener("click",()=>u("after"));function X(e,o,s){const r=o??t.clientWidth/2,n=s??t.clientHeight/2,i=(r-m)/l,b=(n-p)/l;l=Math.max(.1,Math.min(8,e)),m=r-i*l,p=n-b*l,x()}function h(e,o,s){const r=l;let n=r;if(e===1)n=E.find(i=>i>r+.01)??r*1.5;else{for(let i=E.length-1;i>=0;i--)if(E[i]<r-.01){n=E[i];break}n===r&&(n=r/1.5)}X(n,o,s)}T.addEventListener("click",()=>h(1));D.addEventListener("click",()=>h(-1));N.addEventListener("click",v);t.addEventListener("wheel",e=>{e.preventDefault();const o=e.deltaY<0?1:-1;h(o,e.clientX,e.clientY-t.getBoundingClientRect().top)},{passive:!1});let g=null,H=0,W=0,Y=0,z=0;function K(e){if(S!=="split")return!1;const o=t.getBoundingClientRect(),s=m+L*c*l;return Math.abs(e.clientX-o.left-s)<20}t.addEventListener("pointerdown",e=>{e.button===0&&(e.preventDefault(),t.setPointerCapture(e.pointerId),K(e)?(g="slider",t.classList.add("dragging-slider")):(g="pan",H=e.clientX,W=e.clientY,Y=m,z=p,t.classList.add("panning")))});t.addEventListener("pointermove",e=>{if(!g)return;const o=t.getBoundingClientRect();if(g==="slider"){const s=e.clientX-o.left;L=Math.max(0,Math.min(1,(s-m)/(c*l))),O()}else g==="pan"&&(m=Y+(e.clientX-H),p=z+(e.clientY-W),x())});t.addEventListener("pointerup",()=>{g=null,t.classList.remove("dragging-slider","panning")});t.addEventListener("dblclick",e=>{const o=t.getBoundingClientRect(),s=e.clientY-o.top,r=Math.min(t.clientWidth/c,t.clientHeight/a,1);Math.abs(l-r)<.05?X(2,e.clientX-o.left,s):v()});new ResizeObserver(()=>{l<=Math.min(t.clientWidth/c,t.clientHeight/a,1)+.05&&v()}).observe(t);document.addEventListener("keydown",e=>{e.key==="1"?u("before"):e.key==="2"?u("split"):e.key==="3"?u("after"):e.key==="+"||e.key==="="?h(1):e.key==="-"?h(-1):e.key==="0"&&v()});</script>
+  <style rel="stylesheet" crossorigin>*,*:before,*:after{box-sizing:border-box;margin:0;padding:0}:root{--bg: #1a1a1a;--surface: #242424;--border: #333;--text: #e8e8e8;--text-muted: #888;--accent: #7c6bf5;--handle: #fff;--slider-line: rgba(255,255,255,.6)}html,body{height:100%;background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,Segoe UI,system-ui,sans-serif;font-size:13px;overflow:hidden;user-select:none;-webkit-user-select:none}#app{display:flex;flex-direction:column;height:100%}#toolbar{background:var(--surface);border-bottom:1px solid var(--border);padding:8px 12px;display:flex;flex-direction:column;gap:6px;flex-shrink:0}#labels-bar{display:flex;justify-content:space-between}.label{font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--text-muted)}#controls{display:flex;align-items:center;gap:4px;justify-content:center;flex-wrap:wrap}#controls button{background:transparent;border:1px solid var(--border);color:var(--text);padding:4px 10px;border-radius:4px;cursor:pointer;font-size:12px;font-family:inherit;transition:all .15s}#controls button:hover{background:var(--border)}#controls button.active{background:var(--accent);border-color:var(--accent);color:#fff}.separator{width:1px;height:20px;background:var(--border);margin:0 4px}#zoom-level{font-size:12px;font-variant-numeric:tabular-nums;min-width:40px;text-align:center;color:var(--text-muted)}#viewport{flex:1;overflow:hidden;position:relative;cursor:default}#viewport.dragging-slider{cursor:ew-resize}#viewport.panning{cursor:grabbing}#viewport.can-pan{cursor:grab}#canvas{position:absolute;transform-origin:0 0}#canvas img{display:block;pointer-events:none;-webkit-user-drag:none}#img-after{position:relative}#clip-before{position:absolute;top:0;left:0;height:100%;overflow:hidden}#clip-before img{display:block}#slider{position:absolute;top:0;height:100%;width:3px;transform:translate(-50%);z-index:10;cursor:ew-resize}#slider-line{position:absolute;top:0;left:50%;transform:translate(-50%);width:2px;height:100%;background:var(--slider-line);box-shadow:0 0 6px #00000080}#slider-handle{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:36px;height:36px;border-radius:50%;background:#000000b3;border:2px solid var(--handle);display:flex;align-items:center;justify-content:center;box-shadow:0 2px 8px #0006;cursor:ew-resize;transition:transform .1s}#slider-handle:hover{transform:translate(-50%,-50%) scale(1.1)}#meta-bar{background:var(--surface);border-top:1px solid var(--border);padding:4px 12px;display:flex;justify-content:space-between;font-size:11px;color:var(--text-muted);flex-shrink:0}.mode-before #clip-before{width:100%!important}.mode-before #slider{display:none}.mode-after #clip-before{width:0!important}.mode-after #slider{display:none}</style>
+</head>
+<body>
+  <div id="app">
+    <div id="toolbar">
+      <div id="labels-bar">
+        <span id="label-before" class="label">Before</span>
+        <span id="label-after" class="label">After</span>
+      </div>
+      <div id="controls">
+        <button id="btn-before" title="Show Before">◀ Before</button>
+        <button id="btn-split" class="active" title="Split View">Split</button>
+        <button id="btn-after" title="Show After">After ▶</button>
+        <span class="separator"></span>
+        <button id="btn-zoom-in" title="Zoom In">+</button>
+        <span id="zoom-level">100%</span>
+        <button id="btn-zoom-out" title="Zoom Out">−</button>
+        <button id="btn-zoom-fit" title="Fit">Fit</button>
+      </div>
+    </div>
+    <div id="viewport">
+      <div id="canvas">
+        <img id="img-after" alt="After" />
+        <div id="clip-before">
+          <img id="img-before" alt="Before" />
+        </div>
+        <div id="slider">
+          <div id="slider-line"></div>
+          <div id="slider-handle">
+            <svg width="24" height="24" viewBox="0 0 24 24" fill="none">
+              <path d="M9 18L3 12L9 6" stroke="white" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+              <path d="M15 6L21 12L15 18" stroke="white" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+            </svg>
+          </div>
+        </div>
+      </div>
+    </div>
+    <div id="meta-bar">
+      <span id="meta-before"></span>
+      <span id="meta-after"></span>
+    </div>
+  </div>
+</body>
+</html>

package/dist/lib/create-main.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Create and start the MCP server in the appropriate transport mode.
+ *
+ * - If `--http` flag or `PORT` env var is set → HTTP mode (strict path security)
+ * - Otherwise → stdio mode (CWD + temp allowed)
+ */
+export declare function createMain(createServer: () => McpServer): Promise<void>;
+//# sourceMappingURL=create-main.d.ts.map

package/dist/lib/create-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-main.d.ts","sourceRoot":"","sources":["../../src/lib/create-main.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/lib/create-main.js

@@ -0,0 +1,27 @@
+/**
+ * Entry-point factory — handles stdio vs HTTP transport selection,
+ * configures path security, and starts the server.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { startHttpServer } from "./http-server.js";
+import { configurePathSecurity } from "./path-security.js";
+/**
+ * Create and start the MCP server in the appropriate transport mode.
+ *
+ * - If `--http` flag or `PORT` env var is set → HTTP mode (strict path security)
+ * - Otherwise → stdio mode (CWD + temp allowed)
+ */
+export async function createMain(createServer) {
+    const httpMode = process.argv.includes("--http") || !!process.env.PORT;
+    if (httpMode) {
+        configurePathSecurity({ mode: "http" });
+        await startHttpServer({ createServer });
+    }
+    else {
+        configurePathSecurity({ mode: "stdio" });
+        const server = createServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+}
+//# sourceMappingURL=create-main.js.map

package/dist/lib/create-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-main.js","sourceRoot":"","sources":["../../src/lib/create-main.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAA6B;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAEvE,IAAI,QAAQ,EAAE,CAAC;QACb,qBAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACxC,MAAM,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,qBAAqB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared MCP tool result helpers.
+ */
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/** Create a standard MCP error tool result with isError: true */
+export declare function toolError(message: string): ToolResult;
+/** Create a standard MCP success tool result */
+export declare function toolResult(text: string): ToolResult;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAKrD;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAInD"}

package/dist/lib/errors.js

@@ -0,0 +1,17 @@
+/**
+ * Shared MCP tool result helpers.
+ */
+/** Create a standard MCP error tool result with isError: true */
+export function toolError(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+/** Create a standard MCP success tool result */
+export function toolResult(text) {
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/lib/fetch-url.d.ts

@@ -0,0 +1,18 @@
+export declare function validateUrl(url: string): Promise<void>;
+export interface FetchUrlOptions {
+    /** Max response size in bytes (default: 100 MB) */
+    maxBytes?: number;
+    /** Request timeout in ms (default: 30 000) */
+    timeoutMs?: number;
+}
+/**
+ * Fetch a URL with SSRF protection, size limits, timeout, and redirect safety.
+ * Connects directly to the resolved IP to prevent DNS rebinding (TOCTOU) attacks.
+ */
+export declare function fetchUrl(url: string, options?: FetchUrlOptions, _redirectCount?: number): Promise<Buffer>;
+/**
+ * Load an image from a URL or local path.
+ * URLs go through SSRF-safe fetchUrl; paths are validated by the caller.
+ */
+export declare function loadImage(source: string, options?: FetchUrlOptions): Promise<Buffer>;
+//# sourceMappingURL=fetch-url.d.ts.map

package/dist/lib/fetch-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-url.d.ts","sourceRoot":"","sources":["../../src/lib/fetch-url.ts"],"names":[],"mappings":"AAoEA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C5D;AAMD,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2BD;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAAoB,EAC7B,cAAc,SAAI,GACjB,OAAO,CAAC,MAAM,CAAC,CA6GjB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAQjB"}