eyeballs-cli 0.1.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/LICENSE +21 -0
- package/README.md +103 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +144 -0
- package/dist/cli.js.map +1 -0
- package/dist/core.d.ts +67 -0
- package/dist/core.d.ts.map +1 -0
- package/dist/core.js +301 -0
- package/dist/core.js.map +1 -0
- package/dist/mcp.d.ts +3 -0
- package/dist/mcp.d.ts.map +1 -0
- package/dist/mcp.js +201 -0
- package/dist/mcp.js.map +1 -0
- package/package.json +51 -0
- package/src/cli.ts +172 -0
- package/src/core.ts +438 -0
- package/src/mcp.ts +243 -0
- package/src/types/pixelmatch.d.ts +20 -0
- package/tsconfig.json +19 -0
package/dist/core.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}
|
package/dist/mcp.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":""}
|
package/dist/mcp.js
ADDED
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
3
|
+
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
|
4
|
+
import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
|
|
5
|
+
import { capture, checkUrl, listWatches, removeWatch, EyeballsError, } from './core.js';
|
|
6
|
+
const tools = [
|
|
7
|
+
{
|
|
8
|
+
name: 'screenshot',
|
|
9
|
+
description: 'Take a screenshot of a web page. Returns the image and metadata (width, height, load time).',
|
|
10
|
+
inputSchema: {
|
|
11
|
+
type: 'object',
|
|
12
|
+
properties: {
|
|
13
|
+
url: {
|
|
14
|
+
type: 'string',
|
|
15
|
+
description: 'URL to screenshot (must start with http:// or https://)',
|
|
16
|
+
},
|
|
17
|
+
viewport: {
|
|
18
|
+
type: 'object',
|
|
19
|
+
description: 'Viewport size (default: 1280x720)',
|
|
20
|
+
properties: {
|
|
21
|
+
width: { type: 'number' },
|
|
22
|
+
height: { type: 'number' },
|
|
23
|
+
},
|
|
24
|
+
},
|
|
25
|
+
},
|
|
26
|
+
required: ['url'],
|
|
27
|
+
},
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
name: 'check_url',
|
|
31
|
+
description: 'Check a URL for visual changes. On first call, captures a baseline screenshot. On subsequent calls, compares against the baseline and reports the pixel diff percentage. Use reset_baseline to accept the current state as the new baseline.',
|
|
32
|
+
inputSchema: {
|
|
33
|
+
type: 'object',
|
|
34
|
+
properties: {
|
|
35
|
+
url: {
|
|
36
|
+
type: 'string',
|
|
37
|
+
description: 'URL to check (must start with http:// or https://)',
|
|
38
|
+
},
|
|
39
|
+
viewport: {
|
|
40
|
+
type: 'object',
|
|
41
|
+
description: 'Viewport size (default: 1280x720). Stored with baseline for consistent diffs.',
|
|
42
|
+
properties: {
|
|
43
|
+
width: { type: 'number' },
|
|
44
|
+
height: { type: 'number' },
|
|
45
|
+
},
|
|
46
|
+
},
|
|
47
|
+
threshold: {
|
|
48
|
+
type: 'number',
|
|
49
|
+
description: 'Percentage of pixels that must differ to count as "changed" (default: 5)',
|
|
50
|
+
},
|
|
51
|
+
region: {
|
|
52
|
+
type: 'object',
|
|
53
|
+
description: 'Crop region to compare (exclude headers, ads, etc.)',
|
|
54
|
+
properties: {
|
|
55
|
+
x: { type: 'number' },
|
|
56
|
+
y: { type: 'number' },
|
|
57
|
+
width: { type: 'number' },
|
|
58
|
+
height: { type: 'number' },
|
|
59
|
+
},
|
|
60
|
+
},
|
|
61
|
+
reset_baseline: {
|
|
62
|
+
type: 'boolean',
|
|
63
|
+
description: 'Set to true to accept the current page as the new baseline',
|
|
64
|
+
},
|
|
65
|
+
},
|
|
66
|
+
required: ['url'],
|
|
67
|
+
},
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
name: 'list_watches',
|
|
71
|
+
description: 'List all stored baselines (watched URLs) and their last check status.',
|
|
72
|
+
inputSchema: {
|
|
73
|
+
type: 'object',
|
|
74
|
+
properties: {},
|
|
75
|
+
},
|
|
76
|
+
},
|
|
77
|
+
{
|
|
78
|
+
name: 'remove_watch',
|
|
79
|
+
description: 'Remove a stored baseline and its screenshots.',
|
|
80
|
+
inputSchema: {
|
|
81
|
+
type: 'object',
|
|
82
|
+
properties: {
|
|
83
|
+
id: {
|
|
84
|
+
type: 'string',
|
|
85
|
+
description: 'The watch ID to remove (from list_watches)',
|
|
86
|
+
},
|
|
87
|
+
},
|
|
88
|
+
required: ['id'],
|
|
89
|
+
},
|
|
90
|
+
},
|
|
91
|
+
];
|
|
92
|
+
async function handleTool(name, args) {
|
|
93
|
+
switch (name) {
|
|
94
|
+
case 'screenshot': {
|
|
95
|
+
const result = await capture(args.url, args.viewport);
|
|
96
|
+
const base64 = result.buffer.toString('base64');
|
|
97
|
+
return [
|
|
98
|
+
{
|
|
99
|
+
type: 'image',
|
|
100
|
+
data: base64,
|
|
101
|
+
mimeType: 'image/png',
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
type: 'text',
|
|
105
|
+
text: JSON.stringify({
|
|
106
|
+
width: result.width,
|
|
107
|
+
height: result.height,
|
|
108
|
+
loadTimeMs: result.loadTimeMs,
|
|
109
|
+
base64Length: base64.length,
|
|
110
|
+
}),
|
|
111
|
+
},
|
|
112
|
+
];
|
|
113
|
+
}
|
|
114
|
+
case 'check_url': {
|
|
115
|
+
const result = await checkUrl({
|
|
116
|
+
url: args.url,
|
|
117
|
+
viewport: args.viewport,
|
|
118
|
+
threshold: args.threshold,
|
|
119
|
+
region: args.region,
|
|
120
|
+
resetBaseline: args.reset_baseline,
|
|
121
|
+
});
|
|
122
|
+
const content = [];
|
|
123
|
+
// Return the current screenshot
|
|
124
|
+
content.push({
|
|
125
|
+
type: 'image',
|
|
126
|
+
data: result.screenshotBuffer.toString('base64'),
|
|
127
|
+
mimeType: 'image/png',
|
|
128
|
+
});
|
|
129
|
+
// If there's a diff image, return it too
|
|
130
|
+
if (result.diffBuffer) {
|
|
131
|
+
content.push({
|
|
132
|
+
type: 'image',
|
|
133
|
+
data: result.diffBuffer.toString('base64'),
|
|
134
|
+
mimeType: 'image/png',
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
// Text summary
|
|
138
|
+
content.push({
|
|
139
|
+
type: 'text',
|
|
140
|
+
text: JSON.stringify({
|
|
141
|
+
changed: result.changed,
|
|
142
|
+
diffPercent: result.diffPercent,
|
|
143
|
+
threshold: result.threshold,
|
|
144
|
+
message: result.message,
|
|
145
|
+
watchId: result.watch.id,
|
|
146
|
+
url: result.watch.url,
|
|
147
|
+
}),
|
|
148
|
+
});
|
|
149
|
+
return content;
|
|
150
|
+
}
|
|
151
|
+
case 'list_watches': {
|
|
152
|
+
const watches = listWatches();
|
|
153
|
+
if (watches.length === 0) {
|
|
154
|
+
return [{ type: 'text', text: 'No watches. Use check_url to start monitoring a URL.' }];
|
|
155
|
+
}
|
|
156
|
+
return [
|
|
157
|
+
{
|
|
158
|
+
type: 'text',
|
|
159
|
+
text: JSON.stringify(watches.map((w) => ({
|
|
160
|
+
id: w.id,
|
|
161
|
+
url: w.url,
|
|
162
|
+
viewport: w.viewport,
|
|
163
|
+
threshold: w.config.threshold,
|
|
164
|
+
region: w.config.region,
|
|
165
|
+
lastCheckAt: w.lastCheckAt,
|
|
166
|
+
lastDiffPercent: w.lastDiffPercent,
|
|
167
|
+
createdAt: w.createdAt,
|
|
168
|
+
})), null, 2),
|
|
169
|
+
},
|
|
170
|
+
];
|
|
171
|
+
}
|
|
172
|
+
case 'remove_watch': {
|
|
173
|
+
removeWatch(args.id);
|
|
174
|
+
return [{ type: 'text', text: `Watch ${args.id} removed.` }];
|
|
175
|
+
}
|
|
176
|
+
default:
|
|
177
|
+
throw new Error(`Unknown tool: ${name}`);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
const server = new Server({ name: 'eyeballs', version: '0.1.0' }, { capabilities: { tools: {} } });
|
|
181
|
+
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
|
|
182
|
+
server.setRequestHandler(CallToolRequestSchema, async (request) => {
|
|
183
|
+
const { name, arguments: args } = request.params;
|
|
184
|
+
try {
|
|
185
|
+
const content = await handleTool(name, (args ?? {}));
|
|
186
|
+
return { content };
|
|
187
|
+
}
|
|
188
|
+
catch (error) {
|
|
189
|
+
const message = error instanceof EyeballsError
|
|
190
|
+
? `${error.code}: ${error.message}`
|
|
191
|
+
: `Error: ${error.message}`;
|
|
192
|
+
return {
|
|
193
|
+
content: [{ type: 'text', text: message }],
|
|
194
|
+
isError: true,
|
|
195
|
+
};
|
|
196
|
+
}
|
|
197
|
+
});
|
|
198
|
+
const transport = new StdioServerTransport();
|
|
199
|
+
await server.connect(transport);
|
|
200
|
+
console.error('eyeballs MCP server running');
|
|
201
|
+
//# sourceMappingURL=mcp.js.map
|
package/dist/mcp.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,GAGd,MAAM,WAAW,CAAC;AAEnB,MAAM,KAAK,GAAG;IACZ;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,6FAA6F;QAC/F,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yDAAyD;iBACvE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;oBAChD,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qBAC3B;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,8OAA8O;QAChP,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+EAA+E;oBAC5F,UAAU,EAAE;wBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qBAC3B;iBACF;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0EAA0E;iBACxF;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;oBAClE,UAAU,EAAE;wBACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACrB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qBAC3B;iBACF;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,4DAA4D;iBAC1E;aACF;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;CACF,CAAC;AAEF,KAAK,UAAU,UAAU,CACvB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,IAAI,CAAC,GAAa,EAClB,IAAI,CAAC,QAAgC,CACtC,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO;gBACL;oBACE,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,WAAW;iBACtB;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,YAAY,EAAE,MAAM,CAAC,MAAM;qBAC5B,CAAC;iBACH;aACF,CAAC;QACJ,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;gBAC5B,GAAG,EAAE,IAAI,CAAC,GAAa;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAgC;gBAC/C,SAAS,EAAE,IAAI,CAAC,SAA+B;gBAC/C,MAAM,EAAE,IAAI,CAAC,MAA4B;gBACzC,aAAa,EAAE,IAAI,CAAC,cAAqC;aAC1D,CAAC,CAAC;YAEH,MAAM,OAAO,GAA6E,EAAE,CAAC;YAE7F,gCAAgC;YAChC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAChD,QAAQ,EAAE,WAAW;aACtB,CAAC,CAAC;YAEH,yCAAyC;YACzC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAC1C,QAAQ,EAAE,WAAW;iBACtB,CAAC,CAAC;YACL,CAAC;YAED,eAAe;YACf,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE;oBACxB,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG;iBACtB,CAAC;aACH,CAAC,CAAC;YAEH,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;YAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sDAAsD,EAAE,CAAC,CAAC;YAC1F,CAAC;YACD,OAAO;gBACL;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAClB,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS;wBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;wBACvB,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;wBAClC,SAAS,EAAE,CAAC,CAAC,SAAS;qBACvB,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,WAAW,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YAC/B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAE1E,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;QAChF,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,KAAK,YAAY,aAAa;YAC5B,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE;YACnC,CAAC,CAAC,UAAW,KAAe,CAAC,OAAO,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1C,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "eyeballs-cli",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Visual monitoring for AI agents and humans. CLI + MCP server.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"eyeballs": "dist/cli.js",
|
|
8
|
+
"eyeballs-mcp": "dist/mcp.js"
|
|
9
|
+
},
|
|
10
|
+
"main": "./dist/core.js",
|
|
11
|
+
"scripts": {
|
|
12
|
+
"build": "tsc",
|
|
13
|
+
"dev": "tsc --watch",
|
|
14
|
+
"start:mcp": "node dist/mcp.js",
|
|
15
|
+
"start:cli": "node dist/cli.js",
|
|
16
|
+
"test": "vitest run",
|
|
17
|
+
"test:watch": "vitest",
|
|
18
|
+
"postinstall": "npx playwright install chromium",
|
|
19
|
+
"prepublishOnly": "npm run build"
|
|
20
|
+
},
|
|
21
|
+
"keywords": [
|
|
22
|
+
"mcp",
|
|
23
|
+
"ai",
|
|
24
|
+
"visual-monitoring",
|
|
25
|
+
"screenshot",
|
|
26
|
+
"diff",
|
|
27
|
+
"pixel-diff",
|
|
28
|
+
"eyeballs",
|
|
29
|
+
"playwright"
|
|
30
|
+
],
|
|
31
|
+
"author": "Dane Hesseldahl",
|
|
32
|
+
"license": "MIT",
|
|
33
|
+
"dependencies": {
|
|
34
|
+
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
35
|
+
"chalk": "^5.3.0",
|
|
36
|
+
"commander": "^12.1.0",
|
|
37
|
+
"ora": "^8.1.0",
|
|
38
|
+
"pixelmatch": "^6.0.0",
|
|
39
|
+
"playwright": "^1.49.0",
|
|
40
|
+
"pngjs": "^7.0.0"
|
|
41
|
+
},
|
|
42
|
+
"devDependencies": {
|
|
43
|
+
"@types/node": "^22.0.0",
|
|
44
|
+
"@types/pngjs": "^6.0.0",
|
|
45
|
+
"typescript": "^5.6.0",
|
|
46
|
+
"vitest": "^2.1.0"
|
|
47
|
+
},
|
|
48
|
+
"engines": {
|
|
49
|
+
"node": ">=18.0.0"
|
|
50
|
+
}
|
|
51
|
+
}
|
package/src/cli.ts
ADDED
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import { Command } from 'commander';
|
|
4
|
+
import chalk from 'chalk';
|
|
5
|
+
import ora from 'ora';
|
|
6
|
+
import { exec } from 'child_process';
|
|
7
|
+
import { platform } from 'os';
|
|
8
|
+
import {
|
|
9
|
+
capture,
|
|
10
|
+
checkUrl,
|
|
11
|
+
listWatches,
|
|
12
|
+
removeWatch,
|
|
13
|
+
shutdownBrowser,
|
|
14
|
+
EyeballsError,
|
|
15
|
+
} from './core.js';
|
|
16
|
+
import { writeFileSync } from 'fs';
|
|
17
|
+
import { join } from 'path';
|
|
18
|
+
|
|
19
|
+
const program = new Command();
|
|
20
|
+
|
|
21
|
+
program
|
|
22
|
+
.name('eyeballs')
|
|
23
|
+
.description('Visual monitoring for AI agents and humans')
|
|
24
|
+
.version('0.1.0');
|
|
25
|
+
|
|
26
|
+
// --- screenshot ---
|
|
27
|
+
|
|
28
|
+
program
|
|
29
|
+
.command('screenshot')
|
|
30
|
+
.description('Take a screenshot of a URL')
|
|
31
|
+
.argument('<url>', 'URL to screenshot')
|
|
32
|
+
.option('--viewport <size>', 'Viewport size (e.g., 1280x720)', '1280x720')
|
|
33
|
+
.option('-o, --output <path>', 'Output file path')
|
|
34
|
+
.option('--no-open', 'Do not open the screenshot after saving')
|
|
35
|
+
.action(async (url: string, opts: { viewport: string; output?: string; open: boolean }) => {
|
|
36
|
+
const spinner = ora('Capturing screenshot...').start();
|
|
37
|
+
try {
|
|
38
|
+
const [w, h] = opts.viewport.split('x').map(Number);
|
|
39
|
+
const viewport = { width: w || 1280, height: h || 720 };
|
|
40
|
+
|
|
41
|
+
const result = await capture(url, viewport);
|
|
42
|
+
|
|
43
|
+
const output = opts.output || `screenshot-${Date.now()}.png`;
|
|
44
|
+
writeFileSync(output, result.buffer);
|
|
45
|
+
spinner.succeed(`Screenshot saved: ${chalk.cyan(output)} (${result.width}x${result.height}, ${result.loadTimeMs}ms)`);
|
|
46
|
+
|
|
47
|
+
if (opts.open) {
|
|
48
|
+
openFile(output);
|
|
49
|
+
}
|
|
50
|
+
} catch (err) {
|
|
51
|
+
handleError(spinner, err);
|
|
52
|
+
} finally {
|
|
53
|
+
await shutdownBrowser();
|
|
54
|
+
}
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
// --- check ---
|
|
58
|
+
|
|
59
|
+
program
|
|
60
|
+
.command('check')
|
|
61
|
+
.description('Check a URL for visual changes')
|
|
62
|
+
.argument('<url>', 'URL to check')
|
|
63
|
+
.option('--viewport <size>', 'Viewport size (e.g., 1280x720)', '1280x720')
|
|
64
|
+
.option('--threshold <percent>', 'Diff threshold percentage', '5')
|
|
65
|
+
.option('--region <coords>', 'Crop region: x,y,width,height')
|
|
66
|
+
.option('--reset', 'Reset baseline to current state')
|
|
67
|
+
.action(async (url: string, opts: { viewport: string; threshold: string; region?: string; reset?: boolean }) => {
|
|
68
|
+
const spinner = ora('Checking URL...').start();
|
|
69
|
+
try {
|
|
70
|
+
const [w, h] = opts.viewport.split('x').map(Number);
|
|
71
|
+
const viewport = { width: w || 1280, height: h || 720 };
|
|
72
|
+
const threshold = parseFloat(opts.threshold);
|
|
73
|
+
|
|
74
|
+
let region = undefined;
|
|
75
|
+
if (opts.region) {
|
|
76
|
+
const [x, y, rw, rh] = opts.region.split(',').map(Number);
|
|
77
|
+
region = { x, y, width: rw, height: rh };
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
const result = await checkUrl({
|
|
81
|
+
url,
|
|
82
|
+
viewport,
|
|
83
|
+
threshold,
|
|
84
|
+
region,
|
|
85
|
+
resetBaseline: opts.reset,
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
if (result.message === 'Baseline captured') {
|
|
89
|
+
spinner.succeed(`Baseline captured for ${chalk.cyan(url)} (watch ID: ${chalk.yellow(result.watch.id)})`);
|
|
90
|
+
} else if (result.message === 'Baseline updated') {
|
|
91
|
+
spinner.succeed(`Baseline updated for ${chalk.cyan(url)}`);
|
|
92
|
+
} else if (result.changed) {
|
|
93
|
+
spinner.warn(
|
|
94
|
+
`${chalk.red('CHANGED')}: ${chalk.cyan(url)} — ${chalk.yellow(result.diffPercent + '%')} pixels differ (threshold: ${result.threshold}%)`,
|
|
95
|
+
);
|
|
96
|
+
} else {
|
|
97
|
+
spinner.succeed(
|
|
98
|
+
`${chalk.green('No change')}: ${chalk.cyan(url)} — ${chalk.dim(result.diffPercent + '%')} pixels differ`,
|
|
99
|
+
);
|
|
100
|
+
}
|
|
101
|
+
} catch (err) {
|
|
102
|
+
handleError(spinner, err);
|
|
103
|
+
} finally {
|
|
104
|
+
await shutdownBrowser();
|
|
105
|
+
}
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
// --- list ---
|
|
109
|
+
|
|
110
|
+
program
|
|
111
|
+
.command('list')
|
|
112
|
+
.description('List watched URLs')
|
|
113
|
+
.action(() => {
|
|
114
|
+
const watches = listWatches();
|
|
115
|
+
|
|
116
|
+
if (watches.length === 0) {
|
|
117
|
+
console.log(chalk.dim('No watches. Run `eyeballs check <url>` to start monitoring.'));
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
console.log(chalk.bold(`\n${watches.length} watch${watches.length === 1 ? '' : 'es'}:\n`));
|
|
122
|
+
for (const w of watches) {
|
|
123
|
+
const diffColor = w.lastDiffPercent > (w.config.threshold || 5) ? chalk.red : chalk.green;
|
|
124
|
+
console.log(
|
|
125
|
+
` ${chalk.yellow(w.id)} ${chalk.cyan(w.url)}`,
|
|
126
|
+
);
|
|
127
|
+
console.log(
|
|
128
|
+
` ${chalk.dim('viewport:')} ${w.viewport.width}x${w.viewport.height} ${chalk.dim('threshold:')} ${w.config.threshold}% ${chalk.dim('last diff:')} ${diffColor(w.lastDiffPercent + '%')}`,
|
|
129
|
+
);
|
|
130
|
+
if (w.lastCheckAt) {
|
|
131
|
+
console.log(` ${chalk.dim('last check:')} ${w.lastCheckAt}`);
|
|
132
|
+
}
|
|
133
|
+
console.log();
|
|
134
|
+
}
|
|
135
|
+
});
|
|
136
|
+
|
|
137
|
+
// --- remove ---
|
|
138
|
+
|
|
139
|
+
program
|
|
140
|
+
.command('remove')
|
|
141
|
+
.description('Remove a watch and its screenshots')
|
|
142
|
+
.argument('<id>', 'Watch ID to remove')
|
|
143
|
+
.action((id: string) => {
|
|
144
|
+
try {
|
|
145
|
+
removeWatch(id);
|
|
146
|
+
console.log(chalk.green(`Watch ${id} removed.`));
|
|
147
|
+
} catch (err) {
|
|
148
|
+
if (err instanceof EyeballsError) {
|
|
149
|
+
console.error(chalk.red(`${err.code}: ${err.message}`));
|
|
150
|
+
process.exit(1);
|
|
151
|
+
}
|
|
152
|
+
throw err;
|
|
153
|
+
}
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
// --- helpers ---
|
|
157
|
+
|
|
158
|
+
function handleError(spinner: ReturnType<typeof ora>, err: unknown): void {
|
|
159
|
+
if (err instanceof EyeballsError) {
|
|
160
|
+
spinner.fail(chalk.red(`${err.code}: ${err.message}`));
|
|
161
|
+
} else {
|
|
162
|
+
spinner.fail(chalk.red((err as Error).message));
|
|
163
|
+
}
|
|
164
|
+
process.exit(1);
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
function openFile(path: string): void {
|
|
168
|
+
const cmd = platform() === 'darwin' ? 'open' : platform() === 'win32' ? 'start' : 'xdg-open';
|
|
169
|
+
exec(`${cmd} ${JSON.stringify(join(process.cwd(), path))}`);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
program.parse();
|