@geometra/mcp 1.25.0 → 1.27.0

package/dist/index.js

@@ -8,7 +8,7 @@ function cleanupActiveSession() {
         return;
     cleanedUp = true;
     try {
-        disconnect();
+        disconnect({ closeProxy: true });
     }
     catch {
         /* ignore */

package/dist/server.js

@@ -3,7 +3,7 @@ import { performance } from 'node:perf_hooks';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { formatConnectFailureMessage, isHttpUrl, normalizeConnectTarget } from './connect-utils.js';
-import { connect, connectThroughProxy, disconnect, getSession, listSessions, getDefaultSessionId, prewarmProxy, sendClick, sendFillFields, sendType, sendKey, sendFileUpload, sendFieldText, sendFieldChoice, sendListboxPick, sendSelectOption, sendSetChecked, sendWheel, sendScreenshot, sendPdfGenerate, buildA11yTree, buildCompactUiIndex, buildFormRequiredSnapshot, buildPageModel, buildFormSchemas, expandPageSection, buildUiDelta, hasUiDelta, nodeIdForPath, nodeContextForNode, summarizeCompactIndex, summarizePageModel, summarizeUiDelta, waitForUiCondition, } from './session.js';
+import { connect, connectThroughProxy, disconnect, getSession, listSessions, getDefaultSessionId, prewarmProxy, sendClick, sendFillFields, sendType, sendKey, sendFileUpload, sendFieldText, sendFieldChoice, sendListboxPick, sendSelectOption, sendSetChecked, sendWheel, sendScreenshot, sendPdfGenerate, buildA11yTree, buildCompactUiIndex, buildFormRequiredSnapshot, buildPageModel, buildFormSchemas, expandPageSection, buildUiDelta, hasUiDelta, nodeIdForPath, nodeContextForNode, parseSectionId, findNodeByPath, summarizeCompactIndex, summarizePageModel, summarizeUiDelta, waitForUiCondition, } from './session.js';
 function checkedStateInput() {
     return z
         .union([z.boolean(), z.literal('mixed')])
@@ -1755,7 +1755,7 @@ Use this for dropdowns, location pickers, or any scrollable list where items are
         maxScrollSteps: z.number().int().min(1).max(50).optional().default(20).describe('Max scroll steps before stopping (default 20)'),
         scrollDelta: z.number().optional().default(300).describe('Vertical scroll delta per step (default 300)'),
         sessionId: sessionIdInput,
-    }, async ({ listId: _listId, role, scrollX, scrollY, maxItems, maxScrollSteps, scrollDelta, sessionId }) => {
+    }, async ({ listId, role, scrollX, scrollY, maxItems, maxScrollSteps, scrollDelta, sessionId }) => {
         const session = getSession(sessionId);
         if (!session)
             return err('Not connected. Call geometra_connect first.');
@@ -1767,7 +1767,17 @@ Use this for dropdowns, location pickers, or any scrollable list where items are
             const a11y = await sessionA11yWhenReady(session);
             if (!a11y)
                 break;
-            const items = findNodes(a11y, { role: itemRole });
+            // Scope to subtree if listId is provided
+            let searchRoot = a11y;
+            if (listId) {
+                const parsed = parseSectionId(listId);
+                if (parsed) {
+                    const node = findNodeByPath(a11y, parsed.path);
+                    if (node)
+                        searchRoot = node;
+                }
+            }
+            const items = findNodes(searchRoot, { role: itemRole });
             let newCount = 0;
             for (const item of items) {
                 const id = nodeIdForPath(item.path);

package/dist/session.d.ts

@@ -594,6 +594,10 @@ export declare function sendNavigate(session: Session, url: string, timeoutMs?:
  */
 export declare function buildA11yTree(tree: Record<string, unknown>, layout: Record<string, unknown>): A11yNode;
 export declare function nodeIdForPath(path: number[]): string;
+export declare function parseSectionId(id: string): {
+    kind: PageSectionKind;
+    path: number[];
+} | null;
 /**
  * Flat list of actionable / semantic nodes in the viewport, sorted with focusable first
  * then top-to-bottom reading order. Intended to minimize LLM tokens vs a full nested tree.
@@ -608,6 +612,7 @@ export declare function buildCompactUiIndex(root: A11yNode, options?: {
     context: CompactUiContext;
 };
 export declare function summarizeCompactIndex(nodes: CompactUiNode[], maxLines?: number): string;
+export declare function findNodeByPath(root: A11yNode, path: number[]): A11yNode | null;
 export declare function nodeContextForNode(root: A11yNode, node: A11yNode): NodeContextModel | undefined;
 export declare function buildPageModel(root: A11yNode, options?: {
     maxPrimaryActions?: number;

package/dist/session.js

@@ -8,6 +8,9 @@ let nextSessionId = 0;
 function generateSessionId() { return `s${++nextSessionId}`; }
 let reusableProxies = [];
 const REUSABLE_PROXY_POOL_LIMIT = 6;
+/** Close idle reusable proxies after 5 minutes of inactivity. */
+const REUSABLE_PROXY_IDLE_TTL_MS = 5 * 60 * 1000;
+let idleProxyTimer = null;
 const trackedReusableProxyChildren = new WeakSet();
 const ACTION_UPDATE_TIMEOUT_MS = 2000;
 const LISTBOX_UPDATE_TIMEOUT_MS = 4500;
@@ -66,9 +69,11 @@ function closeReusableProxy(entry) {
         catch {
             /* ignore */
         }
+        ensureIdleProxyTimer();
         return;
     }
     void entry.runtime?.close().catch(() => { });
+    ensureIdleProxyTimer();
 }
 function closeReusableProxies() {
     clearReusableProxiesIfExited();
@@ -87,6 +92,25 @@ function closeReusableProxies() {
         void entry.runtime?.close().catch(() => { });
     }
 }
+function evictIdleReusableProxies() {
+    clearReusableProxiesIfExited();
+    const now = Date.now();
+    const stale = reusableProxies.filter(entry => !reusableProxyEntryIsActive(entry) && (now - entry.lastUsedAt) > REUSABLE_PROXY_IDLE_TTL_MS);
+    for (const entry of stale) {
+        closeReusableProxy(entry);
+    }
+    ensureIdleProxyTimer();
+}
+function ensureIdleProxyTimer() {
+    if (reusableProxies.length > 0 && !idleProxyTimer) {
+        idleProxyTimer = setInterval(evictIdleReusableProxies, 60_000);
+        idleProxyTimer.unref();
+    }
+    else if (reusableProxies.length === 0 && idleProxyTimer) {
+        clearInterval(idleProxyTimer);
+        idleProxyTimer = null;
+    }
+}
 function enforceReusableProxyPoolLimit() {
     clearReusableProxiesIfExited();
     if (reusableProxies.length <= REUSABLE_PROXY_POOL_LIMIT)
@@ -139,6 +163,7 @@ function setReusableProxy(proxy, wsUrl, opts) {
             child.once('error', clear);
         }
         enforceReusableProxyPoolLimit();
+        ensureIdleProxyTimer();
         return;
     }
     reusableProxies.push({
@@ -153,6 +178,7 @@ function setReusableProxy(proxy, wsUrl, opts) {
         lastUsedAt: now,
     });
     enforceReusableProxyPoolLimit();
+    ensureIdleProxyTimer();
 }
 function rememberReusableProxyPageUrl(session) {
     const entry = reusableProxyEntryForSession(session);
@@ -1046,7 +1072,7 @@ function sectionPrefix(kind) {
 function sectionIdForPath(kind, path) {
     return `${sectionPrefix(kind)}:${encodePath(path)}`;
 }
-function parseSectionId(id) {
+export function parseSectionId(id) {
     const [prefix, encoded] = id.split(':', 2);
     if (!prefix || !encoded)
         return null;
@@ -1314,7 +1340,7 @@ function firstNamedDescendant(node, allowedRoles) {
     }
     return undefined;
 }
-function findNodeByPath(root, path) {
+export function findNodeByPath(root, path) {
     let current = root;
     for (const index of path) {
         if (!current.children[index])
@@ -2054,10 +2080,25 @@ export function buildPageModel(root, options) {
     };
 }
 export function buildFormSchemas(root, options) {
-    const forms = sortByBounds([
+    const explicitForms = [
         ...(root.role === 'form' ? [root] : []),
         ...collectDescendants(root, candidate => candidate.role === 'form'),
-    ]);
+    ];
+    // Infer forms from group/region containers with 2+ form fields (e.g. Ashby-style UIs without <form>)
+    const inferredForms = collectDescendants(root, candidate => {
+        if (candidate.role !== 'group' && candidate.role !== 'region')
+            return false;
+        // Skip descendants of explicit forms
+        for (const form of explicitForms) {
+            if (candidate.path.length > form.path.length &&
+                form.path.every((v, i) => candidate.path[i] === v)) {
+                return false;
+            }
+        }
+        const fields = collectDescendants(candidate, child => FORM_FIELD_ROLES.has(child.role));
+        return fields.length >= 2;
+    });
+    const forms = sortByBounds([...explicitForms, ...inferredForms]);
     return forms
         .filter(form => !options?.formId || sectionIdForPath('form', form.path) === options.formId)
         .map(form => buildFormSchemaForNode(root, form, options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geometra/mcp",
-  "version": "1.25.0",
+  "version": "1.27.0",
   "description": "MCP server for Geometra — interact with running Geometra apps via the geometry protocol, no browser needed",
   "license": "MIT",
   "type": "module",