@geometra/mcp 1.61.3 → 1.62.1

package/dist/proxy-spawn.d.ts

@@ -40,7 +40,9 @@ export declare function startEmbeddedGeometraProxy(opts: SpawnProxyParams): Prom
     runtime: EmbeddedProxyRuntime;
     wsUrl: string;
 }>;
-export declare function parseProxyReadySignalLine(line: string): string | undefined;
+export declare function parseProxyReadySignalLine(line: string, options?: {
+    allowLegacy?: boolean;
+}): string | undefined;
 export declare function formatProxyStartupFailure(message: string, opts: SpawnProxyParams): string;
 /**
  * Spawn geometra-proxy as a child process and resolve when it emits a structured ready signal.

package/dist/proxy-spawn.js

@@ -7,6 +7,7 @@ const require = createRequire(import.meta.url);
 const READY_SIGNAL_TYPE = 'geometra-proxy-ready';
 const READY_TIMEOUT_MS = 45_000;
 const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+const PLAYWRIGHT_INSTALL_HINT = 'Install Chromium with the Playwright version bundled in this package: npm run browsers:install -w @geometra/proxy (repo checkout) or npx --no-install playwright install chromium.';
 /** Resolve bundled @geometra/proxy CLI entry (dist/index.js). */
 export function resolveProxyScriptPath() {
     return resolveProxyScriptPathWith(require);
@@ -125,17 +126,8 @@ function buildLocalProxyDistIfPossible(packageDir, entryFile, errors) {
     }
     return undefined;
 }
-function envRequestsStealth() {
-    const explicit = process.env.GEOMETRA_STEALTH;
-    if (explicit !== undefined) {
-        const v = explicit.toLowerCase();
-        return v === '1' || v === 'true' || v === 'yes' || v === 'stealth' || v === 'cloak';
-    }
-    const browser = (process.env.GEOMETRA_BROWSER ?? '').toLowerCase();
-    return browser === 'stealth' || browser === 'cloak' || browser === 'cloakbrowser';
-}
 export function resolveStealthMode(stealth) {
-    return stealth ?? envRequestsStealth();
+    return stealth ?? true;
 }
 export async function startEmbeddedGeometraProxy(opts) {
     const runtimePath = resolveProxyRuntimePath();
@@ -148,7 +140,7 @@ export async function startEmbeddedGeometraProxy(opts) {
         port: opts.port,
         width: opts.width,
         height: opts.height,
-        headed: opts.headless !== true,
+        headed: opts.headless === false,
         slowMo: opts.slowMo,
         ...(opts.stealth !== undefined && { stealth: opts.stealth }),
         eagerInitialExtract: opts.eagerInitialExtract,
@@ -156,7 +148,7 @@ export async function startEmbeddedGeometraProxy(opts) {
     });
     return { runtime, wsUrl: runtime.wsUrl };
 }
-export function parseProxyReadySignalLine(line) {
+export function parseProxyReadySignalLine(line, options) {
     const trimmed = line.trim();
     if (!trimmed)
         return undefined;
@@ -173,13 +165,15 @@ export function parseProxyReadySignalLine(line) {
             /* ignore non-JSON lines */
         }
     }
+    if (options?.allowLegacy === false)
+        return undefined;
     const fallback = trimmed.match(/WebSocket listening on (ws:\/\/127\.0\.0\.1:\d+)/);
     return fallback?.[1];
 }
 export function formatProxyStartupFailure(message, opts) {
     const hints = [];
     if (/Executable doesn't exist|playwright install chromium|browserType\.launch/i.test(message)) {
-        hints.push('Install Chromium with: npx playwright install chromium');
+        hints.push(PLAYWRIGHT_INSTALL_HINT);
     }
     if (/cloakbrowser|CLOAKBROWSER|ERR_MODULE_NOT_FOUND|Cannot find package/i.test(message)) {
         hints.push('Stealth mode uses CloakBrowser. Install dependencies with npm install, or disable stealth with stealth=false / GEOMETRA_STEALTH=0. To prefetch the patched Chromium binary, run: npx cloakbrowser install');
@@ -203,10 +197,10 @@ export function spawnGeometraProxy(opts) {
         args.push('--height', String(opts.height));
     if (opts.slowMo != null && opts.slowMo > 0)
         args.push('--slow-mo', String(opts.slowMo));
-    if (opts.headless === true)
-        args.push('--headless');
-    else if (opts.headless === false)
+    if (opts.headless === false)
         args.push('--headed');
+    else
+        args.push('--headless');
     if (opts.stealth === true)
         args.push('--stealth');
     else if (opts.stealth === false)
@@ -236,7 +230,7 @@ export function spawnGeometraProxy(opts) {
             child.stderr?.removeAllListeners('data');
         };
         const tryResolveReady = (line) => {
-            const wsUrl = parseProxyReadySignalLine(line);
+            const wsUrl = parseProxyReadySignalLine(line, { allowLegacy: false });
             if (!wsUrl || settled)
                 return false;
             settled = true;

package/dist/session.js

@@ -147,7 +147,7 @@ function setReusableProxy(proxy, wsUrl, opts) {
     const existing = reusableProxies.find(entry => sameReusableProxyEntry(entry, proxy));
     if (existing) {
         existing.wsUrl = wsUrl;
-        existing.headless = opts.headless === true;
+        existing.headless = opts.headless !== false;
         existing.stealth = stealth;
         existing.slowMo = opts.slowMo ?? 0;
         existing.width = opts.width ?? 1280;
@@ -163,7 +163,7 @@ function setReusableProxy(proxy, wsUrl, opts) {
         const entry = {
             child,
             wsUrl,
-            headless: opts.headless === true,
+            headless: opts.headless !== false,
             stealth,
             slowMo: opts.slowMo ?? 0,
             width: opts.width ?? 1280,
@@ -190,7 +190,7 @@ function setReusableProxy(proxy, wsUrl, opts) {
     reusableProxies.push({
         runtime: proxy.runtime,
         wsUrl,
-        headless: opts.headless === true,
+        headless: opts.headless !== false,
         stealth,
         slowMo: opts.slowMo ?? 0,
         width: opts.width ?? 1280,
@@ -324,6 +324,11 @@ function evictOldestSession() {
 function formatUnknownError(err) {
     return err instanceof Error ? err.message : String(err);
 }
+function rejectOnRuntimeReadyFailure(runtime) {
+    return new Promise((_, reject) => {
+        runtime.ready.catch(reject);
+    });
+}
 function warnSessionLifecycleError(action, session, err) {
     console.warn(`geometra-mcp: failed to ${action} for session ${session.id}: ${formatUnknownError(err)}`);
 }
@@ -408,7 +413,7 @@ function stopSessionHeartbeat(session) {
 }
 function reusableProxyMatchesOptions(entry, options) {
     return (entry.pageUrl === options.pageUrl &&
-        entry.headless === (options.headless === true) &&
+        entry.headless === (options.headless !== false) &&
         entry.stealth === resolveStealthMode(options.stealth) &&
         entry.slowMo === (options.slowMo ?? 0) &&
         entry.width === (options.width ?? 1280) &&
@@ -426,7 +431,7 @@ function findExactReusableProxy(options) {
 }
 function findReusableProxy(options) {
     clearReusableProxiesIfExited();
-    const desiredHeadless = options.headless === true;
+    const desiredHeadless = options.headless !== false;
     const desiredStealth = resolveStealthMode(options.stealth);
     const desiredSlowMo = options.slowMo ?? 0;
     const desiredWidth = options.width ?? 1280;
@@ -465,7 +470,7 @@ export async function prewarmProxy(options) {
             transport: existing.runtime ? 'embedded' : 'child',
             pageUrl: options.pageUrl,
             wsUrl: existing.wsUrl,
-            headless: options.headless === true,
+            headless: options.headless !== false,
             stealth: resolveStealthMode(options.stealth),
             width: options.width ?? 1280,
             height: options.height ?? 720,
@@ -506,7 +511,7 @@ export async function prewarmProxy(options) {
             transport: 'embedded',
             pageUrl: options.pageUrl,
             wsUrl,
-            headless: options.headless === true,
+            headless: options.headless !== false,
             stealth: resolveStealthMode(options.stealth),
             width: options.width ?? 1280,
             height: options.height ?? 720,
@@ -541,7 +546,7 @@ export async function prewarmProxy(options) {
             transport: 'child',
             pageUrl: options.pageUrl,
             wsUrl,
-            headless: options.headless === true,
+            headless: options.headless !== false,
             stealth: resolveStealthMode(options.stealth),
             width: options.width ?? 1280,
             height: options.height ?? 720,
@@ -641,11 +646,14 @@ async function startFreshProxySession(options) {
         });
         pendingEmbeddedRuntime = runtime;
         const proxyStartMs = performance.now() - proxyStartStartedAt;
-        const session = await connect(wsUrl, {
-            skipInitialResize: true,
-            closePreviousProxy: false,
-            awaitInitialFrame: options.awaitInitialFrame,
-        });
+        const session = await Promise.race([
+            connect(wsUrl, {
+                skipInitialResize: true,
+                closePreviousProxy: false,
+                awaitInitialFrame: options.awaitInitialFrame,
+            }),
+            rejectOnRuntimeReadyFailure(runtime),
+        ]);
         // Connect succeeded — the session now owns the runtime, so the
         // catch-block cleanup below must not also close it.
         pendingEmbeddedRuntime = undefined;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@geometra/mcp",
-  "version": "1.61.3",
+  "version": "1.62.1",
   "description": "MCP server for Geometra — interact with running Geometra apps via the geometry protocol, no browser needed",
   "license": "MIT",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://github.com/razroo/geometra",
+    "url": "https://github.com/Agent-Pattern-Labs/geometra",
     "directory": "mcp"
   },
   "bin": {
@@ -32,7 +32,7 @@
     "ui-testing"
   ],
   "dependencies": {
-    "@geometra/proxy": "^1.61.3",
+    "@geometra/proxy": "^1.62.1",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@razroo/parallel-mcp": "^0.1.0",
     "ws": "^8.18.0",