n8n 2.41.2 → 2.42.0

package/dist/modules/mcp/tools/save-user-preference.tool.js

@@ -0,0 +1,261 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSaveUserPreferenceTool = void 0;
+const api_types_1 = require("@n8n/api-types");
+const permissions_1 = require("@n8n/permissions");
+const telemetry_1 = require("@n8n/telemetry");
+const is_record_1 = require("@n8n/utils/is-record");
+const lazy_import_1 = require("@n8n/utils/lazy-import");
+const zod_1 = __importDefault(require("zod"));
+const ai_preference_write_1 = require("../../../services/ai-preference-write");
+const mcp_constants_1 = require("../mcp.constants");
+const user_preference_tool_utils_1 = require("./user-preference-tool.utils");
+const DESCRIPTION = [
+    'Saves a preference about how the user likes to work with n8n, so the n8n assistant and every connected AI tool apply it from now on: node and credential choices, naming, how work is organised, patterns to avoid.',
+    'Call this only for a durable preference the user states about their way of working, such as "always add an error workflow" or "name nodes in English". Do not call it for an instruction that applies to the current task only, such as "make this one a POST request", and do not infer a preference the user did not state.',
+    `Read ${mcp_constants_1.MCP_GET_USER_PREFERENCES_TOOL_NAME} first. If a saved preference already covers the same ground, call ${mcp_constants_1.MCP_UPDATE_USER_PREFERENCE_TOOL_NAME} with its id instead of saving a near-duplicate; saving the exact same text again is refused.`,
+    `The preference is saved at once, without a confirmation step. In the same turn, tell the user the exact text that was saved and give them the settings link from the result, so they can check it. If they want it changed, call ${mcp_constants_1.MCP_UPDATE_USER_PREFERENCE_TOOL_NAME}; if they want it gone, call ${mcp_constants_1.MCP_UNDO_USER_PREFERENCE_TOOL_NAME}.`,
+].join('\n\n');
+const REVIEW_KEY = 'review';
+const inputSchema = {
+    content: api_types_1.aiPreferenceContentSchema,
+};
+const outputSchema = {
+    saved: zod_1.default
+        .boolean()
+        .describe('True when a preference is saved when this call returns. False when nothing is.'),
+    preference: user_preference_tool_utils_1.savedPreferenceSchema
+        .optional()
+        .describe('The preference as saved. Absent when `saved` is false.'),
+    removed: zod_1.default
+        .boolean()
+        .optional()
+        .describe('True when the user declined the review form that followed the write.'),
+    error: zod_1.default.string().optional().describe('Set when the write or the review failed.'),
+    reason: zod_1.default
+        .enum(user_preference_tool_utils_1.PREFERENCE_WRITE_REASONS)
+        .optional()
+        .describe('Why the write was refused. `duplicate`: the same text is saved already, read the preferences and update that one. `scope_full`: the user has to remove a preference first. Do not retry the same call.'),
+};
+const reviewFormSchema = zod_1.default.object({
+    text: zod_1.default.string().optional(),
+    scope: zod_1.default.enum(['user', 'instance']).optional(),
+});
+const SCOPE_LABELS = {
+    user: 'Just you, in every project',
+    instance: 'Everyone on this n8n instance',
+};
+function supportsFormElicitation(capabilities) {
+    const elicitation = (0, is_record_1.isRecord)(capabilities) ? capabilities.elicitation : undefined;
+    if (!(0, is_record_1.isRecord)(elicitation))
+        return false;
+    return 'form' in elicitation || !('url' in elicitation);
+}
+const createSaveUserPreferenceTool = (user, aiPreferenceService, telemetry, urlService, logger) => ({
+    name: mcp_constants_1.MCP_SAVE_USER_PREFERENCE_TOOL_NAME,
+    config: {
+        description: DESCRIPTION,
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: 'Save User Preference',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    },
+    handler: async ({ content }, extra) => {
+        const { inputRequired, inputResponse, CLIENT_CAPABILITIES_META_KEY } = await (0, lazy_import_1.lazyImport)(async () => await import('@modelcontextprotocol/server'));
+        const ctx = (extra ?? {});
+        const canElicit = supportsFormElicitation(ctx.mcpReq?.envelope?.[CLIENT_CAPABILITIES_META_KEY]);
+        const review = inputResponse(ctx.mcpReq?.inputResponses, REVIEW_KEY);
+        const url = (0, user_preference_tool_utils_1.preferencesSettingsUrl)(urlService);
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: mcp_constants_1.MCP_SAVE_USER_PREFERENCE_TOOL_NAME,
+            parameters: { text_length: content.length, can_elicit: canElicit },
+        };
+        const done = (output, text, isError = false) => {
+            telemetryPayload.results = isError
+                ? { success: false, error: output.error, data: { reason: output.reason } }
+                : {
+                    success: true,
+                    data: {
+                        saved: output.saved,
+                        removed: output.removed ?? false,
+                        review: review.kind === 'elicit' ? review.action : 'none',
+                    },
+                };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            return {
+                content: [{ type: 'text', text }],
+                structuredContent: output,
+                ...(isError ? { isError: true } : {}),
+            };
+        };
+        const savedResult = (preference, lead) => done({ saved: true, preference: (0, user_preference_tool_utils_1.toSavedPreferenceOutput)(preference, url) }, `${lead} Saved text: "${preference.content}". Tell the user this is what was saved and that they can review it at ${url}.`);
+        const applyReview = async (id, answer) => {
+            const keep = `Tell the user the preference stays as saved and that they can review it at ${url}.`;
+            if (answer.action === 'cancel') {
+                return done({ saved: true, preference: { id, scope: 'user', text: content, url } }, `The user closed the review without changing the preference. Saved text: "${content}". ${keep}`);
+            }
+            const form = reviewFormSchema.safeParse(answer.content ?? {});
+            const wantsRemoval = answer.action === 'decline';
+            const editedText = form.success ? form.data.text?.trim() : undefined;
+            const chosenScope = form.success ? form.data.scope : undefined;
+            const movedScope = chosenScope && chosenScope !== 'user' ? chosenScope : undefined;
+            if (wantsRemoval) {
+                try {
+                    const removed = await aiPreferenceService.undoWrite(user, id, 'mcp');
+                    telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_DELETED_PREFERENCES, {
+                        count: 1,
+                        source: 'rejected',
+                        scope_types: ['user'],
+                        surface: 'mcp',
+                        seconds_since_saved: (0, user_preference_tool_utils_1.secondsSinceSaved)(removed),
+                    });
+                    telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.PREFERENCE_CONFIRMATION_RESOLVED, {
+                        surface: 'mcp',
+                        outcome: 'rejected',
+                        scope_type: 'user',
+                        text_length: removed.content.length,
+                    });
+                    return done({ saved: false, removed: true }, 'The user removed the preference in the review. Nothing is saved now. Do not save it again unless they ask.');
+                }
+                catch (error) {
+                    const { reason, message } = (0, user_preference_tool_utils_1.classifyPreferenceWriteError)(error);
+                    return done({ saved: true, error: message, reason }, `The user asked to remove the preference but the removal failed: ${message}. The preference is still saved. ${keep}`, true);
+                }
+            }
+            const changedText = editedText && editedText !== content ? editedText : undefined;
+            if (changedText ?? movedScope) {
+                const text = changedText ?? content;
+                const parsed = api_types_1.aiPreferenceContentSchema.safeParse(text);
+                if (!parsed.success) {
+                    const message = `The edited text is longer than ${api_types_1.AI_PREFERENCE_CONTENT_MAX_LENGTH} characters.`;
+                    telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.PREFERENCE_WRITE_REJECTED, {
+                        surface: 'mcp',
+                        reason: 'too_long',
+                        scope_type: 'user',
+                        text_length: text.length,
+                    });
+                    return done({
+                        saved: true,
+                        preference: { id, scope: 'user', text: content, url },
+                        error: message,
+                        reason: 'too_long',
+                    }, `The user edited the preference but the edit was refused: ${message} The original text is still saved: "${content}". ${keep}`, true);
+                }
+                try {
+                    const updated = movedScope
+                        ? await aiPreferenceService.update(user, id, {
+                            content: parsed.data,
+                            scope: movedScope,
+                            userId: null,
+                            projectId: null,
+                        })
+                        : await aiPreferenceService.updateContent(user, id, parsed.data);
+                    telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.PREFERENCE_CONFIRMATION_RESOLVED, {
+                        surface: 'mcp',
+                        outcome: 'accepted_after_edit',
+                        scope_type: movedScope ?? 'user',
+                        text_length: updated.content.length,
+                    });
+                    telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_UPDATED_PREFERENCE, {
+                        scope_type: movedScope ?? 'user',
+                        text_length: updated.content.length,
+                        scope_changed: movedScope !== undefined,
+                        surface: 'mcp',
+                    });
+                    if (movedScope) {
+                        telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.PREFERENCE_SCOPE_ACCEPTED, {
+                            surface: 'mcp',
+                            offered_scope: 'user',
+                            accepted_scope: movedScope,
+                            scope_changed: true,
+                        });
+                    }
+                    return savedResult(updated, movedScope
+                        ? `The user moved the preference to: ${SCOPE_LABELS[movedScope]}.`
+                        : 'The user edited the preference in the review.');
+                }
+                catch (error) {
+                    const { reason, message } = (0, user_preference_tool_utils_1.classifyPreferenceWriteError)(error);
+                    return done({
+                        saved: true,
+                        preference: { id, scope: 'user', text: content, url },
+                        error: message,
+                        reason,
+                    }, `The user changed the preference but the change was refused: ${message}. It is still saved as "${content}", for the user only. ${keep}`, true);
+                }
+            }
+            return done({ saved: true, preference: { id, scope: 'user', text: content, url } }, `The user kept the preference as saved. Saved text: "${content}". ${keep}`);
+        };
+        if (review.kind === 'elicit') {
+            const id = ctx.mcpReq?.requestState?.();
+            if (!(typeof id === 'string' && zod_1.default.string().uuid().safeParse(id).success)) {
+                return done({
+                    saved: true,
+                    error: 'The review answer could not be matched to the saved preference.',
+                }, `The preference was saved, but the review answer could not be matched to it. Read ${mcp_constants_1.MCP_GET_USER_PREFERENCES_TOOL_NAME} to find it, and tell the user it is saved at ${url}.`);
+            }
+            return await applyReview(id, review);
+        }
+        const written = await (0, ai_preference_write_1.writeAssistantPreference)({
+            aiPreferenceService,
+            telemetry,
+            logger,
+            user,
+            surface: 'mcp',
+            content,
+            scope: 'user',
+        });
+        if (!written.ok) {
+            return done({ saved: false, error: written.message, reason: written.reason }, `Nothing was saved: ${written.message}. Do not call this tool again with the same text.`, true);
+        }
+        const { preference } = written;
+        if (!canElicit)
+            return savedResult(preference, 'Preference saved.');
+        const scopeChoices = (0, permissions_1.hasGlobalScope)(user, 'aiPreference:create')
+            ? ['user', 'instance']
+            : ['user'];
+        return inputRequired({
+            inputRequests: {
+                [REVIEW_KEY]: inputRequired.elicit({
+                    message: `Saved to your n8n preferences. Accept to keep it, or Decline to delete it.\n\n"${preference.content}"\n\nFrom now on, the n8n assistant and your connected AI tools follow this preference. To change it, edit the text${scopeChoices.length > 1 ? ' or who it applies to' : ''}, then accept. If you close this, the preference stays saved.\n\nYou can change or delete it anytime in n8n under Settings > Context > Preferences. To stop this tool from saving preferences, connect it again without the "Save, update and undo AI preferences" permission.`,
+                    requestedSchema: {
+                        type: 'object',
+                        properties: {
+                            text: {
+                                type: 'string',
+                                title: 'Preference',
+                                description: "Edit the text to change what's saved.",
+                                default: preference.content,
+                                maxLength: api_types_1.AI_PREFERENCE_CONTENT_MAX_LENGTH,
+                            },
+                            ...(scopeChoices.length > 1
+                                ? {
+                                    scope: {
+                                        type: 'string',
+                                        title: 'Apply this to',
+                                        description: 'Who follows this preference. It is saved for you; change this to share it.',
+                                        enum: [...scopeChoices],
+                                        enumNames: scopeChoices.map((choice) => SCOPE_LABELS[choice]),
+                                        default: 'user',
+                                    },
+                                }
+                                : {}),
+                        },
+                    },
+                }),
+            },
+            requestState: preference.id,
+        });
+    },
+});
+exports.createSaveUserPreferenceTool = createSaveUserPreferenceTool;
+//# sourceMappingURL=save-user-preference.tool.js.map

package/dist/modules/mcp/tools/save-user-preference.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-user-preference.tool.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/save-user-preference.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/mcp/tools/search-folders.tool.js

@@ -7,6 +7,7 @@ exports.createSearchFoldersTool = void 0;
 const zod_1 = __importDefault(require("zod"));
 const mcp_constants_1 = require("../mcp.constants");
 const schemas_1 = require("./schemas");
+const tool_error_utils_1 = require("./tool-error.utils");
 const MAX_RESULTS = 100;
 const inputSchema = {
     projectId: zod_1.default.string().describe('The ID of the project to search folders in'),
@@ -89,18 +90,11 @@ const createSearchFoldersTool = (user, folderService, projectService, telemetry)
             };
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            telemetryPayload.results = {
-                success: false,
-                error: errorMessage,
-            };
-            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
-            const output = { data: [], count: 0, error: errorMessage };
-            return {
-                content: [{ type: 'text', text: JSON.stringify(output) }],
-                structuredContent: output,
-                isError: true,
-            };
+            return (0, tool_error_utils_1.trackAndReturnToolError)(telemetry, telemetryPayload, error, (message) => ({
+                data: [],
+                count: 0,
+                error: message,
+            }));
         }
     },
 });

package/dist/modules/mcp/tools/search-folders.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-folders.tool.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/search-folders.tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search-folders.tool.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/search-folders.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/mcp/tools/search-projects.tool.js

@@ -7,6 +7,7 @@ exports.createSearchProjectsTool = void 0;
 const zod_1 = __importDefault(require("zod"));
 const mcp_constants_1 = require("../mcp.constants");
 const schemas_1 = require("./schemas");
+const tool_error_utils_1 = require("./tool-error.utils");
 const MAX_RESULTS = 100;
 const inputSchema = {
     query: zod_1.default
@@ -124,18 +125,11 @@ const createSearchProjectsTool = (user, projectRepository, licenseState, telemet
             };
         }
         catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            telemetryPayload.results = {
-                success: false,
-                error: errorMessage,
-            };
-            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
-            const output = { data: [], count: 0, error: errorMessage };
-            return {
-                content: [{ type: 'text', text: JSON.stringify(output) }],
-                structuredContent: output,
-                isError: true,
-            };
+            return (0, tool_error_utils_1.trackAndReturnToolError)(telemetry, telemetryPayload, error, (message) => ({
+                data: [],
+                count: 0,
+                error: message,
+            }));
         }
     },
 });

package/dist/modules/mcp/tools/search-projects.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-projects.tool.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/search-projects.tool.ts"],"names":[],"mappings":";;;;;;AAEA,8CAAoB;AAIpB,oDAA8D;AAE9D,uCAA8C;AAE9C,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,WAAW,GAAG;IACnB,KAAK,EAAE,aAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,gMAAgM,CAChM;IACF,IAAI,EAAE,aAAC;SACL,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;SAC1B,QAAQ,EAAE;SACV,QAAQ,CACR,4FAA4F,CAC5F;IACF,KAAK,EAAE,IAAA,2BAAiB,EAAC,WAAW,CAAC;CACb,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,IAAI,EAAE,aAAC;SACL,KAAK,CACL,aAAC,CAAC,MAAM,CAAC;QACR,EAAE,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC/D,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACpD,IAAI,EAAE,aAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACrF,SAAS,EAAE,aAAC;aACV,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;aAC1B,QAAQ,EAAE;aACV,QAAQ,CACR,qIAAqI,CACrI;KACF,CAAC,CACF;SACA,QAAQ,CACR,wFAAwF,CACxF;IACF,KAAK,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC5E,mBAAmB,EAAE,aAAC;SACpB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACR,uWAAuW,CACvW;IACF,IAAI,EAAE,aAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,gRAAgR,CAChR;CACsB,CAAC;AAEnB,MAAM,wBAAwB,GAAG,CACvC,IAAU,EACV,iBAAoC,EACpC,YAA0B,EAC1B,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE;QACP,WAAW,EACV,sqBAAsqB;QACvqB,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EACf,KAAK,EACL,IAAI,EACJ,KAAK,GAAG,WAAW,GAKnB,EAAE,EAAE;QACJ,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,iBAAiB;YAC5B,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;SAClC,CAAC;QAEF,MAAM,mBAAmB,GAAG,YAAY,CAAC,sBAAsB,EAAE,CAAC;QAElE,IAAI,CAAC;YACJ,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;YACjE,MAAM,YAAY,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;YACnC,MAAM,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACnE,iBAAiB,CAAC,6BAA6B,CAAC,IAAI,CAAC,EAAE,EAAE;oBACxD,MAAM,EAAE,YAAY;oBACpB,IAAI;oBACJ,IAAI,EAAE,cAAc;iBACpB,CAAC;gBACF,YAAY;oBACX,CAAC,CAAC,iBAAiB,CAAC,gCAAgC,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC;oBACjF,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;aACtB,CAAC,CAAC;YAGH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7D,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9E,MAAM,cAAc,GAAG,CAAC,GAAG,kBAAkB,EAAE,GAAG,eAAe,CAAC,CAAC;YAEnE,MAAM,eAAe,GAAG,YAAY,EAAE,WAAW,EAAE,CAAC;YACpD,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACvD,OAAO;gBACP,OAAO,EACN,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,eAAe;aACvF,CAAC,CAAC,CAAC;YAGJ,IAAI,eAAe,EAAE,CAAC;gBACrB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBAC5B,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;wBAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACvD,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrD,CAAC,CAAC,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YAE9D,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;gBACvD,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxE,IAAI,CAAC,eAAe;oBAAE,OAAO,IAAI,CAAC;gBAClC,MAAM,SAAS,GAAwB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrE,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACxF,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,eAAe,EAAE,CAAC;gBACrB,IAAI,eAAe,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CACT,uBAAuB,KAAK,MAAM,KAAK,2HAA2H,CAClK,CAAC;gBACH,CAAC;qBAAM,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;oBAChC,KAAK,CAAC,IAAI,CACT,gCAAgC,KAAK,iGAAiG,CACtI,CAAC;gBACH,CAAC;YACF,CAAC;YACD,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CACT,yOAAyO,CACzO,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAE5D,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,KAAK,EAAE;aACf,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/E,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,iBAAiB,EAAE,MAAM;aACzB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY;aACnB,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;YAC3D,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,iBAAiB,EAAE,MAAM;gBACzB,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AA/HU,QAAA,wBAAwB,GAAxB,wBAAwB,CA+HlC"}
+{"version":3,"file":"search-projects.tool.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/search-projects.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/mcp/tools/tool-error.utils.d.ts

@@ -0,0 +1,11 @@
+import type { Telemetry } from '../../../telemetry';
+import type { UserCalledMCPToolEventPayload } from '../mcp.types';
+export declare function trackAndReturnToolError(telemetry: Telemetry, telemetryPayload: UserCalledMCPToolEventPayload, error: unknown, formatOutput?: (message: string) => Record<string, unknown>): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    structuredContent: Record<string, unknown>;
+    isError: boolean;
+};
+export declare function trackAndRethrowToolError(telemetry: Telemetry, telemetryPayload: UserCalledMCPToolEventPayload, error: unknown): never;

package/dist/modules/mcp/tools/tool-error.utils.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackAndReturnToolError = trackAndReturnToolError;
+exports.trackAndRethrowToolError = trackAndRethrowToolError;
+const get_error_message_1 = require("@n8n/utils/errors/get-error-message");
+const mcp_constants_1 = require("../mcp.constants");
+function trackAndReturnToolError(telemetry, telemetryPayload, error, formatOutput = (message) => ({ error: message })) {
+    const errorMessage = (0, get_error_message_1.getErrorMessage)(error);
+    telemetryPayload.results = { success: false, error: errorMessage };
+    telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+    const output = formatOutput(errorMessage);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(output) }],
+        structuredContent: output,
+        isError: true,
+    };
+}
+function trackAndRethrowToolError(telemetry, telemetryPayload, error) {
+    telemetryPayload.results = {
+        success: false,
+        error: (0, get_error_message_1.getErrorMessage)(error),
+    };
+    telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+    throw error;
+}
+//# sourceMappingURL=tool-error.utils.js.map

package/dist/modules/mcp/tools/tool-error.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.utils.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/tool-error.utils.ts"],"names":[],"mappings":";;;;AAAA,2EAAsE;AAItE,oDAA8D;AAG9D,iCACC,SAAoB,EACpB,gBAA+C,EAC/C,KAAc,EACd,YAAY,GAAiD,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAE9F,MAAM,YAAY,GAAG,IAAA,mCAAe,EAAC,KAAK,CAAC,CAAC;IAC5C,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IACnE,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,iBAAiB,EAAE,MAAM;QACzB,OAAO,EAAE,IAAI;KACb,CAAC;AACH,CAAC;AAED,kCACC,SAAoB,EACpB,gBAA+C,EAC/C,KAAc;IAEd,gBAAgB,CAAC,OAAO,GAAG;QAC1B,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,IAAA,mCAAe,EAAC,KAAK,CAAC;KAC7B,CAAC;IACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC;AACb,CAAC"}

package/dist/modules/mcp/tools/undo-user-preference.tool.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from '@n8n/backend-common';
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { AiPreferenceService } from '../../../services/ai-preference.service';
+import type { Telemetry } from '../../../telemetry';
+import type { ToolDefinition } from '../mcp.types';
+declare const inputSchema: {
+    id: z.ZodString;
+};
+export declare const createUndoUserPreferenceTool: (user: User, aiPreferenceService: AiPreferenceService, telemetry: Telemetry, logger: Logger) => ToolDefinition<typeof inputSchema>;
+export {};

package/dist/modules/mcp/tools/undo-user-preference.tool.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUndoUserPreferenceTool = void 0;
+const telemetry_1 = require("@n8n/telemetry");
+const zod_1 = __importDefault(require("zod"));
+const mcp_constants_1 = require("../mcp.constants");
+const user_preference_tool_utils_1 = require("./user-preference-tool.utils");
+const DESCRIPTION = [
+    `Removes a preference that ${mcp_constants_1.MCP_SAVE_USER_PREFERENCE_TOOL_NAME} saved for this user. Call it when the user takes back a preference that was just saved, or asks to forget one that a connected AI tool saved earlier.`,
+    'It only removes preferences saved through a connected AI tool for this user. A preference the user wrote in n8n settings, or one saved for a project or the whole instance, is refused; the user removes those in settings.',
+    'Tell the user in the same turn that the preference is gone.',
+].join('\n\n');
+const inputSchema = {
+    id: zod_1.default.string().min(1).describe('Id of the preference to remove, from the save result.'),
+};
+const outputSchema = {
+    removed: zod_1.default.boolean().describe('True when the preference is gone.'),
+    id: zod_1.default.string().describe('The id that was asked for.'),
+    error: zod_1.default.string().optional().describe('Set when the removal was refused or failed.'),
+    reason: zod_1.default
+        .enum(['not_found', 'not_permitted', 'failed'])
+        .optional()
+        .describe('`not_found`: no preference with this id was saved through a connected AI tool for this user. Do not retry.'),
+};
+const createUndoUserPreferenceTool = (user, aiPreferenceService, telemetry, logger) => ({
+    name: mcp_constants_1.MCP_UNDO_USER_PREFERENCE_TOOL_NAME,
+    config: {
+        description: DESCRIPTION,
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: 'Undo Saved Preference',
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    handler: async ({ id }) => {
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: mcp_constants_1.MCP_UNDO_USER_PREFERENCE_TOOL_NAME,
+            parameters: {},
+        };
+        let removed;
+        try {
+            removed = await aiPreferenceService.undoWrite(user, id, 'mcp');
+        }
+        catch (error) {
+            const classified = (0, user_preference_tool_utils_1.classifyPreferenceWriteError)(error);
+            const reason = classified.reason === 'not_found' || classified.reason === 'not_permitted'
+                ? classified.reason
+                : 'failed';
+            if (reason === 'failed') {
+                logger.error('Removing an AI preference over MCP failed', { error });
+            }
+            const message = reason === 'failed' ? 'The preference could not be removed.' : classified.message;
+            telemetryPayload.results = { success: false, error: message, data: { reason } };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `The preference was not removed: ${message}. Do not call this tool again with the same id; the user can remove preferences in n8n settings.`,
+                    },
+                ],
+                structuredContent: { removed: false, id, error: message, reason },
+                isError: true,
+            };
+        }
+        telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_DELETED_PREFERENCES, {
+            count: 1,
+            source: 'rejected',
+            scope_types: [(0, user_preference_tool_utils_1.preferenceScopeOf)(removed)],
+            surface: 'mcp',
+            seconds_since_saved: (0, user_preference_tool_utils_1.secondsSinceSaved)(removed),
+        });
+        telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.PREFERENCE_CONFIRMATION_RESOLVED, {
+            surface: 'mcp',
+            outcome: 'rejected',
+            scope_type: (0, user_preference_tool_utils_1.preferenceScopeOf)(removed),
+            text_length: removed.content.length,
+        });
+        telemetryPayload.results = { success: true, data: { removed: true } };
+        telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'The preference was removed. Nothing is saved for it now; tell the user so.',
+                },
+            ],
+            structuredContent: { removed: true, id },
+        };
+    },
+});
+exports.createUndoUserPreferenceTool = createUndoUserPreferenceTool;
+//# sourceMappingURL=undo-user-preference.tool.js.map

package/dist/modules/mcp/tools/undo-user-preference.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-user-preference.tool.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/undo-user-preference.tool.ts"],"names":[],"mappings":";;;;;;AAGA,8CAAiD;AACjD,8CAAoB;AAKpB,oDAI0B;AAE1B,6EAIsC;AAGtC,MAAM,WAAW,GAAG;IACnB,6BAA6B,kDAAkC,wJAAwJ;IACvN,6NAA6N;IAC7N,6DAA6D;CAC7D,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEf,MAAM,WAAW,GAAG;IACnB,EAAE,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uDAAuD,CAAC;CAC/D,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,OAAO,EAAE,aAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAClE,EAAE,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACrD,KAAK,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACpF,MAAM,EAAE,aAAC;SACP,IAAI,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;SAC9C,QAAQ,EAAE;SACV,QAAQ,CACR,4GAA4G,CAC5G;CACsB,CAAC;AAEnB,MAAM,4BAA4B,GAAG,CAC3C,IAAU,EACV,mBAAwC,EACxC,SAAoB,EACpB,MAAc,EACuB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,kDAAkC;IACxC,MAAM,EAAE;QACP,WAAW,EAAE,WAAW;QACxB,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACzB,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,kDAAkC;YAC7C,UAAU,EAAE,EAAE;SACd,CAAC;QAEF,IAAI,OAAwB,CAAC;QAC7B,IAAI,CAAC;YACJ,OAAO,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,IAAA,yDAA4B,EAAC,KAAK,CAAC,CAAC;YAEvD,MAAM,MAAM,GACX,UAAU,CAAC,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,MAAM,KAAK,eAAe;gBACzE,CAAC,CAAC,UAAU,CAAC,MAAM;gBACnB,CAAC,CAAC,QAAQ,CAAC;YAEb,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,OAAO,GACZ,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;YACnF,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;YAChF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAC9D,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mCAAmC,OAAO,kGAAkG;qBAClJ;iBACD;gBACD,iBAAiB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;gBACjE,OAAO,EAAE,IAAI;aACb,CAAC;QACH,CAAC;QAID,SAAS,CAAC,KAAK,CAAC,2BAAe,CAAC,OAAO,CAAC,wBAAwB,EAAE;YACjE,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,CAAC,IAAA,8CAAiB,EAAC,OAAO,CAAC,CAAC;YACzC,OAAO,EAAE,KAAK;YACd,mBAAmB,EAAE,IAAA,8CAAiB,EAAC,OAAO,CAAC;SAC/C,CAAC,CAAC;QACH,SAAS,CAAC,KAAK,CAAC,2BAAe,CAAC,OAAO,CAAC,gCAAgC,EAAE;YACzE,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,IAAA,8CAAiB,EAAC,OAAO,CAAC;YACtC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;SACnC,CAAC,CAAC;QACH,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACtE,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;QAE9D,OAAO;YACN,OAAO,EAAE;gBACR;oBACC,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4EAA4E;iBAClF;aACD;YACD,iBAAiB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;SACxC,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AApFU,QAAA,4BAA4B,GAA5B,4BAA4B,CAoFtC"}

package/dist/modules/mcp/tools/update-user-preference.tool.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from '@n8n/backend-common';
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { AiPreferenceService } from '../../../services/ai-preference.service';
+import type { UrlService } from '@n8n/backend-services';
+import type { Telemetry } from '../../../telemetry';
+import type { ToolDefinition } from '../mcp.types';
+declare const inputSchema: {
+    id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodEnum<["user", "project", "instance"]>>;
+    projectId: z.ZodOptional<z.ZodString>;
+};
+export declare const createUpdateUserPreferenceTool: (user: User, aiPreferenceService: AiPreferenceService, telemetry: Telemetry, urlService: UrlService, logger: Logger) => ToolDefinition<typeof inputSchema>;
+export {};