agent-web-interface 4.4.0 → 4.5.1

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

@@ -6,10 +6,7 @@
 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.
  *
@@ -21,7 +18,7 @@ const snapshotStore = getSnapshotStore();
  * @param rawInput - Click options (will be validated)
  * @returns Click result with navigation-aware outcome
  */
-export async function click(rawInput) {
+export async function click(rawInput, ctx) {
     const input = ClickInputSchema.parse(rawInput);
     const hasEid = input.eid !== undefined;
     const hasCoords = input.x !== undefined && input.y !== undefined;
@@ -31,12 +28,12 @@ export async function click(rawInput) {
     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);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id, ctx);
     let result;
     if (hasEid) {
         // Mode 1 & 2: element-based click (center or offset)
-        const snap = requireSnapshot(pageId);
-        const node = resolveElementByEid(pageId, input.eid, snap);
+        const snap = ctx.requireSnapshot(pageId);
+        const node = ctx.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);
@@ -44,15 +41,15 @@ export async function click(rawInput) {
             else {
                 await clickByBackendNodeId(handleRef.current.cdp, backendNodeId, input.modifiers);
             }
-        }, snapshotStore, captureSnapshot);
+        }, ctx, ctx.getSnapshotStore(), 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);
+        }, ctx, captureSnapshot);
     }
-    snapshotStore.store(pageId, result.snapshot);
+    ctx.getSnapshotStore().store(pageId, result.snapshot);
     return result.state_response;
 }
 /**
@@ -61,19 +58,19 @@ export async function click(rawInput) {
  * @param rawInput - Type options (will be validated)
  * @returns Type result with delta
  */
-export async function type(rawInput) {
+export async function type(rawInput, ctx) {
     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);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id, ctx);
+    const snap = ctx.requireSnapshot(pageId);
+    const node = ctx.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);
+    }, ctx, ctx.getSnapshotStore(), captureSnapshot);
     // Store snapshot for future queries
-    snapshotStore.store(pageId, result.snapshot);
+    ctx.getSnapshotStore().store(pageId, result.snapshot);
     // Return XML state response directly
     return result.state_response;
 }
@@ -83,15 +80,15 @@ export async function type(rawInput) {
  * @param rawInput - Press options (will be validated)
  * @returns Press result with delta
  */
-export async function press(rawInput) {
+export async function press(rawInput, ctx) {
     const input = PressInputSchema.parse(rawInput);
-    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id, ctx);
     // Execute action with new simplified wrapper
     const result = await executeAction(handleRef.current, async () => {
         await pressKey(handleRef.current.cdp, input.key, input.modifiers);
-    }, captureSnapshot);
+    }, ctx, captureSnapshot);
     // Store snapshot for future queries
-    snapshotStore.store(pageId, result.snapshot);
+    ctx.getSnapshotStore().store(pageId, result.snapshot);
     // Return XML state response directly
     return result.state_response;
 }
@@ -101,17 +98,17 @@ export async function press(rawInput) {
  * @param rawInput - Select options (will be validated)
  * @returns Select result with delta
  */
-export async function select(rawInput) {
+export async function select(rawInput, ctx) {
     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);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id, ctx);
+    const snap = ctx.requireSnapshot(pageId);
+    const node = ctx.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);
+    }, ctx, ctx.getSnapshotStore(), captureSnapshot);
     // Store snapshot for future queries
-    snapshotStore.store(pageId, result.snapshot);
+    ctx.getSnapshotStore().store(pageId, result.snapshot);
     // Return XML state response directly
     return result.state_response;
 }
@@ -121,17 +118,17 @@ export async function select(rawInput) {
  * @param rawInput - Hover options (will be validated)
  * @returns Hover result with delta
  */
-export async function hover(rawInput) {
+export async function hover(rawInput, ctx) {
     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);
+    const { handleRef, pageId, captureSnapshot } = await prepareActionContext(input.page_id, ctx);
+    const snap = ctx.requireSnapshot(pageId);
+    const node = ctx.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);
+    }, ctx, ctx.getSnapshotStore(), captureSnapshot);
     // Store snapshot for future queries
-    snapshotStore.store(pageId, result.snapshot);
+    ctx.getSnapshotStore().store(pageId, result.snapshot);
     // Return XML state response directly
     return result.state_response;
 }

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

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

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

@@ -3,6 +3,7 @@
  *
  * MCP tool handlers for browser navigation and session management.
  */
+import type { ToolContext } from './tool-context.types.js';
 /**
  * List all open browser pages with their metadata.
  *
@@ -11,47 +12,40 @@
  *
  * @returns XML result with page list
  */
-export declare function listPages(): Promise<import('./tool-schemas.js').ListPagesOutput>;
+export declare function listPages(rawInput: unknown, ctx: ToolContext): 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>;
+export declare function closePage(rawInput: unknown, ctx: ToolContext): Promise<import('./tool-schemas.js').ClosePageOutput>;
 /**
  * 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>;
+export declare function navigate(rawInput: unknown, ctx: ToolContext): 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>;
+export declare function goBack(rawInput: unknown, ctx: ToolContext): 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>;
+export declare function goForward(rawInput: unknown, ctx: ToolContext): 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>;
+export declare function reload(rawInput: unknown, ctx: ToolContext): Promise<import('./tool-schemas.js').ReloadOutput>;
 //# sourceMappingURL=navigation-tools.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"navigation-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAuE3D;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CA2BtD;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAStD;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,mBAAmB,EAAE,cAAc,CAAC,CA+CrD;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAGnD;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAGtD;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAGnD"}

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

@@ -3,17 +3,14 @@
  *
  * 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 { ClosePageInputSchema, NavigateInputSchema, GoBackInputSchema, GoForwardInputSchema, ReloadInputSchema, } from './tool-schemas.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();
+import { buildClosePageResponse, buildListPagesResponse } from './response-builder.js';
+function browserConfigDiffers(current, requested) {
+    return ((requested.headless !== undefined && requested.headless !== current.headless) ||
+        (requested.isolated !== undefined && requested.isolated !== current.isolated) ||
+        (requested.autoConnect !== undefined && requested.autoConnect !== current.autoConnect));
+}
 /**
  * Execute a navigation action with snapshot capture.
  * Consolidates goBack, goForward, and reload handlers.
@@ -25,13 +22,12 @@ const snapshotStore = getSnapshotStore();
  * @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);
+async function executeNavigationAction(pageId, ctx, action) {
+    let handle = await ctx.resolvePageOrCreate(pageId);
     const page_id = handle.page_id;
-    session.touchPage(page_id);
+    ctx.touchPage(page_id);
     // Clear dependency tracker before navigation (old dependencies no longer valid)
-    getDependencyTracker().clearPage(page_id);
+    ctx.getDependencyTracker().clearPage(page_id);
     // Execute navigation
     switch (action) {
         case 'back':
@@ -47,14 +43,14 @@ async function executeNavigationAction(pageId, action) {
     // 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);
+    await ctx.getObservationAccumulator().inject(handle.page);
     // Auto-capture snapshot after navigation
-    const captureResult = await captureSnapshotWithRecovery(session, handle, page_id);
+    const captureResult = await ctx.captureSnapshotWithRecovery(handle, page_id);
     handle = captureResult.handle;
     const snapshot = captureResult.snapshot;
-    snapshotStore.store(page_id, snapshot);
+    ctx.getSnapshotStore().store(page_id, snapshot);
     // Return XML state response (trimmed for navigation snapshots)
-    const stateManager = getStateManager(page_id);
+    const stateManager = ctx.getStateManager(page_id);
     return stateManager.generateResponse(snapshot, { trimRegions: true });
 }
 /**
@@ -65,10 +61,9 @@ async function executeNavigationAction(pageId, action) {
  *
  * @returns XML result with page list
  */
-export async function listPages() {
-    const session = getSessionManager();
+export async function listPages(rawInput, ctx) {
     // Sync to pick up any unregistered browser tabs
-    const pages = await session.syncPages();
+    const pages = await ctx.syncPages();
     const pageInfos = await Promise.all(pages.map(async (h) => {
         const liveUrl = h.page.url?.() ?? h.url ?? '';
         let liveTitle = h.title ?? '';
@@ -96,53 +91,56 @@ export async function listPages() {
  * @param rawInput - Close options (will be validated)
  * @returns Close result
  */
-export async function closePage(rawInput) {
+export async function closePage(rawInput, ctx) {
     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
+    await ctx.closePage(input.page_id);
+    ctx.getSnapshotStore().removeByPageId(input.page_id);
+    ctx.removeStateManager(input.page_id); // Clean up state manager
+    ctx.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) {
+export async function navigate(rawInput, ctx) {
     const input = NavigateInputSchema.parse(rawInput);
-    const session = getSessionManager();
-    let handle = await session.resolvePageOrCreate(input.page_id);
+    const requestedConfig = {
+        headless: input.headless,
+        isolated: input.isolated,
+        autoConnect: input.auto_connect,
+    };
+    // Apply browser preferences if provided
+    if (input.headless !== undefined ||
+        input.isolated !== undefined ||
+        input.auto_connect !== undefined) {
+        // Browser mode is session-scoped. If the caller requests a different mode
+        // mid-session, reset first so the next ensureBrowser() actually honors it.
+        if (!ctx.canReconfigure() && browserConfigDiffers(ctx.getBrowserConfig(), requestedConfig)) {
+            await ctx.resetBrowser();
+        }
+        if (ctx.canReconfigure()) {
+            ctx.setBrowserConfig(requestedConfig);
+        }
+    }
+    // navigate is excluded from the pre-handler ensureBrowser() call so that
+    // browser config (auto_connect, headless, isolated) can be set first.
+    await ctx.ensureBrowser();
+    let handle = await ctx.resolvePageOrCreate(input.page_id);
     const page_id = handle.page_id;
-    session.touchPage(page_id);
+    ctx.touchPage(page_id);
     // Clear dependency tracker before navigation (old dependencies no longer valid)
-    getDependencyTracker().clearPage(page_id);
-    await session.navigateTo(page_id, input.url);
+    ctx.getDependencyTracker().clearPage(page_id);
+    await ctx.navigateTo(page_id, input.url);
     // Auto-capture snapshot after navigation
-    const captureResult = await captureSnapshotWithRecovery(session, handle, page_id);
+    const captureResult = await ctx.captureSnapshotWithRecovery(handle, page_id);
     handle = captureResult.handle;
     const snapshot = captureResult.snapshot;
-    snapshotStore.store(page_id, snapshot);
+    ctx.getSnapshotStore().store(page_id, snapshot);
     // Return XML state response directly (trimmed for navigation snapshots)
-    const stateManager = getStateManager(page_id);
+    const stateManager = ctx.getStateManager(page_id);
     return stateManager.generateResponse(snapshot, { trimRegions: true });
 }
 /**
@@ -151,9 +149,9 @@ export async function navigate(rawInput) {
  * @param rawInput - Navigation options (will be validated)
  * @returns Navigation result with snapshot data
  */
-export async function goBack(rawInput) {
+export async function goBack(rawInput, ctx) {
     const input = GoBackInputSchema.parse(rawInput);
-    return executeNavigationAction(input.page_id, 'back');
+    return executeNavigationAction(input.page_id, ctx, 'back');
 }
 /**
  * Go forward in browser history.
@@ -161,9 +159,9 @@ export async function goBack(rawInput) {
  * @param rawInput - Navigation options (will be validated)
  * @returns Navigation result with snapshot data
  */
-export async function goForward(rawInput) {
+export async function goForward(rawInput, ctx) {
     const input = GoForwardInputSchema.parse(rawInput);
-    return executeNavigationAction(input.page_id, 'forward');
+    return executeNavigationAction(input.page_id, ctx, 'forward');
 }
 /**
  * Reload the current page.
@@ -171,8 +169,8 @@ export async function goForward(rawInput) {
  * @param rawInput - Navigation options (will be validated)
  * @returns Navigation result with snapshot data
  */
-export async function reload(rawInput) {
+export async function reload(rawInput, ctx) {
     const input = ReloadInputSchema.parse(rawInput);
-    return executeNavigationAction(input.page_id, 'reload');
+    return executeNavigationAction(input.page_id, ctx, 'reload');
 }
 //# sourceMappingURL=navigation-tools.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"navigation-tools.js","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,4CAA4C;AAC5C,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;AAOzC;;;;;;;;;;GAUG;AACH,KAAK,UAAU,uBAAuB,CACpC,MAA0B,EAC1B,MAAwB;IAExB,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,IAAI,MAAM,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE3B,gFAAgF;IAChF,oBAAoB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE1C,qBAAqB;IACrB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9B,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM;IACV,CAAC;IAED,kDAAkD;IAClD,MAAM,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE5C,4EAA4E;IAC5E,MAAM,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEjD,yCAAyC;IACzC,MAAM,aAAa,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClF,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;IACxC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEvC,+DAA+D;IAC/D,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,YAAY,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,gDAAgD;IAChD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;QAC9C,IAAI,SAAS,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAE9B,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;QACH,CAAC;QAED,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC;QAChB,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC;QAEpB,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IACF,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAiB;IAEjB,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB;IAC5D,oBAAoB,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;IAEzE,OAAO,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAiB;IAEjB,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IACzB,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,qBAAqB,EAAE,CAAC,CAAC,8BAA8B;IACvD,oBAAoB,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,4BAA4B;IAC/D,MAAM,gBAAgB,EAAE,CAAC,CAAC,iCAAiC;IAE3D,OAAO,yBAAyB,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAiB;IAEjB,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,IAAI,MAAM,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE3B,gFAAgF;IAChF,oBAAoB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAE7C,yCAAyC;IACzC,MAAM,aAAa,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClF,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;IACxC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEvC,wEAAwE;IACxE,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,YAAY,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAiB;IAC5C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAiB;IAEjB,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAiB;IAC5C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"navigation-tools.js","sourceRoot":"","sources":["../../../src/tools/navigation-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAQvF,SAAS,oBAAoB,CAC3B,OAA4E,EAC5E,SAA8E;IAE9E,OAAO,CACL,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC;QAC7E,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC;QAC7E,CAAC,SAAS,CAAC,WAAW,KAAK,SAAS,IAAI,SAAS,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CACvF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,uBAAuB,CACpC,MAA0B,EAC1B,GAAgB,EAChB,MAAwB;IAExB,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAEvB,gFAAgF;IAChF,GAAG,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE9C,qBAAqB;IACrB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9B,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM;IACV,CAAC;IAED,kDAAkD;IAClD,MAAM,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE5C,4EAA4E;IAC5E,MAAM,GAAG,CAAC,yBAAyB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE1D,yCAAyC;IACzC,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;IACxC,GAAG,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEhD,+DAA+D;IAC/D,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAiB,EACjB,GAAgB;IAEhB,gDAAgD;IAChD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;QAC9C,IAAI,SAAS,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAE9B,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,8DAA8D;YAChE,CAAC;QACH,CAAC;QAED,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC;QAChB,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC;QAEpB,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IACF,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAiB,EACjB,GAAgB;IAEhB,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEnD,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,GAAG,CAAC,gBAAgB,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrD,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB;IAChE,GAAG,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB;IAE7E,OAAO,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAiB,EACjB,GAAgB;IAEhB,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,YAAY;KAChC,CAAC;IAEF,wCAAwC;IACxC,IACE,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,KAAK,CAAC,YAAY,KAAK,SAAS,EAChC,CAAC;QACD,0EAA0E;QAC1E,2EAA2E;QAC3E,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,oBAAoB,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC;YAC3F,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC;YACzB,GAAG,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;IAE1B,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAEvB,gFAAgF;IAChF,GAAG,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAEzC,yCAAyC;IACzC,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC;IACxC,GAAG,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEhD,wEAAwE;IACxE,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,QAAiB,EACjB,GAAgB;IAEhB,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAiB,EACjB,GAAgB;IAEhB,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,QAAiB,EACjB,GAAgB;IAEhB,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,uBAAuB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Network Tools
+ *
+ * MCP tool handlers for inspecting network activity on a page.
+ * Provides list and search over recorded HTTP requests/responses.
+ */
+import type { ToolContext } from './tool-context.types.js';
+export declare function listNetworkCalls(rawInput: unknown, ctx: ToolContext): string;
+export declare function searchNetworkCalls(rawInput: unknown, ctx: ToolContext): string;
+//# sourceMappingURL=network-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/network-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA8F3D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAoB5E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAmB9E"}

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

@@ -0,0 +1,117 @@
+/**
+ * Network Tools
+ *
+ * MCP tool handlers for inspecting network activity on a page.
+ * Provides list and search over recorded HTTP requests/responses.
+ */
+import { getOrCreateRecorder, } from '../browser/page-network-recorder.js';
+import { escapeXml } from '../lib/text-utils.js';
+import { ListNetworkCallsInputSchema, SearchNetworkCallsInputSchema, } from './tool-schemas.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function formatDuration(ms) {
+    if (ms === null)
+        return 'pending';
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/** Build a NetworkFilter from the common filter fields shared by both tools. */
+function buildFilter(input) {
+    const filter = {};
+    if (input.resource_type)
+        filter.resource_type = input.resource_type;
+    if (input.method)
+        filter.method = input.method;
+    if (input.status_min != null)
+        filter.status_min = input.status_min;
+    if (input.status_max != null)
+        filter.status_max = input.status_max;
+    if (input.failed_only)
+        filter.failed_only = true;
+    if (input.url_pattern)
+        filter.url_pattern = input.url_pattern;
+    return filter;
+}
+function entryToXml(entry, includeHeaders, includeBody) {
+    const attrs = [
+        `id="${entry.id}"`,
+        `method="${escapeXml(entry.method)}"`,
+        `url="${escapeXml(entry.url)}"`,
+        `type="${escapeXml(entry.resource_type)}"`,
+    ];
+    if (entry.status !== null) {
+        attrs.push(`status="${entry.status}"`);
+    }
+    attrs.push(`duration="${formatDuration(entry.duration_ms)}"`);
+    if (entry.failed) {
+        attrs.push('failed="true"');
+        if (entry.failure_text) {
+            attrs.push(`error="${escapeXml(entry.failure_text)}"`);
+        }
+    }
+    if (entry.mime_type) {
+        attrs.push(`mime="${escapeXml(entry.mime_type)}"`);
+    }
+    const needsChildren = includeHeaders || (includeBody && entry.post_data);
+    if (!needsChildren) {
+        return `  <call ${attrs.join(' ')}/>`;
+    }
+    const lines = [];
+    lines.push(`  <call ${attrs.join(' ')}>`);
+    if (includeHeaders) {
+        if (Object.keys(entry.request_headers).length > 0) {
+            lines.push('    <request_headers>');
+            for (const [k, v] of Object.entries(entry.request_headers)) {
+                lines.push(`      <h name="${escapeXml(k)}">${escapeXml(v)}</h>`);
+            }
+            lines.push('    </request_headers>');
+        }
+        if (entry.response_headers && Object.keys(entry.response_headers).length > 0) {
+            lines.push('    <response_headers>');
+            for (const [k, v] of Object.entries(entry.response_headers)) {
+                lines.push(`      <h name="${escapeXml(k)}">${escapeXml(v)}</h>`);
+            }
+            lines.push('    </response_headers>');
+        }
+    }
+    if (includeBody && entry.post_data) {
+        lines.push(`    <body>${escapeXml(entry.post_data)}</body>`);
+    }
+    lines.push('  </call>');
+    return lines.join('\n');
+}
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+export function listNetworkCalls(rawInput, ctx) {
+    const input = ListNetworkCallsInputSchema.parse(rawInput);
+    const handle = ctx.resolveExistingPage(input.page_id);
+    const recorder = getOrCreateRecorder(handle.page);
+    const filter = buildFilter(input);
+    const result = recorder.getEntries(filter, input.offset, input.limit);
+    const stats = recorder.getStats();
+    const lines = [];
+    lines.push(`<network_calls page_id="${escapeXml(handle.page_id)}" total="${result.total}" shown="${result.entries.length}" offset="${input.offset}" recorded="${stats.total}">`);
+    for (const entry of result.entries) {
+        lines.push(entryToXml(entry, false, false));
+    }
+    lines.push('</network_calls>');
+    return lines.join('\n');
+}
+export function searchNetworkCalls(rawInput, ctx) {
+    const input = SearchNetworkCallsInputSchema.parse(rawInput);
+    const handle = ctx.resolveExistingPage(input.page_id);
+    const recorder = getOrCreateRecorder(handle.page);
+    const filter = buildFilter(input);
+    const result = recorder.search(input.url_pattern, input.url_regex, filter, input.limit);
+    const lines = [];
+    lines.push(`<network_calls page_id="${escapeXml(handle.page_id)}" total="${result.total}" shown="${result.entries.length}" pattern="${escapeXml(input.url_pattern)}">`);
+    for (const entry of result.entries) {
+        lines.push(entryToXml(entry, input.include_headers, input.include_body));
+    }
+    lines.push('</network_calls>');
+    return lines.join('\n');
+}
+//# sourceMappingURL=network-tools.js.map

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

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