@metamask/client-mcp-core 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.mjs","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"]}

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

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleListTestIds = handleListTestIds;
+exports.handleAccessibilitySnapshot = handleAccessibilitySnapshot;
+exports.handleDescribeScreen = handleDescribeScreen;
+const constants_js_1 = require("../constants.cjs");
+const discovery_js_1 = require("../discovery.cjs");
+const knowledge_store_js_1 = require("../knowledge-store.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");
+/**
+ * Handle listing all visible data-testid attributes on the current page.
+ *
+ * @param input The input containing optional limit for number of items
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to list of visible test IDs with metadata
+ */
+async function handleListTestIds(input, options) {
+    const limit = input.limit ?? constants_js_1.DEFAULT_TESTID_LIMIT;
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_list_testids',
+        input,
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Execute the list test IDs operation.
+         *
+         * @param context The workflow context containing the page
+         * @returns The result with test ID items and observation data
+         */
+        execute: async (context) => {
+            const items = await (0, discovery_js_1.collectTestIds)(context.page, limit);
+            const state = await (0, session_manager_js_1.getSessionManager)().getExtensionState();
+            const { nodes, refMap } = await (0, discovery_js_1.collectTrimmedA11ySnapshot)(context.page);
+            (0, session_manager_js_1.getSessionManager)().setRefMap(refMap);
+            return {
+                result: { items },
+                observation: (0, knowledge_store_js_1.createDefaultObservation)(state, items, nodes),
+            };
+        },
+        classifyError: error_classification_js_1.classifyDiscoveryError,
+        /**
+         * Sanitizes input for recording by extracting only the limit parameter.
+         *
+         * @returns Sanitized input with limit value
+         */
+        sanitizeInputForRecording: () => ({ limit }),
+    });
+}
+/**
+ * Handle getting a trimmed accessibility tree with deterministic refs.
+ *
+ * @param input The input containing optional root selector for scoping
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to accessibility nodes with deterministic refs
+ */
+async function handleAccessibilitySnapshot(input, options) {
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_accessibility_snapshot',
+        input,
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Execute the accessibility snapshot operation.
+         *
+         * @param context The workflow context containing the page
+         * @returns The result with accessibility nodes and observation data
+         */
+        execute: async (context) => {
+            const { nodes, refMap } = await (0, discovery_js_1.collectTrimmedA11ySnapshot)(context.page, input.rootSelector);
+            (0, session_manager_js_1.getSessionManager)().setRefMap(refMap);
+            const state = await (0, session_manager_js_1.getSessionManager)().getExtensionState();
+            const testIds = await (0, discovery_js_1.collectTestIds)(context.page, constants_js_1.OBSERVATION_TESTID_LIMIT);
+            return {
+                result: { nodes },
+                observation: (0, knowledge_store_js_1.createDefaultObservation)(state, testIds, nodes),
+            };
+        },
+        classifyError: error_classification_js_1.classifyDiscoveryError,
+        /**
+         * Sanitizes input for recording by extracting only the root selector.
+         *
+         * @returns Sanitized input with rootSelector value
+         */
+        sanitizeInputForRecording: () => ({ rootSelector: input.rootSelector }),
+    });
+}
+/**
+ * Handle getting comprehensive screen state with state, testIds, a11y, and optional screenshot.
+ *
+ * @param input The input containing screenshot options and selector
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to comprehensive screen description with prior knowledge
+ */
+async function handleDescribeScreen(input, options) {
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_describe_screen',
+        input,
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Execute the describe screen operation.
+         *
+         * @param context The workflow context containing the page
+         * @returns The result with state, testIds, a11y, screenshot, and prior knowledge
+         */
+        execute: async (context) => {
+            const sessionManager = (0, session_manager_js_1.getSessionManager)();
+            const { page } = context;
+            const state = await sessionManager.getExtensionState();
+            const testIds = await (0, discovery_js_1.collectTestIds)(page, constants_js_1.DEFAULT_TESTID_LIMIT);
+            const { nodes, refMap } = await (0, discovery_js_1.collectTrimmedA11ySnapshot)(page);
+            sessionManager.setRefMap(refMap);
+            let screenshot = null;
+            if (input.includeScreenshot) {
+                const screenshotName = input.screenshotName ?? 'describe-screen';
+                const result = await sessionManager.screenshot({
+                    name: screenshotName,
+                    fullPage: true,
+                });
+                screenshot = {
+                    path: result.path,
+                    width: result.width,
+                    height: result.height,
+                    base64: input.includeScreenshotBase64 ? result.base64 : null,
+                };
+            }
+            const sessionMetadata = sessionManager.getSessionMetadata();
+            const priorKnowledgeContext = {
+                currentScreen: state.currentScreen,
+                currentUrl: state.currentUrl,
+                visibleTestIds: testIds,
+                a11yNodes: nodes,
+                currentSessionFlowTags: sessionMetadata?.flowTags,
+            };
+            const priorKnowledge = await knowledge_store_js_1.knowledgeStore.generatePriorKnowledge(priorKnowledgeContext, context.sessionId);
+            const observation = (0, knowledge_store_js_1.createDefaultObservation)(state, testIds, nodes, priorKnowledge);
+            return {
+                result: {
+                    state,
+                    testIds: { items: testIds },
+                    a11y: { nodes },
+                    screenshot,
+                    priorKnowledge,
+                },
+                observation,
+            };
+        },
+        classifyError: error_classification_js_1.classifyDiscoveryError,
+        /**
+         * Sanitizes input for recording by extracting screenshot-related parameters.
+         *
+         * @returns Sanitized input with screenshot options
+         */
+        sanitizeInputForRecording: () => ({
+            includeScreenshot: input.includeScreenshot,
+            screenshotName: input.screenshotName,
+        }),
+    });
+}
+//# sourceMappingURL=discovery-tools.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-tools.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/discovery-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DEFAULT_TESTID_LIMIT,\n  OBSERVATION_TESTID_LIMIT,\n} from '../constants.js';\nimport { collectTestIds, collectTrimmedA11ySnapshot } from '../discovery.js';\nimport {\n  knowledgeStore,\n  createDefaultObservation,\n} from '../knowledge-store.js';\nimport { getSessionManager } from '../session-manager.js';\nimport { classifyDiscoveryError } from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  ListTestIdsInput,\n  ListTestIdsResult,\n  AccessibilitySnapshotInput,\n  AccessibilitySnapshotResult,\n  DescribeScreenInput,\n  DescribeScreenResult,\n  McpResponse,\n  PriorKnowledgeContext,\n  HandlerOptions,\n} from '../types';\n\n/**\n * Handle listing all visible data-testid attributes on the current page.\n *\n * @param input The input containing optional limit for number of items\n * @param options Optional handler options for the operation\n * @returns Promise resolving to list of visible test IDs with metadata\n */\nexport async function handleListTestIds(\n  input: ListTestIdsInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<ListTestIdsResult>> {\n  const limit = input.limit ?? DEFAULT_TESTID_LIMIT;\n\n  return runTool<ListTestIdsInput, ListTestIdsResult>({\n    toolName: 'mm_list_testids',\n    input,\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Execute the list test IDs operation.\n     *\n     * @param context The workflow context containing the page\n     * @returns The result with test ID items and observation data\n     */\n    execute: async (context) => {\n      const items = await collectTestIds(context.page, limit);\n      const state = await getSessionManager().getExtensionState();\n      const { nodes, refMap } = await collectTrimmedA11ySnapshot(context.page);\n\n      getSessionManager().setRefMap(refMap);\n\n      return {\n        result: { items },\n        observation: createDefaultObservation(state, items, nodes),\n      };\n    },\n\n    classifyError: classifyDiscoveryError,\n\n    /**\n     * Sanitizes input for recording by extracting only the limit parameter.\n     *\n     * @returns Sanitized input with limit value\n     */\n    sanitizeInputForRecording: () => ({ limit }),\n  });\n}\n\n/**\n * Handle getting a trimmed accessibility tree with deterministic refs.\n *\n * @param input The input containing optional root selector for scoping\n * @param options Optional handler options for the operation\n * @returns Promise resolving to accessibility nodes with deterministic refs\n */\nexport async function handleAccessibilitySnapshot(\n  input: AccessibilitySnapshotInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<AccessibilitySnapshotResult>> {\n  return runTool<AccessibilitySnapshotInput, AccessibilitySnapshotResult>({\n    toolName: 'mm_accessibility_snapshot',\n    input,\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Execute the accessibility snapshot operation.\n     *\n     * @param context The workflow context containing the page\n     * @returns The result with accessibility nodes and observation data\n     */\n    execute: async (context) => {\n      const { nodes, refMap } = await collectTrimmedA11ySnapshot(\n        context.page,\n        input.rootSelector,\n      );\n\n      getSessionManager().setRefMap(refMap);\n\n      const state = await getSessionManager().getExtensionState();\n      const testIds = await collectTestIds(\n        context.page,\n        OBSERVATION_TESTID_LIMIT,\n      );\n\n      return {\n        result: { nodes },\n        observation: createDefaultObservation(state, testIds, nodes),\n      };\n    },\n\n    classifyError: classifyDiscoveryError,\n\n    /**\n     * Sanitizes input for recording by extracting only the root selector.\n     *\n     * @returns Sanitized input with rootSelector value\n     */\n    sanitizeInputForRecording: () => ({ rootSelector: input.rootSelector }),\n  });\n}\n\n/**\n * Handle getting comprehensive screen state with state, testIds, a11y, and optional screenshot.\n *\n * @param input The input containing screenshot options and selector\n * @param options Optional handler options for the operation\n * @returns Promise resolving to comprehensive screen description with prior knowledge\n */\nexport async function handleDescribeScreen(\n  input: DescribeScreenInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<DescribeScreenResult>> {\n  return runTool<DescribeScreenInput, DescribeScreenResult>({\n    toolName: 'mm_describe_screen',\n    input,\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Execute the describe screen operation.\n     *\n     * @param context The workflow context containing the page\n     * @returns The result with state, testIds, a11y, screenshot, and prior knowledge\n     */\n    execute: async (context) => {\n      const sessionManager = getSessionManager();\n      const { page } = context;\n\n      const state = await sessionManager.getExtensionState();\n      const testIds = await collectTestIds(page, DEFAULT_TESTID_LIMIT);\n      const { nodes, refMap } = await collectTrimmedA11ySnapshot(page);\n\n      sessionManager.setRefMap(refMap);\n\n      let screenshot: DescribeScreenResult['screenshot'] = null;\n\n      if (input.includeScreenshot) {\n        const screenshotName = input.screenshotName ?? 'describe-screen';\n        const result = await sessionManager.screenshot({\n          name: screenshotName,\n          fullPage: true,\n        });\n\n        screenshot = {\n          path: result.path,\n          width: result.width,\n          height: result.height,\n          base64: input.includeScreenshotBase64 ? result.base64 : null,\n        };\n      }\n\n      const sessionMetadata = sessionManager.getSessionMetadata();\n      const priorKnowledgeContext: PriorKnowledgeContext = {\n        currentScreen: state.currentScreen,\n        currentUrl: state.currentUrl,\n        visibleTestIds: testIds,\n        a11yNodes: nodes,\n        currentSessionFlowTags: sessionMetadata?.flowTags,\n      };\n\n      const priorKnowledge = await knowledgeStore.generatePriorKnowledge(\n        priorKnowledgeContext,\n        context.sessionId,\n      );\n\n      const observation = createDefaultObservation(\n        state,\n        testIds,\n        nodes,\n        priorKnowledge,\n      );\n\n      return {\n        result: {\n          state,\n          testIds: { items: testIds },\n          a11y: { nodes },\n          screenshot,\n          priorKnowledge,\n        },\n        observation,\n      };\n    },\n\n    classifyError: classifyDiscoveryError,\n\n    /**\n     * Sanitizes input for recording by extracting screenshot-related parameters.\n     *\n     * @returns Sanitized input with screenshot options\n     */\n    sanitizeInputForRecording: () => ({\n      includeScreenshot: input.includeScreenshot,\n      screenshotName: input.screenshotName,\n    }),\n  });\n}\n"]}

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

@@ -0,0 +1,26 @@
+import type { ListTestIdsInput, ListTestIdsResult, AccessibilitySnapshotInput, AccessibilitySnapshotResult, DescribeScreenInput, DescribeScreenResult, McpResponse, HandlerOptions } from "../types/index.cjs";
+/**
+ * Handle listing all visible data-testid attributes on the current page.
+ *
+ * @param input The input containing optional limit for number of items
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to list of visible test IDs with metadata
+ */
+export declare function handleListTestIds(input: ListTestIdsInput, options?: HandlerOptions): Promise<McpResponse<ListTestIdsResult>>;
+/**
+ * Handle getting a trimmed accessibility tree with deterministic refs.
+ *
+ * @param input The input containing optional root selector for scoping
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to accessibility nodes with deterministic refs
+ */
+export declare function handleAccessibilitySnapshot(input: AccessibilitySnapshotInput, options?: HandlerOptions): Promise<McpResponse<AccessibilitySnapshotResult>>;
+/**
+ * Handle getting comprehensive screen state with state, testIds, a11y, and optional screenshot.
+ *
+ * @param input The input containing screenshot options and selector
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to comprehensive screen description with prior knowledge
+ */
+export declare function handleDescribeScreen(input: DescribeScreenInput, options?: HandlerOptions): Promise<McpResponse<DescribeScreenResult>>;
+//# sourceMappingURL=discovery-tools.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-tools.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/discovery-tools.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EAEX,cAAc,EACf,2BAAiB;AAElB;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAqCzC;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,0BAA0B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,CA0CnD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAqF5C"}

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

@@ -0,0 +1,26 @@
+import type { ListTestIdsInput, ListTestIdsResult, AccessibilitySnapshotInput, AccessibilitySnapshotResult, DescribeScreenInput, DescribeScreenResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+/**
+ * Handle listing all visible data-testid attributes on the current page.
+ *
+ * @param input The input containing optional limit for number of items
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to list of visible test IDs with metadata
+ */
+export declare function handleListTestIds(input: ListTestIdsInput, options?: HandlerOptions): Promise<McpResponse<ListTestIdsResult>>;
+/**
+ * Handle getting a trimmed accessibility tree with deterministic refs.
+ *
+ * @param input The input containing optional root selector for scoping
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to accessibility nodes with deterministic refs
+ */
+export declare function handleAccessibilitySnapshot(input: AccessibilitySnapshotInput, options?: HandlerOptions): Promise<McpResponse<AccessibilitySnapshotResult>>;
+/**
+ * Handle getting comprehensive screen state with state, testIds, a11y, and optional screenshot.
+ *
+ * @param input The input containing screenshot options and selector
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to comprehensive screen description with prior knowledge
+ */
+export declare function handleDescribeScreen(input: DescribeScreenInput, options?: HandlerOptions): Promise<McpResponse<DescribeScreenResult>>;
+//# sourceMappingURL=discovery-tools.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-tools.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/discovery-tools.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EAEX,cAAc,EACf,2BAAiB;AAElB;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAqCzC;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,0BAA0B,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,CA0CnD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAqF5C"}

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

@@ -0,0 +1,157 @@
+import { DEFAULT_TESTID_LIMIT, OBSERVATION_TESTID_LIMIT } from "../constants.mjs";
+import { collectTestIds, collectTrimmedA11ySnapshot } from "../discovery.mjs";
+import { knowledgeStore, createDefaultObservation } from "../knowledge-store.mjs";
+import { getSessionManager } from "../session-manager.mjs";
+import { classifyDiscoveryError } from "./error-classification.mjs";
+import { runTool } from "./run-tool.mjs";
+/**
+ * Handle listing all visible data-testid attributes on the current page.
+ *
+ * @param input The input containing optional limit for number of items
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to list of visible test IDs with metadata
+ */
+export async function handleListTestIds(input, options) {
+    const limit = input.limit ?? DEFAULT_TESTID_LIMIT;
+    return runTool({
+        toolName: 'mm_list_testids',
+        input,
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Execute the list test IDs operation.
+         *
+         * @param context The workflow context containing the page
+         * @returns The result with test ID items and observation data
+         */
+        execute: async (context) => {
+            const items = await collectTestIds(context.page, limit);
+            const state = await getSessionManager().getExtensionState();
+            const { nodes, refMap } = await collectTrimmedA11ySnapshot(context.page);
+            getSessionManager().setRefMap(refMap);
+            return {
+                result: { items },
+                observation: createDefaultObservation(state, items, nodes),
+            };
+        },
+        classifyError: classifyDiscoveryError,
+        /**
+         * Sanitizes input for recording by extracting only the limit parameter.
+         *
+         * @returns Sanitized input with limit value
+         */
+        sanitizeInputForRecording: () => ({ limit }),
+    });
+}
+/**
+ * Handle getting a trimmed accessibility tree with deterministic refs.
+ *
+ * @param input The input containing optional root selector for scoping
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to accessibility nodes with deterministic refs
+ */
+export async function handleAccessibilitySnapshot(input, options) {
+    return runTool({
+        toolName: 'mm_accessibility_snapshot',
+        input,
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Execute the accessibility snapshot operation.
+         *
+         * @param context The workflow context containing the page
+         * @returns The result with accessibility nodes and observation data
+         */
+        execute: async (context) => {
+            const { nodes, refMap } = await collectTrimmedA11ySnapshot(context.page, input.rootSelector);
+            getSessionManager().setRefMap(refMap);
+            const state = await getSessionManager().getExtensionState();
+            const testIds = await collectTestIds(context.page, OBSERVATION_TESTID_LIMIT);
+            return {
+                result: { nodes },
+                observation: createDefaultObservation(state, testIds, nodes),
+            };
+        },
+        classifyError: classifyDiscoveryError,
+        /**
+         * Sanitizes input for recording by extracting only the root selector.
+         *
+         * @returns Sanitized input with rootSelector value
+         */
+        sanitizeInputForRecording: () => ({ rootSelector: input.rootSelector }),
+    });
+}
+/**
+ * Handle getting comprehensive screen state with state, testIds, a11y, and optional screenshot.
+ *
+ * @param input The input containing screenshot options and selector
+ * @param options Optional handler options for the operation
+ * @returns Promise resolving to comprehensive screen description with prior knowledge
+ */
+export async function handleDescribeScreen(input, options) {
+    return runTool({
+        toolName: 'mm_describe_screen',
+        input,
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Execute the describe screen operation.
+         *
+         * @param context The workflow context containing the page
+         * @returns The result with state, testIds, a11y, screenshot, and prior knowledge
+         */
+        execute: async (context) => {
+            const sessionManager = getSessionManager();
+            const { page } = context;
+            const state = await sessionManager.getExtensionState();
+            const testIds = await collectTestIds(page, DEFAULT_TESTID_LIMIT);
+            const { nodes, refMap } = await collectTrimmedA11ySnapshot(page);
+            sessionManager.setRefMap(refMap);
+            let screenshot = null;
+            if (input.includeScreenshot) {
+                const screenshotName = input.screenshotName ?? 'describe-screen';
+                const result = await sessionManager.screenshot({
+                    name: screenshotName,
+                    fullPage: true,
+                });
+                screenshot = {
+                    path: result.path,
+                    width: result.width,
+                    height: result.height,
+                    base64: input.includeScreenshotBase64 ? result.base64 : null,
+                };
+            }
+            const sessionMetadata = sessionManager.getSessionMetadata();
+            const priorKnowledgeContext = {
+                currentScreen: state.currentScreen,
+                currentUrl: state.currentUrl,
+                visibleTestIds: testIds,
+                a11yNodes: nodes,
+                currentSessionFlowTags: sessionMetadata?.flowTags,
+            };
+            const priorKnowledge = await knowledgeStore.generatePriorKnowledge(priorKnowledgeContext, context.sessionId);
+            const observation = createDefaultObservation(state, testIds, nodes, priorKnowledge);
+            return {
+                result: {
+                    state,
+                    testIds: { items: testIds },
+                    a11y: { nodes },
+                    screenshot,
+                    priorKnowledge,
+                },
+                observation,
+            };
+        },
+        classifyError: classifyDiscoveryError,
+        /**
+         * Sanitizes input for recording by extracting screenshot-related parameters.
+         *
+         * @returns Sanitized input with screenshot options
+         */
+        sanitizeInputForRecording: () => ({
+            includeScreenshot: input.includeScreenshot,
+            screenshotName: input.screenshotName,
+        }),
+    });
+}
+//# sourceMappingURL=discovery-tools.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-tools.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/discovery-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DEFAULT_TESTID_LIMIT,\n  OBSERVATION_TESTID_LIMIT,\n} from '../constants.js';\nimport { collectTestIds, collectTrimmedA11ySnapshot } from '../discovery.js';\nimport {\n  knowledgeStore,\n  createDefaultObservation,\n} from '../knowledge-store.js';\nimport { getSessionManager } from '../session-manager.js';\nimport { classifyDiscoveryError } from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  ListTestIdsInput,\n  ListTestIdsResult,\n  AccessibilitySnapshotInput,\n  AccessibilitySnapshotResult,\n  DescribeScreenInput,\n  DescribeScreenResult,\n  McpResponse,\n  PriorKnowledgeContext,\n  HandlerOptions,\n} from '../types';\n\n/**\n * Handle listing all visible data-testid attributes on the current page.\n *\n * @param input The input containing optional limit for number of items\n * @param options Optional handler options for the operation\n * @returns Promise resolving to list of visible test IDs with metadata\n */\nexport async function handleListTestIds(\n  input: ListTestIdsInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<ListTestIdsResult>> {\n  const limit = input.limit ?? DEFAULT_TESTID_LIMIT;\n\n  return runTool<ListTestIdsInput, ListTestIdsResult>({\n    toolName: 'mm_list_testids',\n    input,\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Execute the list test IDs operation.\n     *\n     * @param context The workflow context containing the page\n     * @returns The result with test ID items and observation data\n     */\n    execute: async (context) => {\n      const items = await collectTestIds(context.page, limit);\n      const state = await getSessionManager().getExtensionState();\n      const { nodes, refMap } = await collectTrimmedA11ySnapshot(context.page);\n\n      getSessionManager().setRefMap(refMap);\n\n      return {\n        result: { items },\n        observation: createDefaultObservation(state, items, nodes),\n      };\n    },\n\n    classifyError: classifyDiscoveryError,\n\n    /**\n     * Sanitizes input for recording by extracting only the limit parameter.\n     *\n     * @returns Sanitized input with limit value\n     */\n    sanitizeInputForRecording: () => ({ limit }),\n  });\n}\n\n/**\n * Handle getting a trimmed accessibility tree with deterministic refs.\n *\n * @param input The input containing optional root selector for scoping\n * @param options Optional handler options for the operation\n * @returns Promise resolving to accessibility nodes with deterministic refs\n */\nexport async function handleAccessibilitySnapshot(\n  input: AccessibilitySnapshotInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<AccessibilitySnapshotResult>> {\n  return runTool<AccessibilitySnapshotInput, AccessibilitySnapshotResult>({\n    toolName: 'mm_accessibility_snapshot',\n    input,\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Execute the accessibility snapshot operation.\n     *\n     * @param context The workflow context containing the page\n     * @returns The result with accessibility nodes and observation data\n     */\n    execute: async (context) => {\n      const { nodes, refMap } = await collectTrimmedA11ySnapshot(\n        context.page,\n        input.rootSelector,\n      );\n\n      getSessionManager().setRefMap(refMap);\n\n      const state = await getSessionManager().getExtensionState();\n      const testIds = await collectTestIds(\n        context.page,\n        OBSERVATION_TESTID_LIMIT,\n      );\n\n      return {\n        result: { nodes },\n        observation: createDefaultObservation(state, testIds, nodes),\n      };\n    },\n\n    classifyError: classifyDiscoveryError,\n\n    /**\n     * Sanitizes input for recording by extracting only the root selector.\n     *\n     * @returns Sanitized input with rootSelector value\n     */\n    sanitizeInputForRecording: () => ({ rootSelector: input.rootSelector }),\n  });\n}\n\n/**\n * Handle getting comprehensive screen state with state, testIds, a11y, and optional screenshot.\n *\n * @param input The input containing screenshot options and selector\n * @param options Optional handler options for the operation\n * @returns Promise resolving to comprehensive screen description with prior knowledge\n */\nexport async function handleDescribeScreen(\n  input: DescribeScreenInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<DescribeScreenResult>> {\n  return runTool<DescribeScreenInput, DescribeScreenResult>({\n    toolName: 'mm_describe_screen',\n    input,\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Execute the describe screen operation.\n     *\n     * @param context The workflow context containing the page\n     * @returns The result with state, testIds, a11y, screenshot, and prior knowledge\n     */\n    execute: async (context) => {\n      const sessionManager = getSessionManager();\n      const { page } = context;\n\n      const state = await sessionManager.getExtensionState();\n      const testIds = await collectTestIds(page, DEFAULT_TESTID_LIMIT);\n      const { nodes, refMap } = await collectTrimmedA11ySnapshot(page);\n\n      sessionManager.setRefMap(refMap);\n\n      let screenshot: DescribeScreenResult['screenshot'] = null;\n\n      if (input.includeScreenshot) {\n        const screenshotName = input.screenshotName ?? 'describe-screen';\n        const result = await sessionManager.screenshot({\n          name: screenshotName,\n          fullPage: true,\n        });\n\n        screenshot = {\n          path: result.path,\n          width: result.width,\n          height: result.height,\n          base64: input.includeScreenshotBase64 ? result.base64 : null,\n        };\n      }\n\n      const sessionMetadata = sessionManager.getSessionMetadata();\n      const priorKnowledgeContext: PriorKnowledgeContext = {\n        currentScreen: state.currentScreen,\n        currentUrl: state.currentUrl,\n        visibleTestIds: testIds,\n        a11yNodes: nodes,\n        currentSessionFlowTags: sessionMetadata?.flowTags,\n      };\n\n      const priorKnowledge = await knowledgeStore.generatePriorKnowledge(\n        priorKnowledgeContext,\n        context.sessionId,\n      );\n\n      const observation = createDefaultObservation(\n        state,\n        testIds,\n        nodes,\n        priorKnowledge,\n      );\n\n      return {\n        result: {\n          state,\n          testIds: { items: testIds },\n          a11y: { nodes },\n          screenshot,\n          priorKnowledge,\n        },\n        observation,\n      };\n    },\n\n    classifyError: classifyDiscoveryError,\n\n    /**\n     * Sanitizes input for recording by extracting screenshot-related parameters.\n     *\n     * @returns Sanitized input with screenshot options\n     */\n    sanitizeInputForRecording: () => ({\n      includeScreenshot: input.includeScreenshot,\n      screenshotName: input.screenshotName,\n    }),\n  });\n}\n"]}