@geometra/mcp 1.19.5 → 1.19.6

package/README.md

@@ -26,7 +26,7 @@ Geometra proxy:       Chromium → DOM geometry → same WebSocket as native →
 | `geometra_type` | Type text into the focused element |
 | `geometra_key` | Send special keys (Enter, Tab, Escape, arrows) |
 | `geometra_upload_files` | Attach files: auto / hidden input / native chooser / synthetic drop (`@geometra/proxy` only) |
-| `geometra_pick_listbox_option` | Pick `role=option` (React Select, Headless UI, etc.; `@geometra/proxy` only) |
+| `geometra_pick_listbox_option` | Pick an option from a custom dropdown/searchable combobox; can open by field label (`@geometra/proxy` only) |
 | `geometra_select_option` | Choose an option on a native `<select>` (`@geometra/proxy` only) |
 | `geometra_set_checked` | Set a checkbox or radio by label instead of coordinate clicks (`@geometra/proxy` only) |
 | `geometra_wheel` | Mouse wheel / scroll (`@geometra/proxy` only) |

package/dist/server.js

@@ -3,7 +3,7 @@ import { z } from 'zod';
 import { formatConnectFailureMessage, isHttpUrl, normalizeConnectTarget } from './connect-utils.js';
 import { connect, connectThroughProxy, disconnect, getSession, sendClick, sendType, sendKey, sendFileUpload, sendListboxPick, sendSelectOption, sendSetChecked, sendWheel, buildA11yTree, buildCompactUiIndex, buildPageModel, expandPageSection, buildUiDelta, hasUiDelta, nodeIdForPath, summarizeCompactIndex, summarizePageModel, summarizeUiDelta, } from './session.js';
 export function createServer() {
-    const server = new McpServer({ name: 'geometra', version: '1.19.5' }, { capabilities: { tools: {} } });
+    const server = new McpServer({ name: 'geometra', version: '1.19.6' }, { capabilities: { tools: {} } });
     // ── connect ──────────────────────────────────────────────────
     server.tool('geometra_connect', `Connect to a Geometra WebSocket peer, or start \`geometra-proxy\` automatically for a normal web page.
 
@@ -221,14 +221,16 @@ Strategies: **auto** (default) tries chooser click if x,y given, else hidden \`i
             return err(e.message);
         }
     });
-    server.tool('geometra_pick_listbox_option', `Pick a visible \`role=option\` (Headless UI, React Select, Radix, etc.). Requires \`@geometra/proxy\`.
+    server.tool('geometra_pick_listbox_option', `Pick an option from a custom dropdown / listbox / searchable combobox (Headless UI, React Select, Radix, Ashby-style custom selects, etc.). Requires \`@geometra/proxy\`.
 
-Optional openX,openY clicks the combobox first if the list is not open. Uses substring name match unless exact=true.`, {
+Pass \`fieldLabel\` to open a labeled dropdown semantically instead of relying on coordinates. If the opened control is editable, MCP types \`query\` (or the option label by default) before selecting. Uses substring name match unless exact=true.`, {
         label: z.string().describe('Accessible name of the option (visible text or aria-label)'),
         exact: z.boolean().optional().describe('Exact name match'),
         openX: z.number().optional().describe('Click to open dropdown'),
         openY: z.number().optional().describe('Click to open dropdown'),
-    }, async ({ label, exact, openX, openY }) => {
+        fieldLabel: z.string().optional().describe('Field label of the dropdown/combobox to open semantically (e.g. "Location")'),
+        query: z.string().optional().describe('Optional text to type into a searchable combobox before selecting'),
+    }, async ({ label, exact, openX, openY, fieldLabel, query }) => {
         const session = getSession();
         if (!session)
             return err('Not connected. Call geometra_connect first.');
@@ -237,6 +239,8 @@ Optional openX,openY clicks the combobox first if the list is not open. Uses sub
             const wait = await sendListboxPick(session, label, {
                 exact,
                 open: openX !== undefined && openY !== undefined ? { x: openX, y: openY } : undefined,
+                fieldLabel,
+                query,
             });
             const summary = postActionSummary(session, before, wait);
             return ok(`Picked listbox option "${label}".\n${summary}`);

package/dist/session.d.ts

@@ -197,7 +197,7 @@ export interface Session {
     proxyChild?: ChildProcess;
 }
 export interface UpdateWaitResult {
-    status: 'updated' | 'timed_out';
+    status: 'updated' | 'acknowledged' | 'timed_out';
     timeoutMs: number;
 }
 /**
@@ -258,6 +258,8 @@ export declare function sendListboxPick(session: Session, label: string, opts?:
         x: number;
         y: number;
     };
+    fieldLabel?: string;
+    query?: string;
 }): Promise<UpdateWaitResult>;
 /** Native `<select>` only: click the control center, then pick by value, label text, or zero-based index. */
 export declare function sendSelectOption(session: Session, x: number, y: number, option: {

package/dist/session.js

@@ -204,6 +204,10 @@ export function sendListboxPick(session, label, opts) {
         payload.openX = opts.open.x;
         payload.openY = opts.open.y;
     }
+    if (opts?.fieldLabel)
+        payload.fieldLabel = opts.fieldLabel;
+    if (opts?.query)
+        payload.query = opts.query;
     return sendAndWaitForUpdate(session, payload);
 }
 /** Native `<select>` only: click the control center, then pick by value, label text, or zero-based index. */
@@ -1158,6 +1162,10 @@ function waitForNextUpdate(session) {
                     cleanup();
                     resolve({ status: 'updated', timeoutMs: ACTION_UPDATE_TIMEOUT_MS });
                 }
+                else if (msg.type === 'ack') {
+                    cleanup();
+                    resolve({ status: 'acknowledged', timeoutMs: ACTION_UPDATE_TIMEOUT_MS });
+                }
             }
             catch { /* ignore */ }
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geometra/mcp",
-  "version": "1.19.5",
+  "version": "1.19.6",
   "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.5",
+    "@geometra/proxy": "1.19.6",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "ws": "^8.18.0",
     "zod": "^3.23.0"