n8n 2.37.6 → 2.38.1

package/dist/modules/agents/background/agent-background-job.service.d.ts

@@ -0,0 +1,34 @@
+import { Logger } from '@n8n/backend-common';
+import { Publisher } from '../../../scaling/pubsub/publisher.service';
+import type { AgentBackgroundJob } from '../entities/agent-background-job.entity';
+import { AgentBackgroundJobRepository, type AgentBackgroundJobSettlement, type NewSubAgentJob } from '../repositories/agent-background-job.repository';
+import { AgentExecutionRepository } from '../repositories/agent-execution.repository';
+export declare const MAX_RUNNING_JOBS_PER_THREAD = 5;
+export declare const SUB_AGENT_BACKGROUND_TIMEOUT_MS: number;
+export declare const SETTLED_JOB_RETENTION_MS: number;
+export type BackgroundJobReceipt = {
+    status: 'started';
+    jobId: string;
+} | {
+    status: 'limit-reached';
+};
+export type BackgroundJobView = Pick<AgentBackgroundJob, 'id' | 'kind' | 'title' | 'status' | 'result' | 'error' | 'createdAt' | 'timeoutAt' | 'settledAt'>;
+export declare class AgentBackgroundJobService {
+    private readonly jobRepository;
+    private readonly executionRepository;
+    private readonly publisher;
+    private readonly logger;
+    private readonly abortControllers;
+    constructor(jobRepository: AgentBackgroundJobRepository, executionRepository: AgentExecutionRepository, publisher: Publisher, logger: Logger);
+    registerSubAgentJob(params: Omit<NewSubAgentJob, 'kind' | 'timeoutAt'>): Promise<BackgroundJobReceipt>;
+    settle(jobId: string, settlement: AgentBackgroundJobSettlement): Promise<boolean>;
+    registerAbortController(jobId: string, controller: AbortController): void;
+    listForThread(parentThreadId: string, ids?: string[]): Promise<BackgroundJobView[]>;
+    cancel(parentThreadId: string, jobId: string): Promise<'cancelled' | 'not-found' | 'already-settled'>;
+    handleCancelRelay({ jobId }: {
+        jobId: string;
+    }): void;
+    reconcile(): Promise<void>;
+    private failJobsPastTimeout;
+    private failOrphanedSubAgentJobs;
+}

package/dist/modules/agents/background/agent-background-job.service.js

@@ -0,0 +1,168 @@
+"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.AgentBackgroundJobService = exports.SETTLED_JOB_RETENTION_MS = exports.SUB_AGENT_BACKGROUND_TIMEOUT_MS = exports.MAX_RUNNING_JOBS_PER_THREAD = void 0;
+const backend_common_1 = require("@n8n/backend-common");
+const constants_1 = require("@n8n/constants");
+const decorators_1 = require("@n8n/decorators");
+const di_1 = require("@n8n/di");
+const publisher_service_1 = require("../../../scaling/pubsub/publisher.service");
+const agent_background_job_repository_1 = require("../repositories/agent-background-job.repository");
+const agent_execution_repository_1 = require("../repositories/agent-execution.repository");
+exports.MAX_RUNNING_JOBS_PER_THREAD = 5;
+exports.SUB_AGENT_BACKGROUND_TIMEOUT_MS = 30 * constants_1.Time.minutes.toMilliseconds;
+exports.SETTLED_JOB_RETENTION_MS = 30 * constants_1.Time.days.toMilliseconds;
+let AgentBackgroundJobService = class AgentBackgroundJobService {
+    constructor(jobRepository, executionRepository, publisher, logger) {
+        this.jobRepository = jobRepository;
+        this.executionRepository = executionRepository;
+        this.publisher = publisher;
+        this.logger = logger;
+        this.abortControllers = new Map();
+        this.logger = this.logger.scoped('agents');
+    }
+    async registerSubAgentJob(params) {
+        const running = await this.jobRepository.countRunningByParentThread(params.parentThreadId);
+        if (running >= exports.MAX_RUNNING_JOBS_PER_THREAD)
+            return { status: 'limit-reached' };
+        await this.jobRepository.insertJob({
+            ...params,
+            kind: 'subagent',
+            timeoutAt: new Date(Date.now() + exports.SUB_AGENT_BACKGROUND_TIMEOUT_MS),
+        });
+        return { status: 'started', jobId: params.id };
+    }
+    async settle(jobId, settlement) {
+        try {
+            return await this.jobRepository.settleIfRunning(jobId, settlement);
+        }
+        finally {
+            this.abortControllers.delete(jobId);
+        }
+    }
+    registerAbortController(jobId, controller) {
+        this.abortControllers.set(jobId, controller);
+    }
+    async listForThread(parentThreadId, ids) {
+        let jobs = await this.jobRepository.findByParentThread(parentThreadId, ids);
+        const reconciled = await this.failOrphanedSubAgentJobs(jobs);
+        if (reconciled)
+            jobs = await this.jobRepository.findByParentThread(parentThreadId, ids);
+        return jobs.map((job) => ({
+            id: job.id,
+            kind: job.kind,
+            title: job.title,
+            status: job.status,
+            result: job.result,
+            error: job.error,
+            createdAt: job.createdAt,
+            timeoutAt: job.timeoutAt,
+            settledAt: job.settledAt,
+        }));
+    }
+    async cancel(parentThreadId, jobId) {
+        const [job] = await this.jobRepository.findByParentThread(parentThreadId, [jobId]);
+        if (!job)
+            return 'not-found';
+        const claimed = await this.jobRepository.settleIfRunning(jobId, { status: 'cancelled' });
+        if (!claimed)
+            return 'already-settled';
+        const controller = this.abortControllers.get(jobId);
+        if (controller) {
+            controller.abort();
+            this.abortControllers.delete(jobId);
+        }
+        else {
+            try {
+                await this.publisher.publishCommand({
+                    command: 'cancel-agent-background-job',
+                    payload: { jobId },
+                });
+            }
+            catch (error) {
+                this.logger.warn('Failed to relay background job cancellation', { jobId, error });
+            }
+        }
+        return 'cancelled';
+    }
+    handleCancelRelay({ jobId }) {
+        const controller = this.abortControllers.get(jobId);
+        if (!controller)
+            return;
+        controller.abort();
+        this.abortControllers.delete(jobId);
+        this.logger.debug('Aborted background job after relayed cancellation', { jobId });
+    }
+    async reconcile() {
+        await this.failJobsPastTimeout();
+        await this.failOrphanedSubAgentJobs(await this.jobRepository.findRunningJobs('subagent'));
+        await this.jobRepository.deleteSettledBefore(new Date(Date.now() - exports.SETTLED_JOB_RETENTION_MS));
+    }
+    async failJobsPastTimeout() {
+        const timedOut = await this.jobRepository.findRunningPastTimeout(new Date());
+        for (const job of timedOut) {
+            const controller = this.abortControllers.get(job.id);
+            try {
+                const settled = await this.settle(job.id, {
+                    status: 'failed',
+                    error: `Timed out after ${Math.round(exports.SUB_AGENT_BACKGROUND_TIMEOUT_MS / 60_000)} minutes`,
+                });
+                if (settled) {
+                    this.logger.debug('Failed background job past its timeout', { jobId: job.id });
+                }
+            }
+            catch (error) {
+                this.logger.error('Failed to settle background job past its timeout', {
+                    jobId: job.id,
+                    error,
+                });
+            }
+            finally {
+                controller?.abort();
+            }
+        }
+    }
+    async failOrphanedSubAgentJobs(jobs) {
+        const orphans = jobs.flatMap((job) => job.kind === 'subagent' &&
+            job.status === 'running' &&
+            job.childThreadId !== null &&
+            !this.abortControllers.has(job.id)
+            ? [{ job, childThreadId: job.childThreadId }]
+            : []);
+        if (orphans.length === 0)
+            return false;
+        const statuses = await this.executionRepository.findLatestStatusesByThreadIds(orphans.map(({ childThreadId }) => childThreadId));
+        let settledAny = false;
+        for (const { job, childThreadId } of orphans) {
+            const childStatus = statuses.get(childThreadId);
+            if (childStatus !== 'interrupted' && childStatus !== 'error')
+                continue;
+            const settled = await this.settle(job.id, {
+                status: 'failed',
+                error: `Sub-agent run ended with status "${childStatus}" and its result was not recovered`,
+            });
+            settledAny ||= settled;
+        }
+        return settledAny;
+    }
+};
+exports.AgentBackgroundJobService = AgentBackgroundJobService;
+__decorate([
+    (0, decorators_1.OnPubSubEvent)('cancel-agent-background-job', { instanceType: 'main' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], AgentBackgroundJobService.prototype, "handleCancelRelay", null);
+exports.AgentBackgroundJobService = AgentBackgroundJobService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [agent_background_job_repository_1.AgentBackgroundJobRepository, agent_execution_repository_1.AgentExecutionRepository, publisher_service_1.Publisher, backend_common_1.Logger])
+], AgentBackgroundJobService);
+//# sourceMappingURL=agent-background-job.service.js.map

package/dist/modules/agents/background/agent-background-job.service.js.map

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

package/dist/modules/agents/background/background-job-tools.d.ts

@@ -0,0 +1,21 @@
+import type { BuiltTool } from '@n8n/agents';
+import { type SubAgentSource } from '@n8n/api-types';
+import type { AgentBackgroundJobService } from './agent-background-job.service';
+import type { SubAgentBackgroundRunner } from './sub-agent-background-runner';
+import type { SubAgentRunContext } from '../sub-agents/sub-agent-runner';
+export interface BackgroundJobToolsOptions {
+    jobService: AgentBackgroundJobService;
+    backgroundRunner: SubAgentBackgroundRunner;
+    sourcesById: Record<string, SubAgentSource>;
+    availableSubAgents: Array<{
+        id: string;
+        name: string;
+        useWhen?: string;
+    }>;
+    projectId: string;
+    parentAgentId: string;
+    runContext: Pick<SubAgentRunContext, 'credentialProvider' | 'runType' | 'workflowToolExecutionMode' | 'user' | 'instrumentation'>;
+}
+export declare function createSpawnBackgroundSubAgentTool(options: BackgroundJobToolsOptions): BuiltTool;
+export declare function createCheckBackgroundJobsTool(jobService: AgentBackgroundJobService): BuiltTool;
+export declare function createCancelBackgroundJobTool(jobService: AgentBackgroundJobService): BuiltTool;

package/dist/modules/agents/background/background-job-tools.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpawnBackgroundSubAgentTool = createSpawnBackgroundSubAgentTool;
+exports.createCheckBackgroundJobsTool = createCheckBackgroundJobsTool;
+exports.createCancelBackgroundJobTool = createCancelBackgroundJobTool;
+const agents_1 = require("@n8n/agents");
+const tool_1 = require("@n8n/agents/tool");
+const api_types_1 = require("@n8n/api-types");
+const zod_1 = require("zod");
+const agent_sandbox_principal_1 = require("../agent-sandbox-principal");
+const RESULT_ECHO_MAX_CHARS = 8000;
+function threadIdOf(ctx) {
+    return ctx.persistence?.threadId;
+}
+function createSpawnBackgroundSubAgentTool(options) {
+    const roster = options.availableSubAgents
+        .map((agent) => `- ${agent.id}: ${agent.name}${agent.useWhen ? ` — ${agent.useWhen}` : ''}`)
+        .join('\n');
+    return new tool_1.Tool('spawn_background_subagent')
+        .description('Dispatch a sub-agent as a detached background job. Returns a receipt immediately; the ' +
+        'sub-agent keeps working after your turn ends. Pass "inline" as subAgentId to spawn a ' +
+        'copy of yourself for a self-contained subtask.' +
+        (roster ? ` Available configured sub-agents:\n${roster}` : ''))
+        .systemInstruction('Prefer spawn_background_subagent for independent pieces of work that can run in parallel ' +
+        'while you continue. After spawning, either continue with non-overlapping work or end ' +
+        'your turn telling the user that work continues in the background — never poll ' +
+        'check_background_jobs in a loop waiting for jobs to finish; check once in a later turn ' +
+        'instead. The final answer is the contract; never expect the full trace. Instruct ' +
+        'sub-agents producing large outputs to write them to the shared workspace and return a ' +
+        'summary.')
+        .input(zod_1.z.object({
+        subAgentId: zod_1.z
+            .string()
+            .describe('Id of a configured sub-agent from the roster, or "inline" for a copy of yourself'),
+        taskName: zod_1.z
+            .string()
+            .min(1)
+            .max(255)
+            .describe('Short label for the job, echoed in status checks'),
+        goal: zod_1.z.string().describe('What the sub-agent should accomplish'),
+        context: zod_1.z.string().optional().describe('Background information the sub-agent needs'),
+        expectedOutput: zod_1.z.string().optional().describe('Shape of the answer to return'),
+        difficulty: zod_1.z
+            .enum(api_types_1.SUB_AGENT_TASK_DIFFICULTIES)
+            .optional()
+            .describe('Inline spawns only: picks the model tier configured for this difficulty'),
+    }))
+        .output(zod_1.z.object({
+        status: zod_1.z.enum(['started', 'limit-reached', 'rejected']),
+        jobId: zod_1.z.string().optional(),
+        note: zod_1.z.string().optional(),
+    }))
+        .handler(async (input, ctx) => {
+        const parentThreadId = threadIdOf(ctx);
+        const parentResourceId = ctx.persistence?.resourceId;
+        if (!parentThreadId || !parentResourceId) {
+            return {
+                status: 'rejected',
+                note: 'Background jobs need a persisted conversation thread; none is active.',
+            };
+        }
+        const isSelfDelegation = input.subAgentId === agents_1.INLINE_SUB_AGENT_ID;
+        const source = isSelfDelegation
+            ? { agentId: options.parentAgentId }
+            : options.sourcesById[input.subAgentId];
+        if (!source) {
+            const ids = [...options.availableSubAgents.map((agent) => agent.id), 'inline'].join(', ');
+            return {
+                status: 'rejected',
+                note: `No sub-agent matched "${input.subAgentId}". Available: ${ids}.`,
+            };
+        }
+        const sandboxScope = (0, agent_sandbox_principal_1.decodeAgentSandboxHostMetadata)(ctx.persistence?.hostMetadata);
+        const receipt = await options.backgroundRunner.spawn({
+            subAgentId: source.agentId,
+            source,
+            taskName: input.taskName,
+            goal: input.goal,
+            context: input.context,
+            expectedOutput: input.expectedOutput,
+            ...(isSelfDelegation && input.difficulty !== undefined
+                ? { difficulty: input.difficulty }
+                : {}),
+            parentThreadId,
+            parentResourceId,
+            ...(sandboxScope?.projectId === options.projectId
+                ? { parentSandboxPrincipalHash: sandboxScope.principalHash }
+                : {}),
+        }, {
+            projectId: options.projectId,
+            parentAgentId: options.parentAgentId,
+            ...options.runContext,
+        });
+        if (receipt.status === 'started') {
+            return {
+                status: 'started',
+                jobId: receipt.jobId,
+                note: 'Job dispatched. Check on it later with check_background_jobs.',
+            };
+        }
+        return {
+            status: 'limit-reached',
+            note: 'This conversation already has the maximum number of running background jobs. Wait for one to finish or cancel one.',
+        };
+    })
+        .build();
+}
+function createCheckBackgroundJobsTool(jobService) {
+    return new tool_1.Tool('check_background_jobs')
+        .description('List the background jobs of this conversation with their status and, once settled, ' +
+        'their result or error. Pass an empty object {} to list all jobs (required — do not pass null). ' +
+        'Call this at most once per turn: when jobs are still running, tell the user and end your ' +
+        'turn — repeated checks within one turn only burn time and tokens.')
+        .input(zod_1.z.object({
+        jobIds: zod_1.z.array(zod_1.z.string()).max(50).optional().describe('Limit the check to these job ids'),
+    }))
+        .handler(async (input, ctx) => {
+        const parentThreadId = threadIdOf(ctx);
+        if (!parentThreadId) {
+            return { jobs: [], note: 'No persisted conversation thread is active.' };
+        }
+        const jobs = await jobService.listForThread(parentThreadId, input.jobIds);
+        return {
+            jobs: jobs.map((job) => ({
+                jobId: job.id,
+                kind: job.kind,
+                title: job.title,
+                status: job.status,
+                ...(job.result !== null ? { result: truncateResult(job.result) } : {}),
+                ...(job.error !== null ? { error: truncateResult(job.error) } : {}),
+                startedAt: job.createdAt.toISOString(),
+                ...(job.timeoutAt !== null ? { timeoutAt: job.timeoutAt.toISOString() } : {}),
+            })),
+            runningCount: jobs.filter((job) => job.status === 'running').length,
+        };
+    })
+        .build();
+}
+function createCancelBackgroundJobTool(jobService) {
+    return new tool_1.Tool('cancel_background_job')
+        .description('Cancel a running background job of this conversation by its job id.')
+        .input(zod_1.z.object({ jobId: zod_1.z.string() }))
+        .output(zod_1.z.object({ status: zod_1.z.enum(['cancelled', 'not-found', 'already-settled']) }))
+        .handler(async (input, ctx) => {
+        const parentThreadId = threadIdOf(ctx);
+        if (!parentThreadId)
+            return { status: 'not-found' };
+        return { status: await jobService.cancel(parentThreadId, input.jobId) };
+    })
+        .build();
+}
+function truncateResult(result) {
+    if (result.length <= RESULT_ECHO_MAX_CHARS)
+        return result;
+    return `${result.slice(0, RESULT_ECHO_MAX_CHARS)}\n[... truncated, ${result.length} characters total]`;
+}
+//# sourceMappingURL=background-job-tools.js.map

package/dist/modules/agents/background/background-job-tools.js.map

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

package/dist/modules/agents/background/sub-agent-background-runner.d.ts

@@ -0,0 +1,27 @@
+import type { SubAgentSource, SubAgentTaskDifficulty } from '@n8n/api-types';
+import { Logger } from '@n8n/backend-common';
+import { AgentBackgroundJobService, type BackgroundJobReceipt } from './agent-background-job.service';
+import { SubAgentRunner, type SubAgentRunContext } from '../sub-agents/sub-agent-runner';
+export interface BackgroundSpawnRequest {
+    subAgentId: string;
+    source: SubAgentSource;
+    taskName: string;
+    goal: string;
+    context?: string;
+    expectedOutput?: string;
+    difficulty?: SubAgentTaskDifficulty;
+    parentThreadId: string;
+    parentResourceId: string;
+    parentSandboxPrincipalHash?: string;
+}
+export declare class SubAgentBackgroundRunner {
+    private readonly runner;
+    private readonly jobService;
+    private readonly logger;
+    private dispatchCounter;
+    constructor(runner: SubAgentRunner, jobService: AgentBackgroundJobService, logger: Logger);
+    spawn(request: BackgroundSpawnRequest, context: {
+        projectId: string;
+        parentAgentId: string;
+    } & Pick<SubAgentRunContext, 'credentialProvider' | 'runType' | 'workflowToolExecutionMode' | 'user' | 'instrumentation'>): Promise<BackgroundJobReceipt>;
+}

package/dist/modules/agents/background/sub-agent-background-runner.js

@@ -0,0 +1,123 @@
+"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.SubAgentBackgroundRunner = void 0;
+const agents_1 = require("@n8n/agents");
+const backend_common_1 = require("@n8n/backend-common");
+const di_1 = require("@n8n/di");
+const uuid_1 = require("uuid");
+const agent_background_job_service_1 = require("./agent-background-job.service");
+const format_sub_agent_tool_output_1 = require("../sub-agents/format-sub-agent-tool-output");
+const sub_agent_runner_1 = require("../sub-agents/sub-agent-runner");
+let SubAgentBackgroundRunner = class SubAgentBackgroundRunner {
+    constructor(runner, jobService, logger) {
+        this.runner = runner;
+        this.jobService = jobService;
+        this.logger = logger;
+        this.dispatchCounter = 0;
+        this.logger = this.logger.scoped('agents');
+    }
+    async spawn(request, context) {
+        const taskPath = (0, agents_1.createChildSubAgentTaskPath)(request.taskName, this.dispatchCounter++);
+        const jobId = (0, uuid_1.v4)();
+        const childThreadId = (0, uuid_1.v4)();
+        const receipt = await this.jobService.registerSubAgentJob({
+            id: jobId,
+            parentAgentId: context.parentAgentId,
+            parentThreadId: request.parentThreadId,
+            title: request.taskName,
+            subAgentId: request.subAgentId,
+            childThreadId,
+        });
+        if (receipt.status !== 'started')
+            return receipt;
+        const abortController = new AbortController();
+        this.jobService.registerAbortController(jobId, abortController);
+        const timeout = setTimeout(() => {
+            void this.jobService
+                .settle(jobId, {
+                status: 'failed',
+                error: `Timed out after ${Math.round(agent_background_job_service_1.SUB_AGENT_BACKGROUND_TIMEOUT_MS / 60_000)} minutes`,
+            })
+                .catch((error) => {
+                this.logger.error('Failed to settle timed-out background job', { jobId, error });
+            })
+                .finally(() => abortController.abort());
+        }, agent_background_job_service_1.SUB_AGENT_BACKGROUND_TIMEOUT_MS);
+        timeout.unref();
+        void this.runner
+            .run({
+            goal: request.goal,
+            source: request.source,
+            ...(request.context !== undefined ? { context: request.context } : {}),
+            ...(request.expectedOutput !== undefined
+                ? { expectedOutput: request.expectedOutput }
+                : {}),
+            parentThreadId: request.parentThreadId,
+            parentResourceId: request.parentResourceId,
+            ...(request.parentSandboxPrincipalHash !== undefined
+                ? { parentSandboxPrincipalHash: request.parentSandboxPrincipalHash }
+                : {}),
+            childThreadId,
+            taskPath,
+        }, {
+            projectId: context.projectId,
+            parentAgentId: context.parentAgentId,
+            credentialProvider: context.credentialProvider,
+            runType: context.runType,
+            workflowToolExecutionMode: context.workflowToolExecutionMode,
+            user: context.user,
+            instrumentation: context.instrumentation,
+            abortSignal: abortController.signal,
+            ...(request.difficulty !== undefined
+                ? { selfDelegationDifficulty: request.difficulty }
+                : {}),
+        })
+            .then((result) => settlementFor(result))
+            .catch((error) => ({
+            status: 'failed',
+            error: error instanceof Error ? error.message : String(error),
+        }))
+            .then(async (settlement) => {
+            const settled = await this.jobService.settle(jobId, settlement);
+            if (settled && settlement.status === 'failed') {
+                this.logger.warn('Background sub-agent job failed', { jobId, error: settlement.error });
+            }
+        })
+            .catch((error) => {
+            this.logger.error('Failed to settle background sub-agent job', { jobId, error });
+        })
+            .finally(() => clearTimeout(timeout));
+        return receipt;
+    }
+};
+exports.SubAgentBackgroundRunner = SubAgentBackgroundRunner;
+exports.SubAgentBackgroundRunner = SubAgentBackgroundRunner = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [sub_agent_runner_1.SubAgentRunner, agent_background_job_service_1.AgentBackgroundJobService, backend_common_1.Logger])
+], SubAgentBackgroundRunner);
+function settlementFor(result) {
+    const output = (0, format_sub_agent_tool_output_1.formatSubAgentToolOutput)(result);
+    if (output.status === 'completed') {
+        return { status: 'completed', result: output.answer };
+    }
+    if (output.status === 'suspended') {
+        return {
+            status: 'failed',
+            error: 'Sub-agent suspended awaiting human input, which background runs do not support',
+        };
+    }
+    return {
+        status: output.status === 'cancelled' ? 'cancelled' : 'failed',
+        error: output.error ?? null,
+    };
+}
+//# sourceMappingURL=sub-agent-background-runner.js.map

package/dist/modules/agents/background/sub-agent-background-runner.js.map

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

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

@@ -1,7 +1,7 @@
 import { type BuiltTool, type CredentialProvider } from '@n8n/agents';
-import { OutboundHttp, SsrfProtectionService } from '@n8n/backend-network';
-import { SsrfProtectionConfig } from '@n8n/config';
+import { OutboundHttp } from '@n8n/backend-network';
 import type { User } from '@n8n/db';
+import type { InstanceAiCredentialService } from '@n8n/instance-ai';
 import { CredentialTypes } from '../../../credential-types';
 import { McpRegistryService } from '../../../modules/mcp-registry/registry/mcp-registry.service';
 import { NodeTypes } from '../../../node-types';
@@ -52,13 +52,11 @@ export declare class AgentsBuilderToolsService {
     private readonly outboundHttp;
     private readonly dynamicNodeParametersService;
     private readonly nodeTypes;
-    private readonly ssrfConfig;
-    private readonly ssrfProtectionService;
     private readonly freeAiCreditsService;
     private readonly telemetry;
-    constructor(agentsService: AgentsService, agentConfigService: AgentConfigService, agentCustomToolsService: AgentCustomToolsService, agentIntegrationPersistenceService: AgentIntegrationPersistenceService, agentSkillsService: AgentSkillsService, secureRuntime: AgentSecureRuntime, attachableWorkflowsService: AttachableWorkflowsService, agentsToolsService: AgentsToolsService, builderModelLiveLookupService: BuilderModelLiveLookupService, mcpRegistryService: McpRegistryService, oauthService: OauthService, credentialTypes: CredentialTypes, agentTaskService: AgentTaskService, agentPublishService: AgentPublishService, agentTestRunService: AgentTestRunService, aiService: AiService, aiGatewayService: AiGatewayService, outboundHttp: OutboundHttp, dynamicNodeParametersService: DynamicNodeParametersService, nodeTypes: NodeTypes, ssrfConfig: SsrfProtectionConfig, ssrfProtectionService: SsrfProtectionService, freeAiCreditsService: FreeAiCreditsService, telemetry: Telemetry);
+    constructor(agentsService: AgentsService, agentConfigService: AgentConfigService, agentCustomToolsService: AgentCustomToolsService, agentIntegrationPersistenceService: AgentIntegrationPersistenceService, agentSkillsService: AgentSkillsService, secureRuntime: AgentSecureRuntime, attachableWorkflowsService: AttachableWorkflowsService, agentsToolsService: AgentsToolsService, builderModelLiveLookupService: BuilderModelLiveLookupService, mcpRegistryService: McpRegistryService, oauthService: OauthService, credentialTypes: CredentialTypes, agentTaskService: AgentTaskService, agentPublishService: AgentPublishService, agentTestRunService: AgentTestRunService, aiService: AiService, aiGatewayService: AiGatewayService, outboundHttp: OutboundHttp, dynamicNodeParametersService: DynamicNodeParametersService, nodeTypes: NodeTypes, freeAiCreditsService: FreeAiCreditsService, telemetry: Telemetry);
     private withConfigMutationMarker;
-    getTools(agentId: string, projectId: string, credentialProvider: CredentialProvider, user: User, telemetryContext?: BuilderTelemetryContext): BuilderTools;
+    getTools(agentId: string, projectId: string, credentialProvider: CredentialProvider, credentialService: InstanceAiCredentialService, user: User, telemetryContext?: BuilderTelemetryContext): BuilderTools;
     private getJsonTools;
     private getSharedTools;
     private getConfigSnapshot;