@metamask/client-mcp-core 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeding.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/seeding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,qCAAoC;AAI7E,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,WAAW,EACX,cAAc,EACf,2BAAiB;AAIlB,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AA+CF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAsD1C;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAyD3C;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,CA8ChD;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAuDnD"}

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

@@ -0,0 +1,208 @@
+import { getSessionManager } from "../session-manager.mjs";
+import { classifySeedingError } from "./error-classification.mjs";
+import { runTool } from "./run-tool.mjs";
+import { ErrorCodes } from "../types/index.mjs";
+import { createErrorResponse } from "../utils/index.mjs";
+/**
+ * Validates that the seeding capability is available, returning either the capability or an error response.
+ *
+ * @param toolName The name of the tool requesting the capability
+ * @param input The input provided to the tool
+ * @param options Tool options containing the seeding capability
+ * @param startTime Timestamp when the tool execution started
+ * @returns The seeding capability if available, or an error response if not
+ */
+function checkSeedingCapability(toolName, input, options, startTime) {
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    if (!options?.seedingCapability) {
+        return createErrorResponse(ErrorCodes.MM_CAPABILITY_NOT_AVAILABLE, `ContractSeedingCapability not available. The ${toolName} tool requires running in e2e mode with the MetaMask extension wrapper, which provides Anvil chain and contract deployment support.`, { capability: 'ContractSeedingCapability', input }, sessionId, startTime);
+    }
+    return options.seedingCapability;
+}
+/**
+ * Type guard to check if a result is a ContractSeedingCapability.
+ *
+ * @param result The value to check
+ * @returns True if result is a ContractSeedingCapability, false if it's an error response
+ */
+function isCapability(result) {
+    return (typeof result === 'object' && result !== null && 'deployContract' in result);
+}
+/**
+ * Handles the mm_seed_contract tool to deploy a single smart contract.
+ *
+ * @param input The contract name and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the deployment result with contract address
+ */
+export async function handleSeedContract(input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_seed_contract', input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return runTool({
+        toolName: 'mm_seed_contract',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the contract deployment using the seeding capability.
+         *
+         * @returns The deployed contract details including name, address, and timestamp
+         */
+        execute: async () => {
+            const deployed = await seedingCapability.deployContract(input.contractName, {
+                hardfork: input.hardfork,
+                deployerOptions: input.deployerOptions,
+            });
+            return {
+                contractName: deployed.name,
+                contractAddress: deployed.address,
+                deployedAt: deployed.deployedAt,
+            };
+        },
+        classifyError: classifySeedingError,
+        /**
+         * Sanitizes the input for recording in the knowledge store.
+         *
+         * @returns The sanitized input containing contract name and hardfork
+         */
+        sanitizeInputForRecording: () => ({
+            contractName: input.contractName,
+            hardfork: input.hardfork ?? 'prague',
+        }),
+    });
+}
+/**
+ * Handles the mm_seed_contracts tool to deploy multiple smart contracts.
+ *
+ * @param input The list of contract names and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to deployment results with deployed and failed contracts
+ */
+export async function handleSeedContracts(input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_seed_contracts', input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return runTool({
+        toolName: 'mm_seed_contracts',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the multi-contract deployment using the seeding capability.
+         *
+         * @returns The deployment results with deployed and failed contract lists
+         */
+        execute: async () => {
+            const seedResult = await seedingCapability.deployContracts(input.contracts, { hardfork: input.hardfork });
+            return {
+                deployed: seedResult.deployed.map((deployedContract) => ({
+                    contractName: deployedContract.name,
+                    contractAddress: deployedContract.address,
+                    deployedAt: deployedContract.deployedAt,
+                })),
+                failed: seedResult.failed.map((failedDeployment) => ({
+                    contractName: failedDeployment.name,
+                    error: failedDeployment.error,
+                })),
+            };
+        },
+        classifyError: classifySeedingError,
+        /**
+         * Sanitizes the input for recording in the knowledge store.
+         *
+         * @returns The sanitized input containing contracts list and hardfork
+         */
+        sanitizeInputForRecording: () => ({
+            contracts: input.contracts,
+            hardfork: input.hardfork ?? 'prague',
+        }),
+    });
+}
+/**
+ * Handles the mm_get_contract_address tool to retrieve a deployed contract's address.
+ *
+ * @param input The contract name to look up
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the contract address or null if not found
+ */
+export async function handleGetContractAddress(input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_get_contract_address', input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return runTool({
+        toolName: 'mm_get_contract_address',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the contract address lookup using the seeding capability.
+         *
+         * @returns The contract name and its deployed address
+         */
+        execute: async () => {
+            const address = seedingCapability.getContractAddress(input.contractName);
+            return {
+                contractName: input.contractName,
+                contractAddress: address,
+            };
+        },
+        classifyError: classifySeedingError,
+        /**
+         * Sanitizes the input for recording in the knowledge store.
+         *
+         * @returns The sanitized input containing the contract name
+         */
+        sanitizeInputForRecording: () => ({
+            contractName: input.contractName,
+        }),
+    });
+}
+/**
+ * Handles the mm_list_contracts tool to list all deployed contracts in the session.
+ *
+ * @param _input Unused input parameter (no input required for this tool)
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to a list of all deployed contracts with their addresses
+ */
+export async function handleListDeployedContracts(_input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_list_contracts', _input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return runTool({
+        toolName: 'mm_list_contracts',
+        input: _input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the contract listing using the seeding capability.
+         *
+         * @returns The list of all deployed contracts with their details
+         */
+        execute: async () => {
+            const deployed = seedingCapability.listDeployedContracts();
+            return {
+                contracts: deployed.map((deployedContract) => ({
+                    contractName: deployedContract.name,
+                    contractAddress: deployedContract.address,
+                    deployedAt: deployedContract.deployedAt,
+                })),
+            };
+        },
+        classifyError: classifySeedingError,
+    });
+}
+//# sourceMappingURL=seeding.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeding.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/seeding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,+BAA8B;AAC1D,OAAO,EAAE,oBAAoB,EAAE,mCAAkC;AACjE,OAAO,EAAE,OAAO,EAAE,uBAAsB;AAaxC,OAAO,EAAE,UAAU,EAAE,2BAAiB;AACtC,OAAO,EAAE,mBAAmB,EAAE,2BAAiB;AAM/C;;;;;;;;GAQG;AACH,SAAS,sBAAsB,CAC7B,QAAgB,EAChB,KAAc,EACd,OAAuC,EACvC,SAAiB;IAEjB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,EAAE,CAAC;IAEhD,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;QAChC,OAAO,mBAAmB,CACxB,UAAU,CAAC,2BAA2B,EACtC,gDAAgD,QAAQ,qIAAqI,EAC7L,EAAE,UAAU,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAClD,SAAS,EACT,SAAS,CACW,CAAC;IACzB,CAAC;IAED,OAAO,OAAO,CAAC,iBAAiB,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CACnB,MAAwD;IAExD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,gBAAgB,IAAI,MAAM,CAC5E,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAwB,EACxB,OAA4B;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,iBAAiB,GAAG,sBAAsB,CAC9C,kBAAkB,EAClB,KAAK,EACL,OAAO,EACP,SAAS,CACV,CAAC;IAEF,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IAE5C,OAAO,OAAO,CAAwC;QACpD,QAAQ,EAAE,kBAAkB;QAC5B,KAAK;QACL,OAAO;QACP,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,cAAc,CACrD,KAAK,CAAC,YAAY,EAClB;gBACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,eAAe,EAAE,KAAK,CAAC,eAAe;aACvC,CACF,CAAC;YAEF,OAAO;gBACL,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC3B,eAAe,EAAE,QAAQ,CAAC,OAAO;gBACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,oBAAoB;QAEnC;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ;SACrC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAyB,EACzB,OAA4B;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,iBAAiB,GAAG,sBAAsB,CAC9C,mBAAmB,EACnB,KAAK,EACL,OAAO,EACP,SAAS,CACV,CAAC;IAEF,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IAE5C,OAAO,OAAO,CAA0C;QACtD,QAAQ,EAAE,mBAAmB;QAC7B,KAAK;QACL,OAAO;QACP,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,eAAe,CACxD,KAAK,CAAC,SAAS,EACf,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAC7B,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;oBACvD,YAAY,EAAE,gBAAgB,CAAC,IAAI;oBACnC,eAAe,EAAE,gBAAgB,CAAC,OAAO;oBACzC,UAAU,EAAE,gBAAgB,CAAC,UAAU;iBACxC,CAAC,CAAC;gBACH,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;oBACnD,YAAY,EAAE,gBAAgB,CAAC,IAAI;oBACnC,KAAK,EAAE,gBAAgB,CAAC,KAAK;iBAC9B,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,oBAAoB;QAEnC;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ;SACrC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAA8B,EAC9B,OAA4B;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,iBAAiB,GAAG,sBAAsB,CAC9C,yBAAyB,EACzB,KAAK,EACL,OAAO,EACP,SAAS,CACV,CAAC;IAEF,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IAE5C,OAAO,OAAO,CAAoD;QAChE,QAAQ,EAAE,yBAAyB;QACnC,KAAK;QACL,OAAO;QACP,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,OAAO,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAEzE,OAAO;gBACL,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,eAAe,EAAE,OAAO;aACzB,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,oBAAoB;QAEnC;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAkC,EAClC,OAA4B;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,iBAAiB,GAAG,sBAAsB,CAC9C,mBAAmB,EACnB,MAAM,EACN,OAAO,EACP,SAAS,CACV,CAAC;IAEF,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IAE5C,OAAO,OAAO,CAA0D;QACtE,QAAQ,EAAE,mBAAmB;QAC7B,KAAK,EAAE,MAAM;QACb,OAAO;QACP,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,qBAAqB,EAAE,CAAC;YAE3D,OAAO;gBACL,SAAS,EAAE,QAAQ,CAAC,GAAG,CACrB,CAAC,gBAaA,EAAE,EAAE,CAAC,CAAC;oBACL,YAAY,EAAE,gBAAgB,CAAC,IAAI;oBACnC,eAAe,EAAE,gBAAgB,CAAC,OAAO;oBACzC,UAAU,EAAE,gBAAgB,CAAC,UAAU;iBACxC,CAAC,CACH;aACF,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,oBAAoB;KACpC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { ContractSeedingCapability } from '../../capabilities/types.js';\nimport { getSessionManager } from '../session-manager.js';\nimport { classifySeedingError } from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  SeedContractInput,\n  SeedContractsInput,\n  GetContractAddressInput,\n  ListDeployedContractsInput,\n  SeedContractResult,\n  SeedContractsResult,\n  GetContractAddressResult,\n  ListDeployedContractsResult,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport { createErrorResponse } from '../utils';\n\nexport type SeedingToolOptions = HandlerOptions & {\n  seedingCapability?: ContractSeedingCapability;\n};\n\n/**\n * Validates that the seeding capability is available, returning either the capability or an error response.\n *\n * @param toolName The name of the tool requesting the capability\n * @param input The input provided to the tool\n * @param options Tool options containing the seeding capability\n * @param startTime Timestamp when the tool execution started\n * @returns The seeding capability if available, or an error response if not\n */\nfunction checkSeedingCapability<Type>(\n  toolName: string,\n  input: unknown,\n  options: SeedingToolOptions | undefined,\n  startTime: number,\n): McpResponse<Type> | ContractSeedingCapability {\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n\n  if (!options?.seedingCapability) {\n    return createErrorResponse(\n      ErrorCodes.MM_CAPABILITY_NOT_AVAILABLE,\n      `ContractSeedingCapability not available. The ${toolName} tool requires running in e2e mode with the MetaMask extension wrapper, which provides Anvil chain and contract deployment support.`,\n      { capability: 'ContractSeedingCapability', input },\n      sessionId,\n      startTime,\n    ) as McpResponse<Type>;\n  }\n\n  return options.seedingCapability;\n}\n\n/**\n * Type guard to check if a result is a ContractSeedingCapability.\n *\n * @param result The value to check\n * @returns True if result is a ContractSeedingCapability, false if it's an error response\n */\nfunction isCapability(\n  result: McpResponse<unknown> | ContractSeedingCapability,\n): result is ContractSeedingCapability {\n  return (\n    typeof result === 'object' && result !== null && 'deployContract' in result\n  );\n}\n\n/**\n * Handles the mm_seed_contract tool to deploy a single smart contract.\n *\n * @param input The contract name and deployment options\n * @param options Tool options including seeding capability\n * @returns Promise resolving to the deployment result with contract address\n */\nexport async function handleSeedContract(\n  input: SeedContractInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<SeedContractResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<SeedContractResult>(\n    'mm_seed_contract',\n    input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<SeedContractInput, SeedContractResult>({\n    toolName: 'mm_seed_contract',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the contract deployment using the seeding capability.\n     *\n     * @returns The deployed contract details including name, address, and timestamp\n     */\n    execute: async () => {\n      const deployed = await seedingCapability.deployContract(\n        input.contractName,\n        {\n          hardfork: input.hardfork,\n          deployerOptions: input.deployerOptions,\n        },\n      );\n\n      return {\n        contractName: deployed.name,\n        contractAddress: deployed.address,\n        deployedAt: deployed.deployedAt,\n      };\n    },\n\n    classifyError: classifySeedingError,\n\n    /**\n     * Sanitizes the input for recording in the knowledge store.\n     *\n     * @returns The sanitized input containing contract name and hardfork\n     */\n    sanitizeInputForRecording: () => ({\n      contractName: input.contractName,\n      hardfork: input.hardfork ?? 'prague',\n    }),\n  });\n}\n\n/**\n * Handles the mm_seed_contracts tool to deploy multiple smart contracts.\n *\n * @param input The list of contract names and deployment options\n * @param options Tool options including seeding capability\n * @returns Promise resolving to deployment results with deployed and failed contracts\n */\nexport async function handleSeedContracts(\n  input: SeedContractsInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<SeedContractsResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<SeedContractsResult>(\n    'mm_seed_contracts',\n    input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<SeedContractsInput, SeedContractsResult>({\n    toolName: 'mm_seed_contracts',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the multi-contract deployment using the seeding capability.\n     *\n     * @returns The deployment results with deployed and failed contract lists\n     */\n    execute: async () => {\n      const seedResult = await seedingCapability.deployContracts(\n        input.contracts,\n        { hardfork: input.hardfork },\n      );\n\n      return {\n        deployed: seedResult.deployed.map((deployedContract) => ({\n          contractName: deployedContract.name,\n          contractAddress: deployedContract.address,\n          deployedAt: deployedContract.deployedAt,\n        })),\n        failed: seedResult.failed.map((failedDeployment) => ({\n          contractName: failedDeployment.name,\n          error: failedDeployment.error,\n        })),\n      };\n    },\n\n    classifyError: classifySeedingError,\n\n    /**\n     * Sanitizes the input for recording in the knowledge store.\n     *\n     * @returns The sanitized input containing contracts list and hardfork\n     */\n    sanitizeInputForRecording: () => ({\n      contracts: input.contracts,\n      hardfork: input.hardfork ?? 'prague',\n    }),\n  });\n}\n\n/**\n * Handles the mm_get_contract_address tool to retrieve a deployed contract's address.\n *\n * @param input The contract name to look up\n * @param options Tool options including seeding capability\n * @returns Promise resolving to the contract address or null if not found\n */\nexport async function handleGetContractAddress(\n  input: GetContractAddressInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<GetContractAddressResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<GetContractAddressResult>(\n    'mm_get_contract_address',\n    input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<GetContractAddressInput, GetContractAddressResult>({\n    toolName: 'mm_get_contract_address',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the contract address lookup using the seeding capability.\n     *\n     * @returns The contract name and its deployed address\n     */\n    execute: async () => {\n      const address = seedingCapability.getContractAddress(input.contractName);\n\n      return {\n        contractName: input.contractName,\n        contractAddress: address,\n      };\n    },\n\n    classifyError: classifySeedingError,\n\n    /**\n     * Sanitizes the input for recording in the knowledge store.\n     *\n     * @returns The sanitized input containing the contract name\n     */\n    sanitizeInputForRecording: () => ({\n      contractName: input.contractName,\n    }),\n  });\n}\n\n/**\n * Handles the mm_list_contracts tool to list all deployed contracts in the session.\n *\n * @param _input Unused input parameter (no input required for this tool)\n * @param options Tool options including seeding capability\n * @returns Promise resolving to a list of all deployed contracts with their addresses\n */\nexport async function handleListDeployedContracts(\n  _input: ListDeployedContractsInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<ListDeployedContractsResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<ListDeployedContractsResult>(\n    'mm_list_contracts',\n    _input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<ListDeployedContractsInput, ListDeployedContractsResult>({\n    toolName: 'mm_list_contracts',\n    input: _input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the contract listing using the seeding capability.\n     *\n     * @returns The list of all deployed contracts with their details\n     */\n    execute: async () => {\n      const deployed = seedingCapability.listDeployedContracts();\n\n      return {\n        contracts: deployed.map(\n          (deployedContract: {\n            /**\n             * The contract name\n             */\n            name: string;\n            /**\n             * The contract's deployed address\n             */\n            address: string;\n            /**\n             * The deployment timestamp\n             */\n            deployedAt: string;\n          }) => ({\n            contractName: deployedContract.name,\n            contractAddress: deployedContract.address,\n            deployedAt: deployedContract.deployedAt,\n          }),\n        ),\n      };\n    },\n\n    classifyError: classifySeedingError,\n  });\n}\n"]}

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

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleGetState = handleGetState;
+const error_classification_js_1 = require("./error-classification.cjs");
+const helpers_js_1 = require("./helpers.cjs");
+const run_tool_js_1 = require("./run-tool.cjs");
+const session_manager_js_1 = require("../session-manager.cjs");
+/**
+ * Retrieves the current extension state, using the snapshot capability if available.
+ *
+ * @param page The Playwright page object to query
+ * @param sessionManager The session manager instance
+ * @param stateSnapshotCapability Optional capability for detailed state snapshots
+ * @returns Promise resolving to the current extension state
+ */
+async function getState(page, sessionManager, stateSnapshotCapability) {
+    if (stateSnapshotCapability) {
+        const extensionId = sessionManager.getSessionState()?.extensionId;
+        return stateSnapshotCapability.getState(page, {
+            extensionId,
+            chainId: sessionManager.getSessionState()?.ports?.anvil ? 1337 : 1,
+        });
+    }
+    return sessionManager.getExtensionState();
+}
+/**
+ * Handles the mm_get_state tool to retrieve the current extension state.
+ *
+ * @param options Tool options including optional state snapshot capability
+ * @returns Promise resolving to the current extension state and tab information
+ */
+async function handleGetState(options) {
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_get_state',
+        input: {},
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Executes the state retrieval with tab and observation information.
+         *
+         * @param context The tool execution context containing the page
+         * @returns The extension state, tab information, and observation data
+         */
+        execute: async (context) => {
+            const sessionManager = (0, session_manager_js_1.getSessionManager)();
+            const state = await getState(context.page, sessionManager, options?.stateSnapshotCapability);
+            const trackedPages = sessionManager.getTrackedPages();
+            const activePage = sessionManager.getPage();
+            const activeTabInfo = trackedPages.find((trackedPage) => trackedPage.page === activePage);
+            const tabs = {
+                active: {
+                    role: activeTabInfo?.role ?? 'other',
+                    url: activePage.url(),
+                },
+                tracked: trackedPages.map((trackedPage) => ({
+                    role: trackedPage.role,
+                    url: trackedPage.url,
+                })),
+            };
+            const observation = await (0, helpers_js_1.collectObservation)(context.page, 'full', state);
+            return {
+                result: { state, tabs },
+                observation,
+            };
+        },
+        classifyError: error_classification_js_1.classifyStateError,
+    });
+}
+//# sourceMappingURL=state.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/state.ts"],"names":[],"mappings":";;AAmDA,wCAkDC;AAnGD,wEAA+D;AAC/D,8CAAkD;AAClD,gDAAwC;AAKxC,+DAA0D;AAa1D;;;;;;;GAOG;AACH,KAAK,UAAU,QAAQ,CACrB,IAAU,EACV,cAAoD,EACpD,uBAAiD;IAEjD,IAAI,uBAAuB,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,cAAc,CAAC,eAAe,EAAE,EAAE,WAAW,CAAC;QAClE,OAAO,uBAAuB,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC5C,WAAW;YACX,OAAO,EAAE,cAAc,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,cAAc,CAAC,iBAAiB,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAClC,OAA0B;IAE1B,OAAO,IAAA,qBAAO,EAAwC;QACpD,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,EAAE;QACT,OAAO;QACP,iBAAiB,EAAE,QAAQ;QAE3B;;;;;WAKG;QACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,cAAc,GAAG,IAAA,sCAAiB,GAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAC1B,OAAO,CAAC,IAAI,EACZ,cAAc,EACd,OAAO,EAAE,uBAAuB,CACjC,CAAC;YAEF,MAAM,YAAY,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;YACtD,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CACrC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,UAAU,CACjD,CAAC;YAEF,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE;oBACN,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,OAAO;oBACpC,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE;iBACtB;gBACD,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;oBAC1C,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,GAAG,EAAE,WAAW,CAAC,GAAG;iBACrB,CAAC,CAAC;aACJ,CAAC;YAEF,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAkB,EAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAE1E,OAAO;gBACL,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gBACvB,WAAW;aACZ,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,4CAAkB;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Page } from 'playwright';\n\nimport { classifyStateError } from './error-classification.js';\nimport { collectObservation } from './helpers.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  StateSnapshotCapability,\n  ExtensionState,\n} from '../../capabilities/types.js';\nimport { getSessionManager } from '../session-manager.js';\nimport type { GetStateResult, McpResponse, HandlerOptions } from '../types';\n\n/**\n * Tool options for state-related operations.\n */\nexport type StateToolOptions = HandlerOptions & {\n  /**\n   * Optional capability for taking state snapshots\n   */\n  stateSnapshotCapability?: StateSnapshotCapability;\n};\n\n/**\n * Retrieves the current extension state, using the snapshot capability if available.\n *\n * @param page The Playwright page object to query\n * @param sessionManager The session manager instance\n * @param stateSnapshotCapability Optional capability for detailed state snapshots\n * @returns Promise resolving to the current extension state\n */\nasync function getState(\n  page: Page,\n  sessionManager: ReturnType<typeof getSessionManager>,\n  stateSnapshotCapability?: StateSnapshotCapability,\n): Promise<ExtensionState> {\n  if (stateSnapshotCapability) {\n    const extensionId = sessionManager.getSessionState()?.extensionId;\n    return stateSnapshotCapability.getState(page, {\n      extensionId,\n      chainId: sessionManager.getSessionState()?.ports?.anvil ? 1337 : 1,\n    });\n  }\n  return sessionManager.getExtensionState();\n}\n\n/**\n * Handles the mm_get_state tool to retrieve the current extension state.\n *\n * @param options Tool options including optional state snapshot capability\n * @returns Promise resolving to the current extension state and tab information\n */\nexport async function handleGetState(\n  options?: StateToolOptions,\n): Promise<McpResponse<GetStateResult>> {\n  return runTool<Record<string, never>, GetStateResult>({\n    toolName: 'mm_get_state',\n    input: {},\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Executes the state retrieval with tab and observation information.\n     *\n     * @param context The tool execution context containing the page\n     * @returns The extension state, tab information, and observation data\n     */\n    execute: async (context) => {\n      const sessionManager = getSessionManager();\n      const state = await getState(\n        context.page,\n        sessionManager,\n        options?.stateSnapshotCapability,\n      );\n\n      const trackedPages = sessionManager.getTrackedPages();\n      const activePage = sessionManager.getPage();\n      const activeTabInfo = trackedPages.find(\n        (trackedPage) => trackedPage.page === activePage,\n      );\n\n      const tabs = {\n        active: {\n          role: activeTabInfo?.role ?? 'other',\n          url: activePage.url(),\n        },\n        tracked: trackedPages.map((trackedPage) => ({\n          role: trackedPage.role,\n          url: trackedPage.url,\n        })),\n      };\n\n      const observation = await collectObservation(context.page, 'full', state);\n\n      return {\n        result: { state, tabs },\n        observation,\n      };\n    },\n\n    classifyError: classifyStateError,\n  });\n}\n"]}

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

@@ -0,0 +1,19 @@
+import type { StateSnapshotCapability } from "../../capabilities/types.cjs";
+import type { GetStateResult, McpResponse, HandlerOptions } from "../types/index.cjs";
+/**
+ * Tool options for state-related operations.
+ */
+export type StateToolOptions = HandlerOptions & {
+    /**
+     * Optional capability for taking state snapshots
+     */
+    stateSnapshotCapability?: StateSnapshotCapability;
+};
+/**
+ * Handles the mm_get_state tool to retrieve the current extension state.
+ *
+ * @param options Tool options including optional state snapshot capability
+ * @returns Promise resolving to the current extension state and tab information
+ */
+export declare function handleGetState(options?: StateToolOptions): Promise<McpResponse<GetStateResult>>;
+//# sourceMappingURL=state.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,uBAAuB,EAExB,qCAAoC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,2BAAiB;AAE5E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG;IAC9C;;OAEG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAyBF;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAgDtC"}

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

@@ -0,0 +1,19 @@
+import type { StateSnapshotCapability } from "../../capabilities/types.mjs";
+import type { GetStateResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+/**
+ * Tool options for state-related operations.
+ */
+export type StateToolOptions = HandlerOptions & {
+    /**
+     * Optional capability for taking state snapshots
+     */
+    stateSnapshotCapability?: StateSnapshotCapability;
+};
+/**
+ * Handles the mm_get_state tool to retrieve the current extension state.
+ *
+ * @param options Tool options including optional state snapshot capability
+ * @returns Promise resolving to the current extension state and tab information
+ */
+export declare function handleGetState(options?: StateToolOptions): Promise<McpResponse<GetStateResult>>;
+//# sourceMappingURL=state.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,uBAAuB,EAExB,qCAAoC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,2BAAiB;AAE5E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG;IAC9C;;OAEG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAyBF;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAgDtC"}

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

@@ -0,0 +1,66 @@
+import { classifyStateError } from "./error-classification.mjs";
+import { collectObservation } from "./helpers.mjs";
+import { runTool } from "./run-tool.mjs";
+import { getSessionManager } from "../session-manager.mjs";
+/**
+ * Retrieves the current extension state, using the snapshot capability if available.
+ *
+ * @param page The Playwright page object to query
+ * @param sessionManager The session manager instance
+ * @param stateSnapshotCapability Optional capability for detailed state snapshots
+ * @returns Promise resolving to the current extension state
+ */
+async function getState(page, sessionManager, stateSnapshotCapability) {
+    if (stateSnapshotCapability) {
+        const extensionId = sessionManager.getSessionState()?.extensionId;
+        return stateSnapshotCapability.getState(page, {
+            extensionId,
+            chainId: sessionManager.getSessionState()?.ports?.anvil ? 1337 : 1,
+        });
+    }
+    return sessionManager.getExtensionState();
+}
+/**
+ * Handles the mm_get_state tool to retrieve the current extension state.
+ *
+ * @param options Tool options including optional state snapshot capability
+ * @returns Promise resolving to the current extension state and tab information
+ */
+export async function handleGetState(options) {
+    return runTool({
+        toolName: 'mm_get_state',
+        input: {},
+        options,
+        observationPolicy: 'custom',
+        /**
+         * Executes the state retrieval with tab and observation information.
+         *
+         * @param context The tool execution context containing the page
+         * @returns The extension state, tab information, and observation data
+         */
+        execute: async (context) => {
+            const sessionManager = getSessionManager();
+            const state = await getState(context.page, sessionManager, options?.stateSnapshotCapability);
+            const trackedPages = sessionManager.getTrackedPages();
+            const activePage = sessionManager.getPage();
+            const activeTabInfo = trackedPages.find((trackedPage) => trackedPage.page === activePage);
+            const tabs = {
+                active: {
+                    role: activeTabInfo?.role ?? 'other',
+                    url: activePage.url(),
+                },
+                tracked: trackedPages.map((trackedPage) => ({
+                    role: trackedPage.role,
+                    url: trackedPage.url,
+                })),
+            };
+            const observation = await collectObservation(context.page, 'full', state);
+            return {
+                result: { state, tabs },
+                observation,
+            };
+        },
+        classifyError: classifyStateError,
+    });
+}
+//# sourceMappingURL=state.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,mCAAkC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,sBAAqB;AAClD,OAAO,EAAE,OAAO,EAAE,uBAAsB;AAKxC,OAAO,EAAE,iBAAiB,EAAE,+BAA8B;AAa1D;;;;;;;GAOG;AACH,KAAK,UAAU,QAAQ,CACrB,IAAU,EACV,cAAoD,EACpD,uBAAiD;IAEjD,IAAI,uBAAuB,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,cAAc,CAAC,eAAe,EAAE,EAAE,WAAW,CAAC;QAClE,OAAO,uBAAuB,CAAC,QAAQ,CAAC,IAAI,EAAE;YAC5C,WAAW;YACX,OAAO,EAAE,cAAc,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,cAAc,CAAC,iBAAiB,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA0B;IAE1B,OAAO,OAAO,CAAwC;QACpD,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,EAAE;QACT,OAAO;QACP,iBAAiB,EAAE,QAAQ;QAE3B;;;;;WAKG;QACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAC1B,OAAO,CAAC,IAAI,EACZ,cAAc,EACd,OAAO,EAAE,uBAAuB,CACjC,CAAC;YAEF,MAAM,YAAY,GAAG,cAAc,CAAC,eAAe,EAAE,CAAC;YACtD,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CACrC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,UAAU,CACjD,CAAC;YAEF,MAAM,IAAI,GAAG;gBACX,MAAM,EAAE;oBACN,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,OAAO;oBACpC,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE;iBACtB;gBACD,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;oBAC1C,IAAI,EAAE,WAAW,CAAC,IAAI;oBACtB,GAAG,EAAE,WAAW,CAAC,GAAG;iBACrB,CAAC,CAAC;aACJ,CAAC;YAEF,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAE1E,OAAO;gBACL,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gBACvB,WAAW;aACZ,CAAC;QACJ,CAAC;QAED,aAAa,EAAE,kBAAkB;KAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Page } from 'playwright';\n\nimport { classifyStateError } from './error-classification.js';\nimport { collectObservation } from './helpers.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  StateSnapshotCapability,\n  ExtensionState,\n} from '../../capabilities/types.js';\nimport { getSessionManager } from '../session-manager.js';\nimport type { GetStateResult, McpResponse, HandlerOptions } from '../types';\n\n/**\n * Tool options for state-related operations.\n */\nexport type StateToolOptions = HandlerOptions & {\n  /**\n   * Optional capability for taking state snapshots\n   */\n  stateSnapshotCapability?: StateSnapshotCapability;\n};\n\n/**\n * Retrieves the current extension state, using the snapshot capability if available.\n *\n * @param page The Playwright page object to query\n * @param sessionManager The session manager instance\n * @param stateSnapshotCapability Optional capability for detailed state snapshots\n * @returns Promise resolving to the current extension state\n */\nasync function getState(\n  page: Page,\n  sessionManager: ReturnType<typeof getSessionManager>,\n  stateSnapshotCapability?: StateSnapshotCapability,\n): Promise<ExtensionState> {\n  if (stateSnapshotCapability) {\n    const extensionId = sessionManager.getSessionState()?.extensionId;\n    return stateSnapshotCapability.getState(page, {\n      extensionId,\n      chainId: sessionManager.getSessionState()?.ports?.anvil ? 1337 : 1,\n    });\n  }\n  return sessionManager.getExtensionState();\n}\n\n/**\n * Handles the mm_get_state tool to retrieve the current extension state.\n *\n * @param options Tool options including optional state snapshot capability\n * @returns Promise resolving to the current extension state and tab information\n */\nexport async function handleGetState(\n  options?: StateToolOptions,\n): Promise<McpResponse<GetStateResult>> {\n  return runTool<Record<string, never>, GetStateResult>({\n    toolName: 'mm_get_state',\n    input: {},\n    options,\n    observationPolicy: 'custom',\n\n    /**\n     * Executes the state retrieval with tab and observation information.\n     *\n     * @param context The tool execution context containing the page\n     * @returns The extension state, tab information, and observation data\n     */\n    execute: async (context) => {\n      const sessionManager = getSessionManager();\n      const state = await getState(\n        context.page,\n        sessionManager,\n        options?.stateSnapshotCapability,\n      );\n\n      const trackedPages = sessionManager.getTrackedPages();\n      const activePage = sessionManager.getPage();\n      const activeTabInfo = trackedPages.find(\n        (trackedPage) => trackedPage.page === activePage,\n      );\n\n      const tabs = {\n        active: {\n          role: activeTabInfo?.role ?? 'other',\n          url: activePage.url(),\n        },\n        tracked: trackedPages.map((trackedPage) => ({\n          role: trackedPage.role,\n          url: trackedPage.url,\n        })),\n      };\n\n      const observation = await collectObservation(context.page, 'full', state);\n\n      return {\n        result: { state, tabs },\n        observation,\n      };\n    },\n\n    classifyError: classifyStateError,\n  });\n}\n"]}

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INCLUDED_ROLES = exports.IMPORTANT_ROLES = exports.ACTIONABLE_ROLES = void 0;
+exports.ACTIONABLE_ROLES = [
+    'button',
+    'link',
+    'checkbox',
+    'radio',
+    'switch',
+    'textbox',
+    'combobox',
+    'menuitem',
+];
+exports.IMPORTANT_ROLES = [
+    'dialog',
+    'alert',
+    'status',
+    'heading',
+];
+exports.INCLUDED_ROLES = [
+    ...exports.ACTIONABLE_ROLES,
+    ...exports.IMPORTANT_ROLES,
+];
+//# sourceMappingURL=discovery.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.cjs","sourceRoot":"","sources":["../../../src/mcp-server/types/discovery.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG;IAC9B,QAAQ;IACR,MAAM;IACN,UAAU;IACV,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,UAAU;CACF,CAAC;AAEE,QAAA,eAAe,GAAG;IAC7B,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;CACD,CAAC;AAEE,QAAA,cAAc,GAAG;IAC5B,GAAG,wBAAgB;IACnB,GAAG,uBAAe;CACV,CAAC","sourcesContent":["export const ACTIONABLE_ROLES = [\n  'button',\n  'link',\n  'checkbox',\n  'radio',\n  'switch',\n  'textbox',\n  'combobox',\n  'menuitem',\n] as const;\n\nexport const IMPORTANT_ROLES = [\n  'dialog',\n  'alert',\n  'status',\n  'heading',\n] as const;\n\nexport const INCLUDED_ROLES = [\n  ...ACTIONABLE_ROLES,\n  ...IMPORTANT_ROLES,\n] as const;\n\nexport type ActionableRole = (typeof ACTIONABLE_ROLES)[number];\nexport type ImportantRole = (typeof IMPORTANT_ROLES)[number];\nexport type IncludedRole = (typeof INCLUDED_ROLES)[number];\n\nexport type TestIdItem = {\n  testId: string;\n  tag: string;\n  text?: string;\n  visible: boolean;\n};\n\nexport type A11yNodeTrimmed = {\n  ref: string;\n  role: string;\n  name: string;\n  disabled?: boolean;\n  checked?: boolean;\n  expanded?: boolean;\n  path: string[];\n};\n\nexport type RawA11yNode = {\n  role: string;\n  name?: string;\n  disabled?: boolean;\n  checked?: boolean | 'mixed';\n  expanded?: boolean;\n  children?: RawA11yNode[];\n};\n"]}

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

@@ -0,0 +1,30 @@
+export declare const ACTIONABLE_ROLES: readonly ["button", "link", "checkbox", "radio", "switch", "textbox", "combobox", "menuitem"];
+export declare const IMPORTANT_ROLES: readonly ["dialog", "alert", "status", "heading"];
+export declare const INCLUDED_ROLES: readonly ["button", "link", "checkbox", "radio", "switch", "textbox", "combobox", "menuitem", "dialog", "alert", "status", "heading"];
+export type ActionableRole = (typeof ACTIONABLE_ROLES)[number];
+export type ImportantRole = (typeof IMPORTANT_ROLES)[number];
+export type IncludedRole = (typeof INCLUDED_ROLES)[number];
+export type TestIdItem = {
+    testId: string;
+    tag: string;
+    text?: string;
+    visible: boolean;
+};
+export type A11yNodeTrimmed = {
+    ref: string;
+    role: string;
+    name: string;
+    disabled?: boolean;
+    checked?: boolean;
+    expanded?: boolean;
+    path: string[];
+};
+export type RawA11yNode = {
+    role: string;
+    name?: string;
+    disabled?: boolean;
+    checked?: boolean | 'mixed';
+    expanded?: boolean;
+    children?: RawA11yNode[];
+};
+//# sourceMappingURL=discovery.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/types/discovery.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,+FASnB,CAAC;AAEX,eAAO,MAAM,eAAe,mDAKlB,CAAC;AAEX,eAAO,MAAM,cAAc,uIAGjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC"}

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

@@ -0,0 +1,30 @@
+export declare const ACTIONABLE_ROLES: readonly ["button", "link", "checkbox", "radio", "switch", "textbox", "combobox", "menuitem"];
+export declare const IMPORTANT_ROLES: readonly ["dialog", "alert", "status", "heading"];
+export declare const INCLUDED_ROLES: readonly ["button", "link", "checkbox", "radio", "switch", "textbox", "combobox", "menuitem", "dialog", "alert", "status", "heading"];
+export type ActionableRole = (typeof ACTIONABLE_ROLES)[number];
+export type ImportantRole = (typeof IMPORTANT_ROLES)[number];
+export type IncludedRole = (typeof INCLUDED_ROLES)[number];
+export type TestIdItem = {
+    testId: string;
+    tag: string;
+    text?: string;
+    visible: boolean;
+};
+export type A11yNodeTrimmed = {
+    ref: string;
+    role: string;
+    name: string;
+    disabled?: boolean;
+    checked?: boolean;
+    expanded?: boolean;
+    path: string[];
+};
+export type RawA11yNode = {
+    role: string;
+    name?: string;
+    disabled?: boolean;
+    checked?: boolean | 'mixed';
+    expanded?: boolean;
+    children?: RawA11yNode[];
+};
+//# sourceMappingURL=discovery.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/types/discovery.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,+FASnB,CAAC;AAEX,eAAO,MAAM,eAAe,mDAKlB,CAAC;AAEX,eAAO,MAAM,cAAc,uIAGjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC"}

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

@@ -0,0 +1,21 @@
+export const ACTIONABLE_ROLES = [
+    'button',
+    'link',
+    'checkbox',
+    'radio',
+    'switch',
+    'textbox',
+    'combobox',
+    'menuitem',
+];
+export const IMPORTANT_ROLES = [
+    'dialog',
+    'alert',
+    'status',
+    'heading',
+];
+export const INCLUDED_ROLES = [
+    ...ACTIONABLE_ROLES,
+    ...IMPORTANT_ROLES,
+];
+//# sourceMappingURL=discovery.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.mjs","sourceRoot":"","sources":["../../../src/mcp-server/types/discovery.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ;IACR,MAAM;IACN,UAAU;IACV,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,gBAAgB;IACnB,GAAG,eAAe;CACV,CAAC","sourcesContent":["export const ACTIONABLE_ROLES = [\n  'button',\n  'link',\n  'checkbox',\n  'radio',\n  'switch',\n  'textbox',\n  'combobox',\n  'menuitem',\n] as const;\n\nexport const IMPORTANT_ROLES = [\n  'dialog',\n  'alert',\n  'status',\n  'heading',\n] as const;\n\nexport const INCLUDED_ROLES = [\n  ...ACTIONABLE_ROLES,\n  ...IMPORTANT_ROLES,\n] as const;\n\nexport type ActionableRole = (typeof ACTIONABLE_ROLES)[number];\nexport type ImportantRole = (typeof IMPORTANT_ROLES)[number];\nexport type IncludedRole = (typeof INCLUDED_ROLES)[number];\n\nexport type TestIdItem = {\n  testId: string;\n  tag: string;\n  text?: string;\n  visible: boolean;\n};\n\nexport type A11yNodeTrimmed = {\n  ref: string;\n  role: string;\n  name: string;\n  disabled?: boolean;\n  checked?: boolean;\n  expanded?: boolean;\n  path: string[];\n};\n\nexport type RawA11yNode = {\n  role: string;\n  name?: string;\n  disabled?: boolean;\n  checked?: boolean | 'mixed';\n  expanded?: boolean;\n  children?: RawA11yNode[];\n};\n"]}

package/dist/mcp-server/types/errors.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCodes = void 0;
+exports.ErrorCodes = {
+    MM_BUILD_FAILED: 'MM_BUILD_FAILED',
+    MM_DEPENDENCIES_MISSING: 'MM_DEPENDENCIES_MISSING',
+    MM_SESSION_ALREADY_RUNNING: 'MM_SESSION_ALREADY_RUNNING',
+    MM_NO_ACTIVE_SESSION: 'MM_NO_ACTIVE_SESSION',
+    MM_PAGE_CLOSED: 'MM_PAGE_CLOSED',
+    MM_LAUNCH_FAILED: 'MM_LAUNCH_FAILED',
+    MM_INVALID_CONFIG: 'MM_INVALID_CONFIG',
+    MM_INVALID_INPUT: 'MM_INVALID_INPUT',
+    MM_PORT_IN_USE: 'MM_PORT_IN_USE',
+    MM_NAVIGATION_FAILED: 'MM_NAVIGATION_FAILED',
+    MM_NOTIFICATION_TIMEOUT: 'MM_NOTIFICATION_TIMEOUT',
+    MM_TARGET_NOT_FOUND: 'MM_TARGET_NOT_FOUND',
+    MM_CLICK_FAILED: 'MM_CLICK_FAILED',
+    MM_TYPE_FAILED: 'MM_TYPE_FAILED',
+    MM_WAIT_TIMEOUT: 'MM_WAIT_TIMEOUT',
+    MM_SCREENSHOT_FAILED: 'MM_SCREENSHOT_FAILED',
+    MM_DISCOVERY_FAILED: 'MM_DISCOVERY_FAILED',
+    MM_STATE_FAILED: 'MM_STATE_FAILED',
+    MM_KNOWLEDGE_ERROR: 'MM_KNOWLEDGE_ERROR',
+    MM_SEED_FAILED: 'MM_SEED_FAILED',
+    MM_CONTRACT_NOT_FOUND: 'MM_CONTRACT_NOT_FOUND',
+    MM_TAB_NOT_FOUND: 'MM_TAB_NOT_FOUND',
+    MM_CAPABILITY_NOT_AVAILABLE: 'MM_CAPABILITY_NOT_AVAILABLE',
+    MM_CONTEXT_SWITCH_BLOCKED: 'MM_CONTEXT_SWITCH_BLOCKED',
+    MM_SET_CONTEXT_FAILED: 'MM_SET_CONTEXT_FAILED',
+    MM_UNKNOWN_TOOL: 'MM_UNKNOWN_TOOL',
+    MM_INTERNAL_ERROR: 'MM_INTERNAL_ERROR',
+};
+//# sourceMappingURL=errors.cjs.map

package/dist/mcp-server/types/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sourceRoot":"","sources":["../../../src/mcp-server/types/errors.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACxB,eAAe,EAAE,iBAAiB;IAClC,uBAAuB,EAAE,yBAAyB;IAElD,0BAA0B,EAAE,4BAA4B;IACxD,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IAEpC,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAEhC,oBAAoB,EAAE,sBAAsB;IAC5C,uBAAuB,EAAE,yBAAyB;IAElD,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAElC,oBAAoB,EAAE,sBAAsB;IAE5C,mBAAmB,EAAE,qBAAqB;IAC1C,eAAe,EAAE,iBAAiB;IAElC,kBAAkB,EAAE,oBAAoB;IAExC,cAAc,EAAE,gBAAgB;IAChC,qBAAqB,EAAE,uBAAuB;IAE9C,gBAAgB,EAAE,kBAAkB;IAEpC,2BAA2B,EAAE,6BAA6B;IAE1D,yBAAyB,EAAE,2BAA2B;IACtD,qBAAqB,EAAE,uBAAuB;IAE9C,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC","sourcesContent":["export const ErrorCodes = {\n  MM_BUILD_FAILED: 'MM_BUILD_FAILED',\n  MM_DEPENDENCIES_MISSING: 'MM_DEPENDENCIES_MISSING',\n\n  MM_SESSION_ALREADY_RUNNING: 'MM_SESSION_ALREADY_RUNNING',\n  MM_NO_ACTIVE_SESSION: 'MM_NO_ACTIVE_SESSION',\n  MM_PAGE_CLOSED: 'MM_PAGE_CLOSED',\n  MM_LAUNCH_FAILED: 'MM_LAUNCH_FAILED',\n\n  MM_INVALID_CONFIG: 'MM_INVALID_CONFIG',\n  MM_INVALID_INPUT: 'MM_INVALID_INPUT',\n  MM_PORT_IN_USE: 'MM_PORT_IN_USE',\n\n  MM_NAVIGATION_FAILED: 'MM_NAVIGATION_FAILED',\n  MM_NOTIFICATION_TIMEOUT: 'MM_NOTIFICATION_TIMEOUT',\n\n  MM_TARGET_NOT_FOUND: 'MM_TARGET_NOT_FOUND',\n  MM_CLICK_FAILED: 'MM_CLICK_FAILED',\n  MM_TYPE_FAILED: 'MM_TYPE_FAILED',\n  MM_WAIT_TIMEOUT: 'MM_WAIT_TIMEOUT',\n\n  MM_SCREENSHOT_FAILED: 'MM_SCREENSHOT_FAILED',\n\n  MM_DISCOVERY_FAILED: 'MM_DISCOVERY_FAILED',\n  MM_STATE_FAILED: 'MM_STATE_FAILED',\n\n  MM_KNOWLEDGE_ERROR: 'MM_KNOWLEDGE_ERROR',\n\n  MM_SEED_FAILED: 'MM_SEED_FAILED',\n  MM_CONTRACT_NOT_FOUND: 'MM_CONTRACT_NOT_FOUND',\n\n  MM_TAB_NOT_FOUND: 'MM_TAB_NOT_FOUND',\n\n  MM_CAPABILITY_NOT_AVAILABLE: 'MM_CAPABILITY_NOT_AVAILABLE',\n\n  MM_CONTEXT_SWITCH_BLOCKED: 'MM_CONTEXT_SWITCH_BLOCKED',\n  MM_SET_CONTEXT_FAILED: 'MM_SET_CONTEXT_FAILED',\n\n  MM_UNKNOWN_TOOL: 'MM_UNKNOWN_TOOL',\n  MM_INTERNAL_ERROR: 'MM_INTERNAL_ERROR',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];\n"]}