clipqa-mcp 0.2.1

package/build/visual.d.ts

@@ -0,0 +1,62 @@
+import { MediaProcessor } from "./media.js";
+export interface Region {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Difference {
+    meanDifference: number;
+    peakTileDifference: number;
+    ssim: number;
+    changedFraction: number;
+}
+export declare function difference(a: Uint8Array, b: Uint8Array, width: number, height: number, ignore?: Region[]): Difference;
+export interface VisualIndex {
+    fps: number;
+    decodedFrames: number;
+    width: number;
+    height: number;
+    changes: Array<{
+        timestamp: number;
+        score: number;
+    }>;
+    warnings: string[];
+}
+export declare function indexVideo(ffmpeg: string, video: string, start: number, end: number, fps?: number): Promise<VisualIndex>;
+export declare function compareVideos(media: MediaProcessor, before: string, after: string, directory: string, options: {
+    beforeStart: number;
+    afterStart: number;
+    seconds: number;
+    samples: number;
+    threshold: number;
+    ignore: Region[];
+}): Promise<{
+    schemaVersion: number;
+    options: {
+        beforeStart: number;
+        afterStart: number;
+        seconds: number;
+        samples: number;
+        threshold: number;
+        ignore: Region[];
+    };
+    changedSamples: number;
+    rows: (Difference & {
+        beforeSeconds: number;
+        afterSeconds: number;
+        score: number;
+        changed: boolean;
+    })[];
+    note: string;
+    previewSample: (Difference & {
+        beforeSeconds: number;
+        afterSeconds: number;
+        score: number;
+        changed: boolean;
+    }) | undefined;
+    previewPath: string;
+    reportPath: string;
+    jsonPath: string;
+}>;
+//# sourceMappingURL=visual.d.ts.map

package/build/visual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual.d.ts","sourceRoot":"","sources":["../src/visual.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,MAAM;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAC/E,MAAM,WAAW,UAAU;IAAG,cAAc,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE;AAGzH,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,EAAO,GAAG,UAAU,CAsBzH;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAClE,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC1E;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CA8C1H;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE;;;qBAAnG,MAAM;oBAAc,MAAM;iBAAW,MAAM;iBAAW,MAAM;mBAAa,MAAM;gBAAU,MAAM,EAAE;;;;uBAGpL,MAAM;sBAAgB,MAAM;eAAS,MAAM;iBAAW,OAAO;;;;;;;;;;;;GAiC9G"}

package/build/visual.js

@@ -0,0 +1,145 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import sharp from "sharp";
+import { randomUUID } from "node:crypto";
+// Local SSIM plus RGB error catches both structural and flat-color changes.
+export function difference(a, b, width, height, ignore = []) {
+    if (a.length !== width * height * 3 || b.length !== a.length)
+        throw new Error("Frame dimensions must match.");
+    let sum = 0, pixels = 0, changed = 0, peak = 0, ssimSum = 0, tiles = 0;
+    for (let y = 0; y < height; y += 8)
+        for (let x = 0; x < width; x += 8) {
+            let n = 0, sx = 0, sy = 0, xx = 0, yy = 0, xy = 0, delta = 0;
+            for (let j = y; j < Math.min(y + 8, height); j++)
+                for (let i = x; i < Math.min(x + 8, width); i++) {
+                    if (ignore.some(r => i / width >= r.x && i / width < r.x + r.width && j / height >= r.y && j / height < r.y + r.height))
+                        continue;
+                    const k = (j * width + i) * 3;
+                    const u = .2126 * a[k] + .7152 * a[k + 1] + .0722 * a[k + 2];
+                    const v = .2126 * b[k] + .7152 * b[k + 1] + .0722 * b[k + 2];
+                    const d = (Math.abs(a[k] - b[k]) + Math.abs(a[k + 1] - b[k + 1]) + Math.abs(a[k + 2] - b[k + 2])) / (3 * 255);
+                    delta += d;
+                    sum += d;
+                    pixels++;
+                    if (d > .04)
+                        changed++;
+                    n++;
+                    sx += u;
+                    sy += v;
+                    xx += u * u;
+                    yy += v * v;
+                    xy += u * v;
+                }
+            if (!n)
+                continue;
+            const mx = sx / n, my = sy / n;
+            const vx = Math.max(0, xx / n - mx * mx), vy = Math.max(0, yy / n - my * my), cov = xy / n - mx * my;
+            ssimSum += ((2 * mx * my + 6.5025) * (2 * cov + 58.5225)) / ((mx * mx + my * my + 6.5025) * (vx + vy + 58.5225));
+            tiles++;
+            peak = Math.max(peak, delta / n);
+        }
+    if (!pixels)
+        throw new Error("Ignore regions cover the entire frame.");
+    return { meanDifference: sum / pixels, peakTileDifference: peak, ssim: ssimSum / tiles, changedFraction: changed / pixels };
+}
+export async function indexVideo(ffmpeg, video, start, end, fps = 15) {
+    if (!(end > start) || end - start > 3600 || fps < 1 || fps > 60)
+        throw new Error("Index a valid range up to one hour at 1–60 FPS.");
+    const stat = await fs.stat(video);
+    const cache = `${video}.index-${start}-${end}-${fps}.json`;
+    const key = `${stat.size}:${stat.mtimeMs}:v1`;
+    const cached = await fs.readFile(cache, "utf8").then(JSON.parse).catch(() => undefined);
+    if (cached?.key === key)
+        return cached.index;
+    const width = 160, height = 90, bytes = width * height * 3;
+    const index = await new Promise((resolve, reject) => {
+        const child = spawn(ffmpeg, ["-hide_banner", "-loglevel", "error", "-ss", String(start), "-protocol_whitelist", "file,pipe", "-i", video, "-t", String(end - start), "-an", "-vf", `fps=${fps},scale=${width}:${height}`, "-pix_fmt", "rgb24", "-f", "rawvideo", "pipe:1"], { windowsHide: true, stdio: ["ignore", "pipe", "pipe"] });
+        let pending = Buffer.alloc(0), previous, count = 0, stderr = "", staticFrames = 0, darkFrames = 0;
+        const bins = new Map();
+        const timeout = setTimeout(() => { child.kill(); reject(new Error("Visual indexing timed out; inspect a shorter range.")); }, 120_000);
+        child.stderr.on("data", chunk => { stderr = (stderr + String(chunk)).slice(-2000); });
+        child.stdout.on("data", (chunk) => {
+            pending = Buffer.concat([pending, chunk]);
+            while (pending.length >= bytes) {
+                const frame = pending.subarray(0, bytes);
+                let brightness = 0;
+                for (const value of frame)
+                    brightness += value;
+                if (brightness / bytes < 3)
+                    darkFrames++;
+                if (previous) {
+                    const d = difference(previous, frame, width, height);
+                    const score = Math.max(d.peakTileDifference, 1 - d.ssim);
+                    if (d.meanDifference < .0005)
+                        staticFrames++;
+                    if (score >= .035) {
+                        const timestamp = start + count / fps, bin = Math.floor((timestamp - start) * 2);
+                        if (!bins.has(bin) || bins.get(bin).score < score)
+                            bins.set(bin, { timestamp, score });
+                    }
+                }
+                previous = Buffer.from(frame);
+                pending = pending.subarray(bytes);
+                count++;
+            }
+        });
+        child.on("error", e => { clearTimeout(timeout); reject(e); });
+        child.on("close", code => {
+            clearTimeout(timeout);
+            if (code || !count || pending.length)
+                return reject(new Error(`Visual indexing failed: ${stderr || "no complete frames"}`));
+            const warnings = [];
+            if (darkFrames / count > .95)
+                warnings.push("Almost all frames are black; check permissions, protected content, and target rendering.");
+            if (staticFrames / Math.max(1, count - 1) > .98)
+                warnings.push("Nearly static recording: may be an idle application, a frozen capture, or a minimized target. This is not a defect diagnosis.");
+            const changes = [...bins.values()].sort((a, b) => b.score - a.score).slice(0, 256).sort((a, b) => a.timestamp - b.timestamp);
+            resolve({ fps, decodedFrames: count, width, height, changes, warnings });
+        });
+    });
+    const temp = `${cache}.${randomUUID()}.tmp`;
+    await fs.writeFile(temp, JSON.stringify({ key, index }));
+    await fs.rename(temp, cache);
+    return index;
+}
+export async function compareVideos(media, before, after, directory, options) {
+    if (options.seconds <= 0 || options.samples < 2 || options.samples > 60)
+        throw new Error("Compare a positive duration with 2–60 samples.");
+    await fs.mkdir(directory, { recursive: true });
+    const rows = [];
+    const htmlRows = [];
+    for (let i = 0; i < options.samples; i++) {
+        const offset = i * options.seconds / options.samples;
+        const a = path.join(directory, `before-${i}.png`), b = path.join(directory, `after-${i}.png`);
+        await media.extractFrame(before, options.beforeStart + offset, a, 640);
+        await media.extractFrame(after, options.afterStart + offset, b, 640);
+        const raw = async (file) => sharp(file).resize(320, 180, { fit: "contain", background: "black" }).removeAlpha().raw().toBuffer();
+        const [left, right] = await Promise.all([raw(a), raw(b)]);
+        const metrics = difference(left, right, 320, 180, options.ignore);
+        const score = Math.max(metrics.peakTileDifference, 1 - metrics.ssim);
+        const row = { beforeSeconds: options.beforeStart + offset, afterSeconds: options.afterStart + offset, ...metrics, score, changed: score >= options.threshold };
+        rows.push(row);
+        const mask = Buffer.alloc(left.length);
+        for (let p = 0; p < left.length; p += 3) {
+            const x = (p / 3 % 320) / 320, y = Math.floor(p / 3 / 320) / 180;
+            const ignored = options.ignore.some(r => x >= r.x && x < r.x + r.width && y >= r.y && y < r.y + r.height);
+            const delta = Math.max(Math.abs(left[p] - right[p]), Math.abs(left[p + 1] - right[p + 1]), Math.abs(left[p + 2] - right[p + 2]));
+            mask[p] = ignored ? 0 : Math.min(255, delta * 4);
+            mask[p + 1] = ignored ? 0 : delta;
+        }
+        const heatmap = await sharp(mask, { raw: { width: 320, height: 180, channels: 3 } }).png().toBuffer();
+        await fs.writeFile(path.join(directory, `difference-${i}.png`), heatmap);
+        const [aData, bData] = await Promise.all([fs.readFile(a), fs.readFile(b)]);
+        htmlRows.push(`<section><h2>${row.beforeSeconds.toFixed(3)}s → ${row.afterSeconds.toFixed(3)}s · ${row.changed ? "Changed" : "Within threshold"}</h2><p>SSIM ${metrics.ssim.toFixed(4)} · changed pixels ${(metrics.changedFraction * 100).toFixed(2)}%</p><div>${[aData, bData, heatmap].map((data, j) => `<figure><img alt="${["Before", "After", "Difference"][j]}" src="data:image/png;base64,${data.toString("base64")}"><figcaption>${["Before", "After", "Difference"][j]}</figcaption></figure>`).join("")}</div></section>`);
+    }
+    const report = { schemaVersion: 1, options, changedSamples: rows.filter(row => row.changed).length, rows, note: "Visual differences are candidates for review, not confirmed regressions. Only sampled timestamps are compared; motion between them may be missed." };
+    await fs.writeFile(path.join(directory, "report.json"), JSON.stringify(report, null, 2));
+    await fs.writeFile(path.join(directory, "report.html"), `<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>ClipQA comparison</title><style>body{font:16px system-ui;background:#0d1117;color:#e6edf3;margin:32px}section{border-top:1px solid #30363d;padding:16px 0}div{display:flex;flex-wrap:wrap;gap:12px}figure{margin:0;flex:1;min-width:240px}img{width:100%}figcaption{color:#8b949e}h2{font-size:18px}</style><h1>ClipQA comparison</h1><p>${report.changedSamples}/${rows.length} samples changed. ${report.note}</p>${htmlRows.join("")}</html>`);
+    const worst = rows.reduce((best, row, i) => row.score > rows[best].score ? i : best, 0);
+    const previewPath = path.join(directory, "preview.jpg");
+    const previews = await Promise.all(["before", "after", "difference"].map(async (name, i) => ({ input: await sharp(path.join(directory, `${name}-${worst}.png`)).resize(320, 180, { fit: "contain", background: "black" }).png().toBuffer(), left: i * 320, top: 0 })));
+    await sharp({ create: { width: 960, height: 180, channels: 3, background: "black" } }).composite(previews).jpeg({ quality: 85 }).toFile(previewPath);
+    return { ...report, previewSample: rows[worst], previewPath, reportPath: path.join(directory, "report.html"), jsonPath: path.join(directory, "report.json") };
+}
+//# sourceMappingURL=visual.js.map

package/build/visual.js.map

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

package/build/windows.d.ts

@@ -0,0 +1,4 @@
+import type { CommandRunner } from "./process-runner.js";
+import type { WindowInfo } from "./types.js";
+export declare function listWindows(runner: CommandRunner, platform?: NodeJS.Platform): Promise<WindowInfo[]>;
+//# sourceMappingURL=windows.d.ts.map

package/build/windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../src/windows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAmC7C,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,UAAU,EAAE,CAAC,CA2BvB"}

package/build/windows.js

@@ -0,0 +1,60 @@
+const WINDOWS_SCRIPT = `
+[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding $false
+Add-Type -TypeDefinition @'
+using System;
+using System.Text;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+public class ClipWindow { public string title; public string hwnd; public string process; public int pid; public bool minimized; }
+public static class ClipWindows {
+ delegate bool Callback(IntPtr h, IntPtr p);
+ [DllImport("user32.dll")] static extern bool EnumWindows(Callback callback, IntPtr p);
+ [DllImport("user32.dll")] static extern bool IsWindowVisible(IntPtr h);
+ [DllImport("user32.dll")] static extern bool IsIconic(IntPtr h);
+ [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern int GetWindowText(IntPtr h, StringBuilder text, int count);
+ [DllImport("user32.dll")] static extern uint GetWindowThreadProcessId(IntPtr h, out uint pid);
+ public static List<ClipWindow> All() {
+  var result = new List<ClipWindow>();
+  EnumWindows((h,p) => {
+   if (!IsWindowVisible(h)) return true;
+   var text = new StringBuilder(2048); GetWindowText(h, text, text.Capacity);
+   if (text.Length == 0) return true;
+   uint pid; GetWindowThreadProcessId(h, out pid);
+   string process = ""; try { process = System.Diagnostics.Process.GetProcessById((int)pid).ProcessName; } catch {}
+   result.Add(new ClipWindow { title=text.ToString(), hwnd=h.ToInt64().ToString(), process=process, pid=(int)pid, minimized=IsIconic(h) });
+   return true;
+  }, IntPtr.Zero);
+  return result;
+ }
+}
+'@
+@([ClipWindows]::All()) | Sort-Object title | ConvertTo-Json -Compress
+`;
+export async function listWindows(runner, platform = process.platform) {
+    if (platform === "linux") {
+        const result = await runner.run("wmctrl", ["-lp"]);
+        if (result.code)
+            throw new Error("Install wmctrl for X11 window discovery, or use xwininfo and provide windowId directly.");
+        return result.stdout.split(/\r?\n/).flatMap(line => {
+            const m = /^(0x[\da-f]+)\s+-?\d+\s+(\d+)\s+\S+\s+(.+)$/i.exec(line);
+            return m ? [{ hwnd: m[1], title: m[3], pid: Number(m[2]), process: "X11", windowId: m[1] }] : [];
+        });
+    }
+    if (platform !== "win32")
+        throw new Error("Use list_sources to select a macOS display. Window-only discovery is available on Windows and X11.");
+    const result = await runner.run("powershell.exe", [
+        "-NoLogo",
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        WINDOWS_SCRIPT,
+    ]);
+    if (result.code !== 0) {
+        throw new Error(`Unable to list windows: ${result.stderr.trim()}`);
+    }
+    if (!result.stdout.trim())
+        return [];
+    const parsed = JSON.parse(result.stdout);
+    return (Array.isArray(parsed) ? parsed : [parsed]).filter((window) => Boolean(window.title && window.hwnd));
+}
+//# sourceMappingURL=windows.js.map

package/build/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","sourceRoot":"","sources":["../src/windows.ts"],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BtB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqB,EACrB,QAAQ,GAAoB,OAAO,CAAC,QAAQ;IAE5C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;QAC5H,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACjD,MAAM,CAAC,GAAG,8CAA8C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtG,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,oGAAoG,CAAC,CAAC;IAEhJ,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE;QAChD,SAAS;QACT,YAAY;QACZ,iBAAiB;QACjB,UAAU;QACV,cAAc;KACf,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,MAAM,GAA8B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACvD,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,CACjD,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "clipqa-mcp",
+  "version": "0.2.1",
+  "description": "Background window recording and frame-level QA evidence for AI agents via MCP.",
+  "type": "module",
+  "bin": {
+    "clipqa-mcp": "build/index.js"
+  },
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "files": [
+    "build",
+    "scripts/install-wgc.ps1",
+    "docs/assets/banner.png",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "benchmark": "tsx benchmarks/temporal-coverage.ts",
+    "setup:wgc": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/install-wgc.ps1",
+    "start": "node build/index.js",
+    "prepack": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "qa",
+    "screen-recording",
+    "roblox",
+    "computer-vision",
+    "testing"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WheresRace/clipqa-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/WheresRace/clipqa-mcp/issues"
+  },
+  "homepage": "https://github.com/WheresRace/clipqa-mcp#readme",
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "ffmpeg-static": "^5.3.0",
+    "ffprobe-static": "^3.1.0",
+    "sharp": "^0.35.4",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@types/node": "^24.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  }
+}

package/scripts/install-wgc.ps1

@@ -0,0 +1,40 @@
+# Optional Windows setup. Recording itself never downloads software.
+$ErrorActionPreference = 'Stop'
+$ProgressPreference = 'SilentlyContinue'
+$clipInstall = Join-Path ([Environment]::GetFolderPath('UserProfile')) '.clipqa\bin'
+$clipTemp = Join-Path ([System.IO.Path]::GetTempPath()) ('clipqa-ffmpeg-' + [guid]::NewGuid())
+New-Item -ItemType Directory -Path $clipTemp | Out-Null
+try {
+    $clipArchive = Join-Path $clipTemp 'ffmpeg.zip'
+    $clipUrl = 'https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-essentials.zip'
+    Invoke-WebRequest -UseBasicParsing -Uri $clipUrl -OutFile $clipArchive -TimeoutSec 120
+    $clipExpected = ((Invoke-WebRequest -UseBasicParsing -Uri ($clipUrl + '.sha256') -TimeoutSec 30).Content.Trim() -split '\s+')[0]
+    $clipHasher = [Security.Cryptography.SHA256]::Create()
+    $clipStream = [IO.File]::OpenRead($clipArchive)
+    try { $clipActual = [BitConverter]::ToString($clipHasher.ComputeHash($clipStream)).Replace('-', '') }
+    finally { $clipStream.Dispose(); $clipHasher.Dispose() }
+    if ($clipExpected -notmatch '^[0-9a-fA-F]{64}$' -or $clipActual -ne $clipExpected) {
+        throw 'FFmpeg checksum mismatch. No binaries installed; retry in case the release changed during download.'
+    }
+    Add-Type -AssemblyName System.IO.Compression.FileSystem
+    [IO.Compression.ZipFile]::ExtractToDirectory($clipArchive, (Join-Path $clipTemp 'extracted'))
+    $clipExe = Get-ChildItem -LiteralPath (Join-Path $clipTemp 'extracted') -Recurse -Filter ffmpeg.exe | Select-Object -First 1
+    if (-not $clipExe) { throw 'FFmpeg executable missing from archive.' }
+    $ErrorActionPreference = 'Continue'
+    $clipHelp = & $clipExe.FullName -hide_banner -h filter=gfxcapture 2>&1 | Out-String
+    $clipExit = $LASTEXITCODE
+    $ErrorActionPreference = 'Stop'
+    if ($clipExit -ne 0) { throw 'Downloaded FFmpeg could not run.' }
+    if ($clipHelp -notmatch 'capture_cursor' -or $clipHelp -notmatch 'hwnd') { throw 'Downloaded build lacks the required gfxcapture filter.' }
+    New-Item -ItemType Directory -Path $clipInstall -Force | Out-Null
+    Copy-Item -LiteralPath $clipExe.FullName -Destination (Join-Path $clipInstall 'ffmpeg.exe') -Force
+    Copy-Item -LiteralPath (Join-Path $clipExe.DirectoryName 'ffprobe.exe') -Destination (Join-Path $clipInstall 'ffprobe.exe') -Force
+    Get-ChildItem -LiteralPath $clipExe.Directory.Parent.FullName -File | Where-Object { $_.Name -match 'LICENSE|README' } | Copy-Item -Destination $clipInstall -Force
+    Write-Output "Installed verified WGC-capable FFmpeg in $clipInstall. Restart your MCP client to use it. FFmpeg is separately licensed by its distributor."
+} finally {
+    $clipResolved = [IO.Path]::GetFullPath($clipTemp)
+    $clipRoot = [IO.Path]::GetFullPath([IO.Path]::GetTempPath()).TrimEnd('\') + '\'
+    if ($clipResolved.StartsWith($clipRoot, [StringComparison]::OrdinalIgnoreCase) -and [IO.Path]::GetFileName($clipResolved).StartsWith('clipqa-ffmpeg-')) {
+        Remove-Item -LiteralPath $clipResolved -Recurse -Force
+    }
+}