@testivai/mcp 0.2.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/lib.d.ts +29 -0
- package/dist/lib.d.ts.map +1 -1
- package/dist/lib.js +65 -0
- package/dist/lib.js.map +1 -1
- package/dist/server.js +59 -12
- package/dist/server.js.map +1 -1
- package/package.json +8 -3
- package/server.json +19 -0
package/dist/lib.d.ts
CHANGED
|
@@ -40,5 +40,34 @@ export declare function readResults(paths: ProjectPaths): ResultsFile | null;
|
|
|
40
40
|
export declare function verdictFor(snapshot: SnapshotResult): string;
|
|
41
41
|
/** Resolve a report-relative image path safely inside the report dir. */
|
|
42
42
|
export declare function resolveImage(paths: ProjectPaths, relativePath: string): string | null;
|
|
43
|
+
/** Result of an approve operation — machine-readable for agents. */
|
|
44
|
+
export interface ApproveResult {
|
|
45
|
+
approved: string[];
|
|
46
|
+
failed: Array<{
|
|
47
|
+
name: string;
|
|
48
|
+
error: string;
|
|
49
|
+
}>;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Approve one snapshot: promote its current capture in `.testivai/temp/<name>/`
|
|
53
|
+
* to the committed baseline. Reuses the same BaselineStore the CLI uses, so
|
|
54
|
+
* semantics (and undo) match `testivai approve <name>` exactly.
|
|
55
|
+
*/
|
|
56
|
+
export declare function approveSnapshot(root: string, name: string): ApproveResult;
|
|
57
|
+
/** Approve every pending snapshot under `.testivai/temp/` (like `approve --all`). */
|
|
58
|
+
export declare function approveAll(root: string): ApproveResult;
|
|
43
59
|
export declare function listBaselines(root: string): string[];
|
|
60
|
+
/**
|
|
61
|
+
* Downscale a PNG buffer using integer-stride nearest-neighbour sampling.
|
|
62
|
+
* When the longest edge is <= maxEdge the original buffer is returned unchanged.
|
|
63
|
+
*
|
|
64
|
+
* @returns The (possibly) resized PNG buffer, output dimensions, and original dimensions.
|
|
65
|
+
*/
|
|
66
|
+
export declare function downscalePng(buffer: Buffer, maxEdge?: number): {
|
|
67
|
+
data: Buffer;
|
|
68
|
+
width: number;
|
|
69
|
+
height: number;
|
|
70
|
+
originalWidth: number;
|
|
71
|
+
originalHeight: number;
|
|
72
|
+
};
|
|
44
73
|
//# sourceMappingURL=lib.d.ts.map
|
package/dist/lib.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAKA,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpG;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAClF,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAcvD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI,CAInE;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAe3D;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrF;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAQzE;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAatD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,SAAO,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CA2BhG"}
|
package/dist/lib.js
CHANGED
|
@@ -37,9 +37,14 @@ exports.resolvePaths = resolvePaths;
|
|
|
37
37
|
exports.readResults = readResults;
|
|
38
38
|
exports.verdictFor = verdictFor;
|
|
39
39
|
exports.resolveImage = resolveImage;
|
|
40
|
+
exports.approveSnapshot = approveSnapshot;
|
|
41
|
+
exports.approveAll = approveAll;
|
|
40
42
|
exports.listBaselines = listBaselines;
|
|
43
|
+
exports.downscalePng = downscalePng;
|
|
41
44
|
const fs = __importStar(require("fs"));
|
|
42
45
|
const path = __importStar(require("path"));
|
|
46
|
+
const pngjs_1 = require("pngjs");
|
|
47
|
+
const baselines_1 = require("@testivai/witness/baselines");
|
|
43
48
|
/** Resolve the report dir from .testivai/config.json (reportDir key), default visual-report/. */
|
|
44
49
|
function resolvePaths(root) {
|
|
45
50
|
let reportDir = 'visual-report';
|
|
@@ -89,6 +94,37 @@ function resolveImage(paths, relativePath) {
|
|
|
89
94
|
return null; // no traversal
|
|
90
95
|
return fs.existsSync(abs) ? abs : null;
|
|
91
96
|
}
|
|
97
|
+
/**
|
|
98
|
+
* Approve one snapshot: promote its current capture in `.testivai/temp/<name>/`
|
|
99
|
+
* to the committed baseline. Reuses the same BaselineStore the CLI uses, so
|
|
100
|
+
* semantics (and undo) match `testivai approve <name>` exactly.
|
|
101
|
+
*/
|
|
102
|
+
function approveSnapshot(root, name) {
|
|
103
|
+
const store = new baselines_1.BaselineStore(root);
|
|
104
|
+
try {
|
|
105
|
+
store.approve(name);
|
|
106
|
+
return { approved: [name], failed: [] };
|
|
107
|
+
}
|
|
108
|
+
catch (e) {
|
|
109
|
+
return { approved: [], failed: [{ name, error: e instanceof Error ? e.message : String(e) }] };
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
/** Approve every pending snapshot under `.testivai/temp/` (like `approve --all`). */
|
|
113
|
+
function approveAll(root) {
|
|
114
|
+
const store = new baselines_1.BaselineStore(root);
|
|
115
|
+
const approved = [];
|
|
116
|
+
const failed = [];
|
|
117
|
+
for (const name of store.listTemp()) {
|
|
118
|
+
try {
|
|
119
|
+
store.approve(name);
|
|
120
|
+
approved.push(name);
|
|
121
|
+
}
|
|
122
|
+
catch (e) {
|
|
123
|
+
failed.push({ name, error: e instanceof Error ? e.message : String(e) });
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
return { approved, failed };
|
|
127
|
+
}
|
|
92
128
|
function listBaselines(root) {
|
|
93
129
|
const dir = path.join(root, '.testivai', 'baselines');
|
|
94
130
|
if (!fs.existsSync(dir))
|
|
@@ -99,4 +135,33 @@ function listBaselines(root) {
|
|
|
99
135
|
.map((e) => e.name)
|
|
100
136
|
.sort();
|
|
101
137
|
}
|
|
138
|
+
/**
|
|
139
|
+
* Downscale a PNG buffer using integer-stride nearest-neighbour sampling.
|
|
140
|
+
* When the longest edge is <= maxEdge the original buffer is returned unchanged.
|
|
141
|
+
*
|
|
142
|
+
* @returns The (possibly) resized PNG buffer, output dimensions, and original dimensions.
|
|
143
|
+
*/
|
|
144
|
+
function downscalePng(buffer, maxEdge = 1024) {
|
|
145
|
+
const original = pngjs_1.PNG.sync.read(buffer);
|
|
146
|
+
const { width: ow, height: oh } = original;
|
|
147
|
+
const longestEdge = Math.max(ow, oh);
|
|
148
|
+
if (longestEdge <= maxEdge) {
|
|
149
|
+
return { data: buffer, width: ow, height: oh, originalWidth: ow, originalHeight: oh };
|
|
150
|
+
}
|
|
151
|
+
const stride = Math.ceil(longestEdge / maxEdge);
|
|
152
|
+
const w = Math.ceil(ow / stride);
|
|
153
|
+
const h = Math.ceil(oh / stride);
|
|
154
|
+
const out = new pngjs_1.PNG({ width: w, height: h });
|
|
155
|
+
for (let y = 0; y < h; y++) {
|
|
156
|
+
for (let x = 0; x < w; x++) {
|
|
157
|
+
const srcIdx = ((y * stride) * ow + (x * stride)) * 4;
|
|
158
|
+
const dstIdx = (y * w + x) * 4;
|
|
159
|
+
out.data[dstIdx] = original.data[srcIdx];
|
|
160
|
+
out.data[dstIdx + 1] = original.data[srcIdx + 1];
|
|
161
|
+
out.data[dstIdx + 2] = original.data[srcIdx + 2];
|
|
162
|
+
out.data[dstIdx + 3] = original.data[srcIdx + 3];
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
return { data: pngjs_1.PNG.sync.write(out), width: w, height: h, originalWidth: ow, originalHeight: oh };
|
|
166
|
+
}
|
|
102
167
|
//# sourceMappingURL=lib.js.map
|
package/dist/lib.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"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"}
|
package/dist/server.js
CHANGED
|
@@ -73,15 +73,8 @@ server.registerTool('get_visual_results', {
|
|
|
73
73
|
];
|
|
74
74
|
return { content: [{ type: 'text', text: lines.join('\n') }] };
|
|
75
75
|
});
|
|
76
|
-
//
|
|
77
|
-
|
|
78
|
-
// validation of the input schema is unaffected.
|
|
79
|
-
server.registerTool('get_snapshot_diff', {
|
|
80
|
-
title: 'View snapshot diff images',
|
|
81
|
-
description: 'Return the baseline, current, and diff images for one changed snapshot so you can see what changed visually. ' +
|
|
82
|
-
'Use get_visual_results first to find snapshot names.',
|
|
83
|
-
inputSchema: { name: zod_1.z.string().describe('Snapshot name from get_visual_results') },
|
|
84
|
-
}, (async ({ name }) => {
|
|
76
|
+
// Shared handler for the diff-image tools (registered under two names).
|
|
77
|
+
const snapshotDiffHandler = async ({ name }) => {
|
|
85
78
|
const paths = (0, lib_1.resolvePaths)(projectRoot);
|
|
86
79
|
const results = (0, lib_1.readResults)(paths);
|
|
87
80
|
const snapshot = results?.snapshots.find((s) => s.name === name);
|
|
@@ -98,12 +91,66 @@ server.registerTool('get_snapshot_diff', {
|
|
|
98
91
|
]) {
|
|
99
92
|
const abs = rel ? (0, lib_1.resolveImage)(paths, rel) : null;
|
|
100
93
|
if (abs) {
|
|
101
|
-
|
|
102
|
-
|
|
94
|
+
const raw = fs.readFileSync(abs);
|
|
95
|
+
const downscaled = (0, lib_1.downscalePng)(raw);
|
|
96
|
+
const wasDownscaled = downscaled.originalWidth !== downscaled.width ||
|
|
97
|
+
downscaled.originalHeight !== downscaled.height;
|
|
98
|
+
const textLabel = wasDownscaled
|
|
99
|
+
? `${label} (downscaled from ${downscaled.originalWidth}x${downscaled.originalHeight}):`
|
|
100
|
+
: `${label}:`;
|
|
101
|
+
content.push({ type: 'text', text: textLabel });
|
|
102
|
+
content.push({ type: 'image', data: downscaled.data.toString('base64'), mimeType: 'image/png' });
|
|
103
103
|
}
|
|
104
104
|
}
|
|
105
105
|
return { content };
|
|
106
|
-
}
|
|
106
|
+
};
|
|
107
|
+
const diffToolMeta = {
|
|
108
|
+
title: 'View snapshot diff images',
|
|
109
|
+
description: 'Return the baseline, current, and diff images for one changed snapshot so you can see what changed visually. ' +
|
|
110
|
+
'Use get_report / get_visual_results first to find snapshot names.',
|
|
111
|
+
inputSchema: { name: zod_1.z.string().describe('Snapshot name from the results') },
|
|
112
|
+
};
|
|
113
|
+
// registerTool is called through an untyped alias: zod@3.25 + TS 6 blow the
|
|
114
|
+
// type-depth limit (TS2589) when inferring the schema generics. Runtime
|
|
115
|
+
// validation of the input schema is unaffected.
|
|
116
|
+
// `get_diff` is the canonical name; `get_snapshot_diff` is kept as an alias.
|
|
117
|
+
server.registerTool('get_diff', diffToolMeta, snapshotDiffHandler);
|
|
118
|
+
server.registerTool('get_snapshot_diff', diffToolMeta, snapshotDiffHandler);
|
|
119
|
+
// get_report — the raw results.json payload (the public schema) for agents
|
|
120
|
+
// that want to parse structured data rather than the human summary.
|
|
121
|
+
server.registerTool('get_report', {
|
|
122
|
+
title: 'Get the raw visual report (results.json)',
|
|
123
|
+
description: 'Return the machine-readable results.json payload verbatim (summary + per-snapshot status, diff %, ' +
|
|
124
|
+
'DOM signal, and region→selector attribution). Parse this instead of scraping CLI output.',
|
|
125
|
+
inputSchema: {},
|
|
126
|
+
}, async () => {
|
|
127
|
+
const results = (0, lib_1.readResults)((0, lib_1.resolvePaths)(projectRoot));
|
|
128
|
+
if (!results) {
|
|
129
|
+
return { content: [{ type: 'text', text: 'No results found. Run the visual tests first (e.g. npx playwright test).' }] };
|
|
130
|
+
}
|
|
131
|
+
return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
|
|
132
|
+
});
|
|
133
|
+
// approve_snapshot / approve_all — promote current captures to committed
|
|
134
|
+
// baselines. Approval accepts a new visual truth, so only call these once a
|
|
135
|
+
// reviewer has confirmed the change is intended (not a regression).
|
|
136
|
+
server.registerTool('approve_snapshot', {
|
|
137
|
+
title: 'Approve one snapshot as the new baseline',
|
|
138
|
+
description: 'Promote .testivai/temp/<name>/ to the committed baseline (same as `testivai approve <name>`). ' +
|
|
139
|
+
'Only approve changes a reviewer has confirmed are intended; then commit .testivai/baselines/.',
|
|
140
|
+
inputSchema: { name: zod_1.z.string().describe('Snapshot name to approve') },
|
|
141
|
+
}, async ({ name }) => {
|
|
142
|
+
const result = (0, lib_1.approveSnapshot)(projectRoot, name);
|
|
143
|
+
return { content: [{ type: 'text', text: JSON.stringify(result) }] };
|
|
144
|
+
});
|
|
145
|
+
server.registerTool('approve_all', {
|
|
146
|
+
title: 'Approve all pending snapshots as baselines',
|
|
147
|
+
description: 'Promote every pending capture under .testivai/temp/ to committed baselines (same as `testivai approve --all`). ' +
|
|
148
|
+
'Only run this after a reviewer has confirmed the changes; then commit .testivai/baselines/.',
|
|
149
|
+
inputSchema: {},
|
|
150
|
+
}, async () => {
|
|
151
|
+
const result = (0, lib_1.approveAll)(projectRoot);
|
|
152
|
+
return { content: [{ type: 'text', text: JSON.stringify(result) }] };
|
|
153
|
+
});
|
|
107
154
|
server.registerTool('list_baselines', {
|
|
108
155
|
title: 'List committed baselines',
|
|
109
156
|
description: 'List the snapshot baselines committed under .testivai/baselines/.',
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,uCAAyB;AACzB,6BAA0C;AAC1C,oEAAoE;AACpE,wEAAiF;AACjF,+
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@testivai/mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "MCP server exposing TestivAI visual regression results to AI coding agents",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -31,19 +31,24 @@
|
|
|
31
31
|
},
|
|
32
32
|
"files": [
|
|
33
33
|
"dist",
|
|
34
|
-
"README.md"
|
|
34
|
+
"README.md",
|
|
35
|
+
"server.json"
|
|
35
36
|
],
|
|
36
37
|
"dependencies": {
|
|
37
38
|
"@modelcontextprotocol/sdk": "^1.17.0",
|
|
38
|
-
"
|
|
39
|
+
"pngjs": "^7.0.0",
|
|
40
|
+
"zod": "^3.25.0",
|
|
41
|
+
"@testivai/witness": "1.7.0"
|
|
39
42
|
},
|
|
40
43
|
"devDependencies": {
|
|
41
44
|
"@types/jest": "^30.0.0",
|
|
42
45
|
"@types/node": "^25.6.1",
|
|
46
|
+
"@types/pngjs": "^6.0.5",
|
|
43
47
|
"jest": "^30.4.2",
|
|
44
48
|
"ts-jest": "^29.4.0",
|
|
45
49
|
"typescript": "^6.0.3"
|
|
46
50
|
},
|
|
51
|
+
"mcpName": "ai.testiv/mcp",
|
|
47
52
|
"scripts": {
|
|
48
53
|
"build": "tsc",
|
|
49
54
|
"test": "jest"
|
package/server.json
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
|
|
3
|
+
"name": "ai.testiv/mcp",
|
|
4
|
+
"description": "Visual regression results for AI coding agents: per-snapshot verdicts (pixel diff + DOM/text signal), baseline/current/diff images, committed baselines. Local-first, no account or API key.",
|
|
5
|
+
"repository": {
|
|
6
|
+
"url": "https://github.com/mcbuddy/testivai-oss",
|
|
7
|
+
"source": "github"
|
|
8
|
+
},
|
|
9
|
+
"version": "0.3.0",
|
|
10
|
+
"packages": [
|
|
11
|
+
{
|
|
12
|
+
"registryType": "npm",
|
|
13
|
+
"registryBaseUrl": "https://registry.npmjs.org",
|
|
14
|
+
"identifier": "@testivai/mcp",
|
|
15
|
+
"version": "0.3.0",
|
|
16
|
+
"transport": { "type": "stdio" }
|
|
17
|
+
}
|
|
18
|
+
]
|
|
19
|
+
}
|