n8n 2.42.4 → 2.43.1

package/dist/modules/agents/agent-dependency-index.listener.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-dependency-index.listener.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-dependency-index.listener.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wDAA6C;AAC7C,gCAAkC;AAElC,0DAAsD;AAEtD,qFAA+E;AAGxE,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACxC,YACkB,MAAc,EACd,YAA0B,EAC1B,YAAyC;sBAFzC,MAAM;4BACN,YAAY;4BACZ,YAAY;QAE7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;gBACnD,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;YACtC,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACzD,MAAM,IAAI,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;gBACrD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC3D,MAAM,IAAI,CAAC,GAAG,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;gBAC5D,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,yBAAyB,EAAE,CAAC;IAClC,CAAC;IASO,yBAAyB;QAChC,MAAM,UAAU,GAAG,KAAK,EAAE,EAAE,UAAU,EAA0B,EAAE,EAAE;YACnE,MAAM,IAAI,CAAC,GAAG,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;gBAChE,MAAM,IAAI,CAAC,YAAY,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC7D,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,SAA8B;QAC/D,IAAI,CAAC;YACJ,MAAM,SAAS,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;CACD,CAAA;;uCAzDY,4BAA4B;IADxC,IAAA,YAAO,GAAE;qCAGiB,uBAAM,EACA,4BAAY,EACZ,4DAA2B;GAJ/C,4BAA4B,CAyDxC"}
+{"version":3,"file":"agent-dependency-index.listener.js","sourceRoot":"","sources":["../../../src/modules/agents/agent-dependency-index.listener.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wDAA6C;AAC7C,4DAAqD;AACrD,gCAAkC;AAElC,qFAA+E;AAGxE,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACxC,YACkB,MAAc,EACd,YAA0B,EAC1B,YAAyC;sBAFzC,MAAM;4BACN,YAAY;4BACZ,YAAY;QAE7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;gBACnD,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;YACtC,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACzD,MAAM,IAAI,CAAC,GAAG,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;gBACrD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC3D,MAAM,IAAI,CAAC,GAAG,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;gBAC5D,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,yBAAyB,EAAE,CAAC;IAClC,CAAC;IASO,yBAAyB;QAChC,MAAM,UAAU,GAAG,KAAK,EAAE,EAAE,UAAU,EAA0B,EAAE,EAAE;YACnE,MAAM,IAAI,CAAC,GAAG,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;gBAChE,MAAM,IAAI,CAAC,YAAY,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC7D,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,SAA8B;QAC/D,IAAI,CAAC;YACJ,MAAM,SAAS,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;CACD,CAAA;;uCAzDY,4BAA4B;IADxC,IAAA,YAAO,GAAE;qCAGiB,uBAAM,EACA,+BAAY,EACZ,4DAA2B;GAJ/C,4BAA4B,CAyDxC"}

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

@@ -1,5 +1,5 @@
-import { type Agent as RuntimeAgent, type StreamChunk } from '@n8n/agents';
-import type { AgentBackgroundJobSignal, AgentMessageAuthor, AgentChatMessagesResponse } from '@n8n/api-types';
+import { type Agent as RuntimeAgent } from '@n8n/agents';
+import type { AgentBackgroundJobSignal, AgentMessageAuthor, AgentChatMessagesResponse, BudgetGuardrailConfig } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
 import { AiConfig } from '@n8n/config';
 import type { User } from '@n8n/db';
@@ -14,14 +14,18 @@ import { AgentRunTracingService } from './agent-run-tracing.service';
 import { AgentRuntimeCacheService } from './agent-runtime-cache.service';
 import { type AgentSandboxPrincipalHash } from './agent-sandbox-principal';
 import { AgentSandboxRuntimeService } from './agent-sandbox-runtime.service';
+import { AgentsSettingsService } from './agents-settings.service';
 import { AgentTurnExecutionService } from './agent-turn-execution.service';
 import type { IntegrationMessageContext, SessionBinding } from './integrations/integration-tool-types';
 import { IntegrationMessageContextService } from './integrations/integration-message-context.service';
 import { N8NCheckpointStorage } from './integrations/n8n-checkpoint-storage';
 import { AgentRepository } from './repositories/agent.repository';
+import { AgentBackgroundJobRepository } from './repositories/agent-background-job.repository';
+import { AgentBackgroundJobService } from './background/agent-background-job.service';
 import type { ToolRegistry } from './tool-registry';
 import type { StoredAttachmentRef } from './types/agent-chat-attachment';
 import type { AgentExecutionAdmission } from './types/agent-queued-message';
+import type { AgentExecutionStreamChunk } from './types/agent-steering';
 export interface AgentMemoryScope {
     threadId: string;
     resourceId: string;
@@ -46,6 +50,7 @@ export interface ExecuteForChatConfig extends ChatExecutionInput, ChatExecutionC
     user: User;
     source?: string;
     previewChat?: boolean;
+    onBudgetNotice?: () => void;
     abortSignal?: AbortSignal;
 }
 export interface ExecuteForChatPublishedConfig extends ChatExecutionInput {
@@ -74,6 +79,7 @@ export interface ResumeForChatConfig extends ChatExecutionCallbacks {
     usePublishedVersion?: boolean;
     integrationType?: string;
     previewChat?: boolean;
+    onBudgetNotice?: () => void;
     automaticPreviewContinuation?: boolean;
     abortSignal?: AbortSignal;
 }
@@ -87,6 +93,7 @@ export interface ExecuteForTaskNowConfig extends AgentExecutionInput {
 }
 export interface ExecuteForWakeConfig extends AgentExecutionInput {
     backgroundJobSignal: AgentBackgroundJobSignal;
+    pauseReport?: boolean;
     abortSignal: AbortSignal;
     identity: {
         type: 'draft';
@@ -105,6 +112,7 @@ export interface StreamChatResponseConfig extends ChatExecutionInput, ChatExecut
     messageContext?: IntegrationMessageContext | null;
     agentInstance: RuntimeAgent;
     toolRegistry: ToolRegistry;
+    budget?: BudgetGuardrailConfig;
     mcpServerAttributions: Map<string, string>;
     userId?: string;
     modelMessage?: string;
@@ -117,11 +125,12 @@ export interface StreamChatResponseConfig extends ChatExecutionInput, ChatExecut
         configuration: IAgentConfigurationTelemetryProperties;
     };
     previewChat?: boolean;
+    onBudgetNotice?: () => void;
     abortSignal?: AbortSignal;
-    includeHitlToolDetails?: boolean;
     sandboxPrincipalHash: AgentSandboxPrincipalHash;
     hideUserMessageFromTranscript?: boolean;
     isWakeRun?: boolean;
+    pauseReport?: boolean;
     backgroundJobSignal?: AgentBackgroundJobSignal;
 }
 export declare class AgentExecutionOrchestratorService {
@@ -138,7 +147,10 @@ export declare class AgentExecutionOrchestratorService {
     private readonly agentRepository;
     private readonly aiConfig;
     private readonly chatExecutionService;
-    constructor(logger: Logger, n8nCheckpointStorage: N8NCheckpointStorage, agentExecutionService: AgentExecutionService, turnExecutionService: AgentTurnExecutionService, telemetry: Telemetry, runtimeCacheService: AgentRuntimeCacheService, integrationMessageContextService: IntegrationMessageContextService, agentRunTracingService: AgentRunTracingService, externalHooks: ExternalHooks, agentSandboxRuntimeService: AgentSandboxRuntimeService, agentRepository: AgentRepository, aiConfig: AiConfig, chatExecutionService: AgentChatExecutionService);
+    private readonly backgroundJobRepository;
+    private readonly backgroundJobService;
+    private readonly settingsService;
+    constructor(logger: Logger, n8nCheckpointStorage: N8NCheckpointStorage, agentExecutionService: AgentExecutionService, turnExecutionService: AgentTurnExecutionService, telemetry: Telemetry, runtimeCacheService: AgentRuntimeCacheService, integrationMessageContextService: IntegrationMessageContextService, agentRunTracingService: AgentRunTracingService, externalHooks: ExternalHooks, agentSandboxRuntimeService: AgentSandboxRuntimeService, agentRepository: AgentRepository, aiConfig: AiConfig, chatExecutionService: AgentChatExecutionService, backgroundJobRepository: AgentBackgroundJobRepository, backgroundJobService: AgentBackgroundJobService, settingsService: AgentsSettingsService);
     getSessionMode(threadId: string): Promise<AgentSessionMode>;
     getConversationHistory(params: {
         threadId: string;
@@ -151,16 +163,18 @@ export declare class AgentExecutionOrchestratorService {
     private loadResumeMemory;
     private resolveResumeAccess;
     private validateResumeSandbox;
-    resumeForChat(config: ResumeForChatConfig): AsyncGenerator<StreamChunk>;
-    executeForChat(config: ExecuteForChatConfig): AsyncGenerator<StreamChunk>;
-    executeForChatPublished(config: ExecuteForChatPublishedConfig): AsyncGenerator<StreamChunk>;
-    executeForN8nChatPublished(config: ExecuteForN8nChatPublishedConfig): AsyncGenerator<StreamChunk>;
-    executeForTaskPublished(config: ExecuteForTaskPublishedConfig): AsyncGenerator<StreamChunk>;
-    executeForTaskNow(config: ExecuteForTaskNowConfig): AsyncGenerator<StreamChunk>;
+    resumeForChat(config: ResumeForChatConfig): AsyncGenerator<AgentExecutionStreamChunk>;
+    resumeBackgroundForChat(config: ResumeForChatConfig): Promise<boolean>;
+    deliverBackgroundApproval(config: Pick<ExecuteForWakeConfig, 'agentId' | 'projectId' | 'memory' | 'identity'>, title: string, approval: NonNullable<Awaited<ReturnType<AgentBackgroundJobService['getApproval']>>>): Promise<void>;
+    executeForChat(config: ExecuteForChatConfig): AsyncGenerator<AgentExecutionStreamChunk>;
+    executeForChatPublished(config: ExecuteForChatPublishedConfig): AsyncGenerator<AgentExecutionStreamChunk>;
+    executeForN8nChatPublished(config: ExecuteForN8nChatPublishedConfig): AsyncGenerator<AgentExecutionStreamChunk>;
+    executeForTaskPublished(config: ExecuteForTaskPublishedConfig): AsyncGenerator<AgentExecutionStreamChunk>;
+    executeForTaskNow(config: ExecuteForTaskNowConfig): AsyncGenerator<AgentExecutionStreamChunk>;
     executeForWake(config: ExecuteForWakeConfig): Promise<void>;
     private streamWakeResponse;
     private getWakeDelivery;
-    streamChatResponse(config: StreamChatResponseConfig): AsyncGenerator<StreamChunk>;
+    streamChatResponse(config: StreamChatResponseConfig): AsyncGenerator<AgentExecutionStreamChunk>;
     private withRuntimeLease;
     private requestPendingBackgroundWake;
     private getRuntimeOrRecordFailure;

package/dist/modules/agents/agent-execution-orchestrator.service.js

@@ -25,20 +25,25 @@ const agent_run_tracing_service_1 = require("./agent-run-tracing.service");
 const agent_runtime_cache_service_1 = require("./agent-runtime-cache.service");
 const agent_sandbox_principal_1 = require("./agent-sandbox-principal");
 const agent_sandbox_runtime_service_1 = require("./agent-sandbox-runtime.service");
+const agents_settings_service_1 = require("./agents-settings.service");
 const agent_telemetry_1 = require("./agent-telemetry");
 const agent_turn_execution_service_1 = require("./agent-turn-execution.service");
+const budget_guardrail_1 = require("./budget-guardrail");
 const agent_execution_recording_error_1 = require("./agent-execution-recording.error");
 const integration_message_context_1 = require("./integrations/integration-message-context");
 const integration_message_context_service_1 = require("./integrations/integration-message-context.service");
 const n8n_checkpoint_storage_1 = require("./integrations/n8n-checkpoint-storage");
 const model_stream_stall_options_1 = require("./model-stream-stall-options");
 const agent_repository_1 = require("./repositories/agent.repository");
+const agent_background_job_repository_1 = require("./repositories/agent-background-job.repository");
+const agent_background_job_service_1 = require("./background/agent-background-job.service");
+const sub_agent_background_state_1 = require("./background/sub-agent-background-state");
 const agent_execution_counter_1 = require("./utils/agent-execution-counter");
 const agent_published_snapshot_1 = require("./utils/agent-published-snapshot");
 const inbound_attachments_1 = require("./utils/inbound-attachments");
 const execution_to_message_mapper_1 = require("./utils/execution-to-message-mapper");
 let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService {
-    constructor(logger, n8nCheckpointStorage, agentExecutionService, turnExecutionService, telemetry, runtimeCacheService, integrationMessageContextService, agentRunTracingService, externalHooks, agentSandboxRuntimeService, agentRepository, aiConfig, chatExecutionService) {
+    constructor(logger, n8nCheckpointStorage, agentExecutionService, turnExecutionService, telemetry, runtimeCacheService, integrationMessageContextService, agentRunTracingService, externalHooks, agentSandboxRuntimeService, agentRepository, aiConfig, chatExecutionService, backgroundJobRepository, backgroundJobService, settingsService) {
         this.logger = logger;
         this.n8nCheckpointStorage = n8nCheckpointStorage;
         this.agentExecutionService = agentExecutionService;
@@ -52,6 +57,9 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
         this.agentRepository = agentRepository;
         this.aiConfig = aiConfig;
         this.chatExecutionService = chatExecutionService;
+        this.backgroundJobRepository = backgroundJobRepository;
+        this.backgroundJobService = backgroundJobService;
+        this.settingsService = settingsService;
     }
     async getSessionMode(threadId) {
         return await this.agentExecutionService.getSessionMode(threadId);
@@ -144,6 +152,8 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
         return sandboxPrincipalHash;
     }
     async *resumeForChat(config) {
+        if (await this.resumeBackgroundForChat(config))
+            return;
         const resume = { ...config, usePublishedVersion: config.usePublishedVersion ?? true };
         if (resume.source === agent_thread_access_1.N8N_CHAT_PRODUCTION_SOURCE &&
             !(await this.agentRepository.isN8nChatPublished(resume.agentId, resume.projectId))) {
@@ -152,6 +162,88 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
         const checkpoint = await this.loadResumeCheckpoint(resume);
         yield* this.withRuntimeLease(async () => await this.getResumeRuntime(resume, checkpoint), (runtime) => this.resumeRuntimeTurn(resume, checkpoint, runtime));
     }
+    async resumeBackgroundForChat(config) {
+        if (!config.runId.startsWith(sub_agent_background_state_1.BACKGROUND_APPROVAL_RUN_PREFIX))
+            return false;
+        const job = await this.backgroundJobRepository.findById(config.runId.slice(sub_agent_background_state_1.BACKGROUND_APPROVAL_RUN_PREFIX.length));
+        if (!job || job.parentAgentId !== config.agentId || job.status !== 'suspended') {
+            throw new n8n_workflow_1.UserError('This background approval is no longer available');
+        }
+        const resume = { ...config, usePublishedVersion: config.usePublishedVersion ?? true };
+        const approval = await this.backgroundJobService.getApproval(job);
+        if (!approval ||
+            approval.token !== config.toolCallId ||
+            !(0, agent_sandbox_principal_1.isAgentSandboxPrincipalHash)(job.parentPrincipalHash) ||
+            approval.scope.projectId !== config.projectId) {
+            throw new n8n_workflow_1.UserError('This background approval is no longer available');
+        }
+        const memoryScope = {
+            threadId: job.parentThreadId,
+            resourceId: job.parentResourceId,
+            hostMetadata: (0, agent_sandbox_principal_1.encodeAgentSandboxHostMetadata)({
+                projectId: config.projectId,
+                principalHash: job.parentPrincipalHash,
+            }),
+        };
+        if ((config.expectedMemory?.threadId !== undefined &&
+            config.expectedMemory.threadId !== memoryScope.threadId) ||
+            (config.expectedMemory?.resourceId !== undefined &&
+                config.expectedMemory.resourceId !== memoryScope.resourceId)) {
+            throw new n8n_workflow_1.UserError('This background approval does not belong to this chat');
+        }
+        await this.resolveResumeAccess(resume, memoryScope);
+        this.validateResumeSandbox(resume, memoryScope);
+        if (resume.usePublishedVersion) {
+            const expected = approval.metadata.messageContext;
+            const actual = config.messageContext;
+            const destination = expected?.replyTarget ?? expected?.target;
+            if (!expected ||
+                !actual ||
+                actual.platform !== expected.platform ||
+                actual.integrationConnectionId !== expected.integrationConnectionId ||
+                !destination?.threadId ||
+                actual.target.threadId !== destination.threadId) {
+                throw new n8n_workflow_1.UserError('This background approval does not belong to this chat');
+            }
+        }
+        const { SubAgentBackgroundRunner } = await import('./background/sub-agent-background-runner.js');
+        const { AgentsCredentialProvider } = await import('./adapters/agents-credential-provider.js');
+        const { CredentialsService } = await import('../../credentials/credentials.service.js');
+        await di_1.Container.get(SubAgentBackgroundRunner).resume(job, { token: config.toolCallId, resumeData: config.resumeData }, {
+            projectId: config.projectId,
+            parentAgentId: job.parentAgentId,
+            credentialProvider: new AgentsCredentialProvider(di_1.Container.get(CredentialsService), config.projectId, config.user, job.subAgentId ?? undefined),
+            runType: resume.usePublishedVersion ? 'production' : 'test',
+            workflowToolExecutionMode: resume.usePublishedVersion ? 'integrated' : 'manual',
+            user: config.user,
+        });
+        return true;
+    }
+    async deliverBackgroundApproval(config, title, approval) {
+        if (config.identity.type === 'draft') {
+            await this.assertDraftChatAccess({
+                ...config,
+                user: config.identity.user,
+                sessionMode: 'existing',
+            });
+            return;
+        }
+        const delivery = await this.getWakeDelivery(config.agentId, config.identity.integrationType, approval.metadata.messageContext);
+        await delivery.bridge.deliverBackgroundApproval(delivery.threadId, {
+            jobId: approval.metadata.jobId,
+            title,
+            token: approval.token,
+            toolCall: {
+                type: 'tool-call-suspended',
+                runId: approval.runId,
+                toolCallId: approval.pending.toolCallId,
+                toolName: approval.pending.toolName,
+                input: approval.pending.input,
+                suspendPayload: approval.pending.suspendPayload,
+                resumeSchema: approval.pending.resumeSchema,
+            },
+        });
+    }
     async *executeForChat(config) {
         const draft = { ...config, sessionMode: config.sessionMode ?? 'new' };
         const sandboxPrincipalHash = (0, agent_sandbox_principal_1.hashAgentSandboxPrincipal)({
@@ -203,6 +295,7 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 agentInstance: runtime.agent,
                 toolRegistry: runtime.toolRegistry,
                 mcpServerAttributions: runtime.mcpServerAttributions,
+                budget: runtime.budget,
                 agentId,
                 message,
                 modelMessage,
@@ -248,15 +341,18 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             access: { accessScope: 'user', ownerId: user.id },
             sessionMode,
             abortSignal,
+            admittedExecution: config.admittedExecution,
         }), async (runtime) => {
             const messageContext = this.createN8nChatMessageContext(memory, user.id);
             return this.streamChatResponse({
+                admittedExecution: config.admittedExecution,
                 access: { accessScope: 'user', ownerId: user.id },
                 messageContext,
                 onAdmitted: async () => await this.integrationMessageContextService.setLatest(memory.threadId, memory.resourceId, messageContext),
                 agentInstance: runtime.agent,
                 toolRegistry: runtime.toolRegistry,
                 mcpServerAttributions: runtime.mcpServerAttributions,
+                budget: runtime.budget,
                 agentId,
                 projectId,
                 message,
@@ -266,7 +362,6 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 productionN8nChat: true,
                 source: agent_thread_access_1.N8N_CHAT_PRODUCTION_SOURCE,
                 telemetry: { runType: 'production', configuration: runtime.telemetryConfiguration },
-                includeHitlToolDetails: true,
                 sandboxPrincipalHash,
                 sessionMode,
                 abortSignal,
@@ -298,6 +393,7 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             agentInstance: runtime.agent,
             toolRegistry: runtime.toolRegistry,
             mcpServerAttributions: runtime.mcpServerAttributions,
+            budget: runtime.budget,
             agentId,
             message,
             memory,
@@ -336,6 +432,7 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             agentInstance: runtime.agent,
             toolRegistry: runtime.toolRegistry,
             mcpServerAttributions: runtime.mcpServerAttributions,
+            budget: runtime.budget,
             agentId,
             userId: user.id,
             message,
@@ -395,6 +492,8 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 runError = chunk.error;
             if (chunk.type === 'finish' && chunk.finishReason === 'error')
                 runError ??= chunk;
+            if (chunk.type === 'finish' && chunk.guardrail?.code === 'background-pause-report')
+                runError ??= chunk;
             yield chunk;
         }
         if (runError !== undefined) {
@@ -421,6 +520,9 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
         return { bridge, threadId: target.threadId };
     }
     async *streamChatResponse(config) {
+        if (!config.admittedExecution && !config.isWakeRun) {
+            await this.settingsService.assertEnabled();
+        }
         yield* this.turnExecutionService.execute({
             admittedExecution: config.admittedExecution,
             onAdmitted: config.onAdmitted,
@@ -433,7 +535,6 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 threadId: config.memory.threadId,
             },
             backgroundJobSignal: config.backgroundJobSignal,
-            includeHitlToolDetails: config.includeHitlToolDetails,
             onExecutionRecorded: config.onExecutionRecorded,
             previewChat: config.previewChat,
             productionN8nChat: config.source === agent_thread_access_1.N8N_CHAT_PRODUCTION_SOURCE,
@@ -463,14 +564,15 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
         }
     }
     async getRuntimeOrRecordFailure(params, session) {
-        const { onExecutionRecorded, abortSignal, automaticContinuationRunId, admittedExecution, ...recording } = session;
+        const { onExecutionRecorded, abortSignal, automaticContinuationRunId, admittedExecution, isWakeRun, ...recording } = session;
         abortSignal?.throwIfAborted();
+        if (!admittedExecution && !recording.resumeRunId && !isWakeRun) {
+            await this.settingsService.assertEnabled();
+        }
         try {
             return await this.runtimeCacheService.getRuntime(params);
         }
         catch (error) {
-            if (admittedExecution)
-                throw error;
             abortSignal?.throwIfAborted();
             const { agentId, projectId } = params;
             let agent;
@@ -485,7 +587,7 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 const selected = params.usePublishedVersion && agent.activeVersion?.schema
                     ? (0, agent_published_snapshot_1.getPublishedAgentSnapshot)(agent)
                     : agent;
-                await this.turnExecutionService.recordFailedStart({
+                const failed = {
                     ...recording,
                     agentId,
                     agentName: selected.schema?.name ?? agent.name,
@@ -495,7 +597,16 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                         runType: params.usePublishedVersion ? 'production' : 'test',
                         configuration: (0, agent_telemetry_1.buildAgentConfigurationTelemetry)(selected),
                     },
-                }, error, onExecutionRecorded, { previewChat: params.previewChat, automaticContinuationRunId });
+                };
+                if (admittedExecution) {
+                    await this.turnExecutionService.recordFailedAdmission(admittedExecution, failed, error);
+                }
+                else {
+                    await this.turnExecutionService.recordFailedStart(failed, error, onExecutionRecorded, {
+                        previewChat: params.previewChat,
+                        automaticContinuationRunId,
+                    });
+                }
             }
             throw error;
         }
@@ -533,7 +644,6 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             toolRegistry: runtime.toolRegistry,
             mcpServerAttributions: runtime.mcpServerAttributions,
             context: { projectId: config.projectId, agentId: config.agentId, threadId },
-            includeHitlToolDetails: !config.usePublishedVersion || config.source === agent_thread_access_1.N8N_CHAT_PRODUCTION_SOURCE,
             previewChat: config.previewChat,
             productionN8nChat: config.source === agent_thread_access_1.N8N_CHAT_PRODUCTION_SOURCE,
             automaticPreviewContinuation: config.automaticPreviewContinuation,
@@ -553,7 +663,14 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
         return {
             type: 'resume',
             resumeData: config.resumeData,
-            options: this.createResumeOptions(config, memoryScope, messageContext, tracing),
+            options: (0, budget_guardrail_1.withBudgetGuardrail)(this.createResumeOptions(config, memoryScope, messageContext, tracing), {
+                budget: runtime.budget,
+                sessionId: memoryScope.threadId,
+                agentId: config.agentId,
+                ...(config.previewChat && config.onBudgetNotice
+                    ? { onNotice: config.onBudgetNotice }
+                    : {}),
+            }),
             recording: this.createResumeRecording(config, checkpoint, runtime, executionSource),
         };
     }
@@ -666,6 +783,7 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             agentInstance: runtime.agent,
             toolRegistry: runtime.toolRegistry,
             mcpServerAttributions: runtime.mcpServerAttributions,
+            budget: runtime.budget,
             agentId,
             userId: user.id,
             message,
@@ -676,8 +794,8 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             telemetry: { runType: 'test', configuration: runtime.telemetryConfiguration },
             onExecutionRecorded,
             abortSignal,
-            includeHitlToolDetails: true,
             previewChat,
+            onBudgetNotice: config.onBudgetNotice,
             onExecutionStarted: config.onExecutionStarted,
             sandboxPrincipalHash,
             sessionMode,
@@ -715,12 +833,30 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 principalHash: sandboxPrincipalHash,
             }),
             ...(0, integration_message_context_1.encodeIntegrationMessageContext)(messageContext),
+            ...(config.previewChat && !config.isWakeRun && !config.hideUserMessageFromTranscript
+                ? { [sub_agent_background_state_1.BACKGROUND_PAUSE_USER_TURN_KEY]: true }
+                : {}),
         };
         return {
             type: 'start',
             input,
-            options: {
+            options: (0, budget_guardrail_1.withBudgetGuardrail)({
                 persistence: { threadId, resourceId, hostMetadata },
+                ...(config.pauseReport
+                    ? {
+                        toolsEnabled: false,
+                        guardrails: {
+                            hooks: [
+                                {
+                                    beforeTool: async () => ({
+                                        action: 'stop',
+                                        code: 'background-pause-report',
+                                    }),
+                                },
+                            ],
+                        },
+                    }
+                    : {}),
                 executionCounter: (0, agent_execution_counter_1.createAgentExecutionCounter)(this.telemetry, {
                     agentId,
                     userId,
@@ -729,7 +865,14 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 ...(0, model_stream_stall_options_1.modelStreamStallOptions)(this.aiConfig),
                 ...(tracing ? { telemetry: tracing } : {}),
                 ...(abortSignal ? { abortSignal } : {}),
-            },
+            }, {
+                budget: config.budget,
+                sessionId: threadId,
+                agentId,
+                ...(config.previewChat && config.onBudgetNotice
+                    ? { onNotice: config.onBudgetNotice }
+                    : {}),
+            }),
             recording: this.createChatRecording(config),
         };
     }
@@ -778,6 +921,7 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             resourceId: memory.resourceId,
             userMessage: config.message,
             hideUserMessageFromTranscript: true,
+            isWakeRun: true,
             source: productionUserId ? agent_thread_access_1.N8N_CHAT_PRODUCTION_SOURCE : integrationType,
             abortSignal,
             access,
@@ -793,6 +937,7 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
             agentInstance: runtime.agent,
             toolRegistry: runtime.toolRegistry,
             mcpServerAttributions: runtime.mcpServerAttributions,
+            budget: runtime.budget,
             agentId,
             ...(isDraft
                 ? { userId: identity.user.id }
@@ -808,10 +953,10 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
                 configuration: runtime.telemetryConfiguration,
             },
             abortSignal,
-            includeHitlToolDetails: isDraft || Boolean(productionUserId),
             sandboxPrincipalHash: identity.principalHash,
             hideUserMessageFromTranscript: true,
             isWakeRun: true,
+            pauseReport: config.pauseReport,
             sessionMode: 'existing',
             backgroundJobSignal: config.backgroundJobSignal,
         });
@@ -820,6 +965,6 @@ let AgentExecutionOrchestratorService = class AgentExecutionOrchestratorService
 exports.AgentExecutionOrchestratorService = AgentExecutionOrchestratorService;
 exports.AgentExecutionOrchestratorService = AgentExecutionOrchestratorService = __decorate([
     (0, di_1.Service)(),
-    __metadata("design:paramtypes", [backend_common_1.Logger, n8n_checkpoint_storage_1.N8NCheckpointStorage, agent_execution_service_1.AgentExecutionService, agent_turn_execution_service_1.AgentTurnExecutionService, telemetry_1.Telemetry, agent_runtime_cache_service_1.AgentRuntimeCacheService, integration_message_context_service_1.IntegrationMessageContextService, agent_run_tracing_service_1.AgentRunTracingService, external_hooks_1.ExternalHooks, agent_sandbox_runtime_service_1.AgentSandboxRuntimeService, agent_repository_1.AgentRepository, config_1.AiConfig, agent_chat_execution_service_1.AgentChatExecutionService])
+    __metadata("design:paramtypes", [backend_common_1.Logger, n8n_checkpoint_storage_1.N8NCheckpointStorage, agent_execution_service_1.AgentExecutionService, agent_turn_execution_service_1.AgentTurnExecutionService, telemetry_1.Telemetry, agent_runtime_cache_service_1.AgentRuntimeCacheService, integration_message_context_service_1.IntegrationMessageContextService, agent_run_tracing_service_1.AgentRunTracingService, external_hooks_1.ExternalHooks, agent_sandbox_runtime_service_1.AgentSandboxRuntimeService, agent_repository_1.AgentRepository, config_1.AiConfig, agent_chat_execution_service_1.AgentChatExecutionService, agent_background_job_repository_1.AgentBackgroundJobRepository, agent_background_job_service_1.AgentBackgroundJobService, agents_settings_service_1.AgentsSettingsService])
 ], AgentExecutionOrchestratorService);
 //# sourceMappingURL=agent-execution-orchestrator.service.js.map