@geometra/mcp 1.19.15 → 1.19.17

package/dist/session.d.ts

@@ -1,5 +1,6 @@
 import type { ChildProcess } from 'node:child_process';
 import WebSocket from 'ws';
+import { type EmbeddedProxyRuntime } from './proxy-spawn.js';
 /**
  * Parsed accessibility node from the UI tree + computed layout.
  * Mirrors the shape of @geometra/core's AccessibilityNode without importing it
@@ -27,6 +28,7 @@ export interface A11yNode {
         pageUrl?: string;
         scrollX?: number;
         scrollY?: number;
+        controlTag?: string;
     };
     bounds: {
         x: number;
@@ -242,12 +244,16 @@ export interface PageSectionDetail {
     textPreview: string[];
 }
 export type FormSchemaFieldKind = 'text' | 'choice' | 'toggle' | 'multi_choice';
+export type FormSchemaChoiceType = 'select' | 'group' | 'listbox';
+export type FormSchemaContextMode = 'auto' | 'always' | 'none';
 export interface FormSchemaField {
     id: string;
     kind: FormSchemaFieldKind;
     label: string;
     required?: boolean;
     invalid?: boolean;
+    choiceType?: FormSchemaChoiceType;
+    booleanChoice?: boolean;
     controlType?: 'checkbox' | 'radio';
     value?: string;
     valueLength?: number;
@@ -265,6 +271,14 @@ export interface FormSchemaModel {
     invalidCount: number;
     fields: FormSchemaField[];
 }
+export interface FormSchemaBuildOptions {
+    formId?: string;
+    maxFields?: number;
+    onlyRequiredFields?: boolean;
+    onlyInvalidFields?: boolean;
+    includeOptions?: boolean;
+    includeContext?: FormSchemaContextMode;
+}
 export interface UiNodeUpdate {
     before: CompactUiNode;
     after: CompactUiNode;
@@ -312,6 +326,14 @@ export interface Session {
     updateRevision: number;
     /** Present when this session owns a child geometra-proxy process (pageUrl connect). */
     proxyChild?: ChildProcess;
+    proxyRuntime?: EmbeddedProxyRuntime;
+    proxyReusable?: boolean;
+    cachedA11y?: A11yNode | null;
+    cachedA11yRevision?: number;
+    cachedFormSchemas?: Map<string, {
+        revision: number;
+        forms: FormSchemaModel[];
+    }>;
 }
 export interface UpdateWaitResult {
     status: 'updated' | 'acknowledged' | 'timed_out';
@@ -319,16 +341,25 @@ export interface UpdateWaitResult {
     result?: unknown;
 }
 export type ProxyFillField = {
+    kind: 'auto';
+    fieldId?: string;
+    fieldLabel: string;
+    value: string | boolean;
+    exact?: boolean;
+} | {
     kind: 'text';
+    fieldId?: string;
     fieldLabel: string;
     value: string;
     exact?: boolean;
 } | {
     kind: 'choice';
+    fieldId?: string;
     fieldLabel: string;
     value: string;
     query?: string;
     exact?: boolean;
+    choiceType?: FormSchemaChoiceType;
 } | {
     kind: 'toggle';
     label: string;
@@ -337,6 +368,7 @@ export type ProxyFillField = {
     controlType?: 'checkbox' | 'radio';
 } | {
     kind: 'file';
+    fieldId?: string;
     fieldLabel: string;
     paths: string[];
     exact?: boolean;
@@ -349,6 +381,8 @@ export declare function connect(url: string, opts?: {
     width?: number;
     height?: number;
     skipInitialResize?: boolean;
+    closePreviousProxy?: boolean;
+    awaitInitialFrame?: boolean;
 }): Promise<Session>;
 /**
  * Start geometra-proxy for `pageUrl`, connect to its WebSocket, and attach the child
@@ -361,9 +395,12 @@ export declare function connectThroughProxy(options: {
     width?: number;
     height?: number;
     slowMo?: number;
+    awaitInitialFrame?: boolean;
 }): Promise<Session>;
 export declare function getSession(): Session | null;
-export declare function disconnect(): void;
+export declare function disconnect(opts?: {
+    closeProxy?: boolean;
+}): void;
 export declare function waitForUiCondition(session: Session, predicate: () => boolean, timeoutMs: number): Promise<boolean>;
 /**
  * Send a click event at (x, y) and wait for the next frame/patch response.
@@ -402,11 +439,14 @@ export declare function sendFileUpload(session: Session, paths: string[], opts?:
 /** Set a labeled text-like field (`input`, `textarea`, contenteditable, ARIA textbox) semantically. */
 export declare function sendFieldText(session: Session, fieldLabel: string, value: string, opts?: {
     exact?: boolean;
+    fieldId?: string;
 }, timeoutMs?: number): Promise<UpdateWaitResult>;
 /** Choose a value for a labeled choice field (select, custom combobox, or radio-style group). */
 export declare function sendFieldChoice(session: Session, fieldLabel: string, value: string, opts?: {
     exact?: boolean;
     query?: string;
+    choiceType?: FormSchemaChoiceType;
+    fieldId?: string;
 }, timeoutMs?: number): Promise<UpdateWaitResult>;
 /** Fill several semantic form fields in one proxy-side batch. */
 export declare function sendFillFields(session: Session, fields: ProxyFillField[], timeoutMs?: number): Promise<UpdateWaitResult>;
@@ -438,6 +478,8 @@ export declare function sendWheel(session: Session, deltaY: number, opts?: {
     x?: number;
     y?: number;
 }, timeoutMs?: number): Promise<UpdateWaitResult>;
+/** Navigate the proxy page to a new URL while keeping the browser process alive. */
+export declare function sendNavigate(session: Session, url: string, timeoutMs?: number): Promise<UpdateWaitResult>;
 /**
  * Build a flat accessibility tree from the raw UI tree + layout.
  * This is a standalone reimplementation that works with raw JSON —
@@ -467,12 +509,7 @@ export declare function buildPageModel(root: A11yNode, options?: {
     maxPrimaryActions?: number;
     maxSectionsPerKind?: number;
 }): PageModel;
-export declare function buildFormSchemas(root: A11yNode, options?: {
-    formId?: string;
-    maxFields?: number;
-    onlyRequiredFields?: boolean;
-    onlyInvalidFields?: boolean;
-}): FormSchemaModel[];
+export declare function buildFormSchemas(root: A11yNode, options?: FormSchemaBuildOptions): FormSchemaModel[];
 /**
  * Expand a page-model section by stable ID into richer, on-demand details.
  */