agent-web-interface 4.2.0 → 4.4.0

package/dist/src/tools/index.js

@@ -3,9 +3,12 @@
  *
  * Browser automation tools exposed via MCP protocol.
  */
-export { initializeTools, getSnapshotStore } from './browser-tools.js';
+// Shared tool context
+export { initializeToolContext, getSnapshotStore } from './tool-context.js';
+// Legacy exports for backward compatibility
+export { initializeTools } from './browser-tools.js';
 // Tool handlers - Simplified API
-export { listPages, closePage, closeSession, navigate, goBack, goForward, reload, captureSnapshot, findElements, getNodeDetails, scrollElementIntoView, scrollPage, click, type, press, select, hover, takeScreenshot, } from './browser-tools.js';
+export { listPages, closePage, closeSession, navigate, goBack, goForward, reload, captureSnapshot, findElements, getNodeDetails, scrollElementIntoView, scrollPage, click, type, press, select, hover, drag, wheel, takeScreenshot, mapSchemaKindToNodeKind, } from './browser-tools.js';
 // Server config - lazy browser initialization
 export { ensureBrowserForTools, getSessionManager } from '../server/server-config.js';
 // Schemas - Simplified API
@@ -24,15 +27,15 @@ GoBackInputSchema, GoBackOutputSchema,
 GoForwardInputSchema, GoForwardOutputSchema, 
 // reload
 ReloadInputSchema, ReloadOutputSchema, 
-// capture_snapshot
+// snapshot
 CaptureSnapshotInputSchema, CaptureSnapshotOutputSchema, 
-// find_elements
+// find
 FindElementsInputSchema, FindElementsOutputSchema, 
-// get_element_details
+// get_element
 GetNodeDetailsInputSchema, GetNodeDetailsOutputSchema, 
-// scroll_element_into_view
+// scroll_to
 ScrollElementIntoViewInputSchema, ScrollElementIntoViewInputSchemaBase, ScrollElementIntoViewOutputSchema, 
-// scroll_page
+// scroll
 ScrollPageInputSchema, ScrollPageOutputSchema, 
 // click
 ClickInputSchema, ClickInputSchemaBase, ClickOutputSchema, 
@@ -44,10 +47,18 @@ PressInputSchema, PressOutputSchema,
 SelectInputSchema, SelectInputSchemaBase, SelectOutputSchema, 
 // hover
 HoverInputSchema, HoverInputSchemaBase, HoverOutputSchema, 
-// take_screenshot
-TakeScreenshotInputSchema, TakeScreenshotInputSchemaBase, TakeScreenshotOutputSchema, } from './tool-schemas.js';
+// drag
+DragInputSchema, DragInputSchemaBase, DragOutputSchema, 
+// wheel
+WheelInputSchema, WheelInputSchemaBase, WheelOutputSchema, 
+// screenshot
+TakeScreenshotInputSchema, TakeScreenshotInputSchemaBase, TakeScreenshotOutputSchema, 
+// inspect_canvas (unchanged)
+InspectCanvasInputSchema, InspectCanvasInputSchemaBase, } from './tool-schemas.js';
 // Tool result types
-export { isImageResult, isFileResult, } from './tool-result.types.js';
+export { isImageResult, isFileResult, isCompositeResult, } from './tool-result.types.js';
 // Form tools
 export { initializeFormTools, getFormUnderstanding, getFieldContext, GetFormUnderstandingInputSchema, GetFieldContextInputSchema, } from './form-tools.js';
+// Canvas tools
+export { inspectCanvas } from './canvas-tools.js';
 //# sourceMappingURL=index.js.map

package/dist/src/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,iCAAiC;AACjC,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,SAAS,EACT,MAAM,EACN,eAAe,EACf,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,KAAK,EACL,IAAI,EACJ,KAAK,EACL,MAAM,EACN,KAAK,EACL,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,8CAA8C;AAC9C,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,2BAA2B;AAC3B,OAAO;AACL,aAAa;AACb,oBAAoB,EACpB,qBAAqB;AAGrB,aAAa;AACb,oBAAoB,EACpB,qBAAqB;AAGrB,gBAAgB;AAChB,uBAAuB,EACvB,wBAAwB;AAGxB,WAAW;AACX,mBAAmB,EACnB,oBAAoB;AAGpB,UAAU;AACV,iBAAiB,EACjB,kBAAkB;AAGlB,aAAa;AACb,oBAAoB,EACpB,qBAAqB;AAGrB,SAAS;AACT,iBAAiB,EACjB,kBAAkB;AAGlB,mBAAmB;AACnB,0BAA0B,EAC1B,2BAA2B;AAG3B,gBAAgB;AAChB,uBAAuB,EACvB,wBAAwB;AAGxB,sBAAsB;AACtB,yBAAyB,EACzB,0BAA0B;AAG1B,2BAA2B;AAC3B,gCAAgC,EAChC,oCAAoC,EACpC,iCAAiC;AAGjC,cAAc;AACd,qBAAqB,EACrB,sBAAsB;AAGtB,QAAQ;AACR,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB;AAGjB,OAAO;AACP,eAAe,EACf,mBAAmB,EACnB,gBAAgB;AAGhB,QAAQ;AACR,gBAAgB,EAChB,iBAAiB;AAGjB,SAAS;AACT,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB;AAGlB,QAAQ;AACR,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB;AAGjB,kBAAkB;AAClB,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B,GAG3B,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,YAAY,GAIb,MAAM,wBAAwB,CAAC;AAEhC,aAAa;AACb,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,+BAA+B,EAC/B,0BAA0B,GAG3B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sBAAsB;AACtB,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,4CAA4C;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,iCAAiC;AACjC,OAAO,EACL,SAAS,EACT,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,SAAS,EACT,MAAM,EACN,eAAe,EACf,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,UAAU,EACV,KAAK,EACL,IAAI,EACJ,KAAK,EACL,MAAM,EACN,KAAK,EACL,IAAI,EACJ,KAAK,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,8CAA8C;AAC9C,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,2BAA2B;AAC3B,OAAO;AACL,aAAa;AACb,oBAAoB,EACpB,qBAAqB;AAGrB,aAAa;AACb,oBAAoB,EACpB,qBAAqB;AAGrB,gBAAgB;AAChB,uBAAuB,EACvB,wBAAwB;AAGxB,WAAW;AACX,mBAAmB,EACnB,oBAAoB;AAGpB,UAAU;AACV,iBAAiB,EACjB,kBAAkB;AAGlB,aAAa;AACb,oBAAoB,EACpB,qBAAqB;AAGrB,SAAS;AACT,iBAAiB,EACjB,kBAAkB;AAGlB,WAAW;AACX,0BAA0B,EAC1B,2BAA2B;AAG3B,OAAO;AACP,uBAAuB,EACvB,wBAAwB;AAGxB,cAAc;AACd,yBAAyB,EACzB,0BAA0B;AAG1B,YAAY;AACZ,gCAAgC,EAChC,oCAAoC,EACpC,iCAAiC;AAGjC,SAAS;AACT,qBAAqB,EACrB,sBAAsB;AAGtB,QAAQ;AACR,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB;AAGjB,OAAO;AACP,eAAe,EACf,mBAAmB,EACnB,gBAAgB;AAGhB,QAAQ;AACR,gBAAgB,EAChB,iBAAiB;AAGjB,SAAS;AACT,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB;AAGlB,QAAQ;AACR,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB;AAGjB,OAAO;AACP,eAAe,EACf,mBAAmB,EACnB,gBAAgB;AAGhB,QAAQ;AACR,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB;AAGjB,aAAa;AACb,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B;AAG1B,6BAA6B;AAC7B,wBAAwB,EACxB,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,GAKlB,MAAM,wBAAwB,CAAC;AAEhC,aAAa;AACb,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,+BAA+B,EAC/B,0BAA0B,GAG3B,MAAM,iBAAiB,CAAC;AAEzB,eAAe;AACf,OAAO,EAAE,aAAa,EAA0C,MAAM,mBAAmB,CAAC"}

package/dist/src/tools/interaction-tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Interaction Tools
+ *
+ * MCP tool handlers for element interaction: click, type, press, select, hover.
+ */
+/**
+ * Click an element or at viewport coordinates.
+ *
+ * Three modes:
+ * 1. eid only -> click element center (existing behavior)
+ * 2. eid + x/y -> click at offset relative to element top-left
+ * 3. x/y only -> click at absolute viewport coordinates
+ *
+ * @param rawInput - Click options (will be validated)
+ * @returns Click result with navigation-aware outcome
+ */
+export declare function click(rawInput: unknown): Promise<import('./tool-schemas.js').ClickOutput>;
+/**
+ * Type text into an element.
+ *
+ * @param rawInput - Type options (will be validated)
+ * @returns Type result with delta
+ */
+export declare function type(rawInput: unknown): Promise<import('./tool-schemas.js').TypeOutput>;
+/**
+ * Press a keyboard key (no agent_version).
+ *
+ * @param rawInput - Press options (will be validated)
+ * @returns Press result with delta
+ */
+export declare function press(rawInput: unknown): Promise<import('./tool-schemas.js').PressOutput>;
+/**
+ * Select a dropdown option.
+ *
+ * @param rawInput - Select options (will be validated)
+ * @returns Select result with delta
+ */
+export declare function select(rawInput: unknown): Promise<import('./tool-schemas.js').SelectOutput>;
+/**
+ * Hover over an element.
+ *
+ * @param rawInput - Hover options (will be validated)
+ * @returns Hover result with delta
+ */
+export declare function hover(rawInput: unknown): Promise<import('./tool-schemas.js').HoverOutput>;
+//# sourceMappingURL=interaction-tools.d.ts.map

package/dist/src/tools/interaction-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8BH;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,WAAW,CAAC,CAsD/F;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,UAAU,CAAC,CAyB7F;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,WAAW,CAAC,CAkB/F;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAuBjG;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,WAAW,CAAC,CAuB/F"}

package/dist/src/tools/interaction-tools.js

@@ -0,0 +1,138 @@
+/**
+ * Interaction Tools
+ *
+ * MCP tool handlers for element interaction: click, type, press, select, hover.
+ */
+import { clickByBackendNodeId, clickAtCoordinates, clickAtElementOffset, typeByBackendNodeId, pressKey, selectOption, hoverByBackendNodeId, } from '../snapshot/index.js';
+import { ClickInputSchema, TypeInputSchema, PressInputSchema, SelectInputSchema, HoverInputSchema, } from './tool-schemas.js';
+import { executeAction, executeActionWithRetry, executeActionWithOutcome, } from './execute-action.js';
+import { getSnapshotStore, requireSnapshot, resolveElementByEid } from './tool-context.js';
+import { prepareActionContext } from './action-context.js';
+// Convenience alias for module-internal use
+const snapshotStore = getSnapshotStore();
+/**
+ * Click an element or at viewport coordinates.
+ *
+ * Three modes:
+ * 1. eid only -> click element center (existing behavior)
+ * 2. eid + x/y -> click at offset relative to element top-left
+ * 3. x/y only -> click at absolute viewport coordinates
+ *
+ * @param rawInput - Click options (will be validated)
+ * @returns Click result with navigation-aware outcome
+ */
+export async function click(rawInput) {
+    const input = ClickInputSchema.parse(rawInput);
+    const hasEid = input.eid !== undefined;
+    const hasCoords = input.x !== undefined && input.y !== undefined;
+    if (!hasEid && !hasCoords) {
+        throw new Error('Either eid or both x and y coordinates must be provided.');
+    }
+    if ((input.x !== undefined) !== (input.y !== undefined)) {
+        throw new Error('Both x and y coordinates must be provided together.');
+    }
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id);
+    let result;
+    if (hasEid) {
+        // Mode 1 & 2: element-based click (center or offset)
+        const snap = requireSnapshot(pageId);
+        const node = resolveElementByEid(pageId, input.eid, snap);
+        result = await executeActionWithOutcome(handleRef.current, node, async (backendNodeId) => {
+            if (hasCoords) {
+                await clickAtElementOffset(handleRef.current.cdp, backendNodeId, input.x, input.y, input.modifiers);
+            }
+            else {
+                await clickByBackendNodeId(handleRef.current.cdp, backendNodeId, input.modifiers);
+            }
+        }, snapshotStore, captureSnapshot);
+    }
+    else {
+        // Mode 3: x/y only -> absolute viewport click
+        result = await executeAction(handleRef.current, async () => {
+            await clickAtCoordinates(handleRef.current.cdp, input.x, input.y, input.modifiers);
+        }, captureSnapshot);
+    }
+    snapshotStore.store(pageId, result.snapshot);
+    return result.state_response;
+}
+/**
+ * Type text into an element.
+ *
+ * @param rawInput - Type options (will be validated)
+ * @returns Type result with delta
+ */
+export async function type(rawInput) {
+    const input = TypeInputSchema.parse(rawInput);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id);
+    const snap = requireSnapshot(pageId);
+    const node = resolveElementByEid(pageId, input.eid, snap);
+    // Execute action with automatic retry on stale elements
+    const result = await executeActionWithRetry(handleRef.current, node, async (backendNodeId) => {
+        await typeByBackendNodeId(handleRef.current.cdp, backendNodeId, input.text, {
+            clear: input.clear,
+        });
+    }, snapshotStore, captureSnapshot);
+    // Store snapshot for future queries
+    snapshotStore.store(pageId, result.snapshot);
+    // Return XML state response directly
+    return result.state_response;
+}
+/**
+ * Press a keyboard key (no agent_version).
+ *
+ * @param rawInput - Press options (will be validated)
+ * @returns Press result with delta
+ */
+export async function press(rawInput) {
+    const input = PressInputSchema.parse(rawInput);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id);
+    // Execute action with new simplified wrapper
+    const result = await executeAction(handleRef.current, async () => {
+        await pressKey(handleRef.current.cdp, input.key, input.modifiers);
+    }, captureSnapshot);
+    // Store snapshot for future queries
+    snapshotStore.store(pageId, result.snapshot);
+    // Return XML state response directly
+    return result.state_response;
+}
+/**
+ * Select a dropdown option.
+ *
+ * @param rawInput - Select options (will be validated)
+ * @returns Select result with delta
+ */
+export async function select(rawInput) {
+    const input = SelectInputSchema.parse(rawInput);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id);
+    const snap = requireSnapshot(pageId);
+    const node = resolveElementByEid(pageId, input.eid, snap);
+    // Execute action with automatic retry on stale elements
+    const result = await executeActionWithRetry(handleRef.current, node, async (backendNodeId) => {
+        await selectOption(handleRef.current.cdp, backendNodeId, input.value);
+    }, snapshotStore, captureSnapshot);
+    // Store snapshot for future queries
+    snapshotStore.store(pageId, result.snapshot);
+    // Return XML state response directly
+    return result.state_response;
+}
+/**
+ * Hover over an element.
+ *
+ * @param rawInput - Hover options (will be validated)
+ * @returns Hover result with delta
+ */
+export async function hover(rawInput) {
+    const input = HoverInputSchema.parse(rawInput);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id);
+    const snap = requireSnapshot(pageId);
+    const node = resolveElementByEid(pageId, input.eid, snap);
+    // Execute action with automatic retry on stale elements
+    const result = await executeActionWithRetry(handleRef.current, node, async (backendNodeId) => {
+        await hoverByBackendNodeId(handleRef.current.cdp, backendNodeId);
+    }, snapshotStore, captureSnapshot);
+    // Store snapshot for future queries
+    snapshotStore.store(pageId, result.snapshot);
+    // Return XML state response directly
+    return result.state_response;
+}
+//# sourceMappingURL=interaction-tools.js.map

package/dist/src/tools/interaction-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-tools.js","sourceRoot":"","sources":["../../../src/tools/interaction-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,4CAA4C;AAC5C,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAiB;IAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC;IAEjE,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzF,IAAI,MAA0D,CAAC;IAE/D,IAAI,MAAM,EAAE,CAAC;QACX,qDAAqD;QACrD,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,GAAI,EAAE,IAAI,CAAC,CAAC;QAE3D,MAAM,GAAG,MAAM,wBAAwB,CACrC,SAAS,CAAC,OAAO,EACjB,IAAI,EACJ,KAAK,EAAE,aAAa,EAAE,EAAE;YACtB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,oBAAoB,CACxB,SAAS,CAAC,OAAO,CAAC,GAAG,EACrB,aAAa,EACb,KAAK,CAAC,CAAE,EACR,KAAK,CAAC,CAAE,EACR,KAAK,CAAC,SAAS,CAChB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACpF,CAAC;QACH,CAAC,EACD,aAAa,EACb,eAAe,CAChB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,8CAA8C;QAC9C,MAAM,GAAG,MAAM,aAAa,CAC1B,SAAS,CAAC,OAAO,EACjB,KAAK,IAAI,EAAE;YACT,MAAM,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAE,EAAE,KAAK,CAAC,CAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvF,CAAC,EACD,eAAe,CAChB,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,cAAc,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,QAAiB;IAC1C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzF,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAE1D,wDAAwD;IACxD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,SAAS,CAAC,OAAO,EACjB,IAAI,EACJ,KAAK,EAAE,aAAa,EAAE,EAAE;QACtB,MAAM,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE;YAC1E,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;IACL,CAAC,EACD,aAAa,EACb,eAAe,CAChB,CAAC;IAEF,oCAAoC;IACpC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,qCAAqC;IACrC,OAAO,MAAM,CAAC,cAAc,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAiB;IAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzF,6CAA6C;IAC7C,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,SAAS,CAAC,OAAO,EACjB,KAAK,IAAI,EAAE;QACT,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC,EACD,eAAe,CAChB,CAAC;IAEF,oCAAoC;IACpC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,qCAAqC;IACrC,OAAO,MAAM,CAAC,cAAc,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAiB;IAC5C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzF,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAE1D,wDAAwD;IACxD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,SAAS,CAAC,OAAO,EACjB,IAAI,EACJ,KAAK,EAAE,aAAa,EAAE,EAAE;QACtB,MAAM,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,EACD,aAAa,EACb,eAAe,CAChB,CAAC;IAEF,oCAAoC;IACpC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,qCAAqC;IACrC,OAAO,MAAM,CAAC,cAAc,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAiB;IAC3C,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzF,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAE1D,wDAAwD;IACxD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,SAAS,CAAC,OAAO,EACjB,IAAI,EACJ,KAAK,EAAE,aAAa,EAAE,EAAE;QACtB,MAAM,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC,EACD,aAAa,EACb,eAAe,CAChB,CAAC;IAEF,oCAAoC;IACpC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE7C,qCAAqC;IACrC,OAAO,MAAM,CAAC,cAAc,CAAC;AAC/B,CAAC"}

package/dist/src/tools/navigation-detection.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Navigation Detection
+ *
+ * Captures and compares navigation state (URL, loaderId) for click outcome classification.
+ *
+ * @module tools/navigation-detection
+ */
+import type { PageHandle } from '../browser/page-registry.js';
+/**
+ * Navigation state for detecting URL/loaderId changes.
+ */
+export interface NavigationState {
+    url: string;
+    loaderId?: string;
+}
+/**
+ * Capture current navigation state (URL and loaderId).
+ *
+ * @param handle - Page handle with CDP client
+ * @returns Navigation state with URL and optional loaderId
+ */
+export declare function captureNavigationState(handle: PageHandle): Promise<NavigationState>;
+/**
+ * Check if navigation occurred between two states.
+ *
+ * @param before - State before action
+ * @param after - State after action
+ * @returns True if navigation detected
+ */
+export declare function checkNavigationOccurred(before: NavigationState, after: NavigationState): boolean;
+//# sourceMappingURL=navigation-detection.d.ts.map

package/dist/src/tools/navigation-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-detection.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation-detection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAYzF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAgBhG"}

package/dist/src/tools/navigation-detection.js

@@ -0,0 +1,46 @@
+/**
+ * Navigation Detection
+ *
+ * Captures and compares navigation state (URL, loaderId) for click outcome classification.
+ *
+ * @module tools/navigation-detection
+ */
+/**
+ * Capture current navigation state (URL and loaderId).
+ *
+ * @param handle - Page handle with CDP client
+ * @returns Navigation state with URL and optional loaderId
+ */
+export async function captureNavigationState(handle) {
+    const url = handle.page.url();
+    let loaderId;
+    try {
+        const frameTree = await handle.cdp.send('Page.getFrameTree', undefined);
+        loaderId = frameTree.frameTree.frame.loaderId;
+    }
+    catch {
+        // Ignore - we can still detect navigation via URL
+    }
+    return { url, loaderId };
+}
+/**
+ * Check if navigation occurred between two states.
+ *
+ * @param before - State before action
+ * @param after - State after action
+ * @returns True if navigation detected
+ */
+export function checkNavigationOccurred(before, after) {
+    // URL changed = navigation
+    if (before.url !== after.url) {
+        return true;
+    }
+    // LoaderId changed (and both defined) = navigation
+    if (before.loaderId !== undefined &&
+        after.loaderId !== undefined &&
+        before.loaderId !== after.loaderId) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=navigation-detection.js.map

package/dist/src/tools/navigation-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-detection.js","sourceRoot":"","sources":["../../../src/tools/navigation-detection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAkB;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,IAAI,QAA4B,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;QACxE,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB,EAAE,KAAsB;IACrF,2BAA2B;IAC3B,IAAI,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,IACE,MAAM,CAAC,QAAQ,KAAK,SAAS;QAC7B,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/tools/navigation-tools.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Navigation Tools
+ *
+ * MCP tool handlers for browser navigation and session management.
+ */
+/**
+ * List all open browser pages with their metadata.
+ *
+ * Syncs with browser context to ensure all tabs are registered,
+ * including tabs opened externally or after reconnection.
+ *
+ * @returns XML result with page list
+ */
+export declare function listPages(): Promise<import('./tool-schemas.js').ListPagesOutput>;
+/**
+ * Close a specific page.
+ *
+ * @param rawInput - Close options (will be validated)
+ * @returns Close result
+ */
+export declare function closePage(rawInput: unknown): Promise<import('./tool-schemas.js').ClosePageOutput>;
+/**
+ * Close the entire browser session.
+ *
+ * @param rawInput - Close options (will be validated)
+ * @returns Close result
+ */
+export declare function closeSession(rawInput: unknown): Promise<import('./tool-schemas.js').CloseSessionOutput>;
+/**
+ * Navigate to a URL.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function navigate(rawInput: unknown): Promise<import('./tool-schemas.js').NavigateOutput>;
+/**
+ * Go back in browser history.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function goBack(rawInput: unknown): Promise<import('./tool-schemas.js').GoBackOutput>;
+/**
+ * Go forward in browser history.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function goForward(rawInput: unknown): Promise<import('./tool-schemas.js').GoForwardOutput>;
+/**
+ * Reload the current page.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function reload(rawInput: unknown): Promise<import('./tool-schemas.js').ReloadOutput>;
+//# sourceMappingURL=navigation-tools.d.ts.map

package/dist/src/tools/navigation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyFH;;;;;;;GAOG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CA4BtF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAUtD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,kBAAkB,CAAC,CAWzD;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,cAAc,CAAC,CAsBrD;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAGjG;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAGtD;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAGjG"}

package/dist/src/tools/navigation-tools.js

@@ -0,0 +1,178 @@
+/**
+ * Navigation Tools
+ *
+ * MCP tool handlers for browser navigation and session management.
+ */
+import { observationAccumulator } from '../observation/index.js';
+import { ClosePageInputSchema, CloseSessionInputSchema, NavigateInputSchema, GoBackInputSchema, GoForwardInputSchema, ReloadInputSchema, } from './tool-schemas.js';
+import { cleanupTempFiles } from '../lib/temp-file.js';
+import { getStateManager, removeStateManager, clearAllStateManagers, } from './state-manager-registry.js';
+import { stabilizeAfterNavigation } from './action-stabilization.js';
+import { buildClosePageResponse, buildCloseSessionResponse, buildListPagesResponse, } from './response-builder.js';
+import { getDependencyTracker } from '../form/index.js';
+import { getSessionManager, getSnapshotStore } from './tool-context.js';
+import { captureSnapshotWithRecovery } from './action-context.js';
+// Convenience alias for module-internal use
+const snapshotStore = getSnapshotStore();
+/**
+ * Execute a navigation action with snapshot capture.
+ * Consolidates goBack, goForward, and reload handlers.
+ *
+ * Waits for both DOM stabilization and network idle after navigation
+ * to ensure the page is fully loaded before capturing snapshot.
+ *
+ * @param pageId - Optional page ID
+ * @param action - Navigation action to execute
+ * @returns State response after navigation
+ */
+async function executeNavigationAction(pageId, action) {
+    const session = getSessionManager();
+    let handle = await session.resolvePageOrCreate(pageId);
+    const page_id = handle.page_id;
+    session.touchPage(page_id);
+    // Clear dependency tracker before navigation (old dependencies no longer valid)
+    getDependencyTracker().clearPage(page_id);
+    // Execute navigation
+    switch (action) {
+        case 'back':
+            await handle.page.goBack();
+            break;
+        case 'forward':
+            await handle.page.goForward();
+            break;
+        case 'reload':
+            await handle.page.reload();
+            break;
+    }
+    // Wait for page to stabilize (DOM + network idle)
+    await stabilizeAfterNavigation(handle.page);
+    // Re-inject observation accumulator (new document context after navigation)
+    await observationAccumulator.inject(handle.page);
+    // Auto-capture snapshot after navigation
+    const captureResult = await captureSnapshotWithRecovery(session, handle, page_id);
+    handle = captureResult.handle;
+    const snapshot = captureResult.snapshot;
+    snapshotStore.store(page_id, snapshot);
+    // Return XML state response (trimmed for navigation snapshots)
+    const stateManager = getStateManager(page_id);
+    return stateManager.generateResponse(snapshot, { trimRegions: true });
+}
+/**
+ * List all open browser pages with their metadata.
+ *
+ * Syncs with browser context to ensure all tabs are registered,
+ * including tabs opened externally or after reconnection.
+ *
+ * @returns XML result with page list
+ */
+export async function listPages() {
+    const session = getSessionManager();
+    // Sync to pick up any unregistered browser tabs
+    const pages = await session.syncPages();
+    const pageInfos = await Promise.all(pages.map(async (h) => {
+        const liveUrl = h.page.url?.() ?? h.url ?? '';
+        let liveTitle = h.title ?? '';
+        if (typeof h.page.title === 'function') {
+            try {
+                liveTitle = await h.page.title();
+            }
+            catch {
+                // Ignore pages that cannot expose title in the current state.
+            }
+        }
+        h.url = liveUrl;
+        h.title = liveTitle;
+        return {
+            page_id: h.page_id,
+            url: liveUrl,
+            title: liveTitle,
+        };
+    }));
+    return buildListPagesResponse(pageInfos);
+}
+/**
+ * Close a specific page.
+ *
+ * @param rawInput - Close options (will be validated)
+ * @returns Close result
+ */
+export async function closePage(rawInput) {
+    const input = ClosePageInputSchema.parse(rawInput);
+    const session = getSessionManager();
+    await session.closePage(input.page_id);
+    snapshotStore.removeByPageId(input.page_id);
+    removeStateManager(input.page_id); // Clean up state manager
+    getDependencyTracker().clearPage(input.page_id); // Clean up dependencies
+    return buildClosePageResponse(input.page_id);
+}
+/**
+ * Close the entire browser session.
+ *
+ * @param rawInput - Close options (will be validated)
+ * @returns Close result
+ */
+export async function closeSession(rawInput) {
+    CloseSessionInputSchema.parse(rawInput);
+    const session = getSessionManager();
+    await session.shutdown();
+    snapshotStore.clear();
+    clearAllStateManagers(); // Clean up all state managers
+    getDependencyTracker().clearAll(); // Clean up all dependencies
+    await cleanupTempFiles(); // Clean up screenshot temp files
+    return buildCloseSessionResponse();
+}
+/**
+ * Navigate to a URL.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export async function navigate(rawInput) {
+    const input = NavigateInputSchema.parse(rawInput);
+    const session = getSessionManager();
+    let handle = await session.resolvePageOrCreate(input.page_id);
+    const page_id = handle.page_id;
+    session.touchPage(page_id);
+    // Clear dependency tracker before navigation (old dependencies no longer valid)
+    getDependencyTracker().clearPage(page_id);
+    await session.navigateTo(page_id, input.url);
+    // Auto-capture snapshot after navigation
+    const captureResult = await captureSnapshotWithRecovery(session, handle, page_id);
+    handle = captureResult.handle;
+    const snapshot = captureResult.snapshot;
+    snapshotStore.store(page_id, snapshot);
+    // Return XML state response directly (trimmed for navigation snapshots)
+    const stateManager = getStateManager(page_id);
+    return stateManager.generateResponse(snapshot, { trimRegions: true });
+}
+/**
+ * Go back in browser history.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export async function goBack(rawInput) {
+    const input = GoBackInputSchema.parse(rawInput);
+    return executeNavigationAction(input.page_id, 'back');
+}
+/**
+ * Go forward in browser history.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export async function goForward(rawInput) {
+    const input = GoForwardInputSchema.parse(rawInput);
+    return executeNavigationAction(input.page_id, 'forward');
+}
+/**
+ * Reload the current page.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export async function reload(rawInput) {
+    const input = ReloadInputSchema.parse(rawInput);
+    return executeNavigationAction(input.page_id, 'reload');
+}
+//# sourceMappingURL=navigation-tools.js.map

package/dist/src/tools/navigation-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-tools.js","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/observation-tools.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Observation Tools
+ *
+ * MCP tool handlers for page observation: snapshots, find, get_element, scroll.
+ */
+import type { NodeKind } from '../snapshot/snapshot.types.js';
+/**
+ * Capture a fresh snapshot of the current page.
+ *
+ * @param rawInput - Capture options (will be validated)
+ * @returns Snapshot data for the current page
+ */
+export declare function captureSnapshot(rawInput: unknown): Promise<import('./tool-schemas.js').CaptureSnapshotOutput>;
+/**
+ * Map schema kind values to internal NodeKind values.
+ *
+ * The find schema uses user-friendly names that don't always match
+ * internal NodeKind values. For example, 'textbox' in the schema maps to
+ * both 'input' and 'textarea' internally.
+ *
+ * @param schemaKind - Kind value from the find schema
+ * @returns Matching NodeKind value(s)
+ */
+export declare function mapSchemaKindToNodeKind(schemaKind: string): NodeKind | NodeKind[];
+/**
+ * Find elements by semantic criteria.
+ *
+ * @param rawInput - Query filters (will be validated)
+ * @returns Matched nodes
+ */
+export declare function findElements(rawInput: unknown): import('./tool-schemas.js').FindElementsOutput;
+/**
+ * Get full details for a specific node.
+ *
+ * @param rawInput - Node details request (will be validated)
+ * @returns Full node details
+ */
+export declare function getNodeDetails(rawInput: unknown): import('./tool-schemas.js').GetNodeDetailsOutput;
+/**
+ * Scroll an element into view.
+ *
+ * @param rawInput - Scroll options (will be validated)
+ * @returns Scroll result with delta
+ */
+export declare function scrollElementIntoView(rawInput: unknown): Promise<import('./tool-schemas.js').ScrollElementIntoViewOutput>;
+/**
+ * Scroll the page up or down.
+ *
+ * @param rawInput - Scroll options (will be validated)
+ * @returns Scroll result with delta
+ */
+export declare function scrollPage(rawInput: unknown): Promise<import('./tool-schemas.js').ScrollPageOutput>;
+//# sourceMappingURL=observation-tools.d.ts.map