n8n 2.31.5 → 2.32.1

package/dist/modules/agents/builder/agents-builder-tools.service.js

@@ -1,43 +1,10 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
 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 __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
@@ -57,12 +24,14 @@ const credential_types_1 = require("../../../credential-types");
 const mcp_registry_service_1 = require("../../../modules/mcp-registry/registry/mcp-registry.service");
 const node_types_1 = require("../../../node-types");
 const oauth_service_1 = require("../../../oauth/oauth.service");
+const check_access_1 = require("../../../permissions.ee/check-access");
 const ai_service_1 = require("../../../services/ai.service");
 const dynamic_node_parameters_service_1 = require("../../../services/dynamic-node-parameters.service");
 const ai_proxy_fetch_1 = require("../../../utils/ai-proxy-fetch");
 const agent_config_service_1 = require("../agent-config.service");
 const agent_custom_tools_service_1 = require("../agent-custom-tools.service");
 const agent_integration_persistence_service_1 = require("../agent-integration-persistence.service");
+const agent_publish_service_1 = require("../agent-publish.service");
 const agent_skills_service_1 = require("../agent-skills.service");
 const agent_task_service_1 = require("../agent-task.service");
 const agents_tools_service_1 = require("../agents-tools.service");
@@ -72,16 +41,16 @@ const builder_model_live_lookup_service_1 = require("./builder-model-live-lookup
 const builder_tool_names_1 = require("./builder-tool-names");
 const get_resource_locator_options_tool_1 = require("./get-resource-locator-options.tool");
 const interactive_1 = require("./interactive");
+const resolve_integration_tool_1 = require("./resolve-integration.tool");
 const search_mcp_servers_tool_1 = require("./search-mcp-servers.tool");
 const skill_body_template_1 = require("./skill-body-template");
 const task_objective_template_1 = require("./task-objective-template");
 const verify_mcp_server_tool_1 = require("./verify-mcp-server.tool");
 const agent_config_composition_1 = require("../json-config/agent-config-composition");
-const agent_repository_1 = require("../repositories/agent.repository");
 const agent_secure_runtime_1 = require("../runtime/agent-secure-runtime");
 const STALE_CONFIG_ERROR = {
     path: '(root)',
-    message: 'Agent config changed since you last read it. Call read_config and retry with the returned configHash.',
+    message: 'Agent config changed since you last read it. Call read_config, then retry using the config and configHash it returns.',
 };
 const CLI_AGENT_CONFIG_MESSAGES = {
     emptyInstructionsFollowUp: 'saving the config again.',
@@ -120,12 +89,10 @@ function getAgentConfigHash(config) {
         .update(JSON.stringify(canonicalizeJson(config)))
         .digest('hex');
 }
-function snapshotFromConfig(config, updatedAt, versionId) {
+function snapshotFromConfig(config) {
     return {
         config,
         configHash: getAgentConfigHash(config),
-        updatedAt,
-        versionId,
     };
 }
 function applyPromptCachingBuilderDefaults(config) {
@@ -151,7 +118,7 @@ function applyPromptCachingBuilderDefaults(config) {
     };
 }
 let AgentsBuilderToolsService = class AgentsBuilderToolsService {
-    constructor(agentsService, agentConfigService, agentCustomToolsService, agentIntegrationPersistenceService, agentSkillsService, secureRuntime, attachableWorkflowsService, agentsToolsService, builderModelLiveLookupService, mcpRegistryService, oauthService, credentialTypes, agentTaskService, agentRepository, aiService, outboundHttp, dynamicNodeParametersService, nodeTypes, ssrfConfig, ssrfProtectionService) {
+    constructor(agentsService, agentConfigService, agentCustomToolsService, agentIntegrationPersistenceService, agentSkillsService, secureRuntime, attachableWorkflowsService, agentsToolsService, builderModelLiveLookupService, mcpRegistryService, oauthService, credentialTypes, agentTaskService, agentPublishService, aiService, outboundHttp, dynamicNodeParametersService, nodeTypes, ssrfConfig, ssrfProtectionService) {
         this.agentsService = agentsService;
         this.agentConfigService = agentConfigService;
         this.agentCustomToolsService = agentCustomToolsService;
@@ -165,7 +132,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
         this.oauthService = oauthService;
         this.credentialTypes = credentialTypes;
         this.agentTaskService = agentTaskService;
-        this.agentRepository = agentRepository;
+        this.agentPublishService = agentPublishService;
         this.aiService = aiService;
         this.outboundHttp = outboundHttp;
         this.dynamicNodeParametersService = dynamicNodeParametersService;
@@ -181,8 +148,9 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
     }
     getJsonTools(agentId, projectId, credentialProvider, user) {
         const readConfigTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.READ_CONFIG)
-            .description('Read the latest persisted agent configuration and freshness metadata. ' +
-            'Returns { ok: true, config, configHash, updatedAt, versionId }. ' +
+            .description('Read the latest persisted agent configuration and its freshness token. ' +
+            'Returns { ok: true, config, configHash }. This is the only tool that returns the full config — ' +
+            'write_config, patch_config, and stale responses never echo it back. ' +
             'Call this before every write_config or patch_config and use configHash as baseConfigHash.')
             .input(zod_1.z.object({}))
             .handler(async () => {
@@ -199,10 +167,12 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             .build();
         const writeConfigTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.WRITE_CONFIG)
             .description('Create or replace the agent configuration by writing a complete JSON string. ' +
-            'Requires baseConfigHash from the immediately preceding read_config result, or from a stale retry response. ' +
-            'Do not use a configHash copied from the prompt snapshot. ' +
-            'Returns { ok: true, config, configHash, updatedAt, versionId } on success or ' +
-            '{ ok: false, stage, errors } with path, message, expected, received fields on failure.')
+            'Requires baseConfigHash from the immediately preceding read_config result — never from a prior ' +
+            'write_config/patch_config success or from a stale response. ' +
+            'Returns { ok: true } on success — no config, hash, or timestamps are returned; call ' +
+            'read_config again before any later inspection or mutation — or ' +
+            '{ ok: false, stage, errors } with path, message, expected, received fields on failure. ' +
+            'On stage: "stale", call read_config and retry once using its fresh config and configHash.')
             .input(zod_1.z.object({
             json: zod_1.z.string().describe('Complete agent configuration as a JSON string'),
             baseConfigHash: zod_1.z
@@ -227,7 +197,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
                 };
             }
             if (baseConfigHash !== snapshot.configHash) {
-                return { ok: false, stage: 'stale', errors: [STALE_CONFIG_ERROR], ...snapshot };
+                return { ok: false, stage: 'stale', errors: [STALE_CONFIG_ERROR] };
             }
             const zodResult = api_types_1.RunnableAgentJsonConfigSchema.safeParse((0, api_types_1.sanitizeAgentJsonConfig)(parsed.data));
             if (!zodResult.success) {
@@ -247,11 +217,8 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             }
             const configWithDefaults = applyPromptCachingBuilderDefaults((0, agent_config_1.applyNativeWebSearchDefaultOn)(zodResult.data));
             try {
-                const result = await this.agentConfigService.updateConfig(agentId, projectId, configWithDefaults);
-                return {
-                    ok: true,
-                    ...snapshotFromConfig(result.config, result.updatedAt, result.versionId),
-                };
+                await this.agentConfigService.updateConfig(agentId, projectId, configWithDefaults);
+                return { ok: true };
             }
             catch (e) {
                 return {
@@ -265,12 +232,14 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
         const patchConfigTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.PATCH_CONFIG)
             .description('Apply RFC 6902 JSON Patch operations to the current agent configuration. ' +
             'Pass an array of patch operations as a JSON string. ' +
-            'Requires baseConfigHash from the immediately preceding read_config result, or from a stale retry response. ' +
-            'Do not use a configHash copied from the prompt snapshot. ' +
+            'Requires baseConfigHash from the immediately preceding read_config result — never from a prior ' +
+            'write_config/patch_config success or from a stale response. ' +
             'Supported ops: add, remove, replace, move, copy, test. ' +
-            'Returns { ok: true, config, configHash, updatedAt, versionId } on success or ' +
+            'Returns { ok: true } on success — no config, hash, or timestamps are returned; call ' +
+            'read_config again before any later inspection or mutation — or ' +
             '{ ok: false, stage, errors } on failure. ' +
-            'stage is "parse", "stale", "patch", or "schema".')
+            'stage is "parse", "stale", "patch", or "schema". On stage: "stale", call read_config and retry ' +
+            'once using its fresh config and configHash.')
             .input(zod_1.z.object({
             operations: zod_1.z.string().describe('RFC 6902 JSON Patch operations array as a JSON string'),
             baseConfigHash: zod_1.z
@@ -295,7 +264,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
                 };
             }
             if (baseConfigHash !== snapshot.configHash) {
-                return { ok: false, stage: 'stale', errors: [STALE_CONFIG_ERROR], ...snapshot };
+                return { ok: false, stage: 'stale', errors: [STALE_CONFIG_ERROR] };
             }
             if (!snapshot.config) {
                 return {
@@ -304,7 +273,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
                     errors: [{ path: '(root)', message: 'Agent has no JSON config yet.' }],
                 };
             }
-            const jsonpatch = (await Promise.resolve().then(() => __importStar(require('fast-json-patch')))).default;
+            const jsonpatch = (await import('fast-json-patch')).default;
             const ops = parsedOps.data;
             const patchError = jsonpatch.validate(ops, snapshot.config);
             if (patchError) {
@@ -335,11 +304,8 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             }
             const configWithDefaults = applyPromptCachingBuilderDefaults((0, agent_config_1.applyNativeWebSearchDefaultOn)(zodResult.data));
             try {
-                const result = await this.agentConfigService.updateConfig(agentId, projectId, configWithDefaults);
-                return {
-                    ok: true,
-                    ...snapshotFromConfig(result.config, result.updatedAt, result.versionId),
-                };
+                await this.agentConfigService.updateConfig(agentId, projectId, configWithDefaults);
+                return { ok: true };
             }
             catch (e) {
                 return {
@@ -356,9 +322,8 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             'credential types it supports (`credentialTypes: string[]`) and builder guidance ' +
             '(`capabilities`, `useIntegrationWhen`, `useNodeToolWhen`). ' +
             'Use that guidance to decide whether the user needs a chat integration or a node tool. ' +
-            'Call this BEFORE asking the user for a credential. Then pick ONE entry from the ' +
-            'returned `credentialTypes` and pass it to `ask_credential` as the singular ' +
-            '`credentialType` arg.')
+            'For a chat integration, pass the selected integration `type` to `configure_channel`; ' +
+            'never use `ask_credential` for chat-channel credentials.')
             .input(zod_1.z.object({}))
             .handler(async () => this.agentIntegrationPersistenceService.listChatIntegrations())
             .build();
@@ -380,6 +345,69 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             };
         })
             .build();
+        const publishAgentTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.PUBLISH_AGENT)
+            .description('Publish this target agent so it becomes live: integrations sync and scheduled tasks start running. ' +
+            'Idempotent when the draft is already the active published version. Pass optional `versionId` to ' +
+            'activate an existing history row instead of publishing the current draft. Call only when the user ' +
+            'asks to publish, activate, or make the agent live/usable — never tell them to click Publish in the editor. ' +
+            'Returns { ok: true, agentId, activeVersionId, versionId } or { ok: false, errors }.')
+            .input(zod_1.z.object({
+            versionId: zod_1.z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Optional history version ID to activate. Omit to publish the current draft.'),
+        }))
+            .handler(async ({ versionId }) => {
+            if (!(await (0, check_access_1.userHasScopes)(user, ['agent:publish'], false, { projectId }))) {
+                return {
+                    ok: false,
+                    errors: [{ message: 'You do not have permission to publish agents in this project.' }],
+                };
+            }
+            try {
+                const { agent } = await this.agentPublishService.publishAgent(agentId, projectId, user, versionId);
+                return {
+                    ok: true,
+                    agentId,
+                    activeVersionId: agent.activeVersionId,
+                    versionId: agent.versionId,
+                };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const unpublishAgentTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.UNPUBLISH_AGENT)
+            .description('Unpublish this target agent: clears the live version while preserving the draft, disconnects chat ' +
+            'integrations, and stops scheduled tasks. Call when the user asks to unpublish or take the agent offline. ' +
+            'Returns { ok: true, agentId, activeVersionId: null } or { ok: false, errors }.')
+            .input(zod_1.z.object({}))
+            .handler(async () => {
+            if (!(await (0, check_access_1.userHasScopes)(user, ['agent:unpublish'], false, { projectId }))) {
+                return {
+                    ok: false,
+                    errors: [
+                        { message: 'You do not have permission to unpublish agents in this project.' },
+                    ],
+                };
+            }
+            try {
+                await this.agentPublishService.unpublishAgent(agentId, projectId);
+                return { ok: true, agentId, activeVersionId: null };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
         const modelLookup = {
             list: async (credentialId, credentialType, provider) => await this.builderModelLiveLookupService.list(user, projectId, credentialId, credentialType, provider),
         };
@@ -389,6 +417,8 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             patchConfigTool,
             listIntegrationTypesTool,
             listSubAgentsTool,
+            publishAgentTool,
+            unpublishAgentTool,
             (0, interactive_1.buildResolveLlmTool)({ credentialProvider, modelLookup }),
             (0, interactive_1.buildAskCredentialTool)({
                 credentialProvider,
@@ -414,6 +444,10 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
                 proxyFetch: (0, ai_proxy_fetch_1.createAiMcpFetch)(this.outboundHttp, this.ssrfConfig, this.ssrfProtectionService),
             }),
             (0, search_mcp_servers_tool_1.buildSearchMcpServersTool)({ mcpRegistryService: this.mcpRegistryService }),
+            (0, resolve_integration_tool_1.buildResolveIntegrationTool)({
+                mcpRegistryService: this.mcpRegistryService,
+                agentsToolsService: this.agentsToolsService,
+            }),
         ];
         return tools;
     }
@@ -426,7 +460,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             'This does NOT register the tool in the agent config — follow up with ' +
             'patch_config (or write_config) to add `{ type: "custom", id: "<tool name>" }` ' +
             'to `tools`.' +
-            'Returns { ok: true, id, descriptor } or { ok: false, errors }.')
+            'Returns { ok: true, id, name } or { ok: false, errors }.')
             .input(zod_1.z.object({
             code: zod_1.z
                 .string()
@@ -436,7 +470,7 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             try {
                 const descriptor = await this.secureRuntime.describeToolSecurely(code);
                 const built = await this.agentCustomToolsService.buildCustomTool(agentId, projectId, code, descriptor);
-                return { ok: true, id: built.id, descriptor };
+                return { ok: true, id: built.id, name: descriptor.name };
             }
             catch (e) {
                 return {
@@ -446,31 +480,39 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             }
         })
             .build();
-        const createSkillTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.CREATE_SKILL)
-            .description('Create and store an agent skill (a reusable, load-on-demand capability). Pass the skill name, a ' +
-            'routing description, and the full skill instructions. The description is what the runtime sees when ' +
-            'deciding when to load it, and the instructions MUST follow the required structured format (Overview, ' +
-            'Inputs, Steps, Rules, Example, Gotchas) filled with concrete content — see the instructions parameter ' +
-            'for the template. You MUST NOT call this with a vague description or thin/placeholder instructions: ' +
-            'if you lack the domain detail to write a genuinely useful skill, ask the user clarifying ' +
-            'questions first. Use allowedTools only with exact target-agent tool names, ' +
-            'and references only for markdown supporting files under the references/ directory. References are not automatically loaded; when you provide references, instructions must say exactly when to load each one by path. Scripts and non-markdown linked files are not supported. ' +
-            'This does NOT attach the skill to the agent config; follow up with read_config ' +
-            'and patch_config (or write_config) to add a `{ type: "skill", id }` entry to `skills`. ' +
-            'Returns { ok: true, id, skill } or { ok: false, errors }.')
-            .systemInstruction('Never create a vague or placeholder skill. The description is the routing contract (what the ' +
-            'skill does + when to load it); the instructions must follow the required structured Markdown template ' +
-            '(Overview, Inputs, Steps, Rules, Example, Gotchas) with each applicable section filled in with ' +
-            'concrete, specific content. If you do not have enough domain detail to write a genuinely ' +
-            'useful skill, ask the user clarifying questions until you do before calling create_skill. ' +
-            'Do not create references unless the instructions include explicit conditions for loading each referenced file. ' +
-            'Do not invent tool names or reference paths.')
-            .input(createSkillInputSchema)
-            .handler(async (input) => {
-            const skill = input;
+        const createSkillsTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.CREATE_SKILLS)
+            .description('Create and store one or more agent skills (reusable, load-on-demand capabilities) in a ' +
+            'single call. Pass every skill you currently know how to write in one `skills` array — do ' +
+            "not spread multiple fully-specified skills across separate calls; each skill's instructions " +
+            'field carries its own structured template. The whole batch is all-or-nothing: an invalid or ' +
+            'duplicate-named skill rejects every skill in the call. This does NOT attach the skills to the ' +
+            'agent config; follow up with read_config and patch_config (or write_config) to add a ' +
+            '`{ type: "skill", id }` entry per skill to `skills`. Returns { ok: true, skills: [{ id, name }, ' +
+            '...] } (same order as input, bodies are not echoed back) or { ok: false, errors }.')
+            .systemInstruction('Never create a vague or placeholder skill. The description field is the routing contract the ' +
+            'runtime uses to decide when to load the skill; the instructions must follow the required ' +
+            'structured Markdown template (Overview, Inputs, Steps, Rules, Example, Gotchas) with each ' +
+            'applicable section filled in with concrete, specific content. If you do not have enough domain ' +
+            'detail to write a genuinely useful skill, ask the user clarifying questions until you do before ' +
+            'calling create_skills. Use allowedTools only with exact target-agent tool names. Use references ' +
+            'only for markdown supporting files under the references/ directory — references are not ' +
+            'automatically loaded, so instructions must say exactly when to load each one by path; scripts and ' +
+            'non-markdown linked files are not supported. Do not invent tool names or reference paths. Batch ' +
+            'every skill you currently know how to write into one call.')
+            .input(zod_1.z.object({
+            skills: zod_1.z
+                .array(createSkillInputSchema)
+                .min(1)
+                .max(20)
+                .describe('Every skill to create, in the order they should be created.'),
+        }))
+            .handler(async ({ skills }) => {
             try {
-                const created = await this.agentSkillsService.createSkill(agentId, projectId, skill);
-                return { ok: true, id: created.id, skill: created.skill };
+                const created = await this.agentSkillsService.createSkills(agentId, projectId, skills);
+                return {
+                    ok: true,
+                    skills: created.map(({ id, skill }) => ({ id, name: skill.name })),
+                };
             }
             catch (e) {
                 return {
@@ -480,45 +522,43 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             }
         })
             .build();
-        const createTaskTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.CREATE_TASK)
-            .description('Create a recurring scheduled task for the target agent (name + objective + cron schedule). ' +
-            'The objective is the exact message the agent receives on each run, so it must be precise and ' +
-            'self-contained, and it MUST follow the required structured format (Objective, Context, Steps, ' +
-            'Output, Constraints, Success criteria) with every section filled in — see the objective ' +
-            'parameter for the template. You MUST NOT call this tool with a vague, broad, or placeholder ' +
-            'objective, an objective missing any section, or an unclear schedule. First make sure you can ' +
-            'fill every section of the template and know how often/when it should run; if anything is ' +
-            'ambiguous, ask the user clarifying questions (ask_questions with discrete options for choices, ' +
-            'or type: "text" for open-ended) and only call create_task once the objective is complete and the cadence ' +
-            'is known. This adds a `{ type: "task", id, enabled }` ref to the agent config (config.tasks) ' +
-            'and the task starts running once the agent is (re)published. Returns { ok: true, task } or ' +
-            '{ ok: false, errors }.')
-            .systemInstruction('Never create a task with a vague or placeholder objective. The objective must follow the ' +
-            'required structured Markdown template (Objective, Context, Steps, Output, Constraints, ' +
-            'Success criteria) with every section filled in with concrete content. If the user has not ' +
-            'given you enough detail to complete every section and set a clear schedule, ask clarifying ' +
-            'questions first. A task can only use tools the agent already has: if any step in the ' +
-            'objective requires a tool, integration, or web search the agent is missing, you MUST add ' +
-            'it to the agent config (patch_config/write_config) BEFORE calling create_task — otherwise ' +
-            'the task will fail at runtime.')
+        const createTasksTool = new tool_1.Tool(builder_tool_names_1.BUILDER_TOOLS.CREATE_TASKS)
+            .description('Create one or more recurring scheduled tasks for the target agent (name + objective + cron ' +
+            'schedule per task) in a single call. Pass every task you currently know how to write in one ' +
+            "`tasks` array — do not spread multiple fully-specified tasks across separate calls; each task's " +
+            'objective field carries its own structured template. The whole batch is all-or-nothing: an ' +
+            'invalid cron or objective rejects every task in the call. This adds a `{ type: "task", id, ' +
+            'enabled }` ref per task to the agent config (config.tasks) and each task starts running once ' +
+            'the agent is (re)published via `publish_agent`. Returns { ok: true, tasks: [{ id, name, enabled }, ...] } (same ' +
+            'order as input, objectives and crons are not echoed back) or { ok: false, errors }.')
+            .systemInstruction('Never create a task with a vague, broad, or placeholder objective, an objective missing any ' +
+            'required section, or an unclear schedule. Each objective must follow the required structured ' +
+            'Markdown template (Objective, Context, Steps, Output, Constraints, Success criteria) with every ' +
+            'section filled in with concrete content — it is the exact, self-contained message the agent ' +
+            'receives on each unattended run. If anything is ambiguous, ask the user clarifying questions ' +
+            '(ask_questions with discrete options for choices, or type: "text" for open-ended) before calling ' +
+            'create_tasks. A task can only use tools the agent already has: if any step in an objective ' +
+            'requires a tool, integration, or web search the agent is missing, you MUST add it to the agent ' +
+            'config (patch_config/write_config) BEFORE calling create_tasks — otherwise the task will fail at ' +
+            'runtime. Batch every task you currently know how to write into one call.')
             .input(zod_1.z.object({
-            name: api_types_1.agentTaskSchema.shape.name.describe('Short, human-readable task name.'),
-            objective: api_types_1.agentTaskSchema.shape.objective.describe(task_objective_template_1.TASK_OBJECTIVE_GUIDANCE),
-            cronExpression: api_types_1.agentTaskSchema.shape.cronExpression.describe('A 5-field cron expression for when the task runs, e.g. "0 9 * * 1-5" = weekdays at 09:00.'),
+            tasks: zod_1.z
+                .array(zod_1.z.object({
+                name: api_types_1.agentTaskSchema.shape.name.describe('Short, human-readable task name.'),
+                objective: api_types_1.agentTaskSchema.shape.objective.describe(task_objective_template_1.TASK_OBJECTIVE_GUIDANCE),
+                cronExpression: api_types_1.agentTaskSchema.shape.cronExpression.describe('A 5-field cron expression for when the task runs, e.g. "0 9 * * 1-5" = weekdays at 09:00.'),
+            }))
+                .min(1)
+                .max(20)
+                .describe('Every task to create, in the order they should be created.'),
         }))
-            .handler(async ({ name, objective, cronExpression, }) => {
-            const agent = await this.agentRepository.findByIdAndProjectId(agentId, projectId);
-            if (!agent) {
-                return { ok: false, errors: [{ message: 'Agent not found' }] };
-            }
+            .handler(async ({ tasks, }) => {
             try {
-                const task = await this.agentTaskService.create(agentId, {
-                    name,
-                    objective,
-                    cronExpression,
-                    enabled: true,
-                });
-                return { ok: true, task };
+                const created = await this.agentTaskService.createTasks(agentId, projectId, tasks.map((task) => ({ ...task, enabled: true })));
+                return {
+                    ok: true,
+                    tasks: created.map(({ id, name }) => ({ id, name, enabled: true })),
+                };
             }
             catch (e) {
                 return {
@@ -530,8 +570,6 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             .build();
         const listWorkflowsTool = new tool_1.Tool('list_workflows')
             .description('List the n8n workflows that can be attached as tools via `type: "workflow"` in the agent config. ' +
-            'ALWAYS call this at the start — workflows are the preferred way to give agents real capabilities ' +
-            '(sending emails, creating calendar events, querying databases, calling APIs, etc.). ' +
             'Only returns workflows with supported trigger types. Pass `searchTerm` to narrow by workflow name; ' +
             'omitting it returns the 10 most recently updated attachable workflows.')
             .input(zod_1.z.object({
@@ -548,8 +586,8 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
             .build();
         return [
             buildCustomToolTool,
-            createSkillTool,
-            createTaskTool,
+            createSkillsTool,
+            createTasksTool,
             listWorkflowsTool,
             (0, get_resource_locator_options_tool_1.buildGetResourceLocatorOptionsTool)({
                 dynamicNodeParametersService: this.dynamicNodeParametersService,
@@ -567,31 +605,12 @@ let AgentsBuilderToolsService = class AgentsBuilderToolsService {
         if (!agent)
             throw new Error('Agent not found');
         const config = (0, agent_config_composition_1.composeJsonConfig)(agent);
-        return snapshotFromConfig(config, agent.updatedAt.toISOString(), agent.versionId);
+        return snapshotFromConfig(config);
     }
 };
 exports.AgentsBuilderToolsService = AgentsBuilderToolsService;
 exports.AgentsBuilderToolsService = AgentsBuilderToolsService = __decorate([
     (0, di_1.Service)(),
-    __metadata("design:paramtypes", [agents_service_1.AgentsService,
-        agent_config_service_1.AgentConfigService,
-        agent_custom_tools_service_1.AgentCustomToolsService,
-        agent_integration_persistence_service_1.AgentIntegrationPersistenceService,
-        agent_skills_service_1.AgentSkillsService,
-        agent_secure_runtime_1.AgentSecureRuntime,
-        attachable_workflows_service_1.AttachableWorkflowsService,
-        agents_tools_service_1.AgentsToolsService,
-        builder_model_live_lookup_service_1.BuilderModelLiveLookupService,
-        mcp_registry_service_1.McpRegistryService,
-        oauth_service_1.OauthService,
-        credential_types_1.CredentialTypes,
-        agent_task_service_1.AgentTaskService,
-        agent_repository_1.AgentRepository,
-        ai_service_1.AiService,
-        backend_network_1.OutboundHttp,
-        dynamic_node_parameters_service_1.DynamicNodeParametersService,
-        node_types_1.NodeTypes,
-        config_1.SsrfProtectionConfig,
-        backend_network_1.SsrfProtectionService])
+    __metadata("design:paramtypes", [agents_service_1.AgentsService, agent_config_service_1.AgentConfigService, agent_custom_tools_service_1.AgentCustomToolsService, agent_integration_persistence_service_1.AgentIntegrationPersistenceService, agent_skills_service_1.AgentSkillsService, agent_secure_runtime_1.AgentSecureRuntime, attachable_workflows_service_1.AttachableWorkflowsService, agents_tools_service_1.AgentsToolsService, builder_model_live_lookup_service_1.BuilderModelLiveLookupService, mcp_registry_service_1.McpRegistryService, oauth_service_1.OauthService, credential_types_1.CredentialTypes, agent_task_service_1.AgentTaskService, agent_publish_service_1.AgentPublishService, ai_service_1.AiService, backend_network_1.OutboundHttp, dynamic_node_parameters_service_1.DynamicNodeParametersService, node_types_1.NodeTypes, config_1.SsrfProtectionConfig, backend_network_1.SsrfProtectionService])
 ], AgentsBuilderToolsService);
 //# sourceMappingURL=agents-builder-tools.service.js.map