@metamask/client-mcp-core 0.1.0

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

@@ -0,0 +1,62 @@
+import { runTool } from "./run-tool.mjs";
+import { getSessionManager } from "../session-manager.mjs";
+import { classifyContextError } from "./error-classification.mjs";
+/**
+ * Handle setting the workflow context (e2e or prod).
+ *
+ * @param input The context input containing the desired context mode
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to the context change result with previous and new context
+ */
+export async function handleSetContext(input, options) {
+    return runTool({
+        toolName: 'mm_set_context',
+        input,
+        options,
+        requiresSession: false,
+        observationPolicy: 'none',
+        /**
+         * Execute the context switch operation.
+         *
+         * @returns The result containing previous context, new context, and available capabilities
+         */
+        execute: async () => {
+            const sessionManager = getSessionManager();
+            const previousContext = sessionManager.getEnvironmentMode();
+            sessionManager.setContext(input.context);
+            const info = sessionManager.getContextInfo();
+            return {
+                previousContext,
+                newContext: input.context,
+                availableCapabilities: info.capabilities.available,
+            };
+        },
+        classifyError: classifyContextError,
+    });
+}
+/**
+ * Handle getting the current workflow context and capabilities.
+ *
+ * @param input Empty input object for this operation
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to the current context, session state, and available capabilities
+ */
+export async function handleGetContext(input, options) {
+    return runTool({
+        toolName: 'mm_get_context',
+        input,
+        options,
+        requiresSession: false,
+        observationPolicy: 'none',
+        /**
+         * Execute the get context operation.
+         *
+         * @returns The result containing current context, session state, and capabilities
+         */
+        execute: async () => {
+            const sessionManager = getSessionManager();
+            return sessionManager.getContextInfo();
+        },
+    });
+}
+//# sourceMappingURL=context.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,uBAAsB;AACxC,OAAO,EAAE,iBAAiB,EAAE,+BAA8B;AAC1D,OAAO,EAAE,oBAAoB,EAAE,mCAAkC;AAYjE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAsB,EACtB,OAAwB;IAExB,OAAO,OAAO,CAAoC;QAChD,QAAQ,EAAE,gBAAgB;QAC1B,KAAK;QACL,OAAO;QACP,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;YAC3C,MAAM,eAAe,GAAG,cAAc,CAAC,kBAAkB,EAAE,CAAC;YAC5D,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,cAAc,CAAC,cAAc,EAAE,CAAC;YAE7C,OAAO;gBACL,eAAe;gBACf,UAAU,EAAE,KAAK,CAAC,OAAO;gBACzB,qBAAqB,EAAE,IAAI,CAAC,YAAY,CAAC,SAAS;aACnD,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,oBAAoB;KACpC,CAAC,CAAC;AACL,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA4B,EAC5B,OAAwB;IAExB,OAAO,OAAO,CAA0C;QACtD,QAAQ,EAAE,gBAAgB;QAC1B,KAAK;QACL,OAAO;QACP,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;YAC3C,OAAO,cAAc,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { runTool } from './run-tool.js';\nimport { getSessionManager } from '../session-manager.js';\nimport { classifyContextError } from './error-classification.js';\nimport type { McpResponse, HandlerOptions } from '../types';\n\nexport type SetContextInput = {\n  context: 'e2e' | 'prod';\n};\nexport type SetContextResult = {\n  previousContext: 'e2e' | 'prod';\n  newContext: 'e2e' | 'prod';\n  availableCapabilities: string[];\n};\n\n/**\n * Handle setting the workflow context (e2e or prod).\n *\n * @param input The context input containing the desired context mode\n * @param options Optional handler options for the operation\n * @returns Promise resolving to the context change result with previous and new context\n */\nexport async function handleSetContext(\n  input: SetContextInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<SetContextResult>> {\n  return runTool<SetContextInput, SetContextResult>({\n    toolName: 'mm_set_context',\n    input,\n    options,\n    requiresSession: false,\n    observationPolicy: 'none',\n\n    /**\n     * Execute the context switch operation.\n     *\n     * @returns The result containing previous context, new context, and available capabilities\n     */\n    execute: async () => {\n      const sessionManager = getSessionManager();\n      const previousContext = sessionManager.getEnvironmentMode();\n      sessionManager.setContext(input.context);\n      const info = sessionManager.getContextInfo();\n\n      return {\n        previousContext,\n        newContext: input.context,\n        availableCapabilities: info.capabilities.available,\n      };\n    },\n\n    classifyError: classifyContextError,\n  });\n}\n\nexport type GetContextResult = {\n  currentContext: 'e2e' | 'prod';\n  hasActiveSession: boolean;\n  sessionId: string | null;\n  capabilities: {\n    available: string[];\n  };\n  canSwitchContext: boolean;\n};\n\n/**\n * Handle getting the current workflow context and capabilities.\n *\n * @param input Empty input object for this operation\n * @param options Optional handler options for the operation\n * @returns Promise resolving to the current context, session state, and available capabilities\n */\nexport async function handleGetContext(\n  input: Record<string, never>,\n  options?: HandlerOptions,\n): Promise<McpResponse<GetContextResult>> {\n  return runTool<Record<string, never>, GetContextResult>({\n    toolName: 'mm_get_context',\n    input,\n    options,\n    requiresSession: false,\n    observationPolicy: 'none',\n\n    /**\n     * Execute the get context operation.\n     *\n     * @returns The result containing current context, session state, and capabilities\n     */\n    execute: async () => {\n      const sessionManager = getSessionManager();\n      return sessionManager.getContextInfo();\n    },\n  });\n}\n"]}

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

@@ -0,0 +1,463 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_PREFIX = void 0;
+exports.getToolDefinitions = getToolDefinitions;
+exports.getToolHandler = getToolHandler;
+exports.hasToolHandler = hasToolHandler;
+exports.extractBaseName = extractBaseName;
+exports.validateToolInput = validateToolInput;
+exports.safeValidateToolInput = safeValidateToolInput;
+exports.getToolNames = getToolNames;
+exports.getPrefixedToolNames = getPrefixedToolNames;
+exports.buildToolHandlersRecord = buildToolHandlersRecord;
+const schemas_js_1 = require("../schemas.cjs");
+const session_manager_js_1 = require("../session-manager.cjs");
+const batch_js_1 = require("./batch.cjs");
+const build_js_1 = require("./build.cjs");
+const cleanup_js_1 = require("./cleanup.cjs");
+const clipboard_js_1 = require("./clipboard.cjs");
+const context_js_1 = require("./context.cjs");
+const discovery_tools_js_1 = require("./discovery-tools.cjs");
+const interaction_js_1 = require("./interaction.cjs");
+const knowledge_js_1 = require("./knowledge.cjs");
+const launch_js_1 = require("./launch.cjs");
+const navigation_js_1 = require("./navigation.cjs");
+const screenshot_js_1 = require("./screenshot.cjs");
+const seeding_js_1 = require("./seeding.cjs");
+const state_js_1 = require("./state.cjs");
+exports.TOOL_PREFIX = 'mm';
+/**
+ * Create a handler for the build tool that injects build capability.
+ *
+ * @returns A tool handler function for building the extension
+ */
+function createBuildHandler() {
+    return async (input, options) => {
+        const sessionManager = (0, session_manager_js_1.getSessionManager)();
+        const buildOptions = {
+            ...options,
+            buildCapability: sessionManager.getBuildCapability?.(),
+        };
+        return (0, build_js_1.handleBuild)(input, buildOptions);
+    };
+}
+/**
+ * Create a handler for the state tool that injects state snapshot capability.
+ *
+ * @returns A tool handler function for getting extension state
+ */
+function createStateHandler() {
+    return async (_, options) => {
+        const sessionManager = (0, session_manager_js_1.getSessionManager)();
+        const stateOptions = {
+            ...options,
+            stateSnapshotCapability: sessionManager.getStateSnapshotCapability?.(),
+        };
+        return (0, state_js_1.handleGetState)(stateOptions);
+    };
+}
+/**
+ * Create a handler for the seed contract tool that injects seeding capability.
+ *
+ * @returns A tool handler function for deploying a single contract
+ */
+function createSeedContractHandler() {
+    return async (input, options) => {
+        const sessionManager = (0, session_manager_js_1.getSessionManager)();
+        const seedingOptions = {
+            ...options,
+            seedingCapability: sessionManager.getContractSeedingCapability?.(),
+        };
+        return (0, seeding_js_1.handleSeedContract)(input, seedingOptions);
+    };
+}
+/**
+ * Create a handler for the seed contracts tool that injects seeding capability.
+ *
+ * @returns A tool handler function for deploying multiple contracts
+ */
+function createSeedContractsHandler() {
+    return async (input, options) => {
+        const sessionManager = (0, session_manager_js_1.getSessionManager)();
+        const seedingOptions = {
+            ...options,
+            seedingCapability: sessionManager.getContractSeedingCapability?.(),
+        };
+        return (0, seeding_js_1.handleSeedContracts)(input, seedingOptions);
+    };
+}
+/**
+ * Create a handler for the get contract address tool that injects seeding capability.
+ *
+ * @returns A tool handler function for retrieving a deployed contract address
+ */
+function createGetContractAddressHandler() {
+    return async (input, options) => {
+        const sessionManager = (0, session_manager_js_1.getSessionManager)();
+        const seedingOptions = {
+            ...options,
+            seedingCapability: sessionManager.getContractSeedingCapability?.(),
+        };
+        return (0, seeding_js_1.handleGetContractAddress)(input, seedingOptions);
+    };
+}
+/**
+ * Create a handler for the list contracts tool that injects seeding capability.
+ *
+ * @returns A tool handler function for listing deployed contracts
+ */
+function createListDeployedContractsHandler() {
+    return async (input, options) => {
+        const sessionManager = (0, session_manager_js_1.getSessionManager)();
+        const seedingOptions = {
+            ...options,
+            seedingCapability: sessionManager.getContractSeedingCapability?.(),
+        };
+        return (0, seeding_js_1.handleListDeployedContracts)(input, seedingOptions);
+    };
+}
+const tools = {
+    build: {
+        schema: schemas_js_1.buildInputSchema,
+        description: `Build the extension using yarn build:test. Call before ${exports.TOOL_PREFIX}_launch if extension is not built.`,
+        handler: createBuildHandler(),
+    },
+    launch: {
+        schema: schemas_js_1.launchInputSchema,
+        description: 'Launch extension in a headed Chrome browser with Playwright. Returns session info and initial state.',
+        handler: launch_js_1.handleLaunch,
+    },
+    cleanup: {
+        schema: schemas_js_1.cleanupInputSchema,
+        description: 'Stop the browser, Anvil, and all services. Always call when done.',
+        handler: cleanup_js_1.handleCleanup,
+    },
+    get_state: {
+        schema: schemas_js_1.getStateInputSchema,
+        description: 'Get current extension state including screen, URL, balance, network, and account address.',
+        handler: createStateHandler(),
+    },
+    navigate: {
+        schema: schemas_js_1.navigateInputSchema,
+        description: 'Navigate to a specific screen in the extension.',
+        handler: navigation_js_1.handleNavigate,
+    },
+    wait_for_notification: {
+        schema: schemas_js_1.waitForNotificationInputSchema,
+        description: 'Wait for notification popup to appear (e.g., after dapp interaction). Sets the notification page as the active page for subsequent interactions.',
+        handler: navigation_js_1.handleWaitForNotification,
+    },
+    switch_to_tab: {
+        schema: schemas_js_1.switchToTabInputSchema,
+        description: `Switch the active page to a different tracked tab. Use this to direct ${exports.TOOL_PREFIX}_click, ${exports.TOOL_PREFIX}_type, and other interaction tools to a specific page.`,
+        handler: navigation_js_1.handleSwitchToTab,
+    },
+    close_tab: {
+        schema: schemas_js_1.closeTabInputSchema,
+        description: 'Close a specific tab by role or URL. Cannot close the extension home page. If closing the active tab, automatically switches to extension home.',
+        handler: navigation_js_1.handleCloseTab,
+    },
+    list_testids: {
+        schema: schemas_js_1.listTestIdsInputSchema,
+        description: 'List all visible data-testid attributes on the current page. Use to discover available interaction targets.',
+        handler: discovery_tools_js_1.handleListTestIds,
+    },
+    accessibility_snapshot: {
+        schema: schemas_js_1.accessibilitySnapshotInputSchema,
+        description: `Get trimmed accessibility tree with deterministic refs (e1, e2, ...). Use refs with ${exports.TOOL_PREFIX}_click/${exports.TOOL_PREFIX}_type.`,
+        handler: discovery_tools_js_1.handleAccessibilitySnapshot,
+    },
+    describe_screen: {
+        schema: schemas_js_1.describeScreenInputSchema,
+        description: 'Get comprehensive screen state: extension state + testIds + accessibility snapshot. Optional screenshot.',
+        handler: discovery_tools_js_1.handleDescribeScreen,
+    },
+    screenshot: {
+        schema: schemas_js_1.screenshotInputSchema,
+        description: 'Take a screenshot and save to test-artifacts/screenshots/',
+        handler: screenshot_js_1.handleScreenshot,
+    },
+    click: {
+        schema: schemas_js_1.clickInputSchema,
+        description: 'Click an element. Specify exactly one of: a11yRef, testId, or selector.',
+        handler: interaction_js_1.handleClick,
+    },
+    type: {
+        schema: schemas_js_1.typeInputSchema,
+        description: 'Type text into an element. Specify exactly one of: a11yRef, testId, or selector.',
+        handler: interaction_js_1.handleType,
+    },
+    wait_for: {
+        schema: schemas_js_1.waitForInputSchema,
+        description: 'Wait for an element to become visible. Specify exactly one of: a11yRef, testId, or selector.',
+        handler: interaction_js_1.handleWaitFor,
+    },
+    knowledge_last: {
+        schema: schemas_js_1.knowledgeLastInputSchema,
+        description: 'Get the last N step records from the knowledge store for the current session.',
+        handler: knowledge_js_1.handleKnowledgeLast,
+    },
+    knowledge_search: {
+        schema: schemas_js_1.knowledgeSearchInputSchema,
+        description: 'Search step records by tool name, screen, testId, or accessibility names. Default searches all sessions.',
+        handler: knowledge_js_1.handleKnowledgeSearch,
+    },
+    knowledge_summarize: {
+        schema: schemas_js_1.knowledgeSummarizeInputSchema,
+        description: 'Generate a recipe-like summary of steps taken in a session.',
+        handler: knowledge_js_1.handleKnowledgeSummarize,
+    },
+    knowledge_sessions: {
+        schema: schemas_js_1.knowledgeSessionsInputSchema,
+        description: 'List recent sessions with metadata for cross-session knowledge retrieval.',
+        handler: knowledge_js_1.handleKnowledgeSessions,
+    },
+    seed_contract: {
+        schema: schemas_js_1.seedContractInputSchema,
+        description: 'Deploy a smart contract to the local Anvil node. Available: hst (ERC20 TST token), nfts (ERC721), erc1155, piggybank, failing (reverts), multisig, entrypoint (ERC-4337), simpleAccountFactory, verifyingPaymaster.',
+        handler: createSeedContractHandler(),
+    },
+    seed_contracts: {
+        schema: schemas_js_1.seedContractsInputSchema,
+        description: 'Deploy multiple smart contracts in sequence.',
+        handler: createSeedContractsHandler(),
+    },
+    get_contract_address: {
+        schema: schemas_js_1.getContractAddressInputSchema,
+        description: 'Get the deployed address of a smart contract.',
+        handler: createGetContractAddressHandler(),
+    },
+    list_contracts: {
+        schema: schemas_js_1.listDeployedContractsInputSchema,
+        description: 'List all smart contracts deployed in this session.',
+        handler: createListDeployedContractsHandler(),
+    },
+    run_steps: {
+        schema: schemas_js_1.runStepsInputSchema,
+        description: 'Execute multiple tools in sequence. Reduces round trips for multi-step flows.',
+        handler: batch_js_1.handleRunSteps,
+    },
+    set_context: {
+        schema: schemas_js_1.setContextInputSchema,
+        description: 'Switch workflow context (e2e or prod). Cannot switch during active session.',
+        handler: context_js_1.handleSetContext,
+    },
+    get_context: {
+        schema: schemas_js_1.getContextInputSchema,
+        description: 'Get current context, available capabilities, and whether context can be switched.',
+        handler: context_js_1.handleGetContext,
+    },
+    clipboard: {
+        schema: schemas_js_1.clipboardInputSchema,
+        description: "Write text to or read text from the browser clipboard. Use action='write' with text parameter to write, or action='read' to read current clipboard content. Useful for pasting SRP or other data into components that have paste handlers.",
+        handler: clipboard_js_1.handleClipboard,
+    },
+};
+/**
+ * Zod v4's toJSONSchema() marks properties with defaults as required.
+ * This is incorrect for MCP tool input schemas where LLM clients shouldn't
+ * be required to provide values that have defaults. This function recursively
+ * removes those properties from the required array.
+ *
+ * @param schema The JSON schema to process
+ * @returns The modified schema with defaults removed from required array
+ */
+function removeDefaultsFromRequired(schema) {
+    const result = { ...schema };
+    if (Array.isArray(result.allOf)) {
+        result.allOf = result.allOf.map((item) => removeDefaultsFromRequired(item));
+    }
+    if (Array.isArray(result.anyOf)) {
+        result.anyOf = result.anyOf.map((item) => removeDefaultsFromRequired(item));
+    }
+    if (Array.isArray(result.oneOf)) {
+        result.oneOf = result.oneOf.map((item) => removeDefaultsFromRequired(item));
+    }
+    if (result.properties &&
+        typeof result.properties === 'object' &&
+        result.properties !== null) {
+        const newProperties = {};
+        for (const [key, value] of Object.entries(result.properties)) {
+            if (value && typeof value === 'object') {
+                newProperties[key] = removeDefaultsFromRequired(value);
+            }
+            else {
+                newProperties[key] = value;
+            }
+        }
+        result.properties = newProperties;
+    }
+    if (Array.isArray(result.required) &&
+        result.properties &&
+        typeof result.properties === 'object') {
+        const properties = result.properties;
+        result.required = result.required.filter((propName) => {
+            const prop = properties[propName];
+            return prop && !('default' in prop);
+        });
+        if (result.required.length === 0) {
+            delete result.required;
+        }
+    }
+    return result;
+}
+/**
+ * MCP protocol doesn't support allOf/oneOf/anyOf at the top level of input schemas.
+ * This flattens allOf into a single merged object schema.
+ *
+ * @param schema The JSON schema to flatten
+ * @returns The flattened schema with allOf merged into properties
+ */
+function flattenTopLevelAllOf(schema) {
+    if (!Array.isArray(schema.allOf)) {
+        return schema;
+    }
+    const mergedProperties = {};
+    const mergedRequired = [];
+    for (const subSchema of schema.allOf) {
+        if (subSchema.properties && typeof subSchema.properties === 'object') {
+            Object.assign(mergedProperties, subSchema.properties);
+        }
+        if (Array.isArray(subSchema.required)) {
+            mergedRequired.push(...subSchema.required);
+        }
+    }
+    const result = {
+        type: 'object',
+        properties: mergedProperties,
+        additionalProperties: false,
+    };
+    if (mergedRequired.length > 0) {
+        result.required = [...new Set(mergedRequired)];
+    }
+    return result;
+}
+/**
+ * Convert a Zod schema to a JSON schema suitable for MCP tool definitions.
+ *
+ * @param schema The Zod schema to convert
+ * @returns The converted JSON schema with defaults removed and allOf flattened
+ */
+function zodSchemaToJsonSchema(schema) {
+    const jsonSchema = schema.toJSONSchema();
+    const { $schema: _, ...rest } = jsonSchema;
+    const flattened = flattenTopLevelAllOf(rest);
+    if (flattened.type === 'object' && !('additionalProperties' in flattened)) {
+        flattened.additionalProperties = false;
+    }
+    return removeDefaultsFromRequired(flattened);
+}
+/**
+ * Get all tool definitions with their schemas and descriptions.
+ *
+ * @returns Array of tool definitions for all available MCP tools
+ */
+function getToolDefinitions() {
+    return Object.entries(tools).map(([baseName, tool]) => ({
+        name: `${exports.TOOL_PREFIX}_${baseName}`,
+        description: tool.description,
+        inputSchema: zodSchemaToJsonSchema(tool.schema),
+    }));
+}
+/**
+ * Get the handler function for a specific tool by name.
+ *
+ * @param name The tool name (with or without mm_ prefix)
+ * @returns The tool handler function or undefined if tool not found
+ */
+function getToolHandler(name) {
+    const prefixedMatch = Object.entries(tools).find(([baseName]) => `${exports.TOOL_PREFIX}_${baseName}` === name);
+    if (prefixedMatch) {
+        return prefixedMatch[1].handler;
+    }
+    const tool = tools[name];
+    return tool?.handler;
+}
+/**
+ * Check if a tool handler exists for the given tool name.
+ *
+ * @param name The tool name to check
+ * @returns True if a handler exists for the tool, false otherwise
+ */
+function hasToolHandler(name) {
+    return getToolHandler(name) !== undefined;
+}
+/**
+ * Extract the base name from a tool name by removing the mm_ prefix.
+ *
+ * @param toolName The tool name (with or without mm_ prefix)
+ * @returns The base name without the prefix
+ */
+function extractBaseName(toolName) {
+    const prefixWithUnderscore = `${exports.TOOL_PREFIX}_`;
+    if (toolName.startsWith(prefixWithUnderscore)) {
+        return toolName.slice(prefixWithUnderscore.length);
+    }
+    return toolName;
+}
+/**
+ * Validate tool input against the tool's schema and return parsed data.
+ *
+ * @param toolName The tool name to validate input for
+ * @param input The input data to validate
+ * @returns The validated and parsed input data
+ */
+function validateToolInput(toolName, input) {
+    const baseName = extractBaseName(toolName);
+    const tool = tools[baseName];
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+    return tool.schema.parse(input ?? {});
+}
+/**
+ * Safely validate tool input without throwing errors.
+ *
+ * @param toolName The tool name to validate input for
+ * @param input The input data to validate
+ * @returns Object with success flag and either parsed data or error message
+ */
+function safeValidateToolInput(toolName, input) {
+    const baseName = extractBaseName(toolName);
+    const tool = tools[baseName];
+    if (!tool) {
+        return { success: false, error: `Unknown tool: ${toolName}` };
+    }
+    const result = tool.schema.safeParse(input ?? {});
+    if (!result.success) {
+        const errorMessage = result.error.issues
+            .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+            .join('; ');
+        return { success: false, error: errorMessage };
+    }
+    return { success: true, data: result.data };
+}
+/**
+ * Get all available tool base names (without mm_ prefix).
+ *
+ * @returns Array of tool base names
+ */
+function getToolNames() {
+    return Object.keys(tools);
+}
+/**
+ * Get all available tool names with mm_ prefix.
+ *
+ * @returns Array of prefixed tool names
+ */
+function getPrefixedToolNames() {
+    return Object.keys(tools).map((name) => `${exports.TOOL_PREFIX}_${name}`);
+}
+/**
+ * Build a record mapping prefixed tool names to their handler functions.
+ *
+ * @returns Record of tool name to handler function mappings
+ */
+function buildToolHandlersRecord() {
+    const handlers = {};
+    for (const [baseName, tool] of Object.entries(tools)) {
+        handlers[`${exports.TOOL_PREFIX}_${baseName}`] = tool.handler;
+    }
+    return handlers;
+}
+//# sourceMappingURL=definitions.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/definitions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ZodType } from 'zod';\n\nimport {\n  buildInputSchema,\n  launchInputSchema,\n  cleanupInputSchema,\n  getStateInputSchema,\n  navigateInputSchema,\n  waitForNotificationInputSchema,\n  switchToTabInputSchema,\n  closeTabInputSchema,\n  listTestIdsInputSchema,\n  accessibilitySnapshotInputSchema,\n  describeScreenInputSchema,\n  screenshotInputSchema,\n  clickInputSchema,\n  typeInputSchema,\n  waitForInputSchema,\n  knowledgeLastInputSchema,\n  knowledgeSearchInputSchema,\n  knowledgeSummarizeInputSchema,\n  knowledgeSessionsInputSchema,\n  seedContractInputSchema,\n  seedContractsInputSchema,\n  getContractAddressInputSchema,\n  listDeployedContractsInputSchema,\n  runStepsInputSchema,\n  setContextInputSchema,\n  getContextInputSchema,\n  clipboardInputSchema,\n} from '../schemas.js';\nimport { getSessionManager } from '../session-manager.js';\nimport { handleRunSteps } from './batch.js';\nimport type { ToolHandler } from './batch.js';\nimport type { BuildToolOptions } from './build.js';\nimport { handleBuild } from './build.js';\nimport { handleCleanup } from './cleanup.js';\nimport { handleClipboard } from './clipboard.js';\nimport { handleSetContext, handleGetContext } from './context.js';\nimport {\n  handleListTestIds,\n  handleAccessibilitySnapshot,\n  handleDescribeScreen,\n} from './discovery-tools.js';\nimport { handleClick, handleType, handleWaitFor } from './interaction.js';\nimport {\n  handleKnowledgeLast,\n  handleKnowledgeSearch,\n  handleKnowledgeSummarize,\n  handleKnowledgeSessions,\n} from './knowledge.js';\nimport { handleLaunch } from './launch.js';\nimport {\n  handleNavigate,\n  handleWaitForNotification,\n  handleSwitchToTab,\n  handleCloseTab,\n} from './navigation.js';\nimport { handleScreenshot } from './screenshot.js';\nimport {\n  handleSeedContract,\n  handleSeedContracts,\n  handleGetContractAddress,\n  handleListDeployedContracts,\n} from './seeding.js';\nimport type { SeedingToolOptions } from './seeding.js';\nimport { handleGetState } from './state.js';\nimport type { StateToolOptions } from './state.js';\nimport type {\n  SeedContractInput,\n  SeedContractsInput,\n  GetContractAddressInput,\n  ListDeployedContractsInput,\n} from '../types';\n\nexport const TOOL_PREFIX = 'mm';\n\nexport type ToolDefinition = {\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n};\n\ntype ZodSchema = ZodType<unknown> & { toJSONSchema(): Record<string, unknown> };\n\ntype ToolEntry = {\n  schema: ZodSchema;\n  description: string;\n  handler: ToolHandler;\n};\n\n/**\n * Create a handler for the build tool that injects build capability.\n *\n * @returns A tool handler function for building the extension\n */\nfunction createBuildHandler(): ToolHandler {\n  return async (input, options) => {\n    const sessionManager = getSessionManager();\n    const buildOptions: BuildToolOptions = {\n      ...options,\n      buildCapability: sessionManager.getBuildCapability?.(),\n    };\n    return handleBuild(input, buildOptions);\n  };\n}\n\n/**\n * Create a handler for the state tool that injects state snapshot capability.\n *\n * @returns A tool handler function for getting extension state\n */\nfunction createStateHandler(): ToolHandler {\n  return async (_, options) => {\n    const sessionManager = getSessionManager();\n    const stateOptions: StateToolOptions = {\n      ...options,\n      stateSnapshotCapability: sessionManager.getStateSnapshotCapability?.(),\n    };\n    return handleGetState(stateOptions);\n  };\n}\n\n/**\n * Create a handler for the seed contract tool that injects seeding capability.\n *\n * @returns A tool handler function for deploying a single contract\n */\nfunction createSeedContractHandler(): ToolHandler {\n  return async (input, options) => {\n    const sessionManager = getSessionManager();\n    const seedingOptions: SeedingToolOptions = {\n      ...options,\n      seedingCapability: sessionManager.getContractSeedingCapability?.(),\n    };\n    return handleSeedContract(input as SeedContractInput, seedingOptions);\n  };\n}\n\n/**\n * Create a handler for the seed contracts tool that injects seeding capability.\n *\n * @returns A tool handler function for deploying multiple contracts\n */\nfunction createSeedContractsHandler(): ToolHandler {\n  return async (input, options) => {\n    const sessionManager = getSessionManager();\n    const seedingOptions: SeedingToolOptions = {\n      ...options,\n      seedingCapability: sessionManager.getContractSeedingCapability?.(),\n    };\n    return handleSeedContracts(input as SeedContractsInput, seedingOptions);\n  };\n}\n\n/**\n * Create a handler for the get contract address tool that injects seeding capability.\n *\n * @returns A tool handler function for retrieving a deployed contract address\n */\nfunction createGetContractAddressHandler(): ToolHandler {\n  return async (input, options) => {\n    const sessionManager = getSessionManager();\n    const seedingOptions: SeedingToolOptions = {\n      ...options,\n      seedingCapability: sessionManager.getContractSeedingCapability?.(),\n    };\n    return handleGetContractAddress(\n      input as GetContractAddressInput,\n      seedingOptions,\n    );\n  };\n}\n\n/**\n * Create a handler for the list contracts tool that injects seeding capability.\n *\n * @returns A tool handler function for listing deployed contracts\n */\nfunction createListDeployedContractsHandler(): ToolHandler {\n  return async (input, options) => {\n    const sessionManager = getSessionManager();\n    const seedingOptions: SeedingToolOptions = {\n      ...options,\n      seedingCapability: sessionManager.getContractSeedingCapability?.(),\n    };\n    return handleListDeployedContracts(\n      input as ListDeployedContractsInput,\n      seedingOptions,\n    );\n  };\n}\n\nconst tools: Record<string, ToolEntry> = {\n  build: {\n    schema: buildInputSchema,\n    description: `Build the extension using yarn build:test. Call before ${TOOL_PREFIX}_launch if extension is not built.`,\n    handler: createBuildHandler(),\n  },\n  launch: {\n    schema: launchInputSchema,\n    description:\n      'Launch extension in a headed Chrome browser with Playwright. Returns session info and initial state.',\n    handler: handleLaunch as ToolHandler,\n  },\n  cleanup: {\n    schema: cleanupInputSchema,\n    description:\n      'Stop the browser, Anvil, and all services. Always call when done.',\n    handler: handleCleanup as ToolHandler,\n  },\n  get_state: {\n    schema: getStateInputSchema,\n    description:\n      'Get current extension state including screen, URL, balance, network, and account address.',\n    handler: createStateHandler(),\n  },\n  navigate: {\n    schema: navigateInputSchema,\n    description: 'Navigate to a specific screen in the extension.',\n    handler: handleNavigate as ToolHandler,\n  },\n  wait_for_notification: {\n    schema: waitForNotificationInputSchema,\n    description:\n      'Wait for notification popup to appear (e.g., after dapp interaction). Sets the notification page as the active page for subsequent interactions.',\n    handler: handleWaitForNotification as ToolHandler,\n  },\n  switch_to_tab: {\n    schema: switchToTabInputSchema,\n    description: `Switch the active page to a different tracked tab. Use this to direct ${TOOL_PREFIX}_click, ${TOOL_PREFIX}_type, and other interaction tools to a specific page.`,\n    handler: handleSwitchToTab as ToolHandler,\n  },\n  close_tab: {\n    schema: closeTabInputSchema,\n    description:\n      'Close a specific tab by role or URL. Cannot close the extension home page. If closing the active tab, automatically switches to extension home.',\n    handler: handleCloseTab as ToolHandler,\n  },\n  list_testids: {\n    schema: listTestIdsInputSchema,\n    description:\n      'List all visible data-testid attributes on the current page. Use to discover available interaction targets.',\n    handler: handleListTestIds as ToolHandler,\n  },\n  accessibility_snapshot: {\n    schema: accessibilitySnapshotInputSchema,\n    description: `Get trimmed accessibility tree with deterministic refs (e1, e2, ...). Use refs with ${TOOL_PREFIX}_click/${TOOL_PREFIX}_type.`,\n    handler: handleAccessibilitySnapshot as ToolHandler,\n  },\n  describe_screen: {\n    schema: describeScreenInputSchema,\n    description:\n      'Get comprehensive screen state: extension state + testIds + accessibility snapshot. Optional screenshot.',\n    handler: handleDescribeScreen as ToolHandler,\n  },\n  screenshot: {\n    schema: screenshotInputSchema,\n    description: 'Take a screenshot and save to test-artifacts/screenshots/',\n    handler: handleScreenshot as ToolHandler,\n  },\n  click: {\n    schema: clickInputSchema,\n    description:\n      'Click an element. Specify exactly one of: a11yRef, testId, or selector.',\n    handler: handleClick as ToolHandler,\n  },\n  type: {\n    schema: typeInputSchema,\n    description:\n      'Type text into an element. Specify exactly one of: a11yRef, testId, or selector.',\n    handler: handleType as ToolHandler,\n  },\n  wait_for: {\n    schema: waitForInputSchema,\n    description:\n      'Wait for an element to become visible. Specify exactly one of: a11yRef, testId, or selector.',\n    handler: handleWaitFor as ToolHandler,\n  },\n  knowledge_last: {\n    schema: knowledgeLastInputSchema,\n    description:\n      'Get the last N step records from the knowledge store for the current session.',\n    handler: handleKnowledgeLast as ToolHandler,\n  },\n  knowledge_search: {\n    schema: knowledgeSearchInputSchema,\n    description:\n      'Search step records by tool name, screen, testId, or accessibility names. Default searches all sessions.',\n    handler: handleKnowledgeSearch as ToolHandler,\n  },\n  knowledge_summarize: {\n    schema: knowledgeSummarizeInputSchema,\n    description: 'Generate a recipe-like summary of steps taken in a session.',\n    handler: handleKnowledgeSummarize as ToolHandler,\n  },\n  knowledge_sessions: {\n    schema: knowledgeSessionsInputSchema,\n    description:\n      'List recent sessions with metadata for cross-session knowledge retrieval.',\n    handler: handleKnowledgeSessions as ToolHandler,\n  },\n  seed_contract: {\n    schema: seedContractInputSchema,\n    description:\n      'Deploy a smart contract to the local Anvil node. Available: hst (ERC20 TST token), nfts (ERC721), erc1155, piggybank, failing (reverts), multisig, entrypoint (ERC-4337), simpleAccountFactory, verifyingPaymaster.',\n    handler: createSeedContractHandler(),\n  },\n  seed_contracts: {\n    schema: seedContractsInputSchema,\n    description: 'Deploy multiple smart contracts in sequence.',\n    handler: createSeedContractsHandler(),\n  },\n  get_contract_address: {\n    schema: getContractAddressInputSchema,\n    description: 'Get the deployed address of a smart contract.',\n    handler: createGetContractAddressHandler(),\n  },\n  list_contracts: {\n    schema: listDeployedContractsInputSchema,\n    description: 'List all smart contracts deployed in this session.',\n    handler: createListDeployedContractsHandler(),\n  },\n  run_steps: {\n    schema: runStepsInputSchema,\n    description:\n      'Execute multiple tools in sequence. Reduces round trips for multi-step flows.',\n    handler: handleRunSteps as ToolHandler,\n  },\n  set_context: {\n    schema: setContextInputSchema,\n    description:\n      'Switch workflow context (e2e or prod). Cannot switch during active session.',\n    handler: handleSetContext as ToolHandler,\n  },\n  get_context: {\n    schema: getContextInputSchema,\n    description:\n      'Get current context, available capabilities, and whether context can be switched.',\n    handler: handleGetContext as ToolHandler,\n  },\n  clipboard: {\n    schema: clipboardInputSchema,\n    description:\n      \"Write text to or read text from the browser clipboard. Use action='write' with text parameter to write, or action='read' to read current clipboard content. Useful for pasting SRP or other data into components that have paste handlers.\",\n    handler: handleClipboard as ToolHandler,\n  },\n};\n\n/**\n * Zod v4's toJSONSchema() marks properties with defaults as required.\n * This is incorrect for MCP tool input schemas where LLM clients shouldn't\n * be required to provide values that have defaults. This function recursively\n * removes those properties from the required array.\n *\n * @param schema The JSON schema to process\n * @returns The modified schema with defaults removed from required array\n */\nfunction removeDefaultsFromRequired(\n  schema: Record<string, unknown>,\n): Record<string, unknown> {\n  const result = { ...schema };\n\n  if (Array.isArray(result.allOf)) {\n    result.allOf = result.allOf.map((item: Record<string, unknown>) =>\n      removeDefaultsFromRequired(item),\n    );\n  }\n\n  if (Array.isArray(result.anyOf)) {\n    result.anyOf = result.anyOf.map((item: Record<string, unknown>) =>\n      removeDefaultsFromRequired(item),\n    );\n  }\n\n  if (Array.isArray(result.oneOf)) {\n    result.oneOf = result.oneOf.map((item: Record<string, unknown>) =>\n      removeDefaultsFromRequired(item),\n    );\n  }\n\n  if (\n    result.properties &&\n    typeof result.properties === 'object' &&\n    result.properties !== null\n  ) {\n    const newProperties: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(\n      result.properties as Record<string, unknown>,\n    )) {\n      if (value && typeof value === 'object') {\n        newProperties[key] = removeDefaultsFromRequired(\n          value as Record<string, unknown>,\n        );\n      } else {\n        newProperties[key] = value;\n      }\n    }\n    result.properties = newProperties;\n  }\n\n  if (\n    Array.isArray(result.required) &&\n    result.properties &&\n    typeof result.properties === 'object'\n  ) {\n    const properties = result.properties as Record<\n      string,\n      Record<string, unknown>\n    >;\n    result.required = result.required.filter((propName: string) => {\n      const prop = properties[propName];\n      return prop && !('default' in prop);\n    });\n\n    if ((result.required as string[]).length === 0) {\n      delete result.required;\n    }\n  }\n\n  return result;\n}\n\n/**\n * MCP protocol doesn't support allOf/oneOf/anyOf at the top level of input schemas.\n * This flattens allOf into a single merged object schema.\n *\n * @param schema The JSON schema to flatten\n * @returns The flattened schema with allOf merged into properties\n */\nfunction flattenTopLevelAllOf(\n  schema: Record<string, unknown>,\n): Record<string, unknown> {\n  if (!Array.isArray(schema.allOf)) {\n    return schema;\n  }\n\n  const mergedProperties: Record<string, unknown> = {};\n  const mergedRequired: string[] = [];\n\n  for (const subSchema of schema.allOf as Record<string, unknown>[]) {\n    if (subSchema.properties && typeof subSchema.properties === 'object') {\n      Object.assign(mergedProperties, subSchema.properties);\n    }\n    if (Array.isArray(subSchema.required)) {\n      mergedRequired.push(...subSchema.required);\n    }\n  }\n\n  const result: Record<string, unknown> = {\n    type: 'object',\n    properties: mergedProperties,\n    additionalProperties: false,\n  };\n\n  if (mergedRequired.length > 0) {\n    result.required = [...new Set(mergedRequired)];\n  }\n\n  return result;\n}\n\n/**\n * Convert a Zod schema to a JSON schema suitable for MCP tool definitions.\n *\n * @param schema The Zod schema to convert\n * @returns The converted JSON schema with defaults removed and allOf flattened\n */\nfunction zodSchemaToJsonSchema(schema: ZodSchema): Record<string, unknown> {\n  const jsonSchema = schema.toJSONSchema();\n  const { $schema: _, ...rest } = jsonSchema;\n\n  const flattened = flattenTopLevelAllOf(rest);\n\n  if (flattened.type === 'object' && !('additionalProperties' in flattened)) {\n    flattened.additionalProperties = false;\n  }\n\n  return removeDefaultsFromRequired(flattened);\n}\n\n/**\n * Get all tool definitions with their schemas and descriptions.\n *\n * @returns Array of tool definitions for all available MCP tools\n */\nexport function getToolDefinitions(): ToolDefinition[] {\n  return Object.entries(tools).map(([baseName, tool]) => ({\n    name: `${TOOL_PREFIX}_${baseName}`,\n    description: tool.description,\n    inputSchema: zodSchemaToJsonSchema(tool.schema),\n  }));\n}\n\n/**\n * Get the handler function for a specific tool by name.\n *\n * @param name The tool name (with or without mm_ prefix)\n * @returns The tool handler function or undefined if tool not found\n */\nexport function getToolHandler(name: string): ToolHandler | undefined {\n  const prefixedMatch = Object.entries(tools).find(\n    ([baseName]) => `${TOOL_PREFIX}_${baseName}` === name,\n  );\n  if (prefixedMatch) {\n    return prefixedMatch[1].handler;\n  }\n\n  const tool = tools[name];\n  return tool?.handler;\n}\n\n/**\n * Check if a tool handler exists for the given tool name.\n *\n * @param name The tool name to check\n * @returns True if a handler exists for the tool, false otherwise\n */\nexport function hasToolHandler(name: string): boolean {\n  return getToolHandler(name) !== undefined;\n}\n\n/**\n * Extract the base name from a tool name by removing the mm_ prefix.\n *\n * @param toolName The tool name (with or without mm_ prefix)\n * @returns The base name without the prefix\n */\nexport function extractBaseName(toolName: string): string {\n  const prefixWithUnderscore = `${TOOL_PREFIX}_`;\n  if (toolName.startsWith(prefixWithUnderscore)) {\n    return toolName.slice(prefixWithUnderscore.length);\n  }\n  return toolName;\n}\n\n/**\n * Validate tool input against the tool's schema and return parsed data.\n *\n * @param toolName The tool name to validate input for\n * @param input The input data to validate\n * @returns The validated and parsed input data\n */\nexport function validateToolInput<Type = unknown>(\n  toolName: string,\n  input: unknown,\n): Type {\n  const baseName = extractBaseName(toolName);\n  const tool = tools[baseName];\n\n  if (!tool) {\n    throw new Error(`Unknown tool: ${toolName}`);\n  }\n\n  return tool.schema.parse(input ?? {}) as Type;\n}\n\n/**\n * Safely validate tool input without throwing errors.\n *\n * @param toolName The tool name to validate input for\n * @param input The input data to validate\n * @returns Object with success flag and either parsed data or error message\n */\nexport function safeValidateToolInput(\n  toolName: string,\n  input: unknown,\n):\n  | {\n      /**\n       * Indicates validation succeeded\n       */\n      success: true;\n      /**\n       * The validated and parsed input data\n       */\n      data: unknown;\n    }\n  | {\n      /**\n       * Indicates validation failed\n       */\n      success: false;\n      /**\n       * Error message describing validation failure\n       */\n      error: string;\n    } {\n  const baseName = extractBaseName(toolName);\n  const tool = tools[baseName];\n\n  if (!tool) {\n    return { success: false, error: `Unknown tool: ${toolName}` };\n  }\n\n  const result = tool.schema.safeParse(input ?? {});\n  if (!result.success) {\n    const errorMessage = result.error.issues\n      .map((issue) => `${issue.path.join('.')}: ${issue.message}`)\n      .join('; ');\n    return { success: false, error: errorMessage };\n  }\n\n  return { success: true, data: result.data };\n}\n\n/**\n * Get all available tool base names (without mm_ prefix).\n *\n * @returns Array of tool base names\n */\nexport function getToolNames(): string[] {\n  return Object.keys(tools);\n}\n\n/**\n * Get all available tool names with mm_ prefix.\n *\n * @returns Array of prefixed tool names\n */\nexport function getPrefixedToolNames(): string[] {\n  return Object.keys(tools).map((name) => `${TOOL_PREFIX}_${name}`);\n}\n\n/**\n * Build a record mapping prefixed tool names to their handler functions.\n *\n * @returns Record of tool name to handler function mappings\n */\nexport function buildToolHandlersRecord(): Record<string, ToolHandler> {\n  const handlers: Record<string, ToolHandler> = {};\n  for (const [baseName, tool] of Object.entries(tools)) {\n    handlers[`${TOOL_PREFIX}_${baseName}`] = tool.handler;\n  }\n  return handlers;\n}\n\nexport type { ToolEntry };\n"]}