n8n 2.23.2 → 2.24.0

package/dist/modules/agents/builder/skills/mcp.skill.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpSkill = mcpSkill;
+const api_types_1 = require("@n8n/api-types");
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const schema_text_serializer_1 = require("../../json-config/schema-text-serializer");
+const mcpServerSchemaText = (0, schema_text_serializer_1.jsonSchemaToCompactText)((0, zod_to_json_schema_1.zodToJsonSchema)(api_types_1.McpServerConfigSchema));
+function mcpSkill() {
+    return {
+        id: 'agent-builder-mcp',
+        name: 'Agent builder MCP servers',
+        description: 'Use when adding, removing, or updating MCP (Model Context Protocol) servers on the target agent.',
+        instructions: `\
+## Purpose
+
+Use this to manage external MCP server connections in the target agent config.
+MCP servers expose external tool catalogs to the target agent over HTTP. They
+live on the top-level \`mcpServers\` array, and each entry maps 1:1 to a
+connected MCP server.
+
+## Use when:
+
+- The user asks for an external integration and you need to discover/connect an MCP server for it.
+- The user asks to edit the target agent's MCP servers.
+- The users wants to add a custom MCP server.
+
+## Workflow
+
+### Discovery and setup
+
+Follow these steps in order when adding an MCP server:
+
+1. Search: call \`search_mcp_servers\` with queries matching the requested
+   integration (for example \`["github"]\`, \`["slack"]\`).
+   The result includes \`name\`, \`url\`, \`transport\`, \`authentication\`,
+   \`credentialType\`, \`tools\`, and optional \`metadata\`.
+2. Credential: for registry results, call \`ask_credential\` with the returned
+   \`credentialType\`. Never invent credential IDs.
+3. Verify: call \`verify_mcp_server\` with \`name\`, \`url\`, \`transport\`,
+   \`authentication\`, and (if applicable) \`credential\`.
+4. Write config: call \`read_config\`, then \`patch_config\` to add the entry
+   to \`mcpServers[]\` using the patch pattern below.
+
+If \`search_mcp_servers\` returns no matches and the user provides a custom
+server URL, skip the search result mapping and continue with manual
+transport/authentication plus credential selection.
+
+Full schema reference:
+
+${mcpServerSchemaText}
+
+### Credential flow
+
+- For \`bearerAuth\`, call \`ask_credential\` with
+  \`credentialType: "httpBearerAuth"\`.
+- For \`headerAuth\`, call \`ask_credential\` with
+  \`credentialType: "httpHeaderAuth"\`.
+- For \`multipleHeadersAuth\`, call \`ask_credential\` with
+  \`credentialType: "httpMultipleHeadersAuth"\`.
+- For \`mcpOAuth2Api\`, call \`ask_credential\` with
+  \`credentialType: "mcpOAuth2Api"\`.
+- Never invent credential IDs. If the user declines, omit the server entirely
+  rather than persisting a stub.
+
+### Testing the connection
+
+Before writing to config, call \`verify_mcp_server\` with server \`name\`,
+\`url\`, \`transport\`, and (if applicable) the credential id from
+\`ask_credential\`.
+
+- Success returns \`{ ok: true, tools: [{ name, description }] }\`.
+- Use the returned tool list to populate \`toolFilter.tools\` or
+  \`approval.tools\` so the user does not need to type tool names manually.
+- Failure returns \`{ ok: false, error: "..." }\`.
+- If verification fails, explain the error and ask the user to check the URL
+  or credentials before proceeding.
+
+### Selecting credentials
+
+When using a registry-backed server, always use the \`credentialType\` returned
+by \`search_mcp_servers\`.
+
+For custom MCP servers, if credential type is unknown, ask the user which
+credential type to use (OAuth2, Bearer Token, Header Auth, Multiple Headers
+Auth, or None) via \`${api_types_1.ASK_QUESTION_TOOL_NAME}\`. Then map to:
+
+- \`bearerAuth\` -> \`ask_credential\` with \`credentialType: "httpBearerAuth"\`
+- \`headerAuth\` -> \`ask_credential\` with \`credentialType: "httpHeaderAuth"\`
+- \`multipleHeadersAuth\` -> \`ask_credential\` with
+  \`credentialType: "httpMultipleHeadersAuth"\`
+- \`mcpOAuth2Api\` -> \`ask_credential\` with \`credentialType: "mcpOAuth2Api"\`
+
+### Patch pattern
+
+1. Initialize the array if missing:
+   \`{ "op": "add", "path": "/mcpServers", "value": [] }\`
+2. Append each server:
+   \`{ "op": "add", "path": "/mcpServers/-", "value": { ... } }\`
+
+## Gotchas
+
+- Server \`name\` must be unique across \`mcpServers\` within an agent.
+- Never invent credential IDs. If the user declines, omit the server entirely.
+- Never fabricate \`metadata.nodeTypeName\`.
+- When \`search_mcp_servers\` returns \`metadata.nodeTypeName\`, include
+  \`metadata: { nodeTypeName: <result.nodeTypeName> }\` in the entry so the UI
+  can render the correct server form.`,
+    };
+}
+//# sourceMappingURL=mcp.skill.js.map

package/dist/modules/agents/builder/skills/mcp.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/mcp.skill.ts"],"names":[],"mappings":";;AAWA,4BAsGC;AAhHD,8CAA+E;AAE/E,2DAAqD;AAErD,qFAAmF;AAEnF,MAAM,mBAAmB,GAAG,IAAA,gDAAuB,EAClD,IAAA,oCAAe,EAAC,iCAAqB,CAAgB,CACrD,CAAC;AAEF,SAAgB,QAAQ;IACvB,OAAO;QACN,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACV,kGAAkG;QACnG,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCd,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAmCE,kCAAsB;;;;;;;;;;;;;;;;;;;;;;sCAsBP;KACpC,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/skills/research.skill.js

@@ -11,11 +11,14 @@ function researchSkill() {
 
 Use this when external facts can change the target-agent build.
 
-## Boundaries
-
-- You need n8n internals, local schema, or builder-tool guidance.
-- The API or service is well known enough to configure confidently from current context.
-- The user is asking for a general explanation that does not affect the target agent build.
+## Use when
+
+- Current external API, product, standard, or spec facts can change target-agent
+  config, tool, credential, or instruction choices.
+- You need to verify up-to-date endpoint, auth, or behavior details before
+  making build decisions.
+- The user explicitly asks for research that should affect the target-agent
+  build.
 
 ## Workflow
 

package/dist/modules/agents/builder/skills/research.skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"research.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/research.skill.ts"],"names":[],"mappings":";;AAEA,sCAsCC;AAtCD,SAAgB,aAAa;IAC5B,OAAO;QACN,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACV,yNAAyN;QAC1N,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+EA8B+D;KAC7E,CAAC;AACH,CAAC"}
+{"version":3,"file":"research.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/research.skill.ts"],"names":[],"mappings":";;AAEA,sCAyCC;AAzCD,SAAgB,aAAa;IAC5B,OAAO;QACN,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACV,yNAAyN;QAC1N,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+EAiC+D;KAC7E,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/skills/target-skills.skill.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.targetSkillsSkill = targetSkillsSkill;
+const skill_body_template_1 = require("../skill-body-template");
 function targetSkillsSkill() {
     return {
         id: 'agent-builder-target-skills',
@@ -11,23 +12,48 @@ function targetSkillsSkill() {
 
 Use this to create reusable load-on-demand instructions for the target agent.
 
-## Boundaries
+## Use when
 
-- The instruction is one-off and belongs directly in the target agent instructions.
-- You need guidance for your own builder behavior.
-- The user is asking to edit config, tools, integrations, memory, or model settings without a reusable target-agent skill.
+- The user wants reusable target-agent guidance (for example playbooks,
+  policies, or domain instructions) that should load only for relevant future
+  requests.
+- The same behavior is likely to be reused across multiple future tasks and
+  should be captured as a target-agent skill.
+- You want conditional, load-on-demand behavior instead of always-on target
+  agent instructions.
+
+## Don't use when:
+
+- The user asks for one-off target-agent instructions or config/tool/integration/model/memory edits.
+
+## Description (routing contract)
+
+${skill_body_template_1.SKILL_DESCRIPTION_RULE}
+
+## Skill body format (required)
+
+${skill_body_template_1.SKILL_BODY_FORMAT_RULE}
+
+${skill_body_template_1.SKILL_BODY_TEMPLATE}
+
+## Ask first (required)
+
+Do NOT call \`create_skill\` until you have enough concrete domain detail to write
+a genuinely useful skill: a specific routing description and a body whose
+applicable sections are filled with real content (the actual steps, rules,
+examples, and edge cases). If any of that is missing, ask the user clarifying
+questions (use \`ask_question\` — discrete options for choices, or empty options
+for open-ended) until you can write it. Never create a placeholder or vague skill.
 
 ## Workflow
 
+- Gather the domain detail you need, asking clarifying questions until the
+  description and every applicable body section can be written with concrete
+  content.
+- Write the \`description\` as the routing contract and the \`body\` using the
+  template above. Put all "when to use" / "when not to use" guidance in the
+  description, never in the body (the body is invisible until the skill loads).
 - Call \`create_skill\` with \`name\`, \`description\`, and \`body\`.
-- Treat the description as the routing contract: it is what the runtime sees
-  before deciding whether to load the skill.
-- Put all "when to use" and "when not to use" guidance in the description.
-- The body is loaded only after the skill triggers, so it should be a compact
-  operating manual: purpose, workflow, rules, gotchas, and verification where
-  useful.
-- Do not rely on a body "Use when" section for activation; include routing
-  guidance in \`description\`.
 - \`create_skill\` stores the body only; it does not attach the skill.
 - After it returns an id, call \`read_config\`.
 - Use \`patch_config\` or \`write_config\` to add \`{ "type": "skill", "id": "<returned id>" }\` to \`skills\`.
@@ -53,7 +79,9 @@ Use this to create reusable load-on-demand instructions for the target agent.
 
 - The returned skill id is attached in config as \`{ "type": "skill", "id": "<returned id>" }\`.
 - The skill description clearly states when it should load.
-- The body tells the target agent what to do differently when the skill is loaded.`,
+- The body follows the template, with each applicable section filled with
+  concrete content (no placeholders), and tells the target agent what to do when
+  the skill is loaded.`,
     };
 }
 //# sourceMappingURL=target-skills.skill.js.map

package/dist/modules/agents/builder/skills/target-skills.skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"target-skills.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-skills.skill.ts"],"names":[],"mappings":";;AAEA,8CAuDC;AAvDD,SAAgB,iBAAiB;IAChC,OAAO;QACN,EAAE,EAAE,6BAA6B;QACjC,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACV,mOAAmO;QACpO,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFA+CmE;KACjF,CAAC;AACH,CAAC"}
+{"version":3,"file":"target-skills.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-skills.skill.ts"],"names":[],"mappings":";;AAQA,8CAkFC;AAxFD,gEAIgC;AAEhC,SAAgB,iBAAiB;IAChC,OAAO;QACN,EAAE,EAAE,6BAA6B;QACjC,IAAI,EAAE,6BAA6B;QACnC,WAAW,EACV,mOAAmO;QACpO,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;EAqBd,4CAAsB;;;;EAItB,4CAAsB;;EAEtB,yCAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA+CE;KACrB,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/skills/target-tasks.skill.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimeSkill } from '@n8n/agents';
+export declare function targetTasksSkill(): RuntimeSkill;

package/dist/modules/agents/builder/skills/target-tasks.skill.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.targetTasksSkill = targetTasksSkill;
+const task_objective_template_1 = require("../task-objective-template");
+function targetTasksSkill() {
+    return {
+        id: 'agent-builder-target-tasks',
+        name: 'Agent Builder Target Tasks',
+        description: 'Use when the user wants the target agent to run something on a recurring schedule (a "task"): a daily/weekly/hourly objective the agent carries out on its own with create_task. Not for one-off requests, chat/event triggers, or config/tool/skill/model edits.',
+        instructions: `\
+## Purpose
+
+Use this to create a recurring scheduled task for the target agent with
+\`create_task\`. A task = a name + an objective (what the agent does each run) + a
+cron schedule, stored as a \`{ type: "task", id, enabled }\` ref in the agent
+config (\`config.tasks\`) plus a saved body. The config is the source of truth.
+
+## Use when
+
+- The user wants the agent to do something automatically on a schedule
+  ("every morning", "each Monday", "hourly", etc.).
+- There is a clear, repeatable objective the agent can carry out unattended.
+
+## Don't use when
+
+- The request is a one-off action, a chat/event trigger, or a
+  config/tool/skill/model edit.
+
+## Objective format (required)
+
+${task_objective_template_1.TASK_OBJECTIVE_FORMAT_RULE}
+
+${task_objective_template_1.TASK_OBJECTIVE_TEMPLATE}
+
+## Ask first (required)
+
+Do NOT call \`create_task\` until BOTH of these are true:
+
+1. You can fill EVERY section of the objective template above with concrete,
+   specific content — no placeholders, no guesses, nothing left to "refine
+   later". The objective is the ONLY message the agent receives when the task
+   fires, so it must stand on its own and must not rely on the current chat.
+2. The schedule is concrete — how often and at what time it should run.
+
+If any section would be empty or a guess, ask the user clarifying questions (use
+\`ask_question\` — discrete options for choices, or empty options for open-ended)
+until you can complete the whole template and pin down the cadence. Never create a placeholder
+or "refine-it-later" task.
+
+## Workflow
+
+- Gather everything the template needs (every objective section + the cadence),
+  asking clarifying questions until no section is a guess.
+- Write the objective using the exact template above, filling each section.
+- Make sure the agent already has every tool the steps need (an integration,
+  node/workflow tool, or web search). If something is missing, add it to the agent
+  config first — a task can only use tools the agent already has.
+- Translate the cadence into a valid 5-field cron expression (e.g. daily 09:00
+  -> "0 9 * * *"; weekdays 08:30 -> "30 8 * * 1-5"; hourly -> "0 * * * *").
+- Call \`create_task\` with \`name\`, \`objective\`, and \`cronExpression\`.
+- On \`{ ok: false, errors }\` (for example an invalid cron), fix the input and
+  retry.
+
+## Rules
+
+- The objective must be self-contained and unambiguous.
+- Use a short, descriptive task name.
+- One task = one objective + one schedule. Create multiple tasks for multiple
+  recurring jobs.
+
+## Gotchas
+
+- \`create_task\` adds a \`{ type: "task", id, enabled }\` ref to \`config.tasks\` and
+  creates the task body. The task is enabled by default and only starts running
+  once the agent is (re)published; tell the user this when relevant.
+- To disable or remove a task, edit \`config.tasks\` with \`patch_config\` (set
+  \`enabled: false\`, or drop the ref). Changes take effect on the next publish.
+- \`create_task\` does NOT add tools — if the task needs a tool the agent lacks,
+  add it to the config yourself first.`,
+    };
+}
+//# sourceMappingURL=target-tasks.skill.js.map

package/dist/modules/agents/builder/skills/target-tasks.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-tasks.skill.js","sourceRoot":"","sources":["../../../../../src/modules/agents/builder/skills/target-tasks.skill.ts"],"names":[],"mappings":";;AAIA,4CA6EC;AA/ED,wEAAiG;AAEjG,SAAgB,gBAAgB;IAC/B,OAAO;QACN,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACV,mQAAmQ;QACpQ,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;EAqBd,oDAA0B;;EAE1B,iDAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA8Cc;KACrC,CAAC;AACH,CAAC"}

package/dist/modules/agents/builder/task-objective-template.d.ts

@@ -0,0 +1,3 @@
+export declare const TASK_OBJECTIVE_TEMPLATE = "## Objective\n<One sentence: the outcome to achieve on each run and why it matters.>\n\n## Context\n<Background the agent needs, the inputs and data sources to use, and the time window to consider (e.g. \"items created since the previous run\").>\n\n## Steps\n1. <First action.>\n2. <Next action.>\n\n## Output\n<The exact format of the result AND where to deliver it (e.g. \"email a summary to ops@example.com\", \"post to Slack #alerts\", \"append a row to the tracking sheet\"). The run is unattended, so the agent must actively deliver the result somewhere.>\n\n## Constraints\n<Scope limits, what to avoid, and what to do when there is nothing to act on (e.g. \"if there are no new items, do nothing\").>\n\n## Success criteria\n<A verifiable definition of done for a single run.>";
+export declare const TASK_OBJECTIVE_FORMAT_RULE: string;
+export declare const TASK_OBJECTIVE_GUIDANCE = "The objective is the only message the agent receives on each unattended run, so it must be fully self-contained (never rely on the current chat) and must follow this exact Markdown structure, with every section filled in with concrete, specific content \u2014 no placeholders or angle-bracket text:\n\n## Objective\n<One sentence: the outcome to achieve on each run and why it matters.>\n\n## Context\n<Background the agent needs, the inputs and data sources to use, and the time window to consider (e.g. \"items created since the previous run\").>\n\n## Steps\n1. <First action.>\n2. <Next action.>\n\n## Output\n<The exact format of the result AND where to deliver it (e.g. \"email a summary to ops@example.com\", \"post to Slack #alerts\", \"append a row to the tracking sheet\"). The run is unattended, so the agent must actively deliver the result somewhere.>\n\n## Constraints\n<Scope limits, what to avoid, and what to do when there is nothing to act on (e.g. \"if there are no new items, do nothing\").>\n\n## Success criteria\n<A verifiable definition of done for a single run.>";

package/dist/modules/agents/builder/task-objective-template.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TASK_OBJECTIVE_GUIDANCE = exports.TASK_OBJECTIVE_FORMAT_RULE = exports.TASK_OBJECTIVE_TEMPLATE = void 0;
+exports.TASK_OBJECTIVE_TEMPLATE = `## Objective
+<One sentence: the outcome to achieve on each run and why it matters.>
+
+## Context
+<Background the agent needs, the inputs and data sources to use, and the time window to consider (e.g. "items created since the previous run").>
+
+## Steps
+1. <First action.>
+2. <Next action.>
+
+## Output
+<The exact format of the result AND where to deliver it (e.g. "email a summary to ops@example.com", "post to Slack #alerts", "append a row to the tracking sheet"). The run is unattended, so the agent must actively deliver the result somewhere.>
+
+## Constraints
+<Scope limits, what to avoid, and what to do when there is nothing to act on (e.g. "if there are no new items, do nothing").>
+
+## Success criteria
+<A verifiable definition of done for a single run.>`;
+exports.TASK_OBJECTIVE_FORMAT_RULE = 'The objective is the only message the agent receives on each unattended run, so it must be ' +
+    'fully self-contained (never rely on the current chat) and must follow this exact Markdown ' +
+    'structure, with every section filled in with concrete, specific content — no placeholders or ' +
+    'angle-bracket text:';
+exports.TASK_OBJECTIVE_GUIDANCE = `${exports.TASK_OBJECTIVE_FORMAT_RULE}\n\n${exports.TASK_OBJECTIVE_TEMPLATE}`;
+//# sourceMappingURL=task-objective-template.js.map

package/dist/modules/agents/builder/task-objective-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-objective-template.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/task-objective-template.ts"],"names":[],"mappings":";;;AAca,QAAA,uBAAuB,GAAG;;;;;;;;;;;;;;;;;oDAiBa,CAAC;AAGxC,QAAA,0BAA0B,GACtC,6FAA6F;IAC7F,4FAA4F;IAC5F,+FAA+F;IAC/F,qBAAqB,CAAC;AAGV,QAAA,uBAAuB,GAAG,GAAG,kCAA0B,OAAO,+BAAuB,EAAE,CAAC"}

package/dist/modules/agents/builder/verify-mcp-server.tool.d.ts

@@ -0,0 +1,8 @@
+import type { BuiltTool, CredentialProvider } from '@n8n/agents';
+import type { OauthService } from '../../../oauth/oauth.service';
+export interface VerifyMcpServerDeps {
+    credentialProvider: CredentialProvider;
+    oauthService: OauthService;
+    projectId: string;
+}
+export declare function buildVerifyMcpServerTool(deps: VerifyMcpServerDeps): BuiltTool;

package/dist/modules/agents/builder/verify-mcp-server.tool.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildVerifyMcpServerTool = buildVerifyMcpServerTool;
+const tool_1 = require("@n8n/agents/tool");
+const api_types_1 = require("@n8n/api-types");
+const zod_1 = require("zod");
+const mcp_client_factory_1 = require("../json-config/mcp-client-factory");
+const builder_tool_names_1 = require("./builder-tool-names");
+const verifyMcpServerInputSchema = zod_1.z.object({
+    name: zod_1.z
+        .string()
+        .min(1)
+        .max(64)
+        .regex(/^[a-zA-Z0-9_-]+$/)
+        .describe('The server name (used as the tool-name prefix)'),
+    url: zod_1.z.string().min(1).describe('The MCP server endpoint URL'),
+    transport: zod_1.z
+        .enum(['sse', 'streamableHttp'])
+        .default('streamableHttp')
+        .describe('Transport type. Defaults to streamableHttp'),
+    authentication: zod_1.z
+        .union([api_types_1.McpAuthenticationSchemaTypes, zod_1.z.string().endsWith('McpOAuth2Api')])
+        .default('none')
+        .describe('Authentication scheme'),
+    credential: zod_1.z
+        .string()
+        .optional()
+        .describe('Credential id returned by ask_credential. Required when authentication is not "none"'),
+    connectionTimeoutMs: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(120_000)
+        .optional()
+        .describe('Connection timeout in milliseconds'),
+});
+function buildVerifyMcpServerTool(deps) {
+    return new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.VERIFY_MCP_SERVER)
+        .description('Test connectivity to an MCP server before adding it to the agent config. ' +
+        'Establishes a temporary connection, lists the available tools, then closes the connection. ' +
+        'Returns { ok: true, tools: [{ name, description }] } on success, or ' +
+        '{ ok: false, error: string } on failure. ' +
+        'Call this after ask_credential (when authentication is not "none") and before patch_config.')
+        .input(verifyMcpServerInputSchema)
+        .handler(async (input) => {
+        let client;
+        try {
+            client = await (0, mcp_client_factory_1.buildMcpClientForServer)({
+                name: input.name,
+                url: input.url,
+                transport: input.transport,
+                authentication: input.authentication,
+                credential: input.credential,
+                ...(input.connectionTimeoutMs !== undefined && {
+                    connectionTimeoutMs: input.connectionTimeoutMs,
+                }),
+            }, deps);
+            const tools = await client.listTools();
+            return {
+                ok: true,
+                tools: tools.map((t) => ({
+                    name: t.name,
+                    description: t.description ?? '',
+                })),
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        finally {
+            await client?.close().catch(() => { });
+        }
+    })
+        .build();
+}
+//# sourceMappingURL=verify-mcp-server.tool.js.map

package/dist/modules/agents/builder/verify-mcp-server.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-mcp-server.tool.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/verify-mcp-server.tool.ts"],"names":[],"mappings":";;AA0DA,4DA4CC;AArGD,2CAAwC;AACxC,8CAA8D;AAC9D,6BAAwB;AAIxB,0EAA4E;AAC5E,6DAAqD;AAiBrD,MAAM,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,KAAK,CAAC,kBAAkB,CAAC;SACzB,QAAQ,CAAC,gDAAgD,CAAC;IAC5D,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC9D,SAAS,EAAE,OAAC;SACV,IAAI,CAAC,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;SAC/B,OAAO,CAAC,gBAAgB,CAAC;SACzB,QAAQ,CAAC,4CAA4C,CAAC;IACxD,cAAc,EAAE,OAAC;SACf,KAAK,CAAC,CAAC,wCAA4B,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;SAC1E,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,uBAAuB,CAAC;IACnC,UAAU,EAAE,OAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACR,sFAAsF,CACtF;IACF,mBAAmB,EAAE,OAAC;SACpB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,OAAO,CAAC;SACZ,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;CAChD,CAAC,CAAC;AAIH,SAAgB,wBAAwB,CAAC,IAAyB;IACjE,OAAO,IAAI,WAAI,CAAC,kCAAa,CAAC,iBAAiB,CAAC;SAC9C,WAAW,CACX,2EAA2E;QAC1E,6FAA6F;QAC7F,sEAAsE;QACtE,2CAA2C;QAC3C,6FAA6F,CAC9F;SACA,KAAK,CAAC,0BAA0B,CAAC;SACjC,OAAO,CAAC,KAAK,EAAE,KAA2B,EAAE,EAAE;QAC9C,IAAI,MAA6B,CAAC;QAClC,IAAI,CAAC;YACJ,MAAM,GAAG,MAAM,IAAA,4CAAuB,EACrC;gBACC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,GAAG,CAAC,KAAK,CAAC,mBAAmB,KAAK,SAAS,IAAI;oBAC9C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;iBAC9C,CAAC;aACF,EACD,IAAI,CACJ,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACvC,OAAO;gBACN,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;iBAChC,CAAC,CAAC;aACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;QACH,CAAC;gBAAS,CAAC;YACV,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvC,CAAC;IACF,CAAC,CAAC;SACD,KAAK,EAAE,CAAC;AACX,CAAC"}

package/dist/modules/agents/entities/agent-execution-thread.entity.d.ts

@@ -1,4 +1,5 @@
 import { Project, WithTimestampsAndStringId } from '@n8n/db';
+import { AgentHistory } from './agent-history.entity';
 import { Agent } from './agent.entity';
 export declare class AgentExecutionThread extends WithTimestampsAndStringId {
     agent: Agent;
@@ -8,6 +9,9 @@ export declare class AgentExecutionThread extends WithTimestampsAndStringId {
     emoji: string | null;
     project: Project;
     projectId: string;
+    taskId: string | null;
+    taskVersion: AgentHistory | null;
+    taskVersionId: string | null;
     sessionNumber: number;
     totalPromptTokens: number;
     totalCompletionTokens: number;

package/dist/modules/agents/entities/agent-execution-thread.entity.js

@@ -10,8 +10,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentExecutionThread = void 0;
+const api_types_1 = require("@n8n/api-types");
 const db_1 = require("@n8n/db");
 const typeorm_1 = require("@n8n/typeorm");
+const agent_history_entity_1 = require("./agent-history.entity");
 const agent_entity_1 = require("./agent.entity");
 let AgentExecutionThread = class AgentExecutionThread extends db_1.WithTimestampsAndStringId {
 };
@@ -48,6 +50,30 @@ __decorate([
     (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
     __metadata("design:type", String)
 ], AgentExecutionThread.prototype, "projectId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'varchar',
+        length: api_types_1.AGENT_TASK_ID_MAX_LENGTH,
+        nullable: true,
+        comment: 'Published task ID that triggered this session; not an FK because published runs can outlive draft task definition rows',
+    }),
+    __metadata("design:type", Object)
+], AgentExecutionThread.prototype, "taskId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => agent_history_entity_1.AgentHistory, { onDelete: 'SET NULL' }),
+    (0, typeorm_1.JoinColumn)({ name: 'taskVersionId' }),
+    __metadata("design:type", Object)
+], AgentExecutionThread.prototype, "taskVersion", void 0);
+__decorate([
+    (0, typeorm_1.Index)(),
+    (0, typeorm_1.Column)({
+        type: 'varchar',
+        length: 36,
+        nullable: true,
+        comment: 'Published agent_history version that supplied the task snapshot',
+    }),
+    __metadata("design:type", Object)
+], AgentExecutionThread.prototype, "taskVersionId", void 0);
 __decorate([
     (0, typeorm_1.Column)({ type: 'int', default: 0 }),
     __metadata("design:type", Number)

package/dist/modules/agents/entities/agent-execution-thread.entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-execution-thread.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-execution-thread.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAA6D;AAC7D,0CAA4E;AAE5E,iDAAuC;AAgBhC,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,8BAAyB;CA6ClE,CAAA;AA7CY,oDAAoB;AAGhC;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,oBAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/C,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;8BACzB,oBAAK;mDAAC;AAIb;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;qDACxB;AAIhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;uDACvB;AAIlB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACpC;AAIrB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDAClC;AAIrB;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,YAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjD,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;8BACzB,YAAO;qDAAC;AAIjB;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;uDACvB;AAIlB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;2DACd;AAGtB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;+DACV;AAG1B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;mEACN;AAG9B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;uDAC/B;AAIlB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;2DACd;+BA5CV,oBAAoB;IADhC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;GAC/B,oBAAoB,CA6ChC"}
+{"version":3,"file":"agent-execution-thread.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-execution-thread.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAA0D;AAC1D,gCAA6D;AAC7D,0CAA4E;AAE5E,iEAAsD;AACtD,iDAAuC;AAgBhC,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,8BAAyB;CA2ElE,CAAA;AA3EY,oDAAoB;AAGhC;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,oBAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/C,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;8BACzB,oBAAK;mDAAC;AAIb;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;qDACxB;AAIhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;uDACvB;AAIlB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACpC;AAIrB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDAClC;AAIrB;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,YAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjD,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;8BACzB,YAAO;qDAAC;AAIjB;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;uDACvB;AAalB;IAPC,IAAA,gBAAM,EAAC;QACP,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,oCAAwB;QAChC,QAAQ,EAAE,IAAI;QACd,OAAO,EACN,wHAAwH;KACzH,CAAC;;oDACoB;AAQtB;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,mCAAY,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvD,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;;yDACL;AASjC;IAPC,IAAA,eAAK,GAAE;IACP,IAAA,gBAAM,EAAC;QACP,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,iEAAiE;KAC1E,CAAC;;2DAC2B;AAI7B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;2DACd;AAGtB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;+DACV;AAG1B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;mEACN;AAG9B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;uDAC/B;AAIlB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;2DACd;+BA1EV,oBAAoB;IADhC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;GAC/B,oBAAoB,CA2EhC"}

package/dist/modules/agents/entities/agent-file.entity.d.ts

@@ -0,0 +1,11 @@
+import { WithTimestampsAndStringId } from '@n8n/db';
+import { type Relation } from '@n8n/typeorm';
+import { Agent } from './agent.entity';
+export declare class AgentFile extends WithTimestampsAndStringId {
+    agent: Relation<Agent>;
+    agentId: string;
+    binaryDataId: string;
+    fileName: string;
+    mimeType: string;
+    fileSizeBytes: number;
+}

package/dist/modules/agents/entities/agent-file.entity.js

@@ -0,0 +1,48 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentFile = void 0;
+const db_1 = require("@n8n/db");
+const typeorm_1 = require("@n8n/typeorm");
+const agent_entity_1 = require("./agent.entity");
+let AgentFile = class AgentFile extends db_1.WithTimestampsAndStringId {
+};
+exports.AgentFile = AgentFile;
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => agent_entity_1.Agent, { onDelete: 'CASCADE' }),
+    (0, typeorm_1.JoinColumn)({ name: 'agentId' }),
+    __metadata("design:type", Object)
+], AgentFile.prototype, "agent", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36 }),
+    __metadata("design:type", String)
+], AgentFile.prototype, "agentId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text' }),
+    __metadata("design:type", String)
+], AgentFile.prototype, "binaryDataId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], AgentFile.prototype, "fileName", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], AgentFile.prototype, "mimeType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int' }),
+    __metadata("design:type", Number)
+], AgentFile.prototype, "fileSizeBytes", void 0);
+exports.AgentFile = AgentFile = __decorate([
+    (0, typeorm_1.Entity)({ name: 'agent_files' }),
+    (0, typeorm_1.Index)(['agentId', 'createdAt'])
+], AgentFile);
+//# sourceMappingURL=agent-file.entity.js.map

package/dist/modules/agents/entities/agent-file.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-file.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-file.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAAoD;AACpD,0CAA2F;AAE3F,iDAAuC;AAIhC,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,8BAAyB;CA8BvD,CAAA;AA9BY,8BAAS;AAGrB;IAFC,IAAA,mBAAS,EAAC,GAAG,EAAE,CAAC,oBAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/C,IAAA,oBAAU,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;wCACT;AAGvB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;0CACxB;AAQhB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;+CACJ;AASrB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;2CACxB;AAGjB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;2CACxB;AAGjB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;;gDACF;oBA7BV,SAAS;IAFrB,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,IAAA,eAAK,EAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;GACnB,SAAS,CA8BrB"}

package/dist/modules/agents/entities/agent-task-run-lock.entity.d.ts

@@ -0,0 +1,10 @@
+import { WithTimestamps } from '@n8n/db';
+import { type Relation } from '@n8n/typeorm';
+import { Agent } from './agent.entity';
+export declare class AgentTaskRunLock extends WithTimestamps {
+    agentId: string;
+    agent: Relation<Agent>;
+    taskId: string;
+    holderId: string;
+    heldUntil: Date;
+}