n8n 2.20.6 → 2.21.0

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

@@ -0,0 +1,420 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsBuilderToolsService = void 0;
+exports.getAgentConfigHash = getAgentConfigHash;
+const agents_1 = require("@n8n/agents");
+const api_types_1 = require("@n8n/api-types");
+const db_1 = require("@n8n/db");
+const di_1 = require("@n8n/di");
+const node_crypto_1 = require("node:crypto");
+const zod_1 = require("zod");
+const agents_tools_service_1 = require("../agents-tools.service");
+const agents_service_1 = require("../agents.service");
+const agent_config_composition_1 = require("../json-config/agent-config-composition");
+const agent_json_config_1 = require("../json-config/agent-json-config");
+const agent_secure_runtime_1 = require("../runtime/agent-secure-runtime");
+const builder_model_lookup_service_1 = require("./builder-model-lookup.service");
+const interactive_1 = require("./interactive");
+const builder_tool_names_1 = require("./builder-tool-names");
+const EMPTY_INSTRUCTIONS_ERROR = {
+    path: '/instructions',
+    message: 'Refusing to write an agent with empty instructions. Ask the user what the agent should do before calling write_config or patch_config again.',
+};
+const STALE_CONFIG_ERROR = {
+    path: '(root)',
+    message: 'Agent config changed since you last read it. Call read_config and retry with the returned configHash.',
+};
+function rejectIfEmptyInstructions(config) {
+    if (!config.instructions.trim()) {
+        return { errors: [EMPTY_INSTRUCTIONS_ERROR] };
+    }
+    return null;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function canonicalizeJson(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => canonicalizeJson(item));
+    }
+    if (!isRecord(value))
+        return value;
+    const sorted = {};
+    for (const key of Object.keys(value).sort()) {
+        sorted[key] = canonicalizeJson(value[key]);
+    }
+    return sorted;
+}
+function getAgentConfigHash(config) {
+    if (!config)
+        return null;
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(JSON.stringify(canonicalizeJson(config)))
+        .digest('hex');
+}
+function snapshotFromConfig(config, updatedAt, versionId) {
+    return {
+        config,
+        configHash: getAgentConfigHash(config),
+        updatedAt,
+        versionId,
+    };
+}
+let AgentsBuilderToolsService = class AgentsBuilderToolsService {
+    constructor(agentsService, secureRuntime, workflowRepository, agentsToolsService, builderModelLookupService) {
+        this.agentsService = agentsService;
+        this.secureRuntime = secureRuntime;
+        this.workflowRepository = workflowRepository;
+        this.agentsToolsService = agentsToolsService;
+        this.builderModelLookupService = builderModelLookupService;
+    }
+    getTools(agentId, projectId, credentialProvider, user) {
+        return {
+            json: this.getJsonTools(agentId, projectId, credentialProvider, user),
+            shared: this.getSharedTools(agentId, projectId, credentialProvider),
+        };
+    }
+    getJsonTools(agentId, projectId, credentialProvider, user) {
+        const readConfigTool = new agents_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 }. ' +
+            'Call this before every write_config or patch_config and use configHash as baseConfigHash.')
+            .input(zod_1.z.object({}))
+            .handler(async () => {
+            try {
+                return { ok: true, ...(await this.getConfigSnapshot(agentId, projectId)) };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ path: '(root)', message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const writeConfigTool = new agents_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.')
+            .input(zod_1.z.object({
+            json: zod_1.z.string().describe('Complete agent configuration as a JSON string'),
+            baseConfigHash: zod_1.z
+                .string()
+                .nullable()
+                .describe('configHash from the immediately preceding read_config result; null only if no config exists'),
+        }))
+            .handler(async ({ json, baseConfigHash }) => {
+            const parsed = (0, agent_json_config_1.tryParseConfigJson)(json);
+            if (!parsed.ok) {
+                return { ok: false, errors: parsed.errors };
+            }
+            let snapshot;
+            try {
+                snapshot = await this.getConfigSnapshot(agentId, projectId);
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    stage: 'stale',
+                    errors: [{ path: '(root)', message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+            if (baseConfigHash !== snapshot.configHash) {
+                return { ok: false, stage: 'stale', errors: [STALE_CONFIG_ERROR], ...snapshot };
+            }
+            const zodResult = agent_json_config_1.AgentJsonConfigSchema.safeParse(parsed.data);
+            if (!zodResult.success) {
+                return { ok: false, errors: (0, agent_json_config_1.formatZodErrors)(zodResult.error) };
+            }
+            const emptyInstructions = rejectIfEmptyInstructions(zodResult.data);
+            if (emptyInstructions) {
+                return { ok: false, errors: emptyInstructions.errors };
+            }
+            try {
+                const result = await this.agentsService.updateConfig(agentId, projectId, zodResult.data);
+                return {
+                    ok: true,
+                    ...snapshotFromConfig(result.config, result.updatedAt, result.versionId),
+                };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    stage: 'schema',
+                    errors: [{ path: '(root)', message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const patchConfigTool = new agents_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. ' +
+            'Supported ops: add, remove, replace, move, copy, test. ' +
+            'Returns { ok: true, config, configHash, updatedAt, versionId } on success or ' +
+            '{ ok: false, stage, errors } on failure. ' +
+            'stage is "parse", "stale", "patch", or "schema".')
+            .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
+                .string()
+                .nullable()
+                .describe('configHash from the immediately preceding read_config result; null only if no config exists'),
+        }))
+            .handler(async ({ operations, baseConfigHash, }) => {
+            const parsedOps = (0, agent_json_config_1.tryParseConfigJson)(operations);
+            if (!parsedOps.ok) {
+                return { ok: false, stage: 'parse', errors: parsedOps.errors };
+            }
+            let snapshot;
+            try {
+                snapshot = await this.getConfigSnapshot(agentId, projectId);
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    stage: 'stale',
+                    errors: [{ path: '(root)', message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+            if (baseConfigHash !== snapshot.configHash) {
+                return { ok: false, stage: 'stale', errors: [STALE_CONFIG_ERROR], ...snapshot };
+            }
+            if (!snapshot.config) {
+                return {
+                    ok: false,
+                    stage: 'patch',
+                    errors: [{ path: '(root)', message: 'Agent has no JSON config yet.' }],
+                };
+            }
+            const jsonpatch = (await Promise.resolve().then(() => __importStar(require('fast-json-patch')))).default;
+            const ops = parsedOps.data;
+            const patchError = jsonpatch.validate(ops, snapshot.config);
+            if (patchError) {
+                const opPath = patchError.operation?.path ?? '(root)';
+                return {
+                    ok: false,
+                    stage: 'patch',
+                    errors: [{ path: opPath, message: patchError.message ?? 'Invalid patch operation' }],
+                };
+            }
+            const patched = jsonpatch.applyPatch(jsonpatch.deepClone(snapshot.config), ops)
+                .newDocument;
+            const zodResult = agent_json_config_1.AgentJsonConfigSchema.safeParse(patched);
+            if (!zodResult.success) {
+                return { ok: false, stage: 'schema', errors: (0, agent_json_config_1.formatZodErrors)(zodResult.error) };
+            }
+            const emptyInstructions = rejectIfEmptyInstructions(zodResult.data);
+            if (emptyInstructions) {
+                return { ok: false, stage: 'schema', errors: emptyInstructions.errors };
+            }
+            try {
+                const result = await this.agentsService.updateConfig(agentId, projectId, zodResult.data);
+                return {
+                    ok: true,
+                    ...snapshotFromConfig(result.config, result.updatedAt, result.versionId),
+                };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    stage: 'schema',
+                    errors: [{ path: '(root)', message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const listIntegrationTypesTool = new agents_1.Tool(builder_tool_names_1.BUILDER_TOOLS.LIST_INTEGRATION_TYPES)
+            .description("List trigger / integration types that can be added to the agent's `integrations` array. " +
+            'Returns the schedule trigger plus every connected chat platform with the list of ' +
+            'credential types it supports (`credentialTypes: string[]`). ' +
+            'Call this BEFORE asking the user for a credential. Then pick ONE entry from the ' +
+            'returned `credentialTypes` (prefer the OAuth variant if present, e.g. `slackOAuth2Api` ' +
+            'over `slackApi`) and pass it to `ask_credential` as the singular `credentialType` arg.')
+            .input(zod_1.z.object({}))
+            .handler(async () => {
+            const chat = this.agentsService.listChatIntegrations();
+            return [
+                { type: 'schedule', label: 'Schedule', icon: 'clock', credentialTypes: [] },
+                ...chat,
+            ];
+        })
+            .build();
+        const modelLookup = {
+            list: async (credentialId, credentialType, lookup) => await this.builderModelLookupService.list(user, credentialId, credentialType, lookup),
+        };
+        return [
+            readConfigTool,
+            writeConfigTool,
+            patchConfigTool,
+            listIntegrationTypesTool,
+            (0, interactive_1.buildResolveLlmTool)({ credentialProvider, modelLookup }),
+            (0, interactive_1.buildAskCredentialTool)({ credentialProvider }),
+            (0, interactive_1.buildAskLlmTool)(),
+            (0, interactive_1.buildAskQuestionTool)(),
+        ];
+    }
+    getSharedTools(agentId, projectId, credentialProvider) {
+        const buildCustomToolTool = new agents_1.Tool(builder_tool_names_1.BUILDER_TOOLS.BUILD_CUSTOM_TOOL)
+            .description('Compile and store a custom tool. Pass the complete TypeScript source ' +
+            'using `export default new Tool(...)` builder chain. The code is validated in a ' +
+            'sandbox and saved against the agent, but this does NOT register the tool in the ' +
+            'agent config — follow up with patch_config (or write_config) to add a ' +
+            '`{ type: "custom", id }` entry to `tools` so the agent actually uses it. ' +
+            'Returns { ok: true, id, descriptor } or { ok: false, errors }.')
+            .input(zod_1.z.object({
+            code: zod_1.z
+                .string()
+                .describe('Complete TypeScript source using export default new Tool(...)'),
+        }))
+            .handler(async ({ code }) => {
+            try {
+                const descriptor = await this.secureRuntime.describeToolSecurely(code);
+                const built = await this.agentsService.buildCustomTool(agentId, projectId, code, descriptor);
+                return { ok: true, id: built.id, descriptor };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const createSkillTool = new agents_1.Tool(builder_tool_names_1.BUILDER_TOOLS.CREATE_SKILL)
+            .description('Create and store an agent skill. Pass the skill name, a short description, and the full skill body. ' +
+            'The description should help the runtime decide when to load it. ' +
+            'The body is stored as the skill instructions, but 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 }.')
+            .input(zod_1.z.object({
+            name: api_types_1.agentSkillSchema.shape.name.describe('Human-readable skill name'),
+            description: api_types_1.agentSkillSchema.shape.description.describe('Short description of when to load the skill.'),
+            body: api_types_1.agentSkillSchema.shape.instructions.describe('Full skill instructions/body'),
+        }))
+            .handler(async ({ name, description, body, }) => {
+            const skill = { name, description, instructions: body };
+            const validation = api_types_1.agentSkillSchema.safeParse(skill);
+            if (!validation.success) {
+                return { ok: false, errors: (0, agent_json_config_1.formatZodErrors)(validation.error) };
+            }
+            try {
+                const created = await this.agentsService.createSkill(agentId, projectId, skill);
+                return { ok: true, id: created.id, skill: created.skill };
+            }
+            catch (e) {
+                return {
+                    ok: false,
+                    errors: [{ message: e instanceof Error ? e.message : String(e) }],
+                };
+            }
+        })
+            .build();
+        const listWorkflowsTool = new agents_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.')
+            .input(zod_1.z.object({}))
+            .handler(async () => {
+            const workflows = await this.workflowRepository.find({
+                select: ['id', 'name', 'nodes', 'active', 'updatedAt'],
+                where: { shared: { projectId } },
+                relations: ['shared'],
+                order: { updatedAt: 'DESC' },
+                take: 100,
+            });
+            const SUPPORTED_TRIGGERS = {
+                'n8n-nodes-base.manualTrigger': 'manual',
+                'n8n-nodes-base.executeWorkflowTrigger': 'executeWorkflow',
+                'n8n-nodes-base.chatTrigger': 'chat',
+                'n8n-nodes-base.scheduleTrigger': 'schedule',
+                'n8n-nodes-base.formTrigger': 'form',
+            };
+            const compatible = workflows
+                .map((w) => {
+                const triggerNode = (w.nodes ?? []).find((n) => SUPPORTED_TRIGGERS[n.type]);
+                if (!triggerNode)
+                    return null;
+                return {
+                    name: w.name,
+                    active: w.active,
+                    triggerType: SUPPORTED_TRIGGERS[triggerNode.type],
+                };
+            })
+                .filter(Boolean);
+            return { workflows: compatible };
+        })
+            .build();
+        return [
+            buildCustomToolTool,
+            createSkillTool,
+            listWorkflowsTool,
+            ...this.agentsToolsService.getSharedTools(credentialProvider, 'Read-only inspection of available credentials. Use ask_credential to let the user ' +
+                'pick the credential to wire into a node tool — never copy ids from this list directly ' +
+                'into the config.'),
+        ];
+    }
+    async getConfigSnapshot(agentId, projectId) {
+        const agent = await this.agentsService.findById(agentId, projectId);
+        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);
+    }
+};
+exports.AgentsBuilderToolsService = AgentsBuilderToolsService;
+exports.AgentsBuilderToolsService = AgentsBuilderToolsService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [agents_service_1.AgentsService,
+        agent_secure_runtime_1.AgentSecureRuntime,
+        db_1.WorkflowRepository,
+        agents_tools_service_1.AgentsToolsService,
+        builder_model_lookup_service_1.BuilderModelLookupService])
+], AgentsBuilderToolsService);
+//# sourceMappingURL=agents-builder-tools.service.js.map

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

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

package/dist/modules/agents/builder/agents-builder.service.d.ts

@@ -0,0 +1,26 @@
+import type { CredentialProvider, SerializableAgentState, StreamChunk } from '@n8n/agents';
+import { Logger } from '@n8n/backend-common';
+import type { User } from '@n8n/db';
+import { AgentsService } from '../agents.service';
+import { N8NCheckpointStorage } from '../integrations/n8n-checkpoint-storage';
+import { N8nMemory } from '../integrations/n8n-memory';
+import { AgentCheckpointRepository } from '../repositories/agent-checkpoint.repository';
+import { AgentsBuilderToolsService } from './agents-builder-tools.service';
+import { AgentsBuilderSettingsService } from './agents-builder-settings.service';
+export declare class AgentsBuilderService {
+    private readonly logger;
+    private readonly agentsService;
+    private readonly agentsBuilderToolsService;
+    private readonly n8nMemory;
+    private readonly builderSettings;
+    private readonly n8nCheckpointStorage;
+    private readonly agentCheckpointRepository;
+    constructor(logger: Logger, agentsService: AgentsService, agentsBuilderToolsService: AgentsBuilderToolsService, n8nMemory: N8nMemory, builderSettings: AgentsBuilderSettingsService, n8nCheckpointStorage: N8NCheckpointStorage, agentCheckpointRepository: AgentCheckpointRepository);
+    getBuilderMessages(agentId: string): Promise<import("@n8n/agents").AgentDbMessage[]>;
+    clearBuilderMessages(agentId: string): Promise<void>;
+    buildAgent(agentId: string, projectId: string, message: string, credentialProvider: CredentialProvider, user: User): AsyncGenerator<StreamChunk>;
+    resumeBuild(agentId: string, projectId: string, runId: string, toolCallId: string, resumeData: unknown, credentialProvider: CredentialProvider, user: User): AsyncGenerator<StreamChunk>;
+    private createBuilderAgent;
+    private streamFromAgent;
+    findOpenCheckpoint(agentId: string): Promise<SerializableAgentState | null>;
+}

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

@@ -0,0 +1,164 @@
+"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.AgentsBuilderService = void 0;
+const agents_1 = require("@n8n/agents");
+const backend_common_1 = require("@n8n/backend-common");
+const di_1 = require("@n8n/di");
+const n8n_workflow_1 = require("n8n-workflow");
+const agents_service_1 = require("../agents.service");
+const agent_config_composition_1 = require("../json-config/agent-config-composition");
+const n8n_checkpoint_storage_1 = require("../integrations/n8n-checkpoint-storage");
+const n8n_memory_1 = require("../integrations/n8n-memory");
+const agent_checkpoint_repository_1 = require("../repositories/agent-checkpoint.repository");
+const agents_builder_prompts_1 = require("./agents-builder-prompts");
+const agents_builder_tools_service_1 = require("./agents-builder-tools.service");
+const builder_tool_names_1 = require("./builder-tool-names");
+const not_found_error_1 = require("../../../errors/response-errors/not-found.error");
+const agents_builder_settings_service_1 = require("./agents-builder-settings.service");
+const builder_telemetry_1 = require("../tracing/builder-telemetry");
+const BUILDER_MODEL = 'anthropic/claude-sonnet-4-5';
+function builderThreadId(agentId) {
+    return `${builder_tool_names_1.AGENT_THREAD_PREFIX.BUILDER}${agentId}`;
+}
+let AgentsBuilderService = class AgentsBuilderService {
+    constructor(logger, agentsService, agentsBuilderToolsService, n8nMemory, builderSettings, n8nCheckpointStorage, agentCheckpointRepository) {
+        this.logger = logger;
+        this.agentsService = agentsService;
+        this.agentsBuilderToolsService = agentsBuilderToolsService;
+        this.n8nMemory = n8nMemory;
+        this.builderSettings = builderSettings;
+        this.n8nCheckpointStorage = n8nCheckpointStorage;
+        this.agentCheckpointRepository = agentCheckpointRepository;
+    }
+    async getBuilderMessages(agentId) {
+        const threadId = builderThreadId(agentId);
+        return await this.n8nMemory.getMessages(threadId);
+    }
+    async clearBuilderMessages(agentId) {
+        const threadId = builderThreadId(agentId);
+        await this.n8nMemory.deleteMessagesByThread(threadId);
+        await this.n8nMemory.deleteThread(threadId);
+    }
+    async *buildAgent(agentId, projectId, message, credentialProvider, user) {
+        const builder = await this.createBuilderAgent(agentId, projectId, credentialProvider, user);
+        this.logger.debug('Starting builder agent stream', { agentId, projectId });
+        const resourceId = user.id;
+        const resultStream = await builder.stream(message, {
+            persistence: { threadId: builderThreadId(agentId), resourceId },
+        });
+        yield* this.streamFromAgent(resultStream);
+    }
+    async *resumeBuild(agentId, projectId, runId, toolCallId, resumeData, credentialProvider, user) {
+        const checkpointStatus = await this.n8nCheckpointStorage.getStatus(runId);
+        if (checkpointStatus.status === 'expired') {
+            throw new n8n_workflow_1.UserError(`Builder checkpoint ${runId} has expired and cannot be resumed`);
+        }
+        if (checkpointStatus.status === 'not-found') {
+            throw new n8n_workflow_1.UserError(`Builder checkpoint ${runId} not found`);
+        }
+        const builder = await this.createBuilderAgent(agentId, projectId, credentialProvider, user);
+        this.logger.debug('Resuming builder agent', { agentId, runId, toolCallId });
+        const resultStream = await builder.resume('stream', resumeData, {
+            runId,
+            toolCallId,
+        });
+        yield* this.streamFromAgent(resultStream);
+    }
+    async createBuilderAgent(agentId, projectId, credentialProvider, user) {
+        const agent = await this.agentsService.findById(agentId, projectId);
+        if (!agent) {
+            throw new not_found_error_1.NotFoundError(`Agent "${agentId}" not found`);
+        }
+        const { config: modelConfig } = await this.builderSettings.resolveModelConfig(user);
+        const currentConfig = (0, agent_config_composition_1.composeJsonConfig)(agent);
+        const currentToolsMap = agent.tools ?? {};
+        const toolList = Object.entries(currentToolsMap)
+            .map(([id, t]) => `- ${id}: ${t.descriptor.name} -- ${t.descriptor.description}`)
+            .join('\n') || '(none)';
+        const configJson = currentConfig ? JSON.stringify(currentConfig, null, 2) : '(no config yet)';
+        const instructions = (0, agents_builder_prompts_1.buildBuilderPrompt)({
+            configJson,
+            configHash: (0, agents_builder_tools_service_1.getAgentConfigHash)(currentConfig),
+            configUpdatedAt: agent.updatedAt.toISOString(),
+            toolList,
+            builderModel: BUILDER_MODEL,
+        });
+        const tools = this.agentsBuilderToolsService.getTools(agentId, projectId, credentialProvider, user);
+        const builderMemory = new agents_1.Memory().storage(this.n8nMemory).lastMessages(40);
+        const builder = new agents_1.Agent('agent-builder')
+            .model(modelConfig)
+            .instructions(instructions)
+            .memory(builderMemory)
+            .checkpoint(this.n8nCheckpointStorage.getStorage(agentId));
+        const telemetry = (0, builder_telemetry_1.buildBuilderTelemetry)({
+            agentId,
+            projectId,
+            userId: user.id,
+            threadId: builderThreadId(agentId),
+            model: modelConfig,
+        });
+        if (telemetry)
+            builder.telemetry(telemetry);
+        for (const tool of [...tools.json, ...tools.shared]) {
+            builder.tool(tool);
+        }
+        return builder;
+    }
+    async *streamFromAgent(resultStream) {
+        const reader = resultStream.stream.getReader();
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                yield value;
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    async findOpenCheckpoint(agentId) {
+        const rows = await this.agentCheckpointRepository.find({
+            where: { agentId, expired: false },
+            order: { updatedAt: 'DESC' },
+            take: 5,
+        });
+        for (const row of rows) {
+            if (!row.state)
+                continue;
+            let parsed;
+            try {
+                parsed = (0, n8n_workflow_1.jsonParse)(row.state);
+            }
+            catch {
+                continue;
+            }
+            if (parsed.status === 'suspended') {
+                return parsed;
+            }
+        }
+        return null;
+    }
+};
+exports.AgentsBuilderService = AgentsBuilderService;
+exports.AgentsBuilderService = AgentsBuilderService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [backend_common_1.Logger,
+        agents_service_1.AgentsService,
+        agents_builder_tools_service_1.AgentsBuilderToolsService,
+        n8n_memory_1.N8nMemory,
+        agents_builder_settings_service_1.AgentsBuilderSettingsService,
+        n8n_checkpoint_storage_1.N8NCheckpointStorage,
+        agent_checkpoint_repository_1.AgentCheckpointRepository])
+], AgentsBuilderService);
+//# sourceMappingURL=agents-builder.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents-builder.service.js","sourceRoot":"","sources":["../../../../src/modules/agents/builder/agents-builder.service.ts"],"names":[],"mappings":"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"}