agent-web-interface 4.4.0 → 4.5.0

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

@@ -6,6 +6,7 @@
  * queries their scene graphs for object metadata, and returns annotated screenshots.
  */
 import type { CompositeResult } from './tool-result.types.js';
+import type { ToolContext } from './tool-context.types.js';
 /** A single detected object on the canvas. */
 export interface CanvasObject {
     type: string;
@@ -28,5 +29,5 @@ export interface CanvasMetadata {
  * Inspect a canvas element: detect library, query scene graph, and return
  * an annotated screenshot with coordinate grid + object bounding boxes.
  */
-export declare function inspectCanvas(rawInput: unknown): Promise<CompositeResult>;
+export declare function inspectCanvas(rawInput: unknown, ctx: ToolContext): Promise<CompositeResult>;
 //# sourceMappingURL=canvas-tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"canvas-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/canvas-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,wBAAwB,CAAC;AAavF,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AA4TD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CA8D/E"}
+{"version":3,"file":"canvas-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/canvas-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,wBAAwB,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM3D,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AA4TD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CA6DjG"}

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

@@ -7,7 +7,6 @@
  */
 import { InspectCanvasInputSchema } from './tool-schemas.js';
 import { captureScreenshot, getElementBoundingBox } from '../screenshot/index.js';
-import { getSessionManager, resolveExistingPage, ensureCdpSession, requireSnapshot, resolveElementByEid, } from './tool-context.js';
 // ---------------------------------------------------------------------------
 // Canvas detection script (executed in page context via Runtime.callFunctionOn)
 // ---------------------------------------------------------------------------
@@ -314,15 +313,14 @@ async function cleanupInspection(cdp, objectId) {
  * Inspect a canvas element: detect library, query scene graph, and return
  * an annotated screenshot with coordinate grid + object bounding boxes.
  */
-export async function inspectCanvas(rawInput) {
+export async function inspectCanvas(rawInput, ctx) {
     const input = InspectCanvasInputSchema.parse(rawInput);
-    const session = getSessionManager();
-    let handle = resolveExistingPage(session, input.page_id);
+    let handle = ctx.resolveExistingPage(input.page_id);
     const pageId = handle.page_id;
-    const ensureResult = await ensureCdpSession(session, handle);
+    const ensureResult = await ctx.ensureCdpSession(handle);
     handle = ensureResult.handle;
-    const snapshot = requireSnapshot(pageId);
-    const node = resolveElementByEid(pageId, input.eid, snapshot);
+    const snapshot = ctx.requireSnapshot(pageId);
+    const node = ctx.resolveElementByEid(pageId, input.eid, snapshot);
     // Scroll canvas into view before computing bounding box and overlay
     await handle.cdp.send('DOM.scrollIntoViewIfNeeded', {
         backendNodeId: node.backend_node_id,

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

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

package/dist/src/tools/errors.d.ts

@@ -4,32 +4,11 @@
  * Standardized errors for browser tools with consistent formatting.
  * All errors follow the pattern: `${context}: ${identifier}` or `${message}. ${instruction}`
  */
-/**
- * Base error class for all tool errors.
- */
-export declare class ToolError extends Error {
+declare class ToolError extends Error {
     readonly code: string;
     readonly details?: Record<string, unknown> | undefined;
     constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
 }
-/**
- * Thrown when tools are used before initialization.
- */
-export declare class ToolsNotInitializedError extends ToolError {
-    constructor();
-}
-/**
- * Thrown when a page is not found by ID.
- */
-export declare class PageNotFoundError extends ToolError {
-    constructor(pageId: string);
-}
-/**
- * Thrown when no page is available for operations.
- */
-export declare class NoPageAvailableError extends ToolError {
-    constructor();
-}
 /**
  * Thrown when a snapshot is required but not available.
  */
@@ -48,16 +27,5 @@ export declare class ElementNotFoundError extends ToolError {
 export declare class StaleElementError extends ToolError {
     constructor(eid: string);
 }
-/**
- * Thrown when a node is not found in snapshot.
- */
-export declare class NodeNotFoundError extends ToolError {
-    constructor(nodeId: string);
-}
-/**
- * Thrown when eid is required but not provided.
- */
-export declare class EidRequiredError extends ToolError {
-    constructor();
-}
+export {};
 //# sourceMappingURL=errors.d.ts.map

package/dist/src/tools/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAGhB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;;CAItD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,MAAM,EAAE,MAAM;CAG3B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;;CAIlD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,MAAM,EAAE,MAAM;CAK3B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,GAAG,EAAE,MAAM;CAGxB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,GAAG,EAAE,MAAM;CAGxB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,MAAM,EAAE,MAAM;CAG3B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;;CAI9C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAM,SAAU,SAAQ,KAAK;aAGT,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,MAAM,EAAE,MAAM;CAK3B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,GAAG,EAAE,MAAM;CAGxB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,GAAG,EAAE,MAAM;CAGxB"}

package/dist/src/tools/errors.js

@@ -4,10 +4,7 @@
  * Standardized errors for browser tools with consistent formatting.
  * All errors follow the pattern: `${context}: ${identifier}` or `${message}. ${instruction}`
  */
-/**
- * Base error class for all tool errors.
- */
-export class ToolError extends Error {
+class ToolError extends Error {
     code;
     details;
     constructor(message, code, details) {
@@ -17,30 +14,6 @@ export class ToolError extends Error {
         this.name = 'ToolError';
     }
 }
-/**
- * Thrown when tools are used before initialization.
- */
-export class ToolsNotInitializedError extends ToolError {
-    constructor() {
-        super('Tools not initialized. Call initializeTools() first.', 'TOOLS_NOT_INITIALIZED');
-    }
-}
-/**
- * Thrown when a page is not found by ID.
- */
-export class PageNotFoundError extends ToolError {
-    constructor(pageId) {
-        super(`Page not found: ${pageId}`, 'PAGE_NOT_FOUND', { pageId });
-    }
-}
-/**
- * Thrown when no page is available for operations.
- */
-export class NoPageAvailableError extends ToolError {
-    constructor() {
-        super('No page available. Use launch_browser first.', 'NO_PAGE_AVAILABLE');
-    }
-}
 /**
  * Thrown when a snapshot is required but not available.
  */
@@ -67,20 +40,4 @@ export class StaleElementError extends ToolError {
         super(`Element has stale reference: ${eid}`, 'STALE_ELEMENT', { eid });
     }
 }
-/**
- * Thrown when a node is not found in snapshot.
- */
-export class NodeNotFoundError extends ToolError {
-    constructor(nodeId) {
-        super(`Node not found in snapshot: ${nodeId}`, 'NODE_NOT_FOUND', { nodeId });
-    }
-}
-/**
- * Thrown when eid is required but not provided.
- */
-export class EidRequiredError extends ToolError {
-    constructor() {
-        super('Element ID (eid) is required.', 'EID_REQUIRED');
-    }
-}
 //# sourceMappingURL=errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD;QACE,KAAK,CAAC,sDAAsD,EAAE,uBAAuB,CAAC,CAAC;IACzF,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,MAAc;QACxB,KAAK,CAAC,mBAAmB,MAAM,EAAE,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD;QACE,KAAK,CAAC,8CAA8C,EAAE,mBAAmB,CAAC,CAAC;IAC7E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAClD,YAAY,MAAc;QACxB,KAAK,CAAC,wBAAwB,MAAM,6BAA6B,EAAE,mBAAmB,EAAE;YACtF,MAAM;SACP,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,YAAY,GAAW;QACrB,KAAK,CAAC,sBAAsB,GAAG,EAAE,EAAE,mBAAmB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,GAAW;QACrB,KAAK,CAAC,gCAAgC,GAAG,EAAE,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,MAAc;QACxB,KAAK,CAAC,+BAA+B,MAAM,EAAE,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C;QACE,KAAK,CAAC,+BAA+B,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/tools/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,SAAU,SAAQ,KAAK;IAGT;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAClD,YAAY,MAAc;QACxB,KAAK,CAAC,wBAAwB,MAAM,6BAA6B,EAAE,mBAAmB,EAAE;YACtF,MAAM;SACP,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,YAAY,GAAW;QACrB,KAAK,CAAC,sBAAsB,GAAG,EAAE,EAAE,mBAAmB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,GAAW;QACrB,KAAK,CAAC,gCAAgC,GAAG,EAAE,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/src/tools/execute-action.d.ts

@@ -12,6 +12,7 @@ import type { PageHandle } from '../browser/page-registry.js';
 import type { StateResponse } from '../state/types.js';
 import type { ClickOutcome } from '../state/element-ref.types.js';
 import type { RuntimeHealth } from '../state/health.types.js';
+import type { ToolContext } from './tool-context.types.js';
 /**
  * Result of executing an action.
  */
@@ -64,7 +65,7 @@ export type CaptureSnapshotFn = () => Promise<{
  * @param action - The action to execute
  * @returns Action result with page brief and metadata
  */
-export declare function executeAction(handle: PageHandle, action: () => Promise<void>, captureSnapshot?: CaptureSnapshotFn): Promise<ActionResult>;
+export declare function executeAction(handle: PageHandle, action: () => Promise<void>, ctx: ToolContext, captureSnapshot?: CaptureSnapshotFn): Promise<ActionResult>;
 /**
  * Execute an element-based action with automatic retry on stale element errors.
  *
@@ -81,7 +82,7 @@ export declare function executeAction(handle: PageHandle, action: () => Promise<
  * @param snapshotStore - Snapshot store to update with fresh snapshot
  * @returns Action result with page brief and metadata
  */
-export declare function executeActionWithRetry(handle: PageHandle, node: ReadableNode, action: (backendNodeId: number) => Promise<void>, snapshotStore?: {
+export declare function executeActionWithRetry(handle: PageHandle, node: ReadableNode, action: (backendNodeId: number) => Promise<void>, ctx: ToolContext, snapshotStore?: {
     store: (pageId: string, snapshot: BaseSnapshot) => void;
 }, captureSnapshot?: CaptureSnapshotFn): Promise<ActionResult>;
 /**
@@ -99,7 +100,7 @@ export declare function executeActionWithRetry(handle: PageHandle, node: Readabl
  * @param snapshotStore - Snapshot store to update with fresh snapshot
  * @returns ActionResultWithOutcome including ClickOutcome
  */
-export declare function executeActionWithOutcome(handle: PageHandle, node: ReadableNode, action: (backendNodeId: number) => Promise<void>, snapshotStore?: {
+export declare function executeActionWithOutcome(handle: PageHandle, node: ReadableNode, action: (backendNodeId: number) => Promise<void>, ctx: ToolContext, snapshotStore?: {
     store: (pageId: string, snapshot: BaseSnapshot) => void;
 }, captureSnapshot?: CaptureSnapshotFn): Promise<ActionResultWithOutcome>;
 //# sourceMappingURL=execute-action.d.ts.map

package/dist/src/tools/execute-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-action.d.ts","sourceRoot":"","sources":["../../../src/tools/execute-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAe9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,wDAAwD;IACxD,cAAc,EAAE,aAAa,CAAC;IAE9B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,YAAY,CAAC;IAEvB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,aAAa,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,8CAA8C;IAC9C,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC;IAC5C,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,aAAa,CAAC;CAC/B,CAAC,CAAC;AAMH;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,eAAe,CAAC,EAAE,iBAAiB,GAClC,OAAO,CAAC,YAAY,CAAC,CAyDvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,aAAa,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;CAAE,EAC3E,eAAe,CAAC,EAAE,iBAAiB,GAClC,OAAO,CAAC,YAAY,CAAC,CA2GvB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,aAAa,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;CAAE,EAC3E,eAAe,CAAC,EAAE,iBAAiB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CA0IlC"}
+{"version":3,"file":"execute-action.d.ts","sourceRoot":"","sources":["../../../src/tools/execute-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAU3D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,wDAAwD;IACxD,cAAc,EAAE,aAAa,CAAC;IAE9B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,YAAY,CAAC;IAEvB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,aAAa,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,8CAA8C;IAC9C,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC;IAC5C,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,EAAE,aAAa,CAAC;CAC/B,CAAC,CAAC;AAMH;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,GAAG,EAAE,WAAW,EAChB,eAAe,CAAC,EAAE,iBAAiB,GAClC,OAAO,CAAC,YAAY,CAAC,CA0DvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,GAAG,EAAE,WAAW,EAChB,aAAa,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;CAAE,EAC3E,eAAe,CAAC,EAAE,iBAAiB,GAClC,OAAO,CAAC,YAAY,CAAC,CA4GvB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,GAAG,EAAE,WAAW,EAChB,aAAa,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAA;CAAE,EAC3E,eAAe,CAAC,EAAE,iBAAiB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CA2IlC"}

package/dist/src/tools/execute-action.js

@@ -7,10 +7,7 @@
  *
  * Navigation-aware click outcome model for better error classification.
  */
-import { observationAccumulator } from '../observation/index.js';
 import { ATTACHMENT_SIGNIFICANCE_THRESHOLD } from '../observation/observation.types.js';
-import { getDependencyTracker } from '../form/index.js';
-import { getStateManager } from './state-manager-registry.js';
 import { computeObservedEffect } from './effect-tracker.js';
 import { stabilizeAfterAction, captureSnapshotFallback } from './action-stabilization.js';
 import { isStaleElementError, handleStaleElementRetry } from './stale-element-retry.js';
@@ -34,13 +31,13 @@ import { captureNavigationState, checkNavigationOccurred } from './navigation-de
  * @param action - The action to execute
  * @returns Action result with page brief and metadata
  */
-export async function executeAction(handle, action, captureSnapshot) {
+export async function executeAction(handle, action, ctx, captureSnapshot) {
     let success = true;
     let error;
     // Record pre-action timestamp for observation capture
     const actionStartTime = Date.now();
     // Ensure observation accumulator is injected
-    await observationAccumulator.ensureInjected(handle.page);
+    await ctx.getObservationAccumulator().ensureInjected(handle.page);
     // Execute action - if this throws, we catch and return error
     try {
         await action();
@@ -52,20 +49,24 @@ export async function executeAction(handle, action, captureSnapshot) {
     // Stabilize page after action (handles both SPA updates and full navigations)
     await stabilizeAfterAction(handle.page);
     // Capture observations from the action window
-    const observations = await observationAccumulator.getObservations(handle.page, actionStartTime);
+    const observations = await ctx
+        .getObservationAccumulator()
+        .getObservations(handle.page, actionStartTime);
     // Capture snapshot
     const capture = captureSnapshot ?? (() => captureSnapshotFallback(handle));
     const captureResult = await capture();
     const snapshot = captureResult.snapshot;
     // Filter observations to reduce noise (threshold 5 requires semantic signals)
-    const filteredObservations = observationAccumulator.filterBySignificance(observations, ATTACHMENT_SIGNIFICANCE_THRESHOLD);
+    const filteredObservations = ctx
+        .getObservationAccumulator()
+        .filterBySignificance(observations, ATTACHMENT_SIGNIFICANCE_THRESHOLD);
     // Attach observations to snapshot if any were captured
     if (filteredObservations.duringAction.length > 0 ||
         filteredObservations.sincePrevious.length > 0) {
         snapshot.observations = filteredObservations;
     }
     // Generate state response using StateManager
-    const stateManager = getStateManager(handle.page_id);
+    const stateManager = ctx.getStateManager(handle.page_id);
     const state_response = stateManager.generateResponse(snapshot);
     return {
         success,
@@ -94,14 +95,14 @@ export async function executeAction(handle, action, captureSnapshot) {
  * @param snapshotStore - Snapshot store to update with fresh snapshot
  * @returns Action result with page brief and metadata
  */
-export async function executeActionWithRetry(handle, node, action, snapshotStore, captureSnapshot) {
+export async function executeActionWithRetry(handle, node, action, ctx, snapshotStore, captureSnapshot) {
     let success = true;
     let error;
     let retried = false;
     // Record pre-action timestamp for observation capture
     const actionStartTime = Date.now();
     // Ensure observation accumulator is injected
-    await observationAccumulator.ensureInjected(handle.page);
+    await ctx.getObservationAccumulator().ensureInjected(handle.page);
     const capture = captureSnapshot ?? (() => captureSnapshotFallback(handle));
     // Try the action
     try {
@@ -143,19 +144,23 @@ export async function executeActionWithRetry(handle, node, action, snapshotStore
     // Stabilize page after action (handles both SPA updates and full navigations)
     await stabilizeAfterAction(handle.page);
     // Capture observations from the action window
-    const observations = await observationAccumulator.getObservations(handle.page, actionStartTime);
+    const observations = await ctx
+        .getObservationAccumulator()
+        .getObservations(handle.page, actionStartTime);
     // Capture final snapshot
     const captureResult = await capture();
     const snapshot = captureResult.snapshot;
     // Filter observations to reduce noise (threshold 5 requires semantic signals)
-    const filteredObservations = observationAccumulator.filterBySignificance(observations, ATTACHMENT_SIGNIFICANCE_THRESHOLD);
+    const filteredObservations = ctx
+        .getObservationAccumulator()
+        .filterBySignificance(observations, ATTACHMENT_SIGNIFICANCE_THRESHOLD);
     // Attach observations to snapshot if any were captured
     if (filteredObservations.duringAction.length > 0 ||
         filteredObservations.sincePrevious.length > 0) {
         snapshot.observations = filteredObservations;
     }
     // Generate state response using StateManager
-    const stateManager = getStateManager(handle.page_id);
+    const stateManager = ctx.getStateManager(handle.page_id);
     // Get previous snapshot BEFORE generateResponse shifts it
     const prevSnapshot = stateManager.getPreviousSnapshot();
     const state_response = stateManager.generateResponse(snapshot);
@@ -163,7 +168,7 @@ export async function executeActionWithRetry(handle, node, action, snapshotStore
     if (success) {
         const effect = computeObservedEffect(node.node_id, 'type', prevSnapshot, snapshot);
         if (effect) {
-            getDependencyTracker().recordEffect(handle.page_id, effect);
+            ctx.getDependencyTracker().recordEffect(handle.page_id, effect);
         }
     }
     // Add note about retry if it happened
@@ -199,7 +204,7 @@ export async function executeActionWithRetry(handle, node, action, snapshotStore
  * @param snapshotStore - Snapshot store to update with fresh snapshot
  * @returns ActionResultWithOutcome including ClickOutcome
  */
-export async function executeActionWithOutcome(handle, node, action, snapshotStore, captureSnapshot) {
+export async function executeActionWithOutcome(handle, node, action, ctx, snapshotStore, captureSnapshot) {
     let success = true;
     let error;
     let retried = false;
@@ -207,7 +212,7 @@ export async function executeActionWithOutcome(handle, node, action, snapshotSto
     // Record pre-action timestamp for observation capture
     const actionStartTime = Date.now();
     // Ensure observation accumulator is injected
-    await observationAccumulator.ensureInjected(handle.page);
+    await ctx.getObservationAccumulator().ensureInjected(handle.page);
     const capture = captureSnapshot ?? (() => captureSnapshotFallback(handle));
     // Capture pre-click navigation state
     const preClickState = await captureNavigationState(handle);
@@ -219,7 +224,7 @@ export async function executeActionWithOutcome(handle, node, action, snapshotSto
         const navigated = checkNavigationOccurred(preClickState, postClickState);
         // Clear dependency tracker on navigation (old dependencies no longer valid)
         if (navigated) {
-            getDependencyTracker().clearPage(handle.page_id);
+            ctx.getDependencyTracker().clearPage(handle.page_id);
         }
         outcome = { status: 'success', navigated };
     }
@@ -232,7 +237,7 @@ export async function executeActionWithOutcome(handle, node, action, snapshotSto
             if (isNavigation) {
                 // Element gone due to navigation - this is often success!
                 // Clear dependency tracker on navigation (old dependencies no longer valid)
-                getDependencyTracker().clearPage(handle.page_id);
+                ctx.getDependencyTracker().clearPage(handle.page_id);
                 outcome = { status: 'success', navigated: true };
                 // Don't retry - navigation happened
             }
@@ -255,12 +260,16 @@ export async function executeActionWithOutcome(handle, node, action, snapshotSto
     // Stabilize page after action (handles both SPA updates and full navigations)
     await stabilizeAfterAction(handle.page);
     // Capture observations from the action window
-    const observations = await observationAccumulator.getObservations(handle.page, actionStartTime);
+    const observations = await ctx
+        .getObservationAccumulator()
+        .getObservations(handle.page, actionStartTime);
     // Capture final snapshot
     const captureResult = await capture();
     const snapshot = captureResult.snapshot;
     // Filter observations to reduce noise (threshold 5 requires semantic signals)
-    const filteredObservations = observationAccumulator.filterBySignificance(observations, ATTACHMENT_SIGNIFICANCE_THRESHOLD);
+    const filteredObservations = ctx
+        .getObservationAccumulator()
+        .filterBySignificance(observations, ATTACHMENT_SIGNIFICANCE_THRESHOLD);
     // Attach observations to snapshot if any were captured
     if (filteredObservations.duringAction.length > 0 ||
         filteredObservations.sincePrevious.length > 0) {
@@ -273,14 +282,14 @@ export async function executeActionWithOutcome(handle, node, action, snapshotSto
         const postStabilizeUrl = handle.page.url();
         if (postStabilizeUrl !== preClickState.url) {
             outcome = { status: 'success', navigated: true };
-            getDependencyTracker().clearPage(handle.page_id);
+            ctx.getDependencyTracker().clearPage(handle.page_id);
         }
     }
     // Determine if click caused a navigation (used for trimming and dependency tracking)
     const didNavigate = outcome.status === 'success' && outcome.navigated;
     // Generate state response using StateManager
     // Trim regions when navigation occurred (same rationale as navigate() tool)
-    const stateManager = getStateManager(handle.page_id);
+    const stateManager = ctx.getStateManager(handle.page_id);
     // Get previous snapshot BEFORE generateResponse shifts it
     const prevSnapshot = stateManager.getPreviousSnapshot();
     const state_response = stateManager.generateResponse(snapshot, didNavigate ? { trimRegions: true } : undefined);
@@ -288,7 +297,7 @@ export async function executeActionWithOutcome(handle, node, action, snapshotSto
     if (success && !didNavigate) {
         const effect = computeObservedEffect(node.node_id, 'click', prevSnapshot, snapshot);
         if (effect) {
-            getDependencyTracker().recordEffect(handle.page_id, effect);
+            ctx.getDependencyTracker().recordEffect(handle.page_id, effect);
         }
     }
     // Add note about retry if it happened and we recovered

package/dist/src/tools/execute-action.js.map

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

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

@@ -5,13 +5,8 @@
  * Provides semantic understanding of form-like interactions.
  */
 import { z } from 'zod';
+import type { ToolContext } from './tool-context.types.js';
 import { type FormRegion, type FormField, type FormAction, type FieldDependency } from '../form/index.js';
-import type { SessionManager } from '../browser/session-manager.js';
-/**
- * Initialize form tools with a session manager instance.
- * @deprecated Use initializeToolContext() instead. Kept for backward compatibility.
- */
-export declare function initializeFormTools(_manager: SessionManager): void;
 /**
  * get_form input schema
  */
@@ -95,13 +90,13 @@ export declare const _testExports: {
  * dependencies, and state. Reads actual runtime values via CDP
  * to provide accurate filled/has_value status.
  */
-export declare function getFormUnderstanding(rawInput: unknown): Promise<string>;
+export declare function getFormUnderstanding(rawInput: unknown, ctx: ToolContext): Promise<string>;
 /**
  * Get context for a specific field.
  *
  * Returns detailed information about a field including purpose inference,
  * constraints, dependencies, and suggested next action.
  */
-export declare function getFieldContext(rawInput: unknown): string;
+export declare function getFieldContext(rawInput: unknown, ctx: ToolContext): string;
 export {};
 //# sourceMappingURL=form-tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"form-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/form-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,eAAe,EAErB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAElE;AAMD;;GAEG;AACH,eAAO,MAAM,+BAA+B;IAC1C,uDAAuD;;IAEvD,8CAA8C;;IAE9C,qEAAqE;;;;;;;;;;EAErE,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,uDAAuD;;IAEvD,8BAA8B;;;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;;;;GAKG;AACH,iBAAS,yBAAyB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EAAE,EACnB,aAAa,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAqDR;AAED;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkC9F;AAED;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAalE;AAED;;GAEG;AACH,iBAAS,iBAAiB,CACxB,IAAI,EAAE,UAAU,GACf;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAsC5D;AAED;;;;;GAKG;AACH,iBAAS,oBAAoB,CAC3B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,eAAe,EAAE,GAC9B,MAAM,CAgGR;AAMD,0CAA0C;AAC1C,eAAO,MAAM,YAAY;;;;;;CAMxB,CAAC;AAMF;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA4F7E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAsCzD"}
+{"version":3,"file":"form-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/form-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,eAAe,EAErB,MAAM,kBAAkB,CAAC;AA2C1B;;GAEG;AACH,eAAO,MAAM,+BAA+B;IAC1C,uDAAuD;;IAEvD,8CAA8C;;IAE9C,qEAAqE;;;;;;;;;;EAErE,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC,uDAAuD;;IAEvD,8BAA8B;;;;;;;;EAE9B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E;;;;;GAKG;AACH,iBAAS,yBAAyB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EAAE,EACnB,aAAa,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAqDR;AAED;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkC9F;AAED;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAalE;AAED;;GAEG;AACH,iBAAS,iBAAiB,CACxB,IAAI,EAAE,UAAU,GACf;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAsC5D;AAED;;;;;GAKG;AACH,iBAAS,oBAAoB,CAC3B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,eAAe,EAAE,GAC9B,MAAM,CAgGR;AAMD,0CAA0C;AAC1C,eAAO,MAAM,YAAY;;;;;;CAMxB,CAAC;AAMF;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA4F/F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAwC3E"}

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

@@ -5,15 +5,35 @@
  * Provides semantic understanding of form-like interactions.
  */
 import { z } from 'zod';
-import { getSessionManager, getSnapshotStore, resolveExistingPage } from './tool-context.js';
-import { detectForms, getDependencyTracker, computeFormState, readRuntimeValues, } from '../form/index.js';
+import { detectForms, computeFormState, readRuntimeValues, } from '../form/index.js';
 import { escapeXml } from '../lib/text-utils.js';
 /**
- * Initialize form tools with a session manager instance.
- * @deprecated Use initializeToolContext() instead. Kept for backward compatibility.
+ * Resolve internal node_ids to stable semantic eids on all form fields and actions.
+ * Option eids (radio buttons) require a node_id→backend_node_id map from the snapshot.
  */
-export function initializeFormTools(_manager) {
-    // No-op: tool context is now initialized centrally via initializeToolContext()
+function resolveFormEids(forms, registry, nodes) {
+    const resolve = (backendNodeId) => registry.getEidByBackendNodeId(backendNodeId);
+    const nodeIdToBackendId = nodes
+        ? new Map(nodes.map((n) => [n.node_id, n.backend_node_id]))
+        : undefined;
+    for (const form of forms) {
+        for (const field of form.fields) {
+            field.eid = resolve(field.backend_node_id) ?? field.eid;
+            if (nodeIdToBackendId && field.constraints.options) {
+                for (const opt of field.constraints.options) {
+                    if (opt.eid) {
+                        const backendId = nodeIdToBackendId.get(opt.eid);
+                        if (backendId !== undefined) {
+                            opt.eid = resolve(backendId) ?? opt.eid;
+                        }
+                    }
+                }
+            }
+        }
+        for (const action of form.actions) {
+            action.eid = resolve(action.backend_node_id) ?? action.eid;
+        }
+    }
 }
 // ============================================================================
 // Input/Output Schemas
@@ -282,20 +302,19 @@ export const _testExports = {
  * dependencies, and state. Reads actual runtime values via CDP
  * to provide accurate filled/has_value status.
  */
-export async function getFormUnderstanding(rawInput) {
+export async function getFormUnderstanding(rawInput, ctx) {
     const input = GetFormUnderstandingInputSchema.parse(rawInput);
-    const session = getSessionManager();
-    const snapshotStore = getSnapshotStore();
+    const snapshotStore = ctx.getSnapshotStore();
     // Resolve page with CDP client for runtime value reading
-    const handle = resolveExistingPage(session, input.page_id);
+    const handle = ctx.resolveExistingPage(input.page_id);
     const pageId = handle.page_id;
     // Get snapshot for the page
     const snapshot = snapshotStore.getByPageId(pageId);
     if (!snapshot) {
         return '<error>No snapshot available. Use snapshot first.</error>';
     }
-    // Detect forms
     const allForms = detectForms(snapshot);
+    resolveFormEids(allForms, ctx.getStateManager(pageId).getElementRegistry(), snapshot.nodes);
     // Filter by form_id if specified
     const forms = input.form_id ? allForms.filter((f) => f.form_id === input.form_id) : allForms;
     if (forms.length === 0 && input.form_id) {
@@ -310,7 +329,8 @@ export async function getFormUnderstanding(rawInput) {
             backend_node_id: f.backend_node_id,
             frame_id: f.frame_id,
             semantic_type: f.purpose.semantic_type,
-            input_type: snapshot.nodes.find((n) => n.node_id === f.eid)?.attributes?.input_type,
+            input_type: snapshot.nodes.find((n) => n.backend_node_id === f.backend_node_id)?.attributes
+                ?.input_type,
             label: f.label,
         }));
         const runtimeResult = await readRuntimeValues(handle.cdp, fieldRequests, {
@@ -346,7 +366,7 @@ export async function getFormUnderstanding(rawInput) {
         }
     }
     // Enrich fields with observed dependencies
-    const tracker = getDependencyTracker();
+    const tracker = ctx.getDependencyTracker();
     for (const form of forms) {
         for (const field of form.fields) {
             const deps = tracker.getDependenciesFor(pageId, field.eid);
@@ -367,12 +387,11 @@ export async function getFormUnderstanding(rawInput) {
  * Returns detailed information about a field including purpose inference,
  * constraints, dependencies, and suggested next action.
  */
-export function getFieldContext(rawInput) {
+export function getFieldContext(rawInput, ctx) {
     const input = GetFieldContextInputSchema.parse(rawInput);
-    const session = getSessionManager();
-    const snapshotStore = getSnapshotStore();
+    const snapshotStore = ctx.getSnapshotStore();
     // Resolve page
-    const handle = resolveExistingPage(session, input.page_id);
+    const handle = ctx.resolveExistingPage(input.page_id);
     const pageId = handle.page_id;
     // Get snapshot for the page
     const snapshot = snapshotStore.getByPageId(pageId);
@@ -381,6 +400,7 @@ export function getFieldContext(rawInput) {
     }
     // Find the field's form
     const allForms = detectForms(snapshot);
+    resolveFormEids(allForms, ctx.getStateManager(pageId).getElementRegistry());
     let targetField;
     let targetForm;
     for (const form of allForms) {
@@ -395,7 +415,7 @@ export function getFieldContext(rawInput) {
         return `<error>Field not found in any form: ${escapeXml(input.eid)}</error>`;
     }
     // Get dependencies
-    const tracker = getDependencyTracker();
+    const tracker = ctx.getDependencyTracker();
     const dependencies = tracker.getDependenciesFor(pageId, input.eid);
     return buildFieldContextXml(targetField, targetForm, dependencies);
 }