From 8bfeb803f03866f588833c3e5611ba76d0bdeafa Mon Sep 17 00:00:00 2001
From: Eric <ciregenz@berkeley.edu>
Date: Wed, 27 May 2026 16:00:19 -0700
Subject: [PATCH] [eric] test: add a selftest that proves the gui hand can
 launch, drive, and read the real app

---
 e2e/mcp/selftest.js | 53 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 e2e/mcp/selftest.js

diff --git a/e2e/mcp/selftest.js b/e2e/mcp/selftest.js
new file mode 100644
index 00000000..f0657eb8
--- /dev/null
+++ b/e2e/mcp/selftest.js
@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// Proves the openswarm-gui MCP server actually works, end-to-end, the way a CC
+// instance would use it: spawn the server over stdio, list its tools, then (unless
+// --no-launch) launch the real app, screenshot it, read the log, and close.
+//
+//   node e2e/mcp/selftest.js [--no-launch]
+//
+// Exit 0 = the hand works. Exit 1 = it doesn't (prints why).
+
+'use strict';
+const path = require('path');
+const { Client } = require('@modelcontextprotocol/sdk/client/index.js');
+const { StdioClientTransport } = require('@modelcontextprotocol/sdk/client/stdio.js');
+
+const NO_LAUNCH = process.argv.includes('--no-launch');
+
+async function main() {
+  const transport = new StdioClientTransport({ command: process.execPath, args: [path.join(__dirname, 'electron-mcp.js')] });
+  const client = new Client({ name: 'mcp-selftest', version: '0.1.0' }, { capabilities: {} });
+  await client.connect(transport);
+
+  const { tools } = await client.listTools();
+  const names = tools.map((t) => t.name);
+  process.stdout.write(`tools (${names.length}): ${names.join(', ')}\n`);
+  for (const required of ['app_launch', 'click', 'fill', 'screenshot', 'snapshot', 'eval', 'read_log', 'app_close']) {
+    if (!names.includes(required)) throw new Error(`missing tool: ${required}`);
+  }
+
+  if (NO_LAUNCH) {
+    process.stdout.write('\nMCP SELFTEST PASS (handshake + tools only; --no-launch).\n');
+    await client.close();
+    process.exit(0);
+  }
+
+  const launch = await client.callTool({ name: 'app_launch', arguments: {} });
+  if (launch.isError) throw new Error(`app_launch: ${launch.content?.[0]?.text}`);
+  process.stdout.write(`app_launch -> ${launch.content?.[0]?.text}\n`);
+
+  const shot = await client.callTool({ name: 'screenshot', arguments: {} });
+  const isImage = shot.content?.[0]?.type === 'image' && (shot.content[0].data || '').length > 1000;
+  if (!isImage) throw new Error('screenshot did not return a PNG');
+  process.stdout.write(`screenshot -> ${shot.content[0].data.length} base64 bytes\n`);
+
+  const log = await client.callTool({ name: 'read_log', arguments: { tailLines: 5 } });
+  process.stdout.write(`read_log tail:\n${log.content?.[0]?.text}\n`);
+
+  await client.callTool({ name: 'app_close', arguments: {} });
+  await client.close();
+  process.stdout.write('\nMCP SELFTEST PASS: server launched, drove, screenshotted, and read the app.\n');
+  process.exit(0);
+}
+
+main().catch((e) => { process.stderr.write(`\nMCP SELFTEST FAIL: ${e && e.message || e}\n`); process.exit(1); });