@geometra/mcp 1.19.19 → 1.19.20

package/README.md

@@ -26,7 +26,7 @@ Proxy-backed sessions stay warm by default on disconnect, and MCP now keeps a sm
 |---|---|
 | `geometra_connect` | Connect with `url` (ws://…) **or** `pageUrl` (https://…) to auto-start geometra-proxy; can inline `formSchema` and/or `pageModel` for lower-turn starts |
 | `geometra_query` | Find elements by stable id, role, name, text content, ancestor/prompt context, current value, or semantic state such as `invalid`, `required`, or `busy` |
-| `geometra_wait_for` | Wait for a semantic condition instead of guessing sleeps (`busy`, `disabled`, alerts, values, etc.) |
+| `geometra_wait_for` | Wait for a semantic condition instead of guessing sleeps (`busy`, `disabled`, alerts, values, etc.). **Strict parameters** — use `text` plus `present: false` to wait until a substring disappears (e.g. “Parsing your resume”); there is no `textGone` field |
 | `geometra_form_schema` | Compact, fill-oriented form schema with stable field ids and collapsed radio/button groups; can auto-connect from `pageUrl` / `url` |
 | `geometra_fill_form` | Fill a form from `valuesById` / `valuesByLabel` in one MCP call; can auto-connect from `pageUrl` / `url` for the lowest-token known-form path |
 | `geometra_fill_fields` | Fill labeled text/choice/toggle/file fields in one MCP call; can return final-only status for the smallest responses |
@@ -46,6 +46,10 @@ Proxy-backed sessions stay warm by default on disconnect, and MCP now keeps a sm
 | `geometra_layout` | Raw computed geometry for every node |
 | `geometra_disconnect` | Close the connection |
 
+### `geometra_wait_for` and loading banners
+
+The tool input is **strict**: unknown keys are rejected (so mistaken names like `textGone` fail fast instead of being ignored). To wait until copy such as “Parsing…” or “Parsing your resume” is **gone**, pass a substring that matches the banner in **`text`** and set **`present`** to **`false`**. Example: `{ "text": "Parsing", "present": false }` (adjust the substring per site).
+
 ## Setup
 
 <details>

package/dist/server.js

@@ -51,7 +51,11 @@ function nodeFilterShape() {
 function waitConditionShape() {
     return {
         ...nodeFilterShape(),
-        present: z.boolean().optional().default(true).describe('Wait for a matching node to exist (default true) or disappear'),
+        present: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe('Wait until at least one node matches the filter (default true), or until no node matches (set false to wait out loading/parsing banners like “Parsing…” or “Parsing your resume”)'),
         timeoutMs: z
             .number()
             .int()
@@ -62,6 +66,15 @@ function waitConditionShape() {
             .describe('Maximum time to wait before returning an error (default 10000ms)'),
     };
 }
+const GEOMETRA_QUERY_FILTER_REQUIRED_MESSAGE = 'Provide at least one filter (id, role, name, text, contextText, value, checked, disabled, focused, selected, expanded, invalid, required, or busy). ' +
+    'This tool uses a strict schema: unknown keys are rejected. There is no textGone parameter — use text for substring matching. ' +
+    'To wait until text disappears from the UI, use geometra_wait_for with text and present: false.';
+const GEOMETRA_WAIT_FILTER_REQUIRED_MESSAGE = 'Provide at least one semantic filter (id, role, name, text, contextText, value, checked, disabled, focused, selected, expanded, invalid, required, or busy). ' +
+    'This tool uses a strict schema: unknown keys are rejected. There is no textGone parameter — use text with a distinctive substring and present: false to wait until that text is gone ' +
+    '(common for “Parsing…”, “Parsing your resume”, or similar). Passing only present/timeoutMs is not enough without a filter.';
+/** Strict input so unknown keys (e.g. textGone) fail parse; empty-filter checks happen in handlers / waitForSemanticCondition. */
+const geometraQueryInputSchema = z.object(nodeFilterShape()).strict();
+const geometraWaitForInputSchema = z.object(waitConditionShape()).strict();
 const timeoutMsInput = z.number().int().min(50).max(60_000).optional();
 const fillFieldSchema = z.discriminatedUnion('kind', [
     z.object({
@@ -195,7 +208,7 @@ const batchActionSchema = z.discriminatedUnion('type', [
     }),
 ]);
 export function createServer() {
-    const server = new McpServer({ name: 'geometra', version: '1.19.17' }, { capabilities: { tools: {} } });
+    const server = new McpServer({ name: 'geometra', version: '1.19.20' }, { capabilities: { tools: {} } });
     // ── connect ──────────────────────────────────────────────────
     server.tool('geometra_connect', `Connect to a Geometra WebSocket peer, or start \`geometra-proxy\` automatically for a normal web page.
 
@@ -322,7 +335,11 @@ Chromium opens **visible** by default unless \`headless: true\`. File upload / w
     // ── query ────────────────────────────────────────────────────
     server.tool('geometra_query', `Find elements in the current Geometra UI by stable id, role, name, text content, current value, or semantic state. Returns matching elements with their exact pixel bounds {x, y, width, height}, visible in-viewport bounds, an on-screen center point, visibility / scroll-reveal hints, role, name, value, state, and tree path.
 
-This is the Geometra equivalent of Playwright's locator — but instant, structured, and with no browser. Use the returned bounds to click elements or assert on layout.`, nodeFilterShape(), async ({ id, role, name, text, contextText, value, checked, disabled, focused, selected, expanded, invalid, required, busy }) => {
+This is the Geometra equivalent of Playwright's locator — but instant, structured, and with no browser. Use the returned bounds to click elements or assert on layout.
+
+Unknown parameter names are rejected (strict schema). To wait until visible text goes away (e.g. a parsing banner), use geometra_wait_for with that substring in text and present: false — there is no textGone field.`, 
+    // SDK overload typings only list raw shapes; runtime accepts ZodObject via getZodSchemaObject().
+    geometraQueryInputSchema, async ({ id, role, name, text, contextText, value, checked, disabled, focused, selected, expanded, invalid, required, busy }) => {
         const session = getSession();
         if (!session?.tree || !session?.layout)
             return err('Not connected. Call geometra_connect first.');
@@ -346,7 +363,7 @@ This is the Geometra equivalent of Playwright's locator — but instant, structu
             busy,
         };
         if (!hasNodeFilter(filter))
-            return err('Provide at least one query filter (id, role, name, text, contextText, value, or state)');
+            return err(GEOMETRA_QUERY_FILTER_REQUIRED_MESSAGE);
         const matches = findNodes(a11y, filter);
         if (matches.length === 0) {
             return ok(`No elements found matching ${JSON.stringify(filter)}`);
@@ -356,27 +373,30 @@ This is the Geometra equivalent of Playwright's locator — but instant, structu
     });
     server.tool('geometra_wait_for', `Wait for a semantic UI condition without guessing sleep durations. Use this for slow SPA transitions, resume parsing, custom validation alerts, disabled submit buttons, and value/state confirmation before submit.
 
-The filter matches the same fields as geometra_query. Set \`present: false\` to wait for something to disappear (for example an alert or a "Parsing…" status).`, waitConditionShape(), async ({ id, role, name, text, contextText, value, checked, disabled, focused, selected, expanded, invalid, required, busy, present, timeoutMs }) => {
+The filter matches the same fields as geometra_query (strict schema — unknown keys error). Set \`present: false\` to wait until **no** node matches — for example Ashby/Lever-style “Parsing your resume” or any “Parsing…” banner: \`{ "text": "Parsing", "present": false }\` (tune the substring to the site). Do not use a textGone parameter; use \`text\` + \`present: false\`.`, geometraWaitForInputSchema, async ({ id, role, name, text, contextText, value, checked, disabled, focused, selected, expanded, invalid, required, busy, present, timeoutMs }) => {
         const session = getSession();
         if (!session?.tree || !session?.layout)
             return err('Not connected. Call geometra_connect first.');
+        const filterProbe = {
+            id,
+            role,
+            name,
+            text,
+            contextText,
+            value,
+            checked,
+            disabled,
+            focused,
+            selected,
+            expanded,
+            invalid,
+            required,
+            busy,
+        };
+        if (!hasNodeFilter(filterProbe))
+            return err(GEOMETRA_WAIT_FILTER_REQUIRED_MESSAGE);
         const waited = await waitForSemanticCondition(session, {
-            filter: {
-                id,
-                role,
-                name,
-                text,
-                contextText,
-                value,
-                checked,
-                disabled,
-                focused,
-                selected,
-                expanded,
-                invalid,
-                required,
-                busy,
-            },
+            filter: filterProbe,
             present: present ?? true,
             timeoutMs: timeoutMs ?? 10_000,
         });
@@ -1665,7 +1685,7 @@ function compactFilterPayload(filter) {
 }
 async function waitForSemanticCondition(session, options) {
     if (!hasNodeFilter(options.filter)) {
-        return { ok: false, error: 'Provide at least one wait filter (id, role, name, text, contextText, value, or state)' };
+        return { ok: false, error: GEOMETRA_WAIT_FILTER_REQUIRED_MESSAGE };
     }
     const startedAt = Date.now();
     const matched = await waitForUiCondition(session, () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geometra/mcp",
-  "version": "1.19.19",
+  "version": "1.19.20",
   "description": "MCP server for Geometra — interact with running Geometra apps via the geometry protocol, no browser needed",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,7 @@
     "ui-testing"
   ],
   "dependencies": {
-    "@geometra/proxy": "^1.19.19",
+    "@geometra/proxy": "^1.19.20",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "ws": "^8.18.0",
     "zod": "^3.23.0"