n8n 2.28.4 → 2.29.1

package/dist/modules/agents/agent-config.service.js

@@ -0,0 +1,288 @@
+"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.AgentConfigService = void 0;
+const fromai_helpers_1 = require("@n8n/ai-utilities/fromai-helpers");
+const api_types_1 = require("@n8n/api-types");
+const backend_common_1 = require("@n8n/backend-common");
+const di_1 = require("@n8n/di");
+const n8n_workflow_1 = require("n8n-workflow");
+const credentials_service_1 = require("../../credentials/credentials.service");
+const not_found_error_1 = require("../../errors/response-errors/not-found.error");
+const node_definition_resolver_1 = require("../../modules/instance-ai/node-definition-resolver");
+const agent_runtime_cache_service_1 = require("./agent-runtime-cache.service");
+const agent_skills_service_1 = require("./agent-skills.service");
+const integrations_sync_1 = require("./integrations/integrations-sync");
+const agent_config_composition_1 = require("./json-config/agent-config-composition");
+const sanitize_unknown_agent_credentials_1 = require("./json-config/sanitize-unknown-agent-credentials");
+const agent_task_repository_1 = require("./repositories/agent-task.repository");
+const agent_repository_1 = require("./repositories/agent.repository");
+const agent_credential_provider_1 = require("./utils/agent-credential-provider");
+const agent_draft_utils_1 = require("./utils/agent-draft.utils");
+const sub_agent_resolver_1 = require("./utils/sub-agent-resolver");
+let AgentConfigService = class AgentConfigService {
+    constructor(logger, agentRepository, agentTaskRepository, agentSkillsService, runtimeCacheService, credentialsService) {
+        this.logger = logger;
+        this.agentRepository = agentRepository;
+        this.agentTaskRepository = agentTaskRepository;
+        this.agentSkillsService = agentSkillsService;
+        this.runtimeCacheService = runtimeCacheService;
+        this.credentialsService = credentialsService;
+    }
+    async getConfig(agentId, projectId) {
+        const entity = await this.agentRepository.findByIdAndProjectId(agentId, projectId);
+        if (!entity)
+            throw new not_found_error_1.NotFoundError('Agent not found');
+        const config = (0, agent_config_composition_1.composeJsonConfig)(entity);
+        if (!config) {
+            throw new n8n_workflow_1.UserError('Agent has no JSON config yet.');
+        }
+        return config;
+    }
+    async validateConfig(raw) {
+        if (hasNodeToolInputSchema(raw)) {
+            return { valid: false, error: 'Node tool configs must not include inputSchema.' };
+        }
+        const parsed = api_types_1.AgentJsonConfigSchema.safeParse((0, api_types_1.sanitizeAgentJsonConfig)(raw));
+        if (!parsed.success) {
+            return { valid: false, error: parsed.error.message };
+        }
+        const config = parsed.data;
+        try {
+            this.validateNodeToolExpressions(config);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                valid: false,
+                error: `Invalid $fromAI expression in node tool config: ${message}`,
+            };
+        }
+        const nodeError = await this.validateNodeToolConfigs(config);
+        if (nodeError) {
+            return { valid: false, error: nodeError };
+        }
+        return { valid: true, config };
+    }
+    validateNodeToolExpressions(config) {
+        for (const tool of config.tools ?? []) {
+            if (tool.type !== 'node')
+                continue;
+            (0, fromai_helpers_1.extractFromAIParameters)((tool.node.nodeParameters ?? {}));
+        }
+    }
+    async updateConfig(agentId, projectId, config) {
+        const entity = await this.agentRepository.findByIdAndProjectId(agentId, projectId);
+        if (!entity)
+            throw new not_found_error_1.NotFoundError('Agent not found');
+        const credentialProvider = (0, agent_credential_provider_1.createAgentCredentialProvider)(this.credentialsService, projectId);
+        const accessibleCredentialIds = new Set((await credentialProvider.list()).map((credential) => credential.id));
+        const sanitizedConfig = (0, sanitize_unknown_agent_credentials_1.sanitizeUnknownAgentCredentials)((0, api_types_1.sanitizeAgentJsonConfig)(config), accessibleCredentialIds);
+        const result = await this.validateConfig(sanitizedConfig);
+        if (!result.valid) {
+            throw new n8n_workflow_1.UserError(`Invalid agent config: ${result.error}`);
+        }
+        const tasksProvided = result.config.tasks !== undefined;
+        const existingTaskIds = tasksProvided
+            ? (await this.agentTaskRepository.findByAgentId(agentId)).map((task) => task.id)
+            : [];
+        const resolvedSubAgents = await this.removeMissingConfigRefs(result.config, entity, new Set(existingTaskIds));
+        this.validateSubAgentRefs(resolvedSubAgents, entity);
+        const previousIntegrations = entity.integrations ?? [];
+        const previousSchema = entity.schema ?? null;
+        const integrationsProvided = result.config.integrations !== undefined;
+        const toolsProvided = result.config.tools !== undefined;
+        const skillsProvided = result.config.skills !== undefined;
+        const credentialProvided = result.config.credential !== undefined;
+        const memoryProvided = result.config.memory !== undefined;
+        const subAgentsProvided = result.config.subAgents !== undefined;
+        const providerToolsProvided = result.config.providerTools !== undefined;
+        const configBlockProvided = result.config.config !== undefined;
+        const mcpServersProvided = result.config.mcpServers !== undefined;
+        const { schemaConfig: decomposedSchema, integrations: decomposedIntegrations } = (0, agent_config_composition_1.decomposeJsonConfig)(result.config);
+        const nextIntegrations = integrationsProvided ? decomposedIntegrations : previousIntegrations;
+        const nextSchema = {
+            ...omitLegacyAgentDescription(previousSchema),
+            name: decomposedSchema.name,
+            model: decomposedSchema.model,
+            instructions: decomposedSchema.instructions,
+            ...(credentialProvided ? { credential: decomposedSchema.credential } : {}),
+            ...(memoryProvided ? { memory: decomposedSchema.memory } : {}),
+            ...(subAgentsProvided ? { subAgents: decomposedSchema.subAgents } : {}),
+            ...(toolsProvided ? { tools: decomposedSchema.tools } : {}),
+            ...(skillsProvided ? { skills: decomposedSchema.skills } : {}),
+            ...(tasksProvided ? { tasks: decomposedSchema.tasks } : {}),
+            ...(providerToolsProvided ? { providerTools: decomposedSchema.providerTools } : {}),
+            ...(configBlockProvided ? { config: decomposedSchema.config } : {}),
+            ...(mcpServersProvided ? { mcpServers: decomposedSchema.mcpServers } : {}),
+        };
+        entity.schema = nextSchema;
+        entity.name = result.config.name;
+        entity.integrations = nextIntegrations;
+        (0, agent_draft_utils_1.markAgentDraftDirty)(entity);
+        if (toolsProvided) {
+            const referencedIds = new Set((result.config.tools ?? [])
+                .filter((t) => t.type === 'custom')
+                .map((t) => t.id));
+            const orphanIds = Object.keys(entity.tools).filter((id) => !referencedIds.has(id));
+            if (orphanIds.length > 0) {
+                const tools = { ...entity.tools };
+                for (const id of orphanIds) {
+                    delete tools[id];
+                }
+                entity.tools = tools;
+            }
+        }
+        if (skillsProvided) {
+            this.agentSkillsService.removeUnreferencedSkills(entity, result.config);
+        }
+        this.runtimeCacheService.clearRuntimes(agentId);
+        const saved = await this.agentRepository.save(entity);
+        this.logger.debug('Updated agent JSON config', { agentId, projectId });
+        if (tasksProvided) {
+            const referencedTaskIds = new Set((result.config.tasks ?? []).map((ref) => ref.id));
+            const orphanTaskIds = existingTaskIds.filter((id) => !referencedTaskIds.has(id));
+            if (orphanTaskIds.length > 0) {
+                await this.agentTaskRepository.delete(orphanTaskIds);
+            }
+        }
+        if (integrationsProvided) {
+            await (0, integrations_sync_1.syncAgentIntegrations)(saved, previousIntegrations, nextIntegrations, this.logger);
+        }
+        return {
+            config: (0, agent_config_composition_1.composeJsonConfig)(saved) ?? result.config,
+            updatedAt: saved.updatedAt.toISOString(),
+            versionId: saved.versionId,
+        };
+    }
+    async validateNodeToolConfigs(config) {
+        const nodeTools = (config.tools ?? []).filter((t) => t.type === 'node');
+        if (nodeTools.length === 0)
+            return null;
+        const { setSchemaBaseDirs, validateNodeConfig } = await Promise.resolve().then(() => __importStar(require('@n8n/workflow-sdk')));
+        const dirs = (0, node_definition_resolver_1.resolveBuiltinNodeDefinitionDirs)();
+        if (dirs.length > 0) {
+            setSchemaBaseDirs(dirs);
+        }
+        const errors = [];
+        for (const tool of nodeTools) {
+            const nodeType = tool.node.nodeType;
+            const nodeTypeVersion = tool.node.nodeTypeVersion;
+            const nodeParameters = tool.node.nodeParameters ?? {};
+            const result = validateNodeConfig(nodeType, nodeTypeVersion, { parameters: nodeParameters }, { isToolNode: true });
+            if (!result.valid) {
+                const messages = result.errors
+                    .map((e) => e.message)
+                    .join('; ');
+                errors.push(`Node tool "${tool.name}" (${nodeType}@${nodeTypeVersion}): ${messages}`);
+            }
+        }
+        return errors.length > 0 ? errors.join('\n') : null;
+    }
+    async removeMissingConfigRefs(config, entity, existingTaskIds) {
+        if (config.skills !== undefined) {
+            const skills = entity.skills ?? {};
+            config.skills = config.skills.filter((ref) => Boolean(skills[ref.id]));
+        }
+        if (config.tools !== undefined) {
+            const tools = entity.tools ?? {};
+            config.tools = config.tools.filter((ref) => ref.type !== 'custom' || Boolean(tools[ref.id]));
+        }
+        if (config.tasks !== undefined) {
+            config.tasks = config.tasks.filter((ref) => existingTaskIds.has(ref.id));
+        }
+        if (config.subAgents?.agents !== undefined) {
+            const resolvedSubAgents = await (0, sub_agent_resolver_1.resolveUniqueSubAgents)({
+                refs: config.subAgents.agents,
+                projectId: entity.projectId,
+                agentRepository: this.agentRepository,
+            });
+            config.subAgents.agents = resolvedSubAgents
+                .filter(({ agent }) => agent !== null)
+                .map(({ agentId, useWhen }) => ({
+                agentId,
+                ...(useWhen ? { useWhen } : {}),
+            }));
+            return resolvedSubAgents;
+        }
+        return [];
+    }
+    validateSubAgentRefs(resolvedSubAgents, entity) {
+        for (const { agentId, agent } of resolvedSubAgents) {
+            if (!agent)
+                continue;
+            if (agentId === entity.id) {
+                throw new n8n_workflow_1.UserError('Invalid agent config: An agent cannot use itself as a subagent');
+            }
+            if (!agent.activeVersionId) {
+                throw new n8n_workflow_1.UserError(`Invalid agent config: Subagent "${agentId}" must be published`);
+            }
+        }
+    }
+};
+exports.AgentConfigService = AgentConfigService;
+exports.AgentConfigService = AgentConfigService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [backend_common_1.Logger,
+        agent_repository_1.AgentRepository,
+        agent_task_repository_1.AgentTaskRepository,
+        agent_skills_service_1.AgentSkillsService,
+        agent_runtime_cache_service_1.AgentRuntimeCacheService,
+        credentials_service_1.CredentialsService])
+], AgentConfigService);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function hasNodeToolInputSchema(raw) {
+    if (!isRecord(raw) || !Array.isArray(raw.tools))
+        return false;
+    return raw.tools.some((tool) => isRecord(tool) && tool.type === 'node' && 'inputSchema' in tool);
+}
+function omitLegacyAgentDescription(config) {
+    if (!config)
+        return {};
+    const { description: _description, ...rest } = config;
+    return rest;
+}
+//# sourceMappingURL=agent-config.service.js.map

package/dist/modules/agents/agent-config.service.js.map

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

package/dist/modules/agents/agent-custom-tools.service.d.ts

@@ -0,0 +1,22 @@
+import { type ToolDescriptor } from '@n8n/agents';
+import { type AgentJsonConfig } from '@n8n/api-types';
+import { Logger } from '@n8n/backend-common';
+import { AgentRuntimeCacheService } from './agent-runtime-cache.service';
+import type { Agent } from './entities/agent.entity';
+import { AgentRepository } from './repositories/agent.repository';
+type AgentToolEntries = Agent['tools'];
+export declare class AgentCustomToolsService {
+    private readonly logger;
+    private readonly agentRepository;
+    private readonly runtimeCacheService;
+    constructor(logger: Logger, agentRepository: AgentRepository, runtimeCacheService: AgentRuntimeCacheService);
+    buildCustomTool(agentId: string, projectId: string, code: string, descriptor: ToolDescriptor): Promise<{
+        ok: boolean;
+        id: string;
+        descriptor: ToolDescriptor;
+    }>;
+    deleteCustomTool(agentId: string, projectId: string, toolId: string): Promise<void>;
+    private getMissingCustomToolIds;
+    snapshotConfiguredTools(config: AgentJsonConfig | null, tools: AgentToolEntries): AgentToolEntries | null;
+}
+export {};

package/dist/modules/agents/agent-custom-tools.service.js

@@ -0,0 +1,98 @@
+"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.AgentCustomToolsService = void 0;
+const api_types_1 = require("@n8n/api-types");
+const backend_common_1 = require("@n8n/backend-common");
+const di_1 = require("@n8n/di");
+const n8n_workflow_1 = require("n8n-workflow");
+const not_found_error_1 = require("../../errors/response-errors/not-found.error");
+const agent_runtime_cache_service_1 = require("./agent-runtime-cache.service");
+const agent_repository_1 = require("./repositories/agent.repository");
+const agent_draft_utils_1 = require("./utils/agent-draft.utils");
+let AgentCustomToolsService = class AgentCustomToolsService {
+    constructor(logger, agentRepository, runtimeCacheService) {
+        this.logger = logger;
+        this.agentRepository = agentRepository;
+        this.runtimeCacheService = runtimeCacheService;
+    }
+    async buildCustomTool(agentId, projectId, code, descriptor) {
+        const entity = await this.agentRepository.findByIdAndProjectId(agentId, projectId);
+        if (!entity)
+            throw new not_found_error_1.NotFoundError('Agent not found');
+        if (!api_types_1.CUSTOM_TOOL_ID_REGEX.test(descriptor.name)) {
+            throw new n8n_workflow_1.UserError(`Custom tool name "${descriptor.name}" contains invalid characters. Only letters, numbers, and underscores are allowed.`);
+        }
+        const toolId = descriptor.name;
+        entity.tools = {
+            ...entity.tools,
+            [toolId]: { code, descriptor },
+        };
+        (0, agent_draft_utils_1.markAgentDraftDirty)(entity);
+        this.runtimeCacheService.clearRuntimes(agentId);
+        await this.agentRepository.save(entity);
+        this.logger.debug('Built custom tool', { agentId, projectId, toolId });
+        return { ok: true, id: toolId, descriptor };
+    }
+    async deleteCustomTool(agentId, projectId, toolId) {
+        const entity = await this.agentRepository.findByIdAndProjectId(agentId, projectId);
+        if (!entity)
+            throw new not_found_error_1.NotFoundError('Agent not found');
+        const tools = { ...entity.tools };
+        delete tools[toolId];
+        entity.tools = tools;
+        if (entity.schema?.tools) {
+            entity.schema.tools = entity.schema.tools.filter((t) => !(t.type === 'custom' && 'id' in t && t.id === toolId));
+        }
+        (0, agent_draft_utils_1.markAgentDraftDirty)(entity);
+        this.runtimeCacheService.clearRuntimes(agentId);
+        await this.agentRepository.save(entity);
+        this.logger.debug('Deleted custom tool', { agentId, projectId, toolId });
+    }
+    getMissingCustomToolIds(config, tools) {
+        const refs = (config?.tools ?? []).filter((ref) => ref.type === 'custom');
+        const seen = new Set();
+        const missing = [];
+        for (const ref of refs) {
+            if (seen.has(ref.id))
+                continue;
+            seen.add(ref.id);
+            if (!tools[ref.id])
+                missing.push(ref.id);
+        }
+        return missing;
+    }
+    snapshotConfiguredTools(config, tools) {
+        if (!config)
+            return null;
+        const missing = this.getMissingCustomToolIds(config, tools);
+        if (missing.length > 0) {
+            throw new n8n_workflow_1.UserError(`Cannot publish agent with missing custom tools: ${missing.join(', ')}`);
+        }
+        const snapshot = {};
+        for (const ref of config.tools ?? []) {
+            if (ref.type !== 'custom')
+                continue;
+            const tool = tools[ref.id];
+            if (tool)
+                snapshot[ref.id] = tool;
+        }
+        return snapshot;
+    }
+};
+exports.AgentCustomToolsService = AgentCustomToolsService;
+exports.AgentCustomToolsService = AgentCustomToolsService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [backend_common_1.Logger,
+        agent_repository_1.AgentRepository,
+        agent_runtime_cache_service_1.AgentRuntimeCacheService])
+], AgentCustomToolsService);
+//# sourceMappingURL=agent-custom-tools.service.js.map

package/dist/modules/agents/agent-custom-tools.service.js.map

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

package/dist/modules/agents/agent-execution-orchestrator.service.d.ts

@@ -0,0 +1,110 @@
+import type { Agent as RuntimeAgent, AgentExecutionCounter, BuiltAgent, BuiltTool, CredentialProvider, StreamChunk } from '@n8n/agents';
+import type { AgentPersistedMessageDto } from '@n8n/api-types';
+import { Logger } from '@n8n/backend-common';
+import type { JSONSchema7 } from 'json-schema';
+import { type ExecuteAgentData, type ExecuteAgentWorkflowContext } from 'n8n-workflow';
+import { CredentialsService } from '../../credentials/credentials.service';
+import type { AgentRunTelemetryType, IAgentConfigurationTelemetryProperties } from '../../interfaces';
+import { Telemetry } from '../../telemetry';
+import { AgentExecutionService } from './agent-execution.service';
+import { AgentRuntimeCacheService } from './agent-runtime-cache.service';
+import { AgentRuntimeReconstructionService } from './agent-runtime-reconstruction.service';
+import type { Agent } from './entities/agent.entity';
+import { IntegrationMessageContextService } from './integrations/integration-message-context.service';
+import { N8NCheckpointStorage } from './integrations/n8n-checkpoint-storage';
+import { AgentRepository } from './repositories/agent.repository';
+import type { ToolRegistry } from './tool-registry';
+export interface AgentMemoryScope {
+    threadId: string;
+    resourceId: string;
+}
+export interface ExecuteForChatConfig {
+    agentId: string;
+    projectId: string;
+    message: string;
+    userId: string;
+    memory: AgentMemoryScope;
+}
+export interface ExecuteForChatPublishedConfig {
+    agentId: string;
+    projectId: string;
+    message: string;
+    memory: AgentMemoryScope;
+    integrationType?: string;
+}
+export interface ResumeForChatConfig {
+    agentId: string;
+    projectId: string;
+    runId: string;
+    toolCallId: string;
+    resumeData: unknown;
+    userId?: string;
+    usePublishedVersion?: boolean;
+    integrationType?: string;
+}
+export interface ExecuteForTaskPublishedConfig {
+    agentId: string;
+    projectId: string;
+    message: string;
+    memory: AgentMemoryScope;
+    taskId: string;
+    taskVersionId: string;
+}
+export interface ExecuteForTaskNowConfig {
+    agentId: string;
+    projectId: string;
+    userId: string;
+    message: string;
+    memory: AgentMemoryScope;
+    taskId: string;
+}
+export interface StreamChatResponseConfig {
+    agentInstance: RuntimeAgent;
+    toolRegistry: ToolRegistry;
+    agentId: string;
+    userId?: string;
+    message: string;
+    memory: AgentMemoryScope;
+    projectId: string;
+    source?: string;
+    taskId?: string;
+    taskVersionId?: string;
+    telemetry?: {
+        runType: AgentRunTelemetryType;
+        configuration: IAgentConfigurationTelemetryProperties;
+    };
+}
+export declare class AgentExecutionOrchestratorService {
+    private readonly logger;
+    private readonly agentRepository;
+    private readonly n8nCheckpointStorage;
+    private readonly agentExecutionService;
+    private readonly telemetry;
+    private readonly runtimeCacheService;
+    private readonly credentialsService;
+    private readonly agentRuntimeReconstructionService;
+    private readonly integrationMessageContextService;
+    constructor(logger: Logger, agentRepository: AgentRepository, n8nCheckpointStorage: N8NCheckpointStorage, agentExecutionService: AgentExecutionService, telemetry: Telemetry, runtimeCacheService: AgentRuntimeCacheService, credentialsService: CredentialsService, agentRuntimeReconstructionService: AgentRuntimeReconstructionService, integrationMessageContextService: IntegrationMessageContextService);
+    private normalizeWorkflowStreamError;
+    createAgentExecutionCounter({ agentId, userId, }: {
+        agentId: string;
+        userId?: string;
+    }): AgentExecutionCounter;
+    getConversationHistory(params: {
+        threadId: string;
+        projectId: string;
+        agentId: string;
+    }): Promise<AgentPersistedMessageDto[] | null>;
+    resumeForChat(config: ResumeForChatConfig): AsyncGenerator<StreamChunk>;
+    executeForChat(config: ExecuteForChatConfig): AsyncGenerator<StreamChunk>;
+    executeForChatPublished(config: ExecuteForChatPublishedConfig): AsyncGenerator<StreamChunk>;
+    executeForTaskPublished(config: ExecuteForTaskPublishedConfig): AsyncGenerator<StreamChunk>;
+    executeForTaskNow(config: ExecuteForTaskNowConfig): AsyncGenerator<StreamChunk>;
+    streamChatResponse(config: StreamChatResponseConfig): AsyncGenerator<StreamChunk>;
+    compileIsolated(agentEntity: Agent, credentialProvider: CredentialProvider, userId: string, outputSchema?: JSONSchema7, extraTools?: BuiltTool[]): Promise<{
+        ok: boolean;
+        agent?: BuiltAgent;
+        error?: string;
+    }>;
+    executeForWorkflow(agentId: string, message: string, executionId: string, threadId: string, userId: string, projectId: string, telemetryUserId?: string, useDraftVersion?: boolean, outputSchema?: JSONSchema7, workflowContext?: ExecuteAgentWorkflowContext): Promise<ExecuteAgentData>;
+}