@metamask/client-mcp-core 0.1.0

package/dist/mcp-server/tools/launch.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleLaunch = handleLaunch;
+const session_manager_js_1 = require("../session-manager.cjs");
+const types_1 = require("../types/index.cjs");
+const utils_1 = require("../utils/index.cjs");
+const PROD_MODE_PREREQUISITES = [
+    {
+        step: 'Unlock Wallet',
+        description: 'The wallet must be unlocked before interacting with it. Use the extension UI to enter your password.',
+    },
+    {
+        step: 'Configure Network',
+        description: 'Ensure the correct network is selected (e.g., Ethereum Mainnet, Sepolia, or custom network).',
+    },
+    {
+        step: 'Set Up Accounts',
+        description: 'Import or create accounts as needed. Ensure the active account has sufficient funds for transactions.',
+    },
+];
+/**
+ * Handles the launch tool request to start a browser session.
+ *
+ * @param input - The launch configuration parameters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session info or error.
+ */
+async function handleLaunch(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    try {
+        if (sessionManager.hasActiveSession()) {
+            return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_SESSION_ALREADY_RUNNING, 'A session is already running. Call mm_cleanup first.', { currentSessionId: sessionManager.getSessionId() }, sessionManager.getSessionId(), startTime);
+        }
+        const result = await sessionManager.launch(input);
+        const isProdMode = sessionManager.getEnvironmentMode() === 'prod';
+        const launchResult = {
+            ...result,
+            ...(isProdMode && { prerequisites: PROD_MODE_PREREQUISITES }),
+        };
+        return (0, utils_1.createSuccessResponse)(launchResult, result.sessionId, startTime);
+    }
+    catch (error) {
+        const message = (0, utils_1.extractErrorMessage)(error);
+        if (message.includes('EADDRINUSE') || message.includes('port')) {
+            return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_PORT_IN_USE, `Port conflict: ${message}`, { input }, undefined, startTime);
+        }
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_LAUNCH_FAILED, `Launch failed: ${message}`, { input }, undefined, startTime);
+    }
+}
+//# sourceMappingURL=launch.cjs.map

package/dist/mcp-server/tools/launch.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/launch.ts"],"names":[],"mappings":";;AAwCA,oCAoDC;AA5FD,+DAA0D;AAQ1D,8CAAsC;AACtC,8CAIkB;AAElB,MAAM,uBAAuB,GAAyB;IACpD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,sGAAsG;KACzG;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,8FAA8F;KACjG;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,uGAAuG;KAC1G;CACF,CAAC;AAEF;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAChC,KAAkB,EAClB,QAAyB;IAEzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,IAAA,sCAAiB,GAAE,CAAC;IAE3C,IAAI,CAAC;QACH,IAAI,cAAc,CAAC,gBAAgB,EAAE,EAAE,CAAC;YACtC,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,0BAA0B,EACrC,sDAAsD,EACtD,EAAE,gBAAgB,EAAE,cAAc,CAAC,YAAY,EAAE,EAAE,EACnD,cAAc,CAAC,YAAY,EAAE,EAC7B,SAAS,CACV,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAElD,MAAM,UAAU,GAAG,cAAc,CAAC,kBAAkB,EAAE,KAAK,MAAM,CAAC;QAClE,MAAM,YAAY,GAAiB;YACjC,GAAG,MAAM;YACT,GAAG,CAAC,UAAU,IAAI,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAC;SAC9D,CAAC;QAEF,OAAO,IAAA,6BAAqB,EAC1B,YAAY,EACZ,MAAM,CAAC,SAAS,EAChB,SAAS,CACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,IAAA,2BAAmB,EAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,cAAc,EACzB,kBAAkB,OAAO,EAAE,EAC3B,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;QACJ,CAAC;QAED,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,gBAAgB,EAC3B,kBAAkB,OAAO,EAAE,EAC3B,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { getSessionManager } from '../session-manager.js';\nimport type {\n  LaunchInput,\n  LaunchResult,\n  LaunchPrerequisite,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n} from '../utils';\n\nconst PROD_MODE_PREREQUISITES: LaunchPrerequisite[] = [\n  {\n    step: 'Unlock Wallet',\n    description:\n      'The wallet must be unlocked before interacting with it. Use the extension UI to enter your password.',\n  },\n  {\n    step: 'Configure Network',\n    description:\n      'Ensure the correct network is selected (e.g., Ethereum Mainnet, Sepolia, or custom network).',\n  },\n  {\n    step: 'Set Up Accounts',\n    description:\n      'Import or create accounts as needed. Ensure the active account has sufficient funds for transactions.',\n  },\n];\n\n/**\n * Handles the launch tool request to start a browser session.\n *\n * @param input - The launch configuration parameters.\n * @param _options - Handler options (unused).\n * @returns Response with session info or error.\n */\nexport async function handleLaunch(\n  input: LaunchInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<LaunchResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n\n  try {\n    if (sessionManager.hasActiveSession()) {\n      return createErrorResponse(\n        ErrorCodes.MM_SESSION_ALREADY_RUNNING,\n        'A session is already running. Call mm_cleanup first.',\n        { currentSessionId: sessionManager.getSessionId() },\n        sessionManager.getSessionId(),\n        startTime,\n      );\n    }\n\n    const result = await sessionManager.launch(input);\n\n    const isProdMode = sessionManager.getEnvironmentMode() === 'prod';\n    const launchResult: LaunchResult = {\n      ...result,\n      ...(isProdMode && { prerequisites: PROD_MODE_PREREQUISITES }),\n    };\n\n    return createSuccessResponse<LaunchResult>(\n      launchResult,\n      result.sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n\n    if (message.includes('EADDRINUSE') || message.includes('port')) {\n      return createErrorResponse(\n        ErrorCodes.MM_PORT_IN_USE,\n        `Port conflict: ${message}`,\n        { input },\n        undefined,\n        startTime,\n      );\n    }\n\n    return createErrorResponse(\n      ErrorCodes.MM_LAUNCH_FAILED,\n      `Launch failed: ${message}`,\n      { input },\n      undefined,\n      startTime,\n    );\n  }\n}\n"]}

package/dist/mcp-server/tools/launch.d.cts

@@ -0,0 +1,10 @@
+import type { LaunchInput, LaunchResult, McpResponse, HandlerOptions } from "../types/index.cjs";
+/**
+ * Handles the launch tool request to start a browser session.
+ *
+ * @param input - The launch configuration parameters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session info or error.
+ */
+export declare function handleLaunch(input: LaunchInput, _options?: HandlerOptions): Promise<McpResponse<LaunchResult>>;
+//# sourceMappingURL=launch.d.cts.map

package/dist/mcp-server/tools/launch.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/launch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,WAAW,EACX,cAAc,EACf,2BAAiB;AA0BlB;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAiDpC"}

package/dist/mcp-server/tools/launch.d.mts

@@ -0,0 +1,10 @@
+import type { LaunchInput, LaunchResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+/**
+ * Handles the launch tool request to start a browser session.
+ *
+ * @param input - The launch configuration parameters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session info or error.
+ */
+export declare function handleLaunch(input: LaunchInput, _options?: HandlerOptions): Promise<McpResponse<LaunchResult>>;
+//# sourceMappingURL=launch.d.mts.map

package/dist/mcp-server/tools/launch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/launch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAEZ,WAAW,EACX,cAAc,EACf,2BAAiB;AA0BlB;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAiDpC"}

package/dist/mcp-server/tools/launch.mjs

@@ -0,0 +1,48 @@
+import { getSessionManager } from "../session-manager.mjs";
+import { ErrorCodes } from "../types/index.mjs";
+import { createSuccessResponse, createErrorResponse, extractErrorMessage } from "../utils/index.mjs";
+const PROD_MODE_PREREQUISITES = [
+    {
+        step: 'Unlock Wallet',
+        description: 'The wallet must be unlocked before interacting with it. Use the extension UI to enter your password.',
+    },
+    {
+        step: 'Configure Network',
+        description: 'Ensure the correct network is selected (e.g., Ethereum Mainnet, Sepolia, or custom network).',
+    },
+    {
+        step: 'Set Up Accounts',
+        description: 'Import or create accounts as needed. Ensure the active account has sufficient funds for transactions.',
+    },
+];
+/**
+ * Handles the launch tool request to start a browser session.
+ *
+ * @param input - The launch configuration parameters.
+ * @param _options - Handler options (unused).
+ * @returns Response with session info or error.
+ */
+export async function handleLaunch(input, _options) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    try {
+        if (sessionManager.hasActiveSession()) {
+            return createErrorResponse(ErrorCodes.MM_SESSION_ALREADY_RUNNING, 'A session is already running. Call mm_cleanup first.', { currentSessionId: sessionManager.getSessionId() }, sessionManager.getSessionId(), startTime);
+        }
+        const result = await sessionManager.launch(input);
+        const isProdMode = sessionManager.getEnvironmentMode() === 'prod';
+        const launchResult = {
+            ...result,
+            ...(isProdMode && { prerequisites: PROD_MODE_PREREQUISITES }),
+        };
+        return createSuccessResponse(launchResult, result.sessionId, startTime);
+    }
+    catch (error) {
+        const message = extractErrorMessage(error);
+        if (message.includes('EADDRINUSE') || message.includes('port')) {
+            return createErrorResponse(ErrorCodes.MM_PORT_IN_USE, `Port conflict: ${message}`, { input }, undefined, startTime);
+        }
+        return createErrorResponse(ErrorCodes.MM_LAUNCH_FAILED, `Launch failed: ${message}`, { input }, undefined, startTime);
+    }
+}
+//# sourceMappingURL=launch.mjs.map

package/dist/mcp-server/tools/launch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,+BAA8B;AAQ1D,OAAO,EAAE,UAAU,EAAE,2BAAiB;AACtC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACpB,2BAAiB;AAElB,MAAM,uBAAuB,GAAyB;IACpD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,sGAAsG;KACzG;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,8FAA8F;KACjG;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,uGAAuG;KAC1G;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAkB,EAClB,QAAyB;IAEzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,IAAI,CAAC;QACH,IAAI,cAAc,CAAC,gBAAgB,EAAE,EAAE,CAAC;YACtC,OAAO,mBAAmB,CACxB,UAAU,CAAC,0BAA0B,EACrC,sDAAsD,EACtD,EAAE,gBAAgB,EAAE,cAAc,CAAC,YAAY,EAAE,EAAE,EACnD,cAAc,CAAC,YAAY,EAAE,EAC7B,SAAS,CACV,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAElD,MAAM,UAAU,GAAG,cAAc,CAAC,kBAAkB,EAAE,KAAK,MAAM,CAAC;QAClE,MAAM,YAAY,GAAiB;YACjC,GAAG,MAAM;YACT,GAAG,CAAC,UAAU,IAAI,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAC;SAC9D,CAAC;QAEF,OAAO,qBAAqB,CAC1B,YAAY,EACZ,MAAM,CAAC,SAAS,EAChB,SAAS,CACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/D,OAAO,mBAAmB,CACxB,UAAU,CAAC,cAAc,EACzB,kBAAkB,OAAO,EAAE,EAC3B,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;QACJ,CAAC;QAED,OAAO,mBAAmB,CACxB,UAAU,CAAC,gBAAgB,EAC3B,kBAAkB,OAAO,EAAE,EAC3B,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { getSessionManager } from '../session-manager.js';\nimport type {\n  LaunchInput,\n  LaunchResult,\n  LaunchPrerequisite,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n} from '../utils';\n\nconst PROD_MODE_PREREQUISITES: LaunchPrerequisite[] = [\n  {\n    step: 'Unlock Wallet',\n    description:\n      'The wallet must be unlocked before interacting with it. Use the extension UI to enter your password.',\n  },\n  {\n    step: 'Configure Network',\n    description:\n      'Ensure the correct network is selected (e.g., Ethereum Mainnet, Sepolia, or custom network).',\n  },\n  {\n    step: 'Set Up Accounts',\n    description:\n      'Import or create accounts as needed. Ensure the active account has sufficient funds for transactions.',\n  },\n];\n\n/**\n * Handles the launch tool request to start a browser session.\n *\n * @param input - The launch configuration parameters.\n * @param _options - Handler options (unused).\n * @returns Response with session info or error.\n */\nexport async function handleLaunch(\n  input: LaunchInput,\n  _options?: HandlerOptions,\n): Promise<McpResponse<LaunchResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n\n  try {\n    if (sessionManager.hasActiveSession()) {\n      return createErrorResponse(\n        ErrorCodes.MM_SESSION_ALREADY_RUNNING,\n        'A session is already running. Call mm_cleanup first.',\n        { currentSessionId: sessionManager.getSessionId() },\n        sessionManager.getSessionId(),\n        startTime,\n      );\n    }\n\n    const result = await sessionManager.launch(input);\n\n    const isProdMode = sessionManager.getEnvironmentMode() === 'prod';\n    const launchResult: LaunchResult = {\n      ...result,\n      ...(isProdMode && { prerequisites: PROD_MODE_PREREQUISITES }),\n    };\n\n    return createSuccessResponse<LaunchResult>(\n      launchResult,\n      result.sessionId,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n\n    if (message.includes('EADDRINUSE') || message.includes('port')) {\n      return createErrorResponse(\n        ErrorCodes.MM_PORT_IN_USE,\n        `Port conflict: ${message}`,\n        { input },\n        undefined,\n        startTime,\n      );\n    }\n\n    return createErrorResponse(\n      ErrorCodes.MM_LAUNCH_FAILED,\n      `Launch failed: ${message}`,\n      { input },\n      undefined,\n      startTime,\n    );\n  }\n}\n"]}

package/dist/mcp-server/tools/navigation.cjs

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleNavigate = handleNavigate;
+exports.handleWaitForNotification = handleWaitForNotification;
+exports.handleSwitchToTab = handleSwitchToTab;
+exports.handleCloseTab = handleCloseTab;
+const constants_js_1 = require("../constants.cjs");
+const session_manager_js_1 = require("../session-manager.cjs");
+const error_classification_js_1 = require("./error-classification.cjs");
+const run_tool_js_1 = require("./run-tool.cjs");
+const types_1 = require("../types/index.cjs");
+const utils_1 = require("../utils/index.cjs");
+/**
+ * Handles navigation to a specific screen or URL.
+ *
+ * @param input The navigate input containing target screen and optional URL
+ * @param options Optional handler configuration
+ * @returns Promise resolving to navigate result with current URL information
+ */
+async function handleNavigate(input, options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    if (input.screen === 'url' && !input.url) {
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_INVALID_INPUT, 'url is required when screen is "url"', { input }, sessionId, startTime);
+    }
+    const validScreens = ['home', 'settings', 'url', 'notification'];
+    if (!validScreens.includes(input.screen)) {
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_INVALID_INPUT, `Unknown screen: ${String(input.screen)}`, { input }, sessionId, startTime);
+    }
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_navigate',
+        input,
+        options,
+        /**
+         * Executes the navigation action to the target screen.
+         *
+         * @param context The tool execution context containing page and reference map
+         * @returns Promise resolving to navigate result with success status and URL
+         */
+        execute: async (context) => {
+            switch (input.screen) {
+                case 'home':
+                    await sessionManager.navigateToHome();
+                    break;
+                case 'settings':
+                    await sessionManager.navigateToSettings();
+                    break;
+                case 'url':
+                    await sessionManager.navigateToUrl(input.url);
+                    break;
+                case 'notification':
+                    await sessionManager.navigateToNotification();
+                    break;
+                default:
+                    throw new Error(`Unsupported screen: ${String(input.screen)}`);
+            }
+            return {
+                navigated: true,
+                currentUrl: context.page.url(),
+            };
+        },
+        classifyError: error_classification_js_1.classifyNavigationError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object with screen and URL information
+         */
+        sanitizeInputForRecording: () => ({
+            screen: input.screen,
+            url: input.url,
+        }),
+    });
+}
+/**
+ * Handles waiting for a notification popup to appear.
+ *
+ * @param input The wait input containing timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to wait result with notification page URL
+ */
+async function handleWaitForNotification(input, options) {
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const timeoutMs = input.timeoutMs ?? constants_js_1.DEFAULT_INTERACTION_TIMEOUT_MS;
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_wait_for_notification',
+        input,
+        options,
+        /**
+         * Executes the wait action for notification popup.
+         *
+         * @returns Promise resolving to wait result with notification page URL
+         */
+        execute: async () => {
+            const notificationPage = await sessionManager.waitForNotificationPage(timeoutMs);
+            const pageUrl = notificationPage.url();
+            return {
+                found: true,
+                pageUrl,
+            };
+        },
+        classifyError: error_classification_js_1.classifyNotificationError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object with timeout information
+         */
+        sanitizeInputForRecording: () => ({ timeoutMs }),
+    });
+}
+/**
+ * Handles switching to a different tab by role or URL.
+ *
+ * @param input The switch input containing tab role or URL to match
+ * @param options Optional handler configuration
+ * @returns Promise resolving to switch result with active tab information
+ */
+async function handleSwitchToTab(input, options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    if (!input.role && !input.url) {
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_INVALID_INPUT, 'Either role or url must be provided', { input }, sessionId, startTime);
+    }
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_switch_to_tab',
+        input,
+        options,
+        /**
+         * Executes the tab switch action.
+         *
+         * @param _context The tool execution context containing page and reference map
+         * @returns Promise resolving to switch result with active tab information
+         */
+        execute: async (_context) => {
+            const trackedPages = sessionManager.getTrackedPages();
+            const targetPage = trackedPages.find((trackedPage) => {
+                if (input.role) {
+                    return trackedPage.role === input.role;
+                }
+                if (input.url) {
+                    return trackedPage.url.startsWith(input.url);
+                }
+                return false;
+            });
+            if (!targetPage) {
+                const availableTabs = trackedPages.map((trackedPage) => ({
+                    role: trackedPage.role,
+                    url: trackedPage.url,
+                }));
+                throw new Error(`No tab found matching: ${input.role ?? input.url}. Available tabs: ${JSON.stringify(availableTabs)}`);
+            }
+            await targetPage.page.bringToFront();
+            sessionManager.setActivePage(targetPage.page);
+            const updatedTrackedPages = sessionManager.getTrackedPages();
+            const activeTabInfo = updatedTrackedPages.find((trackedPage) => trackedPage.page === targetPage.page);
+            return {
+                switched: true,
+                activeTab: {
+                    role: activeTabInfo?.role ?? 'other',
+                    url: targetPage.page.url(),
+                },
+            };
+        },
+        classifyError: error_classification_js_1.classifyTabError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object with role and URL information
+         */
+        sanitizeInputForRecording: () => ({
+            role: input.role,
+            url: input.url,
+        }),
+    });
+}
+/**
+ * Handles closing a tab by role or URL.
+ *
+ * @param input The close input containing tab role or URL to match
+ * @param options Optional handler configuration
+ * @returns Promise resolving to close result with closed tab URL
+ */
+async function handleCloseTab(input, options) {
+    const startTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    if (!input.role && !input.url) {
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_INVALID_INPUT, 'Either role or url must be provided', { input }, sessionId, startTime);
+    }
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_close_tab',
+        input,
+        options,
+        /**
+         * Executes the tab close action.
+         *
+         * @param context The tool execution context containing page and reference map
+         * @returns Promise resolving to close result with closed tab URL
+         */
+        execute: async (context) => {
+            const trackedPages = sessionManager.getTrackedPages();
+            const targetPage = trackedPages.find((trackedPage) => {
+                if (input.role) {
+                    return trackedPage.role === input.role;
+                }
+                if (input.url) {
+                    return trackedPage.url.startsWith(input.url);
+                }
+                return false;
+            });
+            if (!targetPage) {
+                throw new Error(`No tab found matching: ${input.role ?? input.url}`);
+            }
+            const closedUrl = targetPage.url;
+            const currentActivePage = context.page;
+            if (targetPage.page === currentActivePage) {
+                const extensionPage = trackedPages.find((trackedPage) => trackedPage.role === 'extension');
+                if (extensionPage) {
+                    await extensionPage.page.bringToFront();
+                    sessionManager.setActivePage(extensionPage.page);
+                }
+            }
+            await targetPage.page.close();
+            return {
+                closed: true,
+                closedUrl,
+            };
+        },
+        classifyError: error_classification_js_1.classifyTabError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object with role and URL information
+         */
+        sanitizeInputForRecording: () => ({
+            role: input.role,
+            url: input.url,
+        }),
+    });
+}
+//# sourceMappingURL=navigation.cjs.map

package/dist/mcp-server/tools/navigation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/navigation.ts"],"names":[],"mappings":";;AA8BA,wCA4EC;AASD,8DAqCC;AASD,8CAgFC;AASD,wCA8EC;AAxUD,mDAAiE;AACjE,+DAA0D;AAC1D,wEAImC;AACnC,gDAAwC;AAaxC,8CAAsC;AACtC,8CAA+C;AAE/C;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAClC,KAAoB,EACpB,OAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,IAAA,sCAAiB,GAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC;IAEhD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACzC,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,gBAAgB,EAC3B,sCAAsC,EACtC,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IACjE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,gBAAgB,EAC3B,mBAAmB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EACzC,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,qBAAO,EAAgC;QAC5C,QAAQ,EAAE,aAAa;QACvB,KAAK;QACL,OAAO;QAEP;;;;;WAKG;QACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrB,KAAK,MAAM;oBACT,MAAM,cAAc,CAAC,cAAc,EAAE,CAAC;oBACtC,MAAM;gBACR,KAAK,UAAU;oBACb,MAAM,cAAc,CAAC,kBAAkB,EAAE,CAAC;oBAC1C,MAAM;gBACR,KAAK,KAAK;oBACR,MAAM,cAAc,CAAC,aAAa,CAAC,KAAK,CAAC,GAAa,CAAC,CAAC;oBACxD,MAAM;gBACR,KAAK,cAAc;oBACjB,MAAM,cAAc,CAAC,sBAAsB,EAAE,CAAC;oBAC9C,MAAM;gBACR;oBACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;aAC/B,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,iDAAuB;QAEtC;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,yBAAyB,CAC7C,KAA+B,EAC/B,OAAwB;IAExB,MAAM,cAAc,GAAG,IAAA,sCAAiB,GAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,6CAA8B,CAAC;IAEpE,OAAO,IAAA,qBAAO,EAAsD;QAClE,QAAQ,EAAE,0BAA0B;QACpC,KAAK;QACL,OAAO;QAEP;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,gBAAgB,GACpB,MAAM,cAAc,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAEvC,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,OAAO;aACR,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,mDAAyB;QAExC;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CACrC,KAAuB,EACvB,OAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,IAAA,sCAAiB,GAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC;IAEhD,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,gBAAgB,EAC3B,qCAAqC,EACrC,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,qBAAO,EAAsC;QAClD,QAAQ,EAAE,kBAAkB;QAC5B,KAAK;QACL,OAAO;QAEP;;;;;WAKG;QACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YAC1B,MAAM,YAAY,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;YACtD,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;gBACnD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACf,OAAO,WAAW,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;gBACzC,CAAC;gBACD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;oBACd,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/C,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;oBACvD,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,GAAG,EAAE,WAAW,CAAC,GAAG;iBACrB,CAAC,CAAC,CAAC;gBACJ,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,qBAAqB,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CACtG,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,cAAc,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAE9C,MAAM,mBAAmB,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;YAC7D,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAC5C,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,CACtD,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE;oBACT,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,OAAO;oBACpC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE;iBAC3B;aACF,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,0CAAgB;QAE/B;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAClC,KAAoB,EACpB,OAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,IAAA,sCAAiB,GAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC;IAEhD,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,gBAAgB,EAC3B,qCAAqC,EACrC,EAAE,KAAK,EAAE,EACT,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;IAED,OAAO,IAAA,qBAAO,EAAgC;QAC5C,QAAQ,EAAE,cAAc;QACxB,KAAK;QACL,OAAO;QAEP;;;;;WAKG;QACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,YAAY,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;YACtD,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;gBACnD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACf,OAAO,WAAW,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;gBACzC,CAAC;gBACD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;oBACd,OAAO,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/C,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC;YAEjC,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YACvC,IAAI,UAAU,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC1C,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CACrC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,WAAW,CAClD,CAAC;gBACF,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;oBACxC,cAAc,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAED,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAE9B,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,SAAS;aACV,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,0CAAgB;QAE/B;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC;KACH,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { DEFAULT_INTERACTION_TIMEOUT_MS } from '../constants.js';\nimport { getSessionManager } from '../session-manager.js';\nimport {\n  classifyNavigationError,\n  classifyTabError,\n  classifyNotificationError,\n} from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  NavigateInput,\n  NavigateResult,\n  WaitForNotificationInput,\n  WaitForNotificationResult,\n  SwitchToTabInput,\n  SwitchToTabResult,\n  CloseTabInput,\n  CloseTabResult,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport { createErrorResponse } from '../utils';\n\n/**\n * Handles navigation to a specific screen or URL.\n *\n * @param input The navigate input containing target screen and optional URL\n * @param options Optional handler configuration\n * @returns Promise resolving to navigate result with current URL information\n */\nexport async function handleNavigate(\n  input: NavigateInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<NavigateResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n\n  if (input.screen === 'url' && !input.url) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'url is required when screen is \"url\"',\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  const validScreens = ['home', 'settings', 'url', 'notification'];\n  if (!validScreens.includes(input.screen)) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      `Unknown screen: ${String(input.screen)}`,\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  return runTool<NavigateInput, NavigateResult>({\n    toolName: 'mm_navigate',\n    input,\n    options,\n\n    /**\n     * Executes the navigation action to the target screen.\n     *\n     * @param context The tool execution context containing page and reference map\n     * @returns Promise resolving to navigate result with success status and URL\n     */\n    execute: async (context) => {\n      switch (input.screen) {\n        case 'home':\n          await sessionManager.navigateToHome();\n          break;\n        case 'settings':\n          await sessionManager.navigateToSettings();\n          break;\n        case 'url':\n          await sessionManager.navigateToUrl(input.url as string);\n          break;\n        case 'notification':\n          await sessionManager.navigateToNotification();\n          break;\n        default:\n          throw new Error(`Unsupported screen: ${String(input.screen)}`);\n      }\n\n      return {\n        navigated: true,\n        currentUrl: context.page.url(),\n      };\n    },\n\n    classifyError: classifyNavigationError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object with screen and URL information\n     */\n    sanitizeInputForRecording: () => ({\n      screen: input.screen,\n      url: input.url,\n    }),\n  });\n}\n\n/**\n * Handles waiting for a notification popup to appear.\n *\n * @param input The wait input containing timeout options\n * @param options Optional handler configuration\n * @returns Promise resolving to wait result with notification page URL\n */\nexport async function handleWaitForNotification(\n  input: WaitForNotificationInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<WaitForNotificationResult>> {\n  const sessionManager = getSessionManager();\n  const timeoutMs = input.timeoutMs ?? DEFAULT_INTERACTION_TIMEOUT_MS;\n\n  return runTool<WaitForNotificationInput, WaitForNotificationResult>({\n    toolName: 'mm_wait_for_notification',\n    input,\n    options,\n\n    /**\n     * Executes the wait action for notification popup.\n     *\n     * @returns Promise resolving to wait result with notification page URL\n     */\n    execute: async () => {\n      const notificationPage =\n        await sessionManager.waitForNotificationPage(timeoutMs);\n      const pageUrl = notificationPage.url();\n\n      return {\n        found: true,\n        pageUrl,\n      };\n    },\n\n    classifyError: classifyNotificationError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object with timeout information\n     */\n    sanitizeInputForRecording: () => ({ timeoutMs }),\n  });\n}\n\n/**\n * Handles switching to a different tab by role or URL.\n *\n * @param input The switch input containing tab role or URL to match\n * @param options Optional handler configuration\n * @returns Promise resolving to switch result with active tab information\n */\nexport async function handleSwitchToTab(\n  input: SwitchToTabInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<SwitchToTabResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n\n  if (!input.role && !input.url) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'Either role or url must be provided',\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  return runTool<SwitchToTabInput, SwitchToTabResult>({\n    toolName: 'mm_switch_to_tab',\n    input,\n    options,\n\n    /**\n     * Executes the tab switch action.\n     *\n     * @param _context The tool execution context containing page and reference map\n     * @returns Promise resolving to switch result with active tab information\n     */\n    execute: async (_context) => {\n      const trackedPages = sessionManager.getTrackedPages();\n      const targetPage = trackedPages.find((trackedPage) => {\n        if (input.role) {\n          return trackedPage.role === input.role;\n        }\n        if (input.url) {\n          return trackedPage.url.startsWith(input.url);\n        }\n        return false;\n      });\n\n      if (!targetPage) {\n        const availableTabs = trackedPages.map((trackedPage) => ({\n          role: trackedPage.role,\n          url: trackedPage.url,\n        }));\n        throw new Error(\n          `No tab found matching: ${input.role ?? input.url}. Available tabs: ${JSON.stringify(availableTabs)}`,\n        );\n      }\n\n      await targetPage.page.bringToFront();\n      sessionManager.setActivePage(targetPage.page);\n\n      const updatedTrackedPages = sessionManager.getTrackedPages();\n      const activeTabInfo = updatedTrackedPages.find(\n        (trackedPage) => trackedPage.page === targetPage.page,\n      );\n\n      return {\n        switched: true,\n        activeTab: {\n          role: activeTabInfo?.role ?? 'other',\n          url: targetPage.page.url(),\n        },\n      };\n    },\n\n    classifyError: classifyTabError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object with role and URL information\n     */\n    sanitizeInputForRecording: () => ({\n      role: input.role,\n      url: input.url,\n    }),\n  });\n}\n\n/**\n * Handles closing a tab by role or URL.\n *\n * @param input The close input containing tab role or URL to match\n * @param options Optional handler configuration\n * @returns Promise resolving to close result with closed tab URL\n */\nexport async function handleCloseTab(\n  input: CloseTabInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<CloseTabResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n\n  if (!input.role && !input.url) {\n    return createErrorResponse(\n      ErrorCodes.MM_INVALID_INPUT,\n      'Either role or url must be provided',\n      { input },\n      sessionId,\n      startTime,\n    );\n  }\n\n  return runTool<CloseTabInput, CloseTabResult>({\n    toolName: 'mm_close_tab',\n    input,\n    options,\n\n    /**\n     * Executes the tab close action.\n     *\n     * @param context The tool execution context containing page and reference map\n     * @returns Promise resolving to close result with closed tab URL\n     */\n    execute: async (context) => {\n      const trackedPages = sessionManager.getTrackedPages();\n      const targetPage = trackedPages.find((trackedPage) => {\n        if (input.role) {\n          return trackedPage.role === input.role;\n        }\n        if (input.url) {\n          return trackedPage.url.startsWith(input.url);\n        }\n        return false;\n      });\n\n      if (!targetPage) {\n        throw new Error(`No tab found matching: ${input.role ?? input.url}`);\n      }\n\n      const closedUrl = targetPage.url;\n\n      const currentActivePage = context.page;\n      if (targetPage.page === currentActivePage) {\n        const extensionPage = trackedPages.find(\n          (trackedPage) => trackedPage.role === 'extension',\n        );\n        if (extensionPage) {\n          await extensionPage.page.bringToFront();\n          sessionManager.setActivePage(extensionPage.page);\n        }\n      }\n\n      await targetPage.page.close();\n\n      return {\n        closed: true,\n        closedUrl,\n      };\n    },\n\n    classifyError: classifyTabError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object with role and URL information\n     */\n    sanitizeInputForRecording: () => ({\n      role: input.role,\n      url: input.url,\n    }),\n  });\n}\n"]}

package/dist/mcp-server/tools/navigation.d.cts

@@ -0,0 +1,34 @@
+import type { NavigateInput, NavigateResult, WaitForNotificationInput, WaitForNotificationResult, SwitchToTabInput, SwitchToTabResult, CloseTabInput, CloseTabResult, McpResponse, HandlerOptions } from "../types/index.cjs";
+/**
+ * Handles navigation to a specific screen or URL.
+ *
+ * @param input The navigate input containing target screen and optional URL
+ * @param options Optional handler configuration
+ * @returns Promise resolving to navigate result with current URL information
+ */
+export declare function handleNavigate(input: NavigateInput, options?: HandlerOptions): Promise<McpResponse<NavigateResult>>;
+/**
+ * Handles waiting for a notification popup to appear.
+ *
+ * @param input The wait input containing timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to wait result with notification page URL
+ */
+export declare function handleWaitForNotification(input: WaitForNotificationInput, options?: HandlerOptions): Promise<McpResponse<WaitForNotificationResult>>;
+/**
+ * Handles switching to a different tab by role or URL.
+ *
+ * @param input The switch input containing tab role or URL to match
+ * @param options Optional handler configuration
+ * @returns Promise resolving to switch result with active tab information
+ */
+export declare function handleSwitchToTab(input: SwitchToTabInput, options?: HandlerOptions): Promise<McpResponse<SwitchToTabResult>>;
+/**
+ * Handles closing a tab by role or URL.
+ *
+ * @param input The close input containing tab role or URL to match
+ * @param options Optional handler configuration
+ * @returns Promise resolving to close result with closed tab URL
+ */
+export declare function handleCloseTab(input: CloseTabInput, options?: HandlerOptions): Promise<McpResponse<CloseTabResult>>;
+//# sourceMappingURL=navigation.d.cts.map

package/dist/mcp-server/tools/navigation.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/navigation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACf,2BAAiB;AAIlB;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAyEtC;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAkCjD;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CA6EzC;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CA2EtC"}

package/dist/mcp-server/tools/navigation.d.mts

@@ -0,0 +1,34 @@
+import type { NavigateInput, NavigateResult, WaitForNotificationInput, WaitForNotificationResult, SwitchToTabInput, SwitchToTabResult, CloseTabInput, CloseTabResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+/**
+ * Handles navigation to a specific screen or URL.
+ *
+ * @param input The navigate input containing target screen and optional URL
+ * @param options Optional handler configuration
+ * @returns Promise resolving to navigate result with current URL information
+ */
+export declare function handleNavigate(input: NavigateInput, options?: HandlerOptions): Promise<McpResponse<NavigateResult>>;
+/**
+ * Handles waiting for a notification popup to appear.
+ *
+ * @param input The wait input containing timeout options
+ * @param options Optional handler configuration
+ * @returns Promise resolving to wait result with notification page URL
+ */
+export declare function handleWaitForNotification(input: WaitForNotificationInput, options?: HandlerOptions): Promise<McpResponse<WaitForNotificationResult>>;
+/**
+ * Handles switching to a different tab by role or URL.
+ *
+ * @param input The switch input containing tab role or URL to match
+ * @param options Optional handler configuration
+ * @returns Promise resolving to switch result with active tab information
+ */
+export declare function handleSwitchToTab(input: SwitchToTabInput, options?: HandlerOptions): Promise<McpResponse<SwitchToTabResult>>;
+/**
+ * Handles closing a tab by role or URL.
+ *
+ * @param input The close input containing tab role or URL to match
+ * @param options Optional handler configuration
+ * @returns Promise resolving to close result with closed tab URL
+ */
+export declare function handleCloseTab(input: CloseTabInput, options?: HandlerOptions): Promise<McpResponse<CloseTabResult>>;
+//# sourceMappingURL=navigation.d.mts.map

package/dist/mcp-server/tools/navigation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/navigation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACf,2BAAiB;AAIlB;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAyEtC;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAkCjD;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CA6EzC;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CA2EtC"}