n8n 2.38.0 → 2.38.1

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/get-resource-locator-options.tool.d.ts

@@ -69,9 +69,9 @@ export declare function resolveResourceLocatorOptions({ nodeType, nodeTypeVersio
     message: string;
     credentialSlots: import("@n8n/ai-utilities/node-catalog").RequiredNodeCredentialSlot[];
 } | {
-    dynamicParameters?: undefined;
     code?: undefined;
     message?: undefined;
+    dynamicParameters?: undefined;
     credentialSlots?: undefined;
     ok: boolean;
     kind: "resourceLocator";
@@ -87,9 +87,9 @@ export declare function resolveResourceLocatorOptions({ nodeType, nodeTypeVersio
     paginationToken: string | undefined;
     builderHint?: string | undefined;
 } | {
-    dynamicParameters?: undefined;
     code?: undefined;
     message?: undefined;
+    dynamicParameters?: undefined;
     credentialSlots?: undefined;
     ok: boolean;
     kind: "loadOptionsMethod" | "loadOptionsRouting";

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

@@ -0,0 +1,18 @@
+import { WithTimestampsAndStringId } from '@n8n/db';
+export type AgentBackgroundJobKind = 'subagent' | 'workflow';
+export type AgentBackgroundJobStatus = 'running' | 'completed' | 'failed' | 'cancelled';
+export declare class AgentBackgroundJob extends WithTimestampsAndStringId {
+    kind: AgentBackgroundJobKind;
+    status: AgentBackgroundJobStatus;
+    parentAgentId: string;
+    parentThreadId: string;
+    title: string;
+    subAgentId: string | null;
+    childThreadId: string | null;
+    childExecutionId: string | null;
+    workflowId: string | null;
+    timeoutAt: Date | null;
+    result: string | null;
+    error: string | null;
+    settledAt: Date | null;
+}

package/dist/modules/agents/entities/agent-background-job.entity.js

@@ -0,0 +1,78 @@
+"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.AgentBackgroundJob = void 0;
+const db_1 = require("@n8n/db");
+const typeorm_1 = require("@n8n/typeorm");
+let AgentBackgroundJob = class AgentBackgroundJob extends db_1.WithTimestampsAndStringId {
+};
+exports.AgentBackgroundJob = AgentBackgroundJob;
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "kind", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "parentAgentId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 128 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "parentThreadId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255 }),
+    __metadata("design:type", String)
+], AgentBackgroundJob.prototype, "title", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "subAgentId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 128, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "childThreadId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "childExecutionId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 36, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "workflowId", void 0);
+__decorate([
+    (0, db_1.DateTimeColumn)({ precision: 3, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "timeoutAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "result", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "error", void 0);
+__decorate([
+    (0, db_1.DateTimeColumn)({ precision: 3, nullable: true }),
+    __metadata("design:type", Object)
+], AgentBackgroundJob.prototype, "settledAt", void 0);
+exports.AgentBackgroundJob = AgentBackgroundJob = __decorate([
+    (0, typeorm_1.Entity)({ name: 'agent_background_job' }),
+    (0, typeorm_1.Index)(['parentThreadId', 'status']),
+    (0, typeorm_1.Index)(['parentAgentId']),
+    (0, typeorm_1.Index)(['settledAt']),
+    (0, typeorm_1.Index)(['childExecutionId'], { unique: true, where: '"childExecutionId" IS NOT NULL' }),
+    (0, typeorm_1.Index)(['timeoutAt'], { where: '"status" = \'running\'' })
+], AgentBackgroundJob);
+//# sourceMappingURL=agent-background-job.entity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-background-job.entity.js","sourceRoot":"","sources":["../../../../src/modules/agents/entities/agent-background-job.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAAoE;AACpE,0CAAqD;AAkB9C,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,8BAAyB;CAiDhE,CAAA;;AA/CA;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;gDACX;AAG7B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;kDACP;AAGjC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;yDAClB;AAMtB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;0DAClB;AAIvB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;;iDAC3B;AAId;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDAC9B;AAI1B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDAC5B;AAI7B;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4DACxB;AAIhC;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDAC9B;AAI1B;IADC,IAAA,mBAAc,EAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDAC1B;AAIvB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACnB;AAGtB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDACpB;AAGrB;IADC,IAAA,mBAAc,EAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDAC1B;6BAhDX,kBAAkB;IAN9B,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;IACxC,IAAA,eAAK,EAAC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IACnC,IAAA,eAAK,EAAC,CAAC,eAAe,CAAC,CAAC;IACxB,IAAA,eAAK,EAAC,CAAC,WAAW,CAAC,CAAC;IACpB,IAAA,eAAK,EAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;IACtF,IAAA,eAAK,EAAC,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;GAC7C,kBAAkB,CAiD9B"}

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

@@ -0,0 +1,37 @@
+import { DataSource, Repository } from '@n8n/typeorm';
+import { AgentBackgroundJob, type AgentBackgroundJobKind, type AgentBackgroundJobStatus } from '../entities/agent-background-job.entity';
+type NewAgentBackgroundJobBase = {
+    id: string;
+    parentAgentId: string;
+    parentThreadId: string;
+    title: string;
+};
+export type NewSubAgentJob = NewAgentBackgroundJobBase & {
+    kind: 'subagent';
+    subAgentId: string;
+    childThreadId: string;
+    timeoutAt: Date;
+};
+export type NewWorkflowJob = NewAgentBackgroundJobBase & {
+    kind: 'workflow';
+    workflowId: string;
+    childExecutionId: string;
+};
+export type NewAgentBackgroundJob = NewSubAgentJob | NewWorkflowJob;
+export type AgentBackgroundJobSettlement = {
+    status: Exclude<AgentBackgroundJobStatus, 'running'>;
+    result?: string | null;
+    error?: string | null;
+};
+export declare class AgentBackgroundJobRepository extends Repository<AgentBackgroundJob> {
+    constructor(dataSource: DataSource);
+    insertJob(job: NewAgentBackgroundJob): Promise<void>;
+    countRunningByParentThread(parentThreadId: string): Promise<number>;
+    findByParentThread(parentThreadId: string, ids?: string[]): Promise<AgentBackgroundJob[]>;
+    findRunningWorkflowJobByExecutionId(executionId: string): Promise<AgentBackgroundJob | null>;
+    findRunningJobs(kind?: AgentBackgroundJobKind): Promise<AgentBackgroundJob[]>;
+    findRunningPastTimeout(now: Date): Promise<AgentBackgroundJob[]>;
+    settleIfRunning(id: string, settlement: AgentBackgroundJobSettlement): Promise<boolean>;
+    deleteSettledBefore(cutoff: Date): Promise<void>;
+}
+export {};

package/dist/modules/agents/repositories/agent-background-job.repository.js

@@ -0,0 +1,61 @@
+"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.AgentBackgroundJobRepository = void 0;
+const di_1 = require("@n8n/di");
+const typeorm_1 = require("@n8n/typeorm");
+const agent_background_job_entity_1 = require("../entities/agent-background-job.entity");
+let AgentBackgroundJobRepository = class AgentBackgroundJobRepository extends typeorm_1.Repository {
+    constructor(dataSource) {
+        super(agent_background_job_entity_1.AgentBackgroundJob, dataSource.manager);
+    }
+    async insertJob(job) {
+        await this.insert({ ...job, status: 'running' });
+    }
+    async countRunningByParentThread(parentThreadId) {
+        return await this.count({ where: { parentThreadId, status: 'running' } });
+    }
+    async findByParentThread(parentThreadId, ids) {
+        return await this.find({
+            where: ids?.length ? { parentThreadId, id: (0, typeorm_1.In)(ids) } : { parentThreadId },
+            order: { createdAt: 'ASC' },
+        });
+    }
+    async findRunningWorkflowJobByExecutionId(executionId) {
+        return await this.findOne({
+            where: { kind: 'workflow', status: 'running', childExecutionId: executionId },
+        });
+    }
+    async findRunningJobs(kind) {
+        return await this.find({ where: kind ? { status: 'running', kind } : { status: 'running' } });
+    }
+    async findRunningPastTimeout(now) {
+        return await this.find({ where: { status: 'running', timeoutAt: (0, typeorm_1.LessThan)(now) } });
+    }
+    async settleIfRunning(id, settlement) {
+        const result = await this.update({ id, status: 'running' }, {
+            status: settlement.status,
+            result: settlement.result ?? null,
+            error: settlement.error ?? null,
+            settledAt: new Date(),
+        });
+        return result.affected === 1;
+    }
+    async deleteSettledBefore(cutoff) {
+        await this.delete({ status: (0, typeorm_1.Not)('running'), settledAt: (0, typeorm_1.LessThan)(cutoff) });
+    }
+};
+exports.AgentBackgroundJobRepository = AgentBackgroundJobRepository;
+exports.AgentBackgroundJobRepository = AgentBackgroundJobRepository = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource])
+], AgentBackgroundJobRepository);
+//# sourceMappingURL=agent-background-job.repository.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-background-job.repository.js","sourceRoot":"","sources":["../../../../src/modules/agents/repositories/agent-background-job.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gCAAkC;AAClC,0CAAyE;AAEzE,yFAIiD;AA+B1C,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,oBAA8B;IAC/E,YAAY,UAAsB;QACjC,KAAK,CAAC,gDAAkB,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAA0B;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,0BAA0B,CAAC,cAAsB;QACtD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,cAAsB,EAAE,GAAc;QAC9D,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC;YACtB,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE;YACzE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;SAC3B,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mCAAmC,CACxC,WAAmB;QAEnB,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;YACzB,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE;SAC7E,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAA6B;QAClD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IAGD,KAAK,CAAC,sBAAsB,CAAC,GAAS;QACrC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAA,kBAAQ,EAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IAOD,KAAK,CAAC,eAAe,CAAC,EAAU,EAAE,UAAwC;QACzE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAC/B,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EACzB;YACC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,IAAI;YACjC,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,IAAI;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE;SACrB,CACD,CAAC;QACF,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC9B,CAAC;IAGD,KAAK,CAAC,mBAAmB,CAAC,MAAY;QACrC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAA,aAAG,EAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAA,kBAAQ,EAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;CACD,CAAA;;uCA3DY,4BAA4B;IADxC,IAAA,YAAO,GAAE;qCAEe,oBAAU;GADtB,4BAA4B,CA2DxC"}

package/dist/modules/agents/sub-agents/delegate-sub-agent-tool.d.ts

@@ -1,8 +1,8 @@
-import { type DelegateSubAgentToolOutput, type InlineSubAgentProviderToolsResolver, type ModelConfig, type SubAgentTaskDifficulty } from '@n8n/agents';
+import { type InlineSubAgentProviderToolsResolver, type ModelConfig, type SubAgentTaskDifficulty } from '@n8n/agents';
 import type { SubAgentRunPolicy, SubAgentSource } from '@n8n/api-types';
-import type { SubAgentForegroundRunContext, SubAgentForegroundResult, SubAgentForegroundRunner } from './sub-agent-foreground-runner';
-export interface CreateN8nDelegateSubAgentToolOptions extends SubAgentForegroundRunContext {
-    runner: SubAgentForegroundRunner;
+import type { SubAgentRunContext, SubAgentRunner } from './sub-agent-runner';
+export interface CreateN8nDelegateSubAgentToolOptions extends SubAgentRunContext {
+    runner: SubAgentRunner;
     sourcesById: Record<string, SubAgentSource>;
     availableSubAgents?: Array<{
         id: string;
@@ -14,4 +14,3 @@ export interface CreateN8nDelegateSubAgentToolOptions extends SubAgentForeground
     resolveInlineSubAgentProviderTools?: InlineSubAgentProviderToolsResolver;
 }
 export declare function createN8nDelegateSubAgentTool(options: CreateN8nDelegateSubAgentToolOptions): import("@n8n/agents").BuiltTool;
-export declare function formatSubAgentToolOutput(result: SubAgentForegroundResult): DelegateSubAgentToolOutput;

package/dist/modules/agents/sub-agents/delegate-sub-agent-tool.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createN8nDelegateSubAgentTool = createN8nDelegateSubAgentTool;
-exports.formatSubAgentToolOutput = formatSubAgentToolOutput;
 const agents_1 = require("@n8n/agents");
 const n8n_workflow_1 = require("n8n-workflow");
 const response_error_1 = require("../../../errors/response-errors/abstract/response.error");
 const agent_sandbox_principal_1 = require("../agent-sandbox-principal");
+const format_sub_agent_tool_output_1 = require("./format-sub-agent-tool-output");
 function createN8nDelegateSubAgentTool(options) {
     const { runner, sourcesById, availableSubAgents, policy, inlineSubAgentModelsByDifficulty, resolveInlineSubAgentProviderTools, ...runContext } = options;
     return (0, agents_1.createDelegateSubAgentTool)({
@@ -32,10 +32,9 @@ function createN8nDelegateSubAgentTool(options) {
                 };
             }
             const parentSandboxScope = (0, agent_sandbox_principal_1.decodeAgentSandboxHostMetadata)(request.parentHostMetadata);
-            const result = await runner.runForeground({
+            const result = await runner.run({
                 goal: request.goal,
                 source: selectedSource,
-                executionMode: 'foreground',
                 ...(request.context !== undefined ? { context: request.context } : {}),
                 ...(request.expectedOutput !== undefined
                     ? { expectedOutput: request.expectedOutput }
@@ -65,7 +64,7 @@ function createN8nDelegateSubAgentTool(options) {
                     ? { selfDelegationDifficulty: request.difficulty }
                     : {}),
             });
-            return formatSubAgentToolOutput(result);
+            return (0, format_sub_agent_tool_output_1.formatSubAgentToolOutput)(result);
         },
         resumeSubAgent: async (request, helpers) => {
             if (request.childThreadId === undefined || request.resumeContext === undefined) {
@@ -93,7 +92,7 @@ function createN8nDelegateSubAgentTool(options) {
             const result = request.subAgentId === agents_1.INLINE_SUB_AGENT_ID
                 ? await runner.resumeForeground(request, context, resolveExpectedSourceAgentId(request.subAgentId, runContext.parentAgentId))
                 : await runner.resumeForeground(request, context);
-            return formatSubAgentToolOutput(result);
+            return (0, format_sub_agent_tool_output_1.formatSubAgentToolOutput)(result);
         },
         cancelSubAgent: async (request) => {
             if (request.resumeContext === undefined) {
@@ -129,13 +128,4 @@ function resolveExpectedSourceAgentId(subAgentId, parentAgentId) {
     }
     return parentAgentId;
 }
-function formatSubAgentToolOutput(result) {
-    const output = (0, agents_1.generateResultToDelegateSubAgentOutput)(result.taskPath, result.result, result.threadId);
-    return {
-        ...output,
-        ...(output.status === 'suspended' && result.resumeContext !== undefined
-            ? { resumeContext: result.resumeContext }
-            : {}),
-    };
-}
 //# sourceMappingURL=delegate-sub-agent-tool.js.map