feat(core): Add special @tool displayOption

[CharlieKolb]

Summary

Add a new @tool option to displayOptions: { show: { '@tool': [true] } } which shows the property based on whether the node is being used as a tool.

Had to expose the nodeDescription to workflow/NodeHelpers for this, unfortunately not all calls provide the parameters via the nodeType, so I couldn't replace that argument with the description and had to add a new one instead.

Took the chance to refactor all the optional parameters on getNodeParameters into an options bag.

Test property:

{
		displayName: 'Alive',
		type: 'notice',
		name: 'alive',
		default: 'hello',
		displayOptions: {
			show: {
				'@tool': [true],
			},
		},
	},

Remember to add usableAsTool to the node you add this in if it doesn't already have it.

Related Linear tickets, Github issues, and Community forum posts

https://linear.app/n8n/issue/ADO-3389/add-tool-displayoption

Review / Merge checklist

• PR title and summary are descriptive. (conventions)
• Docs updated or follow-up ticket created.
• Tests included.
• PR Labeled with release/backport (if the PR is an urgent fix that needs to be backported)

[CharlieKolb]

On second thought this might be considered a breaking change? At least for consumers of our code base. Do we care?

[CharlieKolb]

This seemed to set onlySimpleTypes to undefined rather than the default false. Old signature:

	node: Pick<INode, 'typeVersion'> | null,
	onlySimpleTypes = false,
	dataIsResolved = false,
	nodeValuesRoot?: INodeParameters,
	parentType?: string,
	parameterDependencies?: IParameterDependencies,
): INodeParameters | null {

Only usage in the body is if (onlySimpleTypes) { so this should be safe to drop.

[CharlieKolb]

I only saw the NodeHelpers.conditions.test.ts file after this, which does also test this function indirectly. There's some overlap especially for show, but besides @tool tests these do cover other edge cases like using nodeValuesRoot as well, would like to keep them.

[codecov]

Codecov Report

Attention: Patch coverage is 70.73171% with 12 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...frontend/editor-ui/src/components/NodeSettings.vue	0.00%	5 Missing ⚠️
...ontend/editor-ui/src/composables/useNodeHelpers.ts	76.92%	3 Missing ⚠️
...i/src/components/CredentialEdit/CredentialEdit.vue	0.00%	1 Missing ⚠️
...ontend/editor-ui/src/components/ParameterInput.vue	0.00%	1 Missing ⚠️
...s/frontend/editor-ui/src/stores/workflows.store.ts	0.00%	1 Missing ⚠️
...ontend/editor-ui/src/utils/nodes/nodeTransforms.ts	88.88%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!